telnyx 7.17.0 → 7.19.0

package/resources/ai/index.js

@@ -1,7 +1,7 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Tools = exports.OpenAI = exports.Missions = exports.McpServers = exports.Integrations = exports.FineTuning = exports.Embeddings = exports.Conversations = exports.Collections = exports.Clusters = exports.Chat = exports.Audio = exports.Assistants = exports.Anthropic = exports.AI = void 0;
+exports.Tools = exports.OpenAI = exports.Missions = exports.McpServers = exports.Knowledge = exports.Integrations = exports.FineTuning = exports.Embeddings = exports.Conversations = exports.Collections = exports.Clusters = exports.Chat = exports.Audio = exports.Assistants = exports.Anthropic = exports.AI = void 0;
 var ai_1 = require("./ai.js");
 Object.defineProperty(exports, "AI", { enumerable: true, get: function () { return ai_1.AI; } });
 var index_1 = require("./anthropic/index.js");
@@ -24,12 +24,14 @@ var index_6 = require("./fine-tuning/index.js");
 Object.defineProperty(exports, "FineTuning", { enumerable: true, get: function () { return index_6.FineTuning; } });
 var index_7 = require("./integrations/index.js");
 Object.defineProperty(exports, "Integrations", { enumerable: true, get: function () { return index_7.Integrations; } });
+var index_8 = require("./knowledge/index.js");
+Object.defineProperty(exports, "Knowledge", { enumerable: true, get: function () { return index_8.Knowledge; } });
 var mcp_servers_1 = require("./mcp-servers.js");
 Object.defineProperty(exports, "McpServers", { enumerable: true, get: function () { return mcp_servers_1.McpServers; } });
-var index_8 = require("./missions/index.js");
-Object.defineProperty(exports, "Missions", { enumerable: true, get: function () { return index_8.Missions; } });
-var index_9 = require("./openai/index.js");
-Object.defineProperty(exports, "OpenAI", { enumerable: true, get: function () { return index_9.OpenAI; } });
+var index_9 = require("./missions/index.js");
+Object.defineProperty(exports, "Missions", { enumerable: true, get: function () { return index_9.Missions; } });
+var index_10 = require("./openai/index.js");
+Object.defineProperty(exports, "OpenAI", { enumerable: true, get: function () { return index_10.OpenAI; } });
 var tools_1 = require("./tools.js");
 Object.defineProperty(exports, "Tools", { enumerable: true, get: function () { return tools_1.Tools; } });
 //# sourceMappingURL=index.js.map

package/resources/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/ai/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,8BASc;AARZ,wFAAA,EAAE,OAAA;AASJ,8CAA8C;AAArC,kGAAA,SAAS,OAAA;AAClB,+CAgE4B;AA/D1B,mGAAA,UAAU,OAAA;AAgEZ,oCAA0F;AAAjF,8FAAA,KAAK,OAAA;AACd,kCAA0E;AAAjE,4FAAA,IAAI,OAAA;AACb,0CAWoB;AAVlB,oGAAA,QAAQ,OAAA;AAWV,gDAW6B;AAV3B,oGAAA,WAAW,OAAA;AAWb,kDAW+B;AAV7B,sGAAA,aAAa,OAAA;AAWf,+CAW4B;AAV1B,mGAAA,UAAU,OAAA;AAWZ,gDAAiD;AAAxC,mGAAA,UAAU,OAAA;AACnB,iDAAoG;AAA3F,qGAAA,YAAY,OAAA;AACrB,gDAOuB;AANrB,yGAAA,UAAU,OAAA;AAOZ,6CAY0B;AAXxB,iGAAA,QAAQ,OAAA;AAYV,2CAA4G;AAAnG,+FAAA,MAAM,OAAA;AACf,oCAUiB;AATf,8FAAA,KAAK,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/ai/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,8BASc;AARZ,wFAAA,EAAE,OAAA;AASJ,8CAA8C;AAArC,kGAAA,SAAS,OAAA;AAClB,+CAgE4B;AA/D1B,mGAAA,UAAU,OAAA;AAgEZ,oCAA0F;AAAjF,8FAAA,KAAK,OAAA;AACd,kCAA0E;AAAjE,4FAAA,IAAI,OAAA;AACb,0CAWoB;AAVlB,oGAAA,QAAQ,OAAA;AAWV,gDAQ6B;AAP3B,oGAAA,WAAW,OAAA;AAQb,kDAW+B;AAV7B,sGAAA,aAAa,OAAA;AAWf,+CAW4B;AAV1B,mGAAA,UAAU,OAAA;AAWZ,gDAAiD;AAAxC,mGAAA,UAAU,OAAA;AACnB,iDAAoG;AAA3F,qGAAA,YAAY,OAAA;AACrB,8CAA8C;AAArC,kGAAA,SAAS,OAAA;AAClB,gDAOuB;AANrB,yGAAA,UAAU,OAAA;AAOZ,6CAY0B;AAXxB,iGAAA,QAAQ,OAAA;AAYV,4CAA4G;AAAnG,gGAAA,MAAM,OAAA;AACf,oCAUiB;AATf,8FAAA,KAAK,OAAA"}

