@kolbo/mcp 1.87.7 → 1.87.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolbo/mcp",
-  "version": "1.87.7",
+  "version": "1.87.9",
   "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

@@ -210,6 +210,75 @@ const BRIDGE_JS = `
     },
     hostContext: function () { return hostContext; }
   };
+
+  // ChatGPT (OpenAI Apps SDK) host. It mounts the same iframe but speaks no
+  // JSON-RPC: tool input / output / theme arrive as window.openai globals plus
+  // an 'openai:set_globals' DOM event, and actions are methods on that object.
+  // Without this adapter the card rendered, waited for a tool-input that never
+  // came, and sat on "Preparing" with no prompt, no settings and no result —
+  // even after the tool had returned. Everything here maps onto the same
+  // callbacks the JSON-RPC path drives, so widgets need no host-specific code.
+  var oa = window.openai && typeof window.openai === 'object' ? window.openai : null;
+  if (oa) {
+    var oaInputSeen = false, oaOutputSeen = false;
+    var oaName = function () {
+      var meta = oa.toolResponseMetadata || {};
+      return oa.toolName || meta['kolbo/tool'] || (oa.toolOutput && oa.toolOutput.tool) || undefined;
+    };
+    var oaSync = function () {
+      var name = oaName();
+      // Same shape claude.ai hands ready(): toolInfo.tool.name is what widgets read.
+      hostContext = { theme: oa.theme, displayMode: oa.displayMode, toolInfo: { name: name, tool: { name: name }, arguments: oa.toolInput || {} } };
+      if (!initialized) {
+        initialized = true;
+        queue = [];
+        readyFns.forEach(function (f) { try { f(hostContext); } catch (e) {} });
+      } else {
+        themeFns.forEach(function (f) { try { f(hostContext); } catch (e) {} });
+      }
+      if (oa.toolInput && !oaInputSeen) {
+        oaInputSeen = true;
+        toolInputFns.forEach(function (f) { try { f(oa.toolInput, { name: oaName(), arguments: oa.toolInput }); } catch (e) {} });
+      }
+      if (oa.toolOutput && !oaOutputSeen) {
+        oaOutputSeen = true;
+        var res = { structuredContent: oa.toolOutput, _meta: oa.toolResponseMetadata || {} };
+        toolResultFns.forEach(function (f) { try { f(res); } catch (e) {} });
+      }
+    };
+    var oaCall = function (method) { return typeof oa[method] === 'function'; };
+    window.kolbo.callTool = function (name, args) {
+      if (!oaCall('callTool')) return Promise.reject(new Error('host cannot call tools'));
+      return Promise.resolve(oa.callTool(name, args || {})).then(function (r) {
+        // The SDK resolves with the CallToolResult (content + structuredContent);
+        // some builds unwrap to the structured payload — normalise either.
+        if (r && (r.structuredContent || r.content)) return r;
+        return { structuredContent: r, content: [] };
+      });
+    };
+    window.kolbo.sendMessage = function (text) {
+      return oaCall('sendFollowUpMessage') ? Promise.resolve(oa.sendFollowUpMessage({ prompt: text })) : Promise.reject(new Error('unsupported'));
+    };
+    window.kolbo.insertText = function () { return Promise.reject(new Error('unsupported')); };
+    window.kolbo.openLink = function (url) {
+      return oaCall('openExternal') ? Promise.resolve(oa.openExternal({ href: url })) : Promise.resolve(window.open(url, '_blank'));
+    };
+    window.kolbo.copyText = function (t) {
+      return navigator.clipboard && navigator.clipboard.writeText ? navigator.clipboard.writeText(t) : Promise.reject(new Error('unsupported'));
+    };
+    window.kolbo.attachMedia = function () { return Promise.reject(new Error('unsupported')); };
+    window.kolbo.updateModelContext = function () { return Promise.resolve(); };
+    window.kolbo.requestDisplayMode = function (mode) {
+      if (!oaCall('requestDisplayMode')) return Promise.resolve({ mode: 'inline' });
+      return Promise.resolve(oa.requestDisplayMode({ mode: mode })).then(function (r) { return { mode: (r && r.mode) || mode }; });
+    };
+    window.addEventListener('openai:set_globals', oaSync);
+    // Deferred: the widget's own script (which registers ready/onToolInput/
+    // onToolResult) runs AFTER this bridge block in the same document, and a
+    // synchronous sync here fired into empty listener lists and marked the
+    // input/output as seen.
+    setTimeout(oaSync, 0);
+  }
 })();
 `;
 

