@clipform/mcp-server 1.47.1 → 2.0.0

package/README.md

@@ -71,7 +71,8 @@ Your MCP client lists these automatically on connect (via `tools/list`). Full re
 | `clipform_add_node` | Add a new node to an existing form. |
 | `clipform_update_node` | Update one or more existing nodes' text, type, config, or options. |
 | `clipform_delete_node` | Delete a node from a form. |
-| `clipform_upload_node_media` | Upload media for one or more nodes. |
+| `clipform_upload_media_asset` | Put one or more media files into your workspace media library (max 10, uploaded sequentially). |
+| `clipform_attach_node_media` | Attach an existing workspace media asset (from clipform_upload_media_asset) to one or more nodes (max 10). |
 | `clipform_get_node_media` | Get the media attached to a node, including processing status. |
 | `clipform_delete_node_media` | Remove media from a node. |
 | `clipform_set_logic` | Set routing logic on one or more nodes. |
@@ -84,8 +85,10 @@ Your MCP client lists these automatically on connect (via `tools/list`). Full re
 | `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_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 or clipform_render_composition. |
+| `clipform_check_render` | Check the status of render jobs started by clipform_generate_video, 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-MV27JVSL.js → chunk-6U3CVTLZ.js}

@@ -2,7 +2,7 @@ import {
   WORKFLOW_TYPES,
   getDiscoveryParams,
   getSessionContextWithAuth
-} from "./chunk-PJNOCHKR.js";
+} from "./chunk-GDUJLYR4.js";
 import {
   __export
 } from "./chunk-HCZI2UJ5.js";
@@ -4099,7 +4099,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** with clipform_upload_node_media (batch all uploads in one call). Include captions, set 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_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 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.";
 function quizWorkflow(args, sessionContext, authMode = "authenticated") {
   const topic = args.topic ? ` about "${args.topic}"` : "";
@@ -4122,9 +4122,9 @@ function quizWorkflow(args, sessionContext, authMode = "authenticated") {
      - NOTE: Personalised messages per score tier (score_ranges) are coming soon. For now, write one great end screen message that works for all scores.
    ${TAGS_LINE}
 4. **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.
-5. **Build video** for each question - pick per question; mixing treatments across one quiz is fine:
+5. **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.
-   - Designed visual - when a composition fits the question or the user asks for one (e.g. a grid reveal): clipform_list_compositions to see what's available, then ONE clipform_render_composition call with items (all clips render in parallel), collected with one clipform_check_render (job_ids). Compositions take narration via sound.narration.
+   - 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.
 6. ${ATTACH_MEDIA_STEP}
 7. ${REPUBLISH_STEP}
 8. **Log** with clipform_log_generation (sources, images, attributions)
@@ -4220,13 +4220,13 @@ function compositionQuizWorkflow(args, sessionContext, authMode = "authenticated
   const topic = args.topic ? ` about "${args.topic}"` : "";
   const count = args.question_count ?? 5;
   const discovery = buildDiscovery(getDiscoveryParams("quiz", "composition", authMode === "anonymous" ? "demo" : "full"), args, authMode);
-  return `${sessionContext ? sessionContext + "\n\n" : ""}${discovery}Here's how to build a ${count}-question composition quiz${topic} with Clipform - a guess-and-reveal quiz where each question is a rendered composition (flag sweep, emoji rebus, blurred photo resolving) instead of a stock-image slideshow. Read the attached quiz and composition guides for the mechanic matrix, the clue \u2192 reveal node pattern, and difficulty design.
+  return `${sessionContext ? sessionContext + "\n\n" : ""}${discovery}Here's how to build a ${count}-question composition quiz${topic} with Clipform - a guess-and-reveal quiz where each question is a rendered composition (flag sweep, Rebus, blurred photo resolving) instead of a stock-image slideshow. Read the attached quiz and composition guides for the mechanic matrix, the clue \u2192 reveal node pattern, and difficulty design.
 
 ## Composition Quiz Workflow
 
-1. **Discover what's renderable** - call clipform_list_compositions. Availability varies by session; choose mechanics ONLY from what it returns. Match each question to a mechanic via the composition guide's matrix. Mix 2-3 mechanics across the quiz; for questions with no fitting composition, use the base quiz's Ken Burns pipeline instead.
+1. **Discover what's renderable - recipe book first.** Call clipform_list_video_templates and match each question's mechanic against a recipe's description/keywords (e.g. guess-the-city for a where-in-the-world/geography mechanic, mystery-reveal for guess-the-image/flag, colour-grid for palette-matching). Render a matched recipe with clipform_render_video_template and its curated controls. Only when no recipe fits a question, drop to the raw primitives - clipform_list_compositions, matched via the composition guide's matrix - and render with clipform_render_composition. Availability varies by session; choose ONLY from what these tools return. Mix 2-3 mechanics across the quiz; for questions with no fitting recipe or composition, use the base quiz's Ken Burns pipeline instead.
 2. **Write questions** - difficulty curve as in the base guide. Difficulty = subject obscurity (Japan's flag vs Kiribati's), never clue degradation. ${count} questions \u2248 ${count * 2 + 1} nodes (each question is a clue + reveal pair) - check the plan's node limit.
-3. **Render all clips** in ONE clipform_render_composition call with items - the full batch (clue clip + reveal clip per question) renders in parallel - then collect URLs with one clipform_check_render (job_ids). Chain-state compositions: clue clip animate: true, reveal clip animate: false + answer props.
+3. **Render all clips** - raw-composition clips batch in ONE clipform_render_composition call with items (parallel); recipe clips render one clipform_render_video_template call each (wait: false). Collect all job_ids with clipform_check_render. Chain-state compositions: clue clip animate: true, reveal clip animate: false + answer props.
 4. ${BUILD_ONCE_STEP}
    - Settings: show_step_counter: true, disable_back_navigation: true
    - Per question, a PAIR of nodes:
@@ -4235,7 +4235,7 @@ function compositionQuizWorkflow(args, sessionContext, authMode = "authenticated
    - Final end_screen node: show_score: true, icon: "trophy", show_share_button: true, cta_type: "restart", cta_text: a short challenge. NOTE: per-tier messages (score_ranges) are coming soon - write one great message.
    - tags: format "quiz", genre "trivia", and 2-3 topic words
 5. **Generate narration** with clipform_generate_tts - batch ALL items in one call. The visual does the teasing: set stakes, never describe what's on screen or read the clue aloud. Reveal narration can celebrate.
-6. **Attach media** with clipform_upload_node_media (batch all uploads in one call) - clue clip on each choice node, reveal clip on each button node. Include captions, set show_captions: true and fit_media: true (generated renders must not be cropped).
+6. ${ATTACH_MEDIA_STEP} Attach the clue clip to each choice node and the reveal clip to each button node.
 7. ${REPUBLISH_STEP}
 8. **Log** with clipform_log_generation - record the composition IDs used per question alongside sources and attributions`;
 }
