easy-mcp-nest 0.3.0 → 0.4.0

package/dist/core/resilience/circuit-breaker.service.js

@@ -0,0 +1,117 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreakerService = void 0;
+const common_1 = require("@nestjs/common");
+const logger_util_1 = require("../utils/logger.util");
+const DEFAULT_CONFIG = {
+    errorThreshold: 0.5,
+    timeWindow: 60000,
+    minRequests: 10,
+    halfOpenTimeout: 30000,
+};
+let CircuitBreakerService = class CircuitBreakerService {
+    circuits = new Map();
+    configs = new Map();
+    getCircuit(toolName, config) {
+        if (!this.circuits.has(toolName)) {
+            this.circuits.set(toolName, {
+                state: "closed",
+                failures: 0,
+                successes: 0,
+            });
+            this.configs.set(toolName, config || DEFAULT_CONFIG);
+        }
+        return this.circuits.get(toolName);
+    }
+    isOpen(toolName, config) {
+        const circuit = this.getCircuit(toolName, config);
+        const now = Date.now();
+        if (circuit.state === "half-open" && circuit.nextAttemptTime && now < circuit.nextAttemptTime) {
+            return false;
+        }
+        if (circuit.state === "open") {
+            const cfg = this.configs.get(toolName) || config || DEFAULT_CONFIG;
+            if (circuit.nextAttemptTime && now >= circuit.nextAttemptTime) {
+                circuit.state = "half-open";
+                circuit.failures = 0;
+                circuit.successes = 0;
+                logger_util_1.logger.info("CircuitBreakerService", `Circuit half-open for ${toolName}`, {
+                    component: "Resilience",
+                    toolName,
+                });
+                return false;
+            }
+            return true;
+        }
+        return false;
+    }
+    recordSuccess(toolName) {
+        const circuit = this.getCircuit(toolName);
+        circuit.successes++;
+        circuit.lastSuccessTime = Date.now();
+        if (circuit.state === "half-open") {
+            circuit.state = "closed";
+            circuit.failures = 0;
+            circuit.successes = 0;
+            circuit.nextAttemptTime = undefined;
+            logger_util_1.logger.info("CircuitBreakerService", `Circuit closed for ${toolName}`, {
+                component: "Resilience",
+                toolName,
+            });
+        }
+    }
+    recordFailure(toolName) {
+        const circuit = this.getCircuit(toolName);
+        const config = this.configs.get(toolName) || DEFAULT_CONFIG;
+        circuit.failures++;
+        circuit.lastFailureTime = Date.now();
+        const total = circuit.failures + circuit.successes;
+        const errorRate = circuit.failures / total;
+        if (circuit.state === "closed" &&
+            total >= config.minRequests &&
+            errorRate >= config.errorThreshold) {
+            circuit.state = "open";
+            circuit.nextAttemptTime = Date.now() + config.halfOpenTimeout;
+            logger_util_1.logger.warn("CircuitBreakerService", `Circuit opened for ${toolName}`, {
+                component: "Resilience",
+                toolName,
+                errorRate,
+                failures: circuit.failures,
+                total,
+            });
+        }
+        else if (circuit.state === "half-open") {
+            circuit.state = "open";
+            circuit.nextAttemptTime = Date.now() + config.halfOpenTimeout;
+            logger_util_1.logger.warn("CircuitBreakerService", `Circuit re-opened for ${toolName}`, {
+                component: "Resilience",
+                toolName,
+            });
+        }
+    }
+    getState(toolName) {
+        const circuit = this.getCircuit(toolName);
+        return circuit.state;
+    }
+    reset(toolName) {
+        if (toolName) {
+            this.circuits.delete(toolName);
+            this.configs.delete(toolName);
+        }
+        else {
+            this.circuits.clear();
+            this.configs.clear();
+        }
+    }
+};
+exports.CircuitBreakerService = CircuitBreakerService;
+exports.CircuitBreakerService = CircuitBreakerService = __decorate([
+    (0, common_1.Injectable)()
+], CircuitBreakerService);
+//# sourceMappingURL=circuit-breaker.service.js.map

