@yumdee/mcp-studio-inspector 0.1.0

package/LICENSE

@@ -0,0 +1,23 @@
+# License
+
+MIT License
+
+Copyright (c) 2024 yumdee-Mcp-studio Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# @yumdee/mcp-studio-inspector
+
+> 🔍 **Open-source Web UI Debugger, Session Replayer, and AI Diagnostic Copilot for the Model Context Protocol (MCP)**
+
+[![npm version](https://img.shields.io/npm/v/@yumdee/mcp-studio-inspector.svg)](https://www.npmjs.com/package/@yumdee/mcp-studio-inspector)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)
+
+Inspect, test, and debug any MCP server (Stdio, SSE, HTTP) with zero configuration. Includes dynamic schema-driven form runners, live latency timelines, regression replays, and an **AI Root-Cause Diagnostic Copilot**.
+
+---
+
+## ⚡ Quickstart (Zero Install)
+
+Run directly in any terminal:
+
+```bash
+npx @yumdee/mcp-studio-inspector
+```
+
+Or specify a custom port:
+
+```bash
+npx @yumdee/mcp-studio-inspector --port 4000
+```
+
+Then open **`http://localhost:3000`** in your browser!
+
+---
+
+## ✨ Features
+
+- **🌐 Multi-Transport Support**: Connect instantly via `stdio` subprocesses or `http`/`sse` endpoints.
+- **⚡ 1-Click Internet Presets**: Preloaded test buttons for official MCP servers:
+  - `@modelcontextprotocol/server-everything`
+  - `@modelcontextprotocol/server-filesystem`
+  - `@modelcontextprotocol/server-memory`
+- **🩺 AI Root-Cause Diagnostic Copilot**: Automatically diagnoses failed tool invocations, classifies boundary errors, and provides one-click **"Apply to Runner"** parameter auto-fixes.
+- **📜 Live SSE Timeline**: Real-time server-sent event feed with round-trip latency metrics and JSON inspector.
+- **🔁 Session Recording & Regression Replay**: Record testing workflows and diff outputs against past runs.
+- **🎨 Warm Minimalist Design System**: Editorial aesthetic built with Fraunces serif and Plus Jakarta Sans typography, featuring dynamic light and dark theme switching.
+
+---
+
+## 💻 CLI Usage
+
+```bash
+# Start inspector with default settings (port 3000)
+npx @yumdee/mcp-studio-inspector
+
+# Start on custom port
+npx @yumdee/mcp-studio-inspector --port 8080
+```
+
+---
+
+## 📦 Programmatic Usage
+
+You can also mount the Inspector server or React UI programmatically in your own Node.js or Vite projects:
+
+```typescript
+import { createInspector } from "@yumdee/mcp-studio-inspector";
+
+const inspector = createInspector({ port: 3000 });
+await inspector.start();
+console.log("Inspector running on port 3000");
+```
+
+---
+
+## 📄 License
+
+MIT © [Mahesh Singh](https://github.com/maheshsingh20) & YumDee Community
+

package/dist/__tests__/diagnose.test.d.ts

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

package/dist/__tests__/diagnose.test.d.ts.map

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

package/dist/__tests__/diagnose.test.js

@@ -0,0 +1,102 @@
+import { describe, it, expect, afterAll, beforeAll } from "vitest";
+import { diagnoseToolFailure, createInspector } from "../server.js";
+describe("AI Diagnostic Engine", () => {
+    const calcSchema = {
+        type: "object",
+        properties: {
+            operation: {
+                type: "string",
+                enum: ["add", "subtract", "multiply", "divide"],
+                description: "Arithmetic operation",
+            },
+            a: { type: "number", description: "First operand" },
+            b: { type: "number", description: "Second operand" },
+        },
+        required: ["operation", "a", "b"],
+    };
+    it("diagnoses missing required arguments and provides corrected payload", () => {
+        const result = diagnoseToolFailure({
+            toolName: "calculate",
+            schema: calcSchema,
+            arguments: { operation: "add", a: 15 },
+            error: "Invalid parameters: missing b",
+        });
+        expect(result.category).toBe("MISSING_REQUIRED_ARGUMENT");
+        expect(result.rootCause).toContain("requires parameter(s)");
+        expect(result.suggestedFix).toContain("b");
+        expect(result.correctedArgs).toBeDefined();
+        expect(result.correctedArgs.b).toBe(5);
+        expect(result.confidence).toBeGreaterThanOrEqual(0.95);
+    });
+    it("diagnoses arithmetic boundary errors (division by zero)", () => {
+        const result = diagnoseToolFailure({
+            toolName: "calculate",
+            schema: calcSchema,
+            arguments: { operation: "divide", a: 100, b: 0 },
+            error: "Division by zero is undefined",
+        });
+        expect(result.category).toBe("ARITHMETIC_BOUNDARY");
+        expect(result.rootCause).toContain("division by zero");
+        expect(result.suggestedFix).toContain("non-zero");
+        expect(result.correctedArgs.b).toBe(2);
+        expect(result.confidence).toBeGreaterThanOrEqual(0.98);
+    });
+    it("diagnoses type mismatches (string instead of number)", () => {
+        const result = diagnoseToolFailure({
+            toolName: "calculate",
+            schema: calcSchema,
+            arguments: { operation: "add", a: "42", b: 10 },
+            error: "Expected number for a, received string",
+        });
+        expect(result.category).toBe("TYPE_MISMATCH");
+        expect(result.rootCause).toContain("expects a numeric literal");
+        expect(result.correctedArgs.a).toBe(42);
+        expect(result.confidence).toBeGreaterThanOrEqual(0.95);
+    });
+    it("diagnoses invalid enum choices", () => {
+        const result = diagnoseToolFailure({
+            toolName: "calculate",
+            schema: calcSchema,
+            arguments: { operation: "modulo", a: 10, b: 3 },
+            error: "Unsupported operation modulo",
+        });
+        expect(result.category).toBe("INVALID_ENUM");
+        expect(result.rootCause).toContain("is not allowed");
+        expect(result.suggestedFix).toContain("add");
+        expect(result.correctedArgs.operation).toBe("add");
+        expect(result.confidence).toBeGreaterThanOrEqual(0.95);
+    });
+});
+describe("Inspector /api/diagnose endpoint", () => {
+    let inspector;
+    const testPort = 3199;
+    beforeAll(async () => {
+        inspector = createInspector({ port: testPort, host: "localhost" });
+        await inspector.start();
+    });
+    afterAll(async () => {
+        await inspector.stop();
+    });
+    it("handles POST /api/diagnose via HTTP", async () => {
+        const res = await fetch(`http://localhost:${testPort}/api/diagnose`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                toolName: "calculate",
+                schema: {
+                    type: "object",
+                    properties: { a: { type: "number" }, b: { type: "number" } },
+                    required: ["a", "b"],
+                },
+                arguments: { a: 10 },
+                error: "Missing required argument 'b'",
+            }),
+        });
+        expect(res.status).toBe(200);
+        const data = await res.json();
+        expect(data.success).toBe(true);
+        expect(data.category).toBe("MISSING_REQUIRED_ARGUMENT");
+        expect(data.correctedArgs.b).toBeDefined();
+    });
+});
+//# sourceMappingURL=diagnose.test.js.map