package/resources/ai/index.mjs

@@ -10,6 +10,7 @@ export { Conversations, } from "./conversations/index.mjs";
 export { Embeddings, } from "./embeddings/index.mjs";
 export { FineTuning } from "./fine-tuning/index.mjs";
 export { Integrations } from "./integrations/index.mjs";
+export { Knowledge } from "./knowledge/index.mjs";
 export { McpServers, } from "./mcp-servers.mjs";
 export { Missions, } from "./missions/index.mjs";
 export { OpenAI } from "./openai/index.mjs";

package/resources/ai/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/ai/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACL,EAAE,GAQH,iBAAa;AACd,OAAO,EAAE,SAAS,EAAE,8BAA0B;AAC9C,OAAO,EACL,UAAU,GA+DX,+BAA2B;AAC5B,OAAO,EAAE,KAAK,EAA4D,oBAAgB;AAC1F,OAAO,EAAE,IAAI,EAA8C,mBAAe;AAC1E,OAAO,EACL,QAAQ,GAUT,uBAAmB;AACpB,OAAO,EACL,WAAW,GAUZ,gCAA4B;AAC7B,OAAO,EACL,aAAa,GAUd,kCAA8B;AAC/B,OAAO,EACL,UAAU,GAUX,+BAA2B;AAC5B,OAAO,EAAE,UAAU,EAAE,gCAA4B;AACjD,OAAO,EAAE,YAAY,EAAkD,iCAA6B;AACpG,OAAO,EACL,UAAU,GAMX,0BAAsB;AACvB,OAAO,EACL,QAAQ,GAWT,6BAAyB;AAC1B,OAAO,EAAE,MAAM,EAAsE,2BAAuB;AAC5G,OAAO,EACL,KAAK,GASN,oBAAgB"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/ai/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACL,EAAE,GAQH,iBAAa;AACd,OAAO,EAAE,SAAS,EAAE,8BAA0B;AAC9C,OAAO,EACL,UAAU,GA+DX,+BAA2B;AAC5B,OAAO,EAAE,KAAK,EAA4D,oBAAgB;AAC1F,OAAO,EAAE,IAAI,EAA8C,mBAAe;AAC1E,OAAO,EACL,QAAQ,GAUT,uBAAmB;AACpB,OAAO,EACL,WAAW,GAOZ,gCAA4B;AAC7B,OAAO,EACL,aAAa,GAUd,kCAA8B;AAC/B,OAAO,EACL,UAAU,GAUX,+BAA2B;AAC5B,OAAO,EAAE,UAAU,EAAE,gCAA4B;AACjD,OAAO,EAAE,YAAY,EAAkD,iCAA6B;AACpG,OAAO,EAAE,SAAS,EAAE,8BAA0B;AAC9C,OAAO,EACL,UAAU,GAMX,0BAAsB;AACvB,OAAO,EACL,QAAQ,GAWT,6BAAyB;AAC1B,OAAO,EAAE,MAAM,EAAsE,2BAAuB;AAC5G,OAAO,EACL,KAAK,GASN,oBAAgB"}

package/resources/ai/knowledge/collections.d.mts

@@ -0,0 +1,140 @@
+import { APIResource } from "../../../core/resource.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+/**
+ * Create and manage logical collections of your Telnyx data, tune retrieval settings, manage sources, and run collection-scoped semantic search.
+ */
+export declare class Collections extends APIResource {
+    /**
+     * Runs search over the documents in a collection, ranked by relevance to `query`.
+     * Searches currently run `vector` retrieval (semantic similarity). The
+     * collection's `retrieval_type` setting is the forward-compatible selector:
+     * `hybrid` (vector similarity fused with keyword matching) can be set but cannot
+     * be searched yet, and `keyword` (lexical BM25 matching) is not accepted yet --
+     * setting it returns 422 `unsupported_retrieval_type`. A per-request
+     * `retrieval_type` is accepted but ignored; `meta.retrieval_type` echoes the mode
+     * that actually ran. When `query` is omitted, returns a plain catalog listing of
+     * the collection's documents.
+     *
+     * **How it works:**
+     *
+     * 1. The `query` text is embedded into a 1024-dimensional vector using the
+     *    multilingual-e5-large model.
+     * 2. The embedding is compared against the collection's indexed document chunks
+     *    using semantic similarity. When `hybrid` and `keyword` execution ship, those
+     *    scores will be fused with, or replaced by, lexical BM25 matching.
+     * 3. Results are ranked by `score` (descending) and paginated via `page[number]` /
+     *    `page[size]`.
+     *
+     * **Authentication:** Requires a Telnyx API key via `Authorization: Bearer <key>`.
+     * Results are automatically scoped to your organization and cannot be overridden.
+     *
+     * **Filtering:** Use `filter[field][operator]=value` query parameters to narrow
+     * results before search. Supported operators: `eq` (default), `in`, `gte`, `gt`,
+     * `lte`, `lt`, `contains`. Metadata fields resolve to `metadata.<field>`.
+     *
+     * **Examples:**
+     *
+     * - `GET /v2/ai/knowledge/collections/my-collection/documents?query=billing+issue&top_k=10`
+     * - `GET /v2/ai/knowledge/collections/my-collection/documents?query=refund&sources=voice,message`
+     * - `GET /v2/ai/knowledge/collections/my-collection/documents?query=outage&filter[record_created_at][gte]=2026-01-01T00:00:00Z`
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.ai.knowledge.collections.retrieveDocuments(
+     *     'support-transcripts',
+     *   );
+     * ```
+     */
+    retrieveDocuments(slug: string, query?: CollectionRetrieveDocumentsParams | null | undefined, options?: RequestOptions): APIPromise<CollectionRetrieveDocumentsResponse>;
+}
+export interface CollectionRetrieveDocumentsResponse {
+    data?: Array<CollectionRetrieveDocumentsResponse.Data>;
+    meta?: CollectionRetrieveDocumentsResponse.Meta;
+}
+export declare namespace CollectionRetrieveDocumentsResponse {
+    interface Data {
+        id?: string;
+        chunk_index?: number;
+        chunk_total?: number;
+        ingested_at?: string;
+        metadata?: {
+            [key: string]: unknown;
+        };
+        organization_id?: string;
+        record_created_at?: string;
+        record_id?: string;
+        /**
+         * The source record kind this chunk came from (e.g. `voice`, `meeting_bot`,
+         * `message`).
+         */
+        record_type?: string;
+        region?: string;
+        /**
+         * Relevance score (higher = more relevant) for ranked search. `0.0` for plain
+         * catalog listings (when `query` is omitted).
+         */
+        score?: number;
+        text?: string;
+        user_id?: string;
+    }
+    interface Meta {
+        collection_slug?: string;
+        page_number?: number;
+        page_size?: number;
+        retrieval_type?: string;
+        searched_sources?: Array<string>;
+        top_k?: number;
+        total_pages?: number;
+        total_results?: number;
+    }
+}
+export interface CollectionRetrieveDocumentsParams {
+    /**
+     * Field filters applied before ranking, using `filter[field][operator]=value`.
+     * Supported operators: `eq` (default), `in`, `gte`, `gt`, `lte`, `lt`, `contains`.
+     * Known fields: `record_type`, `record_id`, `user_id`, `record_created_at`,
+     * `ingested_at`; any other name resolves to a `metadata.<field>` filter. Example:
+     * `filter[record_id][eq]=rec_123`.
+     */
+    filter?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Page number to return (1-based). Defaults to 1.
+     */
+    'page[number]'?: number;
+    /**
+     * Number of results per page. Defaults to 20.
+     */
+    'page[size]'?: number;
+    /**
+     * Natural-language search query. When provided, the text is matched against the
+     * collection's document chunks using the collection's `retrieval_type` (vector or
+     * hybrid). When omitted, documents are returned as a plain catalog listing.
+     */
+    query?: string;
+    /**
+     * Reserved; not yet functional. A value supplied here is accepted but ignored — it
+     * does not override the collection's configured strategy, and it is not echoed
+     * back. Searches run `vector` retrieval, and `meta.retrieval_type` reports the
+     * mode that actually ran. To change retrieval strategy, set it on the collection's
+     * settings subresource.
+     */
+    retrieval_type?: 'vector' | 'hybrid' | 'keyword';
+    /**
+     * Comma-separated list of source types to restrict the search to. When omitted,
+     * all of the collection's sources are searched.
+     */
+    sources?: string;
+    /**
+     * Maximum number of ranked results to consider. When omitted, the collection's
+     * configured `top_k` setting is used.
+     */
+    top_k?: number;
+}
+export declare namespace Collections {
+    export { type CollectionRetrieveDocumentsResponse as CollectionRetrieveDocumentsResponse, type CollectionRetrieveDocumentsParams as CollectionRetrieveDocumentsParams, };
+}
+//# sourceMappingURL=collections.d.mts.map

