WIRE_PROTOCOL.md

# Wire Protocol

> Generated by `scripts/gen_protocol_doc.py`. **Do not edit manually.**

## Transport

- TCP loopback `127.0.0.1:7437`; `CODEROOK_HOST` may only select a loopback address
- Each message is one `\n`-terminated JSON line (NDJSON)
- Commands use JSON-RPC 2.0 (client -> server); Events use `kind=event` envelope (server -> client)
- The first frame must be `core.authenticate`; failure closes the connection
- Core reads `CODEROOK_IPC_TOKEN` or creates the private `~/.coderook/ipc-token` file
- Authentication frames and token values are excluded from Trace

## Connection Authentication

Authentication completes synchronously before normal command dispatch, so pipelined business frames cannot race the handshake. Clients must never log or persist the token in project files.

### CoreAuthenticateCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `token` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "core.authenticate",
      "default": "core.authenticate",
      "title": "Type",
      "type": "string"
    },
    "token": {
      "title": "Token",
      "type": "string"
    }
  },
  "required": [
    "token"
  ],
  "title": "CoreAuthenticateCommand",
  "type": "object"
}
```

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": "auth-1",
  "method": "core.authenticate",
  "params": {
    "token": "<local-random-token>"
  }
}
```

### CoreAuthenticateResult

| Field | Type | Required |
|---|---|---|
| `authenticated` | `boolean` | no |

```json
{
  "properties": {
    "authenticated": {
      "const": true,
      "default": true,
      "title": "Authenticated",
      "type": "boolean"
    }
  },
  "title": "CoreAuthenticateResult",
  "type": "object"
}
```

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": "auth-1",
  "result": {
    "authenticated": true
  }
}
```

## Commands

All commands are sent as JSON-RPC 2.0 requests. The JSON-RPC `method` selects the handler; the model `type` field is the typed protocol discriminator.

### PingCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `client` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "core.ping",
      "default": "core.ping",
      "title": "Type",
      "type": "string"
    },
    "client": {
      "title": "Client",
      "type": "string"
    }
  },
  "required": [
    "client"
  ],
  "title": "PingCommand",
  "type": "object"
}
```

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": "u-1",
  "method": "core.ping",
  "params": {
    "client": "cli/0.0.1"
  }
}
```

### PongResult

| Field | Type | Required |
|---|---|---|
| `server_version` | `string` | yes |
| `uptime_ms` | `integer` | yes |
| `received_at` | `string` | yes |
| `workspace` | `string` | yes |
| `active_runs` | `integer` | yes |

```json
{
  "properties": {
    "server_version": {
      "title": "Server Version",
      "type": "string"
    },
    "uptime_ms": {
      "title": "Uptime Ms",
      "type": "integer"
    },
    "received_at": {
      "title": "Received At",
      "type": "string"
    },
    "workspace": {
      "title": "Workspace",
      "type": "string"
    },
    "active_runs": {
      "minimum": 0,
      "title": "Active Runs",
      "type": "integer"
    }
  },
  "required": [
    "server_version",
    "uptime_ms",
    "received_at",
    "workspace",
    "active_runs"
  ],
  "title": "PongResult",
  "type": "object"
}
```

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": "u-1",
  "result": {
    "server_version": "0.2.0b1",
    "uptime_ms": 12,
    "received_at": "2026-05-16T10:00:00.001Z",
    "workspace": "/workspace/coderook",
    "active_runs": 0
  }
}
```

### AgentRunCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `goal` | `string` | yes |
| `display_content` | `string | null` | no |
| `permission_mode` | `string` | no |
| `allow_tools` | `array` | no |
| `tools` | `array | null` | no |
| `session_mode` | `string` | no |
| `session_name` | `string` | no |
| `resume_session_id` | `string | null` | no |
| `fork_session_id` | `string | null` | no |
| `route_id` | `string | null` | no |
| `model` | `string | null` | no |
| `thinking_level` | `string | null` | no |
| `system_prompt` | `string | null` | no |
| `append_system_prompt` | `string` | no |
| `question_mode` | `string` | no |
| `question_timeout_s` | `number | null` | no |
| `preset_answers` | `array` | no |
| `attachments` | `array` | no |

```json
{
  "$defs": {
    "ImageArtifactInput": {
      "additionalProperties": false,
      "properties": {
        "sha256": {
          "pattern": "^[0-9a-f]{64}$",
          "title": "Sha256",
          "type": "string"
        },
        "media_type": {
          "pattern": "^image/(png|jpeg|webp|gif)$",
          "title": "Media Type",
          "type": "string"
        },
        "size": {
          "exclusiveMinimum": 0,
          "maximum": 2097152,
          "title": "Size",
          "type": "integer"
        },
        "width": {
          "exclusiveMinimum": 0,
          "maximum": 100000,
          "title": "Width",
          "type": "integer"
        },
        "height": {
          "exclusiveMinimum": 0,
          "maximum": 100000,
          "title": "Height",
          "type": "integer"
        }
      },
      "required": [
        "sha256",
        "media_type",
        "size",
        "width",
        "height"
      ],
      "title": "ImageArtifactInput",
      "type": "object"
    }
  },
  "properties": {
    "type": {
      "const": "agent.run",
      "default": "agent.run",
      "title": "Type",
      "type": "string"
    },
    "goal": {
      "title": "Goal",
      "type": "string"
    },
    "display_content": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Display Content"
    },
    "permission_mode": {
      "default": "fail_fast",
      "enum": [
        "deny",
        "fail_fast",
        "allow_list"
      ],
      "title": "Permission Mode",
      "type": "string"
    },
    "allow_tools": {
      "items": {
        "type": "string"
      },
      "title": "Allow Tools",
      "type": "array"
    },
    "tools": {
      "anyOf": [
        {
          "items": {
            "enum": [
              "read",
              "bash",
              "edit",
              "write"
            ],
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tools"
    },
    "session_mode": {
      "default": "one_shot",
      "enum": [
        "chat",
        "one_shot"
      ],
      "title": "Session Mode",
      "type": "string"
    },
    "session_name": {
      "default": "",
      "maxLength": 200,
      "title": "Session Name",
      "type": "string"
    },
    "resume_session_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Resume Session Id"
    },
    "fork_session_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Fork Session Id"
    },
    "route_id": {
      "anyOf": [
        {
          "maxLength": 256,
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Route Id"
    },
    "model": {
      "anyOf": [
        {
          "maxLength": 256,
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Model"
    },
    "thinking_level": {
      "anyOf": [
        {
          "enum": [
            "off",
            "low",
            "medium",
            "high"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Thinking Level"
    },
    "system_prompt": {
      "anyOf": [
        {
          "maxLength": 262144,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "System Prompt"
    },
    "append_system_prompt": {
      "default": "",
      "maxLength": 262144,
      "title": "Append System Prompt",
      "type": "string"
    },
    "question_mode": {
      "default": "fail_fast",
      "enum": [
        "fail_fast",
        "timeout",
        "preset"
      ],
      "title": "Question Mode",
      "type": "string"
    },
    "question_timeout_s": {
      "anyOf": [
        {
          "exclusiveMinimum": 0,
          "maximum": 3600,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Question Timeout S"
    },
    "preset_answers": {
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "title": "Preset Answers",
      "type": "array"
    },
    "attachments": {
      "items": {
        "$ref": "#/$defs/ImageArtifactInput"
      },
      "maxItems": 8,
      "title": "Attachments",
      "type": "array"
    }
  },
  "required": [
    "goal"
  ],
  "title": "AgentRunCommand",
  "type": "object"
}
```

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": "u-2",
  "method": "agent.run",
  "params": {
    "goal": "\u603b\u7ed3 README.md \u7684\u4e3b\u8981\u7ae0\u8282"
  }
}
```

### AgentRunResult

| Field | Type | Required |
|---|---|---|
| `run_id` | `string` | yes |
| `session_id` | `string` | yes |
| `handled` | `boolean` | no |

```json
{
  "properties": {
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "handled": {
      "default": false,
      "title": "Handled",
      "type": "boolean"
    }
  },
  "required": [
    "run_id",
    "session_id"
  ],
  "title": "AgentRunResult",
  "type": "object"
}
```

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": "u-2",
  "result": {
    "run_id": "20260516-100000-abc123"
  }
}
```

### GoalCreateCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `objective` | `string` | yes |
| `token_budget` | `integer | null` | no |
| `auto_continue` | `boolean` | no |
| `max_auto_turns` | `integer` | no |
| `max_wall_seconds` | `integer` | no |
| `constraints` | `array` | no |
| `completion_criteria` | `array` | no |
| `start` | `boolean` | no |

```json
{
  "properties": {
    "type": {
      "const": "goal.create",
      "default": "goal.create",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "objective": {
      "maxLength": 100000,
      "minLength": 1,
      "title": "Objective",
      "type": "string"
    },
    "token_budget": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Token Budget"
    },
    "auto_continue": {
      "default": true,
      "title": "Auto Continue",
      "type": "boolean"
    },
    "max_auto_turns": {
      "default": 3,
      "maximum": 100,
      "minimum": 1,
      "title": "Max Auto Turns",
      "type": "integer"
    },
    "max_wall_seconds": {
      "default": 1800,
      "maximum": 86400,
      "minimum": 1,
      "title": "Max Wall Seconds",
      "type": "integer"
    },
    "constraints": {
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "title": "Constraints",
      "type": "array"
    },
    "completion_criteria": {
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "title": "Completion Criteria",
      "type": "array"
    },
    "start": {
      "default": true,
      "title": "Start",
      "type": "boolean"
    }
  },
  "required": [
    "session_id",
    "objective"
  ],
  "title": "GoalCreateCommand",
  "type": "object"
}
```

### GoalCreateResult

| Field | Type | Required |
|---|---|---|
| `goal` | `object` | yes |
| `run_id` | `string | null` | no |

```json
{
  "$defs": {
    "AuthorityProfile": {
      "enum": [
        "ask",
        "auto_review",
        "full_access"
      ],
      "title": "AuthorityProfile",
      "type": "string"
    },
    "AuthoritySnapshot": {
      "additionalProperties": false,
      "properties": {
        "mode": {
          "$ref": "#/$defs/RuntimeMode",
          "default": "act"
        },
        "profile": {
          "$ref": "#/$defs/AuthorityProfile",
          "default": "ask"
        },
        "workspace_trust": {
          "$ref": "#/$defs/WorkspaceTrust",
          "default": "untrusted"
        },
        "sandbox": {
          "$ref": "#/$defs/SandboxCapability"
        },
        "allowed_actions": {
          "items": {
            "$ref": "#/$defs/ToolAction"
          },
          "title": "Allowed Actions",
          "type": "array",
          "uniqueItems": true
        }
      },
      "title": "AuthoritySnapshot",
      "type": "object"
    },
    "CompletionEvidence": {
      "additionalProperties": false,
      "properties": {
        "kind": {
          "minLength": 1,
          "title": "Kind",
          "type": "string"
        },
        "reference": {
          "minLength": 1,
          "title": "Reference",
          "type": "string"
        },
        "summary": {
          "default": "",
          "title": "Summary",
          "type": "string"
        },
        "covered_criteria": {
          "items": {
            "type": "string"
          },
          "title": "Covered Criteria",
          "type": "array"
        },
        "recorded_at": {
          "title": "Recorded At",
          "type": "string"
        }
      },
      "required": [
        "kind",
        "reference",
        "recorded_at"
      ],
      "title": "CompletionEvidence",
      "type": "object"
    },
    "GoalRecord": {
      "additionalProperties": false,
      "properties": {
        "schema_version": {
          "const": 4,
          "default": 4,
          "title": "Schema Version",
          "type": "integer"
        },
        "id": {
          "minLength": 1,
          "pattern": "^goal-[a-f0-9]{12}$",
          "title": "Id",
          "type": "string"
        },
        "session_id": {
          "default": "legacy",
          "minLength": 1,
          "title": "Session Id",
          "type": "string"
        },
        "objective": {
          "minLength": 1,
          "title": "Objective",
          "type": "string"
        },
        "status": {
          "default": "active",
          "enum": [
            "active",
            "paused",
            "blocked",
            "completed",
            "cleared"
          ],
          "title": "Status",
          "type": "string"
        },
        "status_reason": {
          "default": "",
          "title": "Status Reason",
          "type": "string"
        },
        "token_budget": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Token Budget"
        },
        "tokens_used": {
          "default": 0,
          "minimum": 0,
          "title": "Tokens Used",
          "type": "integer"
        },
        "token_reservations": {
          "additionalProperties": {
            "exclusiveMinimum": 0,
            "type": "integer"
          },
          "title": "Token Reservations",
          "type": "object"
        },
        "elapsed_ms": {
          "default": 0,
          "minimum": 0,
          "title": "Elapsed Ms",
          "type": "integer"
        },
        "auto_continue": {
          "default": false,
          "title": "Auto Continue",
          "type": "boolean"
        },
        "max_auto_turns": {
          "default": 3,
          "maximum": 100,
          "minimum": 1,
          "title": "Max Auto Turns",
          "type": "integer"
        },
        "auto_turns_used": {
          "default": 0,
          "minimum": 0,
          "title": "Auto Turns Used",
          "type": "integer"
        },
        "max_wall_seconds": {
          "default": 1800,
          "maximum": 86400,
          "minimum": 1,
          "title": "Max Wall Seconds",
          "type": "integer"
        },
        "auto_window_started_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Auto Window Started At"
        },
        "permission_ceiling": {
          "$ref": "#/$defs/AuthoritySnapshot"
        },
        "paused_reason": {
          "default": "",
          "title": "Paused Reason",
          "type": "string"
        },
        "paused_needs_confirmation": {
          "default": false,
          "title": "Paused Needs Confirmation",
          "type": "boolean"
        },
        "constraints": {
          "items": {
            "type": "string"
          },
          "title": "Constraints",
          "type": "array"
        },
        "completion_criteria": {
          "items": {
            "type": "string"
          },
          "title": "Completion Criteria",
          "type": "array"
        },
        "linked_task_ids": {
          "items": {
            "type": "integer"
          },
          "title": "Linked Task Ids",
          "type": "array"
        },
        "linked_run_ids": {
          "items": {
            "type": "string"
          },
          "title": "Linked Run Ids",
          "type": "array"
        },
        "current_run_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Current Run Id"
        },
        "completion_evidence": {
          "items": {
            "$ref": "#/$defs/CompletionEvidence"
          },
          "title": "Completion Evidence",
          "type": "array"
        },
        "timeline": {
          "items": {
            "$ref": "#/$defs/GoalTimelineEntry"
          },
          "title": "Timeline",
          "type": "array"
        },
        "created_at": {
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "title": "Updated At",
          "type": "string"
        }
      },
      "required": [
        "id",
        "objective",
        "created_at",
        "updated_at"
      ],
      "title": "GoalRecord",
      "type": "object"
    },
    "GoalTimelineEntry": {
      "additionalProperties": false,
      "properties": {
        "seq": {
          "minimum": 1,
          "title": "Seq",
          "type": "integer"
        },
        "event": {
          "minLength": 1,
          "title": "Event",
          "type": "string"
        },
        "actor": {
          "minLength": 1,
          "title": "Actor",
          "type": "string"
        },
        "at": {
          "title": "At",
          "type": "string"
        },
        "details": {
          "additionalProperties": {
            "$ref": "#/$defs/JsonValue"
          },
          "title": "Details",
          "type": "object"
        }
      },
      "required": [
        "seq",
        "event",
        "actor",
        "at"
      ],
      "title": "GoalTimelineEntry",
      "type": "object"
    },
    "JsonValue": {},
    "RuntimeMode": {
      "enum": [
        "plan",
        "act",
        "operate",
        "review"
      ],
      "title": "RuntimeMode",
      "type": "string"
    },
    "SandboxCapability": {
      "additionalProperties": false,
      "properties": {
        "available": {
          "title": "Available",
          "type": "boolean"
        },
        "kind": {
          "enum": [
            "none",
            "windows_none",
            "windows_acl",
            "linux_bwrap",
            "macos_seatbelt"
          ],
          "title": "Kind",
          "type": "string"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        }
      },
      "required": [
        "available",
        "kind",
        "reason"
      ],
      "title": "SandboxCapability",
      "type": "object"
    },
    "ToolAction": {
      "enum": [
        "read",
        "mutate",
        "shell",
        "external"
      ],
      "title": "ToolAction",
      "type": "string"
    },
    "WorkspaceTrust": {
      "enum": [
        "untrusted",
        "trusted"
      ],
      "title": "WorkspaceTrust",
      "type": "string"
    }
  },
  "properties": {
    "goal": {
      "$ref": "#/$defs/GoalRecord"
    },
    "run_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Run Id"
    }
  },
  "required": [
    "goal"
  ],
  "title": "GoalCreateResult",
  "type": "object"
}
```

### GoalGetCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `goal_id` | `string` | no |
| `session_id` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "goal.get",
      "default": "goal.get",
      "title": "Type",
      "type": "string"
    },
    "goal_id": {
      "default": "",
      "title": "Goal Id",
      "type": "string"
    },
    "session_id": {
      "default": "",
      "title": "Session Id",
      "type": "string"
    }
  },
  "title": "GoalGetCommand",
  "type": "object"
}
```

### GoalGetResult

| Field | Type | Required |
|---|---|---|
| `goal` | `? | null` | no |

```json
{
  "$defs": {
    "AuthorityProfile": {
      "enum": [
        "ask",
        "auto_review",
        "full_access"
      ],
      "title": "AuthorityProfile",
      "type": "string"
    },
    "AuthoritySnapshot": {
      "additionalProperties": false,
      "properties": {
        "mode": {
          "$ref": "#/$defs/RuntimeMode",
          "default": "act"
        },
        "profile": {
          "$ref": "#/$defs/AuthorityProfile",
          "default": "ask"
        },
        "workspace_trust": {
          "$ref": "#/$defs/WorkspaceTrust",
          "default": "untrusted"
        },
        "sandbox": {
          "$ref": "#/$defs/SandboxCapability"
        },
        "allowed_actions": {
          "items": {
            "$ref": "#/$defs/ToolAction"
          },
          "title": "Allowed Actions",
          "type": "array",
          "uniqueItems": true
        }
      },
      "title": "AuthoritySnapshot",
      "type": "object"
    },
    "CompletionEvidence": {
      "additionalProperties": false,
      "properties": {
        "kind": {
          "minLength": 1,
          "title": "Kind",
          "type": "string"
        },
        "reference": {
          "minLength": 1,
          "title": "Reference",
          "type": "string"
        },
        "summary": {
          "default": "",
          "title": "Summary",
          "type": "string"
        },
        "covered_criteria": {
          "items": {
            "type": "string"
          },
          "title": "Covered Criteria",
          "type": "array"
        },
        "recorded_at": {
          "title": "Recorded At",
          "type": "string"
        }
      },
      "required": [
        "kind",
        "reference",
        "recorded_at"
      ],
      "title": "CompletionEvidence",
      "type": "object"
    },
    "GoalRecord": {
      "additionalProperties": false,
      "properties": {
        "schema_version": {
          "const": 4,
          "default": 4,
          "title": "Schema Version",
          "type": "integer"
        },
        "id": {
          "minLength": 1,
          "pattern": "^goal-[a-f0-9]{12}$",
          "title": "Id",
          "type": "string"
        },
        "session_id": {
          "default": "legacy",
          "minLength": 1,
          "title": "Session Id",
          "type": "string"
        },
        "objective": {
          "minLength": 1,
          "title": "Objective",
          "type": "string"
        },
        "status": {
          "default": "active",
          "enum": [
            "active",
            "paused",
            "blocked",
            "completed",
            "cleared"
          ],
          "title": "Status",
          "type": "string"
        },
        "status_reason": {
          "default": "",
          "title": "Status Reason",
          "type": "string"
        },
        "token_budget": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Token Budget"
        },
        "tokens_used": {
          "default": 0,
          "minimum": 0,
          "title": "Tokens Used",
          "type": "integer"
        },
        "token_reservations": {
          "additionalProperties": {
            "exclusiveMinimum": 0,
            "type": "integer"
          },
          "title": "Token Reservations",
          "type": "object"
        },
        "elapsed_ms": {
          "default": 0,
          "minimum": 0,
          "title": "Elapsed Ms",
          "type": "integer"
        },
        "auto_continue": {
          "default": false,
          "title": "Auto Continue",
          "type": "boolean"
        },
        "max_auto_turns": {
          "default": 3,
          "maximum": 100,
          "minimum": 1,
          "title": "Max Auto Turns",
          "type": "integer"
        },
        "auto_turns_used": {
          "default": 0,
          "minimum": 0,
          "title": "Auto Turns Used",
          "type": "integer"
        },
        "max_wall_seconds": {
          "default": 1800,
          "maximum": 86400,
          "minimum": 1,
          "title": "Max Wall Seconds",
          "type": "integer"
        },
        "auto_window_started_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Auto Window Started At"
        },
        "permission_ceiling": {
          "$ref": "#/$defs/AuthoritySnapshot"
        },
        "paused_reason": {
          "default": "",
          "title": "Paused Reason",
          "type": "string"
        },
        "paused_needs_confirmation": {
          "default": false,
          "title": "Paused Needs Confirmation",
          "type": "boolean"
        },
        "constraints": {
          "items": {
            "type": "string"
          },
          "title": "Constraints",
          "type": "array"
        },
        "completion_criteria": {
          "items": {
            "type": "string"
          },
          "title": "Completion Criteria",
          "type": "array"
        },
        "linked_task_ids": {
          "items": {
            "type": "integer"
          },
          "title": "Linked Task Ids",
          "type": "array"
        },
        "linked_run_ids": {
          "items": {
            "type": "string"
          },
          "title": "Linked Run Ids",
          "type": "array"
        },
        "current_run_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Current Run Id"
        },
        "completion_evidence": {
          "items": {
            "$ref": "#/$defs/CompletionEvidence"
          },
          "title": "Completion Evidence",
          "type": "array"
        },
        "timeline": {
          "items": {
            "$ref": "#/$defs/GoalTimelineEntry"
          },
          "title": "Timeline",
          "type": "array"
        },
        "created_at": {
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "title": "Updated At",
          "type": "string"
        }
      },
      "required": [
        "id",
        "objective",
        "created_at",
        "updated_at"
      ],
      "title": "GoalRecord",
      "type": "object"
    },
    "GoalTimelineEntry": {
      "additionalProperties": false,
      "properties": {
        "seq": {
          "minimum": 1,
          "title": "Seq",
          "type": "integer"
        },
        "event": {
          "minLength": 1,
          "title": "Event",
          "type": "string"
        },
        "actor": {
          "minLength": 1,
          "title": "Actor",
          "type": "string"
        },
        "at": {
          "title": "At",
          "type": "string"
        },
        "details": {
          "additionalProperties": {
            "$ref": "#/$defs/JsonValue"
          },
          "title": "Details",
          "type": "object"
        }
      },
      "required": [
        "seq",
        "event",
        "actor",
        "at"
      ],
      "title": "GoalTimelineEntry",
      "type": "object"
    },
    "JsonValue": {},
    "RuntimeMode": {
      "enum": [
        "plan",
        "act",
        "operate",
        "review"
      ],
      "title": "RuntimeMode",
      "type": "string"
    },
    "SandboxCapability": {
      "additionalProperties": false,
      "properties": {
        "available": {
          "title": "Available",
          "type": "boolean"
        },
        "kind": {
          "enum": [
            "none",
            "windows_none",
            "windows_acl",
            "linux_bwrap",
            "macos_seatbelt"
          ],
          "title": "Kind",
          "type": "string"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        }
      },
      "required": [
        "available",
        "kind",
        "reason"
      ],
      "title": "SandboxCapability",
      "type": "object"
    },
    "ToolAction": {
      "enum": [
        "read",
        "mutate",
        "shell",
        "external"
      ],
      "title": "ToolAction",
      "type": "string"
    },
    "WorkspaceTrust": {
      "enum": [
        "untrusted",
        "trusted"
      ],
      "title": "WorkspaceTrust",
      "type": "string"
    }
  },
  "properties": {
    "goal": {
      "anyOf": [
        {
          "$ref": "#/$defs/GoalRecord"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "title": "GoalGetResult",
  "type": "object"
}
```

### GoalListCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | no |
| `status` | `string | null` | no |
| `limit` | `integer` | no |

```json
{
  "properties": {
    "type": {
      "const": "goal.list",
      "default": "goal.list",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "default": "",
      "title": "Session Id",
      "type": "string"
    },
    "status": {
      "anyOf": [
        {
          "enum": [
            "active",
            "paused",
            "blocked",
            "completed",
            "cleared"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Status"
    },
    "limit": {
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "GoalListCommand",
  "type": "object"
}
```

### GoalListResult

| Field | Type | Required |
|---|---|---|
| `goals` | `array` | no |

```json
{
  "$defs": {
    "AuthorityProfile": {
      "enum": [
        "ask",
        "auto_review",
        "full_access"
      ],
      "title": "AuthorityProfile",
      "type": "string"
    },
    "AuthoritySnapshot": {
      "additionalProperties": false,
      "properties": {
        "mode": {
          "$ref": "#/$defs/RuntimeMode",
          "default": "act"
        },
        "profile": {
          "$ref": "#/$defs/AuthorityProfile",
          "default": "ask"
        },
        "workspace_trust": {
          "$ref": "#/$defs/WorkspaceTrust",
          "default": "untrusted"
        },
        "sandbox": {
          "$ref": "#/$defs/SandboxCapability"
        },
        "allowed_actions": {
          "items": {
            "$ref": "#/$defs/ToolAction"
          },
          "title": "Allowed Actions",
          "type": "array",
          "uniqueItems": true
        }
      },
      "title": "AuthoritySnapshot",
      "type": "object"
    },
    "CompletionEvidence": {
      "additionalProperties": false,
      "properties": {
        "kind": {
          "minLength": 1,
          "title": "Kind",
          "type": "string"
        },
        "reference": {
          "minLength": 1,
          "title": "Reference",
          "type": "string"
        },
        "summary": {
          "default": "",
          "title": "Summary",
          "type": "string"
        },
        "covered_criteria": {
          "items": {
            "type": "string"
          },
          "title": "Covered Criteria",
          "type": "array"
        },
        "recorded_at": {
          "title": "Recorded At",
          "type": "string"
        }
      },
      "required": [
        "kind",
        "reference",
        "recorded_at"
      ],
      "title": "CompletionEvidence",
      "type": "object"
    },
    "GoalRecord": {
      "additionalProperties": false,
      "properties": {
        "schema_version": {
          "const": 4,
          "default": 4,
          "title": "Schema Version",
          "type": "integer"
        },
        "id": {
          "minLength": 1,
          "pattern": "^goal-[a-f0-9]{12}$",
          "title": "Id",
          "type": "string"
        },
        "session_id": {
          "default": "legacy",
          "minLength": 1,
          "title": "Session Id",
          "type": "string"
        },
        "objective": {
          "minLength": 1,
          "title": "Objective",
          "type": "string"
        },
        "status": {
          "default": "active",
          "enum": [
            "active",
            "paused",
            "blocked",
            "completed",
            "cleared"
          ],
          "title": "Status",
          "type": "string"
        },
        "status_reason": {
          "default": "",
          "title": "Status Reason",
          "type": "string"
        },
        "token_budget": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Token Budget"
        },
        "tokens_used": {
          "default": 0,
          "minimum": 0,
          "title": "Tokens Used",
          "type": "integer"
        },
        "token_reservations": {
          "additionalProperties": {
            "exclusiveMinimum": 0,
            "type": "integer"
          },
          "title": "Token Reservations",
          "type": "object"
        },
        "elapsed_ms": {
          "default": 0,
          "minimum": 0,
          "title": "Elapsed Ms",
          "type": "integer"
        },
        "auto_continue": {
          "default": false,
          "title": "Auto Continue",
          "type": "boolean"
        },
        "max_auto_turns": {
          "default": 3,
          "maximum": 100,
          "minimum": 1,
          "title": "Max Auto Turns",
          "type": "integer"
        },
        "auto_turns_used": {
          "default": 0,
          "minimum": 0,
          "title": "Auto Turns Used",
          "type": "integer"
        },
        "max_wall_seconds": {
          "default": 1800,
          "maximum": 86400,
          "minimum": 1,
          "title": "Max Wall Seconds",
          "type": "integer"
        },
        "auto_window_started_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Auto Window Started At"
        },
        "permission_ceiling": {
          "$ref": "#/$defs/AuthoritySnapshot"
        },
        "paused_reason": {
          "default": "",
          "title": "Paused Reason",
          "type": "string"
        },
        "paused_needs_confirmation": {
          "default": false,
          "title": "Paused Needs Confirmation",
          "type": "boolean"
        },
        "constraints": {
          "items": {
            "type": "string"
          },
          "title": "Constraints",
          "type": "array"
        },
        "completion_criteria": {
          "items": {
            "type": "string"
          },
          "title": "Completion Criteria",
          "type": "array"
        },
        "linked_task_ids": {
          "items": {
            "type": "integer"
          },
          "title": "Linked Task Ids",
          "type": "array"
        },
        "linked_run_ids": {
          "items": {
            "type": "string"
          },
          "title": "Linked Run Ids",
          "type": "array"
        },
        "current_run_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Current Run Id"
        },
        "completion_evidence": {
          "items": {
            "$ref": "#/$defs/CompletionEvidence"
          },
          "title": "Completion Evidence",
          "type": "array"
        },
        "timeline": {
          "items": {
            "$ref": "#/$defs/GoalTimelineEntry"
          },
          "title": "Timeline",
          "type": "array"
        },
        "created_at": {
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "title": "Updated At",
          "type": "string"
        }
      },
      "required": [
        "id",
        "objective",
        "created_at",
        "updated_at"
      ],
      "title": "GoalRecord",
      "type": "object"
    },
    "GoalTimelineEntry": {
      "additionalProperties": false,
      "properties": {
        "seq": {
          "minimum": 1,
          "title": "Seq",
          "type": "integer"
        },
        "event": {
          "minLength": 1,
          "title": "Event",
          "type": "string"
        },
        "actor": {
          "minLength": 1,
          "title": "Actor",
          "type": "string"
        },
        "at": {
          "title": "At",
          "type": "string"
        },
        "details": {
          "additionalProperties": {
            "$ref": "#/$defs/JsonValue"
          },
          "title": "Details",
          "type": "object"
        }
      },
      "required": [
        "seq",
        "event",
        "actor",
        "at"
      ],
      "title": "GoalTimelineEntry",
      "type": "object"
    },
    "JsonValue": {},
    "RuntimeMode": {
      "enum": [
        "plan",
        "act",
        "operate",
        "review"
      ],
      "title": "RuntimeMode",
      "type": "string"
    },
    "SandboxCapability": {
      "additionalProperties": false,
      "properties": {
        "available": {
          "title": "Available",
          "type": "boolean"
        },
        "kind": {
          "enum": [
            "none",
            "windows_none",
            "windows_acl",
            "linux_bwrap",
            "macos_seatbelt"
          ],
          "title": "Kind",
          "type": "string"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        }
      },
      "required": [
        "available",
        "kind",
        "reason"
      ],
      "title": "SandboxCapability",
      "type": "object"
    },
    "ToolAction": {
      "enum": [
        "read",
        "mutate",
        "shell",
        "external"
      ],
      "title": "ToolAction",
      "type": "string"
    },
    "WorkspaceTrust": {
      "enum": [
        "untrusted",
        "trusted"
      ],
      "title": "WorkspaceTrust",
      "type": "string"
    }
  },
  "properties": {
    "goals": {
      "items": {
        "$ref": "#/$defs/GoalRecord"
      },
      "title": "Goals",
      "type": "array"
    }
  },
  "title": "GoalListResult",
  "type": "object"
}
```

### GoalEditCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `goal_id` | `string` | no |
| `session_id` | `string` | no |
| `objective` | `string` | yes |
| `completion_criteria` | `array | null` | no |

```json
{
  "properties": {
    "type": {
      "const": "goal.edit",
      "default": "goal.edit",
      "title": "Type",
      "type": "string"
    },
    "goal_id": {
      "default": "",
      "title": "Goal Id",
      "type": "string"
    },
    "session_id": {
      "default": "",
      "title": "Session Id",
      "type": "string"
    },
    "objective": {
      "maxLength": 100000,
      "minLength": 1,
      "title": "Objective",
      "type": "string"
    },
    "completion_criteria": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Completion Criteria"
    }
  },
  "required": [
    "objective"
  ],
  "title": "GoalEditCommand",
  "type": "object"
}
```

### GoalPauseCommand

| Field | Type | Required |
|---|---|---|
| `goal_id` | `string` | no |
| `session_id` | `string` | no |
| `type` | `string` | no |

```json
{
  "properties": {
    "goal_id": {
      "default": "",
      "title": "Goal Id",
      "type": "string"
    },
    "session_id": {
      "default": "",
      "title": "Session Id",
      "type": "string"
    },
    "type": {
      "const": "goal.pause",
      "default": "goal.pause",
      "title": "Type",
      "type": "string"
    }
  },
  "title": "GoalPauseCommand",
  "type": "object"
}
```

### GoalResumeCommand

| Field | Type | Required |
|---|---|---|
| `goal_id` | `string` | no |
| `session_id` | `string` | no |
| `type` | `string` | no |

```json
{
  "properties": {
    "goal_id": {
      "default": "",
      "title": "Goal Id",
      "type": "string"
    },
    "session_id": {
      "default": "",
      "title": "Session Id",
      "type": "string"
    },
    "type": {
      "const": "goal.resume",
      "default": "goal.resume",
      "title": "Type",
      "type": "string"
    }
  },
  "title": "GoalResumeCommand",
  "type": "object"
}
```

### GoalClearCommand

| Field | Type | Required |
|---|---|---|
| `goal_id` | `string` | no |
| `session_id` | `string` | no |
| `type` | `string` | no |

```json
{
  "properties": {
    "goal_id": {
      "default": "",
      "title": "Goal Id",
      "type": "string"
    },
    "session_id": {
      "default": "",
      "title": "Session Id",
      "type": "string"
    },
    "type": {
      "const": "goal.clear",
      "default": "goal.clear",
      "title": "Type",
      "type": "string"
    }
  },
  "title": "GoalClearCommand",
  "type": "object"
}
```

### GoalCompleteCommand

| Field | Type | Required |
|---|---|---|
| `goal_id` | `string` | no |
| `session_id` | `string` | no |
| `type` | `string` | no |
| `summary` | `string` | no |

```json
{
  "properties": {
    "goal_id": {
      "default": "",
      "title": "Goal Id",
      "type": "string"
    },
    "session_id": {
      "default": "",
      "title": "Session Id",
      "type": "string"
    },
    "type": {
      "const": "goal.complete",
      "default": "goal.complete",
      "title": "Type",
      "type": "string"
    },
    "summary": {
      "default": "",
      "maxLength": 4000,
      "title": "Summary",
      "type": "string"
    }
  },
  "title": "GoalCompleteCommand",
  "type": "object"
}
```

### GoalContinueDecisionCommand

| Field | Type | Required |
|---|---|---|
| `goal_id` | `string` | no |
| `session_id` | `string` | no |
| `type` | `string` | no |

```json
{
  "properties": {
    "goal_id": {
      "default": "",
      "title": "Goal Id",
      "type": "string"
    },
    "session_id": {
      "default": "",
      "title": "Session Id",
      "type": "string"
    },
    "type": {
      "const": "goal.continue_decision",
      "default": "goal.continue_decision",
      "title": "Type",
      "type": "string"
    }
  },
  "title": "GoalContinueDecisionCommand",
  "type": "object"
}
```

### GoalContinueDecisionResult

| Field | Type | Required |
|---|---|---|
| `goal` | `object` | yes |
| `decision` | `object` | yes |

```json
{
  "$defs": {
    "AuthorityProfile": {
      "enum": [
        "ask",
        "auto_review",
        "full_access"
      ],
      "title": "AuthorityProfile",
      "type": "string"
    },
    "AuthoritySnapshot": {
      "additionalProperties": false,
      "properties": {
        "mode": {
          "$ref": "#/$defs/RuntimeMode",
          "default": "act"
        },
        "profile": {
          "$ref": "#/$defs/AuthorityProfile",
          "default": "ask"
        },
        "workspace_trust": {
          "$ref": "#/$defs/WorkspaceTrust",
          "default": "untrusted"
        },
        "sandbox": {
          "$ref": "#/$defs/SandboxCapability"
        },
        "allowed_actions": {
          "items": {
            "$ref": "#/$defs/ToolAction"
          },
          "title": "Allowed Actions",
          "type": "array",
          "uniqueItems": true
        }
      },
      "title": "AuthoritySnapshot",
      "type": "object"
    },
    "CompletionEvidence": {
      "additionalProperties": false,
      "properties": {
        "kind": {
          "minLength": 1,
          "title": "Kind",
          "type": "string"
        },
        "reference": {
          "minLength": 1,
          "title": "Reference",
          "type": "string"
        },
        "summary": {
          "default": "",
          "title": "Summary",
          "type": "string"
        },
        "covered_criteria": {
          "items": {
            "type": "string"
          },
          "title": "Covered Criteria",
          "type": "array"
        },
        "recorded_at": {
          "title": "Recorded At",
          "type": "string"
        }
      },
      "required": [
        "kind",
        "reference",
        "recorded_at"
      ],
      "title": "CompletionEvidence",
      "type": "object"
    },
    "GoalContinueDecision": {
      "additionalProperties": false,
      "properties": {
        "goal_id": {
          "title": "Goal Id",
          "type": "string"
        },
        "session_id": {
          "title": "Session Id",
          "type": "string"
        },
        "should_continue": {
          "title": "Should Continue",
          "type": "boolean"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        },
        "auto_turns_used": {
          "minimum": 0,
          "title": "Auto Turns Used",
          "type": "integer"
        },
        "remaining_auto_turns": {
          "minimum": 0,
          "title": "Remaining Auto Turns",
          "type": "integer"
        },
        "tokens_used": {
          "minimum": 0,
          "title": "Tokens Used",
          "type": "integer"
        },
        "token_budget": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Token Budget"
        },
        "remaining_tokens": {
          "anyOf": [
            {
              "minimum": 0,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Remaining Tokens"
        },
        "wall_elapsed_seconds": {
          "minimum": 0,
          "title": "Wall Elapsed Seconds",
          "type": "integer"
        },
        "max_wall_seconds": {
          "minimum": 1,
          "title": "Max Wall Seconds",
          "type": "integer"
        },
        "permission_ceiling": {
          "$ref": "#/$defs/AuthoritySnapshot"
        },
        "paused_needs_confirmation": {
          "default": false,
          "title": "Paused Needs Confirmation",
          "type": "boolean"
        },
        "decided_at": {
          "title": "Decided At",
          "type": "string"
        }
      },
      "required": [
        "goal_id",
        "session_id",
        "should_continue",
        "reason",
        "auto_turns_used",
        "remaining_auto_turns",
        "tokens_used",
        "wall_elapsed_seconds",
        "max_wall_seconds",
        "permission_ceiling",
        "decided_at"
      ],
      "title": "GoalContinueDecision",
      "type": "object"
    },
    "GoalRecord": {
      "additionalProperties": false,
      "properties": {
        "schema_version": {
          "const": 4,
          "default": 4,
          "title": "Schema Version",
          "type": "integer"
        },
        "id": {
          "minLength": 1,
          "pattern": "^goal-[a-f0-9]{12}$",
          "title": "Id",
          "type": "string"
        },
        "session_id": {
          "default": "legacy",
          "minLength": 1,
          "title": "Session Id",
          "type": "string"
        },
        "objective": {
          "minLength": 1,
          "title": "Objective",
          "type": "string"
        },
        "status": {
          "default": "active",
          "enum": [
            "active",
            "paused",
            "blocked",
            "completed",
            "cleared"
          ],
          "title": "Status",
          "type": "string"
        },
        "status_reason": {
          "default": "",
          "title": "Status Reason",
          "type": "string"
        },
        "token_budget": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Token Budget"
        },
        "tokens_used": {
          "default": 0,
          "minimum": 0,
          "title": "Tokens Used",
          "type": "integer"
        },
        "token_reservations": {
          "additionalProperties": {
            "exclusiveMinimum": 0,
            "type": "integer"
          },
          "title": "Token Reservations",
          "type": "object"
        },
        "elapsed_ms": {
          "default": 0,
          "minimum": 0,
          "title": "Elapsed Ms",
          "type": "integer"
        },
        "auto_continue": {
          "default": false,
          "title": "Auto Continue",
          "type": "boolean"
        },
        "max_auto_turns": {
          "default": 3,
          "maximum": 100,
          "minimum": 1,
          "title": "Max Auto Turns",
          "type": "integer"
        },
        "auto_turns_used": {
          "default": 0,
          "minimum": 0,
          "title": "Auto Turns Used",
          "type": "integer"
        },
        "max_wall_seconds": {
          "default": 1800,
          "maximum": 86400,
          "minimum": 1,
          "title": "Max Wall Seconds",
          "type": "integer"
        },
        "auto_window_started_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Auto Window Started At"
        },
        "permission_ceiling": {
          "$ref": "#/$defs/AuthoritySnapshot"
        },
        "paused_reason": {
          "default": "",
          "title": "Paused Reason",
          "type": "string"
        },
        "paused_needs_confirmation": {
          "default": false,
          "title": "Paused Needs Confirmation",
          "type": "boolean"
        },
        "constraints": {
          "items": {
            "type": "string"
          },
          "title": "Constraints",
          "type": "array"
        },
        "completion_criteria": {
          "items": {
            "type": "string"
          },
          "title": "Completion Criteria",
          "type": "array"
        },
        "linked_task_ids": {
          "items": {
            "type": "integer"
          },
          "title": "Linked Task Ids",
          "type": "array"
        },
        "linked_run_ids": {
          "items": {
            "type": "string"
          },
          "title": "Linked Run Ids",
          "type": "array"
        },
        "current_run_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Current Run Id"
        },
        "completion_evidence": {
          "items": {
            "$ref": "#/$defs/CompletionEvidence"
          },
          "title": "Completion Evidence",
          "type": "array"
        },
        "timeline": {
          "items": {
            "$ref": "#/$defs/GoalTimelineEntry"
          },
          "title": "Timeline",
          "type": "array"
        },
        "created_at": {
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "title": "Updated At",
          "type": "string"
        }
      },
      "required": [
        "id",
        "objective",
        "created_at",
        "updated_at"
      ],
      "title": "GoalRecord",
      "type": "object"
    },
    "GoalTimelineEntry": {
      "additionalProperties": false,
      "properties": {
        "seq": {
          "minimum": 1,
          "title": "Seq",
          "type": "integer"
        },
        "event": {
          "minLength": 1,
          "title": "Event",
          "type": "string"
        },
        "actor": {
          "minLength": 1,
          "title": "Actor",
          "type": "string"
        },
        "at": {
          "title": "At",
          "type": "string"
        },
        "details": {
          "additionalProperties": {
            "$ref": "#/$defs/JsonValue"
          },
          "title": "Details",
          "type": "object"
        }
      },
      "required": [
        "seq",
        "event",
        "actor",
        "at"
      ],
      "title": "GoalTimelineEntry",
      "type": "object"
    },
    "JsonValue": {},
    "RuntimeMode": {
      "enum": [
        "plan",
        "act",
        "operate",
        "review"
      ],
      "title": "RuntimeMode",
      "type": "string"
    },
    "SandboxCapability": {
      "additionalProperties": false,
      "properties": {
        "available": {
          "title": "Available",
          "type": "boolean"
        },
        "kind": {
          "enum": [
            "none",
            "windows_none",
            "windows_acl",
            "linux_bwrap",
            "macos_seatbelt"
          ],
          "title": "Kind",
          "type": "string"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        }
      },
      "required": [
        "available",
        "kind",
        "reason"
      ],
      "title": "SandboxCapability",
      "type": "object"
    },
    "ToolAction": {
      "enum": [
        "read",
        "mutate",
        "shell",
        "external"
      ],
      "title": "ToolAction",
      "type": "string"
    },
    "WorkspaceTrust": {
      "enum": [
        "untrusted",
        "trusted"
      ],
      "title": "WorkspaceTrust",
      "type": "string"
    }
  },
  "properties": {
    "goal": {
      "$ref": "#/$defs/GoalRecord"
    },
    "decision": {
      "$ref": "#/$defs/GoalContinueDecision"
    }
  },
  "required": [
    "goal",
    "decision"
  ],
  "title": "GoalContinueDecisionResult",
  "type": "object"
}
```

### GoalActionResult

| Field | Type | Required |
|---|---|---|
| `goal` | `object` | yes |
| `run_id` | `string | null` | no |

```json
{
  "$defs": {
    "AuthorityProfile": {
      "enum": [
        "ask",
        "auto_review",
        "full_access"
      ],
      "title": "AuthorityProfile",
      "type": "string"
    },
    "AuthoritySnapshot": {
      "additionalProperties": false,
      "properties": {
        "mode": {
          "$ref": "#/$defs/RuntimeMode",
          "default": "act"
        },
        "profile": {
          "$ref": "#/$defs/AuthorityProfile",
          "default": "ask"
        },
        "workspace_trust": {
          "$ref": "#/$defs/WorkspaceTrust",
          "default": "untrusted"
        },
        "sandbox": {
          "$ref": "#/$defs/SandboxCapability"
        },
        "allowed_actions": {
          "items": {
            "$ref": "#/$defs/ToolAction"
          },
          "title": "Allowed Actions",
          "type": "array",
          "uniqueItems": true
        }
      },
      "title": "AuthoritySnapshot",
      "type": "object"
    },
    "CompletionEvidence": {
      "additionalProperties": false,
      "properties": {
        "kind": {
          "minLength": 1,
          "title": "Kind",
          "type": "string"
        },
        "reference": {
          "minLength": 1,
          "title": "Reference",
          "type": "string"
        },
        "summary": {
          "default": "",
          "title": "Summary",
          "type": "string"
        },
        "covered_criteria": {
          "items": {
            "type": "string"
          },
          "title": "Covered Criteria",
          "type": "array"
        },
        "recorded_at": {
          "title": "Recorded At",
          "type": "string"
        }
      },
      "required": [
        "kind",
        "reference",
        "recorded_at"
      ],
      "title": "CompletionEvidence",
      "type": "object"
    },
    "GoalRecord": {
      "additionalProperties": false,
      "properties": {
        "schema_version": {
          "const": 4,
          "default": 4,
          "title": "Schema Version",
          "type": "integer"
        },
        "id": {
          "minLength": 1,
          "pattern": "^goal-[a-f0-9]{12}$",
          "title": "Id",
          "type": "string"
        },
        "session_id": {
          "default": "legacy",
          "minLength": 1,
          "title": "Session Id",
          "type": "string"
        },
        "objective": {
          "minLength": 1,
          "title": "Objective",
          "type": "string"
        },
        "status": {
          "default": "active",
          "enum": [
            "active",
            "paused",
            "blocked",
            "completed",
            "cleared"
          ],
          "title": "Status",
          "type": "string"
        },
        "status_reason": {
          "default": "",
          "title": "Status Reason",
          "type": "string"
        },
        "token_budget": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Token Budget"
        },
        "tokens_used": {
          "default": 0,
          "minimum": 0,
          "title": "Tokens Used",
          "type": "integer"
        },
        "token_reservations": {
          "additionalProperties": {
            "exclusiveMinimum": 0,
            "type": "integer"
          },
          "title": "Token Reservations",
          "type": "object"
        },
        "elapsed_ms": {
          "default": 0,
          "minimum": 0,
          "title": "Elapsed Ms",
          "type": "integer"
        },
        "auto_continue": {
          "default": false,
          "title": "Auto Continue",
          "type": "boolean"
        },
        "max_auto_turns": {
          "default": 3,
          "maximum": 100,
          "minimum": 1,
          "title": "Max Auto Turns",
          "type": "integer"
        },
        "auto_turns_used": {
          "default": 0,
          "minimum": 0,
          "title": "Auto Turns Used",
          "type": "integer"
        },
        "max_wall_seconds": {
          "default": 1800,
          "maximum": 86400,
          "minimum": 1,
          "title": "Max Wall Seconds",
          "type": "integer"
        },
        "auto_window_started_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Auto Window Started At"
        },
        "permission_ceiling": {
          "$ref": "#/$defs/AuthoritySnapshot"
        },
        "paused_reason": {
          "default": "",
          "title": "Paused Reason",
          "type": "string"
        },
        "paused_needs_confirmation": {
          "default": false,
          "title": "Paused Needs Confirmation",
          "type": "boolean"
        },
        "constraints": {
          "items": {
            "type": "string"
          },
          "title": "Constraints",
          "type": "array"
        },
        "completion_criteria": {
          "items": {
            "type": "string"
          },
          "title": "Completion Criteria",
          "type": "array"
        },
        "linked_task_ids": {
          "items": {
            "type": "integer"
          },
          "title": "Linked Task Ids",
          "type": "array"
        },
        "linked_run_ids": {
          "items": {
            "type": "string"
          },
          "title": "Linked Run Ids",
          "type": "array"
        },
        "current_run_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Current Run Id"
        },
        "completion_evidence": {
          "items": {
            "$ref": "#/$defs/CompletionEvidence"
          },
          "title": "Completion Evidence",
          "type": "array"
        },
        "timeline": {
          "items": {
            "$ref": "#/$defs/GoalTimelineEntry"
          },
          "title": "Timeline",
          "type": "array"
        },
        "created_at": {
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "title": "Updated At",
          "type": "string"
        }
      },
      "required": [
        "id",
        "objective",
        "created_at",
        "updated_at"
      ],
      "title": "GoalRecord",
      "type": "object"
    },
    "GoalTimelineEntry": {
      "additionalProperties": false,
      "properties": {
        "seq": {
          "minimum": 1,
          "title": "Seq",
          "type": "integer"
        },
        "event": {
          "minLength": 1,
          "title": "Event",
          "type": "string"
        },
        "actor": {
          "minLength": 1,
          "title": "Actor",
          "type": "string"
        },
        "at": {
          "title": "At",
          "type": "string"
        },
        "details": {
          "additionalProperties": {
            "$ref": "#/$defs/JsonValue"
          },
          "title": "Details",
          "type": "object"
        }
      },
      "required": [
        "seq",
        "event",
        "actor",
        "at"
      ],
      "title": "GoalTimelineEntry",
      "type": "object"
    },
    "JsonValue": {},
    "RuntimeMode": {
      "enum": [
        "plan",
        "act",
        "operate",
        "review"
      ],
      "title": "RuntimeMode",
      "type": "string"
    },
    "SandboxCapability": {
      "additionalProperties": false,
      "properties": {
        "available": {
          "title": "Available",
          "type": "boolean"
        },
        "kind": {
          "enum": [
            "none",
            "windows_none",
            "windows_acl",
            "linux_bwrap",
            "macos_seatbelt"
          ],
          "title": "Kind",
          "type": "string"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        }
      },
      "required": [
        "available",
        "kind",
        "reason"
      ],
      "title": "SandboxCapability",
      "type": "object"
    },
    "ToolAction": {
      "enum": [
        "read",
        "mutate",
        "shell",
        "external"
      ],
      "title": "ToolAction",
      "type": "string"
    },
    "WorkspaceTrust": {
      "enum": [
        "untrusted",
        "trusted"
      ],
      "title": "WorkspaceTrust",
      "type": "string"
    }
  },
  "properties": {
    "goal": {
      "$ref": "#/$defs/GoalRecord"
    },
    "run_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Run Id"
    }
  },
  "required": [
    "goal"
  ],
  "title": "GoalActionResult",
  "type": "object"
}
```

### RunCancelCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "run.cancel",
      "default": "run.cancel",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    }
  },
  "required": [
    "run_id"
  ],
  "title": "RunCancelCommand",
  "type": "object"
}
```

### RunCancelResult

| Field | Type | Required |
|---|---|---|
| `run_id` | `string` | yes |
| `session_id` | `string` | yes |
| `status` | `string` | no |

```json
{
  "properties": {
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "status": {
      "const": "cancelled",
      "default": "cancelled",
      "title": "Status",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "session_id"
  ],
  "title": "RunCancelResult",
  "type": "object"
}
```

### RunSteerCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `content` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "run.steer",
      "default": "run.steer",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "content": {
      "maxLength": 10000,
      "minLength": 1,
      "title": "Content",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "content"
  ],
  "title": "RunSteerCommand",
  "type": "object"
}
```

### RunSteerResult

| Field | Type | Required |
|---|---|---|
| `run_id` | `string` | yes |
| `queued` | `boolean` | no |

```json
{
  "properties": {
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "queued": {
      "const": true,
      "default": true,
      "title": "Queued",
      "type": "boolean"
    }
  },
  "required": [
    "run_id"
  ],
  "title": "RunSteerResult",
  "type": "object"
}
```

### PlanRespondCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `run_id` | `string` | yes |
| `decision` | `string` | yes |
| `revision` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "plan.respond",
      "default": "plan.respond",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "run_id": {
      "minLength": 1,
      "title": "Run Id",
      "type": "string"
    },
    "decision": {
      "enum": [
        "approve",
        "revise",
        "cancel"
      ],
      "title": "Decision",
      "type": "string"
    },
    "revision": {
      "default": "",
      "maxLength": 10000,
      "title": "Revision",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "run_id",
    "decision"
  ],
  "title": "PlanRespondCommand",
  "type": "object"
}
```

### PlanRespondResult

| Field | Type | Required |
|---|---|---|
| `session_id` | `string` | yes |
| `run_id` | `string` | yes |
| `decision` | `string` | yes |
| `status` | `string` | no |

```json
{
  "properties": {
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "decision": {
      "enum": [
        "approve",
        "revise",
        "cancel"
      ],
      "title": "Decision",
      "type": "string"
    },
    "status": {
      "const": "resolved",
      "default": "resolved",
      "title": "Status",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "run_id",
    "decision"
  ],
  "title": "PlanRespondResult",
  "type": "object"
}
```

### EventSubscribeCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `topics` | `array` | yes |
| `scope` | `string` | no |
| `replay_from_run` | `string | null` | no |
| `thread_id` | `string | null` | no |
| `after_seq` | `integer` | no |

```json
{
  "properties": {
    "type": {
      "const": "event.subscribe",
      "default": "event.subscribe",
      "title": "Type",
      "type": "string"
    },
    "topics": {
      "items": {
        "type": "string"
      },
      "title": "Topics",
      "type": "array"
    },
    "scope": {
      "default": "global",
      "title": "Scope",
      "type": "string"
    },
    "replay_from_run": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Replay From Run"
    },
    "thread_id": {
      "anyOf": [
        {
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Thread Id"
    },
    "after_seq": {
      "default": 0,
      "minimum": 0,
      "title": "After Seq",
      "type": "integer"
    }
  },
  "required": [
    "topics"
  ],
  "title": "EventSubscribeCommand",
  "type": "object"
}
```

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": "u-3",
  "method": "event.subscribe",
  "params": {
    "topics": [
      "run.*",
      "step.*",
      "agent.*",
      "tool.*",
      "llm.token"
    ],
    "scope": "global",
    "replay_from_run": null,
    "thread_id": null,
    "after_seq": 0
  }
}
```

### EventSubscribeResult

| Field | Type | Required |
|---|---|---|
| `subscription_id` | `string` | yes |
| `replayed_count` | `integer` | no |
| `last_seq` | `integer | null` | no |

```json
{
  "properties": {
    "subscription_id": {
      "title": "Subscription Id",
      "type": "string"
    },
    "replayed_count": {
      "default": 0,
      "title": "Replayed Count",
      "type": "integer"
    },
    "last_seq": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Last Seq"
    }
  },
  "required": [
    "subscription_id"
  ],
  "title": "EventSubscribeResult",
  "type": "object"
}
```

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": "u-3",
  "result": {
    "subscription_id": "sub-abc123",
    "replayed_count": 0,
    "last_seq": null
  }
}
```

### EventUnsubscribeCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `subscription_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "event.unsubscribe",
      "default": "event.unsubscribe",
      "title": "Type",
      "type": "string"
    },
    "subscription_id": {
      "minLength": 1,
      "title": "Subscription Id",
      "type": "string"
    }
  },
  "required": [
    "subscription_id"
  ],
  "title": "EventUnsubscribeCommand",
  "type": "object"
}
```

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": "u-4",
  "method": "event.unsubscribe",
  "params": {
    "subscription_id": "sub-abc123"
  }
}
```

### EventUnsubscribeResult

| Field | Type | Required |
|---|---|---|
| `subscription_id` | `string` | yes |
| `removed` | `boolean` | yes |

