@frontmcp/sdk 0.2.3 → 0.3.0

package/src/plugin/plugin.registry.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// plugin-registry.ts
+require("reflect-metadata");
+const common_1 = require("../common");
+const plugin_utils_1 = require("./plugin.utils");
+const provider_registry_1 = tslib_1.__importDefault(require("../provider/provider.registry"));
+const token_utils_1 = require("../utils/token.utils");
+const adapter_regsitry_1 = tslib_1.__importDefault(require("../adapter/adapter.regsitry"));
+const tool_registry_1 = tslib_1.__importDefault(require("../tool/tool.registry"));
+const resource_registry_1 = tslib_1.__importDefault(require("../resource/resource.registry"));
+const prompt_registry_1 = tslib_1.__importDefault(require("../prompt/prompt.registry"));
+const provider_utils_1 = require("../provider/provider.utils");
+const regsitry_1 = require("../regsitry");
+const hooks_utils_1 = require("../hooks/hooks.utils");
+class PluginRegistry extends regsitry_1.RegistryAbstract {
+    /** providers by token */
+    pProviders = new Map();
+    /** providers by token */
+    pPlugins = new Map();
+    /** adapters by token */
+    pAdapters = new Map();
+    /** tools by token */
+    pTools = new Map();
+    /** resources by token */
+    pResources = new Map();
+    /** prompts by token */
+    pPrompts = new Map();
+    scope;
+    constructor(providers, list) {
+        super('PluginRegistry', providers, list);
+        this.scope = providers.getActiveScope();
+    }
+    getPlugins() {
+        return [...this.instances.values()];
+    }
+    buildMap(list) {
+        const tokens = new Set();
+        const defs = new Map();
+        const graph = new Map();
+        for (const raw of list) {
+            const rec = (0, plugin_utils_1.normalizePlugin)(raw);
+            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, plugin_utils_1.pluginDiscoveryDeps)(rec);
+            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);
+            const deps = this.graph.get(token);
+            const providers = new provider_registry_1.default(rec.metadata.providers ?? [], this.providers);
+            await providers.ready;
+            const plugins = new PluginRegistry(providers, rec.metadata.plugins ?? []);
+            await plugins.ready;
+            const adapters = new adapter_regsitry_1.default(providers, rec.metadata.adapters ?? []);
+            await adapters.ready;
+            const tools = new tool_registry_1.default(providers, rec.metadata.tools ?? [], {
+                kind: 'plugin',
+                id: rec.metadata.name,
+                ref: token,
+            });
+            const resources = new resource_registry_1.default(providers, rec.metadata.resources ?? []);
+            const prompts = new prompt_registry_1.default(providers, rec.metadata.prompts ?? []);
+            await Promise.all([
+                tools.ready,
+                resources.ready,
+                prompts.ready,
+            ]);
+            this.pProviders.set(token, providers);
+            this.pPlugins.set(token, plugins);
+            this.pAdapters.set(token, adapters);
+            this.pTools.set(token, tools);
+            this.pResources.set(token, resources);
+            this.pPrompts.set(token, prompts);
+            /**
+             * Register exported providers to the parent providers registry.
+             */
+            const exported = (rec.metadata.exports ?? []).map(rawToken => {
+                const token = (0, provider_utils_1.normalizeProvider)(rawToken);
+                return providers.getProviderInfo(token.provide);
+            });
+            this.providers.mergeFromRegistry(providers, exported);
+            const depsTokens = [...deps];
+            const depsInstances = await Promise.all(depsTokens.map((t) => this.providers.resolveBootstrapDep(t)));
+            let pluginInstance;
+            if (rec.kind === common_1.PluginKind.CLASS) {
+                const klass = rec.useClass;
+                pluginInstance = new klass(...depsInstances);
+            }
+            else if (rec.kind === common_1.PluginKind.CLASS_TOKEN) {
+                const klass = rec.provide;
+                pluginInstance = new klass(...depsInstances);
+            }
+            else if (rec.kind === common_1.PluginKind.FACTORY) {
+                const deps = [...rec.inject()];
+                const args = [];
+                for (const d of deps)
+                    args.push(await this.providers.resolveBootstrapDep(d));
+                pluginInstance = rec.useFactory(...args);
+            }
+            else if (rec.kind === common_1.PluginKind.VALUE) {
+                pluginInstance = rec.useValue;
+            }
+            else {
+                throw Error('Invalid plugin kind');
+            }
+            const hooks = (0, hooks_utils_1.normalizeHooksFromCls)(pluginInstance);
+            if (hooks.length > 0) {
+                await this.scope.hooks.registerHooks(false, ...hooks);
+            }
+            pluginInstance.get = providers.get.bind(providers);
+            let dynamicProviders = rec.providers;
+            if (dynamicProviders) {
+                await providers.addDynamicProviders(dynamicProviders);
+            }
+            this.instances.set(token, pluginInstance);
+        }
+    }
+}
+exports.default = PluginRegistry;
+//# sourceMappingURL=plugin.registry.js.map

