easy-mcp-nest 0.2.1 → 0.4.0

package/dist/decorators/factory-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-provider.js","sourceRoot":"","sources":["../../src/decorators/factory-provider.ts"],"names":[],"mappings":";;AAiBA,sDAwBC;AAxCD,mEAA8D;AAgB9D,SAAgB,qBAAqB,CACnC,MAAiC,EACjC,OAA+B;IAG/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,CAAC,GAAG,IAAW,EAAE,EAAE;YAE3B,MAAM,oBAAoB,GAAG,IAAA,2CAAmB,EAAC,MAAM,CAAC,CAAC;YAGzD,MAAM,YAAY,GAAG,oBAAoB;iBACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;iBACjC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;YAGhD,OAAO,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC;QACrC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,MAAM;QACf,UAAU,EAAE,OAAO;KACpB,CAAC;AACJ,CAAC"}

package/dist/decorators/index.d.ts

@@ -0,0 +1,7 @@
+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

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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; } });
+var mcp_service_decorator_1 = require("./mcp-service.decorator");
+Object.defineProperty(exports, "McpService", { enumerable: true, get: function () { return mcp_service_decorator_1.McpService; } });
+Object.defineProperty(exports, "getServiceFactories", { enumerable: true, get: function () { return mcp_service_decorator_1.getServiceFactories; } });
+var factory_provider_1 = require("./factory-provider");
+Object.defineProperty(exports, "createFactoryProvider", { enumerable: true, get: function () { return factory_provider_1.createFactoryProvider; } });
+var mcp_param_decorator_1 = require("./mcp-param.decorator");
+Object.defineProperty(exports, "McpParam", { enumerable: true, get: function () { return mcp_param_decorator_1.McpParam; } });
+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

@@ -0,0 +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;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-context.decorator.d.ts

@@ -0,0 +1,3 @@
+import "reflect-metadata";
+export declare function McpContext(): ParameterDecorator;
+export declare function getContextParameterIndices(target: any, propertyKey: string | symbol): number[];

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

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpContext = McpContext;
+exports.getContextParameterIndices = getContextParameterIndices;
+require("reflect-metadata");
+const MCP_CONTEXT_METADATA_KEY = Symbol("mcp:context");
+function McpContext() {
+    return (target, propertyKey, parameterIndex) => {
+        if (propertyKey === undefined) {
+            return;
+        }
+        const existingContextParams = Reflect.getMetadata(MCP_CONTEXT_METADATA_KEY, target, propertyKey) || [];
+        existingContextParams.push(parameterIndex);
+        Reflect.defineMetadata(MCP_CONTEXT_METADATA_KEY, existingContextParams, target, propertyKey);
+    };
+}
+function getContextParameterIndices(target, propertyKey) {
+    return Reflect.getMetadata(MCP_CONTEXT_METADATA_KEY, target, propertyKey) || [];
+}
+//# sourceMappingURL=mcp-context.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-context.decorator.js","sourceRoot":"","sources":["../../src/decorators/mcp-context.decorator.ts"],"names":[],"mappings":";;AAqBA,gCAaC;AAMD,gEAKC;AA7CD,4BAA0B;AAK1B,MAAM,wBAAwB,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAgBvD,SAAgB,UAAU;IACxB,OAAO,CAAC,MAAW,EAAE,WAAwC,EAAE,cAAsB,EAAE,EAAE;QACvF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAGD,MAAM,qBAAqB,GACzB,OAAO,CAAC,WAAW,CAAC,wBAAwB,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;QAE3E,qBAAqB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3C,OAAO,CAAC,cAAc,CAAC,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/F,CAAC,CAAC;AACJ,CAAC;AAMD,SAAgB,0BAA0B,CACxC,MAAW,EACX,WAA4B;IAE5B,OAAO,OAAO,CAAC,WAAW,CAAC,wBAAwB,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;AAClF,CAAC"}

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-param.decorator.d.ts

