@naturali/cli 0.71.2 → 0.73.0

package/dist/index.mjs

@@ -14,9 +14,23 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.71.2";
+var version = "0.73.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
+const serializeFormDataPair = (data, key, value) => {
+	if (typeof value === "string" || value instanceof Blob) data.append(key, value);
+	else if (value instanceof Date) data.append(key, value.toISOString());
+	else data.append(key, JSON.stringify(value));
+};
+const formDataBodySerializer = { bodySerializer: (body) => {
+	const data = new FormData();
+	Object.entries(body).forEach(([key, value]) => {
+		if (value === void 0 || value === null) return;
+		if (Array.isArray(value)) value.forEach((v) => serializeFormDataPair(data, key, v));
+		else serializeFormDataPair(data, key, value);
+	});
+	return data;
+} };
 const jsonBodySerializer = { bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value) };
 //#endregion
 //#region ../sdk/src/generated/core/serverSentEvents.gen.ts
@@ -1677,6 +1691,196 @@ var Conversations = class {
 		});
 	}
 };
+var Documents = class {
+	/**
+	* List documents
+	*
+	* Returns all documents the caller has access to. If projectId is provided, returns only documents in that project. project keys are scoped to a single project automatically. JWT users without projectId receive documents across all their accessible projects.
+	*/
+	static listDocuments(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/documents",
+			...options
+		});
+	}
+	/**
+	* Create a document
+	*
+	* Creates a new text document and generates an embedding vector for semantic search. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.
+	*/
+	static createDocument(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/documents",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Ingest a file into a chunked document
+	*
+	* Parses an already-uploaded file and creates one Document split into one or
+	* more embedded chunks. The source format is detected from the file's content
+	* type: PDFs are parsed page-by-page; `text/plain` and `text/markdown` files
+	* are read as a single source. How the source is chunked is controlled by
+	* `chunk_strategy`.
+	*
+	* A file can only back one Document — a second call with the same `file_id`
+	* returns `409 FILE_ALREADY_INGESTED`. To re-process an already-ingested file
+	* (e.g. with a different `chunk_strategy`), use
+	* `POST /documents/{document_id}/ingest`; to ingest the same source under a
+	* different path, upload a new copy of the file first.
+	*
+	*/
+	static ingestDocument(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/documents/ingest",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a document
+	*
+	* Deletes a document and its underlying file
+	*/
+	static deleteDocument(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/documents/{document_id}",
+			...options
+		});
+	}
+	/**
+	* Get a document by ID
+	*
+	* Returns a document with its text content
+	*/
+	static getDocument(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/documents/{document_id}",
+			...options
+		});
+	}
+	/**
+	* Update a document
+	*
+	* Updates document content, title, path, metadata, or tags. Supplying `path` moves the document to a new logical path within the project.
+	*/
+	static updateDocument(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/documents/{document_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Get document ingestion status
+	*
+	* Returns a lightweight ingestion status payload for polling — `status`,
+	* `chunk_count`, `total_pages`, and (when failed) `error`. Unlike
+	* `GET /documents/{document_id}`, it never returns the assembled chunk
+	* content, so it is cheap to poll on large documents. A document whose
+	* ingestion has stalled (no progress past the configured timeout) is
+	* transitioned to `failed` with `error=INGESTION_TIMEOUT` on read.
+	*
+	*/
+	static getDocumentStatus(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/documents/{document_id}/status",
+			...options
+		});
+	}
+	/**
+	* Re-ingest an existing document
+	*
+	* Re-runs ingestion for an existing document against its already-stored
+	* source file. Existing chunks are discarded and the document is reset to
+	* `status=pending` before re-processing. Use this to recover a document
+	* stuck in `processing`/`failed` or to re-chunk with a different strategy
+	* without re-uploading the file. Background by default (`202`); pass
+	* `?wait=true` to run synchronously (`201`).
+	*
+	*/
+	static reingestDocument(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/documents/{document_id}/ingest",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Get document tags
+	*
+	* Returns all tags attached to the document
+	*/
+	static getDocumentTags(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/documents/{document_id}/tags",
+			...options
+		});
+	}
+	/**
+	* Merge document tags
+	*
+	* Merges provided tags with existing tags (existing tags are preserved unless overridden)
+	*/
+	static mergeDocumentTags(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/documents/{document_id}/tags",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Replace document tags
+	*
+	* Replaces all tags on the document with the provided tags (not merged)
+	*/
+	static replaceDocumentTags(options) {
+		return (options.client ?? client).put({
+			url: "/v1/projects/{project_id}/documents/{document_id}/tags",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
+var Embeddings = class {
+	/**
+	* Create embeddings
+	*
+	* Generates embedding vectors for one or more text inputs using the server's configured embedding model.
+	* Provide `input` for a single text or `inputs` for a batch. At least one is required.
+	* Returns `embedding` when `input` is used, and `embeddings` when `inputs` is used.
+	*
+	*/
+	static createEmbeddings(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/embeddings",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var Evaluations = class {
 	/**
 	* List datasets
@@ -1953,6 +2157,165 @@ var Evaluations = class {
 		});
 	}
 };
+var Files = class {
+	/**
+	* List all files
+	*
+	* Returns a list of all stored files
+	*/
+	static listFiles(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/files",
+			...options
+		});
+	}
+	/**
+	* Create a file
+	*
+	* Creates a new file record in the system
+	*/
+	static createFile(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/files",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Upload a file
+	*
+	* Uploads a file to the server and stores it in the configured storage directory
+	*/
+	static uploadFile(options) {
+		return (options.client ?? client).post({
+			...formDataBodySerializer,
+			url: "/v1/projects/{project_id}/files/upload",
+			...options,
+			headers: {
+				"Content-Type": null,
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Upload a file using base64 encoding
+	*
+	* Uploads a file to the server using base64-encoded content
+	*/
+	static uploadFileBase64(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/files/upload/base64",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a file
+	*
+	* Removes a file from the system by ID
+	*/
+	static deleteFile(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/files/{file_id}",
+			...options
+		});
+	}
+	/**
+	* Get a file by ID
+	*
+	* Returns the data and metadata of a specific file
+	*/
+	static getFile(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/files/{file_id}",
+			...options
+		});
+	}
+	/**
+	* Download a file
+	*
+	* Streams the file content to the client
+	*/
+	static downloadFile(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/files/{file_id}/download",
+			...options
+		});
+	}
+	/**
+	* Update file metadata
+	*
+	* Updates the metadata field of a file
+	*/
+	static updateFileMetadata(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/files/{file_id}/metadata",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Download file as base64
+	*
+	* Returns the file content encoded as base64
+	*/
+	static downloadFileBase64(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/files/{file_id}/download/base64",
+			...options
+		});
+	}
+	/**
+	* Get file tags
+	*
+	* Returns all tags attached to the file
+	*/
+	static getFileTags(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/files/{file_id}/tags",
+			...options
+		});
+	}
+	/**
+	* Merge file tags
+	*
+	* Merges provided tags with existing tags
+	*/
+	static mergeFileTags(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/files/{file_id}/tags",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Replace file tags
+	*
+	* Replaces all tags on the file with the provided tags
+	*/
+	static replaceFileTags(options) {
+		return (options.client ?? client).put({
+			url: "/v1/projects/{project_id}/files/{file_id}/tags",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var Generations = class {
 	/**
 	* List generations
@@ -2029,26 +2392,26 @@ var Generations = class {
 		});
 	}
 };
-var ModelRoutes = class {
+var IngestionRules = class {
 	/**
-	* List model routes
+	* List ingestion rules
 	*
-	* Returns the model routes defined in a project
+	* Returns the ingestion rules for a project
 	*/
-	static listModelRoutes(options) {
+	static listIngestionRules(options) {
 		return (options.client ?? client).get({
-			url: "/v1/projects/{project_id}/model-routes",
+			url: "/v1/projects/{project_id}/ingestion-rules",
 			...options
 		});
 	}
 	/**
-	* Create a model route
+	* Create an ingestion rule
 	*
-	* Creates a project-scoped model route: a named, ordered list of provider+model targets tried in array order. Every target must reference an AI provider in the same project (400 otherwise), and the total attempt budget — the sum of `1 + max_retries` over all targets — may not exceed 10 (400 naming the computed total). A duplicate `name` in the project is rejected with 409.
+	* Creates a rule mapping a content_type glob to a converter. Exactly one of tool_id or agent_id must be set.
 	*/
-	static createModelRoute(options) {
+	static createIngestionRule(options) {
 		return (options.client ?? client).post({
-			url: "/v1/projects/{project_id}/model-routes",
+			url: "/v1/projects/{project_id}/ingestion-rules",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -2057,35 +2420,35 @@ var ModelRoutes = class {
 		});
 	}
 	/**
-	* Delete a model route
+	* Delete an ingestion rule
 	*
-	* Deletes a model route. Returns 409 when an agent still references it — a routed agent has no pinned provider to fall back on, so the reference must be repointed or the agent deleted first.
+	* Deletes an ingestion rule
 	*/
-	static deleteModelRoute(options) {
+	static deleteIngestionRule(options) {
 		return (options.client ?? client).delete({
-			url: "/v1/projects/{project_id}/model-routes/{route_id}",
+			url: "/v1/projects/{project_id}/ingestion-rules/{ingestion_rule_id}",
 			...options
 		});
 	}
 	/**
-	* Get a model route
+	* Get an ingestion rule
 	*
-	* Returns a specific model route
+	* Returns a specific ingestion rule
 	*/
-	static getModelRoute(options) {
+	static getIngestionRule(options) {
 		return (options.client ?? client).get({
-			url: "/v1/projects/{project_id}/model-routes/{route_id}",
+			url: "/v1/projects/{project_id}/ingestion-rules/{ingestion_rule_id}",
 			...options
 		});
 	}
 	/**
-	* Update a model route
+	* Update an ingestion rule
 	*
-	* Updates a model route's name, targets, retry classes, or breaker configuration. Omitted fields are left unchanged.
+	* Updates fields of an ingestion rule
 	*/
-	static updateModelRoute(options) {
-		return (options.client ?? client).put({
-			url: "/v1/projects/{project_id}/model-routes/{route_id}",
+	static updateIngestionRule(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/ingestion-rules/{ingestion_rule_id}",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -2094,9 +2457,91 @@ var ModelRoutes = class {
 		});
 	}
 };
-var Models = class {
+var Knowledge = class {
 	/**
-	* List models
+	* Search knowledge
+	*
+	* 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.
+	*/
+	static searchKnowledge(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/knowledge/search",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
+var ModelRoutes = class {
+	/**
+	* List model routes
+	*
+	* Returns the model routes defined in a project
+	*/
+	static listModelRoutes(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/model-routes",
+			...options
+		});
+	}
+	/**
+	* Create a model route
+	*
+	* Creates a project-scoped model route: a named, ordered list of provider+model targets tried in array order. Every target must reference an AI provider in the same project (400 otherwise), and the total attempt budget — the sum of `1 + max_retries` over all targets — may not exceed 10 (400 naming the computed total). A duplicate `name` in the project is rejected with 409.
+	*/
+	static createModelRoute(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/model-routes",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a model route
+	*
+	* Deletes a model route. Returns 409 when an agent still references it — a routed agent has no pinned provider to fall back on, so the reference must be repointed or the agent deleted first.
+	*/
+	static deleteModelRoute(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/model-routes/{route_id}",
+			...options
+		});
+	}
+	/**
+	* Get a model route
+	*
+	* Returns a specific model route
+	*/
+	static getModelRoute(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/model-routes/{route_id}",
+			...options
+		});
+	}
+	/**
+	* Update a model route
+	*
+	* Updates a model route's name, targets, retry classes, or breaker configuration. Omitted fields are left unchanged.
+	*/
+	static updateModelRoute(options) {
+		return (options.client ?? client).put({
+			url: "/v1/projects/{project_id}/model-routes/{route_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
+var Models = class {
+	/**
+	* List models
 	*
 	* Lists catalog models, sorted by id. Filter by vendor, provider, input/output modality, status, or `managed` — the last being the axis that decides whether a model is usable without bringing your own provider credentials, so `?managed=true&status=available` is the set a project's managed provider serves today.
 	*
@@ -3361,8 +3806,13 @@ var NaturaliClient = class {
 	channels;
 	auth;
 	conversations;
+	documents;
+	embeddings;
 	evaluations;
+	files;
 	generations;
+	ingestionRules;
+	knowledge;
 	modelRoutes;
 	models;
 	orchestrations;
@@ -3395,8 +3845,13 @@ var NaturaliClient = class {
 		this.channels = bindResource(Channels, this.http);
 		this.auth = bindResource(Auth, this.http);
 		this.conversations = bindResource(Conversations, this.http);
+		this.documents = bindResource(Documents, this.http);
+		this.embeddings = bindResource(Embeddings, this.http);
 		this.evaluations = bindResource(Evaluations, this.http);
+		this.files = bindResource(Files, this.http);
 		this.generations = bindResource(Generations, this.http);
+		this.ingestionRules = bindResource(IngestionRules, this.http);
+		this.knowledge = bindResource(Knowledge, this.http);
 		this.modelRoutes = bindResource(ModelRoutes, this.http);
 		this.models = bindResource(Models, this.http);
 		this.orchestrations = bindResource(Orchestrations, this.http);
@@ -3424,8 +3879,13 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	Auth: () => Auth,
 	Channels: () => Channels,
 	Conversations: () => Conversations,
+	Documents: () => Documents,
+	Embeddings: () => Embeddings,
 	Evaluations: () => Evaluations,
+	Files: () => Files,
 	Generations: () => Generations,
+	IngestionRules: () => IngestionRules,
+	Knowledge: () => Knowledge,
 	ModelRoutes: () => ModelRoutes,
 	Models: () => Models,
 	NaturaliClient: () => NaturaliClient,
@@ -6988,14 +7448,18 @@ const routes = {
 			"in": "path"
 		}]
 	},
-	"list-datasets": {
-		serviceClass: "Evaluations",
-		operationId: "listDatasets",
-		description: "Returns the datasets defined in a project",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
+	"list-documents": {
+		serviceClass: "Documents",
+		operationId: "listDocuments",
+		description: "Returns all documents the caller has access to. If projectId is provided, returns only documents in that project. project keys are scoped to a single project automatically. JWT users without projectId receive documents across all their accessible projects.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
 		httpMethod: "get",
 		pathParams: ["project_id"],
-		queryParams: ["limit", "offset"],
+		queryParams: [
+			"path_prefix",
+			"limit",
+			"offset"
+		],
 		flags: [
 			{
 				"name": "project_id",
@@ -7004,6 +7468,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "path_prefix",
+				"description": "Only documents filed under this directory. The prefix is a path boundary, not a substring: `/reports` returns `/reports/q1.txt` and never `/reports-archive/q1.txt`, and `/` selects the whole project. A leading slash is optional and a trailing one is ignored, so `reports`, `/reports` and `/reports/` are the same filter. `%` and `_` are literal characters, not wildcards.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "limit",
 				"description": "Maximum number of results to return",
@@ -7020,11 +7491,11 @@ const routes = {
 			}
 		]
 	},
-	"create-dataset": {
-		serviceClass: "Evaluations",
-		operationId: "createDataset",
-		description: "Creates a project-scoped dataset — a named collection of test cases an eval runs an agent against. Names are unique per project. Datasets are operator-owned **fixtures**. The platform's content purge never deletes or mutates a dataset item, so erasing a generation cannot silently stop a test suite from being runnable.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
+	"create-document": {
+		serviceClass: "Documents",
+		operationId: "createDocument",
+		description: "Creates a new text document and generates an embedding vector for semantic search. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
 		httpMethod: "post",
 		pathParams: ["project_id"],
 		queryParams: [],
@@ -7037,51 +7508,78 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "name",
-				"description": "Unique name within the project",
+				"name": "content",
+				"description": "",
 				"required": true,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "description",
-				"description": "What this suite covers",
+				"name": "path",
+				"description": "Logical path within the project (e.g. /reports/q1.txt). Defaults to /filename if omitted.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "filename",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "title",
+				"description": "Document title",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "metadata",
+				"description": "Arbitrary metadata object. Unlike other body fields, keys are stored and returned verbatim in the casing supplied — they are not converted between snake_case and camelCase.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "tags",
+				"description": "Key-value tags",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "chunk_strategy",
+				"description": "How to split the content into embeddable chunks. `whole` (default) stores the content as a single chunk; `size` splits into fixed-size character windows with overlap. `page` is equivalent to `whole` for plain text.",
 				"required": false,
 				"type": "string",
 				"in": "body"
+			},
+			{
+				"name": "chunk_size",
+				"description": "Window size in characters when `chunk_strategy=size`. Defaults to 1000.",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "chunk_overlap",
+				"description": "Overlap in characters between consecutive windows when `chunk_strategy=size`. Defaults to 200.",
+				"required": false,
+				"type": "integer",
+				"in": "body"
 			}
 		]
 	},
-	"get-dataset": {
-		serviceClass: "Evaluations",
-		operationId: "getDataset",
-		description: "Returns a specific dataset",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
-		httpMethod: "get",
-		pathParams: ["project_id", "dataset_id"],
-		queryParams: [],
-		flags: [{
-			"name": "project_id",
-			"description": "Project public ID (proj_ prefix).",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}, {
-			"name": "dataset_id",
-			"description": "Dataset ID",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}]
-	},
-	"update-dataset": {
-		serviceClass: "Evaluations",
-		operationId: "updateDataset",
-		description: "Updates a dataset's name and/or description",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
-		httpMethod: "put",
-		pathParams: ["project_id", "dataset_id"],
-		queryParams: [],
+	"ingest-document": {
+		serviceClass: "Documents",
+		operationId: "ingestDocument",
+		description: "Parses an already-uploaded file and creates one Document split into one or more embedded chunks. The source format is detected from the file's content type: PDFs are parsed page-by-page; `text/plain` and `text/markdown` files are read as a single source. How the source is chunked is controlled by `chunk_strategy`. A file can only back one Document — a second call with the same `file_id` returns `409 FILE_ALREADY_INGESTED`. To re-process an already-ingested file (e.g. with a different `chunk_strategy`), use `POST /documents/{document_id}/ingest`; to ingest the same source under a different path, upload a new copy of the file first.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: ["wait"],
 		flags: [
 			{
 				"name": "project_id",
@@ -7091,35 +7589,63 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "dataset_id",
-				"description": "Dataset ID",
+				"name": "wait",
+				"description": "When omitted or `false` (default), processing runs in the background and `202 Accepted` is returned immediately with `status=pending`. Pass `true` to block until processing completes and receive `201 Created` with `status=ready`.",
+				"required": false,
+				"type": "boolean",
+				"in": "query"
+			},
+			{
+				"name": "file_id",
+				"description": "ID of the uploaded file. Must be one of application/pdf, text/plain, text/markdown.",
 				"required": true,
 				"type": "string",
-				"in": "path"
+				"in": "body"
 			},
 			{
-				"name": "name",
-				"description": "",
+				"name": "path_prefix",
+				"description": "Path prefix under which to store the document (e.g. /docs/). The filename is appended automatically.",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "description",
-				"description": "",
+				"name": "tags",
+				"description": "Key-value tags to attach to the document.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "chunk_strategy",
+				"description": "How to split the source into chunks. `page` (default) creates one chunk per non-empty page (PDF); for non-paged sources it yields a single chunk. `whole` joins everything into one chunk. `size` splits into fixed-size character windows with overlap.",
 				"required": false,
 				"type": "string",
 				"in": "body"
+			},
+			{
+				"name": "chunk_size",
+				"description": "Window size in characters when `chunk_strategy=size`. Defaults to 1000.",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "chunk_overlap",
+				"description": "Overlap in characters between consecutive windows when `chunk_strategy=size`. Defaults to 200.",
+				"required": false,
+				"type": "integer",
+				"in": "body"
 			}
 		]
 	},
-	"delete-dataset": {
-		serviceClass: "Evaluations",
-		operationId: "deleteDataset",
-		description: "Deletes a dataset, its items, and every eval bound to it. Results of runs that already scored those items keep their frozen copies of the input and expected output.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
-		httpMethod: "delete",
-		pathParams: ["project_id", "dataset_id"],
+	"get-document": {
+		serviceClass: "Documents",
+		operationId: "getDocument",
+		description: "Returns a document with its text content",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
+		httpMethod: "get",
+		pathParams: ["project_id", "document_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -7128,21 +7654,21 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "dataset_id",
-			"description": "Dataset ID",
+			"name": "document_id",
+			"description": "Document ID",
 			"required": true,
 			"type": "string",
 			"in": "path"
 		}]
 	},
-	"list-dataset-items": {
-		serviceClass: "Evaluations",
-		operationId: "listDatasetItems",
-		description: "Returns the test cases in a dataset, oldest first",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
-		httpMethod: "get",
-		pathParams: ["project_id", "dataset_id"],
-		queryParams: ["limit", "offset"],
+	"update-document": {
+		serviceClass: "Documents",
+		operationId: "updateDocument",
+		description: "Updates document content, title, path, metadata, or tags. Supplying `path` moves the document to a new logical path within the project.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
+		httpMethod: "patch",
+		pathParams: ["project_id", "document_id"],
+		queryParams: [],
 		flags: [
 			{
 				"name": "project_id",
@@ -7152,82 +7678,101 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "dataset_id",
-				"description": "Dataset ID",
+				"name": "document_id",
+				"description": "Document ID",
 				"required": true,
 				"type": "string",
 				"in": "path"
 			},
 			{
-				"name": "limit",
-				"description": "Maximum number of results to return",
+				"name": "content",
+				"description": "New text content",
 				"required": false,
-				"type": "integer",
-				"in": "query"
+				"type": "string",
+				"in": "body"
 			},
 			{
-				"name": "offset",
-				"description": "Number of results to skip",
+				"name": "title",
+				"description": "New title",
 				"required": false,
-				"type": "integer",
-				"in": "query"
-			}
-		]
-	},
-	"create-dataset-item": {
-		serviceClass: "Evaluations",
-		operationId: "createDatasetItem",
-		description: "Adds one test case. `input` is replayed verbatim as the generation's messages, so it must be a non-empty array of `{ role, content }`.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
-		httpMethod: "post",
-		pathParams: ["project_id", "dataset_id"],
-		queryParams: [],
-		flags: [
+				"type": "string",
+				"in": "body"
+			},
 			{
-				"name": "project_id",
-				"description": "Project public ID (proj_ prefix).",
-				"required": true,
-				"type": "string",
-				"in": "path"
-			},
-			{
-				"name": "dataset_id",
-				"description": "Dataset ID",
-				"required": true,
+				"name": "path",
+				"description": "Logical path within the project (e.g. /reports/q1.txt). Pass null to clear.",
+				"required": false,
 				"type": "string",
-				"in": "path"
-			},
-			{
-				"name": "input",
-				"description": "Messages replayed verbatim as the generation's input",
-				"required": true,
-				"type": "array",
 				"in": "body"
 			},
 			{
-				"name": "expected_output",
-				"description": "Reference answer for exact_match / embedding_similarity / llm_judge scorers",
+				"name": "metadata",
+				"description": "Arbitrary metadata object. Unlike other body fields, keys are stored and returned verbatim in the casing supplied — they are not converted between snake_case and camelCase.",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
-				"name": "metadata",
-				"description": "Free-form tags, opaque to the platform",
+				"name": "tags",
+				"description": "Key-value tags",
 				"required": false,
 				"type": "object",
 				"in": "body"
 			}
 		]
 	},
-	"create-dataset-item-from-generation": {
-		serviceClass: "Evaluations",
-		operationId: "createDatasetItemFromGeneration",
-		description: "Promotes a real, completed generation into a test case: its input messages become the item's `input`, and its own answer becomes `expected_output` unless you supply one. Use it to build an evaluation set out of production traffic rather than hand-authoring fixtures. The item is a **copy**, not a view. It keeps working after the source generation's content is purged, and `source_generation_id` goes null if that generation is deleted — a purge can never quietly stop a suite from being runnable. Requires both `evaluations:CreateDataset` and `generations:GetGeneration`: the call copies content out of a generation, so a principal that may not read that generation may not curate it either. Only a **completed** generation can be promoted (`409 GENERATION_NOT_COMPLETED`), and only while its content is still available: an agent or project running with `trace_content_mode: none` never stored the input, and a purged or expired generation no longer has it (`409 GENERATION_CONTENT_UNAVAILABLE`). Generations that predate input recording answer the same way.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
-		httpMethod: "post",
-		pathParams: ["project_id", "dataset_id"],
+	"delete-document": {
+		serviceClass: "Documents",
+		operationId: "deleteDocument",
+		description: "Deletes a document and its underlying file",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
+		httpMethod: "delete",
+		pathParams: ["project_id", "document_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "document_id",
+			"description": "Document ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"get-document-status": {
+		serviceClass: "Documents",
+		operationId: "getDocumentStatus",
+		description: "Returns a lightweight ingestion status payload for polling — `status`, `chunk_count`, `total_pages`, and (when failed) `error`. Unlike `GET /documents/{document_id}`, it never returns the assembled chunk content, so it is cheap to poll on large documents. A document whose ingestion has stalled (no progress past the configured timeout) is transitioned to `failed` with `error=INGESTION_TIMEOUT` on read.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
+		httpMethod: "get",
+		pathParams: ["project_id", "document_id"],
 		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "document_id",
+			"description": "Document ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"reingest-document": {
+		serviceClass: "Documents",
+		operationId: "reingestDocument",
+		description: "Re-runs ingestion for an existing document against its already-stored source file. Existing chunks are discarded and the document is reset to `status=pending` before re-processing. Use this to recover a document stuck in `processing`/`failed` or to re-chunk with a different strategy without re-uploading the file. Background by default (`202`); pass `?wait=true` to run synchronously (`201`).",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
+		httpMethod: "post",
+		pathParams: ["project_id", "document_id"],
+		queryParams: ["wait"],
 		flags: [
 			{
 				"name": "project_id",
@@ -7237,46 +7782,115 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "dataset_id",
-				"description": "Dataset ID",
+				"name": "document_id",
+				"description": "Document ID",
 				"required": true,
 				"type": "string",
 				"in": "path"
 			},
 			{
-				"name": "generation_id",
-				"description": "The completed generation to promote. Must belong to the same project as the dataset.",
-				"required": true,
+				"name": "wait",
+				"description": "When omitted or `false` (default), processing runs in the background and `202 Accepted` is returned immediately with `status=pending`. Pass `true` to block until processing completes and receive `201 Created` with `status=ready`.",
+				"required": false,
+				"type": "boolean",
+				"in": "query"
+			},
+			{
+				"name": "chunk_strategy",
+				"description": "How to split the source into chunks. Defaults to `page`.",
+				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "expected_output",
-				"description": "Reference answer. Omit to use the generation's own answer; pass `null` to store the item with no reference answer.",
+				"name": "chunk_size",
+				"description": "Window size in characters when `chunk_strategy=size`. Defaults to 1000.",
 				"required": false,
-				"type": "string",
+				"type": "integer",
 				"in": "body"
 			},
 			{
-				"name": "metadata",
-				"description": "Free-form tags, opaque to the platform",
+				"name": "chunk_overlap",
+				"description": "Overlap in characters between consecutive windows when `chunk_strategy=size`. Defaults to 200.",
 				"required": false,
-				"type": "object",
+				"type": "integer",
 				"in": "body"
 			}
 		]
 	},
-	"update-dataset-item": {
-		serviceClass: "Evaluations",
-		operationId: "updateDatasetItem",
-		description: "Updates a test case. Runs that already scored it are unaffected — each result carries its own frozen copy of the input and expected output.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
+	"get-document-tags": {
+		serviceClass: "Documents",
+		operationId: "getDocumentTags",
+		description: "Returns all tags attached to the document",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
+		httpMethod: "get",
+		pathParams: ["project_id", "document_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "document_id",
+			"description": "Document ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"replace-document-tags": {
+		serviceClass: "Documents",
+		operationId: "replaceDocumentTags",
+		description: "Replaces all tags on the document with the provided tags (not merged)",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
 		httpMethod: "put",
-		pathParams: [
-			"project_id",
-			"dataset_id",
-			"item_id"
-		],
+		pathParams: ["project_id", "document_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "document_id",
+			"description": "Document ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"merge-document-tags": {
+		serviceClass: "Documents",
+		operationId: "mergeDocumentTags",
+		description: "Merges provided tags with existing tags (existing tags are preserved unless overridden)",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
+		httpMethod: "patch",
+		pathParams: ["project_id", "document_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "document_id",
+			"description": "Document ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"create-embeddings": {
+		serviceClass: "Embeddings",
+		operationId: "createEmbeddings",
+		description: "Generates embedding vectors for one or more text inputs using the server's configured embedding model. Provide `input` for a single text or `inputs` for a batch. At least one is required. Returns `embedding` when `input` is used, and `embeddings` when `inputs` is used.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/embeddings",
+		httpMethod: "post",
+		pathParams: ["project_id"],
 		queryParams: [],
 		flags: [
 			{
@@ -7286,83 +7900,26 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
-			{
-				"name": "dataset_id",
-				"description": "Dataset ID",
-				"required": true,
-				"type": "string",
-				"in": "path"
-			},
-			{
-				"name": "item_id",
-				"description": "Dataset item ID",
-				"required": true,
-				"type": "string",
-				"in": "path"
-			},
 			{
 				"name": "input",
-				"description": "Messages replayed verbatim as the generation's input",
-				"required": false,
-				"type": "array",
-				"in": "body"
-			},
-			{
-				"name": "expected_output",
-				"description": "",
+				"description": "Single text to embed.",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "metadata",
-				"description": "",
+				"name": "inputs",
+				"description": "Batch of texts to embed.",
 				"required": false,
-				"type": "object",
+				"type": "array",
 				"in": "body"
 			}
 		]
 	},
-	"delete-dataset-item": {
-		serviceClass: "Evaluations",
-		operationId: "deleteDatasetItem",
-		description: "Deletes a test case. Results of runs that already scored it stay readable; their `dataset_item_id` becomes null.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
-		httpMethod: "delete",
-		pathParams: [
-			"project_id",
-			"dataset_id",
-			"item_id"
-		],
-		queryParams: [],
-		flags: [
-			{
-				"name": "project_id",
-				"description": "Project public ID (proj_ prefix).",
-				"required": true,
-				"type": "string",
-				"in": "path"
-			},
-			{
-				"name": "dataset_id",
-				"description": "Dataset ID",
-				"required": true,
-				"type": "string",
-				"in": "path"
-			},
-			{
-				"name": "item_id",
-				"description": "Dataset item ID",
-				"required": true,
-				"type": "string",
-				"in": "path"
-			}
-		]
-	},
-	"list-evals": {
+	"list-datasets": {
 		serviceClass: "Evaluations",
-		operationId: "listEvals",
-		description: "Returns the evals defined in a project",
+		operationId: "listDatasets",
+		description: "Returns the datasets defined in a project",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
 		httpMethod: "get",
 		pathParams: ["project_id"],
@@ -7391,10 +7948,10 @@ const routes = {
 			}
 		]
 	},
-	"create-eval": {
+	"create-dataset": {
 		serviceClass: "Evaluations",
-		operationId: "createEval",
-		description: "Binds an agent under test to a dataset and a list of scorers. The agent and the dataset must belong to the same project as the eval; a cross-project reference is rejected with 400. Scorer config is frozen here rather than read from the agent at run time, so two runs of the same eval are always judged by the same criteria and their comparison measures the agent instead of the config drifting underneath it. Each scorer `type` may appear at most once.",
+		operationId: "createDataset",
+		description: "Creates a project-scoped dataset — a named collection of test cases an eval runs an agent against. Names are unique per project. Datasets are operator-owned **fixtures**. The platform's content purge never deletes or mutates a dataset item, so erasing a generation cannot silently stop a test suite from being runnable.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
 		httpMethod: "post",
 		pathParams: ["project_id"],
@@ -7415,42 +7972,21 @@ const routes = {
 				"in": "body"
 			},
 			{
-				"name": "agent_id",
-				"description": "The agent under test",
-				"required": true,
-				"type": "string",
-				"in": "body"
-			},
-			{
-				"name": "dataset_id",
-				"description": "The dataset to run it against",
-				"required": true,
-				"type": "string",
-				"in": "body"
-			},
-			{
-				"name": "scorers",
-				"description": "Scorer configs, a discriminated union on `type`. Each type may appear at most once. Every scorer produces `{ score: 0–1, passed: boolean }`; binary scorers emit 0 or 1.\n\n`exact_match` compares the trimmed output text to `expected_output`. `contains` looks for `value` in the output text. `json_logic` evaluates `expression` over `{ input, output, object, expected, item.metadata }`, where `object` is the structured output (absent when the agent has no `output_schema`). `output_schema` validates the structured output against the scorer's own `schema`, falling back to the agent's; it requires the agent to carry an `output_schema`, because without one the platform emits no structured output and every item would score 0.\n\n`llm_judge` grades the output with a model completion, returning a continuous score plus its `reasoning`. Its `pass_threshold` is required: a continuous score says nothing about where \"good enough\" is, and a defaulted cutoff would silently decide the gate.\n\n`embedding_similarity` embeds the output text and `expected_output` with the platform's configured embedding model (`EMBEDDING_PROVIDER` / `EMBEDDING_MODEL` — the same stack document ingestion uses) and scores their cosine similarity, clamped to 0-1. Its `pass_threshold` is required for the same reason as the judge's. An item without an `expected_output` scores 0; an embedding backend failure marks the **item** errored, never a score of 0.\n\n`tool` runs a custom scoring algorithm: a server-callable project tool the engine invokes once per item with the item's context. Unlike the built-in types it may appear several times, each under a distinct `name` — outcomes and aggregates key on the name.",
-				"required": true,
-				"type": "array",
-				"in": "body"
-			},
-			{
-				"name": "pass_threshold",
-				"description": "0–1. The run passes iff its pass rate — passed items over non-errored items — is at least this. Null reports scores without gating on them.",
+				"name": "description",
+				"description": "What this suite covers",
 				"required": false,
-				"type": "number",
+				"type": "string",
 				"in": "body"
 			}
 		]
 	},
-	"get-eval": {
+	"get-dataset": {
 		serviceClass: "Evaluations",
-		operationId: "getEval",
-		description: "Returns a specific eval",
+		operationId: "getDataset",
+		description: "Returns a specific dataset",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
 		httpMethod: "get",
-		pathParams: ["project_id", "eval_id"],
+		pathParams: ["project_id", "dataset_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -7459,20 +7995,20 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "eval_id",
-			"description": "Eval ID",
+			"name": "dataset_id",
+			"description": "Dataset ID",
 			"required": true,
 			"type": "string",
 			"in": "path"
 		}]
 	},
-	"update-eval": {
+	"update-dataset": {
 		serviceClass: "Evaluations",
-		operationId: "updateEval",
-		description: "Updates an eval. Changing `agent_id` re-validates the scorers against the new agent, since an `output_schema` scorer that was legal against the old one may not be.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
+		operationId: "updateDataset",
+		description: "Updates a dataset's name and/or description",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
 		httpMethod: "put",
-		pathParams: ["project_id", "eval_id"],
+		pathParams: ["project_id", "dataset_id"],
 		queryParams: [],
 		flags: [
 			{
@@ -7483,8 +8019,8 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "eval_id",
-				"description": "Eval ID",
+				"name": "dataset_id",
+				"description": "Dataset ID",
 				"required": true,
 				"type": "string",
 				"in": "path"
@@ -7497,42 +8033,21 @@ const routes = {
 				"in": "body"
 			},
 			{
-				"name": "agent_id",
-				"description": "",
-				"required": false,
-				"type": "string",
-				"in": "body"
-			},
-			{
-				"name": "dataset_id",
+				"name": "description",
 				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
-			},
-			{
-				"name": "scorers",
-				"description": "Scorer configs, a discriminated union on `type`. Each type may appear at most once. Every scorer produces `{ score: 0–1, passed: boolean }`; binary scorers emit 0 or 1.\n\n`exact_match` compares the trimmed output text to `expected_output`. `contains` looks for `value` in the output text. `json_logic` evaluates `expression` over `{ input, output, object, expected, item.metadata }`, where `object` is the structured output (absent when the agent has no `output_schema`). `output_schema` validates the structured output against the scorer's own `schema`, falling back to the agent's; it requires the agent to carry an `output_schema`, because without one the platform emits no structured output and every item would score 0.\n\n`llm_judge` grades the output with a model completion, returning a continuous score plus its `reasoning`. Its `pass_threshold` is required: a continuous score says nothing about where \"good enough\" is, and a defaulted cutoff would silently decide the gate.\n\n`embedding_similarity` embeds the output text and `expected_output` with the platform's configured embedding model (`EMBEDDING_PROVIDER` / `EMBEDDING_MODEL` — the same stack document ingestion uses) and scores their cosine similarity, clamped to 0-1. Its `pass_threshold` is required for the same reason as the judge's. An item without an `expected_output` scores 0; an embedding backend failure marks the **item** errored, never a score of 0.\n\n`tool` runs a custom scoring algorithm: a server-callable project tool the engine invokes once per item with the item's context. Unlike the built-in types it may appear several times, each under a distinct `name` — outcomes and aggregates key on the name.",
-				"required": false,
-				"type": "array",
-				"in": "body"
-			},
-			{
-				"name": "pass_threshold",
-				"description": "",
-				"required": false,
-				"type": "number",
-				"in": "body"
 			}
 		]
 	},
-	"delete-eval": {
+	"delete-dataset": {
 		serviceClass: "Evaluations",
-		operationId: "deleteEval",
-		description: "Deletes an eval, its runs, and their results",
+		operationId: "deleteDataset",
+		description: "Deletes a dataset, its items, and every eval bound to it. Results of runs that already scored those items keep their frozen copies of the input and expected output.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
 		httpMethod: "delete",
-		pathParams: ["project_id", "eval_id"],
+		pathParams: ["project_id", "dataset_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -7541,20 +8056,20 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "eval_id",
-			"description": "Eval ID",
+			"name": "dataset_id",
+			"description": "Dataset ID",
 			"required": true,
 			"type": "string",
 			"in": "path"
 		}]
 	},
-	"list-eval-runs": {
+	"list-dataset-items": {
 		serviceClass: "Evaluations",
-		operationId: "listEvalRuns",
-		description: "Returns an eval's runs, newest first",
+		operationId: "listDatasetItems",
+		description: "Returns the test cases in a dataset, oldest first",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
 		httpMethod: "get",
-		pathParams: ["project_id", "eval_id"],
+		pathParams: ["project_id", "dataset_id"],
 		queryParams: ["limit", "offset"],
 		flags: [
 			{
@@ -7565,8 +8080,8 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "eval_id",
-				"description": "Eval ID",
+				"name": "dataset_id",
+				"description": "Dataset ID",
 				"required": true,
 				"type": "string",
 				"in": "path"
@@ -7587,13 +8102,13 @@ const routes = {
 			}
 		]
 	},
-	"start-eval-run": {
+	"create-dataset-item": {
 		serviceClass: "Evaluations",
-		operationId: "startEvalRun",
-		description: "Runs the eval against its dataset, creating one real agent generation per item and scoring the outputs. `wait: true` executes the run synchronously and returns it terminal, with its scores. The dataset is capped at 25 items for a synchronous run; a larger one is rejected with 400 rather than partially scored. `wait: false` (the default) enqueues one task per item and returns immediately with `status: \"queued\"`. A worker executes the items and the run settles itself; poll `GET /evals/{eval_id}/runs/{eval_run_id}` for the terminal status. There is no item cap on a queued run. The whole run is pinned to **one** agent version, stamped on `agent_version`: pass one explicitly to evaluate a canary before promoting it, or omit it to use the active release's stable version (or the live draft when no release is in effect). Without the pin, release assignment would bucket each item independently and blend two configs into a single score. With `baseline_run_id`, the finished run's `aggregate_scores.baseline` carries per-scorer deltas against that run, computed over the items present and scorable in **both** runs, with the divergence counted. A delta over a shifted dataset is therefore never presented as a clean comparison.",
+		operationId: "createDatasetItem",
+		description: "Adds one test case. `input` is replayed verbatim as the generation's messages, so it must be a non-empty array of `{ role, content }`.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
 		httpMethod: "post",
-		pathParams: ["project_id", "eval_id"],
+		pathParams: ["project_id", "dataset_id"],
 		queryParams: [],
 		flags: [
 			{
@@ -7604,46 +8119,42 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "eval_id",
-				"description": "Eval ID",
+				"name": "dataset_id",
+				"description": "Dataset ID",
 				"required": true,
 				"type": "string",
 				"in": "path"
 			},
 			{
-				"name": "wait",
-				"description": "True runs the eval synchronously (25-item cap) and returns a terminal run with its scores. False — the default — enqueues the items and returns a `queued` run immediately.",
-				"required": false,
-				"type": "boolean",
+				"name": "input",
+				"description": "Messages replayed verbatim as the generation's input",
+				"required": true,
+				"type": "array",
 				"in": "body"
 			},
 			{
-				"name": "agent_version",
-				"description": "An archived agent version to evaluate. Defaults to the active release's stable version, or the live draft version when no release is in effect.",
+				"name": "expected_output",
+				"description": "Reference answer for exact_match / embedding_similarity / llm_judge scorers",
 				"required": false,
-				"type": "integer",
+				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "baseline_run_id",
-				"description": "A terminal run of the same eval to compare against. The finished run's `aggregate_scores.baseline` reports per-scorer deltas over the item intersection. A run of a different eval is rejected with 400.",
+				"name": "metadata",
+				"description": "Free-form tags, opaque to the platform",
 				"required": false,
-				"type": "string",
+				"type": "object",
 				"in": "body"
 			}
 		]
 	},
-	"get-eval-run": {
+	"create-dataset-item-from-generation": {
 		serviceClass: "Evaluations",
-		operationId: "getEvalRun",
-		description: "Returns a run's status, counts, and aggregate scores",
+		operationId: "createDatasetItemFromGeneration",
+		description: "Promotes a real, completed generation into a test case: its input messages become the item's `input`, and its own answer becomes `expected_output` unless you supply one. Use it to build an evaluation set out of production traffic rather than hand-authoring fixtures. The item is a **copy**, not a view. It keeps working after the source generation's content is purged, and `source_generation_id` goes null if that generation is deleted — a purge can never quietly stop a suite from being runnable. Requires both `evaluations:CreateDataset` and `generations:GetGeneration`: the call copies content out of a generation, so a principal that may not read that generation may not curate it either. Only a **completed** generation can be promoted (`409 GENERATION_NOT_COMPLETED`), and only while its content is still available: an agent or project running with `trace_content_mode: none` never stored the input, and a purged or expired generation no longer has it (`409 GENERATION_CONTENT_UNAVAILABLE`). Generations that predate input recording answer the same way.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
-		httpMethod: "get",
-		pathParams: [
-			"project_id",
-			"eval_id",
-			"eval_run_id"
-		],
+		httpMethod: "post",
+		pathParams: ["project_id", "dataset_id"],
 		queryParams: [],
 		flags: [
 			{
@@ -7654,33 +8165,47 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "eval_id",
-				"description": "Eval ID",
+				"name": "dataset_id",
+				"description": "Dataset ID",
 				"required": true,
 				"type": "string",
 				"in": "path"
 			},
 			{
-				"name": "eval_run_id",
-				"description": "Eval run ID",
+				"name": "generation_id",
+				"description": "The completed generation to promote. Must belong to the same project as the dataset.",
 				"required": true,
 				"type": "string",
-				"in": "path"
+				"in": "body"
+			},
+			{
+				"name": "expected_output",
+				"description": "Reference answer. Omit to use the generation's own answer; pass `null` to store the item with no reference answer.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "metadata",
+				"description": "Free-form tags, opaque to the platform",
+				"required": false,
+				"type": "object",
+				"in": "body"
 			}
 		]
 	},
-	"list-eval-results": {
+	"update-dataset-item": {
 		serviceClass: "Evaluations",
-		operationId: "listEvalResults",
-		description: "Returns the per-item results of a run, oldest first",
+		operationId: "updateDatasetItem",
+		description: "Updates a test case. Runs that already scored it are unaffected — each result carries its own frozen copy of the input and expected output.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
-		httpMethod: "get",
+		httpMethod: "put",
 		pathParams: [
 			"project_id",
-			"eval_id",
-			"eval_run_id"
+			"dataset_id",
+			"item_id"
 		],
-		queryParams: ["limit", "offset"],
+		queryParams: [],
 		flags: [
 			{
 				"name": "project_id",
@@ -7690,45 +8215,52 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "eval_id",
-				"description": "Eval ID",
+				"name": "dataset_id",
+				"description": "Dataset ID",
 				"required": true,
 				"type": "string",
 				"in": "path"
 			},
 			{
-				"name": "eval_run_id",
-				"description": "Eval run ID",
+				"name": "item_id",
+				"description": "Dataset item ID",
 				"required": true,
 				"type": "string",
 				"in": "path"
 			},
 			{
-				"name": "limit",
-				"description": "Maximum number of results to return",
+				"name": "input",
+				"description": "Messages replayed verbatim as the generation's input",
 				"required": false,
-				"type": "integer",
-				"in": "query"
+				"type": "array",
+				"in": "body"
 			},
 			{
-				"name": "offset",
-				"description": "Number of results to skip",
+				"name": "expected_output",
+				"description": "",
 				"required": false,
-				"type": "integer",
-				"in": "query"
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "metadata",
+				"description": "",
+				"required": false,
+				"type": "object",
+				"in": "body"
 			}
 		]
 	},
-	"cancel-eval-run": {
+	"delete-dataset-item": {
 		serviceClass: "Evaluations",
-		operationId: "cancelEvalRun",
-		description: "Cancels a queued or running run: its outstanding item tasks are dropped so it stops consuming provider budget, and the run settles as `canceled`. Results already written are kept — they are real measurements of generations that were really paid for — and `completed_count` / `errored_count` report what ran. `aggregate_scores` is deliberately left null: a partial roll-up in the same field a completed run uses would read as a whole-dataset verdict. A run that has already finished is rejected with 400.",
+		operationId: "deleteDatasetItem",
+		description: "Deletes a test case. Results of runs that already scored it stay readable; their `dataset_item_id` becomes null.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
-		httpMethod: "post",
+		httpMethod: "delete",
 		pathParams: [
 			"project_id",
-			"eval_id",
-			"eval_run_id"
+			"dataset_id",
+			"item_id"
 		],
 		queryParams: [],
 		flags: [
@@ -7740,36 +8272,29 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "eval_id",
-				"description": "Eval ID",
+				"name": "dataset_id",
+				"description": "Dataset ID",
 				"required": true,
 				"type": "string",
 				"in": "path"
 			},
 			{
-				"name": "eval_run_id",
-				"description": "Eval run ID",
+				"name": "item_id",
+				"description": "Dataset item ID",
 				"required": true,
 				"type": "string",
 				"in": "path"
 			}
 		]
 	},
-	"list-generations": {
-		serviceClass: "Generations",
-		operationId: "listGenerations",
-		description: "Returns generations the caller can access, optionally filtered by agent, trace, and status. Replaces the former per-trace generations endpoint (use the trace_id query filter).",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/generations",
+	"list-evals": {
+		serviceClass: "Evaluations",
+		operationId: "listEvals",
+		description: "Returns the evals defined in a project",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
 		httpMethod: "get",
 		pathParams: ["project_id"],
-		queryParams: [
-			"agent_id",
-			"trace_id",
-			"initiator_generation_id",
-			"status",
-			"limit",
-			"offset"
-		],
+		queryParams: ["limit", "offset"],
 		flags: [
 			{
 				"name": "project_id",
@@ -7778,57 +8303,890 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
-			{
-				"name": "agent_id",
-				"description": "Filter by agent public ID",
-				"required": false,
-				"type": "string",
-				"in": "query"
-			},
-			{
-				"name": "trace_id",
-				"description": "Filter by trace public ID",
-				"required": false,
-				"type": "string",
-				"in": "query"
-			},
-			{
-				"name": "initiator_generation_id",
-				"description": "Filter by the public ID of the parent generation. Returns all generations triggered by that generation — sub-agent invocations. Null-initiated (top-level) generations are not returned.\n",
-				"required": false,
-				"type": "string",
-				"in": "query"
-			},
-			{
-				"name": "status",
-				"description": "Filter by lifecycle status",
-				"required": false,
-				"type": "string",
-				"in": "query"
-			},
 			{
 				"name": "limit",
-				"description": "",
+				"description": "Maximum number of results to return",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "",
+				"description": "Number of results to skip",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			}
 		]
 	},
-	"get-generation": {
-		serviceClass: "Generations",
-		operationId: "getGeneration",
-		description: "Returns a single generation record by ID, including its status and the structured `error` payload when the generation failed (e.g. because the upstream AI provider returned an error).",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/generations",
-		httpMethod: "get",
-		pathParams: ["project_id", "generation_id"],
+	"create-eval": {
+		serviceClass: "Evaluations",
+		operationId: "createEval",
+		description: "Binds an agent under test to a dataset and a list of scorers. The agent and the dataset must belong to the same project as the eval; a cross-project reference is rejected with 400. Scorer config is frozen here rather than read from the agent at run time, so two runs of the same eval are always judged by the same criteria and their comparison measures the agent instead of the config drifting underneath it. Each scorer `type` may appear at most once.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
+		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": "Unique name within the project",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "agent_id",
+				"description": "The agent under test",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "dataset_id",
+				"description": "The dataset to run it against",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "scorers",
+				"description": "Scorer configs, a discriminated union on `type`. Each type may appear at most once. Every scorer produces `{ score: 0–1, passed: boolean }`; binary scorers emit 0 or 1.\n\n`exact_match` compares the trimmed output text to `expected_output`. `contains` looks for `value` in the output text. `json_logic` evaluates `expression` over `{ input, output, object, expected, item.metadata }`, where `object` is the structured output (absent when the agent has no `output_schema`). `output_schema` validates the structured output against the scorer's own `schema`, falling back to the agent's; it requires the agent to carry an `output_schema`, because without one the platform emits no structured output and every item would score 0.\n\n`llm_judge` grades the output with a model completion, returning a continuous score plus its `reasoning`. Its `pass_threshold` is required: a continuous score says nothing about where \"good enough\" is, and a defaulted cutoff would silently decide the gate.\n\n`embedding_similarity` embeds the output text and `expected_output` with the platform's configured embedding model (`EMBEDDING_PROVIDER` / `EMBEDDING_MODEL` — the same stack document ingestion uses) and scores their cosine similarity, clamped to 0-1. Its `pass_threshold` is required for the same reason as the judge's. An item without an `expected_output` scores 0; an embedding backend failure marks the **item** errored, never a score of 0.\n\n`tool` runs a custom scoring algorithm: a server-callable project tool the engine invokes once per item with the item's context. Unlike the built-in types it may appear several times, each under a distinct `name` — outcomes and aggregates key on the name.",
+				"required": true,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "pass_threshold",
+				"description": "0–1. The run passes iff its pass rate — passed items over non-errored items — is at least this. Null reports scores without gating on them.",
+				"required": false,
+				"type": "number",
+				"in": "body"
+			}
+		]
+	},
+	"get-eval": {
+		serviceClass: "Evaluations",
+		operationId: "getEval",
+		description: "Returns a specific eval",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
+		httpMethod: "get",
+		pathParams: ["project_id", "eval_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "eval_id",
+			"description": "Eval ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-eval": {
+		serviceClass: "Evaluations",
+		operationId: "updateEval",
+		description: "Updates an eval. Changing `agent_id` re-validates the scorers against the new agent, since an `output_schema` scorer that was legal against the old one may not be.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
+		httpMethod: "put",
+		pathParams: ["project_id", "eval_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "eval_id",
+				"description": "Eval ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "name",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "agent_id",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "dataset_id",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "scorers",
+				"description": "Scorer configs, a discriminated union on `type`. Each type may appear at most once. Every scorer produces `{ score: 0–1, passed: boolean }`; binary scorers emit 0 or 1.\n\n`exact_match` compares the trimmed output text to `expected_output`. `contains` looks for `value` in the output text. `json_logic` evaluates `expression` over `{ input, output, object, expected, item.metadata }`, where `object` is the structured output (absent when the agent has no `output_schema`). `output_schema` validates the structured output against the scorer's own `schema`, falling back to the agent's; it requires the agent to carry an `output_schema`, because without one the platform emits no structured output and every item would score 0.\n\n`llm_judge` grades the output with a model completion, returning a continuous score plus its `reasoning`. Its `pass_threshold` is required: a continuous score says nothing about where \"good enough\" is, and a defaulted cutoff would silently decide the gate.\n\n`embedding_similarity` embeds the output text and `expected_output` with the platform's configured embedding model (`EMBEDDING_PROVIDER` / `EMBEDDING_MODEL` — the same stack document ingestion uses) and scores their cosine similarity, clamped to 0-1. Its `pass_threshold` is required for the same reason as the judge's. An item without an `expected_output` scores 0; an embedding backend failure marks the **item** errored, never a score of 0.\n\n`tool` runs a custom scoring algorithm: a server-callable project tool the engine invokes once per item with the item's context. Unlike the built-in types it may appear several times, each under a distinct `name` — outcomes and aggregates key on the name.",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "pass_threshold",
+				"description": "",
+				"required": false,
+				"type": "number",
+				"in": "body"
+			}
+		]
+	},
+	"delete-eval": {
+		serviceClass: "Evaluations",
+		operationId: "deleteEval",
+		description: "Deletes an eval, its runs, and their results",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
+		httpMethod: "delete",
+		pathParams: ["project_id", "eval_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "eval_id",
+			"description": "Eval ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"list-eval-runs": {
+		serviceClass: "Evaluations",
+		operationId: "listEvalRuns",
+		description: "Returns an eval's runs, newest first",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
+		httpMethod: "get",
+		pathParams: ["project_id", "eval_id"],
+		queryParams: ["limit", "offset"],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "eval_id",
+				"description": "Eval ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"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"
+			}
+		]
+	},
+	"start-eval-run": {
+		serviceClass: "Evaluations",
+		operationId: "startEvalRun",
+		description: "Runs the eval against its dataset, creating one real agent generation per item and scoring the outputs. `wait: true` executes the run synchronously and returns it terminal, with its scores. The dataset is capped at 25 items for a synchronous run; a larger one is rejected with 400 rather than partially scored. `wait: false` (the default) enqueues one task per item and returns immediately with `status: \"queued\"`. A worker executes the items and the run settles itself; poll `GET /evals/{eval_id}/runs/{eval_run_id}` for the terminal status. There is no item cap on a queued run. The whole run is pinned to **one** agent version, stamped on `agent_version`: pass one explicitly to evaluate a canary before promoting it, or omit it to use the active release's stable version (or the live draft when no release is in effect). Without the pin, release assignment would bucket each item independently and blend two configs into a single score. With `baseline_run_id`, the finished run's `aggregate_scores.baseline` carries per-scorer deltas against that run, computed over the items present and scorable in **both** runs, with the divergence counted. A delta over a shifted dataset is therefore never presented as a clean comparison.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
+		httpMethod: "post",
+		pathParams: ["project_id", "eval_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "eval_id",
+				"description": "Eval ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "wait",
+				"description": "True runs the eval synchronously (25-item cap) and returns a terminal run with its scores. False — the default — enqueues the items and returns a `queued` run immediately.",
+				"required": false,
+				"type": "boolean",
+				"in": "body"
+			},
+			{
+				"name": "agent_version",
+				"description": "An archived agent version to evaluate. Defaults to the active release's stable version, or the live draft version when no release is in effect.",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "baseline_run_id",
+				"description": "A terminal run of the same eval to compare against. The finished run's `aggregate_scores.baseline` reports per-scorer deltas over the item intersection. A run of a different eval is rejected with 400.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"get-eval-run": {
+		serviceClass: "Evaluations",
+		operationId: "getEvalRun",
+		description: "Returns a run's status, counts, and aggregate scores",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
+		httpMethod: "get",
+		pathParams: [
+			"project_id",
+			"eval_id",
+			"eval_run_id"
+		],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "eval_id",
+				"description": "Eval ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "eval_run_id",
+				"description": "Eval run ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			}
+		]
+	},
+	"list-eval-results": {
+		serviceClass: "Evaluations",
+		operationId: "listEvalResults",
+		description: "Returns the per-item results of a run, oldest first",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
+		httpMethod: "get",
+		pathParams: [
+			"project_id",
+			"eval_id",
+			"eval_run_id"
+		],
+		queryParams: ["limit", "offset"],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "eval_id",
+				"description": "Eval ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "eval_run_id",
+				"description": "Eval run ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"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"
+			}
+		]
+	},
+	"cancel-eval-run": {
+		serviceClass: "Evaluations",
+		operationId: "cancelEvalRun",
+		description: "Cancels a queued or running run: its outstanding item tasks are dropped so it stops consuming provider budget, and the run settles as `canceled`. Results already written are kept — they are real measurements of generations that were really paid for — and `completed_count` / `errored_count` report what ran. `aggregate_scores` is deliberately left null: a partial roll-up in the same field a completed run uses would read as a whole-dataset verdict. A run that has already finished is rejected with 400.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/evaluations",
+		httpMethod: "post",
+		pathParams: [
+			"project_id",
+			"eval_id",
+			"eval_run_id"
+		],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "eval_id",
+				"description": "Eval ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "eval_run_id",
+				"description": "Eval run ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			}
+		]
+	},
+	"list-files": {
+		serviceClass: "Files",
+		operationId: "listFiles",
+		description: "Returns a list of all stored files",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/files",
+		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": "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-file": {
+		serviceClass: "Files",
+		operationId: "createFile",
+		description: "Creates a new file record in the system",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/files",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "prefix",
+				"description": "Directory within the project (e.g. /images). Optional; defaults to / (root). Combined with filename to form the file's key (path).",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "filename",
+				"description": "Original / download name and the key's leaf segment (e.g. logo.png).",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "content_type",
+				"description": "MIME type of the file",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "size",
+				"description": "File size in bytes",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "metadata",
+				"description": "JSON string with additional metadata",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"upload-file": {
+		serviceClass: "Files",
+		operationId: "uploadFile",
+		description: "Uploads a file to the server and stores it in the configured storage directory",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/files",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"upload-file-base64": {
+		serviceClass: "Files",
+		operationId: "uploadFileBase64",
+		description: "Uploads a file to the server using base64-encoded content",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/files",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "content",
+				"description": "Base64-encoded file content",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "prefix",
+				"description": "Directory within the project (e.g. /documents). Optional; defaults to / (root).",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "filename",
+				"description": "Original / download name and the key's leaf segment.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "content_type",
+				"description": "MIME type of the file",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "metadata",
+				"description": "JSON string with additional metadata",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"get-file": {
+		serviceClass: "Files",
+		operationId: "getFile",
+		description: "Returns the data and metadata of a specific file",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/files",
+		httpMethod: "get",
+		pathParams: ["project_id", "file_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "file_id",
+			"description": "File ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"delete-file": {
+		serviceClass: "Files",
+		operationId: "deleteFile",
+		description: "Removes a file from the system by ID",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/files",
+		httpMethod: "delete",
+		pathParams: ["project_id", "file_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "file_id",
+			"description": "ID of the file to delete",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"download-file": {
+		serviceClass: "Files",
+		operationId: "downloadFile",
+		description: "Streams the file content to the client",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/files",
+		httpMethod: "get",
+		pathParams: ["project_id", "file_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "file_id",
+			"description": "File ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-file-metadata": {
+		serviceClass: "Files",
+		operationId: "updateFileMetadata",
+		description: "Updates the metadata field of a file",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/files",
+		httpMethod: "patch",
+		pathParams: ["project_id", "file_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "file_id",
+				"description": "File ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "metadata",
+				"description": "New metadata as a JSON string",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "prefix",
+				"description": "New directory — moves the file. The resulting path (prefix + filename) must be unique within the project.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "filename",
+				"description": "New filename — renames the key's leaf and the download name.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"download-file-base64": {
+		serviceClass: "Files",
+		operationId: "downloadFileBase64",
+		description: "Returns the file content encoded as base64",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/files",
+		httpMethod: "get",
+		pathParams: ["project_id", "file_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "file_id",
+			"description": "File ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"get-file-tags": {
+		serviceClass: "Files",
+		operationId: "getFileTags",
+		description: "Returns all tags attached to the file",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/files",
+		httpMethod: "get",
+		pathParams: ["project_id", "file_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "file_id",
+			"description": "File ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"replace-file-tags": {
+		serviceClass: "Files",
+		operationId: "replaceFileTags",
+		description: "Replaces all tags on the file with the provided tags",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/files",
+		httpMethod: "put",
+		pathParams: ["project_id", "file_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "file_id",
+			"description": "File ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"merge-file-tags": {
+		serviceClass: "Files",
+		operationId: "mergeFileTags",
+		description: "Merges provided tags with existing tags",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/files",
+		httpMethod: "patch",
+		pathParams: ["project_id", "file_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "file_id",
+			"description": "File ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"list-generations": {
+		serviceClass: "Generations",
+		operationId: "listGenerations",
+		description: "Returns generations the caller can access, optionally filtered by agent, trace, and status. Replaces the former per-trace generations endpoint (use the trace_id query filter).",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/generations",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: [
+			"agent_id",
+			"trace_id",
+			"initiator_generation_id",
+			"status",
+			"limit",
+			"offset"
+		],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "agent_id",
+				"description": "Filter by agent public ID",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "trace_id",
+				"description": "Filter by trace public ID",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "initiator_generation_id",
+				"description": "Filter by the public ID of the parent generation. Returns all generations triggered by that generation — sub-agent invocations. Null-initiated (top-level) generations are not returned.\n",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "status",
+				"description": "Filter by lifecycle status",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"get-generation": {
+		serviceClass: "Generations",
+		operationId: "getGeneration",
+		description: "Returns a single generation record by ID, including its status and the structured `error` payload when the generation failed (e.g. because the upstream AI provider returned an error).",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/generations",
+		httpMethod: "get",
+		pathParams: ["project_id", "generation_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "generation_id",
+			"description": "Public ID of the generation",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-generation": {
+		serviceClass: "Generations",
+		operationId: "updateGeneration",
+		description: "Attaches caller-supplied key/value metadata to a generation record for per-run audit attribution (e.g. recording which knowledge-corpus version produced an AI action). The provided keys are shallow-merged over the existing `metadata`, so repeated patches accumulate. The bag is caller-owned and no key is reserved: server-owned state (usage attribution, the served agent version, the route's record, the extraction summary) lives in its own top-level fields and cannot be written from here.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/generations",
+		httpMethod: "patch",
+		pathParams: ["project_id", "generation_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "generation_id",
+				"description": "Public ID of the generation",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "metadata",
+				"description": "Caller-supplied key/value metadata to shallow-merge into the generation record's caller-owned `metadata` bag. No key is reserved: server-owned state lives in its own top-level fields and cannot be written from here.\n",
+				"required": true,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"purge-generation-content": {
+		serviceClass: "Generations",
+		operationId: "purgeGenerationContent",
+		description: "Clears the generation's content — `metadata`, `error`, `extraction`, and the internal recovery state of a paused run — and stamps `content_redacted_at`. The usage and audit skeleton is preserved: ids, timestamps, status, stop reason, and the attribution fields (`action_id`, `trigger_id`, `orchestration_run_id`, `node_id`, `agent_version`, `routing`) the billing ledger reads. A purged generation reads back as that skeleton, not a 404. This does **not** delete the parent trace's steps object, which holds this generation's content alongside its siblings'. To erase the run's content completely, purge the trace (`DELETE /v1/projects/{project_id}/traces/{trace_id}/content`), which cascades here. Idempotent — purging an already-purged generation succeeds and leaves the original `content_redacted_at` in place.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/generations",
+		httpMethod: "delete",
+		pathParams: ["project_id", "generation_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "generation_id",
+			"description": "Public ID of the generation",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"get-generation-transcript": {
+		serviceClass: "Generations",
+		operationId: "getGenerationTranscript",
+		description: "Returns one generation's turn read back as an ordered sequence of steps: what it was asked, each model step with its tool calls and results, and how it ended. The transcript is assembled at read time from the generation record and the trace's steps object; nothing is stored, so it cannot outlive the content it projects. Requires `traces:GetTrace` in addition to `generations:GetGeneration`, because the response merges content from both resources. A generation whose content is unavailable — never written under zero-retention, or cleared by a purge — returns `200` with the skeleton rather than an error: `input` and `output` are null, `steps` is empty, and the `content_redacted_*` fields say which happened. `content_redacted_by_principal_id` is `zero_retention` when the content was never stored, and the purging principal's ID when it was erased later. A generation that is still running returns the same shape with an empty `steps`; `status` disambiguates the two.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/generations",
+		httpMethod: "get",
+		pathParams: ["project_id", "generation_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -7844,14 +9202,14 @@ const routes = {
 			"in": "path"
 		}]
 	},
-	"update-generation": {
-		serviceClass: "Generations",
-		operationId: "updateGeneration",
-		description: "Attaches caller-supplied key/value metadata to a generation record for per-run audit attribution (e.g. recording which knowledge-corpus version produced an AI action). The provided keys are shallow-merged over the existing `metadata`, so repeated patches accumulate. The bag is caller-owned and no key is reserved: server-owned state (usage attribution, the served agent version, the route's record, the extraction summary) lives in its own top-level fields and cannot be written from here.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/generations",
-		httpMethod: "patch",
-		pathParams: ["project_id", "generation_id"],
-		queryParams: [],
+	"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",
@@ -7861,28 +9219,123 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "generation_id",
-				"description": "Public ID of the generation",
+				"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": "metadata",
-				"description": "Caller-supplied key/value metadata to shallow-merge into the generation record's caller-owned `metadata` bag. No key is reserved: server-owned state lives in its own top-level fields and cannot be written from here.\n",
+				"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"
 			}
 		]
 	},
-	"purge-generation-content": {
-		serviceClass: "Generations",
-		operationId: "purgeGenerationContent",
-		description: "Clears the generation's content — `metadata`, `error`, `extraction`, and the internal recovery state of a paused run — and stamps `content_redacted_at`. The usage and audit skeleton is preserved: ids, timestamps, status, stop reason, and the attribution fields (`action_id`, `trigger_id`, `orchestration_run_id`, `node_id`, `agent_version`, `routing`) the billing ledger reads. A purged generation reads back as that skeleton, not a 404. This does **not** delete the parent trace's steps object, which holds this generation's content alongside its siblings'. To erase the run's content completely, purge the trace (`DELETE /v1/projects/{project_id}/traces/{trace_id}/content`), which cascades here. Idempotent — purging an already-purged generation succeeds and leaves the original `content_redacted_at` in place.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/generations",
-		httpMethod: "delete",
-		pathParams: ["project_id", "generation_id"],
+	"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",
@@ -7891,20 +9344,122 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "generation_id",
-			"description": "Public ID of the generation",
+			"name": "ingestion_rule_id",
+			"description": "Ingestion rule ID",
 			"required": true,
 			"type": "string",
 			"in": "path"
 		}]
 	},
-	"get-generation-transcript": {
-		serviceClass: "Generations",
-		operationId: "getGenerationTranscript",
-		description: "Returns one generation's turn read back as an ordered sequence of steps: what it was asked, each model step with its tool calls and results, and how it ended. The transcript is assembled at read time from the generation record and the trace's steps object; nothing is stored, so it cannot outlive the content it projects. Requires `traces:GetTrace` in addition to `generations:GetGeneration`, because the response merges content from both resources. A generation whose content is unavailable — never written under zero-retention, or cleared by a purge — returns `200` with the skeleton rather than an error: `input` and `output` are null, `steps` is empty, and the `content_redacted_*` fields say which happened. `content_redacted_by_principal_id` is `zero_retention` when the content was never stored, and the purging principal's ID when it was erased later. A generation that is still running returns the same shape with an empty `steps`; `status` disambiguates the two.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/generations",
-		httpMethod: "get",
-		pathParams: ["project_id", "generation_id"],
+	"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",
@@ -7913,13 +9468,80 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "generation_id",
-			"description": "Public ID of the generation",
+			"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-model-routes": {
 		serviceClass: "ModelRoutes",
 		operationId: "listModelRoutes",