```json
{
  "properties": {
    "subscription_id": {
      "title": "Subscription Id",
      "type": "string"
    },
    "removed": {
      "title": "Removed",
      "type": "boolean"
    }
  },
  "required": [
    "subscription_id",
    "removed"
  ],
  "title": "EventUnsubscribeResult",
  "type": "object"
}
```

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": "u-4",
  "result": {
    "subscription_id": "sub-abc123",
    "removed": true
  }
}
```

### EventReplayCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `thread_id` | `string` | yes |
| `after_seq` | `integer` | no |
| `limit` | `integer` | no |

```json
{
  "properties": {
    "type": {
      "const": "event.replay",
      "default": "event.replay",
      "title": "Type",
      "type": "string"
    },
    "thread_id": {
      "minLength": 1,
      "title": "Thread Id",
      "type": "string"
    },
    "after_seq": {
      "default": 0,
      "minimum": 0,
      "title": "After Seq",
      "type": "integer"
    },
    "limit": {
      "default": 1000,
      "maximum": 1000,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "thread_id"
  ],
  "title": "EventReplayCommand",
  "type": "object"
}
```

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": "u-replay",
  "method": "event.replay",
  "params": {
    "thread_id": "sess-abc123def456",
    "after_seq": 0,
    "limit": 1000
  }
}
```

### EventReplayResult

| Field | Type | Required |
|---|---|---|
| `events` | `array` | yes |
| `latest_seq` | `integer` | yes |
| `has_more` | `boolean` | yes |

```json
{
  "$defs": {
    "JsonValue": {},
    "RuntimeEventRecord": {
      "additionalProperties": false,
      "properties": {
        "thread_id": {
          "minLength": 1,
          "title": "Thread Id",
          "type": "string"
        },
        "turn_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Turn Id"
        },
        "seq": {
          "minimum": 1,
          "title": "Seq",
          "type": "integer"
        },
        "type": {
          "minLength": 1,
          "title": "Type",
          "type": "string"
        },
        "payload": {
          "additionalProperties": {
            "$ref": "#/$defs/JsonValue"
          },
          "title": "Payload",
          "type": "object"
        },
        "ts": {
          "format": "date-time",
          "title": "Ts",
          "type": "string"
        },
        "schema_version": {
          "const": 1,
          "default": 1,
          "title": "Schema Version",
          "type": "integer"
        }
      },
      "required": [
        "thread_id",
        "seq",
        "type",
        "ts"
      ],
      "title": "RuntimeEventRecord",
      "type": "object"
    }
  },
  "properties": {
    "events": {
      "items": {
        "$ref": "#/$defs/RuntimeEventRecord"
      },
      "title": "Events",
      "type": "array"
    },
    "latest_seq": {
      "title": "Latest Seq",
      "type": "integer"
    },
    "has_more": {
      "title": "Has More",
      "type": "boolean"
    }
  },
  "required": [
    "events",
    "latest_seq",
    "has_more"
  ],
  "title": "EventReplayResult",
  "type": "object"
}
```

### ThreadCreateCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `title` | `string` | no |
| `mode` | `string` | no |
| `preset_id` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "thread.create",
      "default": "thread.create",
      "title": "Type",
      "type": "string"
    },
    "title": {
      "default": "",
      "maxLength": 200,
      "title": "Title",
      "type": "string"
    },
    "mode": {
      "default": "chat",
      "enum": [
        "one_shot",
        "chat"
      ],
      "title": "Mode",
      "type": "string"
    },
    "preset_id": {
      "default": "standard",
      "pattern": "^[a-z][a-z0-9-]{0,63}$",
      "title": "Preset Id",
      "type": "string"
    }
  },
  "title": "ThreadCreateCommand",
  "type": "object"
}
```

### ThreadCreateResult

| Field | Type | Required |
|---|---|---|
| `thread` | `object` | yes |

```json
{
  "$defs": {
    "ThreadRecord": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "minLength": 1,
          "title": "Id",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "workspace": {
          "minLength": 1,
          "title": "Workspace",
          "type": "string"
        },
        "status": {
          "$ref": "#/$defs/ThreadStatus",
          "default": "idle"
        },
        "default_route_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Default Route Id"
        },
        "turn_count": {
          "default": 0,
          "minimum": 0,
          "title": "Turn Count",
          "type": "integer"
        },
        "created_at": {
          "format": "date-time",
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "format": "date-time",
          "title": "Updated At",
          "type": "string"
        },
        "schema_version": {
          "const": 1,
          "default": 1,
          "title": "Schema Version",
          "type": "integer"
        }
      },
      "required": [
        "id",
        "title",
        "workspace",
        "created_at",
        "updated_at"
      ],
      "title": "ThreadRecord",
      "type": "object"
    },
    "ThreadStatus": {
      "enum": [
        "idle",
        "running",
        "interrupted",
        "failed",
        "archived"
      ],
      "title": "ThreadStatus",
      "type": "string"
    }
  },
  "properties": {
    "thread": {
      "$ref": "#/$defs/ThreadRecord"
    }
  },
  "required": [
    "thread"
  ],
  "title": "ThreadCreateResult",
  "type": "object"
}
```

### ThreadListCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `include_archived` | `boolean` | no |
| `limit` | `integer` | no |

```json
{
  "properties": {
    "type": {
      "const": "thread.list",
      "default": "thread.list",
      "title": "Type",
      "type": "string"
    },
    "include_archived": {
      "default": false,
      "title": "Include Archived",
      "type": "boolean"
    },
    "limit": {
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "ThreadListCommand",
  "type": "object"
}
```

### ThreadListResult

| Field | Type | Required |
|---|---|---|
| `threads` | `array` | yes |

```json
{
  "$defs": {
    "ThreadRecord": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "minLength": 1,
          "title": "Id",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "workspace": {
          "minLength": 1,
          "title": "Workspace",
          "type": "string"
        },
        "status": {
          "$ref": "#/$defs/ThreadStatus",
          "default": "idle"
        },
        "default_route_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Default Route Id"
        },
        "turn_count": {
          "default": 0,
          "minimum": 0,
          "title": "Turn Count",
          "type": "integer"
        },
        "created_at": {
          "format": "date-time",
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "format": "date-time",
          "title": "Updated At",
          "type": "string"
        },
        "schema_version": {
          "const": 1,
          "default": 1,
          "title": "Schema Version",
          "type": "integer"
        }
      },
      "required": [
        "id",
        "title",
        "workspace",
        "created_at",
        "updated_at"
      ],
      "title": "ThreadRecord",
      "type": "object"
    },
    "ThreadStatus": {
      "enum": [
        "idle",
        "running",
        "interrupted",
        "failed",
        "archived"
      ],
      "title": "ThreadStatus",
      "type": "string"
    }
  },
  "properties": {
    "threads": {
      "items": {
        "$ref": "#/$defs/ThreadRecord"
      },
      "title": "Threads",
      "type": "array"
    }
  },
  "required": [
    "threads"
  ],
  "title": "ThreadListResult",
  "type": "object"
}
```

### ThreadGetCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `thread_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "thread.get",
      "default": "thread.get",
      "title": "Type",
      "type": "string"
    },
    "thread_id": {
      "minLength": 1,
      "title": "Thread Id",
      "type": "string"
    }
  },
  "required": [
    "thread_id"
  ],
  "title": "ThreadGetCommand",
  "type": "object"
}
```

### ThreadGetResult

| Field | Type | Required |
|---|---|---|
| `thread` | `object` | yes |

```json
{
  "$defs": {
    "ThreadRecord": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "minLength": 1,
          "title": "Id",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "workspace": {
          "minLength": 1,
          "title": "Workspace",
          "type": "string"
        },
        "status": {
          "$ref": "#/$defs/ThreadStatus",
          "default": "idle"
        },
        "default_route_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Default Route Id"
        },
        "turn_count": {
          "default": 0,
          "minimum": 0,
          "title": "Turn Count",
          "type": "integer"
        },
        "created_at": {
          "format": "date-time",
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "format": "date-time",
          "title": "Updated At",
          "type": "string"
        },
        "schema_version": {
          "const": 1,
          "default": 1,
          "title": "Schema Version",
          "type": "integer"
        }
      },
      "required": [
        "id",
        "title",
        "workspace",
        "created_at",
        "updated_at"
      ],
      "title": "ThreadRecord",
      "type": "object"
    },
    "ThreadStatus": {
      "enum": [
        "idle",
        "running",
        "interrupted",
        "failed",
        "archived"
      ],
      "title": "ThreadStatus",
      "type": "string"
    }
  },
  "properties": {
    "thread": {
      "$ref": "#/$defs/ThreadRecord"
    }
  },
  "required": [
    "thread"
  ],
  "title": "ThreadGetResult",
  "type": "object"
}
```

### ThreadUpdateCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `thread_id` | `string` | yes |
| `title` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "thread.update",
      "default": "thread.update",
      "title": "Type",
      "type": "string"
    },
    "thread_id": {
      "minLength": 1,
      "title": "Thread Id",
      "type": "string"
    },
    "title": {
      "maxLength": 200,
      "minLength": 1,
      "title": "Title",
      "type": "string"
    }
  },
  "required": [
    "thread_id",
    "title"
  ],
  "title": "ThreadUpdateCommand",
  "type": "object"
}
```

### ThreadUpdateResult

| Field | Type | Required |
|---|---|---|
| `thread` | `object` | yes |

```json
{
  "$defs": {
    "ThreadRecord": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "minLength": 1,
          "title": "Id",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "workspace": {
          "minLength": 1,
          "title": "Workspace",
          "type": "string"
        },
        "status": {
          "$ref": "#/$defs/ThreadStatus",
          "default": "idle"
        },
        "default_route_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Default Route Id"
        },
        "turn_count": {
          "default": 0,
          "minimum": 0,
          "title": "Turn Count",
          "type": "integer"
        },
        "created_at": {
          "format": "date-time",
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "format": "date-time",
          "title": "Updated At",
          "type": "string"
        },
        "schema_version": {
          "const": 1,
          "default": 1,
          "title": "Schema Version",
          "type": "integer"
        }
      },
      "required": [
        "id",
        "title",
        "workspace",
        "created_at",
        "updated_at"
      ],
      "title": "ThreadRecord",
      "type": "object"
    },
    "ThreadStatus": {
      "enum": [
        "idle",
        "running",
        "interrupted",
        "failed",
        "archived"
      ],
      "title": "ThreadStatus",
      "type": "string"
    }
  },
  "properties": {
    "thread": {
      "$ref": "#/$defs/ThreadRecord"
    }
  },
  "required": [
    "thread"
  ],
  "title": "ThreadUpdateResult",
  "type": "object"
}
```

### ThreadArchiveCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `thread_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "thread.archive",
      "default": "thread.archive",
      "title": "Type",
      "type": "string"
    },
    "thread_id": {
      "minLength": 1,
      "title": "Thread Id",
      "type": "string"
    }
  },
  "required": [
    "thread_id"
  ],
  "title": "ThreadArchiveCommand",
  "type": "object"
}
```

### ThreadArchiveResult

| Field | Type | Required |
|---|---|---|
| `thread` | `object` | yes |

```json
{
  "$defs": {
    "ThreadRecord": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "minLength": 1,
          "title": "Id",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "workspace": {
          "minLength": 1,
          "title": "Workspace",
          "type": "string"
        },
        "status": {
          "$ref": "#/$defs/ThreadStatus",
          "default": "idle"
        },
        "default_route_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Default Route Id"
        },
        "turn_count": {
          "default": 0,
          "minimum": 0,
          "title": "Turn Count",
          "type": "integer"
        },
        "created_at": {
          "format": "date-time",
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "format": "date-time",
          "title": "Updated At",
          "type": "string"
        },
        "schema_version": {
          "const": 1,
          "default": 1,
          "title": "Schema Version",
          "type": "integer"
        }
      },
      "required": [
        "id",
        "title",
        "workspace",
        "created_at",
        "updated_at"
      ],
      "title": "ThreadRecord",
      "type": "object"
    },
    "ThreadStatus": {
      "enum": [
        "idle",
        "running",
        "interrupted",
        "failed",
        "archived"
      ],
      "title": "ThreadStatus",
      "type": "string"
    }
  },
  "properties": {
    "thread": {
      "$ref": "#/$defs/ThreadRecord"
    }
  },
  "required": [
    "thread"
  ],
  "title": "ThreadArchiveResult",
  "type": "object"
}
```

### TurnStartCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `thread_id` | `string` | yes |
| `content` | `string` | yes |
| `runtime_mode` | `object` | no |

```json
{
  "$defs": {
    "RuntimeMode": {
      "enum": [
        "plan",
        "act",
        "operate",
        "review"
      ],
      "title": "RuntimeMode",
      "type": "string"
    }
  },
  "properties": {
    "type": {
      "const": "turn.start",
      "default": "turn.start",
      "title": "Type",
      "type": "string"
    },
    "thread_id": {
      "minLength": 1,
      "title": "Thread Id",
      "type": "string"
    },
    "content": {
      "maxLength": 100000,
      "minLength": 1,
      "title": "Content",
      "type": "string"
    },
    "runtime_mode": {
      "$ref": "#/$defs/RuntimeMode",
      "default": "act"
    }
  },
  "required": [
    "thread_id",
    "content"
  ],
  "title": "TurnStartCommand",
  "type": "object"
}
```

### TurnStartResult

| Field | Type | Required |
|---|---|---|
| `turn_id` | `string` | yes |
| `handled` | `boolean` | no |

```json
{
  "properties": {
    "turn_id": {
      "title": "Turn Id",
      "type": "string"
    },
    "handled": {
      "default": false,
      "title": "Handled",
      "type": "boolean"
    }
  },
  "required": [
    "turn_id"
  ],
  "title": "TurnStartResult",
  "type": "object"
}
```

### TurnGetCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `turn_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "turn.get",
      "default": "turn.get",
      "title": "Type",
      "type": "string"
    },
    "turn_id": {
      "minLength": 1,
      "title": "Turn Id",
      "type": "string"
    }
  },
  "required": [
    "turn_id"
  ],
  "title": "TurnGetCommand",
  "type": "object"
}
```

### TurnGetResult

| Field | Type | Required |
|---|---|---|
| `turn` | `object` | yes |

```json
{
  "$defs": {
    "AuthorityProfile": {
      "enum": [
        "ask",
        "auto_review",
        "full_access"
      ],
      "title": "AuthorityProfile",
      "type": "string"
    },
    "JsonValue": {},
    "RouteReceipt": {
      "additionalProperties": false,
      "properties": {
        "route_id": {
          "title": "Route Id",
          "type": "string"
        },
        "wire_format": {
          "enum": [
            "openai_chat",
            "openai_responses",
            "anthropic_messages"
          ],
          "title": "Wire Format",
          "type": "string"
        },
        "base_url_origin": {
          "title": "Base Url Origin",
          "type": "string"
        },
        "model": {
          "title": "Model",
          "type": "string"
        },
        "credential_source": {
          "enum": [
            "keyring",
            "file",
            "env",
            "extension",
            "missing"
          ],
          "title": "Credential Source",
          "type": "string"
        },
        "supports_images": {
          "default": false,
          "title": "Supports Images",
          "type": "boolean"
        },
        "temperature": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Temperature"
        }
      },
      "required": [
        "route_id",
        "wire_format",
        "base_url_origin",
        "model",
        "credential_source"
      ],
      "title": "RouteReceipt",
      "type": "object"
    },
    "RuntimeMode": {
      "enum": [
        "plan",
        "act",
        "operate",
        "review"
      ],
      "title": "RuntimeMode",
      "type": "string"
    },
    "SandboxCapability": {
      "additionalProperties": false,
      "properties": {
        "available": {
          "title": "Available",
          "type": "boolean"
        },
        "kind": {
          "enum": [
            "none",
            "windows_none",
            "windows_acl",
            "linux_bwrap",
            "macos_seatbelt"
          ],
          "title": "Kind",
          "type": "string"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        }
      },
      "required": [
        "available",
        "kind",
        "reason"
      ],
      "title": "SandboxCapability",
      "type": "object"
    },
    "ToolAction": {
      "enum": [
        "read",
        "mutate",
        "shell",
        "external"
      ],
      "title": "ToolAction",
      "type": "string"
    },
    "TurnRecord": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "minLength": 1,
          "title": "Id",
          "type": "string"
        },
        "thread_id": {
          "minLength": 1,
          "title": "Thread Id",
          "type": "string"
        },
        "status": {
          "$ref": "#/$defs/TurnStatus",
          "default": "queued"
        },
        "mode": {
          "$ref": "#/$defs/RuntimeMode",
          "default": "act"
        },
        "authority_profile": {
          "$ref": "#/$defs/AuthorityProfile",
          "default": "ask"
        },
        "workspace_trust": {
          "$ref": "#/$defs/WorkspaceTrust",
          "default": "untrusted"
        },
        "sandbox": {
          "$ref": "#/$defs/SandboxCapability",
          "default": {
            "available": false,
            "kind": "none",
            "reason": "sandbox capability has not been detected"
          }
        },
        "allowed_actions": {
          "items": {
            "$ref": "#/$defs/ToolAction"
          },
          "title": "Allowed Actions",
          "type": "array",
          "uniqueItems": true
        },
        "route": {
          "anyOf": [
            {
              "$ref": "#/$defs/RouteReceipt"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "usage": {
          "additionalProperties": {
            "$ref": "#/$defs/JsonValue"
          },
          "title": "Usage",
          "type": "object"
        },
        "error": {
          "anyOf": [
            {
              "additionalProperties": {
                "$ref": "#/$defs/JsonValue"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "boot_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Boot Id"
        },
        "created_at": {
          "format": "date-time",
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "format": "date-time",
          "title": "Updated At",
          "type": "string"
        },
        "schema_version": {
          "const": 1,
          "default": 1,
          "title": "Schema Version",
          "type": "integer"
        }
      },
      "required": [
        "id",
        "thread_id",
        "created_at",
        "updated_at"
      ],
      "title": "TurnRecord",
      "type": "object"
    },
    "TurnStatus": {
      "enum": [
        "queued",
        "running",
        "waiting",
        "completed",
        "failed",
        "interrupted"
      ],
      "title": "TurnStatus",
      "type": "string"
    },
    "WorkspaceTrust": {
      "enum": [
        "untrusted",
        "trusted"
      ],
      "title": "WorkspaceTrust",
      "type": "string"
    }
  },
  "properties": {
    "turn": {
      "$ref": "#/$defs/TurnRecord"
    }
  },
  "required": [
    "turn"
  ],
  "title": "TurnGetResult",
  "type": "object"
}
```

### TurnListCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `thread_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "turn.list",
      "default": "turn.list",
      "title": "Type",
      "type": "string"
    },
    "thread_id": {
      "minLength": 1,
      "title": "Thread Id",
      "type": "string"
    }
  },
  "required": [
    "thread_id"
  ],
  "title": "TurnListCommand",
  "type": "object"
}
```

### TurnListResult

| Field | Type | Required |
|---|---|---|
| `turns` | `array` | yes |

```json
{
  "$defs": {
    "AuthorityProfile": {
      "enum": [
        "ask",
        "auto_review",
        "full_access"
      ],
      "title": "AuthorityProfile",
      "type": "string"
    },
    "JsonValue": {},
    "RouteReceipt": {
      "additionalProperties": false,
      "properties": {
        "route_id": {
          "title": "Route Id",
          "type": "string"
        },
        "wire_format": {
          "enum": [
            "openai_chat",
            "openai_responses",
            "anthropic_messages"
          ],
          "title": "Wire Format",
          "type": "string"
        },
        "base_url_origin": {
          "title": "Base Url Origin",
          "type": "string"
        },
        "model": {
          "title": "Model",
          "type": "string"
        },
        "credential_source": {
          "enum": [
            "keyring",
            "file",
            "env",
            "extension",
            "missing"
          ],
          "title": "Credential Source",
          "type": "string"
        },
        "supports_images": {
          "default": false,
          "title": "Supports Images",
          "type": "boolean"
        },
        "temperature": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Temperature"
        }
      },
      "required": [
        "route_id",
        "wire_format",
        "base_url_origin",
        "model",
        "credential_source"
      ],
      "title": "RouteReceipt",
      "type": "object"
    },
    "RuntimeMode": {
      "enum": [
        "plan",
        "act",
        "operate",
        "review"
      ],
      "title": "RuntimeMode",
      "type": "string"
    },
    "SandboxCapability": {
      "additionalProperties": false,
      "properties": {
        "available": {
          "title": "Available",
          "type": "boolean"
        },
        "kind": {
          "enum": [
            "none",
            "windows_none",
            "windows_acl",
            "linux_bwrap",
            "macos_seatbelt"
          ],
          "title": "Kind",
          "type": "string"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        }
      },
      "required": [
        "available",
        "kind",
        "reason"
      ],
      "title": "SandboxCapability",
      "type": "object"
    },
    "ToolAction": {
      "enum": [
        "read",
        "mutate",
        "shell",
        "external"
      ],
      "title": "ToolAction",
      "type": "string"
    },
    "TurnRecord": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "minLength": 1,
          "title": "Id",
          "type": "string"
        },
        "thread_id": {
          "minLength": 1,
          "title": "Thread Id",
          "type": "string"
        },
        "status": {
          "$ref": "#/$defs/TurnStatus",
          "default": "queued"
        },
        "mode": {
          "$ref": "#/$defs/RuntimeMode",
          "default": "act"
        },
        "authority_profile": {
          "$ref": "#/$defs/AuthorityProfile",
          "default": "ask"
        },
        "workspace_trust": {
          "$ref": "#/$defs/WorkspaceTrust",
          "default": "untrusted"
        },
        "sandbox": {
          "$ref": "#/$defs/SandboxCapability",
          "default": {
            "available": false,
            "kind": "none",
            "reason": "sandbox capability has not been detected"
          }
        },
        "allowed_actions": {
          "items": {
            "$ref": "#/$defs/ToolAction"
          },
          "title": "Allowed Actions",
          "type": "array",
          "uniqueItems": true
        },
        "route": {
          "anyOf": [
            {
              "$ref": "#/$defs/RouteReceipt"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "usage": {
          "additionalProperties": {
            "$ref": "#/$defs/JsonValue"
          },
          "title": "Usage",
          "type": "object"
        },
        "error": {
          "anyOf": [
            {
              "additionalProperties": {
                "$ref": "#/$defs/JsonValue"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "boot_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Boot Id"
        },
        "created_at": {
          "format": "date-time",
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "format": "date-time",
          "title": "Updated At",
          "type": "string"
        },
        "schema_version": {
          "const": 1,
          "default": 1,
          "title": "Schema Version",
          "type": "integer"
        }
      },
      "required": [
        "id",
        "thread_id",
        "created_at",
        "updated_at"
      ],
      "title": "TurnRecord",
      "type": "object"
    },
    "TurnStatus": {
      "enum": [
        "queued",
        "running",
        "waiting",
        "completed",
        "failed",
        "interrupted"
      ],
      "title": "TurnStatus",
      "type": "string"
    },
    "WorkspaceTrust": {
      "enum": [
        "untrusted",
        "trusted"
      ],
      "title": "WorkspaceTrust",
      "type": "string"
    }
  },
  "properties": {
    "turns": {
      "items": {
        "$ref": "#/$defs/TurnRecord"
      },
      "title": "Turns",
      "type": "array"
    }
  },
  "required": [
    "turns"
  ],
  "title": "TurnListResult",
  "type": "object"
}
```

### TurnInterruptCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `turn_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "turn.interrupt",
      "default": "turn.interrupt",
      "title": "Type",
      "type": "string"
    },
    "turn_id": {
      "minLength": 1,
      "title": "Turn Id",
      "type": "string"
    }
  },
  "required": [
    "turn_id"
  ],
  "title": "TurnInterruptCommand",
  "type": "object"
}
```

### TurnInterruptResult

| Field | Type | Required |
|---|---|---|
| `turn` | `object` | yes |

```json
{
  "$defs": {
    "AuthorityProfile": {
      "enum": [
        "ask",
        "auto_review",
        "full_access"
      ],
      "title": "AuthorityProfile",
      "type": "string"
    },
    "JsonValue": {},
    "RouteReceipt": {
      "additionalProperties": false,
      "properties": {
        "route_id": {
          "title": "Route Id",
          "type": "string"
        },
        "wire_format": {
          "enum": [
            "openai_chat",
            "openai_responses",
            "anthropic_messages"
          ],
          "title": "Wire Format",
          "type": "string"
        },
        "base_url_origin": {
          "title": "Base Url Origin",
          "type": "string"
        },
        "model": {
          "title": "Model",
          "type": "string"
        },
        "credential_source": {
          "enum": [
            "keyring",
            "file",
            "env",
            "extension",
            "missing"
          ],
          "title": "Credential Source",
          "type": "string"
        },
        "supports_images": {
          "default": false,
          "title": "Supports Images",
          "type": "boolean"
        },
        "temperature": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Temperature"
        }
      },
      "required": [
        "route_id",
        "wire_format",
        "base_url_origin",
        "model",
        "credential_source"
      ],
      "title": "RouteReceipt",
      "type": "object"
    },
    "RuntimeMode": {
      "enum": [
        "plan",
        "act",
        "operate",
        "review"
      ],
      "title": "RuntimeMode",
      "type": "string"
    },
    "SandboxCapability": {
      "additionalProperties": false,
      "properties": {
        "available": {
          "title": "Available",
          "type": "boolean"
        },
        "kind": {
          "enum": [
            "none",
            "windows_none",
            "windows_acl",
            "linux_bwrap",
            "macos_seatbelt"
          ],
          "title": "Kind",
          "type": "string"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        }
      },
      "required": [
        "available",
        "kind",
        "reason"
      ],
      "title": "SandboxCapability",
      "type": "object"
    },
    "ToolAction": {
      "enum": [
        "read",
        "mutate",
        "shell",
        "external"
      ],
      "title": "ToolAction",
      "type": "string"
    },
    "TurnRecord": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "minLength": 1,
          "title": "Id",
          "type": "string"
        },
        "thread_id": {
          "minLength": 1,
          "title": "Thread Id",
          "type": "string"
        },
        "status": {
          "$ref": "#/$defs/TurnStatus",
          "default": "queued"
        },
        "mode": {
          "$ref": "#/$defs/RuntimeMode",
          "default": "act"
        },
        "authority_profile": {
          "$ref": "#/$defs/AuthorityProfile",
          "default": "ask"
        },
        "workspace_trust": {
          "$ref": "#/$defs/WorkspaceTrust",
          "default": "untrusted"
        },
        "sandbox": {
          "$ref": "#/$defs/SandboxCapability",
          "default": {
            "available": false,
            "kind": "none",
            "reason": "sandbox capability has not been detected"
          }
        },
        "allowed_actions": {
          "items": {
            "$ref": "#/$defs/ToolAction"
          },
          "title": "Allowed Actions",
          "type": "array",
          "uniqueItems": true
        },
        "route": {
          "anyOf": [
            {
              "$ref": "#/$defs/RouteReceipt"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "usage": {
          "additionalProperties": {
            "$ref": "#/$defs/JsonValue"
          },
          "title": "Usage",
          "type": "object"
        },
        "error": {
          "anyOf": [
            {
              "additionalProperties": {
                "$ref": "#/$defs/JsonValue"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "boot_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Boot Id"
        },
        "created_at": {
          "format": "date-time",
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "format": "date-time",
          "title": "Updated At",
          "type": "string"
        },
        "schema_version": {
          "const": 1,
          "default": 1,
          "title": "Schema Version",
          "type": "integer"
        }
      },
      "required": [
        "id",
        "thread_id",
        "created_at",
        "updated_at"
      ],
      "title": "TurnRecord",
      "type": "object"
    },
    "TurnStatus": {
      "enum": [
        "queued",
        "running",
        "waiting",
        "completed",
        "failed",
        "interrupted"
      ],
      "title": "TurnStatus",
      "type": "string"
    },
    "WorkspaceTrust": {
      "enum": [
        "untrusted",
        "trusted"
      ],
      "title": "WorkspaceTrust",
      "type": "string"
    }
  },
  "properties": {
    "turn": {
      "$ref": "#/$defs/TurnRecord"
    }
  },
  "required": [
    "turn"
  ],
  "title": "TurnInterruptResult",
  "type": "object"
}
```

### TurnSteerCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `turn_id` | `string` | yes |
| `content` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "turn.steer",
      "default": "turn.steer",
      "title": "Type",
      "type": "string"
    },
    "turn_id": {
      "minLength": 1,
      "title": "Turn Id",
      "type": "string"
    },
    "content": {
      "maxLength": 10000,
      "minLength": 1,
      "title": "Content",
      "type": "string"
    }
  },
  "required": [
    "turn_id",
    "content"
  ],
  "title": "TurnSteerCommand",
  "type": "object"
}
```

### TurnSteerResult

| Field | Type | Required |
|---|---|---|
| `turn` | `object` | yes |

```json
{
  "$defs": {
    "AuthorityProfile": {
      "enum": [
        "ask",
        "auto_review",
        "full_access"
      ],
      "title": "AuthorityProfile",
      "type": "string"
    },
    "JsonValue": {},
    "RouteReceipt": {
      "additionalProperties": false,
      "properties": {
        "route_id": {
          "title": "Route Id",
          "type": "string"
        },
        "wire_format": {
          "enum": [
            "openai_chat",
            "openai_responses",
            "anthropic_messages"
          ],
          "title": "Wire Format",
          "type": "string"
        },
        "base_url_origin": {
          "title": "Base Url Origin",
          "type": "string"
        },
        "model": {
          "title": "Model",
          "type": "string"
        },
        "credential_source": {
          "enum": [
            "keyring",
            "file",
            "env",
            "extension",
            "missing"
          ],
          "title": "Credential Source",
          "type": "string"
        },
        "supports_images": {
          "default": false,
          "title": "Supports Images",
          "type": "boolean"
        },
        "temperature": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Temperature"
        }
      },
      "required": [
        "route_id",
        "wire_format",
        "base_url_origin",
        "model",
        "credential_source"
      ],
      "title": "RouteReceipt",
      "type": "object"
    },
    "RuntimeMode": {
      "enum": [
        "plan",
        "act",
        "operate",
        "review"
      ],
      "title": "RuntimeMode",
      "type": "string"
    },
    "SandboxCapability": {
      "additionalProperties": false,
      "properties": {
        "available": {
          "title": "Available",
          "type": "boolean"
        },
        "kind": {
          "enum": [
            "none",
            "windows_none",
            "windows_acl",
            "linux_bwrap",
            "macos_seatbelt"
          ],
          "title": "Kind",
          "type": "string"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        }
      },
      "required": [
        "available",
        "kind",
        "reason"
      ],
      "title": "SandboxCapability",
      "type": "object"
    },
    "ToolAction": {
      "enum": [
        "read",
        "mutate",
        "shell",
        "external"
      ],
      "title": "ToolAction",
      "type": "string"
    },
    "TurnRecord": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "minLength": 1,
          "title": "Id",
          "type": "string"
        },
        "thread_id": {
          "minLength": 1,
          "title": "Thread Id",
          "type": "string"
        },
        "status": {
          "$ref": "#/$defs/TurnStatus",
          "default": "queued"
        },
        "mode": {
          "$ref": "#/$defs/RuntimeMode",
          "default": "act"
        },
        "authority_profile": {
          "$ref": "#/$defs/AuthorityProfile",
          "default": "ask"
        },
        "workspace_trust": {
          "$ref": "#/$defs/WorkspaceTrust",
          "default": "untrusted"
        },
        "sandbox": {
          "$ref": "#/$defs/SandboxCapability",
          "default": {
            "available": false,
            "kind": "none",
            "reason": "sandbox capability has not been detected"
          }
        },
        "allowed_actions": {
          "items": {
            "$ref": "#/$defs/ToolAction"
          },
          "title": "Allowed Actions",
          "type": "array",
          "uniqueItems": true
        },
        "route": {
          "anyOf": [
            {
              "$ref": "#/$defs/RouteReceipt"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "usage": {
          "additionalProperties": {
            "$ref": "#/$defs/JsonValue"
          },
          "title": "Usage",
          "type": "object"
        },
        "error": {
          "anyOf": [
            {
              "additionalProperties": {
                "$ref": "#/$defs/JsonValue"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "boot_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Boot Id"
        },
        "created_at": {
          "format": "date-time",
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "format": "date-time",
          "title": "Updated At",
          "type": "string"
        },
        "schema_version": {
          "const": 1,
          "default": 1,
          "title": "Schema Version",
          "type": "integer"
        }
      },
      "required": [
        "id",
        "thread_id",
        "created_at",
        "updated_at"
      ],
      "title": "TurnRecord",
      "type": "object"
    },
    "TurnStatus": {
      "enum": [
        "queued",
        "running",
        "waiting",
        "completed",
        "failed",
        "interrupted"
      ],
      "title": "TurnStatus",
      "type": "string"
    },
    "WorkspaceTrust": {
      "enum": [
        "untrusted",
        "trusted"
      ],
      "title": "WorkspaceTrust",
      "type": "string"
    }
  },
  "properties": {
    "turn": {
      "$ref": "#/$defs/TurnRecord"
    }
  },
  "required": [
    "turn"
  ],
  "title": "TurnSteerResult",
  "type": "object"
}
```

### TurnItemsCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `turn_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "turn.items",
      "default": "turn.items",
      "title": "Type",
      "type": "string"
    },
    "turn_id": {
      "minLength": 1,
      "title": "Turn Id",
      "type": "string"
    }
  },
  "required": [
    "turn_id"
  ],
  "title": "TurnItemsCommand",
  "type": "object"
}
```

### TurnItemsResult

| Field | Type | Required |
|---|---|---|
| `items` | `array` | yes |

```json
{
  "$defs": {
    "JsonValue": {},
    "TurnItemKind": {
      "enum": [
        "message",
        "tool_call",
        "tool_result",
        "artifact",
        "checkpoint"
      ],
      "title": "TurnItemKind",
      "type": "string"
    },
    "TurnItemRecord": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "minLength": 1,
          "title": "Id",
          "type": "string"
        },
        "turn_id": {
          "minLength": 1,
          "title": "Turn Id",
          "type": "string"
        },
        "kind": {
          "$ref": "#/$defs/TurnItemKind"
        },
        "payload": {
          "additionalProperties": {
            "$ref": "#/$defs/JsonValue"
          },
          "title": "Payload",
          "type": "object"
        },
        "tool_call_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Tool Call Id"
        },
        "created_at": {
          "format": "date-time",
          "title": "Created At",
          "type": "string"
        },
        "schema_version": {
          "const": 1,
          "default": 1,
          "title": "Schema Version",
          "type": "integer"
        }
      },
      "required": [
        "id",
        "turn_id",
        "kind",
        "created_at"
      ],
      "title": "TurnItemRecord",
      "type": "object"
    }
  },
  "properties": {
    "items": {
      "items": {
        "$ref": "#/$defs/TurnItemRecord"
      },
      "title": "Items",
      "type": "array"
    }
  },
  "required": [
    "items"
  ],
  "title": "TurnItemsResult",
  "type": "object"
}
```

### RuntimeCapabilitiesCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "runtime.capabilities",
      "default": "runtime.capabilities",
      "title": "Type",
      "type": "string"
    }
  },
  "title": "RuntimeCapabilitiesCommand",
  "type": "object"
}
```

