@kolbo/mcp 1.82.2 → 1.82.5

package/package.json

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

package/src/apps/widgets/generation.js

@@ -280,8 +280,12 @@ function renderChips(sc) {
   var s = sc.settings || {};
   var kind = displayKind(sc);
   if (kind) h += chip(iconFor(kind) + ' ' + kind);
-  if (s.duration) h += chip(ICONS.clock + ' ' + fmtDur(s.duration) + (s.shots > 1 ? ' · ' + s.shots + ' shots' : ''));
-  else if (s.shots > 1) h += chip(s.shots + ' shots');
+  // Shot count when we know it, otherwise just say multishot is on — the
+  // provider picks the count in that case, and showing nothing made an
+  // enabled toggle look like it had not applied.
+  var shotLabel = s.shots > 1 ? (s.shots + ' shots') : (s.multi_shot ? 'multishot' : '');
+  if (s.duration) h += chip(ICONS.clock + ' ' + fmtDur(s.duration) + (shotLabel ? ' · ' + shotLabel : ''));
+  else if (shotLabel) h += chip(shotLabel);
   if (s.resolution) h += chip(esc(s.resolution));
   if (s.aspect_ratio) h += chip(esc(s.aspect_ratio));
   if (s.quality) h += chip(esc(s.quality) + ' quality');
@@ -790,7 +794,7 @@ function fillBatchCell(sc, i, g) {
   // the user is meant to watch, and without it the tile was a muted poster with
   // no way to play, seek or unmute until the whole batch finished and repainted.
   cell.innerHTML = (sc.kind === 'video'
-    ? '<video class="k-cell-fill" src="' + esc(u) + '"' + (r.thumbnail_url ? ' poster="' + esc(r.thumbnail_url) + '"' : '') + ' controls playsinline preload="metadata"></video>'
+    ? '<video class="k-cell-fill" src="' + esc(playableAt(r, r.urls || [], 0)) + '"' + (r.thumbnail_url ? ' poster="' + esc(r.thumbnail_url) + '"' : '') + ' controls playsinline preload="metadata"></video>'
     : '<img class="k-cell-fill" src="' + esc(u) + '" alt="">') + cap;
   window.kolbo.notifySize();
 }
@@ -858,10 +862,28 @@ function renderImages(sc, urls) {
   });
 }
 
