One of the following:
class BetaResponseAudioDeltaEvent: …

Emitted when there is a partial audio response.

delta: str

A chunk of Base64 encoded response audio bytes.

sequence_number: int

A sequence number for this chunk of the stream response.

type: Literal["response.audio.delta"]

The type of the event. Always response.audio.delta.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseAudioDoneEvent: …

Emitted when the audio response is complete.

sequence_number: int

The sequence number of the delta.

type: Literal["response.audio.done"]

The type of the event. Always response.audio.done.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseAudioTranscriptDeltaEvent: …

Emitted when there is a partial transcript of audio.

delta: str

The partial transcript of the audio response.

sequence_number: int

The sequence number of this event.

type: Literal["response.audio.transcript.delta"]

The type of the event. Always response.audio.transcript.delta.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseAudioTranscriptDoneEvent: …

Emitted when the full audio transcript is completed.

sequence_number: int

The sequence number of this event.

type: Literal["response.audio.transcript.done"]

The type of the event. Always response.audio.transcript.done.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseCodeInterpreterCallCodeDeltaEvent: …

Emitted when a partial code snippet is streamed by the code interpreter.

delta: str

The partial code snippet being streamed by the code interpreter.

item_id: str

The unique identifier of the code interpreter tool call item.

output_index: int

The index of the output item in the response for which the code is being streamed.

sequence_number: int

The sequence number of this event, used to order streaming events.

type: Literal["response.code_interpreter_call_code.delta"]

The type of the event. Always response.code_interpreter_call_code.delta.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseCodeInterpreterCallCodeDoneEvent: …

Emitted when the code snippet is finalized by the code interpreter.

code: str

The final code snippet output by the code interpreter.

item_id: str

The unique identifier of the code interpreter tool call item.

output_index: int

The index of the output item in the response for which the code is finalized.

sequence_number: int

The sequence number of this event, used to order streaming events.

type: Literal["response.code_interpreter_call_code.done"]

The type of the event. Always response.code_interpreter_call_code.done.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseCodeInterpreterCallCompletedEvent: …

Emitted when the code interpreter call is completed.

item_id: str

The unique identifier of the code interpreter tool call item.

output_index: int

The index of the output item in the response for which the code interpreter call is completed.

sequence_number: int

The sequence number of this event, used to order streaming events.

type: Literal["response.code_interpreter_call.completed"]

The type of the event. Always response.code_interpreter_call.completed.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseCodeInterpreterCallInProgressEvent: …

Emitted when a code interpreter call is in progress.

item_id: str

The unique identifier of the code interpreter tool call item.

output_index: int

The index of the output item in the response for which the code interpreter call is in progress.

sequence_number: int

The sequence number of this event, used to order streaming events.

type: Literal["response.code_interpreter_call.in_progress"]

The type of the event. Always response.code_interpreter_call.in_progress.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseCodeInterpreterCallInterpretingEvent: …

Emitted when the code interpreter is actively interpreting the code snippet.

item_id: str

The unique identifier of the code interpreter tool call item.

output_index: int

The index of the output item in the response for which the code interpreter is interpreting code.

sequence_number: int

The sequence number of this event, used to order streaming events.

type: Literal["response.code_interpreter_call.interpreting"]

The type of the event. Always response.code_interpreter_call.interpreting.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseCompactionCompactingEvent: …

Emitted when new summary content is sampled for a compaction trigger. Contains no summary content.

item_id: str

The ID of the compaction output item.

output_index: int

The index of the compaction output item.

sequence_number: int

The sequence number of the event that was emitted.

type: Literal["response.compaction.compacting"]

The type of the event, always response.compaction.compacting.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseCompletedEvent: …

Emitted when the model response is complete.

response: BetaResponse

Properties of the completed response.

sequence_number: int

The sequence number for this event.

type: Literal["response.completed"]

The type of the event. Always response.completed.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseContentPartAddedEvent: …