@@ -0,0 +1,10 @@
+import "reflect-metadata";
+import { z } from "zod";
+export declare function McpParam<T extends z.ZodTypeAny>(schema: T): ParameterDecorator;
+export declare function getParamSchema(target: any, propertyKey: string | symbol, parameterIndex: number): z.ZodTypeAny | undefined;
+export declare function getAllParamSchemas(target: any, propertyKey: string | symbol): Map<number, z.ZodTypeAny>;
+export declare function getParamSchemasAsJsonSchema(target: any, propertyKey: string | symbol): {
+    type: "object";
+    properties?: Record<string, any>;
+    required?: string[];
+} | null;

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

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpParam = McpParam;
+exports.getParamSchema = getParamSchema;
+exports.getAllParamSchemas = getAllParamSchemas;
+exports.getParamSchemasAsJsonSchema = getParamSchemasAsJsonSchema;
+require("reflect-metadata");
+const zod_integration_1 = require("../validation/zod-integration");
+const MCP_PARAM_SCHEMA_METADATA_KEY = Symbol("mcp:param:schema");
+const MCP_PARAM_INDEX_METADATA_KEY = Symbol("mcp:param:index");
+function McpParam(schema) {
+    return (target, propertyKey, parameterIndex) => {
+        if (propertyKey === undefined) {
+            return;
+        }
+        const existingSchemas = Reflect.getMetadata(MCP_PARAM_SCHEMA_METADATA_KEY, target, propertyKey) || new Map();
+        existingSchemas.set(parameterIndex, schema);
+        Reflect.defineMetadata(MCP_PARAM_SCHEMA_METADATA_KEY, existingSchemas, target, propertyKey);
+        const existingIndices = Reflect.getMetadata(MCP_PARAM_INDEX_METADATA_KEY, target, propertyKey) || [];
+        if (!existingIndices.includes(parameterIndex)) {
+            existingIndices.push(parameterIndex);
+            Reflect.defineMetadata(MCP_PARAM_INDEX_METADATA_KEY, existingIndices, target, propertyKey);
+        }
+    };
+}
+function getParamSchema(target, propertyKey, parameterIndex) {
+    const schemas = Reflect.getMetadata(MCP_PARAM_SCHEMA_METADATA_KEY, target, propertyKey) || new Map();
+    return schemas.get(parameterIndex);
+}
+function getAllParamSchemas(target, propertyKey) {
+    return Reflect.getMetadata(MCP_PARAM_SCHEMA_METADATA_KEY, target, propertyKey) || new Map();
+}
+function getParamSchemasAsJsonSchema(target, propertyKey) {
+    const schemas = getAllParamSchemas(target, propertyKey);
+    const paramsSchema = schemas.get(0);
+    if (!paramsSchema) {
+        return null;
+    }
+    return (0, zod_integration_1.zodToJsonSchema)(paramsSchema);
+}
+//# sourceMappingURL=mcp-param.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-param.decorator.js","sourceRoot":"","sources":["../../src/decorators/mcp-param.decorator.ts"],"names":[],"mappings":";;AA+BA,4BAsBC;AAMD,wCAQC;AAMD,gDAKC;AAMD,kEAgBC;AApGD,4BAA0B;AAE1B,mEAAgE;AAKhE,MAAM,6BAA6B,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AACjE,MAAM,4BAA4B,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAuB/D,SAAgB,QAAQ,CAAyB,MAAS;IACxD,OAAO,CAAC,MAAW,EAAE,WAAwC,EAAE,cAAsB,EAAE,EAAE;QACvF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAGD,MAAM,eAAe,GACnB,OAAO,CAAC,WAAW,CAAC,6BAA6B,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAEvF,eAAe,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC5C,OAAO,CAAC,cAAc,CAAC,6BAA6B,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAG5F,MAAM,eAAe,GACnB,OAAO,CAAC,WAAW,CAAC,4BAA4B,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;QAE/E,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YAC9C,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACrC,OAAO,CAAC,cAAc,CAAC,4BAA4B,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAMD,SAAgB,cAAc,CAC5B,MAAW,EACX,WAA4B,EAC5B,cAAsB;IAEtB,MAAM,OAAO,GACX,OAAO,CAAC,WAAW,CAAC,6BAA6B,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;IACvF,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AACrC,CAAC;AAMD,SAAgB,kBAAkB,CAChC,MAAW,EACX,WAA4B;IAE5B,OAAO,OAAO,CAAC,WAAW,CAAC,6BAA6B,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;AAC9F,CAAC;AAMD,SAAgB,2BAA2B,CACzC,MAAW,EACX,WAA4B;IAE5B,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAIxD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEpC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,OAAO,IAAA,iCAAe,EAAC,YAAY,CAA8E,CAAC;AACpH,CAAC"}

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

