lmgrep 0.1.18 → 0.2.1

package/dist/infrastructure/lancedb/LanceTables.js.map

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

package/dist/{lib/native-tuning.js → infrastructure/lancedb/NativeTuning.js}

@@ -6,4 +6,4 @@ process.env.UV_THREADPOOL_SIZE ??= "4";
 process.env.RAYON_NUM_THREADS ??= "4";
 process.env.MATMUL_NUM_THREADS ??= "4";
 export {};
-//# sourceMappingURL=native-tuning.js.map
+//# sourceMappingURL=NativeTuning.js.map

package/dist/infrastructure/lancedb/NativeTuning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeTuning.js","sourceRoot":"","sources":["../../../src/infrastructure/lancedb/NativeTuning.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wEAAwE;AACxE,wDAAwD;AACxD,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,GAAG,CAAC;AACzC,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,GAAG,CAAC;AACvC,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,GAAG,CAAC;AACtC,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,GAAG,CAAC"}

package/dist/infrastructure/lancedb/RowReplication.d.ts

@@ -0,0 +1,27 @@
+import type { Branch } from "../../domain/project/Branch.js";
+import { type LanceTables } from "./LanceTables.js";
+/** A manifest row as it travels between peers. */
+export interface ManifestRow {
+    filePath: string;
+    fileHash: string;
+    branch: string;
+}
+/**
+ * Row-level access to the tables, for replication between databases.
+ *
+ * Peer sharing copies rows verbatim — embeddings included, since avoiding
+ * re-embedding is the entire point — so it works below the domain model rather
+ * than through it. Keeping that access behind this one class means the rest of
+ * the system never sees raw rows.
+ */
+export declare class RowReplication {
+    private readonly tables;
+    private readonly branch;
+    constructor(tables: LanceTables, branch: Branch);
+    chunkCount(): Promise<number>;
+    /** Stream chunk rows in pages, so a large index never loads at once. */
+    streamChunkRows(batchSize: number): AsyncGenerator<Record<string, unknown>[]>;
+    allManifestRows(): Promise<ManifestRow[]>;
+    addChunkRows(rows: Record<string, unknown>[]): Promise<void>;
+    addManifestRows(rows: ManifestRow[]): Promise<void>;
+}

package/dist/infrastructure/lancedb/RowReplication.js

@@ -0,0 +1,82 @@
+import { TableName } from "./LanceTables.js";
+/**
+ * Row-level access to the tables, for replication between databases.
+ *
+ * Peer sharing copies rows verbatim — embeddings included, since avoiding
+ * re-embedding is the entire point — so it works below the domain model rather
+ * than through it. Keeping that access behind this one class means the rest of
+ * the system never sees raw rows.
+ */
+export class RowReplication {
+    tables;
+    branch;
+    constructor(tables, branch) {
+        this.tables = tables;
+        this.branch = branch;
+    }
+    async chunkCount() {
+        const table = await this.tables.table(TableName.Chunks);
+        return table ? table.countRows() : 0;
+    }
+    /** Stream chunk rows in pages, so a large index never loads at once. */
+    async *streamChunkRows(batchSize) {
+        const table = await this.tables.table(TableName.Chunks);
+        if (!table)
+            return;
+        const total = await table.countRows();
+        for (let offset = 0; offset < total; offset += batchSize) {
+            const rows = await table
+                .query()
+                .limit(batchSize)
+                .offset(offset)
+                .toArray();
+            if (rows.length === 0)
+                break;
+            yield rows.map((r) => ({
+                id: r.id,
+                filePath: r.filePath,
+                startLine: r.startLine,
+                endLine: r.endLine,
+                type: r.type,
+                name: r.name,
+                content: r.content,
+                context: r.context,
+                hash: r.hash,
+                fileHash: r.fileHash ?? "",
+                // Arrow typed arrays do not survive JSON; send plain numbers.
+                vector: Array.from(r.vector),
+            }));
+        }
+    }
+    async allManifestRows() {
+        const table = await this.tables.table(TableName.Files);
+        if (!table)
+            return [];
+        const rows = await table.query().toArray();
+        return rows.map((r) => ({
+            filePath: r.filePath,
+            fileHash: r.fileHash,
+            branch: r.branch ?? this.branch.toString(),
+        }));
+    }
+    async addChunkRows(rows) {
+        if (rows.length === 0)
+            return;
+        const { table, seeded } = await this.tables.tableOrCreate(TableName.Chunks, rows);
+        if (!seeded)
+            await table.add(rows);
+    }
+    async addManifestRows(rows) {
+        if (rows.length === 0)
+            return;
+        const records = rows.map((r) => ({
+            filePath: r.filePath,
+            fileHash: r.fileHash,
+            branch: r.branch ?? this.branch.toString(),
+        }));
+        const { table, seeded } = await this.tables.tableOrCreate(TableName.Files, records);
+        if (!seeded)
+            await table.add(records);
+    }
+}
+//# sourceMappingURL=RowReplication.js.map

