id: str

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

call_id: str

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

max_output_length: Optional[int]

The maximum length of the shell command output. This is generated by the model and should be passed back with the raw output.

output: List[Output]

An array of shell call output contents

outcome: OutputOutcome

Represents either an exit outcome (with an exit code) or a timeout outcome for a shell call output chunk.

One of the following:
class OutputOutcomeTimeout: …

Indicates that the shell call exceeded its configured time limit.

type: Literal["timeout"]

The outcome type. Always timeout.

class OutputOutcomeExit: …

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

exit_code: int

Exit code from the shell process.

type: Literal["exit"]

The outcome type. Always exit.

stderr: str

The standard error output that was captured.

stdout: str

The standard output that was captured.

created_by: Optional[str]

The identifier of the actor that created the item.

status: Literal["in_progress", "completed", "incomplete"]

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

One of the following:
"in_progress"
"completed"
"incomplete"
type: Literal["shell_call_output"]

The type of the shell call output. Always shell_call_output.

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 identifier of the actor that created the item.