@code-yeongyu/senpi 2026.7.17 → 2026.7.20

package/dist/modes/interactive/streaming-reveal.d.ts

@@ -0,0 +1,35 @@
+import type { AssistantMessage } from "@earendil-works/pi-ai";
+import type { AssistantMessageComponent } from "./components/assistant-message.ts";
+export declare const MIN_REVEAL_UNITS_PER_SEC = 90;
+export declare const CATCHUP_WINDOW_MS = 267;
+export declare const MIN_SMOOTH_FPS = 30;
+export declare const MAX_SMOOTH_FPS = 120;
+export declare const DEFAULT_SMOOTH_FPS = 60;
+type StreamingRevealComponent = Pick<AssistantMessageComponent, "updateContent">;
+type GraphemeCounter = (index: number, text: string) => number;
+type GraphemeSlicer = (index: number, text: string, units: number) => string;
+export type StreamingRevealControllerOptions = {
+    readonly getSmoothStreaming: () => boolean;
+    readonly getSmoothStreamingFps: () => number;
+    readonly getHideThinkingBlock: () => boolean;
+    readonly requestRender: () => void;
+};
+export declare class BlockUnitCounter {
+    #private;
+    count(index: number, text: string): number;
+    slice(index: number, text: string, units: number): string;
+    reset(): void;
+}
+export declare function visibleUnits(message: AssistantMessage, hideThinking: boolean): number;
+export declare function buildDisplayMessage(target: AssistantMessage, revealed: number, hideThinking: boolean, countOf?: GraphemeCounter, sliceOf?: GraphemeSlicer): AssistantMessage;
+export declare function nextStep(backlog: number, dtMs: number): number;
+export declare class StreamingRevealController {
+    #private;
+    constructor(options: StreamingRevealControllerOptions);
+    begin(component: StreamingRevealComponent, message: AssistantMessage): void;
+    setTarget(message: AssistantMessage): void;
+    resyncVisibility(): void;
+    stop(): void;
+}
+export {};
+//# sourceMappingURL=streaming-reveal.d.ts.map

package/dist/modes/interactive/streaming-reveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-reveal.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/streaming-reveal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAEnF,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAGrC,KAAK,wBAAwB,GAAG,IAAI,CAAC,yBAAyB,EAAE,eAAe,CAAC,CAAC;AACjF,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAC/D,KAAK,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAE7E,MAAM,MAAM,gCAAgC,GAAG;IAC9C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CAAC;IAC3C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,MAAM,CAAC;IAC7C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,OAAO,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;CACnC,CAAC;AAyBF,qBAAa,gBAAgB;;IAI5B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAczC;IAED,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAyBxD;IAED,KAAK,IAAI,IAAI,CAGZ;CACD;AAyBD,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CAErF;AAED,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,OAAO,GAAE,eAAwD,EACjE,OAAO,GAAE,cAAqE,GAC5E,gBAAgB,CAmClB;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED,qBAAa,yBAAyB;;IAiBrC,YAAY,OAAO,EAAE,gCAAgC,EAKpD;IAED,KAAK,CAAC,SAAS,EAAE,wBAAwB,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAM1E;IAED,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAIzC;IAED,gBAAgB,IAAI,IAAI,CAKvB;IAED,IAAI,IAAI,IAAI,CAOX;CA2ED"}

package/dist/modes/interactive/streaming-reveal.js

