@kolbo/mcp 1.28.1 → 1.30.0

package/src/tools/visual_dna.js

@@ -6,6 +6,7 @@
 const { z } = require('zod');
 const FormData = require('form-data');
 const { resolveToBuffer: sharedResolveToBuffer, VISUAL_DNA_MAX_BYTES } = require('./_shared');
+const { UI, uiResult, appsEnabled } = require('../apps');
 
 // Visual DNA caps reference media at 25MB per file (stricter than the
 // default _shared.resolveToBuffer cap — DNA profiles only need enough
@@ -14,7 +15,8 @@ function resolveToBuffer(source, kind) {
   return sharedResolveToBuffer(source, kind, { maxBytes: VISUAL_DNA_MAX_BYTES });
 }
 
-function registerVisualDnaTools(server, client) {
+function registerVisualDnaTools(server, client, options = {}) {
+  const ui = () => appsEnabled(server, options);
   // ─── create_visual_dna ─────────────────────────────────────
   server.tool(
     'create_visual_dna',
@@ -91,15 +93,30 @@ function registerVisualDnaTools(server, client) {
       if (tags) params.set('tags', tags);
       const qs = params.toString();
       const result = await client.get(`/v1/visual-dna${qs ? '?' + qs : ''}`);
-      return {
-        content: [{
-          type: 'text',
-          text: JSON.stringify({
-            visual_dnas: result.visual_dnas || [],
-            count: result.count || 0
-          }, null, 2)
-        }]
-      };
+      const dnas = result.visual_dnas || [];
+      const text = JSON.stringify({
+        visual_dnas: dnas,
+        count: result.count || 0
+      }, null, 2);
+
+      if (ui()) {
+        return uiResult(UI.mediaGrid, text, {
+          widget: 'media-grid',
+          title: 'Visual DNA Profiles',
+          items: dnas.slice(0, 24).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(', ') : ''),
+            thumbnail: d.thumbnail,
+            media_type: 'image',
+            use_hint: 'Use Visual DNA "{TITLE}" (id: {ID}) in my next generation for character/style consistency.'
+          })),
+          total: result.count || dnas.length,
+          has_more: dnas.length > 24
+        });
+      }
+
+      return { content: [{ type: 'text', text }] };
     }
   );
 

package/src/tools/voices.js

@@ -2,8 +2,10 @@
  * CONTRACT. Never rename, remove, or break an existing tool/arg. Full rules: ../index.js top-of-file. */
 
 const { z } = require('zod');
+const { UI, uiResult, appsEnabled } = require('../apps');
 
-function registerVoiceTools(server, client) {
+function registerVoiceTools(server, client, options = {}) {
+  const ui = () => appsEnabled(server, options);
   // ─── list_voices ──────────────────────────────────────────────
   server.tool(
     'list_voices',
@@ -36,12 +38,26 @@ function registerVoiceTools(server, client) {
         return `${v.voice_id} — ${v.name} (${v.provider})${v3}\n   ${tags}${styles}${v.description ? `\n   ${v.description}` : ''}`;
       });
 
-      return {
-        content: [{
-          type: 'text',
-          text: `Available voices (${voices.length}):\n\n${lines.join('\n\n')}\n\nUse the "voice_id" value in generate_speech calls.`
-        }]
-      };
+      const text = `Available voices (${voices.length}):\n\n${lines.join('\n\n')}\n\nUse the "voice_id" value in generate_speech calls.`;
+
+      if (ui()) {
+        return uiResult(UI.mediaGrid, text, {
+          widget: 'media-grid',
+          title: 'Voices',
+          items: voices.slice(0, 24).map(v => ({
+            id: v.voice_id,
+            title: v.name,
+            subtitle: [v.provider, v.language, v.gender, v.accent].filter(Boolean).join(' · '),
+            media_type: 'audio',
+            preview_audio: v.preview_url,
+            use_hint: 'Use voice "{TITLE}" (voice_id: {ID}) for text-to-speech — ask me what text to speak.'
+          })),
+          total: voices.length,
+          has_more: voices.length > 24
+        });
+      }
+
+      return { content: [{ type: 'text', text }] };
     }
   );
 }

package/skill/references/workflows/music-library.md

@@ -1,32 +0,0 @@
-# Music Library (stock / production music)
-
-The music library is Kolbo's catalog of **licensed, ready-made background tracks**. Use it to score a video, ad, or voiceover with an existing track.
-
-> **Library vs generation.** `search_music_library` finds an existing track. `generate_music` composes a brand-new song with Suno. If the user wants "a track for my ad", reach for the library first — it's free (no credits) and instant. Use `generate_music` only when they want something original/custom.
-
-## Tools
-
-| Tool | Use |
-|------|-----|
-| `search_music_library` | Keyword search + filters (genre, mood, bpm, duration, has_stems, has_lyrics) + sort. Returns tracks with id, title, artist, duration, BPM, key, genres, moods, preview URL. |
-| `analyze_script_for_music` | Turn a script/scene description into `{ query, mood, genre, keywords }`. |
-| `browse_music_library` | Paginated browse with no query. |
-| `get_music_library_facets` | Valid genres, moods, instruments + BPM/duration ranges. |
-| `get_music_track_audio` | A track's downloadable 128 / 320 / WAV URLs. |
-| `get_music_track_related` | Stems + alternate versions of a master track. |
-| `get_music_track_lyrics` | Lyrics text, theme, explicit flag. |
-
-All tools are **free** (no credits) and read-only.
-
-## Typical flow
-
-1. **From a script** → call `analyze_script_for_music` to derive `query` / `mood` / `genre`.
-2. **Search** → `search_music_library` with that query (+ optional filters). Show the user the top matches by title + vibe; include the `preview` URL so they can listen.
-3. **Pick** → once the user chooses, call `get_music_track_audio` with the track `id` to get the final downloadable URLs (offer WAV for editing, 320 for delivery).
-4. Optionally `get_music_track_related` for an instrumental/stems cut, or `get_music_track_lyrics` if it's a vocal track.
-
-## Tips
-
-- Don't dump every field — surface title, artist, duration, BPM, mood, and the preview link.
-- If a filtered search returns nothing, call `get_music_library_facets` to use exact valid genre/mood values, then retry.
-- `sort` options: `duration-asc`, `duration-desc`, `bpm-asc`, `bpm-desc`, `title`. Omit for relevance order.