{
  "components": {
    "schemas": {
      "AbortCurrentRunRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "AttachWorkspaceRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "CallbackBody": {
        "description": "Raw callback request body. JSON and text bodies are parsed; other content types are represented internally as base64 JSON."
      },
      "CancelTimerRequest": {
        "additionalProperties": false,
        "properties": {
          "authority_class": {
            "enum": [
              "operator_instruction",
              "runtime_instruction",
              "integration_signal",
              "external_evidence",
              null
            ],
            "type": [
              "string",
              "null"
            ]
          }
        },
        "title": "CancelTimerRequest",
        "type": "object"
      },
      "ClearAgentModelRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "CompleteWorkItemRequest": {
        "additionalProperties": false,
        "properties": {
          "authority_class": {
            "enum": [
              "operator_instruction",
              "runtime_instruction",
              "integration_signal",
              "external_evidence",
              null
            ],
            "type": [
              "string",
              "null"
            ]
          }
        },
        "title": "CompleteWorkItemRequest",
        "type": "object"
      },
      "ControlPromptRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "ControlRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "ControlWakeRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "CreateAgentRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "CreateCommandTaskRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "CreateTimerRequest": {
        "additionalProperties": false,
        "properties": {
          "authority_class": {
            "enum": [
              "operator_instruction",
              "runtime_instruction",
              "integration_signal",
              "external_evidence",
              null
            ],
            "type": [
              "string",
              "null"
            ]
          },
          "duration_ms": {
            "format": "uint64",
            "minimum": 0,
            "type": "integer"
          },
          "interval_ms": {
            "format": "uint64",
            "minimum": 0,
            "type": [
              "integer",
              "null"
            ]
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "duration_ms"
        ],
        "title": "CreateTimerRequest",
        "type": "object"
      },
      "CreateWorkItemRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "DebugPromptRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "DetachWorkspaceRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "EnqueueRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "ErrorResponse": {
        "additionalProperties": true,
        "properties": {
          "after_seq": {
            "minimum": 0,
            "type": "integer"
          },
          "agent_id": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "error": {
            "type": "string"
          },
          "event_seq": {
            "minimum": 0,
            "type": "integer"
          },
          "hint": {
            "type": "string"
          },
          "ok": {
            "const": false,
            "type": "boolean"
          }
        },
        "required": [
          "error"
        ],
        "type": "object"
      },
      "ExitWorkspaceRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "GenericJsonPayload": {
        "$ref": "#/components/schemas/JsonValue"
      },
      "IncomingOrigin": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "InstallSkillRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "JsonValue": {
        "description": "Arbitrary JSON value. Used as a conservative baseline for routes whose DTO is not yet stabilized."
      },
      "OperatorIngressRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "OperatorTransportBindingRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "PickWorkItemRequest": {
        "additionalProperties": false,
        "properties": {
          "authority_class": {
            "enum": [
              "operator_instruction",
              "runtime_instruction",
              "integration_signal",
              "external_evidence",
              null
            ],
            "type": [
              "string",
              "null"
            ]
          },
          "reason": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "title": "PickWorkItemRequest",
        "type": "object"
      },
      "PickWorkItemResponse": {
        "properties": {
          "current_work_item": {
            "properties": {
              "agent_id": {
                "type": "string"
              },
              "blocked_by": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "created_at": {
                "format": "date-time",
                "type": "string"
              },
              "id": {
                "type": "string"
              },
              "legacy_inline_plan": {
                "type": [
                  "string",
                  "null"
                ],
                "writeOnly": true
              },
              "objective": {
                "type": "string"
              },
              "plan_artifact": {
                "properties": {
                  "bytes": {
                    "format": "uint64",
                    "minimum": 0,
                    "type": "integer"
                  },
                  "hash": {
                    "type": "string"
                  },
                  "owner_agent_id": {
                    "default": "",
                    "type": "string"
                  },
                  "path": {
                    "type": "string"
                  },
                  "preview": {
                    "type": "string"
                  },
                  "preview_complete": {
                    "type": "boolean"
                  },
                  "relative_path": {
                    "default": "",
                    "type": "string"
                  },
                  "updated_at": {
                    "format": "date-time",
                    "type": "string"
                  },
                  "workspace_alias": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "workspace_id": {
                    "default": "agent_home",
                    "type": "string"
                  }
                },
                "required": [
                  "path",
                  "hash",
                  "bytes",
                  "updated_at",
                  "preview",
                  "preview_complete"
                ],
                "type": [
                  "object",
                  "null"
                ]
              },
              "plan_status": {
                "enum": [
                  "draft",
                  "ready",
                  "needs_input"
                ],
                "type": "string"
              },
              "recheck_at": {
                "format": "date-time",
                "type": [
                  "string",
                  "null"
                ]
              },
              "recheck_consumed_at": {
                "format": "date-time",
                "type": [
                  "string",
                  "null"
                ]
              },
              "result_summary": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "revision": {
                "default": 1,
                "format": "uint64",
                "minimum": 0,
                "type": "integer"
              },
              "state": {
                "enum": [
                  "open",
                  "completed"
                ],
                "type": "string"
              },
              "todo_list": {
                "items": {
                  "properties": {
                    "state": {
                      "enum": [
                        "pending",
                        "in_progress",
                        "completed"
                      ],
                      "type": "string"
                    },
                    "text": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "text",
                    "state"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "updated_at": {
                "format": "date-time",
                "type": "string"
              },
              "workspace_id": {
                "default": "agent_home",
                "type": "string"
              }
            },
            "required": [
              "id",
              "agent_id",
              "objective",
              "state",
              "plan_status",
              "created_at",
              "updated_at"
            ],
            "type": "object"
          },
          "current_work_item_id": {
            "type": "string"
          },
          "previous_work_item": {
            "properties": {
              "agent_id": {
                "type": "string"
              },
              "blocked_by": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "created_at": {
                "format": "date-time",
                "type": "string"
              },
              "id": {
                "type": "string"
              },
              "legacy_inline_plan": {
                "type": [
                  "string",
                  "null"
                ],
                "writeOnly": true
              },
              "objective": {
                "type": "string"
              },
              "plan_artifact": {
                "properties": {
                  "bytes": {
                    "format": "uint64",
                    "minimum": 0,
                    "type": "integer"
                  },
                  "hash": {
                    "type": "string"
                  },
                  "owner_agent_id": {
                    "default": "",
                    "type": "string"
                  },
                  "path": {
                    "type": "string"
                  },
                  "preview": {
                    "type": "string"
                  },
                  "preview_complete": {
                    "type": "boolean"
                  },
                  "relative_path": {
                    "default": "",
                    "type": "string"
                  },
                  "updated_at": {
                    "format": "date-time",
                    "type": "string"
                  },
                  "workspace_alias": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "workspace_id": {
                    "default": "agent_home",
                    "type": "string"
                  }
                },
                "required": [
                  "path",
                  "hash",
                  "bytes",
                  "updated_at",
                  "preview",
                  "preview_complete"
                ],
                "type": [
                  "object",
                  "null"
                ]
              },
              "plan_status": {
                "enum": [
                  "draft",
                  "ready",
                  "needs_input"
                ],
                "type": "string"
              },
              "recheck_at": {
                "format": "date-time",
                "type": [
                  "string",
                  "null"
                ]
              },
              "recheck_consumed_at": {
                "format": "date-time",
                "type": [
                  "string",
                  "null"
                ]
              },
              "result_summary": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "revision": {
                "default": 1,
                "format": "uint64",
                "minimum": 0,
                "type": "integer"
              },
              "state": {
                "enum": [
                  "open",
                  "completed"
                ],
                "type": "string"
              },
              "todo_list": {
                "items": {
                  "properties": {
                    "state": {
                      "enum": [
                        "pending",
                        "in_progress",
                        "completed"
                      ],
                      "type": "string"
                    },
                    "text": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "text",
                    "state"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "updated_at": {
                "format": "date-time",
                "type": "string"
              },
              "workspace_id": {
                "default": "agent_home",
                "type": "string"
              }
            },
            "required": [
              "id",
              "agent_id",
              "objective",
              "state",
              "plan_status",
              "created_at",
              "updated_at"
            ],
            "type": [
              "object",
              "null"
            ]
          },
          "transition": {
            "properties": {
              "current_focus_mode": {
                "type": "string"
              },
              "current_readiness": {
                "enum": [
                  "runnable",
                  "waiting_for_operator",
                  "blocked",
                  "completed"
                ],
                "type": "string"
              },
              "current_work_item_id": {
                "type": "string"
              },
              "previous_readiness": {
                "enum": [
                  "runnable",
                  "waiting_for_operator",
                  "blocked",
                  "completed",
                  null
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "previous_work_item_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "reason": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "switch_kind": {
                "type": "string"
              },
              "warnings": {
                "items": {
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "code",
                    "message"
                  ],
                  "type": "object"
                },
                "type": "array"
              }
            },
            "required": [
              "current_work_item_id",
              "current_readiness",
              "switch_kind",
              "current_focus_mode"
            ],
            "type": "object"
          }
        },
        "required": [
          "current_work_item",
          "current_work_item_id",
          "transition"
        ],
        "title": "PickWorkItemResponse",
        "type": "object"
      },
      "SetAgentModelRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "TaskInputRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "TaskInputResult": {
        "properties": {
          "accepted_input": {
            "type": "boolean"
          },
          "bytes_written": {
            "format": "uint64",
            "minimum": 0,
            "type": [
              "integer",
              "null"
            ]
          },
          "input_target": {
            "type": [
              "string",
              "null"
            ]
          },
          "summary_text": {
            "type": [
              "string",
              "null"
            ]
          },
          "task": {
            "properties": {
              "child_agent_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "child_observability": {
                "properties": {
                  "blocked_reason": {
                    "enum": [
                      "managed_task_queued",
                      "managed_task_running",
                      "managed_task_cancelling",
                      "awaiting_managed_task",
                      null
                    ],
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "current_work_item_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "last_progress_brief": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "last_result_brief": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "phase": {
                    "enum": [
                      "running",
                      "blocked",
                      "waiting",
                      "terminal"
                    ],
                    "type": "string"
                  },
                  "waiting_reason": {
                    "enum": [
                      "awaiting_operator_input",
                      "awaiting_external_change",
                      "awaiting_task_result",
                      "awaiting_timer",
                      null
                    ],
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "work_summary": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "phase"
                ],
                "type": [
                  "object",
                  "null"
                ]
              },
              "child_supervision": {
                "properties": {
                  "child_agent_id": {
                    "type": "string"
                  },
                  "child_work_item_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "cleanup_owner": {
                    "type": "string"
                  },
                  "cleanup_status": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "delegation_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "followup_target": {
                    "type": "string"
                  },
                  "parent_agent_id": {
                    "type": "string"
                  },
                  "parent_work_item_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "supervision_task_id": {
                    "type": "string"
                  },
                  "workspace_mode": {
                    "enum": [
                      "inherit",
                      "worktree",
                      null
                    ],
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "worktree": {
                    "properties": {
                      "actual_branch": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "auto_cleaned_up": {
                        "type": [
                          "boolean",
                          "null"
                        ]
                      },
                      "branch_cleanup_error": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "branch_cleanup_status": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "changed_files": {
                        "items": {
                          "type": "string"
                        },
                        "type": "array"
                      },
                      "cleanup_error": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "cleanup_reason": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "cleanup_status": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "original_branch": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "original_cwd": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "projection_kind": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "retained_for_review": {
                        "type": [
                          "boolean",
                          "null"
                        ]
                      },
                      "worktree_branch": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "worktree_path": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "type": [
                      "object",
                      "null"
                    ]
                  }
                },
                "required": [
                  "parent_agent_id",
                  "child_agent_id",
                  "supervision_task_id",
                  "cleanup_owner",
                  "followup_target"
                ],
                "type": [
                  "object",
                  "null"
                ]
              },
              "command": {
                "properties": {
                  "accepts_input": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "cmd": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "cmd_digest": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "exit_status": {
                    "format": "int32",
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "input_target": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "login": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "output_path": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "promoted_from_exec_command": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "result_summary": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "shell": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "terminal_reentry": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "tty": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "workdir": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "created_at": {
                "format": "date-time",
                "type": "string"
              },
              "kind": {
                "type": "string"
              },
              "parent_message_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "status": {
                "enum": [
                  "queued",
                  "running",
                  "cancelling",
                  "completed",
                  "failed",
                  "cancelled",
                  "interrupted"
                ],
                "type": "string"
              },
              "summary": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "task_id": {
                "type": "string"
              },
              "updated_at": {
                "format": "date-time",
                "type": "string"
              },
              "wait_policy": {
                "enum": [
                  "background"
                ],
                "type": "string"
              }
            },
            "required": [
              "task_id",
              "kind",
              "status",
              "created_at",
              "updated_at",
              "wait_policy"
            ],
            "type": "object"
          }
        },
        "required": [
          "task",
          "accepted_input"
        ],
        "title": "TaskInputResult",
        "type": "object"
      },
      "TaskOutputResult": {
        "properties": {
          "retrieval_status": {
            "enum": [
              "success",
              "timeout",
              "not_ready"
            ],
            "type": "string"
          },
          "task": {
            "properties": {
              "artifacts": {
                "items": {
                  "properties": {
                    "path": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "path"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "child_supervision": {
                "properties": {
                  "child_agent_id": {
                    "type": "string"
                  },
                  "child_work_item_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "cleanup_owner": {
                    "type": "string"
                  },
                  "cleanup_status": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "delegation_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "followup_target": {
                    "type": "string"
                  },
                  "parent_agent_id": {
                    "type": "string"
                  },
                  "parent_work_item_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "supervision_task_id": {
                    "type": "string"
                  },
                  "workspace_mode": {
                    "enum": [
                      "inherit",
                      "worktree",
                      null
                    ],
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "worktree": {
                    "properties": {
                      "actual_branch": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "auto_cleaned_up": {
                        "type": [
                          "boolean",
                          "null"
                        ]
                      },
                      "branch_cleanup_error": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "branch_cleanup_status": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "changed_files": {
                        "items": {
                          "type": "string"
                        },
                        "type": "array"
                      },
                      "cleanup_error": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "cleanup_reason": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "cleanup_status": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "original_branch": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "original_cwd": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "projection_kind": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "retained_for_review": {
                        "type": [
                          "boolean",
                          "null"
                        ]
                      },
                      "worktree_branch": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "worktree_path": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "type": [
                      "object",
                      "null"
                    ]
                  }
                },
                "required": [
                  "parent_agent_id",
                  "child_agent_id",
                  "supervision_task_id",
                  "cleanup_owner",
                  "followup_target"
                ],
                "type": [
                  "object",
                  "null"
                ]
              },
              "exit_status": {
                "format": "int32",
                "type": [
                  "integer",
                  "null"
                ]
              },
              "failure_artifact": {
                "properties": {
                  "category": {
                    "enum": [
                      "transport",
                      "protocol",
                      "runtime",
                      "task",
                      "unknown"
                    ],
                    "type": "string"
                  },
                  "exit_status": {
                    "format": "int32",
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "kind": {
                    "type": "string"
                  },
                  "metadata": {
                    "additionalProperties": {
                      "type": "string"
                    },
                    "type": "object"
                  },
                  "model_ref": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "provider": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "source_chain": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "status": {
                    "format": "uint16",
                    "maximum": 65535,
                    "minimum": 0,
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "summary": {
                    "type": "string"
                  },
                  "task_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "category",
                  "kind",
                  "summary"
                ],
                "type": [
                  "object",
                  "null"
                ]
              },
              "kind": {
                "type": "string"
              },
              "output_artifact": {
                "format": "uint",
                "minimum": 0,
                "type": [
                  "integer",
                  "null"
                ]
              },
              "output_preview": {
                "type": "string"
              },
              "output_truncated": {
                "type": "boolean"
              },
              "result_summary": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "status": {
                "enum": [
                  "queued",
                  "running",
                  "cancelling",
                  "completed",
                  "failed",
                  "cancelled",
                  "interrupted"
                ],
                "type": "string"
              },
              "summary": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "task_id": {
                "type": "string"
              }
            },
            "required": [
              "task_id",
              "kind",
              "status",
              "output_preview",
              "output_truncated"
            ],
            "type": "object"
          }
        },
        "required": [
          "retrieval_status",
          "task"
        ],
        "title": "TaskOutputResult",
        "type": "object"
      },
      "TaskStatusSnapshot": {
        "properties": {
          "child_agent_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "child_observability": {
            "properties": {
              "blocked_reason": {
                "enum": [
                  "managed_task_queued",
                  "managed_task_running",
                  "managed_task_cancelling",
                  "awaiting_managed_task",
                  null
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "current_work_item_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "last_progress_brief": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "last_result_brief": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "phase": {
                "enum": [
                  "running",
                  "blocked",
                  "waiting",
                  "terminal"
                ],
                "type": "string"
              },
              "waiting_reason": {
                "enum": [
                  "awaiting_operator_input",
                  "awaiting_external_change",
                  "awaiting_task_result",
                  "awaiting_timer",
                  null
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "work_summary": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "phase"
            ],
            "type": [
              "object",
              "null"
            ]
          },
          "child_supervision": {
            "properties": {
              "child_agent_id": {
                "type": "string"
              },
              "child_work_item_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "cleanup_owner": {
                "type": "string"
              },
              "cleanup_status": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "delegation_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "followup_target": {
                "type": "string"
              },
              "parent_agent_id": {
                "type": "string"
              },
              "parent_work_item_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "supervision_task_id": {
                "type": "string"
              },
              "workspace_mode": {
                "enum": [
                  "inherit",
                  "worktree",
                  null
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "worktree": {
                "properties": {
                  "actual_branch": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "auto_cleaned_up": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "branch_cleanup_error": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "branch_cleanup_status": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "changed_files": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "cleanup_error": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "cleanup_reason": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "cleanup_status": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "original_branch": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "original_cwd": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "projection_kind": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "retained_for_review": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "worktree_branch": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "worktree_path": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              }
            },
            "required": [
              "parent_agent_id",
              "child_agent_id",
              "supervision_task_id",
              "cleanup_owner",
              "followup_target"
            ],
            "type": [
              "object",
              "null"
            ]
          },
          "command": {
            "properties": {
              "accepts_input": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "cmd": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "cmd_digest": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "exit_status": {
                "format": "int32",
                "type": [
                  "integer",
                  "null"
                ]
              },
              "input_target": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "login": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "output_path": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "promoted_from_exec_command": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "result_summary": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "shell": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "terminal_reentry": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "tty": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "workdir": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "type": [
              "object",
              "null"
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "parent_message_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "enum": [
              "queued",
              "running",
              "cancelling",
              "completed",
              "failed",
              "cancelled",
              "interrupted"
            ],
            "type": "string"
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "task_id": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "wait_policy": {
            "enum": [
              "background"
            ],
            "type": "string"
          }
        },
        "required": [
          "task_id",
          "kind",
          "status",
          "created_at",
          "updated_at",
          "wait_policy"
        ],
        "title": "TaskStatusSnapshot",
        "type": "object"
      },
      "TaskStopRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "TaskStopResult": {
        "properties": {
          "force_stop_requested": {
            "type": "boolean"
          },
          "stop_requested": {
            "type": "boolean"
          },
          "summary_text": {
            "type": [
              "string",
              "null"
            ]
          },
          "task": {
            "properties": {
              "child_agent_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "child_observability": {
                "properties": {
                  "blocked_reason": {
                    "enum": [
                      "managed_task_queued",
                      "managed_task_running",
                      "managed_task_cancelling",
                      "awaiting_managed_task",
                      null
                    ],
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "current_work_item_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "last_progress_brief": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "last_result_brief": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "phase": {
                    "enum": [
                      "running",
                      "blocked",
                      "waiting",
                      "terminal"
                    ],
                    "type": "string"
                  },
                  "waiting_reason": {
                    "enum": [
                      "awaiting_operator_input",
                      "awaiting_external_change",
                      "awaiting_task_result",
                      "awaiting_timer",
                      null
                    ],
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "work_summary": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "phase"
                ],
                "type": [
                  "object",
                  "null"
                ]
              },
              "child_supervision": {
                "properties": {
                  "child_agent_id": {
                    "type": "string"
                  },
                  "child_work_item_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "cleanup_owner": {
                    "type": "string"
                  },
                  "cleanup_status": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "delegation_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "followup_target": {
                    "type": "string"
                  },
                  "parent_agent_id": {
                    "type": "string"
                  },
                  "parent_work_item_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "supervision_task_id": {
                    "type": "string"
                  },
                  "workspace_mode": {
                    "enum": [
                      "inherit",
                      "worktree",
                      null
                    ],
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "worktree": {
                    "properties": {
                      "actual_branch": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "auto_cleaned_up": {
                        "type": [
                          "boolean",
                          "null"
                        ]
                      },
                      "branch_cleanup_error": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "branch_cleanup_status": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "changed_files": {
                        "items": {
                          "type": "string"
                        },
                        "type": "array"
                      },
                      "cleanup_error": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "cleanup_reason": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "cleanup_status": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "original_branch": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "original_cwd": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "projection_kind": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "retained_for_review": {
                        "type": [
                          "boolean",
                          "null"
                        ]
                      },
                      "worktree_branch": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "worktree_path": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "type": [
                      "object",
                      "null"
                    ]
                  }
                },
                "required": [
                  "parent_agent_id",
                  "child_agent_id",
                  "supervision_task_id",
                  "cleanup_owner",
                  "followup_target"
                ],
                "type": [
                  "object",
                  "null"
                ]
              },
              "command": {
                "properties": {
                  "accepts_input": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "cmd": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "cmd_digest": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "exit_status": {
                    "format": "int32",
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "input_target": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "login": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "output_path": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "promoted_from_exec_command": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "result_summary": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "shell": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "terminal_reentry": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "tty": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "workdir": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "created_at": {
                "format": "date-time",
                "type": "string"
              },
              "kind": {
                "type": "string"
              },
              "parent_message_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "status": {
                "enum": [
                  "queued",
                  "running",
                  "cancelling",
                  "completed",
                  "failed",
                  "cancelled",
                  "interrupted"
                ],
                "type": "string"
              },
              "summary": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "task_id": {
                "type": "string"
              },
              "updated_at": {
                "format": "date-time",
                "type": "string"
              },
              "wait_policy": {
                "enum": [
                  "background"
                ],
                "type": "string"
              }
            },
            "required": [
              "task_id",
              "kind",
              "status",
              "created_at",
              "updated_at",
              "wait_policy"
            ],
            "type": "object"
          }
        },
        "required": [
          "task",
          "stop_requested",
          "force_stop_requested"
        ],
        "title": "TaskStopResult",
        "type": "object"
      },
      "TimerRecord": {
        "properties": {
          "agent_id": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "duration_ms": {
            "format": "uint64",
            "minimum": 0,
            "type": "integer"
          },
          "fire_count": {
            "default": 0,
            "format": "uint64",
            "minimum": 0,
            "type": "integer"
          },
          "id": {
            "type": "string"
          },
          "interval_ms": {
            "format": "uint64",
            "minimum": 0,
            "type": [
              "integer",
              "null"
            ]
          },
          "last_fired_at": {
            "default": null,
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "next_fire_at": {
            "default": null,
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "repeat": {
            "type": "boolean"
          },
          "status": {
            "default": "active",
            "enum": [
              "active",
              "completed",
              "cancelled"
            ],
            "type": "string"
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "agent_id",
          "created_at",
          "duration_ms",
          "repeat"
        ],
        "title": "TimerRecord",
        "type": "object"
      },
      "UninstallSkillRequest": {
        "additionalProperties": true,
        "description": "Baseline request DTO schema. Per-field schemas will be tightened as HTTP envelope and DTO contracts stabilize.",
        "type": "object"
      },
      "UpdateWorkItemRequest": {
        "additionalProperties": false,
        "properties": {
          "authority_class": {
            "enum": [
              "operator_instruction",
              "runtime_instruction",
              "integration_signal",
              "external_evidence",
              null
            ],
            "type": [
              "string",
              "null"
            ]
          },
          "blocked_by": true,
          "objective": {
            "type": [
              "string",
              "null"
            ]
          },
          "plan_status": {
            "enum": [
              "draft",
              "ready",
              "needs_input",
              null
            ],
            "type": [
              "string",
              "null"
            ]
          },
          "recheck_after": {
            "format": "uint64",
            "minimum": 1,
            "type": [
              "integer",
              "null"
            ]
          },
          "todo_list": {
            "items": {
              "properties": {
                "state": {
                  "enum": [
                    "pending",
                    "in_progress",
                    "completed"
                  ],
                  "type": "string"
                },
                "text": {
                  "type": "string"
                }
              },
              "required": [
                "text",
                "state"
              ],
              "type": "object"
            },
            "type": [
              "array",
              "null"
            ]
          }
        },
        "title": "UpdateWorkItemRequest",
        "type": "object"
      },
      "WorkItemRecord": {
        "properties": {
          "agent_id": {
            "type": "string"
          },
          "blocked_by": {
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "legacy_inline_plan": {
            "type": [
              "string",
              "null"
            ],
            "writeOnly": true
          },
          "objective": {
            "type": "string"
          },
          "plan_artifact": {
            "properties": {
              "bytes": {
                "format": "uint64",
                "minimum": 0,
                "type": "integer"
              },
              "hash": {
                "type": "string"
              },
              "owner_agent_id": {
                "default": "",
                "type": "string"
              },
              "path": {
                "type": "string"
              },
              "preview": {
                "type": "string"
              },
              "preview_complete": {
                "type": "boolean"
              },
              "relative_path": {
                "default": "",
                "type": "string"
              },
              "updated_at": {
                "format": "date-time",
                "type": "string"
              },
              "workspace_alias": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "workspace_id": {
                "default": "agent_home",
                "type": "string"
              }
            },
            "required": [
              "path",
              "hash",
              "bytes",
              "updated_at",
              "preview",
              "preview_complete"
            ],
            "type": [
              "object",
              "null"
            ]
          },
          "plan_status": {
            "enum": [
              "draft",
              "ready",
              "needs_input"
            ],
            "type": "string"
          },
          "recheck_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "recheck_consumed_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "result_summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "revision": {
            "default": 1,
            "format": "uint64",
            "minimum": 0,
            "type": "integer"
          },
          "state": {
            "enum": [
              "open",
              "completed"
            ],
            "type": "string"
          },
          "todo_list": {
            "items": {
              "properties": {
                "state": {
                  "enum": [
                    "pending",
                    "in_progress",
                    "completed"
                  ],
                  "type": "string"
                },
                "text": {
                  "type": "string"
                }
              },
              "required": [
                "text",
                "state"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "workspace_id": {
            "default": "agent_home",
            "type": "string"
          }
        },
        "required": [
          "id",
          "agent_id",
          "objective",
          "state",
          "plan_status",
          "created_at",
          "updated_at"
        ],
        "title": "WorkItemRecord",
        "type": "object"
      }
    },
    "securitySchemes": {
      "BearerAuth": {
        "scheme": "bearer",
        "type": "http"
      },
      "CallbackToken": {
        "description": "Opaque capability secret path segment. Use placeholders in documentation and tests.",
        "in": "path",
        "name": "callback_token",
        "type": "apiKey"
      }
    }
  },
  "info": {
    "description": "Generated baseline for Holon's current HTTP control-plane surface. It is intentionally conservative: many response bodies remain JSON placeholders until the success/error envelope contracts stabilize.",
    "title": "Holon HTTP control-plane API",
    "version": "0.15.1"
  },
  "openapi": "3.1.0",
  "paths": {
    "/": {
      "get": {
        "description": "Return the default agent id.",
        "operationId": "root",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Root discovery",
        "tags": [
          "discovery"
        ]
      }
    },
    "/agents/list": {
      "get": {
        "description": "Return lightweight public agent entries.",
        "operationId": "listAgents",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List agents",
        "tags": [
          "agents"
        ],
        "x-holon-openapi-source": "aide::axum::ApiRouter::api_route_docs"
      }
    },
    "/agents/{agent_id}/briefs": {
      "get": {
        "description": "Return recent user-facing delivery briefs. Query parameter: limit.",
        "operationId": "agentBriefs",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            },
            "style": "simple"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Recent briefs",
        "tags": [
          "agents"
        ],
        "x-holon-openapi-source": "aide::axum::ApiRouter::api_route_docs"
      }
    },
    "/agents/{agent_id}/enqueue": {
      "post": {
        "description": "Enqueue a public channel/webhook message for the named agent.",
        "operationId": "enqueueAgent",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnqueueRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Enqueue agent message",
        "tags": [
          "ingress"
        ]
      }
    },
    "/agents/{agent_id}/events": {
      "get": {
        "description": "Return a bounded page of runtime event envelopes. Query parameters: before_seq, after_seq, limit, order, max_level. Event payloads are included in full; max_level filters event inclusion only. Breaking change: the projection query parameter and StreamEventEnvelope.projection field have been removed.",
        "operationId": "agentEvents",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Agent event page",
        "tags": [
          "events"
        ]
      }
    },
    "/agents/{agent_id}/events/stream": {
      "get": {
        "description": "Return Server-Sent Events carrying raw StreamEventEnvelope JSON data. Query parameters: after_seq, limit. SSE id is event_seq; SSE event is the audit event kind; missing replay cursors return cursor_not_found before the stream opens. Breaking change: the projection query parameter and StreamEventEnvelope.projection field have been removed.",
        "operationId": "agentEventsStream",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "text/event-stream": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "Server-Sent Events stream. Each data frame contains a StreamEventEnvelope JSON object."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error before stream establishment."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Agent event stream",
        "tags": [
          "events"
        ]
      }
    },
    "/agents/{agent_id}/skills": {
      "get": {
        "description": "Return installed skills for an agent.",
        "operationId": "agentSkills",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List skills",
        "tags": [
          "skills"
        ]
      }
    },
    "/agents/{agent_id}/state": {
      "get": {
        "description": "Return the current bootstrap snapshot for an agent.",
        "operationId": "agentState",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            },
            "style": "simple"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Agent state snapshot",
        "tags": [
          "agents"
        ],
        "x-holon-openapi-source": "aide::axum::ApiRouter::api_route_docs"
      }
    },
    "/agents/{agent_id}/status": {
      "get": {
        "description": "Return the public AgentSummary read model.",
        "operationId": "agentStatus",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            },
            "style": "simple"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Agent status",
        "tags": [
          "agents"
        ],
        "x-holon-openapi-source": "aide::axum::ApiRouter::api_route_docs"
      }
    },
    "/agents/{agent_id}/tasks": {
      "get": {
        "description": "Return active task records. Query parameter: limit.",
        "operationId": "agentTasks",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List active tasks",
        "tags": [
          "tasks"
        ]
      }
    },
    "/agents/{agent_id}/tasks/{task_id}": {
      "get": {
        "description": "Return a task lifecycle snapshot by id.",
        "operationId": "agentTaskStatus",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Task id.",
            "in": "path",
            "name": "task_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskStatusSnapshot"
                }
              }
            },
            "description": "Successful JSON response using a stable DTO schema."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Task status",
        "tags": [
          "tasks"
        ]
      }
    },
    "/agents/{agent_id}/tasks/{task_id}/output": {
      "get": {
        "description": "Return a task output snapshot. Query parameters: block, timeout_ms.",
        "operationId": "agentTaskOutput",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Task id.",
            "in": "path",
            "name": "task_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskOutputResult"
                }
              }
            },
            "description": "Successful JSON response using a stable DTO schema."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Task output",
        "tags": [
          "tasks"
        ]
      }
    },
    "/agents/{agent_id}/timers": {
      "get": {
        "description": "Return recent timer records. Query parameter: limit.",
        "operationId": "agentTimers",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List timers",
        "tags": [
          "timers"
        ]
      }
    },
    "/agents/{agent_id}/timers/{timer_id}": {
      "get": {
        "description": "Return a timer record by id.",
        "operationId": "agentTimer",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Timer id.",
            "in": "path",
            "name": "timer_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Timer detail",
        "tags": [
          "timers"
        ]
      }
    },
    "/agents/{agent_id}/transcript": {
      "get": {
        "description": "Return recent transcript entries. Query parameter: limit.",
        "operationId": "agentTranscript",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            },
            "style": "simple"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Recent transcript",
        "tags": [
          "agents"
        ],
        "x-holon-openapi-source": "aide::axum::ApiRouter::api_route_docs"
      }
    },
    "/agents/{agent_id}/work-items": {
      "get": {
        "description": "Return latest work item records for the agent. Query parameter: limit.",
        "operationId": "agentWorkItems",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List work items",
        "tags": [
          "work-items"
        ]
      }
    },
    "/agents/{agent_id}/work-items/{work_item_id}": {
      "get": {
        "description": "Return a work item record by id.",
        "operationId": "agentWorkItem",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Work item id.",
            "in": "path",
            "name": "work_item_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Work item detail",
        "tags": [
          "work-items"
        ]
      }
    },
    "/agents/{agent_id}/worktree-summary": {
      "get": {
        "description": "Return managed worktree summary for an agent.",
        "operationId": "agentWorktreeSummary",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            },
            "style": "simple"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Worktree summary",
        "tags": [
          "agents"
        ],
        "x-holon-openapi-source": "aide::axum::ApiRouter::api_route_docs"
      }
    },
    "/briefs": {
      "get": {
        "description": "Compatibility alias for the default agent briefs route. Query parameter: limit.",
        "operationId": "defaultBriefs",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Default agent briefs alias",
        "tags": [
          "compat"
        ],
        "x-holon-openapi-source": "aide::axum::ApiRouter::api_route_docs"
      }
    },
    "/callbacks/enqueue/{callback_token}": {
      "post": {
        "description": "Capability-token callback ingress for enqueue delivery. The token is a secret path segment and examples intentionally use a placeholder.",
        "operationId": "callbackEnqueue",
        "parameters": [
          {
            "description": "Opaque callback capability token. This is a secret and must not be exposed in examples.",
            "in": "path",
            "name": "callback_token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CallbackBody"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "CallbackToken": []
          }
        ],
        "summary": "Callback enqueue ingress",
        "tags": [
          "callbacks"
        ]
      }
    },
    "/callbacks/wake/{callback_token}": {
      "post": {
        "description": "Capability-token callback ingress for wake delivery. The token is a secret path segment and examples intentionally use a placeholder.",
        "operationId": "callbackWake",
        "parameters": [
          {
            "description": "Opaque callback capability token. This is a secret and must not be exposed in examples.",
            "in": "path",
            "name": "callback_token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CallbackBody"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "CallbackToken": []
          }
        ],
        "summary": "Callback wake ingress",
        "tags": [
          "callbacks"
        ]
      }
    },
    "/control/agents/{agent_id}/control": {
      "post": {
        "description": "Submit a lifecycle control action.",
        "operationId": "controlAgent",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ControlRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Control agent lifecycle",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/create": {
      "post": {
        "description": "Create a public named agent, optionally from a template.",
        "operationId": "createAgent",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAgentRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create named agent",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/current-run/abort": {
      "post": {
        "description": "Request abort for the current agent run.",
        "operationId": "abortCurrentRun",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AbortCurrentRunRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Abort current run",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/debug-prompt": {
      "post": {
        "description": "Render a diagnostic prompt preview.",
        "operationId": "debugPrompt",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DebugPromptRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Debug prompt",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/model": {
      "post": {
        "description": "Set an agent model override and optional reasoning effort.",
        "operationId": "setAgentModel",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetAgentModelRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Set agent model override",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/model/clear": {
      "post": {
        "description": "Clear an agent model override.",
        "operationId": "clearAgentModel",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ClearAgentModelRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Clear agent model override",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/operator-bindings": {
      "post": {
        "description": "Create or update a remote operator transport binding.",
        "operationId": "createOperatorTransportBinding",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OperatorTransportBindingRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create operator binding",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/operator-ingress": {
      "post": {
        "description": "Deliver an authenticated remote operator prompt.",
        "operationId": "operatorIngress",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OperatorIngressRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Operator ingress",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/prompt": {
      "post": {
        "description": "Submit a trusted operator prompt through the control plane.",
        "operationId": "controlPrompt",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ControlPromptRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Submit operator prompt",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/skills/install": {
      "post": {
        "description": "Install an agent skill.",
        "operationId": "installSkill",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InstallSkillRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Install skill",
        "tags": [
          "skills"
        ]
      }
    },
    "/control/agents/{agent_id}/skills/uninstall": {
      "post": {
        "description": "Uninstall an agent skill.",
        "operationId": "uninstallSkill",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UninstallSkillRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Uninstall skill",
        "tags": [
          "skills"
        ]
      }
    },
    "/control/agents/{agent_id}/tasks": {
      "post": {
        "description": "Schedule a command task for an agent.",
        "operationId": "createCommandTask",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCommandTaskRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create command task",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/tasks/{task_id}/input": {
      "post": {
        "description": "Deliver text input to a managed task.",
        "operationId": "taskInput",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Task id.",
            "in": "path",
            "name": "task_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TaskInputRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskInputResult"
                }
              }
            },
            "description": "Successful JSON response using a stable DTO schema."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Task input",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/tasks/{task_id}/stop": {
      "post": {
        "description": "Request cancellation for a managed task.",
        "operationId": "taskStop",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Task id.",
            "in": "path",
            "name": "task_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TaskStopRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskStopResult"
                }
              }
            },
            "description": "Successful JSON response using a stable DTO schema."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Task stop",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/timers": {
      "post": {
        "description": "Schedule a timer for an agent.",
        "operationId": "createTimer",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateTimerRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TimerRecord"
                }
              }
            },
            "description": "Successful JSON response using a stable DTO schema."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create timer",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/timers/{timer_id}/cancel": {
      "post": {
        "description": "Cancel an active timer. Cancellation is idempotent for already-cancelled timers; completed or missing timers return a shared error envelope.",
        "operationId": "cancelTimer",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Timer id.",
            "in": "path",
            "name": "timer_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CancelTimerRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TimerRecord"
                }
              }
            },
            "description": "Successful JSON response using a stable DTO schema."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Cancel timer",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/wake": {
      "post": {
        "description": "Submit a trusted wake hint.",
        "operationId": "controlWake",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ControlWakeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Wake agent",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/work-items": {
      "post": {
        "description": "Create or enqueue a public work item objective.",
        "operationId": "createWorkItem",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWorkItemRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkItemRecord"
                }
              }
            },
            "description": "Successful JSON response using a stable DTO schema."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Create work item",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/work-items/{work_item_id}": {
      "patch": {
        "description": "Mutate work item objective, plan status, todo list, or blocker fields.",
        "operationId": "updateWorkItem",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Work item id.",
            "in": "path",
            "name": "work_item_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateWorkItemRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkItemRecord"
                }
              }
            },
            "description": "Successful JSON response using a stable DTO schema."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Update work item",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/work-items/{work_item_id}/complete": {
      "post": {
        "description": "Mark an open work item completed.",
        "operationId": "completeWorkItem",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Work item id.",
            "in": "path",
            "name": "work_item_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CompleteWorkItemRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkItemRecord"
                }
              }
            },
            "description": "Successful JSON response using a stable DTO schema."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Complete work item",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/work-items/{work_item_id}/pick": {
      "post": {
        "description": "Make an existing open work item the current focus for the agent.",
        "operationId": "pickWorkItem",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Work item id.",
            "in": "path",
            "name": "work_item_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PickWorkItemRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PickWorkItemResponse"
                }
              }
            },
            "description": "Successful JSON response using a stable DTO schema."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Pick work item",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/workspace/attach": {
      "post": {
        "description": "Attach a workspace path to an agent.",
        "operationId": "attachWorkspace",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AttachWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Attach workspace",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/workspace/detach": {
      "post": {
        "description": "Detach a workspace binding by workspace id.",
        "operationId": "detachWorkspace",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DetachWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Detach workspace",
        "tags": [
          "control"
        ]
      }
    },
    "/control/agents/{agent_id}/workspace/exit": {
      "post": {
        "description": "Return an agent to its default AgentHome workspace.",
        "operationId": "exitWorkspace",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExitWorkspaceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Exit workspace",
        "tags": [
          "control"
        ]
      }
    },
    "/control/runtime/readiness": {
      "get": {
        "description": "Return daemon readiness metadata.",
        "operationId": "runtimeReadiness",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Runtime readiness",
        "tags": [
          "runtime"
        ]
      }
    },
    "/control/runtime/shutdown": {
      "post": {
        "description": "Request graceful runtime shutdown.",
        "operationId": "runtimeShutdown",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Runtime shutdown",
        "tags": [
          "runtime"
        ]
      }
    },
    "/control/runtime/status": {
      "get": {
        "description": "Return daemon status and runtime activity metadata.",
        "operationId": "runtimeStatus",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Runtime status",
        "tags": [
          "runtime"
        ]
      }
    },
    "/enqueue": {
      "post": {
        "description": "Enqueue a public channel/webhook message for the default agent.",
        "operationId": "enqueueDefault",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnqueueRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Enqueue default agent message",
        "tags": [
          "ingress"
        ]
      }
    },
    "/handshake": {
      "get": {
        "description": "Return auth mode, protocol version, capabilities, and runtime hints.",
        "operationId": "handshake",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Protocol handshake",
        "tags": [
          "discovery"
        ]
      }
    },
    "/models": {
      "get": {
        "description": "Return model catalog entries and runtime availability.",
        "operationId": "models",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "List available models",
        "tags": [
          "discovery"
        ]
      }
    },
    "/state": {
      "get": {
        "description": "Compatibility alias for the default agent state route.",
        "operationId": "defaultState",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Default agent state alias",
        "tags": [
          "compat"
        ],
        "x-holon-openapi-source": "aide::axum::ApiRouter::api_route_docs"
      }
    },
    "/status": {
      "get": {
        "description": "Compatibility alias for the default agent status route.",
        "operationId": "defaultStatus",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Default agent status alias",
        "tags": [
          "compat"
        ],
        "x-holon-openapi-source": "aide::axum::ApiRouter::api_route_docs"
      }
    },
    "/transcript": {
      "get": {
        "description": "Compatibility alias for the default agent transcript route. Query parameter: limit.",
        "operationId": "defaultTranscript",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Default agent transcript alias",
        "tags": [
          "compat"
        ],
        "x-holon-openapi-source": "aide::axum::ApiRouter::api_route_docs"
      }
    },
    "/webhooks/generic/{agent_id}": {
      "post": {
        "description": "Convert an arbitrary JSON webhook body into a trusted integration message.",
        "operationId": "genericWebhook",
        "parameters": [
          {
            "description": "Agent id.",
            "in": "path",
            "name": "agent_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenericJsonPayload"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "summary": "Generic webhook",
        "tags": [
          "ingress"
        ]
      }
    },
    "/worktree-summary": {
      "get": {
        "description": "Compatibility alias for the default agent worktree summary route.",
        "operationId": "defaultWorktreeSummary",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonValue"
                }
              }
            },
            "description": "Successful JSON response. Baseline schema is intentionally loose until per-route response DTO contracts are stabilized."
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Client error JSON response."
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server error JSON response."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Default agent worktree summary alias",
        "tags": [
          "compat"
        ],
        "x-holon-openapi-source": "aide::axum::ApiRouter::api_route_docs"
      }
    }
  },
  "servers": [
    {
      "description": "Local runtime; port is configurable.",
      "url": "http://127.0.0.1:7878"
    }
  ],
  "tags": [
    {
      "name": "discovery"
    },
    {
      "name": "agents"
    },
    {
      "name": "events"
    },
    {
      "name": "ingress"
    },
    {
      "name": "control"
    },
    {
      "name": "runtime"
    },
    {
      "name": "tasks"
    },
    {
      "name": "work-items"
    },
    {
      "name": "timers"
    },
    {
      "name": "skills"
    },
    {
      "description": "Capability-token callback ingress. Never publish real callback_token values.",
      "name": "callbacks"
    },
    {
      "name": "compat"
    }
  ]
}