package/dist/infrastructure/lancedb/RowReplication.js.map

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

package/dist/infrastructure/lancedb/VectorIndexPolicy.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Tuning for the LanceDB vector index. The numbers here were measured on a
+ * 43k-chunk / 3584-dimension index; the comments record what they bought so a
+ * later change can tell a tuned value from an arbitrary one.
+ */
+export declare const VectorIndexPolicy: {
+    /**
+     * Below this row count a brute-force scan is cheap enough that training an
+     * index costs more than it saves, and IVF-PQ has too few vectors to cluster
+     * well.
+     */
+    readonly MIN_ROWS_FOR_ANN: 5000;
+    /**
+     * Re-absorb new rows into the index once the unindexed tail passes this
+     * share of the indexed body. Rows outside the index are searched by flat
+     * scan, so the tail is exactly what needs bounding.
+     */
+    readonly UNINDEXED_REINDEX_RATIO: 0.2;
+    /** ...but always tolerate a small tail, so a 3-chunk edit never retrains. */
+    readonly UNINDEXED_REINDEX_FLOOR: 2000;
+    /**
+     * Vector searches run without an explicit distance type, which LanceDB
+     * resolves to L2. The index has its own default, so it is pinned: an index
+     * built on a different metric would silently reorder every result.
+     */
+    readonly DISTANCE_TYPE: "l2";
+    /**
+     * IVF-PQ stores compressed vectors, so its raw distances approximate the
+     * real ones. `refineFactor` makes LanceDB pull the uncompressed vectors for
+     * the top `limit * factor` candidates and re-score them exactly.
+     *
+     * It is not optional. Measured mean recall@20 against an exact scan:
+     *
+     *   off -> 53%   1 -> 75%   3 -> 86%   10 -> 91%   20 -> 94%   50 -> 94%
+     *
+     * and without it `_distance` is wrong by ~0.07, which matters because score
+     * is derived from it and users filter on `--min-score`. With refinement the
+     * scores match an exact scan to the digit.
+     *
+     * 20 sits at the knee: ~94% recall at ~11ms/query versus ~115ms for an
+     * exact scan. Beyond it recall flattens (the probed partitions run out of
+     * candidates) while latency keeps climbing. The refined set is bounded by
+     * the query limit, not by table size, so this costs a fixed few MB.
+     *
+     * Harmless on tables with no index: a flat scan already computes exact
+     * distances and returns identical rows.
+     */
+    readonly REFINE_FACTOR: 20;
+};
+/**
+ * Columns a search reads off a result row.
+ *
+ * Selecting explicitly keeps the embedding out of the result set — without it
+ * LanceDB ships every over-fetched row's full vector back into JS for nothing.
+ *
+ * `_distance` is listed on purpose: LanceDB currently auto-projects it into any
+ * scoring query but warns that it will stop, so naming it pins the behaviour
+ * rather than relying on a deprecated default.
+ */
+export declare const SEARCH_COLUMNS: readonly ["id", "filePath", "startLine", "endLine", "type", "name", "content", "context", "fileHash", "_distance"];

package/dist/infrastructure/lancedb/VectorIndexPolicy.js