### RuntimeCapabilitiesResult

| Field | Type | Required |
|---|---|---|
| `version` | `string` | yes |
| `api_version` | `string` | no |
| `runtime_modes` | `array` | yes |
| `features` | `array` | yes |
| `feature_flags` | `object` | no |
| `labs_enabled` | `boolean` | no |
| `sandbox` | `object` | no |
| `runtime_event_schema_version` | `integer` | no |
| `stream_json_schema_versions` | `array` | no |

```json
{
  "$defs": {
    "RuntimeFeatureFlags": {
      "additionalProperties": false,
      "properties": {
        "stable": {
          "additionalProperties": {
            "type": "boolean"
          },
          "title": "Stable",
          "type": "object"
        },
        "labs": {
          "additionalProperties": {
            "type": "boolean"
          },
          "title": "Labs",
          "type": "object"
        },
        "internal": {
          "additionalProperties": {
            "type": "boolean"
          },
          "title": "Internal",
          "type": "object"
        }
      },
      "title": "RuntimeFeatureFlags",
      "type": "object"
    },
    "RuntimeMode": {
      "enum": [
        "plan",
        "act",
        "operate",
        "review"
      ],
      "title": "RuntimeMode",
      "type": "string"
    },
    "RuntimeSandboxStatus": {
      "additionalProperties": false,
      "properties": {
        "platform": {
          "title": "Platform",
          "type": "string"
        },
        "capability": {
          "$ref": "#/$defs/SandboxCapability"
        },
        "state": {
          "enum": [
            "enforcement_available",
            "partial_enforcement",
            "degraded"
          ],
          "title": "State",
          "type": "string"
        },
        "windows_forced_sandbox": {
          "enum": [
            "available",
            "partial",
            "unavailable",
            "not_applicable"
          ],
          "title": "Windows Forced Sandbox",
          "type": "string"
        }
      },
      "required": [
        "platform",
        "capability",
        "state",
        "windows_forced_sandbox"
      ],
      "title": "RuntimeSandboxStatus",
      "type": "object"
    },
    "SandboxCapability": {
      "additionalProperties": false,
      "properties": {
        "available": {
          "title": "Available",
          "type": "boolean"
        },
        "kind": {
          "enum": [
            "none",
            "windows_none",
            "windows_acl",
            "linux_bwrap",
            "macos_seatbelt"
          ],
          "title": "Kind",
          "type": "string"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        }
      },
      "required": [
        "available",
        "kind",
        "reason"
      ],
      "title": "SandboxCapability",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "version": {
      "title": "Version",
      "type": "string"
    },
    "api_version": {
      "default": "v1",
      "title": "Api Version",
      "type": "string"
    },
    "runtime_modes": {
      "items": {
        "$ref": "#/$defs/RuntimeMode"
      },
      "title": "Runtime Modes",
      "type": "array"
    },
    "features": {
      "items": {
        "type": "string"
      },
      "title": "Features",
      "type": "array"
    },
    "feature_flags": {
      "$ref": "#/$defs/RuntimeFeatureFlags"
    },
    "labs_enabled": {
      "default": false,
      "title": "Labs Enabled",
      "type": "boolean"
    },
    "sandbox": {
      "$ref": "#/$defs/RuntimeSandboxStatus"
    },
    "runtime_event_schema_version": {
      "default": 1,
      "title": "Runtime Event Schema Version",
      "type": "integer"
    },
    "stream_json_schema_versions": {
      "items": {
        "type": "integer"
      },
      "title": "Stream Json Schema Versions",
      "type": "array"
    }
  },
  "required": [
    "version",
    "runtime_modes",
    "features"
  ],
  "title": "RuntimeCapabilitiesResult",
  "type": "object"
}
```

### SessionCreateCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `mode` | `string` | no |
| `title` | `string` | no |
| `preset_id` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "session.create",
      "default": "session.create",
      "title": "Type",
      "type": "string"
    },
    "mode": {
      "default": "chat",
      "enum": [
        "one_shot",
        "chat"
      ],
      "title": "Mode",
      "type": "string"
    },
    "title": {
      "default": "",
      "title": "Title",
      "type": "string"
    },
    "preset_id": {
      "default": "standard",
      "pattern": "^[a-z][a-z0-9-]{0,63}$",
      "title": "Preset Id",
      "type": "string"
    }
  },
  "title": "SessionCreateCommand",
  "type": "object"
}
```

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": "u-4",
  "method": "session.create",
  "params": {
    "mode": "chat",
    "title": ""
  }
}
```

### SessionCreateResult

| Field | Type | Required |
|---|---|---|
| `session_id` | `string` | yes |
| `status` | `string` | yes |
| `route_id` | `string` | no |
| `model` | `string` | no |
| `thinking_level` | `string | null` | no |

