@soat/cli 0.13.6 → 0.13.8

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.6";
+var version = "0.13.8";
 
 //#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"
@@ -673,7 +673,7 @@ var routes = {
   "update-agent": {
     serviceClass: "Agents",
     operationId: "updateAgent",
-    description: "Updates an existing agent.",
+    description: "Updates an existing agent. Identical to PATCH — both perform partial updates.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
     pathParams: ["agent_id"],
     queryParams: [],
@@ -763,7 +763,118 @@ 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"
+    }, {
+      "name": "max_context_messages",
+      "description": "Maximum number of recent messages included in the context window. Null means no limit.",
+      "required": false,
+      "type": "integer",
+      "in": "body"
+    }, {
+      "name": "single_session_per_actor",
+      "description": "When true, only one open session per actor_id is allowed for this agent.",
+      "required": false,
+      "type": "boolean",
+      "in": "body"
+    }]
+  },
+  "patch-agent": {
+    serviceClass: "Agents",
+    operationId: "patchAgent",
+    description: "Partially updates an existing agent. Identical to PUT — both perform partial updates.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
+    pathParams: ["agent_id"],
+    queryParams: [],
+    flags: [{
+      "name": "agent_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "ai_provider_id",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "name",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "instructions",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "model",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "tool_ids",
+      "description": "",
+      "required": false,
+      "type": "array",
+      "in": "body"
+    }, {
+      "name": "max_steps",
+      "description": "",
+      "required": false,
+      "type": "integer",
+      "in": "body"
+    }, {
+      "name": "tool_choice",
+      "description": "Tool choice strategy. Accepts a string (`\"auto\"`, `\"required\"`) or an object (`{ \"type\": \"tool\", \"name\": \"my_tool\" }`).",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "stop_conditions",
+      "description": "",
+      "required": false,
+      "type": "array",
+      "in": "body"
+    }, {
+      "name": "active_tool_ids",
+      "description": "",
+      "required": false,
+      "type": "array",
+      "in": "body"
+    }, {
+      "name": "step_rules",
+      "description": "",
+      "required": false,
+      "type": "array",
+      "in": "body"
+    }, {
+      "name": "boundary_policy",
+      "description": "",
+      "required": false,
+      "type": "object",
+      "in": "body"
+    }, {
+      "name": "temperature",
+      "description": "",
+      "required": false,
+      "type": "number",
+      "in": "body"
+    }, {
+      "name": "knowledge_config",
+      "description": "",
+      "required": false,
+      "type": "object",
+      "in": "body"
+    }, {
+      "name": "reasoning",
+      "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 +1891,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",
@@ -1975,7 +2140,7 @@ var routes = {
   "create-presigned-url": {
     serviceClass: "Files",
     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 `SERVER_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.",
+    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: [],
@@ -2383,7 +2548,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"
@@ -3127,6 +3292,27 @@ var routes = {
       "in": "path"
     }]
   },
+  "update-project": {
+    serviceClass: "Projects",
+    operationId: "updateProject",
+    description: "Updates a project's name. Requires admin role.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/projects",
+    pathParams: ["project_id"],
+    queryParams: [],
+    flags: [{
+      "name": "project_id",
+      "description": "Project public ID (proj_ prefix)",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "name",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "body"
+    }]
+  },
   "delete-project": {
     serviceClass: "Projects",
     operationId: "deleteProject",
@@ -3835,7 +4021,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.6",
+  "version": "0.13.8",
   "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.6"
+    "@soat/sdk": "0.13.8"
   },
   "devDependencies": {
     "@ttoss/config": "^1.37.15",