@mastra/libsql 0.0.0-working-memory-undefined-20260212204651 → 0.0.0-workshop-yj-20260903030708

package/dist/storage/index.d.ts

@@ -1,16 +1,48 @@
-import type { Client } from '@libsql/client';
-import type { StorageDomains } from '@mastra/core/storage';
+import type { RetentionConfig, StorageDomains } from '@mastra/core/storage';
 import { MastraCompositeStore } from '@mastra/core/storage';
+import type { SqliteClient as Client } from './db/client.js';
 import { AgentsLibSQL } from './domains/agents/index.js';
+import { BackgroundTasksLibSQL } from './domains/background-tasks/index.js';
+import { BlobsLibSQL } from './domains/blobs/index.js';
+import { ChannelsLibSQL } from './domains/channels/index.js';
+import { DatasetsLibSQL } from './domains/datasets/index.js';
+import { ExperimentsLibSQL } from './domains/experiments/index.js';
+import { FavoritesLibSQL } from './domains/favorites/index.js';
+import { HarnessLibSQL } from './domains/harness/index.js';
+import { KnowledgeLibSQL } from './domains/knowledge/index.js';
 import { MCPClientsLibSQL } from './domains/mcp-clients/index.js';
+import { MCPServersLibSQL } from './domains/mcp-servers/index.js';
 import { MemoryLibSQL } from './domains/memory/index.js';
+import { NotificationsLibSQL } from './domains/notifications/index.js';
 import { ObservabilityLibSQL } from './domains/observability/index.js';
 import { PromptBlocksLibSQL } from './domains/prompt-blocks/index.js';
+import { SchedulesLibSQL } from './domains/schedules/index.js';
 import { ScorerDefinitionsLibSQL } from './domains/scorer-definitions/index.js';
 import { ScoresLibSQL } from './domains/scores/index.js';
+import { SkillsLibSQL } from './domains/skills/index.js';
+import { ThreadStateLibSQL } from './domains/thread-state/index.js';
+import { ToolProviderConnectionsLibSQL } from './domains/tool-provider-connections/index.js';
+import { WorkflowDefinitionsLibSQL } from './domains/workflow-definitions/index.js';
 import { WorkflowsLibSQL } from './domains/workflows/index.js';
-export { AgentsLibSQL, MCPClientsLibSQL, MemoryLibSQL, ObservabilityLibSQL, PromptBlocksLibSQL, ScorerDefinitionsLibSQL, ScoresLibSQL, WorkflowsLibSQL, };
+import { WorkspacesLibSQL } from './domains/workspaces/index.js';
+export { AgentsLibSQL, BackgroundTasksLibSQL, BlobsLibSQL, ChannelsLibSQL, DatasetsLibSQL, ExperimentsLibSQL, HarnessLibSQL, MCPClientsLibSQL, MCPServersLibSQL, MemoryLibSQL, KnowledgeLibSQL, NotificationsLibSQL, ObservabilityLibSQL, PromptBlocksLibSQL, SchedulesLibSQL, ScorerDefinitionsLibSQL, ScoresLibSQL, SkillsLibSQL, FavoritesLibSQL, ThreadStateLibSQL, ToolProviderConnectionsLibSQL, WorkflowDefinitionsLibSQL, WorkflowsLibSQL, WorkspacesLibSQL, };
 export type { LibSQLDomainConfig } from './db/index.js';
+export type { SqliteClient, SqliteInArgs, SqliteInValue, SqliteResultSet, SqliteStatement, SqliteTransaction, SqliteTransactionMode, SqliteValue, } from './db/client.js';
+export { LibSQLFactoryStorage, type LibSQLFactoryStorageConfig } from './factory-storage.js';
+export type LibSQLStorageDomain = keyof StorageDomains;
+export type LibSQLLocalPragmaOptions = {
+    /**
+     * SQLite PRAGMA cache_size value for local databases.
+     * Negative values are interpreted as kibibytes by SQLite.
+     * @default -16000
+     */
+    cacheSize?: number;
+    /**
+     * SQLite PRAGMA mmap_size value in bytes for local databases.
+     * @default 134217728
+     */
+    mmapSize?: number;
+};
 /**
  * Base configuration options shared across LibSQL configurations
  */