package/resources/ai/knowledge/collections.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.mts","sourceRoot":"","sources":["../../../src/resources/ai/knowledge/collections.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,mCAA+B;AACrD,OAAO,EAAE,UAAU,EAAE,sCAAkC;AACvD,OAAO,EAAE,cAAc,EAAE,8CAA0C;AAGnE;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACH,iBAAiB,CACf,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,iCAAiC,GAAG,IAAI,GAAG,SAAc,EAChE,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mCAAmC,CAAC;CAGnD;AAED,MAAM,WAAW,mCAAmC;IAClD,IAAI,CAAC,EAAE,KAAK,CAAC,mCAAmC,CAAC,IAAI,CAAC,CAAC;IAEvD,IAAI,CAAC,EAAE,mCAAmC,CAAC,IAAI,CAAC;CACjD;AAED,yBAAiB,mCAAmC,CAAC;IACnD,UAAiB,IAAI;QACnB,EAAE,CAAC,EAAE,MAAM,CAAC;QAEZ,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,QAAQ,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC;QAEtC,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAE3B,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB;;;WAGG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAED,UAAiB,IAAI;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,cAAc,CAAC,EAAE,MAAM,CAAC;QAExB,gBAAgB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAEjC,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;CACF;AAED,MAAM,WAAW,iCAAiC;IAChD;;;;;;OAMG;IACH,MAAM,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAEpC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAEjD;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,mCAAmC,IAAI,mCAAmC,EAC/E,KAAK,iCAAiC,IAAI,iCAAiC,GAC5E,CAAC;CACH"}

package/resources/ai/knowledge/collections.d.ts

@@ -0,0 +1,140 @@
+import { APIResource } from "../../../core/resource.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+/**
+ * Create and manage logical collections of your Telnyx data, tune retrieval settings, manage sources, and run collection-scoped semantic search.
+ */
+export declare class Collections extends APIResource {
+    /**
+     * Runs search over the documents in a collection, ranked by relevance to `query`.
+     * Searches currently run `vector` retrieval (semantic similarity). The
+     * collection's `retrieval_type` setting is the forward-compatible selector:
+     * `hybrid` (vector similarity fused with keyword matching) can be set but cannot
+     * be searched yet, and `keyword` (lexical BM25 matching) is not accepted yet --
+     * setting it returns 422 `unsupported_retrieval_type`. A per-request
+     * `retrieval_type` is accepted but ignored; `meta.retrieval_type` echoes the mode
+     * that actually ran. When `query` is omitted, returns a plain catalog listing of
+     * the collection's documents.
+     *
+     * **How it works:**
+     *
+     * 1. The `query` text is embedded into a 1024-dimensional vector using the
+     *    multilingual-e5-large model.
+     * 2. The embedding is compared against the collection's indexed document chunks
+     *    using semantic similarity. When `hybrid` and `keyword` execution ship, those
+     *    scores will be fused with, or replaced by, lexical BM25 matching.
+     * 3. Results are ranked by `score` (descending) and paginated via `page[number]` /
+     *    `page[size]`.
+     *
+     * **Authentication:** Requires a Telnyx API key via `Authorization: Bearer <key>`.
+     * Results are automatically scoped to your organization and cannot be overridden.
+     *
+     * **Filtering:** Use `filter[field][operator]=value` query parameters to narrow
+     * results before search. Supported operators: `eq` (default), `in`, `gte`, `gt`,
+     * `lte`, `lt`, `contains`. Metadata fields resolve to `metadata.<field>`.
+     *
+     * **Examples:**
+     *
+     * - `GET /v2/ai/knowledge/collections/my-collection/documents?query=billing+issue&top_k=10`
+     * - `GET /v2/ai/knowledge/collections/my-collection/documents?query=refund&sources=voice,message`
+     * - `GET /v2/ai/knowledge/collections/my-collection/documents?query=outage&filter[record_created_at][gte]=2026-01-01T00:00:00Z`
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.ai.knowledge.collections.retrieveDocuments(
+     *     'support-transcripts',
+     *   );
+     * ```
+     */
+    retrieveDocuments(slug: string, query?: CollectionRetrieveDocumentsParams | null | undefined, options?: RequestOptions): APIPromise<CollectionRetrieveDocumentsResponse>;
+}
+export interface CollectionRetrieveDocumentsResponse {
+    data?: Array<CollectionRetrieveDocumentsResponse.Data>;
+    meta?: CollectionRetrieveDocumentsResponse.Meta;
+}
+export declare namespace CollectionRetrieveDocumentsResponse {
+    interface Data {
+        id?: string;
+        chunk_index?: number;
+        chunk_total?: number;
+        ingested_at?: string;
+        metadata?: {
+            [key: string]: unknown;
+        };
+        organization_id?: string;
+        record_created_at?: string;
+        record_id?: string;
+        /**
+         * The source record kind this chunk came from (e.g. `voice`, `meeting_bot`,
+         * `message`).
+         */
+        record_type?: string;
+        region?: string;
+        /**
+         * Relevance score (higher = more relevant) for ranked search. `0.0` for plain
+         * catalog listings (when `query` is omitted).
+         */
+        score?: number;
+        text?: string;
+        user_id?: string;
+    }
+    interface Meta {
+        collection_slug?: string;
+        page_number?: number;
+        page_size?: number;
+        retrieval_type?: string;
+        searched_sources?: Array<string>;
+        top_k?: number;
+        total_pages?: number;
+        total_results?: number;
+    }
+}
+export interface CollectionRetrieveDocumentsParams {
+    /**
+     * Field filters applied before ranking, using `filter[field][operator]=value`.
+     * Supported operators: `eq` (default), `in`, `gte`, `gt`, `lte`, `lt`, `contains`.
+     * Known fields: `record_type`, `record_id`, `user_id`, `record_created_at`,
+     * `ingested_at`; any other name resolves to a `metadata.<field>` filter. Example:
+     * `filter[record_id][eq]=rec_123`.
+     */
+    filter?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Page number to return (1-based). Defaults to 1.
+     */
+    'page[number]'?: number;
+    /**
+     * Number of results per page. Defaults to 20.
+     */
+    'page[size]'?: number;
+    /**
+     * Natural-language search query. When provided, the text is matched against the
+     * collection's document chunks using the collection's `retrieval_type` (vector or
+     * hybrid). When omitted, documents are returned as a plain catalog listing.
+     */
+    query?: string;
+    /**
+     * Reserved; not yet functional. A value supplied here is accepted but ignored — it
+     * does not override the collection's configured strategy, and it is not echoed
+     * back. Searches run `vector` retrieval, and `meta.retrieval_type` reports the
+     * mode that actually ran. To change retrieval strategy, set it on the collection's
+     * settings subresource.
+     */
+    retrieval_type?: 'vector' | 'hybrid' | 'keyword';
+    /**
+     * Comma-separated list of source types to restrict the search to. When omitted,
+     * all of the collection's sources are searched.
+     */
+    sources?: string;
+    /**
+     * Maximum number of ranked results to consider. When omitted, the collection's
+     * configured `top_k` setting is used.
+     */
+    top_k?: number;
+}
+export declare namespace Collections {
+    export { type CollectionRetrieveDocumentsResponse as CollectionRetrieveDocumentsResponse, type CollectionRetrieveDocumentsParams as CollectionRetrieveDocumentsParams, };
+}
+//# sourceMappingURL=collections.d.ts.map

