@vinkius-core/mcp-fusion 1.4.0 → 1.5.0

package/README.md

@@ -391,6 +391,7 @@ After `buildToolDefinition()`, the builder is permanently frozen. `Object.freeze
 | **Streaming Progress** | Generator handlers yield `progress()` events |
 | **Type-Safe Client** | `createFusionClient()` with autocomplete and typed args |
 | **State Sync** | RFC 7234 cache-control prevents temporal blindness |
+| **Prompt Engine** | `definePrompt()` — server-side hydrated templates with flat schema constraint |
 | **TOON Encoding** | Token-optimized descriptions and responses |
 | **Tag Filtering** | Context gating — control what the LLM sees per session |
 | **Observability** | Debug observers with zero-overhead typed event system |
@@ -415,6 +416,7 @@ After `buildToolDefinition()`, the builder is permanently frozen. `Object.freeze
 | 🛡️ **[Middleware](docs/middleware.md)** | Context derivation, authentication, pre-compiled chains |
 | 📈 **[Scaling](docs/scaling.md)** | Tag filtering, TOON, hierarchical groups at scale |
 | 🧠 **[State Sync](docs/state-sync.md)** | Prevent temporal blindness with cache signals |
+| 💬 **[Prompt Engine](docs/prompts.md)** | Server-side hydrated prompts with coercion and lifecycle sync |
 | 🔭 **[Observability](docs/observability.md)** | Zero-overhead debug observers with typed event system |
 | 🔀 **[Tool Exposition](docs/tool-exposition.md)** | Flat vs grouped wire strategies — per-action isolation |
 | 📖 **[API Reference](docs/api-reference.md)** | Complete typings and method reference |

package/dist/framework/index.d.ts

@@ -13,7 +13,9 @@ export { GroupedToolBuilder, ActionGroupBuilder, createTool, defineTool } from '
 export type { GroupConfigurator, ToolConfig, ActionDef, GroupDef } from './builder/index.js';
 export type { ParamDef, ParamsMap, InferParams, StringParamDef, NumberParamDef, BooleanParamDef, EnumParamDef, ArrayParamDef, } from './builder/index.js';
 export { ToolRegistry } from './registry/index.js';
+export { PromptRegistry } from './registry/index.js';
 export type { ToolFilter } from './registry/index.js';
+export type { McpPromptDef, PromptFilter } from './registry/index.js';
 export type { AttachOptions, DetachFn, ToolExposition, ExpositionConfig } from './server/index.js';
 export { generateToonDescription } from './schema/index.js';
 export { progress } from './execution/index.js';
@@ -35,4 +37,8 @@ export { Presenter, createPresenter, isPresenter } from './presenter/index.js';
 export { PresenterValidationError } from './presenter/index.js';
 export { compileManifest, cloneManifest, registerIntrospectionResource } from './introspection/index.js';
 export type { IntrospectionConfig, ManifestPayload, ManifestCapabilities, ManifestTool, ManifestAction, ManifestPresenter, IntrospectionRegistryDelegate, } from './introspection/index.js';
+export { definePrompt } from './prompt/index.js';
+export { PromptMessage } from './prompt/index.js';
+export { assertFlatSchema, coercePromptArgs } from './prompt/index.js';
+export type { PromptMessagePayload, PromptResult, PromptParamDef, PromptParamsMap, PromptBuilder, PromptConfig, } from './prompt/index.js';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/framework/index.js

@@ -11,6 +11,7 @@ export { succeed, fail } from './result.js';
 export { GroupedToolBuilder, ActionGroupBuilder, createTool, defineTool } from './builder/index.js';
 // ── Registry ─────────────────────────────────────────────
 export { ToolRegistry } from './registry/index.js';
+export { PromptRegistry } from './registry/index.js';
 // ── Schema (public strategies) ───────────────────────────
 export { generateToonDescription } from './schema/index.js';
 // ── Progress (streaming) ─────────────────────────────────
@@ -31,4 +32,8 @@ export { Presenter, createPresenter, isPresenter } from './presenter/index.js';
 export { PresenterValidationError } from './presenter/index.js';
 // ── Introspection (Dynamic Manifest) ─────────────────────
 export { compileManifest, cloneManifest, registerIntrospectionResource } from './introspection/index.js';
