@cyanheads/git-mcp-server 2.2.3 → 2.3.1

package/dist/mcp-server/transports/http/httpTransport.js

@@ -19,6 +19,17 @@ import { mcpTransportMiddleware } from "./mcpTransportMiddleware.js";
 const HTTP_PORT = config.mcpHttpPort;
 const HTTP_HOST = config.mcpHttpHost;
 const MCP_ENDPOINT_PATH = config.mcpHttpEndpointPath;
+/**
+ * Extracts the client IP address from the request, prioritizing common proxy headers.
+ * @param c - The Hono context object.
+ * @returns The client's IP address or a default string if not found.
+ */
+function getClientIp(c) {
+    const forwardedFor = c.req.header("x-forwarded-for");
+    return ((forwardedFor?.split(",")[0] ?? "").trim() ||
+        c.req.header("x-real-ip") ||
+        "unknown_ip");
+}
 /**
  * Converts a Fetch API Headers object to Node.js IncomingHttpHeaders.
  * Hono uses Fetch API Headers, but the underlying transport managers expect
@@ -86,7 +97,7 @@ function startHttpServerWithRetry(app, initialPort, host, maxRetries, parentCont
                         "code" in err &&
                         err.code !== "EADDRINUSE") {
                         const errorToLog = err instanceof Error ? err : new Error(String(err));
-                        logger.error("An unexpected error occurred while starting the server.", { ...attemptContext, error: errorToLog });
+                        logger.error("An unexpected error occurred while starting the server.", errorToLog, attemptContext);
                         return reject(err);
                     }
                     logger.warning(`Encountered EADDRINUSE race condition on port ${port}, retrying...`, attemptContext);
@@ -94,10 +105,8 @@ function startHttpServerWithRetry(app, initialPort, host, maxRetries, parentCont
                 }
             })
                 .catch((err) => {
-                logger.fatal("Failed to check if port is in use.", {
-                    ...attemptContext,
-                    error: err,
-                });
+                const error = err instanceof Error ? err : new Error(String(err));
+                logger.fatal("Failed to check if port is in use.", error, attemptContext);
                 reject(err);
             });
         };
@@ -145,7 +154,7 @@ export function createHttpApp(transportManager, createServerInstanceFn, parentCo
         await next();
     });
     app.use(MCP_ENDPOINT_PATH, async (c, next) => {
-        const clientIp = c.req.header("x-forwarded-for")?.split(",")[0].trim() || "unknown_ip";
+        const clientIp = getClientIp(c);
         const context = requestContextService.createRequestContext({
             operation: "httpRateLimitCheck",
             ipAddress: clientIp,
@@ -206,8 +215,15 @@ export function createHttpApp(transportManager, createServerInstanceFn, parentCo
             });
         }
         else {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            return c.json(response.body);
+            // Hono's c.json() expects a JSON-serializable object. The response.body
+            // from the transport layer is `unknown`. This check ensures we pass a valid
+            // object to c.json(). While a full serialization check (e.g., for circular
+            // references) is complex, this is a pragmatic and sufficient safeguard for
+            // the known, simple object structures returned by our tools.
+            const body = typeof response.body === "object" && response.body !== null
+                ? response.body
+                : { body: response.body };
+            return c.json(body);
         }
     });
     app.delete(MCP_ENDPOINT_PATH, async (c) => {
@@ -220,8 +236,10 @@ export function createHttpApp(transportManager, createServerInstanceFn, parentCo
         if (sessionId) {
             if (transportManager instanceof StatefulTransportManager) {
                 const response = await transportManager.handleDeleteRequest(sessionId, context);
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                return c.json(response.body, response.statusCode);
+                const body = typeof response.body === "object" && response.body !== null
+                    ? response.body
+                    : { body: response.body };
+                return c.json(body, response.statusCode);
             }
             else {
                 return c.json({
@@ -252,3 +270,4 @@ export async function startHttpTransport(createServerInstanceFn, parentContext)
     logger.info("HTTP transport started successfully.", transportContext);
     return { app, server, transportManager };
 }
+//# sourceMappingURL=httpTransport.js.map

package/dist/mcp-server/transports/http/httpTransport.js.map

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

package/dist/mcp-server/transports/http/httpTypes.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Defines custom types for the Hono HTTP transport layer.
+ * @module src/mcp-server/transports/http/httpTypes
+ */
+import type { IncomingMessage, ServerResponse } from "http";
+/**
+ * Extends Hono's Bindings to include the raw Node.js request and response objects.
+ * This is necessary for integrating with libraries like the MCP SDK that
+ * need to write directly to the response stream.
+ *
+ * As per `@hono/node-server`, the response object is available on `c.env.outgoing`.
+ */
+export type HonoNodeBindings = {
+    incoming: IncomingMessage;
+    outgoing: ServerResponse;
+};
+//# sourceMappingURL=httpTypes.d.ts.map

