reason: BetaResponseSteerPendingReason

An extensible enum describing why accepted steering input is still queued. Clients should handle unknown values because additional reasons may be introduced. Known values include:

  • waiting_for_required_input: The response is waiting for the tool results or approval decisions identified by required_input.
required_input: List[BetaResponseSteerRequiredInput]

Input stubs identifying outstanding client-owned tool results or approval decisions. Each stub contains identifying fields only; the client supplies the result before including it in response.create.

One of the following:
class FunctionCallOutput: …

Supply output using the function tool call output input schema.

call_id: str
name: str
type: Literal["function_call_output"]
class CustomToolCallOutput: …

Supply output using the custom tool call output input schema. The original custom tool call supplies the tool’s name.

call_id: str
type: Literal["custom_tool_call_output"]
class ComputerCallOutput: …

Supply output using the computer tool call output input schema, including any required acknowledged_safety_checks.

call_id: str
type: Literal["computer_call_output"]
class ShellCallOutput: …

Supply output using the shell tool call output input schema. Each output entry includes stdout, stderr, and outcome.

call_id: str
type: Literal["shell_call_output"]
class ApplyPatchCallOutput: …

Supply status and optional output using the apply patch tool call output input schema.

call_id: str
type: Literal["apply_patch_call_output"]
class ToolSearchOutput: …

Supply tools using the tool search output input schema, retaining execution: "client".

call_id: str
execution: Literal["client"]
type: Literal["tool_search_output"]
class McpApprovalResponse: …

Supply approve using the MCP approval response input schema. An optional reason can be supplied when denying the request. The original approval request identifies the tool and server.

approval_request_id: str
type: Literal["mcp_approval_response"]
sequence_number: int

The sequence number for this event.

steer: Steer

The steering submission that remains queued.

id: str

The ID assigned to the steering submission.

previous_response_id: str

The ID of the response being steered.

type: Literal["response.steer.pending"]

The event discriminator. Always response.steer.pending.

stream_id: Optional[str]

The WebSocket lane that emitted this event. This field is present when the target response’s response.create event supplied a stream_id.