@frontmcp/sdk 0.4.0 → 0.5.0

package/src/front-mcp/front-mcp.providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"front-mcp.providers.js","sourceRoot":"","sources":["../../../src/front-mcp/front-mcp.providers.ts"],"names":[],"mappings":";;AA4BA,4DAKC;AAjCD,sCAKmB;AACnB,+DAAmE;AACnE,yDAAoD;AAEpD,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE,CAAC,QAA4B,EAAyC,EAAE,CAAC,CAAC;QAC9E,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,iCAAc;QACvB,KAAK,EAAE,sBAAa,CAAC,MAAM;QAC3B,QAAQ,EAAE,QAAQ;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,cAAc,GAAG,IAAA,sBAAa,EAAC;IACnC,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,sBAAa,CAAC,MAAM;IAC3B,OAAO,EAAE,uBAAc;IACvB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,iCAAc,CAAC;IAC9B,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;QACrB,OAAO,IAAI,wCAAsB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;CACF,CAAC,CAAC;AAEH,SAAgB,wBAAwB,CAAC,QAA4B;IACnE,OAAO;QACL,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC7B,cAAc;KACf,CAAC;AACJ,CAAC","sourcesContent":["import {\n  FrontMcpConfigType,\n  ProviderScope,\n  FrontMcpServer,\n  ProviderValueType,  AsyncProvider,\n} from '../common';\nimport { FrontMcpServerInstance } from '../server/server.instance';\nimport { FrontMcpConfig } from './front-mcp.tokens';\n\nconst frontMcpConfig = {\n  with: (metadata: FrontMcpConfigType): ProviderValueType<FrontMcpConfigType> => ({\n    name: 'frontmcp:config',\n    provide: FrontMcpConfig,\n    scope: ProviderScope.GLOBAL,\n    useValue: metadata,\n  }),\n};\n\nconst frontMcpServer = AsyncProvider({\n  name: 'frontmcp:server',\n  scope: ProviderScope.GLOBAL,\n  provide: FrontMcpServer,\n  inject: () => [FrontMcpConfig],\n  useFactory: (config) => {\n    return new FrontMcpServerInstance(config.http);\n  },\n});\n\nexport function createMcpGlobalProviders(metadata: FrontMcpConfigType) {\n  return [\n    frontMcpConfig.with(metadata),\n    frontMcpServer,\n  ];\n}\n"]}
+{"version":3,"file":"front-mcp.providers.js","sourceRoot":"","sources":["../../../src/front-mcp/front-mcp.providers.ts"],"names":[],"mappings":";;AAyBA,4DAEC;AA3BD,sCAAgH;AAChH,+DAAmE;AACnE,yDAAoD;AAEpD,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE,CAAC,QAA4B,EAAyC,EAAE,CAAC,CAAC;QAC9E,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,iCAAc;QACvB,KAAK,EAAE,sBAAa,CAAC,MAAM;QAC3B,QAAQ,EAAE,QAAQ;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,oBAAoB,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAE/D,MAAM,cAAc,GAAG,IAAA,sBAAa,EAAC;IACnC,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,sBAAa,CAAC,MAAM;IAC3B,OAAO,EAAE,uBAAc;IACvB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,iCAAc,CAAC;IAC9B,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;QACrB,OAAO,IAAI,wCAAsB,CAAC,MAAM,CAAC,IAAI,IAAI,oBAAoB,CAAC,CAAC;IACzE,CAAC;CACF,CAAC,CAAC;AAEH,SAAgB,wBAAwB,CAAC,QAA4B;IACnE,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC,CAAC;AACzD,CAAC","sourcesContent":["import { FrontMcpConfigType, ProviderScope, FrontMcpServer, ProviderValueType, AsyncProvider } from '../common';\nimport { FrontMcpServerInstance } from '../server/server.instance';\nimport { FrontMcpConfig } from './front-mcp.tokens';\n\nconst frontMcpConfig = {\n  with: (metadata: FrontMcpConfigType): ProviderValueType<FrontMcpConfigType> => ({\n    name: 'frontmcp:config',\n    provide: FrontMcpConfig,\n    scope: ProviderScope.GLOBAL,\n    useValue: metadata,\n  }),\n};\n\nconst DEFAULT_HTTP_OPTIONS = { port: 3000, entryPath: '/mcp' };\n\nconst frontMcpServer = AsyncProvider({\n  name: 'frontmcp:server',\n  scope: ProviderScope.GLOBAL,\n  provide: FrontMcpServer,\n  inject: () => [FrontMcpConfig],\n  useFactory: (config) => {\n    return new FrontMcpServerInstance(config.http ?? DEFAULT_HTTP_OPTIONS);\n  },\n});\n\nexport function createMcpGlobalProviders(metadata: FrontMcpConfigType) {\n  return [frontMcpConfig.with(metadata), frontMcpServer];\n}\n"]}

package/src/hooks/hook.instance.d.ts

@@ -1,4 +1,4 @@
-import { FlowCtxOf, FlowInputOf, FlowName, FlowStagesOf, FrontMcpLogger, HookEntry, HookRecord, ProviderRegistryInterface, ScopeEntry, Token } from "../common";
+import { FlowCtxOf, FlowInputOf, FlowName, FlowStagesOf, FrontMcpLogger, HookEntry, HookRecord, ProviderRegistryInterface, ScopeEntry, Token } from '../common';
 export declare class HookInstance<Name extends FlowName, In = FlowInputOf<Name>, Stage = FlowStagesOf<Name>, Ctx = FlowCtxOf<Name>> extends HookEntry<In, Name, Stage, Ctx> {
     logger: FrontMcpLogger;
     constructor(scope: ScopeEntry, providers: ProviderRegistryInterface, record: HookRecord, token: Token);

package/src/hooks/hook.instance.js

@@ -14,9 +14,12 @@ class HookInstance extends common_1.HookEntry {
     }
     async run(input, ctx) {
         const { target, method } = this.metadata;
-        this.logger.verbose("start");
+        if (!target) {
+            throw new Error(`Hook target is not defined for method "${method}". This is a bug in hook configuration.`);
+        }
+        this.logger.verbose('start');
         await target[method](input, ctx);
-        this.logger.verbose("start");
+        this.logger.verbose('done');
     }
 }
 exports.HookInstance = HookInstance;

package/src/hooks/hook.instance.js.map

