@framers/agentos 0.1.120 → 0.1.122

package/dist/rag/migration/adapters/QdrantSourceAdapter.js

@@ -0,0 +1,109 @@
+/**
+ * @fileoverview Qdrant source adapter for the migration engine.
+ * @module rag/migration/adapters/QdrantSourceAdapter
+ *
+ * Reads vectors from Qdrant collections using the scroll API.
+ * Non-vector data (knowledge graph, documents, etc.) is read from
+ * the sidecar SQLite file that accompanies Qdrant deployments.
+ */
+/** Tables stored as Qdrant collections (vector data). */
+const QDRANT_COLLECTIONS = ['memory_traces', 'document_chunks'];
+/** Tables stored in the sidecar SQLite file (non-vector data). */
+const SIDECAR_TABLES = [
+    'brain_meta', 'knowledge_nodes', 'knowledge_edges',
+    'documents', 'document_images', 'consolidation_log',
+    'retrieval_feedback', 'conversations', 'messages',
+];
+export class QdrantSourceAdapter {
+    /**
+     * @param url    - Qdrant base URL (e.g. 'http://localhost:6333').
+     * @param apiKey - Optional API key for cloud instances.
+     */
+    constructor(url, apiKey) {
+        this.url = url;
+        this.apiKey = apiKey;
+        this.sidecarDb = null; // better-sqlite3 Database for non-vector tables
+    }
+    /** Build fetch headers with optional API key. */
+    _headers() {
+        const h = { 'Content-Type': 'application/json' };
+        if (this.apiKey)
+            h['api-key'] = this.apiKey;
+        return h;
+    }
+    /**
+     * List available tables/collections.
+     * Combines Qdrant collections and sidecar SQLite tables.
+     */
+    async listTables() {
+        const tables = [];
+        // Check which Qdrant collections exist.
+        try {
+            const res = await fetch(`${this.url}/collections`, { headers: this._headers() });
+            if (res.ok) {
+                const data = await res.json();
+                const names = new Set(data.result.collections.map(c => c.name));
+                for (const t of QDRANT_COLLECTIONS) {
+                    if (names.has(t))
+                        tables.push(t);
+                }
+            }
+        }
+        catch {
+            // Qdrant not reachable — skip vector tables.
+        }
+        // Check sidecar SQLite tables.
+        // Sidecar path convention: same directory as Qdrant data, file 'sidecar.sqlite'.
+        // For source adapter, this is typically not needed (data comes from the API).
+        // We include sidecar tables only if the sidecar DB path is available via env.
+        // TODO: Accept sidecar path in constructor for full migration support.
+        return tables;
+    }
+    /** Count points in a Qdrant collection. */
+    async countRows(table) {
+        if (QDRANT_COLLECTIONS.includes(table)) {
+            const res = await fetch(`${this.url}/collections/${table}`, { headers: this._headers() });
+            if (res.ok) {
+                const data = await res.json();
+                return data.result.points_count;
+            }
+        }
+        return 0;
+    }
+    /**
+     * Read a batch of points from a Qdrant collection using the scroll API.
+     * Converts Qdrant point format to flat row objects.
+     */
+    async readBatch(table, offset, limit) {
+        if (!QDRANT_COLLECTIONS.includes(table))
+            return [];
+        const body = JSON.stringify({
+            limit,
+            offset,
+            with_payload: true,
+            with_vector: true,
+        });
+        const res = await fetch(`${this.url}/collections/${table}/points/scroll`, {
+            method: 'POST',
+            headers: this._headers(),
+            body,
+        });
+        if (!res.ok)
+            return [];
+        const data = await res.json();
+        // Flatten Qdrant point structure into row objects.
+        return data.result.points.map(pt => ({
+            id: String(pt.id),
+            embedding: pt.vector,
+            ...pt.payload,
+        }));
+    }
+    /** Close connections. */
+    async close() {
+        if (this.sidecarDb) {
+            this.sidecarDb.close();
+            this.sidecarDb = null;
+        }
+    }
+}
+//# sourceMappingURL=QdrantSourceAdapter.js.map

