@nebula-ai/sdk 1.1.30 → 1.2.0

package/dist/index.d.mts

@@ -123,19 +123,20 @@ interface ActivatedFacet {
     facet_id: string;
     facet_name: string;
     relevance_score: number;
-    facts: ActivatedKnowledge[];
+    facts: ActivatedSemantic[];
     coherence_score?: number;
     is_noise: boolean;
 }
-interface ActivatedKnowledge {
+interface ActivatedSemantic {
     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;
@@ -160,22 +161,30 @@ interface GroundedSource {
 }
 interface ActivatedEpisode {
     id?: string;
-    name: string;
+    name?: string;
+    description?: string;
     activation_score: number;
     status?: string;
     t_start?: number;
     t_last?: number;
-    n_facts: number;
-    member_knowledge_ids?: string[];
+    n_facts?: number;
+    member_semantic_ids?: string[];
     source_chunk_ids?: string[];
     entity_names?: string[];
 }
+interface ActivatedProcedure {
+    statement: string;
+    activation_score: number;
+    confidence: number;
+    is_negated?: boolean;
+}
 interface MemoryResponse {
     query: string;
-    entities: ActivatedEntity[];
-    knowledge: ActivatedKnowledge[];
+    semantics: ActivatedSemantic[];
+    procedures?: ActivatedProcedure[];
     episodes?: ActivatedEpisode[];
     sources: GroundedSource[];
+    entities: ActivatedEntity[];
     total_traversal_time_ms?: number;
     token_count?: number;
 }
@@ -545,4 +554,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 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 };
+export { type ActivatedEntity, type ActivatedEpisode, type ActivatedFacet, type ActivatedProcedure, type ActivatedSemantic, 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,19 +123,20 @@ interface ActivatedFacet {
     facet_id: string;
     facet_name: string;
     relevance_score: number;
-    facts: ActivatedKnowledge[];
+    facts: ActivatedSemantic[];
     coherence_score?: number;
     is_noise: boolean;
 }
-interface ActivatedKnowledge {
+interface ActivatedSemantic {
     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;
@@ -160,22 +161,30 @@ interface GroundedSource {
 }
 interface ActivatedEpisode {
     id?: string;
-    name: string;
+    name?: string;
+    description?: string;
     activation_score: number;
     status?: string;
     t_start?: number;
     t_last?: number;
-    n_facts: number;
-    member_knowledge_ids?: string[];
+    n_facts?: number;
+    member_semantic_ids?: string[];
     source_chunk_ids?: string[];
     entity_names?: string[];
 }
+interface ActivatedProcedure {
+    statement: string;
+    activation_score: number;
+    confidence: number;
+    is_negated?: boolean;
+}
 interface MemoryResponse {
     query: string;
-    entities: ActivatedEntity[];
-    knowledge: ActivatedKnowledge[];
+    semantics: ActivatedSemantic[];
+    procedures?: ActivatedProcedure[];
     episodes?: ActivatedEpisode[];
     sources: GroundedSource[];
+    entities: ActivatedEntity[];
     total_traversal_time_ms?: number;
     token_count?: number;
 }
@@ -545,4 +554,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 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 };
+export { type ActivatedEntity, type ActivatedEpisode, type ActivatedFacet, type ActivatedProcedure, type ActivatedSemantic, 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 {
@@ -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,16 +842,19 @@ 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 ?? [],
+      semantics: memoryResponseData.semantics || memoryResponseData.knowledge || [],
+      procedures: memoryResponseData.procedures || [],
       episodes: memoryResponseData.episodes || [],
-      sources: memoryResponseData.sources || memoryResponseData.utterances || [],
+      sources: memoryResponseData.sources || [],
       total_traversal_time_ms: memoryResponseData.total_traversal_time_ms,
-      token_count: memoryResponseData.token_count
+      token_count: memoryResponseData.token_count,
+      entities: memoryResponseData.entities || []
     };
     return memoryResponse;
   }