@clipform/mcp-server 1.36.0 → 1.38.0

package/dist/{chunk-CN4XBVFD.js → chunk-WHNDWLHI.js}

@@ -6,14 +6,15 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-6MLZZSNM.js";
+} from "./chunk-QT3RFCCN.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
-  getGuideContent,
+  fetchGuideText,
   getGuideUri,
+  guideFallbackText,
   registerResources
-} from "./chunk-2AJMWM5W.js";
+} from "./chunk-ZTJU467D.js";
 import {
   BUSINESS,
   CONTACT_FIELDS,
@@ -22,6 +23,7 @@ import {
   KEN_BURNS_EFFECTS,
   KEN_BURNS_FIT_MODES,
   KEN_BURNS_PRESETS,
+  MCP_TOOL_TIERS,
   NODE_TYPES,
   NON_COUNTABLE_TYPES,
   SLIDESHOW_TRANSITIONS,
@@ -29,7 +31,7 @@ import {
   errorResult,
   resolveFormType,
   textResult
-} from "./chunk-BYJMRIB6.js";
+} from "./chunk-KBWMI24E.js";
 import {
   __commonJS,
   __export,
@@ -16983,9 +16985,7 @@ var _endScreen = NODE_TYPES.end_screen.config_schema.properties;
 var END_SCREEN_ICONS = _endScreen.icon.enum;
 var END_SCREEN_CTA_TYPES = _endScreen.cta_type.enum;
 var PUBLIC_COMPOSITIONS = [
-  "GlobeToCity",
-  "CityToGlobe",
-  "MapPin",
+  "Map",
   "Grid",
   "GridList",
   "ObscuredReveal",
@@ -17006,7 +17006,9 @@ var PUBLIC_COMPOSITIONS = [
 ];
 var LABS_COMPOSITIONS = [
   "StatCounter",
-  "ListReveal"
+  "ListReveal",
+  "Scene",
+  "Spin3D"
 ];
 var EXPOSED_COMPOSITIONS = process.env.CLIPFORM_LABS === "1" ? [...PUBLIC_COMPOSITIONS, ...LABS_COMPOSITIONS] : PUBLIC_COMPOSITIONS;
 
@@ -17782,7 +17784,8 @@ var MediaItemSchema = external_exports.object({
       ).optional().describe("Per-word timestamps within the segment")
     })
   ).optional().describe("Word-level captions from clipform_generate_tts. Required for per-word highlighting - pass the full objects including 'words' arrays."),
-  show_captions: external_exports.boolean().optional().default(true).describe("Display captions/subtitles on the node")
+  show_captions: external_exports.boolean().optional().default(true).describe("Display captions/subtitles on the node"),
+  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).")
 });
 function registerUploadNodeMediaTool(server) {
   server.registerTool(
@@ -17791,7 +17794,7 @@ function registerUploadNodeMediaTool(server) {
       title: "Upload Node Media",
       description: `Upload media for one or more nodes. Pass one item or many (max 10). Multiple items upload sequentially.
 
-When a public URL is provided, the media is fetched and stored automatically. Only works on node types that support media (${MEDIA_SUPPORTED_TYPES.join(", ")}). For video: ingested via Mux. For image: stored in Supabase. Captions from clipform_generate_tts enable per-word highlighting in the viewer.`,
+When a public URL is provided, the media is fetched and stored automatically. Only works on node types that support media (${MEDIA_SUPPORTED_TYPES.join(", ")}). For video: ingested via Mux. For image: stored in Supabase. Captions from clipform_generate_tts enable per-word highlighting in the viewer. When attaching renders from clipform_render_composition or clipform_generate_video, set fit_media: true on each item.`,
       inputSchema: {
         form_id: external_exports.string().uuid().describe("The form UUID (returned by clipform_create_form, not the short share_id from the URL)"),
         items: external_exports.array(MediaItemSchema).min(1).max(10).describe("One or more media items to upload")
@@ -17816,6 +17819,7 @@ When a public URL is provided, the media is fetched and stored automatically. On
         if (item.url) body.url = item.url;
         if (item.captions) body.captions = item.captions;
         if (item.show_captions !== void 0) body.show_captions = item.show_captions;
+        if (item.fit_media !== void 0) body.fit_media = item.fit_media;
         const result = await callApi(
           `/forms/${form_id}/nodes/${item.node_id}/media`,
           { method: "POST", body }
@@ -18380,7 +18384,7 @@ For multi-render builds (e.g. composition quizzes with a clue + reveal clip per
       inputSchema: {
         compositionId: external_exports.string().describe(`The composition ID. Call clipform_list_compositions to see available options (e.g. ${EXPOSED_COMPOSITIONS.map((id) => `'${id}'`).join(", ")})`),
         outputFormat: external_exports.enum(["mp4", "png"]).default("mp4").describe("Output format (default: mp4)"),
-        inputProps: external_exports.record(external_exports.unknown()).optional().describe("Props object matching the composition's schema from clipform_list_compositions. Validated STRICTLY - unknown or missing props fail with the schema in the error, nothing renders silently with defaults. For map compositions (GlobeToCity, CityToGlobe), round lat/lng to 1 decimal place (e.g. 48.9 instead of 48.8566) \u2014 this improves cache hit rates."),
+        inputProps: external_exports.record(external_exports.unknown()).optional().describe("Props object matching the composition's schema from clipform_list_compositions. Validated STRICTLY - unknown or missing props fail with the schema in the error, nothing renders silently with defaults. For map compositions (Map), wide shots (camera.zoom < 9) may round lat/lng to 1 decimal place to improve cache hit rates; close shots and pin drops should keep full precision \u2014 the pin lands exactly on `target`."),
         wait: external_exports.boolean().optional().default(true).describe("true (default) blocks until the render 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 clip.")
       },
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
@@ -18416,7 +18420,10 @@ For multi-render builds (e.g. composition quizzes with a clue + reveal clip per
       if (!result.ok) return errorResult(result.error);
       const data = result.data;
       return textResult(
-        `Render complete. Public URL: ${data.public_url}`
+        [
+          `Render complete. Public URL: ${data.public_url}`,
+          `Attach via clipform_upload_node_media with fit_media: true (composed 9:16 frame - contain, never crop).`
+        ].join("\n")
       );
     }
   );
@@ -18590,6 +18597,8 @@ For multi-question builds, pass wait: false on every render: each call returns a
           })
         ).min(1).max(20).describe("Media items (images, video clips, or a mix)"),
         audio_url: external_exports.string().url().optional().describe("Audio track URL. Video duration matches audio duration."),
+        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)"),
         random_effects: external_exports.boolean().optional().default(true).describe("Shuffle Ken Burns effects across image items (default: true)"),
         transition: external_exports.object({
@@ -18597,23 +18606,40 @@ For multi-question builds, pass wait: false on every render: each call returns a
           duration: external_exports.number().optional().default(1).describe("Transition duration in seconds (default: 1)")
         }).optional(),
         style_preset: STYLE_PRESET_ENUM.optional(),
+        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)"),
+        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')"),
         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.")
       },
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
     },
-    async ({ items, audio_url, duration_seconds, random_effects, transition, style_preset, background_color, wait }) => {
+    async ({ items, audio_url, background_audio_url, background_audio_volume, duration_seconds, random_effects, transition, style_preset, texture, duotone, background_color, wait }) => {
       const workspace_id = getMcpAuth()?.workspace_id;
+      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,
           random_effects: random_effects ?? true,
           transition: transition ?? { type: "fade", duration: 1 },
-          default_style: style_preset ? { preset: style_preset } : void 0,
+          default_style,
           background_color,
           workspace_id
         }
@@ -18639,7 +18665,8 @@ For multi-question builds, pass wait: false on every render: each call returns a
         [
           `Video rendered (${items.length} item${items.length > 1 ? "s" : ""}).`,
           `Public URL: ${data.public_url}`,
-          data.duration_seconds ? `Duration: ${data.duration_seconds}s` : ""
+          data.duration_seconds ? `Duration: ${data.duration_seconds}s` : "",
+          `Attach via clipform_upload_node_media with fit_media: true (composed 9:16 frame - contain, never crop).`
         ].filter(Boolean).join("\n")
       );
     }
@@ -18685,7 +18712,8 @@ Returns the current status and, when complete, the output URL. Typical render ti
         [
           `Render complete.`,
           ...data.public_url ? [`Public URL: ${data.public_url}`] : [],
-          ...data.duration_seconds ? [`Duration: ${data.duration_seconds}s`] : []
+          ...data.duration_seconds ? [`Duration: ${data.duration_seconds}s`] : [],
+          `Attach via clipform_upload_node_media with fit_media: true (composed 9:16 frame - contain, never crop).`
         ].join("\n")
       );
     }
@@ -18718,7 +18746,7 @@ function registerFetchBoundaryTool(server) {
     "clipform_fetch_boundary",
     {
       title: "Fetch Geographic Boundary",
-      description: `Fetch a GeoJSON boundary polygon for a country, city, or region. Returns simplified GeoJSON ready to use as the 'boundary' prop in GlobeToCity/CityToGlobe compositions.
+      description: `Fetch a GeoJSON boundary polygon for a country, city, or region. Returns simplified GeoJSON ready to use as the 'boundary' prop in the Map composition.
 
 mainlandOnly excludes small islands and overseas territories (e.g. Corsica for France, Hawaii for USA).`,
       inputSchema: {
@@ -18793,7 +18821,7 @@ mainlandOnly excludes small islands and overseas territories (e.g. Corsica for F
           `Size: ${sizeKb} KB`,
           mainlandOnly ? `Mainland filter: applied (islands < 5% of largest landmass removed)` : `Mainland filter: off`,
           ``,
-          `Use this as the boundary.geojson prop in GlobeToCity:`,
+          `Use this as the boundary.geojson prop in Map:`,
           ``,
           "```json",
           geojsonStr,
@@ -18839,8 +18867,8 @@ Quiz variants (optional): ${QUIZ_VARIANTS.join(", ")} - appends variant-specific
       }
       const type = resolved;
       const validVariant = type === "quiz" ? variant : void 0;
-      const content = getGuideContent(type, validVariant);
       const uri = getGuideUri(type, validVariant);
+      const content = await fetchGuideText(uri) ?? guideFallbackText(uri);
       return {
         content: [{
           type: "resource",
@@ -18948,6 +18976,10 @@ function createServer(options) {
   );
   const _registerTool = server.registerTool.bind(server);
   server.registerTool = (name, config2, handler) => {
+    const requiredTier = MCP_TOOL_TIERS[name] ?? 0;
+    if (options?.planTier !== void 0 && requiredTier > options.planTier) {
+      return void 0;
+    }
     return _registerTool(
       name,
       config2,
@@ -18998,4 +19030,4 @@ export {
   JSONRPCMessageSchema,
   createServer
 };
-//# sourceMappingURL=chunk-CN4XBVFD.js.map
+//# sourceMappingURL=chunk-WHNDWLHI.js.map