@naturali/cli 0.73.1 → 0.74.0

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.73.1";
+var version = "0.74.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -1402,6 +1402,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
@@ -2157,6 +2222,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
@@ -2392,6 +2507,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
@@ -2474,6 +2714,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
@@ -3802,6 +4172,7 @@ var NaturaliClient = class {
 	agentVersions;
 	aiProviders;
 	apiKeys;
+	approvals;
 	assistant;
 	channels;
 	auth;
@@ -3809,10 +4180,14 @@ var NaturaliClient = class {
 	documents;
 	embeddings;
 	evaluations;
+	exceptions;
 	files;
 	generations;
+	guardrails;
 	ingestionRules;
 	knowledge;
+	memories;
+	memoryEntries;
 	modelRoutes;
 	models;
 	orchestrations;
@@ -3841,6 +4216,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);
@@ -3848,10 +4224,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);
@@ -3875,6 +4255,7 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	Agents: () => Agents,
 	AiProviders: () => AiProviders,
 	ApiKeys: () => ApiKeys,
+	Approvals: () => Approvals,
 	Assistant: () => Assistant,
 	Auth: () => Auth,
 	Channels: () => Channels,
@@ -3882,10 +4263,14 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	Documents: () => Documents,
 	Embeddings: () => Embeddings,
 	Evaluations: () => Evaluations,
+	Exceptions: () => Exceptions,
 	Files: () => Files,
 	Generations: () => Generations,
+	Guardrails: () => Guardrails,
 	IngestionRules: () => IngestionRules,
 	Knowledge: () => Knowledge,
+	Memories: () => Memories,
+	MemoryEntries: () => MemoryEntries,
 	ModelRoutes: () => ModelRoutes,
 	Models: () => Models,
 	NaturaliClient: () => NaturaliClient,
@@ -6125,10 +6510,206 @@ const routes = {
 			"in": "path"
 		}]
 	},
