@kolbo/mcp 1.31.2 → 1.31.4

package/package.json

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

package/src/apps/theme.js

@@ -159,6 +159,18 @@ body {
 .k-media img, .k-media video { display: block; width: 100%; height: 100%; object-fit: cover; }
 .k-media.selected { outline: 2px solid var(--brand); outline-offset: 1px; }
 
+/* ---- Per-item hover download button (multi-image grids, CD scenes, viewer) ---- */
+.k-dl {
+  position: absolute; top: 8px; right: 8px; z-index: 3;
+  width: 30px; height: 30px; border-radius: 8px; border: 1px solid rgba(255,255,255,0.18);
+  background: rgba(0, 0, 0, 0.62); color: #fff; font-size: 14px; line-height: 1;
+  display: inline-flex; align-items: center; justify-content: center;
+  cursor: pointer; opacity: 0; transition: opacity 150ms var(--smooth), background 150ms var(--smooth);
+}
+.k-media:hover .k-dl, .k-viewer:hover .k-dl { opacity: 1; }
+.k-dl:hover { background: var(--brand); border-color: var(--brand); }
+.k-viewer { position: relative; }
+
 /* Keep the whole completed card under the host's iframe height cap (~800px):
    header + prompt + chips + viewer + thumbs + actions + footer must all fit,
    or claude.ai adds an inner scrollbar. Click the image to expand in-Claude. */

package/src/apps/widgets/generation.js

@@ -171,7 +171,7 @@ function renderImages(sc, urls) {
   selected = Math.min(selected, urls.length - 1);
   // If the host CSP still blocks the image, degrade to open-in-browser rows
   // instead of a broken empty viewer.
-  var viewer = '<div class="k-viewer"><img id="main-img" src="' + esc(urls[selected]) + '" alt="" onerror="window.__imgFail && window.__imgFail()"></div>';
+  var viewer = '<div class="k-viewer"><img id="main-img" src="' + esc(urls[selected]) + '" alt="" onerror="window.__imgFail && window.__imgFail()">' + dlBtnHTML(urls[selected]) + '</div>';
   window.__imgFail = function () { renderLinks(urls); window.kolbo.notifySize(); };
   // Click → expand into an in-Claude fullscreen viewer (all actions stay
   // available); click again (or Exit) collapses back. Hosts that refuse
@@ -187,10 +187,14 @@ function renderImages(sc, urls) {
     }).join('') + '</div>';
   }
   el('stage').innerHTML = viewer + thumbs;