@@ -0,0 +1,268 @@
+import { getGraphemeSegmenter } from "@earendil-works/pi-tui";
+export const MIN_REVEAL_UNITS_PER_SEC = 90;
+export const CATCHUP_WINDOW_MS = 267;
+export const MIN_SMOOTH_FPS = 30;
+export const MAX_SMOOTH_FPS = 120;
+export const DEFAULT_SMOOTH_FPS = 60;
+function countGraphemesFrom(text, start) {
+    let count = 0;
+    let tailStart = start;
+    for (const segment of getGraphemeSegmenter().segment(start === 0 ? text : text.slice(start))) {
+        count += 1;
+        tailStart = start + segment.index;
+    }
+    return { count, tailStart };
+}
+function segmentFrom(text, start, clusters) {
+    let count = 0;
+    let end = start;
+    let lastStart = start;
+    for (const segment of getGraphemeSegmenter().segment(start === 0 ? text : text.slice(start))) {
+        count += 1;
+        lastStart = start + segment.index;
+        end = lastStart + segment.segment.length;
+        if (count >= clusters)
+            break;
+    }
+    return { count, end, lastStart };
+}
+export class BlockUnitCounter {
+    #entries = new Map();
+    #sliceEntries = new Map();
+    count(index, text) {
+        const entry = this.#entries.get(index);
+        if (entry !== undefined) {
+            if (entry.text === text)
+                return entry.count;
+            if (entry.count > 0 && text.length > entry.text.length && text.startsWith(entry.text)) {
+                const tail = countGraphemesFrom(text, entry.tailStart);
+                const next = { text, count: entry.count - 1 + tail.count, tailStart: tail.tailStart };
+                this.#entries.set(index, next);
+                return next.count;
+            }
+        }
+        const full = countGraphemesFrom(text, 0);
+        this.#entries.set(index, { text, count: full.count, tailStart: full.tailStart });
+        return full.count;
+    }
+    slice(index, text, units) {
+        const wholeUnits = Math.floor(units);
+        if (wholeUnits <= 0 || text.length === 0)
+            return "";
+        const entry = this.#sliceEntries.get(index);
+        if (entry?.text === text && entry.units === wholeUnits) {
+            return entry.end >= text.length ? text : text.slice(0, entry.end);
+        }
+        if (entry !== undefined && (entry.text === text || text.startsWith(entry.text)) && wholeUnits >= entry.units) {
+            const segment = segmentFrom(text, entry.lastStart, wholeUnits - entry.units + 1);
+            this.#sliceEntries.set(index, {
+                text,
+                units: entry.units - 1 + segment.count,
+                end: segment.end,
+                lastStart: segment.lastStart,
+            });
+            return segment.end >= text.length ? text : text.slice(0, segment.end);
+        }
+        const segment = segmentFrom(text, 0, wholeUnits);
+        this.#sliceEntries.set(index, {
+            text,
+            units: segment.count,
+            end: segment.end,
+            lastStart: segment.lastStart,
+        });
+        return segment.end >= text.length ? text : text.slice(0, segment.end);
+    }
+    reset() {
+        this.#entries.clear();
+        this.#sliceEntries.clear();
+    }
+}
+function countGraphemes(text) {
+    return countGraphemesFrom(text, 0).count;
+}
+function sliceGraphemes(text, units) {
+    if (units <= 0 || text.length === 0)
+        return "";
+    const segment = segmentFrom(text, 0, units);
+    return segment.end >= text.length ? text : text.slice(0, segment.end);
+}
+function countVisibleUnits(message, hideThinking, countOf) {
+    let total = 0;
+    for (let index = 0; index < message.content.length; index++) {
+        const block = message.content[index];
+        if (block?.type === "text") {
+            total += countOf(index, block.text);
+        }
+        else if (block?.type === "thinking" && !hideThinking) {
+            total += countOf(index, block.thinking);
+        }
+    }
+    return total;
+}
+export function visibleUnits(message, hideThinking) {
+    return countVisibleUnits(message, hideThinking, (_index, text) => countGraphemes(text));
+}
+export function buildDisplayMessage(target, revealed, hideThinking, countOf = (_index, text) => countGraphemes(text), sliceOf = (_index, text, units) => sliceGraphemes(text, units)) {
+    let remaining = Math.max(0, Math.floor(revealed));
+    const content = [];
+    for (let index = 0; index < target.content.length; index++) {
+        const block = target.content[index];
+        if (!block)
+            continue;
+        if (block.type === "text") {
+            const units = countOf(index, block.text);
+            content.push(remaining <= 0
+                ? block.text.length === 0
+                    ? block
+                    : { ...block, text: "" }
+                : remaining >= units
+                    ? block
+                    : { ...block, text: sliceOf(index, block.text, remaining) });
+            remaining = Math.max(0, remaining - units);
+        }
+        else if (block.type === "thinking" && !hideThinking) {
+            const units = countOf(index, block.thinking);
+            content.push(remaining <= 0
+                ? block.thinking.length === 0
+                    ? block
+                    : { ...block, thinking: "" }
+                : remaining >= units
+                    ? block
+                    : { ...block, thinking: sliceOf(index, block.thinking, remaining) });
+            remaining = Math.max(0, remaining - units);
+        }
+        else {
+            content.push(block);
+        }
+    }
+    return { ...target, content };
+}
+export function nextStep(backlog, dtMs) {
+    if (backlog <= 0)
+        return 0;
+    const dt = Math.min(Math.max(dtMs, 1), 100);
+    const minStep = Math.max(1, Math.round((MIN_REVEAL_UNITS_PER_SEC * dt) / 1000));
+    const catchup = Math.ceil((backlog * dt) / CATCHUP_WINDOW_MS);
+    return Math.min(backlog, Math.max(minStep, catchup));
+}
+export class StreamingRevealController {
+    #getSmoothStreaming;
+    #getSmoothStreamingFps;
+    #getHideThinkingBlock;
+    #requestRender;
+    #unitCounter = new BlockUnitCounter();
+    #countOf = (index, text) => this.#unitCounter.count(index, text);
+    #sliceOf = (index, text, units) => this.#unitCounter.slice(index, text, units);
+    #target;
+    #component;
+    #timer;
+    #timerFps;
+    #revealed = 0;
+    #lastTickAt = 0;
+    #hideThinkingBlock = false;
+    constructor(options) {
+        this.#getSmoothStreaming = options.getSmoothStreaming;
+        this.#getSmoothStreamingFps = options.getSmoothStreamingFps;
+        this.#getHideThinkingBlock = options.getHideThinkingBlock;
+        this.#requestRender = options.requestRender;
+    }
+    begin(component, message) {
+        this.stop();
+        this.#component = component;
+        this.#target = message;
+        this.#hideThinkingBlock = this.#getHideThinkingBlock();
+        this.#applyTarget();
+    }
+    setTarget(message) {
+        this.#target = message;
+        this.#hideThinkingBlock = this.#getHideThinkingBlock();
+        if (this.#component)
+            this.#applyTarget();
+    }
+    resyncVisibility() {
+        if (!this.#target || !this.#component)
+            return;
+        this.#hideThinkingBlock = this.#getHideThinkingBlock();
+        this.#revealed = Math.min(this.#revealed, this.#visibleUnits(this.#target));
+        this.#applyTarget();
+    }
+    stop() {
+        this.#stopTimer();
+        this.#target = undefined;
+        this.#component = undefined;
+        this.#revealed = 0;
+        this.#lastTickAt = 0;
+        this.#unitCounter.reset();
+    }
+    #applyTarget() {
+        const target = this.#target;
+        const component = this.#component;
+        if (!target || !component)
+            return;
+        const total = this.#visibleUnits(target);
+        if (!this.#getSmoothStreaming() || target.content.some((block) => block.type === "toolCall")) {
+            this.#revealed = total;
+            this.#stopTimer();
+            component.updateContent(target);
+            return;
+        }
+        this.#revealed = Math.min(this.#revealed, total);
+        this.#renderCurrent();
+        this.#syncTimer(total);
+    }
+    #visibleUnits(message) {
+        return countVisibleUnits(message, this.#hideThinkingBlock, this.#countOf);
+    }
+    #renderCurrent() {
+        if (!this.#target || !this.#component)
+            return;
+        this.#component.updateContent(buildDisplayMessage(this.#target, this.#revealed, this.#hideThinkingBlock, this.#countOf, this.#sliceOf));
+    }
+    #syncTimer(total) {
+        if (this.#revealed >= total) {
+            this.#stopTimer();
+            return;
+        }
+        this.#startTimer();
+    }
+    #startTimer() {
+        const configuredFps = this.#getSmoothStreamingFps();
+        const fps = Number.isFinite(configuredFps)
+            ? Math.min(MAX_SMOOTH_FPS, Math.max(MIN_SMOOTH_FPS, configuredFps))
+            : DEFAULT_SMOOTH_FPS;
+        if (this.#timer && this.#timerFps === fps)
+            return;
+        this.#stopTimer();
+        this.#lastTickAt = performance.now();
+        const timer = setInterval(() => this.#tick(), 1000 / fps);
+        timer.unref();
+        this.#timer = timer;
+        this.#timerFps = fps;
+    }
+    #stopTimer() {
+        if (this.#timer)
+            clearInterval(this.#timer);
+        this.#timer = undefined;
+        this.#timerFps = undefined;
+    }
+    #tick() {
+        const target = this.#target;
+        if (!target || !this.#component) {
+            this.stop();
+            return;
+        }
+        const total = this.#visibleUnits(target);
+        if (this.#revealed >= total) {
+            this.#stopTimer();
+            return;
+        }
+        const now = performance.now();
+        this.#revealed = Math.min(total, this.#revealed + nextStep(total - this.#revealed, now - this.#lastTickAt));
+        this.#lastTickAt = now;
+        this.#renderCurrent();
+        this.#requestRender();
+        if (this.#revealed >= total)
+            this.#stopTimer();
+    }
+}
+//# sourceMappingURL=streaming-reveal.js.map

package/dist/modes/interactive/streaming-reveal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-reveal.js","sourceRoot":"","sources":["../../../src/modes/interactive/streaming-reveal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAcrC,SAAS,kBAAkB,CAAC,IAAY,EAAE,KAAa;IACtD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC9F,KAAK,IAAI,CAAC,CAAC;QACX,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IACnC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa,EAAE,QAAgB;IACjE,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC9F,KAAK,IAAI,CAAC,CAAC;QACX,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAClC,GAAG,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QACzC,IAAI,KAAK,IAAI,QAAQ;YAAE,MAAM;IAC9B,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,OAAO,gBAAgB;IACnB,QAAQ,GAAG,IAAI,GAAG,EAA8D,CAAC;IACjF,aAAa,GAAG,IAAI,GAAG,EAA2E,CAAC;IAE5G,KAAK,CAAC,KAAa,EAAE,IAAY;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC,KAAK,CAAC;YAC5C,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvF,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;gBACvD,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACtF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBAC/B,OAAO,IAAI,CAAC,KAAK,CAAC;YACnB,CAAC;QACF,CAAC;QACD,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACjF,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,KAAa,EAAE,IAAY,EAAE,KAAa;QAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,UAAU,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,KAAK,EAAE,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,UAAU,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC9G,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,UAAU,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACjF,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE;gBAC7B,IAAI;gBACJ,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK;gBACtC,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,SAAS,EAAE,OAAO,CAAC,SAAS;aAC5B,CAAC,CAAC;YACH,OAAO,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;QACjD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE;YAC7B,IAAI;YACJ,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC5B,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACvE,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACD;AAED,SAAS,cAAc,CAAC,IAAY;IACnC,OAAO,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1C,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,KAAa;IAClD,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAyB,EAAE,YAAqB,EAAE,OAAwB;IACpG,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,KAAK,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;aAAM,IAAI,KAAK,EAAE,IAAI,KAAK,UAAU,IAAI,CAAC,YAAY,EAAE,CAAC;YACxD,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAyB,EAAE,YAAqB;IAC5E,OAAO,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAClC,MAAwB,EACxB,QAAgB,EAChB,YAAqB,EACrB,OAAO,GAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,EACjE,OAAO,GAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC;IAE9E,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClD,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CACX,SAAS,IAAI,CAAC;gBACb,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;oBACxB,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;gBACzB,CAAC,CAAC,SAAS,IAAI,KAAK;oBACnB,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAC7D,CAAC;YACF,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,YAAY,EAAE,CAAC;YACvD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC7C,OAAO,CAAC,IAAI,CACX,SAAS,IAAI,CAAC;gBACb,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;oBAC5B,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE;gBAC7B,CAAC,CAAC,SAAS,IAAI,KAAK;oBACnB,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CACrE,CAAC;YACF,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACF,CAAC;IACD,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,IAAY;IACrD,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,wBAAwB,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,OAAO,yBAAyB;IAC5B,mBAAmB,CAAgB;IACnC,sBAAsB,CAAe;IACrC,qBAAqB,CAAgB;IACrC,cAAc,CAAa;IAC3B,YAAY,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACtC,QAAQ,GAAG,CAAC,KAAa,EAAE,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACzF,QAAQ,GAAG,CAAC,KAAa,EAAE,IAAY,EAAE,KAAa,EAAU,EAAE,CAC1E,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7C,OAAO,CAA+B;IACtC,UAAU,CAAuC;IACjD,MAAM,CAA6B;IACnC,SAAS,CAAqB;IAC9B,SAAS,GAAG,CAAC,CAAC;IACd,WAAW,GAAG,CAAC,CAAC;IAChB,kBAAkB,GAAG,KAAK,CAAC;IAE3B,YAAY,OAAyC;QACpD,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;QACtD,IAAI,CAAC,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;QAC5D,IAAI,CAAC,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;QAC1D,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,SAAmC,EAAE,OAAyB;QACnE,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACvD,IAAI,CAAC,YAAY,EAAE,CAAC;IACrB,CAAC;IAED,SAAS,CAAC,OAAyB;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACvD,IAAI,IAAI,CAAC,UAAU;YAAE,IAAI,CAAC,YAAY,EAAE,CAAC;IAC1C,CAAC;IAED,gBAAgB;QACf,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO;QAC9C,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACvD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC,YAAY,EAAE,CAAC;IACrB,CAAC;IAED,IAAI;QACH,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,YAAY;QACX,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS;YAAE,OAAO;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,EAAE,CAAC;YAC9F,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAChC,OAAO;QACR,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,aAAa,CAAC,OAAyB;QACtC,OAAO,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3E,CAAC;IAED,cAAc;QACb,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO;QAC9C,IAAI,CAAC,UAAU,CAAC,aAAa,CAC5B,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CACxG,CAAC;IACH,CAAC;IAED,UAAU,CAAC,KAAa;QACvB,IAAI,IAAI,CAAC,SAAS,IAAI,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,OAAO;QACR,CAAC;QACD,IAAI,CAAC,WAAW,EAAE,CAAC;IACpB,CAAC;IAED,WAAW;QACV,MAAM,aAAa,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;YACzC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;YACnE,CAAC,CAAC,kBAAkB,CAAC;QACtB,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,KAAK,GAAG;YAAE,OAAO;QAClD,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;QAC1D,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;IACtB,CAAC;IAED,UAAU;QACT,IAAI,IAAI,CAAC,MAAM;YAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5B,CAAC;IAED,KAAK;QACJ,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO;QACR,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,IAAI,CAAC,SAAS,IAAI,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,OAAO;QACR,CAAC;QACD,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QAC5G,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;QACvB,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,IAAI,CAAC,SAAS,IAAI,KAAK;YAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IAChD,CAAC;CACD","sourcesContent":["import type { AssistantMessage } from \"@earendil-works/pi-ai\";\nimport { getGraphemeSegmenter } from \"@earendil-works/pi-tui\";\nimport type { AssistantMessageComponent } from \"./components/assistant-message.ts\";\n\nexport const MIN_REVEAL_UNITS_PER_SEC = 90;\nexport const CATCHUP_WINDOW_MS = 267;\nexport const MIN_SMOOTH_FPS = 30;\nexport const MAX_SMOOTH_FPS = 120;\nexport const DEFAULT_SMOOTH_FPS = 60;\n\ntype AssistantContentBlock = AssistantMessage[\"content\"][number];\ntype StreamingRevealComponent = Pick<AssistantMessageComponent, \"updateContent\">;\ntype GraphemeCounter = (index: number, text: string) => number;\ntype GraphemeSlicer = (index: number, text: string, units: number) => string;\n\nexport type StreamingRevealControllerOptions = {\n\treadonly getSmoothStreaming: () => boolean;\n\treadonly getSmoothStreamingFps: () => number;\n\treadonly getHideThinkingBlock: () => boolean;\n\treadonly requestRender: () => void;\n};\n\nfunction countGraphemesFrom(text: string, start: number): { count: number; tailStart: number } {\n\tlet count = 0;\n\tlet tailStart = start;\n\tfor (const segment of getGraphemeSegmenter().segment(start === 0 ? text : text.slice(start))) {\n\t\tcount += 1;\n\t\ttailStart = start + segment.index;\n\t}\n\treturn { count, tailStart };\n}\n\nfunction segmentFrom(text: string, start: number, clusters: number): { count: number; end: number; lastStart: number } {\n\tlet count = 0;\n\tlet end = start;\n\tlet lastStart = start;\n\tfor (const segment of getGraphemeSegmenter().segment(start === 0 ? text : text.slice(start))) {\n\t\tcount += 1;\n\t\tlastStart = start + segment.index;\n\t\tend = lastStart + segment.segment.length;\n\t\tif (count >= clusters) break;\n\t}\n\treturn { count, end, lastStart };\n}\n\nexport class BlockUnitCounter {\n\treadonly #entries = new Map<number, { text: string; count: number; tailStart: number }>();\n\treadonly #sliceEntries = new Map<number, { text: string; units: number; end: number; lastStart: number }>();\n\n\tcount(index: number, text: string): number {\n\t\tconst entry = this.#entries.get(index);\n\t\tif (entry !== undefined) {\n\t\t\tif (entry.text === text) return entry.count;\n\t\t\tif (entry.count > 0 && text.length > entry.text.length && text.startsWith(entry.text)) {\n\t\t\t\tconst tail = countGraphemesFrom(text, entry.tailStart);\n\t\t\t\tconst next = { text, count: entry.count - 1 + tail.count, tailStart: tail.tailStart };\n\t\t\t\tthis.#entries.set(index, next);\n\t\t\t\treturn next.count;\n\t\t\t}\n\t\t}\n\t\tconst full = countGraphemesFrom(text, 0);\n\t\tthis.#entries.set(index, { text, count: full.count, tailStart: full.tailStart });\n\t\treturn full.count;\n\t}\n\n\tslice(index: number, text: string, units: number): string {\n\t\tconst wholeUnits = Math.floor(units);\n\t\tif (wholeUnits <= 0 || text.length === 0) return \"\";\n\t\tconst entry = this.#sliceEntries.get(index);\n\t\tif (entry?.text === text && entry.units === wholeUnits) {\n\t\t\treturn entry.end >= text.length ? text : text.slice(0, entry.end);\n\t\t}\n\t\tif (entry !== undefined && (entry.text === text || text.startsWith(entry.text)) && wholeUnits >= entry.units) {\n\t\t\tconst segment = segmentFrom(text, entry.lastStart, wholeUnits - entry.units + 1);\n\t\t\tthis.#sliceEntries.set(index, {\n\t\t\t\ttext,\n\t\t\t\tunits: entry.units - 1 + segment.count,\n\t\t\t\tend: segment.end,\n\t\t\t\tlastStart: segment.lastStart,\n\t\t\t});\n\t\t\treturn segment.end >= text.length ? text : text.slice(0, segment.end);\n\t\t}\n\t\tconst segment = segmentFrom(text, 0, wholeUnits);\n\t\tthis.#sliceEntries.set(index, {\n\t\t\ttext,\n\t\t\tunits: segment.count,\n\t\t\tend: segment.end,\n\t\t\tlastStart: segment.lastStart,\n\t\t});\n\t\treturn segment.end >= text.length ? text : text.slice(0, segment.end);\n\t}\n\n\treset(): void {\n\t\tthis.#entries.clear();\n\t\tthis.#sliceEntries.clear();\n\t}\n}\n\nfunction countGraphemes(text: string): number {\n\treturn countGraphemesFrom(text, 0).count;\n}\n\nfunction sliceGraphemes(text: string, units: number): string {\n\tif (units <= 0 || text.length === 0) return \"\";\n\tconst segment = segmentFrom(text, 0, units);\n\treturn segment.end >= text.length ? text : text.slice(0, segment.end);\n}\n\nfunction countVisibleUnits(message: AssistantMessage, hideThinking: boolean, countOf: GraphemeCounter): number {\n\tlet total = 0;\n\tfor (let index = 0; index < message.content.length; index++) {\n\t\tconst block = message.content[index];\n\t\tif (block?.type === \"text\") {\n\t\t\ttotal += countOf(index, block.text);\n\t\t} else if (block?.type === \"thinking\" && !hideThinking) {\n\t\t\ttotal += countOf(index, block.thinking);\n\t\t}\n\t}\n\treturn total;\n}\n\nexport function visibleUnits(message: AssistantMessage, hideThinking: boolean): number {\n\treturn countVisibleUnits(message, hideThinking, (_index, text) => countGraphemes(text));\n}\n\nexport function buildDisplayMessage(\n\ttarget: AssistantMessage,\n\trevealed: number,\n\thideThinking: boolean,\n\tcountOf: GraphemeCounter = (_index, text) => countGraphemes(text),\n\tsliceOf: GraphemeSlicer = (_index, text, units) => sliceGraphemes(text, units),\n): AssistantMessage {\n\tlet remaining = Math.max(0, Math.floor(revealed));\n\tconst content: AssistantContentBlock[] = [];\n\tfor (let index = 0; index < target.content.length; index++) {\n\t\tconst block = target.content[index];\n\t\tif (!block) continue;\n\t\tif (block.type === \"text\") {\n\t\t\tconst units = countOf(index, block.text);\n\t\t\tcontent.push(\n\t\t\t\tremaining <= 0\n\t\t\t\t\t? block.text.length === 0\n\t\t\t\t\t\t? block\n\t\t\t\t\t\t: { ...block, text: \"\" }\n\t\t\t\t\t: remaining >= units\n\t\t\t\t\t\t? block\n\t\t\t\t\t\t: { ...block, text: sliceOf(index, block.text, remaining) },\n\t\t\t);\n\t\t\tremaining = Math.max(0, remaining - units);\n\t\t} else if (block.type === \"thinking\" && !hideThinking) {\n\t\t\tconst units = countOf(index, block.thinking);\n\t\t\tcontent.push(\n\t\t\t\tremaining <= 0\n\t\t\t\t\t? block.thinking.length === 0\n\t\t\t\t\t\t? block\n\t\t\t\t\t\t: { ...block, thinking: \"\" }\n\t\t\t\t\t: remaining >= units\n\t\t\t\t\t\t? block\n\t\t\t\t\t\t: { ...block, thinking: sliceOf(index, block.thinking, remaining) },\n\t\t\t);\n\t\t\tremaining = Math.max(0, remaining - units);\n\t\t} else {\n\t\t\tcontent.push(block);\n\t\t}\n\t}\n\treturn { ...target, content };\n}\n\nexport function nextStep(backlog: number, dtMs: number): number {\n\tif (backlog <= 0) return 0;\n\tconst dt = Math.min(Math.max(dtMs, 1), 100);\n\tconst minStep = Math.max(1, Math.round((MIN_REVEAL_UNITS_PER_SEC * dt) / 1000));\n\tconst catchup = Math.ceil((backlog * dt) / CATCHUP_WINDOW_MS);\n\treturn Math.min(backlog, Math.max(minStep, catchup));\n}\n\nexport class StreamingRevealController {\n\treadonly #getSmoothStreaming: () => boolean;\n\treadonly #getSmoothStreamingFps: () => number;\n\treadonly #getHideThinkingBlock: () => boolean;\n\treadonly #requestRender: () => void;\n\treadonly #unitCounter = new BlockUnitCounter();\n\treadonly #countOf = (index: number, text: string): number => this.#unitCounter.count(index, text);\n\treadonly #sliceOf = (index: number, text: string, units: number): string =>\n\t\tthis.#unitCounter.slice(index, text, units);\n\t#target: AssistantMessage | undefined;\n\t#component: StreamingRevealComponent | undefined;\n\t#timer: NodeJS.Timeout | undefined;\n\t#timerFps: number | undefined;\n\t#revealed = 0;\n\t#lastTickAt = 0;\n\t#hideThinkingBlock = false;\n\n\tconstructor(options: StreamingRevealControllerOptions) {\n\t\tthis.#getSmoothStreaming = options.getSmoothStreaming;\n\t\tthis.#getSmoothStreamingFps = options.getSmoothStreamingFps;\n\t\tthis.#getHideThinkingBlock = options.getHideThinkingBlock;\n\t\tthis.#requestRender = options.requestRender;\n\t}\n\n\tbegin(component: StreamingRevealComponent, message: AssistantMessage): void {\n\t\tthis.stop();\n\t\tthis.#component = component;\n\t\tthis.#target = message;\n\t\tthis.#hideThinkingBlock = this.#getHideThinkingBlock();\n\t\tthis.#applyTarget();\n\t}\n\n\tsetTarget(message: AssistantMessage): void {\n\t\tthis.#target = message;\n\t\tthis.#hideThinkingBlock = this.#getHideThinkingBlock();\n\t\tif (this.#component) this.#applyTarget();\n\t}\n\n\tresyncVisibility(): void {\n\t\tif (!this.#target || !this.#component) return;\n\t\tthis.#hideThinkingBlock = this.#getHideThinkingBlock();\n\t\tthis.#revealed = Math.min(this.#revealed, this.#visibleUnits(this.#target));\n\t\tthis.#applyTarget();\n\t}\n\n\tstop(): void {\n\t\tthis.#stopTimer();\n\t\tthis.#target = undefined;\n\t\tthis.#component = undefined;\n\t\tthis.#revealed = 0;\n\t\tthis.#lastTickAt = 0;\n\t\tthis.#unitCounter.reset();\n\t}\n\n\t#applyTarget(): void {\n\t\tconst target = this.#target;\n\t\tconst component = this.#component;\n\t\tif (!target || !component) return;\n\t\tconst total = this.#visibleUnits(target);\n\t\tif (!this.#getSmoothStreaming() || target.content.some((block) => block.type === \"toolCall\")) {\n\t\t\tthis.#revealed = total;\n\t\t\tthis.#stopTimer();\n\t\t\tcomponent.updateContent(target);\n\t\t\treturn;\n\t\t}\n\t\tthis.#revealed = Math.min(this.#revealed, total);\n\t\tthis.#renderCurrent();\n\t\tthis.#syncTimer(total);\n\t}\n\n\t#visibleUnits(message: AssistantMessage): number {\n\t\treturn countVisibleUnits(message, this.#hideThinkingBlock, this.#countOf);\n\t}\n\n\t#renderCurrent(): void {\n\t\tif (!this.#target || !this.#component) return;\n\t\tthis.#component.updateContent(\n\t\t\tbuildDisplayMessage(this.#target, this.#revealed, this.#hideThinkingBlock, this.#countOf, this.#sliceOf),\n\t\t);\n\t}\n\n\t#syncTimer(total: number): void {\n\t\tif (this.#revealed >= total) {\n\t\t\tthis.#stopTimer();\n\t\t\treturn;\n\t\t}\n\t\tthis.#startTimer();\n\t}\n\n\t#startTimer(): void {\n\t\tconst configuredFps = this.#getSmoothStreamingFps();\n\t\tconst fps = Number.isFinite(configuredFps)\n\t\t\t? Math.min(MAX_SMOOTH_FPS, Math.max(MIN_SMOOTH_FPS, configuredFps))\n\t\t\t: DEFAULT_SMOOTH_FPS;\n\t\tif (this.#timer && this.#timerFps === fps) return;\n\t\tthis.#stopTimer();\n\t\tthis.#lastTickAt = performance.now();\n\t\tconst timer = setInterval(() => this.#tick(), 1000 / fps);\n\t\ttimer.unref();\n\t\tthis.#timer = timer;\n\t\tthis.#timerFps = fps;\n\t}\n\n\t#stopTimer(): void {\n\t\tif (this.#timer) clearInterval(this.#timer);\n\t\tthis.#timer = undefined;\n\t\tthis.#timerFps = undefined;\n\t}\n\n\t#tick(): void {\n\t\tconst target = this.#target;\n\t\tif (!target || !this.#component) {\n\t\t\tthis.stop();\n\t\t\treturn;\n\t\t}\n\t\tconst total = this.#visibleUnits(target);\n\t\tif (this.#revealed >= total) {\n\t\t\tthis.#stopTimer();\n\t\t\treturn;\n\t\t}\n\t\tconst now = performance.now();\n\t\tthis.#revealed = Math.min(total, this.#revealed + nextStep(total - this.#revealed, now - this.#lastTickAt));\n\t\tthis.#lastTickAt = now;\n\t\tthis.#renderCurrent();\n\t\tthis.#requestRender();\n\t\tif (this.#revealed >= total) this.#stopTimer();\n\t}\n}\n"]}

