@naturali/sdk 0.40.1 → 0.42.0

package/dist/index.cjs

@@ -1344,7 +1344,11 @@ var Knowledge = class {
 	/**
 	* Create a document
 	*
-	* Add an inline-text document to the collection. The platform ingests the content (chunk + embed) and records the document's ingestion status. File upload (PDF/binary) is a deliberate follow-up.
+	* Add a document to the collection, from **inline text** (`content`) or from an **uploaded file** (`file`, base64, plus `content_type` and `filename`) — exactly one of the two.
+	*
+	* `application/pdf`, `text/plain` and `text/markdown` are extracted natively. Any other media type needs a converter (`POST /v1/projects/{project_id}/knowledge/converters`) registered for it in the project; without one the request is rejected with `unsupported_content_type` and no document is created.
+	*
+	* Ingestion (extract → chunk → embed) runs in the background: the document comes back `pending` and becomes `indexed` or `failed`, which is announced by the `knowledge.document_ingested` / `knowledge.ingest_failed` webhook events.
 	*
 	*/
 	static createKnowledgeDocument(options) {
@@ -1389,6 +1393,86 @@ var Knowledge = class {
 			...options
 		});
 	}
+	/**
+	* List converters
+	*
+	* Lists the media converters registered in the project.
+	*/
+	static listKnowledgeConverters(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/knowledge/converters",
+			...options
+		});
+	}
+	/**
+	* Create a converter
+	*
+	* Register a converter for a media type the platform cannot extract natively, so files of that type become ingestable documents like any other. A converter maps a `content_type` glob (`image*`, `audio/mpeg`, …) onto one of two workers:
+	*
+	* - an **agent** (`agent_id`) — the file is handed to a
+	* multimodal model with a fixed "extract all the text" instruction and
+	* its answer becomes the document text. The shortest path for images
+	* and scanned PDFs; nothing to map.
+	*
+	* - a **tool** (`tool_id`) — the file is passed to an
+	* `http` tool as `{ content_type, filename, data_base64 }`, and
+	* whatever string the tool returns becomes the document text. The path
+	* for dedicated non-chat APIs (speech-to-text, a specialist OCR
+	* engine); use the tool's `execute.body_mode: multipart` for
+	* form-data endpoints and its `output_mapping` to reduce a JSON
+	* response to the bare string.
+	*
+	*
+	* Exactly one of `agent_id` / `tool_id`, and one converter per `content_type` in a project.
+	*
+	*/
+	static createKnowledgeConverter(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/knowledge/converters",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a converter
+	*
+	* Removes the converter. Documents already ingested through it are untouched; new files of that media type stop being ingestable until another converter covers them.
+	*
+	*/
+	static deleteKnowledgeConverter(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/knowledge/converters/{converter_id}",
+			...options
+		});
+	}
+	/**
+	* Get a converter
+	*/
+	static getKnowledgeConverter(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/knowledge/converters/{converter_id}",
+			...options
+		});
+	}
+	/**
+	* Update a converter
+	*
+	* Change the worker or the chunking defaults. At least one field is required; `agent_id` and `tool_id` stay mutually exclusive, so setting one clears the other.
+	*
+	*/
+	static updateKnowledgeConverter(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/knowledge/converters/{converter_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
 };
 var Models = class {
 	/**
@@ -1833,6 +1917,126 @@ var Traces = class {
 		});
 	}
 };
+var Webhooks = class {
+	/**
+	* List webhooks
+	*
+	* The endpoints registered in the project, newest first.
+	*/
+	static listWebhooks(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/webhooks",
+			...options
+		});
+	}
+	/**
+	* Create a webhook
+	*
+	* Register an endpoint and subscribe it to one or more event types.
+	* The response carries `secret` — the signing key, in plaintext. **This is the only time it is returned.** Store it where your receiver can read it; if you lose it, rotate rather than re-create, so the endpoint keeps its delivery history.
+	* Returns `501` on a deployment with no credential-sealing key configured, since the secret could not then be stored safely.
+	*
+	*/
+	static createWebhook(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/webhooks",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a webhook
+	*
+	* Removes the endpoint and its delivery records. To stop deliveries while keeping the audit trail, `PATCH` it to `active: false` instead.
+	*
+	*/
+	static deleteWebhook(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/webhooks/{webhook_id}",
+			...options
+		});
+	}
+	/**
+	* Get a webhook
+	*/
+	static getWebhook(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/webhooks/{webhook_id}",
+			...options
+		});
+	}
+	/**
+	* Update a webhook
+	*
+	* Change the destination, the subscription, the label, or whether deliveries are attempted at all. At least one field is required.
+	* Setting `active: false` is the reversible half of `DELETE`: deliveries stop, the endpoint and its history stay. It is what to reach for while a receiver is being repaired.
+	*
+	*/
+	static updateWebhook(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/webhooks/{webhook_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Rotate the signing secret
+	*
+	* Issues a new signing secret for the same endpoint and returns it — the second and last time a secret is ever returned. This is the `…:rotate-secret` action; the path segment is `{webhook_id}:rotate-secret`.
+	* The change takes effect on the next delivery, including retries of deliveries already queued, so roll the new secret out to your receiver promptly. There is no overlap window in which both secrets verify.
+	*
+	*/
+	static rotateWebhookSecret(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/webhooks/{webhook_id}:rotate-secret",
+			...options
+		});
+	}
+	/**
+	* List webhook deliveries
+	*
+	* Every delivery attempted in the project, newest first — what was sent, where, how many times, and what came back. Filter by endpoint, by lifecycle status, or by event type.
+	* Deliveries are per (event, endpoint): an event matching two subscribed endpoints produces two rows, retried and observed independently.
+	*
+	*/
+	static listWebhookDeliveries(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/webhook-deliveries",
+			...options
+		});
+	}
+	/**
+	* Get a webhook delivery
+	*
+	* One delivery, including the exact payload that was signed and sent.
+	*
+	*/
+	static getWebhookDelivery(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/webhook-deliveries/{delivery_id}",
+			...options
+		});
+	}
+	/**
+	* Redeliver an event
+	*
+	* Queue the same event at the same endpoint again — the recovery path for a delivery that failed, or one your receiver dropped. This is the `…:redeliver` action; the path segment is `{delivery_id}:redeliver`.
+	* A **new** delivery is created and returned; the original record is left untouched, because its attempt history is the evidence you redelivered on. The event's `id` is carried over unchanged, so a receiver deduping on the event sees the same event twice while one deduping on `X-Naturali-Delivery` sees a distinct delivery.
+	*
+	*/
+	static redeliverWebhookDelivery(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/webhook-deliveries/{delivery_id}:redeliver",
+			...options
+		});
+	}
+};
 //#endregion
 //#region src/naturaliClient.ts
 /**
@@ -1895,6 +2099,7 @@ var NaturaliClient = class {
 	tasks;
 	tools;
 	traces;
+	webhooks;
 	/** The underlying HTTP client, for interceptors or one-off requests. */
 	http;
 	constructor({ token, headers } = {}) {
@@ -1920,6 +2125,7 @@ var NaturaliClient = class {
 		this.tasks = bindResource(Tasks, this.http);
 		this.tools = bindResource(Tools, this.http);
 		this.traces = bindResource(Traces, this.http);
+		this.webhooks = bindResource(Webhooks, this.http);
 	}
 };
 //#endregion
@@ -1939,5 +2145,6 @@ exports.Sessions = Sessions;
 exports.Tasks = Tasks;
 exports.Tools = Tools;
 exports.Traces = Traces;
+exports.Webhooks = Webhooks;
 exports.createClient = createClient;
 exports.createConfig = createConfig;