@naturali/sdk 0.73.2 → 0.74.0

package/dist/index.mjs

@@ -1384,6 +1384,71 @@ var ApiKeys = class {
 		});
 	}
 };
+var Approvals = class {
+	/**
+	* List approval items
+	*
+	* Returns approval items for a project, filterable by status, origin, and expiry.
+	*/
+	static listApprovals(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/approvals",
+			...options
+		});
+	}
+	/**
+	* List recurring approval groups
+	*
+	* Read-only rollup answering "what keeps coming back?" — groups items by `dedup_key` and returns those recurring at least `min_count` times, most-recurrent first. Each group carries the ordered item chain (via `previous_item_id`) and the resolution reasons in order, so a human can read recurring rejections side by side and graduate the pattern into a guardrail `deny`. Exact-key grouping only; no cluster state is stored.
+	*/
+	static listApprovalRecurrences(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/approvals/recurrences",
+			...options
+		});
+	}
+	/**
+	* Get an approval item
+	*
+	* Returns a single approval item with its full evidence.
+	*/
+	static getApproval(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/approvals/{approval_id}",
+			...options
+		});
+	}
+	/**
+	* Approve an approval item
+	*
+	* Approves the item. Optionally supply edited `arguments` to replace the proposed arguments (edit-then-approve); the original is preserved on the item. Expiry is re-checked at decision time — an expired item can never be approved.
+	*/
+	static approveApproval(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/approvals/{approval_id}/approve",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Reject an approval item
+	*
+	* Rejects the item. A reason is required and preserved on the item.
+	*/
+	static rejectApproval(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/approvals/{approval_id}/reject",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var Assistant = class {
 	/**
 	* List linked identities
@@ -2139,6 +2204,56 @@ var Evaluations = class {
 		});
 	}
 };
+var Exceptions = class {
+	/**
+	* List exception items
+	*
+	* Returns exception items for a project, filterable by status, severity, and kind.
+	*/
+	static listExceptions(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/exceptions",
+			...options
+		});
+	}
+	/**
+	* Get an exception item
+	*
+	* Returns a single exception item with its full detail.
+	*/
+	static getException(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/exceptions/{exception_id}",
+			...options
+		});
+	}
+	/**
+	* Acknowledge an exception item
+	*
+	* Moves the item to `acknowledged` ("someone is on it"), recording who. A no-op that returns the item unchanged when already acknowledged; rejected when already resolved.
+	*/
+	static acknowledgeException(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/exceptions/{exception_id}/acknowledge",
+			...options
+		});
+	}
+	/**
+	* Resolve an exception item
+	*
+	* Moves the item to `resolved` ("fixed"), recording who and an optional note.
+	*/
+	static resolveException(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/exceptions/{exception_id}/resolve",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var Files = class {
 	/**
 	* List all files
@@ -2374,6 +2489,131 @@ var Generations = class {
 		});
 	}
 };
+var Guardrails = class {
+	/**
+	* List guardrails
+	*
+	* Returns all guardrails in the project.
+	*/
+	static listGuardrails(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/guardrails",
+			...options
+		});
+	}
+	/**
+	* Create a guardrail
+	*
+	* Creates a new guardrail in the project, archiving its document as version 1. The `document` is validated on write: `class` must be a literal (A/B/C/D) or a JSON Logic expression, and every variable it (and `guard`) reference must resolve to the `args.*` / `context.*` / `runtime.*` namespaces — an out-of-catalog `runtime.*` key is rejected with 400.
+	*
+	*/
+	static createGuardrail(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/guardrails",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a guardrail
+	*
+	* Deletes a guardrail and its archived versions by ID.
+	*/
+	static deleteGuardrail(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/guardrails/{guardrail_id}",
+			...options
+		});
+	}
+	/**
+	* Get a guardrail
+	*
+	* Returns a single guardrail by ID.
+	*/
+	static getGuardrail(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/guardrails/{guardrail_id}",
+			...options
+		});
+	}
+	/**
+	* Update a guardrail
+	*
+	* Updates an existing guardrail. A `document` write that actually changes the policy increments `version` and archives the new document as a GuardrailVersion; metadata-only edits (name / description / context), and re-writing the document the guardrail already holds, leave the version untouched.
+	*
+	*/
+	static updateGuardrail(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/guardrails/{guardrail_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List a guardrail's config versions
+	*
+	* Returns the guardrail's archived configurations, newest first. A version is written on create and on every subsequent write that changes the policy `document` — through the REST API or a formation apply alike. Metadata-only edits (name, description, context binding) do not archive a version. See [Versioning](/docs/modules/guardrails#versioning).
+	*
+	*/
+	static listGuardrailVersions(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/guardrails/{guardrail_id}/versions",
+			...options
+		});
+	}
+	/**
+	* Fetch an archived guardrail version
+	*
+	* Returns the exact configuration — and so the exact `document` — that governed at a given version. Approval items, activity entries, and exceptions record the version that governed them, so the audit chain survives edits.
+	*
+	*/
+	static getGuardrailVersion(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/guardrails/{guardrail_id}/versions/{version}",
+			...options
+		});
+	}
+	/**
+	* Restore an archived guardrail config
+	*
+	* Writes an archived version's `document` back as the guardrail's live policy, which archives it again as a **new** version rather than rewinding the counter — so an approval item or exception citing any version in between still resolves.
+	*
+	* The restore runs through the ordinary update path, so the archived document is re-validated; restoring the policy the guardrail already holds is a no-op and archives nothing.
+	*
+	*/
+	static restoreGuardrailVersion(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/guardrails/{guardrail_id}/versions/{version}/restore",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Dry-run evaluate a guardrail
+	*
+	* Runs the full evaluation pipeline — the `class` expression, the guard, the context tool per `context_mode`, live `runtime.*` resolution — against caller-supplied `args` and `guardrail_context`, and returns the exact `guardrail_evaluation` record a real call would produce. Nothing executes, no approval item is filed, and no activity entry is written. This is the adoption path: preview a document's decisions against production-shaped calls before attaching it — or before editing a widely-attached one. Pass an optional `tool_id` to resolve `runtime.tool.*`.
+	*
+	*/
+	static evaluateGuardrail(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/guardrails/{guardrail_id}/evaluate",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var IngestionRules = class {
 	/**
 	* List ingestion rules
@@ -2456,6 +2696,136 @@ var Knowledge = class {
 		});
 	}
 };
+var Memories = class {
+	/**
+	* List memories
+	*
+	* Returns a list of memory configurations for a project
+	*/
+	static listMemories(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/memories",
+			...options
+		});
+	}
+	/**
+	* Create a memory
+	*
+	* Creates a new memory configuration in a project
+	*/
+	static createMemory(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/memories",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a memory
+	*
+	* Deletes a memory configuration
+	*/
+	static deleteMemory(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/memories/{memory_id}",
+			...options
+		});
+	}
+	/**
+	* Get a memory
+	*
+	* Returns a single memory configuration by ID
+	*/
+	static getMemory(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/memories/{memory_id}",
+			...options
+		});
+	}
+	/**
+	* Update a memory
+	*
+	* Updates an existing memory configuration
+	*/
+	static updateMemory(options) {
+		return (options.client ?? client).put({
+			url: "/v1/projects/{project_id}/memories/{memory_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
+var MemoryEntries = class {
+	/**
+	* List memory entries
+	*
+	* Returns all entries in a memory container
+	*/
+	static listMemoryEntries(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/memory-entries",
+			...options
+		});
+	}
+	/**
+	* Create a memory entry
+	*
+	* 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.
+	*/
+	static createMemoryEntry(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/memory-entries",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a memory entry
+	*
+	* Deletes a memory entry
+	*/
+	static deleteMemoryEntry(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/memory-entries/{entry_id}",
+			...options
+		});
+	}
+	/**
+	* Get a memory entry
+	*
+	* Returns a single memory entry by ID
+	*/
+	static getMemoryEntry(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/memory-entries/{entry_id}",
+			...options
+		});
+	}
+	/**
+	* Update a memory entry
+	*
+	* Updates an existing memory entry. Regenerates the embedding if content changes.
+	*/
+	static updateMemoryEntry(options) {
+		return (options.client ?? client).put({
+			url: "/v1/projects/{project_id}/memory-entries/{entry_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var ModelRoutes = class {
 	/**
 	* List model routes
@@ -3784,6 +4154,7 @@ var NaturaliClient = class {
 	agentVersions;
 	aiProviders;
 	apiKeys;
+	approvals;
 	assistant;
 	channels;
 	auth;
@@ -3791,10 +4162,14 @@ var NaturaliClient = class {
 	documents;
 	embeddings;
 	evaluations;
+	exceptions;
 	files;
 	generations;
+	guardrails;
 	ingestionRules;
 	knowledge;
+	memories;
+	memoryEntries;
 	modelRoutes;
 	models;
 	orchestrations;
@@ -3823,6 +4198,7 @@ var NaturaliClient = class {
 		this.agentVersions = bindResource(AgentVersions, this.http);
 		this.aiProviders = bindResource(AiProviders, this.http);
 		this.apiKeys = bindResource(ApiKeys, this.http);
+		this.approvals = bindResource(Approvals, this.http);
 		this.assistant = bindResource(Assistant, this.http);
 		this.channels = bindResource(Channels, this.http);
 		this.auth = bindResource(Auth, this.http);
@@ -3830,10 +4206,14 @@ var NaturaliClient = class {
 		this.documents = bindResource(Documents, this.http);
 		this.embeddings = bindResource(Embeddings, this.http);
 		this.evaluations = bindResource(Evaluations, this.http);
+		this.exceptions = bindResource(Exceptions, this.http);
 		this.files = bindResource(Files, this.http);
 		this.generations = bindResource(Generations, this.http);
+		this.guardrails = bindResource(Guardrails, this.http);
 		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.modelRoutes = bindResource(ModelRoutes, this.http);
 		this.models = bindResource(Models, this.http);
 		this.orchestrations = bindResource(Orchestrations, this.http);
@@ -3850,4 +4230,4 @@ var NaturaliClient = class {
 	}
 };
 //#endregion
-export { Actors, AgentVersions, Agents, AiProviders, ApiKeys, Assistant, Auth, Channels, Conversations, Documents, Embeddings, Evaluations, Files, Generations, IngestionRules, Knowledge, ModelRoutes, Models, NaturaliClient, Orchestrations, Projects, Secrets, Sessions, Tasks, Tools, Traces, Triggers, Users, Webhooks, Workflows, createClient, createConfig };
+export { Actors, AgentVersions, Agents, AiProviders, ApiKeys, Approvals, Assistant, Auth, Channels, Conversations, Documents, Embeddings, Evaluations, Exceptions, Files, Generations, Guardrails, IngestionRules, Knowledge, Memories, MemoryEntries, ModelRoutes, Models, NaturaliClient, Orchestrations, Projects, Secrets, Sessions, Tasks, Tools, Traces, Triggers, Users, Webhooks, Workflows, createClient, createConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.73.2",
+  "version": "0.74.0",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "sideEffects": false,
@@ -37,7 +37,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/api": "0.73.2"
+    "@naturali/api": "0.74.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",