@clipform/mcp-server 2.18.0 → 3.0.0

package/dist/{chunk-Y4RGN6KA.js → chunk-QBPE32AV.js}

@@ -6,7 +6,7 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-WWIQEIFF.js";
+} from "./chunk-KCF7ZVDI.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
@@ -15,35 +15,27 @@ import {
   getGuideUri,
   guideFallbackText,
   registerResources
-} from "./chunk-CHSPV2VI.js";
+} from "./chunk-EXV5M7YV.js";
 import {
   ACTIVE_NODE_TYPES,
   CONTACT_FIELDS,
   FEATURE_FLAGS,
   FORM_TYPE_ALIASES,
   FULL_CAPS,
-  HTTP_URL_MESSAGE,
-  KEN_BURNS_EFFECTS,
-  KEN_BURNS_FIT_MODES,
-  KEN_BURNS_PRESETS,
   MCP_TOOL_TIERS,
   MCP_TOOL_TOOLSETS,
   NODE_TYPES,
   NON_COUNTABLE_TYPES,
-  SLIDESHOW_COMPOSITION_TRANSITIONS,
-  SLIDESHOW_TRANSITION_DURATION,
-  VIDEO_LOOK_NAMES,
   bfsOrder,
   callApi,
   capsFromToolsets,
   defaultTarget,
   errorResult,
   exposedCompositionIds,
-  isHttpUrl,
   resolveFormType,
   structuredResult,
   textResult
-} from "./chunk-RKYB6247.js";
+} from "./chunk-KNOCYZHG.js";
 import {
   getMcpAuth,
   runWithMcpTool
@@ -17111,7 +17103,6 @@ var NODE_TYPES_DESCRIPTION = (() => {
   return lines.join("\n");
 })();
 var CONFIG_FIELD_DESCRIPTION = "Type-specific configuration keyed by node type. Omit to use defaults. Per-type keys, shapes, and defaults are listed in the clipform_create_form description; craft guidance via clipform_get_guide.";
-var STYLE_PRESET_ENUM = external_exports.enum(KEN_BURNS_PRESETS).describe(`Ken Burns style preset: ${KEN_BURNS_PRESETS.join(", ")}`);
 var CaptionSchema = external_exports.object({
   start: external_exports.number().describe("Segment start time in seconds"),
   end: external_exports.number().describe("Segment end time in seconds"),
@@ -18832,7 +18823,7 @@ var MEDIA_SUPPORTED_TYPES = Object.entries(NODE_TYPES).filter(([, def]) => def.s
 var AttachMediaItemSchema = external_exports.object({
   node_id: external_exports.string().describe("The node ID"),
   media_asset_id: external_exports.string().describe("A media asset ID returned by clipform_upload_media_asset"),
-  fit_media: external_exports.boolean().optional().describe("Show the whole frame (contain) instead of cover-cropping. ALWAYS set true when attaching renders from clipform_render_composition or clipform_generate_video - they are composed 9:16 frames that must never be cropped. Leave unset for user-supplied media (arbitrary aspect ratios want the cover default)."),
+  fit_media: external_exports.boolean().optional().describe("Show the whole frame (contain) instead of cover-cropping. ALWAYS set true when attaching renders from clipform_render_composition or clipform_render_video_template - they are composed 9:16 frames that must never be cropped. Leave unset for user-supplied media (arbitrary aspect ratios want the cover default)."),
   show_captions: external_exports.boolean().optional().describe("Display captions/subtitles on the node. Defaults to on; pass false to hide them.")
 });
 function registerAttachNodeMediaTool(server) {
@@ -19301,7 +19292,7 @@ function registerSearchMediaTool(server) {
     "clipform_search_media",
     {
       title: "Search Media",
-      description: `Search images or stock video clips. Pass one query or many (max 10) - multiple queries run in one call instead of separate tool calls. Use results to feed into clipform_generate_video for narrated slideshow videos, or upload directly as still images via clipform_upload_media_asset then clipform_attach_node_media. All results are pre-cleared for commercial use. Results include a description (alt text where the provider has it) - use it to pick visually distinct images.
+      description: `Search images or stock video clips. Pass one query or many (max 10) - multiple queries run in one call instead of separate tool calls. Use results to feed into clipform_render_video_template (slideshow) for narrated slideshow videos, or upload directly as still images via clipform_upload_media_asset then clipform_attach_node_media. All results are pre-cleared for commercial use. Results include a description (alt text where the provider has it) - use it to pick visually distinct images.
 
 Example: { queries: [{ query: "saturn rings" }, { query: "mars surface", count: 3 }] } returns portrait images for both.`,
       inputSchema: {
@@ -19395,8 +19386,7 @@ Example: { queries: [{ query: "saturn rings" }, { query: "mars surface", count:
 }
 
 // src/lib/render-routing.ts
-var RENDER_ROUTING_RULE = `Choosing a render tool: for a recognisable form/quiz beat (guess-the-city, this-or-that, mystery reveal, multiple choice, photo montage...) reach for a video template first (clipform_list_video_templates + clipform_render_video_template) - it is a one-call recipe. Use clipform_generate_video for a narrated or audio-synced media montage (images/clips timed to a voice track). Use clipform_render_composition only when neither fits and you need a custom layer stack.`;
-var MONTAGE_NARRATION_RULE = `Montage disambiguation: choose clipform_generate_video when the montage is narrated or synced to an audio track; choose the slideshow video template when it is silent (motion + transitions only, no voice-over).`;
+var RENDER_ROUTING_RULE = `Choosing a render tool: for a recognisable form/quiz beat (guess-the-city, this-or-that, mystery reveal, multiple choice, photo montage...) reach for a video template first (clipform_list_video_templates + clipform_render_video_template) - it is a one-call recipe. For a photo/clip montage, narrated or silent, use the slideshow template (pass audio_url to sync it to a voice track). Use clipform_render_composition only when neither fits and you need a custom layer stack.`;
 var RENDER_ATTACH_RULE = `A render for a form node is not done until it is attached to that node. Pass node_id (and form_id) so the completed render attaches itself automatically - do not poll clipform_check_render to completion or manually chain clipform_upload_media_asset + clipform_attach_node_media; fire the render and move on.`;
 
 // ../../node_modules/.pnpm/uuid@11.1.1/node_modules/uuid/dist/esm/stringify.js
@@ -19680,7 +19670,7 @@ function registerRenderCompositionTool(server) {
     "clipform_render_composition",
     {
       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.
+      description: `Render a specialised video composition to MP4 or PNG - custom animated visuals that a video template 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.
 
 Output formats: mp4 (H.264, best for social media) or png (single frame). Returns a public URL when complete.
 
@@ -19825,7 +19815,7 @@ function registerSearchMusicTool(server) {
     "clipform_search_music",
     {
       title: "Search Music",
-      description: `Search for royalty-free music tracks and ambient sounds. Quiz forms especially benefit from background music - it keeps energy up between questions. Also consider it for multi-step surveys and longer forms. Pass the returned URL as the audio track to clipform_generate_video, or as the audio for the slideshow video template via clipform_render_video_template. Returns download URLs, duration, artist, and license info.`,
+      description: `Search for royalty-free music tracks and ambient sounds. Quiz forms especially benefit from background music - it keeps energy up between questions. Also consider it for multi-step surveys and longer forms. Pass the returned URL as the audio for the slideshow video template via clipform_render_video_template. Returns download URLs, duration, artist, and license info.`,
       inputSchema: {
         query: external_exports.string().min(1).describe("What to search for (e.g. 'upbeat quiz background', 'calm ambient', 'playful pizzicato')"),
         count: external_exports.number().int().min(1).max(10).default(5).optional().describe("Max results (default: 5)"),
@@ -19845,7 +19835,7 @@ function registerSearchMusicTool(server) {
             source: external_exports.string().optional(),
             license: external_exports.string().optional()
           })
-        ).describe("Matching tracks (empty if none); pass a url as the audio track to generate_video")
+        ).describe("Matching tracks (empty if none); pass a url as the audio for the slideshow template")
       },
       // Fetches from an external royalty-free music provider - openWorldHint:
       // true (#2976).
@@ -19915,7 +19905,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 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.`,
+      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) instead of a composition.`,
       inputSchema: {},
       outputSchema: {
         compositions: external_exports.array(
@@ -20214,180 +20204,6 @@ function registerListAssetsTool(server) {
   );
 }
 
-// src/tools/generate-video.ts
-var httpUrl = () => external_exports.string().url().refine(isHttpUrl, { message: HTTP_URL_MESSAGE });
-function registerGenerateVideoTool(server) {
-  server.registerTool(
-    "clipform_generate_video",
-    {
-      title: "Generate Video",
-      description: `Generate a video from images, video clips, or both, synced to an audio track. Use this for narrated question backgrounds, topic visualisations, or any form node that benefits from video. Combine with clipform_generate_tts for narrated audio and clipform_search_media for royalty-free images. Creates 9:16 (720x1280) with Ken Burns pan/zoom effects and transitions. Returns a public URL when complete.
-
-Items: type "image" (Ken Burns motion) or "video" (cover-cropped, muted by default). Duration matches audio_url or set duration_seconds explicitly.
-
-For multi-question builds, pass wait: false on every render: each call returns a job ID immediately, so all renders run in parallel - then collect URLs with clipform_check_render. Sequential waiting renders take ${RENDER_TIMING.expectedRange} EACH.
-
-${RENDER_ROUTING_RULE}
-${MONTAGE_NARRATION_RULE}
-${RENDER_ATTACH_RULE}`,
-      inputSchema: {
-        items: external_exports.array(
-          external_exports.object({
-            type: external_exports.enum(["image", "video"]).describe("'image' for still images with Ken Burns effects, 'video' for video clips"),
-            url: httpUrl().describe("Media URL"),
-            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."),
-            volume: external_exports.number().min(0).max(1).optional().describe("Clip audio volume 0-1 (video only, default 0 = muted)")
-          })
-        ).min(1).max(20).describe("Media items (images, video clips, or a mix)"),
-        audio_url: httpUrl().optional().describe("Audio track URL. Video duration matches audio duration."),
-        background_audio_url: httpUrl().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.enum(SLIDESHOW_COMPOSITION_TRANSITIONS).optional().describe(`Advanced override: ${SLIDESHOW_COMPOSITION_TRANSITIONS.join(", ")} - overrides the preset look's own transition`),
-          duration: external_exports.number().min(SLIDESHOW_TRANSITION_DURATION.min).max(SLIDESHOW_TRANSITION_DURATION.max).optional().describe(`Advanced override: transition duration in seconds (${SLIDESHOW_TRANSITION_DURATION.min}-${SLIDESHOW_TRANSITION_DURATION.max}). For a hard cut use type: 'none' instead - duration is ignored then.`)
-        }).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("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("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)."),
-        captions: external_exports.array(CaptionSchema).optional().describe("Word-level captions from clipform_generate_tts - carried onto the attached media asset. Only used when node_id is set.")
-      },
-      outputSchema: {
-        status: external_exports.enum(["rendering", "complete"]).describe("'rendering' when wait:false (poll check_render); 'complete' with a public_url when wait:true"),
-        job_id: external_exports.string().optional().describe("Present when status is 'rendering' - pass to check_render"),
-        public_url: external_exports.string().optional().describe("Present when status is 'complete' - attach via upload_media_asset then attach_node_media (fit_media: true), unless node_id was set (auto-attached)"),
-        duration_seconds: external_exports.number().optional(),
-        attached: external_exports.boolean().optional().describe("True when node_id was provided and the render was attached to the node automatically (present once the attach outcome is known)."),
-        media_asset_id: external_exports.string().optional().describe("The workspace media asset created from this render, when attached."),
-        republished: external_exports.boolean().optional().describe("True when the form was live and was republished to include this media."),
-        attach_error: external_exports.string().optional().describe("Present when node_id was provided but auto-attach failed - the render itself still succeeded.")
-      },
-      // node_id auto-attach replaces the node's existing media placement and
-      // republishes an already-live form - an indirect but real overwrite +
-      // publish (#2976 research pass 2), even though this tool works with no
-      // 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, 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.");
-      }
-      const default_style = style_preset || texture || duotone ? {
-        ...style_preset ? { preset: style_preset } : {},
-        ...texture ? { texture } : {},
-        ...duotone ? { duotone } : {}
-      } : void 0;
-      const apiCall = () => callApi("/internal/generate-video", {
-        timeoutMs: 3e5,
-        // local renders pay a cold webpack bundle; Lambda is fast but bursty
-        body: {
-          items,
-          audio_url,
-          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,
-          default_style,
-          background_color
-        }
-      });
-      if (wait === false) {
-        const job = createJob("clipform_generate_video");
-        const placeholderPromise2 = node_id && form_id ? createRenderPlaceholder({ formId: form_id, nodeId: node_id, mediaType: "video" }) : Promise.resolve(void 0);
-        apiCall().then(async (r) => {
-          if (!r.ok) {
-            failJob(job.id, r.error);
-            const placeholder = await placeholderPromise2;
-            if (placeholder) await failPlaceholder(placeholder, r.error);
-            return;
-          }
-          let attach2;
-          if (node_id && form_id) {
-            const publicUrl = r.data.public_url;
-            const placeholder = await placeholderPromise2;
-            if (publicUrl) {
-              attach2 = await autoAttachRender({ formId: form_id, nodeId: node_id, publicUrl, mediaType: "video", captions, captionRef: resolveCaptionRef(void 0, audio_url), placeholder });
-            } else {
-              const message = "Render completed without a public_url; nothing to attach.";
-              attach2 = { attached: false, error: message };
-              if (placeholder) await failPlaceholder(placeholder, message);
-            }
-          }
-          completeJob(job.id, r.data, attach2);
-        }).catch(async (err) => {
-          const message = err instanceof Error ? err.message : String(err);
-          failJob(job.id, message);
-          const placeholder = await placeholderPromise2;
-          if (placeholder) await failPlaceholder(placeholder, message);
-        });
-        return structuredResult(
-          [
-            `Render started (${items.length} item${items.length > 1 ? "s" : ""}).`,
-            `Job ID: ${job.id}`,
-            node_id ? `Will attach to node ${node_id} automatically once it completes - no need to poll to completion.` : `Fire any remaining renders now, then poll clipform_check_render. Renders typically take ${RENDER_TIMING.expectedRange}.`
-          ].join("\n"),
-          { status: "rendering", job_id: job.id }
-        );
-      }
-      const placeholderPromise = node_id && form_id ? createRenderPlaceholder({ formId: form_id, nodeId: node_id, mediaType: "video" }) : Promise.resolve(void 0);
-      const result = await apiCall();
-      if (!result.ok) {
-        const placeholder = await placeholderPromise;
-        if (placeholder) await failPlaceholder(placeholder, result.error);
-        return errorResult(result.error);
-      }
-      const data = result.data;
-      let attach;
-      if (node_id && form_id) {
-        const placeholder = await placeholderPromise;
-        if (data.public_url) {
-          attach = await autoAttachRender({ formId: form_id, nodeId: node_id, publicUrl: data.public_url, mediaType: "video", captions, captionRef: resolveCaptionRef(void 0, audio_url), placeholder });
-        } else if (placeholder) {
-          await failPlaceholder(placeholder, "Render completed without a public_url; nothing to attach.");
-        }
-      }
-      return structuredResult(
-        [
-          `Video rendered (${items.length} item${items.length > 1 ? "s" : ""}).`,
-          `Public URL: ${data.public_url}`,
-          data.duration_seconds ? `Duration: ${data.duration_seconds}s` : "",
-          attach ? attachSummaryLine(node_id, attach) : `Attach via clipform_upload_media_asset then clipform_attach_node_media with fit_media: true (composed 9:16 frame - contain, never crop).`
-        ].filter(Boolean).join("\n"),
-        {
-          status: "complete",
-          ...data.public_url ? { public_url: data.public_url } : {},
-          ...typeof data.duration_seconds === "number" ? { duration_seconds: data.duration_seconds } : {},
-          ...attachStructuredFields(attach)
-        }
-      );
-    }
-  );
-}
-
 // src/tools/check-render.ts
 function projectJob(id, job) {
   if (!job) return { job_id: id, status: "not_found" };
@@ -20410,7 +20226,7 @@ var LOST_JOB_RECOVERY = [
   `Jobs expire after 30 minutes and are lost if the server restarts - the render itself may still have completed.`,
   `To recover, re-run the original render call with identical arguments:`,
   `- clipform_render_composition results are content-cached: a finished render returns its URL immediately without re-rendering.`,
-  `- clipform_generate_video is not cached and will re-render.`
+  `- clipform_render_video_template results are content-cached too: re-running with identical controls returns the finished URL.`
 ].join("\n");
 function describeJob(id, job) {
   if (!job) {
@@ -20436,7 +20252,7 @@ function registerCheckRenderTool(server) {
     "clipform_check_render",
     {
       title: "Check Render Status",
-      description: `Check the status of render jobs started by clipform_generate_video, clipform_render_video_template, or clipform_render_composition.
+      description: `Check the status of render jobs started by clipform_render_video_template or clipform_render_composition.
 
 Pass job_ids to check a whole batch in ONE call - one line of status per job. Pass job_id for a single job. Returns the output URL for each completed render. Typical render time: 10-60 seconds. Attach is automatic when node_id was provided to the render tool - no need to poll to completion, and the attach outcome is reported here once known.`,
       inputSchema: {
@@ -20846,7 +20662,6 @@ function createServer(options) {
   registerLogGenerationTool(server);
   registerSearchNewsTool(server);
   registerGenerateTtsTool(server);
-  registerGenerateVideoTool(server);
   registerSearchMediaTool(server);
   registerRenderCompositionTool(server);
   registerSearchMusicTool(server);
@@ -20870,4 +20685,4 @@ export {
   buildInstructions,
   createServer
 };
-//# sourceMappingURL=chunk-Y4RGN6KA.js.map
+//# sourceMappingURL=chunk-QBPE32AV.js.map