package/dist/mcp-server/transports/http/httpTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpTypes.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/http/httpTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,cAAc,CAAC;CAC1B,CAAC"}

package/dist/mcp-server/transports/http/httpTypes.js

@@ -3,3 +3,4 @@
  * @module src/mcp-server/transports/http/httpTypes
  */
 export {};
+//# sourceMappingURL=httpTypes.js.map

package/dist/mcp-server/transports/http/httpTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpTypes.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/http/httpTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/mcp-server/transports/http/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Barrel file for the HTTP transport module.
+ * @module src/mcp-server/transports/http/index
+ */
+export { createHttpApp, startHttpTransport } from "./httpTransport.js";
+export { httpErrorHandler } from "./httpErrorHandler.js";
+export type { HonoNodeBindings } from "./httpTypes.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/transports/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/http/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/mcp-server/transports/http/index.js

@@ -4,3 +4,4 @@
  */
 export { createHttpApp, startHttpTransport } from "./httpTransport.js";
 export { httpErrorHandler } from "./httpErrorHandler.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/transports/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/http/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/mcp-server/transports/http/mcpTransportMiddleware.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Hono middleware for handling MCP transport logic.
+ * This middleware encapsulates the logic for processing MCP requests,
+ * delegating to the appropriate transport manager, and preparing the
+ * response for Hono to send.
+ * @module src/mcp-server/transports/http/mcpTransportMiddleware
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MiddlewareHandler } from "hono";
+import { TransportManager, TransportResponse } from "../core/transportTypes.js";
+import { HonoNodeBindings } from "./httpTypes.js";
+/**
+ * Creates a Hono middleware for handling MCP POST requests.
+ * @param transportManager - The main transport manager (usually stateful).
+ * @param createServerInstanceFn - Function to create an McpServer instance.
+ * @returns A Hono middleware function.
+ */
+type McpMiddlewareEnv = {
+    Variables: {
+        mcpResponse: TransportResponse;
+    };
+};
+export declare const mcpTransportMiddleware: (transportManager: TransportManager, createServerInstanceFn: () => Promise<McpServer>) => MiddlewareHandler<McpMiddlewareEnv & {
+    Bindings: HonoNodeBindings;
+}>;
+export {};
+//# sourceMappingURL=mcpTransportMiddleware.d.ts.map

package/dist/mcp-server/transports/http/mcpTransportMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpTransportMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/http/mcpTransportMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAOzC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAuClD;;;;;GAKG;AAEH,KAAK,gBAAgB,GAAG;IACtB,SAAS,EAAE;QACT,WAAW,EAAE,iBAAiB,CAAC;KAChC,CAAC;CACH,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,kBAAkB,gBAAgB,EAClC,wBAAwB,MAAM,OAAO,CAAC,SAAS,CAAC,KAC/C,iBAAiB,CAAC,gBAAgB,GAAG;IAAE,QAAQ,EAAE,gBAAgB,CAAA;CAAE,CAmDrE,CAAC"}

