@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/core/rpc/iroh-transport.js

@@ -0,0 +1,278 @@
+import { Buffer } from "node:buffer";
+import { serializeJsonLine } from "./jsonl.js";
+export const DEFAULT_IROH_READ_LIMIT = 64 * 1024;
+export const DEFAULT_IROH_RPC_MAX_LINE_BYTES = 8 * 1024 * 1024;
+/**
+ * Create an RPC transport over an Iroh bidirectional stream.
+ *
+ * The transport preserves Volt RPC's strict LF-only JSONL framing and uses the
+ * Iroh stream's write promises for backpressure. It is intentionally typed
+ * structurally so callers can pass @number0/iroh BiStream values without making
+ * the core RPC abstraction own endpoint lifecycle.
+ */
+export function createIrohRpcTransport(options) {
+    const lineHandlers = new Set();
+    const closeHandlers = new Set();
+    const pendingWrites = new Set();
+    let writeQueue;
+    let pendingWriteError;
+    let readLoopStarted = false;
+    let localCloseRequested = false;
+    let closeEmitted = false;
+    let sendClosed = false;
+    const requestedReadLimit = normalizePositiveInteger(options.readLimit ?? DEFAULT_IROH_READ_LIMIT, "readLimit");
+    const maxLineBytes = normalizePositiveInteger(options.maxLineBytes ?? DEFAULT_IROH_RPC_MAX_LINE_BYTES, "maxLineBytes");
+    const readLimit = Math.min(requestedReadLimit, maxLineBytes + 1);
+    const closeErrorCode = options.closeErrorCode ?? 0n;
+    const recordWriteError = (error) => {
+        const writeError = toError(error);
+        pendingWriteError ??= writeError;
+        return writeError;
+    };
+    const throwPendingWriteError = () => {
+        if (!pendingWriteError) {
+            return;
+        }
+        const writeError = pendingWriteError;
+        pendingWriteError = undefined;
+        throw writeError;
+    };
+    const waitForPendingWrites = async () => {
+        while (pendingWrites.size > 0) {
+            await Promise.allSettled(pendingWrites);
+        }
+        throwPendingWriteError();
+    };
+    const emitClose = (error) => {
+        if (closeEmitted) {
+            return;
+        }
+        closeEmitted = true;
+        for (const handler of closeHandlers) {
+            handler(error);
+        }
+    };
+    const emitLine = async (line) => {
+        const normalizedLine = line.endsWith("\r") ? line.slice(0, -1) : line;
+        for (const handler of lineHandlers) {
+            await handler(normalizedLine);
+        }
+    };
+    const startReadLoop = () => {
+        if (readLoopStarted) {
+            return;
+        }
+        readLoopStarted = true;
+        void readIrohJsonl(options.stream.recv, readLimit, maxLineBytes, options.initialInput, emitLine).then(() => {
+            if (!localCloseRequested) {
+                emitClose();
+            }
+        }, (error) => {
+            if (!localCloseRequested) {
+                emitClose(toError(error));
+            }
+        });
+    };
+    return {
+        write(value) {
+            if (localCloseRequested || sendClosed) {
+                throw new Error("Iroh RPC send stream is closed");
+            }
+            const serialized = serializeJsonLine(value);
+            const serializedBytes = Buffer.from(serialized, "utf8");
+            assertIrohRpcLineWithinLimit(serializedBytes.length - 1, maxLineBytes);
+            const bytes = Array.from(serializedBytes);
+            const runWrite = () => {
+                try {
+                    return options.stream.send.writeAll(bytes);
+                }
+                catch (error) {
+                    throw recordWriteError(error);
+                }
+            };
+            const queuedAfter = writeQueue;
+            const rawWrite = queuedAfter ? queuedAfter.then(runWrite) : runWrite();
+            const writePromise = rawWrite
+                .catch((error) => {
+                throw recordWriteError(error);
+            })
+                .finally(() => {
+                pendingWrites.delete(writePromise);
+                if (writeQueue === writePromise) {
+                    writeQueue = undefined;
+                }
+            });
+            pendingWrites.add(writePromise);
+            writeQueue = writePromise;
+            return writePromise;
+        },
+        onLine(handler) {
+            lineHandlers.add(handler);
+            startReadLoop();
+            return () => {
+                lineHandlers.delete(handler);
+            };
+        },
+        onClose(handler) {
+            closeHandlers.add(handler);
+            return () => {
+                closeHandlers.delete(handler);
+            };
+        },
+        waitForBackpressure: waitForPendingWrites,
+        flush: waitForPendingWrites,
+        async close() {
+            localCloseRequested = true;
+            let pendingWriteFailure;
+            try {
+                await waitForPendingWrites();
+            }
+            catch (error) {
+                pendingWriteFailure = toError(error);
+            }
+            const closeFailures = [];
+            if ((options.finishSendOnClose ?? true) && !sendClosed && options.stream.send.finish) {
+                try {
+                    await options.stream.send.finish();
+                    sendClosed = true;
+                }
+                catch (error) {
+                    closeFailures.push(toError(error));
+                }
+            }
+            if ((options.stopRecvOnClose ?? true) && options.stream.recv.stop) {
+                try {
+                    const stopPromise = options.stream.recv.stop(closeErrorCode);
+                    if (!readLoopStarted && stopPromise) {
+                        await stopPromise;
+                    }
+                    else if (stopPromise) {
+                        // Iroh read() and stop() share a stream lock; do not block local shutdown behind the read loop.
+                        void stopPromise.catch(() => { });
+                    }
+                }
+                catch (error) {
+                    closeFailures.push(toError(error));
+                }
+            }
+            if (pendingWriteFailure) {
+                throw pendingWriteFailure;
+            }
+            if (closeFailures.length > 0) {
+                throw closeFailures[0];
+            }
+        },
+    };
+}
+async function readIrohJsonl(recv, readLimit, maxLineBytes, initialInput, onLine) {
+    let buffer = initialInput ? copyBytesToBuffer(initialInput) : Buffer.alloc(0);
+    while (true) {
+        const result = await readIrohJsonlLine(recv, buffer, { readLimit, maxLineBytes });
+        if (result.line === undefined) {
+            if (result.rest.length > 0) {
+                await onLine(normalizeJsonlLine(result.rest).toString("utf8"));
+            }
+            break;
+        }
+        await onLine(result.line);
+        buffer = result.rest;
+    }
+}
+/**
+ * Read one bounded JSONL line without repeatedly concatenating an attacker-
+ * controlled partial line. The geometric accumulator performs linear total
+ * copying while retaining at most maxLineBytes of partial-line storage.
+ */
+export async function readIrohJsonlLine(recv, initialInput = Buffer.alloc(0), options = {}) {
+    const maxLineBytes = normalizePositiveInteger(options.maxLineBytes ?? DEFAULT_IROH_RPC_MAX_LINE_BYTES, "maxLineBytes");
+    const requestedReadLimit = normalizePositiveInteger(options.readLimit ?? DEFAULT_IROH_READ_LIMIT, "readLimit");
+    const readLimit = Math.min(requestedReadLimit, maxLineBytes + 1);
+    const accumulator = new BoundedLineAccumulator(maxLineBytes);
+    let input = bytesToBuffer(initialInput);
+    while (true) {
+        const newlineIndex = input.indexOf(10);
+        if (newlineIndex !== -1) {
+            accumulator.append(input.subarray(0, newlineIndex));
+            return {
+                line: normalizeJsonlLine(accumulator.take()).toString("utf8"),
+                // Iroh reads are already capped. Keep an immutable view over the
+                // unread suffix so a chunk containing many short lines is consumed
+                // linearly instead of copying its shrinking remainder for every line.
+                rest: input.subarray(newlineIndex + 1),
+            };
+        }
+        accumulator.append(input);
+        const remainingBytes = maxLineBytes - accumulator.length;
+        const nextReadLimit = Math.min(readLimit, remainingBytes + 1);
+        const chunk = await recv.read(nextReadLimit);
+        if (!chunk || chunk.length === 0) {
+            return { line: undefined, rest: accumulator.take() };
+        }
+        if (chunk.length > nextReadLimit) {
+            throw new Error(`Iroh recv returned ${chunk.length} bytes for a ${nextReadLimit}-byte read`);
+        }
+        input = bytesToBuffer(chunk);
+    }
+}
+class BoundedLineAccumulator {
+    maxLineBytes;
+    storage = Buffer.alloc(0);
+    used = 0;
+    constructor(maxLineBytes) {
+        this.maxLineBytes = maxLineBytes;
+    }
+    get length() {
+        return this.used;
+    }
+    append(bytes) {
+        const nextLength = this.used + bytes.length;
+        assertIrohRpcLineWithinLimit(nextLength, this.maxLineBytes);
+        if (bytes.length === 0) {
+            return;
+        }
+        if (nextLength > this.storage.length) {
+            let nextCapacity = Math.max(1, this.storage.length);
+            while (nextCapacity < nextLength) {
+                nextCapacity = Math.min(this.maxLineBytes, Math.max(nextLength, nextCapacity * 2));
+            }
+            const grown = Buffer.allocUnsafe(nextCapacity);
+            this.storage.copy(grown, 0, 0, this.used);
+            this.storage = grown;
+        }
+        bytes.copy(this.storage, this.used);
+        this.used = nextLength;
+    }
+    take() {
+        const result = Buffer.from(this.storage.subarray(0, this.used));
+        this.storage = Buffer.alloc(0);
+        this.used = 0;
+        return result;
+    }
+}
+function normalizeJsonlLine(line) {
+    return line.length > 0 && line[line.length - 1] === 13 ? line.subarray(0, line.length - 1) : line;
+}
+function assertIrohRpcLineWithinLimit(length, maxLineBytes) {
+    if (length > maxLineBytes) {
+        throw new Error(`Iroh RPC line exceeds maximum size of ${maxLineBytes} bytes`);
+    }
+}
+function normalizePositiveInteger(value, label) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new Error(`${label} must be a positive integer`);
+    }
+    return value;
+}
+function bytesToBuffer(bytes) {
+    if (Buffer.isBuffer(bytes)) {
+        return bytes;
+    }
+    return Buffer.from(bytes);
+}
+function copyBytesToBuffer(bytes) {
+    return Buffer.from(bytesToBuffer(bytes));
+}
+function toError(value) {
+    return value instanceof Error ? value : new Error(String(value));
+}
+//# sourceMappingURL=iroh-transport.js.map

