poly-weaver 0.10.1 → 0.10.3

package/dist/offscreen/fork-launch.js

@@ -0,0 +1,76 @@
+import { randomUUID } from "node:crypto";
+import { cp } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { rmSync } from "node:fs";
+import { getCopilotSessionDir } from "../providers/copilot/session.js";
+export async function buildForkLaunch(slot, workdir) {
+    switch (slot.driver) {
+        case "claude":
+            return {
+                command: "claude",
+                args: [
+                    "--resume",
+                    slot.sourceSessionId,
+                    "--fork-session",
+                    ...claudeFlags(slot),
+                ],
+                cleanup: () => { },
+            };
+        case "codex":
+            return {
+                command: "codex",
+                args: [
+                    "fork",
+                    slot.sourceSessionId,
+                    ...codexFlags(slot),
+                ],
+                cleanup: () => { },
+            };
+        case "copilot": {
+            const clonedId = randomUUID();
+            const sourceDir = copilotSourceDir(slot);
+            const targetDir = join(getCopilotSessionDir(), clonedId);
+            await cp(sourceDir, targetDir, { recursive: true, errorOnExist: true, force: false });
+            return {
+                command: "copilot",
+                args: [
+                    "--resume",
+                    clonedId,
+                    ...copilotFlags(slot),
+                ],
+                cleanup: () => {
+                    rmSync(targetDir, { recursive: true, force: true });
+                },
+            };
+        }
+    }
+}
+function claudeFlags(slot) {
+    return [
+        ...(slot.yolo ? ["--dangerously-skip-permissions"] : []),
+        ...(slot.model ? ["--model", slot.model] : []),
+        ...(slot.effort ? ["--effort", slot.effort] : []),
+    ];
+}
+function codexFlags(slot) {
+    return [
+        ...(slot.yolo ? ["--dangerously-bypass-approvals-and-sandbox"] : []),
+        ...(slot.model ? ["-m", slot.model] : []),
+        ...(slot.effort ? ["-c", `model_reasoning_effort="${slot.effort}"`] : []),
+    ];
+}
+function copilotFlags(slot) {
+    return [
+        ...(slot.model ? ["--model", slot.model] : []),
+        ...(slot.effort ? ["--effort", slot.effort] : []),
+        ...(slot.yolo ? ["--allow-all"] : []),
+        "--mouse=on",
+    ];
+}
+function copilotSourceDir(slot) {
+    if (slot.sourceSessionPath.endsWith("events.jsonl")) {
+        return dirname(slot.sourceSessionPath);
+    }
+    return join(getCopilotSessionDir(), slot.sourceSessionId);
+}
+//# sourceMappingURL=fork-launch.js.map

package/dist/offscreen/fork-launch.js.map

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

package/dist/offscreen/fork.d.ts

@@ -0,0 +1,21 @@
+import { VirtualTerminal } from "../terminal/virtual-terminal.js";
+import type { TerminalHost } from "../terminal/host.js";
+import type { PtyHandle } from "../pty/types.js";
+import { type OffscreenSlot } from "./fork-launch.js";
+export declare class Fork {
+    private readonly cleanup;
+    readonly binding: OffscreenSlot["binding"];
+    readonly roleLabel: string;
+    readonly sourceSessionId: string;
+    readonly driver: OffscreenSlot["driver"];
+    readonly pty: PtyHandle;
+    readonly vt: VirtualTerminal;
+    private visible;
+    private killed;
+    private constructor();
+    static spawn(slot: OffscreenSlot, workdir: string, host: Pick<TerminalHost, "scheduleParentUiRender">, cols: number, rows: number): Promise<Fork>;
+    setVisible(visible: boolean): void;
+    resize(cols: number, rows: number): void;
+    kill(): void;
+}
+//# sourceMappingURL=fork.d.ts.map