+// ── Prompt Engine ────────────────────────────────────────
+export { definePrompt } from './prompt/index.js';
+export { PromptMessage } from './prompt/index.js';
+export { assertFlatSchema, coercePromptArgs } from './prompt/index.js';
 //# sourceMappingURL=index.js.map

package/dist/framework/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/framework/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4DAA4D;AAC5D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEjF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAU5C,4DAA4D;AAC5D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAQpG,4DAA4D;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,4DAA4D;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,4DAA4D;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,4DAA4D;AAC5D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG5E,4DAA4D;AAC5D,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG5E,4DAA4D;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAMvE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,4DAA4D;AAC5D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAKhF,4DAA4D;AAC5D,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,4DAA4D;AAC5D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/framework/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4DAA4D;AAC5D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEjF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAU5C,4DAA4D;AAC5D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAQpG,4DAA4D;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD,4DAA4D;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,4DAA4D;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,4DAA4D;AAC5D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG5E,4DAA4D;AAC5D,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG5E,4DAA4D;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAMvE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,4DAA4D;AAC5D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAKhF,4DAA4D;AAC5D,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,4DAA4D;AAC5D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAQzG,4DAA4D;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/framework/prompt/PromptExecutionPipeline.d.ts

@@ -0,0 +1,61 @@
+/**
+ * PromptExecutionPipeline — Prompt Hydration Pipeline
+ *
+ * Handles the complete lifecycle of a `prompts/get` request:
+ *
+ *   1. Schema-Informed Coercion (string → typed values)
+ *   2. Zod Validation (.strict() + coaching errors)
+ *   3. Middleware Chain execution
+ *   4. Handler invocation
+ *
+ * Key feature: **Schema-Informed Boundary Coercion**
+ * MCP transmits ALL prompt arguments as `Record<string, string>`.
+ * This module reads the Zod schema AST to determine expected types
+ * and coerces string values deterministically — no guessing.
+ *
+ * @module
+ */
+import { type ZodObject, type ZodRawShape } from 'zod';
+import { type PromptResult } from './PromptTypes.js';
+import { type MiddlewareFn } from '../types.js';
+/**
+ * Assert that a Zod schema only contains flat primitive fields.
+ *
+ * Throws a descriptive error if any field uses arrays, objects,
+ * tuples, records, maps, or sets — types that MCP clients cannot
+ * render as visual form fields.
+ *
+ * Called at **definition time** (in `definePrompt()`) to fail fast
+ * and prevent runtime surprises.
+ *
+ * @param schema - The Zod schema to validate
+ * @throws Error with coaching message if nested types are found
+ */
+export declare function assertFlatSchema(schema: ZodObject<ZodRawShape>): void;
+/**
+ * Schema-Informed Boundary Coercion.
+ *
+ * Reads the Zod schema AST to determine expected types,
+ * then coerces string values from the MCP wire format.
+ *
+ * This is NOT guessing. The coercion is derived from the
+ * developer's declared schema — it's deterministic.
+ *
+ * @param rawArgs - Raw string arguments from the MCP client
+ * @param zodSchema - The validated Zod schema for this prompt
+ * @returns Coerced argument values ready for Zod validation
+ */
+export declare function coercePromptArgs(rawArgs: Record<string, string>, zodSchema: ZodObject<ZodRawShape>): Record<string, unknown>;
+/**
+ * Execute the full prompt hydration pipeline.
+ *
+ * Steps:
+ * 1. Coerce string args to typed values using schema AST
+ * 2. Validate with Zod (.strict() enforced)
+ * 3. Run middleware chain
+ * 4. Execute handler
+ *
+ * @returns Either a `PromptResult` or an error `PromptResult` with coaching
+ */
+export declare function executePromptPipeline<TContext>(ctx: TContext, rawArgs: Record<string, string>, schema: ZodObject<ZodRawShape> | undefined, middlewares: readonly MiddlewareFn<TContext>[], handler: (ctx: TContext, args: Record<string, unknown>) => Promise<PromptResult>): Promise<PromptResult>;
+//# sourceMappingURL=PromptExecutionPipeline.d.ts.map

