@naturali/sdk 0.127.11 → 0.129.0

package/dist/index.mjs

@@ -3023,7 +3023,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({
@@ -3040,7 +3040,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({
@@ -3051,7 +3051,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({
@@ -3066,7 +3066,7 @@ var Memories = class {
 	/**
 	* Delete a memory
 	*
-	* Deletes a memory configuration
+	* Deletes a memory
 	*/
 	static deleteMemory(options) {
 		return (options.client ?? client).delete({
@@ -3077,7 +3077,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({
@@ -3088,7 +3088,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({
@@ -3101,6 +3101,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
@@ -3142,26 +3153,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",
@@ -3170,35 +3181,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",
@@ -3207,24 +3218,35 @@ var MemoryEntries = class {
 		});
 	}
 	/**
-	* Get memory entry tags
+	* 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 entry
+	* Returns all tags attached to the memory store
 	*/
-	static getMemoryEntryTags(options) {
+	static getMemoryStoreTags(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}/tags",
 			...options
 		});
 	}
 	/**
-	* Merge memory entry tags
+	* Merge memory store tags
 	*
-	* Merges provided tags into the memory entry's existing tags (existing tags are preserved unless overridden)
+	* Merges provided tags into the memory store's existing tags (existing tags are preserved unless overridden)
 	*/
-	static mergeMemoryEntryTags(options) {
+	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",
@@ -3233,13 +3255,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",
@@ -3826,7 +3848,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({
@@ -4882,7 +4904,7 @@ var NaturaliClient = class {
 	ingestionRules;
 	knowledge;
 	memories;
-	memoryEntries;
+	memoryStores;
 	modelRoutes;
 	quotas;
 	models;
@@ -4932,7 +4954,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);
@@ -4950,4 +4972,4 @@ var NaturaliClient = class {
 	}
 };
 //#endregion
-export { Activity, Actors, Admin, AgentVersions, Agents, AiProviders, ApiKeys, Approvals, Assistant, AuditLog, Auth, Chains, Channels, Conversations, Documents, Embeddings, Evaluations, Exceptions, Files, Formations, Generations, Guardrails, IngestionRules, Knowledge, Memories, MemoryEntries, ModelRoutes, Models, NaturaliClient, Orchestrations, Projects, Quotas, Secrets, Sessions, Tasks, Tools, Traces, Triggers, Users, Webhooks, Workflows, createClient, createConfig };
+export { Activity, Actors, Admin, AgentVersions, Agents, AiProviders, ApiKeys, Approvals, Assistant, AuditLog, Auth, Chains, Channels, Conversations, Documents, Embeddings, Evaluations, Exceptions, Files, Formations, Generations, Guardrails, IngestionRules, Knowledge, Memories, MemoryStores, ModelRoutes, Models, NaturaliClient, Orchestrations, Projects, Quotas, Secrets, Sessions, Tasks, Tools, Traces, Triggers, Users, Webhooks, Workflows, createClient, createConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.127.11",
+  "version": "0.129.0",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "sideEffects": false,
@@ -31,7 +31,7 @@
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "^0.99.0",
-    "@naturali/api": "0.127.11",
+    "@naturali/api": "0.129.0",
     "@ttoss/openapi-codegen": "^0.3.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",