@soat/sdk 0.49.1 → 0.51.0

package/dist/index.cjs

@@ -2627,7 +2627,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({
@@ -2644,10 +2644,10 @@ 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({
+		return (options.client ?? client).get({
 			url: "/api/v1/memories",
 			...options
 		});
@@ -2655,7 +2655,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({
@@ -2670,7 +2670,7 @@ var Memories = class {
 	/**
 	* Delete a memory
 	*
-	* Deletes a memory configuration
+	* Deletes a memory
 	*/
 	static deleteMemory(options) {
 		return (options.client ?? client).delete({
@@ -2681,7 +2681,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({
@@ -2692,7 +2692,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({
@@ -2705,6 +2705,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: "/api/v1/memories/{memory_id}/assertions",
+			...options
+		});
+	}
+	/**
 	* Get memory tags
 	*
 	* Returns all tags attached to the memory
@@ -2746,26 +2757,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) {
-		return (options.client ?? client).get({
-			url: "/api/v1/memory-entries",
+	static listMemoryStores(options) {
+		return (options?.client ?? client).get({
+			url: "/api/v1/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: "/api/v1/memory-entries",
+			url: "/api/v1/memory-stores",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -2774,35 +2785,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: "/api/v1/memory-entries/{entry_id}",
+			url: "/api/v1/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: "/api/v1/memory-entries/{entry_id}",
+			url: "/api/v1/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: "/api/v1/memory-entries/{entry_id}",
+			url: "/api/v1/memory-stores/{memory_store_id}",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -2811,24 +2822,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: "/api/v1/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: "/api/v1/memory-entries/{entry_id}/tags",
+			url: "/api/v1/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: "/api/v1/memory-entries/{entry_id}/tags",
+			url: "/api/v1/memory-stores/{memory_store_id}/tags",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -2837,13 +2859,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: "/api/v1/memory-entries/{entry_id}/tags",
+			url: "/api/v1/memory-stores/{memory_store_id}/tags",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -3255,7 +3277,7 @@ var Projects = class {
 	*
 	* Deletes a project. Requires admin role. Fails with `409` if the project has any dependent resource, unless `force=true` is passed, in which case those resources are deleted along with the project.
 	*
-	* Every project-scoped resource counts: agents, ai providers, model routes, tools, ingestion rules, actors, chats, conversations, sessions, generations, traces, datasets, evals, workflows, tasks, triggers, orchestrations and their runs, formations, memories, secrets, files, guardrails, quotas, usage history — and the activity, approval, exception and guardrail-evaluation records a project accumulates while it runs. Audit log entries are the one exception: they outlive the project, keeping their record with `project_id` cleared.
+	* Every project-scoped resource counts: agents, ai providers, model routes, tools, ingestion rules, actors, chats, conversations, sessions, generations, traces, datasets, evals, workflows, tasks, triggers, orchestrations and their runs, formations, memory stores, secrets, files, guardrails, quotas, usage history — and the activity, approval, exception and guardrail-evaluation records a project accumulates while it runs. Audit log entries are the one exception: they outlive the project, keeping their record with `project_id` cleared.
 	*
 	*/
 	static deleteProject(options) {
@@ -3336,7 +3358,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({
@@ -4538,7 +4560,7 @@ var SoatClient = class {
 	ingestionRules;
 	knowledge;
 	memories;
-	memoryEntries;
+	memoryStores;
 	modelRoutes;
 	orchestrations;
 	policies;
@@ -4585,7 +4607,7 @@ var SoatClient = class {
 		this.ingestionRules = bindResource(IngestionRules, httpClient);
 		this.knowledge = bindResource(Knowledge, httpClient);
 		this.memories = bindResource(Memories, httpClient);
-		this.memoryEntries = bindResource(MemoryEntries, httpClient);
+		this.memoryStores = bindResource(MemoryStores, httpClient);
 		this.modelRoutes = bindResource(ModelRoutes, httpClient);
 		this.orchestrations = bindResource(Orchestrations, httpClient);
 		this.policies = bindResource(Policies, httpClient);
@@ -4626,7 +4648,7 @@ exports.Guardrails = Guardrails;
 exports.IngestionRules = IngestionRules;
 exports.Knowledge = Knowledge;
 exports.Memories = Memories;
-exports.MemoryEntries = MemoryEntries;
+exports.MemoryStores = MemoryStores;
 exports.ModelRoutes = ModelRoutes;
 exports.Orchestrations = Orchestrations;
 exports.Policies = Policies;