@clipform/mcp-server 2.18.0 → 3.0.0

package/README.md

@@ -84,15 +84,14 @@ Your MCP client lists these automatically on connect (via `tools/list`). Full re
 | `clipform_log_generation` | Internal audit step run by a form-generation workflow. |
 | `clipform_search_news` | Fallback news lookup for clients without native web search. |
 | `clipform_generate_tts` | Generate narration audio from text with word-level captions. |
-| `clipform_generate_video` | Generate a video from images, video clips, or both, synced to an audio track. |
 | `clipform_search_media` | Search images or stock video clips. |
-| `clipform_render_composition` | 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. |
+| `clipform_render_composition` | 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. |
 | `clipform_search_music` | Search for royalty-free music tracks and ambient sounds. |
 | `clipform_list_compositions` | Browse available video compositions and their expected props schemas. |
 | `clipform_list_video_templates` | Browse available video templates - curated Scene arrangements (bed + overlay + sane defaults) that render through the Scene composition from a small controls object. |
 | `clipform_render_video_template` | Render a curated video template (a pre-arranged Scene: bed + overlay + sane defaults) to MP4 or PNG from a small controls object, instead of hand-assembling Scene layers. |
 | `clipform_list_assets` | List available creative assets (sound effects, animations, fonts) for video compositions. |
-| `clipform_check_render` | Check the status of render jobs started by clipform_generate_video, clipform_render_video_template, or clipform_render_composition. |
+| `clipform_check_render` | Check the status of render jobs started by clipform_render_video_template or clipform_render_composition. |
 | `clipform_fetch_boundary` | Fetch a GeoJSON boundary polygon for a country, city, or region. |
 | `clipform_get_guide` | Retrieve craft knowledge for building a specific form type. |
 | `clipform_get_workflow` | Retrieve a step-by-step build workflow for creating a specific form type. |

package/dist/{chunk-CHSPV2VI.js → chunk-EXV5M7YV.js}

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

package/dist/{chunk-WWIQEIFF.js → chunk-KCF7ZVDI.js}

@@ -3,7 +3,7 @@ import {
   WORKFLOW_TYPES,
   getDiscoveryParams,
   getSessionContextWithAuth
-} from "./chunk-RKYB6247.js";
+} from "./chunk-KNOCYZHG.js";
 import {
   __export
 } from "./chunk-G3PMV62Z.js";
@@ -4100,7 +4100,7 @@ function resourceLink(name, uri, title) {
 }
 var BUILD_ONCE_STEP = "**Build the whole form in ONE clipform_create_form call** - pass nodes, settings, and tags together; do NOT create an empty form and add nodes one by one:";
 var TAGS_LINE = "- tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words";
-var ATTACH_MEDIA_STEP = "**Attach media**: pass node_id (and form_id) on each render call (clipform_generate_video / clipform_render_video_template / clipform_render_composition) so it attaches to the node automatically once the render finishes - do not poll clipform_check_render to completion, just fire the renders and move on. Fall back to the manual two-step only for a render that didn't take a node_id: first clipform_upload_media_asset (batch all uploads in one call, include captions), then clipform_attach_node_media (batch all attachments in one call), setting show_captions: true and fit_media: true (generated renders must not be cropped).";
+var ATTACH_MEDIA_STEP = "**Attach media**: pass node_id (and form_id) on each render call (clipform_render_video_template / clipform_render_composition) so it attaches to the node automatically once the render finishes - do not poll clipform_check_render to completion, just fire the renders and move on. Fall back to the manual two-step only for a render that didn't take a node_id: first clipform_upload_media_asset (batch all uploads in one call, include captions), then clipform_attach_node_media (batch all attachments in one call), setting show_captions: true and fit_media: true (generated renders must not be cropped).";
 var REPUBLISH_STEP = "**Republish** with clipform_update_form (is_live: true) - forms are live from creation, but media and edits added since are only visible in the live form after republishing. Never skip this when you attached anything.";
 var LOG_STEP = "**Log** with clipform_log_generation";
 var TEXT_ONLY_OVERRIDE = "\n\n> **Text-only override:** If the user explicitly asked for text-only (no video), skip the video production and media attachment steps. Still generate narration.";
@@ -4130,7 +4130,7 @@ var quizWorkflow = (args, sessionContext, authMode, caps) => {
    ${TAGS_LINE}`,
     caps.media && "**Generate narration** with clipform_generate_tts - batch ALL questions in a single call (pass an array of items). Tease the question - do NOT reveal the answer or read options aloud. Keep each narration 5-15 seconds.",
     caps.media && `**Build video** for each question - pass each question's node_id (and form_id) on the render call so it attaches automatically once done. Pick per question; mixing treatments across one quiz is fine:
-   - Default - narrated slideshow: clipform_search_media (kind: "image", 3 images per question, batch all queries in one call), then clipform_generate_video with wait: false per question - fires all renders in parallel - then collect URLs with clipform_check_render.
+   - Default - narrated slideshow: clipform_search_media (kind: "image", 3 images per question, batch all queries in one call), then clipform_render_video_template (template: "slideshow", controls.items + controls.audio_url) with wait: false per question - fires all renders in parallel - then collect URLs with clipform_check_render.
    - Designed visual - when a recipe or composition fits the question or the user asks for one (e.g. a versus, a grid reveal, guess-the-city): recipe book first - clipform_list_video_templates and match the mechanic to a recipe, then clipform_render_video_template with its curated controls (wait: false, one call per question). Only if no recipe fits, drop to the raw primitives - clipform_list_compositions, then ONE clipform_render_composition call with items (all clips render in parallel). Collect job_ids with clipform_check_render. Both take narration via sound.narration.`,
     caps.media && ATTACH_MEDIA_STEP,
     REPUBLISH_STEP,
@@ -4208,7 +4208,7 @@ var comprehensionQuizWorkflow = (args, sessionContext, authMode, caps) => {
     caps.media && `**Generate narration** with clipform_generate_tts - batch ALL questions in a single call. Reference the video naturally: "If you watched closely, you'll know this one..." Keep each narration 5-10 seconds.`,
     caps.media && `**Build video** for each question:
    - clipform_search_media (kind: "image") - 3 images per question, batch all queries in one call
-   - clipform_generate_video with wait: false per question - fires all renders in parallel - then collect URLs with clipform_check_render`,
+   - clipform_render_video_template (template: "slideshow", controls.items + controls.audio_url) with wait: false per question - fires all renders in parallel - then collect URLs with clipform_check_render`,
     caps.media && ATTACH_MEDIA_STEP,
     REPUBLISH_STEP,
     caps.research && `${LOG_STEP} - include the YouTube URL and video title/channel as sources, using whatever of those the user provided`
@@ -4276,7 +4276,7 @@ var interviewWorkflow = (args, sessionContext, authMode, caps) => {
    - Consent node - "I agree that my response may be used in [context]"` : ""}
    - End screen that sets expectations: "Thanks! We'll be in touch."
    ${TAGS_LINE}`,
-    caps.media && `**Optional - Rich Media:** Add TTS narration (clipform_generate_tts, batch all questions in one call) with a warm, inviting tone - "We'd love to hear your story..." Video backgrounds (clipform_search_media \u2192 clipform_generate_video) on the intro question can set a professional tone.`,
+    caps.media && `**Optional - Rich Media:** Add TTS narration (clipform_generate_tts, batch all questions in one call) with a warm, inviting tone - "We'd love to hear your story..." Video backgrounds (clipform_search_media \u2192 clipform_render_video_template slideshow) on the intro question can set a professional tone.`,
     REPUBLISH_STEP,
     caps.research && LOG_STEP
   ]);
