action: Action { commands, max_output_length, timeout_ms }

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

commands: Array<string>

Ordered shell commands for the execution environment to run.

max_output_length?: number | null

Maximum number of UTF-8 characters to capture from combined stdout and stderr output.

timeout_ms?: number | null

Maximum wall-clock time in milliseconds to allow the shell commands to run.

call_id: string

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

minLength1
maxLength64
type: "shell_call"

The type of the item. Always shell_call.

id?: string | null

The unique ID of the shell tool call. 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.

environment?: BetaLocalEnvironment { type, skills } | BetaContainerReference { container_id, type } | null

The environment to execute the shell commands in.

One of the following:
BetaLocalEnvironment { type, skills }
type: "local"

Use a local computer environment.

skills?: Array<BetaLocalSkill { description, name, path } >

An optional list of skills.

description: string

The description of the skill.

name: string

The name of the skill.

path: string

The path to the directory containing the skill.

BetaContainerReference { container_id, type }
container_id: string

The ID of the referenced container.

type: "container_reference"

References a container created with the /v1/containers endpoint

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

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

One of the following:
"in_progress"
"completed"
"incomplete"