@usecortex_ai/node 0.5.0 → 0.5.2

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

@@ -37,12 +37,7 @@ class Upload {
         this._options = _options;
     }
     /**
-     * Upload one or more documents for ingestion.
-     * Supports both single and batch uploads.
-     * For single file: send one file with the 'files' field.
-     * For batch: send multiple files with the 'files' field (FastAPI will parse as list).
-     *
-     * @param {CortexAI.BodyUploadDocumentIngestionUploadDocumentPost} request
+     * @param {CortexAI.BodyUploadKnowledgeIngestionUploadKnowledgePost} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link CortexAI.BadRequestError}
@@ -55,20 +50,16 @@ class Upload {
      *
      * @example
      *     import { createReadStream } from "fs";
-     *     await client.upload.uploadDocument({
-     *         files: [fs.createReadStream("/path/to/your/file")],
+     *     await client.upload.uploadKnowledge({
      *         tenant_id: "tenant_id"
      *     })
      */
-    uploadDocument(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__uploadDocument(request, requestOptions));
+    uploadKnowledge(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__uploadKnowledge(request, requestOptions));
     }
-    async __uploadDocument(request, requestOptions) {
+    async __uploadKnowledge(request, requestOptions) {
         var _a, _b, _c;
         const _request = await core.newFormData();
-        for (const _file of request.files) {
-            await _request.appendFile("files", _file);
-        }
         _request.append("tenant_id", request.tenant_id);
         if (request.sub_tenant_id != null) {
             _request.append("sub_tenant_id", request.sub_tenant_id);
@@ -76,13 +67,21 @@ class Upload {
         if (request.upsert != null) {
             _request.append("upsert", request.upsert.toString());
         }
+        if (request.files != null) {
+            for (const _file of request.files) {
+                await _request.appendFile("files", _file);
+            }
+        }
         if (request.file_metadata != null) {
             _request.append("file_metadata", request.file_metadata);
         }
+        if (request.app_sources != null) {
+            _request.append("app_sources", request.app_sources);
+        }
         const _maybeEncodedRequest = await _request.getRequest();
         let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ Authorization: await this._getAuthorizationHeader() }, _maybeEncodedRequest.headers)), 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, "ingestion/upload-document"),
+            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, "ingestion/upload_knowledge"),
             method: "POST",
             headers: _headers,
             queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
@@ -128,7 +127,7 @@ class Upload {
                     rawResponse: _response.rawResponse,
                 });
             case "timeout":
-                throw new errors.CortexAITimeoutError("Timeout exceeded when calling POST /ingestion/upload-document.");
+                throw new errors.CortexAITimeoutError("Timeout exceeded when calling POST /ingestion/upload_knowledge.");
             case "unknown":
                 throw new errors.CortexAIError({
                     message: _response.error.errorMessage,
@@ -137,98 +136,6 @@ class Upload {
         }
     }
     /**
-     * Upload structured sources generated by first-party or third-party apps.
-     * Supports both single and batch uploads.
-     *
-     * @param {CortexAI.BodyUploadAppIngestionUploadAppPost} request
-     * @param {Upload.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.upload.uploadAppSources({
-     *         app_sources: {
-     *             id: "id",
-     *             tenant_id: "tenant_id",
-     *             sub_tenant_id: "sub_tenant_id"
-     *         },
-     *         tenant_id: "tenant_id"
-     *     })
-     */
-    uploadAppSources(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__uploadAppSources(request, requestOptions));
-    }
-    async __uploadAppSources(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, "ingestion/upload-app"),
-            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 /ingestion/upload-app.");
-            case "unknown":
-                throw new errors.CortexAIError({
-                    message: _response.error.errorMessage,
-                    rawResponse: _response.rawResponse,
-                });
-        }
-    }
-    /**
-     * Check the current processing status of your uploaded content.
-     *
-     * This endpoint allows you to monitor the progress of documents, text, or other content you've uploaded. Simply provide the file ID to see whether processing is complete, still in progress, or if any errors occurred.
-     *
-     * Use this to determine when your content is ready for search and retrieval, or to troubleshoot any processing issues.
-     *
      * @param {CortexAI.UploadVerifyProcessingRequest} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -242,7 +149,8 @@ class Upload {
      *
      * @example
      *     await client.upload.verifyProcessing({
-     *         file_id: "file_id"
+     *         file_id: "<str>",
+     *         tenant_id: "tenant_1234"
      *     })
      */
     verifyProcessing(request, requestOptions) {
@@ -261,7 +169,7 @@ class Upload {
         }
         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, "ingestion/verify-processing"),