package/dist/core/resilience/circuit-breaker.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.service.js","sourceRoot":"","sources":["../../../src/core/resilience/circuit-breaker.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAM5C,sDAA8C;AAK9C,MAAM,cAAc,GAAyB;IAC3C,cAAc,EAAE,GAAG;IACnB,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,EAAE;IACf,eAAe,EAAE,KAAK;CACvB,CAAC;AAMK,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IACxB,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;IAClD,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;IAKlD,UAAU,CAAC,QAAgB,EAAE,MAA6B;QAChE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE;gBAC1B,KAAK,EAAE,QAAQ;gBACf,QAAQ,EAAE,CAAC;gBACX,SAAS,EAAE,CAAC;aACb,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,cAAc,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;IACtC,CAAC;IAKD,MAAM,CAAC,QAAgB,EAAE,MAA6B;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAGvB,IAAI,OAAO,CAAC,KAAK,KAAK,WAAW,IAAI,OAAO,CAAC,eAAe,IAAI,GAAG,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;YAC9F,OAAO,KAAK,CAAC;QACf,CAAC;QAGD,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,MAAM,IAAI,cAAc,CAAC;YACnE,IAAI,OAAO,CAAC,eAAe,IAAI,GAAG,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;gBAC9D,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC;gBAC5B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;gBACtB,oBAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,yBAAyB,QAAQ,EAAE,EAAE;oBACxE,SAAS,EAAE,YAAY;oBACvB,QAAQ;iBACT,CAAC,CAAC;gBACH,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAKD,aAAa,CAAC,QAAgB;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAGrC,IAAI,OAAO,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;YACzB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;YACtB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;YACpC,oBAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,sBAAsB,QAAQ,EAAE,EAAE;gBACrE,SAAS,EAAE,YAAY;gBACvB,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAKD,aAAa,CAAC,QAAgB;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,cAAc,CAAC;QAC5D,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAErC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;QACnD,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC;QAG3C,IACE,OAAO,CAAC,KAAK,KAAK,QAAQ;YAC1B,KAAK,IAAI,MAAM,CAAC,WAAW;YAC3B,SAAS,IAAI,MAAM,CAAC,cAAc,EAClC,CAAC;YACD,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC;YACvB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,eAAe,CAAC;YAC9D,oBAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,sBAAsB,QAAQ,EAAE,EAAE;gBACrE,SAAS,EAAE,YAAY;gBACvB,QAAQ;gBACR,SAAS;gBACT,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,KAAK;aACN,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,OAAO,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAEzC,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC;YACvB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,eAAe,CAAC;YAC9D,oBAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,yBAAyB,QAAQ,EAAE,EAAE;gBACxE,SAAS,EAAE,YAAY;gBACvB,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAKD,QAAQ,CAAC,QAAgB;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,OAAO,CAAC,KAAK,CAAC;IACvB,CAAC;IAKD,KAAK,CAAC,QAAiB;QACrB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;CACF,CAAA;AAjIY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;GACA,qBAAqB,CAiIjC"}

package/dist/core/resilience/retry.service.d.ts

@@ -0,0 +1,6 @@
+import { RetryConfig } from "../../decorators/mcp-tool.decorator";
+export declare class RetryService {
+    executeWithRetry<T>(fn: () => Promise<T>, config: RetryConfig): Promise<T>;
+    private calculateDelay;
+    private sleep;
+}

package/dist/core/resilience/retry.service.js

@@ -0,0 +1,66 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryService = void 0;
+const common_1 = require("@nestjs/common");
+const logger_util_1 = require("../utils/logger.util");
+let RetryService = class RetryService {
+    async executeWithRetry(fn, config) {
+        let lastError;
+        const initialDelay = config.initialDelay || 100;
+        const maxDelay = config.maxDelay || 10000;
+        for (let attempt = 0; attempt < config.maxAttempts; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (attempt === config.maxAttempts - 1) {
+                    throw lastError;
+                }
+                const delay = this.calculateDelay(attempt, initialDelay, maxDelay, config.backoff);
+                logger_util_1.logger.debug("RetryService", `Retry attempt ${attempt + 1}/${config.maxAttempts}`, {
+                    component: "Resilience",
+                    attempt: attempt + 1,
+                    maxAttempts: config.maxAttempts,
+                    delay,
+                    error: lastError.message,
+                });
+                await this.sleep(delay);
+            }
+        }
+        throw lastError || new Error("Retry failed");
+    }
+    calculateDelay(attempt, initialDelay, maxDelay, strategy) {
+        let delay;
+        switch (strategy) {
+            case "exponential":
+                delay = initialDelay * Math.pow(2, attempt);
+                break;
+            case "linear":
+                delay = initialDelay * (attempt + 1);
+                break;
+            case "fixed":
+                delay = initialDelay;
+                break;
+            default:
+                delay = initialDelay;
+        }
+        const jitter = delay * 0.2 * Math.random();
+        delay = delay + jitter;
+        return Math.min(delay, maxDelay);
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+};
+exports.RetryService = RetryService;
+exports.RetryService = RetryService = __decorate([
+    (0, common_1.Injectable)()
+], RetryService);
+//# sourceMappingURL=retry.service.js.map

package/dist/core/resilience/retry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.service.js","sourceRoot":"","sources":["../../../src/core/resilience/retry.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAE5C,sDAA8C;AAMvC,IAAM,YAAY,GAAlB,MAAM,YAAY;IAIvB,KAAK,CAAC,gBAAgB,CACpB,EAAoB,EACpB,MAAmB;QAEnB,IAAI,SAA4B,CAAC;QACjC,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,GAAG,CAAC;QAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC;QAE1C,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YAC9D,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,EAAE,CAAC;YACpB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAGtE,IAAI,OAAO,KAAK,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;oBACvC,MAAM,SAAS,CAAC;gBAClB,CAAC;gBAGD,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBAEnF,oBAAM,CAAC,KAAK,CAAC,cAAc,EAAE,iBAAiB,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE;oBACjF,SAAS,EAAE,YAAY;oBACvB,OAAO,EAAE,OAAO,GAAG,CAAC;oBACpB,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,KAAK;oBACL,KAAK,EAAE,SAAS,CAAC,OAAO;iBACzB,CAAC,CAAC;gBAEH,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;IAC/C,CAAC;IAKO,cAAc,CACpB,OAAe,EACf,YAAoB,EACpB,QAAgB,EAChB,QAA4C;QAE5C,IAAI,KAAa,CAAC;QAElB,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,aAAa;gBAChB,KAAK,GAAG,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBAC5C,MAAM;YACR,KAAK,QAAQ;gBACX,KAAK,GAAG,YAAY,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;gBACrC,MAAM;YACR,KAAK,OAAO;gBACV,KAAK,GAAG,YAAY,CAAC;gBACrB,MAAM;YACR;gBACE,KAAK,GAAG,YAAY,CAAC;QACzB,CAAC;QAGD,MAAM,MAAM,GAAG,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3C,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;QAGvB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAKO,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF,CAAA;AAhFY,oCAAY;uBAAZ,YAAY;IADxB,IAAA,mBAAU,GAAE;GACA,YAAY,CAgFxB"}

