@naturali/sdk 0.127.11 → 0.129.0

package/dist/index.cjs

@@ -3024,7 +3024,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({
@@ -3041,7 +3041,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({
@@ -3052,7 +3052,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({
@@ -3067,7 +3067,7 @@ var Memories = class {
 	/**
 	* Delete a memory
 	*
-	* Deletes a memory configuration
+	* Deletes a memory
 	*/
 	static deleteMemory(options) {
 		return (options.client ?? client).delete({
@@ -3078,7 +3078,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({
@@ -3089,7 +3089,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({
@@ -3102,6 +3102,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
@@ -3143,26 +3154,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",
@@ -3171,35 +3182,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",
@@ -3208,24 +3219,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",
@@ -3234,13 +3256,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",
@@ -3827,7 +3849,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({
@@ -4883,7 +4905,7 @@ var NaturaliClient = class {
 	ingestionRules;
 	knowledge;
 	memories;
-	memoryEntries;
+	memoryStores;
 	modelRoutes;
 	quotas;
 	models;
@@ -4933,7 +4955,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);
@@ -4976,7 +4998,7 @@ exports.Guardrails = Guardrails;
 exports.IngestionRules = IngestionRules;
 exports.Knowledge = Knowledge;
 exports.Memories = Memories;
-exports.MemoryEntries = MemoryEntries;
+exports.MemoryStores = MemoryStores;
 exports.ModelRoutes = ModelRoutes;
 exports.Models = Models;
 exports.NaturaliClient = NaturaliClient;