@frontmcp/sdk 0.4.1 → 0.5.1

package/src/prompt/flows/get-prompt.flow.js

@@ -0,0 +1,214 @@
+"use strict";
+// file: libs/sdk/src/prompt/flows/get-prompt.flow.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const common_1 = require("../../common");
+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.GetPromptRequestSchema,
+    // z.any() used because ctx is the MCP SDK's PromptGetExtra type which varies by SDK version
+    ctx: zod_1.z.any(),
+});
+const outputSchema = types_js_1.GetPromptResultSchema;
+const stateSchema = zod_1.z.object({
+    input: zod_1.z.object({
+        name: zod_1.z.string().min(1),
+        arguments: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
+    }),
+    // Prompt owner ID for hook filtering during execution
+    promptOwnerId: zod_1.z.string().optional(),
+    // z.any() used because AuthInfo is a complex external type from @modelcontextprotocol/sdk
+    authInfo: zod_1.z.any().optional(),
+    // z.any() used because PromptEntry is a complex abstract class type
+    prompt: zod_1.z.any(),
+    // Cached parsed arguments to avoid parsing twice (once in createPromptContext, once in execute)
+    parsedArgs: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
+    // z.any() used because PromptContext is a complex abstract class type
+    promptContext: zod_1.z.any(),
+    // z.any() used because prompt output type varies by prompt implementation
+    rawOutput: zod_1.z.any().optional(),
+    output: outputSchema,
+});
+const plan = {
+    pre: ['parseInput', 'findPrompt', 'createPromptContext'],
+    execute: ['execute', 'validateOutput'],
+    finalize: ['finalize'],
+};
+const name = 'prompts:get-prompt';
+const { Stage } = (0, common_1.FlowHooksOf)(name);
+let GetPromptFlow = class GetPromptFlow extends common_1.FlowBase {
+    logger = this.scopeLogger.child('GetPromptFlow');
+    async parseInput() {
+        this.logger.verbose('parseInput:start');
+        let method;
+        let params;
+        let ctx;
+        try {
+            const inputData = inputSchema.parse(this.rawInput);
+            method = inputData.request.method;
+            params = inputData.request.params;
+            ctx = inputData.ctx;
+        }
+        catch (e) {
+            throw new errors_1.InvalidInputError('Invalid Input', e instanceof zod_1.z.ZodError ? e.issues : undefined);
+        }
+        if (method !== 'prompts/get') {
+            this.logger.warn(`parseInput: invalid method "${method}"`);
+            throw new errors_1.InvalidMethodError(method, 'prompts/get');
+        }
+        this.state.set({
+            input: {
+                name: params.name,
+                arguments: params.arguments,
+            },
+            authInfo: ctx.authInfo,
+        });
+        this.logger.verbose('parseInput:done');
+    }
+    async findPrompt() {
+        this.logger.verbose('findPrompt:start');
+        const { name } = this.state.required.input;
+        this.logger.info(`findPrompt: looking for prompt with name "${name}"`);
+        // Try to find a prompt that matches this name
+        const prompt = this.scope.prompts.findByName(name);
+        if (!prompt) {
+            this.logger.warn(`findPrompt: prompt "${name}" not found`);
+            throw new errors_1.PromptNotFoundError(name);
+        }
+        // Store prompt owner ID in state for hook filtering during execution
+        this.state.set('promptOwnerId', prompt.owner?.id);
+        this.logger = this.logger.child(`GetPromptFlow(${name})`);
+        this.state.set('prompt', prompt);
+        this.logger.info(`findPrompt: prompt "${prompt.name}" found`);
+        this.logger.verbose('findPrompt:done');
+    }
+    async createPromptContext() {
+        this.logger.verbose('createPromptContext:start');
+        const { ctx } = this.input;
+        const { prompt, input } = this.state.required;
+        try {
+            // Parse and validate arguments, cache for reuse in execute stage
+            const parsedArgs = prompt.parseArguments(input.arguments);
+            this.state.set('parsedArgs', parsedArgs);
+            const context = prompt.create(parsedArgs, ctx);
+            const promptHooks = this.scope.hooks.getClsHooks(prompt.record.provide).map((hook) => {
+                hook.run = async () => {
+                    return context[hook.metadata.method]();
+                };
+                return hook;
+            });
+            this.appendContextHooks(promptHooks);
+            context.mark('createPromptContext');
+            this.state.set('promptContext', context);
+            this.logger.verbose('createPromptContext:done');
+        }
+        catch (error) {
+            this.logger.error('createPromptContext: failed to create context', error);
+            throw new errors_1.PromptExecutionError(input.name, error instanceof Error ? error : undefined);
+        }
+    }
+    async execute() {
+        this.logger.verbose('execute:start');
+        const promptContext = this.state.promptContext;
+        const { input, parsedArgs } = this.state.required;
+        if (!promptContext) {
+            this.logger.warn('execute: promptContext not found, skipping execution');
+            return;
+        }
+        promptContext.mark('execute');
+        try {
+            // Use cached parsed arguments from createPromptContext stage
+            promptContext.output = await promptContext.execute(parsedArgs);
+            this.logger.verbose('execute:done');
+        }
+        catch (error) {
+            this.logger.error('execute: prompt execution failed', error);
+            throw new errors_1.PromptExecutionError(input.name, error instanceof Error ? error : undefined);
+        }
+    }
+    async validateOutput() {
+        this.logger.verbose('validateOutput:start');
+        const { promptContext } = this.state;
+        if (!promptContext) {
+            this.logger.warn('validateOutput: promptContext not found, skipping validation');
+            return;
+        }
+        promptContext.mark('validateOutput');
+        // Store the RAW output for plugins to inspect
+        this.state.set('rawOutput', promptContext.output);
+        this.logger.verbose('validateOutput:done');
+    }
+    async finalize() {
+        this.logger.verbose('finalize:start');
+        const { prompt, rawOutput, input } = this.state;
+        if (!prompt) {
+            this.logger.error('finalize: prompt not found in state');
+            throw new errors_1.PromptExecutionError('unknown', new Error('Prompt not found in state'));
+        }
+        if (rawOutput === undefined) {
+            this.logger.error('finalize: prompt output not found in state');
+            throw new errors_1.PromptExecutionError(input?.name || 'unknown', new Error('Prompt output not found'));
+        }
+        // Parse and construct the MCP-compliant output using safeParseOutput
+        const parseResult = prompt.safeParseOutput(rawOutput);
+        if (!parseResult.success) {
+            this.logger.error('finalize: output validation failed', {
+                prompt: prompt.metadata.name,
+                errors: parseResult.error,
+            });
+            throw new errors_1.InvalidOutputError();
+        }
+        // Respond with the properly formatted MCP result
+        this.respond(parseResult.data);
+        this.logger.verbose('finalize:done');
+    }
+};
+tslib_1.__decorate([
+    Stage('parseInput'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], GetPromptFlow.prototype, "parseInput", null);
+tslib_1.__decorate([
+    Stage('findPrompt'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], GetPromptFlow.prototype, "findPrompt", null);
+tslib_1.__decorate([
+    Stage('createPromptContext'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], GetPromptFlow.prototype, "createPromptContext", null);
+tslib_1.__decorate([
+    Stage('execute'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], GetPromptFlow.prototype, "execute", null);
+tslib_1.__decorate([
+    Stage('validateOutput'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], GetPromptFlow.prototype, "validateOutput", null);
+tslib_1.__decorate([
+    Stage('finalize'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], GetPromptFlow.prototype, "finalize", null);
+GetPromptFlow = tslib_1.__decorate([
+    (0, common_1.Flow)({
+        name,
+        plan,
+        inputSchema,
+        outputSchema,
+        access: 'authorized',
+    })
+], GetPromptFlow);
+exports.default = GetPromptFlow;
+//# sourceMappingURL=get-prompt.flow.js.map

package/src/prompt/flows/get-prompt.flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-prompt.flow.js","sourceRoot":"","sources":["../../../../src/prompt/flows/get-prompt.flow.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/prompt/flows/get-prompt.flow.ts\n\nimport { Flow, FlowBase, FlowHooksOf, FlowPlan, FlowRunOptions, PromptContext, PromptEntry } from '../../common';\nimport { z } from 'zod';\nimport { GetPromptRequestSchema, GetPromptResultSchema } from '@modelcontextprotocol/sdk/types.js';\nimport { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';\nimport {\n  InvalidMethodError,\n  PromptNotFoundError,\n  InvalidInputError,\n  InvalidOutputError,\n  PromptExecutionError,\n} from '../../errors';\n\nconst inputSchema = z.object({\n  request: GetPromptRequestSchema,\n  // z.any() used because ctx is the MCP SDK's PromptGetExtra type which varies by SDK version\n  ctx: z.any(),\n});\n\nconst outputSchema = GetPromptResultSchema;\n\nconst stateSchema = z.object({\n  input: z.object({\n    name: z.string().min(1),\n    arguments: z.record(z.string(), z.string()).optional(),\n  }),\n  // Prompt owner ID for hook filtering during execution\n  promptOwnerId: z.string().optional(),\n  // z.any() used because AuthInfo is a complex external type from @modelcontextprotocol/sdk\n  authInfo: z.any().optional() as z.ZodType<AuthInfo>,\n  // z.any() used because PromptEntry is a complex abstract class type\n  prompt: z.any() as z.ZodType<PromptEntry>,\n  // Cached parsed arguments to avoid parsing twice (once in createPromptContext, once in execute)\n  parsedArgs: z.record(z.string(), z.string()).optional(),\n  // z.any() used because PromptContext is a complex abstract class type\n  promptContext: z.any() as z.ZodType<PromptContext>,\n  // z.any() used because prompt output type varies by prompt implementation\n  rawOutput: z.any().optional(),\n  output: outputSchema,\n});\n\nconst plan = {\n  pre: ['parseInput', 'findPrompt', 'createPromptContext'],\n  execute: ['execute', 'validateOutput'],\n  finalize: ['finalize'],\n} as const satisfies FlowPlan<string>;\n\ndeclare global {\n  interface ExtendFlows {\n    'prompts:get-prompt': FlowRunOptions<\n      GetPromptFlow,\n      typeof plan,\n      typeof inputSchema,\n      typeof outputSchema,\n      typeof stateSchema\n    >;\n  }\n}\n\nconst name = 'prompts:get-prompt' as const;\nconst { Stage } = FlowHooksOf<'prompts:get-prompt'>(name);\n\n@Flow({\n  name,\n  plan,\n  inputSchema,\n  outputSchema,\n  access: 'authorized',\n})\nexport default class GetPromptFlow extends FlowBase<typeof name> {\n  logger = this.scopeLogger.child('GetPromptFlow');\n\n  @Stage('parseInput')\n  async parseInput() {\n    this.logger.verbose('parseInput:start');\n\n    let method!: string;\n    let params: any;\n    let ctx: any;\n    try {\n      const inputData = inputSchema.parse(this.rawInput);\n      method = inputData.request.method;\n      params = inputData.request.params;\n      ctx = inputData.ctx;\n    } catch (e) {\n      throw new InvalidInputError('Invalid Input', e instanceof z.ZodError ? e.issues : undefined);\n    }\n\n    if (method !== 'prompts/get') {\n      this.logger.warn(`parseInput: invalid method \"${method}\"`);\n      throw new InvalidMethodError(method, 'prompts/get');\n    }\n\n    this.state.set({\n      input: {\n        name: params.name,\n        arguments: params.arguments,\n      },\n      authInfo: ctx.authInfo,\n    });\n    this.logger.verbose('parseInput:done');\n  }\n\n  @Stage('findPrompt')\n  async findPrompt() {\n    this.logger.verbose('findPrompt:start');\n\n    const { name } = this.state.required.input;\n    this.logger.info(`findPrompt: looking for prompt with name \"${name}\"`);\n\n    // Try to find a prompt that matches this name\n    const prompt = this.scope.prompts.findByName(name);\n\n    if (!prompt) {\n      this.logger.warn(`findPrompt: prompt \"${name}\" not found`);\n      throw new PromptNotFoundError(name);\n    }\n\n    // Store prompt owner ID in state for hook filtering during execution\n    this.state.set('promptOwnerId', prompt.owner?.id);\n\n    this.logger = this.logger.child(`GetPromptFlow(${name})`);\n    this.state.set('prompt', prompt);\n    this.logger.info(`findPrompt: prompt \"${prompt.name}\" found`);\n    this.logger.verbose('findPrompt:done');\n  }\n\n  @Stage('createPromptContext')\n  async createPromptContext() {\n    this.logger.verbose('createPromptContext:start');\n    const { ctx } = this.input;\n    const { prompt, input } = this.state.required;\n\n    try {\n      // Parse and validate arguments, cache for reuse in execute stage\n      const parsedArgs = prompt.parseArguments(input.arguments);\n      this.state.set('parsedArgs', parsedArgs);\n\n      const context = prompt.create(parsedArgs, ctx);\n      const promptHooks = this.scope.hooks.getClsHooks(prompt.record.provide).map((hook) => {\n        hook.run = async () => {\n          return context[hook.metadata.method]();\n        };\n        return hook;\n      });\n\n      this.appendContextHooks(promptHooks);\n      context.mark('createPromptContext');\n      this.state.set('promptContext', context);\n      this.logger.verbose('createPromptContext:done');\n    } catch (error) {\n      this.logger.error('createPromptContext: failed to create context', error);\n      throw new PromptExecutionError(input.name, error instanceof Error ? error : undefined);\n    }\n  }\n\n  @Stage('execute')\n  async execute() {\n    this.logger.verbose('execute:start');\n    const promptContext = this.state.promptContext;\n    const { input, parsedArgs } = this.state.required;\n\n    if (!promptContext) {\n      this.logger.warn('execute: promptContext not found, skipping execution');\n      return;\n    }\n    promptContext.mark('execute');\n\n    try {\n      // Use cached parsed arguments from createPromptContext stage\n      promptContext.output = await promptContext.execute(parsedArgs);\n      this.logger.verbose('execute:done');\n    } catch (error) {\n      this.logger.error('execute: prompt execution failed', error);\n      throw new PromptExecutionError(input.name, error instanceof Error ? error : undefined);\n    }\n  }\n\n  @Stage('validateOutput')\n  async validateOutput() {\n    this.logger.verbose('validateOutput:start');\n    const { promptContext } = this.state;\n    if (!promptContext) {\n      this.logger.warn('validateOutput: promptContext not found, skipping validation');\n      return;\n    }\n    promptContext.mark('validateOutput');\n\n    // Store the RAW output for plugins to inspect\n    this.state.set('rawOutput', promptContext.output);\n\n    this.logger.verbose('validateOutput:done');\n  }\n\n  @Stage('finalize')\n  async finalize() {\n    this.logger.verbose('finalize:start');\n    const { prompt, rawOutput, input } = this.state;\n\n    if (!prompt) {\n      this.logger.error('finalize: prompt not found in state');\n      throw new PromptExecutionError('unknown', new Error('Prompt not found in state'));\n    }\n\n    if (rawOutput === undefined) {\n      this.logger.error('finalize: prompt output not found in state');\n      throw new PromptExecutionError(input?.name || 'unknown', new Error('Prompt output not found'));\n    }\n\n    // Parse and construct the MCP-compliant output using safeParseOutput\n    const parseResult = prompt.safeParseOutput(rawOutput);\n\n    if (!parseResult.success) {\n      this.logger.error('finalize: output validation failed', {\n        prompt: prompt.metadata.name,\n        errors: parseResult.error,\n      });\n\n      throw new InvalidOutputError();\n    }\n\n    // Respond with the properly formatted MCP result\n    this.respond(parseResult.data);\n    this.logger.verbose('finalize:done');\n  }\n}\n"]}

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

@@ -0,0 +1,78 @@
+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<{
+            task: z.ZodOptional<z.ZodObject<{
+                ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+                pollInterval: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            _meta: z.ZodOptional<z.ZodObject<{
+                progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
+                    taskId: z.ZodString;
+                }, z.core.$loose>>;
+            }, 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.ZodObject<{
+        "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
+            taskId: z.ZodString;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+    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":"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","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>;
+}