@@ -1 +1 @@
-{"version":3,"file":"hook.instance.js","sourceRoot":"","sources":["../../../src/hooks/hook.instance.ts"],"names":[],"mappings":";;;AAAA,sCAQmB;AAGnB,MAAa,YACX,SAAQ,kBAA+B;IACvC,MAAM,CAAiB;IAEvB,YAAY,KAAiB,EAAE,SAAoC,EAAE,MAAkB,EAAE,KAAY;QACnG,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,QAA0C,CAAC,CAAC;QAE1F,MAAM,EAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAC,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC3C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,SAAS,KAAK,IAAI,MAAM,GAAG,CAAC,CAAA;IACtE,CAAC;IAES,UAAU;QAClB,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAS,EAAE,GAAQ;QAC3B,MAAM,EAAC,MAAM,EAAE,MAAM,EAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC5B,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9B,CAAC;CACF;AArBD,oCAqBC","sourcesContent":["import {\n  FlowCtxOf,\n  FlowInputOf,\n  FlowName,\n  FlowStagesOf, FrontMcpLogger,\n  HookEntry, HookMetadata, HookRecord,\n  ProviderRegistryInterface,\n  ScopeEntry, Token\n} from \"../common\";\n\n\nexport class HookInstance<Name extends FlowName, In = FlowInputOf<Name>, Stage = FlowStagesOf<Name>, Ctx = FlowCtxOf<Name>>\n  extends HookEntry<In, Name, Stage, Ctx> {\n  logger: FrontMcpLogger;\n\n  constructor(scope: ScopeEntry, providers: ProviderRegistryInterface, record: HookRecord, token: Token) {\n    super(scope, providers, record, token, record.metadata as HookMetadata<Name, Stage, Ctx>);\n\n    const {flow, method, stage} = this.metadata\n    this.logger = scope.logger.child(`${flow}:hook:${stage}(${method})`)\n  }\n\n  protected initialize(): Promise<void> {\n    return Promise.resolve(undefined);\n  }\n\n  async run(input: In, ctx: Ctx): Promise<void> {\n    const {target, method} = this.metadata;\n    this.logger.verbose(\"start\")\n    await target[method](input, ctx);\n    this.logger.verbose(\"start\")\n  }\n}"]}
+{"version":3,"file":"hook.instance.js","sourceRoot":"","sources":["../../../src/hooks/hook.instance.ts"],"names":[],"mappings":";;;AAAA,sCAYmB;AAEnB,MAAa,YAKX,SAAQ,kBAA+B;IACvC,MAAM,CAAiB;IAEvB,YAAY,KAAiB,EAAE,SAAoC,EAAE,MAAkB,EAAE,KAAY;QACnG,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,QAA0C,CAAC,CAAC;QAE1F,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,SAAS,KAAK,IAAI,MAAM,GAAG,CAAC,CAAC;IACvE,CAAC;IAES,UAAU;QAClB,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAS,EAAE,GAAQ;QAC3B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,yCAAyC,CAAC,CAAC;QAC7G,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACF;AA5BD,oCA4BC","sourcesContent":["import {\n  FlowCtxOf,\n  FlowInputOf,\n  FlowName,\n  FlowStagesOf,\n  FrontMcpLogger,\n  HookEntry,\n  HookMetadata,\n  HookRecord,\n  ProviderRegistryInterface,\n  ScopeEntry,\n  Token,\n} from '../common';\n\nexport class HookInstance<\n  Name extends FlowName,\n  In = FlowInputOf<Name>,\n  Stage = FlowStagesOf<Name>,\n  Ctx = FlowCtxOf<Name>,\n> extends HookEntry<In, Name, Stage, Ctx> {\n  logger: FrontMcpLogger;\n\n  constructor(scope: ScopeEntry, providers: ProviderRegistryInterface, record: HookRecord, token: Token) {\n    super(scope, providers, record, token, record.metadata as HookMetadata<Name, Stage, Ctx>);\n\n    const { flow, method, stage } = this.metadata;\n    this.logger = scope.logger.child(`${flow}:hook:${stage}(${method})`);\n  }\n\n  protected initialize(): Promise<void> {\n    return Promise.resolve(undefined);\n  }\n\n  async run(input: In, ctx: Ctx): Promise<void> {\n    const { target, method } = this.metadata;\n    if (!target) {\n      throw new Error(`Hook target is not defined for method \"${method}\". This is a bug in hook configuration.`);\n    }\n    this.logger.verbose('start');\n    await target[method](input, ctx);\n    this.logger.verbose('done');\n  }\n}\n"]}

package/src/hooks/hook.registry.js

