apcore-mcp 0.3.0 → 0.5.0

package/dist/adapters/annotations.d.ts

@@ -21,10 +21,14 @@ export declare class AnnotationMapper {
     /**
      * Generate a description suffix string from annotations.
      *
+     * Only includes annotation fields that differ from their default values:
+     *   readonly=false, destructive=false, idempotent=false,
+     *   requires_approval=false, open_world=true
+     *
      * Returns a formatted string like:
-     *   `\n\n[Annotations: readonly=true, destructive=false, ...]`
+     *   `\n\n[Annotations: readonly=true, idempotent=true]`
      *
-     * Returns an empty string if annotations are null.
+     * Returns an empty string if annotations are null or all fields are defaults.
      */
     toDescriptionSuffix(annotations: ModuleAnnotations | null): string;
     /**

package/dist/adapters/annotations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/adapters/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEzE,qBAAa,gBAAgB;IAC3B;;;;;;;;;OASG;IACH,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,GAAG,kBAAkB;IAoB3E;;;;;;;OAOG;IACH,mBAAmB,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,GAAG,MAAM;IAgBlE;;;;OAIG;IACH,mBAAmB,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO;CAOpE"}
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/adapters/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEzE,qBAAa,gBAAgB;IAC3B;;;;;;;;;OASG;IACH,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,GAAG,kBAAkB;IAoB3E;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,GAAG,MAAM;IAgClE;;;;OAIG;IACH,mBAAmB,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO;CAOpE"}

package/dist/adapters/annotations.js

@@ -37,22 +37,40 @@ export class AnnotationMapper {
     /**
      * Generate a description suffix string from annotations.
      *
+     * Only includes annotation fields that differ from their default values:
+     *   readonly=false, destructive=false, idempotent=false,
+     *   requires_approval=false, open_world=true
+     *
      * Returns a formatted string like:
-     *   `\n\n[Annotations: readonly=true, destructive=false, ...]`
+     *   `\n\n[Annotations: readonly=true, idempotent=true]`
      *
-     * Returns an empty string if annotations are null.
+     * Returns an empty string if annotations are null or all fields are defaults.
      */
     toDescriptionSuffix(annotations) {
         if (annotations === null) {
             return "";
         }
-        const parts = [
-            `readonly=${annotations.readonly}`,
-            `destructive=${annotations.destructive}`,
-            `idempotent=${annotations.idempotent}`,
-            `requires_approval=${annotations.requiresApproval}`,
-            `open_world=${annotations.openWorld}`,
-        ];
+        const DEFAULTS = {
+            readonly: false,
+            destructive: false,
+            idempotent: false,
+            requires_approval: false,
+            open_world: true,
+        };
+        const parts = [];
+        if (annotations.readonly !== DEFAULTS.readonly)
+            parts.push(`readonly=${annotations.readonly}`);
+        if (annotations.destructive !== DEFAULTS.destructive)
+            parts.push(`destructive=${annotations.destructive}`);
+        if (annotations.idempotent !== DEFAULTS.idempotent)
+            parts.push(`idempotent=${annotations.idempotent}`);
+        if (annotations.requiresApproval !== DEFAULTS.requires_approval)
+            parts.push(`requires_approval=${annotations.requiresApproval}`);
+        if (annotations.openWorld !== DEFAULTS.open_world)
+            parts.push(`open_world=${annotations.openWorld}`);
+        if (parts.length === 0) {
+            return "";
+        }
         return `\n\n[Annotations: ${parts.join(", ")}]`;
     }
     /**

package/dist/adapters/annotations.js.map

@@ -1 +1 @@
-{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../src/adapters/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,OAAO,gBAAgB;IAC3B;;;;;;;;;OASG;IACH,gBAAgB,CAAC,WAAqC;QACpD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO;gBACL,YAAY,EAAE,KAAK;gBACnB,eAAe,EAAE,KAAK;gBACtB,cAAc,EAAE,KAAK;gBACrB,aAAa,EAAE,IAAI;gBACnB,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;QAED,OAAO;YACL,YAAY,EAAE,WAAW,CAAC,QAAQ;YAClC,eAAe,EAAE,WAAW,CAAC,WAAW;YACxC,cAAc,EAAE,WAAW,CAAC,UAAU;YACtC,aAAa,EAAE,WAAW,CAAC,SAAS;YACpC,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,mBAAmB,CAAC,WAAqC;QACvD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,KAAK,GAAa;YACtB,YAAY,WAAW,CAAC,QAAQ,EAAE;YAClC,eAAe,WAAW,CAAC,WAAW,EAAE;YACxC,cAAc,WAAW,CAAC,UAAU,EAAE;YACtC,qBAAqB,WAAW,CAAC,gBAAgB,EAAE;YACnD,cAAc,WAAW,CAAC,SAAS,EAAE;SACtC,CAAC;QAEF,OAAO,qBAAqB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CAAC,WAAqC;QACvD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,WAAW,CAAC,gBAAgB,CAAC;IACtC,CAAC;CACF"}
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../src/adapters/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,OAAO,gBAAgB;IAC3B;;;;;;;;;OASG;IACH,gBAAgB,CAAC,WAAqC;QACpD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO;gBACL,YAAY,EAAE,KAAK;gBACnB,eAAe,EAAE,KAAK;gBACtB,cAAc,EAAE,KAAK;gBACrB,aAAa,EAAE,IAAI;gBACnB,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;QAED,OAAO;YACL,YAAY,EAAE,WAAW,CAAC,QAAQ;YAClC,eAAe,EAAE,WAAW,CAAC,WAAW;YACxC,cAAc,EAAE,WAAW,CAAC,UAAU;YACtC,aAAa,EAAE,WAAW,CAAC,SAAS;YACpC,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,WAAqC;QACvD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,QAAQ,GAA4B;YACxC,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,KAAK;YAClB,UAAU,EAAE,KAAK;YACjB,iBAAiB,EAAE,KAAK;YACxB,UAAU,EAAE,IAAI;SACjB,CAAC;QAEF,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,WAAW,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;YAC5C,KAAK,CAAC,IAAI,CAAC,YAAY,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjD,IAAI,WAAW,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW;YAClD,KAAK,CAAC,IAAI,CAAC,eAAe,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;QACvD,IAAI,WAAW,CAAC,UAAU,KAAK,QAAQ,CAAC,UAAU;YAChD,KAAK,CAAC,IAAI,CAAC,cAAc,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC;QACrD,IAAI,WAAW,CAAC,gBAAgB,KAAK,QAAQ,CAAC,iBAAiB;YAC7D,KAAK,CAAC,IAAI,CAAC,qBAAqB,WAAW,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAClE,IAAI,WAAW,CAAC,SAAS,KAAK,QAAQ,CAAC,UAAU;YAC/C,KAAK,CAAC,IAAI,CAAC,cAAc,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;QAEpD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,qBAAqB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CAAC,WAAqC;QACvD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,WAAW,CAAC,gBAAgB,CAAC;IACtC,CAAC;CACF"}

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAiCH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAmG1C"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAoCH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAkH1C"}

package/dist/cli.js

@@ -28,6 +28,9 @@ Options:
   --name <string>            MCP server name (default: apcore-mcp, max 255 chars)
   --version <string>         MCP server version (default: package version)
   --log-level <level>        Logging level: DEBUG, INFO, WARNING, ERROR (default: INFO)
+  --explorer                 Enable the browser-based Tool Explorer UI (HTTP only)
+  --explorer-prefix <path>   URL prefix for the explorer UI (default: /explorer)
+  --allow-execute            Allow tool execution from the explorer UI
   --help                     Show this help message
 `);
 }
@@ -47,6 +50,9 @@ export async function main() {
                 name: { type: "string", default: "apcore-mcp" },
                 version: { type: "string" },
                 "log-level": { type: "string", default: "INFO" },
+                explorer: { type: "boolean", default: false },
+                "explorer-prefix": { type: "string", default: "/explorer" },
+                "allow-execute": { type: "boolean", default: false },
                 help: { type: "boolean", default: false },
             },
             strict: true,
@@ -93,22 +99,27 @@ export async function main() {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     let Registry;
     try {
-        // @ts-expect-error - apcore is a peer dependency, not available at compile time
-        const apcore = await import("apcore");
+        const apcore = await import("apcore-js");
         Registry = apcore.Registry;
     }
     catch {
-        fail("Failed to import 'apcore' package. Install it with: npm install apcore");
+        fail("Failed to import 'apcore-js' package. Install it with: npm install apcore-js");
     }
     // Create Registry and discover modules
-    const registry = new Registry({ extensions_dir: resolvedDir });
-    const numModules = registry.discover();
+    const registry = new Registry({ extensionsDir: resolvedDir });
+    const numModules = await registry.discover();
     if (numModules === 0) {
         console.warn(`Warning: No modules discovered in '${extensionsDir}'.`);
     }
     else {
         console.info(`Discovered ${numModules} module(s) in '${extensionsDir}'.`);
     }
+    // Validate log-level
+    const logLevel = values["log-level"];
+    const validLogLevels = ["DEBUG", "INFO", "WARNING", "ERROR"];
+    if (logLevel && !validLogLevels.includes(logLevel)) {
+        fail(`--log-level must be one of: ${validLogLevels.join(", ")}. Got '${logLevel}'.`);
+    }
     // Launch the MCP server
     try {
         await serve(registry, {
@@ -117,6 +128,10 @@ export async function main() {
             port,
             name,
             version: values.version ?? undefined,
+            logLevel: logLevel,
+            explorer: values.explorer,
+            explorerPrefix: values["explorer-prefix"],
+            allowExecute: values["allow-execute"],
         });
     }
     catch (error) {

package/dist/cli.js.map

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

package/dist/explorer/handler.d.ts

@@ -0,0 +1,55 @@
+/**
+ * ExplorerHandler - HTTP route handler for the MCP Tool Explorer.
+ *
+ * Provides a browser-based UI for inspecting and testing MCP tools.
+ * Handles explorer-prefixed HTTP routes within the existing HTTP server.
+ *
+ * Routes:
+ * - GET  {prefix}/         → HTML explorer page
+ * - GET  {prefix}/tools    → JSON array of tool summaries
+ * - GET  {prefix}/tools/{name}      → JSON tool detail
+ * - POST {prefix}/tools/{name}/call → Execute tool (403 if disabled)
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { ExecutionRouter } from "../server/router.js";
+/** Options for creating an ExplorerHandler. */
+export interface ExplorerHandlerOptions {
+    /** Whether to allow tool execution from the explorer UI. Default: false */
+    allowExecute?: boolean;
+    /** URL prefix for the explorer. Default: "/explorer" */
+    prefix?: string;
+}
+export declare class ExplorerHandler {
+    private readonly _toolsByName;
+    private readonly _tools;
+    private readonly _router;
+    private readonly _allowExecute;
+    private readonly _prefix;
+    constructor(tools: Tool[], router: ExecutionRouter, options?: ExplorerHandlerOptions);
+    /** The URL prefix this handler is mounted at. */
+    get prefix(): string;
+    /**
+     * Attempt to handle an HTTP request.
+     *
+     * @returns true if the request was handled, false if it should be passed through
+     */
+    handleRequest(req: IncomingMessage, res: ServerResponse, url: URL): Promise<boolean>;
+    /**
+     * Build a summary dict for a tool (used in the list endpoint).
+     */
+    private _toolSummary;
+    /**
+     * Build a full detail dict for a tool (used in the detail endpoint).
+     */
+    private _toolDetail;
+    /**
+     * Handle GET {prefix}/tools/{name} - return tool detail or 404.
+     */
+    private _handleToolDetail;
+    /**
+     * Handle POST {prefix}/tools/{name}/call - execute tool or return 403/404.
+     */
+    private _handleCallTool;
+}
+//# sourceMappingURL=handler.d.ts.map

package/dist/explorer/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/explorer/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI3D,+CAA+C;AAC/C,MAAM,WAAW,sBAAsB;IACrC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAKD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAG/B,KAAK,EAAE,IAAI,EAAE,EACb,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,sBAAsB;IASlC,iDAAiD;IACjD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;OAIG;IACG,aAAa,CACjB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,OAAO,CAAC;IA6CnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;YACW,eAAe;CAqE9B"}

package/dist/explorer/handler.js

@@ -0,0 +1,175 @@
+/**
+ * ExplorerHandler - HTTP route handler for the MCP Tool Explorer.
+ *
+ * Provides a browser-based UI for inspecting and testing MCP tools.
+ * Handles explorer-prefixed HTTP routes within the existing HTTP server.
+ *
+ * Routes:
+ * - GET  {prefix}/         → HTML explorer page
+ * - GET  {prefix}/tools    → JSON array of tool summaries
+ * - GET  {prefix}/tools/{name}      → JSON tool detail
+ * - POST {prefix}/tools/{name}/call → Execute tool (403 if disabled)
+ */
+import { readBody } from "../server/transport.js";
+import { EXPLORER_HTML } from "./html.js";
+/** Maximum request body size for explorer call endpoint (1MB). */
+const EXPLORER_MAX_BODY_BYTES = 1024 * 1024;
+export class ExplorerHandler {
+    _toolsByName;
+    _tools;
+    _router;
+    _allowExecute;
+    _prefix;
+    constructor(tools, router, options) {
+        this._tools = tools;
+        this._router = router;
+        this._allowExecute = options?.allowExecute ?? false;
+        this._prefix = options?.prefix ?? "/explorer";
+        this._toolsByName = new Map(tools.map((t) => [t.name, t]));
+    }
+    /** The URL prefix this handler is mounted at. */
+    get prefix() {
+        return this._prefix;
+    }
+    /**
+     * Attempt to handle an HTTP request.
+     *
+     * @returns true if the request was handled, false if it should be passed through
+     */
+    async handleRequest(req, res, url) {
+        const pathname = url.pathname;
+        // Normalize: strip trailing slash for matching (except root)
+        const prefixSlash = this._prefix + "/";
+        // GET {prefix}/ → HTML page
+        if (req.method === "GET" &&
+            (pathname === this._prefix || pathname === prefixSlash)) {
+            res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+            res.end(EXPLORER_HTML);
+            return true;
+        }
+        // GET {prefix}/tools → list all tools
+        if (req.method === "GET" && pathname === this._prefix + "/tools") {
+            const summaries = this._tools.map((t) => this._toolSummary(t));
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify(summaries));
+            return true;
+        }
+        // POST {prefix}/tools/{name}/call → execute tool
+        if (req.method === "POST" && pathname.startsWith(this._prefix + "/tools/") && pathname.endsWith("/call")) {
+            const toolName = decodeURIComponent(pathname.slice((this._prefix + "/tools/").length, -"/call".length));
+            await this._handleCallTool(req, res, toolName);
+            return true;
+        }
+        // GET {prefix}/tools/{name} → tool detail
+        if (req.method === "GET" && pathname.startsWith(this._prefix + "/tools/")) {
+            const toolName = decodeURIComponent(pathname.slice((this._prefix + "/tools/").length));
+            this._handleToolDetail(res, toolName);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Build a summary dict for a tool (used in the list endpoint).
+     */
+    _toolSummary(tool) {
+        const result = {
+            name: tool.name,
+            description: tool.description ?? "",
+        };
+        if (tool.annotations) {
+            result.annotations = tool.annotations;
+        }
+        return result;
+    }
+    /**
+     * Build a full detail dict for a tool (used in the detail endpoint).
+     */
+    _toolDetail(tool) {
+        const result = {
+            name: tool.name,
+            description: tool.description ?? "",
+            inputSchema: tool.inputSchema,
+        };
+        if (tool.annotations) {
+            result.annotations = tool.annotations;
+        }
+        return result;
+    }
+    /**
+     * Handle GET {prefix}/tools/{name} - return tool detail or 404.
+     */
+    _handleToolDetail(res, toolName) {
+        const tool = this._toolsByName.get(toolName);
+        if (!tool) {
+            res.writeHead(404, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: `Tool not found: ${toolName}` }));
+            return;
+        }
+        res.writeHead(200, { "Content-Type": "application/json" });
+        res.end(JSON.stringify(this._toolDetail(tool)));
+    }
+    /**
+     * Handle POST {prefix}/tools/{name}/call - execute tool or return 403/404.
+     */
+    async _handleCallTool(req, res, toolName) {
+        if (!this._allowExecute) {
+            res.writeHead(403, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({
+                error: "Tool execution is disabled. Launch with --allow-execute to enable.",
+            }));
+            return;
+        }
+        const tool = this._toolsByName.get(toolName);
+        if (!tool) {
+            res.writeHead(404, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: `Tool not found: ${toolName}` }));
+            return;
+        }
+        let body = {};
+        try {
+            const raw = await readBody(req, EXPLORER_MAX_BODY_BYTES);
+            if (raw) {
+                body = JSON.parse(raw);
+            }
+        }
+        catch {
+            // Use empty body if parsing fails
+        }
+        try {
+            const [content, isError] = await this._router.handleCall(toolName, body);
+            // Extract text from content list
+            const texts = content
+                .filter((item) => item.type === "text")
+                .map((item) => item.text);
+            // Try to parse as JSON for a cleaner response
+            let result;
+            if (texts.length === 1) {
+                try {
+                    result = JSON.parse(texts[0]);
+                }
+                catch {
+                    result = texts[0];
+                }
+            }
+            else {
+                result = texts;
+            }
+            if (isError) {
+                res.writeHead(500, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: result }));
+            }
+            else {
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ result }));
+            }
+        }
+        catch (err) {
+            console.error(`Explorer call_tool error for ${toolName}:`, err);
+            res.writeHead(500, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({
+                error: err instanceof Error ? err.message : String(err),
+            }));
+        }
+    }
+}
+//# sourceMappingURL=handler.js.map

