@frontmcp/sdk 0.2.5 → 0.3.0

package/src/tool/tool.registry.js

@@ -0,0 +1,339 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const metadata_utils_1 = require("../utils/metadata.utils");
+const tool_events_1 = require("./tool.events");
+const tool_utils_1 = require("./tool.utils");
+const token_utils_1 = require("../utils/token.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');
+    }
+    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);
+    }
+    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',
+                scope: '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, scope: '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, token_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, token_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, metadata_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;
+    }
+}
+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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.registry.js","sourceRoot":"","sources":["../../../src/tool/tool.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  EntryLineage,\n  EntryOwnerRef,\n  Token,\n  ToolEntry,\n  ToolRecord,\n  ToolRegistryInterface,\n  ToolType\n} from '../common';\nimport {getMetadata} from '../utils/metadata.utils';\nimport {ToolChangeEvent, ToolEmitter} from './tool.events';\nimport ProviderRegistry from '../provider/provider.registry';\nimport {\n  ensureMaxLen,\n  normalizeOwnerPath,\n  normalizeProviderId,\n  normalizeSegment,\n  normalizeTool, ownerKeyOf, qualifiedNameOf, sepFor,\n  toolDiscoveryDeps\n} from './tool.utils';\nimport {tokenName} from '../utils/token.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\";\n\n\nexport default class ToolRegistry extends RegistryAbstract<\n  ToolInstance,        // IMPORTANT: instances map holds ToolInstance (not the interface)\n  ToolRecord,\n  ToolType[]\n> implements ToolRegistryInterface {\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.filter(t => t.owner.kind === 'app').forEach(appToolRegistry => {\n          this.adoptFromChild(appToolRegistry as ToolRegistry, appToolRegistry.owner);\n        });\n      }\n    });\n\n    const childToolRegistries = this.providers.getRegistries('ToolRegistry');\n    childToolRegistries.filter(t => t != this).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\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  getTools(includeHidden: boolean = 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  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'\n            ? (c.provider ?? c.ownerPath)\n            : 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'\n            ? (r.provider ?? r.ownerPath)\n            : 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()]\n      .sort((a, b) => a[0].localeCompare(b[0]))\n      .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        scope: '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, scope: '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/* -------------------- 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.d.ts

@@ -0,0 +1,25 @@
+import { EntryLineage, Token } from '../common';
+import { ToolInstance } from "./tool.instance";
+import ToolRegistry from "./tool.registry";
+/** Internal augmented row: instance + provenance + token */
+export type IndexedTool = {
+    token: Token;
+    instance: ToolInstance;
+    /** base tool name from metadata (unmodified) */
+    baseName: string;
+    /** lineage & qualified info */
+    lineage: EntryLineage;
+    ownerKey: string;
+    qualifiedName: string;
+    qualifiedId: string;
+    /** which registry constructed the instance (the “owner” registry) */
+    source: ToolRegistry;
+};
+export type NameCase = 'snake' | 'camel' | 'kebab' | 'dot';
+export type ExportNameOptions = {
+    case?: NameCase;
+    maxLen?: number;
+    prefixChildrenOnConflict?: boolean;
+    prefixSource?: 'provider' | 'owner';
+};
+export declare const DEFAULT_EXPORT_OPTS: Required<ExportNameOptions>;

package/src/tool/tool.types.js

@@ -0,0 +1,10 @@
+"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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.types.js","sourceRoot":"","sources":["../../../src/tool/tool.types.ts"],"names":[],"mappings":";;;AA4Ba,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\";\n\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};\n\nexport type NameCase = 'snake' | 'camel' | 'kebab' | 'dot';\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};"]}

package/src/tool/tool.utils.d.ts

@@ -0,0 +1,20 @@
+import { ToolMetadata, ToolType, Token, ToolRecord, EntryLineage } from '../common';
+import { NameCase } from "./tool.types";
+export declare function collectToolMetadata(cls: ToolType): ToolMetadata;
+export declare function normalizeTool(item: any): ToolRecord;
+/**
+ * For graph/cycle detection. Returns dependency tokens that should be graphed.
+ * - FUNCTION: get function params without the first argument (the tool input)
+ * - CLASS_TOKEN: deps come from the class constructor
+ */
+export declare function toolDiscoveryDeps(rec: ToolRecord): Token[];
+export declare function splitWords(input: string): string[];
+export declare function toCase(words: string[], kind: NameCase): string;
+export declare function normalizeSegment(raw: string, kind: NameCase): string;
+export declare function normalizeProviderId(raw: string | undefined, kind: NameCase): string | undefined;
+export declare function normalizeOwnerPath(ownerKey: string, kind: NameCase): string;
+export declare function shortHash(s: string): string;
+export declare function ensureMaxLen(name: string, max: number): string;
+export declare function sepFor(kind: NameCase): string;
+export declare function ownerKeyOf(lineage: EntryLineage): string;
+export declare function qualifiedNameOf(lineage: EntryLineage, name: string): string;