package/dist/mcp-server/transports/http/mcpTransportMiddleware.js

@@ -34,30 +34,33 @@ async function handleStatelessRequest(createServerInstanceFn, headers, body, con
     const statelessManager = new StatelessTransportManager(createServerInstanceFn);
     return statelessManager.handleRequest(toIncomingHttpHeaders(headers), body, context);
 }
-export const mcpTransportMiddleware = (transportManager, createServerInstanceFn) => createMiddleware(async (c, next) => {
-    const sessionId = c.req.header("mcp-session-id");
-    const context = requestContextService.createRequestContext({
-        operation: "mcpTransportMiddleware",
-        sessionId,
-    });
-    const body = await c.req.json();
-    let response;
-    if (isInitializeRequest(body)) {
-        if (config.mcpSessionMode === "stateless") {
-            response = await handleStatelessRequest(createServerInstanceFn, c.req.raw.headers, body, context);
+export const mcpTransportMiddleware = (transportManager, createServerInstanceFn) => {
+    return createMiddleware(async (c, next) => {
+        const sessionId = c.req.header("mcp-session-id");
+        const context = requestContextService.createRequestContext({
+            operation: "mcpTransportMiddleware",
+            sessionId,
+        });
+        const body = await c.req.json();
+        let response;
+        if (isInitializeRequest(body)) {
+            if (config.mcpSessionMode === "stateless") {
+                response = await handleStatelessRequest(createServerInstanceFn, c.req.raw.headers, body, context);
+            }
+            else {
+                response = await transportManager.initializeAndHandle(toIncomingHttpHeaders(c.req.raw.headers), body, context);
+            }
         }
         else {
-            response = await transportManager.initializeAndHandle(toIncomingHttpHeaders(c.req.raw.headers), body, context);
-        }
-    }
-    else {
-        if (sessionId) {
-            response = await transportManager.handleRequest(toIncomingHttpHeaders(c.req.raw.headers), body, context, sessionId);
+            if (sessionId) {
+                response = await transportManager.handleRequest(toIncomingHttpHeaders(c.req.raw.headers), body, context, sessionId);
+            }
+            else {
+                response = await handleStatelessRequest(createServerInstanceFn, c.req.raw.headers, body, context);
+            }
         }
-        else {
-            response = await handleStatelessRequest(createServerInstanceFn, c.req.raw.headers, body, context);
-        }
-    }
-    c.set("mcpResponse", response);
-    await next();
-});
+        c.set("mcpResponse", response);
+        await next();
+    });
+};
+//# sourceMappingURL=mcpTransportMiddleware.js.map

package/dist/mcp-server/transports/http/mcpTransportMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpTransportMiddleware.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/http/mcpTransportMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAkB,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhF,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAIjF;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,OAAgB;IAC7C,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,sBAAsB,CACnC,sBAAgD,EAChD,OAAgB,EAChB,IAAa,EACb,OAAuB;IAEvB,MAAM,gBAAgB,GAAG,IAAI,yBAAyB,CACpD,sBAAsB,CACvB,CAAC;IACF,OAAO,gBAAgB,CAAC,aAAa,CACnC,qBAAqB,CAAC,OAAO,CAAC,EAC9B,IAAI,EACJ,OAAO,CACR,CAAC;AACJ,CAAC;AAeD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,gBAAkC,EAClC,sBAAgD,EACsB,EAAE;IACxE,OAAO,gBAAgB,CACrB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QAChB,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,wBAAwB;YACnC,SAAS;SACV,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,QAA2B,CAAC;QAEhC,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,IAAI,MAAM,CAAC,cAAc,KAAK,WAAW,EAAE,CAAC;gBAC1C,QAAQ,GAAG,MAAM,sBAAsB,CACrC,sBAAsB,EACtB,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EACjB,IAAI,EACJ,OAAO,CACR,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,MACT,gBACD,CAAC,mBAAmB,CACnB,qBAAqB,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EACxC,IAAI,EACJ,OAAO,CACR,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,SAAS,EAAE,CAAC;gBACd,QAAQ,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAC7C,qBAAqB,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EACxC,IAAI,EACJ,OAAO,EACP,SAAS,CACV,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,MAAM,sBAAsB,CACrC,sBAAsB,EACtB,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EACjB,IAAI,EACJ,OAAO,CACR,CAAC;YACJ,CAAC;QACH,CAAC;QAED,CAAC,CAAC,GAAG,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC/B,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/mcp-server/transports/stdio/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Barrel file for the Stdio transport module.
+ * @module src/mcp-server/transports/stdio/index
+ */
+export { startStdioTransport } from "./stdioTransport.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/transports/stdio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/stdio/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/mcp-server/transports/stdio/index.js

@@ -3,3 +3,4 @@
  * @module src/mcp-server/transports/stdio/index
  */
 export { startStdioTransport } from "./stdioTransport.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/transports/stdio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/stdio/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/mcp-server/transports/stdio/stdioTransport.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Handles the setup and connection for the Stdio MCP transport.
+ * Implements the MCP Specification 2025-03-26 for stdio transport.
+ * This transport communicates directly over standard input (stdin) and
+ * standard output (stdout), typically used when the MCP server is launched
+ * as a child process by a host application.
+ *
+ * Specification Reference:
+ * https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-03-26/basic/transports.mdx#stdio
+ *
+ * --- Authentication Note ---
+ * As per the MCP Authorization Specification (2025-03-26, Section 1.2),
+ * STDIO transports SHOULD NOT implement HTTP-based authentication flows.
+ * Authorization is typically handled implicitly by the host application
+ * controlling the server process. This implementation follows that guideline.
+ *
+ * @see {@link https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-03-26/basic/authorization.mdx | MCP Authorization Specification}
+ * @module src/mcp-server/transports/stdioTransport
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RequestContext } from "../../../utils/index.js";
+/**
+ * Connects a given `McpServer` instance to the Stdio transport.
+ * This function initializes the SDK's `StdioServerTransport`, which manages
+ * communication over `process.stdin` and `process.stdout` according to the
+ * MCP stdio transport specification.
+ *
+ * MCP Spec Points Covered by SDK's `StdioServerTransport`:
+ * - Reads JSON-RPC messages (requests, notifications, responses, batches) from stdin.
+ * - Writes JSON-RPC messages to stdout.
+ * - Handles newline delimiters and ensures no embedded newlines in output messages.
+ * - Ensures only valid MCP messages are written to stdout.
+ *
+ * Logging via the `logger` utility MAY result in output to stderr, which is
+ * permitted by the spec for logging purposes.
+ *
+ * @param server - The `McpServer` instance.
+ * @param parentContext - The logging and tracing context from the calling function.
+ * @returns A promise that resolves when the Stdio transport is successfully connected.
+ * @throws {Error} If the connection fails during setup.
+ */
+export declare function startStdioTransport(server: McpServer, parentContext: RequestContext): Promise<void>;
+//# sourceMappingURL=stdioTransport.d.ts.map

