@clipform/mcp-server 2.15.6 → 2.15.8

package/dist/{chunk-R4UBAYL4.js → chunk-5POJOTRI.js}

@@ -5,7 +5,7 @@ import {
   FULL_CAPS,
   callApi,
   getSessionContext
-} from "./chunk-XJZKMMY2.js";
+} from "./chunk-4DVA4LDZ.js";
 
 // src/lib/guides.ts
 var guidesPromise = null;
@@ -143,4 +143,4 @@ export {
   getGuideUri,
   registerResources
 };
-//# sourceMappingURL=chunk-R4UBAYL4.js.map
+//# sourceMappingURL=chunk-5POJOTRI.js.map

package/dist/{chunk-T3VQC2RR.js → chunk-AE4G2LMQ.js}

@@ -3,7 +3,7 @@ import {
   WORKFLOW_TYPES,
   getDiscoveryParams,
   getSessionContextWithAuth
-} from "./chunk-XJZKMMY2.js";
+} from "./chunk-4DVA4LDZ.js";
 import {
   __export
 } from "./chunk-G3PMV62Z.js";
@@ -4856,4 +4856,4 @@ export {
   getWorkflowText,
   registerPrompts
 };
-//# sourceMappingURL=chunk-T3VQC2RR.js.map
+//# sourceMappingURL=chunk-AE4G2LMQ.js.map

package/dist/{chunk-TGVK6XPX.js → chunk-DFR7RHPM.js}

@@ -6,7 +6,7 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-T3VQC2RR.js";
+} from "./chunk-AE4G2LMQ.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
@@ -15,7 +15,7 @@ import {
   getGuideUri,
   guideFallbackText,
   registerResources
-} from "./chunk-R4UBAYL4.js";
+} from "./chunk-5POJOTRI.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-XJZKMMY2.js";
+} from "./chunk-4DVA4LDZ.js";
 import {
   getMcpAuth,
   runWithMcpTool
@@ -17922,7 +17923,20 @@ function registerUpdateFormTool(server) {
         updates.push(`Tags \u2192 [${tags.join(", ")}]`);
         updatedFields.push("tags");
       }
-      return structuredResult(`Form updated: ${updates.join(", ")}`, { form_id, updated_fields: updatedFields });
+      let resultText = `Form updated: ${updates.join(", ")}`;
+      if (is_live === true) {
+        const meta = await callApi(`/forms/${form_id}`, { timeoutMs: 5e3 });
+        const urls = meta.ok ? meta.data.urls : void 0;
+        const viewerUrl = urls?.viewer;
+        const responsesUrl = urls?.responses;
+        if (viewerUrl) {
+          resultText += `
+
+Your form is live at: ${viewerUrl}
+Share this URL with respondents. View responses any time with clipform_get_results (form_id: ${form_id})${responsesUrl ? `, or in the dashboard: ${responsesUrl}` : ""}`;
+        }
+      }
+      return structuredResult(resultText, { form_id, updated_fields: updatedFields });
     }
   );
 }
@@ -18810,6 +18824,7 @@ function registerAttachNodeMediaTool(server) {
 `);
       }
       if (successCount === 0) return errorResult(lines.join("\n"));
+      lines.push("Media attached. It becomes visible to respondents after you republish with clipform_update_form (is_live: true).");
       return structuredResult(lines.join("\n"), { results });
     }
   );
@@ -20122,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."),
@@ -20133,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)."),
@@ -20171,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.");
       }
@@ -20190,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
@@ -20751,4 +20773,4 @@ export {
   buildInstructions,
   createServer
 };
-//# sourceMappingURL=chunk-TGVK6XPX.js.map
+//# sourceMappingURL=chunk-DFR7RHPM.js.map