package/src/tool/tool.utils.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectToolMetadata = collectToolMetadata;
+exports.normalizeTool = normalizeTool;
+exports.toolDiscoveryDeps = toolDiscoveryDeps;
+exports.splitWords = splitWords;
+exports.toCase = toCase;
+exports.normalizeSegment = normalizeSegment;
+exports.normalizeProviderId = normalizeProviderId;
+exports.normalizeOwnerPath = normalizeOwnerPath;
+exports.shortHash = shortHash;
+exports.ensureMaxLen = ensureMaxLen;
+exports.sepFor = sepFor;
+exports.ownerKeyOf = ownerKeyOf;
+exports.qualifiedNameOf = qualifiedNameOf;
+const common_1 = require("../common");
+const token_utils_1 = require("../utils/token.utils");
+const metadata_utils_1 = require("../utils/metadata.utils");
+function collectToolMetadata(cls) {
+    const extended = (0, metadata_utils_1.getMetadata)(common_1.extendedToolMetadata, cls);
+    const seed = (extended ? { ...extended } : {});
+    return Object.entries(common_1.FrontMcpToolTokens).reduce((metadata, [key, token]) => {
+        const value = (0, metadata_utils_1.getMetadata)(token, cls);
+        if (value) {
+            return Object.assign(metadata, {
+                [key]: value
+            });
+        }
+        else {
+            return metadata;
+        }
+    }, seed);
+}
+function normalizeTool(item) {
+    if (item && typeof item === 'function' && item[common_1.FrontMcpToolTokens.type] === 'function-tool' && item[common_1.FrontMcpToolTokens.metadata]) {
+        return {
+            kind: common_1.ToolKind.FUNCTION,
+            provide: item(),
+            metadata: item[common_1.FrontMcpToolTokens.metadata],
+        };
+    }
+    if ((0, token_utils_1.isClass)(item)) {
+        // read McpToolMetadata from class
+        const metadata = collectToolMetadata(item);
+        return { kind: common_1.ToolKind.CLASS_TOKEN, provide: item, metadata };
+    }
+    const name = item?.name ?? String(item);
+    throw new Error(`Invalid adapter '${name}'. Expected a class or a adapter object.`);
+}
+/**
+ * For graph/cycle detection. Returns dependency tokens that should be graphed.
+ * - FUNCTION: get function params without the first argument (the tool input)
+ * - CLASS_TOKEN: deps come from the class constructor
+ */
+function toolDiscoveryDeps(rec) {
+    switch (rec.kind) {
+        case common_1.ToolKind.FUNCTION: {
+            return (0, token_utils_1.depsOfFunc)(rec.provide, 'discovery');
+        }
+        case common_1.ToolKind.CLASS_TOKEN:
+            return (0, token_utils_1.depsOfClass)(rec.provide, 'discovery');
+    }
+}
+// Allowed chars per MCP spec: a-zA-Z0-9 _ -. /
+const MCP_ALLOWED = /[A-Za-z0-9_\-./]/;
+function splitWords(input) {
+    const parts = [];
+    let buff = '';
+    for (let i = 0; i < input.length; i++) {
+        const ch = input[i];
+        const isAlphaNum = /[A-Za-z0-9]/.test(ch);
+        if (!isAlphaNum) {
+            if (buff) {
+                parts.push(buff);
+                buff = '';
+            }
+            continue;
+        }
+        if (buff && /[a-z]/.test(buff[buff.length - 1]) && /[A-Z]/.test(ch)) {
+            parts.push(buff);
+            buff = ch;
+        }
+        else {
+            buff += ch;
+        }
+    }
+    if (buff)
+        parts.push(buff);
+    return parts;
+}
+function toCase(words, kind) {
+    const safe = words.filter(Boolean);
+    switch (kind) {
+        case 'snake':
+            return safe.map(w => w.toLowerCase()).join('_');
+        case 'kebab':
+            return safe.map(w => w.toLowerCase()).join('-');
+        case 'dot':
+            return safe.map(w => w.toLowerCase()).join('.');
+        case 'camel':
+            if (safe.length === 0)
+                return '';
+            return safe[0].toLowerCase() + safe.slice(1)
+                .map(w => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join('');
+    }
+}
+function normalizeSegment(raw, kind) {
+    const words = splitWords(raw);
+    let cased = toCase(words, kind);
+    cased = [...cased].filter(ch => MCP_ALLOWED.test(ch)).join('');
+    return cased || 'x';
+}
+function normalizeProviderId(raw, kind) {
+    if (!raw)
+        return undefined;
+    const tokens = raw.split(/\W+/);
+    const cased = toCase(tokens, kind);
+    const safe = [...cased].filter(ch => MCP_ALLOWED.test(ch)).join('');
+    return safe || undefined;
+}
+function normalizeOwnerPath(ownerKey, kind) {
+    const levels = ownerKey.split('/');
+    const normLevels = levels.map(level => {
+        const parts = level.split(':'); // ["app","Portal"]
+        return parts.map(p => normalizeSegment(p, kind)).join(kind === 'snake' ? '_' : kind === 'kebab' ? '-' : kind === 'dot' ? '.' : '');
+    });
+    if (kind === 'camel')
+        return normLevels.map(seg => seg.charAt(0).toLowerCase() + seg.slice(1)).join('');
+    const sep = kind === 'snake' ? '_' : kind === 'kebab' ? '-' : '.';
+    return normLevels.join(sep);
+}
+function shortHash(s) {
+    let h = 5381;
+    for (let i = 0; i < s.length; i++)
+        h = ((h << 5) + h) + s.charCodeAt(i);
+    return (h >>> 0).toString(16).slice(-6).padStart(6, '0');
+}
+function ensureMaxLen(name, max) {
+    if (name.length <= max)
+        return name;
+    const hash = shortHash(name);
+    const lastSep = Math.max(name.lastIndexOf('_'), name.lastIndexOf('-'), name.lastIndexOf('.'), name.lastIndexOf('/'));
+    const tail = lastSep > 0 ? name.slice(lastSep + 1) : name.slice(-Math.max(3, Math.min(16, Math.floor(max / 4))));
+    const budget = Math.max(1, max - (1 + hash.length + 1 + tail.length));
+    const prefix = name.slice(0, budget);
+    return `${prefix}-${hash}-${tail}`.slice(0, max);
+}
+function sepFor(kind) {
+    return kind === 'snake' ? '_' : kind === 'kebab' ? '-' : kind === 'dot' ? '.' : '';
+}
+function ownerKeyOf(lineage) {
+    return lineage.map(o => `${o.kind}:${o.id}`).join('/');
+}
+function qualifiedNameOf(lineage, name) {
+    return `${ownerKeyOf(lineage)}:${name}`;
+}
+//# sourceMappingURL=tool.utils.js.map

package/src/tool/tool.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.utils.js","sourceRoot":"","sources":["../../../src/tool/tool.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  ToolMetadata,\n  FrontMcpToolTokens,\n  ToolType,\n  Token,\n  ToolRecord,\n  ToolKind,\n  EntryLineage,\n  Type, ToolContext, extendedToolMetadata\n} from '../common';\nimport {depsOfClass, depsOfFunc, isClass} from '../utils/token.utils';\nimport {getMetadata} from '../utils/metadata.utils';\nimport {NameCase} from \"./tool.types\";\n\nexport function collectToolMetadata(cls: ToolType): ToolMetadata {\n\n  const extended = getMetadata(extendedToolMetadata, cls);\n  const seed = (extended ? {...extended} : {}) as ToolMetadata;\n  return Object.entries(FrontMcpToolTokens).reduce((metadata, [key, token]) => {\n    const value = getMetadata(token, cls);\n    if (value) {\n      return Object.assign(metadata, {\n        [key]: value\n      });\n    } else {\n      return metadata;\n    }\n  }, seed);\n}\n\nexport function normalizeTool(item: any): ToolRecord {\n  if (item && typeof item === 'function' && item[FrontMcpToolTokens.type] === 'function-tool' && item[FrontMcpToolTokens.metadata]) {\n    return {\n      kind: ToolKind.FUNCTION,\n      provide: item(),\n      metadata: item[FrontMcpToolTokens.metadata] as ToolMetadata,\n    };\n  }\n\n  if (isClass(item)) {\n    // read McpToolMetadata from class\n    const metadata = collectToolMetadata(item);\n    return {kind: ToolKind.CLASS_TOKEN, provide: item as Type<ToolContext>, metadata};\n  }\n  const name = (item as any)?.name ?? String(item);\n  throw new Error(\n    `Invalid adapter '${name}'. Expected a class or a adapter object.`,\n  );\n}\n\n/**\n * For graph/cycle detection. Returns dependency tokens that should be graphed.\n * - FUNCTION: get function params without the first argument (the tool input)\n * - CLASS_TOKEN: deps come from the class constructor\n */\nexport function toolDiscoveryDeps(rec: ToolRecord): Token[] {\n  switch (rec.kind) {\n    case ToolKind.FUNCTION: {\n      return depsOfFunc(rec.provide, 'discovery');\n    }\n    case ToolKind.CLASS_TOKEN:\n      return depsOfClass(rec.provide, 'discovery');\n  }\n}\n\n\n// Allowed chars per MCP spec: a-zA-Z0-9 _ -. /\nconst MCP_ALLOWED = /[A-Za-z0-9_\\-./]/;\n\nexport function splitWords(input: string): string[] {\n  const parts: string[] = [];\n  let buff = '';\n  for (let i = 0; i < input.length; i++) {\n    const ch = input[i];\n    const isAlphaNum = /[A-Za-z0-9]/.test(ch);\n    if (!isAlphaNum) {\n      if (buff) {\n        parts.push(buff);\n        buff = '';\n      }\n      continue;\n    }\n    if (buff && /[a-z]/.test(buff[buff.length - 1]) && /[A-Z]/.test(ch)) {\n      parts.push(buff);\n      buff = ch;\n    } else {\n      buff += ch;\n    }\n  }\n  if (buff) parts.push(buff);\n  return parts;\n}\n\nexport function toCase(words: string[], kind: NameCase): string {\n  const safe = words.filter(Boolean);\n  switch (kind) {\n    case 'snake':\n      return safe.map(w => w.toLowerCase()).join('_');\n    case 'kebab':\n      return safe.map(w => w.toLowerCase()).join('-');\n    case 'dot':\n      return safe.map(w => w.toLowerCase()).join('.');\n    case 'camel':\n      if (safe.length === 0) return '';\n      return safe[0].toLowerCase() + safe.slice(1)\n        .map(w => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join('');\n  }\n}\n\nexport function normalizeSegment(raw: string, kind: NameCase): string {\n  const words = splitWords(raw);\n  let cased = toCase(words, kind);\n  cased = [...cased].filter(ch => MCP_ALLOWED.test(ch)).join('');\n  return cased || 'x';\n}\n\nexport function normalizeProviderId(raw: string | undefined, kind: NameCase): string | undefined {\n  if (!raw) return undefined;\n  const tokens = raw.split(/\\W+/);\n  const cased = toCase(tokens, kind);\n  const safe = [...cased].filter(ch => MCP_ALLOWED.test(ch)).join('');\n  return safe || undefined;\n}\n\nexport function normalizeOwnerPath(ownerKey: string, kind: NameCase): string {\n  const levels = ownerKey.split('/');\n  const normLevels = levels.map(level => {\n    const parts = level.split(':'); // [\"app\",\"Portal\"]\n    return parts.map(p => normalizeSegment(p, kind)).join(\n      kind === 'snake' ? '_' : kind === 'kebab' ? '-' : kind === 'dot' ? '.' : '',\n    );\n  });\n  if (kind === 'camel') return normLevels.map(seg => seg.charAt(0).toLowerCase() + seg.slice(1)).join('');\n  const sep = kind === 'snake' ? '_' : kind === 'kebab' ? '-' : '.';\n  return normLevels.join(sep);\n}\n\nexport function shortHash(s: string): string {\n  let h = 5381;\n  for (let i = 0; i < s.length; i++) h = ((h << 5) + h) + s.charCodeAt(i);\n  return (h >>> 0).toString(16).slice(-6).padStart(6, '0');\n}\n\nexport function ensureMaxLen(name: string, max: number): string {\n  if (name.length <= max) return name;\n  const hash = shortHash(name);\n  const lastSep = Math.max(name.lastIndexOf('_'), name.lastIndexOf('-'), name.lastIndexOf('.'), name.lastIndexOf('/'));\n  const tail = lastSep > 0 ? name.slice(lastSep + 1) : name.slice(-Math.max(3, Math.min(16, Math.floor(max / 4))));\n  const budget = Math.max(1, max - (1 + hash.length + 1 + tail.length));\n  const prefix = name.slice(0, budget);\n  return `${prefix}-${hash}-${tail}`.slice(0, max);\n}\n\nexport function sepFor(kind: NameCase): string {\n  return kind === 'snake' ? '_' : kind === 'kebab' ? '-' : kind === 'dot' ? '.' : '';\n}\n\nexport function ownerKeyOf(lineage: EntryLineage): string {\n  return lineage.map(o => `${o.kind}:${o.id}`).join('/');\n}\n\nexport function qualifiedNameOf(lineage: EntryLineage, name: string): string {\n  return `${ownerKeyOf(lineage)}:${name}`;\n}\n"]}