@soat/cli 0.13.5 → 0.13.7

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.5";
+var version = "0.13.7";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -637,7 +637,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "reasoning",
-      "description": "Deep-thinking configuration. `effort` forwards provider-native reasoning; `mode: reflect` critiques and revises; `mode: debate` runs multiple perspectives then synthesizes.",
+      "description": "Deep-thinking configuration. `effort` forwards provider-native reasoning; `mode: pipeline` runs an ordered list of reasoning steps after the base draft. reflect and debate are expressed as pipelines — see the Agents module docs.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -763,7 +763,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "reasoning",
-      "description": "Deep-thinking configuration. `effort` forwards provider-native reasoning; `mode: reflect` critiques and revises; `mode: debate` runs multiple perspectives then synthesizes.",
+      "description": "Deep-thinking configuration. `effort` forwards provider-native reasoning; `mode: pipeline` runs an ordered list of reasoning steps after the base draft. reflect and debate are expressed as pipelines — see the Agents module docs.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -1780,6 +1780,60 @@ var routes = {
       "in": "path"
     }]
   },
+  "get-document-status": {
+    serviceClass: "Documents",
+    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",
+    pathParams: ["document_id"],
+    queryParams: [],
+    flags: [{
+      "name": "document_id",
+      "description": "Document ID",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
+  "reingest-document": {
+    serviceClass: "Documents",
+    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",
+    pathParams: ["document_id"],
+    queryParams: ["async"],
+    flags: [{
+      "name": "document_id",
+      "description": "Document ID",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "async",
+      "description": "When omitted or `true` (default), processing runs in the background and `202 Accepted` is returned immediately with `status=pending`. Pass `false` to run synchronously and receive `201 Created` with `status=ready`.",
+      "required": false,
+      "type": "boolean",
+      "in": "query"
+    }, {
+      "name": "chunk_strategy",
+      "description": "How to split the source into chunks. Defaults to `page`.",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "chunk_size",
+      "description": "Window size in characters when `chunk_strategy=size`. Defaults to 1000.",
+      "required": false,
+      "type": "integer",
+      "in": "body"
+    }, {
+      "name": "chunk_overlap",
+      "description": "Overlap in characters between consecutive windows when `chunk_strategy=size`. Defaults to 200.",
+      "required": false,
+      "type": "integer",
+      "in": "body"
+    }]
+  },
   "get-document-tags": {
     serviceClass: "Documents",
     operationId: "getDocumentTags",
@@ -1887,14 +1941,14 @@ var routes = {
       "type": "string",
       "in": "body"
     }, {
-      "name": "path",
-      "description": "Logical path within the project (e.g. /images/logo.png). Defaults to /filename if omitted.",
+      "name": "prefix",
+      "description": "Directory within the project (e.g. /images). Optional; defaults to / (root). Combined with filename to form the file's key (path).",
       "required": false,
       "type": "string",
       "in": "body"
     }, {
       "name": "filename",
-      "description": "Name of the file",
+      "description": "Original / download name and the key's leaf segment (e.g. logo.png).",
       "required": false,
       "type": "string",
       "in": "body"
@@ -1910,18 +1964,6 @@ var routes = {
       "required": false,
       "type": "integer",
       "in": "body"
-    }, {
-      "name": "storage_type",
-      "description": "Storage backend type",
-      "required": true,
-      "type": "string",
-      "in": "body"
-    }, {
-      "name": "storage_path",
-      "description": "Path where the file is stored",
-      "required": true,
-      "type": "string",
-      "in": "body"
     }, {
       "name": "metadata",
       "description": "JSON string with additional metadata",
@@ -1959,14 +2001,14 @@ var routes = {
       "type": "string",
       "in": "body"
     }, {
-      "name": "filename",
-      "description": "Name of the file",
+      "name": "prefix",
+      "description": "Directory within the project (e.g. /documents). Optional; defaults to / (root).",
       "required": false,
       "type": "string",
       "in": "body"
     }, {
-      "name": "path",
-      "description": "Logical path within the project (e.g. /images/logo.png). Defaults to /filename if omitted.",
+      "name": "filename",
+      "description": "Original / download name and the key's leaf segment.",
       "required": false,
       "type": "string",
       "in": "body"
@@ -1984,10 +2026,10 @@ var routes = {
       "in": "body"
     }]
   },
-  "create-upload-token": {
+  "create-presigned-url": {
     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.",
+    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",
     pathParams: [],
     queryParams: [],
@@ -1998,20 +2040,20 @@ var routes = {
       "type": "string",
       "in": "body"
     }, {
-      "name": "filename",
-      "description": "Name of the file to be uploaded",
+      "name": "prefix",
+      "description": "Directory within the project (e.g. /documents). Optional; defaults to / (root).",
       "required": false,
       "type": "string",
       "in": "body"
     }, {
-      "name": "content_type",
-      "description": "MIME type of the file to be uploaded",
+      "name": "filename",
+      "description": "Original / download name and the key's leaf segment.",
       "required": false,
       "type": "string",
       "in": "body"
     }, {
-      "name": "path",
-      "description": "Logical path within the project (e.g. /documents/report.pdf). Defaults to /filename if omitted.",
+      "name": "content_type",
+      "description": "MIME type of the file to be uploaded",
       "required": false,
       "type": "string",
       "in": "body"
@@ -2020,7 +2062,7 @@ var routes = {
   "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.",
+    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. Excluded from the MCP tool surface; clients call it directly over HTTP.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
     pathParams: ["token"],
     queryParams: [],
@@ -2038,7 +2080,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "filename",
-      "description": "Name of the file (overrides the token's filename)",
+      "description": "Original / download name (overrides the token's filename)",
       "required": false,
       "type": "string",
       "in": "body"
@@ -2120,9 +2162,15 @@ var routes = {
       "required": false,
       "type": "string",
       "in": "body"
+    }, {
+      "name": "prefix",
+      "description": "New directory — moves the file. The resulting path (prefix + filename) must be unique within the project.",
+      "required": false,
+      "type": "string",
+      "in": "body"
     }, {
       "name": "filename",
-      "description": "New filename for the file",
+      "description": "New filename — renames the key's leaf and the download name.",
       "required": false,
       "type": "string",
       "in": "body"
@@ -2389,7 +2437,7 @@ var routes = {
       "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",
+      "description": "Filter by the public ID of the parent generation. Returns all generations triggered by that generation — reasoning pipeline steps and perspective turns, and sub-agent invocations. Null-initiated (top-level) generations are not returned.\n",
       "required": false,
       "type": "string",
       "in": "query"
@@ -3841,7 +3889,7 @@ var routes = {
       "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",
+      "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 reasoning pipeline children linked via `initiator_generation_id`).\n",
       "required": false,
       "type": "string",
       "in": "query"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/cli",
-  "version": "0.13.5",
+  "version": "0.13.7",
   "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.5"
+    "@soat/sdk": "0.13.7"
   },
   "devDependencies": {
     "@ttoss/config": "^1.37.15",