package/src/plugin/plugin.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.registry.js","sourceRoot":"","sources":["../../../src/plugin/plugin.registry.ts"],"names":[],"mappings":"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","sourcesContent":["// plugin-registry.ts\nimport 'reflect-metadata';\nimport {\n  FlowName,\n  PluginEntry,\n  PluginKind,\n  PluginRecord,\n  PluginRegistryInterface,\n  PluginType,\n  Token,\n} from '../common';\nimport {normalizePlugin, pluginDiscoveryDeps} from './plugin.utils';\nimport ProviderRegistry from '../provider/provider.registry';\nimport {tokenName} from '../utils/token.utils';\nimport AdapterRegistry from '../adapter/adapter.regsitry';\nimport ToolRegistry from '../tool/tool.registry';\nimport ResourceRegistry from '../resource/resource.registry';\nimport PromptRegistry from '../prompt/prompt.registry';\nimport {Ctor} from '../types/token.types';\nimport {normalizeProvider} from '../provider/provider.utils';\nimport {RegistryAbstract, RegistryBuildMapResult} from '../regsitry';\nimport {Scope} from \"../scope\";\nimport {normalizeHooksFromCls} from \"../hooks/hooks.utils\";\n\nexport default class PluginRegistry extends RegistryAbstract<PluginEntry, PluginRecord, PluginType[]> implements PluginRegistryInterface {\n  /** providers by token */\n  private readonly pProviders: Map<Token, ProviderRegistry> = new Map();\n  /** providers by token */\n  private readonly pPlugins: Map<Token, PluginRegistry> = new Map();\n  /** adapters by token */\n  private readonly pAdapters: Map<Token, AdapterRegistry> = new Map();\n  /** tools by token */\n  private readonly pTools: Map<Token, ToolRegistry> = new Map();\n  /** resources by token */\n  private readonly pResources: Map<Token, ResourceRegistry> = new Map();\n  /** prompts by token */\n  private readonly pPrompts: Map<Token, PromptRegistry> = new Map();\n\n  private readonly scope: Scope\n\n  constructor(providers: ProviderRegistry, list: PluginType[]) {\n    super('PluginRegistry', providers, list);\n    this.scope = providers.getActiveScope();\n  }\n\n  getPlugins(): PluginEntry[] {\n    return [...this.instances.values()];\n  }\n\n  protected override buildMap(list: PluginType[]): RegistryBuildMapResult<PluginRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, PluginRecord>();\n    const graph = new Map<Token, Set<Token>>();\n\n    for (const raw of list) {\n      const rec = normalizePlugin(raw);\n      const provide = rec.provide;\n      tokens.add(provide);\n      defs.set(provide, rec);\n      graph.set(provide, new Set());\n    }\n\n    return {tokens, defs, graph};\n  }\n\n  protected buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = pluginDiscoveryDeps(rec);\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      const deps = this.graph.get(token)!;\n\n      const providers = new ProviderRegistry(rec.metadata.providers ?? [], this.providers);\n      await providers.ready;\n\n      const plugins = new PluginRegistry(providers, rec.metadata.plugins ?? []);\n      await plugins.ready;\n\n      const adapters = new AdapterRegistry(providers, rec.metadata.adapters ?? []);\n      await adapters.ready;\n\n      const tools = new ToolRegistry(providers, rec.metadata.tools ?? [], {\n        kind: 'plugin',\n        id: rec.metadata.name,\n        ref: token,\n      });\n      const resources = new ResourceRegistry(providers, rec.metadata.resources ?? []);\n      const prompts = new PromptRegistry(providers, rec.metadata.prompts ?? []);\n\n      await Promise.all([\n        tools.ready,\n        resources.ready,\n        prompts.ready,\n      ]);\n\n      this.pProviders.set(token, providers);\n      this.pPlugins.set(token, plugins);\n      this.pAdapters.set(token, adapters);\n      this.pTools.set(token, tools);\n      this.pResources.set(token, resources);\n      this.pPrompts.set(token, prompts);\n\n      /**\n       * Register exported providers to the parent providers registry.\n       */\n      const exported = (rec.metadata.exports ?? []).map(rawToken => {\n        const token = normalizeProvider(rawToken);\n        return providers.getProviderInfo(token.provide);\n      });\n      this.providers.mergeFromRegistry(providers, exported);\n\n      const depsTokens = [...deps];\n      const depsInstances = await Promise.all(depsTokens.map((t) => this.providers.resolveBootstrapDep(t)));\n\n      let pluginInstance: PluginEntry;\n      if (rec.kind === PluginKind.CLASS) {\n        const klass = rec.useClass as any;\n        pluginInstance = new klass(...depsInstances);\n      } else if (rec.kind === PluginKind.CLASS_TOKEN) {\n        const klass = rec.provide as any;\n        pluginInstance = new (klass as Ctor<any>)(...depsInstances);\n      } else if (rec.kind === PluginKind.FACTORY) {\n        const deps = [...rec.inject()];\n        const args: any[] = [];\n        for (const d of deps) args.push(await this.providers.resolveBootstrapDep(d));\n        pluginInstance = rec.useFactory(...args);\n      } else if (rec.kind === PluginKind.VALUE) {\n        pluginInstance = (rec as any).useValue;\n      } else {\n        throw Error('Invalid plugin kind');\n      }\n\n      const hooks = normalizeHooksFromCls(pluginInstance);\n      if (hooks.length > 0) {\n        await this.scope.hooks.registerHooks(false, ...hooks);\n      }\n      pluginInstance.get = providers.get.bind(providers) as any;\n      let dynamicProviders = rec.providers;\n      if (dynamicProviders) {\n        await providers.addDynamicProviders(dynamicProviders)\n      }\n      this.instances.set(token, pluginInstance);\n    }\n  }\n\n\n}\n"]}

