@frontmcp/sdk 0.2.3 → 0.3.0

package/src/index.d.ts

@@ -1,18 +1,21 @@
-export * from './constants';
-export * from './decorators';
-export * from './types';
-export * from './metadata';
-export * from './interfaces';
-export * from './tokens';
-export * from './dynamic';
-export * from './records';
-export * from './entries';
-export * from './utils';
-export * from './schemas';
-export * from './decorators-old/async-with.decorator';
-export * from './decorators-old/tool-hook.decorator';
-export * from './decorators-old/session-hook.decorator';
-export * from './interfaces/tool-hook.interface';
-export * from './interfaces/session-hook.interface';
-export * from './interfaces/auth-hook.interface';
-export * from './providers/session.provider';
+import 'reflect-metadata';
+export { FrontMcpInstance } from './front-mcp';
+export * from "./common";
+export declare const ToolHook: {
+    Stage: (stage: "execute" | "finalize" | "parseInput" | "findTool" | "createToolCallContext" | "acquireQuota" | "acquireSemaphore" | "validateInput" | "validateOutput" | "releaseSemaphore" | "releaseQuota", opts?: import("./common").HookOptions<import("./tool/flows/call-tool.flow").default>) => MethodDecorator;
+    Will: (stage: "execute" | "finalize" | "parseInput" | "findTool" | "createToolCallContext" | "acquireQuota" | "acquireSemaphore" | "validateInput" | "validateOutput" | "releaseSemaphore" | "releaseQuota", opts?: import("./common").HookOptions<import("./tool/flows/call-tool.flow").default>) => MethodDecorator;
+    Did: (stage: "execute" | "finalize" | "parseInput" | "findTool" | "createToolCallContext" | "acquireQuota" | "acquireSemaphore" | "validateInput" | "validateOutput" | "releaseSemaphore" | "releaseQuota", opts?: import("./common").HookOptions<import("./tool/flows/call-tool.flow").default>) => MethodDecorator;
+    Around: (stage: "execute" | "finalize" | "parseInput" | "findTool" | "createToolCallContext" | "acquireQuota" | "acquireSemaphore" | "validateInput" | "validateOutput" | "releaseSemaphore" | "releaseQuota", opts?: import("./common").HookOptions<import("./tool/flows/call-tool.flow").default>) => MethodDecorator;
+};
+export declare const ListToolsHook: {
+    Stage: (stage: "parseInput" | "findTools" | "resolveConflicts" | "parseTools", opts?: import("./common").HookOptions<import("./tool/flows/tools-list.flow").default>) => MethodDecorator;
+    Will: (stage: "parseInput" | "findTools" | "resolveConflicts" | "parseTools", opts?: import("./common").HookOptions<import("./tool/flows/tools-list.flow").default>) => MethodDecorator;
+    Did: (stage: "parseInput" | "findTools" | "resolveConflicts" | "parseTools", opts?: import("./common").HookOptions<import("./tool/flows/tools-list.flow").default>) => MethodDecorator;
+    Around: (stage: "parseInput" | "findTools" | "resolveConflicts" | "parseTools", opts?: import("./common").HookOptions<import("./tool/flows/tools-list.flow").default>) => MethodDecorator;
+};
+export declare const HttpHook: {
+    Stage: (stage: "error" | "finalize" | "acquireQuota" | "acquireSemaphore" | "releaseSemaphore" | "releaseQuota" | "checkAuthorization" | "router" | "handleLegacySse" | "handleSse" | "handleStreamableHttp" | "handleStatefulHttp" | "handleStatelessHttp" | "audit" | "metrics", opts?: import("./common").HookOptions<import("./scope/flows/http.request.flow").default>) => MethodDecorator;
+    Will: (stage: "error" | "finalize" | "acquireQuota" | "acquireSemaphore" | "releaseSemaphore" | "releaseQuota" | "checkAuthorization" | "router" | "handleLegacySse" | "handleSse" | "handleStreamableHttp" | "handleStatefulHttp" | "handleStatelessHttp" | "audit" | "metrics", opts?: import("./common").HookOptions<import("./scope/flows/http.request.flow").default>) => MethodDecorator;
+    Did: (stage: "error" | "finalize" | "acquireQuota" | "acquireSemaphore" | "releaseSemaphore" | "releaseQuota" | "checkAuthorization" | "router" | "handleLegacySse" | "handleSse" | "handleStreamableHttp" | "handleStatefulHttp" | "handleStatelessHttp" | "audit" | "metrics", opts?: import("./common").HookOptions<import("./scope/flows/http.request.flow").default>) => MethodDecorator;
+    Around: (stage: "error" | "finalize" | "acquireQuota" | "acquireSemaphore" | "releaseSemaphore" | "releaseQuota" | "checkAuthorization" | "router" | "handleLegacySse" | "handleSse" | "handleStreamableHttp" | "handleStatefulHttp" | "handleStatelessHttp" | "audit" | "metrics", opts?: import("./common").HookOptions<import("./scope/flows/http.request.flow").default>) => MethodDecorator;
+};

