devharness 0.8.0

package/build/supervisor/client-watcher.test.js.map

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

package/build/supervisor/idle-config.d.ts

@@ -0,0 +1,30 @@
+export declare const DEFAULT_IDLE_SUSPEND_MINUTES = 120;
+export declare const DEFAULT_CLIENT_POLL_SECONDS = 60;
+export interface SupervisorSessionConfig {
+    /** Minutes of host silence before the child is suspended. 0 disables it. */
+    idleSuspendMinutes: number;
+    /** How often to check the MCP client is still alive. */
+    clientPollSeconds: number;
+}
+/**
+ * How often to test for idleness, given the threshold.
+ *
+ * A quarter of the threshold, so a suspend lands within ~25% of it, but never
+ * more often than every 5 minutes - at the 2h default that is 5 minutes, and
+ * the timer is otherwise doing nothing all day. The 1s floor only matters for
+ * the sub-minute thresholds used by the stress harness.
+ *
+ * Pure and exported so the production timings are actually tested, rather than
+ * only reasoned about: the default threshold is too long to wait out in a test.
+ */
+export declare function idleCheckIntervalMs(idleThresholdMs: number): number;
+export interface ReadSessionConfigDeps {
+    /** Path to config.json, as resolved by getConfigPath(). */
+    configPath: string;
+    /** Path to ~/.cdp-tools/config.json, followed when the local file defers to it. */
+    globalConfigPath?: string;
+    env?: NodeJS.ProcessEnv;
+    readFile?: (path: string) => string;
+}
+export declare function readSupervisorSessionConfig(deps: ReadSessionConfigDeps): SupervisorSessionConfig;
+//# sourceMappingURL=idle-config.d.ts.map

package/build/supervisor/idle-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle-config.d.ts","sourceRoot":"","sources":["../../src/supervisor/idle-config.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAChD,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAWD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,qBAAqB,GAAG,uBAAuB,CAyChG"}

package/build/supervisor/idle-config.js

@@ -0,0 +1,76 @@
+/**
+ * Reads the idle-suspend settings for the supervisor.
+ *
+ * The supervisor runs before (and outlives) the real server, and deliberately
+ * stays free of the server's module graph - so it cannot use ConfigManager,
+ * which loads Zod, the debug logger and everything downstream of them. It
+ * reads the same `.cdp-tools/config.json` directly instead, and falls back to
+ * the shipped defaults on anything unreadable.
+ *
+ * Precedence: env var > config file > default.
+ */
+import { readFileSync } from 'fs';
+export const DEFAULT_IDLE_SUSPEND_MINUTES = 120;
+export const DEFAULT_CLIENT_POLL_SECONDS = 60;
+function readNumber(value) {
+    // `Number('')` is 0, which would read as a deliberate "never suspend" - an
+    // empty exported env var is an accident, not a setting.
+    if (typeof value === 'string' && value.trim() === '')
+        return null;
+    const parsed = typeof value === 'string' ? Number(value) : value;
+    if (typeof parsed !== 'number' || !Number.isFinite(parsed) || parsed < 0)
+        return null;
+    return parsed;
+}
+/**
+ * How often to test for idleness, given the threshold.
+ *
+ * A quarter of the threshold, so a suspend lands within ~25% of it, but never
+ * more often than every 5 minutes - at the 2h default that is 5 minutes, and
+ * the timer is otherwise doing nothing all day. The 1s floor only matters for
+ * the sub-minute thresholds used by the stress harness.
+ *
+ * Pure and exported so the production timings are actually tested, rather than
+ * only reasoned about: the default threshold is too long to wait out in a test.
+ */
+export function idleCheckIntervalMs(idleThresholdMs) {
+    return Math.max(1_000, Math.min(idleThresholdMs / 4, 5 * 60_000));
+}
+export function readSupervisorSessionConfig(deps) {
+    const env = deps.env ?? process.env;
+    const read = deps.readFile ?? ((p) => readFileSync(p, 'utf-8'));
+    const readSession = (path) => {
+        try {
+            const parsed = JSON.parse(read(path));
+            if (!parsed || typeof parsed !== 'object')
+                return { session: null, deferred: false };
+            const session = typeof parsed.session === 'object' && parsed.session ? parsed.session : null;
+            return { session, deferred: parsed.configLocation === 'global' };
+        }
+        catch {
+            // No config file yet, or unreadable/corrupt - defaults are fine.
+            return { session: null, deferred: false };
+        }
+    };
+    const local = readSession(deps.configPath);
+    let fromFile = local.session ?? {};
+    // `config({ action: 'useGlobal' })` leaves a local stub holding nothing but
+    // `configLocation: 'global'`, and getConfigPath() returns that stub because
+    // it exists. Reading only it would silently ignore the settings the user
+    // actually wrote, in the file the config tool shows them.
+    if (local.deferred && !local.session && deps.globalConfigPath) {
+        fromFile = readSession(deps.globalConfigPath).session ?? {};
+    }
+    const idleSuspendMinutes = readNumber(env.CDP_TOOLS_IDLE_SUSPEND_MINUTES) ??
+        readNumber(fromFile.idleSuspendMinutes) ??
+        DEFAULT_IDLE_SUSPEND_MINUTES;
+    const clientPollSeconds = readNumber(env.CDP_TOOLS_CLIENT_POLL_SECONDS) ??
+        readNumber(fromFile.clientPollSeconds) ??
+        DEFAULT_CLIENT_POLL_SECONDS;
+    return {
+        idleSuspendMinutes,
+        // A zero poll interval would spin; treat it as "use the default".
+        clientPollSeconds: clientPollSeconds > 0 ? clientPollSeconds : DEFAULT_CLIENT_POLL_SECONDS,
+    };
+}
+//# sourceMappingURL=idle-config.js.map

