@frontmcp/sdk 0.4.0 → 0.5.0

package/src/prompt/flows/prompts-list.flow.d.ts

@@ -0,0 +1,67 @@
+import { FlowBase, FlowRunOptions } from '../../common';
+import 'reflect-metadata';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    request: z.ZodObject<{
+        params: z.ZodOptional<z.ZodObject<{
+            _meta: z.ZodOptional<z.ZodObject<{
+                progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            }, z.core.$loose>>;
+            cursor: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        method: z.ZodLiteral<"prompts/list">;
+    }, z.core.$strip>;
+    ctx: z.ZodUnknown;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    nextCursor: z.ZodOptional<z.ZodString>;
+    prompts: z.ZodArray<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        arguments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            src: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+declare const stateSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    prompts: z.ZodArray<z.ZodObject<{
+        ownerName: z.ZodString;
+        prompt: z.ZodAny;
+    }, z.core.$strip>>;
+    resolvedPrompts: z.ZodArray<z.ZodObject<{
+        ownerName: z.ZodString;
+        prompt: z.ZodAny;
+        finalName: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const plan: {
+    readonly pre: ["parseInput"];
+    readonly execute: ["findPrompts", "resolveConflicts"];
+    readonly post: ["parsePrompts"];
+};
+declare global {
+    interface ExtendFlows {
+        'prompts:list-prompts': FlowRunOptions<PromptsListFlow, typeof plan, typeof inputSchema, typeof outputSchema, typeof stateSchema>;
+    }
+}
+declare const name: "prompts:list-prompts";
+export default class PromptsListFlow extends FlowBase<typeof name> {
+    logger: import("../../common").FrontMcpLogger;
+    private sample;
+    parseInput(): Promise<void>;
+    findPrompts(): Promise<void>;
+    resolveConflicts(): Promise<void>;
+    parsePrompts(): Promise<void>;
+}
+export {};

package/src/prompt/flows/prompts-list.flow.js

@@ -0,0 +1,176 @@
+"use strict";
+// file: libs/sdk/src/prompt/flows/prompts-list.flow.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const common_1 = require("../../common");
+require("reflect-metadata");
+const zod_1 = require("zod");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const errors_1 = require("../../errors");
+const inputSchema = zod_1.z.object({
+    request: types_js_1.ListPromptsRequestSchema,
+    ctx: zod_1.z.unknown(),
+});
+const outputSchema = types_js_1.ListPromptsResultSchema;
+const stateSchema = zod_1.z.object({
+    cursor: zod_1.z.string().optional(),
+    prompts: zod_1.z.array(zod_1.z.object({
+        ownerName: zod_1.z.string(),
+        // z.any() used because PromptEntry is a complex abstract class type
+        prompt: zod_1.z.any(),
+    })),
+    resolvedPrompts: zod_1.z.array(zod_1.z.object({
+        ownerName: zod_1.z.string(),
+        // z.any() used because PromptEntry is a complex abstract class type
+        prompt: zod_1.z.any(),
+        finalName: zod_1.z.string(),
+    })),
+});
+const plan = {
+    pre: ['parseInput'],
+    execute: ['findPrompts', 'resolveConflicts'],
+    post: ['parsePrompts'],
+};
+const name = 'prompts:list-prompts';
+const { Stage } = (0, common_1.FlowHooksOf)('prompts:list-prompts');
+let PromptsListFlow = class PromptsListFlow extends common_1.FlowBase {
+    logger = this.scopeLogger.child('PromptsListFlow');
+    sample(arr, n = 5) {
+        return arr.slice(0, n);
+    }
+    async parseInput() {
+        this.logger.verbose('parseInput:start');
+        let method;
+        let params;
+        try {
+            const inputData = inputSchema.parse(this.rawInput);
+            method = inputData.request.method;
+            params = inputData.request.params;
+        }
+        catch (e) {
+            throw new errors_1.InvalidInputError('Invalid request format', e instanceof zod_1.z.ZodError ? e.issues : undefined);
+        }
+        if (method !== 'prompts/list') {
+            this.logger.warn(`parseInput: invalid method "${method}"`);
+            throw new errors_1.InvalidMethodError(method, 'prompts/list');
+        }
+        const cursor = params?.cursor;
+        if (cursor)
+            this.logger.verbose(`parseInput: cursor=${cursor}`);
+        this.state.set('cursor', cursor);
+        this.logger.verbose('parseInput:done');
+    }
+    async findPrompts() {
+        this.logger.info('findPrompts:start');
+        try {
+            const prompts = [];
+            // Get prompts from scope's prompt registry
+            const scopePrompts = this.scope.prompts.getPrompts();
+            this.logger.verbose(`findPrompts: scope prompts=${scopePrompts.length}`);
+            for (const prompt of scopePrompts) {
+                prompts.push({ ownerName: prompt.owner.id, prompt });
+            }
+            this.logger.info(`findPrompts: total prompts collected=${prompts.length}`);
+            if (prompts.length === 0) {
+                this.logger.warn('findPrompts: no prompts found');
+            }
+            this.state.set('prompts', prompts);
+            this.logger.verbose('findPrompts:done');
+        }
+        catch (error) {
+            this.logger.error('findPrompts: failed to collect prompts', error);
+            throw error;
+        }
+    }
+    async resolveConflicts() {
+        this.logger.verbose('resolveConflicts:start');
+        try {
+            const found = this.state.required.prompts;
+            const counts = new Map();
+            for (const { prompt } of found) {
+                const baseName = prompt.metadata.name;
+                counts.set(baseName, (counts.get(baseName) ?? 0) + 1);
+            }
+            const conflicts = new Set([...counts.entries()].filter(([, n]) => n > 1).map(([k]) => k));
+            if (conflicts.size > 0) {
+                const preview = this.sample(Array.from(conflicts)).join(', ');
+                const extra = conflicts.size > 5 ? `, +${conflicts.size - 5} more` : '';
+                this.logger.warn(`resolveConflicts: ${conflicts.size} name conflict(s) detected: ${preview}${extra}`);
+            }
+            else {
+                this.logger.info('resolveConflicts: no name conflicts detected');
+            }
+            const resolved = found.map(({ ownerName, prompt }) => {
+                const baseName = prompt.metadata.name;
+                const finalName = conflicts.has(baseName) ? `${ownerName}:${baseName}` : baseName;
+                return { ownerName, prompt, finalName };
+            });
+            this.state.set('resolvedPrompts', resolved);
+            this.logger.verbose('resolveConflicts:done');
+        }
+        catch (error) {
+            this.logger.error('resolveConflicts: failed to resolve conflicts', error);
+            throw error;
+        }
+    }
+    async parsePrompts() {
+        this.logger.verbose('parsePrompts:start');
+        try {
+            const resolved = this.state.required.resolvedPrompts;
+            const prompts = resolved.map(({ finalName, prompt }) => ({
+                name: finalName,
+                title: prompt.metadata.title,
+                description: prompt.metadata.description,
+                arguments: prompt.metadata.arguments,
+                icons: prompt.metadata.icons,
+            }));
+            const preview = this.sample(prompts.map((p) => p.name)).join(', ');
+            const extra = prompts.length > 5 ? `, +${prompts.length - 5} more` : '';
+            this.logger.info(`parsePrompts: prepared ${prompts.length} prompt descriptor(s): ${preview}${extra}`);
+            this.respond({ prompts });
+            this.logger.info('parsePrompts: response sent');
+            this.logger.verbose('parsePrompts:done');
+        }
+        catch (error) {
+            if (error instanceof common_1.FlowControl)
+                throw error;
+            this.logger.error('parsePrompts: failed to parse prompts', error);
+            throw error;
+        }
+    }
+};
+tslib_1.__decorate([
+    Stage('parseInput'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], PromptsListFlow.prototype, "parseInput", null);
+tslib_1.__decorate([
+    Stage('findPrompts'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], PromptsListFlow.prototype, "findPrompts", null);
+tslib_1.__decorate([
+    Stage('resolveConflicts'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], PromptsListFlow.prototype, "resolveConflicts", null);
+tslib_1.__decorate([
+    Stage('parsePrompts'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], PromptsListFlow.prototype, "parsePrompts", null);
+PromptsListFlow = tslib_1.__decorate([
+    (0, common_1.Flow)({
+        name,
+        plan,
+        inputSchema,
+        outputSchema,
+        access: 'authorized',
+    })
+], PromptsListFlow);
+exports.default = PromptsListFlow;
+//# sourceMappingURL=prompts-list.flow.js.map

package/src/prompt/flows/prompts-list.flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts-list.flow.js","sourceRoot":"","sources":["../../../../src/prompt/flows/prompts-list.flow.ts"],"names":[],"mappings":";AAAA,uDAAuD;;;AAEvD,yCAA+G;AAC/G,4BAA0B;AAC1B,6BAAwB;AACxB,iEAA+G;AAC/G,yCAAqE;AAErE,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,OAAO,EAAE,mCAAwB;IACjC,GAAG,EAAE,OAAC,CAAC,OAAO,EAAE;CACjB,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,kCAAuB,CAAC;AAE7C,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,OAAC,CAAC,KAAK,CACd,OAAC,CAAC,MAAM,CAAC;QACP,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;QACrB,oEAAoE;QACpE,MAAM,EAAE,OAAC,CAAC,GAAG,EAAE;KAChB,CAAC,CACH;IACD,eAAe,EAAE,OAAC,CAAC,KAAK,CACtB,OAAC,CAAC,MAAM,CAAC;QACP,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;QACrB,oEAAoE;QACpE,MAAM,EAAE,OAAC,CAAC,GAAG,EAAE;QACf,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;KACtB,CAAC,CACH;CACF,CAAC,CAAC;AAIH,MAAM,IAAI,GAAG;IACX,GAAG,EAAE,CAAC,YAAY,CAAC;IACnB,OAAO,EAAE,CAAC,aAAa,EAAE,kBAAkB,CAAC;IAC5C,IAAI,EAAE,CAAC,cAAc,CAAC;CACa,CAAC;AActC,MAAM,IAAI,GAAG,sBAA+B,CAAC;AAC7C,MAAM,EAAE,KAAK,EAAE,GAAG,IAAA,oBAAW,EAAC,sBAAsB,CAAC,CAAC;AASvC,IAAM,eAAe,GAArB,MAAM,eAAgB,SAAQ,iBAAqB;IAChE,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAE3C,MAAM,CAAI,GAAQ,EAAE,CAAC,GAAG,CAAC;QAC/B,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzB,CAAC;IAGK,AAAN,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAExC,IAAI,MAAe,CAAC;QACpB,IAAI,MAAuC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnD,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;YAClC,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,MAAyC,CAAC;QACvE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,0BAAiB,CAAC,wBAAwB,EAAE,CAAC,YAAY,OAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACxG,CAAC;QAED,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,MAAM,GAAG,CAAC,CAAC;YAC3D,MAAM,IAAI,2BAAkB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC;QAC9B,IAAI,MAAM;YAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,sBAAsB,MAAM,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzC,CAAC;IAGK,AAAN,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAEtC,IAAI,CAAC;YACH,MAAM,OAAO,GAAsD,EAAE,CAAC;YAEtE,2CAA2C;YAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACrD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,8BAA8B,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;YAEzE,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;gBAClC,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YACvD,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wCAAwC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC3E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YACpD,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;YACnE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAGK,AAAN,KAAK,CAAC,gBAAgB;QACpB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;YAE1C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;YACzC,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACtC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACxD,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAElG,IAAI,SAAS,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9D,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,SAAS,CAAC,IAAI,+BAA+B,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC;YACxG,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YACnE,CAAC;YAED,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE;gBACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACtC,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAClF,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YAC1C,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+CAA+C,EAAE,KAAK,CAAC,CAAC;YAC1E,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAGK,AAAN,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAE1C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC;YAErD,MAAM,OAAO,GAAyB,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC7E,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK;gBAC5B,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW;gBACxC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS;gBACpC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK;aAC7B,CAAC,CAAC,CAAC;YAEJ,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnE,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAC,MAAM,0BAA0B,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC;YAEtG,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,oBAAW;gBAAE,MAAM,KAAK,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;YAClE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF,CAAA;AArHO;IADL,KAAK,CAAC,YAAY,CAAC;;;;iDAuBnB;AAGK;IADL,KAAK,CAAC,aAAa,CAAC;;;;kDA0BpB;AAGK;IADL,KAAK,CAAC,kBAAkB,CAAC;;;;uDAmCzB;AAGK;IADL,KAAK,CAAC,cAAc,CAAC;;;;mDA2BrB;AA5HkB,eAAe;IAPnC,IAAA,aAAI,EAAC;QACJ,IAAI;QACJ,IAAI;QACJ,WAAW;QACX,YAAY;QACZ,MAAM,EAAE,YAAY;KACrB,CAAC;GACmB,eAAe,CA6HnC;kBA7HoB,eAAe","sourcesContent":["// file: libs/sdk/src/prompt/flows/prompts-list.flow.ts\n\nimport { Flow, FlowBase, FlowControl, FlowHooksOf, FlowPlan, FlowRunOptions, PromptEntry } from '../../common';\nimport 'reflect-metadata';\nimport { z } from 'zod';\nimport { ListPromptsRequestSchema, ListPromptsResultSchema, Prompt } from '@modelcontextprotocol/sdk/types.js';\nimport { InvalidMethodError, InvalidInputError } from '../../errors';\n\nconst inputSchema = z.object({\n  request: ListPromptsRequestSchema,\n  ctx: z.unknown(),\n});\n\nconst outputSchema = ListPromptsResultSchema;\n\nconst stateSchema = z.object({\n  cursor: z.string().optional(),\n  prompts: z.array(\n    z.object({\n      ownerName: z.string(),\n      // z.any() used because PromptEntry is a complex abstract class type\n      prompt: z.any(),\n    }),\n  ),\n  resolvedPrompts: z.array(\n    z.object({\n      ownerName: z.string(),\n      // z.any() used because PromptEntry is a complex abstract class type\n      prompt: z.any(),\n      finalName: z.string(),\n    }),\n  ),\n});\n\ntype ResponsePromptItem = Prompt;\n\nconst plan = {\n  pre: ['parseInput'],\n  execute: ['findPrompts', 'resolveConflicts'],\n  post: ['parsePrompts'],\n} as const satisfies FlowPlan<string>;\n\ndeclare global {\n  interface ExtendFlows {\n    'prompts:list-prompts': FlowRunOptions<\n      PromptsListFlow,\n      typeof plan,\n      typeof inputSchema,\n      typeof outputSchema,\n      typeof stateSchema\n    >;\n  }\n}\n\nconst name = 'prompts:list-prompts' as const;\nconst { Stage } = FlowHooksOf('prompts:list-prompts');\n\n@Flow({\n  name,\n  plan,\n  inputSchema,\n  outputSchema,\n  access: 'authorized',\n})\nexport default class PromptsListFlow extends FlowBase<typeof name> {\n  logger = this.scopeLogger.child('PromptsListFlow');\n\n  private sample<T>(arr: T[], n = 5): T[] {\n    return arr.slice(0, n);\n  }\n\n  @Stage('parseInput')\n  async parseInput() {\n    this.logger.verbose('parseInput:start');\n\n    let method!: string;\n    let params: { cursor?: string } | undefined;\n    try {\n      const inputData = inputSchema.parse(this.rawInput);\n      method = inputData.request.method;\n      params = inputData.request.params as { cursor?: string } | undefined;\n    } catch (e) {\n      throw new InvalidInputError('Invalid request format', e instanceof z.ZodError ? e.issues : undefined);\n    }\n\n    if (method !== 'prompts/list') {\n      this.logger.warn(`parseInput: invalid method \"${method}\"`);\n      throw new InvalidMethodError(method, 'prompts/list');\n    }\n\n    const cursor = params?.cursor;\n    if (cursor) this.logger.verbose(`parseInput: cursor=${cursor}`);\n    this.state.set('cursor', cursor);\n    this.logger.verbose('parseInput:done');\n  }\n\n  @Stage('findPrompts')\n  async findPrompts() {\n    this.logger.info('findPrompts:start');\n\n    try {\n      const prompts: Array<{ ownerName: string; prompt: PromptEntry }> = [];\n\n      // Get prompts from scope's prompt registry\n      const scopePrompts = this.scope.prompts.getPrompts();\n      this.logger.verbose(`findPrompts: scope prompts=${scopePrompts.length}`);\n\n      for (const prompt of scopePrompts) {\n        prompts.push({ ownerName: prompt.owner.id, prompt });\n      }\n\n      this.logger.info(`findPrompts: total prompts collected=${prompts.length}`);\n      if (prompts.length === 0) {\n        this.logger.warn('findPrompts: no prompts found');\n      }\n\n      this.state.set('prompts', prompts);\n      this.logger.verbose('findPrompts:done');\n    } catch (error) {\n      this.logger.error('findPrompts: failed to collect prompts', error);\n      throw error;\n    }\n  }\n\n  @Stage('resolveConflicts')\n  async resolveConflicts() {\n    this.logger.verbose('resolveConflicts:start');\n\n    try {\n      const found = this.state.required.prompts;\n\n      const counts = new Map<string, number>();\n      for (const { prompt } of found) {\n        const baseName = prompt.metadata.name;\n        counts.set(baseName, (counts.get(baseName) ?? 0) + 1);\n      }\n\n      const conflicts = new Set<string>([...counts.entries()].filter(([, n]) => n > 1).map(([k]) => k));\n\n      if (conflicts.size > 0) {\n        const preview = this.sample(Array.from(conflicts)).join(', ');\n        const extra = conflicts.size > 5 ? `, +${conflicts.size - 5} more` : '';\n        this.logger.warn(`resolveConflicts: ${conflicts.size} name conflict(s) detected: ${preview}${extra}`);\n      } else {\n        this.logger.info('resolveConflicts: no name conflicts detected');\n      }\n\n      const resolved = found.map(({ ownerName, prompt }) => {\n        const baseName = prompt.metadata.name;\n        const finalName = conflicts.has(baseName) ? `${ownerName}:${baseName}` : baseName;\n        return { ownerName, prompt, finalName };\n      });\n\n      this.state.set('resolvedPrompts', resolved);\n      this.logger.verbose('resolveConflicts:done');\n    } catch (error) {\n      this.logger.error('resolveConflicts: failed to resolve conflicts', error);\n      throw error;\n    }\n  }\n\n  @Stage('parsePrompts')\n  async parsePrompts() {\n    this.logger.verbose('parsePrompts:start');\n\n    try {\n      const resolved = this.state.required.resolvedPrompts;\n\n      const prompts: ResponsePromptItem[] = resolved.map(({ finalName, prompt }) => ({\n        name: finalName,\n        title: prompt.metadata.title,\n        description: prompt.metadata.description,\n        arguments: prompt.metadata.arguments,\n        icons: prompt.metadata.icons,\n      }));\n\n      const preview = this.sample(prompts.map((p) => p.name)).join(', ');\n      const extra = prompts.length > 5 ? `, +${prompts.length - 5} more` : '';\n      this.logger.info(`parsePrompts: prepared ${prompts.length} prompt descriptor(s): ${preview}${extra}`);\n\n      this.respond({ prompts });\n      this.logger.info('parsePrompts: response sent');\n      this.logger.verbose('parsePrompts:done');\n    } catch (error) {\n      if (error instanceof FlowControl) throw error;\n      this.logger.error('parsePrompts: failed to parse prompts', error);\n      throw error;\n    }\n  }\n}\n"]}

package/src/prompt/index.d.ts

@@ -0,0 +1,7 @@
+export { default as PromptRegistry } from './prompt.registry';
+export { PromptInstance } from './prompt.instance';
+export * from './prompt.types';
+export * from './prompt.events';
+export * from './prompt.utils';
+export { default as GetPromptFlow } from './flows/get-prompt.flow';
+export { default as PromptsListFlow } from './flows/prompts-list.flow';

package/src/prompt/index.js

@@ -0,0 +1,17 @@
+"use strict";
+// file: libs/sdk/src/prompt/index.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptsListFlow = exports.GetPromptFlow = exports.PromptInstance = exports.PromptRegistry = void 0;
+const tslib_1 = require("tslib");
+var prompt_registry_1 = require("./prompt.registry");
+Object.defineProperty(exports, "PromptRegistry", { enumerable: true, get: function () { return tslib_1.__importDefault(prompt_registry_1).default; } });
+var prompt_instance_1 = require("./prompt.instance");
+Object.defineProperty(exports, "PromptInstance", { enumerable: true, get: function () { return prompt_instance_1.PromptInstance; } });
+tslib_1.__exportStar(require("./prompt.types"), exports);
+tslib_1.__exportStar(require("./prompt.events"), exports);
+tslib_1.__exportStar(require("./prompt.utils"), exports);
+var get_prompt_flow_1 = require("./flows/get-prompt.flow");
+Object.defineProperty(exports, "GetPromptFlow", { enumerable: true, get: function () { return tslib_1.__importDefault(get_prompt_flow_1).default; } });
+var prompts_list_flow_1 = require("./flows/prompts-list.flow");
+Object.defineProperty(exports, "PromptsListFlow", { enumerable: true, get: function () { return tslib_1.__importDefault(prompts_list_flow_1).default; } });
+//# sourceMappingURL=index.js.map

package/src/prompt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/prompt/index.ts"],"names":[],"mappings":";AAAA,qCAAqC;;;;AAErC,qDAA8D;AAArD,0IAAA,OAAO,OAAkB;AAClC,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AACvB,yDAA+B;AAC/B,0DAAgC;AAChC,yDAA+B;AAC/B,2DAAmE;AAA1D,yIAAA,OAAO,OAAiB;AACjC,+DAAuE;AAA9D,6IAAA,OAAO,OAAmB","sourcesContent":["// file: libs/sdk/src/prompt/index.ts\n\nexport { default as PromptRegistry } from './prompt.registry';\nexport { PromptInstance } from './prompt.instance';\nexport * from './prompt.types';\nexport * from './prompt.events';\nexport * from './prompt.utils';\nexport { default as GetPromptFlow } from './flows/get-prompt.flow';\nexport { default as PromptsListFlow } from './flows/prompts-list.flow';\n"]}

package/src/prompt/prompt.events.d.ts

@@ -0,0 +1,17 @@
+import { PromptInstance } from './prompt.instance';
+export type PromptChangeKind = 'added' | 'updated' | 'removed' | 'reset';
+export type PromptChangeEvent = {
+    kind: PromptChangeKind;
+    changeScope: 'global' | 'session';
+    sessionId?: string;
+    relatedRequestId?: string;
+    version: number;
+    snapshot: readonly PromptInstance[];
+};
+type Listener = (e: PromptChangeEvent) => void;
+export declare class PromptEmitter {
+    private listeners;
+    on(l: Listener): () => void;
+    emit(e: PromptChangeEvent): void;
+}
+export {};

package/src/prompt/prompt.events.js

@@ -0,0 +1,25 @@
+"use strict";
+// file: libs/sdk/src/prompt/prompt.events.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptEmitter = void 0;
+class PromptEmitter {
+    listeners = new Set();
+    on(l) {
+        this.listeners.add(l);
+        return () => this.listeners.delete(l);
+    }
+    emit(e) {
+        for (const l of [...this.listeners]) {
+            try {
+                l(e);
+            }
+            catch (err) {
+                // Log error but continue notifying other listeners
+                // Use safe logging to avoid Node.js 24 util.inspect bug with Zod errors
+                console.error('PromptEmitter listener error:', err instanceof Error ? err.message : 'Unknown error');
+            }
+        }
+    }
+}
+exports.PromptEmitter = PromptEmitter;
+//# sourceMappingURL=prompt.events.js.map

package/src/prompt/prompt.events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.events.js","sourceRoot":"","sources":["../../../src/prompt/prompt.events.ts"],"names":[],"mappings":";AAAA,6CAA6C;;;AAiB7C,MAAa,aAAa;IAChB,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;IAExC,EAAE,CAAC,CAAW;QACZ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,CAAoB;QACvB,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,CAAC,CAAC,CAAC,CAAC,CAAC;YACP,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,mDAAmD;gBACnD,wEAAwE;gBACxE,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;YACvG,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAnBD,sCAmBC","sourcesContent":["// file: libs/sdk/src/prompt/prompt.events.ts\n\nimport { PromptInstance } from './prompt.instance';\n\nexport type PromptChangeKind = 'added' | 'updated' | 'removed' | 'reset';\n\nexport type PromptChangeEvent = {\n  kind: PromptChangeKind;\n  changeScope: 'global' | 'session';\n  sessionId?: string;\n  relatedRequestId?: string;\n  version: number;\n  snapshot: readonly PromptInstance[];\n};\n\ntype Listener = (e: PromptChangeEvent) => void;\n\nexport class PromptEmitter {\n  private listeners = new Set<Listener>();\n\n  on(l: Listener): () => void {\n    this.listeners.add(l);\n    return () => this.listeners.delete(l);\n  }\n\n  emit(e: PromptChangeEvent) {\n    for (const l of [...this.listeners]) {\n      try {\n        l(e);\n      } catch (err) {\n        // Log error but continue notifying other listeners\n        // Use safe logging to avoid Node.js 24 util.inspect bug with Zod errors\n        console.error('PromptEmitter listener error:', err instanceof Error ? err.message : 'Unknown error');\n      }\n    }\n  }\n}\n"]}

package/src/prompt/prompt.instance.d.ts

@@ -0,0 +1,30 @@
+import { EntryOwnerRef, PromptEntry, PromptGetExtra, ParsedPromptResult, PromptSafeTransformResult, PromptRecord, PromptContext, PromptMetadata } from '../common';
+import ProviderRegistry from '../provider/provider.registry';
+import HookRegistry from '../hooks/hook.registry';
+import { Scope } from '../scope';
+export declare class PromptInstance extends PromptEntry {
+    private readonly providers;
+    readonly scope: Scope;
+    readonly hooks: HookRegistry;
+    constructor(record: PromptRecord, providers: ProviderRegistry, owner: EntryOwnerRef);
+    protected initialize(): Promise<void>;
+    getMetadata(): PromptMetadata;
+    /**
+     * Create a prompt context (class or function wrapper).
+     */
+    create(args: Record<string, string>, ctx: PromptGetExtra): PromptContext;
+    /**
+     * Parse and validate arguments against the prompt's argument definitions.
+     * @param args Arguments from the MCP request
+     * @returns Validated arguments
+     */
+    parseArguments(args?: Record<string, string>): Record<string, string>;
+    /**
+     * Convert the raw prompt return value into an MCP GetPromptResult.
+     */
+    parseOutput(raw: unknown): ParsedPromptResult;
+    /**
+     * Safe version of parseOutput that returns success/error instead of throwing.
+     */
+    safeParseOutput(raw: unknown): PromptSafeTransformResult<ParsedPromptResult>;
+}

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>;
 }