@clipform/mcp-server 1.44.1 → 1.44.2

package/dist/{chunk-T6B4O3O7.js → chunk-VTRO7ZC3.js}

@@ -4097,6 +4097,10 @@ 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 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}"` : "";
   const count = args.question_count ?? 8;
@@ -4107,7 +4111,7 @@ function quizWorkflow(args, sessionContext, authMode = "authenticated") {
 
 1. **Research** the topic - find surprising facts, common misconceptions, myth-busters
 2. **Write questions** - follow the difficulty curve (easy start, hard middle, satisfying end). Target ${count} questions.
-3. **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:
+3. ${BUILD_ONCE_STEP}
    - Settings: show_step_counter: true, disable_back_navigation: true
    - One choice node per question: config { choice: { show_answer_feedback: true }, randomise_options: true }, options with score: 1 on the correct answer and score: 0 on 3-4 plausible wrong ones. The viewer shuffles options at render time, so list them in any order. Scored options enable correct-answer marking automatically.
    - Final end_screen node - EVERY quiz must have:
@@ -4116,13 +4120,13 @@ function quizWorkflow(args, sessionContext, authMode = "authenticated") {
      - cta_type: "restart", cta_text: a short challenge like "Beat your score?" or "Try again?"
      - title and message that fit the quiz's voice - short, punchy, and specific to the topic (not generic "Good job!"). Example: title: "Well played!", message: "Share your score and challenge a friend."
      - 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: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
+   ${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:
-   - 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
-6. **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).
-7. **Publish** with clipform_update_form
+5. **Build video** for each question - 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 clipform_render_composition with wait: false per clip. Compositions take narration via sound.narration.
+6. ${ATTACH_MEDIA_STEP}
+7. ${REPUBLISH_STEP}
 8. **Log** with clipform_log_generation (sources, images, attributions)
 
 > **Text-only override:** If the user explicitly asked for text-only (no video), skip steps 5-6 (video production and media attachment). Still generate narration in step 4.`;
@@ -4143,7 +4147,7 @@ There are NO correct answers. Each option should feel equally valid - the quiz i
 
 1. **Define 3-5 outcome categories** conceptually - these guide your question design even though automated scoring is not yet available.
 2. **Write questions** - each question should feel revealing but fun. Target ${count} questions.
-3. **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:
+3. ${BUILD_ONCE_STEP}
    - Settings: show_step_counter: true, disable_back_navigation: true
    - One choice node per question: config { choice: { show_answer_feedback: false } } (no right/wrong!)
      - Do NOT set randomise_options (option order matters for personality quizzes - lead with the most appealing)
@@ -4154,10 +4158,10 @@ There are NO correct answers. Each option should feel equally valid - the quiz i
      - cta_type: "restart", cta_text: "Find out again?" or "Take it again?"
      - Write a title and message that feel personal and shareable. Example: title: "Thanks for playing!", message: "Share this quiz with friends and compare your answers."
      - NOTE: Automated result screens per category (scoring_results) are coming soon. For now, write one engaging end screen.
-   - tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
+   ${TAGS_LINE}
 4. **Generate narration** with clipform_generate_tts - batch ALL questions in a single call. Conversational, reflective tone. "What does this say about you?" not "Do you know the answer?"
 5. **Build video** + **attach media** (same as knowledge quiz workflow)
-6. **Publish** with clipform_update_form
+6. ${REPUBLISH_STEP}
 7. **Log** with clipform_log_generation`;
 }
 function comprehensionQuizWorkflow(args, sessionContext, authMode = "authenticated") {
@@ -4180,7 +4184,7 @@ function comprehensionQuizWorkflow(args, sessionContext, authMode = "authenticat
    - Include 1-2 inference questions: "Based on the video, why does the presenter believe...?"
    - Avoid questions answerable without watching (e.g., common knowledge about the topic)
 4. **Adapt to the audience**${audienceLabel} - simplify language for younger audiences, focus on concrete/visual details rather than abstract arguments
-5. **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:
+5. ${BUILD_ONCE_STEP}
    - Settings: show_step_counter: true, disable_back_navigation: true
    - One choice node per question: config { choice: { show_answer_feedback: true }, randomise_options: true }, options with score: 1 on the correct answer and score: 0 on 3-4 plausible wrong ones - make distractors things someone might guess without watching. The viewer shuffles options at render time, so list them in any order. Scored options enable correct-answer marking automatically.
    - Final end_screen node:
@@ -4194,8 +4198,8 @@ function comprehensionQuizWorkflow(args, sessionContext, authMode = "authenticat
 7. **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
-8. **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).
-9. **Publish** with clipform_update_form
+8. ${ATTACH_MEDIA_STEP}
+9. ${REPUBLISH_STEP}
 10. **Log** with clipform_log_generation - include the YouTube URL, video title, and channel as sources
 
 ## Question Types for Comprehension
@@ -4223,7 +4227,7 @@ function compositionQuizWorkflow(args, sessionContext, authMode = "authenticated
 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.
 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** with clipform_render_composition, wait: false on EVERY call - fire the full batch (clue clip + reveal clip per question), then collect URLs with clipform_check_render. Chain-state compositions: clue clip animate: true, reveal clip animate: false + answer props.
-4. **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:
+4. ${BUILD_ONCE_STEP}
    - Settings: show_step_counter: true, disable_back_navigation: true
    - Per question, a PAIR of nodes:
      - Clue node (type: "choice"): question as prompt, config { choice: { show_answer_feedback: true }, randomise_options: true }, options with score: 1 on the correct answer and score: 0 on 2-3 wrong ones. Scored options enable correct-answer marking automatically.
@@ -4232,7 +4236,7 @@ function compositionQuizWorkflow(args, sessionContext, authMode = "authenticated
    - 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).
-7. **Publish** with clipform_update_form
+7. ${REPUBLISH_STEP}
 8. **Log** with clipform_log_generation - record the composition IDs used per question alongside sources and attributions`;
 }
 function interviewWorkflow(args, sessionContext, authMode = "authenticated") {
@@ -4245,16 +4249,16 @@ function interviewWorkflow(args, sessionContext, authMode = "authenticated") {
 ## Workflow
 
 1. **Identify the ask** - what do you need from respondents? ${purpose}.
-2. **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:
+2. ${BUILD_ONCE_STEP}
    - 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 ? `
    - Consent node - "I agree that my response may be used in [context]"` : ""}
    - End screen that sets expectations: "Thanks! We'll be in touch."
-   - tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
+   ${TAGS_LINE}
 3. **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.
-4. **Publish** with clipform_update_form
+4. ${REPUBLISH_STEP}
 5. **Log** with clipform_log_generation`;
 }
 function surveyWorkflow(args, sessionContext, authMode = "authenticated") {
@@ -4266,16 +4270,16 @@ function surveyWorkflow(args, sessionContext, authMode = "authenticated") {
 ## Workflow
 
 1. **Define the key metric** - what's the one number you care about? (NPS, satisfaction, likelihood to recommend)
-2. **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:
+2. ${BUILD_ONCE_STEP}
    - Settings: show_step_counter: true, disable_back_navigation: false
    - 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` : ""}
    - End screen: "Thanks for your feedback!"
-   - tags: one format (quiz/survey/interview/feedback/lead-gen), one genre (trivia/personality/nps/poll/testimonial), and 2-3 topic words
+   ${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).
-4. **Publish** with clipform_update_form
+4. ${REPUBLISH_STEP}
 5. **Log** with clipform_log_generation
 
 ## Key rule: 5 questions max. Every extra question costs completions.`;
@@ -4293,7 +4297,7 @@ function testimonialWorkflow(args, sessionContext, authMode = "authenticated") {
 ## Workflow
 
 1. **Define the story arc** - what transformation or experience do you want to capture?
-2. **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:
+2. ${BUILD_ONCE_STEP}
    - Settings: show_step_counter: true, disable_back_navigation: false
    - Warm-up question (type: "open") - "Tell us your name and [role/relationship/context]". Enable video + audio + text responses.
    - 2-3 storytelling prompts (type: "open") - follow the before \u2192 during \u2192 after arc. Enable video responses. Example prompts:
@@ -4305,7 +4309,7 @@ function testimonialWorkflow(args, sessionContext, authMode = "authenticated") {
    - tags: format "testimonial", genre "story", and 2-3 topic words
 3. **Generate narration** with clipform_generate_tts - batch all prompts in a single call. Warm, appreciative tone - "We'd love to hear your story..." Keep each narration 5-8 seconds.
 4. **Optional: build video** for the intro/warm-up question to set the tone.
-5. **Publish** with clipform_update_form
+5. ${REPUBLISH_STEP}
 6. **Log** with clipform_log_generation
 
 > **Text-only override:** If the user explicitly asked for text-only (no video), skip steps 3-4 (narration and video production).`;
@@ -4318,7 +4322,7 @@ function applicationWorkflow(args, sessionContext, authMode = "authenticated") {
 ## Workflow
 
 1. **Define what you're screening for** - what qualifications matter, and what questions reveal fit?
-2. **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:
+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
    - 2-3 structured screening questions (type: "choice") - experience level, availability, relevant qualifications. These help you filter quickly.
@@ -4327,7 +4331,7 @@ function applicationWorkflow(args, sessionContext, authMode = "authenticated") {
    - 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
 3. **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.
-4. **Publish** with clipform_update_form
+4. ${REPUBLISH_STEP}
 5. **Log** with clipform_log_generation`;
 }
 function bookingWorkflow(args, sessionContext, authMode = "authenticated") {
@@ -4339,14 +4343,14 @@ function bookingWorkflow(args, sessionContext, authMode = "authenticated") {
 ## Workflow
 
 1. **Define the essentials** - what info do you actually need from attendees? Keep the list short.
-2. **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:
+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.
    - 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
 3. **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.
-4. **Publish** with clipform_update_form
+4. ${REPUBLISH_STEP}
 5. **Log** with clipform_log_generation
 
 ## Key rule: 3-5 fields max. Every extra field costs registrations.`;
@@ -4705,4 +4709,4 @@ export {
   getWorkflowText,
   registerPrompts
 };
-//# sourceMappingURL=chunk-T6B4O3O7.js.map
+//# sourceMappingURL=chunk-VTRO7ZC3.js.map