@frontmcp/sdk 0.2.5 → 0.3.0

package/src/scope/scope.instance.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Scope = void 0;
+const tslib_1 = require("tslib");
+require("reflect-metadata");
+const common_1 = require("../common");
+const app_registry_1 = tslib_1.__importDefault(require("../app/app.registry"));
+const provider_registry_1 = tslib_1.__importDefault(require("../provider/provider.registry"));
+const auth_registry_1 = require("../auth/auth.registry");
+const flow_registry_1 = tslib_1.__importDefault(require("../flows/flow.registry"));
+const http_request_flow_1 = tslib_1.__importDefault(require("./flows/http.request.flow"));
+const transport_registry_1 = require("../transport/transport.registry");
+const tool_registry_1 = tslib_1.__importDefault(require("../tool/tool.registry"));
+const hook_registry_1 = tslib_1.__importDefault(require("../hooks/hook.registry"));
+class Scope extends common_1.ScopeEntry {
+    id;
+    globalProviders;
+    logger;
+    scopeProviders;
+    scopeAuth;
+    scopeFlows;
+    scopeApps;
+    scopeHooks;
+    scopeTools;
+    transportService; // TODO: migrate transport service to transport.registry
+    entryPath;
+    routeBase = '';
+    orchestrated = false;
+    server;
+    constructor(rec, globalProviders) {
+        super(rec, rec.provide);
+        this.id = rec.metadata.id;
+        this.logger = globalProviders.get(common_1.FrontMcpLogger).child('FrontMcp.MultiAppScope');
+        this.globalProviders = globalProviders;
+        this.server = this.globalProviders.get(common_1.FrontMcpServer);
+        this.entryPath = rec.metadata.http?.entryPath ?? '';
+        this.scopeProviders = new provider_registry_1.default(this.defaultScopeProviders, globalProviders);
+        this.ready = this.initialize();
+    }
+    async initialize() {
+        await this.scopeProviders.ready;
+        this.scopeHooks = new hook_registry_1.default(this.scopeProviders, []);
+        await this.scopeHooks.ready;
+        this.scopeFlows = new flow_registry_1.default(this.scopeProviders, [http_request_flow_1.default]);
+        await this.scopeFlows.ready;
+        this.transportService = new transport_registry_1.TransportService(this);
+        this.scopeAuth = new auth_registry_1.AuthRegistry(this.scopeProviders, [], {
+            kind: 'scope',
+            id: this.id,
+            ref: common_1.ScopeEntry,
+        }, this.metadata.auth);
+        await this.scopeAuth.ready;
+        this.scopeApps = new app_registry_1.default(this.scopeProviders, this.metadata.apps);
+        await this.scopeApps.ready;
+        this.scopeTools = new tool_registry_1.default(this.scopeProviders, [], { kind: 'scope', id: this.id, ref: Scope });
+        await this.scopeTools.ready;
+        await this.auth.ready;
+        this.logger.info('Initializing multi-app scope', this.metadata);
+        if (!this.metadata.auth) {
+            // log large warning about using FrontMcp without authentication
+            this.logger.warn(`\n\n*******************************\n  WARNING: FrontMcp is running without authentication. \n  This is a security risk and should only be used in development environments. \n*******************************\n\n`);
+        }
+    }
+    get defaultScopeProviders() {
+        return [{
+                scope: common_1.ProviderScope.GLOBAL,
+                name: 'ScopeEntry',
+                provide: common_1.ScopeEntry,
+                useValue: this,
+            }, {
+                scope: common_1.ProviderScope.GLOBAL,
+                name: 'Scope',
+                provide: Scope,
+                useValue: this,
+            }, {
+                scope: common_1.ProviderScope.GLOBAL,
+                name: 'FrontMcpLogger',
+                provide: common_1.FrontMcpLogger,
+                useValue: this.logger,
+            }, {
+                scope: common_1.ProviderScope.SESSION,
+                name: 'SessionProvider',
+                provide: common_1.SessionProvider,
+                useClass: common_1.SessionProvider,
+            }];
+    }
+    get auth() {
+        return this.scopeAuth.getPrimary();
+    }
+    get hooks() {
+        return this.scopeHooks;
+    }
+    get authProviders() {
+        return this.scopeAuth;
+    }
+    get providers() {
+        return this.scopeProviders;
+    }
+    get apps() {
+        return this.scopeApps;
+    }
+    get tools() {
+        return this.scopeTools;
+    }
+    registryFlows(...flows) {
+        return this.scopeFlows.registryFlows(flows);
+    }
+    runFlow(name, input, deps) {
+        return this.scopeFlows.runFlow(name, input, deps);
+    }
+    async runFlowForOutput(name, input, deps) {
+        const result = await this.scopeFlows.runFlow(name, input, deps);
+        if (result) {
+            return result;
+        }
+        throw new Error(`flow exist without output`);
+    }
+}
+exports.Scope = Scope;
+//# sourceMappingURL=scope.instance.js.map

