@vurb/core 3.2.0

package/dist/prompt/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Prompt Engine — Barrel Export
+ *
+ * Public API for the MCP Prompt Engine.
+ * All exports are re-exported from bounded context modules.
+ */
+export type { PromptMessagePayload, PromptResult, PromptParamDef, PromptParamsMap, PromptBuilder, PromptConfig, ToolInvocationResult, LoopbackContext, PromptInterceptorFn, InterceptorBuilder, PromptMeta, } from './types.js';
+export { PromptMessage } from './PromptMessage.js';
+export { definePrompt } from './definePrompt.js';
+export { FluentPromptBuilder } from './FluentPromptBuilder.js';
+export { assertFlatSchema, coercePromptArgs, } from './PromptExecutionPipeline.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACR,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EACH,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,8BAA8B,CAAC"}

package/dist/prompt/index.js

@@ -0,0 +1,13 @@
+/**
+ * Prompt Engine — Barrel Export
+ *
+ * Public API for the MCP Prompt Engine.
+ * All exports are re-exported from bounded context modules.
+ */
+// ── Factories ────────────────────────────────────────────
+export { PromptMessage } from './PromptMessage.js';
+export { definePrompt } from './definePrompt.js';
+export { FluentPromptBuilder } from './FluentPromptBuilder.js';
+// ── Pipeline (advanced / testing) ────────────────────────
+export { assertFlatSchema, coercePromptArgs, } from './PromptExecutionPipeline.js';
+//# sourceMappingURL=index.js.map

package/dist/prompt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,4DAA4D;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,4DAA4D;AAC5D,OAAO,EACH,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,8BAA8B,CAAC"}

package/dist/prompt/types.d.ts

