@clipform/mcp-server 1.48.0 → 2.0.1

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-WUORO245.js → chunk-DDBQDDOK.js}

@@ -3,7 +3,7 @@ import {
   FORM_TYPE_KEYS,
   callApi,
   getSessionContext
-} from "./chunk-4CY5EJCR.js";
+} from "./chunk-ET43M6YO.js";
 
 // src/lib/guides.ts
 var guidesPromise = null;
@@ -57,7 +57,7 @@ var GUIDE_DESCRIPTIONS = {
 var QUIZ_VARIANT_DESCRIPTIONS = {
   "personality": "Addendum for personality quizzes - category design, option weighting, outcome writing, no right/wrong answers",
   "comprehension": "Addendum for YouTube comprehension quizzes - extracting questions from transcripts, distractor design, audience adaptation",
-  "composition": "Addendum for composition quizzes - guess-and-reveal formats built from rendered compositions: mechanic selection, the clue/reveal node pair, difficulty design"
+  "composition": "Addendum for composition quizzes - guess formats built from rendered compositions: mechanic selection, the clue clip + answer feedback default (with an optional reveal payoff node), difficulty design"
 };
 function getGuideUri(type, variant) {
   if (type === "quiz" && variant) {
@@ -136,4 +136,4 @@ export {
   getGuideUri,
   registerResources
 };
-//# sourceMappingURL=chunk-WUORO245.js.map
+//# sourceMappingURL=chunk-DDBQDDOK.js.map

package/dist/chunk-DDBQDDOK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/guides.ts","../src/resources.ts"],"sourcesContent":["import { callApi } from \"./api-client.js\";\n\n/**\n * Craft guide bodies live server-side (#470) - the npm package is a shim\n * that fetches them at runtime instead of bundling them in the tarball.\n * One fetch per process (all ~30KB of guides in a single response), cached;\n * a failed fetch is NOT cached so the next read retries.\n */\n\nexport interface RemoteGuide {\n  type: string;\n  variant: string | null;\n  uri: string;\n  mimeType: string;\n  text: string;\n}\n\nlet guidesPromise: Promise<Map<string, RemoteGuide>> | null = null;\n\nasync function loadGuides(): Promise<Map<string, RemoteGuide>> {\n  const result = await callApi(\"/internal/mcp/guides\", { method: \"GET\" });\n  if (!result.ok) {\n    throw new Error(`Failed to load guides: ${result.error}`);\n  }\n  const guides = (result.data as { guides?: RemoteGuide[] }).guides ?? [];\n  return new Map(guides.map((g) => [g.uri, g]));\n}\n\n/** Fetch a guide body by its clipform:// URI. Returns null when unavailable. */\nexport async function fetchGuideText(uri: string): Promise<string | null> {\n  if (!guidesPromise) {\n    guidesPromise = loadGuides();\n  }\n  try {\n    const guides = await guidesPromise;\n    return guides.get(uri)?.text ?? null;\n  } catch (err) {\n    guidesPromise = null; // don't cache failures - retry on the next read\n    // Loud, not silent: a misconfigured API_URL/key otherwise degrades every\n    // guide to the stub with nothing in the logs.\n    console.error(`[guides] Failed to fetch ${uri}: ${err instanceof Error ? err.message : String(err)}`);\n    return null;\n  }\n}\n\n/** Shown in place of a guide when the API is unreachable or unauthenticated. */\nexport function guideFallbackText(uri: string): string {\n  return [\n    `# Guide unavailable`,\n    ``,\n    `The craft guide (${uri}) could not be loaded from the Clipform API.`,\n    `Guides are served at runtime and need a reachable API with a valid key -`,\n    `check API_URL and CLIPFORM_API_KEY, then try again.`,\n    ``,\n    `General principles in the meantime: write narration for the ear (short,`,\n    `conversational), never reveal answers in narration or media, and keep`,\n    `forms tight - every question must earn its place.`,\n  ].join(\"\\n\");\n}\n","import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { getSessionContext } from \"./lib/session-context.js\";\nimport { FORM_TYPE_KEYS, FORM_TYPES, ALL_VARIANTS } from \"@vid-master/config\";\n\nexport const GUIDE_TYPES = FORM_TYPE_KEYS as readonly string[] as readonly [string, ...string[]];\nexport type GuideType = (typeof FORM_TYPE_KEYS)[number];\n\nexport const QUIZ_VARIANTS = ALL_VARIANTS as readonly string[] as readonly [string, ...string[]];\nexport type QuizVariant = (typeof ALL_VARIANTS)[number];\n// Guide BODIES are not bundled here (#470): the npm tarball ships only this\n// registration metadata. Text is fetched from the API at runtime - see\n// lib/guides.ts (cached per process, stub fallback when unreachable).\nimport { fetchGuideText, guideFallbackText } from \"./lib/guides.js\";\n\nconst GUIDE_DESCRIPTIONS: Record<GuideType, string> = {\n  \"quiz\": \"Craft knowledge for writing engaging quizzes - difficulty curves, question psychology, narration style, scoring\",\n  \"survey\": \"Craft knowledge for feedback surveys, NPS, and research forms - brevity, rating scales, respondent fatigue\",\n  \"interview\": \"Craft knowledge for building interview forms - warm-up pacing, open questions, consent, video responses\",\n  \"funnel\": \"Craft knowledge for lead qualification funnels - planned feature, conditional routing coming soon\",\n  \"testimonial\": \"Craft knowledge for collecting testimonials and customer stories on video - storytelling prompts, comfort techniques, consent\",\n  \"application\": \"Craft knowledge for application and evaluation forms - multi-section structure, video responses for behavioural questions, screening\",\n  \"booking\": \"Craft knowledge for event registration and booking forms - minimal friction, video welcome, confirmation flow\",\n};\n\nconst QUIZ_VARIANT_DESCRIPTIONS: Record<QuizVariant, string> = {\n  \"personality\": \"Addendum for personality quizzes - category design, option weighting, outcome writing, no right/wrong answers\",\n  \"comprehension\": \"Addendum for YouTube comprehension quizzes - extracting questions from transcripts, distractor design, audience adaptation\",\n  \"composition\": \"Addendum for composition quizzes - guess formats built from rendered compositions: mechanic selection, the clue clip + answer feedback default (with an optional reveal payoff node), difficulty design\",\n};\n\nexport function getGuideUri(type: GuideType, variant?: QuizVariant): string {\n  if (type === \"quiz\" && variant) {\n    return `clipform://guides/quiz/${variant}`;\n  }\n  return `clipform://guides/${type}`;\n}\n\nasync function readGuide(uri: string): Promise<string> {\n  return (await fetchGuideText(uri)) ?? guideFallbackText(uri);\n}\n\nexport function registerResources(server: McpServer) {\n  for (const type of GUIDE_TYPES) {\n    server.registerResource(\n      `guide-${type}`,\n      getGuideUri(type),\n      {\n        description: GUIDE_DESCRIPTIONS[type],\n        mimeType: \"text/markdown\",\n        annotations: { audience: [\"assistant\" as const], priority: 0.8 },\n      },\n      async () => ({\n        contents: [{\n          uri: getGuideUri(type),\n          mimeType: \"text/markdown\",\n          text: await readGuide(getGuideUri(type)),\n        }],\n      }),\n    );\n  }\n\n  for (const variant of QUIZ_VARIANTS) {\n    server.registerResource(\n      `guide-quiz-${variant}`,\n      getGuideUri(\"quiz\", variant),\n      {\n        description: QUIZ_VARIANT_DESCRIPTIONS[variant],\n        mimeType: \"text/markdown\",\n        annotations: { audience: [\"assistant\" as const], priority: 0.8 },\n      },\n      async () => ({\n        contents: [{\n          uri: getGuideUri(\"quiz\", variant),\n          mimeType: \"text/markdown\",\n          text: await readGuide(getGuideUri(\"quiz\", variant)),\n        }],\n      }),\n    );\n  }\n\n  server.registerResource(\n    \"context-session\",\n    \"clipform://context/session\",\n    {\n      description:\n        \"Current session info: auth mode, workspace, plan tier, node limits, feature flags. Read this before planning content to know your constraints.\",\n      mimeType: \"text/markdown\",\n      annotations: { audience: [\"assistant\"], priority: 1.0 },\n    },\n    async () => {\n      const text = await getSessionContext();\n      return {\n        contents: [\n          {\n            uri: \"clipform://context/session\",\n            mimeType: \"text/markdown\",\n            text: text || \"Session context unavailable - API may not be reachable.\",\n          },\n        ],\n      };\n    }\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-4CY5EJCR.js → chunk-ET43M6YO.js}

@@ -112,8 +112,8 @@ var FEATURES = {
     status: "live",
     category: "node-types"
   },
-  node_contact: {
-    name: "Contact form",
+  node_details: {
+    name: "Details",
     description: "Structured fields (name, email, phone, company) with consent checkboxes",
     enabled: true,
     status: "live",
@@ -195,8 +195,9 @@ var FEATURES = {
   node_file_download: {
     name: "File download",
     description: "Provide files for respondents to download",
-    enabled: false,
-    status: "planned",
+    enabled: true,
+    status: "live",
+    wentLiveAt: "2026-07-12",
     category: "node-types"
   },
   node_shopping: {
@@ -871,12 +872,12 @@ var NODE_TYPES = {
     },
     output_schema: null
   },
-  contact: {
-    label: "Contact Form",
-    shorthand: "Contact",
+  details: {
+    label: "Details",
+    shorthand: "Details",
     icon: "User",
     color: "#CFFAFE",
-    description: "Collect standardized contact information (name, email, phone, company)",
+    description: "Collect several fields on one screen - name, email, phone, address, date, and more",
     category: "input",
     sort_order: 5,
     has_options: false,
@@ -896,9 +897,9 @@ var NODE_TYPES = {
         { id: "first_name", type: "first_name", label: "First Name", enabled: true, required: true },
         { id: "email", type: "email", label: "Email", enabled: true, required: true }
       ],
-      consent_items: [
-        { id: "default-consent", name: "Privacy policy", label: "I agree to the privacy policy and terms of service", order: 0, type: "consent" }
-      ]
+      // No agreement out of the box - the builder adds one via "Add agreement"
+      // when they actually need consent, so a fresh node ships no orphan checkbox. (#1378)
+      consent_items: []
     },
     config_schema: {
       type: "object",
@@ -913,7 +914,7 @@ var NODE_TYPES = {
             required: ["id", "required"],
             properties: {
               id: { type: "string" },
-              type: { enum: ["text", "textarea", "email", "tel", "url"], type: "string" },
+              type: { enum: ["text", "textarea", "email", "tel", "url", "date", "number"], type: "string" },
               label: { type: "string" },
               order: { type: "number" },
               required: { type: "boolean", default: true },
@@ -976,7 +977,7 @@ var NODE_TYPES = {
       type: "object",
       required: ["node_type", "fields"],
       properties: {
-        node_type: { type: "string", const: "contact" },
+        node_type: { type: "string", const: "details" },
         fields: {
           type: "array",
           items: {
@@ -1090,13 +1091,14 @@ var NODE_TYPES = {
     show_nav_bar: true,
     loading: "lazy",
     supports_prompt: false,
-    supports_media: false,
+    supports_media: true,
     is_system: false,
     show_in_results: true,
     default_config: {
       paper_color: "#FAF9F6",
       stroke_colors: ["#1F2937", "#EF4444", "#3B82F6", "#22C55E", "#FACC15"],
-      stroke_widths: [3, 6, 12]
+      stroke_widths: [3, 6, 12],
+      background: { fit: "contain", opacity: 1 }
     },
     config_schema: {
       type: "object",
@@ -1119,6 +1121,19 @@ var NODE_TYPES = {
           label: "Pen thicknesses",
           default: [3, 6, 12],
           description: "Stroke widths (px) the respondent can choose"
+        },
+        // The reference image itself is the node's attached media (media_id,
+        // via the same media_asset/create-media.ts pipeline every other
+        // supports_media node uses) - not a config field, to avoid a
+        // duplicated asset ref. This only tunes its display/bake.
+        background: {
+          type: "object",
+          label: "Background image",
+          description: "Display settings for the optional reference image behind the drawing canvas",
+          properties: {
+            fit: { type: "string", enum: ["cover", "contain"], default: "contain", label: "Fit", description: "contain letterboxes the image, cover crops it to fill the canvas" },
+            opacity: { type: "number", minimum: 0, maximum: 1, default: 1, label: "Opacity", description: "Background image opacity, from 0 (invisible) to 1 (fully opaque)" }
+          }
         }
       }
     },
@@ -1178,6 +1193,13 @@ var NODE_TYPES = {
     supports_media: false,
     is_system: false,
     show_in_results: true,
+    // Config keys that reference a workspace-scoped connected account (Stripe/etc
+    // via workspace_integrations). The SoT for save_form to strip on cross-workspace
+    // copy (#2064 part 2 - migration, not yet wired). Standing convention for any
+    // future OAuth/connected-account node (booking, shopify), not a payment special
+    // case - the publish gate's own showcase waiver (graph-validation.js) still
+    // names workspace_integration_id directly since it's the only per-type check today.
+    connection_config_keys: ["workspace_integration_id"],
     default_config: { amount: null, currency: "usd", provider: "stripe" },
     config_schema: {
       type: "object",
@@ -1353,7 +1375,7 @@ var NODE_TYPES = {
     color: "#FFEDD5",
     description: "Redirect users to an external URL",
     category: "end",
-    sort_order: 101,
+    sort_order: 997,
     has_options: false,
     is_terminal: true,
     show_nav_bar: false,
@@ -1383,7 +1405,7 @@ var NODE_TYPES = {
     color: "#FFEDD5",
     description: "Display a list of links for users to choose from",
     category: "end",
-    sort_order: 102,
+    sort_order: 998,
     has_options: false,
     is_terminal: true,
     show_nav_bar: false,
@@ -1428,7 +1450,7 @@ var NODE_TYPES = {
     color: "#E9D5FF",
     description: "Provide a file for respondents to download",
     category: "action",
-    sort_order: 103,
+    sort_order: 9,
     has_options: false,
     is_terminal: false,
     show_nav_bar: true,
@@ -1446,7 +1468,8 @@ var NODE_TYPES = {
           items: {
             type: "object",
             properties: {
-              file_name: { type: "string", label: "Display file name", required: true },
+              file_name: { type: "string", label: "Original file name", required: true },
+              display_name: { type: "string", label: "Friendly name shown to respondents" },
               file_path: { type: "string", label: "File path in storage", required: true },
               file_size: { type: "number", label: "File size in bytes" },
               mime_type: { type: "string", label: "MIME type" }
@@ -1454,7 +1477,7 @@ var NODE_TYPES = {
           },
           label: "Downloadable files"
         },
-        button_text: { type: "string", label: "Button text", default: "Download Files" },
+        button_text: { type: "string", label: "Continue button text", default: "Continue" },
         description: { type: "string", label: "Description text" }
       }
     },
@@ -1477,7 +1500,28 @@ var NODE_TYPES = {
         }
       }
     },
-    output_schema: null
+    output_schema: {
+      type: "object",
+      required: ["node_type"],
+      properties: {
+        node_type: { type: "string", const: "file_download" },
+        files: {
+          type: "array",
+          description: "The files the respondent downloaded, each a canonical media object with a fresh signed link.",
+          items: {
+            type: "object",
+            properties: {
+              filename: { type: "string", description: "Original filename" },
+              content_type: { type: "string", description: "File MIME type" },
+              downloaded_at: { type: "string", format: "date-time", description: "Timestamp when download was initiated" },
+              url: { type: "string", format: "uri", description: "Direct, time-limited signed link (~48h, supports HTTP range)" },
+              download_url: { type: "string", format: "uri", description: "Same link with a forced download (Content-Disposition: attachment)" },
+              expires_at: { type: "string", format: "date-time", description: "When url/download_url stop working" }
+            }
+          }
+        }
+      }
+    }
   },
   shopping: {
     label: "Shopping",
@@ -1622,6 +1666,9 @@ for (const [type, def] of Object.entries(NODE_TYPES)) {
 var NODE_TYPES_LIST = Object.entries(NODE_TYPES).map(([type, def]) => ({ type, ...def })).sort((a, b) => a.sort_order - b.sort_order);
 var ACTIVE_NODE_TYPES = Object.entries(NODE_TYPES).filter(([, def]) => def.is_active && !def.is_system).map(([type]) => type);
 var NODE_TYPE_KEYS = Object.keys(NODE_TYPES);
+var CONNECTION_CONFIG_KEYS = Object.fromEntries(
+  Object.entries(NODE_TYPES).filter(([, def]) => Array.isArray(def.connection_config_keys) && def.connection_config_keys.length > 0).map(([type, def]) => [type, def.connection_config_keys])
+);
 var RESPONSE_SCHEMAS = Object.fromEntries(
   Object.entries(NODE_TYPES).map(([k, v]) => [k, v.response_schema])
 );
@@ -1681,7 +1728,7 @@ var FORM_TYPES = {
       ],
       composition: [
         { key: "topic", question: "What topic? (flags, movies, geography, music...)", fallback: "General trivia", mode: "all" },
-        { key: "question_count", question: "How many questions? (composition quizzes use ~2 nodes per question - 5-6 is the sweet spot)", fallback: "5", mode: "all" }
+        { key: "question_count", question: "How many questions? (composition quizzes use ~1 node per question, plus one more for any optional reveal beat - 5-6 is the sweet spot)", fallback: "5", mode: "all" }
       ]
     },
     variant_guide_uris: {
@@ -1692,7 +1739,7 @@ var FORM_TYPES = {
     variant_descriptions: {
       personality: "Addendum for personality quizzes - category design, option weighting, outcome writing, no right/wrong answers",
       comprehension: "Addendum for YouTube comprehension quizzes - extracting questions from transcripts, distractor design, audience adaptation",
-      composition: "Addendum for composition quizzes - guess-and-reveal formats built from rendered compositions: mechanic selection, the clue/reveal node pair, difficulty design"
+      composition: "Addendum for composition quizzes - guess formats built from rendered compositions: mechanic selection, the clue clip + answer feedback default (with an optional reveal payoff node), difficulty design"
     },
     prompt: { name: "create-quiz", title: "Create a Quiz", description: "Build a scored knowledge quiz with narrated video questions" }
   },
@@ -1725,7 +1772,7 @@ var FORM_TYPES = {
     aliases: ["case-study", "callout"],
     variants: [],
     required_features: [],
-    required_node_types: ["open", "contact", "end_screen"],
+    required_node_types: ["open", "details", "end_screen"],
     default_media_style: "video",
     guide_uri: "clipform://guides/interview",
     guide_description: "Craft knowledge for building interview forms - warm-up pacing, open questions, consent, video responses",
@@ -1747,7 +1794,7 @@ var FORM_TYPES = {
     aliases: ["lead-gen", "qualification", "lead-magnet"],
     variants: [],
     required_features: ["branching", "funnel"],
-    required_node_types: ["choice", "contact", "end_screen"],
+    required_node_types: ["choice", "details", "end_screen"],
     default_media_style: "text",
     guide_uri: "clipform://guides/funnel",
     guide_description: "Craft knowledge for lead qualification funnels - planned feature, conditional routing coming soon",
@@ -1765,7 +1812,7 @@ var FORM_TYPES = {
     aliases: ["story", "review"],
     variants: [],
     required_features: [],
-    required_node_types: ["open", "contact", "end_screen"],
+    required_node_types: ["open", "details", "end_screen"],
     default_media_style: "video",
     guide_uri: "clipform://guides/testimonial",
     guide_description: "Craft knowledge for collecting testimonials and customer stories on video - storytelling prompts, comfort techniques, consent",
@@ -1786,7 +1833,7 @@ var FORM_TYPES = {
     aliases: ["job-application", "admission", "enrollment", "grant"],
     variants: [],
     required_features: [],
-    required_node_types: ["open", "choice", "contact", "end_screen"],
+    required_node_types: ["open", "choice", "details", "end_screen"],
     default_media_style: "video",
     guide_uri: "clipform://guides/application",
     guide_description: "Craft knowledge for application and evaluation forms - multi-section structure, video responses for behavioural questions, screening",
@@ -1806,7 +1853,7 @@ var FORM_TYPES = {
     aliases: ["registration", "signup", "event", "rsvp", "workshop"],
     variants: [],
     required_features: [],
-    required_node_types: ["contact", "choice", "end_screen"],
+    required_node_types: ["details", "choice", "end_screen"],
     default_media_style: "text",
     guide_uri: "clipform://guides/booking",
     guide_description: "Craft knowledge for event registration and booking forms - minimal friction, video welcome, confirmation flow",
@@ -1943,7 +1990,8 @@ var BUSINESS = {
   email: {
     support: "support@clipform.io",
     sales: "sales@clipform.io",
-    hello: "hello@clipform.io"
+    hello: "hello@clipform.io",
+    founder: "andy@clipform.io"
   },
   urls: getUrls()
 };
@@ -2001,37 +2049,33 @@ var SLIDESHOW_TRANSITIONS = [
 ];
 var COMPOSITION_REGISTRY = [
   // Beds (full-bleed backgrounds)
-  { id: "MediaSlideshow", tier: "public", kind: "bed", scene_layer: true },
+  { id: "Slideshow", tier: "public", kind: "bed", scene_layer: true },
   { id: "Map", tier: "public", kind: "bed", scene_layer: true },
   { id: "Grid", tier: "public", kind: "bed", scene_layer: true },
-  { id: "ObscuredReveal", tier: "public", kind: "bed" },
-  { id: "Timeline", tier: "public", kind: "bed" },
-  { id: "NumberLine", tier: "public", kind: "bed" },
-  { id: "CountdownRing", tier: "public", kind: "bed" },
-  { id: "CountrySilhouetteClip", tier: "public", kind: "bed", scene_layer: true },
-  { id: "FlagReveal", tier: "public", kind: "bed" },
-  { id: "ColorCards", tier: "public", kind: "bed", scene_layer: true },
-  { id: "TitleCard", tier: "public", kind: "bed" },
-  { id: "ParallaxImage", tier: "public", kind: "bed" },
-  { id: "Spin3D", tier: "labs", kind: "bed", scene_layer: true },
+  { id: "Timeline", tier: "labs", kind: "bed" },
+  { id: "CountrySilhouetteClip", tier: "labs", kind: "bed", scene_layer: true },
   // Overlays (assets layered on a bed)
-  { id: "TextReveal", tier: "public", kind: "overlay", scene_layer: true },
-  { id: "EmojiPuzzle", tier: "public", kind: "overlay", scene_layer: true },
-  { id: "BeforeAfter", tier: "public", kind: "overlay", scene_layer: true },
-  { id: "StatCounter", tier: "labs", kind: "overlay", scene_layer: true },
-  { id: "ListReveal", tier: "labs", kind: "overlay", scene_layer: true },
+  { id: "Text", tier: "labs", kind: "overlay", scene_layer: true },
+  { id: "Rebus", tier: "labs", kind: "overlay", scene_layer: true },
   // Container
   { id: "Scene", tier: "labs", kind: "container" },
   // Social marketing templates (gated)
-  { id: "ShortFormQuiz", tier: "social", kind: "template" },
-  { id: "ScorecardQuiz", tier: "social", kind: "template" },
-  { id: "ScorecardGK", tier: "social", kind: "template" },
-  { id: "CountrySilhouetteQuiz", tier: "social", kind: "template" }
+  { id: "ShortFormQuiz", tier: "social", kind: "video" },
+  { id: "ScorecardQuiz", tier: "social", kind: "video" },
+  { id: "ScorecardGK", tier: "social", kind: "video" },
+  { id: "CountrySilhouetteQuiz", tier: "social", kind: "video" }
 ];
 var compositionIdsByTier = (tier) => COMPOSITION_REGISTRY.filter((c) => c.tier === tier).map((c) => c.id);
 var PUBLIC_COMPOSITION_IDS = compositionIdsByTier("public");
 var LABS_COMPOSITION_IDS = compositionIdsByTier("labs");
 var SOCIAL_COMPOSITION_IDS = compositionIdsByTier("social");
+function exposedCompositionIds(includeNonPublic) {
+  return [
+    ...PUBLIC_COMPOSITION_IDS,
+    ...includeNonPublic ? LABS_COMPOSITION_IDS : [],
+    ...includeNonPublic ? SOCIAL_COMPOSITION_IDS : []
+  ];
+}
 var SCENE_LAYER_COMPOSITION_IDS = COMPOSITION_REGISTRY.filter((c) => c.scene_layer).map((c) => c.id);
 var MCP_TOOL_TIERS = {};
 
@@ -2257,9 +2301,7 @@ export {
   KEN_BURNS_PRESETS,
   KEN_BURNS_FIT_MODES,
   SLIDESHOW_TRANSITIONS,
-  PUBLIC_COMPOSITION_IDS,
-  LABS_COMPOSITION_IDS,
-  SOCIAL_COMPOSITION_IDS,
+  exposedCompositionIds,
   MCP_TOOL_TIERS,
   setMcpVersion,
   callApi,
@@ -2269,4 +2311,4 @@ export {
   getSessionContextWithAuth,
   getSessionContext
 };
-//# sourceMappingURL=chunk-4CY5EJCR.js.map
+//# sourceMappingURL=chunk-ET43M6YO.js.map