@vurb/core 3.2.0

package/dist/prompt/PromptRegistry.js

@@ -0,0 +1,399 @@
+/**
+ * PromptRegistry — Centralized Prompt Registration & Routing
+ *
+ * The single place where all prompt builders are registered and where
+ * incoming `prompts/list` and `prompts/get` requests are routed.
+ *
+ * Mirrors the design of {@link ToolRegistry} with prompt-specific features:
+ * - O(1) routing via Map lookup
+ * - Tag-based filtering for RBAC exposure
+ * - Lifecycle sync via `notifyChanged()` (→ `notifications/prompts/list_changed`)
+ *
+ * @example
+ * ```typescript
+ * import { PromptRegistry, definePrompt } from 'vurb';
+ *
+ * const promptRegistry = new PromptRegistry<AppContext>();
+ * promptRegistry.register(AuditPrompt);
+ * promptRegistry.register(OnboardingPrompt);
+ *
+ * // Attach alongside tools:
+ * attachToServer(server, {
+ *     tools: toolRegistry,
+ *     prompts: promptRegistry,
+ *     contextFactory: createContext,
+ * });
+ *
+ * // Lifecycle sync (e.g., after RBAC change):
+ * promptRegistry.notifyChanged();
+ * ```
+ *
+ * @see {@link definePrompt} for creating prompt builders
+ * @see {@link PromptBuilder} for the builder contract
+ *
+ * @module
+ */
+import {} from './types.js';
+import { runWithHydrationDeadline } from './HydrationSandbox.js';
+import { CursorCodec } from './CursorCodec.js';
+// ── MX Helpers ───────────────────────────────────────────
+/**
+ * Format key-value data into an XML semantic block.
+ *
+ * @internal Used by the interceptor builder's `prependContext`/`appendContext`.
+ */
+function formatContext(tag, data) {
+    const entries = Object.entries(data)
+        .map(([key, value]) => `  ${key}: ${value}`)
+        .join('\n');
+    return `<${tag}_context>\n${entries}\n</${tag}_context>`;
+}
+// ── Registry ─────────────────────────────────────────────
+export class PromptRegistry {
+    _builders = new Map();
+    _interceptors = [];
+    _notificationSink;
+    _notifyDebounceTimer;
+    _defaultHydrationTimeout;
+    // Pagination
+    _cursorCodec = new CursorCodec();
+    _pageSize = 50;
+    /**
+     * Configure stateless cursor-based pagination for `prompts/list`.
+     * Overrides the default page size of 50.
+     *
+     * @param options Pagination configuration (pageSize, modes, secrets)
+     */
+    configurePagination(options) {
+        if (options.pageSize)
+            this._pageSize = options.pageSize;
+        if (options.cursorMode || options.cursorSecret) {
+            this._cursorCodec = new CursorCodec({
+                mode: options.cursorMode ?? 'signed',
+                ...(options.cursorSecret ? { secret: options.cursorSecret } : {})
+            });
+        }
+    }
+    /**
+     * Set a global hydration timeout for ALL prompts in this registry.
+     *
+     * Individual prompts can override with their own `hydrationTimeout`.
+     * If neither is set, no timeout is applied (backward compatible).
+     *
+     * **Enterprise use case**: The platform team sets a 5s global deadline.
+     * Critical prompts like `morning_briefing` set their own 3s deadline.
+     * Simple prompts (no external I/O) inherit the 5s safety net.
+     *
+     * @param ms - Maximum hydration time in milliseconds (must be > 0)
+     *
+     * @example
+     * ```typescript
+     * const promptRegistry = new PromptRegistry<AppContext>();
+     * promptRegistry.setDefaultHydrationTimeout(5000); // 5s global safety net
+     * ```
+     */
+    setDefaultHydrationTimeout(ms) {
+        this._defaultHydrationTimeout = ms;
+    }
+    /**
+     * Register a single prompt builder.
+     *
+     * Validates that the prompt name is unique and triggers
+     * `buildPromptDefinition()` to compile at registration time.
+     *
+     * @param builder - A prompt builder (from `definePrompt()`)
+     * @throws If a prompt with the same name is already registered
+     */
+    register(builder) {
+        const name = builder.getName();
+        if (this._builders.has(name)) {
+            throw new Error(`Prompt "${name}" is already registered.`);
+        }
+        builder.buildPromptDefinition();
+        this._builders.set(name, builder);
+    }
+    /**
+     * Register multiple prompt builders at once.
+     */
+    registerAll(...builders) {
+        for (const builder of builders) {
+            this.register(builder);
+        }
+    }
+    /**
+     * Register a global Prompt Interceptor.
+     *
+     * Interceptors run AFTER the handler produces its `PromptResult` and BEFORE
+     * the result is returned to the MCP client. They can prepend/append messages
+     * to inject compliance headers, tenant context, RBAC constraints, or any
+     * global state that should wrap every prompt.
+     *
+     * **Enterprise use case**: The CISO requires every LLM interaction to include
+     * tenant isolation rules. Register one interceptor — it applies to all 50 prompts.
+     *
+     * Multiple interceptors are supported. They execute in registration order.
+     *
+     * @param interceptor - Callback receiving (ctx, builder, promptMeta)
+     *
+     * @example
+     * ```typescript
+     * promptRegistry.useInterceptor(async (ctx, builder, meta) => {
+     *     builder.prependSystem(
+     *         `[ENTERPRISE COMPLIANCE LAYER]\n` +
+     *         `User Role: ${ctx.user.role} (Tenant ID: ${ctx.tenant.id})\n` +
+     *         `Server Time: ${new Date().toISOString()}`
+     *     );
+     * });
+     * ```
+     */
+    useInterceptor(interceptor) {
+        this._interceptors.push(interceptor);
+    }
+    /**
+     * Get all registered MCP Prompt definitions.
+     *
+     * Returns the compiled prompt metadata for `prompts/list`.
+     * @deprecated Use `listPrompts({ filter })` instead for pagination support.
+     */
+    getAllPrompts() {
+        const prompts = [];
+        for (const builder of this._builders.values()) {
+            prompts.push(builder.buildPromptDefinition());
+        }
+        return prompts;
+    }
+    /**
+     * Get prompt definitions filtered by tags.
+     *
+     * Uses Set-based lookups for O(1) tag matching.
+     * @deprecated Use `listPrompts({ filter })` instead for pagination support.
+     */
+    getPrompts(filter) {
+        const requiredTags = filter.tags && filter.tags.length > 0
+            ? new Set(filter.tags) : undefined;
+        const anyTags = filter.anyTag && filter.anyTag.length > 0
+            ? new Set(filter.anyTag) : undefined;
+        const excludeTags = filter.exclude && filter.exclude.length > 0
+            ? new Set(filter.exclude) : undefined;
+        const prompts = [];
+        for (const builder of this._builders.values()) {
+            const builderTags = builder.getTags();
+            // AND logic
+            if (requiredTags && !Array.from(requiredTags).every(t => builderTags.includes(t))) {
+                continue;
+            }
+            // OR logic
+            if (anyTags && !builderTags.some(t => anyTags.has(t))) {
+                continue;
+            }
+            // Exclude
+            if (excludeTags && builderTags.some(t => excludeTags.has(t))) {
+                continue;
+            }
+            prompts.push(builder.buildPromptDefinition());
+        }
+        return prompts;
+    }
+    /**
+     * Get paginated prompt definitions for `prompts/list`.
+     *
+     * Applies tag filters and decodes stateless cursors to return
+     * the requested slice of prompts, along with a `nextCursor` if more exist.
+     * Memory consumption is strictly O(1) across connections.
+     *
+     * @param request - Configuration containing optional `filter` and `cursor`.
+     * @returns Object with the array of prompts and an optional `nextCursor`.
+     */
+    async listPrompts(request) {
+        const filter = request?.filter;
+        const requiredTags = filter?.tags && filter.tags.length > 0 ? new Set(filter.tags) : undefined;
+        const anyTags = filter?.anyTag && filter.anyTag.length > 0 ? new Set(filter.anyTag) : undefined;
+        const excludeTags = filter?.exclude && filter.exclude.length > 0 ? new Set(filter.exclude) : undefined;
+        // Iterate maps in insertion order
+        const allNames = [];
+        for (const [name, builder] of this._builders.entries()) {
+            if (filter) {
+                const builderTags = builder.getTags();
+                // AND logic
+                if (requiredTags && !Array.from(requiredTags).every(t => builderTags.includes(t)))
+                    continue;
+                // OR logic
+                if (anyTags && !builderTags.some(t => anyTags.has(t)))
+                    continue;
+                // Exclude
+                if (excludeTags && builderTags.some(t => excludeTags.has(t)))
+                    continue;
+            }
+            allNames.push(name);
+        }
+        let startIndex = 0;
+        if (request?.cursor) {
+            const decoded = await this._cursorCodec.decode(request.cursor);
+            if (decoded && decoded.after) {
+                const lastIndex = allNames.indexOf(decoded.after);
+                if (lastIndex !== -1) {
+                    startIndex = lastIndex + 1; // start from the next item
+                }
+                else {
+                    // Cursor target was removed between pages — skip to end
+                    // (insertion-order keys are not sorted, so lexicographic successor is meaningless)
+                    startIndex = allNames.length;
+                }
+            }
+        }
+        const pageNames = allNames.slice(startIndex, startIndex + this._pageSize);
+        const prompts = pageNames.map(name => this._builders.get(name).buildPromptDefinition());
+        let nextCursor;
+        if (startIndex + this._pageSize < allNames.length) {
+            const lastInPage = pageNames[pageNames.length - 1];
+            if (lastInPage) {
+                nextCursor = await this._cursorCodec.encode({ after: lastInPage });
+            }
+        }
+        return nextCursor ? { prompts, nextCursor } : { prompts };
+    }
+    /**
+     * Route an incoming `prompts/get` request to the correct builder.
+     *
+     * Looks up the builder by name and delegates to its `execute()` method.
+     * Returns an error prompt result if the prompt is not found.
+     *
+     * @param ctx - Application context (from contextFactory)
+     * @param name - Prompt name from the incoming MCP request
+     * @param args - Raw string arguments from the MCP client
+     * @returns The hydrated prompt result
+     */
+    async routeGet(ctx, name, args) {
+        const builder = this._builders.get(name);
+        if (!builder) {
+            const available = Array.from(this._builders.keys()).join(', ');
+            return {
+                messages: [{
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Unknown prompt: "${name}". Available prompts: ${available}`,
+                        },
+                    }],
+            };
+        }
+        // ── Hydration Deadline ───────────────────────────
+        // Per-prompt timeout overrides registry default.
+        // Zero overhead when no timeout configured.
+        const effectiveTimeout = builder.getHydrationTimeout() ?? this._defaultHydrationTimeout;
+        const result = effectiveTimeout && effectiveTimeout > 0
+            ? await runWithHydrationDeadline(() => builder.execute(ctx, args), effectiveTimeout)
+            : await builder.execute(ctx, args);
+        // ── Prompt Interceptors ──────────────────────────
+        // Zero overhead when no interceptors registered.
+        if (this._interceptors.length === 0)
+            return result;
+        // Build PromptMeta from the builder's compiled definition
+        const def = builder.buildPromptDefinition();
+        const meta = {
+            name: def.name,
+            ...(def.description ? { description: def.description } : {}),
+            tags: builder.getTags(),
+        };
+        // Create mutable builder facade
+        const prepended = [];
+        const appended = [];
+        const interceptorBuilder = {
+            prependSystem(text) {
+                prepended.push({ role: 'user', content: { type: 'text', text } });
+            },
+            prependUser(text) {
+                prepended.push({ role: 'user', content: { type: 'text', text } });
+            },
+            appendSystem(text) {
+                appended.push({ role: 'user', content: { type: 'text', text } });
+            },
+            appendUser(text) {
+                appended.push({ role: 'user', content: { type: 'text', text } });
+            },
+            appendAssistant(text) {
+                appended.push({ role: 'assistant', content: { type: 'text', text } });
+            },
+            prependContext(tag, data) {
+                prepended.push({ role: 'user', content: { type: 'text', text: formatContext(tag, data) } });
+            },
+            appendContext(tag, data) {
+                appended.push({ role: 'user', content: { type: 'text', text: formatContext(tag, data) } });
+            },
+        };
+        // Execute interceptors in registration order
+        for (const interceptor of this._interceptors) {
+            await interceptor(ctx, interceptorBuilder, meta);
+        }
+        // Short-circuit: no messages added → return original
+        if (prepended.length === 0 && appended.length === 0)
+            return result;
+        // Merge: prepend + original + append
+        return {
+            ...result,
+            messages: [...prepended, ...result.messages, ...appended],
+        };
+    }
+    // ── Lifecycle Sync ───────────────────────────────────
+    /**
+     * Set the notification sink for `notifications/prompts/list_changed`.
+     *
+     * Called by `ServerAttachment` when attaching the registry to a server.
+     * The sink invokes the MCP SDK's `sendPromptListChanged()` method.
+     *
+     * @internal — not part of the public API
+     */
+    setNotificationSink(sink) {
+        this._notificationSink = sink;
+    }
+    /**
+     * Notify all connected clients that the prompt catalog has changed.
+     *
+     * Sends `notifications/prompts/list_changed` to all connected clients,
+     * causing them to re-fetch `prompts/list` and update their UI.
+     *
+     * **Debounced:** Multiple calls within 100ms are coalesced into a single
+     * notification to prevent storms during bulk registration or RBAC updates.
+     *
+     * Use cases:
+     * - RBAC change: user promoted/demoted → visible prompts change
+     * - SOP update: compliance rules changed → prompt logic updated
+     * - Feature flag: new prompt enabled for beta users
+     *
+     * @example
+     * ```typescript
+     * // In your RBAC webhook handler:
+     * app.post('/webhooks/role-changed', async (req) => {
+     *     await db.users.updateRole(req.userId, req.newRole);
+     *     promptRegistry.notifyChanged(); // All clients refresh instantly
+     * });
+     * ```
+     */
+    notifyChanged() {
+        if (!this._notificationSink)
+            return;
+        // Debounce: coalesce rapid calls into a single notification
+        if (this._notifyDebounceTimer !== undefined) {
+            clearTimeout(this._notifyDebounceTimer);
+        }
+        const sink = this._notificationSink;
+        this._notifyDebounceTimer = setTimeout(() => {
+            sink();
+            this._notifyDebounceTimer = undefined;
+        }, 100);
+    }
+    /** Check if a prompt with the given name is registered. */
+    has(name) { return this._builders.has(name); }
+    /** Remove all registered prompts, interceptors, and cancel pending timers. */
+    clear() {
+        this._builders.clear();
+        this._interceptors.length = 0;
+        if (this._notifyDebounceTimer !== undefined) {
+            clearTimeout(this._notifyDebounceTimer);
+            this._notifyDebounceTimer = undefined;
+        }
+    }
+    /** Number of registered prompts. */
+    get size() { return this._builders.size; }
+}
+//# sourceMappingURL=PromptRegistry.js.map

package/dist/prompt/PromptRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptRegistry.js","sourceRoot":"","sources":["../../src/prompt/PromptRegistry.ts"],"names":[],"mappings":"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"}

package/dist/prompt/definePrompt.d.ts

@@ -0,0 +1,111 @@
+/**
+ * PromptBuilderImpl — Internal Prompt Builder Implementation
+ *
+ * Implements the {@link PromptBuilder} interface for use by
+ * `definePrompt()` and `PromptRegistry`.
+ *
+ * Responsibilities:
+ * - Stores prompt metadata (name, description, tags, middleware)
+ * - Compiles Zod schema from ParamsMap (or uses raw Zod)
+ * - Validates flat schema constraint at construction time
+ * - Builds MCP Prompt definition for `prompts/list`
+ * - Delegates hydration to `PromptExecutionPipeline`
+ *
+ * @internal
+ * @module
+ */
+import { type ZodObject, type ZodRawShape } from 'zod';
+import { type PromptBuilder, type PromptResult, type PromptParamDef, type InferPromptArgs, type LoopbackContext } from './types.js';
+import { type MiddlewareFn } from '../core/types.js';
+export declare class PromptBuilderImpl<TContext = void> implements PromptBuilder<TContext> {
+    private readonly _name;
+    private readonly _title;
+    private readonly _description;
+    private readonly _icons;
+    private readonly _tags;
+    private readonly _middlewares;
+    private readonly _schema;
+    private readonly _handler;
+    private readonly _hydrationTimeout;
+    constructor(name: string, config: {
+        title?: string;
+        description?: string;
+        icons?: {
+            light?: string;
+            dark?: string;
+        };
+        tags?: string[];
+        middleware?: MiddlewareFn<TContext>[];
+        schema?: ZodObject<ZodRawShape>;
+        handler: (ctx: TContext & LoopbackContext, args: Record<string, unknown>) => Promise<PromptResult>;
+        hydrationTimeout?: number;
+    });
+    getName(): string;
+    getDescription(): string | undefined;
+    getTags(): string[];
+    hasMiddleware(): boolean;
+    getHydrationTimeout(): number | undefined;
+    buildPromptDefinition(): {
+        name: string;
+        title?: string;
+        description?: string;
+        icons?: {
+            light?: string;
+            dark?: string;
+        };
+        arguments?: Array<{
+            name: string;
+            description?: string;
+            required?: boolean;
+        }>;
+    };
+    execute(ctx: TContext, args: Record<string, string>): Promise<PromptResult>;
+}
+interface PromptConfigBase<TContext> {
+    title?: string;
+    description?: string;
+    icons?: {
+        light?: string;
+        dark?: string;
+    };
+    tags?: string[];
+    middleware?: MiddlewareFn<TContext>[];
+    hydrationTimeout?: number;
+}
+/**
+ * Overload 1: Zod schema — full type inference via `z.infer<>`
+ *
+ * ```typescript
+ * definePrompt<AppContext>('audit', {
+ *     args: z.object({ month: z.string(), strict: z.boolean() }),
+ *     handler: async (ctx, { month, strict }) => { ... }
+ *     //                     ^^^^^  ^^^^^^  ← fully typed!
+ * });
+ * ```
+ */
+export declare function definePrompt<TContext = void, S extends ZodRawShape = ZodRawShape>(name: string, config: PromptConfigBase<TContext> & {
+    args: ZodObject<S>;
+    handler: (ctx: TContext, args: ZodObject<S>["_output"]) => Promise<PromptResult>;
+}): PromptBuilder<TContext>;
+/**
+ * Overload 2: JSON-first descriptors — type inference via `InferPromptArgs<>`
+ *
+ * ```typescript
+ * definePrompt('greet', {
+ *     args: {
+ *         name: { type: 'string', required: true },
+ *         age:  'number',
+ *     } as const,
+ *     handler: async (ctx, { name, age }) => { ... }
+ *     //                     ^^^^  ^^^  ← name: string, age: number!
+ * });
+ * ```
+ *
+ * > 💡 Use `as const` on the args object for full literal type inference.
+ */
+export declare function definePrompt<TContext = void, T extends Record<string, PromptParamDef> = Record<string, PromptParamDef>>(name: string, config: PromptConfigBase<TContext> & {
+    args: T;
+    handler: (ctx: TContext, args: InferPromptArgs<T>) => Promise<PromptResult>;
+}): PromptBuilder<TContext>;
+export {};
+//# sourceMappingURL=definePrompt.d.ts.map

package/dist/prompt/definePrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definePrompt.d.ts","sourceRoot":"","sources":["../../src/prompt/definePrompt.ts"],"names":[],"mappings":"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"}

package/dist/prompt/definePrompt.js

@@ -0,0 +1,130 @@
+/**
+ * PromptBuilderImpl — Internal Prompt Builder Implementation
+ *
+ * Implements the {@link PromptBuilder} interface for use by
+ * `definePrompt()` and `PromptRegistry`.
+ *
+ * Responsibilities:
+ * - Stores prompt metadata (name, description, tags, middleware)
+ * - Compiles Zod schema from ParamsMap (or uses raw Zod)
+ * - Validates flat schema constraint at construction time
+ * - Builds MCP Prompt definition for `prompts/list`
+ * - Delegates hydration to `PromptExecutionPipeline`
+ *
+ * @internal
+ * @module
+ */
+import {} from 'zod';
+import {} from './types.js';
+import {} from '../core/types.js';
+import { convertParamsToZod } from '../core/builder/ParamDescriptors.js';
+import { assertFlatSchema, executePromptPipeline } from './PromptExecutionPipeline.js';
+import { isZodSchema } from '../core/schema/SchemaUtils.js';
+/**
+ * Extract argument metadata from a Zod schema for `prompts/list`.
+ *
+ * Reads field names, descriptions, and optionality from the schema shape
+ * to build the MCP `PromptArgument[]` array.
+ */
+function extractArgumentMeta(schema) {
+    const args = [];
+    for (const [key, field] of Object.entries(schema.shape)) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const def = field._def;
+        const isOptional = def?.typeName === 'ZodOptional' || def?.typeName === 'ZodDefault';
+        const description = field.description ?? def?.description;
+        const argMeta = {
+            name: key,
+            required: !isOptional,
+        };
+        if (typeof description === 'string') {
+            argMeta.description = description;
+        }
+        args.push(argMeta);
+    }
+    return args;
+}
+// ── PromptBuilderImpl ────────────────────────────────────
+export class PromptBuilderImpl {
+    _name;
+    _title;
+    _description;
+    _icons;
+    _tags;
+    _middlewares;
+    _schema;
+    _handler;
+    _hydrationTimeout;
+    constructor(name, config) {
+        this._name = name;
+        this._title = config.title;
+        this._description = config.description;
+        this._icons = config.icons;
+        this._tags = config.tags ?? [];
+        this._middlewares = config.middleware ?? [];
+        this._schema = config.schema;
+        this._handler = config.handler;
+        this._hydrationTimeout = config.hydrationTimeout;
+    }
+    getName() {
+        return this._name;
+    }
+    getDescription() {
+        return this._description;
+    }
+    getTags() {
+        return this._tags;
+    }
+    hasMiddleware() {
+        return this._middlewares.length > 0;
+    }
+    getHydrationTimeout() {
+        return this._hydrationTimeout;
+    }
+    buildPromptDefinition() {
+        const def = { name: this._name };
+        if (this._title) {
+            def.title = this._title;
+        }
+        if (this._description) {
+            def.description = this._description;
+        }
+        if (this._icons) {
+            def.icons = this._icons;
+        }
+        if (this._schema) {
+            def.arguments = extractArgumentMeta(this._schema);
+        }
+        return def;
+    }
+    async execute(ctx, args) {
+        return executePromptPipeline(ctx, args, this._schema, this._middlewares, this._handler);
+    }
+}
+// ── Implementation ───────────────────────────────────────
+export function definePrompt(name, config) {
+    // Compile args to Zod schema
+    let schema;
+    if (config.args) {
+        if (isZodSchema(config.args)) {
+            schema = config.args;
+        }
+        else {
+            schema = convertParamsToZod(config.args);
+        }
+        // Enforce flat schema constraint at definition time
+        assertFlatSchema(schema);
+    }
+    return new PromptBuilderImpl(name, {
+        title: config.title,
+        description: config.description,
+        icons: config.icons,
+        tags: config.tags,
+        middleware: config.middleware,
+        schema,
+        handler: config.handler,
+        hydrationTimeout: config.hydrationTimeout,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    });
+}
+//# sourceMappingURL=definePrompt.js.map

package/dist/prompt/definePrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definePrompt.js","sourceRoot":"","sources":["../../src/prompt/definePrompt.ts"],"names":[],"mappings":"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"}