package/dist/core/rpc/iroh-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iroh-transport.js","sourceRoot":"","sources":["../../../src/core/rpc/iroh-transport.ts"],"names":[],"mappings":"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","sourcesContent":["import { Buffer } from \"node:buffer\";\nimport { serializeJsonLine } from \"./jsonl.ts\";\nimport type { RpcCloseHandler, RpcLineHandler, RpcTransport } from \"./transport.ts\";\n\nexport const DEFAULT_IROH_READ_LIMIT = 64 * 1024;\nexport const DEFAULT_IROH_RPC_MAX_LINE_BYTES = 8 * 1024 * 1024;\n\nexport type IrohBytes = Array<number> | Uint8Array;\n\nexport interface IrohRecvStreamLike {\n\tread(sizeLimit: number): Promise<IrohBytes | null | undefined>;\n\tstop?(errorCode: bigint): void | Promise<void>;\n}\n\nexport interface IrohSendStreamLike {\n\twriteAll(bytes: Array<number>): Promise<void>;\n\tfinish?(): Promise<void>;\n\treset?(errorCode: bigint): void | Promise<void>;\n}\n\nexport interface IrohBiStreamLike {\n\trecv: IrohRecvStreamLike;\n\tsend: IrohSendStreamLike;\n}\n\nexport interface IrohRpcTransportOptions {\n\tstream: IrohBiStreamLike;\n\t/** Bytes already read while handling a pre-RPC handshake. */\n\tinitialInput?: IrohBytes;\n\t/** Maximum bytes requested per Iroh read. Defaults to 64 KiB. */\n\treadLimit?: number;\n\t/** Maximum bytes allowed in one inbound or outbound JSONL line. Defaults to 8 MiB. */\n\tmaxLineBytes?: number;\n\t/** Finish the send half during close. Defaults to true. */\n\tfinishSendOnClose?: boolean;\n\t/** Stop the recv half during close. Defaults to true. */\n\tstopRecvOnClose?: boolean;\n\t/** Error code used for the recv stop helper. Defaults to 0. */\n\tcloseErrorCode?: bigint;\n}\n\n/**\n * Create an RPC transport over an Iroh bidirectional stream.\n *\n * The transport preserves Volt RPC's strict LF-only JSONL framing and uses the\n * Iroh stream's write promises for backpressure. It is intentionally typed\n * structurally so callers can pass @number0/iroh BiStream values without making\n * the core RPC abstraction own endpoint lifecycle.\n */\nexport function createIrohRpcTransport(options: IrohRpcTransportOptions): RpcTransport {\n\tconst lineHandlers = new Set<RpcLineHandler>();\n\tconst closeHandlers = new Set<RpcCloseHandler>();\n\tconst pendingWrites = new Set<Promise<void>>();\n\tlet writeQueue: Promise<void> | undefined;\n\tlet pendingWriteError: Error | undefined;\n\tlet readLoopStarted = false;\n\tlet localCloseRequested = false;\n\tlet closeEmitted = false;\n\tlet sendClosed = false;\n\tconst requestedReadLimit = normalizePositiveInteger(options.readLimit ?? DEFAULT_IROH_READ_LIMIT, \"readLimit\");\n\tconst maxLineBytes = normalizePositiveInteger(\n\t\toptions.maxLineBytes ?? DEFAULT_IROH_RPC_MAX_LINE_BYTES,\n\t\t\"maxLineBytes\",\n\t);\n\tconst readLimit = Math.min(requestedReadLimit, maxLineBytes + 1);\n\tconst closeErrorCode = options.closeErrorCode ?? 0n;\n\n\tconst recordWriteError = (error: unknown): Error => {\n\t\tconst writeError = toError(error);\n\t\tpendingWriteError ??= writeError;\n\t\treturn writeError;\n\t};\n\n\tconst throwPendingWriteError = (): void => {\n\t\tif (!pendingWriteError) {\n\t\t\treturn;\n\t\t}\n\t\tconst writeError = pendingWriteError;\n\t\tpendingWriteError = undefined;\n\t\tthrow writeError;\n\t};\n\n\tconst waitForPendingWrites = async (): Promise<void> => {\n\t\twhile (pendingWrites.size > 0) {\n\t\t\tawait Promise.allSettled(pendingWrites);\n\t\t}\n\t\tthrowPendingWriteError();\n\t};\n\n\tconst emitClose = (error?: Error): void => {\n\t\tif (closeEmitted) {\n\t\t\treturn;\n\t\t}\n\t\tcloseEmitted = true;\n\t\tfor (const handler of closeHandlers) {\n\t\t\thandler(error);\n\t\t}\n\t};\n\n\tconst emitLine = async (line: string): Promise<void> => {\n\t\tconst normalizedLine = line.endsWith(\"\\r\") ? line.slice(0, -1) : line;\n\t\tfor (const handler of lineHandlers) {\n\t\t\tawait handler(normalizedLine);\n\t\t}\n\t};\n\n\tconst startReadLoop = (): void => {\n\t\tif (readLoopStarted) {\n\t\t\treturn;\n\t\t}\n\t\treadLoopStarted = true;\n\t\tvoid readIrohJsonl(options.stream.recv, readLimit, maxLineBytes, options.initialInput, emitLine).then(\n\t\t\t() => {\n\t\t\t\tif (!localCloseRequested) {\n\t\t\t\t\temitClose();\n\t\t\t\t}\n\t\t\t},\n\t\t\t(error: unknown) => {\n\t\t\t\tif (!localCloseRequested) {\n\t\t\t\t\temitClose(toError(error));\n\t\t\t\t}\n\t\t\t},\n\t\t);\n\t};\n\n\treturn {\n\t\twrite(value) {\n\t\t\tif (localCloseRequested || sendClosed) {\n\t\t\t\tthrow new Error(\"Iroh RPC send stream is closed\");\n\t\t\t}\n\n\t\t\tconst serialized = serializeJsonLine(value);\n\t\t\tconst serializedBytes = Buffer.from(serialized, \"utf8\");\n\t\t\tassertIrohRpcLineWithinLimit(serializedBytes.length - 1, maxLineBytes);\n\t\t\tconst bytes = Array.from(serializedBytes);\n\t\t\tconst runWrite = (): Promise<void> => {\n\t\t\t\ttry {\n\t\t\t\t\treturn options.stream.send.writeAll(bytes);\n\t\t\t\t} catch (error: unknown) {\n\t\t\t\t\tthrow recordWriteError(error);\n\t\t\t\t}\n\t\t\t};\n\t\t\tconst queuedAfter = writeQueue;\n\t\t\tconst rawWrite = queuedAfter ? queuedAfter.then(runWrite) : runWrite();\n\t\t\tconst writePromise = rawWrite\n\t\t\t\t.catch((error: unknown) => {\n\t\t\t\t\tthrow recordWriteError(error);\n\t\t\t\t})\n\t\t\t\t.finally(() => {\n\t\t\t\t\tpendingWrites.delete(writePromise);\n\t\t\t\t\tif (writeQueue === writePromise) {\n\t\t\t\t\t\twriteQueue = undefined;\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\tpendingWrites.add(writePromise);\n\t\t\twriteQueue = writePromise;\n\t\t\treturn writePromise;\n\t\t},\n\t\tonLine(handler) {\n\t\t\tlineHandlers.add(handler);\n\t\t\tstartReadLoop();\n\t\t\treturn () => {\n\t\t\t\tlineHandlers.delete(handler);\n\t\t\t};\n\t\t},\n\t\tonClose(handler) {\n\t\t\tcloseHandlers.add(handler);\n\t\t\treturn () => {\n\t\t\t\tcloseHandlers.delete(handler);\n\t\t\t};\n\t\t},\n\t\twaitForBackpressure: waitForPendingWrites,\n\t\tflush: waitForPendingWrites,\n\t\tasync close() {\n\t\t\tlocalCloseRequested = true;\n\t\t\tlet pendingWriteFailure: Error | undefined;\n\t\t\ttry {\n\t\t\t\tawait waitForPendingWrites();\n\t\t\t} catch (error: unknown) {\n\t\t\t\tpendingWriteFailure = toError(error);\n\t\t\t}\n\n\t\t\tconst closeFailures: Error[] = [];\n\t\t\tif ((options.finishSendOnClose ?? true) && !sendClosed && options.stream.send.finish) {\n\t\t\t\ttry {\n\t\t\t\t\tawait options.stream.send.finish();\n\t\t\t\t\tsendClosed = true;\n\t\t\t\t} catch (error: unknown) {\n\t\t\t\t\tcloseFailures.push(toError(error));\n\t\t\t\t}\n\t\t\t}\n\t\t\tif ((options.stopRecvOnClose ?? true) && options.stream.recv.stop) {\n\t\t\t\ttry {\n\t\t\t\t\tconst stopPromise = options.stream.recv.stop(closeErrorCode);\n\t\t\t\t\tif (!readLoopStarted && stopPromise) {\n\t\t\t\t\t\tawait stopPromise;\n\t\t\t\t\t} else if (stopPromise) {\n\t\t\t\t\t\t// Iroh read() and stop() share a stream lock; do not block local shutdown behind the read loop.\n\t\t\t\t\t\tvoid stopPromise.catch(() => {});\n\t\t\t\t\t}\n\t\t\t\t} catch (error: unknown) {\n\t\t\t\t\tcloseFailures.push(toError(error));\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (pendingWriteFailure) {\n\t\t\t\tthrow pendingWriteFailure;\n\t\t\t}\n\t\t\tif (closeFailures.length > 0) {\n\t\t\t\tthrow closeFailures[0];\n\t\t\t}\n\t\t},\n\t};\n}\n\nasync function readIrohJsonl(\n\trecv: IrohRecvStreamLike,\n\treadLimit: number,\n\tmaxLineBytes: number,\n\tinitialInput: IrohBytes | undefined,\n\tonLine: (line: string) => void | Promise<void>,\n): Promise<void> {\n\tlet buffer = initialInput ? copyBytesToBuffer(initialInput) : Buffer.alloc(0);\n\twhile (true) {\n\t\tconst result = await readIrohJsonlLine(recv, buffer, { readLimit, maxLineBytes });\n\t\tif (result.line === undefined) {\n\t\t\tif (result.rest.length > 0) {\n\t\t\t\tawait onLine(normalizeJsonlLine(result.rest).toString(\"utf8\"));\n\t\t\t}\n\t\t\tbreak;\n\t\t}\n\t\tawait onLine(result.line);\n\t\tbuffer = result.rest;\n\t}\n}\n\nexport interface ReadIrohJsonlLineOptions {\n\t/** Maximum bytes requested per Iroh read. Defaults to 64 KiB. */\n\treadLimit?: number;\n\t/** Maximum bytes allowed before the LF delimiter. Defaults to 8 MiB. */\n\tmaxLineBytes?: number;\n}\n\n/**\n * Read one bounded JSONL line without repeatedly concatenating an attacker-\n * controlled partial line. The geometric accumulator performs linear total\n * copying while retaining at most maxLineBytes of partial-line storage.\n */\nexport async function readIrohJsonlLine(\n\trecv: IrohRecvStreamLike,\n\tinitialInput: IrohBytes = Buffer.alloc(0),\n\toptions: ReadIrohJsonlLineOptions = {},\n): Promise<{ line: string | undefined; rest: Buffer }> {\n\tconst maxLineBytes = normalizePositiveInteger(\n\t\toptions.maxLineBytes ?? DEFAULT_IROH_RPC_MAX_LINE_BYTES,\n\t\t\"maxLineBytes\",\n\t);\n\tconst requestedReadLimit = normalizePositiveInteger(options.readLimit ?? DEFAULT_IROH_READ_LIMIT, \"readLimit\");\n\tconst readLimit = Math.min(requestedReadLimit, maxLineBytes + 1);\n\tconst accumulator = new BoundedLineAccumulator(maxLineBytes);\n\tlet input = bytesToBuffer(initialInput);\n\n\twhile (true) {\n\t\tconst newlineIndex = input.indexOf(10);\n\t\tif (newlineIndex !== -1) {\n\t\t\taccumulator.append(input.subarray(0, newlineIndex));\n\t\t\treturn {\n\t\t\t\tline: normalizeJsonlLine(accumulator.take()).toString(\"utf8\"),\n\t\t\t\t// Iroh reads are already capped. Keep an immutable view over the\n\t\t\t\t// unread suffix so a chunk containing many short lines is consumed\n\t\t\t\t// linearly instead of copying its shrinking remainder for every line.\n\t\t\t\trest: input.subarray(newlineIndex + 1),\n\t\t\t};\n\t\t}\n\n\t\taccumulator.append(input);\n\t\tconst remainingBytes = maxLineBytes - accumulator.length;\n\t\tconst nextReadLimit = Math.min(readLimit, remainingBytes + 1);\n\t\tconst chunk = await recv.read(nextReadLimit);\n\t\tif (!chunk || chunk.length === 0) {\n\t\t\treturn { line: undefined, rest: accumulator.take() };\n\t\t}\n\t\tif (chunk.length > nextReadLimit) {\n\t\t\tthrow new Error(`Iroh recv returned ${chunk.length} bytes for a ${nextReadLimit}-byte read`);\n\t\t}\n\t\tinput = bytesToBuffer(chunk);\n\t}\n}\n\nclass BoundedLineAccumulator {\n\tprivate readonly maxLineBytes: number;\n\tprivate storage = Buffer.alloc(0);\n\tprivate used = 0;\n\n\tconstructor(maxLineBytes: number) {\n\t\tthis.maxLineBytes = maxLineBytes;\n\t}\n\n\tget length(): number {\n\t\treturn this.used;\n\t}\n\n\tappend(bytes: Buffer): void {\n\t\tconst nextLength = this.used + bytes.length;\n\t\tassertIrohRpcLineWithinLimit(nextLength, this.maxLineBytes);\n\t\tif (bytes.length === 0) {\n\t\t\treturn;\n\t\t}\n\t\tif (nextLength > this.storage.length) {\n\t\t\tlet nextCapacity = Math.max(1, this.storage.length);\n\t\t\twhile (nextCapacity < nextLength) {\n\t\t\t\tnextCapacity = Math.min(this.maxLineBytes, Math.max(nextLength, nextCapacity * 2));\n\t\t\t}\n\t\t\tconst grown = Buffer.allocUnsafe(nextCapacity);\n\t\t\tthis.storage.copy(grown, 0, 0, this.used);\n\t\t\tthis.storage = grown;\n\t\t}\n\t\tbytes.copy(this.storage, this.used);\n\t\tthis.used = nextLength;\n\t}\n\n\ttake(): Buffer {\n\t\tconst result = Buffer.from(this.storage.subarray(0, this.used));\n\t\tthis.storage = Buffer.alloc(0);\n\t\tthis.used = 0;\n\t\treturn result;\n\t}\n}\n\nfunction normalizeJsonlLine(line: Buffer): Buffer {\n\treturn line.length > 0 && line[line.length - 1] === 13 ? line.subarray(0, line.length - 1) : line;\n}\n\nfunction assertIrohRpcLineWithinLimit(length: number, maxLineBytes: number): void {\n\tif (length > maxLineBytes) {\n\t\tthrow new Error(`Iroh RPC line exceeds maximum size of ${maxLineBytes} bytes`);\n\t}\n}\n\nfunction normalizePositiveInteger(value: number, label: string): number {\n\tif (!Number.isInteger(value) || value <= 0) {\n\t\tthrow new Error(`${label} must be a positive integer`);\n\t}\n\treturn value;\n}\n\nfunction bytesToBuffer(bytes: IrohBytes): Buffer {\n\tif (Buffer.isBuffer(bytes)) {\n\t\treturn bytes;\n\t}\n\treturn Buffer.from(bytes);\n}\n\nfunction copyBytesToBuffer(bytes: IrohBytes): Buffer {\n\treturn Buffer.from(bytesToBuffer(bytes));\n}\n\nfunction toError(value: unknown): Error {\n\treturn value instanceof Error ? value : new Error(String(value));\n}\n"]}

