@bastani/atomic 0.9.9 → 0.9.10-alpha.1

package/dist/modes/interactive-engine/session-picker-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-picker-host.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/session-picker-host.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExtensionUIContext, HostSessionPickerRow } from \"../../core/extensions/index.ts\";\nimport {\n\tmountHostSessionPicker,\n\tsessionInfoFromPickerRow,\n\ttype HostSessionPickerMount,\n} from \"../interactive/components/host-session-picker.ts\";\nimport type { IsolatedInteractiveRuntime } from \"./isolated-runtime.ts\";\nimport type { InteractiveEngineMessage } from \"./protocol.ts\";\n\n/**\n * Host-side half of the engine session picker channel.\n *\n * Mounts a REAL `SessionSelectorComponent` in the terminal host when the engine\n * child opens a picker, so arrow-key navigation, search, and repaints are\n * zero-IPC (unlike remote-rendered `ctx.ui.custom` components, which round-trip\n * every keypress). Only semantic events cross the protocol: the child pushes\n * open/update/error/close, the host sends select/cancel/delete. Deletion is\n * child-owned — the host never removes a row locally; it waits for the child's\n * `update` (row removed) or `error` reply.\n */\nexport class SessionPickerHostController {\n\tprivate readonly mounted = new Map<string, HostSessionPickerMount>();\n\tprivate readonly unsubscribe: () => void;\n\n\tprivate readonly runtime: IsolatedInteractiveRuntime;\n\tprivate readonly ui: ExtensionUIContext;\n\n\tconstructor(runtime: IsolatedInteractiveRuntime, ui: ExtensionUIContext) {\n\t\tthis.runtime = runtime;\n\t\tthis.ui = ui;\n\t\tthis.unsubscribe = runtime.onEngineMessage((message) => this.handleMessage(message));\n\t}\n\n\tdispose(): void {\n\t\tthis.unsubscribe();\n\t\tthis.disposeAll();\n\t}\n\n\tprivate handleMessage(message: InteractiveEngineMessage): void {\n\t\tswitch (message.type) {\n\t\t\tcase \"engine_ready\":\n\t\t\t\t// A fresh engine generation replaced the child: its pickers are gone\n\t\t\t\t// and the componentIds are meaningless to the new generation, so\n\t\t\t\t// unmount silently (no cancel command).\n\t\t\t\tthis.disposeAll();\n\t\t\t\tbreak;\n\t\t\tcase \"engine_session_picker_open\":\n\t\t\t\tthis.open(message.componentId, message.sessions, message.showRenameHint === true);\n\t\t\t\tbreak;\n\t\t\tcase \"engine_session_picker_update\":\n\t\t\t\tthis.mounted.get(message.componentId)?.setRows(message.sessions.map(sessionInfoFromPickerRow));\n\t\t\t\tbreak;\n\t\t\tcase \"engine_session_picker_error\":\n\t\t\t\tthis.mounted.get(message.componentId)?.showError(message.message);\n\t\t\t\tbreak;\n\t\t\tcase \"engine_session_picker_close\": {\n\t\t\t\tconst mount = this.mounted.get(message.componentId);\n\t\t\t\tif (!mount) break;\n\t\t\t\tthis.mounted.delete(message.componentId);\n\t\t\t\tmount.close();\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate open(componentId: string, sessions: HostSessionPickerRow[], showRenameHint: boolean): void {\n\t\tif (this.mounted.has(componentId)) return;\n\t\tconst mount = mountHostSessionPicker(this.ui, sessions.map(sessionInfoFromPickerRow), showRenameHint, {\n\t\t\tonSelect: (path) => {\n\t\t\t\tthis.mounted.delete(componentId);\n\t\t\t\tthis.runtime.sendEngineCommand({ type: \"engine_session_picker_select\", componentId, path });\n\t\t\t},\n\t\t\tonCancel: () => {\n\t\t\t\tthis.mounted.delete(componentId);\n\t\t\t\tthis.runtime.sendEngineCommand({ type: \"engine_session_picker_cancel\", componentId });\n\t\t\t},\n\t\t\tonDelete: (path) => {\n\t\t\t\tthis.runtime.sendEngineCommand({ type: \"engine_session_picker_delete\", componentId, path });\n\t\t\t},\n\t\t});\n\t\tthis.mounted.set(componentId, mount);\n\t}\n\n\tprivate disposeAll(): void {\n\t\tfor (const mount of this.mounted.values()) mount.close();\n\t\tthis.mounted.clear();\n\t}\n}\n"]}

package/dist/modes/interactive-engine/terminal-mode-controller.d.ts

