@frontmcp/sdk 0.5.0 → 0.6.0

package/src/flows/flow.instance.d.ts

@@ -12,5 +12,21 @@ export declare class FlowInstance<Name extends FlowName> extends FlowEntry<Name>
     constructor(scope: Scope, record: FlowRecord, deps: Set<Reference>, globalProviders: ProviderRegistry);
     protected initialize(): Promise<void>;
     canActivate(request: ServerRequest): Promise<boolean>;
+    /**
+     * Get FrontMcpContextStorage from providers (with fallback).
+     * Returns undefined if not available (backward compatibility).
+     */
+    private getContextStorage;
+    /**
+     * Run flow wrapped in FrontMcpContext.
+     * This ensures ALL stages have access to the context via AsyncLocalStorage.
+     *
+     * @param storage - FrontMcpContextStorage instance
+     * @param request - The HTTP request
+     * @param input - Flow input
+     * @param deps - Flow dependencies
+     * @returns Flow output or undefined
+     */
+    private runWithContext;
     run(input: FlowInputOf<Name>, deps: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>;
 }

package/src/flows/flow.instance.js

@@ -7,6 +7,9 @@ require("reflect-metadata");
 const common_1 = require("../common");
 const flow_stages_1 = require("./flow.stages");
 const server_validation_1 = require("../server/server.validation");
+const context_1 = require("../context");
+const mcp_error_1 = require("../errors/mcp.error");
+const crypto_1 = require("crypto");
 const CAP = (s) => (s ? s[0].toUpperCase() + s.slice(1) : s);
 const WILL = (s) => `will${CAP(s)}`;
 const DID = (s) => `did${CAP(s)}`;
@@ -47,8 +50,12 @@ class FlowInstance extends common_1.FlowEntry {
                 const canActivate = await this.canActivate(request);
                 if (!canActivate)
                     return next();
+                // Get context storage to wrap entire flow in FrontMcpContext
+                const contextStorage = this.getContextStorage();
                 try {
-                    const result = await this.run({ request, response, next }, new Map());
+                    // Use runWithContext to wrap entire flow execution in AsyncLocalStorage context
+                    // This ensures all stages have access to FrontMcpContext
+                    const result = await this.runWithContext(contextStorage, request, { request, response, next }, new Map());
                     if (result)
                         return (0, server_validation_1.writeHttpResponse)(response, result);
                 }
@@ -67,8 +74,12 @@ class FlowInstance extends common_1.FlowEntry {
                                 return (0, server_validation_1.writeHttpResponse)(response, e.output);
                         }
                     }
