@kolbo/mcp 1.82.3 → 1.82.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolbo/mcp",
-  "version": "1.82.3",
+  "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

@@ -794,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();
 }
@@ -862,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,
@@ -290,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.'
@@ -380,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.'
@@ -627,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,
@@ -634,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,
@@ -714,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,
@@ -721,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,
@@ -781,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,
@@ -788,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
@@ -899,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 } : {})
@@ -964,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));
     }