devharness 0.8.0

package/build/supervisor/pidfile.test.js.map

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

package/build/supervisor/restart-coordinator.d.ts

@@ -0,0 +1,73 @@
+export type SupervisorPhase = 'ready' | 'restarting' | 'idle-gave-up' | 'suspending' | 'suspended';
+export interface RestartCoordinatorDeps {
+    writeToChild: (line: string) => void;
+    writeToHost: (line: string) => void;
+    killChild: () => Promise<void>;
+    /**
+     * Ask the child to release everything it holds and exit - a deeper teardown
+     * than killChild(), which leaves managed dev servers running.
+     */
+    suspendChild?: () => Promise<void>;
+    spawnChild: () => void;
+    logStderr: (message: string) => void;
+}
+export interface RestartCoordinatorOptions {
+    maxCrashAttempts?: number;
+    crashBackoffBaseMs?: number;
+    crashBackoffCapMs?: number;
+    stabilityThresholdMs?: number;
+}
+export declare class RestartCoordinator {
+    private readonly deps;
+    private phase;
+    private hasSeenFirstInit;
+    private initRequestLine;
+    private initRequestId;
+    private initializedLine;
+    private awaitingReplayResponseId;
+    private initAnswered;
+    private inFlight;
+    private abandonedIds;
+    /** Host lines that arrived while the suspending child was still exiting. */
+    private suspendQueue;
+    private expectingExit;
+    private crashAttempt;
+    private crashBackoffTimer;
+    private stabilityTimer;
+    private readonly maxCrashAttempts;
+    private readonly crashBackoffBaseMs;
+    private readonly crashBackoffCapMs;
+    private readonly stabilityThresholdMs;
+    constructor(deps: RestartCoordinatorDeps, options?: RestartCoordinatorOptions);
+    getPhase(): SupervisorPhase;
+    /** A raw NDJSON line arrived from the host, headed for the child. */
+    handleHostLine(line: string): void;
+    /** A raw NDJSON line arrived from the (current) child, headed for the host. */
+    handleChildLine(line: string): void;
+    /** The current child's stdout stream closed - no more late responses possible from it. */
+    onChildStdoutClosed(): void;
+    /**
+     * Call before deliberately killing the child as part of supervisor shutdown
+     * (not a restart - no respawn follows). Without this, the child's resulting
+     * 'exit' event would be indistinguishable from a real crash.
+     */
+    prepareForShutdown(): void;
+    /** The current child process exited (fires for both deliberate kills and crashes). */
+    onChildExit(): void;
+    /** Explicit restart trigger (SIGUSR2, wired to a postbuild hook or sent manually). */
+    requestRestart(reason: string): void;
+    /**
+     * Idle timeout reached: drop the child and everything it holds, and stay
+     * resident on the host's stdio so the connection itself survives. The next
+     * host line respawns via handleHostLine().
+     *
+     * Only ever suspends from a settled 'ready' state - suspending mid-restart
+     * or while the crash backoff is deciding what to do would race with it.
+     */
+    suspend(reason: string): void;
+    private spawnAndReplay;
+    private synthesizeErrorsForAllInFlight;
+    private sendSynthesizedError;
+    private clearStabilityTimer;
+}
+//# sourceMappingURL=restart-coordinator.d.ts.map

package/build/supervisor/restart-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-coordinator.d.ts","sourceRoot":"","sources":["../../src/supervisor/restart-coordinator.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,CAAC;AAEnG,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAID,qBAAa,kBAAkB;IA8BjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IA7BjC,OAAO,CAAC,KAAK,CAA4B;IAEzC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,wBAAwB,CAAgC;IAMhE,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO,CAAC,QAAQ,CAAkD;IAClE,OAAO,CAAC,YAAY,CAA8B;IAClD,4EAA4E;IAC5E,OAAO,CAAC,YAAY,CAAgB;IAEpC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,iBAAiB,CAA8C;IACvE,OAAO,CAAC,cAAc,CAA8C;IAEpE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;gBAEjB,IAAI,EAAE,sBAAsB,EAAE,OAAO,GAAE,yBAA8B;IAOlG,QAAQ,IAAI,eAAe;IAI3B,qEAAqE;IACrE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAqElC,+EAA+E;IAC/E,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAqBnC,0FAA0F;IAC1F,mBAAmB,IAAI,IAAI;IAI3B;;;;OAIG;IACH,kBAAkB,IAAI,IAAI;IAS1B,sFAAsF;IACtF,WAAW,IAAI,IAAI;IA0BnB,sFAAsF;IACtF,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAkCpC;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAiC7B,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,8BAA8B;IAQtC,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,mBAAmB;CAM5B"}