@@ -0,0 +1,425 @@
+/**
+ * Prompt Engine — Types & Contracts
+ *
+ * Type-only module defining the core contracts for the Prompt Engine.
+ * Follows the same "zero runtime code" pattern as `core/types.ts`.
+ *
+ * Key design decisions:
+ * - `PromptParamDef` restricts to flat primitives only (no arrays, no nested objects)
+ *   because MCP clients render prompt arguments as visual forms.
+ * - `PromptResult` mirrors MCP SDK's `GetPromptResult` shape.
+ * - `PromptBuilder` is the DIP interface that `PromptRegistry` depends on.
+ *
+ * @module
+ */
+import { type ZodObject, type ZodRawShape } from 'zod';
+import { type MiddlewareFn } from '../core/types.js';
+import { type StringParamDef, type NumberParamDef, type BooleanParamDef, type EnumParamDef } from '../core/builder/ParamDescriptors.js';
+import { type ToolResponse } from '../core/response.js';
+/**
+ * Result of an internal Tool invocation from within a Prompt handler.
+ *
+ * Returned by `ctx.invokeTool()`. Provides the Presenter-rendered text
+ * and error status without exposing MCP wire format internals.
+ *
+ * @example
+ * ```typescript
+ * const result = await ctx.invokeTool('billing.list_invoices', { date: '2026-01' });
+ * if (result.isError) {
+ *     // Handle gracefully — result.text contains the error message
+ * }
+ * // result.text contains the full Presenter-rendered output
+ * ```
+ */
+export interface ToolInvocationResult {
+    /** The full Presenter-rendered text output of the Tool */
+    readonly text: string;
+    /** Whether the Tool returned an error (`isError: true` in ToolResponse) */
+    readonly isError: boolean;
+    /** The original ToolResponse for advanced use cases */
+    readonly raw: ToolResponse;
+}
+/**
+ * Context extension injected by ServerAttachment when a PromptRegistry is attached.
+ *
+ * Enables **Internal Loopback Dispatch** — Prompt handlers can invoke Tools
+ * in-memory without an LLM round-trip. The Tool's full pipeline runs:
+ * middleware → validation → handler → Presenter. RBAC is enforced.
+ *
+ * **Design**: The Prompt acts as a server-side macro, aggregating data from
+ * multiple Tools into a single prompt. The dev codes the extraction logic
+ * once in the Tool, and the Prompt reuses the rendered result.
+ *
+ * @example
+ * ```typescript
+ * handler: async (ctx, args) => {
+ *     const invoices = await ctx.invokeTool('billing.list_invoices', { date: args.date });
+ *     const tickets  = await ctx.invokeTool('jira.get_assigned', { user_id: ctx.user.id });
+ *
+ *     return {
+ *         messages: [
+ *             PromptMessage.system('Plan my day based on this context:'),
+ *             PromptMessage.user(`### Invoices\n${invoices.text}\n\n### Tickets\n${tickets.text}`),
+ *         ],
+ *     };
+ * }
+ * ```
+ */
+export interface LoopbackContext {
+    /**
+     * Invoke a Tool internally, in-memory.
+     *
+     * Runs the Tool's full pipeline (middleware → validate → handler → Presenter)
+     * with the **same context** as the current Prompt request. RBAC is enforced.
+     *
+     * @param name - Tool name in canonical dot-notation (e.g. `'billing.list_invoices'`)
+     * @param args - Arguments passed to the Tool handler (default: `{}`)
+     * @returns The rendered Tool output
+     */
+    invokeTool(name: string, args?: Record<string, unknown>): Promise<ToolInvocationResult>;
+}
+/**
+ * Read-only metadata about the prompt being executed.
+ *
+ * Passed to interceptor callbacks so they can conditionally inject
+ * context based on the prompt's identity, tags, or description.
+ */
+export interface PromptMeta {
+    /** The prompt's registered name */
+    readonly name: string;
+    /** The prompt description (if provided) */
+    readonly description?: string;
+    /** The prompt's capability tags */
+    readonly tags: readonly string[];
+}
+/**
+ * Mutable builder-pattern facade for Prompt Interceptors.
+ *
+ * Interceptors use this to inject messages into the prompt result
+ * without touching the developer's handler code. Multiple interceptors
+ * compose cleanly — prepends stack in registration order (first registered
+ * ends up at the very top), appends stack in registration order.
+ *
+ * @example
+ * ```typescript
+ * registry.useInterceptor(async (ctx, builder, meta) => {
+ *     builder.prependSystem(
+ *         `[COMPLIANCE] Tenant: ${ctx.tenant.id} | User: ${ctx.user.role}`
+ *     );
+ *     builder.appendUser('--- End of automated context ---');
+ * });
+ * ```
+ */
+export interface InterceptorBuilder {
+    /** Prepend a system message at the TOP of the prompt messages */
+    prependSystem(text: string): void;
+    /** Prepend a user message at the TOP of the prompt messages */
+    prependUser(text: string): void;
+    /** Append a system message at the END of the prompt messages */
+    appendSystem(text: string): void;
+    /** Append a user message at the END of the prompt messages */
+    appendUser(text: string): void;
+    /** Append an assistant message at the END (for seeded responses) */
+    appendAssistant(text: string): void;
+    /**
+     * Prepend structured context with XML semantic boundary (MX-optimized).
+     *
+     * Auto-wraps the data in `<{tag}_context>` XML tags, giving the LLM
+     * a clear semantic boundary. Best for compliance, tenant, and RBAC context.
+     *
+     * @param tag - Semantic tag name (e.g. 'compliance', 'tenant', 'rbac')
+     * @param data - Key-value pairs to inject
+     *
+     * @example
+     * ```typescript
+     * builder.prependContext('compliance', {
+     *     role: ctx.user.role,
+     *     tenant: ctx.tenant.id,
+     * });
+     * // LLM receives:
+     * // <compliance_context>
+     * //   role: admin
+     * //   tenant: acme-corp
+     * // </compliance_context>
+     * ```
+     */
+    prependContext(tag: string, data: Record<string, string | number | boolean>): void;
+    /**
+     * Append structured context with XML semantic boundary (MX-optimized).
+     *
+     * Same as {@link prependContext} but appended at the END of messages.
+     *
+     * @param tag - Semantic tag name
+     * @param data - Key-value pairs to inject
+     */
+    appendContext(tag: string, data: Record<string, string | number | boolean>): void;
+}
+/**
+ * Prompt Interceptor callback signature.
+ *
+ * Interceptors run AFTER the handler produces its result and BEFORE
+ * the result is returned to the MCP client. They can inject compliance
+ * headers, tenant context, RBAC constraints, or any global context
+ * that should wrap every prompt — without modifying individual handlers.
+ *
+ * The enterprise answer to "every prompt must include tenant context":
+ * write it once, enforce it everywhere.
+ *
+ * @typeParam TContext - Application context type
+ *
+ * @example
+ * ```typescript
+ * // Register once — applies to ALL 50 prompts in the company:
+ * 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()}`
+ *     );
+ * });
+ * ```
+ */
+export type PromptInterceptorFn<TContext> = (ctx: TContext, builder: InterceptorBuilder, meta: PromptMeta) => void | Promise<void>;
+/**
+ * Text content block — the most common prompt message type.
+ */
+export interface PromptTextContent {
+    readonly type: 'text';
+    readonly text: string;
+}
+/**
+ * Image content block — base64-encoded image data.
+ */
+export interface PromptImageContent {
+    readonly type: 'image';
+    readonly data: string;
+    readonly mimeType: string;
+}
+/**
+ * Audio content block — base64-encoded audio data.
+ */
+export interface PromptAudioContent {
+    readonly type: 'audio';
+    readonly data: string;
+    readonly mimeType: string;
+}
+/**
+ * Embedded resource content block — references a server-side resource.
+ */
+export interface PromptResourceContent {
+    readonly type: 'resource';
+    readonly resource: {
+        readonly uri: string;
+        readonly mimeType?: string;
+        readonly text?: string;
+        readonly blob?: string;
+    };
+}
+/**
+ * Union of all MCP-compliant content types for prompt messages.
+ *
+ * Matches `ContentBlock` from the MCP spec:
+ * `TextContent | ImageContent | AudioContent | ResourceLink | EmbeddedResource`
+ */
+export type PromptContentBlock = PromptTextContent | PromptImageContent | PromptAudioContent | PromptResourceContent;
+/**
+ * A single message within a hydrated prompt result.
+ *
+ * Fully MCP-compliant: supports text, image, audio, and
+ * embedded resource content types.
+ *
+ * @see https://modelcontextprotocol.io/docs/concepts/prompts#promptmessage
+ */
+export interface PromptMessagePayload {
+    readonly role: 'user' | 'assistant';
+    readonly content: PromptContentBlock;
+}
+/**
+ * The result of hydrating a prompt via `prompts/get`.
+ *
+ * Mirrors the MCP SDK `GetPromptResult` shape.
+ */
+export interface PromptResult {
+    readonly description?: string;
+    readonly messages: readonly PromptMessagePayload[];
+}
+/**
+ * Prompt-safe param descriptors: only flat primitives allowed.
+ *
+ * **Why?** MCP clients (Claude Desktop, Cursor) render prompt arguments
+ * as native visual forms. Nested objects and arrays cannot be rendered
+ * by any current MCP client — allowing them produces invisible or
+ * broken form fields.
+ *
+ * Allowed: `'string'`, `'number'`, `'boolean'`, `StringParamDef`,
+ * `NumberParamDef`, `BooleanParamDef`, `EnumParamDef`.
+ *
+ * ❌ `ArrayParamDef` — cannot be rendered as a form field.
+ * ❌ Nested `ZodObject` — cannot be rendered as a form field.
+ *
+ * @see {@link PromptParamsMap} for the full prompt args type
+ */
+export type PromptParamDef = 'string' | 'number' | 'boolean' | StringParamDef | NumberParamDef | BooleanParamDef | EnumParamDef<string>;
+/**
+ * Map of prompt argument names to their flat-only definitions.
+ *
+ * @example
+ * ```typescript
+ * const args: PromptParamsMap = {
+ *     month: { enum: ['january', 'february'] },
+ *     limit: { type: 'number', min: 1, max: 100 },
+ *     verbose: 'boolean',
+ * };
+ * ```
+ */
+export type PromptParamsMap = Record<string, PromptParamDef>;
+/**
+ * Infer the TypeScript type from a single `PromptParamDef`.
+ *
+ * Maps JSON descriptor shorthand to its corresponding TS type:
+ * - `'string'` → `string`
+ * - `'number'` → `number`
+ * - `'boolean'` → `boolean`
+ * - `StringParamDef` → `string`
+ * - `NumberParamDef` → `number`
+ * - `BooleanParamDef` → `boolean`
+ * - `EnumParamDef<T>` → `T` (union of literal strings)
+ */
+type InferPromptParamType<T extends PromptParamDef> = T extends 'string' ? string : T extends 'number' ? number : T extends 'boolean' ? boolean : T extends StringParamDef ? string : T extends NumberParamDef ? number : T extends BooleanParamDef ? boolean : T extends EnumParamDef<infer E> ? E : unknown;
+/**
+ * Infer the full typed args object from a `PromptParamsMap`.
+ *
+ * Gives developers full autocomplete and type safety on handler args
+ * when using the JSON-first descriptor approach — zero Zod imports needed.
+ *
+ * @example
+ * ```typescript
+ * const args = {
+ *     name: { type: 'string', required: true },
+ *     age:  { type: 'number' },
+ * } as const;
+ *
+ * // InferPromptArgs<typeof args> = { name: string; age: number }
+ * ```
+ */
+export type InferPromptArgs<T extends Record<string, PromptParamDef>> = {
+    [K in keyof T]: InferPromptParamType<T[K]>;
+};
+/**
+ * Interface that all prompt builders must implement.
+ *
+ * This is the abstraction that {@link PromptRegistry} depends on,
+ * following the Dependency Inversion Principle.
+ *
+ * @typeParam TContext - Application context passed to every handler
+ */
+export interface PromptBuilder<TContext = void> {
+    /** Get the prompt name (used as the registration key) */
+    getName(): string;
+    /** Get the prompt description */
+    getDescription(): string | undefined;
+    /** Get the capability tags for selective exposure */
+    getTags(): string[];
+    /** Whether this prompt has middleware */
+    hasMiddleware(): boolean;
+    /**
+     * Build and return the MCP Prompt definition (for `prompts/list`).
+     *
+     * Returns the prompt metadata including name, description,
+     * and argument definitions.
+     */
+    buildPromptDefinition(): {
+        name: string;
+        description?: string;
+        arguments?: Array<{
+            name: string;
+            description?: string;
+            required?: boolean;
+        }>;
+    };
+    /**
+     * Execute the prompt hydration with the given context and arguments.
+     *
+     * Performs: coercion → validation → middleware → handler.
+     *
+     * @param ctx - Application context (from contextFactory)
+     * @param args - Raw string arguments from the MCP client
+     * @returns The hydrated prompt result with messages
+     */
+    execute(ctx: TContext, args: Record<string, string>): Promise<PromptResult>;
+    /**
+     * Get the configured hydration timeout (in milliseconds).
+     *
+     * When set, the handler is wrapped in a strict deadline.
+     * If the handler doesn't complete within this time, a
+     * SYSTEM ALERT is returned instead of freezing the UI.
+     *
+     * @returns Timeout in ms, or `undefined` if no deadline is configured
+     */
+    getHydrationTimeout(): number | undefined;
+}
+/**
+ * Configuration for `definePrompt()`.
+ *
+ * @typeParam TContext - Application context type
+ * @typeParam TArgs - Validated args type (inferred from `args`)
+ */
+export interface PromptConfig<TContext, TArgs extends Record<string, unknown> = Record<string, unknown>> {
+    /** Human-readable title for display in UI (MCP spec `BaseMetadata.title`) */
+    title?: string;
+    /** Human-readable description shown in the slash command palette */
+    description?: string;
+    /** Icons for light/dark themes (MCP spec `Icons`) */
+    icons?: {
+        light?: string;
+        dark?: string;
+    };
+    /**
+     * Argument definitions.
+     *
+     * Accepts either:
+     * - `PromptParamsMap` (JSON descriptors) — zero Zod imports needed
+     * - `ZodObject` — for power users who need full Zod control
+     *
+     * **Constraint:** Only flat primitives allowed. Arrays and nested
+     * objects will fail with a runtime error at definition time.
+     */
+    args?: PromptParamsMap | ZodObject<ZodRawShape>;
+    /** Capability tags for selective exposure */
+    tags?: string[];
+    /** Middleware chain (same signature as tool middleware) */
+    middleware?: MiddlewareFn<TContext>[];
+    /**
+     * Maximum hydration time in milliseconds.
+     *
+     * When set, the handler is wrapped in a strict deadline. If external
+     * data sources (APIs, databases) don't respond within this time,
+     * the framework cuts the Promise and returns a graceful SYSTEM ALERT.
+     * The UI unblocks immediately — the user never sees a frozen screen.
+     *
+     * @example
+     * ```typescript
+     * definePrompt('morning_briefing', {
+     *     hydrationTimeout: 3000, // 3 seconds strict
+     *     handler: async (ctx, args) => {
+     *         // If Jira takes 15s, the framework cuts at 3s
+     *         const tickets = await ctx.invokeTool('jira.get_assigned');
+     *         return { messages: [...] };
+     *     },
+     * });
+     * ```
+     */
+    hydrationTimeout?: number;
+    /**
+     * The hydration handler.
+     *
+     * Receives validated, typed, coerced args and returns a `PromptResult`.
+     * This is where server-side data fetching and Presenter calls happen.
+     *
+     * **DX**: `ctx` is typed as `TContext & LoopbackContext` — `invokeTool()`
+     * appears in autocomplete without any manual cast.
+     */
+    handler: (ctx: TContext & LoopbackContext, args: TArgs) => Promise<PromptResult>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/prompt/types.js

@@ -0,0 +1,19 @@
+/**
+ * Prompt Engine — Types & Contracts
+ *
+ * Type-only module defining the core contracts for the Prompt Engine.
+ * Follows the same "zero runtime code" pattern as `core/types.ts`.
+ *
+ * Key design decisions:
+ * - `PromptParamDef` restricts to flat primitives only (no arrays, no nested objects)
+ *   because MCP clients render prompt arguments as visual forms.
+ * - `PromptResult` mirrors MCP SDK's `GetPromptResult` shape.
+ * - `PromptBuilder` is the DIP interface that `PromptRegistry` depends on.
+ *
+ * @module
+ */
+import {} from 'zod';
+import {} from '../core/types.js';
+import {} from '../core/builder/ParamDescriptors.js';
+import {} from '../core/response.js';
+//# sourceMappingURL=types.js.map

package/dist/prompt/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/prompt/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAoC,MAAM,KAAK,CAAC;AACvD,OAAO,EAAqB,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAKN,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAqB,MAAM,qBAAqB,CAAC"}