@nebula-ai/sdk 1.1.15 → 1.1.17

package/dist/index.d.mts

@@ -6,7 +6,7 @@ declare enum GraphSearchResultType {
 interface Chunk {
     id: string;
     content: string;
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
     role?: string;
 }
 /**
@@ -17,33 +17,49 @@ interface StructuredChunk {
     text: string;
     role: 'user' | 'assistant' | 'system';
 }
-interface MemoryResponse {
-    id: string;
-    content?: string;
-    chunks?: Chunk[];
-    metadata: Record<string, any>;
-    collection_ids: string[];
-    created_at?: string;
-    updated_at?: string;
+interface TextContentPart {
+    type: 'text';
+    text: string;
+}
+interface FileContentPart {
+    type?: 'image' | 'audio' | 'document' | 'file';
+    data: string;
+    media_type: string;
+    filename?: string;
+    duration_seconds?: number;
 }
-interface Memory {
-    collection_id: string;
-    content: string | string[] | Array<{
-        content: string;
+interface S3FileReferencePart {
+    type: 's3_ref';
+    s3_key: string;
+    bucket?: string;
+    media_type: string;
+    filename?: string;
+    size_bytes?: number;
+}
+type MultimodalContentPart = TextContentPart | FileContentPart | S3FileReferencePart;
+interface Memory$1 {
+    collection_id?: string;
+    content?: string | string[] | MultimodalContentPart[] | Array<{
+        content: string | MultimodalContentPart[];
         role: string;
-        metadata?: Record<string, any>;
+        metadata?: Record<string, unknown>;
         authority?: number;
     }>;
     role?: string;
+    id?: string;
     memory_id?: string;
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
     authority?: number;
+    chunks?: Chunk[];
+    collection_ids?: string[];
+    created_at?: string;
+    updated_at?: string;
 }
 interface Collection {
     id: string;
     name: string;
     description?: string;
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
     created_at?: string;
     updated_at?: string;
     memory_count: number;
@@ -52,13 +68,14 @@ interface Collection {
 interface SearchResult {
     id: string;
     score: number;
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
     source?: string;
     timestamp?: string;
     display_name?: string;
     source_role?: string;
     memory_id?: string;
     owner_id?: string;
+    engram_id?: string;
     content?: string;
     graph_result_type?: GraphSearchResultType;
     graph_entity?: GraphEntityResult;
@@ -70,7 +87,7 @@ interface GraphEntityResult {
     id?: string;
     name: string;
     description: string;
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
 }
 interface GraphRelationshipResult {
     id?: string;
@@ -80,17 +97,17 @@ interface GraphRelationshipResult {
     subject_id?: string;
     object_id?: string;
     description?: string;
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
 }
 interface GraphCommunityResult {
     id?: string;
     name: string;
     summary: string;
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
 }
 interface SearchOptions {
     limit: number;
-    filters?: Record<string, any>;
+    filters?: Record<string, unknown>;
     search_mode?: 'fast' | 'super';
 }
 interface RecallFocus {
@@ -105,7 +122,7 @@ interface ActivatedEntity {
     activation_score: number;
     activation_reason?: string;
     traversal_depth: number;
-    profile?: Record<string, any>;
+    profile?: Record<string, unknown>;
 }
 interface ActivatedFact {
     fact_id: string;
@@ -129,9 +146,9 @@ interface GroundedUtterance {
     timestamp?: string;
     display_name?: string;
     supporting_fact_ids: string[];
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
-interface MemoryRecall {
+interface MemoryResponse {
     query: string;
     entities: ActivatedEntity[];
     facts: ActivatedFact[];
@@ -150,8 +167,8 @@ interface NebulaClientConfig {
 }
 declare class NebulaException extends Error {
     statusCode?: number | undefined;
-    details?: any | undefined;
-    constructor(message: string, statusCode?: number | undefined, details?: any | undefined);
+    details?: unknown | undefined;
+    constructor(message: string, statusCode?: number | undefined, details?: unknown | undefined);
 }
 declare class NebulaClientException extends NebulaException {
     cause?: Error | undefined;
@@ -164,8 +181,8 @@ declare class NebulaRateLimitException extends NebulaException {
     constructor(message?: string);
 }
 declare class NebulaValidationException extends NebulaException {
-    details?: any | undefined;
-    constructor(message?: string, details?: any | undefined);
+    details?: unknown | undefined;
+    constructor(message?: string, details?: unknown | undefined);
 }
 declare class NebulaCollectionNotFoundException extends NebulaException {
     constructor(message?: string);
@@ -182,7 +199,8 @@ declare class Nebula {
     private apiKey;
     private baseUrl;
     private timeout;
-    constructor(config: NebulaClientConfig);
+    private static readonly MAX_INLINE_SIZE;
+    constructor(config?: NebulaClientConfig);
     setApiKey(next: string): void;
     setBaseUrl(next: string): void;
     setCorsProxy(_next: string): void;
@@ -192,13 +210,19 @@ declare class Nebula {
     private _isNebulaApiKey;
     /** Build authentication headers */
     private _buildAuthHeaders;
+    private _isRecord;
+    private _unwrapResults;
+    private _unwrapResultsArray;
+    private _looksLikeMultimodalContent;
+    private _normalizeContentParts;
+    private _serializeContentAsText;
     /** Make an HTTP request to the Nebula API */
     private _makeRequest;
     /** Create a new collection */
     createCollection(options: {
         name: string;
         description?: string;
-        metadata?: Record<string, any>;
+        metadata?: Record<string, unknown>;
     }): Promise<Collection>;
     /** Get a specific collection by ID */
     getCollection(collectionId: string): Promise<Collection>;
@@ -215,14 +239,14 @@ declare class Nebula {
         collectionId: string;
         name?: string;
         description?: string;
-        metadata?: Record<string, any>;
+        metadata?: Record<string, unknown>;
     }): Promise<Collection>;
     /** Delete a collection */
     deleteCollection(collectionId: string): Promise<boolean>;
     /**
      * Legacy convenience: store raw text content into a collection as a document
      */