package/dist/modes/interactive/tool-args-reveal.d.ts

@@ -0,0 +1,20 @@
+import type { ToolExecutionComponent } from "./components/tool-execution.ts";
+export declare const MIN_TOOL_ARGS_PARSE_DELTA = 64;
+type ToolArgsRevealComponent = Pick<ToolExecutionComponent, "updateArgs">;
+export type ToolArgsRevealControllerOptions = {
+    readonly getSmoothStreaming: () => boolean;
+    readonly getSmoothStreamingFps: () => number;
+    readonly requestRender: () => void;
+};
+export declare class ToolArgsRevealController {
+    #private;
+    constructor(options: ToolArgsRevealControllerOptions);
+    update(id: string, component: ToolArgsRevealComponent, partialJson: string): boolean;
+    flush(id: string, exactArgs: unknown): boolean;
+    flushAll(): void;
+    finish(id: string): void;
+    refresh(): void;
+    stop(): void;
+}
+export {};
+//# sourceMappingURL=tool-args-reveal.d.ts.map

package/dist/modes/interactive/tool-args-reveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-args-reveal.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/tool-args-reveal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAG7E,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,KAAK,uBAAuB,GAAG,IAAI,CAAC,sBAAsB,EAAE,YAAY,CAAC,CAAC;AAU1E,MAAM,MAAM,+BAA+B,GAAG;IAC7C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CAAC;IAC3C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,MAAM,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;CACnC,CAAC;AAeF,qBAAa,wBAAwB;;IAQpC,YAAY,OAAO,EAAE,+BAA+B,EAInD;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CA2BnF;IAED,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAO7C;IAED,QAAQ,IAAI,IAAI,CAMf;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAGvB;IAED,OAAO,IAAI,IAAI,CAUd;IAED,IAAI,IAAI,IAAI,CAGX;CAkED"}

