@soat/cli 0.15.4 → 0.15.6

package/dist/index.mjs

@@ -3,6 +3,8 @@ import { createHmac, timingSafeEqual } from "node:crypto";
 import { createServer } from "node:http";
 import * as path from "node:path";
 import { fileURLToPath } from "node:url";
+import input from "@inquirer/input";
+import password from "@inquirer/password";
 import * as sdk from "@soat/sdk";
 import { createClient, createConfig } from "@soat/sdk";
 import { program } from "commander";
@@ -11,7 +13,7 @@ import { load } from "js-yaml";
 import * as os from "node:os";
 
 //#region package.json
-var version = "0.15.4";
+var version = "0.15.6";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -628,15 +630,21 @@ var routes = {
       "required": false,
       "type": "string",
       "in": "body"
+    }, {
+      "name": "tool_bindings",
+      "description": "Tools to attach, one binding object per tool — the canonical attachment field. Cannot be combined with the deprecated `tool_ids`/`tools` shorthands (400). See [Tool Bindings](/docs/modules/agents#tool-bindings).",
+      "required": false,
+      "type": "array",
+      "in": "body"
     }, {
       "name": "tool_ids",
-      "description": "",
+      "description": "Deprecated shorthand — each entry becomes a bare `{ \"tool_id\": … }` binding. Use `tool_bindings` instead.",
       "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.",
+      "description": "Deprecated shorthand — each entry becomes a bare `{ \"tool\": … }` binding (an ephemeral definition: no separate Tool resource is created, any `project_id` on an entry is ignored, entries never appear in `GET /tools`, cannot be targeted by `active_tool_ids`/`step_rules`, and cannot be of type `pipeline`). Use `tool_bindings` instead.",
       "required": false,
       "type": "array",
       "in": "body"
@@ -760,15 +768,21 @@ var routes = {
       "required": false,
       "type": "string",
       "in": "body"
+    }, {
+      "name": "tool_bindings",
+      "description": "Tools attached to the agent — the canonical attachment field. Replaces the whole binding list; set to `null` to clear. Cannot be combined with the deprecated `tool_ids`/`tools` shorthands (400). See [Tool Bindings](/docs/modules/agents#tool-bindings).",
+      "required": false,
+      "type": "array",
+      "in": "body"
     }, {
       "name": "tool_ids",
-      "description": "",
+      "description": "Deprecated shorthand — replaces only the reference (`tool_id`) bindings, rewriting them bare (any `approval_policy` on them is dropped). Use `tool_bindings` instead.",
       "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.",
+      "description": "Deprecated shorthand — replaces only the inline (`tool`) bindings (ephemeral definitions: no separate Tool resource is created, any `project_id` on an entry is ignored, entries never appear in `GET /tools`, cannot be targeted by `active_tool_ids`/`step_rules`, and cannot be of type `pipeline`). Set to `null` to clear the inline bindings. Use `tool_bindings` instead.",
       "required": false,
       "type": "array",
       "in": "body"
@@ -877,15 +891,21 @@ var routes = {
       "required": false,
       "type": "string",
       "in": "body"
+    }, {
+      "name": "tool_bindings",
+      "description": "Tools attached to the agent — the canonical attachment field. Replaces the whole binding list; set to `null` to clear. Cannot be combined with the deprecated `tool_ids`/`tools` shorthands (400). See [Tool Bindings](/docs/modules/agents#tool-bindings).",
+      "required": false,
+      "type": "array",
+      "in": "body"
     }, {
       "name": "tool_ids",
-      "description": "",
+      "description": "Deprecated shorthand — replaces only the reference (`tool_id`) bindings, rewriting them bare (any `approval_policy` on them is dropped). Use `tool_bindings` instead.",
       "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.",
+      "description": "Deprecated shorthand — replaces only the inline (`tool`) bindings (ephemeral definitions: no separate Tool resource is created, any `project_id` on an entry is ignored, entries never appear in `GET /tools`, cannot be targeted by `active_tool_ids`/`step_rules`, and cannot be of type `pipeline`). Set to `null` to clear the inline bindings. Use `tool_bindings` instead.",
       "required": false,
       "type": "array",
       "in": "body"
@@ -1039,6 +1059,12 @@ var routes = {
       "required": false,
       "type": "string",
       "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.",
+      "required": false,
+      "type": "object",
+      "in": "body"
     }, {
       "name": "extract",
       "description": "Per-turn override of the agent's `knowledge_config.extraction` default. Omit to follow the agent's stored config. Set `false` to suppress automatic memory extraction for this turn (e.g. an operational or tool-listing turn that would only add noise to a curated memory). Set `true` to force extraction on for this turn even when the agent does not enable it by default, provided the agent has a `write_memory_id`. Has no effect on streaming or `requires_action` turns, which never extract.",
@@ -3123,6 +3149,27 @@ var routes = {
       "in": "path"
     }]
   },
+  "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.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/generations",
+    pathParams: ["generation_id"],
+    queryParams: [],
+    flags: [{
+      "name": "generation_id",
+      "description": "Public ID of the generation",
+      "required": true,
+      "type": "string",
+      "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",
+      "required": true,
+      "type": "object",
+      "in": "body"
+    }]
+  },
   "list-ingestion-rules": {
     serviceClass: "IngestionRules",
     operationId: "listIngestionRules",
@@ -3556,6 +3603,18 @@ var routes = {
       "required": false,
       "type": "string",
       "in": "body"
+    }, {
+      "name": "tags",
+      "description": "Per-entry tag strings, used for entry-granularity filtering in search-knowledge (memory_tags)",
+      "required": false,
+      "type": "array",
+      "in": "body"
+    }, {
+      "name": "metadata",
+      "description": "Arbitrary structured metadata attached to the entry",
+      "required": false,
+      "type": "object",
+      "in": "body"
     }, {
       "name": "duplicate_threshold",
       "description": "Cosine similarity score at or above which the incoming content is considered a duplicate and skipped (default 0.95)",
@@ -3604,6 +3663,18 @@ var routes = {
       "required": false,
       "type": "string",
       "in": "body"
+    }, {
+      "name": "tags",
+      "description": "Replaces the entry's tags. Pass null or an empty array to clear.",
+      "required": false,
+      "type": "array",
+      "in": "body"
+    }, {
+      "name": "metadata",
+      "description": "Replaces the entry's metadata. Pass null to clear.",
+      "required": false,
+      "type": "object",
+      "in": "body"
     }]
   },
   "delete-memory-entry": {
@@ -5768,11 +5839,6 @@ var resolveServiceClass = serviceClassName => {
 program.name("soat").description("SOAT CLI").version(version).option("-p, --profile <name>", "config profile to use");
 program.addHelpText("after", "\nTip: Run `soat <command> --help` to see command-specific flags and docs.");
 program.command("configure").description("Save credentials to a named profile (~/.soat/config.json)").option("-p, --profile <name>", "profile name", "default").action(async opts => {
-  const [{
-    default: input
-  }, {
-    default: password
-  }] = await Promise.all([import("@inquirer/input"), import("@inquirer/password")]);
   const baseUrl = await input({
     message: "Base URL:"
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/cli",
-  "version": "0.15.4",
+  "version": "0.15.6",
   "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.15.4"
+    "@soat/sdk": "0.15.6"
   },
   "devDependencies": {
     "@ttoss/config": "^1.37.17",