@nebula-ai/sdk 1.1.28 → 1.1.30

package/dist/index.d.mts

@@ -123,12 +123,13 @@ interface ActivatedFacet {
     facet_id: string;
     facet_name: string;
     relevance_score: number;
-    facts: ActivatedFact[];
+    facts: ActivatedKnowledge[];
     coherence_score?: number;
     is_noise: boolean;
 }
-interface ActivatedFact {
+interface ActivatedKnowledge {
     id?: string;
+    category?: string;
     entity_id?: string;
     entity_name?: string;
     facet_name?: string;
@@ -140,8 +141,11 @@ interface ActivatedFact {
     corroboration_count?: number;
     confidence?: number;
     source_chunk_ids?: string[];
+    reasoning?: string;
+    resolved_at?: string;
+    source_nodegroup_ids?: string[];
 }
-interface GroundedUtterance {
+interface GroundedSource {
     id?: string;
     text: string;
     activation_score: number;
@@ -154,29 +158,24 @@ interface GroundedUtterance {
     supporting_fact_ids?: string[];
     metadata?: Record<string, unknown>;
 }
-interface InferenceHint {
-    term: string;
-    predicate: string;
-    object: string;
-    inferred?: boolean;
-    confidence?: number;
-    ledger_p_use?: number;
-    ledger_p_true?: number;
-    ledger_p_stable?: number;
-    usable_for_rewrite?: boolean;
-    used_for_rewrite?: boolean;
-    relationship_id?: string;
-    subject_id?: string;
-    object_id?: string;
-    metadata?: Record<string, unknown>;
-    inference_metadata?: Record<string, unknown>;
+interface ActivatedEpisode {
+    id?: string;
+    name: string;
+    activation_score: number;
+    status?: string;
+    t_start?: number;
+    t_last?: number;
+    n_facts: number;
+    member_knowledge_ids?: string[];
+    source_chunk_ids?: string[];
+    entity_names?: string[];
 }
 interface MemoryResponse {
     query: string;
     entities: ActivatedEntity[];
-    facts: ActivatedFact[];
-    utterances: GroundedUtterance[];
-    inference_hints?: InferenceHint[];
+    knowledge: ActivatedKnowledge[];
+    episodes?: ActivatedEpisode[];
+    sources: GroundedSource[];
     total_traversal_time_ms?: number;
     token_count?: number;
 }
@@ -304,16 +303,16 @@ declare class Nebula {
             };
         };
     }>;
-    /** Delete a specific chunk or message within a memory */
-    deleteChunk(chunkId: string): Promise<boolean>;
-    /** Update a specific chunk or message within a memory */
-    updateChunk(chunkId: string, content: string, metadata?: Record<string, unknown>): Promise<boolean>;
+    /** Delete a specific source within a memory */
+    deleteSource(sourceId: string): Promise<boolean>;
+    /** Update a specific source within a memory */
+    updateSource(sourceId: string, content: string, metadata?: Record<string, unknown>): Promise<boolean>;
     /**
      * Update memory-level properties including name, metadata, and collection associations.
      *
      * This method allows updating properties of an entire memory (document or conversation)
-     * without modifying its content. For updating individual chunks or messages within a memory,
-     * use updateChunk(). For updating content, use storeMemory() to append.
+     * without modifying its content. For updating individual sources within a memory,
+     * use updateSource(). For updating content, use storeMemory() to append.
      *
      * @param options - Update configuration
      * @param options.memoryId - The ID of the memory to update
@@ -546,4 +545,4 @@ type MemoryFactory = {
 declare const Memory: MemoryFactory;
 type Memory = Memory$1;
 
-export { type ActivatedEntity, type ActivatedFacet, type ActivatedFact, type Chunk, type Collection, type FileContentPart, type GraphCommunityResult, type GraphEntityResult, type GraphRelationshipResult, GraphSearchResultType, type GroundedUtterance, Memory, type MemoryResponse, type MultimodalContentPart, Nebula, NebulaAuthenticationException, type NebulaClientConfig, NebulaClientException, NebulaCollectionNotFoundException, NebulaContent, NebulaException, NebulaNotFoundException, NebulaRateLimitException, NebulaValidationException, type S3FileReferencePart, type SearchOptions, type SearchResult, type StructuredChunk, type TextContentPart, Nebula as default };
+export { type ActivatedEntity, type ActivatedEpisode, type ActivatedFacet, type ActivatedKnowledge, type Chunk, type Collection, type FileContentPart, type GraphCommunityResult, type GraphEntityResult, type GraphRelationshipResult, GraphSearchResultType, type GroundedSource, Memory, type MemoryResponse, type MultimodalContentPart, Nebula, NebulaAuthenticationException, type NebulaClientConfig, NebulaClientException, NebulaCollectionNotFoundException, NebulaContent, NebulaException, NebulaNotFoundException, NebulaRateLimitException, NebulaValidationException, type S3FileReferencePart, type SearchOptions, type SearchResult, type StructuredChunk, type TextContentPart, Nebula as default };

package/dist/index.d.ts

@@ -123,12 +123,13 @@ interface ActivatedFacet {
     facet_id: string;
     facet_name: string;
     relevance_score: number;
-    facts: ActivatedFact[];
+    facts: ActivatedKnowledge[];
     coherence_score?: number;
     is_noise: boolean;
 }
-interface ActivatedFact {
+interface ActivatedKnowledge {
     id?: string;
+    category?: string;
     entity_id?: string;
     entity_name?: string;
     facet_name?: string;
@@ -140,8 +141,11 @@ interface ActivatedFact {
     corroboration_count?: number;
     confidence?: number;
     source_chunk_ids?: string[];
+    reasoning?: string;
+    resolved_at?: string;
+    source_nodegroup_ids?: string[];
 }
-interface GroundedUtterance {
+interface GroundedSource {
     id?: string;
     text: string;
     activation_score: number;
@@ -154,29 +158,24 @@ interface GroundedUtterance {
     supporting_fact_ids?: string[];
     metadata?: Record<string, unknown>;
 }
-interface InferenceHint {
-    term: string;
-    predicate: string;
-    object: string;
-    inferred?: boolean;
-    confidence?: number;
-    ledger_p_use?: number;
-    ledger_p_true?: number;
-    ledger_p_stable?: number;
-    usable_for_rewrite?: boolean;
-    used_for_rewrite?: boolean;
-    relationship_id?: string;
-    subject_id?: string;
-    object_id?: string;
-    metadata?: Record<string, unknown>;
-    inference_metadata?: Record<string, unknown>;
+interface ActivatedEpisode {
+    id?: string;
+    name: string;
+    activation_score: number;
+    status?: string;
+    t_start?: number;
+    t_last?: number;
+    n_facts: number;
+    member_knowledge_ids?: string[];
+    source_chunk_ids?: string[];
+    entity_names?: string[];
 }
 interface MemoryResponse {
     query: string;
     entities: ActivatedEntity[];
-    facts: ActivatedFact[];
-    utterances: GroundedUtterance[];
-    inference_hints?: InferenceHint[];
+    knowledge: ActivatedKnowledge[];
+    episodes?: ActivatedEpisode[];
+    sources: GroundedSource[];
     total_traversal_time_ms?: number;
     token_count?: number;
 }
@@ -304,16 +303,16 @@ declare class Nebula {
             };
         };
     }>;
-    /** Delete a specific chunk or message within a memory */
-    deleteChunk(chunkId: string): Promise<boolean>;
-    /** Update a specific chunk or message within a memory */
-    updateChunk(chunkId: string, content: string, metadata?: Record<string, unknown>): Promise<boolean>;
+    /** Delete a specific source within a memory */
+    deleteSource(sourceId: string): Promise<boolean>;
+    /** Update a specific source within a memory */
+    updateSource(sourceId: string, content: string, metadata?: Record<string, unknown>): Promise<boolean>;
     /**
      * Update memory-level properties including name, metadata, and collection associations.
      *
      * This method allows updating properties of an entire memory (document or conversation)
-     * without modifying its content. For updating individual chunks or messages within a memory,
-     * use updateChunk(). For updating content, use storeMemory() to append.
+     * without modifying its content. For updating individual sources within a memory,
+     * use updateSource(). For updating content, use storeMemory() to append.
      *
      * @param options - Update configuration
      * @param options.memoryId - The ID of the memory to update
@@ -546,4 +545,4 @@ type MemoryFactory = {
 declare const Memory: MemoryFactory;
 type Memory = Memory$1;
 
-export { type ActivatedEntity, type ActivatedFacet, type ActivatedFact, type Chunk, type Collection, type FileContentPart, type GraphCommunityResult, type GraphEntityResult, type GraphRelationshipResult, GraphSearchResultType, type GroundedUtterance, Memory, type MemoryResponse, type MultimodalContentPart, Nebula, NebulaAuthenticationException, type NebulaClientConfig, NebulaClientException, NebulaCollectionNotFoundException, NebulaContent, NebulaException, NebulaNotFoundException, NebulaRateLimitException, NebulaValidationException, type S3FileReferencePart, type SearchOptions, type SearchResult, type StructuredChunk, type TextContentPart, Nebula as default };
+export { type ActivatedEntity, type ActivatedEpisode, type ActivatedFacet, type ActivatedKnowledge, type Chunk, type Collection, type FileContentPart, type GraphCommunityResult, type GraphEntityResult, type GraphRelationshipResult, GraphSearchResultType, type GroundedSource, Memory, type MemoryResponse, type MultimodalContentPart, Nebula, NebulaAuthenticationException, type NebulaClientConfig, NebulaClientException, NebulaCollectionNotFoundException, NebulaContent, NebulaException, NebulaNotFoundException, NebulaRateLimitException, NebulaValidationException, type S3FileReferencePart, type SearchOptions, type SearchResult, type StructuredChunk, type TextContentPart, Nebula as default };

package/dist/index.js

@@ -578,30 +578,30 @@ var _Nebula = class _Nebula {
       throw new NebulaClientException(`Unknown error: ${String(error)}`);
     }
   }
-  /** Delete a specific chunk or message within a memory */
-  async deleteChunk(chunkId) {
+  /** Delete a specific source within a memory */
+  async deleteSource(sourceId) {
     try {
-      await this._makeRequest("DELETE", `/v1/chunks/${chunkId}`);
+      await this._makeRequest("DELETE", `/v1/sources/${sourceId}`);
       return true;
     } catch (error) {
       if (error instanceof NebulaException && error.statusCode === 404) {
-        throw new NebulaNotFoundException(chunkId, "Chunk");
+        throw new NebulaNotFoundException(sourceId, "Source");
       }
       throw error;
     }
   }
-  /** Update a specific chunk or message within a memory */
-  async updateChunk(chunkId, content, metadata) {
+  /** Update a specific source within a memory */
+  async updateSource(sourceId, content, metadata) {
     const payload = { content };
     if (metadata !== void 0) {
       payload.metadata = metadata;
     }
     try {
-      await this._makeRequest("PATCH", `/v1/chunks/${chunkId}`, payload);
+      await this._makeRequest("PATCH", `/v1/sources/${sourceId}`, payload);
       return true;
     } catch (error) {
       if (error instanceof NebulaException && error.statusCode === 404) {
-        throw new NebulaNotFoundException(chunkId, "Chunk");
+        throw new NebulaNotFoundException(sourceId, "Source");
       }
       throw error;
     }
@@ -610,8 +610,8 @@ var _Nebula = class _Nebula {
    * Update memory-level properties including name, metadata, and collection associations.
    *
    * This method allows updating properties of an entire memory (document or conversation)
-   * without modifying its content. For updating individual chunks or messages within a memory,
-   * use updateChunk(). For updating content, use storeMemory() to append.
+   * without modifying its content. For updating individual sources within a memory,
+   * use updateSource(). For updating content, use storeMemory() to append.
    *
    * @param options - Update configuration
    * @param options.memoryId - The ID of the memory to update
@@ -847,9 +847,9 @@ var _Nebula = class _Nebula {
     const memoryResponse = {
       query: memoryResponseData.query || options.query,
       entities: memoryResponseData.entities || [],
-      facts: memoryResponseData.facts || [],
-      utterances: memoryResponseData.utterances || [],
-      inference_hints: memoryResponseData.inference_hints || [],
+      knowledge: memoryResponseData.knowledge ?? [],
+      episodes: memoryResponseData.episodes || [],
+      sources: memoryResponseData.sources || memoryResponseData.utterances || [],
       total_traversal_time_ms: memoryResponseData.total_traversal_time_ms,
       token_count: memoryResponseData.token_count
     };