@@ -0,0 +1,6 @@
+import "reflect-metadata";
+export declare function McpService<T = any>(factory: () => T): ParameterDecorator;
+export declare function getServiceFactories(target: any, propertyKey?: string | symbol): Array<{
+    index: number;
+    factory: () => any;
+}>;

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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpService = McpService;
+exports.getServiceFactories = getServiceFactories;
+require("reflect-metadata");
+const MCP_SERVICE_FACTORY_METADATA_KEY = Symbol("mcp:service:factory");
+function McpService(factory) {
+    return (target, propertyKey, parameterIndex) => {
+        if (propertyKey !== undefined) {
+            const existingFactories = Reflect.getMetadata(MCP_SERVICE_FACTORY_METADATA_KEY, target, propertyKey) || [];
+            existingFactories.push({ index: parameterIndex, factory });
+            Reflect.defineMetadata(MCP_SERVICE_FACTORY_METADATA_KEY, existingFactories, target, propertyKey);
+        }
+        else {
+            const existingFactories = Reflect.getMetadata(MCP_SERVICE_FACTORY_METADATA_KEY, target) || [];
+            existingFactories.push({ index: parameterIndex, factory });
+            Reflect.defineMetadata(MCP_SERVICE_FACTORY_METADATA_KEY, existingFactories, target);
+        }
+    };
+}
+function getServiceFactories(target, propertyKey) {
+    if (propertyKey !== undefined) {
+        return Reflect.getMetadata(MCP_SERVICE_FACTORY_METADATA_KEY, target, propertyKey) || [];
+    }
+    return Reflect.getMetadata(MCP_SERVICE_FACTORY_METADATA_KEY, target) || [];
+}
+//# sourceMappingURL=mcp-service.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-service.decorator.js","sourceRoot":"","sources":["../../src/decorators/mcp-service.decorator.ts"],"names":[],"mappings":";;AAuBA,gCAkBC;AAMD,kDAQC;AAvDD,4BAA0B;AAK1B,MAAM,gCAAgC,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAkBvE,SAAgB,UAAU,CAAU,OAAgB;IAClD,OAAO,CAAC,MAAW,EAAE,WAAwC,EAAE,cAAsB,EAAE,EAAE;QACvF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAE9B,MAAM,iBAAiB,GACrB,OAAO,CAAC,WAAW,CAAC,gCAAgC,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;YAEnF,iBAAiB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3D,OAAO,CAAC,cAAc,CAAC,gCAAgC,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACnG,CAAC;aAAM,CAAC;YAEN,MAAM,iBAAiB,GACrB,OAAO,CAAC,WAAW,CAAC,gCAAgC,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YAEtE,iBAAiB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3D,OAAO,CAAC,cAAc,CAAC,gCAAgC,EAAE,iBAAiB,EAAE,MAAM,CAAC,CAAC;QACtF,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAMD,SAAgB,mBAAmB,CACjC,MAAW,EACX,WAA6B;IAE7B,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,WAAW,CAAC,gCAAgC,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;IAC1F,CAAC;IACD,OAAO,OAAO,CAAC,WAAW,CAAC,gCAAgC,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC7E,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,10 +3,21 @@ 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';
 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, 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';