@@ -4300,7 +4300,7 @@ var surveyWorkflow = (args, sessionContext, authMode, caps) => {
    - Contact collection (type: "details") - name + email for follow-up` : ""}
    - End screen: "Thanks for your feedback!"
    ${TAGS_LINE}`,
-    caps.media && "**Optional - Rich Media:** For a more engaging experience, add TTS narration (clipform_generate_tts) for the intro or key questions, video backgrounds (clipform_search_media \u2192 clipform_generate_video), or background music (clipform_search_music).",
+    caps.media && "**Optional - Rich Media:** For a more engaging experience, add TTS narration (clipform_generate_tts) for the intro or key questions, video backgrounds (clipform_search_media \u2192 clipform_render_video_template slideshow), or background music (clipform_search_music).",
     REPUBLISH_STEP,
     caps.research && LOG_STEP
   ]);
@@ -4356,7 +4356,7 @@ var applicationWorkflow = (args, sessionContext, authMode, caps) => {
    - Optional "Anything else?" (type: "open") - catches things you didn't think to ask.
    - End screen: "Your application has been submitted. We'll review it and get back to you." icon: "tick", no score, no restart
    - tags: format "application", genre "screening", and 2-3 topic words`,
-    caps.media && `**Optional - Rich Media:** Add TTS narration (clipform_generate_tts) - professional and welcoming: "Thanks for your interest - let's get to know you." Video backgrounds (clipform_search_media \u2192 clipform_generate_video) on the intro can make the application feel more personal.`,
+    caps.media && `**Optional - Rich Media:** Add TTS narration (clipform_generate_tts) - professional and welcoming: "Thanks for your interest - let's get to know you." Video backgrounds (clipform_search_media \u2192 clipform_render_video_template slideshow) on the intro can make the application feel more personal.`,
     REPUBLISH_STEP,
     caps.research && LOG_STEP
   ]);
@@ -4378,7 +4378,7 @@ var bookingWorkflow = (args, sessionContext, authMode, caps) => {
    - 1-3 event-specific questions (type: "choice") - session preferences, dietary requirements, experience level. Only ask what you'll use.
    - End screen: "You're registered! Here's what to expect." Include event details (date, time, location/link) in the message. icon: "tick", no score, no restart, cta_type: "external_link" with a URL to calendar invite or event page (if available)
    - tags: format "registration", genre "${eventType}", and 2-3 topic words`,
-    caps.media && "**Optional: add welcome video** - a short intro from the host. Generate narration with clipform_generate_tts, then build a video with clipform_search_media + clipform_generate_video.",
+    caps.media && "**Optional: add welcome video** - a short intro from the host. Generate narration with clipform_generate_tts, then build a video with clipform_search_media + clipform_render_video_template (slideshow).",
     REPUBLISH_STEP,
     caps.research && LOG_STEP
   ]);
@@ -4404,7 +4404,7 @@ var intakeWorkflow = (args, sessionContext, authMode, caps) => {
    - Optional "Anything else?" (type: "open") - catches what you didn't think to ask
    - End screen: "Thanks! We've got your details and we'll be in touch shortly." icon: "tick", no score, no restart
    - tags: format "intake", genre "onboarding", and 2-3 topic words`,
-    caps.media && "**Optional: add a welcome video** - a short personal intro from you. Generate narration with clipform_generate_tts, then build a video with clipform_search_media + clipform_generate_video.",
+    caps.media && "**Optional: add a welcome video** - a short personal intro from you. Generate narration with clipform_generate_tts, then build a video with clipform_search_media + clipform_render_video_template (slideshow).",
     REPUBLISH_STEP,
     caps.research && LOG_STEP
   ]);
@@ -4856,4 +4856,4 @@ export {
   getWorkflowText,
   registerPrompts
 };
-//# sourceMappingURL=chunk-WWIQEIFF.js.map
+//# sourceMappingURL=chunk-KCF7ZVDI.js.map