package/dist/__tests__/diagnose.test.js.map

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

package/dist/__tests__/inspector.test.d.ts

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

package/dist/__tests__/inspector.test.d.ts.map

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

package/dist/__tests__/inspector.test.js

@@ -0,0 +1,65 @@
+import { describe, it, expect, beforeAll, afterAll } from "vitest";
+import { createInspector } from "../server.js";
+import { InMemoryStorage } from "@yumdee/mcp-studio-core";
+import * as path from "path";
+describe("Inspector Server API", () => {
+    let inspector;
+    const port = 3899;
+    const baseUrl = `http://localhost:${port}`;
+    const serverPath = path.resolve(__dirname, "../../../../examples/math-server/dist/index.js");
+    beforeAll(async () => {
+        inspector = createInspector({
+            port,
+            storage: new InMemoryStorage(),
+        });
+        await inspector.start();
+    });
+    afterAll(async () => {
+        await inspector.stop();
+    });
+    it("should respond to health check", async () => {
+        const res = await fetch(baseUrl);
+        const data = await res.json();
+        expect(data.status).toBe("running");
+    });
+    it("should connect to math-server and return tools", async () => {
+        const connectRes = await fetch(`${baseUrl}/api/servers/connect`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                transport: "stdio",
+                command: "node",
+                args: [serverPath],
+            }),
+        });
+        const connectData = await connectRes.json();
+        expect(connectRes.status).toBe(200);
+        expect(connectData.serverInfo.name).toBe("math-server");
+        expect(connectData.tools.length).toBeGreaterThan(0);
+        const sessionId = connectData.sessionId;
+        // Test invoking a tool
+        const invokeRes = await fetch(`${baseUrl}/api/servers/${sessionId}/invoke`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                toolName: "multiply",
+                args: { a: 6, b: 7 },
+            }),
+        });
+        const invokeData = await invokeRes.json();
+        expect(invokeData.success).toBe(true);
+        expect(invokeData.result.content[0].text).toContain("42");
+        expect(invokeData.latencyMs).toBeGreaterThanOrEqual(0);
+        // Test save session
+        const saveRes = await fetch(`${baseUrl}/api/sessions/save`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ sessionId }),
+        });
+        const saveData = await saveRes.json();
+        expect(saveData.success).toBe(true);
+        // Disconnect
+        await fetch(`${baseUrl}/api/servers/${sessionId}/disconnect`, { method: "POST" });
+    });
+});
+//# sourceMappingURL=inspector.test.js.map

