@kolbo/mcp 1.77.0 → 1.77.2

package/package.json

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

package/skill/references/models/seedance.md

@@ -110,6 +110,7 @@ These elevate rich cinematic / reference-anchored sequences. For a short, tight,
 ## Dialogue & expression
 
 - Dialogue goes in quotes and may be in ANY language (Hebrew included). For silent tension, deliver it as expression, not speech: `He does not speak. His expression clearly says: "…"`.
+- **Seedance PERFORMS quoted dialogue natively** — synced voices, lip movement, and room tone come out of the video model itself. Never route scene dialogue through TTS (`generate_speech`) or `generate_lipsync`; write each line in quotes inside its shot beat (`DANIEL says: "…"`) and generate once.
 
 ## Content tone
 

package/skill/references/models/seedance25.md

@@ -9,7 +9,7 @@ Load this file when the user wants a **Seedance 2.5** video (they said "2.5" / "
 
 **Kolbo MCP routing:** `generate_video` or `generate_elements` (refs / Visual DNA / first-last). Run `list_models({ type: "text_to_video" })` and pick the Seedance 2.5 variant by name.
 
-**Audio:** Seedance 2.5 still emits real synced audio. `list_models` may show `sound_generation_type: none` because there is no in-app toggle (`sound_baked_in: true`). Do not tell the user the model is silent.
+**Audio:** Seedance 2.5 still emits real synced audio. `list_models` may show `sound_generation_type: none` because there is no in-app toggle (`sound_baked_in: true`). Do not tell the user the model is silent. Quoted dialogue in the prompt is PERFORMED — synced voices, lip movement, room tone — so scene dialogue never goes through `generate_speech` or `generate_lipsync`; write the lines in quotes inside their shot beats.
 
 ## What's NEW in 2.5 (verified — never hedge)
 

package/src/apps/theme.js

@@ -144,20 +144,31 @@ body {
 .k-skel.portrait { aspect-ratio: 3 / 4; }
 .k-skel::after {
   content: ''; position: absolute; inset: 0;
+  /* The shimmer covers the WHOLE cell and outlives the skeleton — .k-skel.done
+     only clears its paint, not its box. A pseudo-element hit-tests as its
+     originating element, so every click on a finished cell landed on the cell
+     instead of the media inside it: image cells still worked (their handler is
+     ON the cell), but a <video>'s native controls never saw a single event —
+     play, scrub, volume and fullscreen were all dead. It is decoration; it must
+     never take a click. */
+  pointer-events: none;
   background: linear-gradient(90deg, transparent 0%, rgba(255,255,255,0.06) 40%, rgba(255,255,255,0.10) 50%, rgba(255,255,255,0.06) 60%, transparent 100%);
   background-size: 200% 100%;
   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;
+/* bottom: 0 puts this exactly where a <video> draws its control bar, so it has
+   to be click-through too — the caption is a label, not a target. The full text
+   stays reachable: the title tooltip moved onto the cell. */
+.k-skel-cap { position: absolute; left: 0; right: 0; bottom: 0; z-index: 2; pointer-events: none;
   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: contain; display: block; background: #000; }
 .k-gen-badge {
-  position: absolute; top: 10px; left: 10px; z-index: 2;
+  position: absolute; top: 10px; left: 10px; z-index: 2; pointer-events: none;
   display: inline-flex; align-items: center; gap: 6px;
   padding: 4px 10px; border-radius: 999px;
   background: rgba(0, 0, 0, 0.65); /* no backdrop-filter: nested blur over the

package/src/apps/widgets/generation.js

@@ -586,8 +586,12 @@ function fillBatchCell(sc, i, g) {
   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>' : '';
+  if (sc.prompts && sc.prompts[i]) cell.title = sc.prompts[i];
+  // The controls attribute is not optional here: this cell is a FINISHED result
+  // the user is meant to watch, and without it the tile was a muted poster with
+  // no way to play, seek or unmute until the whole batch finished and repainted.
   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>'
+    ? '<video class="k-cell-fill" src="' + esc(u) + '"' + (r.thumbnail_url ? ' poster="' + esc(r.thumbnail_url) + '"' : '') + ' controls playsinline preload="metadata"></video>'
     : '<img class="k-cell-fill" src="' + esc(u) + '" alt="">') + cap;
   window.kolbo.notifySize();
 }
@@ -664,15 +668,21 @@ function renderAudio(sc, urls) {
     var titleBase = track.title || sc.title || (TOOL_TITLES[sc.tool] || 'Audio');
     var title = titleBase + (urls.length > 1 ? ' — Track ' + (i + 1) : '');
     var duration = track.duration != null ? track.duration : sc.duration;
-    var artwork = track.thumbnail_url || sc.thumbnail_url;
+    // The voice's own portrait is the artwork for speech — a generic note glyph
+    // told the user nothing about the one thing that defines the take.
+    var artwork = track.thumbnail_url || sc.thumbnail_url || sc.voice_thumbnail;
+    var placeholder = sc.tool === 'generate_speech' ? ICONS.mic : ICONS.audio;
     return '<div class="k-audio-row k-generated-audio">' +
-      (artwork ? '<img class="k-audio-art" src="' + esc(artwork) + '" alt="" loading="lazy">' :
-        '<div class="k-audio-art k-audio-placeholder">' + ICONS.audio + '</div>') +
+      (artwork ? '<img class="k-audio-art" src="' + esc(artwork) + '" alt="" loading="lazy" onerror="this.style.display=\\'none\\'">' :
+        '<div class="k-audio-art k-audio-placeholder">' + placeholder + '</div>') +
       '<div class="k-audio-meta"><div class="k-audio-title">' + esc(title) + '</div>' +
-      // Resolved name first: a per-track model field is the raw id, and every
-      // track in one generation came from the same model anyway.
-      '<div class="k-audio-sub">' + esc(modelLabel(sc) || track.model || '') +
-      (duration ? ' · ' + fmtDur(duration) : '') + '</div></div>' +
+      // Voice FIRST where there is one — on a speech row, who is speaking is the
+      // thing that defines the take; the engine is secondary. Resolved names
+      // only: a per-track model field is the raw id, and every track in one
+      // generation came from the same model anyway.
+      '<div class="k-audio-sub">' +
+      [voiceLabel(sc), modelLabel(sc) || track.model, duration ? fmtDur(duration) : '']
+        .filter(Boolean).map(esc).join(' · ') + '</div></div>' +
       '<button class="k-btn k-audio-download" data-audio-download="' + esc(u) +
       '" aria-label="Download ' + esc(title) + '">' + ICONS.download + ' Download</button>' +
       '<audio class="k-audio-player" src="' + esc(u) + '" controls preload="none" aria-label="Play ' +
@@ -767,7 +777,8 @@ function renderBatchGrid(sc) {
   var shape = items[0].type === 'video' ? 'video' : 'square';
   el('stage').innerHTML = '<div class="k-gen-grid n' + Math.min(items.length, 4) + '">' +
     items.map(function (it, i) {
-      return '<div class="k-skel done ' + shape + '" data-focus="' + i + '">' +
+      return '<div class="k-skel done ' + shape + '" data-focus="' + i + '"' +
+        (it.label ? ' title="' + esc(it.label) + '"' : '') + '>' +
         (it.type === 'video'
           ? '<video class="k-cell-fill" src="' + esc(it.url) + '" controls playsinline preload="metadata"></video>'
           : '<img class="k-cell-fill" src="' + esc(it.url) + '" alt="" loading="lazy" style="cursor:zoom-in">') +
@@ -803,7 +814,8 @@ function renderStatusGrid(sc) {
         // file — the tool only knows a url came back, not what kind it is.
         it.kind = refKind(it.url, 'image');
         var shape = it.kind === 'video' ? 'video' : 'square';
-        return '<div class="k-skel done ' + shape + '" data-focus="' + i + '">' +
+        return '<div class="k-skel done ' + shape + '" data-focus="' + i + '"' +
+          (it.title ? ' title="' + esc(it.title) + '"' : '') + '>' +
           (it.kind === 'video'
             ? '<video class="k-cell-fill" src="' + esc(it.url) + '" controls playsinline preload="metadata"></video>'
             : it.kind === 'audio'

package/src/tools/_shared.js

@@ -659,6 +659,14 @@ async function uiCompleted(p, textPayload, extraContent) {
     // above which assume everything finished together. Only set when the
     // caller actually has this shape; every existing caller is unaffected.
     ...(Array.isArray(p.items) ? { items: p.items } : {}),
+    // The voice, by name and portrait. uiGenerating has carried this since the
+    // chips were introduced; uiCompleted never did, so it silently dropped a
+    // resolved voice its caller had already looked up — every FINISHED speech
+    // card fell back to `settings.voice`, printing a raw ElevenLabs id where the
+    // name belongs and rendering the generic note placeholder instead of the
+    // voice's face. Exactly the "never show a raw id on a card" rule, broken on
+    // the one path the user actually ends up looking at.
+    ...(p.voice ? { voice_name: p.voice.name, voice_thumbnail: p.voice.thumbnail } : {}),
     // The RAW generation state, when the caller has one. `phase` above is
     // hardcoded 'completed' — it means "this tool call finished", not "the
     // generation finished" — so a status check on a still-running job looked

package/src/tools/generate.js

@@ -855,11 +855,19 @@ function registerGenerateTools(server, client, options = {}) {
       if (poll.timedOut) return poll.timedOut;
       const result = poll.result;
 
+      // What ACTUALLY ran, not what was asked for. The status result reports the
+      // engine's own choice (`model: "google_tts"`, `voice: "he-IL-Chirp3-HD-Kore"`)
+      // and for an omitted model that is the ONLY place the real answer appears —
+      // the card was labelling those "Smart Select", which is not even a text-to-
+      // speech option, and naming the voice the caller typed rather than the one
+      // that spoke. Same resolution addDisplayNames does for the polling path.
+      const ranVoice = (await voiceInfo(client, result.result?.voice).catch(() => null)) || voiceRecord;
       return uiCompleted({
-        tool: 'generate_speech', kind: 'audio', gen, client, model, prompt: text,
-        voice: voiceRecord,
+        tool: 'generate_speech', kind: 'audio', gen, client, prompt: text,
+        model: result.result?.model || model,
+        voice: ranVoice,
         settings: {
-          voice: voice || 'Rachel',
+          voice: (ranVoice && ranVoice.name) || voice || 'Rachel',
           style: selected_style || emotion || style_instructions_preset_id || style_instructions,
           speaking_speed,
           language,
@@ -1181,10 +1189,10 @@ function registerGenerateTools(server, client, options = {}) {
     {
       prompt: z.string().describe('Locked Intro prompt (Seedance/Elements): Total line, [GLOBAL LOOK], [CAST] with @ExactDNAName for every visual_dna_ids entry, [LOCATION], then SHOT N. Not SCENE CONTEXT/OPTICS/ACTION packs. Never substitute "the left man" or "Zohar\'s" for @Name.'),
       model: z.string().optional().describe('Model identifier. If the user already named a family (Grok / Kling / Veo / Seedance / …), pass THAT family — never default to Seedance because Elements often uses it. Use list_models type="elements" for exact ids and elements_max_* caps. Do NOT omit (omitting = Smart Select).'),
-      reference_images: z.array(z.string()).optional().describe('Array of image references (product shots, character references, etc.). Accepts a public URL (forwarded as-is, never re-uploaded) OR an absolute local path, which is uploaded for you. **Cap: pass at most `elements_max_images` URLs from list_models for the chosen model — exceeding it is a deterministic 400.**'),
-      reference_videos: z.array(z.string()).optional().describe('Array of reference videos for models that accept video inputs. Accepts a public URL (forwarded as-is, never re-uploaded) OR an absolute local path, which is uploaded for you. **Cap: pass at most `elements_max_videos` URLs from list_models — if the cap is 0 the model rejects videos.**'),
-      reference_audio_urls: z.array(z.string()).optional().describe('Array of reference audio tracks for models that accept audio inputs. Accepts a public URL (forwarded as-is, never re-uploaded) OR an absolute local path, which is uploaded for you. **Cap: pass at most `elements_max_audio` URLs from list_models.** `audio_url` remains supported as the legacy single-track form.'),
-      audio_url: z.string().optional().describe('A single reference audio track — legacy form of reference_audio_urls. Accepts a public URL (forwarded as-is, never re-uploaded) OR an absolute local path, which is uploaded for you. **Audio constraints: `elements_max_audio` from list_models gates whether audio is accepted at all; audio duration must fall within `min_audio_duration`-`max_audio_duration`; format must be in `supported_audio_formats` (if specified).**'),
+      reference_images: z.array(z.string()).optional().describe('Array of image references (product shots, character references, etc.). Accepts a public URL (forwarded as-is; if the API rejects an external URL as untrusted, it is auto-rehosted into the media library and retried once) OR an absolute local path, which is uploaded for you. **Cap: pass at most `elements_max_images` URLs from list_models for the chosen model — exceeding it is a deterministic 400.**'),
+      reference_videos: z.array(z.string()).optional().describe('Array of reference videos for models that accept video inputs. Accepts a public URL (forwarded as-is; if the API rejects an external URL as untrusted, it is auto-rehosted into the media library and retried once) OR an absolute local path, which is uploaded for you. **Cap: pass at most `elements_max_videos` URLs from list_models — if the cap is 0 the model rejects videos.**'),
+      reference_audio_urls: z.array(z.string()).optional().describe('Array of reference audio tracks for models that accept audio inputs. Accepts a public URL (forwarded as-is; if the API rejects an external URL as untrusted, it is auto-rehosted into the media library and retried once) OR an absolute local path, which is uploaded for you. **Cap: pass at most `elements_max_audio` URLs from list_models.** `audio_url` remains supported as the legacy single-track form.'),
+      audio_url: z.string().optional().describe('A single reference audio track — legacy form of reference_audio_urls. Accepts a public URL (forwarded as-is; if the API rejects an external URL as untrusted, it is auto-rehosted into the media library and retried once) OR an absolute local path, which is uploaded for you. **Audio constraints: `elements_max_audio` from list_models gates whether audio is accepted at all; audio duration must fall within `min_audio_duration`-`max_audio_duration`; format must be in `supported_audio_formats` (if specified).**'),
       files: z.array(z.string()).optional().describe('Untyped catch-all for mixed media — images, videos AND audio, each a URL or an absolute local path. The kind is detected from the file extension and the item is routed to the matching reference list, so a local .mp4 is sent as a video and a local .mp3 as audio. Prefer the typed lists (reference_images / reference_videos / reference_audio_urls) when you already know the kind; they accept local paths too. URLs given here are forwarded as URLs, never re-uploaded. **Caps still apply per kind: `elements_max_images` / `elements_max_videos` / `elements_max_audio` from list_models. Local uploads are capped at 200MB each.**'),
       duration: z.number().optional().describe('Output duration in seconds. Must be in `supported_durations` from list_models, OR within `min_output_duration`-`max_output_duration`. Default: 5'),
       aspect_ratio: z.string().optional().describe('Aspect ratio (e.g., "16:9", "9:16", "1:1"). Must be in `supported_aspect_ratios` from list_models. Default: "16:9"'),
@@ -1250,10 +1258,10 @@ function registerGenerateTools(server, client, options = {}) {
         session_name, project_id, session_id
       };
 
-      let startResponse;
-      if (!locals.length) {
-        startResponse = await client.post('/v1/generate/elements', body);
-      } else {
+      const startElements = async () => {
+        if (!locals.length) {
+          return client.post('/v1/generate/elements', body);
+        }
         const resolved = await Promise.all(locals.map(({ src, kind }) =>
           resolveToBuffer(src, kind, { maxBytes: ELEMENTS_MAX_UPLOAD_BYTES })));
         const form = new FormData();
@@ -1277,7 +1285,36 @@ function registerGenerateTools(server, client, options = {}) {
         for (const f of resolved) {
           form.append('files', f.buffer, { filename: f.filename, contentType: f.contentType });
         }
-        startResponse = await client.postMultipart('/v1/generate/elements', form);
+        return client.postMultipart('/v1/generate/elements', form);
+      };
+
+      let startResponse;
+      try {
+        startResponse = await startElements();
+      } catch (err) {
+        // The elements trust gate only accepts remote references that are BOTH
+        // Kolbo-hosted AND registered to this caller's library/project — any
+        // other public URL 400s with this code, even though every schema here
+        // says "public URL, forwarded as-is". Agents used to recover by hand
+        // (upload_media, then resend). Do that detour for them: rehost every
+        // remote reference into the caller's library and retry ONCE. The gate
+        // fires before any charge, so the failed first attempt costs nothing.
+        if (err?.code !== 'UNTRUSTED_REFERENCE_MEDIA_URL') throw err;
+        for (const kind of ['image', 'video', 'audio']) {
+          media[kind] = await Promise.all(media[kind].map(async (src) => {
+            if (!isUrlSource(src)) return src;
+            const file = await resolveToBuffer(src, kind, { maxBytes: ELEMENTS_MAX_UPLOAD_BYTES });
+            const form = new FormData();
+            form.append('file', file.buffer, { filename: file.filename, contentType: file.contentType });
+            if (project_id) form.append('project_id', project_id);
+            const uploaded = await client.postMultipart('/v1/media/upload', form);
+            return uploaded?.media?.url || uploaded?.url || src;
+          }));
+        }
+        body.reference_images = some(urlsOf('image'));
+        body.reference_videos = some(urlsOf('video'));
+        body.reference_audio_urls = some(urlsOf('audio'));
+        startResponse = await startElements();
       }
 
       if (ui()) return uiGenerating({
@@ -1576,10 +1613,18 @@ function registerGenerateTools(server, client, options = {}) {
           highlighted: z.object({ font: z.string().optional(), weight: z.number().int().min(100).max(900).optional(), color: z.string().optional() }).optional().describe('Highlighted word tier styling.'),
         }).optional(),
       }).optional().describe('VEED Subtitles only: style overrides. Any omitted field keeps the preset default. Best supported by Basic presets.'),
+      enhancement_model: z.string().optional()
+        .describe('Topaz Slow Motion only (model "topaz/interpolate/video"): retiming engine — "Apollo" (smooth motion, default), "Chronos" (complex motion and occlusion), or "Aion" (highest quality for extreme slow motion, and the most expensive).'),
+      target_fps: z.number().optional()
+        .describe('Topaz Slow Motion only: frames per second of the OUTPUT (16-120, default 60). Higher rates generate more frames and cost proportionally more.'),
+      slowdown_factor: z.number().optional()
+        .describe('Topaz Slow Motion only: how many times longer the output runs (1-8, default 1). 4 turns a 5s clip into 20s of slow motion. Billing is on the OUTPUT length, so an 8x pass costs 8x a 1x pass.'),
+      output_format: z.string().optional()
+        .describe('Topaz HDR only (model "topaz/sdr-to-hdr/video"): "mp4" for 10-bit H.265 HDR10 (default) or "prores" for 10-bit ProRes 422 HQ. Both are HDR masters — the in-app player shows a tone-mapped SDR preview and the HDR file is the download.'),
       project_id: projectIdField,
       session_id: sessionIdField
     },
-    async ({ source_video, prompt, model, aspect_ratio, duration, enhance_prompt = false, visual_dna_ids, resolution, sound_enabled, reference_images, reference_videos, elements, preset, source_language, translation_language, srt_content, srt_file_url, vocabulary, customization, project_id, session_id }) => {
+    async ({ source_video, prompt, model, aspect_ratio, duration, enhance_prompt = false, visual_dna_ids, resolution, sound_enabled, reference_images, reference_videos, elements, preset, source_language, translation_language, srt_content, srt_file_url, vocabulary, customization, enhancement_model, target_fps, slowdown_factor, output_format, project_id, session_id }) => {
       model = await canonicalModelId(client, model, 'video_to_video'); // lenient id resolution ("z-image" → "z-image/turbo")
       if (!source_video) throw new Error('source_video is required');
 
@@ -1589,7 +1634,9 @@ function registerGenerateTools(server, client, options = {}) {
         startResponse = await client.post('/v1/generate/video-from-video', {
           video_url: source_video, prompt, model, aspect_ratio, duration, enhance_prompt, visual_dna_ids, resolution, sound_enabled,
           reference_images, reference_videos, elements, preset, source_language, translation_language,
-          srt_content, srt_file_url, vocabulary, customization, project_id, session_id
+          srt_content, srt_file_url, vocabulary, customization,
+          enhancement_model, target_fps, slowdown_factor, output_format,
+          project_id, session_id
         });
       } else {
         const resolved = await resolveToBuffer(source_video, 'video');
@@ -1613,6 +1660,10 @@ function registerGenerateTools(server, client, options = {}) {
         if (reference_images) form.append('reference_images', JSON.stringify(reference_images));
         if (reference_videos) form.append('reference_videos', JSON.stringify(reference_videos));
         if (elements) form.append('elements', JSON.stringify(elements));
+        if (enhancement_model) form.append('enhancement_model', enhancement_model);
+        if (target_fps !== undefined) form.append('target_fps', String(target_fps));
+        if (slowdown_factor !== undefined) form.append('slowdown_factor', String(slowdown_factor));
+        if (output_format) form.append('output_format', output_format);
         if (project_id) form.append('project_id', project_id);
         if (session_id) form.append('session_id', session_id);
         startResponse = await client.postMultipart('/v1/generate/video-from-video', form);
@@ -1822,7 +1873,8 @@ function registerGenerateTools(server, client, options = {}) {
         'camera_angle',
         'split', 'split_upscale',
         'multi_shot',
-        'magic_edit'
+        'magic_edit',
+        'enhance'
       ]).describe([
         'Edit operation:',
         '"upscale" — increase resolution by 2×, 3×, or 4× (use `scale`). "clarity_upscale" — AI-powered clarity upscale with detail enhancement (use `resolution`).',
@@ -1831,6 +1883,7 @@ function registerGenerateTools(server, client, options = {}) {
         '"removebg" — remove the image background, output is transparent PNG.',
         '"background_replace" — remove background and replace it with AI-generated content from `prompt`.',
         '"enhance_skin" — portrait skin retouching (use `skin_strength`: "subtle" | "realistic" | "pimple" | "freckle").',
+        '"enhance" — Topaz photo correction at the SOURCE resolution (no resizing). Pick the tool with `model`: "topaz/adjust/image" (exposure, white balance, or colorizing a black-and-white photo), "topaz/sharpen/image" (lens / motion / portrait / wildlife blur, or Super Focus for severely blurred shots), "topaz/denoise/image" (high-ISO and night noise), "topaz/restore/image" (old or damaged photos, dust and scratches). Choose the specific engine with `enhancement_model` — call list_models type="graphics_enhance" to see each model\'s engines. To make an image BIGGER use "upscale" instead.',
         '"inpaint" — paint over a masked area using `mask_image_url` (B&W mask, white = fill area) and optional `prompt`. Add reference images via `additional_images`.',
         '"erase" — erase an object defined by `mask_image_url` (white = erase area).',
         '"face_swap" — swap the face in `image_url` with the face from `mask_image_url` (required).',
@@ -1845,7 +1898,13 @@ function registerGenerateTools(server, client, options = {}) {
 
       // ── upscale ────────────────────────────────────────────
       scale: z.number().optional()
-        .describe('Upscale factor: 2, 3, or 4. Used with operation="upscale". Default: 2.'),
+        .describe('Upscale factor: 1, 2, 4 or 8. Used with operation="upscale". Default: 2.'),
+
+      enhancement_model: z.string().optional()
+        .describe('Topaz engine. With operation="upscale" on model "topaz/upscale/image" it selects the engine family: "Standard V2" / "High Fidelity V3" / "CGI" / "Text Refine" (faithful), "Wonder 3.5" (rebuilds natural detail), "Bloom 2" (reinvents detail — most expensive), "Transparent" (keeps the alpha channel). With operation="enhance" it selects the correction engine for the chosen model. Omit for the model default. Call list_models to see the engines a model offers.'),
+
+      output_format: z.string().optional()
+        .describe('Output image format: "jpeg" or "png". Used with Topaz "upscale" and "enhance". Defaults to jpeg (the transparent upscaler always returns png).'),
 
       resolution: z.string().optional()
         .describe('Target output resolution (e.g. "4k", "2k", "1080p"). Used with "clarity_upscale", "split_upscale", "multi_shot".'),
@@ -1902,6 +1961,7 @@ function registerGenerateTools(server, client, options = {}) {
       image_url, operation, model, scale, aspect_ratio, skin_strength, prompt,
       mask_image_url, additional_images, generate_all_angles, resolution, quality, ai_optimize = false,
       zoom_out_percentage, expand_left, expand_right, expand_top, expand_bottom,
+      enhancement_model, output_format,
       project_id, session_id
     }) => {
       // No `type` argument: these are operation-routed tools (upscale / reframe /
@@ -1911,6 +1971,9 @@ function registerGenerateTools(server, client, options = {}) {
 
       // Basic validation
       if (operation === 'reframe' && !aspect_ratio) throw new Error('aspect_ratio is required for reframe');
+      if (operation === 'enhance' && !model) {
+        throw new Error('model is required for enhance — pick one of: topaz/adjust/image, topaz/sharpen/image, topaz/denoise/image, topaz/restore/image');
+      }
       if (operation === 'background_replace' && !prompt) throw new Error('prompt is required for background_replace');
       if (operation === 'face_swap' && !mask_image_url && !(additional_images && additional_images.length > 0)) {
         throw new Error('mask_image_url (face reference) is required for face_swap');
@@ -1920,6 +1983,7 @@ function registerGenerateTools(server, client, options = {}) {
         image_url, operation, model, scale, aspect_ratio, skin_strength, prompt,
         mask_image_url, additional_images, generate_all_angles, resolution, quality, ai_optimize,
         zoom_out_percentage, expand_left, expand_right, expand_top, expand_bottom,
+        enhancement_model, output_format,
         project_id, session_id
       });
 
@@ -1992,6 +2056,8 @@ function registerGenerateTools(server, client, options = {}) {
         .describe('Target resolution (e.g. "4k", "2k", "1080p"). Used with "upscale" and "reframe".'),
       target_fps: z.number().optional()
         .describe('Target frame rate (e.g. 24, 30, 60). Used with operation="upscale".'),
+      enhancement_model: z.string().optional()
+        .describe('Topaz enhancement engine for operation="upscale" on model "topaz/upscale/video". Families: Precision (faithful — "Proteus", "Artemis High Quality", "Iris", "Dione TV", "Gaia CG", "Gaia 2"), Denoise ("Nyx", "Nyx Fast"), Generative (rebuilds detail that is not in the source — "Starlight Fast 2", "Starlight HQ", "Starlight Precise 2.6"), Creative ("Astra 2", always renders 4K). Generative and Creative engines cost several times the Precision rate. Omit for the default.'),
 
       // ── reframe ────────────────────────────────────────────
       aspect_ratio: z.string().optional()
@@ -2055,7 +2121,7 @@ function registerGenerateTools(server, client, options = {}) {
     async ({
       video_url, operation, model, aspect_ratio, scale, prompt,
       image_url, audio_url, duration, mode,
-      target_fps, resolution,
+      target_fps, resolution, enhancement_model,
       grid_position_x, grid_position_y,
       sound_effect_prompt, background_music_prompt, original_sound, cfg_strength,
       refine_edges, subject_is_person,
@@ -2078,7 +2144,7 @@ function registerGenerateTools(server, client, options = {}) {
       if (operation === 'extend'        && !duration)    throw new Error('duration is required for extend');
 
       const gen = await client.post('/v1/edit/video', {
-        video_url, operation, model, aspect_ratio, scale, prompt,
+        video_url, operation, model, aspect_ratio, scale, prompt, enhancement_model,
         image_url, audio_url, duration, mode,
         target_fps, resolution,
         grid_position_x, grid_position_y,