@@ -89,16 +89,18 @@ class HookRegistry extends regsitry_1.RegistryAbstract {
         this.instances.set(token, instance);
         // Keep raw records grouped by class (if needed elsewhere)
         const cls = rec.metadata.target;
-        const recs = this.recordsByCls.get(cls) ?? [];
-        recs.push(rec);
-        this.recordsByCls.set(cls, recs);
+        if (cls) {
+            const recs = this.recordsByCls.get(cls) ?? [];
+            recs.push(rec);
+            this.recordsByCls.set(cls, recs);
+        }
         // Build fast indexes of *instances*, sorted by priority
         const entry = this.instances.get(token);
         const { flow, stage, target } = rec.metadata;
-        if (embedded) {
+        if (embedded && target) {
             this.indexByClass(target.constructor ?? target, entry);
         }
-        else {
+        else if (!embedded) {
             this.indexByFlowStage(flow, String(stage), entry);
             this.indexByFlow(flow, entry);
         }

package/src/hooks/hook.registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"hook.registry.js","sourceRoot":"","sources":["../../../src/hooks/hook.registry.ts"],"names":[],"mappings":"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","sourcesContent":["// src/hooks/hook.registry.ts\n\nimport {\n  FlowCtxOf,\n  FlowInputOf,\n  FlowName,\n  FlowStagesOf,\n  HookEntry,\n  HookRecord,\n  HookRegistryInterface,\n  HookType,\n  ScopeEntry,\n  Token,\n} from '../common';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { HookInstance } from './hook.instance';\n\nexport default class HookRegistry\n  extends RegistryAbstract<HookEntry, HookRecord, HookType[]>\n  implements HookRegistryInterface\n{\n  scope: ScopeEntry;\n\n  /** Historical records by class (kept if you still want access to raw records) */\n  recordsByCls: Map<Token, HookRecord[]> = new Map();\n\n  /** Fast O(1) indexes of *instances*, sorted by priority (desc) */\n  private entriesByCls: Map<Token, HookEntry[]> = new Map();\n  private hooksByFlow: Map<FlowName, HookEntry[]> = new Map();\n  private hooksByFlowStage: Map<FlowName, Map<string, HookEntry[]>> = new Map();\n\n  constructor(providers: ProviderRegistry, list: HookType[]) {\n    super('HookRegistry', providers, list);\n    this.scope = this.providers.getActiveScope();\n  }\n\n  protected override buildMap(): RegistryBuildMapResult<HookRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, HookRecord>();\n    const graph = new Map<Token, Set<Token>>();\n    /**\n     * No need to build graph for hooks,\n     * hooks are injected by other tokens\n     */\n    return { tokens, defs, graph };\n  }\n\n  protected buildGraph() {\n    /**\n     * Currently, hooks cannot be depended on other tokens,\n     * in the future we can add this feature, so hooks can depends on:\n     * - other hooks completions\n     * - specific injected providers\n     */\n  }\n\n  async initialize() {\n    /**\n     * No need to initialize hooks,\n     * hooks are injected by other tokens\n     */\n  }\n\n  /** Priority helper (default 0) */\n  private getPriority(entry: Pick<HookEntry, 'metadata'> | Pick<HookRecord, 'metadata'>): number {\n    return entry.metadata?.priority ?? 0;\n  }\n\n  /** Binary insert by priority (desc). Stable for equal priorities. */\n  private insertSorted(arr: HookEntry[], item: HookEntry) {\n    const p = this.getPriority(item);\n    let lo = 0;\n    let hi = arr.length;\n    // Insert AFTER existing equal-priority items to keep stable order.\n    while (lo < hi) {\n      const mid = (lo + hi) >>> 1;\n      const mp = this.getPriority(arr[mid]);\n      if (mp < p) {\n        hi = mid;\n      } else {\n        lo = mid + 1;\n      }\n    }\n    arr.splice(lo, 0, item);\n  }\n\n  private upsert<K, V>(map: Map<K, V>, key: K, init: () => V): V {\n    let v = map.get(key);\n    if (!v) {\n      v = init();\n      map.set(key, v);\n    }\n    return v;\n  }\n\n  private indexByClass(cls: Token, entry: HookEntry) {\n    const list = this.upsert(this.entriesByCls, cls, () => []);\n    this.insertSorted(list, entry);\n  }\n\n  private indexByFlow(flow: FlowName, entry: HookEntry) {\n    const list = this.upsert(this.hooksByFlow, flow, () => []);\n    this.insertSorted(list, entry);\n  }\n\n  private indexByFlowStage(flow: FlowName, stage: string, entry: HookEntry) {\n    const stages = this.upsert(this.hooksByFlowStage, flow, () => new Map<string, HookEntry[]>());\n    const list = this.upsert(stages, String(stage), () => []);\n    this.insertSorted(list, entry);\n  }\n\n  private initializeOne(embedded: boolean, token: Token) {\n    const rec = this.defs.get(token)!;\n    const providers = this.providers; // nearest token provider registry\n    const instance = new HookInstance(this.scope, providers, rec, token);\n    this.instances.set(token, instance);\n\n    // Keep raw records grouped by class (if needed elsewhere)\n    const cls = rec.metadata.target;\n    const recs = this.recordsByCls.get(cls) ?? [];\n    recs.push(rec);\n    this.recordsByCls.set(cls, recs);\n\n    // Build fast indexes of *instances*, sorted by priority\n    const entry = this.instances.get(token)!;\n    const { flow, stage, target } = rec.metadata;\n\n    if (embedded) {\n      this.indexByClass(target.constructor ?? target, entry);\n    } else {\n      this.indexByFlowStage(flow, String(stage), entry);\n      this.indexByFlow(flow, entry);\n    }\n\n    return instance.ready;\n  }\n\n  registerHooks(embedded: boolean, ...records: HookRecord[]) {\n    const readyArr: Promise<void>[] = [];\n    for (const record of records) {\n      this.defs.set(record.provide, record);\n      this.tokens.add(record.provide);\n      this.graph.set(record.provide, new Set());\n      readyArr.push(this.initializeOne(embedded, record.provide));\n    }\n    return Promise.all(readyArr);\n  }\n\n  /** Hooks for a given *flow*, filtered by owner if provided, sorted by priority (desc). */\n  getFlowHooksForOwner<Name extends FlowName>(\n    flow: Name,\n    ownerId?: string,\n  ): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[] {\n    const allHooks = this.getFlowHooks(flow);\n    if (!ownerId) {\n      return allHooks;\n    }\n    // Filter hooks to only include those that belong to the same owner or have no owner (global hooks)\n    return allHooks.filter((hook) => {\n      const hookOwner = hook.metadata.owner;\n      return !hookOwner || hookOwner.id === ownerId;\n    });\n  }\n\n  /** Hooks defined on a given *class* (metadata.target), sorted by priority (desc). */\n  getClsHooks(token: Token): HookEntry[] {\n    return this.entriesByCls.get(token) ?? [];\n  }\n\n  /** All hooks (instances, unordered) */\n  getHooks(): HookEntry[] {\n    return [...this.instances.values()];\n  }\n\n  /** Hooks for a given *flow*, sorted by priority (desc). */\n  getFlowHooks<Name extends FlowName>(\n    flow: Name,\n  ): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[] {\n    const list = this.hooksByFlow.get(flow) ?? [];\n    return list as HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[];\n  }\n\n  /** Hooks for a specific *flow + stage*, sorted by priority (desc). */\n  getFlowStageHooks<Name extends FlowName>(\n    flow: Name,\n    stage: FlowStagesOf<Name> | string,\n  ): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[] {\n    const byStage = this.hooksByFlowStage.get(flow);\n    const list = byStage?.get(String(stage)) ?? [];\n    return list as HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[];\n  }\n}\n"]}
+{"version":3,"file":"hook.registry.js","sourceRoot":"","sources":["../../../src/hooks/hook.registry.ts"],"names":[],"mappings":"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","sourcesContent":["// src/hooks/hook.registry.ts\n\nimport {\n  FlowCtxOf,\n  FlowInputOf,\n  FlowName,\n  FlowStagesOf,\n  HookEntry,\n  HookRecord,\n  HookRegistryInterface,\n  HookType,\n  ScopeEntry,\n  Token,\n} from '../common';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { HookInstance } from './hook.instance';\n\nexport default class HookRegistry\n  extends RegistryAbstract<HookEntry, HookRecord, HookType[]>\n  implements HookRegistryInterface\n{\n  scope: ScopeEntry;\n\n  /** Historical records by class (kept if you still want access to raw records) */\n  recordsByCls: Map<Token, HookRecord[]> = new Map();\n\n  /** Fast O(1) indexes of *instances*, sorted by priority (desc) */\n  private entriesByCls: Map<Token, HookEntry[]> = new Map();\n  private hooksByFlow: Map<FlowName, HookEntry[]> = new Map();\n  private hooksByFlowStage: Map<FlowName, Map<string, HookEntry[]>> = new Map();\n\n  constructor(providers: ProviderRegistry, list: HookType[]) {\n    super('HookRegistry', providers, list);\n    this.scope = this.providers.getActiveScope();\n  }\n\n  protected override buildMap(): RegistryBuildMapResult<HookRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, HookRecord>();\n    const graph = new Map<Token, Set<Token>>();\n    /**\n     * No need to build graph for hooks,\n     * hooks are injected by other tokens\n     */\n    return { tokens, defs, graph };\n  }\n\n  protected buildGraph() {\n    /**\n     * Currently, hooks cannot be depended on other tokens,\n     * in the future we can add this feature, so hooks can depends on:\n     * - other hooks completions\n     * - specific injected providers\n     */\n  }\n\n  async initialize() {\n    /**\n     * No need to initialize hooks,\n     * hooks are injected by other tokens\n     */\n  }\n\n  /** Priority helper (default 0) */\n  private getPriority(entry: Pick<HookEntry, 'metadata'> | Pick<HookRecord, 'metadata'>): number {\n    return entry.metadata?.priority ?? 0;\n  }\n\n  /** Binary insert by priority (desc). Stable for equal priorities. */\n  private insertSorted(arr: HookEntry[], item: HookEntry) {\n    const p = this.getPriority(item);\n    let lo = 0;\n    let hi = arr.length;\n    // Insert AFTER existing equal-priority items to keep stable order.\n    while (lo < hi) {\n      const mid = (lo + hi) >>> 1;\n      const mp = this.getPriority(arr[mid]);\n      if (mp < p) {\n        hi = mid;\n      } else {\n        lo = mid + 1;\n      }\n    }\n    arr.splice(lo, 0, item);\n  }\n\n  private upsert<K, V>(map: Map<K, V>, key: K, init: () => V): V {\n    let v = map.get(key);\n    if (!v) {\n      v = init();\n      map.set(key, v);\n    }\n    return v;\n  }\n\n  private indexByClass(cls: Token, entry: HookEntry) {\n    const list = this.upsert(this.entriesByCls, cls, () => []);\n    this.insertSorted(list, entry);\n  }\n\n  private indexByFlow(flow: FlowName, entry: HookEntry) {\n    const list = this.upsert(this.hooksByFlow, flow, () => []);\n    this.insertSorted(list, entry);\n  }\n\n  private indexByFlowStage(flow: FlowName, stage: string, entry: HookEntry) {\n    const stages = this.upsert(this.hooksByFlowStage, flow, () => new Map<string, HookEntry[]>());\n    const list = this.upsert(stages, String(stage), () => []);\n    this.insertSorted(list, entry);\n  }\n\n  private initializeOne(embedded: boolean, token: Token) {\n    const rec = this.defs.get(token)!;\n    const providers = this.providers; // nearest token provider registry\n    const instance = new HookInstance(this.scope, providers, rec, token);\n    this.instances.set(token, instance);\n\n    // Keep raw records grouped by class (if needed elsewhere)\n    const cls = rec.metadata.target;\n    if (cls) {\n      const recs = this.recordsByCls.get(cls) ?? [];\n      recs.push(rec);\n      this.recordsByCls.set(cls, recs);\n    }\n\n    // Build fast indexes of *instances*, sorted by priority\n    const entry = this.instances.get(token)!;\n    const { flow, stage, target } = rec.metadata;\n\n    if (embedded && target) {\n      this.indexByClass(target.constructor ?? target, entry);\n    } else if (!embedded) {\n      this.indexByFlowStage(flow, String(stage), entry);\n      this.indexByFlow(flow, entry);\n    }\n\n    return instance.ready;\n  }\n\n  registerHooks(embedded: boolean, ...records: HookRecord[]) {\n    const readyArr: Promise<void>[] = [];\n    for (const record of records) {\n      this.defs.set(record.provide, record);\n      this.tokens.add(record.provide);\n      this.graph.set(record.provide, new Set());\n      readyArr.push(this.initializeOne(embedded, record.provide));\n    }\n    return Promise.all(readyArr);\n  }\n\n  /** Hooks for a given *flow*, filtered by owner if provided, sorted by priority (desc). */\n  getFlowHooksForOwner<Name extends FlowName>(\n    flow: Name,\n    ownerId?: string,\n  ): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[] {\n    const allHooks = this.getFlowHooks(flow);\n    if (!ownerId) {\n      return allHooks;\n    }\n    // Filter hooks to only include those that belong to the same owner or have no owner (global hooks)\n    return allHooks.filter((hook) => {\n      const hookOwner = hook.metadata.owner;\n      return !hookOwner || hookOwner.id === ownerId;\n    });\n  }\n\n  /** Hooks defined on a given *class* (metadata.target), sorted by priority (desc). */\n  getClsHooks(token: Token): HookEntry[] {\n    return this.entriesByCls.get(token) ?? [];\n  }\n\n  /** All hooks (instances, unordered) */\n  getHooks(): HookEntry[] {\n    return [...this.instances.values()];\n  }\n\n  /** Hooks for a given *flow*, sorted by priority (desc). */\n  getFlowHooks<Name extends FlowName>(\n    flow: Name,\n  ): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[] {\n    const list = this.hooksByFlow.get(flow) ?? [];\n    return list as HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[];\n  }\n\n  /** Hooks for a specific *flow + stage*, sorted by priority (desc). */\n  getFlowStageHooks<Name extends FlowName>(\n    flow: Name,\n    stage: FlowStagesOf<Name> | string,\n  ): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[] {\n    const byStage = this.hooksByFlowStage.get(flow);\n    const list = byStage?.get(String(stage)) ?? [];\n    return list as HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[];\n  }\n}\n"]}

package/src/index.d.ts

@@ -1,11 +1,12 @@
 import 'reflect-metadata';
 export { FrontMcpInstance } from './front-mcp';
-export * from "./common";
+export * from './common';
+export { ToolChangeEvent, ToolChangeKind, ToolChangeScope } from './tool/tool.events';
 export declare const ToolHook: {
-    Stage: (stage: "execute" | "finalize" | "parseInput" | "findTool" | "createToolCallContext" | "acquireQuota" | "acquireSemaphore" | "validateInput" | "validateOutput" | "releaseSemaphore" | "releaseQuota", opts?: import("./common").HookOptions<import("./tool/flows/call-tool.flow").default>) => MethodDecorator;
-    Will: (stage: "execute" | "finalize" | "parseInput" | "findTool" | "createToolCallContext" | "acquireQuota" | "acquireSemaphore" | "validateInput" | "validateOutput" | "releaseSemaphore" | "releaseQuota", opts?: import("./common").HookOptions<import("./tool/flows/call-tool.flow").default>) => MethodDecorator;
-    Did: (stage: "execute" | "finalize" | "parseInput" | "findTool" | "createToolCallContext" | "acquireQuota" | "acquireSemaphore" | "validateInput" | "validateOutput" | "releaseSemaphore" | "releaseQuota", opts?: import("./common").HookOptions<import("./tool/flows/call-tool.flow").default>) => MethodDecorator;
-    Around: (stage: "execute" | "finalize" | "parseInput" | "findTool" | "createToolCallContext" | "acquireQuota" | "acquireSemaphore" | "validateInput" | "validateOutput" | "releaseSemaphore" | "releaseQuota", opts?: import("./common").HookOptions<import("./tool/flows/call-tool.flow").default>) => MethodDecorator;
+    Stage: (stage: "execute" | "finalize" | "parseInput" | "findTool" | "checkToolAuthorization" | "createToolCallContext" | "acquireQuota" | "acquireSemaphore" | "validateInput" | "validateOutput" | "releaseSemaphore" | "releaseQuota", opts?: import("./common").HookOptions<import("./tool/flows/call-tool.flow").default>) => MethodDecorator;
+    Will: (stage: "execute" | "finalize" | "parseInput" | "findTool" | "checkToolAuthorization" | "createToolCallContext" | "acquireQuota" | "acquireSemaphore" | "validateInput" | "validateOutput" | "releaseSemaphore" | "releaseQuota", opts?: import("./common").HookOptions<import("./tool/flows/call-tool.flow").default>) => MethodDecorator;
+    Did: (stage: "execute" | "finalize" | "parseInput" | "findTool" | "checkToolAuthorization" | "createToolCallContext" | "acquireQuota" | "acquireSemaphore" | "validateInput" | "validateOutput" | "releaseSemaphore" | "releaseQuota", opts?: import("./common").HookOptions<import("./tool/flows/call-tool.flow").default>) => MethodDecorator;
+    Around: (stage: "execute" | "finalize" | "parseInput" | "findTool" | "checkToolAuthorization" | "createToolCallContext" | "acquireQuota" | "acquireSemaphore" | "validateInput" | "validateOutput" | "releaseSemaphore" | "releaseQuota", opts?: import("./common").HookOptions<import("./tool/flows/call-tool.flow").default>) => MethodDecorator;
 };
 export declare const ListToolsHook: {
     Stage: (stage: "parseInput" | "findTools" | "resolveConflicts" | "parseTools", opts?: import("./common").HookOptions<import("./tool/flows/tools-list.flow").default>) => MethodDecorator;
@@ -14,8 +15,26 @@ export declare const ListToolsHook: {
     Around: (stage: "parseInput" | "findTools" | "resolveConflicts" | "parseTools", opts?: import("./common").HookOptions<import("./tool/flows/tools-list.flow").default>) => MethodDecorator;
 };
 export declare const HttpHook: {
-    Stage: (stage: "error" | "finalize" | "acquireQuota" | "acquireSemaphore" | "releaseSemaphore" | "releaseQuota" | "checkAuthorization" | "router" | "handleLegacySse" | "handleSse" | "handleStreamableHttp" | "handleStatefulHttp" | "handleStatelessHttp" | "audit" | "metrics", opts?: import("./common").HookOptions<import("./scope/flows/http.request.flow").default>) => MethodDecorator;
-    Will: (stage: "error" | "finalize" | "acquireQuota" | "acquireSemaphore" | "releaseSemaphore" | "releaseQuota" | "checkAuthorization" | "router" | "handleLegacySse" | "handleSse" | "handleStreamableHttp" | "handleStatefulHttp" | "handleStatelessHttp" | "audit" | "metrics", opts?: import("./common").HookOptions<import("./scope/flows/http.request.flow").default>) => MethodDecorator;
-    Did: (stage: "error" | "finalize" | "acquireQuota" | "acquireSemaphore" | "releaseSemaphore" | "releaseQuota" | "checkAuthorization" | "router" | "handleLegacySse" | "handleSse" | "handleStreamableHttp" | "handleStatefulHttp" | "handleStatelessHttp" | "audit" | "metrics", opts?: import("./common").HookOptions<import("./scope/flows/http.request.flow").default>) => MethodDecorator;
-    Around: (stage: "error" | "finalize" | "acquireQuota" | "acquireSemaphore" | "releaseSemaphore" | "releaseQuota" | "checkAuthorization" | "router" | "handleLegacySse" | "handleSse" | "handleStreamableHttp" | "handleStatefulHttp" | "handleStatelessHttp" | "audit" | "metrics", opts?: import("./common").HookOptions<import("./scope/flows/http.request.flow").default>) => MethodDecorator;
+    Stage: (stage: "finalize" | "acquireQuota" | "acquireSemaphore" | "releaseSemaphore" | "releaseQuota" | "traceRequest" | "checkAuthorization" | "router" | "handleLegacySse" | "handleSse" | "handleStreamableHttp" | "handleStatefulHttp" | "handleStatelessHttp" | "handleDeleteSession" | "audit" | "metrics", opts?: import("./common").HookOptions<import("./scope/flows/http.request.flow").default>) => MethodDecorator;
+    Will: (stage: "finalize" | "acquireQuota" | "acquireSemaphore" | "releaseSemaphore" | "releaseQuota" | "traceRequest" | "checkAuthorization" | "router" | "handleLegacySse" | "handleSse" | "handleStreamableHttp" | "handleStatefulHttp" | "handleStatelessHttp" | "handleDeleteSession" | "audit" | "metrics", opts?: import("./common").HookOptions<import("./scope/flows/http.request.flow").default>) => MethodDecorator;
+    Did: (stage: "finalize" | "acquireQuota" | "acquireSemaphore" | "releaseSemaphore" | "releaseQuota" | "traceRequest" | "checkAuthorization" | "router" | "handleLegacySse" | "handleSse" | "handleStreamableHttp" | "handleStatefulHttp" | "handleStatelessHttp" | "handleDeleteSession" | "audit" | "metrics", opts?: import("./common").HookOptions<import("./scope/flows/http.request.flow").default>) => MethodDecorator;
+    Around: (stage: "finalize" | "acquireQuota" | "acquireSemaphore" | "releaseSemaphore" | "releaseQuota" | "traceRequest" | "checkAuthorization" | "router" | "handleLegacySse" | "handleSse" | "handleStreamableHttp" | "handleStatefulHttp" | "handleStatelessHttp" | "handleDeleteSession" | "audit" | "metrics", opts?: import("./common").HookOptions<import("./scope/flows/http.request.flow").default>) => MethodDecorator;
+};
+export declare const ResourceHook: {
+    Stage: (stage: "execute" | "finalize" | "parseInput" | "validateOutput" | "findResource" | "createResourceContext", opts?: import("./common").HookOptions<import("./resource").ReadResourceFlow>) => MethodDecorator;
+    Will: (stage: "execute" | "finalize" | "parseInput" | "validateOutput" | "findResource" | "createResourceContext", opts?: import("./common").HookOptions<import("./resource").ReadResourceFlow>) => MethodDecorator;
+    Did: (stage: "execute" | "finalize" | "parseInput" | "validateOutput" | "findResource" | "createResourceContext", opts?: import("./common").HookOptions<import("./resource").ReadResourceFlow>) => MethodDecorator;
+    Around: (stage: "execute" | "finalize" | "parseInput" | "validateOutput" | "findResource" | "createResourceContext", opts?: import("./common").HookOptions<import("./resource").ReadResourceFlow>) => MethodDecorator;
+};
+export declare const ListResourcesHook: {
+    Stage: (stage: "parseInput" | "resolveConflicts" | "findResources" | "parseResources", opts?: import("./common").HookOptions<import("./resource").ResourcesListFlow>) => MethodDecorator;
+    Will: (stage: "parseInput" | "resolveConflicts" | "findResources" | "parseResources", opts?: import("./common").HookOptions<import("./resource").ResourcesListFlow>) => MethodDecorator;
+    Did: (stage: "parseInput" | "resolveConflicts" | "findResources" | "parseResources", opts?: import("./common").HookOptions<import("./resource").ResourcesListFlow>) => MethodDecorator;
+    Around: (stage: "parseInput" | "resolveConflicts" | "findResources" | "parseResources", opts?: import("./common").HookOptions<import("./resource").ResourcesListFlow>) => MethodDecorator;
+};
+export declare const ListResourceTemplatesHook: {
+    Stage: (stage: "parseInput" | "resolveConflicts" | "findTemplates" | "parseTemplates", opts?: import("./common").HookOptions<import("./resource").ResourceTemplatesListFlow>) => MethodDecorator;
+    Will: (stage: "parseInput" | "resolveConflicts" | "findTemplates" | "parseTemplates", opts?: import("./common").HookOptions<import("./resource").ResourceTemplatesListFlow>) => MethodDecorator;
+    Did: (stage: "parseInput" | "resolveConflicts" | "findTemplates" | "parseTemplates", opts?: import("./common").HookOptions<import("./resource").ResourceTemplatesListFlow>) => MethodDecorator;
+    Around: (stage: "parseInput" | "resolveConflicts" | "findTemplates" | "parseTemplates", opts?: import("./common").HookOptions<import("./resource").ResourceTemplatesListFlow>) => MethodDecorator;
 };

package/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpHook = exports.ListToolsHook = exports.ToolHook = exports.FrontMcpInstance = void 0;
+exports.ListResourceTemplatesHook = exports.ListResourcesHook = exports.ResourceHook = exports.HttpHook = exports.ListToolsHook = exports.ToolHook = exports.FrontMcpInstance = void 0;
 const tslib_1 = require("tslib");
 require("reflect-metadata");
 const common_1 = require("./common");
@@ -10,4 +10,8 @@ tslib_1.__exportStar(require("./common"), exports);
 exports.ToolHook = (0, common_1.FlowHooksOf)('tools:call-tool');
 exports.ListToolsHook = (0, common_1.FlowHooksOf)('tools:list-tools');
 exports.HttpHook = (0, common_1.FlowHooksOf)('http:request');
+// Resource hooks
+exports.ResourceHook = (0, common_1.FlowHooksOf)('resources:read-resource');
+exports.ListResourcesHook = (0, common_1.FlowHooksOf)('resources:list-resources');
+exports.ListResourceTemplatesHook = (0, common_1.FlowHooksOf)('resources:list-resource-templates');
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;AAAA,4BAA0B;AAC1B,qCAAqC;AAErC,yCAA6C;AAArC,6GAAA,gBAAgB,OAAA;AACxB,mDAAyB;AAGZ,QAAA,QAAQ,GAAG,IAAA,oBAAW,EAAC,iBAAiB,CAAC,CAAA;AACzC,QAAA,aAAa,GAAG,IAAA,oBAAW,EAAC,kBAAkB,CAAC,CAAA;AAC/C,QAAA,QAAQ,GAAG,IAAA,oBAAW,EAAC,cAAc,CAAC,CAAA","sourcesContent":["import 'reflect-metadata';\nimport {FlowHooksOf} from \"./common\";\n\nexport {FrontMcpInstance} from './front-mcp';\nexport * from \"./common\";\n\n\nexport const ToolHook = FlowHooksOf('tools:call-tool')\nexport const ListToolsHook = FlowHooksOf('tools:list-tools')\nexport const HttpHook = FlowHooksOf('http:request')\n\n\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;AAAA,4BAA0B;AAC1B,qCAAuC;AAEvC,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA;AACzB,mDAAyB;AAKZ,QAAA,QAAQ,GAAG,IAAA,oBAAW,EAAC,iBAAiB,CAAC,CAAC;AAC1C,QAAA,aAAa,GAAG,IAAA,oBAAW,EAAC,kBAAkB,CAAC,CAAC;AAChD,QAAA,QAAQ,GAAG,IAAA,oBAAW,EAAC,cAAc,CAAC,CAAC;AAEpD,iBAAiB;AACJ,QAAA,YAAY,GAAG,IAAA,oBAAW,EAAC,yBAAyB,CAAC,CAAC;AACtD,QAAA,iBAAiB,GAAG,IAAA,oBAAW,EAAC,0BAA0B,CAAC,CAAC;AAC5D,QAAA,yBAAyB,GAAG,IAAA,oBAAW,EAAC,mCAAmC,CAAC,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { FlowHooksOf } from './common';\n\nexport { FrontMcpInstance } from './front-mcp';\nexport * from './common';\n\n// Tool change events for subscription\nexport { ToolChangeEvent, ToolChangeKind, ToolChangeScope } from './tool/tool.events';\n\nexport const ToolHook = FlowHooksOf('tools:call-tool');\nexport const ListToolsHook = FlowHooksOf('tools:list-tools');\nexport const HttpHook = FlowHooksOf('http:request');\n\n// Resource hooks\nexport const ResourceHook = FlowHooksOf('resources:read-resource');\nexport const ListResourcesHook = FlowHooksOf('resources:list-resources');\nexport const ListResourceTemplatesHook = FlowHooksOf('resources:list-resource-templates');\n"]}

package/src/logger/instances/instance.logger.js

@@ -41,8 +41,9 @@ class LoggerInstance extends common_1.FrontMcpLogger {
             }
             catch (err) {
                 // Never throw from logging
+                // Use safe logging to avoid Node.js 24 util.inspect bug with Zod errors
                 // eslint-disable-next-line no-console
-                console.error('[Logger] Transport error:', err);
+                console.error('[Logger] Transport error:', err instanceof Error ? err.message : 'Unknown error');
             }
         }
     }
