@soat/cli 0.15.9 → 0.15.11

package/dist/index.mjs

@@ -13,7 +13,7 @@ import { load } from "js-yaml";
 import * as os from "node:os";
 
 //#region package.json
-var version = "0.15.9";
+var version = "0.15.11";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -343,6 +343,7 @@ var routes = {
     operationId: "listActors",
     description: "Returns all actors the caller has access to. If projectId is provided, returns only actors in that project. project keys are scoped to a single project automatically. JWT users without projectId receive actors across all their accessible projects.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/actors",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id", "external_id", "agent_id", "chat_id", "conversation_id", "limit", "offset"],
     flags: [{
@@ -394,6 +395,7 @@ var routes = {
     operationId: "createActor",
     description: "Creates a new actor. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/actors",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -451,6 +453,7 @@ var routes = {
     operationId: "getActor",
     description: "Returns an actor by its ID",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/actors",
+    httpMethod: "get",
     pathParams: ["actor_id"],
     queryParams: [],
     flags: [{
@@ -466,6 +469,7 @@ var routes = {
     operationId: "updateActor",
     description: "Updates an actor's properties",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/actors",
+    httpMethod: "patch",
     pathParams: ["actor_id"],
     queryParams: [],
     flags: [{
@@ -523,6 +527,7 @@ var routes = {
     operationId: "deleteActor",
     description: "Deletes an actor by its ID",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/actors",
+    httpMethod: "delete",
     pathParams: ["actor_id"],
     queryParams: [],
     flags: [{
@@ -538,6 +543,7 @@ var routes = {
     operationId: "getActorTags",
     description: "Returns all tags attached to the actor",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/actors",
+    httpMethod: "get",
     pathParams: ["actor_id"],
     queryParams: [],
     flags: [{
@@ -553,6 +559,7 @@ var routes = {
     operationId: "replaceActorTags",
     description: "Replaces all tags on the actor with the provided tags (not merged)",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/actors",
+    httpMethod: "put",
     pathParams: ["actor_id"],
     queryParams: [],
     flags: [{
@@ -568,6 +575,7 @@ var routes = {
     operationId: "mergeActorTags",
     description: "Merges provided tags with existing tags (existing tags are preserved unless overridden)",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/actors",
+    httpMethod: "patch",
     pathParams: ["actor_id"],
     queryParams: [],
     flags: [{
@@ -583,6 +591,7 @@ var routes = {
     operationId: "listAgents",
     description: "Returns all agents in the project.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id"],
     flags: [{
@@ -598,6 +607,7 @@ var routes = {
     operationId: "createAgent",
     description: "Creates a new agent bound to an AI provider.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -672,6 +682,12 @@ var routes = {
       "required": false,
       "type": "array",
       "in": "body"
+    }, {
+      "name": "guardrail_ids",
+      "description": "Guardrails attached at the agent scope.",
+      "required": false,
+      "type": "array",
+      "in": "body"
     }, {
       "name": "step_rules",
       "description": "",
@@ -721,6 +737,7 @@ var routes = {
     operationId: "getAgent",
     description: "Returns a single agent by ID.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
+    httpMethod: "get",
     pathParams: ["agent_id"],
     queryParams: [],
     flags: [{
@@ -736,6 +753,7 @@ var routes = {
     operationId: "updateAgent",
     description: "Updates an existing agent. Identical to PATCH — both perform partial updates.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
+    httpMethod: "put",
     pathParams: ["agent_id"],
     queryParams: [],
     flags: [{
@@ -776,7 +794,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "tool_ids",
-      "description": "Deprecated shorthand — replaces only the reference (`tool_id`) bindings, rewriting them bare (any `approval_policy` on them is dropped). Use `tool_bindings` instead.",
+      "description": "Deprecated shorthand — replaces only the reference (`tool_id`) bindings, rewriting them bare. Use `tool_bindings` instead.",
       "required": false,
       "type": "array",
       "in": "body"
@@ -810,6 +828,12 @@ var routes = {
       "required": false,
       "type": "array",
       "in": "body"
+    }, {
+      "name": "guardrail_ids",
+      "description": "Guardrails attached at the agent scope.",
+      "required": false,
+      "type": "array",
+      "in": "body"
     }, {
       "name": "step_rules",
       "description": "",
@@ -859,6 +883,7 @@ var routes = {
     operationId: "patchAgent",
     description: "Partially updates an existing agent. Identical to PUT — both perform partial updates.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
+    httpMethod: "patch",
     pathParams: ["agent_id"],
     queryParams: [],
     flags: [{
@@ -899,7 +924,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "tool_ids",
-      "description": "Deprecated shorthand — replaces only the reference (`tool_id`) bindings, rewriting them bare (any `approval_policy` on them is dropped). Use `tool_bindings` instead.",
+      "description": "Deprecated shorthand — replaces only the reference (`tool_id`) bindings, rewriting them bare. Use `tool_bindings` instead.",
       "required": false,
       "type": "array",
       "in": "body"
@@ -933,6 +958,12 @@ var routes = {
       "required": false,
       "type": "array",
       "in": "body"
+    }, {
+      "name": "guardrail_ids",
+      "description": "Guardrails attached at the agent scope.",
+      "required": false,
+      "type": "array",
+      "in": "body"
     }, {
       "name": "step_rules",
       "description": "",
@@ -982,6 +1013,7 @@ var routes = {
     operationId: "deleteAgent",
     description: "Deletes an agent by ID. Fails with `409` if the agent has dependent generations or traces, unless `force=true` is passed, in which case those generations and traces are deleted along with the agent.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
+    httpMethod: "delete",
     pathParams: ["agent_id"],
     queryParams: ["force"],
     flags: [{
@@ -1003,6 +1035,7 @@ var routes = {
     operationId: "createAgentGeneration",
     description: "Sends messages to the agent, resolves its tools, and runs the AI model loop. Supports streaming via `stream: true`. Client tools pause the generation and return `requires_action`.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
+    httpMethod: "post",
     pathParams: ["agent_id"],
     queryParams: [],
     flags: [{
@@ -1059,6 +1092,12 @@ var routes = {
       "required": false,
       "type": "string",
       "in": "body"
+    }, {
+      "name": "guardrail_context",
+      "description": "Caller-supplied guardrail context (the `context.*` namespace guard and class expressions read at tool-dispatch time). Free-form and never interpreted by the platform; a guardrail may combine it with a `context_tool` per its `context_mode`. See the guardrails module.",
+      "required": false,
+      "type": "object",
+      "in": "body"
     }, {
       "name": "metadata",
       "description": "Caller-supplied key/value metadata attached to the generation record for per-run audit attribution (e.g. the knowledge-corpus version that produced this action). Round-trips when the generation is fetched via the generations API. Reserved server-owned keys (`action_id`, `trigger_id`, `run_id`, `node_id`, `extraction`, and internal recovery state) cannot be set here and are rejected with 400.",
@@ -1084,6 +1123,7 @@ var routes = {
     operationId: "submitAgentToolOutputs",
     description: "Resumes a generation that was paused due to client tool calls. Provide tool outputs for each pending tool call.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
+    httpMethod: "post",
     pathParams: ["agent_id", "generation_id"],
     queryParams: [],
     flags: [{
@@ -1111,6 +1151,7 @@ var routes = {
     operationId: "listAiProviders",
     description: "Returns a list of AI provider configurations for a project",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/ai-providers",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id", "limit", "offset"],
     flags: [{
@@ -1138,6 +1179,7 @@ var routes = {
     operationId: "createAiProvider",
     description: "Creates a new LLM provider configuration",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/ai-providers",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -1189,6 +1231,7 @@ var routes = {
     operationId: "getAiProvider",
     description: "Returns a specific AI provider configuration",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/ai-providers",
+    httpMethod: "get",
     pathParams: ["ai_provider_id"],
     queryParams: [],
     flags: [{
@@ -1204,6 +1247,7 @@ var routes = {
     operationId: "updateAiProvider",
     description: "Updates an AI provider configuration",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/ai-providers",
+    httpMethod: "patch",
     pathParams: ["ai_provider_id"],
     queryParams: [],
     flags: [{
@@ -1253,16 +1297,23 @@ var routes = {
   "delete-ai-provider": {
     serviceClass: "AIProviders",
     operationId: "deleteAiProvider",
-    description: "Deletes an AI provider configuration",
+    description: "Deletes an AI provider configuration. Live references — chats, agents, and discussions that use this provider — always block deletion with `409 AI_PROVIDER_HAS_DEPENDENTS`; `force` does not override them, so delete or repoint those resources first. Soft dependents — price overrides, usage/generation records, and discussion participants — also block with `409` unless `force=true`, which deletes the provider's price overrides and unlinks (nulls) its usage and participant history, preserving those rows. The `409` body's `error.meta` reports the counts, a sample of offending IDs, and a `forcible` flag that is `true` when a `force=true` retry would succeed.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/ai-providers",
+    httpMethod: "delete",
     pathParams: ["ai_provider_id"],
-    queryParams: [],
+    queryParams: ["force"],
     flags: [{
       "name": "ai_provider_id",
       "description": "AI Provider ID",
       "required": true,
       "type": "string",
       "in": "path"
+    }, {
+      "name": "force",
+      "description": "When `true`, delete the provider's price overrides and unlink its usage/participant history so a provider with only soft dependents can be removed. Has no effect on live references (chats, agents, discussions), which always block deletion.\n",
+      "required": false,
+      "type": "boolean",
+      "in": "query"
     }]
   },
   "get-ai-provider-prices": {
@@ -1270,6 +1321,7 @@ var routes = {
     operationId: "getAiProviderPrices",
     description: "Returns the per-provider price overrides for this AI provider instance. An override prices this specific provider (e.g. an enterprise-negotiated rate or a gateway with markup) and wins over the global default at cost time. Authorized by the caller's access to the provider's project — so, unlike the global price book, a project's own overrides are visible here.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/ai-providers",
+    httpMethod: "get",
     pathParams: ["ai_provider_id"],
     queryParams: [],
     flags: [{
@@ -1285,6 +1337,7 @@ var routes = {
     operationId: "updateAiProviderPrices",
     description: "Upserts price overrides for this AI provider instance, keyed on (model, effective_from). The provider slug is taken from the AI provider itself, so only the model, rates, and effective_from are supplied. Authorized by the caller's access to the provider's project. `effective_from` must be in the future — past prices are immutable, so ship corrections as new future-dated rows.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/ai-providers",
+    httpMethod: "put",
     pathParams: ["ai_provider_id"],
     queryParams: [],
     flags: [{
@@ -1306,6 +1359,7 @@ var routes = {
     operationId: "listApiKeys",
     description: "Lists API keys accessible to the caller. - JWT admin: returns all API keys. - JWT regular user: returns only the user's own API keys. - API key: returns only API keys scoped to the key's project.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/api-keys",
+    httpMethod: "get",
     pathParams: [],
     queryParams: [],
     flags: []
@@ -1315,6 +1369,7 @@ var routes = {
     operationId: "createApiKey",
     description: "Creates a new API key for the authenticated user. - `project_id` is optional. When set, the key is scoped to that single project. When omitted or null, the key is **unscoped** and spans every project its owner can reach. - If `policy_ids` is provided, the key's effective permissions are the intersection of the user's policies and the key's policies. - Otherwise the key inherits the user's permissions (confined to the key's project when scoped).",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/api-keys",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -1342,6 +1397,7 @@ var routes = {
     operationId: "getApiKey",
     description: "Returns details of an API key. Only the owner or an admin can access it.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/api-keys",
+    httpMethod: "get",
     pathParams: ["api_key_id"],
     queryParams: [],
     flags: [{
@@ -1357,6 +1413,7 @@ var routes = {
     operationId: "updateApiKey",
     description: "Updates an API key's name, project scope, or policies. The project scope can be changed to another project, set (scoping a previously unscoped key), or cleared with null (unscoping the key). Only the owner or an admin can update it.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/api-keys",
+    httpMethod: "put",
     pathParams: ["api_key_id"],
     queryParams: [],
     flags: [{
@@ -1390,6 +1447,7 @@ var routes = {
     operationId: "deleteApiKey",
     description: "Deletes an API key. Only the owner or an admin can delete it.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/api-keys",
+    httpMethod: "delete",
     pathParams: ["api_key_id"],
     queryParams: [],
     flags: [{
@@ -1405,6 +1463,7 @@ var routes = {
     operationId: "listApprovals",
     description: "Returns approval items for a project, filterable by status, origin, and expiry.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/approvals",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id", "status", "origin", "expires_before"],
     flags: [{
@@ -1438,6 +1497,7 @@ var routes = {
     operationId: "getApproval",
     description: "Returns a single approval item with its full evidence.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/approvals",
+    httpMethod: "get",
     pathParams: ["approval_id"],
     queryParams: [],
     flags: [{
@@ -1453,6 +1513,7 @@ var routes = {
     operationId: "approveApproval",
     description: "Approves the item. Optionally supply edited `arguments` to replace the proposed arguments (edit-then-approve); the original is preserved on the item. Expiry is re-checked at decision time — an expired item can never be approved.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/approvals",
+    httpMethod: "post",
     pathParams: ["approval_id"],
     queryParams: [],
     flags: [{
@@ -1474,6 +1535,7 @@ var routes = {
     operationId: "rejectApproval",
     description: "Rejects the item. A reason is required and preserved on the item.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/approvals",
+    httpMethod: "post",
     pathParams: ["approval_id"],
     queryParams: [],
     flags: [{
@@ -1495,6 +1557,7 @@ var routes = {
     operationId: "listChats",
     description: "Returns all chats in the project.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/chats",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id"],
     flags: [{
@@ -1510,6 +1573,7 @@ var routes = {
     operationId: "createChat",
     description: "Creates a new chat resource bound to an AI provider.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/chats",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -1549,6 +1613,7 @@ var routes = {
     operationId: "getChat",
     description: "Returns a single chat by ID.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/chats",
+    httpMethod: "get",
     pathParams: ["chat_id"],
     queryParams: [],
     flags: [{
@@ -1564,6 +1629,7 @@ var routes = {
     operationId: "deleteChat",
     description: "Deletes a chat by ID.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/chats",
+    httpMethod: "delete",
     pathParams: ["chat_id"],
     queryParams: [],
     flags: [{
@@ -1579,6 +1645,7 @@ var routes = {
     operationId: "createChatCompletionForChat",
     description: "Runs a completion using the AI provider and settings stored in the chat. Pass `stream: true` for SSE streaming. A system message in `messages` overrides the chat's stored system message for this call only. Messages may use `documentId` instead of `content`.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/chats",
+    httpMethod: "post",
     pathParams: ["chat_id"],
     queryParams: [],
     flags: [{
@@ -1612,6 +1679,7 @@ var routes = {
     operationId: "createChatCompletion",
     description: "OpenAI Chat Completions-compatible endpoint. Mirrors OpenAI's `POST /v1/chat/completions` path so an OpenAI SDK can target it by base URL alone. Resolves the AI provider from `ai_provider_id`, decrypts its secret, and calls the appropriate Vercel AI SDK provider. `ai_provider_id` is required — there is no server-side model fallback.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/chats",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -1645,6 +1713,7 @@ var routes = {
     operationId: "listConversations",
     description: "Returns all conversations the caller has access to. If projectId is provided, returns only conversations in that project. project keys are scoped to a single project automatically.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/conversations",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id", "actor_id", "limit", "offset"],
     flags: [{
@@ -1678,6 +1747,7 @@ var routes = {
     operationId: "createConversation",
     description: "Creates a new conversation. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/conversations",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -1711,6 +1781,7 @@ var routes = {
     operationId: "getConversation",
     description: "Returns a conversation by its ID",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/conversations",
+    httpMethod: "get",
     pathParams: ["conversation_id"],
     queryParams: [],
     flags: [{
@@ -1726,6 +1797,7 @@ var routes = {
     operationId: "updateConversation",
     description: "Updates the status of a conversation",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/conversations",
+    httpMethod: "patch",
     pathParams: ["conversation_id"],
     queryParams: [],
     flags: [{
@@ -1753,6 +1825,7 @@ var routes = {
     operationId: "deleteConversation",
     description: "Deletes a conversation by its ID",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/conversations",
+    httpMethod: "delete",
     pathParams: ["conversation_id"],
     queryParams: [],
     flags: [{
@@ -1768,6 +1841,7 @@ var routes = {
     operationId: "listConversationMessages",
     description: "Returns all messages (documents) attached to a conversation, ordered by position",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/conversations",
+    httpMethod: "get",
     pathParams: ["conversation_id"],
     queryParams: ["limit", "offset"],
     flags: [{
@@ -1795,6 +1869,7 @@ var routes = {
     operationId: "addConversationMessage",
     description: "Creates a document from the message text and attaches it to the conversation at the given position. If position is omitted, it is appended at the end.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/conversations",
+    httpMethod: "post",
     pathParams: ["conversation_id"],
     queryParams: [],
     flags: [{
@@ -1840,6 +1915,7 @@ var routes = {
     operationId: "generateConversationMessage",
     description: "Generates the next message using the specified actor's linked agent or chat. On `completed`, the reply is persisted as a new ConversationMessage authored by that actor. On `requires_action`, nothing is persisted; the caller must submit tool outputs via the Agents module and re-invoke generate.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/conversations",
+    httpMethod: "post",
     pathParams: ["conversation_id"],
     queryParams: [],
     flags: [{
@@ -1879,6 +1955,7 @@ var routes = {
     operationId: "removeConversationMessage",
     description: "Removes a document from a conversation",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/conversations",
+    httpMethod: "delete",
     pathParams: ["conversation_id", "document_id"],
     queryParams: [],
     flags: [{
@@ -1900,6 +1977,7 @@ var routes = {
     operationId: "getConversationTags",
     description: "Returns all tags attached to the conversation",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/conversations",
+    httpMethod: "get",
     pathParams: ["conversation_id"],
     queryParams: [],
     flags: [{
@@ -1915,6 +1993,7 @@ var routes = {
     operationId: "replaceConversationTags",
     description: "Replaces all tags on the conversation with the provided tags",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/conversations",
+    httpMethod: "put",
     pathParams: ["conversation_id"],
     queryParams: [],
     flags: [{
@@ -1930,6 +2009,7 @@ var routes = {
     operationId: "mergeConversationTags",
     description: "Merges provided tags with existing tags",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/conversations",
+    httpMethod: "patch",
     pathParams: ["conversation_id"],
     queryParams: [],
     flags: [{
@@ -1945,6 +2025,7 @@ var routes = {
     operationId: "listDiscussions",
     description: "Returns all discussions the caller has access to. If project_id is provided, returns only discussions in that project.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/discussions",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id", "limit", "offset"],
     flags: [{
@@ -1972,6 +2053,7 @@ var routes = {
     operationId: "createDiscussion",
     description: "Creates a new discussion config. project keys infer the project from the key's scope; JWT callers must supply project_id.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/discussions",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -2035,6 +2117,7 @@ var routes = {
     operationId: "getDiscussionRun",
     description: "Returns a single discussion run, including its outcome, transcript conversation, and outcome document.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/discussions",
+    httpMethod: "get",
     pathParams: ["run_id"],
     queryParams: [],
     flags: [{
@@ -2050,6 +2133,7 @@ var routes = {
     operationId: "getDiscussion",
     description: "Returns a discussion config with its participants.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/discussions",
+    httpMethod: "get",
     pathParams: ["discussion_id"],
     queryParams: [],
     flags: [{
@@ -2065,6 +2149,7 @@ var routes = {
     operationId: "updateDiscussion",
     description: "Updates a discussion. Providing participants replaces the full set (not merged).",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/discussions",
+    httpMethod: "patch",
     pathParams: ["discussion_id"],
     queryParams: [],
     flags: [{
@@ -2128,6 +2213,7 @@ var routes = {
     operationId: "deleteDiscussion",
     description: "Deletes a discussion config and its participants.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/discussions",
+    httpMethod: "delete",
     pathParams: ["discussion_id"],
     queryParams: [],
     flags: [{
@@ -2143,6 +2229,7 @@ var routes = {
     operationId: "listDiscussionRuns",
     description: "Returns the run history of a discussion, most recent first.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/discussions",
+    httpMethod: "get",
     pathParams: ["discussion_id"],
     queryParams: ["limit", "offset"],
     flags: [{
@@ -2170,6 +2257,7 @@ var routes = {
     operationId: "createDiscussionRun",
     description: "Runs the discussion synchronously over the given topic and returns the completed run, whose outcome inlines the synthesized text. The run's transcript is persisted as a conversation and the outcome as a document.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/discussions",
+    httpMethod: "post",
     pathParams: ["discussion_id"],
     queryParams: [],
     flags: [{
@@ -2191,6 +2279,7 @@ var routes = {
     operationId: "listDocuments",
     description: "Returns all documents the caller has access to. If projectId is provided, returns only documents in that project. project keys are scoped to a single project automatically. JWT users without projectId receive documents across all their accessible projects.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/documents",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id", "limit", "offset"],
     flags: [{
@@ -2218,6 +2307,7 @@ var routes = {
     operationId: "createDocument",
     description: "Creates a new text document and generates an embedding vector for semantic search. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/documents",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -2287,6 +2377,7 @@ var routes = {
     operationId: "ingestDocument",
     description: "Parses an already-uploaded file and creates one Document split into one or more embedded chunks. The source format is detected from the file's content type: PDFs are parsed page-by-page; `text/plain` and `text/markdown` files are read as a single source. How the source is chunked is controlled by `chunk_strategy`.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/documents",
+    httpMethod: "post",
     pathParams: [],
     queryParams: ["async"],
     flags: [{
@@ -2344,6 +2435,7 @@ var routes = {
     operationId: "getDocument",
     description: "Returns a document with its text content",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/documents",
+    httpMethod: "get",
     pathParams: ["document_id"],
     queryParams: [],
     flags: [{
@@ -2359,6 +2451,7 @@ var routes = {
     operationId: "updateDocument",
     description: "Updates document content, title, path, metadata, or tags. Supplying `path` moves the document to a new logical path within the project.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/documents",
+    httpMethod: "patch",
     pathParams: ["document_id"],
     queryParams: [],
     flags: [{
@@ -2404,6 +2497,7 @@ var routes = {
     operationId: "deleteDocument",
     description: "Deletes a document and its underlying file",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/documents",
+    httpMethod: "delete",
     pathParams: ["document_id"],
     queryParams: [],
     flags: [{
@@ -2419,6 +2513,7 @@ var routes = {
     operationId: "getDocumentStatus",
     description: "Returns a lightweight ingestion status payload for polling — `status`, `chunk_count`, `total_pages`, and (when failed) `error`. Unlike `GET /documents/{document_id}`, it never returns the assembled chunk content, so it is cheap to poll on large documents. A document whose ingestion has stalled (no progress past the configured timeout) is transitioned to `failed` with `error=INGESTION_TIMEOUT` on read.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/documents",
+    httpMethod: "get",
     pathParams: ["document_id"],
     queryParams: [],
     flags: [{
@@ -2434,6 +2529,7 @@ var routes = {
     operationId: "reingestDocument",
     description: "Re-runs ingestion for an existing document against its already-stored source file. Existing chunks are discarded and the document is reset to `status=pending` before re-processing. Use this to recover a document stuck in `processing`/`failed` or to re-chunk with a different strategy without re-uploading the file. Async by default (`202`); pass `?async=false` to run synchronously (`201`).",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/documents",
+    httpMethod: "post",
     pathParams: ["document_id"],
     queryParams: ["async"],
     flags: [{
@@ -2473,6 +2569,7 @@ var routes = {
     operationId: "completeIngestionCallback",
     description: "Token-authed callback for a tool converter that deferred conversion by returning `{ \"status\": \"pending\" }` (see the Ingestion Rules module docs). Not IAM-gated — the external converter is not a SOAT principal, so it authenticates with the single-use token minted for this document and ingestion attempt (delivered as `callback.token` / embedded in `callback.url` in the original converter invocation). Accepted only while the document is still awaiting that exact attempt; rejected with `409` if the attempt already completed, timed out, or was superseded by a re-ingest.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/documents",
+    httpMethod: "post",
     pathParams: ["document_id"],
     queryParams: ["token"],
     flags: [{
@@ -2506,6 +2603,7 @@ var routes = {
     operationId: "getDocumentTags",
     description: "Returns all tags attached to the document",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/documents",
+    httpMethod: "get",
     pathParams: ["document_id"],
     queryParams: [],
     flags: [{
@@ -2521,6 +2619,7 @@ var routes = {
     operationId: "replaceDocumentTags",
     description: "Replaces all tags on the document with the provided tags (not merged)",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/documents",
+    httpMethod: "put",
     pathParams: ["document_id"],
     queryParams: [],
     flags: [{
@@ -2536,6 +2635,7 @@ var routes = {
     operationId: "mergeDocumentTags",
     description: "Merges provided tags with existing tags (existing tags are preserved unless overridden)",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/documents",
+    httpMethod: "patch",
     pathParams: ["document_id"],
     queryParams: [],
     flags: [{
@@ -2551,6 +2651,7 @@ var routes = {
     operationId: "createEmbeddings",
     description: "Generates embedding vectors for one or more text inputs using the server's configured embedding model. Provide `input` for a single text or `inputs` for a batch. At least one is required. Returns `embedding` when `input` is used, and `embeddings` when `inputs` is used.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/embeddings",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -2572,6 +2673,7 @@ var routes = {
     operationId: "listFiles",
     description: "Returns a list of all stored files",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id", "limit", "offset"],
     flags: [{
@@ -2599,6 +2701,7 @@ var routes = {
     operationId: "createFile",
     description: "Creates a new file record in the system",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -2644,6 +2747,7 @@ var routes = {
     operationId: "uploadFile",
     description: "Uploads a file to the server and stores it in the configured storage directory",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: []
@@ -2653,6 +2757,7 @@ var routes = {
     operationId: "uploadFileBase64",
     description: "Uploads a file to the server using base64-encoded content",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -2698,6 +2803,7 @@ var routes = {
     operationId: "createPresignedUrl",
     description: "Creates a short-lived, single-use presigned upload URL — the local-storage equivalent of an S3 presigned URL. The client then uploads the file content directly to the returned `upload_url` via `POST /api/v1/files/upload/{token}`, bypassing MCP payload size limits. When the server is configured with `SOAT_BASE_URL`, `upload_url` is a fully-qualified absolute URL so MCP agents and other clients can POST to it without knowing the server base URL in advance.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -2731,6 +2837,7 @@ var routes = {
     operationId: "uploadFileWithToken",
     description: "Uploads file content authorized by a single-use token from `POST /api/v1/files/presigned-url`. No bearer credential is required — the token is the credential. Accepts either multipart/form-data (field `file`) or JSON with a base64-encoded `content` field.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    httpMethod: "post",
     pathParams: ["token"],
     queryParams: [],
     flags: [{
@@ -2770,6 +2877,7 @@ var routes = {
     operationId: "getFile",
     description: "Returns the data and metadata of a specific file",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    httpMethod: "get",
     pathParams: ["file_id"],
     queryParams: [],
     flags: [{
@@ -2785,6 +2893,7 @@ var routes = {
     operationId: "deleteFile",
     description: "Removes a file from the system by ID",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    httpMethod: "delete",
     pathParams: ["file_id"],
     queryParams: [],
     flags: [{
@@ -2800,6 +2909,7 @@ var routes = {
     operationId: "downloadFile",
     description: "Streams the file content to the client",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    httpMethod: "get",
     pathParams: ["file_id"],
     queryParams: [],
     flags: [{
@@ -2815,6 +2925,7 @@ var routes = {
     operationId: "updateFileMetadata",
     description: "Updates the metadata field of a file",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    httpMethod: "patch",
     pathParams: ["file_id"],
     queryParams: [],
     flags: [{
@@ -2848,6 +2959,7 @@ var routes = {
     operationId: "downloadFileBase64",
     description: "Returns the file content encoded as base64",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    httpMethod: "get",
     pathParams: ["file_id"],
     queryParams: [],
     flags: [{
@@ -2863,6 +2975,7 @@ var routes = {
     operationId: "getFileTags",
     description: "Returns all tags attached to the file",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    httpMethod: "get",
     pathParams: ["file_id"],
     queryParams: [],
     flags: [{
@@ -2878,6 +2991,7 @@ var routes = {
     operationId: "replaceFileTags",
     description: "Replaces all tags on the file with the provided tags",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    httpMethod: "put",
     pathParams: ["file_id"],
     queryParams: [],
     flags: [{
@@ -2893,6 +3007,7 @@ var routes = {
     operationId: "mergeFileTags",
     description: "Merges provided tags with existing tags",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    httpMethod: "patch",
     pathParams: ["file_id"],
     queryParams: [],
     flags: [{
@@ -2908,6 +3023,7 @@ var routes = {
     operationId: "validateFormation",
     description: "Validates a formation template without creating any resources. Returns a list of errors and warnings. Accepts the template as a JSON object or as a YAML/JSON string.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/formations",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -2929,6 +3045,7 @@ var routes = {
     operationId: "planFormation",
     description: "Computes a diff between the desired template and the current stack state without making any changes. Returns the list of planned actions.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/formations",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -2962,6 +3079,7 @@ var routes = {
     operationId: "listFormations",
     description: "Returns all formation stacks for a project",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/formations",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id"],
     flags: [{
@@ -2977,6 +3095,7 @@ var routes = {
     operationId: "createFormation",
     description: "Validates the template, creates the formation record, then provisions all declared resources in dependency order.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/formations",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -3016,6 +3135,7 @@ var routes = {
     operationId: "getFormation",
     description: "Returns the formation stack including its current resources.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/formations",
+    httpMethod: "get",
     pathParams: ["formation_id"],
     queryParams: [],
     flags: [{
@@ -3031,6 +3151,7 @@ var routes = {
     operationId: "updateFormation",
     description: "Applies a new template to the formation. Resources are created, updated, or deleted to reconcile the current state with the desired state.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/formations",
+    httpMethod: "put",
     pathParams: ["formation_id"],
     queryParams: [],
     flags: [{
@@ -3064,6 +3185,7 @@ var routes = {
     operationId: "deleteFormation",
     description: "Deletes the formation stack and all its managed resources in reverse dependency order.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/formations",
+    httpMethod: "delete",
     pathParams: ["formation_id"],
     queryParams: [],
     flags: [{
@@ -3079,6 +3201,7 @@ var routes = {
     operationId: "listFormationEvents",
     description: "Returns all operations (create, update, delete) with their event logs for the formation, ordered chronologically.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/formations",
+    httpMethod: "get",
     pathParams: ["formation_id"],
     queryParams: [],
     flags: [{
@@ -3094,6 +3217,7 @@ var routes = {
     operationId: "listGenerations",
     description: "Returns generations the caller can access, optionally filtered by agent, trace, and status. Replaces the former per-trace generations endpoint (use the trace_id query filter).",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/generations",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["agent_id", "trace_id", "initiator_generation_id", "status", "limit", "offset"],
     flags: [{
@@ -3139,6 +3263,7 @@ var routes = {
     operationId: "getGeneration",
     description: "Returns a single generation record by ID, including its status and the structured `error` payload when the generation failed (e.g. because the upstream AI provider returned an error).",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/generations",
+    httpMethod: "get",
     pathParams: ["generation_id"],
     queryParams: [],
     flags: [{
@@ -3154,6 +3279,7 @@ var routes = {
     operationId: "updateGeneration",
     description: "Attaches caller-supplied key/value metadata to a generation record for per-run audit attribution (e.g. recording which knowledge-corpus version produced an AI action). The provided keys are shallow-merged over the existing metadata, so repeated patches accumulate and system-owned keys are preserved. Reserved keys (`action_id`, `trigger_id`, `run_id`, `node_id`, `extraction`, and internal recovery state) cannot be set and are rejected with 400.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/generations",
+    httpMethod: "patch",
     pathParams: ["generation_id"],
     queryParams: [],
     flags: [{
@@ -3170,11 +3296,208 @@ var routes = {
       "in": "body"
     }]
   },
+  "list-guardrails": {
+    serviceClass: "Guardrails",
+    operationId: "listGuardrails",
+    description: "Returns all guardrails in the project.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/guardrails",
+    httpMethod: "get",
+    pathParams: [],
+    queryParams: ["project_id"],
+    flags: [{
+      "name": "project_id",
+      "description": "Project public ID to filter by",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }]
+  },
+  "create-guardrail": {
+    serviceClass: "Guardrails",
+    operationId: "createGuardrail",
+    description: "Creates a new guardrail in the project. The `document` is validated on write: `class` must be a literal (A/B/C/D) or a JSON Logic expression, and every variable it (and `guard`) reference must resolve to the `args.*` / `context.*` / `soat.*` namespaces — an out-of-catalog `soat.*` key is rejected with 400.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/guardrails",
+    httpMethod: "post",
+    pathParams: [],
+    queryParams: [],
+    flags: [{
+      "name": "project_id",
+      "description": "Public ID of the project",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "name",
+      "description": "Human-readable name",
+      "required": true,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "description",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "document",
+      "description": "The action-class document. `class` maps a call to an action class; `guard` gates class-B autonomy. Both are single JSON Logic expressions over the `args.*` / `context.*` / `soat.*` namespaces.\n",
+      "required": true,
+      "type": "object",
+      "in": "body"
+    }, {
+      "name": "context_tool_id",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "context_mode",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }]
+  },
+  "get-guardrail": {
+    serviceClass: "Guardrails",
+    operationId: "getGuardrail",
+    description: "Returns a single guardrail by ID.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/guardrails",
+    httpMethod: "get",
+    pathParams: ["guardrail_id"],
+    queryParams: [],
+    flags: [{
+      "name": "guardrail_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
+  "update-guardrail": {
+    serviceClass: "Guardrails",
+    operationId: "updateGuardrail",
+    description: "Updates an existing guardrail. A `document` write increments `version` and archives the prior document as a GuardrailVersion; metadata-only edits (name / description / context) leave the version untouched.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/guardrails",
+    httpMethod: "patch",
+    pathParams: ["guardrail_id"],
+    queryParams: [],
+    flags: [{
+      "name": "guardrail_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "name",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "description",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "document",
+      "description": "The action-class document. `class` maps a call to an action class; `guard` gates class-B autonomy. Both are single JSON Logic expressions over the `args.*` / `context.*` / `soat.*` namespaces.\n",
+      "required": false,
+      "type": "object",
+      "in": "body"
+    }, {
+      "name": "context_tool_id",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "context_mode",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }]
+  },
+  "delete-guardrail": {
+    serviceClass: "Guardrails",
+    operationId: "deleteGuardrail",
+    description: "Deletes a guardrail and its archived versions by ID.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/guardrails",
+    httpMethod: "delete",
+    pathParams: ["guardrail_id"],
+    queryParams: [],
+    flags: [{
+      "name": "guardrail_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
+  "get-guardrail-version": {
+    serviceClass: "Guardrails",
+    operationId: "getGuardrailVersion",
+    description: "Returns the exact `document` that governed at a given version. Approval items, activity entries, and exceptions record the version that governed them, so the audit chain survives edits.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/guardrails",
+    httpMethod: "get",
+    pathParams: ["guardrail_id", "version"],
+    queryParams: [],
+    flags: [{
+      "name": "guardrail_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "version",
+      "description": "",
+      "required": true,
+      "type": "integer",
+      "in": "path"
+    }]
+  },
+  "evaluate-guardrail": {
+    serviceClass: "Guardrails",
+    operationId: "evaluateGuardrail",
+    description: "Runs the full evaluation pipeline — the `class` expression, the guard, the context tool per `context_mode`, live `soat.*` resolution — against caller-supplied `args` and `guardrail_context`, and returns the exact `guardrail_evaluation` record a real call would produce. Nothing executes, no approval item is filed, and no activity entry is written. This is the adoption path: preview a document's decisions against production-shaped calls before attaching it — or before editing a widely-attached one. Pass an optional `tool_id` to resolve `soat.tool.*`.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/guardrails",
+    httpMethod: "post",
+    pathParams: ["guardrail_id"],
+    queryParams: [],
+    flags: [{
+      "name": "guardrail_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "args",
+      "description": "The proposed call's arguments (the `args.*` namespace).",
+      "required": false,
+      "type": "object",
+      "in": "body"
+    }, {
+      "name": "guardrail_context",
+      "description": "The caller-supplied guardrail context (the `context.*` namespace), combined with the context tool per `context_mode`.\n",
+      "required": false,
+      "type": "object",
+      "in": "body"
+    }, {
+      "name": "tool_id",
+      "description": "Optional tool to resolve `soat.tool.*` against.",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }]
+  },
   "list-ingestion-rules": {
     serviceClass: "IngestionRules",
     operationId: "listIngestionRules",
     description: "Returns the ingestion rules for a project",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/ingestion-rules",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id", "limit", "offset"],
     flags: [{
@@ -3202,6 +3525,7 @@ var routes = {
     operationId: "createIngestionRule",
     description: "Creates a rule mapping a content_type glob to a converter. Exactly one of tool_id or agent_id must be set.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/ingestion-rules",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -3283,6 +3607,7 @@ var routes = {
     operationId: "getIngestionRule",
     description: "Returns a specific ingestion rule",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/ingestion-rules",
+    httpMethod: "get",
     pathParams: ["ingestion_rule_id"],
     queryParams: [],
     flags: [{
@@ -3298,6 +3623,7 @@ var routes = {
     operationId: "updateIngestionRule",
     description: "Updates fields of an ingestion rule",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/ingestion-rules",
+    httpMethod: "patch",
     pathParams: ["ingestion_rule_id"],
     queryParams: [],
     flags: [{
@@ -3379,6 +3705,7 @@ var routes = {
     operationId: "deleteIngestionRule",
     description: "Deletes an ingestion rule",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/ingestion-rules",
+    httpMethod: "delete",
     pathParams: ["ingestion_rule_id"],
     queryParams: [],
     flags: [{
@@ -3394,6 +3721,7 @@ var routes = {
     operationId: "searchKnowledge",
     description: "Searches across documents and memory entries using semantic search, file paths, document IDs, or memory IDs/tags. At least one of `query`, `document_paths`, `document_ids`, `memory_ids`, or `memory_tags` must be provided.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/knowledge",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -3451,6 +3779,7 @@ var routes = {
     operationId: "listMemories",
     description: "Returns a list of memory configurations for a project",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memories",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id", "tags"],
     flags: [{
@@ -3472,6 +3801,7 @@ var routes = {
     operationId: "createMemory",
     description: "Creates a new memory configuration in a project",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memories",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -3505,6 +3835,7 @@ var routes = {
     operationId: "getMemory",
     description: "Returns a single memory configuration by ID",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memories",
+    httpMethod: "get",
     pathParams: ["memory_id"],
     queryParams: [],
     flags: [{
@@ -3520,6 +3851,7 @@ var routes = {
     operationId: "updateMemory",
     description: "Updates an existing memory configuration",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memories",
+    httpMethod: "put",
     pathParams: ["memory_id"],
     queryParams: [],
     flags: [{
@@ -3553,6 +3885,7 @@ var routes = {
     operationId: "deleteMemory",
     description: "Deletes a memory configuration",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memories",
+    httpMethod: "delete",
     pathParams: ["memory_id"],
     queryParams: [],
     flags: [{
@@ -3568,6 +3901,7 @@ var routes = {
     operationId: "listMemoryEntries",
     description: "Returns all entries in a memory container",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memoryEntries",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["memory_id"],
     flags: [{
@@ -3583,6 +3917,7 @@ var routes = {
     operationId: "createMemoryEntry",
     description: "Creates a new entry in the specified memory container. Automatically generates an embedding for semantic search.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memoryEntries",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -3634,6 +3969,7 @@ var routes = {
     operationId: "getMemoryEntry",
     description: "Returns a single memory entry by ID",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memoryEntries",
+    httpMethod: "get",
     pathParams: ["entry_id"],
     queryParams: [],
     flags: [{
@@ -3649,6 +3985,7 @@ var routes = {
     operationId: "updateMemoryEntry",
     description: "Updates an existing memory entry. Regenerates the embedding if content changes.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memoryEntries",
+    httpMethod: "put",
     pathParams: ["entry_id"],
     queryParams: [],
     flags: [{
@@ -3682,6 +4019,7 @@ var routes = {
     operationId: "deleteMemoryEntry",
     description: "Deletes a memory entry",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memoryEntries",
+    httpMethod: "delete",
     pathParams: ["entry_id"],
     queryParams: [],
     flags: [{
@@ -3697,6 +4035,7 @@ var routes = {
     operationId: "listOrchestrations",
     description: "Returns orchestrations accessible to the caller.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id"],
     flags: [{
@@ -3712,6 +4051,7 @@ var routes = {
     operationId: "createOrchestration",
     description: "Creates a new orchestration (pipeline) definition in the project.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -3763,6 +4103,7 @@ var routes = {
     operationId: "validateOrchestration",
     description: "Statically validates an orchestration graph without persisting anything. Checks that every node has its required field, node ids are unique, edges reference existing nodes, the graph is acyclic (unless it contains a loop node), and every `input_mapping` `{\"var\": \"...\"}` reference resolves to a state key written by an upstream node or seeded by `input_schema`. Returns blocking `errors` and non-blocking `warnings` (e.g. a state key only written on a conditional branch). The same `errors` checks are enforced on create and update, which fail with `400` when any error is present.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -3790,6 +4131,7 @@ var routes = {
     operationId: "getOrchestration",
     description: "Returns the orchestration with nodes and edges.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
+    httpMethod: "get",
     pathParams: ["orchestration_id"],
     queryParams: [],
     flags: [{
@@ -3805,6 +4147,7 @@ var routes = {
     operationId: "updateOrchestration",
     description: "Partially updates an orchestration definition.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
+    httpMethod: "patch",
     pathParams: ["orchestration_id"],
     queryParams: [],
     flags: [{
@@ -3856,6 +4199,7 @@ var routes = {
     operationId: "deleteOrchestration",
     description: "Deletes an orchestration definition and all its runs.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
+    httpMethod: "delete",
     pathParams: ["orchestration_id"],
     queryParams: [],
     flags: [{
@@ -3871,6 +4215,7 @@ var routes = {
     operationId: "listOrchestrationRuns",
     description: "Returns orchestration runs the caller can access, optionally filtered by orchestration.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["orchestration_id"],
     flags: [{
@@ -3886,6 +4231,7 @@ var routes = {
     operationId: "startOrchestrationRun",
     description: "Creates a new run for the orchestration named by orchestration_id. By default the run executes durably in the background: the response returns immediately with status \"running\" and progress is observed via get-orchestration-run or run lifecycle webhook events (orchestration_runs.started/awaiting_input/succeeded/failed). Delay and poll waits park the run as \"sleeping\" and are woken by a background scheduler, surviving restarts. Pass wait=true to block until the run reaches a terminal or awaiting_input state (the legacy synchronous behaviour).",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -3913,6 +4259,7 @@ var routes = {
     operationId: "cancelOrchestrationRun",
     description: "Cancels a run that has not yet reached a terminal state.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
+    httpMethod: "post",
     pathParams: ["run_id"],
     queryParams: [],
     flags: [{
@@ -3928,6 +4275,7 @@ var routes = {
     operationId: "submitHumanInput",
     description: "Provides human input to a run that is awaiting_input at a human node.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
+    httpMethod: "post",
     pathParams: ["run_id"],
     queryParams: [],
     flags: [{
@@ -3955,6 +4303,7 @@ var routes = {
     operationId: "resumeOrchestrationRun",
     description: "Resumes an awaiting_input orchestration run from its last checkpoint.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
+    httpMethod: "post",
     pathParams: ["run_id"],
     queryParams: [],
     flags: [{
@@ -3970,6 +4319,7 @@ var routes = {
     operationId: "getOrchestrationRun",
     description: "Returns the status, state, and artifacts of a specific run.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
+    httpMethod: "get",
     pathParams: ["run_id"],
     queryParams: [],
     flags: [{
@@ -3985,6 +4335,7 @@ var routes = {
     operationId: "listPolicies",
     description: "Returns global policies. Requires admin role. Pass user_id to list only the policies attached to that user (replaces the former per-user policies endpoint).",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/policies",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["user_id"],
     flags: [{
@@ -4000,6 +4351,7 @@ var routes = {
     operationId: "createPolicy",
     description: "Creates a new global policy. Requires admin role.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/policies",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -4027,6 +4379,7 @@ var routes = {
     operationId: "getPolicy",
     description: "Returns details of a specific policy. Requires admin role.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/policies",
+    httpMethod: "get",
     pathParams: ["policy_id"],
     queryParams: [],
     flags: [{
@@ -4042,6 +4395,7 @@ var routes = {
     operationId: "updatePolicy",
     description: "Updates an existing global policy. Requires admin role.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/policies",
+    httpMethod: "put",
     pathParams: ["policy_id"],
     queryParams: [],
     flags: [{
@@ -4075,6 +4429,7 @@ var routes = {
     operationId: "deletePolicy",
     description: "Deletes a global policy. Requires admin role.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/policies",
+    httpMethod: "delete",
     pathParams: ["policy_id"],
     queryParams: [],
     flags: [{
@@ -4090,6 +4445,7 @@ var routes = {
     operationId: "listProjects",
     description: "Lists projects accessible to the caller. - JWT admin: returns all projects. - JWT regular user: returns only projects granted by the user's policies. - API key scoped to a project: returns only that project.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/projects",
+    httpMethod: "get",
     pathParams: [],
     queryParams: [],
     flags: []
@@ -4099,6 +4455,7 @@ var routes = {
     operationId: "createProject",
     description: "Creates a new project. Requires admin role.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/projects",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -4114,6 +4471,7 @@ var routes = {
     operationId: "getProject",
     description: "Returns details of a specific project.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/projects",
+    httpMethod: "get",
     pathParams: ["project_id"],
     queryParams: [],
     flags: [{
@@ -4127,8 +4485,9 @@ var routes = {
   "update-project": {
     serviceClass: "Projects",
     operationId: "updateProject",
-    description: "Updates a project's name. Requires admin role.",
+    description: "Updates a project's name and/or its attached guardrails (`guardrail_ids` — the project-scope baseline governing every tool call by every agent in the project). Requires admin role. Detaching a guardrail (removing an id) additionally requires guardrails:DetachGuardrail.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/projects",
+    httpMethod: "patch",
     pathParams: ["project_id"],
     queryParams: [],
     flags: [{
@@ -4140,9 +4499,15 @@ var routes = {
     }, {
       "name": "name",
       "description": "",
-      "required": true,
+      "required": false,
       "type": "string",
       "in": "body"
+    }, {
+      "name": "guardrail_ids",
+      "description": "Guardrails attached at the project scope.",
+      "required": false,
+      "type": "array",
+      "in": "body"
     }]
   },
   "delete-project": {
@@ -4150,6 +4515,7 @@ var routes = {
     operationId: "deleteProject",
     description: "Deletes a project. Requires admin role. Fails with `409` if the project has any dependent resources (agents, ai providers, tools, conversations, chats, formations, memories, actors, webhooks, secrets, sessions, files, traces, generations, orchestrations, etc.), unless `force=true` is passed, in which case those resources are deleted along with the project.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/projects",
+    httpMethod: "delete",
     pathParams: ["project_id"],
     queryParams: ["force"],
     flags: [{
@@ -4171,6 +4537,7 @@ var routes = {
     operationId: "getProjectPrices",
     description: "Returns the project's per-provider-slug price rows — the middle pricing tier that covers every one of the project's instances of a given provider slug. At cost time a per-provider-instance override wins over these, and these win over the global default. Authorized by the caller's access to the project.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/projects",
+    httpMethod: "get",
     pathParams: ["project_id"],
     queryParams: [],
     flags: [{
@@ -4186,6 +4553,7 @@ var routes = {
     operationId: "updateProjectPrices",
     description: "Upserts project + provider-slug price rows, keyed on (provider, model, effective_from). A row covers all of the project's instances of that provider slug. Authorized by the caller's access to the project. `effective_from` must be in the future — past prices are immutable, so ship corrections as new future-dated rows.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/projects",
+    httpMethod: "put",
     pathParams: ["project_id"],
     queryParams: [],
     flags: [{
@@ -4207,6 +4575,7 @@ var routes = {
     operationId: "listSecrets",
     description: "Returns a list of secrets for a project",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/secrets",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id", "limit", "offset"],
     flags: [{
@@ -4234,6 +4603,7 @@ var routes = {
     operationId: "createSecret",
     description: "Creates a new encrypted secret in a project",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/secrets",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -4261,6 +4631,7 @@ var routes = {
     operationId: "getSecret",
     description: "Returns a specific secret",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/secrets",
+    httpMethod: "get",
     pathParams: ["secret_id"],
     queryParams: [],
     flags: [{
@@ -4276,6 +4647,7 @@ var routes = {
     operationId: "updateSecret",
     description: "Updates a secret's name and/or value",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/secrets",
+    httpMethod: "patch",
     pathParams: ["secret_id"],
     queryParams: [],
     flags: [{
@@ -4303,6 +4675,7 @@ var routes = {
     operationId: "deleteSecret",
     description: "Deletes a secret",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/secrets",
+    httpMethod: "delete",
     pathParams: ["secret_id"],
     queryParams: [],
     flags: [{
@@ -4318,6 +4691,7 @@ var routes = {
     operationId: "listSessions",
     description: "Returns sessions the caller can access, optionally filtered by agent, actor and status.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/sessions",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["agent_id", "actor_id", "status", "limit", "offset"],
     flags: [{
@@ -4357,6 +4731,7 @@ var routes = {
     operationId: "createSession",
     description: "Creates a new session for the specified agent. Internally creates a conversation and two actors (agent + user) so the caller only needs this single call to start interacting with the agent.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/sessions",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -4408,6 +4783,7 @@ var routes = {
     operationId: "getSession",
     description: "Returns details of a single session.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/sessions",
+    httpMethod: "get",
     pathParams: ["session_id"],
     queryParams: [],
     flags: [{
@@ -4423,6 +4799,7 @@ var routes = {
     operationId: "updateSession",
     description: "Updates the session name and/or status.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/sessions",
+    httpMethod: "patch",
     pathParams: ["session_id"],
     queryParams: [],
     flags: [{
@@ -4474,6 +4851,7 @@ var routes = {
     operationId: "deleteSession",
     description: "Deletes the session and its underlying conversation and messages. The session's actor is not deleted. Generations and traces produced by the session are not deleted either, since they are not linked to the session or conversation.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/sessions",
+    httpMethod: "delete",
     pathParams: ["session_id"],
     queryParams: [],
     flags: [{
@@ -4489,6 +4867,7 @@ var routes = {
     operationId: "addSessionMessage",
     description: "Saves a user message to the session. When autoGenerate is enabled on the session and no generation is currently in progress, generation is triggered automatically and the response mirrors GenerateSessionResponse. Otherwise returns the saved user message.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/sessions",
+    httpMethod: "post",
     pathParams: ["session_id"],
     queryParams: [],
     flags: [{
@@ -4528,6 +4907,7 @@ var routes = {
     operationId: "generateSessionResponse",
     description: "Triggers the agent to generate a response based on the current conversation. Returns the assistant reply or a requires_action status if the agent needs client tool outputs. Pass ?async=true for a 202 accepted response when you do not need to wait for the result.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/sessions",
+    httpMethod: "post",
     pathParams: ["session_id"],
     queryParams: ["async"],
     flags: [{
@@ -4561,6 +4941,7 @@ var routes = {
     operationId: "submitSessionToolOutputs",
     description: "Submits client tool outputs for a generation that returned requires_action. The agent continues its loop and returns the final or next requires_action result.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/sessions",
+    httpMethod: "post",
     pathParams: ["session_id"],
     queryParams: [],
     flags: [{
@@ -4588,6 +4969,7 @@ var routes = {
     operationId: "getSessionTags",
     description: "Returns the session's tags object.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/sessions",
+    httpMethod: "get",
     pathParams: ["session_id"],
     queryParams: [],
     flags: [{
@@ -4603,6 +4985,7 @@ var routes = {
     operationId: "replaceSessionTags",
     description: "Replaces all tags on the session.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/sessions",
+    httpMethod: "put",
     pathParams: ["session_id"],
     queryParams: [],
     flags: [{
@@ -4618,6 +5001,7 @@ var routes = {
     operationId: "mergeSessionTags",
     description: "Merges the provided tags into the session's existing tags.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/sessions",
+    httpMethod: "patch",
     pathParams: ["session_id"],
     queryParams: [],
     flags: [{
@@ -4633,6 +5017,7 @@ var routes = {
     operationId: "listTasks",
     description: "Lists tasks (the board query). Filter by workflow, state, status, or assignee — `GET /tasks?workflow_id=...&state=...` is one board column.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tasks",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id", "workflow_id", "state", "status", "assignee"],
     flags: [{
@@ -4672,6 +5057,7 @@ var routes = {
     operationId: "createTask",
     description: "Creates a task bound to a workflow. The task is placed in the workflow's initial state and that state's `on_enter` automation fires.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tasks",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -4711,6 +5097,7 @@ var routes = {
     operationId: "getTask",
     description: "Retrieves a task, including its active dispatch and automation status.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tasks",
+    httpMethod: "get",
     pathParams: ["task_id"],
     queryParams: [],
     flags: [{
@@ -4724,8 +5111,9 @@ var routes = {
   "update-task": {
     serviceClass: "Tasks",
     operationId: "updateTask",
-    description: "Updates a task's payload, title, or assignee. `state` is never directly writable — move it with a transition. `payload` is shallow-merged over the existing payload (PATCH semantics): keys the request omits are preserved, so setting one field never discards values an on_enter automation wrote (e.g. `last_result`). The merged payload is validated against the workflow's `payload_schema`.",
+    description: "Updates a task's payload, title, or assignee. `state` is never directly writable — move it with a transition; sending a `state` field is rejected as an unknown field (`VALIDATION_FAILED`). `payload` is shallow-merged over the existing payload (PATCH semantics): keys the request omits are preserved, so setting one field never discards values an on_enter automation wrote (e.g. `last_result`). The merged payload is validated against the workflow's `payload_schema`.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tasks",
+    httpMethod: "patch",
     pathParams: ["task_id"],
     queryParams: [],
     flags: [{
@@ -4759,6 +5147,7 @@ var routes = {
     operationId: "deleteTask",
     description: "Deletes a task. Its transition history cascades.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tasks",
+    httpMethod: "delete",
     pathParams: ["task_id"],
     queryParams: [],
     flags: [{
@@ -4772,8 +5161,9 @@ var routes = {
   "transition-task": {
     serviceClass: "Tasks",
     operationId: "transitionTask",
-    description: "Fires a named transition on a task. The transition must exist in the workflow and be valid from the task's current state; its guard must pass. This is the single path every state change routes through.",
+    description: "Fires a named transition on a task. The transition must exist in the workflow and be valid from the task's current state; its guard must pass. This is the single path every state change routes through. A transition declaring `requires_approval` does not move the task — it parks a pending ApprovalItem and returns the task with `pending_transition` set; the move applies only when the approval is approved.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tasks",
+    httpMethod: "post",
     pathParams: ["task_id"],
     queryParams: [],
     flags: [{
@@ -4801,6 +5191,7 @@ var routes = {
     operationId: "getTaskHistory",
     description: "Returns the append-only transition history of a task.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tasks",
+    httpMethod: "get",
     pathParams: ["task_id"],
     queryParams: [],
     flags: [{
@@ -4816,6 +5207,7 @@ var routes = {
     operationId: "listTools",
     description: "Returns all tools in the project.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tools",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id"],
     flags: [{
@@ -4831,6 +5223,7 @@ var routes = {
     operationId: "createTool",
     description: "Creates a new tool in the project.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tools",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -4911,6 +5304,12 @@ var routes = {
       "required": false,
       "type": "object",
       "in": "body"
+    }, {
+      "name": "guardrail_ids",
+      "description": "Guardrails attached at the tool scope.",
+      "required": false,
+      "type": "array",
+      "in": "body"
     }]
   },
   "get-tool": {
@@ -4918,6 +5317,7 @@ var routes = {
     operationId: "getTool",
     description: "Returns a single tool by ID.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tools",
+    httpMethod: "get",
     pathParams: ["tool_id"],
     queryParams: [],
     flags: [{
@@ -4933,6 +5333,7 @@ var routes = {
     operationId: "updateTool",
     description: "Updates an existing tool.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tools",
+    httpMethod: "patch",
     pathParams: ["tool_id"],
     queryParams: [],
     flags: [{
@@ -5013,6 +5414,12 @@ var routes = {
       "required": false,
       "type": "object",
       "in": "body"
+    }, {
+      "name": "guardrail_ids",
+      "description": "Guardrails attached at the tool scope.",
+      "required": false,
+      "type": "array",
+      "in": "body"
     }]
   },
   "delete-tool": {
@@ -5020,6 +5427,7 @@ var routes = {
     operationId: "deleteTool",
     description: "Deletes a tool by ID.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tools",
+    httpMethod: "delete",
     pathParams: ["tool_id"],
     queryParams: [],
     flags: [{
@@ -5035,6 +5443,7 @@ var routes = {
     operationId: "callTool",
     description: "Directly invokes a tool and returns its output. Supported for `http`, `soat`, `mcp`, and `pipeline` tools. `client` tools cannot be invoked server-side and will return 422. A `pipeline` tool runs its declared steps in order and returns the mapped `output` (or the last step's output); `action` is ignored and `input` is the pipeline input. For `soat` and `mcp` tools the `action` field is required and identifies which action (SOAT) or tool name (MCP) to invoke. For `http` tools `action` is ignored. When a `soat` or `mcp` tool declares an `actions` allowlist, an action outside it is rejected with `400 VALIDATION_FAILED` (\"not available on this tool\") before any outbound request is made. `preset_parameters` stored on the tool are merged with the caller-supplied `input` before execution; preset keys take lower precedence.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tools",
+    httpMethod: "post",
     pathParams: ["tool_id"],
     queryParams: [],
     flags: [{
@@ -5062,6 +5471,7 @@ var routes = {
     operationId: "listTraces",
     description: "Returns a paginated list of execution traces for the project.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/traces",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id", "limit", "offset"],
     flags: [{
@@ -5089,6 +5499,7 @@ var routes = {
     operationId: "getTrace",
     description: "Returns a single trace by ID.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/traces",
+    httpMethod: "get",
     pathParams: ["trace_id"],
     queryParams: [],
     flags: [{
@@ -5104,6 +5515,7 @@ var routes = {
     operationId: "getTraceTree",
     description: "Returns the full execution tree rooted at the given trace (or its root if the given trace is a child). Each node represents one agent's execution session. The `children` array contains traces triggered by sub-agent tool calls from that trace.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/traces",
+    httpMethod: "get",
     pathParams: ["trace_id"],
     queryParams: ["include"],
     flags: [{
@@ -5125,6 +5537,7 @@ var routes = {
     operationId: "listTriggers",
     description: "Lists triggers. Filter by project, starter type, or target type.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id", "type", "target_type"],
     flags: [{
@@ -5152,6 +5565,7 @@ var routes = {
     operationId: "createTrigger",
     description: "Creates a new trigger for a project",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -5227,6 +5641,7 @@ var routes = {
     operationId: "getTrigger",
     description: "Retrieves the details of a specific trigger",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    httpMethod: "get",
     pathParams: ["trigger_id"],
     queryParams: [],
     flags: [{
@@ -5242,6 +5657,7 @@ var routes = {
     operationId: "updateTrigger",
     description: "Updates an existing trigger's configuration. The type is immutable.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    httpMethod: "patch",
     pathParams: ["trigger_id"],
     queryParams: [],
     flags: [{
@@ -5311,6 +5727,7 @@ var routes = {
     operationId: "deleteTrigger",
     description: "Deletes a trigger",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    httpMethod: "delete",
     pathParams: ["trigger_id"],
     queryParams: [],
     flags: [{
@@ -5326,6 +5743,7 @@ var routes = {
     operationId: "fireTrigger",
     description: "Fires a trigger synchronously and returns the terminal firing record.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    httpMethod: "post",
     pathParams: ["trigger_id"],
     queryParams: [],
     flags: [{
@@ -5347,6 +5765,7 @@ var routes = {
     operationId: "getTriggerSecret",
     description: "Retrieves the signing secret for a webhook trigger",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    httpMethod: "get",
     pathParams: ["trigger_id"],
     queryParams: [],
     flags: [{
@@ -5362,6 +5781,7 @@ var routes = {
     operationId: "rotateTriggerSecret",
     description: "Rotates the signing secret for a webhook trigger",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    httpMethod: "post",
     pathParams: ["trigger_id"],
     queryParams: [],
     flags: [{
@@ -5377,6 +5797,7 @@ var routes = {
     operationId: "listTriggerFirings",
     description: "Lists firings for a trigger (trigger_id is required).",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["trigger_id", "limit", "offset"],
     flags: [{
@@ -5404,6 +5825,7 @@ var routes = {
     operationId: "getTriggerFiring",
     description: "Retrieves the details of a specific trigger firing",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    httpMethod: "get",
     pathParams: ["firing_id"],
     queryParams: [],
     flags: [{
@@ -5419,6 +5841,7 @@ var routes = {
     operationId: "listUsageMeters",
     description: "Returns the raw usage-meter rows the caller can access, most recent first, optionally filtered by agent and generation. Each row is the per-generation token usage as reported by the provider, for audit and reconciliation.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["agent_id", "generation_id", "trace_id", "trigger_id", "action_id", "meter_type", "limit", "offset"],
     flags: [{
@@ -5476,6 +5899,7 @@ var routes = {
     operationId: "getUsage",
     description: "Returns a project's usage rolled up over an optional `[from, to]` time window, bucketed by a single dimension. Each group and the grand total carry summed token counts and `cost_usd` (null when no event in the bucket was priced). This is the per-project cost-by-range/by-category query — a monthly figure without scanning raw meter rows client-side.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id", "group_by", "from", "to"],
     flags: [{
@@ -5509,6 +5933,7 @@ var routes = {
     operationId: "listUsageThresholds",
     description: "Lists the usage alert thresholds the caller can access, optionally filtered by project_id. Each threshold fires the `usage.threshold_crossed` webhook when a project's cost or token usage over a calendar-month or rolling-24h window crosses the configured value.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id"],
     flags: [{
@@ -5524,6 +5949,7 @@ var routes = {
     operationId: "createUsageThreshold",
     description: "Creates a usage alert threshold on a project. Thresholds are immutable apart from deletion — to change one, delete and recreate it (which resets its fire state).",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -5557,6 +5983,7 @@ var routes = {
     operationId: "deleteUsageThreshold",
     description: "Deletes a usage threshold, resetting its fire state. Recreating a threshold starts its once-per-window / hysteresis state fresh.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
+    httpMethod: "delete",
     pathParams: ["threshold_id"],
     queryParams: [],
     flags: [{
@@ -5572,6 +5999,7 @@ var routes = {
     operationId: "getUsageReceipt",
     description: "Returns a billing receipt. Pass generation_id for a per-generation receipt, or run_id for a per-run receipt summed across the orchestration run's meters — both share the same shape (per-model line items with tokens, the price-book version that priced them, and cost, plus totals). Exactly one of generation_id or run_id must be supplied.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["generation_id", "run_id"],
     flags: [{
@@ -5593,6 +6021,7 @@ var routes = {
     operationId: "getPriceBook",
     description: "Returns the global price book — the versioned per-provider/model unit prices used to compute usage cost at write time. Readable by any authenticated user.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
+    httpMethod: "get",
     pathParams: [],
     queryParams: [],
     flags: []
@@ -5602,6 +6031,7 @@ var routes = {
     operationId: "upsertPriceBook",
     description: "Upserts price rows keyed on (provider, model, effective_from). Admin only. `effective_from` must be in the future — past prices are immutable so recorded costs stay explainable; ship corrections as new future-dated rows.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
+    httpMethod: "put",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -5617,6 +6047,7 @@ var routes = {
     operationId: "getCurrentUser",
     description: "Returns the profile of the currently authenticated user",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/users",
+    httpMethod: "get",
     pathParams: [],
     queryParams: [],
     flags: []
@@ -5626,6 +6057,7 @@ var routes = {
     operationId: "listUsers",
     description: "Returns a list of all users",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/users",
+    httpMethod: "get",
     pathParams: [],
     queryParams: [],
     flags: []
@@ -5635,6 +6067,7 @@ var routes = {
     operationId: "createUser",
     description: "Creates a new user in the system",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/users",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -5662,6 +6095,7 @@ var routes = {
     operationId: "getUser",
     description: "Returns the data of a specific user",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/users",
+    httpMethod: "get",
     pathParams: ["user_id"],
     queryParams: [],
     flags: [{
@@ -5677,6 +6111,7 @@ var routes = {
     operationId: "deleteUser",
     description: "Deletes a specific user",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/users",
+    httpMethod: "delete",
     pathParams: ["user_id"],
     queryParams: [],
     flags: [{
@@ -5692,6 +6127,7 @@ var routes = {
     operationId: "bootstrapUser",
     description: "Creates the first admin user. Returns 409 if any user already exists.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/users",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -5713,6 +6149,7 @@ var routes = {
     operationId: "loginUser",
     description: "Authenticates a user and returns a JWT token",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/users",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -5734,6 +6171,7 @@ var routes = {
     operationId: "attachUserPolicies",
     description: "Replaces the user's policy list with the provided policy IDs. Requires admin role.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/users",
+    httpMethod: "put",
     pathParams: ["user_id"],
     queryParams: [],
     flags: [{
@@ -5755,6 +6193,7 @@ var routes = {
     operationId: "listWebhooks",
     description: "Lists webhooks. Use the project_id query parameter to filter by project.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/webhooks",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id"],
     flags: [{
@@ -5770,6 +6209,7 @@ var routes = {
     operationId: "createWebhook",
     description: "Creates a new webhook for a project",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/webhooks",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -5815,6 +6255,7 @@ var routes = {
     operationId: "getWebhook",
     description: "Retrieves the details of a specific webhook",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/webhooks",
+    httpMethod: "get",
     pathParams: ["webhook_id"],
     queryParams: [],
     flags: [{
@@ -5830,6 +6271,7 @@ var routes = {
     operationId: "updateWebhook",
     description: "Updates an existing webhook's configuration",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/webhooks",
+    httpMethod: "put",
     pathParams: ["webhook_id"],
     queryParams: [],
     flags: [{
@@ -5881,6 +6323,7 @@ var routes = {
     operationId: "deleteWebhook",
     description: "Deletes a webhook and stops all event deliveries",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/webhooks",
+    httpMethod: "delete",
     pathParams: ["webhook_id"],
     queryParams: [],
     flags: [{
@@ -5896,6 +6339,7 @@ var routes = {
     operationId: "listWebhookDeliveries",
     description: "Lists event deliveries for a webhook (webhook_id is required).",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/webhooks",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["webhook_id", "limit", "offset"],
     flags: [{
@@ -5923,6 +6367,7 @@ var routes = {
     operationId: "getWebhookDelivery",
     description: "Retrieves the details of a specific webhook delivery",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/webhooks",
+    httpMethod: "get",
     pathParams: ["delivery_id"],
     queryParams: [],
     flags: [{
@@ -5938,6 +6383,7 @@ var routes = {
     operationId: "getWebhookSecret",
     description: "Retrieves the signing secret for the specified webhook",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/webhooks",
+    httpMethod: "get",
     pathParams: ["webhook_id"],
     queryParams: [],
     flags: [{
@@ -5953,6 +6399,7 @@ var routes = {
     operationId: "rotateWebhookSecret",
     description: "Rotates the secret key for the specified webhook",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/webhooks",
+    httpMethod: "post",
     pathParams: ["webhook_id"],
     queryParams: [],
     flags: [{
@@ -5968,6 +6415,7 @@ var routes = {
     operationId: "listWorkflows",
     description: "Lists workflow definitions in a project.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/workflows",
+    httpMethod: "get",
     pathParams: [],
     queryParams: ["project_id"],
     flags: [{
@@ -5983,6 +6431,7 @@ var routes = {
     operationId: "createWorkflow",
     description: "Creates a new workflow definition. The definition is statically validated.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/workflows",
+    httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
@@ -6028,6 +6477,7 @@ var routes = {
     operationId: "getWorkflow",
     description: "Retrieves a workflow definition.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/workflows",
+    httpMethod: "get",
     pathParams: ["workflow_id"],
     queryParams: [],
     flags: [{
@@ -6043,6 +6493,7 @@ var routes = {
     operationId: "updateWorkflow",
     description: "Updates a workflow definition. Structural changes (states/transitions) are re-validated. Existing tasks in a removed state stay put but can only leave via transitions valid in the new definition.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/workflows",
+    httpMethod: "patch",
     pathParams: ["workflow_id"],
     queryParams: [],
     flags: [{
@@ -6088,6 +6539,7 @@ var routes = {
     operationId: "deleteWorkflow",
     description: "Deletes a workflow. Rejected while open tasks exist.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/workflows",
+    httpMethod: "delete",
     pathParams: ["workflow_id"],
     queryParams: [],
     flags: [{
@@ -6115,6 +6567,16 @@ var toCanonical = s => {
 var kebabToSnake = s => {
   return s.replace(/-/g, "_");
 };
+/**
+* Convert snake_case or camelCase to kebab-case for flag *display* in --help
+* (e.g. project_id → project-id). Kebab-case is the documented canonical CLI
+* flag convention (see the generated docs pages and tutorials); the parser is
+* lenient and accepts snake/kebab/camel alike via `toCanonical`, so this only
+* affects how flags are printed (#610).
+*/
+var toKebab = s => {
+  return s.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/_/g, "-").toLowerCase();
+};
 var parseFlagValue = value => {
   const trimmed = value.trim();
   if (trimmed.startsWith("{") || trimmed.startsWith("[") || trimmed === "true" || trimmed === "false" || trimmed === "null" || /^-?\d+(\.\d+)?$/.test(trimmed)) try {
@@ -6305,7 +6767,7 @@ program.argument("[command]", "API command in kebab-case (e.g. list-actors)").ar
       for (const f of allFlags) {
         const req = f.required ? " [required]" : "";
         const desc = f.description ? `  ${f.description}` : "";
-        console.log(`  --${f.name}  <${f.type}>${req}${desc}`);
+        console.log(`  --${toKebab(f.name)}  <${f.type}>${req}${desc}`);
       }
     }
     process.exit(0);
@@ -6335,7 +6797,7 @@ program.argument("[command]", "API command in kebab-case (e.g. list-actors)").ar
     const queryParam = route.queryParams.find(p => {
       return toCanonical(p) === canonical;
     });
-    if (pathParam) pathArgs[pathParam] = parsedValue;else if (queryParam) queryArgs[queryParam] = parsedValue;else bodyArgs[kebabToSnake(flagKey)] = parsedValue;
+    if (pathParam) pathArgs[pathParam] = parsedValue;else if (queryParam) queryArgs[queryParam] = parsedValue;else if (route.httpMethod === "get") queryArgs[kebabToSnake(flagKey)] = parsedValue;else bodyArgs[kebabToSnake(flagKey)] = parsedValue;
   }
   const positionalArgs = extractPositionalArgs({
     cliArgs: rawArgs