@naturali/cli 0.127.11 → 0.129.0

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.127.11";
+var version = "0.129.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -3041,7 +3041,7 @@ var Knowledge = class {
 	/**
 	* Search knowledge
 	*
-	* 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.
+	* Searches across documents and memories using hybrid retrieval — a vector query and a full-text query per source, fused by reciprocal rank — or by file paths, document IDs, memory store IDs, or tags. At least one of `query`, `tags`, `document_paths`, `document_ids`, or `memory_store_ids` must be provided.
 	*/
 	static searchKnowledge(options) {
 		return (options.client ?? client).post({
@@ -3058,7 +3058,7 @@ var Memories = class {
 	/**
 	* List memories
 	*
-	* Returns a list of memory configurations for a project
+	* Returns all memories in a memory store
 	*/
 	static listMemories(options) {
 		return (options.client ?? client).get({
@@ -3069,7 +3069,7 @@ var Memories = class {
 	/**
 	* Create a memory
 	*
-	* Creates a new memory configuration in a project
+	* 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({
@@ -3084,7 +3084,7 @@ var Memories = class {
 	/**
 	* Delete a memory
 	*
-	* Deletes a memory configuration
+	* Deletes a memory
 	*/
 	static deleteMemory(options) {
 		return (options.client ?? client).delete({
@@ -3095,7 +3095,7 @@ var Memories = class {
 	/**
 	* Get a memory
 	*
-	* Returns a single memory configuration by ID
+	* Returns a single memory by ID
 	*/
 	static getMemory(options) {
 		return (options.client ?? client).get({
@@ -3106,7 +3106,7 @@ var Memories = class {
 	/**
 	* Update a memory
 	*
-	* Updates an existing memory configuration
+	* Updates an existing memory. Regenerates the embedding if content changes.
 	*/
 	static updateMemory(options) {
 		return (options.client ?? client).put({
@@ -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
@@ -3160,26 +3171,26 @@ var Memories = class {
 		});
 	}
 };
-var MemoryEntries = class {
+var MemoryStores = class {
 	/**
-	* List memory entries
+	* List memory stores
 	*
-	* Returns all entries in a memory container
+	* Returns a list of memory store configurations for a project
 	*/
-	static listMemoryEntries(options) {
+	static listMemoryStores(options) {
 		return (options.client ?? client).get({
-			url: "/v1/projects/{project_id}/memory-entries",
+			url: "/v1/projects/{project_id}/memory-stores",
 			...options
 		});
 	}
 	/**
-	* Create a memory entry
+	* Create a memory store
 	*
-	* Creates a new entry in the specified memory container. Automatically generates an embedding for semantic search, and skips the write when an existing entry is a near-duplicate (see `duplicate_threshold`). A merely similar fact is stored as its own entry: this path has no agent context and therefore no model to consolidate two facts into one.
+	* Creates a new memory store configuration in a project
 	*/
-	static createMemoryEntry(options) {
+	static createMemoryStore(options) {
 		return (options.client ?? client).post({
-			url: "/v1/projects/{project_id}/memory-entries",
+			url: "/v1/projects/{project_id}/memory-stores",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -3188,35 +3199,35 @@ var MemoryEntries = class {
 		});
 	}
 	/**
-	* Delete a memory entry
+	* Delete a memory store
 	*
-	* Deletes a memory entry
+	* Deletes a memory store configuration
 	*/
-	static deleteMemoryEntry(options) {
+	static deleteMemoryStore(options) {
 		return (options.client ?? client).delete({
-			url: "/v1/projects/{project_id}/memory-entries/{entry_id}",
+			url: "/v1/projects/{project_id}/memory-stores/{memory_store_id}",
 			...options
 		});
 	}
 	/**
-	* Get a memory entry
+	* Get a memory store
 	*
-	* Returns a single memory entry by ID
+	* Returns a single memory store configuration by ID
 	*/
-	static getMemoryEntry(options) {
+	static getMemoryStore(options) {
 		return (options.client ?? client).get({
-			url: "/v1/projects/{project_id}/memory-entries/{entry_id}",
+			url: "/v1/projects/{project_id}/memory-stores/{memory_store_id}",
 			...options
 		});
 	}
 	/**
-	* Update a memory entry
+	* Update a memory store
 	*
-	* Updates an existing memory entry. Regenerates the embedding if content changes.
+	* Updates an existing memory store configuration
 	*/
-	static updateMemoryEntry(options) {
+	static updateMemoryStore(options) {
 		return (options.client ?? client).put({
-			url: "/v1/projects/{project_id}/memory-entries/{entry_id}",
+			url: "/v1/projects/{project_id}/memory-stores/{memory_store_id}",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -3225,24 +3236,35 @@ var MemoryEntries = class {
 		});
 	}
 	/**
-	* Get memory entry tags
+	* List a memory store's write assertions
 	*
-	* Returns all tags attached to the memory entry
+	* 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 getMemoryEntryTags(options) {
+	static listMemoryStoreAssertions(options) {
 		return (options.client ?? client).get({
-			url: "/v1/projects/{project_id}/memory-entries/{entry_id}/tags",
+			url: "/v1/projects/{project_id}/memory-stores/{memory_store_id}/assertions",
 			...options
 		});
 	}
 	/**
-	* Merge memory entry tags
+	* Get memory store tags
 	*
-	* Merges provided tags into the memory entry's existing tags (existing tags are preserved unless overridden)
+	* Returns all tags attached to the memory store
 	*/
-	static mergeMemoryEntryTags(options) {
+	static getMemoryStoreTags(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/memory-stores/{memory_store_id}/tags",
+			...options
+		});
+	}
+	/**
+	* Merge memory store tags
+	*
+	* Merges provided tags into the memory store's existing tags (existing tags are preserved unless overridden)
+	*/
+	static mergeMemoryStoreTags(options) {
 		return (options.client ?? client).patch({
-			url: "/v1/projects/{project_id}/memory-entries/{entry_id}/tags",
+			url: "/v1/projects/{project_id}/memory-stores/{memory_store_id}/tags",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -3251,13 +3273,13 @@ var MemoryEntries = class {
 		});
 	}
 	/**
-	* Replace memory entry tags
+	* Replace memory store tags
 	*
-	* Replaces all tags on the memory entry with the provided tags (not merged)
+	* Replaces all tags on the memory store with the provided tags (not merged)
 	*/
-	static replaceMemoryEntryTags(options) {
+	static replaceMemoryStoreTags(options) {
 		return (options.client ?? client).put({
-			url: "/v1/projects/{project_id}/memory-entries/{entry_id}/tags",
+			url: "/v1/projects/{project_id}/memory-stores/{memory_store_id}/tags",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -3844,7 +3866,7 @@ var Quotas = class {
 	*
 	* Creates a project-scoped quota. `requests` is valid for `scope: project`/`api_key`; `tokens` and `cost_usd` are valid for `scope: project`/`agent`/`actor`; `storage_bytes` is valid for `scope: project` only. Any other scope/metric pair is rejected with 400 (no attribution exists to enforce it). An `actor` quota caps one end user's spend, matched from the generation's session; a null `scope_ref` means one budget *per* actor rather than a pooled project total. A `cost_usd` quota may name one `meter_type` to cap; omitting it caps every priced meter. A duplicate quota (same project, scope, scope_ref, metric, window, meter_type) is rejected with 409.
 	*
-	* `storage_bytes` caps a stored total rather than a windowed one, so it takes `window: current` and every other metric refuses that value (400 either way). It is enforced at the corpus write paths — file upload and create, document create, document ingest and re-ingest, memory-entry create — with `409 QUOTA_STORAGE_EXCEEDED` and no `Retry-After`, since no window reset clears a footprint.
+	* `storage_bytes` caps a stored total rather than a windowed one, so it takes `window: current` and every other metric refuses that value (400 either way). It is enforced at the corpus write paths — file upload and create, document create, document ingest and re-ingest, memory create — with `409 QUOTA_STORAGE_EXCEEDED` and no `Retry-After`, since no window reset clears a footprint.
 	*/
 	static createQuota(options) {
 		return (options.client ?? client).post({
@@ -4900,7 +4922,7 @@ var NaturaliClient = class {
 	ingestionRules;
 	knowledge;
 	memories;
-	memoryEntries;
+	memoryStores;
 	modelRoutes;
 	quotas;
 	models;
@@ -4950,7 +4972,7 @@ var NaturaliClient = class {
 		this.ingestionRules = bindResource(IngestionRules, this.http);
 		this.knowledge = bindResource(Knowledge, this.http);
 		this.memories = bindResource(Memories, this.http);
-		this.memoryEntries = bindResource(MemoryEntries, this.http);
+		this.memoryStores = bindResource(MemoryStores, this.http);
 		this.modelRoutes = bindResource(ModelRoutes, this.http);
 		this.quotas = bindResource(Quotas, this.http);
 		this.models = bindResource(Models, this.http);
@@ -4995,7 +5017,7 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	IngestionRules: () => IngestionRules,
 	Knowledge: () => Knowledge,
 	Memories: () => Memories,
-	MemoryEntries: () => MemoryEntries,
+	MemoryStores: () => MemoryStores,
 	ModelRoutes: () => ModelRoutes,
 	Models: () => Models,
 	NaturaliClient: () => NaturaliClient,
@@ -6916,14 +6938,14 @@ const routes = {
 			},
 			{
 				"name": "extract",
-				"description": "Per-turn override of the agent's `knowledge_config.extraction` default. Omit to follow the agent's stored config. Set `false` to suppress automatic memory extraction for this turn (e.g. an operational or tool-listing turn that would only add noise to a curated memory). Set `true` to force extraction on for this turn even when the agent does not enable it by default, provided the agent has a `write_memory_id`. Has no effect on streaming or `requires_action` turns, which never extract.",
+				"description": "Per-turn override of the agent's `knowledge_config.extraction` default. Omit to follow the agent's stored config. Set `false` to suppress automatic memory store extraction for this turn (e.g. an operational or tool-listing turn that would only add noise to a curated memory store). Set `true` to force extraction on for this turn even when the agent does not enable it by default, provided the agent has a `write_memory_store_id`. Has no effect on streaming or `requires_action` turns, which never extract.",
 				"required": false,
 				"type": "boolean",
 				"in": "body"
 			},
 			{
 				"name": "knowledge_config",
-				"description": "Per-generation knowledge retrieval override. Array filters (memory_ids, document_ids, document_paths) are unioned with the agent's stored knowledge_config; `tags` pairs are merged with the override winning per key; scalar fields (min_score, limit) use the per-generation value when present.",
+				"description": "Per-generation knowledge retrieval override. Array filters (memory_store_ids, document_ids, document_paths) are unioned with the agent's stored knowledge_config; `tags` pairs are merged with the override winning per key; scalar fields (min_score, limit) use the per-generation value when present.",
 				"required": false,
 				"type": "object",
 				"in": "body"
@@ -12286,7 +12308,7 @@ const routes = {
 	"search-knowledge": {
 		serviceClass: "Knowledge",
 		operationId: "searchKnowledge",
-		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.",
+		description: "Searches across documents and memories using hybrid retrieval — a vector query and a full-text query per source, fused by reciprocal rank — or by file paths, document IDs, memory store IDs, or tags. At least one of `query`, `tags`, `document_paths`, `document_ids`, or `memory_store_ids` must be provided.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/knowledge",
 		httpMethod: "post",
 		pathParams: ["project_id"],
@@ -12329,7 +12351,7 @@ const routes = {
 			},
 			{
 				"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.",
+				"description": "Half-life, in days, of a recency decay applied to **memory store** 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"
@@ -12342,8 +12364,8 @@ const routes = {
 				"in": "body"
 			},
 			{
-				"name": "memory_ids",
-				"description": "Search entries within these specific memories",
+				"name": "memory_store_ids",
+				"description": "Search memories within these specific memory stores",
 				"required": false,
 				"type": "array",
 				"in": "body"
@@ -12364,7 +12386,7 @@ const routes = {
 			},
 			{
 				"name": "tags",
-				"description": "Filter results to documents and memory entries whose `tags` contain every one of these key-value pairs (exact, case-sensitive match). The only filter that scopes both stores, so passing it alone searches both. For memory it matches at entry granularity: an entry is returned when its parent memory's tags match or its own do.",
+				"description": "Filter results to documents and memories whose `tags` contain every one of these key-value pairs (exact, case-sensitive match). The only filter that scopes both stores, so passing it alone searches both. For memories it matches at memory granularity: a memory is returned when its parent memory store's tags match or its own do.",
 				"required": false,
 				"type": "string",
 				"in": "body"
@@ -12374,14 +12396,16 @@ const routes = {
 	"list-memories": {
 		serviceClass: "Memories",
 		operationId: "listMemories",
-		description: "Returns a list of memory configurations for a project",
+		description: "Returns all memories in a memory store",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memories",
 		httpMethod: "get",
 		pathParams: ["project_id"],
 		queryParams: [
+			"memory_store_id",
 			"tags",
 			"limit",
-			"offset"
+			"offset",
+			"include_invalidated"
 		],
 		flags: [
 			{
@@ -12391,6 +12415,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "memory_store_id",
+				"description": "Memory store to list memories from (mstore_...)",
+				"required": true,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "tags",
 				"description": "Filter by tag pairs, written `key:value` (split on the first colon, so a value may contain colons). Repeat the parameter for several pairs; **all** must be present with exactly that value.\n",
@@ -12411,13 +12442,20 @@ const routes = {
 				"required": false,
 				"type": "integer",
 				"in": "query"
+			},
+			{
+				"name": "include_invalidated",
+				"description": "Include invalidated (superseded) memories. They are excluded by default; set this to audit the supersede history.",
+				"required": false,
+				"type": "boolean",
+				"in": "query"
 			}
 		]
 	},
 	"create-memory": {
 		serviceClass: "Memories",
 		operationId: "createMemory",
-		description: "Creates a new memory configuration in a project",
+		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"],
@@ -12431,32 +12469,67 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "name",
-				"description": "Memory name",
+				"name": "memory_store_id",
+				"description": "Memory store to add the memory to (mstore_...)",
 				"required": true,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "description",
-				"description": "Optional description",
+				"name": "content",
+				"description": "The text content of the memory",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "source_type",
+				"description": "Whether there is a source to point at. `conversation` requires `source_id`; `manual` rejects it.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "source_id",
+				"description": "The conversation this fact was learned in. Required when `source_type` is `conversation`, and rejected otherwise.",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
 				"name": "tags",
-				"description": "Optional key-value tags. Scopes the memory in knowledge search, where every requested pair must match exactly.",
+				"description": "Per-memory key-value tags, used for memory-granularity filtering by `tags` in search-knowledge.",
 				"required": false,
 				"type": "string",
 				"in": "body"
+			},
+			{
+				"name": "metadata",
+				"description": "Arbitrary structured metadata attached to the memory",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "duplicate_threshold",
+				"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"
 			}
 		]
 	},
 	"get-memory": {
 		serviceClass: "Memories",
 		operationId: "getMemory",
-		description: "Returns a single memory configuration by ID",
+		description: "Returns a single memory by ID",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memories",
 		httpMethod: "get",
 		pathParams: ["project_id", "memory_id"],
@@ -12478,7 +12551,7 @@ const routes = {
 	"update-memory": {
 		serviceClass: "Memories",
 		operationId: "updateMemory",
-		description: "Updates an existing memory configuration",
+		description: "Updates an existing memory. Regenerates the embedding if content changes.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memories",
 		httpMethod: "put",
 		pathParams: ["project_id", "memory_id"],
@@ -12499,24 +12572,24 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "name",
-				"description": "Memory name",
+				"name": "content",
+				"description": "Updated text content",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "description",
-				"description": "Optional description",
+				"name": "tags",
+				"description": "Replaces the memory's tags. Pass null or an empty object to clear.",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "tags",
-				"description": "Optional key-value tags. Replaces the stored bag; `null` clears it.",
+				"name": "metadata",
+				"description": "Replaces the memory's metadata. Pass null to clear.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			}
 		]
@@ -12524,7 +12597,7 @@ const routes = {
 	"delete-memory": {
 		serviceClass: "Memories",
 		operationId: "deleteMemory",
-		description: "Deletes a memory configuration",
+		description: "Deletes a memory",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memories",
 		httpMethod: "delete",
 		pathParams: ["project_id", "memory_id"],
@@ -12543,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",
@@ -12609,19 +12721,17 @@ const routes = {
 			"in": "path"
 		}]
 	},
-	"list-memory-entries": {
-		serviceClass: "MemoryEntries",
-		operationId: "listMemoryEntries",
-		description: "Returns all entries in a memory container",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+	"list-memory-stores": {
+		serviceClass: "MemoryStores",
+		operationId: "listMemoryStores",
+		description: "Returns a list of memory store configurations for a project",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-stores",
 		httpMethod: "get",
 		pathParams: ["project_id"],
 		queryParams: [
-			"memory_id",
 			"tags",
 			"limit",
-			"offset",
-			"include_invalidated"
+			"offset"
 		],
 		flags: [
 			{
@@ -12631,13 +12741,6 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
-			{
-				"name": "memory_id",
-				"description": "Memory container to list entries from (mem_...)",
-				"required": true,
-				"type": "string",
-				"in": "query"
-			},
 			{
 				"name": "tags",
 				"description": "Filter by tag pairs, written `key:value` (split on the first colon, so a value may contain colons). Repeat the parameter for several pairs; **all** must be present with exactly that value.\n",
@@ -12658,21 +12761,14 @@ const routes = {
 				"required": false,
 				"type": "integer",
 				"in": "query"
-			},
-			{
-				"name": "include_invalidated",
-				"description": "Include invalidated (superseded) entries. They are excluded by default; set this to audit the supersede history.",
-				"required": false,
-				"type": "boolean",
-				"in": "query"
 			}
 		]
 	},
-	"create-memory-entry": {
-		serviceClass: "MemoryEntries",
-		operationId: "createMemoryEntry",
-		description: "Creates a new entry in the specified memory container. Automatically generates an embedding for semantic search, and skips the write when an existing entry is a near-duplicate (see `duplicate_threshold`). A merely similar fact is stored as its own entry: this path has no agent context and therefore no model to consolidate two facts into one.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+	"create-memory-store": {
+		serviceClass: "MemoryStores",
+		operationId: "createMemoryStore",
+		description: "Creates a new memory store configuration in a project",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-stores",
 		httpMethod: "post",
 		pathParams: ["project_id"],
 		queryParams: [],
@@ -12685,56 +12781,49 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "memory_id",
-				"description": "Memory container to add the entry to (mem_...)",
-				"required": true,
-				"type": "string",
-				"in": "body"
-			},
-			{
-				"name": "content",
-				"description": "The text content of the memory entry",
+				"name": "name",
+				"description": "Memory store name",
 				"required": true,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "source_type",
-				"description": "How this entry was created",
+				"name": "description",
+				"description": "Optional description",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
 				"name": "tags",
-				"description": "Per-entry key-value tags, used for entry-granularity filtering by `tags` in search-knowledge.",
+				"description": "Optional key-value tags. Scopes the memory store in knowledge search, where every requested pair must match exactly.",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "metadata",
-				"description": "Arbitrary structured metadata attached to the entry",
+				"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": "object",
+				"type": "number",
 				"in": "body"
 			},
 			{
-				"name": "duplicate_threshold",
-				"description": "Cosine similarity score at or above which the incoming content is considered a duplicate of an existing entry and skipped (default 0.95). Below it the entry is always created.",
+				"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-entry": {
-		serviceClass: "MemoryEntries",
-		operationId: "getMemoryEntry",
-		description: "Returns a single memory entry by ID",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+	"get-memory-store": {
+		serviceClass: "MemoryStores",
+		operationId: "getMemoryStore",
+		description: "Returns a single memory store configuration by ID",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-stores",
 		httpMethod: "get",
-		pathParams: ["project_id", "entry_id"],
+		pathParams: ["project_id", "memory_store_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -12743,20 +12832,20 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "entry_id",
+			"name": "memory_store_id",
 			"description": "",
 			"required": true,
 			"type": "string",
 			"in": "path"
 		}]
 	},
-	"update-memory-entry": {
-		serviceClass: "MemoryEntries",
-		operationId: "updateMemoryEntry",
-		description: "Updates an existing memory entry. Regenerates the embedding if content changes.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+	"update-memory-store": {
+		serviceClass: "MemoryStores",
+		operationId: "updateMemoryStore",
+		description: "Updates an existing memory store configuration",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-stores",
 		httpMethod: "put",
-		pathParams: ["project_id", "entry_id"],
+		pathParams: ["project_id", "memory_store_id"],
 		queryParams: [],
 		flags: [
 			{
@@ -12767,42 +12856,56 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "entry_id",
+				"name": "memory_store_id",
 				"description": "",
 				"required": true,
 				"type": "string",
 				"in": "path"
 			},
 			{
-				"name": "content",
-				"description": "Updated text content",
+				"name": "name",
+				"description": "Memory store name",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "description",
+				"description": "Optional description",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
 				"name": "tags",
-				"description": "Replaces the entry's tags. Pass null or an empty object to clear.",
+				"description": "Optional key-value tags. Replaces the stored bag; `null` clears it.",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "metadata",
-				"description": "Replaces the entry's metadata. Pass null to clear.",
+				"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": "object",
+				"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-entry": {
-		serviceClass: "MemoryEntries",
-		operationId: "deleteMemoryEntry",
-		description: "Deletes a memory entry",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+	"delete-memory-store": {
+		serviceClass: "MemoryStores",
+		operationId: "deleteMemoryStore",
+		description: "Deletes a memory store configuration",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-stores",
 		httpMethod: "delete",
-		pathParams: ["project_id", "entry_id"],
+		pathParams: ["project_id", "memory_store_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -12811,20 +12914,94 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "entry_id",
+			"name": "memory_store_id",
 			"description": "",
 			"required": true,
 			"type": "string",
 			"in": "path"
 		}]
 	},
-	"get-memory-entry-tags": {
-		serviceClass: "MemoryEntries",
-		operationId: "getMemoryEntryTags",
-		description: "Returns all tags attached to the memory entry",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+	"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", "entry_id"],
+		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",
+		description: "Returns all tags attached to the memory store",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-stores",
+		httpMethod: "get",
+		pathParams: ["project_id", "memory_store_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -12833,20 +13010,20 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "entry_id",
-			"description": "Memory entry ID",
+			"name": "memory_store_id",
+			"description": "Memory store ID",
 			"required": true,
 			"type": "string",
 			"in": "path"
 		}]
 	},
-	"replace-memory-entry-tags": {
-		serviceClass: "MemoryEntries",
-		operationId: "replaceMemoryEntryTags",
-		description: "Replaces all tags on the memory entry with the provided tags (not merged)",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+	"replace-memory-store-tags": {
+		serviceClass: "MemoryStores",
+		operationId: "replaceMemoryStoreTags",
+		description: "Replaces all tags on the memory store with the provided tags (not merged)",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-stores",
 		httpMethod: "put",
-		pathParams: ["project_id", "entry_id"],
+		pathParams: ["project_id", "memory_store_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -12855,20 +13032,20 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "entry_id",
-			"description": "Memory entry ID",
+			"name": "memory_store_id",
+			"description": "Memory store ID",
 			"required": true,
 			"type": "string",
 			"in": "path"
 		}]
 	},
-	"merge-memory-entry-tags": {
-		serviceClass: "MemoryEntries",
-		operationId: "mergeMemoryEntryTags",
-		description: "Merges provided tags into the memory entry's existing tags (existing tags are preserved unless overridden)",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+	"merge-memory-store-tags": {
+		serviceClass: "MemoryStores",
+		operationId: "mergeMemoryStoreTags",
+		description: "Merges provided tags into the memory store's existing tags (existing tags are preserved unless overridden)",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-stores",
 		httpMethod: "patch",
-		pathParams: ["project_id", "entry_id"],
+		pathParams: ["project_id", "memory_store_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -12877,8 +13054,8 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "entry_id",
-			"description": "Memory entry ID",
+			"name": "memory_store_id",
+			"description": "Memory store ID",
 			"required": true,
 			"type": "string",
 			"in": "path"
@@ -14466,7 +14643,7 @@ const routes = {
 	"create-quota": {
 		serviceClass: "Quotas",
 		operationId: "createQuota",
-		description: "Creates a project-scoped quota. `requests` is valid for `scope: project`/`api_key`; `tokens` and `cost_usd` are valid for `scope: project`/`agent`/`actor`; `storage_bytes` is valid for `scope: project` only. Any other scope/metric pair is rejected with 400 (no attribution exists to enforce it). An `actor` quota caps one end user's spend, matched from the generation's session; a null `scope_ref` means one budget *per* actor rather than a pooled project total. A `cost_usd` quota may name one `meter_type` to cap; omitting it caps every priced meter. A duplicate quota (same project, scope, scope_ref, metric, window, meter_type) is rejected with 409. `storage_bytes` caps a stored total rather than a windowed one, so it takes `window: current` and every other metric refuses that value (400 either way). It is enforced at the corpus write paths — file upload and create, document create, document ingest and re-ingest, memory-entry create — with `409 QUOTA_STORAGE_EXCEEDED` and no `Retry-After`, since no window reset clears a footprint.",
+		description: "Creates a project-scoped quota. `requests` is valid for `scope: project`/`api_key`; `tokens` and `cost_usd` are valid for `scope: project`/`agent`/`actor`; `storage_bytes` is valid for `scope: project` only. Any other scope/metric pair is rejected with 400 (no attribution exists to enforce it). An `actor` quota caps one end user's spend, matched from the generation's session; a null `scope_ref` means one budget *per* actor rather than a pooled project total. A `cost_usd` quota may name one `meter_type` to cap; omitting it caps every priced meter. A duplicate quota (same project, scope, scope_ref, metric, window, meter_type) is rejected with 409. `storage_bytes` caps a stored total rather than a windowed one, so it takes `window: current` and every other metric refuses that value (400 either way). It is enforced at the corpus write paths — file upload and create, document create, document ingest and re-ingest, memory create — with `409 QUOTA_STORAGE_EXCEEDED` and no `Retry-After`, since no window reset clears a footprint.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/quotas",
 		httpMethod: "post",
 		pathParams: ["project_id"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.127.11",
+  "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.127.11",
+    "@naturali/sdk": "0.129.0",
     "@ttoss/openapi-codegen": "^0.3.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",