@mastra/libsql 0.10.0 → 0.10.1-alpha.1

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/libsql@0.10.0-alpha.1 build /home/runner/work/mastra/mastra/stores/libsql
+> @mastra/libsql@0.10.1-alpha.1 build /home/runner/work/mastra/mastra/stores/libsql
 > tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.4.0
 TSC Build start
-TSC ⚡️ Build success in 8671ms
+TSC ⚡️ Build success in 9697ms
 DTS Build start
 CLI Target: es2022
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/stores/libsql/dist/_tsup-dts-rollup.d.ts
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/stores/libsql/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 8251ms
+DTS ⚡️ Build success in 9670ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 45.42 KB
-CJS ⚡️ Build success in 1060ms
-ESM dist/index.js 45.22 KB
-ESM ⚡️ Build success in 1062ms
+CJS dist/index.cjs 48.56 KB
+CJS ⚡️ Build success in 1141ms
+ESM dist/index.js 48.36 KB
+ESM ⚡️ Build success in 1142ms

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @mastra/libsql
 
+## 0.10.1-alpha.1
+
+### Patch Changes
+
+- f0d559f: Fix peerdeps for alpha channel
+- Updated dependencies [1e8bb40]
+  - @mastra/core@0.10.2-alpha.2
+
+## 0.10.1-alpha.0
+
+### Patch Changes
+
+- e5dc18d: Added a backwards compatible layer to begin storing/retrieving UIMessages in storage instead of CoreMessages
+- 9e37877: Fixes SQLITE_BUSY error often seen when working locally on the playground
+- Updated dependencies [592a2db]
+- Updated dependencies [e5dc18d]
+  - @mastra/core@0.10.2-alpha.0
+
 ## 0.10.0
 
 ### Minor Changes

package/dist/_tsup-dts-rollup.d.cts

@@ -6,9 +6,9 @@ import type { DescribeIndexParams } from '@mastra/core/vector';
 import type { EvalRow } from '@mastra/core/storage';
 import type { IndexStats } from '@mastra/core/vector';
 import type { InValue } from '@libsql/client';
+import type { MastraMessageV2 } from '@mastra/core/agent';
 import { MastraStorage } from '@mastra/core/storage';
 import { MastraVector } from '@mastra/core/vector';
-import type { MessageType } from '@mastra/core/memory';
 import type { OperatorSupport } from '@mastra/core/vector/filter';
 import type { QueryResult } from '@mastra/core/vector';
 import type { QueryVectorParams } from '@mastra/core/vector';
@@ -40,6 +40,17 @@ export { LIBSQL_PROMPT as LIBSQL_PROMPT_alias_1 }
 declare interface LibSQLConfig {
     url: string;
     authToken?: string;
+    /**
+     * Maximum number of retries for write operations if an SQLITE_BUSY error occurs.
+     * @default 5
+     */
+    maxRetries?: number;
+    /**
+     * Initial backoff time in milliseconds for retrying write operations on SQLITE_BUSY.
+     * The backoff time will double with each retry (exponential backoff).
+     * @default 100
+     */
+    initialBackoffMs?: number;
 }
 export { LibSQLConfig }
 export { LibSQLConfig as LibSQLConfig_alias_1 }
@@ -60,12 +71,14 @@ export declare class LibSQLFilterTranslator extends BaseFilterTranslator {
     private translateNode;
 }
 
