@opengsd/gsd-pi 1.2.0 → 1.3.0-dev.eed73bea

package/packages/mcp-server/dist/cli-errors.d.ts

@@ -4,8 +4,19 @@ interface GlobalErrorRuntime {
     stderr: {
         write(message: string): unknown;
     };
+    exit(code: number): never;
 }
 export declare function formatUnknownError(error: unknown): string;
+/**
+ * Install process-global error handlers that log and then terminate.
+ *
+ * A repeating throw against a dead stdio transport (e.g. an orphaned server
+ * whose parent pipe has closed) would otherwise log-and-loop, pegging the CPU
+ * indefinitely because the handler returns without exiting. Terminating after
+ * logging guarantees the process crashes out of the loop; the client (Claude
+ * Code) owns restart/backoff, and the PID registry sweep cleans up the stale
+ * entry on the next spawn. See #783.
+ */
 export declare function installGlobalErrorHandlers(runtime?: GlobalErrorRuntime): void;
 export {};
 //# sourceMappingURL=cli-errors.d.ts.map

package/packages/mcp-server/dist/cli-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-errors.d.ts","sourceRoot":"","sources":["../src/cli-errors.ts"],"names":[],"mappings":"AAAA,KAAK,gBAAgB,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;AAEnE,UAAU,kBAAkB;IAC1B,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;IACzE,MAAM,EAAE;QACN,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;KACjC,CAAC;CACH;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKzD;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,kBAAkD,GAAG,IAAI,CAQ5G"}
+{"version":3,"file":"cli-errors.d.ts","sourceRoot":"","sources":["../src/cli-errors.ts"],"names":[],"mappings":"AAAA,KAAK,gBAAgB,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;AAEnE,UAAU,kBAAkB;IAC1B,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;IACzE,MAAM,EAAE;QACN,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;KACjC,CAAC;IACF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;CAC3B;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,kBAA6D,GAAG,IAAI,CAUvH"}

package/packages/mcp-server/dist/cli-errors.js

@@ -4,12 +4,24 @@ export function formatUnknownError(error) {
     }
     return String(error);
 }
+/**
+ * Install process-global error handlers that log and then terminate.
+ *
+ * A repeating throw against a dead stdio transport (e.g. an orphaned server
+ * whose parent pipe has closed) would otherwise log-and-loop, pegging the CPU
+ * indefinitely because the handler returns without exiting. Terminating after
+ * logging guarantees the process crashes out of the loop; the client (Claude
+ * Code) owns restart/backoff, and the PID registry sweep cleans up the stale
+ * entry on the next spawn. See #783.
+ */
 export function installGlobalErrorHandlers(runtime = process) {
     runtime.on('uncaughtException', (error) => {
         runtime.stderr.write(`[gsd-mcp-server] Uncaught exception: ${formatUnknownError(error)}\n`);
+        runtime.exit(1);
     });
     runtime.on('unhandledRejection', (reason) => {
         runtime.stderr.write(`[gsd-mcp-server] Unhandled rejection: ${formatUnknownError(reason)}\n`);
+        runtime.exit(1);
     });
 }
 //# sourceMappingURL=cli-errors.js.map

