@soat/cli 0.5.6 → 0.5.8

package/dist/esm/index.js

@@ -16,7 +16,7 @@ import { program } from "commander";
 // package.json
 var package_default = {
   name: "@soat/cli",
-  version: "0.5.6",
+  version: "0.5.8",
   type: "module",
   scripts: {
     generate: "tsx scripts/generate.ts",
@@ -57,10 +57,10 @@ var package_default = {
   }
 };
 
-// src/cli-wrappers/wrappers/agentFormations.ts
+// src/cli-wrappers/wrappers/formations.ts
 import * as fs from "fs";
 import yaml from "js-yaml";
-var FORMATION_COMMANDS = ["validate-agent-formation", "plan-agent-formation", "create-agent-formation", "update-agent-formation"];
+var FORMATION_COMMANDS = ["validate-formation", "plan-formation", "create-formation", "update-formation"];
 var TEMPLATE_PATH_FLAG = "template-path";
 var TEMPLATE_FILE_FLAG = "template-file";
 var ENV_FILE_FLAG = "env-file";
@@ -139,8 +139,8 @@ var resolveEnvRef = /* @__PURE__ */__name(args => {
   }
   return value;
 }, "resolveEnvRef");
-var agentFormationsWrapper = {
-  id: "agent-formations-wrapper",
+var formationsWrapper = {
+  id: "formations-wrapper",
   commands: FORMATION_COMMANDS,
   helpFlags: [{
     name: "template-path",
@@ -271,7 +271,7 @@ var parseUnknownWithRepeats = /* @__PURE__ */__name(args => {
 }, "parseUnknownWithRepeats");
 
 // src/cli-wrappers/index.ts
-var WRAPPERS = [agentFormationsWrapper];
+var WRAPPERS = [formationsWrapper];
 var resolveWrapperForCommand = /* @__PURE__ */__name(args => {
   const {
     commandName
@@ -550,255 +550,6 @@ var routes = {
       "in": "path"
     }]
   },
-  "validate-agent-formation": {
-    serviceClass: "AgentFormations",
-    operationId: "validateAgentFormation",
-    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/agent-formations",
-    pathParams: [],
-    queryParams: [],
-    flags: [{
-      "name": "template",
-      "description": "",
-      "required": true,
-      "type": "string",
-      "in": "body"
-    }]
-  },
-  "plan-agent-formation": {
-    serviceClass: "AgentFormations",
-    operationId: "planAgentFormation",
-    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/agent-formations",
-    pathParams: [],
-    queryParams: [],
-    flags: [{
-      "name": "project_id",
-      "description": "Project ID",
-      "required": true,
-      "type": "string",
-      "in": "body"
-    }, {
-      "name": "formation_id",
-      "description": "Existing formation ID to compare against. Omit for new formation planning.",
-      "required": false,
-      "type": "string",
-      "in": "body"
-    }, {
-      "name": "template",
-      "description": "",
-      "required": true,
-      "type": "string",
-      "in": "body"
-    }, {
-      "name": "parameters",
-      "description": "Runtime parameter values that override or supply template parameter defaults. Keys must match parameter names declared in `template.parameters`.\n",
-      "required": false,
-      "type": "object",
-      "in": "body"
-    }]
-  },
-  "list-agent-formations": {
-    serviceClass: "AgentFormations",
-    operationId: "listAgentFormations",
-    description: "Returns all formation stacks for a project",
-    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agent-formations",
-    pathParams: [],
-    queryParams: ["project_id"],
-    flags: [{
-      "name": "project_id",
-      "description": "Project ID (required if not using project key auth)",
-      "required": false,
-      "type": "string",
-      "in": "query"
-    }]
-  },
-  "create-agent-formation": {
-    serviceClass: "AgentFormations",
-    operationId: "createAgentFormation",
-    description: "Validates the template, creates the formation record, then provisions all declared resources in dependency order.",
-    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agent-formations",
-    pathParams: [],
-    queryParams: [],
-    flags: [{
-      "name": "project_id",
-      "description": "Project ID",
-      "required": true,
-      "type": "string",
-      "in": "body"
-    }, {
-      "name": "name",
-      "description": "Human-readable name for the formation stack",
-      "required": true,
-      "type": "string",
-      "in": "body"
-    }, {
-      "name": "template",
-      "description": "",
-      "required": true,
-      "type": "string",
-      "in": "body"
-    }, {
-      "name": "parameters",
-      "description": "Runtime parameter values that override or supply template parameter defaults. Keys must match parameter names declared in `template.parameters`. Required parameters (those without a default) must be provided here.\n",
-      "required": false,
-      "type": "object",
-      "in": "body"
-    }, {
-      "name": "metadata",
-      "description": "",
-      "required": false,
-      "type": "object",
-      "in": "body"
-    }]
-  },
-  "get-agent-formation": {
-    serviceClass: "AgentFormations",
-    operationId: "getAgentFormation",
-    description: "Returns the formation stack including its current resources.",
-    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agent-formations",
-    pathParams: ["formation_id"],
-    queryParams: [],
-    flags: [{
-      "name": "formation_id",
-      "description": "",
-      "required": true,
-      "type": "string",
-      "in": "path"
-    }]
-  },
-  "update-agent-formation": {
-    serviceClass: "AgentFormations",
-    operationId: "updateAgentFormation",
-    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/agent-formations",
-    pathParams: ["formation_id"],
-    queryParams: [],
-    flags: [{
-      "name": "formation_id",
-      "description": "",
-      "required": true,
-      "type": "string",
-      "in": "path"
-    }, {
-      "name": "template",
-      "description": "",
-      "required": false,
-      "type": "string",
-      "in": "body"
-    }, {
-      "name": "parameters",
-      "description": "Runtime parameter values that override or supply template parameter defaults. Keys must match parameter names declared in `template.parameters`. Required parameters (those without a default) must be provided here.\n",
-      "required": false,
-      "type": "object",
-      "in": "body"
-    }, {
-      "name": "metadata",
-      "description": "",
-      "required": false,
-      "type": "object",
-      "in": "body"
-    }]
-  },
-  "delete-agent-formation": {
-    serviceClass: "AgentFormations",
-    operationId: "deleteAgentFormation",
-    description: "Deletes the formation stack and all its managed resources in reverse dependency order.",
-    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agent-formations",
-    pathParams: ["formation_id"],
-    queryParams: [],
-    flags: [{
-      "name": "formation_id",
-      "description": "",
-      "required": true,
-      "type": "string",
-      "in": "path"
-    }]
-  },
-  "list-agent-formation-events": {
-    serviceClass: "AgentFormations",
-    operationId: "listAgentFormationEvents",
-    description: "Returns all operations (create, update, delete) with their event logs for the formation, ordered chronologically.",
-    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agent-formations",
-    pathParams: ["formation_id"],
-    queryParams: [],
-    flags: [{
-      "name": "formation_id",
-      "description": "",
-      "required": true,
-      "type": "string",
-      "in": "path"
-    }]
-  },
-  "list-agent-tools": {
-    serviceClass: "AgentTools",
-    operationId: "listAgentTools",
-    description: "Returns all agent tools in the project.",
-    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
-    pathParams: [],
-    queryParams: ["project_id"],
-    flags: [{
-      "name": "project_id",
-      "description": "Project public ID to filter by",
-      "required": false,
-      "type": "string",
-      "in": "query"
-    }]
-  },
-  "create-agent-tool": {
-    serviceClass: "AgentTools",
-    operationId: "createAgentTool",
-    description: "Creates a new agent tool in the project.",
-    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
-    pathParams: [],
-    queryParams: [],
-    flags: []
-  },
-  "get-agent-tool": {
-    serviceClass: "AgentTools",
-    operationId: "getAgentTool",
-    description: "Returns a single agent tool by ID.",
-    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
-    pathParams: ["tool_id"],
-    queryParams: [],
-    flags: [{
-      "name": "tool_id",
-      "description": "",
-      "required": true,
-      "type": "string",
-      "in": "path"
-    }]
-  },
-  "update-agent-tool": {
-    serviceClass: "AgentTools",
-    operationId: "updateAgentTool",
-    description: "Updates an existing agent tool.",
-    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
-    pathParams: ["tool_id"],
-    queryParams: [],
-    flags: [{
-      "name": "tool_id",
-      "description": "",
-      "required": true,
-      "type": "string",
-      "in": "path"
-    }]
-  },
-  "delete-agent-tool": {
-    serviceClass: "AgentTools",
-    operationId: "deleteAgentTool",
-    description: "Deletes an agent tool by ID.",
-    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
-    pathParams: ["tool_id"],
-    queryParams: [],
-    flags: [{
-      "name": "tool_id",
-      "description": "",
-      "required": true,
-      "type": "string",
-      "in": "path"
-    }]
-  },
   "list-agents": {
     serviceClass: "Agents",
     operationId: "listAgents",
@@ -2023,6 +1774,186 @@ var routes = {
       "in": "path"
     }]
   },
+  "validate-formation": {
+    serviceClass: "Formations",
+    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",
+    pathParams: [],
+    queryParams: [],
+    flags: [{
+      "name": "template",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "body"
+    }]
+  },
+  "plan-formation": {
+    serviceClass: "Formations",
+    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",
+    pathParams: [],
+    queryParams: [],
+    flags: [{
+      "name": "project_id",
+      "description": "Project ID",
+      "required": true,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "formation_id",
+      "description": "Existing formation ID to compare against. Omit for new formation planning.",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "template",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "parameters",
+      "description": "Runtime parameter values that override or supply template parameter defaults. Keys must match parameter names declared in `template.parameters`.\n",
+      "required": false,
+      "type": "object",
+      "in": "body"
+    }]
+  },
+  "list-formations": {
+    serviceClass: "Formations",
+    operationId: "listFormations",
+    description: "Returns all formation stacks for a project",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/formations",
+    pathParams: [],
+    queryParams: ["project_id"],
+    flags: [{
+      "name": "project_id",
+      "description": "Project ID (required if not using project key auth)",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }]
+  },
+  "create-formation": {
+    serviceClass: "Formations",
+    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",
+    pathParams: [],
+    queryParams: [],
+    flags: [{
+      "name": "project_id",
+      "description": "Project ID",
+      "required": true,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "name",
+      "description": "Human-readable name for the formation stack",
+      "required": true,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "template",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "parameters",
+      "description": "Runtime parameter values that override or supply template parameter defaults. Keys must match parameter names declared in `template.parameters`. Required parameters (those without a default) must be provided here.\n",
+      "required": false,
+      "type": "object",
+      "in": "body"
+    }, {
+      "name": "metadata",
+      "description": "",
+      "required": false,
+      "type": "object",
+      "in": "body"
+    }]
+  },
+  "get-formation": {
+    serviceClass: "Formations",
+    operationId: "getFormation",
+    description: "Returns the formation stack including its current resources.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/formations",
+    pathParams: ["formation_id"],
+    queryParams: [],
+    flags: [{
+      "name": "formation_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
+  "update-formation": {
+    serviceClass: "Formations",
+    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",
+    pathParams: ["formation_id"],
+    queryParams: [],
+    flags: [{
+      "name": "formation_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "template",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "parameters",
+      "description": "Runtime parameter values that override or supply template parameter defaults. Keys must match parameter names declared in `template.parameters`. Required parameters (those without a default) must be provided here.\n",
+      "required": false,
+      "type": "object",
+      "in": "body"
+    }, {
+      "name": "metadata",
+      "description": "",
+      "required": false,
+      "type": "object",
+      "in": "body"
+    }]
+  },
+  "delete-formation": {
+    serviceClass: "Formations",
+    operationId: "deleteFormation",
+    description: "Deletes the formation stack and all its managed resources in reverse dependency order.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/formations",
+    pathParams: ["formation_id"],
+    queryParams: [],
+    flags: [{
+      "name": "formation_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
+  "list-formation-events": {
+    serviceClass: "Formations",
+    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",
+    pathParams: ["formation_id"],
+    queryParams: [],
+    flags: [{
+      "name": "formation_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
   "search-knowledge": {
     serviceClass: "Knowledge",
     operationId: "searchKnowledge",
@@ -2857,6 +2788,90 @@ var routes = {
       "in": "path"
     }]
   },
+  "list-tools": {
+    serviceClass: "Tools",
+    operationId: "listTools",
+    description: "Returns all tools in the project.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tools",
+    pathParams: [],
+    queryParams: ["project_id"],
+    flags: [{
+      "name": "project_id",
+      "description": "Project public ID to filter by",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }]
+  },
+  "create-tool": {
+    serviceClass: "Tools",
+    operationId: "createTool",
+    description: "Creates a new tool in the project.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tools",
+    pathParams: [],
+    queryParams: [],
+    flags: []
+  },
+  "get-tool": {
+    serviceClass: "Tools",
+    operationId: "getTool",
+    description: "Returns a single tool by ID.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tools",
+    pathParams: ["tool_id"],
+    queryParams: [],
+    flags: [{
+      "name": "tool_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
+  "update-tool": {
+    serviceClass: "Tools",
+    operationId: "updateTool",
+    description: "Updates an existing tool.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tools",
+    pathParams: ["tool_id"],
+    queryParams: [],
+    flags: [{
+      "name": "tool_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
+  "delete-tool": {
+    serviceClass: "Tools",
+    operationId: "deleteTool",
+    description: "Deletes a tool by ID.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tools",
+    pathParams: ["tool_id"],
+    queryParams: [],
+    flags: [{
+      "name": "tool_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
+  "call-tool": {
+    serviceClass: "Tools",
+    operationId: "callTool",
+    description: "Directly invokes a tool and returns its output. Supported for `http`, `soat`, and `mcp` tools. `client` tools cannot be invoked server-side and will return 422. 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. `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",
+    pathParams: ["tool_id"],
+    queryParams: [],
+    flags: [{
+      "name": "tool_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
   "list-traces": {
     serviceClass: "Traces",
     operationId: "listTraces",
@@ -3211,6 +3226,27 @@ var routes = {
       "in": "path"
     }]
   },
+  "get-webhook-secret": {
+    serviceClass: "Webhooks",
+    operationId: "getWebhookSecret",
+    description: "Retrieves the signing secret for the specified webhook",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/webhooks",
+    pathParams: ["project_id", "webhook_id"],
+    queryParams: [],
+    flags: [{
+      "name": "project_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "webhook_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
   "rotate-webhook-secret": {
     serviceClass: "Webhooks",
     operationId: "rotateWebhookSecret",
@@ -3503,14 +3539,21 @@ Usage: soat ${commandName} [flags]
   const result = await method(callOpts);
   if (result.error) {
     const status = result.response && "status" in result.response ? result.response.status : void 0;
-    const errorPayload = result.error instanceof Error ? {
-      name: result.error.name,
-      message: result.error.message
-    } : result.error;
-    console.error(JSON.stringify({
+    const rawError = result.error;
+    const errorOutput = rawError instanceof Error ? {
+      status,
+      error: {
+        name: rawError.name,
+        message: rawError.message
+      }
+    } : typeof rawError === "object" && rawError !== null ? {
+      status,
+      ...rawError
+    } : {
       status,
-      error: errorPayload
-    }, null, 2));
+      error: rawError
+    };
+    console.error(JSON.stringify(errorOutput, null, 2));
     process.exit(1);
   }
   console.log(JSON.stringify(result.data, null, 2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/cli",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "type": "module",
   "dependencies": {
     "@inquirer/input": "^5.0.12",
@@ -8,7 +8,7 @@
     "@ttoss/logger": "^0.8.10",
     "commander": "^14.0.3",
     "js-yaml": "^4.1.1",
-    "@soat/sdk": "0.5.6"
+    "@soat/sdk": "0.5.8"
   },
   "devDependencies": {
     "@ttoss/config": "^1.37.10",