Emitted when a new content part is added.

content_index: int

The index of the content part that was added.

item_id: str

The ID of the output item that the content part was added to.

output_index: int

The index of the output item that the content part was added to.

part: Part

The content part that was added.

One of the following:
class BetaResponseOutputText: …

A text output from the model.

annotations: List[Annotation]

The annotations of the text output.

One of the following:
class AnnotationFileCitation: …

A citation to a file.

file_id: str

The ID of the file.

filename: str

The filename of the file cited.

index: int

The index in the output text at which to insert the file citation.

type: Literal["file_citation"]

The type of the file citation. Always file_citation.

class AnnotationURLCitation: …

A citation for a web resource used to generate a model response.

end_index: int

The index of the last character of the URL citation in the message.

start_index: int

The index of the first character of the URL citation in the message.

title: str

The title of the web resource.

type: Literal["url_citation"]

The type of the URL citation. Always url_citation.

url: str

The URL of the web resource.

formaturi
class AnnotationContainerFileCitation: …

A citation for a container file used to generate a model response.

container_id: str

The ID of the container file.

end_index: int

The index of the last character of the container file citation in the message.

file_id: str

The ID of the file.

filename: str

The filename of the container file cited.

start_index: int

The index of the first character of the container file citation in the message.

type: Literal["container_file_citation"]

The type of the container file citation. Always container_file_citation.

class AnnotationFilePath: …

A path to a file.

file_id: str

The ID of the file.

index: int

The index of the file in the list of files.

type: Literal["file_path"]

The type of the file path. Always file_path.

text: str

The text output from the model.

type: Literal["output_text"]

The type of the output text. Always output_text.

logprobs: Optional[List[Logprob]]
token: str
bytes: List[int]
logprob: float
top_logprobs: List[LogprobTopLogprob]
token: str
bytes: List[int]
logprob: float
class BetaResponseOutputRefusal: …

A refusal from the model.

refusal: str

The refusal explanation from the model.

type: Literal["refusal"]

The type of the refusal. Always refusal.

class PartReasoningText: …

Reasoning text from the model.

text: str

The reasoning text from the model.

type: Literal["reasoning_text"]

The type of the reasoning text. Always reasoning_text.

sequence_number: int

The sequence number of this event.

type: Literal["response.content_part.added"]

The type of the event. Always response.content_part.added.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseContentPartDoneEvent: …

Emitted when a content part is done.

content_index: int

The index of the content part that is done.

item_id: str

The ID of the output item that the content part was added to.

output_index: int

The index of the output item that the content part was added to.

part: Part

The content part that is done.

One of the following:
class BetaResponseOutputText: …

A text output from the model.

annotations: List[Annotation]

The annotations of the text output.

One of the following:
class AnnotationFileCitation: …

A citation to a file.

file_id: str

The ID of the file.

filename: str

The filename of the file cited.

index: int

The index in the output text at which to insert the file citation.

type: Literal["file_citation"]

The type of the file citation. Always file_citation.

class AnnotationURLCitation: …

A citation for a web resource used to generate a model response.

end_index: int

The index of the last character of the URL citation in the message.

start_index: int

The index of the first character of the URL citation in the message.

title: str

The title of the web resource.

type: Literal["url_citation"]

The type of the URL citation. Always url_citation.

url: str

The URL of the web resource.

formaturi
class AnnotationContainerFileCitation: …

A citation for a container file used to generate a model response.

container_id: str

The ID of the container file.

end_index: int

The index of the last character of the container file citation in the message.

file_id: str

The ID of the file.

filename: str

The filename of the container file cited.

start_index: int

The index of the first character of the container file citation in the message.

type: Literal["container_file_citation"]

The type of the container file citation. Always container_file_citation.

class AnnotationFilePath: …

A path to a file.

file_id: str

The ID of the file.

index: int

The index of the file in the list of files.