@@ -0,0 +1,43 @@
+import type { EngineTerminalControl } from "./protocol.ts";
+/**
+ * Host-side terminal-mode arbiter for remote custom components.
+ *
+ * Remote components (running in the engine child) cannot touch the host TTY —
+ * their stdout is the JSONL transport, not a terminal. Instead they send typed
+ * {@link EngineTerminalControl} intents; this controller owns the concrete
+ * escape sequences and applies them to the real host terminal associated with
+ * the mounted component. Never a raw byte channel: only the two allowlisted
+ * modes below can ever reach the terminal.
+ *
+ * Guarantees:
+ *  - Controls that arrive before the component mounts are buffered and flushed
+ *    on mount (the child enables mouse reporting inside the overlay factory,
+ *    which runs before the mount `engine_custom_open` on the wire).
+ *  - Every mode a component turns on is reset to its safe default when that
+ *    component unmounts, or when the whole controller is reset (engine
+ *    crash / restart / generation replacement / host shutdown).
+ *  - State is component-scoped: a stale child cannot reset or alter a mode
+ *    owned by the currently mounted component.
+ */
+export declare const HOST_MOUSE_SCROLL_TRACKING_ON = "\u001B[?1000h\u001B[?1002h\u001B[?1006h";
+export declare const HOST_MOUSE_SCROLL_TRACKING_OFF = "\u001B[?1006l\u001B[?1002l\u001B[?1000l";
+export declare const HOST_TERMINAL_AUTOWRAP_ON = "\u001B[?7h";
+export declare const HOST_TERMINAL_AUTOWRAP_OFF = "\u001B[?7l";
+export interface HostTerminalWriter {
+    write(data: string): void;
+}
+export declare class TerminalModeController {
+    private readonly components;
+    /** Apply (or buffer) a typed control for a component. */
+    applyControl(componentId: string, control: EngineTerminalControl): void;
+    /** Register the host terminal for a component and flush buffered controls. */
+    onMount(componentId: string, terminal: HostTerminalWriter): void;
+    /** Reset and forget a single component's terminal modes. */
+    onUnmount(componentId: string): void;
+    /** Reset every component (engine crash/restart/generation swap/shutdown). */
+    resetAll(): void;
+    private ensure;
+    private write;
+    private reset;
+}
+//# sourceMappingURL=terminal-mode-controller.d.ts.map

package/dist/modes/interactive-engine/terminal-mode-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-mode-controller.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/terminal-mode-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,eAAO,MAAM,6BAA6B,4CAAsC,CAAC;AACjF,eAAO,MAAM,8BAA8B,4CAAsC,CAAC;AAClF,eAAO,MAAM,yBAAyB,eAAa,CAAC;AACpD,eAAO,MAAM,0BAA0B,eAAa,CAAC;AAErD,MAAM,WAAW,kBAAkB;IAClC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAYD,qBAAa,sBAAsB;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6C;IAExE,yDAAyD;IACzD,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CActE;IAED,8EAA8E;IAC9E,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAI/D;IAED,4DAA4D;IAC5D,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAKnC;IAED,6EAA6E;IAC7E,QAAQ,IAAI,IAAI,CAGf;IAED,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,KAAK;CAUb"}

package/dist/modes/interactive-engine/terminal-mode-controller.js

@@ -0,0 +1,109 @@
+/**
+ * Host-side terminal-mode arbiter for remote custom components.
+ *
+ * Remote components (running in the engine child) cannot touch the host TTY —
+ * their stdout is the JSONL transport, not a terminal. Instead they send typed
+ * {@link EngineTerminalControl} intents; this controller owns the concrete
+ * escape sequences and applies them to the real host terminal associated with
+ * the mounted component. Never a raw byte channel: only the two allowlisted
+ * modes below can ever reach the terminal.
+ *
+ * Guarantees:
+ *  - Controls that arrive before the component mounts are buffered and flushed
+ *    on mount (the child enables mouse reporting inside the overlay factory,
+ *    which runs before the mount `engine_custom_open` on the wire).
+ *  - Every mode a component turns on is reset to its safe default when that
+ *    component unmounts, or when the whole controller is reset (engine
+ *    crash / restart / generation replacement / host shutdown).
+ *  - State is component-scoped: a stale child cannot reset or alter a mode
+ *    owned by the currently mounted component.
+ */
+export const HOST_MOUSE_SCROLL_TRACKING_ON = "\x1b[?1000h\x1b[?1002h\x1b[?1006h";
+export const HOST_MOUSE_SCROLL_TRACKING_OFF = "\x1b[?1006l\x1b[?1002l\x1b[?1000l";
+export const HOST_TERMINAL_AUTOWRAP_ON = "\x1b[?7h";
+export const HOST_TERMINAL_AUTOWRAP_OFF = "\x1b[?7l";
+export class TerminalModeController {
+    constructor() {
+        this.components = new Map();
+    }
+    /** Apply (or buffer) a typed control for a component. */
+    applyControl(componentId, control) {
+        let state = this.components.get(componentId);
+        if (!state) {
+            // A control from an unmounted (late/stale) component that only restores
+            // the default mode has nothing to reset — ignore it rather than leak a
+            // dead entry or let a stale child perturb terminal-mode bookkeeping.
+            if (isDefaultControl(control))
+                return;
+            state = this.ensure(componentId);
+        }
+        if (!state.terminal) {
+            state.buffered.push(control);
+            return;
+        }
+        this.write(state, control);
+    }
+    /** Register the host terminal for a component and flush buffered controls. */
+    onMount(componentId, terminal) {
+        const state = this.ensure(componentId);
+        state.terminal = terminal;
+        for (const control of state.buffered.splice(0))
+            this.write(state, control);
+    }
+    /** Reset and forget a single component's terminal modes. */
+    onUnmount(componentId) {
+        const state = this.components.get(componentId);
+        if (!state)
+            return;
+        this.reset(state);
+        this.components.delete(componentId);
+    }
+    /** Reset every component (engine crash/restart/generation swap/shutdown). */
+    resetAll() {
+        for (const state of this.components.values())
+            this.reset(state);
+        this.components.clear();
+    }
+    ensure(componentId) {
+        let state = this.components.get(componentId);
+        if (!state) {
+            state = { mouse: false, autowrapDisabled: false, buffered: [] };
+            this.components.set(componentId, state);
+        }
+        return state;
+    }
+    write(state, control) {
+        const terminal = state.terminal;
+        if (!terminal)
+            return;
+        if (control.kind === "mouse-scroll-tracking") {
+            if (control.enabled === state.mouse)
+                return;
+            state.mouse = control.enabled;
+            terminal.write(control.enabled ? HOST_MOUSE_SCROLL_TRACKING_ON : HOST_MOUSE_SCROLL_TRACKING_OFF);
+            return;
+        }
+        const disabled = !control.enabled;
+        if (disabled === state.autowrapDisabled)
+            return;
+        state.autowrapDisabled = disabled;
+        terminal.write(control.enabled ? HOST_TERMINAL_AUTOWRAP_ON : HOST_TERMINAL_AUTOWRAP_OFF);
+    }
+    reset(state) {
+        const terminal = state.terminal;
+        if (terminal) {
+            if (state.mouse)
+                terminal.write(HOST_MOUSE_SCROLL_TRACKING_OFF);
+            if (state.autowrapDisabled)
+                terminal.write(HOST_TERMINAL_AUTOWRAP_ON);
+        }
+        state.mouse = false;
+        state.autowrapDisabled = false;
+        state.buffered = [];
+    }
+}
+/** Whether a control merely restores a mode's safe default (mouse off / autowrap on). */
+function isDefaultControl(control) {
+    return control.kind === "mouse-scroll-tracking" ? !control.enabled : control.enabled;
+}
+//# sourceMappingURL=terminal-mode-controller.js.map