package/dist/offscreen/fork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../../src/offscreen/fork.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAI1B,qBAAa,IAAI;IAcb,OAAO,CAAC,QAAQ,CAAC,OAAO;IAb1B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAC;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO;WAiCM,KAAK,CAChB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,wBAAwB,CAAC,EAClD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC;IAqChB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAOxC,IAAI,IAAI,IAAI;CAoBb"}

package/dist/offscreen/fork.js

@@ -0,0 +1,122 @@
+import { VirtualTerminal } from "../terminal/virtual-terminal.js";
+import { spawnPty } from "../pty/spawn.js";
+import { buildForkLaunch, } from "./fork-launch.js";
+const HEADER_ROWS = 1;
+export class Fork {
+    cleanup;
+    binding;
+    roleLabel;
+    sourceSessionId;
+    driver;
+    pty;
+    vt;
+    visible = false;
+    killed = false;
+    constructor(slot, pty, vt, cleanup, host) {
+        this.cleanup = cleanup;
+        this.binding = slot.binding;
+        this.roleLabel = slot.roleLabel;
+        this.sourceSessionId = slot.sourceSessionId;
+        this.driver = slot.driver;
+        this.pty = pty;
+        this.vt = vt;
+        this.pty.onData((data) => {
+            if (this.killed)
+                return;
+            const stickyBottom = !this.vt.isScrolledBack;
+            const preWriteViewportY = this.vt.viewportY;
+            this.vt.write(data, () => {
+                if (this.killed)
+                    return;
+                if (stickyBottom) {
+                    if (this.vt.isScrolledBack)
+                        this.vt.scrollToBottom();
+                }
+                else {
+                    const currentY = this.vt.viewportY;
+                    const delta = preWriteViewportY - currentY;
+                    if (delta < 0)
+                        this.vt.scrollBack(-delta);
+                    else if (delta > 0)
+                        this.vt.scrollForward(delta);
+                }
+                if (this.visible)
+                    host.scheduleParentUiRender();
+            });
+        });
+    }
+    static async spawn(slot, workdir, host, cols, rows) {
+        const launch = await buildForkLaunch(slot, workdir);
+        const forkRows = Math.max(1, rows - HEADER_ROWS);
+        const forkCols = Math.max(1, cols);
+        let vt;
+        let pty;
+        try {
+            vt = new VirtualTerminal(forkCols, forkRows);
+            pty = spawnPty({
+                command: launch.command,
+                args: launch.args,
+                cwd: workdir,
+                cols: forkCols,
+                rows: forkRows,
+                interactive: true,
+            });
+            return new Fork(slot, pty, vt, launch.cleanup, host);
+        }
+        catch (err) {
+            try {
+                pty?.kill();
+            }
+            catch {
+                // The child may already have exited.
+            }
+            try {
+                vt?.dispose();
+            }
+            catch {
+                // Dispose is best-effort on construction failure.
+            }
+            try {
+                launch.cleanup();
+            }
+            catch {
+                // Preserve the original launch/spawn failure.
+            }
+            throw err;
+        }
+    }
+    setVisible(visible) {
+        this.visible = visible;
+    }
+    resize(cols, rows) {
+        const forkCols = Math.max(1, cols);
+        const forkRows = Math.max(1, rows - HEADER_ROWS);
+        this.vt.resize(forkCols, forkRows);
+        this.pty.resize(forkCols, forkRows);
+    }
+    kill() {
+        if (this.killed)
+            return;
+        this.killed = true;
+        this.visible = false;
+        try {
+            this.pty.kill();
+        }
+        catch {
+            // The child may already have exited.
+        }
+        try {
+            this.vt.dispose();
+        }
+        catch {
+            // Dispose is best-effort during process teardown.
+        }
+        try {
+            this.cleanup();
+        }
+        catch {
+            // Cleanup is best-effort during process teardown.
+        }
+    }
+}
+//# sourceMappingURL=fork.js.map

package/dist/offscreen/fork.js.map

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