package/dist/framework/prompt/PromptExecutionPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptExecutionPipeline.d.ts","sourceRoot":"","sources":["../../../src/framework/prompt/PromptExecutionPipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAmB,MAAM,KAAK,CAAC;AACxE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAoChD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI,CAYrE;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,SAAS,EAAE,SAAS,CAAC,WAAW,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BzB;AAoDD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAChD,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,SAAS,EAC1C,WAAW,EAAE,SAAS,YAAY,CAAC,QAAQ,CAAC,EAAE,EAC9C,OAAO,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,GACjF,OAAO,CAAC,YAAY,CAAC,CAgCvB"}

package/dist/framework/prompt/PromptExecutionPipeline.js

@@ -0,0 +1,191 @@
+/**
+ * PromptExecutionPipeline — Prompt Hydration Pipeline
+ *
+ * Handles the complete lifecycle of a `prompts/get` request:
+ *
+ *   1. Schema-Informed Coercion (string → typed values)
+ *   2. Zod Validation (.strict() + coaching errors)
+ *   3. Middleware Chain execution
+ *   4. Handler invocation
+ *
+ * Key feature: **Schema-Informed Boundary Coercion**
+ * MCP transmits ALL prompt arguments as `Record<string, string>`.
+ * This module reads the Zod schema AST to determine expected types
+ * and coerces string values deterministically — no guessing.
+ *
+ * @module
+ */
+import {} from 'zod';
+import {} from './PromptTypes.js';
+import {} from '../types.js';
+// ── Flat Schema Guard ────────────────────────────────────
+/** Zod type names that are NOT allowed in prompt argument schemas */
+const FORBIDDEN_ZOD_TYPES = new Set([
+    'ZodArray', 'ZodObject', 'ZodTuple', 'ZodRecord', 'ZodMap', 'ZodSet',
+]);
+/**
+ * Get the base Zod type name, unwrapping Optional/Default/Nullable wrappers.
+ * @internal
+ */
+function getZodBaseTypeName(schema) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const def = schema._def;
+    if (!def)
+        return 'Unknown';
+    const typeName = def.typeName ?? '';
+    // Unwrap Optional, Default, Nullable, Effects to find the inner type
+    if (typeName === 'ZodOptional' ||
+        typeName === 'ZodDefault' ||
+        typeName === 'ZodNullable') {
+        return getZodBaseTypeName(def.innerType);
+    }
+    if (typeName === 'ZodEffects') {
+        return getZodBaseTypeName(def.schema);
+    }
+    return typeName;
+}
+/**
+ * Assert that a Zod schema only contains flat primitive fields.
+ *
+ * Throws a descriptive error if any field uses arrays, objects,
+ * tuples, records, maps, or sets — types that MCP clients cannot
+ * render as visual form fields.
+ *
+ * Called at **definition time** (in `definePrompt()`) to fail fast
+ * and prevent runtime surprises.
+ *
+ * @param schema - The Zod schema to validate
+ * @throws Error with coaching message if nested types are found
+ */
+export function assertFlatSchema(schema) {
+    for (const [key, field] of Object.entries(schema.shape)) {
+        const typeName = getZodBaseTypeName(field);
+        if (FORBIDDEN_ZOD_TYPES.has(typeName)) {
+            throw new Error(`[definePrompt] Argument '${key}' uses type '${typeName}', which is not supported ` +
+                `in MCP prompt arguments. MCP clients render prompt args as visual forms — only ` +
+                `flat primitives (string, number, boolean, enum) are supported.\n` +
+                `💡 If you need complex data, fetch it server-side inside the handler instead.`);
+        }
+    }
+}
+// ── Schema-Informed Coercion ─────────────────────────────
+/**
+ * Schema-Informed Boundary Coercion.
+ *
+ * Reads the Zod schema AST to determine expected types,
+ * then coerces string values from the MCP wire format.
+ *
+ * This is NOT guessing. The coercion is derived from the
+ * developer's declared schema — it's deterministic.
+ *
+ * @param rawArgs - Raw string arguments from the MCP client
+ * @param zodSchema - The validated Zod schema for this prompt
+ * @returns Coerced argument values ready for Zod validation
+ */
+export function coercePromptArgs(rawArgs, zodSchema) {
+    const coerced = {};
+    const shape = zodSchema.shape;
+    for (const [key, value] of Object.entries(rawArgs)) {
+        const fieldSchema = shape[key];
+        if (!fieldSchema) {
+            // Unknown field — pass through, let Zod .strict() reject it
+            coerced[key] = value;
+            continue;
+        }
+        const typeName = getZodBaseTypeName(fieldSchema);
+        switch (typeName) {
+            case 'ZodBoolean':
+                coerced[key] = value === 'true';
+                break;
+            case 'ZodNumber':
+                coerced[key] = Number(value);
+                break;
+            case 'ZodEnum':
+            case 'ZodString':
+            default:
+                coerced[key] = value;
+                break;
+        }
+    }
+    return coerced;
+}
+// ── Validation ───────────────────────────────────────────
+/**
+ * Format a Zod validation error into a coaching prompt.
+ *
+ * Returns a human+LLM readable error that guides the agent
+ * (or the user via the MCP client) to correct the input.
+ */
+function formatPromptValidationError(issues) {
+    const lines = ['⚠️ PROMPT ARGUMENT VALIDATION FAILED:', ''];
+    for (const issue of issues) {
+        const field = issue.path.join('.') || '(root)';
+        lines.push(`  • ${field} — ${issue.message}`);
+    }
+    lines.push('', '💡 Check the prompt definition for valid argument types and values.');
+    return lines.join('\n');
+}
+// ── Middleware Compiler ──────────────────────────────────
+/**
+ * Compile middleware chain for a prompt handler.
+ *
+ * Wraps middlewares right-to-left around the handler function,
+ * producing a ready-to-execute chain. Same pattern as tool
+ * middleware compilation.
+ *
+ * @param handler - The prompt handler function
+ * @param middlewares - Middleware stack (outermost first)
+ * @returns The compiled chain function
+ */
+function compilePromptChain(handler, middlewares) {
+    let chain = handler;
+    for (let i = middlewares.length - 1; i >= 0; i--) {
+        const mw = middlewares[i];
+        if (!mw)
+            continue;
+        const nextFn = chain;
+        chain = (ctx, args) => mw(ctx, args, () => nextFn(ctx, args));
+    }
+    return chain;
+}
+// ── Pipeline ─────────────────────────────────────────────
+/**
+ * Execute the full prompt hydration pipeline.
+ *
+ * Steps:
+ * 1. Coerce string args to typed values using schema AST
+ * 2. Validate with Zod (.strict() enforced)
+ * 3. Run middleware chain
+ * 4. Execute handler
+ *
+ * @returns Either a `PromptResult` or an error `PromptResult` with coaching
+ */
+export async function executePromptPipeline(ctx, rawArgs, schema, middlewares, handler) {
+    // Step 1 + 2: Coerce and validate
+    let validatedArgs = rawArgs;
+    if (schema) {
+        const coerced = coercePromptArgs(rawArgs, schema);
+        const result = schema.strict().safeParse(coerced);
+        if (!result.success) {
+            // Return a validation error as a user message
+            return {
+                messages: [{
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: formatPromptValidationError(result.error.issues),
+                        },
+                    }],
+            };
+        }
+        validatedArgs = result.data;
+    }
+    // Step 3 + 4: Middleware chain → handler
+    if (middlewares.length > 0) {
+        const chain = compilePromptChain(handler, middlewares);
+        const result = await chain(ctx, validatedArgs);
+        return result;
+    }
+    return handler(ctx, validatedArgs);
+}
+//# sourceMappingURL=PromptExecutionPipeline.js.map

