@askdb/rag 0.2.0-beta.1

package/dist/stores/memory.js

@@ -0,0 +1,118 @@
+export function createMemoryStore() {
+    const records = new Map();
+    let dimensions;
+    const upsert = async (input) => {
+        for (const r of input) {
+            const f32 = toFloat32(r.vector);
+            if (dimensions === undefined)
+                dimensions = f32.length;
+            else if (dimensions !== f32.length) {
+                throw new Error(`Vector dimension mismatch: expected ${dimensions}, got ${f32.length} for id="${r.id}".`);
+            }
+            const existing = records.get(r.id);
+            records.set(r.id, {
+                id: r.id,
+                vector: f32,
+                payload: r.payload,
+                hash: r.hash ?? existing?.hash,
+            });
+        }
+    };
+    const query = async (vector, k, filter) => {
+        const q = toFloat32(vector);
+        const qNorm = norm(q);
+        if (qNorm === 0)
+            return [];
+        const out = [];
+        for (const r of records.values()) {
+            if (filter && !matchesFilter(r.payload, filter))
+                continue;
+            const rNorm = norm(r.vector);
+            if (rNorm === 0)
+                continue;
+            const score = dot(q, r.vector) / (qNorm * rNorm);
+            out.push({ id: r.id, score, payload: r.payload });
+        }
+        // Stable sort: score desc, then id asc for deterministic ties.
+        out.sort((a, b) => b.score !== a.score ? b.score - a.score : a.id < b.id ? -1 : a.id > b.id ? 1 : 0);
+        return out.slice(0, Math.max(0, k));
+    };
+    const del = async (ids) => {
+        for (const id of ids)
+            records.delete(id);
+    };
+    const hashesByPrefix = async (prefix) => {
+        const out = {};
+        for (const r of records.values()) {
+            if (r.hash && r.id.startsWith(prefix))
+                out[r.id] = r.hash;
+        }
+        return out;
+    };
+    return {
+        upsert,
+        query,
+        delete: del,
+        hashesByPrefix,
+        size() {
+            return records.size;
+        },
+        snapshot() {
+            return {
+                dimensions,
+                records: Array.from(records.values()).map((r) => ({
+                    id: r.id,
+                    vector: r.vector,
+                    payload: r.payload,
+                    hash: r.hash,
+                })),
+            };
+        },
+        restore(snap) {
+            records.clear();
+            dimensions = snap.dimensions;
+            for (const r of snap.records) {
+                records.set(r.id, {
+                    id: r.id,
+                    vector: toFloat32(r.vector),
+                    payload: r.payload,
+                    hash: r.hash,
+                });
+            }
+        },
+        setHash(id, hash) {
+            const r = records.get(id);
+            if (r)
+                r.hash = hash;
+        },
+    };
+}
+function toFloat32(v) {
+    return v instanceof Float32Array ? v : Float32Array.from(v);
+}
+function dot(a, b) {
+    let s = 0;
+    const len = Math.min(a.length, b.length);
+    for (let i = 0; i < len; i++)
+        s += a[i] * b[i];
+    return s;
+}
+function norm(v) {
+    let s = 0;
+    for (let i = 0; i < v.length; i++)
+        s += v[i] * v[i];
+    return Math.sqrt(s);
+}
+function matchesFilter(payload, filter) {
+    if (filter.schemaId !== undefined && payload.schemaId !== filter.schemaId)
+        return false;
+    if (filter.types && filter.types.length > 0 && !filter.types.includes(payload.type))
+        return false;
+    if (filter.refs && filter.refs.length > 0) {
+        const set = new Set(payload.refs);
+        if (!filter.refs.some((r) => set.has(r)))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=memory.js.map

package/dist/stores/memory.js.map

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

package/dist/stores/pgvector.d.ts

@@ -0,0 +1,41 @@
+import type { VectorStore } from "../types.js";
+/**
+ * Minimal `pg`-compatible client shape so this module can stay free of a
+ * hard dependency on the `pg` package. Consumers pass either a `pg.Pool`,
+ * `pg.Client`, or any object exposing `query(text, params)`.
+ */
+export type PgClient = {
+    query: (text: string, params?: unknown[]) => Promise<{
+        rows: unknown[];
+    }>;
+};
+export type PgvectorIndexStrategy = "ivfflat" | "hnsw" | "none";
+export type CreatePgvectorStoreOptions = {
+    /**
+     * Either a connection string (the adapter lazy-loads `pg`) or a pre-built
+     * client. When a client is supplied, the adapter never imports `pg`.
+     */
+    connectionString?: string;
+    client?: PgClient;
+    /** Table name to read/write. Default `"askdb_rag_chunks"`. */
+    table?: string;
+    /** Embedding dimensions. Required — pgvector columns are dimension-typed. */
+    dimensions: number;
+    /** Index strategy hint, surfaced via the documented DDL helper. Default `"hnsw"`. */
+    indexStrategy?: PgvectorIndexStrategy;
+};
+export type PgvectorStore = VectorStore & {
+    /** Documented DDL the consumer must run before first use. */
+    setupSql(): string;
+    /** Close any pool the adapter built internally. No-op when an external client was supplied. */
+    close(): Promise<void>;
+};
+/**
+ * pgvector adapter. Follows the same `VectorStore` interface as the other
+ * stores; cosine similarity via the `<=>` operator. Index creation is the
+ * consumer's responsibility — `setupSql()` returns documented DDL but is
+ * **not** auto-run (so accidental `CREATE EXTENSION` in production migrations
+ * doesn't surprise anyone).
+ */
+export declare function createPgvectorStore(options: CreatePgvectorStoreOptions): PgvectorStore;
+//# sourceMappingURL=pgvector.d.ts.map

package/dist/stores/pgvector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pgvector.d.ts","sourceRoot":"","sources":["../../src/stores/pgvector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAMV,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;CAC3E,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhE,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG;IACxC,6DAA6D;IAC7D,QAAQ,IAAI,MAAM,CAAC;IACnB,+FAA+F;IAC/F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAIF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,aAAa,CAsLf"}

package/dist/stores/pgvector.js

@@ -0,0 +1,176 @@
+const DEFAULT_TABLE = "askdb_rag_chunks";
+/**
+ * pgvector adapter. Follows the same `VectorStore` interface as the other
+ * stores; cosine similarity via the `<=>` operator. Index creation is the
+ * consumer's responsibility — `setupSql()` returns documented DDL but is
+ * **not** auto-run (so accidental `CREATE EXTENSION` in production migrations
+ * doesn't surprise anyone).
+ */
+export function createPgvectorStore(options) {
+    const table = options.table ?? DEFAULT_TABLE;
+    const dimensions = options.dimensions;
+    const indexStrategy = options.indexStrategy ?? "hnsw";
+    if (!Number.isInteger(dimensions) || dimensions <= 0) {
+        throw new Error(`pgvector store requires positive integer dimensions; got ${dimensions}`);
+    }
+    let internalPool;
+    let client = options.client;
+    const getClient = async () => {
+        if (client)
+            return client;
+        if (!options.connectionString) {
+            throw new Error("createPgvectorStore: pass either `client` or `connectionString`.");
+        }
+        // Lazy-load `pg` so the package stays usable without it for the other stores.
+        const pgMod = 
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        (await import("pg"));
+        const pool = new pgMod.Pool({ connectionString: options.connectionString });
+        internalPool = pool;
+        client = pool;
+        return pool;
+    };
+    const upsert = async (records) => {
+        if (records.length === 0)
+            return;
+        const c = await getClient();
+        // Single round-trip with parameterised UNNEST.
+        const ids = records.map((r) => r.id);
+        const types = records.map((r) => r.payload.type);
+        const texts = records.map((r) => r.payload.text);
+        const schemaIds = records.map((r) => r.payload.schemaId);
+        const refs = records.map((r) => JSON.stringify(r.payload.refs));
+        const sensitives = records.map((r) => r.payload.sensitive);
+        const vectors = records.map((r) => formatVector(r.vector));
+        const sql = `
+      INSERT INTO ${quoteIdent(table)} (id, type, text, schema_id, refs, sensitive, embedding)
+      SELECT
+        UNNEST($1::text[]),
+        UNNEST($2::text[]),
+        UNNEST($3::text[]),
+        UNNEST($4::text[]),
+        UNNEST($5::jsonb[]),
+        UNNEST($6::boolean[]),
+        UNNEST($7::vector[])
+      ON CONFLICT (id) DO UPDATE SET
+        type = EXCLUDED.type,
+        text = EXCLUDED.text,
+        schema_id = EXCLUDED.schema_id,
+        refs = EXCLUDED.refs,
+        sensitive = EXCLUDED.sensitive,
+        embedding = EXCLUDED.embedding
+    `;
+        await c.query(sql, [ids, types, texts, schemaIds, refs, sensitives, vectors]);
+    };
+    const query = async (vector, k, filter) => {
+        const c = await getClient();
+        const wheres = [];
+        const params = [formatVector(vector), Math.max(0, k)];
+        let pIdx = 3;
+        if (filter?.schemaId !== undefined) {
+            wheres.push(`schema_id = $${pIdx++}`);
+            params.push(filter.schemaId);
+        }
+        if (filter?.types && filter.types.length > 0) {
+            wheres.push(`type = ANY($${pIdx++}::text[])`);
+            params.push(filter.types);
+        }
+        if (filter?.refs && filter.refs.length > 0) {
+            wheres.push(`refs ?| $${pIdx++}::text[]`);
+            params.push(filter.refs);
+        }
+        const whereSql = wheres.length > 0 ? `WHERE ${wheres.join(" AND ")}` : "";
+        const sql = `
+      SELECT
+        id,
+        type,
+        text,
+        schema_id,
+        refs,
+        sensitive,
+        1 - (embedding <=> $1::vector) AS score
+      FROM ${quoteIdent(table)}
+      ${whereSql}
+      ORDER BY embedding <=> $1::vector ASC
+      LIMIT $2
+    `;
+        const result = await c.query(sql, params);
+        return result.rows.map((row) => {
+            const r = row;
+            const payload = {
+                id: r.id,
+                type: r.type,
+                text: r.text,
+                schemaId: r.schema_id,
+                refs: Array.isArray(r.refs) ? r.refs : [],
+                sensitive: r.sensitive,
+            };
+            return { id: r.id, score: r.score, payload };
+        });
+    };
+    const del = async (ids) => {
+        if (ids.length === 0)
+            return;
+        const c = await getClient();
+        await c.query(`DELETE FROM ${quoteIdent(table)} WHERE id = ANY($1::text[])`, [ids]);
+    };
+    const setupSql = () => {
+        const indexClause = indexStrategy === "hnsw"
+            ? `CREATE INDEX IF NOT EXISTS ${quoteIdent(`${table}_embedding_hnsw`)} ON ${quoteIdent(table)} USING hnsw (embedding vector_cosine_ops);`
+            : indexStrategy === "ivfflat"
+                ? `CREATE INDEX IF NOT EXISTS ${quoteIdent(`${table}_embedding_ivfflat`)} ON ${quoteIdent(table)} USING ivfflat (embedding vector_cosine_ops) WITH (lists = 100);`
+                : "";
+        return [
+            `CREATE EXTENSION IF NOT EXISTS vector;`,
+            `CREATE TABLE IF NOT EXISTS ${quoteIdent(table)} (`,
+            `  id text PRIMARY KEY,`,
+            `  type text NOT NULL,`,
+            `  text text NOT NULL,`,
+            `  schema_id text NOT NULL,`,
+            `  refs jsonb NOT NULL DEFAULT '[]'::jsonb,`,
+            `  sensitive boolean NOT NULL DEFAULT false,`,
+            `  embedding vector(${dimensions}) NOT NULL`,
+            `);`,
+            `CREATE INDEX IF NOT EXISTS ${quoteIdent(`${table}_schema_id`)} ON ${quoteIdent(table)} (schema_id);`,
+            `CREATE INDEX IF NOT EXISTS ${quoteIdent(`${table}_type`)} ON ${quoteIdent(table)} (type);`,
+            `CREATE INDEX IF NOT EXISTS ${quoteIdent(`${table}_refs`)} ON ${quoteIdent(table)} USING gin (refs);`,
+            indexClause,
+        ]
+            .filter(Boolean)
+            .join("\n");
+    };
+    const close = async () => {
+        if (internalPool) {
+            await internalPool.end();
+            internalPool = undefined;
+        }
+    };
+    const hashesByPrefix = async (prefix) => {
+        // pgvector store doesn't persist hashes itself — the indexer relies on
+        // `schema.lock.json`. Returning empty here means the indexer falls back
+        // to its file-based hash bookkeeping, which is the intended path.
+        void prefix;
+        return {};
+    };
+    return {
+        upsert,
+        query,
+        delete: del,
+        hashesByPrefix,
+        setupSql,
+        close,
+    };
+}
+function quoteIdent(name) {
+    // Conservative identifier quoting — only allow alnum + underscore.
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name)) {
+        throw new Error(`Unsafe identifier for pgvector store: ${name}`);
+    }
+    return `"${name}"`;
+}
+function formatVector(v) {
+    // pgvector text format is `[v1,v2,...]`.
+    const arr = v instanceof Float32Array ? Array.from(v) : v;
+    return `[${arr.join(",")}]`;
+}
+//# sourceMappingURL=pgvector.js.map

