@voltagent/libsql 1.0.13 → 1.1.0

package/dist/vector-core-CKn8FNVK.d.mts

@@ -0,0 +1,274 @@
+import { Client } from '@libsql/client';
+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';
+
+/**
+ * LibSQL Memory Adapter Core
+ * Contains shared logic for both Node.js and Edge environments
+ * Environment-specific adapters extend this class
+ */
+
+/**
+ * Core configuration options for LibSQL Memory adapter
+ */
+interface LibSQLMemoryCoreOptions {
+    /**
+     * Prefix for table names
+     * @default "voltagent_memory"
+     */
+    tablePrefix?: string;
+    /**
+     * Maximum number of retries for database operations
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Initial retry delay in milliseconds
+     * @default 100
+     */
+    retryDelayMs?: number;
+}
+/**
+ * LibSQL Memory Adapter Core
+ * Implements all storage operations, receives client via dependency injection
+ */
+declare class LibSQLMemoryCore implements StorageAdapter {
+    protected client: Client;
+    protected tablePrefix: string;
+    protected initialized: boolean;
+    protected logger: Logger;
+    protected maxRetries: number;
+    protected retryDelayMs: number;
+    protected url: string;
+    constructor(client: Client, url: string, options: LibSQLMemoryCoreOptions, logger: Logger);
+    /**
+     * Execute a database operation with retry logic
+     */
+    protected executeWithRetry<T>(operation: () => Promise<T>, operationName: string): Promise<T>;
+    /**
+     * Initialize database schema
+     */
+    protected initialize(): Promise<void>;
+    private addV2ColumnsToMessagesTable;
+    private migrateDefaultUserIds;
+    private addWorkflowStateColumns;
+    addMessage(message: UIMessage, userId: string, conversationId: string): Promise<void>;
+    addMessages(messages: UIMessage[], userId: string, conversationId: string): Promise<void>;
+    saveConversationSteps(steps: ConversationStepRecord[]): Promise<void>;
+    getMessages(userId: string, conversationId: string, options?: GetMessagesOptions): Promise<UIMessage<{
+        createdAt: Date;
+    }>[]>;
+    getConversationSteps(userId: string, conversationId: string, options?: GetConversationStepsOptions): Promise<ConversationStepRecord[]>;
+    clearMessages(userId: string, conversationId?: string): Promise<void>;
+    createConversation(input: CreateConversationInput): Promise<Conversation>;
+    getConversation(id: string): Promise<Conversation | null>;
+    getConversations(resourceId: string): Promise<Conversation[]>;
+    getConversationsByUserId(userId: string, options?: Omit<ConversationQueryOptions, "userId">): Promise<Conversation[]>;
+    queryConversations(options: ConversationQueryOptions): Promise<Conversation[]>;
+    updateConversation(id: string, updates: Partial<Omit<Conversation, "id" | "createdAt" | "updatedAt">>): Promise<Conversation>;
+    deleteConversation(id: string): Promise<void>;
+    getWorkingMemory(params: {
+        conversationId?: string;
+        userId?: string;
+        scope: WorkingMemoryScope;
+    }): Promise<string | null>;
+    setWorkingMemory(params: {
+        conversationId?: string;
+        userId?: string;
+        content: string;
+        scope: WorkingMemoryScope;
+    }): Promise<void>;
+    deleteWorkingMemory(params: {
+        conversationId?: string;
+        userId?: string;
+        scope: WorkingMemoryScope;
+    }): Promise<void>;
+    getWorkflowState(executionId: string): Promise<WorkflowStateEntry | null>;
+    queryWorkflowRuns(query: {
+        workflowId?: string;
+        status?: WorkflowStateEntry["status"];
+        from?: Date;
+        to?: Date;
+        limit?: number;
+        offset?: number;
+    }): Promise<WorkflowStateEntry[]>;
+    setWorkflowState(executionId: string, state: WorkflowStateEntry): Promise<void>;
+    updateWorkflowState(executionId: string, updates: Partial<WorkflowStateEntry>): Promise<void>;
+    getSuspendedWorkflowStates(workflowId: string): Promise<WorkflowStateEntry[]>;
+    close(): Promise<void>;
+}
+
+/**
+ * LibSQL Observability Adapter Core
+ * Contains shared logic for both Node.js and Edge environments
+ * Environment-specific adapters extend this class
+ */
+
+/**
+ * Core configuration options for LibSQL Observability adapter
+ */
+interface LibSQLObservabilityCoreOptions {
+    /**
+     * Prefix for table names
+     * @default "observability"
+     */
+    tablePrefix?: string;
+    /**
+     * Whether to enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Maximum number of spans to return in a single query
+     * @default 1000
+     */
+    maxSpansPerQuery?: number;
+}
+/**
+ * LibSQL Observability Adapter Core
+ * Implements all observability storage operations, receives client via dependency injection
+ */
+declare class LibSQLObservabilityCore implements ObservabilityStorageAdapter {
+    protected client: Client;
+    protected tablePrefix: string;
+    protected debug: boolean;
+    protected logger: Logger;
+    protected initialized: Promise<void>;
+    protected maxSpansPerQuery: number;
+    constructor(client: Client, options: LibSQLObservabilityCoreOptions, logger: Logger);
+    protected debugLog(message: string, data?: unknown): void;
+    private initializeDatabase;
+    protected ensureInitialized(): Promise<void>;
+    addSpan(span: ObservabilitySpan): Promise<void>;
+    updateSpan(spanId: string, updates: Partial<ObservabilitySpan>): Promise<void>;
+    getSpan(spanId: string): Promise<ObservabilitySpan | null>;
+    getTrace(traceId: string): Promise<ObservabilitySpan[]>;
+    listTraces(limit?: number, offset?: number, filter?: {
+        entityId?: string;
+        entityType?: "agent" | "workflow";
+    }): Promise<string[]>;
+    deleteOldSpans(beforeTimestamp: number): Promise<number>;
+    clear(): Promise<void>;
+    private rowToSpan;
+    getStats(): Promise<{
+        spanCount: number;
+        traceCount: number;
+        oldestSpan?: Date;
+        newestSpan?: Date;
+    }>;
+    saveLogRecord(logRecord: any): Promise<void>;
+    getLogsByTraceId(traceId: string): Promise<ObservabilityLogRecord[]>;
+    getLogsBySpanId(spanId: string): Promise<ObservabilityLogRecord[]>;
+    queryLogs(filter: LogFilter): Promise<ObservabilityLogRecord[]>;
+    deleteOldLogs(beforeTimestamp: number): Promise<number>;
+    private rowToLogRecord;
+    getInfo(): {
+        adapter: string;
+        displayName: string;
+        persistent: boolean;
+        description: string;
+    };
+    close(): Promise<void>;
+}
+
+/**
+ * LibSQL Vector Adapter Core
+ * Contains shared logic for both Node.js and Edge environments
+ * Environment-specific adapters extend this class
+ */
+
+/**
+ * Core configuration options for LibSQL Vector adapter
+ */
+interface LibSQLVectorCoreOptions {
+    /**
+     * 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;
+    /**
+     * Maximum number of retries for database operations
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Initial retry delay in milliseconds
+     * @default 100
+     */
+    retryDelayMs?: number;
+}
+/**
+ * LibSQL Vector Adapter Core
+ * Implements all vector storage operations, receives client via dependency injection
+ */
+declare class LibSQLVectorCore implements VectorAdapter {
+    protected client: Client;
+    protected tablePrefix: string;
+    protected maxVectorDimensions: number;
+    protected cacheSize: number;
+    protected batchSize: number;
+    protected debug: boolean;
+    protected logger: Logger;
+    protected maxRetries: number;
+    protected retryDelayMs: number;
+    protected initialized: boolean;
+    protected vectorCache: Map<string, VectorItem>;
+    protected dimensions: number | null;
+    constructor(client: Client, options: LibSQLVectorCoreOptions, logger: Logger);
+    /**
+     * Serialize a vector to binary format
+     * Uses ArrayBuffer/DataView for cross-platform compatibility
+     */
+    protected serializeVector(vector: number[]): Uint8Array;
+    /**
+     * Deserialize a vector from binary format
+     */
+    protected deserializeVector(data: Uint8Array | ArrayBuffer): number[];
+    /**
+     * Initialize the database schema
+     */
+    protected initialize(): Promise<void>;
+    /**
+     * Execute a database operation with retries
+     */
+    protected executeWithRetry<T>(operation: () => Promise<T>, context: string): Promise<T>;
+    store(id: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
+    storeBatch(items: VectorItem[]): Promise<void>;
+    search(queryVector: number[], options?: VectorSearchOptions): Promise<SearchResult[]>;
+    private matchesFilter;
+    delete(id: string): Promise<void>;
+    deleteBatch(ids: string[]): Promise<void>;
+    clear(): Promise<void>;
+    count(): Promise<number>;
+    get(id: string): Promise<VectorItem | null>;
+    close(): Promise<void>;
+    getStats(): Promise<{
+        count: number;
+        dimensions: number | null;
+        cacheSize: number;
+        tableSizeBytes: number;
+    }>;
+}
+
+export { LibSQLMemoryCore as L, type LibSQLMemoryCoreOptions as a, LibSQLObservabilityCore as b, type LibSQLObservabilityCoreOptions as c, LibSQLVectorCore as d, type LibSQLVectorCoreOptions as e };

package/dist/vector-core-CKn8FNVK.d.ts

@@ -0,0 +1,274 @@
+import { Client } from '@libsql/client';
+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';
+
+/**
+ * LibSQL Memory Adapter Core
+ * Contains shared logic for both Node.js and Edge environments
+ * Environment-specific adapters extend this class
+ */
+
+/**
+ * Core configuration options for LibSQL Memory adapter
+ */
+interface LibSQLMemoryCoreOptions {
+    /**
+     * Prefix for table names
+     * @default "voltagent_memory"
+     */
+    tablePrefix?: string;
+    /**
+     * Maximum number of retries for database operations
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Initial retry delay in milliseconds
+     * @default 100
+     */
+    retryDelayMs?: number;
+}
+/**
+ * LibSQL Memory Adapter Core
+ * Implements all storage operations, receives client via dependency injection
+ */
+declare class LibSQLMemoryCore implements StorageAdapter {
+    protected client: Client;
+    protected tablePrefix: string;
+    protected initialized: boolean;
+    protected logger: Logger;
+    protected maxRetries: number;
+    protected retryDelayMs: number;
+    protected url: string;
+    constructor(client: Client, url: string, options: LibSQLMemoryCoreOptions, logger: Logger);
+    /**
+     * Execute a database operation with retry logic
+     */
+    protected executeWithRetry<T>(operation: () => Promise<T>, operationName: string): Promise<T>;
+    /**
+     * Initialize database schema
+     */
+    protected initialize(): Promise<void>;
+    private addV2ColumnsToMessagesTable;
+    private migrateDefaultUserIds;
+    private addWorkflowStateColumns;
+    addMessage(message: UIMessage, userId: string, conversationId: string): Promise<void>;
+    addMessages(messages: UIMessage[], userId: string, conversationId: string): Promise<void>;
+    saveConversationSteps(steps: ConversationStepRecord[]): Promise<void>;
+    getMessages(userId: string, conversationId: string, options?: GetMessagesOptions): Promise<UIMessage<{
+        createdAt: Date;
+    }>[]>;
+    getConversationSteps(userId: string, conversationId: string, options?: GetConversationStepsOptions): Promise<ConversationStepRecord[]>;
+    clearMessages(userId: string, conversationId?: string): Promise<void>;
+    createConversation(input: CreateConversationInput): Promise<Conversation>;
+    getConversation(id: string): Promise<Conversation | null>;
+    getConversations(resourceId: string): Promise<Conversation[]>;
+    getConversationsByUserId(userId: string, options?: Omit<ConversationQueryOptions, "userId">): Promise<Conversation[]>;
+    queryConversations(options: ConversationQueryOptions): Promise<Conversation[]>;
+    updateConversation(id: string, updates: Partial<Omit<Conversation, "id" | "createdAt" | "updatedAt">>): Promise<Conversation>;
+    deleteConversation(id: string): Promise<void>;
+    getWorkingMemory(params: {
+        conversationId?: string;
+        userId?: string;
+        scope: WorkingMemoryScope;
+    }): Promise<string | null>;
+    setWorkingMemory(params: {
+        conversationId?: string;
+        userId?: string;
+        content: string;
+        scope: WorkingMemoryScope;
+    }): Promise<void>;
+    deleteWorkingMemory(params: {
+        conversationId?: string;
+        userId?: string;
+        scope: WorkingMemoryScope;
+    }): Promise<void>;
+    getWorkflowState(executionId: string): Promise<WorkflowStateEntry | null>;
+    queryWorkflowRuns(query: {
+        workflowId?: string;
+        status?: WorkflowStateEntry["status"];
+        from?: Date;
+        to?: Date;
+        limit?: number;
+        offset?: number;
+    }): Promise<WorkflowStateEntry[]>;
+    setWorkflowState(executionId: string, state: WorkflowStateEntry): Promise<void>;
+    updateWorkflowState(executionId: string, updates: Partial<WorkflowStateEntry>): Promise<void>;
+    getSuspendedWorkflowStates(workflowId: string): Promise<WorkflowStateEntry[]>;
+    close(): Promise<void>;
+}
+
+/**
+ * LibSQL Observability Adapter Core
+ * Contains shared logic for both Node.js and Edge environments
+ * Environment-specific adapters extend this class
+ */
+
+/**
+ * Core configuration options for LibSQL Observability adapter
+ */
+interface LibSQLObservabilityCoreOptions {
+    /**
+     * Prefix for table names
+     * @default "observability"
+     */
+    tablePrefix?: string;
+    /**
+     * Whether to enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Maximum number of spans to return in a single query
+     * @default 1000
+     */
+    maxSpansPerQuery?: number;
+}
+/**
+ * LibSQL Observability Adapter Core
+ * Implements all observability storage operations, receives client via dependency injection
+ */
+declare class LibSQLObservabilityCore implements ObservabilityStorageAdapter {
+    protected client: Client;
+    protected tablePrefix: string;
+    protected debug: boolean;
+    protected logger: Logger;
+    protected initialized: Promise<void>;
+    protected maxSpansPerQuery: number;
+    constructor(client: Client, options: LibSQLObservabilityCoreOptions, logger: Logger);
+    protected debugLog(message: string, data?: unknown): void;
+    private initializeDatabase;
+    protected ensureInitialized(): Promise<void>;
+    addSpan(span: ObservabilitySpan): Promise<void>;
+    updateSpan(spanId: string, updates: Partial<ObservabilitySpan>): Promise<void>;
+    getSpan(spanId: string): Promise<ObservabilitySpan | null>;
+    getTrace(traceId: string): Promise<ObservabilitySpan[]>;
+    listTraces(limit?: number, offset?: number, filter?: {
+        entityId?: string;
+        entityType?: "agent" | "workflow";
+    }): Promise<string[]>;
+    deleteOldSpans(beforeTimestamp: number): Promise<number>;
+    clear(): Promise<void>;
+    private rowToSpan;
+    getStats(): Promise<{
+        spanCount: number;
+        traceCount: number;
+        oldestSpan?: Date;
+        newestSpan?: Date;
+    }>;
+    saveLogRecord(logRecord: any): Promise<void>;
+    getLogsByTraceId(traceId: string): Promise<ObservabilityLogRecord[]>;
+    getLogsBySpanId(spanId: string): Promise<ObservabilityLogRecord[]>;
+    queryLogs(filter: LogFilter): Promise<ObservabilityLogRecord[]>;
+    deleteOldLogs(beforeTimestamp: number): Promise<number>;
+    private rowToLogRecord;
+    getInfo(): {
+        adapter: string;
+        displayName: string;
+        persistent: boolean;
+        description: string;
+    };
+    close(): Promise<void>;
+}
+
+/**
+ * LibSQL Vector Adapter Core
+ * Contains shared logic for both Node.js and Edge environments
+ * Environment-specific adapters extend this class
+ */
+
+/**
+ * Core configuration options for LibSQL Vector adapter
+ */
+interface LibSQLVectorCoreOptions {
+    /**
+     * 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;
+    /**
+     * Maximum number of retries for database operations
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Initial retry delay in milliseconds
+     * @default 100
+     */
+    retryDelayMs?: number;
+}
+/**
+ * LibSQL Vector Adapter Core
+ * Implements all vector storage operations, receives client via dependency injection
+ */
+declare class LibSQLVectorCore implements VectorAdapter {
+    protected client: Client;
+    protected tablePrefix: string;
+    protected maxVectorDimensions: number;
+    protected cacheSize: number;
+    protected batchSize: number;
+    protected debug: boolean;
+    protected logger: Logger;
+    protected maxRetries: number;
+    protected retryDelayMs: number;
+    protected initialized: boolean;
+    protected vectorCache: Map<string, VectorItem>;
+    protected dimensions: number | null;
+    constructor(client: Client, options: LibSQLVectorCoreOptions, logger: Logger);
+    /**
+     * Serialize a vector to binary format
+     * Uses ArrayBuffer/DataView for cross-platform compatibility
+     */
+    protected serializeVector(vector: number[]): Uint8Array;
+    /**
+     * Deserialize a vector from binary format
+     */
+    protected deserializeVector(data: Uint8Array | ArrayBuffer): number[];
+    /**
+     * Initialize the database schema
+     */
+    protected initialize(): Promise<void>;
+    /**
+     * Execute a database operation with retries
+     */
+    protected executeWithRetry<T>(operation: () => Promise<T>, context: string): Promise<T>;
+    store(id: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
+    storeBatch(items: VectorItem[]): Promise<void>;
+    search(queryVector: number[], options?: VectorSearchOptions): Promise<SearchResult[]>;
+    private matchesFilter;
+    delete(id: string): Promise<void>;
+    deleteBatch(ids: string[]): Promise<void>;
+    clear(): Promise<void>;
+    count(): Promise<number>;
+    get(id: string): Promise<VectorItem | null>;
+    close(): Promise<void>;
+    getStats(): Promise<{
+        count: number;
+        dimensions: number | null;
+        cacheSize: number;
+        tableSizeBytes: number;
+    }>;
+}
+
+export { LibSQLMemoryCore as L, type LibSQLMemoryCoreOptions as a, LibSQLObservabilityCore as b, type LibSQLObservabilityCoreOptions as c, LibSQLVectorCore as d, type LibSQLVectorCoreOptions as e };

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@voltagent/libsql",
   "description": "VoltAgent LibSQL - LibSQL/Turso Memory provider integration for VoltAgent",
-  "version": "1.0.13",
+  "version": "1.1.0",
   "dependencies": {
     "@libsql/client": "^0.15.0",
     "@voltagent/internal": "^0.0.12"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^3.2.4",
-    "@voltagent/core": "^1.2.11",
+    "@voltagent/core": "^1.5.2",
     "@voltagent/logger": "^1.0.3",
     "ai": "^5.0.76"
   },
@@ -22,6 +22,16 @@
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
       }
+    },
+    "./edge": {
+      "import": {
+        "types": "./dist/edge.d.mts",
+        "default": "./dist/edge.mjs"
+      },
+      "require": {
+        "types": "./dist/edge.d.ts",
+        "default": "./dist/edge.js"
+      }
     }
   },
   "files": [