package/dist/core/utils/decorator-scanner.d.ts

@@ -0,0 +1,4 @@
+import "reflect-metadata";
+import { ToolDefinition } from "../../tooling/tool.interface";
+export declare function scanClassForTools(targetClass: new (...args: any[]) => any, instance?: any): ToolDefinition[];
+export declare function scanClassesForTools(classes: Array<new (...args: any[]) => any>, instances?: Map<new (...args: any[]) => any, any>): ToolDefinition[];

package/dist/core/utils/decorator-scanner.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanClassForTools = scanClassForTools;
+exports.scanClassesForTools = scanClassesForTools;
+require("reflect-metadata");
+const mcp_tool_decorator_1 = require("../../decorators/mcp-tool.decorator");
+const mcp_param_decorator_1 = require("../../decorators/mcp-param.decorator");
+const mcp_context_decorator_1 = require("../../decorators/mcp-context.decorator");
+const mcp_service_decorator_1 = require("../../decorators/mcp-service.decorator");
+const zod_integration_1 = require("../../validation/zod-integration");
+const logger_util_1 = require("./logger.util");
+function scanClassForTools(targetClass, instance) {
+    const tools = [];
+    const classInstance = instance || new targetClass();
+    const toolMethods = (0, mcp_tool_decorator_1.getToolMethods)(targetClass.prototype);
+    for (const toolMetadata of toolMethods) {
+        const methodName = toolMetadata.methodName;
+        const method = classInstance[methodName];
+        if (typeof method !== "function") {
+            logger_util_1.logger.warn("DecoratorScanner", `Method ${methodName} is not a function`, {
+                component: "DecoratorScanner",
+                className: targetClass.name,
+                methodName,
+            });
+            continue;
+        }
+        const paramSchemasMap = (0, mcp_param_decorator_1.getAllParamSchemas)(classInstance, methodName);
+        const contextParamIndices = (0, mcp_context_decorator_1.getContextParameterIndices)(classInstance, methodName);
+        const serviceFactories = (0, mcp_service_decorator_1.getServiceFactories)(classInstance, methodName);
+        let inputSchema = {
+            type: "object",
+            properties: {},
+            required: [],
+        };
+        if (paramSchemasMap.size > 0) {
+            const firstSchema = paramSchemasMap.get(0);
+            if (firstSchema) {
+                const jsonSchema = (0, zod_integration_1.zodToJsonSchema)(firstSchema);
+                if (jsonSchema.type === "object") {
+                    inputSchema = jsonSchema;
+                }
+                else {
+                    inputSchema = {
+                        type: "object",
+                        properties: {
+                            value: jsonSchema,
+                        },
+                        required: ["value"],
+                    };
+                }
+            }
+        }
+        const execute = async (args, cancellationToken, context) => {
+            const methodArgs = [];
+            const originalMethod = classInstance[methodName].bind(classInstance);
+            const paramSchemasArray = Array.from(paramSchemasMap.entries()).sort((a, b) => a[0] - b[0]);
+            for (const [paramIndex, schema] of paramSchemasArray) {
+                if (paramIndex === 0) {
+                    methodArgs.push(args);
+                }
+                else {
+                    methodArgs.push(undefined);
+                }
+            }
+            for (const contextIndex of contextParamIndices) {
+                while (methodArgs.length <= contextIndex) {
+                    methodArgs.push(undefined);
+                }
+                methodArgs[contextIndex] = context;
+            }
+            for (const factoryInfo of serviceFactories) {
+                while (methodArgs.length <= factoryInfo.index) {
+                    methodArgs.push(undefined);
+                }
+                methodArgs[factoryInfo.index] = factoryInfo.factory();
+            }
+            if (methodArgs.length === 0) {
+                methodArgs.push(args);
+                if (cancellationToken) {
+                    methodArgs.push(cancellationToken);
+                }
+                if (context) {
+                    methodArgs.push(context);
+                }
+            }
+            return await originalMethod(...methodArgs);
+        };
+        const toolDefinition = {
+            name: toolMetadata.name,
+            description: toolMetadata.description,
+            execute,
+            inputSchema,
+            icon: toolMetadata.icon,
+            requiredScopes: toolMetadata.requiredScopes,
+            rateLimit: toolMetadata.rateLimit,
+            retry: toolMetadata.retry,
+            version: toolMetadata.version,
+        };
+        tools.push(toolDefinition);
+    }
+    return tools;
+}
+function scanClassesForTools(classes, instances) {
+    const allTools = [];
+    for (const targetClass of classes) {
+        const instance = instances?.get(targetClass);
+        const tools = scanClassForTools(targetClass, instance);
+        allTools.push(...tools);
+    }
+    return allTools;
+}
+//# sourceMappingURL=decorator-scanner.js.map

