@kolbo/mcp 1.79.6 → 1.80.0

package/src/tools/presets.js

@@ -12,55 +12,56 @@ function registerPresetTools(server, client, options = {}) {
   // ─── list_presets ──────────────────────────────────────────
   server.tool(
     'list_presets',
-    'List generation presets across image, image-editing, video, music, and text-to-video catalogs. Use this BEFORE generating whenever the user requests a preset, names a preset, or asks to use one of their/Kolbo presets. Resolve the requested name or choose the closest match from the correct `type`, then pass the returned exact `id` as `preset_id` on the generation tool. Never claim a preset was used unless that id is passed. Returns id, name, description, thumbnail, category, and (for music) audio preview URL.',
+    'Resolve a generation preset and pass its exact id as preset_id. ALWAYS pass `search` when you already know the name (headless, bible, character sheet, a user preset) — that is a silent id lookup, not a catalog to show the user. Omit search only when they asked to browse. Custom instructions live on the preset, so prefer generate_image + preset_id over generate_character_sheet. Never invent an id.',
     {
-      type: z.string().optional().describe('Filter by catalog: "image" | "image_edit" | "video" | "music" | "text_to_video". Omit for all.')
+      type: z.string().optional().describe('Filter by catalog: "image" | "image_edit" | "video" | "music" | "text_to_video". Omit for all.'),
+      search: z.string().optional().describe('Name lookup, e.g. "headless", "bible", "character sheet". Required when resolving a named sheet/style — do not list the whole catalog.')
     },
-    async ({ type }) => {
+    async ({ type, search }) => {
       const params = new URLSearchParams();
       if (type) params.set('type', type);
+      if (search) params.set('search', search);
       const qs = params.toString();
       const result = await client.get(`/v1/presets${qs ? '?' + qs : ''}`);
 
-      const presets = result.presets || [];
-      // Full catalog measured 632,919 chars — the single biggest payload in the
-      // tool surface. The model only needs enough to pick a preset_id.
+      let presets = result.presets || [];
+      if (search && !result.search) {
+        const q = search.toLowerCase();
+        presets = presets.filter((p) => `${p.name || ''} ${p.description || ''} ${p.category || ''}`.toLowerCase().includes(q));
+      }
+      const lookup = Boolean(search);
+      // Full catalog measured 632,919 chars. A named lookup should return a handful of rows.
       const text = compactList(presets, {
         fields: ['id', 'name', 'category', 'type', 'description'],
-        cap: 60,
+        cap: lookup ? 8 : 12,
         total: result.count || presets.length,
-        extra: result.warning ? { warning: result.warning } : undefined,
-        note: 'Filter with `type` (image | image_edit | video | music | text_to_video) to see a focused set. Pass the chosen exact id as `preset_id` on the next generation call.',
+        extra: {
+          ...(result.warning ? { warning: result.warning } : {}),
+          ...(lookup ? { _lookup: true } : {}),
+        },
+        note: lookup
+          ? 'Pick the closest id and pass it as preset_id. Do not show this list to the user.'
+          : 'Pass search next time if you already know the name. Pass the chosen exact id as preset_id.',
       });
 
-      // Ship structuredContent UNCONDITIONALLY. Gating on ui() left every host that
-      // renders widgets without advertising MCP Apps (Kolbo Code) with text-only rows
-      // that carry no thumbnail field at all — and its BY_TOOL map still force-mounts
-      // 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.
-      {
-        return uiResult(UI.mediaGrid, text, {
-          widget: 'media-grid',
-          title: 'Presets' + (type ? ' — ' + type : ''),
-          items: presets.slice(0, 24).map(p => ({
-            id: p.id,
-            title: p.name,
-            subtitle: p.category,
-            // API returns thumbnail_url / audio_url (see sdk listPresets) — NOT
-            // thumbnail / audio_preview_url. Reading the wrong key rendered every
-            // preset as a blank tile and dropped music previews entirely.
-            thumbnail: p.thumbnail_url || p.thumbnail,
-            media_type: p.audio_url ? 'audio' : 'image',
-            preview_audio: p.audio_url,
-            url: p.thumbnail_url || p.thumbnail,
-            use_hint: 'Use preset "{TITLE}" (preset_id: {ID}) for my next generation — ask me for the prompt.'
-          })),
-          total: result.count || presets.length,
-          has_more: presets.length > 24
-        });
-      }
+      if (lookup) return { content: [{ type: 'text', text }] };
 
-      return { content: [{ type: 'text', text }] };
+      return uiResult(UI.list, text, {
+        widget: 'list',
+        title: 'Presets' + (type ? ' — ' + type : ''),
+        items: presets.slice(0, 8).map(p => ({
+          id: p.id,
+          title: p.name,
+          subtitle: p.category,
+          thumbnail: p.thumbnail_url || p.thumbnail,
+          media_type: p.audio_url ? 'audio' : 'image',
+          preview_audio: p.audio_url,
+          url: p.thumbnail_url || p.thumbnail,
+          use_hint: 'Use preset "{TITLE}" (preset_id: {ID}) for my next generation — ask me for the prompt.'
+        })),
+        total: result.count || presets.length,
+        has_more: presets.length > 8
+      });
     }
   );
 

package/src/tools/visual_dna.js

@@ -153,7 +153,8 @@ function registerVisualDnaTools(server, client, options = {}) {
           id: d.id,
           title: d.name,
           subtitle: (d.dna_type || '') + (Array.isArray(d.tags) && d.tags.length ? ' · ' + d.tags.slice(0, 3).join(', ') : ''),
-          thumbnail: d.thumbnail_url || d.thumbnail,
+          thumbnail: d.sheet_url || d.thumbnail_url || d.thumbnail,
+          url: d.sheet_url || d.thumbnail_url || d.thumbnail,
           media_type: 'image',
           use_hint: 'Use Visual DNA "{TITLE}" (id: {ID}) in my next generation for character/style consistency.'
         })),
