@mosvera/mcp 0.1.5 → 0.1.7

package/README.md

@@ -9,17 +9,23 @@ Context Protocol server that lets Claude Desktop, editors, and automation
 tools inspect, resolve, compile, draft, save, and delete Mosvera aesthetics in
 a local registry.
 
-The server never calls image providers, never sends provider HTTP requests,
-and does not store API keys or secrets. It turns aesthetic documents into
-canonical Mosvera models, portable design tokens, CSS variables, and
-deterministic provider payloads that other tools can consume.
+The server runs locally. It never executes provider APIs, never sends provider
+HTTP requests, and does not store API keys or secrets. It turns documents in
+your local registry into canonical Mosvera models, portable design tokens,
+CSS variables, deterministic provider payloads, and portable aesthetic packs.
+
+## 10-Minute Quickstart
+
+New users should start with the
+[`10-minute quickstart`](https://github.com/mosvera/spec/blob/main/docs/guides/10-minute-quickstart.md).
+It begins with Claude Desktop, then shows the npm/MCP path and runtime paths.
 
 ## Install In Claude Desktop
 
 The easiest path for non-command-line users is the Mosvera MCP Bundle:
 
-1. Download `mosvera-mcp-0.1.5.mcpb` from the latest
-   [GitHub release](https://github.com/mosvera/mcp/releases).
+1. Download `mosvera-mcp-0.1.7.mcpb` from the latest
+   [GitHub release](https://github.com/mosvera/mcp/releases/latest).
 2. Double-click the file, drag it into Claude Desktop, or install it from
    Claude Desktop Settings → Extensions → Advanced settings → Install
    Extension.
@@ -106,17 +112,26 @@ Export quiet-editorial as an aesthetic pack.
 Preview importing this aesthetic pack into my registry.
 ```
 
+```text
+Import the claymation-playful-builder sample pack into my registry.
+```
+
 ```text
 Save a new aesthetic called executive-editorial based on quiet-editorial-base with a more compact, board-ready voice.
 ```
 
 The saved documents are deterministic JSON in your local registry directory.
 
+Canonical sample pack:
+<https://raw.githubusercontent.com/mosvera/spec/main/examples/packs/claymation-playful-builder.mosvera.json>
+
 ## Tools
 
 Every tool returns `structuredContent` plus a short text summary. Tools are
-annotated with MCP read/write hints so clients can present normal approval
-flows.
+annotated with MCP read/write/destructive hints so clients can present normal
+approval flows. Read tools do not mutate the registry. Write tools are only
+registered when the active local registry is writable and the server is not in
+read-only mode.
 
 | Tool | Mode | Purpose |
 |------|------|---------|
@@ -130,7 +145,7 @@ flows.
 | `export_aesthetic_pack` | Read | Export a named aesthetic as a portable `.mosvera.json` pack. |
 | `resolve_aesthetic` | Read | Resolve a named or inline aesthetic into canonical Mosvera JSON. |
 | `compile_design_tokens` | Read | Compile canonical output into portable design tokens and CSS variables. |
-| `compile_provider_payload` | Read | Advanced deterministic provider payload compilation; no provider HTTP call. |
+| `compile_provider_payload` | Read | Advanced deterministic provider payload compilation; no provider HTTP call. Supports provider-specific `provider_options` such as HeyGen `avatar_id`/`script`, ElevenLabs `voice_id`, and short-video `duration` settings. |
 | `draft_aesthetic` | Read | Draft a composition document without saving it. |
 | `save_aesthetic` | Write | Create or update a named composition aesthetic. |
 | `save_registry_document` | Write | Advanced create/update for registry documents and manifests. |
@@ -158,6 +173,10 @@ templates, palettes, modifiers, composition documents, and merge strategies.
 They do not carry assets, provider manifests, credentials, remote URLs, or zip
 bundles in v1.
 
+To test import/export without authoring a pack from scratch, use the canonical
+sample pack in
+[`mosvera/spec/examples/packs`](https://github.com/mosvera/spec/tree/main/examples/packs).
+
 IDs must be safe Mosvera references: lowercase letters, numbers, `_`, and `-`,
 starting with a letter. Absolute paths, dotfiles, path traversal, unknown
 kinds, and unsafe filenames are rejected.
@@ -176,7 +195,7 @@ npm run mcpb:inspect
 The MCPB pack step creates:
 
 ```text
-build/mosvera/mosvera-mcp-0.1.5.mcpb
+build/mosvera/mosvera-mcp-0.1.7.mcpb
 ```
 
 ## Package Boundaries
@@ -187,7 +206,23 @@ runtime directly.
 Use the Python package `mosvera` when you want the peer Python runtime.
 
 Use `@mosvera/provider-*` packages when you want direct provider payload
-compilation without MCP.
+compilation without MCP. The MCP package loads optional provider adapters when
+they are installed and always keeps provider calls out of MCP. The current
+compile-only provider ids are:
+
+```text
+openai-gpt-image-1
+bfl-flux-2-pro
+sdxl-replicate
+heygen-avatar-video
+google-gemini-image
+google-veo-video
+runway-gen4-image
+runway-gen45-video
+elevenlabs-tts
+adobe-firefly-image
+meshy-text-to-3d
+```
 
 Use `@mosvera/mcp` when an agent, editor, or automation system should call
 Mosvera through MCP tools.

package/dist/context.d.ts

@@ -1,6 +1,6 @@
 import { type LoadedProject, type RegistryDiagnostic, type Validator } from "@mosvera/runtime";
 import type { ToolContext } from "./types.ts";
-export declare const SERVER_VERSION = "0.1.5";
+export declare const SERVER_VERSION = "0.1.7";
 export interface CliOptions {
     registryDir?: string;
     readOnlyMode: boolean;
@@ -13,6 +13,7 @@ export declare function parseCliOptions(argv: string[]): CliOptions;
 export declare function defaultRegistryDir(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): string;
 export declare function packagedRegistryDir(): string;
 export declare function registryDiagnostics(project: LoadedProject, validator: Validator): RegistryDiagnostic[];
+export declare function loadOptionalProviderAdapters(ctx: ToolContext): Promise<void>;
 export declare function reloadContext(ctx: ToolContext): void;
 export declare function buildContext(input?: string | BuildContextOptions): ToolContext;
 export declare function bundleRoot(): string;

package/dist/context.js

@@ -3,16 +3,24 @@
 // Server context loading: choose a user-owned registry directory, seed public
 // examples on first run, and fall back to packaged examples when local writes
 // are unavailable.
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
 import { cpSync, existsSync, mkdirSync, readdirSync, statSync, } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { composeStrategies, createValidator, deriveStrategies, validateRegistry, } from "@mosvera/runtime";
 import { loadProject, RegistryProjectError } from "@mosvera/runtime/node";
 import { fluxAdapter } from "@mosvera/provider-flux";
 import { openaiAdapter } from "@mosvera/provider-openai";
 import { sdxlAdapter } from "@mosvera/provider-sdxl";
-export const SERVER_VERSION = "0.1.5";
+export const SERVER_VERSION = "0.1.7";
 function flagValue(argv, name) {
     const direct = argv.find((arg) => arg.startsWith(`${name}=`));
     if (direct !== undefined)
@@ -110,6 +118,73 @@ function emptyProject() {
         strategies: {},
     };
 }
+function isProviderAdapter(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const adapter = value;
+    return (typeof adapter.id === "string" &&
+        typeof adapter.version === "string" &&
+        typeof adapter.manifest === "function" &&
+        typeof adapter.emit === "function" &&
+        typeof adapter.execute === "function");
+}
+function packageParts(packageName) {
+    return packageName.split("/");
+}
+function optionalPackageEntrypoint(packageName) {
+    let directory = dirname(fileURLToPath(import.meta.url));
+    const parts = packageParts(packageName);
+    while (true) {
+        const candidate = join(directory, "node_modules", ...parts, "dist", "index.js");
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(directory);
+        if (parent === directory)
+            return undefined;
+        directory = parent;
+    }
+}
+async function optionalAdapter(packageName, exportName) {
+    const entrypoint = optionalPackageEntrypoint(packageName);
+    if (entrypoint === undefined)
+        return undefined;
+    try {
+        const mod = await import(__rewriteRelativeImportExtension(pathToFileURL(entrypoint).href));
+        const adapter = mod[exportName];
+        return isProviderAdapter(adapter) ? adapter : undefined;
+    }
+    catch (e) {
+        const code = typeof e === "object" && e !== null && "code" in e ? e.code : undefined;
+        if (e instanceof Error &&
+            (code === "MODULE_NOT_FOUND" || code === "ERR_MODULE_NOT_FOUND" || code === "ERR_PACKAGE_PATH_NOT_EXPORTED")) {
+            return undefined;
+        }
+        throw e;
+    }
+}
+function providerAdapters() {
+    return {
+        [openaiAdapter.id]: openaiAdapter,
+        [fluxAdapter.id]: fluxAdapter,
+        [sdxlAdapter.id]: sdxlAdapter,
+    };
+}
+export async function loadOptionalProviderAdapters(ctx) {
+    const optional = await Promise.all([
+        optionalAdapter("@mosvera/provider-heygen", "heygenAdapter"),
+        optionalAdapter("@mosvera/provider-google", "googleGeminiImageAdapter"),
+        optionalAdapter("@mosvera/provider-google", "googleVeoVideoAdapter"),
+        optionalAdapter("@mosvera/provider-runway", "runwayGen4ImageAdapter"),
+        optionalAdapter("@mosvera/provider-runway", "runwayGen45VideoAdapter"),
+        optionalAdapter("@mosvera/provider-elevenlabs", "elevenLabsTtsAdapter"),
+        optionalAdapter("@mosvera/provider-firefly", "fireflyImageAdapter"),
+        optionalAdapter("@mosvera/provider-meshy", "meshyTextTo3DAdapter"),
+    ]);
+    ctx.adapters = {
+        ...(ctx.adapters ?? {}),
+        ...Object.fromEntries(optional.filter((adapter) => adapter !== undefined).map((adapter) => [adapter.id, adapter])),
+    };
+}
 function loadProjectOrEmpty(directory, validator) {
     if (!existsSync(directory))
         return emptyProject();
@@ -128,11 +203,7 @@ function makeContext(registryDir, project, validator, options) {
         project,
         validator,
         baseStrategies: composeStrategies(deriveStrategies(), project.strategies),
-        adapters: {
-            [openaiAdapter.id]: openaiAdapter,
-            [fluxAdapter.id]: fluxAdapter,
-            [sdxlAdapter.id]: sdxlAdapter,
-        },
+        adapters: providerAdapters(),
     };
     if (options.fallbackReason !== undefined)
         ctx.fallbackReason = options.fallbackReason;

package/dist/server.js

@@ -9,7 +9,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { realpathSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { z } from "zod";
-import { buildContext, parseCliOptions, SERVER_VERSION } from "./context.js";
+import { buildContext, loadOptionalProviderAdapters, parseCliOptions, SERVER_VERSION } from "./context.js";
 import { documentKinds, runCompileDesignTokens, runCompileProviderPayload, runDeleteRegistryDocument, runDraftAesthetic, runExportAestheticPack, runGetRegistryDocument, runImportAestheticPack, runListAesthetics, runPreviewAestheticImport, runResolveAesthetic, runSaveAesthetic, runSaveRegistryDocument, runServerStatus, runValidateAestheticPack, runValidateDocument, runValidateRegistry, runWriteMergeStrategies, } from "./tools/aesthetic.js";
 const docArg = z.union([z.string(), z.record(z.any())]);
 const packSourceArg = {
@@ -141,6 +141,7 @@ export function createServer(ctx) {
         inputSchema: {
             aesthetic: z.union([z.string(), z.record(z.any())]),
             provider: z.string(),
+            provider_options: z.record(z.any()).optional(),
             criticality: criticalityArg.optional(),
             merge_strategies: strategiesArg.optional(),
         },
@@ -210,6 +211,7 @@ export function createServer(ctx) {
 async function main() {
     const options = parseCliOptions(process.argv.slice(2));
     const ctx = buildContext(options);
+    await loadOptionalProviderAdapters(ctx);
     const server = createServer(ctx);
     await server.connect(new StdioServerTransport());
 }

package/dist/tools/aesthetic.d.ts

@@ -44,6 +44,7 @@ export declare function runCompileDesignTokens(ctx: ToolContext, args: {
 export declare function runCompileProviderPayload(ctx: ToolContext, args: {
     aesthetic: string | object;
     provider: string;
+    provider_options?: Record<string, unknown>;
     criticality?: Record<string, Criticality>;
     merge_strategies?: MergeStrategies;
 }): CallToolResult;

package/dist/tools/aesthetic.js

@@ -41,6 +41,131 @@ function stable(value) {
 function stableStringify(value) {
     return JSON.stringify(stable(value));
 }
+function stablePretty(value) {
+    return JSON.stringify(stable(value), null, 2);
+}
+function jsonPreview(label, value, limit = 3000) {
+    const pretty = stablePretty(value);
+    const suffix = pretty.length > limit ? `\n...truncated ${pretty.length - limit} character${pretty.length - limit === 1 ? "" : "s"}` : "";
+    return `${label}:\n\`\`\`json\n${pretty.slice(0, limit)}${suffix}\n\`\`\``;
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function objectValue(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+function canonicalHighlights(canonical) {
+    const lines = [];
+    const sections = Object.keys(canonical).sort();
+    lines.push(`Sections: ${sections.length > 0 ? sections.join(", ") : "none"}.`);
+    const voice = objectValue(canonical.voice);
+    const headline = stringValue(voice?.headline);
+    const body = stringValue(voice?.body);
+    if (headline !== undefined)
+        lines.push(`Voice headline: ${headline}`);
+    if (body !== undefined)
+        lines.push(`Voice body: ${body}`);
+    const palette = objectValue(canonical.palette);
+    if (palette !== undefined) {
+        const keys = ["accent", "accent_2", "background", "surface", "ink", "muted"];
+        const values = keys
+            .map((key) => [key, stringValue(palette[key])])
+            .filter((entry) => entry[1] !== undefined)
+            .map(([key, value]) => `${key} ${value}`);
+        if (values.length > 0)
+            lines.push(`Palette: ${values.join(", ")}.`);
+    }
+    const typography = objectValue(canonical.typography);
+    if (typography !== undefined) {
+        const values = ["display", "body", "mono", "scale"]
+            .map((key) => [key, stringValue(typography[key])])
+            .filter((entry) => entry[1] !== undefined)
+            .map(([key, value]) => `${key} ${value}`);
+        if (values.length > 0)
+            lines.push(`Typography: ${values.join(", ")}.`);
+    }
+    const layout = objectValue(canonical.layout);
+    if (layout !== undefined) {
+        const values = ["density", "radius", "max_width", "shadow"]
+            .map((key) => [key, stringValue(layout[key])])
+            .filter((entry) => entry[1] !== undefined)
+            .map(([key, value]) => `${key} ${value}`);
+        if (values.length > 0)
+            lines.push(`Layout: ${values.join(", ")}.`);
+    }
+    const imagery = objectValue(canonical.imagery);
+    if (imagery !== undefined) {
+        const treatment = stringValue(imagery.treatment);
+        const src = stringValue(imagery.src);
+        const alt = stringValue(imagery.alt);
+        const values = [
+            treatment !== undefined ? `treatment ${treatment}` : undefined,
+            src !== undefined ? `src ${src}` : undefined,
+            alt !== undefined ? `alt ${alt}` : undefined,
+        ].filter((value) => value !== undefined);
+        if (values.length > 0)
+            lines.push(`Imagery: ${values.join(", ")}.`);
+    }
+    const motion = objectValue(canonical.motion);
+    if (motion !== undefined) {
+        const values = ["pace", "duration"]
+            .map((key) => [key, stringValue(motion[key])])
+            .filter((entry) => entry[1] !== undefined)
+            .map(([key, value]) => `${key} ${value}`);
+        if (values.length > 0)
+            lines.push(`Motion: ${values.join(", ")}.`);
+    }
+    return lines;
+}
+function packCounts(pack) {
+    return {
+        templates: Object.keys(pack.documents.templates ?? {}).length,
+        palettes: Object.keys(pack.documents.palettes ?? {}).length,
+        modifiers: Object.keys(pack.documents.modifiers ?? {}).length,
+        compositions: Object.keys(pack.documents.compositions ?? {}).length,
+    };
+}
+function packSummary(pack) {
+    const counts = packCounts(pack);
+    return [
+        `Pack id: ${pack.id}`,
+        `Entrypoint: ${pack.entrypoint.kind}:${pack.entrypoint.id}`,
+        `Documents: ${counts.templates} templates, ${counts.palettes} palettes, ${counts.modifiers} modifiers, ${counts.compositions} compositions.`,
+    ];
+}
+function importPlanSummary(plan) {
+    const actionCounts = plan.operations.reduce((acc, op) => {
+        acc[op.action] = (acc[op.action] ?? 0) + 1;
+        return acc;
+    }, {});
+    const actions = Object.entries(actionCounts)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([action, count]) => `${count} ${action}`)
+        .join(", ");
+    const renamed = plan.operations
+        .filter((op) => op.action === "rename")
+        .map((op) => `${op.kind}:${op.original_id} -> ${op.id}`);
+    return [
+        `Pack id: ${plan.pack_id}`,
+        `Entrypoint: ${plan.entrypoint.kind}:${plan.entrypoint.id}`,
+        `Installed entrypoint: ${plan.installed_entrypoint.kind}:${plan.installed_entrypoint.id}`,
+        `Operations: ${plan.operations.length}${actions.length > 0 ? ` (${actions})` : ""}.`,
+        renamed.length > 0 ? `Renames:\n${renamed.map((line) => `- ${line}`).join("\n")}` : "Renames: none.",
+        `Diagnostics: ${plan.diagnostics.length}.`,
+    ];
+}
+function warningSummary(warnings) {
+    if (warnings === undefined || warnings.length === 0)
+        return "Warnings: none.";
+    const visible = warnings.slice(0, 12).map((warning) => {
+        const construct = typeof warning.construct === "string" ? warning.construct : "unknown";
+        const action = typeof warning.action === "string" ? warning.action : "warning";
+        return `- ${construct}: ${action}`;
+    });
+    const remaining = warnings.length - visible.length;
+    return `Warnings (${warnings.length}):\n${visible.join("\n")}${remaining > 0 ? `\n...and ${remaining} more warning${remaining === 1 ? "" : "s"}.` : ""}`;
+}
 function validatePackPath(path) {
     if (/^https?:\/\//i.test(path)) {
         return { error: "unsafe_filename", message: "Aesthetic pack imports only accept local .mosvera.json files, not URLs." };
@@ -260,7 +385,12 @@ export function runPreviewAestheticImport(ctx, args) {
     const plan = previewAestheticPackImport(source.pack, ctx.project.registry, options);
     if (!plan.valid)
         return fail("invalid_document", "Aesthetic pack import preview found blocking diagnostics.", { plan });
-    return ok("Previewed aesthetic pack import.", { source: source.source, path: source.path, plan });
+    const message = [
+        "Previewed aesthetic pack import.",
+        ...importPlanSummary(plan),
+        "No files were written.",
+    ].join("\n");
+    return ok(message, { source: source.source, path: source.path, plan });
 }
 export function runExportAestheticPack(ctx, args) {
     try {
@@ -275,7 +405,13 @@ export function runExportAestheticPack(ctx, args) {
             options.description = args.description;
         const pack = exportAestheticPack(args.aesthetic, ctx.project.registry, options);
         const suggested_filename = `${pack.id}.mosvera.json`;
-        return ok(`Exported aesthetic pack "${pack.id}".`, { pack, suggested_filename });
+        const message = [
+            `Exported aesthetic pack "${pack.id}".`,
+            `Suggested filename: ${suggested_filename}`,
+            ...packSummary(pack),
+            jsonPreview("Pack JSON", pack, 8000),
+        ].join("\n");
+        return ok(message, { pack, suggested_filename });
     }
     catch (e) {
         return toolFail(runtimeError(e));
@@ -289,7 +425,12 @@ export function runResolveAesthetic(ctx, args) {
     if (maybeFail(resolved))
         return toolFail(resolved);
     const id = typeof args.aesthetic === "string" ? args.aesthetic : "inline";
-    return ok(`Resolved aesthetic "${id}".`, { canonical: resolved.canonical });
+    const message = [
+        `Resolved aesthetic "${id}".`,
+        ...canonicalHighlights(resolved.canonical),
+        jsonPreview("Canonical model", resolved.canonical, 5000),
+    ].join("\n");
+    return ok(message, { canonical: resolved.canonical });
 }
 export function runCompileDesignTokens(ctx, args) {
     const resolved = resolveInput(ctx, args);
@@ -329,7 +470,12 @@ export function runCompileProviderPayload(ctx, args) {
     }
     const compiled = compile(resolved.canonical, manifest, args.criticality ?? {});
     if (compiled.status === "error") {
-        return ok(`Provider "${args.provider}" cannot satisfy required construct "${compiled.construct}".`, {
+        const message = [
+            `Provider "${args.provider}" cannot satisfy required construct "${compiled.construct}".`,
+            `Error: ${compiled.error}`,
+            jsonPreview("Canonical model", resolved.canonical, 2500),
+        ].join("\n");
+        return ok(message, {
             status: "error",
             error: compiled.error,
             construct: compiled.construct,
@@ -337,7 +483,12 @@ export function runCompileProviderPayload(ctx, args) {
         });
     }
     if (adapter === undefined) {
-        return ok(`Compiled provider contract for "${args.provider}".`, {
+        const message = [
+            `Compiled provider contract for "${args.provider}".`,
+            "No provider adapter is installed, so no payload was emitted.",
+            warningSummary(compiled.warnings),
+        ].join("\n");
+        return ok(message, {
             status: "compiled",
             provider: args.provider,
             warnings: compiled.warnings,
@@ -345,8 +496,17 @@ export function runCompileProviderPayload(ctx, args) {
         });
     }
     try {
-        const emission = adapter.emit(resolved.canonical, { criticality: args.criticality ?? {} });
-        return ok(`Compiled deterministic provider payload for "${args.provider}".`, {
+        const emitOptions = { criticality: args.criticality ?? {} };
+        if (args.provider_options !== undefined)
+            emitOptions.providerOptions = args.provider_options;
+        const emission = adapter.emit(resolved.canonical, emitOptions);
+        const message = [
+            `Compiled deterministic provider payload for "${args.provider}".`,
+            emission.prompt.length > 0 ? `Prompt: ${emission.prompt}` : "Prompt: none.",
+            warningSummary(emission.warnings),
+            jsonPreview("Payload JSON", emission.payload, 5000),
+        ].join("\n");
+        return ok(message, {
             status: "compiled",
             provider: args.provider,
             warnings: emission.warnings,
@@ -370,7 +530,12 @@ export function runDraftAesthetic(_ctx, args) {
         if (overrides !== undefined)
             options.overrides = overrides;
         const document = createComposition(args.id, args.base, options);
-        return ok(`Drafted aesthetic "${args.id}".`, { kind: "composition", id: args.id, document });
+        const message = [
+            `Drafted aesthetic "${args.id}".`,
+            "This draft was not saved to the local registry. Use save_aesthetic to persist it.",
+            jsonPreview("Composition document", document, 4000),
+        ].join("\n");
+        return ok(message, { kind: "composition", id: args.id, document });
     }
     catch (e) {
         const failure = runtimeError(e);
@@ -393,7 +558,12 @@ export function runSaveAesthetic(ctx, args) {
     try {
         saveProjectDocument(ctx.registryDir, "composition", document);
         reloadContext(ctx);
-        return ok(`Saved aesthetic "${args.id}".`, { kind: "composition", id: args.id, document });
+        const message = [
+            `Saved aesthetic "${args.id}" to the local registry.`,
+            `Registry: ${ctx.registryDir}`,
+            jsonPreview("Composition document", document, 4000),
+        ].join("\n");
+        return ok(message, { kind: "composition", id: args.id, document });
     }
     catch (e) {
         return toolFail(runtimeError(e));
@@ -414,11 +584,21 @@ export function runSaveRegistryDocument(ctx, args) {
             const manifest = document;
             saveCapabilityManifest(ctx.registryDir, manifest);
             reloadContext(ctx);
-            return ok(`Saved capability manifest "${manifest.provider}".`, { kind: args.kind, id: manifest.provider, document });
+            const message = [
+                `Saved capability manifest "${manifest.provider}".`,
+                `Registry: ${ctx.registryDir}`,
+                jsonPreview("Capability manifest", document, 4000),
+            ].join("\n");
+            return ok(message, { kind: args.kind, id: manifest.provider, document });
         }
         saveProjectDocument(ctx.registryDir, args.kind, document);
         reloadContext(ctx);
-        return ok(`Saved ${args.kind} "${String(document.id)}".`, { kind: args.kind, id: document.id, document });
+        const message = [
+            `Saved ${args.kind} "${String(document.id)}".`,
+            `Registry: ${ctx.registryDir}`,
+            jsonPreview("Registry document", document, 4000),
+        ].join("\n");
+        return ok(message, { kind: args.kind, id: document.id, document });
     }
     catch (e) {
         return toolFail(runtimeError(e));
@@ -491,7 +671,12 @@ export function runImportAestheticPack(ctx, args) {
             writeMergeStrategies(ctx.registryDir, result.strategies);
         }
         reloadContext(ctx);
-        return ok(`Imported aesthetic pack "${result.pack.id}".`, {
+        const message = [
+            `Imported aesthetic pack "${result.pack.id}".`,
+            `Registry: ${ctx.registryDir}`,
+            ...importPlanSummary(result.plan),
+        ].join("\n");
+        return ok(message, {
             source: source.source,
             path: source.path,
             plan: result.plan,

package/dist/tools/compile-generation.d.ts

@@ -7,6 +7,7 @@ export interface CompileArgs {
     manifest?: CapabilityManifest;
     criticality?: Record<string, Criticality>;
     merge_strategies?: MergeStrategies;
+    provider_options?: Record<string, unknown>;
     emit?: boolean;
 }
 export declare function runCompileGeneration(ctx: ToolContext, args: CompileArgs): CompileResultMcp;

package/dist/tools/compile-generation.js

@@ -54,7 +54,14 @@ export function runCompileGeneration(ctx, args) {
             return toolError("unknown_provider", { provider: args.provider, adapter: "missing" });
         }
         try {
-            return { status: "compiled", canonical, emission: adapter.emit(canonical, { criticality: args.criticality ?? {} }) };
+            const emitOptions = { criticality: args.criticality ?? {} };
+            if (args.provider_options !== undefined)
+                emitOptions.providerOptions = args.provider_options;
+            return {
+                status: "compiled",
+                canonical,
+                emission: adapter.emit(canonical, emitOptions),
+            };
         }
         catch (e) {
             if (e instanceof EmissionError) {

package/mcpb/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "mosvera-mcp",
   "display_name": "Mosvera",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Resolve, compile, and save local Mosvera aesthetics from Claude Desktop.",
   "long_description": "Mosvera runs locally against your own aesthetic registry. It lets Claude list named aesthetics, resolve them to canonical Mosvera models, compile portable design tokens and CSS variables, and save registry documents without sending provider requests or storing secrets.",
   "author": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mosvera/mcp",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Run Mosvera as local MCP tools for agents, editors, and Claude Desktop.",
   "license": "Apache-2.0",
   "type": "module",
@@ -41,8 +41,8 @@
     "ci": "npm run build && npm run typecheck && npm test",
     "clean": "rm -rf dist",
     "mcpb:stage": "npm run build && node scripts/stage-mcpb.mjs",
-    "mcpb:pack": "npm run mcpb:stage && mcpb pack build/mcpb/mosvera build/mosvera/mosvera-mcp-0.1.5.mcpb",
-    "mcpb:inspect": "node scripts/inspect-mcpb.mjs build/mosvera/mosvera-mcp-0.1.5.mcpb",
+    "mcpb:pack": "npm run mcpb:stage && mcpb pack build/mcpb/mosvera build/mosvera/mosvera-mcp-0.1.7.mcpb",
+    "mcpb:inspect": "node scripts/inspect-mcpb.mjs build/mosvera/mosvera-mcp-0.1.7.mcpb",
     "prepublishOnly": "npm run build && npm run typecheck && npm test",
     "start": "tsx src/server.ts",
     "test": "vitest run",
@@ -64,6 +64,14 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.24.1"
   },
+  "optionalDependencies": {
+    "@mosvera/provider-elevenlabs": "^0.1.2",
+    "@mosvera/provider-firefly": "^0.1.2",
+    "@mosvera/provider-google": "^0.1.2",
+    "@mosvera/provider-heygen": "^0.1.1",
+    "@mosvera/provider-meshy": "^0.1.2",
+    "@mosvera/provider-runway": "^0.1.2"
+  },
   "devDependencies": {
     "@anthropic-ai/mcpb": "^2.1.2",
     "typescript": "^5.7.2",