+export { OAuthProviderService, createOAuthMiddleware } from './auth/oauth';
+export type { OAuthProviderConfig, OAuthConfig, OAuthTokenValidator, OAuthContextExtractor } from './auth/oauth';
+export { createMcpServer, StandaloneMcpServer } from './standalone';
+export type { CreateMcpServerOptions, StandaloneTransport, StandaloneAuthFunction } from './standalone';
+export { createMcpTestApp, McpTestApp, mockMcpContext } from './testing';
+export { createMockJsonRpcRequest, createMockTool, wait, createMockCancellationToken } from './testing';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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");
@@ -21,4 +21,33 @@ Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () {
 Object.defineProperty(exports, "PACKAGE_NAME", { enumerable: true, get: function () { return version_1.PACKAGE_NAME; } });
 Object.defineProperty(exports, "getVersion", { enumerable: true, get: function () { return version_1.getVersion; } });
 Object.defineProperty(exports, "getPackageName", { enumerable: true, get: function () { return version_1.getPackageName; } });
+var decorators_1 = require("./decorators");
+Object.defineProperty(exports, "McpContextDecorator", { enumerable: true, get: function () { return decorators_1.McpContext; } });
+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; } });
+Object.defineProperty(exports, "safeValidateWithZod", { enumerable: true, get: function () { return validation_1.safeValidateWithZod; } });
+var express_1 = require("./adapters/express");
+Object.defineProperty(exports, "createMcpExpressRouter", { enumerable: true, get: function () { return express_1.createMcpExpressRouter; } });
+var oauth_1 = require("./auth/oauth");
+Object.defineProperty(exports, "OAuthProviderService", { enumerable: true, get: function () { return oauth_1.OAuthProviderService; } });
+Object.defineProperty(exports, "createOAuthMiddleware", { enumerable: true, get: function () { return oauth_1.createOAuthMiddleware; } });
+var standalone_1 = require("./standalone");
+Object.defineProperty(exports, "createMcpServer", { enumerable: true, get: function () { return standalone_1.createMcpServer; } });
+Object.defineProperty(exports, "StandaloneMcpServer", { enumerable: true, get: function () { return standalone_1.StandaloneMcpServer; } });
+var testing_1 = require("./testing");
+Object.defineProperty(exports, "createMcpTestApp", { enumerable: true, get: function () { return testing_1.createMcpTestApp; } });
+Object.defineProperty(exports, "McpTestApp", { enumerable: true, get: function () { return testing_1.McpTestApp; } });
+Object.defineProperty(exports, "mockMcpContext", { enumerable: true, get: function () { return testing_1.mockMcpContext; } });
+var testing_2 = require("./testing");
+Object.defineProperty(exports, "createMockJsonRpcRequest", { enumerable: true, get: function () { return testing_2.createMockJsonRpcRequest; } });
+Object.defineProperty(exports, "createMockTool", { enumerable: true, get: function () { return testing_2.createMockTool; } });
+Object.defineProperty(exports, "wait", { enumerable: true, get: function () { return testing_2.wait; } });
+Object.defineProperty(exports, "createMockCancellationToken", { enumerable: true, get: function () { return testing_2.createMockCancellationToken; } });
 //# sourceMappingURL=index.js.map

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"}
+{"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"}

package/dist/interface/interface.interface.d.ts

@@ -1,4 +1,6 @@
+import type { ProgressNotification } from "./mcp-protocol.interface";
 export interface IInterfaceLayer {
     start(): Promise<void>;
     sendMessage(sessionId: string, output: any): Promise<void>;
+    sendNotification?(notification: ProgressNotification): void;
 }

package/dist/interface/jsonrpc.interface.d.ts

