@frontmcp/sdk 0.5.0 → 0.6.0

package/src/common/interfaces/execution-context.interface.js

@@ -4,13 +4,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExecutionContextBase = void 0;
 const crypto_1 = require("crypto");
 const flow_interface_1 = require("./flow.interface");
+const context_1 = require("../../context");
+const mcp_error_1 = require("../../errors/mcp.error");
 /**
  * Abstract base class for execution contexts (tools, resources, prompts, etc.).
  * Provides common functionality for dependency injection, logging, and flow control.
  */
 class ExecutionContextBase {
     providers;
-    authInfo;
+    /**
+     * @deprecated Use `context.authInfo` instead. Will be removed in v2.0.
+     */
+    _authInfo;
     /** Unique identifier for this execution run */
     runId;
     logger;
@@ -23,7 +28,75 @@ class ExecutionContextBase {
         this.runId = (0, crypto_1.randomUUID)();
         this.providers = providers;
         this.logger = logger;
-        this.authInfo = authInfo;
+        this._authInfo = authInfo;
+    }
+    /**
+     * Get the current FrontMcpContext.
+     *
+     * Provides access to requestId, traceId, sessionId, authInfo,
+     * timing marks, request metadata, transport, and context-aware fetch.
+     *
+     * @throws RequestContextNotAvailableError if called outside of a context scope
+     */
+    get context() {
+        try {
+            return this.providers.get(context_1.FRONTMCP_CONTEXT);
+        }
+        catch {
+            // Context not available (likely called during initialization or outside request scope)
+            throw new mcp_error_1.RequestContextNotAvailableError();
+        }
+    }
+    /**
+     * Try to get the context, returning undefined if not available.
+     *
+     * Use this when context may not be available (e.g., during initialization).
+     */
+    tryGetContext() {
+        try {
+            return this.providers.get(context_1.FRONTMCP_CONTEXT);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * @deprecated Use `context.authInfo` instead. Will be removed in v2.0.
+     *
+     * Get authentication information for the current request.
+     */
+    get authInfo() {
+        return this._authInfo;
+    }
+    /**
+     * Get authentication information for the current request.
+     *
+     * Prefers context.authInfo when available (the recommended source),
+     * falls back to the legacy authInfo property for backward compatibility.
+     *
+     * Returns Partial<AuthInfo> because auth info is progressively populated
+     * during the request lifecycle. Callers should check for required fields.
+     */
+    getAuthInfo() {
+        const ctx = this.tryGetContext();
+        if (ctx) {
+            return ctx.authInfo;
+        }
+        return this._authInfo;
+    }
+    /**
+     * Get a child logger with request context attached.
+     *
+     * The logger includes requestId, traceId, and sessionId in its context.
+     */
+    get contextLogger() {
+        try {
+            return this.context.getLogger(this.logger);
+        }
+        catch {
+            // Fallback if context not available
+            return this.logger;
+        }
     }
     /**
      * Get a dependency from the provider registry.
@@ -65,9 +138,21 @@ class ExecutionContextBase {
         this.activeStage = stage;
     }
     /**
-     * Fetch a URL using the standard fetch API.
+     * Fetch a URL with context-aware header injection.
+     *
+     * When FrontMcpContext is available, delegates to ctx.fetch() which:
+     * - Auto-injects Authorization header (if authInfo.token is available)
+     * - Auto-injects W3C traceparent header for distributed tracing
+     * - Auto-injects x-request-id header
+     * - Auto-injects custom headers from request metadata
+     *
+     * Falls back to standard fetch if context is not available.
      */
     fetch(input, init) {
+        const ctx = this.tryGetContext();
+        if (ctx) {
+            return ctx.fetch(input, init);
+        }
         return fetch(input, init);
     }
     /**

package/src/common/interfaces/execution-context.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution-context.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/execution-context.interface.ts"],"names":[],"mappings":";AAAA,sEAAsE;;;AAEtE,mCAAoC;AAIpC,qDAA+C;AAc/C;;;GAGG;AACH,MAAsB,oBAAoB;IAChC,SAAS,CAA4B;IACpC,QAAQ,CAAW;IAE5B,+CAA+C;IAC5B,KAAK,CAAS;IACd,MAAM,CAAiB;IAE1C,gDAAgD;IACtC,WAAW,GAAG,MAAM,CAAC;IAE/B,gCAAgC;IACxB,MAAM,CAAS;IAEvB,YAAY,IAA8B;QACxC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAA,mBAAU,GAAE,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,GAAG,CAAI,KAAe;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,MAAM,CAAI,KAAe;QACvB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;OAEG;IACO,IAAI,CAAC,GAAU;QACvB,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;QAClB,4BAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAwB,EAAE,IAAkB;QAChD,OAAO,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,IAAc,KAAK;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AA9ED,oDA8EC","sourcesContent":["// file: libs/sdk/src/common/interfaces/execution-context.interface.ts\n\nimport { randomUUID } from 'crypto';\nimport { Token } from './base.interface';\nimport { ProviderRegistryInterface } from './internal';\nimport { FrontMcpLogger } from './logger.interface';\nimport { FlowControl } from './flow.interface';\nimport { URL } from 'url';\nimport { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';\nimport { ScopeEntry } from '../entries';\n\n/**\n * Base constructor arguments for all execution contexts.\n */\nexport type ExecutionContextBaseArgs = {\n  providers: ProviderRegistryInterface;\n  logger: FrontMcpLogger;\n  authInfo: AuthInfo;\n};\n\n/**\n * Abstract base class for execution contexts (tools, resources, prompts, etc.).\n * Provides common functionality for dependency injection, logging, and flow control.\n */\nexport abstract class ExecutionContextBase<Out = unknown> {\n  private providers: ProviderRegistryInterface;\n  readonly authInfo: AuthInfo;\n\n  /** Unique identifier for this execution run */\n  protected readonly runId: string;\n  protected readonly logger: FrontMcpLogger;\n\n  /** Current stage name for tracking/debugging */\n  protected activeStage = 'init';\n\n  /** Error if execution failed */\n  private _error?: Error;\n\n  constructor(args: ExecutionContextBaseArgs) {\n    const { providers, logger, authInfo } = args;\n    this.runId = randomUUID();\n    this.providers = providers;\n    this.logger = logger;\n    this.authInfo = authInfo;\n  }\n\n  /**\n   * Get a dependency from the provider registry.\n   * @throws Error if the dependency is not found\n   */\n  get<T>(token: Token<T>): T {\n    return this.providers.get(token);\n  }\n\n  /**\n   * Get the current scope.\n   */\n  get scope(): ScopeEntry {\n    return this.providers.getScope();\n  }\n\n  /**\n   * Try to get a dependency, returning undefined if not found.\n   */\n  tryGet<T>(token: Token<T>): T | undefined {\n    try {\n      return this.providers.get(token);\n    } catch (e) {\n      const msg = e instanceof Error ? e.message : String(e);\n      this.logger.warn(`Failed to get provider ${String(token)}: ${msg}`);\n      return undefined;\n    }\n  }\n\n  /**\n   * Fail the execution and trigger error handling.\n   */\n  protected fail(err: Error): never {\n    this._error = err;\n    FlowControl.fail(err);\n  }\n\n  /**\n   * Mark the current execution stage (for debugging/tracking).\n   */\n  mark(stage: string): void {\n    this.activeStage = stage;\n  }\n\n  /**\n   * Fetch a URL using the standard fetch API.\n   */\n  fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response> {\n    return fetch(input, init);\n  }\n\n  /**\n   * Get the current error, if any.\n   */\n  protected get error(): Error | undefined {\n    return this._error;\n  }\n}\n"]}
+{"version":3,"file":"execution-context.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/execution-context.interface.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/common/interfaces/execution-context.interface.ts\n\nimport { randomUUID } from 'crypto';\nimport { Token } from './base.interface';\nimport { ProviderRegistryInterface } from './internal';\nimport { FrontMcpLogger } from './logger.interface';\nimport { FlowControl } from './flow.interface';\nimport { URL } from 'url';\nimport { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';\nimport { ScopeEntry } from '../entries';\nimport { FrontMcpContext, FRONTMCP_CONTEXT } from '../../context';\nimport { RequestContextNotAvailableError } from '../../errors/mcp.error';\n\n/**\n * Base constructor arguments for all execution contexts.\n */\nexport type ExecutionContextBaseArgs = {\n  providers: ProviderRegistryInterface;\n  logger: FrontMcpLogger;\n  authInfo: Partial<AuthInfo>;\n};\n\n/**\n * Abstract base class for execution contexts (tools, resources, prompts, etc.).\n * Provides common functionality for dependency injection, logging, and flow control.\n */\nexport abstract class ExecutionContextBase<Out = unknown> {\n  private providers: ProviderRegistryInterface;\n\n  /**\n   * @deprecated Use `context.authInfo` instead. Will be removed in v2.0.\n   */\n  private readonly _authInfo: Partial<AuthInfo>;\n\n  /** Unique identifier for this execution run */\n  protected readonly runId: string;\n  protected readonly logger: FrontMcpLogger;\n\n  /** Current stage name for tracking/debugging */\n  protected activeStage = 'init';\n\n  /** Error if execution failed */\n  private _error?: Error;\n\n  constructor(args: ExecutionContextBaseArgs) {\n    const { providers, logger, authInfo } = args;\n    this.runId = randomUUID();\n    this.providers = providers;\n    this.logger = logger;\n    this._authInfo = authInfo;\n  }\n\n  /**\n   * Get the current FrontMcpContext.\n   *\n   * Provides access to requestId, traceId, sessionId, authInfo,\n   * timing marks, request metadata, transport, and context-aware fetch.\n   *\n   * @throws RequestContextNotAvailableError if called outside of a context scope\n   */\n  get context(): FrontMcpContext {\n    try {\n      return this.providers.get(FRONTMCP_CONTEXT as Token<FrontMcpContext>);\n    } catch {\n      // Context not available (likely called during initialization or outside request scope)\n      throw new RequestContextNotAvailableError();\n    }\n  }\n\n  /**\n   * Try to get the context, returning undefined if not available.\n   *\n   * Use this when context may not be available (e.g., during initialization).\n   */\n  tryGetContext(): FrontMcpContext | undefined {\n    try {\n      return this.providers.get(FRONTMCP_CONTEXT as Token<FrontMcpContext>);\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * @deprecated Use `context.authInfo` instead. Will be removed in v2.0.\n   *\n   * Get authentication information for the current request.\n   */\n  get authInfo(): Partial<AuthInfo> {\n    return this._authInfo;\n  }\n\n  /**\n   * Get authentication information for the current request.\n   *\n   * Prefers context.authInfo when available (the recommended source),\n   * falls back to the legacy authInfo property for backward compatibility.\n   *\n   * Returns Partial<AuthInfo> because auth info is progressively populated\n   * during the request lifecycle. Callers should check for required fields.\n   */\n  getAuthInfo(): Partial<AuthInfo> {\n    const ctx = this.tryGetContext();\n    if (ctx) {\n      return ctx.authInfo;\n    }\n    return this._authInfo;\n  }\n\n  /**\n   * Get a child logger with request context attached.\n   *\n   * The logger includes requestId, traceId, and sessionId in its context.\n   */\n  protected get contextLogger(): FrontMcpLogger {\n    try {\n      return this.context.getLogger(this.logger);\n    } catch {\n      // Fallback if context not available\n      return this.logger;\n    }\n  }\n\n  /**\n   * Get a dependency from the provider registry.\n   * @throws Error if the dependency is not found\n   */\n  get<T>(token: Token<T>): T {\n    return this.providers.get(token);\n  }\n\n  /**\n   * Get the current scope.\n   */\n  get scope(): ScopeEntry {\n    return this.providers.getScope();\n  }\n\n  /**\n   * Try to get a dependency, returning undefined if not found.\n   */\n  tryGet<T>(token: Token<T>): T | undefined {\n    try {\n      return this.providers.get(token);\n    } catch (e) {\n      const msg = e instanceof Error ? e.message : String(e);\n      this.logger.warn(`Failed to get provider ${String(token)}: ${msg}`);\n      return undefined;\n    }\n  }\n\n  /**\n   * Fail the execution and trigger error handling.\n   */\n  protected fail(err: Error): never {\n    this._error = err;\n    FlowControl.fail(err);\n  }\n\n  /**\n   * Mark the current execution stage (for debugging/tracking).\n   */\n  mark(stage: string): void {\n    this.activeStage = stage;\n  }\n\n  /**\n   * Fetch a URL with context-aware header injection.\n   *\n   * When FrontMcpContext is available, delegates to ctx.fetch() which:\n   * - Auto-injects Authorization header (if authInfo.token is available)\n   * - Auto-injects W3C traceparent header for distributed tracing\n   * - Auto-injects x-request-id header\n   * - Auto-injects custom headers from request metadata\n   *\n   * Falls back to standard fetch if context is not available.\n   */\n  fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response> {\n    const ctx = this.tryGetContext();\n    if (ctx) {\n      return ctx.fetch(input, init);\n    }\n    return fetch(input, init);\n  }\n\n  /**\n   * Get the current error, if any.\n   */\n  protected get error(): Error | undefined {\n    return this._error;\n  }\n}\n"]}

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

@@ -4,6 +4,7 @@ import { z } from 'zod';
 import { HookEntry, ScopeEntry } from '../entries';
 import { FlowStateOf } from './internal/flow.utils';
 import { FrontMcpLogger } from './logger.interface';
+import type { FrontMcpContext } from '../../context/frontmcp-context';
 export type FlowInputOf<N extends FlowName> = z.infer<ExtendFlows[N]['input']>;
 export type FlowOutputOf<N extends FlowName> = z.infer<ExtendFlows[N]['output']>;
 export type FlowPlanOf<N extends FlowName> = ExtendFlows[N]['plan'];
@@ -37,5 +38,17 @@ export declare abstract class FlowBase<N extends FlowName = FlowName> {
     protected abort(message: string): void;
     protected next(): void;
     protected handled(): void;
+    /**
+     * Get the current FrontMcpContext from AsyncLocalStorage.
+     * Available in all stages after context initialization.
+     *
+     * @throws Error if not in a context scope
+     */
+    protected get context(): FrontMcpContext;
+    /**
+     * Safely try to get FrontMcpContext (returns undefined if not available).
+     * Use this when context might not be available (e.g., non-HTTP flows).
+     */
+    protected tryGetContext(): FrontMcpContext | undefined;
 }
 export type FlowType<Provide = FlowBase<any>> = Type<Provide>;

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FlowBase = exports.FlowControl = void 0;
 const flow_utils_1 = require("./internal/flow.utils");
+const frontmcp_context_storage_1 = require("../../context/frontmcp-context-storage");
 class FlowControl extends Error {
     type;
     output;
@@ -66,6 +67,29 @@ class FlowBase {
     handled() {
         throw FlowControl.handled();
     }
+    /**
+     * Get the current FrontMcpContext from AsyncLocalStorage.
+     * Available in all stages after context initialization.
+     *
+     * @throws Error if not in a context scope
+     */
+    get context() {
+        const storage = this.scope.providers.get(frontmcp_context_storage_1.FrontMcpContextStorage);
+        return storage.getStoreOrThrow();
+    }
+    /**
+     * Safely try to get FrontMcpContext (returns undefined if not available).
+     * Use this when context might not be available (e.g., non-HTTP flows).
+     */
+    tryGetContext() {
+        try {
+            const storage = this.scope.providers.get(frontmcp_context_storage_1.FrontMcpContextStorage);
+            return storage.getStore();
+        }
+        catch {
+            return undefined;
+        }
+    }
 }
 exports.FlowBase = FlowBase;
 //# sourceMappingURL=flow.interface.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"flow.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/flow.interface.ts"],"names":[],"mappings":";;;AAIA,sDAA+D;AAY/D,MAAa,WAAY,SAAQ,KAAK;IACR;IAAuC;IAAnE,YAA4B,IAAqB,EAAkB,MAAW;QAC5E,KAAK,EAAE,CAAC;QADkB,SAAI,GAAJ,IAAI,CAAiB;QAAkB,WAAM,GAAN,MAAM,CAAK;IAE9E,CAAC;IAED,MAAM,CAAC,OAAO,CAAI,MAAS;QACzB,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,IAAI;QACT,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,OAAO;QACZ,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAY;QACtB,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAc;QACzB,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;CACF;AAxBD,kCAwBC;AAED,uCAAuC;AACvC,MAAsB,QAAQ;IAMP;IACV;IACU;IACA;IACA;IATX,KAAK,CAAiB;IAChC,KAAK,GAAmB,sBAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7C,WAAW,CAAiB;IAE5B,YACqB,QAAyB,EACnC,QAAuC,EAC7B,KAAiB,EACjB,kBAAgD,EAChD,OAAoC,IAAI,GAAG,EAAE;QAJ7C,aAAQ,GAAR,QAAQ,CAAiB;QACnC,aAAQ,GAAR,QAAQ,CAA+B;QAC7B,UAAK,GAAL,KAAK,CAAY;QACjB,uBAAkB,GAAlB,kBAAkB,CAA8B;QAChD,SAAI,GAAJ,IAAI,CAAyC;QAEhE,IAAI,CAAC,KAAK,GAAI,QAAQ,CAAC,WAAmB,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;IAClC,CAAC;IAED,GAAG,CAAI,KAAe;QACpB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAM,CAAC;QAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,CAAC,MAAuB;QAC7B,MAAM,WAAW,CAAC,OAAO,CAAE,IAAI,CAAC,QAAQ,CAAC,YAAiC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,IAAI,CAAC,KAAY;QACf,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAES,KAAK,CAAC,OAAe;QAC7B,MAAM,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAES,IAAI;QACZ,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAES,OAAO;QACf,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;CACF;AAxCD,4BAwCC","sourcesContent":["import { Token, Type } from './base.interface';\nimport { FlowMetadata, FlowName } from '../metadata';\nimport { z } from 'zod';\nimport { HookEntry, ScopeEntry } from '../entries';\nimport { FlowState, FlowStateOf } from './internal/flow.utils';\nimport { FrontMcpLogger } from './logger.interface';\n\nexport type FlowInputOf<N extends FlowName> = z.infer<ExtendFlows[N]['input']>;\nexport type FlowOutputOf<N extends FlowName> = z.infer<ExtendFlows[N]['output']>;\nexport type FlowPlanOf<N extends FlowName> = ExtendFlows[N]['plan'];\nexport type FlowCtxOf<N extends FlowName> = ExtendFlows[N]['ctx'];\nexport type FlowStagesOf<N extends FlowName> = ExtendFlows[N]['stage'];\nexport type FlowExecuteStagesOf<N extends FlowName> = ExtendFlows[N]['executeStage'];\n\nexport type FlowControlType = 'respond' | 'fail' | 'abort' | 'next' | 'handled';\n\nexport class FlowControl extends Error {\n  constructor(public readonly type: FlowControlType, public readonly output: any) {\n    super();\n  }\n\n  static respond<T>(output: T): never {\n    throw new FlowControl('respond', output);\n  }\n\n  static next(): never {\n    throw new FlowControl('next', null);\n  }\n\n  static handled(): never {\n    throw new FlowControl('handled', null);\n  }\n\n  static fail(error: Error): never {\n    throw new FlowControl('fail', { error: error.message });\n  }\n\n  static abort(reason: string): never {\n    throw new FlowControl('abort', reason);\n  }\n}\n\n// 1) The actual abstract class (value)\nexport abstract class FlowBase<N extends FlowName = FlowName> {\n  protected input: FlowInputOf<N>;\n  state: FlowStateOf<N> = FlowState.create({});\n  scopeLogger: FrontMcpLogger;\n\n  constructor(\n    protected readonly metadata: FlowMetadata<N>,\n    readonly rawInput: Partial<FlowInputOf<N>> | any,\n    protected readonly scope: ScopeEntry,\n    protected readonly appendContextHooks: (hooks: HookEntry[]) => void,\n    protected readonly deps: ReadonlyMap<Token, unknown> = new Map(),\n  ) {\n    this.input = (metadata.inputSchema as any)?.parse?.(rawInput);\n    this.scopeLogger = scope.logger;\n  }\n\n  get<T>(token: Token<T>): T {\n    if (this.deps.has(token)) return this.deps.get(token) as T;\n    return this.scope.providers.get(token);\n  }\n\n  respond(output: FlowOutputOf<N>) {\n    throw FlowControl.respond((this.metadata.outputSchema as z.ZodObject<any>).parse(output));\n  }\n\n  fail(error: Error) {\n    throw FlowControl.fail(error);\n  }\n\n  protected abort(message: string) {\n    throw FlowControl.abort(message);\n  }\n\n  protected next() {\n    throw FlowControl.next();\n  }\n\n  protected handled() {\n    throw FlowControl.handled();\n  }\n}\n\nexport type FlowType<Provide = FlowBase<any>> = Type<Provide>;\n"]}
+{"version":3,"file":"flow.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/flow.interface.ts"],"names":[],"mappings":"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","sourcesContent":["import { Token, Type } from './base.interface';\nimport { FlowMetadata, FlowName } from '../metadata';\nimport { z } from 'zod';\nimport { HookEntry, ScopeEntry } from '../entries';\nimport { FlowState, FlowStateOf } from './internal/flow.utils';\nimport { FrontMcpLogger } from './logger.interface';\nimport type { FrontMcpContext } from '../../context/frontmcp-context';\nimport { FrontMcpContextStorage } from '../../context/frontmcp-context-storage';\n\nexport type FlowInputOf<N extends FlowName> = z.infer<ExtendFlows[N]['input']>;\nexport type FlowOutputOf<N extends FlowName> = z.infer<ExtendFlows[N]['output']>;\nexport type FlowPlanOf<N extends FlowName> = ExtendFlows[N]['plan'];\nexport type FlowCtxOf<N extends FlowName> = ExtendFlows[N]['ctx'];\nexport type FlowStagesOf<N extends FlowName> = ExtendFlows[N]['stage'];\nexport type FlowExecuteStagesOf<N extends FlowName> = ExtendFlows[N]['executeStage'];\n\nexport type FlowControlType = 'respond' | 'fail' | 'abort' | 'next' | 'handled';\n\nexport class FlowControl extends Error {\n  constructor(public readonly type: FlowControlType, public readonly output: any) {\n    super();\n  }\n\n  static respond<T>(output: T): never {\n    throw new FlowControl('respond', output);\n  }\n\n  static next(): never {\n    throw new FlowControl('next', null);\n  }\n\n  static handled(): never {\n    throw new FlowControl('handled', null);\n  }\n\n  static fail(error: Error): never {\n    throw new FlowControl('fail', { error: error.message });\n  }\n\n  static abort(reason: string): never {\n    throw new FlowControl('abort', reason);\n  }\n}\n\n// 1) The actual abstract class (value)\nexport abstract class FlowBase<N extends FlowName = FlowName> {\n  protected input: FlowInputOf<N>;\n  state: FlowStateOf<N> = FlowState.create({});\n  scopeLogger: FrontMcpLogger;\n\n  constructor(\n    protected readonly metadata: FlowMetadata<N>,\n    readonly rawInput: Partial<FlowInputOf<N>> | any,\n    protected readonly scope: ScopeEntry,\n    protected readonly appendContextHooks: (hooks: HookEntry[]) => void,\n    protected readonly deps: ReadonlyMap<Token, unknown> = new Map(),\n  ) {\n    this.input = (metadata.inputSchema as any)?.parse?.(rawInput);\n    this.scopeLogger = scope.logger;\n  }\n\n  get<T>(token: Token<T>): T {\n    if (this.deps.has(token)) return this.deps.get(token) as T;\n    return this.scope.providers.get(token);\n  }\n\n  respond(output: FlowOutputOf<N>) {\n    throw FlowControl.respond((this.metadata.outputSchema as z.ZodObject<any>).parse(output));\n  }\n\n  fail(error: Error) {\n    throw FlowControl.fail(error);\n  }\n\n  protected abort(message: string) {\n    throw FlowControl.abort(message);\n  }\n\n  protected next() {\n    throw FlowControl.next();\n  }\n\n  protected handled() {\n    throw FlowControl.handled();\n  }\n\n  /**\n   * Get the current FrontMcpContext from AsyncLocalStorage.\n   * Available in all stages after context initialization.\n   *\n   * @throws Error if not in a context scope\n   */\n  protected get context(): FrontMcpContext {\n    const storage = this.scope.providers.get(FrontMcpContextStorage);\n    return storage.getStoreOrThrow();\n  }\n\n  /**\n   * Safely try to get FrontMcpContext (returns undefined if not available).\n   * Use this when context might not be available (e.g., non-HTTP flows).\n   */\n  protected tryGetContext(): FrontMcpContext | undefined {\n    try {\n      const storage = this.scope.providers.get(FrontMcpContextStorage);\n      return storage.getStore();\n    } catch {\n      return undefined;\n    }\n  }\n}\n\nexport type FlowType<Provide = FlowBase<any>> = Type<Provide>;\n"]}

package/src/common/interfaces/server.interface.d.ts

@@ -39,6 +39,15 @@ export declare abstract class FrontMcpServer {
      * with the gateway's request/response processing.
      */
     abstract enhancedHandler(handler: ServerRequestHandler): (req: any, res: any, next: () => any) => Promise<void> | void;
+    /**
+     * Prepares the server routes without starting the HTTP listener.
+     * Used for serverless deployments (Vercel, AWS Lambda, etc.)
+     */
+    abstract prepare(): void;
+    /**
+     * Returns the underlying HTTP handler for serverless exports.
+     */
+    abstract getHandler(): unknown;
     /**
      *  Start the server on the specified port
      */

package/src/common/interfaces/server.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/server.interface.ts"],"names":[],"mappings":";;;AAAA,+BAA6E;AAK7E,MAAa,aAAc,SAAQ,sBAAe;IAEhD,IAAI,CAAS;IAGb,KAAK,CAAoC;IACzC,IAAI,CAAO;IACX,WAAW,CAAiB;CAC7B;AARD,sCAQC;AAED,MAAsB,cAAe,SAAQ,qBAAkB;CAU9D;AAVD,wCAUC;AAMD,MAAsB,cAAc;CA+BnC;AA/BD,wCA+BC","sourcesContent":["import { IncomingMessage, ServerResponse as HttpServerResponse } from 'http';\nimport { Authorization } from '../types'; // TODO: move to internal\n\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';\n\nexport class ServerRequest extends IncomingMessage {\n  declare method: HttpMethod;\n  path: string;\n  declare url: string;\n  declare headers: Record<string, string>;\n  query: Record<string, string | string[]>;\n  body?: any;\n  authSession?: Authorization;\n}\n\nexport abstract class ServerResponse extends HttpServerResponse {\n  abstract status(code: number): ServerResponse;\n\n  abstract json(payload: any): void;\n\n  abstract send(payload: any): void;\n\n  abstract redirect(url: string): void;\n\n  abstract redirect(status: number, url: string): void;\n}\n\nexport type NextFn = () => Promise<void> | void;\n\nexport type ServerRequestHandler = (req: ServerRequest, res: ServerResponse, next: NextFn) => Promise<void> | void;\n\nexport abstract class FrontMcpServer {\n\n  /**\n   * Register a middleware handler for a specific entry path.\n   * @param entryPath - e.g. '' or '/mcp'\n   * @param handler - (req, res, next) => {// middleware // next()}\n   */\n  abstract registerMiddleware(entryPath: string, handler: ServerRequestHandler): Promise<void> | void;\n\n  /**\n   * Register a route handler for a specific path.\n   * @param method - e.g. 'GET' or 'POST'\n   * @param path - e.g. '/mcp/invoke'\n   * @param handler - (req, res) => {// route handler // res.end() }\n   */\n  abstract registerRoute(method: HttpMethod, path: string, handler: ServerRequestHandler): Promise<void> | void;\n\n  /**\n   * Enhance a request handler with request/response processing and error handling.\n   * This handle will be stored as the first middleware in the chain to align adapter handler\n   * with the gateway's request/response processing.\n   */\n  abstract enhancedHandler(\n    handler: ServerRequestHandler,\n  ): (req: any, res: any, next: () => any) => Promise<void> | void;\n\n\n  /**\n   *  Start the server on the specified port\n   */\n  abstract start(port?: number): Promise<void> | void;\n}"]}
+{"version":3,"file":"server.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/server.interface.ts"],"names":[],"mappings":";;;AAAA,+BAA6E;AAK7E,MAAa,aAAc,SAAQ,sBAAe;IAEhD,IAAI,CAAS;IAGb,KAAK,CAAoC;IACzC,IAAI,CAAO;IACX,WAAW,CAAiB;CAC7B;AARD,sCAQC;AAED,MAAsB,cAAe,SAAQ,qBAAkB;CAU9D;AAVD,wCAUC;AAMD,MAAsB,cAAc;CAwCnC;AAxCD,wCAwCC","sourcesContent":["import { IncomingMessage, ServerResponse as HttpServerResponse } from 'http';\nimport { Authorization } from '../types'; // TODO: move to internal\n\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';\n\nexport class ServerRequest extends IncomingMessage {\n  declare method: HttpMethod;\n  path: string;\n  declare url: string;\n  declare headers: Record<string, string>;\n  query: Record<string, string | string[]>;\n  body?: any;\n  authSession?: Authorization;\n}\n\nexport abstract class ServerResponse extends HttpServerResponse {\n  abstract status(code: number): ServerResponse;\n\n  abstract json(payload: any): void;\n\n  abstract send(payload: any): void;\n\n  abstract redirect(url: string): void;\n\n  abstract redirect(status: number, url: string): void;\n}\n\nexport type NextFn = () => Promise<void> | void;\n\nexport type ServerRequestHandler = (req: ServerRequest, res: ServerResponse, next: NextFn) => Promise<void> | void;\n\nexport abstract class FrontMcpServer {\n  /**\n   * Register a middleware handler for a specific entry path.\n   * @param entryPath - e.g. '' or '/mcp'\n   * @param handler - (req, res, next) => {// middleware // next()}\n   */\n  abstract registerMiddleware(entryPath: string, handler: ServerRequestHandler): Promise<void> | void;\n\n  /**\n   * Register a route handler for a specific path.\n   * @param method - e.g. 'GET' or 'POST'\n   * @param path - e.g. '/mcp/invoke'\n   * @param handler - (req, res) => {// route handler // res.end() }\n   */\n  abstract registerRoute(method: HttpMethod, path: string, handler: ServerRequestHandler): Promise<void> | void;\n\n  /**\n   * Enhance a request handler with request/response processing and error handling.\n   * This handle will be stored as the first middleware in the chain to align adapter handler\n   * with the gateway's request/response processing.\n   */\n  abstract enhancedHandler(\n    handler: ServerRequestHandler,\n  ): (req: any, res: any, next: () => any) => Promise<void> | void;\n\n  /**\n   * Prepares the server routes without starting the HTTP listener.\n   * Used for serverless deployments (Vercel, AWS Lambda, etc.)\n   */\n  abstract prepare(): void;\n\n  /**\n   * Returns the underlying HTTP handler for serverless exports.\n   */\n  abstract getHandler(): unknown;\n\n  /**\n   *  Start the server on the specified port\n   */\n  abstract start(port?: number): Promise<void> | void;\n}\n"]}

package/src/common/metadata/app.metadata.d.ts

@@ -110,6 +110,19 @@ export declare const frontMcpLocalAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         mode: z.ZodLiteral<"transparent">;
@@ -146,6 +159,19 @@ export declare const frontMcpLocalAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         mode: z.ZodLiteral<"orchestrated">;
@@ -168,6 +194,7 @@ export declare const frontMcpLocalAppMetadataSchema: z.ZodObject<{
                 db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
                 tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
                 keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             }, z.core.$strip>;
         }, z.core.$strip>], "type">>;
         sessionMode: z.ZodDefault<z.ZodEnum<{
@@ -213,6 +240,19 @@ export declare const frontMcpLocalAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         mode: z.ZodLiteral<"orchestrated">;
@@ -252,6 +292,7 @@ export declare const frontMcpLocalAppMetadataSchema: z.ZodObject<{
                 db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
                 tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
                 keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             }, z.core.$strip>;
         }, z.core.$strip>], "type">>;
         sessionMode: z.ZodDefault<z.ZodEnum<{
@@ -297,6 +338,19 @@ export declare const frontMcpLocalAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>]>>;
     standalone: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"includeInParent">, z.ZodBoolean]>>>;
@@ -373,6 +427,19 @@ export declare const frontMcpRemoteAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         mode: z.ZodLiteral<"transparent">;
@@ -409,6 +476,19 @@ export declare const frontMcpRemoteAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         mode: z.ZodLiteral<"orchestrated">;
@@ -431,6 +511,7 @@ export declare const frontMcpRemoteAppMetadataSchema: z.ZodObject<{
                 db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
                 tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
                 keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             }, z.core.$strip>;
         }, z.core.$strip>], "type">>;
         sessionMode: z.ZodDefault<z.ZodEnum<{
@@ -476,6 +557,19 @@ export declare const frontMcpRemoteAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         mode: z.ZodLiteral<"orchestrated">;
@@ -515,6 +609,7 @@ export declare const frontMcpRemoteAppMetadataSchema: z.ZodObject<{
                 db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
                 tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
                 keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             }, z.core.$strip>;
         }, z.core.$strip>], "type">>;
         sessionMode: z.ZodDefault<z.ZodEnum<{
@@ -560,6 +655,19 @@ export declare const frontMcpRemoteAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>]>>;
     standalone: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"includeInParent">, z.ZodBoolean]>>>;