package/build/supervisor/idle-config.js.map

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

package/build/supervisor/idle-config.test.d.ts

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

package/build/supervisor/idle-config.test.d.ts.map

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

package/build/supervisor/idle-config.test.js

@@ -0,0 +1,119 @@
+import { describe, it, expect } from 'vitest';
+import { readSupervisorSessionConfig, idleCheckIntervalMs, DEFAULT_IDLE_SUSPEND_MINUTES, DEFAULT_CLIENT_POLL_SECONDS, } from './idle-config.js';
+const NO_FILE = () => {
+    throw new Error('ENOENT');
+};
+describe('readSupervisorSessionConfig', () => {
+    it('falls back to defaults with no config file', () => {
+        const config = readSupervisorSessionConfig({ configPath: '/nope.json', env: {}, readFile: NO_FILE });
+        expect(config).toEqual({
+            idleSuspendMinutes: DEFAULT_IDLE_SUSPEND_MINUTES,
+            clientPollSeconds: DEFAULT_CLIENT_POLL_SECONDS,
+        });
+    });
+    it('reads the session section from the config file', () => {
+        const config = readSupervisorSessionConfig({
+            configPath: '/config.json',
+            env: {},
+            readFile: () => JSON.stringify({ session: { idleSuspendMinutes: 30, clientPollSeconds: 15 } }),
+        });
+        expect(config).toEqual({ idleSuspendMinutes: 30, clientPollSeconds: 15 });
+    });
+    it('lets the environment override the file', () => {
+        const config = readSupervisorSessionConfig({
+            configPath: '/config.json',
+            env: { CDP_TOOLS_IDLE_SUSPEND_MINUTES: '5' },
+            readFile: () => JSON.stringify({ session: { idleSuspendMinutes: 30 } }),
+        });
+        expect(config.idleSuspendMinutes).toBe(5);
+    });
+    it('keeps 0 as an explicit "never suspend"', () => {
+        const config = readSupervisorSessionConfig({
+            configPath: '/config.json',
+            env: {},
+            readFile: () => JSON.stringify({ session: { idleSuspendMinutes: 0 } }),
+        });
+        expect(config.idleSuspendMinutes).toBe(0);
+    });
+    it('ignores a zero or negative poll interval rather than spinning', () => {
+        const config = readSupervisorSessionConfig({
+            configPath: '/config.json',
+            env: {},
+            readFile: () => JSON.stringify({ session: { clientPollSeconds: 0 } }),
+        });
+        expect(config.clientPollSeconds).toBe(DEFAULT_CLIENT_POLL_SECONDS);
+    });
+    it('falls back to defaults on a corrupt config file', () => {
+        const config = readSupervisorSessionConfig({
+            configPath: '/config.json',
+            env: {},
+            readFile: () => '{ not json',
+        });
+        expect(config.idleSuspendMinutes).toBe(DEFAULT_IDLE_SUSPEND_MINUTES);
+    });
+    it('ignores non-numeric values', () => {
+        const config = readSupervisorSessionConfig({
+            configPath: '/config.json',
+            env: { CDP_TOOLS_IDLE_SUSPEND_MINUTES: 'soon' },
+            readFile: () => JSON.stringify({ session: { idleSuspendMinutes: 'later' } }),
+        });
+        expect(config.idleSuspendMinutes).toBe(DEFAULT_IDLE_SUSPEND_MINUTES);
+    });
+});
+describe('readSupervisorSessionConfig - global config', () => {
+    it('follows configLocation global when the local file is only a stub', () => {
+        // `config({ action: 'useGlobal' })` leaves exactly this stub behind, and
+        // getConfigPath() returns it because it exists.
+        const files = {
+            '/local.json': JSON.stringify({ configLocation: 'global' }),
+            '/global.json': JSON.stringify({ session: { idleSuspendMinutes: 0 } }),
+        };
+        const config = readSupervisorSessionConfig({
+            configPath: '/local.json',
+            globalConfigPath: '/global.json',
+            env: {},
+            readFile: (path) => files[path] ?? (() => { throw new Error('ENOENT'); })(),
+        });
+        expect(config.idleSuspendMinutes).toBe(0);
+    });
+    it('prefers a local session section over the global file', () => {
+        const files = {
+            '/local.json': JSON.stringify({ configLocation: 'global', session: { idleSuspendMinutes: 45 } }),
+            '/global.json': JSON.stringify({ session: { idleSuspendMinutes: 5 } }),
+        };
+        const config = readSupervisorSessionConfig({
+            configPath: '/local.json',
+            globalConfigPath: '/global.json',
+            env: {},
+            readFile: (path) => files[path],
+        });
+        expect(config.idleSuspendMinutes).toBe(45);
+    });
+    it('treats an empty env var as unset rather than as "never suspend"', () => {
+        const config = readSupervisorSessionConfig({
+            configPath: '/nope.json',
+            env: { CDP_TOOLS_IDLE_SUSPEND_MINUTES: '' },
+            readFile: () => { throw new Error('ENOENT'); },
+        });
+        expect(config.idleSuspendMinutes).toBe(DEFAULT_IDLE_SUSPEND_MINUTES);
+    });
+});
+describe('idleCheckIntervalMs', () => {
+    it('checks every 5 minutes at the shipped 2 hour default', () => {
+        // The production timing, verified directly rather than inferred: two hours
+        // is too long to wait out in a test, so the arithmetic is the thing tested.
+        const thresholdMs = DEFAULT_IDLE_SUSPEND_MINUTES * 60_000;
+        expect(thresholdMs).toBe(7_200_000);
+        expect(idleCheckIntervalMs(thresholdMs)).toBe(300_000);
+    });
+    it('suspends within a quarter of the threshold for shorter settings', () => {
+        expect(idleCheckIntervalMs(20 * 60_000)).toBe(5 * 60_000); // 20min -> capped at 5min
+        expect(idleCheckIntervalMs(8 * 60_000)).toBe(2 * 60_000); // 8min -> quarter
+        expect(idleCheckIntervalMs(60_000)).toBe(15_000); // 1min -> quarter
+    });
+    it('never spins on a sub-minute threshold', () => {
+        expect(idleCheckIntervalMs(1_800)).toBe(1_000);
+        expect(idleCheckIntervalMs(0)).toBe(1_000);
+    });
+});
+//# sourceMappingURL=idle-config.test.js.map

