@frontmcp/sdk 0.4.0 → 0.5.0

package/src/common/decorators/hook.decorator.js

@@ -1,62 +1,172 @@
 "use strict";
+/**
+ * Flow Hook Decorators
+ *
+ * This module provides decorators for defining flow stages and lifecycle hooks.
+ * Supports both legacy TypeScript decorators and TC39 Stage 3 decorators.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePendingTC39HooksForClass = resolvePendingTC39HooksForClass;
+exports.registerPendingTC39Hook = registerPendingTC39Hook;
+exports.consumePendingTC39Hooks = consumePendingTC39Hooks;
 exports.StageHookOf = StageHookOf;
 exports.WillHookOf = WillHookOf;
 exports.DidHookOf = DidHookOf;
 exports.AroundHookOf = AroundHookOf;
 exports.FlowHooksOf = FlowHooksOf;
 const tokens_1 = require("../tokens");
-function registerFlowHook(target, meta) {
-    const ctor = target.constructor;
+const decorator_utils_1 = require("./decorator-utils");
+/**
+ * Pending metadata registry for TC39 decorators
+ * Stores hook metadata keyed by method function until class is processed
+ */
+const pendingHookRegistry = new decorator_utils_1.PendingMetadataRegistry();
+/**
+ * Register hook metadata on a class constructor
+ */
+function registerHookOnClass(ctor, meta) {
     const arr = Reflect.getMetadata(tokens_1.FrontMcpFlowHookTokens.hooks, ctor) ?? [];
     arr.push(meta);
     Reflect.defineMetadata(tokens_1.FrontMcpFlowHookTokens.hooks, arr, ctor);
 }
