id: string

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

action: Action { commands, max_output_length, timeout_ms }

The shell commands and limits that describe how to run the tool call.

commands: Array<string>

max_output_length: number | null

Optional maximum number of characters to return from each command.

timeout_ms: number | null

Optional timeout in milliseconds for the commands.

call_id: string

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

environment: ResponseLocalEnvironment { type } | ResponseContainerReference { container_id, type } | null

Represents the use of a local environment to perform shell actions.

One of the following:

ResponseLocalEnvironment { type }

Represents the use of a local environment to perform shell actions.

type: "local"

The environment type. Always local.

ResponseContainerReference { container_id, type }

Represents a container created with /v1/containers.

container_id: string

type: "container_reference"

The environment type. Always container_reference.

status: "in_progress" | "completed" | "incomplete"

The status of the shell call. One of in_progress, completed, or incomplete.

One of the following:

"in_progress"

"completed"

"incomplete"

type: "shell_call"

The type of the item. Always shell_call.

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

The execution context that produced this tool call.

One of the following:

Direct { type }

type: "direct"

Program { caller_id, type }

caller_id: string

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

type: "program"

created_by?: string

The ID of the entity that created this tool call.