package/build/supervisor/idle-config.test.js.map

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

package/build/supervisor/ndjson-reader.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Newline-delimited JSON message framing - the exact wire format
+ * @modelcontextprotocol/sdk uses for stdio (see its own ReadBuffer in
+ * dist/esm/shared/stdio.js: messages are `JSON.stringify(message) + '\n'`,
+ * split on the first '\n', with a trailing '\r' tolerated on read).
+ *
+ * Buffers as raw bytes (not strings) so a multi-byte UTF-8 character split
+ * across two chunks is never corrupted.
+ */
+export declare class NdjsonReader {
+    private buffer;
+    /** Feed a raw chunk of bytes read from a stream. */
+    push(chunk: Buffer): void;
+    /**
+     * Pull the next complete line, if any, as a raw string (not yet parsed).
+     * Returns undefined if no complete line is buffered yet.
+     */
+    readLine(): string | undefined;
+    /** Drain and return every complete line currently buffered, in order. */
+    readAllLines(): string[];
+}
+/** JSON-RPC 2.0 message shape, classified structurally (no schema validation). */
+export type ParsedMessage = {
+    kind: 'request';
+    id: string | number;
+    method: string;
+    raw: unknown;
+} | {
+    kind: 'notification';
+    method: string;
+    raw: unknown;
+} | {
+    kind: 'response';
+    id: string | number;
+    raw: unknown;
+} | {
+    kind: 'unparseable';
+    raw: string;
+};
+/**
+ * Classify a raw NDJSON line. Never throws - an unparseable or
+ * unrecognizable line is still forwarded (as 'unparseable'), since the
+ * supervisor's job is to proxy, not to police the protocol.
+ */
+export declare function classifyLine(line: string): ParsedMessage;
+export declare function serializeMessage(message: unknown): string;
+//# sourceMappingURL=ndjson-reader.d.ts.map