-    store(content: string, collectionId: string, metadata?: Record<string, any>): Promise<MemoryResponse>;
+    store(content: string, collectionId: string, metadata?: Record<string, unknown>): Promise<Memory$1>;
     /**
      * Store a single memory using the unified engrams API.
      *
@@ -230,15 +254,15 @@ declare class Nebula {
      * - If role is present, creates a conversation
      * - Otherwise, creates a document
      */
-    storeMemory(memory: Memory | Record<string, any>, name?: string): Promise<string>;
+    storeMemory(memory: Memory$1 | Record<string, unknown>, name?: string): Promise<string>;
     /**
-     * Internal method to append content to an existing engram
+     * Internal method to append content to an existing memory
      *
-     * @throws NebulaNotFoundException if engram_id doesn't exist
+     * @throws NebulaNotFoundException if memory_id doesn't exist
      */
     private _appendToMemory;
     /** Store multiple memories using the unified engrams API */
-    storeMemories(memories: Memory[]): Promise<string[]>;
+    storeMemories(memories: Memory$1[]): Promise<string[]>;
     /** Delete one or more memories */
     delete(memoryIds: string | string[]): Promise<boolean | {
         message: string;
@@ -258,7 +282,7 @@ 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, any>): Promise<boolean>;
+    updateChunk(chunkId: string, content: string, metadata?: Record<string, unknown>): Promise<boolean>;
     /**
      * Update memory-level properties including name, metadata, and collection associations.
      *
@@ -284,7 +308,7 @@ declare class Nebula {
     updateMemory(options: {
         memoryId: string;
         name?: string;
-        metadata?: Record<string, any>;
+        metadata?: Record<string, unknown>;
         collectionIds?: string[];
         mergeMetadata?: boolean;
     }): Promise<boolean>;
@@ -325,18 +349,17 @@ declare class Nebula {
         collection_ids: string | string[];
         limit?: number;
         offset?: number;
-        metadata_filters?: Record<string, any>;
-    }): Promise<MemoryResponse[]>;
+        metadata_filters?: Record<string, unknown>;
+    }): Promise<Memory$1[]>;
     /** Get a specific memory by engram ID */
