@naturali/cli 0.128.0 → 0.129.0

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.128.0";
+var version = "0.129.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -3069,7 +3069,7 @@ var Memories = class {
 	/**
 	* Create a memory
 	*
-	* 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.
+	* 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.
 	*/
 	static createMemory(options) {
 		return (options.client ?? client).post({
@@ -3119,6 +3119,17 @@ var Memories = class {
 		});
 	}
 	/**
+	* List a memory's assertions
+	*
+	* 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.
+	*/
+	static listMemoryAssertions(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/memories/{memory_id}/assertions",
+			...options
+		});
+	}
+	/**
 	* Get memory tags
 	*
 	* Returns all tags attached to the memory
@@ -3225,6 +3236,17 @@ var MemoryStores = class {
 		});
 	}
 	/**
+	* List a memory store's write assertions
+	*
+	* 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.
+	*/
+	static listMemoryStoreAssertions(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/memory-stores/{memory_store_id}/assertions",
+			...options
+		});
+	}
+	/**
 	* Get memory store tags
 	*
 	* Returns all tags attached to the memory store
@@ -12433,7 +12455,7 @@ const 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://docs.naturali.ai/docs/modules/memories",
 		httpMethod: "post",
 		pathParams: ["project_id"],
@@ -12490,7 +12512,14 @@ const routes = {
 			},
 			{
 				"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"
@@ -12587,6 +12616,45 @@ const 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://docs.naturali.ai/docs/modules/memories",
+		httpMethod: "get",
+		pathParams: ["project_id", "memory_id"],
+		queryParams: ["limit", "offset"],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"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",
@@ -12732,6 +12800,20 @@ const routes = {
 				"required": false,
 				"type": "string",
 				"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 /v1/projects/{project_id}/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"
 			}
 		]
 	},
@@ -12800,6 +12882,20 @@ const routes = {
 				"required": false,
 				"type": "string",
 				"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 /v1/projects/{project_id}/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"
 			}
 		]
 	},
@@ -12825,6 +12921,80 @@ const 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://docs.naturali.ai/docs/modules/memory-stores",
+		httpMethod: "get",
+		pathParams: ["project_id", "memory_store_id"],
+		queryParams: [
+			"mechanism",
+			"outcome",
+			"generation_id",
+			"since",
+			"limit",
+			"offset"
+		],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"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": "@naturali/cli",
-  "version": "0.128.0",
+  "version": "0.129.0",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -24,7 +24,7 @@
     "commander": "^15.0.0"
   },
   "devDependencies": {
-    "@naturali/sdk": "0.128.0",
+    "@naturali/sdk": "0.129.0",
     "@ttoss/openapi-codegen": "^0.3.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",