package/packages/mcp-server/dist/cli-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-errors.js","sourceRoot":"","sources":["../src/cli-errors.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,UAA8B,OAA6B;IACpG,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["type GlobalErrorEvent = 'uncaughtException' | 'unhandledRejection';\n\ninterface GlobalErrorRuntime {\n  on(event: GlobalErrorEvent, listener: (error: unknown) => void): unknown;\n  stderr: {\n    write(message: string): unknown;\n  };\n}\n\nexport function formatUnknownError(error: unknown): string {\n  if (error instanceof Error) {\n    return error.stack ?? `${error.name}: ${error.message}`;\n  }\n  return String(error);\n}\n\nexport function installGlobalErrorHandlers(runtime: GlobalErrorRuntime = process as GlobalErrorRuntime): void {\n  runtime.on('uncaughtException', (error) => {\n    runtime.stderr.write(`[gsd-mcp-server] Uncaught exception: ${formatUnknownError(error)}\\n`);\n  });\n\n  runtime.on('unhandledRejection', (reason) => {\n    runtime.stderr.write(`[gsd-mcp-server] Unhandled rejection: ${formatUnknownError(reason)}\\n`);\n  });\n}\n"]}
+{"version":3,"file":"cli-errors.js","sourceRoot":"","sources":["../src/cli-errors.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,UAA8B,OAAwC;IAC/G,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["type GlobalErrorEvent = 'uncaughtException' | 'unhandledRejection';\n\ninterface GlobalErrorRuntime {\n  on(event: GlobalErrorEvent, listener: (error: unknown) => void): unknown;\n  stderr: {\n    write(message: string): unknown;\n  };\n  exit(code: number): never;\n}\n\nexport function formatUnknownError(error: unknown): string {\n  if (error instanceof Error) {\n    return error.stack ?? `${error.name}: ${error.message}`;\n  }\n  return String(error);\n}\n\n/**\n * Install process-global error handlers that log and then terminate.\n *\n * A repeating throw against a dead stdio transport (e.g. an orphaned server\n * whose parent pipe has closed) would otherwise log-and-loop, pegging the CPU\n * indefinitely because the handler returns without exiting. Terminating after\n * logging guarantees the process crashes out of the loop; the client (Claude\n * Code) owns restart/backoff, and the PID registry sweep cleans up the stale\n * entry on the next spawn. See #783.\n */\nexport function installGlobalErrorHandlers(runtime: GlobalErrorRuntime = process as unknown as GlobalErrorRuntime): void {\n  runtime.on('uncaughtException', (error) => {\n    runtime.stderr.write(`[gsd-mcp-server] Uncaught exception: ${formatUnknownError(error)}\\n`);\n    runtime.exit(1);\n  });\n\n  runtime.on('unhandledRejection', (reason) => {\n    runtime.stderr.write(`[gsd-mcp-server] Unhandled rejection: ${formatUnknownError(reason)}\\n`);\n    runtime.exit(1);\n  });\n}\n"]}

package/packages/mcp-server/dist/cli-runner.d.ts

@@ -0,0 +1,40 @@
+import type { Readable, Writable } from 'node:stream';
+interface SessionManagerLike {
+    cleanup(): Promise<void>;
+}
+interface McpServerLike {
+    connect(transport: unknown): Promise<void>;
+    close(): Promise<void>;
+}
+interface StdioTransportConstructor {
+    new (input?: Readable, output?: Writable): unknown;
+}
+export interface RunMcpServerCliOptions {
+    cwd?: () => string;
+    env?: NodeJS.ProcessEnv;
+    exit?: (code: number) => never;
+    loadStoredCredentialEnvKeys?: () => void;
+    registerMcpInstance?: (projectDir: string) => boolean | void;
+    sweepProjectOrphanMcpServers?: (projectDir: string) => void;
+    unregisterMcpInstance?: (projectDir: string) => void;
+    createSessionManager?: () => SessionManagerLike;
+    createMcpServer?: (sessionManager: SessionManagerLike) => Promise<{
+        server: McpServerLike;
+    }>;
+    importStdioServerTransport?: () => Promise<{
+        StdioServerTransport: StdioTransportConstructor;
+    }>;
+    warmWorkflowToolBridges?: () => Promise<unknown> | unknown;
+    stdin?: Readable;
+    stdout?: Writable;
+    stderr?: Writable;
+    onSignal?: (signal: NodeJS.Signals, listener: () => void) => void;
+    now?: () => number;
+    setInterval?: typeof setInterval;
+    clearInterval?: typeof clearInterval;
+    isOrphaned?: () => boolean;
+    cleanupStepTimeoutMs?: number;
+}
+export declare function runMcpServerCli(options?: RunMcpServerCliOptions): Promise<void>;
+export {};
+//# sourceMappingURL=cli-runner.d.ts.map

package/packages/mcp-server/dist/cli-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runner.d.ts","sourceRoot":"","sources":["../src/cli-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAiCtD,UAAU,kBAAkB;IAC1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,UAAU,aAAa;IACrB,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,UAAU,yBAAyB;IACjC,KAAI,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACnD;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;IAC/B,2BAA2B,CAAC,EAAE,MAAM,IAAI,CAAC;IACzC,mBAAmB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC;IAC7D,4BAA4B,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,qBAAqB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,oBAAoB,CAAC,EAAE,MAAM,kBAAkB,CAAC;IAChD,eAAe,CAAC,EAAE,CAAC,cAAc,EAAE,kBAAkB,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IAC7F,0BAA0B,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,oBAAoB,EAAE,yBAAyB,CAAA;KAAE,CAAC,CAAC;IAChG,uBAAuB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC3D,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAClE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAkBD,wBAAsB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CA4IzF"}

package/packages/mcp-server/dist/cli-runner.js

@@ -0,0 +1,170 @@
+import { SessionManager } from './session-manager.js';
+import { createMcpServer } from './server.js';
+import { loadStoredCredentialEnvKeys } from './tool-credentials.js';
+import { warmWorkflowToolBridges } from './workflow-tools.js';
+import { isMcpProbeSession } from './probe-mode.js';
+import { registerMcpInstance, sweepProjectOrphanMcpServers, unregisterMcpInstance, } from './pid-registry.js';
+import { createActivityTrackingInput } from './stdio-watchdog.js';
+const MCP_PKG = '@modelcontextprotocol/sdk';
+const STDIN_IDLE_TIMEOUT_MS = 5 * 60 * 1000;
+const STDIN_IDLE_CHECK_INTERVAL_MS = 60 * 1000;
+const CLEANUP_STEP_TIMEOUT_MS = 2 * 1000;
+/**
+ * Cadence for the ref-held parent-liveness monitor.
+ *
+ * Separate from the `.unref()`'d idle watchdog: a process already pegged at
+ * ~100% CPU starves its event loop, so the watchdog timer may never fire and a
+ * spinning orphan lingers until the next spawn sweeps it. This monitor is
+ * ref-held (NOT `.unref()`'d) so the libuv loop keeps scheduling it under load,
+ * and it exits the process itself the moment the parent is gone — independent
+ * of the external PID-registry sweep that only runs on the next launch. See
+ * #783.
+ */
+const ORPHAN_PARENT_LOSS_CHECK_INTERVAL_MS = 10 * 1000;
+function createDefaultIsOrphaned(initialParentPid) {
+    return () => {
+        if (process.ppid !== initialParentPid)
+            return true;
+        try {
+            process.kill(initialParentPid, 0);
+            return false;
+        }
+        catch (err) {
+            return err.code === 'ESRCH';
+        }
+    };
+}
+async function importDefaultStdioServerTransport() {
+    return import(`${MCP_PKG}/server/stdio.js`);
+}
+export async function runMcpServerCli(options = {}) {
+    const cwd = options.cwd ?? (() => process.cwd());
+    const env = options.env ?? process.env;
+    const exit = options.exit ?? ((code) => process.exit(code));
+    const stdin = options.stdin ?? process.stdin;
+    const stdout = options.stdout ?? process.stdout;
+    const stderr = options.stderr ?? process.stderr;
+    const onSignal = options.onSignal ?? ((signal, listener) => process.on(signal, listener));
+    const now = options.now ?? (() => Date.now());
+    const startInterval = options.setInterval ?? setInterval;
+    const stopInterval = options.clearInterval ?? clearInterval;
+    const isOrphaned = options.isOrphaned ?? createDefaultIsOrphaned(process.ppid);
+    const cleanupStepTimeoutMs = options.cleanupStepTimeoutMs ?? CLEANUP_STEP_TIMEOUT_MS;
+    const loadEnv = options.loadStoredCredentialEnvKeys ?? loadStoredCredentialEnvKeys;
+    const registerInstance = options.registerMcpInstance ?? registerMcpInstance;
+    const sweepOrphans = options.sweepProjectOrphanMcpServers ?? sweepProjectOrphanMcpServers;
+    const unregisterInstance = options.unregisterMcpInstance ?? unregisterMcpInstance;
+    const createSessionManager = options.createSessionManager ?? (() => new SessionManager());
+    const createServer = options.createMcpServer ?? (async (manager) => createMcpServer(manager));
+    const importTransport = options.importStdioServerTransport ?? importDefaultStdioServerTransport;
+    const warmBridges = options.warmWorkflowToolBridges ?? warmWorkflowToolBridges;
+    loadEnv();
+    const projectDir = env.GSD_WORKFLOW_PROJECT_ROOT || cwd();
+    const probeSession = isMcpProbeSession(env);
+    let registered = false;
+    let cleaningUp = false;
+    let idleWatchdog;
+    let orphanMonitor;
+    let trackedStdin;
+    let sessionManager;
+    let server;
+    async function runCleanupStep(label, step) {
+        let timeout;
+        try {
+            await Promise.race([
+                Promise.resolve().then(step),
+                new Promise((resolve) => {
+                    timeout = setTimeout(() => {
+                        stderr.write(`[gsd-mcp-server] Cleanup step timed out: ${label}\n`);
+                        resolve();
+                    }, cleanupStepTimeoutMs);
+                    timeout.unref();
+                }),
+            ]);
+        }
+        catch {
+        }
+        finally {
+            if (timeout)
+                clearTimeout(timeout);
+        }
+    }
+    async function stopRuntime() {
+        if (idleWatchdog)
+            stopInterval(idleWatchdog);
+        if (orphanMonitor)
+            stopInterval(orphanMonitor);
+        trackedStdin?.close();
+        if (registered)
+            unregisterInstance(projectDir);
+        await runCleanupStep('session manager cleanup', () => sessionManager?.cleanup());
+        await runCleanupStep('server close', () => server?.close());
+    }
+    async function cleanup(code = 0) {
+        if (cleaningUp)
+            return;
+        cleaningUp = true;
+        stderr.write('[gsd-mcp-server] Shutting down...\n');
+        await stopRuntime();
+        exit(code);
+    }
+    onSignal('SIGTERM', () => void cleanup());
+    onSignal('SIGINT', () => void cleanup());
+    stdin.once('end', () => void cleanup());
+    stdin.once('close', () => void cleanup());
+    stdin.once('error', () => void cleanup(1));
+    try {
+        if (!probeSession) {
+            sweepOrphans(projectDir);
+            if (registerInstance(projectDir) === false) {
+                throw new Error('refusing to start: existing MCP server PID could not be verified');
+            }
+            registered = true;
+        }
+        sessionManager = createSessionManager();
+        ({ server } = await createServer(sessionManager));
+        const { StdioServerTransport } = await importTransport();
+        trackedStdin = createActivityTrackingInput(stdin, now);
+        const transport = new StdioServerTransport(trackedStdin.input, stdout);
+        idleWatchdog = startInterval(() => {
+            if (trackedStdin && now() - trackedStdin.lastActivityAt() > STDIN_IDLE_TIMEOUT_MS && isOrphaned()) {
+                stderr.write(`[gsd-mcp-server] Idle stdin watchdog: no activity for ${STDIN_IDLE_TIMEOUT_MS / 1000}s and parent process is gone, shutting down\n`);
+                void cleanup();
+            }
+        }, STDIN_IDLE_CHECK_INTERVAL_MS);
+        idleWatchdog.unref();
+        // Ref-held parent-liveness monitor (#783). The idle watchdog above is
+        // `.unref()`'d, so a process pegged at ~100% CPU (e.g. a repeating throw
+        // against a dead stdio pipe) starves its event loop and the watchdog never
+        // fires — the orphan spins until the next launch sweeps it. This monitor is
+        // NOT unref'd: the loop keeps scheduling it under load, so parent loss is
+        // detected in seconds regardless of CPU state. It still requires the same
+        // idle gate as the watchdog so an active session whose parent briefly
+        // appears gone is not killed (#783 "stays alive when parent is gone but
+        // stdin is still active").
+        orphanMonitor = startInterval(() => {
+            if (!isOrphaned())
+                return;
+            const idleMs = trackedStdin ? now() - trackedStdin.lastActivityAt() : 0;
+            if (idleMs <= STDIN_IDLE_TIMEOUT_MS)
+                return;
+            stderr.write(`[gsd-mcp-server] Parent process is gone; shutting down to avoid orphan spin\n`);
+            void cleanup();
+        }, ORPHAN_PARENT_LOSS_CHECK_INTERVAL_MS);
+        // Fail closed (ADR-036): warm the executor / write-gate bridges BEFORE
+        // connecting the transport. If a bridge is broken we must not advertise the
+        // workflow tool surface — a rejection here propagates to the catch below so
+        // startup aborts and the client never sees tools that would error on first
+        // call. A healthy warm-up pre-pays the bridge import so the first real tool
+        // call stays fast.
+        await warmBridges();
+        stderr.write('[gsd-mcp-server] workflow bridges ready\n');
+        await server.connect(transport);
+        stderr.write('[gsd-mcp-server] MCP server started on stdio\n');
+    }
+    catch (err) {
+        stderr.write(`[gsd-mcp-server] Fatal: failed to start — ${err instanceof Error ? err.message : String(err)}\n`);
+        await cleanup(1);
+    }
+}
+//# sourceMappingURL=cli-runner.js.map

package/packages/mcp-server/dist/cli-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runner.js","sourceRoot":"","sources":["../src/cli-runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,2BAA2B,EAA8B,MAAM,qBAAqB,CAAC;AAE9F,MAAM,OAAO,GAAG,2BAA2B,CAAC;AAE5C,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAC5C,MAAM,4BAA4B,GAAG,EAAE,GAAG,IAAI,CAAC;AAC/C,MAAM,uBAAuB,GAAG,CAAC,GAAG,IAAI,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,MAAM,oCAAoC,GAAG,EAAE,GAAG,IAAI,CAAC;AAsCvD,SAAS,uBAAuB,CAAC,gBAAwB;IACvD,OAAO,GAAG,EAAE;QACV,IAAI,OAAO,CAAC,IAAI,KAAK,gBAAgB;YAAE,OAAO,IAAI,CAAC;QACnD,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;YAClC,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAQ,GAA6B,CAAC,IAAI,KAAK,OAAO,CAAC;QACzD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iCAAiC;IAC9C,OAAO,MAAM,CAAC,GAAG,OAAO,kBAAkB,CAAiE,CAAC;AAC9G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkC,EAAE;IACxE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,IAAY,EAAS,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC1F,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,IAAI,WAAW,CAAC;IACzD,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,IAAI,aAAa,CAAC;IAC5D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,uBAAuB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,uBAAuB,CAAC;IACrF,MAAM,OAAO,GAAG,OAAO,CAAC,2BAA2B,IAAI,2BAA2B,CAAC;IACnF,MAAM,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,IAAI,mBAAmB,CAAC;IAC5E,MAAM,YAAY,GAAG,OAAO,CAAC,4BAA4B,IAAI,4BAA4B,CAAC;IAC1F,MAAM,kBAAkB,GAAG,OAAO,CAAC,qBAAqB,IAAI,qBAAqB,CAAC;IAClF,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC;IAC1F,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,IAAI,CAC9C,KAAK,EAAE,OAA2B,EAAE,EAAE,CAAC,eAAe,CAAC,OAAyB,CAAC,CAClF,CAAC;IACF,MAAM,eAAe,GAAG,OAAO,CAAC,0BAA0B,IAAI,iCAAiC,CAAC;IAChG,MAAM,WAAW,GAAG,OAAO,CAAC,uBAAuB,IAAI,uBAAuB,CAAC;IAE/E,OAAO,EAAE,CAAC;IAEV,MAAM,UAAU,GAAG,GAAG,CAAC,yBAAyB,IAAI,GAAG,EAAE,CAAC;IAC1D,MAAM,YAAY,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,YAAwD,CAAC;IAC7D,IAAI,aAAyD,CAAC;IAC9D,IAAI,YAA+C,CAAC;IACpD,IAAI,cAA8C,CAAC;IACnD,IAAI,MAAiC,CAAC;IAEtC,KAAK,UAAU,cAAc,CAAC,KAAa,EAAE,IAAgC;QAC3E,IAAI,OAAkD,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC;gBACjB,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC5B,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;oBAC5B,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;wBACxB,MAAM,CAAC,KAAK,CAAC,4CAA4C,KAAK,IAAI,CAAC,CAAC;wBACpE,OAAO,EAAE,CAAC;oBACZ,CAAC,EAAE,oBAAoB,CAAC,CAAC;oBACzB,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,CAAC,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;QACT,CAAC;gBAAS,CAAC;YACT,IAAI,OAAO;gBAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,KAAK,UAAU,WAAW;QACxB,IAAI,YAAY;YAAE,YAAY,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,aAAa;YAAE,YAAY,CAAC,aAAa,CAAC,CAAC;QAC/C,YAAY,EAAE,KAAK,EAAE,CAAC;QACtB,IAAI,UAAU;YAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,cAAc,CAAC,yBAAyB,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;QACjF,MAAM,cAAc,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,UAAU,OAAO,CAAC,IAAI,GAAG,CAAC;QAC7B,IAAI,UAAU;YAAE,OAAO;QACvB,UAAU,GAAG,IAAI,CAAC;QAClB,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACpD,MAAM,WAAW,EAAE,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,CAAC;IAED,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAC1C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,YAAY,CAAC,UAAU,CAAC,CAAC;YACzB,IAAI,gBAAgB,CAAC,UAAU,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;YACtF,CAAC;YACD,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,cAAc,GAAG,oBAAoB,EAAE,CAAC;QACxC,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC;QAElD,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,eAAe,EAAE,CAAC;QACzD,YAAY,GAAG,2BAA2B,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAEvE,YAAY,GAAG,aAAa,CAAC,GAAG,EAAE;YAChC,IAAI,YAAY,IAAI,GAAG,EAAE,GAAG,YAAY,CAAC,cAAc,EAAE,GAAG,qBAAqB,IAAI,UAAU,EAAE,EAAE,CAAC;gBAClG,MAAM,CAAC,KAAK,CACV,yDAAyD,qBAAqB,GAAG,IAAI,+CAA+C,CACrI,CAAC;gBACF,KAAK,OAAO,EAAE,CAAC;YACjB,CAAC;QACH,CAAC,EAAE,4BAA4B,CAAC,CAAC;QACjC,YAAY,CAAC,KAAK,EAAE,CAAC;QAErB,sEAAsE;QACtE,yEAAyE;QACzE,2EAA2E;QAC3E,4EAA4E;QAC5E,0EAA0E;QAC1E,0EAA0E;QAC1E,sEAAsE;QACtE,wEAAwE;QACxE,2BAA2B;QAC3B,aAAa,GAAG,aAAa,CAAC,GAAG,EAAE;YACjC,IAAI,CAAC,UAAU,EAAE;gBAAE,OAAO;YAC1B,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACxE,IAAI,MAAM,IAAI,qBAAqB;gBAAE,OAAO;YAC5C,MAAM,CAAC,KAAK,CACV,+EAA+E,CAChF,CAAC;YACF,KAAK,OAAO,EAAE,CAAC;QACjB,CAAC,EAAE,oCAAoC,CAAC,CAAC;QAEzC,uEAAuE;QACvE,4EAA4E;QAC5E,4EAA4E;QAC5E,2EAA2E;QAC3E,4EAA4E;QAC5E,mBAAmB;QACnB,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAE1D,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CACV,6CAA6C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAClG,CAAC;QACF,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;AACH,CAAC","sourcesContent":["import type { Readable, Writable } from 'node:stream';\n\nimport { SessionManager } from './session-manager.js';\nimport { createMcpServer } from './server.js';\nimport { loadStoredCredentialEnvKeys } from './tool-credentials.js';\nimport { warmWorkflowToolBridges } from './workflow-tools.js';\nimport { isMcpProbeSession } from './probe-mode.js';\nimport {\n  registerMcpInstance,\n  sweepProjectOrphanMcpServers,\n  unregisterMcpInstance,\n} from './pid-registry.js';\nimport { createActivityTrackingInput, type ActivityTrackingInput } from './stdio-watchdog.js';\n\nconst MCP_PKG = '@modelcontextprotocol/sdk';\n\nconst STDIN_IDLE_TIMEOUT_MS = 5 * 60 * 1000;\nconst STDIN_IDLE_CHECK_INTERVAL_MS = 60 * 1000;\nconst CLEANUP_STEP_TIMEOUT_MS = 2 * 1000;\n\n/**\n * Cadence for the ref-held parent-liveness monitor.\n *\n * Separate from the `.unref()`'d idle watchdog: a process already pegged at\n * ~100% CPU starves its event loop, so the watchdog timer may never fire and a\n * spinning orphan lingers until the next spawn sweeps it. This monitor is\n * ref-held (NOT `.unref()`'d) so the libuv loop keeps scheduling it under load,\n * and it exits the process itself the moment the parent is gone — independent\n * of the external PID-registry sweep that only runs on the next launch. See\n * #783.\n */\nconst ORPHAN_PARENT_LOSS_CHECK_INTERVAL_MS = 10 * 1000;\n\ninterface SessionManagerLike {\n  cleanup(): Promise<void>;\n}\n\ninterface McpServerLike {\n  connect(transport: unknown): Promise<void>;\n  close(): Promise<void>;\n}\n\ninterface StdioTransportConstructor {\n  new(input?: Readable, output?: Writable): unknown;\n}\n\nexport interface RunMcpServerCliOptions {\n  cwd?: () => string;\n  env?: NodeJS.ProcessEnv;\n  exit?: (code: number) => never;\n  loadStoredCredentialEnvKeys?: () => void;\n  registerMcpInstance?: (projectDir: string) => boolean | void;\n  sweepProjectOrphanMcpServers?: (projectDir: string) => void;\n  unregisterMcpInstance?: (projectDir: string) => void;\n  createSessionManager?: () => SessionManagerLike;\n  createMcpServer?: (sessionManager: SessionManagerLike) => Promise<{ server: McpServerLike }>;\n  importStdioServerTransport?: () => Promise<{ StdioServerTransport: StdioTransportConstructor }>;\n  warmWorkflowToolBridges?: () => Promise<unknown> | unknown;\n  stdin?: Readable;\n  stdout?: Writable;\n  stderr?: Writable;\n  onSignal?: (signal: NodeJS.Signals, listener: () => void) => void;\n  now?: () => number;\n  setInterval?: typeof setInterval;\n  clearInterval?: typeof clearInterval;\n  isOrphaned?: () => boolean;\n  cleanupStepTimeoutMs?: number;\n}\n\nfunction createDefaultIsOrphaned(initialParentPid: number): () => boolean {\n  return () => {\n    if (process.ppid !== initialParentPid) return true;\n    try {\n      process.kill(initialParentPid, 0);\n      return false;\n    } catch (err) {\n      return (err as NodeJS.ErrnoException).code === 'ESRCH';\n    }\n  };\n}\n\nasync function importDefaultStdioServerTransport(): Promise<{ StdioServerTransport: StdioTransportConstructor }> {\n  return import(`${MCP_PKG}/server/stdio.js`) as Promise<{ StdioServerTransport: StdioTransportConstructor }>;\n}\n\nexport async function runMcpServerCli(options: RunMcpServerCliOptions = {}): Promise<void> {\n  const cwd = options.cwd ?? (() => process.cwd());\n  const env = options.env ?? process.env;\n  const exit = options.exit ?? ((code: number): never => process.exit(code));\n  const stdin = options.stdin ?? process.stdin;\n  const stdout = options.stdout ?? process.stdout;\n  const stderr = options.stderr ?? process.stderr;\n  const onSignal = options.onSignal ?? ((signal, listener) => process.on(signal, listener));\n  const now = options.now ?? (() => Date.now());\n  const startInterval = options.setInterval ?? setInterval;\n  const stopInterval = options.clearInterval ?? clearInterval;\n  const isOrphaned = options.isOrphaned ?? createDefaultIsOrphaned(process.ppid);\n  const cleanupStepTimeoutMs = options.cleanupStepTimeoutMs ?? CLEANUP_STEP_TIMEOUT_MS;\n  const loadEnv = options.loadStoredCredentialEnvKeys ?? loadStoredCredentialEnvKeys;\n  const registerInstance = options.registerMcpInstance ?? registerMcpInstance;\n  const sweepOrphans = options.sweepProjectOrphanMcpServers ?? sweepProjectOrphanMcpServers;\n  const unregisterInstance = options.unregisterMcpInstance ?? unregisterMcpInstance;\n  const createSessionManager = options.createSessionManager ?? (() => new SessionManager());\n  const createServer = options.createMcpServer ?? (\n    async (manager: SessionManagerLike) => createMcpServer(manager as SessionManager)\n  );\n  const importTransport = options.importStdioServerTransport ?? importDefaultStdioServerTransport;\n  const warmBridges = options.warmWorkflowToolBridges ?? warmWorkflowToolBridges;\n\n  loadEnv();\n\n  const projectDir = env.GSD_WORKFLOW_PROJECT_ROOT || cwd();\n  const probeSession = isMcpProbeSession(env);\n  let registered = false;\n  let cleaningUp = false;\n  let idleWatchdog: ReturnType<typeof setInterval> | undefined;\n  let orphanMonitor: ReturnType<typeof setInterval> | undefined;\n  let trackedStdin: ActivityTrackingInput | undefined;\n  let sessionManager: SessionManagerLike | undefined;\n  let server: McpServerLike | undefined;\n\n  async function runCleanupStep(label: string, step: () => Promise<void> | void): Promise<void> {\n    let timeout: ReturnType<typeof setTimeout> | undefined;\n    try {\n      await Promise.race([\n        Promise.resolve().then(step),\n        new Promise<void>((resolve) => {\n          timeout = setTimeout(() => {\n            stderr.write(`[gsd-mcp-server] Cleanup step timed out: ${label}\\n`);\n            resolve();\n          }, cleanupStepTimeoutMs);\n          timeout.unref();\n        }),\n      ]);\n    } catch {\n    } finally {\n      if (timeout) clearTimeout(timeout);\n    }\n  }\n\n  async function stopRuntime(): Promise<void> {\n    if (idleWatchdog) stopInterval(idleWatchdog);\n    if (orphanMonitor) stopInterval(orphanMonitor);\n    trackedStdin?.close();\n    if (registered) unregisterInstance(projectDir);\n    await runCleanupStep('session manager cleanup', () => sessionManager?.cleanup());\n    await runCleanupStep('server close', () => server?.close());\n  }\n\n  async function cleanup(code = 0): Promise<void> {\n    if (cleaningUp) return;\n    cleaningUp = true;\n    stderr.write('[gsd-mcp-server] Shutting down...\\n');\n    await stopRuntime();\n    exit(code);\n  }\n\n  onSignal('SIGTERM', () => void cleanup());\n  onSignal('SIGINT', () => void cleanup());\n  stdin.once('end', () => void cleanup());\n  stdin.once('close', () => void cleanup());\n  stdin.once('error', () => void cleanup(1));\n\n  try {\n    if (!probeSession) {\n      sweepOrphans(projectDir);\n      if (registerInstance(projectDir) === false) {\n        throw new Error('refusing to start: existing MCP server PID could not be verified');\n      }\n      registered = true;\n    }\n\n    sessionManager = createSessionManager();\n    ({ server } = await createServer(sessionManager));\n\n    const { StdioServerTransport } = await importTransport();\n    trackedStdin = createActivityTrackingInput(stdin, now);\n    const transport = new StdioServerTransport(trackedStdin.input, stdout);\n\n    idleWatchdog = startInterval(() => {\n      if (trackedStdin && now() - trackedStdin.lastActivityAt() > STDIN_IDLE_TIMEOUT_MS && isOrphaned()) {\n        stderr.write(\n          `[gsd-mcp-server] Idle stdin watchdog: no activity for ${STDIN_IDLE_TIMEOUT_MS / 1000}s and parent process is gone, shutting down\\n`,\n        );\n        void cleanup();\n      }\n    }, STDIN_IDLE_CHECK_INTERVAL_MS);\n    idleWatchdog.unref();\n\n    // Ref-held parent-liveness monitor (#783). The idle watchdog above is\n    // `.unref()`'d, so a process pegged at ~100% CPU (e.g. a repeating throw\n    // against a dead stdio pipe) starves its event loop and the watchdog never\n    // fires — the orphan spins until the next launch sweeps it. This monitor is\n    // NOT unref'd: the loop keeps scheduling it under load, so parent loss is\n    // detected in seconds regardless of CPU state. It still requires the same\n    // idle gate as the watchdog so an active session whose parent briefly\n    // appears gone is not killed (#783 \"stays alive when parent is gone but\n    // stdin is still active\").\n    orphanMonitor = startInterval(() => {\n      if (!isOrphaned()) return;\n      const idleMs = trackedStdin ? now() - trackedStdin.lastActivityAt() : 0;\n      if (idleMs <= STDIN_IDLE_TIMEOUT_MS) return;\n      stderr.write(\n        `[gsd-mcp-server] Parent process is gone; shutting down to avoid orphan spin\\n`,\n      );\n      void cleanup();\n    }, ORPHAN_PARENT_LOSS_CHECK_INTERVAL_MS);\n\n    // Fail closed (ADR-036): warm the executor / write-gate bridges BEFORE\n    // connecting the transport. If a bridge is broken we must not advertise the\n    // workflow tool surface — a rejection here propagates to the catch below so\n    // startup aborts and the client never sees tools that would error on first\n    // call. A healthy warm-up pre-pays the bridge import so the first real tool\n    // call stays fast.\n    await warmBridges();\n    stderr.write('[gsd-mcp-server] workflow bridges ready\\n');\n\n    await server.connect(transport);\n    stderr.write('[gsd-mcp-server] MCP server started on stdio\\n');\n  } catch (err) {\n    stderr.write(\n      `[gsd-mcp-server] Fatal: failed to start — ${err instanceof Error ? err.message : String(err)}\\n`,\n    );\n    await cleanup(1);\n  }\n}\n"]}

package/packages/mcp-server/dist/cli.d.ts

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 /**
  * @opengsd/mcp-server CLI — stdio transport entry point.
  *

package/packages/mcp-server/dist/cli.d.ts.map

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

package/packages/mcp-server/dist/cli.js

@@ -1,61 +1,14 @@
+#!/usr/bin/env node
 /**
  * @opengsd/mcp-server CLI — stdio transport entry point.
  *
  * Connects the MCP server to stdin/stdout for use by Claude Code,
  * Cursor, and other MCP-compatible clients.
  */
-import { SessionManager } from './session-manager.js';
-import { createMcpServer } from './server.js';
 import { installGlobalErrorHandlers } from './cli-errors.js';
-import { loadStoredCredentialEnvKeys } from './tool-credentials.js';
-const MCP_PKG = '@modelcontextprotocol/sdk';
+import { runMcpServerCli } from './cli-runner.js';
 installGlobalErrorHandlers();
-async function main() {
-    loadStoredCredentialEnvKeys();
-    const sessionManager = new SessionManager();
-    // Create the configured MCP server with session, interactive, read-only,
-    // and workflow tools.
-    const { server } = await createMcpServer(sessionManager);
-    // Dynamic import for StdioServerTransport (same TS subpath workaround)
-    const { StdioServerTransport } = await import(`${MCP_PKG}/server/stdio.js`);
-    const transport = new StdioServerTransport();
-    // Cleanup handler — stop all sessions before exiting
-    let cleaningUp = false;
-    async function cleanup() {
-        if (cleaningUp)
-            return;
-        cleaningUp = true;
-        process.stderr.write('[gsd-mcp-server] Shutting down...\n');
-        try {
-            await sessionManager.cleanup();
-        }
-        catch {
-            // swallow cleanup errors
-        }
-        try {
-            await server.close();
-        }
-        catch {
-            // swallow close errors
-        }
-        process.exit(0);
-    }
-    process.on('SIGTERM', () => void cleanup());
-    process.on('SIGINT', () => void cleanup());
-    // Handle stdin end — MCP client disconnected
-    process.stdin.on('end', () => void cleanup());
-    // Connect and start serving
-    try {
-        await server.connect(transport);
-        process.stderr.write('[gsd-mcp-server] MCP server started on stdio\n');
-    }
-    catch (err) {
-        process.stderr.write(`[gsd-mcp-server] Fatal: failed to start — ${err instanceof Error ? err.message : String(err)}\n`);
-        await sessionManager.cleanup();
-        process.exit(1);
-    }
-}
-main().catch((err) => {
+runMcpServerCli().catch((err) => {
     process.stderr.write(`[gsd-mcp-server] Fatal: ${err instanceof Error ? err.message : String(err)}\n`);
     process.exit(1);
 });

package/packages/mcp-server/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEpE,MAAM,OAAO,GAAG,2BAA2B,CAAC;AAE5C,0BAA0B,EAAE,CAAC;AAE7B,KAAK,UAAU,IAAI;IACjB,2BAA2B,EAAE,CAAC;IAE9B,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;IAE5C,yEAAyE;IACzE,sBAAsB;IACtB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,eAAe,CAAC,cAAc,CAAC,CAAC;IAEzD,uEAAuE;IACvE,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,OAAO,kBAAkB,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,qDAAqD;IACrD,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,KAAK,UAAU,OAAO;QACpB,IAAI,UAAU;YAAE,OAAO;QACvB,UAAU,GAAG,IAAI,CAAC;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAE3C,6CAA6C;IAC7C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAE9C,4BAA4B;IAC5B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACzE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6CAA6C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAClG,CAAC;QACF,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAChF,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","sourcesContent":["/**\n * @opengsd/mcp-server CLI — stdio transport entry point.\n *\n * Connects the MCP server to stdin/stdout for use by Claude Code,\n * Cursor, and other MCP-compatible clients.\n */\n\nimport { SessionManager } from './session-manager.js';\nimport { createMcpServer } from './server.js';\nimport { installGlobalErrorHandlers } from './cli-errors.js';\nimport { loadStoredCredentialEnvKeys } from './tool-credentials.js';\n\nconst MCP_PKG = '@modelcontextprotocol/sdk';\n\ninstallGlobalErrorHandlers();\n\nasync function main(): Promise<void> {\n  loadStoredCredentialEnvKeys();\n\n  const sessionManager = new SessionManager();\n\n  // Create the configured MCP server with session, interactive, read-only,\n  // and workflow tools.\n  const { server } = await createMcpServer(sessionManager);\n\n  // Dynamic import for StdioServerTransport (same TS subpath workaround)\n  const { StdioServerTransport } = await import(`${MCP_PKG}/server/stdio.js`);\n  const transport = new StdioServerTransport();\n\n  // Cleanup handler — stop all sessions before exiting\n  let cleaningUp = false;\n  async function cleanup(): Promise<void> {\n    if (cleaningUp) return;\n    cleaningUp = true;\n    process.stderr.write('[gsd-mcp-server] Shutting down...\\n');\n    try {\n      await sessionManager.cleanup();\n    } catch {\n      // swallow cleanup errors\n    }\n    try {\n      await server.close();\n    } catch {\n      // swallow close errors\n    }\n    process.exit(0);\n  }\n\n  process.on('SIGTERM', () => void cleanup());\n  process.on('SIGINT', () => void cleanup());\n\n  // Handle stdin end — MCP client disconnected\n  process.stdin.on('end', () => void cleanup());\n\n  // Connect and start serving\n  try {\n    await server.connect(transport);\n    process.stderr.write('[gsd-mcp-server] MCP server started on stdio\\n');\n  } catch (err) {\n    process.stderr.write(\n      `[gsd-mcp-server] Fatal: failed to start — ${err instanceof Error ? err.message : String(err)}\\n`\n    );\n    await sessionManager.cleanup();\n    process.exit(1);\n  }\n}\n\nmain().catch((err) => {\n  process.stderr.write(\n    `[gsd-mcp-server] Fatal: ${err instanceof Error ? err.message : String(err)}\\n`\n  );\n  process.exit(1);\n});\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,0BAA0B,EAAE,CAAC;AAE7B,eAAe,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAChF,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\n/**\n * @opengsd/mcp-server CLI — stdio transport entry point.\n *\n * Connects the MCP server to stdin/stdout for use by Claude Code,\n * Cursor, and other MCP-compatible clients.\n */\n\nimport { installGlobalErrorHandlers } from './cli-errors.js';\nimport { runMcpServerCli } from './cli-runner.js';\n\ninstallGlobalErrorHandlers();\n\nrunMcpServerCli().catch((err) => {\n  process.stderr.write(\n    `[gsd-mcp-server] Fatal: ${err instanceof Error ? err.message : String(err)}\\n`\n  );\n  process.exit(1);\n});\n"]}

package/packages/mcp-server/dist/moonshot-tool-schema.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Moonshot-compatible MCP tool list schemas for Kimi Code and Moonshot API hosts.
+ *
+ * The MCP SDK converts Zod shapes to JSON Schema with anyOf for unions/nullable
+ * fields. Moonshot rejects those patterns on tools.function.parameters.
+ */
+type RegisteredTool = {
+    enabled: boolean;
+    title?: string;
+    description?: string;
+    inputSchema?: unknown;
+    outputSchema?: unknown;
+    annotations?: unknown;
+    execution?: unknown;
+    _meta?: unknown;
+};
+type McpServerWithRegisteredTools = {
+    server: {
+        setRequestHandler: (schema: unknown, handler: () => unknown) => void;
+    };
+    _registeredTools: Record<string, RegisteredTool>;
+};
+/**
+ * Replace the MCP SDK ListTools handler so every advertised inputSchema is
+ * flattened for Moonshot/Kimi grammar. Call after all tools are registered.
+ */
+export declare function installMoonshotCompatibleToolSchemas(mcpServer: McpServerWithRegisteredTools): void;
+export {};
+//# sourceMappingURL=moonshot-tool-schema.d.ts.map

package/packages/mcp-server/dist/moonshot-tool-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moonshot-tool-schema.d.ts","sourceRoot":"","sources":["../src/moonshot-tool-schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,KAAK,cAAc,GAAG;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,KAAK,4BAA4B,GAAG;IACnC,MAAM,EAAE;QACP,iBAAiB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,KAAK,IAAI,CAAC;KACrE,CAAC;IACF,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACjD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,SAAS,EAAE,4BAA4B,GAAG,IAAI,CAsClG"}

package/packages/mcp-server/dist/moonshot-tool-schema.js

@@ -0,0 +1,50 @@
+/**
+ * Moonshot-compatible MCP tool list schemas for Kimi Code and Moonshot API hosts.
+ *
+ * The MCP SDK converts Zod shapes to JSON Schema with anyOf for unions/nullable
+ * fields. Moonshot rejects those patterns on tools.function.parameters.
+ */
+import { ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { normalizeObjectSchema } from "@modelcontextprotocol/sdk/server/zod-compat.js";
+import { toJsonSchemaCompat } from "@modelcontextprotocol/sdk/server/zod-json-schema-compat.js";
+import { sanitizeSchemaForMoonshot } from "@gsd/pi-ai";
+const EMPTY_OBJECT_JSON_SCHEMA = { type: "object", properties: {} };
+/**
+ * Replace the MCP SDK ListTools handler so every advertised inputSchema is
+ * flattened for Moonshot/Kimi grammar. Call after all tools are registered.
+ */
+export function installMoonshotCompatibleToolSchemas(mcpServer) {
+    mcpServer.server.setRequestHandler(ListToolsRequestSchema, () => ({
+        tools: Object.entries(mcpServer._registeredTools)
+            .filter(([, tool]) => tool.enabled)
+            .map(([name, tool]) => {
+            const inputObj = normalizeObjectSchema(tool.inputSchema);
+            const rawInputSchema = inputObj
+                ? toJsonSchemaCompat(inputObj, {
+                    strictUnions: true,
+                    pipeStrategy: "input",
+                })
+                : EMPTY_OBJECT_JSON_SCHEMA;
+            const toolDefinition = {
+                name,
+                title: tool.title,
+                description: tool.description,
+                inputSchema: sanitizeSchemaForMoonshot(rawInputSchema),
+                annotations: tool.annotations,
+                execution: tool.execution,
+                _meta: tool._meta,
+            };
+            if (tool.outputSchema) {
+                const outputObj = normalizeObjectSchema(tool.outputSchema);
+                if (outputObj) {
+                    toolDefinition.outputSchema = sanitizeSchemaForMoonshot(toJsonSchemaCompat(outputObj, {
+                        strictUnions: true,
+                        pipeStrategy: "output",
+                    }));
+                }
+            }
+            return toolDefinition;
+        }),
+    }));
+}
+//# sourceMappingURL=moonshot-tool-schema.js.map

package/packages/mcp-server/dist/moonshot-tool-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moonshot-tool-schema.js","sourceRoot":"","sources":["../src/moonshot-tool-schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,4DAA4D,CAAC;AAChG,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,wBAAwB,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAW,CAAC;AAoB7E;;;GAGG;AACH,MAAM,UAAU,oCAAoC,CAAC,SAAuC;IAC3F,SAAS,CAAC,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC;QACjE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC;aAC/C,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;aAClC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;YACrB,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,WAA0D,CAAC,CAAC;YACxG,MAAM,cAAc,GAAG,QAAQ;gBAC9B,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;oBAC7B,YAAY,EAAE,IAAI;oBAClB,YAAY,EAAE,OAAO;iBACrB,CAAC;gBACH,CAAC,CAAC,wBAAwB,CAAC;YAE5B,MAAM,cAAc,GAA4B;gBAC/C,IAAI;gBACJ,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,WAAW,EAAE,yBAAyB,CAAC,cAAc,CAAC;gBACtD,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,KAAK,EAAE,IAAI,CAAC,KAAK;aACjB,CAAC;YAEF,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACvB,MAAM,SAAS,GAAG,qBAAqB,CAAC,IAAI,CAAC,YAA2D,CAAC,CAAC;gBAC1G,IAAI,SAAS,EAAE,CAAC;oBACf,cAAc,CAAC,YAAY,GAAG,yBAAyB,CACtD,kBAAkB,CAAC,SAAS,EAAE;wBAC7B,YAAY,EAAE,IAAI;wBAClB,YAAY,EAAE,QAAQ;qBACtB,CAAC,CACF,CAAC;gBACH,CAAC;YACF,CAAC;YAED,OAAO,cAAc,CAAC;QACvB,CAAC,CAAC;KACH,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * Moonshot-compatible MCP tool list schemas for Kimi Code and Moonshot API hosts.\n *\n * The MCP SDK converts Zod shapes to JSON Schema with anyOf for unions/nullable\n * fields. Moonshot rejects those patterns on tools.function.parameters.\n */\n\nimport { ListToolsRequestSchema } from \"@modelcontextprotocol/sdk/types.js\";\nimport { normalizeObjectSchema } from \"@modelcontextprotocol/sdk/server/zod-compat.js\";\nimport { toJsonSchemaCompat } from \"@modelcontextprotocol/sdk/server/zod-json-schema-compat.js\";\nimport { sanitizeSchemaForMoonshot } from \"@gsd/pi-ai\";\n\nconst EMPTY_OBJECT_JSON_SCHEMA = { type: \"object\", properties: {} } as const;\n\ntype RegisteredTool = {\n\tenabled: boolean;\n\ttitle?: string;\n\tdescription?: string;\n\tinputSchema?: unknown;\n\toutputSchema?: unknown;\n\tannotations?: unknown;\n\texecution?: unknown;\n\t_meta?: unknown;\n};\n\ntype McpServerWithRegisteredTools = {\n\tserver: {\n\t\tsetRequestHandler: (schema: unknown, handler: () => unknown) => void;\n\t};\n\t_registeredTools: Record<string, RegisteredTool>;\n};\n\n/**\n * Replace the MCP SDK ListTools handler so every advertised inputSchema is\n * flattened for Moonshot/Kimi grammar. Call after all tools are registered.\n */\nexport function installMoonshotCompatibleToolSchemas(mcpServer: McpServerWithRegisteredTools): void {\n\tmcpServer.server.setRequestHandler(ListToolsRequestSchema, () => ({\n\t\ttools: Object.entries(mcpServer._registeredTools)\n\t\t\t.filter(([, tool]) => tool.enabled)\n\t\t\t.map(([name, tool]) => {\n\t\t\t\tconst inputObj = normalizeObjectSchema(tool.inputSchema as Parameters<typeof normalizeObjectSchema>[0]);\n\t\t\t\tconst rawInputSchema = inputObj\n\t\t\t\t\t? toJsonSchemaCompat(inputObj, {\n\t\t\t\t\t\t\tstrictUnions: true,\n\t\t\t\t\t\t\tpipeStrategy: \"input\",\n\t\t\t\t\t\t})\n\t\t\t\t\t: EMPTY_OBJECT_JSON_SCHEMA;\n\n\t\t\t\tconst toolDefinition: Record<string, unknown> = {\n\t\t\t\t\tname,\n\t\t\t\t\ttitle: tool.title,\n\t\t\t\t\tdescription: tool.description,\n\t\t\t\t\tinputSchema: sanitizeSchemaForMoonshot(rawInputSchema),\n\t\t\t\t\tannotations: tool.annotations,\n\t\t\t\t\texecution: tool.execution,\n\t\t\t\t\t_meta: tool._meta,\n\t\t\t\t};\n\n\t\t\t\tif (tool.outputSchema) {\n\t\t\t\t\tconst outputObj = normalizeObjectSchema(tool.outputSchema as Parameters<typeof normalizeObjectSchema>[0]);\n\t\t\t\t\tif (outputObj) {\n\t\t\t\t\t\ttoolDefinition.outputSchema = sanitizeSchemaForMoonshot(\n\t\t\t\t\t\t\ttoJsonSchemaCompat(outputObj, {\n\t\t\t\t\t\t\t\tstrictUnions: true,\n\t\t\t\t\t\t\t\tpipeStrategy: \"output\",\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\treturn toolDefinition;\n\t\t\t}),\n\t}));\n}\n"]}

package/packages/mcp-server/dist/pid-registry.d.ts

@@ -0,0 +1,46 @@
+/**
+ * MCP server PID registry — tracks running instances per project so new
+ * launches can kill stale ones. Mirrors web-mode's web-instances.json pattern.
+ */
+export interface McpInstanceEntry {
+    pid: number;
+    projectDir: string;
+    startedAt: string;
+}
+export type McpInstanceRegistry = Record<string, McpInstanceEntry>;
+export interface RegisterMcpInstanceOptions {
+    kill?: (pid: number, signal?: NodeJS.Signals | 0) => void;
+    getProcessCommand?: (pid: number) => string | null;
+    getProcessCwd?: (pid: number) => string | null;
+    getProcessStartTime?: (pid: number) => number | null;
+    waitForExit?: () => void;
+}
+export interface McpProcessSnapshot {
+    pid: number;
+    ppid: number;
+    command: string;
+}
+export interface SweepProjectOrphanMcpServersOptions {
+    kill?: (pid: number, signal?: NodeJS.Signals | 0) => void;
+    getProcessCwd?: (pid: number) => string | null;
+    listProcesses?: () => McpProcessSnapshot[];
+    isOrphaned?: (proc: McpProcessSnapshot) => boolean;
+    waitForExit?: () => void;
+}
+export interface SweepProjectOrphanMcpServersResult {
+    matched: number[];
+    terminated: number[];
+    forceKilled: number[];
+    skipped: number[];
+}
+export declare function readMcpRegistry(registryPath?: string): McpInstanceRegistry;
+export declare function sweepProjectOrphanMcpServers(projectDir: string, options?: SweepProjectOrphanMcpServersOptions): SweepProjectOrphanMcpServersResult;
+/**
+ * Kill any existing MCP server for this project, then register our PID.
+ */
+export declare function registerMcpInstance(projectDir: string, registryPath?: string, options?: RegisterMcpInstanceOptions): boolean;
+/**
+ * Remove our PID from the registry on shutdown.
+ */
+export declare function unregisterMcpInstance(projectDir: string, registryPath?: string): void;
+//# sourceMappingURL=pid-registry.d.ts.map

package/packages/mcp-server/dist/pid-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pid-registry.d.ts","sourceRoot":"","sources":["../src/pid-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAEnE,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,IAAI,CAAC;IAC1D,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACnD,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC/C,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACrD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mCAAmC;IAClD,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,IAAI,CAAC;IAC1D,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC/C,aAAa,CAAC,EAAE,MAAM,kBAAkB,EAAE,CAAC;IAC3C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC;IACnD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAaD,wBAAgB,eAAe,CAAC,YAAY,SAAgB,GAAG,mBAAmB,CAwCjF;AAwRD,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,mCAAwC,GAChD,kCAAkC,CAgDpC;AAkED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,YAAY,SAAgB,EAC5B,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAgCT;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,SAAgB,GAAG,IAAI,CAa5F"}