@naturali/sdk 0.128.0 → 0.130.0

package/dist/index.mjs

@@ -2755,7 +2755,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.
 	*
@@ -3051,7 +3051,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({
@@ -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,6 +3153,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
@@ -3207,6 +3283,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
@@ -4882,6 +4969,7 @@ var NaturaliClient = class {
 	ingestionRules;
 	knowledge;
 	memories;
+	memoryRules;
 	memoryStores;
 	modelRoutes;
 	quotas;
@@ -4932,6 +5020,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);
@@ -4950,4 +5039,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, MemoryStores, 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, MemoryRules, 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.128.0",
+  "version": "0.130.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.128.0",
+    "@naturali/api": "0.130.0",
     "@ttoss/openapi-codegen": "^0.3.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",