@bastani/atomic 0.9.11-alpha.7 → 0.9.11-alpha.9

package/dist/modes/interactive-engine/engine-health.js

@@ -0,0 +1,236 @@
+import { ENGINE_UNRESPONSIVE_MS } from "./activity-watchdog.js";
+export const UNEXPECTED_ENGINE_LOSS_NOTICE = "Interactive engine stopped unexpectedly; restarting.";
+export const UNRESPONSIVE_ENGINE_NOTICE = "Interactive engine is not responding; restarting.";
+/**
+ * Engine health surface: diagnostic fan-out plus single-flight recovery.
+ *
+ * Recovery has exactly two entry points, deliberately separate:
+ *
+ *  - {@link handleGenerationEnded} runs ONE automatic replacement attempt after
+ *    an unexpected loss of a generation. Expected losses (explicit stop,
+ *    deliberate generation replacement, host shutdown) never restart.
+ *  - {@link terminate} is the explicit user escape hatch (Ctrl+C). It force-stops
+ *    first, so it can rescue a replacement child that is hung waiting for
+ *    readiness instead of joining that pending promise.
+ *
+ * Neither path is reachable from an interrupt: pressing Escape only requests the
+ * engine's own cooperative abort and waits for it.
+ */
+export class EngineHealthController {
+    constructor(deps, options) {
+        this.listeners = new Set();
+        this.pending = [];
+        this.unresponsive = false;
+        this.attemptId = 0;
+        this.rescueRequested = false;
+        /**
+         * Latched when a replacement failed on its own. Automatic recovery stays
+         * single-shot, but the user's Ctrl+C must remain able to try again: without
+         * this the host would be left with no engine, no pending attempt, no overdue
+         * abort, and no watchdog flag, so nothing could arm the escape hatch.
+         */
+        this.replacementNeeded = false;
+        this.stopped = false;
+        this.deps = deps;
+        this.now = options?.now ?? (() => performance.now());
+    }
+    onDiagnostic(listener) {
+        for (const diagnostic of this.pending.splice(0))
+            listener(diagnostic);
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /** Publish a diagnostic produced elsewhere (watchdog, transport, bridge). */
+    publish(diagnostic) {
+        if (diagnostic.level === "unresponsive" && diagnostic.source === "watchdog")
+            this.unresponsive = true;
+        this.deliver(diagnostic);
+    }
+    /** A heartbeat proves the child's loop turns again, so clear a reported stall. */
+    clearUnresponsive() {
+        this.unresponsive = false;
+    }
+    markCooperativeAbortStarted() {
+        this.abortStartedAt ??= this.now();
+    }
+    markCooperativeAbortSettled() {
+        this.abortStartedAt = undefined;
+    }
+    /**
+     * True only when the engine is provably not answering:
+     *
+     *  - the heartbeat watchdog declared it unresponsive;
+     *  - a replacement failed on its own and the host has no engine;
+     *  - a cooperative abort has been outstanding past the unresponsive threshold
+     *    (a child whose loop still turns but is deadlocked);
+     *  - a replacement has been waiting for `engine_ready` past that threshold.
+     *
+     * The readiness case has no watchdog coverage at all: a child stopped before
+     * readiness emits no heartbeat and no diagnostic, and `start()` waits without
+     * a deadline by design. Crossing a threshold arms nothing on its own — it
+     * only decides whether a deliberate Ctrl+C escalates — and all of this stays
+     * false for a healthy engine so a stray second Ctrl+C cannot replace one.
+     */
+    needsExplicitTermination() {
+        if (this.unresponsive || this.replacementNeeded)
+            return true;
+        return this.isOverdue(this.abortStartedAt) || this.isOverdue(this.attemptStartedAt);
+    }
+    isOverdue(startedAt) {
+        return startedAt !== undefined && this.now() - startedAt >= ENGINE_UNRESPONSIVE_MS;
+    }
+    isRecovering() {
+        return this.attempt !== undefined || this.termination !== undefined;
+    }
+    /**
+     * Stop accepting recovery work and join whatever is still running.
+     *
+     * Disposal must not return while a replacement is between its own stop and
+     * its spawn: the client's restart permit is voided by `deps.stop()`, and the
+     * attempt is then awaited so no child, and no host initialization, outlives
+     * teardown. Idempotent, and bounded by the client's own stop deadlines.
+     */
+    shutdown() {
+        if (this.shutdownPromise)
+            return this.shutdownPromise;
+        this.stopped = true;
+        this.rescueRequested = false;
+        this.replacementNeeded = false;
+        this.shutdownPromise = (async () => {
+            await this.stopQuietly();
+            await this.attempt?.catch(() => { });
+            await this.termination?.catch(() => { });
+        })();
+        return this.shutdownPromise;
+    }
+    handleGenerationEnded(event) {
+        this.deps.clearActivity();
+        if (event.expected || this.stopped)
+            return;
+        if (this.attempt) {
+            // A newer child died while the replacement attempt was still running, so
+            // that attempt cannot leave a viable generation behind. Latch instead of
+            // restarting again: automatic recovery stays single-shot, and Ctrl+C is
+            // armed once the in-flight attempt settles.
+            this.replacementNeeded = true;
+            return;
+        }
+        void this.recover(UNEXPECTED_ENGINE_LOSS_NOTICE).catch(() => { });
+    }
+    terminate() {
+        // A repeat Ctrl+C must be able to rescue a replacement that is itself
+        // overdue, instead of joining the in-flight termination forever. The stop
+        // is fenced by attempt id so repeated presses cannot stack restarts onto a
+        // healthy replacement.
+        if (this.termination) {
+            this.rescueOverdueAttempt();
+            return this.termination;
+        }
+        const inFlight = this.attempt;
+        // The attempt this press supersedes fails by our own hand, so its failure is
+        // expected rather than something to report to the user.
+        if (inFlight)
+            this.forceStoppedAttemptId = this.attemptId;
+        const run = (async () => {
+            this.deps.clearActivity();
+            this.notice(UNRESPONSIVE_ENGINE_NOTICE);
+            await this.stopQuietly();
+            // An automatic attempt swallows its own errors, so this only waits for it
+            // to release the single-flight slot.
+            if (inFlight)
+                await inFlight;
+            await this.recover(undefined);
+            // Each user-forced stop of an overdue replacement earns exactly one more
+            // replacement attempt, so the escape hatch stays usable indefinitely.
+            while (this.rescueRequested && !this.stopped) {
+                this.rescueRequested = false;
+                this.notice(UNRESPONSIVE_ENGINE_NOTICE);
+                await this.recover(undefined);
+            }
+        })().finally(() => {
+            if (this.termination === run)
+                this.termination = undefined;
+        });
+        this.termination = run;
+        return run;
+    }
+    /** Force-stop an overdue replacement, at most once per attempt. */
+    rescueOverdueAttempt() {
+        if (!this.isOverdue(this.attemptStartedAt))
+            return false;
+        if (this.forceStoppedAttemptId === this.attemptId)
+            return false;
+        this.forceStoppedAttemptId = this.attemptId;
+        this.rescueRequested = true;
+        void this.stopQuietly();
+        return true;
+    }
+    async stopQuietly() {
+        try {
+            await this.deps.stop();
+        }
+        catch {
+            // A stop failure must not strand the escape hatch: the restart still
+            // replaces the child and reports any real failure.
+        }
+    }
+    recover(notice) {
+        // Order matters: after shutdown no caller may join, or revive, an attempt
+        // that still happens to occupy the slot.
+        if (this.stopped)
+            return Promise.resolve();
+        if (this.attempt)
+            return this.attempt;
+        if (notice)
+            this.notice(notice);
+        this.attemptId += 1;
+        const id = this.attemptId;
+        this.attemptStartedAt = this.now();
+        this.rescueRequested = false;
+        // A new attempt is under way, so the previous failure is no longer the
+        // reason to arm Ctrl+C. It re-arms below only if this attempt fails too.
+        this.replacementNeeded = false;
+        // The watchdog verdict belonged to the generation being replaced. A fresh
+        // child emits no heartbeat until it is ready, so leaving the latch set
+        // would keep `needsExplicitTermination()` true through the whole pre-ready
+        // window and let the first Ctrl+C stop a replacement that never misbehaved.
+        // Only this child's own heartbeat, or its own stall, may set it again.
+        this.unresponsive = false;
+        const run = this.deps
+            .restart()
+            .catch((error) => {
+            // An attempt the user deliberately stopped, or one cancelled by
+            // disposal, did not fail on its own.
+            if (this.forceStoppedAttemptId === id || this.stopped)
+                return;
+            // Keep Ctrl+C armed: automatic recovery is single-shot, but the user
+            // must be able to ask for another attempt after a real failure.
+            this.replacementNeeded = true;
+            // A concrete failure, so no operational source: this one surfaces.
+            this.deliver({
+                activity: undefined,
+                elapsedMs: 0,
+                level: "unresponsive",
+                message: `Interactive engine restart failed: ${error.message}`,
+            });
+        })
+            .finally(() => {
+            if (this.attempt !== run)
+                return;
+            this.attempt = undefined;
+            this.attemptStartedAt = undefined;
+        });
+        this.attempt = run;
+        return run;
+    }
+    notice(message) {
+        this.deliver({ activity: undefined, elapsedMs: 0, level: "blocking", message, source: "recovery" });
+    }
+    deliver(diagnostic) {
+        if (this.listeners.size === 0)
+            this.pending.push(diagnostic);
+        for (const listener of this.listeners)
+            listener(diagnostic);
+    }
+}
+//# sourceMappingURL=engine-health.js.map

package/dist/modes/interactive-engine/engine-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-health.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-health.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ActivityWatchdogDiagnostic, ENGINE_UNRESPONSIVE_MS } from \"./activity-watchdog.ts\";\nimport type { InteractiveEngineGenerationEnded } from \"./engine-generation.ts\";\n\nexport type EngineDiagnosticListener = (diagnostic: ActivityWatchdogDiagnostic) => void;\n\nexport interface EngineHealthDeps {\n\t/** Terminate the current (or hung replacement) engine child. */\n\tstop(): Promise<void>;\n\t/** Replace the engine child and reload host state from it. */\n\trestart(): Promise<void>;\n\t/** Drop streaming/compaction/callback activity owned by the dead generation. */\n\tclearActivity(): void;\n}\n\nexport const UNEXPECTED_ENGINE_LOSS_NOTICE = \"Interactive engine stopped unexpectedly; restarting.\";\nexport const UNRESPONSIVE_ENGINE_NOTICE = \"Interactive engine is not responding; restarting.\";\n\nexport interface EngineHealthOptions {\n\t/** Injectable clock so tests can cross the unresponsive threshold instantly. */\n\tnow?: () => number;\n}\n\n/**\n * Engine health surface: diagnostic fan-out plus single-flight recovery.\n *\n * Recovery has exactly two entry points, deliberately separate:\n *\n *  - {@link handleGenerationEnded} runs ONE automatic replacement attempt after\n *    an unexpected loss of a generation. Expected losses (explicit stop,\n *    deliberate generation replacement, host shutdown) never restart.\n *  - {@link terminate} is the explicit user escape hatch (Ctrl+C). It force-stops\n *    first, so it can rescue a replacement child that is hung waiting for\n *    readiness instead of joining that pending promise.\n *\n * Neither path is reachable from an interrupt: pressing Escape only requests the\n * engine's own cooperative abort and waits for it.\n */\nexport class EngineHealthController {\n\tprivate readonly deps: EngineHealthDeps;\n\tprivate readonly now: () => number;\n\tprivate readonly listeners = new Set<EngineDiagnosticListener>();\n\tprivate pending: ActivityWatchdogDiagnostic[] = [];\n\tprivate unresponsive = false;\n\tprivate abortStartedAt: number | undefined;\n\tprivate attempt: Promise<void> | undefined;\n\t/** When the current replacement attempt began; undefined once it settles. */\n\tprivate attemptStartedAt: number | undefined;\n\tprivate attemptId = 0;\n\tprivate forceStoppedAttemptId: number | undefined;\n\tprivate rescueRequested = false;\n\t/**\n\t * Latched when a replacement failed on its own. Automatic recovery stays\n\t * single-shot, but the user's Ctrl+C must remain able to try again: without\n\t * this the host would be left with no engine, no pending attempt, no overdue\n\t * abort, and no watchdog flag, so nothing could arm the escape hatch.\n\t */\n\tprivate replacementNeeded = false;\n\tprivate termination: Promise<void> | undefined;\n\t/** Set once disposal begins; joins the in-flight attempt and termination. */\n\tprivate shutdownPromise: Promise<void> | undefined;\n\tprivate stopped = false;\n\n\tconstructor(deps: EngineHealthDeps, options?: EngineHealthOptions) {\n\t\tthis.deps = deps;\n\t\tthis.now = options?.now ?? (() => performance.now());\n\t}\n\n\tonDiagnostic(listener: EngineDiagnosticListener): () => void {\n\t\tfor (const diagnostic of this.pending.splice(0)) listener(diagnostic);\n\t\tthis.listeners.add(listener);\n\t\treturn () => this.listeners.delete(listener);\n\t}\n\n\t/** Publish a diagnostic produced elsewhere (watchdog, transport, bridge). */\n\tpublish(diagnostic: ActivityWatchdogDiagnostic): void {\n\t\tif (diagnostic.level === \"unresponsive\" && diagnostic.source === \"watchdog\") this.unresponsive = true;\n\t\tthis.deliver(diagnostic);\n\t}\n\n\t/** A heartbeat proves the child's loop turns again, so clear a reported stall. */\n\tclearUnresponsive(): void {\n\t\tthis.unresponsive = false;\n\t}\n\n\tmarkCooperativeAbortStarted(): void {\n\t\tthis.abortStartedAt ??= this.now();\n\t}\n\n\tmarkCooperativeAbortSettled(): void {\n\t\tthis.abortStartedAt = undefined;\n\t}\n\n\t/**\n\t * True only when the engine is provably not answering:\n\t *\n\t *  - the heartbeat watchdog declared it unresponsive;\n\t *  - a replacement failed on its own and the host has no engine;\n\t *  - a cooperative abort has been outstanding past the unresponsive threshold\n\t *    (a child whose loop still turns but is deadlocked);\n\t *  - a replacement has been waiting for `engine_ready` past that threshold.\n\t *\n\t * The readiness case has no watchdog coverage at all: a child stopped before\n\t * readiness emits no heartbeat and no diagnostic, and `start()` waits without\n\t * a deadline by design. Crossing a threshold arms nothing on its own — it\n\t * only decides whether a deliberate Ctrl+C escalates — and all of this stays\n\t * false for a healthy engine so a stray second Ctrl+C cannot replace one.\n\t */\n\tneedsExplicitTermination(): boolean {\n\t\tif (this.unresponsive || this.replacementNeeded) return true;\n\t\treturn this.isOverdue(this.abortStartedAt) || this.isOverdue(this.attemptStartedAt);\n\t}\n\n\tprivate isOverdue(startedAt: number | undefined): boolean {\n\t\treturn startedAt !== undefined && this.now() - startedAt >= ENGINE_UNRESPONSIVE_MS;\n\t}\n\n\tisRecovering(): boolean {\n\t\treturn this.attempt !== undefined || this.termination !== undefined;\n\t}\n\n\t/**\n\t * Stop accepting recovery work and join whatever is still running.\n\t *\n\t * Disposal must not return while a replacement is between its own stop and\n\t * its spawn: the client's restart permit is voided by `deps.stop()`, and the\n\t * attempt is then awaited so no child, and no host initialization, outlives\n\t * teardown. Idempotent, and bounded by the client's own stop deadlines.\n\t */\n\tshutdown(): Promise<void> {\n\t\tif (this.shutdownPromise) return this.shutdownPromise;\n\t\tthis.stopped = true;\n\t\tthis.rescueRequested = false;\n\t\tthis.replacementNeeded = false;\n\t\tthis.shutdownPromise = (async () => {\n\t\t\tawait this.stopQuietly();\n\t\t\tawait this.attempt?.catch(() => {});\n\t\t\tawait this.termination?.catch(() => {});\n\t\t})();\n\t\treturn this.shutdownPromise;\n\t}\n\n\thandleGenerationEnded(event: InteractiveEngineGenerationEnded): void {\n\t\tthis.deps.clearActivity();\n\t\tif (event.expected || this.stopped) return;\n\t\tif (this.attempt) {\n\t\t\t// A newer child died while the replacement attempt was still running, so\n\t\t\t// that attempt cannot leave a viable generation behind. Latch instead of\n\t\t\t// restarting again: automatic recovery stays single-shot, and Ctrl+C is\n\t\t\t// armed once the in-flight attempt settles.\n\t\t\tthis.replacementNeeded = true;\n\t\t\treturn;\n\t\t}\n\t\tvoid this.recover(UNEXPECTED_ENGINE_LOSS_NOTICE).catch(() => {});\n\t}\n\n\tterminate(): Promise<void> {\n\t\t// A repeat Ctrl+C must be able to rescue a replacement that is itself\n\t\t// overdue, instead of joining the in-flight termination forever. The stop\n\t\t// is fenced by attempt id so repeated presses cannot stack restarts onto a\n\t\t// healthy replacement.\n\t\tif (this.termination) {\n\t\t\tthis.rescueOverdueAttempt();\n\t\t\treturn this.termination;\n\t\t}\n\t\tconst inFlight = this.attempt;\n\t\t// The attempt this press supersedes fails by our own hand, so its failure is\n\t\t// expected rather than something to report to the user.\n\t\tif (inFlight) this.forceStoppedAttemptId = this.attemptId;\n\t\tconst run = (async () => {\n\t\t\tthis.deps.clearActivity();\n\t\t\tthis.notice(UNRESPONSIVE_ENGINE_NOTICE);\n\t\t\tawait this.stopQuietly();\n\t\t\t// An automatic attempt swallows its own errors, so this only waits for it\n\t\t\t// to release the single-flight slot.\n\t\t\tif (inFlight) await inFlight;\n\t\t\tawait this.recover(undefined);\n\t\t\t// Each user-forced stop of an overdue replacement earns exactly one more\n\t\t\t// replacement attempt, so the escape hatch stays usable indefinitely.\n\t\t\twhile (this.rescueRequested && !this.stopped) {\n\t\t\t\tthis.rescueRequested = false;\n\t\t\t\tthis.notice(UNRESPONSIVE_ENGINE_NOTICE);\n\t\t\t\tawait this.recover(undefined);\n\t\t\t}\n\t\t})().finally(() => {\n\t\t\tif (this.termination === run) this.termination = undefined;\n\t\t});\n\t\tthis.termination = run;\n\t\treturn run;\n\t}\n\n\t/** Force-stop an overdue replacement, at most once per attempt. */\n\tprivate rescueOverdueAttempt(): boolean {\n\t\tif (!this.isOverdue(this.attemptStartedAt)) return false;\n\t\tif (this.forceStoppedAttemptId === this.attemptId) return false;\n\t\tthis.forceStoppedAttemptId = this.attemptId;\n\t\tthis.rescueRequested = true;\n\t\tvoid this.stopQuietly();\n\t\treturn true;\n\t}\n\n\tprivate async stopQuietly(): Promise<void> {\n\t\ttry {\n\t\t\tawait this.deps.stop();\n\t\t} catch {\n\t\t\t// A stop failure must not strand the escape hatch: the restart still\n\t\t\t// replaces the child and reports any real failure.\n\t\t}\n\t}\n\n\tprivate recover(notice: string | undefined): Promise<void> {\n\t\t// Order matters: after shutdown no caller may join, or revive, an attempt\n\t\t// that still happens to occupy the slot.\n\t\tif (this.stopped) return Promise.resolve();\n\t\tif (this.attempt) return this.attempt;\n\t\tif (notice) this.notice(notice);\n\t\tthis.attemptId += 1;\n\t\tconst id = this.attemptId;\n\t\tthis.attemptStartedAt = this.now();\n\t\tthis.rescueRequested = false;\n\t\t// A new attempt is under way, so the previous failure is no longer the\n\t\t// reason to arm Ctrl+C. It re-arms below only if this attempt fails too.\n\t\tthis.replacementNeeded = false;\n\t\t// The watchdog verdict belonged to the generation being replaced. A fresh\n\t\t// child emits no heartbeat until it is ready, so leaving the latch set\n\t\t// would keep `needsExplicitTermination()` true through the whole pre-ready\n\t\t// window and let the first Ctrl+C stop a replacement that never misbehaved.\n\t\t// Only this child's own heartbeat, or its own stall, may set it again.\n\t\tthis.unresponsive = false;\n\t\tconst run = this.deps\n\t\t\t.restart()\n\t\t\t.catch((error: Error) => {\n\t\t\t\t// An attempt the user deliberately stopped, or one cancelled by\n\t\t\t\t// disposal, did not fail on its own.\n\t\t\t\tif (this.forceStoppedAttemptId === id || this.stopped) return;\n\t\t\t\t// Keep Ctrl+C armed: automatic recovery is single-shot, but the user\n\t\t\t\t// must be able to ask for another attempt after a real failure.\n\t\t\t\tthis.replacementNeeded = true;\n\t\t\t\t// A concrete failure, so no operational source: this one surfaces.\n\t\t\t\tthis.deliver({\n\t\t\t\t\tactivity: undefined,\n\t\t\t\t\telapsedMs: 0,\n\t\t\t\t\tlevel: \"unresponsive\",\n\t\t\t\t\tmessage: `Interactive engine restart failed: ${error.message}`,\n\t\t\t\t});\n\t\t\t})\n\t\t\t.finally(() => {\n\t\t\t\tif (this.attempt !== run) return;\n\t\t\t\tthis.attempt = undefined;\n\t\t\t\tthis.attemptStartedAt = undefined;\n\t\t\t});\n\t\tthis.attempt = run;\n\t\treturn run;\n\t}\n\n\tprivate notice(message: string): void {\n\t\tthis.deliver({ activity: undefined, elapsedMs: 0, level: \"blocking\", message, source: \"recovery\" });\n\t}\n\n\tprivate deliver(diagnostic: ActivityWatchdogDiagnostic): void {\n\t\tif (this.listeners.size === 0) this.pending.push(diagnostic);\n\t\tfor (const listener of this.listeners) listener(diagnostic);\n\t}\n}\n"]}

