id: str

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

action: Action

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

commands: List[str]
max_output_length: Optional[int]

Optional maximum number of characters to return from each command.

timeout_ms: Optional[int]

Optional timeout in milliseconds for the commands.

call_id: str

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

environment: Optional[Environment]

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

One of the following:
class BetaResponseLocalEnvironment: …

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

type: Literal["local"]

The environment type. Always local.

class BetaResponseContainerReference: …

Represents a container created with /v1/containers.

container_id: str
type: Literal["container_reference"]

The environment type. Always container_reference.

status: Literal["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: Literal["shell_call"]

The type of the item. Always shell_call.

agent: Optional[Agent]

The agent that produced this item.

agent_name: str

The canonical name of the agent that produced this item.

caller: Optional[Caller]

The execution context that produced this tool call.

One of the following:
class CallerDirect: …
type: Literal["direct"]
class CallerProgram: …
caller_id: str

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

type: Literal["program"]
created_by: Optional[str]

The ID of the entity that created this tool call.