@naturali/sdk 0.73.2 → 0.75.0

package/dist/index.cjs

@@ -1385,6 +1385,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
@@ -2140,6 +2205,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
@@ -2375,6 +2490,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
@@ -2457,6 +2697,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
@@ -3785,6 +4155,7 @@ var NaturaliClient = class {
 	agentVersions;
 	aiProviders;
 	apiKeys;
+	approvals;
 	assistant;
 	channels;
 	auth;
@@ -3792,10 +4163,14 @@ var NaturaliClient = class {
 	documents;
 	embeddings;
 	evaluations;
+	exceptions;
 	files;
 	generations;
+	guardrails;
 	ingestionRules;
 	knowledge;
+	memories;
+	memoryEntries;
 	modelRoutes;
 	models;
 	orchestrations;
@@ -3824,6 +4199,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);
@@ -3831,10 +4207,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);
@@ -3856,6 +4236,7 @@ exports.AgentVersions = AgentVersions;
 exports.Agents = Agents;
 exports.AiProviders = AiProviders;
 exports.ApiKeys = ApiKeys;
+exports.Approvals = Approvals;
 exports.Assistant = Assistant;
 exports.Auth = Auth;
 exports.Channels = Channels;
@@ -3863,10 +4244,14 @@ exports.Conversations = Conversations;
 exports.Documents = Documents;
 exports.Embeddings = Embeddings;
 exports.Evaluations = Evaluations;
+exports.Exceptions = Exceptions;
 exports.Files = Files;
 exports.Generations = Generations;
+exports.Guardrails = Guardrails;
 exports.IngestionRules = IngestionRules;
 exports.Knowledge = Knowledge;
+exports.Memories = Memories;
+exports.MemoryEntries = MemoryEntries;
 exports.ModelRoutes = ModelRoutes;
 exports.Models = Models;
 exports.NaturaliClient = NaturaliClient;