@hazeljs/mcp 0.7.8 → 0.8.0

package/dist/index.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * @hazeljs/mcp — Public API
+ *
+ * MCP Server: Expose HazelJS tools as MCP tools over STDIO/HTTP.
+ * MCP Client: Connect to external MCP servers and consume their tools.
+ *
+ * Quickstart (Server):
+ *   import { createMcpServer } from '@hazeljs/mcp';
+ *   const server = createMcpServer({ name: 'my-server', version: '1.0.0', toolRegistry });
+ *   server.listenStdio();
+ *
+ * Quickstart (Client):
+ *   import { McpClient } from '@hazeljs/mcp';
+ *   const client = new McpClient({ name: 'my-app', version: '1.0.0' });
+ *   await client.connect({ id: 'github', name: 'GitHub', transport: { type: 'stdio', command: 'npx', args: ['-y', '@modelcontextprotocol/server-github'] } });
+ *   const tools = client.listTools();
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpClient = exports.internalError = exports.toolNotFoundError = exports.invalidParamsError = exports.methodNotFoundError = exports.invalidRequestError = exports.parseError = exports.makeErrorResponse = exports.makeError = exports.ErrorCode = exports.HazelToolAdapter = exports.createMcpServer = void 0;
+// ---------------------------------------------------------------------------
+// Server
+// ---------------------------------------------------------------------------
+// Factory function
+var createMcpServer_1 = require("./server/createMcpServer");
+Object.defineProperty(exports, "createMcpServer", { enumerable: true, get: function () { return createMcpServer_1.createMcpServer; } });
+// Adapter — useful for testing or custom transports
+var hazelToolAdapter_1 = require("./server/hazelToolAdapter");
+Object.defineProperty(exports, "HazelToolAdapter", { enumerable: true, get: function () { return hazelToolAdapter_1.HazelToolAdapter; } });
+// Error utilities — useful when building custom transports or middleware
+var errors_1 = require("./server/errors");
+Object.defineProperty(exports, "ErrorCode", { enumerable: true, get: function () { return errors_1.ErrorCode; } });
+Object.defineProperty(exports, "makeError", { enumerable: true, get: function () { return errors_1.makeError; } });
+Object.defineProperty(exports, "makeErrorResponse", { enumerable: true, get: function () { return errors_1.makeErrorResponse; } });
+Object.defineProperty(exports, "parseError", { enumerable: true, get: function () { return errors_1.parseError; } });
+Object.defineProperty(exports, "invalidRequestError", { enumerable: true, get: function () { return errors_1.invalidRequestError; } });
+Object.defineProperty(exports, "methodNotFoundError", { enumerable: true, get: function () { return errors_1.methodNotFoundError; } });
+Object.defineProperty(exports, "invalidParamsError", { enumerable: true, get: function () { return errors_1.invalidParamsError; } });
+Object.defineProperty(exports, "toolNotFoundError", { enumerable: true, get: function () { return errors_1.toolNotFoundError; } });
+Object.defineProperty(exports, "internalError", { enumerable: true, get: function () { return errors_1.internalError; } });
+// ---------------------------------------------------------------------------
+// Client
+// ---------------------------------------------------------------------------
+var mcp_client_1 = require("./client/mcp-client");
+Object.defineProperty(exports, "McpClient", { enumerable: true, get: function () { return mcp_client_1.McpClient; } });
+//# 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;;;;;;;;;;;;;;;;GAgBG;;;AAEH,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,mBAAmB;AACnB,4DAA2D;AAAlD,kHAAA,eAAe,OAAA;AAExB,oDAAoD;AACpD,8DAA6D;AAApD,oHAAA,gBAAgB,OAAA;AAEzB,yEAAyE;AACzE,0CAUyB;AATvB,mGAAA,SAAS,OAAA;AACT,mGAAA,SAAS,OAAA;AACT,2GAAA,iBAAiB,OAAA;AACjB,oGAAA,UAAU,OAAA;AACV,6GAAA,mBAAmB,OAAA;AACnB,6GAAA,mBAAmB,OAAA;AACnB,4GAAA,kBAAkB,OAAA;AAClB,2GAAA,iBAAiB,OAAA;AACjB,uGAAA,aAAa,OAAA;AAGf,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,kDAAgD;AAAvC,uGAAA,SAAS,OAAA"}