package/dist/modes/interactive-engine/terminal-mode-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-mode-controller.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/terminal-mode-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EngineTerminalControl } from \"./protocol.ts\";\n\n/**\n * Host-side terminal-mode arbiter for remote custom components.\n *\n * Remote components (running in the engine child) cannot touch the host TTY —\n * their stdout is the JSONL transport, not a terminal. Instead they send typed\n * {@link EngineTerminalControl} intents; this controller owns the concrete\n * escape sequences and applies them to the real host terminal associated with\n * the mounted component. Never a raw byte channel: only the two allowlisted\n * modes below can ever reach the terminal.\n *\n * Guarantees:\n *  - Controls that arrive before the component mounts are buffered and flushed\n *    on mount (the child enables mouse reporting inside the overlay factory,\n *    which runs before the mount `engine_custom_open` on the wire).\n *  - Every mode a component turns on is reset to its safe default when that\n *    component unmounts, or when the whole controller is reset (engine\n *    crash / restart / generation replacement / host shutdown).\n *  - State is component-scoped: a stale child cannot reset or alter a mode\n *    owned by the currently mounted component.\n */\n\nexport const HOST_MOUSE_SCROLL_TRACKING_ON = \"\\x1b[?1000h\\x1b[?1002h\\x1b[?1006h\";\nexport const HOST_MOUSE_SCROLL_TRACKING_OFF = \"\\x1b[?1006l\\x1b[?1002l\\x1b[?1000l\";\nexport const HOST_TERMINAL_AUTOWRAP_ON = \"\\x1b[?7h\";\nexport const HOST_TERMINAL_AUTOWRAP_OFF = \"\\x1b[?7l\";\n\nexport interface HostTerminalWriter {\n\twrite(data: string): void;\n}\n\ninterface ComponentTerminalState {\n\tterminal?: HostTerminalWriter;\n\t/** Component currently has mouse-scroll reporting enabled. */\n\tmouse: boolean;\n\t/** Component currently has autowrap disabled (its non-default state). */\n\tautowrapDisabled: boolean;\n\t/** Controls received before the component mounted. */\n\tbuffered: EngineTerminalControl[];\n}\n\nexport class TerminalModeController {\n\tprivate readonly components = new Map<string, ComponentTerminalState>();\n\n\t/** Apply (or buffer) a typed control for a component. */\n\tapplyControl(componentId: string, control: EngineTerminalControl): void {\n\t\tlet state = this.components.get(componentId);\n\t\tif (!state) {\n\t\t\t// A control from an unmounted (late/stale) component that only restores\n\t\t\t// the default mode has nothing to reset — ignore it rather than leak a\n\t\t\t// dead entry or let a stale child perturb terminal-mode bookkeeping.\n\t\t\tif (isDefaultControl(control)) return;\n\t\t\tstate = this.ensure(componentId);\n\t\t}\n\t\tif (!state.terminal) {\n\t\t\tstate.buffered.push(control);\n\t\t\treturn;\n\t\t}\n\t\tthis.write(state, control);\n\t}\n\n\t/** Register the host terminal for a component and flush buffered controls. */\n\tonMount(componentId: string, terminal: HostTerminalWriter): void {\n\t\tconst state = this.ensure(componentId);\n\t\tstate.terminal = terminal;\n\t\tfor (const control of state.buffered.splice(0)) this.write(state, control);\n\t}\n\n\t/** Reset and forget a single component's terminal modes. */\n\tonUnmount(componentId: string): void {\n\t\tconst state = this.components.get(componentId);\n\t\tif (!state) return;\n\t\tthis.reset(state);\n\t\tthis.components.delete(componentId);\n\t}\n\n\t/** Reset every component (engine crash/restart/generation swap/shutdown). */\n\tresetAll(): void {\n\t\tfor (const state of this.components.values()) this.reset(state);\n\t\tthis.components.clear();\n\t}\n\n\tprivate ensure(componentId: string): ComponentTerminalState {\n\t\tlet state = this.components.get(componentId);\n\t\tif (!state) {\n\t\t\tstate = { mouse: false, autowrapDisabled: false, buffered: [] };\n\t\t\tthis.components.set(componentId, state);\n\t\t}\n\t\treturn state;\n\t}\n\n\tprivate write(state: ComponentTerminalState, control: EngineTerminalControl): void {\n\t\tconst terminal = state.terminal;\n\t\tif (!terminal) return;\n\t\tif (control.kind === \"mouse-scroll-tracking\") {\n\t\t\tif (control.enabled === state.mouse) return;\n\t\t\tstate.mouse = control.enabled;\n\t\t\tterminal.write(control.enabled ? HOST_MOUSE_SCROLL_TRACKING_ON : HOST_MOUSE_SCROLL_TRACKING_OFF);\n\t\t\treturn;\n\t\t}\n\t\tconst disabled = !control.enabled;\n\t\tif (disabled === state.autowrapDisabled) return;\n\t\tstate.autowrapDisabled = disabled;\n\t\tterminal.write(control.enabled ? HOST_TERMINAL_AUTOWRAP_ON : HOST_TERMINAL_AUTOWRAP_OFF);\n\t}\n\n\tprivate reset(state: ComponentTerminalState): void {\n\t\tconst terminal = state.terminal;\n\t\tif (terminal) {\n\t\t\tif (state.mouse) terminal.write(HOST_MOUSE_SCROLL_TRACKING_OFF);\n\t\t\tif (state.autowrapDisabled) terminal.write(HOST_TERMINAL_AUTOWRAP_ON);\n\t\t}\n\t\tstate.mouse = false;\n\t\tstate.autowrapDisabled = false;\n\t\tstate.buffered = [];\n\t}\n}\n\n/** Whether a control merely restores a mode's safe default (mouse off / autowrap on). */\nfunction isDefaultControl(control: EngineTerminalControl): boolean {\n\treturn control.kind === \"mouse-scroll-tracking\" ? !control.enabled : control.enabled;\n}\n"]}