+/**
+ * The url to PLAY, which is not always the url to DOWNLOAD.
+ *
+ * Seedance 2.5 at 1080p returns HEVC Main 10 (10-bit). Chrome and Edge decode HEVC in
+ * hardware only — with no software fallback — and Firefox on Windows not at all, so the
+ * widget showed a black frame with sound. The API therefore returns playback_urls
+ * alongside urls whenever it had to build an H.264 proxy.
+ *
+ * urls stays the MASTER and is what every download button must keep using: handing
+ * someone the 8-bit proxy for a file they paid the 1080p multiplier for is a silent
+ * quality downgrade. Backend: kolbo-api/src/services/webPlaybackProxy.js
+ */
+function playableAt(src, urls, i) {
+  var proxies = (src && src.playback_urls) || [];
+  return proxies[i] || (urls || [])[i];
+}
+
 function renderVideo(sc, urls) {
   // preload="none" behind a poster: the card shows the still until the user
   // hits play, instead of pulling the video header on mount.
-  el('stage').innerHTML = '<div class="k-viewer"><video id="main-video" src="' + esc(urls[0]) + '"' +
+  // PLAY the proxy when there is one; the download button below keeps urls[0] (master).
+  el('stage').innerHTML = '<div class="k-viewer"><video id="main-video" src="' + esc(playableAt(sc, urls, 0)) + '"' +
     (sc.thumbnail_url ? ' poster="' + esc(sc.thumbnail_url) + '" preload="none"' : ' preload="metadata"') + ' controls playsinline></video>' +
     dlBtnHTML(urls[0]) + '</div>';
   wireDlButtons(el('stage'));

package/src/tools/generate.js

@@ -89,7 +89,7 @@ async function pollBatch(client, batch, { interval, timeout }, toolName) {
   const polls = await Promise.all(batch.ids.map((id) => pollOrTimedOut(client, id, { interval, timeout })));
   const generations = polls.map((p, i) => p.timedOut
     ? { prompt: batch.ok[i].prompt, generation_id: batch.ids[i], status: 'processing', note: 'Still running — call get_generation_status with wait=true to collect it.' }
-    : { prompt: batch.ok[i].prompt, generation_id: batch.ids[i], status: 'completed', ...creditFields(polls[i].result), urls: p.result.result.urls });
+    : { prompt: batch.ok[i].prompt, generation_id: batch.ids[i], status: 'completed', ...creditFields(polls[i].result), urls: p.result.result.urls, playback_urls: p.result.result.playback_urls });
   const text = JSON.stringify({
     batch: true,
     session_id: batch.ok[0].gen.session_id,
@@ -186,6 +186,9 @@ const videoSettings = (a = {}) => ({
   // echoed back on start, then to per-shot × shots.
   duration: a.duration ?? a.reported_duration ?? (a.shot_duration && a.shots ? a.shot_duration * a.shots : undefined),
   ...(a.shots > 1 ? { shots: a.shots } : {}),
+  // Multishot with no explicit count: the provider decides how many, so there
+  // is no number to show — but the card still has to say the toggle applied.
+  ...(a.multi_shot ? { multi_shot: true } : {}),
   resolution: a.resolution,
   aspect_ratio: a.aspect_ratio,
   ...(a.mode ? { mode: a.mode } : {}),
@@ -287,11 +290,13 @@ function registerGenerateTools(server, client, options = {}) {
         // input arg is only what the caller happened to name.
         reference_images: result.result.reference_images || reference_images,
         urls: result.result.urls,
+        playback_urls: result.result.playback_urls,
         credits_used: creditFields(result).credits_used,
       }, JSON.stringify({
         ...creditFields(result),
         session_id: gen.session_id,
         urls: result.result.urls,
+        playback_urls: result.result.playback_urls,
         model: result.result.model,
         prompt_used: result.result.prompt_used,
         _followup_hint: 'If the user asks to edit/change/modify this image next (scene, lighting, objects, style, color — any content edit), pass urls[0] to generate_image_edit. Use edit_image ONLY for mechanical ops (upscale/reframe/removebg/enhance_skin). Do NOT call generate_image again.'
@@ -377,11 +382,13 @@ function registerGenerateTools(server, client, options = {}) {
         reference_images: result.result.reference_images
           || [...(source_images || []), ...(reference_images || [])],
         urls: result.result.urls,
+        playback_urls: result.result.playback_urls,
         credits_used: creditFields(result).credits_used,
       }, JSON.stringify({
         ...creditFields(result),
         session_id: gen.session_id,
         urls: result.result.urls,
+        playback_urls: result.result.playback_urls,
         model: result.result.model,
         prompt_used: result.result.prompt_used,
         _followup_hint: 'If the user asks for another edit on this output, pass urls[0] back into generate_image_edit as source_images. For targeted ops (upscale/reframe/removebg/enhance_skin) use edit_image instead. Do NOT call generate_image from scratch.'
@@ -624,6 +631,7 @@ function registerGenerateTools(server, client, options = {}) {
         settings: videoSettings(shared),
         reference_images,
         urls: result.result.urls,
+        playback_urls: result.result.playback_urls,
         thumbnail_url: result.result.thumbnail_url,
         duration: result.result.duration,
         credits_used: creditFields(result).credits_used,
@@ -631,6 +639,7 @@ function registerGenerateTools(server, client, options = {}) {
         ...creditFields(result),
         session_id: gen.session_id,
         urls: result.result.urls,
+        playback_urls: result.result.playback_urls,
         model: result.result.model,
         duration: result.result.duration,
         thumbnail_url: result.result.thumbnail_url,
@@ -711,6 +720,7 @@ function registerGenerateTools(server, client, options = {}) {
         settings: videoSettings({ duration, resolution, aspect_ratio, enhance_prompt, visual_dna_ids }),
         reference_images: [image_url],
         urls: result.result.urls,
+        playback_urls: result.result.playback_urls,
         thumbnail_url: result.result.thumbnail_url,
         duration: result.result.duration,
         credits_used: creditFields(result).credits_used,
@@ -718,6 +728,7 @@ function registerGenerateTools(server, client, options = {}) {
         ...creditFields(result),
         session_id: gen.session_id,
         urls: result.result.urls,
+        playback_urls: result.result.playback_urls,
         model: result.result.model,
         duration: result.result.duration,
         thumbnail_url: result.result.thumbnail_url,
@@ -778,6 +789,7 @@ function registerGenerateTools(server, client, options = {}) {
         tool: 'generate_music', kind: 'audio', gen, client, model: model || 'Suno', prompt,
         settings: { mode: instrumental ? 'instrumental' : (style || undefined), preset_id },
         urls: result.result.urls,
+        playback_urls: result.result.playback_urls,
         title: result.result.title,
         duration: result.result.duration,
         credits_used: creditFields(result).credits_used,
@@ -785,6 +797,7 @@ function registerGenerateTools(server, client, options = {}) {
         ...creditFields(result),
         session_id: gen.session_id,
         urls: result.result.urls,
+        playback_urls: result.result.playback_urls,
         title: result.result.title,
         duration: result.result.duration,
         lyrics: result.result.lyrics
@@ -896,12 +909,14 @@ function registerGenerateTools(server, client, options = {}) {
           language,
         },
         urls: result.result.urls,
+        playback_urls: result.result.playback_urls,
         duration: result.result.duration,
         credits_used: creditFields(result).credits_used,
       }, JSON.stringify({
         ...creditFields(result),
         session_id: gen.session_id,
         urls: result.result.urls,
+        playback_urls: result.result.playback_urls,
         voice: result.result.voice,
         duration: result.result.duration,
         ...(unknownVoice ? { _warning: unknownVoice } : {})
@@ -961,12 +976,14 @@ function registerGenerateTools(server, client, options = {}) {
         settings: { duration },
         reference_images: seed_reference_image_url ? [seed_reference_image_url] : [],
         urls: result.result.urls,
+        playback_urls: result.result.playback_urls,
         duration: result.result.duration,
         credits_used: creditFields(result).credits_used,
       }, JSON.stringify({
         ...creditFields(result),
         session_id: gen.session_id,
         urls: result.result.urls,
+        playback_urls: result.result.playback_urls,
         duration: result.result.duration
       }, null, 2));
     }
@@ -1374,7 +1391,14 @@ function registerGenerateTools(server, client, options = {}) {
         settings: videoSettings({
           duration,
           reported_duration: startResponse?.duration ?? startResponse?.result?.duration,
-          shots: multi_shot_count ?? (Array.isArray(multi_shots) ? multi_shots.length : undefined),
+          // `multi_shots` is a boolean (z.boolean()); the old
+          // `Array.isArray(multi_shots) ? multi_shots.length : undefined`
+          // branch could never be true, so enabling multishot WITHOUT an
+          // explicit count left shots undefined and the card silently showed
+          // no multishot indicator at all. Carry the flag so the chip can
+          // render even when the shot count is the provider's to decide.
+          shots: multi_shot_count,
+          multi_shot: multi_shots === true || undefined,
           resolution, aspect_ratio, enhance_prompt, visual_dna_ids, preset_id,
         }),
         // Already bucketed and deduped above, so a URL handed to `files`
@@ -1396,7 +1420,14 @@ function registerGenerateTools(server, client, options = {}) {
         settings: videoSettings({
           duration,
           reported_duration: result.result?.duration,
-          shots: multi_shot_count ?? (Array.isArray(multi_shots) ? multi_shots.length : undefined),
+          // `multi_shots` is a boolean (z.boolean()); the old
+          // `Array.isArray(multi_shots) ? multi_shots.length : undefined`
+          // branch could never be true, so enabling multishot WITHOUT an
+          // explicit count left shots undefined and the card silently showed
+          // no multishot indicator at all. Carry the flag so the chip can
+          // render even when the shot count is the provider's to decide.
+          shots: multi_shot_count,
+          multi_shot: multi_shots === true || undefined,
           resolution, aspect_ratio, enhance_prompt, visual_dna_ids, preset_id,
         }),
         reference_images: [...urlsOf('image'), ...(keyframes || []).map((keyframe) => keyframe.image_url)],

package/src/tools/visual_dna.js

@@ -102,7 +102,7 @@ function registerVisualDnaTools(server, client, options = {}) {
     {
       scope: z.enum(['all', 'personal', 'global', 'organization']).optional().describe('Default: "personal" — the user\'s own DNAs (plus a shared project\'s when project_id is set). "global" = the ~1000 system cast/preset DNAs, for browsing when the user needs a character and has none of their own. "organization" = org-shared. "all" = everything, rarely wanted.'),
       search: z.string().optional().describe('Search by name, tags, or description (case-insensitive). Matches at WORD STARTS, so "man" finds "Man"/"Manager" but not "woman" or "romantic". Name matches are ranked first.'),
-      collection: z.string().optional().describe('Filter global presets by collection: cast, influencers, props, locations, styles, glamour, street'),
+      collection: z.string().optional().describe('Filter global presets by collection: cast, influencers, props, locations, styles, street'),
       tags: z.string().optional().describe('Comma-separated tags to filter by (OR logic)'),
       page: z.number().optional().describe('Page number, 1-indexed. Default: 1. Needed to reach the global cast beyond the first page.'),
       limit: z.number().optional().describe('Results per page, max 100. Default: 50'),