package/src/apps/index.js

@@ -71,12 +71,12 @@ const WIDGET_CSP = {
     // Public hosts owned by Kolbo.
     'https://api.kolbo.ai',
     'https://app.kolbo.ai',
-    'https://cdn.kolbo.ai',
-    // Preset thumbnails and library media live on the media-* hosts (prod
-    // presets still reference media-dev); without these every preset tile
-    // rendered as a black box. All three are on kolbo-api's download allowlist.
-    'https://media.kolbo.ai',
-    'https://media-staging.kolbo.ai',
+    'https://cdn.kolbo.ai',
+    // Preset thumbnails and library media live on the media-* hosts (prod
+    // presets still reference media-dev); without these every preset tile
+    // rendered as a black box. All three are on kolbo-api's download allowlist.
+    'https://media.kolbo.ai',
+    'https://media-staging.kolbo.ai',
     'https://media-dev.kolbo.ai',
     ...KOLBO_MEDIA_DOMAINS,
     'https://kolbo-general-media.fra1.digitaloceanspaces.com',
@@ -201,7 +201,9 @@ function uiResult(uri, text, structured) {
   return {
     content: [{ type: 'text', text }],
     structuredContent: structured,
-    _meta: uiMeta(uri),
+    // 'kolbo/tool' reaches ChatGPT widgets as toolResponseMetadata — that host
+    // never tells the iframe which tool ran, and the card title depends on it.
+    _meta: { ...uiMeta(uri), ...(structured && structured.tool ? { 'kolbo/tool': structured.tool } : {}) },
   };
 }
 

package/src/apps/widgets/list.js

@@ -47,6 +47,8 @@ var state = null;
 function boot(sc) {
   var list = listPayload(sc);
   if (!list) return false;
+  // listPayload() normalises plain shapes; carry the paging contract through.
+  if (sc && sc.page_tool && !list.page_tool) { list.page_tool = sc.page_tool; list.next_args = sc.next_args; list.page = sc.page; }
   state = list;
   el('title').textContent = list.title || 'List';
   var total = list.total != null ? list.total : list.items.length;
@@ -58,13 +60,41 @@ function boot(sc) {
     window.kolbo.notifySize();
     return true;
   }
-  el('stage').innerHTML = list.items.slice(0, 40).map(itemHTML).join('');
+  // Render every item the server sent (the old slice(0, 40) silently dropped
+  // rows, and nothing told the user). Load more only when the server said how.
+  var h = list.items.map(itemHTML).join('');
+  var shown = list.items.length;
+  if (list.page_tool && list.next_args) {
+    h += '<button class="k-btn" id="load-more" style="width:100%;margin-top:10px">Load more' +
+      (total > shown ? ' (' + shown + ' of ' + total + ' shown)' : '') + '</button>';
+  }
+  el('stage').innerHTML = h;
   el('stage').classList.remove('k-empty');
   wire();
+  var lm = el('load-more');
+  if (lm) lm.onclick = function () { fetchNextPage(lm); };
   window.kolbo.notifySize();
   return true;
 }
 
+function fetchNextPage(btn) {
+  if (!state || !state.page_tool || !state.next_args || btn.disabled) return;
+  btn.disabled = true;
+  var label = btn.textContent;
+  btn.innerHTML = '<span class="k-spin"></span> Loading';
+  window.kolbo.callTool(state.page_tool, state.next_args).then(function (res) {
+    var sc = structured(res);
+    var next = sc ? listPayload(sc) || sc : null;
+    var more = (next && next.items) || [];
+    if ((res && res.isError) || !next) { btn.disabled = false; btn.textContent = 'Could not load more — try again'; return; }
+    if (!more.length) { btn.textContent = 'No more results'; return; }
+    state.items = state.items.concat(more);
+    state.next_args = sc.next_args;
+    if (sc.total != null) state.total = sc.total;
+    boot(Object.assign({}, state, { widget: 'list', page_tool: state.page_tool, next_args: state.next_args }));
+  }).catch(function () { btn.disabled = false; btn.textContent = label; });
+}
+
 function apply(result) {
   if (!result) return false;
   var inner = result.result || result;

package/src/apps/widgets/mediaGrid.js

@@ -60,9 +60,14 @@ function boot(sc) {
     h += audioItems.map(audioRowHTML).join('');
   }
   var shown = visualItems.length + audioItems.length;
-  if (sc.total != null && sc.total > shown) {
+  // Only a tool that told us HOW to page (page_tool + next_args / query) gets a
+  // button. Every other grid used to render a Load more that did nothing —
+  // fetchNextPage returned early with no page_tool — which read as "broken".
+  if (sc.total != null && sc.total > shown && sc.page_tool && (sc.next_args || sc.query || sc.page)) {
     h += '<button class="k-btn" id="load-more" style="width:100%;margin-top:10px">Load more (' +
       shown + ' of ' + sc.total + ' shown)</button>';
+  } else if (sc.total != null && sc.total > shown) {
+    h += '<div style="text-align:center;font-size:12px;color:var(--text-muted);margin-top:10px">' + shown + ' of ' + sc.total + ' shown</div>';
   }
   el('stage').innerHTML = h;
   el('stage').classList.remove('k-empty');
@@ -177,14 +182,26 @@ function fetchNextPage(btn) {
   btn.disabled = true;
   var label = btn.textContent;
   btn.innerHTML = '<span class="k-spin"></span> Loading';
+  // The server knows its own paging arg names (page/limit, offset, cursor…):
+  // when it shipped next_args, send exactly that. The query+page shape is the
+  // legacy fallback list_media has always used.
   var args = {};
-  var q = state.query || {};
-  for (var k in q) { if (q[k] !== undefined && q[k] !== null && q[k] !== '') args[k] = q[k]; }
-  args.page = next;
-  if (state.page_size) args.page_size = state.page_size;
+  if (state.next_args) {
+    for (var nk in state.next_args) { if (state.next_args[nk] !== undefined && state.next_args[nk] !== null) args[nk] = state.next_args[nk]; }
+  } else {
+    var q = state.query || {};
+    for (var k in q) { if (q[k] !== undefined && q[k] !== null && q[k] !== '') args[k] = q[k]; }
+    args.page = next;
+    if (state.page_size) args.page_size = state.page_size;
+  }
 
   window.kolbo.callTool(state.page_tool, args).then(function (res) {
     var sc = structured(res);
+    if (res && res.isError) {
+      btn.disabled = false;
+      btn.textContent = 'Could not load more — try again';
+      return;
+    }
     var more = (sc && sc.items) || [];
     if (!more.length) {
       // Nothing came back: say so rather than restoring a button that still
@@ -194,6 +211,9 @@ function fetchNextPage(btn) {
     }
     state.items = (state.items || []).concat(more);
     state.page = (sc && sc.page) || next;
+    // The next page's args come from THIS response; none means this was the last page.
+    state.next_args = sc && sc.next_args;
+    if (sc && sc.next_args == null && sc.page_tool == null && state.next_args === undefined) state.next_args = undefined;
     if (sc && sc.total != null) state.total = sc.total;
     boot(state);            // re-renders the grid + a fresh Load more button
   }).catch(function () {

package/src/tools/color_palettes.js

@@ -40,7 +40,7 @@ function registerColorPaletteTools(server, client, options = {}) {
         return uiResult(UI.mediaGrid, text, {
           widget: 'media-grid',
           title: 'Color DNA Palettes',
-          items: palettes.slice(0, 24).map(p => ({
+          items: palettes.slice(0, 300).map(p => ({
             id: p.id,
             title: p.is_active ? `${p.name} (active)` : p.name,
             // First source image when available, else an SVG strip of the palette itself.
@@ -48,8 +48,8 @@ function registerColorPaletteTools(server, client, options = {}) {
             media_type: 'image',
             use_hint: 'Activate Color DNA palette "{TITLE}" (color_palette_id: {ID}) so it grades my generations.'
           })),
-          total: result.pagination?.total || palettes.length,
-          has_more: palettes.length > 24
+          total: palettes.length,
+          has_more: palettes.length > 300
         });
       }
 

package/src/tools/docs.js

@@ -63,7 +63,9 @@ function registerDocTools(server, client) {
           subtitle: (d.updated_at ? String(d.updated_at).slice(0, 10) : '') + (d.is_shared ? ' · shared' : ''),
           open_url: d.share_url || null
         })),
-        total: docs.length
+        total: docs.length,
+        page_tool: 'list_docs',
+        next_args: docs.length >= (limit || 20) ? { project_id, page: (page || 1) + 1, limit } : undefined
       });
     }
   );

package/src/tools/moodboards.js

@@ -11,14 +11,16 @@ function registerMoodboardTools(server, client, options = {}) {
   // ─── list_moodboards ───────────────────────────────────────
   server.tool(
     'list_moodboards',
-    'List moodboards. By default returns ALL (personal + system presets + organization). Use "scope" to filter: "personal" (user\'s own), "preset" or "global" (system presets), or "organization" (org-shared). Returns id, name, master_prompt, thumbnail, and image URLs for each.',
+    'List moodboards. Default scope is "personal" — the user\'s OWN custom moodboards, which is what the card shows. Pass scope "preset"/"global" for the system presets, "organization" for org-shared, or "all" for everything. Returns id, name, master_prompt, thumbnail, and image URLs for each.',
     {
-      scope: z.enum(['all', 'personal', 'preset', 'global', 'organization']).optional().describe('Filter by scope. Default: "all" (everything accessible). "personal" = only your own. "preset"/"global" = system presets. "organization" = org-shared.'),
+      scope: z.enum(['all', 'personal', 'preset', 'global', 'organization']).optional().describe('Filter by scope. Default: "personal" (only the user\'s own custom moodboards). "preset"/"global" = system presets. "organization" = org-shared. "all" = everything accessible.'),
       project_id: projectScopeReadField
     },
     async ({ scope, project_id } = {}) => {
       const params = new URLSearchParams();
-      if (scope && scope !== 'all') params.set('scope', scope);
+      // Users asked to see only THEIR moodboards on the card, not the system presets.
+      const effectiveScope = scope || 'personal';
+      if (effectiveScope !== 'all') params.set('scope', effectiveScope);
       if (project_id) params.set('project_id', project_id);
       const qs = params.toString();
       const result = await client.get(`/v1/moodboards${qs ? '?' + qs : ''}`);
@@ -36,7 +38,7 @@ function registerMoodboardTools(server, client, options = {}) {
       return uiResult(UI.mediaGrid, text, {
         widget: 'media-grid',
         title: 'Moodboards',
-        items: moodboards.slice(0, 24).map(mb => ({
+        items: moodboards.slice(0, 300).map(mb => ({
           id: mb.id,
           title: mb.name,
           // API returns thumbnail_url + images[] (sdk listMoodboards) — both
@@ -46,8 +48,8 @@ function registerMoodboardTools(server, client, options = {}) {
           media_type: 'image',
           use_hint: 'Apply moodboard "{TITLE}" (moodboard_id: {ID}) to my next generation.'
         })),
-        total: result.count || moodboards.length,
-        has_more: moodboards.length > 24
+        total: moodboards.length,
+        has_more: moodboards.length > 300
       });
     }
   );

package/src/tools/music_library.js

@@ -26,7 +26,7 @@ function trackItem(track) {
   };
 }
 
-function tracksResult(ui, title, tracks, total) {
+function tracksResult(ui, title, tracks, total, paging) {
   if (!tracks.length) return { content: [{ type: 'text', text: 'No SYNCI tracks found.' }] };
   const text = [
     `Found ${tracks.length} track${tracks.length === 1 ? '' : 's'}${total ? ` (of ${total})` : ''}.`,
@@ -38,8 +38,11 @@ function tracksResult(ui, title, tracks, total) {
   return uiResult(UI.mediaGrid, text, {
     widget: 'media-grid',
     title,
-    items: tracks.slice(0, 20).map(trackItem),
+    items: tracks.map(trackItem),
     total: total != null ? total : tracks.length,
+    ...(paging && total != null && (paging.offset + tracks.length) < total
+      ? { page_tool: paging.tool, next_args: { ...paging.args, offset: paging.offset + tracks.length, limit: paging.limit } }
+      : {}),
   });
 }
 
@@ -90,7 +93,8 @@ function registerMusicLibraryTools(server, client, options = {}) {
     },
     async (args) => {
       const result = await client.post('/v1/music-library/search', args);
-      return tracksResult(ui, `SYNCI — ${args.query || 'Search'}`, result.tracks || [], result.total);
+      return tracksResult(ui, `SYNCI — ${args.query || 'Search'}`, result.tracks || [], result.total,
+        { tool: 'search_music_library', args, offset: args.offset || 0, limit: args.limit || (result.tracks || []).length || 20 });
     },
   );
 
@@ -118,7 +122,8 @@ function registerMusicLibraryTools(server, client, options = {}) {
       if (limit != null) params.set('limit', String(limit));
       if (offset != null) params.set('offset', String(offset));
       const result = await client.get(`/v1/music-library/catalog?${params.toString()}`);
-      return tracksResult(ui, 'SYNCI Music Library', result.tracks || [], result.total);
+      return tracksResult(ui, 'SYNCI Music Library', result.tracks || [], result.total,
+        { tool: 'browse_music_library', args: { sort }, offset: offset || 0, limit: limit || (result.tracks || []).length || 20 });
     },
   );
 

package/src/tools/projects.js

@@ -60,7 +60,9 @@ function registerProjectTools(server, client) {
           open_url: p.open_url,
           use_hint: 'Use my "{TITLE}" project (project_id: {ID}) for what I do next.'
         })),
-        total: projects.length
+        total: projects.length,
+        page_tool: 'list_projects',
+        next_args: projects.length >= (limit || 50) ? { search, include_archived, page: (page || 1) + 1, limit } : undefined
       });
     }
   );
@@ -359,7 +361,9 @@ function registerProjectTools(server, client) {
           ].filter(Boolean).join(' · '),
           badge: (s.types && s.types[0]) || undefined
         })),
-        total: sessions.length
+        total: sessions.length,
+        page_tool: 'list_sessions',
+        next_args: sessions.length >= (limit || 20) ? { project_id, type, types, page: (page || 1) + 1, limit } : undefined
       });
     }
   );