-    getMemory(memoryId: string): Promise<MemoryResponse>;
+    getMemory(memoryId: string): Promise<Memory$1>;
     /**
      * Search within specific collections with optional metadata filtering.
      *
      * @param options - Search configuration
      * @param options.query - Search query string
      * @param options.collection_ids - One or more collection IDs to search within
-     * @param options.limit - Maximum number of results to return (default: 10)
-     * @param options.retrieval_type - Retrieval strategy (default: ADVANCED)
+     * @param options.effort - Compute effort budget (auto/low/medium/high). Controls traversal compute, not MemoryResponse size.
      * @param options.filters - Optional filters to apply to the search. Supports comprehensive metadata filtering
      *                          with MongoDB-like operators for both vector/chunk search and graph search.
      * @param options.searchSettings - Optional search configuration
@@ -428,16 +451,56 @@ declare class Nebula {
     search(options: {
         query: string;
         collection_ids?: string | string[];
-        limit?: number;
-        filters?: Record<string, any>;
-        searchSettings?: Record<string, any>;
-    }): Promise<MemoryRecall>;
-    healthCheck(): Promise<Record<string, any>>;
+        effort?: 'auto' | 'low' | 'medium' | 'high';
+        filters?: Record<string, unknown>;
+        searchSettings?: Record<string, unknown>;
+    }): Promise<MemoryResponse>;
+    healthCheck(): Promise<Record<string, unknown>>;
     private _collectionFromDict;
     private _memoryResponseFromDict;
     private _searchResultFromDict;
     private _searchResultFromGraphDict;
     private _sha256;
+    private _formDataFromObject;
+    /**
+     * Convert and process multimodal content parts, auto-uploading large base64 files to S3.
+     *
+     * - Binary parts (`image`/`audio`/`document` with `data`) larger than 5MB are uploaded to S3 and converted to `s3_ref`.
+     */
+    private _processContentParts;
+    /**
+     * Get a presigned URL for uploading large files to S3.
+     */
+    getUploadUrl(options: {
+        filename: string;
+        content_type: string;
+        file_size: number;
+    }): Promise<{
+        upload_url: string;
+        s3_key: string;
+        bucket: string;
+        expires_in: number;
+    }>;
 }
 
-export { type ActivatedEntity, type ActivatedFact, type Chunk, type Collection, type GraphCommunityResult, type GraphEntityResult, type GraphRelationshipResult, GraphSearchResultType, type GroundedUtterance, type Memory, type MemoryRecall, type MemoryResponse, Nebula, NebulaAuthenticationException, type NebulaClientConfig, NebulaClientException, NebulaCollectionNotFoundException, NebulaException, NebulaNotFoundException, NebulaRateLimitException, NebulaValidationException, type RecallFocus, type SearchOptions, type SearchResult, type StructuredChunk, Nebula as default };
+/**
+ * Utility for creating multimodal content from files.
+ * Note: These methods only work in Node.js environments.
+ */
+declare class NebulaContent {
+    /**
+     * Create a FileContentPart from a file path.
+     * Automatically deduces media_type and the backend 'type' (image, audio, document).
+     */
+    static fromFile(filePath: string, mediaType?: string): Promise<FileContentPart>;
+}
+
+type MemoryFactory = {
+    (data: Memory$1): Memory$1;
+    File: typeof NebulaContent.fromFile;
+    fromFile: (filePath: string, collection_id: string, metadata?: Record<string, unknown>, role?: string) => Promise<Memory$1>;
+};
+declare const Memory: MemoryFactory;
+type Memory = Memory$1;
+
+export { type ActivatedEntity, 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 RecallFocus, type S3FileReferencePart, type SearchOptions, type SearchResult, type StructuredChunk, type TextContentPart, Nebula as default };