package/dist/explorer/handler.js.map

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

package/dist/explorer/html.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Self-contained HTML page for the MCP Tool Explorer.
+ *
+ * Single-page application with no external dependencies.
+ * Displays registered MCP tools, their schemas, annotations,
+ * and optionally allows executing tools from the browser.
+ */
+export declare const EXPLORER_HTML = "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<title>MCP Tool Explorer</title>\n<style>\n  * { margin: 0; padding: 0; box-sizing: border-box; }\n  body { font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, monospace;\n         background: #f5f5f5; color: #333; padding: 24px; }\n  h1 { font-size: 1.4rem; margin-bottom: 16px; }\n  .tool-list { list-style: none; }\n  .tool-item { background: #fff; border: 1px solid #ddd; border-radius: 6px;\n               padding: 12px 16px; margin-bottom: 8px; cursor: pointer; }\n  .tool-item:hover { border-color: #888; }\n  .tool-name { font-weight: 600; }\n  .tool-desc { color: #666; font-size: 0.9rem; margin-top: 4px; }\n  .hint { display: inline-block; background: #e8e8e8; padding: 2px 8px;\n          border-radius: 3px; font-size: 0.75rem; margin-right: 4px; }\n  .hint-readonly { background: #d4edda; color: #155724; }\n  .hint-destructive { background: #f8d7da; color: #721c24; }\n  .hint-idempotent { background: #cce5ff; color: #004085; }\n  .detail { background: #fff; border: 1px solid #ddd; border-radius: 6px;\n            padding: 16px; margin-top: 16px; display: none; }\n  .detail.active { display: block; }\n  .detail h2 { font-size: 1.1rem; margin-bottom: 12px; }\n  .schema-label { font-weight: 600; margin-top: 12px; display: block; }\n  pre { background: #282c34; color: #abb2bf; padding: 12px; border-radius: 4px;\n        overflow-x: auto; font-size: 0.85rem; margin-top: 4px; }\n  #loading { color: #888; }\n  .try-it { margin-top: 16px; border-top: 1px solid #eee; padding-top: 16px; }\n  .try-it h3 { font-size: 0.95rem; margin-bottom: 8px; }\n  .input-editor { width: 100%; min-height: 120px; font-family: monospace;\n                  font-size: 0.85rem; padding: 10px; border: 1px solid #ddd;\n                  border-radius: 4px; resize: vertical; background: #fafafa; }\n  .execute-btn { margin-top: 8px; padding: 8px 20px; background: #4CAF50; color: #fff;\n                 border: none; border-radius: 4px; cursor: pointer; font-size: 0.9rem;\n                 font-weight: 600; }\n  .execute-btn:hover { background: #45a049; }\n  .execute-btn:disabled { background: #ccc; cursor: not-allowed; }\n  .result-area { margin-top: 12px; }\n  .result-area pre { background: #1a2332; }\n  .result-error { color: #f93e3e; }\n  .result-success { color: #49cc90; }\n  .exec-disabled { color: #888; font-size: 0.85rem; font-style: italic; margin-top: 16px; }\n</style>\n</head>\n<body>\n<h1>MCP Tool Explorer</h1>\n<div id=\"loading\">Loading tools...</div>\n<ul class=\"tool-list\" id=\"tools\"></ul>\n<div class=\"detail\" id=\"detail\"></div>\n<script>\n(function() {\n  var base = window.location.pathname.replace(/\\/$/, '');\n  var toolsEl = document.getElementById('tools');\n  var detailEl = document.getElementById('detail');\n  var loadingEl = document.getElementById('loading');\n  var executeEnabled = null;\n\n  function esc(s) {\n    var d = document.createElement('div');\n    d.appendChild(document.createTextNode(s));\n    return d.innerHTML;\n  }\n\n  function defaultFromSchema(schema) {\n    if (!schema || !schema.properties) return {};\n    var result = {};\n    var props = schema.properties;\n    for (var key in props) {\n      if (!props.hasOwnProperty(key)) continue;\n      var t = props[key].type;\n      if (props[key]['default'] !== undefined) {\n        result[key] = props[key]['default'];\n      } else if (t === 'string') {\n        result[key] = '';\n      } else if (t === 'number' || t === 'integer') {\n        result[key] = 0;\n      } else if (t === 'boolean') {\n        result[key] = false;\n      } else if (t === 'array') {\n        result[key] = [];\n      } else if (t === 'object') {\n        result[key] = {};\n      } else {\n        result[key] = null;\n      }\n    }\n    return result;\n  }\n\n  function hintsHtml(annotations) {\n    if (!annotations) return '';\n    var parts = [];\n    if (annotations.readOnlyHint) parts.push('<span class=\"hint hint-readonly\">readOnly</span>');\n    if (annotations.destructiveHint) parts.push('<span class=\"hint hint-destructive\">destructive</span>');\n    if (annotations.idempotentHint) parts.push('<span class=\"hint hint-idempotent\">idempotent</span>');\n    if (annotations.openWorldHint === false) parts.push('<span class=\"hint\">closedWorld</span>');\n    return parts.join('');\n  }\n\n  fetch(base + '/tools')\n    .then(function(r) { return r.json(); })\n    .then(function(tools) {\n      loadingEl.style.display = 'none';\n      tools.forEach(function(t) {\n        var li = document.createElement('li');\n        li.className = 'tool-item';\n        li.innerHTML =\n          '<span class=\"tool-name\">' + esc(t.name) + '</span> ' +\n          hintsHtml(t.annotations) +\n          '<div class=\"tool-desc\">' + esc(t.description || '') + '</div>';\n        li.onclick = function() { loadDetail(t.name); };\n        toolsEl.appendChild(li);\n      });\n      fetch(base + '/tools/__probe__/call', {\n        method: 'POST',\n        headers: {'Content-Type': 'application/json'},\n        body: '{}'\n      }).then(function(r) {\n        executeEnabled = r.status !== 403;\n      }).catch(function() {});\n    })\n    .catch(function(e) { loadingEl.textContent = 'Error: ' + e; });\n\n  function loadDetail(name) {\n    fetch(base + '/tools/' + encodeURIComponent(name))\n      .then(function(r) { return r.json(); })\n      .then(function(d) {\n        detailEl.className = 'detail active';\n        var html =\n          '<h2>' + esc(d.name) + '</h2>' +\n          '<p>' + esc(d.description || '') + '</p>' +\n          '<span class=\"schema-label\">Input Schema</span>' +\n          '<pre>' + esc(JSON.stringify(d.inputSchema, null, 2)) + '</pre>';\n\n        if (d.annotations) {\n          html += '<span class=\"schema-label\">Annotations</span>' +\n            '<pre>' + esc(JSON.stringify(d.annotations, null, 2)) + '</pre>';\n        }\n\n        html += '<div class=\"try-it\" id=\"try-it-section\">' +\n          '<h3>Try it</h3>' +\n          '<textarea class=\"input-editor\" id=\"input-editor\">' +\n          esc(JSON.stringify(defaultFromSchema(d.inputSchema), null, 2)) +\n          '</textarea>' +\n          '<button class=\"execute-btn\" id=\"execute-btn\">Execute</button>' +\n          '<div class=\"result-area\" id=\"result-area\"></div>' +\n          '</div>';\n\n        detailEl.innerHTML = html;\n\n        document.getElementById('execute-btn').onclick = function() {\n          execTool(d.name);\n        };\n\n        if (executeEnabled === false) {\n          var section = document.getElementById('try-it-section');\n          if (section) section.innerHTML =\n            '<p class=\"exec-disabled\">' +\n            'Tool execution is disabled. ' +\n            'Launch with --allow-execute to enable.</p>';\n        }\n      })\n      .catch(function(e) {\n        detailEl.className = 'detail active';\n        detailEl.innerHTML = '<p class=\"result-error\">Failed to load tool details: ' + esc(e.message) + '</p>';\n      });\n  }\n\n  function execTool(name) {\n    var btn = document.getElementById('execute-btn');\n    var editor = document.getElementById('input-editor');\n    var resultArea = document.getElementById('result-area');\n\n    var inputText = editor.value.trim();\n    var inputs;\n    try {\n      inputs = inputText ? JSON.parse(inputText) : {};\n    } catch (e) {\n      resultArea.innerHTML = '<p class=\"result-error\">Invalid JSON: ' + esc(e.message) + '</p>';\n      return;\n    }\n\n    btn.disabled = true;\n    btn.textContent = 'Executing...';\n    resultArea.innerHTML = '';\n\n    fetch(base + '/tools/' + encodeURIComponent(name) + '/call', {\n      method: 'POST',\n      headers: {'Content-Type': 'application/json'},\n      body: JSON.stringify(inputs)\n    })\n    .then(function(r) {\n      if (r.status === 403) {\n        executeEnabled = false;\n        var section = document.getElementById('try-it-section');\n        if (section) section.innerHTML =\n          '<p class=\"exec-disabled\">' +\n          'Tool execution is disabled. ' +\n          'Launch with --allow-execute to enable.</p>';\n        return null;\n      }\n      return r.json().then(function(data) { return {status: r.status, data: data}; });\n    })\n    .then(function(result) {\n      if (!result) return;\n      btn.disabled = false;\n      btn.textContent = 'Execute';\n      if (result.status >= 400) {\n        resultArea.innerHTML = '<span class=\"schema-label result-error\">Error (' + result.status + ')</span>' +\n          '<pre>' + esc(JSON.stringify(result.data, null, 2)) + '</pre>';\n      } else {\n        resultArea.innerHTML = '<span class=\"schema-label result-success\">Result</span>' +\n          '<pre>' + esc(JSON.stringify(result.data, null, 2)) + '</pre>';\n      }\n    })\n    .catch(function(e) {\n      btn.disabled = false;\n      btn.textContent = 'Execute';\n      resultArea.innerHTML = '<p class=\"result-error\">Request failed: ' + esc(e.message) + '</p>';\n    });\n  }\n})();\n</script>\n</body>\n</html>\n";
+//# sourceMappingURL=html.d.ts.map

package/dist/explorer/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/explorer/html.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,aAAa,i/RAqOzB,CAAC"}