package/dist/mcp-server/transports/stdio/stdioTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdioTransport.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/stdio/stdioTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAwB,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,cAAc,GAC5B,OAAO,CAAC,IAAI,CAAC,CAoCf"}

package/dist/mcp-server/transports/stdio/stdioTransport.js

@@ -66,3 +66,4 @@ export async function startStdioTransport(server, parentContext) {
         });
     }
 }
+//# sourceMappingURL=stdioTransport.js.map

package/dist/mcp-server/transports/stdio/stdioTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdioTransport.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/stdio/stdioTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,EAAkB,MAAM,yBAAyB,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAiB,EACjB,aAA6B;IAE7B,MAAM,gBAAgB,GAAG;QACvB,GAAG,aAAa;QAChB,SAAS,EAAE,uBAAuB;QAClC,aAAa,EAAE,OAAO;KACvB,CAAC;IACF,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,gBAAgB,CAAC,CAAC;IAE1E,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE,gBAAgB,CAAC,CAAC;QAC5E,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,MAAM,CAAC,KAAK,CACV,0DAA0D,EAC1D,gBAAgB,CACjB,CAAC;QACF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,MAAM,CAAC,IAAI,CACT,yDAAyD,EACzD,gBAAgB,CACjB,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CACT,qFAAqF,CACtF,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,qEAAqE;QACrE,MAAM,YAAY,CAAC,WAAW,CAAC,GAAG,EAAE;YAClC,SAAS,EAAE,uBAAuB;YAClC,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/types-global/errors.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @fileoverview Defines standardized error codes, a custom error class, and related schemas
+ * for handling errors within the Model Context Protocol (MCP) server and its components.
+ * This module provides a structured way to represent and communicate errors, ensuring
+ * consistency and clarity for both server-side operations and client-side error handling.
+ * @module src/types-global/errors
+ */
+import { z } from "zod";
+/**
+ * Defines a comprehensive set of standardized error codes for common issues encountered
+ * within MCP servers, tools, or related operations. These codes are designed to help
+ * clients and developers programmatically understand the nature of an error, facilitating
+ * more precise error handling and debugging.
+ */
+export declare enum BaseErrorCode {
+    /** Access denied due to invalid credentials or lack of authentication. */
+    UNAUTHORIZED = "UNAUTHORIZED",
+    /** Access denied despite valid authentication, due to insufficient permissions. */
+    FORBIDDEN = "FORBIDDEN",
+    /** The requested resource or entity could not be found. */
+    NOT_FOUND = "NOT_FOUND",
+    /** The request could not be completed due to a conflict with the current state of the resource. */
+    CONFLICT = "CONFLICT",
+    /** The request failed due to invalid input parameters or data. */
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    /** The provided input is invalid for the operation. */
+    INVALID_INPUT = "INVALID_INPUT",
+    /** An error occurred while parsing input data (e.g., date string, JSON). */
+    PARSING_ERROR = "PARSING_ERROR",
+    /** The request was rejected because the client has exceeded rate limits. */
+    RATE_LIMITED = "RATE_LIMITED",
+    /** The request timed out before a response could be generated. */
+    TIMEOUT = "TIMEOUT",
+    /** The service is temporarily unavailable, possibly due to maintenance or overload. */
+    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
+    /** An unexpected error occurred on the server side. */
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    /** An error occurred, but the specific cause is unknown or cannot be categorized. */
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    /** An error occurred during the loading or validation of configuration data. */
+    CONFIGURATION_ERROR = "CONFIGURATION_ERROR",
+    /** An error occurred during the initialization phase of a service or module. */
+    INITIALIZATION_FAILED = "INITIALIZATION_FAILED",
+    /** A service was used before it was properly initialized. */
+    SERVICE_NOT_INITIALIZED = "SERVICE_NOT_INITIALIZED",
+    /** A generic error occurred during a database operation. */
+    DATABASE_ERROR = "DATABASE_ERROR",
+    /** An error occurred while loading or interacting with an extension. */
+    EXTENSION_ERROR = "EXTENSION_ERROR",
+    /** An error occurred during the shutdown phase of a service or module. */
+    SHUTDOWN_ERROR = "SHUTDOWN_ERROR",
+    /** A generic error occurred during the execution of an agent's task. */
+    AGENT_EXECUTION_ERROR = "AGENT_EXECUTION_ERROR"
+}
+/**
+ * Custom error class for MCP-specific errors, extending the built-in `Error` class.
+ * It standardizes error reporting by encapsulating a `BaseErrorCode`, a descriptive
+ * human-readable message, and optional structured details for more context.
+ *
+ * This class is central to error handling within the MCP framework, allowing for
+ * consistent error creation and propagation.
+ */
+export declare class McpError extends Error {
+    /**
+     * The standardized error code from {@link BaseErrorCode}.
+     */
+    readonly code: BaseErrorCode;
+    /**
+     * Optional additional details or context about the error.
+     * This can be any structured data that helps in understanding or debugging the error.
+     */
+    readonly details?: Record<string, unknown>;
+    /**
+     * Creates an instance of McpError.
+     *
+     * @param code - The standardized error code that categorizes the error.
+     * @param message - A human-readable description of the error.
+     * @param details - Optional. A record containing additional structured details about the error.
+     */
+    constructor(code: BaseErrorCode, message: string, details?: Record<string, unknown>);
+}
+/**
+ * Zod schema for validating error objects. This schema can be used for:
+ * - Validating error structures when parsing error responses from external services.
+ * - Ensuring consistency when creating or handling error objects internally.
+ * - Generating TypeScript types for error objects.
+ *
+ * The schema enforces the presence of a `code` (from {@link BaseErrorCode}) and a `message`,
+ * and allows for optional `details`.
+ */
+export declare const ErrorSchema: z.ZodObject<{
+    /**
+     * The error code, corresponding to one of the {@link BaseErrorCode} enum values.
+     * This field is required and helps in programmatically identifying the error type.
+     */
+    code: z.ZodNativeEnum<typeof BaseErrorCode>;
+    /**
+     * A human-readable, descriptive message explaining the error.
+     * This field is required and provides context to developers or users.
+     */
+    message: z.ZodString;
+    /**
+     * Optional. A record containing additional structured details or context about the error.
+     * This can include things like invalid field names, specific values that caused issues, or other relevant data.
+     */
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    code: BaseErrorCode;
+    message: string;
+    details?: Record<string, unknown> | undefined;
+}, {
+    code: BaseErrorCode;
+    message: string;
+    details?: Record<string, unknown> | undefined;
+}>;
+/**
+ * TypeScript type inferred from the {@link ErrorSchema}.
+ * This type represents the structure of a validated error object, commonly used
+ * for error responses or when passing error information within the application.
+ */
+export type ErrorResponse = z.infer<typeof ErrorSchema>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types-global/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types-global/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,oBAAY,aAAa;IACvB,0EAA0E;IAC1E,YAAY,iBAAiB;IAC7B,mFAAmF;IACnF,SAAS,cAAc;IACvB,2DAA2D;IAC3D,SAAS,cAAc;IACvB,mGAAmG;IACnG,QAAQ,aAAa;IACrB,kEAAkE;IAClE,gBAAgB,qBAAqB;IACrC,uDAAuD;IACvD,aAAa,kBAAkB;IAC/B,4EAA4E;IAC5E,aAAa,kBAAkB;IAC/B,4EAA4E;IAC5E,YAAY,iBAAiB;IAC7B,kEAAkE;IAClE,OAAO,YAAY;IACnB,uFAAuF;IACvF,mBAAmB,wBAAwB;IAC3C,uDAAuD;IACvD,cAAc,mBAAmB;IACjC,qFAAqF;IACrF,aAAa,kBAAkB;IAC/B,gFAAgF;IAChF,mBAAmB,wBAAwB;IAC3C,gFAAgF;IAChF,qBAAqB,0BAA0B;IAC/C,6DAA6D;IAC7D,uBAAuB,4BAA4B;IACnD,4DAA4D;IAC5D,cAAc,mBAAmB;IACjC,wEAAwE;IACxE,eAAe,oBAAoB;IACnC,0EAA0E;IAC1E,cAAc,mBAAmB;IACjC,wEAAwE;IACxE,qBAAqB,0BAA0B;CAChD;AAED;;;;;;;GAOG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC;;OAEG;IACH,SAAgB,IAAI,EAAE,aAAa,CAAC;IAEpC;;;OAGG;IACH,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElD;;;;;;OAMG;gBAED,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAgBpC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;IAEpB;;;OAGG;;IAIH;;;OAGG;;IAKH;;;OAGG;;;;;;;;;;EAUJ,CAAC;AAEJ;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/types-global/errors.js