@@ -210,15 +211,22 @@ function registerVisualDnaTools(server, client, options = {}) {
     'STANDARD FIRST STEP OF THE ASSET PASS for any film/ad/scene: inventory the characters, locations and props the script needs, generate a sheet for each, create its Visual DNA from that sheet, confirm the whole set with the user, and only THEN generate video. Sheets for cinematic environments and invented characters run well on `mirage-film-2` (3cr); use `nano-banana-2` (10cr) or `gpt-image-2` (12cr) when reference fidelity or legible text matters. Generate a reference sheet for a Visual DNA from 1+ reference image URLs — the same step the in-app Visual DNA wizard offers, for EVERY DNA type via `sheet_type`: character = multi-angle turnaround, product = angles + branding/material/construction close-ups, environment = location angles + one signature detail, style = a style board (the same look applied to six varied subjects). The sheet is the single strongest consistency booster for a DNA, and it always preserves the reference\'s original art style (2D stays 2D, photo stays photo). CHARGES CREDITS, so when the user is about to create a DNA, OFFER this first ("want me to generate a reference sheet for stronger consistency? it costs a few credits") and only run it on a yes. Returns `character_sheet_url` — pass it as `character_sheet_url` to `create_visual_dna` with the matching `dna_type`.',
     {
       image_urls: z.array(z.string()).min(1).describe('Reference image URLs of the subject (for characters: front/side/varied angles work best). Use generated-image URLs or upload_media output.'),
-      sheet_type: z.enum(['character', 'character_headless', 'character_bible', 'product', 'environment', 'style']).optional().describe('Sheet layout. character = front/back/face turnaround. character_headless = wardrobe/body refs with a headless front panel (use when clothing must change without fighting the face sheet). character_bible = denser production model-sheet (turnaround + faces + wardrobe + color swatches). product / environment / style = matching DNA types. Defaults to character.')
+      sheet_type: z.enum(['character', 'character_headless', 'character_bible', 'product', 'environment', 'style']).optional().describe('Sheet layout. character = front/back/face turnaround. character_headless = wardrobe/body refs with a headless front panel (use when clothing must change without fighting the face sheet). character_bible = denser production model-sheet (turnaround + faces + wardrobe + color swatches). product / environment / style = matching DNA types. Defaults to character. This IS the Character Sheet / Headless / Bible preset — do not call list_presets for those names.'),
+      model: z.string().optional().describe('Image model for the sheet. Default nano-banana-2. Pass gpt-image-2 when the user names it.'),
+      resolution: z.enum(['2K', '4K']).optional().describe('Sheet resolution. 2K or 4K only — never 1K. Default 2K. Use 4K for character_bible, high-detail leads, or when the user asks.')
     },
-    async ({ image_urls, sheet_type }) => {
+    async ({ image_urls, sheet_type, model, resolution }) => {
       // The endpoint is blocking and a 2K multi-panel sheet routinely runs past the
       // 120s default: the MCP aborted while kolbo-api kept going, finished, and
       // billed — the user saw "Failed" for a sheet they had already paid for.
       const result = await client.post(
         '/v1/visual-dna/character-sheet',
-        { image_urls, ...(sheet_type ? { sheet_type } : {}) },
+        {
+          image_urls,
+          ...(sheet_type ? { sheet_type } : {}),
+          ...(model ? { model } : {}),
+          ...(resolution ? { resolution } : {}),
+        },
         { timeoutMs: CHARACTER_SHEET_TIMEOUT_MS },
       );
       // `urls` is NOT redundant with character_sheet_url. Every generation-card