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: Integer

Optional maximum number of characters to return from each command.

timeout_ms: Integer

Optional timeout in milliseconds for the commands.

call_id: String

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

environment: BetaResponseLocalEnvironment { type } | BetaResponseContainerReference { container_id, type }

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

One of the following:
class BetaResponseLocalEnvironment { type }

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

type: :local

The environment type. Always local.

class BetaResponseContainerReference { 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.

agent: Agent{ agent_name}

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}

The execution context that produced this tool call.

One of the following:
class Direct { type }
type: :direct
class 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.