call_id: string

The unique ID of the shell tool call generated by the model.

minLength1

maxLength64

output: Array<BetaResponseFunctionShellCallOutputContent { outcome, stderr, stdout } >

Captured chunks of stdout and stderr output, along with their associated outcomes.

outcome: Timeout { type } | Exit { exit_code, type }

The exit or timeout outcome associated with this shell call.

One of the following:

Timeout { type }

Indicates that the shell call exceeded its configured time limit.

type: "timeout"

The outcome type. Always timeout.

Exit { exit_code, type }

Indicates that the shell commands finished and returned an exit code.

exit_code: number

The exit code returned by the shell process.

type: "exit"

The outcome type. Always exit.

stderr: string

Captured stderr output for the shell call.

maxLength10485760

stdout: string

Captured stdout output for the shell call.

maxLength10485760

type: "shell_call_output"

The type of the item. Always shell_call_output.

id?: string | null

The unique ID of the shell tool call output. Populated when this item is returned via API.

agent?: Agent | null

The agent that produced this item.

agent_name: string

The canonical name of the agent that produced this item.

caller?: Direct { type } | Program { caller_id, type } | null

The execution context that produced this tool call.

One of the following:

Direct { type }

type: "direct"

The caller type. Always direct.

Program { caller_id, type }

caller_id: string

The call ID of the program item that produced this tool call.

minLength1

maxLength64

type: "program"

The caller type. Always program.

max_output_length?: number | null

The maximum number of UTF-8 characters captured for this shell call’s combined output.

status?: "in_progress" | "completed" | "incomplete" | null

The status of the shell call output.

One of the following:

"in_progress"

"completed"

"incomplete"