@soat/cli 0.48.0 → 0.49.1

package/dist/index.mjs

@@ -13,7 +13,7 @@ import * as os from "node:os";
 import { createHmac, timingSafeEqual } from "node:crypto";
 
 //#region package.json
-var version = "0.48.0";
+var version = "0.49.1";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -4967,7 +4967,7 @@ var routes = {
   "search-knowledge": {
     serviceClass: "Knowledge",
     operationId: "searchKnowledge",
-    description: "Searches across documents and memory entries using semantic search, file paths, document IDs, memory IDs, or tags. At least one of `query`, `tags`, `document_paths`, `document_ids`, or `memory_ids` must be provided.",
+    description: "Searches across documents and memory entries using hybrid retrieval — a vector query and a full-text query per source, fused by reciprocal rank — or by file paths, document IDs, memory IDs, or tags. At least one of `query`, `tags`, `document_paths`, `document_ids`, or `memory_ids` must be provided.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/knowledge",
     httpMethod: "post",
     pathParams: [],
@@ -4980,13 +4980,31 @@ var routes = {
       "in": "body"
     }, {
       "name": "query",
-      "description": "Semantic search query text",
+      "description": "Search query text. Runs a vector query and a full-text query over each store and fuses the rankings; the full-text channel matches exact tokens and phrases, the vector channel everything else.",
       "required": false,
       "type": "string",
       "in": "body"
+    }, {
+      "name": "min_similarity",
+      "description": "Minimum raw cosine `similarity_score` a **vector** candidate must reach to take part in ranking, applied before fusion. Only applies when `query` is provided. Lexical candidates are deliberately exempt: a result that literally contains the searched token is the evidence, and dropping it for a low cosine is the failure hybrid search exists to prevent. Not a floor on `score`, whose fused value encodes rank position rather than similarity.",
+      "required": false,
+      "type": "number",
+      "in": "body"
     }, {
       "name": "min_score",
-      "description": "Minimum `score` a result must reach to be returned. Filters on the implementation-defined `score`, not on `similarity_score`, so the cutoff follows the ranking. Only applies when `query` is provided. Because the scale behind `score` is not part of the contract, treat a tuned value as tied to the deployment rather than portable.",
+      "description": "Deprecated alias for `min_similarity`, with identical behavior. While ranking was single-signal `score` equaled `similarity_score`, so this has only ever filtered cosine and an existing value keeps returning the same results. `min_similarity` wins when both are sent. Removed in v2.",
+      "required": false,
+      "type": "number",
+      "in": "body"
+    }, {
+      "name": "rrf_k",
+      "description": "The `k` in the reciprocal rank fusion term `1 / (k + rank)`, which sets how steeply a result's contribution decays with its position in each ranked list. A smaller value weights the very top of each list more heavily. Defaults to the deployment's `KNOWLEDGE_RRF_K`, itself 60 by default. Only applies when `query` is provided.",
+      "required": false,
+      "type": "integer",
+      "in": "body"
+    }, {
+      "name": "recency_half_life_days",
+      "description": "Half-life, in days, of a recency decay applied to **memory** results after fusion: a result's `score` is multiplied by `2 ^ (-age_in_days / recency_half_life_days)`, where age is measured from its `updated_at`. Document results are never decayed. `0` — the default, and the default of the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` — disables the blend entirely; it is a switch, not a lower bound, and sending `0` turns off a deployment-wide decay for this one request. Accepts fractions (`0.5` is twelve hours). How many ranks a given half-life costs depends on `rrf_k`. Only applies when `query` is provided.",
       "required": false,
       "type": "number",
       "in": "body"
@@ -9345,12 +9363,13 @@ program.argument("[command]", "API command in kebab-case (e.g. list-actors)").ar
     }
     process.exit(0);
   }
+  const parsedFlags = parseUnknownWithRepeats({
+    cliArgs: rawArgs
+  });
   const wrapped = applyWrapperForCommand({
     commandName,
     route,
-    parsedFlags: parseUnknownWithRepeats({
-      cliArgs: rawArgs
-    })
+    parsedFlags
   });
   const flags = wrapped.flags.single;
   const repeatedFlags = wrapped.flags.repeated;
@@ -9395,7 +9414,8 @@ program.argument("[command]", "API command in kebab-case (e.g. list-actors)").ar
     console.error(`Missing required path parameter(s): ${missingPathParams.join(", ")}.\nProvide with --${missingPathParams[0]} <value>, --id <value>, or a positional argument: soat ${commandName} <id>`);
     process.exit(1);
   }
-  const client = resolveClient(flags["profile"] ?? program.opts().profile);
+  const profileOpt = flags["profile"] ?? program.opts().profile;
+  const client = resolveClient(profileOpt);
   const serviceClass = resolveServiceClass(route.serviceClass);
   if (!serviceClass) {
     console.error(`SDK class "${route.serviceClass}" not found.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/cli",
-  "version": "0.48.0",
+  "version": "0.49.1",
   "description": "CLI for SOAT — open-source infrastructure for production-ready AI agents.",
   "keywords": [
     "ai-agents",
@@ -20,22 +20,22 @@
   "license": "Apache-2.0",
   "type": "module",
   "dependencies": {
-    "@inquirer/input": "^5.1.2",
-    "@inquirer/password": "^5.1.1",
-    "@soat/sdk": "0.48.0",
-    "@ttoss/logger": "^0.8.19",
+    "@inquirer/input": "^5.1.6",
+    "@inquirer/password": "^5.2.2",
+    "@soat/sdk": "0.49.1",
+    "@ttoss/logger": "^0.8.20",
     "commander": "^15.0.0",
-    "js-yaml": "^5.2.1"
+    "js-yaml": "^5.4.2"
   },
   "devDependencies": {
-    "@ttoss/config": "^1.37.17",
-    "@ttoss/openapi-codegen": "^0.2.0",
-    "@ttoss/test-utils": "^4.2.18",
+    "@ttoss/config": "^1.38.0",
+    "@ttoss/openapi-codegen": "^0.3.0",
+    "@ttoss/test-utils": "^4.2.19",
     "@types/jest": "^30.0.0",
-    "@types/node": "^26.1.1",
-    "jest": "^30.4.2",
-    "tsdown": "^0.22.7",
-    "tsx": "^4.23.1",
+    "@types/node": "^26.5.1",
+    "jest": "^30.5.1",
+    "tsdown": "^0.23.0",
+    "tsx": "^4.23.13",
     "typescript": "~6.0.3"
   },
   "files": [