package/dist/server/createMcpServer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * createMcpServer
+ *
+ * The main entry point of @hazeljs/mcp. Wires together:
+ *   1. HazelToolAdapter  — converts Hazel tools to MCP definitions
+ *   2. Request router    — dispatches JSON-RPC methods to handlers
+ *   3. STDIO transport   — reads/writes newline-delimited JSON
+ *
+ * Supported JSON-RPC methods:
+ *   initialize    — MCP handshake; returns server name, version, capabilities
+ *   ping          — liveness probe; returns empty result
+ *   tools/list    — returns all registered MCP tool definitions
+ *   tools/call    — invokes a named tool with provided arguments
+ *
+ * Usage:
+ *   const server = createMcpServer({ name, version, toolRegistry });
+ *   server.listenStdio();
+ *
+ * Extension note:
+ *   To expose the same tools over HTTP/SSE, call handleRequest() from an
+ *   HTTP handler instead of wiring it to createStdioTransport(). The router
+ *   logic and adapter are reusable across transports.
+ */
+import type { McpServerOptions, McpServer } from './types';
+export declare function createMcpServer(options: McpServerOptions): McpServer;
+//# sourceMappingURL=createMcpServer.d.ts.map

package/dist/server/createMcpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMcpServer.d.ts","sourceRoot":"","sources":["../../src/server/createMcpServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,SAAS,EAMV,MAAM,SAAS,CAAC;AAUjB,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA+GpE"}

