@kolbo/mcp 1.106.4 → 1.107.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolbo/mcp",
-  "version": "1.106.4",
+  "version": "1.107.1",
   "description": "Kolbo AI MCP Server - Generate images, videos, music, speech, and sound effects from Claude Code",
   "main": "src/index.js",
   "bin": {

package/src/apps/html.js

@@ -17,7 +17,7 @@ function widgetPage({ title, body, script }) {
 <title>${title}</title>
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet" media="print" onload="this.media='all'">
+<link href="https://fonts.googleapis.com/css2?family=Poppins:wght@400;500;600;700&display=swap" rel="stylesheet" media="print" onload="this.media='all'">
 <style>${KOLBO_CSS}</style>
 </head>
 <body>

package/src/apps/index.js

@@ -779,6 +779,7 @@ const TOOL_WIDGETS = {
   list_voices: UI.mediaGrid,
   list_visual_dnas: UI.mediaGrid,
   list_moodboards: UI.mediaGrid,
+  list_morphious_styles: UI.mediaGrid,
   // NOTE: list_color_palettes' handler has always called uiResult(UI.mediaGrid, ...)
   // (see color_palettes.js) but was missing here — hosts that prepare the widget
   // iframe from the tool DECLARATION (claude.ai reads tools/list, not the result)

package/src/apps/theme.js

@@ -34,7 +34,13 @@ const KOLBO_CSS = `
   --spring: cubic-bezier(0.34, 1.56, 0.64, 1);
   --smooth: cubic-bezier(0.25, 0.46, 0.45, 0.94);
   --specular: inset 0 1px 0 rgba(255, 255, 255, 0.18);
-  color-scheme: dark;
+  /* "light dark" on the ROOT, never a fixed scheme. When an iframe's root
+     scheme differs from the host frame's, the browser paints an OPAQUE canvas
+     behind the page: a fixed "dark" here drew a dark square around every card
+     in hosts whose frame is light/normal (Codex). "light dark" adopts the host
+     frame's scheme, so the canvas stays transparent everywhere. The card
+     carries the real theme for its native controls below. */
+  color-scheme: light dark;
 }
 [data-theme="light"] {
   --bg: #f5f5f2;
@@ -50,12 +56,13 @@ const KOLBO_CSS = `
   --text-faint: rgba(10, 10, 12, 0.40);
   --brand-soft: rgba(59, 130, 246, 0.10);
   --specular: inset 0 1px 0 rgba(255, 255, 255, 0.65);
-  color-scheme: light;
 }
 * { box-sizing: border-box; margin: 0; padding: 0; }
 html, body { background: transparent; }
+.k-card { color-scheme: dark; }
+[data-theme="light"] .k-card { color-scheme: light; }
 body {
-  font-family: 'Inter', ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Arial, sans-serif;
+  font-family: 'Poppins', ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Arial, sans-serif;
   color: var(--text);
   font-size: 14px;
   line-height: 1.5;
@@ -114,7 +121,6 @@ body {
 .k-mention {
   display: inline; padding: 1px 5px; border-radius: 5px;
   background: var(--brand-soft); color: var(--brand);
-  font-family: 'JetBrains Mono', ui-monospace, monospace;
   font-size: 0.94em; font-weight: 500;
 }
 /* Single-line media caption (scene / batch prompt under the viewer) */
@@ -143,7 +149,7 @@ body {
 .k-chip .k-mono-icon {
   width: 14px; height: 14px; border-radius: 4px; background: var(--brand);
   color: #fff; font-size: 9px; font-weight: 700; display: inline-flex;
-  align-items: center; justify-content: center; font-family: 'Inter', sans-serif;
+  align-items: center; justify-content: center; font-family: inherit;
 }
 .k-chip img.k-voice-thumb { width: 18px; height: 18px; border-radius: 999px; margin-left: -3px; }
 .k-ref-thumb { width: 26px; height: 26px; border-radius: 6px; object-fit: cover; border: 1px solid var(--border-strong); }
@@ -161,7 +167,7 @@ html.k-peek-open .k-card { min-height: 460px; }
 .k-peek-bar { flex: none; display: flex; align-items: center; gap: 8px; padding: 8px 8px 8px 14px; min-height: 44px; }
 .k-peek-cap { flex: 1; min-width: 0; font-size: 12.5px; color: rgba(255,255,255,0.78);
   white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
-.k-peek-count { flex: none; font-size: 11.5px; color: rgba(255,255,255,0.55); font-family: 'JetBrains Mono', ui-monospace, monospace; }
+.k-peek-count { flex: none; font-size: 11.5px; color: rgba(255,255,255,0.55); font-variant-numeric: tabular-nums; }
 .k-peek-btn {
   flex: none; width: 32px; height: 32px; border: 1px solid rgba(255,255,255,0.14); border-radius: 999px;
   background: rgba(255,255,255,0.08); color: #fff; cursor: pointer; font-size: 15px;
@@ -303,7 +309,7 @@ video::-webkit-media-controls-fullscreen-button { display: none !important; }
     animating k-sweep skeleton forced per-frame backdrop re-sampling on phones;
     0.65 black over the shimmer reads identically without it */
   border: 1px solid rgba(255, 255, 255, 0.14);
-  font-size: 11px; font-weight: 600; color: #fff;
+  font-size: 11px; font-weight: 600; color: #fff; text-transform: capitalize;
 }
 .k-spin {
   width: 12px; height: 12px; border-radius: 50%;
@@ -463,7 +469,7 @@ video::-webkit-media-controls-fullscreen-button { display: none !important; }
 .k-dot.on { width: 22px; opacity: 0.95; cursor: default; }
 .k-dot.ghost { cursor: default; opacity: 0.14; }
 .k-pager-label { font-size: 11px; color: var(--text-faint);
-  font-family: 'JetBrains Mono', ui-monospace, monospace; min-width: 58px; text-align: center; }
+  font-variant-numeric: tabular-nums; min-width: 58px; text-align: center; }
 
 /* ---- Audio rows ---- */
 .k-audio-row { display: flex; align-items: center; gap: 10px; padding: 9px 10px;
@@ -533,7 +539,7 @@ video::-webkit-media-controls-fullscreen-button { display: none !important; }
 .k-footer:not(:has(.k-credits:not(:empty))) { display: none; }
 .k-footer a { color: var(--text-faint); text-decoration: none; }
 .k-footer a:hover { color: var(--brand); }
-.k-credits { margin-left: auto; font-family: 'JetBrains Mono', monospace; }
+.k-credits { margin-left: auto; font-variant-numeric: tabular-nums; }
 `;
 
 /**

package/src/apps/widgets/generation.js

@@ -453,11 +453,17 @@ function moodboardChipsHTML(sc, s) {
   }
   return h;
 }
-function chip(inner) { return '<span class="k-chip">' + inner + '</span>'; }
+// Labels read as words: "Image", "Enhanced", "Web search" — the first letter
+// of the visible text (after any leading icon markup) is uppercased. Digits
+// first ("1080p", "16:9", "7 images") are left alone.
+function capLabel(inner) {
+  return String(inner).replace(/(^|>)(\\s*)([a-z])/, function (m, gt, sp, ch) { return gt + sp + ch.toUpperCase(); });
+}
+function chip(inner) { return '<span class="k-chip">' + capLabel(inner) + '</span>'; }
 // Same chip with a hover title — used to surface the asset id behind a
 // "2 Visual DNA" / "preset" label without spending chip width on it.
 function chipT(inner, title) {
-  return '<span class="k-chip" title="' + esc(title) + '">' + inner + '</span>';
+  return '<span class="k-chip" title="' + esc(title) + '">' + capLabel(inner) + '</span>';
 }
 function iconFor(kind) {
   switch (kind) {

package/src/index.js

@@ -70,6 +70,7 @@ const { registerFontTools } = require('./tools/fonts');
 const { registerEditorTools } = require('./tools/editor');
 const { registerFlowTools } = require('./tools/flow');
 const { registerTrendTools } = require('./tools/trends');
+const { registerMorphiousStyleTools } = require('./tools/morphious_styles');
 const { registerMediaTools } = require('./tools/media');
 const { registerPresetTools } = require('./tools/presets');
 const { registerArtifactTools } = require('./tools/artifacts');
@@ -196,6 +197,7 @@ function createServer(opts = {}) {
   registerEditorTools(server, client);
   registerFlowTools(server, client);
   registerTrendTools(server, client);
+  registerMorphiousStyleTools(server, client);
   registerAnalyzeTools(server, client, toolOptions);
   registerMediaTools(server, client, toolOptions);
   registerPresetTools(server, client, toolOptions);

package/src/toolAnnotations.js

@@ -11,6 +11,7 @@
 const READ_ONLY = [
   'get_flow_schema', 'list_flow_sessions', 'get_flow_session', 'validate_flow_session',
   'estimate_flow_run', 'get_flow_run', 'list_flow_runs',
+  'list_morphious_styles',
   'list_trends', 'get_trend', 'estimate_trend_run', 'get_trend_run', 'list_trend_runs',
   'get_download_status',
   'get_video_editor_schema', 'list_video_editor_sessions', 'get_video_editor_session',
@@ -59,7 +60,7 @@ const PRIVATE_WRITE = [
   'import_elevenlabs_voice',
   'create_visual_dna', 'create_visual_dna_folder', 'update_visual_dna_folder',
   'move_visual_dna_to_folder',
-  'create_moodboard',
+  'create_moodboard', 'create_morphious_style',
   'create_color_palette', 'activate_color_palette', 'deactivate_color_palette',
   'move_session', 'bulk_move_sessions', 'move_generations_to_session',
   'split_session', 'undo_session_organization',
@@ -102,7 +103,7 @@ const DESTRUCTIVE_WRITE = [
 
   // Deletes and whole-value replacement updates are conservatively destructive.
   'delete_voice', 'update_visual_dna', 'delete_visual_dna', 'delete_visual_dna_folder',
-  'update_moodboard', 'delete_moodboard',
+  'update_moodboard', 'delete_moodboard', 'delete_morphious_style',
   'update_color_palette', 'delete_color_palette',
   'delete_media_folder', 'delete_media', 'permanently_delete_media',
   'bulk_delete_media', 'bulk_permanently_delete_media',

package/src/tools/generate.js

@@ -240,7 +240,8 @@ const MORPHIOUS_GUIDE = ' MORPHIOUS / GENJUTSU (exactly ONE source video, omit d
   + 'kolbo-morphious-motion 1-30 images, 4-30s; kolbo-morphious-swap 0-30 images, 4-30s; both 480p/720p/1080p, output keeps the source shape. '
   + 'Lite (kolbo-morphious-lite-motion 1-10 images / kolbo-morphious-lite-swap 0-10 images) caps at 15s. '
   + 'kolbo-morphious-reframe: NO images/DNA, 1-300s, aspect_ratio REQUIRED (16:9, 9:16, 1:1, 4:3, 3:4, 21:9), 540p or 720p. '
-  + 'higgsfield-genjutsu-motion-transfer / -object-swap: 1-8 images or Visual DNA, 4-30s, 480p/720p/1080p.';
+  + 'higgsfield-genjutsu-motion-transfer / -object-swap: 1-8 images or Visual DNA, 4-30s, 480p/720p/1080p. '
+  + 'STYLES: to restyle a whole video into an animated look (2D toon, painterly 3D, gouache, comic, clay, felt...), pick an id from list_morphious_styles and pass it as style_id with model kolbo-morphious-motion; no reference image or prompt is needed.';
 
 function registerGenerateTools(server, client, options = {}) {
   // Every JSON POST from these tools rehosts local file paths into the media
@@ -1579,6 +1580,7 @@ function registerGenerateTools(server, client, options = {}) {
       preset_id: z.string().optional().describe('Preset ID from list_presets type="video" (optional)'),
       enhance_prompt: z.boolean().optional().describe('Enhance the prompt. Default: false — only pass true if the user explicitly asks to enhance/improve the prompt.'),
       visual_dna_ids: z.array(z.string()).optional().describe('Array of Visual DNA profile IDs to apply for character/style consistency across outputs. **Cap: pass at most `max_visual_dna` IDs from list_models for the chosen model.**'),
+      style_id: z.string().optional().describe('Morphious Styles only (kolbo-morphious-motion / -lite-motion): id of a look from list_morphious_styles (Kolbo catalog or a custom style the user made). Restyles the WHOLE video in that look; the style counts as reference image 1, so no reference_images are needed. Prompt optional.'),
       draft: z.boolean().optional().describe('Special Draft mode. True forces 480p Draft even if resolution says 1080p; false selects regular video. Only supported when list_models advertises draft capabilities. For Seedance 2.5 editing use model seedance-2-5-video-to-video with generate_video_from_video; the source duration and aspect ratio are preserved. Uses ordinary credits; finalize through draft_quote then draft_enhance.'),
       resolution: z.string().optional().describe('Video resolution or named tier: read supported_resolutions from list_models. For Seedance 2.5 Draft use resolution="480p-draft" on the matching public model: seedance-2-5 for creation, seedance-2-5-video-to-video for editing. Plain "480p" generates regular video, NOT Draft. Finalize an actual draft with edit_video operation="draft_quote" then "draft_enhance".'),
       sound_enabled: z.boolean().optional().describe('Enable (`true`) or disable (`false`) AI-generated synced audio on the output video. Honored by `sound_generation_type: "native"` models (Kling O3/V3, Veo 3.1, PixVerse V6). Omit to use `sound_enabled_by_default`. Enabling sound may apply `sound_credit_multiplier` to cost.'),
@@ -1592,7 +1594,7 @@ function registerGenerateTools(server, client, options = {}) {
       project_id: projectIdField,
       session_id: sessionIdField
     },
-    async ({ prompt = '', model, reference_images, reference_videos, reference_audio_urls, audio_url, files, duration, aspect_ratio, motion, preset_id, enhance_prompt = false, visual_dna_ids, resolution, draft, sound_enabled, keyframes, multi_shots, multi_shot_count, session_name, project_id, session_id }) => {
+    async ({ prompt = '', model, reference_images, reference_videos, reference_audio_urls, audio_url, files, duration, aspect_ratio, motion, preset_id, enhance_prompt = false, visual_dna_ids, style_id, resolution, draft, sound_enabled, keyframes, multi_shots, multi_shot_count, session_name, project_id, session_id }) => {
       validateVideoPrompt({ prompt, duration, aspect_ratio, multi_shots, multi_shot_count });
       if (draft === true) resolution = '480p-draft';
       else if (draft === false && resolution?.endsWith('-draft')) resolution = resolution.slice(0, -6);
@@ -1638,7 +1640,7 @@ function registerGenerateTools(server, client, options = {}) {
         reference_images: some(urlsOf('image')),
         reference_videos: some(urlsOf('video')),
         reference_audio_urls: some(urlsOf('audio')),
-        duration, aspect_ratio, motion, preset_id, enhance_prompt, visual_dna_ids,
+        duration, aspect_ratio, motion, preset_id, enhance_prompt, visual_dna_ids, style_id,
         resolution, draft, sound_enabled, keyframes, multi_shots, multi_shot_count,
         session_name, project_id, session_id
       };
@@ -1994,6 +1996,7 @@ function registerGenerateTools(server, client, options = {}) {
       duration: z.number().optional().describe('Output duration in seconds. Must be in `supported_durations` from list_models, OR within `min_output_duration`-`max_output_duration`. Default: matches source'),
       enhance_prompt: z.boolean().optional().describe('Enhance the prompt. Default: false — only pass true if the user explicitly asks to enhance/improve the prompt.'),
       visual_dna_ids: z.array(z.string()).optional().describe('Array of Visual DNA profile IDs to apply for character/style consistency. **Cap: pass at most `max_visual_dna` IDs from list_models for the chosen model; if `supports_visual_dna: false`, DNA is silently ignored.**'),
+      style_id: z.string().optional().describe('Morphious Styles only (kolbo-morphious-motion / -lite-motion): id of a look from list_morphious_styles (Kolbo catalog or a custom style the user made). Restyles the WHOLE video in that look; the style counts as reference image 1, so no reference_images are needed. Prompt optional.'),
       draft: z.boolean().optional().describe('Special Draft mode. True forces 480p Draft even if resolution says 1080p; false selects regular video. Only supported when list_models advertises draft capabilities. For Seedance 2.5 editing use model seedance-2-5-video-to-video with generate_video_from_video; the source duration and aspect ratio are preserved. Uses ordinary credits; finalize through draft_quote then draft_enhance.'),
       resolution: z.string().optional().describe('Video resolution or named tier: read supported_resolutions from list_models. For Seedance 2.5 Draft use resolution="480p-draft" on the matching public model: seedance-2-5 for creation, seedance-2-5-video-to-video for editing. Plain "480p" generates regular video, NOT Draft. Finalize an actual draft with edit_video operation="draft_quote" then "draft_enhance".'),
       reference_images: z.array(z.string()).optional().describe('Array of reference image URLs for models that support additional image inputs. **Cap: pass at most `max_images` URLs from list_models — if `max_images === 0` the model does not accept image refs.** Examples: character reference images for Kling O1/O3, style reference for Aleph/gen4_aleph, character image for WAN VACE video-edit.'),
@@ -2029,7 +2032,7 @@ function registerGenerateTools(server, client, options = {}) {
       project_id: projectIdField,
       session_id: sessionIdField
     },
-    async ({ source_video, prompt, model, aspect_ratio, duration, enhance_prompt = false, visual_dna_ids, resolution, draft, sound_enabled, reference_images, reference_videos, elements, preset, source_language, translation_language, srt_content, srt_file_url, vocabulary, customization, enhancement_model, target_fps, slowdown_factor, output_format, project_id, session_id }) => {
+    async ({ source_video, prompt, model, aspect_ratio, duration, enhance_prompt = false, visual_dna_ids, style_id, resolution, draft, sound_enabled, reference_images, reference_videos, elements, preset, source_language, translation_language, srt_content, srt_file_url, vocabulary, customization, enhancement_model, target_fps, slowdown_factor, output_format, project_id, session_id }) => {
       if (draft === true) resolution = '480p-draft';
       else if (draft === false && resolution?.endsWith('-draft')) resolution = resolution.slice(0, -6);
       model = await canonicalModelId(client, model, 'video_to_video'); // lenient id resolution ("z-image" → "z-image/turbo")
@@ -2040,7 +2043,7 @@ function registerGenerateTools(server, client, options = {}) {
       let startResponse;
       if (isUrl) {
         startResponse = await client.post('/v1/generate/video-from-video', {
-          video_url: source_video, prompt, model, aspect_ratio, duration, enhance_prompt, visual_dna_ids, resolution, draft, sound_enabled,
+          video_url: source_video, prompt, model, aspect_ratio, duration, enhance_prompt, visual_dna_ids, style_id, resolution, draft, sound_enabled,
           reference_images, reference_videos, elements, preset, source_language, translation_language,
           srt_content, srt_file_url, vocabulary, customization,
           enhancement_model, target_fps, slowdown_factor, output_format,
@@ -2063,6 +2066,7 @@ function registerGenerateTools(server, client, options = {}) {
         if (duration !== undefined) form.append('duration', String(duration));
         if (enhance_prompt !== undefined) form.append('enhance_prompt', String(enhance_prompt));
         if (visual_dna_ids) form.append('visual_dna_ids', JSON.stringify(visual_dna_ids));
+        if (style_id) form.append('style_id', style_id);
         if (resolution) form.append('resolution', resolution);
         if (draft !== undefined) form.append('draft', String(draft));
         if (sound_enabled !== undefined) form.append('sound_enabled', String(sound_enabled));

package/src/tools/morphious_styles.js

@@ -0,0 +1,59 @@
+/* ⛔ BACKWARD COMPATIBILITY: Tool names and arg names below are a PUBLIC
+ * CONTRACT. Never rename, remove, or break an existing tool/arg — old cached
+ * `npx @kolbo/mcp` installs in the wild will break silently. Add new tools or
+ * new OPTIONAL args only. Full rules: ../index.js top-of-file and CLAUDE.md. */
+
+// Morphious Styles: restyle a whole video into a look (Kolbo catalog or the user's own custom style).
+// Apply one by passing its id as `style_id` to generate_video_from_video / generate_elements with
+// model kolbo-morphious-motion. Contract: kolbo-api src/modules/morphiousStyles.
+
+const { z } = require('zod');
+const { UI, uiResult } = require('../apps');
+
+const unwrap = r => (r && r.status === true && r.data !== undefined ? r.data : r);
+const text = value => ({ content: [{ type: 'text', text: JSON.stringify(value, null, 2) }] });
+
+function registerMorphiousStyleTools(server, client) {
+  server.tool(
+    'list_morphious_styles',
+    'List Morphious Styles: looks that restyle a WHOLE video (2D toon, painterly 3D, gouache, comic, clay, felt, yarn...). Returns the Kolbo catalog first, then the user\'s own custom styles (custom: true). To apply one, pass its id as style_id to generate_video_from_video with model "kolbo-morphious-motion" and the source video; no reference image or prompt is needed.',
+    {},
+    async () => {
+      const styles = unwrap(await client.get('/v1/morphious-styles')).styles || [];
+      return uiResult(UI.mediaGrid, JSON.stringify({ styles, count: styles.length }, null, 2), {
+        widget: 'media-grid',
+        title: 'Morphious Styles',
+        items: styles.map(s => ({
+          id: s.id,
+          title: s.name,
+          subtitle: s.custom ? 'Custom' : undefined,
+          thumbnail: s.thumb || s.cover,
+          url: s.preview || s.motion || s.cover,
+          media_type: s.preview ? 'video' : 'image',
+          use_hint: 'Restyle my video in the "{TITLE}" style (style_id: {ID}).',
+        })),
+        total: styles.length,
+        has_more: false,
+      });
+    }
+  );
+
+  server.tool(
+    'create_morphious_style',
+    'Create a custom Morphious Style from 1-8 image URLs that show the look (an illustration style, a painting technique, a 3D render style). The images define the LOOK only, never the subject. Returns the style id to pass as style_id. Upload local files first with upload_media / create_upload_ticket.',
+    {
+      name: z.string().min(1).max(60).describe('Style name shown to the user, e.g. "Ink Wash".'),
+      image_urls: z.array(z.string().url()).min(1).max(8).describe('1-8 https image URLs that show the look.'),
+    },
+    async ({ name, image_urls }) => text(unwrap(await client.post('/v1/morphious-styles/custom', { name, image_urls })))
+  );
+
+  server.tool(
+    'delete_morphious_style',
+    'Delete one of the user\'s own custom Morphious Styles. Catalog styles cannot be deleted. Past generations keep their result.',
+    { style_id: z.string().min(1).max(64).describe('Custom style id from list_morphious_styles (custom: true).') },
+    async ({ style_id }) => text(unwrap(await client.delete(`/v1/morphious-styles/custom/${encodeURIComponent(style_id)}`)))
+  );
+}
+
+module.exports = { registerMorphiousStyleTools };