package/build/supervisor/ndjson-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjson-reader.d.ts","sourceRoot":"","sources":["../../src/supervisor/ndjson-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAqB;IAEnC,oDAAoD;IACpD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzB;;;OAGG;IACH,QAAQ,IAAI,MAAM,GAAG,SAAS;IAa9B,yEAAyE;IACzE,YAAY,IAAI,MAAM,EAAE;CAQzB;AAED,kFAAkF;AAClF,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CA0BxD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEzD"}

package/build/supervisor/ndjson-reader.js

@@ -0,0 +1,75 @@
+/**
+ * Newline-delimited JSON message framing - the exact wire format
+ * @modelcontextprotocol/sdk uses for stdio (see its own ReadBuffer in
+ * dist/esm/shared/stdio.js: messages are `JSON.stringify(message) + '\n'`,
+ * split on the first '\n', with a trailing '\r' tolerated on read).
+ *
+ * Buffers as raw bytes (not strings) so a multi-byte UTF-8 character split
+ * across two chunks is never corrupted.
+ */
+export class NdjsonReader {
+    buffer;
+    /** Feed a raw chunk of bytes read from a stream. */
+    push(chunk) {
+        this.buffer = this.buffer ? Buffer.concat([this.buffer, chunk]) : chunk;
+    }
+    /**
+     * Pull the next complete line, if any, as a raw string (not yet parsed).
+     * Returns undefined if no complete line is buffered yet.
+     */
+    readLine() {
+        if (!this.buffer) {
+            return undefined;
+        }
+        const index = this.buffer.indexOf('\n');
+        if (index === -1) {
+            return undefined;
+        }
+        const line = this.buffer.toString('utf8', 0, index).replace(/\r$/, '');
+        this.buffer = this.buffer.subarray(index + 1);
+        return line;
+    }
+    /** Drain and return every complete line currently buffered, in order. */
+    readAllLines() {
+        const lines = [];
+        let line;
+        while ((line = this.readLine()) !== undefined) {
+            lines.push(line);
+        }
+        return lines;
+    }
+}
+/**
+ * Classify a raw NDJSON line. Never throws - an unparseable or
+ * unrecognizable line is still forwarded (as 'unparseable'), since the
+ * supervisor's job is to proxy, not to police the protocol.
+ */
+export function classifyLine(line) {
+    let value;
+    try {
+        value = JSON.parse(line);
+    }
+    catch {
+        return { kind: 'unparseable', raw: line };
+    }
+    if (typeof value !== 'object' || value === null) {
+        return { kind: 'unparseable', raw: line };
+    }
+    const obj = value;
+    const hasId = 'id' in obj && (typeof obj.id === 'string' || typeof obj.id === 'number');
+    const hasMethod = 'method' in obj && typeof obj.method === 'string';
+    if (hasId && hasMethod) {
+        return { kind: 'request', id: obj.id, method: obj.method, raw: value };
+    }
+    if (hasMethod) {
+        return { kind: 'notification', method: obj.method, raw: value };
+    }
+    if (hasId) {
+        return { kind: 'response', id: obj.id, raw: value };
+    }
+    return { kind: 'unparseable', raw: line };
+}
+export function serializeMessage(message) {
+    return JSON.stringify(message) + '\n';
+}
+//# sourceMappingURL=ndjson-reader.js.map