package/src/index.js

@@ -1,22 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpHook = exports.ListToolsHook = exports.ToolHook = exports.FrontMcpInstance = void 0;
 const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./constants"), exports);
-tslib_1.__exportStar(require("./decorators"), exports);
-tslib_1.__exportStar(require("./types"), exports);
-tslib_1.__exportStar(require("./metadata"), exports);
-tslib_1.__exportStar(require("./interfaces"), exports);
-tslib_1.__exportStar(require("./tokens"), exports);
-tslib_1.__exportStar(require("./dynamic"), exports);
-tslib_1.__exportStar(require("./records"), exports);
-tslib_1.__exportStar(require("./entries"), exports);
-tslib_1.__exportStar(require("./utils"), exports);
-tslib_1.__exportStar(require("./schemas"), exports);
-tslib_1.__exportStar(require("./decorators-old/async-with.decorator"), exports);
-tslib_1.__exportStar(require("./decorators-old/tool-hook.decorator"), exports);
-tslib_1.__exportStar(require("./decorators-old/session-hook.decorator"), exports);
-tslib_1.__exportStar(require("./interfaces/tool-hook.interface"), exports);
-tslib_1.__exportStar(require("./interfaces/session-hook.interface"), exports);
-tslib_1.__exportStar(require("./interfaces/auth-hook.interface"), exports);
-tslib_1.__exportStar(require("./providers/session.provider"), exports);
+require("reflect-metadata");
+const common_1 = require("./common");
+var front_mcp_1 = require("./front-mcp");
+Object.defineProperty(exports, "FrontMcpInstance", { enumerable: true, get: function () { return front_mcp_1.FrontMcpInstance; } });
+tslib_1.__exportStar(require("./common"), exports);
+exports.ToolHook = (0, common_1.FlowHooksOf)('tools:call-tool');
+exports.ListToolsHook = (0, common_1.FlowHooksOf)('tools:list-tools');
+exports.HttpHook = (0, common_1.FlowHooksOf)('http:request');
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,sDAA4B;AAC5B,uDAA6B;AAC7B,kDAAwB;AACxB,qDAA2B;AAC3B,uDAA6B;AAC7B,mDAAyB;AACzB,oDAA0B;AAC1B,oDAA0B;AAC1B,oDAA0B;AAC1B,kDAAwB;AACxB,oDAA0B;AAE1B,gFAAsD;AACtD,+EAAqD;AACrD,kFAAwD;AAExD,2EAAiD;AACjD,8EAAoD;AACpD,2EAAiD;AAGjD,uEAA6C","sourcesContent":["export * from './constants';\nexport * from './decorators';\nexport * from './types';\nexport * from './metadata';\nexport * from './interfaces';\nexport * from './tokens';\nexport * from './dynamic';\nexport * from './records';\nexport * from './entries';\nexport * from './utils';\nexport * from './schemas';\n\nexport * from './decorators-old/async-with.decorator';\nexport * from './decorators-old/tool-hook.decorator';\nexport * from './decorators-old/session-hook.decorator';\n\nexport * from './interfaces/tool-hook.interface';\nexport * from './interfaces/session-hook.interface';\nexport * from './interfaces/auth-hook.interface';\n\n\nexport * from './providers/session.provider';\n\n\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;AAAA,4BAA0B;AAC1B,qCAAqC;AAErC,yCAA6C;AAArC,6GAAA,gBAAgB,OAAA;AACxB,mDAAyB;AAGZ,QAAA,QAAQ,GAAG,IAAA,oBAAW,EAAC,iBAAiB,CAAC,CAAA;AACzC,QAAA,aAAa,GAAG,IAAA,oBAAW,EAAC,kBAAkB,CAAC,CAAA;AAC/C,QAAA,QAAQ,GAAG,IAAA,oBAAW,EAAC,cAAc,CAAC,CAAA","sourcesContent":["import 'reflect-metadata';\nimport {FlowHooksOf} from \"./common\";\n\nexport {FrontMcpInstance} from './front-mcp';\nexport * from \"./common\";\n\n\nexport const ToolHook = FlowHooksOf('tools:call-tool')\nexport const ListToolsHook = FlowHooksOf('tools:list-tools')\nexport const HttpHook = FlowHooksOf('http:request')\n\n\n"]}

package/src/logger/instances/instance.console-logger.d.ts

@@ -0,0 +1,10 @@
+import { LogTransportInterface, LogRecord, LogLevel, LogFn } from '../../common';
+export declare class ConsoleLogTransportInstance extends LogTransportInterface {
+    log(rec: LogRecord): void;
+    private levelTags;
+    /** Returns a *bound native console function* with the prefix (ANSI only) */
+    bind(level: LogLevel, loggerPrefix?: string): LogFn;
+    private pickMethod;
+    private supportsAnsi;
+    private friendlyTime;
+}

