@usecortex_ai/node 0.2.0 → 0.3.0

package/README.md

@@ -5,15 +5,6 @@ The official TypeScript SDK for the Cortex AI platform. Build powerful, context-
 * **Homepage:** [usecortex.ai](https://www.usecortex.ai/ "null")
 * **Documentation:** [docs.usecortex.ai](https://docs.usecortex.ai/ "null")
 
-## Installation
-
-```
-npm install @usecortex/ai
-# or
-yarn add @usecortex/ai
-
-```
-
 ## Getting Started
 
 To use the SDK, you'll need an API key from your Cortex AI dashboard.
@@ -32,40 +23,6 @@ const client = new CortexAI({
 
 ```
 
-### Example: Searching a Collection
-
-Here’s a quick example of how to perform a search on an existing collection.
-
-```
-import { CortexAI } from "@usecortex/ai";
-
-const client = new CortexAI({ apiKey: "YOUR_API_KEY" });
-
-async function main() {
-  try {
-    const searchResults = await client.search.search({
-      collectionName: "my-knowledge-base",
-      data: {
-        query: "What is the main topic of the document?",
-        topK: 3,
-      },
-    });
-
-    console.log("Search Results:");
-    for (const chunk of searchResults.chunks) {
-      console.log(`- Score: ${chunk.score.toFixed(2)}`);
-      console.log(`  Text: ${chunk.text.substring(0, 100)}...`);
-      console.log("----------");
-    }
-  } catch (error) {
-    console.error("An error occurred during search:", error);
-  }
-}
-
-main();
-
-```
-
 ## Support
 
-If you have any questions or need help, please reach out to our support team at [support@usecortex.ai](mailto:support@usecortex.ai "null").
+If you have any questions or need help, please reach out to our support team at [founders@usecortex.ai](mailto:founders@usecortex.ai "null").

package/dist/Client.d.ts

@@ -8,16 +8,16 @@ import { Sources } from "./api/resources/sources/client/Client.js";
 import { UserMemory } from "./api/resources/userMemory/client/Client.js";
 import { Fetch } from "./api/resources/fetch/client/Client.js";
 import { Upload } from "./api/resources/upload/client/Client.js";
-import { Document } from "./api/resources/document/client/Client.js";
 import { Embeddings } from "./api/resources/embeddings/client/Client.js";
 import { User } from "./api/resources/user/client/Client.js";
 import { Tenant } from "./api/resources/tenant/client/Client.js";
+import { Document } from "./api/resources/document/client/Client.js";
 export declare namespace CortexAIClient {
     interface Options {
         environment?: core.Supplier<environments.CortexAIEnvironment | string>;
         /** Specify a custom URL to connect the client to. */
         baseUrl?: core.Supplier<string>;
-        token: core.Supplier<core.BearerToken>;
+        token?: core.Supplier<core.BearerToken | undefined>;
         /** Additional headers to include in requests. */
         headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
@@ -41,18 +41,27 @@ export declare class CortexAIClient {
     protected _userMemory: UserMemory | undefined;
     protected _fetch: Fetch | undefined;
     protected _upload: Upload | undefined;
-    protected _document: Document | undefined;
     protected _embeddings: Embeddings | undefined;
     protected _user: User | undefined;
     protected _tenant: Tenant | undefined;
-    constructor(_options: CortexAIClient.Options);
+    protected _document: Document | undefined;
+    constructor(_options?: CortexAIClient.Options);
     get search(): Search;
     get sources(): Sources;
     get userMemory(): UserMemory;
     get fetch(): Fetch;
     get upload(): Upload;
-    get document(): Document;
     get embeddings(): Embeddings;
     get user(): User;
     get tenant(): Tenant;
+    get document(): Document;
+    /**
+     * @param {CortexAIClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.rootGet()
+     */
+    rootGet(requestOptions?: CortexAIClient.RequestOptions): core.HttpResponsePromise<unknown>;
+    private __rootGet;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

package/dist/Client.js

@@ -27,19 +27,21 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CortexAIClient = void 0;
+const environments = __importStar(require("./environments.js"));
 const core = __importStar(require("./core/index.js"));
 const headers_js_1 = require("./core/headers.js");
+const errors = __importStar(require("./errors/index.js"));
 const Client_js_1 = require("./api/resources/search/client/Client.js");
 const Client_js_2 = require("./api/resources/sources/client/Client.js");
 const Client_js_3 = require("./api/resources/userMemory/client/Client.js");
 const Client_js_4 = require("./api/resources/fetch/client/Client.js");
 const Client_js_5 = require("./api/resources/upload/client/Client.js");
-const Client_js_6 = require("./api/resources/document/client/Client.js");
-const Client_js_7 = require("./api/resources/embeddings/client/Client.js");
-const Client_js_8 = require("./api/resources/user/client/Client.js");
-const Client_js_9 = require("./api/resources/tenant/client/Client.js");
+const Client_js_6 = require("./api/resources/embeddings/client/Client.js");
+const Client_js_7 = require("./api/resources/user/client/Client.js");
+const Client_js_8 = require("./api/resources/tenant/client/Client.js");
+const Client_js_9 = require("./api/resources/document/client/Client.js");
 class CortexAIClient {
-    constructor(_options) {
+    constructor(_options = {}) {
         this._options = Object.assign(Object.assign({}, _options), { headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-Runtime": core.RUNTIME.type,
@@ -66,21 +68,75 @@ class CortexAIClient {
         var _a;
         return ((_a = this._upload) !== null && _a !== void 0 ? _a : (this._upload = new Client_js_5.Upload(this._options)));
     }
-    get document() {
-        var _a;
-        return ((_a = this._document) !== null && _a !== void 0 ? _a : (this._document = new Client_js_6.Document(this._options)));
-    }
     get embeddings() {
         var _a;
-        return ((_a = this._embeddings) !== null && _a !== void 0 ? _a : (this._embeddings = new Client_js_7.Embeddings(this._options)));
+        return ((_a = this._embeddings) !== null && _a !== void 0 ? _a : (this._embeddings = new Client_js_6.Embeddings(this._options)));
     }
     get user() {
         var _a;
-        return ((_a = this._user) !== null && _a !== void 0 ? _a : (this._user = new Client_js_8.User(this._options)));
+        return ((_a = this._user) !== null && _a !== void 0 ? _a : (this._user = new Client_js_7.User(this._options)));
     }
     get tenant() {
         var _a;
-        return ((_a = this._tenant) !== null && _a !== void 0 ? _a : (this._tenant = new Client_js_9.Tenant(this._options)));
+        return ((_a = this._tenant) !== null && _a !== void 0 ? _a : (this._tenant = new Client_js_8.Tenant(this._options)));
+    }
+    get document() {
+        var _a;
+        return ((_a = this._document) !== null && _a !== void 0 ? _a : (this._document = new Client_js_9.Document(this._options)));
+    }
+    /**
+     * @param {CortexAIClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.rootGet()
+     */
+    rootGet(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__rootGet(requestOptions));
+    }
+    async __rootGet(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: (_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,
+            method: "GET",
+            headers: _headers,
+            queryParameters: 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") {
+            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 /.");
+            case "unknown":
+                throw new errors.CortexAIError({
+                    message: _response.error.errorMessage,
+                    rawResponse: _response.rawResponse,
+                });
+        }
+    }
+    async _getAuthorizationHeader() {
+        const bearer = await core.Supplier.get(this._options.token);
+        if (bearer != null) {
+            return `Bearer ${bearer}`;
+        }
+        return undefined;
     }
 }
 exports.CortexAIClient = CortexAIClient;

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

@@ -9,7 +9,7 @@ export declare namespace Document {
         environment?: core.Supplier<environments.CortexAIEnvironment | string>;
         /** Specify a custom URL to connect the client to. */
         baseUrl?: core.Supplier<string>;
-        token: core.Supplier<core.BearerToken>;
+        token?: core.Supplier<core.BearerToken | undefined>;
         /** Additional headers to include in requests. */
         headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
@@ -28,7 +28,7 @@ export declare namespace Document {
 }
 export declare class Document {
     protected readonly _options: Document.Options;
-    constructor(_options: Document.Options);
+    constructor(_options?: Document.Options);
     /**
      * Remove documents and content from your knowledge base.
      *
@@ -49,11 +49,11 @@ export declare class Document {
      *
      * @example
      *     await client.document.delete({
-     *         tenant_id: "tenant_id",
-     *         source_ids: ["source_ids"]
+     *         tenant_id: "tenant_1234",
+     *         source_ids: ["CortexDoc1234", "CortexDoc4567"]
      *     })
      */
     delete(request: CortexAI.DeleteMemoryRequest, requestOptions?: Document.RequestOptions): core.HttpResponsePromise<CortexAI.DeleteSources>;
     private __delete;
-    protected _getAuthorizationHeader(): Promise<string>;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

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

@@ -33,7 +33,7 @@ const CortexAI = __importStar(require("../../../index.js"));
 const headers_js_1 = require("../../../../core/headers.js");
 const errors = __importStar(require("../../../../errors/index.js"));
 class Document {
-    constructor(_options) {
+    constructor(_options = {}) {
         this._options = _options;
     }
     /**
@@ -56,8 +56,8 @@ class Document {
      *
      * @example
      *     await client.document.delete({
-     *         tenant_id: "tenant_id",
-     *         source_ids: ["source_ids"]
+     *         tenant_id: "tenant_1234",
+     *         source_ids: ["CortexDoc1234", "CortexDoc4567"]
      *     })
      */
     delete(request, requestOptions) {
@@ -122,7 +122,11 @@ class Document {
         }
     }
     async _getAuthorizationHeader() {
-        return `Bearer ${await core.Supplier.get(this._options.token)}`;
+        const bearer = await core.Supplier.get(this._options.token);
+        if (bearer != null) {
+            return `Bearer ${bearer}`;
+        }
+        return undefined;
     }
 }
 exports.Document = Document;

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

@@ -9,7 +9,7 @@ export declare namespace Embeddings {
         environment?: core.Supplier<environments.CortexAIEnvironment | string>;
         /** Specify a custom URL to connect the client to. */
         baseUrl?: core.Supplier<string>;
-        token: core.Supplier<core.BearerToken>;
+        token?: core.Supplier<core.BearerToken | undefined>;
         /** Additional headers to include in requests. */
         headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
@@ -28,7 +28,7 @@ export declare namespace Embeddings {
 }
 export declare class Embeddings {
     protected readonly _options: Embeddings.Options;
-    constructor(_options: Embeddings.Options);
+    constructor(_options?: Embeddings.Options);
     /**
      * Delete embedding chunks by chunk ID.
      *
@@ -47,8 +47,8 @@ export declare class Embeddings {
      *
      * @example
      *     await client.embeddings.delete({
-     *         chunk_ids: ["chunk_ids"],
-     *         tenant_id: "tenant_id"
+     *         chunk_ids: ["CortexEmbeddings123_0", "CortexEmbeddings123_1"],
+     *         tenant_id: "tenant_1234"
      *     })
      */
     delete(request: CortexAI.EmbeddingsDeleteRequest, requestOptions?: Embeddings.RequestOptions): core.HttpResponsePromise<CortexAI.EmbeddingsDeleteData>;
@@ -75,7 +75,7 @@ export declare class Embeddings {
      *
      * @example
      *     await client.embeddings.search({
-     *         tenant_id: "tenant_id"
+     *         tenant_id: "tenant_1234"
      *     })
      */
     search(request: CortexAI.EmbeddingsSearchRequest, requestOptions?: Embeddings.RequestOptions): core.HttpResponsePromise<CortexAI.EmbeddingsSearchData>;
@@ -98,8 +98,8 @@ export declare class Embeddings {
      *
      * @example
      *     await client.embeddings.getByChunkIds({
-     *         chunk_ids: ["chunk_ids"],
-     *         tenant_id: "tenant_id"
+     *         chunk_ids: ["CortexEmbeddings123_0", "CortexEmbeddings123_1"],
+     *         tenant_id: "tenant_1234"
      *     })
      */
     getByChunkIds(request: CortexAI.GetEmbeddingsBasedOnChunkIdsRequest, requestOptions?: Embeddings.RequestOptions): core.HttpResponsePromise<CortexAI.EmbeddingsGetData>;
@@ -122,10 +122,10 @@ export declare class Embeddings {
      *
      * @example
      *     await client.embeddings.createCollection({
-     *         tenant_id: "tenant_id"
+     *         tenant_id: "tenant_1234"
      *     })
      */
     createCollection(request: CortexAI.EmbeddingsCreateCollectionRequest, requestOptions?: Embeddings.RequestOptions): core.HttpResponsePromise<CortexAI.EmbeddingsCreateCollectionData>;
     private __createCollection;
-    protected _getAuthorizationHeader(): Promise<string>;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

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

@@ -33,7 +33,7 @@ const CortexAI = __importStar(require("../../../index.js"));
 const headers_js_1 = require("../../../../core/headers.js");
 const errors = __importStar(require("../../../../errors/index.js"));
 class Embeddings {
-    constructor(_options) {
+    constructor(_options = {}) {
         this._options = _options;
     }
     /**
@@ -54,8 +54,8 @@ class Embeddings {
      *
      * @example
      *     await client.embeddings.delete({
-     *         chunk_ids: ["chunk_ids"],
-     *         tenant_id: "tenant_id"
+     *         chunk_ids: ["CortexEmbeddings123_0", "CortexEmbeddings123_1"],
+     *         tenant_id: "tenant_1234"
      *     })
      */
     delete(request, requestOptions) {
@@ -141,7 +141,7 @@ class Embeddings {
      *
      * @example
      *     await client.embeddings.search({
-     *         tenant_id: "tenant_id"
+     *         tenant_id: "tenant_1234"
      *     })
      */
     search(request, requestOptions) {
@@ -223,8 +223,8 @@ class Embeddings {
      *
      * @example
      *     await client.embeddings.getByChunkIds({
-     *         chunk_ids: ["chunk_ids"],
-     *         tenant_id: "tenant_id"
+     *         chunk_ids: ["CortexEmbeddings123_0", "CortexEmbeddings123_1"],
+     *         tenant_id: "tenant_1234"
      *     })
      */
     getByChunkIds(request, requestOptions) {
@@ -234,7 +234,7 @@ class Embeddings {
         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, "embeddings/by-chunk-ids"),
+            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, "embeddings/retrieve_by_ids"),
             method: "POST",
             headers: _headers,
             contentType: "application/json",
@@ -280,7 +280,7 @@ class Embeddings {
                     rawResponse: _response.rawResponse,
                 });
             case "timeout":
-                throw new errors.CortexAITimeoutError("Timeout exceeded when calling POST /embeddings/by-chunk-ids.");
+                throw new errors.CortexAITimeoutError("Timeout exceeded when calling POST /embeddings/retrieve_by_ids.");
             case "unknown":
                 throw new errors.CortexAIError({
                     message: _response.error.errorMessage,
@@ -306,7 +306,7 @@ class Embeddings {
      *
      * @example
      *     await client.embeddings.createCollection({
-     *         tenant_id: "tenant_id"
+     *         tenant_id: "tenant_1234"
      *     })
      */
     createCollection(request, requestOptions) {
@@ -319,7 +319,7 @@ class Embeddings {
         _queryParams["tenant_id"] = tenantId;
         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, "embeddings/create_embeddings_tenant"),
+            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, "embeddings/create_tenant"),
             method: "POST",
             headers: _headers,
             queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
@@ -365,7 +365,7 @@ class Embeddings {
                     rawResponse: _response.rawResponse,
                 });
             case "timeout":
-                throw new errors.CortexAITimeoutError("Timeout exceeded when calling POST /embeddings/create_embeddings_tenant.");
+                throw new errors.CortexAITimeoutError("Timeout exceeded when calling POST /embeddings/create_tenant.");
             case "unknown":
                 throw new errors.CortexAIError({
                     message: _response.error.errorMessage,
@@ -374,7 +374,11 @@ class Embeddings {
         }
     }
     async _getAuthorizationHeader() {
-        return `Bearer ${await core.Supplier.get(this._options.token)}`;
+        const bearer = await core.Supplier.get(this._options.token);
+        if (bearer != null) {
+            return `Bearer ${bearer}`;
+        }
+        return undefined;
     }
 }
 exports.Embeddings = Embeddings;

package/dist/api/resources/embeddings/client/requests/EmbeddingsCreateCollectionRequest.d.ts

@@ -4,7 +4,7 @@
 /**
  * @example
  *     {
- *         tenant_id: "tenant_id"
+ *         tenant_id: "tenant_1234"
  *     }
  */
 export interface EmbeddingsCreateCollectionRequest {

package/dist/api/resources/embeddings/client/requests/EmbeddingsDeleteRequest.d.ts

@@ -4,8 +4,8 @@
 /**
  * @example
  *     {
- *         chunk_ids: ["chunk_ids"],
- *         tenant_id: "tenant_id"
+ *         chunk_ids: ["CortexEmbeddings123_0", "CortexEmbeddings123_1"],
+ *         tenant_id: "tenant_1234"
  *     }
  */
 export interface EmbeddingsDeleteRequest {
@@ -13,6 +13,6 @@ export interface EmbeddingsDeleteRequest {
     chunk_ids: string[];
     /** Unique identifier for the tenant/organization */
     tenant_id: string;
-    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
+    /** 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;
 }

package/dist/api/resources/embeddings/client/requests/EmbeddingsSearchRequest.d.ts

@@ -4,7 +4,7 @@
 /**
  * @example
  *     {
- *         tenant_id: "tenant_id"
+ *         tenant_id: "tenant_1234"
  *     }
  */
 export interface EmbeddingsSearchRequest {
@@ -12,7 +12,7 @@ export interface EmbeddingsSearchRequest {
     tenant_id: string;
     /** The embedding vector for search */
     embeddings?: number[];
-    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
+    /** 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;
     max_chunks?: number;
 }

package/dist/api/resources/embeddings/client/requests/GetEmbeddingsBasedOnChunkIdsRequest.d.ts

@@ -4,8 +4,8 @@
 /**
  * @example
  *     {
- *         chunk_ids: ["chunk_ids"],
- *         tenant_id: "tenant_id"
+ *         chunk_ids: ["CortexEmbeddings123_0", "CortexEmbeddings123_1"],
+ *         tenant_id: "tenant_1234"
  *     }
  */
 export interface GetEmbeddingsBasedOnChunkIdsRequest {
@@ -13,6 +13,6 @@ export interface GetEmbeddingsBasedOnChunkIdsRequest {
     chunk_ids: string[];
     /** Unique identifier for the tenant/organization */
     tenant_id: string;
-    /** Optional sub-tenant identifier for organizing data within a tenant. If not provided, defaults to tenant_id */
+    /** 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;
 }

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

@@ -9,7 +9,7 @@ export declare namespace Fetch {
         environment?: core.Supplier<environments.CortexAIEnvironment | string>;
         /** Specify a custom URL to connect the client to. */
         baseUrl?: core.Supplier<string>;
-        token: core.Supplier<core.BearerToken>;
+        token?: core.Supplier<core.BearerToken | undefined>;
         /** Additional headers to include in requests. */
         headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
@@ -28,7 +28,7 @@ export declare namespace Fetch {
 }
 export declare class Fetch {
     protected readonly _options: Fetch.Options;
-    constructor(_options: Fetch.Options);
+    constructor(_options?: Fetch.Options);
     /**
      * @param {CortexAI.FetchContentRequest} request
      * @param {Fetch.RequestOptions} requestOptions - Request-specific configuration.
@@ -43,12 +43,12 @@ export declare class Fetch {
      *
      * @example
      *     await client.fetch.fetchContent({
-     *         file_id: "file_id",
-     *         file_type: "file_type",
-     *         tenant_id: "tenant_id"
+     *         file_id: "CortexDoc1234",
+     *         file_type: "<file_type>",
+     *         tenant_id: "tenant_1234"
      *     })
      */
     fetchContent(request: CortexAI.FetchContentRequest, requestOptions?: Fetch.RequestOptions): core.HttpResponsePromise<CortexAI.FetchContentData>;
     private __fetchContent;
-    protected _getAuthorizationHeader(): Promise<string>;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

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

@@ -33,7 +33,7 @@ const CortexAI = __importStar(require("../../../index.js"));
 const headers_js_1 = require("../../../../core/headers.js");
 const errors = __importStar(require("../../../../errors/index.js"));
 class Fetch {
-    constructor(_options) {
+    constructor(_options = {}) {
         this._options = _options;
     }
     /**
@@ -50,9 +50,9 @@ class Fetch {
      *
      * @example
      *     await client.fetch.fetchContent({
-     *         file_id: "file_id",
-     *         file_type: "file_type",
-     *         tenant_id: "tenant_id"
+     *         file_id: "CortexDoc1234",
+     *         file_type: "<file_type>",
+     *         tenant_id: "tenant_1234"
      *     })
      */
     fetchContent(request, requestOptions) {
@@ -117,7 +117,11 @@ class Fetch {
         }
     }
     async _getAuthorizationHeader() {
-        return `Bearer ${await core.Supplier.get(this._options.token)}`;
+        const bearer = await core.Supplier.get(this._options.token);
+        if (bearer != null) {
+            return `Bearer ${bearer}`;
+        }
+        return undefined;
     }
 }
 exports.Fetch = Fetch;

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

@@ -4,20 +4,15 @@
 /**
  * @example
  *     {
- *         file_id: "file_id",
- *         file_type: "file_type",
- *         tenant_id: "tenant_id"
+ *         file_id: "CortexDoc1234",
+ *         file_type: "<file_type>",
+ *         tenant_id: "tenant_1234"
  *     }
  */
 export interface FetchContentRequest {
-    /** Unique identifier for the file to fetch */
     file_id: string;
-    /** Type of file (e.g., 'app', 'file', or other) */
     file_type: string;
-    /** Tenant identifier for multi-tenancy */
     tenant_id: string;
-    /** Whether to return the file content along with the URL */
     return_content?: boolean;
-    /** Sub-tenant identifier, defaults to tenant_id if not provided */
     sub_tenant_id?: string;
 }

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

@@ -3,10 +3,10 @@ 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 document from "./document/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";

package/dist/api/resources/index.js

@@ -26,16 +26,16 @@ 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.tenant = exports.user = exports.embeddings = exports.document = exports.upload = exports.fetch = exports.userMemory = exports.sources = exports.search = void 0;
+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.upload = __importStar(require("./upload/index.js"));
-exports.document = __importStar(require("./document/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);