@soat/cli 0.17.0 → 0.17.3

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.17.0";
+var version = "0.17.3";
 
 //#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 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`.",
+      "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"
@@ -1112,7 +1152,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "metadata",
-      "description": "Caller-supplied key/value metadata attached to the generation record for per-run audit attribution (e.g. the knowledge-corpus version that produced this action). Round-trips when the generation is fetched via the generations API. Reserved server-owned keys (`action_id`, `trigger_id`, `run_id`, `node_id`, `extraction`, and internal recovery state) cannot be set here and are rejected with 400.",
+      "description": "Caller-supplied key/value metadata attached to the generation record for per-run audit attribution (e.g. the knowledge-corpus version that produced this action). Round-trips when the generation is fetched via the generations API. Reserved server-owned keys (`action_id`, `trigger_id`, `orchestration_run_id`, `node_id`, `extraction`, and internal recovery state) cannot be set here and are rejected with 400.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -2164,7 +2204,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "tool_context",
-      "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`.",
+      "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"
@@ -3621,7 +3661,7 @@ var routes = {
   "update-generation": {
     serviceClass: "Generations",
     operationId: "updateGeneration",
-    description: "Attaches caller-supplied key/value metadata to a generation record for per-run audit attribution (e.g. recording which knowledge-corpus version produced an AI action). The provided keys are shallow-merged over the existing metadata, so repeated patches accumulate and system-owned keys are preserved. Reserved keys (`action_id`, `trigger_id`, `run_id`, `node_id`, `extraction`, and internal recovery state) cannot be set and are rejected with 400.",
+    description: "Attaches caller-supplied key/value metadata to a generation record for per-run audit attribution (e.g. recording which knowledge-corpus version produced an AI action). The provided keys are shallow-merged over the existing metadata, so repeated patches accumulate and system-owned keys are preserved. Reserved keys (`action_id`, `trigger_id`, `orchestration_run_id`, `node_id`, `extraction`, and internal recovery state) cannot be set and are rejected with 400.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/generations",
     httpMethod: "patch",
     pathParams: ["generation_id"],
@@ -3634,7 +3674,7 @@ var routes = {
       "in": "path"
     }, {
       "name": "metadata",
-      "description": "Caller-supplied key/value metadata to shallow-merge into the generation record. Reserved server-owned keys (`action_id`, `trigger_id`, `run_id`, `node_id`, `extraction`, and internal recovery state) are rejected with 400.\n",
+      "description": "Caller-supplied key/value metadata to shallow-merge into the generation record. Reserved server-owned keys (`action_id`, `trigger_id`, `orchestration_run_id`, `node_id`, `extraction`, and internal recovery state) are rejected with 400.\n",
       "required": true,
       "type": "object",
       "in": "body"
@@ -4674,10 +4714,10 @@ var routes = {
     description: "Cancels a run that has not yet reached a terminal state.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
     httpMethod: "post",
-    pathParams: ["run_id"],
+    pathParams: ["orchestration_run_id"],
     queryParams: [],
     flags: [{
-      "name": "run_id",
+      "name": "orchestration_run_id",
       "description": "Public ID of the run (run_...)",
       "required": true,
       "type": "string",
@@ -4690,10 +4730,10 @@ var routes = {
     description: "Provides human input to a run that is awaiting_input at a human node.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
     httpMethod: "post",
-    pathParams: ["run_id"],
+    pathParams: ["orchestration_run_id"],
     queryParams: [],
     flags: [{
-      "name": "run_id",
+      "name": "orchestration_run_id",
       "description": "Public ID of the run (run_...)",
       "required": true,
       "type": "string",
@@ -4718,10 +4758,10 @@ var routes = {
     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"],
+    pathParams: ["orchestration_run_id"],
     queryParams: [],
     flags: [{
-      "name": "run_id",
+      "name": "orchestration_run_id",
       "description": "Public ID of the run (run_...)",
       "required": true,
       "type": "string",
@@ -4734,10 +4774,10 @@ var routes = {
     description: "Returns the status, state, and artifacts of a specific run.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
     httpMethod: "get",
-    pathParams: ["run_id"],
+    pathParams: ["orchestration_run_id"],
     queryParams: [],
     flags: [{
-      "name": "run_id",
+      "name": "orchestration_run_id",
       "description": "Public ID of the run (run_...)",
       "required": true,
       "type": "string",
@@ -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"
@@ -5350,7 +5390,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "tool_context",
-      "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`.",
+      "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 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`.",
+      "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 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`.",
+      "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 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`.",
+      "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"
@@ -6647,19 +6687,19 @@ var routes = {
   "get-usage-receipt": {
     serviceClass: "Usage",
     operationId: "getUsageReceipt",
-    description: "Returns a billing receipt. Pass generation_id for a per-generation receipt, or run_id for a per-run receipt summed across the orchestration run's meters — both share the same shape (per-model line items with tokens, the price-book version that priced them, and cost, plus totals). Exactly one of generation_id or run_id must be supplied.",
+    description: "Returns a billing receipt. Pass generation_id for a per-generation receipt, or orchestration_run_id for a per-run receipt summed across the orchestration run's meters — both share the same shape (per-model line items with tokens, the price-book version that priced them, and cost, plus totals). Exactly one of generation_id or orchestration_run_id must be supplied.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
     httpMethod: "get",
     pathParams: [],
-    queryParams: ["generation_id", "run_id"],
+    queryParams: ["generation_id", "orchestration_run_id"],
     flags: [{
       "name": "generation_id",
-      "description": "Generation public ID. Mutually exclusive with run_id.\n",
+      "description": "Generation public ID. Mutually exclusive with orchestration_run_id.\n",
       "required": false,
       "type": "string",
       "in": "query"
     }, {
-      "name": "run_id",
+      "name": "orchestration_run_id",
       "description": "Orchestration run public ID. Returns the receipt summed across every generation the run metered. Mutually exclusive with generation_id.\n",
       "required": false,
       "type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/cli",
-  "version": "0.17.0",
+  "version": "0.17.3",
   "type": "module",
   "dependencies": {
     "@inquirer/input": "^5.1.2",
@@ -8,10 +8,11 @@
     "@ttoss/logger": "^0.8.19",
     "commander": "^15.0.0",
     "js-yaml": "^5.2.1",
-    "@soat/sdk": "0.17.0"
+    "@soat/sdk": "0.17.3"
   },
   "devDependencies": {
     "@ttoss/config": "^1.37.17",
+    "@ttoss/openapi-codegen": "^0.2.0",
     "@ttoss/test-utils": "^4.2.18",
     "@types/jest": "^30.0.0",
     "@types/node": "^26.1.1",