@frontmcp/sdk 0.2.1 → 0.2.2

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "@frontmcp/sdk",
-  "version": "0.2.1",
-  "type": "commonjs",
+  "version": "0.2.2",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
   "exports": {
@@ -26,5 +25,6 @@
   },
   "devDependencies": {
     "typescript": "^5.9.3"
-  }
+  },
+  "type": "commonjs"
 }

package/src/decorators/front-mcp.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"front-mcp.decorator.js","sourceRoot":"","sources":["../../../src/decorators/front-mcp.decorator.ts"],"names":[],"mappings":";;AAOA,4BAiCC;AAxCD,4BAA0B;AAC1B,sCAA2C;AAC3C,0CAAuE;AAEvE;;GAEG;AACH,SAAgB,QAAQ,CAAC,gBAAkC;IACzD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAE1B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,iCAAsB,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACrF,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,2DAA2D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,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,gEAAgE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACvI,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,8EAA8E,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/J,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,CAAC,cAAc,CAAC,uBAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1D,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,uBAAc,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,gBAAgB,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE;gBACzC,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBACtB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,qFAAqF,CAAC,CAAC;gBAChH,CAAC;gBACD,gBAAgB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;QACL,CAAC;IAEH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpTokens } from '../tokens';\nimport { FrontMcpMetadata, frontMcpMetadataSchema } from '../metadata';\n\n/**\n * Decorator that marks a class as a FrontMcp Server and provides metadata\n */\nexport function FrontMcp(providedMetadata: FrontMcpMetadata): ClassDecorator {\n  return (target: Function) => {\n\n    const { error, data: metadata } = frontMcpMetadataSchema.safeParse(providedMetadata);\n    if (error) {\n      if (error.format().apps) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { apps: [?] }: \\n${JSON.stringify(error.format().apps, null, 2)}`);\n      }\n      if (error.format().providers) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { providers: [?] }: \\n${JSON.stringify(error.format().providers, null, 2)}`);\n      }\n      if (error.format().logging?.transports) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { logging: { transports: [?] } }: \\n${JSON.stringify(error.format().logging?.transports, null, 2)}`);\n      }\n      throw error;\n    }\n\n    Reflect.defineMetadata(FrontMcpTokens.type, true, target);\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpTokens[property] ?? property, metadata[property], target);\n    }\n\n    if (metadata.serve) {\n      const core = '@frontmcp/core';\n      import(core).then(({ FrontMcpInstance }) => {\n        if (!FrontMcpInstance) {\n          throw new Error(`${core} version mismatch, make sure you have the same version for all @frontmcp/* packages`);\n        }\n        FrontMcpInstance.bootstrap(metadata);\n      });\n    }\n\n  };\n}\n"]}
+{"version":3,"file":"front-mcp.decorator.js","sourceRoot":"","sources":["../../../src/decorators/front-mcp.decorator.ts"],"names":[],"mappings":";;AAOA,4BAiCC;AAxCD,4BAA0B;AAC1B,sCAAyC;AACzC,0CAAqE;AAErE;;GAEG;AACH,SAAgB,QAAQ,CAAC,gBAAkC;IACzD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAE1B,MAAM,EAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAC,GAAG,iCAAsB,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACnF,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,2DAA2D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,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,gEAAgE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACvI,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,8EAA8E,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/J,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,CAAC,cAAc,CAAC,uBAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1D,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,uBAAc,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,gBAAgB,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAC,gBAAgB,EAAC,EAAE,EAAE;gBACvC,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBACtB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,qFAAqF,CAAC,CAAC;gBAChH,CAAC;gBACD,gBAAgB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;QACL,CAAC;IAEH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport {FrontMcpTokens} from '../tokens';\nimport {FrontMcpMetadata, frontMcpMetadataSchema} from '../metadata';\n\n/**\n * Decorator that marks a class as a FrontMcp Server and provides metadata\n */\nexport function FrontMcp(providedMetadata: FrontMcpMetadata): ClassDecorator {\n  return (target: Function) => {\n\n    const {error, data: metadata} = frontMcpMetadataSchema.safeParse(providedMetadata);\n    if (error) {\n      if (error.format().apps) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { apps: [?] }: \\n${JSON.stringify(error.format().apps, null, 2)}`);\n      }\n      if (error.format().providers) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { providers: [?] }: \\n${JSON.stringify(error.format().providers, null, 2)}`);\n      }\n      if (error.format().logging?.transports) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { logging: { transports: [?] } }: \\n${JSON.stringify(error.format().logging?.transports, null, 2)}`);\n      }\n      throw error;\n    }\n\n    Reflect.defineMetadata(FrontMcpTokens.type, true, target);\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpTokens[property] ?? property, metadata[property], target);\n    }\n\n    if (metadata.serve) {\n      const core = '@frontmcp/core';\n      import(core).then(({FrontMcpInstance}) => {\n        if (!FrontMcpInstance) {\n          throw new Error(`${core} version mismatch, make sure you have the same version for all @frontmcp/* packages`);\n        }\n        FrontMcpInstance.bootstrap(metadata);\n      });\n    }\n\n  };\n}\n"]}

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

