@voltagent/libsql 1.0.13 → 1.1.0

package/dist/index.d.ts

@@ -1,17 +1,19 @@
-import { StorageAdapter, ConversationStepRecord, GetMessagesOptions, GetConversationStepsOptions, CreateConversationInput, Conversation, ConversationQueryOptions, WorkingMemoryScope, WorkflowStateEntry, ObservabilityStorageAdapter, ObservabilitySpan, ObservabilityLogRecord, LogFilter, VectorAdapter, VectorItem, VectorSearchOptions, SearchResult } from '@voltagent/core';
 import { Logger } from '@voltagent/logger';
-import { UIMessage } from 'ai';
+import { L as LibSQLMemoryCore, a as LibSQLMemoryCoreOptions, b as LibSQLObservabilityCore, c as LibSQLObservabilityCoreOptions, d as LibSQLVectorCore, e as LibSQLVectorCoreOptions } from './vector-core-CKn8FNVK.js';
+import '@libsql/client';
+import '@voltagent/core';
+import 'ai';
 
 /**
- * LibSQL Storage Adapter for Memory
+ * LibSQL Storage Adapter for Memory - Node.js
  * Stores conversations and messages in SQLite/Turso database
- * Compatible with existing LibSQL storage structure
+ * Supports both local file databases and remote Turso connections
  */
 
 /**
  * LibSQL configuration options for Memory
  */