package/dist/index.d.ts

@@ -6,7 +6,7 @@ declare enum GraphSearchResultType {
 interface Chunk {
     id: string;
     content: string;
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
     role?: string;
 }
 /**
@@ -17,33 +17,49 @@ interface StructuredChunk {
     text: string;
     role: 'user' | 'assistant' | 'system';
 }
-interface MemoryResponse {
-    id: string;
-    content?: string;
-    chunks?: Chunk[];
-    metadata: Record<string, any>;
-    collection_ids: string[];
-    created_at?: string;
-    updated_at?: string;
+interface TextContentPart {
+    type: 'text';
+    text: string;
+}
+interface FileContentPart {
+    type?: 'image' | 'audio' | 'document' | 'file';
+    data: string;
+    media_type: string;
+    filename?: string;
+    duration_seconds?: number;
 }
-interface Memory {
-    collection_id: string;
-    content: string | string[] | Array<{
-        content: string;
+interface S3FileReferencePart {
+    type: 's3_ref';
+    s3_key: string;
+    bucket?: string;
+    media_type: string;
+    filename?: string;
+    size_bytes?: number;
+}
+type MultimodalContentPart = TextContentPart | FileContentPart | S3FileReferencePart;
+interface Memory$1 {
+    collection_id?: string;
+    content?: string | string[] | MultimodalContentPart[] | Array<{
+        content: string | MultimodalContentPart[];
         role: string;
-        metadata?: Record<string, any>;
+        metadata?: Record<string, unknown>;
         authority?: number;
     }>;
     role?: string;
+    id?: string;
     memory_id?: string;
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
     authority?: number;
+    chunks?: Chunk[];
+    collection_ids?: string[];
+    created_at?: string;
+    updated_at?: string;
 }
 interface Collection {
     id: string;
     name: string;
     description?: string;
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
     created_at?: string;
     updated_at?: string;
     memory_count: number;
@@ -52,13 +68,14 @@ interface Collection {
 interface SearchResult {
     id: string;
     score: number;
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
     source?: string;
     timestamp?: string;
     display_name?: string;
     source_role?: string;
     memory_id?: string;
     owner_id?: string;
+    engram_id?: string;
     content?: string;
     graph_result_type?: GraphSearchResultType;
     graph_entity?: GraphEntityResult;
@@ -70,7 +87,7 @@ interface GraphEntityResult {
     id?: string;
     name: string;
     description: string;
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
 }
 interface GraphRelationshipResult {
     id?: string;
@@ -80,17 +97,17 @@ interface GraphRelationshipResult {
     subject_id?: string;
     object_id?: string;
     description?: string;
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
 }
 interface GraphCommunityResult {
     id?: string;
     name: string;
     summary: string;
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
 }
 interface SearchOptions {
     limit: number;
-    filters?: Record<string, any>;
+    filters?: Record<string, unknown>;
     search_mode?: 'fast' | 'super';
 }
 interface RecallFocus {
@@ -105,7 +122,7 @@ interface ActivatedEntity {
     activation_score: number;
     activation_reason?: string;
     traversal_depth: number;
-    profile?: Record<string, any>;
+    profile?: Record<string, unknown>;
 }
 interface ActivatedFact {
     fact_id: string;
@@ -129,9 +146,9 @@ interface GroundedUtterance {
     timestamp?: string;
     display_name?: string;
     supporting_fact_ids: string[];
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
-interface MemoryRecall {
+interface MemoryResponse {
     query: string;
     entities: ActivatedEntity[];
     facts: ActivatedFact[];
@@ -150,8 +167,8 @@ interface NebulaClientConfig {
 }
 declare class NebulaException extends Error {
     statusCode?: number | undefined;
-    details?: any | undefined;
-    constructor(message: string, statusCode?: number | undefined, details?: any | undefined);
+    details?: unknown | undefined;
+    constructor(message: string, statusCode?: number | undefined, details?: unknown | undefined);
 }
 declare class NebulaClientException extends NebulaException {
     cause?: Error | undefined;
@@ -164,8 +181,8 @@ declare class NebulaRateLimitException extends NebulaException {
     constructor(message?: string);
 }
 declare class NebulaValidationException extends NebulaException {
-    details?: any | undefined;
-    constructor(message?: string, details?: any | undefined);
+    details?: unknown | undefined;
+    constructor(message?: string, details?: unknown | undefined);
 }
 declare class NebulaCollectionNotFoundException extends NebulaException {
     constructor(message?: string);
@@ -182,7 +199,8 @@ declare class Nebula {
     private apiKey;
     private baseUrl;
     private timeout;
-    constructor(config: NebulaClientConfig);
+    private static readonly MAX_INLINE_SIZE;
+    constructor(config?: NebulaClientConfig);
     setApiKey(next: string): void;
     setBaseUrl(next: string): void;
     setCorsProxy(_next: string): void;
@@ -192,13 +210,19 @@ declare class Nebula {
     private _isNebulaApiKey;
     /** Build authentication headers */
     private _buildAuthHeaders;
+    private _isRecord;
+    private _unwrapResults;
+    private _unwrapResultsArray;
+    private _looksLikeMultimodalContent;
+    private _normalizeContentParts;
+    private _serializeContentAsText;
     /** Make an HTTP request to the Nebula API */
     private _makeRequest;
     /** Create a new collection */
     createCollection(options: {
         name: string;
         description?: string;
-        metadata?: Record<string, any>;
+        metadata?: Record<string, unknown>;
     }): Promise<Collection>;
     /** Get a specific collection by ID */
     getCollection(collectionId: string): Promise<Collection>;
@@ -215,14 +239,14 @@ declare class Nebula {
         collectionId: string;
         name?: string;
         description?: string;
-        metadata?: Record<string, any>;
+        metadata?: Record<string, unknown>;
     }): Promise<Collection>;
     /** Delete a collection */
     deleteCollection(collectionId: string): Promise<boolean>;
     /**
      * Legacy convenience: store raw text content into a collection as a document
      */