package/src/scope/scope.instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.instance.js","sourceRoot":"","sources":["../../../src/scope/scope.instance.ts"],"names":[],"mappings":"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","sourcesContent":["import 'reflect-metadata';\nimport {\n  FlowInputOf,\n  FlowName, FlowOutputOf,\n  FlowType,\n  FrontMcpAuth,\n  FrontMcpLogger,\n  FrontMcpServer, HookRegistryInterface,\n  ProviderScope,\n  ScopeEntry,\n  ScopeRecord,\n  SessionProvider,\n  Token,\n  Type,\n} from '../common';\nimport AppRegistry from '../app/app.registry';\nimport ProviderRegistry from '../provider/provider.registry';\nimport {AuthRegistry} from '../auth/auth.registry';\nimport FlowRegistry from '../flows/flow.registry';\nimport HttpRequestFlow from './flows/http.request.flow';\nimport {TransportService} from '../transport/transport.registry';\nimport ToolRegistry from '../tool/tool.registry';\nimport HookRegistry from \"../hooks/hook.registry\";\n\n\nexport class Scope extends ScopeEntry {\n  readonly id: string;\n  private readonly globalProviders: ProviderRegistry;\n  readonly logger: FrontMcpLogger;\n\n  private readonly scopeProviders: ProviderRegistry;\n  private scopeAuth: AuthRegistry;\n  private scopeFlows: FlowRegistry;\n  private scopeApps: AppRegistry;\n  private scopeHooks: HookRegistry;\n  private scopeTools: ToolRegistry;\n\n  transportService: TransportService; // TODO: migrate transport service to transport.registry\n  readonly entryPath: string;\n  readonly routeBase: string = '';\n  readonly orchestrated: boolean = false;\n\n  readonly server: FrontMcpServer;\n\n  constructor(rec: ScopeRecord, globalProviders: ProviderRegistry) {\n    super(rec, rec.provide);\n    this.id = rec.metadata.id;\n    this.logger = globalProviders.get(FrontMcpLogger).child('FrontMcp.MultiAppScope');\n    this.globalProviders = globalProviders;\n    this.server = this.globalProviders.get(FrontMcpServer);\n    this.entryPath = rec.metadata.http?.entryPath ?? '';\n    this.scopeProviders = new ProviderRegistry(this.defaultScopeProviders, globalProviders);\n    this.ready = this.initialize();\n  }\n\n  protected async initialize(): Promise<void> {\n    await this.scopeProviders.ready;\n\n    this.scopeHooks = new HookRegistry(this.scopeProviders, []);\n    await this.scopeHooks.ready;\n\n    this.scopeFlows = new FlowRegistry(this.scopeProviders, [HttpRequestFlow]);\n    await this.scopeFlows.ready;\n\n    this.transportService = new TransportService(this);\n\n    this.scopeAuth = new AuthRegistry(this.scopeProviders, [], {\n      kind: 'scope',\n      id: this.id,\n      ref: ScopeEntry,\n    }, this.metadata.auth);\n    await this.scopeAuth.ready\n\n    this.scopeApps = new AppRegistry(this.scopeProviders, this.metadata.apps);\n    await this.scopeApps.ready;\n\n    this.scopeTools = new ToolRegistry(this.scopeProviders, [], {kind: 'scope', id: this.id, ref: Scope});\n    await this.scopeTools.ready;\n\n\n    await this.auth.ready;\n    this.logger.info('Initializing multi-app scope', this.metadata);\n    if (!this.metadata.auth) {\n      // log large warning about using FrontMcp without authentication\n      this.logger.warn(`\\n\\n*******************************\\n  WARNING: FrontMcp is running without authentication. \\n  This is a security risk and should only be used in development environments. \\n*******************************\\n\\n`);\n    }\n  }\n\n  private get defaultScopeProviders() {\n    return [{\n      scope: ProviderScope.GLOBAL,\n      name: 'ScopeEntry',\n      provide: ScopeEntry,\n      useValue: this,\n    }, {\n      scope: ProviderScope.GLOBAL,\n      name: 'Scope',\n      provide: Scope,\n      useValue: this,\n    }, {\n      scope: ProviderScope.GLOBAL,\n      name: 'FrontMcpLogger',\n      provide: FrontMcpLogger,\n      useValue: this.logger,\n    }, {\n      scope: ProviderScope.SESSION,\n      name: 'SessionProvider',\n      provide: SessionProvider,\n      useClass: SessionProvider,\n    }];\n  }\n\n  get auth(): FrontMcpAuth {\n    return this.scopeAuth.getPrimary();\n  }\n\n  get hooks(): HookRegistryInterface {\n    return this.scopeHooks;\n  }\n\n  get authProviders(): AuthRegistry {\n    return this.scopeAuth;\n  }\n\n  get providers() {\n    return this.scopeProviders;\n  }\n\n  get apps(): AppRegistry {\n    return this.scopeApps;\n  }\n\n  get tools(): ToolRegistry {\n    return this.scopeTools;\n  }\n\n\n  registryFlows(...flows: FlowType[]) {\n    return this.scopeFlows.registryFlows(flows);\n  }\n\n  runFlow<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, deps?: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined> {\n    return this.scopeFlows.runFlow(name, input, deps);\n  }\n\n  async runFlowForOutput<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, deps?: Map<Token, Type>): Promise<FlowOutputOf<Name>> {\n    const result = await this.scopeFlows.runFlow(name, input, deps);\n    if (result) {\n      return result;\n    }\n    throw new Error(`flow exist without output`);\n  }\n}\n"]}

