@usecortex_ai/node 0.3.6 → 0.5.0

package/dist/api/resources/fetch/client/Client.js

@@ -37,7 +37,286 @@ class Fetch {
         this._options = _options;
     }
     /**
-     * @param {CortexAI.FetchContentRequest} request
+     * Retrieve all sources for a specific tenant and subtenant combination.
+     *
+     * Use this endpoint to fetch a complete list of all sources associated
+     * with your tenant. This includes documents, files, and other content
+     * you've uploaded for processing.
+     *
+     * You can optionally specify a sub-tenant to narrow down the results to
+     * sources within that specific sub-tenant scope.
+     *
+     * @param {CortexAI.FetchSourcesRequest} request
+     * @param {Fetch.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CortexAI.BadRequestError}
+     * @throws {@link CortexAI.UnauthorizedError}
+     * @throws {@link CortexAI.ForbiddenError}
+     * @throws {@link CortexAI.NotFoundError}
+     * @throws {@link CortexAI.UnprocessableEntityError}
+     * @throws {@link CortexAI.InternalServerError}
+     * @throws {@link CortexAI.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.fetch.sources({
+     *         tenant_id: "tenant_id"
+     *     })
+     */
+    sources(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__sources(request, requestOptions));
+    }
+    async __sources(request, requestOptions) {
+        var _a, _b, _c;
+        const { tenant_id: tenantId, sub_tenant_id: subTenantId } = request;
+        const _queryParams = {};
+        _queryParams["tenant_id"] = tenantId;
+        if (subTenantId != null) {
+            _queryParams["sub_tenant_id"] = subTenantId;
+        }
+        let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: await this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((_c = (_b = (await core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (await core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CortexAIEnvironment.CortexProd, "list/list-sources"),
+            method: "GET",
+            headers: _headers,
+            queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+            timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+            maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+            abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new CortexAI.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new CortexAI.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new CortexAI.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new CortexAI.NotFoundError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new CortexAI.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new CortexAI.InternalServerError(_response.error.body, _response.rawResponse);
+                case 503:
+                    throw new CortexAI.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.CortexAIError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        switch (_response.error.reason) {
+            case "non-json":
+                throw new errors.CortexAIError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.rawBody,
+                    rawResponse: _response.rawResponse,
+                });
+            case "timeout":
+                throw new errors.CortexAITimeoutError("Timeout exceeded when calling GET /list/list-sources.");
+            case "unknown":
+                throw new errors.CortexAIError({
+                    message: _response.error.errorMessage,
+                    rawResponse: _response.rawResponse,
+                });
+        }
+    }
+    /**
+     * Retrieve specific sources by their IDs.
+     *
+     * Use this endpoint to fetch one or more sources by providing their
+     * unique identifiers. This is useful when you need detailed information
+     * about specific documents or content you've previously uploaded.
+     *
+     * Provide the source IDs in the request body along with your tenant
+     * information to get the exact sources you need.
+     *
+     * @param {CortexAI.ListSourcesByIdRequest} request
+     * @param {Fetch.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CortexAI.BadRequestError}
+     * @throws {@link CortexAI.UnauthorizedError}
+     * @throws {@link CortexAI.ForbiddenError}
+     * @throws {@link CortexAI.NotFoundError}
+     * @throws {@link CortexAI.UnprocessableEntityError}
+     * @throws {@link CortexAI.InternalServerError}
+     * @throws {@link CortexAI.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.fetch.sourceByIds({
+     *         source_ids: ["source_ids"],
+     *         tenant_id: "tenant_id"
+     *     })
+     */
+    sourceByIds(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__sourceByIds(request, requestOptions));
+    }
+    async __sourceByIds(request, requestOptions) {
+        var _a, _b, _c;
+        let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: await this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((_c = (_b = (await core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (await core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CortexAIEnvironment.CortexProd, "list/list-sources-by-id"),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+            requestType: "json",
+            body: request,
+            timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+            maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+            abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new CortexAI.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new CortexAI.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new CortexAI.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new CortexAI.NotFoundError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new CortexAI.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new CortexAI.InternalServerError(_response.error.body, _response.rawResponse);
+                case 503:
+                    throw new CortexAI.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.CortexAIError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        switch (_response.error.reason) {
+            case "non-json":
+                throw new errors.CortexAIError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.rawBody,
+                    rawResponse: _response.rawResponse,
+                });
+            case "timeout":
+                throw new errors.CortexAITimeoutError("Timeout exceeded when calling POST /list/list-sources-by-id.");
+            case "unknown":
+                throw new errors.CortexAIError({
+                    message: _response.error.errorMessage,
+                    rawResponse: _response.rawResponse,
+                });
+        }
+    }
+    /**
+     * Retrieve relations for a specific source.
+     *
+     * Use this endpoint to fetch all relations associated with a specific source.
+     *  This is useful when you need to understand the relationships between entities within a source.
+     *
+     * Provide the source ID in the request body along with your tenant information to get the relations for that source.
+     *
+     * @param {CortexAI.FetchGraphRelationsBySourceIdRequest} request
+     * @param {Fetch.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CortexAI.BadRequestError}
+     * @throws {@link CortexAI.UnauthorizedError}
+     * @throws {@link CortexAI.ForbiddenError}
+     * @throws {@link CortexAI.NotFoundError}
+     * @throws {@link CortexAI.UnprocessableEntityError}
+     * @throws {@link CortexAI.InternalServerError}
+     * @throws {@link CortexAI.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.fetch.graphRelationsBySourceId({
+     *         source_id: "source_id"
+     *     })
+     */
+    graphRelationsBySourceId(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__graphRelationsBySourceId(request, requestOptions));
+    }
+    async __graphRelationsBySourceId(request, requestOptions) {
+        var _a, _b, _c;
+        const { source_id: sourceId, tenant_id: tenantId, sub_tenant_id: subTenantId } = request;
+        const _queryParams = {};
+        _queryParams["source_id"] = sourceId;
+        if (tenantId != null) {
+            _queryParams["tenant_id"] = tenantId;
+        }
+        if (subTenantId != null) {
+            _queryParams["sub_tenant_id"] = subTenantId;
+        }
+        let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: await this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((_c = (_b = (await core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (await core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CortexAIEnvironment.CortexProd, "list/graph-relations-by-id"),
+            method: "GET",
+            headers: _headers,
+            queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+            timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+            maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+            abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+        });
+        if (_response.ok) {
+            return {
+                data: _response.body,
+                rawResponse: _response.rawResponse,
+            };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new CortexAI.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new CortexAI.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new CortexAI.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new CortexAI.NotFoundError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new CortexAI.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new CortexAI.InternalServerError(_response.error.body, _response.rawResponse);
+                case 503:
+                    throw new CortexAI.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.CortexAIError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        switch (_response.error.reason) {
+            case "non-json":
+                throw new errors.CortexAIError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.rawBody,
+                    rawResponse: _response.rawResponse,
+                });
+            case "timeout":
+                throw new errors.CortexAITimeoutError("Timeout exceeded when calling GET /list/graph-relations-by-id.");
+            case "unknown":
+                throw new errors.CortexAIError({
+                    message: _response.error.errorMessage,
+                    rawResponse: _response.rawResponse,
+                });
+        }
+    }
+    /**
+     * Fetch the content of a source ingested.
+     *
+     * This endpoint can return:
+     * - File content directly (as string or base64)
+     * - A presigned URL to access the file
+     * - Both content and presigned URL
+     *
+     * @param {CortexAI.SourceFetchRequest} request
      * @param {Fetch.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link CortexAI.BadRequestError}
@@ -49,20 +328,19 @@ class Fetch {
      * @throws {@link CortexAI.ServiceUnavailableError}
      *
      * @example
-     *     await client.fetch.fetchContent({
-     *         file_id: "CortexDoc1234",
-     *         file_type: "<file_type>",
-     *         tenant_id: "tenant_1234"
+     *     await client.fetch.sourceContent({
+     *         tenant_id: "tenant_id",
+     *         source_id: "source_id"
      *     })
      */
-    fetchContent(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__fetchContent(request, requestOptions));
+    sourceContent(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__sourceContent(request, requestOptions));
     }
-    async __fetchContent(request, requestOptions) {
+    async __sourceContent(request, requestOptions) {
         var _a, _b, _c;
         let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: await this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
         const _response = await core.fetcher({
-            url: core.url.join((_c = (_b = (await core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (await core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CortexAIEnvironment.CortexProd, "fetch/fetch_content"),
+            url: core.url.join((_c = (_b = (await core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (await core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CortexAIEnvironment.CortexProd, "fetch/fetch-source-content"),
             method: "POST",
             headers: _headers,
             contentType: "application/json",
@@ -108,7 +386,7 @@ class Fetch {
                     rawResponse: _response.rawResponse,
                 });
             case "timeout":
-                throw new errors.CortexAITimeoutError("Timeout exceeded when calling POST /fetch/fetch_content.");
+                throw new errors.CortexAITimeoutError("Timeout exceeded when calling POST /fetch/fetch-source-content.");
             case "unknown":
                 throw new errors.CortexAIError({
                     message: _response.error.errorMessage,

package/dist/api/resources/{sources/client/requests/SourcesGetGraphRelationsByIdRequest.d.ts → fetch/client/requests/FetchGraphRelationsBySourceIdRequest.d.ts}

@@ -4,11 +4,10 @@
 /**
  * @example
  *     {
- *         source_id: "CortexDoc1234",
- *         tenant_id: "tenant_1234"
+ *         source_id: "source_id"
  *     }
  */
-export interface SourcesGetGraphRelationsByIdRequest {
+export interface FetchGraphRelationsBySourceIdRequest {
     /** The source ID to fetch relations for */
     source_id: string;
     /** Unique identifier for the tenant/organization */

package/dist/api/resources/{sources/client/requests/SourcesGetAllRequest.d.ts → fetch/client/requests/FetchSourcesRequest.d.ts}

@@ -4,11 +4,10 @@
 /**
  * @example
  *     {
- *         tenant_id: "tenant_1234",
- *         sub_tenant_id: "sub_tenant_4567"
+ *         tenant_id: "tenant_id"
  *     }
  */
-export interface SourcesGetAllRequest {
+export interface FetchSourcesRequest {
     /** Unique identifier for the tenant/organization */
     tenant_id: string;
     /** Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used. */

package/dist/api/resources/fetch/client/requests/ListSourcesByIdRequest.d.ts

@@ -0,0 +1,18 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         source_ids: ["source_ids"],
+ *         tenant_id: "tenant_id"
+ *     }
+ */
+export interface ListSourcesByIdRequest {
+    /** List of source IDs to fetch. */
+    source_ids: string[];
+    /** Tenant ID */
+    tenant_id: string;
+    /** Sub-tenant ID */
+    sub_tenant_id?: string;
+}

package/dist/api/resources/{upload/client/requests/UploadUpdateTextRequest.d.ts → fetch/client/requests/SourceFetchRequest.d.ts}

@@ -5,20 +5,19 @@ import * as CortexAI from "../../../../index.js";
 /**
  * @example
  *     {
- *         source_id: "CortexDoc1234",
- *         tenant_id: "tenant_1234",
- *         sub_tenant_id: "sub_tenant_4567",
- *         body: {
- *             content: "<content>"
- *         }
+ *         tenant_id: "tenant_id",
+ *         source_id: "source_id"
  *     }
  */
-export interface UploadUpdateTextRequest {
-    /** The source ID of the document to update */
-    source_id: string;
+export interface SourceFetchRequest {
     /** Unique identifier for the tenant/organization */
     tenant_id: string;
     /** Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used. */
     sub_tenant_id?: string;
-    body: CortexAI.MarkdownUploadRequest;
+    /** Source ID of the file to fetch */
+    source_id: string;
+    /** Fetch mode: 'content' returns file content, 'url' returns presigned URL, 'both' returns both */
+    mode?: CortexAI.FetchMode;
+    /** Expiry time in seconds for presigned URL (60-604800, default: 3600) */
+    expiry_seconds?: number;
 }

package/dist/api/resources/fetch/client/requests/index.d.ts

@@ -1 +1,4 @@
-export { type FetchContentRequest } from "./FetchContentRequest.js";
+export { type FetchSourcesRequest } from "./FetchSourcesRequest.js";
+export { type ListSourcesByIdRequest } from "./ListSourcesByIdRequest.js";
+export { type FetchGraphRelationsBySourceIdRequest } from "./FetchGraphRelationsBySourceIdRequest.js";
+export { type SourceFetchRequest } from "./SourceFetchRequest.js";

package/dist/api/resources/index.d.ts

@@ -1,17 +1,14 @@
-export * as search from "./search/index.js";
-export * as sources from "./sources/index.js";
-export * as userMemory from "./userMemory/index.js";
-export * as fetch from "./fetch/index.js";
 export * as upload from "./upload/index.js";
-export * as embeddings from "./embeddings/index.js";
-export * as user from "./user/index.js";
 export * as tenant from "./tenant/index.js";
-export * as document from "./document/index.js";
-export * from "./search/client/requests/index.js";
-export * from "./sources/client/requests/index.js";
-export * from "./userMemory/client/requests/index.js";
-export * from "./fetch/client/requests/index.js";
+export * as embeddings from "./embeddings/index.js";
+export * as fetch from "./fetch/index.js";
+export * as sources from "./sources/index.js";
+export * as search from "./search/index.js";
+export * as dashboard from "./dashboard/index.js";
 export * from "./upload/client/requests/index.js";
-export * from "./embeddings/client/requests/index.js";
-export * from "./user/client/requests/index.js";
 export * from "./tenant/client/requests/index.js";
+export * from "./embeddings/client/requests/index.js";
+export * from "./fetch/client/requests/index.js";
+export * from "./sources/client/requests/index.js";
+export * from "./search/client/requests/index.js";
+export * from "./dashboard/client/requests/index.js";

package/dist/api/resources/index.js

@@ -26,21 +26,18 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.document = exports.tenant = exports.user = exports.embeddings = exports.upload = exports.fetch = exports.userMemory = exports.sources = exports.search = void 0;
-exports.search = __importStar(require("./search/index.js"));
-exports.sources = __importStar(require("./sources/index.js"));
-exports.userMemory = __importStar(require("./userMemory/index.js"));
-exports.fetch = __importStar(require("./fetch/index.js"));
+exports.dashboard = exports.search = exports.sources = exports.fetch = exports.embeddings = exports.tenant = exports.upload = void 0;
 exports.upload = __importStar(require("./upload/index.js"));
-exports.embeddings = __importStar(require("./embeddings/index.js"));
-exports.user = __importStar(require("./user/index.js"));
 exports.tenant = __importStar(require("./tenant/index.js"));
-exports.document = __importStar(require("./document/index.js"));
-__exportStar(require("./search/client/requests/index.js"), exports);
-__exportStar(require("./sources/client/requests/index.js"), exports);
-__exportStar(require("./userMemory/client/requests/index.js"), exports);
-__exportStar(require("./fetch/client/requests/index.js"), exports);
+exports.embeddings = __importStar(require("./embeddings/index.js"));
+exports.fetch = __importStar(require("./fetch/index.js"));
+exports.sources = __importStar(require("./sources/index.js"));
+exports.search = __importStar(require("./search/index.js"));
+exports.dashboard = __importStar(require("./dashboard/index.js"));
 __exportStar(require("./upload/client/requests/index.js"), exports);
-__exportStar(require("./embeddings/client/requests/index.js"), exports);
-__exportStar(require("./user/client/requests/index.js"), exports);
 __exportStar(require("./tenant/client/requests/index.js"), exports);
+__exportStar(require("./embeddings/client/requests/index.js"), exports);
+__exportStar(require("./fetch/client/requests/index.js"), exports);
+__exportStar(require("./sources/client/requests/index.js"), exports);
+__exportStar(require("./search/client/requests/index.js"), exports);
+__exportStar(require("./dashboard/client/requests/index.js"), exports);

package/dist/api/resources/search/client/Client.d.ts

@@ -30,9 +30,25 @@ export declare class Search {
     protected readonly _options: Search.Options;
     constructor(_options?: Search.Options);
     /**
-     * Ask a question to your uploaded knowledge base and let Cortex AI answer it.
+     * Search for relevant content within your indexed sources or user memories.
      *
-     * @param {CortexAI.QnARequest} request
+     *     Results are ranked by relevance and can be customized with parameters like
+     *     result limits, alpha weighting, and recency preferences.
+     *
+     *     Use `search_mode` to specify what to search:
+     *     - "sources" (default): Search over indexed documents
+     *     - "memories": Search over user memories (uses inferred content)
+     *
+     *     Use `mode` to control retrieval quality:
+     *     - "fast" (default): Single query, faster response
+     *     - "accurate": Multi-query generation with reranking, higher quality
+     *
+     *     Use `filters` to narrow results by metadata:
+     *     - Provide key-value pairs matching fields defined in your tenant_metadata_schema
+     *     - Example: `{"category": "engineering", "priority": "high"}`
+     *     - Filters are validated against your tenant schema for type safety
+     *
+     * @param {CortexAI.HybridSearchRequest} request
      * @param {Search.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link CortexAI.BadRequestError}
@@ -40,25 +56,28 @@ export declare class Search {
      * @throws {@link CortexAI.ForbiddenError}
      * @throws {@link CortexAI.NotFoundError}
      * @throws {@link CortexAI.UnprocessableEntityError}
+     * @throws {@link CortexAI.TooManyRequestsError}
      * @throws {@link CortexAI.InternalServerError}
      * @throws {@link CortexAI.ServiceUnavailableError}
      *
      * @example
-     *     await client.search.qna({
-     *         question: "What is Cortex AI",
-     *         session_id: "chat_session_1234",
-     *         tenant_id: "tenant_1234"
+     *     await client.search.retrieve({
+     *         tenant_id: "tenant_id",
+     *         query: "query"
      *     })
      */
-    qna(request: CortexAI.QnARequest, requestOptions?: Search.RequestOptions): core.HttpResponsePromise<unknown>;
-    private __qna;
+    retrieve(request: CortexAI.HybridSearchRequest, requestOptions?: Search.RequestOptions): core.HttpResponsePromise<CortexAI.RetrievalResult>;
+    private __retrieve;
     /**
-     * Search for relevant content within your indexed sources.
+     * Perform full text search for exact matches within your indexed sources or memories.
+     *     Choose between 'OR' and 'AND' operators to control how search terms are combined
+     *     for precise text matching.
      *
-     * This API returns the chunks related to the query you make. We use neural (embedding) search to give you the most relevant chunks.
-     * Results are ranked by relevance and can be customized with parameters like result limits and recency preferences.
+     *     Use `search_mode` to specify what to search:
+     *     - "sources" (default): Search over indexed documents
+     *     - "memories": Search over user memories
      *
-     * @param {CortexAI.SearchRequest} request
+     * @param {CortexAI.FullTextSearchRequest} request
      * @param {Search.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link CortexAI.BadRequestError}
@@ -66,24 +85,33 @@ export declare class Search {
      * @throws {@link CortexAI.ForbiddenError}
      * @throws {@link CortexAI.NotFoundError}
      * @throws {@link CortexAI.UnprocessableEntityError}
+     * @throws {@link CortexAI.TooManyRequestsError}
      * @throws {@link CortexAI.InternalServerError}
      * @throws {@link CortexAI.ServiceUnavailableError}
      *
      * @example
-     *     await client.search.retrieve({
-     *         query: "Which mode does user prefer",
-     *         tenant_id: "tenant_1234"
+     *     await client.search.fullTextSearch({
+     *         tenant_id: "tenant_id",
+     *         query: "query"
      *     })
      */
-    retrieve(request: CortexAI.SearchRequest, requestOptions?: Search.RequestOptions): core.HttpResponsePromise<CortexAI.RetrieveResponse>;
-    private __retrieve;
+    fullTextSearch(request: CortexAI.FullTextSearchRequest, requestOptions?: Search.RequestOptions): core.HttpResponsePromise<CortexAI.RetrievalResult>;
+    private __fullTextSearch;
     /**
-     * Perform full text search for exact matches within your indexed sources.
+     * Ask a question and get an AI-generated answer based on your indexed sources or memories.
      *
-     * Use this endpoint to find content chunks using BM25-based text matching with configurable operators.
-     * Choose between 'OR' and 'AND' operators to control how search terms are combined for precise text matching.
+     *     The response includes both the AI answer and the source chunks used to generate it,
+     *     enabling full transparency and citation capabilities.
      *
-     * @param {CortexAI.FullTextSearchRequest} request
+     *     Use `search_mode` to specify what to search:
+     *     - "sources" (default): Search over indexed documents
+     *     - "memories": Search over user memories
+     *
+     *     Use `mode` to control retrieval quality:
+     *     - "fast" (default): Single query, faster response
+     *     - "accurate": Multi-query generation with reranking, higher quality
+     *
+     * @param {CortexAI.QnASearchRequest} request
      * @param {Search.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link CortexAI.BadRequestError}
@@ -91,16 +119,17 @@ export declare class Search {
      * @throws {@link CortexAI.ForbiddenError}
      * @throws {@link CortexAI.NotFoundError}
      * @throws {@link CortexAI.UnprocessableEntityError}
+     * @throws {@link CortexAI.TooManyRequestsError}
      * @throws {@link CortexAI.InternalServerError}
      * @throws {@link CortexAI.ServiceUnavailableError}
      *
      * @example
-     *     await client.search.fullTextSearch({
-     *         query: "John Smith Jake",
-     *         tenant_id: "tenant_1234"
+     *     await client.search.qna({
+     *         tenant_id: "tenant_id",
+     *         question: "question"
      *     })
      */
-    fullTextSearch(request: CortexAI.FullTextSearchRequest, requestOptions?: Search.RequestOptions): core.HttpResponsePromise<CortexAI.SearchChunk[]>;
-    private __fullTextSearch;
+    qna(request: CortexAI.QnASearchRequest, requestOptions?: Search.RequestOptions): core.HttpResponsePromise<CortexAI.QnASearchResponse>;
+    private __qna;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }