@frontmcp/sdk 0.6.0 → 0.6.2

package/src/tool/tool.instance.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool.instance.js","sourceRoot":"","sources":["../../../src/tool/tool.instance.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/tool/tool.instance.ts\n\nimport {\n  EntryOwnerRef,\n  ToolCallArgs,\n  ToolCallExtra,\n  ToolContext,\n  ToolCtorArgs,\n  ToolEntry,\n  ToolFunctionTokenRecord,\n  ToolInputType,\n  ToolKind,\n  ToolOutputType,\n  ToolRecord,\n  ParsedToolResult,\n  ToolInputOf,\n  ToolOutputOf,\n  SafeTransformResult,\n} from '../common';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { z } from 'zod';\nimport HookRegistry from '../hooks/hook.registry';\nimport { Scope } from '../scope';\nimport { normalizeHooksFromCls } from '../hooks/hooks.utils';\nimport type { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';\nimport { buildParsedToolResult } from './tool.utils';\nimport { InvalidHookFlowError } from '../errors/mcp.error';\n\nexport class ToolInstance<\n  InSchema extends ToolInputType = ToolInputType,\n  OutSchema extends ToolOutputType = ToolOutputType,\n  In = ToolInputOf<{ inputSchema: InSchema }>,\n  Out = ToolOutputOf<{ outputSchema: OutSchema }>,\n> extends ToolEntry<InSchema, OutSchema, In, Out> {\n  private readonly providers: ProviderRegistry;\n  readonly scope: Scope;\n  readonly hooks: HookRegistry;\n\n  constructor(record: ToolRecord, providers: ProviderRegistry, owner: EntryOwnerRef) {\n    super(record);\n    this.owner = owner;\n    this.providers = providers;\n    this.name = record.metadata.id || record.metadata.name;\n    this.fullName = this.owner.id + ':' + this.name;\n    this.scope = this.providers.getActiveScope();\n    this.hooks = this.scope.providers.getHooksRegistry();\n\n    const schema: any = record.metadata.inputSchema;\n    // Support both Zod objects and raw ZodRawShape\n    this.inputSchema = schema instanceof z.ZodObject ? schema.shape : schema ?? {};\n\n    // Whatever JSON schema representation you’re storing for inputs\n    this.rawInputSchema = record.metadata.rawInputSchema;\n\n    // IMPORTANT: keep the *raw* outputSchema (string literal, zod, raw shape, or array)\n    this.outputSchema = record.metadata.outputSchema as OutSchema;\n\n    this.ready = this.initialize();\n  }\n\n  protected async initialize() {\n    // Valid flows for tool hooks\n    const validFlows = ['tools:call-tool', 'tools:list-tools'];\n\n    const allHooks = normalizeHooksFromCls(this.record.provide);\n\n    // Separate valid and invalid hooks\n    const validHooks = allHooks.filter((hook) => validFlows.includes(hook.metadata.flow));\n    const invalidHooks = allHooks.filter((hook) => !validFlows.includes(hook.metadata.flow));\n\n    // Throw error for invalid hooks (fail fast)\n    if (invalidHooks.length > 0) {\n      const className = (this.record.provide as any)?.name ?? 'Unknown';\n      const invalidFlowNames = invalidHooks.map((h) => h.metadata.flow).join(', ');\n      throw new InvalidHookFlowError(\n        `Tool \"${className}\" has hooks for unsupported flows: ${invalidFlowNames}. ` +\n          `Only tool flows (${validFlows.join(', ')}) are supported on tool classes.`,\n      );\n    }\n\n    // Register valid hooks\n    if (validHooks.length > 0) {\n      await this.hooks.registerHooks(true, ...validHooks);\n    }\n    return Promise.resolve();\n  }\n\n  getMetadata() {\n    return this.record.metadata;\n  }\n\n  override getOutputSchema() {\n    return this.outputSchema;\n  }\n\n  override create(input: ToolCallArgs, ctx: ToolCallExtra): ToolContext<InSchema, OutSchema, In, Out> {\n    const metadata = this.metadata;\n    const providers = this.providers;\n    const scope = this.providers.getActiveScope();\n    const logger = scope.logger;\n    const authInfo = ctx.authInfo;\n\n    const toolCtorArgs: ToolCtorArgs<In> = {\n      metadata,\n      input: input as In,\n      providers,\n      logger,\n      authInfo,\n    };\n    switch (this.record.kind) {\n      case ToolKind.CLASS_TOKEN:\n        return new this.record.provide(toolCtorArgs) as ToolContext<InSchema, OutSchema, In, Out>;\n      case ToolKind.FUNCTION:\n        return new FunctionToolContext<InSchema, OutSchema, In, Out>(this.record, toolCtorArgs);\n    }\n  }\n\n  override parseInput(input: CallToolRequest['params']): CallToolRequest['params']['arguments'] {\n    const inputSchema = z.object(this.inputSchema);\n    return inputSchema.parse(input.arguments);\n  }\n  /**\n   * Turn the raw tool function result into an MCP-compliant CallToolResult:\n   *   - `content`: list of ContentBlocks (text / image / audio / resource / resource_link)\n   *   - `structuredContent`: sanitized JSON when outputSchema is \"json-like\"\n   *\n   * Rules:\n   *   - If outputSchema is a JS array → multiple content items, each with its own type.\n   *   - Primitive → stringifies into a TextContent block.\n   *   - image/audio/resource/resource_link → passed through as-is.\n   *   - JSON / structured → JSON.stringify for text, and full sanitized JSON in structuredContent.\n   */\n  override parseOutput(raw: Out | Partial<Out> | any): ParsedToolResult {\n    const descriptor = this.outputSchema as any;\n\n    return buildParsedToolResult(descriptor, raw);\n  }\n\n  override safeParseOutput(raw: Out | Partial<Out> | any): SafeTransformResult<ParsedToolResult> {\n    const descriptor = this.outputSchema as any;\n    try {\n      return { success: true, data: buildParsedToolResult(descriptor, raw) };\n    } catch (error: any) {\n      return { success: false, error };\n    }\n  }\n}\n\nclass FunctionToolContext<\n  InSchema extends ToolInputType,\n  OutSchema extends ToolOutputType,\n  In = ToolInputOf<{ inputSchema: InSchema }>,\n  Out = ToolOutputOf<{ outputSchema: OutSchema }>,\n> extends ToolContext<InSchema, OutSchema, In, Out> {\n  constructor(private readonly record: ToolFunctionTokenRecord, args: ToolCtorArgs<In>) {\n    super(args);\n  }\n\n  execute(input: In): Promise<Out> {\n    return this.record.provide(input, this);\n  }\n}\n"]}

package/src/tool/tool.registry.js

@@ -1,353 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const utils_1 = require("../utils");
-const tool_events_1 = require("./tool.events");
-const tool_utils_1 = require("./tool.utils");
-const regsitry_1 = require("../regsitry");
-const tool_instance_1 = require("./tool.instance");
-const tool_types_1 = require("./tool.types");
-const tools_list_flow_1 = tslib_1.__importDefault(require("./flows/tools-list.flow"));
-const call_tool_flow_1 = tslib_1.__importDefault(require("./flows/call-tool.flow"));
-class ToolRegistry extends regsitry_1.RegistryAbstract {
-    /** Who owns this registry (used for provenance). Optional. */
-    owner;
-    /** Tools truly owned/constructed by THIS registry (with lineage applied) */
-    localRows = [];
-    /** Adopted tool rows from each child registry (references to the same instances) */
-    adopted = new Map();
-    /** Children registries that we track */
-    children = new Set();
-    // ---- O(1) indexes over EFFECTIVE set (local + adopted) ----
-    byQualifiedId = new Map(); // qualifiedId -> row
-    byName = new Map(); // baseName -> rows
-    byOwnerAndName = new Map(); // "ownerKey:name" -> row
-    byProviderAndName = new Map(); // "providerId:name" -> row (best-effort)
-    byOwner = new Map(); // ownerKey -> rows
-    // version + emitter
-    version = 0;
-    emitter = new tool_events_1.ToolEmitter();
-    constructor(providers, list, owner) {
-        // disable auto so subclass fields initialize first
-        super('ToolRegistry', providers, list, false);
-        this.owner = owner;
-        // now it’s safe to run the lifecycle
-        this.buildGraph();
-        this.ready = this.initialize();
-    }
-    /* -------------------- Build-time: defs + dep checks -------------------- */
-    buildMap(list) {
-        const tokens = new Set();
-        const defs = new Map();
-        const graph = new Map();
-        for (const raw of list) {
-            const rec = (0, tool_utils_1.normalizeTool)(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, tool_utils_1.toolDiscoveryDeps)(rec);
-            for (const d of deps) {
-                // Validate against hierarchical providers; throws early if missing
-                this.providers.get(d);
-                this.graph.get(token).add(d);
-            }
-        }
-    }
-    /* -------------------- Initialize: create ONE FrontMcpToolInstance per local tool -------------------- */
-    async initialize() {
-        // Instantiate each local tool once and store in this.instances (from RegistryAbstract)
-        for (const token of this.tokens) {
-            const rec = this.defs.get(token);
-            // Single, authoritative instance per local tool
-            const ti = new tool_instance_1.ToolInstance(rec, this.providers, this.owner);
-            this.instances.set(token, ti);
-            const lineage = this.owner ? [this.owner] : [];
-            const row = this.makeRow(token, ti, lineage, this);
-            this.localRows.push(row);
-        }
-        const childAppRegistries = this.providers.getRegistries('AppRegistry');
-        childAppRegistries.forEach((appRegistry) => {
-            const apps = appRegistry.getApps();
-            for (const app of apps) {
-                const appToolsRegistries = app.providers.getRegistries('ToolRegistry');
-                appToolsRegistries
-                    .filter((t) => t.owner.kind === 'app')
-                    .forEach((appToolRegistry) => {
-                    this.adoptFromChild(appToolRegistry, appToolRegistry.owner);
-                });
-            }
-        });
-        const childToolRegistries = this.providers.getRegistries('ToolRegistry');
-        childToolRegistries
-            .filter((t) => t != this)
-            .forEach((toolRegistry) => {
-            this.adoptFromChild(toolRegistry, toolRegistry.owner);
-        });
-        // Build effective indexes from (locals + already adopted children)
-        this.reindex();
-        this.bump('reset');
-        const scope = this.providers.getActiveScope();
-        await scope.registryFlows(tools_list_flow_1.default, call_tool_flow_1.default);
-    }
-    /* -------------------- Adoption: reference child instances (no cloning) -------------------- */
-    /**
-     * Adopt tools from a child registry. Parent runs after children are ready.
-     * We *reference* the child's tool instances; no duplicates are created.
-     *
-     * IMPORTANT:
-     * - Child rows already include the child's own lineage (e.g., adapter:openapi).
-     * - Here we only prepend the **parent's** owner, to avoid double-prefixing the child.
-     */
-    adoptFromChild(child, _childOwner) {
-        if (this.children.has(child))
-            return;
-        const childRows = child.listAllIndexed(); // includes child's lineage
-        const prepend = this.owner ? [this.owner] : [];
-        const adoptedRows = childRows.map((r) => this.relineage(r, prepend));
-        this.adopted.set(child, adoptedRows);
-        this.children.add(child);
-        // keep live if child changes
-        child.subscribe({ immediate: false }, () => {
-            const latest = child.listAllIndexed().map((r) => this.relineage(r, prepend));
-            this.adopted.set(child, latest);
-            this.reindex();
-            this.bump('reset');
-        });
-        this.reindex();
-        this.bump('reset');
-    }
-    // NOTE: `any` is intentional here - heterogeneous tool collections can't use `unknown`
-    // because ToolEntry has constrained generics (InSchema extends ToolInputType, etc.)
-    getTools(includeHidden = false) {
-        const local = [...this.localRows].flat().map((t) => t.instance);
-        const adopted = [...this.adopted.values()].flat().map((t) => t.instance);
-        return [...local, ...adopted].filter((t) => t.metadata.hideFromDiscovery !== true || includeHidden);
-    }
-    // NOTE: `any` is intentional - see getTools comment above
-    getInlineTools() {
-        return [...this.instances.values()];
-    }
-    /** Internal snapshot of effective indexed rows (locals + adopted). */
-    listAllIndexed() {
-        return [...this.localRows, ...[...this.adopted.values()].flat()];
-    }
-    /* -------------------- Indexing & lookups -------------------- */
-    reindex() {
-        const effective = this.listAllIndexed();
-        this.byQualifiedId.clear();
-        this.byName.clear();
-        this.byOwnerAndName.clear();
-        this.byProviderAndName.clear();
-        this.byOwner.clear();
-        for (const r of effective) {
-            this.byQualifiedId.set(r.qualifiedId, r);
-            const listByName = this.byName.get(r.baseName) ?? [];
-            listByName.push(r);
-            this.byName.set(r.baseName, listByName);
-            const byOwnerKey = this.byOwner.get(r.ownerKey) ?? [];
-            byOwnerKey.push(r);
-            this.byOwner.set(r.ownerKey, byOwnerKey);
-            const on = `${r.ownerKey}:${r.baseName}`;
-            if (!this.byOwnerAndName.has(on))
-                this.byOwnerAndName.set(on, r);
-            const provId = this.providerIdOf(r.instance);
-            if (provId) {
-                const pn = `${provId}:${r.baseName}`;
-                if (!this.byProviderAndName.has(pn))
-                    this.byProviderAndName.set(pn, r);
-            }
-        }
-    }
-    /** List all instances (locals + adopted). */
-    listAllInstances() {
-        return this.listAllIndexed().map((r) => r.instance);
-    }
-    /** List instances by owner path (e.g. "app:Portal/plugin:Okta") */
-    listByOwner(ownerPath) {
-        return (this.byOwner.get(ownerPath) ?? []).map((r) => r.instance);
-    }
-    /* -------------------- Conflict-aware exported names -------------------- */
-    /**
-     * Produce unique, MCP-valid exported names.
-     * - Base (standardized) = metadata.name cased (snake/camel/kebab/dot)
-     * - If conflicting:
-     *    - Locals keep bare base (unless >1 locals conflict → they get owner prefixes)
-     *    - Children with same base get prefixed by providerId (or owner path)
-     */
-    exportResolvedNames(opts) {
-        const cfg = { ...tool_types_1.DEFAULT_EXPORT_OPTS, ...(opts ?? {}) };
-        const rows = this.listAllIndexed().map((r) => {
-            const base = (0, tool_utils_1.normalizeSegment)(r.baseName, cfg.case);
-            const isLocal = r.source === this;
-            const provider = (0, tool_utils_1.normalizeProviderId)(this.providerIdOf(r.instance), cfg.case);
-            const ownerPath = (0, tool_utils_1.normalizeOwnerPath)(r.ownerKey, cfg.case);
-            return { base, row: r, isLocal, provider, ownerPath };
-        });
-        // group by standardized base
-        const byBase = new Map();
-        for (const r of rows) {
-            const list = byBase.get(r.base) ?? [];
-            list.push(r);
-            byBase.set(r.base, list);
-        }
-        const out = new Map();
-        for (const [base, group] of byBase.entries()) {
-            if (group.length === 1) {
-                const g = group[0];
-                out.set((0, tool_utils_1.ensureMaxLen)(base, cfg.maxLen), g.row.instance);
-                continue;
-            }
-            const locals = group.filter((g) => g.isLocal);
-            const children = group.filter((g) => !g.isLocal);
-            if (cfg.prefixChildrenOnConflict && locals.length > 0) {
-                // Locals
-                if (locals.length === 1) {
-                    const localName = (0, tool_utils_1.ensureMaxLen)(base, cfg.maxLen);
-                    out.set(disambiguate(localName, out, cfg), locals[0].row.instance);
-                }
-                else {
-                    for (const l of locals) {
-                        const pref = (0, tool_utils_1.normalizeOwnerPath)(l.ownerPath, cfg.case);
-                        const name = (0, tool_utils_1.ensureMaxLen)(`${pref}${(0, tool_utils_1.sepFor)(cfg.case)}${base}`, cfg.maxLen);
-                        out.set(disambiguate(name, out, cfg), l.row.instance);
-                    }
-                }
-                // Children
-                for (const c of children) {
-                    const pre = cfg.prefixSource === 'provider' ? c.provider ?? c.ownerPath : c.ownerPath;
-                    const name = (0, tool_utils_1.ensureMaxLen)(`${pre}${(0, tool_utils_1.sepFor)(cfg.case)}${base}`, cfg.maxLen);
-                    out.set(disambiguate(name, out, cfg), c.row.instance);
-                }
-            }
-            else {
-                // Prefix everyone by source
-                for (const r of group) {
-                    const pre = cfg.prefixSource === 'provider' ? r.provider ?? r.ownerPath : r.ownerPath;
-                    const name = (0, tool_utils_1.ensureMaxLen)(`${pre}${(0, tool_utils_1.sepFor)(cfg.case)}${base}`, cfg.maxLen);
-                    out.set(disambiguate(name, out, cfg), r.row.instance);
-                }
-            }
-        }
-        return [...out.entries()].sort((a, b) => a[0].localeCompare(b[0])).map(([name, instance]) => ({ name, instance }));
-        function disambiguate(candidate, pool, cfg) {
-            if (!pool.has(candidate))
-                return candidate;
-            let n = 2;
-            while (true) {
-                const withN = (0, tool_utils_1.ensureMaxLen)(`${candidate}${(0, tool_utils_1.sepFor)(cfg.case)}${n}`, cfg.maxLen);
-                if (!pool.has(withN))
-                    return withN;
-                n++;
-            }
-        }
-    }
-    /** Lookup by the exported (resolved) name. */
-    getExported(name, opts) {
-        const pairs = this.exportResolvedNames(opts);
-        return pairs.find((p) => p.name === name)?.instance;
-    }
-    /* -------------------- Subscriptions -------------------- */
-    subscribe(opts, cb) {
-        const filter = opts.filter ?? (() => true);
-        if (opts.immediate) {
-            cb({
-                kind: 'reset',
-                changeScope: 'global',
-                version: this.version,
-                snapshot: this.listAllInstances().filter(filter),
-            });
-        }
-        return this.emitter.on((e) => cb({ ...e, snapshot: this.listAllInstances().filter(filter) }));
-    }
-    bump(kind) {
-        const version = ++this.version;
-        this.emitter.emit({ kind, changeScope: 'global', version, snapshot: this.listAllInstances() });
-    }
-    /* -------------------- Helpers -------------------- */
-    /** Build an IndexedTool row */
-    makeRow(token, instance, lineage, source) {
-        const ownerKey = (0, tool_utils_1.ownerKeyOf)(lineage);
-        const baseName = instance.name;
-        const qualifiedName = (0, tool_utils_1.qualifiedNameOf)(lineage, baseName);
-        const qualifiedId = `${ownerKey}:${(0, utils_1.tokenName)(token)}`;
-        return { token, instance, baseName, lineage, ownerKey, qualifiedName, qualifiedId, source };
-    }
-    /** Clone a child row and prepend lineage (with adjacent de-dup to avoid double prefixes). */
-    relineage(row, prepend) {
-        const merged = [...prepend, ...row.lineage];
-        const lineage = dedupLineage(merged);
-        const ownerKey = (0, tool_utils_1.ownerKeyOf)(lineage);
-        const qualifiedName = (0, tool_utils_1.qualifiedNameOf)(lineage, row.baseName);
-        const qualifiedId = `${ownerKey}:${(0, utils_1.tokenName)(row.token)}`;
-        return {
-            token: row.token,
-            instance: row.instance, // REFERENCE the same instance
-            baseName: row.baseName,
-            lineage,
-            ownerKey,
-            qualifiedName,
-            qualifiedId,
-            source: row.source, // keep original source (who constructed instance)
-        };
-    }
-    /** Best-effort provider id used for prefixing (inspects class metadata if present). */
-    providerIdOf(inst) {
-        // Try reading provider id from the tool class metadata (if your decorators set one)
-        try {
-            const meta = inst.getMetadata?.();
-            const maybe = meta?.providerId ?? meta?.provider ?? meta?.ownerId ?? undefined;
-            if (typeof maybe === 'string' && maybe.length)
-                return maybe;
-            const cls = meta && meta.cls ? meta.cls : undefined;
-            if (cls) {
-                const id = (0, utils_1.getMetadata)('id', cls);
-                if (typeof id === 'string' && id.length)
-                    return id;
-                if (cls.name)
-                    return cls.name;
-            }
-        }
-        catch {
-            /* ignore */
-        }
-        return undefined;
-    }
-    /** True if this registry (or adopted children) has any tools. */
-    hasAny() {
-        return this.listAllIndexed().length > 0 || this.tokens.size > 0;
-    }
-    /**
-     * Get the MCP capabilities for tools.
-     * These are reported to clients during initialization.
-     */
-    getCapabilities() {
-        return this.hasAny()
-            ? {
-                tools: {
-                    // List change notifications are supported if we have any tools registered
-                    listChanged: true,
-                },
-            }
-            : {};
-    }
-}
-exports.default = ToolRegistry;
-/* -------------------- lineage utility -------------------- */
-/** Remove only adjacent duplicates like [adapter:x, adapter:x] → [adapter:x] */
-function dedupLineage(l) {
-    const out = [];
-    for (const o of l) {
-        const last = out[out.length - 1];
-        if (!last || last.kind !== o.kind || last.id !== o.id)
-            out.push(o);
-    }
-    return out;
-}
-//# sourceMappingURL=tool.registry.js.map

package/src/tool/tool.registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool.registry.js","sourceRoot":"","sources":["../../../src/tool/tool.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntryLineage, EntryOwnerRef, Token, ToolEntry, ToolRecord, ToolRegistryInterface, ToolType } from '../common';\nimport { getMetadata, tokenName } from '../utils';\nimport { ToolChangeEvent, ToolEmitter } from './tool.events';\nimport ProviderRegistry from '../provider/provider.registry';\nimport {\n  ensureMaxLen,\n  normalizeOwnerPath,\n  normalizeProviderId,\n  normalizeSegment,\n  normalizeTool,\n  ownerKeyOf,\n  qualifiedNameOf,\n  sepFor,\n  toolDiscoveryDeps,\n} from './tool.utils';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport { ToolInstance } from './tool.instance';\nimport { DEFAULT_EXPORT_OPTS, ExportNameOptions, IndexedTool } from './tool.types';\nimport ToolsListFlow from './flows/tools-list.flow';\nimport CallToolFlow from './flows/call-tool.flow';\nimport { ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';\n\nexport default class ToolRegistry\n  extends RegistryAbstract<\n    ToolInstance, // IMPORTANT: instances map holds ToolInstance (not the interface)\n    ToolRecord,\n    ToolType[]\n  >\n  implements ToolRegistryInterface\n{\n  /** Who owns this registry (used for provenance). Optional. */\n  owner: EntryOwnerRef;\n\n  /** Tools truly owned/constructed by THIS registry (with lineage applied) */\n  private localRows: IndexedTool[] = [];\n\n  /** Adopted tool rows from each child registry (references to the same instances) */\n  private adopted = new Map<ToolRegistry, IndexedTool[]>();\n\n  /** Children registries that we track */\n  private children = new Set<ToolRegistry>();\n\n  // ---- O(1) indexes over EFFECTIVE set (local + adopted) ----\n  private byQualifiedId = new Map<string, IndexedTool>(); // qualifiedId -> row\n  private byName = new Map<string, IndexedTool[]>(); // baseName -> rows\n  private byOwnerAndName = new Map<string, IndexedTool>(); // \"ownerKey:name\" -> row\n  private byProviderAndName = new Map<string, IndexedTool>(); // \"providerId:name\" -> row (best-effort)\n  private byOwner = new Map<string, IndexedTool[]>(); // ownerKey -> rows\n\n  // version + emitter\n  private version = 0;\n  private emitter = new ToolEmitter();\n\n  constructor(providers: ProviderRegistry, list: ToolType[], owner: EntryOwnerRef) {\n    // disable auto so subclass fields initialize first\n    super('ToolRegistry', providers, list, false);\n    this.owner = owner;\n\n    // now it’s safe to run the lifecycle\n    this.buildGraph();\n    this.ready = this.initialize();\n  }\n\n  /* -------------------- Build-time: defs + dep checks -------------------- */\n\n  protected override buildMap(list: ToolType[]): RegistryBuildMapResult<ToolRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, ToolRecord>();\n    const graph = new Map<Token, Set<Token>>();\n    for (const raw of list) {\n      const rec = normalizeTool(raw);\n      const provide = rec.provide;\n      tokens.add(provide);\n      defs.set(provide, rec);\n      graph.set(provide, new Set());\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 = toolDiscoveryDeps(rec);\n\n      for (const d of deps) {\n        // Validate against hierarchical providers; throws early if missing\n        this.providers.get(d);\n        this.graph.get(token)!.add(d);\n      }\n    }\n  }\n\n  /* -------------------- Initialize: create ONE FrontMcpToolInstance per local tool -------------------- */\n\n  protected override async initialize(): Promise<void> {\n    // Instantiate each local tool once and store in this.instances (from RegistryAbstract)\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n\n      // Single, authoritative instance per local tool\n      const ti = new ToolInstance(rec, this.providers, this.owner);\n      this.instances.set(token as Token<ToolInstance>, ti);\n\n      const lineage: EntryLineage = this.owner ? [this.owner] : [];\n      const row = this.makeRow(token, ti, lineage, this);\n      this.localRows.push(row);\n    }\n\n    const childAppRegistries = this.providers.getRegistries('AppRegistry');\n    childAppRegistries.forEach((appRegistry) => {\n      const apps = appRegistry.getApps();\n      for (const app of apps) {\n        const appToolsRegistries = app.providers.getRegistries('ToolRegistry');\n        appToolsRegistries\n          .filter((t) => t.owner.kind === 'app')\n          .forEach((appToolRegistry) => {\n            this.adoptFromChild(appToolRegistry as ToolRegistry, appToolRegistry.owner);\n          });\n      }\n    });\n\n    const childToolRegistries = this.providers.getRegistries('ToolRegistry');\n    childToolRegistries\n      .filter((t) => t != this)\n      .forEach((toolRegistry) => {\n        this.adoptFromChild(toolRegistry as ToolRegistry, toolRegistry.owner);\n      });\n\n    // Build effective indexes from (locals + already adopted children)\n    this.reindex();\n    this.bump('reset');\n\n    const scope = this.providers.getActiveScope();\n    await scope.registryFlows(ToolsListFlow, CallToolFlow);\n  }\n\n  /* -------------------- Adoption: reference child instances (no cloning) -------------------- */\n\n  /**\n   * Adopt tools from a child registry. Parent runs after children are ready.\n   * We *reference* the child's tool instances; no duplicates are created.\n   *\n   * IMPORTANT:\n   * - Child rows already include the child's own lineage (e.g., adapter:openapi).\n   * - Here we only prepend the **parent's** owner, to avoid double-prefixing the child.\n   */\n  adoptFromChild(child: ToolRegistry, _childOwner: EntryOwnerRef): void {\n    if (this.children.has(child)) return;\n\n    const childRows = child.listAllIndexed(); // includes child's lineage\n    const prepend: EntryLineage = this.owner ? [this.owner] : [];\n\n    const adoptedRows = childRows.map((r) => this.relineage(r, prepend));\n\n    this.adopted.set(child, adoptedRows);\n    this.children.add(child);\n\n    // keep live if child changes\n    child.subscribe({ immediate: false }, () => {\n      const latest = child.listAllIndexed().map((r) => this.relineage(r, prepend));\n      this.adopted.set(child, latest);\n      this.reindex();\n      this.bump('reset');\n    });\n\n    this.reindex();\n    this.bump('reset');\n  }\n\n  // NOTE: `any` is intentional here - heterogeneous tool collections can't use `unknown`\n  // because ToolEntry has constrained generics (InSchema extends ToolInputType, etc.)\n  getTools(includeHidden = false): ToolEntry<any, any>[] {\n    const local = [...this.localRows].flat().map((t) => t.instance);\n    const adopted = [...this.adopted.values()].flat().map((t) => t.instance);\n    return [...local, ...adopted].filter((t) => t.metadata.hideFromDiscovery !== true || includeHidden);\n  }\n\n  // NOTE: `any` is intentional - see getTools comment above\n  getInlineTools(): ToolEntry<any, any>[] {\n    return [...this.instances.values()];\n  }\n\n  /** Internal snapshot of effective indexed rows (locals + adopted). */\n  private listAllIndexed(): IndexedTool[] {\n    return [...this.localRows, ...[...this.adopted.values()].flat()];\n  }\n\n  /* -------------------- Indexing & lookups -------------------- */\n\n  private reindex() {\n    const effective = this.listAllIndexed();\n\n    this.byQualifiedId.clear();\n    this.byName.clear();\n    this.byOwnerAndName.clear();\n    this.byProviderAndName.clear();\n    this.byOwner.clear();\n\n    for (const r of effective) {\n      this.byQualifiedId.set(r.qualifiedId, r);\n\n      const listByName = this.byName.get(r.baseName) ?? [];\n      listByName.push(r);\n      this.byName.set(r.baseName, listByName);\n\n      const byOwnerKey = this.byOwner.get(r.ownerKey) ?? [];\n      byOwnerKey.push(r);\n      this.byOwner.set(r.ownerKey, byOwnerKey);\n\n      const on = `${r.ownerKey}:${r.baseName}`;\n      if (!this.byOwnerAndName.has(on)) this.byOwnerAndName.set(on, r);\n\n      const provId = this.providerIdOf(r.instance);\n      if (provId) {\n        const pn = `${provId}:${r.baseName}`;\n        if (!this.byProviderAndName.has(pn)) this.byProviderAndName.set(pn, r);\n      }\n    }\n  }\n\n  /** List all instances (locals + adopted). */\n  listAllInstances(): readonly ToolInstance[] {\n    return this.listAllIndexed().map((r) => r.instance);\n  }\n\n  /** List instances by owner path (e.g. \"app:Portal/plugin:Okta\") */\n  listByOwner(ownerPath: string): readonly ToolInstance[] {\n    return (this.byOwner.get(ownerPath) ?? []).map((r) => r.instance);\n  }\n\n  /* -------------------- Conflict-aware exported names -------------------- */\n\n  /**\n   * Produce unique, MCP-valid exported names.\n   * - Base (standardized) = metadata.name cased (snake/camel/kebab/dot)\n   * - If conflicting:\n   *    - Locals keep bare base (unless >1 locals conflict → they get owner prefixes)\n   *    - Children with same base get prefixed by providerId (or owner path)\n   */\n  exportResolvedNames(opts?: ExportNameOptions): Array<{ name: string; instance: ToolInstance }> {\n    const cfg = { ...DEFAULT_EXPORT_OPTS, ...(opts ?? {}) };\n\n    const rows = this.listAllIndexed().map((r) => {\n      const base = normalizeSegment(r.baseName, cfg.case);\n      const isLocal = r.source === this;\n      const provider = normalizeProviderId(this.providerIdOf(r.instance), cfg.case);\n      const ownerPath = normalizeOwnerPath(r.ownerKey, cfg.case);\n      return { base, row: r, isLocal, provider, ownerPath };\n    });\n\n    // group by standardized base\n    const byBase = new Map<string, typeof rows>();\n    for (const r of rows) {\n      const list = byBase.get(r.base) ?? [];\n      list.push(r);\n      byBase.set(r.base, list);\n    }\n\n    const out = new Map<string, ToolInstance>();\n\n    for (const [base, group] of byBase.entries()) {\n      if (group.length === 1) {\n        const g = group[0];\n        out.set(ensureMaxLen(base, cfg.maxLen), g.row.instance);\n        continue;\n      }\n\n      const locals = group.filter((g) => g.isLocal);\n      const children = group.filter((g) => !g.isLocal);\n\n      if (cfg.prefixChildrenOnConflict && locals.length > 0) {\n        // Locals\n        if (locals.length === 1) {\n          const localName = ensureMaxLen(base, cfg.maxLen);\n          out.set(disambiguate(localName, out, cfg), locals[0].row.instance);\n        } else {\n          for (const l of locals) {\n            const pref = normalizeOwnerPath(l.ownerPath, cfg.case);\n            const name = ensureMaxLen(`${pref}${sepFor(cfg.case)}${base}`, cfg.maxLen);\n            out.set(disambiguate(name, out, cfg), l.row.instance);\n          }\n        }\n\n        // Children\n        for (const c of children) {\n          const pre = cfg.prefixSource === 'provider' ? c.provider ?? c.ownerPath : c.ownerPath;\n          const name = ensureMaxLen(`${pre}${sepFor(cfg.case)}${base}`, cfg.maxLen);\n          out.set(disambiguate(name, out, cfg), c.row.instance);\n        }\n      } else {\n        // Prefix everyone by source\n        for (const r of group) {\n          const pre = cfg.prefixSource === 'provider' ? r.provider ?? r.ownerPath : r.ownerPath;\n          const name = ensureMaxLen(`${pre}${sepFor(cfg.case)}${base}`, cfg.maxLen);\n          out.set(disambiguate(name, out, cfg), r.row.instance);\n        }\n      }\n    }\n\n    return [...out.entries()].sort((a, b) => a[0].localeCompare(b[0])).map(([name, instance]) => ({ name, instance }));\n\n    function disambiguate(candidate: string, pool: Map<string, any>, cfg: Required<ExportNameOptions>): string {\n      if (!pool.has(candidate)) return candidate;\n      let n = 2;\n      while (true) {\n        const withN = ensureMaxLen(`${candidate}${sepFor(cfg.case)}${n}`, cfg.maxLen);\n        if (!pool.has(withN)) return withN;\n        n++;\n      }\n    }\n  }\n\n  /** Lookup by the exported (resolved) name. */\n  getExported(name: string, opts?: ExportNameOptions): ToolInstance | undefined {\n    const pairs = this.exportResolvedNames(opts);\n    return pairs.find((p) => p.name === name)?.instance;\n  }\n\n  /* -------------------- Subscriptions -------------------- */\n\n  subscribe(\n    opts: { immediate?: boolean; filter?: (i: ToolInstance) => boolean },\n    cb: (evt: ToolChangeEvent) => void,\n  ): () => void {\n    const filter = opts.filter ?? (() => true);\n    if (opts.immediate) {\n      cb({\n        kind: 'reset',\n        changeScope: 'global',\n        version: this.version,\n        snapshot: this.listAllInstances().filter(filter),\n      });\n    }\n    return this.emitter.on((e) => cb({ ...e, snapshot: this.listAllInstances().filter(filter) }));\n  }\n\n  private bump(kind: ToolChangeEvent['kind']) {\n    const version = ++this.version;\n    this.emitter.emit({ kind, changeScope: 'global', version, snapshot: this.listAllInstances() });\n  }\n\n  /* -------------------- Helpers -------------------- */\n\n  /** Build an IndexedTool row */\n  private makeRow(token: Token, instance: ToolInstance, lineage: EntryLineage, source: ToolRegistry): IndexedTool {\n    const ownerKey = ownerKeyOf(lineage);\n    const baseName = instance.name;\n    const qualifiedName = qualifiedNameOf(lineage, baseName);\n    const qualifiedId = `${ownerKey}:${tokenName(token)}`;\n    return { token, instance, baseName, lineage, ownerKey, qualifiedName, qualifiedId, source };\n  }\n\n  /** Clone a child row and prepend lineage (with adjacent de-dup to avoid double prefixes). */\n  private relineage(row: IndexedTool, prepend: EntryLineage): IndexedTool {\n    const merged = [...prepend, ...row.lineage];\n    const lineage = dedupLineage(merged);\n\n    const ownerKey = ownerKeyOf(lineage);\n    const qualifiedName = qualifiedNameOf(lineage, row.baseName);\n    const qualifiedId = `${ownerKey}:${tokenName(row.token)}`;\n    return {\n      token: row.token,\n      instance: row.instance, // REFERENCE the same instance\n      baseName: row.baseName,\n      lineage,\n      ownerKey,\n      qualifiedName,\n      qualifiedId,\n      source: row.source, // keep original source (who constructed instance)\n    };\n  }\n\n  /** Best-effort provider id used for prefixing (inspects class metadata if present). */\n  private providerIdOf(inst: ToolInstance): string | undefined {\n    // Try reading provider id from the tool class metadata (if your decorators set one)\n    try {\n      const meta: any = inst.getMetadata?.();\n      const maybe = meta?.providerId ?? meta?.provider ?? meta?.ownerId ?? undefined;\n      if (typeof maybe === 'string' && maybe.length) return maybe;\n\n      const cls: any = meta && meta.cls ? meta.cls : undefined;\n      if (cls) {\n        const id = getMetadata('id', cls);\n        if (typeof id === 'string' && id.length) return id;\n        if (cls.name) return cls.name;\n      }\n    } catch {\n      /* ignore */\n    }\n    return undefined;\n  }\n\n  /** True if this registry (or adopted children) has any tools. */\n  hasAny(): boolean {\n    return this.listAllIndexed().length > 0 || this.tokens.size > 0;\n  }\n\n  /**\n   * Get the MCP capabilities for tools.\n   * These are reported to clients during initialization.\n   */\n  getCapabilities(): Partial<ServerCapabilities> {\n    return this.hasAny()\n      ? {\n          tools: {\n            // List change notifications are supported if we have any tools registered\n            listChanged: true,\n          },\n        }\n      : {};\n  }\n}\n\n/* -------------------- lineage utility -------------------- */\n\n/** Remove only adjacent duplicates like [adapter:x, adapter:x] → [adapter:x] */\nfunction dedupLineage(l: EntryLineage): EntryLineage {\n  const out: EntryLineage = [];\n  for (const o of l) {\n    const last = out[out.length - 1];\n    if (!last || last.kind !== o.kind || last.id !== o.id) out.push(o);\n  }\n  return out;\n}\n"]}

package/src/tool/tool.types.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_EXPORT_OPTS = void 0;
-exports.DEFAULT_EXPORT_OPTS = {
-    case: 'snake',
-    maxLen: 64,
-    prefixChildrenOnConflict: true,
-    prefixSource: 'provider',
-};
-//# sourceMappingURL=tool.types.js.map

package/src/tool/tool.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool.types.js","sourceRoot":"","sources":["../../../src/tool/tool.types.ts"],"names":[],"mappings":";;;AA0Ba,QAAA,mBAAmB,GAAgC;IAC9D,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,EAAE;IACV,wBAAwB,EAAE,IAAI;IAC9B,YAAY,EAAE,UAAU;CACzB,CAAC","sourcesContent":["import { EntryLineage, Token } from '../common';\nimport { ToolInstance } from './tool.instance';\nimport ToolRegistry from './tool.registry';\nimport type { NameCase } from '../utils/naming.utils';\n\n/** Internal augmented row: instance + provenance + token */\nexport type IndexedTool = {\n  token: Token;\n  instance: ToolInstance;\n  /** base tool name from metadata (unmodified) */\n  baseName: string;\n  /** lineage & qualified info */\n  lineage: EntryLineage;\n  ownerKey: string; // \"app:Portal/plugin:Okta\"\n  qualifiedName: string; // \"app:Portal/plugin:Okta:toolName\"\n  qualifiedId: string; // \"app:Portal/plugin:Okta:tokenName(<token>)\"\n  /** which registry constructed the instance (the \"owner\" registry) */\n  source: ToolRegistry;\n};\nexport type ExportNameOptions = {\n  case?: NameCase; // default 'snake'\n  maxLen?: number; // default 64\n  prefixChildrenOnConflict?: boolean; // default true\n  prefixSource?: 'provider' | 'owner'; // default 'provider'\n};\n\nexport const DEFAULT_EXPORT_OPTS: Required<ExportNameOptions> = {\n  case: 'snake',\n  maxLen: 64,\n  prefixChildrenOnConflict: true,\n  prefixSource: 'provider',\n};\n"]}