@@ -0,0 +1,72 @@
+/**
+ * Tuning for the LanceDB vector index. The numbers here were measured on a
+ * 43k-chunk / 3584-dimension index; the comments record what they bought so a
+ * later change can tell a tuned value from an arbitrary one.
+ */
+export const VectorIndexPolicy = {
+    /**
+     * Below this row count a brute-force scan is cheap enough that training an
+     * index costs more than it saves, and IVF-PQ has too few vectors to cluster
+     * well.
+     */
+    MIN_ROWS_FOR_ANN: 5_000,
+    /**
+     * Re-absorb new rows into the index once the unindexed tail passes this
+     * share of the indexed body. Rows outside the index are searched by flat
+     * scan, so the tail is exactly what needs bounding.
+     */
+    UNINDEXED_REINDEX_RATIO: 0.2,
+    /** ...but always tolerate a small tail, so a 3-chunk edit never retrains. */
+    UNINDEXED_REINDEX_FLOOR: 2_000,
+    /**
+     * Vector searches run without an explicit distance type, which LanceDB
+     * resolves to L2. The index has its own default, so it is pinned: an index
+     * built on a different metric would silently reorder every result.
+     */
+    DISTANCE_TYPE: "l2",
+    /**
+     * IVF-PQ stores compressed vectors, so its raw distances approximate the
+     * real ones. `refineFactor` makes LanceDB pull the uncompressed vectors for
+     * the top `limit * factor` candidates and re-score them exactly.
+     *
+     * It is not optional. Measured mean recall@20 against an exact scan:
+     *
+     *   off -> 53%   1 -> 75%   3 -> 86%   10 -> 91%   20 -> 94%   50 -> 94%
+     *
+     * and without it `_distance` is wrong by ~0.07, which matters because score
+     * is derived from it and users filter on `--min-score`. With refinement the
+     * scores match an exact scan to the digit.
+     *
+     * 20 sits at the knee: ~94% recall at ~11ms/query versus ~115ms for an
+     * exact scan. Beyond it recall flattens (the probed partitions run out of
+     * candidates) while latency keeps climbing. The refined set is bounded by
+     * the query limit, not by table size, so this costs a fixed few MB.
+     *
+     * Harmless on tables with no index: a flat scan already computes exact
+     * distances and returns identical rows.
+     */
+    REFINE_FACTOR: 20,
+};
+/**
+ * Columns a search reads off a result row.
+ *
+ * Selecting explicitly keeps the embedding out of the result set — without it
+ * LanceDB ships every over-fetched row's full vector back into JS for nothing.
+ *
+ * `_distance` is listed on purpose: LanceDB currently auto-projects it into any
+ * scoring query but warns that it will stop, so naming it pins the behaviour
+ * rather than relying on a deprecated default.
+ */
+export const SEARCH_COLUMNS = [
+    "id",
+    "filePath",
+    "startLine",
+    "endLine",
+    "type",
+    "name",
+    "content",
+    "context",
+    "fileHash",
+    "_distance",
+];
+//# sourceMappingURL=VectorIndexPolicy.js.map

package/dist/infrastructure/lancedb/VectorIndexPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectorIndexPolicy.js","sourceRoot":"","sources":["../../../src/infrastructure/lancedb/VectorIndexPolicy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC;;;;OAIG;IACH,gBAAgB,EAAE,KAAK;IAEvB;;;;OAIG;IACH,uBAAuB,EAAE,GAAG;IAE5B,6EAA6E;IAC7E,uBAAuB,EAAE,KAAK;IAE9B;;;;OAIG;IACH,aAAa,EAAE,IAAI;IAEnB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,aAAa,EAAE,EAAE;CACR,CAAC;AAEX;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC7B,IAAI;IACJ,UAAU;IACV,WAAW;IACX,SAAS;IACT,MAAM;IACN,MAAM;IACN,SAAS;IACT,SAAS;IACT,UAAU;IACV,WAAW;CACF,CAAC"}

package/dist/infrastructure/p2p/IndexShare.d.ts

