@nebula-ai/sdk 1.1.27 → 1.1.28

package/dist/index.d.mts

@@ -282,8 +282,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 +480,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;

package/dist/index.d.ts

@@ -282,8 +282,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 +480,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;

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);
       }
@@ -851,6 +855,58 @@ var _Nebula = class _Nebula {
     };
     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");