package/dist/modes/rpc/bounded-writer.d.ts

@@ -0,0 +1,27 @@
+import type { Writable } from "node:stream";
+export interface BoundedWriterOptions {
+    maxFrameBytes: number;
+    maxQueuedBytes: number;
+}
+/** A byte-accounted, one-write-at-a-time stream writer with replaceable updates. */
+export declare class BoundedWriter {
+    private readonly critical;
+    private readonly coalesced;
+    private readonly capacityWaiters;
+    private queuedBytes;
+    private pumping;
+    private closedError;
+    private readonly stream;
+    private readonly options;
+    constructor(stream: Writable, options: BoundedWriterOptions);
+    get pendingBytes(): number;
+    write(text: string): Promise<void>;
+    offerLatest(key: string, text: string): boolean;
+    close(error?: Error): void;
+    private frame;
+    private next;
+    private pump;
+    private runPump;
+    private wakeCapacityWaiters;
+}
+//# sourceMappingURL=bounded-writer.d.ts.map

package/dist/modes/rpc/bounded-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-writer.d.ts","sourceRoot":"","sources":["../../../src/modes/rpc/bounded-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAS5C,MAAM,WAAW,oBAAoB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,oFAAoF;AACpF,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAoB;IAEvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAE/C,YACC,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,oBAAoB,EAI7B;IAED,IAAI,YAAY,IAAI,MAAM,CAA6B;IAEjD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvC;IAED,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAW9C;IAED,KAAK,CAAC,KAAK,QAAiC,GAAG,IAAI,CAOlD;IAED,OAAO,CAAC,KAAK;IASb,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,IAAI;YAME,OAAO;IAoBrB,OAAO,CAAC,mBAAmB;CAI3B"}

package/dist/modes/rpc/bounded-writer.js