type: Literal["file_path"]

The type of the file path. Always file_path.

text: str

The text output from the model.

type: Literal["output_text"]

The type of the output text. Always output_text.

logprobs: Optional[List[Logprob]]
token: str
bytes: List[int]
logprob: float
top_logprobs: List[LogprobTopLogprob]
token: str
bytes: List[int]
logprob: float
class BetaResponseOutputRefusal: …

A refusal from the model.

refusal: str

The refusal explanation from the model.

type: Literal["refusal"]

The type of the refusal. Always refusal.

class PartReasoningText: …

Reasoning text from the model.

text: str

The reasoning text from the model.

type: Literal["reasoning_text"]

The type of the reasoning text. Always reasoning_text.

sequence_number: int

The sequence number of this event.

type: Literal["response.content_part.done"]

The type of the event. Always response.content_part.done.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseCreatedEvent: …

An event that is emitted when a response is created.

response: BetaResponse

The response that was created.

sequence_number: int

The sequence number for this event.

type: Literal["response.created"]

The type of the event. Always response.created.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseErrorEvent: …

Emitted when an error occurs.

code: Optional[str]

The error code.

message: str

The error message.

param: Optional[str]

The error parameter.

sequence_number: int

The sequence number of this event.

type: Literal["error"]

The type of the event. Always error.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseFileSearchCallCompletedEvent: …

Emitted when a file search call is completed (results found).

item_id: str

The ID of the output item that the file search call is initiated.

output_index: int

The index of the output item that the file search call is initiated.

sequence_number: int

The sequence number of this event.

type: Literal["response.file_search_call.completed"]

The type of the event. Always response.file_search_call.completed.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseFileSearchCallInProgressEvent: …

Emitted when a file search call is initiated.

item_id: str

The ID of the output item that the file search call is initiated.

output_index: int

The index of the output item that the file search call is initiated.

sequence_number: int

The sequence number of this event.

type: Literal["response.file_search_call.in_progress"]

The type of the event. Always response.file_search_call.in_progress.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseFileSearchCallSearchingEvent: …

Emitted when a file search is currently searching.

item_id: str

The ID of the output item that the file search call is initiated.

output_index: int

The index of the output item that the file search call is searching.

sequence_number: int

The sequence number of this event.

type: Literal["response.file_search_call.searching"]

The type of the event. Always response.file_search_call.searching.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseFunctionCallArgumentsDeltaEvent: …

Emitted when there is a partial function-call arguments delta.

delta: str

The function-call arguments delta that is added.

item_id: str

The ID of the output item that the function-call arguments delta is added to.

output_index: int

The index of the output item that the function-call arguments delta is added to.

sequence_number: int

The sequence number of this event.

type: Literal["response.function_call_arguments.delta"]

The type of the event. Always response.function_call_arguments.delta.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseFunctionCallArgumentsDoneEvent: …

Emitted when function-call arguments are finalized.

arguments: str

The function-call arguments.

item_id: str

The ID of the item.

output_index: int

The index of the output item.

sequence_number: int

The sequence number of this event.

type: Literal["response.function_call_arguments.done"]
agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseShellCallCommandAddedEvent: …

A streaming event that indicated a shell command was added to a tool call.

command: str

The shell command that was added.

command_index: int

The index of the shell command that was added.

output_index: int

The index of the output item that was updated.

sequence_number: int

The sequence number of the event that was emitted.

type: Literal["response.shell_call_command.added"]

The type of the event, always response.shell_call_command.added.

agent: Optional[Agent]

The agent that owns this multi-agent streaming event.

agent_name: str

The canonical name of the agent that produced this item.

class BetaResponseShellCallCommandDeltaEvent: …

A streaming event that indicated a shell command was incrementally updated.

class BetaResponseShellCallCommandDoneEvent: …

A streaming event that indicated a shell command was completed.