@@ -0,0 +1,45 @@
+import type { IndexMetadata } from "../../domain/project/IndexMetadata.js";
+import type { RowReplication } from "../lancedb/RowReplication.js";
+import { ShareCode } from "./ShareCode.js";
+export interface ShareProgress {
+    onProgress?: (done: number, total: number) => void;
+}
+export interface ReceiveOptions extends ShareProgress {
+    onMeta?: (meta: {
+        model?: string;
+        dimensions?: number;
+        chunkCount: number;
+        remote?: string;
+    }) => void;
+    onWarning?: (message: string) => void;
+}
+export interface ReceiveResult {
+    chunks: number;
+    files: number;
+}
+/**
+ * Sends and receives a whole index between two machines.
+ *
+ * The transfer copies rows verbatim, embeddings included: re-embedding a large
+ * repository is the expensive thing, and avoiding it is the entire reason to
+ * share. That makes model compatibility the receiver's responsibility to check
+ * — vectors from a different model are silently meaningless, so a mismatch is
+ * warned about explicitly.
+ */
+export declare class IndexShare {
+    private readonly rows;
+    private static readonly BATCH_SIZE;
+    private static readonly PEER_TIMEOUT_MS;
+    constructor(rows: RowReplication);
+    /**
+     * Publish the index and return the code a peer needs. `done` resolves once
+     * a peer has taken the whole transfer.
+     */
+    send(metadata: IndexMetadata | undefined, options?: ShareProgress): Promise<{
+        code: string;
+        done: Promise<void>;
+    }>;
+    /** Connect to a sharer and write everything it sends into this database. */
+    receive(code: ShareCode, localMetadata: IndexMetadata | undefined, options?: ReceiveOptions): Promise<ReceiveResult>;
+    private warnOnModelMismatch;
+}

package/dist/infrastructure/p2p/IndexShare.js