package/dist/rag/migration/adapters/QdrantSourceAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QdrantSourceAdapter.js","sourceRoot":"","sources":["../../../../src/rag/migration/adapters/QdrantSourceAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,yDAAyD;AACzD,MAAM,kBAAkB,GAAG,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;AAEhE,kEAAkE;AAClE,MAAM,cAAc,GAAG;IACrB,YAAY,EAAE,iBAAiB,EAAE,iBAAiB;IAClD,WAAW,EAAE,iBAAiB,EAAE,mBAAmB;IACnD,oBAAoB,EAAE,eAAe,EAAE,UAAU;CAClD,CAAC;AAEF,MAAM,OAAO,mBAAmB;IAG9B;;;OAGG;IACH,YACmB,GAAW,EACX,MAAe;QADf,QAAG,GAAH,GAAG,CAAQ;QACX,WAAM,GAAN,MAAM,CAAS;QAR1B,cAAS,GAAQ,IAAI,CAAC,CAAC,gDAAgD;IAS5E,CAAC;IAEJ,iDAAiD;IACzC,QAAQ;QACd,MAAM,CAAC,GAA2B,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;QACzE,IAAI,IAAI,CAAC,MAAM;YAAE,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5C,OAAO,CAAC,CAAC;IACX,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,wCAAwC;QACxC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,cAAc,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACjF,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;gBACX,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAqD,CAAC;gBACjF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBAChE,KAAK,MAAM,CAAC,IAAI,kBAAkB,EAAE,CAAC;oBACnC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;wBAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;QAED,+BAA+B;QAC/B,iFAAiF;QACjF,8EAA8E;QAC9E,8EAA8E;QAC9E,uEAAuE;QAEvE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,IAAI,kBAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,gBAAgB,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC1F,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;gBACX,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAA0C,CAAC;gBACtE,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;YAClC,CAAC;QACH,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,MAAc,EAAE,KAAa;QAC1D,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEnD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,KAAK;YACL,MAAM;YACN,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,gBAAgB,KAAK,gBAAgB,EAAE;YACxE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE;YACxB,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,CAAC;QAEvB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAE1B,CAAC;QAEF,mDAAmD;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACnC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YACjB,SAAS,EAAE,EAAE,CAAC,MAAM;YACpB,GAAG,EAAE,CAAC,OAAO;SACd,CAAC,CAAC,CAAC;IACN,CAAC;IAED,yBAAyB;IACzB,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/rag/migration/adapters/QdrantTargetAdapter.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Qdrant target adapter for the migration engine.
+ * @module rag/migration/adapters/QdrantTargetAdapter
+ *
+ * Writes vector data to Qdrant collections and non-vector data
+ * to a sidecar SQLite file. Creates collections with appropriate
+ * vector configuration on first write.
+ */
+import type { IMigrationTarget } from '../types.js';
+export declare class QdrantTargetAdapter implements IMigrationTarget {
+    private readonly url;
+    private readonly apiKey?;
+    private createdCollections;
+    private sidecarDb;
+    /**
+     * @param url    - Qdrant base URL.
+     * @param apiKey - Optional API key for cloud instances.
+     */
+    constructor(url: string, apiKey?: string | undefined);
+    /** Build fetch headers. */
+    private _headers;
+    /**
+     * Ensure a Qdrant collection exists with the correct vector configuration.
+     * For non-vector tables, ensures the sidecar SQLite file has the table.
+     */
+    ensureTable(table: string, sampleRow: Record<string, unknown>): Promise<void>;
+    /**
+     * Write a batch of rows as Qdrant points.
+     * Extracts `id` and `embedding` fields; everything else becomes payload.
+     */
+    writeBatch(table: string, rows: Record<string, unknown>[]): Promise<number>;
+    /** Close connections. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=QdrantTargetAdapter.d.ts.map

package/dist/rag/migration/adapters/QdrantTargetAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QdrantTargetAdapter.d.ts","sourceRoot":"","sources":["../../../../src/rag/migration/adapters/QdrantTargetAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKpD,qBAAa,mBAAoB,YAAW,gBAAgB;IASxD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAT1B,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,SAAS,CAAa;IAE9B;;;OAGG;gBAEgB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,YAAA;IAGlC,2BAA2B;IAC3B,OAAO,CAAC,QAAQ;IAMhB;;;OAGG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCnF;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAwCjF,yBAAyB;IACnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B"}

package/dist/rag/migration/adapters/QdrantTargetAdapter.js

@@ -0,0 +1,110 @@
+/**
+ * @fileoverview Qdrant target adapter for the migration engine.
+ * @module rag/migration/adapters/QdrantTargetAdapter
+ *
+ * Writes vector data to Qdrant collections and non-vector data
+ * to a sidecar SQLite file. Creates collections with appropriate
+ * vector configuration on first write.
+ */
+/** Tables that go into Qdrant as point collections. */
+const QDRANT_COLLECTIONS = new Set(['memory_traces', 'document_chunks']);
+export class QdrantTargetAdapter {
+    /**
+     * @param url    - Qdrant base URL.
+     * @param apiKey - Optional API key for cloud instances.
+     */
+    constructor(url, apiKey) {
+        this.url = url;
+        this.apiKey = apiKey;
+        this.createdCollections = new Set();
+        this.sidecarDb = null; // For non-vector tables
+    }
+    /** Build fetch headers. */
+    _headers() {
+        const h = { 'Content-Type': 'application/json' };
+        if (this.apiKey)
+            h['api-key'] = this.apiKey;
+        return h;
+    }
+    /**
+     * Ensure a Qdrant collection exists with the correct vector configuration.
+     * For non-vector tables, ensures the sidecar SQLite file has the table.
+     */
+    async ensureTable(table, sampleRow) {
+        if (this.createdCollections.has(table))
+            return;
+        if (QDRANT_COLLECTIONS.has(table)) {
+            // Determine vector dimensions from sample row.
+            const embedding = sampleRow['embedding'];
+            const dim = Array.isArray(embedding)
+                ? embedding.length
+                : (embedding instanceof Buffer ? embedding.byteLength / 4 : 1536);
+            // Check if collection already exists.
+            const checkRes = await fetch(`${this.url}/collections/${table}`, {
+                headers: this._headers(),
+            });
+            if (!checkRes.ok) {
+                // Create the collection with cosine distance.
+                await fetch(`${this.url}/collections/${table}`, {
+                    method: 'PUT',
+                    headers: this._headers(),
+                    body: JSON.stringify({
+                        vectors: { size: dim, distance: 'Cosine' },
+                    }),
+                });
+            }
+            this.createdCollections.add(table);
+        }
+        // Non-vector tables would go to sidecar SQLite — not implemented here.
+        // TODO: Wire sidecar SQLite for graph/document metadata tables.
+    }
+    /**
+     * Write a batch of rows as Qdrant points.
+     * Extracts `id` and `embedding` fields; everything else becomes payload.
+     */
+    async writeBatch(table, rows) {
+        if (rows.length === 0)
+            return 0;
+        if (QDRANT_COLLECTIONS.has(table)) {
+            // Convert rows to Qdrant point format.
+            const points = rows.map(row => {
+                const { id, embedding, ...payload } = row;
+                // Convert Buffer embedding to number[] if needed.
+                let vector;
+                if (embedding instanceof Buffer) {
+                    const f32 = new Float32Array(embedding.buffer, embedding.byteOffset, embedding.byteLength / 4);
+                    vector = Array.from(f32);
+                }
+                else if (Array.isArray(embedding)) {
+                    vector = embedding;
+                }
+                else {
+                    vector = []; // Fallback — shouldn't happen.
+                }
+                return {
+                    id: String(id),
+                    vector,
+                    payload,
+                };
+            });
+            // Upsert points in a single batch request.
+            const res = await fetch(`${this.url}/collections/${table}/points`, {
+                method: 'PUT',
+                headers: this._headers(),
+                body: JSON.stringify({ points }),
+            });
+            return res.ok ? points.length : 0;
+        }
+        // Non-vector tables: would write to sidecar SQLite.
+        // TODO: Implement sidecar write for graph/metadata tables.
+        return 0;
+    }
+    /** Close connections. */
+    async close() {
+        if (this.sidecarDb) {
+            this.sidecarDb.close();
+            this.sidecarDb = null;
+        }
+    }
+}
+//# sourceMappingURL=QdrantTargetAdapter.js.map

package/dist/rag/migration/adapters/QdrantTargetAdapter.js.map

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

package/dist/rag/migration/adapters/SqliteSourceAdapter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview SQLite source adapter for the migration engine.
+ * @module rag/migration/adapters/SqliteSourceAdapter
+ *
+ * Reads data from a brain.sqlite file in streaming batches using
+ * better-sqlite3's synchronous API (fastest for local reads).
+ */
+import type { IMigrationSource } from '../types.js';
+export declare class SqliteSourceAdapter implements IMigrationSource {
+    private db;
+    /**
+     * @param path - Path to the source brain.sqlite file. Opened read-only.
+     */
+    constructor(path: string);
+    /**
+     * List tables that exist in the source database AND are part of
+     * the AgentOS memory schema. Unknown tables are skipped.
+     */
+    listTables(): Promise<string[]>;
+    /**
+     * Count rows in a table.
+     * @param table - Table name.
+     */
+    countRows(table: string): Promise<number>;
+    /**
+     * Read a batch of rows from a table using LIMIT/OFFSET pagination.
+     *
+     * @param table  - Table name.
+     * @param offset - Number of rows to skip.
+     * @param limit  - Maximum rows to return.
+     * @returns Array of row objects with column name → value mappings.
+     */
+    readBatch(table: string, offset: number, limit: number): Promise<Record<string, unknown>[]>;
+    /** Close the read-only database connection. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=SqliteSourceAdapter.d.ts.map

package/dist/rag/migration/adapters/SqliteSourceAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteSourceAdapter.d.ts","sourceRoot":"","sources":["../../../../src/rag/migration/adapters/SqliteSourceAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAqBpD,qBAAa,mBAAoB,YAAW,gBAAgB;IAC1D,OAAO,CAAC,EAAE,CAAoB;IAE9B;;OAEG;gBACS,IAAI,EAAE,MAAM;IAIxB;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IASrC;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/C;;;;;;;OAOG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAMjG,+CAA+C;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/rag/migration/adapters/SqliteSourceAdapter.js

@@ -0,0 +1,72 @@
+/**
+ * @fileoverview SQLite source adapter for the migration engine.
+ * @module rag/migration/adapters/SqliteSourceAdapter
+ *
+ * Reads data from a brain.sqlite file in streaming batches using
+ * better-sqlite3's synchronous API (fastest for local reads).
+ */
+import Database from 'better-sqlite3';
+/**
+ * Tables that are part of the AgentOS memory schema and should
+ * be included in migrations. Order matters — foreign key dependencies
+ * require parent tables to be migrated before children.
+ */
+const MIGRATION_TABLES = [
+    'brain_meta',
+    'memory_traces',
+    'knowledge_nodes',
+    'knowledge_edges',
+    'documents',
+    'document_chunks',
+    'document_images',
+    'consolidation_log',
+    'retrieval_feedback',
+    'conversations',
+    'messages',
+];
+export class SqliteSourceAdapter {
+    /**
+     * @param path - Path to the source brain.sqlite file. Opened read-only.
+     */
+    constructor(path) {
+        this.db = new Database(path, { readonly: true });
+    }
+    /**
+     * List tables that exist in the source database AND are part of
+     * the AgentOS memory schema. Unknown tables are skipped.
+     */
+    async listTables() {
+        const rows = this.db
+            .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'")
+            .all();
+        const existing = new Set(rows.map(r => r.name));
+        // Return only known tables that actually exist, in dependency order.
+        return MIGRATION_TABLES.filter(t => existing.has(t));
+    }
+    /**
+     * Count rows in a table.
+     * @param table - Table name.
+     */
+    async countRows(table) {
+        const row = this.db.prepare(`SELECT COUNT(*) as c FROM "${table}"`).get();
+        return row.c;
+    }
+    /**
+     * Read a batch of rows from a table using LIMIT/OFFSET pagination.
+     *
+     * @param table  - Table name.
+     * @param offset - Number of rows to skip.
+     * @param limit  - Maximum rows to return.
+     * @returns Array of row objects with column name → value mappings.
+     */
+    async readBatch(table, offset, limit) {
+        return this.db
+            .prepare(`SELECT * FROM "${table}" LIMIT ? OFFSET ?`)
+            .all(limit, offset);
+    }
+    /** Close the read-only database connection. */
+    async close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=SqliteSourceAdapter.js.map

package/dist/rag/migration/adapters/SqliteSourceAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteSourceAdapter.js","sourceRoot":"","sources":["../../../../src/rag/migration/adapters/SqliteSourceAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC;;;;GAIG;AACH,MAAM,gBAAgB,GAAG;IACvB,YAAY;IACZ,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,WAAW;IACX,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,oBAAoB;IACpB,eAAe;IACf,UAAU;CACX,CAAC;AAEF,MAAM,OAAO,mBAAmB;IAG9B;;OAEG;IACH,YAAY,IAAY;QACtB,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,gFAAgF,CAAC;aACzF,GAAG,EAAwB,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,qEAAqE;QACrE,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,8BAA8B,KAAK,GAAG,CAAC,CAAC,GAAG,EAAmB,CAAC;QAC3F,OAAO,GAAG,CAAC,CAAC,CAAC;IACf,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,MAAc,EAAE,KAAa;QAC1D,OAAO,IAAI,CAAC,EAAE;aACX,OAAO,CAAC,kBAAkB,KAAK,oBAAoB,CAAC;aACpD,GAAG,CAAC,KAAK,EAAE,MAAM,CAA8B,CAAC;IACrD,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/rag/migration/adapters/SqliteTargetAdapter.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview SQLite target adapter for the migration engine.
+ * @module rag/migration/adapters/SqliteTargetAdapter
+ *
+ * Writes migration data to a new or existing brain.sqlite file.
+ * Uses WAL mode for concurrent read safety and wraps each batch
+ * in a transaction for atomicity and performance.
+ */
+import type { IMigrationTarget } from '../types.js';
+export declare class SqliteTargetAdapter implements IMigrationTarget {
+    private db;
+    /** Track which tables we've already created to avoid redundant DDL. */
+    private createdTables;
+    /**
+     * @param path - Path to the target brain.sqlite file. Created if it doesn't exist.
+     */
+    constructor(path: string);
+    /**
+     * Ensure the target table exists. Infers column types from a sample row:
+     * - Buffer → BLOB
+     * - number (integer) → INTEGER
+     * - number (float) → REAL
+     * - everything else → TEXT
+     *
+     * Uses CREATE TABLE IF NOT EXISTS so it's safe to call multiple times.
+     *
+     * @param table     - Table name to create.
+     * @param sampleRow - A sample row to derive column types from.
+     */
+    ensureTable(table: string, sampleRow: Record<string, unknown>): Promise<void>;
+    /**
+     * Write a batch of rows to the target table.
+     * Uses INSERT OR REPLACE to handle duplicates (requires a PRIMARY KEY
+     * or UNIQUE constraint — if none exists, rows are simply inserted).
+     *
+     * Wraps the entire batch in a single transaction for atomicity and
+     * dramatically better write performance (avoids per-row fsync).
+     *
+     * @param table - Table name to write to.
+     * @param rows  - Array of row objects.
+     * @returns Number of rows written.
+     */
+    writeBatch(table: string, rows: Record<string, unknown>[]): Promise<number>;
+    /** Close the database connection. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=SqliteTargetAdapter.d.ts.map

package/dist/rag/migration/adapters/SqliteTargetAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteTargetAdapter.d.ts","sourceRoot":"","sources":["../../../../src/rag/migration/adapters/SqliteTargetAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,qBAAa,mBAAoB,YAAW,gBAAgB;IAC1D,OAAO,CAAC,EAAE,CAAoB;IAC9B,uEAAuE;IACvE,OAAO,CAAC,aAAa,CAAqB;IAE1C;;OAEG;gBACS,IAAI,EAAE,MAAM;IAMxB;;;;;;;;;;;OAWG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBnF;;;;;;;;;;;OAWG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BjF,qCAAqC;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/rag/migration/adapters/SqliteTargetAdapter.js

@@ -0,0 +1,93 @@
+/**
+ * @fileoverview SQLite target adapter for the migration engine.
+ * @module rag/migration/adapters/SqliteTargetAdapter
+ *
+ * Writes migration data to a new or existing brain.sqlite file.
+ * Uses WAL mode for concurrent read safety and wraps each batch
+ * in a transaction for atomicity and performance.
+ */
+import Database from 'better-sqlite3';
+export class SqliteTargetAdapter {
+    /**
+     * @param path - Path to the target brain.sqlite file. Created if it doesn't exist.
+     */
+    constructor(path) {
+        /** Track which tables we've already created to avoid redundant DDL. */
+        this.createdTables = new Set();
+        this.db = new Database(path);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+    }
+    /**
+     * Ensure the target table exists. Infers column types from a sample row:
+     * - Buffer → BLOB
+     * - number (integer) → INTEGER
+     * - number (float) → REAL
+     * - everything else → TEXT
+     *
+     * Uses CREATE TABLE IF NOT EXISTS so it's safe to call multiple times.
+     *
+     * @param table     - Table name to create.
+     * @param sampleRow - A sample row to derive column types from.
+     */
+    async ensureTable(table, sampleRow) {
+        if (this.createdTables.has(table))
+            return;
+        const columns = Object.keys(sampleRow);
+        const colDefs = columns.map(col => {
+            const val = sampleRow[col];
+            // Infer SQLite column type from the sample value.
+            if (val instanceof Buffer || val instanceof Uint8Array)
+                return `"${col}" BLOB`;
+            if (typeof val === 'number')
+                return `"${col}" ${Number.isInteger(val) ? 'INTEGER' : 'REAL'}`;
+            if (typeof val === 'boolean')
+                return `"${col}" INTEGER`; // SQLite stores booleans as 0/1
+            return `"${col}" TEXT`;
+        }).join(', ');
+        this.db.exec(`CREATE TABLE IF NOT EXISTS "${table}" (${colDefs})`);
+        this.createdTables.add(table);
+    }
+    /**
+     * Write a batch of rows to the target table.
+     * Uses INSERT OR REPLACE to handle duplicates (requires a PRIMARY KEY
+     * or UNIQUE constraint — if none exists, rows are simply inserted).
+     *
+     * Wraps the entire batch in a single transaction for atomicity and
+     * dramatically better write performance (avoids per-row fsync).
+     *
+     * @param table - Table name to write to.
+     * @param rows  - Array of row objects.
+     * @returns Number of rows written.
+     */
+    async writeBatch(table, rows) {
+        if (rows.length === 0)
+            return 0;
+        const columns = Object.keys(rows[0]);
+        const quotedCols = columns.map(c => `"${c}"`).join(', ');
+        const placeholders = columns.map(() => '?').join(', ');
+        const stmt = this.db.prepare(`INSERT OR REPLACE INTO "${table}" (${quotedCols}) VALUES (${placeholders})`);
+        // Transaction wrapper: single fsync for the entire batch.
+        const tx = this.db.transaction((batch) => {
+            let count = 0;
+            for (const row of batch) {
+                const values = columns.map(c => {
+                    const v = row[c];
+                    // Convert booleans to integers for SQLite compatibility.
+                    if (typeof v === 'boolean')
+                        return v ? 1 : 0;
+                    return v;
+                });
+                stmt.run(...values);
+                count++;
+            }
+            return count;
+        });
+        return tx(rows);
+    }
+    /** Close the database connection. */
+    async close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=SqliteTargetAdapter.js.map

package/dist/rag/migration/adapters/SqliteTargetAdapter.js.map

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

package/dist/rag/migration/types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @fileoverview Types for the universal vector store migration engine.
+ * @module rag/migration/types
+ *
+ * Defines the interfaces for streaming data between any pair of
+ * vector store backends (SQLite, Postgres, Qdrant). The migration
+ * engine reads batches from an IMigrationSource and writes them
+ * to an IMigrationTarget, never loading the entire dataset into memory.
+ */
+/** Supported backend types for migration. */
+export type BackendType = 'sqlite' | 'postgres' | 'qdrant' | 'pinecone';
+/**
+ * Configuration for a migration source or target backend.
+ * Only the fields relevant to the chosen `type` need to be provided.
+ */
+export interface BackendConfig {
+    /** Which backend type to connect to. */
+    type: BackendType;
+    /** SQLite file path. Required when type='sqlite'. */
+    path?: string;
+    /** Postgres connection string. Required when type='postgres'. */
+    connectionString?: string;
+    /** Qdrant base URL (e.g. 'http://localhost:6333'). Required when type='qdrant'. */
+    url?: string;
+    /** Qdrant API key for cloud instances. Optional. */
+    apiKey?: string;
+    /** Qdrant collection name prefix. @default 'wunderland' */
+    collectionPrefix?: string;
+}
+/**
+ * Options for a migration operation.
+ */
+export interface MigrationOptions {
+    /** Source backend configuration. */
+    from: BackendConfig;
+    /** Target backend configuration. */
+    to: BackendConfig;
+    /** Rows per batch for streaming reads/writes. @default 1000 */
+    batchSize?: number;
+    /**
+     * Progress callback fired after each batch write.
+     * @param done  - Number of rows written so far for the current table.
+     * @param total - Total row count for the current table.
+     * @param table - Name of the table currently being migrated.
+     */
+    onProgress?: (done: number, total: number, table: string) => void;
+    /** If true, counts rows but does not write to target. @default false */
+    dryRun?: boolean;
+}
+/**
+ * Result returned after a migration completes.
+ */
+export interface MigrationResult {
+    /** Names of tables that were processed. */
+    tablesProcessed: string[];
+    /** Total rows migrated across all tables. */
+    totalRows: number;
+    /** Wall-clock duration in milliseconds. */
+    durationMs: number;
+    /** True if post-migration verification passed. */
+    verified: boolean;
+    /** Any errors encountered (non-fatal errors are collected, not thrown). */
+    errors: string[];
+}
+/**
+ * Adapter for reading data from a migration source backend.
+ * Implementations exist for SQLite, Postgres, and Qdrant.
+ */
+export interface IMigrationSource {
+    /** List table/collection names available for migration. */
+    listTables(): Promise<string[]>;
+    /** Count rows/points in a table. */
+    countRows(table: string): Promise<number>;
+    /**
+     * Read a batch of rows starting at offset.
+     * @param table  - Table name to read from.
+     * @param offset - Number of rows to skip.
+     * @param limit  - Maximum rows to return.
+     * @returns Array of row objects with column values.
+     */
+    readBatch(table: string, offset: number, limit: number): Promise<Record<string, unknown>[]>;
+    /** Close the connection and release resources. */
+    close(): Promise<void>;
+}
+/**
+ * Adapter for writing data to a migration target backend.
+ * Implementations exist for SQLite, Postgres, and Qdrant.
+ */
+export interface IMigrationTarget {
+    /**
+     * Ensure the target schema/collection exists for a table.
+     * Creates it if it doesn't exist, using a sample row to infer column types.
+     * @param table     - Table name to create.
+     * @param sampleRow - A sample row to derive schema from.
+     */
+    ensureTable(table: string, sampleRow: Record<string, unknown>): Promise<void>;
+    /**
+     * Write a batch of rows to the target.
+     * Uses INSERT OR REPLACE / upsert semantics to handle duplicates.
+     * @param table - Table name to write to.
+     * @param rows  - Array of row objects.
+     * @returns Number of rows successfully written.
+     */
+    writeBatch(table: string, rows: Record<string, unknown>[]): Promise<number>;
+    /** Close the connection and release resources. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/rag/migration/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/rag/migration/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAMxE;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,IAAI,EAAE,WAAW,CAAC;IAClB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mFAAmF;IACnF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,IAAI,EAAE,aAAa,CAAC;IACpB,oCAAoC;IACpC,EAAE,EAAE,aAAa,CAAC;IAClB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClE,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChC,oCAAoC;IACpC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C;;;;;;OAMG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5F,kDAAkD;IAClD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E;;;;;;OAMG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,kDAAkD;IAClD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}