package/dist/stores/pgvector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pgvector.js","sourceRoot":"","sources":["../../src/stores/pgvector.ts"],"names":[],"mappings":"AA0CA,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAmC;IAEnC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,MAAM,CAAC;IAEtD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,4DAA4D,UAAU,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,IAAI,YAAsD,CAAC;IAC3D,IAAI,MAAM,GAAyB,OAAO,CAAC,MAAM,CAAC;IAElD,MAAM,SAAS,GAAG,KAAK,IAAuB,EAAE;QAC9C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;QACJ,CAAC;QACD,8EAA8E;QAC9E,MAAM,KAAK;QACT,iEAAiE;QACjE,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAiE,CAAC;QACvF,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAEzE,CAAC;QACF,YAAY,GAAG,IAAI,CAAC;QACpB,MAAM,GAAG,IAAI,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,KAAK,EAAE,OAAuB,EAAiB,EAAE;QAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACjC,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;QAC5B,+CAA+C;QAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAE3D,MAAM,GAAG,GAAG;oBACI,UAAU,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;KAgBhC,CAAC;QACF,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,KAAK,EACjB,MAAgB,EAChB,CAAS,EACT,MAAe,EACS,EAAE;QAC1B,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAc,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACjE,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,MAAM,EAAE,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,EAAE,CAAC,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,MAAM,EAAE,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,WAAW,CAAC,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,MAAM,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,UAAU,CAAC,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,MAAM,GAAG,GAAG;;;;;;;;;aASH,UAAU,CAAC,KAAK,CAAC;QACtB,QAAQ;;;KAGX,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAC7B,MAAM,CAAC,GAAG,GAQT,CAAC;YACF,MAAM,OAAO,GAAiB;gBAC5B,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,SAAS;gBACrB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;gBACzC,SAAS,EAAE,CAAC,CAAC,SAAS;aACvB,CAAC;YACF,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,GAAG,GAAG,KAAK,EAAE,GAAa,EAAiB,EAAE;QACjD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC7B,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;QAC5B,MAAM,CAAC,CAAC,KAAK,CACX,eAAe,UAAU,CAAC,KAAK,CAAC,6BAA6B,EAC7D,CAAC,GAAG,CAAC,CACN,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,GAAW,EAAE;QAC5B,MAAM,WAAW,GACf,aAAa,KAAK,MAAM;YACtB,CAAC,CAAC,8BAA8B,UAAU,CAAC,GAAG,KAAK,iBAAiB,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,4CAA4C;YACzI,CAAC,CAAC,aAAa,KAAK,SAAS;gBAC3B,CAAC,CAAC,8BAA8B,UAAU,CAAC,GAAG,KAAK,oBAAoB,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,kEAAkE;gBAClK,CAAC,CAAC,EAAE,CAAC;QACX,OAAO;YACL,wCAAwC;YACxC,8BAA8B,UAAU,CAAC,KAAK,CAAC,IAAI;YACnD,wBAAwB;YACxB,uBAAuB;YACvB,uBAAuB;YACvB,4BAA4B;YAC5B,4CAA4C;YAC5C,6CAA6C;YAC7C,sBAAsB,UAAU,YAAY;YAC5C,IAAI;YACJ,8BAA8B,UAAU,CAAC,GAAG,KAAK,YAAY,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,eAAe;YACrG,8BAA8B,UAAU,CAAC,GAAG,KAAK,OAAO,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,UAAU;YAC3F,8BAA8B,UAAU,CAAC,GAAG,KAAK,OAAO,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,oBAAoB;YACrG,WAAW;SACZ;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;QACtC,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC;YACzB,YAAY,GAAG,SAAS,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,cAAc,GAAG,KAAK,EAAE,MAAc,EAAmC,EAAE;QAC/E,uEAAuE;QACvE,wEAAwE;QACxE,kEAAkE;QAClE,KAAK,MAAM,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;IAEF,OAAO;QACL,MAAM;QACN,KAAK;QACL,MAAM,EAAE,GAAG;QACX,cAAc;QACd,QAAQ;QACR,KAAK;KACN,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,mEAAmE;IACnE,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,yCAAyC,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,IAAI,IAAI,GAAG,CAAC;AACrB,CAAC;AAED,SAAS,YAAY,CAAC,CAA0B;IAC9C,yCAAyC;IACzC,MAAM,GAAG,GAAG,CAAC,YAAY,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAC9B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Public types for @askdb/rag.
+ *
+ * The chunker, indexer, and stores all converge on these shapes; nothing else
+ * leaks across the package boundary. Embedder and VectorStore are BYO seams —
+ * consumers wire their own providers behind these interfaces.
+ */
+/** Chunk type taxonomy from `docs/contracts/schema-v2.md` (Chunking rules). */
+export type ChunkType = "table" | "column" | "cql" | "question" | "concept" | "relationship";
+/**
+ * One slice of the v2 artifact, embedded as a single vector.
+ *
+ * `text` is what gets embedded. `id` is stable across runs (re-embedding is
+ * gated on text changes via `schema.lock.json`).
+ */
+export type Chunk = {
+    id: string;
+    type: ChunkType;
+    text: string;
+    schemaId: string;
+    /** Schema-v2 ids referenced by this chunk (for cross-link filtering). */
+    refs: string[];
+    /**
+     * True when the chunk's source content references a sensitive column.
+     * Default chunker excludes such chunks; this metadata flows through anyway
+     * so opt-in mode (`includeSensitiveDescribable: true`) can carry it for telemetry.
+     */
+    sensitive: boolean;
+};
+/** Payload stored in vector stores alongside the embedding. */
+export type ChunkPayload = {
+    id: string;
+    type: ChunkType;
+    text: string;
+    schemaId: string;
+    refs: string[];
+    sensitive: boolean;
+};
+/** Filter for vector-store queries. Every field is optional. */
+export type Filter = {
+    schemaId?: string;
+    types?: ChunkType[];
+    refs?: string[];
+};
+/** Result of a vector-store similarity query. */
+export type QueryResult = {
+    id: string;
+    score: number;
+    payload: ChunkPayload;
+};
+/** Single record passed to {@link VectorStore.upsert}. */
+export type UpsertRecord = {
+    id: string;
+    vector: number[];
+    payload: ChunkPayload;
+    /** Optional content hash. Stores may persist it for `hashesByPrefix` reuse. */
+    hash?: string;
+};
+/**
+ * BYO embedder seam.
+ *
+ * Implementations batch as they like; callers pass whatever they want
+ * embedded together. No model-specific concerns leak across this seam.
+ */
+export type Embedder = (texts: string[]) => Promise<number[][]>;
+/**
+ * BYO vector-store seam.
+ *
+ * Adapters: in-memory (default), file-backed, pgvector. Adding more is a
+ * pure adapter concern — nothing else in the package needs to know.
+ */
+export type VectorStore = {
+    upsert(records: UpsertRecord[]): Promise<void>;
+    query(vector: number[], k: number, filter?: Filter): Promise<QueryResult[]>;
+    delete(ids: string[]): Promise<void>;
+    /**
+     * Optional fast path used by the indexer to skip re-embedding unchanged
+     * chunks. Returns `chunkId → contentHash` for ids whose stored hash starts
+     * with `prefix`. Implementations without persistent hash storage can omit it.
+     */
+    hashesByPrefix?(prefix: string): Promise<Record<string, string>>;
+};
+/** Retriever shape consumed by `@askdb/core` `ask({ retriever })`. */
+export type Retriever = (params: {
+    question: string;
+    k?: number;
+    filter?: Filter;
+}) => Promise<QueryResult[]>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,QAAQ,GACR,KAAK,GACL,UAAU,GACV,SAAS,GACT,cAAc,CAAC;AAEnB;;;;;GAKG;AACH,MAAM,MAAM,KAAK,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,gEAAgE;AAChE,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,YAAY,CAAC;IACtB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5E,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC;;;;OAIG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAClE,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Public types for @askdb/rag.
+ *
+ * The chunker, indexer, and stores all converge on these shapes; nothing else
+ * leaks across the package boundary. Embedder and VectorStore are BYO seams —
+ * consumers wire their own providers behind these interfaces.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@askdb/rag",
+  "version": "0.2.0-beta.1",
+  "description": "AskDB RAG layer: deterministic chunker over Schema v2, BYO embedder + vector store (in-memory, file-backed, pgvector), and an optional retriever wired into @askdb/core ask().",
+  "keywords": [
+    "askdb",
+    "rag",
+    "retrieval",
+    "embeddings",
+    "schema-v2",
+    "pgvector",
+    "ai"
+  ],
+  "homepage": "https://github.com/Ygilany/AskDB#readme",
+  "bugs": {
+    "url": "https://github.com/Ygilany/AskDB/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ygilany/AskDB.git",
+    "directory": "packages/rag"
+  },
+  "license": "Apache-2.0",
+  "author": "Yahya Gilany",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./stores/memory": {
+      "types": "./dist/stores/memory.d.ts",
+      "import": "./dist/stores/memory.js"
+    },
+    "./stores/file": {
+      "types": "./dist/stores/file.d.ts",
+      "import": "./dist/stores/file.js"
+    },
+    "./stores/pgvector": {
+      "types": "./dist/stores/pgvector.d.ts",
+      "import": "./dist/stores/pgvector.js"
+    },
+    "./embedders/openai": {
+      "types": "./dist/embedders/openai.d.ts",
+      "import": "./dist/embedders/openai.js"
+    },
+    "./embedders/ai-sdk": {
+      "types": "./dist/embedders/ai-sdk.d.ts",
+      "import": "./dist/embedders/ai-sdk.js"
+    }
+  },
+  "bin": {
+    "askdb-rag": "./bin/askdb-rag.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@askdb/core": "0.5.0-beta.0",
+    "@askdb/config": "0.3.0-beta.1"
+  },
+  "peerDependencies": {
+    "@ai-sdk/openai": ">=1",
+    "ai": ">=4",
+    "pg": ">=8"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/openai": {
+      "optional": true
+    },
+    "ai": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@ai-sdk/openai": "^1.3.21",
+    "@types/pg": "^8.11.12",
+    "ai": "^4.3.19",
+    "pg": "^8.14.1",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.9"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "lint": "tsc -p tsconfig.build.json --noEmit",
+    "test": "vitest run --config ../../vitest.config.ts"
+  }
+}