@soat/cli 0.13.8 → 0.13.10

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.8";
+var version = "0.13.10";
 
 //#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.",
@@ -641,6 +665,12 @@ var routes = {
       "required": false,
       "type": "object",
       "in": "body"
+    }, {
+      "name": "output_schema",
+      "description": "JSON Schema describing the structured object the model must return. When set, non-streaming generations use the AI SDK to constrain output to this schema; the parsed value is returned as `output.object` in the generation response. See the Structured Output section in 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.",
@@ -767,6 +797,12 @@ var routes = {
       "required": false,
       "type": "object",
       "in": "body"
+    }, {
+      "name": "output_schema",
+      "description": "JSON Schema describing the structured object the model must return. When set, non-streaming generations use the AI SDK to constrain output to this schema; the parsed value is returned as `output.object` in the generation response. See the Structured Output section in 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.",
@@ -878,6 +914,12 @@ var routes = {
       "required": false,
       "type": "object",
       "in": "body"
+    }, {
+      "name": "output_schema",
+      "description": "JSON Schema describing the structured object the model must return. When set, non-streaming generations use the AI SDK to constrain output to this schema; the parsed value is returned as `output.object` in the generation response. See the Structured Output section in 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.",
@@ -1109,6 +1151,12 @@ var routes = {
       "required": false,
       "type": "string",
       "in": "body"
+    }, {
+      "name": "provider",
+      "description": "LLM provider",
+      "required": false,
+      "type": "string",
+      "in": "body"
     }, {
       "name": "default_model",
       "description": "",
@@ -1153,7 +1201,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: [],
@@ -1162,7 +1210,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: [],
@@ -1174,8 +1222,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"
     }, {
@@ -1204,7 +1252,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: [],
@@ -1222,7 +1270,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"
@@ -1496,7 +1544,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"
     }]
@@ -1739,6 +1793,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.",
@@ -2102,7 +2174,7 @@ var routes = {
     flags: [{
       "name": "project_id",
       "description": "Public ID of the project",
-      "required": true,
+      "required": false,
       "type": "string",
       "in": "body"
     }, {
@@ -2173,7 +2245,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/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.",
+    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.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
     pathParams: ["token"],
     queryParams: [],
@@ -2185,8 +2257,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"
     }, {
@@ -2357,7 +2429,7 @@ var routes = {
     flags: [{
       "name": "template",
       "description": "",
-      "required": true,
+      "required": false,
       "type": "string",
       "in": "body"
     }]
@@ -2389,7 +2461,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"
@@ -2485,7 +2557,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"
@@ -2942,13 +3014,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"
     }, {

package/package.json

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