@zauso-ai/capstan-db 0.2.0 → 0.3.0

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export type ScalarType = "string" | "integer" | "number" | "boolean" | "date" | "datetime" | "text" | "json";
+export type ScalarType = "string" | "integer" | "number" | "boolean" | "date" | "datetime" | "text" | "json" | "vector";
 export interface FieldDefinition {
     type: ScalarType;
     required?: boolean;
@@ -7,6 +7,8 @@ export interface FieldDefinition {
     min?: number;
     max?: number;
     enum?: readonly string[];
+    /** Number of dimensions for vector fields */
+    dimensions?: number;
     /** Auto-set to current time on update */
     updatedAt?: boolean;
     /** Auto-generate UUID */
@@ -32,7 +34,7 @@ export interface ModelDefinition {
     relations: Record<string, RelationDefinition>;
     indexes: IndexDefinition[];
 }
-export type DbProvider = "sqlite" | "postgres" | "mysql";
+export type DbProvider = "sqlite" | "postgres" | "mysql" | "libsql";
 export interface DatabaseConfig {
     provider: DbProvider;
     url: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7G,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yBAAyB;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC9C,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yBAAyB;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC9C,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/vector-store-memory.d.ts

@@ -0,0 +1,31 @@
+import type { VectorFilter, VectorHybridSearchOptions, VectorSearchResult, VectorStore, VectorStoreConfig } from "./vector-store.js";
+interface StoredEntry {
+    vector: number[];
+    metadata: Record<string, unknown>;
+}
+/**
+ * In-memory vector store backed by a `Map`.
+ *
+ * This implementation wraps the same cosine-distance utilities that power the
+ * existing `findNearest` and `hybridSearch` exports so that behaviour is
+ * identical when running without a database.
+ */
+export declare class InMemoryVectorStore implements VectorStore {
+    /** @internal */
+    readonly _store: Map<string, StoredEntry>;
+    private readonly _dimensions;
+    constructor(config?: Partial<VectorStoreConfig>);
+    private _validateDimensions;
+    upsert(id: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
+    upsertBatch(items: ReadonlyArray<{
+        id: string;
+        vector: number[];
+        metadata?: Record<string, unknown>;
+    }>): Promise<void>;
+    search(query: number[], k: number, filter?: VectorFilter): Promise<VectorSearchResult[]>;
+    hybridSearch(query: string, queryVector: number[], k: number, opts?: VectorHybridSearchOptions): Promise<VectorSearchResult[]>;
+    remove(id: string): Promise<boolean>;
+    count(): Promise<number>;
+}
+export {};
+//# sourceMappingURL=vector-store-memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store-memory.d.ts","sourceRoot":"","sources":["../../../.claude/worktrees/agent-a1ae6f0b/packages/db/src/vector-store-memory.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAE3B,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAqCD;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,gBAAgB;IAChB,QAAQ,CAAC,MAAM,2BAAkC;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;gBAErC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAI/C,OAAO,CAAC,mBAAmB;IAWrB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvF,WAAW,CACf,KAAK,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,GACzF,OAAO,CAAC,IAAI,CAAC;IASV,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAexF,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EAAE,EACrB,CAAC,EAAE,MAAM,EACT,IAAI,CAAC,EAAE,yBAAyB,GAC/B,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAgC1B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAG/B"}

package/dist/vector-store-memory.js

@@ -0,0 +1,125 @@
+// ---------------------------------------------------------------------------
+// InMemoryVectorStore — brute-force in-memory vector search
+// ---------------------------------------------------------------------------
+//
+// Suitable for development and small datasets (<10K vectors).  All data lives
+// in a plain Map and is lost when the process exits.  Search is O(n) per
+// query — acceptable for prototyping but not for production workloads.
+// ---------------------------------------------------------------------------
+import { cosineDistance } from "./search.js";
+/** Simple whitespace tokeniser with lower-casing and deduplication. */
+function tokenize(text) {
+    return [
+        ...new Set(text
+            .toLowerCase()
+            .split(/\W+/)
+            .filter((t) => t.length > 0)),
+    ];
+}
+/** Normalised keyword overlap score in [0, 1]. */
+function keywordOverlap(queryTerms, text) {
+    if (queryTerms.length === 0)
+        return 0;
+    const docTokens = new Set(tokenize(text));
+    let hits = 0;
+    for (const term of queryTerms) {
+        if (docTokens.has(term))
+            hits++;
+    }
+    return hits / queryTerms.length;
+}
+function matchesFilter(metadata, filter) {
+    for (const [key, value] of Object.entries(filter)) {
+        const actual = metadata[key];
+        if (Array.isArray(value)) {
+            if (!value.includes(actual))
+                return false;
+        }
+        else if (actual !== value) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * In-memory vector store backed by a `Map`.
+ *
+ * This implementation wraps the same cosine-distance utilities that power the
+ * existing `findNearest` and `hybridSearch` exports so that behaviour is
+ * identical when running without a database.
+ */
+export class InMemoryVectorStore {
+    /** @internal */
+    _store = new Map();
+    _dimensions;
+    constructor(config) {
+        this._dimensions = config?.dimensions;
+    }
+    _validateDimensions(vector) {
+        if (vector.length === 0) {
+            throw new Error("Cannot store a zero-length vector.");
+        }
+        if (this._dimensions !== undefined && vector.length !== this._dimensions) {
+            throw new Error(`Dimension mismatch: expected ${this._dimensions}, got ${vector.length}.`);
+        }
+    }
+    async upsert(id, vector, metadata) {
+        this._validateDimensions(vector);
+        this._store.set(id, { vector, metadata: metadata ?? {} });
+    }
+    async upsertBatch(items) {
+        for (const item of items) {
+            this._validateDimensions(item.vector);
+        }
+        for (const item of items) {
+            this._store.set(item.id, { vector: item.vector, metadata: item.metadata ?? {} });
+        }
+    }
+    async search(query, k, filter) {
+        if (query.length === 0)
+            return [];
+        const results = [];
+        for (const [id, entry] of this._store) {
+            if (filter && !matchesFilter(entry.metadata, filter))
+                continue;
+            if (entry.vector.length !== query.length)
+                continue;
+            const score = 1 - cosineDistance(query, entry.vector);
+            results.push({ id, score, metadata: entry.metadata });
+        }
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, Math.max(0, k));
+    }
+    async hybridSearch(query, queryVector, k, opts) {
+        const keywordWeight = opts?.keywordWeight ?? 0.3;
+        const vectorWeight = opts?.vectorWeight ?? 0.7;
+        const queryTerms = tokenize(query);
+        if (queryTerms.length === 0 && queryVector.length === 0)
+            return [];
+        const results = [];
+        for (const [id, entry] of this._store) {
+            if (opts?.filter && !matchesFilter(entry.metadata, opts.filter))
+                continue;
+            const vectorScore = queryVector.length > 0 && entry.vector.length === queryVector.length
+                ? 1 - cosineDistance(queryVector, entry.vector)
+                : 0;
+            // Use the "text" metadata field for keyword matching when available.
+            const text = typeof entry.metadata["text"] === "string" ? entry.metadata["text"] : "";
+            const kwScore = keywordOverlap(queryTerms, text);
+            results.push({
+                id,
+                score: vectorWeight * vectorScore + keywordWeight * kwScore,
+                metadata: entry.metadata,
+            });
+        }
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, Math.max(0, k));
+    }
+    async remove(id) {
+        return this._store.delete(id);
+    }
+    async count() {
+        return this._store.size;
+    }
+}
+//# sourceMappingURL=vector-store-memory.js.map

package/dist/vector-store-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store-memory.js","sourceRoot":"","sources":["../../../.claude/worktrees/agent-a1ae6f0b/packages/db/src/vector-store-memory.ts"],"names":[],"mappings":"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"}

package/dist/vector-store-pgvector.d.ts

@@ -0,0 +1,46 @@
+import type { VectorFilter, VectorHybridSearchOptions, VectorSearchResult, VectorStore, VectorStoreConfig } from "./vector-store.js";
+/** Minimal query interface accepted by the pgvector store. */
+export interface PgQueryFn {
+    /** Execute a parameterised SQL statement and return rows. */
+    (sql: string, params?: unknown[]): Promise<Record<string, unknown>[]>;
+}
+/**
+ * PostgreSQL vector store powered by the pgvector extension.
+ *
+ * The store creates a `capstan_vectors` table (configurable via
+ * `config.tableName`) and uses the `<=>` cosine distance operator for
+ * similarity search.  The pgvector extension is created automatically on
+ * first use if the connected role has the required permissions.
+ *
+ * No pgvector npm package is required — all interaction happens through raw
+ * parameterised SQL.
+ */
+export declare class PgVectorStore implements VectorStore {
+    private readonly _query;
+    private readonly _table;
+    private readonly _dimensions;
+    private _initialised;
+    constructor(config: VectorStoreConfig & {
+        connection: PgQueryFn;
+    });
+    /** @internal */
+    _ensureSchema(): Promise<void>;
+    upsert(id: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
+    upsertBatch(items: ReadonlyArray<{
+        id: string;
+        vector: number[];
+        metadata?: Record<string, unknown>;
+    }>): Promise<void>;
+    search(query: number[], k: number, filter?: VectorFilter): Promise<VectorSearchResult[]>;
+    hybridSearch(query: string, queryVector: number[], k: number, opts?: VectorHybridSearchOptions): Promise<VectorSearchResult[]>;
+    remove(id: string): Promise<boolean>;
+    count(): Promise<number>;
+    private _validateDimensions;
+    /** Format a number array as a pgvector literal `[1,2,3]`. */
+    private _vec;
+    /** Quote a SQL identifier to prevent injection. */
+    private _qi;
+    /** Build a WHERE clause from a VectorFilter, starting param indices at `startIdx`. */
+    private _buildFilterClause;
+}
+//# sourceMappingURL=vector-store-pgvector.d.ts.map

package/dist/vector-store-pgvector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store-pgvector.d.ts","sourceRoot":"","sources":["../../../.claude/worktrees/agent-a1ae6f0b/packages/db/src/vector-store-pgvector.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAE3B,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACxB,6DAA6D;IAC7D,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;CACvE;AAED;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,YAAW,WAAW;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,iBAAiB,GAAG;QAAE,UAAU,EAAE,SAAS,CAAA;KAAE;IAgBjE,gBAAgB;IACV,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA6C9B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvF,WAAW,CACf,KAAK,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,GACzF,OAAO,CAAC,IAAI,CAAC;IA6BV,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA0BxF,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EAAE,EACrB,CAAC,EAAE,MAAM,EACT,IAAI,CAAC,EAAE,yBAAyB,GAC/B,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAkC1B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASpC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAY9B,OAAO,CAAC,mBAAmB;IAW3B,6DAA6D;IAC7D,OAAO,CAAC,IAAI;IAIZ,mDAAmD;IACnD,OAAO,CAAC,GAAG;IAIX,sFAAsF;IACtF,OAAO,CAAC,kBAAkB;CA0B3B"}

package/dist/vector-store-pgvector.js

@@ -0,0 +1,215 @@
+// ---------------------------------------------------------------------------
+// PgVectorStore — PostgreSQL pgvector-backed vector search
+// ---------------------------------------------------------------------------
+//
+// Uses raw SQL over a caller-supplied query function so there is no hard
+// dependency on any specific PostgreSQL client library.  The pgvector
+// extension must be installed in the target database.
+// ---------------------------------------------------------------------------
+/**
+ * PostgreSQL vector store powered by the pgvector extension.
+ *
+ * The store creates a `capstan_vectors` table (configurable via
+ * `config.tableName`) and uses the `<=>` cosine distance operator for
+ * similarity search.  The pgvector extension is created automatically on
+ * first use if the connected role has the required permissions.
+ *
+ * No pgvector npm package is required — all interaction happens through raw
+ * parameterised SQL.
+ */
+export class PgVectorStore {
+    _query;
+    _table;
+    _dimensions;
+    _initialised = false;
+    constructor(config) {
+        if (!config.connection) {
+            throw new Error("PgVectorStore requires a `connection` query function.");
+        }
+        if (!config.dimensions) {
+            throw new Error("PgVectorStore requires `dimensions` to be specified.");
+        }
+        this._query = config.connection;
+        this._table = config.tableName ?? "capstan_vectors";
+        this._dimensions = config.dimensions;
+    }
+    // -------------------------------------------------------------------------
+    // Schema bootstrap
+    // -------------------------------------------------------------------------
+    /** @internal */
+    async _ensureSchema() {
+        if (this._initialised)
+            return;
+        try {
+            await this._query("CREATE EXTENSION IF NOT EXISTS vector");
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new Error(`pgvector extension not found. Run: CREATE EXTENSION vector;\n` +
+                `Underlying error: ${message}`);
+        }
+        const table = this._table;
+        const dim = this._dimensions;
+        await this._query(`
+      CREATE TABLE IF NOT EXISTS ${this._qi(table)} (
+        id   TEXT PRIMARY KEY,
+        embedding vector(${dim}) NOT NULL,
+        content   TEXT NOT NULL DEFAULT '',
+        metadata  JSONB NOT NULL DEFAULT '{}'::jsonb
+      )
+    `);
+        // Create an IVFFlat index if it does not already exist.  The index
+        // requires at least one row so we wrap in a DO block that is safe to
+        // re-run.
+        await this._query(`
+      CREATE INDEX IF NOT EXISTS ${this._qi(table + "_embedding_idx")}
+        ON ${this._qi(table)}
+        USING ivfflat (embedding vector_cosine_ops)
+        WITH (lists = 100)
+    `).catch(() => {
+            // Index creation can fail on an empty table — that is fine, it will
+            // be retried lazily on the next search.
+        });
+        this._initialised = true;
+    }
+    // -------------------------------------------------------------------------
+    // VectorStore implementation
+    // -------------------------------------------------------------------------
+    async upsert(id, vector, metadata) {
+        this._validateDimensions(vector);
+        await this._ensureSchema();
+        const text = typeof metadata?.["text"] === "string" ? metadata["text"] : "";
+        const metaJson = JSON.stringify(metadata ?? {});
+        await this._query(`INSERT INTO ${this._qi(this._table)} (id, embedding, content, metadata)
+       VALUES ($1, $2::vector, $3, $4::jsonb)
+       ON CONFLICT (id) DO UPDATE
+         SET embedding = EXCLUDED.embedding,
+             content   = EXCLUDED.content,
+             metadata  = EXCLUDED.metadata`, [id, this._vec(vector), text, metaJson]);
+    }
+    async upsertBatch(items) {
+        if (items.length === 0)
+            return;
+        for (const item of items)
+            this._validateDimensions(item.vector);
+        await this._ensureSchema();
+        // Batch upserts using a single multi-row INSERT .. ON CONFLICT.
+        const valueClauses = [];
+        const params = [];
+        let idx = 1;
+        for (const item of items) {
+            const text = typeof item.metadata?.["text"] === "string" ? item.metadata["text"] : "";
+            const metaJson = JSON.stringify(item.metadata ?? {});
+            valueClauses.push(`($${idx}, $${idx + 1}::vector, $${idx + 2}, $${idx + 3}::jsonb)`);
+            params.push(item.id, this._vec(item.vector), text, metaJson);
+            idx += 4;
+        }
+        await this._query(`INSERT INTO ${this._qi(this._table)} (id, embedding, content, metadata)
+       VALUES ${valueClauses.join(", ")}
+       ON CONFLICT (id) DO UPDATE
+         SET embedding = EXCLUDED.embedding,
+             content   = EXCLUDED.content,
+             metadata  = EXCLUDED.metadata`, params);
+    }
+    async search(query, k, filter) {
+        if (query.length === 0)
+            return [];
+        this._validateDimensions(query);
+        await this._ensureSchema();
+        const { clause, params, nextIndex } = this._buildFilterClause(filter, 2);
+        const rows = await this._query(`SELECT id, metadata, 1 - (embedding <=> $1::vector) AS score
+       FROM ${this._qi(this._table)}
+       ${clause}
+       ORDER BY embedding <=> $1::vector
+       LIMIT $${nextIndex}`, [this._vec(query), ...params, Math.max(1, k)]);
+        return rows.map((row) => {
+            const meta = typeof row["metadata"] === "string"
+                ? JSON.parse(row["metadata"])
+                : row["metadata"];
+            const result = { id: String(row["id"]), score: Number(row["score"]) };
+            if (meta !== undefined)
+                result.metadata = meta;
+            return result;
+        });
+    }
+    async hybridSearch(query, queryVector, k, opts) {
+        if (query.length === 0 && queryVector.length === 0)
+            return [];
+        if (queryVector.length > 0)
+            this._validateDimensions(queryVector);
+        await this._ensureSchema();
+        const vectorWeight = opts?.vectorWeight ?? 0.7;
+        const keywordWeight = opts?.keywordWeight ?? 0.3;
+        const { clause, params, nextIndex } = this._buildFilterClause(opts?.filter, 3);
+        let idx = nextIndex;
+        // Use ts_rank for text relevance combined with cosine similarity.
+        const rows = await this._query(`SELECT id, metadata,
+              ${vectorWeight} * (1 - (embedding <=> $1::vector))
+            + ${keywordWeight} * COALESCE(ts_rank(to_tsvector('simple', content), plainto_tsquery('simple', $2)), 0)
+            AS score
+       FROM ${this._qi(this._table)}
+       ${clause}
+       ORDER BY score DESC
+       LIMIT $${idx}`, [this._vec(queryVector), query, ...params, Math.max(1, k)]);
+        return rows.map((row) => {
+            const meta = typeof row["metadata"] === "string"
+                ? JSON.parse(row["metadata"])
+                : row["metadata"];
+            const result = { id: String(row["id"]), score: Number(row["score"]) };
+            if (meta !== undefined)
+                result.metadata = meta;
+            return result;
+        });
+    }
+    async remove(id) {
+        await this._ensureSchema();
+        const rows = await this._query(`DELETE FROM ${this._qi(this._table)} WHERE id = $1 RETURNING id`, [id]);
+        return rows.length > 0;
+    }
+    async count() {
+        await this._ensureSchema();
+        const rows = await this._query(`SELECT COUNT(*)::int AS count FROM ${this._qi(this._table)}`);
+        return Number(rows[0]?.["count"] ?? 0);
+    }
+    // -------------------------------------------------------------------------
+    // Internal helpers
+    // -------------------------------------------------------------------------
+    _validateDimensions(vector) {
+        if (vector.length === 0) {
+            throw new Error("Cannot store a zero-length vector.");
+        }
+        if (vector.length !== this._dimensions) {
+            throw new Error(`Dimension mismatch: expected ${this._dimensions}, got ${vector.length}.`);
+        }
+    }
+    /** Format a number array as a pgvector literal `[1,2,3]`. */
+    _vec(v) {
+        return `[${v.join(",")}]`;
+    }
+    /** Quote a SQL identifier to prevent injection. */
+    _qi(identifier) {
+        return `"${identifier.replace(/"/g, '""')}"`;
+    }
+    /** Build a WHERE clause from a VectorFilter, starting param indices at `startIdx`. */
+    _buildFilterClause(filter, startIdx) {
+        if (!filter || Object.keys(filter).length === 0) {
+            return { clause: "", params: [], nextIndex: startIdx };
+        }
+        const parts = [];
+        const params = [];
+        let idx = startIdx;
+        for (const [key, value] of Object.entries(filter)) {
+            // Use JSONB containment for metadata filtering.
+            const fragment = JSON.stringify({ [key]: value });
+            parts.push(`metadata @> $${idx}::jsonb`);
+            params.push(fragment);
+            idx++;
+        }
+        return {
+            clause: `WHERE ${parts.join(" AND ")}`,
+            params,
+            nextIndex: idx,
+        };
+    }
+}
+//# sourceMappingURL=vector-store-pgvector.js.map

package/dist/vector-store-pgvector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store-pgvector.js","sourceRoot":"","sources":["../../../.claude/worktrees/agent-a1ae6f0b/packages/db/src/vector-store-pgvector.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2DAA2D;AAC3D,8EAA8E;AAC9E,EAAE;AACF,yEAAyE;AACzE,sEAAsE;AACtE,sDAAsD;AACtD,8EAA8E;AAgB9E;;;;;;;;;;GAUG;AACH,MAAM,OAAO,aAAa;IACP,MAAM,CAAY;IAClB,MAAM,CAAS;IACf,WAAW,CAAS;IAC7B,YAAY,GAAG,KAAK,CAAC;IAE7B,YAAY,MAAqD;QAC/D,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,IAAI,iBAAiB,CAAC;QACpD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC;IACvC,CAAC;IAED,4EAA4E;IAC5E,mBAAmB;IACnB,4EAA4E;IAE5E,gBAAgB;IAChB,KAAK,CAAC,aAAa;QACjB,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAE9B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,uCAAuC,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,IAAI,KAAK,CACb,+DAA+D;gBAC/D,qBAAqB,OAAO,EAAE,CAC/B,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;QAE7B,MAAM,IAAI,CAAC,MAAM,CAAC;mCACa,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;;2BAEvB,GAAG;;;;KAIzB,CAAC,CAAC;QAEH,mEAAmE;QACnE,qEAAqE;QACrE,UAAU;QACV,MAAM,IAAI,CAAC,MAAM,CAAC;mCACa,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,gBAAgB,CAAC;aACxD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;;;KAGvB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACZ,oEAAoE;YACpE,wCAAwC;QAC1C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,4EAA4E;IAC5E,6BAA6B;IAC7B,4EAA4E;IAE5E,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,MAAgB,EAAE,QAAkC;QAC3E,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAE3B,MAAM,IAAI,GAAG,OAAO,QAAQ,EAAE,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,IAAI,CAAC,MAAM,CACf,eAAe,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;;;;;2CAKC,EACrC,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CACxC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CACf,KAA0F;QAE1F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAE3B,gEAAgE;QAChE,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,GAAG,GAAG,CAAC,CAAC;QAEZ,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtF,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YACrD,YAAY,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,GAAG,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;YACrF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC7D,GAAG,IAAI,CAAC,CAAC;QACX,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CACf,eAAe,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;gBAC1B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;;;;2CAII,EACrC,MAAM,CACP,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAe,EAAE,CAAS,EAAE,MAAqB;QAC5D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAE3B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAEzE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAC5B;cACQ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;SAC1B,MAAM;;gBAEC,SAAS,EAAE,EACrB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAC9C,CAAC;QAEF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,UAAU,CAAC,KAAK,QAAQ;gBAC9C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAW,CAA4B;gBAClE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAwC,CAAC;YAC3D,MAAM,MAAM,GAAuB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC1F,IAAI,IAAI,KAAK,SAAS;gBAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;YAC/C,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,KAAa,EACb,WAAqB,EACrB,CAAS,EACT,IAAgC;QAEhC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC9D,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAClE,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAE3B,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,GAAG,CAAC;QAC/C,MAAM,aAAa,GAAG,IAAI,EAAE,aAAa,IAAI,GAAG,CAAC;QAEjD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAC/E,IAAI,GAAG,GAAG,SAAS,CAAC;QAEpB,kEAAkE;QAClE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAC5B;gBACU,YAAY;gBACZ,aAAa;;cAEf,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;SAC1B,MAAM;;gBAEC,GAAG,EAAE,EACf,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAC3D,CAAC;QAEF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,UAAU,CAAC,KAAK,QAAQ;gBAC9C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAW,CAA4B;gBAClE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAwC,CAAC;YAC3D,MAAM,MAAM,GAAuB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC1F,IAAI,IAAI,KAAK,SAAS;gBAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;YAC/C,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAC5B,eAAe,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,6BAA6B,EACjE,CAAC,EAAE,CAAC,CACL,CAAC;QACF,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAC5B,sCAAsC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAC9D,CAAC;QACF,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,4EAA4E;IAC5E,mBAAmB;IACnB,4EAA4E;IAEpE,mBAAmB,CAAC,MAAgB;QAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,gCAAgC,IAAI,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,GAAG,CAC1E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,6DAA6D;IACrD,IAAI,CAAC,CAAW;QACtB,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC5B,CAAC;IAED,mDAAmD;IAC3C,GAAG,CAAC,UAAkB;QAC5B,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;IAC/C,CAAC;IAED,sFAAsF;IAC9E,kBAAkB,CACxB,MAAgC,EAChC,QAAgB;QAEhB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChD,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QACzD,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,GAAG,GAAG,QAAQ,CAAC;QAEnB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,gDAAgD;YAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtB,GAAG,EAAE,CAAC;QACR,CAAC;QAED,OAAO;YACL,MAAM,EAAE,SAAS,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YACtC,MAAM;YACN,SAAS,EAAE,GAAG;SACf,CAAC;IACJ,CAAC;CACF"}

package/dist/vector-store-sqlite.d.ts

@@ -0,0 +1,51 @@
+import type { VectorFilter, VectorHybridSearchOptions, VectorSearchResult, VectorStore, VectorStoreConfig } from "./vector-store.js";
+/**
+ * Minimal interface for a `better-sqlite3` Database instance.
+ *
+ * We only declare the subset of the API we actually use so that callers are
+ * not forced to depend on `@types/better-sqlite3`.
+ */
+export interface SqliteConnection {
+    prepare(sql: string): {
+        run(...params: unknown[]): {
+            changes: number;
+        };
+        all(...params: unknown[]): Record<string, unknown>[];
+        get(...params: unknown[]): Record<string, unknown> | undefined;
+    };
+    exec(sql: string): void;
+}
+/**
+ * SQLite vector store.
+ *
+ * Stores vectors as JSON text columns and loads them into memory for
+ * brute-force cosine search.  The trade-off is durability with a simple
+ * dependency chain — no native extensions beyond `better-sqlite3`.
+ */
+export declare class SqliteVectorStore implements VectorStore {
+    private readonly _db;
+    private readonly _table;
+    private readonly _dimensions;
+    private _initialised;
+    constructor(config: VectorStoreConfig & {
+        connection: SqliteConnection;
+    });
+    /** @internal */
+    _ensureSchema(): void;
+    upsert(id: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
+    upsertBatch(items: ReadonlyArray<{
+        id: string;
+        vector: number[];
+        metadata?: Record<string, unknown>;
+    }>): Promise<void>;
+    search(query: number[], k: number, filter?: VectorFilter): Promise<VectorSearchResult[]>;
+    hybridSearch(query: string, queryVector: number[], k: number, opts?: VectorHybridSearchOptions): Promise<VectorSearchResult[]>;
+    remove(id: string): Promise<boolean>;
+    count(): Promise<number>;
+    private _validateDimensions;
+    /** Load all stored rows, parsing JSON columns. */
+    private _loadAll;
+    /** Escape a SQL identifier (double-quote style). */
+    private _esc;
+}
+//# sourceMappingURL=vector-store-sqlite.d.ts.map

package/dist/vector-store-sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store-sqlite.d.ts","sourceRoot":"","sources":["../../../.claude/worktrees/agent-a1ae6f0b/packages/db/src/vector-store-sqlite.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;QACpB,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;KAChE,CAAC;IACF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AA2CD;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAmB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,iBAAiB,GAAG;QAAE,UAAU,EAAE,gBAAgB,CAAA;KAAE;IAaxE,gBAAgB;IAChB,aAAa,IAAI,IAAI;IAiBf,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvF,WAAW,CACf,KAAK,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,GACzF,OAAO,CAAC,IAAI,CAAC;IAqBV,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAkBxF,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EAAE,EACrB,CAAC,EAAE,MAAM,EACT,IAAI,CAAC,EAAE,yBAAyB,GAC/B,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAgC1B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQpC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAY9B,OAAO,CAAC,mBAAmB;IAW3B,kDAAkD;IAClD,OAAO,CAAC,QAAQ;IAahB,oDAAoD;IACpD,OAAO,CAAC,IAAI;CAGb"}