-                    // Skip console.error due to Node.js 24 util.inspect bug with Zod validation errors
-                    // The error will be returned to the client as a 500 response
+                    // Log unhandled errors for visibility (non-FlowControl errors indicate bugs)
+                    // Note: Using structured logging to avoid Node.js util.inspect issues with Zod errors
+                    console.error('[FlowInstance] Unhandled error:', {
+                        name: e instanceof Error ? e.name : 'UnknownError',
+                        message: e instanceof Error ? e.message : String(e),
+                    });
                     return (0, server_validation_1.writeHttpResponse)(response, {
                         kind: 'text',
                         status: 500,
@@ -92,18 +103,82 @@ class FlowInstance extends common_1.FlowEntry {
         const results = await Promise.all(canActivate.map((m) => m(request, this.scope)));
         return results.every((r) => r);
     }
+    /**
+     * Get FrontMcpContextStorage from providers (with fallback).
+     * Returns undefined if not available (backward compatibility).
+     */
+    getContextStorage() {
+        try {
+            return this.globalProviders.get(context_1.FrontMcpContextStorage);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Run flow wrapped in FrontMcpContext.
+     * This ensures ALL stages have access to the context via AsyncLocalStorage.
+     *
+     * @param storage - FrontMcpContextStorage instance
+     * @param request - The HTTP request
+     * @param input - Flow input
+     * @param deps - Flow dependencies
+     * @returns Flow output or undefined
+     */
+    async runWithContext(storage, request, input, deps) {
+        // If no storage available, run without context (backward compatibility)
+        if (!storage) {
+            return this.run(input, deps);
+        }
+        // Extract context parameters from request
+        const headers = (request.headers ?? {});
+        // Generate unique ID for anonymous sessions to prevent session collision
+        // All unauthenticated requests previously shared 'anonymous', causing data leakage
+        // Handle empty strings explicitly: '' ?? 'fallback' returns '', not 'fallback'
+        const headerSessionId = typeof headers['mcp-session-id'] === 'string' ? headers['mcp-session-id'].trim() : '';
+        const sessionId = headerSessionId.length > 0 ? headerSessionId : `anon:${(0, crypto_1.randomUUID)()}`;
+        const scope = this.globalProviders.getActiveScope();
+        // Wrap ENTIRE flow execution in AsyncLocalStorage context
+        return storage.runFromHeaders(headers, {
+            sessionId,
+            scopeId: scope.id,
+        }, async () => {
+            return this.run(input, deps);
+        });
+    }
     async run(input, deps) {
         const scope = this.globalProviders.getActiveScope();
         const { FlowClass, plan, name } = this;
+        // Build provider views for scoped DI
+        // This enables CONTEXT scoped providers to be resolved
+        const contextStorage = this.getContextStorage();
+        const currentContext = contextStorage?.getStore();
+        // Get session ID from context - should always be available since runWithContext wraps the entire flow
+        // If unavailable, it indicates a bug in context propagation (not a normal case)
+        const sessionKey = currentContext?.sessionId;
+        if (!sessionKey) {
+            // This should never happen since runWithContext wraps the entire flow execution
+            // If we reach here, there's a bug in context propagation
+            throw new mcp_error_1.RequestContextNotAvailableError('FrontMcpContext unavailable - session ID required for provider resolution. Ensure flow is wrapped with runWithContext.');
+        }
+        // Build views with current context if available
+        const views = await this.globalProviders.buildViews(sessionKey, currentContext ? new Map([[context_1.FRONTMCP_CONTEXT, currentContext]]) : undefined);
+        // Merge context-scoped providers into deps for resolution by FlowClass
+        const mergedDeps = new Map(deps);
+        for (const [token, instance] of views.context) {
+            mergedDeps.set(token, instance);
+        }
         // Clone stages so we can merge injections safely per run.
         const baseStages = this.stages;
-        let stages = (0, flow_stages_1.cloneStageMap)(baseStages);
+        const stages = (0, flow_stages_1.cloneStageMap)(baseStages);
         // Compute next order base after any class-defined entries.
         let orderBase = Math.max(0, ...Object.values(stages).flatMap((list) => list.map((e) => e._order ?? 0))) + 1;
         // Get tool owner ID if this is a tool call flow
         // The tool owner ID is set by the CallToolFlow.findTool stage
         const toolOwnerId = input?._toolOwnerId;
         const initialInjectedHooks = this.hooks.getFlowHooksForOwner(name, toolOwnerId) ?? [];
+        // FlowClass generic type is erased at runtime, so we use FlowBase<any>
+        // to avoid complex type gymnastics while maintaining basic type safety
         let context;
         let contextReady = false;
         const materializeAndMerge = async (newHooks, opts) => {
@@ -116,7 +191,6 @@ class FlowInstance extends common_1.FlowEntry {
                 }
                 catch (e) {
                     // Use safe logging to avoid Node.js 24 util.inspect bug with Zod errors
-                    // eslint-disable-next-line no-console
                     console.warn('[flow] Ignoring injected hook that failed to materialize:', e instanceof Error ? e.message : 'Unknown error');
                 }
             }
@@ -130,8 +204,9 @@ class FlowInstance extends common_1.FlowEntry {
         const appendContextHooks = async (hooks) => {
             await materializeAndMerge(hooks);
         };
-        // Construct flow instance
-        context = new FlowClass(this.metadata, input, scope, appendContextHooks, deps);
+        // Construct flow instance with merged dependencies (includes scoped providers)
+        // eslint-disable-next-line prefer-const -- declaration must precede helper functions that close over context
+        context = new FlowClass(this.metadata, input, scope, appendContextHooks, mergedDeps);
         // Now injections can materialize
         contextReady = true;
         // Initial registry hooks should not pre-empt stages; they just get registered
@@ -237,97 +312,108 @@ class FlowInstance extends common_1.FlowEntry {
         const runErrorStage = async () => {
             await runStageGroup(plan.error, false, { ignoreRespond: true });
         };
-        const runFinalizeStage = async () => {
-            await runStageGroup(plan.finalize, false);
-        };
-        try {
-            // ---------- PRE ----------
-            {
-                const pre = await runStageGroup(plan.pre, true);
-                if (pre.outcome === 'respond') {
-                    const post = await runStageGroup(plan.post, false);
-                    if (post.outcome === 'unknown_error' || post.outcome === 'fail') {
-                        try {
-                            await runErrorStage();
-                        }
-                        finally {
-                            await runFinalizeStage();
-                        }
-                        if (post.outcome === 'fail')
-                            throw post.control;
-                        throw post.control;
-                    }
-                    if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {
-                        await runFinalizeStage();
-                        throw post.control;
-                    }
-                    await runFinalizeStage();
-                    return responded;
+        const runFinalizeStage = async (options) => {
+            const res = await runStageGroup(plan.finalize, false);
+            // Handle finalize stage errors
+            if (res.outcome === 'unknown_error' || res.outcome === 'fail') {
+                const finalizeError = res.control ?? new mcp_error_1.InternalMcpError('Finalize stage failed');
+                if (options?.suppressErrors) {
+                    // Log finalizes errors but doesn't throw when called from finally blocks
+                    // This prevents masking the original error
+                    this.scope.logger.error('[FrontMCP] Finalize stage error (suppressed to preserve original error):', finalizeError);
+                    return res;
                 }
-                if (pre.outcome === 'unknown_error' || pre.outcome === 'fail') {
+                throw finalizeError;
+            }
+            return res;
+        };
+        // ---------- PRE ----------
+        {
+            const pre = await runStageGroup(plan.pre, true);
+            if (pre.outcome === 'respond') {
+                const post = await runStageGroup(plan.post, false);
+                if (post.outcome === 'unknown_error' || post.outcome === 'fail') {
                     try {
                         await runErrorStage();
                     }
                     finally {
-                        await runFinalizeStage();
+                        await runFinalizeStage({ suppressErrors: true });
                     }
-                    if (pre.outcome === 'fail')
-                        throw pre.control;
-                    throw pre.control;
+                    throw post.control ?? new mcp_error_1.InternalMcpError('Missing control for fail/error outcome');
                 }
-                if (pre.outcome === 'abort' || pre.outcome === 'next' || pre.outcome === 'handled') {
-                    await runFinalizeStage();
-                    throw pre.control;
+                if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {
+                    await runFinalizeStage({ suppressErrors: true });
+                    if (!(post.control instanceof common_1.FlowControl)) {
+                        throw new mcp_error_1.InternalMcpError('Expected FlowControl but received different error type');
+                    }
+                    throw post.control;
                 }
+                await runFinalizeStage();
+                return responded;
             }
-            // ---------- EXECUTE ----------
-            if (!responded) {
-                const exec = await runStageGroup(plan.execute, true);
-                if (exec.outcome === 'respond') {
-                    // continue to post + finalize
+            if (pre.outcome === 'unknown_error' || pre.outcome === 'fail') {
+                try {
+                    await runErrorStage();
                 }
-                else if (exec.outcome === 'unknown_error' || exec.outcome === 'fail') {
-                    try {
-                        await runErrorStage();
-                    }
-                    finally {
-                        await runFinalizeStage();
-                    }
-                    if (exec.outcome === 'fail')
-                        throw exec.control;
-                    throw exec.control;
+                finally {
+                    await runFinalizeStage({ suppressErrors: true });
                 }
-                else if (exec.outcome === 'abort' || exec.outcome === 'next' || exec.outcome === 'handled') {
-                    await runFinalizeStage();
-                    throw exec.control;
+                throw pre.control ?? new mcp_error_1.InternalMcpError('Missing control for fail/error outcome');
+            }
+            if (pre.outcome === 'abort' || pre.outcome === 'next' || pre.outcome === 'handled') {
+                await runFinalizeStage({ suppressErrors: true });
+                if (!(pre.control instanceof common_1.FlowControl)) {
+                    throw new mcp_error_1.InternalMcpError('Expected FlowControl but received different error type');
                 }
+                throw pre.control;
             }
-            // ---------- POST ----------
-            {
-                const post = await runStageGroup(plan.post, false);
-                if (post.outcome === 'unknown_error' || post.outcome === 'fail') {
-                    try {
-                        await runErrorStage();
-                    }
-                    finally {
-                        await runFinalizeStage();
-                    }
-                    if (post.outcome === 'fail')
-                        throw post.control;
-                    throw post.control;
+        }
+        // ---------- EXECUTE ----------
+        if (!responded) {
+            const exec = await runStageGroup(plan.execute, true);
+            if (exec.outcome === 'respond') {
+                // continue to post + finalize
+            }
+            else if (exec.outcome === 'unknown_error' || exec.outcome === 'fail') {
+                try {
+                    await runErrorStage();
                 }
-                if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {
-                    await runFinalizeStage();
-                    throw post.control;
+                finally {
+                    await runFinalizeStage({ suppressErrors: true });
+                }
+                throw exec.control ?? new mcp_error_1.InternalMcpError('Missing control for fail/error outcome');
+            }
+            else if (exec.outcome === 'abort' || exec.outcome === 'next' || exec.outcome === 'handled') {
+                await runFinalizeStage({ suppressErrors: true });
+                if (!(exec.control instanceof common_1.FlowControl)) {
+                    throw new mcp_error_1.InternalMcpError('Expected FlowControl but received different error type');
                 }
+                throw exec.control;
             }
-            // ---------- FINALIZE ----------
-            await runFinalizeStage();
-            return responded;
         }
-        catch (e) {
-            throw e;
+        // ---------- POST ----------
+        {
+            const post = await runStageGroup(plan.post, false);
+            if (post.outcome === 'unknown_error' || post.outcome === 'fail') {
+                try {
+                    await runErrorStage();
+                }
+                finally {
+                    await runFinalizeStage({ suppressErrors: true });
+                }
+                throw post.control ?? new mcp_error_1.InternalMcpError('Missing control for fail/error outcome');
+            }
+            if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {
+                await runFinalizeStage({ suppressErrors: true });
+                if (!(post.control instanceof common_1.FlowControl)) {
+                    throw new mcp_error_1.InternalMcpError('Expected FlowControl but received different error type');
+                }
+                throw post.control;
+            }
         }
+        // ---------- FINALIZE ----------
+        await runFinalizeStage();
+        return responded;
     }
 }
 exports.FlowInstance = FlowInstance;

package/src/flows/flow.instance.js.map

@@ -1 +1 @@
-{"version":3,"file":"flow.instance.js","sourceRoot":"","sources":["../../../src/flows/flow.instance.ts"],"names":[],"mappings":"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","sourcesContent":["// noinspection ExceptionCaughtLocallyJS\n// flows/flow.instance.ts\n\nimport 'reflect-metadata';\nimport {\n  FlowControl,\n  FlowCtxOf,\n  FlowEntry,\n  FlowInputOf,\n  FlowName,\n  FlowOutputOf,\n  FlowPlan,\n  FlowRecord,\n  FlowStagesOf,\n  FlowType,\n  HookEntry,\n  HookMetadata,\n  Reference,\n  ServerRequest,\n  Token,\n  Type,\n} from '../common';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { collectFlowHookMap, StageMap, cloneStageMap, mergeHookMetasIntoStageMap } from './flow.stages';\nimport { writeHttpResponse } from '../server/server.validation';\nimport { Scope } from '../scope';\nimport HookRegistry from '../hooks/hook.registry';\nimport { rpcError } from '../transport/transport.error';\n\ntype StageOutcome = 'ok' | 'respond' | 'next' | 'handled' | 'fail' | 'abort' | 'unknown_error';\n\ninterface StageResult {\n  outcome: StageOutcome;\n  control?: FlowControl | Error;\n}\n\nconst CAP = (s: string) => (s ? s[0].toUpperCase() + s.slice(1) : s);\nconst WILL = (s: string) => `will${CAP(s)}`;\nconst DID = (s: string) => `did${CAP(s)}`;\nconst AROUND = (s: string) => `around${CAP(s)}`;\n\nfunction parseTypedKey(k: string): { base: string; type?: 'will' | 'did' | 'around' } {\n  const lc = k.toLowerCase();\n  if (lc.startsWith('will') && k.length > 4) return { base: k.slice(4, 5).toLowerCase() + k.slice(5), type: 'will' };\n  if (lc.startsWith('did') && k.length > 3) return { base: k.slice(3, 4).toLowerCase() + k.slice(4), type: 'did' };\n  if (lc.startsWith('around') && k.length > 6)\n    return { base: k.slice(6, 7).toLowerCase() + k.slice(7), type: 'around' };\n  return { base: k };\n}\n\nexport class FlowInstance<Name extends FlowName> extends FlowEntry<Name> {\n  readonly deps: Reference[];\n  readonly globalProviders: ProviderRegistry;\n  private plan: FlowPlan<never>;\n  private FlowClass: FlowType;\n  private stages: StageMap<FlowType>;\n  private hooks: HookRegistry;\n\n  constructor(scope: Scope, record: FlowRecord, deps: Set<Reference>, globalProviders: ProviderRegistry) {\n    super(scope, record);\n    this.deps = [...deps];\n    this.globalProviders = globalProviders;\n    this.FlowClass = this.record.provide;\n    this.ready = this.initialize();\n    this.plan = this.record.metadata.plan;\n    this.hooks = scope.providers.getHooksRegistry();\n  }\n\n  protected async initialize() {\n    const server = this.globalProviders.getActiveServer();\n\n    this.stages = collectFlowHookMap(this.FlowClass);\n\n    const { middleware } = this.metadata;\n    if (middleware) {\n      const path = typeof middleware.path === 'string' ? middleware.path : '';\n      server.registerMiddleware(path, async (request, response, next) => {\n        const canActivate = await this.canActivate(request);\n        if (!canActivate) return next();\n\n        try {\n          const result = await this.run({ request, response, next } as any, new Map());\n          if (result) return writeHttpResponse(response, result);\n        } catch (e) {\n          if (e instanceof FlowControl) {\n            switch (e.type) {\n              case 'abort':\n                return writeHttpResponse(response, { kind: 'text', status: 500, body: 'Aborted' });\n              case 'fail':\n                return writeHttpResponse(response, { kind: 'text', status: 500, body: 'Internal Server Error' });\n              case 'handled':\n                return;\n              case 'next':\n                return next();\n              case 'respond':\n                return writeHttpResponse(response, e.output as any);\n            }\n          }\n          // Skip console.error due to Node.js 24 util.inspect bug with Zod validation errors\n          // The error will be returned to the client as a 500 response\n          return writeHttpResponse(response, {\n            kind: 'text',\n            status: 500,\n            body: 'Internal Server Error',\n          });\n        }\n\n        return next();\n      });\n    }\n\n    return Promise.resolve();\n  }\n\n  async canActivate(request: ServerRequest): Promise<boolean> {\n    if (this.method && request.method !== this.method) return false;\n\n    const canActivate = this.metadata.middleware?.canActivate ?? [];\n    if ((this.FlowClass as any)['canActivate']) {\n      canActivate.push((this.FlowClass as any)['canActivate']);\n    }\n    if (canActivate.length === 0) return true;\n\n    const results = await Promise.all(canActivate.map((m) => m(request, this.scope)));\n    return results.every((r) => r);\n  }\n\n  async run(input: FlowInputOf<Name>, deps: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined> {\n    const scope = this.globalProviders.getActiveScope();\n    const { FlowClass, plan, name } = this;\n\n    // Clone stages so we can merge injections safely per run.\n    const baseStages = this.stages;\n    let stages: StageMap<any> = cloneStageMap(baseStages);\n\n    // Compute next order base after any class-defined entries.\n    let orderBase = Math.max(0, ...Object.values(stages).flatMap((list) => list.map((e: any) => e._order ?? 0))) + 1;\n\n    // Get tool owner ID if this is a tool call flow\n    // The tool owner ID is set by the CallToolFlow.findTool stage\n    const toolOwnerId = (input as any)?._toolOwnerId;\n\n    const initialInjectedHooks =\n      (this.hooks.getFlowHooksForOwner(name, toolOwnerId) as HookEntry<\n        FlowInputOf<Name>,\n        Name,\n        FlowStagesOf<Name>,\n        FlowCtxOf<Name>\n      >[]) ?? [];\n\n    let context: any;\n    let contextReady = false;\n\n    const materializeAndMerge = async (\n      newHooks: HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[],\n      opts?: { orderStart?: number },\n    ) => {\n      if (!newHooks?.length || !contextReady) return;\n\n      const metas: HookMetadata[] = [];\n      for (const h of newHooks) {\n        try {\n          metas.push(h.metadata);\n        } catch (e) {\n          // Use safe logging to avoid Node.js 24 util.inspect bug with Zod errors\n          // eslint-disable-next-line no-console\n          console.warn(\n            '[flow] Ignoring injected hook that failed to materialize:',\n            e instanceof Error ? e.message : 'Unknown error',\n          );\n        }\n      }\n\n      if (metas.length) {\n        const start = opts?.orderStart ?? orderBase;\n        mergeHookMetasIntoStageMap(FlowClass, stages, metas, start);\n        if (opts?.orderStart === undefined) orderBase += metas.length;\n      }\n    };\n\n    const appendContextHooks = async (\n      hooks: HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[],\n    ) => {\n      await materializeAndMerge(hooks);\n    };\n\n    // Construct flow instance\n    context = new FlowClass(this.metadata, input, scope, appendContextHooks, deps);\n\n    // Now injections can materialize\n    contextReady = true;\n\n    // Initial registry hooks should not pre-empt stages; they just get registered\n    await materializeAndMerge(initialInjectedHooks, { orderStart: -1_000_000 });\n\n    // Refresh order base to be after everything currently present\n    orderBase = Math.max(0, ...Object.values(stages).flatMap((list) => list.map((e: any) => e._order ?? 0))) + 1;\n\n    let responded: FlowOutputOf<Name> | undefined;\n\n    // Robust list runner (doesn't skip mid-run insertions)\n    const runList = async (key: string, opts?: { ignoreRespond?: boolean }): Promise<StageResult> => {\n      const getList = () => ((stages as any)[key] ?? []) as Array<{ method: (ctx: any) => Promise<void> }>;\n      const seen = new Set<any>();\n\n      while (true) {\n        const list = getList();\n        const item = list.find((e) => !seen.has(e));\n        if (!item) break;\n        seen.add(item);\n\n        try {\n          await item.method(context);\n        } catch (e: any) {\n          if (e instanceof FlowControl) {\n            if (e.type === 'respond') {\n              if (!opts?.ignoreRespond) {\n                responded = e.output as FlowOutputOf<Name>;\n                return { outcome: 'respond', control: e };\n              }\n              continue;\n            }\n            return { outcome: e.type, control: e };\n          }\n          return { outcome: 'unknown_error', control: e as Error };\n        }\n      }\n      return { outcome: 'ok' };\n    };\n\n    // Run exactly one stage in order: will → around → stage → did (did runs once)\n    const runOneStage = async (stageName: string, stopOnRespond: boolean): Promise<StageResult> => {\n      // 1) willStage\n      {\n        const res = await runList(WILL(stageName));\n        if (res.outcome === 'respond' && stopOnRespond) return res;\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') return res;\n      }\n\n      // 2) aroundStage (acts as pre-handlers unless you later add true wrapping)\n      {\n        const res = await runList(AROUND(stageName));\n        if (res.outcome === 'respond' && stopOnRespond) return res;\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') return res;\n      }\n\n      // 3) stage\n      let bodyOutcome: StageResult = { outcome: 'ok' };\n      {\n        const res = await runList(stageName, { ignoreRespond: false });\n        bodyOutcome = res;\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') {\n          // fail/abort/next/handled/unknown → do NOT run did\n          return res;\n        }\n      }\n\n      // 4) didStage (run once regardless of body respond)\n      {\n        const res = await runList(DID(stageName), { ignoreRespond: true });\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') return res;\n      }\n\n      if (bodyOutcome.outcome === 'respond') return bodyOutcome;\n      return { outcome: 'ok' };\n    };\n\n    // IMPORTANT: ignore typed stage names in plan arrays.\n    // Only base stage names in the plan drive execution; typed hooks run *with* their base.\n    const runStageGroup = async (\n      group: Array<string> | undefined,\n      stopOnRespond: boolean,\n      opts?: { ignoreRespond?: boolean },\n    ): Promise<StageResult> => {\n      if (!group || group.length === 0) return { outcome: 'ok' };\n\n      const seenBase = new Set<string>();\n      for (const rawKey of group) {\n        const { base, type } = parseTypedKey(rawKey);\n        if (type) {\n          // Soft warning once per typed key occurrence (optional)\n          // console.warn(`[flow] Ignoring typed stage \"${rawKey}\" in plan; hooks will run with base \"${base}\".`);\n          continue; // Do not run typed keys as standalone stages\n        }\n        if (seenBase.has(base)) continue;\n        seenBase.add(base);\n\n        const res = await runOneStage(base, stopOnRespond);\n        if (res.outcome === 'respond') {\n          if (stopOnRespond) return res;\n          // else keep going\n        } else if (res.outcome !== 'ok') {\n          return res;\n        }\n      }\n      return { outcome: 'ok' };\n    };\n\n    const runErrorStage = async () => {\n      await runStageGroup((plan as any).error, false, { ignoreRespond: true });\n    };\n\n    const runFinalizeStage = async () => {\n      await runStageGroup((plan as any).finalize, false);\n    };\n\n    try {\n      // ---------- PRE ----------\n      {\n        const pre = await runStageGroup((plan as any).pre, true);\n        if (pre.outcome === 'respond') {\n          const post = await runStageGroup((plan as any).post, false);\n          if (post.outcome === 'unknown_error' || post.outcome === 'fail') {\n            try {\n              await runErrorStage();\n            } finally {\n              await runFinalizeStage();\n            }\n            if (post.outcome === 'fail') throw post.control!;\n            throw post.control!;\n          }\n          if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {\n            await runFinalizeStage();\n            throw post.control as FlowControl;\n          }\n          await runFinalizeStage();\n          return responded;\n        }\n        if (pre.outcome === 'unknown_error' || pre.outcome === 'fail') {\n          try {\n            await runErrorStage();\n          } finally {\n            await runFinalizeStage();\n          }\n          if (pre.outcome === 'fail') throw pre.control!;\n          throw pre.control!;\n        }\n        if (pre.outcome === 'abort' || pre.outcome === 'next' || pre.outcome === 'handled') {\n          await runFinalizeStage();\n          throw pre.control as FlowControl;\n        }\n      }\n\n      // ---------- EXECUTE ----------\n      if (!responded) {\n        const exec = await runStageGroup((plan as any).execute, true);\n        if (exec.outcome === 'respond') {\n          // continue to post + finalize\n        } else if (exec.outcome === 'unknown_error' || exec.outcome === 'fail') {\n          try {\n            await runErrorStage();\n          } finally {\n            await runFinalizeStage();\n          }\n          if (exec.outcome === 'fail') throw exec.control!;\n          throw exec.control!;\n        } else if (exec.outcome === 'abort' || exec.outcome === 'next' || exec.outcome === 'handled') {\n          await runFinalizeStage();\n          throw exec.control as FlowControl;\n        }\n      }\n\n      // ---------- POST ----------\n      {\n        const post = await runStageGroup((plan as any).post, false);\n        if (post.outcome === 'unknown_error' || post.outcome === 'fail') {\n          try {\n            await runErrorStage();\n          } finally {\n            await runFinalizeStage();\n          }\n          if (post.outcome === 'fail') throw post.control!;\n          throw post.control!;\n        }\n        if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {\n          await runFinalizeStage();\n          throw post.control as FlowControl;\n        }\n      }\n\n      // ---------- FINALIZE ----------\n      await runFinalizeStage();\n\n      return responded;\n    } catch (e) {\n      throw e;\n    }\n  }\n}\n"]}
+{"version":3,"file":"flow.instance.js","sourceRoot":"","sources":["../../../src/flows/flow.instance.ts"],"names":[],"mappings":"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","sourcesContent":["// noinspection ExceptionCaughtLocallyJS\n// flows/flow.instance.ts\n\nimport 'reflect-metadata';\nimport {\n  FlowBase,\n  FlowControl,\n  FlowCtxOf,\n  FlowEntry,\n  FlowInputOf,\n  FlowName,\n  FlowOutputOf,\n  FlowPlan,\n  FlowRecord,\n  FlowStagesOf,\n  FlowType,\n  HookEntry,\n  HookMetadata,\n  Reference,\n  ServerRequest,\n  Token,\n  Type,\n} from '../common';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { collectFlowHookMap, StageMap, cloneStageMap, mergeHookMetasIntoStageMap } from './flow.stages';\nimport { writeHttpResponse } from '../server/server.validation';\nimport { Scope } from '../scope';\nimport HookRegistry from '../hooks/hook.registry';\nimport { rpcError } from '../transport/transport.error';\nimport { FrontMcpContextStorage, FRONTMCP_CONTEXT } from '../context';\nimport { RequestContextNotAvailableError, InternalMcpError } from '../errors/mcp.error';\nimport { randomUUID } from 'crypto';\n\ntype StageOutcome = 'ok' | 'respond' | 'next' | 'handled' | 'fail' | 'abort' | 'unknown_error';\n\ninterface StageResult {\n  outcome: StageOutcome;\n  control?: FlowControl | Error;\n}\n\nconst CAP = (s: string) => (s ? s[0].toUpperCase() + s.slice(1) : s);\nconst WILL = (s: string) => `will${CAP(s)}`;\nconst DID = (s: string) => `did${CAP(s)}`;\nconst AROUND = (s: string) => `around${CAP(s)}`;\n\nfunction parseTypedKey(k: string): { base: string; type?: 'will' | 'did' | 'around' } {\n  const lc = k.toLowerCase();\n  if (lc.startsWith('will') && k.length > 4) return { base: k.slice(4, 5).toLowerCase() + k.slice(5), type: 'will' };\n  if (lc.startsWith('did') && k.length > 3) return { base: k.slice(3, 4).toLowerCase() + k.slice(4), type: 'did' };\n  if (lc.startsWith('around') && k.length > 6)\n    return { base: k.slice(6, 7).toLowerCase() + k.slice(7), type: 'around' };\n  return { base: k };\n}\n\nexport class FlowInstance<Name extends FlowName> extends FlowEntry<Name> {\n  readonly deps: Reference[];\n  readonly globalProviders: ProviderRegistry;\n  private plan: FlowPlan<never>;\n  private FlowClass: FlowType;\n  private stages: StageMap<FlowType>;\n  private hooks: HookRegistry;\n\n  constructor(scope: Scope, record: FlowRecord, deps: Set<Reference>, globalProviders: ProviderRegistry) {\n    super(scope, record);\n    this.deps = [...deps];\n    this.globalProviders = globalProviders;\n    this.FlowClass = this.record.provide;\n    this.ready = this.initialize();\n    this.plan = this.record.metadata.plan;\n    this.hooks = scope.providers.getHooksRegistry();\n  }\n\n  protected async initialize() {\n    const server = this.globalProviders.getActiveServer();\n\n    this.stages = collectFlowHookMap(this.FlowClass);\n\n    const { middleware } = this.metadata;\n    if (middleware) {\n      const path = typeof middleware.path === 'string' ? middleware.path : '';\n      server.registerMiddleware(path, async (request, response, next) => {\n        const canActivate = await this.canActivate(request);\n        if (!canActivate) return next();\n\n        // Get context storage to wrap entire flow in FrontMcpContext\n        const contextStorage = this.getContextStorage();\n\n        try {\n          // Use runWithContext to wrap entire flow execution in AsyncLocalStorage context\n          // This ensures all stages have access to FrontMcpContext\n          const result = await this.runWithContext(\n            contextStorage,\n            request,\n            { request, response, next } as any,\n            new Map(),\n          );\n          if (result) return writeHttpResponse(response, result);\n        } catch (e) {\n          if (e instanceof FlowControl) {\n            switch (e.type) {\n              case 'abort':\n                return writeHttpResponse(response, { kind: 'text', status: 500, body: 'Aborted' });\n              case 'fail':\n                return writeHttpResponse(response, { kind: 'text', status: 500, body: 'Internal Server Error' });\n              case 'handled':\n                return;\n              case 'next':\n                return next();\n              case 'respond':\n                return writeHttpResponse(response, e.output as any);\n            }\n          }\n          // Log unhandled errors for visibility (non-FlowControl errors indicate bugs)\n          // Note: Using structured logging to avoid Node.js util.inspect issues with Zod errors\n          console.error('[FlowInstance] Unhandled error:', {\n            name: e instanceof Error ? e.name : 'UnknownError',\n            message: e instanceof Error ? e.message : String(e),\n          });\n          return writeHttpResponse(response, {\n            kind: 'text',\n            status: 500,\n            body: 'Internal Server Error',\n          });\n        }\n\n        return next();\n      });\n    }\n\n    return Promise.resolve();\n  }\n\n  async canActivate(request: ServerRequest): Promise<boolean> {\n    if (this.method && request.method !== this.method) return false;\n\n    const canActivate = this.metadata.middleware?.canActivate ?? [];\n    if ((this.FlowClass as any)['canActivate']) {\n      canActivate.push((this.FlowClass as any)['canActivate']);\n    }\n    if (canActivate.length === 0) return true;\n\n    const results = await Promise.all(canActivate.map((m) => m(request, this.scope)));\n    return results.every((r) => r);\n  }\n\n  /**\n   * Get FrontMcpContextStorage from providers (with fallback).\n   * Returns undefined if not available (backward compatibility).\n   */\n  private getContextStorage(): FrontMcpContextStorage | undefined {\n    try {\n      return this.globalProviders.get(FrontMcpContextStorage);\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Run flow wrapped in FrontMcpContext.\n   * This ensures ALL stages have access to the context via AsyncLocalStorage.\n   *\n   * @param storage - FrontMcpContextStorage instance\n   * @param request - The HTTP request\n   * @param input - Flow input\n   * @param deps - Flow dependencies\n   * @returns Flow output or undefined\n   */\n  private async runWithContext(\n    storage: FrontMcpContextStorage | undefined,\n    request: ServerRequest,\n    input: FlowInputOf<Name>,\n    deps: Map<Token, Type>,\n  ): Promise<FlowOutputOf<Name> | undefined> {\n    // If no storage available, run without context (backward compatibility)\n    if (!storage) {\n      return this.run(input, deps);\n    }\n\n    // Extract context parameters from request\n    const headers = (request.headers ?? {}) as Record<string, unknown>;\n    // Generate unique ID for anonymous sessions to prevent session collision\n    // All unauthenticated requests previously shared 'anonymous', causing data leakage\n    // Handle empty strings explicitly: '' ?? 'fallback' returns '', not 'fallback'\n    const headerSessionId = typeof headers['mcp-session-id'] === 'string' ? headers['mcp-session-id'].trim() : '';\n    const sessionId = headerSessionId.length > 0 ? headerSessionId : `anon:${randomUUID()}`;\n    const scope = this.globalProviders.getActiveScope();\n\n    // Wrap ENTIRE flow execution in AsyncLocalStorage context\n    return storage.runFromHeaders(\n      headers,\n      {\n        sessionId,\n        scopeId: scope.id,\n      },\n      async () => {\n        return this.run(input, deps);\n      },\n    );\n  }\n\n  async run(input: FlowInputOf<Name>, deps: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined> {\n    const scope = this.globalProviders.getActiveScope();\n    const { FlowClass, plan, name } = this;\n\n    // Build provider views for scoped DI\n    // This enables CONTEXT scoped providers to be resolved\n    const contextStorage = this.getContextStorage();\n    const currentContext = contextStorage?.getStore();\n    // Get session ID from context - should always be available since runWithContext wraps the entire flow\n    // If unavailable, it indicates a bug in context propagation (not a normal case)\n    const sessionKey = currentContext?.sessionId;\n    if (!sessionKey) {\n      // This should never happen since runWithContext wraps the entire flow execution\n      // If we reach here, there's a bug in context propagation\n      throw new RequestContextNotAvailableError(\n        'FrontMcpContext unavailable - session ID required for provider resolution. Ensure flow is wrapped with runWithContext.',\n      );\n    }\n\n    // Build views with current context if available\n    const views = await this.globalProviders.buildViews(\n      sessionKey,\n      currentContext ? new Map([[FRONTMCP_CONTEXT, currentContext]]) : undefined,\n    );\n\n    // Merge context-scoped providers into deps for resolution by FlowClass\n    const mergedDeps = new Map(deps);\n    for (const [token, instance] of views.context) {\n      mergedDeps.set(token, instance as Type);\n    }\n\n    // Clone stages so we can merge injections safely per run.\n    const baseStages = this.stages;\n    const stages: StageMap<any> = cloneStageMap(baseStages);\n\n    // Compute next order base after any class-defined entries.\n    let orderBase = Math.max(0, ...Object.values(stages).flatMap((list) => list.map((e: any) => e._order ?? 0))) + 1;\n\n    // Get tool owner ID if this is a tool call flow\n    // The tool owner ID is set by the CallToolFlow.findTool stage\n    const toolOwnerId = (input as any)?._toolOwnerId;\n\n    const initialInjectedHooks =\n      (this.hooks.getFlowHooksForOwner(name, toolOwnerId) as HookEntry<\n        FlowInputOf<Name>,\n        Name,\n        FlowStagesOf<Name>,\n        FlowCtxOf<Name>\n      >[]) ?? [];\n\n    // FlowClass generic type is erased at runtime, so we use FlowBase<any>\n    // to avoid complex type gymnastics while maintaining basic type safety\n    let context: FlowBase<any>;\n    let contextReady = false;\n\n    const materializeAndMerge = async (\n      newHooks: HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[],\n      opts?: { orderStart?: number },\n    ) => {\n      if (!newHooks?.length || !contextReady) return;\n\n      const metas: HookMetadata[] = [];\n      for (const h of newHooks) {\n        try {\n          metas.push(h.metadata);\n        } catch (e) {\n          // Use safe logging to avoid Node.js 24 util.inspect bug with Zod errors\n\n          console.warn(\n            '[flow] Ignoring injected hook that failed to materialize:',\n            e instanceof Error ? e.message : 'Unknown error',\n          );\n        }\n      }\n\n      if (metas.length) {\n        const start = opts?.orderStart ?? orderBase;\n        mergeHookMetasIntoStageMap(FlowClass, stages, metas, start);\n        if (opts?.orderStart === undefined) orderBase += metas.length;\n      }\n    };\n\n    const appendContextHooks = async (\n      hooks: HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[],\n    ) => {\n      await materializeAndMerge(hooks);\n    };\n\n    // Construct flow instance with merged dependencies (includes scoped providers)\n    // eslint-disable-next-line prefer-const -- declaration must precede helper functions that close over context\n    context = new FlowClass(this.metadata, input, scope, appendContextHooks, mergedDeps);\n\n    // Now injections can materialize\n    contextReady = true;\n\n    // Initial registry hooks should not pre-empt stages; they just get registered\n    await materializeAndMerge(initialInjectedHooks, { orderStart: -1_000_000 });\n\n    // Refresh order base to be after everything currently present\n    orderBase = Math.max(0, ...Object.values(stages).flatMap((list) => list.map((e: any) => e._order ?? 0))) + 1;\n\n    let responded: FlowOutputOf<Name> | undefined;\n\n    // Robust list runner (doesn't skip mid-run insertions)\n    const runList = async (key: string, opts?: { ignoreRespond?: boolean }): Promise<StageResult> => {\n      const getList = () => ((stages as any)[key] ?? []) as Array<{ method: (ctx: any) => Promise<void> }>;\n      const seen = new Set<any>();\n\n      while (true) {\n        const list = getList();\n        const item = list.find((e) => !seen.has(e));\n        if (!item) break;\n        seen.add(item);\n\n        try {\n          await item.method(context);\n        } catch (e: any) {\n          if (e instanceof FlowControl) {\n            if (e.type === 'respond') {\n              if (!opts?.ignoreRespond) {\n                responded = e.output as FlowOutputOf<Name>;\n                return { outcome: 'respond', control: e };\n              }\n              continue;\n            }\n            return { outcome: e.type, control: e };\n          }\n          return { outcome: 'unknown_error', control: e as Error };\n        }\n      }\n      return { outcome: 'ok' };\n    };\n\n    // Run exactly one stage in order: will → around → stage → did (did runs once)\n    const runOneStage = async (stageName: string, stopOnRespond: boolean): Promise<StageResult> => {\n      // 1) willStage\n      {\n        const res = await runList(WILL(stageName));\n        if (res.outcome === 'respond' && stopOnRespond) return res;\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') return res;\n      }\n\n      // 2) aroundStage (acts as pre-handlers unless you later add true wrapping)\n      {\n        const res = await runList(AROUND(stageName));\n        if (res.outcome === 'respond' && stopOnRespond) return res;\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') return res;\n      }\n\n      // 3) stage\n      let bodyOutcome: StageResult = { outcome: 'ok' };\n      {\n        const res = await runList(stageName, { ignoreRespond: false });\n        bodyOutcome = res;\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') {\n          // fail/abort/next/handled/unknown → do NOT run did\n          return res;\n        }\n      }\n\n      // 4) didStage (run once regardless of body respond)\n      {\n        const res = await runList(DID(stageName), { ignoreRespond: true });\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') return res;\n      }\n\n      if (bodyOutcome.outcome === 'respond') return bodyOutcome;\n      return { outcome: 'ok' };\n    };\n\n    // IMPORTANT: ignore typed stage names in plan arrays.\n    // Only base stage names in the plan drive execution; typed hooks run *with* their base.\n    const runStageGroup = async (\n      group: Array<string> | undefined,\n      stopOnRespond: boolean,\n      opts?: { ignoreRespond?: boolean },\n    ): Promise<StageResult> => {\n      if (!group || group.length === 0) return { outcome: 'ok' };\n\n      const seenBase = new Set<string>();\n      for (const rawKey of group) {\n        const { base, type } = parseTypedKey(rawKey);\n        if (type) {\n          // Soft warning once per typed key occurrence (optional)\n          // console.warn(`[flow] Ignoring typed stage \"${rawKey}\" in plan; hooks will run with base \"${base}\".`);\n          continue; // Do not run typed keys as standalone stages\n        }\n        if (seenBase.has(base)) continue;\n        seenBase.add(base);\n\n        const res = await runOneStage(base, stopOnRespond);\n        if (res.outcome === 'respond') {\n          if (stopOnRespond) return res;\n          // else keep going\n        } else if (res.outcome !== 'ok') {\n          return res;\n        }\n      }\n      return { outcome: 'ok' };\n    };\n\n    const runErrorStage = async () => {\n      await runStageGroup((plan as any).error, false, { ignoreRespond: true });\n    };\n\n    const runFinalizeStage = async (options?: { suppressErrors?: boolean }) => {\n      const res = await runStageGroup((plan as any).finalize, false);\n      // Handle finalize stage errors\n      if (res.outcome === 'unknown_error' || res.outcome === 'fail') {\n        const finalizeError = res.control ?? new InternalMcpError('Finalize stage failed');\n        if (options?.suppressErrors) {\n          // Log finalizes errors but doesn't throw when called from finally blocks\n          // This prevents masking the original error\n          this.scope.logger.error(\n            '[FrontMCP] Finalize stage error (suppressed to preserve original error):',\n            finalizeError,\n          );\n          return res;\n        }\n        throw finalizeError;\n      }\n      return res;\n    };\n\n    // ---------- PRE ----------\n    {\n      const pre = await runStageGroup((plan as any).pre, true);\n      if (pre.outcome === 'respond') {\n        const post = await runStageGroup((plan as any).post, false);\n        if (post.outcome === 'unknown_error' || post.outcome === 'fail') {\n          try {\n            await runErrorStage();\n          } finally {\n            await runFinalizeStage({ suppressErrors: true });\n          }\n          throw post.control ?? new InternalMcpError('Missing control for fail/error outcome');\n        }\n        if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {\n          await runFinalizeStage({ suppressErrors: true });\n          if (!(post.control instanceof FlowControl)) {\n            throw new InternalMcpError('Expected FlowControl but received different error type');\n          }\n          throw post.control;\n        }\n        await runFinalizeStage();\n        return responded;\n      }\n      if (pre.outcome === 'unknown_error' || pre.outcome === 'fail') {\n        try {\n          await runErrorStage();\n        } finally {\n          await runFinalizeStage({ suppressErrors: true });\n        }\n        throw pre.control ?? new InternalMcpError('Missing control for fail/error outcome');\n      }\n      if (pre.outcome === 'abort' || pre.outcome === 'next' || pre.outcome === 'handled') {\n        await runFinalizeStage({ suppressErrors: true });\n        if (!(pre.control instanceof FlowControl)) {\n          throw new InternalMcpError('Expected FlowControl but received different error type');\n        }\n        throw pre.control;\n      }\n    }\n\n    // ---------- EXECUTE ----------\n    if (!responded) {\n      const exec = await runStageGroup((plan as any).execute, true);\n      if (exec.outcome === 'respond') {\n        // continue to post + finalize\n      } else if (exec.outcome === 'unknown_error' || exec.outcome === 'fail') {\n        try {\n          await runErrorStage();\n        } finally {\n          await runFinalizeStage({ suppressErrors: true });\n        }\n        throw exec.control ?? new InternalMcpError('Missing control for fail/error outcome');\n      } else if (exec.outcome === 'abort' || exec.outcome === 'next' || exec.outcome === 'handled') {\n        await runFinalizeStage({ suppressErrors: true });\n        if (!(exec.control instanceof FlowControl)) {\n          throw new InternalMcpError('Expected FlowControl but received different error type');\n        }\n        throw exec.control;\n      }\n    }\n\n    // ---------- POST ----------\n    {\n      const post = await runStageGroup((plan as any).post, false);\n      if (post.outcome === 'unknown_error' || post.outcome === 'fail') {\n        try {\n          await runErrorStage();\n        } finally {\n          await runFinalizeStage({ suppressErrors: true });\n        }\n        throw post.control ?? new InternalMcpError('Missing control for fail/error outcome');\n      }\n      if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {\n        await runFinalizeStage({ suppressErrors: true });\n        if (!(post.control instanceof FlowControl)) {\n          throw new InternalMcpError('Expected FlowControl but received different error type');\n        }\n        throw post.control;\n      }\n    }\n\n    // ---------- FINALIZE ----------\n    await runFinalizeStage();\n\n    return responded;\n  }\n}\n"]}

package/src/flows/flow.registry.d.ts

@@ -11,4 +11,9 @@ export default class FlowRegistry extends RegistryAbstract<FlowInstance<FlowName
     private initializeOne;
     registryFlows(rawFlows: FlowType[]): Promise<void>;
     runFlow<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, deps?: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>;
+    /**
+     * Get FrontMcpContextStorage from providers (with fallback).
+     * Returns undefined if not available (backward compatibility).
+     */
+    private getContextStorage;
 }

package/src/flows/flow.registry.js

@@ -3,8 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const regsitry_1 = require("../regsitry");
 const common_1 = require("../common");
 const flow_utils_1 = require("./flow.utils");
-const token_utils_1 = require("../utils/token.utils");
+const utils_1 = require("../utils");
 const flow_instance_1 = require("./flow.instance");
+const context_1 = require("../context");
+const crypto_1 = require("crypto");
 class FlowRegistry extends regsitry_1.RegistryAbstract {
     constructor(providers, list) {
         super('FlowRegistry', providers, list);
@@ -32,7 +34,7 @@ class FlowRegistry extends regsitry_1.RegistryAbstract {
                 }
                 else {
                     if (!this.providers.get(d)) {
-                        throw new Error(`Flow ${(0, token_utils_1.tokenName)(token)} depends on ${(0, token_utils_1.tokenName)(d)}, which is not registered.`);
+                        throw new Error(`Flow ${(0, utils_1.tokenName)(token)} depends on ${(0, utils_1.tokenName)(d)}, which is not registered.`);
                     }
                     this.graph.get(token).add(d);
                 }
@@ -72,7 +74,47 @@ class FlowRegistry extends regsitry_1.RegistryAbstract {
         if (!flow) {
             throw new Error(`Flow ${name} is not registered`);
         }
-        return flow.run(input, deps ?? new Map());
+        // Get context storage for MCP flows (if not already in a context)
+        const contextStorage = this.getContextStorage();
+        if (!contextStorage) {
+            // No context storage available, run without context (backward compatibility)
+            return flow.run(input, deps ?? new Map());
+        }
+        // Check if we're already in a context (e.g., HTTP middleware flow)
+        const existingContext = contextStorage.getStore();
+        if (existingContext) {
+            // Already in context, run directly
+            return flow.run(input, deps ?? new Map());
+        }
+        // Extract session info from MCP handler context (input.ctx.authInfo)
+        // MCP handlers pass { request, ctx } where ctx has authInfo
+        const mcpCtx = input?.ctx;
+        const authInfo = mcpCtx?.authInfo;
+        // Get session ID from authInfo (set by ensureAuthInfo in transport adapter)
+        // Fall back to anonymous session if not available
+        const rawSessionId = authInfo?.sessionId;
+        const sessionId = typeof rawSessionId === 'string' && rawSessionId.trim().length > 0 ? rawSessionId.trim() : `anon:${(0, crypto_1.randomUUID)()}`;
+        const scope = this.providers.getActiveScope();
+        // Wrap flow execution in FrontMcpContext
+        return Promise.resolve(contextStorage.run({
+            sessionId,
+            scopeId: scope.id,
+            authInfo,
+        }, async () => {
+            return flow.run(input, deps ?? new Map());
+        }));
+    }
+    /**
+     * Get FrontMcpContextStorage from providers (with fallback).
+     * Returns undefined if not available (backward compatibility).
+     */
+    getContextStorage() {
+        try {
+            return this.providers.get(context_1.FrontMcpContextStorage);
+        }
+        catch {
+            return undefined;
+        }
     }
 }
 exports.default = FlowRegistry;

package/src/flows/flow.registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"flow.registry.js","sourceRoot":"","sources":["../../../src/flows/flow.registry.ts"],"names":[],"mappings":";;AACA,0CAAuE;AACvE,sCAA+G;AAC/G,6CAA6C;AAC7C,sDAAiD;AACjD,mDAA+C;AAE/C,MAAqB,YAAa,SAAQ,2BAAgE;IACxG,YAAY,SAA2B,EAAE,IAAgB;QACvD,KAAK,CAAC,cAAc,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAEkB,QAAQ,CAAC,IAAgB;QAC1C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAS,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;QAE3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,IAAA,0BAAa,EAAC,GAAG,CAAC,CAAC;YAC/B,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,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACjC,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,GAAG,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC;YAE1C,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI,mBAAU,EAAE,CAAC;oBACpB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,mBAAU,CAAC,CAAC;gBACzC,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC3B,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAA,uBAAS,EAAC,KAAK,CAAC,eAAe,IAAA,uBAAS,EAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC;oBACnG,CAAC;oBACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,0EAA0E;IAChE,KAAK,CAAC,UAAU;QACxB,MAAM,QAAQ,GAAoB,EAAE,CAAC;QACrC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC3C,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAEO,aAAa,CAAC,KAAY;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;QAEpC,MAAM,QAAQ,GAAG,IAAI,4BAAY,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9F,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAoB;QACtC,MAAM,QAAQ,GAAoB,EAAE,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,IAAA,0BAAa,EAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YACnC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CACL,IAAU,EACV,KAAwB,EACxB,IAAuB;QAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,oBAAoB,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,IAAI,IAAI,GAAG,EAAE,CAA4C,CAAC;IACvF,CAAC;CACF;AAlFD,+BAkFC","sourcesContent":["import ProviderRegistry from '../provider/provider.registry';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport { FlowInputOf, FlowName, FlowOutputOf, FlowRecord, FlowType, ScopeEntry, Token, Type } from '../common';\nimport { normalizeFlow } from './flow.utils';\nimport { tokenName } from '../utils/token.utils';\nimport { FlowInstance } from './flow.instance';\n\nexport default class FlowRegistry extends RegistryAbstract<FlowInstance<FlowName>, FlowRecord, FlowType[]> {\n  constructor(providers: ProviderRegistry, list: FlowType[]) {\n    super('FlowRegistry', providers, list);\n  }\n\n  protected override buildMap(list: FlowType[]): RegistryBuildMapResult<FlowRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, FlowRecord>();\n    const graph = new Map<Token, Set<Token>>();\n\n    for (const raw of list) {\n      const rec = normalizeFlow(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 { tokens, defs, graph };\n  }\n\n  protected buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = rec.metadata.dependsOn ?? [];\n\n      for (const d of deps) {\n        if (d == ScopeEntry) {\n          this.graph.get(token)!.add(ScopeEntry);\n        } else {\n          if (!this.providers.get(d)) {\n            throw new Error(`Flow ${tokenName(token)} depends on ${tokenName(d)}, which is not registered.`);\n          }\n          this.graph.get(token)!.add(d);\n        }\n      }\n    }\n  }\n\n  /** Instantiate adapters, run fetch/transform, and populate registries. */\n  protected async initialize(): Promise<void> {\n    const readyArr: Promise<void>[] = [];\n    for (const token of this.tokens) {\n      const instance = this.initializeOne(token);\n      readyArr.push(instance.ready);\n    }\n    await Promise.all(readyArr);\n  }\n\n  private initializeOne(token: Token) {\n    const rec = this.defs.get(token)!;\n    const deps = this.graph.get(token)!;\n\n    const instance = new FlowInstance(this.providers.getActiveScope(), rec, deps, this.providers);\n    this.instances.set(rec.metadata.name, instance);\n    return instance;\n  }\n\n  async registryFlows(rawFlows: FlowType[]): Promise<void> {\n    const readyArr: Promise<void>[] = [];\n    for (const raw of rawFlows) {\n      const rec = normalizeFlow(raw);\n      const provide = rec.provide;\n      this.tokens.add(provide);\n      this.defs.set(provide, rec);\n      this.graph.set(provide, new Set());\n      readyArr.push(this.initializeOne(provide).ready);\n    }\n    await Promise.all(readyArr);\n  }\n\n  runFlow<Name extends FlowName>(\n    name: Name,\n    input: FlowInputOf<Name>,\n    deps?: Map<Token, Type>,\n  ): Promise<FlowOutputOf<Name> | undefined> {\n    const flow = this.instances.get(name);\n    if (!flow) {\n      throw new Error(`Flow ${name} is not registered`);\n    }\n    return flow.run(input, deps ?? new Map()) as Promise<FlowOutputOf<Name> | undefined>;\n  }\n}\n"]}
+{"version":3,"file":"flow.registry.js","sourceRoot":"","sources":["../../../src/flows/flow.registry.ts"],"names":[],"mappings":";;AACA,0CAAuE;AACvE,sCAA+G;AAC/G,6CAA6C;AAC7C,oCAAqC;AACrC,mDAA+C;AAC/C,wCAAoD;AACpD,mCAAoC;AAEpC,MAAqB,YAAa,SAAQ,2BAAgE;IACxG,YAAY,SAA2B,EAAE,IAAgB;QACvD,KAAK,CAAC,cAAc,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAEkB,QAAQ,CAAC,IAAgB;QAC1C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAS,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;QAE3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,IAAA,0BAAa,EAAC,GAAG,CAAC,CAAC;YAC/B,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,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACjC,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,GAAG,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC;YAE1C,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI,mBAAU,EAAE,CAAC;oBACpB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,mBAAU,CAAC,CAAC;gBACzC,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC3B,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAA,iBAAS,EAAC,KAAK,CAAC,eAAe,IAAA,iBAAS,EAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC;oBACnG,CAAC;oBACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,0EAA0E;IAChE,KAAK,CAAC,UAAU;QACxB,MAAM,QAAQ,GAAoB,EAAE,CAAC;QACrC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC3C,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAEO,aAAa,CAAC,KAAY;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;QAEpC,MAAM,QAAQ,GAAG,IAAI,4BAAY,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9F,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAoB;QACtC,MAAM,QAAQ,GAAoB,EAAE,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,IAAA,0BAAa,EAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YACnC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CACL,IAAU,EACV,KAAwB,EACxB,IAAuB;QAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,oBAAoB,CAAC,CAAC;QACpD,CAAC;QAED,kEAAkE;QAClE,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAChD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,6EAA6E;YAC7E,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,IAAI,IAAI,GAAG,EAAE,CAA4C,CAAC;QACvF,CAAC;QAED,mEAAmE;QACnE,MAAM,eAAe,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC;QAClD,IAAI,eAAe,EAAE,CAAC;YACpB,mCAAmC;YACnC,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,IAAI,IAAI,GAAG,EAAE,CAA4C,CAAC;QACvF,CAAC;QAED,qEAAqE;QACrE,4DAA4D;QAC5D,MAAM,MAAM,GAAI,KAAa,EAAE,GAAG,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,CAAC;QAElC,4EAA4E;QAC5E,kDAAkD;QAClD,MAAM,YAAY,GAAG,QAAQ,EAAE,SAAS,CAAC;QACzC,MAAM,SAAS,GACb,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAA,mBAAU,GAAE,EAAE,CAAC;QAEpH,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;QAE9C,yCAAyC;QACzC,OAAO,OAAO,CAAC,OAAO,CACpB,cAAc,CAAC,GAAG,CAChB;YACE,SAAS;YACT,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,QAAQ;SACT,EACD,KAAK,IAAI,EAAE;YACT,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,IAAI,IAAI,GAAG,EAAE,CAA4C,CAAC;QACvF,CAAC,CACF,CACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,iBAAiB;QACvB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,gCAAsB,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF;AAtID,+BAsIC","sourcesContent":["import ProviderRegistry from '../provider/provider.registry';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport { FlowInputOf, FlowName, FlowOutputOf, FlowRecord, FlowType, ScopeEntry, Token, Type } from '../common';\nimport { normalizeFlow } from './flow.utils';\nimport { tokenName } from '../utils';\nimport { FlowInstance } from './flow.instance';\nimport { FrontMcpContextStorage } from '../context';\nimport { randomUUID } from 'crypto';\n\nexport default class FlowRegistry extends RegistryAbstract<FlowInstance<FlowName>, FlowRecord, FlowType[]> {\n  constructor(providers: ProviderRegistry, list: FlowType[]) {\n    super('FlowRegistry', providers, list);\n  }\n\n  protected override buildMap(list: FlowType[]): RegistryBuildMapResult<FlowRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, FlowRecord>();\n    const graph = new Map<Token, Set<Token>>();\n\n    for (const raw of list) {\n      const rec = normalizeFlow(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 { tokens, defs, graph };\n  }\n\n  protected buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = rec.metadata.dependsOn ?? [];\n\n      for (const d of deps) {\n        if (d == ScopeEntry) {\n          this.graph.get(token)!.add(ScopeEntry);\n        } else {\n          if (!this.providers.get(d)) {\n            throw new Error(`Flow ${tokenName(token)} depends on ${tokenName(d)}, which is not registered.`);\n          }\n          this.graph.get(token)!.add(d);\n        }\n      }\n    }\n  }\n\n  /** Instantiate adapters, run fetch/transform, and populate registries. */\n  protected async initialize(): Promise<void> {\n    const readyArr: Promise<void>[] = [];\n    for (const token of this.tokens) {\n      const instance = this.initializeOne(token);\n      readyArr.push(instance.ready);\n    }\n    await Promise.all(readyArr);\n  }\n\n  private initializeOne(token: Token) {\n    const rec = this.defs.get(token)!;\n    const deps = this.graph.get(token)!;\n\n    const instance = new FlowInstance(this.providers.getActiveScope(), rec, deps, this.providers);\n    this.instances.set(rec.metadata.name, instance);\n    return instance;\n  }\n\n  async registryFlows(rawFlows: FlowType[]): Promise<void> {\n    const readyArr: Promise<void>[] = [];\n    for (const raw of rawFlows) {\n      const rec = normalizeFlow(raw);\n      const provide = rec.provide;\n      this.tokens.add(provide);\n      this.defs.set(provide, rec);\n      this.graph.set(provide, new Set());\n      readyArr.push(this.initializeOne(provide).ready);\n    }\n    await Promise.all(readyArr);\n  }\n\n  runFlow<Name extends FlowName>(\n    name: Name,\n    input: FlowInputOf<Name>,\n    deps?: Map<Token, Type>,\n  ): Promise<FlowOutputOf<Name> | undefined> {\n    const flow = this.instances.get(name);\n    if (!flow) {\n      throw new Error(`Flow ${name} is not registered`);\n    }\n\n    // Get context storage for MCP flows (if not already in a context)\n    const contextStorage = this.getContextStorage();\n    if (!contextStorage) {\n      // No context storage available, run without context (backward compatibility)\n      return flow.run(input, deps ?? new Map()) as Promise<FlowOutputOf<Name> | undefined>;\n    }\n\n    // Check if we're already in a context (e.g., HTTP middleware flow)\n    const existingContext = contextStorage.getStore();\n    if (existingContext) {\n      // Already in context, run directly\n      return flow.run(input, deps ?? new Map()) as Promise<FlowOutputOf<Name> | undefined>;\n    }\n\n    // Extract session info from MCP handler context (input.ctx.authInfo)\n    // MCP handlers pass { request, ctx } where ctx has authInfo\n    const mcpCtx = (input as any)?.ctx;\n    const authInfo = mcpCtx?.authInfo;\n\n    // Get session ID from authInfo (set by ensureAuthInfo in transport adapter)\n    // Fall back to anonymous session if not available\n    const rawSessionId = authInfo?.sessionId;\n    const sessionId =\n      typeof rawSessionId === 'string' && rawSessionId.trim().length > 0 ? rawSessionId.trim() : `anon:${randomUUID()}`;\n\n    const scope = this.providers.getActiveScope();\n\n    // Wrap flow execution in FrontMcpContext\n    return Promise.resolve(\n      contextStorage.run(\n        {\n          sessionId,\n          scopeId: scope.id,\n          authInfo,\n        },\n        async () => {\n          return flow.run(input, deps ?? new Map()) as Promise<FlowOutputOf<Name> | undefined>;\n        },\n      ),\n    );\n  }\n\n  /**\n   * Get FrontMcpContextStorage from providers (with fallback).\n   * Returns undefined if not available (backward compatibility).\n   */\n  private getContextStorage(): FrontMcpContextStorage | undefined {\n    try {\n      return this.providers.get(FrontMcpContextStorage);\n    } catch {\n      return undefined;\n    }\n  }\n}\n"]}