package/dist/framework/prompt/PromptExecutionPipeline.js.map

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

package/dist/framework/prompt/PromptMessage.d.ts

@@ -0,0 +1,90 @@
+/**
+ * PromptMessage — Factory Helpers for Prompt Messages
+ *
+ * Provides ergonomic factory methods for creating `PromptMessagePayload`
+ * objects used in `PromptResult.messages`.
+ *
+ * These helpers encode the MCP wire format so developers never deal
+ * with `{ role: 'user', content: { type: 'text', text: '...' } }`
+ * manually.
+ *
+ * @example
+ * ```typescript
+ * import { PromptMessage } from '@vinkius-core/mcp-fusion';
+ *
+ * return {
+ *     messages: [
+ *         PromptMessage.system('You are a Senior Auditor.'),
+ *         PromptMessage.user('Begin the audit.'),
+ *         PromptMessage.assistant('Analyzing invoices...'),
+ *     ],
+ * };
+ * ```
+ *
+ * @module
+ */
+import { type PromptMessagePayload } from './PromptTypes.js';
+/**
+ * Factory for creating MCP prompt messages.
+ *
+ * **Note on `system()`:** The MCP protocol only supports `user` and
+ * `assistant` roles in `PromptMessage`. System instructions are encoded
+ * as a `user` message (the first message) by convention — the MCP client
+ * prepends it to the conversation context.
+ */
+export declare const PromptMessage: {
+    /**
+     * Create a system instruction message.
+     *
+     * Encoded as `role: 'user'` per MCP spec (MCP does not have
+     * a `system` role in PromptMessage — system instructions are
+     * conveyed as the first `user` message by convention).
+     *
+     * @param text - System instruction text
+     */
+    readonly system: (text: string) => PromptMessagePayload;
+    /**
+     * Create a user message.
+     *
+     * @param text - User message text
+     */
+    readonly user: (text: string) => PromptMessagePayload;
+    /**
+     * Create an assistant message (for multi-turn seeding).
+     *
+     * Use this to pre-seed the assistant's initial response,
+     * guiding the LLM's first reasoning step.
+     *
+     * @param text - Assistant message text
+     */
+    readonly assistant: (text: string) => PromptMessagePayload;
+    /**
+     * Create a message with an embedded image.
+     *
+     * @param role - Message role ('user' or 'assistant')
+     * @param data - Base64-encoded image data
+     * @param mimeType - MIME type (e.g., 'image/png', 'image/jpeg')
+     */
+    readonly image: (role: "user" | "assistant", data: string, mimeType: string) => PromptMessagePayload;
+    /**
+     * Create a message with embedded audio.
+     *
+     * @param role - Message role ('user' or 'assistant')
+     * @param data - Base64-encoded audio data
+     * @param mimeType - MIME type (e.g., 'audio/wav', 'audio/mp3')
+     */
+    readonly audio: (role: "user" | "assistant", data: string, mimeType: string) => PromptMessagePayload;
+    /**
+     * Create a message with an embedded resource reference.
+     *
+     * @param role - Message role ('user' or 'assistant')
+     * @param uri - Resource URI
+     * @param options - Optional mime type, text, or blob data
+     */
+    readonly resource: (role: "user" | "assistant", uri: string, options?: {
+        mimeType?: string;
+        text?: string;
+        blob?: string;
+    }) => PromptMessagePayload;
+};
+//# sourceMappingURL=PromptMessage.d.ts.map

