@usecortex_ai/node 0.4.0 → 0.5.1

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/ForcefulRelationsPayload.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface ForcefulRelationsPayload {
+    /** Cortex source IDs to forcefully relate to the uploaded source. */
+    cortex_source_ids?: string[];
+    /** Optional properties to attach to the forceful relation. */
+    properties?: Record<string, unknown>;
+}

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/MemoryItem.d.ts

@@ -17,7 +17,7 @@ export interface MemoryItem {
     user_assistant_pairs?: CortexAI.UserAssistantPair[];
     /** Whether the text is markdown formatted. */
     is_markdown?: boolean;
-    /** If true, process and extract additional insights/inferences from the content before indexing. Useful for extracting implicit information from conversations. */
+    /** If true, process and extract additional insights/inferences from the contentbefore indexingUseful for extracting implicit information from conversations */
     infer?: boolean;
     /** Custom instructions to guide inference processing. */
     custom_instructions?: string;
@@ -38,4 +38,6 @@ export interface MemoryItem {
      *
      */
     document_metadata?: string;
+    /** Forcefully connect 2 sources based on cortex source ids or common properties. */
+    relations?: CortexAI.ForcefulRelationsPayload;
 }

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

@@ -8,4 +8,6 @@ import * as CortexAI from "../index.js";
 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. */
+    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",
 };

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

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Represents a user memory stored in the system.
+ */
+export interface UserMemory {
+    /** Unique identifier for the user memory */
+    memory_id: string;
+    /** The actual memory content text that was stored */
+    memory_content: string;
+}

package/dist/api/types/UserMemory.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -24,4 +24,6 @@ export interface VectorStoreChunk {
     document_metadata?: Record<string, unknown>;
     /** Custom metadata associated with your tenant */
     tenant_metadata?: Record<string, unknown>;
+    /** IDs of related chunks providing extra context (from forceful relations). Only present in accurate mode when sources have forceful relations. */
+    extra_context_ids?: string[];
 }

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

@@ -1,7 +1,6 @@
 export * from "./ActualErrorResponse.js";
 export * from "./AddMemoryResponse.js";
 export * from "./ApiKeyInfo.js";
-export * from "./AppSourcesUploadData.js";
 export * from "./AttachmentModel.js";
 export * from "./Bm25OperatorType.js";
 export * from "./CollectionStats.js";
@@ -15,10 +14,13 @@ export * from "./DeleteUserMemoryResponse.js";
 export * from "./Entity.js";
 export * from "./ErrorResponse.js";
 export * from "./FetchMode.js";
+export * from "./ForcefulRelationsPayload.js";
 export * from "./GraphContext.js";
 export * from "./HttpValidationError.js";
 export * from "./Infra.js";
 export * from "./InsertResult.js";
+export * from "./ListContentKind.js";
+export * from "./ListUserMemoriesResponse.js";
 export * from "./MemoryItem.js";
 export * from "./MemoryResultItem.js";
 export * from "./MilvusDataType.js";
@@ -49,5 +51,6 @@ export * from "./TenantMetadataSchemaInfo.js";
 export * from "./TenantStatsResponse.js";
 export * from "./TripletWithEvidence.js";
 export * from "./UserAssistantPair.js";
+export * from "./UserMemory.js";
 export * from "./ValidationError.js";
 export * from "./VectorStoreChunk.js";

package/dist/api/types/index.js

@@ -17,7 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ActualErrorResponse.js"), exports);
 __exportStar(require("./AddMemoryResponse.js"), exports);
 __exportStar(require("./ApiKeyInfo.js"), exports);
-__exportStar(require("./AppSourcesUploadData.js"), exports);
 __exportStar(require("./AttachmentModel.js"), exports);
 __exportStar(require("./Bm25OperatorType.js"), exports);
 __exportStar(require("./CollectionStats.js"), exports);
@@ -31,10 +30,13 @@ __exportStar(require("./DeleteUserMemoryResponse.js"), exports);
 __exportStar(require("./Entity.js"), exports);
 __exportStar(require("./ErrorResponse.js"), exports);
 __exportStar(require("./FetchMode.js"), exports);