@@ -3,6 +3,14 @@ export interface JsonRpcRequest {
     id: string | number | null;
     method: string;
     params?: any;
+    metadata?: {
+        userId?: string;
+        scopes?: string[];
+        buildingIds?: string[];
+        sessionId?: string;
+        metadata?: Record<string, any>;
+        [key: string]: any;
+    };
 }
 export interface JsonRpcResponse {
     jsonrpc: "2.0";

package/dist/interface/jsonrpc.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsonrpc.interface.js","sourceRoot":"","sources":["../../src/interface/jsonrpc.interface.ts"],"names":[],"mappings":";;;AA2CA,sDAUC;AAKD,oDASC;AAKD,gDAeC;AAvDD,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,wEAAmB,CAAA;IACnB,gFAAuB,CAAA;IACvB,gFAAuB,CAAA;IACvB,8EAAsB,CAAA;IACtB,8EAAsB,CAAA;AACxB,CAAC,EANW,gBAAgB,gCAAhB,gBAAgB,QAM3B;AAKD,SAAgB,qBAAqB,CAAC,GAAQ;IAC5C,OAAO,CACL,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,CAAC,OAAO,KAAK,KAAK;QACrB,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC9B,CAAC,GAAG,CAAC,EAAE,KAAK,IAAI;YACd,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ;YAC1B,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC,CAC9B,CAAC;AACJ,CAAC;AAKD,SAAgB,oBAAoB,CAClC,EAA0B,EAC1B,MAAW;IAEX,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,MAAM;KACP,CAAC;AACJ,CAAC;AAKD,SAAgB,kBAAkB,CAChC,EAA0B,EAC1B,IAAY,EACZ,OAAe,EACf,IAAU;IAEV,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,KAAK,EAAE;YACL,IAAI;YACJ,OAAO;YACP,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC;SACpC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"jsonrpc.interface.js","sourceRoot":"","sources":["../../src/interface/jsonrpc.interface.ts"],"names":[],"mappings":";;;AAoDA,sDAUC;AAKD,oDASC;AAKD,gDAeC;AAvDD,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,wEAAmB,CAAA;IACnB,gFAAuB,CAAA;IACvB,gFAAuB,CAAA;IACvB,8EAAsB,CAAA;IACtB,8EAAsB,CAAA;AACxB,CAAC,EANW,gBAAgB,gCAAhB,gBAAgB,QAM3B;AAKD,SAAgB,qBAAqB,CAAC,GAAQ;IAC5C,OAAO,CACL,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,CAAC,OAAO,KAAK,KAAK;QACrB,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC9B,CAAC,GAAG,CAAC,EAAE,KAAK,IAAI;YACd,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ;YAC1B,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC,CAC9B,CAAC;AACJ,CAAC;AAKD,SAAgB,oBAAoB,CAClC,EAA0B,EAC1B,MAAW;IAEX,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,MAAM;KACP,CAAC;AACJ,CAAC;AAKD,SAAgB,kBAAkB,CAChC,EAA0B,EAC1B,IAAY,EACZ,OAAe,EACf,IAAU;IAEV,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,KAAK,EAAE;YACL,IAAI;YACJ,OAAO;YACP,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC;SACpC;KACF,CAAC;AACJ,CAAC"}

package/dist/interface/mcp-protocol.interface.d.ts

@@ -53,6 +53,20 @@ export interface CallToolResult {
     }>;
     isError?: boolean;
 }