@@ -127,3 +127,4 @@ export const ErrorSchema = z
         .describe("Optional structured details providing more context about the error"),
 })
     .describe("Schema for validating structured error objects, ensuring consistency in error reporting.");
+//# sourceMappingURL=errors.js.map

package/dist/types-global/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types-global/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAN,IAAY,aAuCX;AAvCD,WAAY,aAAa;IACvB,0EAA0E;IAC1E,8CAA6B,CAAA;IAC7B,mFAAmF;IACnF,wCAAuB,CAAA;IACvB,2DAA2D;IAC3D,wCAAuB,CAAA;IACvB,mGAAmG;IACnG,sCAAqB,CAAA;IACrB,kEAAkE;IAClE,sDAAqC,CAAA;IACrC,uDAAuD;IACvD,gDAA+B,CAAA;IAC/B,4EAA4E;IAC5E,gDAA+B,CAAA;IAC/B,4EAA4E;IAC5E,8CAA6B,CAAA;IAC7B,kEAAkE;IAClE,oCAAmB,CAAA;IACnB,uFAAuF;IACvF,4DAA2C,CAAA;IAC3C,uDAAuD;IACvD,kDAAiC,CAAA;IACjC,qFAAqF;IACrF,gDAA+B,CAAA;IAC/B,gFAAgF;IAChF,4DAA2C,CAAA;IAC3C,gFAAgF;IAChF,gEAA+C,CAAA;IAC/C,6DAA6D;IAC7D,oEAAmD,CAAA;IACnD,4DAA4D;IAC5D,kDAAiC,CAAA;IACjC,wEAAwE;IACxE,oDAAmC,CAAA;IACnC,0EAA0E;IAC1E,kDAAiC,CAAA;IACjC,wEAAwE;IACxE,gEAA+C,CAAA;AACjD,CAAC,EAvCW,aAAa,KAAb,aAAa,QAuCxB;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC;;OAEG;IACa,IAAI,CAAgB;IAEpC;;;OAGG;IACa,OAAO,CAA2B;IAElD;;;;;;OAMG;IACH,YACE,IAAmB,EACnB,OAAe,EACf,OAAiC;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QAEvB,qCAAqC;QACrC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEhD,iFAAiF;QACjF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,CAAC;IACN;;;OAGG;IACH,IAAI,EAAE,CAAC;SACJ,UAAU,CAAC,aAAa,CAAC;SACzB,QAAQ,CAAC,iDAAiD,CAAC;IAC9D;;;OAGG;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;SACxC,QAAQ,CAAC,uCAAuC,CAAC;IACpD;;;OAGG;IACH,OAAO,EAAE,CAAC;SACP,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CACP,oEAAoE,CACrE;CACJ,CAAC;KACD,QAAQ,CACP,0FAA0F,CAC3F,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./internal/index.js";
+export * from "./parsing/index.js";
+export * from "./security/index.js";
+export * from "./metrics/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/utils/index.js