package/src/logger/instances/instance.console-logger.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleLogTransportInstance = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("../../common");
+let ConsoleLogTransportInstance = class ConsoleLogTransportInstance extends common_1.LogTransportInterface {
+    log(rec) {
+        const fn = this.bind(rec.level, rec.prefix);
+        fn(String(rec.message), ...rec.args);
+    }
+    levelTags = {
+        [common_1.LogLevel.Off]: { label: '', ansi: '' },
+        [common_1.LogLevel.Debug]: { label: 'DEBUG', ansi: '\x1b[34m' }, // gray
+        [common_1.LogLevel.VERBOSE]: { label: 'VERBOSE', ansi: '\x1b[90m' }, // blue
+        [common_1.LogLevel.Info]: { label: 'INFO', ansi: '\x1b[32m' }, // green
+        [common_1.LogLevel.Warn]: { label: 'WARN', ansi: '\x1b[33m' }, // yellow
+        [common_1.LogLevel.Error]: { label: 'ERROR', ansi: '\x1b[31m' }, // red
+    };
+    /** Returns a *bound native console function* with the prefix (ANSI only) */
+    bind(level, loggerPrefix) {
+        const method = this.pickMethod(level);
+        const meta = this.levelTags[level] ?? this.levelTags[common_1.LogLevel.Info];
+        const ts = this.friendlyTime(new Date());
+        const RESET = '\x1b[0m';
+        const BOLD = '\x1b[1m';
+        const DIM = '\x1b[2m';
+        const GRAY = '\x1b[90m';
+        const useAnsi = this.supportsAnsi();
+        const timePart = useAnsi ? `${DIM}[${ts}]${RESET}` : `[${ts}]`;
+        const scopePart = loggerPrefix
+            ? (useAnsi ? `${BOLD}[${loggerPrefix}]${RESET}` : `[${loggerPrefix}]`)
+            : undefined;
+        const levelPart = useAnsi ? `${BOLD}${meta.ansi}${meta.label}${RESET}` : meta.label;
+        const fmt = [timePart, scopePart, levelPart, '%s'].filter(Boolean).join(' ');
+        return method.bind(console, fmt);
+    }
+    pickMethod(level) {
+        switch (level) {
+            case common_1.LogLevel.Debug:
+                return console.debug.bind(console);
+            case common_1.LogLevel.VERBOSE:
+                return console.info.bind(console);
+            case common_1.LogLevel.Info:
+                return console.info.bind(console);
+            case common_1.LogLevel.Warn:
+                return console.warn.bind(console);
+            case common_1.LogLevel.Error:
+                return console.error.bind(console);
+            default:
+                return console.log.bind(console);
+        }
+    }
+    supportsAnsi() {
+        if (typeof process === 'undefined')
+            return false;
+        const env = process.env || {};
+        if (env['NO_COLOR'])
+            return false;
+        if (env['FORCE_COLOR'])
+            return true;
+        return !!(process.stdout && process.stdout.isTTY);
+    }
+    friendlyTime(d) {
+        const pad = (n, w = 2) => String(n).padStart(w, '0');
+        return `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}.${pad(d.getMilliseconds(), 3)}`;
+    }
+};
+exports.ConsoleLogTransportInstance = ConsoleLogTransportInstance;
+exports.ConsoleLogTransportInstance = ConsoleLogTransportInstance = tslib_1.__decorate([
+    (0, common_1.LogTransport)({
+        name: 'ConsoleLogger',
+        description: 'Used as default console logger',
+    })
+], ConsoleLogTransportInstance);
+//# sourceMappingURL=instance.console-logger.js.map