@@ -63,7 +64,7 @@ class LoggerInstance extends common_1.FrontMcpLogger {
     }
     _getter(level) {
         if (level < this.level || this.level === common_1.LogLevel.Off)
-            return (() => void 0);
+            return () => void 0;
         if (process.env['NODE_ENV'] === 'development' && this.config.enableConsole && this.consoleTransport) {
             return this.consoleTransport.bind(level, this.prefix);
         }

package/src/logger/instances/instance.logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"instance.logger.js","sourceRoot":"","sources":["../../../../src/logger/instances/instance.logger.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  FrontMcpLogger,\n  LogTransportInterface,\n  LogFn,\n  LoggingConfigType,\n  LogLevel, LogLevelName,\n  LogRecord,\n} from '../../common';\nimport { ConsoleLogTransportInstance } from './instance.console-logger';\n\nexport type GetTransports = () => {\n  consoleTransport?: ConsoleLogTransportInstance,\n  transports: LogTransportInterface[]\n};\n\nexport class LoggerInstance extends FrontMcpLogger {\n  private readonly level: LogLevel;\n  private readonly prefix: string;\n  private readonly transports: LogTransportInterface[];\n  private readonly consoleTransport?: ConsoleLogTransportInstance;\n\n  constructor(private readonly config: LoggingConfigType, private getTransports: GetTransports) {\n    super();\n    this.level = config.level;\n    this.prefix = config.prefix ?? '';\n\n    const { transports, consoleTransport } = getTransports();\n    this.transports = transports;\n    this.consoleTransport = consoleTransport;\n\n  }\n\n  child(prefix: string): FrontMcpLogger {\n    return new LoggerInstance({ ...this.config, prefix }, this.getTransports);\n  }\n\n  /** Internal: fan out to transports if level passes a threshold. */\n  private emit(level: LogLevel, message: string, args: unknown[]) {\n    if (level < this.level || this.level === LogLevel.Off) return;\n    const rec: LogRecord = {\n      level,\n      levelName: LogLevelName[level],\n      message,\n      args,\n      timestamp: new Date(),\n      prefix: this.prefix,\n    };\n    for (const t of this.transports) {\n      try {\n        // Fire-and-forget; transports may be async\n        void t.log(rec);\n      } catch (err) {\n        // Never throw from logging\n        // eslint-disable-next-line no-console\n        console.error('[Logger] Transport error:', err);\n      }\n    }\n  }\n\n  get verbose(): LogFn {\n    return this._getter(LogLevel.VERBOSE);\n  }\n\n  get debug(): LogFn {\n    return this._getter(LogLevel.Debug);\n  }\n\n  get info(): LogFn {\n    return this._getter(LogLevel.Info);\n  }\n\n  get warn(): LogFn {\n    return this._getter(LogLevel.Warn);\n  }\n\n  get error(): LogFn {\n    return this._getter(LogLevel.Error);\n  }\n\n  private _getter(level: LogLevel): LogFn {\n    if (level < this.level || this.level === LogLevel.Off) return (() => void 0);\n    if (process.env['NODE_ENV'] === 'development' && this.config.enableConsole && this.consoleTransport) {\n      return this.consoleTransport.bind(level, this.prefix);\n    }\n    const emit = this.emit.bind(this);\n    return function(...args: unknown[]) {\n      emit(level, String(args[0]), Array.prototype.slice.call(args, 1));\n    };\n  }\n\n}"]}
+{"version":3,"file":"instance.logger.js","sourceRoot":"","sources":["../../../../src/logger/instances/instance.logger.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  FrontMcpLogger,\n  LogTransportInterface,\n  LogFn,\n  LoggingConfigType,\n  LogLevel,\n  LogLevelName,\n  LogRecord,\n} from '../../common';\nimport { ConsoleLogTransportInstance } from './instance.console-logger';\n\nexport type GetTransports = () => {\n  consoleTransport?: ConsoleLogTransportInstance;\n  transports: LogTransportInterface[];\n};\n\nexport class LoggerInstance extends FrontMcpLogger {\n  private readonly level: LogLevel;\n  private readonly prefix: string;\n  private readonly transports: LogTransportInterface[];\n  private readonly consoleTransport?: ConsoleLogTransportInstance;\n\n  constructor(private readonly config: LoggingConfigType, private getTransports: GetTransports) {\n    super();\n    this.level = config.level;\n    this.prefix = config.prefix ?? '';\n\n    const { transports, consoleTransport } = getTransports();\n    this.transports = transports;\n    this.consoleTransport = consoleTransport;\n  }\n\n  child(prefix: string): FrontMcpLogger {\n    return new LoggerInstance({ ...this.config, prefix }, this.getTransports);\n  }\n\n  /** Internal: fan out to transports if level passes a threshold. */\n  private emit(level: LogLevel, message: string, args: unknown[]) {\n    if (level < this.level || this.level === LogLevel.Off) return;\n    const rec: LogRecord = {\n      level,\n      levelName: LogLevelName[level],\n      message,\n      args,\n      timestamp: new Date(),\n      prefix: this.prefix,\n    };\n    for (const t of this.transports) {\n      try {\n        // Fire-and-forget; transports may be async\n        void t.log(rec);\n      } catch (err) {\n        // Never throw from logging\n        // Use safe logging to avoid Node.js 24 util.inspect bug with Zod errors\n        // eslint-disable-next-line no-console\n        console.error('[Logger] Transport error:', err instanceof Error ? err.message : 'Unknown error');\n      }\n    }\n  }\n\n  get verbose(): LogFn {\n    return this._getter(LogLevel.VERBOSE);\n  }\n\n  get debug(): LogFn {\n    return this._getter(LogLevel.Debug);\n  }\n\n  get info(): LogFn {\n    return this._getter(LogLevel.Info);\n  }\n\n  get warn(): LogFn {\n    return this._getter(LogLevel.Warn);\n  }\n\n  get error(): LogFn {\n    return this._getter(LogLevel.Error);\n  }\n\n  private _getter(level: LogLevel): LogFn {\n    if (level < this.level || this.level === LogLevel.Off) return () => void 0;\n    if (process.env['NODE_ENV'] === 'development' && this.config.enableConsole && this.consoleTransport) {\n      return this.consoleTransport.bind(level, this.prefix);\n    }\n    const emit = this.emit.bind(this);\n    return function (...args: unknown[]) {\n      emit(level, String(args[0]), Array.prototype.slice.call(args, 1));\n    };\n  }\n}\n"]}