@@ -0,0 +1,160 @@
+import { ModelIdentity } from "../../domain/project/ModelIdentity.js";
+import { PeerSwarm } from "./PeerSwarm.js";
+import { SecureChannel, } from "./SecureChannel.js";
+import { ShareCode } from "./ShareCode.js";
+/**
+ * Sends and receives a whole index between two machines.
+ *
+ * The transfer copies rows verbatim, embeddings included: re-embedding a large
+ * repository is the expensive thing, and avoiding it is the entire reason to
+ * share. That makes model compatibility the receiver's responsibility to check
+ * — vectors from a different model are silently meaningless, so a mismatch is
+ * warned about explicitly.
+ */
+export class IndexShare {
+    rows;
+    static BATCH_SIZE = 200;
+    static PEER_TIMEOUT_MS = 5 * 60 * 1000;
+    constructor(rows) {
+        this.rows = rows;
+    }
+    /**
+     * Publish the index and return the code a peer needs. `done` resolves once
+     * a peer has taken the whole transfer.
+     */
+    async send(metadata, options = {}) {
+        const swarm = await PeerSwarm.create();
+        const code = ShareCode.generate();
+        const channel = new SecureChannel(code.toEncryptionKey());
+        const chunkCount = await this.rows.chunkCount();
+        const done = new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                void swarm.destroy();
+                reject(new Error("Timed out waiting for peer (5 minutes)."));
+            }, IndexShare.PEER_TIMEOUT_MS);
+            swarm.onConnection(async (socket) => {
+                clearTimeout(timeout);
+                try {
+                    channel.send(socket, {
+                        type: "meta",
+                        model: metadata?.model,
+                        dimensions: metadata?.dimensions,
+                        chunkCount,
+                        branch: metadata?.branch ?? "main",
+                        remote: metadata?.remote,
+                    });
+                    // Wait for the receiver to accept before streaming — it may
+                    // refuse on an incompatible model.
+                    await channel.await(socket, "ready");
+                    let sent = 0;
+                    for await (const batch of this.rows.streamChunkRows(IndexShare.BATCH_SIZE)) {
+                        channel.send(socket, { type: "chunks", batch });
+                        sent += batch.length;
+                        options.onProgress?.(sent, chunkCount);
+                    }
+                    const files = await this.rows.allManifestRows();
+                    if (files.length > 0) {
+                        channel.send(socket, { type: "files", batch: files });
+                    }
+                    channel.send(socket, { type: "done" });
+                    // Wait for the ack so the socket is not torn down before
+                    // the receiver has committed.
+                    await channel.await(socket, "ack");
+                    socket.end();
+                    await swarm.destroy();
+                    resolve();
+                }
+                catch (err) {
+                    await swarm.destroy();
+                    reject(err);
+                }
+            });
+            swarm.join(code.toTopic(), "server").catch(reject);
+        });
+        return { code: code.toString(), done };
+    }
+    /** Connect to a sharer and write everything it sends into this database. */
+    async receive(code, localMetadata, options = {}) {
+        const swarm = await PeerSwarm.create();
+        const channel = new SecureChannel(code.toEncryptionKey());
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                void swarm.destroy();
+                reject(new Error("Timed out waiting for peer (5 minutes)."));
+            }, IndexShare.PEER_TIMEOUT_MS);
+            const fail = (err) => {
+                void swarm.destroy().then(() => reject(err));
+            };
+            swarm.onConnection((socket) => {
+                clearTimeout(timeout);
+                let expected = 0;
+                let chunks = 0;
+                let files = 0;
+                let accepted = false;
+                const handle = (message) => {
+                    switch (message.type) {
+                        case "meta": {
+                            expected = message.chunkCount;
+                            options.onMeta?.({
+                                model: message.model,
+                                dimensions: message.dimensions,
+                                chunkCount: message.chunkCount,
+                                remote: message.remote,
+                            });
+                            this.warnOnModelMismatch(localMetadata, message, options.onWarning);
+                            channel.send(socket, { type: "ready" });
+                            accepted = true;
+                            break;
+                        }
+                        case "chunks": {
+                            // Ignore anything arriving before the handshake.
+                            if (!accepted)
+                                break;
+                            chunks += message.batch.length;
+                            options.onProgress?.(chunks, expected);
+                            this.rows.addChunkRows(message.batch).catch(fail);
+                            break;
+                        }
+                        case "files": {
+                            if (!accepted)
+                                break;
+                            files += message.batch.length;
+                            this.rows.addManifestRows(message.batch).catch(fail);
+                            break;
+                        }
+                        case "done": {
+                            channel.send(socket, { type: "ack" });
+                            void swarm.destroy().then(() => resolve({ chunks, files }));
+                            break;
+                        }
+                    }
+                };
+                const read = channel.reader((message) => {
+                    try {
+                        handle(message);
+                    }
+                    catch (err) {
+                        fail(new Error(`Protocol error: ${err}`));
+                    }
+                });
+                socket.on("data", read);
+                socket.on("error", fail);
+            });
+            swarm.join(code.toTopic(), "client").catch(reject);
+        });
+    }
+    warnOnModelMismatch(local, remote, onWarning) {
+        if (!local?.model || !remote.model)
+            return;
+        const localFamily = ModelIdentity.of(local.model).family;
+        const remoteFamily = ModelIdentity.of(remote.model).family;
+        if (localFamily === remoteFamily &&
+            local.dimensions === remote.dimensions) {
+            return;
+        }
+        onWarning?.(`Warning: source uses "${remote.model}" (${remote.dimensions} dims) ` +
+            `but local index uses "${local.model}" (${local.dimensions} dims). ` +
+            "Imported vectors may not be compatible.");
+    }
+}
+//# sourceMappingURL=IndexShare.js.map

package/dist/infrastructure/p2p/IndexShare.js.map

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

package/dist/infrastructure/p2p/PeerSwarm.d.ts

@@ -0,0 +1,16 @@
+import type { DuplexSocket } from "./SecureChannel.js";
+/**
+ * Peer discovery over Hyperswarm.
+ *
+ * Imported lazily and treated as optional: sharing is a side feature, and its
+ * native dependency should not be required to run a search.
+ */
+export declare class PeerSwarm {
+    private readonly swarm;
+    private constructor();
+    static create(): Promise<PeerSwarm>;
+    onConnection(handler: (socket: DuplexSocket) => void): void;
+    /** Announce as a server (sharer) or dial as a client (receiver). */
+    join(topic: Buffer, role: "server" | "client"): Promise<void>;
+    destroy(): Promise<void>;
+}

package/dist/infrastructure/p2p/PeerSwarm.js