-    store(content: string, collectionId: string, metadata?: Record<string, any>): Promise<MemoryResponse>;
+    store(content: string, collectionId: string, metadata?: Record<string, unknown>): Promise<Memory$1>;
     /**
      * Store a single memory using the unified engrams API.
      *
@@ -230,15 +254,15 @@ declare class Nebula {
      * - If role is present, creates a conversation
      * - Otherwise, creates a document
      */
-    storeMemory(memory: Memory | Record<string, any>, name?: string): Promise<string>;
+    storeMemory(memory: Memory$1 | Record<string, unknown>, name?: string): Promise<string>;
     /**
-     * Internal method to append content to an existing engram
+     * Internal method to append content to an existing memory
      *
-     * @throws NebulaNotFoundException if engram_id doesn't exist
+     * @throws NebulaNotFoundException if memory_id doesn't exist
      */
     private _appendToMemory;
     /** Store multiple memories using the unified engrams API */
-    storeMemories(memories: Memory[]): Promise<string[]>;
+    storeMemories(memories: Memory$1[]): Promise<string[]>;
     /** Delete one or more memories */
     delete(memoryIds: string | string[]): Promise<boolean | {
         message: string;
@@ -258,7 +282,7 @@ 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, any>): Promise<boolean>;
+    updateChunk(chunkId: string, content: string, metadata?: Record<string, unknown>): Promise<boolean>;
     /**
      * Update memory-level properties including name, metadata, and collection associations.
      *
@@ -284,7 +308,7 @@ declare class Nebula {
     updateMemory(options: {
         memoryId: string;
         name?: string;
-        metadata?: Record<string, any>;
+        metadata?: Record<string, unknown>;
         collectionIds?: string[];
         mergeMetadata?: boolean;
     }): Promise<boolean>;
@@ -325,18 +349,17 @@ declare class Nebula {
         collection_ids: string | string[];
         limit?: number;
         offset?: number;
-        metadata_filters?: Record<string, any>;
-    }): Promise<MemoryResponse[]>;
+        metadata_filters?: Record<string, unknown>;
+    }): Promise<Memory$1[]>;
     /** Get a specific memory by engram ID */
