@kolbo/mcp 1.114.2 → 1.116.0

package/README.md

@@ -148,7 +148,7 @@ Without the optional skill, the config block alone already exposes every tool
 | `generate_creative_director` | One brief → N coordinated scenes (image or video) |
 | `generate_music` | Text (+ optional lyrics) → song. Style, title, negative tags, length, and Suno fine-controls (style weight, weirdness, audio weight, persona / singing voice) |
 | `generate_speech` | Text + voice → spoken audio. `eleven_model` (eleven_v4 / eleven_v3 / eleven_multilingual_v2) picks which ElevenLabs model speaks an ElevenLabs voice (stock or own clone; omit = the voice's default; same price; `turbo` needs v4). Full expressive/style control: Google/Gemini named voice-direction presets (`style_instructions_preset_id`: warm/dramatic/whisper/…) or free-form `style_instructions`, preset styles + emotions (DeepDub / MiniMax / Cartesia), speed, accent/`language`, and per-provider voice settings (ElevenLabs stability/similarity/style/speaker boost/seed, `enforce_language`, `output_format` mp3/wav, `text_normalization`; DeepDub accent/variance/tempo, MiniMax pitch/volume/intensity/timbre), plus `audio_effect` (phone/radio/megaphone/small_room/hall/distant) + `audio_effect_strength` for any voice at no extra credits. Status returns the same fields for reuse. |
-| `generate_sound` | Text → sound effect. Duration, prompt influence, and per-provider controls (Stable Audio guidance, Kie loop/tempo/key, Seed-Audio voice/speed/volume/pitch + reference audio/image) |
+| `generate_sound` | Text → sound effect. Duration, prompt influence, and per-provider controls (Stable Audio guidance, Kie loop/tempo/key, Seed-Audio voice/speed/volume/pitch + reference audio/image, output format, Mirelo SFX 2.0 negative prompt / variations / seed / bitrate) |
 | `generate_3d` | Text or reference images → 3D model (GLB/FBX/OBJ/USDZ) |
 | `transcribe_audio` | Audio/video URL or file → text + SRT subtitles. Language, speaker diarization, audio-event tagging, and SRT formatting (words/line, lines/subtitle, caption stretch) |
 | `separate_audio_stems` | Audio/video URL (or a Kolbo `generation_id`) → Dialogue / Music / Effects / without-dialogue (M&E) layers. Kolbo's own masking pipeline with a speech classifier on top, so a centred engine or ambience is not handed back mislabelled as dialogue. 5 credits, runs inline |

package/package.json

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

package/src/apps/widgets/plans.js

@@ -24,7 +24,11 @@ const { widgetPage } = require('../html');
  *   plans:        [{ key, name, interval, credits, price, original_price,
  *                    discount_percent, promo_text, currency, top_up_discount }],
  *   credit_packs: [{ …, subscriber_price, is_subscriber }],
- *   pricing_url
+ *   pricing_url,
+ *   // insufficient_credits only — leads the card (packs out-convert plans
+ *   // for users who just ran out); every URL carries MCP attribution tags:
+ *   recommended_pack: { …pack, covers_shortfall, url } | null,
+ *   pack_url, home_url
  * }
  */
 
@@ -52,11 +56,15 @@ var state = null;
 var interval = 'month';
 
 el('logo').innerHTML = KOLBO_LOGO + '<span>Kolbo</span>';
-el('kolbo-link').onclick = function (e) { e.preventDefault(); window.kolbo.openLink('https://app.kolbo.ai'); };
+function homeUrl() { return (state && state.home_url) || 'https://app.kolbo.ai'; }
+el('kolbo-link').onclick = function (e) { e.preventDefault(); window.kolbo.openLink(homeUrl()); };
+// Own handler so the shared untagged logo link (html.js) never fires here.
+el('logo').onclick = function (e) { e.stopPropagation(); window.kolbo.openLink(homeUrl()); };
 
 function pricingUrl() {
   return (state && state.pricing_url) || 'https://app.kolbo.ai/pricing';
 }