package/src/plugin/plugin.utils.d.ts

@@ -0,0 +1,10 @@
+import { PluginMetadata, PluginType, Token, PluginRecord } from '../common';
+export declare function collectPluginMetadata(cls: PluginType): PluginMetadata;
+export declare function normalizePlugin(item: PluginType): PluginRecord;
+/**
+ * For graph/cycle detection. Returns dependency tokens that should be graphed.
+ * - VALUE: no deps
+ * - FACTORY: only includes deps that are registered (others will be resolved)
+ * - CLASS / CLASS_TOKEN: deps come from the class constructor or static with(...)
+ */
+export declare function pluginDiscoveryDeps(rec: PluginRecord): Token[];

package/src/plugin/plugin.utils.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectPluginMetadata = collectPluginMetadata;
+exports.normalizePlugin = normalizePlugin;
+exports.pluginDiscoveryDeps = pluginDiscoveryDeps;
+const common_1 = require("../common");
+const token_utils_1 = require("../utils/token.utils");
+const metadata_utils_1 = require("../utils/metadata.utils");
+function collectPluginMetadata(cls) {
+    return Object.entries(common_1.FrontMcpPluginTokens).reduce((metadata, [key, token]) => {
+        return Object.assign(metadata, {
+            [key]: (0, metadata_utils_1.getMetadata)(token, cls),
+        });
+    }, {});
+}
+function normalizePlugin(item) {
+    if ((0, token_utils_1.isClass)(item)) {
+        // read McpPluginMetadata from class
+        const metadata = collectPluginMetadata(item);
+        return { kind: common_1.PluginKind.CLASS_TOKEN, provide: item, metadata };
+    }
+    if (item && typeof item === 'object') {
+        const { provide, useClass, useFactory, useValue, inject, ...metadata } = item;
+        if (!provide) {
+            const name = item?.name ?? '[object]';
+            throw new Error(`Plugin '${name}' is missing 'provide'.`);
+        }
+        if (useClass) {
+            if (!(0, token_utils_1.isClass)(useClass)) {
+                throw new Error(`'useClass' on plugin '${(0, token_utils_1.tokenName)(provide)}' must be a class.`);
+            }
+            return {
+                kind: common_1.PluginKind.CLASS,
+                provide,
+                useClass,
+                metadata,
+            };
+        }
+        if (useFactory) {
+            if (typeof useFactory !== 'function') {
+                throw new Error(`'useFactory' on plugin '${(0, token_utils_1.tokenName)(provide)}' must be a function.`);
+            }
+            const inj = typeof inject === 'function' ? inject : () => [];
+            return {
+                kind: common_1.PluginKind.FACTORY,
+                provide,
+                inject: inj,
+                useFactory,
+                metadata,
+            };
+        }
+        if ('useValue' in item) {
+            if (useValue === undefined || useValue === null) {
+                throw new Error(`'useValue' on plugin '${(0, token_utils_1.tokenName)(provide)}' must be defined.`);
+            }
+            const metadata = collectPluginMetadata(useValue.constructor);
+            return {
+                kind: common_1.PluginKind.VALUE,
+                provide,
+                useValue,
+                metadata,
+                providers: (item.providers ?? [])
+            };
+        }
+    }
+    const name = item?.name ?? String(item);
+    throw new Error(`Invalid plugin '${name}'. Expected a class or a plugin object.`);
+}
+/**
+ * For graph/cycle detection. Returns dependency tokens that should be graphed.
+ * - VALUE: no deps
+ * - FACTORY: only includes deps that are registered (others will be resolved)
+ * - CLASS / CLASS_TOKEN: deps come from the class constructor or static with(...)
+ */
+function pluginDiscoveryDeps(rec) {
+    switch (rec.kind) {
+        case common_1.PluginKind.VALUE:
+            return [];
+        case common_1.PluginKind.FACTORY: {
+            return [...rec.inject()];
+        }
+        case common_1.PluginKind.CLASS:
+            return (0, token_utils_1.depsOfClass)(rec.useClass, 'discovery').filter(v => v !== null && typeof v === 'object');
+        case common_1.PluginKind.CLASS_TOKEN:
+            return (0, token_utils_1.depsOfClass)(rec.provide, 'discovery').filter(v => v !== null && typeof v === 'object');
+    }
+}
+//# sourceMappingURL=plugin.utils.js.map

