@kolbo/mcp 1.30.10 → 1.31.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolbo/mcp",
-  "version": "1.30.10",
+  "version": "1.31.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/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) {
@@ -141,6 +146,10 @@ const BRIDGE_JS = `
     updateModelContext: function (text) {
       return request('ui/update-model-context', { content: [{ type: 'text', text: text }] });
     },
+    // Resolves with the mode the host ACTUALLY granted ('inline'|'fullscreen'|'pip').
+    requestDisplayMode: function (mode) {
+      return request('ui/request-display-mode', { mode: mode });
+    },
     notifySize: notifySize,
     hostContext: function () { return hostContext; }
   };

package/src/apps/theme.js

@@ -161,11 +161,21 @@ body {
 
 /* 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 open it full-size. */
+   or claude.ai adds an inner scrollbar. Click the image to expand in-Claude. */
 .k-viewer { margin-bottom: 10px; }
 .k-viewer img, .k-viewer video { display: block; width: 100%; max-height: 340px; object-fit: contain;
   border-radius: 12px; background: #000; border: 1px solid var(--border); cursor: zoom-in; }
 .k-viewer video { cursor: default; }
+
+/* ---- Fullscreen (ui/request-display-mode granted) ---- */
+html.k-fullscreen, html.k-fullscreen body { height: 100%; }
+html.k-fullscreen .k-card { height: 100%; display: flex; flex-direction: column; border-radius: 0; }
+html.k-fullscreen .k-body { flex: 1; min-height: 0; display: flex; flex-direction: column; }
+html.k-fullscreen .k-viewer { flex: 1; min-height: 0; display: flex; align-items: center; justify-content: center; }
+html.k-fullscreen .k-viewer img, html.k-fullscreen .k-viewer video {
+  max-height: 100%; max-width: 100%; width: auto; margin: 0 auto; cursor: zoom-out; }
+html.k-fullscreen .k-thumbs .k-thumb { width: 64px; height: 64px; }
+.k-expand-hint { display: none; }
 .k-thumbs { display: flex; gap: 6px; margin: 10px 0 2px; }
 .k-thumbs .k-thumb { width: 48px; height: 48px; border-radius: 8px; overflow: hidden; cursor: pointer;
   border: 2px solid transparent; opacity: 0.75; transition: all 150ms var(--smooth); flex: none; }

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

@@ -173,10 +173,12 @@ function renderImages(sc, urls) {
   // 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>';
   window.__imgFail = function () { renderLinks(urls); window.kolbo.notifySize(); };
-  // Constrained viewer → click opens the original full-size.
+  // Click → expand into an in-Claude fullscreen viewer (all actions stay
+  // available); click again (or Exit) collapses back. Hosts that refuse
+  // fullscreen fall back to opening the original in a new tab.
   setTimeout(function () {
     var img = el('main-img');
-    if (img) img.onclick = function () { window.kolbo.openLink(state.urls[selected]); };
+    if (img) img.onclick = toggleFullscreen;
   }, 0);
   var thumbs = '';
   if (urls.length > 1) {
@@ -257,11 +259,44 @@ 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();
 }
 
+/* ---------- fullscreen viewer ---------- */
+var isFullscreen = false;
+function toggleFullscreen() {
+  var want = isFullscreen ? 'inline' : 'fullscreen';
+  window.kolbo.requestDisplayMode(want).then(function (res) {
+    var granted = res && res.mode;
+    if (granted === 'fullscreen') { isFullscreen = true; applyFullscreen(true); }
+    else if (granted === 'inline' || isFullscreen) { isFullscreen = false; applyFullscreen(false); }
+    else if (!isFullscreen) {
+      // Host refused fullscreen — degrade to opening the original file.
+      window.kolbo.openLink(state.urls && state.urls[selected]);
+    }
+  }).catch(function () {
+    if (!isFullscreen) window.kolbo.openLink(state.urls && state.urls[selected]);
+  });
+}
+function applyFullscreen(on) {
+  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;
+  } else {
+    c.style.display = 'none';
+    c.onclick = null;
+    c.style.cursor = '';
+  }
+  window.kolbo.notifySize();
+}
+
 function setPhaseChip(text, spinning) {
   var c = el('phase-chip');
   if (!text) { c.style.display = 'none'; return; }
@@ -333,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/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 }] };
     }
   );