```json
{
  "properties": {
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "status": {
      "enum": [
        "active",
        "waiting_for_input",
        "interrupted",
        "closed"
      ],
      "title": "Status",
      "type": "string"
    },
    "route_id": {
      "default": "",
      "title": "Route Id",
      "type": "string"
    },
    "model": {
      "default": "",
      "title": "Model",
      "type": "string"
    },
    "thinking_level": {
      "anyOf": [
        {
          "enum": [
            "off",
            "low",
            "medium",
            "high"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Thinking Level"
    }
  },
  "required": [
    "session_id",
    "status"
  ],
  "title": "SessionCreateResult",
  "type": "object"
}
```

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": "u-4",
  "result": {
    "session_id": "sess-abc123def456",
    "status": "active"
  }
}
```

### SessionSendMessageCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `content` | `string` | yes |
| `display_content` | `string | null` | no |
| `runtime_mode` | `object` | no |
| `attachments` | `array` | no |
| `tools` | `array | null` | no |

```json
{
  "$defs": {
    "ImageArtifactInput": {
      "additionalProperties": false,
      "properties": {
        "sha256": {
          "pattern": "^[0-9a-f]{64}$",
          "title": "Sha256",
          "type": "string"
        },
        "media_type": {
          "pattern": "^image/(png|jpeg|webp|gif)$",
          "title": "Media Type",
          "type": "string"
        },
        "size": {
          "exclusiveMinimum": 0,
          "maximum": 2097152,
          "title": "Size",
          "type": "integer"
        },
        "width": {
          "exclusiveMinimum": 0,
          "maximum": 100000,
          "title": "Width",
          "type": "integer"
        },
        "height": {
          "exclusiveMinimum": 0,
          "maximum": 100000,
          "title": "Height",
          "type": "integer"
        }
      },
      "required": [
        "sha256",
        "media_type",
        "size",
        "width",
        "height"
      ],
      "title": "ImageArtifactInput",
      "type": "object"
    },
    "RuntimeMode": {
      "enum": [
        "plan",
        "act",
        "operate",
        "review"
      ],
      "title": "RuntimeMode",
      "type": "string"
    }
  },
  "properties": {
    "type": {
      "const": "session.send_message",
      "default": "session.send_message",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "content": {
      "title": "Content",
      "type": "string"
    },
    "display_content": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Display Content"
    },
    "runtime_mode": {
      "$ref": "#/$defs/RuntimeMode",
      "default": "act"
    },
    "attachments": {
      "items": {
        "$ref": "#/$defs/ImageArtifactInput"
      },
      "maxItems": 8,
      "title": "Attachments",
      "type": "array"
    },
    "tools": {
      "anyOf": [
        {
          "items": {
            "enum": [
              "read",
              "bash",
              "edit",
              "write"
            ],
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tools"
    }
  },
  "required": [
    "session_id",
    "content"
  ],
  "title": "SessionSendMessageCommand",
  "type": "object"
}
```

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": "u-5",
  "method": "session.send_message",
  "params": {
    "session_id": "sess-abc123def456",
    "content": "\u603b\u7ed3 README.md",
    "runtime_mode": "act"
  }
}
```

### SessionSendMessageResult

| Field | Type | Required |
|---|---|---|
| `run_id` | `string` | yes |
| `handled` | `boolean` | no |

```json
{
  "properties": {
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "handled": {
      "default": false,
      "title": "Handled",
      "type": "boolean"
    }
  },
  "required": [
    "run_id"
  ],
  "title": "SessionSendMessageResult",
  "type": "object"
}
```

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": "u-5",
  "result": {
    "run_id": "20260516-100000-abc123"
  }
}
```

### SessionGetAuthorityCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.get_authority",
      "default": "session.get_authority",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionGetAuthorityCommand",
  "type": "object"
}
```

### SessionSetAuthorityCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `mode` | `? | null` | no |
| `profile` | `? | null` | no |
| `workspace_trust` | `? | null` | no |

```json
{
  "$defs": {
    "AuthorityProfile": {
      "enum": [
        "ask",
        "auto_review",
        "full_access"
      ],
      "title": "AuthorityProfile",
      "type": "string"
    },
    "RuntimeMode": {
      "enum": [
        "plan",
        "act",
        "operate",
        "review"
      ],
      "title": "RuntimeMode",
      "type": "string"
    },
    "WorkspaceTrust": {
      "enum": [
        "untrusted",
        "trusted"
      ],
      "title": "WorkspaceTrust",
      "type": "string"
    }
  },
  "properties": {
    "type": {
      "const": "session.set_authority",
      "default": "session.set_authority",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "mode": {
      "anyOf": [
        {
          "$ref": "#/$defs/RuntimeMode"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "profile": {
      "anyOf": [
        {
          "$ref": "#/$defs/AuthorityProfile"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "workspace_trust": {
      "anyOf": [
        {
          "$ref": "#/$defs/WorkspaceTrust"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionSetAuthorityCommand",
  "type": "object"
}
```

### SessionAuthorityResult

| Field | Type | Required |
|---|---|---|
| `snapshot` | `object` | yes |

```json
{
  "$defs": {
    "AuthorityProfile": {
      "enum": [
        "ask",
        "auto_review",
        "full_access"
      ],
      "title": "AuthorityProfile",
      "type": "string"
    },
    "AuthoritySnapshot": {
      "additionalProperties": false,
      "properties": {
        "mode": {
          "$ref": "#/$defs/RuntimeMode",
          "default": "act"
        },
        "profile": {
          "$ref": "#/$defs/AuthorityProfile",
          "default": "ask"
        },
        "workspace_trust": {
          "$ref": "#/$defs/WorkspaceTrust",
          "default": "untrusted"
        },
        "sandbox": {
          "$ref": "#/$defs/SandboxCapability"
        },
        "allowed_actions": {
          "items": {
            "$ref": "#/$defs/ToolAction"
          },
          "title": "Allowed Actions",
          "type": "array",
          "uniqueItems": true
        }
      },
      "title": "AuthoritySnapshot",
      "type": "object"
    },
    "RuntimeMode": {
      "enum": [
        "plan",
        "act",
        "operate",
        "review"
      ],
      "title": "RuntimeMode",
      "type": "string"
    },
    "SandboxCapability": {
      "additionalProperties": false,
      "properties": {
        "available": {
          "title": "Available",
          "type": "boolean"
        },
        "kind": {
          "enum": [
            "none",
            "windows_none",
            "windows_acl",
            "linux_bwrap",
            "macos_seatbelt"
          ],
          "title": "Kind",
          "type": "string"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        }
      },
      "required": [
        "available",
        "kind",
        "reason"
      ],
      "title": "SandboxCapability",
      "type": "object"
    },
    "ToolAction": {
      "enum": [
        "read",
        "mutate",
        "shell",
        "external"
      ],
      "title": "ToolAction",
      "type": "string"
    },
    "WorkspaceTrust": {
      "enum": [
        "untrusted",
        "trusted"
      ],
      "title": "WorkspaceTrust",
      "type": "string"
    }
  },
  "properties": {
    "snapshot": {
      "$ref": "#/$defs/AuthoritySnapshot"
    }
  },
  "required": [
    "snapshot"
  ],
  "title": "SessionAuthorityResult",
  "type": "object"
}
```

### SessionGetHistoryCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.get_history",
      "default": "session.get_history",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionGetHistoryCommand",
  "type": "object"
}
```

### SessionGetHistoryResult

| Field | Type | Required |
|---|---|---|
| `messages` | `array` | yes |
| `display_messages` | `array | null` | no |

```json
{
  "properties": {
    "messages": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Messages",
      "type": "array"
    },
    "display_messages": {
      "anyOf": [
        {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Display Messages"
    }
  },
  "required": [
    "messages"
  ],
  "title": "SessionGetHistoryResult",
  "type": "object"
}
```

### SessionListCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `include_closed` | `boolean` | no |
| `limit` | `integer` | no |

```json
{
  "properties": {
    "type": {
      "const": "session.list",
      "default": "session.list",
      "title": "Type",
      "type": "string"
    },
    "include_closed": {
      "default": false,
      "title": "Include Closed",
      "type": "boolean"
    },
    "limit": {
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "SessionListCommand",
  "type": "object"
}
```

### SessionListResult

| Field | Type | Required |
|---|---|---|
| `sessions` | `array` | yes |

```json
{
  "$defs": {
    "SessionInfo": {
      "properties": {
        "session_id": {
          "title": "Session Id",
          "type": "string"
        },
        "mode": {
          "enum": [
            "one_shot",
            "chat"
          ],
          "title": "Mode",
          "type": "string"
        },
        "status": {
          "enum": [
            "active",
            "waiting_for_input",
            "interrupted",
            "closed"
          ],
          "title": "Status",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "created_at": {
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "title": "Updated At",
          "type": "string"
        },
        "run_count": {
          "title": "Run Count",
          "type": "integer"
        },
        "last_run_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Run Id"
        },
        "parent_session_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Parent Session Id"
        },
        "workspace": {
          "default": "",
          "title": "Workspace",
          "type": "string"
        },
        "preset_id": {
          "default": "standard",
          "title": "Preset Id",
          "type": "string"
        },
        "preset_digest": {
          "default": "",
          "title": "Preset Digest",
          "type": "string"
        },
        "route_id": {
          "default": "",
          "title": "Route Id",
          "type": "string"
        },
        "model": {
          "default": "",
          "title": "Model",
          "type": "string"
        },
        "thinking_level": {
          "anyOf": [
            {
              "enum": [
                "off",
                "low",
                "medium",
                "high"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Thinking Level"
        }
      },
      "required": [
        "session_id",
        "mode",
        "status",
        "title",
        "created_at",
        "updated_at",
        "run_count"
      ],
      "title": "SessionInfo",
      "type": "object"
    }
  },
  "properties": {
    "sessions": {
      "items": {
        "$ref": "#/$defs/SessionInfo"
      },
      "title": "Sessions",
      "type": "array"
    }
  },
  "required": [
    "sessions"
  ],
  "title": "SessionListResult",
  "type": "object"
}
```

### SessionResumeCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.resume",
      "default": "session.resume",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionResumeCommand",
  "type": "object"
}
```

### SessionResumeResult

| Field | Type | Required |
|---|---|---|
| `session` | `object` | yes |

```json
{
  "$defs": {
    "SessionInfo": {
      "properties": {
        "session_id": {
          "title": "Session Id",
          "type": "string"
        },
        "mode": {
          "enum": [
            "one_shot",
            "chat"
          ],
          "title": "Mode",
          "type": "string"
        },
        "status": {
          "enum": [
            "active",
            "waiting_for_input",
            "interrupted",
            "closed"
          ],
          "title": "Status",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "created_at": {
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "title": "Updated At",
          "type": "string"
        },
        "run_count": {
          "title": "Run Count",
          "type": "integer"
        },
        "last_run_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Run Id"
        },
        "parent_session_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Parent Session Id"
        },
        "workspace": {
          "default": "",
          "title": "Workspace",
          "type": "string"
        },
        "preset_id": {
          "default": "standard",
          "title": "Preset Id",
          "type": "string"
        },
        "preset_digest": {
          "default": "",
          "title": "Preset Digest",
          "type": "string"
        },
        "route_id": {
          "default": "",
          "title": "Route Id",
          "type": "string"
        },
        "model": {
          "default": "",
          "title": "Model",
          "type": "string"
        },
        "thinking_level": {
          "anyOf": [
            {
              "enum": [
                "off",
                "low",
                "medium",
                "high"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Thinking Level"
        }
      },
      "required": [
        "session_id",
        "mode",
        "status",
        "title",
        "created_at",
        "updated_at",
        "run_count"
      ],
      "title": "SessionInfo",
      "type": "object"
    }
  },
  "properties": {
    "session": {
      "$ref": "#/$defs/SessionInfo"
    }
  },
  "required": [
    "session"
  ],
  "title": "SessionResumeResult",
  "type": "object"
}
```

### SessionRenameCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `title` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.rename",
      "default": "session.rename",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "title": {
      "maxLength": 200,
      "minLength": 1,
      "title": "Title",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "title"
  ],
  "title": "SessionRenameCommand",
  "type": "object"
}
```

### SessionRenameResult

| Field | Type | Required |
|---|---|---|
| `session` | `object` | yes |

```json
{
  "$defs": {
    "SessionInfo": {
      "properties": {
        "session_id": {
          "title": "Session Id",
          "type": "string"
        },
        "mode": {
          "enum": [
            "one_shot",
            "chat"
          ],
          "title": "Mode",
          "type": "string"
        },
        "status": {
          "enum": [
            "active",
            "waiting_for_input",
            "interrupted",
            "closed"
          ],
          "title": "Status",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "created_at": {
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "title": "Updated At",
          "type": "string"
        },
        "run_count": {
          "title": "Run Count",
          "type": "integer"
        },
        "last_run_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Run Id"
        },
        "parent_session_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Parent Session Id"
        },
        "workspace": {
          "default": "",
          "title": "Workspace",
          "type": "string"
        },
        "preset_id": {
          "default": "standard",
          "title": "Preset Id",
          "type": "string"
        },
        "preset_digest": {
          "default": "",
          "title": "Preset Digest",
          "type": "string"
        },
        "route_id": {
          "default": "",
          "title": "Route Id",
          "type": "string"
        },
        "model": {
          "default": "",
          "title": "Model",
          "type": "string"
        },
        "thinking_level": {
          "anyOf": [
            {
              "enum": [
                "off",
                "low",
                "medium",
                "high"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Thinking Level"
        }
      },
      "required": [
        "session_id",
        "mode",
        "status",
        "title",
        "created_at",
        "updated_at",
        "run_count"
      ],
      "title": "SessionInfo",
      "type": "object"
    }
  },
  "properties": {
    "session": {
      "$ref": "#/$defs/SessionInfo"
    }
  },
  "required": [
    "session"
  ],
  "title": "SessionRenameResult",
  "type": "object"
}
```

### SessionForkCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `leaf_seq` | `integer | null` | no |
| `title` | `string` | no |
| `preset_id` | `string | null` | no |

```json
{
  "properties": {
    "type": {
      "const": "session.fork",
      "default": "session.fork",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "leaf_seq": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Leaf Seq"
    },
    "title": {
      "default": "",
      "maxLength": 200,
      "title": "Title",
      "type": "string"
    },
    "preset_id": {
      "anyOf": [
        {
          "pattern": "^[a-z][a-z0-9-]{0,63}$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Preset Id"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionForkCommand",
  "type": "object"
}
```

### SessionForkResult

| Field | Type | Required |
|---|---|---|
| `session` | `object` | yes |

```json
{
  "$defs": {
    "SessionInfo": {
      "properties": {
        "session_id": {
          "title": "Session Id",
          "type": "string"
        },
        "mode": {
          "enum": [
            "one_shot",
            "chat"
          ],
          "title": "Mode",
          "type": "string"
        },
        "status": {
          "enum": [
            "active",
            "waiting_for_input",
            "interrupted",
            "closed"
          ],
          "title": "Status",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "created_at": {
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "title": "Updated At",
          "type": "string"
        },
        "run_count": {
          "title": "Run Count",
          "type": "integer"
        },
        "last_run_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Run Id"
        },
        "parent_session_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Parent Session Id"
        },
        "workspace": {
          "default": "",
          "title": "Workspace",
          "type": "string"
        },
        "preset_id": {
          "default": "standard",
          "title": "Preset Id",
          "type": "string"
        },
        "preset_digest": {
          "default": "",
          "title": "Preset Digest",
          "type": "string"
        },
        "route_id": {
          "default": "",
          "title": "Route Id",
          "type": "string"
        },
        "model": {
          "default": "",
          "title": "Model",
          "type": "string"
        },
        "thinking_level": {
          "anyOf": [
            {
              "enum": [
                "off",
                "low",
                "medium",
                "high"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Thinking Level"
        }
      },
      "required": [
        "session_id",
        "mode",
        "status",
        "title",
        "created_at",
        "updated_at",
        "run_count"
      ],
      "title": "SessionInfo",
      "type": "object"
    }
  },
  "properties": {
    "session": {
      "$ref": "#/$defs/SessionInfo"
    }
  },
  "required": [
    "session"
  ],
  "title": "SessionForkResult",
  "type": "object"
}
```

### SessionExportCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `format` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "session.export",
      "default": "session.export",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "format": {
      "default": "markdown",
      "enum": [
        "markdown",
        "json",
        "html"
      ],
      "title": "Format",
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionExportCommand",
  "type": "object"
}
```

### SessionExportResult

| Field | Type | Required |
|---|---|---|
| `filename` | `string` | yes |
| `media_type` | `string` | yes |
| `content` | `string` | yes |

```json
{
  "properties": {
    "filename": {
      "title": "Filename",
      "type": "string"
    },
    "media_type": {
      "title": "Media Type",
      "type": "string"
    },
    "content": {
      "title": "Content",
      "type": "string"
    }
  },
  "required": [
    "filename",
    "media_type",
    "content"
  ],
  "title": "SessionExportResult",
  "type": "object"
}
```

### SessionDeleteCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.delete",
      "default": "session.delete",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionDeleteCommand",
  "type": "object"
}
```

### SessionDeleteResult

| Field | Type | Required |
|---|---|---|
| `session_id` | `string` | yes |
| `deleted` | `boolean` | no |

```json
{
  "properties": {
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "deleted": {
      "const": true,
      "default": true,
      "title": "Deleted",
      "type": "boolean"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionDeleteResult",
  "type": "object"
}
```

### SessionCloseCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.close",
      "default": "session.close",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionCloseCommand",
  "type": "object"
}
```

### SessionCloseResult

| Field | Type | Required |
|---|---|---|
| `status` | `string` | yes |

```json
{
  "properties": {
    "status": {
      "enum": [
        "active",
        "waiting_for_input",
        "interrupted",
        "closed"
      ],
      "title": "Status",
      "type": "string"
    }
  },
  "required": [
    "status"
  ],
  "title": "SessionCloseResult",
  "type": "object"
}
```

### PermissionRespondCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `tool_use_id` | `string` | yes |
| `session_id` | `string` | yes |
| `decision` | `string` | yes |
| `selected_hunks` | `array | null` | no |
| `patch_plan_id` | `string | null` | no |

```json
{
  "properties": {
    "type": {
      "const": "permission.respond",
      "default": "permission.respond",
      "title": "Type",
      "type": "string"
    },
    "tool_use_id": {
      "minLength": 1,
      "title": "Tool Use Id",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "decision": {
      "title": "Decision",
      "type": "string"
    },
    "selected_hunks": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "maxItems": 1000,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Selected Hunks"
    },
    "patch_plan_id": {
      "anyOf": [
        {
          "maxLength": 128,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Patch Plan Id"
    }
  },
  "required": [
    "tool_use_id",
    "session_id",
    "decision"
  ],
  "title": "PermissionRespondCommand",
  "type": "object"
}
```

### PermissionRespondResult

| Field | Type | Required |
|---|---|---|
| `ok` | `boolean` | no |

```json
{
  "properties": {
    "ok": {
      "default": true,
      "title": "Ok",
      "type": "boolean"
    }
  },
  "title": "PermissionRespondResult",
  "type": "object"
}
```

### UserQuestionRespondCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `question_id` | `string` | yes |
| `answer` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "user_question.respond",
      "default": "user_question.respond",
      "title": "Type",
      "type": "string"
    },
    "question_id": {
      "title": "Question Id",
      "type": "string"
    },
    "answer": {
      "maxLength": 10000,
      "minLength": 1,
      "title": "Answer",
      "type": "string"
    }
  },
  "required": [
    "question_id",
    "answer"
  ],
  "title": "UserQuestionRespondCommand",
  "type": "object"
}
```

### UserQuestionRespondResult

| Field | Type | Required |
|---|---|---|
| `answered` | `boolean` | no |

```json
{
  "properties": {
    "answered": {
      "const": true,
      "default": true,
      "title": "Answered",
      "type": "boolean"
    }
  },
  "title": "UserQuestionRespondResult",
  "type": "object"
}
```

### SessionCompactCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `focus` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "session.compact",
      "default": "session.compact",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "focus": {
      "default": "",
      "title": "Focus",
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionCompactCommand",
  "type": "object"
}
```

### SessionCompactResult

| Field | Type | Required |
|---|---|---|
| `status` | `string` | no |
| `message` | `string` | no |
| `summary_tokens` | `integer` | yes |
| `saved_tokens` | `integer` | yes |
| `original_tokens` | `integer` | no |
| `compacted_tokens` | `integer` | no |
| `retained_tokens` | `integer` | no |
| `retained_messages` | `integer` | no |
| `quality_score` | `number` | no |
| `summary_path` | `string` | no |

```json
{
  "properties": {
    "status": {
      "default": "compacted",
      "enum": [
        "compacted",
        "not_needed"
      ],
      "title": "Status",
      "type": "string"
    },
    "message": {
      "default": "",
      "title": "Message",
      "type": "string"
    },
    "summary_tokens": {
      "title": "Summary Tokens",
      "type": "integer"
    },
    "saved_tokens": {
      "title": "Saved Tokens",
      "type": "integer"
    },
    "original_tokens": {
      "default": 0,
      "title": "Original Tokens",
      "type": "integer"
    },
    "compacted_tokens": {
      "default": 0,
      "title": "Compacted Tokens",
      "type": "integer"
    },
    "retained_tokens": {
      "default": 0,
      "title": "Retained Tokens",
      "type": "integer"
    },
    "retained_messages": {
      "default": 0,
      "title": "Retained Messages",
      "type": "integer"
    },
    "quality_score": {
      "default": 1.0,
      "title": "Quality Score",
      "type": "number"
    },
    "summary_path": {
      "default": "",
      "title": "Summary Path",
      "type": "string"
    }
  },
  "required": [
    "summary_tokens",
    "saved_tokens"
  ],
  "title": "SessionCompactResult",
  "type": "object"
}
```

### SessionTasksCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.tasks",
      "default": "session.tasks",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionTasksCommand",
  "type": "object"
}
```

### SessionTasksResult

| Field | Type | Required |
|---|---|---|
| `run_id` | `string | null` | no |
| `tasks` | `array` | no |

```json
{
  "properties": {
    "run_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Run Id"
    },
    "tasks": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Tasks",
      "type": "array"
    }
  },
  "title": "SessionTasksResult",
  "type": "object"
}
```

### WorkerListCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `worker_id` | `string` | no |
| `root_goal_id` | `string` | no |
| `limit` | `integer` | no |

```json
{
  "properties": {
    "type": {
      "const": "worker.list",
      "default": "worker.list",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "worker_id": {
      "default": "",
      "title": "Worker Id",
      "type": "string"
    },
    "root_goal_id": {
      "default": "",
      "title": "Root Goal Id",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "WorkerListCommand",
  "type": "object"
}
```

### WorkerListResult

| Field | Type | Required |
|---|---|---|
| `workers` | `array` | no |

```json
{
  "properties": {
    "workers": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Workers",
      "type": "array"
    }
  },
  "title": "WorkerListResult",
  "type": "object"
}
```

### WorkerStartCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `description` | `string` | yes |
| `prompt` | `string` | yes |
| `profile` | `string` | no |
| `route_id` | `string` | no |
| `model` | `string` | no |
| `read_only` | `boolean` | no |
| `exact_files` | `array` | no |
| `write_roots` | `array` | no |
| `coordination_contract` | `string` | no |
| `acceptance` | `array` | no |
| `token_budget` | `integer | null` | no |
| `wall_time_s` | `integer` | no |
| `max_attempts` | `integer` | no |
| `retry_backoff_s` | `number` | no |
| `backend` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "worker.start",
      "default": "worker.start",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "description": {
      "maxLength": 500,
      "minLength": 1,
      "title": "Description",
      "type": "string"
    },
    "prompt": {
      "maxLength": 100000,
      "minLength": 1,
      "title": "Prompt",
      "type": "string"
    },
    "profile": {
      "default": "",
      "maxLength": 64,
      "title": "Profile",
      "type": "string"
    },
    "route_id": {
      "default": "",
      "maxLength": 256,
      "title": "Route Id",
      "type": "string"
    },
    "model": {
      "default": "",
      "maxLength": 256,
      "title": "Model",
      "type": "string"
    },
    "read_only": {
      "default": true,
      "title": "Read Only",
      "type": "boolean"
    },
    "exact_files": {
      "items": {
        "type": "string"
      },
      "maxItems": 200,
      "title": "Exact Files",
      "type": "array"
    },
    "write_roots": {
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "title": "Write Roots",
      "type": "array"
    },
    "coordination_contract": {
      "default": "",
      "maxLength": 2000,
      "title": "Coordination Contract",
      "type": "string"
    },
    "acceptance": {
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "title": "Acceptance",
      "type": "array"
    },
    "token_budget": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Token Budget"
    },
    "wall_time_s": {
      "default": 900,
      "maximum": 86400,
      "minimum": 1,
      "title": "Wall Time S",
      "type": "integer"
    },
    "max_attempts": {
      "default": 3,
      "maximum": 10,
      "minimum": 1,
      "title": "Max Attempts",
      "type": "integer"
    },
    "retry_backoff_s": {
      "default": 1.0,
      "maximum": 300,
      "minimum": 0,
      "title": "Retry Backoff S",
      "type": "number"
    },
    "backend": {
      "default": "builtin",
      "pattern": "^[a-z][a-z0-9-]{0,63}$",
      "title": "Backend",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "description",
    "prompt"
  ],
  "title": "WorkerStartCommand",
  "type": "object"
}
```

### WorkerStartResult

| Field | Type | Required |
|---|---|---|
| `worker_id` | `string` | yes |
| `session_id` | `string` | yes |
| `status` | `string` | yes |
| `route_id` | `string` | yes |
| `model` | `string` | yes |
| `attempt` | `integer` | yes |
| `worktree` | `string` | no |
| `read_only` | `boolean` | yes |
| `backend` | `string` | no |
| `backend_capabilities` | `object` | no |
| `sandbox_enforcement` | `string` | no |

```json
{
  "$defs": {
    "JsonValue": {}
  },
  "properties": {
    "worker_id": {
      "title": "Worker Id",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "status": {
      "title": "Status",
      "type": "string"
    },
    "route_id": {
      "title": "Route Id",
      "type": "string"
    },
    "model": {
      "title": "Model",
      "type": "string"
    },
    "attempt": {
      "minimum": 1,
      "title": "Attempt",
      "type": "integer"
    },
    "worktree": {
      "default": "",
      "title": "Worktree",
      "type": "string"
    },
    "read_only": {
      "title": "Read Only",
      "type": "boolean"
    },
    "backend": {
      "default": "builtin",
      "title": "Backend",
      "type": "string"
    },
    "backend_capabilities": {
      "additionalProperties": {
        "$ref": "#/$defs/JsonValue"
      },
      "title": "Backend Capabilities",
      "type": "object"
    },
    "sandbox_enforcement": {
      "default": "unavailable",
      "enum": [
        "full",
        "partial",
        "unavailable"
      ],
      "title": "Sandbox Enforcement",
      "type": "string"
    }
  },
  "required": [
    "worker_id",
    "session_id",
    "status",
    "route_id",
    "model",
    "attempt",
    "read_only"
  ],
  "title": "WorkerStartResult",
  "type": "object"
}
```

### WorkerStatusCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `worker_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "worker.status",
      "default": "worker.status",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "worker_id": {
      "minLength": 1,
      "title": "Worker Id",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "worker_id"
  ],
  "title": "WorkerStatusCommand",
  "type": "object"
}
```

### WorkerStatusResult

| Field | Type | Required |
|---|---|---|
| `worker` | `object` | yes |

```json
{
  "properties": {
    "worker": {
      "additionalProperties": true,
      "title": "Worker",
      "type": "object"
    }
  },
  "required": [
    "worker"
  ],
  "title": "WorkerStatusResult",
  "type": "object"
}
```

### WorkerRetryCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `worker_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "worker.retry",
      "default": "worker.retry",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "worker_id": {
      "minLength": 1,
      "title": "Worker Id",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "worker_id"
  ],
  "title": "WorkerRetryCommand",
  "type": "object"
}
```

### WorkerRetryResult

| Field | Type | Required |
|---|---|---|
| `worker_id` | `string` | yes |
| `session_id` | `string` | yes |
| `status` | `string` | yes |
| `route_id` | `string` | yes |
| `model` | `string` | yes |
| `attempt` | `integer` | yes |
| `worktree` | `string` | no |
| `read_only` | `boolean` | yes |
| `backend` | `string` | no |
| `backend_capabilities` | `object` | no |
| `sandbox_enforcement` | `string` | no |

```json
{
  "$defs": {
    "JsonValue": {}
  },
  "properties": {
    "worker_id": {
      "title": "Worker Id",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "status": {
      "title": "Status",
      "type": "string"
    },
    "route_id": {
      "title": "Route Id",
      "type": "string"
    },
    "model": {
      "title": "Model",
      "type": "string"
    },
    "attempt": {
      "minimum": 1,
      "title": "Attempt",
      "type": "integer"
    },
    "worktree": {
      "default": "",
      "title": "Worktree",
      "type": "string"
    },
    "read_only": {
      "title": "Read Only",
      "type": "boolean"
    },
    "backend": {
      "default": "builtin",
      "title": "Backend",
      "type": "string"
    },
    "backend_capabilities": {
      "additionalProperties": {
        "$ref": "#/$defs/JsonValue"
      },
      "title": "Backend Capabilities",
      "type": "object"
    },
    "sandbox_enforcement": {
      "default": "unavailable",
      "enum": [
        "full",
        "partial",
        "unavailable"
      ],
      "title": "Sandbox Enforcement",
      "type": "string"
    }
  },
  "required": [
    "worker_id",
    "session_id",
    "status",
    "route_id",
    "model",
    "attempt",
    "read_only"
  ],
  "title": "WorkerRetryResult",
  "type": "object"
}
```

### WorkerEventsCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `worker_id` | `string` | yes |
| `after_cursor` | `integer` | no |
| `limit` | `integer` | no |

```json
{
  "properties": {
    "type": {
      "const": "worker.events",
      "default": "worker.events",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "worker_id": {
      "minLength": 1,
      "title": "Worker Id",
      "type": "string"
    },
    "after_cursor": {
      "default": 0,
      "minimum": 0,
      "title": "After Cursor",
      "type": "integer"
    },
    "limit": {
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "session_id",
    "worker_id"
  ],
  "title": "WorkerEventsCommand",
  "type": "object"
}
```

### WorkerEventsResult

| Field | Type | Required |
|---|---|---|
| `events` | `array` | no |

```json
{
  "properties": {
    "events": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Events",
      "type": "array"
    }
  },
  "title": "WorkerEventsResult",
  "type": "object"
}
```

### WorkerFollowupCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `worker_id` | `string` | yes |
| `message` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "worker.followup",
      "default": "worker.followup",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "worker_id": {
      "minLength": 1,
      "title": "Worker Id",
      "type": "string"
    },
    "message": {
      "maxLength": 8000,
      "minLength": 1,
      "title": "Message",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "worker_id",
    "message"
  ],
  "title": "WorkerFollowupCommand",
  "type": "object"
}
```

### WorkerFollowupResult

| Field | Type | Required |
|---|---|---|
| `worker_id` | `string` | yes |
| `status` | `string` | yes |
| `event_cursor` | `integer` | yes |

```json
{
  "properties": {
    "worker_id": {
      "title": "Worker Id",
      "type": "string"
    },
    "status": {
      "title": "Status",
      "type": "string"
    },
    "event_cursor": {
      "minimum": 0,
      "title": "Event Cursor",
      "type": "integer"
    }
  },
  "required": [
    "worker_id",
    "status",
    "event_cursor"
  ],
  "title": "WorkerFollowupResult",
  "type": "object"
}
```

### WorkerReviewCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `worker_id` | `string` | yes |
| `approved` | `boolean` | yes |
| `confirmed` | `boolean` | no |
| `expected_digest` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "worker.review",
      "default": "worker.review",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "worker_id": {
      "minLength": 1,
      "title": "Worker Id",
      "type": "string"
    },
    "approved": {
      "title": "Approved",
      "type": "boolean"
    },
    "confirmed": {
      "default": false,
      "title": "Confirmed",
      "type": "boolean"
    },
    "expected_digest": {
      "default": "",
      "title": "Expected Digest",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "worker_id",
    "approved"
  ],
  "title": "WorkerReviewCommand",
  "type": "object"
}
```

### WorkerReviewResult

| Field | Type | Required |
|---|---|---|
| `worker_id` | `string` | yes |
| `handoff_status` | `string` | yes |
| `approved` | `boolean` | yes |
| `applied` | `boolean` | no |
| `state_digest` | `string` | no |
| `preview_only` | `boolean` | no |
| `changed_files` | `array` | no |
| `diff` | `string` | no |
| `diff_truncated` | `boolean` | no |

```json
{
  "properties": {
    "worker_id": {
      "title": "Worker Id",
      "type": "string"
    },
    "handoff_status": {
      "title": "Handoff Status",
      "type": "string"
    },
    "approved": {
      "title": "Approved",
      "type": "boolean"
    },
    "applied": {
      "const": false,
      "default": false,
      "title": "Applied",
      "type": "boolean"
    },
    "state_digest": {
      "default": "",
      "title": "State Digest",
      "type": "string"
    },
    "preview_only": {
      "default": false,
      "title": "Preview Only",
      "type": "boolean"
    },
    "changed_files": {
      "items": {
        "type": "string"
      },
      "title": "Changed Files",
      "type": "array"
    },
    "diff": {
      "default": "",
      "title": "Diff",
      "type": "string"
    },
    "diff_truncated": {
      "default": false,
      "title": "Diff Truncated",
      "type": "boolean"
    }
  },
  "required": [
    "worker_id",
    "handoff_status",
    "approved"
  ],
  "title": "WorkerReviewResult",
  "type": "object"
}
```

### WorkerApplyCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `worker_id` | `string` | yes |
| `expected_digest` | `string` | yes |
| `confirmed` | `boolean` | no |

```json
{
  "properties": {
    "type": {
      "const": "worker.apply",
      "default": "worker.apply",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "worker_id": {
      "minLength": 1,
      "title": "Worker Id",
      "type": "string"
    },
    "expected_digest": {
      "pattern": "^[0-9a-f]{64}$",
      "title": "Expected Digest",
      "type": "string"
    },
    "confirmed": {
      "default": false,
      "title": "Confirmed",
      "type": "boolean"
    }
  },
  "required": [
    "session_id",
    "worker_id",
    "expected_digest"
  ],
  "title": "WorkerApplyCommand",
  "type": "object"
}
```

### WorkerApplyResult

| Field | Type | Required |
|---|---|---|
| `worker_id` | `string` | yes |
| `handoff_status` | `string` | no |
| `changed_files` | `array` | no |
| `state_digest` | `string` | yes |

```json
{
  "properties": {
    "worker_id": {
      "title": "Worker Id",
      "type": "string"
    },
    "handoff_status": {
      "const": "applied",
      "default": "applied",
      "title": "Handoff Status",
      "type": "string"
    },
    "changed_files": {
      "items": {
        "type": "string"
      },
      "title": "Changed Files",
      "type": "array"
    },
    "state_digest": {
      "pattern": "^[0-9a-f]{64}$",
      "title": "State Digest",
      "type": "string"
    }
  },
  "required": [
    "worker_id",
    "state_digest"
  ],
  "title": "WorkerApplyResult",
  "type": "object"
}
```

### WorkflowStartCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `source` | `string` | yes |
| `format` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "workflow.start",
      "default": "workflow.start",
      "title": "Type",
      "type": "string"
    },
    "source": {
      "maxLength": 1048576,
      "minLength": 1,
      "title": "Source",
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "toml"
      ],
      "title": "Format",
      "type": "string"
    }
  },
  "required": [
    "source",
    "format"
  ],
  "title": "WorkflowStartCommand",
  "type": "object"
}
```

### WorkflowStartResult

| Field | Type | Required |
|---|---|---|
| `workflow_id` | `string` | yes |
| `status` | `string` | no |

```json
{
  "properties": {
    "workflow_id": {
      "title": "Workflow Id",
      "type": "string"
    },
    "status": {
      "const": "started",
      "default": "started",
      "title": "Status",
      "type": "string"
    }
  },
  "required": [
    "workflow_id"
  ],
  "title": "WorkflowStartResult",
  "type": "object"
}
```

### WorkflowListCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `limit` | `integer` | no |

```json
{
  "properties": {
    "type": {
      "const": "workflow.list",
      "default": "workflow.list",
      "title": "Type",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "WorkflowListCommand",
  "type": "object"
}
```

### WorkflowListResult

| Field | Type | Required |
|---|---|---|
| `workflows` | `array` | no |

```json
{
  "properties": {
    "workflows": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Workflows",
      "type": "array"
    }
  },
  "title": "WorkflowListResult",
  "type": "object"
}
```

### WorkflowGetCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `workflow_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "workflow.get",
      "default": "workflow.get",
      "title": "Type",
      "type": "string"
    },
    "workflow_id": {
      "minLength": 1,
      "title": "Workflow Id",
      "type": "string"
    }
  },
  "required": [
    "workflow_id"
  ],
  "title": "WorkflowGetCommand",
  "type": "object"
}
```

### WorkflowGetResult

| Field | Type | Required |
|---|---|---|
| `workflow` | `object` | yes |

```json
{
  "properties": {
    "workflow": {
      "additionalProperties": true,
      "title": "Workflow",
      "type": "object"
    }
  },
  "required": [
    "workflow"
  ],
  "title": "WorkflowGetResult",
  "type": "object"
}
```

### WorkspaceDiffCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `scope` | `string` | no |
| `path` | `string` | no |
| `session_id` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "workspace.diff",
      "default": "workspace.diff",
      "title": "Type",
      "type": "string"
    },
    "scope": {
      "default": "all",
      "enum": [
        "all",
        "staged",
        "unstaged"
      ],
      "title": "Scope",
      "type": "string"
    },
    "path": {
      "default": ".",
      "title": "Path",
      "type": "string"
    },
    "session_id": {
      "default": "",
      "title": "Session Id",
      "type": "string"
    }
  },
  "title": "WorkspaceDiffCommand",
  "type": "object"
}
```

### WorkspaceDiffResult

| Field | Type | Required |
|---|---|---|
| `payload` | `object` | yes |

```json
{
  "properties": {
    "payload": {
      "additionalProperties": true,
      "title": "Payload",
      "type": "object"
    }
  },
  "required": [
    "payload"
  ],
  "title": "WorkspaceDiffResult",
  "type": "object"
}
```

### SessionCheckpointsCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `run_id` | `string | null` | no |

```json
{
  "properties": {
    "type": {
      "const": "session.checkpoints",
      "default": "session.checkpoints",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "run_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Run Id"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionCheckpointsCommand",
  "type": "object"
}
```

### SessionCheckpointsResult

| Field | Type | Required |
|---|---|---|
| `run_id` | `string | null` | no |
| `checkpoints` | `array` | no |

```json
{
  "properties": {
    "run_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Run Id"
    },
    "checkpoints": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Checkpoints",
      "type": "array"
    }
  },
  "title": "SessionCheckpointsResult",
  "type": "object"
}
```

### SessionRewindCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `checkpoint_id` | `string` | yes |
| `run_id` | `string | null` | no |
| `expected_digest` | `string` | yes |
| `confirmed` | `boolean` | no |

```json
{
  "properties": {
    "type": {
      "const": "session.rewind",
      "default": "session.rewind",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "checkpoint_id": {
      "title": "Checkpoint Id",
      "type": "string"
    },
    "run_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Run Id"
    },
    "expected_digest": {
      "maxLength": 64,
      "minLength": 64,
      "title": "Expected Digest",
      "type": "string"
    },
    "confirmed": {
      "default": false,
      "title": "Confirmed",
      "type": "boolean"
    }
  },
  "required": [
    "session_id",
    "checkpoint_id",
    "expected_digest"
  ],
  "title": "SessionRewindCommand",
  "type": "object"
}
```

### SessionRewindResult

| Field | Type | Required |
|---|---|---|
| `checkpoint_id` | `string` | yes |
| `restored` | `array` | no |
| `already_restored` | `array` | no |

```json
{
  "properties": {
    "checkpoint_id": {
      "title": "Checkpoint Id",
      "type": "string"
    },
    "restored": {
      "items": {
        "type": "string"
      },
      "title": "Restored",
      "type": "array"
    },
    "already_restored": {
      "items": {
        "type": "string"
      },
      "title": "Already Restored",
      "type": "array"
    }
  },
  "required": [
    "checkpoint_id"
  ],
  "title": "SessionRewindResult",
  "type": "object"
}
```

### SessionContextCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.context",
      "default": "session.context",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionContextCommand",
  "type": "object"
}
```

### SessionContextResult

| Field | Type | Required |
|---|---|---|
| `input_commands` | `array` | no |
| `message_count` | `integer` | yes |
| `estimated_tokens` | `integer` | yes |
| `run_count` | `integer` | yes |
| `last_run_id` | `string | null` | no |
| `usage` | `object` | no |
| `session_usage` | `object` | no |
| `working_set` | `array` | no |
| `memory_count` | `integer` | no |
| `compaction` | `object | null` | no |
| `tool_schema_tokens` | `integer | null` | no |
| `system_tokens` | `integer | null` | no |

```json
{
  "properties": {
    "input_commands": {
      "items": {
        "additionalProperties": {
          "type": "string"
        },
        "type": "object"
      },
      "title": "Input Commands",
      "type": "array"
    },
    "message_count": {
      "title": "Message Count",
      "type": "integer"
    },
    "estimated_tokens": {
      "title": "Estimated Tokens",
      "type": "integer"
    },
    "run_count": {
      "title": "Run Count",
      "type": "integer"
    },
    "last_run_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Last Run Id"
    },
    "usage": {
      "additionalProperties": true,
      "title": "Usage",
      "type": "object"
    },
    "session_usage": {
      "additionalProperties": true,
      "title": "Session Usage",
      "type": "object"
    },
    "working_set": {
      "items": {
        "type": "string"
      },
      "title": "Working Set",
      "type": "array"
    },
    "memory_count": {
      "default": 0,
      "minimum": 0,
      "title": "Memory Count",
      "type": "integer"
    },
    "compaction": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Compaction"
    },
    "tool_schema_tokens": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tool Schema Tokens"
    },
    "system_tokens": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "System Tokens"
    }
  },
  "required": [
    "message_count",
    "estimated_tokens",
    "run_count"
  ],
  "title": "SessionContextResult",
  "type": "object"
}
```

### TurnInspectCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `turn_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "turn.inspect",
      "default": "turn.inspect",
      "title": "Type",
      "type": "string"
    },
    "turn_id": {
      "minLength": 1,
      "title": "Turn Id",
      "type": "string"
    }
  },
  "required": [
    "turn_id"
  ],
  "title": "TurnInspectCommand",
  "type": "object"
}
```

### TurnInspectResult

| Field | Type | Required |
|---|---|---|
| `turn` | `object` | yes |
| `items` | `array` | no |
| `events` | `array` | no |
| `receipt` | `object` | yes |

```json
{
  "properties": {
    "turn": {
      "additionalProperties": true,
      "title": "Turn",
      "type": "object"
    },
    "items": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Items",
      "type": "array"
    },
    "events": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Events",
      "type": "array"
    },
    "receipt": {
      "additionalProperties": true,
      "title": "Receipt",
      "type": "object"
    }
  },
  "required": [
    "turn",
    "receipt"
  ],
  "title": "TurnInspectResult",
  "type": "object"
}
```

### McpListCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "mcp.list",
      "default": "mcp.list",
      "title": "Type",
      "type": "string"
    }
  },
  "title": "McpListCommand",
  "type": "object"
}
```

### McpListResult

| Field | Type | Required |
|---|---|---|
| `servers` | `array` | no |

```json
{
  "$defs": {
    "McpServerInfo": {
      "properties": {
        "name": {
          "title": "Name",
          "type": "string"
        },
        "transport": {
          "title": "Transport",
          "type": "string"
        },
        "status": {
          "title": "Status",
          "type": "string"
        },
        "tool_count": {
          "title": "Tool Count",
          "type": "integer"
        },
        "tools": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Tools",
          "type": "array"
        },
        "error": {
          "default": "",
          "title": "Error",
          "type": "string"
        }
      },
      "required": [
        "name",
        "transport",
        "status",
        "tool_count"
      ],
      "title": "McpServerInfo",
      "type": "object"
    }
  },
  "properties": {
    "servers": {
      "items": {
        "$ref": "#/$defs/McpServerInfo"
      },
      "title": "Servers",
      "type": "array"
    }
  },
  "title": "McpListResult",
  "type": "object"
}
```

### McpServerInfo

| Field | Type | Required |
|---|---|---|
| `name` | `string` | yes |
| `transport` | `string` | yes |
| `status` | `string` | yes |
| `tool_count` | `integer` | yes |
| `tools` | `array` | no |
| `error` | `string` | no |

```json
{
  "properties": {
    "name": {
      "title": "Name",
      "type": "string"
    },
    "transport": {
      "title": "Transport",
      "type": "string"
    },
    "status": {
      "title": "Status",
      "type": "string"
    },
    "tool_count": {
      "title": "Tool Count",
      "type": "integer"
    },
    "tools": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Tools",
      "type": "array"
    },
    "error": {
      "default": "",
      "title": "Error",
      "type": "string"
    }
  },
  "required": [
    "name",
    "transport",
    "status",
    "tool_count"
  ],
  "title": "McpServerInfo",
  "type": "object"
}
```

### HooksListCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `limit` | `integer` | no |

```json
{
  "properties": {
    "type": {
      "const": "hooks.list",
      "default": "hooks.list",
      "title": "Type",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "HooksListCommand",
  "type": "object"
}
```

### HooksListResult

| Field | Type | Required |
|---|---|---|
| `configs` | `array` | no |
| `audit_events` | `array` | no |

```json
{
  "$defs": {
    "HookAuditInfo": {
      "properties": {
        "hook_id": {
          "title": "Hook Id",
          "type": "string"
        },
        "run_id": {
          "default": "",
          "title": "Run Id",
          "type": "string"
        },
        "event": {
          "title": "Event",
          "type": "string"
        },
        "status": {
          "title": "Status",
          "type": "string"
        },
        "blocking": {
          "title": "Blocking",
          "type": "boolean"
        },
        "elapsed_ms": {
          "title": "Elapsed Ms",
          "type": "integer"
        },
        "blocked": {
          "title": "Blocked",
          "type": "boolean"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        },
        "exit_code": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Exit Code"
        },
        "process_usage": {
          "additionalProperties": true,
          "title": "Process Usage",
          "type": "object"
        },
        "ts": {
          "title": "Ts",
          "type": "string"
        }
      },
      "required": [
        "hook_id",
        "event",
        "status",
        "blocking",
        "elapsed_ms",
        "blocked",
        "reason",
        "ts"
      ],
      "title": "HookAuditInfo",
      "type": "object"
    },
    "HookConfigInfo": {
      "properties": {
        "id": {
          "title": "Id",
          "type": "string"
        },
        "event": {
          "title": "Event",
          "type": "string"
        },
        "blocking": {
          "title": "Blocking",
          "type": "boolean"
        },
        "trusted_scope": {
          "title": "Trusted Scope",
          "type": "string"
        },
        "on_failure": {
          "title": "On Failure",
          "type": "string"
        },
        "command": {
          "items": {
            "type": "string"
          },
          "title": "Command",
          "type": "array"
        },
        "conditions": {
          "additionalProperties": {
            "type": "string"
          },
          "title": "Conditions",
          "type": "object"
        }
      },
      "required": [
        "id",
        "event",
        "blocking",
        "trusted_scope",
        "on_failure"
      ],
      "title": "HookConfigInfo",
      "type": "object"
    }
  },
  "properties": {
    "configs": {
      "items": {
        "$ref": "#/$defs/HookConfigInfo"
      },
      "title": "Configs",
      "type": "array"
    },
    "audit_events": {
      "items": {
        "$ref": "#/$defs/HookAuditInfo"
      },
      "title": "Audit Events",
      "type": "array"
    }
  },
  "title": "HooksListResult",
  "type": "object"
}
```

### HookConfigInfo

| Field | Type | Required |
|---|---|---|
| `id` | `string` | yes |
| `event` | `string` | yes |
| `blocking` | `boolean` | yes |
| `trusted_scope` | `string` | yes |
| `on_failure` | `string` | yes |
| `command` | `array` | no |
| `conditions` | `object` | no |