package/dist/server/createMcpServer.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * createMcpServer
+ *
+ * The main entry point of @hazeljs/mcp. Wires together:
+ *   1. HazelToolAdapter  — converts Hazel tools to MCP definitions
+ *   2. Request router    — dispatches JSON-RPC methods to handlers
+ *   3. STDIO transport   — reads/writes newline-delimited JSON
+ *
+ * Supported JSON-RPC methods:
+ *   initialize    — MCP handshake; returns server name, version, capabilities
+ *   ping          — liveness probe; returns empty result
+ *   tools/list    — returns all registered MCP tool definitions
+ *   tools/call    — invokes a named tool with provided arguments
+ *
+ * Usage:
+ *   const server = createMcpServer({ name, version, toolRegistry });
+ *   server.listenStdio();
+ *
+ * Extension note:
+ *   To expose the same tools over HTTP/SSE, call handleRequest() from an
+ *   HTTP handler instead of wiring it to createStdioTransport(). The router
+ *   logic and adapter are reusable across transports.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMcpServer = createMcpServer;
+const hazelToolAdapter_1 = require("./hazelToolAdapter");
+const stdioTransport_1 = require("./stdioTransport");
+const errors_1 = require("./errors");
+function createMcpServer(options) {
+    const { name, version, toolRegistry } = options;
+    // Snapshot the registry once at startup. Tools registered after this point
+    // won't be visible until the server is restarted or the adapter is rebuilt.
+    const adapter = hazelToolAdapter_1.HazelToolAdapter.fromRegistry(toolRegistry);
+    // ---------------------------------------------------------------------------
+    // Request router
+    // ---------------------------------------------------------------------------
+    async function handleRequest(req) {
+        const id = req.id ?? null;
+        switch (req.method) {
+            case 'initialize':
+                return handleInitialize(id);
+            case 'initialized':
+                // Notification — no response required by spec, but we send an ack
+                // to avoid clients hanging on a missing reply
+                return { jsonrpc: '2.0', id, result: {} };
+            case 'ping':
+                return { jsonrpc: '2.0', id, result: {} };
+            case 'tools/list':
+                return handleListTools(id);
+            case 'tools/call':
+                return handleCallTool(id, req);
+            default:
+                return (0, errors_1.methodNotFoundError)(id, req.method);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Method handlers
+    // ---------------------------------------------------------------------------
+    function handleInitialize(id) {
+        return {
+            jsonrpc: '2.0',
+            id,
+            result: {
+                protocolVersion: '2024-11-05',
+                serverInfo: { name, version },
+                capabilities: {
+                    // Advertise tool support; set listChanged: true if dynamic
+                    // registration is added in a future version
+                    tools: {},
+                },
+            },
+        };
+    }
+    function handleListTools(id) {
+        return {
+            jsonrpc: '2.0',
+            id,
+            result: {
+                tools: adapter.listTools(),
+            },
+        };
+    }
+    async function handleCallTool(id, req) {
+        const params = req.params;
+        if (!params?.name) {
+            return (0, errors_1.invalidParamsError)(id, 'Missing required field: name');
+        }
+        if (!adapter.hasTool(params.name)) {
+            return (0, errors_1.toolNotFoundError)(id, params.name);
+        }
+        try {
+            const result = await adapter.invoke(params.name, params.arguments ?? {});
+            return {
+                jsonrpc: '2.0',
+                id,
+                result: {
+                    // MCP content block format — clients render type: 'text' as plain text
+                    content: [{ type: 'text', text: JSON.stringify(result) }],
+                    isError: false,
+                },
+            };
+        }
+        catch (err) {
+            return (0, errors_1.internalError)(id, err);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    return {
+        listenStdio() {
+            (0, stdioTransport_1.createStdioTransport)(handleRequest);
+        },
+        listTools() {
+            return adapter.listTools();
+        },
+    };
+}
+//# sourceMappingURL=createMcpServer.js.map

package/dist/server/createMcpServer.js.map

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

package/dist/server/errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * JSON-RPC 2.0 Error Helpers
+ *
+ * Standard error codes: https://www.jsonrpc.org/specification#error_object
+ *
+ * MCP application-level codes occupy the -32000 to -32099 server-error range.
+ * The server never throws — every error path returns a typed response object
+ * so that the transport layer can safely serialize and send it.
+ */
+import type { McpError, McpErrorResponse } from './types';
+export declare const ErrorCode: {
+    readonly PARSE_ERROR: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    readonly TOOL_NOT_FOUND: -32001;
+    readonly TOOL_EXECUTION_FAILED: -32002;
+};
+export declare function makeError(code: number, message: string, data?: unknown): McpError;
+export declare function makeErrorResponse(id: string | number | null, code: number, message: string, data?: unknown): McpErrorResponse;
+/** -32700 — Line received from stdin could not be parsed as JSON */
+export declare function parseError(id?: string | number | null): McpErrorResponse;
+/** -32600 — Message is not a valid JSON-RPC 2.0 request */
+export declare function invalidRequestError(id?: string | number | null): McpErrorResponse;
+/** -32601 — No handler registered for the given method */
+export declare function methodNotFoundError(id: string | number | null, method: string): McpErrorResponse;
+/** -32602 — Required parameter missing or malformed */
+export declare function invalidParamsError(id: string | number | null, detail?: string): McpErrorResponse;
+/** -32001 — Requested tool name is not registered in the adapter */
+export declare function toolNotFoundError(id: string | number | null, toolName: string): McpErrorResponse;
+/** -32603 — Unexpected exception inside a handler or tool execution */
+export declare function internalError(id: string | number | null, detail?: unknown): McpErrorResponse;
+//# sourceMappingURL=errors.d.ts.map

package/dist/server/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/server/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAM1D,eAAO,MAAM,SAAS;;;;;;;;CAWZ,CAAC;AAMX,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAEjF;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,GACb,gBAAgB,CAMlB;AAMD,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,EAAE,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,GAAG,gBAAgB,CAE9E;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,EAAE,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,GAAG,gBAAgB,CAEvF;AAED,0DAA0D;AAC1D,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAEhG;AAED,uDAAuD;AACvD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAMhG;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAEhG;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAG5F"}

package/dist/server/errors.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * JSON-RPC 2.0 Error Helpers
+ *
+ * Standard error codes: https://www.jsonrpc.org/specification#error_object
+ *
+ * MCP application-level codes occupy the -32000 to -32099 server-error range.
+ * The server never throws — every error path returns a typed response object
+ * so that the transport layer can safely serialize and send it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorCode = void 0;
+exports.makeError = makeError;
+exports.makeErrorResponse = makeErrorResponse;
+exports.parseError = parseError;
+exports.invalidRequestError = invalidRequestError;
+exports.methodNotFoundError = methodNotFoundError;
+exports.invalidParamsError = invalidParamsError;
+exports.toolNotFoundError = toolNotFoundError;
+exports.internalError = internalError;
+// ---------------------------------------------------------------------------
+// Error code constants
+// ---------------------------------------------------------------------------
+exports.ErrorCode = {
+    // Standard JSON-RPC 2.0 codes
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+    // MCP / application-level codes
+    TOOL_NOT_FOUND: -32001,
+    TOOL_EXECUTION_FAILED: -32002,
+};
+// ---------------------------------------------------------------------------
+// Primitive builders
+// ---------------------------------------------------------------------------
+function makeError(code, message, data) {
+    return { code, message, ...(data !== undefined ? { data } : {}) };
+}
+function makeErrorResponse(id, code, message, data) {
+    return {
+        jsonrpc: '2.0',
+        id,
+        error: makeError(code, message, data),
+    };
+}
+// ---------------------------------------------------------------------------
+// Named error constructors
+// ---------------------------------------------------------------------------
+/** -32700 — Line received from stdin could not be parsed as JSON */
+function parseError(id = null) {
+    return makeErrorResponse(id, exports.ErrorCode.PARSE_ERROR, 'Parse error');
+}
+/** -32600 — Message is not a valid JSON-RPC 2.0 request */
+function invalidRequestError(id = null) {
+    return makeErrorResponse(id, exports.ErrorCode.INVALID_REQUEST, 'Invalid Request');
+}
+/** -32601 — No handler registered for the given method */
+function methodNotFoundError(id, method) {
+    return makeErrorResponse(id, exports.ErrorCode.METHOD_NOT_FOUND, `Method not found: ${method}`);
+}
+/** -32602 — Required parameter missing or malformed */
+function invalidParamsError(id, detail) {
+    return makeErrorResponse(id, exports.ErrorCode.INVALID_PARAMS, detail ? `Invalid params: ${detail}` : 'Invalid params');
+}
+/** -32001 — Requested tool name is not registered in the adapter */
+function toolNotFoundError(id, toolName) {
+    return makeErrorResponse(id, exports.ErrorCode.TOOL_NOT_FOUND, `Tool not found: ${toolName}`);
+}
+/** -32603 — Unexpected exception inside a handler or tool execution */
+function internalError(id, detail) {
+    const data = detail instanceof Error ? { message: detail.message } : detail;
+    return makeErrorResponse(id, exports.ErrorCode.INTERNAL_ERROR, 'Internal error', data);
+}
+//# sourceMappingURL=errors.js.map

package/dist/server/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/server/errors.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAyBH,8BAEC;AAED,8CAWC;AAOD,gCAEC;AAGD,kDAEC;AAGD,kDAEC;AAGD,gDAMC;AAGD,8CAEC;AAGD,sCAGC;AA3ED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAEjE,QAAA,SAAS,GAAG;IACvB,8BAA8B;IAC9B,WAAW,EAAE,CAAC,KAAK;IACnB,eAAe,EAAE,CAAC,KAAK;IACvB,gBAAgB,EAAE,CAAC,KAAK;IACxB,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;IAEtB,gCAAgC;IAChC,cAAc,EAAE,CAAC,KAAK;IACtB,qBAAqB,EAAE,CAAC,KAAK;CACrB,CAAC;AAEX,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,SAAgB,SAAS,CAAC,IAAY,EAAE,OAAe,EAAE,IAAc;IACrE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,SAAgB,iBAAiB,CAC/B,EAA0B,EAC1B,IAAY,EACZ,OAAe,EACf,IAAc;IAEd,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;KACtC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,oEAAoE;AACpE,SAAgB,UAAU,CAAC,KAA6B,IAAI;IAC1D,OAAO,iBAAiB,CAAC,EAAE,EAAE,iBAAS,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AACrE,CAAC;AAED,2DAA2D;AAC3D,SAAgB,mBAAmB,CAAC,KAA6B,IAAI;IACnE,OAAO,iBAAiB,CAAC,EAAE,EAAE,iBAAS,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;AAC7E,CAAC;AAED,0DAA0D;AAC1D,SAAgB,mBAAmB,CAAC,EAA0B,EAAE,MAAc;IAC5E,OAAO,iBAAiB,CAAC,EAAE,EAAE,iBAAS,CAAC,gBAAgB,EAAE,qBAAqB,MAAM,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,uDAAuD;AACvD,SAAgB,kBAAkB,CAAC,EAA0B,EAAE,MAAe;IAC5E,OAAO,iBAAiB,CACtB,EAAE,EACF,iBAAS,CAAC,cAAc,EACxB,MAAM,CAAC,CAAC,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC,CAAC,gBAAgB,CACxD,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,SAAgB,iBAAiB,CAAC,EAA0B,EAAE,QAAgB;IAC5E,OAAO,iBAAiB,CAAC,EAAE,EAAE,iBAAS,CAAC,cAAc,EAAE,mBAAmB,QAAQ,EAAE,CAAC,CAAC;AACxF,CAAC;AAED,uEAAuE;AACvE,SAAgB,aAAa,CAAC,EAA0B,EAAE,MAAgB;IACxE,MAAM,IAAI,GAAG,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5E,OAAO,iBAAiB,CAAC,EAAE,EAAE,iBAAS,CAAC,cAAc,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;AACjF,CAAC"}

package/dist/server/hazelToolAdapter.d.ts

@@ -0,0 +1,59 @@
+/**
+ * HazelToolAdapter
+ *
+ * Converts a Hazel tool registry into MCP tool definitions and handles
+ * tool invocation on behalf of the MCP server.
+ *
+ * Hazel → MCP field mapping:
+ *   ToolMetadata.name        → McpToolDefinition.name
+ *   ToolMetadata.description → McpToolDefinition.description
+ *   ToolMetadata.parameters  → McpToolDefinition.inputSchema (JSON Schema object)
+ *
+ * Invocation:
+ *   The adapter calls method.call(target, input) to preserve the `this`
+ *   context of the original decorated class instance. This means tools
+ *   registered via @Tool() on an agent class work out of the box.
+ *
+ * Schema handling:
+ *   - parameters[] present  → converted to JSON Schema (type/description/enum)
+ *   - parameters absent     → empty schema, accepts any JSON object
+ *
+ * Extension note:
+ *   To support input validation via Zod, replace the direct method.call with
+ *   a validation step: parse input with the Zod schema, then call the method.
+ *   The validation hook below is a placeholder for that upgrade path.
+ *
+ * The adapter is designed to be transport-agnostic. The same instance can be
+ * used by STDIO, HTTP, or SSE transports — only the transport glue changes.
+ */
+import type { IToolRegistry, McpToolDefinition } from './types';
+export declare class HazelToolAdapter {
+    private readonly tools;
+    private constructor();
+    /**
+     * Build an adapter from a Hazel tool registry.
+     *
+     * The registry is snapshotted at construction time. If tools are registered
+     * dynamically after server start, call fromRegistry() again and replace the
+     * server's adapter (or extend this class to hold a live registry reference).
+     */
+    static fromRegistry(registry: IToolRegistry): HazelToolAdapter;
+    /** Return all tools as MCP definitions for a tools/list response */
+    listTools(): McpToolDefinition[];
+    /**
+     * Invoke a named tool with the given input object.
+     *
+     * Throws if the tool is not found — callers should check hasTool() first
+     * or catch the error and convert it to a JSON-RPC error response.
+     */
+    invoke(toolName: string, input: Record<string, unknown>): Promise<unknown>;
+    hasTool(toolName: string): boolean;
+    /**
+     * Convert a Hazel tool's parameter list into an MCP JSON Schema inputSchema.
+     *
+     * If parameters is empty or undefined, an open schema is emitted
+     * ({ type: 'object', properties: {}, required: [] }) which accepts any input.
+     */
+    private toMcpDefinition;
+}
+//# sourceMappingURL=hazelToolAdapter.d.ts.map

package/dist/server/hazelToolAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hazelToolAdapter.d.ts","sourceRoot":"","sources":["../../src/server/hazelToolAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAa,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE3E,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAE3D,OAAO;IAEP;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,gBAAgB;IAU9D,oEAAoE;IACpE,SAAS,IAAI,iBAAiB,EAAE;IAIhC;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAWhF,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQlC;;;;;OAKG;IACH,OAAO,CAAC,eAAe;CA0BxB"}

package/dist/server/hazelToolAdapter.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * HazelToolAdapter
+ *
+ * Converts a Hazel tool registry into MCP tool definitions and handles
+ * tool invocation on behalf of the MCP server.
+ *
+ * Hazel → MCP field mapping:
+ *   ToolMetadata.name        → McpToolDefinition.name
+ *   ToolMetadata.description → McpToolDefinition.description
+ *   ToolMetadata.parameters  → McpToolDefinition.inputSchema (JSON Schema object)
+ *
+ * Invocation:
+ *   The adapter calls method.call(target, input) to preserve the `this`
+ *   context of the original decorated class instance. This means tools
+ *   registered via @Tool() on an agent class work out of the box.
+ *
+ * Schema handling:
+ *   - parameters[] present  → converted to JSON Schema (type/description/enum)
+ *   - parameters absent     → empty schema, accepts any JSON object
+ *
+ * Extension note:
+ *   To support input validation via Zod, replace the direct method.call with
+ *   a validation step: parse input with the Zod schema, then call the method.
+ *   The validation hook below is a placeholder for that upgrade path.
+ *
+ * The adapter is designed to be transport-agnostic. The same instance can be
+ * used by STDIO, HTTP, or SSE transports — only the transport glue changes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HazelToolAdapter = void 0;
+class HazelToolAdapter {
+    constructor() {
+        this.tools = new Map();
+    }
+    /**
+     * Build an adapter from a Hazel tool registry.
+     *
+     * The registry is snapshotted at construction time. If tools are registered
+     * dynamically after server start, call fromRegistry() again and replace the
+     * server's adapter (or extend this class to hold a live registry reference).
+     */
+    static fromRegistry(registry) {
+        const adapter = new HazelToolAdapter();
+        for (const tool of registry.getAllTools()) {
+            adapter.tools.set(tool.name, tool);
+        }
+        return adapter;
+    }
+    /** Return all tools as MCP definitions for a tools/list response */
+    listTools() {
+        return Array.from(this.tools.values()).map((tool) => this.toMcpDefinition(tool));
+    }
+    /**
+     * Invoke a named tool with the given input object.
+     *
+     * Throws if the tool is not found — callers should check hasTool() first
+     * or catch the error and convert it to a JSON-RPC error response.
+     */
+    async invoke(toolName, input) {
+        const tool = this.tools.get(toolName);
+        if (!tool) {
+            throw new Error(`Tool not found: ${toolName}`);
+        }
+        // Preserve the original `this` context from the registered class instance
+        return tool.method.call(tool.target, input);
+    }
+    hasTool(toolName) {
+        return this.tools.has(toolName);
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Convert a Hazel tool's parameter list into an MCP JSON Schema inputSchema.
+     *
+     * If parameters is empty or undefined, an open schema is emitted
+     * ({ type: 'object', properties: {}, required: [] }) which accepts any input.
+     */
+    toMcpDefinition(tool) {
+        const properties = {};
+        const required = [];
+        for (const param of tool.parameters ?? []) {
+            properties[param.name] = {
+                type: param.type,
+                description: param.description,
+                ...(param.enum !== undefined ? { enum: param.enum } : {}),
+            };
+            if (param.required) {
+                required.push(param.name);
+            }
+        }
+        return {
+            name: tool.name,
+            description: tool.description,
+            inputSchema: {
+                type: 'object',
+                properties,
+                required,
+            },
+        };
+    }
+}
+exports.HazelToolAdapter = HazelToolAdapter;
+//# sourceMappingURL=hazelToolAdapter.js.map

package/dist/server/hazelToolAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hazelToolAdapter.js","sourceRoot":"","sources":["../../src/server/hazelToolAdapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;AAIH,MAAa,gBAAgB;IAG3B;QAFiB,UAAK,GAA2B,IAAI,GAAG,EAAE,CAAC;IAEpC,CAAC;IAExB;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,QAAuB;QACzC,MAAM,OAAO,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAEvC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;YAC1C,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,oEAAoE;IACpE,SAAS;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IACnF,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,KAA8B;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,0EAA0E;QAC1E,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAqB,CAAC;IAClE,CAAC;IAED,OAAO,CAAC,QAAgB;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,8EAA8E;IAC9E,kBAAkB;IAClB,8EAA8E;IAE9E;;;;;OAKG;IACK,eAAe,CAAC,IAAe;QACrC,MAAM,UAAU,GAAmD,EAAE,CAAC;QACtE,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;YAC1C,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;gBACvB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1D,CAAC;YAEF,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU;gBACV,QAAQ;aACT;SACF,CAAC;IACJ,CAAC;CACF;AApFD,4CAoFC"}

package/dist/server/stdioTransport.d.ts

@@ -0,0 +1,37 @@
+/**
+ * STDIO Transport
+ *
+ * Reads newline-delimited JSON from process.stdin, passes each message to the
+ * supplied RequestHandler, and writes the JSON-RPC response back to
+ * process.stdout followed by a newline.
+ *
+ * Design decisions:
+ *   - Each incoming line is handled in its own promise chain (no await in the
+ *     readline handler) so slow tool calls don't block subsequent requests.
+ *   - JSON parse errors are returned as -32700 responses instead of crashing.
+ *   - Unexpected handler exceptions are caught and returned as -32603 so the
+ *     server never exits due to user input.
+ *   - process.stdin 'close' triggers a clean process.exit(0) — MCP clients
+ *     that close stdin expect the server to terminate.
+ *
+ * Extension note:
+ *   To add HTTP/SSE transport, implement the same RequestHandler signature
+ *   and wire it to incoming HTTP requests (e.g. via Express or Fastify).
+ *   The handler itself, the adapter, and all protocol types stay unchanged.
+ *
+ *   Example HTTP skeleton:
+ *     app.post('/rpc', async (req, res) => {
+ *       const response = await handler(req.body as McpRequest);
+ *       res.json(response);
+ *     });
+ */
+import type { McpRequest, McpResponse, McpErrorResponse } from './types';
+export type RequestHandler = (req: McpRequest) => Promise<McpResponse | McpErrorResponse>;
+/**
+ * Attach the STDIO transport to the current process.
+ *
+ * After this call, the process reads from stdin and writes to stdout until
+ * stdin is closed. Call this once at server startup.
+ */
+export declare function createStdioTransport(handler: RequestHandler): void;
+//# sourceMappingURL=stdioTransport.d.ts.map

package/dist/server/stdioTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdioTransport.d.ts","sourceRoot":"","sources":["../../src/server/stdioTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGzE,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,GAAG,gBAAgB,CAAC,CAAC;AAE1F;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAmBlE"}