@@ -0,0 +1,12 @@
+import { HookOptions, FlowName } from '../metadata';
+/** NEW: typed variants */
+export declare function StageHookOf<Name extends FlowName>(flow: Name): (stage: ExtendFlows[Name]["stage"], opts?: HookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+export declare function WillHookOf<Name extends FlowName>(flow: Name): (stage: ExtendFlows[Name]["stage"], opts?: HookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+export declare function DidHookOf<Name extends FlowName>(flow: Name): (stage: ExtendFlows[Name]["stage"], opts?: HookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+export declare function AroundHookOf<Name extends FlowName>(name: Name): (stage: ExtendFlows[Name]["stage"], opts?: HookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+export declare function FlowHooksOf<Name extends FlowName>(name: Name): {
+    Stage: (stage: ExtendFlows[Name]["stage"], opts?: HookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+    Will: (stage: ExtendFlows[Name]["stage"], opts?: HookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+    Did: (stage: ExtendFlows[Name]["stage"], opts?: HookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+    Around: (stage: ExtendFlows[Name]["stage"], opts?: HookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+};

package/src/decorators/{flow-hooks.decorator.js → hook.decorator.js}

@@ -13,41 +13,46 @@ function registerFlowHook(target, meta) {
     Reflect.defineMetadata(tokens_1.FrontMcpFlowHookTokens.hooks, arr, ctor);
 }
 /** Base factory (kept internal) */
-function make(kind) {
+function make(flow, type) {
     return function (stage, opts = {}) {
         return (target, key, _desc) => {
+            const { priority = 0, filter, ...rest } = opts;
             registerFlowHook(target, {
-                kind,
-                stage: String(stage),
+                ...rest,
+                [tokens_1.FrontMcpFlowHookTokens.type]: true,
+                flow: flow,
+                type: type,
+                stage: stage,
                 method: String(key),
-                priority: opts.priority ?? 0,
-                filter: opts.filter,
+                priority: priority,
+                filter: filter,
+                target: target,
                 static: Boolean(target.constructor[key]),
             });
         };
     };
 }
 /** NEW: typed variants */
-function StageHookOf(name) {
-    const base = make('stage');
+function StageHookOf(flow) {
+    const base = make(flow, 'stage');
     return function (stage, opts = {}) {
         return base(stage, opts);
     };
 }
-function WillHookOf(name) {
-    const base = make('will');
+function WillHookOf(flow) {
+    const base = make(flow, 'will');
     return function (stage, opts = {}) {
         return base(stage, opts);
     };
 }
-function DidHookOf(name) {
-    const base = make('did');
+function DidHookOf(flow) {
+    const base = make(flow, 'did');
     return function (stage, opts = {}) {
         return base(stage, opts);
     };
 }
 function AroundHookOf(name) {
-    const base = make('around');
+    const base = make(name, 'around');
     return function (stage, opts = {}) {
         return base(stage, opts);
     };
@@ -60,4 +65,4 @@ function FlowHooksOf(name) {
         Around: AroundHookOf(name),
     };
 }
-//# sourceMappingURL=flow-hooks.decorator.js.map
+//# sourceMappingURL=hook.decorator.js.map

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

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

package/src/decorators/index.d.ts

@@ -1,6 +1,6 @@
 export * from './front-mcp.decorator';
 export * from './flow.decorator';
-export * from './flow-hooks.decorator';
+export * from './hook.decorator';
 export * from './app.decorator';
 export * from './provider.decorator';
 export * from './auth-provider.decorator';

package/src/decorators/index.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./front-mcp.decorator"), exports);
 tslib_1.__exportStar(require("./flow.decorator"), exports);
-tslib_1.__exportStar(require("./flow-hooks.decorator"), exports);
+tslib_1.__exportStar(require("./hook.decorator"), exports);
 tslib_1.__exportStar(require("./app.decorator"), exports);
 tslib_1.__exportStar(require("./provider.decorator"), exports);
 tslib_1.__exportStar(require("./auth-provider.decorator"), exports);

package/src/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decorators/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,2DAAiC;AACjC,iEAAuC;AACvC,0DAAgC;AAChC,+DAAqC;AACrC,oEAA0C;AAC1C,8DAAoC;AACpC,6DAAmC;AACnC,2DAAiC;AACjC,+DAAqC;AACrC,6DAAmC;AACnC,6DAAmC","sourcesContent":["export * from './front-mcp.decorator';\nexport * from './flow.decorator';\nexport * from './flow-hooks.decorator';\nexport * from './app.decorator';\nexport * from './provider.decorator';\nexport * from './auth-provider.decorator';\nexport * from './adapter.decorator';\nexport * from './plugin.decorator';\nexport * from './tool.decorator';\nexport * from './resource.decorator';\nexport * from './prompt.decorator';\nexport * from './logger.decorator';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decorators/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,2DAAiC;AACjC,2DAAiC;AACjC,0DAAgC;AAChC,+DAAqC;AACrC,oEAA0C;AAC1C,8DAAoC;AACpC,6DAAmC;AACnC,2DAAiC;AACjC,+DAAqC;AACrC,6DAAmC;AACnC,6DAAmC","sourcesContent":["export * from './front-mcp.decorator';\nexport * from './flow.decorator';\nexport * from './hook.decorator';\nexport * from './app.decorator';\nexport * from './provider.decorator';\nexport * from './auth-provider.decorator';\nexport * from './adapter.decorator';\nexport * from './plugin.decorator';\nexport * from './tool.decorator';\nexport * from './resource.decorator';\nexport * from './prompt.decorator';\nexport * from './logger.decorator';\n"]}

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

@@ -2,13 +2,41 @@ import 'reflect-metadata';
 import { ToolMetadata } from '../metadata';
 import z from 'zod';
 import { ToolContext } from "../interfaces";
+export type FrontMcpToolExecuteHandler<In extends object, Out extends object> = (input: In, ctx: ToolContext<In, Out>) => Out | Promise<Out>;
 /**
  * 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);
+declare function frontMcpTool<T extends ToolMetadata, In extends object = z.baseObjectInputType<T['inputSchema']>, Out extends object = T['outputSchema'] extends z.ZodRawShape ? z.baseObjectInputType<T['outputSchema']> : object>(providedMetadata: T): (handler: FrontMcpToolExecuteHandler<In, Out>) => (() => void);
 export { FrontMcpTool, FrontMcpTool as Tool, frontMcpTool, frontMcpTool as tool, };
+declare module "@frontmcp/sdk" {
+    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 __InputOf<Opt> = Opt extends {
+        inputSchema: infer I;
+    } ? z.infer<__AsZodObj<I>> : never;
+    type __OutputOf<Opt> = Opt extends {
+        outputSchema: infer O;
+    } ? z.infer<__AsZodObj<O>> : never;
+    type __ToolOptions<I extends __Shape, O extends __Shape> = ExtendFrontMcpToolMetadata & ToolMetadata<I | z.ZodObject<I>, O | z.ZodObject<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;
+    type __Param<C extends __Ctor> = __R<C> extends {
+        execute: (arg: infer P, ...r: any) => any;
+    } ? P : never;
+    type __Return<C extends __Ctor> = __R<C> extends {
+        execute: (...a: any) => infer R;
+    } ? R : never;
+    type __Unwrap<T> = T extends Promise<infer U> ? U : T;
+    type __IsAny<T> = 0 extends (1 & T) ? true : false;
+    type __Err<M extends string> = {
+        __type_error__: M;
+    } & {
+        never?: never;
+    };
+    type __MustExtendCtx<C extends __Ctor> = __R<C> extends ToolContext ? {} : __Err<"Class must extend ToolContext">;
+    type __MustParam<C extends __Ctor, In> = __IsAny<__Param<C>> extends true ? __Err<"execute(input) must not be any and must exactly match input schema"> : __Param<C> extends In ? (In extends __Param<C> ? {} : __Err<"execute(input) must be exactly the input schema (no widening or narrowing)">) : __Err<"execute(input) parameter does not match input schema">;
+    type __MustReturn<C extends __Ctor, Out> = __Unwrap<__Return<C>> extends Out ? {} : __Err<"execute return type must be output schema or Promise<output schema>">;
+    type __Rewrap<C extends __Ctor, In, Out> = C extends abstract new (...a: __A<C>) => __R<C> ? C & (abstract new (...a: __A<C>) => (ToolContext<In, Out> & __R<C>)) : C extends new (...a: __A<C>) => __R<C> ? C & (new (...a: __A<C>) => (ToolContext<In, Out> & __R<C>)) : never;
+    function Tool<I extends __Shape, O extends __Shape, T extends __ToolOptions<I, O>>(opts: T): <C extends __Ctor>(cls: C & __MustExtendCtx<C> & __MustParam<C, __InputOf<T>> & __MustReturn<C, __OutputOf<T>>) => __Rewrap<C, __InputOf<T>, __OutputOf<T>>;
+}

package/src/decorators/tool.decorator.js

@@ -14,9 +14,16 @@ function FrontMcpTool(providedMetadata) {
     return (target) => {
         const metadata = metadata_1.frontMcpToolMetadataSchema.parse(providedMetadata);
         Reflect.defineMetadata(tokens_1.FrontMcpToolTokens.type, true, target);
+        const extended = {};
         for (const property in metadata) {
-            Reflect.defineMetadata(tokens_1.FrontMcpToolTokens[property] ?? property, metadata[property], target);
+            if (tokens_1.FrontMcpToolTokens[property]) {
+                Reflect.defineMetadata(tokens_1.FrontMcpToolTokens[property], metadata[property], target);
+            }
+            else {
+                extended[property] = metadata[property];
+            }
         }
+        Reflect.defineMetadata(tokens_1.extendedToolMetadata, extended, target);
     };
 }
 /**

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

@@ -1 +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};"]}
+{"version":3,"file":"tool.decorator.js","sourceRoot":"","sources":["../../../src/decorators/tool.decorator.ts"],"names":[],"mappings":";;AAkDE,oCAAY;AACI,4BAAI;AACpB,oCAAY;AACI,4BAAI;AArDtB,4BAA0B;AAC1B,sCAAmE;AACnE,0CAAqE;AAIrE;;GAEG;AACH,SAAS,YAAY,CAAC,gBAA8B;IAElD,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,IAAG,2BAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,OAAO,CAAC,cAAc,CAAC,2BAAkB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;YACnF,CAAC;iBAAK,CAAC;gBACL,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;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 {extendedToolMetadata, 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    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\n\nexport type FrontMcpToolExecuteHandler<In extends object, Out extends object> = (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 extends object = z.baseObjectInputType<T['inputSchema']>,\n  Out extends object = T['outputSchema'] extends z.ZodRawShape ? z.baseObjectInputType<T['outputSchema']> : object\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};\n\n\ndeclare module \"@frontmcp/sdk\" {\n  // ---------- zod helpers ----------\n  type __Shape = z.ZodRawShape; // = Record<string, z.ZodTypeAny>\n  type __AsZodObj<T> =\n    T extends z.ZodObject<infer S> ? z.ZodObject<S> :\n      T extends z.ZodRawShape       ? z.ZodObject<T> :\n        never;\n\n  export type __InputOf<Opt>  =\n    Opt extends { inputSchema: infer I }  ? z.infer<__AsZodObj<I>>  : never;\n\n  export type __OutputOf<Opt> =\n    Opt extends { outputSchema: infer O } ? z.infer<__AsZodObj<O>> : never;\n\n  export type __ToolOptions<I extends __Shape, O extends __Shape> = ExtendFrontMcpToolMetadata & ToolMetadata<I | z.ZodObject<I>, O | z.ZodObject<O>>;\n\n  // ---------- ctor & reflection ----------\n  type __Ctor = new (...a: any[]) => any | (abstract new (...a: any[]) => any);\n  type __A<C extends __Ctor> = C extends new (...a: infer A) => any ? A\n    : C extends abstract new (...a: infer A) => any ? A : never;\n  type __R<C extends __Ctor> = C extends new (...a: any[]) => infer R ? R\n    : C extends abstract new (...a: any[]) => infer R ? R : never;\n\n  type __Param<C extends __Ctor> =\n    __R<C> extends { execute: (arg: infer P, ...r: any) => any } ? P : never;\n\n  type __Return<C extends __Ctor> =\n    __R<C> extends { execute: (...a: any) => infer R } ? R : never;\n\n  type __Unwrap<T> = T extends Promise<infer U> ? U : T;\n  type __IsAny<T> = 0 extends (1 & T) ? true : false;\n\n  // ---------- friendly branded errors ----------\n  type __Err<M extends string> = { __type_error__: M } & { never?: never };\n\n  // Must extend ToolContext\n  type __MustExtendCtx<C extends __Ctor> =\n    __R<C> extends ToolContext ? {} :\n      __Err<\"Class must extend ToolContext\">;\n\n  // execute param must exactly match In (and not be any)\n  type __MustParam<C extends __Ctor, In> =\n    __IsAny<__Param<C>> extends true\n      ? __Err<\"execute(input) must not be any and must exactly match input schema\">\n      : __Param<C> extends In\n        ? (In extends __Param<C> ? {} : __Err<\"execute(input) must be exactly the input schema (no widening or narrowing)\">)\n        : __Err<\"execute(input) parameter does not match input schema\">;\n\n  // execute return must be Out or Promise<Out>\n  type __MustReturn<C extends __Ctor, Out> =\n    __Unwrap<__Return<C>> extends Out ? {} :\n      __Err<\"execute return type must be output schema or Promise<output schema>\">;\n\n  // Rewrapped constructor: preserve concrete/abstract + original type, but guarantee ToolContext<In,Out> on instance\n  type __Rewrap<C extends __Ctor, In, Out> =\n    C extends abstract new (...a: __A<C>) => __R<C>\n      ? C & (abstract new (...a: __A<C>) => (ToolContext<In, Out> & __R<C>))\n      : C extends new (...a: __A<C>) => __R<C>\n        ? C & (new (...a: __A<C>) => (ToolContext<In, Out> & __R<C>))\n        : never;\n\n  // ---------- the decorator ----------\n  // @ts-expect-error - Module augmentation requires decorator overload\n  export function Tool<\n    I extends __Shape,\n    O extends __Shape,\n    T extends __ToolOptions<I, O>\n  >(opts: T): <\n    C extends __Ctor\n  >(cls: C &\n    __MustExtendCtx<C> &\n    __MustParam<C, __InputOf<T>> &\n    __MustReturn<C, __OutputOf<T>>\n  ) => __Rewrap<C, __InputOf<T>, __OutputOf<T>>;\n}"]}

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

@@ -39,6 +39,7 @@ export declare abstract class DynamicPlugin<TOptions extends object> {
      * @param options
      */
     static dynamicProviders?(options: any): readonly ProviderType[];
+    get<T>(token: Reference<T>): T;
     /**
      * Static init() method to create a plugin provider.
      * @param options

package/src/dynamic/dynamic.plugin.js

@@ -3,6 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DynamicPlugin = void 0;
 const dynamic_utils_1 = require("./dynamic.utils");
 class DynamicPlugin {
+    get(token) {
+        throw new Error('Method not implemented.');
+    }
     /**
      * Static init() method to create a plugin provider.
      * @param options

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

@@ -1 +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}"]}
+{"version":3,"file":"dynamic.plugin.js","sourceRoot":"","sources":["../../../src/dynamic/dynamic.plugin.ts"],"names":[],"mappings":";;;AAEA,mDAA+E;AA0B/E,MAAsB,aAAa;IAYjC,GAAG,CAAI,KAAmB;QACxB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED;;;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;aACvD,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;AA9CD,sCA8CC","sourcesContent":["// dynamic-plugin.ts\nimport {Reference, PluginType, ProviderType, ProviderRegistryInterface} 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  get<T>(token: Reference<T>): T {\n    throw new Error('Method not implemented.');\n  }\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    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/entries/base.entry.d.ts

@@ -12,7 +12,7 @@ export declare abstract class BaseEntry<Record extends {
     metadata: any;
 }, Interface, Metadata> {
     ready: Promise<void>;
-    protected readonly record: Record;
+    readonly record: Record;
     protected readonly token: Token<Interface>;
     readonly metadata: Metadata;
     constructor(record: Record, token?: Token<Interface>, metadata?: Metadata);

package/src/entries/base.entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.entry.js","sourceRoot":"","sources":["../../../src/entries/base.entry.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAQ1B,MAAsB,SAAS;IAC7B,KAAK,CAAgB;IACF,MAAM,CAAS;IACf,KAAK,CAAmB;IAClC,QAAQ,CAAW;IAE5B,YAAY,MAAc,EAAE,KAAwB,EAAE,QAAmB;QACvE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC;IAC9C,CAAC;CAGF;AAbD,8BAaC","sourcesContent":["import 'reflect-metadata';\nimport { Token } from '../interfaces';\n\nexport type EntryOwnerKind = 'scope' | 'app' | 'plugin' | 'adapter';\nexport type EntryOwnerRef = { kind: EntryOwnerKind; id: string, ref: Token };\nexport type EntryLineage = EntryOwnerRef[]; // root -> leaf; e.g. [{kind:'app', id:'Portal'}, {kind:'plugin', id:'Okta'}]\n\n\nexport abstract class BaseEntry<Record extends { provide: any, metadata: any }, Interface, Metadata> {\n  ready: Promise<void>;\n  protected readonly record: Record;\n  protected readonly token: Token<Interface>;\n  readonly metadata: Metadata;\n\n  constructor(record: Record, token?: Token<Interface>, metadata?: Metadata) {\n    this.record = record;\n    this.token = token ?? record.provide;\n    this.metadata = metadata ?? record.metadata;\n  }\n\n  protected abstract initialize(): Promise<void>;\n}\n"]}
+{"version":3,"file":"base.entry.js","sourceRoot":"","sources":["../../../src/entries/base.entry.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAQ1B,MAAsB,SAAS;IAC7B,KAAK,CAAgB;IACZ,MAAM,CAAS;IACL,KAAK,CAAmB;IAClC,QAAQ,CAAW;IAE5B,YAAY,MAAc,EAAE,KAAwB,EAAE,QAAmB;QACvE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC;IAC9C,CAAC;CAGF;AAbD,8BAaC","sourcesContent":["import 'reflect-metadata';\nimport { Token } from '../interfaces';\n\nexport type EntryOwnerKind = 'scope' | 'app' | 'plugin' | 'adapter';\nexport type EntryOwnerRef = { kind: EntryOwnerKind; id: string, ref: Token };\nexport type EntryLineage = EntryOwnerRef[]; // root -> leaf; e.g. [{kind:'app', id:'Portal'}, {kind:'plugin', id:'Okta'}]\n\n\nexport abstract class BaseEntry<Record extends { provide: any, metadata: any }, Interface, Metadata> {\n  ready: Promise<void>;\n  readonly record: Record;\n  protected readonly token: Token<Interface>;\n  readonly metadata: Metadata;\n\n  constructor(record: Record, token?: Token<Interface>, metadata?: Metadata) {\n    this.record = record;\n    this.token = token ?? record.provide;\n    this.metadata = metadata ?? record.metadata;\n  }\n\n  protected abstract initialize(): Promise<void>;\n}\n"]}

package/src/entries/flow.entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"flow.entry.js","sourceRoot":"","sources":["../../../src/entries/flow.entry.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAC1B,6CAAyC;AAQzC,MAAsB,SAAiC,SAAQ,sBAAoD;IACxG,IAAI,CAAO;IACX,IAAI,CAAmB,CAAC,oEAAoE;IAC5F,MAAM,CAAc;IACpB,KAAK,CAAa;IAM3B,YAAsB,KAAiB,EAAC,MAAkB,EAAE,KAAuB,EAAE,QAA8B;QACjH,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC/B,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,IAAI,QAAQ,EAAE,UAAU,IAAI,EAAE,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CAEF;AAnBD,8BAmBC","sourcesContent":["import 'reflect-metadata';\nimport { BaseEntry } from './base.entry';\nimport { FlowRecord } from '../records';\nimport { FlowBase, FlowInputOf, FlowOutputOf, HttpMethod, ServerRequest, Token, Type } from '../interfaces';\nimport { FlowMetadata, FlowName } from '../metadata';\nimport { ScopeEntry } from './scope.entry';\nimport { z } from 'zod';\n\n\nexport abstract class FlowEntry<Name extends FlowName> extends BaseEntry<FlowRecord, FlowBase, FlowMetadata<never>> {\n  readonly name: Name;\n  readonly path?: RegExp | string; // string can be \"/test/**\" or \"/test/*/asds\", default to all paths;\n  readonly method?: HttpMethod;\n  readonly scope: ScopeEntry;\n\n  abstract canActivate(request: ServerRequest): Promise<boolean>\n\n  abstract run(input: FlowInputOf<Name>, deps: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>\n\n  protected constructor(scope: ScopeEntry,record: FlowRecord, token?: Token<FlowBase>, metadata?: FlowMetadata<never>) {\n    super(record, token, metadata);\n    const { path, method } = record.metadata.middleware ?? metadata?.middleware ?? {};\n    this.name = metadata?.name ?? record.metadata?.name;\n    this.path = path;\n    this.method = method;\n    this.scope = scope;\n  }\n\n}\n\n"]}
+{"version":3,"file":"flow.entry.js","sourceRoot":"","sources":["../../../src/entries/flow.entry.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAC1B,6CAAyC;AAOzC,MAAsB,SAAiC,SAAQ,sBAAoD;IACxG,IAAI,CAAO;IACX,IAAI,CAAmB,CAAC,oEAAoE;IAC5F,MAAM,CAAc;IACpB,KAAK,CAAa;IAM3B,YAAsB,KAAiB,EAAC,MAAkB,EAAE,KAAuB,EAAE,QAA8B;QACjH,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC/B,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,IAAI,QAAQ,EAAE,UAAU,IAAI,EAAE,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CAEF;AAnBD,8BAmBC","sourcesContent":["import 'reflect-metadata';\nimport { BaseEntry } from './base.entry';\nimport { FlowRecord } from '../records';\nimport { FlowBase, FlowInputOf, FlowOutputOf, HttpMethod, ServerRequest, Token, Type } from '../interfaces';\nimport { FlowMetadata, FlowName } from '../metadata';\nimport { ScopeEntry } from './scope.entry';\n\n\nexport abstract class FlowEntry<Name extends FlowName> extends BaseEntry<FlowRecord, FlowBase, FlowMetadata<never>> {\n  readonly name: Name;\n  readonly path?: RegExp | string; // string can be \"/test/**\" or \"/test/*/asds\", default to all paths;\n  readonly method?: HttpMethod;\n  readonly scope: ScopeEntry;\n\n  abstract canActivate(request: ServerRequest): Promise<boolean>\n\n  abstract run(input: FlowInputOf<Name>, deps: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>\n\n  protected constructor(scope: ScopeEntry,record: FlowRecord, token?: Token<FlowBase>, metadata?: FlowMetadata<never>) {\n    super(record, token, metadata);\n    const { path, method } = record.metadata.middleware ?? metadata?.middleware ?? {};\n    this.name = metadata?.name ?? record.metadata?.name;\n    this.path = path;\n    this.method = method;\n    this.scope = scope;\n  }\n\n}\n\n"]}

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

@@ -0,0 +1,12 @@
+import { ScopeEntry } from "./scope.entry";
+import { HookOptions, HookMetadata, FlowName } from "../metadata";
+import { HookRecord } from "../records";
+import { HookBase, ProviderRegistryInterface, Token } from "../interfaces";
+import { BaseEntry } from "./base.entry";
+export declare abstract class HookEntry<In = any, Name extends FlowName = FlowName, Stage = string, Ctx = any> extends BaseEntry<HookRecord, HookBase<In, Ctx>, HookMetadata<Name, Stage, Ctx>> {
+    readonly scope: ScopeEntry;
+    readonly providers: ProviderRegistryInterface;
+    readonly options: HookOptions<Ctx>;
+    protected constructor(scope: ScopeEntry, providers: ProviderRegistryInterface, record: HookRecord, token: Token, metadata: HookMetadata<Name, Stage, Ctx>);
+    abstract run(input: In, ctx: Ctx): Promise<void>;
+}

package/src/entries/hook.entry.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HookEntry = void 0;
+const base_entry_1 = require("./base.entry");
+class HookEntry extends base_entry_1.BaseEntry {
+    scope;
+    providers;
+    options;
+    constructor(scope, providers, record, token, metadata) {
+        super(record, token, metadata);
+        this.scope = scope;
+        this.providers = providers;
+        this.options = {
+            filter: metadata.filter,
+            priority: metadata.priority
+        };
+    }
+}
+exports.HookEntry = HookEntry;
+//# sourceMappingURL=hook.entry.js.map

package/src/entries/hook.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.entry.js","sourceRoot":"","sources":["../../../src/entries/hook.entry.ts"],"names":[],"mappings":";;;AAIA,6CAAuC;AAEvC,MAAsB,SAAiF,SAAQ,sBAAwE;IAC5K,KAAK,CAAa;IAClB,SAAS,CAA4B;IACrC,OAAO,CAAmB;IAEnC,YAAsB,KAAiB,EAAE,SAAoC,EAAE,MAAkB,EAAE,KAAY,EAAE,QAAyC;QACxJ,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG;YACb,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B,CAAA;IACH,CAAC;CAGF;AAhBD,8BAgBC","sourcesContent":["import {ScopeEntry} from \"./scope.entry\";\nimport {HookOptions, HookMetadata, FlowName} from \"../metadata\";\nimport {HookRecord} from \"../records\";\nimport {HookBase, ProviderRegistryInterface, Token} from \"../interfaces\";\nimport {BaseEntry} from \"./base.entry\";\n\nexport abstract class HookEntry<In = any, Name extends FlowName = FlowName, Stage = string, Ctx = any> extends BaseEntry<HookRecord, HookBase<In, Ctx>, HookMetadata<Name, Stage, Ctx>> {\n  readonly scope: ScopeEntry;\n  readonly providers: ProviderRegistryInterface;\n  readonly options: HookOptions<Ctx>;\n\n  protected constructor(scope: ScopeEntry, providers: ProviderRegistryInterface, record: HookRecord, token: Token, metadata:  HookMetadata<Name, Stage, Ctx>) {\n    super(record, token, metadata);\n    this.scope = scope;\n    this.providers = providers;\n    this.options = {\n      filter: metadata.filter,\n      priority: metadata.priority\n    }\n  }\n\n  abstract run(input: In, ctx: Ctx): Promise<void>;\n}"]}

package/src/entries/index.d.ts

@@ -1,6 +1,7 @@
 export * from './base.entry';
 export * from './scope.entry';
 export * from './flow.entry';
+export * from './hook.entry';
 export * from './app.entry';
 export * from './provider.entry';
 export * from './auth-provider.entry';

package/src/entries/index.js

@@ -4,6 +4,7 @@ const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./base.entry"), exports);
 tslib_1.__exportStar(require("./scope.entry"), exports);
 tslib_1.__exportStar(require("./flow.entry"), exports);
+tslib_1.__exportStar(require("./hook.entry"), exports);
 tslib_1.__exportStar(require("./app.entry"), exports);
 tslib_1.__exportStar(require("./provider.entry"), exports);
 tslib_1.__exportStar(require("./auth-provider.entry"), exports);

package/src/entries/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/entries/index.ts"],"names":[],"mappings":";;;AAAA,uDAA6B;AAC7B,wDAA8B;AAC9B,uDAA6B;AAC7B,sDAA4B;AAC5B,2DAAiC;AACjC,gEAAsC;AACtC,yDAA+B;AAC/B,0DAAgC;AAChC,uDAA6B;AAC7B,2DAAiC;AACjC,yDAA+B;AAC/B,yDAA+B","sourcesContent":["export * from './base.entry';\nexport * from './scope.entry';\nexport * from './flow.entry';\nexport * from './app.entry';\nexport * from './provider.entry';\nexport * from './auth-provider.entry';\nexport * from './plugin.entry';\nexport * from './adapter.entry';\nexport * from './tool.entry';\nexport * from './resource.entry';\nexport * from './prompt.entry';\nexport * from './logger.entry';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/entries/index.ts"],"names":[],"mappings":";;;AAAA,uDAA6B;AAC7B,wDAA8B;AAC9B,uDAA6B;AAC7B,uDAA6B;AAC7B,sDAA4B;AAC5B,2DAAiC;AACjC,gEAAsC;AACtC,yDAA+B;AAC/B,0DAAgC;AAChC,uDAA6B;AAC7B,2DAAiC;AACjC,yDAA+B;AAC/B,yDAA+B","sourcesContent":["export * from './base.entry';\nexport * from './scope.entry';\nexport * from './flow.entry';\nexport * from './hook.entry';\nexport * from './app.entry';\nexport * from './provider.entry';\nexport * from './auth-provider.entry';\nexport * from './plugin.entry';\nexport * from './adapter.entry';\nexport * from './tool.entry';\nexport * from './resource.entry';\nexport * from './prompt.entry';\nexport * from './logger.entry';\n"]}

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

@@ -1,6 +1,7 @@
 import { BaseEntry } from './base.entry';
 import { PluginRecord } from '../records';
-import { PluginInterface } from '../interfaces';
+import { PluginInterface, Token } from '../interfaces';
 import { PluginMetadata } from '../metadata';
 export declare abstract class PluginEntry extends BaseEntry<PluginRecord, PluginInterface, PluginMetadata> {
+    abstract get<T>(token: Token<T>): T;
 }

package/src/entries/plugin.entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.entry.js","sourceRoot":"","sources":["../../../src/entries/plugin.entry.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AAMzC,MAAsB,WAAY,SAAQ,sBAAwD;CAGjG;AAHD,kCAGC","sourcesContent":["import { BaseEntry } from './base.entry';\nimport { PluginRecord } from '../records';\nimport { PluginInterface } from '../interfaces';\nimport { PluginMetadata } from '../metadata';\n\n\nexport abstract class PluginEntry extends BaseEntry<PluginRecord, PluginInterface, PluginMetadata> {\n\n\n}"]}
+{"version":3,"file":"plugin.entry.js","sourceRoot":"","sources":["../../../src/entries/plugin.entry.ts"],"names":[],"mappings":";;;AAAA,6CAAuC;AAMvC,MAAsB,WAAY,SAAQ,sBAAwD;CAGjG;AAHD,kCAGC","sourcesContent":["import {BaseEntry} from './base.entry';\nimport {PluginRecord} from '../records';\nimport {PluginInterface, Token} from '../interfaces';\nimport {PluginMetadata} from '../metadata';\n\n\nexport abstract class PluginEntry extends BaseEntry<PluginRecord, PluginInterface, PluginMetadata> {\n\n  abstract get<T>(token: Token<T>): T;\n}"]}

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

@@ -1,6 +1,6 @@
 import { BaseEntry } from './base.entry';
 import { ScopeRecord } from '../records';
-import { ScopeInterface, ProviderRegistryInterface, AppRegistryInterface, AuthRegistryInterface, FrontMcpAuth, Token, FlowInputOf, FlowOutputOf, Type, FlowType, FrontMcpLogger, ToolRegistryInterface } from '../interfaces';
+import { ScopeInterface, ProviderRegistryInterface, AppRegistryInterface, AuthRegistryInterface, FrontMcpAuth, Token, FlowInputOf, FlowOutputOf, Type, FlowType, FrontMcpLogger, ToolRegistryInterface, HookRegistryInterface } from '../interfaces';
 import { FlowName, ScopeMetadata } from '../metadata';
 export declare abstract class ScopeEntry extends BaseEntry<ScopeRecord, ScopeInterface, ScopeMetadata> {
     abstract readonly id: string;
@@ -8,6 +8,7 @@ export declare abstract class ScopeEntry extends BaseEntry<ScopeRecord, ScopeInt
     abstract readonly routeBase: string;
     abstract readonly logger: FrontMcpLogger;
     abstract get auth(): FrontMcpAuth;
+    abstract get hooks(): HookRegistryInterface;
     abstract get authProviders(): AuthRegistryInterface;
     abstract get providers(): ProviderRegistryInterface;
     abstract get apps(): AppRegistryInterface;

package/src/entries/scope.entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"scope.entry.js","sourceRoot":"","sources":["../../../src/entries/scope.entry.ts"],"names":[],"mappings":";;;AAAA,6CAAuC;AAYvC,MAAsB,UAAW,SAAQ,sBAAqD;CAmB7F;AAnBD,gCAmBC","sourcesContent":["import {BaseEntry} from './base.entry';\nimport {ScopeRecord} from '../records';\nimport {\n  ScopeInterface,\n  ProviderRegistryInterface,\n  AppRegistryInterface,\n  AuthRegistryInterface,\n  FrontMcpAuth,\n  Token, FlowInputOf, FlowOutputOf, Type, FlowType, FrontMcpLogger, ToolRegistryInterface,\n} from '../interfaces';\nimport {FlowName, ScopeMetadata} from '../metadata';\n\nexport abstract class ScopeEntry extends BaseEntry<ScopeRecord, ScopeInterface, ScopeMetadata> {\n  abstract readonly id: string;\n  abstract readonly entryPath: string;\n  abstract readonly routeBase: string;\n  abstract readonly logger: FrontMcpLogger;\n\n  abstract get auth(): FrontMcpAuth;\n\n  abstract get authProviders(): AuthRegistryInterface;\n\n  abstract get providers(): ProviderRegistryInterface;\n\n  abstract get apps(): AppRegistryInterface;\n\n  abstract get tools(): ToolRegistryInterface;\n\n  abstract registryFlows(...flows: FlowType[]): Promise<void>;\n\n  abstract runFlow<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, additionalDeps?: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>;\n}\n"]}
+{"version":3,"file":"scope.entry.js","sourceRoot":"","sources":["../../../src/entries/scope.entry.ts"],"names":[],"mappings":";;;AAAA,6CAAuC;AAYvC,MAAsB,UAAW,SAAQ,sBAAqD;CAqB7F;AArBD,gCAqBC","sourcesContent":["import {BaseEntry} from './base.entry';\nimport {ScopeRecord} from '../records';\nimport {\n  ScopeInterface,\n  ProviderRegistryInterface,\n  AppRegistryInterface,\n  AuthRegistryInterface,\n  FrontMcpAuth,\n  Token, FlowInputOf, FlowOutputOf, Type, FlowType, FrontMcpLogger, ToolRegistryInterface, HookRegistryInterface,\n} from '../interfaces';\nimport {FlowName, ScopeMetadata} from '../metadata';\n\nexport abstract class ScopeEntry extends BaseEntry<ScopeRecord, ScopeInterface, ScopeMetadata> {\n  abstract readonly id: string;\n  abstract readonly entryPath: string;\n  abstract readonly routeBase: string;\n  abstract readonly logger: FrontMcpLogger;\n\n  abstract get auth(): FrontMcpAuth;\n\n  abstract get hooks(): HookRegistryInterface;\n\n  abstract get authProviders(): AuthRegistryInterface;\n\n  abstract get providers(): ProviderRegistryInterface;\n\n  abstract get apps(): AppRegistryInterface;\n\n  abstract get tools(): ToolRegistryInterface;\n\n  abstract registryFlows(...flows: FlowType[]): Promise<void>;\n\n  abstract runFlow<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, additionalDeps?: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>;\n}\n"]}

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

@@ -5,9 +5,12 @@ import { ToolContext } from '../interfaces';
 import { ToolMetadata } from '../metadata';
 import { Request, Notification, CallToolRequest } from "@modelcontextprotocol/sdk/types.js";
 import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import { AuthInfo } from "@modelcontextprotocol/sdk/server/auth/types.js";
 export type ToolCallArgs = CallToolRequest["params"]["arguments"];
-export type ToolCallExtra = RequestHandlerExtra<Request, Notification>;
-export declare abstract class ToolEntry<In = z.ZodRawShape, Out = z.ZodRawShape> extends BaseEntry<ToolRecord, ToolContext<In, Out>, ToolMetadata> {
+export type ToolCallExtra = RequestHandlerExtra<Request, Notification> & {
+    authInfo: AuthInfo;
+};
+export declare abstract class ToolEntry<In extends object = any, Out extends object = any> extends BaseEntry<ToolRecord, ToolContext<In, Out>, ToolMetadata> {
     owner: EntryOwnerRef;
     inputSchema: z.ZodObject<any>;
     rawInputSchema: z.ZodObject<any>;

package/src/entries/tool.entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.entry.js","sourceRoot":"","sources":["../../../src/entries/tool.entry.ts"],"names":[],"mappings":";;;AACA,6CAAsD;AAWtD,MAAsB,SAAmD,SAAQ,sBAAyD;IACxI,KAAK,CAAgB;IACrB,WAAW,CAAmB;IAC9B,cAAc,CAAmB;IACjC,YAAY,CAAmB;CAGhC;AAPD,8BAOC","sourcesContent":["import {z} from 'zod';\nimport {BaseEntry, EntryOwnerRef} from './base.entry';\nimport {ToolRecord} from '../records';\nimport {ToolContext} from '../interfaces';\nimport {ToolMetadata} from '../metadata';\nimport {Request, Notification, CallToolRequest} from \"@modelcontextprotocol/sdk/types.js\";\nimport {RequestHandlerExtra} from \"@modelcontextprotocol/sdk/shared/protocol.js\";\n\n\nexport type ToolCallArgs = CallToolRequest[\"params\"][\"arguments\"];\nexport type ToolCallExtra = RequestHandlerExtra<Request, Notification>;\n\nexport abstract class ToolEntry<In = z.ZodRawShape, Out = z.ZodRawShape> extends BaseEntry<ToolRecord, ToolContext<In, Out>, ToolMetadata> {\n  owner: EntryOwnerRef;\n  inputSchema: z.ZodObject<any>;\n  rawInputSchema: z.ZodObject<any>;\n  outputSchema: z.ZodObject<any>;\n\n  abstract create(input: ToolCallArgs, ctx: ToolCallExtra): ToolContext<In, Out>;\n}\n"]}
+{"version":3,"file":"tool.entry.js","sourceRoot":"","sources":["../../../src/entries/tool.entry.ts"],"names":[],"mappings":";;;AACA,6CAAsD;AActD,MAAsB,SAA6D,SAAQ,sBAAyD;IAClJ,KAAK,CAAgB;IACrB,WAAW,CAAmB;IAC9B,cAAc,CAAmB;IACjC,YAAY,CAAmB;CAGhC;AAPD,8BAOC","sourcesContent":["import {z} from 'zod';\nimport {BaseEntry, EntryOwnerRef} from './base.entry';\nimport {ToolRecord} from '../records';\nimport {ToolContext} from '../interfaces';\nimport {ToolMetadata} from '../metadata';\nimport {Request, Notification, CallToolRequest} from \"@modelcontextprotocol/sdk/types.js\";\nimport {RequestHandlerExtra} from \"@modelcontextprotocol/sdk/shared/protocol.js\";\nimport {AuthInfo} from \"@modelcontextprotocol/sdk/server/auth/types.js\";\n\n\nexport type ToolCallArgs = CallToolRequest[\"params\"][\"arguments\"];\nexport type ToolCallExtra = RequestHandlerExtra<Request, Notification> & {\n  authInfo: AuthInfo;\n};\n\nexport abstract class ToolEntry<In extends object = any, Out extends object = any> extends BaseEntry<ToolRecord, ToolContext<In, Out>, ToolMetadata> {\n  owner: EntryOwnerRef;\n  inputSchema: z.ZodObject<any>;\n  rawInputSchema: z.ZodObject<any>;\n  outputSchema: z.ZodObject<any>;\n\n  abstract create(input: ToolCallArgs, ctx: ToolCallExtra): ToolContext<In, Out>;\n}\n"]}

package/src/interfaces/flow.interface.d.ts

@@ -1,13 +1,15 @@
 import { Token, Type } from './base.interface';
 import { FlowMetadata, FlowName } from '../metadata';
 import { z } from 'zod';
-import { ScopeEntry } from '../entries';
+import { HookEntry, ScopeEntry } from '../entries';
 import { FlowStateOf } from './internal/flow.utils';
 import { FrontMcpLogger } from "./logger.interface";
 export type FlowInputOf<N extends FlowName> = z.infer<ExtendFlows[N]['input']>;
 export type FlowOutputOf<N extends FlowName> = z.infer<ExtendFlows[N]['output']>;
 export type FlowPlanOf<N extends FlowName> = ExtendFlows[N]['plan'];
 export type FlowCtxOf<N extends FlowName> = ExtendFlows[N]['ctx'];
+export type FlowStagesOf<N extends FlowName> = ExtendFlows[N]['stage'];
+export type FlowExecuteStagesOf<N extends FlowName> = ExtendFlows[N]['executeStage'];
 export type FlowControlType = 'respond' | 'fail' | 'abort' | 'next' | 'handled';
 export declare class FlowControl extends Error {
     readonly type: FlowControlType;
@@ -21,18 +23,19 @@ export declare class FlowControl extends Error {
 }
 export declare abstract class FlowBase<N extends FlowName = FlowName> {
     protected readonly metadata: FlowMetadata<N>;
-    protected readonly rawInput: Partial<FlowInputOf<N>> | any;
+    readonly rawInput: Partial<FlowInputOf<N>> | any;
     protected readonly scope: ScopeEntry;
+    protected readonly appendContextHooks: (hooks: HookEntry[]) => void;
     protected readonly deps: ReadonlyMap<Token, unknown>;
     protected input: FlowInputOf<N>;
     state: FlowStateOf<N>;
     scopeLogger: FrontMcpLogger;
-    constructor(metadata: FlowMetadata<N>, rawInput: Partial<FlowInputOf<N>> | any, scope: ScopeEntry, deps?: ReadonlyMap<Token, unknown>);
+    constructor(metadata: FlowMetadata<N>, rawInput: Partial<FlowInputOf<N>> | any, scope: ScopeEntry, appendContextHooks: (hooks: HookEntry[]) => void, deps?: ReadonlyMap<Token, unknown>);
     get<T>(token: Token<T>): T;
-    protected respond(output: FlowOutputOf<N>): void;
-    protected fail(error: Error): void;
+    respond(output: FlowOutputOf<N>): void;
+    fail(error: Error): void;
     protected abort(message: string): void;
     protected next(): void;
     protected handled(): void;
 }
-export type FlowType<Provide = FlowBase<FlowName>> = Type<Provide>;
+export type FlowType<Provide = FlowBase> = Type<Provide>;

package/src/interfaces/flow.interface.js

@@ -20,7 +20,7 @@ class FlowControl extends Error {
         throw new FlowControl('handled', null);
     }
     static fail(error) {
-        throw new FlowControl('fail', error);
+        throw new FlowControl('fail', { error: error.message });
     }
     static abort(reason) {
         throw new FlowControl('abort', reason);
@@ -32,14 +32,16 @@ class FlowBase {
     metadata;
     rawInput;
     scope;
+    appendContextHooks;
     deps;
     input;
     state = flow_utils_1.FlowState.create({});
     scopeLogger;
-    constructor(metadata, rawInput, scope, deps = new Map()) {
+    constructor(metadata, rawInput, scope, appendContextHooks, deps = new Map()) {
         this.metadata = metadata;
         this.rawInput = rawInput;
         this.scope = scope;
+        this.appendContextHooks = appendContextHooks;
         this.deps = deps;
         this.input = metadata.inputSchema?.parse?.(rawInput);
         this.scopeLogger = scope.logger;

package/src/interfaces/flow.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"flow.interface.js","sourceRoot":"","sources":["../../../src/interfaces/flow.interface.ts"],"names":[],"mappings":";;;AAIA,sDAA6D;AAW7D,MAAa,WAAY,SAAQ,KAAK;IACR;IAAuC;IAAnE,YAA4B,IAAqB,EAAkB,MAAW;QAC5E,KAAK,EAAE,CAAC;QADkB,SAAI,GAAJ,IAAI,CAAiB;QAAkB,WAAM,GAAN,MAAM,CAAK;IAE9E,CAAC;IAED,MAAM,CAAC,OAAO,CAAI,MAAS;QACzB,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,IAAI;QACT,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,OAAO;QACZ,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAY;QACtB,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAc;QACzB,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;CAEF;AAzBD,kCAyBC;AAGD,uCAAuC;AACvC,MAAsB,QAAQ;IAMP;IACA;IACA;IACA;IARX,KAAK,CAAiB;IAChC,KAAK,GAAmB,sBAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7C,WAAW,CAAiB;IAE5B,YACqB,QAAyB,EACzB,QAAuC,EACvC,KAAiB,EACjB,OAAoC,IAAI,GAAG,EAAE;QAH7C,aAAQ,GAAR,QAAQ,CAAiB;QACzB,aAAQ,GAAR,QAAQ,CAA+B;QACvC,UAAK,GAAL,KAAK,CAAY;QACjB,SAAI,GAAJ,IAAI,CAAyC;QAEhE,IAAI,CAAC,KAAK,GAAI,QAAQ,CAAC,WAAmB,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;IAClC,CAAC;IAED,GAAG,CAAI,KAAe;QACpB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAM,CAAC;QAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAES,OAAO,CAAC,MAAuB;QACvC,MAAM,WAAW,CAAC,OAAO,CAAE,IAAI,CAAC,QAAQ,CAAC,YAAiC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5F,CAAC;IAES,IAAI,CAAC,KAAY;QACzB,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAES,KAAK,CAAC,OAAe;QAC7B,MAAM,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAES,IAAI;QACZ,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAES,OAAO;QACf,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;CACF;AAvCD,4BAuCC","sourcesContent":["import {Token, Type} from './base.interface';\nimport {FlowMetadata, FlowName} from '../metadata';\nimport {z} from 'zod';\nimport {ScopeEntry} from '../entries';\nimport {FlowState, FlowStateOf} from './internal/flow.utils';\nimport {FrontMcpLogger} from \"./logger.interface\";\n\nexport type FlowInputOf<N extends FlowName> = z.infer<ExtendFlows[N]['input']>;\nexport type FlowOutputOf<N extends FlowName> = z.infer<ExtendFlows[N]['output']>;\nexport type FlowPlanOf<N extends FlowName> = ExtendFlows[N]['plan'];\nexport type FlowCtxOf<N extends FlowName> = ExtendFlows[N]['ctx'];\n\n\nexport type FlowControlType = 'respond' | 'fail' | 'abort' | 'next' | 'handled';\n\nexport class FlowControl extends Error {\n  constructor(public readonly type: FlowControlType, public readonly output: any) {\n    super();\n  }\n\n  static respond<T>(output: T): never {\n    throw new FlowControl('respond', output);\n  }\n\n  static next(): never {\n    throw new FlowControl('next', null);\n  }\n\n  static handled(): never {\n    throw new FlowControl('handled', null);\n  }\n\n  static fail(error: Error): never {\n    throw new FlowControl('fail', error);\n  }\n\n  static abort(reason: string): never {\n    throw new FlowControl('abort', reason);\n  }\n\n}\n\n\n// 1) The actual abstract class (value)\nexport abstract class FlowBase<N extends FlowName = FlowName> {\n  protected input: FlowInputOf<N>;\n  state: FlowStateOf<N> = FlowState.create({});\n  scopeLogger: FrontMcpLogger;\n\n  constructor(\n    protected readonly metadata: FlowMetadata<N>,\n    protected readonly rawInput: Partial<FlowInputOf<N>> | any,\n    protected readonly scope: ScopeEntry,\n    protected readonly deps: ReadonlyMap<Token, unknown> = new Map(),\n  ) {\n    this.input = (metadata.inputSchema as any)?.parse?.(rawInput);\n    this.scopeLogger = scope.logger;\n  }\n\n  get<T>(token: Token<T>): T {\n    if (this.deps.has(token)) return this.deps.get(token) as T;\n    return this.scope.providers.get(token);\n  }\n\n  protected respond(output: FlowOutputOf<N>) {\n    throw FlowControl.respond((this.metadata.outputSchema as z.ZodObject<any>).parse(output));\n  }\n\n  protected fail(error: Error) {\n    throw FlowControl.fail(error);\n  }\n\n  protected abort(message: string) {\n    throw FlowControl.abort(message);\n  }\n\n  protected next() {\n    throw FlowControl.next();\n  }\n\n  protected handled() {\n    throw FlowControl.handled();\n  }\n}\n\nexport type FlowType<Provide = FlowBase<FlowName>> =\n  | Type<Provide>\n\n"]}
+{"version":3,"file":"flow.interface.js","sourceRoot":"","sources":["../../../src/interfaces/flow.interface.ts"],"names":[],"mappings":";;;AAIA,sDAA6D;AAa7D,MAAa,WAAY,SAAQ,KAAK;IACR;IAAuC;IAAnE,YAA4B,IAAqB,EAAkB,MAAW;QAC5E,KAAK,EAAE,CAAC;QADkB,SAAI,GAAJ,IAAI,CAAiB;QAAkB,WAAM,GAAN,MAAM,CAAK;IAE9E,CAAC;IAED,MAAM,CAAC,OAAO,CAAI,MAAS;QACzB,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,IAAI;QACT,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,OAAO;QACZ,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAY;QACtB,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,EAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAc;QACzB,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;CAEF;AAzBD,kCAyBC;AAGD,uCAAuC;AACvC,MAAsB,QAAQ;IAMP;IACV;IACU;IACA;IACA;IATX,KAAK,CAAiB;IAChC,KAAK,GAAmB,sBAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7C,WAAW,CAAiB;IAE5B,YACqB,QAAyB,EACnC,QAAuC,EAC7B,KAAiB,EACjB,kBAAgD,EAChD,OAAoC,IAAI,GAAG,EAAE;QAJ7C,aAAQ,GAAR,QAAQ,CAAiB;QACnC,aAAQ,GAAR,QAAQ,CAA+B;QAC7B,UAAK,GAAL,KAAK,CAAY;QACjB,uBAAkB,GAAlB,kBAAkB,CAA8B;QAChD,SAAI,GAAJ,IAAI,CAAyC;QAEhE,IAAI,CAAC,KAAK,GAAI,QAAQ,CAAC,WAAmB,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;IAClC,CAAC;IAED,GAAG,CAAI,KAAe;QACpB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAM,CAAC;QAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,CAAC,MAAuB;QAC7B,MAAM,WAAW,CAAC,OAAO,CAAE,IAAI,CAAC,QAAQ,CAAC,YAAiC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,IAAI,CAAC,KAAY;QACf,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAES,KAAK,CAAC,OAAe;QAC7B,MAAM,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAES,IAAI;QACZ,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAES,OAAO;QACf,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;CAEF;AAzCD,4BAyCC","sourcesContent":["import {Token, Type} from './base.interface';\nimport {FlowMetadata, FlowName} from '../metadata';\nimport {z} from 'zod';\nimport {HookEntry, ScopeEntry} from '../entries';\nimport {FlowState, FlowStateOf} from './internal/flow.utils';\nimport {FrontMcpLogger} from \"./logger.interface\";\n\nexport type FlowInputOf<N extends FlowName> = z.infer<ExtendFlows[N]['input']>;\nexport type FlowOutputOf<N extends FlowName> = z.infer<ExtendFlows[N]['output']>;\nexport type FlowPlanOf<N extends FlowName> = ExtendFlows[N]['plan'];\nexport type FlowCtxOf<N extends FlowName> = ExtendFlows[N]['ctx'];\nexport type FlowStagesOf<N extends FlowName> = ExtendFlows[N]['stage'];\nexport type FlowExecuteStagesOf<N extends FlowName> = ExtendFlows[N]['executeStage'];\n\n\nexport type FlowControlType = 'respond' | 'fail' | 'abort' | 'next' | 'handled';\n\nexport class FlowControl extends Error {\n  constructor(public readonly type: FlowControlType, public readonly output: any) {\n    super();\n  }\n\n  static respond<T>(output: T): never {\n    throw new FlowControl('respond', output);\n  }\n\n  static next(): never {\n    throw new FlowControl('next', null);\n  }\n\n  static handled(): never {\n    throw new FlowControl('handled', null);\n  }\n\n  static fail(error: Error): never {\n    throw new FlowControl('fail', {error: error.message});\n  }\n\n  static abort(reason: string): never {\n    throw new FlowControl('abort', reason);\n  }\n\n}\n\n\n// 1) The actual abstract class (value)\nexport abstract class FlowBase<N extends FlowName = FlowName> {\n  protected input: FlowInputOf<N>;\n  state: FlowStateOf<N> = FlowState.create({});\n  scopeLogger: FrontMcpLogger;\n\n  constructor(\n    protected readonly metadata: FlowMetadata<N>,\n    readonly rawInput: Partial<FlowInputOf<N>> | any,\n    protected readonly scope: ScopeEntry,\n    protected readonly appendContextHooks: (hooks: HookEntry[]) => void,\n    protected readonly deps: ReadonlyMap<Token, unknown> = new Map(),\n  ) {\n    this.input = (metadata.inputSchema as any)?.parse?.(rawInput);\n    this.scopeLogger = scope.logger;\n  }\n\n  get<T>(token: Token<T>): T {\n    if (this.deps.has(token)) return this.deps.get(token) as T;\n    return this.scope.providers.get(token);\n  }\n\n  respond(output: FlowOutputOf<N>) {\n    throw FlowControl.respond((this.metadata.outputSchema as z.ZodObject<any>).parse(output));\n  }\n\n  fail(error: Error) {\n    throw FlowControl.fail(error);\n  }\n\n  protected abort(message: string) {\n    throw FlowControl.abort(message);\n  }\n\n  protected next() {\n    throw FlowControl.next();\n  }\n\n  protected handled() {\n    throw FlowControl.handled();\n  }\n\n}\n\nexport type FlowType<Provide = FlowBase> =\n  | Type<Provide>\n\n"]}

package/src/interfaces/hook.interface.d.ts

@@ -0,0 +1,3 @@
+import { Type } from './base.interface';
+export type HookBase<In, Ctx> = (input: In, ctx?: Ctx) => Promise<void>;
+export type HookType = Type<HookBase<any, any>>;

package/src/{metadata/flow-hooks.metadata.js → interfaces/hook.interface.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=flow-hooks.metadata.js.map
+//# sourceMappingURL=hook.interface.js.map

package/src/interfaces/hook.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.interface.js","sourceRoot":"","sources":["../../../src/interfaces/hook.interface.ts"],"names":[],"mappings":"","sourcesContent":["import {Type} from './base.interface';\n\nexport type HookBase<In, Ctx> = (input: In, ctx?: Ctx) => Promise<void>;\n\nexport type HookType = Type<HookBase<any, any>>\n\n"]}

package/src/interfaces/index.d.ts

@@ -3,6 +3,7 @@ export * from './front-mcp.interface';
 export * from './server.interface';
 export * from './scope.interface';
 export * from './flow.interface';
+export * from './hook.interface';
 export * from './app.interface';
 export * from './provider.interface';
 export * from './auth-provider.interface';

package/src/interfaces/index.js

@@ -6,6 +6,7 @@ tslib_1.__exportStar(require("./front-mcp.interface"), exports);
 tslib_1.__exportStar(require("./server.interface"), exports);
 tslib_1.__exportStar(require("./scope.interface"), exports);
 tslib_1.__exportStar(require("./flow.interface"), exports);
+tslib_1.__exportStar(require("./hook.interface"), exports);
 tslib_1.__exportStar(require("./app.interface"), exports);
 tslib_1.__exportStar(require("./provider.interface"), exports);
 tslib_1.__exportStar(require("./auth-provider.interface"), exports);