package/resources/ai/knowledge/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../../src/resources/ai/knowledge/collections.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,kCAA+B;AACrD,OAAO,EAAE,UAAU,EAAE,qCAAkC;AACvD,OAAO,EAAE,cAAc,EAAE,6CAA0C;AAGnE;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACH,iBAAiB,CACf,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,iCAAiC,GAAG,IAAI,GAAG,SAAc,EAChE,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mCAAmC,CAAC;CAGnD;AAED,MAAM,WAAW,mCAAmC;IAClD,IAAI,CAAC,EAAE,KAAK,CAAC,mCAAmC,CAAC,IAAI,CAAC,CAAC;IAEvD,IAAI,CAAC,EAAE,mCAAmC,CAAC,IAAI,CAAC;CACjD;AAED,yBAAiB,mCAAmC,CAAC;IACnD,UAAiB,IAAI;QACnB,EAAE,CAAC,EAAE,MAAM,CAAC;QAEZ,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,QAAQ,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC;QAEtC,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAE3B,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB;;;WAGG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAED,UAAiB,IAAI;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,cAAc,CAAC,EAAE,MAAM,CAAC;QAExB,gBAAgB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAEjC,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;CACF;AAED,MAAM,WAAW,iCAAiC;IAChD;;;;;;OAMG;IACH,MAAM,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAEpC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAEjD;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,mCAAmC,IAAI,mCAAmC,EAC/E,KAAK,iCAAiC,IAAI,iCAAiC,GAC5E,CAAC;CACH"}

package/resources/ai/knowledge/collections.js

