@kolbo/mcp 1.56.0 → 1.57.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolbo/mcp",
-  "version": "1.56.0",
+  "version": "1.57.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/index.js

@@ -69,12 +69,19 @@ const WIDGET_CSP = {
     'https://fonts.googleapis.com',             // Inter / JetBrains Mono stylesheet
     'https://fonts.gstatic.com',                // font files
     'https://images.pexels.com',                // stock thumbnails
+    'https://images.unsplash.com',              // stock thumbnails (Unsplash)
+    'https://plus.unsplash.com',                // Unsplash+ premium images
+    'https://cdn.coverr.co',                    // Coverr video thumbnails
+    'https://cdn.freesound.org',                // Freesound waveform previews
     // Wildcards as a second layer for hosts that do support them.
     'https://*.kolbo.ai',
     'https://*.digitaloceanspaces.com',
     'https://*.cdn.digitaloceanspaces.com',
     'https://*.pexels.com',
     'https://*.pixabay.com',
+    'https://*.unsplash.com',
+    'https://*.coverr.co',
+    'https://*.freesound.org',
     'https://*.sketchfab.com',
     'https://*.cloudfront.net',
   ],

package/src/apps/theme.js

@@ -83,6 +83,12 @@ body {
 .k-body { padding: 14px 16px; }
 .k-prompt { color: var(--text-muted); font-size: 12.5px; margin-bottom: 10px; word-break: break-word;
   display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; }
+.k-prompt.k-clamped, .k-caption.k-clamped { cursor: pointer; }
+.k-prompt.expanded { -webkit-line-clamp: unset; }
+/* Single-line media caption (scene / batch prompt under the viewer) */
+.k-caption { font-size: 11px; color: var(--text-faint); margin: 2px 2px 0;
+  white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.k-caption.expanded { white-space: normal; word-break: break-word; }
 
 /* ---- Chips ---- */
 .k-chips { display: flex; flex-wrap: wrap; gap: 6px; align-items: center; margin-bottom: 12px; }
@@ -127,6 +133,13 @@ body {
   animation: k-sweep 1.6s ease-in-out infinite;
 }
 @keyframes k-sweep { 0% { background-position: 200% 0; } 100% { background-position: -200% 0; } }
+/* Batch grid: per-cell prompt caption + a cell that already finished */
+.k-skel-cap { position: absolute; left: 0; right: 0; bottom: 0; z-index: 2;
+  padding: 12px 8px 6px; font-size: 10.5px; color: #fff;
+  background: linear-gradient(transparent, rgba(0, 0, 0, 0.65));
+  white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.k-skel.done::after { animation: none; background: none; }
+.k-cell-fill { width: 100%; height: 100%; object-fit: cover; display: block; }
 .k-gen-badge {
   position: absolute; top: 10px; left: 10px; z-index: 2;
   display: inline-flex; align-items: center; gap: 6px;

package/src/apps/widgets/generation.js

@@ -71,12 +71,31 @@ var TOOL_TITLES = {
   generate_creative_director: 'Creative Director', edit_image: 'Image Edit', edit_video: 'Video Edit'
 };
 
+// Long text is clamped by CSS (.k-prompt 2 lines / .k-caption 1 line). When it
+// actually overflows, make it click-to-expand so the full prompt is readable.
+function makeExpandable(node) {
+  if (!node) return;
+  node.classList.remove('k-clamped');
+  // Synchronous layout read — rAF would never fire in a hidden/backgrounded
+  // iframe, leaving long prompts stuck without the expand affordance.
+  if (node.scrollHeight > node.clientHeight + 2 || node.scrollWidth > node.clientWidth + 2) {
+    node.classList.add('k-clamped');
+    node.title = node.title || 'Show full text';
+    node.onclick = function () {
+      node.classList.toggle('expanded');
+      node.title = node.classList.contains('expanded') ? 'Collapse' : 'Show full text';
+      window.kolbo.notifySize();
+    };
+  }
+}
+
 function boot(sc) {
   if (!sc) return;
   state = sc;
   el('tool-title').textContent = TOOL_TITLES[sc.tool] || 'Generation';
   el('prompt').textContent = sc.prompt || '';
   el('prompt').style.display = sc.prompt ? '' : 'none';
+  makeExpandable(el('prompt'));
   renderChips(sc);
   el('credits').textContent = sc.credits_used != null ? fmtCredits(sc.credits_used) : '';
   if (sc.phase === 'generating') renderGenerating(sc);
@@ -111,16 +130,21 @@ function iconFor(kind) {
 }
 
 /* ---------- generating ---------- */
+function isBatch(sc) { return !!(sc && sc.generation_ids && sc.generation_ids.length > 1); }
+
 function renderGenerating(sc) {
   setPhaseChip('Generating', true);
-  var n = Math.min(sc.count || 1, 4);
+  var n = Math.min(sc.count || 1, isBatch(sc) ? 8 : 4);
   var shape = sc.kind === 'video' || sc.kind === 'scenes' ? 'video' : (sc.kind === 'audio' ? 'video' : 'square');
   var cells = '';
   for (var i = 0; i < n; i++) {
-    cells += '<div class="k-skel ' + shape + '">' +
-      (i === 0 ? '<span class="k-gen-badge"><span class="k-spin"></span>Generating</span>' : '') + '</div>';
+    var cap = (sc.prompts && sc.prompts[i])
+      ? '<span class="k-skel-cap" title="' + esc(sc.prompts[i]) + '">' + esc(sc.prompts[i]) + '</span>' : '';
+    cells += '<div class="k-skel ' + shape + '" data-cell="' + i + '">' +
+      (i === 0 ? '<span class="k-gen-badge"><span class="k-spin"></span>Generating</span>' : '') + cap + '</div>';
   }
-  el('stage').innerHTML = '<div class="k-gen-grid n' + n + '">' + cells + '</div>';
+  // Grid class caps at n4 — the auto-fill rule handles any larger batch count.
+  el('stage').innerHTML = '<div class="k-gen-grid n' + Math.min(n, 4) + '">' + cells + '</div>';
   renderStopButton(sc);
   schedulePoll(sc);
 }
@@ -134,6 +158,7 @@ function cancelSpec(sc) {
     var jobId = (sc.status_args && sc.status_args.job_id) || sc.generation_id;
     return jobId ? { tool: 'shorts_cancel', args: { job_id: jobId } } : null;
   }
+  if (isBatch(sc)) return { batch: sc.generation_ids };
   if (!sc.generation_id) return null;
   return { tool: 'cancel_generation', args: { generation_id: sc.generation_id } };
 }
@@ -150,8 +175,23 @@ function renderStopButton(sc) {
     // cannot repaint the card back into "Generating".
     cancelRequested = true;
     clearTimeout(pollTimer);
-    window.kolbo.callTool(spec.tool, spec.args).then(function (res) {
-      var st = structured(res) || {};
+    // Batch: cancel every id; report combined refund. Entries that already
+    // finished return cancelled:false — only resume polling if ALL did.
+    var call = spec.batch
+      ? Promise.all(spec.batch.map(function (id) {
+          return window.kolbo.callTool('cancel_generation', { generation_id: id })
+            .then(function (r) { return structured(r) || {}; })
+            .catch(function () { return {}; });
+        })).then(function (sts) {
+          var refund = 0;
+          sts.forEach(function (s) { if (s.credits_refunded) refund += s.credits_refunded; });
+          return {
+            cancelled: sts.some(function (s) { return s.cancelled !== false; }),
+            credits_refunded: refund || undefined
+          };
+        })
+      : window.kolbo.callTool(spec.tool, spec.args).then(function (r) { return structured(r) || {}; });
+    call.then(function (st) {
       if (st.cancelled === false) {
         // Already terminal — let the normal poll path report the real outcome
         // instead of claiming a cancel that did not happen.
@@ -183,7 +223,7 @@ function renderCancelled(creditsRefunded) {
   // Tell the model, so it does not go on to report the generation as running.
   try {
     window.kolbo.updateModelContext('The user cancelled generation ' +
-      ((state && state.generation_id) || '') + '.' + note +
+      ((state && (state.generation_ids || [state.generation_id]).filter(Boolean).join(', ')) || '') + '.' + note +
       ' Do not poll it or report it as in progress.');
   } catch (e) {}
   window.kolbo.notifySize();
@@ -222,6 +262,10 @@ function poll(sc) {
       if (++pollErrors >= MAX_POLL_ERRORS) return renderTrackingIssue(st.error || 'Tracking paused. The generation may still be running.');
       return schedulePoll(sc);
     }
+    // Batch (prompts[] fan-out): multi-id status shape { all_done, generations[] }.
+    if (isBatch(sc) && Array.isArray(st.generations)) {
+      return handleBatchStatus(sc, st);
+    }
     if (stateName === 'completed') {
       pollErrors = 0;
       var r = st.result || st;
@@ -257,6 +301,68 @@ function poll(sc) {
   });
 }
 
+/* ---------- batch (prompts[] fan-out) ---------- */
+// Each poll round resolves when every id has completed or its wait window
+// closed (~3 min), so finished cells fill in per round while the rest keep
+// their skeleton. When all_done, the set renders through the scenes viewer.
+function handleBatchStatus(sc, st) {
+  pollErrors = 0;
+  var gens = st.generations || [];
+  gens.forEach(function (g, i) {
+    if (g.state === 'completed') fillBatchCell(sc, i, g);
+  });
+  if (!st.all_done) return schedulePoll(sc);
+
+  var scenes = [], failedCount = 0, credits = 0, haveCredits = false, allUrls = [];
+  gens.forEach(function (g, i) {
+    var r = g.result || g;
+    var urls = (r && r.urls) || [];
+    if (g.state !== 'completed' || !urls.length) { failedCount++; return; }
+    allUrls = allUrls.concat(urls);
+    var c = g.credits_used != null ? g.credits_used : (r.credits_used != null ? r.credits_used : null);
+    if (c != null) { credits += c; haveCredits = true; }
+    scenes.push({
+      scene_number: i + 1,
+      title: (sc.prompts && sc.prompts[i]) || '',
+      image_urls: sc.kind === 'video' ? [] : urls,
+      video_urls: sc.kind === 'video' ? urls : []
+    });
+  });
+  if (!scenes.length) return renderError('All ' + gens.length + ' generations failed');
+
+  var done = Object.assign({}, sc, {
+    phase: 'completed', kind: 'scenes', batch: true, scenes: scenes, urls: [],
+    credits_used: haveCredits ? credits : sc.credits_used
+  });
+  state = done;
+  el('credits').textContent = done.credits_used != null ? fmtCredits(done.credits_used) : '';
+  if (failedCount) setPhaseChip(failedCount + ' failed', false);
+  renderResult(done);
+  try {
+    window.kolbo.updateModelContext(
+      'Batch generation completed (' + (sc.tool || '') + '): ' + scenes.length + ' of ' + gens.length + ' succeeded.' +
+      '\\nOutput URLs:\\n' + allUrls.join('\\n') +
+      (failedCount ? '\\nFailed: ' + failedCount : '') +
+      (haveCredits ? '\\nCredits used: ' + credits : ''));
+  } catch (e) {}
+}
+
+function fillBatchCell(sc, i, g) {
+  var cell = el('stage').querySelector('[data-cell="' + i + '"]');
+  if (!cell || cell.getAttribute('data-done')) return;
+  var r = g.result || g;
+  var u = (r.urls || [])[0];
+  if (!u) return;
+  cell.setAttribute('data-done', '1');
+  cell.classList.add('done');
+  var cap = (sc.prompts && sc.prompts[i])
+    ? '<span class="k-skel-cap" title="' + esc(sc.prompts[i]) + '">' + esc(sc.prompts[i]) + '</span>' : '';
+  cell.innerHTML = (sc.kind === 'video'
+    ? '<video class="k-cell-fill" src="' + esc(u) + '"' + (r.thumbnail_url ? ' poster="' + esc(r.thumbnail_url) + '"' : '') + ' muted playsinline preload="metadata"></video>'
+    : '<img class="k-cell-fill" src="' + esc(u) + '" alt="">') + cap;
+  window.kolbo.notifySize();
+}
+
 /* ---------- results ---------- */
 function renderResult(sc) {
   clearTimeout(pollTimer);
@@ -392,7 +498,10 @@ function wireDlButtons(root) {
 function sceneItems(sc) {
   var items = [];
   (sc.scenes || []).forEach(function (scene) {
-    var label = 'Scene ' + scene.scene_number + (scene.title ? ' — ' + scene.title : '');
+    // Batch sets carry the raw user prompt as title — no "Scene N" framing.
+    var label = sc.batch
+      ? (scene.title || 'Prompt ' + scene.scene_number)
+      : 'Scene ' + scene.scene_number + (scene.title ? ' — ' + scene.title : '');
     (scene.image_urls || []).forEach(function (u) { items.push({ url: u, type: 'image', label: label }); });
     (scene.video_urls || []).forEach(function (u) { items.push({ url: u, type: 'video', label: label }); });
   });
@@ -415,8 +524,9 @@ function renderScenes(sc) {
   }).join('') + '</div>';
   el('stage').innerHTML =
     '<div class="k-viewer">' + mediaHtml + dlBtnHTML(it.url) + '</div>' +
-    '<div style="font-size:11px;color:var(--text-faint);margin:2px 2px 0">' + esc(it.label) + '</div>' +
+    '<div class="k-caption" id="scene-cap">' + esc(it.label) + '</div>' +
     thumbs;
+  makeExpandable(el('scene-cap'));
   wireDlButtons(el('stage'));
   if (it.type === 'image') {
     var main = el('scene-main');
@@ -591,9 +701,11 @@ function bootPre(toolName, args) {
   if (args) originArgs = args;
   if (state) return; // real data already arrived
   el('tool-title').textContent = TOOL_TITLES[toolName] || 'Generation';
-  if (args && (args.prompt || args.text)) {
-    el('prompt').textContent = args.prompt || args.text;
+  if (args && (args.prompt || args.text || (Array.isArray(args.prompts) && args.prompts.length))) {
+    el('prompt').textContent = args.prompt || args.text ||
+      (args.prompts.length + ' prompts — ' + args.prompts.join(' · '));
     el('prompt').style.display = '';
+    makeExpandable(el('prompt'));
   }
   setPhaseChip('Preparing', true);
   if (!el('stage').innerHTML) {

package/src/tools/_shared.js

@@ -519,9 +519,18 @@ async function uiGenerating(p) {
     reference_image: p.reference_image,
     open_url: buildOpenUrl(p.tool, p.gen),
   };
+  // Batch mode (prompts[] fan-out): ONE widget tracks every id in the set.
+  if (Array.isArray(p.generation_ids) && p.generation_ids.length > 1) {
+    structured.generation_ids = p.generation_ids;
+    structured.prompts = p.prompts;
+  }
   const text = JSON.stringify({
     status: 'submitted',
     generation_id: p.gen.generation_id,
+    ...(Array.isArray(p.generation_ids) && p.generation_ids.length > 1
+      ? { batch: true, generation_ids: p.generation_ids } : {}),
+    ...(p.failed_submissions && p.failed_submissions.length
+      ? { failed_submissions: p.failed_submissions } : {}),
     _widget_note: 'A live Kolbo widget is rendering this generation for the user (progress + final result + action buttons). Tell the user it is generating and the card above will update — do NOT poll in a loop. If you need the output URLs (e.g. for a follow-up edit or a report), call get_generation_status ONCE with wait=true — it blocks until done. Tracking several generations? Pass ALL their ids in generation_ids in that one call.',
   }, null, 2);
   return uiResult(UI.generation, text, structured);

package/src/tools/generate.js

@@ -37,6 +37,46 @@ const CINEMATIC_SCHEMA = z.object({
   'validated against their dimension server-side. Dimensions are data-driven — never hardcode ids.'
 );
 
+// ─── Batch fan-out (prompts[]) ──────────────────────────────────────────────
+// One tool call, N DIFFERENT prompts → N generations tracked by ONE widget.
+// The manual-control twin of generate_creative_director: no orchestration pass,
+// the user's exact prompts verbatim. Submit failures never sink the batch —
+// successful ids proceed, failed prompts are reported alongside.
+const MAX_BATCH_PROMPTS = 8;
+async function submitBatch(rawPrompts, submitOne) {
+  const prompts = rawPrompts.slice(0, MAX_BATCH_PROMPTS).map((s) => String(s).trim()).filter(Boolean);
+  const settled = await Promise.allSettled(prompts.map((p) => submitOne(p)));
+  const ok = [], failed = [];
+  settled.forEach((s, i) => {
+    if (s.status === 'fulfilled' && s.value && s.value.generation_id) ok.push({ prompt: prompts[i], gen: s.value });
+    else failed.push({ prompt: prompts[i], error: (s.reason && s.reason.message) || 'submit failed' });
+  });
+  if (!ok.length) throw new Error(`All ${prompts.length} batch submissions failed: ${failed[0].error}`);
+  return { ok, failed, ids: ok.map((o) => o.gen.generation_id) };
+}
+
+// Blocking path for text-only hosts: wait for every batch member, aggregate.
+async function pollBatch(client, batch, { interval, timeout }) {
+  const polls = await Promise.all(batch.ids.map((id) => pollOrTimedOut(client, id, { interval, timeout })));
+  const generations = polls.map((p, i) => p.timedOut
+    ? { prompt: batch.ok[i].prompt, generation_id: batch.ids[i], status: 'processing', note: 'Still running — call get_generation_status with wait=true to collect it.' }
+    : { prompt: batch.ok[i].prompt, generation_id: batch.ids[i], status: 'completed', ...creditFields(polls[i].result), urls: p.result.result.urls });
+  return {
+    content: [{
+      type: 'text',
+      text: JSON.stringify({
+        batch: true,
+        generations,
+        failed_submissions: batch.failed.length ? batch.failed : undefined
+      }, null, 2)
+    }]
+  };
+}
+
+const promptsField = (what) => z.array(z.string()).optional().describe(
+  `BATCH MODE — several DIFFERENT prompts (2–${MAX_BATCH_PROMPTS}) generated concurrently in ONE call and rendered together in ONE combined widget. Whenever the user wants multiple distinct ${what} with their own prompts, ALWAYS pass them all here instead of making several separate calls — separate calls clutter the chat with stacked widgets. All prompts share the same model/settings. When set, \`prompt\` is ignored. For N variations of a SINGLE prompt use num_images (image tools); for an AI-planned coherent scene set use generate_creative_director.`
+);
+
 function registerGenerateTools(server, client, options = {}) {
   // Only enabled by hosts that explicitly opt in (the remote HTTP connector).
   // stdio hosts (Kolbo Code, Claude Desktop, Cursor) leave this false, so their
@@ -49,9 +89,10 @@ function registerGenerateTools(server, client, options = {}) {
   // ─── generate_image ────────────────────────────────────────
   server.tool(
     'generate_image',
-    'Generate image(s) from a text prompt using Kolbo AI. Supports Visual DNA profiles (for character/style/product consistency), moodboards (for style direction), reference images (for composition guidance), batch generation (num_images), and web-search grounding. For EDITING an existing image, use generate_image_edit instead. For a coordinated multi-scene set (storyboard, ad campaign), use generate_creative_director. Returns the final image URL(s) when complete.',
+    'Generate image(s) from a text prompt using Kolbo AI. Supports Visual DNA profiles (for character/style/product consistency), moodboards (for style direction), reference images (for composition guidance), batch generation (num_images for variations of ONE prompt, `prompts` for SEVERAL different prompts in one combined widget), and web-search grounding. When the user wants multiple distinct images, pass all their prompts in `prompts` in ONE call — never a series of separate generate_image calls. For EDITING an existing image, use generate_image_edit instead. For a coordinated multi-scene set planned by AI from a single brief (storyboard, ad campaign), use generate_creative_director. Returns the final image URL(s) when complete.',
     {
-      prompt: z.string().describe('Text description of the image to generate'),
+      prompt: z.string().optional().describe('Text description of the image to generate. Required unless `prompts` is provided.'),
+      prompts: promptsField('images'),
       model: z.string().optional().describe('Model identifier — REQUIRED in practice: pick a specific model, do NOT omit (omitting = Smart Select auto-pick, which we avoid). Strong current defaults: "nano-banana-2" (versatile, text rendering, multilingual) or "gpt-image-2" (photoreal, infographics). Call list_models type="text_to_img" to see all options and pick per the user\'s intent.'),
       aspect_ratio: z.string().optional().describe('Aspect ratio (e.g., "1:1", "16:9", "9:16"). Must be a value present in the model\'s `supported_aspect_ratios` from list_models — pass an unsupported value and the API rejects. Default: "1:1"'),
       enhance_prompt: z.boolean().optional().describe('Enhance the prompt for better results. Default: false — only pass true if the user explicitly asks to enhance/improve the prompt.'),
@@ -67,12 +108,29 @@ function registerGenerateTools(server, client, options = {}) {
       skip_color_palette: z.boolean().optional().describe('Opt this single call OUT of the account\'s active Color DNA palette (see list_color_palettes / activate_color_palette). By default, if the user has an active palette it strict-grades every generation automatically — pass true only when the user explicitly wants this one image ungraded.'),
       project_id: projectIdField
     },
-    async ({ prompt, model, aspect_ratio, enhance_prompt = false, num_images, reference_images, visual_dna_ids, moodboard_id, enable_web_search, resolution, quality, preset_id, cinematic, skip_color_palette, project_id }) => {
+    async ({ prompt, prompts, model, aspect_ratio, enhance_prompt = false, num_images, reference_images, visual_dna_ids, moodboard_id, enable_web_search, resolution, quality, preset_id, cinematic, skip_color_palette, project_id }) => {
+      if (!prompt && !(prompts && prompts.length)) throw new Error('Provide prompt or prompts');
       model = await canonicalModelId(client, model); // lenient id resolution ("z-image" → "z-image/turbo")
-      const gen = await client.post('/v1/generate/image', {
-        prompt, model, aspect_ratio, enhance_prompt, num_images,
+      const shared = {
+        model, aspect_ratio, enhance_prompt,
         reference_images, visual_dna_ids, moodboard_id, enable_web_search, resolution, quality, preset_id, cinematic, skip_color_palette, project_id
-      });
+      };
+
+      // Batch mode: N different prompts, one widget owning all generation ids.
+      if (prompts && prompts.length) {
+        const batch = await submitBatch(prompts, (p) => client.post('/v1/generate/image', { ...shared, prompt: p }));
+        if (ui()) return uiGenerating({
+          tool: 'generate_image', kind: 'image', gen: batch.ok[0].gen, client, model,
+          count: batch.ids.length, settings: { resolution, aspect_ratio },
+          generation_ids: batch.ids, prompts: batch.ok.map((o) => o.prompt),
+          failed_submissions: batch.failed,
+          status_args: { generation_ids: batch.ids, wait: true },
+          reference_image: reference_images?.[0]
+        });
+        return pollBatch(client, batch, { interval: (batch.ok[0].gen.poll_interval_hint || 3) * 1000, timeout: 240000 });
+      }
+
+      const gen = await client.post('/v1/generate/image', { ...shared, prompt, num_images });
 
       if (ui()) return uiGenerating({
         tool: 'generate_image', kind: 'image', gen, client, model, prompt,
@@ -165,7 +223,7 @@ function registerGenerateTools(server, client, options = {}) {
   // ─── generate_creative_director ─────────────────────────────
   server.tool(
     'generate_creative_director',
-    'Generate 2–8 related images or videos as one coherent set from a single creative brief. Use scene_count (NOT num_images) to set the number of scenes (1–8, default 4). Use this when the user gives a general brief ("make 4 product shots", "create a storyboard") and you are planning the scenes — it handles style consistency and runs scenes in parallel. If the user explicitly provides separate prompts for each image, use parallel generate_image calls instead. Supports image and video modes (workflow_type). Visual DNA and moodboard references keep character/style consistent across every scene.',
+    'Generate 2–8 related images or videos as one coherent set from a single creative brief. Use scene_count (NOT num_images) to set the number of scenes (1–8, default 4). Use this when the user gives a general brief ("make 4 product shots", "create a storyboard") and you are planning the scenes — it handles style consistency and runs scenes in parallel. If the user explicitly provides separate prompts for each image, use ONE generate_image call with the `prompts` array instead (never parallel single-prompt calls). Supports image and video modes (workflow_type). Visual DNA and moodboard references keep character/style consistent across every scene.',
     {
       prompt: z.string().describe('Creative brief or concept describing the full set of scenes to generate'),
       scene_count: z.number().optional().describe('Number of scenes/images to generate, 1–8. Default: 4. Use this — NOT num_images — to control how many outputs are created.'),
@@ -318,9 +376,10 @@ function registerGenerateTools(server, client, options = {}) {
   // DNA-locked still via generate_video_from_image.
   server.tool(
     'generate_video',
-    'Generate a video from a text prompt using Kolbo AI. For animating an existing still image into motion, use generate_video_from_image instead. For a coordinated multi-scene video campaign, use generate_creative_director with workflow_type="video". Supports reference images (for style/composition guidance). Does NOT support Visual DNA — for character-consistent video use generate_elements or animate a DNA-locked still via generate_video_from_image. Returns the final video URL when complete.',
+    'Generate a video from a text prompt using Kolbo AI. For SEVERAL different videos, pass all their prompts in `prompts` in ONE call (one combined widget) — never a series of separate calls. For animating an existing still image into motion, use generate_video_from_image instead. For a coordinated multi-scene video campaign, use generate_creative_director with workflow_type="video". Supports reference images (for style/composition guidance). Does NOT support Visual DNA — for character-consistent video use generate_elements or animate a DNA-locked still via generate_video_from_image. Returns the final video URL when complete.',
     {
-      prompt: z.string().describe('Text description of the video to generate'),
+      prompt: z.string().optional().describe('Text description of the video to generate. Required unless `prompts` is provided.'),
+      prompts: promptsField('videos'),
       model: z.string().optional().describe('Model identifier — pick a SPECIFIC model, do NOT omit (omitting = Smart Select auto-pick, which we avoid). Strong current defaults: "seedance-2" (versatile) or "veo3" (Veo 3.1, cinematic + native audio); the Kling family (call list_models for exact ids like kling-video/v3/pro/text-to-video) is strongest for motion. Call list_models type="text_to_video" to see all options + check supported_durations / supported_aspect_ratios, and choose per the user\'s intent.'),
       aspect_ratio: z.string().optional().describe('Aspect ratio (e.g., "16:9", "9:16", "1:1"). Must be in the chosen model\'s `supported_aspect_ratios` from list_models. Default: "16:9"'),
       duration: z.number().optional().describe('Duration in seconds. Must be a value in `supported_durations` from list_models, OR within `min_output_duration`-`max_output_duration` (whichever the model exposes). Default: 5'),
@@ -332,11 +391,28 @@ function registerGenerateTools(server, client, options = {}) {
       skip_color_palette: z.boolean().optional().describe('Opt this single call OUT of the account\'s active Color DNA palette (see list_color_palettes / activate_color_palette). By default, if the user has an active palette it strict-grades every generation automatically — pass true only when the user explicitly wants this one video ungraded.'),
       project_id: projectIdField
     },
-    async ({ prompt, model, aspect_ratio, duration, enhance_prompt = false, reference_images, resolution, preset_id, sound_enabled, skip_color_palette, project_id }) => {
+    async ({ prompt, prompts, model, aspect_ratio, duration, enhance_prompt = false, reference_images, resolution, preset_id, sound_enabled, skip_color_palette, project_id }) => {
+      if (!prompt && !(prompts && prompts.length)) throw new Error('Provide prompt or prompts');
       model = await canonicalModelId(client, model); // lenient id resolution ("z-image" → "z-image/turbo")
-      const gen = await client.post('/v1/generate/video', {
-        prompt, model, aspect_ratio, duration, enhance_prompt, reference_images, resolution, preset_id, sound_enabled, skip_color_palette, project_id
-      });
+      const shared = {
+        model, aspect_ratio, duration, enhance_prompt, reference_images, resolution, preset_id, sound_enabled, skip_color_palette, project_id
+      };
+
+      // Batch mode: N different prompts, one widget owning all generation ids.
+      if (prompts && prompts.length) {
+        const batch = await submitBatch(prompts, (p) => client.post('/v1/generate/video', { ...shared, prompt: p }));
+        if (ui()) return uiGenerating({
+          tool: 'generate_video', kind: 'video', gen: batch.ok[0].gen, client, model,
+          count: batch.ids.length, settings: { duration, resolution, aspect_ratio },
+          generation_ids: batch.ids, prompts: batch.ok.map((o) => o.prompt),
+          failed_submissions: batch.failed,
+          status_args: { generation_ids: batch.ids, wait: true },
+          reference_image: reference_images?.[0]
+        });
+        return pollBatch(client, batch, { interval: (batch.ok[0].gen.poll_interval_hint || 8) * 1000, timeout: 900000 });
+      }
+
+      const gen = await client.post('/v1/generate/video', { ...shared, prompt });
 
       if (ui()) return uiGenerating({
         tool: 'generate_video', kind: 'video', gen, client, model, prompt,