-	"list-assistant-grants": {
-		serviceClass: "Assistant",
-		operationId: "listAssistantGrants",
-		description: "Lists the caller's assistant grants — one per channel identity that may operate their account. Grants belong to the account, so this is the caller's own set regardless of which projects they own.",
+	"list-approvals": {
+		serviceClass: "Approvals",
+		operationId: "listApprovals",
+		description: "Returns approval items for a project, filterable by status, origin, and expiry.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/approvals",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: [
+			"status",
+			"origin",
+			"expires_before",
+			"limit",
+			"offset"
+		],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "status",
+				"description": "Filter by lifecycle status",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "origin",
+				"description": "Filter by producer origin",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "expires_before",
+				"description": "Return only items expiring at or before this timestamp",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum number of results to return",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Number of results to skip",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"list-approval-recurrences": {
+		serviceClass: "Approvals",
+		operationId: "listApprovalRecurrences",
+		description: "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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/approvals",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: [
+			"status",
+			"min_count",
+			"limit",
+			"offset"
+		],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "status",
+				"description": "Lifecycle status the groups are built from (default `rejected`)",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "min_count",
+				"description": "Minimum items in a group for it to be returned",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum number of groups to return",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Number of groups to skip",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"get-approval": {
+		serviceClass: "Approvals",
+		operationId: "getApproval",
+		description: "Returns a single approval item with its full evidence.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/approvals",
+		httpMethod: "get",
+		pathParams: ["project_id", "approval_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "approval_id",
+			"description": "Approval item ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"approve-approval": {
+		serviceClass: "Approvals",
+		operationId: "approveApproval",
+		description: "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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/approvals",
+		httpMethod: "post",
+		pathParams: ["project_id", "approval_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "approval_id",
+				"description": "Approval item ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "arguments",
+				"description": "Edited arguments to execute instead of the proposed ones",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"reject-approval": {
+		serviceClass: "Approvals",
+		operationId: "rejectApproval",
+		description: "Rejects the item. A reason is required and preserved on the item.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/approvals",
+		httpMethod: "post",
+		pathParams: ["project_id", "approval_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "approval_id",
+				"description": "Approval item ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "reason",
+				"description": "Why the item is being rejected (required)",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"list-assistant-grants": {
+		serviceClass: "Assistant",
+		operationId: "listAssistantGrants",
+		description: "Lists the caller's assistant grants — one per channel identity that may operate their account. Grants belong to the account, so this is the caller's own set regardless of which projects they own.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/assistant",
 		httpMethod: "get",
 		pathParams: [],
@@ -8683,6 +9264,141 @@ const routes = {
 			}
 		]
 	},
+	"list-exceptions": {
+		serviceClass: "Exceptions",
+		operationId: "listExceptions",
+		description: "Returns exception items for a project, filterable by status, severity, and kind.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/exceptions",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: [
+			"status",
+			"severity",
+			"kind",
+			"limit",
+			"offset"
+		],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "status",
+				"description": "Filter by triage status",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "severity",
+				"description": "Filter by severity",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "kind",
+				"description": "Filter by how the exception was filed",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum number of results to return",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Number of results to skip",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"get-exception": {
+		serviceClass: "Exceptions",
+		operationId: "getException",
+		description: "Returns a single exception item with its full detail.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/exceptions",
+		httpMethod: "get",
+		pathParams: ["project_id", "exception_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "exception_id",
+			"description": "Exception item ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"acknowledge-exception": {
+		serviceClass: "Exceptions",
+		operationId: "acknowledgeException",
+		description: "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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/exceptions",
+		httpMethod: "post",
+		pathParams: ["project_id", "exception_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "exception_id",
+			"description": "Exception item ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"resolve-exception": {
+		serviceClass: "Exceptions",
+		operationId: "resolveException",
+		description: "Moves the item to `resolved` (\"fixed\"), recording who and an optional note.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/exceptions",
+		httpMethod: "post",
+		pathParams: ["project_id", "exception_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "exception_id",
+				"description": "Exception item ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "note",
+				"description": "Optional resolution note",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
 	"list-files": {
 		serviceClass: "Files",
 		operationId: "listFiles",
@@ -9202,11 +9918,11 @@ const routes = {
 			"in": "path"
 		}]
 	},
-	"list-ingestion-rules": {
-		serviceClass: "IngestionRules",
-		operationId: "listIngestionRules",
-		description: "Returns the ingestion rules for a project",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/ingestion-rules",
+	"list-guardrails": {
+		serviceClass: "Guardrails",
+		operationId: "listGuardrails",
+		description: "Returns all guardrails in the project.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/guardrails",
 		httpMethod: "get",
 		pathParams: ["project_id"],
 		queryParams: ["limit", "offset"],
@@ -9220,7 +9936,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Number of results per page",
+				"description": "Maximum number of results to return",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -9234,11 +9950,11 @@ const routes = {
 			}
 		]
 	},
-	"create-ingestion-rule": {
-		serviceClass: "IngestionRules",
-		operationId: "createIngestionRule",
-		description: "Creates a rule mapping a content_type glob to a converter. Exactly one of tool_id or agent_id must be set.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/ingestion-rules",
+	"create-guardrail": {
+		serviceClass: "Guardrails",
+		operationId: "createGuardrail",
+		description: "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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/guardrails",
 		httpMethod: "post",
 		pathParams: ["project_id"],
 		queryParams: [],
@@ -9251,91 +9967,56 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "content_type_glob",
-				"description": "MIME type glob matched against a file's content_type",
+				"name": "name",
+				"description": "Human-readable name",
 				"required": true,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "tool_id",
-				"description": "Converter tool id (mutually exclusive with agent_id)",
-				"required": false,
-				"type": "string",
-				"in": "body"
-			},
-			{
-				"name": "agent_id",
-				"description": "Converter agent id (mutually exclusive with tool_id)",
-				"required": false,
-				"type": "string",
-				"in": "body"
-			},
-			{
-				"name": "action",
-				"description": "Operation id, required for mcp tool converters",
+				"name": "description",
+				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "preset_parameters",
-				"description": "Merged into the tool input before invocation (tool converters only)",
-				"required": false,
+				"name": "document",
+				"description": "The action-class document. `class` maps a call to an action class; `guard` gates class-B autonomy. Both are single JSON Logic expressions over the `args.*` / `context.*` / `runtime.*` namespaces.\n",
+				"required": true,
 				"type": "object",
 				"in": "body"
 			},
 			{
-				"name": "native_extraction",
-				"description": "For native types (PDF/text): `first` (default) converts only when native extraction yields no text; `skip` always converts.",
+				"name": "context_tool_id",
+				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "file_delivery",
-				"description": "How the file reaches a tool converter (default base64)",
+				"name": "context_mode",
+				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "chunk_strategy",
-				"description": "Default chunk strategy, overridable per ingest request",
+				"name": "version_label",
+				"description": "Optional tag for the config version this write archives (e.g. `initial`). Annotates the version only — it is not stored on the guardrail and is not part of the config, so labelling a change is never itself a change.",
 				"required": false,
 				"type": "string",
 				"in": "body"
-			},
-			{
-				"name": "chunk_size",
-				"description": "Default window size in characters for the size strategy",
-				"required": false,
-				"type": "integer",
-				"in": "body"
-			},
-			{
-				"name": "chunk_overlap",
-				"description": "Default overlap in characters for the size strategy",
-				"required": false,
-				"type": "integer",
-				"in": "body"
-			},
-			{
-				"name": "metadata",
-				"description": "Arbitrary JSON metadata",
-				"required": false,
-				"type": "object",
-				"in": "body"
 			}
 		]
 	},
-	"get-ingestion-rule": {
-		serviceClass: "IngestionRules",
-		operationId: "getIngestionRule",
-		description: "Returns a specific ingestion rule",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/ingestion-rules",
+	"get-guardrail": {
+		serviceClass: "Guardrails",
+		operationId: "getGuardrail",
+		description: "Returns a single guardrail by ID.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/guardrails",
 		httpMethod: "get",
-		pathParams: ["project_id", "ingestion_rule_id"],
+		pathParams: ["project_id", "guardrail_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -9344,20 +10025,20 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "ingestion_rule_id",
-			"description": "Ingestion rule ID",
+			"name": "guardrail_id",
+			"description": "",
 			"required": true,
 			"type": "string",
 			"in": "path"
 		}]
 	},
-	"update-ingestion-rule": {
-		serviceClass: "IngestionRules",
-		operationId: "updateIngestionRule",
-		description: "Updates fields of an ingestion rule",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/ingestion-rules",
+	"update-guardrail": {
+		serviceClass: "Guardrails",
+		operationId: "updateGuardrail",
+		description: "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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/guardrails",
 		httpMethod: "patch",
-		pathParams: ["project_id", "ingestion_rule_id"],
+		pathParams: ["project_id", "guardrail_id"],
 		queryParams: [],
 		flags: [
 			{
@@ -9368,98 +10049,63 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "ingestion_rule_id",
-				"description": "Ingestion rule ID",
+				"name": "guardrail_id",
+				"description": "",
 				"required": true,
 				"type": "string",
 				"in": "path"
 			},
 			{
-				"name": "content_type_glob",
-				"description": "",
-				"required": false,
-				"type": "string",
-				"in": "body"
-			},
-			{
-				"name": "tool_id",
-				"description": "",
-				"required": false,
-				"type": "string",
-				"in": "body"
-			},
-			{
-				"name": "agent_id",
+				"name": "name",
 				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "action",
+				"name": "description",
 				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "preset_parameters",
-				"description": "",
+				"name": "document",
+				"description": "The action-class document. `class` maps a call to an action class; `guard` gates class-B autonomy. Both are single JSON Logic expressions over the `args.*` / `context.*` / `runtime.*` namespaces.\n",
 				"required": false,
 				"type": "object",
 				"in": "body"
 			},
 			{
-				"name": "native_extraction",
+				"name": "context_tool_id",
 				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "file_delivery",
+				"name": "context_mode",
 				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "chunk_strategy",
-				"description": "Send `null` to clear the rule's override and fall back to the per-request default.",
+				"name": "version_label",
+				"description": "Optional tag for the config version this write archives (e.g. `pre-tightening`). Annotates the version only — it is not stored on the guardrail and is not part of the config, so labelling a change is never itself a change. Ignored when the write changes no policy, since no version is created.",
 				"required": false,
 				"type": "string",
 				"in": "body"
-			},
-			{
-				"name": "chunk_size",
-				"description": "",
-				"required": false,
-				"type": "integer",
-				"in": "body"
-			},
-			{
-				"name": "chunk_overlap",
-				"description": "",
-				"required": false,
-				"type": "integer",
-				"in": "body"
-			},
-			{
-				"name": "metadata",
-				"description": "",
-				"required": false,
-				"type": "object",
-				"in": "body"
 			}
 		]
 	},
-	"delete-ingestion-rule": {
-		serviceClass: "IngestionRules",
-		operationId: "deleteIngestionRule",
-		description: "Deletes an ingestion rule",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/ingestion-rules",
+	"delete-guardrail": {
+		serviceClass: "Guardrails",
+		operationId: "deleteGuardrail",
+		description: "Deletes a guardrail and its archived versions by ID.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/guardrails",
 		httpMethod: "delete",
-		pathParams: ["project_id", "ingestion_rule_id"],
+		pathParams: ["project_id", "guardrail_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -9468,21 +10114,21 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "ingestion_rule_id",
-			"description": "Ingestion rule ID",
+			"name": "guardrail_id",
+			"description": "",
 			"required": true,
 			"type": "string",
 			"in": "path"
 		}]
 	},
-	"search-knowledge": {
-		serviceClass: "Knowledge",
-		operationId: "searchKnowledge",
-		description: "Searches across documents and memory entries using semantic search, file paths, document IDs, or memory IDs/tags. At least one of `query`, `document_paths`, `document_ids`, `memory_ids`, or `memory_tags` must be provided.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/knowledge",
-		httpMethod: "post",
-		pathParams: ["project_id"],
-		queryParams: [],
+	"list-guardrail-versions": {
+		serviceClass: "Guardrails",
+		operationId: "listGuardrailVersions",
+		description: "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).",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/guardrails",
+		httpMethod: "get",
+		pathParams: ["project_id", "guardrail_id"],
+		queryParams: ["limit", "offset"],
 		flags: [
 			{
 				"name": "project_id",
@@ -9492,56 +10138,866 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "query",
-				"description": "Semantic search query text",
-				"required": false,
+				"name": "guardrail_id",
+				"description": "",
+				"required": true,
 				"type": "string",
-				"in": "body"
+				"in": "path"
 			},
 			{
-				"name": "min_score",
-				"description": "Minimum `score` a result must reach to be returned. Filters on the implementation-defined `score`, not on `similarity_score`, so the cutoff follows the ranking. Only applies when `query` is provided. Because the scale behind `score` is not part of the contract, treat a tuned value as tied to the deployment rather than portable.",
+				"name": "limit",
+				"description": "Maximum number of results to return",
 				"required": false,
-				"type": "number",
-				"in": "body"
+				"type": "integer",
+				"in": "query"
 			},
 			{
-				"name": "limit",
-				"description": "Maximum number of results to return (default 10)",
+				"name": "offset",
+				"description": "Number of results to skip",
 				"required": false,
 				"type": "integer",
-				"in": "body"
+				"in": "query"
+			}
+		]
+	},
+	"get-guardrail-version": {
+		serviceClass: "Guardrails",
+		operationId: "getGuardrailVersion",
+		description: "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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/guardrails",
+		httpMethod: "get",
+		pathParams: [
+			"project_id",
+			"guardrail_id",
+			"version"
+		],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
 			},
 			{
-				"name": "memory_ids",
-				"description": "Search entries within these specific memories",
+				"name": "guardrail_id",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "version",
+				"description": "",
+				"required": true,
+				"type": "integer",
+				"in": "path"
+			}
+		]
+	},
+	"restore-guardrail-version": {
+		serviceClass: "Guardrails",
+		operationId: "restoreGuardrailVersion",
+		description: "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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/guardrails",
+		httpMethod: "post",
+		pathParams: [
+			"project_id",
+			"guardrail_id",
+			"version"
+		],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "guardrail_id",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "version",
+				"description": "",
+				"required": true,
+				"type": "integer",
+				"in": "path"
+			},
+			{
+				"name": "label",
+				"description": "Optional tag for the version the restore creates. Defaults to `restored from v<version>`.",
 				"required": false,
-				"type": "array",
+				"type": "string",
 				"in": "body"
+			}
+		]
+	},
+	"evaluate-guardrail": {
+		serviceClass: "Guardrails",
+		operationId: "evaluateGuardrail",
+		description: "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.*`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/guardrails",
+		httpMethod: "post",
+		pathParams: ["project_id", "guardrail_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
 			},
 			{
-				"name": "memory_tags",
-				"description": "Search entries in memories whose tags match any of these patterns (glob supported)",
+				"name": "guardrail_id",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "args",
+				"description": "The proposed call's arguments (the `args.*` namespace).",
 				"required": false,
-				"type": "array",
+				"type": "object",
 				"in": "body"
 			},
 			{
-				"name": "document_paths",
-				"description": "Filter results to documents whose file path starts with one of these prefixes",
+				"name": "guardrail_context",
+				"description": "The caller-supplied guardrail context (the `context.*` namespace), combined with the context tool per `context_mode`.\n",
 				"required": false,
-				"type": "array",
+				"type": "object",
 				"in": "body"
 			},
 			{
-				"name": "document_ids",
-				"description": "Filter results to specific document IDs",
+				"name": "tool_id",
+				"description": "Optional tool to resolve `runtime.tool.*` against.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"list-ingestion-rules": {
+		serviceClass: "IngestionRules",
+		operationId: "listIngestionRules",
+		description: "Returns the ingestion rules for a project",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/ingestion-rules",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: ["limit", "offset"],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Number of results per page",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Number of results to skip",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"create-ingestion-rule": {
+		serviceClass: "IngestionRules",
+		operationId: "createIngestionRule",
+		description: "Creates a rule mapping a content_type glob to a converter. Exactly one of tool_id or agent_id must be set.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/ingestion-rules",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "content_type_glob",
+				"description": "MIME type glob matched against a file's content_type",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "tool_id",
+				"description": "Converter tool id (mutually exclusive with agent_id)",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "agent_id",
+				"description": "Converter agent id (mutually exclusive with tool_id)",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "action",
+				"description": "Operation id, required for mcp tool converters",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "preset_parameters",
+				"description": "Merged into the tool input before invocation (tool converters only)",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "native_extraction",
+				"description": "For native types (PDF/text): `first` (default) converts only when native extraction yields no text; `skip` always converts.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "file_delivery",
+				"description": "How the file reaches a tool converter (default base64)",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "chunk_strategy",
+				"description": "Default chunk strategy, overridable per ingest request",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "chunk_size",
+				"description": "Default window size in characters for the size strategy",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "chunk_overlap",
+				"description": "Default overlap in characters for the size strategy",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "metadata",
+				"description": "Arbitrary JSON metadata",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"get-ingestion-rule": {
+		serviceClass: "IngestionRules",
+		operationId: "getIngestionRule",
+		description: "Returns a specific ingestion rule",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/ingestion-rules",
+		httpMethod: "get",
+		pathParams: ["project_id", "ingestion_rule_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "ingestion_rule_id",
+			"description": "Ingestion rule ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-ingestion-rule": {
+		serviceClass: "IngestionRules",
+		operationId: "updateIngestionRule",
+		description: "Updates fields of an ingestion rule",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/ingestion-rules",
+		httpMethod: "patch",
+		pathParams: ["project_id", "ingestion_rule_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "ingestion_rule_id",
+				"description": "Ingestion rule ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "content_type_glob",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "tool_id",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "agent_id",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "action",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "preset_parameters",
+				"description": "",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "native_extraction",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "file_delivery",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "chunk_strategy",
+				"description": "Send `null` to clear the rule's override and fall back to the per-request default.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "chunk_size",
+				"description": "",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "chunk_overlap",
+				"description": "",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "metadata",
+				"description": "",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"delete-ingestion-rule": {
+		serviceClass: "IngestionRules",
+		operationId: "deleteIngestionRule",
+		description: "Deletes an ingestion rule",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/ingestion-rules",
+		httpMethod: "delete",
+		pathParams: ["project_id", "ingestion_rule_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "ingestion_rule_id",
+			"description": "Ingestion rule ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"search-knowledge": {
+		serviceClass: "Knowledge",
+		operationId: "searchKnowledge",
+		description: "Searches across documents and memory entries using semantic search, file paths, document IDs, or memory IDs/tags. At least one of `query`, `document_paths`, `document_ids`, `memory_ids`, or `memory_tags` must be provided.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/knowledge",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "query",
+				"description": "Semantic search query text",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "min_score",
+				"description": "Minimum `score` a result must reach to be returned. Filters on the implementation-defined `score`, not on `similarity_score`, so the cutoff follows the ranking. Only applies when `query` is provided. Because the scale behind `score` is not part of the contract, treat a tuned value as tied to the deployment rather than portable.",
+				"required": false,
+				"type": "number",
+				"in": "body"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum number of results to return (default 10)",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "memory_ids",
+				"description": "Search entries within these specific memories",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "memory_tags",
+				"description": "Search entries in memories whose tags match any of these patterns (glob supported)",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "document_paths",
+				"description": "Filter results to documents whose file path starts with one of these prefixes",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "document_ids",
+				"description": "Filter results to specific document IDs",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			}
+		]
+	},
+	"list-memories": {
+		serviceClass: "Memories",
+		operationId: "listMemories",
+		description: "Returns a list of memory configurations for a project",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memories",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: [
+			"tags",
+			"limit",
+			"offset"
+		],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "tags",
+				"description": "Filter memories by tag patterns. Supports glob syntax (`*` matches any substring, `?` matches any single character). Multiple values are ORed — a memory is returned if any of its tags match any of the provided patterns. Omit to return all memories.\n",
+				"required": false,
+				"type": "array",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum number of results to return",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Number of results to skip",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"create-memory": {
+		serviceClass: "Memories",
+		operationId: "createMemory",
+		description: "Creates a new memory configuration in a project",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memories",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "name",
+				"description": "Memory name",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "description",
+				"description": "Optional description",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "tags",
+				"description": "Optional list of tags for filtering in knowledge search",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			}
+		]
+	},
+	"get-memory": {
+		serviceClass: "Memories",
+		operationId: "getMemory",
+		description: "Returns a single memory configuration by ID",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memories",
+		httpMethod: "get",
+		pathParams: ["project_id", "memory_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "memory_id",
+			"description": "",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-memory": {
+		serviceClass: "Memories",
+		operationId: "updateMemory",
+		description: "Updates an existing memory configuration",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memories",
+		httpMethod: "put",
+		pathParams: ["project_id", "memory_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "memory_id",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "name",
+				"description": "Memory name",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "description",
+				"description": "Optional description",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "tags",
+				"description": "Optional list of tags for filtering in knowledge search",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			}
+		]
+	},
+	"delete-memory": {
+		serviceClass: "Memories",
+		operationId: "deleteMemory",
+		description: "Deletes a memory configuration",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memories",
+		httpMethod: "delete",
+		pathParams: ["project_id", "memory_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "memory_id",
+			"description": "",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"list-memory-entries": {
+		serviceClass: "MemoryEntries",
+		operationId: "listMemoryEntries",
+		description: "Returns all entries in a memory container",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: [
+			"memory_id",
+			"limit",
+			"offset",
+			"include_invalidated"
+		],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "memory_id",
+				"description": "Memory container to list entries from (mem_...)",
+				"required": true,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum number of results to return",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Number of results to skip",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "include_invalidated",
+				"description": "Include invalidated (superseded) entries. They are excluded by default; set this to audit the supersede history.",
+				"required": false,
+				"type": "boolean",
+				"in": "query"
+			}
+		]
+	},
+	"create-memory-entry": {
+		serviceClass: "MemoryEntries",
+		operationId: "createMemoryEntry",
+		description: "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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "memory_id",
+				"description": "Memory container to add the entry to (mem_...)",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "content",
+				"description": "The text content of the memory entry",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "source_type",
+				"description": "How this entry was created",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "tags",
+				"description": "Per-entry tag strings, used for entry-granularity filtering in search-knowledge (memory_tags)",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "metadata",
+				"description": "Arbitrary structured metadata attached to the entry",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "duplicate_threshold",
+				"description": "Cosine similarity score at or above which the incoming content is considered a duplicate of an existing entry and skipped (default 0.95). Below it the entry is always created.",
+				"required": false,
+				"type": "number",
+				"in": "body"
+			}
+		]
+	},
+	"get-memory-entry": {
+		serviceClass: "MemoryEntries",
+		operationId: "getMemoryEntry",
+		description: "Returns a single memory entry by ID",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+		httpMethod: "get",
+		pathParams: ["project_id", "entry_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "entry_id",
+			"description": "",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-memory-entry": {
+		serviceClass: "MemoryEntries",
+		operationId: "updateMemoryEntry",
+		description: "Updates an existing memory entry. Regenerates the embedding if content changes.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+		httpMethod: "put",
+		pathParams: ["project_id", "entry_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "entry_id",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "content",
+				"description": "Updated text content",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "tags",
+				"description": "Replaces the entry's tags. Pass null or an empty array to clear.",
 				"required": false,
 				"type": "array",
 				"in": "body"
+			},
+			{
+				"name": "metadata",
+				"description": "Replaces the entry's metadata. Pass null to clear.",
+				"required": false,
+				"type": "object",
+				"in": "body"
 			}
 		]
 	},
+	"delete-memory-entry": {
+		serviceClass: "MemoryEntries",
+		operationId: "deleteMemoryEntry",
+		description: "Deletes a memory entry",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+		httpMethod: "delete",
+		pathParams: ["project_id", "entry_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "entry_id",
+			"description": "",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
 	"list-model-routes": {
 		serviceClass: "ModelRoutes",
 		operationId: "listModelRoutes",