pi_llm.providers.openai_responses

openai_responses

OpenAI Responses API provider.

Implements the streaming interface for OpenAI's Responses API.

OpenAIResponsesOptions(temperature=None, max_tokens=None, api_key=None, cancel_event=None, cache_retention=None, session_id=None, on_payload=None, headers=None, max_retry_delay_ms=None, metadata=None, reasoning_effort=None, reasoning_summary=None, service_tier=None) dataclass

Bases: StreamOptions

Extended options for the OpenAI Responses API.

Attributes:

Name	Type	Description
reasoning_effort	str | None	Reasoning effort level (e.g. "medium").
reasoning_summary	str | None	Reasoning summary mode (e.g. "auto").
service_tier	str | None	Service tier (e.g. "flex", "priority").

stream_openai_responses(model, context, options=None)

Stream from the OpenAI Responses API.

Returns an event stream immediately and processes the API response in a background asyncio task.

Parameters:

Name	Type	Description	Default
model	Model	Model to use for the request.	required
context	Context	Conversation context.	required
options	OpenAIResponsesOptions | None	OpenAI-specific options.	None

Returns:

Type	Description
AssistantMessageEventStream	An async iterable event stream of AssistantMessageEvent.

stream_simple_openai_responses(model, context, options=None)

Simplified entry point with automatic option building.

Validates the API key, maps SimpleStreamOptions to OpenAIResponsesOptions, and delegates to stream_openai_responses.