@kolbo/mcp 1.55.0 → 1.56.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolbo/mcp",
-  "version": "1.55.0",
+  "version": "1.56.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/upload.js

@@ -123,7 +123,8 @@ function addFiles(list) {
     if (items.length >= maxFiles) break;
     var f = list[i];
     var kind = classify(f.name);
-    var it = { file: f, kind: kind, status: 'queued', pct: 0, url: null, err: null, id: nextItemId++ };
+    var it = { file: f, kind: kind, status: 'queued', pct: 0, url: null, err: null, id: nextItemId++, thumb: null };
+    if (kind === 'image') { try { it.thumb = URL.createObjectURL(f); } catch (e) {} }
     var allowedKinds = state.kinds && state.kinds.length ? state.kinds : ['image','video','audio','document'];
     if (!kind || allowedKinds.indexOf(kind) === -1) {
       it.status = 'error'; it.err = 'Unsupported file type';
@@ -201,9 +202,12 @@ function rowHtml(it) {
   var bar = it.status === 'uploading'
     ? '<div style="height:3px;border-radius:2px;background:var(--surface);margin-top:5px;overflow:hidden"><div id="bar-' + it.id + '" style="height:100%;width:' + it.pct + '%;background:var(--accent,#7c6cff);transition:width .2s"></div></div>'
     : '';
+  var left = it.thumb
+    ? '<img data-thumb="' + it.id + '" src="' + it.thumb + '" alt="" style="width:34px;height:34px;object-fit:cover;border-radius:7px;flex:none;border:1px solid var(--border);background:var(--surface)">'
+    : '<span>' + icon + '</span>';
   return '<div id="row-' + it.id + '" style="padding:8px 10px;border:1px solid var(--border);border-radius:10px;margin-bottom:6px;background:var(--surface)">' +
     '<div style="display:flex;align-items:center;gap:8px;font-size:12.5px">' +
-    '<span>' + icon + '</span>' +
+    left +
     '<span style="flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap" title="' + esc(it.file.name) + '">' + esc(it.file.name) + '</span>' +
     '<span style="color:var(--text-muted);font-size:11px">' + fmtSize(it.file.size) + '</span>' +
     '<span id="status-' + it.id + '" style="font-size:11.5px">' + right + '</span>' +
@@ -219,6 +223,19 @@ function renderRow(it) {
 
 function render() {
   el('rows').innerHTML = items.map(rowHtml).join('');
+  // Thumbnail fallback chain: local blob preview -> CDN URL (allowlisted in the
+  // host CSP) once uploaded -> plain type icon.
+  Array.prototype.forEach.call(el('rows').querySelectorAll('[data-thumb]'), function (img) {
+    img.onerror = function () {
+      var id = Number(img.getAttribute('data-thumb'));
+      for (var i = 0; i < items.length; i++) {
+        if (items[i].id !== id) continue;
+        if (items[i].url && img.src !== items[i].url) { img.src = items[i].url; return; }
+        items[i].thumb = null;
+      }
+      render();
+    };
+  });
   Array.prototype.forEach.call(el('rows').querySelectorAll('[data-retry]'), function (a) {
     a.onclick = function (e) {
       e.preventDefault();

package/src/tools/generate.js

@@ -767,9 +767,13 @@ function registerGenerateTools(server, client, options = {}) {
       enhance_prompt: z.boolean().optional().describe('Enhance the prompt. Default: false — only pass true if the user explicitly asks to enhance/improve the prompt.'),
       visual_dna_ids: z.array(z.string()).optional().describe('Array of Visual DNA profile IDs to apply for character/style consistency across outputs. **Cap: pass at most `max_visual_dna` IDs from list_models for the chosen model.**'),
       resolution: z.string().optional().describe('Video resolution tier (vertical pixels): "720p" / "1080p" / "1440p" / "2160p". Model-dependent — call list_models and read supported_resolutions.'),
+      keyframes: z.array(z.object({
+        image_url: z.string().describe('Public URL of the keyframe image'),
+        timestamp_seconds: z.number().describe('Moment on the OUTPUT timeline (seconds, 0 = first frame) where this image is pinned')
+      })).optional().describe('Timeline-pinned keyframes for multi-keyframe models (e.g. "flux-3-keyframes", "luma-ray-3-2-storyboard"): the model generates the motion BETWEEN the pinned images. Only models with `supports_keyframes: true` in list_models accept this; cap = `max_keyframes` (FLUX 3: 10). Requires an explicit `duration` — timestamps beyond it are clamped. Ignored by ordinary elements models. OPTIONAL for flux-3-keyframes: if omitted, pass the images via reference_images instead — they are played through IN ORDER, timed from timing language in the prompt or spaced evenly. Pass explicit keyframes only when you need exact control.'),
       project_id: projectIdField
     },
-    async ({ prompt, model, reference_images, reference_videos, reference_audio_urls, audio_url, files, duration, aspect_ratio, motion, preset_id, enhance_prompt = false, visual_dna_ids, resolution, project_id }) => {
+    async ({ prompt, model, reference_images, reference_videos, reference_audio_urls, audio_url, files, duration, aspect_ratio, motion, preset_id, enhance_prompt = false, visual_dna_ids, resolution, keyframes, project_id }) => {
       model = await canonicalModelId(client, model); // lenient id resolution ("z-image" → "z-image/turbo")
       if (!prompt) throw new Error('prompt is required');
 
@@ -791,6 +795,7 @@ function registerGenerateTools(server, client, options = {}) {
         if (reference_audio_urls) form.append('reference_audio_urls', JSON.stringify(reference_audio_urls));
         if (audio_url) form.append('audio_url', audio_url);
         if (resolution) form.append('resolution', resolution);
+        if (keyframes) form.append('keyframes', JSON.stringify(keyframes));
         if (project_id) form.append('project_id', project_id);
         for (const f of resolved) {
           form.append('files', f.buffer, { filename: f.filename, contentType: f.contentType });
@@ -799,7 +804,7 @@ function registerGenerateTools(server, client, options = {}) {
       } else {
         // URL-only mode: plain JSON.
         startResponse = await client.post('/v1/generate/elements', {
-          prompt, model, reference_images, reference_videos, reference_audio_urls, audio_url, duration, aspect_ratio, motion, preset_id, enhance_prompt, visual_dna_ids, resolution, project_id
+          prompt, model, reference_images, reference_videos, reference_audio_urls, audio_url, duration, aspect_ratio, motion, preset_id, enhance_prompt, visual_dna_ids, resolution, keyframes, project_id
         });
       }