@@ -0,0 +1,103 @@
+/** A byte-accounted, one-write-at-a-time stream writer with replaceable updates. */
+export class BoundedWriter {
+    constructor(stream, options) {
+        this.critical = [];
+        this.coalesced = new Map();
+        this.capacityWaiters = new Set();
+        this.queuedBytes = 0;
+        this.pumping = false;
+        this.stream = stream;
+        this.options = options;
+    }
+    get pendingBytes() { return this.queuedBytes; }
+    async write(text) {
+        const bytes = this.frame(text);
+        while (!this.closedError && this.queuedBytes + bytes.length > this.options.maxQueuedBytes) {
+            await new Promise((resolve) => this.capacityWaiters.add(resolve));
+        }
+        if (this.closedError)
+            throw this.closedError;
+        await new Promise((resolve, reject) => {
+            this.critical.push({ bytes, resolve, reject });
+            this.queuedBytes += bytes.length;
+            this.pump();
+        });
+    }
+    offerLatest(key, text) {
+        if (this.closedError)
+            return false;
+        const bytes = this.frame(text);
+        const previous = this.coalesced.get(key);
+        const nextBytes = this.queuedBytes - (previous?.bytes.length ?? 0) + bytes.length;
+        if (nextBytes > this.options.maxQueuedBytes)
+            return false;
+        if (previous)
+            this.queuedBytes -= previous.bytes.length;
+        this.coalesced.set(key, { bytes, key });
+        this.queuedBytes += bytes.length;
+        this.pump();
+        return true;
+    }
+    close(error = new Error("RPC writer closed")) {
+        if (this.closedError)
+            return;
+        this.closedError = error;
+        for (const frame of this.critical.splice(0))
+            frame.reject?.(error);
+        this.coalesced.clear();
+        this.queuedBytes = 0;
+        this.wakeCapacityWaiters();
+    }
+    frame(text) {
+        const bytes = Buffer.from(text, "utf8");
+        const payloadBytes = bytes.at(-1) === 0x0a ? bytes.length - 1 : bytes.length;
+        if (payloadBytes > this.options.maxFrameBytes) {
+            throw new Error(`RPC frame exceeds ${this.options.maxFrameBytes} bytes`);
+        }
+        return bytes;
+    }
+    next() {
+        const critical = this.critical.shift();
+        if (critical)
+            return critical;
+        const entry = this.coalesced.entries().next().value;
+        if (!entry)
+            return undefined;
+        this.coalesced.delete(entry[0]);
+        return entry[1];
+    }
+    pump() {
+        if (this.pumping)
+            return;
+        this.pumping = true;
+        void this.runPump();
+    }
+    async runPump() {
+        try {
+            let frame;
+            while (!this.closedError && (frame = this.next())) {
+                this.queuedBytes -= frame.bytes.length;
+                this.wakeCapacityWaiters();
+                await new Promise((resolve, reject) => {
+                    this.stream.write(frame.bytes, (error) => error ? reject(error) : resolve());
+                });
+                frame.resolve?.();
+            }
+        }
+        catch (error) {
+            const failure = error instanceof Error ? error : new Error(String(error));
+            this.close(failure);
+        }
+        finally {
+            this.pumping = false;
+            if (!this.closedError && (this.critical.length > 0 || this.coalesced.size > 0))
+                this.pump();
+        }
+    }
+    wakeCapacityWaiters() {
+        for (const resolve of this.capacityWaiters)
+            resolve();
+        this.capacityWaiters.clear();
+    }
+}
+//# sourceMappingURL=bounded-writer.js.map