package/dist/core/rpc/jsonl.d.ts

@@ -0,0 +1,17 @@
+import type { Readable } from "node:stream";
+/**
+ * Serialize a single strict JSONL record.
+ *
+ * Framing is LF-only. Payload strings may contain other Unicode separators such as
+ * U+2028 and U+2029. Clients must split records on `\n` only.
+ */
+export declare function serializeJsonLine(value: unknown): string;
+/**
+ * Attach an LF-only JSONL reader to a stream.
+ *
+ * This intentionally does not use Node readline. Readline splits on additional
+ * Unicode separators that are valid inside JSON strings and therefore does not
+ * implement strict JSONL framing.
+ */
+export declare function attachJsonlLineReader(stream: Readable, onLine: (line: string) => void): () => void;
+//# sourceMappingURL=jsonl.d.ts.map

package/dist/core/rpc/jsonl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../../../src/core/rpc/jsonl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAqClG","sourcesContent":["import type { Readable } from \"node:stream\";\nimport { StringDecoder } from \"node:string_decoder\";\n\n/**\n * Serialize a single strict JSONL record.\n *\n * Framing is LF-only. Payload strings may contain other Unicode separators such as\n * U+2028 and U+2029. Clients must split records on `\\n` only.\n */\nexport function serializeJsonLine(value: unknown): string {\n\treturn `${JSON.stringify(value)}\\n`;\n}\n\n/**\n * Attach an LF-only JSONL reader to a stream.\n *\n * This intentionally does not use Node readline. Readline splits on additional\n * Unicode separators that are valid inside JSON strings and therefore does not\n * implement strict JSONL framing.\n */\nexport function attachJsonlLineReader(stream: Readable, onLine: (line: string) => void): () => void {\n\tconst decoder = new StringDecoder(\"utf8\");\n\tlet buffer = \"\";\n\n\tconst emitLine = (line: string) => {\n\t\tonLine(line.endsWith(\"\\r\") ? line.slice(0, -1) : line);\n\t};\n\n\tconst onData = (chunk: string | Buffer) => {\n\t\tbuffer += typeof chunk === \"string\" ? chunk : decoder.write(chunk);\n\n\t\twhile (true) {\n\t\t\tconst newlineIndex = buffer.indexOf(\"\\n\");\n\t\t\tif (newlineIndex === -1) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\temitLine(buffer.slice(0, newlineIndex));\n\t\t\tbuffer = buffer.slice(newlineIndex + 1);\n\t\t}\n\t};\n\n\tconst onEnd = () => {\n\t\tbuffer += decoder.end();\n\t\tif (buffer.length > 0) {\n\t\t\temitLine(buffer);\n\t\t\tbuffer = \"\";\n\t\t}\n\t};\n\n\tstream.on(\"data\", onData);\n\tstream.on(\"end\", onEnd);\n\n\treturn () => {\n\t\tstream.off(\"data\", onData);\n\t\tstream.off(\"end\", onEnd);\n\t};\n}\n"]}

