@hazeljs/mcp 0.7.9 → 0.8.0

package/README.md

@@ -52,7 +52,7 @@ export class SupportAgent {
     description: 'Open a new support ticket',
     parameters: [
       { name: 'customer_id', type: 'string', description: 'Customer ID', required: true },
-      { name: 'subject',     type: 'string', description: 'Ticket subject', required: true },
+      { name: 'subject', type: 'string', description: 'Ticket subject', required: true },
     ],
   })
   async createTicket(input: Record<string, unknown>) {
@@ -113,10 +113,18 @@ import type { IToolRegistry, HazelTool } from '@hazeljs/mcp';
 class SimpleRegistry implements IToolRegistry {
   private tools = new Map<string, HazelTool>();
 
-  register(tool: HazelTool) { this.tools.set(tool.name, tool); }
-  getAllTools()             { return [...this.tools.values()]; }
-  getTool(name: string)    { return this.tools.get(name); }
-  hasTool(name: string)    { return this.tools.has(name); }
+  register(tool: HazelTool) {
+    this.tools.set(tool.name, tool);
+  }
+  getAllTools() {
+    return [...this.tools.values()];
+  }
+  getTool(name: string) {
+    return this.tools.get(name);
+  }
+  hasTool(name: string) {
+    return this.tools.has(name);
+  }
 }
 
 const registry = new SimpleRegistry();
@@ -125,7 +133,7 @@ registry.register({
   name: 'add',
   description: 'Returns the sum of two numbers',
   parameters: [
-    { name: 'a', type: 'number', description: 'First operand',  required: true },
+    { name: 'a', type: 'number', description: 'First operand', required: true },
     { name: 'b', type: 'number', description: 'Second operand', required: true },
   ],
   target: {},
@@ -180,9 +188,9 @@ AI assistant in Cursor looks up customers, checks orders, and files tickets —
 // AI does this automatically when you ask:
 // "Alice says her order hasn't arrived. Check the status and open a ticket."
 
-await adapter.invoke('lookup_customer',  { email: 'alice@example.com' });
+await adapter.invoke('lookup_customer', { email: 'alice@example.com' });
 await adapter.invoke('get_order_status', { order_id: 'ORD-1001' });
-await adapter.invoke('create_ticket',    { customer_id: 'cust_001', subject: 'Order not arrived' });
+await adapter.invoke('create_ticket', { customer_id: 'cust_001', subject: 'Order not arrived' });
 ```
 
 ### On-call runbook automation
@@ -213,15 +221,15 @@ async exportUserData(input: { userId: string }) { ... }
 
 ## Hazel → MCP field mapping
 
-| Hazel (`ToolMetadata`) | MCP (`McpToolDefinition`) |
-|---|---|
-| `name` | `name` |
-| `description` | `description` |
-| `parameters[].name` | `inputSchema.properties.<key>` |
-| `parameters[].type` | `inputSchema.properties.<key>.type` |
+| Hazel (`ToolMetadata`)     | MCP (`McpToolDefinition`)                  |
+| -------------------------- | ------------------------------------------ |
+| `name`                     | `name`                                     |
+| `description`              | `description`                              |
+| `parameters[].name`        | `inputSchema.properties.<key>`             |
+| `parameters[].type`        | `inputSchema.properties.<key>.type`        |
 | `parameters[].description` | `inputSchema.properties.<key>.description` |
-| `parameters[].enum` | `inputSchema.properties.<key>.enum` |
-| `parameters[].required` | `inputSchema.required[]` |
+| `parameters[].enum`        | `inputSchema.properties.<key>.enum`        |
+| `parameters[].required`    | `inputSchema.required[]`                   |
 
 If a tool has no `parameters`, an open schema is emitted that accepts any JSON object.
 
@@ -235,13 +243,13 @@ If a tool has no `parameters`, an open schema is emitted that accepts any JSON o
 function createMcpServer(options: McpServerOptions): McpServer;
 
 interface McpServerOptions {
-  name: string;           // server name advertised during MCP initialize
-  version: string;        // server version advertised during MCP initialize
+  name: string; // server name advertised during MCP initialize
+  version: string; // server version advertised during MCP initialize
   toolRegistry: IToolRegistry;
 }
 
 interface McpServer {
-  listenStdio(): void;              // attach to process.stdin / process.stdout
+  listenStdio(): void; // attach to process.stdin / process.stdout
   listTools(): McpToolDefinition[]; // inspect registered tools without serving
 }
 ```
@@ -273,7 +281,13 @@ interface IToolRegistry {
 interface HazelTool {
   name: string;
   description: string;
-  parameters?: Array<{ name: string; type: string; description: string; required?: boolean; enum?: unknown[] }>;
+  parameters?: Array<{
+    name: string;
+    type: string;
+    description: string;
+    required?: boolean;
+    enum?: unknown[];
+  }>;
   target: object;
   method: Function;
 }
@@ -281,23 +295,23 @@ interface HazelTool {
 
 ### Supported MCP methods
 
-| Method | Description |
-|---|---|
-| `initialize` | Handshake — returns server info and capabilities |
-| `ping` | Liveness probe |
-| `tools/list` | Returns all registered tool definitions |
+| Method       | Description                                         |
+| ------------ | --------------------------------------------------- |
+| `initialize` | Handshake — returns server info and capabilities    |
+| `ping`       | Liveness probe                                      |
+| `tools/list` | Returns all registered tool definitions             |
 | `tools/call` | Invokes a tool and returns a content block response |
 
 ### Error codes
 
-| Code | Constant | Meaning |
-|---|---|---|
-| -32700 | `PARSE_ERROR` | stdin line could not be parsed as JSON |
-| -32600 | `INVALID_REQUEST` | Not a valid JSON-RPC 2.0 request |
-| -32601 | `METHOD_NOT_FOUND` | No handler for the given method |
-| -32602 | `INVALID_PARAMS` | Required parameter missing or malformed |
-| -32603 | `INTERNAL_ERROR` | Unexpected exception inside a handler |
-| -32001 | `TOOL_NOT_FOUND` | Named tool is not registered |
+| Code   | Constant           | Meaning                                 |
+| ------ | ------------------ | --------------------------------------- |
+| -32700 | `PARSE_ERROR`      | stdin line could not be parsed as JSON  |
+| -32600 | `INVALID_REQUEST`  | Not a valid JSON-RPC 2.0 request        |
+| -32601 | `METHOD_NOT_FOUND` | No handler for the given method         |
+| -32602 | `INVALID_PARAMS`   | Required parameter missing or malformed |
+| -32603 | `INTERNAL_ERROR`   | Unexpected exception inside a handler   |
+| -32001 | `TOOL_NOT_FOUND`   | Named tool is not registered            |
 
 ---
 

package/dist/client/mcp-client.d.ts

@@ -0,0 +1,75 @@
+/**
+ * MCP Client — Connect to external MCP servers
+ *
+ * Allows HazelJS agents to discover and invoke tools from external
+ * MCP-compatible servers via STDIO or HTTP transport.
+ *
+ * @example STDIO transport (e.g., connect to a local MCP server):
+ * ```ts
+ * const client = new McpClient({ name: 'my-app', version: '1.0.0' });
+ *
+ * await client.connectStdio({
+ *   id: 'github',
+ *   name: 'GitHub MCP',
+ *   transport: {
+ *     type: 'stdio',
+ *     command: 'npx',
+ *     args: ['-y', '@modelcontextprotocol/server-github'],
+ *     env: { GITHUB_TOKEN: process.env.GITHUB_TOKEN! },
+ *   },
+ * });
+ *
+ * const tools = client.listTools();          // discover available tools
+ * const result = await client.callTool('github.create_issue', { title: 'Bug' });
+ * ```
+ *
+ * @example Register MCP tools into an agent's ToolRegistry:
+ * ```ts
+ * import { ToolRegistry } from '@hazeljs/agent';
+ * const registry = new ToolRegistry();
+ * client.registerToolsInto(registry);
+ * ```
+ */
+import type { McpClientOptions, McpServerConfig, McpRemoteTool, McpToolCallResult } from './types';
+export declare class McpClient {
+    private readonly clientInfo;
+    private servers;
+    private nextId;
+    constructor(options: McpClientOptions);
+    /**
+     * Connect to an MCP server using the specified transport.
+     * Performs the initialize handshake and discovers available tools.
+     */
+    connect(config: McpServerConfig): Promise<void>;
+    private connectStdio;
+    private connectHttp;
+    /**
+     * List all tools from all connected servers.
+     */
+    listTools(): McpRemoteTool[];
+    /**
+     * List tools from a specific server.
+     */
+    listServerTools(serverId: string): McpRemoteTool[];
+    /**
+     * Call a tool by its qualified name (e.g., "github.create_issue").
+     */
+    callTool(qualifiedName: string, args?: Record<string, unknown>): Promise<McpToolCallResult>;
+    /**
+     * Check if a tool exists by qualified name.
+     */
+    hasTool(qualifiedName: string): boolean;
+    /**
+     * Disconnect from a specific server.
+     */
+    disconnect(serverId: string): void;
+    /**
+     * Disconnect from all servers.
+     */
+    disconnectAll(): void;
+    /**
+     * Get connected server IDs.
+     */
+    getConnectedServers(): string[];
+}
+//# sourceMappingURL=mcp-client.d.ts.map

package/dist/client/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../src/client/mcp-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAKH,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,iBAAiB,EAGlB,MAAM,SAAS,CAAC;AAyBjB,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,MAAM,CAAK;gBAEP,OAAO,EAAE,gBAAgB;IAQrC;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;YAkBvC,YAAY;YA8GZ,WAAW;IAwEzB;;OAEG;IACH,SAAS,IAAI,aAAa,EAAE;IAQ5B;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;IAKlD;;OAEG;IACG,QAAQ,CACZ,aAAa,EAAE,MAAM,EACrB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,iBAAiB,CAAC;IAsB7B;;OAEG;IACH,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;IAQvC;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQlC;;OAEG;IACH,aAAa,IAAI,IAAI;IAMrB;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;CAGhC"}

package/dist/client/mcp-client.js

@@ -0,0 +1,275 @@
+"use strict";
+/**
+ * MCP Client — Connect to external MCP servers
+ *
+ * Allows HazelJS agents to discover and invoke tools from external
+ * MCP-compatible servers via STDIO or HTTP transport.
+ *
+ * @example STDIO transport (e.g., connect to a local MCP server):
+ * ```ts
+ * const client = new McpClient({ name: 'my-app', version: '1.0.0' });
+ *
+ * await client.connectStdio({
+ *   id: 'github',
+ *   name: 'GitHub MCP',
+ *   transport: {
+ *     type: 'stdio',
+ *     command: 'npx',
+ *     args: ['-y', '@modelcontextprotocol/server-github'],
+ *     env: { GITHUB_TOKEN: process.env.GITHUB_TOKEN! },
+ *   },
+ * });
+ *
+ * const tools = client.listTools();          // discover available tools
+ * const result = await client.callTool('github.create_issue', { title: 'Bug' });
+ * ```
+ *
+ * @example Register MCP tools into an agent's ToolRegistry:
+ * ```ts
+ * import { ToolRegistry } from '@hazeljs/agent';
+ * const registry = new ToolRegistry();
+ * client.registerToolsInto(registry);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpClient = void 0;
+const child_process_1 = require("child_process");
+const readline_1 = require("readline");
+class McpClient {
+    constructor(options) {
+        this.servers = new Map();
+        this.nextId = 1;
+        this.clientInfo = options;
+    }
+    // -------------------------------------------------------------------------
+    // Connect
+    // -------------------------------------------------------------------------
+    /**
+     * Connect to an MCP server using the specified transport.
+     * Performs the initialize handshake and discovers available tools.
+     */
+    async connect(config) {
+        if (this.servers.has(config.id)) {
+            throw new Error(`Server "${config.id}" is already connected`);
+        }
+        if (config.transport.type === 'stdio') {
+            await this.connectStdio(config, config.transport);
+        }
+        else if (config.transport.type === 'http') {
+            await this.connectHttp(config, config.transport);
+        }
+        else {
+            throw new Error(`Unknown transport type: ${config.transport.type}`);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // STDIO Transport
+    // -------------------------------------------------------------------------
+    async connectStdio(config, transport) {
+        const child = (0, child_process_1.spawn)(transport.command, transport.args ?? [], {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env, ...(transport.env ?? {}) },
+            cwd: transport.cwd,
+        });
+        if (!child.stdin || !child.stdout) {
+            throw new Error(`Failed to spawn STDIO process for server "${config.id}"`);
+        }
+        const pendingRequests = new Map();
+        // Read line-delimited JSON responses
+        const rl = (0, readline_1.createInterface)({ input: child.stdout });
+        rl.on('line', (line) => {
+            try {
+                const response = JSON.parse(line);
+                const pending = pendingRequests.get(response.id);
+                if (pending) {
+                    clearTimeout(pending.timer);
+                    pendingRequests.delete(response.id);
+                    if (response.error) {
+                        pending.reject(new Error(`MCP error: ${response.error.message}`));
+                    }
+                    else {
+                        pending.resolve(response.result);
+                    }
+                }
+            }
+            catch {
+                // Ignore non-JSON lines (server logs, etc.)
+            }
+        });
+        const requestFn = (method, params) => {
+            return new Promise((resolve, reject) => {
+                const id = this.nextId++;
+                const request = {
+                    jsonrpc: '2.0',
+                    id,
+                    method,
+                    ...(params !== undefined ? { params } : {}),
+                };
+                // Timeout after 30s
+                const timer = setTimeout(() => {
+                    if (pendingRequests.has(id)) {
+                        pendingRequests.delete(id);
+                        reject(new Error(`MCP request timed out: ${method}`));
+                    }
+                }, 30000);
+                pendingRequests.set(id, { resolve, reject, timer });
+                child.stdin.write(JSON.stringify(request) + '\n');
+            });
+        };
+        const disconnectFn = () => {
+            rl.close();
+            child.kill();
+        };
+        // Initialize handshake
+        await requestFn('initialize', {
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: { name: this.clientInfo.name, version: this.clientInfo.version },
+        });
+        // Send initialized notification
+        child.stdin.write(JSON.stringify({ jsonrpc: '2.0', method: 'initialized' }) + '\n');
+        // Discover tools
+        const toolsResult = (await requestFn('tools/list'));
+        const tools = (toolsResult.tools ?? []).map((t) => ({
+            qualifiedName: `${config.id}.${t.name}`,
+            name: t.name,
+            serverId: config.id,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        }));
+        this.servers.set(config.id, {
+            config,
+            tools,
+            request: requestFn,
+            disconnect: disconnectFn,
+        });
+    }
+    // -------------------------------------------------------------------------
+    // HTTP Transport
+    // -------------------------------------------------------------------------
+    async connectHttp(config, transport) {
+        const requestFn = async (method, params) => {
+            const id = this.nextId++;
+            const body = {
+                jsonrpc: '2.0',
+                id,
+                method,
+                ...(params !== undefined ? { params } : {}),
+            };
+            const response = await fetch(transport.url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...(transport.headers ?? {}),
+                },
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                throw new Error(`MCP HTTP error: ${response.status} ${response.statusText}`);
+            }
+            const result = (await response.json());
+            if (result.error) {
+                throw new Error(`MCP error: ${result.error.message}`);
+            }
+            return result.result;
+        };
+        // Initialize handshake
+        await requestFn('initialize', {
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: { name: this.clientInfo.name, version: this.clientInfo.version },
+        });
+        // Discover tools
+        const toolsResult = (await requestFn('tools/list'));
+        const tools = (toolsResult.tools ?? []).map((t) => ({
+            qualifiedName: `${config.id}.${t.name}`,
+            name: t.name,
+            serverId: config.id,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        }));
+        this.servers.set(config.id, {
+            config,
+            tools,
+            request: requestFn,
+            disconnect: () => {
+                /* HTTP is stateless */
+            },
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Tool Operations
+    // -------------------------------------------------------------------------
+    /**
+     * List all tools from all connected servers.
+     */
+    listTools() {
+        const tools = [];
+        for (const server of this.servers.values()) {
+            tools.push(...server.tools);
+        }
+        return tools;
+    }
+    /**
+     * List tools from a specific server.
+     */
+    listServerTools(serverId) {
+        const server = this.servers.get(serverId);
+        return server?.tools ?? [];
+    }
+    /**
+     * Call a tool by its qualified name (e.g., "github.create_issue").
+     */
+    async callTool(qualifiedName, args = {}) {
+        const [serverId, ...nameParts] = qualifiedName.split('.');
+        const toolName = nameParts.join('.');
+        const server = this.servers.get(serverId);
+        if (!server) {
+            throw new Error(`Server not connected: ${serverId}`);
+        }
+        const tool = server.tools.find((t) => t.name === toolName);
+        if (!tool) {
+            throw new Error(`Tool not found: ${qualifiedName}`);
+        }
+        const result = (await server.request('tools/call', {
+            name: toolName,
+            arguments: args,
+        }));
+        return result;
+    }
+    /**
+     * Check if a tool exists by qualified name.
+     */
+    hasTool(qualifiedName) {
+        return this.listTools().some((t) => t.qualifiedName === qualifiedName);
+    }
+    // -------------------------------------------------------------------------
+    // Server Management
+    // -------------------------------------------------------------------------
+    /**
+     * Disconnect from a specific server.
+     */
+    disconnect(serverId) {
+        const server = this.servers.get(serverId);
+        if (server) {
+            server.disconnect();
+            this.servers.delete(serverId);
+        }
+    }
+    /**
+     * Disconnect from all servers.
+     */
+    disconnectAll() {
+        for (const [id] of this.servers) {
+            this.disconnect(id);
+        }
+    }
+    /**
+     * Get connected server IDs.
+     */
+    getConnectedServers() {
+        return Array.from(this.servers.keys());
+    }
+}
+exports.McpClient = McpClient;
+//# sourceMappingURL=mcp-client.js.map

package/dist/client/mcp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.js","sourceRoot":"","sources":["../../src/client/mcp-client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;AAEH,iDAAoD;AACpD,uCAA2E;AAkC3E,MAAa,SAAS;IAKpB,YAAY,OAAyB;QAH7B,YAAO,GAAiC,IAAI,GAAG,EAAE,CAAC;QAClD,WAAM,GAAG,CAAC,CAAC;QAGjB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED,4EAA4E;IAC5E,UAAU;IACV,4EAA4E;IAE5E;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,MAAuB;QACnC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,EAAE,wBAAwB,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACtC,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACpD,CAAC;aAAM,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5C,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,2BAA4B,MAAM,CAAC,SAA8B,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAEpE,KAAK,CAAC,YAAY,CACxB,MAAuB,EACvB,SAAkC;QAElC,MAAM,KAAK,GAAiB,IAAA,qBAAK,EAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,IAAI,EAAE,EAAE;YACzE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;YACjD,GAAG,EAAE,SAAS,CAAC,GAAG;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,6CAA6C,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,GAAG,EAO5B,CAAC;QAEJ,qCAAqC;QACrC,MAAM,EAAE,GAAsB,IAAA,0BAAe,EAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACvE,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YAC7B,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAuB,CAAC;gBACxD,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACjD,IAAI,OAAO,EAAE,CAAC;oBACZ,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;oBAC5B,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;oBACpC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;wBACnB,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,cAAc,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;oBACpE,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBACnC,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,4CAA4C;YAC9C,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,MAAgB,EAAoB,EAAE;YACvE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACrC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAsB;oBACjC,OAAO,EAAE,KAAK;oBACd,EAAE;oBACF,MAAM;oBACN,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC5C,CAAC;gBAEF,oBAAoB;gBACpB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC5B,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;wBAC5B,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;wBAC3B,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC,CAAC;oBACxD,CAAC;gBACH,CAAC,EAAE,KAAK,CAAC,CAAC;gBAEV,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;gBACpD,KAAK,CAAC,KAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;YACrD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,YAAY,GAAG,GAAS,EAAE;YAC9B,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,CAAC,CAAC;QAEF,uBAAuB;QACvB,MAAM,SAAS,CAAC,YAAY,EAAE;YAC5B,eAAe,EAAE,YAAY;YAC7B,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE;SAC7E,CAAC,CAAC;QAEH,gCAAgC;QAChC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAEpF,iBAAiB;QACjB,MAAM,WAAW,GAAG,CAAC,MAAM,SAAS,CAAC,YAAY,CAAC,CAMjD,CAAC;QAEF,MAAM,KAAK,GAAoB,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnE,aAAa,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE;YACvC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,CAAC;QAEJ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE;YAC1B,MAAM;YACN,KAAK;YACL,OAAO,EAAE,SAAS;YAClB,UAAU,EAAE,YAAY;SACzB,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,iBAAiB;IACjB,4EAA4E;IAEpE,KAAK,CAAC,WAAW,CACvB,MAAuB,EACvB,SAAiC;QAEjC,MAAM,SAAS,GAAG,KAAK,EAAE,MAAc,EAAE,MAAgB,EAAoB,EAAE;YAC7E,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,GAAsB;gBAC9B,OAAO,EAAE,KAAK;gBACd,EAAE;gBACF,MAAM;gBACN,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5C,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;gBAC1C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,GAAG,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC;iBAC7B;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC3B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAC/E,CAAC;YAED,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAuB,CAAC;YAC7D,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,cAAc,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACxD,CAAC;YAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACvB,CAAC,CAAC;QAEF,uBAAuB;QACvB,MAAM,SAAS,CAAC,YAAY,EAAE;YAC5B,eAAe,EAAE,YAAY;YAC7B,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE;SAC7E,CAAC,CAAC;QAEH,iBAAiB;QACjB,MAAM,WAAW,GAAG,CAAC,MAAM,SAAS,CAAC,YAAY,CAAC,CAMjD,CAAC;QAEF,MAAM,KAAK,GAAoB,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnE,aAAa,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE;YACvC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,CAAC;QAEJ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE;YAC1B,MAAM;YACN,KAAK;YACL,OAAO,EAAE,SAAS;YAClB,UAAU,EAAE,GAAG,EAAE;gBACf,uBAAuB;YACzB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E;;OAEG;IACH,SAAS;QACP,MAAM,KAAK,GAAoB,EAAE,CAAC;QAClC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,QAAgB;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,aAAqB,EACrB,OAAgC,EAAE;QAElC,MAAM,CAAC,QAAQ,EAAE,GAAG,SAAS,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAErC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,mBAAmB,aAAa,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE;YACjD,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,IAAI;SAChB,CAAC,CAAsB,CAAC;QAEzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,aAAqB;QAC3B,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,aAAa,CAAC,CAAC;IACzE,CAAC;IAED,4EAA4E;IAC5E,oBAAoB;IACpB,4EAA4E;IAE5E;;OAEG;IACH,UAAU,CAAC,QAAgB;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa;QACX,KAAK,MAAM,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAChC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;CACF;AA7SD,8BA6SC"}

package/dist/client/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * MCP Client Types
+ *
+ * Types for connecting to external MCP servers as a client,
+ * allowing HazelJS agents to consume tools from other systems.
+ */
+export interface McpClientOptions {
+    /** Human-readable name for this client */
+    name: string;
+    /** Client version */
+    version: string;
+}
+/** Configuration for connecting to an MCP server */
+export interface McpServerConfig {
+    /** Unique identifier for this server connection */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Transport type */
+    transport: McpTransportConfig;
+}
+export type McpTransportConfig = McpStdioTransportConfig | McpHttpTransportConfig;
+export interface McpStdioTransportConfig {
+    type: 'stdio';
+    /** Command to spawn the MCP server */
+    command: string;
+    /** Arguments to the command */
+    args?: string[];
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Working directory */
+    cwd?: string;
+}
+export interface McpHttpTransportConfig {
+    type: 'http';
+    /** URL of the MCP server */
+    url: string;
+    /** HTTP headers to include */
+    headers?: Record<string, string>;
+}
+export interface McpRemoteTool {
+    /** Server ID + tool name (e.g., "github.create_issue") */
+    qualifiedName: string;
+    /** Original tool name from the server */
+    name: string;
+    /** Server ID this tool belongs to */
+    serverId: string;
+    /** Tool description */
+    description: string;
+    /** JSON Schema for input */
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, {
+            type: string;
+            description: string;
+            enum?: unknown[];
+        }>;
+        required: string[];
+    };
+}
+/** Result of calling a remote MCP tool */
+export interface McpToolCallResult {
+    content: Array<{
+        type: string;
+        text?: string;
+        data?: unknown;
+    }>;
+    isError: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,MAAM,MAAM,kBAAkB,GAAG,uBAAuB,GAAG,sBAAsB,CAAC;AAElF,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,OAAO,CAAC;IACd,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAMD,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;SAAE,CAAC,CAAC;QACpF,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAChE,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/client/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * MCP Client Types
+ *
+ * Types for connecting to external MCP servers as a client,
+ * allowing HazelJS agents to consume tools from other systems.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @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();
+ */
+export { createMcpServer } from './server/createMcpServer';
+export { HazelToolAdapter } from './server/hazelToolAdapter';
+export { ErrorCode, makeError, makeErrorResponse, parseError, invalidRequestError, methodNotFoundError, invalidParamsError, toolNotFoundError, internalError, } from './server/errors';
+export { McpClient } from './client/mcp-client';
+export type { McpServer, McpServerOptions, McpToolDefinition, McpRequest, McpResponse, McpError, McpErrorResponse, CallToolParams, InitializeParams, ServerCapabilities, JsonSchemaProperty, IToolRegistry, HazelTool, } from './server/types';
+export type { McpClientOptions, McpServerConfig, McpTransportConfig, McpStdioTransportConfig, McpHttpTransportConfig, McpRemoteTool, McpToolCallResult, } from './client/types';
+//# 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;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG7D,OAAO,EACL,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMhD,YAAY,EAEV,SAAS,EACT,gBAAgB,EAEhB,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAElB,aAAa,EACb,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAEV,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,aAAa,EACb,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}