@usecortex_ai/node 0.3.5 → 0.3.6

package/dist/api/resources/userMemory/client/requests/AddUserMemoryRequest.d.ts

@@ -14,7 +14,7 @@ export interface AddUserMemoryRequest {
     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;
-    /** Single raw text memory to store */
+    /** Single raw text memory to store. If both raw_text and user_assistant_pairs are provided, raw_text will be used. */
     raw_text?: string;
     /** Array of user/assistant conversation pairs to store as a single memory */
     user_assistant_pairs?: CortexAI.UserAssistantPair[];

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

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as CortexAI from "../index.js";
+/**
+ * Graph relations with group_id -> triplet mapping
+ */
+export interface ChunkGraphRelationsResponse {
+    /** Multi-hop paths connecting entities from the query, reranked by relevance. Each path is a chain of connected triplets. */
+    entity_paths?: CortexAI.ScoredPathResponse[];
+    /** Mapping of group_id to scored triplet. Use chunk.graph_triplet_ids to find which groups belong to a chunk. */
+    chunk_triplets?: Record<string, CortexAI.ScoredTripletResponse>;
+}

package/dist/api/types/ChunkGraphRelationsResponse.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/ExtendedContext.d.ts

@@ -1,8 +1,5 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import * as CortexAI from "../index.js";
 export interface ExtendedContext {
-    /** Relations linked with this chunk */
-    chunk_relations?: CortexAI.TripleWithEvidence[];
 }

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

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as CortexAI from "../index.js";
+/**
+ * Single triplet within a path (without score, as the path is scored as a whole)
+ */
+export interface PathTriplet {
+    /** Source entity */
+    source: CortexAI.Entity;
+    /** Target entity */
+    target: CortexAI.Entity;
+    /** Relation between entities */
+    relation: CortexAI.RelationEvidence;
+}

package/dist/api/types/PathTriplet.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/RelationEvidence.d.ts

@@ -1,20 +1,19 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-/**
- * Single piece of evidence for a relationship between two entities
- */
 export interface RelationEvidence {
+    /** Unique identifier for this specific relationship edge in the graph. The combination of source entity, target entity, and relationship_id allows disambiguation between multiple relations between the same source and target entities. */
+    relationship_id?: string;
     /** Relationship phrase like 'works for', 'reports to' */
     canonical_predicate: string;
     /** Original predicate from text */
     raw_predicate: string;
     /** Rich contextual description of the relationship with surrounding information, details about how/why/when, and any relevant background. Should be comprehensive enough to understand the relationship without referring back to source. */
     context: string;
-    /** Confidence score */
-    confidence?: number;
     /** Temporal timing information extracted from text (e.g., 'last week', 'in 2023', 'yesterday') */
     temporal_details?: string;
+    /** The chunk_id this relation came from */
+    chunk_id?: string;
     /** Timestamp when this relation was introduced */
     timestamp?: string;
 }

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

@@ -5,8 +5,8 @@ import * as CortexAI from "../index.js";
 export interface RetrieveResponse {
     /** Retrieved content chunks */
     chunks?: CortexAI.SearchChunk[];
-    /** Extra graph context which will help you agent get better understanding of the entities involved in query. */
-    extra_graph_context?: CortexAI.TripleWithEvidence[];
+    /** Graph relations with chunk_relations (by chunk_id) and entity_relations (top entity matches) */
+    graph_relations?: CortexAI.ChunkGraphRelationsResponse;
     /** Additional metadata about the retrieval run */
     metadata?: Record<string, unknown>;
 }

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

@@ -10,6 +10,6 @@ export interface RetrieveUserMemoryResponse {
     success: boolean;
     /** Array of user memories ranked by relevance to your search query */
     retrieved_user_memories?: CortexAI.UserMemory[];
-    /** Array of relations extracted from the user query */
-    relations?: CortexAI.TripleWithEvidence[];
+    /** Array of scored relations extracted from the user query via knowledge graph search */
+    relations?: CortexAI.ScoredPathResponse[];
 }

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

@@ -0,0 +1,18 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as CortexAI from "../index.js";
+/**
+ * A multi-hop path (chain of triplets) with a relevancy score.
+ *
+ * Represents connected paths like: A --rel1--> B --rel2--> C
+ * The triplets list preserves the chain order.
+ */
+export interface ScoredPathResponse {
+    /** Merged context from all triplets in the path */
+    combined_context?: string;
+    /** Ordered list of triplets forming the path chain */
+    triplets: CortexAI.PathTriplet[];
+    /** Relevancy score for the entire path */
+    relevancy_score?: number;
+}

package/dist/api/types/ScoredPathResponse.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/ScoredTripletResponse.d.ts

@@ -0,0 +1,17 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as CortexAI from "../index.js";
+/**
+ * Individual scored triplet for entity-based search results
+ */
+export interface ScoredTripletResponse {
+    /** Source entity */
+    source: CortexAI.Entity;
+    /** Target entity */
+    target: CortexAI.Entity;
+    /** Relation between entities */
+    relation: CortexAI.RelationEvidence;
+    /** Relevancy score from reranking */
+    relevancy_score?: number;
+}

package/dist/api/types/ScoredTripletResponse.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/SearchChunk.d.ts

@@ -27,4 +27,6 @@ export interface SearchChunk {
     tenant_metadata?: Record<string, unknown>;
     /** Additional context for this chunk */
     extra_context?: CortexAI.ExtendedContext;
+    /** List of group IDs for triplets linked to this chunk. Lookup triplet data in graph_relations.chunk_relations[group_id] */
+    graph_triplet_ids?: string[];
 }

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

@@ -2,9 +2,6 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as CortexAI from "../index.js";
-/**
- * Triple with multiple evidence items from different chunks
- */
 export interface TripleWithEvidence {
     source: CortexAI.Entity;
     target: CortexAI.Entity;

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

@@ -6,6 +6,7 @@ export * from "./Bm25OperatorType.js";
 export * from "./BatchUploadData.js";
 export * from "./BodyScrapeWebpageUploadScrapeWebpagePost.js";
 export * from "./BodyUpdateScrapeJobUploadUpdateWebpagePatch.js";
+export * from "./ChunkGraphRelationsResponse.js";
 export * from "./ContentModel.js";
 export * from "./DeleteMemoryRequest.js";
 export * from "./DeleteSources.js";
@@ -25,6 +26,7 @@ export * from "./HttpValidationError.js";
 export * from "./ListSourcesResponse.js";
 export * from "./ListUserMemoriesResponse.js";
 export * from "./MarkdownUploadRequest.js";
+export * from "./PathTriplet.js";
 export * from "./ProcessingStatus.js";
 export * from "./RelatedChunk.js";
 export * from "./RelationEvidence.js";
@@ -32,6 +34,8 @@ export * from "./Relations.js";
 export * from "./RetrieveMode.js";
 export * from "./RetrieveResponse.js";
 export * from "./RetrieveUserMemoryResponse.js";
+export * from "./ScoredPathResponse.js";
+export * from "./ScoredTripletResponse.js";
 export * from "./SearchChunk.js";
 export * from "./SingleUploadData.js";
 export * from "./Source.js";

package/dist/api/types/index.js

@@ -22,6 +22,7 @@ __exportStar(require("./Bm25OperatorType.js"), exports);
 __exportStar(require("./BatchUploadData.js"), exports);
 __exportStar(require("./BodyScrapeWebpageUploadScrapeWebpagePost.js"), exports);
 __exportStar(require("./BodyUpdateScrapeJobUploadUpdateWebpagePatch.js"), exports);
+__exportStar(require("./ChunkGraphRelationsResponse.js"), exports);
 __exportStar(require("./ContentModel.js"), exports);
 __exportStar(require("./DeleteMemoryRequest.js"), exports);
 __exportStar(require("./DeleteSources.js"), exports);
@@ -41,6 +42,7 @@ __exportStar(require("./HttpValidationError.js"), exports);
 __exportStar(require("./ListSourcesResponse.js"), exports);
 __exportStar(require("./ListUserMemoriesResponse.js"), exports);
 __exportStar(require("./MarkdownUploadRequest.js"), exports);
+__exportStar(require("./PathTriplet.js"), exports);
 __exportStar(require("./ProcessingStatus.js"), exports);
 __exportStar(require("./RelatedChunk.js"), exports);
 __exportStar(require("./RelationEvidence.js"), exports);
@@ -48,6 +50,8 @@ __exportStar(require("./Relations.js"), exports);
 __exportStar(require("./RetrieveMode.js"), exports);
 __exportStar(require("./RetrieveResponse.js"), exports);
 __exportStar(require("./RetrieveUserMemoryResponse.js"), exports);
+__exportStar(require("./ScoredPathResponse.js"), exports);
+__exportStar(require("./ScoredTripletResponse.js"), exports);
 __exportStar(require("./SearchChunk.js"), exports);
 __exportStar(require("./SingleUploadData.js"), exports);
 __exportStar(require("./Source.js"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usecortex_ai/node",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "The official TypeScript SDK for the Cortex AI platform.",
   "author": "Nishkarsh Shrivastava <nishkarsh@usecortex.ai>",
   "main": "./dist/index.js",