@kolbo/mcp 1.30.2 → 1.30.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolbo/mcp",
-  "version": "1.30.2",
+  "version": "1.30.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/index.js

@@ -123,38 +123,60 @@ function uiResult(uri, text, structured) {
 /* ------------------------------------------------------------------ */
 
 const ICON_TTL_MS = 10 * 60 * 1000;
-const iconCache = new Map(); // apiBase → { at, byKey: Map<lowername, url> }
+const infoCache = new Map(); // apiBase → { at, byKey: Map<lowername, {icon, eta}> }
 
-async function modelIconMap(client) {
+/**
+ * Resolve a Model.avatar value to an absolute URL. Avatars are bare filenames
+ * (sometimes with spaces) living in the BACKEND's public assets folder —
+ * `<api origin>/assets/<file>`. Do NOT use app.kolbo.ai for this: it's the SPA,
+ * whose catch-all returns 200 text/html for any missing file, which renders as
+ * a broken image in widgets.
+ */
+function resolveAvatarUrl(avatar, apiBase) {
+  if (!avatar) return null;
+  if (/^https?:\/\//i.test(avatar)) return avatar;
+  let origin = 'https://api.kolbo.ai';
+  try {
+    origin = new URL(apiBase || 'https://api.kolbo.ai/api').origin;
+  } catch (_) { /* keep default */ }
+  return `${origin}/assets/${encodeURIComponent(avatar)}`;
+}
+
+async function modelInfoMap(client) {
   const cacheKey = client.apiBase || 'default';
-  const hit = iconCache.get(cacheKey);
+  const hit = infoCache.get(cacheKey);
   if (hit && Date.now() - hit.at < ICON_TTL_MS) return hit.byKey;
   const byKey = new Map();
   try {
     const res = await client.request('GET', '/v1/models');
     const models = res?.models || res?.data?.models || [];
     for (const m of models) {
-      if (!m || !m.avatar) continue;
-      // The API usually resolves avatars to absolute URLs; bare filenames (older
-      // deployments / internal calls) resolve against the app's public icon dir.
-      const url = /^https?:\/\//i.test(m.avatar)
-        ? m.avatar
-        : `https://app.kolbo.ai/models_icons/${encodeURIComponent(m.avatar)}`;
-      if (m.name) byKey.set(String(m.name).toLowerCase(), url);
-      if (m.identifier) byKey.set(String(m.identifier).toLowerCase(), url);
+      if (!m) continue;
+      const icon = resolveAvatarUrl(m.avatar, client.apiBase);
+      // Real p75 wall-clock estimate mined from production creditUsages —
+      // the same source the in-app countdowns use. No estimate → no ETA shown.
+      const eta = Number(m.estimatedDurationSeconds || m.estimated_duration_seconds) || null;
+      const info = { icon, eta };
+      if (m.name) byKey.set(String(m.name).toLowerCase(), info);
+      if (m.identifier) byKey.set(String(m.identifier).toLowerCase(), info);
     }
   } catch (_) {
-    /* fail open — widgets fall back to monogram chips */
+    /* fail open — widgets fall back to monogram chips, no ETA */
   }
-  iconCache.set(cacheKey, { at: Date.now(), byKey });
+  infoCache.set(cacheKey, { at: Date.now(), byKey });
   return byKey;
 }
 
-/** Resolve one model's icon URL; null → widget renders a monogram. */
+/** Resolve one model's { icon, eta }; missing → { icon: null, eta: null }. */
+async function modelInfo(client, modelName) {
+  if (!modelName) return { icon: null, eta: null };
+  const map = await modelInfoMap(client);
+  return map.get(String(modelName).toLowerCase()) || { icon: null, eta: null };
+}
+
+/** Back-compat shim (used by uiCompleted and older call sites). */
 async function modelIcon(client, modelName) {
-  if (!modelName) return null;
-  const map = await modelIconMap(client);
-  return map.get(String(modelName).toLowerCase()) || null;
+  return (await modelInfo(client, modelName)).icon;
 }
 
 /* ------------------------------------------------------------------ */
@@ -219,6 +241,8 @@ module.exports = {
   uiResult,
   appsEnabled,
   modelIcon,
-  modelIconMap,
+  modelInfo,
+  modelInfoMap,
+  resolveAvatarUrl,
   widgetHtml, // exported for smoke tests
 };

package/src/apps/widgets/generation.js

@@ -12,7 +12,7 @@ const { widgetPage } = require('../html');
  *   tool: 'generate_image',            // originating MCP tool name
  *   generation_id, poll_tool,          // when phase === 'generating'
  *   status_args,                       // extra args for the poll tool (optional)
- *   estimated_seconds,                 // optional ETA hint
+
  *   model, model_icon, prompt, count,
  *   settings: { duration, resolution, aspect_ratio, audio, voice, mode },
  *   reference_image,                   // thumbnail URL (optional)
@@ -35,10 +35,6 @@ const BODY = `
     <div class="k-prompt" id="prompt"></div>
     <div class="k-chips" id="chips"></div>
     <div id="stage"></div>
-    <div class="k-progress" id="progress" style="display:none"><i id="progress-fill"></i></div>
-    <div class="k-status-line" id="status-line" style="display:none">
-      <span id="status-text">Generating…</span><span id="eta"></span>
-    </div>
     <div class="k-prompt-row" id="prompt-row">
       <input class="k-input" id="action-input" placeholder="">
       <button class="k-btn primary" id="action-send">Send</button>
@@ -57,8 +53,6 @@ const SCRIPT = `
 var state = null;          // current structuredContent
 var selected = 0;          // selected result index
 var pollTimer = null;
-var progressTimer = null;
-var startedAt = Date.now();
 
 el('logo').innerHTML = KOLBO_LOGO + '<span>Kolbo</span>';
 el('kolbo-link').onclick = function (e) { e.preventDefault(); window.kolbo.openLink('https://app.kolbo.ai'); };
@@ -98,7 +92,7 @@ function renderChips(sc) {
   if (s.voice) h += chip('🎤 ' + esc(s.voice));
   if (s.mode) h += chip(esc(s.mode));
   if (sc.count > 1) h += chip('×' + sc.count);
-  if (sc.reference_image) h += '<img class="k-ref-thumb" src="' + esc(sc.reference_image) + '" alt="" title="Reference image" onerror="this.style.display=\'none\'">';
+  if (sc.reference_image) h += '<img class="k-ref-thumb" src="' + esc(sc.reference_image) + '" alt="" title="Reference image" onerror="this.style.display=\\'none\\'">';
   el('chips').innerHTML = h;
 }
 function chip(inner) { return '<span class="k-chip">' + inner + '</span>'; }
@@ -117,24 +111,9 @@ function renderGenerating(sc) {
       (i === 0 ? '<span class="k-gen-badge"><span class="k-spin"></span>Generating</span>' : '') + '</div>';
   }
   el('stage').innerHTML = '<div class="k-gen-grid n' + n + '">' + cells + '</div>';
-  el('progress').style.display = '';
-  el('status-line').style.display = '';
   el('actions').innerHTML = '';
-  startProgress(sc.estimated_seconds || defaultEta(sc.kind));
   schedulePoll(sc);
 }
-function defaultEta(kind) { return { image: 25, video: 120, audio: 45, '3d': 300, scenes: 240 }[kind] || 60; }
-
-function startProgress(etaSec) {
-  clearInterval(progressTimer);
-  progressTimer = setInterval(function () {
-    var t = (Date.now() - startedAt) / 1000;
-    var pct = Math.min(92, 100 * (1 - Math.exp(-t / (etaSec * 0.55))));
-    el('progress-fill').style.width = pct.toFixed(1) + '%';
-    var remain = Math.max(0, etaSec - t);
-    el('eta').textContent = remain > 1 ? '~' + fmtDur(remain) + ' left' : 'finishing…';
-  }, 500);
-}
 
 function schedulePoll(sc) {
   clearTimeout(pollTimer);
@@ -147,7 +126,7 @@ function poll(sc) {
     var stateName = st.state || st.phase || st.status;
     if (stateName === 'completed') {
       var r = st.result || st;
-      finishProgress();
+
       var done = Object.assign({}, sc, r, {
         phase: 'completed',
         urls: r.urls || st.urls || [],
@@ -170,16 +149,11 @@ function poll(sc) {
     }
   }).catch(function () { schedulePoll(sc); });
 }
-function finishProgress() {
-  clearInterval(progressTimer);
-  el('progress-fill').style.width = '100%';
-  setTimeout(function () { el('progress').style.display = 'none'; el('status-line').style.display = 'none'; }, 450);
-}
 
 /* ---------- results ---------- */
 function renderResult(sc) {
-  clearTimeout(pollTimer); clearInterval(progressTimer);
-  el('progress').style.display = 'none'; el('status-line').style.display = 'none';
+  clearTimeout(pollTimer);
+
   setPhaseChip('', false);
   if (sc.kind === 'scenes' && sc.scenes && sc.scenes.length) return renderScenes(sc);
   var urls = sc.urls || [];
@@ -272,8 +246,8 @@ function renderScenes(sc) {
 }
 
 function renderError(msg) {
-  clearTimeout(pollTimer); clearInterval(progressTimer);
-  el('progress').style.display = 'none'; el('status-line').style.display = 'none';
+  clearTimeout(pollTimer);
+
   setPhaseChip('Failed', false);
   el('stage').innerHTML = '<div class="k-error">⚠ ' + esc(msg) + '</div>';
   el('actions').innerHTML = '<button class="k-btn" id="retry-btn">↻ Try Again</button>';

package/src/tools/_shared.js

@@ -311,6 +311,7 @@ const { UI, uiResult, appsEnabled, modelIcon } = require('../apps');
  *   status_args    args for poll_tool (default { generation_id })
  */
 async function uiGenerating(p) {
+  // No ETAs anywhere — just a spinner until the poll flips to completed.
   const icon = await modelIcon(p.client, p.model).catch(() => null);
   const structured = {
     phase: 'generating',
@@ -326,7 +327,6 @@ async function uiGenerating(p) {
     count: p.count || 1,
     settings: p.settings || {},
     reference_image: p.reference_image,
-    estimated_seconds: p.estimated_seconds,
   };
   const text = JSON.stringify({
     status: 'submitted',

package/src/tools/generate.js

@@ -45,7 +45,7 @@ function registerGenerateTools(server, client, options = {}) {
       if (ui()) return uiGenerating({
         tool: 'generate_image', kind: 'image', gen, client, model, prompt,
         count: num_images, settings: { resolution, aspect_ratio },
-        reference_image: reference_images?.[0], estimated_seconds: 25
+        reference_image: reference_images?.[0]
       });
 
       const result = await pollUntilDone(client, gen.generation_id, {
@@ -95,7 +95,7 @@ function registerGenerateTools(server, client, options = {}) {
       if (ui()) return uiGenerating({
         tool: 'generate_image_edit', kind: 'image', gen, client, model, prompt,
         count: num_images, settings: { resolution, aspect_ratio },
-        reference_image: source_images?.[0], estimated_seconds: 40
+        reference_image: source_images?.[0]
       });
 
       // Multi-source compositing or DNA-anchored edits routinely exceed 120s
@@ -211,7 +211,7 @@ function registerGenerateTools(server, client, options = {}) {
       if (ui()) return uiGenerating({
         tool: 'generate_video', kind: 'video', gen, client, model, prompt,
         settings: { duration, resolution, aspect_ratio },
-        reference_image: reference_images?.[0], estimated_seconds: 120
+        reference_image: reference_images?.[0]
       });
 
       const result = await pollUntilDone(client, gen.generation_id, {
@@ -259,7 +259,7 @@ function registerGenerateTools(server, client, options = {}) {
       if (ui()) return uiGenerating({
         tool: 'generate_video_from_image', kind: 'video', gen, client, model, prompt,
         settings: { duration, resolution, aspect_ratio },
-        reference_image: image_url, estimated_seconds: 120
+        reference_image: image_url
       });
 
       const result = await pollUntilDone(client, gen.generation_id, {
@@ -306,7 +306,6 @@ function registerGenerateTools(server, client, options = {}) {
       if (ui()) return uiGenerating({
         tool: 'generate_music', kind: 'audio', gen, client, model: model || 'Suno', prompt,
         settings: { mode: instrumental ? 'instrumental' : (style || undefined) },
-        estimated_seconds: 90
       });
 
       const result = await pollUntilDone(client, gen.generation_id, {
@@ -347,7 +346,7 @@ function registerGenerateTools(server, client, options = {}) {
 
       if (ui()) return uiGenerating({
         tool: 'generate_speech', kind: 'audio', gen, client, model, prompt: text,
-        settings: { voice: voice || 'Rachel' }, estimated_seconds: 20
+        settings: { voice: voice || 'Rachel' }
       });
 
       const result = await pollUntilDone(client, gen.generation_id, {
@@ -387,7 +386,7 @@ function registerGenerateTools(server, client, options = {}) {
 
       if (ui()) return uiGenerating({
         tool: 'generate_sound', kind: 'audio', gen, client, model, prompt,
-        settings: { duration }, estimated_seconds: 20
+        settings: { duration }
       });
 
       const result = await pollUntilDone(client, gen.generation_id, {
@@ -486,7 +485,7 @@ function registerGenerateTools(server, client, options = {}) {
       if (ui()) return uiGenerating({
         tool: 'generate_elements', kind: 'video', gen: startResponse, client, model, prompt,
         settings: { duration, resolution, aspect_ratio },
-        reference_image: reference_images?.[0], estimated_seconds: 180
+        reference_image: reference_images?.[0]
       });
 
       const result = await pollUntilDone(client, startResponse.generation_id, {
@@ -564,7 +563,7 @@ function registerGenerateTools(server, client, options = {}) {
       if (ui()) return uiGenerating({
         tool: 'generate_first_last_frame', kind: 'video', gen: startResponse, client, model, prompt,
         settings: { duration, resolution, aspect_ratio },
-        reference_image: first_frame_url || undefined, estimated_seconds: 120
+        reference_image: first_frame_url || undefined
       });
 
       const result = await pollUntilDone(client, startResponse.generation_id, {
@@ -674,7 +673,6 @@ function registerGenerateTools(server, client, options = {}) {
         tool: 'generate_lipsync', kind: 'video', gen: startResponse, client, model,
         prompt: text_prompt, settings: { mode: 'lipsync' },
         reference_image: sourceIsUrl && !/\.(mp4|mov|webm|mkv|avi|m4v)(\?|$)/i.test(source) ? source : undefined,
-        estimated_seconds: 180
       });
 
       const result = await pollUntilDone(client, startResponse.generation_id, {
@@ -773,7 +771,7 @@ function registerGenerateTools(server, client, options = {}) {
         tool: 'generate_video_from_video', kind: 'video', gen: startResponse, client, model,
         prompt: prompt || (preset ? `Subtitles preset: ${preset}` : undefined),
         settings: { duration, resolution, aspect_ratio, mode: preset ? 'subtitles' : 'restyle' },
-        reference_image: reference_images?.[0], estimated_seconds: 240
+        reference_image: reference_images?.[0]
       });
 
       const result = await pollUntilDone(client, startResponse.generation_id, {
@@ -890,7 +888,7 @@ function registerGenerateTools(server, client, options = {}) {
       if (ui()) return uiGenerating({
         tool: 'generate_3d', kind: '3d', gen: startResponse, client, model, prompt,
         settings: { mode: mode || (reference_images?.length > 1 ? 'multi' : reference_images?.length === 1 ? 'single' : 'text') },
-        reference_image: reference_images?.[0], estimated_seconds: 300
+        reference_image: reference_images?.[0]
       });
 
       const result = await pollUntilDone(client, startResponse.generation_id, {
@@ -940,7 +938,7 @@ function registerGenerateTools(server, client, options = {}) {
         tool: 'edit_image', kind: 'image', gen, client, model,
         prompt: prompt || operation,
         settings: { mode: operation, aspect_ratio },
-        reference_image: image_url, estimated_seconds: 40
+        reference_image: image_url
       });
 
       const result = await pollUntilDone(client, gen.generation_id, {
@@ -997,7 +995,7 @@ function registerGenerateTools(server, client, options = {}) {
         tool: 'edit_video', kind: 'video', gen, client, model,
         prompt: prompt || operation,
         settings: { mode: operation, duration, aspect_ratio },
-        reference_image: image_url, estimated_seconds: 180
+        reference_image: image_url
       });
 
       const result = await pollUntilDone(client, gen.generation_id, {

package/src/tools/shorts_creator.js

@@ -263,7 +263,6 @@ function registerShortsCreatorTools(server, client, options = {}) {
         settings: { mode: 'shorts' },
         poll_tool: 'shorts_status',
         status_args: { job_id },
-        estimated_seconds: 240
       });
 
       let job;