@soat/cli 0.13.18 → 0.13.20

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.18";
+var version = "0.13.20";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -611,6 +611,12 @@ var routes = {
       "required": false,
       "type": "array",
       "in": "body"
+    }, {
+      "name": "tools",
+      "description": "Ephemeral tool definitions available only to this agent's generations — no separate Tool resource is created (any `project_id` on an entry is ignored), so they never appear in `GET /tools` and cannot be targeted by `active_tool_ids`/ `step_rules` (which reference `tool_ids`). Cannot be of type `pipeline`; nest a persisted pipeline tool via `tool_ids` instead. Use `tool_ids` to reference existing tools and `tools` for ones scoped to just this agent.",
+      "required": false,
+      "type": "array",
+      "in": "body"
     }, {
       "name": "max_steps",
       "description": "",
@@ -661,7 +667,7 @@ var routes = {
       "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.",
+      "description": "Deep-thinking configuration. `effort` forwards provider-native reasoning; `mode: pipeline` runs an ordered list of reasoning steps after the base draft, each step running 1..N branches over 1..R rounds. reflect, debate, and best-of-N are expressed as pipelines over this primitive — see the Agents module docs and the deep-thinking tutorial. As a per-generation override (in the generate request body), this replaces the agent's stored reasoning config entirely (object replace, not merge).",
       "required": false,
       "type": "object",
       "in": "body"
@@ -743,6 +749,12 @@ var routes = {
       "required": false,
       "type": "array",
       "in": "body"
+    }, {
+      "name": "tools",
+      "description": "Ephemeral tool definitions available only to this agent's generations — no separate Tool resource is created (any `project_id` on an entry is ignored), so they never appear in `GET /tools` and cannot be targeted by `active_tool_ids`/ `step_rules` (which reference `tool_ids`). Cannot be of type `pipeline`; nest a persisted pipeline tool via `tool_ids` instead. Replaces the agent's entire `tools` array; set to `null` to clear.",
+      "required": false,
+      "type": "array",
+      "in": "body"
     }, {
       "name": "max_steps",
       "description": "",
@@ -793,7 +805,7 @@ var routes = {
       "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.",
+      "description": "Deep-thinking configuration. `effort` forwards provider-native reasoning; `mode: pipeline` runs an ordered list of reasoning steps after the base draft, each step running 1..N branches over 1..R rounds. reflect, debate, and best-of-N are expressed as pipelines over this primitive — see the Agents module docs and the deep-thinking tutorial. As a per-generation override (in the generate request body), this replaces the agent's stored reasoning config entirely (object replace, not merge).",
       "required": false,
       "type": "object",
       "in": "body"
@@ -860,6 +872,12 @@ var routes = {
       "required": false,
       "type": "array",
       "in": "body"
+    }, {
+      "name": "tools",
+      "description": "Ephemeral tool definitions available only to this agent's generations — no separate Tool resource is created (any `project_id` on an entry is ignored), so they never appear in `GET /tools` and cannot be targeted by `active_tool_ids`/ `step_rules` (which reference `tool_ids`). Cannot be of type `pipeline`; nest a persisted pipeline tool via `tool_ids` instead. Replaces the agent's entire `tools` array; set to `null` to clear.",
+      "required": false,
+      "type": "array",
+      "in": "body"
     }, {
       "name": "max_steps",
       "description": "",
@@ -910,7 +928,7 @@ var routes = {
       "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.",
+      "description": "Deep-thinking configuration. `effort` forwards provider-native reasoning; `mode: pipeline` runs an ordered list of reasoning steps after the base draft, each step running 1..N branches over 1..R rounds. reflect, debate, and best-of-N are expressed as pipelines over this primitive — see the Agents module docs and the deep-thinking tutorial. As a per-generation override (in the generate request body), this replaces the agent's stored reasoning config entirely (object replace, not merge).",
       "required": false,
       "type": "object",
       "in": "body"
@@ -1018,7 +1036,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "reasoning",
-      "description": "Per-generation deep-thinking override. Replaces the agent's stored reasoning config for this request (object replace, not merge). Same shape as the agent `reasoning` field.",
+      "description": "Deep-thinking configuration. `effort` forwards provider-native reasoning; `mode: pipeline` runs an ordered list of reasoning steps after the base draft, each step running 1..N branches over 1..R rounds. reflect, debate, and best-of-N are expressed as pipelines over this primitive — see the Agents module docs and the deep-thinking tutorial. As a per-generation override (in the generate request body), this replaces the agent's stored reasoning config entirely (object replace, not merge).",
       "required": false,
       "type": "object",
       "in": "body"
@@ -1813,7 +1831,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "metadata",
-      "description": "Arbitrary metadata object",
+      "description": "Arbitrary metadata object. Unlike other body fields, keys are stored and returned verbatim in the casing supplied — they are not converted between snake_case and camelCase.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -1948,7 +1966,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "metadata",
-      "description": "Arbitrary metadata object",
+      "description": "Arbitrary metadata object. Unlike other body fields, keys are stored and returned verbatim in the casing supplied — they are not converted between snake_case and camelCase.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -2473,7 +2491,7 @@ var routes = {
     queryParams: [],
     flags: [{
       "name": "template",
-      "description": "",
+      "description": "A formation template supplied as either a JSON object or a YAML/JSON string. When a string is provided the server parses it with a YAML parser (JSON is valid YAML) before processing.\n",
       "required": false,
       "type": "string",
       "in": "body"
@@ -2506,7 +2524,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "template",
-      "description": "",
+      "description": "A formation template supplied as either a JSON object or a YAML/JSON string. When a string is provided the server parses it with a YAML parser (JSON is valid YAML) before processing.\n",
       "required": true,
       "type": "string",
       "in": "body"
@@ -2554,7 +2572,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "template",
-      "description": "",
+      "description": "A formation template supplied as either a JSON object or a YAML/JSON string. When a string is provided the server parses it with a YAML parser (JSON is valid YAML) before processing.\n",
       "required": true,
       "type": "string",
       "in": "body"
@@ -2602,7 +2620,7 @@ var routes = {
       "in": "path"
     }, {
       "name": "template",
-      "description": "",
+      "description": "A formation template supplied as either a JSON object or a YAML/JSON string. When a string is provided the server parses it with a YAML parser (JSON is valid YAML) before processing.\n",
       "required": false,
       "type": "string",
       "in": "body"
@@ -3400,7 +3418,7 @@ var routes = {
   "start-orchestration-run": {
     serviceClass: "Orchestrations",
     operationId: "startOrchestrationRun",
-    description: "Creates and immediately executes a new run for the orchestration named by orchestration_id.",
+    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/paused/completed/failed). Delay and poll waits are offloaded to a background scheduler and survive restarts. Pass wait=true to block until the run reaches a terminal or paused state (the legacy synchronous behaviour).",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/orchestrations",
     pathParams: [],
     queryParams: [],
@@ -3416,6 +3434,12 @@ var routes = {
       "required": false,
       "type": "object",
       "in": "body"
+    }, {
+      "name": "wait",
+      "description": "When true, block until the run reaches a terminal (completed/failed) or paused state and return the settled run. When false (default), return immediately with status \"running\" and execute the run in the background.",
+      "required": false,
+      "type": "boolean",
+      "in": "body"
     }]
   },
   "cancel-orchestration-run": {
@@ -3528,7 +3552,7 @@ var routes = {
       "name": "document",
       "description": "",
       "required": true,
-      "type": "string",
+      "type": "object",
       "in": "body"
     }]
   },
@@ -3576,7 +3600,7 @@ var routes = {
       "name": "document",
       "description": "",
       "required": true,
-      "type": "string",
+      "type": "object",
       "in": "body"
     }]
   },

package/package.json

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