@naturali/sdk 0.128.0 → 0.130.0

package/dist/index.cjs

@@ -2756,7 +2756,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.
 	*
@@ -3052,7 +3052,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({
@@ -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,6 +3154,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: "/v1/projects/{project_id}/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: "/v1/projects/{project_id}/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: "/v1/projects/{project_id}/memory-rules/{memory_rule_id}",
+			...options
+		});
+	}
+	/**
+	* Get a memory rule
+	*
+	* Returns a specific memory rule
+	*/
+	static getMemoryRule(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/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: "/v1/projects/{project_id}/memory-rules/{memory_rule_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var MemoryStores = class {
 	/**
 	* List memory stores
@@ -3208,6 +3284,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: "/v1/projects/{project_id}/memory-stores/{memory_store_id}/assertions",
+			...options
+		});
+	}
+	/**
 	* Get memory store tags
 	*
 	* Returns all tags attached to the memory store
@@ -4883,6 +4970,7 @@ var NaturaliClient = class {
 	ingestionRules;
 	knowledge;
 	memories;
+	memoryRules;
 	memoryStores;
 	modelRoutes;
 	quotas;
@@ -4933,6 +5021,7 @@ var NaturaliClient = class {
 		this.ingestionRules = bindResource(IngestionRules, this.http);
 		this.knowledge = bindResource(Knowledge, this.http);
 		this.memories = bindResource(Memories, this.http);
+		this.memoryRules = bindResource(MemoryRules, this.http);
 		this.memoryStores = bindResource(MemoryStores, this.http);
 		this.modelRoutes = bindResource(ModelRoutes, this.http);
 		this.quotas = bindResource(Quotas, this.http);
@@ -4976,6 +5065,7 @@ exports.Guardrails = Guardrails;
 exports.IngestionRules = IngestionRules;
 exports.Knowledge = Knowledge;
 exports.Memories = Memories;
+exports.MemoryRules = MemoryRules;
 exports.MemoryStores = MemoryStores;
 exports.ModelRoutes = ModelRoutes;
 exports.Models = Models;