@naturali/sdk 0.71.1 → 0.72.0

package/dist/index.mjs

@@ -1,4 +1,18 @@
 //#region 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 src/generated/core/serverSentEvents.gen.ts
@@ -1251,7 +1265,8 @@ var AiProviders = class {
 	* Which models are reachable is a property of the credential, not of the provider type: a Vertex provider sees only the publisher models its Google Cloud project and location serve, and a Bedrock provider only the foundation models enabled in its region. Reading the list is how a caller avoids pinning a model that fails at generation time.
 	* Not every provider type can answer. `azure` lists deployments an operator named rather than models, and `ollama` lists whatever was pulled onto that host, so both return `400 MODEL_LISTING_UNSUPPORTED`.
 	* Listing resolves credentials the same way generation does, so a record that can generate can list. The API-key types (`openai`, `groq`, `xai`, `gateway`, `custom`, `anthropic`, `google`) use the record's linked secret and cannot list without one. `bedrock` and `vertex` use the linked secret when there is one — IAM keys or a Bedrock API key, a Google service-account key — and otherwise fall back to the server environment (the AWS default credential chain, Google Application Default Credentials), so a record with no `secret_id` can still list.
-	* A Vertex record needs no `config.project` when its secret is a service-account key, since the key file names its own project. A Vertex record in express mode (API key) cannot list at all: express mode is a global, project-less endpoint and the publisher-model catalogue is per-project, so it returns `400 MODEL_LISTING_UNSUPPORTED`.
+	* A Vertex record needs no `config.project` when its secret is a service-account key, since the key file names its own project. A Vertex record in express mode (API key) cannot list at all: the publisher-model listing rejects API keys and needs a credential that asserts a principal, so it returns `400 MODEL_LISTING_UNSUPPORTED`.
+	* The Vertex answer is the publisher catalogue the record's `config.location` region serves. The project behind the credential is billed and quota'd for the call but does not filter the result, so a listed model may still be unavailable to that project at generation time.
 	*
 	*/
 	static listAiProviderModels(options) {
@@ -1658,6 +1673,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
@@ -1934,6 +2139,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
@@ -2010,6 +2374,88 @@ var Generations = class {
 		});
 	}
 };
+var IngestionRules = class {
+	/**
+	* List ingestion rules
+	*
+	* Returns the ingestion rules for a project
+	*/
+	static listIngestionRules(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/ingestion-rules",
+			...options
+		});
+	}
+	/**
+	* Create an ingestion rule
+	*
+	* Creates a rule mapping a content_type glob to a converter. Exactly one of tool_id or agent_id must be set.
+	*/
+	static createIngestionRule(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/ingestion-rules",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete an ingestion rule
+	*
+	* Deletes an ingestion rule
+	*/
+	static deleteIngestionRule(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/ingestion-rules/{ingestion_rule_id}",
+			...options
+		});
+	}
+	/**
+	* Get an ingestion rule
+	*
+	* Returns a specific ingestion rule
+	*/
+	static getIngestionRule(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/ingestion-rules/{ingestion_rule_id}",
+			...options
+		});
+	}
+	/**
+	* Update an ingestion rule
+	*
+	* Updates fields of an ingestion rule
+	*/
+	static updateIngestionRule(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/ingestion-rules/{ingestion_rule_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
+var Knowledge = class {
+	/**
+	* 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
@@ -3342,8 +3788,13 @@ var NaturaliClient = class {
 	channels;
 	auth;
 	conversations;
+	documents;
+	embeddings;
 	evaluations;
+	files;
 	generations;
+	ingestionRules;
+	knowledge;
 	modelRoutes;
 	models;
 	orchestrations;
@@ -3376,8 +3827,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);
@@ -3394,4 +3850,4 @@ var NaturaliClient = class {
 	}
 };
 //#endregion
-export { Actors, AgentVersions, Agents, AiProviders, ApiKeys, Assistant, Auth, Channels, Conversations, Evaluations, Generations, ModelRoutes, Models, NaturaliClient, Orchestrations, Projects, Secrets, Sessions, Tasks, Tools, Traces, Triggers, Users, Webhooks, Workflows, createClient, createConfig };
+export { Actors, AgentVersions, Agents, AiProviders, ApiKeys, Assistant, Auth, Channels, Conversations, Documents, Embeddings, Evaluations, Files, Generations, IngestionRules, Knowledge, ModelRoutes, Models, NaturaliClient, Orchestrations, Projects, Secrets, Sessions, Tasks, Tools, Traces, Triggers, Users, Webhooks, Workflows, createClient, createConfig };

package/package.json

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