package/src/logger/logger.registry.js

@@ -13,8 +13,13 @@ class LoggerRegistry extends regsitry_1.RegistryAbstract {
     config;
     constructor(globalProviders) {
         const { logging } = globalProviders.get(front_mcp_tokens_1.FrontMcpConfig);
-        const { transports, ...config } = logging;
-        const list = transports ?? [];
+        const loggingConfig = logging ?? {
+            level: common_1.LogLevel.Info,
+            enableConsole: true,
+            transports: [],
+        };
+        const { transports, ...config } = loggingConfig;
+        const list = [...(transports ?? [])];
         if (config.enableConsole) {
             list.push(instance_console_logger_1.ConsoleLogTransportInstance);
         }

package/src/logger/logger.registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.registry.js","sourceRoot":"","sources":["../../../src/logger/logger.registry.ts"],"names":[],"mappings":";;AAAA,4BAA0B;AAC1B,sCAOmB;AACnB,0CAAuE;AAEvE,iDAA0D;AAC1D,iDAAsE;AACtE,oEAA+D;AAC/D,iFAAkF;AAClF,sDAAiD;AACjD,iEAA4E;AAE5E,MAAqB,cAAe,SAAQ,2BAAyE;IACnH,MAAM,CAAoB;IAE1B,YAAY,eAAiC;QAC3C,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,GAAG,CAAC,iCAAc,CAAC,CAAC;QACxD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;QAC1C,MAAM,IAAI,GAAG,UAAU,IAAI,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,qDAA2B,CAAC,CAAC;QACzC,CAAC;QAED,KAAK,CAAC,gBAAgB,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;QAE/C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAES,UAAU;QAClB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;YAClC,MAAM,IAAI,GAAG,IAAA,kCAAmB,EAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC/C,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3B,MAAM,IAAI,KAAK,CAAC,UAAU,IAAA,uBAAS,EAAC,KAAK,CAAC,eAAe,IAAA,uBAAS,EAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC;gBACrG,CAAC;gBACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAEkB,QAAQ,CAAC,IAAwB;QAClD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAS,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;QAG3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,IAAA,8BAAe,EAAC,GAAG,CAAC,CAAC;YACjC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACvB,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAChC,CAAC;QAED,OAAO;YACL,MAAM;YACN,IAAI;YACJ,KAAK;SACN,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,UAAU;QAExB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;YAClC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;YAEpC,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;YAC7B,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAEtG,IAAI,GAA0B,CAAC;YAC/B,IAAI,GAAG,CAAC,IAAI,KAAK,yBAAU,CAAC,WAAW,EAAE,CAAC;gBACxC,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC;gBAClC,GAAG,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,aAAa,CAAC,CAAC;YACzD,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACrC,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAES,UAAU;QAElB,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,qDAA2B,CAAgC,CAAC;QACxG,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QAChD,MAAM,aAAa,GAAkB,GAAG,EAAE;YACxC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC;QAC1C,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,gCAAc,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAE9D,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC;YAC5B,OAAO,EAAE,uBAAc;YACvB,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE;gBACR,EAAE,EAAE,iBAAiB;gBACrB,IAAI,EAAE,gBAAgB;gBACtB,KAAK,EAAE,sBAAa,CAAC,MAAM;gBAC3B,WAAW,EAAE,qEAAqE;aACnF;SACF,CAAC,CAAC;IACL,CAAC;CAEF;AA7FD,iCA6FC","sourcesContent":["import 'reflect-metadata';\nimport {\n  FrontMcpLogger,\n  LogTransportType,\n  LogTransportInterface,\n  LoggingConfigType,\n  ProviderScope,\n  Token,\n} from '../common';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { LoggerKind, LoggerRecord } from './logger.types';\nimport { loggerDiscoveryDeps, normalizeLogger } from './logger.utils';\nimport { FrontMcpConfig } from '../front-mcp/front-mcp.tokens';\nimport { ConsoleLogTransportInstance } from './instances/instance.console-logger';\nimport { tokenName } from '../utils/token.utils';\nimport { GetTransports, LoggerInstance } from './instances/instance.logger';\n\nexport default class LoggerRegistry extends RegistryAbstract<LogTransportInterface, LoggerRecord, LogTransportType[]> {\n  config: LoggingConfigType;\n\n  constructor(globalProviders: ProviderRegistry) {\n    const { logging } = globalProviders.get(FrontMcpConfig);\n    const { transports, ...config } = logging;\n    const list = transports ?? [];\n    if (config.enableConsole) {\n      list.push(ConsoleLogTransportInstance);\n    }\n\n    super('LoggerRegistry', globalProviders, list);\n\n    this.config = config;\n  }\n\n  protected buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = loggerDiscoveryDeps(rec).slice(1);\n      for (const d of deps) {\n        if (!this.providers.get(d)) {\n          throw new Error(`Logger ${tokenName(token)} depends on ${tokenName(d)}, which is not registered.`);\n        }\n        this.graph.get(token)!.add(d);\n      }\n    }\n  }\n\n  protected override buildMap(list: LogTransportType[]): RegistryBuildMapResult<LoggerRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, LoggerRecord>();\n    const graph = new Map<Token, Set<Token>>();\n\n\n    for (const raw of list) {\n      const rec = normalizeLogger(raw);\n      const provide = rec.provide;\n      tokens.add(provide);\n      defs.set(provide, rec);\n      graph.set(provide, new Set());\n    }\n\n    return {\n      tokens,\n      defs,\n      graph,\n    };\n  }\n\n  protected async initialize(): Promise<void> {\n\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = this.graph.get(token)!;\n\n      const depsTokens = [...deps];\n      const depsInstances = await Promise.all(depsTokens.map((t) => this.providers.resolveBootstrapDep(t)));\n\n      let app: LogTransportInterface;\n      if (rec.kind === LoggerKind.CLASS_TOKEN) {\n        const LocalAppClass = rec.provide;\n        app = new LocalAppClass(this.config, ...depsInstances);\n      } else {\n        throw Error('Invalid logger kind');\n      }\n\n      this.instances.set(token, app);\n    }\n    this.bindLogger();\n  }\n\n  protected bindLogger() {\n\n    const consoleTransport = this.instances.get(ConsoleLogTransportInstance) as ConsoleLogTransportInstance;\n    const transports = [...this.instances.values()];\n    const getTransports: GetTransports = () => {\n      return { consoleTransport, transports };\n    };\n    const logger = new LoggerInstance(this.config, getTransports);\n\n    this.providers.injectProvider({\n      provide: FrontMcpLogger,\n      value: logger,\n      metadata: {\n        id: 'frontmcp-logger',\n        name: 'FrontMcpLogger',\n        scope: ProviderScope.GLOBAL,\n        description: 'Logger instance that transport logs to all registered transporters.',\n      },\n    });\n  }\n\n}\n"]}
+{"version":3,"file":"logger.registry.js","sourceRoot":"","sources":["../../../src/logger/logger.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import 'reflect-metadata';\nimport {\n  FrontMcpLogger,\n  LogLevel,\n  LogTransportType,\n  LogTransportInterface,\n  LoggingConfigType,\n  ProviderScope,\n  Token,\n} from '../common';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { LoggerKind, LoggerRecord } from './logger.types';\nimport { loggerDiscoveryDeps, normalizeLogger } from './logger.utils';\nimport { FrontMcpConfig } from '../front-mcp/front-mcp.tokens';\nimport { ConsoleLogTransportInstance } from './instances/instance.console-logger';\nimport { tokenName } from '../utils/token.utils';\nimport { GetTransports, LoggerInstance } from './instances/instance.logger';\n\nexport default class LoggerRegistry extends RegistryAbstract<LogTransportInterface, LoggerRecord, LogTransportType[]> {\n  config: LoggingConfigType;\n\n  constructor(globalProviders: ProviderRegistry) {\n    const { logging } = globalProviders.get(FrontMcpConfig);\n    const loggingConfig = logging ?? {\n      level: LogLevel.Info,\n      enableConsole: true,\n      transports: [] as LogTransportType[],\n    };\n    const { transports, ...config } = loggingConfig;\n    const list: LogTransportType[] = [...(transports ?? [])];\n    if (config.enableConsole) {\n      list.push(ConsoleLogTransportInstance);\n    }\n\n    super('LoggerRegistry', globalProviders, list);\n\n    this.config = config;\n  }\n\n  protected buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = loggerDiscoveryDeps(rec).slice(1);\n      for (const d of deps) {\n        if (!this.providers.get(d)) {\n          throw new Error(`Logger ${tokenName(token)} depends on ${tokenName(d)}, which is not registered.`);\n        }\n        this.graph.get(token)!.add(d);\n      }\n    }\n  }\n\n  protected override buildMap(list: LogTransportType[]): RegistryBuildMapResult<LoggerRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, LoggerRecord>();\n    const graph = new Map<Token, Set<Token>>();\n\n    for (const raw of list) {\n      const rec = normalizeLogger(raw);\n      const provide = rec.provide;\n      tokens.add(provide);\n      defs.set(provide, rec);\n      graph.set(provide, new Set());\n    }\n\n    return {\n      tokens,\n      defs,\n      graph,\n    };\n  }\n\n  protected async initialize(): Promise<void> {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = this.graph.get(token)!;\n\n      const depsTokens = [...deps];\n      const depsInstances = await Promise.all(depsTokens.map((t) => this.providers.resolveBootstrapDep(t)));\n\n      let app: LogTransportInterface;\n      if (rec.kind === LoggerKind.CLASS_TOKEN) {\n        const LocalAppClass = rec.provide;\n        app = new LocalAppClass(this.config, ...depsInstances);\n      } else {\n        throw Error('Invalid logger kind');\n      }\n\n      this.instances.set(token, app);\n    }\n    this.bindLogger();\n  }\n\n  protected bindLogger() {\n    const consoleTransport = this.instances.get(ConsoleLogTransportInstance) as ConsoleLogTransportInstance;\n    const transports = [...this.instances.values()];\n    const getTransports: GetTransports = () => {\n      return { consoleTransport, transports };\n    };\n    const logger = new LoggerInstance(this.config, getTransports);\n\n    this.providers.injectProvider({\n      provide: FrontMcpLogger,\n      value: logger,\n      metadata: {\n        id: 'frontmcp-logger',\n        name: 'FrontMcpLogger',\n        scope: ProviderScope.GLOBAL,\n        description: 'Logger instance that transport logs to all registered transporters.',\n      },\n    });\n  }\n}\n"]}