+  wireDlButtons(el('stage'));
   Array.prototype.forEach.call(el('stage').querySelectorAll('.k-thumb'), function (t) {
     t.onclick = function () {
       selected = +t.getAttribute('data-i');
       el('main-img').src = state.urls[selected];
+      // Keep the viewer's hover download pointing at the newly selected image.
+      var dl = el('stage').querySelector('.k-viewer .k-dl');
+      if (dl) dl.setAttribute('data-dl', state.urls[selected]);
       Array.prototype.forEach.call(el('stage').querySelectorAll('.k-thumb'), function (x) { x.classList.remove('active'); });
       t.classList.add('active');
     };
@@ -199,7 +203,9 @@ function renderImages(sc, urls) {
 
 function renderVideo(sc, urls) {
   el('stage').innerHTML = '<div class="k-viewer"><video id="main-video" src="' + esc(urls[0]) + '"' +
-    (sc.thumbnail_url ? ' poster="' + esc(sc.thumbnail_url) + '"' : '') + ' controls playsinline></video></div>';
+    (sc.thumbnail_url ? ' poster="' + esc(sc.thumbnail_url) + '"' : '') + ' controls playsinline></video>' +
+    dlBtnHTML(urls[0]) + '</div>';
+  wireDlButtons(el('stage'));
 }
 
 function renderAudio(sc, urls) {
@@ -238,20 +244,62 @@ function renderLinks(urls) {
   });
 }
 
+// Small hover download button attached to a media cell (per-item downloads —
+// batch grids and CD scenes have no single "current" url for the action row).
+function dlBtnHTML(u) {
+  return '<button class="k-dl" data-dl="' + esc(u) + '" title="Download" aria-label="Download">⬇</button>';
+}
+function wireDlButtons(root) {
+  Array.prototype.forEach.call((root || document).querySelectorAll('.k-dl[data-dl]'), function (b) {
+    b.onclick = function (e) {
+      e.stopPropagation();
+      window.kolbo.openLink(downloadUrl(b.getAttribute('data-dl')));
+    };
+  });
+}
+
 function renderScenes(sc) {
   el('stage').innerHTML = sc.scenes.map(function (scene) {
     var media = (scene.video_urls || []).map(function (u) {
-      return '<div class="k-media"><video src="' + esc(u) + '" controls playsinline></video></div>';
+      return '<div class="k-media"><video src="' + esc(u) + '" controls playsinline></video>' + dlBtnHTML(u) + '</div>';
     }).join('') + (scene.image_urls || []).map(function (u) {
-      return '<div class="k-media"><img src="' + esc(u) + '" alt=""></div>';
+      return '<div class="k-media" data-focus="' + esc(u) + '"><img src="' + esc(u) + '" alt="">' + dlBtnHTML(u) + '</div>';
     }).join('');
     return '<div style="margin-bottom:14px"><div style="font-size:12px;font-weight:600;color:var(--text-muted);margin-bottom:8px">Scene ' +
       esc(scene.scene_number) + (scene.title ? ' — ' + esc(scene.title) : '') + '</div>' +
       '<div class="k-gen-grid n2">' + media + '</div></div>';
   }).join('');
+  wireDlButtons(el('stage'));
+  // Click a scene image → fullscreen focus on THAT image (videos keep their
+  // native controls; clicking them shouldn't hijack playback).
+  Array.prototype.forEach.call(el('stage').querySelectorAll('.k-media[data-focus]'), function (m) {
+    m.style.cursor = 'zoom-in';
+    m.onclick = function () { focusMedia(m.getAttribute('data-focus')); };
+  });
   renderActions(sc);
 }
 
+// Fullscreen a single item out of a multi-item grid (Creative Director
+// scenes). Exit restores the grid.
+function focusMedia(url) {
+  window.kolbo.requestDisplayMode('fullscreen').then(function (res) {
+    if (!(res && res.mode === 'fullscreen')) return window.kolbo.openLink(url);
+    isFullscreen = true;
+    el('stage').innerHTML = '<div class="k-viewer"><img id="focus-img" src="' + esc(url) + '" alt="" style="cursor:zoom-out">' + dlBtnHTML(url) + '</div>';
+    wireDlButtons(el('stage'));
+    el('focus-img').onclick = exitFocus;
+    applyFullscreen(true, exitFocus);
+    window.kolbo.notifySize();
+  }).catch(function () { window.kolbo.openLink(url); });
+}
+function exitFocus() {
+  window.kolbo.requestDisplayMode('inline').catch(function () {});
+  isFullscreen = false;
+  applyFullscreen(false);
+  renderScenes(state); // restore the grid
+  window.kolbo.notifySize();
+}
+
 function renderError(msg) {
   clearTimeout(pollTimer);
 
@@ -281,14 +329,14 @@ function toggleFullscreen() {
     if (!isFullscreen) window.kolbo.openLink(state.urls && state.urls[selected]);
   });
 }
-function applyFullscreen(on) {
+function applyFullscreen(on, exitHandler) {
   document.documentElement.classList.toggle('k-fullscreen', on);
   var c = el('phase-chip');
   if (on) {
     c.style.display = '';
     c.innerHTML = '✕ ' + esc('Exit');
     c.style.cursor = 'pointer';
-    c.onclick = toggleFullscreen;
+    c.onclick = exitHandler || toggleFullscreen;
   } else {
     c.style.display = 'none';
     c.onclick = null;
@@ -311,6 +359,7 @@ function currentUrl() {
 
 function renderActions(sc) {
   var a = [];
+  var hasSingleUrl = !!(sc.urls && sc.urls.length);
   if (sc.kind === 'image') {
     a.push('<button class="k-btn primary" id="btn-animate">🎬 Animate</button>');
     a.push('<button class="k-btn" id="btn-edit">✏️ Edit</button>');
@@ -318,7 +367,9 @@ function renderActions(sc) {
   if (sc.kind === 'video') {
     a.push('<button class="k-btn primary" id="btn-download">⬇ Download</button>');
     a.push('<button class="k-btn" id="btn-analyze">📊 Analyze</button>');
-  } else {
+  } else if (hasSingleUrl) {
+    // Scenes (Creative Director) have no single "current" url — per-item hover
+    // download buttons cover them instead.
     a.push('<button class="k-btn" id="btn-download">⬇ Download</button>');
   }
   a.push('<button class="k-btn" id="btn-recreate">↻ Recreate</button>');

package/src/apps/widgets/mediaGrid.js

@@ -118,7 +118,12 @@ function useItem(i) {
 
 window.kolbo.onToolResult(function (result) {
   var sc = result.structuredContent || structured(result);
-  if (sc) boot(sc);
+  if (sc && sc.items) return boot(sc);
+  // No grid data (empty result set, error, or timeout path returned plain
+  // text) — collapse instead of showing a dead "Loading…" card forever.
+  var card = document.querySelector('.k-card');
+  if (card) card.style.display = 'none';
+  window.kolbo.notifySize();
 });
 `;
 

package/src/apps/widgets/transcript.js

@@ -97,7 +97,23 @@ function poll() {
 
 window.kolbo.onToolResult(function (result) {
   var sc = result.structuredContent || structured(result);
-  if (sc) boot(sc);
+  // Only boot on a real widget contract (phase present). A text-JSON
+  // fallback like { status: 'submitted' } has no phase and would render a
+  // bogus "(empty transcript)" completed view.
+  if (sc && (sc.phase || sc.widget === 'transcript')) return boot(sc);
+  var txt = '';
+  try { txt = (result.content || []).filter(function (c) { return c.type === 'text'; }).map(function (c) { return c.text; }).join(' '); } catch (e) {}
+  if (result.isError || /error|failed/i.test(txt)) {
+    el('phase-chip').style.display = 'none';
+    el('stage').classList.remove('k-empty');
+    el('stage').innerHTML = '<div class="k-error">⚠ ' + esc((txt || 'Transcription failed').slice(0, 300)) + '</div>';
+    window.kolbo.notifySize();
+    return;
+  }
+  // No usable data — collapse instead of a dead "Loading…" card.
+  var card = document.querySelector('.k-card');
+  if (card) card.style.display = 'none';
+  window.kolbo.notifySize();
 });
 `;
 

package/src/tools/_shared.js

@@ -184,9 +184,23 @@ async function resolveToBuffer(source, kind, opts = {}) {
   }
 
   if (!path.isAbsolute(source)) {
-    throw new Error(`Local file paths must be absolute: ${source}`);
+    throw new Error(
+      `Local file paths must be absolute: ${source}. ` +
+      `If you are using Kolbo over a remote connector (e.g. claude.ai), local files are not reachable — ` +
+      `pass a public https:// URL instead (upload the file somewhere first, or use a URL from list_media).`
+    );
+  }
+  let stat;
+  try {
+    stat = fs.statSync(source);
+  } catch (err) {
+    throw new Error(
+      `Local file not found or unreadable: ${source}. ` +
+      `If you are using Kolbo over a remote connector (e.g. claude.ai), local file paths are not reachable — ` +
+      `pass a public https:// URL instead (upload the file somewhere first, or use a URL from list_media).` +
+      (err && err.code ? ` [${err.code}]` : '')
+    );
   }
-  const stat = fs.statSync(source);
   if (stat.size > maxBytes) {
     throw new Error(`File ${source} (${stat.size} bytes) exceeds ${maxBytes}-byte limit`);
   }