@naturali/sdk 0.41.0 → 0.42.1

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 {
 	/**

package/dist/index.d.cts

@@ -1460,6 +1460,11 @@ type KnowledgeDocument = {
   collection_id: string;
   project_id: string;
   filename: string | null;
+  /**
+   * Media type of the source file; null for an inline-text document.
+   *
+   */
+  content_type: string | null;
   /**
    * Ingestion status (API.md §4, K1). `pending` — enqueued/processing; `indexed` — fully embedded and retrievable; `failed` — ingestion error (see `error`).
    *
@@ -1473,6 +1478,11 @@ type KnowledgeDocument = {
    * Source size in bytes.
    */
   size: number | null;
+  /**
+   * Number of embedded chunks the document was split into; null until ingestion finishes.
+   *
+   */
+  chunk_count: number | null;
   /**
    * Text content — present on get when indexed, null on list.
    */
@@ -1480,19 +1490,48 @@ type KnowledgeDocument = {
   created_at: Date;
   updated_at: Date;
 };
+/**
+ * Exactly one of `content` (inline text) or `file` (a base64-encoded upload). `file` additionally requires `content_type` and `filename`.
+ *
+ */
 type KnowledgeDocumentCreate = {
   /**
-   * The document's text content.
+   * The document's text content. Mutually exclusive with `file`.
    */
-  content: string;
+  content?: string;
+  /**
+   * The file's bytes, base64-encoded. Mutually exclusive with `content`.
+   *
+   */
+  file?: string;
   /**
-   * A label for the document; also its logical filename.
+   * Media type of `file`. `application/pdf`, `text/plain` and `text/markdown` are extracted natively; anything else needs a matching converter in the project. Required with `file`.
+   *
+   */
+  content_type?: string;
+  /**
+   * A label for the document; also its logical filename. Required with `file`.
+   *
    */
   filename?: string;
   /**
    * Human-readable title.
    */
   title?: string;
+  /**
+   * How the extracted text is split for embedding. `page` (the default) makes one chunk per page, which is what lets a retrieved chunk cite a page number; `size` makes fixed-width character windows, which retrieves more sharply on dense pages at the cost of that citation; `whole` keeps the document as a single chunk. Ignored for inline text.
+   *
+   */
+  chunk_strategy?: 'page' | 'size' | 'whole';
+  /**
+   * Window width in characters, when `chunk_strategy` is `size`.
+   */
+  chunk_size?: number;
+  /**
+   * Characters of overlap between consecutive windows, when `chunk_strategy` is `size`. Must be smaller than `chunk_size`.
+   *
+   */
+  chunk_overlap?: number;
 };
 type KnowledgeDocumentList = {
   data: Array<KnowledgeDocument>;
@@ -1501,6 +1540,103 @@ type KnowledgeDocumentList = {
    */
   next_cursor: string | null;
 };
+type KnowledgeConverter = {
+  /**
+   * Public converter ID (igr_ prefix).
+   */
+  id: string;
+  project_id: string;
+  /**
+   * The media-type glob this converter claims, matched against an uploaded file's `content_type`.
+   *
+   */
+  content_type: string;
+  /**
+   * The agent that converts the file; null for a tool converter.
+   */
+  agent_id: string | null;
+  /**
+   * The tool that converts the file; null for an agent converter.
+   */
+  tool_id: string | null;
+  /**
+   * Fixed arguments merged into every call to a tool converter (e.g. `{ "language": "en" }`). Null for an agent converter.
+   *
+   */
+  preset_parameters: {
+    [key: string]: unknown;
+  } | null;
+  /**
+   * What to do for a media type the platform *can* extract natively (PDF, text, markdown). `first` — try native extraction and fall back to the converter only when it yields no text, which is what makes a converter a scanned-PDF fallback; `skip` — always convert.
+   *
+   */
+  native_extraction: 'first' | 'skip';
+  /**
+   * Default chunking for documents this converter produces, overridable per document at create time.
+   *
+   */
+  chunk_strategy: 'page' | 'size' | 'whole';
+  chunk_size: number | null;
+  chunk_overlap: number | null;
+  created_at: Date;
+  updated_at: Date;
+};
+/**
+ * Exactly one of `agent_id` or `tool_id` is required.
+ */
+type KnowledgeConverterCreate = {
+  /**
+   * The media-type glob to claim — an exact type (`audio/mpeg`) or a `*` wildcard on the subtype (`image*`).
+   *
+   */
+  content_type: string;
+  /**
+   * An agent in this project, used as the converter.
+   */
+  agent_id?: string;
+  /**
+   * An `http` tool in this project, used as the converter.
+   */
+  tool_id?: string;
+  /**
+   * Fixed arguments merged into every tool-converter call.
+   */
+  preset_parameters?: {
+    [key: string]: unknown;
+  };
+  native_extraction?: 'first' | 'skip';
+  chunk_strategy?: 'page' | 'size' | 'whole';
+  chunk_size?: number;
+  chunk_overlap?: number;
+};
+/**
+ * At least one field must be present.
+ */
+type KnowledgeConverterUpdate = {
+  content_type?: string;
+  /**
+   * Switches the converter to this agent, clearing `tool_id`.
+   */
+  agent_id?: string;
+  /**
+   * Switches the converter to this tool, clearing `agent_id`.
+   */
+  tool_id?: string;
+  preset_parameters?: {
+    [key: string]: unknown;
+  } | null;
+  native_extraction?: 'first' | 'skip';
+  chunk_strategy?: 'page' | 'size' | 'whole';
+  chunk_size?: number;
+  chunk_overlap?: number;
+};
+type KnowledgeConverterList = {
+  data: Array<KnowledgeConverter>;
+  /**
+   * Cursor for the next page, or null at the end.
+   */
+  next_cursor: string | null;
+};
 type KnowledgeQueryRequest = {
   /**
    * The question to preview retrieval for.
@@ -2491,6 +2627,10 @@ type CollectionId = string;
  * Knowledge document public ID (doc_ prefix) — the runtime document id.
  */
 type DocumentId = string;
+/**
+ * Knowledge converter public ID (igr_ prefix).
+ */
+type ConverterId = string;
 /**
  * Provider public ID (aip_ prefix).
  */
@@ -4658,6 +4798,10 @@ type CreateKnowledgeDocumentErrors = {
    * The resource does not exist (existence is not leaked).
    */
   404: ErrorResponse;
+  /**
+   * The uploaded file exceeds the maximum size.
+   */
+  413: ErrorResponse;
   /**
    * The upstream runtime could not complete the operation.
    */
@@ -4794,6 +4938,214 @@ type ReingestKnowledgeDocumentResponses = {
   202: KnowledgeDocument;
 };
 type ReingestKnowledgeDocumentResponse = ReingestKnowledgeDocumentResponses[keyof ReingestKnowledgeDocumentResponses];
+type ListKnowledgeConvertersData = {
+  body?: never;
+  path: {
+    /**
+     * Project public ID (proj_ prefix).
+     */
+    project_id: string;
+  };
+  query?: {
+    /**
+     * Maximum items per page.
+     */
+    limit?: number;
+    /**
+     * Opaque pagination cursor from a previous response's next_cursor.
+     */
+    cursor?: string;
+  };
+  url: '/v1/projects/{project_id}/knowledge/converters';
+};
+type ListKnowledgeConvertersErrors = {
+  /**
+   * Missing or invalid credentials.
+   */
+  401: ErrorResponse;
+  /**
+   * The resource does not exist (existence is not leaked).
+   */
+  404: ErrorResponse;
+  /**
+   * The upstream runtime could not complete the operation.
+   */
+  502: ErrorResponse;
+};
+type ListKnowledgeConvertersError = ListKnowledgeConvertersErrors[keyof ListKnowledgeConvertersErrors];
+type ListKnowledgeConvertersResponses = {
+  /**
+   * A page of converters.
+   */
+  200: KnowledgeConverterList;
+};
+type ListKnowledgeConvertersResponse = ListKnowledgeConvertersResponses[keyof ListKnowledgeConvertersResponses];
+type CreateKnowledgeConverterData = {
+  body: KnowledgeConverterCreate;
+  headers?: {
+    /**
+     * Client-supplied key to make this mutating POST idempotent.
+     */
+    'Idempotency-Key'?: string;
+  };
+  path: {
+    /**
+     * Project public ID (proj_ prefix).
+     */
+    project_id: string;
+  };
+  query?: never;
+  url: '/v1/projects/{project_id}/knowledge/converters';
+};
+type CreateKnowledgeConverterErrors = {
+  /**
+   * The request was malformed or failed validation.
+   */
+  400: ErrorResponse;
+  /**
+   * Missing or invalid credentials.
+   */
+  401: ErrorResponse;
+  /**
+   * The resource does not exist (existence is not leaked).
+   */
+  404: ErrorResponse;
+  /**
+   * The request conflicts with the resource's current state.
+   */
+  409: ErrorResponse;
+  /**
+   * The upstream runtime could not complete the operation.
+   */
+  502: ErrorResponse;
+};
+type CreateKnowledgeConverterError = CreateKnowledgeConverterErrors[keyof CreateKnowledgeConverterErrors];
+type CreateKnowledgeConverterResponses = {
+  /**
+   * Converter created.
+   */
+  201: KnowledgeConverter;
+};
+type CreateKnowledgeConverterResponse = CreateKnowledgeConverterResponses[keyof CreateKnowledgeConverterResponses];
+type DeleteKnowledgeConverterData = {
+  body?: never;
+  path: {
+    /**
+     * Project public ID (proj_ prefix).
+     */
+    project_id: string;
+    /**
+     * Knowledge converter public ID (igr_ prefix).
+     */
+    converter_id: string;
+  };
+  query?: never;
+  url: '/v1/projects/{project_id}/knowledge/converters/{converter_id}';
+};
+type DeleteKnowledgeConverterErrors = {
+  /**
+   * Missing or invalid credentials.
+   */
+  401: ErrorResponse;
+  /**
+   * The resource does not exist (existence is not leaked).
+   */
+  404: ErrorResponse;
+  /**
+   * The upstream runtime could not complete the operation.
+   */
+  502: ErrorResponse;
+};
+type DeleteKnowledgeConverterError = DeleteKnowledgeConverterErrors[keyof DeleteKnowledgeConverterErrors];
+type DeleteKnowledgeConverterResponses = {
+  /**
+   * Converter deleted.
+   */
+  204: void;
+};
+type DeleteKnowledgeConverterResponse = DeleteKnowledgeConverterResponses[keyof DeleteKnowledgeConverterResponses];
+type GetKnowledgeConverterData = {
+  body?: never;
+  path: {
+    /**
+     * Project public ID (proj_ prefix).
+     */
+    project_id: string;
+    /**
+     * Knowledge converter public ID (igr_ prefix).
+     */
+    converter_id: string;
+  };
+  query?: never;
+  url: '/v1/projects/{project_id}/knowledge/converters/{converter_id}';
+};
+type GetKnowledgeConverterErrors = {
+  /**
+   * Missing or invalid credentials.
+   */
+  401: ErrorResponse;
+  /**
+   * The resource does not exist (existence is not leaked).
+   */
+  404: ErrorResponse;
+  /**
+   * The upstream runtime could not complete the operation.
+   */
+  502: ErrorResponse;
+};
+type GetKnowledgeConverterError = GetKnowledgeConverterErrors[keyof GetKnowledgeConverterErrors];
+type GetKnowledgeConverterResponses = {
+  /**
+   * Converter details.
+   */
+  200: KnowledgeConverter;
+};
+type GetKnowledgeConverterResponse = GetKnowledgeConverterResponses[keyof GetKnowledgeConverterResponses];
+type UpdateKnowledgeConverterData = {
+  body: KnowledgeConverterUpdate;
+  path: {
+    /**
+     * Project public ID (proj_ prefix).
+     */
+    project_id: string;
+    /**
+     * Knowledge converter public ID (igr_ prefix).
+     */
+    converter_id: string;
+  };
+  query?: never;
+  url: '/v1/projects/{project_id}/knowledge/converters/{converter_id}';
+};
+type UpdateKnowledgeConverterErrors = {
+  /**
+   * The request was malformed or failed validation.
+   */
+  400: ErrorResponse;
+  /**
+   * Missing or invalid credentials.
+   */
+  401: ErrorResponse;
+  /**
+   * The resource does not exist (existence is not leaked).
+   */
+  404: ErrorResponse;
+  /**
+   * The request conflicts with the resource's current state.
+   */
+  409: ErrorResponse;
+  /**
+   * The upstream runtime could not complete the operation.
+   */
+  502: ErrorResponse;
+};
+type UpdateKnowledgeConverterError = UpdateKnowledgeConverterErrors[keyof UpdateKnowledgeConverterErrors];
+type UpdateKnowledgeConverterResponses = {
+  /**
+   * Converter updated.
+   */
+  200: KnowledgeConverter;
+};
+type UpdateKnowledgeConverterResponse = UpdateKnowledgeConverterResponses[keyof UpdateKnowledgeConverterResponses];
 type ListModelsData = {
   body?: never;
   path?: never;
@@ -6904,7 +7256,11 @@ declare class Knowledge {
   /**
    * 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<ThrowOnError extends boolean = false>(options: Options<CreateKnowledgeDocumentData, ThrowOnError>): RequestResult<CreateKnowledgeDocumentResponses, CreateKnowledgeDocumentErrors, ThrowOnError>;
@@ -6925,6 +7281,53 @@ declare class Knowledge {
    *
    */
   static reingestKnowledgeDocument<ThrowOnError extends boolean = false>(options: Options<ReingestKnowledgeDocumentData, ThrowOnError>): RequestResult<ReingestKnowledgeDocumentResponses, ReingestKnowledgeDocumentErrors, ThrowOnError>;
+  /**
+   * List converters
+   *
+   * Lists the media converters registered in the project.
+   */
+  static listKnowledgeConverters<ThrowOnError extends boolean = false>(options: Options<ListKnowledgeConvertersData, ThrowOnError>): RequestResult<ListKnowledgeConvertersResponses, ListKnowledgeConvertersErrors, ThrowOnError>;
+  /**
+   * 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<ThrowOnError extends boolean = false>(options: Options<CreateKnowledgeConverterData, ThrowOnError>): RequestResult<CreateKnowledgeConverterResponses, CreateKnowledgeConverterErrors, ThrowOnError>;
+  /**
+   * 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<ThrowOnError extends boolean = false>(options: Options<DeleteKnowledgeConverterData, ThrowOnError>): RequestResult<DeleteKnowledgeConverterResponses, DeleteKnowledgeConverterErrors, ThrowOnError>;
+  /**
+   * Get a converter
+   */
+  static getKnowledgeConverter<ThrowOnError extends boolean = false>(options: Options<GetKnowledgeConverterData, ThrowOnError>): RequestResult<GetKnowledgeConverterResponses, GetKnowledgeConverterErrors, ThrowOnError>;
+  /**
+   * 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<ThrowOnError extends boolean = false>(options: Options<UpdateKnowledgeConverterData, ThrowOnError>): RequestResult<UpdateKnowledgeConverterResponses, UpdateKnowledgeConverterErrors, ThrowOnError>;
 }
 declare class Models {
   /**
@@ -7286,4 +7689,4 @@ declare class NaturaliClient {
   constructor({ token, headers }?: NaturaliClientOptions);
 }
 //#endregion
-export { type Acknowledgement, type AddSessionMessageData, type AddSessionMessageError, type AddSessionMessageErrors, type AddSessionMessageResponse, type AddSessionMessageResponses, type Agent, type AgentCreate, type AgentId, type AgentList, type AgentUpdate, Agents, type ApiKeyCreate, type ApiKeyCreated, type ApiKeyId, type ApiKeyList, type ApiKeyRecord, type ApiKeyUpdate, ApiKeys, type AssigneeFilter, Auth, type AuthSession, type Board, type BoardCompletionRule, type BoardCreate, type BoardDispatch, type BoardId, type BoardIdFilter, type BoardList, type BoardOnEnter, type BoardState, type BoardTransition, type BoardUpdate, Boards, type Channel, type ChannelBinding, type ChannelBindingSet, type ChannelCreate, type ChannelId, type ChannelList, type ChannelUpdate, Channels, type ClientOptions, type CollectionId, type Contact, type ContactConversation, type ContactConversationList, type ContactCreate, type ContactId, type ContactIdentity, type ContactIdentityCreate, type ContactList, type ContactMerge, type ContactMergeList, type ContactMergeRequest, type ContactMergeResult, type ContactUpdate, Contacts, type Conversation, type ConversationId, type ConversationList, type ConversationMessage, type ConversationMessageList, type CreateAgentData, type CreateAgentError, type CreateAgentErrors, type CreateAgentResponse, type CreateAgentResponses, type CreateApiKeyData, type CreateApiKeyError, type CreateApiKeyErrors, type CreateApiKeyResponse, type CreateApiKeyResponses, type CreateBoardData, type CreateBoardError, type CreateBoardErrors, type CreateBoardResponse, type CreateBoardResponses, type CreateChannelData, type CreateChannelError, type CreateChannelErrors, type CreateChannelResponse, type CreateChannelResponses, type CreateContactData, type CreateContactError, type CreateContactErrors, type CreateContactIdentityData, type CreateContactIdentityError, type CreateContactIdentityErrors, type CreateContactIdentityResponse, type CreateContactIdentityResponses, type CreateContactResponse, type CreateContactResponses, type CreateGenerationData, type CreateGenerationError, type CreateGenerationErrors, type CreateGenerationResponse, type CreateGenerationResponses, type CreateKnowledgeCollectionData, type CreateKnowledgeCollectionError, type CreateKnowledgeCollectionErrors, type CreateKnowledgeCollectionResponse, type CreateKnowledgeCollectionResponses, type CreateKnowledgeDocumentData, type CreateKnowledgeDocumentError, type CreateKnowledgeDocumentErrors, type CreateKnowledgeDocumentResponse, type CreateKnowledgeDocumentResponses, type CreateProjectData, type CreateProjectError, type CreateProjectErrors, type CreateProjectResponse, type CreateProjectResponses, type CreateProviderData, type CreateProviderError, type CreateProviderErrors, type CreateProviderResponse, type CreateProviderResponses, type CreateSessionData, type CreateSessionError, type CreateSessionErrors, type CreateSessionResponse, type CreateSessionResponses, type CreateTaskData, type CreateTaskError, type CreateTaskErrors, type CreateTaskResponse, type CreateTaskResponses, type CreateToolData, type CreateToolError, type CreateToolErrors, type CreateToolResponse, type CreateToolResponses, type CreateWebhookData, type CreateWebhookError, type CreateWebhookErrors, type CreateWebhookResponse, type CreateWebhookResponses, type Cursor, type DeleteAgentData, type DeleteAgentError, type DeleteAgentErrors, type DeleteAgentResponse, type DeleteAgentResponses, type DeleteApiKeyData, type DeleteApiKeyError, type DeleteApiKeyErrors, type DeleteApiKeyResponse, type DeleteApiKeyResponses, type DeleteBoardData, type DeleteBoardError, type DeleteBoardErrors, type DeleteBoardResponse, type DeleteBoardResponses, type DeleteChannelBindingData, type DeleteChannelBindingError, type DeleteChannelBindingErrors, type DeleteChannelBindingResponse, type DeleteChannelBindingResponses, type DeleteChannelData, type DeleteChannelError, type DeleteChannelErrors, type DeleteChannelResponse, type DeleteChannelResponses, type DeleteContactData, type DeleteContactError, type DeleteContactErrors, type DeleteContactIdentityData, type DeleteContactIdentityError, type DeleteContactIdentityErrors, type DeleteContactIdentityResponse, type DeleteContactIdentityResponses, type DeleteContactResponse, type DeleteContactResponses, type DeleteKnowledgeCollectionData, type DeleteKnowledgeCollectionError, type DeleteKnowledgeCollectionErrors, type DeleteKnowledgeCollectionResponse, type DeleteKnowledgeCollectionResponses, type DeleteKnowledgeDocumentData, type DeleteKnowledgeDocumentError, type DeleteKnowledgeDocumentErrors, type DeleteKnowledgeDocumentResponse, type DeleteKnowledgeDocumentResponses, type DeleteProjectData, type DeleteProjectError, type DeleteProjectErrors, type DeleteProjectResponse, type DeleteProjectResponses, type DeleteProviderData, type DeleteProviderError, type DeleteProviderErrors, type DeleteProviderResponse, type DeleteProviderResponses, type DeleteTaskData, type DeleteTaskError, type DeleteTaskErrors, type DeleteTaskResponse, type DeleteTaskResponses, type DeleteToolData, type DeleteToolError, type DeleteToolErrors, type DeleteToolResponse, type DeleteToolResponses, type DeleteWebhookData, type DeleteWebhookError, type DeleteWebhookErrors, type DeleteWebhookResponse, type DeleteWebhookResponses, type DeliveryId, type DiscordModes, type DocumentId, type ErrorResponse, type Event, type EventSubscription, type EventType, type Force, type GenerateSessionResponseData, type GenerateSessionResponseError, type GenerateSessionResponseErrors, type GenerateSessionResponseResponse, type GenerateSessionResponseResponses, type Generation, type GenerationCreate, type GenerationId, type GenerationList, type GenerationResult, type GenerationStatus, type GenerationUsage, Generations, type GetAgentData, type GetAgentError, type GetAgentErrors, type GetAgentResponse, type GetAgentResponses, type GetApiKeyData, type GetApiKeyError, type GetApiKeyErrors, type GetApiKeyResponse, type GetApiKeyResponses, type GetBoardData, type GetBoardError, type GetBoardErrors, type GetBoardResponse, type GetBoardResponses, type GetChannelBindingData, type GetChannelBindingError, type GetChannelBindingErrors, type GetChannelBindingResponse, type GetChannelBindingResponses, type GetChannelConversationData, type GetChannelConversationError, type GetChannelConversationErrors, type GetChannelConversationResponse, type GetChannelConversationResponses, type GetChannelData, type GetChannelError, type GetChannelErrors, type GetChannelResponse, type GetChannelResponses, type GetContactData, type GetContactError, type GetContactErrors, type GetContactResponse, type GetContactResponses, type GetCurrentUserData, type GetCurrentUserError, type GetCurrentUserErrors, type GetCurrentUserResponse, type GetCurrentUserResponses, type GetGenerationData, type GetGenerationError, type GetGenerationErrors, type GetGenerationResponse, type GetGenerationResponses, type GetGenerationUsageData, type GetGenerationUsageError, type GetGenerationUsageErrors, type GetGenerationUsageResponse, type GetGenerationUsageResponses, type GetKnowledgeCollectionData, type GetKnowledgeCollectionError, type GetKnowledgeCollectionErrors, type GetKnowledgeCollectionResponse, type GetKnowledgeCollectionResponses, type GetKnowledgeDocumentData, type GetKnowledgeDocumentError, type GetKnowledgeDocumentErrors, type GetKnowledgeDocumentResponse, type GetKnowledgeDocumentResponses, type GetModelData, type GetModelError, type GetModelErrors, type GetModelResponse, type GetModelResponses, type GetProjectData, type GetProjectError, type GetProjectErrors, type GetProjectResponse, type GetProjectResponses, type GetProjectUsageData, type GetProjectUsageError, type GetProjectUsageErrors, type GetProjectUsageResponse, type GetProjectUsageResponses, type GetProviderData, type GetProviderError, type GetProviderErrors, type GetProviderResponse, type GetProviderResponses, type GetSessionData, type GetSessionError, type GetSessionErrors, type GetSessionResponse, type GetSessionResponses, type GetTaskData, type GetTaskError, type GetTaskErrors, type GetTaskResponse, type GetTaskResponses, type GetToolData, type GetToolError, type GetToolErrors, type GetToolResponse, type GetToolResponses, type GetTraceData, type GetTraceError, type GetTraceErrors, type GetTraceResponse, type GetTraceResponses, type GetTraceTreeData, type GetTraceTreeError, type GetTraceTreeErrors, type GetTraceTreeResponse, type GetTraceTreeResponses, type GetWebhookData, type GetWebhookDeliveryData, type GetWebhookDeliveryError, type GetWebhookDeliveryErrors, type GetWebhookDeliveryResponse, type GetWebhookDeliveryResponses, type GetWebhookError, type GetWebhookErrors, type GetWebhookResponse, type GetWebhookResponses, type HttpExecute, type IdempotencyKey, type IdentityId, Knowledge, type KnowledgeChunk, type KnowledgeCollection, type KnowledgeCollectionCreate, type KnowledgeCollectionList, type KnowledgeCollectionUpdate, type KnowledgeDocument, type KnowledgeDocumentCreate, type KnowledgeDocumentList, type KnowledgeQueryRequest, type KnowledgeQueryResult, type Limit, type ListAgentGenerationsData, type ListAgentGenerationsError, type ListAgentGenerationsErrors, type ListAgentGenerationsResponse, type ListAgentGenerationsResponses, type ListAgentsData, type ListAgentsError, type ListAgentsErrors, type ListAgentsResponse, type ListAgentsResponses, type ListApiKeysData, type ListApiKeysError, type ListApiKeysErrors, type ListApiKeysResponse, type ListApiKeysResponses, type ListBoardsData, type ListBoardsError, type ListBoardsErrors, type ListBoardsResponse, type ListBoardsResponses, type ListChannelConversationMessagesData, type ListChannelConversationMessagesError, type ListChannelConversationMessagesErrors, type ListChannelConversationMessagesResponse, type ListChannelConversationMessagesResponses, type ListChannelConversationsData, type ListChannelConversationsError, type ListChannelConversationsErrors, type ListChannelConversationsResponse, type ListChannelConversationsResponses, type ListChannelsData, type ListChannelsError, type ListChannelsErrors, type ListChannelsResponse, type ListChannelsResponses, type ListContactConversationsData, type ListContactConversationsError, type ListContactConversationsErrors, type ListContactConversationsResponse, type ListContactConversationsResponses, type ListContactMergesData, type ListContactMergesError, type ListContactMergesErrors, type ListContactMergesResponse, type ListContactMergesResponses, type ListContactsData, type ListContactsError, type ListContactsErrors, type ListContactsResponse, type ListContactsResponses, type ListKnowledgeCollectionsData, type ListKnowledgeCollectionsError, type ListKnowledgeCollectionsErrors, type ListKnowledgeCollectionsResponse, type ListKnowledgeCollectionsResponses, type ListKnowledgeDocumentsData, type ListKnowledgeDocumentsError, type ListKnowledgeDocumentsErrors, type ListKnowledgeDocumentsResponse, type ListKnowledgeDocumentsResponses, type ListModelsData, type ListModelsError, type ListModelsErrors, type ListModelsResponse, type ListModelsResponses, type ListProjectsData, type ListProjectsError, type ListProjectsErrors, type ListProjectsResponse, type ListProjectsResponses, type ListProvidersData, type ListProvidersError, type ListProvidersErrors, type ListProvidersResponse, type ListProvidersResponses, type ListTaskTransitionsData, type ListTaskTransitionsError, type ListTaskTransitionsErrors, type ListTaskTransitionsResponse, type ListTaskTransitionsResponses, type ListTasksData, type ListTasksError, type ListTasksErrors, type ListTasksResponse, type ListTasksResponses, type ListToolsData, type ListToolsError, type ListToolsErrors, type ListToolsResponse, type ListToolsResponses, type ListTraceGenerationsData, type ListTraceGenerationsError, type ListTraceGenerationsErrors, type ListTraceGenerationsResponse, type ListTraceGenerationsResponses, type ListTracesData, type ListTracesError, type ListTracesErrors, type ListTracesResponse, type ListTracesResponses, type ListWebhookDeliveriesData, type ListWebhookDeliveriesError, type ListWebhookDeliveriesErrors, type ListWebhookDeliveriesResponse, type ListWebhookDeliveriesResponses, type ListWebhooksData, type ListWebhooksError, type ListWebhooksErrors, type ListWebhooksResponse, type ListWebhooksResponses, type LogoutData, type LogoutError, type LogoutErrors, type LogoutRequest, type LogoutResponse, type LogoutResponses, type McpConfig, type MergeContactData, type MergeContactError, type MergeContactErrors, type MergeContactResponse, type MergeContactResponses, type MergeId, type Message, type MessagesLimit, type Model, type ModelList, Models, NaturaliClient, type NaturaliClientOptions, type Offset, type Options, type Project, type ProjectCreate, type ProjectId, type ProjectList, type ProjectUpdate, type ProjectUsage, Projects, type Provider, type ProviderCreate, type ProviderId, type ProviderList, type ProviderUpdate, Providers, type QueryKnowledgeCollectionData, type QueryKnowledgeCollectionError, type QueryKnowledgeCollectionErrors, type QueryKnowledgeCollectionResponse, type QueryKnowledgeCollectionResponses, type RedeliverWebhookDeliveryData, type RedeliverWebhookDeliveryError, type RedeliverWebhookDeliveryErrors, type RedeliverWebhookDeliveryResponse, type RedeliverWebhookDeliveryResponses, type RefreshRequest, type RefreshSessionData, type RefreshSessionError, type RefreshSessionErrors, type RefreshSessionResponse, type RefreshSessionResponses, type ReingestKnowledgeDocumentData, type ReingestKnowledgeDocumentError, type ReingestKnowledgeDocumentErrors, type ReingestKnowledgeDocumentResponse, type ReingestKnowledgeDocumentResponses, type RequestSignInCodeData, type RequestSignInCodeError, type RequestSignInCodeErrors, type RequestSignInCodeResponse, type RequestSignInCodeResponses, type RevertContactMergeData, type RevertContactMergeError, type RevertContactMergeErrors, type RevertContactMergeResponse, type RevertContactMergeResponses, type RotateApiKeyData, type RotateApiKeyError, type RotateApiKeyErrors, type RotateApiKeyResponse, type RotateApiKeyResponses, type RotateWebhookSecretData, type RotateWebhookSecretError, type RotateWebhookSecretErrors, type RotateWebhookSecretResponse, type RotateWebhookSecretResponses, type Session, type SessionCreate, type SessionGenerate, type SessionGeneration, type SessionId, type SessionMessage, type SessionMessageCreate, Sessions, type SetChannelBindingData, type SetChannelBindingError, type SetChannelBindingErrors, type SetChannelBindingResponse, type SetChannelBindingResponses, type SignInCodeRequest, type SignInCodeVerify, type StateFilter, type StatusFilter, type Task, type TaskCreate, type TaskId, type TaskList, type TaskTransitionList, type TaskTransitionRecord, type TaskTransitionRequest, type TaskUpdate, Tasks, type Tool, type ToolChoice, type ToolContext, type ToolCreate, type ToolId, type ToolList, type ToolUpdate, Tools, type Trace, type TraceId, type TraceList, type TraceTreeNode, Traces, type TransitionTaskData, type TransitionTaskError, type TransitionTaskErrors, type TransitionTaskResponse, type TransitionTaskResponses, type UpdateAgentData, type UpdateAgentError, type UpdateAgentErrors, type UpdateAgentResponse, type UpdateAgentResponses, type UpdateApiKeyData, type UpdateApiKeyError, type UpdateApiKeyErrors, type UpdateApiKeyResponse, type UpdateApiKeyResponses, type UpdateBoardData, type UpdateBoardError, type UpdateBoardErrors, type UpdateBoardResponse, type UpdateBoardResponses, type UpdateChannelData, type UpdateChannelError, type UpdateChannelErrors, type UpdateChannelResponse, type UpdateChannelResponses, type UpdateContactData, type UpdateContactError, type UpdateContactErrors, type UpdateContactResponse, type UpdateContactResponses, type UpdateKnowledgeCollectionData, type UpdateKnowledgeCollectionError, type UpdateKnowledgeCollectionErrors, type UpdateKnowledgeCollectionResponse, type UpdateKnowledgeCollectionResponses, type UpdateProjectData, type UpdateProjectError, type UpdateProjectErrors, type UpdateProjectResponse, type UpdateProjectResponses, type UpdateProviderData, type UpdateProviderError, type UpdateProviderErrors, type UpdateProviderResponse, type UpdateProviderResponses, type UpdateTaskData, type UpdateTaskError, type UpdateTaskErrors, type UpdateTaskResponse, type UpdateTaskResponses, type UpdateToolData, type UpdateToolError, type UpdateToolErrors, type UpdateToolResponse, type UpdateToolResponses, type UpdateWebhookData, type UpdateWebhookError, type UpdateWebhookErrors, type UpdateWebhookResponse, type UpdateWebhookResponses, type UsageGroup, type UsageTokens, type User, type VerifySignInCodeData, type VerifySignInCodeError, type VerifySignInCodeErrors, type VerifySignInCodeResponse, type VerifySignInCodeResponses, type Webhook, type WebhookCreate, type WebhookDelivery, type WebhookDeliveryList, type WebhookId, type WebhookList, type WebhookUpdate, type WebhookWithSecret, Webhooks, createClient, createConfig };
+export { type Acknowledgement, type AddSessionMessageData, type AddSessionMessageError, type AddSessionMessageErrors, type AddSessionMessageResponse, type AddSessionMessageResponses, type Agent, type AgentCreate, type AgentId, type AgentList, type AgentUpdate, Agents, type ApiKeyCreate, type ApiKeyCreated, type ApiKeyId, type ApiKeyList, type ApiKeyRecord, type ApiKeyUpdate, ApiKeys, type AssigneeFilter, Auth, type AuthSession, type Board, type BoardCompletionRule, type BoardCreate, type BoardDispatch, type BoardId, type BoardIdFilter, type BoardList, type BoardOnEnter, type BoardState, type BoardTransition, type BoardUpdate, Boards, type Channel, type ChannelBinding, type ChannelBindingSet, type ChannelCreate, type ChannelId, type ChannelList, type ChannelUpdate, Channels, type ClientOptions, type CollectionId, type Contact, type ContactConversation, type ContactConversationList, type ContactCreate, type ContactId, type ContactIdentity, type ContactIdentityCreate, type ContactList, type ContactMerge, type ContactMergeList, type ContactMergeRequest, type ContactMergeResult, type ContactUpdate, Contacts, type Conversation, type ConversationId, type ConversationList, type ConversationMessage, type ConversationMessageList, type ConverterId, type CreateAgentData, type CreateAgentError, type CreateAgentErrors, type CreateAgentResponse, type CreateAgentResponses, type CreateApiKeyData, type CreateApiKeyError, type CreateApiKeyErrors, type CreateApiKeyResponse, type CreateApiKeyResponses, type CreateBoardData, type CreateBoardError, type CreateBoardErrors, type CreateBoardResponse, type CreateBoardResponses, type CreateChannelData, type CreateChannelError, type CreateChannelErrors, type CreateChannelResponse, type CreateChannelResponses, type CreateContactData, type CreateContactError, type CreateContactErrors, type CreateContactIdentityData, type CreateContactIdentityError, type CreateContactIdentityErrors, type CreateContactIdentityResponse, type CreateContactIdentityResponses, type CreateContactResponse, type CreateContactResponses, type CreateGenerationData, type CreateGenerationError, type CreateGenerationErrors, type CreateGenerationResponse, type CreateGenerationResponses, type CreateKnowledgeCollectionData, type CreateKnowledgeCollectionError, type CreateKnowledgeCollectionErrors, type CreateKnowledgeCollectionResponse, type CreateKnowledgeCollectionResponses, type CreateKnowledgeConverterData, type CreateKnowledgeConverterError, type CreateKnowledgeConverterErrors, type CreateKnowledgeConverterResponse, type CreateKnowledgeConverterResponses, type CreateKnowledgeDocumentData, type CreateKnowledgeDocumentError, type CreateKnowledgeDocumentErrors, type CreateKnowledgeDocumentResponse, type CreateKnowledgeDocumentResponses, type CreateProjectData, type CreateProjectError, type CreateProjectErrors, type CreateProjectResponse, type CreateProjectResponses, type CreateProviderData, type CreateProviderError, type CreateProviderErrors, type CreateProviderResponse, type CreateProviderResponses, type CreateSessionData, type CreateSessionError, type CreateSessionErrors, type CreateSessionResponse, type CreateSessionResponses, type CreateTaskData, type CreateTaskError, type CreateTaskErrors, type CreateTaskResponse, type CreateTaskResponses, type CreateToolData, type CreateToolError, type CreateToolErrors, type CreateToolResponse, type CreateToolResponses, type CreateWebhookData, type CreateWebhookError, type CreateWebhookErrors, type CreateWebhookResponse, type CreateWebhookResponses, type Cursor, type DeleteAgentData, type DeleteAgentError, type DeleteAgentErrors, type DeleteAgentResponse, type DeleteAgentResponses, type DeleteApiKeyData, type DeleteApiKeyError, type DeleteApiKeyErrors, type DeleteApiKeyResponse, type DeleteApiKeyResponses, type DeleteBoardData, type DeleteBoardError, type DeleteBoardErrors, type DeleteBoardResponse, type DeleteBoardResponses, type DeleteChannelBindingData, type DeleteChannelBindingError, type DeleteChannelBindingErrors, type DeleteChannelBindingResponse, type DeleteChannelBindingResponses, type DeleteChannelData, type DeleteChannelError, type DeleteChannelErrors, type DeleteChannelResponse, type DeleteChannelResponses, type DeleteContactData, type DeleteContactError, type DeleteContactErrors, type DeleteContactIdentityData, type DeleteContactIdentityError, type DeleteContactIdentityErrors, type DeleteContactIdentityResponse, type DeleteContactIdentityResponses, type DeleteContactResponse, type DeleteContactResponses, type DeleteKnowledgeCollectionData, type DeleteKnowledgeCollectionError, type DeleteKnowledgeCollectionErrors, type DeleteKnowledgeCollectionResponse, type DeleteKnowledgeCollectionResponses, type DeleteKnowledgeConverterData, type DeleteKnowledgeConverterError, type DeleteKnowledgeConverterErrors, type DeleteKnowledgeConverterResponse, type DeleteKnowledgeConverterResponses, type DeleteKnowledgeDocumentData, type DeleteKnowledgeDocumentError, type DeleteKnowledgeDocumentErrors, type DeleteKnowledgeDocumentResponse, type DeleteKnowledgeDocumentResponses, type DeleteProjectData, type DeleteProjectError, type DeleteProjectErrors, type DeleteProjectResponse, type DeleteProjectResponses, type DeleteProviderData, type DeleteProviderError, type DeleteProviderErrors, type DeleteProviderResponse, type DeleteProviderResponses, type DeleteTaskData, type DeleteTaskError, type DeleteTaskErrors, type DeleteTaskResponse, type DeleteTaskResponses, type DeleteToolData, type DeleteToolError, type DeleteToolErrors, type DeleteToolResponse, type DeleteToolResponses, type DeleteWebhookData, type DeleteWebhookError, type DeleteWebhookErrors, type DeleteWebhookResponse, type DeleteWebhookResponses, type DeliveryId, type DiscordModes, type DocumentId, type ErrorResponse, type Event, type EventSubscription, type EventType, type Force, type GenerateSessionResponseData, type GenerateSessionResponseError, type GenerateSessionResponseErrors, type GenerateSessionResponseResponse, type GenerateSessionResponseResponses, type Generation, type GenerationCreate, type GenerationId, type GenerationList, type GenerationResult, type GenerationStatus, type GenerationUsage, Generations, type GetAgentData, type GetAgentError, type GetAgentErrors, type GetAgentResponse, type GetAgentResponses, type GetApiKeyData, type GetApiKeyError, type GetApiKeyErrors, type GetApiKeyResponse, type GetApiKeyResponses, type GetBoardData, type GetBoardError, type GetBoardErrors, type GetBoardResponse, type GetBoardResponses, type GetChannelBindingData, type GetChannelBindingError, type GetChannelBindingErrors, type GetChannelBindingResponse, type GetChannelBindingResponses, type GetChannelConversationData, type GetChannelConversationError, type GetChannelConversationErrors, type GetChannelConversationResponse, type GetChannelConversationResponses, type GetChannelData, type GetChannelError, type GetChannelErrors, type GetChannelResponse, type GetChannelResponses, type GetContactData, type GetContactError, type GetContactErrors, type GetContactResponse, type GetContactResponses, type GetCurrentUserData, type GetCurrentUserError, type GetCurrentUserErrors, type GetCurrentUserResponse, type GetCurrentUserResponses, type GetGenerationData, type GetGenerationError, type GetGenerationErrors, type GetGenerationResponse, type GetGenerationResponses, type GetGenerationUsageData, type GetGenerationUsageError, type GetGenerationUsageErrors, type GetGenerationUsageResponse, type GetGenerationUsageResponses, type GetKnowledgeCollectionData, type GetKnowledgeCollectionError, type GetKnowledgeCollectionErrors, type GetKnowledgeCollectionResponse, type GetKnowledgeCollectionResponses, type GetKnowledgeConverterData, type GetKnowledgeConverterError, type GetKnowledgeConverterErrors, type GetKnowledgeConverterResponse, type GetKnowledgeConverterResponses, type GetKnowledgeDocumentData, type GetKnowledgeDocumentError, type GetKnowledgeDocumentErrors, type GetKnowledgeDocumentResponse, type GetKnowledgeDocumentResponses, type GetModelData, type GetModelError, type GetModelErrors, type GetModelResponse, type GetModelResponses, type GetProjectData, type GetProjectError, type GetProjectErrors, type GetProjectResponse, type GetProjectResponses, type GetProjectUsageData, type GetProjectUsageError, type GetProjectUsageErrors, type GetProjectUsageResponse, type GetProjectUsageResponses, type GetProviderData, type GetProviderError, type GetProviderErrors, type GetProviderResponse, type GetProviderResponses, type GetSessionData, type GetSessionError, type GetSessionErrors, type GetSessionResponse, type GetSessionResponses, type GetTaskData, type GetTaskError, type GetTaskErrors, type GetTaskResponse, type GetTaskResponses, type GetToolData, type GetToolError, type GetToolErrors, type GetToolResponse, type GetToolResponses, type GetTraceData, type GetTraceError, type GetTraceErrors, type GetTraceResponse, type GetTraceResponses, type GetTraceTreeData, type GetTraceTreeError, type GetTraceTreeErrors, type GetTraceTreeResponse, type GetTraceTreeResponses, type GetWebhookData, type GetWebhookDeliveryData, type GetWebhookDeliveryError, type GetWebhookDeliveryErrors, type GetWebhookDeliveryResponse, type GetWebhookDeliveryResponses, type GetWebhookError, type GetWebhookErrors, type GetWebhookResponse, type GetWebhookResponses, type HttpExecute, type IdempotencyKey, type IdentityId, Knowledge, type KnowledgeChunk, type KnowledgeCollection, type KnowledgeCollectionCreate, type KnowledgeCollectionList, type KnowledgeCollectionUpdate, type KnowledgeConverter, type KnowledgeConverterCreate, type KnowledgeConverterList, type KnowledgeConverterUpdate, type KnowledgeDocument, type KnowledgeDocumentCreate, type KnowledgeDocumentList, type KnowledgeQueryRequest, type KnowledgeQueryResult, type Limit, type ListAgentGenerationsData, type ListAgentGenerationsError, type ListAgentGenerationsErrors, type ListAgentGenerationsResponse, type ListAgentGenerationsResponses, type ListAgentsData, type ListAgentsError, type ListAgentsErrors, type ListAgentsResponse, type ListAgentsResponses, type ListApiKeysData, type ListApiKeysError, type ListApiKeysErrors, type ListApiKeysResponse, type ListApiKeysResponses, type ListBoardsData, type ListBoardsError, type ListBoardsErrors, type ListBoardsResponse, type ListBoardsResponses, type ListChannelConversationMessagesData, type ListChannelConversationMessagesError, type ListChannelConversationMessagesErrors, type ListChannelConversationMessagesResponse, type ListChannelConversationMessagesResponses, type ListChannelConversationsData, type ListChannelConversationsError, type ListChannelConversationsErrors, type ListChannelConversationsResponse, type ListChannelConversationsResponses, type ListChannelsData, type ListChannelsError, type ListChannelsErrors, type ListChannelsResponse, type ListChannelsResponses, type ListContactConversationsData, type ListContactConversationsError, type ListContactConversationsErrors, type ListContactConversationsResponse, type ListContactConversationsResponses, type ListContactMergesData, type ListContactMergesError, type ListContactMergesErrors, type ListContactMergesResponse, type ListContactMergesResponses, type ListContactsData, type ListContactsError, type ListContactsErrors, type ListContactsResponse, type ListContactsResponses, type ListKnowledgeCollectionsData, type ListKnowledgeCollectionsError, type ListKnowledgeCollectionsErrors, type ListKnowledgeCollectionsResponse, type ListKnowledgeCollectionsResponses, type ListKnowledgeConvertersData, type ListKnowledgeConvertersError, type ListKnowledgeConvertersErrors, type ListKnowledgeConvertersResponse, type ListKnowledgeConvertersResponses, type ListKnowledgeDocumentsData, type ListKnowledgeDocumentsError, type ListKnowledgeDocumentsErrors, type ListKnowledgeDocumentsResponse, type ListKnowledgeDocumentsResponses, type ListModelsData, type ListModelsError, type ListModelsErrors, type ListModelsResponse, type ListModelsResponses, type ListProjectsData, type ListProjectsError, type ListProjectsErrors, type ListProjectsResponse, type ListProjectsResponses, type ListProvidersData, type ListProvidersError, type ListProvidersErrors, type ListProvidersResponse, type ListProvidersResponses, type ListTaskTransitionsData, type ListTaskTransitionsError, type ListTaskTransitionsErrors, type ListTaskTransitionsResponse, type ListTaskTransitionsResponses, type ListTasksData, type ListTasksError, type ListTasksErrors, type ListTasksResponse, type ListTasksResponses, type ListToolsData, type ListToolsError, type ListToolsErrors, type ListToolsResponse, type ListToolsResponses, type ListTraceGenerationsData, type ListTraceGenerationsError, type ListTraceGenerationsErrors, type ListTraceGenerationsResponse, type ListTraceGenerationsResponses, type ListTracesData, type ListTracesError, type ListTracesErrors, type ListTracesResponse, type ListTracesResponses, type ListWebhookDeliveriesData, type ListWebhookDeliveriesError, type ListWebhookDeliveriesErrors, type ListWebhookDeliveriesResponse, type ListWebhookDeliveriesResponses, type ListWebhooksData, type ListWebhooksError, type ListWebhooksErrors, type ListWebhooksResponse, type ListWebhooksResponses, type LogoutData, type LogoutError, type LogoutErrors, type LogoutRequest, type LogoutResponse, type LogoutResponses, type McpConfig, type MergeContactData, type MergeContactError, type MergeContactErrors, type MergeContactResponse, type MergeContactResponses, type MergeId, type Message, type MessagesLimit, type Model, type ModelList, Models, NaturaliClient, type NaturaliClientOptions, type Offset, type Options, type Project, type ProjectCreate, type ProjectId, type ProjectList, type ProjectUpdate, type ProjectUsage, Projects, type Provider, type ProviderCreate, type ProviderId, type ProviderList, type ProviderUpdate, Providers, type QueryKnowledgeCollectionData, type QueryKnowledgeCollectionError, type QueryKnowledgeCollectionErrors, type QueryKnowledgeCollectionResponse, type QueryKnowledgeCollectionResponses, type RedeliverWebhookDeliveryData, type RedeliverWebhookDeliveryError, type RedeliverWebhookDeliveryErrors, type RedeliverWebhookDeliveryResponse, type RedeliverWebhookDeliveryResponses, type RefreshRequest, type RefreshSessionData, type RefreshSessionError, type RefreshSessionErrors, type RefreshSessionResponse, type RefreshSessionResponses, type ReingestKnowledgeDocumentData, type ReingestKnowledgeDocumentError, type ReingestKnowledgeDocumentErrors, type ReingestKnowledgeDocumentResponse, type ReingestKnowledgeDocumentResponses, type RequestSignInCodeData, type RequestSignInCodeError, type RequestSignInCodeErrors, type RequestSignInCodeResponse, type RequestSignInCodeResponses, type RevertContactMergeData, type RevertContactMergeError, type RevertContactMergeErrors, type RevertContactMergeResponse, type RevertContactMergeResponses, type RotateApiKeyData, type RotateApiKeyError, type RotateApiKeyErrors, type RotateApiKeyResponse, type RotateApiKeyResponses, type RotateWebhookSecretData, type RotateWebhookSecretError, type RotateWebhookSecretErrors, type RotateWebhookSecretResponse, type RotateWebhookSecretResponses, type Session, type SessionCreate, type SessionGenerate, type SessionGeneration, type SessionId, type SessionMessage, type SessionMessageCreate, Sessions, type SetChannelBindingData, type SetChannelBindingError, type SetChannelBindingErrors, type SetChannelBindingResponse, type SetChannelBindingResponses, type SignInCodeRequest, type SignInCodeVerify, type StateFilter, type StatusFilter, type Task, type TaskCreate, type TaskId, type TaskList, type TaskTransitionList, type TaskTransitionRecord, type TaskTransitionRequest, type TaskUpdate, Tasks, type Tool, type ToolChoice, type ToolContext, type ToolCreate, type ToolId, type ToolList, type ToolUpdate, Tools, type Trace, type TraceId, type TraceList, type TraceTreeNode, Traces, type TransitionTaskData, type TransitionTaskError, type TransitionTaskErrors, type TransitionTaskResponse, type TransitionTaskResponses, type UpdateAgentData, type UpdateAgentError, type UpdateAgentErrors, type UpdateAgentResponse, type UpdateAgentResponses, type UpdateApiKeyData, type UpdateApiKeyError, type UpdateApiKeyErrors, type UpdateApiKeyResponse, type UpdateApiKeyResponses, type UpdateBoardData, type UpdateBoardError, type UpdateBoardErrors, type UpdateBoardResponse, type UpdateBoardResponses, type UpdateChannelData, type UpdateChannelError, type UpdateChannelErrors, type UpdateChannelResponse, type UpdateChannelResponses, type UpdateContactData, type UpdateContactError, type UpdateContactErrors, type UpdateContactResponse, type UpdateContactResponses, type UpdateKnowledgeCollectionData, type UpdateKnowledgeCollectionError, type UpdateKnowledgeCollectionErrors, type UpdateKnowledgeCollectionResponse, type UpdateKnowledgeCollectionResponses, type UpdateKnowledgeConverterData, type UpdateKnowledgeConverterError, type UpdateKnowledgeConverterErrors, type UpdateKnowledgeConverterResponse, type UpdateKnowledgeConverterResponses, type UpdateProjectData, type UpdateProjectError, type UpdateProjectErrors, type UpdateProjectResponse, type UpdateProjectResponses, type UpdateProviderData, type UpdateProviderError, type UpdateProviderErrors, type UpdateProviderResponse, type UpdateProviderResponses, type UpdateTaskData, type UpdateTaskError, type UpdateTaskErrors, type UpdateTaskResponse, type UpdateTaskResponses, type UpdateToolData, type UpdateToolError, type UpdateToolErrors, type UpdateToolResponse, type UpdateToolResponses, type UpdateWebhookData, type UpdateWebhookError, type UpdateWebhookErrors, type UpdateWebhookResponse, type UpdateWebhookResponses, type UsageGroup, type UsageTokens, type User, type VerifySignInCodeData, type VerifySignInCodeError, type VerifySignInCodeErrors, type VerifySignInCodeResponse, type VerifySignInCodeResponses, type Webhook, type WebhookCreate, type WebhookDelivery, type WebhookDeliveryList, type WebhookId, type WebhookList, type WebhookUpdate, type WebhookWithSecret, Webhooks, createClient, createConfig };

package/dist/index.d.mts

@@ -1460,6 +1460,11 @@ type KnowledgeDocument = {
   collection_id: string;
   project_id: string;
   filename: string | null;
+  /**
+   * Media type of the source file; null for an inline-text document.
+   *
+   */
+  content_type: string | null;
   /**
    * Ingestion status (API.md §4, K1). `pending` — enqueued/processing; `indexed` — fully embedded and retrievable; `failed` — ingestion error (see `error`).
    *
@@ -1473,6 +1478,11 @@ type KnowledgeDocument = {
    * Source size in bytes.
    */
   size: number | null;
+  /**
+   * Number of embedded chunks the document was split into; null until ingestion finishes.
+   *
+   */
+  chunk_count: number | null;
   /**
    * Text content — present on get when indexed, null on list.
    */
@@ -1480,19 +1490,48 @@ type KnowledgeDocument = {
   created_at: Date;
   updated_at: Date;
 };
+/**
+ * Exactly one of `content` (inline text) or `file` (a base64-encoded upload). `file` additionally requires `content_type` and `filename`.
+ *
+ */
 type KnowledgeDocumentCreate = {
   /**
-   * The document's text content.
+   * The document's text content. Mutually exclusive with `file`.
    */
-  content: string;
+  content?: string;
+  /**
+   * The file's bytes, base64-encoded. Mutually exclusive with `content`.
+   *
+   */
+  file?: string;
   /**
-   * A label for the document; also its logical filename.
+   * Media type of `file`. `application/pdf`, `text/plain` and `text/markdown` are extracted natively; anything else needs a matching converter in the project. Required with `file`.
+   *
+   */
+  content_type?: string;
+  /**
+   * A label for the document; also its logical filename. Required with `file`.
+   *
    */
   filename?: string;
   /**
    * Human-readable title.
    */
   title?: string;
+  /**
+   * How the extracted text is split for embedding. `page` (the default) makes one chunk per page, which is what lets a retrieved chunk cite a page number; `size` makes fixed-width character windows, which retrieves more sharply on dense pages at the cost of that citation; `whole` keeps the document as a single chunk. Ignored for inline text.
+   *
+   */
+  chunk_strategy?: 'page' | 'size' | 'whole';
+  /**
+   * Window width in characters, when `chunk_strategy` is `size`.
+   */
+  chunk_size?: number;
+  /**
+   * Characters of overlap between consecutive windows, when `chunk_strategy` is `size`. Must be smaller than `chunk_size`.
+   *
+   */
+  chunk_overlap?: number;
 };
 type KnowledgeDocumentList = {
   data: Array<KnowledgeDocument>;
@@ -1501,6 +1540,103 @@ type KnowledgeDocumentList = {
    */
   next_cursor: string | null;
 };
+type KnowledgeConverter = {
+  /**
+   * Public converter ID (igr_ prefix).
+   */
+  id: string;
+  project_id: string;
+  /**
+   * The media-type glob this converter claims, matched against an uploaded file's `content_type`.
+   *
+   */
+  content_type: string;
+  /**
+   * The agent that converts the file; null for a tool converter.
+   */
+  agent_id: string | null;
+  /**
+   * The tool that converts the file; null for an agent converter.
+   */
+  tool_id: string | null;
+  /**
+   * Fixed arguments merged into every call to a tool converter (e.g. `{ "language": "en" }`). Null for an agent converter.
+   *
+   */
+  preset_parameters: {
+    [key: string]: unknown;
+  } | null;
+  /**
+   * What to do for a media type the platform *can* extract natively (PDF, text, markdown). `first` — try native extraction and fall back to the converter only when it yields no text, which is what makes a converter a scanned-PDF fallback; `skip` — always convert.
+   *
+   */
+  native_extraction: 'first' | 'skip';
+  /**
+   * Default chunking for documents this converter produces, overridable per document at create time.
+   *
+   */
+  chunk_strategy: 'page' | 'size' | 'whole';
+  chunk_size: number | null;
+  chunk_overlap: number | null;
+  created_at: Date;
+  updated_at: Date;
+};
+/**
+ * Exactly one of `agent_id` or `tool_id` is required.
+ */
+type KnowledgeConverterCreate = {
+  /**
+   * The media-type glob to claim — an exact type (`audio/mpeg`) or a `*` wildcard on the subtype (`image*`).
+   *
+   */
+  content_type: string;
+  /**
+   * An agent in this project, used as the converter.
+   */
+  agent_id?: string;
+  /**
+   * An `http` tool in this project, used as the converter.
+   */
+  tool_id?: string;
+  /**
+   * Fixed arguments merged into every tool-converter call.
+   */
+  preset_parameters?: {
+    [key: string]: unknown;
+  };
+  native_extraction?: 'first' | 'skip';
+  chunk_strategy?: 'page' | 'size' | 'whole';
+  chunk_size?: number;
+  chunk_overlap?: number;
+};
+/**
+ * At least one field must be present.
+ */
+type KnowledgeConverterUpdate = {
+  content_type?: string;
+  /**
+   * Switches the converter to this agent, clearing `tool_id`.
+   */
+  agent_id?: string;
+  /**
+   * Switches the converter to this tool, clearing `agent_id`.
+   */
+  tool_id?: string;
+  preset_parameters?: {
+    [key: string]: unknown;
+  } | null;
+  native_extraction?: 'first' | 'skip';
+  chunk_strategy?: 'page' | 'size' | 'whole';
+  chunk_size?: number;
+  chunk_overlap?: number;
+};
+type KnowledgeConverterList = {
+  data: Array<KnowledgeConverter>;
+  /**
+   * Cursor for the next page, or null at the end.
+   */
+  next_cursor: string | null;
+};
 type KnowledgeQueryRequest = {
   /**
    * The question to preview retrieval for.
@@ -2491,6 +2627,10 @@ type CollectionId = string;
  * Knowledge document public ID (doc_ prefix) — the runtime document id.
  */
 type DocumentId = string;
+/**
+ * Knowledge converter public ID (igr_ prefix).
+ */
+type ConverterId = string;
 /**
  * Provider public ID (aip_ prefix).
  */
@@ -4658,6 +4798,10 @@ type CreateKnowledgeDocumentErrors = {
    * The resource does not exist (existence is not leaked).
    */
   404: ErrorResponse;
+  /**
+   * The uploaded file exceeds the maximum size.
+   */
+  413: ErrorResponse;
   /**
    * The upstream runtime could not complete the operation.
    */
@@ -4794,6 +4938,214 @@ type ReingestKnowledgeDocumentResponses = {
   202: KnowledgeDocument;
 };
 type ReingestKnowledgeDocumentResponse = ReingestKnowledgeDocumentResponses[keyof ReingestKnowledgeDocumentResponses];
+type ListKnowledgeConvertersData = {
+  body?: never;
+  path: {
+    /**
+     * Project public ID (proj_ prefix).
+     */
+    project_id: string;
+  };
+  query?: {
+    /**
+     * Maximum items per page.
+     */
+    limit?: number;
+    /**
+     * Opaque pagination cursor from a previous response's next_cursor.
+     */
+    cursor?: string;
+  };
+  url: '/v1/projects/{project_id}/knowledge/converters';
+};
+type ListKnowledgeConvertersErrors = {
+  /**
+   * Missing or invalid credentials.
+   */
+  401: ErrorResponse;
+  /**
+   * The resource does not exist (existence is not leaked).
+   */
+  404: ErrorResponse;
+  /**
+   * The upstream runtime could not complete the operation.
+   */
+  502: ErrorResponse;
+};
+type ListKnowledgeConvertersError = ListKnowledgeConvertersErrors[keyof ListKnowledgeConvertersErrors];
+type ListKnowledgeConvertersResponses = {
+  /**
+   * A page of converters.
+   */
+  200: KnowledgeConverterList;
+};
+type ListKnowledgeConvertersResponse = ListKnowledgeConvertersResponses[keyof ListKnowledgeConvertersResponses];
+type CreateKnowledgeConverterData = {
+  body: KnowledgeConverterCreate;
+  headers?: {
+    /**
+     * Client-supplied key to make this mutating POST idempotent.
+     */
+    'Idempotency-Key'?: string;
+  };
+  path: {
+    /**
+     * Project public ID (proj_ prefix).
+     */
+    project_id: string;
+  };
+  query?: never;
+  url: '/v1/projects/{project_id}/knowledge/converters';
+};
+type CreateKnowledgeConverterErrors = {
+  /**
+   * The request was malformed or failed validation.
+   */
+  400: ErrorResponse;
+  /**
+   * Missing or invalid credentials.
+   */
+  401: ErrorResponse;
+  /**
+   * The resource does not exist (existence is not leaked).
+   */
+  404: ErrorResponse;
+  /**
+   * The request conflicts with the resource's current state.
+   */
+  409: ErrorResponse;
+  /**
+   * The upstream runtime could not complete the operation.
+   */
+  502: ErrorResponse;
+};
+type CreateKnowledgeConverterError = CreateKnowledgeConverterErrors[keyof CreateKnowledgeConverterErrors];
+type CreateKnowledgeConverterResponses = {
+  /**
+   * Converter created.
+   */
+  201: KnowledgeConverter;
+};
+type CreateKnowledgeConverterResponse = CreateKnowledgeConverterResponses[keyof CreateKnowledgeConverterResponses];
+type DeleteKnowledgeConverterData = {
+  body?: never;
+  path: {
+    /**
+     * Project public ID (proj_ prefix).
+     */
+    project_id: string;
+    /**
+     * Knowledge converter public ID (igr_ prefix).
+     */
+    converter_id: string;
+  };
+  query?: never;
+  url: '/v1/projects/{project_id}/knowledge/converters/{converter_id}';
+};
+type DeleteKnowledgeConverterErrors = {
+  /**
+   * Missing or invalid credentials.
+   */
+  401: ErrorResponse;
+  /**
+   * The resource does not exist (existence is not leaked).
+   */
+  404: ErrorResponse;
+  /**
+   * The upstream runtime could not complete the operation.
+   */
+  502: ErrorResponse;
+};
+type DeleteKnowledgeConverterError = DeleteKnowledgeConverterErrors[keyof DeleteKnowledgeConverterErrors];
+type DeleteKnowledgeConverterResponses = {
+  /**
+   * Converter deleted.
+   */
+  204: void;
+};
+type DeleteKnowledgeConverterResponse = DeleteKnowledgeConverterResponses[keyof DeleteKnowledgeConverterResponses];
+type GetKnowledgeConverterData = {
+  body?: never;
+  path: {
+    /**
+     * Project public ID (proj_ prefix).
+     */
+    project_id: string;
+    /**
+     * Knowledge converter public ID (igr_ prefix).
+     */
+    converter_id: string;
+  };
+  query?: never;
+  url: '/v1/projects/{project_id}/knowledge/converters/{converter_id}';
+};
+type GetKnowledgeConverterErrors = {
+  /**
+   * Missing or invalid credentials.
+   */
+  401: ErrorResponse;
+  /**
+   * The resource does not exist (existence is not leaked).
+   */
+  404: ErrorResponse;
+  /**
+   * The upstream runtime could not complete the operation.
+   */
+  502: ErrorResponse;
+};
+type GetKnowledgeConverterError = GetKnowledgeConverterErrors[keyof GetKnowledgeConverterErrors];
+type GetKnowledgeConverterResponses = {
+  /**
+   * Converter details.
+   */
+  200: KnowledgeConverter;
+};
+type GetKnowledgeConverterResponse = GetKnowledgeConverterResponses[keyof GetKnowledgeConverterResponses];
+type UpdateKnowledgeConverterData = {
+  body: KnowledgeConverterUpdate;
+  path: {
+    /**
+     * Project public ID (proj_ prefix).
+     */
+    project_id: string;
+    /**
+     * Knowledge converter public ID (igr_ prefix).
+     */
+    converter_id: string;
+  };
+  query?: never;
+  url: '/v1/projects/{project_id}/knowledge/converters/{converter_id}';
+};
+type UpdateKnowledgeConverterErrors = {
+  /**
+   * The request was malformed or failed validation.
+   */
+  400: ErrorResponse;
+  /**
+   * Missing or invalid credentials.
+   */
+  401: ErrorResponse;
+  /**
+   * The resource does not exist (existence is not leaked).
+   */
+  404: ErrorResponse;
+  /**
+   * The request conflicts with the resource's current state.
+   */
+  409: ErrorResponse;
+  /**
+   * The upstream runtime could not complete the operation.
+   */
+  502: ErrorResponse;
+};
+type UpdateKnowledgeConverterError = UpdateKnowledgeConverterErrors[keyof UpdateKnowledgeConverterErrors];
+type UpdateKnowledgeConverterResponses = {
+  /**
+   * Converter updated.
+   */
+  200: KnowledgeConverter;
+};
+type UpdateKnowledgeConverterResponse = UpdateKnowledgeConverterResponses[keyof UpdateKnowledgeConverterResponses];
 type ListModelsData = {
   body?: never;
   path?: never;
@@ -6904,7 +7256,11 @@ declare class Knowledge {
   /**
    * 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<ThrowOnError extends boolean = false>(options: Options<CreateKnowledgeDocumentData, ThrowOnError>): RequestResult<CreateKnowledgeDocumentResponses, CreateKnowledgeDocumentErrors, ThrowOnError>;
@@ -6925,6 +7281,53 @@ declare class Knowledge {
    *
    */
   static reingestKnowledgeDocument<ThrowOnError extends boolean = false>(options: Options<ReingestKnowledgeDocumentData, ThrowOnError>): RequestResult<ReingestKnowledgeDocumentResponses, ReingestKnowledgeDocumentErrors, ThrowOnError>;
+  /**
+   * List converters
+   *
+   * Lists the media converters registered in the project.
+   */
+  static listKnowledgeConverters<ThrowOnError extends boolean = false>(options: Options<ListKnowledgeConvertersData, ThrowOnError>): RequestResult<ListKnowledgeConvertersResponses, ListKnowledgeConvertersErrors, ThrowOnError>;
+  /**
+   * 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<ThrowOnError extends boolean = false>(options: Options<CreateKnowledgeConverterData, ThrowOnError>): RequestResult<CreateKnowledgeConverterResponses, CreateKnowledgeConverterErrors, ThrowOnError>;
+  /**
+   * 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<ThrowOnError extends boolean = false>(options: Options<DeleteKnowledgeConverterData, ThrowOnError>): RequestResult<DeleteKnowledgeConverterResponses, DeleteKnowledgeConverterErrors, ThrowOnError>;
+  /**
+   * Get a converter
+   */
+  static getKnowledgeConverter<ThrowOnError extends boolean = false>(options: Options<GetKnowledgeConverterData, ThrowOnError>): RequestResult<GetKnowledgeConverterResponses, GetKnowledgeConverterErrors, ThrowOnError>;
+  /**
+   * 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<ThrowOnError extends boolean = false>(options: Options<UpdateKnowledgeConverterData, ThrowOnError>): RequestResult<UpdateKnowledgeConverterResponses, UpdateKnowledgeConverterErrors, ThrowOnError>;
 }
 declare class Models {
   /**
@@ -7286,4 +7689,4 @@ declare class NaturaliClient {
   constructor({ token, headers }?: NaturaliClientOptions);
 }
 //#endregion
-export { type Acknowledgement, type AddSessionMessageData, type AddSessionMessageError, type AddSessionMessageErrors, type AddSessionMessageResponse, type AddSessionMessageResponses, type Agent, type AgentCreate, type AgentId, type AgentList, type AgentUpdate, Agents, type ApiKeyCreate, type ApiKeyCreated, type ApiKeyId, type ApiKeyList, type ApiKeyRecord, type ApiKeyUpdate, ApiKeys, type AssigneeFilter, Auth, type AuthSession, type Board, type BoardCompletionRule, type BoardCreate, type BoardDispatch, type BoardId, type BoardIdFilter, type BoardList, type BoardOnEnter, type BoardState, type BoardTransition, type BoardUpdate, Boards, type Channel, type ChannelBinding, type ChannelBindingSet, type ChannelCreate, type ChannelId, type ChannelList, type ChannelUpdate, Channels, type ClientOptions, type CollectionId, type Contact, type ContactConversation, type ContactConversationList, type ContactCreate, type ContactId, type ContactIdentity, type ContactIdentityCreate, type ContactList, type ContactMerge, type ContactMergeList, type ContactMergeRequest, type ContactMergeResult, type ContactUpdate, Contacts, type Conversation, type ConversationId, type ConversationList, type ConversationMessage, type ConversationMessageList, type CreateAgentData, type CreateAgentError, type CreateAgentErrors, type CreateAgentResponse, type CreateAgentResponses, type CreateApiKeyData, type CreateApiKeyError, type CreateApiKeyErrors, type CreateApiKeyResponse, type CreateApiKeyResponses, type CreateBoardData, type CreateBoardError, type CreateBoardErrors, type CreateBoardResponse, type CreateBoardResponses, type CreateChannelData, type CreateChannelError, type CreateChannelErrors, type CreateChannelResponse, type CreateChannelResponses, type CreateContactData, type CreateContactError, type CreateContactErrors, type CreateContactIdentityData, type CreateContactIdentityError, type CreateContactIdentityErrors, type CreateContactIdentityResponse, type CreateContactIdentityResponses, type CreateContactResponse, type CreateContactResponses, type CreateGenerationData, type CreateGenerationError, type CreateGenerationErrors, type CreateGenerationResponse, type CreateGenerationResponses, type CreateKnowledgeCollectionData, type CreateKnowledgeCollectionError, type CreateKnowledgeCollectionErrors, type CreateKnowledgeCollectionResponse, type CreateKnowledgeCollectionResponses, type CreateKnowledgeDocumentData, type CreateKnowledgeDocumentError, type CreateKnowledgeDocumentErrors, type CreateKnowledgeDocumentResponse, type CreateKnowledgeDocumentResponses, type CreateProjectData, type CreateProjectError, type CreateProjectErrors, type CreateProjectResponse, type CreateProjectResponses, type CreateProviderData, type CreateProviderError, type CreateProviderErrors, type CreateProviderResponse, type CreateProviderResponses, type CreateSessionData, type CreateSessionError, type CreateSessionErrors, type CreateSessionResponse, type CreateSessionResponses, type CreateTaskData, type CreateTaskError, type CreateTaskErrors, type CreateTaskResponse, type CreateTaskResponses, type CreateToolData, type CreateToolError, type CreateToolErrors, type CreateToolResponse, type CreateToolResponses, type CreateWebhookData, type CreateWebhookError, type CreateWebhookErrors, type CreateWebhookResponse, type CreateWebhookResponses, type Cursor, type DeleteAgentData, type DeleteAgentError, type DeleteAgentErrors, type DeleteAgentResponse, type DeleteAgentResponses, type DeleteApiKeyData, type DeleteApiKeyError, type DeleteApiKeyErrors, type DeleteApiKeyResponse, type DeleteApiKeyResponses, type DeleteBoardData, type DeleteBoardError, type DeleteBoardErrors, type DeleteBoardResponse, type DeleteBoardResponses, type DeleteChannelBindingData, type DeleteChannelBindingError, type DeleteChannelBindingErrors, type DeleteChannelBindingResponse, type DeleteChannelBindingResponses, type DeleteChannelData, type DeleteChannelError, type DeleteChannelErrors, type DeleteChannelResponse, type DeleteChannelResponses, type DeleteContactData, type DeleteContactError, type DeleteContactErrors, type DeleteContactIdentityData, type DeleteContactIdentityError, type DeleteContactIdentityErrors, type DeleteContactIdentityResponse, type DeleteContactIdentityResponses, type DeleteContactResponse, type DeleteContactResponses, type DeleteKnowledgeCollectionData, type DeleteKnowledgeCollectionError, type DeleteKnowledgeCollectionErrors, type DeleteKnowledgeCollectionResponse, type DeleteKnowledgeCollectionResponses, type DeleteKnowledgeDocumentData, type DeleteKnowledgeDocumentError, type DeleteKnowledgeDocumentErrors, type DeleteKnowledgeDocumentResponse, type DeleteKnowledgeDocumentResponses, type DeleteProjectData, type DeleteProjectError, type DeleteProjectErrors, type DeleteProjectResponse, type DeleteProjectResponses, type DeleteProviderData, type DeleteProviderError, type DeleteProviderErrors, type DeleteProviderResponse, type DeleteProviderResponses, type DeleteTaskData, type DeleteTaskError, type DeleteTaskErrors, type DeleteTaskResponse, type DeleteTaskResponses, type DeleteToolData, type DeleteToolError, type DeleteToolErrors, type DeleteToolResponse, type DeleteToolResponses, type DeleteWebhookData, type DeleteWebhookError, type DeleteWebhookErrors, type DeleteWebhookResponse, type DeleteWebhookResponses, type DeliveryId, type DiscordModes, type DocumentId, type ErrorResponse, type Event, type EventSubscription, type EventType, type Force, type GenerateSessionResponseData, type GenerateSessionResponseError, type GenerateSessionResponseErrors, type GenerateSessionResponseResponse, type GenerateSessionResponseResponses, type Generation, type GenerationCreate, type GenerationId, type GenerationList, type GenerationResult, type GenerationStatus, type GenerationUsage, Generations, type GetAgentData, type GetAgentError, type GetAgentErrors, type GetAgentResponse, type GetAgentResponses, type GetApiKeyData, type GetApiKeyError, type GetApiKeyErrors, type GetApiKeyResponse, type GetApiKeyResponses, type GetBoardData, type GetBoardError, type GetBoardErrors, type GetBoardResponse, type GetBoardResponses, type GetChannelBindingData, type GetChannelBindingError, type GetChannelBindingErrors, type GetChannelBindingResponse, type GetChannelBindingResponses, type GetChannelConversationData, type GetChannelConversationError, type GetChannelConversationErrors, type GetChannelConversationResponse, type GetChannelConversationResponses, type GetChannelData, type GetChannelError, type GetChannelErrors, type GetChannelResponse, type GetChannelResponses, type GetContactData, type GetContactError, type GetContactErrors, type GetContactResponse, type GetContactResponses, type GetCurrentUserData, type GetCurrentUserError, type GetCurrentUserErrors, type GetCurrentUserResponse, type GetCurrentUserResponses, type GetGenerationData, type GetGenerationError, type GetGenerationErrors, type GetGenerationResponse, type GetGenerationResponses, type GetGenerationUsageData, type GetGenerationUsageError, type GetGenerationUsageErrors, type GetGenerationUsageResponse, type GetGenerationUsageResponses, type GetKnowledgeCollectionData, type GetKnowledgeCollectionError, type GetKnowledgeCollectionErrors, type GetKnowledgeCollectionResponse, type GetKnowledgeCollectionResponses, type GetKnowledgeDocumentData, type GetKnowledgeDocumentError, type GetKnowledgeDocumentErrors, type GetKnowledgeDocumentResponse, type GetKnowledgeDocumentResponses, type GetModelData, type GetModelError, type GetModelErrors, type GetModelResponse, type GetModelResponses, type GetProjectData, type GetProjectError, type GetProjectErrors, type GetProjectResponse, type GetProjectResponses, type GetProjectUsageData, type GetProjectUsageError, type GetProjectUsageErrors, type GetProjectUsageResponse, type GetProjectUsageResponses, type GetProviderData, type GetProviderError, type GetProviderErrors, type GetProviderResponse, type GetProviderResponses, type GetSessionData, type GetSessionError, type GetSessionErrors, type GetSessionResponse, type GetSessionResponses, type GetTaskData, type GetTaskError, type GetTaskErrors, type GetTaskResponse, type GetTaskResponses, type GetToolData, type GetToolError, type GetToolErrors, type GetToolResponse, type GetToolResponses, type GetTraceData, type GetTraceError, type GetTraceErrors, type GetTraceResponse, type GetTraceResponses, type GetTraceTreeData, type GetTraceTreeError, type GetTraceTreeErrors, type GetTraceTreeResponse, type GetTraceTreeResponses, type GetWebhookData, type GetWebhookDeliveryData, type GetWebhookDeliveryError, type GetWebhookDeliveryErrors, type GetWebhookDeliveryResponse, type GetWebhookDeliveryResponses, type GetWebhookError, type GetWebhookErrors, type GetWebhookResponse, type GetWebhookResponses, type HttpExecute, type IdempotencyKey, type IdentityId, Knowledge, type KnowledgeChunk, type KnowledgeCollection, type KnowledgeCollectionCreate, type KnowledgeCollectionList, type KnowledgeCollectionUpdate, type KnowledgeDocument, type KnowledgeDocumentCreate, type KnowledgeDocumentList, type KnowledgeQueryRequest, type KnowledgeQueryResult, type Limit, type ListAgentGenerationsData, type ListAgentGenerationsError, type ListAgentGenerationsErrors, type ListAgentGenerationsResponse, type ListAgentGenerationsResponses, type ListAgentsData, type ListAgentsError, type ListAgentsErrors, type ListAgentsResponse, type ListAgentsResponses, type ListApiKeysData, type ListApiKeysError, type ListApiKeysErrors, type ListApiKeysResponse, type ListApiKeysResponses, type ListBoardsData, type ListBoardsError, type ListBoardsErrors, type ListBoardsResponse, type ListBoardsResponses, type ListChannelConversationMessagesData, type ListChannelConversationMessagesError, type ListChannelConversationMessagesErrors, type ListChannelConversationMessagesResponse, type ListChannelConversationMessagesResponses, type ListChannelConversationsData, type ListChannelConversationsError, type ListChannelConversationsErrors, type ListChannelConversationsResponse, type ListChannelConversationsResponses, type ListChannelsData, type ListChannelsError, type ListChannelsErrors, type ListChannelsResponse, type ListChannelsResponses, type ListContactConversationsData, type ListContactConversationsError, type ListContactConversationsErrors, type ListContactConversationsResponse, type ListContactConversationsResponses, type ListContactMergesData, type ListContactMergesError, type ListContactMergesErrors, type ListContactMergesResponse, type ListContactMergesResponses, type ListContactsData, type ListContactsError, type ListContactsErrors, type ListContactsResponse, type ListContactsResponses, type ListKnowledgeCollectionsData, type ListKnowledgeCollectionsError, type ListKnowledgeCollectionsErrors, type ListKnowledgeCollectionsResponse, type ListKnowledgeCollectionsResponses, type ListKnowledgeDocumentsData, type ListKnowledgeDocumentsError, type ListKnowledgeDocumentsErrors, type ListKnowledgeDocumentsResponse, type ListKnowledgeDocumentsResponses, type ListModelsData, type ListModelsError, type ListModelsErrors, type ListModelsResponse, type ListModelsResponses, type ListProjectsData, type ListProjectsError, type ListProjectsErrors, type ListProjectsResponse, type ListProjectsResponses, type ListProvidersData, type ListProvidersError, type ListProvidersErrors, type ListProvidersResponse, type ListProvidersResponses, type ListTaskTransitionsData, type ListTaskTransitionsError, type ListTaskTransitionsErrors, type ListTaskTransitionsResponse, type ListTaskTransitionsResponses, type ListTasksData, type ListTasksError, type ListTasksErrors, type ListTasksResponse, type ListTasksResponses, type ListToolsData, type ListToolsError, type ListToolsErrors, type ListToolsResponse, type ListToolsResponses, type ListTraceGenerationsData, type ListTraceGenerationsError, type ListTraceGenerationsErrors, type ListTraceGenerationsResponse, type ListTraceGenerationsResponses, type ListTracesData, type ListTracesError, type ListTracesErrors, type ListTracesResponse, type ListTracesResponses, type ListWebhookDeliveriesData, type ListWebhookDeliveriesError, type ListWebhookDeliveriesErrors, type ListWebhookDeliveriesResponse, type ListWebhookDeliveriesResponses, type ListWebhooksData, type ListWebhooksError, type ListWebhooksErrors, type ListWebhooksResponse, type ListWebhooksResponses, type LogoutData, type LogoutError, type LogoutErrors, type LogoutRequest, type LogoutResponse, type LogoutResponses, type McpConfig, type MergeContactData, type MergeContactError, type MergeContactErrors, type MergeContactResponse, type MergeContactResponses, type MergeId, type Message, type MessagesLimit, type Model, type ModelList, Models, NaturaliClient, type NaturaliClientOptions, type Offset, type Options, type Project, type ProjectCreate, type ProjectId, type ProjectList, type ProjectUpdate, type ProjectUsage, Projects, type Provider, type ProviderCreate, type ProviderId, type ProviderList, type ProviderUpdate, Providers, type QueryKnowledgeCollectionData, type QueryKnowledgeCollectionError, type QueryKnowledgeCollectionErrors, type QueryKnowledgeCollectionResponse, type QueryKnowledgeCollectionResponses, type RedeliverWebhookDeliveryData, type RedeliverWebhookDeliveryError, type RedeliverWebhookDeliveryErrors, type RedeliverWebhookDeliveryResponse, type RedeliverWebhookDeliveryResponses, type RefreshRequest, type RefreshSessionData, type RefreshSessionError, type RefreshSessionErrors, type RefreshSessionResponse, type RefreshSessionResponses, type ReingestKnowledgeDocumentData, type ReingestKnowledgeDocumentError, type ReingestKnowledgeDocumentErrors, type ReingestKnowledgeDocumentResponse, type ReingestKnowledgeDocumentResponses, type RequestSignInCodeData, type RequestSignInCodeError, type RequestSignInCodeErrors, type RequestSignInCodeResponse, type RequestSignInCodeResponses, type RevertContactMergeData, type RevertContactMergeError, type RevertContactMergeErrors, type RevertContactMergeResponse, type RevertContactMergeResponses, type RotateApiKeyData, type RotateApiKeyError, type RotateApiKeyErrors, type RotateApiKeyResponse, type RotateApiKeyResponses, type RotateWebhookSecretData, type RotateWebhookSecretError, type RotateWebhookSecretErrors, type RotateWebhookSecretResponse, type RotateWebhookSecretResponses, type Session, type SessionCreate, type SessionGenerate, type SessionGeneration, type SessionId, type SessionMessage, type SessionMessageCreate, Sessions, type SetChannelBindingData, type SetChannelBindingError, type SetChannelBindingErrors, type SetChannelBindingResponse, type SetChannelBindingResponses, type SignInCodeRequest, type SignInCodeVerify, type StateFilter, type StatusFilter, type Task, type TaskCreate, type TaskId, type TaskList, type TaskTransitionList, type TaskTransitionRecord, type TaskTransitionRequest, type TaskUpdate, Tasks, type Tool, type ToolChoice, type ToolContext, type ToolCreate, type ToolId, type ToolList, type ToolUpdate, Tools, type Trace, type TraceId, type TraceList, type TraceTreeNode, Traces, type TransitionTaskData, type TransitionTaskError, type TransitionTaskErrors, type TransitionTaskResponse, type TransitionTaskResponses, type UpdateAgentData, type UpdateAgentError, type UpdateAgentErrors, type UpdateAgentResponse, type UpdateAgentResponses, type UpdateApiKeyData, type UpdateApiKeyError, type UpdateApiKeyErrors, type UpdateApiKeyResponse, type UpdateApiKeyResponses, type UpdateBoardData, type UpdateBoardError, type UpdateBoardErrors, type UpdateBoardResponse, type UpdateBoardResponses, type UpdateChannelData, type UpdateChannelError, type UpdateChannelErrors, type UpdateChannelResponse, type UpdateChannelResponses, type UpdateContactData, type UpdateContactError, type UpdateContactErrors, type UpdateContactResponse, type UpdateContactResponses, type UpdateKnowledgeCollectionData, type UpdateKnowledgeCollectionError, type UpdateKnowledgeCollectionErrors, type UpdateKnowledgeCollectionResponse, type UpdateKnowledgeCollectionResponses, type UpdateProjectData, type UpdateProjectError, type UpdateProjectErrors, type UpdateProjectResponse, type UpdateProjectResponses, type UpdateProviderData, type UpdateProviderError, type UpdateProviderErrors, type UpdateProviderResponse, type UpdateProviderResponses, type UpdateTaskData, type UpdateTaskError, type UpdateTaskErrors, type UpdateTaskResponse, type UpdateTaskResponses, type UpdateToolData, type UpdateToolError, type UpdateToolErrors, type UpdateToolResponse, type UpdateToolResponses, type UpdateWebhookData, type UpdateWebhookError, type UpdateWebhookErrors, type UpdateWebhookResponse, type UpdateWebhookResponses, type UsageGroup, type UsageTokens, type User, type VerifySignInCodeData, type VerifySignInCodeError, type VerifySignInCodeErrors, type VerifySignInCodeResponse, type VerifySignInCodeResponses, type Webhook, type WebhookCreate, type WebhookDelivery, type WebhookDeliveryList, type WebhookId, type WebhookList, type WebhookUpdate, type WebhookWithSecret, Webhooks, createClient, createConfig };
+export { type Acknowledgement, type AddSessionMessageData, type AddSessionMessageError, type AddSessionMessageErrors, type AddSessionMessageResponse, type AddSessionMessageResponses, type Agent, type AgentCreate, type AgentId, type AgentList, type AgentUpdate, Agents, type ApiKeyCreate, type ApiKeyCreated, type ApiKeyId, type ApiKeyList, type ApiKeyRecord, type ApiKeyUpdate, ApiKeys, type AssigneeFilter, Auth, type AuthSession, type Board, type BoardCompletionRule, type BoardCreate, type BoardDispatch, type BoardId, type BoardIdFilter, type BoardList, type BoardOnEnter, type BoardState, type BoardTransition, type BoardUpdate, Boards, type Channel, type ChannelBinding, type ChannelBindingSet, type ChannelCreate, type ChannelId, type ChannelList, type ChannelUpdate, Channels, type ClientOptions, type CollectionId, type Contact, type ContactConversation, type ContactConversationList, type ContactCreate, type ContactId, type ContactIdentity, type ContactIdentityCreate, type ContactList, type ContactMerge, type ContactMergeList, type ContactMergeRequest, type ContactMergeResult, type ContactUpdate, Contacts, type Conversation, type ConversationId, type ConversationList, type ConversationMessage, type ConversationMessageList, type ConverterId, type CreateAgentData, type CreateAgentError, type CreateAgentErrors, type CreateAgentResponse, type CreateAgentResponses, type CreateApiKeyData, type CreateApiKeyError, type CreateApiKeyErrors, type CreateApiKeyResponse, type CreateApiKeyResponses, type CreateBoardData, type CreateBoardError, type CreateBoardErrors, type CreateBoardResponse, type CreateBoardResponses, type CreateChannelData, type CreateChannelError, type CreateChannelErrors, type CreateChannelResponse, type CreateChannelResponses, type CreateContactData, type CreateContactError, type CreateContactErrors, type CreateContactIdentityData, type CreateContactIdentityError, type CreateContactIdentityErrors, type CreateContactIdentityResponse, type CreateContactIdentityResponses, type CreateContactResponse, type CreateContactResponses, type CreateGenerationData, type CreateGenerationError, type CreateGenerationErrors, type CreateGenerationResponse, type CreateGenerationResponses, type CreateKnowledgeCollectionData, type CreateKnowledgeCollectionError, type CreateKnowledgeCollectionErrors, type CreateKnowledgeCollectionResponse, type CreateKnowledgeCollectionResponses, type CreateKnowledgeConverterData, type CreateKnowledgeConverterError, type CreateKnowledgeConverterErrors, type CreateKnowledgeConverterResponse, type CreateKnowledgeConverterResponses, type CreateKnowledgeDocumentData, type CreateKnowledgeDocumentError, type CreateKnowledgeDocumentErrors, type CreateKnowledgeDocumentResponse, type CreateKnowledgeDocumentResponses, type CreateProjectData, type CreateProjectError, type CreateProjectErrors, type CreateProjectResponse, type CreateProjectResponses, type CreateProviderData, type CreateProviderError, type CreateProviderErrors, type CreateProviderResponse, type CreateProviderResponses, type CreateSessionData, type CreateSessionError, type CreateSessionErrors, type CreateSessionResponse, type CreateSessionResponses, type CreateTaskData, type CreateTaskError, type CreateTaskErrors, type CreateTaskResponse, type CreateTaskResponses, type CreateToolData, type CreateToolError, type CreateToolErrors, type CreateToolResponse, type CreateToolResponses, type CreateWebhookData, type CreateWebhookError, type CreateWebhookErrors, type CreateWebhookResponse, type CreateWebhookResponses, type Cursor, type DeleteAgentData, type DeleteAgentError, type DeleteAgentErrors, type DeleteAgentResponse, type DeleteAgentResponses, type DeleteApiKeyData, type DeleteApiKeyError, type DeleteApiKeyErrors, type DeleteApiKeyResponse, type DeleteApiKeyResponses, type DeleteBoardData, type DeleteBoardError, type DeleteBoardErrors, type DeleteBoardResponse, type DeleteBoardResponses, type DeleteChannelBindingData, type DeleteChannelBindingError, type DeleteChannelBindingErrors, type DeleteChannelBindingResponse, type DeleteChannelBindingResponses, type DeleteChannelData, type DeleteChannelError, type DeleteChannelErrors, type DeleteChannelResponse, type DeleteChannelResponses, type DeleteContactData, type DeleteContactError, type DeleteContactErrors, type DeleteContactIdentityData, type DeleteContactIdentityError, type DeleteContactIdentityErrors, type DeleteContactIdentityResponse, type DeleteContactIdentityResponses, type DeleteContactResponse, type DeleteContactResponses, type DeleteKnowledgeCollectionData, type DeleteKnowledgeCollectionError, type DeleteKnowledgeCollectionErrors, type DeleteKnowledgeCollectionResponse, type DeleteKnowledgeCollectionResponses, type DeleteKnowledgeConverterData, type DeleteKnowledgeConverterError, type DeleteKnowledgeConverterErrors, type DeleteKnowledgeConverterResponse, type DeleteKnowledgeConverterResponses, type DeleteKnowledgeDocumentData, type DeleteKnowledgeDocumentError, type DeleteKnowledgeDocumentErrors, type DeleteKnowledgeDocumentResponse, type DeleteKnowledgeDocumentResponses, type DeleteProjectData, type DeleteProjectError, type DeleteProjectErrors, type DeleteProjectResponse, type DeleteProjectResponses, type DeleteProviderData, type DeleteProviderError, type DeleteProviderErrors, type DeleteProviderResponse, type DeleteProviderResponses, type DeleteTaskData, type DeleteTaskError, type DeleteTaskErrors, type DeleteTaskResponse, type DeleteTaskResponses, type DeleteToolData, type DeleteToolError, type DeleteToolErrors, type DeleteToolResponse, type DeleteToolResponses, type DeleteWebhookData, type DeleteWebhookError, type DeleteWebhookErrors, type DeleteWebhookResponse, type DeleteWebhookResponses, type DeliveryId, type DiscordModes, type DocumentId, type ErrorResponse, type Event, type EventSubscription, type EventType, type Force, type GenerateSessionResponseData, type GenerateSessionResponseError, type GenerateSessionResponseErrors, type GenerateSessionResponseResponse, type GenerateSessionResponseResponses, type Generation, type GenerationCreate, type GenerationId, type GenerationList, type GenerationResult, type GenerationStatus, type GenerationUsage, Generations, type GetAgentData, type GetAgentError, type GetAgentErrors, type GetAgentResponse, type GetAgentResponses, type GetApiKeyData, type GetApiKeyError, type GetApiKeyErrors, type GetApiKeyResponse, type GetApiKeyResponses, type GetBoardData, type GetBoardError, type GetBoardErrors, type GetBoardResponse, type GetBoardResponses, type GetChannelBindingData, type GetChannelBindingError, type GetChannelBindingErrors, type GetChannelBindingResponse, type GetChannelBindingResponses, type GetChannelConversationData, type GetChannelConversationError, type GetChannelConversationErrors, type GetChannelConversationResponse, type GetChannelConversationResponses, type GetChannelData, type GetChannelError, type GetChannelErrors, type GetChannelResponse, type GetChannelResponses, type GetContactData, type GetContactError, type GetContactErrors, type GetContactResponse, type GetContactResponses, type GetCurrentUserData, type GetCurrentUserError, type GetCurrentUserErrors, type GetCurrentUserResponse, type GetCurrentUserResponses, type GetGenerationData, type GetGenerationError, type GetGenerationErrors, type GetGenerationResponse, type GetGenerationResponses, type GetGenerationUsageData, type GetGenerationUsageError, type GetGenerationUsageErrors, type GetGenerationUsageResponse, type GetGenerationUsageResponses, type GetKnowledgeCollectionData, type GetKnowledgeCollectionError, type GetKnowledgeCollectionErrors, type GetKnowledgeCollectionResponse, type GetKnowledgeCollectionResponses, type GetKnowledgeConverterData, type GetKnowledgeConverterError, type GetKnowledgeConverterErrors, type GetKnowledgeConverterResponse, type GetKnowledgeConverterResponses, type GetKnowledgeDocumentData, type GetKnowledgeDocumentError, type GetKnowledgeDocumentErrors, type GetKnowledgeDocumentResponse, type GetKnowledgeDocumentResponses, type GetModelData, type GetModelError, type GetModelErrors, type GetModelResponse, type GetModelResponses, type GetProjectData, type GetProjectError, type GetProjectErrors, type GetProjectResponse, type GetProjectResponses, type GetProjectUsageData, type GetProjectUsageError, type GetProjectUsageErrors, type GetProjectUsageResponse, type GetProjectUsageResponses, type GetProviderData, type GetProviderError, type GetProviderErrors, type GetProviderResponse, type GetProviderResponses, type GetSessionData, type GetSessionError, type GetSessionErrors, type GetSessionResponse, type GetSessionResponses, type GetTaskData, type GetTaskError, type GetTaskErrors, type GetTaskResponse, type GetTaskResponses, type GetToolData, type GetToolError, type GetToolErrors, type GetToolResponse, type GetToolResponses, type GetTraceData, type GetTraceError, type GetTraceErrors, type GetTraceResponse, type GetTraceResponses, type GetTraceTreeData, type GetTraceTreeError, type GetTraceTreeErrors, type GetTraceTreeResponse, type GetTraceTreeResponses, type GetWebhookData, type GetWebhookDeliveryData, type GetWebhookDeliveryError, type GetWebhookDeliveryErrors, type GetWebhookDeliveryResponse, type GetWebhookDeliveryResponses, type GetWebhookError, type GetWebhookErrors, type GetWebhookResponse, type GetWebhookResponses, type HttpExecute, type IdempotencyKey, type IdentityId, Knowledge, type KnowledgeChunk, type KnowledgeCollection, type KnowledgeCollectionCreate, type KnowledgeCollectionList, type KnowledgeCollectionUpdate, type KnowledgeConverter, type KnowledgeConverterCreate, type KnowledgeConverterList, type KnowledgeConverterUpdate, type KnowledgeDocument, type KnowledgeDocumentCreate, type KnowledgeDocumentList, type KnowledgeQueryRequest, type KnowledgeQueryResult, type Limit, type ListAgentGenerationsData, type ListAgentGenerationsError, type ListAgentGenerationsErrors, type ListAgentGenerationsResponse, type ListAgentGenerationsResponses, type ListAgentsData, type ListAgentsError, type ListAgentsErrors, type ListAgentsResponse, type ListAgentsResponses, type ListApiKeysData, type ListApiKeysError, type ListApiKeysErrors, type ListApiKeysResponse, type ListApiKeysResponses, type ListBoardsData, type ListBoardsError, type ListBoardsErrors, type ListBoardsResponse, type ListBoardsResponses, type ListChannelConversationMessagesData, type ListChannelConversationMessagesError, type ListChannelConversationMessagesErrors, type ListChannelConversationMessagesResponse, type ListChannelConversationMessagesResponses, type ListChannelConversationsData, type ListChannelConversationsError, type ListChannelConversationsErrors, type ListChannelConversationsResponse, type ListChannelConversationsResponses, type ListChannelsData, type ListChannelsError, type ListChannelsErrors, type ListChannelsResponse, type ListChannelsResponses, type ListContactConversationsData, type ListContactConversationsError, type ListContactConversationsErrors, type ListContactConversationsResponse, type ListContactConversationsResponses, type ListContactMergesData, type ListContactMergesError, type ListContactMergesErrors, type ListContactMergesResponse, type ListContactMergesResponses, type ListContactsData, type ListContactsError, type ListContactsErrors, type ListContactsResponse, type ListContactsResponses, type ListKnowledgeCollectionsData, type ListKnowledgeCollectionsError, type ListKnowledgeCollectionsErrors, type ListKnowledgeCollectionsResponse, type ListKnowledgeCollectionsResponses, type ListKnowledgeConvertersData, type ListKnowledgeConvertersError, type ListKnowledgeConvertersErrors, type ListKnowledgeConvertersResponse, type ListKnowledgeConvertersResponses, type ListKnowledgeDocumentsData, type ListKnowledgeDocumentsError, type ListKnowledgeDocumentsErrors, type ListKnowledgeDocumentsResponse, type ListKnowledgeDocumentsResponses, type ListModelsData, type ListModelsError, type ListModelsErrors, type ListModelsResponse, type ListModelsResponses, type ListProjectsData, type ListProjectsError, type ListProjectsErrors, type ListProjectsResponse, type ListProjectsResponses, type ListProvidersData, type ListProvidersError, type ListProvidersErrors, type ListProvidersResponse, type ListProvidersResponses, type ListTaskTransitionsData, type ListTaskTransitionsError, type ListTaskTransitionsErrors, type ListTaskTransitionsResponse, type ListTaskTransitionsResponses, type ListTasksData, type ListTasksError, type ListTasksErrors, type ListTasksResponse, type ListTasksResponses, type ListToolsData, type ListToolsError, type ListToolsErrors, type ListToolsResponse, type ListToolsResponses, type ListTraceGenerationsData, type ListTraceGenerationsError, type ListTraceGenerationsErrors, type ListTraceGenerationsResponse, type ListTraceGenerationsResponses, type ListTracesData, type ListTracesError, type ListTracesErrors, type ListTracesResponse, type ListTracesResponses, type ListWebhookDeliveriesData, type ListWebhookDeliveriesError, type ListWebhookDeliveriesErrors, type ListWebhookDeliveriesResponse, type ListWebhookDeliveriesResponses, type ListWebhooksData, type ListWebhooksError, type ListWebhooksErrors, type ListWebhooksResponse, type ListWebhooksResponses, type LogoutData, type LogoutError, type LogoutErrors, type LogoutRequest, type LogoutResponse, type LogoutResponses, type McpConfig, type MergeContactData, type MergeContactError, type MergeContactErrors, type MergeContactResponse, type MergeContactResponses, type MergeId, type Message, type MessagesLimit, type Model, type ModelList, Models, NaturaliClient, type NaturaliClientOptions, type Offset, type Options, type Project, type ProjectCreate, type ProjectId, type ProjectList, type ProjectUpdate, type ProjectUsage, Projects, type Provider, type ProviderCreate, type ProviderId, type ProviderList, type ProviderUpdate, Providers, type QueryKnowledgeCollectionData, type QueryKnowledgeCollectionError, type QueryKnowledgeCollectionErrors, type QueryKnowledgeCollectionResponse, type QueryKnowledgeCollectionResponses, type RedeliverWebhookDeliveryData, type RedeliverWebhookDeliveryError, type RedeliverWebhookDeliveryErrors, type RedeliverWebhookDeliveryResponse, type RedeliverWebhookDeliveryResponses, type RefreshRequest, type RefreshSessionData, type RefreshSessionError, type RefreshSessionErrors, type RefreshSessionResponse, type RefreshSessionResponses, type ReingestKnowledgeDocumentData, type ReingestKnowledgeDocumentError, type ReingestKnowledgeDocumentErrors, type ReingestKnowledgeDocumentResponse, type ReingestKnowledgeDocumentResponses, type RequestSignInCodeData, type RequestSignInCodeError, type RequestSignInCodeErrors, type RequestSignInCodeResponse, type RequestSignInCodeResponses, type RevertContactMergeData, type RevertContactMergeError, type RevertContactMergeErrors, type RevertContactMergeResponse, type RevertContactMergeResponses, type RotateApiKeyData, type RotateApiKeyError, type RotateApiKeyErrors, type RotateApiKeyResponse, type RotateApiKeyResponses, type RotateWebhookSecretData, type RotateWebhookSecretError, type RotateWebhookSecretErrors, type RotateWebhookSecretResponse, type RotateWebhookSecretResponses, type Session, type SessionCreate, type SessionGenerate, type SessionGeneration, type SessionId, type SessionMessage, type SessionMessageCreate, Sessions, type SetChannelBindingData, type SetChannelBindingError, type SetChannelBindingErrors, type SetChannelBindingResponse, type SetChannelBindingResponses, type SignInCodeRequest, type SignInCodeVerify, type StateFilter, type StatusFilter, type Task, type TaskCreate, type TaskId, type TaskList, type TaskTransitionList, type TaskTransitionRecord, type TaskTransitionRequest, type TaskUpdate, Tasks, type Tool, type ToolChoice, type ToolContext, type ToolCreate, type ToolId, type ToolList, type ToolUpdate, Tools, type Trace, type TraceId, type TraceList, type TraceTreeNode, Traces, type TransitionTaskData, type TransitionTaskError, type TransitionTaskErrors, type TransitionTaskResponse, type TransitionTaskResponses, type UpdateAgentData, type UpdateAgentError, type UpdateAgentErrors, type UpdateAgentResponse, type UpdateAgentResponses, type UpdateApiKeyData, type UpdateApiKeyError, type UpdateApiKeyErrors, type UpdateApiKeyResponse, type UpdateApiKeyResponses, type UpdateBoardData, type UpdateBoardError, type UpdateBoardErrors, type UpdateBoardResponse, type UpdateBoardResponses, type UpdateChannelData, type UpdateChannelError, type UpdateChannelErrors, type UpdateChannelResponse, type UpdateChannelResponses, type UpdateContactData, type UpdateContactError, type UpdateContactErrors, type UpdateContactResponse, type UpdateContactResponses, type UpdateKnowledgeCollectionData, type UpdateKnowledgeCollectionError, type UpdateKnowledgeCollectionErrors, type UpdateKnowledgeCollectionResponse, type UpdateKnowledgeCollectionResponses, type UpdateKnowledgeConverterData, type UpdateKnowledgeConverterError, type UpdateKnowledgeConverterErrors, type UpdateKnowledgeConverterResponse, type UpdateKnowledgeConverterResponses, type UpdateProjectData, type UpdateProjectError, type UpdateProjectErrors, type UpdateProjectResponse, type UpdateProjectResponses, type UpdateProviderData, type UpdateProviderError, type UpdateProviderErrors, type UpdateProviderResponse, type UpdateProviderResponses, type UpdateTaskData, type UpdateTaskError, type UpdateTaskErrors, type UpdateTaskResponse, type UpdateTaskResponses, type UpdateToolData, type UpdateToolError, type UpdateToolErrors, type UpdateToolResponse, type UpdateToolResponses, type UpdateWebhookData, type UpdateWebhookError, type UpdateWebhookErrors, type UpdateWebhookResponse, type UpdateWebhookResponses, type UsageGroup, type UsageTokens, type User, type VerifySignInCodeData, type VerifySignInCodeError, type VerifySignInCodeErrors, type VerifySignInCodeResponse, type VerifySignInCodeResponses, type Webhook, type WebhookCreate, type WebhookDelivery, type WebhookDeliveryList, type WebhookId, type WebhookList, type WebhookUpdate, type WebhookWithSecret, Webhooks, createClient, createConfig };

package/dist/index.mjs

@@ -1343,7 +1343,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) {
@@ -1388,6 +1392,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 {
 	/**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.41.0",
+  "version": "0.42.1",
   "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.41.0"
+    "@naturali/api": "0.42.1"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",