@opengsd/gsd-pi 1.2.0-dev.84c56d87 → 1.2.0-dev.8e6112e9

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;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,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,0EAA0E;IAC1E,uEAAuE;IACvE,qEAAqE;IACrE,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAC;QAC1E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wEAAwE,CAAC,CAAC;IACjG,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';\nimport { warmWorkflowToolBridges } from './workflow-tools.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. The workflow bridges are warmed eagerly so a\n  // broken executor/write-gate module fails the spawn with an actionable\n  // error instead of advertising tools that error on their first call.\n  try {\n    await Promise.all([server.connect(transport), warmWorkflowToolBridges()]);\n    process.stderr.write('[gsd-mcp-server] MCP server started on stdio; workflow bridges ready\\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":"AAAA;;;;;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":["/**\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;AA+QD,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"}

package/packages/mcp-server/dist/pid-registry.js

@@ -0,0 +1,452 @@
+/**
+ * MCP server PID registry — tracks running instances per project so new
+ * launches can kill stale ones. Mirrors web-mode's web-instances.json pattern.
+ */
+import { execFileSync } from 'node:child_process';
+import { readFileSync, writeFileSync, mkdirSync, renameSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+const REGISTRY_PATH = join(process.env.GSD_HOME || join(homedir(), '.gsd'), 'mcp-instances.json');
+// A live PID is only treated as "our" stale server if its OS start time is no
+// later than the moment we recorded the registry entry (plus a small skew for
+// clock granularity / start-vs-register delay). A PID that started materially
+// later has been recycled by a different process and must not be signalled.
+const STALE_PID_START_SKEW_MS = 60_000;
+export function readMcpRegistry(registryPath = REGISTRY_PATH) {
+    let raw;
+    try {
+        raw = readFileSync(registryPath, 'utf8');
+    }
+    catch (err) {
+        // A missing file is the normal first-run case — start with an empty
+        // registry silently. Any other read error is worth surfacing.
+        if (err.code !== 'ENOENT') {
+            process.stderr.write(`[gsd-mcp-server] failed to read MCP registry ${registryPath}: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+        return {};
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        throw new Error('registry is not a JSON object');
+    }
+    catch (err) {
+        // The file exists but is unparseable. Returning {} here means the next
+        // registerMcpInstance would overwrite the file and silently drop every
+        // other project's entry. The corrupt bytes can't be recovered, but we
+        // preserve them for forensics and warn loudly instead of dropping them
+        // without a trace.
+        const backup = `${registryPath}.corrupt-${Date.now()}`;
+        try {
+            renameSync(registryPath, backup);
+            process.stderr.write(`[gsd-mcp-server] MCP registry ${registryPath} was corrupt (${err instanceof Error ? err.message : String(err)}); preserved as ${backup}\n`);
+        }
+        catch {
+            process.stderr.write(`[gsd-mcp-server] MCP registry ${registryPath} was corrupt (${err instanceof Error ? err.message : String(err)}) and could not be preserved\n`);
+        }
+        return {};
+    }
+}
+function writeMcpRegistry(registry, registryPath = REGISTRY_PATH) {
+    mkdirSync(dirname(registryPath), { recursive: true });
+    writeFileSync(registryPath, JSON.stringify(registry, null, 2), 'utf8');
+}
+function defaultGetProcessCommand(pid) {
+    try {
+        if (process.platform === 'win32') {
+            // `ps` does not exist on Windows; query the process command line via CIM
+            // so stale same-project cleanup is not silently disabled there.
+            const out = execFileSync('powershell.exe', [
+                '-NoProfile',
+                '-NonInteractive',
+                '-Command',
+                `(Get-CimInstance Win32_Process -Filter "ProcessId=${pid}").CommandLine`,
+            ], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+            return out || null;
+        }
+        const command = execFileSync('ps', ['-p', String(pid), '-o', 'command='], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            env: { ...process.env, LC_ALL: 'C' },
+        }).trim();
+        return command || null;
+    }
+    catch {
+        return null;
+    }
+}
+function defaultGetProcessStartTime(pid) {
+    try {
+        if (process.platform === 'win32') {
+            const out = execFileSync('powershell.exe', [
+                '-NoProfile',
+                '-NonInteractive',
+                '-Command',
+                `$p = Get-CimInstance Win32_Process -Filter "ProcessId=${pid}"; if ($p) { [int64](($p.CreationDate.ToUniversalTime() - [datetime]'1970-01-01T00:00:00Z').TotalMilliseconds) }`,
+            ], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+            const ms = Number(out);
+            return Number.isFinite(ms) && ms > 0 ? ms : null;
+        }
+        // `lstart` is supported by both Linux (procps) and macOS (BSD) ps. Force
+        // the C locale so the timestamp is parseable regardless of the user's LANG.
+        const lstart = execFileSync('ps', ['-p', String(pid), '-o', 'lstart='], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            env: { ...process.env, LC_ALL: 'C' },
+        }).trim();
+        if (!lstart)
+            return null;
+        const ms = new Date(lstart).getTime();
+        return Number.isFinite(ms) ? ms : null;
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeProcessCwd(value) {
+    return value.startsWith('\\\\?\\') ? value.slice(4) : value;
+}
+function defaultGetProcessCwd(pid) {
+    if (process.platform === 'win32') {
+        try {
+            const out = execFileSync('powershell.exe', [
+                '-NoProfile',
+                '-NonInteractive',
+                '-Command',
+                `$pid=${pid};$t=@'
+using System;using System.Runtime.InteropServices;using System.Text;
+public static class GsdProcCwd{
+ [DllImport("kernel32.dll")] public static extern IntPtr OpenProcess(int a,bool b,int p);
+ [DllImport("kernel32.dll")] public static extern bool CloseHandle(IntPtr h);
+ [DllImport("kernel32.dll")] public static extern bool ReadProcessMemory(IntPtr h,IntPtr a,byte[] b,int l,out int r);
+ [DllImport("ntdll.dll")] public static extern int NtQueryInformationProcess(IntPtr h,int c,byte[] i,int l,out int o);
+ public static string G(int pid){
+  IntPtr h=OpenProcess(0x1010,false,pid);if(h==IntPtr.Zero)return null;
+  try{bool x=IntPtr.Size==8;int n=IntPtr.Size*6;byte[] pbi=new byte[n];int o;
+  if(NtQueryInformationProcess(h,0,pbi,n,out o)!=0)return null;
+  IntPtr peb=x?(IntPtr)BitConverter.ToInt64(pbi,IntPtr.Size):(IntPtr)BitConverter.ToInt32(pbi,4);
+  byte[] ptr=new byte[IntPtr.Size];int rd;
+  if(!ReadProcessMemory(h,IntPtr.Add(peb,x?0x20:0x10),ptr,ptr.Length,out rd))return null;
+  IntPtr pp=x?(IntPtr)BitConverter.ToInt64(ptr,0):(IntPtr)BitConverter.ToInt32(ptr,0);
+  byte[] us=new byte[16];
+  if(!ReadProcessMemory(h,IntPtr.Add(pp,x?0x38:0x24),us,us.Length,out rd))return null;
+  int len=BitConverter.ToUInt16(us,0);if(len<=0||len>32766)return null;
+  IntPtr buf=x?(IntPtr)BitConverter.ToInt64(us,8):(IntPtr)BitConverter.ToInt32(us,4);
+  byte[] ch=new byte[len];
+  if(!ReadProcessMemory(h,buf,ch,ch.Length,out rd))return null;
+  return Encoding.Unicode.GetString(ch,0,len);}finally{CloseHandle(h);}}
+}
+'@;Add-Type -TypeDefinition $t -ErrorAction Stop;[GsdProcCwd]::G($pid)`,
+            ], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+            if (!out)
+                return null;
+            return normalizeProcessCwd(out);
+        }
+        catch {
+            return null;
+        }
+    }
+    try {
+        const out = execFileSync('lsof', ['-a', '-p', String(pid), '-d', 'cwd', '-Fn'], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            env: { ...process.env, LC_ALL: 'C' },
+        });
+        const cwd = out.split('\n').find((line) => line.startsWith('n'))?.slice(1).trim();
+        if (cwd)
+            return cwd;
+    }
+    catch {
+    }
+    try {
+        const out = execFileSync('pwdx', [String(pid)], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            env: { ...process.env, LC_ALL: 'C' },
+        }).trim();
+        const match = /^\d+:\s+(.+)$/.exec(out);
+        return match?.[1]?.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+function isSafePid(pid) {
+    return typeof pid === 'number' && Number.isSafeInteger(pid) && pid > 1;
+}
+function isMcpServerCommand(command) {
+    if (!command)
+        return false;
+    const normalized = command.replace(/\\/g, '/');
+    return (command.includes('gsd-mcp-server') ||
+        command.includes('@opengsd/mcp-server') ||
+        normalized.includes('/packages/mcp-server/'));
+}
+function defaultListProcesses() {
+    if (process.platform === 'win32') {
+        try {
+            const out = execFileSync('powershell.exe', [
+                '-NoProfile',
+                '-NonInteractive',
+                '-Command',
+                'Get-CimInstance Win32_Process | Select-Object ProcessId,ParentProcessId,CommandLine | ConvertTo-Json -Compress',
+            ], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+            if (!out)
+                return [];
+            const parsed = JSON.parse(out);
+            const rows = Array.isArray(parsed) ? parsed : [parsed];
+            return rows.flatMap((row) => {
+                if (!row || typeof row !== 'object')
+                    return [];
+                const record = row;
+                const pid = Number(record.ProcessId);
+                const ppid = Number(record.ParentProcessId);
+                const command = typeof record.CommandLine === 'string' ? record.CommandLine : '';
+                if (!Number.isSafeInteger(pid) || !Number.isSafeInteger(ppid))
+                    return [];
+                return [{ pid, ppid, command }];
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    try {
+        const out = execFileSync('ps', ['-axo', 'pid=,ppid=,command='], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            env: { ...process.env, LC_ALL: 'C' },
+        });
+        return out.split('\n').flatMap((line) => {
+            const match = /^\s*(\d+)\s+(\d+)\s+(.+)$/.exec(line);
+            if (!match)
+                return [];
+            return [{
+                    pid: Number(match[1]),
+                    ppid: Number(match[2]),
+                    command: match[3],
+                }];
+        });
+    }
+    catch {
+        return [];
+    }
+}
+function defaultWaitForExit() {
+    const shared = new Int32Array(new SharedArrayBuffer(4));
+    Atomics.wait(shared, 0, 0, 250);
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function normalizeCommandPath(value) {
+    return value.replace(/\\/g, '/');
+}
+function resolveComparableProjectPath(projectDir) {
+    if (/^[A-Za-z]:[\\/]/.test(projectDir) || projectDir.startsWith('\\\\')) {
+        return normalizeCommandPath(projectDir);
+    }
+    return normalizeCommandPath(resolve(projectDir));
+}
+function projectRegistryKeys(projectDir) {
+    return [...new Set([
+            resolveComparableProjectPath(projectDir),
+            resolve(projectDir),
+            projectDir,
+        ])];
+}
+function commandContainsProjectPath(command, projectDir) {
+    const normalizedProject = resolveComparableProjectPath(projectDir);
+    const normalizedCommand = normalizeCommandPath(command);
+    const pattern = new RegExp(`(^|[\\s"'])${escapeRegExp(normalizedProject)}(?=$|[/\\s"'])`);
+    return pattern.test(normalizedCommand);
+}
+function isSameProjectMcpProcess(command, cwd, projectDir) {
+    if (!isMcpServerCommand(command))
+        return false;
+    if (cwd && resolveComparableProjectPath(normalizeProcessCwd(cwd)) === resolveComparableProjectPath(projectDir))
+        return true;
+    return commandContainsProjectPath(command, projectDir);
+}
+function isPidAlive(pid, sendSignal) {
+    try {
+        sendSignal(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return !(error instanceof Error &&
+            'code' in error &&
+            error.code === 'ESRCH');
+    }
+}
+function isOrphanedMcpProcess(proc, sendSignal) {
+    if (process.platform === 'win32') {
+        // Windows does not reparent orphans to PID 1; the PPID usually still
+        // points at the dead parent, so treat a missing parent as orphaned.
+        if (!isSafePid(proc.ppid))
+            return false;
+        return !isPidAlive(proc.ppid, sendSignal);
+    }
+    return proc.ppid === 1;
+}
+export function sweepProjectOrphanMcpServers(projectDir, options = {}) {
+    const sendSignal = options.kill ?? ((targetPid, signal) => process.kill(targetPid, signal));
+    const getProcessCwd = options.getProcessCwd ?? defaultGetProcessCwd;
+    const listProcesses = options.listProcesses ?? defaultListProcesses;
+    const isOrphaned = options.isOrphaned ?? ((proc) => isOrphanedMcpProcess(proc, sendSignal));
+    const waitForExit = options.waitForExit ?? defaultWaitForExit;
+    const result = {
+        matched: [],
+        terminated: [],
+        forceKilled: [],
+        skipped: [],
+    };
+    for (const proc of listProcesses()) {
+        if (!isSafePid(proc.pid) || proc.pid === process.pid)
+            continue;
+        if (!isOrphaned(proc))
+            continue;
+        if (!isMcpServerCommand(proc.command))
+            continue;
+        const cwd = commandContainsProjectPath(proc.command, projectDir) ? null : getProcessCwd(proc.pid);
+        if (!isSameProjectMcpProcess(proc.command, cwd, projectDir))
+            continue;
+        result.matched.push(proc.pid);
+        if (!isPidAlive(proc.pid, sendSignal)) {
+            result.skipped.push(proc.pid);
+            continue;
+        }
+        try {
+            sendSignal(proc.pid, 'SIGTERM');
+            result.terminated.push(proc.pid);
+        }
+        catch {
+            result.skipped.push(proc.pid);
+        }
+    }
+    if (result.terminated.length > 0)
+        waitForExit();
+    for (const pid of result.terminated) {
+        if (!isPidAlive(pid, sendSignal))
+            continue;
+        try {
+            sendSignal(pid, 'SIGKILL');
+            result.forceKilled.push(pid);
+        }
+        catch {
+            result.skipped.push(pid);
+        }
+    }
+    return result;
+}
+function killPid(pid, projectDir, startedAt, options = {}) {
+    if (!isSafePid(pid))
+        return 'invalid';
+    const sendSignal = options.kill ?? ((targetPid, signal) => process.kill(targetPid, signal));
+    const getProcessCommand = options.getProcessCommand ?? defaultGetProcessCommand;
+    const getProcessCwd = options.getProcessCwd ?? defaultGetProcessCwd;
+    const getProcessStartTime = options.getProcessStartTime ?? defaultGetProcessStartTime;
+    const waitForExit = options.waitForExit ?? defaultWaitForExit;
+    try {
+        sendSignal(pid, 0);
+    }
+    catch (error) {
+        const isAlreadyDead = error instanceof Error && 'code' in error && error.code === 'ESRCH';
+        if (isAlreadyDead)
+            return 'already-dead';
+        return { error: error instanceof Error ? error.message : String(error) };
+    }
+    const command = getProcessCommand(pid);
+    if (!command || !isMcpServerCommand(command))
+        return 'unverified';
+    const cwd = getProcessCwd(pid);
+    const recordedMs = startedAt ? Date.parse(startedAt) : NaN;
+    const actualStartMs = getProcessStartTime(pid);
+    // Guard against PID reuse: a recycled PID can belong to a *different* live
+    // MCP server (even for another project). If we can determine when the live
+    // process actually started and it began materially after we recorded this
+    // entry, the original server is gone and this PID is not ours — refuse to
+    // signal it.
+    if (Number.isFinite(recordedMs) &&
+        actualStartMs !== null &&
+        actualStartMs > recordedMs + STALE_PID_START_SKEW_MS) {
+        return 'unverified';
+    }
+    // Confirm the live MCP server is the one we registered for this project via
+    // the process cwd or an embedded project path. Start time alone is not enough
+    // to authorize a signal when cwd is unavailable — another project's global
+    // install can share the same command line and a coincidentally aligned start.
+    const sameProject = isSameProjectMcpProcess(command, cwd, projectDir);
+    if (!sameProject)
+        return 'unverified';
+    try {
+        sendSignal(pid, 'SIGTERM');
+        waitForExit();
+        if (!isPidAlive(pid, sendSignal))
+            return 'killed';
+        sendSignal(pid, 'SIGKILL');
+        return 'force-killed';
+    }
+    catch (error) {
+        const isAlreadyDead = error instanceof Error && 'code' in error && error.code === 'ESRCH';
+        if (isAlreadyDead)
+            return 'already-dead';
+        return { error: error instanceof Error ? error.message : String(error) };
+    }
+}
+/**
+ * Kill any existing MCP server for this project, then register our PID.
+ */
+export function registerMcpInstance(projectDir, registryPath = REGISTRY_PATH, options = {}) {
+    const registry = readMcpRegistry(registryPath);
+    const keys = projectRegistryKeys(projectDir);
+    const key = keys[0];
+    const existingKey = keys.find((candidate) => candidate in registry);
+    const existing = existingKey ? registry[existingKey] : undefined;
+    if (existing && existing.pid !== process.pid) {
+        const result = killPid(existing.pid, key, existing.startedAt, options);
+        const label = result === 'killed'
+            ? `killed stale pid=${existing.pid}`
+            : result === 'force-killed'
+                ? `force-killed stale pid=${existing.pid}`
+                : result === 'already-dead'
+                    ? `stale pid=${existing.pid} already dead`
+                    : result === 'invalid'
+                        ? `ignored invalid stale pid=${String(existing.pid)}`
+                        : result === 'unverified'
+                            ? `ignored unverified stale pid=${existing.pid}`
+                            : `failed to kill pid=${existing.pid}: ${result.error}`;
+        process.stderr.write(`[gsd-mcp-server] ${label} for ${key}\n`);
+        if (result === 'unverified')
+            return false;
+    }
+    if (existingKey && existingKey !== key)
+        delete registry[existingKey];
+    registry[key] = {
+        pid: process.pid,
+        projectDir: key,
+        startedAt: new Date().toISOString(),
+    };
+    writeMcpRegistry(registry, registryPath);
+    return true;
+}
+/**
+ * Remove our PID from the registry on shutdown.
+ */
+export function unregisterMcpInstance(projectDir, registryPath = REGISTRY_PATH) {
+    const keys = projectRegistryKeys(projectDir);
+    const registry = readMcpRegistry(registryPath);
+    let changed = false;
+    for (const key of keys) {
+        if (registry[key]?.pid === process.pid) {
+            delete registry[key];
+            changed = true;
+        }
+    }
+    if (changed) {
+        writeMcpRegistry(registry, registryPath);
+    }
+}
+//# sourceMappingURL=pid-registry.js.map