package/src/tools/stock_library.js

@@ -84,7 +84,7 @@ function registerStockLibraryTools(server, client, options = {}) {
       // the media grid on them, so the card rendered one broken-file glyph per cell.
       // media.js and listResult() have always done it this way; these five lagged.
       {
-        const items = assets.slice(0, 24).map((a) => {
+        const items = assets.map((a) => {
           const mt = widgetMediaType(a.mediaType);
           return {
             id: a.source + ':' + a.sourceId,
@@ -107,7 +107,12 @@ function registerStockLibraryTools(server, client, options = {}) {
           title: 'Stock — "' + (args.query || 'browse') + '"',
           items,
           total: result.total != null ? result.total : assets.length,
-          has_more: !!result.hasMore
+          has_more: !!result.hasMore,
+          page: args.page || 1,
+          page_tool: 'search_stock_media',
+          next_args: result.hasMore
+            ? { ...args, page: (args.page || 1) + 1, ...(result.nextCursor ? { cursor: result.nextCursor } : {}) }
+            : undefined
         });
       }
 
@@ -172,7 +177,7 @@ function registerStockLibraryTools(server, client, options = {}) {
       // media.js and listResult() have always done it this way; these five lagged.
       {
         const collections = result.collections || [];
-        const items = collections.slice(0, 24).map((c) => ({
+        const items = collections.slice(0, 300).map((c) => ({
           id: c.id,
           title: c.title,
           subtitle: [c.kind, c.mediaType].filter(Boolean).join(' · '),

package/src/tools/visual_dna.js

@@ -154,7 +154,7 @@ function registerVisualDnaTools(server, client, options = {}) {
       return uiResult(UI.mediaGrid, text, {
         widget: 'media-grid',
         title: 'Visual DNA Profiles',
-        items: dnas.slice(0, 24).map(d => ({
+        items: dnas.map(d => ({
           id: d.id,
           title: d.name,
           subtitle: (d.dna_type || '') + (Array.isArray(d.tags) && d.tags.length ? ' · ' + d.tags.slice(0, 3).join(', ') : ''),
@@ -164,7 +164,12 @@ function registerVisualDnaTools(server, client, options = {}) {
           use_hint: 'Use Visual DNA "{TITLE}" (id: {ID}) in my next generation for character/style consistency.'
         })),
         total,
-        has_more: result.has_more || dnas.length > 24
+        has_more: !!result.has_more,
+        page: page && page > 0 ? Math.floor(page) : 1,
+        page_tool: 'list_visual_dnas',
+        next_args: result.has_more
+          ? { scope, search, collection, tags, project_id, page: (page && page > 0 ? Math.floor(page) : 1) + 1, limit }
+          : undefined
       });
     }
   );

package/src/tools/voices.js

@@ -99,7 +99,10 @@ function registerVoiceTools(server, client, options = {}) {
             use_hint: 'Use voice "{TITLE}" (voice_id: {ID}) for text-to-speech — ask me what text to speak.'
           })),
           total: voices.length,
-          has_more: more > 0
+          has_more: more > 0,
+          page: pageNum,
+          page_tool: 'list_voices',
+          next_args: more > 0 ? { language, gender, provider, page: pageNum + 1, limit: perPage } : undefined
         });
       }