package/dist/core/rpc/jsonl.js

@@ -0,0 +1,49 @@
+import { StringDecoder } from "node:string_decoder";
+/**
+ * Serialize a single strict JSONL record.
+ *
+ * Framing is LF-only. Payload strings may contain other Unicode separators such as
+ * U+2028 and U+2029. Clients must split records on `\n` only.
+ */
+export function serializeJsonLine(value) {
+    return `${JSON.stringify(value)}\n`;
+}
+/**
+ * Attach an LF-only JSONL reader to a stream.
+ *
+ * This intentionally does not use Node readline. Readline splits on additional
+ * Unicode separators that are valid inside JSON strings and therefore does not
+ * implement strict JSONL framing.
+ */
+export function attachJsonlLineReader(stream, onLine) {
+    const decoder = new StringDecoder("utf8");
+    let buffer = "";
+    const emitLine = (line) => {
+        onLine(line.endsWith("\r") ? line.slice(0, -1) : line);
+    };
+    const onData = (chunk) => {
+        buffer += typeof chunk === "string" ? chunk : decoder.write(chunk);
+        while (true) {
+            const newlineIndex = buffer.indexOf("\n");
+            if (newlineIndex === -1) {
+                return;
+            }
+            emitLine(buffer.slice(0, newlineIndex));
+            buffer = buffer.slice(newlineIndex + 1);
+        }
+    };
+    const onEnd = () => {
+        buffer += decoder.end();
+        if (buffer.length > 0) {
+            emitLine(buffer);
+            buffer = "";
+        }
+    };
+    stream.on("data", onData);
+    stream.on("end", onEnd);
+    return () => {
+        stream.off("data", onData);
+        stream.off("end", onEnd);
+    };
+}
+//# sourceMappingURL=jsonl.js.map