package/src/logging/flows/set-level.flow.d.ts

@@ -0,0 +1,62 @@
+import { FlowBase, FlowRunOptions } from '../../common';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    request: z.ZodObject<{
+        method: z.ZodLiteral<"logging/setLevel">;
+        params: z.ZodObject<{
+            _meta: z.ZodOptional<z.ZodObject<{
+                progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            }, z.core.$loose>>;
+            level: z.ZodEnum<{
+                error: "error";
+                debug: "debug";
+                info: "info";
+                notice: "notice";
+                warning: "warning";
+                critical: "critical";
+                alert: "alert";
+                emergency: "emergency";
+            }>;
+        }, z.core.$loose>;
+    }, z.core.$strip>;
+    ctx: z.ZodUnknown;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+declare const stateSchema: z.ZodObject<{
+    input: z.ZodObject<{
+        level: z.ZodEnum<{
+            error: "error";
+            debug: "debug";
+            info: "info";
+            notice: "notice";
+            warning: "warning";
+            critical: "critical";
+            alert: "alert";
+            emergency: "emergency";
+        }>;
+    }, z.core.$strip>;
+    sessionId: z.ZodString;
+    output: z.ZodObject<{
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+declare const plan: {
+    readonly pre: ["parseInput"];
+    readonly execute: ["setLevel"];
+    readonly finalize: ["finalize"];
+};
+declare global {
+    interface ExtendFlows {
+        'logging:set-level': FlowRunOptions<SetLevelFlow, typeof plan, typeof inputSchema, typeof outputSchema, typeof stateSchema>;
+    }
+}
+declare const name: "logging:set-level";
+export default class SetLevelFlow extends FlowBase<typeof name> {
+    logger: import("../../common").FrontMcpLogger;
+    parseInput(): Promise<void>;
+    setLevel(): Promise<void>;
+    finalize(): Promise<void>;
+}
+export {};

package/src/logging/flows/set-level.flow.js

@@ -0,0 +1,108 @@
+"use strict";
+// file: libs/sdk/src/logging/flows/set-level.flow.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const common_1 = require("../../common");
+const zod_1 = require("zod");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const errors_1 = require("../../errors");
+const inputSchema = zod_1.z.object({
+    request: types_js_1.SetLevelRequestSchema,
+    ctx: zod_1.z.unknown(),
+});
+const outputSchema = types_js_1.EmptyResultSchema;
+const stateSchema = zod_1.z.object({
+    input: zod_1.z.object({
+        level: types_js_1.LoggingLevelSchema,
+    }),
+    sessionId: zod_1.z.string(),
+    output: outputSchema,
+});
+const plan = {
+    pre: ['parseInput'],
+    execute: ['setLevel'],
+    finalize: ['finalize'],
+};
+const name = 'logging:set-level';
+const { Stage } = (0, common_1.FlowHooksOf)(name);
+let SetLevelFlow = class SetLevelFlow extends common_1.FlowBase {
+    logger = this.scopeLogger.child('SetLevelFlow');
+    async parseInput() {
+        this.logger.verbose('parseInput:start');
+        let method;
+        let params;
+        let ctx;
+        try {
+            const inputData = inputSchema.parse(this.rawInput);
+            method = inputData.request.method;
+            params = inputData.request.params;
+            ctx = inputData.ctx;
+        }
+        catch (e) {
+            throw new errors_1.InvalidInputError('Invalid Input', e instanceof zod_1.z.ZodError ? e.issues : undefined);
+        }
+        if (method !== 'logging/setLevel') {
+            this.logger.warn(`parseInput: invalid method "${method}"`);
+            throw new errors_1.InvalidMethodError(method, 'logging/setLevel');
+        }
+        // Get session ID from context - required for logging level tracking
+        const sessionId = ctx?.['sessionId'];
+        if (!sessionId || typeof sessionId !== 'string') {
+            this.logger.warn('parseInput: sessionId not found in context');
+            throw new errors_1.InvalidInputError('Session ID is required for setting log level');
+        }
+        this.state.set({ input: params, sessionId });
+        this.logger.verbose('parseInput:done');
+    }
+    async setLevel() {
+        this.logger.verbose('setLevel:start');
+        const { level } = this.state.required.input;
+        const { sessionId } = this.state.required;
+        // Set the log level for this session via NotificationService
+        const success = this.scope.notifications.setLogLevel(sessionId, level);
+        if (success) {
+            this.logger.info(`setLevel: session log level set to "${level}"`);
+        }
+        else {
+            // Per MCP spec, return Internal error (-32603) when operation fails
+            this.logger.warn(`setLevel: failed to set log level for session (session not registered?)`);
+            throw new errors_1.GenericServerError('Failed to set log level: session not registered');
+        }
+        this.logger.verbose('setLevel:done');
+    }
+    async finalize() {
+        this.logger.verbose('finalize:start');
+        // Per MCP spec, logging/setLevel returns an empty result on success
+        this.respond({});
+        this.logger.verbose('finalize:done');
+    }
+};
+tslib_1.__decorate([
+    Stage('parseInput'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], SetLevelFlow.prototype, "parseInput", null);
+tslib_1.__decorate([
+    Stage('setLevel'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], SetLevelFlow.prototype, "setLevel", null);
+tslib_1.__decorate([
+    Stage('finalize'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], SetLevelFlow.prototype, "finalize", null);
+SetLevelFlow = tslib_1.__decorate([
+    (0, common_1.Flow)({
+        name,
+        plan,
+        inputSchema,
+        outputSchema,
+        access: 'authorized',
+    })
+], SetLevelFlow);
+exports.default = SetLevelFlow;
+//# sourceMappingURL=set-level.flow.js.map

package/src/logging/flows/set-level.flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-level.flow.js","sourceRoot":"","sources":["../../../../src/logging/flows/set-level.flow.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/logging/flows/set-level.flow.ts\n\nimport { Flow, FlowBase, FlowHooksOf, FlowPlan, FlowRunOptions } from '../../common';\nimport { z } from 'zod';\nimport { SetLevelRequestSchema, EmptyResultSchema, LoggingLevelSchema } from '@modelcontextprotocol/sdk/types.js';\nimport { InvalidMethodError, InvalidInputError, GenericServerError } from '../../errors';\n\nconst inputSchema = z.object({\n  request: SetLevelRequestSchema,\n  ctx: z.unknown(),\n});\n\nconst outputSchema = EmptyResultSchema;\n\nconst stateSchema = z.object({\n  input: z.object({\n    level: LoggingLevelSchema,\n  }),\n  sessionId: z.string(),\n  output: outputSchema,\n});\n\nconst plan = {\n  pre: ['parseInput'],\n  execute: ['setLevel'],\n  finalize: ['finalize'],\n} as const satisfies FlowPlan<string>;\n\ndeclare global {\n  interface ExtendFlows {\n    'logging:set-level': FlowRunOptions<\n      SetLevelFlow,\n      typeof plan,\n      typeof inputSchema,\n      typeof outputSchema,\n      typeof stateSchema\n    >;\n  }\n}\n\nconst name = 'logging:set-level' as const;\nconst { Stage } = FlowHooksOf<'logging:set-level'>(name);\n\n@Flow({\n  name,\n  plan,\n  inputSchema,\n  outputSchema,\n  access: 'authorized',\n})\nexport default class SetLevelFlow extends FlowBase<typeof name> {\n  logger = this.scopeLogger.child('SetLevelFlow');\n\n  @Stage('parseInput')\n  async parseInput() {\n    this.logger.verbose('parseInput:start');\n\n    let method!: string;\n    let params: z.infer<typeof SetLevelRequestSchema>['params'];\n    let ctx: unknown;\n    try {\n      const inputData = inputSchema.parse(this.rawInput);\n      method = inputData.request.method;\n      params = inputData.request.params;\n      ctx = inputData.ctx;\n    } catch (e) {\n      throw new InvalidInputError('Invalid Input', e instanceof z.ZodError ? e.issues : undefined);\n    }\n\n    if (method !== 'logging/setLevel') {\n      this.logger.warn(`parseInput: invalid method \"${method}\"`);\n      throw new InvalidMethodError(method, 'logging/setLevel');\n    }\n\n    // Get session ID from context - required for logging level tracking\n    const sessionId = (ctx as Record<string, unknown> | undefined)?.['sessionId'];\n    if (!sessionId || typeof sessionId !== 'string') {\n      this.logger.warn('parseInput: sessionId not found in context');\n      throw new InvalidInputError('Session ID is required for setting log level');\n    }\n\n    this.state.set({ input: params, sessionId });\n    this.logger.verbose('parseInput:done');\n  }\n\n  @Stage('setLevel')\n  async setLevel() {\n    this.logger.verbose('setLevel:start');\n    const { level } = this.state.required.input;\n    const { sessionId } = this.state.required;\n\n    // Set the log level for this session via NotificationService\n    const success = this.scope.notifications.setLogLevel(sessionId, level);\n\n    if (success) {\n      this.logger.info(`setLevel: session log level set to \"${level}\"`);\n    } else {\n      // Per MCP spec, return Internal error (-32603) when operation fails\n      this.logger.warn(`setLevel: failed to set log level for session (session not registered?)`);\n      throw new GenericServerError('Failed to set log level: session not registered');\n    }\n\n    this.logger.verbose('setLevel:done');\n  }\n\n  @Stage('finalize')\n  async finalize() {\n    this.logger.verbose('finalize:start');\n    // Per MCP spec, logging/setLevel returns an empty result on success\n    this.respond({});\n    this.logger.verbose('finalize:done');\n  }\n}\n"]}