package/dist/modes/interactive/tool-args-reveal.js

@@ -0,0 +1,153 @@
+import { parseStreamingJson } from "@earendil-works/pi-ai";
+import { DEFAULT_SMOOTH_FPS, MAX_SMOOTH_FPS, MIN_SMOOTH_FPS, nextStep } from "./streaming-reveal.js";
+export const MIN_TOOL_ARGS_PARSE_DELTA = 64;
+function isHighSurrogate(code) {
+    return code >= 0xd800 && code <= 0xdbff;
+}
+function isLowSurrogate(code) {
+    return code >= 0xdc00 && code <= 0xdfff;
+}
+function advancePastSurrogateBoundary(text, end) {
+    if (end <= 0 || end >= text.length)
+        return end;
+    return isHighSurrogate(text.charCodeAt(end - 1)) && isLowSurrogate(text.charCodeAt(end)) ? end + 1 : end;
+}
+export class ToolArgsRevealController {
+    #getSmoothStreaming;
+    #getSmoothStreamingFps;
+    #requestRender;
+    #states = new Map();
+    #timer;
+    #timerFps;
+    constructor(options) {
+        this.#getSmoothStreaming = options.getSmoothStreaming;
+        this.#getSmoothStreamingFps = options.getSmoothStreamingFps;
+        this.#requestRender = options.requestRender;
+    }
+    update(id, component, partialJson) {
+        if (!this.#getSmoothStreaming() || partialJson.length === 0) {
+            this.finish(id);
+            return false;
+        }
+        const existing = this.#states.get(id);
+        if (existing === undefined || existing.component !== component || !partialJson.startsWith(existing.target)) {
+            component.updateArgs(parseStreamingJson(partialJson));
+            this.#states.set(id, {
+                component,
+                target: partialJson,
+                revealed: partialJson.length,
+                rendered: partialJson.length,
+                lastTickAt: performance.now(),
+            });
+            this.#syncTimer();
+            return true;
+        }
+        const wasCaughtUp = existing.revealed >= existing.target.length;
+        existing.target = partialJson;
+        if (wasCaughtUp && existing.revealed < partialJson.length) {
+            existing.lastTickAt = performance.now();
+        }
+        this.#syncTimer();
+        return true;
+    }
+    flush(id, exactArgs) {
+        const state = this.#states.get(id);
+        if (state === undefined)
+            return false;
+        state.component.updateArgs(exactArgs);
+        this.#states.delete(id);
+        this.#syncTimer();
+        return true;
+    }
+    flushAll() {
+        for (const state of this.#states.values()) {
+            state.component.updateArgs(parseStreamingJson(state.target));
+        }
+        this.#states.clear();
+        this.#stopTimer();
+    }
+    finish(id) {
+        if (!this.#states.delete(id))
+            return;
+        this.#syncTimer();
+    }
+    refresh() {
+        if (!this.#getSmoothStreaming()) {
+            this.flushAll();
+            return;
+        }
+        if (!this.#hasBacklog()) {
+            this.#stopTimer();
+            return;
+        }
+        this.#startTimer(true);
+    }
+    stop() {
+        this.#stopTimer();
+        this.#states.clear();
+    }
+    #syncTimer() {
+        if (!this.#hasBacklog()) {
+            this.#stopTimer();
+            return;
+        }
+        this.#startTimer(false);
+    }
+    #hasBacklog() {
+        for (const state of this.#states.values()) {
+            if (state.revealed < state.target.length)
+                return true;
+        }
+        return false;
+    }
+    #startTimer(restart) {
+        const configuredFps = this.#getSmoothStreamingFps();
+        const fps = Number.isFinite(configuredFps)
+            ? Math.min(MAX_SMOOTH_FPS, Math.max(MIN_SMOOTH_FPS, configuredFps))
+            : DEFAULT_SMOOTH_FPS;
+        if (!restart && this.#timer !== undefined && this.#timerFps === fps)
+            return;
+        this.#stopTimer();
+        const now = performance.now();
+        for (const state of this.#states.values()) {
+            if (state.revealed < state.target.length)
+                state.lastTickAt = now;
+        }
+        const timer = setInterval(() => this.#tick(), 1000 / fps);
+        timer.unref();
+        this.#timer = timer;
+        this.#timerFps = fps;
+    }
+    #stopTimer() {
+        if (this.#timer !== undefined)
+            clearInterval(this.#timer);
+        this.#timer = undefined;
+        this.#timerFps = undefined;
+    }
+    #tick() {
+        if (!this.#getSmoothStreaming()) {
+            this.flushAll();
+            this.#requestRender();
+            return;
+        }
+        const now = performance.now();
+        let rendered = false;
+        for (const state of this.#states.values()) {
+            const backlog = state.target.length - state.revealed;
+            if (backlog <= 0)
+                continue;
+            const step = nextStep(backlog, now - state.lastTickAt);
+            state.revealed = advancePastSurrogateBoundary(state.target, Math.min(state.target.length, state.revealed + step));
+            state.lastTickAt = now;
+            if (state.revealed - state.rendered < MIN_TOOL_ARGS_PARSE_DELTA)
+                continue;
+            state.component.updateArgs(parseStreamingJson(state.target.slice(0, state.revealed)));
+            state.rendered = state.revealed;
+            rendered = true;
+        }
+        if (rendered)
+            this.#requestRender();
+        this.#syncTimer();
+    }
+}
+//# sourceMappingURL=tool-args-reveal.js.map

