@nebula-ai/sdk 1.1.27 → 1.1.29

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,6 +141,9 @@ interface ActivatedFact {
     corroboration_count?: number;
     confidence?: number;
     source_chunk_ids?: string[];
+    reasoning?: string;
+    resolved_at?: string;
+    source_nodegroup_ids?: string[];
 }
 interface GroundedUtterance {
     id?: string;
@@ -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[];
+    knowledge: ActivatedKnowledge[];
+    episodes?: ActivatedEpisode[];
     utterances: GroundedUtterance[];
-    inference_hints?: InferenceHint[];
     total_traversal_time_ms?: number;
     token_count?: number;
 }
@@ -282,8 +281,12 @@ declare class Nebula {
      * @throws NebulaNotFoundException if memory_id doesn't exist
      */
     private _appendToMemory;
-    /** Store multiple memories using the unified engrams API */
-    storeMemories(memories: Memory$1[]): Promise<string[]>;
+    /** Store multiple memories using the unified engrams API.
+     *  @param memories - List of Memory objects to store.
+     *  @param metadata - Optional memory-level metadata for conversation groups.
+     *    Each Memory's own metadata is used as per-message metadata.
+     */
+    storeMemories(memories: Memory$1[], metadata?: Record<string, unknown>): Promise<string[]>;
     /** Delete one or more memories */
     delete(memoryIds: string | string[]): Promise<boolean | {
         message: string;
@@ -476,6 +479,24 @@ declare class Nebula {
         filters?: Record<string, unknown>;
         searchSettings?: Record<string, unknown>;
     }): Promise<MemoryResponse>;
+    /** List available connector providers */
+    listProviders(): Promise<string[]>;
+    /** Start an OAuth connection flow */
+    connectProvider(provider: string, collectionId: string, config?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** List active connections for a collection */
+    listConnections(collectionId: string): Promise<Record<string, unknown>[]>;
+    /** Browse Google Drive folders for a connection */
+    listFolders(connectionId: string, parentId?: string): Promise<Record<string, unknown>[]>;
+    /** List Slack channels for a connection */
+    listChannels(connectionId: string): Promise<Record<string, unknown>[]>;
+    /** Get a single connection by ID */
+    getConnection(connectionId: string): Promise<Record<string, unknown>>;
+    /** Manually trigger a sync for a connection */
+    triggerSync(connectionId: string): Promise<Record<string, unknown>>;
+    /** Update connection config (e.g., folder/channel selection) */
+    updateConnectionConfig(connectionId: string, config: Record<string, unknown>, apply?: string): Promise<Record<string, unknown>>;
+    /** Disconnect an external data source */
+    disconnect(connectionId: string, deleteMemories?: boolean): Promise<Record<string, unknown>>;
     healthCheck(): Promise<Record<string, unknown>>;
     private _collectionFromDict;
     private _memoryResponseFromDict;
@@ -524,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 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 };

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,6 +141,9 @@ interface ActivatedFact {
     corroboration_count?: number;
     confidence?: number;
     source_chunk_ids?: string[];
+    reasoning?: string;
+    resolved_at?: string;
+    source_nodegroup_ids?: string[];
 }
 interface GroundedUtterance {
     id?: string;
@@ -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[];
+    knowledge: ActivatedKnowledge[];
+    episodes?: ActivatedEpisode[];
     utterances: GroundedUtterance[];
-    inference_hints?: InferenceHint[];
     total_traversal_time_ms?: number;
     token_count?: number;
 }
@@ -282,8 +281,12 @@ declare class Nebula {
      * @throws NebulaNotFoundException if memory_id doesn't exist
      */
     private _appendToMemory;
-    /** Store multiple memories using the unified engrams API */
-    storeMemories(memories: Memory$1[]): Promise<string[]>;
+    /** Store multiple memories using the unified engrams API.
+     *  @param memories - List of Memory objects to store.
+     *  @param metadata - Optional memory-level metadata for conversation groups.
+     *    Each Memory's own metadata is used as per-message metadata.
+     */
+    storeMemories(memories: Memory$1[], metadata?: Record<string, unknown>): Promise<string[]>;
     /** Delete one or more memories */
     delete(memoryIds: string | string[]): Promise<boolean | {
         message: string;
@@ -476,6 +479,24 @@ declare class Nebula {
         filters?: Record<string, unknown>;
         searchSettings?: Record<string, unknown>;
     }): Promise<MemoryResponse>;
+    /** List available connector providers */
+    listProviders(): Promise<string[]>;
+    /** Start an OAuth connection flow */
+    connectProvider(provider: string, collectionId: string, config?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** List active connections for a collection */
+    listConnections(collectionId: string): Promise<Record<string, unknown>[]>;
+    /** Browse Google Drive folders for a connection */
+    listFolders(connectionId: string, parentId?: string): Promise<Record<string, unknown>[]>;
+    /** List Slack channels for a connection */
+    listChannels(connectionId: string): Promise<Record<string, unknown>[]>;
+    /** Get a single connection by ID */
+    getConnection(connectionId: string): Promise<Record<string, unknown>>;
+    /** Manually trigger a sync for a connection */
+    triggerSync(connectionId: string): Promise<Record<string, unknown>>;
+    /** Update connection config (e.g., folder/channel selection) */
+    updateConnectionConfig(connectionId: string, config: Record<string, unknown>, apply?: string): Promise<Record<string, unknown>>;
+    /** Disconnect an external data source */
+    disconnect(connectionId: string, deleteMemories?: boolean): Promise<Record<string, unknown>>;
     healthCheck(): Promise<Record<string, unknown>>;
     private _collectionFromDict;
     private _memoryResponseFromDict;
@@ -524,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 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 };

package/dist/index.js

@@ -473,8 +473,12 @@ var _Nebula = class _Nebula {
       throw error;
     }
   }
-  /** Store multiple memories using the unified engrams API */
-  async storeMemories(memories) {
+  /** Store multiple memories using the unified engrams API.
+   *  @param memories - List of Memory objects to store.
+   *  @param metadata - Optional memory-level metadata for conversation groups.
+   *    Each Memory's own metadata is used as per-message metadata.
+   */
+  async storeMemories(memories, metadata) {
     const results = [];
     const convGroups = {};
     const others = [];
@@ -517,7 +521,7 @@ var _Nebula = class _Nebula {
           collection_id: collectionId,
           name: "Conversation",
           messages,
-          metadata: {}
+          metadata: metadata ?? {}
         };
         const response = await this._makeRequest("POST", "/v1/memories", data);
         if (response.results) {
@@ -534,7 +538,7 @@ var _Nebula = class _Nebula {
           collection_id: collectionId,
           content: messages,
           memory_id: convId,
-          metadata: {}
+          metadata: metadata ?? {}
         };
         await this._appendToMemory(convId, appendMem);
       }
@@ -843,14 +847,66 @@ var _Nebula = class _Nebula {
     const memoryResponse = {
       query: memoryResponseData.query || options.query,
       entities: memoryResponseData.entities || [],
-      facts: memoryResponseData.facts || [],
+      knowledge: memoryResponseData.knowledge ?? memoryResponseData.facts ?? [],
+      episodes: memoryResponseData.episodes || [],
       utterances: memoryResponseData.utterances || [],
-      inference_hints: memoryResponseData.inference_hints || [],
       total_traversal_time_ms: memoryResponseData.total_traversal_time_ms,
       token_count: memoryResponseData.token_count
     };
     return memoryResponse;
   }
+  // Connector Methods
+  /** List available connector providers */
+  async listProviders() {
+    const response = await this._makeRequest("GET", "/v1/connectors/providers");
+    return this._unwrapResultsArray(response);
+  }
+  /** Start an OAuth connection flow */
+  async connectProvider(provider, collectionId, config) {
+    const body = { collection_id: collectionId };
+    if (config !== void 0) body.config = config;
+    const response = await this._makeRequest("POST", `/v1/connectors/${provider}/connect`, body);
+    return this._unwrapResults(response);
+  }
+  /** List active connections for a collection */
+  async listConnections(collectionId) {
+    const response = await this._makeRequest("GET", "/v1/connectors", void 0, { collection_id: collectionId });
+    return this._unwrapResultsArray(response);
+  }
+  /** Browse Google Drive folders for a connection */
+  async listFolders(connectionId, parentId) {
+    const params = {};
+    if (parentId !== void 0) params.parent_id = parentId;
+    const response = await this._makeRequest("GET", `/v1/connectors/${connectionId}/folders`, void 0, Object.keys(params).length ? params : void 0);
+    return this._unwrapResultsArray(response);
+  }
+  /** List Slack channels for a connection */
+  async listChannels(connectionId) {
+    const response = await this._makeRequest("GET", `/v1/connectors/${connectionId}/channels`);
+    return this._unwrapResultsArray(response);
+  }
+  /** Get a single connection by ID */
+  async getConnection(connectionId) {
+    const response = await this._makeRequest("GET", `/v1/connectors/${connectionId}`);
+    return this._unwrapResults(response);
+  }
+  /** Manually trigger a sync for a connection */
+  async triggerSync(connectionId) {
+    const response = await this._makeRequest("POST", `/v1/connectors/${connectionId}/sync`);
+    return this._unwrapResults(response);
+  }
+  /** Update connection config (e.g., folder/channel selection) */
+  async updateConnectionConfig(connectionId, config, apply = "full_resync") {
+    const response = await this._makeRequest("PATCH", `/v1/connectors/${connectionId}/config`, { config, apply });
+    return this._unwrapResults(response);
+  }
+  /** Disconnect an external data source */
+  async disconnect(connectionId, deleteMemories = false) {
+    const params = {};
+    if (deleteMemories) params.delete_memories = "true";
+    const response = await this._makeRequest("DELETE", `/v1/connectors/${connectionId}`, void 0, Object.keys(params).length ? params : void 0);
+    return this._unwrapResults(response);
+  }
   // Health Check
   async healthCheck() {
     return this._makeRequest("GET", "/v1/health");