package/dist/modes/rpc/bounded-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-writer.js","sourceRoot":"","sources":["../../../src/modes/rpc/bounded-writer.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Writable } from \"node:stream\";\n\ninterface PendingFrame {\n\tbytes: Buffer;\n\tresolve?: () => void;\n\treject?: (error: Error) => void;\n\tkey?: string;\n}\n\nexport interface BoundedWriterOptions {\n\tmaxFrameBytes: number;\n\tmaxQueuedBytes: number;\n}\n\n/** A byte-accounted, one-write-at-a-time stream writer with replaceable updates. */\nexport class BoundedWriter {\n\tprivate readonly critical: PendingFrame[] = [];\n\tprivate readonly coalesced = new Map<string, PendingFrame>();\n\tprivate readonly capacityWaiters = new Set<() => void>();\n\tprivate queuedBytes = 0;\n\tprivate pumping = false;\n\tprivate closedError: Error | undefined;\n\n\tprivate readonly stream: Writable;\n\tprivate readonly options: BoundedWriterOptions;\n\n\tconstructor(\n\t\tstream: Writable,\n\t\toptions: BoundedWriterOptions,\n\t) {\n\t\tthis.stream = stream;\n\t\tthis.options = options;\n\t}\n\n\tget pendingBytes(): number { return this.queuedBytes; }\n\n\tasync write(text: string): Promise<void> {\n\t\tconst bytes = this.frame(text);\n\t\twhile (!this.closedError && this.queuedBytes + bytes.length > this.options.maxQueuedBytes) {\n\t\t\tawait new Promise<void>((resolve) => this.capacityWaiters.add(resolve));\n\t\t}\n\t\tif (this.closedError) throw this.closedError;\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tthis.critical.push({ bytes, resolve, reject });\n\t\t\tthis.queuedBytes += bytes.length;\n\t\t\tthis.pump();\n\t\t});\n\t}\n\n\tofferLatest(key: string, text: string): boolean {\n\t\tif (this.closedError) return false;\n\t\tconst bytes = this.frame(text);\n\t\tconst previous = this.coalesced.get(key);\n\t\tconst nextBytes = this.queuedBytes - (previous?.bytes.length ?? 0) + bytes.length;\n\t\tif (nextBytes > this.options.maxQueuedBytes) return false;\n\t\tif (previous) this.queuedBytes -= previous.bytes.length;\n\t\tthis.coalesced.set(key, { bytes, key });\n\t\tthis.queuedBytes += bytes.length;\n\t\tthis.pump();\n\t\treturn true;\n\t}\n\n\tclose(error = new Error(\"RPC writer closed\")): void {\n\t\tif (this.closedError) return;\n\t\tthis.closedError = error;\n\t\tfor (const frame of this.critical.splice(0)) frame.reject?.(error);\n\t\tthis.coalesced.clear();\n\t\tthis.queuedBytes = 0;\n\t\tthis.wakeCapacityWaiters();\n\t}\n\n\tprivate frame(text: string): Buffer {\n\t\tconst bytes = Buffer.from(text, \"utf8\");\n\t\tconst payloadBytes = bytes.at(-1) === 0x0a ? bytes.length - 1 : bytes.length;\n\t\tif (payloadBytes > this.options.maxFrameBytes) {\n\t\t\tthrow new Error(`RPC frame exceeds ${this.options.maxFrameBytes} bytes`);\n\t\t}\n\t\treturn bytes;\n\t}\n\n\tprivate next(): PendingFrame | undefined {\n\t\tconst critical = this.critical.shift();\n\t\tif (critical) return critical;\n\t\tconst entry = this.coalesced.entries().next().value as [string, PendingFrame] | undefined;\n\t\tif (!entry) return undefined;\n\t\tthis.coalesced.delete(entry[0]);\n\t\treturn entry[1];\n\t}\n\n\tprivate pump(): void {\n\t\tif (this.pumping) return;\n\t\tthis.pumping = true;\n\t\tvoid this.runPump();\n\t}\n\n\tprivate async runPump(): Promise<void> {\n\t\ttry {\n\t\t\tlet frame: PendingFrame | undefined;\n\t\t\twhile (!this.closedError && (frame = this.next())) {\n\t\t\t\tthis.queuedBytes -= frame.bytes.length;\n\t\t\t\tthis.wakeCapacityWaiters();\n\t\t\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\t\t\tthis.stream.write(frame!.bytes, (error) => error ? reject(error) : resolve());\n\t\t\t\t});\n\t\t\t\tframe.resolve?.();\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconst failure = error instanceof Error ? error : new Error(String(error));\n\t\t\tthis.close(failure);\n\t\t} finally {\n\t\t\tthis.pumping = false;\n\t\t\tif (!this.closedError && (this.critical.length > 0 || this.coalesced.size > 0)) this.pump();\n\t\t}\n\t}\n\n\tprivate wakeCapacityWaiters(): void {\n\t\tfor (const resolve of this.capacityWaiters) resolve();\n\t\tthis.capacityWaiters.clear();\n\t}\n}\n"]}

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

@@ -1,17 +1,20 @@
 import type { Readable } from "node:stream";
+/** Serialize one LF-delimited JSON record. */
+export declare function serializeJsonLine(value: object | boolean | null | number | string): string;
+export interface JsonlReaderOptions {
+    maxBytesPerTurn?: number;
+    maxFrameBytes?: number;
+    /** @deprecated Use maxFrameBytes. Retained for source compatibility; measured as UTF-8 bytes. */
+    maxLineChars?: number;
+    maxLinesPerTurn?: number;
+    onOversizedLine?: () => void;
+}
 /**
- * Serialize a single strict JSONL record.
+ * Attach a strict LF-only, UTF-8 byte-bounded JSONL reader.
  *
- * 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.
+ * The stream is paused before queued chunks are drained, so one turn cannot parse
+ * an unbounded number of frames. Oversized records are discarded through their LF;
+ * the next bounded record remains readable.
  */
-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;
+export declare function attachJsonlLineReader(stream: Readable, onLine: (line: string) => void, options?: JsonlReaderOptions): () => void;
 //# sourceMappingURL=jsonl.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../../../src/modes/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"}
