swarm-mail 1.2.1 → 1.3.0

package/dist/libsql.convenience.d.ts

@@ -0,0 +1,155 @@
+/**
+ * LibSQL Convenience Layer - Simple API for libSQL users
+ *
+ * Parallel to pglite.ts - provides simplified interface for users who want
+ * libSQL without manually setting up adapters.
+ *
+ * ## Simple API (this file)
+ * ```typescript
+ * import { getSwarmMailLibSQL } from '@opencode/swarm-mail';
+ *
+ * const swarmMail = await getSwarmMailLibSQL('/path/to/project');
+ * await swarmMail.registerAgent(projectKey, 'agent-name');
+ * ```
+ *
+ * ## Advanced API (adapter pattern)
+ * ```typescript
+ * import { createLibSQLAdapter, createSwarmMailAdapter } from '@opencode/swarm-mail';
+ *
+ * const db = await createLibSQLAdapter({ url: 'libsql://...' });
+ * const swarmMail = createSwarmMailAdapter(db, '/path/to/project');
+ * ```
+ */
+import type { SwarmDb } from "./db/client.js";
+import type { SwarmMailAdapter } from "./types/adapter.js";
+import type { DatabaseAdapter } from "./types/database.js";
+/**
+ * Get project-specific temporary directory name
+ *
+ * Creates a stable directory name based on project path:
+ * `opencode-<project-name>-<hash>`
+ *
+ * @param projectPath - Absolute path to project
+ * @returns Directory name (not full path)
+ *
+ * @example
+ * ```typescript
+ * getProjectTempDirName("/path/to/my-project");
+ * // => "opencode-my-project-a1b2c3d4"
+ * ```
+ */
+export declare function getProjectTempDirName(projectPath: string): string;
+/**
+ * Hash project path to 8-character hex string
+ *
+ * Uses SHA-256 truncated to 8 chars for project path disambiguation.
+ *
+ * @param projectPath - Path to hash
+ * @returns 8-character hex hash
+ */
+export declare function hashProjectPath(projectPath: string): string;
+/**
+ * Get database file path for a project
+ *
+ * Returns `file:/<tmpdir>/opencode-<project>-<hash>/streams.db`
+ * or `file:/<tmpdir>/opencode-global/streams.db` if no project specified.
+ *
+ * Creates directory if it doesn't exist.
+ *
+ * @param projectPath - Optional project path (defaults to global)
+ * @returns Database file URL for libSQL
+ */
+export declare function getDatabasePath(projectPath?: string): string;
+/**
+ * Get SwarmMailAdapter for a project (singleton)
+ *
+ * Creates or returns existing adapter for the project.
+ * Uses file-based libSQL database in system temp directory.
+ *
+ * **Singleton behavior:** Multiple calls with same path return same instance.
+ *
+ * @param projectPath - Absolute path to project (or undefined for global)
+ * @returns SwarmMailAdapter instance
+ *
+ * @example
+ * ```typescript
+ * const swarmMail = await getSwarmMailLibSQL('/path/to/project');
+ * await swarmMail.registerAgent(projectKey, 'agent-1');
+ * ```
+ */
+export declare function getSwarmMailLibSQL(projectPath?: string): Promise<SwarmMailAdapter>;
+/**
+ * Create in-memory SwarmMailAdapter for testing
+ *
+ * Uses `:memory:` database - no persistence.
+ * Each call creates a new isolated instance.
+ *
+ * @param testId - Unique test identifier
+ * @returns SwarmMailAdapter instance
+ *
+ * @example
+ * ```typescript
+ * const swarmMail = await createInMemorySwarmMailLibSQL('test-123');
+ * // ... use for tests ...
+ * await swarmMail.close();
+ * ```
+ */
+export declare function createInMemorySwarmMailLibSQL(testId: string): Promise<SwarmMailAdapter>;
+/**
+ * Close SwarmMailAdapter for specific project
+ *
+ * Closes database connection and removes from singleton cache.
+ *
+ * @param projectPath - Project path (or undefined for global)
+ */
+export declare function closeSwarmMailLibSQL(projectPath?: string): Promise<void>;
+/**
+ * Close all SwarmMailAdapter instances
+ *
+ * Useful for cleanup in tests or application shutdown.
+ */
+export declare function closeAllSwarmMailLibSQL(): Promise<void>;
+/**
+ * Convert a DatabaseAdapter to a SwarmDb (Drizzle database)
+ *
+ * This is useful when you have a DatabaseAdapter from getSwarmMailLibSQL()
+ * but need a SwarmDb for the memory store.
+ *
+ * @param adapter - DatabaseAdapter (must be a LibSQLAdapter internally)
+ * @returns SwarmDb (Drizzle database)
+ * @throws Error if adapter doesn't have getClient() method
+ *
+ * @example
+ * ```typescript
+ * const swarmMail = await getSwarmMailLibSQL('/path/to/project');
+ * const dbAdapter = await swarmMail.getDatabase();
+ * const drizzleDb = toSwarmDb(dbAdapter);
+ *
+ * // Now use drizzleDb with memory store
+ * const store = createMemoryStore(drizzleDb);
+ * ```
+ */
+export declare function toSwarmDb(adapter: DatabaseAdapter): SwarmDb;
+/**
+ * Convert DatabaseAdapter OR PGlite to SwarmDb (Drizzle client)
+ *
+ * Supports both:
+ * - LibSQLAdapter (has getClient() method)
+ * - PGlite (direct instance)
+ *
+ * @param db - DatabaseAdapter or PGlite instance
+ * @returns Drizzle client compatible with SwarmDb
+ *
+ * @example
+ * ```typescript
+ * // Works with LibSQLAdapter
+ * const adapter = await createLibSQLAdapter();
+ * const drizzle = toDrizzleDb(adapter);
+ *
+ * // Works with PGlite
+ * const pglite = await getDatabase(projectPath);
+ * const drizzle = toDrizzleDb(pglite);
+ * ```
+ */
+export declare function toDrizzleDb(db: any): SwarmDb;
+//# sourceMappingURL=libsql.convenience.d.ts.map

