@kolbo/mcp 1.31.0 → 1.31.2

package/package.json

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

package/src/apps/bridge.js

@@ -33,7 +33,7 @@ const BRIDGE_JS = `
   var initialized = false;
   var queue = [];        // deferred host-bound sends until initialized
   var hostContext = null;
-  var readyFns = [], toolResultFns = [], themeFns = [];
+  var readyFns = [], toolResultFns = [], themeFns = [], toolInputFns = [];
 
   function post(msg) { window.parent.postMessage(msg, '*'); }
 
@@ -66,6 +66,10 @@ const BRIDGE_JS = `
     }
     if (m.method === 'ui/notifications/tool-result') {
       toolResultFns.forEach(function (f) { try { f(m.params || {}); } catch (e) {} });
+    } else if (m.method === 'ui/notifications/tool-input' || m.method === 'ui/notifications/tool-input-partial') {
+      // Fires while the tool is still RUNNING — lets widgets show a real
+      // "preparing" state instead of a blank card until the result lands.
+      toolInputFns.forEach(function (f) { try { f((m.params && m.params.arguments) || {}); } catch (e) {} });
     } else if (m.method === 'ui/notifications/host-context-changed') {
       hostContext = (m.params && m.params.hostContext) || m.params || hostContext;
       themeFns.forEach(function (f) { try { f(hostContext); } catch (e) {} });
@@ -132,6 +136,7 @@ const BRIDGE_JS = `
   window.kolbo = {
     ready: function (f) { if (initialized) f(hostContext); else readyFns.push(f); },
     onToolResult: function (f) { toolResultFns.push(f); },
+    onToolInput: function (f) { toolInputFns.push(f); },
     onThemeChange: function (f) { themeFns.push(f); },
     callTool: function (name, args) { return request('tools/call', { name: name, arguments: args || {} }); },
     sendMessage: function (text) {

package/src/apps/html.js

@@ -33,6 +33,12 @@ function esc(s) {
   });
 }
 function el(id) { return document.getElementById(id); }
+// Force-download via the api.kolbo.ai proxy (CDN files open inline otherwise —
+// browsers display images/videos instead of saving them).
+function downloadUrl(u) {
+  if (!u) return u;
+  return 'https://api.kolbo.ai/mcp/download?url=' + encodeURIComponent(u);
+}
 function fmtCredits(n) { return (n == null) ? '' : (Math.round(n * 100) / 100) + ' cr'; }
 function fmtDur(s) { if (s == null) return ''; s = Math.round(s); return s >= 60 ? Math.floor(s/60) + 'm ' + (s%60) + 's' : s + 's'; }
 function applyTheme(ctx) {

package/src/apps/widgets/catalog.js

@@ -64,7 +64,12 @@ function boot(sc) {
 
 window.kolbo.onToolResult(function (result) {
   var sc = result.structuredContent || structured(result);
-  if (sc) boot(sc);
+  if (sc && sc.groups) return boot(sc);
+  // Internal lookup (Claude checking constraints mid-task) — no catalog data
+  // was attached on purpose. Collapse instead of showing a dead card.
+  var card = document.querySelector('.k-card');
+  if (card) card.style.display = 'none';
+  window.kolbo.notifySize();
 });
 `;
 

package/src/apps/widgets/generation.js

@@ -224,7 +224,7 @@ function render3d(sc, urls) {
         '<button class="k-btn" data-url="' + esc(u) + '">Download</button></div>';
     }).join('');
   Array.prototype.forEach.call(el('stage').querySelectorAll('.k-btn[data-url]'), function (b) {
-    b.onclick = function () { window.kolbo.openLink(b.getAttribute('data-url')); };
+    b.onclick = function () { window.kolbo.openLink(downloadUrl(b.getAttribute('data-url'))); };
   });
 }
 
@@ -259,7 +259,8 @@ function renderError(msg) {
   el('stage').innerHTML = '<div class="k-error">⚠ ' + esc(msg) + '</div>';
   el('actions').innerHTML = '<button class="k-btn" id="retry-btn">↻ Try Again</button>';
   el('retry-btn').onclick = function () {
-    window.kolbo.sendMessage('Please retry that ' + (TOOL_TITLES[state.tool] || 'generation').toLowerCase() + ' — it failed with: ' + msg);
+    var what = (state && TOOL_TITLES[state.tool]) || 'generation';
+    window.kolbo.sendMessage('Please retry that ' + what.toLowerCase() + ' — it failed with: ' + msg);
   };
   window.kolbo.notifySize();
 }