package/dist/offscreen/keys.d.ts

@@ -0,0 +1,6 @@
+import type { TerminalKey } from "../terminal-input.js";
+export declare function isPrimaryShowKey(key: TerminalKey): boolean;
+export declare function isSecondaryShowKey(key: TerminalKey): boolean;
+export declare function isShowKey(key: TerminalKey): boolean;
+export declare function isHideKey(key: TerminalKey): boolean;
+//# sourceMappingURL=keys.d.ts.map

package/dist/offscreen/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/offscreen/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMxD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAE1D;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAE5D;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAEnD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAEnD"}

package/dist/offscreen/keys.js

@@ -0,0 +1,16 @@
+const CTRL_O = 0x0f;
+const CTRL_Q = 0x11;
+const CTRL_C = 0x03;
+export function isPrimaryShowKey(key) {
+    return key.kind === "control" && key.byte === CTRL_O;
+}
+export function isSecondaryShowKey(key) {
+    return key.kind === "control" && key.byte === CTRL_Q;
+}
+export function isShowKey(key) {
+    return isPrimaryShowKey(key) || isSecondaryShowKey(key);
+}
+export function isHideKey(key) {
+    return key.kind === "control" && key.byte === CTRL_C;
+}
+//# sourceMappingURL=keys.js.map

package/dist/offscreen/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/offscreen/keys.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,IAAI,CAAC;AACpB,MAAM,MAAM,GAAG,IAAI,CAAC;AACpB,MAAM,MAAM,GAAG,IAAI,CAAC;AAEpB,MAAM,UAAU,gBAAgB,CAAC,GAAgB;IAC/C,OAAO,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAgB;IACjD,OAAO,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAgB;IACxC,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAgB;IACxC,OAAO,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AACvD,CAAC"}

package/dist/offscreen/registry.d.ts

@@ -0,0 +1,6 @@
+type OffscreenDisposer = () => void;
+export declare function registerOffscreenDisposer(disposer: OffscreenDisposer): () => void;
+export declare function drainOffscreenDisposers(): void;
+export declare function offscreenDisposerCount(): number;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/offscreen/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/offscreen/registry.ts"],"names":[],"mappings":"AAAA,KAAK,iBAAiB,GAAG,MAAM,IAAI,CAAC;AAIpC,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI,CAQjF;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAU9C;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C"}

package/dist/offscreen/registry.js

@@ -0,0 +1,27 @@
+const disposers = new Set();
+export function registerOffscreenDisposer(disposer) {
+    disposers.add(disposer);
+    let removed = false;
+    return () => {
+        if (removed)
+            return;
+        removed = true;
+        disposers.delete(disposer);
+    };
+}
+export function drainOffscreenDisposers() {
+    const snapshot = Array.from(disposers);
+    disposers.clear();
+    for (const dispose of snapshot) {
+        try {
+            dispose();
+        }
+        catch {
+            // Abrupt-exit cleanup must be best-effort and non-throwing.
+        }
+    }
+}
+export function offscreenDisposerCount() {
+    return disposers.size;
+}
+//# sourceMappingURL=registry.js.map

package/dist/offscreen/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/offscreen/registry.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAqB,CAAC;AAE/C,MAAM,UAAU,yBAAyB,CAAC,QAA2B;IACnE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO,GAAG,EAAE;QACV,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,4DAA4D;QAC9D,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,SAAS,CAAC,IAAI,CAAC;AACxB,CAAC"}

package/dist/offscreen/resolve.d.ts