+            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, "ingestion/verify_processing"),
             method: "POST",
             headers: _headers,
             queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
@@ -304,7 +212,7 @@ class Upload {
                     rawResponse: _response.rawResponse,
                 });
             case "timeout":
-                throw new errors.CortexAITimeoutError("Timeout exceeded when calling POST /ingestion/verify-processing.");
+                throw new errors.CortexAITimeoutError("Timeout exceeded when calling POST /ingestion/verify_processing.");
             case "unknown":
                 throw new errors.CortexAIError({
                     message: _response.error.errorMessage,
@@ -313,24 +221,6 @@ class Upload {
         }
     }
     /**
-     * Add memories for indexing and retrieval.
-     *
-     *     This API provides a unified entry point for ingesting various types of content:
-     *
-     *     **Content Types Supported:**
-     *     - Raw text content (`text` field)
-     *     - Markdown formatted content (`text` + `is_markdown=true`)
-     *     - User/assistant conversation pairs (`user_assistant_pairs` field)
-     *
-     *     **Key Features:**
-     *     - **Inference Mode (`infer=true`)**: When enabled, the system extracts additional
-     *       insights and implicit information from your content. Useful for conversation
-     *       analysis and knowledge extraction.
-     *     - **Direct Mode (`infer=false`)**: Content is chunked and indexed as-is without
-     *       additional processing.
-     *
-     *     Use `/ingestion/verify-processing` endpoint to check the processing status.
-     *
      * @param {CortexAI.BodyAddMemoryMemoriesAddMemoryPost} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -345,7 +235,7 @@ class Upload {
      * @example
      *     await client.upload.addMemory({
      *         memories: [{}],
-     *         tenant_id: "tenant_id"
+     *         tenant_id: "tenant_1234"
      *     })
      */
     addMemory(request, requestOptions) {
@@ -410,14 +300,6 @@ class Upload {
         }
     }
     /**
-     * Permanently remove a specific memory from storage.
-     *
-     *     This API allows you to delete a memory by its unique identifier.
-     *     Once deleted, the memory cannot be recovered, so use this operation carefully.
-     *
-     *     The memory will be removed from your tenant's storage and will no longer
-     *     appear in search results or memory listings.
-     *
      * @param {CortexAI.UploadDeleteMemoryRequest} request
      * @param {Upload.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -431,8 +313,8 @@ class Upload {
      *
      * @example
      *     await client.upload.deleteMemory({
-     *         tenant_id: "tenant_id",
-     *         memory_id: "memory_id"
+     *         tenant_id: "tenant_1234",
+     *         memory_id: "memory_1234"
      *     })
      */
     deleteMemory(request, requestOptions) {

package/dist/api/resources/upload/client/requests/BodyAddMemoryMemoriesAddMemoryPost.d.ts

@@ -6,7 +6,7 @@ import * as CortexAI from "../../../../index.js";
  * @example
  *     {
  *         memories: [{}],
- *         tenant_id: "tenant_id"
+ *         tenant_id: "tenant_1234"
  *     }
  */
 export interface BodyAddMemoryMemoriesAddMemoryPost {

package/dist/api/resources/upload/client/requests/{BodyUploadDocumentIngestionUploadDocumentPost.d.ts → BodyUploadKnowledgeIngestionUploadKnowledgePost.d.ts}

@@ -5,18 +5,20 @@ import * as core from "../../../../../core/index.js";
 /**
  * @example
  *     {
- *         files: [fs.createReadStream("/path/to/your/file")],
  *         tenant_id: "tenant_id"
  *     }
  */
-export interface BodyUploadDocumentIngestionUploadDocumentPost {
-    /** Files to be uploaded */
-    files: core.file.Uploadable.FileLike[];
+export interface BodyUploadKnowledgeIngestionUploadKnowledgePost {
     /** 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;
+    /** If true, update existing sources with the same id. */
     upsert?: boolean;
-    /** JSON Array of file metadata objects */
+    /** Files to upload (documents). Omit or leave empty when only sending app_sources. */
+    files?: core.file.Uploadable.FileLike[] | undefined;
+    /** JSON array of file metadata objects; length must match files when provided. */
     file_metadata?: string;
+    /** JSON: single source object or array of app-generated sources to index. Omit when only uploading files. */
+    app_sources?: string;
 }

package/dist/api/resources/upload/client/requests/UploadDeleteMemoryRequest.d.ts

@@ -4,8 +4,8 @@
 /**
  * @example
  *     {
- *         tenant_id: "tenant_id",
- *         memory_id: "memory_id"
+ *         tenant_id: "tenant_1234",
+ *         memory_id: "memory_1234"
  *     }
  */
 export interface UploadDeleteMemoryRequest {

package/dist/api/resources/upload/client/requests/UploadVerifyProcessingRequest.d.ts

@@ -4,7 +4,8 @@
 /**
  * @example
  *     {
- *         file_id: "file_id"
+ *         file_id: "<str>",
+ *         tenant_id: "tenant_1234"
  *     }
  */
 export interface UploadVerifyProcessingRequest {

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

@@ -1,5 +1,4 @@
-export { type BodyUploadDocumentIngestionUploadDocumentPost } from "./BodyUploadDocumentIngestionUploadDocumentPost.js";
-export { type BodyUploadAppIngestionUploadAppPost } from "./BodyUploadAppIngestionUploadAppPost.js";
+export { type BodyUploadKnowledgeIngestionUploadKnowledgePost } from "./BodyUploadKnowledgeIngestionUploadKnowledgePost.js";
 export { type UploadVerifyProcessingRequest } from "./UploadVerifyProcessingRequest.js";
 export { type BodyAddMemoryMemoriesAddMemoryPost } from "./BodyAddMemoryMemoriesAddMemoryPost.js";
 export { type UploadDeleteMemoryRequest } from "./UploadDeleteMemoryRequest.js";

package/dist/api/types/ListContentKind.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type ListContentKind = "knowledge" | "memories";
+export declare const ListContentKind: {
+    readonly Knowledge: "knowledge";
+    readonly Memories: "memories";
+};

package/dist/api/types/ListContentKind.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListContentKind = void 0;
+exports.ListContentKind = {
+    Knowledge: "knowledge",
+    Memories: "memories",
+};

package/dist/api/types/ListUserMemoriesResponse.d.ts

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as CortexAI from "../index.js";
+/**
+ * Response model for listing all user memories.
+ */
+export interface ListUserMemoriesResponse {
+    /** Indicates whether the memory listing operation was successful */
+    success?: boolean;
+    /** Array of all user memories associated with your tenant */
+    user_memories?: CortexAI.UserMemory[];
+}

package/dist/api/types/RetrievalResult.d.ts

@@ -9,5 +9,5 @@ export interface RetrievalResult {
     chunks?: CortexAI.VectorStoreChunk[];
     graph_context?: CortexAI.GraphContext;
     /** Map of chunk_uuid to VectorStoreChunk for extra context from forcefully related sources. Use chunk.extra_context_ids to look up chunks: extra_context[id] for id in chunk.extra_context_ids. */
-    extra_context?: Record<string, CortexAI.VectorStoreChunk>;
+    additional_context?: Record<string, CortexAI.VectorStoreChunk>;
 }

package/dist/api/types/RetrieveMode.d.ts

@@ -1,8 +1,8 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export type RetrieveMode = "fast" | "accurate";
+export type RetrieveMode = "fast" | "thinking";
 export declare const RetrieveMode: {
     readonly Fast: "fast";
-    readonly Accurate: "accurate";
+    readonly Thinking: "thinking";
 };

package/dist/api/types/RetrieveMode.js

@@ -6,5 +6,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RetrieveMode = void 0;
 exports.RetrieveMode = {
     Fast: "fast",
-    Accurate: "accurate",
+    Thinking: "thinking",
 };