@soat/cli 0.50.0 → 0.51.0

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.50.0";
+var version = "0.51.0";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -5083,7 +5083,7 @@ var routes = {
   "create-memory": {
     serviceClass: "Memories",
     operationId: "createMemory",
-    description: "Creates a new memory in the specified memory store. Automatically generates an embedding for semantic search, and skips the write when an existing memory is a near-duplicate (see `duplicate_threshold`). A merely similar fact is stored as its own memory: this path has no agent context and therefore no model to consolidate two facts into one.",
+    description: "Writes a fact to the specified memory store through the standard write algorithm: the content is embedded (or matched to text the store already holds), compared against the most similar currently-valid memory, and resolved to exactly one of three outcomes — `skipped` at or above `duplicate_threshold`, `superseded` at or above `supersede_threshold`, `created` below it. Every call records one assertion, whatever the outcome.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memories",
     httpMethod: "post",
     pathParams: [],
@@ -5126,7 +5126,13 @@ var routes = {
       "in": "body"
     }, {
       "name": "duplicate_threshold",
-      "description": "Cosine similarity score at or above which the incoming content is considered a duplicate of an existing memory and skipped (default 0.95). Below it the memory is always created.",
+      "description": "Cosine similarity at or above which the incoming content is a duplicate of an existing memory and the write is skipped. Overrides the store's `duplicate_threshold` for this call; falls back to the store's value, then to `0.95`.",
+      "required": false,
+      "type": "number",
+      "in": "body"
+    }, {
+      "name": "supersede_threshold",
+      "description": "Cosine similarity at or above which the incoming content restates a fact that has changed: the top match is invalidated and a new memory replaces it. Overrides the store's `supersede_threshold` for this call; falls back to the store's value, then to `0.90`. The effective pair must satisfy `supersede_threshold < duplicate_threshold`, and the check runs against the effective pair — so overriding only one value cannot invert it against the store's other one.",
       "required": false,
       "type": "number",
       "in": "body"
@@ -5198,6 +5204,34 @@ var routes = {
       "in": "path"
     }]
   },
+  "list-memory-assertions": {
+    serviceClass: "Memories",
+    operationId: "listMemoryAssertions",
+    description: "Returns every write that resolved into this memory, oldest first: the one that created it, the duplicates it absorbed, and the assertion that superseded another memory in its favour. A superseded memory keeps its own assertions, so the chain can be walked in both directions.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memories",
+    httpMethod: "get",
+    pathParams: ["memory_id"],
+    queryParams: ["limit", "offset"],
+    flags: [{
+      "name": "memory_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-memory-tags": {
     serviceClass: "Memories",
     operationId: "getMemoryTags",
@@ -5312,6 +5346,18 @@ var routes = {
       "required": false,
       "type": "object",
       "in": "body"
+    }, {
+      "name": "duplicate_threshold",
+      "description": "The store's dedup policy: cosine similarity at or above which an incoming fact is already known and the write is skipped. `null` (the default) uses the algorithm constant `0.95`. A single `POST /api/v1/memories` call may override it; the agent tool and the post-turn rule never can.",
+      "required": false,
+      "type": "number",
+      "in": "body"
+    }, {
+      "name": "supersede_threshold",
+      "description": "Cosine similarity at or above which an incoming fact restates a known one that has changed: the matched memory is invalidated and replaced. `null` (the default) uses the algorithm constant `0.90`. Must be lower than the effective `duplicate_threshold`, or the write is rejected with `400 VALIDATION_FAILED` — equal makes `superseded` unreachable and inverted swallows `skipped`.",
+      "required": false,
+      "type": "number",
+      "in": "body"
     }]
   },
   "get-memory-store": {
@@ -5362,6 +5408,18 @@ var routes = {
       "required": false,
       "type": "object",
       "in": "body"
+    }, {
+      "name": "duplicate_threshold",
+      "description": "The store's dedup policy: cosine similarity at or above which an incoming fact is already known and the write is skipped. `null` (the default) uses the algorithm constant `0.95`. A single `POST /api/v1/memories` call may override it; the agent tool and the post-turn rule never can.",
+      "required": false,
+      "type": "number",
+      "in": "body"
+    }, {
+      "name": "supersede_threshold",
+      "description": "Cosine similarity at or above which an incoming fact restates a known one that has changed: the matched memory is invalidated and replaced. `null` (the default) uses the algorithm constant `0.90`. Must be lower than the effective `duplicate_threshold`, or the write is rejected with `400 VALIDATION_FAILED` — equal makes `superseded` unreachable and inverted swallows `skipped`.",
+      "required": false,
+      "type": "number",
+      "in": "body"
     }]
   },
   "delete-memory-store": {
@@ -5380,6 +5438,58 @@ var routes = {
       "in": "path"
     }]
   },
+  "list-memory-store-assertions": {
+    serviceClass: "MemoryStores",
+    operationId: "listMemoryStoreAssertions",
+    description: "Returns the store's write ledger, newest first: one row per write attempt, skips included. This is how \"which write path is filling this store?\" is asked — a question no column on a memory row could answer, because a skipped write produced no memory at all.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-stores",
+    httpMethod: "get",
+    pathParams: ["memory_store_id"],
+    queryParams: ["mechanism", "outcome", "generation_id", "since", "limit", "offset"],
+    flags: [{
+      "name": "memory_store_id",
+      "description": "",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "mechanism",
+      "description": "Only assertions that came through this door.",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
+      "name": "outcome",
+      "description": "Only assertions that resolved this way.",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
+      "name": "generation_id",
+      "description": "Only assertions made during this generation. A generation that does not exist matches nothing rather than widening to the whole store.",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
+      "name": "since",
+      "description": "Only assertions recorded at or after this instant.",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
+      "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-memory-store-tags": {
     serviceClass: "MemoryStores",
     operationId: "getMemoryStoreTags",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/cli",
-  "version": "0.50.0",
+  "version": "0.51.0",
   "description": "CLI for SOAT — open-source infrastructure for production-ready AI agents.",
   "keywords": [
     "ai-agents",
@@ -22,7 +22,7 @@
   "dependencies": {
     "@inquirer/input": "^5.1.6",
     "@inquirer/password": "^5.2.2",
-    "@soat/sdk": "0.50.0",
+    "@soat/sdk": "0.51.0",
     "@ttoss/logger": "^0.8.20",
     "commander": "^15.0.0",
     "js-yaml": "^5.4.2"