@frontmcp/sdk 0.1.0

package/src/decorators/prompt.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.decorator.js","sourceRoot":"","sources":["../../../src/decorators/prompt.decorator.ts"],"names":[],"mappings":";;AAkDE,wCAAc;AACI,gCAAM;AAExB,wCAAc;AACI,gCAAM;AAtD1B,4BAA0B;AAC1B,sCAEmB;AACnB,0CAGqB;AAIrB;;GAEG;AACH,SAAS,cAAc,CAAC,gBAAgC;IACtD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,QAAQ,GAAG,uCAA4B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAEtE,OAAO,CAAC,cAAc,CAAC,6BAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAEhE,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,6BAAoB,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACjG,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAQD;;GAEG;AACH,SAAS,cAAc,CAA2B,gBAAmB;IACnE,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,uCAA4B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACtE,MAAM,YAAY,GAAG;YACnB,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE;YAC1B,CAAC,6BAAoB,CAAC,IAAI,CAAC,EAAE,iBAAiB;YAC9C,CAAC,6BAAoB,CAAC,QAAQ,CAAC,EAAE,QAAQ;SAC1C,CAAC,CAAC;QACH,OAAO,YAAY,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport {\n  FrontMcpPromptTokens,\n} from '../tokens';\nimport {\n  PromptMetadata,\n  frontMcpPromptMetadataSchema,\n} from '../metadata';\nimport { GetPromptResult, GetPromptRequest } from '@modelcontextprotocol/sdk/types.js';\n\n\n/**\n * Decorator that marks a class as a McpPrompt module and provides metadata\n */\nfunction FrontMcpPrompt(providedMetadata: PromptMetadata): ClassDecorator {\n  return (target: Function) => {\n    const metadata = frontMcpPromptMetadataSchema.parse(providedMetadata);\n\n    Reflect.defineMetadata(FrontMcpPromptTokens.type, true, target);\n\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpPromptTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\n\nexport type FrontMcpPromptExecuteHandler = (\n  args: GetPromptRequest['params']['arguments'],\n  ...tokens: any[]\n) => GetPromptResult | Promise<GetPromptResult>;\n\n/**\n * Decorator that marks a class as a McpTool module and provides metadata\n */\nfunction frontMcpPrompt<T extends PromptMetadata>(providedMetadata: T): (handler: FrontMcpPromptExecuteHandler) => (() => void) {\n  return (execute) => {\n    const metadata = frontMcpPromptMetadataSchema.parse(providedMetadata);\n    const toolFunction = function() {\n      return execute;\n    };\n    Object.assign(toolFunction, {\n      [FrontMcpPromptTokens.type]: 'function-prompt',\n      [FrontMcpPromptTokens.metadata]: metadata,\n    });\n    return toolFunction;\n  };\n}\n\nexport {\n  FrontMcpPrompt,\n  FrontMcpPrompt as Prompt,\n\n  frontMcpPrompt,\n  frontMcpPrompt as prompt,\n};"]}

package/src/decorators/provider.decorator.d.ts

@@ -0,0 +1,7 @@
+import 'reflect-metadata';
+import { ProviderMetadata } from '../metadata';
+/**
+ * Decorator that marks a class as a McpProvider module and provides metadata
+ */
+declare function FrontMcpProvider(providedMetadata: ProviderMetadata): ClassDecorator;
+export { FrontMcpProvider, FrontMcpProvider as Provider, };

package/src/decorators/provider.decorator.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontMcpProvider = FrontMcpProvider;
+exports.Provider = FrontMcpProvider;
+require("reflect-metadata");
+const tokens_1 = require("../tokens");
+const metadata_1 = require("../metadata");
+/**
+ * Decorator that marks a class as a McpProvider module and provides metadata
+ */
+function FrontMcpProvider(providedMetadata) {
+    return (target) => {
+        const metadata = metadata_1.frontMcpProviderMetadataSchema.parse(providedMetadata);
+        Reflect.defineMetadata(tokens_1.FrontMcpProviderTokens.type, true, target);
+        for (const property in metadata) {
+            Reflect.defineMetadata(tokens_1.FrontMcpProviderTokens[property] ?? property, metadata[property], target);
+        }
+    };
+}
+//# sourceMappingURL=provider.decorator.js.map

package/src/decorators/provider.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.decorator.js","sourceRoot":"","sources":["../../../src/decorators/provider.decorator.ts"],"names":[],"mappings":";;AAoBE,4CAAgB;AACI,oCAAQ;AArB9B,4BAA0B;AAC1B,sCAAmD;AACnD,0CAA+E;AAE/E;;GAEG;AACH,SAAS,gBAAgB,CAAC,gBAAkC;IAC1D,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,QAAQ,GAAG,yCAA8B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAExE,OAAO,CAAC,cAAc,CAAC,+BAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAElE,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,+BAAsB,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACnG,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpProviderTokens } from '../tokens';\nimport { frontMcpProviderMetadataSchema, ProviderMetadata } from '../metadata';\n\n/**\n * Decorator that marks a class as a McpProvider module and provides metadata\n */\nfunction FrontMcpProvider(providedMetadata: ProviderMetadata): ClassDecorator {\n  return (target: Function) => {\n    const metadata = frontMcpProviderMetadataSchema.parse(providedMetadata);\n\n    Reflect.defineMetadata(FrontMcpProviderTokens.type, true, target);\n\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpProviderTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\nexport {\n  FrontMcpProvider,\n  FrontMcpProvider as Provider,\n};"]}

package/src/decorators/resource.decorator.d.ts

@@ -0,0 +1,17 @@
+import 'reflect-metadata';
+import { ResourceMetadata, ResourceTemplateMetadata } from '../metadata';
+import { ReadResourceRequest, ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Decorator that marks a class as a McpResource module and provides metadata
+ */
+declare function FrontMcpResource(providedMetadata: ResourceMetadata): ClassDecorator;
+/**
+ * Decorator that marks a class as a McpResourceTemplate module and provides metadata
+ */
+declare function FrontMcpResourceTemplate(providedMetadata: ResourceTemplateMetadata): ClassDecorator;
+export type FrontMcpResourceExecuteHandler = (uri: ReadResourceRequest['params']['uri'], ...tokens: any[]) => ReadResourceResult | Promise<ReadResourceResult>;
+/**
+ * Decorator that marks a class as a McpResource module and provides metadata
+ */
+declare function frontMcpResource<T extends ResourceMetadata>(providedMetadata: T): (handler: FrontMcpResourceExecuteHandler) => (() => void);
+export { FrontMcpResource, FrontMcpResource as Resource, FrontMcpResourceTemplate, FrontMcpResourceTemplate as ResourceTemplate, frontMcpResource, frontMcpResource as resource, };

package/src/decorators/resource.decorator.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontMcpResource = FrontMcpResource;
+exports.Resource = FrontMcpResource;
+exports.FrontMcpResourceTemplate = FrontMcpResourceTemplate;
+exports.ResourceTemplate = FrontMcpResourceTemplate;
+exports.frontMcpResource = frontMcpResource;
+exports.resource = frontMcpResource;
+require("reflect-metadata");
+const tokens_1 = require("../tokens");
+const metadata_1 = require("../metadata");
+/**
+ * Decorator that marks a class as a McpResource module and provides metadata
+ */
+function FrontMcpResource(providedMetadata) {
+    return (target) => {
+        const metadata = metadata_1.frontMcpResourceMetadataSchema.parse(providedMetadata);
+        Reflect.defineMetadata(tokens_1.FrontMcpResourceTokens.type, true, target);
+        for (const property in metadata) {
+            Reflect.defineMetadata(tokens_1.FrontMcpResourceTokens[property] ?? property, metadata[property], target);
+        }
+    };
+}
+/**
+ * Decorator that marks a class as a McpResourceTemplate module and provides metadata
+ */
+function FrontMcpResourceTemplate(providedMetadata) {
+    return (target) => {
+        const metadata = metadata_1.frontMcpResourceTemplateMetadataSchema.parse(providedMetadata);
+        Reflect.defineMetadata(tokens_1.FrontMcpResourceTemplateTokens.type, true, target);
+        for (const property in metadata) {
+            Reflect.defineMetadata(tokens_1.FrontMcpResourceTemplateTokens[property] ?? property, metadata[property], target);
+        }
+    };
+}
+/**
+ * Decorator that marks a class as a McpResource module and provides metadata
+ */
+function frontMcpResource(providedMetadata) {
+    return (execute) => {
+        const metadata = metadata_1.frontMcpResourceMetadataSchema.parse(providedMetadata);
+        const toolFunction = function () {
+            return execute;
+        };
+        Object.assign(toolFunction, {
+            [tokens_1.FrontMcpResourceTokens.type]: 'function-resource',
+            [tokens_1.FrontMcpResourceTokens.metadata]: metadata,
+        });
+        return toolFunction;
+    };
+}
+//# sourceMappingURL=resource.decorator.js.map

package/src/decorators/resource.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.decorator.js","sourceRoot":"","sources":["../../../src/decorators/resource.decorator.ts"],"names":[],"mappings":";;AA2FE,4CAAgB;AACI,oCAAQ;AAC5B,4DAAwB;AACI,oDAAgB;AAC5C,4CAAgB;AACI,oCAAQ;AAhG9B,4BAA0B;AAC1B,sCAGmB;AACnB,0CAKqB;AAOrB;;GAEG;AACH,SAAS,gBAAgB,CAAC,gBAAkC;IAC1D,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,QAAQ,GAAG,yCAA8B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAExE,OAAO,CAAC,cAAc,CAAC,+BAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAElE,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,+BAAsB,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACnG,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAGD;;GAEG;AACH,SAAS,wBAAwB,CAAC,gBAA0C;IAC1E,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,QAAQ,GAAG,iDAAsC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAEhF,OAAO,CAAC,cAAc,CAAC,uCAA8B,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAE1E,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,uCAA8B,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3G,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAQD;;GAEG;AACH,SAAS,gBAAgB,CAA6B,gBAAmB;IACvE,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,yCAA8B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACxE,MAAM,YAAY,GAAG;YACnB,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE;YAC1B,CAAC,+BAAsB,CAAC,IAAI,CAAC,EAAE,mBAAmB;YAClD,CAAC,+BAAsB,CAAC,QAAQ,CAAC,EAAE,QAAQ;SAC5C,CAAC,CAAC;QACH,OAAO,YAAY,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport {\n  FrontMcpResourceTokens,\n  FrontMcpResourceTemplateTokens,\n} from '../tokens';\nimport {\n  frontMcpResourceMetadataSchema,\n  frontMcpResourceTemplateMetadataSchema,\n  ResourceMetadata,\n  ResourceTemplateMetadata,\n} from '../metadata';\n\nimport {\n  ReadResourceRequest,\n  ReadResourceResult,\n} from '@modelcontextprotocol/sdk/types.js';\n\n/**\n * Decorator that marks a class as a McpResource module and provides metadata\n */\nfunction FrontMcpResource(providedMetadata: ResourceMetadata): ClassDecorator {\n  return (target: Function) => {\n    const metadata = frontMcpResourceMetadataSchema.parse(providedMetadata);\n\n    Reflect.defineMetadata(FrontMcpResourceTokens.type, true, target);\n\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpResourceTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\n\n/**\n * Decorator that marks a class as a McpResourceTemplate module and provides metadata\n */\nfunction FrontMcpResourceTemplate(providedMetadata: ResourceTemplateMetadata): ClassDecorator {\n  return (target: Function) => {\n    const metadata = frontMcpResourceTemplateMetadataSchema.parse(providedMetadata);\n\n    Reflect.defineMetadata(FrontMcpResourceTemplateTokens.type, true, target);\n\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpResourceTemplateTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\n\nexport type FrontMcpResourceExecuteHandler = (\n  uri: ReadResourceRequest['params']['uri'],\n  ...tokens: any[]\n) => ReadResourceResult | Promise<ReadResourceResult>;\n\n/**\n * Decorator that marks a class as a McpResource module and provides metadata\n */\nfunction frontMcpResource<T extends ResourceMetadata>(providedMetadata: T): (handler: FrontMcpResourceExecuteHandler) => (() => void) {\n  return (execute) => {\n    const metadata = frontMcpResourceMetadataSchema.parse(providedMetadata);\n    const toolFunction = function () {\n      return execute;\n    };\n    Object.assign(toolFunction, {\n      [FrontMcpResourceTokens.type]: 'function-resource',\n      [FrontMcpResourceTokens.metadata]: metadata,\n    });\n    return toolFunction;\n  };\n}\n\n//\n// /**\n//  * Decorator that marks a class as a McpResource module and provides metadata\n//  */\n// function frontMcpResourceTemplate<T extends ResourceMetadata>(providedMetadata: T): (handler: FrontMcpResourceExecuteHandler) => (() => void) {\n//   return (execute) => {\n//     const metadata = frontMcpResourceMetadataSchema.parse(providedMetadata);\n//     const toolFunction = function() {\n//       return execute;\n//     };\n//     Object.assign(toolFunction, {\n//       [FrontMcpResourceTokens.type]: 'function-resource',\n//       [FrontMcpResourceTokens.metadata]: metadata,\n//     });\n//     return toolFunction;\n//   };\n// }\n\n\nexport {\n  FrontMcpResource,\n  FrontMcpResource as Resource,\n  FrontMcpResourceTemplate,\n  FrontMcpResourceTemplate as ResourceTemplate,\n  frontMcpResource,\n  frontMcpResource as resource,\n};"]}

package/src/decorators/tool.decorator.d.ts

@@ -0,0 +1,14 @@
+import 'reflect-metadata';
+import { ToolMetadata } from '../metadata';
+import z from 'zod';
+import { ToolContext } from "../interfaces";
+/**
+ * Decorator that marks a class as a McpTool module and provides metadata
+ */
+declare function FrontMcpTool(providedMetadata: ToolMetadata): ClassDecorator;
+export type FrontMcpToolExecuteHandler<In, Out> = (input: In, ctx: ToolContext<In, Out>) => Out | Promise<Out>;
+/**
+ * Decorator that marks a class as a McpTool module and provides metadata
+ */
+declare function frontMcpTool<T extends ToolMetadata, In = z.baseObjectInputType<T['inputSchema']>, Out = T['outputSchema'] extends z.ZodRawShape ? z.baseObjectInputType<T['outputSchema']> : unknown>(providedMetadata: T): (handler: FrontMcpToolExecuteHandler<In, Out>) => (() => void);
+export { FrontMcpTool, FrontMcpTool as Tool, frontMcpTool, frontMcpTool as tool, };

package/src/decorators/tool.decorator.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontMcpTool = FrontMcpTool;
+exports.Tool = FrontMcpTool;
+exports.frontMcpTool = frontMcpTool;
+exports.tool = frontMcpTool;
+require("reflect-metadata");
+const tokens_1 = require("../tokens");
+const metadata_1 = require("../metadata");
+/**
+ * Decorator that marks a class as a McpTool module and provides metadata
+ */
+function FrontMcpTool(providedMetadata) {
+    return (target) => {
+        const metadata = metadata_1.frontMcpToolMetadataSchema.parse(providedMetadata);
+        Reflect.defineMetadata(tokens_1.FrontMcpToolTokens.type, true, target);
+        for (const property in metadata) {
+            Reflect.defineMetadata(tokens_1.FrontMcpToolTokens[property] ?? property, metadata[property], target);
+        }
+    };
+}
+/**
+ * Decorator that marks a class as a McpTool module and provides metadata
+ */
+function frontMcpTool(providedMetadata) {
+    return (execute) => {
+        const metadata = metadata_1.frontMcpToolMetadataSchema.parse(providedMetadata);
+        const toolFunction = function () {
+            return execute;
+        };
+        Object.assign(toolFunction, {
+            [tokens_1.FrontMcpToolTokens.type]: 'function-tool',
+            [tokens_1.FrontMcpToolTokens.metadata]: metadata,
+        });
+        return toolFunction;
+    };
+}
+//# sourceMappingURL=tool.decorator.js.map

package/src/decorators/tool.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.decorator.js","sourceRoot":"","sources":["../../../src/decorators/tool.decorator.ts"],"names":[],"mappings":";;AA8CE,oCAAY;AACI,4BAAI;AACpB,oCAAY;AACI,4BAAI;AAjDtB,4BAA0B;AAC1B,sCAA+C;AAC/C,0CAAuE;AAIvE;;GAEG;AACH,SAAS,YAAY,CAAC,gBAA8B;IAElD,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,MAAM,QAAQ,GAAG,qCAA0B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAEpE,OAAO,CAAC,cAAc,CAAC,2BAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAE9D,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,2BAAkB,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAKD;;GAEG;AACH,SAAS,YAAY,CAGnB,gBAAmB;IACnB,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,qCAA0B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACpE,MAAM,YAAY,GAAG;YACnB,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE;YAC1B,CAAC,2BAAkB,CAAC,IAAI,CAAC,EAAE,eAAe;YAC1C,CAAC,2BAAkB,CAAC,QAAQ,CAAC,EAAE,QAAQ;SACxC,CAAC,CAAC;QACH,OAAO,YAAY,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpToolTokens } from '../tokens';\nimport { ToolMetadata, frontMcpToolMetadataSchema } from '../metadata';\nimport z from 'zod';\nimport {ToolContext} from \"../interfaces\";\n\n/**\n * Decorator that marks a class as a McpTool module and provides metadata\n */\nfunction FrontMcpTool(providedMetadata: ToolMetadata): ClassDecorator {\n\n  return (target: any) => {\n    const metadata = frontMcpToolMetadataSchema.parse(providedMetadata);\n\n    Reflect.defineMetadata(FrontMcpToolTokens.type, true, target);\n\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpToolTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\n\nexport type FrontMcpToolExecuteHandler<In, Out> = (input: In, ctx: ToolContext<In, Out>) => Out | Promise<Out>;\n\n/**\n * Decorator that marks a class as a McpTool module and provides metadata\n */\nfunction frontMcpTool<T extends ToolMetadata,\n  In = z.baseObjectInputType<T['inputSchema']>,\n  Out = T['outputSchema'] extends z.ZodRawShape ? z.baseObjectInputType<T['outputSchema']> : unknown\n>(providedMetadata: T): (handler: FrontMcpToolExecuteHandler<In, Out>) => (() => void) {\n  return (execute) => {\n    const metadata = frontMcpToolMetadataSchema.parse(providedMetadata);\n    const toolFunction = function() {\n      return execute;\n    };\n    Object.assign(toolFunction, {\n      [FrontMcpToolTokens.type]: 'function-tool',\n      [FrontMcpToolTokens.metadata]: metadata,\n    });\n    return toolFunction;\n  };\n}\n\nexport {\n  FrontMcpTool,\n  FrontMcpTool as Tool,\n  frontMcpTool,\n  frontMcpTool as tool,\n};"]}

package/src/decorators-old/async-with.decorator.d.ts

@@ -0,0 +1,9 @@
+import 'reflect-metadata';
+export declare const META_ASYNC_WITH = "mcp:asyncWith";
+export declare const META_ASYNC_WITH_TOKENS = "mcp:asyncWith:tokens";
+/**
+ * @AsyncWith(optionalLazyTokens)
+ * - Marks a static with(...) as the factory for this provider.
+ * - If you pass a lazy resolver, we won't read design:paramtypes (ESM-TDZ safe).
+ */
+export declare function AsyncWith(tokens?: () => any[]): MethodDecorator;

package/src/decorators-old/async-with.decorator.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.META_ASYNC_WITH_TOKENS = exports.META_ASYNC_WITH = void 0;
+exports.AsyncWith = AsyncWith;
+require("reflect-metadata");
+exports.META_ASYNC_WITH = 'mcp:asyncWith';
+exports.META_ASYNC_WITH_TOKENS = 'mcp:asyncWith:tokens';
+/**
+ * @AsyncWith(optionalLazyTokens)
+ * - Marks a static with(...) as the factory for this provider.
+ * - If you pass a lazy resolver, we won't read design:paramtypes (ESM-TDZ safe).
+ */
+function AsyncWith(tokens) {
+    return (target, propertyKey, descriptor) => {
+        const ctor = target.constructor ?? target; // static method => target is ctor
+        Reflect.defineMetadata(exports.META_ASYNC_WITH, true, ctor);
+        if (typeof tokens === 'function') {
+            Reflect.defineMetadata(exports.META_ASYNC_WITH_TOKENS, tokens, ctor);
+        }
+        return descriptor;
+    };
+}
+//# sourceMappingURL=async-with.decorator.js.map

package/src/decorators-old/async-with.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-with.decorator.js","sourceRoot":"","sources":["../../../src/decorators-old/async-with.decorator.ts"],"names":[],"mappings":";;;AASA,8BASC;AAlBD,4BAA0B;AACb,QAAA,eAAe,GAAG,eAAe,CAAC;AAClC,QAAA,sBAAsB,GAAG,sBAAsB,CAAC;AAE7D;;;;GAIG;AACH,SAAgB,SAAS,CAAC,MAAoB;IAC5C,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE;QACzC,MAAM,IAAI,GAAI,MAAc,CAAC,WAAW,IAAI,MAAM,CAAC,CAAC,kCAAkC;QACtF,OAAO,CAAC,cAAc,CAAC,uBAAe,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACpD,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,OAAO,CAAC,cAAc,CAAC,8BAAsB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,UAAW,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nexport const META_ASYNC_WITH = 'mcp:asyncWith';\nexport const META_ASYNC_WITH_TOKENS = 'mcp:asyncWith:tokens';\n\n/**\n * @AsyncWith(optionalLazyTokens)\n * - Marks a static with(...) as the factory for this provider.\n * - If you pass a lazy resolver, we won't read design:paramtypes (ESM-TDZ safe).\n */\nexport function AsyncWith(tokens?: () => any[]): MethodDecorator {\n  return (target, propertyKey, descriptor) => {\n    const ctor = (target as any).constructor ?? target; // static method => target is ctor\n    Reflect.defineMetadata(META_ASYNC_WITH, true, ctor);\n    if (typeof tokens === 'function') {\n      Reflect.defineMetadata(META_ASYNC_WITH_TOKENS, tokens, ctor);\n    }\n    return descriptor!;\n  };\n}"]}

package/src/decorators-old/auth-hook.decorator.d.ts

@@ -0,0 +1,14 @@
+import 'reflect-metadata';
+import { AuthHookStage } from '../interfaces/auth-hook.interface';
+export type AuthHookOptions = {
+    priority?: number;
+    /** Name of a filter method on same class (static or instance) */
+    filter?: string;
+};
+/**
+ * Decorator for declaring global Tool hooks on plugin classes.
+ * Usage:
+ *   @AuthHook('willExchangeToken')
+ *   static willExchangeToken(ctx: AuthInvokeContext) { ... }
+ */
+export declare function AuthHook(stage: AuthHookStage, opts?: AuthHookOptions): (target: any, propertyKey: string, _desc: PropertyDescriptor) => void;

package/src/decorators-old/auth-hook.decorator.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthHook = AuthHook;
+require("reflect-metadata");
+const constants_1 = require("../constants");
+/**
+ * Decorator for declaring global Tool hooks on plugin classes.
+ * Usage:
+ *   @AuthHook('willExchangeToken')
+ *   static willExchangeToken(ctx: AuthInvokeContext) { ... }
+ */
+function AuthHook(stage, opts) {
+    return function (target, propertyKey, _desc) {
+        const isStatic = typeof target === 'function'; // static methods receive constructor as target
+        const clazz = isStatic ? target : target.constructor;
+        const arr = Reflect.getOwnMetadata(constants_1.MCP_AUTH_HOOKS, clazz) ?? [];
+        arr.push({
+            stage,
+            methodName: propertyKey,
+            isStatic,
+            priority: opts?.priority,
+            filterKey: opts?.filter,
+        });
+        Reflect.defineMetadata(constants_1.MCP_AUTH_HOOKS, arr, clazz);
+    };
+}
+//# sourceMappingURL=auth-hook.decorator.js.map

package/src/decorators-old/auth-hook.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-hook.decorator.js","sourceRoot":"","sources":["../../../src/decorators-old/auth-hook.decorator.ts"],"names":[],"mappings":";;AAgBA,4BAcC;AA9BD,4BAA0B;AAC1B,4CAA8C;AAS9C;;;;;GAKG;AACH,SAAgB,QAAQ,CAAC,KAAoB,EAAE,IAAsB;IACnE,OAAO,UAAU,MAAW,EAAE,WAAmB,EAAE,KAAyB;QAC1E,MAAM,QAAQ,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,+CAA+C;QAC9F,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;QACrD,MAAM,GAAG,GAAU,OAAO,CAAC,cAAc,CAAC,0BAAc,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QACvE,GAAG,CAAC,IAAI,CAAC;YACP,KAAK;YACL,UAAU,EAAE,WAAW;YACvB,QAAQ;YACR,QAAQ,EAAE,IAAI,EAAE,QAAQ;YACxB,SAAS,EAAE,IAAI,EAAE,MAAM;SACxB,CAAC,CAAC;QACH,OAAO,CAAC,cAAc,CAAC,0BAAc,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { MCP_AUTH_HOOKS } from '../constants';\nimport { AuthHookStage } from '../interfaces/auth-hook.interface';\n\nexport type AuthHookOptions = {\n  priority?: number;\n  /** Name of a filter method on same class (static or instance) */\n  filter?: string;\n};\n\n/**\n * Decorator for declaring global Tool hooks on plugin classes.\n * Usage:\n *   @AuthHook('willExchangeToken')\n *   static willExchangeToken(ctx: AuthInvokeContext) { ... }\n */\nexport function AuthHook(stage: AuthHookStage, opts?: AuthHookOptions) {\n  return function (target: any, propertyKey: string, _desc: PropertyDescriptor) {\n    const isStatic = typeof target === 'function'; // static methods receive constructor as target\n    const clazz = isStatic ? target : target.constructor;\n    const arr: any[] = Reflect.getOwnMetadata(MCP_AUTH_HOOKS, clazz) ?? [];\n    arr.push({\n      stage,\n      methodName: propertyKey,\n      isStatic,\n      priority: opts?.priority,\n      filterKey: opts?.filter,\n    });\n    Reflect.defineMetadata(MCP_AUTH_HOOKS, arr, clazz);\n  };\n}\n"]}

package/src/decorators-old/session-hook.decorator.d.ts

@@ -0,0 +1,14 @@
+import 'reflect-metadata';
+import { SessionHookStage } from '../interfaces/session-hook.interface';
+export type SessionHookOptions = {
+    priority?: number;
+    /** Name of a filter method on same class (static or instance) */
+    filter?: string;
+};
+/**
+ * Decorator for declaring global Tool hooks on plugin classes.
+ * Usage:
+ *   @SessionHook('willCreateSession')
+ *   static willCreateSession(ctx: SessionInvokeContext) { ... }
+ */
+export declare function SessionHook(stage: SessionHookStage, opts?: SessionHookOptions): (target: any, propertyKey: string, _desc: PropertyDescriptor) => void;

package/src/decorators-old/session-hook.decorator.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionHook = SessionHook;
+require("reflect-metadata");
+const constants_1 = require("../constants");
+/**
+ * Decorator for declaring global Tool hooks on plugin classes.
+ * Usage:
+ *   @SessionHook('willCreateSession')
+ *   static willCreateSession(ctx: SessionInvokeContext) { ... }
+ */
+function SessionHook(stage, opts) {
+    return function (target, propertyKey, _desc) {
+        const isStatic = typeof target === 'function'; // static methods receive constructor as target
+        const clazz = isStatic ? target : target.constructor;
+        const arr = Reflect.getOwnMetadata(constants_1.MCP_SESSION_HOOKS, clazz) ?? [];
+        arr.push({
+            stage,
+            methodName: propertyKey,
+            isStatic,
+            priority: opts?.priority,
+            filterKey: opts?.filter,
+        });
+        Reflect.defineMetadata(constants_1.MCP_SESSION_HOOKS, arr, clazz);
+    };
+}
+//# sourceMappingURL=session-hook.decorator.js.map

package/src/decorators-old/session-hook.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-hook.decorator.js","sourceRoot":"","sources":["../../../src/decorators-old/session-hook.decorator.ts"],"names":[],"mappings":";;AAgBA,kCAcC;AA9BD,4BAA0B;AAC1B,4CAAiD;AASjD;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,KAAuB,EAAE,IAAyB;IAC5E,OAAO,UAAU,MAAW,EAAE,WAAmB,EAAE,KAAyB;QAC1E,MAAM,QAAQ,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,+CAA+C;QAC9F,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;QACrD,MAAM,GAAG,GAAU,OAAO,CAAC,cAAc,CAAC,6BAAiB,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1E,GAAG,CAAC,IAAI,CAAC;YACP,KAAK;YACL,UAAU,EAAE,WAAW;YACvB,QAAQ;YACR,QAAQ,EAAE,IAAI,EAAE,QAAQ;YACxB,SAAS,EAAE,IAAI,EAAE,MAAM;SACxB,CAAC,CAAC;QACH,OAAO,CAAC,cAAc,CAAC,6BAAiB,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { MCP_SESSION_HOOKS } from '../constants';\nimport { SessionHookStage } from '../interfaces/session-hook.interface';\n\nexport type SessionHookOptions = {\n  priority?: number;\n  /** Name of a filter method on same class (static or instance) */\n  filter?: string;\n};\n\n/**\n * Decorator for declaring global Tool hooks on plugin classes.\n * Usage:\n *   @SessionHook('willCreateSession')\n *   static willCreateSession(ctx: SessionInvokeContext) { ... }\n */\nexport function SessionHook(stage: SessionHookStage, opts?: SessionHookOptions) {\n  return function (target: any, propertyKey: string, _desc: PropertyDescriptor) {\n    const isStatic = typeof target === 'function'; // static methods receive constructor as target\n    const clazz = isStatic ? target : target.constructor;\n    const arr: any[] = Reflect.getOwnMetadata(MCP_SESSION_HOOKS, clazz) ?? [];\n    arr.push({\n      stage,\n      methodName: propertyKey,\n      isStatic,\n      priority: opts?.priority,\n      filterKey: opts?.filter,\n    });\n    Reflect.defineMetadata(MCP_SESSION_HOOKS, arr, clazz);\n  };\n}\n"]}

package/src/decorators-old/tool-hook.decorator.d.ts

@@ -0,0 +1,14 @@
+import 'reflect-metadata';
+import { ToolHookStage } from '../interfaces/tool-hook.interface';
+export type ToolHookOptions = {
+    priority?: number;
+    /** Name of a filter method on same class (static or instance) */
+    filter?: string;
+};
+/**
+ * Decorator for declaring global Tool hooks on plugin classes.
+ * Usage:
+ *   @ToolHook('willReadCache')
+ *   static willReadCache(ctx: ToolInvokeContext) { ... }
+ */
+export declare function ToolHook(stage: ToolHookStage, opts?: ToolHookOptions): (target: any, propertyKey: string, _desc: PropertyDescriptor) => void;

package/src/decorators-old/tool-hook.decorator.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolHook = ToolHook;
+require("reflect-metadata");
+const constants_1 = require("../constants");
+/**
+ * Decorator for declaring global Tool hooks on plugin classes.
+ * Usage:
+ *   @ToolHook('willReadCache')
+ *   static willReadCache(ctx: ToolInvokeContext) { ... }
+ */
+function ToolHook(stage, opts) {
+    return function (target, propertyKey, _desc) {
+        const isStatic = typeof target === 'function'; // static methods receive constructor as target
+        const clazz = isStatic ? target : target.constructor;
+        const arr = Reflect.getOwnMetadata(constants_1.MCP_TOOL_HOOKS, clazz) ?? [];
+        arr.push({
+            stage,
+            methodName: propertyKey,
+            isStatic,
+            priority: opts?.priority,
+            filterKey: opts?.filter,
+        });
+        Reflect.defineMetadata(constants_1.MCP_TOOL_HOOKS, arr, clazz);
+    };
+}
+//# sourceMappingURL=tool-hook.decorator.js.map

package/src/decorators-old/tool-hook.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-hook.decorator.js","sourceRoot":"","sources":["../../../src/decorators-old/tool-hook.decorator.ts"],"names":[],"mappings":";;AAgBA,4BAcC;AA9BD,4BAA0B;AAC1B,4CAA8C;AAS9C;;;;;GAKG;AACH,SAAgB,QAAQ,CAAC,KAAoB,EAAE,IAAsB;IACnE,OAAO,UAAU,MAAW,EAAE,WAAmB,EAAE,KAAyB;QAC1E,MAAM,QAAQ,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,+CAA+C;QAC9F,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;QACrD,MAAM,GAAG,GAAU,OAAO,CAAC,cAAc,CAAC,0BAAc,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QACvE,GAAG,CAAC,IAAI,CAAC;YACP,KAAK;YACL,UAAU,EAAE,WAAW;YACvB,QAAQ;YACR,QAAQ,EAAE,IAAI,EAAE,QAAQ;YACxB,SAAS,EAAE,IAAI,EAAE,MAAM;SACxB,CAAC,CAAC;QACH,OAAO,CAAC,cAAc,CAAC,0BAAc,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { MCP_TOOL_HOOKS } from '../constants';\nimport { ToolHookStage } from '../interfaces/tool-hook.interface';\n\nexport type ToolHookOptions = {\n  priority?: number;\n  /** Name of a filter method on same class (static or instance) */\n  filter?: string;\n};\n\n/**\n * Decorator for declaring global Tool hooks on plugin classes.\n * Usage:\n *   @ToolHook('willReadCache')\n *   static willReadCache(ctx: ToolInvokeContext) { ... }\n */\nexport function ToolHook(stage: ToolHookStage, opts?: ToolHookOptions) {\n  return function (target: any, propertyKey: string, _desc: PropertyDescriptor) {\n    const isStatic = typeof target === 'function'; // static methods receive constructor as target\n    const clazz = isStatic ? target : target.constructor;\n    const arr: any[] = Reflect.getOwnMetadata(MCP_TOOL_HOOKS, clazz) ?? [];\n    arr.push({\n      stage,\n      methodName: propertyKey,\n      isStatic,\n      priority: opts?.priority,\n      filterKey: opts?.filter,\n    });\n    Reflect.defineMetadata(MCP_TOOL_HOOKS, arr, clazz);\n  };\n}\n"]}

package/src/dynamic/dynamic.adapter.d.ts

@@ -0,0 +1,42 @@
+import { Reference, FrontMcpAdapterResponse, AdapterType, AdapterInterface } from '../interfaces';
+type InitOptions<T> = ((T & {
+    useFactory?: never;
+    inject?: never;
+    name: string;
+})) | {
+    inject: () => readonly Reference<any>[];
+    useFactory: (...args: any[]) => T;
+    name: string;
+};
+type AdapterClassWithOptions<T> = {
+    new (...args: any[]): any;
+    prototype: {
+        __options_brand?: T;
+    };
+};
+type AdapterReturn<T> = AdapterType;
+export declare abstract class DynamicAdapter<TOptions extends object> implements AdapterInterface {
+    abstract options: {
+        name: string;
+    } & TOptions;
+    /**
+     * Private property to ensure options are typed correctly.
+     */
+    __options_brand: TOptions;
+    /**
+     * Static init() method to create a plugin provider.
+     * @param options
+     */
+    static init<TThis extends AdapterClassWithOptions<any>>(this: TThis, options: InitOptions<TThis['prototype'] extends {
+        __options_brand?: infer O;
+    } ? O : never>): AdapterReturn<TThis['prototype'] extends {
+        __options_brand?: infer O;
+    } ? O : never>;
+    /**
+     * Abstract fetch method to be implemented by subclasses.
+     * @returns A promise resolving to any type the will be used
+     * to trnasform into tools, resources, prompts, etc.
+     */
+    abstract fetch(): Promise<FrontMcpAdapterResponse> | FrontMcpAdapterResponse;
+}
+export {};

package/src/dynamic/dynamic.adapter.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamicAdapter = void 0;
+class DynamicAdapter {
+    /**
+     * Static init() method to create a plugin provider.
+     * @param options
+     */
+    static init(options) {
+        const typedOptions = options;
+        if ('useFactory' in options) {
+            const { inject, useFactory, ...rest } = typedOptions;
+            return {
+                provide: this,
+                inject: options.inject,
+                useFactory: options.useFactory,
+                ...rest,
+            };
+        }
+        return {
+            ...typedOptions,
+            provide: this,
+            useValue: new this(options),
+        };
+    }
+}
+exports.DynamicAdapter = DynamicAdapter;
+//# sourceMappingURL=dynamic.adapter.js.map

package/src/dynamic/dynamic.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic.adapter.js","sourceRoot":"","sources":["../../../src/dynamic/dynamic.adapter.ts"],"names":[],"mappings":";;;AA4BA,MAAsB,cAAc;IAOlC;;;OAGG;IACH,MAAM,CAAC,IAAI,CAET,OAA0F;QAE1F,MAAM,YAAY,GAAG,OAAc,CAAC;QAEpC,IAAI,YAAY,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,YAAY,CAAC;YACrD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,OAAO,CAAC,MAAgC;gBAChD,UAAU,EAAE,OAAO,CAAC,UAAiB;gBACrC,GAAG,IAAI;aACR,CAAC;QACJ,CAAC;QACD,OAAO;YACL,GAAG,YAAY;YACf,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC;SAC5B,CAAC;IACJ,CAAC;CAQF;AAvCD,wCAuCC","sourcesContent":["// dynamic-adapter.ts\nimport {\n  Reference,\n  FrontMcpAdapterResponse,\n  AdapterType,\n  AdapterInterface,\n} from '../interfaces';\n\n// keep your original options union; just add optional `providers`\ntype InitOptions<T> =\n  | ((T & {\n    useFactory?: never;\n    inject?: never;\n    name: string;\n  }))\n  | {\n  inject: () => readonly Reference<any>[];\n  useFactory: (...args: any[]) => T;\n  name: string;\n};\n\ntype AdapterClassWithOptions<T> = {\n  new(...args: any[]): any;\n  prototype: { __options_brand?: T };\n};\n\ntype AdapterReturn<T> = AdapterType\n\nexport abstract class DynamicAdapter<TOptions extends object> implements AdapterInterface {\n  abstract options: {name:string} & TOptions\n  /**\n   * Private property to ensure options are typed correctly.\n   */\n  declare __options_brand: TOptions;\n\n  /**\n   * Static init() method to create a plugin provider.\n   * @param options\n   */\n  static init<TThis extends AdapterClassWithOptions<any>>(\n    this: TThis,\n    options: InitOptions<TThis['prototype'] extends { __options_brand?: infer O } ? O : never>,\n  ): AdapterReturn<TThis['prototype'] extends { __options_brand?: infer O } ? O : never> {\n    const typedOptions = options as any;\n\n    if ('useFactory' in options) {\n      const { inject, useFactory, ...rest } = typedOptions;\n      return {\n        provide: this,\n        inject: options.inject as () => Reference<any>[],\n        useFactory: options.useFactory as any,\n        ...rest,\n      };\n    }\n    return {\n      ...typedOptions,\n      provide: this,\n      useValue: new this(options),\n    };\n  }\n\n  /**\n   * Abstract fetch method to be implemented by subclasses.\n   * @returns A promise resolving to any type the will be used\n   * to trnasform into tools, resources, prompts, etc.\n   */\n  abstract fetch(): Promise<FrontMcpAdapterResponse> | FrontMcpAdapterResponse;\n}\n\n"]}

package/src/dynamic/dynamic.plugin.d.ts

@@ -0,0 +1,52 @@
+import { Reference, PluginType, ProviderType } from '../interfaces';
+type InitOptions<T> = ((T & {
+    useFactory?: never;
+    inject?: never;
+}) & {
+    providers?: readonly ProviderType[];
+}) | {
+    inject: () => readonly Reference<any>[];
+    useFactory: (...args: any[]) => T;
+    providers?: readonly ProviderType[];
+};
+type PluginClassWithOptions<T> = {
+    new (...args: any[]): any;
+    prototype: {
+        __options_brand?: T;
+    };
+    dynamicProviders?: (options: T) => readonly ProviderType[];
+};
+type ValueMcpPlugin<T> = {
+    provide: any;
+    useValue: T;
+    providers?: ProviderType[];
+};
+type FactoryMcpPlugin<T> = {
+    provide: any;
+    inject: () => readonly Reference<any>[];
+    useFactory: (...args: any[]) => T;
+};
+type PluginReturn<T> = (ValueMcpPlugin<T> | FactoryMcpPlugin<T>) & PluginType & {
+    providers?: readonly ProviderType[];
+};
+export declare abstract class DynamicPlugin<TOptions extends object> {
+    /**
+     * Private property to ensure options are typed correctly.
+     */
+    __options_brand: TOptions;
+    /**
+     * Optional hook to contribute providers to the plugin.
+     * @param options
+     */
+    static dynamicProviders?(options: any): readonly ProviderType[];
+    /**
+     * Static init() method to create a plugin provider.
+     * @param options
+     */
+    static init<TThis extends PluginClassWithOptions<any>>(this: TThis, options: InitOptions<TThis['prototype'] extends {
+        __options_brand?: infer O;
+    } ? O : never>): PluginReturn<TThis['prototype'] extends {
+        __options_brand?: infer O;
+    } ? O : never>;
+}
+export {};

package/src/dynamic/dynamic.plugin.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamicPlugin = void 0;
+const dynamic_utils_1 = require("./dynamic.utils");
+class DynamicPlugin {
+    /**
+     * Static init() method to create a plugin provider.
+     * @param options
+     */
+    static init(options) {
+        const extraProviders = options.providers;
+        const typedOptions = options;
+        if ('useFactory' in options) {
+            return {
+                ...typedOptions,
+                provide: this,
+                inject: options.inject,
+                useFactory: options.useFactory,
+                providers: (0, dynamic_utils_1.dedupePluginProviders)(extraProviders ?? []),
+            };
+        }
+        const dyn = (0, dynamic_utils_1.collectDynamicProviders)(this, typedOptions);
+        const mergedProviders = (0, dynamic_utils_1.dedupePluginProviders)([...(dyn ?? []), ...(extraProviders ?? [])]);
+        return {
+            ...typedOptions,
+            provide: this,
+            useValue: new this(options),
+            providers: mergedProviders,
+        };
+    }
+}
+exports.DynamicPlugin = DynamicPlugin;
+//# sourceMappingURL=dynamic.plugin.js.map

package/src/dynamic/dynamic.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic.plugin.js","sourceRoot":"","sources":["../../../src/dynamic/dynamic.plugin.ts"],"names":[],"mappings":";;;AAEA,mDAAiF;AA0BjF,MAAsB,aAAa;IAYjC;;;OAGG;IACH,MAAM,CAAC,IAAI,CAET,OAA0F;QAE1F,MAAM,cAAc,GAAI,OAAe,CAAC,SAAgD,CAAC;QACzF,MAAM,YAAY,GAAG,OAAc,CAAC;QAEpC,IAAI,YAAY,IAAI,OAAO,EAAE,CAAC;YAC5B,OAAO;gBACL,GAAG,YAAY;gBACf,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,OAAO,CAAC,MAAgC;gBAChD,UAAU,EAAE,OAAO,CAAC,UAAiB;gBACrC,SAAS,EAAE,IAAA,qCAAqB,EAAC,cAAc,IAAI,EAAE,CAAC;aAEvD,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,IAAA,uCAAuB,EAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACxD,MAAM,eAAe,GAAG,IAAA,qCAAqB,EAAC,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3F,OAAO;YACL,GAAG,YAAY;YACf,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC;YAC3B,SAAS,EAAE,eAAe;SAC3B,CAAC;IACJ,CAAC;CACF;AA3CD,sCA2CC","sourcesContent":["// dynamic-plugin.ts\nimport { Reference, PluginType, ProviderType } from '../interfaces';\nimport { collectDynamicProviders, dedupePluginProviders } from './dynamic.utils';\n\n// keep your original options union; just add optional `providers`\ntype InitOptions<T> =\n  | ((T & { useFactory?: never; inject?: never }) & { providers?: readonly ProviderType[] })\n  | {\n  inject: () => readonly Reference<any>[];\n  useFactory: (...args: any[]) => T;\n  providers?: readonly ProviderType[];\n};\n\ntype PluginClassWithOptions<T> = {\n  new(...args: any[]): any;\n  prototype: { __options_brand?: T };\n  // optional hook contributed by plugin authors\n  dynamicProviders?: (options: T) => readonly ProviderType[];\n};\n\ntype ValueMcpPlugin<T> = { provide: any; useValue: T; providers?: ProviderType[] };\ntype FactoryMcpPlugin<T> = { provide: any; inject: () => readonly Reference<any>[]; useFactory: (...args: any[]) => T };\n\ntype PluginReturn<T> = (ValueMcpPlugin<T> | FactoryMcpPlugin<T>) &\n  PluginType & {\n  providers?: readonly ProviderType[];\n};\n\nexport abstract class DynamicPlugin<TOptions extends object> {\n  /**\n   * Private property to ensure options are typed correctly.\n   */\n  declare __options_brand: TOptions;\n\n  /**\n   * Optional hook to contribute providers to the plugin.\n   * @param options\n   */\n  static dynamicProviders?(options: any): readonly ProviderType[];\n\n  /**\n   * Static init() method to create a plugin provider.\n   * @param options\n   */\n  static init<TThis extends PluginClassWithOptions<any>>(\n    this: TThis,\n    options: InitOptions<TThis['prototype'] extends { __options_brand?: infer O } ? O : never>,\n  ): PluginReturn<TThis['prototype'] extends { __options_brand?: infer O } ? O : never> {\n    const extraProviders = (options as any).providers as readonly ProviderType[] | undefined;\n    const typedOptions = options as any;\n\n    if ('useFactory' in options) {\n      return {\n        ...typedOptions,\n        provide: this,\n        inject: options.inject as () => Reference<any>[],\n        useFactory: options.useFactory as any,\n        providers: dedupePluginProviders(extraProviders ?? []),\n\n      };\n    }\n\n    const dyn = collectDynamicProviders(this, typedOptions);\n    const mergedProviders = dedupePluginProviders([...(dyn ?? []), ...(extraProviders ?? [])]);\n    return {\n      ...typedOptions,\n      provide: this,\n      useValue: new this(options),\n      providers: mergedProviders,\n    };\n  }\n}"]}

package/src/dynamic/dynamic.utils.d.ts

@@ -0,0 +1,3 @@
+import { ProviderType } from '@frontmcp/sdk';
+export declare function collectDynamicProviders<T>(klass: any, options: T): ProviderType[];
+export declare function dedupePluginProviders(providers: readonly ProviderType[]): ProviderType[];

package/src/dynamic/dynamic.utils.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectDynamicProviders = collectDynamicProviders;
+exports.dedupePluginProviders = dedupePluginProviders;
+function collectDynamicProviders(klass, options) {
+    // walk the prototype chain so parent plugins can contribute
+    const chain = [];
+    for (let k = klass; k && k !== Function.prototype; k = Object.getPrototypeOf(k)) {
+        chain.push(k);
+    }
+    // parent-first; child can override tokens later
+    const out = [];
+    for (let i = chain.length - 1; i >= 0; i--) {
+        const k = chain[i];
+        if (typeof k.dynamicProviders === 'function') {
+            out.push(...(k.dynamicProviders(options) ?? []));
+        }
+    }
+    return out;
+}
+function dedupePluginProviders(providers) {
+    const map = new Map();
+    for (const p of providers)
+        map.set(p['provide'] ?? p, p); // class-as-token fallback
+    return [...map.values()];
+}
+//# sourceMappingURL=dynamic.utils.js.map

package/src/dynamic/dynamic.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic.utils.js","sourceRoot":"","sources":["../../../src/dynamic/dynamic.utils.ts"],"names":[],"mappings":";;AAEA,0DAeC;AAED,sDAIC;AArBD,SAAgB,uBAAuB,CAAI,KAAU,EAAE,OAAU;IAC/D,4DAA4D;IAC5D,MAAM,KAAK,GAAU,EAAE,CAAC;IACxB,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChB,CAAC;IACD,gDAAgD;IAChD,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,OAAO,CAAC,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;YAC7C,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,qBAAqB,CAAC,SAAkC;IACtE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAqB,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAQ,CAAC,CAAC,CAAC,0BAA0B;IAC3F,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;AAC3B,CAAC","sourcesContent":["import { ProviderType } from '@frontmcp/sdk';\n\nexport function collectDynamicProviders<T>(klass: any, options: T): ProviderType[] {\n  // walk the prototype chain so parent plugins can contribute\n  const chain: any[] = [];\n  for (let k = klass; k && k !== Function.prototype; k = Object.getPrototypeOf(k)) {\n    chain.push(k);\n  }\n  // parent-first; child can override tokens later\n  const out: ProviderType[] = [];\n  for (let i = chain.length - 1; i >= 0; i--) {\n    const k = chain[i];\n    if (typeof k.dynamicProviders === 'function') {\n      out.push(...(k.dynamicProviders(options) ?? []));\n    }\n  }\n  return out;\n}\n\nexport function dedupePluginProviders(providers: readonly ProviderType[]): ProviderType[] {\n  const map = new Map<any, ProviderType>();\n  for (const p of providers) map.set(p['provide'] ?? p, p as any); // class-as-token fallback\n  return [...map.values()];\n}\n"]}

package/src/dynamic/index.d.ts

@@ -0,0 +1,2 @@
+export * from './dynamic.adapter';
+export * from './dynamic.plugin';

package/src/dynamic/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./dynamic.adapter"), exports);
+tslib_1.__exportStar(require("./dynamic.plugin"), exports);
+//# sourceMappingURL=index.js.map

package/src/dynamic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dynamic/index.ts"],"names":[],"mappings":";;;AAAA,4DAAkC;AAClC,2DAAiC","sourcesContent":["export * from './dynamic.adapter';\nexport * from './dynamic.plugin';"]}

package/src/entries/adapter.entry.d.ts

@@ -0,0 +1,6 @@
+import { BaseEntry } from './base.entry';
+import { AdapterRecord } from '../records';
+import { AdapterInterface } from '../interfaces';
+import { AdapterMetadata } from '../metadata';
+export declare abstract class AdapterEntry extends BaseEntry<AdapterRecord, AdapterInterface, AdapterMetadata> {
+}