package/dist/modes/interactive/tool-args-reveal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-args-reveal.js","sourceRoot":"","sources":["../../../src/modes/interactive/tool-args-reveal.ts"],"names":[],"mappings":"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","sourcesContent":["import { parseStreamingJson } from \"@earendil-works/pi-ai\";\nimport type { ToolExecutionComponent } from \"./components/tool-execution.ts\";\nimport { DEFAULT_SMOOTH_FPS, MAX_SMOOTH_FPS, MIN_SMOOTH_FPS, nextStep } from \"./streaming-reveal.ts\";\n\nexport const MIN_TOOL_ARGS_PARSE_DELTA = 64;\n\ntype ToolArgsRevealComponent = Pick<ToolExecutionComponent, \"updateArgs\">;\n\ntype ToolArgsRevealState = {\n\tcomponent: ToolArgsRevealComponent;\n\ttarget: string;\n\trevealed: number;\n\trendered: number;\n\tlastTickAt: number;\n};\n\nexport type ToolArgsRevealControllerOptions = {\n\treadonly getSmoothStreaming: () => boolean;\n\treadonly getSmoothStreamingFps: () => number;\n\treadonly requestRender: () => void;\n};\n\nfunction isHighSurrogate(code: number): boolean {\n\treturn code >= 0xd800 && code <= 0xdbff;\n}\n\nfunction isLowSurrogate(code: number): boolean {\n\treturn code >= 0xdc00 && code <= 0xdfff;\n}\n\nfunction advancePastSurrogateBoundary(text: string, end: number): number {\n\tif (end <= 0 || end >= text.length) return end;\n\treturn isHighSurrogate(text.charCodeAt(end - 1)) && isLowSurrogate(text.charCodeAt(end)) ? end + 1 : end;\n}\n\nexport class ToolArgsRevealController {\n\treadonly #getSmoothStreaming: () => boolean;\n\treadonly #getSmoothStreamingFps: () => number;\n\treadonly #requestRender: () => void;\n\treadonly #states = new Map<string, ToolArgsRevealState>();\n\t#timer: NodeJS.Timeout | undefined;\n\t#timerFps: number | undefined;\n\n\tconstructor(options: ToolArgsRevealControllerOptions) {\n\t\tthis.#getSmoothStreaming = options.getSmoothStreaming;\n\t\tthis.#getSmoothStreamingFps = options.getSmoothStreamingFps;\n\t\tthis.#requestRender = options.requestRender;\n\t}\n\n\tupdate(id: string, component: ToolArgsRevealComponent, partialJson: string): boolean {\n\t\tif (!this.#getSmoothStreaming() || partialJson.length === 0) {\n\t\t\tthis.finish(id);\n\t\t\treturn false;\n\t\t}\n\n\t\tconst existing = this.#states.get(id);\n\t\tif (existing === undefined || existing.component !== component || !partialJson.startsWith(existing.target)) {\n\t\t\tcomponent.updateArgs(parseStreamingJson(partialJson));\n\t\t\tthis.#states.set(id, {\n\t\t\t\tcomponent,\n\t\t\t\ttarget: partialJson,\n\t\t\t\trevealed: partialJson.length,\n\t\t\t\trendered: partialJson.length,\n\t\t\t\tlastTickAt: performance.now(),\n\t\t\t});\n\t\t\tthis.#syncTimer();\n\t\t\treturn true;\n\t\t}\n\n\t\tconst wasCaughtUp = existing.revealed >= existing.target.length;\n\t\texisting.target = partialJson;\n\t\tif (wasCaughtUp && existing.revealed < partialJson.length) {\n\t\t\texisting.lastTickAt = performance.now();\n\t\t}\n\t\tthis.#syncTimer();\n\t\treturn true;\n\t}\n\n\tflush(id: string, exactArgs: unknown): boolean {\n\t\tconst state = this.#states.get(id);\n\t\tif (state === undefined) return false;\n\t\tstate.component.updateArgs(exactArgs);\n\t\tthis.#states.delete(id);\n\t\tthis.#syncTimer();\n\t\treturn true;\n\t}\n\n\tflushAll(): void {\n\t\tfor (const state of this.#states.values()) {\n\t\t\tstate.component.updateArgs(parseStreamingJson(state.target));\n\t\t}\n\t\tthis.#states.clear();\n\t\tthis.#stopTimer();\n\t}\n\n\tfinish(id: string): void {\n\t\tif (!this.#states.delete(id)) return;\n\t\tthis.#syncTimer();\n\t}\n\n\trefresh(): void {\n\t\tif (!this.#getSmoothStreaming()) {\n\t\t\tthis.flushAll();\n\t\t\treturn;\n\t\t}\n\t\tif (!this.#hasBacklog()) {\n\t\t\tthis.#stopTimer();\n\t\t\treturn;\n\t\t}\n\t\tthis.#startTimer(true);\n\t}\n\n\tstop(): void {\n\t\tthis.#stopTimer();\n\t\tthis.#states.clear();\n\t}\n\n\t#syncTimer(): void {\n\t\tif (!this.#hasBacklog()) {\n\t\t\tthis.#stopTimer();\n\t\t\treturn;\n\t\t}\n\t\tthis.#startTimer(false);\n\t}\n\n\t#hasBacklog(): boolean {\n\t\tfor (const state of this.#states.values()) {\n\t\t\tif (state.revealed < state.target.length) return true;\n\t\t}\n\t\treturn false;\n\t}\n\n\t#startTimer(restart: boolean): void {\n\t\tconst configuredFps = this.#getSmoothStreamingFps();\n\t\tconst fps = Number.isFinite(configuredFps)\n\t\t\t? Math.min(MAX_SMOOTH_FPS, Math.max(MIN_SMOOTH_FPS, configuredFps))\n\t\t\t: DEFAULT_SMOOTH_FPS;\n\t\tif (!restart && this.#timer !== undefined && this.#timerFps === fps) return;\n\t\tthis.#stopTimer();\n\t\tconst now = performance.now();\n\t\tfor (const state of this.#states.values()) {\n\t\t\tif (state.revealed < state.target.length) state.lastTickAt = now;\n\t\t}\n\t\tconst timer = setInterval(() => this.#tick(), 1000 / fps);\n\t\ttimer.unref();\n\t\tthis.#timer = timer;\n\t\tthis.#timerFps = fps;\n\t}\n\n\t#stopTimer(): void {\n\t\tif (this.#timer !== undefined) clearInterval(this.#timer);\n\t\tthis.#timer = undefined;\n\t\tthis.#timerFps = undefined;\n\t}\n\n\t#tick(): void {\n\t\tif (!this.#getSmoothStreaming()) {\n\t\t\tthis.flushAll();\n\t\t\tthis.#requestRender();\n\t\t\treturn;\n\t\t}\n\n\t\tconst now = performance.now();\n\t\tlet rendered = false;\n\t\tfor (const state of this.#states.values()) {\n\t\t\tconst backlog = state.target.length - state.revealed;\n\t\t\tif (backlog <= 0) continue;\n\t\t\tconst step = nextStep(backlog, now - state.lastTickAt);\n\t\t\tstate.revealed = advancePastSurrogateBoundary(\n\t\t\t\tstate.target,\n\t\t\t\tMath.min(state.target.length, state.revealed + step),\n\t\t\t);\n\t\t\tstate.lastTickAt = now;\n\t\t\tif (state.revealed - state.rendered < MIN_TOOL_ARGS_PARSE_DELTA) continue;\n\t\t\tstate.component.updateArgs(parseStreamingJson(state.target.slice(0, state.revealed)));\n\t\t\tstate.rendered = state.revealed;\n\t\t\trendered = true;\n\t\t}\n\t\tif (rendered) this.#requestRender();\n\t\tthis.#syncTimer();\n\t}\n}\n"]}