@@ -0,0 +1,10 @@
+import type { StepContext, BuiltinRole } from "../flow/types.js";
+import type { ForkSourceConfig, ForkSourceKey, OffscreenSlot } from "./fork-launch.js";
+export interface OffscreenPromptConfig {
+    workdir: string;
+    slots: OffscreenSlot[];
+}
+export declare function resolveOffscreenPromptConfig(phaseId: string, ctx: StepContext, forkSources: ReadonlyMap<ForkSourceKey, ForkSourceConfig>, workdir: string): Promise<OffscreenPromptConfig | undefined>;
+export declare function findRestorableOffscreenSessionId(source: Pick<ForkSourceConfig, "sessionKey" | "role" | "variant">, ctx: StepContext): string | undefined;
+export declare function forkSourceKeyForAgent(role: BuiltinRole, variant: string | undefined): ForkSourceKey | undefined;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/offscreen/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/offscreen/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAc,MAAM,kBAAkB,CAAC;AAE7E,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EAEb,aAAa,EACd,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AA0CD,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,WAAW,CAAC,aAAa,EAAE,gBAAgB,CAAC,EACzD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAiB5C;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC,EACjE,GAAG,EAAE,WAAW,GACf,MAAM,GAAG,SAAS,CAapB;AAsCD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,aAAa,GAAG,SAAS,CAK3B"}

package/dist/offscreen/resolve.js

