@frontmcp/sdk 0.2.3 → 0.3.0

package/src/flows/flow.utils.js

@@ -0,0 +1,36 @@
+"use strict";
+// flows/flow.utils.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectFlowMetadata = collectFlowMetadata;
+exports.normalizeFlow = normalizeFlow;
+exports.flowDiscoveryDeps = flowDiscoveryDeps;
+const common_1 = require("../common");
+const token_utils_1 = require("../utils/token.utils");
+const metadata_utils_1 = require("../utils/metadata.utils");
+function collectFlowMetadata(cls) {
+    return Object.entries(common_1.FrontMcpFlowTokens).reduce((metadata, [key, token]) => {
+        return Object.assign(metadata, {
+            [key]: (0, metadata_utils_1.getMetadata)(token, cls),
+        });
+    }, {});
+}
+function normalizeFlow(item) {
+    if ((0, token_utils_1.isClass)(item)) {
+        // read McpFlowMetadata from class
+        const metadata = collectFlowMetadata(item);
+        return { kind: common_1.FlowKind.CLASS_TOKEN, provide: item, metadata };
+    }
+    const name = item?.name ?? String(item);
+    throw new Error(`Invalid adapter '${name}'. Expected a class or a adapter object.`);
+}
+/**
+ * For graph/cycle detection. Returns dependency tokens that should be graphed.
+ * - CLASS_TOKEN: deps come from the class constructor
+ */
+function flowDiscoveryDeps(rec) {
+    switch (rec.kind) {
+        case common_1.FlowKind.CLASS_TOKEN:
+            return (0, token_utils_1.depsOfClass)(rec.provide, 'discovery');
+    }
+}
+//# sourceMappingURL=flow.utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow.utils.js","sourceRoot":"","sources":["../../../src/flows/flow.utils.ts"],"names":[],"mappings":";AAAA,sBAAsB;;AAMtB,kDAMC;AAGD,sCAUC;AAMD,8CAKC;AAlCD,sCAAoG;AACpG,sDAA4D;AAC5D,4DAAsD;AAEtD,SAAgB,mBAAmB,CAAC,GAAa;IAC/C,OAAO,MAAM,CAAC,OAAO,CAAC,2BAAkB,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC1E,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE;YAC7B,CAAC,GAAG,CAAC,EAAE,IAAA,4BAAW,EAAC,KAAK,EAAE,GAAG,CAAC;SAC/B,CAAC,CAAC;IACL,CAAC,EAAE,EAAyB,CAAC,CAAC;AAChC,CAAC;AAGD,SAAgB,aAAa,CAAC,IAAc;IAC1C,IAAI,IAAA,qBAAO,EAAC,IAAI,CAAC,EAAE,CAAC;QAClB,kCAAkC;QAClC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,EAAE,IAAI,EAAE,iBAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjE,CAAC;IACD,MAAM,IAAI,GAAI,IAAY,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,IAAI,KAAK,CACb,oBAAoB,IAAI,0CAA0C,CACnE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,GAAe;IAC/C,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,iBAAQ,CAAC,WAAW;YACvB,OAAO,IAAA,yBAAW,EAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;AACH,CAAC","sourcesContent":["// flows/flow.utils.ts\n\nimport { FlowKind, FlowMetadata, FlowRecord, FlowType, FrontMcpFlowTokens, Token } from '../common';\nimport { depsOfClass, isClass } from '../utils/token.utils';\nimport { getMetadata } from '../utils/metadata.utils';\n\nexport function collectFlowMetadata(cls: FlowType): FlowMetadata<never> {\n  return Object.entries(FrontMcpFlowTokens).reduce((metadata, [key, token]) => {\n    return Object.assign(metadata, {\n      [key]: getMetadata(token, cls),\n    });\n  }, {} as FlowMetadata<never>);\n}\n\n\nexport function normalizeFlow(item: FlowType): FlowRecord {\n  if (isClass(item)) {\n    // read McpFlowMetadata from class\n    const metadata = collectFlowMetadata(item);\n    return { kind: FlowKind.CLASS_TOKEN, provide: item, metadata };\n  }\n  const name = (item as any)?.name ?? String(item);\n  throw new Error(\n    `Invalid adapter '${name}'. Expected a class or a adapter object.`,\n  );\n}\n\n/**\n * For graph/cycle detection. Returns dependency tokens that should be graphed.\n * - CLASS_TOKEN: deps come from the class constructor\n */\nexport function flowDiscoveryDeps(rec: FlowRecord): Token[] {\n  switch (rec.kind) {\n    case FlowKind.CLASS_TOKEN:\n      return depsOfClass(rec.provide, 'discovery');\n  }\n}\n\n"]}

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