+function packUrl() { return (state && state.pack_url) || pricingUrl(); }
 function money(v, currency) {
   if (v == null || isNaN(v)) return '';
   var sym = { usd: '$', eur: '\u20ac', gbp: '\u00a3', ils: '\u20aa' }[String(currency || 'usd').toLowerCase()] || '';
@@ -76,7 +84,9 @@ function planCard(p, opts) {
   var note = p.promo_text ? '<div class="k-plan-note">' + esc(p.promo_text) + '</div>'
     : (opts.pack && p.is_subscriber && p.subscriber_price != null ? '<div class="k-plan-note">Subscriber price applied</div>' : '')
       + (!opts.pack && p.top_up_discount ? '<div class="k-plan-note">Cheaper credit packs included</div>' : '');
-  var cta = current ? '' : '<button class="k-btn ' + (opts.pack ? 'ghost' : 'primary') + '" data-open="1">' + (opts.pack ? 'Buy pack' : 'Upgrade') + ' ' + ICONS.open + '</button>';
+  if (opts.lead) note += '<div class="k-plan-note">One-time top-up, no subscription</div>';
+  var primary = opts.pack ? opts.lead : !state.recommended_pack;
+  var cta = current ? '' : '<button class="k-btn ' + (primary ? 'primary' : 'ghost') + '" data-open="' + (opts.pack ? 'pack' : 'plan') + '">' + (opts.pack ? 'Buy pack' : 'Upgrade') + ' ' + ICONS.open + '</button>';
   return '<div class="k-plan' + (current ? ' current' : '') + '">' +
     '<div class="k-plan-top"><span class="k-plan-name">' + esc(p.name || p.key || 'Plan') + '</span>' + badge + '</div>' +
     (p.credits != null ? '<div class="k-plan-credits">' + ICONS.sparkle + ' ' + esc(fmtCredits(p.credits)) + ' credits' + (opts.pack ? '' : ' / ' + (isAnnual(p) ? 'year' : 'month')) + '</div>' : '') +
@@ -85,12 +95,17 @@ function planCard(p, opts) {
 
 function renderStage() {
   var plans = (state.plans || []).filter(function (p) { return p && (p.price != null || p.credits != null); });
-  var packs = (state.credit_packs || []).filter(function (p) { return p && p.price != null; });
+  var lead = state.recommended_pack;
+  var packs = (state.credit_packs || []).filter(function (p) { return p && p.price != null && !(lead && lead.key != null && p.key === lead.key); });
   var monthly = plans.filter(function (p) { return !isAnnual(p); });
   var annual = plans.filter(isAnnual);
   var hasToggle = monthly.length && annual.length;
   var shown = hasToggle ? (interval === 'year' ? annual : monthly) : plans;
   var html = '';
+  if (lead) {
+    html += '<div class="k-pack-head">Quickest fix</div><div class="k-plan-grid">' + planCard(lead, { pack: true, lead: true }) + '</div>' +
+      '<div class="k-pack-head">Or upgrade your plan</div>';
+  }
   if (hasToggle) {
     html += '<div class="k-plan-toggle">' +
       '<button class="k-toggle-btn' + (interval === 'month' ? ' active' : '') + '" data-interval="month">Monthly</button>' +
@@ -98,7 +113,7 @@ function renderStage() {
   }
   if (shown.length) html += '<div class="k-plan-grid">' + shown.map(function (p) { return planCard(p, {}); }).join('') + '</div>';
   if (packs.length) {
-    html += '<div class="k-pack-head">Credit packs</div><div class="k-plan-grid">' +
+    html += '<div class="k-pack-head">' + (lead ? 'Other credit packs' : 'Credit packs') + '</div><div class="k-plan-grid">' +
       packs.map(function (p) { return planCard(p, { pack: true }); }).join('') + '</div>';
   }
   if (!html) html = '<div class="k-plan-note">Live plans and prices are on the Kolbo pricing page.</div>';
@@ -106,7 +121,7 @@ function renderStage() {
   var btns = el('stage').querySelectorAll('[data-interval]');
   for (var i = 0; i < btns.length; i++) btns[i].onclick = function () { interval = this.getAttribute('data-interval'); renderStage(); window.kolbo.notifySize(); };
   var opens = el('stage').querySelectorAll('[data-open]');
-  for (var j = 0; j < opens.length; j++) opens[j].onclick = function () { window.kolbo.openLink(pricingUrl()); };
+  for (var j = 0; j < opens.length; j++) opens[j].onclick = function () { window.kolbo.openLink(this.getAttribute('data-open') === 'pack' ? packUrl() : pricingUrl()); };
 }
 
 function boot(sc) {

package/src/tools/_shared.js

@@ -1163,12 +1163,44 @@ function compactList(items, { fields, cap = 50, total, extra, note, maxChars = M
   return text;
 }
 
+// Every link out of the out-of-credits card carries the same tags so MCP
+// purchases are attributable. kolbo-map's /pricing reads only `category`
+// (month | annual | one_time) — no per-pack preselect exists, so the pack link
+// lands on the credit-pack tab.
+function upgradeCardUrl(path, content, query = {}) {
+  const url = new URL(path, APP_BASE_URL);
+  const params = {
+    ...query,
+    utm_source: 'mcp',
+    utm_medium: 'upgrade_card',
+    utm_campaign: 'out_of_credits',
+    utm_content: content,
+    // kolbo-map's stable funnel-join fields (ANALYTICS_ATTRIBUTION_KEYS).
+    attribution_link_id: `mcp_upgrade_card_${content}`,
+    attribution_trigger: 'mcp_insufficient_credits',
+    upgrade_entry: 'mcp_upgrade_card',
+  };
+  for (const [k, v] of Object.entries(params)) url.searchParams.set(k, v);
+  return url.toString();
+}
+
+// Smallest pack that covers the shortfall; the largest when none does; the
+// smallest when the shortfall is unknown.
+function packForShortfall(packs, shortfall) {
+  const sized = (packs || [])
+    .filter((p) => p && Number.isFinite(p.credits) && p.price != null)
+    .sort((a, b) => a.credits - b.credits);
+  if (!sized.length) return null;
+  return sized.find((p) => !(shortfall > 0) || p.credits >= shortfall) || sized[sized.length - 1];
+}
+
 /**
  * Turn a 403 INSUFFICIENT_CREDITS into the plans/upgrade card.
  *
  * Without this the user just sees the raw API sentence and has to go find the
- * pricing page themselves. The card states the shortfall, shows live
- * promo-adjusted plans, and links to app.kolbo.ai/pricing.
+ * pricing page themselves. The card states the shortfall, leads with the
+ * credit pack that covers it, shows live promo-adjusted plans below, and links
+ * to app.kolbo.ai/pricing with MCP attribution tags.
  *
  * Returns null for any other error so callers can rethrow untouched. The plan
  * fetch is best-effort: if it fails we still return a card carrying the
@@ -1209,30 +1241,56 @@ async function insufficientCreditsResult(client, err, options = {}) {
 
   const balance = err.data?.balance ?? data?.credits?.total;
   const required = err.data?.required;
+  const shortfall = (Number.isFinite(balance) && Number.isFinite(required))
+    ? Math.max(0, required - balance) : undefined;
+  const credit_packs = data?.credit_packs || [];
+  const pack = packForShortfall(credit_packs, shortfall);
+  const pack_url = upgradeCardUrl('/pricing', 'credit_pack', { category: 'one_time' });
   const structured = {
     widget: 'plans',
     reason: 'insufficient_credits',
     balance,
     required,
-    shortfall: (Number.isFinite(balance) && Number.isFinite(required))
-      ? Math.max(0, required - balance) : undefined,
+    shortfall,
     current_plan: data?.current_plan || null,
+    // Leads the card: out of credits on the web app, packs convert 56% vs
+    // plans 17.5%. Plans stay below as the alternative.
+    recommended_pack: pack ? {
+      ...pack,
+      // Only when the shortfall is known (and `required` is the API's lower
+      // bound, so this is a floor, not a promise).
+      covers_shortfall: shortfall > 0 && pack.credits >= shortfall,
+      url: pack_url,
+    } : null,
     plans: data?.plans || [],
-    credit_packs: data?.credit_packs || [],
-    pricing_url: err.data?.pricing_url || data?.pricing_url || 'https://app.kolbo.ai/pricing',
+    credit_packs,
+    // MCP-tagged, not the API's sdk-tagged link: every way out of this card
+    // must be attributable to it.
+    pricing_url: upgradeCardUrl('/pricing', 'plans'),
+    pack_url,
+    home_url: upgradeCardUrl('/', 'home'),
   };
 
   // structuredContent shadows the text on widget hosts, so the refusal reason
   // has to be inside the object too — an agent that only reads structured
   // content must still understand that nothing was generated.
   structured.error = err.message;
-  structured._hint = 'The generation did NOT run and nothing was charged. An upgrade card is shown to the user. Tell them they are out of credits and point at the card; do not retry the generation, and do not attempt to purchase anything for them.';
+  structured._hint = 'The generation did NOT run and nothing was charged. An upgrade card is shown to the user. Tell them they are out of credits and point at the card; '
+    + (pack ? 'the quickest fix is the one-time credit pack it leads with (recommended_pack), with plans as the alternative; ' : '')
+    + 'do not retry the generation, and do not attempt to purchase anything for them.';
 
   const text = JSON.stringify({
     error: err.message,
     code: 'INSUFFICIENT_CREDITS',
     balance,
     required,
+    recommended_pack: structured.recommended_pack && {
+      name: pack.name,
+      credits: pack.credits,
+      price: pack.price,
+      currency: pack.currency,
+      url: pack_url,
+    },
     pricing_url: structured.pricing_url,
     _hint: structured._hint,
   }, null, 2);

package/src/tools/generate.js

@@ -1234,7 +1234,7 @@ function registerGenerateTools(server, client, options = {}) {
   // ─── generate_sound ────────────────────────────────────────
   server.tool(
     'generate_sound',
-    'Generate sound effects (not music, not speech) from a text description using Kolbo AI. Use this for ambient sounds, foley, impacts, atmospheres, UI sounds, etc. For music use generate_music; for voice use generate_speech. Beyond the core prompt/duration, per-provider controls are available (Stable Audio guidance, Kie loop/tempo/key, Seed-Audio voice/speed/volume/pitch + reference audio/image); the engine ignores controls that do not apply to the chosen model. Returns the final audio URL when complete.',
+    'Generate sound effects (not music, not speech) from a text description using Kolbo AI. Use this for ambient sounds, foley, impacts, atmospheres, UI sounds, etc. For music use generate_music; for voice use generate_speech. Beyond the core prompt/duration, per-provider controls are available (Stable Audio guidance, Kie loop/tempo/key, Seed-Audio voice/speed/volume/pitch + reference audio/image, output audio_format, and Mirelo SFX 2.0 negative_prompt / num_samples / seed / audio_bitrate_kbps); the engine ignores controls that do not apply to the chosen model. Mirelo SFX 2.0 (model "mirelo-ai/sfx2.0/text-to-audio") makes up to 10 minutes of layered sound design and up to 4 variations per call (each variation is billed). Returns the final audio URL(s) when complete.',
     {
       prompt: z.string().describe('Text description of the sound effect (e.g., "thunder clap with rain", "door creaking open", "futuristic UI beep")'),
       model: z.string().optional().describe('Model identifier. Use list_models type="text_to_sound" to see options. Default: elevenlabs-sound-effects-v1'),
@@ -1253,21 +1253,30 @@ function registerGenerateTools(server, client, options = {}) {
       seed_pitch: z.number().optional().describe('FAL Seed-Audio: pitch shift in semitones.'),
       seed_reference_audio_urls: z.array(z.string()).optional().describe('FAL Seed-Audio: up to 3 reference audio URLs to condition the sound.'),
       seed_reference_image_url: z.string().optional().describe('FAL Seed-Audio: a reference image URL to condition the sound.'),
+      // ── Output format (models whose list_models entry has output_audio_formats) ──
+      audio_format: z.enum(['wav', 'mp3', 'aac', 'flac']).optional().describe('Output audio container/codec, for models that advertise output_audio_formats in list_models (Sonilo, Mirelo SFX 2.0).'),
+      // ── Mirelo SFX 2.0 (list_models: max_samples / supports_negative_prompt / supports_seed / supports_audio_bitrate) ──
+      negative_prompt: z.string().max(1000).optional().describe('Mirelo SFX 2.0: sounds to keep OUT of the result, e.g. "music, speech".'),
+      num_samples: z.number().int().min(1).max(4).optional().describe('Mirelo SFX 2.0: number of variations (1-4, default 1). Each variation is billed; all URLs are returned.'),
+      seed: z.number().int().min(-1).optional().describe('Mirelo SFX 2.0: seed for repeatable results (-1 or omit = random).'),
+      audio_bitrate_kbps: z.number().int().optional().describe('Mirelo SFX 2.0: bitrate for mp3 (32,40,48,56,64,80,96,112,128,160,192,224,256,320) or aac (32-256). Not allowed with wav/flac.'),
       project_id: projectIdField,
       session_id: sessionIdField
     },
-    async ({ prompt, model, duration, prompt_influence, cfg_strength, sound_loop, sound_tempo, sound_key, seed_voice, seed_speed, seed_volume, seed_pitch, seed_reference_audio_urls, seed_reference_image_url, project_id, session_id }) => {
+    async ({ prompt, model, duration, prompt_influence, cfg_strength, sound_loop, sound_tempo, sound_key, seed_voice, seed_speed, seed_volume, seed_pitch, seed_reference_audio_urls, seed_reference_image_url, audio_format, negative_prompt, num_samples, seed, audio_bitrate_kbps, project_id, session_id }) => {
       model = await canonicalModelId(client, model, 'text_to_sound'); // lenient id resolution ("z-image" → "z-image/turbo")
       const gen = await client.post('/v1/generate/sound', {
         prompt, model, duration, prompt_influence,
         cfg_strength, sound_loop, sound_tempo, sound_key,
         seed_voice, seed_speed, seed_volume, seed_pitch,
-        seed_reference_audio_urls, seed_reference_image_url, project_id, session_id
+        seed_reference_audio_urls, seed_reference_image_url,
+        audio_format, negative_prompt, num_samples, seed, audio_bitrate_kbps,
+        project_id, session_id
       });
 
       if (returnsImmediately()) return submittedResult({
         tool: 'generate_sound', kind: 'audio', gen, client, model, prompt,
-        settings: { duration },
+        settings: { duration, ...(num_samples > 1 && { variations: num_samples }) },
         reference_images: seed_reference_image_url ? [seed_reference_image_url] : []
       });
 
@@ -1280,7 +1289,7 @@ function registerGenerateTools(server, client, options = {}) {
 
       return uiCompleted({
         tool: 'generate_sound', kind: 'audio', gen, client, model, prompt,
-        settings: { duration },
+        settings: { duration, ...(num_samples > 1 && { variations: num_samples }) },
         reference_images: seed_reference_image_url ? [seed_reference_image_url] : [],
         urls: result.result.urls,
         playback_urls: result.result.playback_urls,
@@ -2391,6 +2400,10 @@ function registerGenerateTools(server, client, options = {}) {
   const editDetails = (op, a) => {
     const d = [];
     const has = (v) => v !== undefined && v !== null && v !== '';
+    if (op === 'generate_audio') {
+      if (a.num_samples > 1) d.push(`${a.num_samples} variations`);
+      if (a.preserve_speech === false) d.push('no dialogue');
+    }
     if (op === 'upscale' || op === 'split_upscale') {
       if (has(a.scale)) d.push(`${a.scale}×`);
       if (a.face_enhancement === false) d.push('no face enhance');
@@ -2678,7 +2691,7 @@ function registerGenerateTools(server, client, options = {}) {
         '"draft_quote" — check a saved draft’s supported final resolutions, expiry and exact credit cost without starting a render. Use this before draft_enhance.',
         '"upscale" — boost to 4K/2K resolution (use `scale` for factor, `resolution` for target, `target_fps` for frame rate). On model "blackforestlabs/flux-video-upscale" (Flux Video Upscale): `scale` is 1.5-3x (no named `resolution` target — billed on the OUTPUT tier it lands in), `mode` is "precise" (source-faithful, default) or "creative" (reimagines detail — a pricier tier), and `prompt` optionally guides the creative-mode enhancement. On model "bytedance-upscaler/upscale/video" (Bytedance Upscaler): `resolution` is "1080p" | "2k" | "4k" | "6k" | "8k" (OR `scale_ratio` 1.1-10, output ≤4K), plus `target_fps` (24-120), `enhancement_tier`, `enhancement_preset`, `fidelity`, `bit_depth` — see each field. Price = resolution tier (1080p 1 · 2k 2 · 4k 4 · 6k 8 · 8k 16 credits/s) × every started 30 fps (60 = 2×, 120 = 4×) × tier (fast 0.5×, pro 10×). Source-length caps: 6K 120s, 8K 60s, Pro 30s, otherwise 300s.',
         '"reframe" — change aspect ratio (requires `aspect_ratio`; use `grid_position_x`/`grid_position_y` to control where the original sits).',
-        '"generate_audio" — add AI-generated audio from `prompt`. Optionally split into `sound_effect_prompt` and `background_music_prompt`. Set `original_sound=true` to keep original audio alongside.',
+        '"generate_audio" — add AI-generated audio from `prompt`. Optionally split into `sound_effect_prompt` and `background_music_prompt`. Set `original_sound=true` to keep original audio alongside. On model "mirelo-ai/sfx2.0/video-to-video" (Mirelo SFX 2.0) the prompt is optional (it watches the clip and builds a full synced sound design, up to 10 minutes): `preserve_speech` keeps the dialogue (default true), `negative_prompt` keeps sounds out, `num_samples` returns 1-4 variations (each billed), `seed` repeats a result, and `duration` makes a shorter soundtrack by TRIMMING the video (omit for the whole clip).',
         '"remove_watermark" — AI-powered watermark removal.',
         '"face_swap" — replace the face in the video with the face from `image_url` (required).',
         '"extend" — lengthen the video at `mode` ("start" or "end") by `duration` seconds. Optional `prompt` and `context` guide the generated content.',
@@ -2742,6 +2755,15 @@ function registerGenerateTools(server, client, options = {}) {
         prompt: z.string()
       })).optional()
         .describe('Optional contiguous Sonilo sound-design ranges. The first start must be 0, each end must equal the next start, and the final end must not exceed the video duration. Omit to let Sonilo detect scenes automatically.'),
+      // Mirelo SFX 2.0 (list_models: max_samples / supports_negative_prompt / supports_seed / supports_preserve_speech)
+      negative_prompt: z.string().max(1000).optional()
+        .describe('Mirelo SFX 2.0 (operation="generate_audio"): sounds to keep out, as a short comma-separated list, e.g. "music, crowd noise".'),
+      preserve_speech: z.boolean().optional()
+        .describe('Mirelo SFX 2.0 (operation="generate_audio"): true (default) keeps the dialogue and builds the soundtrack around it; false makes sound effects only and suppresses speech.'),
+      num_samples: z.number().int().min(1).max(4).optional()
+        .describe('Mirelo SFX 2.0 (operation="generate_audio"): number of variations, 1-4 (default 1). Each is billed; all result URLs are returned.'),
+      seed: z.number().int().min(-1).optional()
+        .describe('Mirelo SFX 2.0 (operation="generate_audio"): seed for repeatable results (-1 or omit = random).'),
 
       // ── face_swap ──────────────────────────────────────────
       image_url: z.string().optional()
@@ -2749,7 +2771,7 @@ function registerGenerateTools(server, client, options = {}) {
 
       // ── extend ─────────────────────────────────────────────
       duration: z.number().optional()
-        .describe('Seconds of content to generate. Used with "extend" (required) and "retake" (optional). Typical range: 1–20.'),
+        .describe('Seconds of content to generate. Used with "extend" (required) and "retake" (optional). Typical range: 1–20. With "generate_audio" on Mirelo SFX 2.0: seconds of sound (1-600) — the returned video is TRIMMED to this length; omit for the whole clip.'),
       mode: z.string().optional()
         .describe('Extension direction: "start" or "end". Used with "extend". For "retake": replacement mode (default: "replace_audio_and_video"). For "upscale" on model "blackforestlabs/flux-video-upscale": "precise" (source-faithful, default) or "creative" (reimagines detail — pricier). Default: "end".'),
       context: z.string().optional()
@@ -2790,6 +2812,7 @@ function registerGenerateTools(server, client, options = {}) {
       grid_position_x, grid_position_y,
       sound_effect_prompt, background_music_prompt, original_sound, cfg_strength,
       audio_format, segments,
+      negative_prompt, preserve_speech, num_samples, seed,
       refine_edges, subject_is_person,
       text_prompt, context,
       mask_video_url, object_prompt, video_strength,
@@ -2806,7 +2829,7 @@ function registerGenerateTools(server, client, options = {}) {
       // Validation
       if (operation === 'magic_edit'    && !prompt)      throw new Error('prompt is required for magic_edit');
       if (operation === 'generate_audio' && !prompt && !sound_effect_prompt && !background_music_prompt
-          && !(typeof model === 'string' && model.includes('sonilo'))) {
+          && !(typeof model === 'string' && (model.includes('sonilo') || model.includes('mirelo')))) {
         throw new Error('prompt is required for generate_audio unless dedicated sound/music prompts are provided or the selected model supports automatic captioning');
       }
       if (operation === 'reframe'       && !aspect_ratio)throw new Error('aspect_ratio is required for reframe');
@@ -2824,6 +2847,7 @@ function registerGenerateTools(server, client, options = {}) {
         grid_position_x, grid_position_y,
         sound_effect_prompt, background_music_prompt, original_sound, cfg_strength,
         audio_format, segments,
+        negative_prompt, preserve_speech, num_samples, seed,
         refine_edges, subject_is_person,
         text_prompt, context,
         mask_video_url, object_prompt, video_strength,
@@ -2840,7 +2864,7 @@ function registerGenerateTools(server, client, options = {}) {
       if (operation === 'draft_quote') return { content: [{ type: 'text', text: JSON.stringify(gen, null, 2) }] };
       const cardSettings = {
         mode: operation, duration, aspect_ratio, resolution,
-        details: editDetails(operation, { scale, enhancement_model, target_fps, mode, enhancement_tier, enhancement_preset, bit_depth, scale_ratio }),
+        details: editDetails(operation, { scale, enhancement_model, target_fps, mode, enhancement_tier, enhancement_preset, bit_depth, scale_ratio, num_samples, preserve_speech }),
       };
       if (returnsImmediately()) return submittedResult({
         tool: 'edit_video', kind: 'video', gen, client, model,