@clipform/mcp-server 1.36.0 → 1.37.0

package/README.md

@@ -75,7 +75,7 @@ You can also pass the key as a CLI flag: `npx -y @clipform/mcp-server --api-key=
 
 | Tool | Description |
 |------|-------------|
-| `clipform_upload_node_media` | Attach video or image to one or more nodes (batch, max 10) |
+| `clipform_upload_node_media` | Attach video or image to one or more nodes (batch, max 10); set `fit_media: true` for generated renders |
 | `clipform_get_node_media` | View a node's media details |
 | `clipform_delete_node_media` | Remove media from a node (asks the user to confirm) |
 | `clipform_attach_audio` | Attach audio to a still-image node |

package/dist/{chunk-CN4XBVFD.js → chunk-5L2KPKOE.js}

@@ -6,14 +6,14 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-6MLZZSNM.js";
+} from "./chunk-XOYZMNJD.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
   getGuideContent,
   getGuideUri,
   registerResources
-} from "./chunk-2AJMWM5W.js";
+} from "./chunk-AZ33QQ4H.js";
 import {
   BUSINESS,
   CONTACT_FIELDS,
@@ -29,7 +29,7 @@ import {
   errorResult,
   resolveFormType,
   textResult
-} from "./chunk-BYJMRIB6.js";
+} from "./chunk-UA3MYEUA.js";
 import {
   __commonJS,
   __export,
@@ -16983,8 +16983,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",
+  "Map",
   "MapPin",
   "Grid",
   "GridList",
@@ -17782,7 +17781,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 +17791,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 +17816,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 +18381,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), round lat/lng to 1 decimal place (e.g. 48.9 instead of 48.8566) \u2014 this improves cache hit rates."),
         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 +18417,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")
       );
     }
   );
@@ -18639,7 +18643,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 +18690,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 +18724,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 +18799,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,
@@ -18998,4 +19004,4 @@ export {
   JSONRPCMessageSchema,
   createServer
 };
-//# sourceMappingURL=chunk-CN4XBVFD.js.map
+//# sourceMappingURL=chunk-5L2KPKOE.js.map