@frontmcp/sdk 0.4.1 → 0.5.1

package/src/prompt/prompt.instance.js

@@ -0,0 +1,120 @@
+"use strict";
+// file: libs/sdk/src/prompt/prompt.instance.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptInstance = void 0;
+const common_1 = require("../common");
+const hooks_utils_1 = require("../hooks/hooks.utils");
+const prompt_utils_1 = require("./prompt.utils");
+class PromptInstance extends common_1.PromptEntry {
+    providers;
+    scope;
+    hooks;
+    constructor(record, providers, owner) {
+        super(record);
+        this.owner = owner;
+        this.providers = providers;
+        this.name = record.metadata.name;
+        this.fullName = this.owner.id + ':' + this.name;
+        this.scope = this.providers.getActiveScope();
+        this.hooks = this.scope.providers.getHooksRegistry();
+        this.ready = this.initialize();
+    }
+    async initialize() {
+        // Register hooks for prompts:get-prompt, prompts:list-prompts flows
+        const hooks = (0, hooks_utils_1.normalizeHooksFromCls)(this.record.provide).filter((hook) => hook.metadata.flow === 'prompts:get-prompt' || hook.metadata.flow === 'prompts:list-prompts');
+        if (hooks.length > 0) {
+            await this.hooks.registerHooks(true, ...hooks);
+        }
+    }
+    getMetadata() {
+        return this.record.metadata;
+    }
+    /**
+     * Create a prompt context (class or function wrapper).
+     */
+    create(args, ctx) {
+        const metadata = this.metadata;
+        const providers = this.providers;
+        const scope = this.providers.getActiveScope();
+        const logger = scope.logger;
+        const authInfo = ctx.authInfo;
+        const promptCtorArgs = {
+            metadata,
+            args,
+            providers,
+            logger,
+            authInfo,
+        };
+        const record = this.record;
+        switch (record.kind) {
+            case common_1.PromptKind.CLASS_TOKEN:
+                return new record.provide(promptCtorArgs);
+            case common_1.PromptKind.FUNCTION:
+                return new FunctionPromptContext(record, promptCtorArgs);
+            default:
+                // Exhaustive check: TypeScript will error if a new PromptKind is added but not handled
+                // The assertion below catches runtime cases that TypeScript can't detect
+                throw new Error(`Unhandled prompt kind: ${record.kind}`);
+        }
+    }
+    /**
+     * Parse and validate arguments against the prompt's argument definitions.
+     * @param args Arguments from the MCP request
+     * @returns Validated arguments
+     */
+    parseArguments(args) {
+        const argDefs = this.metadata.arguments ?? [];
+        const result = {};
+        // Check required arguments
+        for (const argDef of argDefs) {
+            const value = args?.[argDef.name];
+            if (argDef.required && (value === undefined || value === null)) {
+                throw new Error(`Missing required argument: ${argDef.name}`);
+            }
+            if (value !== undefined) {
+                result[argDef.name] = value;
+            }
+        }
+        // Include any additional arguments not in the definition
+        if (args) {
+            for (const [key, value] of Object.entries(args)) {
+                if (!(key in result)) {
+                    result[key] = value;
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Convert the raw prompt return value into an MCP GetPromptResult.
+     */
+    parseOutput(raw) {
+        return (0, prompt_utils_1.buildParsedPromptResult)(raw, this.metadata);
+    }
+    /**
+     * Safe version of parseOutput that returns success/error instead of throwing.
+     */
+    safeParseOutput(raw) {
+        try {
+            return { success: true, data: this.parseOutput(raw) };
+        }
+        catch (error) {
+            return { success: false, error: error instanceof Error ? error : new Error(String(error)) };
+        }
+    }
+}
+exports.PromptInstance = PromptInstance;
+/**
+ * Prompt context for function-decorated prompts.
+ */
+class FunctionPromptContext extends common_1.PromptContext {
+    record;
+    constructor(record, args) {
+        super(args);
+        this.record = record;
+    }
+    execute(args) {
+        return this.record.provide(args, this);
+    }
+}
+//# sourceMappingURL=prompt.instance.js.map

package/src/prompt/prompt.instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.instance.js","sourceRoot":"","sources":["../../../src/prompt/prompt.instance.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/prompt/prompt.instance.ts\n\nimport {\n  EntryOwnerRef,\n  PromptEntry,\n  PromptGetExtra,\n  ParsedPromptResult,\n  PromptSafeTransformResult,\n  PromptRecord,\n  PromptKind,\n  PromptContext,\n  PromptCtorArgs,\n  PromptMetadata,\n  PromptFunctionTokenRecord,\n} from '../common';\nimport ProviderRegistry from '../provider/provider.registry';\nimport HookRegistry from '../hooks/hook.registry';\nimport { Scope } from '../scope';\nimport { normalizeHooksFromCls } from '../hooks/hooks.utils';\nimport { buildParsedPromptResult } from './prompt.utils';\nimport { GetPromptResult } from '@modelcontextprotocol/sdk/types.js';\n\nexport class PromptInstance extends PromptEntry {\n  private readonly providers: ProviderRegistry;\n  readonly scope: Scope;\n  readonly hooks: HookRegistry;\n\n  constructor(record: PromptRecord, providers: ProviderRegistry, owner: EntryOwnerRef) {\n    super(record);\n    this.owner = owner;\n    this.providers = providers;\n    this.name = 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    this.ready = this.initialize();\n  }\n\n  protected async initialize(): Promise<void> {\n    // Register hooks for prompts:get-prompt, prompts:list-prompts flows\n    const hooks = normalizeHooksFromCls(this.record.provide).filter(\n      (hook) => hook.metadata.flow === 'prompts:get-prompt' || hook.metadata.flow === 'prompts:list-prompts',\n    );\n    if (hooks.length > 0) {\n      await this.hooks.registerHooks(true, ...hooks);\n    }\n  }\n\n  getMetadata(): PromptMetadata {\n    return this.record.metadata;\n  }\n\n  /**\n   * Create a prompt context (class or function wrapper).\n   */\n  override create(args: Record<string, string>, ctx: PromptGetExtra): PromptContext {\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 promptCtorArgs: PromptCtorArgs = {\n      metadata,\n      args,\n      providers,\n      logger,\n      authInfo,\n    };\n\n    const record = this.record;\n\n    switch (record.kind) {\n      case PromptKind.CLASS_TOKEN:\n        return new (record.provide as unknown as new (args: PromptCtorArgs) => PromptContext)(promptCtorArgs);\n      case PromptKind.FUNCTION:\n        return new FunctionPromptContext(record as PromptFunctionTokenRecord, promptCtorArgs);\n      default:\n        // Exhaustive check: TypeScript will error if a new PromptKind is added but not handled\n        // The assertion below catches runtime cases that TypeScript can't detect\n        throw new Error(`Unhandled prompt kind: ${(record as { kind: string }).kind}`);\n    }\n  }\n\n  /**\n   * Parse and validate arguments against the prompt's argument definitions.\n   * @param args Arguments from the MCP request\n   * @returns Validated arguments\n   */\n  override parseArguments(args?: Record<string, string>): Record<string, string> {\n    const argDefs = this.metadata.arguments ?? [];\n    const result: Record<string, string> = {};\n\n    // Check required arguments\n    for (const argDef of argDefs) {\n      const value = args?.[argDef.name];\n      if (argDef.required && (value === undefined || value === null)) {\n        throw new Error(`Missing required argument: ${argDef.name}`);\n      }\n      if (value !== undefined) {\n        result[argDef.name] = value;\n      }\n    }\n\n    // Include any additional arguments not in the definition\n    if (args) {\n      for (const [key, value] of Object.entries(args)) {\n        if (!(key in result)) {\n          result[key] = value;\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Convert the raw prompt return value into an MCP GetPromptResult.\n   */\n  override parseOutput(raw: unknown): ParsedPromptResult {\n    return buildParsedPromptResult(raw, this.metadata);\n  }\n\n  /**\n   * Safe version of parseOutput that returns success/error instead of throwing.\n   */\n  override safeParseOutput(raw: unknown): PromptSafeTransformResult<ParsedPromptResult> {\n    try {\n      return { success: true, data: this.parseOutput(raw) };\n    } catch (error: unknown) {\n      return { success: false, error: error instanceof Error ? error : new Error(String(error)) };\n    }\n  }\n}\n\n/**\n * Prompt context for function-decorated prompts.\n */\nclass FunctionPromptContext extends PromptContext {\n  constructor(private readonly record: PromptFunctionTokenRecord, args: PromptCtorArgs) {\n    super(args);\n  }\n\n  execute(args: Record<string, string>): Promise<GetPromptResult> {\n    return this.record.provide(args, this) as Promise<GetPromptResult>;\n  }\n}\n"]}

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

@@ -1,16 +1,83 @@
+import { EntryOwnerRef, PromptEntry, PromptRecord, PromptRegistryInterface, PromptType } from '../common';
+import { PromptChangeEvent } from './prompt.events';
 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;
+import { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';
+import { PromptInstance } from './prompt.instance';
+import { PromptExportOptions, IndexedPrompt } from './prompt.types';
+import { ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';
+export default class PromptRegistry extends RegistryAbstract<PromptInstance, // instances map holds PromptInstance
+PromptRecord, PromptType[]> implements PromptRegistryInterface {
+    /** Who owns this registry (used for provenance). */
+    owner: EntryOwnerRef;
+    /** Prompts truly owned/constructed by THIS registry (with lineage applied) */
+    private localRows;
+    /** Adopted prompt rows from each child registry (references to the same instances) */
+    private adopted;
+    /** Children registries that we track */
+    private children;
+    private byQualifiedId;
+    private byName;
+    private byOwnerAndName;
+    private byOwner;
+    private version;
+    private emitter;
+    constructor(providers: ProviderRegistry, list: PromptType[], owner: EntryOwnerRef);
+    protected buildMap(list: PromptType[]): RegistryBuildMapResult<PromptRecord>;
+    protected buildGraph(): void;
     protected initialize(): Promise<void>;
-    hasAny(): boolean;
-    getPrompts(): never[];
+    /**
+     * Adopt prompts from a child registry. Parent runs after children are ready.
+     * We *reference* the child's prompt instances; no duplicates are created.
+     */
+    adoptFromChild(child: PromptRegistry, _childOwner: EntryOwnerRef): void;
+    /**
+     * Get all prompts
+     */
+    getPrompts(includeHidden?: boolean): PromptEntry[];
+    /**
+     * Get inline prompts (local only)
+     */
     getInlinePrompts(): PromptEntry[];
+    /**
+     * Find a prompt by exact name match
+     */
+    findByName(name: string): PromptInstance | undefined;
+    /**
+     * Find all prompts matching a name
+     */
+    findAllByName(name: string): PromptInstance[];
+    /** Internal snapshot of effective indexed rows (locals + adopted). */
+    listAllIndexed(): IndexedPrompt[];
+    /** List all instances (locals + adopted). */
+    listAllInstances(): readonly PromptInstance[];
+    /** List instances by owner path (e.g. "app:Portal/plugin:Okta") */
+    listByOwner(ownerPath: string): readonly PromptInstance[];
+    private reindex;
+    /**
+     * Produce unique, MCP-valid exported names.
+     */
+    exportResolvedNames(opts?: PromptExportOptions): Array<{
+        name: string;
+        instance: PromptInstance;
+    }>;
+    /** Lookup by the exported (resolved) name. */
+    getExported(name: string, opts?: PromptExportOptions): PromptInstance | undefined;
+    subscribe(opts: {
+        immediate?: boolean;
+        filter?: (i: PromptInstance) => boolean;
+    }, cb: (evt: PromptChangeEvent) => void): () => void;
+    private bump;
+    /** Build an IndexedPrompt row */
+    private makeRow;
+    /** Clone a child row and prepend lineage (with adjacent de-dup to avoid double prefixes). */
+    private relineage;
+    /** Best-effort provider id used for prefixing. */
+    private providerIdOf;
+    /** True if this registry (or adopted children) has any prompts. */
+    hasAny(): boolean;
+    /**
+     * Get the MCP capabilities for prompts.
+     * These are reported to clients during initialization.
+     */
+    getCapabilities(): Partial<ServerCapabilities>;
 }

package/src/prompt/prompt.registry.js

@@ -1,35 +1,380 @@
 "use strict";
+// file: libs/sdk/src/prompt/prompt.registry.ts
 Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const metadata_utils_1 = require("../utils/metadata.utils");
+const prompt_events_1 = require("./prompt.events");
+const prompt_utils_1 = require("./prompt.utils");
+const token_utils_1 = require("../utils/token.utils");
 const regsitry_1 = require("../regsitry");
+const prompt_instance_1 = require("./prompt.instance");
+const prompt_types_1 = require("./prompt.types");
+const get_prompt_flow_1 = tslib_1.__importDefault(require("./flows/get-prompt.flow"));
+const prompts_list_flow_1 = tslib_1.__importDefault(require("./flows/prompts-list.flow"));
+/** Maximum attempts for name disambiguation to prevent infinite loops */
+const MAX_DISAMBIGUATE_ATTEMPTS = 10000;
 class PromptRegistry extends regsitry_1.RegistryAbstract {
-    constructor(providers, list) {
-        super('PromptRegistry', providers, list);
+    /** Who owns this registry (used for provenance). */
+    owner;
+    /** Prompts truly owned/constructed by THIS registry (with lineage applied) */
+    localRows = [];
+    /** Adopted prompt 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
+    byOwner = new Map(); // ownerKey -> rows
+    // version + emitter
+    version = 0;
+    emitter = new prompt_events_1.PromptEmitter();
+    constructor(providers, list, owner) {
+        // disable auto so subclass fields initialize first
+        super('PromptRegistry', 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();
-        return {
-            tokens,
-            defs,
-            graph,
-        };
+        for (const raw of list) {
+            const rec = (0, prompt_utils_1.normalizePrompt)(raw);
+            const provide = rec.provide;
+            tokens.add(provide);
+            defs.set(provide, rec);
+            graph.set(provide, new Set());
+        }
+        return { tokens, defs, graph };
     }
     buildGraph() {
-        // TODO: implement graph building
+        for (const token of this.tokens) {
+            const rec = this.defs.get(token);
+            const deps = (0, prompt_utils_1.promptDiscoveryDeps)(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() {
-        return Promise.resolve();
+    /* -------------------- Initialize: create ONE PromptInstance per local prompt -------------------- */
+    async initialize() {
+        // Instantiate each local prompt once and store in this.instances
+        for (const token of this.tokens) {
+            const rec = this.defs.get(token);
+            // Single, authoritative instance per local prompt
+            const pi = new prompt_instance_1.PromptInstance(rec, this.providers, this.owner);
+            this.instances.set(token, pi);
+            const lineage = this.owner ? [this.owner] : [];
+            const row = this.makeRow(token, pi, lineage, this);
+            this.localRows.push(row);
+        }
+        // Adopt prompts from child app registries
+        const childAppRegistries = this.providers.getRegistries('AppRegistry');
+        childAppRegistries.forEach((appRegistry) => {
+            const apps = appRegistry.getApps();
+            for (const app of apps) {
+                const appPromptRegistries = app.providers.getRegistries('PromptRegistry');
+                appPromptRegistries
+                    .filter((r) => r.owner.kind === 'app')
+                    .forEach((appPromptRegistry) => {
+                    this.adoptFromChild(appPromptRegistry, appPromptRegistry.owner);
+                });
+            }
+        });
+        // Adopt prompts from other child prompt registries
+        const childPromptRegistries = this.providers.getRegistries('PromptRegistry');
+        childPromptRegistries
+            .filter((r) => r !== this)
+            .forEach((promptRegistry) => {
+            this.adoptFromChild(promptRegistry, promptRegistry.owner);
+        });
+        // Build effective indexes from (locals + already adopted children)
+        this.reindex();
+        this.bump('reset');
+        // Register prompt flows with the scope
+        const scope = this.providers.getActiveScope();
+        await scope.registryFlows(get_prompt_flow_1.default, prompts_list_flow_1.default);
     }
-    hasAny() {
-        return this.tokens.size > 0;
+    /* -------------------- Adoption: reference child instances (no cloning) -------------------- */
+    /**
+     * Adopt prompts from a child registry. Parent runs after children are ready.
+     * We *reference* the child's prompt instances; no duplicates are created.
+     */
+    adoptFromChild(child, _childOwner) {
+        if (this.children.has(child))
+            return;
+        const childRows = child.listAllIndexed();
+        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');
     }
-    getPrompts() {
-        return [];
+    /* -------------------- Public API -------------------- */
+    /**
+     * Get all prompts
+     */
+    getPrompts(includeHidden = false) {
+        const all = this.listAllIndexed();
+        return all
+            .filter((r) => {
+            const meta = r.instance.metadata;
+            const hidden = 'hideFromDiscovery' in meta && meta.hideFromDiscovery === true;
+            return !hidden || includeHidden;
+        })
+            .map((r) => r.instance);
     }
+    /**
+     * Get inline prompts (local only)
+     */
     getInlinePrompts() {
-        return [];
+        return [...this.instances.values()];
+    }
+    /**
+     * Find a prompt by exact name match
+     */
+    findByName(name) {
+        const rows = this.byName.get(name);
+        return rows?.[0]?.instance;
+    }
+    /**
+     * Find all prompts matching a name
+     */
+    findAllByName(name) {
+        const rows = this.byName.get(name) ?? [];
+        return rows.map((r) => r.instance);
+    }
+    /** Internal snapshot of effective indexed rows (locals + adopted). */
+    listAllIndexed() {
+        return [...this.localRows, ...[...this.adopted.values()].flat()];
+    }
+    /** 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);
+    }
+    /* -------------------- Indexing & lookups -------------------- */
+    reindex() {
+        const effective = this.listAllIndexed();
+        this.byQualifiedId.clear();
+        this.byName.clear();
+        this.byOwnerAndName.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);
+        }
+    }
+    /* -------------------- Conflict-aware exported names -------------------- */
+    /**
+     * Produce unique, MCP-valid exported names.
+     */
+    exportResolvedNames(opts) {
+        const cfg = { ...prompt_types_1.DEFAULT_PROMPT_EXPORT_OPTS, ...(opts ?? {}) };
+        const rows = this.listAllIndexed().map((r) => {
+            const base = (0, prompt_utils_1.normalizeSegment)(r.baseName, cfg.case);
+            const isLocal = r.source === this;
+            const provider = (0, prompt_utils_1.normalizeProviderId)(this.providerIdOf(r.instance), cfg.case);
+            const ownerPath = (0, prompt_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, prompt_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, prompt_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, prompt_utils_1.normalizeOwnerPath)(l.ownerPath, cfg.case);
+                        const name = (0, prompt_utils_1.ensureMaxLen)(`${pref}${(0, prompt_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, prompt_utils_1.ensureMaxLen)(`${pre}${(0, prompt_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, prompt_utils_1.ensureMaxLen)(`${pre}${(0, prompt_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 (n <= MAX_DISAMBIGUATE_ATTEMPTS) {
+                const withN = (0, prompt_utils_1.ensureMaxLen)(`${candidate}${(0, prompt_utils_1.sepFor)(cfg.case)}${n}`, cfg.maxLen);
+                if (!pool.has(withN))
+                    return withN;
+                n++;
+            }
+            throw new Error(`Failed to disambiguate name "${candidate}" after ${MAX_DISAMBIGUATE_ATTEMPTS} attempts`);
+        }
+    }
+    /** 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 IndexedPrompt row */
+    makeRow(token, instance, lineage, source) {
+        const ownerKey = (0, prompt_utils_1.ownerKeyOf)(lineage);
+        const baseName = instance.name;
+        const qualifiedName = (0, prompt_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, prompt_utils_1.ownerKeyOf)(lineage);
+        const qualifiedName = (0, prompt_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. */
+    providerIdOf(inst) {
+        try {
+            const meta = inst.getMetadata?.();
+            if (!meta || typeof meta !== 'object')
+                return undefined;
+            const metaObj = meta;
+            const maybe = metaObj['providerId'] ?? metaObj['provider'] ?? metaObj['ownerId'];
+            if (typeof maybe === 'string' && maybe.length > 0)
+                return maybe;
+            const cls = metaObj['cls'];
+            if (cls && typeof cls === 'function') {
+                const id = (0, metadata_utils_1.getMetadata)('id', cls);
+                if (typeof id === 'string' && id.length > 0)
+                    return id;
+                if ('name' in cls && typeof cls.name === 'string')
+                    return cls.name;
+            }
+        }
+        catch {
+            // Silently ignore errors - provider ID lookup is best-effort for prefixing
+            // and should not fail the overall operation
+        }
+        return undefined;
+    }
+    /** True if this registry (or adopted children) has any prompts. */
+    hasAny() {
+        return this.listAllIndexed().length > 0 || this.tokens.size > 0;
+    }
+    /**
+     * Get the MCP capabilities for prompts.
+     * These are reported to clients during initialization.
+     */
+    getCapabilities() {
+        return this.hasAny()
+            ? {
+                prompts: {
+                    // List change notifications are only supported when prompts are registered
+                    listChanged: true,
+                },
+            }
+            : {};
     }
 }
 exports.default = PromptRegistry;
+/* -------------------- 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=prompt.registry.js.map