@soat/cli 0.18.1 → 0.18.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.18.1";
+var version = "0.18.3";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -788,6 +788,12 @@ var routes = {
       "required": false,
       "type": "boolean",
       "in": "body"
+    }, {
+      "name": "version_label",
+      "description": "Optional tag for the config version this write archives (e.g. `initial`). Annotates the version only — it is not stored on the agent and is not part of the config, so labelling a change is never itself a change.",
+      "required": false,
+      "type": "string",
+      "in": "body"
     }]
   },
   "get-agent": {
@@ -940,6 +946,12 @@ var routes = {
       "required": false,
       "type": "boolean",
       "in": "body"
+    }, {
+      "name": "version_label",
+      "description": "Optional tag for the config version this write archives (e.g. `pre-tone-change`). Annotates the version only — it is not stored on the agent and is not part of the config, so labelling a change is never itself a change. Ignored when the write changes nothing, since no version is created.",
+      "required": false,
+      "type": "string",
+      "in": "body"
     }]
   },
   "patch-agent": {
@@ -1076,6 +1088,12 @@ var routes = {
       "required": false,
       "type": "boolean",
       "in": "body"
+    }, {
+      "name": "version_label",
+      "description": "Optional tag for the config version this write archives (e.g. `pre-tone-change`). Annotates the version only — it is not stored on the agent and is not part of the config, so labelling a change is never itself a change. Ignored when the write changes nothing, since no version is created.",
+      "required": false,
+      "type": "string",
+      "in": "body"
     }]
   },
   "delete-agent": {
@@ -1216,6 +1234,150 @@ var routes = {
       "in": "body"
     }]
   },
+  "list-agent-versions": {
+    serviceClass: "AgentVersions",
+    operationId: "listAgentVersions",
+    description: "Returns the agent's archived configurations, newest first. A version is written on create and on every subsequent write that changes the config — through the REST API or a formation apply alike. See [Versioning and Staged Rollout](/docs/modules/agents#versioning-and-staged-rollout).",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
+    httpMethod: "get",
+    pathParams: ["agent_id"],
+    queryParams: ["limit", "offset"],
+    flags: [{
+      "name": "agent_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "limit",
+      "description": "Maximum number of results to return",
+      "required": false,
+      "type": "integer",
+      "in": "query"
+    }, {
+      "name": "offset",
+      "description": "Number of results to skip",
+      "required": false,
+      "type": "integer",
+      "in": "query"
+    }]
+  },
+  "get-agent-version": {
+    serviceClass: "AgentVersions",
+    operationId: "getAgentVersion",
+    description: "Returns the exact configuration the agent held at a given version, so a generation can be traced back to the config that produced it.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
+    httpMethod: "get",
+    pathParams: ["agent_id", "version"],
+    queryParams: [],
+    flags: [{
+      "name": "agent_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "version",
+      "description": "",
+      "required": true,
+      "type": "integer",
+      "in": "path"
+    }]
+  },
+  "restore-agent-version": {
+    serviceClass: "AgentVersions",
+    operationId: "restoreAgentVersion",
+    description: "Copies the named version's configuration onto the agent as a **new** version rather than rewinding the counter, so history stays append-only and the versions in between remain retrievable. Restoring the config the agent already holds is a no-op and creates no version. The restored config fully replaces the current one: a field the archived version did not set is cleared, not merged. Restore re-validates the config, so a tool, provider, or guardrail deleted since the snapshot was taken fails the request instead of writing a broken agent.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
+    httpMethod: "post",
+    pathParams: ["agent_id", "version"],
+    queryParams: [],
+    flags: [{
+      "name": "agent_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "version",
+      "description": "",
+      "required": true,
+      "type": "integer",
+      "in": "path"
+    }, {
+      "name": "label",
+      "description": "Tag for the version this restore creates. Defaults to `restored from v{version}`.",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }]
+  },
+  "set-agent-release": {
+    serviceClass: "AgentVersions",
+    operationId: "setAgentRelease",
+    description: "Starts serving two archived versions side by side: `canary_percent` of traffic gets `canary_version`, the rest gets `stable_version`. Assignment is deterministic — it hashes the actor behind the request's session (falling back to the session itself), so one end user never flip-flops between configs mid-conversation. Requests with neither are split randomly. While a release is active the agent's live columns act as a **draft**: further edits archive new versions but do not disturb either side of the running split. End the rollout with `promote` or `abort`.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
+    httpMethod: "put",
+    pathParams: ["agent_id"],
+    queryParams: [],
+    flags: [{
+      "name": "agent_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "stable_version",
+      "description": "An existing version to serve as the baseline",
+      "required": true,
+      "type": "integer",
+      "in": "body"
+    }, {
+      "name": "canary_version",
+      "description": "An existing version to trial. Must differ from `stable_version`.",
+      "required": true,
+      "type": "integer",
+      "in": "body"
+    }, {
+      "name": "canary_percent",
+      "description": "Percentage of traffic to assign to `canary_version`",
+      "required": true,
+      "type": "integer",
+      "in": "body"
+    }]
+  },
+  "promote-agent-release": {
+    serviceClass: "AgentVersions",
+    operationId: "promoteAgentRelease",
+    description: "Makes the canary version's config the agent's live config and clears the release. The canary is pinned by version, so an edit that landed mid-rollout is not promoted in its place — it stays an unreleased draft in the version history.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
+    httpMethod: "post",
+    pathParams: ["agent_id"],
+    queryParams: [],
+    flags: [{
+      "name": "agent_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
+  "abort-agent-release": {
+    serviceClass: "AgentVersions",
+    operationId: "abortAgentRelease",
+    description: "Restores the stable version's config as the agent's live config and clears the release, so all traffic returns to the configuration the rollout was measured against — not to whatever draft the live columns happened to hold.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
+    httpMethod: "post",
+    pathParams: ["agent_id"],
+    queryParams: [],
+    flags: [{
+      "name": "agent_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
   "list-ai-providers": {
     serviceClass: "AIProviders",
     operationId: "listAiProviders",
@@ -2653,7 +2815,7 @@ var routes = {
   "ingest-document": {
     serviceClass: "Documents",
     operationId: "ingestDocument",
-    description: "Parses an already-uploaded file and creates one Document split into one or more embedded chunks. The source format is detected from the file's content type: PDFs are parsed page-by-page; `text/plain` and `text/markdown` files are read as a single source. How the source is chunked is controlled by `chunk_strategy`.",
+    description: "Parses an already-uploaded file and creates one Document split into one or more embedded chunks. The source format is detected from the file's content type: PDFs are parsed page-by-page; `text/plain` and `text/markdown` files are read as a single source. How the source is chunked is controlled by `chunk_strategy`. A file can only back one Document — a second call with the same `file_id` returns `409 FILE_ALREADY_INGESTED`. To re-process an already-ingested file (e.g. with a different `chunk_strategy`), use `POST /documents/{document_id}/ingest`; to ingest the same source under a different path, upload a new copy of the file first.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/documents",
     httpMethod: "post",
     pathParams: [],

package/package.json

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