@frontmcp/sdk 0.5.1 → 0.6.1

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":"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","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"]}

package/src/front-mcp/front-mcp.d.ts

@@ -9,4 +9,16 @@ export declare class FrontMcpInstance implements FrontMcpInterface {
     initialize(): Promise<void>;
     start(): void;
     static bootstrap(options: FrontMcpConfigType): Promise<void>;
+    /**
+     * Creates and initializes a FrontMCP instance without starting the HTTP server.
+     * Returns the underlying HTTP handler for serverless deployments (Vercel, Lambda).
+     *
+     * @example
+     * // In index.ts for Vercel
+     * import { FrontMcpInstance } from '@frontmcp/sdk';
+     * import config from '../src/main';
+     *
+     * export default FrontMcpInstance.createHandler(config);
+     */
+    static createHandler(options: FrontMcpConfigType): Promise<unknown>;
 }

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

@@ -18,9 +18,7 @@ class FrontMcpInstance {
         this.ready = this.initialize();
     }
     async initialize() {
-        this.providers = new provider_registry_1.default([
-            ...(0, front_mcp_providers_1.createMcpGlobalProviders)(this.config),
-        ]);
+        this.providers = new provider_registry_1.default([...(0, front_mcp_providers_1.createMcpGlobalProviders)(this.config)]);
         await this.providers.ready;
         this.logger = new logger_registry_1.default(this.providers);
         await this.logger.ready;
@@ -39,6 +37,27 @@ class FrontMcpInstance {
         await frontMcp.ready;
         frontMcp.start();
     }
+    /**
+     * Creates and initializes a FrontMCP instance without starting the HTTP server.
+     * Returns the underlying HTTP handler for serverless deployments (Vercel, Lambda).
+     *
+     * @example
+     * // In index.ts for Vercel
+     * import { FrontMcpInstance } from '@frontmcp/sdk';
+     * import config from '../src/main';
+     *
+     * export default FrontMcpInstance.createHandler(config);
+     */
+    static async createHandler(options) {
+        const frontMcp = new FrontMcpInstance(options);
+        await frontMcp.ready;
+        const server = frontMcp.providers.get(common_1.FrontMcpServer);
+        if (!server) {
+            throw new Error('Server not found');
+        }
+        server.prepare();
+        return server.getHandler();
+    }
 }
 exports.FrontMcpInstance = FrontMcpInstance;
 //# sourceMappingURL=front-mcp.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"front-mcp.js","sourceRoot":"","sources":["../../../src/front-mcp/front-mcp.ts"],"names":[],"mappings":";;;;AAAA,sCAAgF;AAChF,4DAAsD;AACtD,8FAA6D;AAC7D,+DAA+D;AAC/D,wFAAuD;AAEvD,MAAa,gBAAgB;IAC3B,MAAM,CAAqB;IAClB,KAAK,CAAgB;IAEtB,MAAM,CAAiB;IACvB,SAAS,CAAmB;IAC5B,MAAM,CAAgB;IAE9B,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,UAAU;QAEd,IAAI,CAAC,SAAS,GAAG,IAAI,2BAAgB,CAAC;YACpC,GAAG,IAAA,8CAAwB,EAAC,IAAI,CAAC,MAAM,CAAC;SACzC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAE3B,IAAI,CAAC,MAAM,GAAG,IAAI,yBAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAExB,IAAI,CAAC,MAAM,GAAG,IAAI,8BAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAE1B,CAAC;IAED,KAAK;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,uBAAc,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,OAA2B;QACvD,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,QAAQ,CAAC,KAAK,CAAC;QAErB,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;CACF;AA1CD,4CA0CC","sourcesContent":["import {FrontMcpConfigType, FrontMcpInterface, FrontMcpServer} from '../common';\nimport {ScopeRegistry} from '../scope/scope.registry';\nimport ProviderRegistry from '../provider/provider.registry';\nimport {createMcpGlobalProviders} from './front-mcp.providers';\nimport LoggerRegistry from '../logger/logger.registry';\n\nexport class FrontMcpInstance implements FrontMcpInterface {\n  config: FrontMcpConfigType;\n  readonly ready: Promise<void>;\n\n  private logger: LoggerRegistry;\n  private providers: ProviderRegistry;\n  private scopes: ScopeRegistry;\n\n  constructor(config: FrontMcpConfigType) {\n    this.config = config;\n    this.ready = this.initialize();\n  }\n\n  async initialize(): Promise<void> {\n\n    this.providers = new ProviderRegistry([\n      ...createMcpGlobalProviders(this.config),\n    ]);\n    await this.providers.ready;\n\n    this.logger = new LoggerRegistry(this.providers);\n    await this.logger.ready;\n\n    this.scopes = new ScopeRegistry(this.providers);\n    await this.scopes.ready;\n\n  }\n\n  start() {\n    const server = this.providers.get(FrontMcpServer);\n    if (!server) {\n      throw new Error('Server not found');\n    }\n    server.start();\n  }\n\n  public static async bootstrap(options: FrontMcpConfigType) {\n    const frontMcp = new FrontMcpInstance(options);\n    await frontMcp.ready;\n\n    frontMcp.start();\n  }\n}\n"]}
