@kolbo/mcp 1.71.1 → 1.71.3

package/package.json

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

package/skill/GENERATED.md

@@ -1,6 +1,6 @@
 # AUTO-GENERATED — do not edit
 
-This tree is mirrored from kolbo-code@c5b2132, the single source of truth.
+This tree is mirrored from kolbo-code@ff2a2e2, the single source of truth.
 Canonical source: packages/opencode/skills/kolbo/
 Distribution: .github/workflows/sync-skill-to-plugin.yml
 

package/src/apps/html.js

@@ -109,11 +109,63 @@ function monogram(name) {
 function structured(res) {
   if (!res) return null;
   if (res.structuredContent) return res.structuredContent;
+  if (res.result) return structured(res.result);
   try {
     var t = (res.content || []).filter(function (c) { return c.type === 'text'; })[0];
     return t ? JSON.parse(t.text) : null;
   } catch (e) { return null; }
 }
+// Hosts that do not advertise MCP Apps (Kolbo Code) get plain JSON
+// ({ sessions }, { generations }, { projects }, …) with no items[].
+// Normalize those shapes so list.html and the generation fallback can
+// leave Loading on first paint without waiting for a newer host.
+function listPayload(sc) {
+  if (!sc || typeof sc !== 'object') return null;
+  if (sc.widget && sc.widget !== 'list') return null;
+  if (sc.phase || sc.generation_id || sc.generation_ids) return null;
+  if (Array.isArray(sc.items)) {
+    return {
+      widget: 'list',
+      title: sc.title || 'List',
+      items: sc.items,
+      total: sc.total != null ? sc.total : sc.items.length
+    };
+  }
+  var key = sc.sessions ? 'sessions' : sc.projects ? 'projects' : sc.generations ? 'generations'
+    : sc.agents ? 'agents' : sc.docs ? 'docs' : sc.folders ? 'folders' : sc.sources ? 'sources' : '';
+  var rows = key ? sc[key] : null;
+  if (!Array.isArray(rows)) return null;
+  var titles = {
+    sessions: 'Sessions', projects: 'Projects', generations: 'Generations',
+    agents: 'Agents', docs: 'Docs', folders: 'Folders', sources: 'Knowledge Base'
+  };
+  return {
+    widget: 'list',
+    title: sc.title || titles[key] || 'List',
+    items: rows.map(function (row) {
+      var types = Array.isArray(row.types)
+        ? row.types.filter(function (x) { return typeof x === 'string'; })
+        : String(row.type || '').split('|').filter(Boolean);
+      var id = row.session_id || row.id || row.generation_id || row.file_key;
+      var name = row.name || row.title || (row.prompt ? String(row.prompt).slice(0, 80) : '') || types[0] || 'Item';
+      return {
+        id: id,
+        title: name,
+        subtitle: [
+          types.join(', ') || row.role || row.status || row.description,
+          id,
+          row.project_id ? 'project ' + row.project_id : null,
+          row.updated_at ? String(row.updated_at).slice(0, 10) : null,
+          row.output_count ? row.output_count + ' outputs' : null
+        ].filter(Boolean).join(' · '),
+        badge: types[0] || row.role || row.status,
+        open_url: row.open_url || row.share_url || null,
+        meta: row.item_count != null ? String(row.item_count) : undefined
+      };
+    }),
+    total: sc.total != null ? sc.total : (sc.count != null ? sc.count : rows.length)
+  };
+}
 </script>
 <script>${script}</script>
 </body>

package/src/apps/index.js

@@ -166,6 +166,13 @@ function uiResult(uri, text, structured) {
   };
 }
 
+/** List tools always ship structuredContent — Kolbo Code does not advertise
+ *  MCP Apps, so gating on appsEnabled() left list.html / the generation
+ *  fallback stuck on Loading with only `{ sessions }` text. */
+function listResult(text, structured) {
+  return uiResult(UI.list, text, structured);
+}
+
 /* ------------------------------------------------------------------ */
 /* Model icon lookup (name/identifier → absolute avatar URL)           */
 /* ------------------------------------------------------------------ */
