@soat/sdk 0.50.0 → 0.52.0

package/dist/index.cjs

@@ -2359,7 +2359,7 @@ var Generations = class {
 	/**
 	* List generations
 	*
-	* Returns generations the caller can access, optionally filtered by agent, trace, orchestration run, node, and status. Replaces the former per-trace generations endpoint (use the trace_id query filter).
+	* Returns generations the caller can access, optionally filtered by agent, trace, orchestration run, node, and status. The generations of one trace are the `trace_id` filter.
 	*
 	* Filtering by `orchestration_run_id` is the supported way to get from an orchestration run to the generations its agent nodes produced: a node execution record carries no generation id, so the pointer lives here, alongside the run's other attribution columns.
 	*
@@ -2655,7 +2655,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. `supersedes` overrides that comparison entirely, retiring the memory it names. Every call records one assertion, whatever the outcome.
 	*/
 	static createMemory(options) {
 		return (options.client ?? client).post({
@@ -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,6 +2757,71 @@ var Memories = class {
 		});
 	}
 };
+var MemoryRules = class {
+	/**
+	* List memory rules
+	*
+	* Returns memory rules, newest first. Narrow to one store with `memory_store_id` — that form is authorized against the store itself, so it answers "what feeds this store?" in one call.
+	*/
+	static listMemoryRules(options) {
+		return (options?.client ?? client).get({
+			url: "/api/v1/memory-rules",
+			...options
+		});
+	}
+	/**
+	* Create a memory rule
+	*
+	* Creates an ingestion rule on a memory store. With neither `agent_id` nor `tool_id` the built-in extractor runs, configurable through `prompt`, `ai_provider_id` and `model`.
+	*/
+	static createMemoryRule(options) {
+		return (options.client ?? client).post({
+			url: "/api/v1/memory-rules",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a memory rule
+	*
+	* Deletes a memory rule. The assertions it wrote are kept; their `rule_id` becomes null.
+	*/
+	static deleteMemoryRule(options) {
+		return (options.client ?? client).delete({
+			url: "/api/v1/memory-rules/{memory_rule_id}",
+			...options
+		});
+	}
+	/**
+	* Get a memory rule
+	*
+	* Returns a specific memory rule
+	*/
+	static getMemoryRule(options) {
+		return (options.client ?? client).get({
+			url: "/api/v1/memory-rules/{memory_rule_id}",
+			...options
+		});
+	}
+	/**
+	* Update a memory rule
+	*
+	* Updates a memory rule. Validation runs against the rule as it would stand after the change, so a one-field update cannot pair a handler with a stored extractor override from the side.
+	*/
+	static updateMemoryRule(options) {
+		return (options.client ?? client).patch({
+			url: "/api/v1/memory-rules/{memory_rule_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var MemoryStores = class {
 	/**
 	* List memory stores
@@ -2811,6 +2887,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: "/api/v1/memory-stores/{memory_store_id}/assertions",
+			...options
+		});
+	}
+	/**
 	* Get memory store tags
 	*
 	* Returns all tags attached to the memory store
@@ -3156,7 +3243,7 @@ var Policies = class {
 	/**
 	* List all policies
 	*
-	* Returns global policies. Requires admin role. Pass user_id to list only the policies attached to that user (replaces the former per-user policies endpoint).
+	* Returns global policies. Requires admin role. Pass user_id to list only the policies attached to that user.
 	*
 	*/
 	static listPolicies(options) {
@@ -4538,6 +4625,7 @@ var SoatClient = class {
 	ingestionRules;
 	knowledge;
 	memories;
+	memoryRules;
 	memoryStores;
 	modelRoutes;
 	orchestrations;
@@ -4585,6 +4673,7 @@ var SoatClient = class {
 		this.ingestionRules = bindResource(IngestionRules, httpClient);
 		this.knowledge = bindResource(Knowledge, httpClient);
 		this.memories = bindResource(Memories, httpClient);
+		this.memoryRules = bindResource(MemoryRules, httpClient);
 		this.memoryStores = bindResource(MemoryStores, httpClient);
 		this.modelRoutes = bindResource(ModelRoutes, httpClient);
 		this.orchestrations = bindResource(Orchestrations, httpClient);
@@ -4626,6 +4715,7 @@ exports.Guardrails = Guardrails;
 exports.IngestionRules = IngestionRules;
 exports.Knowledge = Knowledge;
 exports.Memories = Memories;
+exports.MemoryRules = MemoryRules;
 exports.MemoryStores = MemoryStores;
 exports.ModelRoutes = ModelRoutes;
 exports.Orchestrations = Orchestrations;