@soat/cli 0.13.3 → 0.13.5

package/dist/index.mjs

@@ -11,7 +11,7 @@ import yaml from "js-yaml";
 import * as os from "node:os";
 
 //#region package.json
-var version = "0.13.3";
+var version = "0.13.5";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -1882,8 +1882,8 @@ var routes = {
     queryParams: [],
     flags: [{
       "name": "project_id",
-      "description": "Public ID of the project",
-      "required": true,
+      "description": "Public ID of the project. Optional when authenticating with a project-scoped API key, which defaults to the key's project; required otherwise.",
+      "required": false,
       "type": "string",
       "in": "body"
     }, {
@@ -1984,6 +1984,78 @@ var routes = {
       "in": "body"
     }]
   },
+  "create-upload-token": {
+    serviceClass: "Files",
+    operationId: "createUploadToken",
+    description: "Creates a short-lived, single-use upload token — 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.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    pathParams: [],
+    queryParams: [],
+    flags: [{
+      "name": "project_id",
+      "description": "Public ID of the project",
+      "required": true,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "filename",
+      "description": "Name of the file to be uploaded",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "content_type",
+      "description": "MIME type of the file to be uploaded",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "path",
+      "description": "Logical path within the project (e.g. /documents/report.pdf). Defaults to /filename if omitted.",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }]
+  },
+  "upload-file-with-token": {
+    serviceClass: "Files",
+    operationId: "uploadFileWithToken",
+    description: "Uploads file content authorized by a single-use token from `POST /api/v1/files/upload-token`. 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. Excluded from the MCP tool surface; clients call it directly over HTTP.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
+    pathParams: ["token"],
+    queryParams: [],
+    flags: [{
+      "name": "token",
+      "description": "The single-use upload token (e.g. upt_...)",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "content",
+      "description": "Base64-encoded file content",
+      "required": true,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "filename",
+      "description": "Name of the file (overrides the token's filename)",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "content_type",
+      "description": "MIME type of the file (overrides the token's content type)",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "metadata",
+      "description": "JSON string with additional metadata",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }]
+  },
   "get-file": {
     serviceClass: "Files",
     operationId: "getFile",
@@ -2140,8 +2212,8 @@ var routes = {
     queryParams: [],
     flags: [{
       "name": "project_id",
-      "description": "Project ID",
-      "required": true,
+      "description": "Project ID. Optional when authenticating with a project-scoped API key, which defaults to the key's project; required otherwise.",
+      "required": false,
       "type": "string",
       "in": "body"
     }, {
@@ -2188,8 +2260,8 @@ var routes = {
     queryParams: [],
     flags: [{
       "name": "project_id",
-      "description": "Project ID",
-      "required": true,
+      "description": "Project ID. Optional when authenticating with a project-scoped API key, which defaults to the key's project; required otherwise.",
+      "required": false,
       "type": "string",
       "in": "body"
     }, {
@@ -2302,7 +2374,7 @@ var routes = {
     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",
     pathParams: [],
-    queryParams: ["agent_id", "trace_id", "status", "limit", "offset"],
+    queryParams: ["agent_id", "trace_id", "initiator_generation_id", "status", "limit", "offset"],
     flags: [{
       "name": "agent_id",
       "description": "Filter by agent public ID",
@@ -2315,6 +2387,12 @@ var routes = {
       "required": false,
       "type": "string",
       "in": "query"
+    }, {
+      "name": "initiator_generation_id",
+      "description": "Filter by the public ID of the parent generation. Returns all generations triggered by that generation — debate perspective turns, synthesis steps, and sub-agent invocations. Null-initiated (top-level) generations are not returned.\n",
+      "required": false,
+      "type": "string",
+      "in": "query"
     }, {
       "name": "status",
       "description": "Filter by lifecycle status",
@@ -2559,7 +2637,7 @@ var routes = {
       "type": "string",
       "in": "body"
     }, {
-      "name": "source",
+      "name": "source_type",
       "description": "How this entry was created",
       "required": false,
       "type": "string",
@@ -2653,8 +2731,8 @@ var routes = {
     queryParams: [],
     flags: [{
       "name": "project_id",
-      "description": "Public ID of the project.",
-      "required": true,
+      "description": "Public ID of the project. Optional when authenticating with a project-scoped API key, which defaults to the key's project; required otherwise.",
+      "required": false,
       "type": "string",
       "in": "body"
     }, {
@@ -3572,6 +3650,12 @@ var routes = {
       "required": false,
       "type": "object",
       "in": "body"
+    }, {
+      "name": "pipeline",
+      "description": "Pipeline definition for `pipeline` tools. See the `pipeline` field on the Tool schema for the full structure.",
+      "required": false,
+      "type": "object",
+      "in": "body"
     }]
   },
   "get-tool": {
@@ -3650,6 +3734,12 @@ var routes = {
       "required": false,
       "type": "object",
       "in": "body"
+    }, {
+      "name": "pipeline",
+      "description": "Pipeline definition for `pipeline` tools. See the `pipeline` field on the Tool schema for the full structure.",
+      "required": false,
+      "type": "object",
+      "in": "body"
     }]
   },
   "delete-tool": {
@@ -3670,7 +3760,7 @@ var routes = {
   "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.",
+    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. `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: [],
@@ -3742,13 +3832,19 @@ var routes = {
     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",
     pathParams: ["trace_id"],
-    queryParams: [],
+    queryParams: ["include"],
     flags: [{
       "name": "trace_id",
       "description": "Public ID of any trace in the tree (root or child)",
       "required": true,
       "type": "string",
       "in": "path"
+    }, {
+      "name": "include",
+      "description": "Comma-separated list of related resources to embed on each node. Supported value: `generations` — attaches all generations that belong to each trace node (including debate perspective/synthesis children linked via `initiator_generation_id`).\n",
+      "required": false,
+      "type": "string",
+      "in": "query"
     }]
   },
   "get-current-user": {
@@ -3913,8 +4009,8 @@ var routes = {
     queryParams: [],
     flags: [{
       "name": "project_id",
-      "description": "",
-      "required": true,
+      "description": "Public ID of the project. Optional when authenticating with a project-scoped API key, which defaults to the key's project; required otherwise.",
+      "required": false,
       "type": "string",
       "in": "body"
     }, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/cli",
-  "version": "0.13.3",
+  "version": "0.13.5",
   "type": "module",
   "dependencies": {
     "@inquirer/input": "^5.1.2",
@@ -8,7 +8,7 @@
     "@ttoss/logger": "^0.8.16",
     "commander": "^15.0.0",
     "js-yaml": "^4.2.0",
-    "@soat/sdk": "0.13.3"
+    "@soat/sdk": "0.13.5"
   },
   "devDependencies": {
     "@ttoss/config": "^1.37.15",