@mastra/libsql 0.0.0-error-handler-fix-20251020202607 → 0.0.0-esbuild-bundle-worker-20260807182016

package/dist/storage/index.d.ts

@@ -1,14 +1,51 @@
 import type { Client } from '@libsql/client';
-import type { MastraMessageContentV2, MastraMessageV2 } from '@mastra/core/agent';
-import type { MastraMessageV1, StorageThreadType } from '@mastra/core/memory';
-import type { ScoreRowData, ScoringSource } from '@mastra/core/scores';
-import { MastraStorage } from '@mastra/core/storage';
-import type { EvalRow, PaginationArgs, PaginationInfo, StorageColumn, StoragePagination, StorageGetMessagesArg, StorageResourceType, TABLE_NAMES, WorkflowRun, WorkflowRuns, StorageGetTracesArg, StorageDomains, ThreadSortOptions, AISpanRecord, AITraceRecord, AITracesPaginatedArg } from '@mastra/core/storage';
-import type { Trace } from '@mastra/core/telemetry';
-import type { StepResult, WorkflowRunState } from '@mastra/core/workflows';
-export type LibSQLConfig = {
-    url: string;
-    authToken?: string;
+import type { RetentionConfig, StorageDomains } from '@mastra/core/storage';
+import { MastraCompositeStore } from '@mastra/core/storage';
+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 { 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';
+import { WorkspacesLibSQL } from './domains/workspaces/index.js';
+export { AgentsLibSQL, BackgroundTasksLibSQL, BlobsLibSQL, ChannelsLibSQL, DatasetsLibSQL, ExperimentsLibSQL, HarnessLibSQL, MCPClientsLibSQL, MCPServersLibSQL, MemoryLibSQL, NotificationsLibSQL, ObservabilityLibSQL, PromptBlocksLibSQL, SchedulesLibSQL, ScorerDefinitionsLibSQL, ScoresLibSQL, SkillsLibSQL, FavoritesLibSQL, ThreadStateLibSQL, ToolProviderConnectionsLibSQL, WorkflowDefinitionsLibSQL, WorkflowsLibSQL, WorkspacesLibSQL, };
+export type { LibSQLDomainConfig } from './db/index.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
+ */
+export type LibSQLBaseConfig = {
+    id: string;
     /**
      * Maximum number of retries for write operations if an SQLITE_BUSY error occurs.
      * @default 5
@@ -20,261 +57,97 @@ export type LibSQLConfig = {
      * @default 100
      */
     initialBackoffMs?: number;
-} | {
-    client: Client;
-    maxRetries?: number;
-    initialBackoffMs?: number;
-};
-export declare class LibSQLStore extends MastraStorage {
-    private client;
-    private readonly maxRetries;
-    private readonly initialBackoffMs;
-    stores: StorageDomains;
-    constructor(config: LibSQLConfig);
-    get supports(): {
-        selectByIncludeResourceScope: boolean;
-        resourceWorkingMemory: boolean;
-        hasColumn: boolean;
-        createTable: boolean;
-        deleteMessages: boolean;
-        aiTracing: boolean;
-        getScoresBySpan: boolean;
-    };
-    createTable({ tableName, schema, }: {
-        tableName: TABLE_NAMES;
-        schema: Record<string, StorageColumn>;
-    }): Promise<void>;
-    /**
-     * Alters table schema to add columns if they don't exist
-     * @param tableName Name of the table
-     * @param schema Schema of the table
-     * @param ifNotExists Array of column names to add if they don't exist
-     */
-    alterTable({ tableName, schema, ifNotExists, }: {
-        tableName: TABLE_NAMES;
-        schema: Record<string, StorageColumn>;
-        ifNotExists: string[];
-    }): Promise<void>;
-    clearTable({ tableName }: {
-        tableName: TABLE_NAMES;
-    }): Promise<void>;
-    dropTable({ tableName }: {
-        tableName: TABLE_NAMES;
-    }): Promise<void>;
-    insert(args: {
-        tableName: TABLE_NAMES;
-        record: Record<string, any>;
-    }): Promise<void>;
-    batchInsert(args: {
-        tableName: TABLE_NAMES;
-        records: Record<string, any>[];
-    }): Promise<void>;
-    load<R>({ tableName, keys }: {
-        tableName: TABLE_NAMES;
-        keys: Record<string, string>;
-    }): Promise<R | null>;
-    getThreadById({ threadId }: {
-        threadId: string;
-    }): Promise<StorageThreadType | null>;
     /**
-     * @deprecated use getThreadsByResourceIdPaginated instead for paginated results.
+     * 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
      */
-    getThreadsByResourceId(args: {
-        resourceId: string;
-    } & ThreadSortOptions): Promise<StorageThreadType[]>;
-    getThreadsByResourceIdPaginated(args: {
-        resourceId: string;
-        page: number;
-        perPage: number;
-    } & ThreadSortOptions): Promise<PaginationInfo & {
-        threads: StorageThreadType[];
-    }>;
-    saveThread({ thread }: {
-        thread: StorageThreadType;
-    }): Promise<StorageThreadType>;
-    updateThread({ id, title, metadata, }: {
-        id: string;
-        title: string;
-        metadata: Record<string, unknown>;
-    }): Promise<StorageThreadType>;
-    deleteThread({ threadId }: {
-        threadId: string;
-    }): Promise<void>;
+    connectionTimeoutMs?: number;
     /**
-     * @deprecated use getMessagesPaginated instead for paginated results.
+     * Overrides local SQLite PRAGMA values used for startup/read performance.
+     * Only applies to local file and in-memory databases.
      */
-    getMessages(args: StorageGetMessagesArg & {
-        format?: 'v1';
-    }): Promise<MastraMessageV1[]>;
-    getMessages(args: StorageGetMessagesArg & {
-        format: 'v2';
-    }): Promise<MastraMessageV2[]>;
-    getMessagesById({ messageIds, format }: {
-        messageIds: string[];
-        format: 'v1';
-    }): Promise<MastraMessageV1[]>;
-    getMessagesById({ messageIds, format }: {
-        messageIds: string[];
-        format?: 'v2';
-    }): Promise<MastraMessageV2[]>;
-    getMessagesPaginated(args: StorageGetMessagesArg & {
-        format?: 'v1' | 'v2';
-    }): Promise<PaginationInfo & {
-        messages: MastraMessageV1[] | MastraMessageV2[];
-    }>;
-    saveMessages(args: {
-        messages: MastraMessageV1[];
-        format?: undefined | 'v1';
-    }): Promise<MastraMessageV1[]>;
-    saveMessages(args: {
-        messages: MastraMessageV2[];
-        format: 'v2';
-    }): Promise<MastraMessageV2[]>;
-    updateMessages({ messages, }: {
-        messages: (Partial<Omit<MastraMessageV2, 'createdAt'>> & {
-            id: string;
-            content?: {
-                metadata?: MastraMessageContentV2['metadata'];
-                content?: MastraMessageContentV2['content'];
-            };
-        })[];
-    }): Promise<MastraMessageV2[]>;
-    deleteMessages(messageIds: string[]): Promise<void>;
-    /** @deprecated use getEvals instead */
-    getEvalsByAgentName(agentName: string, type?: 'test' | 'live'): Promise<EvalRow[]>;
-    getEvals(options?: {
-        agentName?: string;
-        type?: 'test' | 'live';
-    } & PaginationArgs): Promise<PaginationInfo & {
-        evals: EvalRow[];
-    }>;
-    getScoreById({ id }: {
-        id: string;
-    }): Promise<ScoreRowData | null>;
-    saveScore(score: Omit<ScoreRowData, 'id' | 'createdAt' | 'updatedAt'>): Promise<{
-        score: ScoreRowData;
-    }>;
-    getScoresByScorerId({ scorerId, entityId, entityType, source, pagination, }: {
-        scorerId: string;
-        entityId?: string;
-        entityType?: string;
-        source?: ScoringSource;
-        pagination: StoragePagination;
-    }): Promise<{
-        pagination: PaginationInfo;
-        scores: ScoreRowData[];
-    }>;
-    getScoresByRunId({ runId, pagination, }: {
-        runId: string;
-        pagination: StoragePagination;
-    }): Promise<{
-        pagination: PaginationInfo;
-        scores: ScoreRowData[];
-    }>;
-    getScoresByEntityId({ entityId, entityType, pagination, }: {
-        pagination: StoragePagination;
-        entityId: string;
-        entityType: string;
-    }): Promise<{
-        pagination: PaginationInfo;
-        scores: ScoreRowData[];
-    }>;
+    localPragmas?: LibSQLLocalPragmaOptions;
     /**
-     * TRACES
+     * When true, automatic initialization (table creation/migrations) is disabled.
+     * This is useful for CI/CD pipelines where you want to:
+     * 1. Run migrations explicitly during deployment (not at runtime)
+     * 2. Use different credentials for schema changes vs runtime operations
+     *
+     * When disableInit is true:
+     * - The storage will not automatically create/alter tables on first use
+     * - You must call `storage.init()` explicitly in your CI/CD scripts
+     *
+     * @example
+     * // In CI/CD script:
+     * const storage = new LibSQLStore({ ...config, disableInit: false });
+     * await storage.init(); // Explicitly run migrations
+     *
+     * // In runtime application:
+     * const storage = new LibSQLStore({ ...config, disableInit: true });
+     * // No auto-init, tables must already exist
      */
+    disableInit?: boolean;
     /**
-     * @deprecated use getTracesPaginated instead.
+     * 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}.
      */
-    getTraces(args: StorageGetTracesArg): Promise<Trace[]>;
-    getTracesPaginated(args: StorageGetTracesArg): Promise<PaginationInfo & {
-        traces: Trace[];
-    }>;
-    batchTraceInsert(args: {
-        records: Record<string, any>[];
-    }): Promise<void>;
+    retention?: RetentionConfig;
+};
+export type LibSQLConfig = (LibSQLBaseConfig & {
+    url: string;
+    authToken?: string;
+}) | (LibSQLBaseConfig & {
+    client: Client;
+});
+/**
+ * LibSQL/Turso storage adapter for Mastra.
+ *
+ * Access domain-specific storage via `getStore()`:
+ *
+ * @example
+ * ```typescript
+ * const storage = new LibSQLStore({ id: 'my-store', url: 'file:./dev.db' });
+ *
+ * // Access memory domain
+ * const memory = await storage.getStore('memory');
+ * await memory?.saveThread({ thread });
+ *
+ * // Access workflows domain
+ * const workflows = await storage.getStore('workflows');
+ * await workflows?.persistWorkflowSnapshot({ workflowName, runId, snapshot });
+ * ```
+ */
+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>;
     /**
-     * WORKFLOWS
+     * Closes the underlying libsql client, releasing this store's OS file handles.
+     *
+     * Safe to call more than once; subsequent calls are no-ops.
      */
-    updateWorkflowResults({ workflowName, runId, stepId, result, runtimeContext, }: {
-        workflowName: string;
-        runId: string;
-        stepId: string;
-        result: StepResult<any, any, any, any>;
-        runtimeContext: Record<string, any>;
-    }): Promise<Record<string, StepResult<any, any, any, any>>>;
-    updateWorkflowState({ workflowName, runId, opts, }: {
-        workflowName: string;
-        runId: string;
-        opts: {
-            status: string;
-            result?: StepResult<any, any, any, any>;
-            error?: string;
-            suspendedPaths?: Record<string, number[]>;
-            waitingPaths?: Record<string, number[]>;
-        };
-    }): Promise<WorkflowRunState | undefined>;
-    persistWorkflowSnapshot({ workflowName, runId, resourceId, snapshot, }: {
-        workflowName: string;
-        runId: string;
-        resourceId?: string;
-        snapshot: WorkflowRunState;
-    }): Promise<void>;
-    loadWorkflowSnapshot({ workflowName, runId, }: {
-        workflowName: string;
-        runId: string;
-    }): Promise<WorkflowRunState | null>;
-    getWorkflowRuns({ workflowName, fromDate, toDate, limit, offset, resourceId, }?: {
-        workflowName?: string;
-        fromDate?: Date;
-        toDate?: Date;
-        limit?: number;
-        offset?: number;
-        resourceId?: string;
-    }): Promise<WorkflowRuns>;
-    getWorkflowRunById({ runId, workflowName, }: {
-        runId: string;
-        workflowName?: string;
-    }): Promise<WorkflowRun | null>;
-    getResourceById({ resourceId }: {
-        resourceId: string;
-    }): Promise<StorageResourceType | null>;
-    saveResource({ resource }: {
-        resource: StorageResourceType;
-    }): Promise<StorageResourceType>;
-    updateResource({ resourceId, workingMemory, metadata, }: {
-        resourceId: string;
-        workingMemory?: string;
-        metadata?: Record<string, unknown>;
-    }): Promise<StorageResourceType>;
-    createAISpan(span: AISpanRecord): Promise<void>;
-    updateAISpan(params: {
-        spanId: string;
-        traceId: string;
-        updates: Partial<Omit<AISpanRecord, 'spanId' | 'traceId'>>;
-    }): Promise<void>;
-    getAITrace(traceId: string): Promise<AITraceRecord | null>;
-    getAITracesPaginated(args: AITracesPaginatedArg): Promise<{
-        pagination: PaginationInfo;
-        spans: AISpanRecord[];
-    }>;
-    getScoresBySpan({ traceId, spanId, pagination, }: {
-        traceId: string;
-        spanId: string;
-        pagination: StoragePagination;
-    }): Promise<{
-        pagination: PaginationInfo;
-        scores: ScoreRowData[];
-    }>;
-    batchCreateAISpans(args: {
-        records: AISpanRecord[];
-    }): Promise<void>;
-    batchUpdateAISpans(args: {
-        records: {
-            traceId: string;
-            spanId: string;
-            updates: Partial<Omit<AISpanRecord, 'spanId' | 'traceId'>>;
-        }[];
-    }): Promise<void>;
+    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":"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"}
+{"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/index.d.ts

@@ -1,11 +1,15 @@
 import { MastraVector } from '@mastra/core/vector';
-import type { IndexStats, QueryResult, QueryVectorParams, CreateIndexParams, UpsertVectorParams, DescribeIndexParams, DeleteIndexParams, DeleteVectorParams, UpdateVectorParams } from '@mastra/core/vector';
+import type { IndexStats, QueryResult, QueryVectorParams, CreateIndexParams, UpsertVectorParams, DescribeIndexParams, DeleteIndexParams, DeleteVectorParams, UpdateVectorParams, DeleteVectorsParams } from '@mastra/core/vector';
 import type { LibSQLVectorFilter } from './filter.js';
 interface LibSQLQueryVectorParams extends QueryVectorParams<LibSQLVectorFilter> {
     minScore?: number;
 }
 export interface LibSQLVectorConfig {
-    connectionUrl: string;
+    /**
+     * The URL of the LibSQL database.
+     * Examples: 'file:./dev.db', 'file::memory:', 'libsql://your-db.turso.io'
+     */
+    url: string;
     authToken?: string;
     syncUrl?: string;
     syncInterval?: number;
@@ -20,14 +24,35 @@ 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({ connectionUrl, authToken, syncUrl, syncInterval, maxRetries, initialBackoffMs, }: LibSQLVectorConfig);
+    private readonly overFetchMultiplier;
+    private readonly isMemoryDb;
+    private vectorIndexes;
+    constructor({ url, authToken, syncUrl, syncInterval, maxRetries, initialBackoffMs, vectorTopKOverFetchMultiplier, id, }: LibSQLVectorConfig & {
+        id: string;
+    });
+    /**
+     * 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;
@@ -54,7 +79,7 @@ export declare class LibSQLVector extends MastraVector<LibSQLVectorFilter> {
      * @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(args: UpdateVectorParams): Promise<void>;
+    updateVector(args: UpdateVectorParams<LibSQLVectorFilter>): Promise<void>;
     private doUpdateVector;
     /**
      * Deletes a vector by its ID.
@@ -65,6 +90,8 @@ export declare class LibSQLVector extends MastraVector<LibSQLVectorFilter> {
      */
     deleteVector(args: DeleteVectorParams): Promise<void>;
     private doDeleteVector;
+    deleteVectors(args: DeleteVectorsParams<LibSQLVectorFilter>): Promise<void>;
+    private doDeleteVectors;
     truncateIndex(args: DeleteIndexParams): Promise<void>;
     private _doTruncateIndex;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vector/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EACnB,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,aAAa,EAAE,MAAM,CAAC;IACtB,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,aAAa,EACb,SAAS,EACT,OAAO,EACP,YAAY,EACZ,UAAc,EACd,gBAAsB,GACvB,EAAE,kBAAkB;YAwBP,8BAA8B;IAgC5C,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;IAoE5C,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAe5C,QAAQ;IA2Cf,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,GAAG,OAAO,CAAC,IAAI,CAAC;YAI9C,cAAc;IAiD5B;;;;;;OAMG;IACI,YAAY,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;YAgB9C,cAAc;IAQrB,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":"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;IAC1B;;;;;OAKG;IACH,6BAA6B,CAAC,EAAE,MAAM,CAAC;CACxC;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;IAC1C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,aAAa,CAAuB;gBAEhC,EACV,GAAG,EACH,SAAS,EACT,OAAO,EACP,YAAY,EACZ,UAAc,EACd,gBAAsB,EACtB,6BAAkC,EAClC,EAAE,GACH,EAAE,kBAAkB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE;IA+BtC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAMd,qBAAqB;YAYrB,8BAA8B;IAmC5C,eAAe,CAAC,MAAM,CAAC,EAAE,kBAAkB;YAK7B,cAAc;YAKd,cAAc;IA0CtB,KAAK,CAAC,EACV,SAAS,EACT,WAAW,EACX,IAAS,EACT,MAAM,EACN,aAAqB,EACrB,QAAa,GACd,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA0F5C,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;IA0BpB,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;YAgB5C,aAAa;IASrB,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"}

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;AA8VnD,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;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"}