package/dist/utils/child-process.d.ts

@@ -1,5 +1,16 @@
 import { type ChildProcess, type ChildProcessByStdio, type SpawnOptions, type SpawnOptionsWithStdioTuple, type SpawnSyncOptionsWithStringEncoding, type SpawnSyncReturns, type StdioNull, type StdioPipe } from "node:child_process";
 import type { Readable } from "node:stream";
+export interface WaitForChildProcessOptions {
+    /**
+     * Abort when the caller has killed the process and no longer needs its
+     * output. The wait then stops preserving stdio tails (descendants that
+     * survived the kill can no longer hold it open) and resolves as soon as
+     * the process exits, or after `abortExitGraceMs` if it never does.
+     */
+    signal?: AbortSignal;
+    /** Post-abort deadline for `exit` before resolving anyway. Default 5s. */
+    abortExitGraceMs?: number;
+}
 export declare function spawnProcess(command: string, args: string[], options: SpawnOptionsWithStdioTuple<StdioNull, StdioPipe, StdioPipe>): ChildProcessByStdio<null, Readable, Readable>;
 export declare function spawnProcess(command: string, args: string[], options: SpawnOptions): ChildProcess;
 export declare function spawnProcessSync(command: string, args: string[], options: SpawnSyncOptionsWithStringEncoding): SpawnSyncReturns<string>;