package/dist/core/rpc/jsonl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.js","sourceRoot":"","sources":["../../../src/core/rpc/jsonl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc,EAAU;IACzD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;AAAA,CACpC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAgB,EAAE,MAA8B,EAAc;IACnG,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAAA,CACvD,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,KAAsB,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEnE,OAAO,IAAI,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;gBACzB,OAAO;YACR,CAAC;YAED,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;YACxC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;QACzC,CAAC;IAAA,CACD,CAAC;IAEF,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;QACnB,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACxB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,MAAM,CAAC,CAAC;YACjB,MAAM,GAAG,EAAE,CAAC;QACb,CAAC;IAAA,CACD,CAAC;IAEF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAExB,OAAO,GAAG,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAAA,CACzB,CAAC;AAAA,CACF","sourcesContent":["import type { Readable } from \"node:stream\";\nimport { StringDecoder } from \"node:string_decoder\";\n\n/**\n * Serialize a single strict JSONL record.\n *\n * Framing is LF-only. Payload strings may contain other Unicode separators such as\n * U+2028 and U+2029. Clients must split records on `\\n` only.\n */\nexport function serializeJsonLine(value: unknown): string {\n\treturn `${JSON.stringify(value)}\\n`;\n}\n\n/**\n * Attach an LF-only JSONL reader to a stream.\n *\n * This intentionally does not use Node readline. Readline splits on additional\n * Unicode separators that are valid inside JSON strings and therefore does not\n * implement strict JSONL framing.\n */\nexport function attachJsonlLineReader(stream: Readable, onLine: (line: string) => void): () => void {\n\tconst decoder = new StringDecoder(\"utf8\");\n\tlet buffer = \"\";\n\n\tconst emitLine = (line: string) => {\n\t\tonLine(line.endsWith(\"\\r\") ? line.slice(0, -1) : line);\n\t};\n\n\tconst onData = (chunk: string | Buffer) => {\n\t\tbuffer += typeof chunk === \"string\" ? chunk : decoder.write(chunk);\n\n\t\twhile (true) {\n\t\t\tconst newlineIndex = buffer.indexOf(\"\\n\");\n\t\t\tif (newlineIndex === -1) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\temitLine(buffer.slice(0, newlineIndex));\n\t\t\tbuffer = buffer.slice(newlineIndex + 1);\n\t\t}\n\t};\n\n\tconst onEnd = () => {\n\t\tbuffer += decoder.end();\n\t\tif (buffer.length > 0) {\n\t\t\temitLine(buffer);\n\t\t\tbuffer = \"\";\n\t\t}\n\t};\n\n\tstream.on(\"data\", onData);\n\tstream.on(\"end\", onEnd);\n\n\treturn () => {\n\t\tstream.off(\"data\", onData);\n\t\tstream.off(\"end\", onEnd);\n\t};\n}\n"]}