package/build/supervisor/restart-coordinator.js

@@ -0,0 +1,300 @@
+/**
+ * The protocol-level restart state machine. Deliberately built against
+ * injected functions rather than real streams/processes so it's unit
+ * testable with plain spies (see restart-coordinator.test.ts).
+ *
+ * Responsibilities:
+ * - Proxy host<->child JSON-RPC lines verbatim in steady state.
+ * - Capture the first `initialize` request + `notifications/initialized`
+ *   notification so they can be replayed to a freshly spawned child (a
+ *   second `initialize` on a fresh process is harmless/idempotent per the
+ *   MCP SDK - it has no "already initialized" guard - but the *response* to
+ *   a replayed initialize must be swallowed, since the host already
+ *   consumed its original response and isn't expecting a second one).
+ * - Synthesize an error response for any request left dangling by a dying
+ *   child (deliberate restart or crash), so the host never hangs waiting
+ *   for an answer that will never arrive.
+ * - Back off and eventually give up on repeated unplanned crashes.
+ * - Suspend an idle session: let the child (and everything it holds - Chrome,
+ *   dev servers, monitor buffers) go, while this supervisor stays resident on
+ *   the host's stdio, and bring a fresh child back on the next host line.
+ */
+import { classifyLine, serializeMessage } from './ndjson-reader.js';
+const CONNECTION_CLOSED_ERROR_CODE = -32000; // matches the SDK's own ErrorCode.ConnectionClosed
+export class RestartCoordinator {
+    deps;
+    phase = 'ready';
+    hasSeenFirstInit = false;
+    initRequestLine = null;
+    initRequestId = null;
+    initializedLine = null;
+    awaitingReplayResponseId = null;
+    // True once the host has received a real answer to its original `initialize`.
+    // Only then do we swallow a *replayed* init's response on a later restart -
+    // if a restart happens before the host ever got its first answer, the new
+    // child's response must flow through normally instead, or the host would
+    // hang forever waiting for a response we ate.
+    initAnswered = false;
+    inFlight = new Map();
+    abandonedIds = new Set();
+    /** Host lines that arrived while the suspending child was still exiting. */
+    suspendQueue = [];
+    expectingExit = false;
+    crashAttempt = 0;
+    crashBackoffTimer = null;
+    stabilityTimer = null;
+    maxCrashAttempts;
+    crashBackoffBaseMs;
+    crashBackoffCapMs;
+    stabilityThresholdMs;
+    constructor(deps, options = {}) {
+        this.deps = deps;
+        this.maxCrashAttempts = options.maxCrashAttempts ?? 10;
+        this.crashBackoffBaseMs = options.crashBackoffBaseMs ?? 500;
+        this.crashBackoffCapMs = options.crashBackoffCapMs ?? 30000;
+        this.stabilityThresholdMs = options.stabilityThresholdMs ?? 10000;
+    }
+    getPhase() {
+        return this.phase;
+    }
+    /** A raw NDJSON line arrived from the host, headed for the child. */
+    handleHostLine(line) {
+        const parsed = classifyLine(line);
+        // A line that lands while the old child is still going down waits for it:
+        // spawning a replacement now would leave two children alive at once, and
+        // erroring the request would punish the user for the timing of their own
+        // first call back.
+        if (this.phase === 'suspending') {
+            this.suspendQueue.push(line);
+            return;
+        }
+        // Any traffic at all means the session is alive again - bring the child
+        // back before handling the line, so this very request is the one that
+        // resumes us rather than the one that gets an error.
+        if (this.phase === 'suspended') {
+            this.deps.logStderr('Host activity after suspend; respawning child');
+            this.spawnAndReplay();
+        }
+        if (this.phase !== 'ready') {
+            if (parsed.kind === 'request') {
+                this.sendSynthesizedError(parsed.id);
+            }
+            else {
+                this.deps.logStderr(`Dropping host ${parsed.kind} received while phase=${this.phase}`);
+            }
+            return;
+        }
+        let isCapturedInitRequest = false;
+        if (!this.hasSeenFirstInit && parsed.kind === 'request' && parsed.method === 'initialize') {
+            this.hasSeenFirstInit = true;
+            this.initRequestLine = line;
+            this.initRequestId = parsed.id;
+            isCapturedInitRequest = true;
+        }
+        else if (this.initRequestLine &&
+            !this.initializedLine &&
+            parsed.kind === 'notification' &&
+            parsed.method === 'notifications/initialized') {
+            this.initializedLine = line;
+        }
+        // A cancelled request never gets a response - MCP forbids answering one -
+        // so its id would sit in `inFlight` forever, and since suspend refuses to
+        // run with anything in flight, one Esc during a long tool call would
+        // silently disable idle suspend for the rest of the session.
+        if (parsed.kind === 'notification' && parsed.method === 'notifications/cancelled') {
+            const cancelledId = parsed.raw?.params?.requestId;
+            if (cancelledId !== undefined && this.inFlight.delete(cancelledId)) {
+                // Should a late response arrive anyway, swallow it: the host has moved on.
+                this.abandonedIds.add(cancelledId);
+                this.deps.logStderr(`Host cancelled request ${cancelledId}; no longer awaiting a response`);
+            }
+        }
+        // The captured init request's lifecycle is managed separately (via
+        // initAnswered/awaitingReplayResponseId below), not the generic in-flight
+        // map - otherwise a restart before its real answer arrives would
+        // synthesize a premature error for it in addition to the eventual real
+        // (or replayed) response, double-delivering to the host.
+        if (parsed.kind === 'request' && !isCapturedInitRequest) {
+            this.inFlight.set(parsed.id, { method: parsed.method });
+        }
+        this.deps.writeToChild(line);
+    }
+    /** A raw NDJSON line arrived from the (current) child, headed for the host. */
+    handleChildLine(line) {
+        const parsed = classifyLine(line);
+        if (parsed.kind === 'response') {
+            if (this.awaitingReplayResponseId !== null && parsed.id === this.awaitingReplayResponseId) {
+                this.awaitingReplayResponseId = null;
+                return; // swallow - host already has the original initialize response
+            }
+            if (this.abandonedIds.has(parsed.id)) {
+                this.abandonedIds.delete(parsed.id);
+                return; // late response for an id we already answered synthetically
+            }
+            this.inFlight.delete(parsed.id);
+            if (this.initRequestId !== null && parsed.id === this.initRequestId) {
+                this.initAnswered = true;
+            }
+        }
+        this.deps.writeToHost(line);
+    }
+    /** The current child's stdout stream closed - no more late responses possible from it. */
+    onChildStdoutClosed() {
+        this.abandonedIds.clear();
+    }
+    /**
+     * Call before deliberately killing the child as part of supervisor shutdown
+     * (not a restart - no respawn follows). Without this, the child's resulting
+     * 'exit' event would be indistinguishable from a real crash.
+     */
+    prepareForShutdown() {
+        this.expectingExit = true;
+        if (this.crashBackoffTimer) {
+            clearTimeout(this.crashBackoffTimer);
+            this.crashBackoffTimer = null;
+        }
+        this.clearStabilityTimer();
+    }
+    /** The current child process exited (fires for both deliberate kills and crashes). */
+    onChildExit() {
+        if (this.expectingExit) {
+            // requestRestart()'s own flow (awaiting killChild()) drives what happens next.
+            return;
+        }
+        this.clearStabilityTimer();
+        this.synthesizeErrorsForAllInFlight();
+        this.crashAttempt++;
+        if (this.crashAttempt > this.maxCrashAttempts) {
+            this.phase = 'idle-gave-up';
+            this.deps.logStderr(`Giving up after ${this.crashAttempt - 1} consecutive crashes; waiting for an explicit restart trigger.`);
+            return;
+        }
+        const delay = Math.min(this.crashBackoffBaseMs * Math.pow(2, this.crashAttempt - 1), this.crashBackoffCapMs);
+        this.phase = 'restarting';
+        this.deps.logStderr(`Child crashed (attempt ${this.crashAttempt}/${this.maxCrashAttempts}), respawning in ${delay}ms`);
+        this.crashBackoffTimer = setTimeout(() => {
+            this.crashBackoffTimer = null;
+            this.spawnAndReplay();
+        }, delay);
+    }
+    /** Explicit restart trigger (SIGUSR2, wired to a postbuild hook or sent manually). */
+    requestRestart(reason) {
+        if (this.phase === 'restarting') {
+            this.deps.logStderr(`Restart already in progress, ignoring additional trigger (${reason})`);
+            return;
+        }
+        if (this.phase === 'suspending' || this.phase === 'suspended') {
+            // Nothing is running to restart, and the next host line will spawn a
+            // child from whatever is on disk by then - which for a rebuild trigger
+            // is exactly the new build.
+            this.deps.logStderr(`Suspended, so ignoring restart trigger (${reason}); next request spawns a fresh child`);
+            return;
+        }
+        if (this.phase === 'idle-gave-up') {
+            this.crashAttempt = 0;
+        }
+        if (this.crashBackoffTimer) {
+            clearTimeout(this.crashBackoffTimer);
+            this.crashBackoffTimer = null;
+        }
+        this.clearStabilityTimer();
+        this.phase = 'restarting';
+        this.synthesizeErrorsForAllInFlight();
+        this.expectingExit = true;
+        this.deps
+            .killChild()
+            .catch((err) => this.deps.logStderr(`killChild() failed (continuing anyway): ${err}`))
+            .then(() => {
+            this.expectingExit = false;
+            this.spawnAndReplay();
+        });
+    }
+    /**
+     * Idle timeout reached: drop the child and everything it holds, and stay
+     * resident on the host's stdio so the connection itself survives. The next
+     * host line respawns via handleHostLine().
+     *
+     * Only ever suspends from a settled 'ready' state - suspending mid-restart
+     * or while the crash backoff is deciding what to do would race with it.
+     */
+    suspend(reason) {
+        if (this.phase !== 'ready') {
+            this.deps.logStderr(`Not suspending while phase=${this.phase}`);
+            return;
+        }
+        if (this.inFlight.size > 0) {
+            this.deps.logStderr(`Not suspending with ${this.inFlight.size} request(s) in flight`);
+            return;
+        }
+        this.deps.logStderr(`Suspending idle child (${reason})`);
+        this.clearStabilityTimer();
+        this.phase = 'suspending';
+        this.expectingExit = true;
+        const teardown = this.deps.suspendChild ?? this.deps.killChild;
+        teardown()
+            .catch((err) => this.deps.logStderr(`suspendChild() failed (continuing anyway): ${err}`))
+            .then(() => {
+            // No child is running now, so nothing is left to report an exit we
+            // would have to distinguish from a crash.
+            this.expectingExit = false;
+            this.crashAttempt = 0;
+            this.phase = 'suspended';
+            const queued = this.suspendQueue;
+            this.suspendQueue = [];
+            for (const queuedLine of queued) {
+                this.handleHostLine(queuedLine);
+            }
+        });
+    }
+    spawnAndReplay() {
+        this.deps.spawnChild();
+        if (this.initRequestLine && this.initRequestId !== null) {
+            // Only swallow the replayed init's response if the host already has a
+            // real answer from before - otherwise it's still waiting for its very
+            // first one, so let this response flow through normally instead.
+            if (this.initAnswered) {
+                this.awaitingReplayResponseId = this.initRequestId;
+            }
+            this.deps.writeToChild(this.initRequestLine);
+            if (this.initializedLine) {
+                this.deps.writeToChild(this.initializedLine);
+            }
+        }
+        this.phase = 'ready';
+        this.stabilityTimer = setTimeout(() => {
+            this.crashAttempt = 0;
+        }, this.stabilityThresholdMs);
+        // Best-effort: the host may have cached tool schemas from the original
+        // initialize; if a rebuild changed one, this nudges a compliant host to
+        // re-fetch. Only relevant once a real handshake has actually happened
+        // (never fires for the very first startup spawn, which doesn't go
+        // through this method at all).
+        if (this.initRequestLine) {
+            this.deps.writeToHost(serializeMessage({ jsonrpc: '2.0', method: 'notifications/tools/list_changed' }));
+        }
+    }
+    synthesizeErrorsForAllInFlight() {
+        for (const id of this.inFlight.keys()) {
+            this.abandonedIds.add(id);
+            this.sendSynthesizedError(id);
+        }
+        this.inFlight.clear();
+    }
+    sendSynthesizedError(id) {
+        this.deps.writeToHost(serializeMessage({
+            jsonrpc: '2.0',
+            id,
+            error: {
+                code: CONNECTION_CLOSED_ERROR_CODE,
+                message: 'MCP server is restarting; this request will not receive a response from the previous process. Please retry.',
+            },
+        }));
+    }
+    clearStabilityTimer() {
+        if (this.stabilityTimer) {
+            clearTimeout(this.stabilityTimer);
+            this.stabilityTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=restart-coordinator.js.map

package/build/supervisor/restart-coordinator.js.map

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

package/build/supervisor/restart-coordinator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=restart-coordinator.test.d.ts.map

package/build/supervisor/restart-coordinator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-coordinator.test.d.ts","sourceRoot":"","sources":["../../src/supervisor/restart-coordinator.test.ts"],"names":[],"mappings":""}