+__exportStar(require("./ForcefulRelationsPayload.js"), exports);
 __exportStar(require("./GraphContext.js"), exports);
 __exportStar(require("./HttpValidationError.js"), exports);
 __exportStar(require("./Infra.js"), exports);
 __exportStar(require("./InsertResult.js"), exports);
+__exportStar(require("./ListContentKind.js"), exports);
+__exportStar(require("./ListUserMemoriesResponse.js"), exports);
 __exportStar(require("./MemoryItem.js"), exports);
 __exportStar(require("./MemoryResultItem.js"), exports);
 __exportStar(require("./MilvusDataType.js"), exports);
@@ -65,5 +67,6 @@ __exportStar(require("./TenantMetadataSchemaInfo.js"), exports);
 __exportStar(require("./TenantStatsResponse.js"), exports);
 __exportStar(require("./TripletWithEvidence.js"), exports);
 __exportStar(require("./UserAssistantPair.js"), exports);
+__exportStar(require("./UserMemory.js"), exports);
 __exportStar(require("./ValidationError.js"), exports);
 __exportStar(require("./VectorStoreChunk.js"), exports);

package/package.json

@@ -1,31 +1,34 @@
 {
-    "name": "@usecortex_ai/node",
-    "version": "0.4.0",
-    "description": "The official TypeScript SDK for the Cortex AI platform.",
-    "author": "Nishkarsh Shrivastava <nishkarsh@usecortex.ai>",
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "files": [
-        "dist"
-    ],
-    "keywords": [
-        "cortex",
-        "cortex-ai",
-        "cortex-ai-sdk",
-        "cortex-ai-typescript-sdk",
-        "rag", "gen-ai", "memory", "ai"
-    ],
-    "scripts": {
-        "build": "tsc",
-        "prepublishOnly": "npm run build"
-    },
-    "dependencies": {
-        "form-data": "^4.0.0",
-        "node-fetch": "2.7.0"
-    },
-    "devDependencies": {
-        "@types/node": "^18.19.3",
-        "@types/node-fetch": "2.6.9",
-        "typescript": "5.3.3"
-    }
-}
+  "name": "@usecortex_ai/node",
+  "version": "0.5.1",
+  "description": "The official TypeScript SDK for the Cortex AI platform.",
+  "author": "Nishkarsh Shrivastava <nishkarsh@usecortex.ai>",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "cortex",
+    "cortex-ai",
+    "cortex-ai-sdk",
+    "cortex-ai-typescript-sdk",
+    "rag",
+    "gen-ai",
+    "memory",
+    "ai"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "form-data": "^4.0.0",
+    "node-fetch": "2.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^18.19.3",
+    "@types/node-fetch": "2.6.9",
+    "typescript": "5.3.3"
+  }
+}

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

@@ -1,15 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-/**
- * @example
- *     {
- *         tenant_id: "tenant_id"
- *     }
- */
-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. */
-    sub_tenant_id?: string;
-}

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

@@ -1,18 +0,0 @@
-/**
- * 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/BodyUploadAppIngestionUploadAppPost.d.ts

@@ -1,31 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as CortexAI from "../../../../index.js";
-/**
- * @example
- *     {
- *         app_sources: {
- *             id: "id",
- *             tenant_id: "tenant_id",
- *             sub_tenant_id: "sub_tenant_id"
- *         },
- *         tenant_id: "tenant_id"
- *     }
- */
-export interface BodyUploadAppIngestionUploadAppPost {
-    /** Single source object or list of structured source objects containing app-generated data to be indexed */
-    app_sources: BodyUploadAppIngestionUploadAppPost.AppSources;
-    /** 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 source_id. Defaults to True. */
-    upsert?: boolean;
-}
-export declare namespace BodyUploadAppIngestionUploadAppPost {
-    /**
-     * Single source object or list of structured source objects containing app-generated data to be indexed
-     */
-    type AppSources = CortexAI.SourceModel | CortexAI.SourceModel[];
-}

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

@@ -1,17 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as CortexAI from "../index.js";
-/**
- * Response model for uploads of app-generated sources.
- */
-export interface AppSourcesUploadData {
-    success?: boolean;
-    message?: string;
-    /** List of upload results for each source. */
-    results?: CortexAI.SourceUploadResultItem[];
-    /** Number of sources successfully queued. */
-    success_count?: number;
-    /** Number of sources that failed to upload. */
-    failed_count?: number;
-}