package/build/supervisor/ndjson-reader.js.map

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

package/build/supervisor/ndjson-reader.test.d.ts

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

package/build/supervisor/ndjson-reader.test.d.ts.map

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

package/build/supervisor/ndjson-reader.test.js

@@ -0,0 +1,92 @@
+import { describe, it, expect } from 'vitest';
+import { NdjsonReader, classifyLine, serializeMessage } from './ndjson-reader.js';
+describe('NdjsonReader', () => {
+    it('parses a single complete line', () => {
+        const reader = new NdjsonReader();
+        reader.push(Buffer.from('{"a":1}\n'));
+        expect(reader.readLine()).toBe('{"a":1}');
+        expect(reader.readLine()).toBeUndefined();
+    });
+    it('returns undefined until a full line has arrived', () => {
+        const reader = new NdjsonReader();
+        reader.push(Buffer.from('{"a":1}'));
+        expect(reader.readLine()).toBeUndefined();
+        reader.push(Buffer.from('\n'));
+        expect(reader.readLine()).toBe('{"a":1}');
+    });
+    it('handles a message split across two chunks', () => {
+        const reader = new NdjsonReader();
+        const full = '{"jsonrpc":"2.0","id":1,"method":"tools/call"}\n';
+        const splitAt = 10;
+        reader.push(Buffer.from(full.slice(0, splitAt)));
+        expect(reader.readLine()).toBeUndefined();
+        reader.push(Buffer.from(full.slice(splitAt)));
+        expect(reader.readLine()).toBe(full.trim());
+    });
+    it('handles multiple messages in one chunk', () => {
+        const reader = new NdjsonReader();
+        reader.push(Buffer.from('{"a":1}\n{"a":2}\n{"a":3}\n'));
+        expect(reader.readAllLines()).toEqual(['{"a":1}', '{"a":2}', '{"a":3}']);
+    });
+    it('handles a multi-byte UTF-8 character split exactly at a chunk boundary', () => {
+        const reader = new NdjsonReader();
+        // U+1F600 (😀) is 4 bytes in UTF-8: F0 9F 98 80
+        const line = '{"msg":"hi 😀"}\n';
+        const bytes = Buffer.from(line, 'utf8');
+        const emojiStart = bytes.indexOf(0xf0); // start of the 4-byte sequence
+        reader.push(bytes.subarray(0, emojiStart + 2)); // split mid-emoji
+        expect(reader.readLine()).toBeUndefined();
+        reader.push(bytes.subarray(emojiStart + 2));
+        expect(reader.readLine()).toBe('{"msg":"hi 😀"}');
+    });
+    it('strips a trailing \\r (CRLF line endings)', () => {
+        const reader = new NdjsonReader();
+        reader.push(Buffer.from('{"a":1}\r\n'));
+        expect(reader.readLine()).toBe('{"a":1}');
+    });
+    it('a malformed line does not corrupt subsequent valid lines', () => {
+        const reader = new NdjsonReader();
+        reader.push(Buffer.from('not json at all\n{"jsonrpc":"2.0","id":1,"result":{}}\n'));
+        const lines = reader.readAllLines();
+        expect(lines).toEqual(['not json at all', '{"jsonrpc":"2.0","id":1,"result":{}}']);
+        expect(classifyLine(lines[0]).kind).toBe('unparseable');
+        expect(classifyLine(lines[1]).kind).toBe('response');
+    });
+});
+describe('classifyLine', () => {
+    it('classifies a request (has id and method)', () => {
+        const parsed = classifyLine('{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}');
+        expect(parsed).toMatchObject({ kind: 'request', id: 1, method: 'initialize' });
+    });
+    it('classifies a notification (has method, no id)', () => {
+        const parsed = classifyLine('{"jsonrpc":"2.0","method":"notifications/initialized"}');
+        expect(parsed).toMatchObject({ kind: 'notification', method: 'notifications/initialized' });
+    });
+    it('classifies a response (has id, no method)', () => {
+        const parsed = classifyLine('{"jsonrpc":"2.0","id":1,"result":{}}');
+        expect(parsed).toMatchObject({ kind: 'response', id: 1 });
+    });
+    it('classifies an error response (has id, no method) the same as a response', () => {
+        const parsed = classifyLine('{"jsonrpc":"2.0","id":1,"error":{"code":-32000,"message":"boom"}}');
+        expect(parsed).toMatchObject({ kind: 'response', id: 1 });
+    });
+    it('classifies invalid JSON as unparseable without throwing', () => {
+        expect(() => classifyLine('{not valid')).not.toThrow();
+        expect(classifyLine('{not valid').kind).toBe('unparseable');
+    });
+    it('classifies a JSON value with neither id nor method as unparseable', () => {
+        expect(classifyLine('{"jsonrpc":"2.0"}').kind).toBe('unparseable');
+        expect(classifyLine('null').kind).toBe('unparseable');
+        expect(classifyLine('42').kind).toBe('unparseable');
+    });
+    it('preserves a string id', () => {
+        const parsed = classifyLine('{"jsonrpc":"2.0","id":"abc-123","result":{}}');
+        expect(parsed).toMatchObject({ kind: 'response', id: 'abc-123' });
+    });
+});
+describe('serializeMessage', () => {
+    it('serializes with a trailing newline', () => {
+        expect(serializeMessage({ a: 1 })).toBe('{"a":1}\n');
+    });
+});
+//# sourceMappingURL=ndjson-reader.test.js.map