+{"version":3,"file":"front-mcp.js","sourceRoot":"","sources":["../../../src/front-mcp/front-mcp.ts"],"names":[],"mappings":";;;;AAAA,sCAAkF;AAClF,4DAAwD;AACxD,8FAA6D;AAC7D,+DAAiE;AACjE,wFAAuD;AAEvD,MAAa,gBAAgB;IAC3B,MAAM,CAAqB;IAClB,KAAK,CAAgB;IAEtB,MAAM,CAAiB;IACvB,SAAS,CAAmB;IAC5B,MAAM,CAAgB;IAE9B,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,SAAS,GAAG,IAAI,2BAAgB,CAAC,CAAC,GAAG,IAAA,8CAAwB,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAClF,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAE3B,IAAI,CAAC,MAAM,GAAG,IAAI,yBAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAExB,IAAI,CAAC,MAAM,GAAG,IAAI,8BAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,KAAK;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,uBAAc,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,OAA2B;QACvD,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,QAAQ,CAAC,KAAK,CAAC;QAErB,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAED;;;;;;;;;;OAUG;IACI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,OAA2B;QAC3D,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,QAAQ,CAAC,KAAK,CAAC;QAErB,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,uBAAc,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;CACF;AA9DD,4CA8DC","sourcesContent":["import { FrontMcpConfigType, FrontMcpInterface, FrontMcpServer } from '../common';\nimport { ScopeRegistry } from '../scope/scope.registry';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { createMcpGlobalProviders } from './front-mcp.providers';\nimport LoggerRegistry from '../logger/logger.registry';\n\nexport class FrontMcpInstance implements FrontMcpInterface {\n  config: FrontMcpConfigType;\n  readonly ready: Promise<void>;\n\n  private logger: LoggerRegistry;\n  private providers: ProviderRegistry;\n  private scopes: ScopeRegistry;\n\n  constructor(config: FrontMcpConfigType) {\n    this.config = config;\n    this.ready = this.initialize();\n  }\n\n  async initialize(): Promise<void> {\n    this.providers = new ProviderRegistry([...createMcpGlobalProviders(this.config)]);\n    await this.providers.ready;\n\n    this.logger = new LoggerRegistry(this.providers);\n    await this.logger.ready;\n\n    this.scopes = new ScopeRegistry(this.providers);\n    await this.scopes.ready;\n  }\n\n  start() {\n    const server = this.providers.get(FrontMcpServer);\n    if (!server) {\n      throw new Error('Server not found');\n    }\n    server.start();\n  }\n\n  public static async bootstrap(options: FrontMcpConfigType) {\n    const frontMcp = new FrontMcpInstance(options);\n    await frontMcp.ready;\n\n    frontMcp.start();\n  }\n\n  /**\n   * Creates and initializes a FrontMCP instance without starting the HTTP server.\n   * Returns the underlying HTTP handler for serverless deployments (Vercel, Lambda).\n   *\n   * @example\n   * // In index.ts for Vercel\n   * import { FrontMcpInstance } from '@frontmcp/sdk';\n   * import config from '../src/main';\n   *\n   * export default FrontMcpInstance.createHandler(config);\n   */\n  public static async createHandler(options: FrontMcpConfigType): Promise<unknown> {\n    const frontMcp = new FrontMcpInstance(options);\n    await frontMcp.ready;\n\n    const server = frontMcp.providers.get(FrontMcpServer);\n    if (!server) {\n      throw new Error('Server not found');\n    }\n\n    server.prepare();\n    return server.getHandler();\n  }\n}\n"]}