@clipform/mcp-server 2.15.7 → 2.15.9

package/dist/{chunk-G32PAZBX.js → chunk-4YDGMSPG.js}

@@ -6,7 +6,7 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-EAGVCUZK.js";
+} from "./chunk-SKNKSZOA.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
@@ -15,7 +15,7 @@ import {
   getGuideUri,
   guideFallbackText,
   registerResources
-} from "./chunk-CMGILVM3.js";
+} from "./chunk-ORZYVIW3.js";
 import {
   ACTIVE_NODE_TYPES,
   CONTACT_FIELDS,
@@ -29,7 +29,8 @@ import {
   MCP_TOOL_TOOLSETS,
   NODE_TYPES,
   NON_COUNTABLE_TYPES,
-  SLIDESHOW_TRANSITIONS,
+  SLIDESHOW_COMPOSITION_TRANSITIONS,
+  VIDEO_LOOK_NAMES,
   bfsOrder,
   callApi,
   capsFromToolsets,
@@ -39,7 +40,7 @@ import {
   resolveFormType,
   structuredResult,
   textResult
-} from "./chunk-DP5QUTMG.js";
+} from "./chunk-VLI2LYIB.js";
 import {
   getMcpAuth,
   runWithMcpTool
@@ -19588,7 +19589,7 @@ function registerRenderCompositionTool(server) {
       title: "Render Composition",
       description: `Render a specialised video composition to MP4 or PNG - custom animated visuals that clipform_generate_video can't provide, such as geography animations or designed motion graphics. Available composition names and their required input props schemas come from clipform_list_compositions.
 
-For narrated Ken Burns slideshows from images, use clipform_generate_video instead. Output formats: mp4 (H.264, best for social media) or png (single frame). Returns a public URL when complete.
+Output formats: mp4 (H.264, best for social media) or png (single frame). Returns a public URL when complete.
 
 For multi-render builds (e.g. one clip per quiz question), pass everything in ONE call via items (max 10): all renders fire in parallel and you get one job ID each - then collect the URLs in a single clipform_check_render call with job_ids. Single render: pass compositionId/inputProps at the top level (wait: true blocks and returns the URL; wait: false returns a job ID).
 
@@ -19821,7 +19822,7 @@ function registerListCompositionsTool(server) {
     "clipform_list_compositions",
     {
       title: "List Compositions",
-      description: `Browse available video compositions and their expected props schemas. Call this before using clipform_render_composition to discover visual styles and their input props. For narrated slideshows from images, use clipform_generate_video instead.`,
+      description: `Browse available video compositions and their expected props schemas. Call this before using clipform_render_composition to discover visual styles and their input props. For an image or photo montage, reach for a video template (clipform_list_video_templates + clipform_render_video_template) or clipform_generate_video instead of a composition.`,
       inputSchema: {},
       outputSchema: {
         compositions: external_exports.array(
@@ -20136,7 +20137,7 @@ ${RENDER_ATTACH_RULE}`,
           external_exports.object({
             type: external_exports.enum(["image", "video"]).describe("'image' for still images with Ken Burns effects, 'video' for video clips"),
             url: external_exports.string().url().describe("Media URL"),
-            effect: external_exports.string().optional().describe(`Ken Burns effect (image only): ${[...KEN_BURNS_EFFECTS, "random"].join(", ")}`),
+            effect: external_exports.enum([...KEN_BURNS_EFFECTS, "random"]).optional().describe("Advanced override: a specific Ken Burns effect (image only), overriding the preset look's own effect choice"),
             aspect_ratio: external_exports.number().positive().optional().describe("Image width/height ratio (image only). Enables auto blur-pad for landscape images."),
             fit: external_exports.enum(KEN_BURNS_FIT_MODES).optional().describe("Framing mode (image only). auto = cover for portrait, blur-pad for landscape."),
             start_from: external_exports.number().min(0).optional().describe("Start time in seconds (video only). Trims the clip."),
@@ -20147,23 +20148,24 @@ ${RENDER_ATTACH_RULE}`,
         background_audio_url: external_exports.string().url().optional().describe("Ambience/music bed under the narration (crowd noise, room tone). Loops to fill the video. Find tracks with clipform_search_music."),
         background_audio_volume: external_exports.number().min(0).max(1).optional().describe("Background bed volume 0-1 (default 0.15 - sits under speech)"),
         duration_seconds: external_exports.number().positive().optional().describe("Video duration in seconds (required if no audio_url)"),
+        preset: external_exports.enum(VIDEO_LOOK_NAMES).optional().default("clean").describe(`Named look driving transition + motion + colour treatment together (default: 'clean'). One of: ${VIDEO_LOOK_NAMES.join(", ")}. The advanced fields below (transition, style_preset, texture, duotone, background_color, per-item effect) override individual pieces of the chosen look when set.`),
         random_effects: external_exports.boolean().optional().default(true).describe("Shuffle Ken Burns effects across image items (default: true)"),
         transition: external_exports.object({
-          type: external_exports.string().optional().default("fade").describe(`Transition: ${SLIDESHOW_TRANSITIONS.join(", ")}`),
-          duration: external_exports.number().optional().default(1).describe("Transition duration in seconds (default: 1)")
-        }).optional(),
-        style_preset: STYLE_PRESET_ENUM.optional(),
+          type: external_exports.enum(SLIDESHOW_COMPOSITION_TRANSITIONS).optional().describe(`Advanced override: ${SLIDESHOW_COMPOSITION_TRANSITIONS.join(", ")} - overrides the preset look's own transition`),
+          duration: external_exports.number().optional().describe("Advanced override: transition duration in seconds")
+        }).optional().describe("Advanced: overrides the preset look's transition"),
+        style_preset: STYLE_PRESET_ENUM.optional().describe(`Advanced override: a raw Ken Burns motion preset, overriding the preset look's own motion.`),
         texture: external_exports.object({
           type: external_exports.enum(["checker", "halftone", "scanlines"]).describe("checker = square dither mesh, halftone = dot grid, scanlines = horizontal lines"),
           sizePx: external_exports.number().positive().optional().describe("Pattern cell size in px (default 4)"),
           opacity: external_exports.number().min(0).max(1).optional().describe("Pattern darkness 0-1 (default 0.35)")
-        }).optional().describe("Print-style pattern overlay on image items - makes stock imagery read as designed (screen-print dither look)"),
+        }).optional().describe("Advanced override: print-style pattern overlay on image items, overriding the preset look's own texture - makes stock imagery read as designed (screen-print dither look)"),
         duotone: external_exports.object({
           shadow: external_exports.string().describe("Darker tone (maps to image shadows), e.g. '#1a1633'"),
           highlight: external_exports.string().describe("Lighter tone (maps to image highlights), e.g. '#f5c542'"),
           contrast: external_exports.number().positive().optional().describe("Contrast boost before mapping (default 1.1)")
-        }).optional().describe("Two-tone editorial recolour on image items - desaturates then maps to a shadow->highlight palette. Pair with a halftone texture for a screen-print poster look."),
-        background_color: external_exports.string().optional().describe("Background color (default '#000')"),
+        }).optional().describe("Advanced override: two-tone editorial recolour on image items, overriding the preset look's own duotone - desaturates then maps to a shadow->highlight palette. Pair with a halftone texture for a screen-print poster look."),
+        background_color: external_exports.string().optional().describe("Advanced override: background color, overriding the preset look's own background (default '#000')"),
         wait: external_exports.boolean().optional().default(true).describe("true (default) blocks until the video is ready and returns its URL. false returns a job ID immediately - fire all renders first, then poll clipform_check_render. Use false whenever rendering more than one video."),
         node_id: external_exports.string().optional().describe("Form node to attach this render to automatically once it completes - skips the manual clipform_upload_media_asset + clipform_attach_node_media steps and republishes the form if it's currently live. Requires form_id."),
         form_id: external_exports.string().uuid().optional().describe("The form UUID (required when node_id is set)."),