package/src/scope/scope.registry.d.ts

@@ -0,0 +1,10 @@
+import 'reflect-metadata';
+import { FrontMcpConfigType, ScopeEntry, ScopeRecord } from '../common';
+import { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';
+import ProviderRegistry from '../provider/provider.registry';
+export declare class ScopeRegistry extends RegistryAbstract<ScopeEntry, ScopeRecord, FrontMcpConfigType> {
+    constructor(globalProviders: ProviderRegistry);
+    protected buildMap(metadata: FrontMcpConfigType): RegistryBuildMapResult<ScopeRecord>;
+    protected buildGraph(): void;
+    protected initialize(): Promise<void>;
+}

package/src/scope/scope.registry.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopeRegistry = void 0;
+require("reflect-metadata");
+const common_1 = require("../common");
+const regsitry_1 = require("../regsitry");
+const front_mcp_tokens_1 = require("../front-mcp/front-mcp.tokens");
+const app_utils_1 = require("../app/app.utils");
+const scope_utils_1 = require("./scope.utils");
+const token_utils_1 = require("../utils/token.utils");
+class ScopeRegistry extends regsitry_1.RegistryAbstract {
+    constructor(globalProviders) {
+        const metadata = globalProviders.get(front_mcp_tokens_1.FrontMcpConfig);
+        super('ScopeRegistry', globalProviders, metadata);
+    }
+    buildMap(metadata) {
+        const tokens = new Set();
+        const defs = new Map();
+        const graph = new Map();
+        if (metadata.splitByApp) {
+            for (const raw of metadata.apps) {
+                const rec = (0, scope_utils_1.normalizeAppScope)(raw, metadata);
+                const provide = rec.provide;
+                tokens.add(provide);
+                defs.set(provide, rec);
+                graph.set(provide, new Set());
+            }
+        }
+        else {
+            const includeInParent = [];
+            for (const raw of metadata.apps) {
+                const app = (0, app_utils_1.normalizeApp)(raw);
+                const appMetadata = app.metadata;
+                if (appMetadata.standalone === false) {
+                    includeInParent.push(raw);
+                    // default include in parent scope
+                    continue;
+                }
+                if (appMetadata.standalone === 'includeInParent') {
+                    includeInParent.push(raw);
+                    // include in the parent scope and continue to create a standalone app scope
+                }
+                const appScopeRec = (0, scope_utils_1.normalizeAppScope)(raw, metadata);
+                const provide = appScopeRec.provide;
+                tokens.add(provide);
+                defs.set(provide, appScopeRec);
+                graph.set(provide, new Set());
+            }
+            const rec = (0, scope_utils_1.normalizeMultiAppScope)(includeInParent, metadata);
+            const provide = rec.provide;
+            tokens.add(provide);
+            defs.set(provide, rec);
+            graph.set(provide, new Set());
+        }
+        return {
+            tokens,
+            defs,
+            graph,
+        };
+    }
+    buildGraph() {
+        for (const token of this.tokens) {
+            const rec = this.defs.get(token);
+            const deps = (0, scope_utils_1.scopeDiscoveryDeps)(rec).slice(1);
+            for (const d of deps) {
+                if (!this.providers.get(d)) {
+                    throw new Error(`Adapter ${(0, token_utils_1.tokenName)(token)} depends on ${(0, token_utils_1.tokenName)(d)}, which is not registered.`);
+                }
+                this.graph.get(token).add(d);
+            }
+        }
+    }
+    async initialize() {
+        for (const token of this.tokens) {
+            const rec = this.defs.get(token);
+            let scope;
+            switch (rec.kind) {
+                case common_1.ScopeKind.SPLIT_BY_APP:
+                    scope = new rec.provide(rec, this.providers);
+                    break;
+                case common_1.ScopeKind.MULTI_APP:
+                    scope = new rec.provide(rec, this.providers);
+                    break;
+                default:
+                    throw new Error(`Invalid scope kind ${rec}`);
+            }
+            await scope.ready;
+            this.instances.set(token, scope);
+        }
+    }
+}
+exports.ScopeRegistry = ScopeRegistry;
+//# sourceMappingURL=scope.registry.js.map

package/src/scope/scope.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.registry.js","sourceRoot":"","sources":["../../../src/scope/scope.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import 'reflect-metadata';\nimport {\n  AppType,\n  FrontMcpConfigType,\n  ScopeEntry,\n  ScopeRecord,\n  ScopeKind,\n  Token,\n} from '../common';\nimport {RegistryAbstract, RegistryBuildMapResult} from '../regsitry';\nimport ProviderRegistry from '../provider/provider.registry';\nimport {FrontMcpConfig} from '../front-mcp/front-mcp.tokens';\nimport {normalizeApp} from '../app/app.utils';\nimport {normalizeAppScope, normalizeMultiAppScope, scopeDiscoveryDeps} from './scope.utils';\nimport {tokenName} from '../utils/token.utils';\n\nexport class ScopeRegistry extends RegistryAbstract<ScopeEntry, ScopeRecord, FrontMcpConfigType> {\n\n  constructor(globalProviders: ProviderRegistry) {\n    const metadata = globalProviders.get(FrontMcpConfig);\n    super('ScopeRegistry', globalProviders, metadata);\n  }\n\n  protected override buildMap(metadata: FrontMcpConfigType): RegistryBuildMapResult<ScopeRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, ScopeRecord>();\n    const graph = new Map<Token, Set<Token>>();\n\n    if (metadata.splitByApp) {\n      for (const raw of metadata.apps) {\n        const rec = normalizeAppScope(raw, metadata);\n        const provide = rec.provide;\n        tokens.add(provide);\n        defs.set(provide, rec);\n        graph.set(provide, new Set());\n      }\n    } else {\n      const includeInParent: AppType[] = [];\n\n      for (const raw of metadata.apps) {\n        const app = normalizeApp(raw);\n        const appMetadata = app.metadata;\n        if (appMetadata.standalone === false) {\n          includeInParent.push(raw);\n          // default include in parent scope\n          continue;\n        }\n\n        if (appMetadata.standalone === 'includeInParent') {\n          includeInParent.push(raw);\n          // include in the parent scope and continue to create a standalone app scope\n        }\n\n        const appScopeRec = normalizeAppScope(raw, metadata);\n        const provide = appScopeRec.provide;\n        tokens.add(provide);\n        defs.set(provide, appScopeRec);\n        graph.set(provide, new Set());\n      }\n\n      const rec = normalizeMultiAppScope(includeInParent, metadata);\n      const provide = rec.provide;\n      tokens.add(provide);\n      defs.set(provide, rec);\n      graph.set(provide, new Set());\n    }\n\n    return {\n      tokens,\n      defs,\n      graph,\n    };\n  }\n\n  protected override buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = scopeDiscoveryDeps(rec).slice(1);\n\n      for (const d of deps) {\n        if (!this.providers.get(d)) {\n          throw new Error(`Adapter ${tokenName(token)} depends on ${tokenName(d)}, which is not registered.`);\n        }\n        this.graph.get(token)!.add(d);\n      }\n    }\n  }\n\n  protected async initialize() {\n\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n\n      let scope: ScopeEntry;\n      switch (rec.kind) {\n        case ScopeKind.SPLIT_BY_APP:\n          scope = new rec.provide(rec, this.providers);\n          break;\n        case ScopeKind.MULTI_APP:\n          scope = new rec.provide(rec, this.providers);\n          break;\n        default:\n          throw new Error(`Invalid scope kind ${rec}`);\n      }\n\n      await scope.ready;\n      this.instances.set(token, scope);\n    }\n  }\n\n}\n"]}

package/src/scope/scope.utils.d.ts

@@ -0,0 +1,13 @@
+import { AppType, FrontMcpMultiAppConfig, FrontMcpSplitByAppConfig, Token, ScopeRecord } from '../common';
+/**
+ * Normalize a raw scope metadata list into useful maps/sets.
+ * - tokens: all provided tokens
+ * - defs: AdapterRecord by token
+ * - graph: initialized adjacency map (empty sets)
+ */
+export declare function normalizeAppScope(appItem: AppType, metadata: FrontMcpMultiAppConfig | FrontMcpSplitByAppConfig): ScopeRecord;
+export declare function normalizeMultiAppScope(includedApps: AppType[], metadata: FrontMcpMultiAppConfig): ScopeRecord;
+/**
+ * For graph/cycle detection. Returns dependency tokens that should be graphed.
+ */
+export declare function scopeDiscoveryDeps(rec: ScopeRecord): Token[];

package/src/scope/scope.utils.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeAppScope = normalizeAppScope;
+exports.normalizeMultiAppScope = normalizeMultiAppScope;
+exports.scopeDiscoveryDeps = scopeDiscoveryDeps;
+const common_1 = require("../common");
+const app_utils_1 = require("../app/app.utils");
+const token_utils_1 = require("../utils/token.utils");
+const scope_instance_1 = require("./scope.instance");
+/**
+ * Normalize a raw scope metadata list into useful maps/sets.
+ * - tokens: all provided tokens
+ * - defs: AdapterRecord by token
+ * - graph: initialized adjacency map (empty sets)
+ */
+function normalizeAppScope(appItem, metadata) {
+    const app = (0, app_utils_1.normalizeApp)(appItem);
+    const appMetadata = app.metadata;
+    /**
+     *  Explicitly check for true for splitByApp scope.
+     */
+    // noinspection PointlessBooleanExpressionJS
+    if (metadata.splitByApp === true && appMetadata.standalone === 'includeInParent') {
+        throw new Error('standalone: includeInParent is not supported for splitByApp scope');
+    }
+    return {
+        kind: common_1.ScopeKind.SPLIT_BY_APP,
+        provide: scope_instance_1.Scope,
+        metadata: {
+            ...metadata,
+            id: appMetadata.id ?? appMetadata.name,
+            apps: [appItem],
+            auth: appMetadata.auth
+        },
+    };
+}
+function normalizeMultiAppScope(includedApps, metadata) {
+    return {
+        kind: common_1.ScopeKind.MULTI_APP,
+        provide: scope_instance_1.Scope,
+        metadata: {
+            ...metadata,
+            id: 'root',
+            apps: includedApps,
+        },
+    };
+}
+/**
+ * For graph/cycle detection. Returns dependency tokens that should be graphed.
+ */
+function scopeDiscoveryDeps(rec) {
+    switch (rec.kind) {
+        case common_1.ScopeKind.MULTI_APP:
+            return (0, token_utils_1.depsOfClass)(rec.provide, 'discovery').slice(1);
+        case common_1.ScopeKind.SPLIT_BY_APP:
+            return (0, token_utils_1.depsOfClass)(rec.provide, 'discovery').slice(1);
+    }
+}
+//# sourceMappingURL=scope.utils.js.map

package/src/scope/scope.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.utils.js","sourceRoot":"","sources":["../../../src/scope/scope.utils.ts"],"names":[],"mappings":";;AAqBA,8CAqBC;AAED,wDAUC;AAKD,gDAOC;AAlED,sCASmB;AACnB,gDAA8C;AAC9C,sDAAiD;AACjD,qDAAuC;AAEvC;;;;;GAKG;AAEH,SAAgB,iBAAiB,CAAC,OAAgB,EAAE,QAA2D;IAC7G,MAAM,GAAG,GAAG,IAAA,wBAAY,EAAC,OAAO,CAAC,CAAC;IAClC,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC;IAEjC;;OAEG;IACH,4CAA4C;IAC5C,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI,IAAI,WAAW,CAAC,UAAU,KAAK,iBAAiB,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO;QACL,IAAI,EAAE,kBAAS,CAAC,YAAY;QAC5B,OAAO,EAAE,sBAAK;QACd,QAAQ,EAAE;YACR,GAAG,QAAQ;YACX,EAAE,EAAE,WAAW,CAAC,EAAE,IAAI,WAAW,CAAC,IAAI;YACtC,IAAI,EAAE,CAAC,OAAO,CAAC;YACf,IAAI,EAAE,WAAW,CAAC,IAAI;SACI;KAC7B,CAAC;AACJ,CAAC;AAED,SAAgB,sBAAsB,CAAC,YAAuB,EAAE,QAAgC;IAC9F,OAAO;QACL,IAAI,EAAE,kBAAS,CAAC,SAAS;QACzB,OAAO,EAAE,sBAAK;QACd,QAAQ,EAAE;YACR,GAAG,QAAQ;YACX,EAAE,EAAE,MAAM;YACV,IAAI,EAAE,YAAY;SACM;KAC3B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,GAAgB;IACjD,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,kBAAS,CAAC,SAAS;YACtB,OAAO,IAAA,yBAAW,EAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxD,KAAK,kBAAS,CAAC,YAAY;YACzB,OAAO,IAAA,yBAAW,EAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC","sourcesContent":["import {\n  AppScopeMetadata,\n  AppType,\n  FrontMcpMultiAppConfig,\n  FrontMcpSplitByAppConfig,\n  MultiAppScopeMetadata,\n  Token,\n  ScopeRecord,\n  ScopeKind,\n} from '../common';\nimport {normalizeApp} from '../app/app.utils';\nimport {depsOfClass} from '../utils/token.utils';\nimport {Scope} from './scope.instance';\n\n/**\n * Normalize a raw scope metadata list into useful maps/sets.\n * - tokens: all provided tokens\n * - defs: AdapterRecord by token\n * - graph: initialized adjacency map (empty sets)\n */\n\nexport function normalizeAppScope(appItem: AppType, metadata: FrontMcpMultiAppConfig | FrontMcpSplitByAppConfig): ScopeRecord {\n  const app = normalizeApp(appItem);\n  const appMetadata = app.metadata;\n\n  /**\n   *  Explicitly check for true for splitByApp scope.\n   */\n  // noinspection PointlessBooleanExpressionJS\n  if (metadata.splitByApp === true && appMetadata.standalone === 'includeInParent') {\n    throw new Error('standalone: includeInParent is not supported for splitByApp scope');\n  }\n  return {\n    kind: ScopeKind.SPLIT_BY_APP,\n    provide: Scope,\n    metadata: {\n      ...metadata,\n      id: appMetadata.id ?? appMetadata.name,\n      apps: [appItem],\n      auth: appMetadata.auth\n    } as any as AppScopeMetadata,\n  };\n}\n\nexport function normalizeMultiAppScope(includedApps: AppType[], metadata: FrontMcpMultiAppConfig): ScopeRecord {\n  return {\n    kind: ScopeKind.MULTI_APP,\n    provide: Scope,\n    metadata: {\n      ...metadata,\n      id: 'root',\n      apps: includedApps,\n    } as MultiAppScopeMetadata,\n  };\n}\n\n/**\n * For graph/cycle detection. Returns dependency tokens that should be graphed.\n */\nexport function scopeDiscoveryDeps(rec: ScopeRecord): Token[] {\n  switch (rec.kind) {\n    case ScopeKind.MULTI_APP:\n      return depsOfClass(rec.provide, 'discovery').slice(1);\n    case ScopeKind.SPLIT_BY_APP:\n      return depsOfClass(rec.provide, 'discovery').slice(1);\n  }\n}"]}

package/src/server/adapters/base.host.adapter.d.ts

@@ -0,0 +1,7 @@
+import { FrontMcpServer } from '../../common';
+export declare abstract class HostServerAdapter extends FrontMcpServer {
+    /**
+     *  Start the server on the specified port
+     */
+    abstract start(port: number): Promise<void> | void;
+}

package/src/server/adapters/base.host.adapter.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HostServerAdapter = void 0;
+const common_1 = require("../../common");
+class HostServerAdapter extends common_1.FrontMcpServer {
+}
+exports.HostServerAdapter = HostServerAdapter;
+//# sourceMappingURL=base.host.adapter.js.map

package/src/server/adapters/base.host.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.host.adapter.js","sourceRoot":"","sources":["../../../../src/server/adapters/base.host.adapter.ts"],"names":[],"mappings":";;;AAAA,yCAA8C;AAE9C,MAAsB,iBAAkB,SAAQ,uBAAc;CAM7D;AAND,8CAMC","sourcesContent":["import { FrontMcpServer } from '../../common';\n\nexport abstract class HostServerAdapter extends FrontMcpServer {\n\n  /**\n   *  Start the server on the specified port\n   */\n  abstract override start(port: number): Promise<void> | void;\n}\n\n"]}

package/src/server/adapters/express.host.adapter.d.ts

@@ -0,0 +1,12 @@
+import express from 'express';
+import { HostServerAdapter } from './base.host.adapter';
+import { HttpMethod, ServerRequestHandler } from '../../common';
+export declare class ExpressHostAdapter extends HostServerAdapter {
+    private app;
+    private router;
+    constructor();
+    registerRoute(method: HttpMethod, path: string, handler: ServerRequestHandler): void;
+    registerMiddleware(entryPath: string, handler: ServerRequestHandler): void;
+    enhancedHandler(handler: ServerRequestHandler): (req: express.Request, res: express.Response, next: express.NextFunction) => void | Promise<void>;
+    start(port: number): void;
+}

package/src/server/adapters/express.host.adapter.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpressHostAdapter = void 0;
+const tslib_1 = require("tslib");
+// server/adapters/express.host.adapter.ts
+const http = tslib_1.__importStar(require("node:http"));
+const express_1 = tslib_1.__importDefault(require("express"));
+const cors_1 = tslib_1.__importDefault(require("cors"));
+const base_host_adapter_1 = require("./base.host.adapter");
+class ExpressHostAdapter extends base_host_adapter_1.HostServerAdapter {
+    app = (0, express_1.default)();
+    router = express_1.default.Router();
+    constructor() {
+        super();
+        this.app.use(express_1.default.json());
+        this.app.use(express_1.default.urlencoded({ extended: true }));
+        this.app.use((0, cors_1.default)({ origin: '*', maxAge: 300 }));
+        // When creating the HTTP(S) server that hosts /mcp:
+        this.app.use((req, res, next) => {
+            res.setHeader('Access-Control-Expose-Headers', 'WWW-Authenticate');
+            res.setHeader('Cache-Control', 'no-cache, no-transform');
+            res.setHeader('Content-Type', 'application/json; charset=utf-8');
+            next();
+        });
+    }
+    registerRoute(method, path, handler) {
+        this.router[method.toLowerCase()](path, this.enhancedHandler(handler));
+    }
+    registerMiddleware(entryPath, handler) {
+        this.router.use(entryPath, handler);
+    }
+    enhancedHandler(handler) {
+        return (req, res, next) => {
+            // TODO: add request/response enhancements here if needed
+            const request = req;
+            const response = res;
+            return handler(request, response, next);
+        };
+    }
+    start(port) {
+        this.app.use('/', this.router);
+        const server = http.createServer(this.app);
+        server.requestTimeout = 0;
+        server.headersTimeout = 0;
+        server.keepAliveTimeout = 75_000;
+        server.listen(port, () => console.log(`MCP HTTP (Express) on ${port}`));
+    }
+}
+exports.ExpressHostAdapter = ExpressHostAdapter;
+//# sourceMappingURL=express.host.adapter.js.map

package/src/server/adapters/express.host.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.host.adapter.js","sourceRoot":"","sources":["../../../../src/server/adapters/express.host.adapter.ts"],"names":[],"mappings":";;;;AAAA,0CAA0C;AAC1C,wDAAkC;AAClC,8DAA8B;AAC9B,wDAAwB;AACxB,2DAAwD;AAGxD,MAAa,kBAAmB,SAAQ,qCAAiB;IAC/C,GAAG,GAAG,IAAA,iBAAO,GAAE,CAAC;IAChB,MAAM,GAAG,iBAAO,CAAC,MAAM,EAAE,CAAC;IAElC;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAA,cAAI,EAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACjD,oDAAoD;QACpD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YAC9B,GAAG,CAAC,SAAS,CAAC,+BAA+B,EAAE,kBAAkB,CAAC,CAAC;YACnE,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,wBAAwB,CAAC,CAAC;YACzD,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,iCAAiC,CAAC,CAAC;YACjE,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CAAC,MAAkB,EAAE,IAAY,EAAE,OAA6B;QAC3E,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,kBAAkB,CAAC,SAAiB,EAAE,OAA6B;QACjE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAc,CAAC,CAAC;IAC7C,CAAC;IAED,eAAe,CAAC,OAA6B;QAC3C,OAAO,CAAC,GAAoB,EAAE,GAAqB,EAAE,IAA0B,EAAE,EAAE;YACjF,yDAAyD;YACzD,MAAM,OAAO,GAAG,GAAoB,CAAC;YACrC,MAAM,QAAQ,GAAG,GAAqB,CAAC;YACvC,OAAO,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC;QAC1B,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC;QAC1B,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;CAEF;AA5CD,gDA4CC","sourcesContent":["// server/adapters/express.host.adapter.ts\nimport * as http from 'node:http';\nimport express from 'express';\nimport cors from 'cors';\nimport { HostServerAdapter } from './base.host.adapter';\nimport { HttpMethod, ServerRequest, ServerRequestHandler, ServerResponse } from '../../common';\n\nexport class ExpressHostAdapter extends HostServerAdapter {\n  private app = express();\n  private router = express.Router();\n\n  constructor() {\n    super();\n    this.app.use(express.json());\n    this.app.use(express.urlencoded({ extended: true }));\n    this.app.use(cors({ origin: '*', maxAge: 300 }));\n    // When creating the HTTP(S) server that hosts /mcp:\n    this.app.use((req, res, next) => {\n      res.setHeader('Access-Control-Expose-Headers', 'WWW-Authenticate');\n      res.setHeader('Cache-Control', 'no-cache, no-transform');\n      res.setHeader('Content-Type', 'application/json; charset=utf-8');\n      next();\n    });\n  }\n\n  registerRoute(method: HttpMethod, path: string, handler: ServerRequestHandler) {\n    this.router[method.toLowerCase()](path, this.enhancedHandler(handler));\n  }\n\n  registerMiddleware(entryPath: string, handler: ServerRequestHandler) {\n    this.router.use(entryPath, handler as any);\n  }\n\n  enhancedHandler(handler: ServerRequestHandler) {\n    return (req: express.Request, res: express.Response, next: express.NextFunction) => {\n      // TODO: add request/response enhancements here if needed\n      const request = req as ServerRequest;\n      const response = res as ServerResponse;\n      return handler(request, response, next);\n    };\n  }\n\n  start(port: number) {\n    this.app.use('/', this.router);\n    const server = http.createServer(this.app);\n    server.requestTimeout = 0;\n    server.headersTimeout = 0;\n    server.keepAliveTimeout = 75_000;\n    server.listen(port, () => console.log(`MCP HTTP (Express) on ${port}`));\n  }\n\n}\n"]}

package/src/server/server.instance.d.ts

@@ -0,0 +1,12 @@
+import { FrontMcpServer, HttpConfig, HttpMethod, ServerRequestHandler } from '../common';
+import { HostServerAdapter } from './adapters/base.host.adapter';
+export declare class FrontMcpServerInstance extends FrontMcpServer {
+    config: HttpConfig;
+    host: HostServerAdapter;
+    constructor(httpConfig: HttpConfig);
+    private setupDefaults;
+    registerMiddleware(entryPath: string, handler: ServerRequestHandler): void | Promise<void>;
+    registerRoute(method: HttpMethod, path: string, handler: ServerRequestHandler): void | Promise<void>;
+    enhancedHandler(handler: ServerRequestHandler): ServerRequestHandler;
+    start(): void;
+}

package/src/server/server.instance.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontMcpServerInstance = void 0;
+const common_1 = require("../common");
+const express_host_adapter_1 = require("./adapters/express.host.adapter");
+class FrontMcpServerInstance extends common_1.FrontMcpServer {
+    config;
+    host;
+    constructor(httpConfig) {
+        super();
+        this.config = httpConfig;
+        this.setupDefaults();
+    }
+    setupDefaults() {
+        if (typeof this.config.hostFactory === 'function') {
+            const { hostFactory, ...config } = this.config;
+            this.host = this.config.hostFactory(config);
+        }
+        else if (this.config.hostFactory !== undefined) {
+            this.host = this.config.hostFactory;
+        }
+        else {
+            this.host = new express_host_adapter_1.ExpressHostAdapter();
+        }
+    }
+    registerMiddleware(entryPath, handler) {
+        return this.host.registerMiddleware(entryPath, handler);
+    }
+    ;
+    registerRoute(method, path, handler) {
+        return this.host.registerRoute(method, path, handler);
+    }
+    ;
+    enhancedHandler(handler) {
+        return this.host.enhancedHandler(handler);
+    }
+    start() {
+        this.registerRoute('GET', '/health', async (req, res) => {
+            res.status(200).json({
+                status: 'ok',
+            });
+        });
+        this.host.start(this.config.port);
+    }
+}
+exports.FrontMcpServerInstance = FrontMcpServerInstance;
+//# sourceMappingURL=server.instance.js.map

package/src/server/server.instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.instance.js","sourceRoot":"","sources":["../../../src/server/server.instance.ts"],"names":[],"mappings":";;;AAAA,sCAAyF;AACzF,0EAAqE;AAIrE,MAAa,sBAAuB,SAAQ,uBAAc;IACxD,MAAM,CAAa;IACnB,IAAI,CAAoB;IAExB,YAAY,UAAsB;QAChC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;QACzB,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAEO,aAAa;QACnB,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YAClD,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;YAC/C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACjD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,GAAG,IAAI,yCAAkB,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAED,kBAAkB,CAAC,SAAiB,EAAE,OAA6B;QACjE,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAAA,CAAC;IAEF,aAAa,CAAC,MAAkB,EAAE,IAAY,EAAE,OAA6B;QAC3E,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAAA,CAAC;IAEO,eAAe,CAAC,OAA6B;QACpD,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;YACtD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;QACL,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AAzCD,wDAyCC","sourcesContent":["import { FrontMcpServer, HttpConfig, HttpMethod, ServerRequestHandler } from '../common';\nimport { ExpressHostAdapter } from './adapters/express.host.adapter';\nimport { HostServerAdapter } from './adapters/base.host.adapter';\n\n\nexport class FrontMcpServerInstance extends FrontMcpServer {\n  config: HttpConfig;\n  host: HostServerAdapter;\n\n  constructor(httpConfig: HttpConfig) {\n    super();\n    this.config = httpConfig;\n    this.setupDefaults();\n  }\n\n  private setupDefaults() {\n    if (typeof this.config.hostFactory === 'function') {\n      const { hostFactory, ...config } = this.config;\n      this.host = this.config.hostFactory(config);\n    } else if (this.config.hostFactory !== undefined) {\n      this.host = this.config.hostFactory;\n    } else {\n      this.host = new ExpressHostAdapter();\n    }\n  }\n\n  registerMiddleware(entryPath: string, handler: ServerRequestHandler) {\n    return this.host.registerMiddleware(entryPath, handler);\n  };\n\n  registerRoute(method: HttpMethod, path: string, handler: ServerRequestHandler) {\n    return this.host.registerRoute(method, path, handler);\n  };\n\n  override enhancedHandler(handler: ServerRequestHandler): ServerRequestHandler {\n    return this.host.enhancedHandler(handler);\n  }\n\n  start() {\n    this.registerRoute('GET', '/health', async (req, res) => {\n      res.status(200).json({\n        status: 'ok',\n      });\n    })\n    this.host.start(this.config.port);\n  }\n}\n"]}

package/src/server/server.types.d.ts

@@ -0,0 +1,24 @@
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import { Authorization, ServerRequest, SessionIdPayload, UserClaim } from '../common';
+import { LocalTransportAdapter } from '../transport/adapters/transport.local.adapter';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { SSEServerTransport } from '../transport/legacy/legacy.sse.tranporter';
+import { Scope } from '../scope';
+export interface ScopedServerRequest extends ServerRequest {
+    authScope: Scope;
+    auth: AuthInfo;
+    authSession?: Authorization;
+}
+export interface AuthenticatedServerRequest extends ScopedServerRequest {
+    auth: AuthInfo;
+    authSession: Authorization;
+}
+declare module '@modelcontextprotocol/sdk/server/auth/types.js' {
+    interface AuthInfo {
+        token: string;
+        user: UserClaim;
+        sessionId: string;
+        sessionIdPayload: SessionIdPayload;
+        transport: LocalTransportAdapter<StreamableHTTPServerTransport | SSEServerTransport>;
+    }
+}

package/src/server/server.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=server.types.js.map

package/src/server/server.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.types.js","sourceRoot":"","sources":["../../../src/server/server.types.ts"],"names":[],"mappings":"","sourcesContent":["import {AuthInfo} from '@modelcontextprotocol/sdk/server/auth/types.js';\nimport {\n  Authorization,\n  ServerRequest,\n  SessionIdPayload,\n  UserClaim,\n} from '../common';\nimport {LocalTransportAdapter} from '../transport/adapters/transport.local.adapter';\nimport {StreamableHTTPServerTransport} from '@modelcontextprotocol/sdk/server/streamableHttp.js';\nimport {SSEServerTransport} from '../transport/legacy/legacy.sse.tranporter';\nimport {Scope} from '../scope';\n\nexport interface ScopedServerRequest extends ServerRequest {\n  authScope: Scope;\n  auth: AuthInfo;\n  authSession?: Authorization;\n}\n\nexport interface AuthenticatedServerRequest extends ScopedServerRequest {\n  auth: AuthInfo;\n  authSession: Authorization;\n}\n\ndeclare module '@modelcontextprotocol/sdk/server/auth/types.js' {\n  export interface AuthInfo {\n    token: string;\n    user: UserClaim;\n    sessionId: string;\n    sessionIdPayload: SessionIdPayload;\n    transport: LocalTransportAdapter<StreamableHTTPServerTransport | SSEServerTransport>;\n  }\n}\n"]}

package/src/server/server.validation.d.ts

@@ -0,0 +1,2 @@
+import { ServerResponse } from '../common';
+export declare function writeHttpResponse(res: ServerResponse, value: any): Promise<void>;