@@ -494,6 +501,7 @@ module.exports = {
   attachToolWidgetMeta,
   uiMeta,
   uiResult,
+  listResult,
   appsEnabled,
   modelIcon,
   modelInfo,

package/src/apps/widgets/generation.js

@@ -889,6 +889,8 @@ function completedFromPlain(sc) {
 /* ---------- wire host events ---------- */
 window.kolbo.onToolResult(function (result) {
   var sc = result.structuredContent || structured(result);
+  var list = listPayload(sc);
+  if (list) return renderList(list);
   if (sc && (sc.phase || sc.widget)) return boot(sc);
   var recovered = completedFromPlain(sc);
   if (recovered) return boot(recovered);
@@ -907,7 +909,10 @@ window.kolbo.ready(function (ctx) {
   var info = ctx && ctx.toolInfo;
   if (!state && info) {
     originTool = (info.tool && info.tool.name) || originTool;
-    if (info.result && info.result.structuredContent) return boot(info.result.structuredContent);
+    var raw = info.result && (info.result.structuredContent || structured(info.result));
+    var list = listPayload(raw);
+    if (list) return renderList(list);
+    if (raw) return boot(raw);
     bootPre(originTool, null);
   }
 });

package/src/apps/widgets/list.js

@@ -43,17 +43,30 @@ el('kolbo-link').onclick = function (e) { e.preventDefault(); window.kolbo.openL
 var state = null;
 
 function boot(sc) {
-  if (!sc || !sc.items) return;
-  state = sc;
-  el('title').textContent = sc.title || 'List';
-  var total = sc.total != null ? sc.total : sc.items.length;
+  var list = listPayload(sc);
+  if (!list) return false;
+  state = list;
+  el('title').textContent = list.title || 'List';
+  var total = list.total != null ? list.total : list.items.length;
   el('count-chip').style.display = '';
   el('count-chip').textContent = total + (total === 1 ? ' item' : ' items');
-  if (!sc.items.length) { el('stage').innerHTML = '<div class="k-empty">Nothing here yet</div>'; return; }
-  el('stage').innerHTML = sc.items.slice(0, 40).map(itemHTML).join('');
+  if (!list.items.length) {
+    el('stage').classList.add('k-empty');
+    el('stage').innerHTML = 'Nothing here yet';
+    window.kolbo.notifySize();
+    return true;
+  }
+  el('stage').innerHTML = list.items.slice(0, 40).map(itemHTML).join('');
   el('stage').classList.remove('k-empty');
   wire();
   window.kolbo.notifySize();
+  return true;
+}
+
+function apply(result) {
+  if (!result) return false;
+  var inner = result.result || result;
+  return boot(inner.structuredContent || structured(inner) || inner);
 }
 
 function itemHTML(item, i) {
@@ -86,11 +99,11 @@ function wire() {
 }
 
 window.kolbo.onToolResult(function (result) {
-  var sc = result.structuredContent || structured(result);
-  if (sc && sc.items) return boot(sc);
-  var card = document.querySelector('.k-card');
-  if (card) card.style.display = 'none';
-  window.kolbo.notifySize();
+  apply(result);
+});
+window.kolbo.ready(function (ctx) {
+  var info = ctx && ctx.toolInfo;
+  if (info && info.result) apply(info.result);
 });
 `;
 

package/src/tools/agents.js

@@ -4,10 +4,9 @@
  * new OPTIONAL args only. Full rules: ../index.js top-of-file and CLAUDE.md. */
 
 const { z } = require('zod');
-const { UI, uiResult, appsEnabled } = require('../apps');
+const { listResult } = require('../apps');
 
-function registerAgentTools(server, client, options = {}) {
-  const ui = () => appsEnabled(server, options);
+function registerAgentTools(server, client) {
   // ─── list_agents ───────────────────────────────────────────
   server.tool(
     'list_agents',
@@ -22,22 +21,18 @@ function registerAgentTools(server, client, options = {}) {
         count: result.count || agents.length
       }, null, 2);
 
-      if (ui()) {
-        return uiResult(UI.list, text, {
-          widget: 'list',
-          title: 'Your Agents',
-          items: agents.map(a => ({
-            id: a.id,
-            title: (a.emoji ? a.emoji + ' ' : '') + a.name,
-            subtitle: a.description,
-            badge: a.is_global ? 'preset' : null,
-            use_hint: 'Use my "{TITLE}" agent (agent_id: {ID}) for this conversation.'
-          })),
-          total: agents.length
-        });
-      }
-
-      return { content: [{ type: 'text', text }] };
+      return listResult(text, {
+        widget: 'list',
+        title: 'Your Agents',
+        items: agents.map(a => ({
+          id: a.id,
+          title: (a.emoji ? a.emoji + ' ' : '') + a.name,
+          subtitle: a.description,
+          badge: a.is_global ? 'preset' : null,
+          use_hint: 'Use my "{TITLE}" agent (agent_id: {ID}) for this conversation.'
+        })),
+        total: agents.length
+      });
     }
   );
 

package/src/tools/docs.js

@@ -5,12 +5,11 @@
 
 const { z } = require('zod');
 const { projectIdField } = require('./_shared');
-const { UI, uiResult, appsEnabled } = require('../apps');
+const { listResult } = require('../apps');
 
 const CONTENT_GUIDE = 'HTML body content. Use clean semantic HTML the in-app editor understands: <h1>-<h3>, <p>, <ul>/<ol>/<li>, <table>, <blockquote>, <strong>/<em>, <a>. No <script>/<style>/<iframe> (stripped server-side). Write the FULL document yourself — this is where you author the doc.';
 
-function registerDocTools(server, client, options = {}) {
-  const ui = () => appsEnabled(server, options);
+function registerDocTools(server, client) {
   // ─── create_doc ────────────────────────────────────────────
   server.tool(
     'create_doc',
@@ -55,21 +54,17 @@ function registerDocTools(server, client, options = {}) {
       const docs = result.docs || [];
       const text = JSON.stringify({ docs, pagination: result.pagination || null }, null, 2);
 
-      if (ui()) {
-        return uiResult(UI.list, text, {
-          widget: 'list',
-          title: 'Your AI Docs',
-          items: docs.map(d => ({
-            id: d.id,
-            title: d.title,
-            subtitle: (d.updated_at ? String(d.updated_at).slice(0, 10) : '') + (d.is_shared ? ' · shared' : ''),
-            open_url: d.share_url || null
-          })),
-          total: docs.length
-        });
-      }
-
-      return { content: [{ type: 'text', text }] };
+      return listResult(text, {
+        widget: 'list',
+        title: 'Your AI Docs',
+        items: docs.map(d => ({
+          id: d.id,
+          title: d.title,
+          subtitle: (d.updated_at ? String(d.updated_at).slice(0, 10) : '') + (d.is_shared ? ' · shared' : ''),
+          open_url: d.share_url || null
+        })),
+        total: docs.length
+      });
     }
   );
 

package/src/tools/media.js

@@ -6,7 +6,7 @@
 const { z } = require('zod');
 const FormData = require('form-data');
 const { resolveToBuffer, DEFAULT_MAX_FILE_MB, compactList } = require('./_shared');
-const { UI, uiResult, appsEnabled } = require('../apps');
+const { UI, uiResult, listResult, appsEnabled } = require('../apps');
 
 // How many tiles the media grid renders. A rendering limit only — the text
 // payload always carries the full page, and `total` reports the real library
@@ -343,22 +343,18 @@ function registerMediaTools(server, client, options = {}) {
       const folders = result.folders || [];
       const text = JSON.stringify({ folders, count: result.count || 0 }, null, 2);
 
-      if (ui()) {
-        return uiResult(UI.list, text, {
-          widget: 'list',
-          title: 'Media Folders',
-          items: folders.map(f => ({
-            id: f.id,
-            title: f.name,
-            subtitle: f.description,
-            meta: (f.item_count || 0) + (f.item_count === 1 ? ' item' : ' items'),
-            use_hint: 'List media in my "{TITLE}" folder (folder_id: {ID}).'
-          })),
-          total: folders.length
-        });
-      }
-
-      return { content: [{ type: 'text', text }] };
+      return listResult(text, {
+        widget: 'list',
+        title: 'Media Folders',
+        items: folders.map(f => ({
+          id: f.id,
+          title: f.name,
+          subtitle: f.description,
+          meta: (f.item_count || 0) + (f.item_count === 1 ? ' item' : ' items'),
+          use_hint: 'List media in my "{TITLE}" folder (folder_id: {ID}).'
+        })),
+        total: folders.length
+      });
     }
   );
 

package/src/tools/projects.js

@@ -5,10 +5,9 @@
 
 const { z } = require('zod');
 const { buildProjectUrl } = require('./_shared');
-const { UI, uiResult, appsEnabled } = require('../apps');
+const { listResult } = require('../apps');
 
-function registerProjectTools(server, client, options = {}) {
-  const ui = () => appsEnabled(server, options);
+function registerProjectTools(server, client) {
   // ─── list_projects ─────────────────────────────────────────
   server.tool(
     'list_projects',
@@ -42,22 +41,18 @@ function registerProjectTools(server, client, options = {}) {
         _hint: 'Pass the chosen `id` as `project_id` on any generate_* tool to drop the generation into that project. Omit project_id to use the project flagged is_default:true. `open_url` opens that project\'s media in the web app (share it with the user). If `pagination.has_more` is true there are more projects — narrow with `search` rather than paging through everything.'
       }, null, 2);
 
-      if (ui()) {
-        return uiResult(UI.list, text, {
-          widget: 'list',
-          title: 'Your Projects',
-          items: projects.map(p => ({
-            id: p.id,
-            title: p.name,
-            subtitle: p.role + (p.is_default ? ' · default' : '') + (p.is_archived ? ' · archived' : ''),
-            open_url: p.open_url,
-            use_hint: 'Use my "{TITLE}" project (project_id: {ID}) for what I do next.'
-          })),
-          total: projects.length
-        });
-      }
-
-      return { content: [{ type: 'text', text }] };
+      return listResult(text, {
+        widget: 'list',
+        title: 'Your Projects',
+        items: projects.map(p => ({
+          id: p.id,
+          title: p.name,
+          subtitle: p.role + (p.is_default ? ' · default' : '') + (p.is_archived ? ' · archived' : ''),
+          open_url: p.open_url,
+          use_hint: 'Use my "{TITLE}" project (project_id: {ID}) for what I do next.'
+        })),
+        total: projects.length
+      });
     }
   );
 
@@ -135,20 +130,17 @@ function registerProjectTools(server, client, options = {}) {
         generations,
         _hint: 'This is an inventory, not a live generation. Pass the `id` values to `move_generations_to_session` (into an existing session) or `split_session` (into a new one). `in_flight: true` means it is still running and cannot be moved yet.'
       }, null, 2);
-      if (ui()) {
-        return uiResult(UI.list, text, {
-          widget: 'list',
-          title: (result.session && result.session.name) || 'Session generations',
-          items: generations.map((g) => ({
-            id: g.id,
-            title: (g.prompt && String(g.prompt).slice(0, 80)) || g.id,
-            subtitle: [g.status, g.output_count ? g.output_count + ' outputs' : null].filter(Boolean).join(' · '),
-            badge: g.in_flight ? 'running' : g.status
-          })),
-          total: generations.length
-        });
-      }
-      return { content: [{ type: 'text', text }] };
+      return listResult(text, {
+        widget: 'list',
+        title: (result.session && result.session.name) || 'Session generations',
+        items: generations.map((g) => ({
+          id: g.id,
+          title: (g.prompt && String(g.prompt).slice(0, 80)) || g.id,
+          subtitle: [g.status, g.output_count ? g.output_count + ' outputs' : null].filter(Boolean).join(' · '),
+          badge: g.in_flight ? 'running' : g.status
+        })),
+        total: generations.length
+      });
     }
   );
 
@@ -316,26 +308,22 @@ function registerProjectTools(server, client, options = {}) {
         _hint: 'Each row has project_id — pass it on every later generate/chat/upload in this conversation. Empty leftover sessions after a move: delete_session.'
       }, null, 2);
 
-      if (ui()) {
-        return uiResult(UI.list, text, {
-          widget: 'list',
-          title: 'Sessions' + (type ? ' — ' + type : '') + ' (' + sessions.length + ')',
-          items: sessions.map(s => ({
-            id: s.session_id,
-            title: s.name || s.types[0] || s.type || 'Session',
-            subtitle: [
-              s.session_id,
-              (s.types || []).join(', '),
-              s.project_id ? 'project ' + s.project_id : null,
-              s.updated_at ? String(s.updated_at).slice(0, 10) : null
-            ].filter(Boolean).join(' · '),
-            badge: (s.types && s.types[0]) || undefined
-          })),
-          total: sessions.length
-        });
-      }
-
-      return { content: [{ type: 'text', text }] };
+      return listResult(text, {
+        widget: 'list',
+        title: 'Sessions' + (type ? ' — ' + type : '') + ' (' + sessions.length + ')',
+        items: sessions.map(s => ({
+          id: s.session_id,
+          title: s.name || s.types[0] || s.type || 'Session',
+          subtitle: [
+            s.session_id,
+            (s.types || []).join(', '),
+            s.project_id ? 'project ' + s.project_id : null,
+            s.updated_at ? String(s.updated_at).slice(0, 10) : null
+          ].filter(Boolean).join(' · '),
+          badge: (s.types && s.types[0]) || undefined
+        })),
+        total: sessions.length
+      });
     }
   );
 
@@ -416,21 +404,17 @@ function registerProjectTools(server, client, options = {}) {
       const sources = result.sources || [];
       const text = JSON.stringify({ sources, count: result.count || 0 }, null, 2);
 
-      if (ui()) {
-        return uiResult(UI.list, text, {
-          widget: 'list',
-          title: 'Project Knowledge Base',
-          items: sources.map(s => ({
-            id: s.file_key,
-            title: s.title || s.type,
-            subtitle: s.type + ' · ' + s.status,
-            open_url: s.url || null
-          })),
-          total: sources.length
-        });
-      }
-
-      return { content: [{ type: 'text', text }] };
+      return listResult(text, {
+        widget: 'list',
+        title: 'Project Knowledge Base',
+        items: sources.map(s => ({
+          id: s.file_key,
+          title: s.title || s.type,
+          subtitle: s.type + ' · ' + s.status,
+          open_url: s.url || null
+        })),
+        total: sources.length
+      });
     }
   );
 

package/src/tools/visual_dna.js

@@ -6,7 +6,7 @@
 const { z } = require('zod');
 const FormData = require('form-data');
 const { resolveToBuffer: sharedResolveToBuffer, VISUAL_DNA_MAX_BYTES, projectScopeReadField, compactList } = require('./_shared');
-const { UI, uiResult, appsEnabled } = require('../apps');
+const { UI, uiResult, listResult, appsEnabled } = require('../apps');
 
 // Visual DNA caps reference media at 25MB per file (stricter than the
 // default _shared.resolveToBuffer cap — DNA profiles only need enough
@@ -227,21 +227,17 @@ function registerVisualDnaTools(server, client, options = {}) {
       const folders = result.folders || [];
       const text = JSON.stringify({ folders, count: result.count || 0 }, null, 2);
 
-      if (ui()) {
-        return uiResult(UI.list, text, {
-          widget: 'list',
-          title: 'Visual DNA Folders',
-          items: folders.map(f => ({
-            id: f.id,
-            title: f.name,
-            meta: f.item_count != null ? (f.item_count + (f.item_count === 1 ? ' DNA' : ' DNAs')) : null,
-            use_hint: 'List Visual DNAs in my "{TITLE}" folder (folder_id: {ID}).'
-          })),
-          total: folders.length
-        });
-      }
-
-      return { content: [{ type: 'text', text }] };
+      return listResult(text, {
+        widget: 'list',
+        title: 'Visual DNA Folders',
+        items: folders.map(f => ({
+          id: f.id,
+          title: f.name,
+          meta: f.item_count != null ? (f.item_count + (f.item_count === 1 ? ' DNA' : ' DNAs')) : null,
+          use_hint: 'List Visual DNAs in my "{TITLE}" folder (folder_id: {ID}).'
+        })),
+        total: folders.length
+      });
     }
   );