@nebula-ai/sdk 1.1.29 → 1.1.31

package/dist/index.d.mts

@@ -130,12 +130,13 @@ interface ActivatedFacet {
 interface ActivatedKnowledge {
     id?: string;
     category?: string;
+    description?: string;
     entity_id?: string;
     entity_name?: string;
     facet_name?: string;
-    subject: string;
-    predicate: string;
-    value: string;
+    subject?: string;
+    predicate?: string;
+    value?: string;
     activation_score: number;
     extraction_confidence?: number;
     corroboration_count?: number;
@@ -145,7 +146,7 @@ interface ActivatedKnowledge {
     resolved_at?: string;
     source_nodegroup_ids?: string[];
 }
-interface GroundedUtterance {
+interface GroundedSource {
     id?: string;
     text: string;
     activation_score: number;
@@ -160,12 +161,13 @@ interface GroundedUtterance {
 }
 interface ActivatedEpisode {
     id?: string;
-    name: string;
+    name?: string;
+    description?: string;
     activation_score: number;
     status?: string;
     t_start?: number;
     t_last?: number;
-    n_facts: number;
+    n_facts?: number;
     member_knowledge_ids?: string[];
     source_chunk_ids?: string[];
     entity_names?: string[];
@@ -175,7 +177,7 @@ interface MemoryResponse {
     entities: ActivatedEntity[];
     knowledge: ActivatedKnowledge[];
     episodes?: ActivatedEpisode[];
-    utterances: GroundedUtterance[];
+    sources: GroundedSource[];
     total_traversal_time_ms?: number;
     token_count?: number;
 }
@@ -303,16 +305,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
@@ -545,4 +547,4 @@ type MemoryFactory = {
 declare const Memory: MemoryFactory;
 type Memory = Memory$1;
 
-export { type ActivatedEntity, type ActivatedEpisode, type ActivatedFacet, type ActivatedKnowledge, 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

@@ -130,12 +130,13 @@ interface ActivatedFacet {
 interface ActivatedKnowledge {
     id?: string;
     category?: string;
+    description?: string;
     entity_id?: string;
     entity_name?: string;
     facet_name?: string;
-    subject: string;
-    predicate: string;
-    value: string;
+    subject?: string;
+    predicate?: string;
+    value?: string;
     activation_score: number;
     extraction_confidence?: number;
     corroboration_count?: number;
@@ -145,7 +146,7 @@ interface ActivatedKnowledge {
     resolved_at?: string;
     source_nodegroup_ids?: string[];
 }
-interface GroundedUtterance {
+interface GroundedSource {
     id?: string;
     text: string;
     activation_score: number;
@@ -160,12 +161,13 @@ interface GroundedUtterance {
 }
 interface ActivatedEpisode {
     id?: string;
-    name: string;
+    name?: string;
+    description?: string;
     activation_score: number;
     status?: string;
     t_start?: number;
     t_last?: number;
-    n_facts: number;
+    n_facts?: number;
     member_knowledge_ids?: string[];
     source_chunk_ids?: string[];
     entity_names?: string[];
@@ -175,7 +177,7 @@ interface MemoryResponse {
     entities: ActivatedEntity[];
     knowledge: ActivatedKnowledge[];
     episodes?: ActivatedEpisode[];
-    utterances: GroundedUtterance[];
+    sources: GroundedSource[];
     total_traversal_time_ms?: number;
     token_count?: number;
 }
@@ -303,16 +305,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
@@ -545,4 +547,4 @@ type MemoryFactory = {
 declare const Memory: MemoryFactory;
 type Memory = Memory$1;
 
-export { type ActivatedEntity, type ActivatedEpisode, type ActivatedFacet, type ActivatedKnowledge, 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

@@ -183,7 +183,7 @@ var _Nebula = class _Nebula {
     return await this._processContentParts(normalized);
   }
   /** Make an HTTP request to the Nebula API */
-  async _makeRequest(method, endpoint, jsonData, params) {
+  async _makeRequest(method, endpoint, jsonData, params, extraHeaders) {
     const url = new URL(endpoint, this.baseUrl);
     if (params) {
       Object.entries(params).forEach(([key, value]) => {
@@ -198,7 +198,7 @@ var _Nebula = class _Nebula {
         }
       });
     }
-    const headers = this._buildAuthHeaders(true);
+    const headers = { ...this._buildAuthHeaders(true), ...extraHeaders };
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
     try {
@@ -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
@@ -830,8 +830,8 @@ var _Nebula = class _Nebula {
       data.effort = options.effort;
     }
     if (options.collection_ids) {
-      const collectionIds = Array.isArray(options.collection_ids) ? options.collection_ids : [options.collection_ids];
-      const validCollectionIds = collectionIds.filter((id) => id && id.trim() !== "");
+      const collectionIds2 = Array.isArray(options.collection_ids) ? options.collection_ids : [options.collection_ids];
+      const validCollectionIds = collectionIds2.filter((id) => id && id.trim() !== "");
       if (validCollectionIds.length) {
         data.collection_ids = validCollectionIds;
       }
@@ -842,14 +842,16 @@ var _Nebula = class _Nebula {
     if (options.searchSettings) {
       data.search_settings = options.searchSettings;
     }
-    const response = await this._makeRequest("POST", "/v1/memories/search", data);
+    const collectionIds = data.collection_ids;
+    const extraHeaders = collectionIds && collectionIds.length === 1 ? { "X-Nebula-Collection-Id": collectionIds[0] } : void 0;
+    const response = await this._makeRequest("POST", "/v1/memories/search", data, void 0, extraHeaders);
     const memoryResponseData = response.results;
     const memoryResponse = {
       query: memoryResponseData.query || options.query,
       entities: memoryResponseData.entities || [],
-      knowledge: memoryResponseData.knowledge ?? memoryResponseData.facts ?? [],
+      knowledge: memoryResponseData.knowledge ?? [],
       episodes: memoryResponseData.episodes || [],
-      utterances: memoryResponseData.utterances || [],
+      sources: memoryResponseData.sources || [],
       total_traversal_time_ms: memoryResponseData.total_traversal_time_ms,
       token_count: memoryResponseData.token_count
     };