@soat/cli 0.14.0 → 0.14.2

package/dist/index.mjs

@@ -7,11 +7,11 @@ import * as sdk from "@soat/sdk";
 import { createClient, createConfig } from "@soat/sdk";
 import { program } from "commander";
 import * as fs from "node:fs";
-import yaml from "js-yaml";
+import { load } from "js-yaml";
 import * as os from "node:os";
 
 //#region package.json
-var version = "0.14.0";
+var version = "0.14.2";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -62,11 +62,12 @@ var readTemplateFromPath = args => {
     return JSON.parse(trimmed);
   } catch {}
   try {
-    return yaml.load(trimmed);
+    return load(trimmed);
   } catch {
     throw new Error(`Template file must contain valid JSON or YAML: ${templatePath}`);
   }
 };
+var OMIT_PARAMETER = Symbol("omit-parameter");
 var resolveEnvRef = args => {
   const {
     value,
@@ -75,8 +76,7 @@ var resolveEnvRef = args => {
   const atRef = /^@([A-Za-z_][A-Za-z0-9_]*)$/.exec(value);
   if (atRef) {
     const resolved = env[atRef[1]];
-    if (resolved === void 0) throw new Error(`Missing environment variable: ${atRef[1]}`);
-    return resolved;
+    return resolved === void 0 ? OMIT_PARAMETER : resolved;
   }
   const simple = /^\$([A-Za-z_][A-Za-z0-9_]*)$/.exec(value);
   if (simple) {
@@ -103,10 +103,9 @@ var resolveParameterPair = args => {
     const key = pair.trim();
     if (!key) throw new Error(`Invalid --${PARAMETER_FLAG} value "${pair}". Parameter key cannot be empty.`);
     const resolved = env[key];
-    if (resolved === void 0) throw new Error(`Missing environment variable: ${key}`);
     return {
       key,
-      value: resolved
+      value: resolved === void 0 ? OMIT_PARAMETER : resolved
     };
   }
   const key = pair.slice(0, eqIdx).trim();
@@ -130,7 +129,7 @@ var formationsWrapper = {
     type: "string"
   }, {
     name: "parameter",
-    description: "Template parameter in key=value format (repeatable). Values support env var references: $VAR, ${VAR}, or @VAR_NAME (shell-safe). Omit the value entirely (--parameter KEY) to auto-read KEY from the merged env.",
+    description: "Template parameter in key=value format (repeatable). Values support env var references: $VAR, ${VAR}, or @VAR_NAME (shell-safe). Omit the value entirely (--parameter KEY) to auto-read KEY from the merged env. For @VAR_NAME and bare KEY, an unset env var omits the parameter instead of failing, so the server reuses a previous value (formation parameters declared `use_previous_value`) or errors if none exists.",
     required: false,
     type: "string"
   }, {
@@ -182,7 +181,7 @@ var formationsWrapper = {
           pair,
           env: mergedEnv
         });
-        resolvedParameters[key] = value;
+        if (value !== OMIT_PARAMETER) resolvedParameters[key] = value;
       }
       forcedBody[PARAMETERS_FIELD] = resolvedParameters;
     }
@@ -4192,7 +4191,7 @@ var routes = {
   "delete-session": {
     serviceClass: "Sessions",
     operationId: "deleteSession",
-    description: "Deletes the session and its underlying conversation and actors.",
+    description: "Deletes the session and its underlying conversation and messages. The session's actor is not deleted. Generations and traces produced by the session are not deleted either, since they are not linked to the session or conversation.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/sessions",
     pathParams: ["session_id"],
     queryParams: [],
@@ -4431,10 +4430,10 @@ var routes = {
       "type": "object",
       "in": "body"
     }, {
-      "name": "discussion",
-      "description": "Discussion config for `discussion` tools: `{ discussion_id }`. See the `discussion` field on the Tool schema for details.",
+      "name": "discussion_id",
+      "description": "For `discussion` tools: the ID of the discussion to invoke.",
       "required": false,
-      "type": "object",
+      "type": "string",
       "in": "body"
     }, {
       "name": "output_mapping",
@@ -4527,10 +4526,10 @@ var routes = {
       "type": "object",
       "in": "body"
     }, {
-      "name": "discussion",
-      "description": "Discussion config for `discussion` tools: `{ discussion_id }`. See the `discussion` field on the Tool schema for details.",
+      "name": "discussion_id",
+      "description": "For `discussion` tools: the ID of the discussion to invoke.",
       "required": false,
-      "type": "object",
+      "type": "string",
       "in": "body"
     }, {
       "name": "output_mapping",
@@ -4645,6 +4644,300 @@ var routes = {
       "in": "query"
     }]
   },
+  "list-triggers": {
+    serviceClass: "Triggers",
+    operationId: "listTriggers",
+    description: "Lists triggers. Filter by project, starter type, or target type.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    pathParams: [],
+    queryParams: ["project_id", "type", "target_type"],
+    flags: [{
+      "name": "project_id",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
+      "name": "type",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
+      "name": "target_type",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }]
+  },
+  "create-trigger": {
+    serviceClass: "Triggers",
+    operationId: "createTrigger",
+    description: "Creates a new trigger for a project",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    pathParams: [],
+    queryParams: [],
+    flags: [{
+      "name": "project_id",
+      "description": "Public ID of the project. Optional when authenticating with a project-scoped API key, which defaults to the key's project; required otherwise.",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "name",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "description",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "type",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "target_type",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "target_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "action",
+      "description": "Tool targets only — the action for soat/mcp tools",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "input",
+      "description": "",
+      "required": false,
+      "type": "object",
+      "in": "body"
+    }, {
+      "name": "cron",
+      "description": "5-field cron expression (UTC). Required when type is schedule",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "active",
+      "description": "",
+      "required": false,
+      "type": "boolean",
+      "in": "body"
+    }, {
+      "name": "policy_id",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }]
+  },
+  "get-trigger": {
+    serviceClass: "Triggers",
+    operationId: "getTrigger",
+    description: "Retrieves the details of a specific trigger",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    pathParams: ["trigger_id"],
+    queryParams: [],
+    flags: [{
+      "name": "trigger_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
+  "update-trigger": {
+    serviceClass: "Triggers",
+    operationId: "updateTrigger",
+    description: "Updates an existing trigger's configuration. The type is immutable.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    pathParams: ["trigger_id"],
+    queryParams: [],
+    flags: [{
+      "name": "trigger_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "name",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "description",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "target_type",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "target_id",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "action",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "input",
+      "description": "",
+      "required": false,
+      "type": "object",
+      "in": "body"
+    }, {
+      "name": "cron",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "active",
+      "description": "",
+      "required": false,
+      "type": "boolean",
+      "in": "body"
+    }, {
+      "name": "policy_id",
+      "description": "",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }]
+  },
+  "delete-trigger": {
+    serviceClass: "Triggers",
+    operationId: "deleteTrigger",
+    description: "Deletes a trigger",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    pathParams: ["trigger_id"],
+    queryParams: [],
+    flags: [{
+      "name": "trigger_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
+  "fire-trigger": {
+    serviceClass: "Triggers",
+    operationId: "fireTrigger",
+    description: "Fires a trigger synchronously and returns the terminal firing record.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    pathParams: ["trigger_id"],
+    queryParams: [],
+    flags: [{
+      "name": "trigger_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "input",
+      "description": "Fire-time input, shallow-merged over the trigger's static input",
+      "required": false,
+      "type": "object",
+      "in": "body"
+    }]
+  },
+  "get-trigger-secret": {
+    serviceClass: "Triggers",
+    operationId: "getTriggerSecret",
+    description: "Retrieves the signing secret for a webhook trigger",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    pathParams: ["trigger_id"],
+    queryParams: [],
+    flags: [{
+      "name": "trigger_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
+  "rotate-trigger-secret": {
+    serviceClass: "Triggers",
+    operationId: "rotateTriggerSecret",
+    description: "Rotates the signing secret for a webhook trigger",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    pathParams: ["trigger_id"],
+    queryParams: [],
+    flags: [{
+      "name": "trigger_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
+  "list-trigger-firings": {
+    serviceClass: "Triggers",
+    operationId: "listTriggerFirings",
+    description: "Lists firings for a trigger (trigger_id is required).",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    pathParams: [],
+    queryParams: ["trigger_id", "limit", "offset"],
+    flags: [{
+      "name": "trigger_id",
+      "description": "Trigger to list firings for (trg_...)",
+      "required": true,
+      "type": "string",
+      "in": "query"
+    }, {
+      "name": "limit",
+      "description": "",
+      "required": false,
+      "type": "integer",
+      "in": "query"
+    }, {
+      "name": "offset",
+      "description": "",
+      "required": false,
+      "type": "integer",
+      "in": "query"
+    }]
+  },
+  "get-trigger-firing": {
+    serviceClass: "Triggers",
+    operationId: "getTriggerFiring",
+    description: "Retrieves the details of a specific trigger firing",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/triggers",
+    pathParams: ["firing_id"],
+    queryParams: [],
+    flags: [{
+      "name": "firing_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
   "get-current-user": {
     serviceClass: "Users",
     operationId: "getCurrentUser",
@@ -4771,7 +5064,7 @@ var routes = {
     queryParams: [],
     flags: [{
       "name": "user_id",
-      "description": "User public ID (usr_ prefix)",
+      "description": "User public ID (user_ prefix)",
       "required": true,
       "type": "string",
       "in": "path"

package/package.json

@@ -1,24 +1,23 @@
 {
   "name": "@soat/cli",
-  "version": "0.14.0",
+  "version": "0.14.2",
   "type": "module",
   "dependencies": {
     "@inquirer/input": "^5.1.2",
     "@inquirer/password": "^5.1.1",
-    "@ttoss/logger": "^0.8.16",
+    "@ttoss/logger": "^0.8.19",
     "commander": "^15.0.0",
-    "js-yaml": "^4.2.0",
-    "@soat/sdk": "0.14.0"
+    "js-yaml": "^5.2.1",
+    "@soat/sdk": "0.14.2"
   },
   "devDependencies": {
-    "@ttoss/config": "^1.37.15",
-    "@ttoss/test-utils": "^4.2.15",
+    "@ttoss/config": "^1.37.17",
+    "@ttoss/test-utils": "^4.2.18",
     "@types/jest": "^30.0.0",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^24",
+    "@types/node": "^24.13.2",
     "jest": "^30.4.2",
-    "tsdown": "^0.22.1",
-    "tsx": "^4.22.4"
+    "tsdown": "^0.22.3",
+    "tsx": "^4.23.0"
   },
   "files": [
     "dist",