@@ -0,0 +1,58 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Collections = void 0;
+const resource_1 = require("../../../core/resource.js");
+const path_1 = require("../../../internal/utils/path.js");
+/**
+ * Create and manage logical collections of your Telnyx data, tune retrieval settings, manage sources, and run collection-scoped semantic search.
+ */
+class Collections extends resource_1.APIResource {
+    /**
+     * Runs search over the documents in a collection, ranked by relevance to `query`.
+     * Searches currently run `vector` retrieval (semantic similarity). The
+     * collection's `retrieval_type` setting is the forward-compatible selector:
+     * `hybrid` (vector similarity fused with keyword matching) can be set but cannot
+     * be searched yet, and `keyword` (lexical BM25 matching) is not accepted yet --
+     * setting it returns 422 `unsupported_retrieval_type`. A per-request
+     * `retrieval_type` is accepted but ignored; `meta.retrieval_type` echoes the mode
+     * that actually ran. When `query` is omitted, returns a plain catalog listing of
+     * the collection's documents.
+     *
+     * **How it works:**
+     *
+     * 1. The `query` text is embedded into a 1024-dimensional vector using the
+     *    multilingual-e5-large model.
+     * 2. The embedding is compared against the collection's indexed document chunks
+     *    using semantic similarity. When `hybrid` and `keyword` execution ship, those
+     *    scores will be fused with, or replaced by, lexical BM25 matching.
+     * 3. Results are ranked by `score` (descending) and paginated via `page[number]` /
+     *    `page[size]`.
+     *
+     * **Authentication:** Requires a Telnyx API key via `Authorization: Bearer <key>`.
+     * Results are automatically scoped to your organization and cannot be overridden.
+     *
+     * **Filtering:** Use `filter[field][operator]=value` query parameters to narrow
+     * results before search. Supported operators: `eq` (default), `in`, `gte`, `gt`,
+     * `lte`, `lt`, `contains`. Metadata fields resolve to `metadata.<field>`.
+     *
+     * **Examples:**
+     *
+     * - `GET /v2/ai/knowledge/collections/my-collection/documents?query=billing+issue&top_k=10`
+     * - `GET /v2/ai/knowledge/collections/my-collection/documents?query=refund&sources=voice,message`
+     * - `GET /v2/ai/knowledge/collections/my-collection/documents?query=outage&filter[record_created_at][gte]=2026-01-01T00:00:00Z`
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.ai.knowledge.collections.retrieveDocuments(
+     *     'support-transcripts',
+     *   );
+     * ```
+     */
+    retrieveDocuments(slug, query = {}, options) {
+        return this._client.get((0, path_1.path) `/ai/knowledge/collections/${slug}/documents`, { query, ...options });
+    }
+}
+exports.Collections = Collections;
+//# sourceMappingURL=collections.js.map

package/resources/ai/knowledge/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../../src/resources/ai/knowledge/collections.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAGrD,0DAAoD;AAEpD;;GAEG;AACH,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACH,iBAAiB,CACf,IAAY,EACZ,QAA8D,EAAE,EAChE,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,6BAA6B,IAAI,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpG,CAAC;CACF;AAlDD,kCAkDC"}

package/resources/ai/knowledge/collections.mjs

@@ -0,0 +1,54 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import { path } from "../../../internal/utils/path.mjs";
+/**
+ * Create and manage logical collections of your Telnyx data, tune retrieval settings, manage sources, and run collection-scoped semantic search.
+ */
+export class Collections extends APIResource {
+    /**
+     * Runs search over the documents in a collection, ranked by relevance to `query`.
+     * Searches currently run `vector` retrieval (semantic similarity). The
+     * collection's `retrieval_type` setting is the forward-compatible selector:
+     * `hybrid` (vector similarity fused with keyword matching) can be set but cannot
+     * be searched yet, and `keyword` (lexical BM25 matching) is not accepted yet --
+     * setting it returns 422 `unsupported_retrieval_type`. A per-request
+     * `retrieval_type` is accepted but ignored; `meta.retrieval_type` echoes the mode
+     * that actually ran. When `query` is omitted, returns a plain catalog listing of
+     * the collection's documents.
+     *
+     * **How it works:**
+     *
+     * 1. The `query` text is embedded into a 1024-dimensional vector using the
+     *    multilingual-e5-large model.
+     * 2. The embedding is compared against the collection's indexed document chunks
+     *    using semantic similarity. When `hybrid` and `keyword` execution ship, those
+     *    scores will be fused with, or replaced by, lexical BM25 matching.
+     * 3. Results are ranked by `score` (descending) and paginated via `page[number]` /
+     *    `page[size]`.
+     *
+     * **Authentication:** Requires a Telnyx API key via `Authorization: Bearer <key>`.
+     * Results are automatically scoped to your organization and cannot be overridden.
+     *
+     * **Filtering:** Use `filter[field][operator]=value` query parameters to narrow
+     * results before search. Supported operators: `eq` (default), `in`, `gte`, `gt`,
+     * `lte`, `lt`, `contains`. Metadata fields resolve to `metadata.<field>`.
+     *
+     * **Examples:**
+     *
+     * - `GET /v2/ai/knowledge/collections/my-collection/documents?query=billing+issue&top_k=10`
+     * - `GET /v2/ai/knowledge/collections/my-collection/documents?query=refund&sources=voice,message`
+     * - `GET /v2/ai/knowledge/collections/my-collection/documents?query=outage&filter[record_created_at][gte]=2026-01-01T00:00:00Z`
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.ai.knowledge.collections.retrieveDocuments(
+     *     'support-transcripts',
+     *   );
+     * ```
+     */
+    retrieveDocuments(slug, query = {}, options) {
+        return this._client.get(path `/ai/knowledge/collections/${slug}/documents`, { query, ...options });
+    }
+}
+//# sourceMappingURL=collections.mjs.map