-interface LibSQLMemoryOptions {
+interface LibSQLMemoryOptions extends LibSQLMemoryCoreOptions {
     /**
      * Database URL (e.g., 'file:./conversations.db' or 'libsql://...')
      * @default "file:./.voltagent/memory.db"
@@ -21,11 +23,6 @@ interface LibSQLMemoryOptions {
      * Auth token for remote connections (optional)
      */
     authToken?: string;
-    /**
-     * Prefix for table names
-     * @default "voltagent_memory"
-     */
-    tablePrefix?: string;
     /**
      * Enable debug logging
      * @default false
@@ -35,166 +32,29 @@ interface LibSQLMemoryOptions {
      * Logger instance
      */
     logger?: Logger;
-    /**
-     * Maximum number of retries for database operations
-     * @default 3
-     */
-    maxRetries?: number;
-    /**
-     * Initial retry delay in milliseconds
-     * @default 100
-     */
-    retryDelayMs?: number;
 }
 /**
- * LibSQL Storage Adapter for Memory
+ * LibSQL Storage Adapter for Memory - Node.js
  * Production-ready storage for conversations and messages
- * Compatible with existing LibSQL storage structure
+ * Supports both local SQLite files and remote Turso databases
  */
-declare class LibSQLMemoryAdapter implements StorageAdapter {
-    private client;
-    private tablePrefix;
-    private initialized;
-    private logger;
-    private maxRetries;
-    private retryDelayMs;
-    private url;
+declare class LibSQLMemoryAdapter extends LibSQLMemoryCore {
     constructor(options?: LibSQLMemoryOptions);
-    /**
-     * Execute a database operation with retry logic
-     */
-    private executeWithRetry;
-    /**
-     * Initialize database schema
-     */
-    private initialize;
-    /**
-     * Add new columns to messages table for V2 format if they don't exist
-     * This allows existing tables to support both old and new message formats
-     */
-    private addV2ColumnsToMessagesTable;
-    /**
-     * Migrate default user_id values in messages table
-     * Updates messages with user_id='default' to use the actual user_id from their conversation
-     */
-    private migrateDefaultUserIds;
-    /**
-     * Add new columns to workflow_states table for event persistence
-     * This migration adds support for events, output, and cancellation tracking
-     */
-    private addWorkflowStateColumns;
-    /**
-     * Add a single message
-     */
-    addMessage(message: UIMessage, userId: string, conversationId: string): Promise<void>;
-    /**
-     * Add multiple messages
-     */
-    addMessages(messages: UIMessage[], userId: string, conversationId: string): Promise<void>;
-    saveConversationSteps(steps: ConversationStepRecord[]): Promise<void>;
-    /**
-     * Get messages with optional filtering
-     */
-    getMessages(userId: string, conversationId: string, options?: GetMessagesOptions): Promise<UIMessage<{
-        createdAt: Date;
-    }>[]>;
-    getConversationSteps(userId: string, conversationId: string, options?: GetConversationStepsOptions): Promise<ConversationStepRecord[]>;
-    /**
-     * Clear messages for a user
-     */
-    clearMessages(userId: string, conversationId?: string): Promise<void>;
-    /**
-     * Create a new conversation
-     */
-    createConversation(input: CreateConversationInput): Promise<Conversation>;
-    /**
-     * Get a conversation by ID
-     */
-    getConversation(id: string): Promise<Conversation | null>;
-    /**
-     * Get conversations by resource ID
-     */
-    getConversations(resourceId: string): Promise<Conversation[]>;
-    /**
-     * Get conversations by user ID
-     */
-    getConversationsByUserId(userId: string, options?: Omit<ConversationQueryOptions, "userId">): Promise<Conversation[]>;
-    /**
-     * Query conversations with filters
-     */
-    queryConversations(options: ConversationQueryOptions): Promise<Conversation[]>;
-    /**
-     * Update a conversation
-     */
-    updateConversation(id: string, updates: Partial<Omit<Conversation, "id" | "createdAt" | "updatedAt">>): Promise<Conversation>;
-    /**
-     * Delete a conversation
-     */
-    deleteConversation(id: string): Promise<void>;
-    /**
-     * Get working memory
-     */
-    getWorkingMemory(params: {
-        conversationId?: string;
-        userId?: string;
-        scope: WorkingMemoryScope;
-    }): Promise<string | null>;
-    /**
-     * Set working memory
-     */
-    setWorkingMemory(params: {
-        conversationId?: string;
-        userId?: string;
-        content: string;
-        scope: WorkingMemoryScope;
-    }): Promise<void>;
-    /**
-     * Delete working memory
-     */
-    deleteWorkingMemory(params: {
-        conversationId?: string;
-        userId?: string;
-        scope: WorkingMemoryScope;
-    }): Promise<void>;
-    /**
-     * Get workflow state by execution ID
-     */
-    getWorkflowState(executionId: string): Promise<WorkflowStateEntry | null>;
-    /**
-     * Set workflow state
-     */
-    setWorkflowState(executionId: string, state: WorkflowStateEntry): Promise<void>;
-    /**
-     * Update workflow state
-     */
-    updateWorkflowState(executionId: string, updates: Partial<WorkflowStateEntry>): Promise<void>;
-    /**
-     * Get suspended workflow states for a workflow
-     */
-    getSuspendedWorkflowStates(workflowId: string): Promise<WorkflowStateEntry[]>;
-    /**
-     * Close database connection
-     */
-    close(): Promise<void>;
 }
 
 /**
- * LibSQL Observability Adapter
+ * LibSQL Observability Adapter - Node.js
  * Provides persistent storage for OpenTelemetry spans using LibSQL/Turso database
- * Part of the OpenTelemetry observability migration (Phase 3)
  */
 
 /**
  * Options for configuring the LibSQLObservabilityAdapter
  */
-interface LibSQLObservabilityOptions {
+interface LibSQLObservabilityOptions extends LibSQLObservabilityCoreOptions {
     /**
      * LibSQL connection URL
      * Can be either a remote Turso URL or a local file path
      * @default "file:./.voltagent/observability.db"
-     * @example "libsql://your-database.turso.io" for remote Turso
-     * @example "file:observability.db" for local SQLite in current directory
-     * @example "file:.voltagent/observability.db" for local SQLite in .voltagent folder
      */
     url?: string;
     /**
@@ -202,141 +62,29 @@ interface LibSQLObservabilityOptions {
      * Not needed for local SQLite
      */
     authToken?: string;
-    /**
-     * Prefix for table names
-     * @default "observability"
-     */
-    tablePrefix?: string;
-    /**
-     * Whether to enable debug logging
-     * @default false
-     */
-    debug?: boolean;
     /**
      * Optional logger instance
      */
     logger?: Logger;
-    /**
-     * Maximum number of spans to return in a single query
-     * @default 1000
-     */
-    maxSpansPerQuery?: number;
 }
 /**
- * LibSQL Observability Adapter
+ * LibSQL Observability Adapter - Node.js
  * Provides observability storage using LibSQL/Turso database
- * Implements the ObservabilityStorageAdapter interface for OpenTelemetry spans
+ * Supports both local SQLite files and remote Turso databases
  */
-declare class LibSQLObservabilityAdapter implements ObservabilityStorageAdapter {
-    private client;
-    private tablePrefix;
-    private debug;
-    private logger;
-    private initialized;
-    private maxSpansPerQuery;
+declare class LibSQLObservabilityAdapter extends LibSQLObservabilityCore {
     constructor(options?: LibSQLObservabilityOptions);
-    /**
-     * Log a debug message if debug is enabled
-     */
-    private debugLog;
-    /**
-     * Initialize database tables for observability
-     */
-    private initializeDatabase;
-    /**
-     * Ensure database is initialized before operations
-     */
-    private ensureInitialized;
-    /**
-     * Add a span to the database
-     */
-    addSpan(span: ObservabilitySpan): Promise<void>;
-    /**
-     * Update an existing span
-     */
-    updateSpan(spanId: string, updates: Partial<ObservabilitySpan>): Promise<void>;
-    /**
-     * Get a span by ID
-     */
-    getSpan(spanId: string): Promise<ObservabilitySpan | null>;
-    /**
-     * Get all spans in a trace
-     */
-    getTrace(traceId: string): Promise<ObservabilitySpan[]>;
-    /**
-     * List all traces with optional entity filter
-     */
-    listTraces(limit?: number, offset?: number, filter?: {
-        entityId?: string;
-        entityType?: "agent" | "workflow";
-    }): Promise<string[]>;
-    /**
-     * Delete old spans
-     */
-    deleteOldSpans(beforeTimestamp: number): Promise<number>;
-    /**
-     * Clear all spans, traces, and logs
-     */
-    clear(): Promise<void>;
-    /**
-     * Convert a database row to an ObservabilitySpan
-     */
-    private rowToSpan;
-    /**
-     * Get statistics about stored spans
-     */
-    getStats(): Promise<{
-        spanCount: number;
-        traceCount: number;
-        oldestSpan?: Date;
-        newestSpan?: Date;
-    }>;
-    /**
-     * Save a log record to the database
-     */
-    saveLogRecord(logRecord: any): Promise<void>;
-    /**
-     * Get logs by trace ID
-     */
-    getLogsByTraceId(traceId: string): Promise<ObservabilityLogRecord[]>;
-    /**
-     * Get logs by span ID
-     */
-    getLogsBySpanId(spanId: string): Promise<ObservabilityLogRecord[]>;
-    /**
-     * Query logs with flexible filtering
-     */
-    queryLogs(filter: LogFilter): Promise<ObservabilityLogRecord[]>;
-    /**
-     * Delete old logs
-     */
-    deleteOldLogs(beforeTimestamp: number): Promise<number>;
-    /**
-     * Convert a database row to an ObservabilityLogRecord
-     */
-    private rowToLogRecord;
-    getInfo(): {
-        adapter: string;
-        displayName: string;
-        persistent: boolean;
-        description: string;
-    };
-    /**
-     * Close the database connection
-     */
-    close(): Promise<void>;
 }
 
 /**
- * LibSQL Vector Adapter
+ * LibSQL Vector Adapter - Node.js
  * Provides vector storage and similarity search using LibSQL/Turso database
- * Stores vectors as binary BLOBs for efficiency
  */
 
 /**
  * LibSQL Vector Adapter configuration options
  */
-interface LibSQLVectorOptions {
+interface LibSQLVectorOptions extends LibSQLVectorCoreOptions {
     /**
      * Database URL (e.g., 'file:./memory.db' or 'libsql://...')
      * @default "file:./.voltagent/memory.db"
@@ -346,130 +94,26 @@ interface LibSQLVectorOptions {
      * Auth token for remote connections (optional)
      */
     authToken?: string;
-    /**
-     * Prefix for table names
-     * @default "voltagent"
-     */
-    tablePrefix?: string;
-    /**
-     * Maximum vector dimensions allowed
-     * @default 1536
-     */
-    maxVectorDimensions?: number;
-    /**
-     * Size of the LRU cache for frequently accessed vectors
-     * @default 100
-     */
-    cacheSize?: number;
-    /**
-     * Batch size for bulk operations
-     * @default 100
-     */
-    batchSize?: number;
-    /**
-     * Enable debug logging
-     * @default false
-     */
-    debug?: boolean;
     /**
      * Logger instance
      */
     logger?: Logger;
-    /**
-     * Maximum number of retries for database operations
-     * @default 3
-     */
-    maxRetries?: number;
-    /**
-     * Initial retry delay in milliseconds
-     * @default 100
-     */
-    retryDelayMs?: number;
 }
 /**
- * LibSQL Vector Adapter
+ * LibSQL Vector Adapter - Node.js
  * Production-ready vector storage with similarity search
+ * Supports both local SQLite files and remote Turso databases
  */
-declare class LibSQLVectorAdapter implements VectorAdapter {
-    private client;
-    private tablePrefix;
-    private maxVectorDimensions;
-    private cacheSize;
-    private batchSize;
-    private debug;
-    private logger;
-    private maxRetries;
-    private retryDelayMs;
-    private url;
-    private initialized;
-    private vectorCache;
-    private dimensions;
+declare class LibSQLVectorAdapter extends LibSQLVectorCore {
     constructor(options?: LibSQLVectorOptions);
     /**
-     * Initialize the database schema
-     */
-    private initialize;
-    /**
-     * Serialize a vector to binary format
-     */
-    private serializeVector;
-    /**
-     * Deserialize a vector from binary format
-     */
-    private deserializeVector;
-    /**
-     * Execute a database operation with retries
-     */
-    private executeWithRetry;
-    /**
-     * Store a vector with associated metadata
-     */
-    store(id: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
-    /**
-     * Store multiple vectors in batch
-     */
-    storeBatch(items: VectorItem[]): Promise<void>;
-    /**
-     * Search for similar vectors using cosine similarity
-     */
-    search(queryVector: number[], options?: VectorSearchOptions): Promise<SearchResult[]>;
-    /**
-     * Check if metadata matches the filter criteria
-     */
-    private matchesFilter;
-    /**
-     * Delete a vector by ID
-     */
-    delete(id: string): Promise<void>;
-    /**
-     * Delete multiple vectors by IDs
-     */
-    deleteBatch(ids: string[]): Promise<void>;
-    /**
-     * Clear all vectors
-     */
-    clear(): Promise<void>;
-    /**
-     * Get total count of stored vectors
-     */
-    count(): Promise<number>;
-    /**
-     * Get a specific vector by ID
-     */
-    get(id: string): Promise<VectorItem | null>;
-    /**
-     * Close the database connection
+     * Override to use Buffer for more efficient serialization in Node.js
      */
-    close(): Promise<void>;
+    protected serializeVector(vector: number[]): Uint8Array;
     /**
-     * Get statistics about the vector table and cache
+     * Override to use Buffer for more efficient deserialization in Node.js
      */
-    getStats(): Promise<{
-        count: number;
-        dimensions: number | null;
-        cacheSize: number;
-        tableSizeBytes: number;
-    }>;
+    protected deserializeVector(data: Uint8Array | ArrayBuffer): number[];
 }
 
 export { LibSQLMemoryAdapter, type LibSQLMemoryOptions, LibSQLObservabilityAdapter, type LibSQLObservabilityOptions, LibSQLVectorAdapter, type LibSQLVectorOptions };