@@ -324,7 +325,7 @@ function renderActions(sc) {
   a.push('<button class="k-btn ghost" id="btn-open">Open in Kolbo ↗</button>');
   el('actions').innerHTML = a.join('');
 
-  bind('btn-download', function () { window.kolbo.openLink(currentUrl()); });
+  bind('btn-download', function () { window.kolbo.openLink(downloadUrl(currentUrl())); });
   bind('btn-open', function () { window.kolbo.openLink(state.open_url || 'https://app.kolbo.ai'); });
   bind('btn-recreate', function () {
     window.kolbo.sendMessage('Recreate this with the same settings' +
@@ -367,17 +368,41 @@ function openPromptRow(placeholder, onSend) {
   window.kolbo.notifySize();
 }
 
+/* ---------- pre-result "Preparing" state ----------
+   The host mounts this iframe as soon as the tool is CALLED; the result can
+   take many seconds (model resolution, file upload, submit). Show a live
+   shell immediately instead of a blank card. */
+function bootPre(toolName, args) {
+  if (state) return; // real data already arrived
+  el('tool-title').textContent = TOOL_TITLES[toolName] || 'Generation';
+  if (args && (args.prompt || args.text)) {
+    el('prompt').textContent = args.prompt || args.text;
+    el('prompt').style.display = '';
+  }
+  setPhaseChip('Preparing', true);
+  if (!el('stage').innerHTML) {
+    el('stage').innerHTML = '<div class="k-gen-grid n1"><div class="k-skel video" style="min-height:100px;max-height:140px"></div></div>';
+  }
+  window.kolbo.notifySize();
+}
+
 /* ---------- wire host events ---------- */
 window.kolbo.onToolResult(function (result) {
   var sc = result.structuredContent || structured(result);
-  if (sc) boot(sc);
+  if (sc && (sc.phase || sc.widget)) return boot(sc);
+  // Tool errored (or returned plain text): show it instead of a dead blank card.
+  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)) {
+    renderError((txt || 'The request failed.').slice(0, 300));
+  }
 });
+window.kolbo.onToolInput(function (args) { bootPre(null, args); });
 window.kolbo.ready(function (ctx) {
-  // Some hosts deliver the initial result via hostContext.toolInfo; the
-  // tool-result notification is the primary path.
-  if (!state && ctx && ctx.toolInfo && ctx.toolInfo.result) {
-    var sc = ctx.toolInfo.result.structuredContent;
-    if (sc) boot(sc);
+  var info = ctx && ctx.toolInfo;
+  if (!state && info) {
+    if (info.result && info.result.structuredContent) return boot(info.result.structuredContent);
+    bootPre(info.tool && info.tool.name, null);
   }
 });
 `;

package/src/apps/widgets/transcript.js

@@ -72,7 +72,7 @@ function boot(sc) {
   a.push('<button class="k-btn ghost" id="btn-copy">Copy text</button>');
   el('actions').innerHTML = a.join('');
   Array.prototype.forEach.call(el('actions').querySelectorAll('[data-url]'), function (b) {
-    b.onclick = function () { window.kolbo.openLink(b.getAttribute('data-url')); };
+    b.onclick = function () { window.kolbo.openLink(downloadUrl(b.getAttribute('data-url'))); };
   });
   var copyBtn = el('btn-copy');
   if (copyBtn) copyBtn.onclick = function () {

package/src/tools/models.js

@@ -96,9 +96,13 @@ function registerModelTools(server, client, options = {}) {
     'List available AI models on Kolbo. Filter by `type` to narrow to a generation type, and pass `format: "json"` to get the raw model documents (every constraint field, useful for programmatic comparison / cap validation before submitting a generation). Default `format: "text"` returns the human-readable summary.',
     {
       type: z.string().optional().describe('Filter by DB type name: "text_to_img", "image_editing", "text_to_video", "img_to_video", "draw_to_video", "video_to_video", "elements", "firstlastgenerations", "lipsync-image", "lipsync-video", "music_gen", "text_to_speech", "text_to_sound", "stt", "text". Legacy aliases also accepted: "image", "image_edit", "video", "video_from_image", "video_from_video", "music", "speech", "sound", "chat", "lipsync" (both lipsync types), "three_d" (all 3D types), "first_last_frame", "transcription". Omit for all models.'),
-      format: z.enum(['text', 'json']).optional().describe('Output format. "text" (default) returns a human-readable summary with the most-used caps. "json" returns the raw model documents from the API — use this when you need to programmatically verify caps (max_reference_images, max_visual_dna, max_video_duration, supported_aspect_ratios, etc.) before passing an array/value that might exceed a model-specific limit. The JSON form is the source of truth; the text form is a convenience preview.')
+      format: z.enum(['text', 'json']).optional().describe('Output format. "text" (default) returns a human-readable summary with the most-used caps. "json" returns the raw model documents from the API — use this when you need to programmatically verify caps (max_reference_images, max_visual_dna, max_video_duration, supported_aspect_ratios, etc.) before passing an array/value that might exceed a model-specific limit. The JSON form is the source of truth; the text form is a convenience preview.'),
+      display_catalog: z.boolean().optional().describe('Set true ONLY when the USER explicitly asked to see/browse the available models — it renders a visual model catalog to them. Leave unset for internal lookups (verifying a model name, checking caps before a generation): those should stay invisible to the user.')
     },
-    async ({ type, format }) => {
+    async ({ type, format, display_catalog }) => {
+      // Widget only when the user asked to browse — internal validation
+      // lookups were spamming the chat with a full catalog card.
+      const showCatalog = display_catalog === true;
       const path = type ? `/v1/models?type=${encodeURIComponent(type)}` : '/v1/models';
       const result = await client.get(path);
 
@@ -108,7 +112,7 @@ function registerModelTools(server, client, options = {}) {
       // resolution multipliers, supports_* flags, prompt-length limits, etc.).
       if (format === 'json') {
         const text = JSON.stringify({ count: result.count, models: result.models }, null, 2);
-        if (ui()) return uiResult(UI.catalog, text, buildCatalogStructured(result.models, type));
+        if (ui() && showCatalog) return uiResult(UI.catalog, text, buildCatalogStructured(result.models, type));
         return { content: [{ type: 'text', text }] };
       }
 
@@ -279,7 +283,7 @@ function registerModelTools(server, client, options = {}) {
       }
 
       const text = `Available models (${result.count}):\n\n${sections.join('\n\n')}\n\nUse the "identifier" value as the "model" parameter in generate tools. For programmatic cap validation, re-call with format: "json".`;
-      if (ui()) return uiResult(UI.catalog, text, buildCatalogStructured(result.models, type));
+      if (ui() && showCatalog) return uiResult(UI.catalog, text, buildCatalogStructured(result.models, type));
       return { content: [{ type: 'text', text }] };
     }
   );