@@ -10,3 +10,4 @@ export * from "./metrics/index.js";
 // export * from './internal/errorHandler.js';
 // export * from './internal/logger.js';
 // ... etc.
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAEnC,iEAAiE;AACjE,8CAA8C;AAC9C,mDAAmD;AACnD,qEAAqE;AACrE,8CAA8C;AAC9C,wCAAwC;AACxC,WAAW"}

package/dist/utils/internal/errorHandler.d.ts

@@ -0,0 +1,91 @@
+import { BaseErrorCode } from "../../types-global/errors.js";
+/**
+ * Generic error context interface
+ */
+export interface ErrorContext {
+    /** Unique request or operation identifier */
+    requestId?: string;
+    /** Any additional context information */
+    [key: string]: unknown;
+}
+/**
+ * Error handler options
+ */
+export interface ErrorHandlerOptions {
+    /** The context of the operation that caused the error */
+    context?: ErrorContext;
+    /** The name of the operation being performed */
+    operation: string;
+    /** The input that caused the error */
+    input?: unknown;
+    /** Whether to rethrow the error after handling */
+    rethrow?: boolean;
+    /** Custom error code to use when creating an McpError */
+    errorCode?: BaseErrorCode;
+    /** Custom error mapper function */
+    errorMapper?: (error: unknown) => Error;
+    /** Whether to include stack traces in logs */
+    includeStack?: boolean;
+    /** Whether this is a critical error that should abort operations */
+    critical?: boolean;
+}
+/**
+ * Base error mapping rule
+ */
+export interface BaseErrorMapping {
+    /** Pattern to match in the error message */
+    pattern: string | RegExp;
+    /** Error code for mapped errors */
+    errorCode: BaseErrorCode;
+    /** Custom error message template */
+    messageTemplate?: string;
+}
+/**
+ * Error mapping configuration
+ */
+export interface ErrorMapping<T extends Error = Error> extends BaseErrorMapping {
+    /** Factory function to create the mapped error */
+    factory: (error: unknown, context?: Record<string, unknown>) => T;
+    /** Additional context to merge with error context */
+    additionalContext?: Record<string, unknown>;
+}
+/**
+ * Error handler utility class with various error handling methods
+ */
+export declare class ErrorHandler {
+    /**
+     * Determine the appropriate error code for an error based on patterns and type
+     * @param error The error to classify
+     * @returns The appropriate error code
+     */
+    static determineErrorCode(error: unknown): BaseErrorCode;
+    /**
+     * Handle operation errors with consistent logging and transformation
+     * @param error The error that occurred
+     * @param options Error handling options
+     * @returns The transformed error
+     */
+    static handleError(error: unknown, options: ErrorHandlerOptions): Error;
+    /**
+     * Map an error to a specific error type based on error message patterns
+     * @param error The error to map
+     * @param mappings Array of pattern and factory mappings
+     * @param defaultFactory Default factory function if no pattern matches
+     * @returns The mapped error
+     */
+    static mapError<T extends Error>(error: unknown, mappings: ErrorMapping<T>[], defaultFactory?: (error: unknown, context?: Record<string, unknown>) => T): T | Error;
+    /**
+     * Format an error for consistent response structure
+     * @param error The error to format
+     * @returns Formatted error object
+     */
+    static formatError(error: unknown): Record<string, unknown>;
+    /**
+     * Safely execute a function and handle any errors
+     * @param fn Function to execute
+     * @param options Error handling options
+     * @returns The result of the function or error
+     */
+    static tryCatch<T>(fn: () => Promise<T> | T, options: ErrorHandlerOptions): Promise<T>;
+}
+//# sourceMappingURL=errorHandler.d.ts.map

package/dist/utils/internal/errorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../../src/utils/internal/errorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAY,MAAM,8BAA8B,CAAC;AAIvE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,mCAAmC;IACnC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC;IACxC,8CAA8C;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,mCAAmC;IACnC,SAAS,EAAE,aAAa,CAAC;IACzB,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,CACnD,SAAQ,gBAAgB;IACxB,kDAAkD;IAClD,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAClE,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAuGD;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;OAIG;WACW,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa;IAgC/D;;;;;OAKG;WACW,WAAW,CACvB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,mBAAmB,GAC3B,KAAK;IAoFR;;;;;;OAMG;WACW,QAAQ,CAAC,CAAC,SAAS,KAAK,EACpC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC3B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,GACxE,CAAC,GAAG,KAAK;IAiCZ;;;;OAIG;WACW,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA4BlE;;;;;OAKG;WACiB,QAAQ,CAAC,CAAC,EAC5B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC;CAOd"}