class BetaResponseShellCallOutputContentDeltaEvent: …

A streaming event that indicated shell call output was incrementally added.

class BetaResponseShellCallOutputContentDoneEvent: …

A streaming event that indicated shell call output was completed.

class BetaResponseInProgressEvent: …

Emitted when the response is in progress.

class BetaResponseFailedEvent: …

An event that is emitted when a response fails.

class BetaResponseIncompleteEvent: …

An event that is emitted when a response finishes as incomplete.

Over WebSocket, steering can finish a response with response.incomplete_details.reason set to steered, followed automatically by a successor response.created that commits the queued steering input.

class BetaResponseOutputItemAddedEvent: …

Emitted when a new output item is added.

class BetaResponseOutputItemDoneEvent: …

Emitted when an output item is marked done.

class BetaResponseReasoningSummaryPartAddedEvent: …

Emitted when a new reasoning summary part is added.

class BetaResponseReasoningSummaryPartDoneEvent: …

Emitted when a reasoning summary part is completed.

class BetaResponseReasoningSummaryTextDeltaEvent: …

Emitted when a delta is added to a reasoning summary text.

class BetaResponseReasoningSummaryTextDoneEvent: …

Emitted when a reasoning summary text is completed.

class BetaResponseReasoningTextDeltaEvent: …

Emitted when a delta is added to a reasoning text.

class BetaResponseReasoningTextDoneEvent: …

Emitted when a reasoning text is completed.

class BetaResponseRefusalDeltaEvent: …

Emitted when there is a partial refusal text.

class BetaResponseRefusalDoneEvent: …

Emitted when refusal text is finalized.

class BetaResponseTextDeltaEvent: …

Emitted when there is an additional text delta.

class BetaResponseTextDoneEvent: …

Emitted when text content is finalized.

class BetaResponseWebSearchCallCompletedEvent: …

Emitted when a web search call is completed.

class BetaResponseWebSearchCallInProgressEvent: …

Emitted when a web search call is initiated.

class BetaResponseWebSearchCallSearchingEvent: …

Emitted when a web search call is executing.

class BetaResponseImageGenCallCompletedEvent: …

Emitted when an image generation tool call has completed and the final image is available.

class BetaResponseImageGenCallGeneratingEvent: …

Emitted when an image generation tool call is actively generating an image (intermediate state).

class BetaResponseImageGenCallInProgressEvent: …

Emitted when an image generation tool call is in progress.

class BetaResponseImageGenCallPartialImageEvent: …

Emitted when a partial image is available during image generation streaming.

class BetaResponseMcpCallArgumentsDeltaEvent: …

Emitted when there is a delta (partial update) to the arguments of an MCP tool call.

class BetaResponseMcpCallArgumentsDoneEvent: …

Emitted when the arguments for an MCP tool call are finalized.

class BetaResponseMcpCallCompletedEvent: …

Emitted when an MCP tool call has completed successfully.

class BetaResponseMcpCallFailedEvent: …

Emitted when an MCP tool call has failed.

class BetaResponseMcpCallInProgressEvent: …

Emitted when an MCP tool call is in progress.

class BetaResponseMcpListToolsCompletedEvent: …

Emitted when the list of available MCP tools has been successfully retrieved.

class BetaResponseMcpListToolsFailedEvent: …

Emitted when the attempt to list available MCP tools has failed.

class BetaResponseMcpListToolsInProgressEvent: …

Emitted when the system is in the process of retrieving the list of available MCP tools.

class BetaResponseOutputTextAnnotationAddedEvent: …

Emitted when an annotation is added to output text content.

class BetaResponseQueuedEvent: …

Emitted when a response is queued and waiting to be processed.

class BetaResponseCustomToolCallInputDeltaEvent: …

Event representing a delta (partial update) to the input of a custom tool call.

class BetaResponseCustomToolCallInputDoneEvent: …

Event indicating that input for a custom tool call is complete.