+export interface BatchToolParams {
+    tools: Array<{
+        name: string;
+        arguments?: Record<string, any>;
+    }>;
+}
+export interface BatchToolResult {
+    results: Array<{
+        tool: string;
+        success: boolean;
+        result?: CallToolResult;
+        error?: string;
+    }>;
+}
 export interface McpResource {
     uri: string;
     name: string;

package/dist/interface/mcp-protocol.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-protocol.interface.js","sourceRoot":"","sources":["../../src/interface/mcp-protocol.interface.ts"],"names":[],"mappings":";;;AA0RA,IAAY,YAaX;AAbD,WAAY,YAAY;IACtB,wEAAuB,CAAA;IACvB,wEAAuB,CAAA;IACvB,sEAAsB,CAAA;IACtB,sEAAsB,CAAA;IACtB,oEAAqB,CAAA;IACrB,gFAA2B,CAAA;IAC3B,4EAAyB,CAAA;IACzB,wEAAuB,CAAA;IACvB,oFAA6B,CAAA;IAC7B,8EAA0B,CAAA;IAC1B,0FAAgC,CAAA;IAChC,4EAAyB,CAAA;AAC3B,CAAC,EAbW,YAAY,4BAAZ,YAAY,QAavB"}
+{"version":3,"file":"mcp-protocol.interface.js","sourceRoot":"","sources":["../../src/interface/mcp-protocol.interface.ts"],"names":[],"mappings":";;;AAgTA,IAAY,YAaX;AAbD,WAAY,YAAY;IACtB,wEAAuB,CAAA;IACvB,wEAAuB,CAAA;IACvB,sEAAsB,CAAA;IACtB,sEAAsB,CAAA;IACtB,oEAAqB,CAAA;IACrB,gFAA2B,CAAA;IAC3B,4EAAyB,CAAA;IACzB,wEAAuB,CAAA;IACvB,oFAA6B,CAAA;IAC7B,8EAA0B,CAAA;IAC1B,0FAAgC,CAAA;IAChC,4EAAyB,CAAA;AAC3B,CAAC,EAbW,YAAY,4BAAZ,YAAY,QAavB"}

package/dist/standalone/core-services.d.ts

@@ -0,0 +1,29 @@
+import { ToolDefinition, CancellationToken } from "../tooling/tool.interface";
+import { ToolRegistrationInput, ResourceRegistrationInput, PromptRegistrationInput } from "../config/mcp-config.interface";
+import { McpContext } from "../core/context/mcp-context.interface";
+export declare class StandaloneToolRegistry {
+    private readonly registry;
+    registerTool(toolInput: ToolRegistrationInput): void;
+    getTool(name: string): ToolDefinition | undefined;
+    executeTool(name: string, args: Record<string, any>, cancellationToken?: CancellationToken, context?: McpContext): Promise<any>;
+    getToolSchemasForLLM(): Array<{
+        type: "function";
+        function: {
+            name: string;
+            description: string;
+            parameters: any;
+        };
+    }>;
+}
+export declare class StandaloneResourceRegistry {
+    private readonly registry;
+    registerResource(resource: ResourceRegistrationInput): void;
+    getResource(uri: string): ResourceRegistrationInput | undefined;
+    getAllResources(): ResourceRegistrationInput[];
+}
+export declare class StandalonePromptRegistry {
+    private readonly registry;
+    registerPrompt(prompt: PromptRegistrationInput): void;
+    getPrompt(name: string): PromptRegistrationInput | undefined;
+    getAllPrompts(): PromptRegistrationInput[];
+}

package/dist/standalone/core-services.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandalonePromptRegistry = exports.StandaloneResourceRegistry = exports.StandaloneToolRegistry = void 0;
+const easy_mcp_error_1 = require("../core/errors/easy-mcp-error");
+const schema_validator_1 = require("../core/utils/schema-validator");
+const logger_util_1 = require("../core/utils/logger.util");
+class StandaloneToolRegistry {
+    registry = new Map();
+    registerTool(toolInput) {
+        if (this.registry.has(toolInput.name)) {
+            throw new Error(`Tool name '${toolInput.name}' already registered.`);
+        }
+        if (toolInput.inputSchema.type !== "object") {
+            throw new Error(`Tool '${toolInput.name}': inputSchema.type must be "object" for tool definitions`);
+        }
+        const toolDefinition = {
+            name: toolInput.name,
+            description: toolInput.description,
+            execute: toolInput.function,
+            inputSchema: toolInput.inputSchema,
+            icon: toolInput.icon,
+        };
+        this.registry.set(toolInput.name, toolDefinition);
+        logger_util_1.logger.info("StandaloneToolRegistry", `Tool registered: ${toolInput.name}`, {
+            component: "Standalone",
+            toolName: toolInput.name,
+        });
+    }
+    getTool(name) {
+        return this.registry.get(name);
+    }
+    async executeTool(name, args, cancellationToken, context) {
+        const tool = this.getTool(name);
+        if (!tool) {
+            throw new easy_mcp_error_1.ToolNotFoundError(name);
+        }
+        const validationError = (0, schema_validator_1.validateToolArguments)(args, tool.inputSchema);
+        if (validationError) {
+            throw new easy_mcp_error_1.ToolExecutionError(`Tool '${name}' validation failed: ${validationError}`, name);
+        }
+        try {
+            const result = await tool.execute(args, cancellationToken, context);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new easy_mcp_error_1.ToolExecutionError(`Tool '${name}' execution failed: ${errorMessage}`, name, error instanceof Error ? error : undefined);
+        }
+    }
+    getToolSchemasForLLM() {
+        return Array.from(this.registry.values()).map((tool) => ({
+            type: "function",
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.inputSchema,
+            },
+        }));
+    }
+}
+exports.StandaloneToolRegistry = StandaloneToolRegistry;
+class StandaloneResourceRegistry {
+    registry = new Map();
+    registerResource(resource) {
+        if (this.registry.has(resource.uri)) {
+            throw new Error(`Resource URI '${resource.uri}' already registered.`);
+        }
+        this.registry.set(resource.uri, resource);
+    }
+    getResource(uri) {
+        return this.registry.get(uri);
+    }
+    getAllResources() {
+        return Array.from(this.registry.values());
+    }
+}
+exports.StandaloneResourceRegistry = StandaloneResourceRegistry;
+class StandalonePromptRegistry {
+    registry = new Map();
+    registerPrompt(prompt) {
+        if (this.registry.has(prompt.name)) {
+            throw new Error(`Prompt name '${prompt.name}' already registered.`);
+        }
+        this.registry.set(prompt.name, prompt);
+    }
+    getPrompt(name) {
+        return this.registry.get(name);
+    }
+    getAllPrompts() {
+        return Array.from(this.registry.values());
+    }
+}
+exports.StandalonePromptRegistry = StandalonePromptRegistry;
+//# sourceMappingURL=core-services.js.map