@@ -27,6 +59,24 @@ export type LibSQLBaseConfig = {
      * @default 100
      */
     initialBackoffMs?: number;
+    /**
+     * SQLite `busy_timeout` (in milliseconds) applied to the underlying connection
+     * for local (`file:`/`:memory:`) databases. When a write hits a locked
+     * database, the driver waits up to this long for the lock to clear instead of
+     * failing immediately with `SQLITE_BUSY`. Requires `@libsql/client` >= 0.17.4,
+     * which also ensures the timeout survives connections created after
+     * `transaction()` (see libsql-client-ts#288/#345).
+     *
+     * Has no effect for remote (`libsql://`/`https://`) clients or when an existing
+     * `client` is supplied.
+     * @default 5000
+     */
+    connectionTimeoutMs?: number;
+    /**
+     * Overrides local SQLite PRAGMA values used for startup/read performance.
+     * Only applies to local file and in-memory databases.
+     */
+    localPragmas?: LibSQLLocalPragmaOptions;
     /**
      * When true, automatic initialization (table creation/migrations) is disabled.
      * This is useful for CI/CD pipelines where you want to:
@@ -47,10 +97,27 @@ export type LibSQLBaseConfig = {
      * // No auto-init, tables must already exist
      */
     disableInit?: boolean;
+    /**
+     * Opt-in, table-granular, age-based retention policies. Declare per-table
+     * `maxAge` per domain (e.g. `{ memory: { messages: { maxAge: '30d' } } }`);
+     * unset tables are kept forever. Wire `storage.prune()` to your own cron to
+     * apply them. See {@link RetentionConfig}.
+     */
+    retention?: RetentionConfig;
 };
 export type LibSQLConfig = (LibSQLBaseConfig & {
     url: string;
     authToken?: string;
+    /**
+     * URL of the remote primary database to sync from, enabling an embedded
+     * replica (e.g. 'libsql://your-db.turso.io'). Requires a local `file:` url.
+     */
+    syncUrl?: string;
+    /**
+     * Interval in seconds for automatic sync with the remote primary.
+     * Only applies when `syncUrl` is set.
+     */
+    syncInterval?: number;
 }) | (LibSQLBaseConfig & {
     client: Client;
 });
@@ -76,8 +143,23 @@ export declare class LibSQLStore extends MastraCompositeStore {
     private client;
     private readonly maxRetries;
     private readonly initialBackoffMs;
+    private readonly connectionTimeoutMs;
+    private readonly pragmasReady;
+    private readonly isLocalDb;
+    private readonly localPragmas;
     stores: StorageDomains;
     constructor(config: LibSQLConfig);
+    private applyLocalPragmas;
+    private getStoresToInit;
+    private initDomainsSequentially;
+    private initDomainsInParallel;
+    init(): Promise<void>;
+    /**
+     * Closes the underlying libsql client, releasing this store's OS file handles.
+     *
+     * Safe to call more than once; subsequent calls are no-ops.
+     */
+    close(): Promise<void>;
 }
 export { LibSQLStore as DefaultStorage };
 //# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,YAAY,EACZ,eAAe,GAChB,CAAC;AACF,YAAY,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB,CAAC,gBAAgB,GAAG;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,GACF,CAAC,gBAAgB,GAAG;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEP;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,WAAY,SAAQ,oBAAoB;IACnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C,MAAM,EAAE,cAAc,CAAC;gBAEX,MAAM,EAAE,YAAY;CA6DjC;AAED,OAAO,EAAE,WAAW,IAAI,cAAc,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"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"}

package/dist/storage/retention.d.ts