package/dist/modes/interactive-engine/engine-input-form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-input-form.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-input-form.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAY9E,oDAAoD;AACpD,qBAAa,sBAAsB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,MAAM,CAAK;IACnB,YAAY,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAExC;IAED,IAAI,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CAuBrG;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQhC;IAED,OAAO,IAAI,IAAI,CAGd;IAED,OAAO,CAAC,IAAI;CAGZ"}
+{"version":3,"file":"engine-input-form.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-input-form.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAY9E,oDAAoD;AACpD,qBAAa,sBAAsB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,MAAM,CAAK;IACnB,YAAY,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAExC;IAED,IAAI,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CAgCrG;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQhC;IAED,OAAO,IAAI,IAAI,CAGd;IAED,OAAO,CAAC,IAAI;CAGZ"}

package/dist/modes/interactive-engine/engine-input-form.js

@@ -11,7 +11,9 @@ export class EngineInputFormService {
             return Promise.resolve(undefined);
         const componentId = `input_form_${++this.nextId}`;
         let resolveResult;
-        const result = new Promise((resolve) => { resolveResult = resolve; });
+        const result = new Promise((resolve) => {
+            resolveResult = resolve;
+        });
         const onAbort = () => {
             this.send({ type: "engine_input_form_close", componentId });
             record.resolve(undefined);
@@ -29,12 +31,19 @@ export class EngineInputFormService {
         };
         signal?.addEventListener("abort", onAbort, { once: true });
         this.active.set(componentId, record);
-        this.send({ type: "engine_input_form_open", componentId, title: request.title, fields: request.fields.map((field) => ({ ...field, choices: field.choices ? [...field.choices] : undefined })), ...(request.heading !== undefined ? { heading: request.heading } : {}), ...(request.submitLabel !== undefined ? { submitLabel: request.submitLabel } : {}) });
+        this.send({
+            type: "engine_input_form_open",
+            componentId,
+            title: request.title,
+            fields: request.fields.map((field) => ({ ...field, choices: field.choices ? [...field.choices] : undefined })),
+            ...(request.heading !== undefined ? { heading: request.heading } : {}),
+            ...(request.submitLabel !== undefined ? { submitLabel: request.submitLabel } : {}),
+        });
         return result;
     }
     handleLine(line) {
         const command = parseInteractiveEngineCommand(line);
-        if (!command || !command.type.startsWith("engine_input_form_"))
+        if (!command?.type.startsWith("engine_input_form_"))
             return false;
         const record = this.active.get(command.componentId);
         if (!record)

package/dist/modes/interactive-engine/engine-input-form.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine-input-form.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-input-form.ts"],"names":[],"mappings":"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","sourcesContent":["import type { HostInputFormRequest } from \"../../core/extensions/ui-types.ts\";\nimport {\n\tparseInteractiveEngineCommand,\n\tserializeInteractiveEngineMessage,\n\ttype InteractiveEngineMessage,\n} from \"./protocol.ts\";\n\ninterface ActiveForm {\n\tsettled: boolean;\n\tresolve: (values: Record<string, string> | undefined) => void;\n}\n\n/** Child-side owner for host-native input forms. */\nexport class EngineInputFormService {\n\tprivate readonly active = new Map<string, ActiveForm>();\n\tprivate readonly write: (line: string) => void;\n\tprivate nextId = 0;\n\tconstructor(write: (line: string) => void) {\n\t\tthis.write = write;\n\t}\n\n\topen(request: HostInputFormRequest, signal?: AbortSignal): Promise<Record<string, string> | undefined> {\n\t\tif (signal?.aborted) return Promise.resolve(undefined);\n\t\tconst componentId = `input_form_${++this.nextId}`;\n\t\tlet resolveResult!: (values: Record<string, string> | undefined) => void;\n\t\tconst result = new Promise<Record<string, string> | undefined>((resolve) => { resolveResult = resolve; });\n\t\tconst onAbort = () => {\n\t\t\tthis.send({ type: \"engine_input_form_close\", componentId });\n\t\t\trecord.resolve(undefined);\n\t\t};\n\t\tconst record: ActiveForm = {\n\t\t\tsettled: false,\n\t\t\tresolve: (values) => {\n\t\t\t\tif (record.settled) return;\n\t\t\t\trecord.settled = true;\n\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\tthis.active.delete(componentId);\n\t\t\t\tresolveResult(values);\n\t\t\t},\n\t\t};\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t\tthis.active.set(componentId, record);\n\t\tthis.send({ type: \"engine_input_form_open\", componentId, title: request.title, fields: request.fields.map((field) => ({ ...field, choices: field.choices ? [...field.choices] : undefined })), ...(request.heading !== undefined ? { heading: request.heading } : {}), ...(request.submitLabel !== undefined ? { submitLabel: request.submitLabel } : {}) });\n\t\treturn result;\n\t}\n\n\thandleLine(line: string): boolean {\n\t\tconst command = parseInteractiveEngineCommand(line);\n\t\tif (!command || !command.type.startsWith(\"engine_input_form_\")) return false;\n\t\tconst record = this.active.get(command.componentId);\n\t\tif (!record) return true;\n\t\tif (command.type === \"engine_input_form_submit\") record.resolve(command.values);\n\t\telse if (command.type === \"engine_input_form_cancel\") record.resolve(undefined);\n\t\treturn true;\n\t}\n\n\tdispose(): void {\n\t\tfor (const record of this.active.values()) record.resolve(undefined);\n\t\tthis.active.clear();\n\t}\n\n\tprivate send(message: InteractiveEngineMessage): void {\n\t\tthis.write(serializeInteractiveEngineMessage(message));\n\t}\n}\n"]}
+{"version":3,"file":"engine-input-form.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-input-form.ts"],"names":[],"mappings":"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","sourcesContent":["import type { HostInputFormRequest } from \"../../core/extensions/ui-types.ts\";\nimport {\n\ttype InteractiveEngineMessage,\n\tparseInteractiveEngineCommand,\n\tserializeInteractiveEngineMessage,\n} from \"./protocol.ts\";\n\ninterface ActiveForm {\n\tsettled: boolean;\n\tresolve: (values: Record<string, string> | undefined) => void;\n}\n\n/** Child-side owner for host-native input forms. */\nexport class EngineInputFormService {\n\tprivate readonly active = new Map<string, ActiveForm>();\n\tprivate readonly write: (line: string) => void;\n\tprivate nextId = 0;\n\tconstructor(write: (line: string) => void) {\n\t\tthis.write = write;\n\t}\n\n\topen(request: HostInputFormRequest, signal?: AbortSignal): Promise<Record<string, string> | undefined> {\n\t\tif (signal?.aborted) return Promise.resolve(undefined);\n\t\tconst componentId = `input_form_${++this.nextId}`;\n\t\tlet resolveResult!: (values: Record<string, string> | undefined) => void;\n\t\tconst result = new Promise<Record<string, string> | undefined>((resolve) => {\n\t\t\tresolveResult = resolve;\n\t\t});\n\t\tconst onAbort = () => {\n\t\t\tthis.send({ type: \"engine_input_form_close\", componentId });\n\t\t\trecord.resolve(undefined);\n\t\t};\n\t\tconst record: ActiveForm = {\n\t\t\tsettled: false,\n\t\t\tresolve: (values) => {\n\t\t\t\tif (record.settled) return;\n\t\t\t\trecord.settled = true;\n\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\tthis.active.delete(componentId);\n\t\t\t\tresolveResult(values);\n\t\t\t},\n\t\t};\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t\tthis.active.set(componentId, record);\n\t\tthis.send({\n\t\t\ttype: \"engine_input_form_open\",\n\t\t\tcomponentId,\n\t\t\ttitle: request.title,\n\t\t\tfields: request.fields.map((field) => ({ ...field, choices: field.choices ? [...field.choices] : undefined })),\n\t\t\t...(request.heading !== undefined ? { heading: request.heading } : {}),\n\t\t\t...(request.submitLabel !== undefined ? { submitLabel: request.submitLabel } : {}),\n\t\t});\n\t\treturn result;\n\t}\n\n\thandleLine(line: string): boolean {\n\t\tconst command = parseInteractiveEngineCommand(line);\n\t\tif (!command?.type.startsWith(\"engine_input_form_\")) return false;\n\t\tconst record = this.active.get(command.componentId);\n\t\tif (!record) return true;\n\t\tif (command.type === \"engine_input_form_submit\") record.resolve(command.values);\n\t\telse if (command.type === \"engine_input_form_cancel\") record.resolve(undefined);\n\t\treturn true;\n\t}\n\n\tdispose(): void {\n\t\tfor (const record of this.active.values()) record.resolve(undefined);\n\t\tthis.active.clear();\n\t}\n\n\tprivate send(message: InteractiveEngineMessage): void {\n\t\tthis.write(serializeInteractiveEngineMessage(message));\n\t}\n}\n"]}