package/dist/core/rpc/loopback-transport.d.ts

@@ -0,0 +1,14 @@
+import type { RpcTransport } from "./transport.ts";
+export interface LoopbackRpcTransportPair {
+    client: RpcTransport;
+    server: RpcTransport;
+}
+/**
+ * Create an in-memory, full-duplex RPC transport pair.
+ *
+ * Each endpoint owns JSONL framing like the stream transports. Writes on one
+ * endpoint are delivered as inbound lines on the other endpoint, and closing one
+ * endpoint's output closes the peer endpoint's input.
+ */
+export declare function createLoopbackRpcTransportPair(): LoopbackRpcTransportPair;
+//# sourceMappingURL=loopback-transport.d.ts.map

package/dist/core/rpc/loopback-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopback-transport.d.ts","sourceRoot":"","sources":["../../../src/core/rpc/loopback-transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmC,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEpF,MAAM,WAAW,wBAAwB;IACxC,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,IAAI,wBAAwB,CAMzE","sourcesContent":["import { serializeJsonLine } from \"./jsonl.ts\";\nimport type { RpcCloseHandler, RpcLineHandler, RpcTransport } from \"./transport.ts\";\n\nexport interface LoopbackRpcTransportPair {\n\tclient: RpcTransport;\n\tserver: RpcTransport;\n}\n\n/**\n * Create an in-memory, full-duplex RPC transport pair.\n *\n * Each endpoint owns JSONL framing like the stream transports. Writes on one\n * endpoint are delivered as inbound lines on the other endpoint, and closing one\n * endpoint's output closes the peer endpoint's input.\n */\nexport function createLoopbackRpcTransportPair(): LoopbackRpcTransportPair {\n\tconst client = new LoopbackRpcTransportEndpoint();\n\tconst server = new LoopbackRpcTransportEndpoint();\n\tclient.setPeer(server);\n\tserver.setPeer(client);\n\treturn { client, server };\n}\n\nclass LoopbackRpcTransportEndpoint implements RpcTransport {\n\tprivate readonly lineHandlers = new Set<RpcLineHandler>();\n\tprivate readonly closeHandlers = new Set<RpcCloseHandler>();\n\tprivate readonly queuedLines: string[] = [];\n\tprivate peer: LoopbackRpcTransportEndpoint | undefined;\n\tprivate inputBuffer = \"\";\n\tprivate inputClosed = false;\n\tprivate inputCloseError: Error | undefined;\n\tprivate outputClosed = false;\n\n\tsetPeer(peer: LoopbackRpcTransportEndpoint): void {\n\t\tthis.peer = peer;\n\t}\n\n\twrite(value: object): void {\n\t\tif (this.outputClosed) {\n\t\t\tthrow new Error(\"Loopback RPC transport output is closed\");\n\t\t}\n\t\tif (!this.peer) {\n\t\t\tthrow new Error(\"Loopback RPC transport peer is missing\");\n\t\t}\n\n\t\tthis.peer.receiveText(serializeJsonLine(value));\n\t}\n\n\tonLine(handler: RpcLineHandler): () => void {\n\t\tthis.lineHandlers.add(handler);\n\t\tthis.drainQueuedLines();\n\t\treturn () => {\n\t\t\tthis.lineHandlers.delete(handler);\n\t\t};\n\t}\n\n\tonClose(handler: RpcCloseHandler): () => void {\n\t\tif (this.inputClosed) {\n\t\t\tlet active = true;\n\t\t\tqueueMicrotask(() => {\n\t\t\t\tif (active) {\n\t\t\t\t\thandler(this.inputCloseError);\n\t\t\t\t}\n\t\t\t});\n\t\t\treturn () => {\n\t\t\t\tactive = false;\n\t\t\t};\n\t\t}\n\n\t\tthis.closeHandlers.add(handler);\n\t\treturn () => {\n\t\t\tthis.closeHandlers.delete(handler);\n\t\t};\n\t}\n\n\tasync waitForBackpressure(): Promise<void> {}\n\n\tasync flush(): Promise<void> {}\n\n\tclose(): void {\n\t\tif (this.outputClosed) {\n\t\t\treturn;\n\t\t}\n\t\tthis.outputClosed = true;\n\t\tthis.peer?.endInput();\n\t}\n\n\tprivate receiveText(text: string): void {\n\t\tif (this.inputClosed) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.inputBuffer += text;\n\t\twhile (true) {\n\t\t\tconst newlineIndex = this.inputBuffer.indexOf(\"\\n\");\n\t\t\tif (newlineIndex === -1) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthis.enqueueLine(this.inputBuffer.slice(0, newlineIndex));\n\t\t\tthis.inputBuffer = this.inputBuffer.slice(newlineIndex + 1);\n\t\t}\n\t}\n\n\tprivate endInput(error?: Error): void {\n\t\tif (this.inputClosed) {\n\t\t\treturn;\n\t\t}\n\t\tif (this.inputBuffer.length > 0) {\n\t\t\tthis.enqueueLine(this.inputBuffer);\n\t\t\tthis.inputBuffer = \"\";\n\t\t}\n\n\t\tthis.inputClosed = true;\n\t\tthis.inputCloseError = error;\n\t\tfor (const handler of this.closeHandlers) {\n\t\t\thandler(error);\n\t\t}\n\t}\n\n\tprivate enqueueLine(line: string): void {\n\t\tconst normalizedLine = line.endsWith(\"\\r\") ? line.slice(0, -1) : line;\n\t\tif (this.lineHandlers.size === 0) {\n\t\t\tthis.queuedLines.push(normalizedLine);\n\t\t\treturn;\n\t\t}\n\n\t\tthis.emitLine(normalizedLine);\n\t}\n\n\tprivate drainQueuedLines(): void {\n\t\twhile (this.queuedLines.length > 0 && this.lineHandlers.size > 0) {\n\t\t\tconst line = this.queuedLines.shift();\n\t\t\tif (line !== undefined) {\n\t\t\t\tthis.emitLine(line);\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate emitLine(line: string): void {\n\t\tfor (const handler of this.lineHandlers) {\n\t\t\thandler(line);\n\t\t}\n\t}\n}\n"]}