@@ -0,0 +1,77 @@
+import type { TABLE_NAMES, PruneOptions, PruneResult, TableRetentionPolicy } from '@mastra/core/storage';
+import type { LibSQLDB } from './db/index.js';
+/** One table to prune, resolved from a policy + the domain's descriptor. */
+export interface PruneTarget {
+    /** Physical table name. */
+    table: TABLE_NAMES;
+    /** Timestamp anchor column for the age comparison. */
+    column: string;
+    /**
+     * How the anchor column stores time, which decides how the cutoff is bound:
+     * - `timestamp` (default): ISO-8601 string comparison.
+     * - `epoch-ms`: raw millisecond number comparison (e.g. `schedules.triggers`).
+     */
+    anchorType: 'timestamp' | 'epoch-ms';
+    /** Whether the anchor column should get a supporting index before pruning. */
+    indexed: boolean;
+    /** Retention policy (maxAge + optional batchSize). */
+    policy: TableRetentionPolicy;
+}
+/**
+ * Runs the bounded, batched, cancellable delete loop for a set of tables in the
+ * given order (callers pass children before parents for cascade-safe pruning),
+ * and returns one {@link PruneResult} per table.
+ *
+ * The loop:
+ * - deletes in chunks of `batchSize` (default 1000), each its own statement;
+ * - stops a table's loop when a batch deletes fewer rows than requested (drained),
+ *   or when `maxBatches`/`maxRows` is hit, or the `signal` aborts — the latter
+ *   three leave `done: false` so the caller can resume;
+ * - pauses `pauseMs` between batches when set, to avoid starving live traffic.
+ *
+ * `prune()` only deletes rows; it never reclaims disk. Freed pages are reused
+ * by future writes so the file stops growing. Handing disk back to the OS is
+ * left to the underlying database and the operator to manage.
+ */
+/** Convert a policy's `maxAge` into a cutoff bound matching the anchor's storage type. */
+export declare function cutoffFor(policy: TableRetentionPolicy, anchorType: 'timestamp' | 'epoch-ms', now?: number): string | number;
+/**
+ * Run the bounded/cancellable batched-delete loop for a single logical target,
+ * delegating the actual delete of up to `limit` rows to `deleteBatch`. Returns
+ * `{ deleted, done }`; `done: false` means the loop stopped on a bound or the
+ * abort signal and eligible rows may remain.
+ */
+export declare function runBatchedDelete({ deleteBatch, batchSize, options, }: {
+    deleteBatch: (limit: number) => Promise<number>;
+    batchSize: number;
+    options?: PruneOptions;
+}): Promise<{
+    deleted: number;
+    done: boolean;
+}>;
+export declare function runPrune({ db, domain, targets, options, logger, }: {
+    db: LibSQLDB;
+    domain: string;
+    targets: PruneTarget[];
+    options?: PruneOptions;
+    logger?: {
+        warn?: (msg: string, err?: unknown) => void;
+    };
+}): Promise<PruneResult[]>;
+/**
+ * Resolve a domain's `{ tableKey: policy }` map plus its descriptor into an
+ * ordered list of {@link PruneTarget}s. `order` lists table keys children-first
+ * so cascade-dependent rows are removed before their parents. Table keys not in
+ * `policies` are skipped (unset = keep forever).
+ */
+export declare function resolveTargets({ policies, descriptor, order, }: {
+    policies: Record<string, TableRetentionPolicy>;
+    descriptor: Record<string, {
+        table: string;
+        column: string;
+        anchorType?: 'timestamp' | 'epoch-ms';
+        indexed?: boolean;
+    }>;
+    order: string[];
+}): PruneTarget[];
+//# sourceMappingURL=retention.d.ts.map

package/dist/storage/retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/storage/retention.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACzG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAIrC,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,EAAE,WAAW,GAAG,UAAU,CAAC;IACrC,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAwCD;;;;;;;;;;;;;;;GAeG;AACH,0FAA0F;AAC1F,wBAAgB,SAAS,CAAC,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAE,WAAW,GAAG,UAAU,EAAE,GAAG,SAAa,mBAG7G;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,EACrC,WAAW,EACX,SAAS,EACT,OAAO,GACR,EAAE;IACD,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAkC9C;AAED,wBAAsB,QAAQ,CAAC,EAC7B,EAAE,EACF,MAAM,EACN,OAAO,EACP,OAAO,EACP,MAAM,GACP,EAAE;IACD,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAC;CAC1D,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAyBzB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,UAAU,EACV,KAAK,GACN,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,CAChB,MAAM,EACN;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAC5F,CAAC;IACF,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,GAAG,WAAW,EAAE,CAehB"}