package/resources/ai/knowledge/collections.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.mjs","sourceRoot":"","sources":["../../../src/resources/ai/knowledge/collections.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAGrD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACH,iBAAiB,CACf,IAAY,EACZ,QAA8D,EAAE,EAChE,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,6BAA6B,IAAI,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpG,CAAC;CACF"}

package/resources/ai/knowledge/index.d.mts

@@ -0,0 +1,3 @@
+export { Collections, type CollectionRetrieveDocumentsResponse, type CollectionRetrieveDocumentsParams, } from "./collections.mjs";
+export { Knowledge } from "./knowledge.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/ai/knowledge/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/resources/ai/knowledge/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,KAAK,mCAAmC,EACxC,KAAK,iCAAiC,GACvC,0BAAsB;AACvB,OAAO,EAAE,SAAS,EAAE,wBAAoB"}

package/resources/ai/knowledge/index.d.ts

@@ -0,0 +1,3 @@
+export { Collections, type CollectionRetrieveDocumentsResponse, type CollectionRetrieveDocumentsParams, } from "./collections.js";
+export { Knowledge } from "./knowledge.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/ai/knowledge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/ai/knowledge/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,KAAK,mCAAmC,EACxC,KAAK,iCAAiC,GACvC,yBAAsB;AACvB,OAAO,EAAE,SAAS,EAAE,uBAAoB"}

package/resources/ai/knowledge/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Knowledge = exports.Collections = void 0;
+var collections_1 = require("./collections.js");
+Object.defineProperty(exports, "Collections", { enumerable: true, get: function () { return collections_1.Collections; } });
+var knowledge_1 = require("./knowledge.js");
+Object.defineProperty(exports, "Knowledge", { enumerable: true, get: function () { return knowledge_1.Knowledge; } });
+//# sourceMappingURL=index.js.map

package/resources/ai/knowledge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/ai/knowledge/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,gDAIuB;AAHrB,0GAAA,WAAW,OAAA;AAIb,4CAAwC;AAA/B,sGAAA,SAAS,OAAA"}

package/resources/ai/knowledge/index.mjs

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Collections, } from "./collections.mjs";
+export { Knowledge } from "./knowledge.mjs";
+//# sourceMappingURL=index.mjs.map

package/resources/ai/knowledge/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/resources/ai/knowledge/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACL,WAAW,GAGZ,0BAAsB;AACvB,OAAO,EAAE,SAAS,EAAE,wBAAoB"}

package/resources/ai/knowledge/knowledge.d.mts

@@ -0,0 +1,10 @@
+import { APIResource } from "../../../core/resource.mjs";
+import * as CollectionsAPI from "./collections.mjs";
+import { CollectionRetrieveDocumentsParams, CollectionRetrieveDocumentsResponse, Collections } from "./collections.mjs";
+export declare class Knowledge extends APIResource {
+    collections: CollectionsAPI.Collections;
+}
+export declare namespace Knowledge {
+    export { Collections as Collections, type CollectionRetrieveDocumentsResponse as CollectionRetrieveDocumentsResponse, type CollectionRetrieveDocumentsParams as CollectionRetrieveDocumentsParams, };
+}
+//# sourceMappingURL=knowledge.d.mts.map

package/resources/ai/knowledge/knowledge.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.mts","sourceRoot":"","sources":["../../../src/resources/ai/knowledge/knowledge.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,mCAA+B;AACrD,OAAO,KAAK,cAAc,0BAAsB;AAChD,OAAO,EACL,iCAAiC,EACjC,mCAAmC,EACnC,WAAW,EACZ,0BAAsB;AAEvB,qBAAa,SAAU,SAAQ,WAAW;IACxC,WAAW,EAAE,cAAc,CAAC,WAAW,CAAgD;CACxF;AAID,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,WAAW,IAAI,WAAW,EAC1B,KAAK,mCAAmC,IAAI,mCAAmC,EAC/E,KAAK,iCAAiC,IAAI,iCAAiC,GAC5E,CAAC;CACH"}

package/resources/ai/knowledge/knowledge.d.ts

@@ -0,0 +1,10 @@
+import { APIResource } from "../../../core/resource.js";
+import * as CollectionsAPI from "./collections.js";
+import { CollectionRetrieveDocumentsParams, CollectionRetrieveDocumentsResponse, Collections } from "./collections.js";
+export declare class Knowledge extends APIResource {
+    collections: CollectionsAPI.Collections;
+}
+export declare namespace Knowledge {
+    export { Collections as Collections, type CollectionRetrieveDocumentsResponse as CollectionRetrieveDocumentsResponse, type CollectionRetrieveDocumentsParams as CollectionRetrieveDocumentsParams, };
+}
+//# sourceMappingURL=knowledge.d.ts.map