package/dist/libsql.convenience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libsql.convenience.d.ts","sourceRoot":"","sources":["../src/libsql.convenience.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAUH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAI9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAU3D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAajE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAa5D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAyB3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC,CAS3B;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAW7D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAO3D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAgB5C"}

package/dist/libsql.d.ts

@@ -0,0 +1,93 @@
+/**
+ * LibSQLAdapter - libSQL implementation of DatabaseAdapter
+ *
+ * Wraps @libsql/client to implement the DatabaseAdapter interface.
+ * Supports file-based, in-memory, and remote (Turso) databases.
+ *
+ * Key differences from PGLite:
+ * - Uses ? placeholders instead of $1, $2, etc.
+ * - Native vector support with F32_BLOB(N) columns
+ * - No extensions needed for vector operations
+ * - vector_distance_cos() returns distance (lower = more similar)
+ *
+ * Based on spike at packages/swarm-mail/scripts/sqlite-vec-spike.ts
+ *
+ * @example
+ * ```typescript
+ * // In-memory (for tests)
+ * const db = await createLibSQLAdapter({ url: ":memory:" });
+ *
+ * // File-based
+ * const db = await createLibSQLAdapter({ url: "file:./swarm.db" });
+ *
+ * // Remote (Turso)
+ * const db = await createLibSQLAdapter({
+ *   url: "libsql://[database].turso.io",
+ *   authToken: process.env.TURSO_TOKEN
+ * });
+ * ```
+ */
+import type { DatabaseAdapter } from "./types/database.js";
+/**
+ * LibSQL configuration options
+ *
+ * Extends @libsql/client Config with type safety.
+ */
+export interface LibSQLConfig {
+    /** Database URL - ":memory:", "file:./path.db", or "libsql://..." */
+    url: string;
+    /** Auth token for remote Turso databases */
+    authToken?: string;
+    /** Connection timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Convert PostgreSQL-style placeholders ($1, $2, ...) to SQLite-style (?)
+ * and expand parameters for reused placeholders.
+ *
+ * PostgreSQL allows reusing placeholders (e.g., $1, $2, $1) but SQLite's ?
+ * placeholders are strictly positional. This function:
+ * 1. Converts $N to ? in order of appearance
+ * 2. Expands the params array to match (duplicating values for reused placeholders)
+ *
+ * If SQL already uses ? placeholders (native SQLite style), params are passed through unchanged.
+ *
+ * @param sql - SQL string with PostgreSQL or SQLite placeholders
+ * @param params - Original parameters array
+ * @returns Object with converted SQL and expanded parameters
+ *
+ * @example
+ * ```typescript
+ * // PostgreSQL: VALUES ($1, $2, $1) with params [a, b]
+ * // SQLite:     VALUES (?, ?, ?) with params [a, b, a]
+ * const result = convertPlaceholders("VALUES ($1, $2, $1)", ["a", "b"]);
+ * // result.sql = "VALUES (?, ?, ?)"
+ * // result.params = ["a", "b", "a"]
+ *
+ * // Already SQLite style - pass through unchanged
+ * const result2 = convertPlaceholders("VALUES (?, ?, ?)", ["a", "b", "c"]);
+ * // result2.sql = "VALUES (?, ?, ?)"
+ * // result2.params = ["a", "b", "c"]
+ * ```
+ */
+export declare function convertPlaceholders(sql: string, params?: unknown[]): {
+    sql: string;
+    params: unknown[] | undefined;
+};
+/**
+ * Create a LibSQLAdapter instance
+ *
+ * Factory function that creates and initializes a libSQL database connection.
+ *
+ * @param config - LibSQL configuration (url, authToken, etc.)
+ * @returns DatabaseAdapter instance
+ *
+ * @example
+ * ```typescript
+ * const db = await createLibSQLAdapter({ url: ":memory:" });
+ * await db.exec("CREATE TABLE users (id INTEGER PRIMARY KEY)");
+ * await db.close();
+ * ```
+ */
+export declare function createLibSQLAdapter(config: LibSQLConfig): Promise<DatabaseAdapter>;
+//# sourceMappingURL=libsql.d.ts.map

package/dist/libsql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libsql.d.ts","sourceRoot":"","sources":["../src/libsql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,qBAAqB,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC5B,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GAChB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,CAAA;CAAE,CAuFhD;AAmGD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,YAAY,GAClB,OAAO,CAAC,eAAe,CAAC,CA0B1B"}

package/dist/memory/adapter.d.ts

@@ -14,11 +14,10 @@
  * ## Usage
  * ```typescript
  * import { createMemoryAdapter } from './adapter.js';
- * import { wrapPGlite } from '../pglite.js';
- * import { PGlite } from '@electric-sql/pglite';
+ * import { createInMemorySwarmMailLibSQL } from 'swarm-mail';
  *
- * const pglite = await PGlite.create({ dataDir: './db' });
- * const db = wrapPGlite(pglite);
+ * const swarmMail = await createInMemorySwarmMailLibSQL('my-project');
+ * const db = swarmMail.getDrizzle();
  * const config = {
  *   ollamaHost: 'http://localhost:11434',
  *   ollamaModel: 'mxbai-embed-large',
@@ -39,7 +38,7 @@
  * const results = await adapter.find("token refresh", { fts: true });
  * ```
  */
-import type { DatabaseAdapter } from "../types/database.js";
+import type { SwarmDb } from "../db/client.js";
 import { type Memory, type SearchResult } from "./store.js";
 import { type MemoryConfig } from "./ollama.js";
 export type { MemoryConfig } from "./ollama.js";
@@ -82,11 +81,11 @@ export interface HealthStatus {
 /**
  * Create a memory adapter with high-level operations
  *
- * @param db - DatabaseAdapter for PGlite/PostgreSQL
+ * @param db - Drizzle database instance (libSQL)
  * @param config - Ollama configuration
  * @returns Memory adapter instance
  */
-export declare function createMemoryAdapter(db: DatabaseAdapter, config: MemoryConfig): {
+export declare function createMemoryAdapter(db: SwarmDb, config: MemoryConfig): {
     /**
      * Store a memory with automatic embedding generation
      *

package/dist/memory/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/memory/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAqB,KAAK,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAMxE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY;IAqFzE;;;;;;;OAOG;uBAEY,MAAM,YACV,YAAY,GACpB,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IA2C1B;;;;;;OAMG;gBACe,MAAM,YAAW,WAAW,GAAQ,OAAO,CAAC,YAAY,EAAE,CAAC;IA0C7E;;;;;OAKG;YACW,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI7C;;;;OAIG;eACc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;;;;;;;OAQG;iBACgB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAczC;;;;;OAKG;mBACiB;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;IAIpE;;;;OAIG;aACY,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAIhE;;;;OAIG;mBACkB,OAAO,CAAC,YAAY,CAAC;EAiB7C"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/memory/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAqB,KAAK,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAMxE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY;IAqFjE;;;;;;;OAOG;uBAEY,MAAM,YACV,YAAY,GACpB,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IA2C1B;;;;;;OAMG;gBACe,MAAM,YAAW,WAAW,GAAQ,OAAO,CAAC,YAAY,EAAE,CAAC;IA0C7E;;;;;OAKG;YACW,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI7C;;;;OAIG;eACc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;;;;;;;OAQG;iBACgB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAczC;;;;;OAKG;mBACiB;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;IAIpE;;;;OAIG;aACY,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAIhE;;;;OAIG;mBACkB,OAAO,CAAC,YAAY,CAAC;EAiB7C"}

package/dist/memory/libsql-schema.d.ts

@@ -0,0 +1,83 @@
+/**
+ * libSQL Memory Schema - FTS5 and Vector Extensions
+ *
+ * Provides FTS5 full-text search and vector indexes for memories table.
+ *
+ * ## Schema Source of Truth
+ * - **Table structure**: db/schema/memory.ts (Drizzle schema)
+ * - **FTS5/vector DDL**: This file (raw SQL - Drizzle can't create these)
+ *
+ * ## Synchronization
+ * The memories table definition MUST match db/schema/memory.ts exactly.
+ * Changes to table structure should be made in db/schema/memory.ts first,
+ * then reflected here.
+ *
+ * ## Key Differences from PGlite
+ *
+ * | PGlite (pgvector)        | libSQL                               |
+ * |--------------------------|--------------------------------------|
+ * | `vector(768)`            | `F32_BLOB(768)`                      |
+ * | `$1::vector`             | `vector(?)`                          |
+ * | `embedding <=> $1`       | `vector_distance_cos(embedding, vector(?))` |
+ * | `CREATE EXTENSION vector`| Not needed (native support)          |
+ * | GIN FTS index            | FTS5 virtual table                   |
+ * | JSONB                    | TEXT (JSON stored as string)         |
+ * | TIMESTAMPTZ              | TEXT (ISO 8601 string)               |
+ *
+ * ## Vector Search Notes
+ * - libSQL returns distance (0 = identical, 2 = opposite)
+ * - To get similarity score: similarity = 1 - distance
+ * - Lower distance = higher similarity (opposite of pgvector score)
+ *
+ * @module memory/libsql-schema
+ */
+import type { Client } from "@libsql/client";
+/** Embedding dimension for mxbai-embed-large (matches PGlite schema) */
+export declare const EMBEDDING_DIM = 1024;
+/**
+ * Create libSQL memory schema with FTS5 and vector support
+ *
+ * Creates:
+ * - memories table (structure from db/schema/memory.ts)
+ * - FTS5 virtual table for full-text search (Drizzle can't create this)
+ * - Vector index (Drizzle can't create this)
+ * - Standard indexes for performance
+ *
+ * Idempotent - safe to call multiple times.
+ *
+ * @param db - libSQL client instance
+ * @throws Error if schema creation fails
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from "@libsql/client";
+ * import { createLibSQLMemorySchema } from "./libsql-schema.js";
+ *
+ * const db = createClient({ url: ":memory:" });
+ * await createLibSQLMemorySchema(db);
+ * ```
+ */
+export declare function createLibSQLMemorySchema(db: Client): Promise<void>;
+/**
+ * Drop libSQL memory schema
+ *
+ * Removes all tables, indexes, and triggers created by createLibSQLMemorySchema.
+ * Useful for tests and cleanup.
+ *
+ * @param db - libSQL client instance
+ */
+export declare function dropLibSQLMemorySchema(db: Client): Promise<void>;
+/**
+ * Verify libSQL memory schema exists and is valid
+ *
+ * Checks for:
+ * - memories table with required columns
+ * - FTS5 virtual table
+ * - Required indexes
+ * - Required triggers
+ *
+ * @param db - libSQL client instance
+ * @returns True if schema is valid, false otherwise
+ */
+export declare function validateLibSQLMemorySchema(db: Client): Promise<boolean>;
+//# sourceMappingURL=libsql-schema.d.ts.map

package/dist/memory/libsql-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libsql-schema.d.ts","sourceRoot":"","sources":["../../src/memory/libsql-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,wEAAwE;AACxE,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4ExE;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CActE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,0BAA0B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA+B7E"}

package/dist/memory/migrate-legacy.d.ts

@@ -66,6 +66,9 @@ export interface MigrationResult {
 export declare function getDefaultLegacyPath(): string;
 /**
  * Check if legacy database exists
+ *
+ * Checks for the presence of PGLite data files (PG_VERSION file)
+ * to distinguish between an empty directory and an actual database.
  */
 export declare function legacyDatabaseExists(path?: string): boolean;
 /**
@@ -85,4 +88,12 @@ export declare function getMigrationStatus(legacyPath?: string): Promise<{
     total: number;
     withEmbeddings: number;
 } | null>;
+/**
+ * Check if target database already has memories
+ * Used to skip migration prompt if already migrated
+ *
+ * @param targetDb - Target database adapter
+ * @returns true if memories exist, false if empty
+ */
+export declare function targetHasMemories(targetDb: DatabaseAdapter): Promise<boolean>;
 //# sourceMappingURL=migrate-legacy.d.ts.map

package/dist/memory/migrate-legacy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrate-legacy.d.ts","sourceRoot":"","sources":["../../src/memory/migrate-legacy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,QAAQ,EAAE,eAAe,CAAC;IAC1B,yEAAyE;IACzE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB;AAsBD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CA4I1B;AAwBD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAiC3D"}
+{"version":3,"file":"migrate-legacy.d.ts","sourceRoot":"","sources":["../../src/memory/migrate-legacy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,QAAQ,EAAE,eAAe,CAAC;IAC1B,yEAAyE;IACzE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB;AAsBD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAQ3D;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAkJ1B;AAwBD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAuC3D;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAKnF"}

package/dist/memory/migrations.d.ts

@@ -35,8 +35,19 @@ import type { Migration } from "../streams/migrations.js";
  * in src/streams/migrations.ts.
  */
 export declare const memoryMigration: Migration;
+/**
+ * Migration v9 (libSQL): Add memory tables
+ *
+ * LibSQL-compatible version using:
+ * - F32_BLOB for vector embeddings (instead of pgvector)
+ * - TEXT for metadata (instead of JSONB)
+ * - TEXT for timestamps (instead of TIMESTAMPTZ)
+ * - FTS5 virtual table (instead of PostgreSQL GIN index)
+ */
+export declare const memoryMigrationLibSQL: Migration;
 /**
  * Export memory migrations array
  */
 export declare const memoryMigrations: Migration[];
+export declare const memoryMigrationsLibSQL: Migration[];
 //# sourceMappingURL=migrations.d.ts.map

package/dist/memory/migrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/memory/migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,SAkD7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,EAAsB,CAAC"}
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/memory/migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,SAkD7B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,EAAE,SA6DnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,EAAsB,CAAC;AAC/D,eAAO,MAAM,sBAAsB,EAAE,SAAS,EAA4B,CAAC"}

package/dist/memory/store.d.ts

@@ -1,30 +1,31 @@
 /**
- * Memory Store - PGlite + pgvector operations
+ * Memory Store - Drizzle-based memory operations
  *
- * Provides CRUD operations and semantic search for memories using
- * an existing shared PGlite instance. Does NOT create its own database.
+ * Provides CRUD operations and semantic search for memories using Drizzle ORM.
+ * Replaces raw SQL adapter detection with Drizzle's unified query interface.
  *
  * ## Design Pattern
- * - Accept DatabaseAdapter via factory parameter (dependency injection)
- * - Share PGlite instance with other swarm-mail services
- * - Schema migrations handled separately (by migrations task)
+ * - Uses Drizzle query builder for all operations (except vector search)
+ * - Vector similarity search uses sql`` template for vector_distance_cos()
+ * - No adapter type detection needed - Drizzle handles PGlite/libSQL differences
  *
  * ## Key Operations
- * - store: Insert or update memory with embedding
+ * - store: Insert or update memory with embedding (UPSERT via onConflictDoUpdate)
  * - search: Vector similarity search with threshold/limit/collection filters
- * - ftsSearch: Full-text search with PostgreSQL FTS
+ * - ftsSearch: Full-text search (uses raw SQL - FTS5 not yet in Drizzle)
  * - list: List all memories, optionally filtered by collection
  * - get: Retrieve single memory by ID
  * - delete: Remove memory and its embedding
  * - getStats: Memory and embedding counts
  *
- * ## Vector Search Query
- * Uses pgvector's <=> operator for cosine distance, where:
- * - 0 = identical vectors
- * - 2 = opposite vectors
- * - Score = 1 - distance (higher is more similar)
+ * ## Migration Notes
+ * - Removed detectAdapterType() - Drizzle abstracts this
+ * - Removed PGlite-specific code (separate memory_embeddings table)
+ * - libSQL schema has embedding inline in memories table
+ * - JSON columns (metadata, tags) stored as TEXT, need JSON.parse/stringify
+ * - Timestamps are TEXT (ISO strings)
  */
-import type { DatabaseAdapter } from "../types/database.js";
+import type { SwarmDb } from "../db/client.js";
 /** Embedding dimension for mxbai-embed-large */
 export declare const EMBEDDING_DIM = 1024;
 /** Memory data structure */
@@ -50,31 +51,30 @@ export interface SearchOptions {
     readonly collection?: string;
 }
 /**
- * Create a memory store using a shared DatabaseAdapter
+ * Create a memory store using Drizzle ORM
  *
- * @param db - DatabaseAdapter instance (shared PGLite, SQLite, PostgreSQL, etc.)
+ * Uses Drizzle query builder for all operations except vector search
+ * (vector_distance_cos requires raw SQL template).
+ *
+ * @param db - Drizzle database instance (libSQL)
  * @returns Memory store operations
  *
  * @example
  * ```typescript
- * import { wrapPGlite } from '../pglite.js';
- * import { PGlite } from '@electric-sql/pglite';
- * import { vector } from '@electric-sql/pglite/vector';
- *
- * const pglite = await PGlite.create({ dataDir: './db', extensions: { vector } });
- * const db = wrapPGlite(pglite);
+ * import { createInMemoryDb } from '../db/client.js';
+ * const db = await createInMemoryDb();
  * const store = createMemoryStore(db);
  *
  * await store.store(memory, embedding);
  * const results = await store.search(queryEmbedding);
  * ```
  */
-export declare function createMemoryStore(db: DatabaseAdapter): {
+export declare function createMemoryStore(db: SwarmDb): {
     /**
      * Store a memory with its embedding
      *
-     * Uses UPSERT (INSERT ... ON CONFLICT DO UPDATE) to handle both
-     * new memories and updates to existing ones atomically.
+     * Uses Drizzle's onConflictDoUpdate for UPSERT behavior.
+     * Vector embedding stored via sql`` template with vector() function.
      *
      * @param memory - Memory to store
      * @param embedding - 1024-dimensional vector
@@ -84,8 +84,14 @@ export declare function createMemoryStore(db: DatabaseAdapter): {
     /**
      * Vector similarity search
      *
-     * Finds memories with embeddings similar to the query embedding.
-     * Uses cosine distance (<=> operator) with HNSW index for performance.
+     * Uses vector_top_k() function with libsql_vector_idx for efficient ANN search.
+     * Returns results sorted by similarity (highest first).
+     *
+     * libSQL vector search requires:
+     * 1. A vector index: CREATE INDEX ... ON table(libsql_vector_idx(column))
+     * 2. Using vector_top_k() which returns a virtual table with just (id) - the rowid
+     * 3. Joining the virtual table back to get full rows
+     * 4. Calculating distance separately with vector_distance_cos()
      *
      * @param queryEmbedding - 1024-dimensional query vector
      * @param options - Search options (limit, threshold, collection)
@@ -95,12 +101,12 @@ export declare function createMemoryStore(db: DatabaseAdapter): {
     /**
      * Full-text search
      *
-     * Searches memory content using PostgreSQL's full-text search.
-     * Uses GIN index on to_tsvector('english', content) for performance.
+     * Uses FTS5 virtual table (memories_fts) for text search.
+     * Falls back to raw SQL since FTS5 isn't yet in Drizzle.
      *
      * @param searchQuery - Text query string
      * @param options - Search options (limit, collection)
-     * @returns Array of search results ranked by ts_rank
+     * @returns Array of search results ranked by relevance
      */
     ftsSearch(searchQuery: string, options?: SearchOptions): Promise<SearchResult[]>;
     /**
@@ -120,7 +126,7 @@ export declare function createMemoryStore(db: DatabaseAdapter): {
     /**
      * Delete a memory
      *
-     * Cascade delete handles memory_embeddings automatically.
+     * Embedding stored inline in same table, single DELETE works.
      *
      * @param id - Memory ID
      */
@@ -128,6 +134,8 @@ export declare function createMemoryStore(db: DatabaseAdapter): {
     /**
      * Get database statistics
      *
+     * Counts memories and embeddings (embeddings in same table).
+     *
      * @returns Memory and embedding counts
      */
     getStats(): Promise<{

package/dist/memory/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAM5D,gDAAgD;AAChD,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC,4BAA4B;AAC5B,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;CACtC;AAED,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,eAAe;IAcjD;;;;;;;;;OASG;kBACiB,MAAM,aAAa,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC/D;;;;;;;;;OASG;2BAEe,MAAM,EAAE,YACf,aAAa,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC;IAmD1B;;;;;;;;;OASG;2BAEY,MAAM,YACV,aAAa,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC;IAqC1B;;;;;OAKG;sBACqB,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAelD;;;;;OAKG;YACW,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQ7C;;;;;;OAMG;eACc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;;;OAIG;gBACe,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;EActE"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAO/C,gDAAgD;AAChD,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC,4BAA4B;AAC5B,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;CACtC;AAED,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,OAAO;IAuBzC;;;;;;;;;OASG;kBACiB,MAAM,aAAa,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B/D;;;;;;;;;;;;;;;OAeG;2BAEe,MAAM,EAAE,YACf,aAAa,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC;IA6C1B;;;;;;;;;OASG;2BAEY,MAAM,YACV,aAAa,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC;IA4C1B;;;;;OAKG;sBACqB,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAYlD;;;;;OAKG;YACW,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAS7C;;;;;;OAMG;eACc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;;;;;OAMG;gBACe,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;EAgBtE"}

package/dist/memory/test-utils.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Test Utilities for Memory Store
+ *
+ * Provides shared test setup for in-memory libSQL databases with full memory schema.
+ * This ensures consistency across all memory-related tests by centralizing the schema setup.
+ *
+ * ## Key Features
+ * - Creates in-memory libSQL database with full memory schema
+ * - Includes vector index for similarity search (required for vector_top_k)
+ * - Sets up FTS5 virtual table for full-text search fallback
+ * - Creates triggers to keep FTS in sync with memories table
+ * - Returns cleanup function for proper test teardown
+ *
+ * ## Usage
+ * ```typescript
+ * import { createTestMemoryDb } from 'swarm-mail';
+ *
+ * let cleanup: () => Promise<void>;
+ *
+ * beforeEach(async () => {
+ *   const setup = await createTestMemoryDb();
+ *   db = setup.db;
+ *   client = setup.client;
+ *   cleanup = setup.cleanup;
+ * });
+ *
+ * afterEach(async () => {
+ *   await cleanup();
+ * });
+ * ```
+ *
+ * ## Why This Exists
+ * The critical piece that's often missed in manual schema setup is the vector index:
+ * ```sql
+ * CREATE INDEX idx_memories_embedding ON memories(libsql_vector_idx(embedding))
+ * ```
+ * Without it, vector_top_k() fails with "failed to parse vector index parameters".
+ *
+ * This utility ensures all memory tests use the same complete schema.
+ */
+import type { Client } from "@libsql/client";
+import type { SwarmDb } from "../db/client.js";
+/**
+ * Create in-memory libSQL database with complete memory schema
+ *
+ * Sets up:
+ * - memories table with F32_BLOB(1024) vector column
+ * - FTS5 virtual table for full-text search
+ * - Triggers to keep FTS in sync
+ * - Vector index for similarity search
+ *
+ * @returns Database client, Drizzle client, and cleanup function
+ */
+export declare function createTestMemoryDb(): Promise<{
+    client: Client;
+    db: SwarmDb;
+    cleanup: () => Promise<void>;
+}>;
+//# sourceMappingURL=test-utils.d.ts.map