package/src/logger/instances/instance.console-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.console-logger.js","sourceRoot":"","sources":["../../../../src/logger/instances/instance.console-logger.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  LogTransportInterface,\n  LogRecord,\n  LogTransport,\n  LogLevel,\n  LogFn,\n} from '../../common';\n\ntype LogLevelMeta = {\n  label: string;\n  ansi: string; // ANSI for TTY (kept for completeness)\n};\n\n@LogTransport({\n  name: 'ConsoleLogger',\n  description: 'Used as default console logger',\n})\nexport class ConsoleLogTransportInstance extends LogTransportInterface {\n\n  log(rec: LogRecord): void {\n    const fn = this.bind(rec.level, rec.prefix);\n    fn(String(rec.message), ...rec.args);\n  }\n\n  private levelTags: Record<LogLevel, LogLevelMeta> = {\n    [LogLevel.Off]: { label: '', ansi: '' },\n    [LogLevel.Debug]: { label: 'DEBUG', ansi: '\\x1b[34m' }, // gray\n    [LogLevel.VERBOSE]: { label: 'VERBOSE', ansi: '\\x1b[90m' }, // blue\n    [LogLevel.Info]: { label: 'INFO', ansi: '\\x1b[32m' }, // green\n    [LogLevel.Warn]: { label: 'WARN', ansi: '\\x1b[33m' }, // yellow\n    [LogLevel.Error]: { label: 'ERROR', ansi: '\\x1b[31m' }, // red\n  };\n\n  /** Returns a *bound native console function* with the prefix (ANSI only) */\n  bind(level: LogLevel, loggerPrefix?: string): LogFn {\n    const method = this.pickMethod(level);\n    const meta = this.levelTags[level] ?? this.levelTags[LogLevel.Info];\n    const ts = this.friendlyTime(new Date());\n\n    const RESET = '\\x1b[0m';\n    const BOLD = '\\x1b[1m';\n    const DIM = '\\x1b[2m';\n    const GRAY = '\\x1b[90m';\n\n    const useAnsi = this.supportsAnsi();\n    const timePart = useAnsi ? `${DIM}[${ts}]${RESET}` : `[${ts}]`;\n    const scopePart = loggerPrefix\n      ? (useAnsi ? `${BOLD}[${loggerPrefix}]${RESET}` : `[${loggerPrefix}]`)\n      : undefined;\n    const levelPart = useAnsi ? `${BOLD}${meta.ansi}${meta.label}${RESET}` : meta.label;\n\n    const fmt = [timePart, scopePart, levelPart, '%s'].filter(Boolean).join(' ');\n    return method.bind(console, fmt);\n  }\n\n  private pickMethod(level: LogLevel): LogFn {\n    switch (level) {\n      case LogLevel.Debug:\n        return console.debug.bind(console);\n      case LogLevel.VERBOSE:\n        return console.info.bind(console);\n      case LogLevel.Info:\n        return console.info.bind(console);\n      case LogLevel.Warn:\n        return console.warn.bind(console);\n      case LogLevel.Error:\n        return console.error.bind(console);\n      default:\n        return console.log.bind(console);\n    }\n  }\n\n  private supportsAnsi(): boolean {\n    if (typeof process === 'undefined') return false;\n    const env = process.env || {};\n    if (env['NO_COLOR']) return false;\n    if (env['FORCE_COLOR']) return true;\n    return !!(process.stdout && (process.stdout as any).isTTY);\n  }\n\n  private friendlyTime(d: Date): string {\n    const pad = (n: number, w = 2) => String(n).padStart(w, '0');\n    return `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}.${pad(d.getMilliseconds(), 3)}`;\n  }\n\n}"]}

package/src/logger/instances/instance.logger.d.ts

@@ -0,0 +1,24 @@
+import { FrontMcpLogger, LogTransportInterface, LogFn, LoggingConfigType } from '../../common';
+import { ConsoleLogTransportInstance } from './instance.console-logger';
+export type GetTransports = () => {
+    consoleTransport?: ConsoleLogTransportInstance;
+    transports: LogTransportInterface[];
+};
+export declare class LoggerInstance extends FrontMcpLogger {
+    private readonly config;
+    private getTransports;
+    private readonly level;
+    private readonly prefix;
+    private readonly transports;
+    private readonly consoleTransport?;
+    constructor(config: LoggingConfigType, getTransports: GetTransports);
+    child(prefix: string): FrontMcpLogger;
+    /** Internal: fan out to transports if level passes a threshold. */
+    private emit;
+    get verbose(): LogFn;
+    get debug(): LogFn;
+    get info(): LogFn;
+    get warn(): LogFn;
+    get error(): LogFn;
+    private _getter;
+}

package/src/logger/instances/instance.logger.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggerInstance = void 0;
+const common_1 = require("../../common");
+class LoggerInstance extends common_1.FrontMcpLogger {
+    config;
+    getTransports;
+    level;
+    prefix;
+    transports;
+    consoleTransport;
+    constructor(config, getTransports) {
+        super();
+        this.config = config;
+        this.getTransports = getTransports;
+        this.level = config.level;
+        this.prefix = config.prefix ?? '';
+        const { transports, consoleTransport } = getTransports();
+        this.transports = transports;
+        this.consoleTransport = consoleTransport;
+    }
+    child(prefix) {
+        return new LoggerInstance({ ...this.config, prefix }, this.getTransports);
+    }
+    /** Internal: fan out to transports if level passes a threshold. */
+    emit(level, message, args) {
+        if (level < this.level || this.level === common_1.LogLevel.Off)
+            return;
+        const rec = {
+            level,
+            levelName: common_1.LogLevelName[level],
+            message,
+            args,
+            timestamp: new Date(),
+            prefix: this.prefix,
+        };
+        for (const t of this.transports) {
+            try {
+                // Fire-and-forget; transports may be async
+                void t.log(rec);
+            }
+            catch (err) {
+                // Never throw from logging
+                // eslint-disable-next-line no-console
+                console.error('[Logger] Transport error:', err);
+            }
+        }
+    }
+    get verbose() {
+        return this._getter(common_1.LogLevel.VERBOSE);
+    }
+    get debug() {
+        return this._getter(common_1.LogLevel.Debug);
+    }
+    get info() {
+        return this._getter(common_1.LogLevel.Info);
+    }
+    get warn() {
+        return this._getter(common_1.LogLevel.Warn);
+    }
+    get error() {
+        return this._getter(common_1.LogLevel.Error);
+    }
+    _getter(level) {
+        if (level < this.level || this.level === common_1.LogLevel.Off)
+            return (() => void 0);
+        if (process.env['NODE_ENV'] === 'development' && this.config.enableConsole && this.consoleTransport) {
+            return this.consoleTransport.bind(level, this.prefix);
+        }
+        const emit = this.emit.bind(this);
+        return function (...args) {
+            emit(level, String(args[0]), Array.prototype.slice.call(args, 1));
+        };
+    }
+}
+exports.LoggerInstance = LoggerInstance;
+//# sourceMappingURL=instance.logger.js.map

package/src/logger/instances/instance.logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.logger.js","sourceRoot":"","sources":["../../../../src/logger/instances/instance.logger.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  FrontMcpLogger,\n  LogTransportInterface,\n  LogFn,\n  LoggingConfigType,\n  LogLevel, LogLevelName,\n  LogRecord,\n} from '../../common';\nimport { ConsoleLogTransportInstance } from './instance.console-logger';\n\nexport type GetTransports = () => {\n  consoleTransport?: ConsoleLogTransportInstance,\n  transports: LogTransportInterface[]\n};\n\nexport class LoggerInstance extends FrontMcpLogger {\n  private readonly level: LogLevel;\n  private readonly prefix: string;\n  private readonly transports: LogTransportInterface[];\n  private readonly consoleTransport?: ConsoleLogTransportInstance;\n\n  constructor(private readonly config: LoggingConfigType, private getTransports: GetTransports) {\n    super();\n    this.level = config.level;\n    this.prefix = config.prefix ?? '';\n\n    const { transports, consoleTransport } = getTransports();\n    this.transports = transports;\n    this.consoleTransport = consoleTransport;\n\n  }\n\n  child(prefix: string): FrontMcpLogger {\n    return new LoggerInstance({ ...this.config, prefix }, this.getTransports);\n  }\n\n  /** Internal: fan out to transports if level passes a threshold. */\n  private emit(level: LogLevel, message: string, args: unknown[]) {\n    if (level < this.level || this.level === LogLevel.Off) return;\n    const rec: LogRecord = {\n      level,\n      levelName: LogLevelName[level],\n      message,\n      args,\n      timestamp: new Date(),\n      prefix: this.prefix,\n    };\n    for (const t of this.transports) {\n      try {\n        // Fire-and-forget; transports may be async\n        void t.log(rec);\n      } catch (err) {\n        // Never throw from logging\n        // eslint-disable-next-line no-console\n        console.error('[Logger] Transport error:', err);\n      }\n    }\n  }\n\n  get verbose(): LogFn {\n    return this._getter(LogLevel.VERBOSE);\n  }\n\n  get debug(): LogFn {\n    return this._getter(LogLevel.Debug);\n  }\n\n  get info(): LogFn {\n    return this._getter(LogLevel.Info);\n  }\n\n  get warn(): LogFn {\n    return this._getter(LogLevel.Warn);\n  }\n\n  get error(): LogFn {\n    return this._getter(LogLevel.Error);\n  }\n\n  private _getter(level: LogLevel): LogFn {\n    if (level < this.level || this.level === LogLevel.Off) return (() => void 0);\n    if (process.env['NODE_ENV'] === 'development' && this.config.enableConsole && this.consoleTransport) {\n      return this.consoleTransport.bind(level, this.prefix);\n    }\n    const emit = this.emit.bind(this);\n    return function(...args: unknown[]) {\n      emit(level, String(args[0]), Array.prototype.slice.call(args, 1));\n    };\n  }\n\n}"]}

package/src/logger/logger.registry.d.ts

@@ -0,0 +1,13 @@
+import 'reflect-metadata';
+import { LogTransportType, LogTransportInterface, LoggingConfigType } from '../common';
+import { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';
+import ProviderRegistry from '../provider/provider.registry';
+import { LoggerRecord } from './logger.types';
+export default class LoggerRegistry extends RegistryAbstract<LogTransportInterface, LoggerRecord, LogTransportType[]> {
+    config: LoggingConfigType;
+    constructor(globalProviders: ProviderRegistry);
+    protected buildGraph(): void;
+    protected buildMap(list: LogTransportType[]): RegistryBuildMapResult<LoggerRecord>;
+    protected initialize(): Promise<void>;
+    protected bindLogger(): void;
+}

package/src/logger/logger.registry.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const common_1 = require("../common");
+const regsitry_1 = require("../regsitry");
+const logger_types_1 = require("./logger.types");
+const logger_utils_1 = require("./logger.utils");
+const front_mcp_tokens_1 = require("../front-mcp/front-mcp.tokens");
+const instance_console_logger_1 = require("./instances/instance.console-logger");
+const token_utils_1 = require("../utils/token.utils");
+const instance_logger_1 = require("./instances/instance.logger");
+class LoggerRegistry extends regsitry_1.RegistryAbstract {
+    config;
+    constructor(globalProviders) {
+        const { logging } = globalProviders.get(front_mcp_tokens_1.FrontMcpConfig);
+        const { transports, ...config } = logging;
+        const list = transports ?? [];
+        if (config.enableConsole) {
+            list.push(instance_console_logger_1.ConsoleLogTransportInstance);
+        }
+        super('LoggerRegistry', globalProviders, list);
+        this.config = config;
+    }
+    buildGraph() {
+        for (const token of this.tokens) {
+            const rec = this.defs.get(token);
+            const deps = (0, logger_utils_1.loggerDiscoveryDeps)(rec).slice(1);
+            for (const d of deps) {
+                if (!this.providers.get(d)) {
+                    throw new Error(`Logger ${(0, token_utils_1.tokenName)(token)} depends on ${(0, token_utils_1.tokenName)(d)}, which is not registered.`);
+                }
+                this.graph.get(token).add(d);
+            }
+        }
+    }
+    buildMap(list) {
+        const tokens = new Set();
+        const defs = new Map();
+        const graph = new Map();
+        for (const raw of list) {
+            const rec = (0, logger_utils_1.normalizeLogger)(raw);
+            const provide = rec.provide;
+            tokens.add(provide);
+            defs.set(provide, rec);
+            graph.set(provide, new Set());
+        }
+        return {
+            tokens,
+            defs,
+            graph,
+        };
+    }
+    async initialize() {
+        for (const token of this.tokens) {
+            const rec = this.defs.get(token);
+            const deps = this.graph.get(token);
+            const depsTokens = [...deps];
+            const depsInstances = await Promise.all(depsTokens.map((t) => this.providers.resolveBootstrapDep(t)));
+            let app;
+            if (rec.kind === logger_types_1.LoggerKind.CLASS_TOKEN) {
+                const LocalAppClass = rec.provide;
+                app = new LocalAppClass(this.config, ...depsInstances);
+            }
+            else {
+                throw Error('Invalid logger kind');
+            }
+            this.instances.set(token, app);
+        }
+        this.bindLogger();
+    }
+    bindLogger() {
+        const consoleTransport = this.instances.get(instance_console_logger_1.ConsoleLogTransportInstance);
+        const transports = [...this.instances.values()];
+        const getTransports = () => {
+            return { consoleTransport, transports };
+        };
+        const logger = new instance_logger_1.LoggerInstance(this.config, getTransports);
+        this.providers.injectProvider({
+            provide: common_1.FrontMcpLogger,
+            value: logger,
+            metadata: {
+                id: 'frontmcp-logger',
+                name: 'FrontMcpLogger',
+                scope: common_1.ProviderScope.GLOBAL,
+                description: 'Logger instance that transport logs to all registered transporters.',
+            },
+        });
+    }
+}
+exports.default = LoggerRegistry;
+//# sourceMappingURL=logger.registry.js.map

package/src/logger/logger.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.registry.js","sourceRoot":"","sources":["../../../src/logger/logger.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import 'reflect-metadata';\nimport {\n  FrontMcpLogger,\n  LogTransportType,\n  LogTransportInterface,\n  LoggingConfigType,\n  ProviderScope,\n  Token,\n} from '../common';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { LoggerKind, LoggerRecord } from './logger.types';\nimport { loggerDiscoveryDeps, normalizeLogger } from './logger.utils';\nimport { FrontMcpConfig } from '../front-mcp/front-mcp.tokens';\nimport { ConsoleLogTransportInstance } from './instances/instance.console-logger';\nimport { tokenName } from '../utils/token.utils';\nimport { GetTransports, LoggerInstance } from './instances/instance.logger';\n\nexport default class LoggerRegistry extends RegistryAbstract<LogTransportInterface, LoggerRecord, LogTransportType[]> {\n  config: LoggingConfigType;\n\n  constructor(globalProviders: ProviderRegistry) {\n    const { logging } = globalProviders.get(FrontMcpConfig);\n    const { transports, ...config } = logging;\n    const list = transports ?? [];\n    if (config.enableConsole) {\n      list.push(ConsoleLogTransportInstance);\n    }\n\n    super('LoggerRegistry', globalProviders, list);\n\n    this.config = config;\n  }\n\n  protected buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = loggerDiscoveryDeps(rec).slice(1);\n      for (const d of deps) {\n        if (!this.providers.get(d)) {\n          throw new Error(`Logger ${tokenName(token)} depends on ${tokenName(d)}, which is not registered.`);\n        }\n        this.graph.get(token)!.add(d);\n      }\n    }\n  }\n\n  protected override buildMap(list: LogTransportType[]): RegistryBuildMapResult<LoggerRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, LoggerRecord>();\n    const graph = new Map<Token, Set<Token>>();\n\n\n    for (const raw of list) {\n      const rec = normalizeLogger(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 {\n      tokens,\n      defs,\n      graph,\n    };\n  }\n\n  protected async initialize(): Promise<void> {\n\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = this.graph.get(token)!;\n\n      const depsTokens = [...deps];\n      const depsInstances = await Promise.all(depsTokens.map((t) => this.providers.resolveBootstrapDep(t)));\n\n      let app: LogTransportInterface;\n      if (rec.kind === LoggerKind.CLASS_TOKEN) {\n        const LocalAppClass = rec.provide;\n        app = new LocalAppClass(this.config, ...depsInstances);\n      } else {\n        throw Error('Invalid logger kind');\n      }\n\n      this.instances.set(token, app);\n    }\n    this.bindLogger();\n  }\n\n  protected bindLogger() {\n\n    const consoleTransport = this.instances.get(ConsoleLogTransportInstance) as ConsoleLogTransportInstance;\n    const transports = [...this.instances.values()];\n    const getTransports: GetTransports = () => {\n      return { consoleTransport, transports };\n    };\n    const logger = new LoggerInstance(this.config, getTransports);\n\n    this.providers.injectProvider({\n      provide: FrontMcpLogger,\n      value: logger,\n      metadata: {\n        id: 'frontmcp-logger',\n        name: 'FrontMcpLogger',\n        scope: ProviderScope.GLOBAL,\n        description: 'Logger instance that transport logs to all registered transporters.',\n      },\n    });\n  }\n\n}\n"]}

package/src/logger/logger.tokens.d.ts

@@ -0,0 +1 @@
+export {};

package/src/logger/logger.tokens.js

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

package/src/logger/logger.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.tokens.js","sourceRoot":"","sources":["../../../src/logger/logger.tokens.ts"],"names":[],"mappings":"","sourcesContent":["\n\n"]}

package/src/logger/logger.types.d.ts

@@ -0,0 +1,10 @@
+import { LogTransportInterface, LogTransportMetadata, Type } from '../common';
+export declare enum LoggerKind {
+    CLASS_TOKEN = "CLASS_TOKEN"
+}
+export type ClassTokenLogger = {
+    kind: LoggerKind.CLASS_TOKEN;
+    provide: Type<LogTransportInterface>;
+    metadata: LogTransportMetadata;
+};
+export type LoggerRecord = ClassTokenLogger;

package/src/logger/logger.types.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggerKind = void 0;
+var LoggerKind;
+(function (LoggerKind) {
+    LoggerKind["CLASS_TOKEN"] = "CLASS_TOKEN";
+})(LoggerKind || (exports.LoggerKind = LoggerKind = {}));
+//# sourceMappingURL=logger.types.js.map

package/src/logger/logger.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.types.js","sourceRoot":"","sources":["../../../src/logger/logger.types.ts"],"names":[],"mappings":";;;AAMA,IAAY,UAEX;AAFD,WAAY,UAAU;IACpB,yCAA2B,CAAA;AAC7B,CAAC,EAFW,UAAU,0BAAV,UAAU,QAErB","sourcesContent":["import {\n  LogTransportInterface,\n  LogTransportMetadata,\n  Type,\n} from '../common';\n\nexport enum LoggerKind {\n  CLASS_TOKEN = 'CLASS_TOKEN',\n}\n\nexport type ClassTokenLogger = {\n  kind: LoggerKind.CLASS_TOKEN;\n  provide: Type<LogTransportInterface>;\n  metadata: LogTransportMetadata\n};\n\nexport type LoggerRecord =\n  | ClassTokenLogger\n"]}

package/src/logger/logger.utils.d.ts

@@ -0,0 +1,15 @@
+import { LogTransportMetadata, LogTransportType, Token } from '../common';
+import { LoggerRecord } from './logger.types';
+export declare function collectLoggerMetadata(cls: LogTransportType): LogTransportMetadata;
+/**
+ * Normalize a raw app metadata list into useful maps/sets.
+ * - tokens: all provided tokens
+ * - defs: LoggerRecord by token
+ * - graph: initialized adjacency map (empty sets)
+ */
+export declare function normalizeLogger(item: any): LoggerRecord;
+/**
+ * For graph/cycle detection. Returns dependency tokens that should be graphed.
+ * - CLASS / CLASS_TOKEN: deps come from the class constructor
+ */
+export declare function loggerDiscoveryDeps(rec: LoggerRecord): Token[];

package/src/logger/logger.utils.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectLoggerMetadata = collectLoggerMetadata;
+exports.normalizeLogger = normalizeLogger;
+exports.loggerDiscoveryDeps = loggerDiscoveryDeps;
+const common_1 = require("../common");
+const metadata_utils_1 = require("../utils/metadata.utils");
+const token_utils_1 = require("../utils/token.utils");
+const logger_types_1 = require("./logger.types");
+function collectLoggerMetadata(cls) {
+    return Object.entries(common_1.FrontMcpLogTransportTokens).reduce((metadata, [key, token]) => {
+        return Object.assign(metadata, {
+            [key]: (0, metadata_utils_1.getMetadata)(token, cls),
+        });
+    }, {});
+}
+/**
+ * Normalize a raw app metadata list into useful maps/sets.
+ * - tokens: all provided tokens
+ * - defs: LoggerRecord by token
+ * - graph: initialized adjacency map (empty sets)
+ */
+function normalizeLogger(item) {
+    if ((0, token_utils_1.isClass)(item)) {
+        const metadata = collectLoggerMetadata(item);
+        return { kind: logger_types_1.LoggerKind.CLASS_TOKEN, provide: item, metadata };
+    }
+    const name = item?.name ?? String(item);
+    throw new Error(`Invalid app '${name}'. Expected a class or remote app config object.`);
+}
+/**
+ * For graph/cycle detection. Returns dependency tokens that should be graphed.
+ * - CLASS / CLASS_TOKEN: deps come from the class constructor
+ */
+function loggerDiscoveryDeps(rec) {
+    switch (rec.kind) {
+        // TODO: FEATURE/LOGGING add support for LoggerKind.VALUE as url based loggers
+        case logger_types_1.LoggerKind.CLASS_TOKEN:
+            return (0, token_utils_1.depsOfClass)(rec.provide, 'discovery');
+    }
+}
+//# sourceMappingURL=logger.utils.js.map

package/src/logger/logger.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.utils.js","sourceRoot":"","sources":["../../../src/logger/logger.utils.ts"],"names":[],"mappings":";;AAWA,sDAOC;AAQD,0CAQC;AAMD,kDAMC;AA9CD,sCAMmB;AACnB,4DAAsD;AACtD,sDAA4D;AAC5D,iDAA0D;AAE1D,SAAgB,qBAAqB,CAAC,GAAqB;IAEzD,OAAO,MAAM,CAAC,OAAO,CAAC,mCAA0B,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAClF,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,EAA0B,CAAC,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,IAAS;IACvC,IAAI,IAAA,qBAAO,EAAC,IAAI,CAAC,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC7C,OAAO,EAAE,IAAI,EAAE,yBAAU,CAAC,WAAW,EAAE,OAAO,EAAE,IAAmC,EAAE,QAAQ,EAAE,CAAC;IAClG,CAAC;IAED,MAAM,IAAI,GAAI,IAAY,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,kDAAkD,CAAC,CAAC;AAC1F,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,GAAiB;IACnD,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,8EAA8E;QAC9E,KAAK,yBAAU,CAAC,WAAW;YACzB,OAAO,IAAA,yBAAW,EAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;AACH,CAAC","sourcesContent":["import {\n  FrontMcpLogTransportTokens,\n  LogTransportMetadata,\n  LogTransportType,\n  Type, Token,\n  LogTransportInterface,\n} from '../common';\nimport { getMetadata } from '../utils/metadata.utils';\nimport { depsOfClass, isClass } from '../utils/token.utils';\nimport { LoggerKind, LoggerRecord } from './logger.types';\n\nexport function collectLoggerMetadata(cls: LogTransportType): LogTransportMetadata {\n\n  return Object.entries(FrontMcpLogTransportTokens).reduce((metadata, [key, token]) => {\n    return Object.assign(metadata, {\n      [key]: getMetadata(token, cls),\n    });\n  }, {} as LogTransportMetadata);\n}\n\n/**\n * Normalize a raw app metadata list into useful maps/sets.\n * - tokens: all provided tokens\n * - defs: LoggerRecord by token\n * - graph: initialized adjacency map (empty sets)\n */\nexport function normalizeLogger(item: any): LoggerRecord {\n  if (isClass(item)) {\n    const metadata = collectLoggerMetadata(item);\n    return { kind: LoggerKind.CLASS_TOKEN, provide: item as Type<LogTransportInterface>, metadata };\n  }\n\n  const name = (item as any)?.name ?? String(item);\n  throw new Error(`Invalid app '${name}'. Expected a class or remote app config object.`);\n}\n\n/**\n * For graph/cycle detection. Returns dependency tokens that should be graphed.\n * - CLASS / CLASS_TOKEN: deps come from the class constructor\n */\nexport function loggerDiscoveryDeps(rec: LoggerRecord): Token[] {\n  switch (rec.kind) {\n    // TODO: FEATURE/LOGGING add support for LoggerKind.VALUE as url based loggers\n    case LoggerKind.CLASS_TOKEN:\n      return depsOfClass(rec.provide, 'discovery');\n  }\n}\n"]}

package/src/plugin/plugin.registry.d.ts

@@ -0,0 +1,24 @@
+import 'reflect-metadata';
+import { PluginEntry, PluginRecord, PluginRegistryInterface, PluginType } from '../common';
+import ProviderRegistry from '../provider/provider.registry';
+import { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';
+export default class PluginRegistry extends RegistryAbstract<PluginEntry, PluginRecord, PluginType[]> implements PluginRegistryInterface {
+    /** providers by token */
+    private readonly pProviders;
+    /** providers by token */
+    private readonly pPlugins;
+    /** adapters by token */
+    private readonly pAdapters;
+    /** tools by token */
+    private readonly pTools;
+    /** resources by token */
+    private readonly pResources;
+    /** prompts by token */
+    private readonly pPrompts;
+    private readonly scope;
+    constructor(providers: ProviderRegistry, list: PluginType[]);
+    getPlugins(): PluginEntry[];
+    protected buildMap(list: PluginType[]): RegistryBuildMapResult<PluginRecord>;
+    protected buildGraph(): void;
+    protected initialize(): Promise<void>;
+}