@@ -0,0 +1,111 @@
+import { resolveProvider } from "../providers/registry.js";
+const PHASE_SLOTS = {
+    "user:spec-approval": [
+        {
+            key: "interviewer",
+            binding: "primary",
+            roleLabel: "interviewer",
+            hint: "Ctrl+O Inquire spec",
+        },
+    ],
+    "user:plan-approval": [
+        {
+            key: "planner",
+            binding: "primary",
+            roleLabel: "planner",
+            hint: "Ctrl+O Inquire plan",
+        },
+    ],
+    "user:curate-verdict": [
+        {
+            key: "planner",
+            binding: "primary",
+            roleLabel: "planner",
+            hint: "Ctrl+O Inquire plan",
+        },
+        {
+            key: "reviewer-plan",
+            binding: "secondary",
+            roleLabel: "reviewer",
+            hint: "Ctrl+Q Inquire issues",
+        },
+    ],
+};
+export async function resolveOffscreenPromptConfig(phaseId, ctx, forkSources, workdir) {
+    // Handlers pass the resolved step.id. The user() DSL prefixes a step's flow
+    // label with "user-", so user("user:plan-approval") resolves to step.id
+    // "user-user:plan-approval". PHASE_SLOTS is keyed by the bare flow label
+    // (matching the built-in flow definitions), so fall back to the de-prefixed id.
+    const requests = PHASE_SLOTS[phaseId] ?? PHASE_SLOTS[phaseId.replace(/^user-/, "")];
+    if (!requests)
+        return undefined;
+    if (forkSources.size === 0)
+        return undefined;
+    const slots = [];
+    for (const request of requests) {
+        const source = forkSources.get(request.key);
+        if (!source)
+            continue;
+        const slot = await resolveSlot(request, source, ctx, workdir);
+        if (slot)
+            slots.push(slot);
+    }
+    return { workdir, slots };
+}
+export function findRestorableOffscreenSessionId(source, ctx) {
+    const live = ctx.sessionIds.get(source.sessionKey);
+    if (live)
+        return live;
+    const snapshots = ctx.completedSnapshots
+        ? Array.from(ctx.completedSnapshots.values()).sort((a, b) => b.seq - a.seq)
+        : [];
+    for (const snap of snapshots) {
+        if (snap.role !== source.role)
+            continue;
+        const id = snap.sessionIds?.[source.sessionKey];
+        if (id)
+            return id;
+    }
+    return undefined;
+}
+function isDriverName(driver) {
+    return driver === "claude" || driver === "codex" || driver === "copilot";
+}
+async function resolveSlot(request, source, ctx, workdir) {
+    if (!isDriverName(source.driver))
+        return undefined;
+    const sourceSessionId = findRestorableOffscreenSessionId(source, ctx);
+    if (!sourceSessionId)
+        return undefined;
+    let sourceSessionPath;
+    try {
+        const provider = resolveProvider(source.driver);
+        sourceSessionPath = await provider.session.locateSessionById?.(workdir, sourceSessionId);
+    }
+    catch {
+        return undefined;
+    }
+    if (!sourceSessionPath)
+        return undefined;
+    return {
+        binding: request.binding,
+        roleLabel: request.roleLabel,
+        hint: request.hint,
+        driver: source.driver,
+        sourceSessionId,
+        sourceSessionPath,
+        model: source.model,
+        effort: source.effort,
+        yolo: source.yolo,
+    };
+}
+export function forkSourceKeyForAgent(role, variant) {
+    if (role === "interviewer")
+        return "interviewer";
+    if (role === "planner")
+        return "planner";
+    if (role === "reviewer" && variant === "plan")
+        return "reviewer-plan";
+    return undefined;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/offscreen/resolve.js.map

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

package/dist/offscreen/surface.d.ts

@@ -0,0 +1,4 @@
+import type { HostUiSurface } from "../terminal/host.js";
+import type { Fork } from "./fork.js";
+export declare function buildForkSurface(fork: Fork, cols: number, rows: number): HostUiSurface;
+//# sourceMappingURL=surface.d.ts.map

package/dist/offscreen/surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../src/offscreen/surface.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAYtF"}

package/dist/offscreen/surface.js

@@ -0,0 +1,24 @@
+import { bold, padOrClip, reset } from "../ansi.js";
+import { renderViewportLines } from "../terminal/render.js";
+export function buildForkSurface(fork, cols, rows) {
+    const width = Math.max(1, cols);
+    const height = Math.max(1, rows);
+    const vtRows = Math.max(0, height - 1);
+    const headerText = ` Branched Inquiry - ${forkSurfaceLabel(fork.roleLabel)} · Ctrl+C hide`;
+    const header = `${bold}\x1b[45m\x1b[97m${padOrClip(headerText, width)}${reset}`;
+    const lines = [
+        header,
+        ...renderViewportLines(fork.vt, vtRows, width),
+    ];
+    return { lines, showCursor: false };
+}
+function forkSurfaceLabel(roleLabel) {
+    if (roleLabel === "interviewer")
+        return "Spec";
+    if (roleLabel === "planner")
+        return "Plan";
+    if (roleLabel === "reviewer")
+        return "Issues";
+    return roleLabel;
+}
+//# sourceMappingURL=surface.js.map

package/dist/offscreen/surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.js","sourceRoot":"","sources":["../../src/offscreen/surface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,MAAM,UAAU,gBAAgB,CAAC,IAAU,EAAE,IAAY,EAAE,IAAY;IACrE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,uBAAuB,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC;IAC3F,MAAM,MAAM,GAAG,GAAG,IAAI,mBAAmB,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,KAAK,EAAE,CAAC;IAChF,MAAM,KAAK,GAAG;QACZ,MAAM;QACN,GAAG,mBAAmB,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC;KAC/C,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB;IACzC,IAAI,SAAS,KAAK,aAAa;QAAE,OAAO,MAAM,CAAC;IAC/C,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAC3C,IAAI,SAAS,KAAK,UAAU;QAAE,OAAO,QAAQ,CAAC;IAC9C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/orchestrator.d.ts

@@ -5,7 +5,7 @@ import type { CuratePromptHandler } from "./user/curate-prompt.js";
 import type { StatusBar } from "./status-bar.js";
 import type { OrchestrationOutput } from "./terminal/output.js";
 import type { SessionManifest, SessionStepEntry } from "./session/manifest.js";
-import { type FlowTemplate, type FlowParamValues } from "./flow/types.js";
+import { type FlowTemplate, type FlowParamValues, type FlowStep, type AgentStep } from "./flow/types.js";
 export declare class PlannerContractError extends Error {
     constructor(message: string);
 }
@@ -74,6 +74,8 @@ export interface TemplateOrchestratorOptions {
     output?: OrchestrationOutput;
     /** Optional terminal host for parent-owned rendering. */
     terminalHost?: import("./terminal/host.js").TerminalHost;
+    /** Optional timeout for provider session-file discovery. */
+    sessionFileWaitMs?: number;
     /**
      * Required for fresh runs (unless `persistence === "disabled"`); ignored
      * for resumed runs. Path to the flow's source file (the factory
@@ -112,4 +114,6 @@ export declare function createCuratePromptHandler(terminalHost?: import("./termi
  * drivers dynamically; structure params shape the flow via build().
  */
 export declare function orchestrateWithTemplate(opts: TemplateOrchestratorOptions): Promise<OrchestratorResult>;
+/** Recursively walk flow steps and yield all AgentStep nodes. */
+export declare function collectAgentSteps(steps: FlowStep[]): AgentStep[];
 //# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

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

package/dist/orchestrator.js

@@ -22,6 +22,7 @@ import { getSessionsDir } from "./config.js";
 import { captureFlowSnapshot } from "./session/flow-snapshot.js";
 import { SessionStore } from "./session/session-store.js";
 import { acquireLock, releaseLock } from "./session/lock.js";
+import { forkSourceKeyForAgent, } from "./offscreen/resolve.js";
 import { TASK, handlerKey, } from "./flow/types.js";
 export class PlannerContractError extends Error {
     constructor(message) {
@@ -324,10 +325,9 @@ export async function orchestrateWithTemplate(opts) {
         const handler = opts.userPromptHandler
             ?? (needsUserPrompt ? createUserPromptHandler(opts.terminalHost) : undefined);
         const handlers = new Map();
+        const forkSources = new Map();
         for (const step of collectAgentSteps(flow.steps)) {
             const key = handlerKey(step);
-            if (handlers.has(key))
-                continue;
             const role = step.role;
             const { modelKey, effortKey } = getRoleModelEffortKeys(role, opts.template.params);
             const model = modelKey
@@ -336,16 +336,35 @@ export async function orchestrateWithTemplate(opts) {
             const effort = effortKey
                 ? effectiveParamValues[effortKey]
                 : undefined;
+            const forkKey = forkSourceKeyForAgent(role, step.variant);
+            if (forkKey && !forkSources.has(forkKey)) {
+                forkSources.set(forkKey, {
+                    key: forkKey,
+                    role,
+                    variant: step.variant,
+                    driver: step.driver,
+                    sessionKey: step.sessionShareKey ?? step.id,
+                    model,
+                    effort,
+                    yolo: opts.yolo,
+                });
+            }
+            if (handlers.has(key))
+                continue;
             handlers.set(key, createHandler(step.role, step.driver, workdir, {
-                variant: step.variant, yolo: opts.yolo, model, effort,
+                variant: step.variant,
+                yolo: opts.yolo,
+                model,
+                effort,
+                sessionFileWaitMs: opts.sessionFileWaitMs,
             }));
         }
         if (handler) {
-            handlers.set("user", new UserRoleHandler(handler));
+            handlers.set("user", new UserRoleHandler(handler, forkSources, workdir));
         }
         if (stepsContainCuratePrompt(flow.steps)) {
             const curatePrompt = opts.curatePromptHandler ?? createCuratePromptHandler(opts.terminalHost);
-            handlers.set("user:curate-verdict", new CurateVerdictRoleHandler(curatePrompt));
+            handlers.set("user:curate-verdict", new CurateVerdictRoleHandler(curatePrompt, forkSources, workdir));
         }
         const ctx = {
             sessionDir: ephemeralSessionDir,
@@ -451,7 +470,7 @@ export async function orchestrateWithTemplate(opts) {
     }
 }
 /** Recursively walk flow steps and yield all AgentStep nodes. */
-function collectAgentSteps(steps) {
+export function collectAgentSteps(steps) {
     const result = [];
     for (const step of steps) {
         if (step.type === "agent") {