package/dist/vector/filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/vector/filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEpH,KAAK,sBAAsB,GAAG,IAAI,CAChC,gBAAgB,EAChB,QAAQ,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAChE,GAAG;IACF,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtD,IAAI,EAAE,gBAAgB,CAAC;IACvB,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,gBAAgB,CAAC;IACvB,GAAG,EAAE,gBAAgB,CAAC;IACtB,GAAG,EAAE,gBAAgB,CAAC;CACvB,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,MAAM,sBAAsB,EAAE,sBAAsB,CAAC,CAAC;AAEpG;;;;;;;;;GASG;AACH,qBAAa,sBAAuB,SAAQ,oBAAoB,CAAC,kBAAkB,CAAC;cAC/D,qBAAqB,IAAI,eAAe;IAQ3D,SAAS,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,kBAAkB;IAQ1D,OAAO,CAAC,aAAa;CAsFtB"}
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/vector/filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEpH,KAAK,sBAAsB,GAAG,IAAI,CAChC,gBAAgB,EAChB,QAAQ,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAChE,GAAG;IACF,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtD,IAAI,EAAE,gBAAgB,CAAC;IACvB,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,gBAAgB,CAAC;IACvB,GAAG,EAAE,gBAAgB,CAAC;IACtB,GAAG,EAAE,gBAAgB,CAAC;CACvB,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,MAAM,sBAAsB,EAAE,sBAAsB,CAAC,CAAC;AAEpG;;;;;;;;;GASG;AACH,qBAAa,sBAAuB,SAAQ,oBAAoB,CAAC,kBAAkB,CAAC;IAClF,UAAmB,qBAAqB,IAAI,eAAe,CAM1D;IAED,SAAS,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,CAMzD;IAED,OAAO,CAAC,aAAa;CAsFtB"}

package/dist/vector/index.d.ts