package/resources/ai/knowledge/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../../src/resources/ai/knowledge/knowledge.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,kCAA+B;AACrD,OAAO,KAAK,cAAc,yBAAsB;AAChD,OAAO,EACL,iCAAiC,EACjC,mCAAmC,EACnC,WAAW,EACZ,yBAAsB;AAEvB,qBAAa,SAAU,SAAQ,WAAW;IACxC,WAAW,EAAE,cAAc,CAAC,WAAW,CAAgD;CACxF;AAID,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,WAAW,IAAI,WAAW,EAC1B,KAAK,mCAAmC,IAAI,mCAAmC,EAC/E,KAAK,iCAAiC,IAAI,iCAAiC,GAC5E,CAAC;CACH"}

package/resources/ai/knowledge/knowledge.js

@@ -0,0 +1,17 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Knowledge = void 0;
+const tslib_1 = require("../../../internal/tslib.js");
+const resource_1 = require("../../../core/resource.js");
+const CollectionsAPI = tslib_1.__importStar(require("./collections.js"));
+const collections_1 = require("./collections.js");
+class Knowledge extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.collections = new CollectionsAPI.Collections(this._client);
+    }
+}
+exports.Knowledge = Knowledge;
+Knowledge.Collections = collections_1.Collections;
+//# sourceMappingURL=knowledge.js.map

package/resources/ai/knowledge/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../../src/resources/ai/knowledge/knowledge.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AACrD,yEAAgD;AAChD,kDAIuB;AAEvB,MAAa,SAAU,SAAQ,sBAAW;IAA1C;;QACE,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzF,CAAC;CAAA;AAFD,8BAEC;AAED,SAAS,CAAC,WAAW,GAAG,yBAAW,CAAC"}

package/resources/ai/knowledge/knowledge.mjs

@@ -0,0 +1,12 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import * as CollectionsAPI from "./collections.mjs";
+import { Collections, } from "./collections.mjs";
+export class Knowledge extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.collections = new CollectionsAPI.Collections(this._client);
+    }
+}
+Knowledge.Collections = Collections;
+//# sourceMappingURL=knowledge.mjs.map

package/resources/ai/knowledge/knowledge.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.mjs","sourceRoot":"","sources":["../../../src/resources/ai/knowledge/knowledge.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AACrD,OAAO,KAAK,cAAc,0BAAsB;AAChD,OAAO,EAGL,WAAW,GACZ,0BAAsB;AAEvB,MAAM,OAAO,SAAU,SAAQ,WAAW;IAA1C;;QACE,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzF,CAAC;CAAA;AAED,SAAS,CAAC,WAAW,GAAG,WAAW,CAAC"}

package/resources/ai/knowledge.d.mts

@@ -0,0 +1,2 @@
+export * from "./knowledge/index.mjs";
+//# sourceMappingURL=knowledge.d.mts.map

package/resources/ai/knowledge.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.mts","sourceRoot":"","sources":["../../src/resources/ai/knowledge.ts"],"names":[],"mappings":"AAEA,sCAAkC"}

package/resources/ai/knowledge.d.ts

@@ -0,0 +1,2 @@
+export * from "./knowledge/index.js";
+//# sourceMappingURL=knowledge.d.ts.map

package/resources/ai/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/resources/ai/knowledge.ts"],"names":[],"mappings":"AAEA,qCAAkC"}

package/resources/ai/knowledge.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../../internal/tslib.js");
+tslib_1.__exportStar(require("./knowledge/index.js"), exports);
+//# sourceMappingURL=knowledge.js.map

package/resources/ai/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../src/resources/ai/knowledge.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,+DAAkC"}

package/resources/ai/knowledge.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./knowledge/index.mjs";
+//# sourceMappingURL=knowledge.mjs.map

package/resources/ai/knowledge.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.mjs","sourceRoot":"","sources":["../../src/resources/ai/knowledge.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,sCAAkC"}

package/resources/ai/openai/chat.d.mts

@@ -108,6 +108,14 @@ export interface ChatCreateCompletionParams {
      * Higher values will penalize the model from repeating the same output tokens.
      */
     presence_penalty?: number;
+    /**
+     * Controls the reasoning effort for models that support it. When set, the model
+     * spends more or less compute on internal reasoning before generating its
+     * response. Supported values: none, minimal, low, medium, high, xhigh, max. Not
+     * all models support all values; unsupported values are rejected with a 400 error.
+     * When omitted, reasoning models use their default effort level.
+     */
+    reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
     /**
      * Use this is you want to guarantee a JSON output without defining a schema. For
      * control over the schema, use `guided_json`.