-    getMemory(memoryId: string): Promise<MemoryResponse>;
+    getMemory(memoryId: string): Promise<Memory$1>;
     /**
      * Search within specific collections with optional metadata filtering.
      *
      * @param options - Search configuration
      * @param options.query - Search query string
      * @param options.collection_ids - One or more collection IDs to search within
-     * @param options.limit - Maximum number of results to return (default: 10)
-     * @param options.retrieval_type - Retrieval strategy (default: ADVANCED)
+     * @param options.effort - Compute effort budget (auto/low/medium/high). Controls traversal compute, not MemoryResponse size.
      * @param options.filters - Optional filters to apply to the search. Supports comprehensive metadata filtering
      *                          with MongoDB-like operators for both vector/chunk search and graph search.
      * @param options.searchSettings - Optional search configuration
@@ -428,16 +451,56 @@ declare class Nebula {
     search(options: {
         query: string;
         collection_ids?: string | string[];
-        limit?: number;
-        filters?: Record<string, any>;
-        searchSettings?: Record<string, any>;
-    }): Promise<MemoryRecall>;
-    healthCheck(): Promise<Record<string, any>>;
+        effort?: 'auto' | 'low' | 'medium' | 'high';
+        filters?: Record<string, unknown>;
+        searchSettings?: Record<string, unknown>;
+    }): Promise<MemoryResponse>;
+    healthCheck(): Promise<Record<string, unknown>>;
     private _collectionFromDict;
     private _memoryResponseFromDict;
     private _searchResultFromDict;
     private _searchResultFromGraphDict;
     private _sha256;
+    private _formDataFromObject;
+    /**
+     * Convert and process multimodal content parts, auto-uploading large base64 files to S3.
+     *
+     * - Binary parts (`image`/`audio`/`document` with `data`) larger than 5MB are uploaded to S3 and converted to `s3_ref`.
+     */
+    private _processContentParts;
+    /**
+     * Get a presigned URL for uploading large files to S3.
+     */
+    getUploadUrl(options: {
+        filename: string;
+        content_type: string;
+        file_size: number;
+    }): Promise<{
+        upload_url: string;
+        s3_key: string;
+        bucket: string;
+        expires_in: number;
+    }>;
 }
 
-export { type ActivatedEntity, type ActivatedFact, type Chunk, type Collection, type GraphCommunityResult, type GraphEntityResult, type GraphRelationshipResult, GraphSearchResultType, type GroundedUtterance, type Memory, type MemoryRecall, type MemoryResponse, Nebula, NebulaAuthenticationException, type NebulaClientConfig, NebulaClientException, NebulaCollectionNotFoundException, NebulaException, NebulaNotFoundException, NebulaRateLimitException, NebulaValidationException, type RecallFocus, type SearchOptions, type SearchResult, type StructuredChunk, Nebula as default };
+/**
+ * Utility for creating multimodal content from files.
+ * Note: These methods only work in Node.js environments.
+ */
+declare class NebulaContent {
+    /**
+     * Create a FileContentPart from a file path.
+     * Automatically deduces media_type and the backend 'type' (image, audio, document).
+     */
+    static fromFile(filePath: string, mediaType?: string): Promise<FileContentPart>;
+}
+
+type MemoryFactory = {
+    (data: Memory$1): Memory$1;
+    File: typeof NebulaContent.fromFile;
+    fromFile: (filePath: string, collection_id: string, metadata?: Record<string, unknown>, role?: string) => Promise<Memory$1>;
+};
+declare const Memory: MemoryFactory;
+type Memory = Memory$1;
+
+export { type ActivatedEntity, 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 RecallFocus, type S3FileReferencePart, type SearchOptions, type SearchResult, type StructuredChunk, type TextContentPart, Nebula as default };