@soat/cli 0.16.3 → 0.17.1

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.1";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -338,6 +338,46 @@ var resolveClient = profileName => {
 //#endregion
 //#region src/generated/routes.ts
 var routes = {
+  "list-activity": {
+    serviceClass: "Activity",
+    operationId: "listActivity",
+    description: "Returns activity entries for a project, newest first, filterable by kind and severity. Paginated with an opaque cursor rather than offset/limit — pass the previous page's `next_cursor` to fetch the next one; a `null` `next_cursor` means there is no more data.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/activity",
+    httpMethod: "get",
+    pathParams: [],
+    queryParams: ["project_id", "kind", "severity", "cursor", "limit"],
+    flags: [{
+      "name": "project_id",
+      "description": "Project ID (required if not using project key auth)",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
+      "name": "kind",
+      "description": "Filter by activity kind",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
+      "name": "severity",
+      "description": "Filter by severity",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
+      "name": "cursor",
+      "description": "Opaque cursor from a previous page's `next_cursor`",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
+      "name": "limit",
+      "description": "Maximum number of results to return",
+      "required": false,
+      "type": "integer",
+      "in": "query"
+    }]
+  },
   "list-actors": {
     serviceClass: "Actors",
     operationId: "listActors",
@@ -1094,7 +1134,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. The header name is `X-Soat-Context-` plus the key verbatim — no character is re-cased. 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 +2204,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. The header name is `X-Soat-Context-` plus the key verbatim — no character is re-cased and keys are never case-converted, so 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 +4683,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 +4702,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 +4755,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"],
@@ -5070,7 +5110,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "scope_ref",
-      "description": "Public id of the api key / agent the quota applies to. NULL means all entities of that scope type in the project.",
+      "description": "Public id of the api key / agent / actor the quota applies to. For `api_key` and `agent` scope, NULL means all entities of that scope type in the project. For `actor` scope, NULL means one budget *per* actor — each end user gets their own allowance — rather than a pooled total across all actors.",
       "required": false,
       "type": "string",
       "in": "body"
@@ -5319,7 +5359,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 +5378,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 +5390,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. The header name is `X-Soat-Context-` plus the key verbatim — no character is re-cased. 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 +5458,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. The header name is `X-Soat-Context-` plus the key verbatim — no character is re-cased. 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 +5514,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. The header name is `X-Soat-Context-` plus the key verbatim — no character is re-cased. 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 +5560,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. The header name is `X-Soat-Context-` plus the key verbatim — no character is re-cased. 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.1",
   "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.1"
   },
   "devDependencies": {
     "@ttoss/config": "^1.37.17",