package/dist/core/rpc/loopback-transport.js

@@ -0,0 +1,120 @@
+import { serializeJsonLine } from "./jsonl.js";
+/**
+ * Create an in-memory, full-duplex RPC transport pair.
+ *
+ * Each endpoint owns JSONL framing like the stream transports. Writes on one
+ * endpoint are delivered as inbound lines on the other endpoint, and closing one
+ * endpoint's output closes the peer endpoint's input.
+ */
+export function createLoopbackRpcTransportPair() {
+    const client = new LoopbackRpcTransportEndpoint();
+    const server = new LoopbackRpcTransportEndpoint();
+    client.setPeer(server);
+    server.setPeer(client);
+    return { client, server };
+}
+class LoopbackRpcTransportEndpoint {
+    lineHandlers = new Set();
+    closeHandlers = new Set();
+    queuedLines = [];
+    peer;
+    inputBuffer = "";
+    inputClosed = false;
+    inputCloseError;
+    outputClosed = false;
+    setPeer(peer) {
+        this.peer = peer;
+    }
+    write(value) {
+        if (this.outputClosed) {
+            throw new Error("Loopback RPC transport output is closed");
+        }
+        if (!this.peer) {
+            throw new Error("Loopback RPC transport peer is missing");
+        }
+        this.peer.receiveText(serializeJsonLine(value));
+    }
+    onLine(handler) {
+        this.lineHandlers.add(handler);
+        this.drainQueuedLines();
+        return () => {
+            this.lineHandlers.delete(handler);
+        };
+    }
+    onClose(handler) {
+        if (this.inputClosed) {
+            let active = true;
+            queueMicrotask(() => {
+                if (active) {
+                    handler(this.inputCloseError);
+                }
+            });
+            return () => {
+                active = false;
+            };
+        }
+        this.closeHandlers.add(handler);
+        return () => {
+            this.closeHandlers.delete(handler);
+        };
+    }
+    async waitForBackpressure() { }
+    async flush() { }
+    close() {
+        if (this.outputClosed) {
+            return;
+        }
+        this.outputClosed = true;
+        this.peer?.endInput();
+    }
+    receiveText(text) {
+        if (this.inputClosed) {
+            return;
+        }
+        this.inputBuffer += text;
+        while (true) {
+            const newlineIndex = this.inputBuffer.indexOf("\n");
+            if (newlineIndex === -1) {
+                return;
+            }
+            this.enqueueLine(this.inputBuffer.slice(0, newlineIndex));
+            this.inputBuffer = this.inputBuffer.slice(newlineIndex + 1);
+        }
+    }
+    endInput(error) {
+        if (this.inputClosed) {
+            return;
+        }
+        if (this.inputBuffer.length > 0) {
+            this.enqueueLine(this.inputBuffer);
+            this.inputBuffer = "";
+        }
+        this.inputClosed = true;
+        this.inputCloseError = error;
+        for (const handler of this.closeHandlers) {
+            handler(error);
+        }
+    }
+    enqueueLine(line) {
+        const normalizedLine = line.endsWith("\r") ? line.slice(0, -1) : line;
+        if (this.lineHandlers.size === 0) {
+            this.queuedLines.push(normalizedLine);
+            return;
+        }
+        this.emitLine(normalizedLine);
+    }
+    drainQueuedLines() {
+        while (this.queuedLines.length > 0 && this.lineHandlers.size > 0) {
+            const line = this.queuedLines.shift();
+            if (line !== undefined) {
+                this.emitLine(line);
+            }
+        }
+    }
+    emitLine(line) {
+        for (const handler of this.lineHandlers) {
+            handler(line);
+        }
+    }
+}
+//# sourceMappingURL=loopback-transport.js.map

