@clipform/mcp-server 1.34.0 → 1.35.0

package/README.md

@@ -84,7 +84,7 @@ You can also pass the key as a CLI flag: `npx -y @clipform/mcp-server --api-key=
 
 | Tool | Description |
 |------|-------------|
-| `clipform_render_composition` | Render a video composition to MP4 or PNG (waits, returns URL) |
+| `clipform_render_composition` | Render a video composition to MP4 or PNG - flag reveals, emoji puzzles, grids, timelines, map motion and more. Pass `wait: false` to fire renders in parallel and poll for results |
 | `clipform_generate_tts` | Generate narration audio with word-level captions |
 | `clipform_generate_slideshow` | Create slideshow videos from images + audio (waits, returns URL) |
 | `clipform_generate_video` | Generate video from images, clips, or both synced to audio. Pass `wait: false` to fire renders in parallel and poll for results |

package/dist/{chunk-JOJJ2XFL.js → chunk-6MLZZSNM.js}

@@ -2,7 +2,7 @@ import {
   WORKFLOW_TYPES,
   getDiscoveryParams,
   getSessionContextWithAuth
-} from "./chunk-KWEBCAPF.js";
+} from "./chunk-BYJMRIB6.js";
 import {
   __export
 } from "./chunk-HCZI2UJ5.js";
@@ -4212,6 +4212,29 @@ Wrong answers should sound right to someone who didn't watch but googled the top
 
 > **Text-only override:** If the user explicitly asked for text-only (no video), skip steps 7-8 (video production and media attachment). Still generate narration in step 6.`;
 }
+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.
+
+## 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.
+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:
+   - 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.
+     - Reveal node (type: "button"): the answer in the prompt ("It was Japan!"), config { button_text: "Next one" }
+   - 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.
+7. **Publish** with clipform_update_form
+8. **Log** with clipform_log_generation - record the composition IDs used per question alongside sources and attributions`;
+}
 function interviewWorkflow(args, sessionContext, authMode = "authenticated") {
   const purpose = args.purpose ?? "responses";
   const format = args.response_format ?? "all";
@@ -4339,7 +4362,8 @@ var WORKFLOW_BUILDERS = {
 };
 var QUIZ_VARIANT_BUILDERS = {
   "personality": personalityQuizWorkflow,
-  "comprehension": comprehensionQuizWorkflow
+  "comprehension": comprehensionQuizWorkflow,
+  "composition": compositionQuizWorkflow
 };
 async function getWorkflowText(type, args = {}, variant) {
   const { text: sessionContext, authMode } = await getSessionContextWithAuth();
@@ -4527,6 +4551,40 @@ Outcome categories: ${args.categories}` : "";
       };
     }
   );
+  server.registerPrompt(
+    "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",
+      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)")
+      }
+    },
+    async (rawArgs) => {
+      const args = coercePromptArgs(rawArgs);
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `I want to create a composition quiz${args.topic ? ` about "${args.topic}"` : ""}. ${args.question_count ?? 5} questions, guess-and-reveal style.`
+            }
+          },
+          resourceLink("guide-quiz", "clipform://guides/quiz", "Quiz Writing Guide"),
+          resourceLink("guide-quiz-composition", "clipform://guides/quiz/composition", "Composition Quiz Addendum"),
+          {
+            role: "assistant",
+            content: {
+              type: "text",
+              text: await getWorkflowText("quiz", args, "composition")
+            }
+          }
+        ]
+      };
+    }
+  );
   server.registerPrompt(
     "create-funnel",
     {
@@ -4647,4 +4705,4 @@ export {
   getWorkflowText,
   registerPrompts
 };
-//# sourceMappingURL=chunk-JOJJ2XFL.js.map
+//# sourceMappingURL=chunk-6MLZZSNM.js.map