@wootsup/mcp 0.1.0-rc.1

package/dist/server-http.js

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+// src/server-http.ts — Phase 9.2 HTTP entry point.
+//
+// Boots the http+OAuth transport for the API Mapper MCP server. Used by:
+//   - `npm run start:http` (local dev / staging)
+//   - the future hosted service at mcp.wootsup.com (Phase 10+)
+//
+// The MCP handler bridges incoming JSON-RPC requests to a real
+// SDK-managed McpServer via `createServer()` + `InMemoryTransport.createLinkedPair()`.
+// Each HTTP request is serialised through the in-memory transport pair so
+// the MCP server's full handler-registry runs (initialize, tools/list,
+// tools/call all dispatch correctly). Tests can pass their own handler
+// stub via `bootHttpServer({ mcpHandler })`.
+import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
+import { loadModules } from "@getimo/mcp-toolkit";
+import { createHttpTransportServer } from "./transports/http.js";
+import { createOAuthProvider } from "./auth/oauth-provider.js";
+import { createServer } from "./index.js";
+import { apimapperRestModule } from "./modules/apimapper/index.js";
+const DEFAULT_PORT = (() => {
+    const env = process.env.APIMAPPER_HTTP_PORT;
+    const parsed = env ? Number.parseInt(env, 10) : NaN;
+    return Number.isFinite(parsed) ? parsed : 8901;
+})();
+/**
+ * Default MCP handler — closes Phase 9.2 "deferred SDK binding" gap
+ * (R7 audit finding 2026-05-18).
+ *
+ * Lazily boots a real McpServer + loads all api-mapper modules + connects
+ * it to one end of an InMemoryTransport pair. The HTTP handler-callback
+ * sends each incoming JSON-RPC request through the other end and awaits
+ * the matching response by id.
+ *
+ * This makes the HTTP transport functionally equivalent to stdio:
+ * initialize, tools/list, tools/call all dispatch through the same
+ * McpServer instance + tool registry that the stdio transport uses.
+ */
+let mcpHandlerSingleton = null;
+let mcpServerSingleton = null;
+let mcpModuleStatuses = [];
+async function getDefaultMcpHandler() {
+    if (mcpHandlerSingleton)
+        return mcpHandlerSingleton;
+    const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+    const server = createServer();
+    mcpServerSingleton = server;
+    mcpModuleStatuses = await loadModules(server, [apimapperRestModule]);
+    await server.connect(serverTransport);
+    // The client end stays open for the lifetime of the HTTP server. Each
+    // HTTP request sends a JSON-RPC message in and registers a one-shot
+    // resolver keyed on the JSON-RPC id; the McpServer's reply lands on
+    // clientTransport.onmessage and resolves the matching pending promise.
+    await clientTransport.start();
+    const pending = new Map();
+    clientTransport.onmessage = (message) => {
+        const m = message;
+        if (m && m.id !== undefined && pending.has(m.id)) {
+            const resolve = pending.get(m.id);
+            pending.delete(m.id);
+            resolve(message);
+        }
+        // Server-initiated notifications (no id) are intentionally dropped —
+        // the HTTP transport is request/response only.
+    };
+    mcpHandlerSingleton = async (body) => {
+        const req = body;
+        // Notifications carry no id and expect no response. Forward + return
+        // 202-like empty body to caller.
+        if (req.id === undefined) {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any -- SDK message type is broader
+                await clientTransport.send(body);
+            }
+            catch {
+                /* ignore — notification fire-and-forget */
+            }
+            return { jsonrpc: "2.0", result: { ok: true } };
+        }
+        // Request/response: register resolver, send, await reply.
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                if (pending.has(req.id)) {
+                    pending.delete(req.id);
+                    resolve({
+                        jsonrpc: "2.0",
+                        id: req.id,
+                        error: { code: -32000, message: "HTTP→MCP dispatch timed out after 30s" },
+                    });
+                }
+            }, 30_000);
+            pending.set(req.id, (msg) => {
+                clearTimeout(timer);
+                resolve(msg);
+            });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any -- SDK message type is broader
+            void clientTransport.send(body).catch((err) => {
+                clearTimeout(timer);
+                pending.delete(req.id);
+                resolve({
+                    jsonrpc: "2.0",
+                    id: req.id,
+                    error: { code: -32603, message: `dispatch failed: ${err.message}` },
+                });
+            });
+        });
+    };
+    return mcpHandlerSingleton;
+}
+/** Test-only — exposes the server + module load status for assertions. */
+export function _testGetMcpServer() {
+    return { server: mcpServerSingleton, modules: mcpModuleStatuses };
+}
+export async function bootHttpServer(options = {}) {
+    const port = options.port ?? DEFAULT_PORT;
+    const oauth = createOAuthProvider();
+    const mcpHandler = options.mcpHandler ?? (await getDefaultMcpHandler());
+    const transport = await createHttpTransportServer({
+        port,
+        oauth,
+        mcpHandler,
+        publicBaseUrl: options.publicBaseUrl,
+    });
+    return { ...transport, oauth };
+}
+// ── CLI entry ──────────────────────────────────────────────────────────
+// Only auto-boot when this file is executed as the process entrypoint
+// (i.e. `node dist/server-http.js`), never when imported by tests.
+const isEntry = (() => {
+    if (typeof process.argv[1] !== "string")
+        return false;
+    // import.meta.url is a file:// URL; argv[1] is a path. Map both to
+    // a comparable form.
+    try {
+        const argvUrl = new URL(`file://${process.argv[1]}`).href;
+        return argvUrl === import.meta.url;
+    }
+    catch {
+        return false;
+    }
+})();
+if (isEntry) {
+    bootHttpServer()
+        .then((s) => {
+        // eslint-disable-next-line no-console -- intentional startup log
+        console.error(`[apimapper-mcp] HTTP transport listening on ${s.url}`);
+        const shutdown = async () => {
+            await s.close();
+            process.exit(0);
+        };
+        process.on("SIGTERM", shutdown);
+        process.on("SIGINT", shutdown);
+    })
+        .catch((err) => {
+        // eslint-disable-next-line no-console -- intentional fatal log
+        console.error("[apimapper-mcp] HTTP boot failed:", err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=server-http.js.map

package/dist/server-http.js.map

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

package/dist/setup/detect-clients.d.ts

@@ -0,0 +1,39 @@
+import { dirname } from "node:path";
+export type ClientId = "claude-desktop" | "claude-code" | "cursor" | "vscode" | "cline" | "codex";
+export type ClientFormat = "json" | "toml";
+export interface DetectedClient {
+    id: ClientId;
+    label: string;
+    configPath: string;
+    format: ClientFormat;
+    installed: boolean;
+}
+/**
+ * Injectable environment surface. `existsSync` is the only file-system
+ * dependency; everything else is pure-data lookup of OS/env.
+ */
+export interface DetectEnv {
+    platform: () => NodeJS.Platform;
+    homedir: () => string;
+    env: Partial<Record<string, string>>;
+    existsSync: (p: string) => boolean;
+}
+interface ClientDef {
+    id: ClientId;
+    label: string;
+    format: ClientFormat;
+    /**
+     * Per-platform path-builders. The function receives a small ctx so it
+     * can compute paths from homedir and APPDATA without re-reading env.
+     */
+    pathBy: Record<"darwin" | "linux" | "win32" | "default", (ctx: PathCtx) => string>;
+}
+interface PathCtx {
+    home: string;
+    appdata: string;
+}
+/** Cross-platform path-join that respects whichever separator the home uses. */
+declare function joinPath(home: string, ...parts: string[]): string;
+export declare const CLIENT_DEFS: readonly ClientDef[];
+export declare function detectClients(env?: DetectEnv): Promise<DetectedClient[]>;
+export { joinPath, dirname };

package/dist/setup/detect-clients.js

@@ -0,0 +1,152 @@
+// src/setup/detect-clients.ts — Phase 6.2.
+//
+// Per-OS auto-discovery of AI-client config-file locations for the six
+// supported clients. All path logic is data-driven via CLIENT_DEFS so
+// future clients are a single table entry, not a code change.
+//
+// The module accepts an injectable DetectEnv so that tests can pretend
+// to be running on any OS without touching the real filesystem.
+import { existsSync as realExistsSync } from "node:fs";
+import { platform as realPlatform, homedir as realHomedir } from "node:os";
+import { dirname } from "node:path";
+const PSEP = (home) => (home.includes("\\") ? "\\" : "/");
+/** Cross-platform path-join that respects whichever separator the home uses. */
+function joinPath(home, ...parts) {
+    const sep = PSEP(home);
+    // We don't use node:path here because we want deterministic output for
+    // Windows-style homes on a posix test runner.
+    const acc = [home, ...parts]
+        .map((seg) => seg.replace(/[\\/]+$/, ""))
+        .filter((seg) => seg.length > 0);
+    return acc.join(sep);
+}
+export const CLIENT_DEFS = [
+    {
+        id: "claude-desktop",
+        label: "Claude Desktop",
+        format: "json",
+        pathBy: {
+            darwin: ({ home }) => joinPath(home, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
+            linux: ({ home }) => joinPath(home, ".config", "Claude", "claude_desktop_config.json"),
+            win32: ({ appdata }) => joinPath(appdata, "Claude", "claude_desktop_config.json"),
+            default: ({ home }) => joinPath(home, ".config", "Claude", "claude_desktop_config.json"),
+        },
+    },
+    {
+        id: "claude-code",
+        label: "Claude Code",
+        format: "json",
+        pathBy: {
+            darwin: ({ home }) => joinPath(home, ".claude.json"),
+            linux: ({ home }) => joinPath(home, ".claude.json"),
+            win32: ({ home }) => joinPath(home, ".claude.json"),
+            default: ({ home }) => joinPath(home, ".claude.json"),
+        },
+    },
+    {
+        id: "cursor",
+        label: "Cursor",
+        format: "json",
+        pathBy: {
+            darwin: ({ home }) => joinPath(home, ".cursor", "mcp.json"),
+            linux: ({ home }) => joinPath(home, ".cursor", "mcp.json"),
+            win32: ({ home }) => joinPath(home, ".cursor", "mcp.json"),
+            default: ({ home }) => joinPath(home, ".cursor", "mcp.json"),
+        },
+    },
+    {
+        id: "vscode",
+        label: "VS Code",
+        format: "json",
+        pathBy: {
+            darwin: ({ home }) => joinPath(home, "Library", "Application Support", "Code", "User", "settings.json"),
+            linux: ({ home }) => joinPath(home, ".config", "Code", "User", "settings.json"),
+            win32: ({ appdata }) => joinPath(appdata, "Code", "User", "settings.json"),
+            default: ({ home }) => joinPath(home, ".config", "Code", "User", "settings.json"),
+        },
+    },
+    {
+        id: "cline",
+        label: "Cline",
+        format: "json",
+        pathBy: {
+            // Cline's canonical config path is not yet stable across releases;
+            // default to ~/.cline/config.json for now (overridable by hand).
+            darwin: ({ home }) => joinPath(home, ".cline", "config.json"),
+            linux: ({ home }) => joinPath(home, ".cline", "config.json"),
+            win32: ({ home }) => joinPath(home, ".cline", "config.json"),
+            default: ({ home }) => joinPath(home, ".cline", "config.json"),
+        },
+    },
+    {
+        id: "codex",
+        label: "Codex CLI",
+        format: "toml",
+        pathBy: {
+            darwin: ({ home }) => joinPath(home, ".codex", "config.toml"),
+            linux: ({ home }) => joinPath(home, ".codex", "config.toml"),
+            win32: ({ home }) => joinPath(home, ".codex", "config.toml"),
+            default: ({ home }) => joinPath(home, ".codex", "config.toml"),
+        },
+    },
+];
+function getAppdata(env, home) {
+    const a = env.env.APPDATA;
+    if (a && a.length > 0)
+        return a;
+    // Fallback for Windows when APPDATA is unset — matches the conventional
+    // location relative to USERPROFILE/homedir.
+    return joinPath(home, "AppData", "Roaming");
+}
+function pickPath(def, plat, ctx) {
+    if (plat === "darwin")
+        return def.pathBy.darwin(ctx);
+    if (plat === "linux")
+        return def.pathBy.linux(ctx);
+    if (plat === "win32")
+        return def.pathBy.win32(ctx);
+    return def.pathBy.default(ctx);
+}
+function isInstalled(env, configPath) {
+    if (env.existsSync(configPath))
+        return true;
+    // Treat "parent dir exists" as a soft signal the client is installed —
+    // configs are often created on first MCP wire-up rather than at install.
+    const parent = (() => {
+        // dirname from node:path doesn't handle mixed separators well; do a
+        // manual split that respects whichever separator the path uses.
+        const sep = configPath.includes("\\") ? "\\" : "/";
+        const idx = configPath.lastIndexOf(sep);
+        if (idx < 0)
+            return null;
+        return configPath.slice(0, idx);
+    })();
+    if (parent && env.existsSync(parent))
+        return true;
+    return false;
+}
+const REAL_ENV = {
+    platform: () => realPlatform(),
+    homedir: () => realHomedir(),
+    env: process.env,
+    existsSync: (p) => realExistsSync(p),
+};
+export async function detectClients(env = REAL_ENV) {
+    const plat = env.platform();
+    const home = env.homedir();
+    const ctx = { home, appdata: getAppdata(env, home) };
+    const out = CLIENT_DEFS.map((def) => {
+        const configPath = pickPath(def, plat, ctx);
+        return {
+            id: def.id,
+            label: def.label,
+            configPath,
+            format: def.format,
+            installed: isInstalled(env, configPath),
+        };
+    });
+    return out;
+}
+// Re-export the helper for use by other setup modules (write-config etc.).
+export { joinPath, dirname };
+//# sourceMappingURL=detect-clients.js.map

package/dist/setup/detect-clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-clients.js","sourceRoot":"","sources":["../../src/setup/detect-clients.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,EAAE;AACF,uEAAuE;AACvE,sEAAsE;AACtE,8DAA8D;AAC9D,EAAE;AACF,uEAAuE;AACvE,gEAAgE;AAEhE,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAQ,MAAM,WAAW,CAAC;AA+C1C,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAElE,gFAAgF;AAChF,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAG,KAAe;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,uEAAuE;IACvE,8CAA8C;IAC9C,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC;SACzB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;SACxC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnC,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAyB;IAC/C;QACE,EAAE,EAAE,gBAAgB;QACpB,KAAK,EAAE,gBAAgB;QACvB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE;YACN,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CACnB,QAAQ,CACN,IAAI,EACJ,SAAS,EACT,qBAAqB,EACrB,QAAQ,EACR,4BAA4B,CAC7B;YACH,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAClB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,4BAA4B,CAAC;YACnE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CACrB,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,4BAA4B,CAAC;YAC3D,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,4BAA4B,CAAC;SACpE;KACF;IACD;QACE,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,aAAa;QACpB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE;YACN,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;YACpD,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;YACnD,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;YACnD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;SACtD;KACF;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,MAAM;QACd,MAAM,EAAE;YACN,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC;YAC3D,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC;YAC1D,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC;YAC1D,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC;SAC7D;KACF;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE;YACN,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CACnB,QAAQ,CACN,IAAI,EACJ,SAAS,EACT,qBAAqB,EACrB,MAAM,EACN,MAAM,EACN,eAAe,CAChB;YACH,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAClB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC;YAC5D,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC;YACpD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC;SAC7D;KACF;IACD;QACE,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,MAAM;QACd,MAAM,EAAE;YACN,mEAAmE;YACnE,iEAAiE;YACjE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC;YAC7D,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC;YAC5D,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC;YAC5D,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC;SAC/D;KACF;IACD;QACE,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE;YACN,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC;YAC7D,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC;YAC5D,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC;YAC5D,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC;SAC/D;KACF;CACF,CAAC;AAEF,SAAS,UAAU,CAAC,GAAc,EAAE,IAAY;IAC9C,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC;IAC1B,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IAChC,wEAAwE;IACxE,4CAA4C;IAC5C,OAAO,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,QAAQ,CAAC,GAAc,EAAE,IAAqB,EAAE,GAAY;IACnE,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,WAAW,CAAC,GAAc,EAAE,UAAkB;IACrD,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,uEAAuE;IACvE,yEAAyE;IACzE,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;QACnB,oEAAoE;QACpE,gEAAgE;QAChE,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QACnD,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC,CAAC,EAAE,CAAC;IACL,IAAI,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,QAAQ,GAAc;IAC1B,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE;IAC9B,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;IAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,UAAU,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAiB,QAAQ;IAEzB,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAY,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;IAE9D,MAAM,GAAG,GAAqB,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACpD,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5C,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,UAAU;YACV,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,SAAS,EAAE,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC;SACxC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2EAA2E;AAC3E,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC"}

package/dist/setup/probe-handshake.d.ts

@@ -0,0 +1,26 @@
+import { Writable, Readable } from "node:stream";
+export interface ProbeSpawnedProc {
+    stdin: Writable;
+    stdout: Readable;
+    kill: (signal?: NodeJS.Signals) => void;
+    on: (event: "exit" | "error", cb: (...args: unknown[]) => void) => void;
+}
+export type ProbeSpawnFn = (command: string, args: string[], env: Record<string, string>) => ProbeSpawnedProc;
+export interface ProbeOptions {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+    spawn?: ProbeSpawnFn;
+    timeoutMs?: number;
+}
+export interface ProbeResult {
+    ok: boolean;
+    tools?: string[];
+    error?: string;
+}
+export declare function probeHandshake(opts: ProbeOptions): Promise<ProbeResult>;
+/**
+ * Roll back every undo handle in order. Errors are caught + ignored — the
+ * goal is to clean up as much as possible, not bail on the first failure.
+ */
+export declare function rollbackAll(undos: Array<() => Promise<void>>): Promise<void>;

package/dist/setup/probe-handshake.js

@@ -0,0 +1,159 @@
+// src/setup/probe-handshake.ts — Phase 6.4.
+//
+// Spawn the MCP server via stdio with the same command/args/env the
+// setup wizard just wrote to the client config, then perform a JSONRPC
+// handshake (initialize + tools/list) and verify that the apimapper_health
+// tool is registered. On failure, the caller invokes rollbackAll() to
+// undo the config writes from Phase 6.3.
+//
+// The subprocess is abstracted as a ProbeSpawnFn so the unit tests can
+// inject a deterministic fake. The default spawn (used in production)
+// shells out to node:child_process.spawn.
+import { spawn as realSpawn } from "node:child_process";
+const PROTOCOL_VERSION = "2024-11-05";
+const HEALTH_TOOL = "apimapper_health";
+const DEFAULT_TIMEOUT_MS = 10_000;
+function defaultSpawn(command, args, env) {
+    const child = realSpawn(command, args, {
+        env: { ...process.env, ...env },
+        stdio: ["pipe", "pipe", "pipe"],
+    });
+    return {
+        stdin: child.stdin,
+        stdout: child.stdout,
+        kill: (signal) => child.kill(signal),
+        on: (event, cb) => child.on(event, cb),
+    };
+}
+/**
+ * Drive a JSONRPC over stdio session with the spawned MCP. Sends
+ * `initialize` then `tools/list`, returns the tools array or rejects.
+ */
+async function runHandshake(proc, timeoutMs) {
+    const pending = new Map();
+    let nextId = 1;
+    let buf = "";
+    proc.stdout.on("data", (chunk) => {
+        buf += chunk.toString("utf8");
+        // Process newline-delimited JSON.
+        // (MCP stdio transport uses newline-delimited JSONRPC.)
+        let i;
+        while ((i = buf.indexOf("\n")) >= 0) {
+            const line = buf.slice(0, i).trim();
+            buf = buf.slice(i + 1);
+            if (line.length === 0)
+                continue;
+            let msg = null;
+            try {
+                const raw = JSON.parse(line);
+                if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+                    msg = raw;
+                }
+            }
+            catch {
+                continue;
+            }
+            if (msg && typeof msg.id === "number" && pending.has(msg.id)) {
+                const p = pending.get(msg.id);
+                pending.delete(msg.id);
+                if (msg.error) {
+                    p.reject(new Error(`JSONRPC error: ${JSON.stringify(msg.error)}`));
+                }
+                else {
+                    p.resolve(msg.result);
+                }
+            }
+        }
+    });
+    function send(method, params) {
+        const id = nextId++;
+        const message = { jsonrpc: "2.0", id, method, params };
+        return new Promise((resolve, reject) => {
+            pending.set(id, { resolve, reject });
+            proc.stdin.write(`${JSON.stringify(message)}\n`);
+        });
+    }
+    // Wrap the whole handshake in a deadline.
+    const deadline = new Promise((_, reject) => {
+        setTimeout(() => reject(new Error("Handshake timed out")), timeoutMs);
+    });
+    const handshake = (async () => {
+        // 1. initialize
+        await Promise.race([
+            send("initialize", {
+                protocolVersion: PROTOCOL_VERSION,
+                capabilities: {},
+                clientInfo: { name: "apimapper-mcp-setup", version: "0.1.0" },
+            }),
+            deadline,
+        ]);
+        // 2. tools/list
+        const result = (await Promise.race([
+            send("tools/list", {}),
+            deadline,
+        ]));
+        if (!result || !Array.isArray(result.tools)) {
+            throw new Error("tools/list returned no tools array");
+        }
+        const names = result.tools
+            .map((t) => (typeof t?.name === "string" ? t.name : null))
+            .filter((n) => n !== null);
+        return names;
+    })();
+    return handshake;
+}
+export async function probeHandshake(opts) {
+    const spawnFn = opts.spawn ?? defaultSpawn;
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const env = opts.env ?? {};
+    let proc;
+    try {
+        proc = spawnFn(opts.command, opts.args, env);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: `Failed to spawn MCP process: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    try {
+        const tools = await runHandshake(proc, timeoutMs);
+        if (!tools.includes(HEALTH_TOOL)) {
+            return {
+                ok: false,
+                tools,
+                error: `Tools list missing ${HEALTH_TOOL} (got: ${tools.join(", ") || "<empty>"})`,
+            };
+        }
+        return { ok: true, tools };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    finally {
+        try {
+            proc.kill();
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+}
+/**
+ * Roll back every undo handle in order. Errors are caught + ignored — the
+ * goal is to clean up as much as possible, not bail on the first failure.
+ */
+export async function rollbackAll(undos) {
+    for (const undo of undos) {
+        try {
+            await undo();
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+}
+//# sourceMappingURL=probe-handshake.js.map

package/dist/setup/probe-handshake.js.map

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

package/dist/setup/write-config.d.ts

@@ -0,0 +1,25 @@
+export declare const MANAGED_MARKER = "x-managed-by";
+export declare const MANAGED_VALUE = "@wootsup/mcp";
+export declare const TOML_MANAGED_COMMENT = "# @apimapper-managed";
+export interface McpEntry {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+}
+export interface WriteConfigResult {
+    /** True iff we actually added or updated our entry. */
+    added: boolean;
+    /**
+     * True iff an existing managed entry of the same key was found (and
+     * updated). False when the key was missing OR when an unmanaged entry
+     * blocked the write.
+     */
+    alreadyManaged: boolean;
+    /**
+     * Roll back the write — restore the file to its pre-write content.
+     * Safe to call even when `added=false`.
+     */
+    undo: () => Promise<void>;
+}
+export declare function writeJsonConfig(path: string, key: string, entry: McpEntry): Promise<WriteConfigResult>;
+export declare function writeTomlConfig(path: string, key: string, entry: McpEntry): Promise<WriteConfigResult>;