@@ -13,6 +24,11 @@ export declare function spawnProcessSync(command: string, args: string[], option
  * the grace timer is re-armed on every chunk, so an actively writing descendant keeps
  * us reading, while a quiet inherited handle (e.g. a Windows daemonized descendant
  * that never lets `close` fire) still releases us after the grace elapses.
+ *
+ * When `options.signal` aborts, the caller has killed the process and
+ * abandoned its output: tail preservation ends, the pipes are destroyed, and
+ * the wait resolves on `exit` — or after `abortExitGraceMs` when the kill
+ * never lands (uninterruptible IO, failed taskkill).
  */
-export declare function waitForChildProcess(child: ChildProcess): Promise<number | null>;
+export declare function waitForChildProcess(child: ChildProcess, options?: WaitForChildProcessOptions): Promise<number | null>;
 //# sourceMappingURL=child-process.d.ts.map

package/dist/utils/child-process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"child-process.d.ts","sourceRoot":"","sources":["../../src/utils/child-process.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,mBAAmB,EAGxB,KAAK,YAAY,EACjB,KAAK,0BAA0B,EAC/B,KAAK,kCAAkC,EACvC,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5C,wBAAgB,YAAY,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,GAClE,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACjD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY,CAAC;AAKnG,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,kCAAkC,GACzC,gBAAgB,CAAC,MAAM,CAAC,CAI1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwF/E"}
+{"version":3,"file":"child-process.d.ts","sourceRoot":"","sources":["../../src/utils/child-process.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,mBAAmB,EAGxB,KAAK,YAAY,EACjB,KAAK,0BAA0B,EAC/B,KAAK,kCAAkC,EACvC,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAM5C,MAAM,WAAW,0BAA0B;IAC1C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,GAClE,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACjD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY,CAAC;AAKnG,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,kCAAkC,GACzC,gBAAgB,CAAC,MAAM,CAAC,CAI1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2HrH"}