package/dist/core/rpc/loopback-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopback-transport.js","sourceRoot":"","sources":["../../../src/core/rpc/loopback-transport.ts"],"names":[],"mappings":"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","sourcesContent":["import { serializeJsonLine } from \"./jsonl.ts\";\nimport type { RpcCloseHandler, RpcLineHandler, RpcTransport } from \"./transport.ts\";\n\nexport interface LoopbackRpcTransportPair {\n\tclient: RpcTransport;\n\tserver: RpcTransport;\n}\n\n/**\n * Create an in-memory, full-duplex RPC transport pair.\n *\n * Each endpoint owns JSONL framing like the stream transports. Writes on one\n * endpoint are delivered as inbound lines on the other endpoint, and closing one\n * endpoint's output closes the peer endpoint's input.\n */\nexport function createLoopbackRpcTransportPair(): LoopbackRpcTransportPair {\n\tconst client = new LoopbackRpcTransportEndpoint();\n\tconst server = new LoopbackRpcTransportEndpoint();\n\tclient.setPeer(server);\n\tserver.setPeer(client);\n\treturn { client, server };\n}\n\nclass LoopbackRpcTransportEndpoint implements RpcTransport {\n\tprivate readonly lineHandlers = new Set<RpcLineHandler>();\n\tprivate readonly closeHandlers = new Set<RpcCloseHandler>();\n\tprivate readonly queuedLines: string[] = [];\n\tprivate peer: LoopbackRpcTransportEndpoint | undefined;\n\tprivate inputBuffer = \"\";\n\tprivate inputClosed = false;\n\tprivate inputCloseError: Error | undefined;\n\tprivate outputClosed = false;\n\n\tsetPeer(peer: LoopbackRpcTransportEndpoint): void {\n\t\tthis.peer = peer;\n\t}\n\n\twrite(value: object): void {\n\t\tif (this.outputClosed) {\n\t\t\tthrow new Error(\"Loopback RPC transport output is closed\");\n\t\t}\n\t\tif (!this.peer) {\n\t\t\tthrow new Error(\"Loopback RPC transport peer is missing\");\n\t\t}\n\n\t\tthis.peer.receiveText(serializeJsonLine(value));\n\t}\n\n\tonLine(handler: RpcLineHandler): () => void {\n\t\tthis.lineHandlers.add(handler);\n\t\tthis.drainQueuedLines();\n\t\treturn () => {\n\t\t\tthis.lineHandlers.delete(handler);\n\t\t};\n\t}\n\n\tonClose(handler: RpcCloseHandler): () => void {\n\t\tif (this.inputClosed) {\n\t\t\tlet active = true;\n\t\t\tqueueMicrotask(() => {\n\t\t\t\tif (active) {\n\t\t\t\t\thandler(this.inputCloseError);\n\t\t\t\t}\n\t\t\t});\n\t\t\treturn () => {\n\t\t\t\tactive = false;\n\t\t\t};\n\t\t}\n\n\t\tthis.closeHandlers.add(handler);\n\t\treturn () => {\n\t\t\tthis.closeHandlers.delete(handler);\n\t\t};\n\t}\n\n\tasync waitForBackpressure(): Promise<void> {}\n\n\tasync flush(): Promise<void> {}\n\n\tclose(): void {\n\t\tif (this.outputClosed) {\n\t\t\treturn;\n\t\t}\n\t\tthis.outputClosed = true;\n\t\tthis.peer?.endInput();\n\t}\n\n\tprivate receiveText(text: string): void {\n\t\tif (this.inputClosed) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.inputBuffer += text;\n\t\twhile (true) {\n\t\t\tconst newlineIndex = this.inputBuffer.indexOf(\"\\n\");\n\t\t\tif (newlineIndex === -1) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthis.enqueueLine(this.inputBuffer.slice(0, newlineIndex));\n\t\t\tthis.inputBuffer = this.inputBuffer.slice(newlineIndex + 1);\n\t\t}\n\t}\n\n\tprivate endInput(error?: Error): void {\n\t\tif (this.inputClosed) {\n\t\t\treturn;\n\t\t}\n\t\tif (this.inputBuffer.length > 0) {\n\t\t\tthis.enqueueLine(this.inputBuffer);\n\t\t\tthis.inputBuffer = \"\";\n\t\t}\n\n\t\tthis.inputClosed = true;\n\t\tthis.inputCloseError = error;\n\t\tfor (const handler of this.closeHandlers) {\n\t\t\thandler(error);\n\t\t}\n\t}\n\n\tprivate enqueueLine(line: string): void {\n\t\tconst normalizedLine = line.endsWith(\"\\r\") ? line.slice(0, -1) : line;\n\t\tif (this.lineHandlers.size === 0) {\n\t\t\tthis.queuedLines.push(normalizedLine);\n\t\t\treturn;\n\t\t}\n\n\t\tthis.emitLine(normalizedLine);\n\t}\n\n\tprivate drainQueuedLines(): void {\n\t\twhile (this.queuedLines.length > 0 && this.lineHandlers.size > 0) {\n\t\t\tconst line = this.queuedLines.shift();\n\t\t\tif (line !== undefined) {\n\t\t\t\tthis.emitLine(line);\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate emitLine(line: string): void {\n\t\tfor (const handler of this.lineHandlers) {\n\t\t\thandler(line);\n\t\t}\n\t}\n}\n"]}

package/dist/core/rpc/transcript.d.ts

@@ -0,0 +1,37 @@
+import type { ImageContent } from "@hansjm10/volt-ai";
+import type { ReadonlySessionManager, SessionEntry } from "../session-manager.ts";
+import type { RpcMessageImage, RpcTranscriptResponse } from "./types.ts";
+export interface ProjectSessionTranscriptOptions {
+    beforeEntryId?: string;
+    limit?: number;
+}
+export declare function projectSessionTranscript(sessionManager: ReadonlySessionManager, options?: ProjectSessionTranscriptOptions): RpcTranscriptResponse;
+/**
+ * Serialized-size budget for one get_message_images response. Keeps the frame
+ * under the daemon control protocol's 8 MB line cap (the tightest transport on
+ * any relay path) with headroom for JSON envelope overhead. The first image of
+ * a page is always included so pagination cannot stall on a single large image.
+ */
+export declare const MESSAGE_IMAGES_RESPONSE_BUDGET_BYTES: number;
+export declare const MESSAGE_IMAGES_PAGE_MAX_ITEMS = 32;
+export type ProjectMessageImagesResult = {
+    ok: true;
+    entryId: string;
+    totalImages: number;
+    images: RpcMessageImage[];
+    nextImageIndex: number | null;
+} | {
+    ok: false;
+    error: "unknown_entry" | "image_too_large";
+};
+/**
+ * Recovers the inline image blocks persisted on a session entry, paged from
+ * `startImageIndex` under `budgetBytes`. Text-only transcript projections
+ * advertise `imageCount`; reconnecting clients call this per entry to restore
+ * user-message images after a cold restart.
+ */
+export declare function projectMessageImages(entries: SessionEntry[], entryId: string, startImageIndex?: number, budgetBytes?: number): ProjectMessageImagesResult;
+/** Inline image blocks on a persisted message's content array. */
+export declare function extractMessageImages(content: unknown): ImageContent[];
+export declare function projectSubagentDetails(details: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
+//# sourceMappingURL=transcript.d.ts.map