package/dist/__tests__/inspector.test.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * MCP Studio Inspector CLI
+ *
+ * Entry point: npx mcp-studio-inspect
+ *
+ * Usage:
+ *   mcp-studio-inspect                    # Start inspector at localhost:3000
+ *   mcp-studio-inspect --port 4000        # Start at custom port
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * MCP Studio Inspector CLI
+ *
+ * Entry point: npx mcp-studio-inspect
+ *
+ * Usage:
+ *   mcp-studio-inspect                    # Start inspector at localhost:3000
+ *   mcp-studio-inspect --port 4000        # Start at custom port
+ */
+import * as path from "path";
+import { fileURLToPath } from "url";
+import { createInspector } from "./server.js";
+async function main() {
+    const args = process.argv.slice(2);
+    let port = 3000;
+    const portFlagIdx = args.indexOf("--port");
+    if (portFlagIdx !== -1 && args[portFlagIdx + 1]) {
+        port = parseInt(args[portFlagIdx + 1], 10) || 3000;
+    }
+    else {
+        const eqMatch = args.find((a) => a.startsWith("--port="));
+        if (eqMatch) {
+            port = parseInt(eqMatch.split("=")[1], 10) || 3000;
+        }
+    }
+    let staticDir;
+    try {
+        const currentDir = path.dirname(fileURLToPath(import.meta.url));
+        staticDir = path.resolve(currentDir, "../dist/ui");
+    }
+    catch { }
+    const inspector = createInspector({ port, staticDir });
+    try {
+        await inspector.start();
+        console.log(`\n🔍 MCP Studio Inspector running at http://localhost:${port}`);
+        console.log("   Open in your browser to debug and replay MCP servers.\n");
+        process.on("SIGINT", async () => {
+            console.log("\n✋ Shutting down inspector server...");
+            await inspector.stop();
+            process.exit(0);
+        });
+    }
+    catch (err) {
+        console.error("Failed to start inspector:", err);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,GAAG,IAAI,CAAC;IAEhB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,WAAW,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC;QAChD,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;QAC1D,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;QACrD,CAAC;IACH,CAAC;IAED,IAAI,SAA6B,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,MAAM,SAAS,GAAG,eAAe,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAEvD,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,yDAAyD,IAAI,EAAE,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;QAE1E,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC9B,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;YACrD,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/diagnostics.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @yumdee/mcp-studio-inspector - AI Diagnostic Engine
+ *
+ * Automated Root-Cause Analysis (RCA) and patch synthesis for failed MCP tool executions.
+ * Classifies runtime errors, schema boundary violations, and missing parameters.
+ */
+export type DiagnosticCategory = "MISSING_REQUIRED_ARGUMENT" | "TYPE_MISMATCH" | "ARITHMETIC_BOUNDARY" | "INVALID_ENUM" | "INVALID_JSON" | "SERVER_RUNTIME_ERROR";
+export interface DiagnosticRequest {
+    toolName?: string;
+    schema?: any;
+    arguments?: any;
+    error?: string;
+    logs?: string;
+}
+export interface DiagnosticResult {
+    rootCause: string;
+    category: DiagnosticCategory;
+    suggestedFix: string;
+    correctedArgs?: any;
+    confidence: number;
+}
+export declare function diagnoseToolFailure(req: DiagnosticRequest): DiagnosticResult;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,kBAAkB,GAC1B,2BAA2B,GAC3B,eAAe,GACf,qBAAqB,GACrB,cAAc,GACd,cAAc,GACd,sBAAsB,CAAC;AAE3B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,iBAAiB,GAAG,gBAAgB,CAiH5E"}

package/dist/diagnostics.js

@@ -0,0 +1,114 @@
+/**
+ * @yumdee/mcp-studio-inspector - AI Diagnostic Engine
+ *
+ * Automated Root-Cause Analysis (RCA) and patch synthesis for failed MCP tool executions.
+ * Classifies runtime errors, schema boundary violations, and missing parameters.
+ */
+export function diagnoseToolFailure(req) {
+    const { toolName, schema, error = "" } = req;
+    const args = typeof req.arguments === "object" && req.arguments !== null ? { ...req.arguments } : {};
+    const errorLower = error.toLowerCase();
+    // 1. Check for Arithmetic / Mathematical Boundary Violations (e.g. division by zero)
+    if (errorLower.includes("divide by zero") ||
+        errorLower.includes("division by zero") ||
+        (args.operation === "divide" && (args.b === 0 || args.b === "0"))) {
+        return {
+            category: "ARITHMETIC_BOUNDARY",
+            rootCause: "Attempted division by zero, which is mathematically undefined and caused the calculator to reject the call.",
+            suggestedFix: "Change the denominator parameter 'b' to a non-zero numeric value (e.g. 1 or 2).",
+            correctedArgs: { ...args, b: 2 },
+            confidence: 0.99,
+        };
+    }
+    // 2. Check Schema Required Fields
+    if (schema && typeof schema === "object") {
+        const required = Array.isArray(schema.required) ? schema.required : [];
+        const missing = required.filter((key) => args[key] === undefined || args[key] === null || args[key] === "");
+        if (missing.length > 0) {
+            const firstMissing = missing[0];
+            const prop = schema.properties?.[firstMissing] || {};
+            const expectedType = prop.type || "string";
+            let sampleVal = "example";
+            if (expectedType === "number" || expectedType === "integer")
+                sampleVal = 10;
+            else if (expectedType === "boolean")
+                sampleVal = true;
+            else if (expectedType === "array")
+                sampleVal = [];
+            else if (expectedType === "object")
+                sampleVal = {};
+            const corrected = { ...args };
+            for (const m of missing) {
+                const mType = schema.properties?.[m]?.type || "string";
+                corrected[m] = mType === "number" ? 5 : mType === "boolean" ? true : "example";
+            }
+            return {
+                category: "MISSING_REQUIRED_ARGUMENT",
+                rootCause: `The tool '${toolName || "invoked"}' requires parameter(s) [${missing.join(", ")}], but '${firstMissing}' was omitted from the payload.`,
+                suggestedFix: `Add '${firstMissing}' (${expectedType}) to the arguments payload.`,
+                correctedArgs: corrected,
+                confidence: 0.98,
+            };
+        }
+        // 3. Check for Type Mismatches
+        if (schema.properties && typeof schema.properties === "object") {
+            for (const [key, prop] of Object.entries(schema.properties)) {
+                if (args[key] !== undefined && prop?.type) {
+                    const val = args[key];
+                    if (prop.type === "number" && typeof val === "string") {
+                        const parsed = Number(val);
+                        if (!isNaN(parsed)) {
+                            return {
+                                category: "TYPE_MISMATCH",
+                                rootCause: `Parameter '${key}' was provided as a string ("${val}"), but the schema expects a numeric literal.`,
+                                suggestedFix: `Convert '${key}' to a raw number without quotation marks.`,
+                                correctedArgs: { ...args, [key]: parsed },
+                                confidence: 0.96,
+                            };
+                        }
+                    }
+                    else if (prop.type === "string" && typeof val === "number") {
+                        return {
+                            category: "TYPE_MISMATCH",
+                            rootCause: `Parameter '${key}' was provided as a number (${val}), but the schema expects a string.`,
+                            suggestedFix: `Enclose '${key}' in double quotation marks as a string literal.`,
+                            correctedArgs: { ...args, [key]: String(val) },
+                            confidence: 0.95,
+                        };
+                    }
+                    // 4. Check for Enum Violations
+                    if (Array.isArray(prop.enum) && prop.enum.length > 0) {
+                        if (!prop.enum.includes(val)) {
+                            return {
+                                category: "INVALID_ENUM",
+                                rootCause: `Parameter '${key}' value "${val}" is not allowed. Valid options are: [${prop.enum.join(", ")}].`,
+                                suggestedFix: `Change '${key}' to one of the accepted enum choices: ${prop.enum.join(", ")}.`,
+                                correctedArgs: { ...args, [key]: prop.enum[0] },
+                                confidence: 0.97,
+                            };
+                        }
+                    }
+                }
+            }
+        }
+    }
+    // 5. Check for JSON syntax or parsing failure
+    if (errorLower.includes("json") || errorLower.includes("syntax") || errorLower.includes("parse")) {
+        return {
+            category: "INVALID_JSON",
+            rootCause: "The arguments payload contains malformed JSON syntax.",
+            suggestedFix: "Verify that all keys and strings are enclosed in double quotes and commas are properly positioned.",
+            correctedArgs: args,
+            confidence: 0.92,
+        };
+    }
+    // 6. Generic Server Runtime Error
+    return {
+        category: "SERVER_RUNTIME_ERROR",
+        rootCause: error || `Tool '${toolName || "unknown"}' failed execution with an unhandled exception.`,
+        suggestedFix: "Inspect the server standard error (stderr) logs and confirm underlying services or database connections are active.",
+        correctedArgs: args,
+        confidence: 0.82,
+    };
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @yumdee/mcp-studio-inspector
+ *
+ * Web UI debugger for MCP servers with session recording and replay.
+ *
+ * Exports:
+ * - Inspector class - main server
+ * - createInspector() - factory function
+ * - InspectorConfig - configuration interface
+ */
+export { Inspector, createInspector, type InspectorConfig } from "./server.js";
+export { InspectorUI, type InspectorUIProps } from "./ui.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @yumdee/mcp-studio-inspector
+ *
+ * Web UI debugger for MCP servers with session recording and replay.
+ *
+ * Exports:
+ * - Inspector class - main server
+ * - createInspector() - factory function
+ * - InspectorConfig - configuration interface
+ */
+export { Inspector, createInspector } from "./server.js";
+export { InspectorUI } from "./ui.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAyB,MAAM,SAAS,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,33 @@
+/**
+ * MCP Studio Inspector - Web UI & API Server
+ *
+ * Runs a local HTTP server with REST APIs and SSE streaming for live server inspection,
+ * tool invocation, session recording, and session replay.
+ */
+import { SessionStorage } from "@yumdee/mcp-studio-core";
+import { diagnoseToolFailure, DiagnosticRequest, DiagnosticResult, DiagnosticCategory } from "./diagnostics.js";
+export { diagnoseToolFailure, DiagnosticRequest, DiagnosticResult, DiagnosticCategory, };
+export interface InspectorConfig {
+    port: number;
+    host?: string;
+    storage?: SessionStorage;
+    staticDir?: string;
+}
+export declare class Inspector {
+    private port;
+    private host;
+    private storage;
+    private staticDir?;
+    private server?;
+    private activeClients;
+    private sseClients;
+    constructor(config: InspectorConfig);
+    private setCorsHeaders;
+    private sendJson;
+    private broadcastEvent;
+    private parseBody;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+export declare function createInspector(config: InspectorConfig): Inspector;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAEL,cAAc,EAMf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAc;IAC7B,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,UAAU,CAAuC;gBAE7C,MAAM,EAAE,eAAe;IAOnC,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,cAAc;YAWR,SAAS;IAiBjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuRtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAmB5B;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAElE"}