+{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../../../src/modes/rpc/jsonl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAE1F;AAED,MAAM,WAAW,kBAAkB;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iGAAiG;IACjG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC9B,OAAO,GAAE,kBAAuB,GAC9B,MAAM,IAAI,CAqGZ"}

package/dist/modes/rpc/jsonl.js

@@ -1,49 +1,123 @@
-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.
- */
+/** Serialize one LF-delimited JSON record. */
 export function serializeJsonLine(value) {
     return `${JSON.stringify(value)}\n`;
 }
 /**
- * Attach an LF-only JSONL reader to a stream.
+ * Attach a strict LF-only, UTF-8 byte-bounded JSONL reader.
  *
- * 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.
+ * The stream is paused before queued chunks are drained, so one turn cannot parse
+ * an unbounded number of frames. Oversized records are discarded through their LF;
+ * the next bounded record remains readable.
  */
-export function attachJsonlLineReader(stream, onLine) {
-    const decoder = new StringDecoder("utf8");
-    let buffer = "";
-    const emitLine = (line) => {
-        onLine(line.endsWith("\r") ? line.slice(0, -1) : line);
+export function attachJsonlLineReader(stream, onLine, options = {}) {
+    const maxFrameBytes = options.maxFrameBytes ?? options.maxLineChars ?? Number.POSITIVE_INFINITY;
+    const maxBytesPerTurn = options.maxBytesPerTurn ?? Number.POSITIVE_INFINITY;
+    const maxLinesPerTurn = options.maxLinesPerTurn ?? Number.POSITIVE_INFINITY;
+    const chunks = [];
+    let frameParts = [];
+    let frameBytes = 0;
+    let discarding = false;
+    let scheduled;
+    let ended = false;
+    let detached = false;
+    const finishFrame = () => {
+        if (discarding) {
+            discarding = false;
+            frameParts = [];
+            frameBytes = 0;
+            return;
+        }
+        const frame = Buffer.concat(frameParts, frameBytes);
+        frameParts = [];
+        frameBytes = 0;
+        const withoutCr = frame.at(-1) === 0x0d ? frame.subarray(0, -1) : frame;
+        onLine(withoutCr.toString("utf8"));
     };
-    const onData = (chunk) => {
-        buffer += typeof chunk === "string" ? chunk : decoder.write(chunk);
-        while (true) {
-            const newlineIndex = buffer.indexOf("\n");
-            if (newlineIndex === -1) {
-                return;
+    const consume = (chunk, byteBudget, lineBudget) => {
+        let offset = 0;
+        let lines = 0;
+        while (offset < chunk.length && offset < byteBudget && lines < lineBudget) {
+            const budgetEnd = Math.min(chunk.length, offset + (byteBudget - offset));
+            const newline = chunk.indexOf(0x0a, offset);
+            const end = newline !== -1 && newline < budgetEnd ? newline : budgetEnd;
+            const part = chunk.subarray(offset, end);
+            if (!discarding && frameBytes + part.length <= maxFrameBytes) {
+                if (part.length > 0)
+                    frameParts.push(part);
+                frameBytes += part.length;
+            }
+            else if (!discarding) {
+                discarding = true;
+                frameParts = [];
+                frameBytes = 0;
+                options.onOversizedLine?.();
+            }
+            offset = end;
+            if (newline === end) {
+                offset += 1;
+                finishFrame();
+                lines += 1;
             }
-            emitLine(buffer.slice(0, newlineIndex));
-            buffer = buffer.slice(newlineIndex + 1);
+            if (end === budgetEnd && newline !== end)
+                break;
         }
+        return { offset, lines };
+    };
+    const schedule = () => {
+        if (!scheduled && !detached)
+            scheduled = setImmediate(drain);
+    };
+    const drain = () => {
+        scheduled = undefined;
+        let bytes = 0;
+        let lines = 0;
+        while (chunks.length > 0 && bytes < maxBytesPerTurn && lines < maxLinesPerTurn) {
+            const chunk = chunks[0];
+            const result = consume(chunk, maxBytesPerTurn - bytes, maxLinesPerTurn - lines);
+            bytes += result.offset;
+            lines += result.lines;
+            if (result.offset === chunk.length)
+                chunks.shift();
+            else {
+                chunks[0] = chunk.subarray(result.offset);
+                break;
+            }
+        }
+        if (chunks.length > 0)
+            schedule();
+        else if (ended) {
+            if (!discarding && frameBytes > 0)
+                finishFrame();
+            frameParts = [];
+            frameBytes = 0;
+        }
+        else
+            stream.resume();
+    };
+    const onData = (chunk) => {
+        stream.pause();
+        chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+        schedule();
     };
     const onEnd = () => {
-        buffer += decoder.end();
-        if (buffer.length > 0) {
-            emitLine(buffer);
-            buffer = "";
+        ended = true;
+        if (scheduled) {
+            clearImmediate(scheduled);
+            scheduled = undefined;
+            drain();
         }
+        else if (chunks.length === 0 && !discarding && frameBytes > 0)
+            finishFrame();
     };
     stream.on("data", onData);
     stream.on("end", onEnd);
     return () => {
+        detached = true;
+        if (scheduled)
+            clearImmediate(scheduled);
         stream.off("data", onData);
         stream.off("end", onEnd);
+        chunks.length = 0;
     };
 }
 //# sourceMappingURL=jsonl.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"jsonl.js","sourceRoot":"","sources":["../../../src/modes/rpc/jsonl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC/C,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAgB,EAAE,MAA8B;IACrF,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE;QACjC,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;IACxD,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,KAAsB,EAAE,EAAE;QACzC,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;IACF,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,GAAG,EAAE;QAClB,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;IACF,CAAC,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;QACX,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC1B,CAAC,CAAC;AACH,CAAC","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"]}
+{"version":3,"file":"jsonl.js","sourceRoot":"","sources":["../../../src/modes/rpc/jsonl.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Readable } from \"node:stream\";\n\n/** Serialize one LF-delimited JSON record. */\nexport function serializeJsonLine(value: object | boolean | null | number | string): string {\n\treturn `${JSON.stringify(value)}\\n`;\n}\n\nexport interface JsonlReaderOptions {\n\tmaxBytesPerTurn?: number;\n\tmaxFrameBytes?: number;\n\t/** @deprecated Use maxFrameBytes. Retained for source compatibility; measured as UTF-8 bytes. */\n\tmaxLineChars?: number;\n\tmaxLinesPerTurn?: number;\n\tonOversizedLine?: () => void;\n}\n\n/**\n * Attach a strict LF-only, UTF-8 byte-bounded JSONL reader.\n *\n * The stream is paused before queued chunks are drained, so one turn cannot parse\n * an unbounded number of frames. Oversized records are discarded through their LF;\n * the next bounded record remains readable.\n */\nexport function attachJsonlLineReader(\n\tstream: Readable,\n\tonLine: (line: string) => void,\n\toptions: JsonlReaderOptions = {},\n): () => void {\n\tconst maxFrameBytes = options.maxFrameBytes ?? options.maxLineChars ?? Number.POSITIVE_INFINITY;\n\tconst maxBytesPerTurn = options.maxBytesPerTurn ?? Number.POSITIVE_INFINITY;\n\tconst maxLinesPerTurn = options.maxLinesPerTurn ?? Number.POSITIVE_INFINITY;\n\tconst chunks: Buffer[] = [];\n\tlet frameParts: Buffer[] = [];\n\tlet frameBytes = 0;\n\tlet discarding = false;\n\tlet scheduled: ReturnType<typeof setImmediate> | undefined;\n\tlet ended = false;\n\tlet detached = false;\n\n\tconst finishFrame = (): void => {\n\t\tif (discarding) {\n\t\t\tdiscarding = false;\n\t\t\tframeParts = [];\n\t\t\tframeBytes = 0;\n\t\t\treturn;\n\t\t}\n\t\tconst frame = Buffer.concat(frameParts, frameBytes);\n\t\tframeParts = [];\n\t\tframeBytes = 0;\n\t\tconst withoutCr = frame.at(-1) === 0x0d ? frame.subarray(0, -1) : frame;\n\t\tonLine(withoutCr.toString(\"utf8\"));\n\t};\n\n\tconst consume = (chunk: Buffer, byteBudget: number, lineBudget: number): { offset: number; lines: number } => {\n\t\tlet offset = 0;\n\t\tlet lines = 0;\n\t\twhile (offset < chunk.length && offset < byteBudget && lines < lineBudget) {\n\t\t\tconst budgetEnd = Math.min(chunk.length, offset + (byteBudget - offset));\n\t\t\tconst newline = chunk.indexOf(0x0a, offset);\n\t\t\tconst end = newline !== -1 && newline < budgetEnd ? newline : budgetEnd;\n\t\t\tconst part = chunk.subarray(offset, end);\n\t\t\tif (!discarding && frameBytes + part.length <= maxFrameBytes) {\n\t\t\t\tif (part.length > 0) frameParts.push(part);\n\t\t\t\tframeBytes += part.length;\n\t\t\t} else if (!discarding) {\n\t\t\t\tdiscarding = true;\n\t\t\t\tframeParts = [];\n\t\t\t\tframeBytes = 0;\n\t\t\t\toptions.onOversizedLine?.();\n\t\t\t}\n\t\t\toffset = end;\n\t\t\tif (newline === end) {\n\t\t\t\toffset += 1;\n\t\t\t\tfinishFrame();\n\t\t\t\tlines += 1;\n\t\t\t}\n\t\t\tif (end === budgetEnd && newline !== end) break;\n\t\t}\n\t\treturn { offset, lines };\n\t};\n\n\tconst schedule = (): void => {\n\t\tif (!scheduled && !detached) scheduled = setImmediate(drain);\n\t};\n\tconst drain = (): void => {\n\t\tscheduled = undefined;\n\t\tlet bytes = 0;\n\t\tlet lines = 0;\n\t\twhile (chunks.length > 0 && bytes < maxBytesPerTurn && lines < maxLinesPerTurn) {\n\t\t\tconst chunk = chunks[0]!;\n\t\t\tconst result = consume(chunk, maxBytesPerTurn - bytes, maxLinesPerTurn - lines);\n\t\t\tbytes += result.offset;\n\t\t\tlines += result.lines;\n\t\t\tif (result.offset === chunk.length) chunks.shift();\n\t\t\telse {\n\t\t\t\tchunks[0] = chunk.subarray(result.offset);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t\tif (chunks.length > 0) schedule();\n\t\telse if (ended) {\n\t\t\tif (!discarding && frameBytes > 0) finishFrame();\n\t\t\tframeParts = [];\n\t\t\tframeBytes = 0;\n\t\t} else stream.resume();\n\t};\n\tconst onData = (chunk: string | Buffer): void => {\n\t\tstream.pause();\n\t\tchunks.push(typeof chunk === \"string\" ? Buffer.from(chunk) : chunk);\n\t\tschedule();\n\t};\n\tconst onEnd = (): void => {\n\t\tended = true;\n\t\tif (scheduled) {\n\t\t\tclearImmediate(scheduled);\n\t\t\tscheduled = undefined;\n\t\t\tdrain();\n\t\t} else if (chunks.length === 0 && !discarding && frameBytes > 0) finishFrame();\n\t};\n\tstream.on(\"data\", onData);\n\tstream.on(\"end\", onEnd);\n\treturn () => {\n\t\tdetached = true;\n\t\tif (scheduled) clearImmediate(scheduled);\n\t\tstream.off(\"data\", onData);\n\t\tstream.off(\"end\", onEnd);\n\t\tchunks.length = 0;\n\t};\n}\n"]}