```json
{
  "properties": {
    "id": {
      "title": "Id",
      "type": "string"
    },
    "event": {
      "title": "Event",
      "type": "string"
    },
    "blocking": {
      "title": "Blocking",
      "type": "boolean"
    },
    "trusted_scope": {
      "title": "Trusted Scope",
      "type": "string"
    },
    "on_failure": {
      "title": "On Failure",
      "type": "string"
    },
    "command": {
      "items": {
        "type": "string"
      },
      "title": "Command",
      "type": "array"
    },
    "conditions": {
      "additionalProperties": {
        "type": "string"
      },
      "title": "Conditions",
      "type": "object"
    }
  },
  "required": [
    "id",
    "event",
    "blocking",
    "trusted_scope",
    "on_failure"
  ],
  "title": "HookConfigInfo",
  "type": "object"
}
```

### HookAuditInfo

| Field | Type | Required |
|---|---|---|
| `hook_id` | `string` | yes |
| `run_id` | `string` | no |
| `event` | `string` | yes |
| `status` | `string` | yes |
| `blocking` | `boolean` | yes |
| `elapsed_ms` | `integer` | yes |
| `blocked` | `boolean` | yes |
| `reason` | `string` | yes |
| `exit_code` | `integer | null` | no |
| `process_usage` | `object` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "hook_id": {
      "title": "Hook Id",
      "type": "string"
    },
    "run_id": {
      "default": "",
      "title": "Run Id",
      "type": "string"
    },
    "event": {
      "title": "Event",
      "type": "string"
    },
    "status": {
      "title": "Status",
      "type": "string"
    },
    "blocking": {
      "title": "Blocking",
      "type": "boolean"
    },
    "elapsed_ms": {
      "title": "Elapsed Ms",
      "type": "integer"
    },
    "blocked": {
      "title": "Blocked",
      "type": "boolean"
    },
    "reason": {
      "title": "Reason",
      "type": "string"
    },
    "exit_code": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Exit Code"
    },
    "process_usage": {
      "additionalProperties": true,
      "title": "Process Usage",
      "type": "object"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "hook_id",
    "event",
    "status",
    "blocking",
    "elapsed_ms",
    "blocked",
    "reason",
    "ts"
  ],
  "title": "HookAuditInfo",
  "type": "object"
}
```

### HookRerunCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `hook_id` | `string` | yes |
| `session_id` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "hooks.rerun",
      "default": "hooks.rerun",
      "title": "Type",
      "type": "string"
    },
    "hook_id": {
      "minLength": 1,
      "title": "Hook Id",
      "type": "string"
    },
    "session_id": {
      "default": "",
      "title": "Session Id",
      "type": "string"
    }
  },
  "required": [
    "hook_id"
  ],
  "title": "HookRerunCommand",
  "type": "object"
}
```

### HookRerunResult

| Field | Type | Required |
|---|---|---|
| `hook_id` | `string` | yes |
| `executed` | `boolean` | yes |
| `status` | `string` | no |
| `reason` | `string` | no |
| `ts` | `string` | no |

```json
{
  "properties": {
    "hook_id": {
      "title": "Hook Id",
      "type": "string"
    },
    "executed": {
      "title": "Executed",
      "type": "boolean"
    },
    "status": {
      "default": "",
      "title": "Status",
      "type": "string"
    },
    "reason": {
      "default": "",
      "title": "Reason",
      "type": "string"
    },
    "ts": {
      "default": "",
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "hook_id",
    "executed"
  ],
  "title": "HookRerunResult",
  "type": "object"
}
```

### MemoryListCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `include_expired` | `boolean` | no |

```json
{
  "properties": {
    "type": {
      "const": "memory.list",
      "default": "memory.list",
      "title": "Type",
      "type": "string"
    },
    "include_expired": {
      "default": true,
      "title": "Include Expired",
      "type": "boolean"
    }
  },
  "title": "MemoryListCommand",
  "type": "object"
}
```

### MemoryListResult

| Field | Type | Required |
|---|---|---|
| `memories` | `array` | no |
| `settings` | `object` | no |

```json
{
  "$defs": {
    "MemoryInfo": {
      "properties": {
        "id": {
          "title": "Id",
          "type": "string"
        },
        "name": {
          "title": "Name",
          "type": "string"
        },
        "description": {
          "title": "Description",
          "type": "string"
        },
        "type": {
          "title": "Type",
          "type": "string"
        },
        "body": {
          "title": "Body",
          "type": "string"
        },
        "source_session_id": {
          "title": "Source Session Id",
          "type": "string"
        },
        "source_run_id": {
          "title": "Source Run Id",
          "type": "string"
        },
        "created_at": {
          "title": "Created At",
          "type": "string"
        },
        "updated_at": {
          "title": "Updated At",
          "type": "string"
        },
        "pinned": {
          "default": false,
          "title": "Pinned",
          "type": "boolean"
        },
        "expires_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Expires At"
        },
        "expired": {
          "default": false,
          "title": "Expired",
          "type": "boolean"
        }
      },
      "required": [
        "id",
        "name",
        "description",
        "type",
        "body",
        "source_session_id",
        "source_run_id",
        "created_at",
        "updated_at"
      ],
      "title": "MemoryInfo",
      "type": "object"
    },
    "MemorySettingsInfo": {
      "properties": {
        "auto_save": {
          "default": "prompt",
          "enum": [
            "prompt",
            "off"
          ],
          "title": "Auto Save",
          "type": "string"
        }
      },
      "title": "MemorySettingsInfo",
      "type": "object"
    }
  },
  "properties": {
    "memories": {
      "items": {
        "$ref": "#/$defs/MemoryInfo"
      },
      "title": "Memories",
      "type": "array"
    },
    "settings": {
      "$ref": "#/$defs/MemorySettingsInfo"
    }
  },
  "title": "MemoryListResult",
  "type": "object"
}
```

### MemoryInfo

| Field | Type | Required |
|---|---|---|
| `id` | `string` | yes |
| `name` | `string` | yes |
| `description` | `string` | yes |
| `type` | `string` | yes |
| `body` | `string` | yes |
| `source_session_id` | `string` | yes |
| `source_run_id` | `string` | yes |
| `created_at` | `string` | yes |
| `updated_at` | `string` | yes |
| `pinned` | `boolean` | no |
| `expires_at` | `string | null` | no |
| `expired` | `boolean` | no |

```json
{
  "properties": {
    "id": {
      "title": "Id",
      "type": "string"
    },
    "name": {
      "title": "Name",
      "type": "string"
    },
    "description": {
      "title": "Description",
      "type": "string"
    },
    "type": {
      "title": "Type",
      "type": "string"
    },
    "body": {
      "title": "Body",
      "type": "string"
    },
    "source_session_id": {
      "title": "Source Session Id",
      "type": "string"
    },
    "source_run_id": {
      "title": "Source Run Id",
      "type": "string"
    },
    "created_at": {
      "title": "Created At",
      "type": "string"
    },
    "updated_at": {
      "title": "Updated At",
      "type": "string"
    },
    "pinned": {
      "default": false,
      "title": "Pinned",
      "type": "boolean"
    },
    "expires_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Expires At"
    },
    "expired": {
      "default": false,
      "title": "Expired",
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "name",
    "description",
    "type",
    "body",
    "source_session_id",
    "source_run_id",
    "created_at",
    "updated_at"
  ],
  "title": "MemoryInfo",
  "type": "object"
}
```

### MemoryDeleteCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `memory_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "memory.delete",
      "default": "memory.delete",
      "title": "Type",
      "type": "string"
    },
    "memory_id": {
      "minLength": 1,
      "title": "Memory Id",
      "type": "string"
    }
  },
  "required": [
    "memory_id"
  ],
  "title": "MemoryDeleteCommand",
  "type": "object"
}
```

### MemoryDeleteResult

| Field | Type | Required |
|---|---|---|
| `memory_id` | `string` | yes |
| `deleted` | `boolean` | yes |

```json
{
  "properties": {
    "memory_id": {
      "title": "Memory Id",
      "type": "string"
    },
    "deleted": {
      "title": "Deleted",
      "type": "boolean"
    }
  },
  "required": [
    "memory_id",
    "deleted"
  ],
  "title": "MemoryDeleteResult",
  "type": "object"
}
```

### BackgroundGetCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `job_id` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "background.get",
      "default": "background.get",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "job_id": {
      "default": "",
      "title": "Job Id",
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "BackgroundGetCommand",
  "type": "object"
}
```

### BackgroundGetResult

| Field | Type | Required |
|---|---|---|
| `jobs` | `array` | no |

```json
{
  "$defs": {
    "BackgroundJobInfo": {
      "properties": {
        "id": {
          "title": "Id",
          "type": "string"
        },
        "command": {
          "title": "Command",
          "type": "string"
        },
        "session_id": {
          "title": "Session Id",
          "type": "string"
        },
        "run_id": {
          "title": "Run Id",
          "type": "string"
        },
        "status": {
          "title": "Status",
          "type": "string"
        },
        "output": {
          "title": "Output",
          "type": "string"
        },
        "is_error": {
          "title": "Is Error",
          "type": "boolean"
        },
        "created_at": {
          "title": "Created At",
          "type": "string"
        },
        "finished_at": {
          "default": "",
          "title": "Finished At",
          "type": "string"
        },
        "process_usage": {
          "additionalProperties": true,
          "title": "Process Usage",
          "type": "object"
        },
        "output_bytes": {
          "default": 0,
          "minimum": 0,
          "title": "Output Bytes",
          "type": "integer"
        },
        "output_truncated": {
          "default": false,
          "title": "Output Truncated",
          "type": "boolean"
        },
        "output_artifact": {
          "default": "",
          "title": "Output Artifact",
          "type": "string"
        },
        "output_artifact_size": {
          "default": 0,
          "minimum": 0,
          "title": "Output Artifact Size",
          "type": "integer"
        },
        "output_artifact_error": {
          "default": "",
          "title": "Output Artifact Error",
          "type": "string"
        }
      },
      "required": [
        "id",
        "command",
        "session_id",
        "run_id",
        "status",
        "output",
        "is_error",
        "created_at"
      ],
      "title": "BackgroundJobInfo",
      "type": "object"
    }
  },
  "properties": {
    "jobs": {
      "items": {
        "$ref": "#/$defs/BackgroundJobInfo"
      },
      "title": "Jobs",
      "type": "array"
    }
  },
  "title": "BackgroundGetResult",
  "type": "object"
}
```

### BackgroundJobInfo

| Field | Type | Required |
|---|---|---|
| `id` | `string` | yes |
| `command` | `string` | yes |
| `session_id` | `string` | yes |
| `run_id` | `string` | yes |
| `status` | `string` | yes |
| `output` | `string` | yes |
| `is_error` | `boolean` | yes |
| `created_at` | `string` | yes |
| `finished_at` | `string` | no |
| `process_usage` | `object` | no |
| `output_bytes` | `integer` | no |
| `output_truncated` | `boolean` | no |
| `output_artifact` | `string` | no |
| `output_artifact_size` | `integer` | no |
| `output_artifact_error` | `string` | no |

```json
{
  "properties": {
    "id": {
      "title": "Id",
      "type": "string"
    },
    "command": {
      "title": "Command",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "status": {
      "title": "Status",
      "type": "string"
    },
    "output": {
      "title": "Output",
      "type": "string"
    },
    "is_error": {
      "title": "Is Error",
      "type": "boolean"
    },
    "created_at": {
      "title": "Created At",
      "type": "string"
    },
    "finished_at": {
      "default": "",
      "title": "Finished At",
      "type": "string"
    },
    "process_usage": {
      "additionalProperties": true,
      "title": "Process Usage",
      "type": "object"
    },
    "output_bytes": {
      "default": 0,
      "minimum": 0,
      "title": "Output Bytes",
      "type": "integer"
    },
    "output_truncated": {
      "default": false,
      "title": "Output Truncated",
      "type": "boolean"
    },
    "output_artifact": {
      "default": "",
      "title": "Output Artifact",
      "type": "string"
    },
    "output_artifact_size": {
      "default": 0,
      "minimum": 0,
      "title": "Output Artifact Size",
      "type": "integer"
    },
    "output_artifact_error": {
      "default": "",
      "title": "Output Artifact Error",
      "type": "string"
    }
  },
  "required": [
    "id",
    "command",
    "session_id",
    "run_id",
    "status",
    "output",
    "is_error",
    "created_at"
  ],
  "title": "BackgroundJobInfo",
  "type": "object"
}
```

### BackgroundCancelCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `job_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "background.cancel",
      "default": "background.cancel",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "job_id": {
      "minLength": 1,
      "title": "Job Id",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "job_id"
  ],
  "title": "BackgroundCancelCommand",
  "type": "object"
}
```

### BackgroundCancelResult

| Field | Type | Required |
|---|---|---|
| `job_id` | `string` | yes |
| `cancelled` | `boolean` | yes |

```json
{
  "properties": {
    "job_id": {
      "title": "Job Id",
      "type": "string"
    },
    "cancelled": {
      "title": "Cancelled",
      "type": "boolean"
    }
  },
  "required": [
    "job_id",
    "cancelled"
  ],
  "title": "BackgroundCancelResult",
  "type": "object"
}
```

### WorkerCancelCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `worker_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "worker.cancel",
      "default": "worker.cancel",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "worker_id": {
      "minLength": 1,
      "title": "Worker Id",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "worker_id"
  ],
  "title": "WorkerCancelCommand",
  "type": "object"
}
```

### WorkerCancelResult

| Field | Type | Required |
|---|---|---|
| `worker_id` | `string` | yes |
| `status` | `string` | yes |

```json
{
  "properties": {
    "worker_id": {
      "title": "Worker Id",
      "type": "string"
    },
    "status": {
      "title": "Status",
      "type": "string"
    }
  },
  "required": [
    "worker_id",
    "status"
  ],
  "title": "WorkerCancelResult",
  "type": "object"
}
```

## Server Push

Events pushed from daemon to subscribed clients over the same TCP connection.

### EventPushEnvelope

| Field | Type | Required |
|---|---|---|
| `kind` | `string` | no |
| `event` | `object` | yes |

```json
{
  "properties": {
    "kind": {
      "const": "event",
      "default": "event",
      "title": "Kind",
      "type": "string"
    },
    "event": {
      "additionalProperties": true,
      "title": "Event",
      "type": "object"
    }
  },
  "required": [
    "event"
  ],
  "title": "EventPushEnvelope",
  "type": "object"
}
```

**Example:**

```json
{
  "kind": "event",
  "event": {
    "type": "step.started",
    "run_id": "20260516-100000-abc123",
    "step": 1,
    "ts": "2026-05-16T10:00:00.001Z"
  }
}
```

## IPC Events

Events sent over the IPC socket (daemon -> client).

### CoreStartedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `listen_addr` | `string` | yes |
| `version` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "core.started",
      "default": "core.started",
      "title": "Type",
      "type": "string"
    },
    "listen_addr": {
      "title": "Listen Addr",
      "type": "string"
    },
    "version": {
      "title": "Version",
      "type": "string"
    }
  },
  "required": [
    "listen_addr",
    "version"
  ],
  "title": "CoreStartedEvent",
  "type": "object"
}
```

### RuntimeEventAppendedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `thread_id` | `string` | yes |
| `turn_id` | `string | null` | yes |
| `seq` | `integer` | yes |
| `event_type` | `string` | yes |
| `payload` | `object` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "runtime.event",
      "default": "runtime.event",
      "title": "Type",
      "type": "string"
    },
    "thread_id": {
      "title": "Thread Id",
      "type": "string"
    },
    "turn_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Turn Id"
    },
    "seq": {
      "title": "Seq",
      "type": "integer"
    },
    "event_type": {
      "title": "Event Type",
      "type": "string"
    },
    "payload": {
      "additionalProperties": true,
      "title": "Payload",
      "type": "object"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "thread_id",
    "turn_id",
    "seq",
    "event_type",
    "payload",
    "ts"
  ],
  "title": "RuntimeEventAppendedEvent",
  "type": "object"
}
```

### HookExecutedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `hook_id` | `string` | yes |
| `run_id` | `string` | no |
| `event_name` | `string` | yes |
| `status` | `string` | yes |
| `blocking` | `boolean` | yes |
| `on_failure` | `string` | yes |
| `elapsed_ms` | `integer` | yes |
| `blocked` | `boolean` | yes |
| `reason` | `string` | yes |
| `output_truncated` | `boolean` | yes |
| `exit_code` | `integer | null` | yes |
| `process_usage` | `object` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "hook.executed",
      "default": "hook.executed",
      "title": "Type",
      "type": "string"
    },
    "hook_id": {
      "title": "Hook Id",
      "type": "string"
    },
    "run_id": {
      "default": "",
      "title": "Run Id",
      "type": "string"
    },
    "event_name": {
      "title": "Event Name",
      "type": "string"
    },
    "status": {
      "title": "Status",
      "type": "string"
    },
    "blocking": {
      "title": "Blocking",
      "type": "boolean"
    },
    "on_failure": {
      "title": "On Failure",
      "type": "string"
    },
    "elapsed_ms": {
      "title": "Elapsed Ms",
      "type": "integer"
    },
    "blocked": {
      "title": "Blocked",
      "type": "boolean"
    },
    "reason": {
      "title": "Reason",
      "type": "string"
    },
    "output_truncated": {
      "title": "Output Truncated",
      "type": "boolean"
    },
    "exit_code": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Exit Code"
    },
    "process_usage": {
      "additionalProperties": true,
      "title": "Process Usage",
      "type": "object"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "hook_id",
    "event_name",
    "status",
    "blocking",
    "on_failure",
    "elapsed_ms",
    "blocked",
    "reason",
    "output_truncated",
    "exit_code",
    "ts"
  ],
  "title": "HookExecutedEvent",
  "type": "object"
}
```

### GoalContinueDecisionEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `goal_id` | `string` | yes |
| `session_id` | `string` | yes |
| `run_id` | `string` | yes |
| `should_continue` | `boolean` | yes |
| `reason` | `string` | yes |
| `auto_turns_used` | `integer` | yes |
| `remaining_auto_turns` | `integer` | yes |
| `tokens_used` | `integer` | yes |
| `token_budget` | `integer | null` | no |
| `remaining_tokens` | `integer | null` | no |
| `wall_elapsed_seconds` | `integer` | yes |
| `max_wall_seconds` | `integer` | yes |
| `paused_needs_confirmation` | `boolean` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "goal.continue_decision",
      "default": "goal.continue_decision",
      "title": "Type",
      "type": "string"
    },
    "goal_id": {
      "title": "Goal Id",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "should_continue": {
      "title": "Should Continue",
      "type": "boolean"
    },
    "reason": {
      "title": "Reason",
      "type": "string"
    },
    "auto_turns_used": {
      "minimum": 0,
      "title": "Auto Turns Used",
      "type": "integer"
    },
    "remaining_auto_turns": {
      "minimum": 0,
      "title": "Remaining Auto Turns",
      "type": "integer"
    },
    "tokens_used": {
      "minimum": 0,
      "title": "Tokens Used",
      "type": "integer"
    },
    "token_budget": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Token Budget"
    },
    "remaining_tokens": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Remaining Tokens"
    },
    "wall_elapsed_seconds": {
      "minimum": 0,
      "title": "Wall Elapsed Seconds",
      "type": "integer"
    },
    "max_wall_seconds": {
      "minimum": 1,
      "title": "Max Wall Seconds",
      "type": "integer"
    },
    "paused_needs_confirmation": {
      "title": "Paused Needs Confirmation",
      "type": "boolean"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "goal_id",
    "session_id",
    "run_id",
    "should_continue",
    "reason",
    "auto_turns_used",
    "remaining_auto_turns",
    "tokens_used",
    "wall_elapsed_seconds",
    "max_wall_seconds",
    "paused_needs_confirmation",
    "ts"
  ],
  "title": "GoalContinueDecisionEvent",
  "type": "object"
}
```

## Run Events

Events written to `runs/<run_id>/events.jsonl` and forwarded over IPC to subscribed clients.

### RunStartedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `goal` | `string` | yes |
| `run_kind` | `string` | no |
| `ledger_seq` | `integer | null` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "run.started",
      "default": "run.started",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "goal": {
      "title": "Goal",
      "type": "string"
    },
    "run_kind": {
      "default": "agent",
      "enum": [
        "agent",
        "user_shell"
      ],
      "title": "Run Kind",
      "type": "string"
    },
    "ledger_seq": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Ledger Seq"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "goal",
    "ts"
  ],
  "title": "RunStartedEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "run.started",
  "run_id": "20260516-100000-abc123",
  "goal": "\u603b\u7ed3 README.md",
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### RunFinishedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `status` | `string` | yes |
| `reason` | `string | null` | no |
| `steps` | `integer` | yes |
| `outcome` | `string | null` | no |
| `failure_category` | `string | null` | no |
| `changes` | `array | null` | no |
| `verification` | `array | null` | no |
| `result_summary` | `string | null` | no |
| `ledger_seq` | `integer | null` | no |
| `ts` | `string` | yes |

```json
{
  "$defs": {
    "JsonValue": {}
  },
  "properties": {
    "type": {
      "const": "run.finished",
      "default": "run.finished",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "status": {
      "title": "Status",
      "type": "string"
    },
    "reason": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Reason"
    },
    "steps": {
      "title": "Steps",
      "type": "integer"
    },
    "outcome": {
      "anyOf": [
        {
          "enum": [
            "completed",
            "tool_use",
            "length",
            "incomplete",
            "content_filtered",
            "failed",
            "cancelled",
            "transport_error"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Outcome"
    },
    "failure_category": {
      "anyOf": [
        {
          "enum": [
            "configuration",
            "credential",
            "network",
            "model",
            "tool",
            "index",
            "sandbox",
            "runtime",
            "permission",
            "verification",
            "persistence",
            "internal",
            "user_cancelled"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Failure Category"
    },
    "changes": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/JsonValue"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Changes"
    },
    "verification": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/JsonValue"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Verification"
    },
    "result_summary": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result Summary"
    },
    "ledger_seq": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Ledger Seq"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "status",
    "steps",
    "ts"
  ],
  "title": "RunFinishedEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "run.finished",
  "run_id": "20260516-100000-abc123",
  "status": "success",
  "reason": null,
  "steps": 2,
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### RunSteeredEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `session_id` | `string` | yes |
| `content` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "run.steered",
      "default": "run.steered",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "content": {
      "title": "Content",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "session_id",
    "content",
    "ts"
  ],
  "title": "RunSteeredEvent",
  "type": "object"
}
```

### StepStartedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `step` | `integer` | yes |
| `ledger_seq` | `integer | null` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "step.started",
      "default": "step.started",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "step": {
      "title": "Step",
      "type": "integer"
    },
    "ledger_seq": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Ledger Seq"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "step",
    "ts"
  ],
  "title": "StepStartedEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "step.started",
  "run_id": "20260516-100000-abc123",
  "step": 1,
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### StepFinishedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `step` | `integer` | yes |
| `ledger_seq` | `integer | null` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "step.finished",
      "default": "step.finished",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "step": {
      "title": "Step",
      "type": "integer"
    },
    "ledger_seq": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Ledger Seq"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "step",
    "ts"
  ],
  "title": "StepFinishedEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "step.finished",
  "run_id": "20260516-100000-abc123",
  "step": 1,
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### AgentDecisionEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `step` | `integer` | yes |
| `intent` | `string` | yes |
| `summary` | `string` | yes |
| `tool_names` | `array` | yes |
| `has_visible_text` | `boolean` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "agent.decision",
      "default": "agent.decision",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "step": {
      "title": "Step",
      "type": "integer"
    },
    "intent": {
      "enum": [
        "inspect",
        "plan",
        "change",
        "execute",
        "delegate",
        "respond"
      ],
      "title": "Intent",
      "type": "string"
    },
    "summary": {
      "title": "Summary",
      "type": "string"
    },
    "tool_names": {
      "items": {
        "type": "string"
      },
      "title": "Tool Names",
      "type": "array"
    },
    "has_visible_text": {
      "title": "Has Visible Text",
      "type": "boolean"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "step",
    "intent",
    "summary",
    "tool_names",
    "has_visible_text",
    "ts"
  ],
  "title": "AgentDecisionEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "agent.decision",
  "run_id": "20260516-100000-abc123",
  "step": 1,
  "intent": "inspect",
  "summary": "I will inspect the relevant files first.",
  "tool_names": [
    "read_file"
  ],
  "has_visible_text": true,
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### AgentStuckEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `step` | `integer` | yes |
| `tool_name` | `string` | yes |
| `signature` | `string` | yes |
| `repeat_count` | `integer` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "agent.stuck",
      "default": "agent.stuck",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "step": {
      "title": "Step",
      "type": "integer"
    },
    "tool_name": {
      "title": "Tool Name",
      "type": "string"
    },
    "signature": {
      "title": "Signature",
      "type": "string"
    },
    "repeat_count": {
      "title": "Repeat Count",
      "type": "integer"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "step",
    "tool_name",
    "signature",
    "repeat_count",
    "ts"
  ],
  "title": "AgentStuckEvent",
  "type": "object"
}
```

### ToolCallStartedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `tool_use_id` | `string` | yes |
| `tool_name` | `string` | yes |
| `operation_id` | `string` | no |
| `params` | `object` | yes |
| `step` | `integer` | no |
| `ledger_seq` | `integer | null` | no |
| `presentation` | `object | null` | no |
| `program_id` | `string` | no |
| `parent_tool_call_id` | `string` | no |
| `node_id` | `string` | no |
| `commit_order` | `integer` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "tool.call_started",
      "default": "tool.call_started",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "tool_use_id": {
      "title": "Tool Use Id",
      "type": "string"
    },
    "tool_name": {
      "title": "Tool Name",
      "type": "string"
    },
    "operation_id": {
      "default": "",
      "title": "Operation Id",
      "type": "string"
    },
    "params": {
      "additionalProperties": true,
      "title": "Params",
      "type": "object"
    },
    "step": {
      "default": 0,
      "title": "Step",
      "type": "integer"
    },
    "ledger_seq": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Ledger Seq"
    },
    "presentation": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Presentation"
    },
    "program_id": {
      "default": "",
      "title": "Program Id",
      "type": "string"
    },
    "parent_tool_call_id": {
      "default": "",
      "title": "Parent Tool Call Id",
      "type": "string"
    },
    "node_id": {
      "default": "",
      "title": "Node Id",
      "type": "string"
    },
    "commit_order": {
      "default": 0,
      "title": "Commit Order",
      "type": "integer"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "tool_use_id",
    "tool_name",
    "params",
    "ts"
  ],
  "title": "ToolCallStartedEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "tool.call_started",
  "run_id": "20260516-100000-abc123",
  "tool_use_id": "toolu_01",
  "tool_name": "read_file",
  "params": {
    "path": "README.md"
  },
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### ToolCallFinishedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `tool_use_id` | `string` | yes |
| `tool_name` | `string` | yes |
| `operation_id` | `string` | no |
| `elapsed_ms` | `integer` | yes |
| `output` | `string` | no |
| `process_usage` | `object` | no |
| `step` | `integer` | no |
| `ledger_seq` | `integer | null` | no |
| `presentation` | `object | null` | no |
| `sandbox_enforcement` | `string` | no |
| `failure_category` | `string | null` | no |
| `program_id` | `string` | no |
| `parent_tool_call_id` | `string` | no |
| `node_id` | `string` | no |
| `commit_order` | `integer` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "tool.call_finished",
      "default": "tool.call_finished",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "tool_use_id": {
      "title": "Tool Use Id",
      "type": "string"
    },
    "tool_name": {
      "title": "Tool Name",
      "type": "string"
    },
    "operation_id": {
      "default": "",
      "title": "Operation Id",
      "type": "string"
    },
    "elapsed_ms": {
      "title": "Elapsed Ms",
      "type": "integer"
    },
    "output": {
      "default": "",
      "title": "Output",
      "type": "string"
    },
    "process_usage": {
      "additionalProperties": true,
      "title": "Process Usage",
      "type": "object"
    },
    "step": {
      "default": 0,
      "title": "Step",
      "type": "integer"
    },
    "ledger_seq": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Ledger Seq"
    },
    "presentation": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Presentation"
    },
    "sandbox_enforcement": {
      "default": "unavailable",
      "enum": [
        "full",
        "partial",
        "unavailable"
      ],
      "title": "Sandbox Enforcement",
      "type": "string"
    },
    "failure_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Failure Category"
    },
    "program_id": {
      "default": "",
      "title": "Program Id",
      "type": "string"
    },
    "parent_tool_call_id": {
      "default": "",
      "title": "Parent Tool Call Id",
      "type": "string"
    },
    "node_id": {
      "default": "",
      "title": "Node Id",
      "type": "string"
    },
    "commit_order": {
      "default": 0,
      "title": "Commit Order",
      "type": "integer"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "tool_use_id",
    "tool_name",
    "elapsed_ms",
    "ts"
  ],
  "title": "ToolCallFinishedEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "tool.call_finished",
  "run_id": "20260516-100000-abc123",
  "tool_use_id": "toolu_01",
  "tool_name": "read_file",
  "elapsed_ms": 3,
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### ToolCallFailedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `tool_use_id` | `string` | yes |
| `tool_name` | `string` | yes |
| `operation_id` | `string` | no |
| `error_class` | `string` | yes |
| `error_message` | `string` | yes |
| `elapsed_ms` | `integer` | yes |
| `attempt` | `integer` | no |
| `terminal` | `boolean` | no |
| `process_usage` | `object` | no |
| `step` | `integer` | no |
| `ledger_seq` | `integer | null` | no |
| `presentation` | `object | null` | no |
| `sandbox_enforcement` | `string` | no |
| `failure_category` | `string | null` | no |
| `program_id` | `string` | no |
| `parent_tool_call_id` | `string` | no |
| `node_id` | `string` | no |
| `commit_order` | `integer` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "tool.call_failed",
      "default": "tool.call_failed",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "tool_use_id": {
      "title": "Tool Use Id",
      "type": "string"
    },
    "tool_name": {
      "title": "Tool Name",
      "type": "string"
    },
    "operation_id": {
      "default": "",
      "title": "Operation Id",
      "type": "string"
    },
    "error_class": {
      "title": "Error Class",
      "type": "string"
    },
    "error_message": {
      "title": "Error Message",
      "type": "string"
    },
    "elapsed_ms": {
      "title": "Elapsed Ms",
      "type": "integer"
    },
    "attempt": {
      "default": 1,
      "title": "Attempt",
      "type": "integer"
    },
    "terminal": {
      "default": true,
      "title": "Terminal",
      "type": "boolean"
    },
    "process_usage": {
      "additionalProperties": true,
      "title": "Process Usage",
      "type": "object"
    },
    "step": {
      "default": 0,
      "title": "Step",
      "type": "integer"
    },
    "ledger_seq": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Ledger Seq"
    },
    "presentation": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Presentation"
    },
    "sandbox_enforcement": {
      "default": "unavailable",
      "enum": [
        "full",
        "partial",
        "unavailable"
      ],
      "title": "Sandbox Enforcement",
      "type": "string"
    },
    "failure_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Failure Category"
    },
    "program_id": {
      "default": "",
      "title": "Program Id",
      "type": "string"
    },
    "parent_tool_call_id": {
      "default": "",
      "title": "Parent Tool Call Id",
      "type": "string"
    },
    "node_id": {
      "default": "",
      "title": "Node Id",
      "type": "string"
    },
    "commit_order": {
      "default": 0,
      "title": "Commit Order",
      "type": "integer"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "tool_use_id",
    "tool_name",
    "error_class",
    "error_message",
    "elapsed_ms",
    "ts"
  ],
  "title": "ToolCallFailedEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "tool.call_failed",
  "run_id": "20260516-100000-abc123",
  "tool_use_id": "toolu_02",
  "tool_name": "read_file",
  "error_class": "runtime_error",
  "error_message": "file not found",
  "elapsed_ms": 1,
  "attempt": 1,
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### LlmModelSelectedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `model` | `string` | yes |
| `strategy` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "llm.model_selected",
      "default": "llm.model_selected",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "model": {
      "title": "Model",
      "type": "string"
    },
    "strategy": {
      "title": "Strategy",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "model",
    "strategy",
    "ts"
  ],
  "title": "LlmModelSelectedEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "llm.model_selected",
  "run_id": "20260516-100000-abc123",
  "model": "claude-sonnet-4-6",
  "strategy": "static",
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### LlmRouteSelectedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `route_id` | `string` | yes |
| `wire_format` | `string` | yes |
| `base_url_origin` | `string` | yes |
| `model` | `string` | yes |
| `credential_source` | `string` | yes |
| `strategy` | `string` | no |
| `candidates` | `array` | no |
| `reason` | `string` | no |
| `step` | `integer` | no |
| `accumulated_cost_usd` | `number | null` | no |
| `cost_budget_usd` | `number | null` | no |
| `temperature` | `number | null` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "llm.route_selected",
      "default": "llm.route_selected",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "route_id": {
      "title": "Route Id",
      "type": "string"
    },
    "wire_format": {
      "title": "Wire Format",
      "type": "string"
    },
    "base_url_origin": {
      "title": "Base Url Origin",
      "type": "string"
    },
    "model": {
      "title": "Model",
      "type": "string"
    },
    "credential_source": {
      "enum": [
        "keyring",
        "file",
        "env",
        "extension",
        "missing"
      ],
      "title": "Credential Source",
      "type": "string"
    },
    "strategy": {
      "default": "static",
      "title": "Strategy",
      "type": "string"
    },
    "candidates": {
      "items": {
        "type": "string"
      },
      "title": "Candidates",
      "type": "array"
    },
    "reason": {
      "default": "active_route",
      "title": "Reason",
      "type": "string"
    },
    "step": {
      "default": 0,
      "title": "Step",
      "type": "integer"
    },
    "accumulated_cost_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Accumulated Cost Usd"
    },
    "cost_budget_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cost Budget Usd"
    },
    "temperature": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Temperature"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "route_id",
    "wire_format",
    "base_url_origin",
    "model",
    "credential_source",
    "ts"
  ],
  "title": "LlmRouteSelectedEvent",
  "type": "object"
}
```

### LlmTokenEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `token` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "llm.token",
      "default": "llm.token",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "token": {
      "title": "Token",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "token",
    "ts"
  ],
  "title": "LlmTokenEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "llm.token",
  "run_id": "20260516-100000-abc123",
  "token": "The ",
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### LlmReasoningEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `content` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "llm.reasoning",
      "default": "llm.reasoning",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "content": {
      "title": "Content",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "content",
    "ts"
  ],
  "title": "LlmReasoningEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "llm.reasoning",
  "run_id": "20260516-100000-abc123",
  "content": "I should inspect the project first.",
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### LlmUsageEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `input_tokens` | `integer` | yes |
| `output_tokens` | `integer` | yes |
| `cache_read_input_tokens` | `integer` | yes |
| `cache_creation_input_tokens` | `integer` | yes |
| `context_pct` | `number` | no |
| `purpose` | `string` | no |
| `model` | `string` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "llm.usage",
      "default": "llm.usage",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "input_tokens": {
      "title": "Input Tokens",
      "type": "integer"
    },
    "output_tokens": {
      "title": "Output Tokens",
      "type": "integer"
    },
    "cache_read_input_tokens": {
      "title": "Cache Read Input Tokens",
      "type": "integer"
    },
    "cache_creation_input_tokens": {
      "title": "Cache Creation Input Tokens",
      "type": "integer"
    },
    "context_pct": {
      "default": 0.0,
      "title": "Context Pct",
      "type": "number"
    },
    "purpose": {
      "default": "response",
      "enum": [
        "response",
        "summary"
      ],
      "title": "Purpose",
      "type": "string"
    },
    "model": {
      "default": "",
      "title": "Model",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "input_tokens",
    "output_tokens",
    "cache_read_input_tokens",
    "cache_creation_input_tokens",
    "ts"
  ],
  "title": "LlmUsageEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "llm.usage",
  "run_id": "20260516-100000-abc123",
  "input_tokens": 512,
  "output_tokens": 48,
  "cache_read_input_tokens": 490,
  "cache_creation_input_tokens": 0,
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### LlmRequestPreparedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `step` | `integer` | yes |
| `ledger_seq` | `integer | null` | no |
| `request_snapshot_digest` | `string` | yes |
| `preset_id` | `string` | no |
| `preset_digest` | `string` | no |
| `route_id` | `string` | no |
| `model` | `string` | no |
| `wire_format` | `string` | no |
| `execution_contract_digest` | `string` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "llm.request_prepared",
      "default": "llm.request_prepared",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "step": {
      "title": "Step",
      "type": "integer"
    },
    "ledger_seq": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Ledger Seq"
    },
    "request_snapshot_digest": {
      "pattern": "^[0-9a-f]{64}$",
      "title": "Request Snapshot Digest",
      "type": "string"
    },
    "preset_id": {
      "default": "standard",
      "title": "Preset Id",
      "type": "string"
    },
    "preset_digest": {
      "default": "",
      "pattern": "^(?:|[0-9a-f]{64})$",
      "title": "Preset Digest",
      "type": "string"
    },
    "route_id": {
      "default": "",
      "title": "Route Id",
      "type": "string"
    },
    "model": {
      "default": "",
      "title": "Model",
      "type": "string"
    },
    "wire_format": {
      "default": "",
      "title": "Wire Format",
      "type": "string"
    },
    "execution_contract_digest": {
      "default": "",
      "title": "Execution Contract Digest",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "step",
    "request_snapshot_digest",
    "ts"
  ],
  "title": "LlmRequestPreparedEvent",
  "type": "object"
}
```

### LlmRetryEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `step` | `integer` | yes |
| `kind` | `string` | yes |
| `attempt` | `integer` | yes |
| `reason` | `string` | yes |
| `delay_ms` | `integer` | no |
| `max_retries` | `integer` | no |
| `failure_code` | `string` | no |
| `request_snapshot_digest` | `string` | no |
| `ledger_seq` | `integer | null` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "llm.retry",
      "default": "llm.retry",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "step": {
      "title": "Step",
      "type": "integer"
    },
    "kind": {
      "enum": [
        "transient",
        "no_content"
      ],
      "title": "Kind",
      "type": "string"
    },
    "attempt": {
      "title": "Attempt",
      "type": "integer"
    },
    "reason": {
      "title": "Reason",
      "type": "string"
    },
    "delay_ms": {
      "default": 0,
      "title": "Delay Ms",
      "type": "integer"
    },
    "max_retries": {
      "default": 5,
      "title": "Max Retries",
      "type": "integer"
    },
    "failure_code": {
      "default": "",
      "title": "Failure Code",
      "type": "string"
    },
    "request_snapshot_digest": {
      "default": "",
      "title": "Request Snapshot Digest",
      "type": "string"
    },
    "ledger_seq": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Ledger Seq"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "step",
    "kind",
    "attempt",
    "reason",
    "ts"
  ],
  "title": "LlmRetryEvent",
  "type": "object"
}
```

### ContextPrefixFingerprintEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `step` | `integer` | yes |
| `digest` | `string` | yes |
| `source_hashes` | `object` | yes |
| `changed_sources` | `array` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "context.prefix_fingerprint",
      "default": "context.prefix_fingerprint",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "step": {
      "title": "Step",
      "type": "integer"
    },
    "digest": {
      "title": "Digest",
      "type": "string"
    },
    "source_hashes": {
      "additionalProperties": {
        "type": "string"
      },
      "title": "Source Hashes",
      "type": "object"
    },
    "changed_sources": {
      "items": {
        "type": "string"
      },
      "title": "Changed Sources",
      "type": "array"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "step",
    "digest",
    "source_hashes",
    "changed_sources",
    "ts"
  ],
  "title": "ContextPrefixFingerprintEvent",
  "type": "object"
}
```

### ContextBudgetEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `step` | `integer` | yes |
| `message_tokens` | `integer` | yes |
| `system_tokens` | `integer` | yes |
| `tool_schema_tokens` | `integer` | yes |
| `tool_count` | `integer` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "context.budget",
      "default": "context.budget",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "step": {
      "title": "Step",
      "type": "integer"
    },
    "message_tokens": {
      "title": "Message Tokens",
      "type": "integer"
    },
    "system_tokens": {
      "title": "System Tokens",
      "type": "integer"
    },
    "tool_schema_tokens": {
      "title": "Tool Schema Tokens",
      "type": "integer"
    },
    "tool_count": {
      "title": "Tool Count",
      "type": "integer"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "step",
    "message_tokens",
    "system_tokens",
    "tool_schema_tokens",
    "tool_count",
    "ts"
  ],
  "title": "ContextBudgetEvent",
  "type": "object"
}
```

### ContextWorkingSetEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `step` | `integer` | yes |
| `paths` | `array` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "context.working_set",
      "default": "context.working_set",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "step": {
      "title": "Step",
      "type": "integer"
    },
    "paths": {
      "items": {
        "type": "string"
      },
      "title": "Paths",
      "type": "array"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "step",
    "paths",
    "ts"
  ],
  "title": "ContextWorkingSetEvent",
  "type": "object"
}
```

### LspDiagnosticsEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `step` | `integer` | yes |
| `status` | `string` | yes |
| `tool` | `string` | yes |
| `paths` | `array` | yes |
| `diagnostic_count` | `integer` | yes |
| `duration_ms` | `integer` | no |
| `truncated` | `boolean` | yes |
| `error` | `string` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "lsp.diagnostics",
      "default": "lsp.diagnostics",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "step": {
      "title": "Step",
      "type": "integer"
    },
    "status": {
      "enum": [
        "ok",
        "unavailable",
        "failed",
        "timeout",
        "truncated"
      ],
      "title": "Status",
      "type": "string"
    },
    "tool": {
      "title": "Tool",
      "type": "string"
    },
    "paths": {
      "items": {
        "type": "string"
      },
      "title": "Paths",
      "type": "array"
    },
    "diagnostic_count": {
      "title": "Diagnostic Count",
      "type": "integer"
    },
    "duration_ms": {
      "default": 0,
      "minimum": 0,
      "title": "Duration Ms",
      "type": "integer"
    },
    "truncated": {
      "title": "Truncated",
      "type": "boolean"
    },
    "error": {
      "default": "",
      "title": "Error",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "step",
    "status",
    "tool",
    "paths",
    "diagnostic_count",
    "truncated",
    "ts"
  ],
  "title": "LspDiagnosticsEvent",
  "type": "object"
}
```

### LogLineEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `level` | `string` | yes |
| `source` | `string` | yes |
| `message` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "log.line",
      "default": "log.line",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "level": {
      "title": "Level",
      "type": "string"
    },
    "source": {
      "title": "Source",
      "type": "string"
    },
    "message": {
      "title": "Message",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "level",
    "source",
    "message",
    "ts"
  ],
  "title": "LogLineEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "log.line",
  "run_id": "20260516-100000-abc123",
  "level": "INFO",
  "source": "code_rook.core.loop",
  "message": "step 1 started",
  "ts": "2026-05-16T10:00:00.001Z"
}
```

## Session Events

### SessionCreatedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `mode` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.created",
      "default": "session.created",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "mode": {
      "title": "Mode",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "mode",
    "ts"
  ],
  "title": "SessionCreatedEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "session.created",
  "session_id": "sess-abc123def456",
  "mode": "chat",
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### SessionMessageReceivedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `content` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.message_received",
      "default": "session.message_received",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "content": {
      "title": "Content",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "content",
    "ts"
  ],
  "title": "SessionMessageReceivedEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "session.message_received",
  "session_id": "sess-abc123def456",
  "content": "\u603b\u7ed3 README.md",
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### SessionWaitingForInputEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `last_run_id` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.waiting_for_input",
      "default": "session.waiting_for_input",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "last_run_id": {
      "title": "Last Run Id",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "last_run_id",
    "ts"
  ],
  "title": "SessionWaitingForInputEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "session.waiting_for_input",
  "session_id": "sess-abc123def456",
  "last_run_id": "20260516-100000-abc123",
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### PlanReadyEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `run_id` | `string` | yes |
| `request` | `string` | yes |
| `plan` | `string` | yes |
| `plan_ticket` | `string` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "plan.ready",
      "default": "plan.ready",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "request": {
      "title": "Request",
      "type": "string"
    },
    "plan": {
      "title": "Plan",
      "type": "string"
    },
    "plan_ticket": {
      "default": "",
      "title": "Plan Ticket",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "run_id",
    "request",
    "plan",
    "ts"
  ],
  "title": "PlanReadyEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "plan.ready",
  "session_id": "sess-abc123def456",
  "run_id": "20260516-100000-abc123",
  "request": "\u89c4\u5212 README \u91cd\u6784",
  "plan": "1. Inspect\n2. Edit\n3. Test",
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### PlanResolvedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `run_id` | `string` | yes |
| `decision` | `string` | yes |
| `revision` | `string` | no |
| `plan_ticket` | `string` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "plan.resolved",
      "default": "plan.resolved",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "decision": {
      "enum": [
        "approve",
        "revise",
        "cancel"
      ],
      "title": "Decision",
      "type": "string"
    },
    "revision": {
      "default": "",
      "title": "Revision",
      "type": "string"
    },
    "plan_ticket": {
      "default": "",
      "title": "Plan Ticket",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "run_id",
    "decision",
    "ts"
  ],
  "title": "PlanResolvedEvent",
  "type": "object"
}
```

### PlanUpdatedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `explanation` | `string` | no |
| `plan` | `array` | yes |
| `plan_ticket` | `string` | no |
| `ts` | `string` | yes |

```json
{
  "$defs": {
    "PlanStepState": {
      "properties": {
        "step": {
          "title": "Step",
          "type": "string"
        },
        "status": {
          "enum": [
            "pending",
            "in_progress",
            "completed"
          ],
          "title": "Status",
          "type": "string"
        }
      },
      "required": [
        "step",
        "status"
      ],
      "title": "PlanStepState",
      "type": "object"
    }
  },
  "properties": {
    "type": {
      "const": "plan.updated",
      "default": "plan.updated",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "explanation": {
      "default": "",
      "title": "Explanation",
      "type": "string"
    },
    "plan": {
      "items": {
        "$ref": "#/$defs/PlanStepState"
      },
      "title": "Plan",
      "type": "array"
    },
    "plan_ticket": {
      "default": "",
      "title": "Plan Ticket",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "plan",
    "ts"
  ],
  "title": "PlanUpdatedEvent",
  "type": "object"
}
```

### UserQuestionAskedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `question_id` | `string` | yes |
| `run_id` | `string` | yes |
| `session_id` | `string` | yes |
| `question` | `string` | yes |
| `header` | `string` | yes |
| `options` | `array` | yes |
| `multi_select` | `boolean` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "user_question.asked",
      "default": "user_question.asked",
      "title": "Type",
      "type": "string"
    },
    "question_id": {
      "title": "Question Id",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "question": {
      "title": "Question",
      "type": "string"
    },
    "header": {
      "title": "Header",
      "type": "string"
    },
    "options": {
      "items": {
        "type": "string"
      },
      "title": "Options",
      "type": "array"
    },
    "multi_select": {
      "default": false,
      "title": "Multi Select",
      "type": "boolean"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "question_id",
    "run_id",
    "session_id",
    "question",
    "header",
    "options",
    "ts"
  ],
  "title": "UserQuestionAskedEvent",
  "type": "object"
}
```

### SessionResumedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.resumed",
      "default": "session.resumed",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "ts"
  ],
  "title": "SessionResumedEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "session.resumed",
  "session_id": "sess-abc123def456",
  "ts": "2026-05-16T10:00:00.001Z"
}
```

### SessionRenamedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `title` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.renamed",
      "default": "session.renamed",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "title": {
      "title": "Title",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "title",
    "ts"
  ],
  "title": "SessionRenamedEvent",
  "type": "object"
}
```

### SessionForkedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `source_session_id` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.forked",
      "default": "session.forked",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "source_session_id": {
      "title": "Source Session Id",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "source_session_id",
    "ts"
  ],
  "title": "SessionForkedEvent",
  "type": "object"
}
```

### SessionDeletedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.deleted",
      "default": "session.deleted",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "ts"
  ],
  "title": "SessionDeletedEvent",
  "type": "object"
}
```

### SessionClosedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.closed",
      "default": "session.closed",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "ts"
  ],
  "title": "SessionClosedEvent",
  "type": "object"
}
```

**Example:**

```json
{
  "type": "session.closed",
  "session_id": "sess-abc123def456",
  "ts": "2026-05-16T10:00:00.001Z"
}
```

## Error Codes

| Code | Name | Meaning |
|------|------|---------|
| -32700 | Parse Error | Invalid JSON received |
| -32600 | Invalid Request | Missing required JSON-RPC fields |
| -32601 | Method Not Found | Unknown method |
| -32602 | Invalid Params | Parameter validation failed |
| -32603 | Internal Error | Handler raised an unhandled exception |
| -32001 | Authentication Required | First frame was not authentication |
| -32002 | Authentication Failed | Credential was malformed or incorrect |
| -32010 | Session Not Found | Requested session does not exist |
| -32011 | Session Closed | Session cannot accept a message |
| -32012 | Session Busy | Session already has an active run |
| -32013 | Session Not Resumable | Session mode cannot be resumed |
| -32014 | Run Not Active | Run cannot be cancelled |

## Complete Discriminated Union Members

The following command and event models are discovered directly from the typed discriminated unions and therefore cannot drift from the wire contract.

### AgentMessageEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `session_id` | `string | null` | no |
| `message_id` | `string` | yes |
| `phase` | `string` | yes |
| `role` | `string` | yes |
| `custom_type` | `string | null` | no |
| `content` | `array` | yes |
| `stop_reason` | `string | null` | no |
| `backend` | `string` | no |
| `step` | `integer` | no |
| `ledger_seq` | `integer | null` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "agent.message",
      "default": "agent.message",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "session_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Session Id"
    },
    "message_id": {
      "title": "Message Id",
      "type": "string"
    },
    "phase": {
      "enum": [
        "start",
        "update",
        "end"
      ],
      "title": "Phase",
      "type": "string"
    },
    "role": {
      "title": "Role",
      "type": "string"
    },
    "custom_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Custom Type"
    },
    "content": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Content",
      "type": "array"
    },
    "stop_reason": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Stop Reason"
    },
    "backend": {
      "default": "python",
      "enum": [
        "pi",
        "python"
      ],
      "title": "Backend",
      "type": "string"
    },
    "step": {
      "default": 0,
      "title": "Step",
      "type": "integer"
    },
    "ledger_seq": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Ledger Seq"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "message_id",
    "phase",
    "role",
    "content",
    "ts"
  ],
  "title": "AgentMessageEvent",
  "type": "object"
}
```

### AgentRepeatNoticeEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `step` | `integer` | yes |
| `tool_name` | `string` | yes |
| `signature` | `string` | yes |
| `repeat_count` | `integer` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "agent.repeat_notice",
      "default": "agent.repeat_notice",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "step": {
      "title": "Step",
      "type": "integer"
    },
    "tool_name": {
      "title": "Tool Name",
      "type": "string"
    },
    "signature": {
      "title": "Signature",
      "type": "string"
    },
    "repeat_count": {
      "title": "Repeat Count",
      "type": "integer"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "step",
    "tool_name",
    "signature",
    "repeat_count",
    "ts"
  ],
  "title": "AgentRepeatNoticeEvent",
  "type": "object"
}
```

### AgentSettingsGetCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "agent.settings.get",
      "default": "agent.settings.get",
      "title": "Type",
      "type": "string"
    }
  },
  "title": "AgentSettingsGetCommand",
  "type": "object"
}
```

### AgentSettingsSetCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `steering_mode` | `string` | yes |
| `follow_up_mode` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "agent.settings.set",
      "default": "agent.settings.set",
      "title": "Type",
      "type": "string"
    },
    "steering_mode": {
      "enum": [
        "one-at-a-time",
        "all"
      ],
      "title": "Steering Mode",
      "type": "string"
    },
    "follow_up_mode": {
      "enum": [
        "one-at-a-time",
        "all"
      ],
      "title": "Follow Up Mode",
      "type": "string"
    }
  },
  "required": [
    "steering_mode",
    "follow_up_mode"
  ],
  "title": "AgentSettingsSetCommand",
  "type": "object"
}
```

### ArtifactGcCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `days` | `integer` | no |
| `confirmed` | `boolean` | no |

```json
{
  "properties": {
    "type": {
      "const": "artifact.gc",
      "default": "artifact.gc",
      "title": "Type",
      "type": "string"
    },
    "days": {
      "default": 30,
      "maximum": 3650,
      "minimum": 0,
      "title": "Days",
      "type": "integer"
    },
    "confirmed": {
      "default": false,
      "title": "Confirmed",
      "type": "boolean"
    }
  },
  "title": "ArtifactGcCommand",
  "type": "object"
}
```

### ArtifactListCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `days` | `integer` | no |

```json
{
  "properties": {
    "type": {
      "const": "artifact.list",
      "default": "artifact.list",
      "title": "Type",
      "type": "string"
    },
    "days": {
      "default": 30,
      "maximum": 3650,
      "minimum": 0,
      "title": "Days",
      "type": "integer"
    }
  },
  "title": "ArtifactListCommand",
  "type": "object"
}
```

### AuditDegradedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `source` | `string` | yes |
| `diagnostic_id` | `string` | yes |
| `error_type` | `string` | yes |
| `message` | `string` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "audit.degraded",
      "default": "audit.degraded",
      "title": "Type",
      "type": "string"
    },
    "source": {
      "title": "Source",
      "type": "string"
    },
    "diagnostic_id": {
      "title": "Diagnostic Id",
      "type": "string"
    },
    "error_type": {
      "title": "Error Type",
      "type": "string"
    },
    "message": {
      "default": "Audit persistence is degraded; mutating tools are paused until repair and restart.",
      "title": "Message",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "source",
    "diagnostic_id",
    "error_type",
    "ts"
  ],
  "title": "AuditDegradedEvent",
  "type": "object"
}
```

### BackgroundJobFinishedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `job_id` | `string` | yes |
| `run_id` | `string` | yes |
| `session_id` | `string` | yes |
| `status` | `string` | yes |
| `output_preview` | `string` | yes |
| `process_usage` | `object` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "background.finished",
      "default": "background.finished",
      "title": "Type",
      "type": "string"
    },
    "job_id": {
      "title": "Job Id",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "status": {
      "title": "Status",
      "type": "string"
    },
    "output_preview": {
      "title": "Output Preview",
      "type": "string"
    },
    "process_usage": {
      "additionalProperties": true,
      "title": "Process Usage",
      "type": "object"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "job_id",
    "run_id",
    "session_id",
    "status",
    "output_preview",
    "ts"
  ],
  "title": "BackgroundJobFinishedEvent",
  "type": "object"
}
```

### BackgroundJobStartedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `job_id` | `string` | yes |
| `run_id` | `string` | yes |
| `session_id` | `string` | yes |
| `command` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "background.started",
      "default": "background.started",
      "title": "Type",
      "type": "string"
    },
    "job_id": {
      "title": "Job Id",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "command": {
      "title": "Command",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "job_id",
    "run_id",
    "session_id",
    "command",
    "ts"
  ],
  "title": "BackgroundJobStartedEvent",
  "type": "object"
}
```

### ContextCompactedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `run_id` | `string` | yes |
| `original_tokens` | `integer` | yes |
| `summary_tokens` | `integer` | yes |
| `retained_tokens` | `integer` | no |
| `retained_messages` | `integer` | no |
| `compacted_tokens` | `integer` | no |
| `quality_score` | `number` | no |
| `trigger` | `string` | no |
| `summary_path` | `string` | no |
| `strategy` | `string` | no |
| `pinned_fact_count` | `integer` | no |
| `pinned_fact_retained` | `integer` | no |
| `deduplicated_reads` | `integer` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "context.compacted",
      "default": "context.compacted",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "original_tokens": {
      "title": "Original Tokens",
      "type": "integer"
    },
    "summary_tokens": {
      "title": "Summary Tokens",
      "type": "integer"
    },
    "retained_tokens": {
      "default": 0,
      "title": "Retained Tokens",
      "type": "integer"
    },
    "retained_messages": {
      "default": 0,
      "title": "Retained Messages",
      "type": "integer"
    },
    "compacted_tokens": {
      "default": 0,
      "title": "Compacted Tokens",
      "type": "integer"
    },
    "quality_score": {
      "default": 1.0,
      "title": "Quality Score",
      "type": "number"
    },
    "trigger": {
      "default": "auto",
      "title": "Trigger",
      "type": "string"
    },
    "summary_path": {
      "default": "",
      "title": "Summary Path",
      "type": "string"
    },
    "strategy": {
      "default": "structured",
      "title": "Strategy",
      "type": "string"
    },
    "pinned_fact_count": {
      "default": 0,
      "minimum": 0,
      "title": "Pinned Fact Count",
      "type": "integer"
    },
    "pinned_fact_retained": {
      "default": 0,
      "minimum": 0,
      "title": "Pinned Fact Retained",
      "type": "integer"
    },
    "deduplicated_reads": {
      "default": 0,
      "minimum": 0,
      "title": "Deduplicated Reads",
      "type": "integer"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "run_id",
    "original_tokens",
    "summary_tokens",
    "ts"
  ],
  "title": "ContextCompactedEvent",
  "type": "object"
}
```

### ContextCompactionCommittedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `run_id` | `string` | yes |
| `shadowed_event_seqs` | `array` | yes |
| `replacement_event_seqs` | `array` | yes |
| `original_tokens` | `integer` | yes |
| `compacted_tokens` | `integer` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "context.compaction.committed",
      "default": "context.compaction.committed",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "shadowed_event_seqs": {
      "items": {
        "type": "integer"
      },
      "title": "Shadowed Event Seqs",
      "type": "array"
    },
    "replacement_event_seqs": {
      "items": {
        "type": "integer"
      },
      "title": "Replacement Event Seqs",
      "type": "array"
    },
    "original_tokens": {
      "minimum": 0,
      "title": "Original Tokens",
      "type": "integer"
    },
    "compacted_tokens": {
      "minimum": 0,
      "title": "Compacted Tokens",
      "type": "integer"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "run_id",
    "shadowed_event_seqs",
    "replacement_event_seqs",
    "original_tokens",
    "compacted_tokens",
    "ts"
  ],
  "title": "ContextCompactionCommittedEvent",
  "type": "object"
}
```

### ContextCompactionStartedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `run_id` | `string` | yes |
| `shadow_start_seq` | `integer` | yes |
| `shadow_end_seq` | `integer` | yes |
| `trigger` | `string` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "context.compaction.started",
      "default": "context.compaction.started",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "shadow_start_seq": {
      "minimum": 1,
      "title": "Shadow Start Seq",
      "type": "integer"
    },
    "shadow_end_seq": {
      "minimum": 1,
      "title": "Shadow End Seq",
      "type": "integer"
    },
    "trigger": {
      "default": "auto",
      "title": "Trigger",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "run_id",
    "shadow_start_seq",
    "shadow_end_seq",
    "ts"
  ],
  "title": "ContextCompactionStartedEvent",
  "type": "object"
}
```

### ContextCompactionSummaryEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `run_id` | `string` | yes |
| `summary` | `string` | yes |
| `source_event_seqs` | `array` | yes |
| `pinned_fact_count` | `integer` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "context.compaction.summary",
      "default": "context.compaction.summary",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "summary": {
      "title": "Summary",
      "type": "string"
    },
    "source_event_seqs": {
      "items": {
        "type": "integer"
      },
      "title": "Source Event Seqs",
      "type": "array"
    },
    "pinned_fact_count": {
      "default": 0,
      "minimum": 0,
      "title": "Pinned Fact Count",
      "type": "integer"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "run_id",
    "summary",
    "source_event_seqs",
    "ts"
  ],
  "title": "ContextCompactionSummaryEvent",
  "type": "object"
}
```

### ContextRepositoryEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `repository_hash` | `string` | yes |
| `budget_chars` | `integer` | yes |
| `used_chars` | `integer` | yes |
| `paths` | `array` | yes |
| `selection_reasons` | `array` | yes |
| `cache_hits` | `integer` | yes |
| `parsed_files` | `integer` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "context.repository",
      "default": "context.repository",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "repository_hash": {
      "title": "Repository Hash",
      "type": "string"
    },
    "budget_chars": {
      "minimum": 1,
      "title": "Budget Chars",
      "type": "integer"
    },
    "used_chars": {
      "minimum": 0,
      "title": "Used Chars",
      "type": "integer"
    },
    "paths": {
      "items": {
        "type": "string"
      },
      "title": "Paths",
      "type": "array"
    },
    "selection_reasons": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Selection Reasons",
      "type": "array"
    },
    "cache_hits": {
      "minimum": 0,
      "title": "Cache Hits",
      "type": "integer"
    },
    "parsed_files": {
      "minimum": 0,
      "title": "Parsed Files",
      "type": "integer"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "repository_hash",
    "budget_chars",
    "used_chars",
    "paths",
    "selection_reasons",
    "cache_hits",
    "parsed_files",
    "ts"
  ],
  "title": "ContextRepositoryEvent",
  "type": "object"
}
```

### CoreShutdownCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `reason` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "core.shutdown",
      "default": "core.shutdown",
      "title": "Type",
      "type": "string"
    },
    "reason": {
      "default": "",
      "title": "Reason",
      "type": "string"
    }
  },
  "title": "CoreShutdownCommand",
  "type": "object"
}
```

### CoreWorkspaceChangedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `previous_workspace` | `string` | yes |
| `workspace` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "core.workspace_changed",
      "default": "core.workspace_changed",
      "title": "Type",
      "type": "string"
    },
    "previous_workspace": {
      "title": "Previous Workspace",
      "type": "string"
    },
    "workspace": {
      "title": "Workspace",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "previous_workspace",
    "workspace",
    "ts"
  ],
  "title": "CoreWorkspaceChangedEvent",
  "type": "object"
}
```

### ExtensionNotificationEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `session_id` | `string` | yes |
| `message` | `string` | yes |
| `severity` | `string` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "extension.notification",
      "default": "extension.notification",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "message": {
      "title": "Message",
      "type": "string"
    },
    "severity": {
      "default": "info",
      "enum": [
        "info",
        "warning",
        "error"
      ],
      "title": "Severity",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "session_id",
    "message",
    "ts"
  ],
  "title": "ExtensionNotificationEvent",
  "type": "object"
}
```

### ExtensionUiUpdatedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `session_id` | `string` | yes |
| `kind` | `string` | yes |
| `key` | `string` | no |
| `value` | `object` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "extension.ui_updated",
      "default": "extension.ui_updated",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "kind": {
      "enum": [
        "status",
        "working_message",
        "working_visible",
        "hidden_thinking_label",
        "widget",
        "title",
        "editor_text",
        "editor_insert",
        "tools_expanded"
      ],
      "title": "Kind",
      "type": "string"
    },
    "key": {
      "default": "",
      "title": "Key",
      "type": "string"
    },
    "value": {
      "default": null,
      "title": "Value"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "session_id",
    "kind",
    "ts"
  ],
  "title": "ExtensionUiUpdatedEvent",
  "type": "object"
}
```

### LlmAttemptFinishedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `step` | `integer` | yes |
| `attempt` | `integer` | yes |
| `status` | `string` | yes |
| `failure_code` | `string` | no |
| `request_snapshot_digest` | `string` | yes |
| `ledger_seq` | `integer | null` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "llm.attempt_finished",
      "default": "llm.attempt_finished",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "step": {
      "title": "Step",
      "type": "integer"
    },
    "attempt": {
      "title": "Attempt",
      "type": "integer"
    },
    "status": {
      "enum": [
        "succeeded",
        "failed",
        "cancelled"
      ],
      "title": "Status",
      "type": "string"
    },
    "failure_code": {
      "default": "",
      "title": "Failure Code",
      "type": "string"
    },
    "request_snapshot_digest": {
      "title": "Request Snapshot Digest",
      "type": "string"
    },
    "ledger_seq": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Ledger Seq"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "step",
    "attempt",
    "status",
    "request_snapshot_digest",
    "ts"
  ],
  "title": "LlmAttemptFinishedEvent",
  "type": "object"
}
```

### MemoryAddCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `name` | `string` | yes |
| `description` | `string` | no |
| `memory_type` | `string` | no |
| `body` | `string` | yes |
| `source_session_id` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "memory.add",
      "default": "memory.add",
      "title": "Type",
      "type": "string"
    },
    "name": {
      "maxLength": 200,
      "minLength": 1,
      "title": "Name",
      "type": "string"
    },
    "description": {
      "default": "",
      "maxLength": 1000,
      "title": "Description",
      "type": "string"
    },
    "memory_type": {
      "default": "project",
      "enum": [
        "user",
        "feedback",
        "project",
        "reference"
      ],
      "title": "Memory Type",
      "type": "string"
    },
    "body": {
      "maxLength": 100000,
      "minLength": 1,
      "title": "Body",
      "type": "string"
    },
    "source_session_id": {
      "default": "",
      "title": "Source Session Id",
      "type": "string"
    }
  },
  "required": [
    "name",
    "body"
  ],
  "title": "MemoryAddCommand",
  "type": "object"
}
```

### MemoryEditCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `memory_id` | `string` | yes |
| `name` | `string | null` | no |
| `description` | `string | null` | no |
| `memory_type` | `string | null` | no |
| `body` | `string | null` | no |

```json
{
  "properties": {
    "type": {
      "const": "memory.edit",
      "default": "memory.edit",
      "title": "Type",
      "type": "string"
    },
    "memory_id": {
      "minLength": 1,
      "title": "Memory Id",
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "description": {
      "anyOf": [
        {
          "maxLength": 1000,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Description"
    },
    "memory_type": {
      "anyOf": [
        {
          "enum": [
            "user",
            "feedback",
            "project",
            "reference"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Memory Type"
    },
    "body": {
      "anyOf": [
        {
          "maxLength": 100000,
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body"
    }
  },
  "required": [
    "memory_id"
  ],
  "title": "MemoryEditCommand",
  "type": "object"
}
```

### MemoryExpireCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `memory_id` | `string` | yes |
| `expires_at` | `string | null` | no |

```json
{
  "properties": {
    "type": {
      "const": "memory.expire",
      "default": "memory.expire",
      "title": "Type",
      "type": "string"
    },
    "memory_id": {
      "minLength": 1,
      "title": "Memory Id",
      "type": "string"
    },
    "expires_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Expires At"
    }
  },
  "required": [
    "memory_id"
  ],
  "title": "MemoryExpireCommand",
  "type": "object"
}
```

### MemoryPinCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `memory_id` | `string` | yes |
| `pinned` | `boolean` | no |

```json
{
  "properties": {
    "type": {
      "const": "memory.pin",
      "default": "memory.pin",
      "title": "Type",
      "type": "string"
    },
    "memory_id": {
      "minLength": 1,
      "title": "Memory Id",
      "type": "string"
    },
    "pinned": {
      "default": true,
      "title": "Pinned",
      "type": "boolean"
    }
  },
  "required": [
    "memory_id"
  ],
  "title": "MemoryPinCommand",
  "type": "object"
}
```

### MemorySettingsGetCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "memory.settings.get",
      "default": "memory.settings.get",
      "title": "Type",
      "type": "string"
    }
  },
  "title": "MemorySettingsGetCommand",
  "type": "object"
}
```

### MemorySettingsSetCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `auto_save` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "memory.settings.set",
      "default": "memory.settings.set",
      "title": "Type",
      "type": "string"
    },
    "auto_save": {
      "enum": [
        "prompt",
        "off"
      ],
      "title": "Auto Save",
      "type": "string"
    }
  },
  "required": [
    "auto_save"
  ],
  "title": "MemorySettingsSetCommand",
  "type": "object"
}
```

### PermissionDeniedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `tool_use_id` | `string` | yes |
| `decision` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "permission.denied",
      "default": "permission.denied",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "tool_use_id": {
      "title": "Tool Use Id",
      "type": "string"
    },
    "decision": {
      "title": "Decision",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "tool_use_id",
    "decision",
    "ts"
  ],
  "title": "PermissionDeniedEvent",
  "type": "object"
}
```

### PermissionGrantedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `tool_use_id` | `string` | yes |
| `decision` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "permission.granted",
      "default": "permission.granted",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "tool_use_id": {
      "title": "Tool Use Id",
      "type": "string"
    },
    "decision": {
      "title": "Decision",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "tool_use_id",
    "decision",
    "ts"
  ],
  "title": "PermissionGrantedEvent",
  "type": "object"
}
```

### PermissionRequestedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `tool_use_id` | `string` | yes |
| `tool_name` | `string` | yes |
| `params` | `object` | yes |
| `param_preview` | `string` | yes |
| `session_id` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "permission.requested",
      "default": "permission.requested",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "tool_use_id": {
      "title": "Tool Use Id",
      "type": "string"
    },
    "tool_name": {
      "title": "Tool Name",
      "type": "string"
    },
    "params": {
      "additionalProperties": true,
      "title": "Params",
      "type": "object"
    },
    "param_preview": {
      "title": "Param Preview",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "tool_use_id",
    "tool_name",
    "params",
    "param_preview",
    "session_id",
    "ts"
  ],
  "title": "PermissionRequestedEvent",
  "type": "object"
}
```

### ProjectActivateCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `project_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "project.activate",
      "default": "project.activate",
      "title": "Type",
      "type": "string"
    },
    "project_id": {
      "minLength": 1,
      "title": "Project Id",
      "type": "string"
    }
  },
  "required": [
    "project_id"
  ],
  "title": "ProjectActivateCommand",
  "type": "object"
}
```

### ProjectOpenCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `path` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "project.open",
      "default": "project.open",
      "title": "Type",
      "type": "string"
    },
    "path": {
      "minLength": 1,
      "title": "Path",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "title": "ProjectOpenCommand",
  "type": "object"
}
```

### RecoveryAvailableEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `run_id` | `string` | yes |
| `interruption_kind` | `string` | yes |
| `safe_to_resume` | `boolean` | yes |
| `summary` | `string` | yes |
| `actions` | `array` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "recovery.available",
      "default": "recovery.available",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "interruption_kind": {
      "title": "Interruption Kind",
      "type": "string"
    },
    "safe_to_resume": {
      "title": "Safe To Resume",
      "type": "boolean"
    },
    "summary": {
      "title": "Summary",
      "type": "string"
    },
    "actions": {
      "items": {
        "type": "string"
      },
      "title": "Actions",
      "type": "array"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "run_id",
    "interruption_kind",
    "safe_to_resume",
    "summary",
    "actions",
    "ts"
  ],
  "title": "RecoveryAvailableEvent",
  "type": "object"
}
```

### RecoveryResolvedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `run_id` | `string` | yes |
| `action` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "recovery.resolved",
      "default": "recovery.resolved",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "action": {
      "title": "Action",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "run_id",
    "action",
    "ts"
  ],
  "title": "RecoveryResolvedEvent",
  "type": "object"
}
```

### RunPhaseChangedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `phase` | `string` | yes |
| `current` | `integer` | no |
| `total` | `integer` | no |
| `summary` | `string` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "run.phase_changed",
      "default": "run.phase_changed",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "phase": {
      "enum": [
        "understanding",
        "exploring",
        "planning",
        "waiting_confirmation",
        "executing",
        "verifying",
        "reviewing",
        "completed",
        "failed",
        "interrupted"
      ],
      "title": "Phase",
      "type": "string"
    },
    "current": {
      "default": 0,
      "minimum": 0,
      "title": "Current",
      "type": "integer"
    },
    "total": {
      "default": 0,
      "minimum": 0,
      "title": "Total",
      "type": "integer"
    },
    "summary": {
      "default": "",
      "title": "Summary",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "phase",
    "ts"
  ],
  "title": "RunPhaseChangedEvent",
  "type": "object"
}
```

### SessionExecuteCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `content` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.execute_command",
      "default": "session.execute_command",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "content": {
      "minLength": 1,
      "title": "Content",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "content"
  ],
  "title": "SessionExecuteCommand",
  "type": "object"
}
```

### SessionImportCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `content` | `string` | yes |
| `filename` | `string` | no |
| `title` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "session.import",
      "default": "session.import",
      "title": "Type",
      "type": "string"
    },
    "content": {
      "maxLength": 3145728,
      "minLength": 1,
      "title": "Content",
      "type": "string"
    },
    "filename": {
      "default": "",
      "maxLength": 260,
      "title": "Filename",
      "type": "string"
    },
    "title": {
      "default": "",
      "maxLength": 200,
      "title": "Title",
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "title": "SessionImportCommand",
  "type": "object"
}
```

### SessionInterruptedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `last_run_id` | `string` | yes |
| `reason` | `string` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.interrupted",
      "default": "session.interrupted",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "last_run_id": {
      "title": "Last Run Id",
      "type": "string"
    },
    "reason": {
      "default": "cancelled",
      "title": "Reason",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "last_run_id",
    "ts"
  ],
  "title": "SessionInterruptedEvent",
  "type": "object"
}
```

### SessionListQueueCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.list_queue",
      "default": "session.list_queue",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionListQueueCommand",
  "type": "object"
}
```

### SessionNavigateCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `target_seq` | `integer` | yes |
| `summarize` | `boolean` | no |
| `focus` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "session.navigate",
      "default": "session.navigate",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "target_seq": {
      "minimum": 1,
      "title": "Target Seq",
      "type": "integer"
    },
    "summarize": {
      "default": false,
      "title": "Summarize",
      "type": "boolean"
    },
    "focus": {
      "default": "",
      "title": "Focus",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "target_seq"
  ],
  "title": "SessionNavigateCommand",
  "type": "object"
}
```

### SessionQueueMessageCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `content` | `string` | yes |
| `display_content` | `string | null` | no |
| `runtime_mode` | `object` | no |
| `attachments` | `array` | no |
| `tools` | `array | null` | no |

```json
{
  "$defs": {
    "ImageArtifactInput": {
      "additionalProperties": false,
      "properties": {
        "sha256": {
          "pattern": "^[0-9a-f]{64}$",
          "title": "Sha256",
          "type": "string"
        },
        "media_type": {
          "pattern": "^image/(png|jpeg|webp|gif)$",
          "title": "Media Type",
          "type": "string"
        },
        "size": {
          "exclusiveMinimum": 0,
          "maximum": 2097152,
          "title": "Size",
          "type": "integer"
        },
        "width": {
          "exclusiveMinimum": 0,
          "maximum": 100000,
          "title": "Width",
          "type": "integer"
        },
        "height": {
          "exclusiveMinimum": 0,
          "maximum": 100000,
          "title": "Height",
          "type": "integer"
        }
      },
      "required": [
        "sha256",
        "media_type",
        "size",
        "width",
        "height"
      ],
      "title": "ImageArtifactInput",
      "type": "object"
    },
    "RuntimeMode": {
      "enum": [
        "plan",
        "act",
        "operate",
        "review"
      ],
      "title": "RuntimeMode",
      "type": "string"
    }
  },
  "properties": {
    "type": {
      "const": "session.queue_message",
      "default": "session.queue_message",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "content": {
      "minLength": 1,
      "title": "Content",
      "type": "string"
    },
    "display_content": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Display Content"
    },
    "runtime_mode": {
      "$ref": "#/$defs/RuntimeMode",
      "default": "act"
    },
    "attachments": {
      "items": {
        "$ref": "#/$defs/ImageArtifactInput"
      },
      "maxItems": 8,
      "title": "Attachments",
      "type": "array"
    },
    "tools": {
      "anyOf": [
        {
          "items": {
            "enum": [
              "read",
              "bash",
              "edit",
              "write"
            ],
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tools"
    }
  },
  "required": [
    "session_id",
    "content"
  ],
  "title": "SessionQueueMessageCommand",
  "type": "object"
}
```

### SessionReloadCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.reload",
      "default": "session.reload",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionReloadCommand",
  "type": "object"
}
```

### SessionRemoveQueuedMessageCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `message_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.remove_queued_message",
      "default": "session.remove_queued_message",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "message_id": {
      "minLength": 1,
      "title": "Message Id",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "message_id"
  ],
  "title": "SessionRemoveQueuedMessageCommand",
  "type": "object"
}
```

### SessionRetryQueuedMessageCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `message_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.retry_queued_message",
      "default": "session.retry_queued_message",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "message_id": {
      "minLength": 1,
      "title": "Message Id",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "message_id"
  ],
  "title": "SessionRetryQueuedMessageCommand",
  "type": "object"
}
```

### SessionRewindPreviewCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `checkpoint_id` | `string` | yes |
| `run_id` | `string | null` | no |

```json
{
  "properties": {
    "type": {
      "const": "session.rewind_preview",
      "default": "session.rewind_preview",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    },
    "checkpoint_id": {
      "title": "Checkpoint Id",
      "type": "string"
    },
    "run_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Run Id"
    }
  },
  "required": [
    "session_id",
    "checkpoint_id"
  ],
  "title": "SessionRewindPreviewCommand",
  "type": "object"
}
```

### SessionSetModelCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `route_id` | `string` | yes |
| `model` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "session.set_model",
      "default": "session.set_model",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "route_id": {
      "maxLength": 256,
      "minLength": 1,
      "title": "Route Id",
      "type": "string"
    },
    "model": {
      "default": "",
      "maxLength": 256,
      "title": "Model",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "route_id"
  ],
  "title": "SessionSetModelCommand",
  "type": "object"
}
```

### SessionSetThinkingCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `thinking_level` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.set_thinking",
      "default": "session.set_thinking",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "thinking_level": {
      "enum": [
        "off",
        "low",
        "medium",
        "high"
      ],
      "title": "Thinking Level",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "thinking_level"
  ],
  "title": "SessionSetThinkingCommand",
  "type": "object"
}
```

### SessionTreeCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "session.tree",
      "default": "session.tree",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "title": "Session Id",
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "title": "SessionTreeCommand",
  "type": "object"
}
```

### SkillInvokedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `skill_name` | `string` | yes |
| `arguments` | `string` | yes |
| `run_id` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "skill.invoked",
      "default": "skill.invoked",
      "title": "Type",
      "type": "string"
    },
    "skill_name": {
      "title": "Skill Name",
      "type": "string"
    },
    "arguments": {
      "title": "Arguments",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "skill_name",
    "arguments",
    "run_id",
    "ts"
  ],
  "title": "SkillInvokedEvent",
  "type": "object"
}
```

### StrategyProposedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `profile_digest` | `string` | yes |
| `strategy` | `string` | yes |
| `summary` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "strategy.proposed",
      "default": "strategy.proposed",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "profile_digest": {
      "pattern": "^[0-9a-f]{64}$",
      "title": "Profile Digest",
      "type": "string"
    },
    "strategy": {
      "enum": [
        "direct",
        "plan_first",
        "delegate"
      ],
      "title": "Strategy",
      "type": "string"
    },
    "summary": {
      "title": "Summary",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "profile_digest",
    "strategy",
    "summary",
    "ts"
  ],
  "title": "StrategyProposedEvent",
  "type": "object"
}
```

### StrategyResolvedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `profile_digest` | `string` | yes |
| `strategy` | `string` | yes |
| `ticket` | `string` | no |
| `reason` | `string` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "strategy.resolved",
      "default": "strategy.resolved",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "profile_digest": {
      "pattern": "^[0-9a-f]{64}$",
      "title": "Profile Digest",
      "type": "string"
    },
    "strategy": {
      "enum": [
        "direct",
        "plan_first",
        "delegate"
      ],
      "title": "Strategy",
      "type": "string"
    },
    "ticket": {
      "default": "",
      "title": "Ticket",
      "type": "string"
    },
    "reason": {
      "default": "",
      "title": "Reason",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "profile_digest",
    "strategy",
    "ts"
  ],
  "title": "StrategyResolvedEvent",
  "type": "object"
}
```

### SubagentFinishedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `parent_run_id` | `string` | yes |
| `status` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "subagent.finished",
      "default": "subagent.finished",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "parent_run_id": {
      "title": "Parent Run Id",
      "type": "string"
    },
    "status": {
      "title": "Status",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "parent_run_id",
    "status",
    "ts"
  ],
  "title": "SubagentFinishedEvent",
  "type": "object"
}
```

### SubagentStartedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `parent_run_id` | `string` | yes |
| `description` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "subagent.started",
      "default": "subagent.started",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "parent_run_id": {
      "title": "Parent Run Id",
      "type": "string"
    },
    "description": {
      "title": "Description",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "parent_run_id",
    "description",
    "ts"
  ],
  "title": "SubagentStartedEvent",
  "type": "object"
}
```

### TaskProfiledEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `profile` | `object` | yes |
| `profile_digest` | `string` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "task.profiled",
      "default": "task.profiled",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "profile": {
      "additionalProperties": true,
      "title": "Profile",
      "type": "object"
    },
    "profile_digest": {
      "title": "Profile Digest",
      "type": "string"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "profile",
    "profile_digest",
    "ts"
  ],
  "title": "TaskProfiledEvent",
  "type": "object"
}
```

### ToolCallProgressEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `tool_use_id` | `string` | yes |
| `tool_name` | `string` | yes |
| `elapsed_ms` | `integer` | yes |
| `output_tail` | `string` | no |
| `total_bytes` | `integer` | no |
| `step` | `integer` | no |
| `presentation` | `object | null` | no |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "tool.call_progress",
      "default": "tool.call_progress",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "tool_use_id": {
      "title": "Tool Use Id",
      "type": "string"
    },
    "tool_name": {
      "title": "Tool Name",
      "type": "string"
    },
    "elapsed_ms": {
      "minimum": 0,
      "title": "Elapsed Ms",
      "type": "integer"
    },
    "output_tail": {
      "default": "",
      "title": "Output Tail",
      "type": "string"
    },
    "total_bytes": {
      "default": 0,
      "minimum": 0,
      "title": "Total Bytes",
      "type": "integer"
    },
    "step": {
      "default": 0,
      "title": "Step",
      "type": "integer"
    },
    "presentation": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Presentation"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "tool_use_id",
    "tool_name",
    "elapsed_ms",
    "ts"
  ],
  "title": "ToolCallProgressEvent",
  "type": "object"
}
```

### VerificationCompletedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `step` | `integer` | yes |
| `tool` | `string` | yes |
| `action` | `string` | yes |
| `verdict` | `string` | no |
| `gate_count` | `integer` | yes |
| `passed` | `integer` | yes |
| `failed` | `integer` | yes |
| `paths` | `array` | yes |
| `gates` | `array` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "verification.completed",
      "default": "verification.completed",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "step": {
      "title": "Step",
      "type": "integer"
    },
    "tool": {
      "title": "Tool",
      "type": "string"
    },
    "action": {
      "title": "Action",
      "type": "string"
    },
    "verdict": {
      "const": "pass",
      "default": "pass",
      "title": "Verdict",
      "type": "string"
    },
    "gate_count": {
      "minimum": 0,
      "title": "Gate Count",
      "type": "integer"
    },
    "passed": {
      "minimum": 0,
      "title": "Passed",
      "type": "integer"
    },
    "failed": {
      "minimum": 0,
      "title": "Failed",
      "type": "integer"
    },
    "paths": {
      "items": {
        "type": "string"
      },
      "title": "Paths",
      "type": "array"
    },
    "gates": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Gates",
      "type": "array"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "step",
    "tool",
    "action",
    "gate_count",
    "passed",
    "failed",
    "paths",
    "gates",
    "ts"
  ],
  "title": "VerificationCompletedEvent",
  "type": "object"
}
```

### VerificationFailedEvent

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `run_id` | `string` | yes |
| `step` | `integer` | yes |
| `tool` | `string` | yes |
| `action` | `string` | yes |
| `verdict` | `string` | no |
| `gate_count` | `integer` | yes |
| `passed` | `integer` | yes |
| `failed` | `integer` | yes |
| `failure_class` | `string` | yes |
| `paths` | `array` | yes |
| `gates` | `array` | yes |
| `ts` | `string` | yes |

```json
{
  "properties": {
    "type": {
      "const": "verification.failed",
      "default": "verification.failed",
      "title": "Type",
      "type": "string"
    },
    "run_id": {
      "title": "Run Id",
      "type": "string"
    },
    "step": {
      "title": "Step",
      "type": "integer"
    },
    "tool": {
      "title": "Tool",
      "type": "string"
    },
    "action": {
      "title": "Action",
      "type": "string"
    },
    "verdict": {
      "const": "fail",
      "default": "fail",
      "title": "Verdict",
      "type": "string"
    },
    "gate_count": {
      "minimum": 0,
      "title": "Gate Count",
      "type": "integer"
    },
    "passed": {
      "minimum": 0,
      "title": "Passed",
      "type": "integer"
    },
    "failed": {
      "minimum": 1,
      "title": "Failed",
      "type": "integer"
    },
    "failure_class": {
      "title": "Failure Class",
      "type": "string"
    },
    "paths": {
      "items": {
        "type": "string"
      },
      "title": "Paths",
      "type": "array"
    },
    "gates": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Gates",
      "type": "array"
    },
    "ts": {
      "title": "Ts",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "step",
    "tool",
    "action",
    "gate_count",
    "passed",
    "failed",
    "failure_class",
    "paths",
    "gates",
    "ts"
  ],
  "title": "VerificationFailedEvent",
  "type": "object"
}
```

### WebLaunchCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |

```json
{
  "properties": {
    "type": {
      "const": "web.launch",
      "default": "web.launch",
      "title": "Type",
      "type": "string"
    }
  },
  "title": "WebLaunchCommand",
  "type": "object"
}
```

### WorkspaceCommitCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `message` | `string` | yes |
| `expected_digest` | `string` | yes |
| `confirmed` | `boolean` | no |

```json
{
  "properties": {
    "type": {
      "const": "workspace.commit",
      "default": "workspace.commit",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "message": {
      "maxLength": 200,
      "minLength": 1,
      "title": "Message",
      "type": "string"
    },
    "expected_digest": {
      "maxLength": 64,
      "minLength": 64,
      "title": "Expected Digest",
      "type": "string"
    },
    "confirmed": {
      "default": false,
      "title": "Confirmed",
      "type": "boolean"
    }
  },
  "required": [
    "session_id",
    "message",
    "expected_digest"
  ],
  "title": "WorkspaceCommitCommand",
  "type": "object"
}
```

### WorkspaceStageCommand

| Field | Type | Required |
|---|---|---|
| `type` | `string` | no |
| `session_id` | `string` | yes |
| `paths` | `array` | yes |
| `expected_digest` | `string` | yes |
| `confirmed` | `boolean` | no |

```json
{
  "properties": {
    "type": {
      "const": "workspace.stage",
      "default": "workspace.stage",
      "title": "Type",
      "type": "string"
    },
    "session_id": {
      "minLength": 1,
      "title": "Session Id",
      "type": "string"
    },
    "paths": {
      "items": {
        "type": "string"
      },
      "maxItems": 200,
      "minItems": 1,
      "title": "Paths",
      "type": "array"
    },
    "expected_digest": {
      "maxLength": 64,
      "minLength": 64,
      "title": "Expected Digest",
      "type": "string"
    },
    "confirmed": {
      "default": false,
      "title": "Confirmed",
      "type": "boolean"
    }
  },
  "required": [
    "session_id",
    "paths",
    "expected_digest"
  ],
  "title": "WorkspaceStageCommand",
  "type": "object"
}
```