-/** Base factory (kept internal) */
+/**
+ * Resolve all pending TC39 hooks for a class by scanning its prototype
+ * This is called by collectFlowHookMap during flow registration
+ */
+function resolvePendingTC39HooksForClass(ctor) {
+    return pendingHookRegistry.resolveForClass(ctor);
+}
+/**
+ * Store a pending hook for TC39 mode
+ * @internal
+ */
+function registerPendingTC39Hook(method, meta) {
+    pendingHookRegistry.store(method, meta);
+}
+/**
+ * Get and clear pending hooks for a method (TC39 mode)
+ * @internal
+ */
+function consumePendingTC39Hooks(method) {
+    return pendingHookRegistry.consume(method);
+}
+/**
+ * Base factory for creating hook decorators
+ * Works with both legacy TypeScript and TC39 Stage 3 decorators
+ */
 function make(flow, type) {
     return function (stage, opts = {}) {
-        return (target, key, _desc) => {
+        return (target, keyOrContext, _desc) => {
             const { priority = 0, filter, ...rest } = opts;
-            registerFlowHook(target, {
-                ...rest,
-                [tokens_1.FrontMcpFlowHookTokens.type]: true,
-                flow: flow,
-                type: type,
-                stage: stage,
-                method: String(key),
-                priority: priority,
-                filter: filter,
-                target: target,
-                static: Boolean(target.constructor[key]),
-            });
+            // Detect TC39 Stage 3 decorators vs legacy TypeScript decorators
+            if ((0, decorator_utils_1.isTC39MethodContext)(keyOrContext)) {
+                // TC39 Stage 3 decorator style
+                const context = keyOrContext;
+                const methodName = String(context.name);
+                const isStatic = context.static;
+                const method = target; // In TC39, target is the method function itself
+                const meta = {
+                    ...rest,
+                    [tokens_1.FrontMcpFlowHookTokens.type]: true,
+                    flow: flow,
+                    type: type,
+                    stage: stage,
+                    method: methodName,
+                    priority: priority,
+                    filter: filter,
+                    target: null, // Will be resolved at execution time
+                    static: isStatic,
+                };
+                // Store as pending - resolved when collectFlowHookMap processes the class
+                pendingHookRegistry.store(method, meta);
+                // Return the original method unchanged
+                return target;
+            }
+            else {
+                // Legacy TypeScript decorator style
+                const key = keyOrContext;
+                const methodName = String(key);
+                const isStatic = typeof target === 'function';
+                const ctor = isStatic ? target : target.constructor;
+                const meta = {
+                    ...rest,
+                    [tokens_1.FrontMcpFlowHookTokens.type]: true,
+                    flow: flow,
+                    type: type,
+                    stage: stage,
+                    method: methodName,
+                    priority: priority,
+                    filter: filter,
+                    target: target,
+                    static: isStatic,
+                };
+                // Register immediately on the class
+                registerHookOnClass(ctor, meta);
+                return undefined;
+            }
         };
     };
 }
-/** NEW: typed variants */
+/**
+ * Creates a typed Stage hook decorator for a specific flow
+ * @example
+ * ```typescript
+ * const { Stage } = FlowHooksOf('http:request');
+ *
+ * class HttpRequestFlow {
+ *   @Stage('checkAuthorization')
+ *   async checkAuthorization() { ... }
+ * }
+ * ```
+ */
 function StageHookOf(flow) {
     const base = make(flow, 'stage');
     return function (stage, opts = {}) {
         return base(stage, opts);
     };
 }
+/**
+ * Creates a typed Will hook decorator (runs before stage)
+ */
 function WillHookOf(flow) {
     const base = make(flow, 'will');
     return function (stage, opts = {}) {
         return base(stage, opts);
     };
 }
+/**
+ * Creates a typed Did hook decorator (runs after stage)
+ */
 function DidHookOf(flow) {
     const base = make(flow, 'did');
     return function (stage, opts = {}) {
         return base(stage, opts);
     };
 }
+/**
+ * Creates a typed Around hook decorator (wraps stage execution)
+ */
 function AroundHookOf(name) {
     const base = make(name, 'around');
     return function (stage, opts = {}) {
         return base(stage, opts);
     };
 }
+/**
+ * Creates all hook decorators for a specific flow
+ * @example
+ * ```typescript
+ * const { Stage, Will, Did, Around } = FlowHooksOf('http:request');
+ *
+ * class HttpRequestFlow {
+ *   @Stage('checkAuthorization')
+ *   async checkAuthorization() { ... }
+ *
+ *   @Will('execute', { priority: 10 })
+ *   async beforeExecute() { ... }
+ * }
+ * ```
+ */
 function FlowHooksOf(name) {
     return {
         Stage: StageHookOf(name),

package/src/common/decorators/hook.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"hook.decorator.js","sourceRoot":"","sources":["../../../../src/common/decorators/hook.decorator.ts"],"names":[],"mappings":";;AAiCA,kCAOC;AAED,gCAOC;AAED,8BAOC;AAED,oCAOC;AAED,kCAOC;AA3ED,sCAAiD;AAGjD,SAAS,gBAAgB,CAAC,MAAW,EAAE,IAAkB;IACvD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC;IAChC,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,+BAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1E,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,OAAO,CAAC,cAAc,CAAC,+BAAsB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AAClE,CAAC;AAED,mCAAmC;AACnC,SAAS,IAAI,CAAC,IAAc,EAAE,IAAmB;IAC/C,OAAO,UAAoD,KAAQ,EAAE,OAAyB,EAAE;QAC9F,OAAO,CAAC,MAAW,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YACjC,MAAM,EAAC,QAAQ,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAC,GAAG,IAAI,CAAC;YAC7C,gBAAgB,CAAC,MAAM,EAAE;gBACvB,GAAG,IAAI;gBACP,CAAC,+BAAsB,CAAC,IAAI,CAAC,EAAE,IAAI;gBACnC,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;gBACnB,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;aACzC,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,0BAA0B;AAC1B,SAAgB,WAAW,CAAwB,IAAU;IAG3D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,UAAU,KAAQ,EAAE,OAAyB,EAAE;QACpD,OAAO,IAAI,CAAS,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,UAAU,CAAwB,IAAU;IAG1D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,UAAU,KAAQ,EAAE,OAAyB,EAAE;QACpD,OAAO,IAAI,CAAS,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,SAAS,CAAwB,IAAU;IAGzD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,UAAU,KAAQ,EAAE,OAAyB,EAAE;QACpD,OAAO,IAAI,CAAS,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,YAAY,CAAwB,IAAU;IAG5D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClC,OAAO,UAAU,KAAQ,EAAE,OAAyB,EAAE;QACpD,OAAO,IAAI,CAAS,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,WAAW,CAAwB,IAAU;IAC3D,OAAO;QACL,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC;QACxB,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC;QACtB,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC;QACpB,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC;KAC3B,CAAC;AACJ,CAAC","sourcesContent":["import {HookStageType, HookOptions, FlowName, HookMetadata} from '../metadata';\nimport {FrontMcpFlowHookTokens} from '../tokens';\n\n\nfunction registerFlowHook(target: any, meta: HookMetadata) {\n  const ctor = target.constructor;\n  const arr = Reflect.getMetadata(FrontMcpFlowHookTokens.hooks, ctor) ?? [];\n  arr.push(meta);\n  Reflect.defineMetadata(FrontMcpFlowHookTokens.hooks, arr, ctor);\n}\n\n/** Base factory (kept internal) */\nfunction make(flow: FlowName, type: HookStageType) {\n  return function <Ctx = unknown, T extends string = string>(stage: T, opts: HookOptions<Ctx> = {}): MethodDecorator {\n    return (target: any, key, _desc) => {\n      const {priority = 0, filter, ...rest} = opts;\n      registerFlowHook(target, {\n        ...rest,\n        [FrontMcpFlowHookTokens.type]: true,\n        flow: flow,\n        type: type,\n        stage: stage,\n        method: String(key),\n        priority: priority,\n        filter: filter,\n        target: target,\n        static: Boolean(target.constructor[key]),\n      });\n    };\n  };\n}\n\n/** NEW: typed variants */\nexport function StageHookOf<Name extends FlowName>(flow: Name) {\n  type T = ExtendFlows[Name]['stage']\n  type Ctx = ExtendFlows[Name]['ctx']\n  const base = make(flow, 'stage');\n  return function (stage: T, opts: HookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\nexport function WillHookOf<Name extends FlowName>(flow: Name) {\n  type T = ExtendFlows[Name]['stage']\n  type Ctx = ExtendFlows[Name]['ctx']\n  const base = make(flow, 'will');\n  return function (stage: T, opts: HookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\nexport function DidHookOf<Name extends FlowName>(flow: Name) {\n  type T = ExtendFlows[Name]['stage']\n  type Ctx = ExtendFlows[Name]['ctx']\n  const base = make(flow, 'did');\n  return function (stage: T, opts: HookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\nexport function AroundHookOf<Name extends FlowName>(name: Name) {\n  type T = ExtendFlows[Name]['stage']\n  type Ctx = ExtendFlows[Name]['ctx']\n  const base = make(name, 'around');\n  return function (stage: T, opts: HookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\nexport function FlowHooksOf<Name extends FlowName>(name: Name) {\n  return {\n    Stage: StageHookOf(name),\n    Will: WillHookOf(name),\n    Did: DidHookOf(name),\n    Around: AroundHookOf(name),\n  };\n}\n\n"]}
+{"version":3,"file":"hook.decorator.js","sourceRoot":"","sources":["../../../../src/common/decorators/hook.decorator.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAyBH,0EAEC;AAMD,0DAEC;AAMD,0DAEC;AA8ED,kCAOC;AAKD,gCAOC;AAKD,8BAOC;AAKD,oCAOC;AAiBD,kCAOC;AAzLD,sCAAmD;AACnD,uDAAyG;AAEzG;;;GAGG;AACH,MAAM,mBAAmB,GAAG,IAAI,yCAAuB,EAAgB,CAAC;AAExE;;GAEG;AACH,SAAS,mBAAmB,CAAC,IAAc,EAAE,IAAkB;IAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,+BAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1E,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,OAAO,CAAC,cAAc,CAAC,+BAAsB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,SAAgB,+BAA+B,CAAC,IAAc;IAC5D,OAAO,mBAAmB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,SAAgB,uBAAuB,CAAC,MAAgB,EAAE,IAAkB;IAC1E,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,SAAgB,uBAAuB,CAAC,MAAgB;IACtD,OAAO,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,SAAS,IAAI,CAAC,IAAc,EAAE,IAAmB;IAC/C,OAAO,UAAoD,KAAQ,EAAE,OAAyB,EAAE;QAC9F,OAAO,CAAC,MAAW,EAAE,YAAiB,EAAE,KAA0B,EAAO,EAAE;YACzE,MAAM,EAAE,QAAQ,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;YAE/C,iEAAiE;YACjE,IAAI,IAAA,qCAAmB,EAAC,YAAY,CAAC,EAAE,CAAC;gBACtC,+BAA+B;gBAC/B,MAAM,OAAO,GAAG,YAAiC,CAAC;gBAClD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;gBAChC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,gDAAgD;gBAEvE,MAAM,IAAI,GAAiB;oBACzB,GAAG,IAAI;oBACP,CAAC,+BAAsB,CAAC,IAAI,CAAC,EAAE,IAAI;oBACnC,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,IAAI;oBACV,KAAK,EAAE,KAAK;oBACZ,MAAM,EAAE,UAAU;oBAClB,QAAQ,EAAE,QAAQ;oBAClB,MAAM,EAAE,MAAM;oBACd,MAAM,EAAE,IAAI,EAAE,qCAAqC;oBACnD,MAAM,EAAE,QAAQ;iBACjB,CAAC;gBAEF,0EAA0E;gBAC1E,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBAExC,uCAAuC;gBACvC,OAAO,MAAM,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,oCAAoC;gBACpC,MAAM,GAAG,GAAG,YAAY,CAAC;gBACzB,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC/B,MAAM,QAAQ,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC;gBAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;gBAEpD,MAAM,IAAI,GAAiB;oBACzB,GAAG,IAAI;oBACP,CAAC,+BAAsB,CAAC,IAAI,CAAC,EAAE,IAAI;oBACnC,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,IAAI;oBACV,KAAK,EAAE,KAAK;oBACZ,MAAM,EAAE,UAAU;oBAClB,QAAQ,EAAE,QAAQ;oBAClB,MAAM,EAAE,MAAM;oBACd,MAAM,EAAE,MAAM;oBACd,MAAM,EAAE,QAAQ;iBACjB,CAAC;gBAEF,oCAAoC;gBACpC,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAEhC,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,WAAW,CAAwB,IAAU;IAG3D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,UAAU,KAAQ,EAAE,OAAyB,EAAE;QACpD,OAAO,IAAI,CAAS,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAwB,IAAU;IAG1D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,UAAU,KAAQ,EAAE,OAAyB,EAAE;QACpD,OAAO,IAAI,CAAS,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAwB,IAAU;IAGzD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,UAAU,KAAQ,EAAE,OAAyB,EAAE;QACpD,OAAO,IAAI,CAAS,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAwB,IAAU;IAG5D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClC,OAAO,UAAU,KAAQ,EAAE,OAAyB,EAAE;QACpD,OAAO,IAAI,CAAS,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,WAAW,CAAwB,IAAU;IAC3D,OAAO;QACL,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC;QACxB,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC;QACtB,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC;QACpB,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC;KAC3B,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Flow Hook Decorators\n *\n * This module provides decorators for defining flow stages and lifecycle hooks.\n * Supports both legacy TypeScript decorators and TC39 Stage 3 decorators.\n */\n\nimport { HookStageType, HookOptions, FlowName, HookMetadata } from '../metadata';\nimport { FrontMcpFlowHookTokens } from '../tokens';\nimport { isTC39MethodContext, PendingMetadataRegistry, type TC39MethodContext } from './decorator-utils';\n\n/**\n * Pending metadata registry for TC39 decorators\n * Stores hook metadata keyed by method function until class is processed\n */\nconst pendingHookRegistry = new PendingMetadataRegistry<HookMetadata>();\n\n/**\n * Register hook metadata on a class constructor\n */\nfunction registerHookOnClass(ctor: Function, meta: HookMetadata): void {\n  const arr = Reflect.getMetadata(FrontMcpFlowHookTokens.hooks, ctor) ?? [];\n  arr.push(meta);\n  Reflect.defineMetadata(FrontMcpFlowHookTokens.hooks, arr, ctor);\n}\n\n/**\n * Resolve all pending TC39 hooks for a class by scanning its prototype\n * This is called by collectFlowHookMap during flow registration\n */\nexport function resolvePendingTC39HooksForClass(ctor: Function): HookMetadata[] {\n  return pendingHookRegistry.resolveForClass(ctor);\n}\n\n/**\n * Store a pending hook for TC39 mode\n * @internal\n */\nexport function registerPendingTC39Hook(method: Function, meta: HookMetadata): void {\n  pendingHookRegistry.store(method, meta);\n}\n\n/**\n * Get and clear pending hooks for a method (TC39 mode)\n * @internal\n */\nexport function consumePendingTC39Hooks(method: Function): HookMetadata[] {\n  return pendingHookRegistry.consume(method);\n}\n\n/**\n * Base factory for creating hook decorators\n * Works with both legacy TypeScript and TC39 Stage 3 decorators\n */\nfunction make(flow: FlowName, type: HookStageType) {\n  return function <Ctx = unknown, T extends string = string>(stage: T, opts: HookOptions<Ctx> = {}): MethodDecorator {\n    return (target: any, keyOrContext: any, _desc?: PropertyDescriptor): any => {\n      const { priority = 0, filter, ...rest } = opts;\n\n      // Detect TC39 Stage 3 decorators vs legacy TypeScript decorators\n      if (isTC39MethodContext(keyOrContext)) {\n        // TC39 Stage 3 decorator style\n        const context = keyOrContext as TC39MethodContext;\n        const methodName = String(context.name);\n        const isStatic = context.static;\n        const method = target; // In TC39, target is the method function itself\n\n        const meta: HookMetadata = {\n          ...rest,\n          [FrontMcpFlowHookTokens.type]: true,\n          flow: flow,\n          type: type,\n          stage: stage,\n          method: methodName,\n          priority: priority,\n          filter: filter,\n          target: null, // Will be resolved at execution time\n          static: isStatic,\n        };\n\n        // Store as pending - resolved when collectFlowHookMap processes the class\n        pendingHookRegistry.store(method, meta);\n\n        // Return the original method unchanged\n        return target;\n      } else {\n        // Legacy TypeScript decorator style\n        const key = keyOrContext;\n        const methodName = String(key);\n        const isStatic = typeof target === 'function';\n        const ctor = isStatic ? target : target.constructor;\n\n        const meta: HookMetadata = {\n          ...rest,\n          [FrontMcpFlowHookTokens.type]: true,\n          flow: flow,\n          type: type,\n          stage: stage,\n          method: methodName,\n          priority: priority,\n          filter: filter,\n          target: target,\n          static: isStatic,\n        };\n\n        // Register immediately on the class\n        registerHookOnClass(ctor, meta);\n\n        return undefined;\n      }\n    };\n  };\n}\n\n/**\n * Creates a typed Stage hook decorator for a specific flow\n * @example\n * ```typescript\n * const { Stage } = FlowHooksOf('http:request');\n *\n * class HttpRequestFlow {\n *   @Stage('checkAuthorization')\n *   async checkAuthorization() { ... }\n * }\n * ```\n */\nexport function StageHookOf<Name extends FlowName>(flow: Name) {\n  type T = ExtendFlows[Name]['stage'];\n  type Ctx = ExtendFlows[Name]['ctx'];\n  const base = make(flow, 'stage');\n  return function (stage: T, opts: HookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\n/**\n * Creates a typed Will hook decorator (runs before stage)\n */\nexport function WillHookOf<Name extends FlowName>(flow: Name) {\n  type T = ExtendFlows[Name]['stage'];\n  type Ctx = ExtendFlows[Name]['ctx'];\n  const base = make(flow, 'will');\n  return function (stage: T, opts: HookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\n/**\n * Creates a typed Did hook decorator (runs after stage)\n */\nexport function DidHookOf<Name extends FlowName>(flow: Name) {\n  type T = ExtendFlows[Name]['stage'];\n  type Ctx = ExtendFlows[Name]['ctx'];\n  const base = make(flow, 'did');\n  return function (stage: T, opts: HookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\n/**\n * Creates a typed Around hook decorator (wraps stage execution)\n */\nexport function AroundHookOf<Name extends FlowName>(name: Name) {\n  type T = ExtendFlows[Name]['stage'];\n  type Ctx = ExtendFlows[Name]['ctx'];\n  const base = make(name, 'around');\n  return function (stage: T, opts: HookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\n/**\n * Creates all hook decorators for a specific flow\n * @example\n * ```typescript\n * const { Stage, Will, Did, Around } = FlowHooksOf('http:request');\n *\n * class HttpRequestFlow {\n *   @Stage('checkAuthorization')\n *   async checkAuthorization() { ... }\n *\n *   @Will('execute', { priority: 10 })\n *   async beforeExecute() { ... }\n * }\n * ```\n */\nexport function FlowHooksOf<Name extends FlowName>(name: Name) {\n  return {\n    Stage: StageHookOf(name),\n    Will: WillHookOf(name),\n    Did: DidHookOf(name),\n    Around: AroundHookOf(name),\n  };\n}\n"]}

package/src/common/decorators/plugin.decorator.d.ts

@@ -4,4 +4,4 @@ import { PluginMetadata } from '../metadata';
  * Decorator that marks a class as a McpPlugin and provides metadata
  */
 declare function FrontMcpPlugin(providedMetadata: PluginMetadata): ClassDecorator;
-export { FrontMcpPlugin, FrontMcpPlugin as Plugin, };
+export { FrontMcpPlugin, FrontMcpPlugin as Plugin };

package/src/common/decorators/plugin.decorator.js

@@ -12,20 +12,21 @@ function FrontMcpPlugin(providedMetadata) {
     return (target) => {
         const { error, data: metadata } = metadata_1.frontMcpPluginMetadataSchema.safeParse(providedMetadata);
         if (error) {
-            if (error.format().providers) {
-                throw new Error(`Invalid metadata provided to @FrontMcpProvider or @Provider: \n${JSON.stringify(error.formErrors.fieldErrors['providers'], null, 2)}`);
+            const formatted = error.format();
+            if (formatted.providers) {
+                throw new Error(`Invalid metadata provided to @FrontMcpProvider or @Provider: \n${JSON.stringify(formatted.providers, null, 2)}`);
             }
-            if (error.format().adapters) {
-                throw new Error(`Invalid metadata provided to @FrontMcpAdapter or @Adapter: \n${JSON.stringify(error.format().adapters, null, 2)}`);
+            if (formatted.adapters) {
+                throw new Error(`Invalid metadata provided to @FrontMcpAdapter or @Adapter: \n${JSON.stringify(formatted.adapters, null, 2)}`);
             }
-            if (error.format().tools) {
-                throw new Error(`Invalid metadata provided to @FrontMcpTool or @Tool: \n${JSON.stringify(error.format().tools, null, 2)}`);
+            if (formatted.tools) {
+                throw new Error(`Invalid metadata provided to @FrontMcpTool or @Tool: \n${JSON.stringify(formatted.tools, null, 2)}`);
             }
-            if (error.format().resources) {
-                throw new Error(`Invalid metadata provided to @FrontMcpResource or @Resource: \n${JSON.stringify(error.format().resources, null, 2)}`);
+            if (formatted.resources) {
+                throw new Error(`Invalid metadata provided to @FrontMcpResource or @Resource: \n${JSON.stringify(formatted.resources, null, 2)}`);
             }
-            if (error.format().prompts) {
-                throw new Error(`Invalid metadata provided to @FrontMcpPrompt or @Prompt: \n${JSON.stringify(error.format().prompts, null, 2)}`);
+            if (formatted.prompts) {
+                throw new Error(`Invalid metadata provided to @FrontMcpPrompt or @Prompt: \n${JSON.stringify(formatted.prompts, null, 2)}`);
             }
             throw error;
         }

package/src/common/decorators/plugin.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.decorator.js","sourceRoot":"","sources":["../../../../src/common/decorators/plugin.decorator.ts"],"names":[],"mappings":";;AAsCE,wCAAc;AACI,gCAAM;AAvC1B,4BAA0B;AAC1B,sCAAiD;AACjD,0CAA2E;AAE3E;;GAEG;AACH,SAAS,cAAc,CAAC,gBAAgC;IACtD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAE1B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,uCAA4B,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC3F,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,kEAAkE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1J,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,gEAAgE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACtI,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,0DAA0D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7H,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,kEAAkE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACzI,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,8DAA8D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACnI,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,CAAC,cAAc,CAAC,6BAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAChE,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","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpPluginTokens } from '../tokens';\nimport { PluginMetadata, frontMcpPluginMetadataSchema } from '../metadata';\n\n/**\n * Decorator that marks a class as a McpPlugin and provides metadata\n */\nfunction FrontMcpPlugin(providedMetadata: PluginMetadata): ClassDecorator {\n  return (target: Function) => {\n\n    const { error, data: metadata } = frontMcpPluginMetadataSchema.safeParse(providedMetadata);\n    if (error) {\n      if (error.format().providers) {\n        throw new Error(`Invalid metadata provided to @FrontMcpProvider or @Provider: \\n${JSON.stringify(error.formErrors.fieldErrors['providers'], null, 2)}`);\n      }\n      if (error.format().adapters) {\n        throw new Error(`Invalid metadata provided to @FrontMcpAdapter or @Adapter: \\n${JSON.stringify(error.format().adapters, null, 2)}`);\n      }\n      if (error.format().tools) {\n        throw new Error(`Invalid metadata provided to @FrontMcpTool or @Tool: \\n${JSON.stringify(error.format().tools, null, 2)}`);\n      }\n      if (error.format().resources) {\n        throw new Error(`Invalid metadata provided to @FrontMcpResource or @Resource: \\n${JSON.stringify(error.format().resources, null, 2)}`);\n      }\n      if (error.format().prompts) {\n        throw new Error(`Invalid metadata provided to @FrontMcpPrompt or @Prompt: \\n${JSON.stringify(error.format().prompts, null, 2)}`);\n      }\n      throw error;\n    }\n\n    Reflect.defineMetadata(FrontMcpPluginTokens.type, true, target);\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpPluginTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\nexport {\n  FrontMcpPlugin,\n  FrontMcpPlugin as Plugin,\n};"]}
+{"version":3,"file":"plugin.decorator.js","sourceRoot":"","sources":["../../../../src/common/decorators/plugin.decorator.ts"],"names":[],"mappings":";;AAuDS,wCAAc;AAAoB,gCAAM;AAvDjD,4BAA0B;AAC1B,sCAAiD;AACjD,0CAA2E;AAE3E;;GAEG;AACH,SAAS,cAAc,CAAC,gBAAgC;IACtD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,uCAA4B,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC3F,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CACb,kEAAkE,IAAI,CAAC,SAAS,CAC9E,SAAS,CAAC,SAAS,EACnB,IAAI,EACJ,CAAC,CACF,EAAE,CACJ,CAAC;YACJ,CAAC;YACD,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,gEAAgE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAC9G,CAAC;YACJ,CAAC;YACD,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CACb,0DAA0D,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CACrG,CAAC;YACJ,CAAC;YACD,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CACb,kEAAkE,IAAI,CAAC,SAAS,CAC9E,SAAS,CAAC,SAAS,EACnB,IAAI,EACJ,CAAC,CACF,EAAE,CACJ,CAAC;YACJ,CAAC;YACD,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CACb,8DAA8D,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAC3G,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,CAAC,cAAc,CAAC,6BAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAChE,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","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpPluginTokens } from '../tokens';\nimport { PluginMetadata, frontMcpPluginMetadataSchema } from '../metadata';\n\n/**\n * Decorator that marks a class as a McpPlugin and provides metadata\n */\nfunction FrontMcpPlugin(providedMetadata: PluginMetadata): ClassDecorator {\n  return (target: Function) => {\n    const { error, data: metadata } = frontMcpPluginMetadataSchema.safeParse(providedMetadata);\n    if (error) {\n      const formatted = error.format();\n      if (formatted.providers) {\n        throw new Error(\n          `Invalid metadata provided to @FrontMcpProvider or @Provider: \\n${JSON.stringify(\n            formatted.providers,\n            null,\n            2,\n          )}`,\n        );\n      }\n      if (formatted.adapters) {\n        throw new Error(\n          `Invalid metadata provided to @FrontMcpAdapter or @Adapter: \\n${JSON.stringify(formatted.adapters, null, 2)}`,\n        );\n      }\n      if (formatted.tools) {\n        throw new Error(\n          `Invalid metadata provided to @FrontMcpTool or @Tool: \\n${JSON.stringify(formatted.tools, null, 2)}`,\n        );\n      }\n      if (formatted.resources) {\n        throw new Error(\n          `Invalid metadata provided to @FrontMcpResource or @Resource: \\n${JSON.stringify(\n            formatted.resources,\n            null,\n            2,\n          )}`,\n        );\n      }\n      if (formatted.prompts) {\n        throw new Error(\n          `Invalid metadata provided to @FrontMcpPrompt or @Prompt: \\n${JSON.stringify(formatted.prompts, null, 2)}`,\n        );\n      }\n      throw error;\n    }\n\n    Reflect.defineMetadata(FrontMcpPluginTokens.type, true, target);\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpPluginTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\nexport { FrontMcpPlugin, FrontMcpPlugin as Plugin };\n"]}

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

@@ -10,8 +10,37 @@ declare function FrontMcpResource(providedMetadata: ResourceMetadata): ClassDeco
  */
 declare function FrontMcpResourceTemplate(providedMetadata: ResourceTemplateMetadata): ClassDecorator;
 export type FrontMcpResourceExecuteHandler = (uri: ReadResourceRequest['params']['uri'], ...tokens: any[]) => ReadResourceResult | Promise<ReadResourceResult>;
+export type FrontMcpResourceTemplateExecuteHandler = (uri: ReadResourceRequest['params']['uri'], params: Record<string, string>, ...tokens: any[]) => ReadResourceResult | Promise<ReadResourceResult>;
 /**
- * Decorator that marks a class as a McpResource module and provides metadata
+ * Function builder that creates a function-style static resource.
+ * Use for simple resources that don't need class-based context.
+ *
+ * @example
+ * ```ts
+ * const AppConfig = resource({
+ *   name: 'app-config',
+ *   uri: 'config://app',
+ *   mimeType: 'application/json',
+ * })((uri) => ({
+ *   contents: [{ uri, text: JSON.stringify({ version: '1.0.0' }) }]
+ * }));
+ * ```
+ */
+declare function frontMcpResource<T extends ResourceMetadata>(providedMetadata: T): (handler: FrontMcpResourceExecuteHandler) => () => FrontMcpResourceExecuteHandler;
+/**
+ * Function builder that creates a function-style resource template.
+ * Use for simple templated resources that don't need class-based context.
+ *
+ * @example
+ * ```ts
+ * const UserProfile = resourceTemplate({
+ *   name: 'user-profile',
+ *   uriTemplate: 'users://{userId}/profile',
+ *   mimeType: 'application/json',
+ * })((uri, params) => ({
+ *   contents: [{ uri, text: JSON.stringify({ id: params.userId }) }]
+ * }));
+ * ```
  */
-declare function frontMcpResource<T extends ResourceMetadata>(providedMetadata: T): (handler: FrontMcpResourceExecuteHandler) => (() => void);
-export { FrontMcpResource, FrontMcpResource as Resource, FrontMcpResourceTemplate, FrontMcpResourceTemplate as ResourceTemplate, frontMcpResource, frontMcpResource as resource, };
+declare function frontMcpResourceTemplate<T extends ResourceTemplateMetadata>(providedMetadata: T): (handler: FrontMcpResourceTemplateExecuteHandler) => () => FrontMcpResourceTemplateExecuteHandler;
+export { FrontMcpResource, FrontMcpResource as Resource, FrontMcpResourceTemplate, FrontMcpResourceTemplate as ResourceTemplate, frontMcpResource, frontMcpResource as resource, frontMcpResourceTemplate, frontMcpResourceTemplate as resourceTemplate, };

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

@@ -6,6 +6,8 @@ exports.FrontMcpResourceTemplate = FrontMcpResourceTemplate;
 exports.ResourceTemplate = FrontMcpResourceTemplate;
 exports.frontMcpResource = frontMcpResource;
 exports.resource = frontMcpResource;
+exports.frontMcpResourceTemplate = frontMcpResourceTemplate;
+exports.resourceTemplate = frontMcpResourceTemplate;
 require("reflect-metadata");
 const tokens_1 = require("../tokens");
 const metadata_1 = require("../metadata");
@@ -34,19 +36,59 @@ function FrontMcpResourceTemplate(providedMetadata) {
     };
 }
 /**
- * Decorator that marks a class as a McpResource module and provides metadata
+ * Function builder that creates a function-style static resource.
+ * Use for simple resources that don't need class-based context.
+ *
+ * @example
+ * ```ts
+ * const AppConfig = resource({
+ *   name: 'app-config',
+ *   uri: 'config://app',
+ *   mimeType: 'application/json',
+ * })((uri) => ({
+ *   contents: [{ uri, text: JSON.stringify({ version: '1.0.0' }) }]
+ * }));
+ * ```
  */
 function frontMcpResource(providedMetadata) {
     return (execute) => {
         const metadata = metadata_1.frontMcpResourceMetadataSchema.parse(providedMetadata);
-        const toolFunction = function () {
+        const resourceFunction = function () {
             return execute;
         };
-        Object.assign(toolFunction, {
+        Object.assign(resourceFunction, {
             [tokens_1.FrontMcpResourceTokens.type]: 'function-resource',
             [tokens_1.FrontMcpResourceTokens.metadata]: metadata,
         });
-        return toolFunction;
+        return resourceFunction;
+    };
+}
+/**
+ * Function builder that creates a function-style resource template.
+ * Use for simple templated resources that don't need class-based context.
+ *
+ * @example
+ * ```ts
+ * const UserProfile = resourceTemplate({
+ *   name: 'user-profile',
+ *   uriTemplate: 'users://{userId}/profile',
+ *   mimeType: 'application/json',
+ * })((uri, params) => ({
+ *   contents: [{ uri, text: JSON.stringify({ id: params.userId }) }]
+ * }));
+ * ```
+ */
+function frontMcpResourceTemplate(providedMetadata) {
+    return (execute) => {
+        const metadata = metadata_1.frontMcpResourceTemplateMetadataSchema.parse(providedMetadata);
+        const resourceFunction = function () {
+            return execute;
+        };
+        Object.assign(resourceFunction, {
+            [tokens_1.FrontMcpResourceTemplateTokens.type]: 'function-resource-template',
+            [tokens_1.FrontMcpResourceTemplateTokens.metadata]: metadata,
+        });
+        return resourceFunction;
     };
 }
 //# sourceMappingURL=resource.decorator.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"resource.decorator.js","sourceRoot":"","sources":["../../../../src/common/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};"]}
+{"version":3,"file":"resource.decorator.js","sourceRoot":"","sources":["../../../../src/common/decorators/resource.decorator.ts"],"names":[],"mappings":";;AAmHE,4CAAgB;AACI,oCAAQ;AAC5B,4DAAwB;AACI,oDAAgB;AAC5C,4CAAgB;AACI,oCAAQ;AAC5B,4DAAwB;AACI,oDAAgB;AA1H9C,4BAA0B;AAC1B,sCAAmF;AACnF,0CAKqB;AAIrB;;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;AAED;;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;AAaD;;;;;;;;;;;;;;GAcG;AACH,SAAS,gBAAgB,CACvB,gBAAmB;IAEnB,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,yCAA8B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACxE,MAAM,gBAAgB,GAAG;YACvB,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE;YAC9B,CAAC,+BAAsB,CAAC,IAAI,CAAC,EAAE,mBAAmB;YAClD,CAAC,+BAAsB,CAAC,QAAQ,CAAC,EAAE,QAAQ;SAC5C,CAAC,CAAC;QACH,OAAO,gBAAgB,CAAC;IAC1B,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAS,wBAAwB,CAC/B,gBAAmB;IAEnB,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,iDAAsC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAChF,MAAM,gBAAgB,GAAG;YACvB,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE;YAC9B,CAAC,uCAA8B,CAAC,IAAI,CAAC,EAAE,4BAA4B;YACnE,CAAC,uCAA8B,CAAC,QAAQ,CAAC,EAAE,QAAQ;SACpD,CAAC,CAAC;QACH,OAAO,gBAAgB,CAAC;IAC1B,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpResourceTokens, FrontMcpResourceTemplateTokens } from '../tokens';\nimport {\n  frontMcpResourceMetadataSchema,\n  frontMcpResourceTemplateMetadataSchema,\n  ResourceMetadata,\n  ResourceTemplateMetadata,\n} from '../metadata';\n\nimport { ReadResourceRequest, ReadResourceResult } 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 * 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\nexport type FrontMcpResourceExecuteHandler = (\n  uri: ReadResourceRequest['params']['uri'],\n  ...tokens: any[]\n) => ReadResourceResult | Promise<ReadResourceResult>;\n\nexport type FrontMcpResourceTemplateExecuteHandler = (\n  uri: ReadResourceRequest['params']['uri'],\n  params: Record<string, string>,\n  ...tokens: any[]\n) => ReadResourceResult | Promise<ReadResourceResult>;\n\n/**\n * Function builder that creates a function-style static resource.\n * Use for simple resources that don't need class-based context.\n *\n * @example\n * ```ts\n * const AppConfig = resource({\n *   name: 'app-config',\n *   uri: 'config://app',\n *   mimeType: 'application/json',\n * })((uri) => ({\n *   contents: [{ uri, text: JSON.stringify({ version: '1.0.0' }) }]\n * }));\n * ```\n */\nfunction frontMcpResource<T extends ResourceMetadata>(\n  providedMetadata: T,\n): (handler: FrontMcpResourceExecuteHandler) => () => FrontMcpResourceExecuteHandler {\n  return (execute) => {\n    const metadata = frontMcpResourceMetadataSchema.parse(providedMetadata);\n    const resourceFunction = function () {\n      return execute;\n    };\n    Object.assign(resourceFunction, {\n      [FrontMcpResourceTokens.type]: 'function-resource',\n      [FrontMcpResourceTokens.metadata]: metadata,\n    });\n    return resourceFunction;\n  };\n}\n\n/**\n * Function builder that creates a function-style resource template.\n * Use for simple templated resources that don't need class-based context.\n *\n * @example\n * ```ts\n * const UserProfile = resourceTemplate({\n *   name: 'user-profile',\n *   uriTemplate: 'users://{userId}/profile',\n *   mimeType: 'application/json',\n * })((uri, params) => ({\n *   contents: [{ uri, text: JSON.stringify({ id: params.userId }) }]\n * }));\n * ```\n */\nfunction frontMcpResourceTemplate<T extends ResourceTemplateMetadata>(\n  providedMetadata: T,\n): (handler: FrontMcpResourceTemplateExecuteHandler) => () => FrontMcpResourceTemplateExecuteHandler {\n  return (execute) => {\n    const metadata = frontMcpResourceTemplateMetadataSchema.parse(providedMetadata);\n    const resourceFunction = function () {\n      return execute;\n    };\n    Object.assign(resourceFunction, {\n      [FrontMcpResourceTemplateTokens.type]: 'function-resource-template',\n      [FrontMcpResourceTemplateTokens.metadata]: metadata,\n    });\n    return resourceFunction;\n  };\n}\n\nexport {\n  FrontMcpResource,\n  FrontMcpResource as Resource,\n  FrontMcpResourceTemplate,\n  FrontMcpResourceTemplate as ResourceTemplate,\n  frontMcpResource,\n  frontMcpResource as resource,\n  frontMcpResourceTemplate,\n  frontMcpResourceTemplate as resourceTemplate,\n};\n"]}

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

@@ -1,5 +1,6 @@
 import 'reflect-metadata';
 import { ToolMetadata, ImageOutputSchema, AudioOutputSchema, ResourceOutputSchema, ResourceLinkOutputSchema, ToolInputType, ToolOutputType } from '../metadata';
+import type { ToolUIConfig } from '../metadata/tool-ui.metadata';
 import z from 'zod';
 import { ToolContext } from '../interfaces';
 export type FrontMcpToolExecuteHandler<InSchema extends ToolInputType, OutSchema extends ToolOutputType, In = ToolInputOf<{
@@ -21,7 +22,7 @@ export { FrontMcpTool, FrontMcpTool as Tool, frontMcpTool, frontMcpTool as tool
  * Don't move below code outside the decorator file, it will break the module augmentation.
  */
 type __Shape = z.ZodRawShape;
-type __AsZodObj<T> = T extends z.ZodObject<infer S> ? z.ZodObject<S> : T extends z.ZodRawShape ? z.ZodObject<T> : never;
+type __AsZodObj<T> = T extends z.ZodObject<any> ? T : T extends z.ZodRawShape ? z.ZodObject<T> : never;
 export type ToolInputOf<Opt> = Opt extends {
     inputSchema: infer I;
 } ? z.infer<__AsZodObj<I>> : never;
@@ -29,12 +30,12 @@ export type ToolInputOf<Opt> = Opt extends {
  * Helper to infer the return type from any Zod schema,
  * including ZodRawShape.
  */
-type __InferZod<S> = S extends z.ZodTypeAny ? z.infer<S> : S extends z.ZodRawShape ? z.infer<z.ZodObject<S>> : never;
+type __InferZod<S> = S extends z.ZodType ? z.infer<S> : S extends z.ZodRawShape ? z.infer<z.ZodObject<S>> : never;
 /**
  * Infers the *output type* from a *single schema definition*
  * based on the new ToolSingleOutputType.
  */
-type __InferFromSingleSchema<S> = S extends 'image' ? z.infer<typeof ImageOutputSchema> : S extends 'audio' ? z.infer<typeof AudioOutputSchema> : S extends 'resource' ? z.infer<typeof ResourceOutputSchema> : S extends 'resource_link' ? z.infer<typeof ResourceLinkOutputSchema> : S extends 'string' ? string : S extends 'number' ? number : S extends 'boolean' ? boolean : S extends 'date' ? Date : S extends z.ZodTypeAny | z.ZodRawShape ? __InferZod<S> : any;
+type __InferFromSingleSchema<S> = S extends 'image' ? z.infer<typeof ImageOutputSchema> : S extends 'audio' ? z.infer<typeof AudioOutputSchema> : S extends 'resource' ? z.infer<typeof ResourceOutputSchema> : S extends 'resource_link' ? z.infer<typeof ResourceLinkOutputSchema> : S extends 'string' ? string : S extends 'number' ? number : S extends 'boolean' ? boolean : S extends 'date' ? Date : S extends z.ZodType | z.ZodRawShape ? __InferZod<S> : any;
 /**
  * Infers a tuple/array of output types from an array of schemas
  */
@@ -53,11 +54,59 @@ type __ImageOutputType = 'image';
 type __AudioOutputType = 'audio';
 type __ResourceOutputType = 'resource';
 type __ResourceLinkOutputType = 'resource_link';
-type __StructuredOutputType = z.ZodRawShape | z.ZodObject<any> | z.ZodArray<any> | z.ZodUnion<[z.ZodObject<any>, ...z.ZodObject<any>[]]> | z.ZodDiscriminatedUnion<any, any>;
+type __StructuredOutputType = z.ZodRawShape | z.ZodObject<any> | z.ZodArray<z.ZodType> | z.ZodUnion<[z.ZodObject<any>, ...z.ZodObject<any>[]]> | z.ZodDiscriminatedUnion<z.ZodObject<any>[]>;
 type __ToolSingleOutputType = __PrimitiveOutputType | __ImageOutputType | __AudioOutputType | __ResourceOutputType | __ResourceLinkOutputType | __StructuredOutputType;
 type __OutputSchema = __ToolSingleOutputType | __ToolSingleOutputType[];
-export type ToolMetadataOptions<I extends __Shape, O extends __OutputSchema> = ToolMetadata<I | z.ZodObject<I>, // inputSchema can be a raw shape or ZodObject
+/**
+ * Base tool metadata options without UI field.
+ */
+type __ToolMetadataBase<I extends __Shape, O extends __OutputSchema> = ToolMetadata<I | z.ZodObject<I>, // inputSchema can be a raw shape or ZodObject
 O>;
+/**
+ * Tool metadata options with optional UI configuration.
+ *
+ * The `ui` property accepts a `ToolUIConfig` from `@frontmcp/ui/types`
+ * for configuring interactive widget rendering.
+ */
+export type ToolMetadataOptions<I extends __Shape, O extends __OutputSchema> = __ToolMetadataBase<I, O> & {
+    /**
+     * UI template configuration for rendering interactive widgets.
+     *
+     * The template builder function receives typed `ctx.input` and `ctx.output`
+     * based on the tool's `inputSchema` and `outputSchema`.
+     *
+     * @see {@link ToolUIConfig} for all available options including:
+     * - `template`: React component, HTML string, or builder function
+     * - `servingMode`: 'inline' | 'static' | 'hybrid' | 'direct-url' | 'custom-url'
+     * - `csp`: Content Security Policy configuration
+     * - `widgetAccessible`: Enable MCP bridge for tool calls from widget
+     * - `displayMode`: 'inline' | 'fullscreen' | 'pip'
+     * - And more...
+     *
+     * @example HTML template builder with typed context
+     * ```typescript
+     * ui: {
+     *   template: (ctx) => `<div>${ctx.helpers.escapeHtml(ctx.output.name)}</div>`,
+     *   // ctx.output is typed based on outputSchema
+     *   servingMode: 'inline',
+     * }
+     * ```
+     *
+     * @example React component
+     * ```typescript
+     * import WeatherCard from './weather-ui';
+     * ui: {
+     *   template: WeatherCard,
+     *   servingMode: 'static',
+     * }
+     * ```
+     */
+    ui?: ToolUIConfig<ToolInputOf<{
+        inputSchema: I | z.ZodObject<I>;
+    }>, ToolOutputOf<{
+        outputSchema: O;
+    }>>;
+};
 type __Ctor = (new (...a: any[]) => any) | (abstract new (...a: any[]) => any);
 type __A<C extends __Ctor> = C extends new (...a: infer A) => any ? A : C extends abstract new (...a: infer A) => any ? A : never;
 type __R<C extends __Ctor> = C extends new (...a: any[]) => infer R ? R : C extends abstract new (...a: any[]) => infer R ? R : never;

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

@@ -1 +1 @@
-{"version":3,"file":"tool.decorator.js","sourceRoot":"","sources":["../../../../src/common/decorators/tool.decorator.ts"],"names":[],"mappings":";;AA8DS,oCAAY;AAAkB,4BAAI;AAAE,oCAAY;AAAkB,4BAAI;AA9D/E,4BAA0B;AAC1B,sCAAqE;AACrE,0CASqB;AAIrB;;GAEG;AACH,SAAS,YAAY,CAAC,gBAA8B;IAClD,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,MAAM,QAAQ,GAAG,qCAA0B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACpE,OAAO,CAAC,cAAc,CAAC,2BAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,EAAE,CAAC;QACpB,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,IAAI,2BAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,cAAc,CAAC,2BAAkB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;YACnF,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QACD,OAAO,CAAC,cAAc,CAAC,6BAAoB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC,CAAC;AACJ,CAAC;AASD;;GAEG;AACH,SAAS,YAAY,CAInB,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 { extendedToolMetadata, FrontMcpToolTokens } from '../tokens';\nimport {\n  ToolMetadata,\n  frontMcpToolMetadataSchema,\n  ImageOutputSchema,\n  AudioOutputSchema,\n  ResourceOutputSchema,\n  ResourceLinkOutputSchema,\n  ToolInputType,\n  ToolOutputType,\n} 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  return (target: any) => {\n    const metadata = frontMcpToolMetadataSchema.parse(providedMetadata);\n    Reflect.defineMetadata(FrontMcpToolTokens.type, true, target);\n    const extended = {};\n    for (const property in metadata) {\n      if (FrontMcpToolTokens[property]) {\n        Reflect.defineMetadata(FrontMcpToolTokens[property], metadata[property], target);\n      } else {\n        extended[property] = metadata[property];\n      }\n    }\n    Reflect.defineMetadata(extendedToolMetadata, extended, target);\n  };\n}\n\nexport type FrontMcpToolExecuteHandler<\n  InSchema extends ToolInputType,\n  OutSchema extends ToolOutputType,\n  In = ToolInputOf<{ inputSchema: InSchema }>,\n  Out = ToolOutputOf<{ outputSchema: OutSchema }>,\n> = (input: In, ctx: ToolContext<InSchema, OutSchema>) => Out | Promise<Out>;\n\n/**\n * Decorator that marks a class as a McpTool module and provides metadata\n */\nfunction frontMcpTool<\n  T extends ToolMetadata,\n  InSchema extends ToolInputType = T['inputSchema'],\n  OutSchema extends ToolOutputType = T['outputSchema'],\n>(providedMetadata: T): (handler: FrontMcpToolExecuteHandler<InSchema, OutSchema>) => () => 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 { FrontMcpTool, FrontMcpTool as Tool, frontMcpTool, frontMcpTool as tool };\n\n/**\n * This is a modified version of the original decorator, with the following changes:\n * - Added support for ZodRawShape as inputSchema\n * - Added support for outputSchema: any of the allowed forms\n * - Added rich error messages for input/output type mismatches\n *\n * Don't move below code outside the decorator file, it will break the module augmentation.\n */\n// ---------- zod helpers ----------\ntype __Shape = z.ZodRawShape;\ntype __AsZodObj<T> = T extends z.ZodObject<infer S> ? z.ZodObject<S> : T extends z.ZodRawShape ? z.ZodObject<T> : never;\n\nexport type ToolInputOf<Opt> = Opt extends { inputSchema: infer I } ? z.infer<__AsZodObj<I>> : never;\n\n// ---------- output inference helpers for NEW schemas ----------\n\n/**\n * Helper to infer the return type from any Zod schema,\n * including ZodRawShape.\n */\ntype __InferZod<S> = S extends z.ZodTypeAny ? z.infer<S> : S extends z.ZodRawShape ? z.infer<z.ZodObject<S>> : never;\n\n/**\n * Infers the *output type* from a *single schema definition*\n * based on the new ToolSingleOutputType.\n */\ntype __InferFromSingleSchema<S> =\n  // Handle specific MCP type literals\n  S extends 'image'\n    ? z.infer<typeof ImageOutputSchema>\n    : S extends 'audio'\n    ? z.infer<typeof AudioOutputSchema>\n    : S extends 'resource'\n    ? z.infer<typeof ResourceOutputSchema>\n    : S extends 'resource_link'\n    ? z.infer<typeof ResourceLinkOutputSchema>\n    : // Handle primitive type literals\n    S extends 'string'\n    ? string\n    : S extends 'number'\n    ? number\n    : S extends 'boolean'\n    ? boolean\n    : S extends 'date'\n    ? Date\n    : // Handle all Zod schemas (primitives, objects, arrays, etc.)\n    // This will correctly infer z.ZodString to string, etc.\n    S extends z.ZodTypeAny | z.ZodRawShape\n    ? __InferZod<S>\n    : // Fallback for unknown/unrecognized schema\n      any;\n\n/**\n * Infers a tuple/array of output types from an array of schemas\n */\ntype __InferFromArraySchema<A> = A extends readonly any[] ? { [K in keyof A]: __InferFromSingleSchema<A[K]> } : never;\n\n/**\n * Main output type inference.\n * Handles single schemas, arrays of schemas, or no schema.\n */\nexport type ToolOutputOf<Opt> = Opt extends { outputSchema: infer O }\n  ? O extends readonly any[] // Check for array/tuple first\n    ? __InferFromArraySchema<O>\n    : __InferFromSingleSchema<O> // Handle a single schema\n  : any; // no outputSchema property at all -> allow anything\n\n// --- Define the schema types locally to constrain the generic ---\n// This mirrors your `ToolOutputType` definitions for use in constraints.\n\ntype __PrimitiveOutputType =\n  | 'string'\n  | 'number'\n  | 'date'\n  | 'boolean'\n  | z.ZodString\n  | z.ZodNumber\n  | z.ZodBoolean\n  | z.ZodBigInt\n  | z.ZodDate;\ntype __ImageOutputType = 'image';\ntype __AudioOutputType = 'audio';\ntype __ResourceOutputType = 'resource';\ntype __ResourceLinkOutputType = 'resource_link';\ntype __StructuredOutputType =\n  | z.ZodRawShape\n  | z.ZodObject<any>\n  | z.ZodArray<any>\n  | z.ZodUnion<[z.ZodObject<any>, ...z.ZodObject<any>[]]>\n  | z.ZodDiscriminatedUnion<any, any>;\n\ntype __ToolSingleOutputType =\n  | __PrimitiveOutputType\n  | __ImageOutputType\n  | __AudioOutputType\n  | __ResourceOutputType\n  | __ResourceLinkOutputType\n  | __StructuredOutputType;\n\n// This is the final constraint for the `outputSchema` option\ntype __OutputSchema = __ToolSingleOutputType | __ToolSingleOutputType[];\n\nexport type ToolMetadataOptions<I extends __Shape, O extends __OutputSchema> = ToolMetadata<\n  I | z.ZodObject<I>, // inputSchema can be a raw shape or ZodObject\n  O // outputSchema: any of the allowed forms\n>;\n\n// ---------- ctor & reflection ----------\ntype __Ctor = (new (...a: any[]) => any) | (abstract new (...a: any[]) => any);\ntype __A<C extends __Ctor> = C extends new (...a: infer A) => any\n  ? A\n  : C extends abstract new (...a: infer A) => any\n  ? A\n  : never;\ntype __R<C extends __Ctor> = C extends new (...a: any[]) => infer R\n  ? R\n  : C extends abstract new (...a: any[]) => infer R\n  ? R\n  : never;\ntype __Param<C extends __Ctor> = __R<C> extends { execute: (arg: infer P, ...r: any) => any } ? P : never;\ntype __Return<C extends __Ctor> = __R<C> extends { execute: (...a: any) => infer R } ? R : never;\ntype __Unwrap<T> = T extends Promise<infer U> ? U : T;\ntype __IsAny<T> = 0 extends 1 & T ? true : false;\n\n// ---------- friendly branded errors (UPDATED) ----------\n\n// Must extend ToolContext (assuming ToolContext is exported by the SDK)\ntype __MustExtendCtx<C extends __Ctor> = __R<C> extends ToolContext\n  ? unknown\n  : { 'Tool class error': 'Class must extend ToolContext' };\n\n// execute param must exactly match In (and not be any)\ntype __MustParam<C extends __Ctor, In> =\n  // 1. If 'In' (from schema) is 'any', we can't check, so allow.\n  __IsAny<In> extends true\n    ? unknown\n    : // 2. Check if the actual param type is 'any'. This is an error.\n    __IsAny<__Param<C>> extends true\n    ? { 'execute() parameter error': \"Parameter type must not be 'any'.\"; expected_input_type: In }\n    : // 3. Check for the exact match: Param extends In AND In extends Param\n    __Param<C> extends In\n    ? In extends __Param<C>\n      ? unknown // OK, exact match\n      : {\n          'execute() parameter error': 'Parameter type is too wide. It must exactly match the input schema.';\n          expected_input_type: In;\n          actual_parameter_type: __Param<C>;\n        }\n    : {\n        'execute() parameter error': 'Parameter type does not match the input schema.';\n        expected_input_type: In;\n        actual_parameter_type: __Param<C>;\n      };\n\n// execute return must be Out or Promise<Out>\ntype __MustReturn<C extends __Ctor, Out> =\n  // 1. If 'Out' (from schema) is 'any', no check is needed.\n  __IsAny<Out> extends true\n    ? unknown\n    : // 2. Check if the unwrapped return type is assignable to Out.\n    __Unwrap<__Return<C>> extends Out\n    ? unknown // OK\n    : {\n        'execute() return type error': \"The method's return type is not assignable to the expected output schema type.\";\n        expected_output_type: Out;\n        'actual_return_type (unwrapped)': __Unwrap<__Return<C>>;\n      };\n\n// Rewrapped constructor with updated ToolContext generic params\ntype __Rewrap<C extends __Ctor, In, Out> = C extends abstract new (...a: __A<C>) => __R<C>\n  ? C & (abstract new (...a: __A<C>) => ToolContext<any, any, In, Out> & __R<C>)\n  : C extends new (...a: __A<C>) => __R<C>\n  ? C & (new (...a: __A<C>) => ToolContext<any, any, In, Out> & __R<C>)\n  : never;\n\ndeclare module '@frontmcp/sdk' {\n  // ---------- the decorator (overloads) ----------\n\n  // 1) Overload: outputSchema PROVIDED → strict return typing\n  // @ts-expect-error - Module augmentation requires decorator overload\n  export function Tool<\n    I extends __Shape,\n    O extends __OutputSchema, // Use our new output schema constraint\n    T extends ToolMetadataOptions<I, O> & { outputSchema: any }, // ensure present\n  >(\n    opts: T,\n  ): <C extends __Ctor>(\n    cls: C &\n      __MustExtendCtx<C> &\n      __MustParam<C, ToolInputOf<T>> & // <-- Will now show a rich error\n      __MustReturn<C, ToolOutputOf<T>>, // <-- Will now show a rich error\n  ) => __Rewrap<C, ToolInputOf<T>, ToolOutputOf<T>>;\n\n  // 2) Overload: outputSchema NOT PROVIDED → execute() can return any\n  // @ts-expect-error - Module augmentation requires decorator overload\n  export function Tool<\n    I extends __Shape,\n    // Note: 'O' is omitted, 'any' is used for the generic\n    T extends ToolMetadataOptions<I, any> & { outputSchema?: never }, // ensure absent\n  >(\n    opts: T,\n  ): <C extends __Ctor>(\n    cls: C &\n      __MustExtendCtx<C> &\n      __MustParam<C, ToolInputOf<T>> & // <-- Will now show a rich error\n      __MustReturn<C, ToolOutputOf<T>>, // <-- Will now show 'any'\n  ) => __Rewrap<C, ToolInputOf<T>, ToolOutputOf<T>>;\n}\n"]}
+{"version":3,"file":"tool.decorator.js","sourceRoot":"","sources":["../../../../src/common/decorators/tool.decorator.ts"],"names":[],"mappings":";;AA+DS,oCAAY;AAAkB,4BAAI;AAAE,oCAAY;AAAkB,4BAAI;AA/D/E,4BAA0B;AAC1B,sCAAqE;AACrE,0CASqB;AAKrB;;GAEG;AACH,SAAS,YAAY,CAAC,gBAA8B;IAClD,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,MAAM,QAAQ,GAAG,qCAA0B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACpE,OAAO,CAAC,cAAc,CAAC,2BAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,EAAE,CAAC;QACpB,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,IAAI,2BAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,cAAc,CAAC,2BAAkB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;YACnF,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QACD,OAAO,CAAC,cAAc,CAAC,6BAAoB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC,CAAC;AACJ,CAAC;AASD;;GAEG;AACH,SAAS,YAAY,CAInB,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 { extendedToolMetadata, FrontMcpToolTokens } from '../tokens';\nimport {\n  ToolMetadata,\n  frontMcpToolMetadataSchema,\n  ImageOutputSchema,\n  AudioOutputSchema,\n  ResourceOutputSchema,\n  ResourceLinkOutputSchema,\n  ToolInputType,\n  ToolOutputType,\n} from '../metadata';\nimport type { ToolUIConfig } from '../metadata/tool-ui.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  return (target: any) => {\n    const metadata = frontMcpToolMetadataSchema.parse(providedMetadata);\n    Reflect.defineMetadata(FrontMcpToolTokens.type, true, target);\n    const extended = {};\n    for (const property in metadata) {\n      if (FrontMcpToolTokens[property]) {\n        Reflect.defineMetadata(FrontMcpToolTokens[property], metadata[property], target);\n      } else {\n        extended[property] = metadata[property];\n      }\n    }\n    Reflect.defineMetadata(extendedToolMetadata, extended, target);\n  };\n}\n\nexport type FrontMcpToolExecuteHandler<\n  InSchema extends ToolInputType,\n  OutSchema extends ToolOutputType,\n  In = ToolInputOf<{ inputSchema: InSchema }>,\n  Out = ToolOutputOf<{ outputSchema: OutSchema }>,\n> = (input: In, ctx: ToolContext<InSchema, OutSchema>) => Out | Promise<Out>;\n\n/**\n * Decorator that marks a class as a McpTool module and provides metadata\n */\nfunction frontMcpTool<\n  T extends ToolMetadata,\n  InSchema extends ToolInputType = T['inputSchema'],\n  OutSchema extends ToolOutputType = T['outputSchema'],\n>(providedMetadata: T): (handler: FrontMcpToolExecuteHandler<InSchema, OutSchema>) => () => 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 { FrontMcpTool, FrontMcpTool as Tool, frontMcpTool, frontMcpTool as tool };\n\n/**\n * This is a modified version of the original decorator, with the following changes:\n * - Added support for ZodRawShape as inputSchema\n * - Added support for outputSchema: any of the allowed forms\n * - Added rich error messages for input/output type mismatches\n *\n * Don't move below code outside the decorator file, it will break the module augmentation.\n */\n// ---------- zod helpers ----------\ntype __Shape = z.ZodRawShape;\ntype __AsZodObj<T> = T extends z.ZodObject<any> ? T : T extends z.ZodRawShape ? z.ZodObject<T> : never;\n\nexport type ToolInputOf<Opt> = Opt extends { inputSchema: infer I } ? z.infer<__AsZodObj<I>> : never;\n\n// ---------- output inference helpers for NEW schemas ----------\n\n/**\n * Helper to infer the return type from any Zod schema,\n * including ZodRawShape.\n */\ntype __InferZod<S> = S extends z.ZodType ? z.infer<S> : S extends z.ZodRawShape ? z.infer<z.ZodObject<S>> : never;\n\n/**\n * Infers the *output type* from a *single schema definition*\n * based on the new ToolSingleOutputType.\n */\ntype __InferFromSingleSchema<S> =\n  // Handle specific MCP type literals\n  S extends 'image'\n    ? z.infer<typeof ImageOutputSchema>\n    : S extends 'audio'\n    ? z.infer<typeof AudioOutputSchema>\n    : S extends 'resource'\n    ? z.infer<typeof ResourceOutputSchema>\n    : S extends 'resource_link'\n    ? z.infer<typeof ResourceLinkOutputSchema>\n    : // Handle primitive type literals\n    S extends 'string'\n    ? string\n    : S extends 'number'\n    ? number\n    : S extends 'boolean'\n    ? boolean\n    : S extends 'date'\n    ? Date\n    : // Handle all Zod schemas (primitives, objects, arrays, etc.)\n    // This will correctly infer z.ZodString to string, etc.\n    S extends z.ZodType | z.ZodRawShape\n    ? __InferZod<S>\n    : // Fallback for unknown/unrecognized schema\n      any;\n\n/**\n * Infers a tuple/array of output types from an array of schemas\n */\ntype __InferFromArraySchema<A> = A extends readonly any[] ? { [K in keyof A]: __InferFromSingleSchema<A[K]> } : never;\n\n/**\n * Main output type inference.\n * Handles single schemas, arrays of schemas, or no schema.\n */\nexport type ToolOutputOf<Opt> = Opt extends { outputSchema: infer O }\n  ? O extends readonly any[] // Check for array/tuple first\n    ? __InferFromArraySchema<O>\n    : __InferFromSingleSchema<O> // Handle a single schema\n  : any; // no outputSchema property at all -> allow anything\n\n// --- Define the schema types locally to constrain the generic ---\n// This mirrors your `ToolOutputType` definitions for use in constraints.\n\ntype __PrimitiveOutputType =\n  | 'string'\n  | 'number'\n  | 'date'\n  | 'boolean'\n  | z.ZodString\n  | z.ZodNumber\n  | z.ZodBoolean\n  | z.ZodBigInt\n  | z.ZodDate;\ntype __ImageOutputType = 'image';\ntype __AudioOutputType = 'audio';\ntype __ResourceOutputType = 'resource';\ntype __ResourceLinkOutputType = 'resource_link';\ntype __StructuredOutputType =\n  | z.ZodRawShape\n  | z.ZodObject<any>\n  | z.ZodArray<z.ZodType>\n  | z.ZodUnion<[z.ZodObject<any>, ...z.ZodObject<any>[]]>\n  | z.ZodDiscriminatedUnion<z.ZodObject<any>[]>;\n\ntype __ToolSingleOutputType =\n  | __PrimitiveOutputType\n  | __ImageOutputType\n  | __AudioOutputType\n  | __ResourceOutputType\n  | __ResourceLinkOutputType\n  | __StructuredOutputType;\n\n// This is the final constraint for the `outputSchema` option\ntype __OutputSchema = __ToolSingleOutputType | __ToolSingleOutputType[];\n\n/**\n * Base tool metadata options without UI field.\n */\ntype __ToolMetadataBase<I extends __Shape, O extends __OutputSchema> = ToolMetadata<\n  I | z.ZodObject<I>, // inputSchema can be a raw shape or ZodObject\n  O // outputSchema: any of the allowed forms\n>;\n\n/**\n * Tool metadata options with optional UI configuration.\n *\n * The `ui` property accepts a `ToolUIConfig` from `@frontmcp/ui/types`\n * for configuring interactive widget rendering.\n */\nexport type ToolMetadataOptions<I extends __Shape, O extends __OutputSchema> = __ToolMetadataBase<I, O> & {\n  /**\n   * UI template configuration for rendering interactive widgets.\n   *\n   * The template builder function receives typed `ctx.input` and `ctx.output`\n   * based on the tool's `inputSchema` and `outputSchema`.\n   *\n   * @see {@link ToolUIConfig} for all available options including:\n   * - `template`: React component, HTML string, or builder function\n   * - `servingMode`: 'inline' | 'static' | 'hybrid' | 'direct-url' | 'custom-url'\n   * - `csp`: Content Security Policy configuration\n   * - `widgetAccessible`: Enable MCP bridge for tool calls from widget\n   * - `displayMode`: 'inline' | 'fullscreen' | 'pip'\n   * - And more...\n   *\n   * @example HTML template builder with typed context\n   * ```typescript\n   * ui: {\n   *   template: (ctx) => `<div>${ctx.helpers.escapeHtml(ctx.output.name)}</div>`,\n   *   // ctx.output is typed based on outputSchema\n   *   servingMode: 'inline',\n   * }\n   * ```\n   *\n   * @example React component\n   * ```typescript\n   * import WeatherCard from './weather-ui';\n   * ui: {\n   *   template: WeatherCard,\n   *   servingMode: 'static',\n   * }\n   * ```\n   */\n  ui?: ToolUIConfig<ToolInputOf<{ inputSchema: I | z.ZodObject<I> }>, ToolOutputOf<{ outputSchema: O }>>;\n};\n\n// ---------- ctor & reflection ----------\ntype __Ctor = (new (...a: any[]) => any) | (abstract new (...a: any[]) => any);\ntype __A<C extends __Ctor> = C extends new (...a: infer A) => any\n  ? A\n  : C extends abstract new (...a: infer A) => any\n  ? A\n  : never;\ntype __R<C extends __Ctor> = C extends new (...a: any[]) => infer R\n  ? R\n  : C extends abstract new (...a: any[]) => infer R\n  ? R\n  : never;\ntype __Param<C extends __Ctor> = __R<C> extends { execute: (arg: infer P, ...r: any) => any } ? P : never;\ntype __Return<C extends __Ctor> = __R<C> extends { execute: (...a: any) => infer R } ? R : never;\ntype __Unwrap<T> = T extends Promise<infer U> ? U : T;\ntype __IsAny<T> = 0 extends 1 & T ? true : false;\n\n// ---------- friendly branded errors (UPDATED) ----------\n\n// Must extend ToolContext (assuming ToolContext is exported by the SDK)\ntype __MustExtendCtx<C extends __Ctor> = __R<C> extends ToolContext\n  ? unknown\n  : { 'Tool class error': 'Class must extend ToolContext' };\n\n// execute param must exactly match In (and not be any)\ntype __MustParam<C extends __Ctor, In> =\n  // 1. If 'In' (from schema) is 'any', we can't check, so allow.\n  __IsAny<In> extends true\n    ? unknown\n    : // 2. Check if the actual param type is 'any'. This is an error.\n    __IsAny<__Param<C>> extends true\n    ? { 'execute() parameter error': \"Parameter type must not be 'any'.\"; expected_input_type: In }\n    : // 3. Check for the exact match: Param extends In AND In extends Param\n    __Param<C> extends In\n    ? In extends __Param<C>\n      ? unknown // OK, exact match\n      : {\n          'execute() parameter error': 'Parameter type is too wide. It must exactly match the input schema.';\n          expected_input_type: In;\n          actual_parameter_type: __Param<C>;\n        }\n    : {\n        'execute() parameter error': 'Parameter type does not match the input schema.';\n        expected_input_type: In;\n        actual_parameter_type: __Param<C>;\n      };\n\n// execute return must be Out or Promise<Out>\ntype __MustReturn<C extends __Ctor, Out> =\n  // 1. If 'Out' (from schema) is 'any', no check is needed.\n  __IsAny<Out> extends true\n    ? unknown\n    : // 2. Check if the unwrapped return type is assignable to Out.\n    __Unwrap<__Return<C>> extends Out\n    ? unknown // OK\n    : {\n        'execute() return type error': \"The method's return type is not assignable to the expected output schema type.\";\n        expected_output_type: Out;\n        'actual_return_type (unwrapped)': __Unwrap<__Return<C>>;\n      };\n\n// Rewrapped constructor with updated ToolContext generic params\ntype __Rewrap<C extends __Ctor, In, Out> = C extends abstract new (...a: __A<C>) => __R<C>\n  ? C & (abstract new (...a: __A<C>) => ToolContext<any, any, In, Out> & __R<C>)\n  : C extends new (...a: __A<C>) => __R<C>\n  ? C & (new (...a: __A<C>) => ToolContext<any, any, In, Out> & __R<C>)\n  : never;\n\ndeclare module '@frontmcp/sdk' {\n  // ---------- the decorator (overloads) ----------\n\n  // 1) Overload: outputSchema PROVIDED → strict return typing\n  // @ts-expect-error - Module augmentation requires decorator overload\n  export function Tool<\n    I extends __Shape,\n    O extends __OutputSchema, // Use our new output schema constraint\n    T extends ToolMetadataOptions<I, O> & { outputSchema: any }, // ensure present\n  >(\n    opts: T,\n  ): <C extends __Ctor>(\n    cls: C &\n      __MustExtendCtx<C> &\n      __MustParam<C, ToolInputOf<T>> & // <-- Will now show a rich error\n      __MustReturn<C, ToolOutputOf<T>>, // <-- Will now show a rich error\n  ) => __Rewrap<C, ToolInputOf<T>, ToolOutputOf<T>>;\n\n  // 2) Overload: outputSchema NOT PROVIDED → execute() can return any\n  // @ts-expect-error - Module augmentation requires decorator overload\n  export function Tool<\n    I extends __Shape,\n    // Note: 'O' is omitted, 'any' is used for the generic\n    T extends ToolMetadataOptions<I, any> & { outputSchema?: never }, // ensure absent\n  >(\n    opts: T,\n  ): <C extends __Ctor>(\n    cls: C &\n      __MustExtendCtx<C> &\n      __MustParam<C, ToolInputOf<T>> & // <-- Will now show a rich error\n      __MustReturn<C, ToolOutputOf<T>>, // <-- Will now show 'any'\n  ) => __Rewrap<C, ToolInputOf<T>, ToolOutputOf<T>>;\n}\n"]}