package/dist/framework/prompt/PromptMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptMessage.d.ts","sourceRoot":"","sources":["../../../src/framework/prompt/PromptMessage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;IACtB;;;;;;;;OAQG;4BACU,MAAM,KAAG,oBAAoB;IAI1C;;;;OAIG;0BACQ,MAAM,KAAG,oBAAoB;IAIxC;;;;;;;OAOG;+BACa,MAAM,KAAG,oBAAoB;IAI7C;;;;;;OAMG;2BACS,MAAM,GAAG,WAAW,QAAQ,MAAM,YAAY,MAAM,KAAG,oBAAoB;IAIvF;;;;;;OAMG;2BACS,MAAM,GAAG,WAAW,QAAQ,MAAM,YAAY,MAAM,KAAG,oBAAoB;IAIvF;;;;;;OAMG;8BAEO,MAAM,GAAG,WAAW,OACrB,MAAM,YACD;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAC9D,oBAAoB;CASjB,CAAC"}

package/dist/framework/prompt/PromptMessage.js

@@ -0,0 +1,104 @@
+/**
+ * PromptMessage — Factory Helpers for Prompt Messages
+ *
+ * Provides ergonomic factory methods for creating `PromptMessagePayload`
+ * objects used in `PromptResult.messages`.
+ *
+ * These helpers encode the MCP wire format so developers never deal
+ * with `{ role: 'user', content: { type: 'text', text: '...' } }`
+ * manually.
+ *
+ * @example
+ * ```typescript
+ * import { PromptMessage } from '@vinkius-core/mcp-fusion';
+ *
+ * return {
+ *     messages: [
+ *         PromptMessage.system('You are a Senior Auditor.'),
+ *         PromptMessage.user('Begin the audit.'),
+ *         PromptMessage.assistant('Analyzing invoices...'),
+ *     ],
+ * };
+ * ```
+ *
+ * @module
+ */
+import {} from './PromptTypes.js';
+/**
+ * Factory for creating MCP prompt messages.
+ *
+ * **Note on `system()`:** The MCP protocol only supports `user` and
+ * `assistant` roles in `PromptMessage`. System instructions are encoded
+ * as a `user` message (the first message) by convention — the MCP client
+ * prepends it to the conversation context.
+ */
+export const PromptMessage = {
+    /**
+     * Create a system instruction message.
+     *
+     * Encoded as `role: 'user'` per MCP spec (MCP does not have
+     * a `system` role in PromptMessage — system instructions are
+     * conveyed as the first `user` message by convention).
+     *
+     * @param text - System instruction text
+     */
+    system(text) {
+        return { role: 'user', content: { type: 'text', text } };
+    },
+    /**
+     * Create a user message.
+     *
+     * @param text - User message text
+     */
+    user(text) {
+        return { role: 'user', content: { type: 'text', text } };
+    },
+    /**
+     * Create an assistant message (for multi-turn seeding).
+     *
+     * Use this to pre-seed the assistant's initial response,
+     * guiding the LLM's first reasoning step.
+     *
+     * @param text - Assistant message text
+     */
+    assistant(text) {
+        return { role: 'assistant', content: { type: 'text', text } };
+    },
+    /**
+     * Create a message with an embedded image.
+     *
+     * @param role - Message role ('user' or 'assistant')
+     * @param data - Base64-encoded image data
+     * @param mimeType - MIME type (e.g., 'image/png', 'image/jpeg')
+     */
+    image(role, data, mimeType) {
+        return { role, content: { type: 'image', data, mimeType } };
+    },
+    /**
+     * Create a message with embedded audio.
+     *
+     * @param role - Message role ('user' or 'assistant')
+     * @param data - Base64-encoded audio data
+     * @param mimeType - MIME type (e.g., 'audio/wav', 'audio/mp3')
+     */
+    audio(role, data, mimeType) {
+        return { role, content: { type: 'audio', data, mimeType } };
+    },
+    /**
+     * Create a message with an embedded resource reference.
+     *
+     * @param role - Message role ('user' or 'assistant')
+     * @param uri - Resource URI
+     * @param options - Optional mime type, text, or blob data
+     */
+    resource(role, uri, options) {
+        return {
+            role,
+            content: {
+                type: 'resource',
+                resource: { uri, ...options },
+            },
+        };
+    },
+};
+//# sourceMappingURL=PromptMessage.js.map

package/dist/framework/prompt/PromptMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptMessage.js","sourceRoot":"","sources":["../../../src/framework/prompt/PromptMessage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAA6B,MAAM,kBAAkB,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAY;QACf,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,IAAY;QACb,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;IAC7D,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,IAAY;QAClB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;IAClE,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAA0B,EAAE,IAAY,EAAE,QAAgB;QAC5D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;IAChE,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAA0B,EAAE,IAAY,EAAE,QAAgB;QAC5D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;IAChE,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CACJ,IAA0B,EAC1B,GAAW,EACX,OAA6D;QAE7D,OAAO;YACH,IAAI;YACJ,OAAO,EAAE;gBACL,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE;aAChC;SACJ,CAAC;IACN,CAAC;CACK,CAAC"}