package/build/supervisor/ndjson-reader.test.js.map

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

package/build/supervisor/pidfile.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Remove the supervisor pidfile ONLY if it still names this process.
+ *
+ * The pidfile is last-writer-wins: a second supervisor starting in the same
+ * project overwrites it. Deleting it unconditionally on shutdown therefore let
+ * an OLD supervisor, exiting hours later, delete the LIVE one's pidfile - after
+ * which `npm run build` signalled nothing, silently, and the running session
+ * stopped receiving rebuilds while appearing healthy.
+ */
+export declare function removeOwnPidFile(pidFilePath: string, ownPid: number): Promise<boolean>;
+//# sourceMappingURL=pidfile.d.ts.map

package/build/supervisor/pidfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pidfile.d.ts","sourceRoot":"","sources":["../../src/supervisor/pidfile.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAe5F"}

package/build/supervisor/pidfile.js

@@ -0,0 +1,29 @@
+import { promises as fs } from 'fs';
+/**
+ * Remove the supervisor pidfile ONLY if it still names this process.
+ *
+ * The pidfile is last-writer-wins: a second supervisor starting in the same
+ * project overwrites it. Deleting it unconditionally on shutdown therefore let
+ * an OLD supervisor, exiting hours later, delete the LIVE one's pidfile - after
+ * which `npm run build` signalled nothing, silently, and the running session
+ * stopped receiving rebuilds while appearing healthy.
+ */
+export async function removeOwnPidFile(pidFilePath, ownPid) {
+    try {
+        const contents = await fs.readFile(pidFilePath, 'utf-8');
+        if (parseInt(contents.trim(), 10) !== ownPid)
+            return false;
+    }
+    catch {
+        // Already gone, or unreadable - nothing of ours to remove.
+        return false;
+    }
+    try {
+        await fs.unlink(pidFilePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=pidfile.js.map

package/build/supervisor/pidfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pidfile.js","sourceRoot":"","sources":["../../src/supervisor/pidfile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB,EAAE,MAAc;IACxE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACzD,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/build/supervisor/pidfile.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Observed for real: two supervisors were running in this project, and when the
+ * three-day-old one exited it deleted the pidfile belonging to the one actually
+ * serving the session. From then on `npm run build` signalled nothing - the
+ * build succeeded, the running server kept the old code, and nothing said so.
+ */
+export {};
+//# sourceMappingURL=pidfile.test.d.ts.map

package/build/supervisor/pidfile.test.d.ts.map

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

package/build/supervisor/pidfile.test.js

@@ -0,0 +1,46 @@
+/**
+ * Observed for real: two supervisors were running in this project, and when the
+ * three-day-old one exited it deleted the pidfile belonging to the one actually
+ * serving the session. From then on `npm run build` signalled nothing - the
+ * build succeeded, the running server kept the old code, and nothing said so.
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { promises as fs } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { removeOwnPidFile } from './pidfile.js';
+let dir;
+let pidFile;
+beforeEach(async () => {
+    dir = await fs.mkdtemp(join(tmpdir(), 'cdp-tools-pidfile-'));
+    pidFile = join(dir, 'mcp-supervisor.pid');
+});
+afterEach(async () => {
+    await fs.rm(dir, { recursive: true, force: true });
+});
+const exists = async () => fs.access(pidFile).then(() => true, () => false);
+describe('removeOwnPidFile', () => {
+    it('removes the pidfile when it still names this process', async () => {
+        await fs.writeFile(pidFile, '4242');
+        expect(await removeOwnPidFile(pidFile, 4242)).toBe(true);
+        expect(await exists()).toBe(false);
+    });
+    it('leaves a pidfile that a newer supervisor has taken over', async () => {
+        await fs.writeFile(pidFile, '9999'); // the live supervisor
+        expect(await removeOwnPidFile(pidFile, 4242)).toBe(false); // an older one exiting
+        expect(await fs.readFile(pidFile, 'utf-8')).toBe('9999');
+    });
+    it('tolerates trailing whitespace, as an atomic write can leave', async () => {
+        await fs.writeFile(pidFile, '4242\n');
+        expect(await removeOwnPidFile(pidFile, 4242)).toBe(true);
+    });
+    it('is a no-op when the pidfile is already gone', async () => {
+        expect(await removeOwnPidFile(pidFile, 4242)).toBe(false);
+    });
+    it('leaves an unparseable pidfile alone rather than guessing', async () => {
+        await fs.writeFile(pidFile, 'not-a-pid');
+        expect(await removeOwnPidFile(pidFile, 4242)).toBe(false);
+        expect(await exists()).toBe(true);
+    });
+});
+//# sourceMappingURL=pidfile.test.js.map