package/dist/modes/interactive-engine/engine-monitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-monitor.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAC3F,OAAO,EAAiC,KAAK,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE7F,qBAAa,wBAAwB;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8C;IAExE,YACC,YAAY,EAAE,CAAC,UAAU,EAAE,0BAA0B,KAAK,IAAI,EAC9D,SAAS,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,EAgBtD;IAGD,IAAI,IAAI,IAAI,CAEX;IACD,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAwD;IAEhF;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpC;IAED,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAuB;IAEtD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAyBhC;CACD"}
+{"version":3,"file":"engine-monitor.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAC3F,OAAO,EAAE,KAAK,wBAAwB,EAAiC,MAAM,eAAe,CAAC;AAE7F,qBAAa,wBAAwB;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8C;IAExE,YACC,YAAY,EAAE,CAAC,UAAU,EAAE,0BAA0B,KAAK,IAAI,EAC9D,SAAS,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,EAgBtD;IAED,IAAI,IAAI,IAAI,CAEX;IACD,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAGvB;IAED;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpC;IAED,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9B;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAyBhC;CACD"}

package/dist/modes/interactive-engine/engine-monitor.js

@@ -20,7 +20,10 @@ export class InteractiveEngineMonitor {
     stop() {
         this.watchdog.stop();
     }
-    fail(error) { this.rejectBound(error); this.rejectFailure(error); }
+    fail(error) {
+        this.rejectBound(error);
+        this.rejectFailure(error);
+    }
     /**
      * Waits for the engine to announce readiness. There is deliberately no
      * deadline: slow starts (cold module loads on Windows) must not be treated
@@ -29,7 +32,9 @@ export class InteractiveEngineMonitor {
     async waitUntilReady() {
         await Promise.race([this.readiness, this.failure]);
     }
-    waitUntilBound() { return this.bound; }
+    waitUntilBound() {
+        return this.bound;
+    }
     handleLine(line) {
         const message = parseInteractiveEngineMessage(line);
         if (!message)

package/dist/modes/interactive-engine/engine-monitor.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine-monitor.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAmC,MAAM,wBAAwB,CAAC;AAC3F,OAAO,EAAE,6BAA6B,EAAiC,MAAM,eAAe,CAAC;AAE7F,MAAM,OAAO,wBAAwB;IAWpC,YACC,YAA8D,EAC9D,SAAsD;QAEtD,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACxC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC5C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;YAC5B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YACxC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;IAGD,IAAI;QACH,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IACD,IAAI,CAAC,KAAY,IAAU,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEhF;;;;OAIG;IACH,KAAK,CAAC,cAAc;QACnB,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,cAAc,KAAoB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAEtD,UAAU,CAAC,IAAY;QACtB,MAAM,OAAO,GAAG,6BAA6B,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACxB,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACtB,KAAK,cAAc;gBAClB,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACtB,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpB,MAAM;YACP,KAAK,cAAc;gBAClB,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpB,MAAM;YACP,KAAK,kBAAkB;gBACtB,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACtB,MAAM;YACP,KAAK,yBAAyB;gBAC7B,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAChD,MAAM;YACP,KAAK,0BAA0B;gBAC9B,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBACnD,MAAM;QACR,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;CACD","sourcesContent":["import { ActivityWatchdog, type ActivityWatchdogDiagnostic } from \"./activity-watchdog.ts\";\nimport { parseInteractiveEngineMessage, type InteractiveEngineMessage } from \"./protocol.ts\";\n\nexport class InteractiveEngineMonitor {\n\tprivate readonly watchdog: ActivityWatchdog;\n\tprivate readonly readiness: Promise<void>;\n\tprivate resolveReady!: () => void;\n\tprivate readonly bound: Promise<void>;\n\tprivate resolveBound!: () => void;\n\tprivate rejectBound!: (error: Error) => void;\n\tprivate readonly failure: Promise<never>;\n\tprivate rejectFailure!: (error: Error) => void;\n\tprivate readonly onMessage: (message: InteractiveEngineMessage) => void;\n\n\tconstructor(\n\t\tonDiagnostic: (diagnostic: ActivityWatchdogDiagnostic) => void,\n\t\tonMessage: (message: InteractiveEngineMessage) => void,\n\t) {\n\t\tthis.watchdog = new ActivityWatchdog({ onDiagnostic });\n\t\tthis.onMessage = onMessage;\n\t\tthis.readiness = new Promise((resolve) => {\n\t\t\tthis.resolveReady = resolve;\n\t\t});\n\t\tthis.bound = new Promise((resolve, reject) => {\n\t\t\tthis.resolveBound = resolve;\n\t\t\tthis.rejectBound = reject;\n\t\t});\n\t\tthis.bound.catch(() => {});\n\t\tthis.failure = new Promise((_, reject) => {\n\t\t\tthis.rejectFailure = reject;\n\t\t});\n\t\tthis.failure.catch(() => {});\n\t}\n\n\n\tstop(): void {\n\t\tthis.watchdog.stop();\n\t}\n\tfail(error: Error): void { this.rejectBound(error); this.rejectFailure(error); }\n\n\t/**\n\t * Waits for the engine to announce readiness. There is deliberately no\n\t * deadline: slow starts (cold module loads on Windows) must not be treated\n\t * as failures. Engine exit or a transport error rejects via fail().\n\t */\n\tasync waitUntilReady(): Promise<void> {\n\t\tawait Promise.race([this.readiness, this.failure]);\n\t}\n\n\twaitUntilBound(): Promise<void> { return this.bound; }\n\n\thandleLine(line: string): boolean {\n\t\tconst message = parseInteractiveEngineMessage(line);\n\t\tif (!message) return false;\n\t\tthis.onMessage(message);\n\t\tswitch (message.type) {\n\t\t\tcase \"engine_ready\":\n\t\t\t\tthis.watchdog.heartbeat();\n\t\t\t\tthis.watchdog.start();\n\t\t\t\tthis.resolveReady();\n\t\t\t\tbreak;\n\t\t\tcase \"engine_bound\":\n\t\t\t\tthis.resolveBound();\n\t\t\t\tbreak;\n\t\t\tcase \"engine_heartbeat\":\n\t\t\t\tthis.watchdog.heartbeat();\n\t\t\t\tthis.watchdog.start();\n\t\t\t\tbreak;\n\t\t\tcase \"engine_activity_started\":\n\t\t\t\tthis.watchdog.activityStarted(message.activity);\n\t\t\t\tbreak;\n\t\t\tcase \"engine_activity_finished\":\n\t\t\t\tthis.watchdog.activityFinished(message.activityId);\n\t\t\t\tbreak;\n\t\t}\n\t\treturn true;\n\t}\n}\n"]}
+{"version":3,"file":"engine-monitor.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAmC,MAAM,wBAAwB,CAAC;AAC3F,OAAO,EAAiC,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAE7F,MAAM,OAAO,wBAAwB;IAWpC,YACC,YAA8D,EAC9D,SAAsD;QAEtD,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACxC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC5C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;YAC5B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YACxC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI;QACH,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IACD,IAAI,CAAC,KAAY;QAChB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc;QACnB,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,cAAc;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,IAAY;QACtB,MAAM,OAAO,GAAG,6BAA6B,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACxB,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACtB,KAAK,cAAc;gBAClB,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACtB,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpB,MAAM;YACP,KAAK,cAAc;gBAClB,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpB,MAAM;YACP,KAAK,kBAAkB;gBACtB,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACtB,MAAM;YACP,KAAK,yBAAyB;gBAC7B,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAChD,MAAM;YACP,KAAK,0BAA0B;gBAC9B,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBACnD,MAAM;QACR,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;CACD","sourcesContent":["import { ActivityWatchdog, type ActivityWatchdogDiagnostic } from \"./activity-watchdog.ts\";\nimport { type InteractiveEngineMessage, parseInteractiveEngineMessage } from \"./protocol.ts\";\n\nexport class InteractiveEngineMonitor {\n\tprivate readonly watchdog: ActivityWatchdog;\n\tprivate readonly readiness: Promise<void>;\n\tprivate resolveReady!: () => void;\n\tprivate readonly bound: Promise<void>;\n\tprivate resolveBound!: () => void;\n\tprivate rejectBound!: (error: Error) => void;\n\tprivate readonly failure: Promise<never>;\n\tprivate rejectFailure!: (error: Error) => void;\n\tprivate readonly onMessage: (message: InteractiveEngineMessage) => void;\n\n\tconstructor(\n\t\tonDiagnostic: (diagnostic: ActivityWatchdogDiagnostic) => void,\n\t\tonMessage: (message: InteractiveEngineMessage) => void,\n\t) {\n\t\tthis.watchdog = new ActivityWatchdog({ onDiagnostic });\n\t\tthis.onMessage = onMessage;\n\t\tthis.readiness = new Promise((resolve) => {\n\t\t\tthis.resolveReady = resolve;\n\t\t});\n\t\tthis.bound = new Promise((resolve, reject) => {\n\t\t\tthis.resolveBound = resolve;\n\t\t\tthis.rejectBound = reject;\n\t\t});\n\t\tthis.bound.catch(() => {});\n\t\tthis.failure = new Promise((_, reject) => {\n\t\t\tthis.rejectFailure = reject;\n\t\t});\n\t\tthis.failure.catch(() => {});\n\t}\n\n\tstop(): void {\n\t\tthis.watchdog.stop();\n\t}\n\tfail(error: Error): void {\n\t\tthis.rejectBound(error);\n\t\tthis.rejectFailure(error);\n\t}\n\n\t/**\n\t * Waits for the engine to announce readiness. There is deliberately no\n\t * deadline: slow starts (cold module loads on Windows) must not be treated\n\t * as failures. Engine exit or a transport error rejects via fail().\n\t */\n\tasync waitUntilReady(): Promise<void> {\n\t\tawait Promise.race([this.readiness, this.failure]);\n\t}\n\n\twaitUntilBound(): Promise<void> {\n\t\treturn this.bound;\n\t}\n\n\thandleLine(line: string): boolean {\n\t\tconst message = parseInteractiveEngineMessage(line);\n\t\tif (!message) return false;\n\t\tthis.onMessage(message);\n\t\tswitch (message.type) {\n\t\t\tcase \"engine_ready\":\n\t\t\t\tthis.watchdog.heartbeat();\n\t\t\t\tthis.watchdog.start();\n\t\t\t\tthis.resolveReady();\n\t\t\t\tbreak;\n\t\t\tcase \"engine_bound\":\n\t\t\t\tthis.resolveBound();\n\t\t\t\tbreak;\n\t\t\tcase \"engine_heartbeat\":\n\t\t\t\tthis.watchdog.heartbeat();\n\t\t\t\tthis.watchdog.start();\n\t\t\t\tbreak;\n\t\t\tcase \"engine_activity_started\":\n\t\t\t\tthis.watchdog.activityStarted(message.activity);\n\t\t\t\tbreak;\n\t\t\tcase \"engine_activity_finished\":\n\t\t\t\tthis.watchdog.activityFinished(message.activityId);\n\t\t\t\tbreak;\n\t\t}\n\t\treturn true;\n\t}\n}\n"]}

package/dist/modes/interactive-engine/engine-render-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-render-service.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-render-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAsDhE,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAE/C,YAAY,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAExC;IAED,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAGvC;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAuBhC;IAED,OAAO,IAAI,IAAI,CAEd;IAED,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,UAAU;IAoClB,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,IAAI;CAGZ"}
+{"version":3,"file":"engine-render-service.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-render-service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAsDhE,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAE/C,YAAY,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAExC;IAED,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAGvC;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgChC;IAED,OAAO,IAAI,IAAI,CAEd;IAED,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,UAAU;IAuClB,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,IAAI;CAGZ"}

package/dist/modes/interactive-engine/engine-render-service.js

@@ -14,7 +14,9 @@ class RenderTerminal {
     start() { }
     stop() { }
     async drainInput() { }
-    write() { this.requestRender(); }
+    write() {
+        this.requestRender();
+    }
     moveBy() { }
     hideCursor() { }
     showCursor() { }
@@ -35,7 +37,7 @@ export class EngineRenderService {
     }
     handleLine(line) {
         const command = parseInteractiveEngineCommand(line);
-        if (!command || !command.type.startsWith("engine_") || command.type.startsWith("engine_custom_"))
+        if (!command?.type.startsWith("engine_") || command.type.startsWith("engine_custom_"))
             return false;
         if (command.type === "engine_render_dispose") {
             this.disposeRecord(command.componentId);
@@ -43,15 +45,19 @@ export class EngineRenderService {
         }
         if (command.type !== "engine_tool_render" && command.type !== "engine_message_render")
             return false;
-        const name = command.type === "engine_tool_render" ? `tool:${command.toolName}` : `message:${command.message.customType ?? "custom"}`;
+        const name = command.type === "engine_tool_render"
+            ? `tool:${command.toolName}`
+            : `message:${command.message.customType ?? "custom"}`;
         void runCallback({ kind: "renderer", name }, async () => {
             return command.type === "engine_tool_render" ? this.renderTool(command) : this.renderMessage(command);
-        }).then((lines) => this.send({
+        })
+            .then((lines) => this.send({
             type: "engine_custom_frame",
             componentId: command.componentId,
             requestId: command.requestId,
             lines,
-        })).catch((error) => this.send({
+        }))
+            .catch((error) => this.send({
             type: "engine_custom_frame",
             componentId: command.componentId,
             requestId: command.requestId,

package/dist/modes/interactive-engine/engine-render-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine-render-service.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-render-service.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Terminal } from \"@earendil-works/pi-tui\";\nimport { TUI } from \"@earendil-works/pi-tui\";\nimport type { AgentSession } from \"../../core/agent-session.ts\";\nimport { getAgentDir } from \"../../config.ts\";\nimport { runCallback } from \"../../core/callback-activity.ts\";\nimport type { CustomMessage } from \"../../core/messages.ts\";\nimport { CustomMessageComponent } from \"../interactive/components/custom-message.ts\";\nimport { ToolExecutionComponent } from \"../interactive/components/tool-execution.ts\";\nimport {\n\ttype InteractiveEngineCommand,\n\ttype InteractiveEngineMessage,\n\tparseInteractiveEngineCommand,\n\tserializeInteractiveEngineMessage,\n} from \"./protocol.ts\";\n\ntype ToolRenderCommand = Extract<InteractiveEngineCommand, { type: \"engine_tool_render\" }>;\ntype MessageRenderCommand = Extract<InteractiveEngineCommand, { type: \"engine_message_render\" }>;\n\n/**\n * Cached per-componentId render state. Records are REUSED across render\n * requests: recreating (and re-seeding) the component on every request made\n * the seeding setters call `ui.requestRender()` each time, whose eventual\n * terminal write emitted `engine_custom_invalidate` back to the host, which\n * re-sent the render request — a self-sustaining host⇄engine render\n * ping-pong that presented as full-screen TUI flicker (quit/pause while a\n * workflow stage streams). Reuse plus idempotent seeding setters lets the\n * loop converge after at most one round trip while still forwarding\n * legitimate async invalidations (e.g. image conversion).\n */\ntype RenderRecord =\n\t| { kind: \"message\"; component: CustomMessageComponent; terminal: RenderTerminal; tui: TUI }\n\t| { kind: \"tool\"; component: ToolExecutionComponent; terminal: RenderTerminal; tui: TUI };\n\nclass RenderTerminal implements Terminal {\n\tcolumns = 80;\n\trows = 24;\n\tkittyProtocolActive = false;\n\tprivate readonly requestRender: () => void;\n\tconstructor(requestRender: () => void) {\n\t\tthis.requestRender = requestRender;\n\t}\n\tstart(): void {}\n\tstop(): void {}\n\tasync drainInput(): Promise<void> {}\n\twrite(): void { this.requestRender(); }\n\tmoveBy(): void {}\n\thideCursor(): void {}\n\tshowCursor(): void {}\n\tclearLine(): void {}\n\tclearFromCursor(): void {}\n\tclearScreen(): void {}\n\tsetTitle(): void {}\n\tsetProgress(): void {}\n}\n\n\nexport class EngineRenderService {\n\tprivate readonly records = new Map<string, RenderRecord>();\n\tprivate session: AgentSession | undefined;\n\tprivate readonly write: (line: string) => void;\n\n\tconstructor(write: (line: string) => void) {\n\t\tthis.write = write;\n\t}\n\n\tbindSession(session: AgentSession): void {\n\t\tthis.dispose();\n\t\tthis.session = session;\n\t}\n\n\thandleLine(line: string): boolean {\n\t\tconst command = parseInteractiveEngineCommand(line);\n\t\tif (!command || !command.type.startsWith(\"engine_\") || command.type.startsWith(\"engine_custom_\")) return false;\n\t\tif (command.type === \"engine_render_dispose\") {\n\t\t\tthis.disposeRecord(command.componentId);\n\t\t\treturn true;\n\t\t}\n\t\tif (command.type !== \"engine_tool_render\" && command.type !== \"engine_message_render\") return false;\n\t\tconst name = command.type === \"engine_tool_render\" ? `tool:${command.toolName}` : `message:${command.message.customType ?? \"custom\"}`;\n\t\tvoid runCallback({ kind: \"renderer\", name }, async () => {\n\t\t\treturn command.type === \"engine_tool_render\" ? this.renderTool(command) : this.renderMessage(command);\n\t\t}).then((lines) => this.send({\n\t\t\ttype: \"engine_custom_frame\",\n\t\t\tcomponentId: command.componentId,\n\t\t\trequestId: command.requestId,\n\t\t\tlines,\n\t\t})).catch((error: Error) => this.send({\n\t\t\ttype: \"engine_custom_frame\",\n\t\t\tcomponentId: command.componentId,\n\t\t\trequestId: command.requestId,\n\t\t\tlines: [`Remote renderer failed: ${error.message}`],\n\t\t}));\n\t\treturn true;\n\t}\n\n\tdispose(): void {\n\t\tfor (const id of [...this.records.keys()]) this.disposeRecord(id);\n\t}\n\n\tprivate boundSession(): AgentSession {\n\t\tconst session = this.session;\n\t\tif (!session) throw new Error(\"Renderer session is not bound\");\n\t\treturn session;\n\t}\n\n\tprivate createTerminal(componentId: string): RenderTerminal {\n\t\treturn new RenderTerminal(() => this.send({ type: \"engine_custom_invalidate\", componentId }));\n\t}\n\n\tprivate renderTool(command: ToolRenderCommand): string[] {\n\t\tlet record = this.records.get(command.componentId);\n\t\tif (record?.kind !== \"tool\") {\n\t\t\tconst session = this.boundSession();\n\t\t\tthis.disposeRecord(command.componentId);\n\t\t\tconst terminal = this.createTerminal(command.componentId);\n\t\t\tterminal.columns = Math.max(1, command.width);\n\t\t\tconst tui = new TUI(terminal, undefined, getAgentDir());\n\t\t\tconst component = new ToolExecutionComponent(\n\t\t\t\tcommand.toolName,\n\t\t\t\tcommand.toolCallId,\n\t\t\t\tcommand.args,\n\t\t\t\t{ showImages: command.showImages, imageWidthCells: command.imageWidthCells },\n\t\t\t\tsession.getToolDefinition(command.toolName),\n\t\t\t\ttui,\n\t\t\t\tsession.sessionManager.getCwd(),\n\t\t\t);\n\t\t\ttui.addChild(component);\n\t\t\trecord = { kind: \"tool\", component, terminal, tui };\n\t\t\tthis.records.set(command.componentId, record);\n\t\t} else {\n\t\t\trecord.terminal.columns = Math.max(1, command.width);\n\t\t\trecord.component.updateArgs(command.args);\n\t\t\trecord.component.setShowImages(command.showImages);\n\t\t\trecord.component.setImageWidthCells(command.imageWidthCells);\n\t\t}\n\t\tconst tool = record.component;\n\t\tif (command.executionStarted) tool.markExecutionStarted();\n\t\tif (command.argsComplete) tool.setArgsComplete();\n\t\ttool.setExpanded(command.expanded);\n\t\tif (command.result) {\n\t\t\ttool.updateResult(command.result as unknown as Parameters<ToolExecutionComponent[\"updateResult\"]>[0], command.isPartial);\n\t\t}\n\t\treturn tool.render(command.width);\n\t}\n\n\tprivate renderMessage(command: MessageRenderCommand): string[] {\n\t\tlet record = this.records.get(command.componentId);\n\t\tif (record?.kind !== \"message\") {\n\t\t\tconst session = this.boundSession();\n\t\t\tthis.disposeRecord(command.componentId);\n\t\t\tconst terminal = this.createTerminal(command.componentId);\n\t\t\tterminal.columns = Math.max(1, command.width);\n\t\t\tconst tui = new TUI(terminal, undefined, getAgentDir());\n\t\t\tconst message = command.message as unknown as CustomMessage<object>;\n\t\t\tconst component = new CustomMessageComponent(\n\t\t\t\tmessage,\n\t\t\t\tsession.extensionRunner.getMessageRenderer(message.customType),\n\t\t\t\tundefined,\n\t\t\t\tcommand.outputPad,\n\t\t\t);\n\t\t\ttui.addChild(component);\n\t\t\trecord = { kind: \"message\", component, terminal, tui };\n\t\t\tthis.records.set(command.componentId, record);\n\t\t} else {\n\t\t\trecord.terminal.columns = Math.max(1, command.width);\n\t\t}\n\t\trecord.component.setExpanded(command.expanded);\n\t\trecord.component.setOutputPad(command.outputPad);\n\t\treturn record.component.render(command.width);\n\t}\n\n\tprivate disposeRecord(id: string): void {\n\t\tconst record = this.records.get(id);\n\t\tif (!record) return;\n\t\tthis.records.delete(id);\n\t\tif (record.kind === \"tool\") record.component.dispose();\n\t\trecord.tui.stop();\n\t}\n\n\tprivate send(message: InteractiveEngineMessage): void {\n\t\tthis.write(serializeInteractiveEngineMessage(message));\n\t}\n}\n"]}
+{"version":3,"file":"engine-render-service.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-render-service.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Terminal } from \"@earendil-works/pi-tui\";\nimport { TUI } from \"@earendil-works/pi-tui\";\nimport { getAgentDir } from \"../../config.ts\";\nimport type { AgentSession } from \"../../core/agent-session.ts\";\nimport { runCallback } from \"../../core/callback-activity.ts\";\nimport type { CustomMessage } from \"../../core/messages.ts\";\nimport { CustomMessageComponent } from \"../interactive/components/custom-message.ts\";\nimport { ToolExecutionComponent } from \"../interactive/components/tool-execution.ts\";\nimport {\n\ttype InteractiveEngineCommand,\n\ttype InteractiveEngineMessage,\n\tparseInteractiveEngineCommand,\n\tserializeInteractiveEngineMessage,\n} from \"./protocol.ts\";\n\ntype ToolRenderCommand = Extract<InteractiveEngineCommand, { type: \"engine_tool_render\" }>;\ntype MessageRenderCommand = Extract<InteractiveEngineCommand, { type: \"engine_message_render\" }>;\n\n/**\n * Cached per-componentId render state. Records are REUSED across render\n * requests: recreating (and re-seeding) the component on every request made\n * the seeding setters call `ui.requestRender()` each time, whose eventual\n * terminal write emitted `engine_custom_invalidate` back to the host, which\n * re-sent the render request — a self-sustaining host⇄engine render\n * ping-pong that presented as full-screen TUI flicker (quit/pause while a\n * workflow stage streams). Reuse plus idempotent seeding setters lets the\n * loop converge after at most one round trip while still forwarding\n * legitimate async invalidations (e.g. image conversion).\n */\ntype RenderRecord =\n\t| { kind: \"message\"; component: CustomMessageComponent; terminal: RenderTerminal; tui: TUI }\n\t| { kind: \"tool\"; component: ToolExecutionComponent; terminal: RenderTerminal; tui: TUI };\n\nclass RenderTerminal implements Terminal {\n\tcolumns = 80;\n\trows = 24;\n\tkittyProtocolActive = false;\n\tprivate readonly requestRender: () => void;\n\tconstructor(requestRender: () => void) {\n\t\tthis.requestRender = requestRender;\n\t}\n\tstart(): void {}\n\tstop(): void {}\n\tasync drainInput(): Promise<void> {}\n\twrite(): void {\n\t\tthis.requestRender();\n\t}\n\tmoveBy(): void {}\n\thideCursor(): void {}\n\tshowCursor(): void {}\n\tclearLine(): void {}\n\tclearFromCursor(): void {}\n\tclearScreen(): void {}\n\tsetTitle(): void {}\n\tsetProgress(): void {}\n}\n\nexport class EngineRenderService {\n\tprivate readonly records = new Map<string, RenderRecord>();\n\tprivate session: AgentSession | undefined;\n\tprivate readonly write: (line: string) => void;\n\n\tconstructor(write: (line: string) => void) {\n\t\tthis.write = write;\n\t}\n\n\tbindSession(session: AgentSession): void {\n\t\tthis.dispose();\n\t\tthis.session = session;\n\t}\n\n\thandleLine(line: string): boolean {\n\t\tconst command = parseInteractiveEngineCommand(line);\n\t\tif (!command?.type.startsWith(\"engine_\") || command.type.startsWith(\"engine_custom_\")) return false;\n\t\tif (command.type === \"engine_render_dispose\") {\n\t\t\tthis.disposeRecord(command.componentId);\n\t\t\treturn true;\n\t\t}\n\t\tif (command.type !== \"engine_tool_render\" && command.type !== \"engine_message_render\") return false;\n\t\tconst name =\n\t\t\tcommand.type === \"engine_tool_render\"\n\t\t\t\t? `tool:${command.toolName}`\n\t\t\t\t: `message:${command.message.customType ?? \"custom\"}`;\n\t\tvoid runCallback({ kind: \"renderer\", name }, async () => {\n\t\t\treturn command.type === \"engine_tool_render\" ? this.renderTool(command) : this.renderMessage(command);\n\t\t})\n\t\t\t.then((lines) =>\n\t\t\t\tthis.send({\n\t\t\t\t\ttype: \"engine_custom_frame\",\n\t\t\t\t\tcomponentId: command.componentId,\n\t\t\t\t\trequestId: command.requestId,\n\t\t\t\t\tlines,\n\t\t\t\t}),\n\t\t\t)\n\t\t\t.catch((error: Error) =>\n\t\t\t\tthis.send({\n\t\t\t\t\ttype: \"engine_custom_frame\",\n\t\t\t\t\tcomponentId: command.componentId,\n\t\t\t\t\trequestId: command.requestId,\n\t\t\t\t\tlines: [`Remote renderer failed: ${error.message}`],\n\t\t\t\t}),\n\t\t\t);\n\t\treturn true;\n\t}\n\n\tdispose(): void {\n\t\tfor (const id of [...this.records.keys()]) this.disposeRecord(id);\n\t}\n\n\tprivate boundSession(): AgentSession {\n\t\tconst session = this.session;\n\t\tif (!session) throw new Error(\"Renderer session is not bound\");\n\t\treturn session;\n\t}\n\n\tprivate createTerminal(componentId: string): RenderTerminal {\n\t\treturn new RenderTerminal(() => this.send({ type: \"engine_custom_invalidate\", componentId }));\n\t}\n\n\tprivate renderTool(command: ToolRenderCommand): string[] {\n\t\tlet record = this.records.get(command.componentId);\n\t\tif (record?.kind !== \"tool\") {\n\t\t\tconst session = this.boundSession();\n\t\t\tthis.disposeRecord(command.componentId);\n\t\t\tconst terminal = this.createTerminal(command.componentId);\n\t\t\tterminal.columns = Math.max(1, command.width);\n\t\t\tconst tui = new TUI(terminal, undefined, getAgentDir());\n\t\t\tconst component = new ToolExecutionComponent(\n\t\t\t\tcommand.toolName,\n\t\t\t\tcommand.toolCallId,\n\t\t\t\tcommand.args,\n\t\t\t\t{ showImages: command.showImages, imageWidthCells: command.imageWidthCells },\n\t\t\t\tsession.getToolDefinition(command.toolName),\n\t\t\t\ttui,\n\t\t\t\tsession.sessionManager.getCwd(),\n\t\t\t);\n\t\t\ttui.addChild(component);\n\t\t\trecord = { kind: \"tool\", component, terminal, tui };\n\t\t\tthis.records.set(command.componentId, record);\n\t\t} else {\n\t\t\trecord.terminal.columns = Math.max(1, command.width);\n\t\t\trecord.component.updateArgs(command.args);\n\t\t\trecord.component.setShowImages(command.showImages);\n\t\t\trecord.component.setImageWidthCells(command.imageWidthCells);\n\t\t}\n\t\tconst tool = record.component;\n\t\tif (command.executionStarted) tool.markExecutionStarted();\n\t\tif (command.argsComplete) tool.setArgsComplete();\n\t\ttool.setExpanded(command.expanded);\n\t\tif (command.result) {\n\t\t\ttool.updateResult(\n\t\t\t\tcommand.result as unknown as Parameters<ToolExecutionComponent[\"updateResult\"]>[0],\n\t\t\t\tcommand.isPartial,\n\t\t\t);\n\t\t}\n\t\treturn tool.render(command.width);\n\t}\n\n\tprivate renderMessage(command: MessageRenderCommand): string[] {\n\t\tlet record = this.records.get(command.componentId);\n\t\tif (record?.kind !== \"message\") {\n\t\t\tconst session = this.boundSession();\n\t\t\tthis.disposeRecord(command.componentId);\n\t\t\tconst terminal = this.createTerminal(command.componentId);\n\t\t\tterminal.columns = Math.max(1, command.width);\n\t\t\tconst tui = new TUI(terminal, undefined, getAgentDir());\n\t\t\tconst message = command.message as unknown as CustomMessage<object>;\n\t\t\tconst component = new CustomMessageComponent(\n\t\t\t\tmessage,\n\t\t\t\tsession.extensionRunner.getMessageRenderer(message.customType),\n\t\t\t\tundefined,\n\t\t\t\tcommand.outputPad,\n\t\t\t);\n\t\t\ttui.addChild(component);\n\t\t\trecord = { kind: \"message\", component, terminal, tui };\n\t\t\tthis.records.set(command.componentId, record);\n\t\t} else {\n\t\t\trecord.terminal.columns = Math.max(1, command.width);\n\t\t}\n\t\trecord.component.setExpanded(command.expanded);\n\t\trecord.component.setOutputPad(command.outputPad);\n\t\treturn record.component.render(command.width);\n\t}\n\n\tprivate disposeRecord(id: string): void {\n\t\tconst record = this.records.get(id);\n\t\tif (!record) return;\n\t\tthis.records.delete(id);\n\t\tif (record.kind === \"tool\") record.component.dispose();\n\t\trecord.tui.stop();\n\t}\n\n\tprivate send(message: InteractiveEngineMessage): void {\n\t\tthis.write(serializeInteractiveEngineMessage(message));\n\t}\n}\n"]}

package/dist/modes/interactive-engine/engine-session-picker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-session-picker.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-session-picker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,uBAAuB,EACvB,wBAAwB,EAExB,MAAM,mCAAmC,CAAC;AAa3C;;;;;;;;;GASG;AACH,qBAAa,0BAA0B;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAE/C,YAAY,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAExC;IAED,IAAI,CAAC,OAAO,EAAE,wBAAwB,GAAG,uBAAuB,CAqC/D;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAiChC;IAED,OAAO,IAAI,IAAI,CAGd;IAED,OAAO,CAAC,IAAI;CAGZ"}
+{"version":3,"file":"engine-session-picker.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-session-picker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,uBAAuB,EACvB,wBAAwB,EAExB,MAAM,mCAAmC,CAAC;AAa3C;;;;;;;;;GASG;AACH,qBAAa,0BAA0B;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAE/C,YAAY,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAExC;IAED,IAAI,CAAC,OAAO,EAAE,wBAAwB,GAAG,uBAAuB,CAuC/D;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAiChC;IAED,OAAO,IAAI,IAAI,CAGd;IAED,OAAO,CAAC,IAAI;CAGZ"}

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

@@ -18,7 +18,9 @@ export class EngineSessionPickerService {
     open(request) {
         const componentId = `session_picker_${++this.nextId}`;
         let resolveResult;
-        const result = new Promise((resolve) => { resolveResult = resolve; });
+        const result = new Promise((resolve) => {
+            resolveResult = resolve;
+        });
         const record = {
             settled: false,
             resolve: (path) => {
@@ -59,7 +61,7 @@ export class EngineSessionPickerService {
     }
     handleLine(line) {
         const command = parseInteractiveEngineCommand(line);
-        if (!command || !command.type.startsWith("engine_session_picker_"))
+        if (!command?.type.startsWith("engine_session_picker_"))
             return false;
         const record = this.active.get(command.componentId);
         if (!record)

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

@@ -1 +1 @@
-{"version":3,"file":"engine-session-picker.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-session-picker.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tHostSessionPickerHandle,\n\tHostSessionPickerRequest,\n\tHostSessionPickerRow,\n} from \"../../core/extensions/ui-types.ts\";\nimport {\n\tparseInteractiveEngineCommand,\n\tserializeInteractiveEngineMessage,\n\ttype InteractiveEngineMessage,\n} from \"./protocol.ts\";\n\ninterface ActivePicker {\n\tsettled: boolean;\n\tresolve: (path: string | undefined) => void;\n\tonDelete?: (path: string) => void | Promise<void>;\n}\n\n/**\n * Child-side half of the host-native session picker channel.\n *\n * Runs in the interactive-engine child and backs the optional\n * `ctx.ui.hostSessionPicker()` capability: `open()` ships JSON-safe rows to the\n * terminal host, which mounts the REAL `SessionSelectorComponent` locally so\n * arrow-key navigation and search never cross the process boundary. Only the\n * semantic events do — open/update/error/close travel child→host as engine\n * messages, and select/cancel/delete travel host→child as engine commands.\n */\nexport class EngineSessionPickerService {\n\tprivate readonly active = new Map<string, ActivePicker>();\n\tprivate nextId = 0;\n\tprivate readonly write: (line: string) => void;\n\n\tconstructor(write: (line: string) => void) {\n\t\tthis.write = write;\n\t}\n\n\topen(request: HostSessionPickerRequest): HostSessionPickerHandle {\n\t\tconst componentId = `session_picker_${++this.nextId}`;\n\t\tlet resolveResult!: (path: string | undefined) => void;\n\t\tconst result = new Promise<string | undefined>((resolve) => { resolveResult = resolve; });\n\t\tconst record: ActivePicker = {\n\t\t\tsettled: false,\n\t\t\tresolve: (path) => {\n\t\t\t\tif (record.settled) return;\n\t\t\t\trecord.settled = true;\n\t\t\t\tthis.active.delete(componentId);\n\t\t\t\tresolveResult(path);\n\t\t\t},\n\t\t\t...(request.onDelete ? { onDelete: request.onDelete } : {}),\n\t\t};\n\t\tthis.active.set(componentId, record);\n\t\tthis.send({\n\t\t\ttype: \"engine_session_picker_open\",\n\t\t\tcomponentId,\n\t\t\tsessions: [...request.sessions],\n\t\t\t...(request.showRenameHint !== undefined ? { showRenameHint: request.showRenameHint } : {}),\n\t\t});\n\t\treturn {\n\t\t\tresult,\n\t\t\tupdate: (sessions: HostSessionPickerRow[]) => {\n\t\t\t\tif (record.settled) return;\n\t\t\t\tthis.send({ type: \"engine_session_picker_update\", componentId, sessions: [...sessions] });\n\t\t\t},\n\t\t\terror: (message: string) => {\n\t\t\t\tif (record.settled) return;\n\t\t\t\tthis.send({ type: \"engine_session_picker_error\", componentId, message });\n\t\t\t},\n\t\t\tclose: () => {\n\t\t\t\tif (record.settled) return;\n\t\t\t\tthis.send({ type: \"engine_session_picker_close\", componentId });\n\t\t\t\trecord.resolve(undefined);\n\t\t\t},\n\t\t};\n\t}\n\n\thandleLine(line: string): boolean {\n\t\tconst command = parseInteractiveEngineCommand(line);\n\t\tif (!command || !command.type.startsWith(\"engine_session_picker_\")) return false;\n\t\tconst record = this.active.get(command.componentId);\n\t\tif (!record) return true;\n\t\tswitch (command.type) {\n\t\t\tcase \"engine_session_picker_select\":\n\t\t\t\trecord.resolve(command.path);\n\t\t\t\tbreak;\n\t\t\tcase \"engine_session_picker_cancel\":\n\t\t\t\trecord.resolve(undefined);\n\t\t\t\tbreak;\n\t\t\tcase \"engine_session_picker_delete\":\n\t\t\t\tif (!record.onDelete) {\n\t\t\t\t\tthis.send({\n\t\t\t\t\t\ttype: \"engine_session_picker_error\",\n\t\t\t\t\t\tcomponentId: command.componentId,\n\t\t\t\t\t\tmessage: \"Deletion is not supported for this picker\",\n\t\t\t\t\t});\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tvoid Promise.resolve(record.onDelete(command.path)).catch((error: unknown) => {\n\t\t\t\t\tif (record.settled) return;\n\t\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\t\tthis.send({\n\t\t\t\t\t\ttype: \"engine_session_picker_error\",\n\t\t\t\t\t\tcomponentId: command.componentId,\n\t\t\t\t\t\tmessage: `Failed to delete: ${message}`,\n\t\t\t\t\t});\n\t\t\t\t});\n\t\t\t\tbreak;\n\t\t}\n\t\treturn true;\n\t}\n\n\tdispose(): void {\n\t\tfor (const record of [...this.active.values()]) record.resolve(undefined);\n\t\tthis.active.clear();\n\t}\n\n\tprivate send(message: InteractiveEngineMessage): void {\n\t\tthis.write(serializeInteractiveEngineMessage(message));\n\t}\n}\n"]}
+{"version":3,"file":"engine-session-picker.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/engine-session-picker.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tHostSessionPickerHandle,\n\tHostSessionPickerRequest,\n\tHostSessionPickerRow,\n} from \"../../core/extensions/ui-types.ts\";\nimport {\n\ttype InteractiveEngineMessage,\n\tparseInteractiveEngineCommand,\n\tserializeInteractiveEngineMessage,\n} from \"./protocol.ts\";\n\ninterface ActivePicker {\n\tsettled: boolean;\n\tresolve: (path: string | undefined) => void;\n\tonDelete?: (path: string) => void | Promise<void>;\n}\n\n/**\n * Child-side half of the host-native session picker channel.\n *\n * Runs in the interactive-engine child and backs the optional\n * `ctx.ui.hostSessionPicker()` capability: `open()` ships JSON-safe rows to the\n * terminal host, which mounts the REAL `SessionSelectorComponent` locally so\n * arrow-key navigation and search never cross the process boundary. Only the\n * semantic events do — open/update/error/close travel child→host as engine\n * messages, and select/cancel/delete travel host→child as engine commands.\n */\nexport class EngineSessionPickerService {\n\tprivate readonly active = new Map<string, ActivePicker>();\n\tprivate nextId = 0;\n\tprivate readonly write: (line: string) => void;\n\n\tconstructor(write: (line: string) => void) {\n\t\tthis.write = write;\n\t}\n\n\topen(request: HostSessionPickerRequest): HostSessionPickerHandle {\n\t\tconst componentId = `session_picker_${++this.nextId}`;\n\t\tlet resolveResult!: (path: string | undefined) => void;\n\t\tconst result = new Promise<string | undefined>((resolve) => {\n\t\t\tresolveResult = resolve;\n\t\t});\n\t\tconst record: ActivePicker = {\n\t\t\tsettled: false,\n\t\t\tresolve: (path) => {\n\t\t\t\tif (record.settled) return;\n\t\t\t\trecord.settled = true;\n\t\t\t\tthis.active.delete(componentId);\n\t\t\t\tresolveResult(path);\n\t\t\t},\n\t\t\t...(request.onDelete ? { onDelete: request.onDelete } : {}),\n\t\t};\n\t\tthis.active.set(componentId, record);\n\t\tthis.send({\n\t\t\ttype: \"engine_session_picker_open\",\n\t\t\tcomponentId,\n\t\t\tsessions: [...request.sessions],\n\t\t\t...(request.showRenameHint !== undefined ? { showRenameHint: request.showRenameHint } : {}),\n\t\t});\n\t\treturn {\n\t\t\tresult,\n\t\t\tupdate: (sessions: HostSessionPickerRow[]) => {\n\t\t\t\tif (record.settled) return;\n\t\t\t\tthis.send({ type: \"engine_session_picker_update\", componentId, sessions: [...sessions] });\n\t\t\t},\n\t\t\terror: (message: string) => {\n\t\t\t\tif (record.settled) return;\n\t\t\t\tthis.send({ type: \"engine_session_picker_error\", componentId, message });\n\t\t\t},\n\t\t\tclose: () => {\n\t\t\t\tif (record.settled) return;\n\t\t\t\tthis.send({ type: \"engine_session_picker_close\", componentId });\n\t\t\t\trecord.resolve(undefined);\n\t\t\t},\n\t\t};\n\t}\n\n\thandleLine(line: string): boolean {\n\t\tconst command = parseInteractiveEngineCommand(line);\n\t\tif (!command?.type.startsWith(\"engine_session_picker_\")) return false;\n\t\tconst record = this.active.get(command.componentId);\n\t\tif (!record) return true;\n\t\tswitch (command.type) {\n\t\t\tcase \"engine_session_picker_select\":\n\t\t\t\trecord.resolve(command.path);\n\t\t\t\tbreak;\n\t\t\tcase \"engine_session_picker_cancel\":\n\t\t\t\trecord.resolve(undefined);\n\t\t\t\tbreak;\n\t\t\tcase \"engine_session_picker_delete\":\n\t\t\t\tif (!record.onDelete) {\n\t\t\t\t\tthis.send({\n\t\t\t\t\t\ttype: \"engine_session_picker_error\",\n\t\t\t\t\t\tcomponentId: command.componentId,\n\t\t\t\t\t\tmessage: \"Deletion is not supported for this picker\",\n\t\t\t\t\t});\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tvoid Promise.resolve(record.onDelete(command.path)).catch((error: unknown) => {\n\t\t\t\t\tif (record.settled) return;\n\t\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\t\tthis.send({\n\t\t\t\t\t\ttype: \"engine_session_picker_error\",\n\t\t\t\t\t\tcomponentId: command.componentId,\n\t\t\t\t\t\tmessage: `Failed to delete: ${message}`,\n\t\t\t\t\t});\n\t\t\t\t});\n\t\t\t\tbreak;\n\t\t}\n\t\treturn true;\n\t}\n\n\tdispose(): void {\n\t\tfor (const record of [...this.active.values()]) record.resolve(undefined);\n\t\tthis.active.clear();\n\t}\n\n\tprivate send(message: InteractiveEngineMessage): void {\n\t\tthis.write(serializeInteractiveEngineMessage(message));\n\t}\n}\n"]}

package/dist/modes/interactive-engine/extension-ui-bridge.d.ts

@@ -1,18 +1,29 @@
 import type { AgentSessionRuntime } from "../../core/agent-session-runtime.ts";
 import type { ResourceOverlap } from "../../core/diagnostics.ts";
-import type { KeybindingsManager } from "../../core/keybindings.ts";
 import type { ExtensionUIContext } from "../../core/extensions/index.ts";
+import type { KeybindingsManager } from "../../core/keybindings.ts";
+import type { RpcAutocompleteItem, RpcSlashCommand } from "../rpc/rpc-types.ts";
 import type { ActivityWatchdogDiagnostic } from "./activity-watchdog.ts";
 import type { EngineKeybindingState, InteractiveEngineMessage } from "./protocol.ts";
-import type { RpcAutocompleteItem, RpcSlashCommand } from "../rpc/rpc-types.ts";
 interface EngineMessageSource {
     onEngineMessage(listener: (message: InteractiveEngineMessage) => void): () => void;
     onKeybindingState?(listener: (state: EngineKeybindingState) => void): () => void;
 }
 export declare function attachInteractiveEngineKeybindingSync(runtime: EngineMessageSource, keybindings: KeybindingsManager, onState?: (state: EngineKeybindingState) => void): () => void;
-export declare function attachInteractiveEngineHost(runtime: AgentSessionRuntime, ui: ExtensionUIContext, onDiagnostic: (diagnostic: ActivityWatchdogDiagnostic) => void, setShortcutHandler?: (handler: (data: string) => boolean) => void | (() => void), keybindings?: KeybindingsManager): () => void;
+export declare function attachInteractiveEngineHost(runtime: AgentSessionRuntime, ui: ExtensionUIContext, onDiagnostic: (diagnostic: ActivityWatchdogDiagnostic) => void, setShortcutHandler?: (handler: (data: string) => boolean) => undefined | (() => void), keybindings?: KeybindingsManager): () => void;
 export declare function waitForInteractiveEngineBound(runtime: AgentSessionRuntime): Promise<void>;
 export declare function interruptBlockedInteractiveEngine(runtime: AgentSessionRuntime): boolean;
+/**
+ * True when the interactive engine still owes a cooperative abort or the
+ * heartbeat watchdog has declared it unresponsive, i.e. when the explicit
+ * Ctrl+C escape hatch promised by the watchdog copy applies.
+ */
+export declare function interactiveEngineNeedsExplicitTermination(runtime: AgentSessionRuntime): boolean;
+/**
+ * Explicitly terminate an unresponsive interactive engine and start recovery.
+ * Only ever reached from a deliberate user action (Ctrl+C) — never from Escape.
+ */
+export declare function terminateInteractiveEngine(runtime: AgentSessionRuntime): boolean;
 /**
  * Command catalog the engine child exposes to the isolated host. Returns an
  * empty list for non-isolated runtimes so callers can merge unconditionally.