package/dist/core/utils/decorator-scanner.js.map

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

package/dist/core/utils/sanitize.util.d.ts

@@ -8,3 +8,4 @@ export declare function sanitizeFilePath(filePath: string): string;
 export declare function sanitizeUri(uri: string): string;
 export declare function sanitizeName(name: string): string;
 export declare function sanitizeActorId(actorId: string | undefined): string;
+export declare function hashRateLimitIdentifier(identifier: string): string;

package/dist/core/utils/sanitize.util.js

@@ -10,6 +10,7 @@ exports.sanitizeFilePath = sanitizeFilePath;
 exports.sanitizeUri = sanitizeUri;
 exports.sanitizeName = sanitizeName;
 exports.sanitizeActorId = sanitizeActorId;
+exports.hashRateLimitIdentifier = hashRateLimitIdentifier;
 const DANGEROUS_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
 function isSafeObjectKey(key) {
     if (typeof key !== 'string') {
@@ -188,4 +189,22 @@ function sanitizeActorId(actorId) {
         return 'anonymous';
     }
 }
+function hashRateLimitIdentifier(identifier) {
+    if (!identifier || typeof identifier !== 'string') {
+        return 'anonymous';
+    }
+    try {
+        const normalized = identifier.trim().toLowerCase();
+        let hash = 0;
+        for (let i = 0; i < normalized.length; i++) {
+            const char = normalized.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash;
+        }
+        return `rl:${Math.abs(hash).toString(36)}`;
+    }
+    catch {
+        return 'anonymous';
+    }
+}
 //# sourceMappingURL=sanitize.util.js.map

package/dist/core/utils/sanitize.util.js.map

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

package/dist/decorators/index.d.ts

@@ -2,3 +2,6 @@ export { McpContext, getContextParameterIndices } from "./mcp-context.decorator"
 export { McpService, getServiceFactories } from "./mcp-service.decorator";
 export { createFactoryProvider } from "./factory-provider";
 export { McpParam, getParamSchema, getAllParamSchemas, getParamSchemasAsJsonSchema } from "./mcp-param.decorator";
+export { McpTool, getToolMetadata, getToolMethods, isToolMethod, type McpToolOptions, type RateLimitConfig, type RetryConfig, type ToolMethodMetadata, } from "./mcp-tool.decorator";
+export { McpErrorHandler, getErrorHandler } from "./mcp-error-handler.decorator";
+export { McpMiddleware, getMiddlewares } from "./mcp-middleware.decorator";

package/dist/decorators/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getParamSchemasAsJsonSchema = exports.getAllParamSchemas = exports.getParamSchema = exports.McpParam = exports.createFactoryProvider = exports.getServiceFactories = exports.McpService = exports.getContextParameterIndices = exports.McpContext = void 0;
+exports.getMiddlewares = exports.McpMiddleware = exports.getErrorHandler = exports.McpErrorHandler = exports.isToolMethod = exports.getToolMethods = exports.getToolMetadata = exports.McpTool = exports.getParamSchemasAsJsonSchema = exports.getAllParamSchemas = exports.getParamSchema = exports.McpParam = exports.createFactoryProvider = exports.getServiceFactories = exports.McpService = exports.getContextParameterIndices = exports.McpContext = void 0;
 var mcp_context_decorator_1 = require("./mcp-context.decorator");
 Object.defineProperty(exports, "McpContext", { enumerable: true, get: function () { return mcp_context_decorator_1.McpContext; } });
 Object.defineProperty(exports, "getContextParameterIndices", { enumerable: true, get: function () { return mcp_context_decorator_1.getContextParameterIndices; } });
@@ -14,4 +14,15 @@ Object.defineProperty(exports, "McpParam", { enumerable: true, get: function ()
 Object.defineProperty(exports, "getParamSchema", { enumerable: true, get: function () { return mcp_param_decorator_1.getParamSchema; } });
 Object.defineProperty(exports, "getAllParamSchemas", { enumerable: true, get: function () { return mcp_param_decorator_1.getAllParamSchemas; } });
 Object.defineProperty(exports, "getParamSchemasAsJsonSchema", { enumerable: true, get: function () { return mcp_param_decorator_1.getParamSchemasAsJsonSchema; } });
+var mcp_tool_decorator_1 = require("./mcp-tool.decorator");
+Object.defineProperty(exports, "McpTool", { enumerable: true, get: function () { return mcp_tool_decorator_1.McpTool; } });
+Object.defineProperty(exports, "getToolMetadata", { enumerable: true, get: function () { return mcp_tool_decorator_1.getToolMetadata; } });
+Object.defineProperty(exports, "getToolMethods", { enumerable: true, get: function () { return mcp_tool_decorator_1.getToolMethods; } });
+Object.defineProperty(exports, "isToolMethod", { enumerable: true, get: function () { return mcp_tool_decorator_1.isToolMethod; } });
+var mcp_error_handler_decorator_1 = require("./mcp-error-handler.decorator");
+Object.defineProperty(exports, "McpErrorHandler", { enumerable: true, get: function () { return mcp_error_handler_decorator_1.McpErrorHandler; } });
+Object.defineProperty(exports, "getErrorHandler", { enumerable: true, get: function () { return mcp_error_handler_decorator_1.getErrorHandler; } });
+var mcp_middleware_decorator_1 = require("./mcp-middleware.decorator");
+Object.defineProperty(exports, "McpMiddleware", { enumerable: true, get: function () { return mcp_middleware_decorator_1.McpMiddleware; } });
+Object.defineProperty(exports, "getMiddlewares", { enumerable: true, get: function () { return mcp_middleware_decorator_1.getMiddlewares; } });
 //# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;AAAA,iEAAiF;AAAxE,mHAAA,UAAU,OAAA;AAAE,mIAAA,0BAA0B,OAAA;AAC/C,iEAA0E;AAAjE,mHAAA,UAAU,OAAA;AAAE,4HAAA,mBAAmB,OAAA;AACxC,uDAA2D;AAAlD,yHAAA,qBAAqB,OAAA;AAC9B,6DAAkH;AAAzG,+GAAA,QAAQ,OAAA;AAAE,qHAAA,cAAc,OAAA;AAAE,yHAAA,kBAAkB,OAAA;AAAE,kIAAA,2BAA2B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;AAAA,iEAAiF;AAAxE,mHAAA,UAAU,OAAA;AAAE,mIAAA,0BAA0B,OAAA;AAC/C,iEAA0E;AAAjE,mHAAA,UAAU,OAAA;AAAE,4HAAA,mBAAmB,OAAA;AACxC,uDAA2D;AAAlD,yHAAA,qBAAqB,OAAA;AAC9B,6DAAkH;AAAzG,+GAAA,QAAQ,OAAA;AAAE,qHAAA,cAAc,OAAA;AAAE,yHAAA,kBAAkB,OAAA;AAAE,kIAAA,2BAA2B,OAAA;AAClF,2DAS8B;AAR5B,6GAAA,OAAO,OAAA;AACP,qHAAA,eAAe,OAAA;AACf,oHAAA,cAAc,OAAA;AACd,kHAAA,YAAY,OAAA;AAMd,6EAAiF;AAAxE,8HAAA,eAAe,OAAA;AAAE,8HAAA,eAAe,OAAA;AACzC,uEAA2E;AAAlE,yHAAA,aAAa,OAAA;AAAE,0HAAA,cAAc,OAAA"}

package/dist/decorators/mcp-error-handler.decorator.d.ts

@@ -0,0 +1,4 @@
+import "reflect-metadata";
+import { ErrorHandler } from "../core/errors/error-handler.interface";
+export declare function McpErrorHandler(handler: ErrorHandler): ClassDecorator;
+export declare function getErrorHandler(target: any): ErrorHandler | undefined;

package/dist/decorators/mcp-error-handler.decorator.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpErrorHandler = McpErrorHandler;
+exports.getErrorHandler = getErrorHandler;
+require("reflect-metadata");
+const MCP_ERROR_HANDLER_METADATA_KEY = Symbol("mcp:error:handler");
+function McpErrorHandler(handler) {
+    return (target) => {
+        Reflect.defineMetadata(MCP_ERROR_HANDLER_METADATA_KEY, handler, target);
+    };
+}
+function getErrorHandler(target) {
+    return Reflect.getMetadata(MCP_ERROR_HANDLER_METADATA_KEY, target);
+}
+//# sourceMappingURL=mcp-error-handler.decorator.js.map

package/dist/decorators/mcp-error-handler.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-error-handler.decorator.js","sourceRoot":"","sources":["../../src/decorators/mcp-error-handler.decorator.ts"],"names":[],"mappings":";;AAoBA,0CAIC;AAMD,0CAEC;AAhCD,4BAA0B;AAM1B,MAAM,8BAA8B,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAcnE,SAAgB,eAAe,CAAC,OAAqB;IACnD,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,OAAO,CAAC,cAAc,CAAC,8BAA8B,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1E,CAAC,CAAC;AACJ,CAAC;AAMD,SAAgB,eAAe,CAAC,MAAW;IACzC,OAAO,OAAO,CAAC,WAAW,CAAC,8BAA8B,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC"}

package/dist/decorators/mcp-middleware.decorator.d.ts

@@ -0,0 +1,4 @@
+import "reflect-metadata";
+import { Middleware } from "../core/middleware/middleware.interface";
+export declare function McpMiddleware(middleware: Middleware): ClassDecorator;
+export declare function getMiddlewares(target: any): Middleware[];

package/dist/decorators/mcp-middleware.decorator.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpMiddleware = McpMiddleware;
+exports.getMiddlewares = getMiddlewares;
+require("reflect-metadata");
+const MCP_MIDDLEWARE_METADATA_KEY = Symbol("mcp:middleware");
+function McpMiddleware(middleware) {
+    return (target) => {
+        const existingMiddlewares = Reflect.getMetadata(MCP_MIDDLEWARE_METADATA_KEY, target) || [];
+        existingMiddlewares.push(middleware);
+        Reflect.defineMetadata(MCP_MIDDLEWARE_METADATA_KEY, existingMiddlewares, target);
+    };
+}
+function getMiddlewares(target) {
+    return Reflect.getMetadata(MCP_MIDDLEWARE_METADATA_KEY, target) || [];
+}
+//# sourceMappingURL=mcp-middleware.decorator.js.map

package/dist/decorators/mcp-middleware.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-middleware.decorator.js","sourceRoot":"","sources":["../../src/decorators/mcp-middleware.decorator.ts"],"names":[],"mappings":";;AAsBA,sCAOC;AAMD,wCAEC;AArCD,4BAA0B;AAM1B,MAAM,2BAA2B,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAgB7D,SAAgB,aAAa,CAAC,UAAsB;IAClD,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,MAAM,mBAAmB,GACvB,OAAO,CAAC,WAAW,CAAC,2BAA2B,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACjE,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,OAAO,CAAC,cAAc,CAAC,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,CAAC,CAAC;IACnF,CAAC,CAAC;AACJ,CAAC;AAMD,SAAgB,cAAc,CAAC,MAAW;IACxC,OAAO,OAAO,CAAC,WAAW,CAAC,2BAA2B,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACxE,CAAC"}

package/dist/decorators/mcp-tool.decorator.d.ts

@@ -0,0 +1,28 @@
+import "reflect-metadata";
+export interface RateLimitConfig {
+    max: number;
+    window: string;
+}
+export interface RetryConfig {
+    maxAttempts: number;
+    backoff: "exponential" | "linear" | "fixed";
+    initialDelay?: number;
+    maxDelay?: number;
+}
+export interface McpToolOptions {
+    name: string;
+    description: string;
+    requiredScopes?: string[];
+    rateLimit?: RateLimitConfig;
+    retry?: RetryConfig;
+    version?: string;
+    icon?: string;
+}
+export interface ToolMethodMetadata extends McpToolOptions {
+    methodName: string;
+    target: any;
+}
+export declare function McpTool(options: McpToolOptions): MethodDecorator;
+export declare function getToolMetadata(target: any, propertyKey: string | symbol): ToolMethodMetadata | undefined;
+export declare function getToolMethods(target: any): ToolMethodMetadata[];
+export declare function isToolMethod(target: any, propertyKey: string | symbol): boolean;

package/dist/decorators/mcp-tool.decorator.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpTool = McpTool;
+exports.getToolMetadata = getToolMetadata;
+exports.getToolMethods = getToolMethods;
+exports.isToolMethod = isToolMethod;
+require("reflect-metadata");
+const MCP_TOOL_METADATA_KEY = Symbol("mcp:tool");
+const MCP_TOOL_METHODS_METADATA_KEY = Symbol("mcp:tool:methods");
+function McpTool(options) {
+    return (target, propertyKey, descriptor) => {
+        if (!options.name || !options.description) {
+            throw new Error(`@McpTool decorator requires 'name' and 'description' options. Found on ${target.constructor.name}.${String(propertyKey)}`);
+        }
+        const methodName = String(propertyKey);
+        const metadata = {
+            ...options,
+            methodName,
+            target,
+        };
+        Reflect.defineMetadata(MCP_TOOL_METADATA_KEY, metadata, target, propertyKey);
+        const existingMethods = Reflect.getMetadata(MCP_TOOL_METHODS_METADATA_KEY, target) || [];
+        existingMethods.push(metadata);
+        Reflect.defineMetadata(MCP_TOOL_METHODS_METADATA_KEY, existingMethods, target);
+    };
+}
+function getToolMetadata(target, propertyKey) {
+    return Reflect.getMetadata(MCP_TOOL_METADATA_KEY, target, propertyKey);
+}
+function getToolMethods(target) {
+    return Reflect.getMetadata(MCP_TOOL_METHODS_METADATA_KEY, target) || [];
+}
+function isToolMethod(target, propertyKey) {
+    return Reflect.hasMetadata(MCP_TOOL_METADATA_KEY, target, propertyKey);
+}
+//# sourceMappingURL=mcp-tool.decorator.js.map

package/dist/decorators/mcp-tool.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool.decorator.js","sourceRoot":"","sources":["../../src/decorators/mcp-tool.decorator.ts"],"names":[],"mappings":";;AAkFA,0BAwBC;AAMD,0CAKC;AAMD,wCAEC;AAMD,oCAEC;AArID,4BAA0B;AAK1B,MAAM,qBAAqB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AACjD,MAAM,6BAA6B,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AA4EjE,SAAgB,OAAO,CAAC,OAAuB;IAC7C,OAAO,CAAC,MAAW,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACnF,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,0EAA0E,MAAM,CAAC,WAAW,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,CAAC,EAAE,CAC3H,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAuB;YACnC,GAAG,OAAO;YACV,UAAU;YACV,MAAM;SACP,CAAC;QAGF,OAAO,CAAC,cAAc,CAAC,qBAAqB,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAG7E,MAAM,eAAe,GACnB,OAAO,CAAC,WAAW,CAAC,6BAA6B,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACnE,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,OAAO,CAAC,cAAc,CAAC,6BAA6B,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;IACjF,CAAC,CAAC;AACJ,CAAC;AAMD,SAAgB,eAAe,CAC7B,MAAW,EACX,WAA4B;IAE5B,OAAO,OAAO,CAAC,WAAW,CAAC,qBAAqB,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AACzE,CAAC;AAMD,SAAgB,cAAc,CAAC,MAAW;IACxC,OAAO,OAAO,CAAC,WAAW,CAAC,6BAA6B,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC1E,CAAC;AAMD,SAAgB,YAAY,CAAC,MAAW,EAAE,WAA4B;IACpE,OAAO,OAAO,CAAC,WAAW,CAAC,qBAAqB,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AACzE,CAAC"}

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export type { McpConfig, ToolRegistrationInput, ServerInfo, } from './config/mcp
 export type { IInterfaceLayer } from './interface/interface.interface';
 export type { JsonRpcRequest, JsonRpcResponse, JsonRpcError, } from './interface/jsonrpc.interface';
 export { JsonRpcErrorCode } from './interface/jsonrpc.interface';
-export type { InitializeParams, InitializeResult, ListToolsResult, McpTool, CallToolParams, CallToolResult, } from './interface/mcp-protocol.interface';
+export type { InitializeParams, InitializeResult, ListToolsResult, McpTool as McpToolDefinition, CallToolParams, CallToolResult, } from './interface/mcp-protocol.interface';
 export { McpErrorCode } from './interface/mcp-protocol.interface';
 export type { ToolDefinition, ToolParameter, ToolFunction, } from './tooling/tool.interface';
 export { EasyMcpError, ConfigurationError, ToolExecutionError, ToolNotFoundError, } from './core/errors/easy-mcp-error';
@@ -11,7 +11,7 @@ export { ToolNamingValidator } from './core/utils/tool-naming-validator';
 export { INTERFACE_LAYER_TOKEN } from './config/constants';
 export { VERSION, PACKAGE_NAME, getVersion, getPackageName } from './config/version';
 export type { McpContext } from './core/context/mcp-context.interface';
-export { McpContext as McpContextDecorator, McpService, createFactoryProvider, McpParam } from './decorators';
+export { McpContext as McpContextDecorator, McpService, createFactoryProvider, McpParam, McpTool, McpErrorHandler, McpMiddleware, type McpToolOptions, type RateLimitConfig, type RetryConfig, } from './decorators';
 export { zodToJsonSchema, validateWithZod, safeValidateWithZod } from './validation';
 export { createMcpExpressRouter } from './adapters/express';
 export type { CreateMcpExpressRouterOptions, McpAuthMiddleware } from './adapters/express';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createMockCancellationToken = exports.wait = exports.createMockTool = exports.createMockJsonRpcRequest = exports.mockMcpContext = exports.McpTestApp = exports.createMcpTestApp = exports.StandaloneMcpServer = exports.createMcpServer = exports.createOAuthMiddleware = exports.OAuthProviderService = exports.createMcpExpressRouter = exports.safeValidateWithZod = exports.validateWithZod = exports.zodToJsonSchema = exports.McpParam = exports.createFactoryProvider = exports.McpService = exports.McpContextDecorator = exports.getPackageName = exports.getVersion = exports.PACKAGE_NAME = exports.VERSION = exports.INTERFACE_LAYER_TOKEN = exports.ToolNamingValidator = exports.ToolNotFoundError = exports.ToolExecutionError = exports.ConfigurationError = exports.EasyMcpError = exports.McpErrorCode = exports.JsonRpcErrorCode = exports.EasyMCP = void 0;
+exports.createMockCancellationToken = exports.wait = exports.createMockTool = exports.createMockJsonRpcRequest = exports.mockMcpContext = exports.McpTestApp = exports.createMcpTestApp = exports.StandaloneMcpServer = exports.createMcpServer = exports.createOAuthMiddleware = exports.OAuthProviderService = exports.createMcpExpressRouter = exports.safeValidateWithZod = exports.validateWithZod = exports.zodToJsonSchema = exports.McpMiddleware = exports.McpErrorHandler = exports.McpTool = exports.McpParam = exports.createFactoryProvider = exports.McpService = exports.McpContextDecorator = exports.getPackageName = exports.getVersion = exports.PACKAGE_NAME = exports.VERSION = exports.INTERFACE_LAYER_TOKEN = exports.ToolNamingValidator = exports.ToolNotFoundError = exports.ToolExecutionError = exports.ConfigurationError = exports.EasyMcpError = exports.McpErrorCode = exports.JsonRpcErrorCode = exports.EasyMCP = void 0;
 var EasyMCP_1 = require("./EasyMCP");
 Object.defineProperty(exports, "EasyMCP", { enumerable: true, get: function () { return EasyMCP_1.EasyMCP; } });
 var jsonrpc_interface_1 = require("./interface/jsonrpc.interface");
@@ -26,6 +26,9 @@ Object.defineProperty(exports, "McpContextDecorator", { enumerable: true, get: f
 Object.defineProperty(exports, "McpService", { enumerable: true, get: function () { return decorators_1.McpService; } });
 Object.defineProperty(exports, "createFactoryProvider", { enumerable: true, get: function () { return decorators_1.createFactoryProvider; } });
 Object.defineProperty(exports, "McpParam", { enumerable: true, get: function () { return decorators_1.McpParam; } });
+Object.defineProperty(exports, "McpTool", { enumerable: true, get: function () { return decorators_1.McpTool; } });
+Object.defineProperty(exports, "McpErrorHandler", { enumerable: true, get: function () { return decorators_1.McpErrorHandler; } });
+Object.defineProperty(exports, "McpMiddleware", { enumerable: true, get: function () { return decorators_1.McpMiddleware; } });
 var validation_1 = require("./validation");
 Object.defineProperty(exports, "zodToJsonSchema", { enumerable: true, get: function () { return validation_1.zodToJsonSchema; } });
 Object.defineProperty(exports, "validateWithZod", { enumerable: true, get: function () { return validation_1.validateWithZod; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAmBhB,mEAAiE;AAAxD,qHAAA,gBAAgB,OAAA;AAYzB,6EAAkE;AAAzD,sHAAA,YAAY,OAAA;AAUrB,+DAKsC;AAJpC,8GAAA,YAAY,OAAA;AACZ,oHAAA,kBAAkB,OAAA;AAClB,oHAAA,kBAAkB,OAAA;AAClB,mHAAA,iBAAiB,OAAA;AAInB,4EAAyE;AAAhE,4HAAA,mBAAmB,OAAA;AAG5B,gDAA2D;AAAlD,kHAAA,qBAAqB,OAAA;AAG9B,4CAAqF;AAA5E,kGAAA,OAAO,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,qGAAA,UAAU,OAAA;AAAE,yGAAA,cAAc,OAAA;AAI1D,2CAA8G;AAArG,iHAAA,UAAU,OAAuB;AAAE,wGAAA,UAAU,OAAA;AAAE,mHAAA,qBAAqB,OAAA;AAAE,sGAAA,QAAQ,OAAA;AAGvF,2CAAqF;AAA5E,6GAAA,eAAe,OAAA;AAAE,6GAAA,eAAe,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAG9D,8CAA4D;AAAnD,iHAAA,sBAAsB,OAAA;AAI/B,sCAA2E;AAAlE,6GAAA,oBAAoB,OAAA;AAAE,8GAAA,qBAAqB,OAAA;AAIpD,2CAAoE;AAA3D,6GAAA,eAAe,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAI7C,qCAAyE;AAAhE,2GAAA,gBAAgB,OAAA;AAAE,qGAAA,UAAU,OAAA;AAAE,yGAAA,cAAc,OAAA;AACrD,qCAAwG;AAA/F,mHAAA,wBAAwB,OAAA;AAAE,yGAAA,cAAc,OAAA;AAAE,+FAAA,IAAI,OAAA;AAAE,sHAAA,2BAA2B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAmBhB,mEAAiE;AAAxD,qHAAA,gBAAgB,OAAA;AAYzB,6EAAkE;AAAzD,sHAAA,YAAY,OAAA;AAUrB,+DAKsC;AAJpC,8GAAA,YAAY,OAAA;AACZ,oHAAA,kBAAkB,OAAA;AAClB,oHAAA,kBAAkB,OAAA;AAClB,mHAAA,iBAAiB,OAAA;AAInB,4EAAyE;AAAhE,4HAAA,mBAAmB,OAAA;AAG5B,gDAA2D;AAAlD,kHAAA,qBAAqB,OAAA;AAG9B,4CAAqF;AAA5E,kGAAA,OAAO,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,qGAAA,UAAU,OAAA;AAAE,yGAAA,cAAc,OAAA;AAI1D,2CAWsB;AAVpB,iHAAA,UAAU,OAAuB;AACjC,wGAAA,UAAU,OAAA;AACV,mHAAA,qBAAqB,OAAA;AACrB,sGAAA,QAAQ,OAAA;AACR,qGAAA,OAAO,OAAA;AACP,6GAAA,eAAe,OAAA;AACf,2GAAA,aAAa,OAAA;AAOf,2CAAqF;AAA5E,6GAAA,eAAe,OAAA;AAAE,6GAAA,eAAe,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAG9D,8CAA4D;AAAnD,iHAAA,sBAAsB,OAAA;AAI/B,sCAA2E;AAAlE,6GAAA,oBAAoB,OAAA;AAAE,8GAAA,qBAAqB,OAAA;AAIpD,2CAAoE;AAA3D,6GAAA,eAAe,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAI7C,qCAAyE;AAAhE,2GAAA,gBAAgB,OAAA;AAAE,qGAAA,UAAU,OAAA;AAAE,yGAAA,cAAc,OAAA;AACrD,qCAAwG;AAA/F,mHAAA,wBAAwB,OAAA;AAAE,yGAAA,cAAc,OAAA;AAAE,+FAAA,IAAI,OAAA;AAAE,sHAAA,2BAA2B,OAAA"}