@@ -20185,7 +20187,7 @@ ${RENDER_ATTACH_RULE}`,
       // node_id too (destructive/openWorld apply "even in only select modes").
       annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true }
     },
-    async ({ items, audio_url, background_audio_url, background_audio_volume, duration_seconds, random_effects, transition, style_preset, texture, duotone, background_color, wait, node_id, form_id, captions }) => {
+    async ({ items, audio_url, background_audio_url, background_audio_volume, duration_seconds, preset, random_effects, transition, style_preset, texture, duotone, background_color, wait, node_id, form_id, captions }) => {
       if (node_id && !form_id) {
         return errorResult("form_id is required when node_id is set.");
       }
@@ -20204,8 +20206,14 @@ ${RENDER_ATTACH_RULE}`,
           background_audio_url,
           background_audio_volume,
           duration_seconds,
+          // preset expands to its base transition/style/background on the
+          // API side (expandVideoLook); transition/default_style/background_color
+          // below are only sent when the caller actually set the advanced
+          // override, so the API can tell "explicit" apart from "unset" and
+          // apply the look's own base value instead (#4038).
+          preset,
           random_effects: random_effects ?? true,
-          transition: transition ?? { type: "fade", duration: 1 },
+          transition,
           default_style,
           background_color,
           workspace_id
@@ -20765,4 +20773,4 @@ export {
   buildInstructions,
   createServer
 };
-//# sourceMappingURL=chunk-G32PAZBX.js.map
+//# sourceMappingURL=chunk-4YDGMSPG.js.map