Run
Type: object
| Field | Required | Type | Description and constraints |
|---|---|---|---|
usage | Yes | Usage | |
phase | Yes | string / null | |
agent_status | Yes | string / null | |
agent_error | Yes | Error / null | |
hooks | Yes | array<HookResult> | |
env_names | Yes | array<string> | Sorted names of explicit variables supplied for this run; values are never returned. |
services | Yes | array<Service> | Immutable service descriptions and environment names resolved when accepted. |
env_from | Yes | array<string> | Sorted orchestrator environment variable names for this run, including expanded services. |
input_fingerprint | Yes | string / null | Input snapshot version supplied when the run was accepted. Opaque identifier, 1–256 UTF-8 bytes; no NUL or whitespace-only value. Compared exactly, without normalization. |
cancel_requested_at | Yes | string / null | |
created_at | Yes | string | format: "date-time" |
deadline_at | Yes | string / null | |
error | Yes | Error / null | |
execution_started_at | Yes | string / null | |
final_message | Yes | Message / null | |
finished_at | Yes | string / null | |
id | Yes | string | format: "uuid" |
number | Yes | integer | |
observation | Yes | string / null | |
session_id | Yes | string | format: "uuid" |
status | Yes | RunStatus | |
stop_method | Yes | string / null | How cancellation stopped agent execution. Null until confirmed, or if the run was cancelled before the first dispatch attempt, including user-requested cancellation. |
stop_reason | Yes | string / null |
JSON Schema
json
{
"properties": {
"usage": {
"$ref": "#/components/schemas/Usage"
},
"phase": {
"anyOf": [
{
"type": "string",
"enum": [
"preparation",
"after_create",
"before_run",
"agent",
"after_run"
]
},
{
"type": "null"
}
]
},
"agent_status": {
"anyOf": [
{
"type": "string",
"enum": [
"completed",
"failed",
"cancelled"
]
},
{
"type": "null"
}
]
},
"agent_error": {
"anyOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"type": "null"
}
]
},
"hooks": {
"type": "array",
"items": {
"$ref": "#/components/schemas/HookResult"
}
},
"env_names": {
"description": "Sorted names of explicit variables supplied for this run; values are never returned.",
"type": "array",
"items": {
"type": "string"
}
},
"services": {
"description": "Immutable service descriptions and environment names resolved when accepted.",
"type": "array",
"items": {
"$ref": "#/components/schemas/Service"
}
},
"env_from": {
"description": "Sorted orchestrator environment variable names for this run, including expanded services.",
"type": "array",
"items": {
"type": "string"
}
},
"input_fingerprint": {
"description": "Input snapshot version supplied when the run was accepted. Opaque identifier, 1–256 UTF-8 bytes; no NUL or whitespace-only value. Compared exactly, without normalization.",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"cancel_requested_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Cancel Requested At"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"deadline_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Deadline At"
},
"error": {
"anyOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"type": "null"
}
]
},
"execution_started_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Execution Started At"
},
"final_message": {
"anyOf": [
{
"$ref": "#/components/schemas/Message"
},
{
"type": "null"
}
]
},
"finished_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Finished At"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"number": {
"title": "Number",
"type": "integer"
},
"observation": {
"anyOf": [
{
"enum": [
"attached",
"reconnecting",
"uncertain"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Observation"
},
"session_id": {
"format": "uuid",
"title": "Session Id",
"type": "string"
},
"status": {
"$ref": "#/components/schemas/RunStatus"
},
"stop_method": {
"description": "How cancellation stopped agent execution. Null until confirmed, or if the run was cancelled before the first dispatch attempt, including user-requested cancellation.",
"anyOf": [
{
"enum": [
"graceful",
"forced"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Stop Method"
},
"stop_reason": {
"anyOf": [
{
"enum": [
"user_request",
"run_timeout",
"token_limit"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Stop Reason"
}
},
"required": [
"usage",
"phase",
"agent_status",
"agent_error",
"hooks",
"input_fingerprint",
"env_names",
"env_from",
"services",
"id",
"session_id",
"number",
"status",
"observation",
"created_at",
"execution_started_at",
"deadline_at",
"finished_at",
"cancel_requested_at",
"stop_reason",
"stop_method",
"final_message",
"error"
],
"title": "Run",
"type": "object"
}