package/src/plugin/plugin.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.utils.js","sourceRoot":"","sources":["../../../src/plugin/plugin.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  PluginMetadata,\n  PluginType,\n  FrontMcpPluginTokens,\n  Token, PluginRecord, PluginKind,\n} from '../common';\nimport {depsOfClass, isClass, tokenName} from '../utils/token.utils';\nimport {getMetadata} from '../utils/metadata.utils';\n\nexport function collectPluginMetadata(cls: PluginType): PluginMetadata {\n  return Object.entries(FrontMcpPluginTokens).reduce((metadata, [key, token]) => {\n    return Object.assign(metadata, {\n      [key]: getMetadata(token, cls),\n    });\n  }, {} as PluginMetadata);\n}\n\n\nexport function normalizePlugin(item: PluginType): PluginRecord {\n  if (isClass(item)) {\n    // read McpPluginMetadata from class\n    const metadata = collectPluginMetadata(item);\n    return {kind: PluginKind.CLASS_TOKEN, provide: item, metadata};\n  }\n  if (item && typeof item === 'object') {\n    const {provide, useClass, useFactory, useValue, inject, ...metadata} = item as any;\n\n    if (!provide) {\n      const name = (item as any)?.name ?? '[object]';\n      throw new Error(`Plugin '${name}' is missing 'provide'.`);\n    }\n\n    if (useClass) {\n      if (!isClass(useClass)) {\n        throw new Error(\n          `'useClass' on plugin '${tokenName(provide)}' must be a class.`,\n        );\n      }\n      return {\n        kind: PluginKind.CLASS,\n        provide,\n        useClass,\n        metadata,\n      };\n    }\n\n    if (useFactory) {\n      if (typeof useFactory !== 'function') {\n        throw new Error(\n          `'useFactory' on plugin '${tokenName(provide)}' must be a function.`,\n        );\n      }\n      const inj = typeof inject === 'function' ? inject : () => [] as const;\n      return {\n        kind: PluginKind.FACTORY,\n        provide,\n        inject: inj,\n        useFactory,\n        metadata,\n      };\n    }\n\n    if ('useValue' in item) {\n      if (useValue === undefined || useValue === null) {\n        throw new Error(`'useValue' on plugin '${tokenName(provide)}' must be defined.`);\n      }\n      const metadata = collectPluginMetadata(useValue.constructor);\n      return {\n        kind: PluginKind.VALUE,\n        provide,\n        useValue,\n        metadata,\n        providers: (item.providers ?? []) as any\n      };\n    }\n  }\n\n  const name = (item as any)?.name ?? String(item);\n  throw new Error(\n    `Invalid plugin '${name}'. Expected a class or a plugin object.`,\n  );\n}\n\n/**\n * For graph/cycle detection. Returns dependency tokens that should be graphed.\n * - VALUE: no deps\n * - FACTORY: only includes deps that are registered (others will be resolved)\n * - CLASS / CLASS_TOKEN: deps come from the class constructor or static with(...)\n */\nexport function pluginDiscoveryDeps(\n  rec: PluginRecord,\n): Token[] {\n  switch (rec.kind) {\n    case PluginKind.VALUE:\n      return []\n    case PluginKind.FACTORY: {\n      return [...rec.inject()];\n    }\n    case PluginKind.CLASS:\n      return depsOfClass(rec.useClass, 'discovery').filter(v => v !== null && typeof v === 'object');\n\n    case PluginKind.CLASS_TOKEN:\n      return depsOfClass(rec.provide, 'discovery').filter(v => v !== null && typeof v === 'object');\n  }\n}"]}

package/src/prompt/prompt.registry.d.ts

@@ -0,0 +1,16 @@
+import ProviderRegistry from '../provider/provider.registry';
+import { PromptEntry, PromptRecord, PromptRegistryInterface, PromptType } from '../common';
+import { RegistryAbstract } from '../regsitry';
+export default class PromptRegistry extends RegistryAbstract<PromptEntry, PromptRecord, PromptType[]> implements PromptRegistryInterface {
+    constructor(providers: ProviderRegistry, list: PromptType[]);
+    protected buildMap(list: PromptType[]): {
+        tokens: Set<import("../common").Reference<any>>;
+        defs: Map<import("../common").Reference<any>, PromptRecord>;
+        graph: Map<import("../common").Reference<any>, Set<import("../common").Reference<any>>>;
+    };
+    buildGraph(): void;
+    protected initialize(): Promise<void>;
+    hasAny(): boolean;
+    getPrompts(): never[];
+    getInlinePrompts(): PromptEntry[];
+}

package/src/prompt/prompt.registry.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const regsitry_1 = require("../regsitry");
+class PromptRegistry extends regsitry_1.RegistryAbstract {
+    constructor(providers, list) {
+        super('PromptRegistry', providers, list);
+    }
+    buildMap(list) {
+        const tokens = new Set();
+        const defs = new Map();
+        const graph = new Map();
+        return {
+            tokens,
+            defs,
+            graph,
+        };
+    }
+    buildGraph() {
+    }
+    initialize() {
+        return Promise.resolve();
+    }
+    hasAny() {
+        return this.tokens.size > 0;
+    }
+    getPrompts() {
+        return [];
+    }
+    getInlinePrompts() {
+        return [];
+    }
+}
+exports.default = PromptRegistry;
+//# sourceMappingURL=prompt.registry.js.map

package/src/prompt/prompt.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.registry.js","sourceRoot":"","sources":["../../../src/prompt/prompt.registry.ts"],"names":[],"mappings":";;AAEA,0CAA+C;AAG/C,MAAqB,cAAe,SAAQ,2BAAyD;IAEnG,YAAY,SAA2B,EAAE,IAAkB;QACzD,KAAK,CAAC,gBAAgB,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAGS,QAAQ,CAAC,IAAkB;QACnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAS,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;QAE3C,OAAO;YACL,MAAM;YACN,IAAI;YACJ,KAAK;SACN,CAAC;IACJ,CAAC;IAED,UAAU;IAEV,CAAC;IAES,UAAU;QAClB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,UAAU;QACR,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,gBAAgB;QACd,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAtCD,iCAsCC","sourcesContent":["import ProviderRegistry from '../provider/provider.registry';\nimport { PromptEntry, PromptRecord, PromptRegistryInterface, PromptType, Token } from '../common';\nimport { RegistryAbstract } from '../regsitry';\n\n\nexport default class PromptRegistry extends RegistryAbstract<PromptEntry, PromptRecord, PromptType[]> implements PromptRegistryInterface {\n\n  constructor(providers: ProviderRegistry, list: PromptType[]) {\n    super('PromptRegistry', providers, list);\n  }\n\n\n  protected buildMap(list: PromptType[]) {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, PromptRecord>();\n    const graph = new Map<Token, Set<Token>>();\n\n    return {\n      tokens,\n      defs,\n      graph,\n    };\n  }\n\n  buildGraph() {\n\n  }\n\n  protected initialize() {\n    return Promise.resolve();\n  }\n\n  hasAny() {\n    return this.tokens.size > 0;\n  }\n\n  getPrompts() {\n    return [];\n  }\n\n  getInlinePrompts(): PromptEntry[] {\n    return [];\n  }\n}\n"]}

package/src/provider/provider.registry.d.ts

@@ -0,0 +1,75 @@
+import 'reflect-metadata';
+import { ProviderInterface, ProviderType, ProviderScope, Token, ProviderRegistryInterface, ProviderRecord, ProviderInjectedRecord, RegistryKind, RegistryType, ProviderEntry, FrontMcpServer } from '../common';
+import { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';
+import { ProviderViews } from './provider.types';
+import { Scope } from '../scope';
+import HookRegistry from "../hooks/hook.registry";
+export default class ProviderRegistry extends RegistryAbstract<ProviderEntry, ProviderRecord, ProviderType[], ProviderRegistry | undefined> implements ProviderRegistryInterface {
+    private readonly parentProviders?;
+    /** used to track which registry provided which token */
+    private readonly providedBy;
+    /** topo order (deps first) */
+    private order;
+    private registries;
+    constructor(list: ProviderType[], parentProviders?: ProviderRegistry | undefined);
+    getProviders(): ProviderEntry[];
+    /** Walk up the registry chain to find a def for a token. */
+    private lookupDefInHierarchy;
+    /** Resolve a DEFAULT-scoped dependency from the hierarchy, enforcing scope & instantiation. */
+    private resolveDefaultFromHierarchy;
+    protected buildMap(list: ProviderType[]): RegistryBuildMapResult<ProviderRecord>;
+    protected buildGraph(): void;
+    protected topoSort(): void;
+    /** Incremental instantiation for DEFAULT providers.
+     *  - Skips already-built singletons unless force:true.
+     *  - Can limit to a subset via onlyTokens.
+     */
+    protected initialize(opts?: {
+        force?: boolean;
+        onlyTokens?: Iterable<Token>;
+    }): Promise<void>;
+    /** Return the live singleton map as a read-only view. No copying. */
+    getAllSingletons(): ReadonlyMap<Token, unknown>;
+    discoveryDeps(rec: ProviderRecord): Token[];
+    invocationTokens(_token: Token, rec: ProviderRecord): Token[];
+    getScope(rec: ProviderRecord): ProviderScope;
+    private withTimeout;
+    private resolveFactoryArg;
+    /** Build a single DEFAULT-scoped singleton (used by incremental instantiating). */
+    private initiateOne;
+    private buildIntoStore;
+    private resolveManagedForClass;
+    get<T>(token: Token<T>): T;
+    addRegistry(type: RegistryKind, value: RegistryType): void;
+    getRegistries<T extends RegistryKind>(type: T): RegistryType[T][];
+    getHooksRegistry(): HookRegistry;
+    getScopeRegistry(): import("../common").ScopeRegistryInterface;
+    /** bootstrap helper: resolve a dependency usable during app bootstrap (must be GLOBAL). */
+    resolveBootstrapDep(t: Token): Promise<any>;
+    /** Lightweight, synchronous resolver for app-scoped DI.
+     *  - If `cls` is a registered DEFAULT provider token, returns the singleton (must be instantiated).
+     *  - If `cls` is SCOPED in DI, throws (use getScoped/buildViews instead).
+     *  - Otherwise, if `cls` is a constructable class not registered in DI, returns `new cls()`.
+     *    If it defines a synchronous init(), it will be invoked (async init() is NOT awaited).
+     */
+    resolve<T>(cls: any): T;
+    mergeFromRegistry(providedBy: ProviderRegistry, exported: {
+        token: Token<ProviderInterface>;
+        def: ProviderRecord;
+        instance: ProviderEntry;
+    }[]): void;
+    /**
+     * Used by plugins to get the exported provider definitions.
+     */
+    getProviderInfo(token: Token<ProviderInterface>): {
+        token: import("../common").Reference<ProviderInterface>;
+        def: ProviderRecord;
+        instance: ProviderEntry;
+    };
+    injectProvider(injected: Omit<ProviderInjectedRecord, 'kind'>): void;
+    addDynamicProviders(dynamicProviders: ProviderRecord[]): Promise<void[]>;
+    private getWithParents;
+    getActiveScope(): Scope;
+    getActiveServer(): FrontMcpServer;
+    buildViews(session: string): Promise<ProviderViews>;
+}