@@ -24,16 +24,41 @@ export interface LibSQLVectorConfig {
      * @default 100
      */
     initialBackoffMs?: number;
+    /**
+     * Over-fetch multiplier for vector_top_k queries when metadata filters are present.
+     * Since vector_top_k doesn't support inline WHERE clauses, we fetch topK * this multiplier
+     * candidates and post-filter. Higher values improve recall at the cost of more data scanned.
+     * @default 10
+     */
+    vectorTopKOverFetchMultiplier?: number;
 }
 export declare class LibSQLVector extends MastraVector<LibSQLVectorFilter> {
     private turso;
     private readonly maxRetries;
     private readonly initialBackoffMs;
-    constructor({ url, authToken, syncUrl, syncInterval, maxRetries, initialBackoffMs, id, }: LibSQLVectorConfig & {
+    private readonly overFetchMultiplier;
+    private readonly isMemoryDb;
+    private readonly initialization;
+    private databaseKey;
+    private vectorIndexes;
+    constructor({ url, authToken, syncUrl, syncInterval, maxRetries, initialBackoffMs, vectorTopKOverFetchMultiplier, id, }: LibSQLVectorConfig & {
         id: string;
     });
+    private initialize;
+    private applyLocalPragmas;
+    private ensureInitialized;
+    private executeMutation;
+    /**
+     * Closes the underlying libsql client, releasing this vector store's OS file handles.
+     *
+     * Safe to call more than once; subsequent calls are no-ops.
+     */
+    close(): Promise<void>;
+    private discoverVectorIndexes;
     private executeWriteOperationWithRetry;
     transformFilter(filter?: LibSQLVectorFilter): LibSQLVectorFilter;
+    private hasVectorIndex;
+    private queryWithIndex;
     query({ indexName, queryVector, topK, filter, includeVector, minScore, }: LibSQLQueryVectorParams): Promise<QueryResult[]>;
     upsert(args: UpsertVectorParams): Promise<string[]>;
     private doUpsert;

package/dist/vector/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vector/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAqC,MAAM,qBAAqB,CAAC;AACtF,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAInD,UAAU,uBAAwB,SAAQ,iBAAiB,CAAC,kBAAkB,CAAC;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,YAAa,SAAQ,YAAY,CAAC,kBAAkB,CAAC;IAChE,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,EACV,GAAG,EACH,SAAS,EACT,OAAO,EACP,YAAY,EACZ,UAAc,EACd,gBAAsB,EACtB,EAAE,GACH,EAAE,kBAAkB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE;YAwBxB,8BAA8B;IAmC5C,eAAe,CAAC,MAAM,CAAC,EAAE,kBAAkB;IAKrC,KAAK,CAAC,EACV,SAAS,EACT,WAAW,EACX,IAAS,EACT,MAAM,EACN,aAAqB,EACrB,QAAa,GACd,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA8D5C,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAe5C,QAAQ;IA8Cf,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;YAgB5C,aAAa;IAyBpB,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;YAgB5C,aAAa;IAQrB,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBtC;;;;;OAKG;IACG,aAAa,CAAC,EAAE,SAAS,EAAE,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAqD5E;;;;;;;;;;OAUG;IACI,YAAY,CAAC,IAAI,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;YAIlE,cAAc;IA8I5B;;;;;;OAMG;IACI,YAAY,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;YAmB9C,cAAc;IAQrB,aAAa,CAAC,IAAI,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;YAIpE,eAAe;IAiHtB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;YAgB9C,gBAAgB;CAM/B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vector/index.ts"],"names":[],"mappings":"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"}

package/dist/vector/sql-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sql-builder.d.ts","sourceRoot":"","sources":["../../src/vector/sql-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAS9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AA+WnD,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AA6BD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAkBzE"}
+{"version":3,"file":"sql-builder.d.ts","sourceRoot":"","sources":["../../src/vector/sql-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAS9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAmXnD,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AA6BD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAkBzE"}

package/dist/vector/write-lock.d.ts

@@ -0,0 +1,7 @@
+export declare function getLocalFileDatabaseKey({ url, syncUrl, cwd, }: {
+    url: string;
+    syncUrl?: string;
+    cwd: string;
+}): Promise<string | undefined>;
+export declare function withLocalFileDatabaseWriteLock<T>(key: string | undefined, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=write-lock.d.ts.map

package/dist/vector/write-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-lock.d.ts","sourceRoot":"","sources":["../../src/vector/write-lock.ts"],"names":[],"mappings":"AAKA,wBAAsB,uBAAuB,CAAC,EAC5C,GAAG,EACH,OAAO,EACP,GAAG,GACJ,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkB9B;AAED,wBAAgB,8BAA8B,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAoB3G"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/libsql",
-  "version": "0.0.0-working-memory-undefined-20260212204651",
+  "version": "0.0.0-workshop-yj-20260903030708",
   "description": "Libsql provider for Mastra - includes both vector and db storage capabilities",
   "type": "module",
   "main": "dist/index.js",
@@ -20,27 +20,27 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@libsql/client": "^0.15.15"
+    "@libsql/client": "^0.17.4"
   },
   "devDependencies": {
-    "@types/node": "22.19.7",
-    "@vitest/coverage-v8": "4.0.12",
-    "@vitest/ui": "4.0.12",
-    "eslint": "^9.37.0",
-    "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "vitest": "4.0.16",
-    "@internal/lint": "0.0.0-working-memory-undefined-20260212204651",
-    "@internal/storage-test-utils": "0.0.54",
-    "@internal/types-builder": "0.0.0-working-memory-undefined-20260212204651",
-    "@mastra/core": "0.0.0-working-memory-undefined-20260212204651"
+    "@types/node": "22.20.1",
+    "@vitest/coverage-v8": "4.1.10",
+    "@vitest/ui": "4.1.10",
+    "eslint": "^10.7.0",
+    "tsdown": "0.22.9",
+    "tsx": "^4.23.1",
+    "typescript": "^7.0.2",
+    "vitest": "4.1.10",
+    "@internal/types-builder": "0.0.0-workshop-yj-20260903030708",
+    "@internal/lint": "0.0.0-workshop-yj-20260903030708",
+    "@internal/storage-test-utils": "0.0.125",
+    "@mastra/core": "0.0.0-workshop-yj-20260903030708"
   },
   "peerDependencies": {
-    "@mastra/core": "0.0.0-working-memory-undefined-20260212204651"
+    "@mastra/core": "0.0.0-workshop-yj-20260903030708"
   },
   "files": [
-    "dist",
-    "CHANGELOG.md"
+    "dist"
   ],
   "homepage": "https://mastra.ai",
   "repository": {
@@ -55,9 +55,10 @@
     "node": ">=22.13.0"
   },
   "scripts": {
-    "build:lib": "tsup --silent --config tsup.config.ts",
-    "build:watch": "tsup --watch --silent --config tsup.config.ts",
+    "build:lib": "tsdown --silent --config tsdown.config.ts",
+    "build:watch": "tsdown --watch --silent --config tsdown.config.ts",
     "test": "vitest run",
-    "lint": "eslint ."
+    "lint": "oxlint . && eslint .",
+    "lint:fix": "oxlint --fix . && eslint --fix ."
   }
 }