@soat/cli 0.16.3 → 0.17.0

package/dist/index.mjs

@@ -13,7 +13,7 @@ import { load } from "js-yaml";
 import * as os from "node:os";
 
 //#region package.json
-var version = "0.16.3";
+var version = "0.17.0";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -1094,7 +1094,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "tool_context",
-      "description": "Key-value pairs injected as context headers into all tool call requests made during this generation.",
+      "description": "Key-value pairs forwarded as `X-Soat-Context-<Key>` headers on every `http`, `mcp` and `soat` tool call in this generation. Each key's first character is uppercased and the rest is used verbatim. Keys are never case-converted — they round-trip exactly as sent. An invalid or colliding key is rejected with `400 INVALID_TOOL_CONTEXT_KEY`.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -2164,7 +2164,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "tool_context",
-      "description": "Key-value pairs injected as context headers into all tool call requests made during this generation.",
+      "description": "Key-value pairs forwarded as `X-Soat-Context-<Key>` headers on every `http`, `mcp` and `soat` tool call in this generation. Each key's first character is uppercased and the rest is used verbatim; keys are never case-converted — they round-trip exactly as sent. An invalid or colliding key is rejected with `400 INVALID_TOOL_CONTEXT_KEY`.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -4643,7 +4643,7 @@ var routes = {
   "start-orchestration-run": {
     serviceClass: "Orchestrations",
     operationId: "startOrchestrationRun",
-    description: "Creates a new run for the orchestration named by orchestration_id. By default the run executes durably in the background: the response returns immediately with status \"running\" and progress is observed via get-orchestration-run or run lifecycle webhook events (orchestration_runs.started/awaiting_input/succeeded/failed). Delay and poll waits park the run as \"sleeping\" and are woken by a background scheduler, surviving restarts. Pass wait=true to block until the run reaches a terminal or awaiting_input state (the legacy synchronous behaviour).",
+    description: "Creates a new run for the orchestration named by orchestration_id. By default the run executes durably in the background: the response returns immediately with status \"queued\" (a worker then claims it and moves it to \"running\") and progress is observed via get-orchestration-run or run lifecycle webhook events (orchestration_runs.started/awaiting_input/succeeded/failed). Delay and poll waits park the run as \"sleeping\" and are woken by a background scheduler, surviving restarts. Pass wait=true to block until the run reaches a terminal or awaiting_input state (the legacy synchronous behaviour).",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
     httpMethod: "post",
     pathParams: [],
@@ -4662,7 +4662,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "wait",
-      "description": "When true, block until the run reaches a terminal (succeeded/failed) or awaiting_input state and return the settled run. When false (default), return immediately with status \"running\" and execute the run in the background.",
+      "description": "When true, block until the run reaches a terminal (succeeded/failed) or awaiting_input state and return the settled run. When false (default), return immediately with status \"queued\" and execute the run in the background.",
       "required": false,
       "type": "boolean",
       "in": "body"
@@ -4715,7 +4715,7 @@ var routes = {
   "resume-orchestration-run": {
     serviceClass: "Orchestrations",
     operationId: "resumeOrchestrationRun",
-    description: "Resumes an awaiting_input orchestration run from its last checkpoint.",
+    description: "Re-drives an awaiting_input orchestration run from its last checkpoint. This does not satisfy the pause itself — it carries no node_id or payload, so a run parked on a human or webhook-receive node re-parks on the same node. Use submit-human-input to supply the awaited payload and advance the run.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
     httpMethod: "post",
     pathParams: ["run_id"],
@@ -5319,7 +5319,7 @@ var routes = {
   "create-session": {
     serviceClass: "Sessions",
     operationId: "createSession",
-    description: "Creates a new session for the specified agent. Internally creates a conversation and two actors (agent + user) so the caller only needs this single call to start interacting with the agent.",
+    description: "Creates a new session for the specified agent, along with the underlying conversation, so the caller only needs this single call to start interacting with the agent. No actor is created: pass `actor_id` to attach an existing actor as the session's end user. When it is omitted the session has no actor, and generations in it carry no end-user attribution — they are not billed to an actor in the usage meter and they match no `actor`-scoped quota.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/sessions",
     httpMethod: "post",
     pathParams: [],
@@ -5338,7 +5338,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "actor_id",
-      "description": "Optional public ID of an existing actor to use as the user actor",
+      "description": "Optional public ID of an existing actor to use as the user actor. Actors are created separately (POST /actors); this field only links one. Omit it and the session has no end user, so its generations match no actor-scoped quota.\n",
       "required": false,
       "type": "string",
       "in": "body"
@@ -5350,7 +5350,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "tool_context",
-      "description": "Key-value pairs injected as context headers into all tool call requests made during this session.",
+      "description": "Key-value pairs forwarded as `X-Soat-Context-<Key>` headers on every `http`, `mcp` and `soat` tool call in this session. Each key's first character is uppercased and the rest is used verbatim. Keys are never case-converted — they round-trip exactly as sent. A key that is not a valid HTTP header name, or two keys that map to the same header, are rejected with `400 INVALID_TOOL_CONTEXT_KEY`.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -5418,7 +5418,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "tool_context",
-      "description": "Key-value pairs injected as context headers into all tool call requests made during this session.",
+      "description": "Key-value pairs forwarded as `X-Soat-Context-<Key>` headers on every `http`, `mcp` and `soat` tool call in this session. Each key's first character is uppercased and the rest is used verbatim. Keys are never case-converted — they round-trip exactly as sent. A key that is not a valid HTTP header name, or two keys that map to the same header, are rejected with `400 INVALID_TOOL_CONTEXT_KEY`.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -5474,7 +5474,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "tool_context",
-      "description": "Key-value pairs injected as context headers into all tool call requests made during this generation.",
+      "description": "Key-value pairs forwarded as `X-Soat-Context-<Key>` headers on every `http`, `mcp` and `soat` tool call in this generation. Each key's first character is uppercased and the rest is used verbatim. Keys are never case-converted — they round-trip exactly as sent. An invalid or colliding key is rejected with `400 INVALID_TOOL_CONTEXT_KEY`.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -5520,7 +5520,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "tool_context",
-      "description": "Key-value pairs injected as context headers into all tool call requests made during this generation.",
+      "description": "Key-value pairs forwarded as `X-Soat-Context-<Key>` headers on every `http`, `mcp` and `soat` tool call in this generation. Each key's first character is uppercased and the rest is used verbatim. Keys are never case-converted — they round-trip exactly as sent. An invalid or colliding key is rejected with `400 INVALID_TOOL_CONTEXT_KEY`.",
       "required": false,
       "type": "object",
       "in": "body"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/cli",
-  "version": "0.16.3",
+  "version": "0.17.0",
   "type": "module",
   "dependencies": {
     "@inquirer/input": "^5.1.2",
@@ -8,7 +8,7 @@
     "@ttoss/logger": "^0.8.19",
     "commander": "^15.0.0",
     "js-yaml": "^5.2.1",
-    "@soat/sdk": "0.16.3"
+    "@soat/sdk": "0.17.0"
   },
   "devDependencies": {
     "@ttoss/config": "^1.37.17",