package/dist/standalone/core-services.js.map

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

package/dist/standalone/index.d.ts

@@ -0,0 +1,3 @@
+export { createMcpServer, StandaloneMcpServer } from "./standalone-server";
+export type { CreateMcpServerOptions, StandaloneTransport, StandaloneAuthFunction } from "./types";
+export { StandaloneToolRegistry, StandaloneResourceRegistry, StandalonePromptRegistry } from "./core-services";

package/dist/standalone/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandalonePromptRegistry = exports.StandaloneResourceRegistry = exports.StandaloneToolRegistry = exports.StandaloneMcpServer = exports.createMcpServer = void 0;
+var standalone_server_1 = require("./standalone-server");
+Object.defineProperty(exports, "createMcpServer", { enumerable: true, get: function () { return standalone_server_1.createMcpServer; } });
+Object.defineProperty(exports, "StandaloneMcpServer", { enumerable: true, get: function () { return standalone_server_1.StandaloneMcpServer; } });
+var core_services_1 = require("./core-services");
+Object.defineProperty(exports, "StandaloneToolRegistry", { enumerable: true, get: function () { return core_services_1.StandaloneToolRegistry; } });
+Object.defineProperty(exports, "StandaloneResourceRegistry", { enumerable: true, get: function () { return core_services_1.StandaloneResourceRegistry; } });
+Object.defineProperty(exports, "StandalonePromptRegistry", { enumerable: true, get: function () { return core_services_1.StandalonePromptRegistry; } });
+//# sourceMappingURL=index.js.map

package/dist/standalone/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/standalone/index.ts"],"names":[],"mappings":";;;AAAA,yDAA2E;AAAlE,oHAAA,eAAe,OAAA;AAAE,wHAAA,mBAAmB,OAAA;AAE7C,iDAA+G;AAAtG,uHAAA,sBAAsB,OAAA;AAAE,2HAAA,0BAA0B,OAAA;AAAE,yHAAA,wBAAwB,OAAA"}