@@ -0,0 +1,12 @@
+import { FrontMcpConfigType, FrontMcpInterface } from '../common';
+export declare class FrontMcpInstance implements FrontMcpInterface {
+    config: FrontMcpConfigType;
+    readonly ready: Promise<void>;
+    private logger;
+    private providers;
+    private scopes;
+    constructor(config: FrontMcpConfigType);
+    initialize(): Promise<void>;
+    start(): void;
+    static bootstrap(options: FrontMcpConfigType): Promise<void>;
+}

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

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontMcpInstance = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("../common");
+const scope_registry_1 = require("../scope/scope.registry");
+const provider_registry_1 = tslib_1.__importDefault(require("../provider/provider.registry"));
+const front_mcp_providers_1 = require("./front-mcp.providers");
+const logger_registry_1 = tslib_1.__importDefault(require("../logger/logger.registry"));
+class FrontMcpInstance {
+    config;
+    ready;
+    logger;
+    providers;
+    scopes;
+    constructor(config) {
+        this.config = config;
+        this.ready = this.initialize();
+    }
+    async initialize() {
+        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;
+        this.scopes = new scope_registry_1.ScopeRegistry(this.providers);
+        await this.scopes.ready;
+    }
+    start() {
+        const server = this.providers.get(common_1.FrontMcpServer);
+        if (!server) {
+            throw new Error('Server not found');
+        }
+        server.start();
+    }
+    static async bootstrap(options) {
+        const frontMcp = new FrontMcpInstance(options);
+        await frontMcp.ready;
+        frontMcp.start();
+    }
+}
+exports.FrontMcpInstance = FrontMcpInstance;
+//# sourceMappingURL=front-mcp.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,198 @@
+import { FrontMcpConfigType, FrontMcpServer, ProviderValueType } from '../common';
+export declare function createMcpGlobalProviders(metadata: FrontMcpConfigType): (ProviderValueType<{
+    providers: import("../common").Type<unknown>[];
+    info: {
+        name: string;
+        version: string;
+        title?: string | undefined;
+        icons?: import("zod").objectOutputType<{
+            src: import("zod").ZodString;
+            mimeType: import("zod").ZodOptional<import("zod").ZodString>;
+            sizes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, import("zod").ZodTypeAny, "passthrough">[] | undefined;
+        websiteUrl?: string | undefined;
+    };
+    apps: import("../common").Type<unknown>[];
+    http: {
+        port: number;
+        entryPath: string;
+        hostFactory?: any;
+    };
+    session: {
+        sessionMode: ((...args: unknown[]) => unknown) | "stateful" | "stateless";
+        transportIdMode: ((...args: unknown[]) => unknown) | "uuid" | "jwt";
+    };
+    logging: {
+        level: import("../common").LogLevel;
+        enableConsole: boolean;
+        transports: import("../common").Type<unknown>[];
+        prefix?: string | undefined;
+    };
+    serve: boolean;
+    splitByApp: false;
+    auth?: {
+        type: "remote";
+        name: string;
+        baseUrl: string;
+        id?: string | undefined;
+        dcrEnabled?: boolean | undefined;
+        clientId?: string | ((args_0: {
+            clientId: string;
+        }, ...args: unknown[]) => string) | undefined;
+        mode?: "orchestrated" | "transparent" | undefined;
+        allowAnonymous?: boolean | undefined;
+        consent?: boolean | undefined;
+        scopes?: string[] | undefined;
+        grantTypes?: ("authorization_code" | "refresh_token")[] | undefined;
+        authEndpoint?: string | undefined;
+        tokenEndpoint?: string | undefined;
+        registrationEndpoint?: string | undefined;
+        userInfoEndpoint?: string | undefined;
+        jwks?: {
+            keys: import("../common").JWK[];
+        } | undefined;
+        jwksUri?: string | undefined;
+    } | {
+        type: "local";
+        id: string;
+        name: string;
+        allowAnonymous?: boolean | undefined;
+        consent?: boolean | undefined;
+        scopes?: string[] | undefined;
+        grantTypes?: ("authorization_code" | "refresh_token")[] | undefined;
+        jwks?: {
+            keys: import("../common").JWK[];
+        } | undefined;
+        signKey?: import("../common").JWK | Uint8Array<ArrayBuffer> | undefined;
+    } | undefined;
+} | {
+    providers: import("../common").Type<unknown>[];
+    info: {
+        name: string;
+        version: string;
+        title?: string | undefined;
+        icons?: import("zod").objectOutputType<{
+            src: import("zod").ZodString;
+            mimeType: import("zod").ZodOptional<import("zod").ZodString>;
+            sizes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, import("zod").ZodTypeAny, "passthrough">[] | undefined;
+        websiteUrl?: string | undefined;
+    };
+    apps: import("../common").Type<unknown>[];
+    http: {
+        port: number;
+        entryPath: string;
+        hostFactory?: any;
+    };
+    session: {
+        sessionMode: ((...args: unknown[]) => unknown) | "stateful" | "stateless";
+        transportIdMode: ((...args: unknown[]) => unknown) | "uuid" | "jwt";
+    };
+    logging: {
+        level: import("../common").LogLevel;
+        enableConsole: boolean;
+        transports: import("../common").Type<unknown>[];
+        prefix?: string | undefined;
+    };
+    serve: boolean;
+    splitByApp: true;
+    auth?: undefined;
+}> | import("../common").ProviderFactoryType<FrontMcpServer, readonly [import("../common").Reference<{
+    providers: import("../common").Type<unknown>[];
+    info: {
+        name: string;
+        version: string;
+        title?: string | undefined;
+        icons?: import("zod").objectOutputType<{
+            src: import("zod").ZodString;
+            mimeType: import("zod").ZodOptional<import("zod").ZodString>;
+            sizes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, import("zod").ZodTypeAny, "passthrough">[] | undefined;
+        websiteUrl?: string | undefined;
+    };
+    apps: import("../common").Type<unknown>[];
+    http: {
+        port: number;
+        entryPath: string;
+        hostFactory?: any;
+    };
+    session: {
+        sessionMode: ((...args: unknown[]) => unknown) | "stateful" | "stateless";
+        transportIdMode: ((...args: unknown[]) => unknown) | "uuid" | "jwt";
+    };
+    logging: {
+        level: import("../common").LogLevel;
+        enableConsole: boolean;
+        transports: import("../common").Type<unknown>[];
+        prefix?: string | undefined;
+    };
+    serve: boolean;
+    splitByApp: false;
+    auth?: {
+        type: "remote";
+        name: string;
+        baseUrl: string;
+        id?: string | undefined;
+        dcrEnabled?: boolean | undefined;
+        clientId?: string | ((args_0: {
+            clientId: string;
+        }, ...args: unknown[]) => string) | undefined;
+        mode?: "orchestrated" | "transparent" | undefined;
+        allowAnonymous?: boolean | undefined;
+        consent?: boolean | undefined;
+        scopes?: string[] | undefined;
+        grantTypes?: ("authorization_code" | "refresh_token")[] | undefined;
+        authEndpoint?: string | undefined;
+        tokenEndpoint?: string | undefined;
+        registrationEndpoint?: string | undefined;
+        userInfoEndpoint?: string | undefined;
+        jwks?: {
+            keys: import("../common").JWK[];
+        } | undefined;
+        jwksUri?: string | undefined;
+    } | {
+        type: "local";
+        id: string;
+        name: string;
+        allowAnonymous?: boolean | undefined;
+        consent?: boolean | undefined;
+        scopes?: string[] | undefined;
+        grantTypes?: ("authorization_code" | "refresh_token")[] | undefined;
+        jwks?: {
+            keys: import("../common").JWK[];
+        } | undefined;
+        signKey?: import("../common").JWK | Uint8Array<ArrayBuffer> | undefined;
+    } | undefined;
+} | {
+    providers: import("../common").Type<unknown>[];
+    info: {
+        name: string;
+        version: string;
+        title?: string | undefined;
+        icons?: import("zod").objectOutputType<{
+            src: import("zod").ZodString;
+            mimeType: import("zod").ZodOptional<import("zod").ZodString>;
+            sizes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, import("zod").ZodTypeAny, "passthrough">[] | undefined;
+        websiteUrl?: string | undefined;
+    };
+    apps: import("../common").Type<unknown>[];
+    http: {
+        port: number;
+        entryPath: string;
+        hostFactory?: any;
+    };
+    session: {
+        sessionMode: ((...args: unknown[]) => unknown) | "stateful" | "stateless";
+        transportIdMode: ((...args: unknown[]) => unknown) | "uuid" | "jwt";
+    };
+    logging: {
+        level: import("../common").LogLevel;
+        enableConsole: boolean;
+        transports: import("../common").Type<unknown>[];
+        prefix?: string | undefined;
+    };
+    serve: boolean;
+    splitByApp: true;
+    auth?: undefined;
+}>]>)[];

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMcpGlobalProviders = createMcpGlobalProviders;
+const common_1 = require("../common");
+const server_instance_1 = require("../server/server.instance");
+const front_mcp_tokens_1 = require("./front-mcp.tokens");
+const frontMcpConfig = {
+    with: (metadata) => ({
+        name: 'frontmcp:config',
+        provide: front_mcp_tokens_1.FrontMcpConfig,
+        scope: common_1.ProviderScope.GLOBAL,
+        useValue: metadata,
+    }),
+};
+const frontMcpServer = (0, common_1.AsyncProvider)({
+    name: 'frontmcp:server',
+    scope: common_1.ProviderScope.GLOBAL,
+    provide: common_1.FrontMcpServer,
+    inject: () => [front_mcp_tokens_1.FrontMcpConfig],
+    useFactory: (config) => {
+        return new server_instance_1.FrontMcpServerInstance(config.http);
+    },
+});
+function createMcpGlobalProviders(metadata) {
+    return [
+        frontMcpConfig.with(metadata),
+        frontMcpServer,
+    ];
+}
+//# sourceMappingURL=front-mcp.providers.js.map

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

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

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

@@ -0,0 +1,2 @@
+import { FrontMcpConfigType, Token } from '../common';
+export declare const FrontMcpConfig: Token<FrontMcpConfigType>;

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

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontMcpConfig = void 0;
+exports.FrontMcpConfig = Symbol('FrontMcpConfig');
+//# sourceMappingURL=front-mcp.tokens.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"front-mcp.tokens.js","sourceRoot":"","sources":["../../../src/front-mcp/front-mcp.tokens.ts"],"names":[],"mappings":";;;AAIa,QAAA,cAAc,GAA8B,MAAM,CAAC,gBAAgB,CAAC,CAAC","sourcesContent":["import { FrontMcpConfigType, FrontMcpScopeInterface, Token } from '../common';\nimport { FrontMcpServerInstance } from '../server/server.instance';\n\n\nexport const FrontMcpConfig: Token<FrontMcpConfigType> = Symbol('FrontMcpConfig');\n"]}

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

@@ -0,0 +1 @@
+export * from './front-mcp';

package/src/front-mcp/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./front-mcp"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/front-mcp/index.ts"],"names":[],"mappings":";;;AAAA,sDAA2B","sourcesContent":["export * from './front-mcp'"]}

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

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

package/src/hooks/hook.instance.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HookInstance = void 0;
+const common_1 = require("../common");
+class HookInstance extends common_1.HookEntry {
+    logger;
+    constructor(scope, providers, record, token) {
+        super(scope, providers, record, token, record.metadata);
+        const { flow, method, stage } = this.metadata;
+        this.logger = scope.logger.child(`${flow}:hook:${stage}(${method})`);
+    }
+    initialize() {
+        return Promise.resolve(undefined);
+    }
+    async run(input, ctx) {
+        const { target, method } = this.metadata;
+        this.logger.verbose("start");
+        await target[method](input, ctx);
+        this.logger.verbose("start");
+    }
+}
+exports.HookInstance = HookInstance;
+//# sourceMappingURL=hook.instance.js.map

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

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

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

@@ -0,0 +1,34 @@
+import { FlowCtxOf, FlowInputOf, FlowName, FlowStagesOf, HookEntry, HookRecord, HookRegistryInterface, HookType, ScopeEntry, Token } from "../common";
+import { RegistryAbstract, RegistryBuildMapResult } from "../regsitry";
+import ProviderRegistry from "../provider/provider.registry";
+export default class HookRegistry extends RegistryAbstract<HookEntry, HookRecord, HookType[]> implements HookRegistryInterface {
+    scope: ScopeEntry;
+    /** Historical records by class (kept if you still want access to raw records) */
+    recordsByCls: Map<Token, HookRecord[]>;
+    /** Fast O(1) indexes of *instances*, sorted by priority (desc) */
+    private entriesByCls;
+    private hooksByFlow;
+    private hooksByFlowStage;
+    constructor(providers: ProviderRegistry, list: HookType[]);
+    protected buildMap(): RegistryBuildMapResult<HookRecord>;
+    protected buildGraph(): void;
+    initialize(): Promise<void>;
+    /** Priority helper (default 0) */
+    private getPriority;
+    /** Binary insert by priority (desc). Stable for equal priorities. */
+    private insertSorted;
+    private upsert;
+    private indexByClass;
+    private indexByFlow;
+    private indexByFlowStage;
+    private initializeOne;
+    registerHooks(embedded: boolean, ...records: HookRecord[]): Promise<void[]>;
+    /** Hooks defined on a given *class* (metadata.target), sorted by priority (desc). */
+    getClsHooks(token: Token): HookEntry[];
+    /** All hooks (instances, unordered) */
+    getHooks(): HookEntry[];
+    /** Hooks for a given *flow*, sorted by priority (desc). */
+    getFlowHooks<Name extends FlowName>(flow: Name): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[];
+    /** Hooks for a specific *flow + stage*, sorted by priority (desc). */
+    getFlowStageHooks<Name extends FlowName>(flow: Name, stage: FlowStagesOf<Name> | string): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[];
+}

package/src/hooks/hook.registry.js

@@ -0,0 +1,138 @@
+"use strict";
+// src/hooks/hook.registry.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+const regsitry_1 = require("../regsitry");
+const hook_instance_1 = require("./hook.instance");
+class HookRegistry extends regsitry_1.RegistryAbstract {
+    scope;
+    /** Historical records by class (kept if you still want access to raw records) */
+    recordsByCls = new Map();
+    /** Fast O(1) indexes of *instances*, sorted by priority (desc) */
+    entriesByCls = new Map();
+    hooksByFlow = new Map();
+    hooksByFlowStage = new Map();
+    constructor(providers, list) {
+        super("HookRegistry", providers, list);
+        this.scope = this.providers.getActiveScope();
+    }
+    buildMap() {
+        const tokens = new Set();
+        const defs = new Map();
+        const graph = new Map();
+        /**
+         * No need to build graph for hooks,
+         * hooks are injected by other tokens
+         */
+        return { tokens, defs, graph };
+    }
+    buildGraph() {
+        /**
+         * Currently, hooks cannot be depended on other tokens,
+         * in the future we can add this feature, so hooks can depends on:
+         * - other hooks completions
+         * - specific injected providers
+         */
+    }
+    async initialize() {
+        /**
+         * No need to initialize hooks,
+         * hooks are injected by other tokens
+         */
+    }
+    /** Priority helper (default 0) */
+    getPriority(entry) {
+        return entry.metadata?.priority ?? 0;
+    }
+    /** Binary insert by priority (desc). Stable for equal priorities. */
+    insertSorted(arr, item) {
+        const p = this.getPriority(item);
+        let lo = 0;
+        let hi = arr.length;
+        // Insert AFTER existing equal-priority items to keep stable order.
+        while (lo < hi) {
+            const mid = (lo + hi) >>> 1;
+            const mp = this.getPriority(arr[mid]);
+            if (mp < p) {
+                hi = mid;
+            }
+            else {
+                lo = mid + 1;
+            }
+        }
+        arr.splice(lo, 0, item);
+    }
+    upsert(map, key, init) {
+        let v = map.get(key);
+        if (!v) {
+            v = init();
+            map.set(key, v);
+        }
+        return v;
+    }
+    indexByClass(cls, entry) {
+        const list = this.upsert(this.entriesByCls, cls, () => []);
+        this.insertSorted(list, entry);
+    }
+    indexByFlow(flow, entry) {
+        const list = this.upsert(this.hooksByFlow, flow, () => []);
+        this.insertSorted(list, entry);
+    }
+    indexByFlowStage(flow, stage, entry) {
+        const stages = this.upsert(this.hooksByFlowStage, flow, () => new Map());
+        const list = this.upsert(stages, String(stage), () => []);
+        this.insertSorted(list, entry);
+    }
+    initializeOne(embedded, token) {
+        const rec = this.defs.get(token);
+        const providers = this.providers; // nearest token provider registry
+        const instance = new hook_instance_1.HookInstance(this.scope, providers, rec, token);
+        this.instances.set(token, instance);
+        // Keep raw records grouped by class (if needed elsewhere)
+        const cls = rec.metadata.target;
+        const recs = this.recordsByCls.get(cls) ?? [];
+        recs.push(rec);
+        this.recordsByCls.set(cls, recs);
+        // Build fast indexes of *instances*, sorted by priority
+        const entry = this.instances.get(token);
+        const { flow, stage, target } = rec.metadata;
+        if (embedded) {
+            this.indexByClass(target.constructor ?? target, entry);
+        }
+        else {
+            this.indexByFlowStage(flow, String(stage), entry);
+            this.indexByFlow(flow, entry);
+        }
+        return instance.ready;
+    }
+    registerHooks(embedded, ...records) {
+        const readyArr = [];
+        for (const record of records) {
+            this.defs.set(record.provide, record);
+            this.tokens.add(record.provide);
+            this.graph.set(record.provide, new Set());
+            readyArr.push(this.initializeOne(embedded, record.provide));
+        }
+        return Promise.all(readyArr);
+    }
+    /** Hooks defined on a given *class* (metadata.target), sorted by priority (desc). */
+    getClsHooks(token) {
+        return this.entriesByCls.get(token) ?? [];
+    }
+    /** All hooks (instances, unordered) */
+    getHooks() {
+        return [...this.instances.values()];
+    }
+    /** Hooks for a given *flow*, sorted by priority (desc). */
+    getFlowHooks(flow) {
+        const list = this.hooksByFlow.get(flow) ?? [];
+        return list;
+    }
+    /** Hooks for a specific *flow + stage*, sorted by priority (desc). */
+    getFlowStageHooks(flow, stage) {
+        const byStage = this.hooksByFlowStage.get(flow);
+        const list = byStage?.get(String(stage)) ?? [];
+        return list;
+    }
+}
+exports.default = HookRegistry;
+//# sourceMappingURL=hook.registry.js.map

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

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

package/src/hooks/hooks.utils.d.ts

@@ -0,0 +1,3 @@
+import { HookMetadata, HookRecord, Token } from "../common";
+export declare function collectHook(cls: Token): HookMetadata[];
+export declare function normalizeHooksFromCls(instance: any): HookRecord[];

package/src/hooks/hooks.utils.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectHook = collectHook;
+exports.normalizeHooksFromCls = normalizeHooksFromCls;
+const common_1 = require("../common");
+const metadata_utils_1 = require("../utils/metadata.utils");
+const token_utils_1 = require("../utils/token.utils");
+function collectHook(cls) {
+    return ((0, metadata_utils_1.getMetadata)(common_1.FrontMcpFlowHookTokens.hooks, cls) ?? []);
+}
+function normalizeHooksFromCls(instance) {
+    const item = instance.constructor;
+    if ((0, token_utils_1.isClass)(item)) {
+        const hooks = collectHook(item);
+        return hooks.map(hook => ({
+            kind: common_1.HookKind.METHOD_TOKEN,
+            provide: hook.static ? item[hook.method] : instance[hook.method],
+            metadata: {
+                ...hook,
+                target: hook.static ? item : instance,
+            }
+        }));
+    }
+    // ignore hooks from non-class items
+    return [];
+}
+//# sourceMappingURL=hooks.utils.js.map

package/src/hooks/hooks.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.utils.js","sourceRoot":"","sources":["../../../src/hooks/hooks.utils.ts"],"names":[],"mappings":";;AAKA,kCAEC;AAGD,sDAeC;AAzBD,sCAA4F;AAC5F,4DAAoD;AACpD,sDAA6C;AAG7C,SAAgB,WAAW,CAAC,GAAU;IACpC,OAAO,CAAC,IAAA,4BAAW,EAAC,+BAAsB,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,CAAmB,CAAC;AAClF,CAAC;AAGD,SAAgB,qBAAqB,CAAC,QAAa;IACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC;IAClC,IAAI,IAAA,qBAAO,EAAC,IAAI,CAAC,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxB,IAAI,EAAE,iBAAQ,CAAC,YAAY;YAC3B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;YAChE,QAAQ,EAAE;gBACR,GAAG,IAAI;gBACP,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;aACtC;SACF,CAAC,CAAC,CAAA;IACL,CAAC;IACD,oCAAoC;IACpC,OAAO,EAAE,CAAA;AACX,CAAC","sourcesContent":["import {FrontMcpFlowHookTokens, HookKind, HookMetadata, HookRecord, Token} from \"../common\";\nimport {getMetadata} from \"../utils/metadata.utils\";\nimport {isClass} from \"../utils/token.utils\";\n\n\nexport function collectHook(cls: Token): HookMetadata[] {\n  return (getMetadata(FrontMcpFlowHookTokens.hooks, cls) ?? []) as HookMetadata[];\n}\n\n\nexport function normalizeHooksFromCls(instance: any): HookRecord[] {\n  const item = instance.constructor;\n  if (isClass(item)) {\n    const hooks = collectHook(item);\n    return hooks.map(hook => ({\n      kind: HookKind.METHOD_TOKEN,\n      provide: hook.static ? item[hook.method] : instance[hook.method],\n      metadata: {\n        ...hook,\n        target: hook.static ? item : instance,\n      }\n    }))\n  }\n  // ignore hooks from non-class items\n  return []\n}"]}