@soat/cli 0.13.7 → 0.13.9

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.7";
+var version = "0.13.9";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -389,6 +389,12 @@ var routes = {
       "required": false,
       "type": "string",
       "in": "body"
+    }, {
+      "name": "instructions",
+      "description": "Persona-specific instructions composed into the effective system prompt during conversation generation.",
+      "required": false,
+      "type": "string",
+      "in": "body"
     }, {
       "name": "agent_id",
       "description": "Agent to link this actor to. Mutually exclusive with chat_id.",
@@ -449,12 +455,30 @@ var routes = {
       "required": false,
       "type": "string",
       "in": "body"
+    }, {
+      "name": "external_id",
+      "description": "External identifier (e.g. WhatsApp phone number)",
+      "required": false,
+      "type": "string",
+      "in": "body"
     }, {
       "name": "instructions",
       "description": "Persona-specific instructions",
       "required": false,
       "type": "string",
       "in": "body"
+    }, {
+      "name": "agent_id",
+      "description": "Agent to link this actor to. Mutually exclusive with chat_id.",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "chat_id",
+      "description": "Chat to link this actor to. Mutually exclusive with agent_id.",
+      "required": false,
+      "type": "string",
+      "in": "body"
     }, {
       "name": "memory_id",
       "description": "Memory ID to link to this actor. Set to null to unlink.",
@@ -673,7 +697,118 @@ 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: [],
+    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"
+    }, {
+      "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: [],
@@ -998,6 +1133,12 @@ var routes = {
       "required": false,
       "type": "string",
       "in": "body"
+    }, {
+      "name": "provider",
+      "description": "LLM provider",
+      "required": false,
+      "type": "string",
+      "in": "body"
     }, {
       "name": "default_model",
       "description": "",
@@ -1042,7 +1183,7 @@ var routes = {
   "list-api-keys": {
     serviceClass: "APIKeys",
     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 scoped to a project: returns only API keys scoped to that project.",
+    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",
     pathParams: [],
     queryParams: [],
@@ -1051,7 +1192,7 @@ var routes = {
   "create-api-key": {
     serviceClass: "APIKeys",
     operationId: "createApiKey",
-    description: "Creates a new API key for the authenticated user. - If `project_id` is provided, the key is scoped to that project. - If `policy_ids` is provided, the key's effective permissions are the intersection of the user's policies and the key's policies. - If neither is provided, the key inherits the user's full permissions.",
+    description: "Creates a new API key for the authenticated user. - `project_id` is required: every key is scoped to exactly one project. - 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.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/api-keys",
     pathParams: [],
     queryParams: [],
@@ -1063,8 +1204,8 @@ var routes = {
       "in": "body"
     }, {
       "name": "project_id",
-      "description": "Optional project ID to scope this key to a specific project",
-      "required": false,
+      "description": "Project ID this key is scoped to. Required — keys cannot span projects.",
+      "required": true,
       "type": "string",
       "in": "body"
     }, {
@@ -1093,7 +1234,7 @@ var routes = {
   "update-api-key": {
     serviceClass: "APIKeys",
     operationId: "updateApiKey",
-    description: "Updates an API key's name, project scope, or policies. Only the owner or an admin can update it.",
+    description: "Updates an API key's name, project scope, or policies. The project scope can be changed to another project but never cleared. Only the owner or an admin can update it.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/api-keys",
     pathParams: ["api_key_id"],
     queryParams: [],
@@ -1111,7 +1252,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "project_id",
-      "description": "Set to null to remove project scope",
+      "description": "Re-scope the key to a different project. Cannot be null — keys are always project-scoped.",
       "required": false,
       "type": "string",
       "in": "body"
@@ -1385,7 +1526,13 @@ var routes = {
     }, {
       "name": "status",
       "description": "New conversation status",
-      "required": true,
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "name",
+      "description": "New conversation name",
+      "required": false,
       "type": "string",
       "in": "body"
     }]
@@ -1628,6 +1775,24 @@ var routes = {
       "required": false,
       "type": "string",
       "in": "body"
+    }, {
+      "name": "title",
+      "description": "Document title",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "metadata",
+      "description": "Arbitrary metadata object",
+      "required": false,
+      "type": "object",
+      "in": "body"
+    }, {
+      "name": "tags",
+      "description": "Key-value tags",
+      "required": false,
+      "type": "object",
+      "in": "body"
     }, {
       "name": "chunk_strategy",
       "description": "How to split the content into embeddable chunks. `whole` (default) stores the content as a single chunk; `size` splits into fixed-size character windows with overlap. `page` is equivalent to `whole` for plain text.",
@@ -1991,7 +2156,7 @@ var routes = {
     flags: [{
       "name": "project_id",
       "description": "Public ID of the project",
-      "required": true,
+      "required": false,
       "type": "string",
       "in": "body"
     }, {
@@ -2074,8 +2239,8 @@ var routes = {
       "in": "path"
     }, {
       "name": "content",
-      "description": "Base64-encoded file content",
-      "required": true,
+      "description": "Base64-encoded file content (alternative to multipart `file`)",
+      "required": false,
       "type": "string",
       "in": "body"
     }, {
@@ -2246,7 +2411,7 @@ var routes = {
     flags: [{
       "name": "template",
       "description": "",
-      "required": true,
+      "required": false,
       "type": "string",
       "in": "body"
     }]
@@ -2278,7 +2443,7 @@ var routes = {
       "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",
+      "description": "Runtime parameter values that override or supply template parameter defaults. Keys must match parameter names declared in `template.parameters`. A parameter declared with `use_previous_value: true` may be omitted to reuse its stored value.\n",
       "required": false,
       "type": "object",
       "in": "body"
@@ -2374,7 +2539,7 @@ var routes = {
       "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",
+      "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, unless the parameter is declared with `use_previous_value: true`, in which case omitting it reuses the previously stored value.\n",
       "required": false,
       "type": "object",
       "in": "body"
@@ -2831,13 +2996,13 @@ var routes = {
     flags: [{
       "name": "nodes",
       "description": "",
-      "required": true,
+      "required": false,
       "type": "array",
       "in": "body"
     }, {
       "name": "edges",
       "description": "",
-      "required": true,
+      "required": false,
       "type": "array",
       "in": "body"
     }, {
@@ -3181,6 +3346,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",

package/package.json

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