@mosvera/mcp 0.1.6 → 0.1.8

package/README.md

@@ -24,8 +24,8 @@ It begins with Claude Desktop, then shows the npm/MCP path and runtime paths.
 
 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.8.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.
@@ -195,7 +195,7 @@ npm run mcpb:inspect
 The MCPB pack step creates:
 
 ```text
-build/mosvera/mosvera-mcp-0.1.6.mcpb
+build/mosvera/mosvera-mcp-0.1.8.mcpb
 ```
 
 ## Package Boundaries

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.6";
+export declare const SERVER_VERSION = "0.1.8";
 export interface CliOptions {
     registryDir?: string;
     readOnlyMode: boolean;

package/dist/context.js

@@ -20,7 +20,7 @@ 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.6";
+export const SERVER_VERSION = "0.1.8";
 function flagValue(argv, name) {
     const direct = argv.find((arg) => arg.startsWith(`${name}=`));
     if (direct !== undefined)

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,
@@ -349,7 +500,13 @@ export function runCompileProviderPayload(ctx, args) {
         if (args.provider_options !== undefined)
             emitOptions.providerOptions = args.provider_options;
         const emission = adapter.emit(resolved.canonical, emitOptions);
-        return ok(`Compiled deterministic provider payload for "${args.provider}".`, {
+        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,
@@ -373,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);
@@ -396,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));
@@ -417,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));
@@ -494,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/mcpb/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "mosvera-mcp",
   "display_name": "Mosvera",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "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.6",
+  "version": "0.1.8",
   "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.6.mcpb",
-    "mcpb:inspect": "node scripts/inspect-mcpb.mjs build/mosvera/mosvera-mcp-0.1.6.mcpb",
+    "mcpb:pack": "npm run mcpb:stage && mcpb pack build/mcpb/mosvera build/mosvera/mosvera-mcp-0.1.8.mcpb",
+    "mcpb:inspect": "node scripts/inspect-mcpb.mjs build/mosvera/mosvera-mcp-0.1.8.mcpb",
     "prepublishOnly": "npm run build && npm run typecheck && npm test",
     "start": "tsx src/server.ts",
     "test": "vitest run",
@@ -65,7 +65,7 @@
     "zod": "^3.24.1"
   },
   "optionalDependencies": {
-    "@mosvera/provider-elevenlabs": "^0.1.2",
+    "@mosvera/provider-elevenlabs": "^0.1.3",
     "@mosvera/provider-firefly": "^0.1.2",
     "@mosvera/provider-google": "^0.1.2",
     "@mosvera/provider-heygen": "^0.1.1",