@@ -0,0 +1,41 @@
+/**
+ * Peer discovery over Hyperswarm.
+ *
+ * Imported lazily and treated as optional: sharing is a side feature, and its
+ * native dependency should not be required to run a search.
+ */
+export class PeerSwarm {
+    swarm;
+    constructor(swarm) {
+        this.swarm = swarm;
+    }
+    static async create() {
+        let module;
+        try {
+            // @ts-expect-error -- no type declarations for hyperswarm
+            module = await import("hyperswarm");
+        }
+        catch {
+            throw new Error("hyperswarm is not installed. Run: pnpm add hyperswarm");
+        }
+        const Constructor = (module.default ??
+            module);
+        return new PeerSwarm(new Constructor());
+    }
+    onConnection(handler) {
+        this.swarm.on("connection", handler);
+    }
+    /** Announce as a server (sharer) or dial as a client (receiver). */
+    async join(topic, role) {
+        await this.swarm
+            .join(topic, {
+            server: role === "server",
+            client: role === "client",
+        })
+            .flushed();
+    }
+    async destroy() {
+        await this.swarm.destroy().catch(() => { });
+    }
+}
+//# sourceMappingURL=PeerSwarm.js.map

package/dist/infrastructure/p2p/PeerSwarm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PeerSwarm.js","sourceRoot":"","sources":["../../../src/infrastructure/p2p/PeerSwarm.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,MAAM,OAAO,SAAS;IACgB;IAArC,YAAqC,KAAyB;QAAzB,UAAK,GAAL,KAAK,CAAoB;IAAG,CAAC;IAElE,MAAM,CAAC,KAAK,CAAC,MAAM;QAClB,IAAI,MAAkD,CAAC;QACvD,IAAI,CAAC;YACJ,0DAA0D;YAC1D,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,OAAO;YAClC,MAAM,CAAiC,CAAC;QACzC,OAAO,IAAI,SAAS,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,YAAY,CAAC,OAAuC;QACnD,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,oEAAoE;IACpE,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,IAAyB;QAClD,MAAM,IAAI,CAAC,KAAK;aACd,IAAI,CAAC,KAAK,EAAE;YACZ,MAAM,EAAE,IAAI,KAAK,QAAQ;YACzB,MAAM,EAAE,IAAI,KAAK,QAAQ;SACzB,CAAC;aACD,OAAO,EAAE,CAAC;IACb,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;CACD"}

package/dist/infrastructure/p2p/SecureChannel.d.ts

@@ -0,0 +1,60 @@
+/** Messages exchanged during a share. */
+export type ShareMessage = {
+    type: "meta";
+    model?: string;
+    dimensions?: number;
+    chunkCount: number;
+    branch: string;
+    remote?: string;
+} | {
+    type: "ready";
+} | {
+    type: "chunks";
+    batch: Record<string, unknown>[];
+} | {
+    type: "files";
+    batch: Array<{
+        filePath: string;
+        fileHash: string;
+        branch: string;
+    }>;
+} | {
+    type: "done";
+} | {
+    type: "ack";
+};
+/** The transport a share runs over. */
+export interface DuplexSocket {
+    write(data: Buffer): boolean;
+    on(event: "data", cb: (chunk: Buffer) => void): void;
+    on(event: "end" | "close" | "error", cb: (err?: Error) => void): void;
+    end(): void;
+    destroy(): void;
+}
+/**
+ * Authenticated encryption and message framing over a raw peer socket.
+ *
+ * AES-256-GCM, so a tampered payload fails to decrypt rather than being parsed
+ * — a peer discovered over a public DHT is not trusted. Frames carry an
+ * explicit length prefix because a stream socket splits and merges writes
+ * arbitrarily, and JSON alone gives no way to find a message boundary.
+ */
+export declare class SecureChannel {
+    private readonly key;
+    private static readonly IV_BYTES;
+    private static readonly TAG_BYTES;
+    private static readonly LENGTH_PREFIX_BYTES;
+    constructor(key: Buffer);
+    send(socket: {
+        write(data: Buffer): boolean;
+    }, message: ShareMessage): void;
+    /**
+     * A stateful reader: feed it raw socket chunks, and it emits whole
+     * messages as their frames complete.
+     */
+    reader(onMessage: (message: ShareMessage) => void): (chunk: Buffer) => void;
+    /** Resolve once a message of the expected type arrives. */
+    await(socket: DuplexSocket, expected: ShareMessage["type"]): Promise<ShareMessage>;
+    private encrypt;
+    private decrypt;
+}