-declare interface LibSQLQueryParams extends QueryVectorParams {
+declare interface LibSQLQueryVectorParams extends QueryVectorParams {
     minScore?: number;
 }
 
 declare class LibSQLStore extends MastraStorage {
     private client;
+    private readonly maxRetries;
+    private readonly initialBackoffMs;
     constructor(config: LibSQLConfig);
     private getCreateTableSQL;
     createTable({ tableName, schema, }: {
@@ -76,14 +89,17 @@ declare class LibSQLStore extends MastraStorage {
         tableName: TABLE_NAMES;
     }): Promise<void>;
     private prepareStatement;
-    insert({ tableName, record }: {
+    private executeWriteOperationWithRetry;
+    insert(args: {
         tableName: TABLE_NAMES;
         record: Record<string, any>;
     }): Promise<void>;
-    batchInsert({ tableName, records }: {
+    private doInsert;
+    batchInsert(args: {
         tableName: TABLE_NAMES;
         records: Record<string, any>[];
     }): Promise<void>;
+    private doBatchInsert;
     load<R>({ tableName, keys }: {
         tableName: TABLE_NAMES;
         keys: Record<string, string>;
@@ -106,10 +122,10 @@ declare class LibSQLStore extends MastraStorage {
         threadId: string;
     }): Promise<void>;
     private parseRow;
-    getMessages<T extends MessageType[]>({ threadId, selectBy }: StorageGetMessagesArg): Promise<T>;
+    getMessages<T extends MastraMessageV2[]>({ threadId, selectBy }: StorageGetMessagesArg): Promise<T>;
     saveMessages({ messages }: {
-        messages: MessageType[];
-    }): Promise<MessageType[]>;
+        messages: MastraMessageV2[];
+    }): Promise<MastraMessageV2[]>;
     private transformEvalRow;
     getEvalsByAgentName(agentName: string, type?: 'test' | 'live'): Promise<EvalRow[]>;
     getTraces({ name, scope, page, perPage, attributes, filters, fromDate, toDate, }?: {
@@ -144,17 +160,18 @@ export { LibSQLStore as LibSQLStore_alias_1 }
 
 declare class LibSQLVector extends MastraVector {
     private turso;
-    constructor({ connectionUrl, authToken, syncUrl, syncInterval, }: {
-        connectionUrl: string;
-        authToken?: string;
-        syncUrl?: string;
-        syncInterval?: number;
-    });
+    private readonly maxRetries;
+    private readonly initialBackoffMs;
+    constructor({ connectionUrl, authToken, syncUrl, syncInterval, maxRetries, initialBackoffMs, }: LibSQLVectorConfig);
+    private executeWriteOperationWithRetry;
     transformFilter(filter?: VectorFilter): VectorFilter;
-    query({ indexName, queryVector, topK, filter, includeVector, minScore, }: LibSQLQueryParams): Promise<QueryResult[]>;
-    upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
-    createIndex({ indexName, dimension }: CreateIndexParams): Promise<void>;
-    deleteIndex({ indexName }: DeleteIndexParams): Promise<void>;
+    query({ indexName, queryVector, topK, filter, includeVector, minScore, }: LibSQLQueryVectorParams): Promise<QueryResult[]>;
+    upsert(args: UpsertVectorParams): Promise<string[]>;
+    private doUpsert;
+    createIndex(args: CreateIndexParams): Promise<void>;
+    private doCreateIndex;
+    deleteIndex(args: DeleteIndexParams): Promise<void>;
+    private doDeleteIndex;
     listIndexes(): Promise<string[]>;
     /**
      * Retrieves statistics about a vector index.
@@ -174,7 +191,8 @@ declare class LibSQLVector extends MastraVector {
      * @returns A promise that resolves when the update is complete.
      * @throws Will throw an error if no updates are provided or if the update operation fails.
      */
-    updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void>;
+    updateVector(args: UpdateVectorParams): Promise<void>;
+    private doUpdateVector;
     /**
      * Deletes a vector by its ID.
      * @param indexName - The name of the index containing the vector.
@@ -182,10 +200,32 @@ declare class LibSQLVector extends MastraVector {
      * @returns A promise that resolves when the deletion is complete.
      * @throws Will throw an error if the deletion operation fails.
      */
-    deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
-    truncateIndex({ indexName }: DeleteIndexParams): Promise<void>;
+    deleteVector(args: DeleteVectorParams): Promise<void>;
+    private doDeleteVector;
+    truncateIndex(args: DeleteIndexParams): Promise<void>;
+    private _doTruncateIndex;
 }
 export { LibSQLVector }
 export { LibSQLVector as LibSQLVector_alias_1 }
 
+declare interface LibSQLVectorConfig {
+    connectionUrl: string;
+    authToken?: string;
+    syncUrl?: string;
+    syncInterval?: number;
+    /**
+     * Maximum number of retries for write operations if an SQLITE_BUSY error occurs.
+     * @default 5
+     */
+    maxRetries?: number;
+    /**
+     * Initial backoff time in milliseconds for retrying write operations on SQLITE_BUSY.
+     * The backoff time will double with each retry (exponential backoff).
+     * @default 100
+     */
+    initialBackoffMs?: number;
+}
+export { LibSQLVectorConfig }
+export { LibSQLVectorConfig as LibSQLVectorConfig_alias_1 }
+
 export { }

package/dist/_tsup-dts-rollup.d.ts

@@ -6,9 +6,9 @@ import type { DescribeIndexParams } from '@mastra/core/vector';
 import type { EvalRow } from '@mastra/core/storage';
 import type { IndexStats } from '@mastra/core/vector';
 import type { InValue } from '@libsql/client';
+import type { MastraMessageV2 } from '@mastra/core/agent';
 import { MastraStorage } from '@mastra/core/storage';
 import { MastraVector } from '@mastra/core/vector';
-import type { MessageType } from '@mastra/core/memory';
 import type { OperatorSupport } from '@mastra/core/vector/filter';
 import type { QueryResult } from '@mastra/core/vector';
 import type { QueryVectorParams } from '@mastra/core/vector';
@@ -40,6 +40,17 @@ export { LIBSQL_PROMPT as LIBSQL_PROMPT_alias_1 }
 declare interface LibSQLConfig {
     url: string;
     authToken?: string;
+    /**
+     * Maximum number of retries for write operations if an SQLITE_BUSY error occurs.
+     * @default 5
+     */
+    maxRetries?: number;
+    /**
+     * Initial backoff time in milliseconds for retrying write operations on SQLITE_BUSY.
+     * The backoff time will double with each retry (exponential backoff).
+     * @default 100
+     */
+    initialBackoffMs?: number;
 }
 export { LibSQLConfig }
 export { LibSQLConfig as LibSQLConfig_alias_1 }
@@ -60,12 +71,14 @@ export declare class LibSQLFilterTranslator extends BaseFilterTranslator {
     private translateNode;
 }
 
-declare interface LibSQLQueryParams extends QueryVectorParams {
+declare interface LibSQLQueryVectorParams extends QueryVectorParams {
     minScore?: number;
 }
 
 declare class LibSQLStore extends MastraStorage {
     private client;
+    private readonly maxRetries;
+    private readonly initialBackoffMs;
     constructor(config: LibSQLConfig);
     private getCreateTableSQL;
     createTable({ tableName, schema, }: {
@@ -76,14 +89,17 @@ declare class LibSQLStore extends MastraStorage {
         tableName: TABLE_NAMES;
     }): Promise<void>;
     private prepareStatement;
-    insert({ tableName, record }: {
+    private executeWriteOperationWithRetry;
+    insert(args: {
         tableName: TABLE_NAMES;
         record: Record<string, any>;
     }): Promise<void>;
-    batchInsert({ tableName, records }: {
+    private doInsert;
+    batchInsert(args: {
         tableName: TABLE_NAMES;
         records: Record<string, any>[];
     }): Promise<void>;
+    private doBatchInsert;
     load<R>({ tableName, keys }: {
         tableName: TABLE_NAMES;
         keys: Record<string, string>;
@@ -106,10 +122,10 @@ declare class LibSQLStore extends MastraStorage {
         threadId: string;
     }): Promise<void>;
     private parseRow;
-    getMessages<T extends MessageType[]>({ threadId, selectBy }: StorageGetMessagesArg): Promise<T>;
+    getMessages<T extends MastraMessageV2[]>({ threadId, selectBy }: StorageGetMessagesArg): Promise<T>;
     saveMessages({ messages }: {
-        messages: MessageType[];
-    }): Promise<MessageType[]>;
+        messages: MastraMessageV2[];
+    }): Promise<MastraMessageV2[]>;
     private transformEvalRow;
     getEvalsByAgentName(agentName: string, type?: 'test' | 'live'): Promise<EvalRow[]>;
     getTraces({ name, scope, page, perPage, attributes, filters, fromDate, toDate, }?: {
@@ -144,17 +160,18 @@ export { LibSQLStore as LibSQLStore_alias_1 }
 
 declare class LibSQLVector extends MastraVector {
     private turso;
-    constructor({ connectionUrl, authToken, syncUrl, syncInterval, }: {
-        connectionUrl: string;
-        authToken?: string;
-        syncUrl?: string;
-        syncInterval?: number;
-    });
+    private readonly maxRetries;
+    private readonly initialBackoffMs;
+    constructor({ connectionUrl, authToken, syncUrl, syncInterval, maxRetries, initialBackoffMs, }: LibSQLVectorConfig);
+    private executeWriteOperationWithRetry;
     transformFilter(filter?: VectorFilter): VectorFilter;
-    query({ indexName, queryVector, topK, filter, includeVector, minScore, }: LibSQLQueryParams): Promise<QueryResult[]>;
-    upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
-    createIndex({ indexName, dimension }: CreateIndexParams): Promise<void>;
-    deleteIndex({ indexName }: DeleteIndexParams): Promise<void>;
+    query({ indexName, queryVector, topK, filter, includeVector, minScore, }: LibSQLQueryVectorParams): Promise<QueryResult[]>;
+    upsert(args: UpsertVectorParams): Promise<string[]>;
+    private doUpsert;
+    createIndex(args: CreateIndexParams): Promise<void>;
+    private doCreateIndex;
+    deleteIndex(args: DeleteIndexParams): Promise<void>;
+    private doDeleteIndex;
     listIndexes(): Promise<string[]>;
     /**
      * Retrieves statistics about a vector index.
@@ -174,7 +191,8 @@ declare class LibSQLVector extends MastraVector {
      * @returns A promise that resolves when the update is complete.
      * @throws Will throw an error if no updates are provided or if the update operation fails.
      */
-    updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void>;
+    updateVector(args: UpdateVectorParams): Promise<void>;
+    private doUpdateVector;
     /**
      * Deletes a vector by its ID.
      * @param indexName - The name of the index containing the vector.
@@ -182,10 +200,32 @@ declare class LibSQLVector extends MastraVector {
      * @returns A promise that resolves when the deletion is complete.
      * @throws Will throw an error if the deletion operation fails.
      */
-    deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
-    truncateIndex({ indexName }: DeleteIndexParams): Promise<void>;
+    deleteVector(args: DeleteVectorParams): Promise<void>;
+    private doDeleteVector;
+    truncateIndex(args: DeleteIndexParams): Promise<void>;
+    private _doTruncateIndex;
 }
 export { LibSQLVector }
 export { LibSQLVector as LibSQLVector_alias_1 }
 
+declare interface LibSQLVectorConfig {
+    connectionUrl: string;
+    authToken?: string;
+    syncUrl?: string;
+    syncInterval?: number;
+    /**
+     * Maximum number of retries for write operations if an SQLITE_BUSY error occurs.
+     * @default 5
+     */
+    maxRetries?: number;
+    /**
+     * Initial backoff time in milliseconds for retrying write operations on SQLITE_BUSY.
+     * The backoff time will double with each retry (exponential backoff).
+     * @default 100
+     */
+    initialBackoffMs?: number;
+}
+export { LibSQLVectorConfig }
+export { LibSQLVectorConfig as LibSQLVectorConfig_alias_1 }
+
 export { }