@@ -4253,7 +4253,7 @@ function interviewWorkflow(args, sessionContext, authMode = "authenticated") {
    - Settings: show_step_counter: true, disable_back_navigation: false
    - Warm-up question first (type: "open") - something easy: "Tell us your name and role"
    - 2-3 core questions (type: "open") - one topic per question.${format === "all" ? " Enable text + audio + video responses." : ` Enable ${format} responses.`}
-   - Contact collection (type: "contact") - first name + email minimum${consent ? `
+   - Contact collection (type: "details") - first name + email minimum${consent ? `
    - 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}
@@ -4275,7 +4275,7 @@ function surveyWorkflow(args, sessionContext, authMode = "authenticated") {
    - Key metric question FIRST (type: "choice" or "rating") - while attention is highest
    - One "why?" follow-up (type: "open") - "What's the main reason for your score?"
    - 2-3 specific questions (type: "choice") - only ask what you'll act on${!anonymous ? `
-   - Contact collection (type: "contact") - name + email for follow-up` : ""}
+   - Contact collection (type: "details") - name + email for follow-up` : ""}
    - End screen: "Thanks for your feedback!"
    ${TAGS_LINE}
 3. **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).
@@ -4324,7 +4324,7 @@ function applicationWorkflow(args, sessionContext, authMode = "authenticated") {
 1. **Define what you're screening for** - what qualifications matter, and what questions reveal fit?
 2. ${BUILD_ONCE_STEP}
    - Settings: show_step_counter: true, disable_back_navigation: false
-   - Contact collection first (type: "contact") - name, email, phone - while motivation is high
+   - Contact collection first (type: "details") - name, email, phone - while motivation is high
    - 2-3 structured screening questions (type: "choice") - experience level, availability, relevant qualifications. These help you filter quickly.
    - 1-2 open response questions (type: "open") - "Tell us why you're interested" or "Walk us through a relevant experience." Enable video + audio + text responses.
    - Optional "Anything else?" (type: "open") - catches things you didn't think to ask.
@@ -4345,7 +4345,7 @@ function bookingWorkflow(args, sessionContext, authMode = "authenticated") {
 1. **Define the essentials** - what info do you actually need from attendees? Keep the list short.
 2. ${BUILD_ONCE_STEP}
    - Settings: show_step_counter: false (it's so short, a counter adds unnecessary UI), disable_back_navigation: false
-   - Contact collection (type: "contact") - name + email minimum. Add phone only if needed.
+   - Contact collection (type: "details") - name + email minimum. Add phone only if needed.
    - 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
@@ -4559,7 +4559,7 @@ Outcome categories: ${args.categories}` : "";
     "create-composition-quiz",
     {
       title: "Create a Composition Quiz",
-      description: "Build a guess-and-reveal quiz from rendered compositions - flag sweeps, emoji puzzles, blur reveals, odd-one-out grids - instead of stock-image slideshows",
+      description: "Build a guess-and-reveal quiz from rendered compositions - flag sweeps, Rebus puzzles, blur reveals, odd-one-out grids - instead of stock-image slideshows",
       argsSchema: {
         topic: external_exports.string().optional().describe("Quiz topic (e.g. 'world flags', 'movie emoji', '90s music')"),
         question_count: external_exports.string().optional().default("5").describe("Number of questions (default: 5 - each question is a clue + reveal node pair)")
@@ -4709,4 +4709,4 @@ export {
   getWorkflowText,
   registerPrompts
 };
-//# sourceMappingURL=chunk-MV27JVSL.js.map
+//# sourceMappingURL=chunk-6U3CVTLZ.js.map