@instavar/mcp-server 0.5.0 → 0.7.0

package/dist/index.js

@@ -1,11 +1,1445 @@
 #!/usr/bin/env node
 
+// src/paired-announcement.ts
+import { z } from "zod";
+
+// src/announcement-source.ts
+var htmlEscape = (value) => value.replace(
+  /[&<>"']/g,
+  (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]
+);
+function announcementFiles(project) {
+  const copy = project.copy;
+  const files = {};
+  const addFile = (name, contents) => {
+    files[name] = contents;
+  };
+  const css = `@font-face{font-family:AnnouncementDisplay;src:url(__ANNOUNCEMENT_DISPLAY_FONT__);font-weight:100 900;}
+@font-face{font-family:AnnouncementBody;src:url(__ANNOUNCEMENT_BODY_FONT__);font-weight:400;}
+*{box-sizing:border-box}body{margin:0;background:#f4f0e7;color:#202d29}
+#announcement-root{position:relative;width:1280px;height:720px;overflow:hidden;background:#f4f0e7;color:#202d29}
+.clip{position:absolute;inset:0}
+h1,p{margin:0;overflow-wrap:anywhere}h1{position:absolute;left:88px;top:110px;width:1040px;font-family:AnnouncementDisplay;font-size:${copy.title.length > 45 ? 48 : copy.title.length > 24 ? 64 : 92}px;font-weight:650;line-height:1.08;letter-spacing:-3px}
+#body{position:absolute;left:92px;top:370px;width:1050px;font-family:AnnouncementBody;font-size:${copy.body.length > 60 ? 28 : 34}px;font-weight:400;line-height:1.4}
+#cta{position:absolute;left:92px;top:535px;width:1050px;font-family:AnnouncementBody;font-size:${copy.cta.length > 30 ? 26 : 30}px;font-weight:400;line-height:1.4;color:#345a45}
+#rule{position:absolute;left:92px;top:620px;width:1096px;height:4px;background:#345a45;transform-origin:left center}
+html,body,*{text-rendering:auto}
+`;
+  addFile("style.css", css);
+  const manifest = {
+    framework: project.framework,
+    copy,
+    width: 1280,
+    height: 720,
+    fps: 30,
+    durationSeconds: 10
+  };
+  addFile("manifest.json", JSON.stringify(manifest, null, 2) + "\n");
+  if (project.framework === "hyperframes") {
+    addFile(
+      "hyperframes.json",
+      JSON.stringify({ authoringSkill: "general-video" })
+    );
+    addFile(
+      "index.html",
+      `<!doctype html><html lang="en"><head><meta charset="utf-8"><title>Instavar announcement card</title><link rel="stylesheet" href="style.css"><script src="gsap.min.js"></script></head><body>
+<div id="announcement-root" data-composition-id="announcement" data-start="0" data-width="1280" data-height="720" data-duration="10">
+<section id="announcement-scene" class="clip" data-start="0" data-duration="10" data-track-index="0">
+<h1 id="title">${htmlEscape(copy.title)}</h1><p id="body">${htmlEscape(
+        copy.body
+      )}</p><p id="cta">${htmlEscape(
+        copy.cta
+      )}</p><div id="rule"></div></section></div>
+<script>
+// Adapted from HyperFrames registry staggered-fade-up: three whole text blocks.
+const tl=gsap.timeline({paused:true});
+tl.fromTo('#title',{opacity:0,y:22},{opacity:1,y:0,duration:0.6,ease:'power3.out'},0.25);
+tl.fromTo('#body',{opacity:0,y:22},{opacity:1,y:0,duration:0.6,ease:'power3.out'},2);
+tl.fromTo('#cta',{opacity:0,y:22},{opacity:1,y:0,duration:0.6,ease:'power3.out'},5);
+tl.fromTo('#rule',{scaleX:0},{scaleX:1,duration:9.5,ease:'none'},0.25);
+window.__timelines['announcement']=tl;
+</script></body></html>`
+    );
+    addFile(
+      "index.motion.json",
+      JSON.stringify(
+        {
+          duration: 10,
+          assertions: [
+            { kind: "appearsBy", selector: "#title", bySec: 1 },
+            { kind: "before", a: "#title", b: "#body" },
+            { kind: "before", a: "#body", b: "#cta" },
+            { kind: "staysInFrame", selector: "#title" },
+            { kind: "staysInFrame", selector: "#body" },
+            { kind: "staysInFrame", selector: "#cta" }
+          ]
+        },
+        null,
+        2
+      )
+    );
+  } else {
+    addFile(
+      "index.jsx",
+      `import React from 'react';
+import {Composition,registerRoot,useCurrentFrame,useVideoConfig} from 'remotion';
+const css=${JSON.stringify(css)};
+const copy=${JSON.stringify(copy)};
+const ease=t=>1-Math.pow(1-t,4);
+const reveal=(t,start)=>{const p=ease(Math.max(0,Math.min(1,(t-start)/0.6)));return {opacity:p,transform:'translateY('+(22*(1-p))+'px)'}};
+function Announcement(){const frame=useCurrentFrame();const {fps}=useVideoConfig();const t=frame/fps;return <div id="announcement-root"><style>{css}</style><section className="clip"><h1 id="title" style={reveal(t,0.25)}>{copy.title}</h1><p id="body" style={reveal(t,2)}>{copy.body}</p><p id="cta" style={reveal(t,5)}>{copy.cta}</p><div id="rule" style={{transform:'scaleX('+Math.max(0,Math.min(1,(t-0.25)/9.5))+')'}}/></section></div>}
+registerRoot(()=> <Composition id="Announcement" component={Announcement} width={1280} height={720} fps={30} durationInFrames={300}/>);
+`
+    );
+  }
+  const dependencies = project.framework === "hyperframes" ? { hyperframes: "0.8.38", gsap: "3.14.2" } : {
+    remotion: "4.0.496",
+    "@remotion/cli": "4.0.496",
+    react: "19.1.0",
+    "react-dom": "19.1.0"
+  };
+  addFile(
+    "package.json",
+    JSON.stringify(
+      {
+        private: true,
+        type: "module",
+        scripts: {
+          setup: "node setup.mjs",
+          preview: project.framework === "hyperframes" ? "hyperframes preview" : "remotion studio index.jsx",
+          render: project.framework === "hyperframes" ? "hyperframes render --fps 30 --output video.mp4" : "remotion render index.jsx Announcement video.mp4"
+        },
+        dependencies
+      },
+      null,
+      2
+    )
+  );
+  addFile(
+    "setup.mjs",
+    `import {readFile,writeFile,copyFile} from 'node:fs/promises';
+const fonts = [['__ANNOUNCEMENT_DISPLAY_FONT__','Fraunces-Variable.ttf'],['__ANNOUNCEMENT_BODY_FONT__','Inter-Regular.ttf']];
+for (const [marker,name] of fonts) {
+  const response = await fetch('https://instavar.com/fonts/'+name);
+  if (!response.ok) throw new Error('Font download failed: '+name);
+  const uri = 'data:font/ttf;base64,'+Buffer.from(await response.arrayBuffer()).toString('base64');
+  for (const file of ${JSON.stringify(
+      project.framework === "hyperframes" ? ["style.css"] : ["style.css", "index.jsx"]
+    )}) {
+    const source = await readFile(file,'utf8');
+    await writeFile(file,source.replaceAll(marker,uri));
+  }
+}
+${project.framework === "hyperframes" ? "await copyFile('node_modules/gsap/dist/gsap.min.js','gsap.min.js');" : ""}
+`
+  );
+  return files;
+}
+
+// src/paired-announcement.ts
+var framework = z.enum(["remotion", "hyperframes"]);
+var text = (max) => z.string().trim().min(1).max(max);
+var copyFields = { title: text(70), body: text(100), cta: text(40) };
+var copySchema = z.object(copyFields).strict();
+var announcementProjectSchema = z.object({
+  templateId: z.literal("announcement-card-v1"),
+  framework,
+  revision: z.number().int().min(1).max(Number.MAX_SAFE_INTEGER - 1),
+  copy: copySchema
+}).strict();
+var pairedAnnouncementInput = {
+  framework: z.enum(["remotion", "hyperframes", "no-preference"]).optional().describe(
+    "Only supply an explicit user choice. Omit for an ambiguous request or to inherit the existing project framework."
+  ),
+  copy: copySchema.optional().describe("Accepted copy for a new project only."),
+  project: announcementProjectSchema.optional().describe(
+    "The latest project document returned by this tool. Caller-held, not a saved hosted project."
+  ),
+  expectedRevision: z.number().int().min(1).optional().describe(
+    "Required with project. Must match its revision. This checks the supplied document, not a server-side stored version."
+  ),
+  edits: copySchema.partial().optional().describe(
+    "Explicit copy edits to apply before switching. Other source or timeline edits cannot be preserved."
+  )
+};
+var inputSchema = z.object(pairedAnnouncementInput).strict();
+var PAIRED_ANNOUNCEMENT_CAPABILITY = {
+  templateId: "announcement-card-v1",
+  frameworks: ["remotion", "hyperframes"],
+  tool: "prepare_announcement",
+  dimensions: { width: 1280, height: 720, fps: 30, durationSeconds: 10 },
+  scope: "One silent announcement card. Returns portable source and caller-held copy state; does not save or render. Only title, body and action survive switching."
+};
+var PAIRED_ANNOUNCEMENT_INSTRUCTIONS = "For the paired announcement-card-v1 or a HyperFrames announcement request, use prepare_announcement. Never infer a framework from creative wording. Omit framework unless the user explicitly chooses one or says no preference. If needs-selection, ask the user. Continue with the latest returned project and expectedRevision; apply edits through edits before switching. Keep the returned project document for later calls. Never describe this caller-held document as a saved hosted project. The existing VideoSpec catalogue remains Remotion-only.";
+function prepareAnnouncement(raw) {
+  const input = inputSchema.parse(raw);
+  const inputReceipt = {
+    contract: "paired-announcement-input-receipt/v1",
+    stage: "validated-input",
+    normalizedInput: JSON.parse(JSON.stringify(input))
+  };
+  const old = input.project;
+  if (old && input.expectedRevision !== old.revision)
+    throw new Error(
+      "Supply the latest project document and its matching expectedRevision."
+    );
+  if (old && input.copy)
+    throw new Error(
+      "Use edits to change existing copy; do not replace it with new-project copy."
+    );
+  if (!old && (input.edits || input.expectedRevision !== void 0))
+    throw new Error("Edits and expectedRevision require an existing project.");
+  const selected = input.framework === "remotion" || input.framework === "hyperframes" ? input.framework : old?.framework ?? (input.framework === "no-preference" ? "remotion" : void 0);
+  if (!selected)
+    return {
+      inputReceipt,
+      status: "needs-selection",
+      options: ["remotion", "hyperframes", "no-preference"],
+      message: "Which framework would you like: Remotion, HyperFrames, or no preference? No source was generated."
+    };
+  if (!old && !input.copy)
+    return {
+      inputReceipt,
+      status: "needs-copy",
+      framework: selected,
+      required: ["title", "body", "cta"]
+    };
+  const copy = copySchema.parse({
+    ...old?.copy ?? input.copy,
+    ...input.edits
+  });
+  const changed = old && Object.keys(copyFields).some(
+    (key) => copy[key] !== old.copy[key]
+  );
+  const project = {
+    templateId: "announcement-card-v1",
+    framework: selected,
+    revision: (old?.revision ?? 1) + (changed ? 1 : 0),
+    copy
+  };
+  return {
+    inputReceipt,
+    status: "ready",
+    reason: input.framework && input.framework !== "no-preference" ? "explicit" : old ? "existing-project" : "visible-default",
+    project,
+    files: {
+      ...announcementFiles(project),
+      "announcement.project.json": JSON.stringify(project, null, 2) + "\n"
+    },
+    commands: [
+      "npm install",
+      "npm run setup",
+      ...selected === "hyperframes" ? ["npx hyperframes check --samples 15 --strict"] : [],
+      "npm run preview",
+      "npm run render"
+    ],
+    instructions: "Save these files in a new directory. Install and setup download pinned dependencies and Instavar fonts; setup embeds fonts locally before rendering. Review preview frames before rendering. Keep announcement.project.json as the copy source of truth. This tool has not written files, saved a hosted project or rendered video. Regenerating source preserves only the three copy fields, not custom source edits."
+  };
+}
+function pairedAnnouncementInstructions(pairedCatalogue = false) {
+  return pairedCatalogue ? PAIRED_ANNOUNCEMENT_INSTRUCTIONS.replace(
+    "The existing VideoSpec catalogue remains Remotion-only.",
+    "VideoSpec templates use prepare_video_template in either framework."
+  ) : PAIRED_ANNOUNCEMENT_INSTRUCTIONS;
+}
+function registerPairedAnnouncement(server, options = {}) {
+  server.registerTool(
+    "prepare_announcement",
+    {
+      title: "Prepare an announcement in Remotion or HyperFrames",
+      description: "Prepare one paired announcement-card-v1 template, continue its caller-held project, edit copy or switch frameworks. Returns source files for local rendering. " + pairedAnnouncementInstructions(options.pairedCatalogue),
+      inputSchema: pairedAnnouncementInput,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false
+      },
+      _meta: { securitySchemes: [{ type: "noauth" }] }
+    },
+    async (args) => {
+      try {
+        const result3 = prepareAnnouncement(args);
+        return {
+          structuredContent: result3,
+          content: [{ type: "text", text: JSON.stringify(result3) }]
+        };
+      } catch (error) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: error instanceof Error ? error.message : "Invalid announcement input"
+            }
+          ]
+        };
+      }
+    }
+  );
+}
+
+// src/paired-templates/prepare-video-template.ts
+import { z as z3 } from "zod";
+
+// src/paired-templates/media-preflight.ts
+function mediaRequirements(spec, timeline) {
+  const requirements = [];
+  for (const scene of timeline.scenes) {
+    const source = spec.scenes[scene.index];
+    if (source.kind !== "video-window") continue;
+    requirements.push({
+      path: String(source.content.src),
+      role: `scene ${scene.index + 1} video`,
+      kind: "video",
+      minSeconds: scene.visibleFrames / timeline.fps
+    });
+  }
+  if (spec.audio.narrationSrc)
+    requirements.push({
+      path: spec.audio.narrationSrc,
+      role: "narration",
+      kind: "audio"
+    });
+  if (spec.audio.musicSrc)
+    requirements.push({
+      path: spec.audio.musicSrc,
+      role: "music",
+      kind: "audio",
+      minSeconds: timeline.durationInFrames / timeline.fps
+    });
+  return requirements;
+}
+function preflightScript(requirements, fps) {
+  return `// Paired template media preflight. Run before rendering in either framework.
+import { access } from "node:fs/promises";
+import { execFileSync } from "node:child_process";
+
+const requirements = ${JSON.stringify(requirements, null, 2)};
+const tolerance = ${0.5 / fps};
+function probe(file) {
+  try {
+    return JSON.parse(
+      execFileSync("ffprobe", ["-v", "error", "-show_streams", "-show_format", "-of", "json", file], { encoding: "utf8" })
+    );
+  } catch {
+    throw new Error("ffprobe could not read " + file + ". Install FFmpeg and check the file.");
+  }
+}
+for (const item of requirements) {
+  try {
+    await access(item.path);
+  } catch {
+    throw new Error("Missing " + item.role + " file " + item.path + ". Copy it to that path first.");
+  }
+  const info = probe(item.path);
+  const duration = Number(info.format?.duration ?? 0);
+  const stream = info.streams.find((entry) => entry.codec_type === item.kind);
+  if (!stream) throw new Error(item.role + " file " + item.path + " has no " + item.kind + " stream.");
+  if (item.kind === "audio" && stream.channels !== 2)
+    throw new Error(item.role + " file " + item.path + " must be stereo. Convert it first, for example: ffmpeg -i input -ac 2 output.wav");
+  // Untagged video is read as BT.709 by Remotion and BT.601 by HyperFrames,
+  // so saturated colours differ. Only tagged BT.709 SDR video renders alike.
+  if (item.kind === "video" && [stream.color_space, stream.color_primaries, stream.color_transfer].some((tag) => tag !== "bt709"))
+    throw new Error(item.role + " file " + item.path + " must be tagged BT.709 SDR (colour space " + stream.color_space + ", primaries " + stream.color_primaries + ", transfer " + stream.color_transfer + "). Convert it first, for example: ffmpeg -i input -vf scale=out_color_matrix=bt709:out_range=tv,format=yuv420p,setparams=range=tv:color_primaries=bt709:color_trc=bt709:colorspace=bt709 -c:v libx264 -crf 16 output.mp4");
+  if (item.minSeconds !== undefined && duration + tolerance < item.minSeconds)
+    throw new Error(item.role + " file " + item.path + " lasts " + duration + " s but must cover " + item.minSeconds + " s.");
+}
+console.log("Media preflight passed for " + requirements.length + " file(s).");
+`;
+}
+
+// src/paired-templates/spring.ts
+var CONFIG = { damping: 200, mass: 1, stiffness: 100 };
+var REST_THRESHOLD = 5e-3;
+function advance(animation, now) {
+  const { toValue, lastTimestamp, current, velocity } = animation;
+  const deltaTime = Math.min(now - lastTimestamp, 64);
+  const c = CONFIG.damping;
+  const m = CONFIG.mass;
+  const k = CONFIG.stiffness;
+  const v0 = -velocity;
+  const x0 = toValue - current;
+  const zeta = c / (2 * Math.sqrt(k * m));
+  const omega0 = Math.sqrt(k / m);
+  const omega1 = omega0 * Math.sqrt(1 - zeta ** 2);
+  const t = deltaTime / 1e3;
+  const sin1 = Math.sin(omega1 * t);
+  const cos1 = Math.cos(omega1 * t);
+  const underDampedEnvelope = Math.exp(-zeta * omega0 * t);
+  const underDampedFrag1 = underDampedEnvelope * (sin1 * ((v0 + zeta * omega0 * x0) / omega1) + x0 * cos1);
+  const underDampedPosition = toValue - underDampedFrag1;
+  const underDampedVelocity = zeta * omega0 * underDampedFrag1 - underDampedEnvelope * (cos1 * (v0 + zeta * omega0 * x0) - omega1 * x0 * sin1);
+  const criticallyDampedEnvelope = Math.exp(-omega0 * t);
+  const criticallyDampedPosition = toValue - criticallyDampedEnvelope * (x0 + (v0 + omega0 * x0) * t);
+  const criticallyDampedVelocity = criticallyDampedEnvelope * (v0 * (t * omega0 - 1) + t * x0 * omega0 * omega0);
+  return {
+    toValue,
+    lastTimestamp: now,
+    current: zeta < 1 ? underDampedPosition : criticallyDampedPosition,
+    velocity: zeta < 1 ? underDampedVelocity : criticallyDampedVelocity
+  };
+}
+function springCalculation(frame2, fps) {
+  let animation = {
+    lastTimestamp: 0,
+    current: 0,
+    toValue: 1,
+    velocity: 0
+  };
+  const frameClamped = Math.max(0, frame2);
+  const unevenRest = frameClamped % 1;
+  for (let f = 0; f <= Math.floor(frameClamped); f++) {
+    if (f === Math.floor(frameClamped)) f += unevenRest;
+    animation = advance(animation, f / fps * 1e3);
+  }
+  return animation;
+}
+function measureSpring(fps) {
+  let frame2 = 0;
+  let animation = springCalculation(frame2, fps);
+  let difference = Math.abs(animation.current - animation.toValue);
+  while (difference >= REST_THRESHOLD) {
+    frame2++;
+    animation = springCalculation(frame2, fps);
+    difference = Math.abs(animation.current - animation.toValue);
+  }
+  let finishedFrame = frame2;
+  for (let i = 0; i < 20; i++) {
+    frame2++;
+    animation = springCalculation(frame2, fps);
+    difference = Math.abs(animation.current - animation.toValue);
+    if (difference >= REST_THRESHOLD) {
+      i = 0;
+      finishedFrame = frame2 + 1;
+    }
+  }
+  return finishedFrame;
+}
+function springSamples(fps) {
+  const durationInFrames = Math.round(fps * 0.7);
+  const naturalDuration = measureSpring(fps);
+  return Array.from(
+    { length: durationInFrames + 2 },
+    (_, frame2) => frame2 > durationInFrames ? 1 : springCalculation(frame2 / (durationInFrames / naturalDuration), fps).current
+  );
+}
+
+// src/paired-templates/hyperframes-videospec.ts
+var HYPERFRAMES_RUNTIME = { hyperframes: "0.8.143", gsap: "3.14.2" };
+var LATIN_RANGE = "U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD";
+var PAIRED_FONTS = [
+  {
+    family: "Fraunces",
+    file: "Fraunces.woff2",
+    url: "https://fonts.gstatic.com/s/fraunces/v38/6NUu8FyLNQOQZAnv9bYEvDiIdE9Ea92uemAk_WBq8U_9v0c2Wa0K7iN7hzFUPJH58nib14c7qv8.woff2",
+    sha256: "7f9d191d999336d3b9790afa72e1358e50a13b06d4f289341e92a311967a80f9"
+  },
+  {
+    family: "Inter",
+    file: "Inter.woff2",
+    url: "https://fonts.gstatic.com/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1ZL7.woff2",
+    sha256: "3100e775e8616cd2611beecfa23a4263d7037586789b43f035236a2e6fbd4c62"
+  }
+];
+var palettes = {
+  "editorial-light": {
+    background: "#f4efe5",
+    surface: "#fffaf0",
+    ink: "#18241f",
+    muted: "#667169",
+    accent: "#2f6d5a",
+    accentSoft: "#cfe0d5",
+    signal: "#c96f58"
+  },
+  "editorial-dark": {
+    background: "#171c1a",
+    surface: "#222a27",
+    ink: "#f5efe3",
+    muted: "#abb7ae",
+    accent: "#a8cfb8",
+    accentSoft: "#30483e",
+    signal: "#ec967d"
+  },
+  clinical: {
+    background: "#f2f1e9",
+    surface: "#fbfaf5",
+    ink: "#14283a",
+    muted: "#60727c",
+    accent: "#3d796d",
+    accentSoft: "#d6e5df",
+    signal: "#d2705d"
+  }
+};
+function paletteFor(spec) {
+  if (spec.style.theme !== "default") return palettes[spec.style.theme];
+  return spec.templateFamily === "announcement-brief" ? palettes["editorial-light"] : palettes["editorial-dark"];
+}
+var escapeHtml = (value) => value.replace(
+  /[&<>"']/g,
+  (character) => ({
+    "&": "&amp;",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#39;"
+  })[character]
+);
+var str = (value) => typeof value === "string" ? value : "";
+var div = (className, value, attributes = "") => `<div class="${className}"${attributes}>${escapeHtml(value)}</div>`;
+function sceneCss(palette) {
+  const p = palette;
+  const fonts = PAIRED_FONTS.map(
+    (font) => `@font-face{font-family:${font.family};src:url(${font.file}) format('woff2');font-weight:100 900;font-style:normal;unicode-range:${LATIN_RANGE}}`
+  ).join("");
+  return `${fonts}
+*{box-sizing:border-box}
+.fill{position:absolute;top:0;left:0;right:0;bottom:0;width:100%;height:100%;display:flex;flex-direction:column}
+.background{background:${p.background}}
+.orb{position:absolute;width:760px;height:760px;border-radius:50%;background:${p.accentSoft};opacity:.42;right:-280px;top:-300px}
+.ring{position:absolute;width:420px;height:420px;border-radius:50%;border:2px solid ${p.accent};opacity:.16;left:-220px;bottom:80px}
+.layout{justify-content:center;padding:11% 9%}
+.layout.hero{justify-content:space-between}
+.layout.mechanism,.layout.points,.layout.equation{padding:10% 8.5%}
+.layout.video-window{padding:8%}
+.title{color:${p.ink};font-family:Fraunces;font-weight:600}
+.subtitle{color:${p.muted};font-family:Inter}
+.label{color:${p.muted};font-family:Inter;font-size:26px;font-weight:600;letter-spacing:.2px;margin-bottom:32px}
+.accent-bar{width:116px;height:12px;border-radius:12px;background:${p.accent};transform-origin:left}
+.hero-title{line-height:.98;letter-spacing:-2.6px;max-width:94%}
+.hero-sub{font-size:38px;line-height:1.35;margin-top:44px;max-width:82%}
+.footer{color:${p.accent};font-family:Inter;font-size:25px;font-weight:600}
+.statement-card{width:88%;padding:70px 64px;border-radius:44px;background:${p.surface};box-shadow:0 32px 90px rgba(20,40,58,.10)}
+.statement-title{font-size:88px;line-height:1.02}
+.statement-sub{font-size:34px;line-height:1.4;margin-top:34px}
+.mechanism-title{font-size:88px;line-height:1;letter-spacing:-1.5px}
+.mechanism-sub{font-size:32px;line-height:1.35;margin-top:24px}
+.states{display:grid;grid-template-columns:1fr 112px 1fr;align-items:center;gap:20px;margin-top:84px}
+.state-card{height:520px;border-radius:220px;background:${p.surface};box-shadow:0 28px 70px rgba(20,40,58,.10);display:flex;flex-direction:column;align-items:center;justify-content:center;padding:28px}
+.capsule{width:180px;height:290px;border-radius:90px;border:18px solid ${p.accent};opacity:.9}
+.capsule.before{border-color:${p.signal}}
+.state-label{color:${p.ink};font-family:Inter;font-size:29px;font-weight:600;margin-top:34px;text-align:center}
+.arrow{color:${p.accent};font-family:Inter;font-size:64px;text-align:center}
+.points-head{max-width:860px}
+.points-title{line-height:1.02;letter-spacing:-1.7px}
+.points-sub{font-size:32px;line-height:1.4;margin-top:24px}
+.point-list{display:grid;gap:22px;margin-top:70px}
+.point{display:grid;grid-template-columns:70px 1fr;align-items:center;gap:28px;background:${p.surface};border-radius:28px;padding:30px 34px;box-shadow:0 18px 52px rgba(20,40,58,.07)}
+.number{width:58px;height:58px;border-radius:50%;background:${p.accentSoft};color:${p.accent};display:flex;align-items:center;justify-content:center;font-family:Inter;font-size:27px;font-weight:700}
+.point-text{color:${p.ink};font-family:Inter;font-size:35px;font-weight:500;line-height:1.25}
+.check{width:124px;height:124px;border-radius:50%;background:${p.accent};color:${p.background};font-family:Inter;font-size:58px;display:flex;align-items:center;justify-content:center;margin-bottom:58px}
+.cta-title{font-size:104px;line-height:.98;letter-spacing:-2px}
+.cta-sub{font-size:34px;line-height:1.4;margin-top:38px}
+.equation-title{font-size:84px;line-height:1.02}
+.equations{display:grid;gap:24px;margin-top:58px}
+.equation-block{color:${p.ink};background:${p.surface};font-size:40px;padding:30px;border-radius:24px}
+.window-title{font-size:72px;line-height:1.04;margin-bottom:42px}
+.window{position:relative;height:66%;overflow:hidden;border-radius:36px;background:${p.surface};box-shadow:0 28px 80px rgba(20,40,58,.14)}
+.window video{position:absolute;top:0;left:0;width:100%;height:100%;object-fit:cover}
+.scene-label{position:absolute;left:54px;bottom:40px;color:${p.muted};font-family:Inter;font-size:18px}`;
+}
+function title(content, className, fit = "") {
+  return div(
+    `title ${className}`,
+    str(content.title) || str(content.line1),
+    fit
+  );
+}
+function subtitle(content, className) {
+  const value = str(content.subtitle) || str(content.line2);
+  return value ? div(`subtitle ${className}`, value) : "";
+}
+function pointsSubtitle(content) {
+  const value = str(content.subtitle);
+  return value ? div("subtitle points-sub", value) : "";
+}
+function label(content) {
+  const value = str(content.label);
+  return value ? div("label", value) : "";
+}
+function sceneBody(scene, id2, seconds) {
+  const c = scene.content;
+  switch (scene.kind) {
+    case "hero":
+      return `<div class="accent-bar" data-motion="bar"></div><div data-motion="rise" data-rise="42">${title(
+        c,
+        "hero-title",
+        ' data-fit="885.6,126"'
+      )}${subtitle(c, "hero-sub")}</div>${div("footer", str(c.footer))}`;
+    case "statement":
+    case "custom":
+      return `<div class="statement-card" data-motion="rise" data-rise="36">${label(
+        c
+      )}${title(c, "statement-title")}${subtitle(c, "statement-sub")}</div>`;
+    case "mechanism": {
+      const state = (value, side) => `<div class="state-card"><div class="capsule ${side}" data-motion="${side}"></div>${div(
+        "state-label",
+        value
+      )}</div>`;
+      return `<div data-motion="fade">${label(c)}${title(
+        c,
+        "mechanism-title"
+      )}${str(c.subtitle) ? div("subtitle mechanism-sub", str(c.subtitle)) : ""}</div><div class="states">${state(
+        str(c.before),
+        "before"
+      )}<div class="arrow" data-motion="arrow">\u2192</div>${state(
+        str(c.after),
+        "after"
+      )}</div>`;
+    }
+    case "points": {
+      const points = c.points ?? [];
+      return `<div class="points-head">${label(c)}${title(
+        c,
+        "points-title",
+        ' data-fit="850,98"'
+      )}${pointsSubtitle(c)}</div><div class="point-list">${points.map(
+        (point2, index) => `<div class="point" data-motion="rise" data-rise="28" data-delay="${index * 6}">${div("number", String(index + 1))}${div(
+          "point-text",
+          point2
+        )}</div>`
+      ).join("")}</div>`;
+    }
+    case "equation":
+      return `${div(
+        "title equation-title",
+        str(c.title)
+      )}<div class="equations">${c.latexBlocks.map(
+        (block) => `<code class="equation-block">${escapeHtml(block)}</code>`
+      ).join("")}</div>`;
+    case "video-window":
+      return `${div(
+        "title window-title",
+        str(c.title)
+      )}<div class="window"><video id="${id2}-video" class="clip" src="${escapeHtml(
+        str(c.src)
+      )}" data-start="0" data-duration="${seconds}" data-track-index="1" muted playsinline></video></div>`;
+    case "cta":
+      return `<div class="check" data-motion="pop">\u2713</div>${title(
+        c,
+        "cta-title"
+      )}${subtitle(c, "cta-sub")}`;
+  }
+}
+function sceneScript(id2, seconds, fps) {
+  const samples = springSamples(fps);
+  const span = samples.length - 1;
+  return `(async()=>{
+const root=document.getElementById(${JSON.stringify(id2)});
+await Promise.all(['600 100px Fraunces','400 38px Inter','500 35px Inter','600 29px Inter','700 27px Inter'].map(f=>document.fonts.load(f)));
+root.querySelectorAll('[data-fit]').forEach(e=>{const [width,cap]=e.dataset.fit.split(',').map(Number);const span=document.createElement('span');Object.assign(span.style,{fontFamily:'Fraunces',fontWeight:'600',fontSize:'100px',display:'inline-block',position:'absolute',top:'-10000px',whiteSpace:'pre',textRendering:'auto'});span.innerText=e.textContent;document.body.append(span);const size=Math.max(58,Math.min(cap,width/span.getBoundingClientRect().width*100*2.25));span.remove();e.style.fontSize=size+'px';});
+const samples=${JSON.stringify(samples)};
+const enter=f=>{if(f<=0)return samples[0];if(f>=${span})return 1;const i=Math.floor(f);return samples[i]+(samples[i+1]-samples[i])*(f-i);};
+const tl=gsap.timeline({paused:true});
+tl.to({},{duration:${seconds}},0);
+const spring={duration:${span / fps},ease:t=>enter(t*${span}),force3D:false};
+root.querySelectorAll('[data-motion="rise"]').forEach(e=>tl.fromTo(e,{opacity:0,y:Number(e.dataset.rise)},{opacity:1,y:0,...spring},Number(e.dataset.delay||0)/${fps}));
+root.querySelectorAll('[data-motion="fade"]').forEach(e=>tl.fromTo(e,{opacity:0},{opacity:1,...spring},0));
+root.querySelectorAll('[data-motion="bar"]').forEach(e=>tl.fromTo(e,{scaleX:0},{scaleX:1,...spring},0));
+root.querySelectorAll('[data-motion="pop"]').forEach(e=>tl.fromTo(e,{scale:0},{scale:1,...spring},0));
+const calm={duration:1.95,ease:'power1.inOut',force3D:false};
+root.querySelectorAll('[data-motion="before"]').forEach(e=>tl.fromTo(e,{scaleX:1},{scaleX:0.66,...calm},0.45));
+root.querySelectorAll('[data-motion="after"]').forEach(e=>tl.fromTo(e,{scaleX:0.45},{scaleX:0.25,...calm},0.45));
+root.querySelectorAll('[data-motion="arrow"]').forEach(e=>tl.fromTo(e,{x:-14},{x:14,...calm},0.45));
+window.__timelines=window.__timelines||{};window.__timelines[${JSON.stringify(
+    id2
+  )}]=tl;window.__hfForceTimelineRebind?.();
+})();`;
+}
+function hyperframesVideoSpecFiles(spec, timeline) {
+  const palette = paletteFor(spec);
+  const css = sceneCss(palette);
+  const { fps, width, height } = timeline;
+  const total = timeline.durationInFrames / fps;
+  const files = {};
+  const hosts = [];
+  for (const entry of timeline.scenes) {
+    if (entry.visibleFrames === 0) continue;
+    const scene = spec.scenes[entry.index];
+    const id2 = `scene-${entry.index + 1}`;
+    const seconds = entry.visibleFrames / fps;
+    const body = `<div class="fill background"><div class="orb" data-layout-allow-overflow></div><div class="ring" data-layout-allow-overflow></div></div><div class="fill layout ${scene.kind}">${sceneBody(scene, id2, seconds)}</div>${spec.style.showSceneLabels ? div("scene-label", scene.kind) : ""}`;
+    files[`compositions/${id2}.html`] = `<template><style>${css}
+#${id2}{position:absolute;inset:0;width:100%;height:100%;overflow:hidden}
+#${id2},#${id2} *{text-rendering:auto}</style><div id="${id2}" data-composition-id="${id2}" data-scene-id="${escapeHtml(
+      scene.id
+    )}" data-start="0" data-duration="${seconds}" data-width="${width}" data-height="${height}">${body}</div><script>${sceneScript(
+      id2,
+      seconds,
+      fps
+    )}</script></template>
+`;
+    hosts.push(
+      `<div id="${id2}" class="clip" data-composition-id="${id2}" data-composition-src="compositions/${id2}.html" data-start="${entry.startFrame / fps}" data-duration="${seconds}" data-track-index="0"></div>`
+    );
+  }
+  const audio = spec.audio;
+  if (audio.musicSrc)
+    hosts.push(
+      `<audio id="music" src="${escapeHtml(
+        audio.musicSrc
+      )}" data-start="0" data-duration="${total}" data-track-index="10" data-volume="${audio.ducking && audio.narrationSrc ? audio.musicVolume * 0.32 : audio.musicVolume}"></audio>`
+    );
+  if (audio.narrationSrc)
+    hosts.push(
+      `<audio id="narration" src="${escapeHtml(
+        audio.narrationSrc
+      )}" data-start="0" data-duration="${total}" data-track-index="11" data-volume="${audio.narrationVolume}"></audio>`
+    );
+  files["index.html"] = `<!doctype html>
+<html lang="en"><head><meta charset="utf-8"><title>${escapeHtml(
+    spec.meta.title
+  )}</title><style>html,body{margin:0;width:100%;height:100%;background:${palette.background}}#video{position:absolute;inset:0;overflow:hidden;background:${palette.background}}.clip{position:absolute;inset:0}</style><script src="gsap.min.js"></script></head><body>
+<div id="video" data-composition-id="video" data-start="0" data-width="${width}" data-height="${height}" data-duration="${total}">
+${hosts.join("\n")}
+</div>
+<script>const tl=gsap.timeline({paused:true});tl.to({},{duration:${total}});window.__timelines=window.__timelines||{};window.__timelines.video=tl;window.__hfForceTimelineRebind?.();</script>
+</body></html>
+`;
+  files["video.json"] = JSON.stringify(spec, null, 2) + "\n";
+  files["hyperframes.json"] = JSON.stringify({ authoringSkill: "general-video" }, null, 2) + "\n";
+  files["package.json"] = JSON.stringify(
+    {
+      private: true,
+      type: "module",
+      scripts: {
+        setup: "node setup.mjs",
+        check: "hyperframes check",
+        preview: "hyperframes preview",
+        // Extract source video frames as PNG. The default JPEG extraction
+        // re-subsamples chroma and leaves 1:1 windows of saturated footage
+        // just under the similarity floor; under HyperFrames 0.8.143 PNG
+        // extraction no longer darkens BT.709 footage.
+        render: `hyperframes render --fps ${fps} --video-frame-format png --output video.mp4`
+      },
+      dependencies: HYPERFRAMES_RUNTIME
+    },
+    null,
+    2
+  ) + "\n";
+  files["preflight.mjs"] = preflightScript(
+    mediaRequirements(spec, timeline),
+    fps
+  );
+  files["setup.mjs"] = `// Fetch the pinned fonts, copy the local GSAP runtime, then check media.
+import { createHash } from "node:crypto";
+import { copyFile, writeFile } from "node:fs/promises";
+
+const fonts = ${JSON.stringify(
+    PAIRED_FONTS.map(({ file, url, sha256 }) => ({ file, url, sha256 })),
+    null,
+    2
+  )};
+for (const font of fonts) {
+  const response = await fetch(font.url);
+  if (!response.ok) throw new Error("Font download failed: " + font.url);
+  const bytes = Buffer.from(await response.arrayBuffer());
+  const digest = createHash("sha256").update(bytes).digest("hex");
+  if (digest !== font.sha256)
+    throw new Error("Font " + font.file + " changed upstream; expected sha-256 " + font.sha256);
+  await writeFile(font.file, bytes);
+}
+await copyFile("node_modules/gsap/dist/gsap.min.js", "gsap.min.js");
+await import("./preflight.mjs");
+`;
+  return files;
+}
+
+// src/paired-templates/remotion-videospec.ts
+var REMOTION_TEMPLATES = {
+  repository: "https://github.com/instavar/remotion-templates",
+  commit: "a9092254937d28a05a277a9b6ecfd4ebea864245",
+  remotion: "4.0.502"
+};
+function remotionVideoSpecFiles(spec, timeline) {
+  return {
+    "video.json": JSON.stringify(spec, null, 2) + "\n",
+    "preflight.mjs": preflightScript(
+      mediaRequirements(spec, timeline),
+      timeline.fps
+    )
+  };
+}
+function remotionVideoSpecCommands(spec) {
+  return [
+    `git clone ${REMOTION_TEMPLATES.repository}.git`,
+    "cd remotion-templates",
+    `git checkout ${REMOTION_TEMPLATES.commit}`,
+    "npm ci",
+    "# Save video.json and preflight.mjs here and place each referenced media file at its public/ path.",
+    "node preflight.mjs",
+    "npm run video:validate -- video.json",
+    "npm run video:preview -- video.json",
+    `npm run video:render -- video.json out/${spec.id}.mp4`
+  ];
+}
+
+// src/paired-templates/videospec-contract.ts
+import { z as z2 } from "zod";
+var PAIRED_VIDEOSPEC_CONTRACT = "paired-videospec/v1";
+var PAIRED_TEMPLATE_FAMILIES = [
+  "qa-ad",
+  "proof-walkthrough",
+  "announcement-brief",
+  "social-remix",
+  "finance-brief"
+];
+var PAIRED_SCENE_KINDS = [
+  "hero",
+  "statement",
+  // The public renderer draws custom as a statement card; so does HyperFrames.
+  "custom",
+  "mechanism",
+  "points",
+  "equation",
+  "video-window",
+  "cta"
+];
+var PAIRED_FPS = { min: 1, max: 240 };
+var PAIRED_LIMITS = {
+  scenes: 24,
+  sceneDurationMs: 3e5,
+  totalDurationMs: 20 * 60 * 1e3
+};
+var text2 = (max) => z2.string().max(max).refine((value) => value.trim().length > 0, "Must not be blank.");
+var mediaPath = (extensions) => z2.string().max(200).refine(
+  (value) => /^public\/(?:[A-Za-z0-9_-][A-Za-z0-9._-]*\/)*[A-Za-z0-9_-][A-Za-z0-9._-]*$/.test(
+    value
+  ) && !value.split("/").includes("..") && extensions.some((extension) => value.toLowerCase().endsWith(extension)),
+  `Use a local file under public/ ending in ${extensions.join(
+    ", "
+  )}. Remote URLs and other paths are not supported by the paired templates.`
+);
+var videoPath = mediaPath([".mp4"]);
+var audioPath = mediaPath([".wav", ".mp3", ".m4a"]);
+var contentSchemas = {
+  hero: z2.object({
+    title: text2(160).optional(),
+    line1: text2(160).optional(),
+    subtitle: text2(400).optional(),
+    line2: text2(400).optional(),
+    footer: text2(120).optional()
+  }).strict(),
+  statement: z2.object({
+    title: text2(160).optional(),
+    line1: text2(160).optional(),
+    subtitle: text2(400).optional(),
+    line2: text2(400).optional(),
+    label: text2(60).optional()
+  }).strict(),
+  custom: z2.object({
+    title: text2(160).optional(),
+    line1: text2(160).optional(),
+    subtitle: text2(400).optional(),
+    line2: text2(400).optional(),
+    label: text2(60).optional()
+  }).strict(),
+  // The public renderer reads only title here and invents copy for missing
+  // before/after states, so all three are required.
+  mechanism: z2.object({
+    title: text2(160),
+    subtitle: text2(400).optional(),
+    label: text2(60).optional(),
+    before: text2(80),
+    after: text2(80)
+  }).strict(),
+  points: z2.object({
+    title: text2(160).optional(),
+    line1: text2(160).optional(),
+    subtitle: text2(400).optional(),
+    label: text2(60).optional(),
+    points: z2.array(text2(160)).max(8).default([])
+  }).strict(),
+  equation: z2.object({
+    title: text2(160),
+    latexBlocks: z2.array(text2(400)).min(1).max(6)
+  }).strict(),
+  "video-window": z2.object({
+    title: text2(160),
+    src: videoPath
+  }).strict(),
+  cta: z2.object({
+    title: text2(160).optional(),
+    line1: text2(160).optional(),
+    subtitle: text2(400).optional(),
+    line2: text2(400).optional()
+  }).strict()
+};
+var narrationTimingSchema = z2.object({
+  schemaVersion: z2.literal("1.0"),
+  source: z2.literal("segmented-synthesis"),
+  durationMs: z2.number().int().positive().max(PAIRED_LIMITS.totalDurationMs),
+  segments: z2.array(
+    z2.object({
+      sceneId: z2.string().min(1).max(80),
+      startMs: z2.number().int().nonnegative(),
+      endMs: z2.number().int().positive(),
+      durationMs: z2.number().int().positive()
+    }).strict()
+  ).min(1).max(PAIRED_LIMITS.scenes)
+}).strict();
+var sceneSchema = z2.object({
+  id: z2.string().min(1).max(80),
+  kind: z2.string(),
+  content: z2.record(z2.unknown()),
+  timing: z2.object({
+    durationMs: z2.number().int().positive().max(PAIRED_LIMITS.sceneDurationMs).optional()
+  }).strict().optional()
+}).strict();
+var specShape = z2.object({
+  schemaVersion: z2.literal("1.0"),
+  id: z2.string().regex(/^[a-z0-9][a-z0-9-]{2,80}$/),
+  templateFamily: z2.enum(PAIRED_TEMPLATE_FAMILIES),
+  meta: z2.object({
+    title: z2.string().min(1).max(160),
+    description: z2.string().max(500).optional(),
+    tags: z2.array(z2.string().max(40)).max(20).default([])
+  }).strict(),
+  target: z2.object({
+    aspect: z2.enum(["9:16", "4:5", "1:1"]),
+    fps: z2.number().int().positive().default(30),
+    durationMode: z2.enum(["auto", "fixed"]).default("auto"),
+    fixedDurationSec: z2.number().positive().max(PAIRED_LIMITS.totalDurationMs / 1e3).optional()
+  }).strict(),
+  style: z2.object({
+    theme: z2.enum(["default", "editorial-light", "editorial-dark", "clinical"]).default("default"),
+    variant: z2.string().default("default"),
+    safeAreaProfile: z2.enum(["baseline", "metaSafe"]).default("baseline"),
+    showSceneLabels: z2.boolean().default(false)
+  }).strict().default({}),
+  audio: z2.object({
+    mode: z2.enum(["auto", "narration", "music", "silent"]).default("auto"),
+    narrationText: z2.string().max(1e4).optional(),
+    narrationSrc: audioPath.optional(),
+    narrationTiming: narrationTimingSchema.optional(),
+    narrationVolume: z2.number().min(0).max(1).default(1),
+    musicSrc: audioPath.optional(),
+    musicVolume: z2.number().min(0).max(1).default(0.16),
+    ducking: z2.boolean().default(true)
+  }).strict().default({}),
+  assets: z2.object({
+    logoSrc: z2.string().optional(),
+    posterSrc: z2.string().optional()
+  }).strict().default({}),
+  scenes: z2.array(sceneSchema).min(1).max(PAIRED_LIMITS.scenes)
+}).strict();
+var DIMENSIONS = {
+  "9:16": { width: 1080, height: 1920 },
+  "4:5": { width: 1080, height: 1350 },
+  "1:1": { width: 1080, height: 1080 }
+};
+function pairedTimeline(spec) {
+  const fps = spec.target.fps;
+  const sceneMs = (scene) => spec.audio.narrationTiming?.segments.find(
+    (segment) => segment.sceneId === scene.id
+  )?.durationMs ?? scene.timing?.durationMs ?? 3e3;
+  const totalMs = spec.scenes.reduce((sum, scene) => sum + sceneMs(scene), 0);
+  const durationInFrames = spec.target.durationMode === "fixed" && spec.target.fixedDurationSec ? Math.max(1, Math.round(spec.target.fixedDurationSec * fps)) : Math.max(1, Math.round(totalMs / 1e3 * fps));
+  let cursor = 0;
+  const scenes = spec.scenes.map((scene, index) => {
+    const frames = Math.max(1, Math.round(sceneMs(scene) / 1e3 * fps));
+    const startFrame = cursor;
+    cursor += frames;
+    return {
+      index,
+      id: scene.id,
+      kind: scene.kind,
+      startFrame,
+      durationInFrames: frames,
+      visibleFrames: Math.max(
+        0,
+        Math.min(frames, durationInFrames - startFrame)
+      )
+    };
+  });
+  return { fps, ...DIMENSIONS[spec.target.aspect], durationInFrames, scenes };
+}
+function stringValue(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function qualityReview(spec) {
+  const errors = [];
+  const notes = [];
+  spec.scenes.forEach((scene, index) => {
+    if (scene.kind === "custom")
+      notes.push({
+        level: "warning",
+        code: "custom-renders-as-statement",
+        message: `Scene ${index + 1} is custom. Both frameworks draw it as a statement card; no custom code runs.`
+      });
+  });
+  const audio = spec.audio;
+  const audible = audio.mode === "narration" || audio.mode === "music" || audio.mode === "auto" && Boolean(audio.narrationSrc || audio.musicSrc);
+  if (audio.mode === "narration" && !audio.narrationSrc)
+    errors.push({
+      path: "audio.narrationSrc",
+      code: "narration-source-missing",
+      message: "audio.mode is narration, but audio.narrationSrc is missing. Add an existing audio file."
+    });
+  if (audio.mode === "music" && !audio.musicSrc)
+    errors.push({
+      path: "audio.musicSrc",
+      code: "music-source-missing",
+      message: "audio.mode is music, but audio.musicSrc is missing."
+    });
+  if (audio.narrationText && !audio.narrationSrc) {
+    if (audio.mode === "silent")
+      notes.push({
+        level: "warning",
+        code: "narration-text-not-rendered",
+        message: "Narration text exists without narrationSrc. Written narration is not audible until audio is generated or attached."
+      });
+    else
+      errors.push({
+        path: "audio.narrationText",
+        code: "narration-text-not-rendered",
+        message: "Narration text exists without narrationSrc. Written narration is not audible until audio is generated or attached."
+      });
+  }
+  if (audio.narrationTiming) {
+    const ids = spec.scenes.map((scene) => scene.id);
+    const timed = audio.narrationTiming.segments.map((item) => item.sceneId);
+    if (ids.length !== timed.length || ids.some((id2, index) => timed[index] !== id2))
+      errors.push({
+        path: "audio.narrationTiming.segments",
+        code: "narration-timing-scene-mismatch",
+        message: "Narration timing must contain exactly one ordered segment for every scene."
+      });
+  }
+  if (!audible)
+    notes.push({
+      level: "info",
+      code: "intentional-silence",
+      message: "No audible audio is configured. Set audio.mode to silent only when this is intentional."
+    });
+  if (spec.style.showSceneLabels)
+    notes.push({
+      level: "warning",
+      code: "debug-labels-visible",
+      message: "Scene-kind labels are visible. Keep showSceneLabels false for audience-facing renders."
+    });
+  spec.scenes.forEach((scene, index) => {
+    const title2 = stringValue(scene.content.title) || stringValue(scene.content.line1);
+    const label2 = stringValue(scene.content.label);
+    const at = `scenes.${index}`;
+    if (!title2)
+      errors.push({
+        path: `${at}.content.title`,
+        code: "scene-title-missing",
+        message: `Scene ${index + 1} (${scene.id}) has no title or line1.`
+      });
+    if (title2.length > 82)
+      notes.push({
+        level: "warning",
+        code: "headline-too-long",
+        message: `Scene ${index + 1} headline has ${title2.length} characters. Prefer 82 or fewer.`
+      });
+    if (title2.length >= 12 && title2 === title2.toUpperCase())
+      notes.push({
+        level: "warning",
+        code: "all-caps-headline",
+        message: `Scene ${index + 1} uses an all-caps headline. Use sentence case for editorial hierarchy.`
+      });
+    if (label2 && label2 === label2.toUpperCase())
+      notes.push({
+        level: "warning",
+        code: "all-caps-label",
+        message: `Scene ${index + 1} uses an all-caps label. Remove it or use sentence case only when it adds meaning.`
+      });
+    if (label2 && ["hero", "custom", "points", "cta"].includes(label2.toLowerCase()))
+      errors.push({
+        path: `${at}.content.label`,
+        code: "implementation-label",
+        message: `Scene ${index + 1} exposes the implementation label "${label2}". Remove it from audience-facing copy.`
+      });
+    const points = Array.isArray(scene.content.points) ? scene.content.points : [];
+    if (points.length > 4)
+      notes.push({
+        level: "warning",
+        code: "too-many-points",
+        message: `Scene ${index + 1} has ${points.length} points. Prefer four or fewer.`
+      });
+    if (points.some((point2) => point2.length > 58))
+      notes.push({
+        level: "warning",
+        code: "point-too-long",
+        message: `Scene ${index + 1} contains a point longer than 58 characters.`
+      });
+  });
+  const kinds = new Set(spec.scenes.map((scene) => scene.kind));
+  if (spec.scenes.length >= 4 && kinds.size < 3)
+    notes.push({
+      level: "warning",
+      code: "weak-scene-differentiation",
+      message: "Four or more scenes use fewer than three layout kinds. Add visual structure instead of repeating text slides."
+    });
+  return { errors, notes };
+}
+function zodIssues(error, prefix = "") {
+  return error.issues.map((issue) => ({
+    path: [prefix, ...issue.path.map(String)].filter(Boolean).join("."),
+    code: issue.code === "unrecognized_keys" ? "unsupported-field" : "invalid-videospec",
+    message: issue.code === "unrecognized_keys" ? `${issue.message}. Neither paired renderer reads these fields; remove them rather than expecting them to render.` : issue.message
+  }));
+}
+function validatePairedVideoSpec(raw) {
+  const parsed = specShape.safeParse(raw);
+  if (!parsed.success) return { ok: false, issues: zodIssues(parsed.error) };
+  const shape2 = parsed.data;
+  const issues = [];
+  const reject = (path, code, message) => issues.push({ path, code, message });
+  if (shape2.target.fps > PAIRED_FPS.max)
+    reject(
+      "target.fps",
+      "unsupported-fps",
+      `Paired templates render at whole frame rates from ${PAIRED_FPS.min} to ${PAIRED_FPS.max} fps, the range the HyperFrames renderer accepts.`
+    );
+  if (shape2.target.durationMode === "fixed" && !shape2.target.fixedDurationSec)
+    reject(
+      "target.fixedDurationSec",
+      "fixed-duration-missing",
+      "durationMode fixed needs fixedDurationSec; the public renderer would otherwise fall back to automatic duration."
+    );
+  if (shape2.target.durationMode === "auto" && shape2.target.fixedDurationSec)
+    reject(
+      "target.fixedDurationSec",
+      "fixed-duration-unused",
+      "fixedDurationSec is ignored unless durationMode is fixed. Remove it or set durationMode to fixed."
+    );
+  if (shape2.style.variant !== "default")
+    reject(
+      "style.variant",
+      "unsupported-style-variant",
+      "Only the default variant exists. The public renderer ignores other variant values."
+    );
+  if (shape2.style.safeAreaProfile !== "baseline")
+    reject(
+      "style.safeAreaProfile",
+      "unsupported-safe-area",
+      "Neither renderer applies a metaSafe layout; it renders exactly like baseline. Set baseline so the document does not promise safe-area handling."
+    );
+  for (const key of ["logoSrc", "posterSrc"])
+    if (shape2.assets[key] !== void 0)
+      reject(
+        `assets.${key}`,
+        "unsupported-asset",
+        `assets.${key} is not rendered by either framework. Remove it.`
+      );
+  const narrationTiming = shape2.audio.narrationTiming;
+  if (narrationTiming) {
+    let previousEnd = 0;
+    const timedIds = /* @__PURE__ */ new Set();
+    narrationTiming.segments.forEach((segment, index) => {
+      const at = `audio.narrationTiming.segments.${index}`;
+      if (timedIds.has(segment.sceneId))
+        reject(
+          `${at}.sceneId`,
+          "invalid-videospec",
+          "Narration timing scene IDs must be unique."
+        );
+      timedIds.add(segment.sceneId);
+      if (segment.startMs !== previousEnd)
+        reject(
+          `${at}.startMs`,
+          "invalid-videospec",
+          "Narration timing segments must be contiguous."
+        );
+      if (segment.durationMs !== segment.endMs - segment.startMs)
+        reject(
+          `${at}.durationMs`,
+          "invalid-videospec",
+          "Narration timing duration must equal endMs minus startMs."
+        );
+      previousEnd = segment.endMs;
+    });
+    if (previousEnd !== narrationTiming.durationMs)
+      reject(
+        "audio.narrationTiming.durationMs",
+        "invalid-videospec",
+        "Narration timing duration must end with the final segment."
+      );
+  }
+  if (shape2.audio.mode === "silent" && (shape2.audio.narrationSrc || shape2.audio.musicSrc))
+    reject(
+      "audio.mode",
+      "audio-mode-conflict",
+      "audio.mode is silent, but an audio source is set and would still play. Remove the source or change the mode."
+    );
+  const ids = /* @__PURE__ */ new Set();
+  const scenes = [];
+  shape2.scenes.forEach((scene, index) => {
+    const at = `scenes.${index}`;
+    if (ids.has(scene.id))
+      reject(`${at}.id`, "duplicate-scene-id", "Scene IDs must be unique.");
+    ids.add(scene.id);
+    if (!PAIRED_SCENE_KINDS.includes(scene.kind)) {
+      reject(
+        `${at}.kind`,
+        "invalid-videospec",
+        `Unknown scene kind ${JSON.stringify(scene.kind)}.`
+      );
+      return;
+    }
+    const kind = scene.kind;
+    const content = contentSchemas[kind].safeParse(scene.content);
+    if (!content.success) {
+      issues.push(...zodIssues(content.error, `${at}.content`));
+      return;
+    }
+    const value = content.data;
+    for (const [first, second] of [
+      ["title", "line1"],
+      ["subtitle", "line2"]
+    ])
+      if (value[first] !== void 0 && value[second] !== void 0)
+        reject(
+          `${at}.content.${second}`,
+          "ambiguous-copy-field",
+          `Supply ${first} or ${second}, not both; the renderer shows only ${first}.`
+        );
+    if (kind === "equation") {
+      const blocks = value.latexBlocks;
+      if (new Set(blocks).size !== blocks.length)
+        reject(
+          `${at}.content.latexBlocks`,
+          "duplicate-equation",
+          "Equation blocks must be unique."
+        );
+    }
+    scenes.push({ ...scene, kind, content: value });
+  });
+  if (issues.length) return { ok: false, issues };
+  const spec = { ...shape2, scenes };
+  const quality = qualityReview(spec);
+  issues.push(...quality.errors);
+  const timeline = pairedTimeline(spec);
+  const sceneFrames = timeline.scenes.reduce(
+    (sum, scene) => sum + scene.durationInFrames,
+    0
+  );
+  if (timeline.durationInFrames / timeline.fps > PAIRED_LIMITS.totalDurationMs / 1e3)
+    reject(
+      "scenes",
+      "duration-too-long",
+      "Paired templates are limited to 20 minutes."
+    );
+  if (spec.target.durationMode === "fixed" && timeline.durationInFrames < sceneFrames)
+    reject(
+      "target.fixedDurationSec",
+      "fixed-duration-truncates",
+      `fixedDurationSec gives ${timeline.durationInFrames} frames but the scenes need ${sceneFrames}; later scenes would be cut off.`
+    );
+  const hidden = timeline.scenes.find((scene) => scene.visibleFrames === 0);
+  if (hidden)
+    reject(
+      `scenes.${hidden.index}.timing`,
+      "scene-not-visible",
+      "Frame rounding leaves this scene no visible frames. Lengthen the scene durations."
+    );
+  if (issues.length) return { ok: false, issues };
+  return { ok: true, spec, timeline, qualityNotes: quality.notes };
+}
+
+// src/paired-templates/catalogue.ts
+var FRAMEWORKS = ["remotion", "hyperframes"];
+var videoSpecContract = {
+  id: PAIRED_VIDEOSPEC_CONTRACT,
+  validate(raw) {
+    const result3 = validatePairedVideoSpec(raw);
+    if (!result3.ok) return result3;
+    const { spec, timeline, qualityNotes } = result3;
+    return {
+      ok: true,
+      document: spec,
+      timeline,
+      qualityNotes,
+      realise: (framework3) => framework3 === "remotion" ? {
+        files: remotionVideoSpecFiles(spec, timeline),
+        commands: remotionVideoSpecCommands(spec),
+        runtime: { ...REMOTION_TEMPLATES }
+      } : {
+        files: hyperframesVideoSpecFiles(spec, timeline),
+        commands: [
+          "npm install",
+          "npm run setup",
+          "npm run check",
+          "npm run preview",
+          "npm run render"
+        ],
+        runtime: { ...HYPERFRAMES_RUNTIME }
+      }
+    };
+  }
+};
+var familyNames = {
+  "qa-ad": "Question and answer ad",
+  "proof-walkthrough": "Proof walkthrough",
+  "announcement-brief": "Announcement brief",
+  "social-remix": "Social remix",
+  "finance-brief": "Data and finance brief"
+};
+var PAIRED_CONTRACTS = {
+  [videoSpecContract.id]: videoSpecContract
+};
+var PAIRED_FAMILIES = PAIRED_TEMPLATE_FAMILIES.map((id2) => ({
+  id: id2,
+  name: familyNames[id2],
+  contract: PAIRED_VIDEOSPEC_CONTRACT,
+  frameworks: FRAMEWORKS
+}));
+function contractForFamily(templateFamily) {
+  const family = PAIRED_FAMILIES.find((item) => item.id === templateFamily);
+  return family ? PAIRED_CONTRACTS[family.contract] : void 0;
+}
+
+// src/paired-templates/prepare-video-template.ts
+function pairedTemplatesEnabled(env = process.env) {
+  return env.INSTAVAR_PAIRED_TEMPLATES !== "0";
+}
+var PAIRED_TEMPLATE_CAPABILITY = {
+  tool: "prepare_video_template",
+  contract: PAIRED_VIDEOSPEC_CONTRACT,
+  frameworks: FRAMEWORKS,
+  families: PAIRED_FAMILIES.map((family) => family.id),
+  fps: PAIRED_FPS,
+  aspects: ["9:16", "4:5", "1:1"],
+  realisations: {
+    remotion: `${REMOTION_TEMPLATES.repository} at ${REMOTION_TEMPLATES.commit}`,
+    hyperframes: `hyperframes ${HYPERFRAMES_RUNTIME.hyperframes} source generated from the same VideoSpec`
+  },
+  scope: "One VideoSpec document, realised in either framework. Returns local source and commands; does not save, upload or render. Fields neither renderer honours are rejected, not dropped."
+};
+var PAIRED_TEMPLATE_INSTRUCTIONS = "For a VideoSpec template in Remotion or HyperFrames, use prepare_video_template with the VideoSpec. Never infer a framework from creative wording; omit framework unless the user chose one or said no preference, and ask the user on needs-selection. Continue with the returned project: edit project.spec, then call again to regenerate or to switch frameworks. A rejected field is unsupported in both frameworks; fix it rather than dropping it. The tool returns local source and commands; it does not render, save or upload.";
+var framework2 = z3.enum(["remotion", "hyperframes"]);
+var prepareVideoTemplateInput = {
+  framework: z3.enum(["remotion", "hyperframes", "no-preference"]).optional().describe(
+    "Only supply an explicit user choice. Omit for an ambiguous request or to inherit the existing project framework."
+  ),
+  spec: z3.record(z3.unknown()).optional().describe("A VideoSpec 1.0 document for a new project."),
+  project: z3.object({
+    contract: z3.literal(PAIRED_VIDEOSPEC_CONTRACT),
+    framework: framework2,
+    spec: z3.record(z3.unknown())
+  }).strict().optional().describe(
+    "The latest project returned by this tool, with any edits made to project.spec. Caller-held, not a saved hosted project."
+  )
+};
+var inputSchema2 = z3.object(prepareVideoTemplateInput).strict();
+function prepareVideoTemplate(raw) {
+  const input = inputSchema2.parse(raw);
+  if (input.spec && input.project)
+    throw new Error(
+      "Supply spec for a new project or project to continue one, not both."
+    );
+  const spec = input.project?.spec ?? input.spec;
+  if (!spec)
+    return {
+      isError: false,
+      result: {
+        status: "needs-spec",
+        message: "Supply a VideoSpec 1.0 document. Use scaffold_video_spec for a starting point."
+      }
+    };
+  const contract = contractForFamily(spec.templateFamily);
+  if (!contract)
+    return {
+      isError: true,
+      result: {
+        status: "rejected",
+        issues: [
+          {
+            path: "templateFamily",
+            code: "unsupported-family",
+            message: `Paired templates cover ${PAIRED_FAMILIES.map(
+              (family) => family.id
+            ).join(", ")}.`
+          }
+        ]
+      }
+    };
+  const validated = contract.validate(spec);
+  if (!validated.ok)
+    return {
+      isError: true,
+      result: {
+        status: "rejected",
+        contract: contract.id,
+        issues: validated.issues,
+        message: "No source was generated. These fields are unsupported in both frameworks; change them and call again."
+      }
+    };
+  const selected = input.framework === "remotion" || input.framework === "hyperframes" ? input.framework : input.project?.framework ?? (input.framework === "no-preference" ? "remotion" : void 0);
+  if (!selected)
+    return {
+      isError: false,
+      result: {
+        status: "needs-selection",
+        options: ["remotion", "hyperframes", "no-preference"],
+        message: "Which framework would you like: Remotion, HyperFrames, or no preference? No source was generated."
+      }
+    };
+  const realisation = validated.realise(selected);
+  return {
+    isError: false,
+    result: {
+      status: "ready",
+      reason: input.framework && input.framework !== "no-preference" ? "explicit" : input.project ? "existing-project" : "visible-default",
+      project: {
+        contract: contract.id,
+        framework: selected,
+        spec: validated.document
+      },
+      timeline: validated.timeline,
+      qualityNotes: validated.qualityNotes,
+      runtime: realisation.runtime,
+      files: realisation.files,
+      commands: realisation.commands,
+      instructions: "Save these files in a new directory and place each media file at the public/ path the spec names. The same preflight checks media for both frameworks. Equation blocks are shown as source text, not typeset. Keep project.spec as the content source of truth: regenerating or switching frameworks keeps only what the spec holds, not edits made to generated files. This tool has not written files, saved a hosted project or rendered video."
+    }
+  };
+}
+function registerPairedTemplates(server) {
+  server.registerTool(
+    "prepare_video_template",
+    {
+      title: "Prepare a template video in Remotion or HyperFrames",
+      description: "Validate one VideoSpec against the paired template contract and return local source for the chosen framework, or switch an existing project's framework. " + PAIRED_TEMPLATE_INSTRUCTIONS,
+      inputSchema: prepareVideoTemplateInput,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false
+      },
+      _meta: { securitySchemes: [{ type: "noauth" }] }
+    },
+    async (args) => {
+      try {
+        const { isError, result: result3 } = prepareVideoTemplate(args);
+        return {
+          ...isError ? { isError: true } : {},
+          structuredContent: result3,
+          content: [{ type: "text", text: JSON.stringify(result3) }]
+        };
+      } catch (error) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: error instanceof Error ? error.message : "Invalid template input"
+            }
+          ]
+        };
+      }
+    }
+  );
+}
+
 // src/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 // src/creative-guides.ts
-import { z } from "zod";
+import { z as z4 } from "zod";
 
 // src/creative-guides.generated.ts
 var CREATIVE_GUIDES = [
@@ -36,16 +1470,16 @@ var CREATIVE_GUIDES = [
 ];
 
 // src/creative-guides.ts
-var creativeGuideIdSchema = z.enum([
+var creativeGuideIdSchema = z4.enum([
   "visual-copy",
   "carousel-stories",
   "visual-design",
   "human-review"
 ]);
 var CREATIVE_GUIDE_INDEX = CREATIVE_GUIDES.map(
-  ({ id: id2, title, uri }) => ({
+  ({ id: id2, title: title2, uri }) => ({
     id: id2,
-    title,
+    title: title2,
     uri
   })
 );
@@ -66,83 +1500,513 @@ function registerCreativeGuides(server) {
       })
     );
   }
-  server.registerTool(
-    "get_creative_guide",
-    {
-      title: "Get a visual communication guide",
-      description: "Read practical guidance before drafting concise plain or poetic copy, choosing carousel stories, designing visuals or recording human feedback. Returns guidance for the calling assistant to apply, not generated copy or saved feedback. Omit guideId to list guides.",
-      inputSchema: { guideId: creativeGuideIdSchema.optional() },
-      annotations: {
-        readOnlyHint: true,
-        destructiveHint: false,
-        openWorldHint: false
-      },
-      _meta: { securitySchemes: [{ type: "noauth" }] }
-    },
-    async ({ guideId }) => {
-      const guide = CREATIVE_GUIDES.find((entry) => entry.id === guideId);
-      return {
-        structuredContent: guide ? { guide } : { guides: CREATIVE_GUIDE_INDEX },
-        content: [
-          {
-            type: "text",
-            text: guide ? guide.text : CREATIVE_GUIDE_INDEX.map(
-              (entry) => `${entry.id}: ${entry.title} (${entry.uri})`
-            ).join("\n")
+  server.registerTool(
+    "get_creative_guide",
+    {
+      title: "Get a visual communication guide",
+      description: "Read practical guidance before drafting concise plain or poetic copy, choosing carousel stories, designing visuals or recording human feedback. Returns guidance for the calling assistant to apply, not generated copy or saved feedback. Omit guideId to list guides.",
+      inputSchema: {
+        guideId: creativeGuideIdSchema.optional().describe("Guide to read. Omit to list the guides.")
+      },
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false
+      },
+      _meta: { securitySchemes: [{ type: "noauth" }] }
+    },
+    async ({ guideId }) => {
+      const guide = CREATIVE_GUIDES.find((entry) => entry.id === guideId);
+      return {
+        structuredContent: guide ? { guide } : { guides: CREATIVE_GUIDE_INDEX },
+        content: [
+          {
+            type: "text",
+            text: guide ? guide.text : CREATIVE_GUIDE_INDEX.map(
+              (entry) => `${entry.id}: ${entry.title} (${entry.uri})`
+            ).join("\n")
+          }
+        ]
+      };
+    }
+  );
+}
+
+// src/public-catalogue.ts
+import { z as z5 } from "zod";
+
+// src/carousel/archetypes.ts
+function frame(slides, content, visualStyle = "editorial") {
+  return {
+    slides: slides.map((slide, index) => ({
+      ...slide,
+      image: content.images?.[index],
+      visualRequest: content.visualRequests?.[index]
+    })),
+    handle: content.handle,
+    showPageNumber: true,
+    visualStyle
+  };
+}
+var listicle = {
+  id: "listicle",
+  label: "Listicle",
+  blurb: "Hook, a numbered rundown on one slide, then the payoff.",
+  build: (c) => frame(
+    [
+      {
+        kind: "cover",
+        title: c.hook,
+        accent: c.accent,
+        subtitle: c.subtitle
+      },
+      {
+        kind: "list",
+        title: c.listTitle ?? "The rundown",
+        items: c.points
+      },
+      { kind: "takeaway", title: c.payoff, accent: c.accent, cta: c.cta }
+    ],
+    c
+  )
+};
+var manifesto = {
+  id: "manifesto",
+  label: "Manifesto",
+  blurb: "Hook, then one punchy idea per slide, building to the payoff.",
+  build: (c) => frame(
+    [
+      {
+        kind: "cover",
+        title: c.hook,
+        accent: c.accent,
+        subtitle: c.subtitle
+      },
+      ...c.points.map(
+        (p) => ({
+          kind: "statement",
+          statement: p
+        })
+      ),
+      { kind: "takeaway", title: c.payoff, cta: c.cta }
+    ],
+    c
+  )
+};
+var beforeAfter = {
+  id: "before-after",
+  label: "Before / After",
+  blurb: "Hook, the problem, the contrast, then the payoff.",
+  build: (c) => {
+    const problem = c.points[0] ?? "";
+    const contrast = c.points[c.points.length - 1] ?? problem;
+    return frame(
+      [
+        {
+          kind: "cover",
+          title: c.hook,
+          accent: c.accent,
+          subtitle: c.subtitle
+        },
+        { kind: "statement", statement: problem, footnote: "The status quo" },
+        { kind: "statement", statement: contrast, footnote: "The shift" },
+        { kind: "takeaway", title: c.payoff, accent: c.accent, cta: c.cta }
+      ],
+      c
+    );
+  }
+};
+var valueFirstReveal = {
+  id: "value-first-reveal",
+  label: "Value-First Reveal",
+  blurb: "Three useful beats first, then proof and a restrained product reveal.",
+  build: (c) => {
+    const beats = [0, 1, 2].map(
+      (index) => c.points[index] ?? c.points.at(-1) ?? c.payoff
+    );
+    const bridge = c.bridge ?? "Here is what makes this repeatable.";
+    const proof = c.productProof ?? c.payoff;
+    return frame(
+      [
+        {
+          kind: "cover",
+          title: c.hook,
+          accent: c.accent,
+          subtitle: c.subtitle
+        },
+        { kind: "statement", statement: beats[0], footnote: "01 \xB7 The value" },
+        { kind: "statement", statement: beats[1], footnote: "02 \xB7 The value" },
+        { kind: "statement", statement: beats[2], footnote: "03 \xB7 The value" },
+        {
+          kind: "statement",
+          statement: bridge,
+          footnote: `Proof \xB7 ${proof}`
+        },
+        {
+          kind: "takeaway",
+          title: c.productReveal ?? c.payoff,
+          cta: [c.cta, c.disclosure].filter(Boolean).join(" \xB7 ") || void 0
+        }
+      ],
+      c
+    );
+  }
+};
+var CAROUSEL_ARCHETYPES = [
+  listicle,
+  manifesto,
+  beforeAfter,
+  valueFirstReveal
+];
+function getArchetype(id2) {
+  return CAROUSEL_ARCHETYPES.find((a) => a.id === id2);
+}
+var DEFAULT_CAROUSEL_CONTENT = {
+  hook: "Just say the word.",
+  accent: "the word",
+  subtitle: "How one sentence becomes a finished video.",
+  listTitle: "What you skip",
+  points: [
+    "Storyboarding every shot by hand",
+    "Re-recording voiceover for one wording change",
+    "Fighting a timeline editor for an hour"
+  ],
+  payoff: "Describe it. We render it.",
+  bridge: "The workflow gets easier when one brief drives every production step.",
+  productProof: "One approved brief, one repeatable render pipeline.",
+  productReveal: "Instavar turns the brief into the first draft.",
+  images: [
+    "2025_video_hooks_hero.v20250811.avif",
+    "ai_content_ops_system.v20250811.avif",
+    "short_form_funnel_blueprint.v20250811.avif",
+    "server_side_tracking_playbook.v20250811.avif",
+    "retention_loops_post_purchase_funnel.v20250811.avif",
+    "true_roas_incrementality_first.v20250811.avif"
+  ].map((file, index) => ({
+    src: `https://thumbnails.instavar.com/${file}`,
+    alt: `Instavar AI-generated carousel sample image ${index + 1}`,
+    provenance: "ai-generated"
+  })),
+  cta: "Start at instavar.com. Your first draft is one sentence away.",
+  handle: "@instavar"
+};
+
+// src/carousel/aspect-contract.ts
+var CAROUSEL_ASPECTS = ["4:5", "3:4", "1:1", "9:16"];
+function isCarouselAspect(value) {
+  return CAROUSEL_ASPECTS.some((aspect) => aspect === value);
+}
+
+// src/carousel/deck-contract.ts
+var IMAGE_PROVENANCE = /* @__PURE__ */ new Set([
+  "user-owned",
+  "licensed-stock",
+  "ai-generated"
+]);
+var VISUAL_KINDS = /* @__PURE__ */ new Set([
+  "photography",
+  "illustration",
+  "diagram",
+  "background",
+  "visual-metaphor"
+]);
+var EVIDENCE_LABELS = /* @__PURE__ */ new Set([
+  "AI-generated visual",
+  "Concept illustration"
+]);
+var INPUT_IMAGE_PROVENANCE = /* @__PURE__ */ new Set(["user-owned", "licensed-stock"]);
+var CAROUSEL_DECK_LIMITS = {
+  slides: 12,
+  handle: 40,
+  imageSrc: 2048,
+  imageAlt: 240,
+  visualRequest: { id: 120, prompt: 1200, direction: 500, inputs: 4 },
+  cover: { title: 100, accent: 100, subtitle: 160 },
+  statement: { statement: 220, accent: 220, footnote: 100 },
+  list: { title: 80, accent: 80, items: 5, item: 120 },
+  takeaway: { title: 120, accent: 120, cta: 140 }
+};
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function textLength(value) {
+  return Array.from(value.trim()).length;
+}
+function validateText(value, path, maxLength, issues, options = {}) {
+  if (value === void 0 && options.optional) return;
+  if (!isNonEmptyString(value)) {
+    issues.push(`${path} is required`);
+    return;
+  }
+  if (textLength(value) > maxLength) {
+    issues.push(`${path} must be at most ${maxLength} characters`);
+  }
+}
+function validateOptionalImage(value, path, issues) {
+  if (value === void 0) return;
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    issues.push(`${path} must be an object`);
+    return;
+  }
+  const image = value;
+  validateText(image.src, `${path}.src`, CAROUSEL_DECK_LIMITS.imageSrc, issues);
+  validateText(image.alt, `${path}.alt`, CAROUSEL_DECK_LIMITS.imageAlt, issues);
+  if (!isNonEmptyString(image.provenance) || !IMAGE_PROVENANCE.has(image.provenance)) {
+    issues.push(`${path}.provenance is invalid`);
+  }
+  if (image.generation !== void 0) {
+    const generation = image.generation;
+    if (!generation || typeof generation !== "object" || Array.isArray(generation)) {
+      issues.push(`${path}.generation must be an object`);
+    } else {
+      const record2 = generation;
+      for (const field of ["provider", "model", "generatedAt", "promptHash"])
+        validateText(record2[field], `${path}.generation.${field}`, 200, issues);
+      if (isNonEmptyString(record2.generatedAt) && Number.isNaN(Date.parse(record2.generatedAt))) {
+        issues.push(`${path}.generation.generatedAt must be an ISO timestamp`);
+      }
+      validateText(
+        record2.outputHash,
+        `${path}.generation.outputHash`,
+        200,
+        issues,
+        {
+          optional: true
+        }
+      );
+    }
+  }
+}
+function validateOptionalVisualRequest(value, path, issues) {
+  if (value === void 0) return;
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    issues.push(`${path} must be an object`);
+    return;
+  }
+  const request = value;
+  validateText(
+    request.id,
+    `${path}.id`,
+    CAROUSEL_DECK_LIMITS.visualRequest.id,
+    issues
+  );
+  validateText(
+    request.prompt,
+    `${path}.prompt`,
+    CAROUSEL_DECK_LIMITS.visualRequest.prompt,
+    issues
+  );
+  validateText(
+    request.direction,
+    `${path}.direction`,
+    CAROUSEL_DECK_LIMITS.visualRequest.direction,
+    issues
+  );
+  validateText(
+    request.alt,
+    `${path}.alt`,
+    CAROUSEL_DECK_LIMITS.imageAlt,
+    issues
+  );
+  if (!isNonEmptyString(request.kind) || !VISUAL_KINDS.has(request.kind)) {
+    issues.push(`${path}.kind is invalid`);
+  }
+  if (!isNonEmptyString(request.evidenceLabel) || !EVIDENCE_LABELS.has(request.evidenceLabel)) {
+    issues.push(`${path}.evidenceLabel is invalid`);
+  }
+  if (request.inputImages !== void 0) {
+    if (!Array.isArray(request.inputImages)) {
+      issues.push(`${path}.inputImages must be an array`);
+    } else {
+      if (request.inputImages.length > CAROUSEL_DECK_LIMITS.visualRequest.inputs) {
+        issues.push(
+          `${path}.inputImages must contain at most ${CAROUSEL_DECK_LIMITS.visualRequest.inputs} items`
+        );
+      }
+      request.inputImages.forEach((candidate, index) => {
+        const inputPath = `${path}.inputImages[${index}]`;
+        if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) {
+          issues.push(`${inputPath} must be an object`);
+          return;
+        }
+        const input = candidate;
+        validateText(
+          input.src,
+          `${inputPath}.src`,
+          CAROUSEL_DECK_LIMITS.imageSrc,
+          issues
+        );
+        if (!isNonEmptyString(input.provenance) || !INPUT_IMAGE_PROVENANCE.has(input.provenance)) {
+          issues.push(`${inputPath}.provenance is invalid`);
+        }
+      });
+    }
+  }
+}
+function validateCarouselDeck(value) {
+  const issues = [];
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return { ok: false, issues: ["deck must be an object"] };
+  }
+  const deck = value;
+  if (deck.aspect !== void 0 && !isCarouselAspect(deck.aspect)) {
+    issues.push("deck.aspect is invalid");
+  }
+  if (!Array.isArray(deck.slides) || deck.slides.length === 0) {
+    issues.push("deck.slides must contain at least one slide");
+    return { ok: false, issues };
+  }
+  if (deck.slides.length > CAROUSEL_DECK_LIMITS.slides) {
+    issues.push(
+      `deck.slides must contain at most ${CAROUSEL_DECK_LIMITS.slides} slides`
+    );
+  }
+  validateText(
+    deck.handle,
+    "deck.handle",
+    CAROUSEL_DECK_LIMITS.handle,
+    issues,
+    { optional: true }
+  );
+  if (deck.showPageNumber !== void 0 && typeof deck.showPageNumber !== "boolean") {
+    issues.push("deck.showPageNumber must be a boolean");
+  }
+  if (deck.visualStyle !== void 0 && deck.visualStyle !== "editorial" && deck.visualStyle !== "native-photo") {
+    issues.push("deck.visualStyle is invalid");
+  }
+  const visualRequestIds = /* @__PURE__ */ new Set();
+  deck.slides.forEach((value2, index) => {
+    const path = `deck.slides[${index}]`;
+    if (!value2 || typeof value2 !== "object" || Array.isArray(value2)) {
+      issues.push(`${path} must be an object`);
+      return;
+    }
+    const slide = value2;
+    switch (slide.kind) {
+      case "cover":
+        validateText(
+          slide.title,
+          `${path}.title`,
+          CAROUSEL_DECK_LIMITS.cover.title,
+          issues
+        );
+        validateText(
+          slide.accent,
+          `${path}.accent`,
+          CAROUSEL_DECK_LIMITS.cover.accent,
+          issues,
+          { optional: true }
+        );
+        validateText(
+          slide.subtitle,
+          `${path}.subtitle`,
+          CAROUSEL_DECK_LIMITS.cover.subtitle,
+          issues,
+          { optional: true }
+        );
+        break;
+      case "statement":
+        validateText(
+          slide.statement,
+          `${path}.statement`,
+          CAROUSEL_DECK_LIMITS.statement.statement,
+          issues
+        );
+        validateText(
+          slide.accent,
+          `${path}.accent`,
+          CAROUSEL_DECK_LIMITS.statement.accent,
+          issues,
+          { optional: true }
+        );
+        validateText(
+          slide.footnote,
+          `${path}.footnote`,
+          CAROUSEL_DECK_LIMITS.statement.footnote,
+          issues,
+          { optional: true }
+        );
+        break;
+      case "list":
+        validateText(
+          slide.title,
+          `${path}.title`,
+          CAROUSEL_DECK_LIMITS.list.title,
+          issues
+        );
+        validateText(
+          slide.accent,
+          `${path}.accent`,
+          CAROUSEL_DECK_LIMITS.list.accent,
+          issues,
+          { optional: true }
+        );
+        if (!Array.isArray(slide.items) || slide.items.length === 0 || slide.items.some((item) => !isNonEmptyString(item))) {
+          issues.push(`${path}.items must contain non-empty strings`);
+        } else {
+          if (slide.items.length > CAROUSEL_DECK_LIMITS.list.items) {
+            issues.push(
+              `${path}.items must contain at most ${CAROUSEL_DECK_LIMITS.list.items} items`
+            );
           }
-        ]
-      };
+          slide.items.forEach(
+            (item, itemIndex) => validateText(
+              item,
+              `${path}.items[${itemIndex}]`,
+              CAROUSEL_DECK_LIMITS.list.item,
+              issues
+            )
+          );
+        }
+        break;
+      case "takeaway":
+        validateText(
+          slide.title,
+          `${path}.title`,
+          CAROUSEL_DECK_LIMITS.takeaway.title,
+          issues
+        );
+        validateText(
+          slide.accent,
+          `${path}.accent`,
+          CAROUSEL_DECK_LIMITS.takeaway.accent,
+          issues,
+          { optional: true }
+        );
+        validateText(
+          slide.cta,
+          `${path}.cta`,
+          CAROUSEL_DECK_LIMITS.takeaway.cta,
+          issues,
+          { optional: true }
+        );
+        break;
+      default:
+        issues.push(`${path}.kind is invalid`);
     }
-  );
+    validateOptionalImage(slide.image, `${path}.image`, issues);
+    validateOptionalVisualRequest(
+      slide.visualRequest,
+      `${path}.visualRequest`,
+      issues
+    );
+    if (slide.visualRequest && typeof slide.visualRequest === "object" && !Array.isArray(slide.visualRequest)) {
+      const id2 = slide.visualRequest.id;
+      if (isNonEmptyString(id2)) {
+        if (visualRequestIds.has(id2)) {
+          issues.push(
+            `${path}.visualRequest.id must be unique within the deck`
+          );
+        }
+        visualRequestIds.add(id2);
+      }
+    }
+  });
+  return issues.length === 0 ? { ok: true, slideCount: deck.slides.length } : { ok: false, issues };
 }
 
-// src/public-templates.ts
-import { z as z2 } from "zod";
-var TEMPLATE_REPOSITORY = "https://github.com/instavar/remotion-templates";
-var TEMPLATE_ENDPOINT = "https://instavar.com/api/mcp/templates";
-var VOICE_STUDIO_URL = "https://instavar.com/voice";
-var templateIds = [
-  "qa-ad",
-  "proof-walkthrough",
-  "announcement-brief",
-  "social-remix",
-  "finance-brief"
-];
-var templateIdSchema = z2.enum(templateIds);
-var aspectSchema = z2.enum(["9:16", "4:5", "1:1"]);
-var templates = [
-  {
-    id: "qa-ad",
-    name: "Question and answer ad",
-    description: "A short video with a hook, source-video window, explanation points, and call to action.",
-    aspects: ["9:16", "4:5", "1:1"]
-  },
-  {
-    id: "proof-walkthrough",
-    name: "Proof walkthrough",
-    description: "A paced explanation for equations, worked reasoning, and a final takeaway.",
-    aspects: ["9:16", "4:5", "1:1"]
-  },
-  {
-    id: "announcement-brief",
-    name: "Announcement brief",
-    description: "A concise announcement with a headline, supporting points, optional media, and next action.",
-    aspects: ["9:16", "4:5", "1:1"]
-  },
-  {
-    id: "social-remix",
-    name: "Social remix",
-    description: "A caption-forward treatment that frames an existing clip with a hook, context, and call to action.",
-    aspects: ["9:16", "4:5", "1:1"]
-  },
-  {
-    id: "finance-brief",
-    name: "Data and finance brief",
-    description: "An editorial brief for comparisons, numeric highlights, evidence, caveats, and a recommendation.",
-    aspects: ["9:16", "4:5", "1:1"]
-  }
-];
-var videoSpecSchema = {
+// src/videospec-json-schema.ts
+var VIDEO_SPEC_JSON_SCHEMA = {
   $schema: "https://json-schema.org/draft/2020-12/schema",
   $id: "https://instavar.com/schemas/video-spec-1.0.json",
   title: "Instavar VideoSpec",
@@ -159,52 +2023,94 @@ var videoSpecSchema = {
   properties: {
     schemaVersion: { const: "1.0" },
     id: { type: "string", pattern: "^[a-z0-9][a-z0-9-]{2,80}$" },
-    templateFamily: { enum: templateIds },
+    templateFamily: {
+      enum: [
+        "qa-ad",
+        "proof-walkthrough",
+        "announcement-brief",
+        "social-remix",
+        "finance-brief"
+      ]
+    },
     meta: {
       type: "object",
+      additionalProperties: false,
       required: ["title"],
       properties: {
         title: { type: "string", minLength: 1 },
         description: { type: "string" },
-        tags: { type: "array", items: { type: "string" } }
+        tags: { type: "array", items: { type: "string" }, default: [] }
       }
     },
     target: {
       type: "object",
-      required: ["aspect", "fps", "durationMode"],
+      additionalProperties: false,
+      required: ["aspect"],
       properties: {
         aspect: { enum: ["9:16", "4:5", "1:1"] },
-        fps: { type: "integer", minimum: 1 },
-        durationMode: { enum: ["auto", "fixed"] },
+        fps: { type: "integer", minimum: 1, default: 30 },
+        durationMode: { enum: ["auto", "fixed"], default: "auto" },
         fixedDurationSec: { type: "number", exclusiveMinimum: 0 }
       }
     },
+    style: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        theme: {
+          enum: ["default", "editorial-light", "editorial-dark", "clinical"],
+          default: "default"
+        },
+        variant: { type: "string", default: "default" },
+        safeAreaProfile: {
+          enum: ["baseline", "metaSafe"],
+          default: "baseline"
+        },
+        showSceneLabels: { type: "boolean", default: false }
+      }
+    },
     audio: {
       type: "object",
+      additionalProperties: false,
       properties: {
-        mode: { enum: ["auto", "narration", "music", "silent"] },
+        mode: {
+          enum: ["auto", "narration", "music", "silent"],
+          default: "auto"
+        },
         narrationText: { type: "string" },
         narrationSrc: { type: "string" },
-        narrationVolume: { type: "number", minimum: 0, maximum: 1 },
+        narrationVolume: {
+          type: "number",
+          minimum: 0,
+          maximum: 1,
+          default: 1
+        },
         musicSrc: { type: "string" },
-        musicVolume: { type: "number", minimum: 0, maximum: 1 },
-        ducking: { type: "boolean" },
+        musicVolume: {
+          type: "number",
+          minimum: 0,
+          maximum: 1,
+          default: 0.16
+        },
+        ducking: { type: "boolean", default: true },
         narrationTiming: {
           type: "object",
+          additionalProperties: false,
           required: ["schemaVersion", "source", "durationMs", "segments"],
           properties: {
             schemaVersion: { const: "1.0" },
             source: { const: "segmented-synthesis" },
-            durationMs: { type: "integer", minimum: 1 },
+            durationMs: { type: "integer", minimum: 1, maximum: 12e5 },
             segments: {
               type: "array",
               minItems: 1,
               maxItems: 24,
               items: {
                 type: "object",
+                additionalProperties: false,
                 required: ["sceneId", "startMs", "endMs", "durationMs"],
                 properties: {
-                  sceneId: { type: "string", minLength: 1 },
+                  sceneId: { type: "string", minLength: 1, maxLength: 80 },
                   startMs: { type: "integer", minimum: 0 },
                   endMs: { type: "integer", minimum: 1 },
                   durationMs: { type: "integer", minimum: 1 }
@@ -215,11 +2121,20 @@ var videoSpecSchema = {
         }
       }
     },
+    assets: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        logoSrc: { type: "string" },
+        posterSrc: { type: "string" }
+      }
+    },
     scenes: {
       type: "array",
       minItems: 1,
       items: {
         type: "object",
+        additionalProperties: false,
         required: ["id", "kind", "content"],
         properties: {
           id: { type: "string", minLength: 1 },
@@ -236,27 +2151,136 @@ var videoSpecSchema = {
             ]
           },
           content: { type: "object" },
-          timing: { type: "object" }
+          timing: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+              durationMs: { type: "integer", exclusiveMinimum: 0 }
+            }
+          }
         }
       }
-    },
-    style: {
-      type: "object",
-      properties: {
-        theme: {
-          enum: ["default", "editorial-light", "editorial-dark", "clinical"]
-        },
-        variant: { type: "string" },
-        safeAreaProfile: { enum: ["baseline", "metaSafe"] },
-        showSceneLabels: { type: "boolean", default: false }
-      }
     }
   }
 };
-var annotations = {
-  readOnlyHint: true,
-  openWorldHint: false,
-  destructiveHint: false
+
+// src/public-catalogue.ts
+var TEMPLATE_REPOSITORY = "https://github.com/instavar/remotion-templates";
+var VOICE_STUDIO_URL = "https://instavar.com/voice";
+var PUBLIC_VIDEO_TEMPLATES = [
+  {
+    id: "qa-ad",
+    name: "Question and answer ad",
+    description: "Start with a question, then answer it with a clip and clear points.",
+    aspects: ["9:16", "4:5", "1:1"],
+    requiredSceneKinds: ["hero", "video-window", "cta"],
+    optionalSceneKinds: ["points"],
+    exampleId: "qa-ad-starter"
+  },
+  {
+    id: "proof-walkthrough",
+    name: "Proof walkthrough",
+    description: "Explain a calculation or claim step by step, then end with the takeaway.",
+    aspects: ["9:16", "4:5", "1:1"],
+    requiredSceneKinds: ["hero", "equation"],
+    optionalSceneKinds: ["points", "cta"],
+    exampleId: "proof-walkthrough-starter"
+  },
+  {
+    id: "announcement-brief",
+    name: "Announcement brief",
+    description: "Announce something new with a headline, proof, and next step.",
+    aspects: ["9:16", "4:5", "1:1"],
+    requiredSceneKinds: ["hero", "points"],
+    optionalSceneKinds: ["statement", "mechanism", "video-window", "cta"],
+    exampleId: "announcement-brief-starter"
+  },
+  {
+    id: "social-remix",
+    name: "Social remix",
+    description: "Turn an existing clip into a caption-led social post.",
+    aspects: ["9:16", "4:5", "1:1"],
+    requiredSceneKinds: ["hero", "video-window", "cta"],
+    optionalSceneKinds: ["points"],
+    exampleId: "social-remix-starter"
+  },
+  {
+    id: "finance-brief",
+    name: "Data and finance brief",
+    description: "Compare key numbers, show the evidence, and give a recommendation.",
+    aspects: ["9:16", "4:5", "1:1"],
+    requiredSceneKinds: ["hero", "points"],
+    optionalSceneKinds: ["equation", "cta"],
+    exampleId: "finance-brief-starter"
+  }
+];
+function findPublicTemplate(id2) {
+  return PUBLIC_VIDEO_TEMPLATES.find((template) => template.id === id2);
+}
+var aspectSchema = z5.enum(["9:16", "4:5", "1:1"]);
+var storyboardBriefSchema = z5.string().min(8).max(600);
+var templateIdSchema = z5.enum([
+  "qa-ad",
+  "proof-walkthrough",
+  "announcement-brief",
+  "social-remix",
+  "finance-brief"
+]);
+var acceptedDesignSchema = z5.object({
+  style: z5.string().min(1).max(600),
+  durationSeconds: z5.number().positive().max(300),
+  audio: z5.enum(["silent", "narration", "music"]),
+  illustration: z5.string().min(1).max(600),
+  exclusions: z5.array(z5.string().min(1).max(200)).max(20),
+  preview: z5.literal("dark-cafe").optional()
+});
+var carouselTemplateIdSchema = z5.enum([
+  "listicle",
+  "manifesto",
+  "before-after",
+  "value-first-reveal"
+]);
+var PUBLIC_CAROUSEL_DECK_JSON_SCHEMA = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "Instavar CarouselDeck",
+  type: "object",
+  required: ["slides"],
+  properties: {
+    aspect: { enum: ["4:5", "1:1", "9:16"] },
+    visualStyle: { enum: ["editorial", "native-photo"] },
+    handle: { type: "string", maxLength: 40 },
+    showPageNumber: { type: "boolean" },
+    slides: {
+      type: "array",
+      minItems: 1,
+      maxItems: 12,
+      items: {
+        type: "object",
+        required: ["kind"],
+        properties: {
+          kind: { enum: ["cover", "statement", "list", "takeaway"] },
+          title: { type: "string" },
+          statement: { type: "string" },
+          subtitle: { type: "string" },
+          accent: { type: "string" },
+          footnote: { type: "string" },
+          cta: { type: "string" },
+          items: { type: "array", items: { type: "string" }, maxItems: 5 },
+          image: {
+            type: "object",
+            required: ["src", "alt", "provenance"],
+            properties: {
+              src: { type: "string" },
+              alt: { type: "string" },
+              provenance: {
+                enum: ["user-owned", "licensed-stock", "ai-generated"]
+              }
+            }
+          }
+        }
+      }
+    }
+  }
 };
 function result(value, summary) {
   return {
@@ -268,14 +2292,18 @@ function slugify(value) {
   const slug = value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 72);
   return slug.length >= 3 ? slug : "new-video";
 }
-function scaffoldVideoSpec(args) {
+function withFrameworks(template, paired) {
+  return paired ? { ...template, frameworks: ["remotion", "hyperframes"] } : template;
+}
+function scaffoldVideoSpec(args, options = {}) {
+  const announcement = args.templateId === "announcement-brief";
   const scenes = [
     {
       id: "hero",
       kind: "hero",
       content: {
         title: args.title,
-        subtitle: "Replace with a concise promise"
+        ...announcement && args.body ? {} : { subtitle: args.body ?? "Replace with a concise promise" }
       },
       timing: { durationMs: 4e3 }
     }
@@ -291,7 +2319,14 @@ function scaffoldVideoSpec(args) {
       timing: { durationMs: 7e3 }
     });
   }
-  if (args.templateId === "announcement-brief") {
+  if (announcement && args.body) {
+    scenes.push({
+      id: "key-points",
+      kind: "points",
+      content: { title: args.body, points: [] },
+      timing: { durationMs: 7e3 }
+    });
+  } else if (announcement) {
     scenes.push(
       {
         id: "context",
@@ -322,14 +2357,21 @@ function scaffoldVideoSpec(args) {
         timing: { durationMs: 7e3 }
       }
     );
-  } else {
+  } else if (args.templateId === "proof-walkthrough") {
     scenes.push({
-      id: args.templateId === "proof-walkthrough" ? "working" : "key-points",
-      kind: args.templateId === "proof-walkthrough" ? "equation" : "points",
-      content: args.templateId === "proof-walkthrough" ? {
+      id: "working",
+      kind: "equation",
+      content: {
         title: "Work through the idea",
         latexBlocks: ["x = \\frac{-b \\pm \\sqrt{b^2 - 4ac}}{2a}"]
-      } : {
+      },
+      timing: { durationMs: 8e3 }
+    });
+  } else {
+    scenes.push({
+      id: "key-points",
+      kind: "points",
+      content: args.body ? { title: args.body, points: [args.body] } : {
         title: "Key points",
         points: [
           "Replace with evidence",
@@ -340,218 +2382,658 @@ function scaffoldVideoSpec(args) {
       timing: { durationMs: 8e3 }
     });
   }
-  scenes.push({
-    id: "cta",
-    kind: "cta",
-    content: { line1: "Replace with the next action" },
-    timing: {
-      durationMs: args.templateId === "announcement-brief" ? 6e3 : 5e3
-    }
-  });
-  return {
-    schemaVersion: "1.0",
-    id: slugify(args.title),
-    templateFamily: args.templateId,
-    meta: { title: args.title, tags: [] },
-    target: { aspect: args.aspect, fps: 30, durationMode: "auto" },
-    style: {
-      theme: args.templateId === "announcement-brief" ? "editorial-light" : "default",
-      variant: "default",
-      safeAreaProfile: "metaSafe",
-      showSceneLabels: false
+  scenes.push({
+    id: "cta",
+    kind: "cta",
+    content: { line1: args.cta ?? "Replace with the next action" },
+    timing: { durationMs: announcement ? 6e3 : 5e3 }
+  });
+  return {
+    schemaVersion: "1.0",
+    id: slugify(args.title),
+    templateFamily: args.templateId,
+    meta: { title: args.title, tags: [] },
+    target: { aspect: args.aspect, fps: 30, durationMode: "auto" },
+    style: {
+      theme: announcement ? "editorial-light" : "default",
+      variant: "default",
+      // Neither renderer applies metaSafe; the paired contract rejects it.
+      safeAreaProfile: options.pairedTemplates ? "baseline" : "metaSafe",
+      showSceneLabels: false
+    },
+    audio: {
+      mode: "silent",
+      narrationText: "",
+      narrationVolume: 1,
+      musicVolume: 0.16,
+      ducking: true
+    },
+    assets: {},
+    scenes
+  };
+}
+var HEALTH_OR_SAFETY_PATTERN = /\b(cpr|first aid|medical|medicine|medication|symptom|emergency|safety)\b/i;
+function titleFromBrief(brief) {
+  const concise = brief.trim().replace(
+    /^(?:please\s+)?(?:make|create|show|teach|explain)\s+(?:me\s+)?(?:a\s+)?(?:video\s+)?(?:about\s+)?/i,
+    ""
+  ).replace(/^tell me\s+/i, "").replace(/\s+/g, " ").replace(/[.?!]+$/, "");
+  if (!concise) return "A clear video";
+  return concise.charAt(0).toUpperCase() + concise.slice(1);
+}
+function recommendStoryboardStructure(brief) {
+  const mediaIntent = brief.replace(
+    /\b(?:no|without|avoid)\s+(?:(?:any|source|stock|automatic|supplied)\s+)?(?:clips?|footage|b-?roll)\b/gi,
+    ""
+  );
+  if (/\b(clip|footage|reel|remix|repurpose)\b/i.test(mediaIntent)) {
+    return { templateId: "social-remix", kind: "source-remix" };
+  }
+  if (/\b(data|numbers?|metric|finance|financial|compare|comparison)\b/i.test(
+    brief
+  )) {
+    return { templateId: "finance-brief", kind: "data-brief" };
+  }
+  if (/\b(announce(?:ment)?|launch|new|opening|release)\b/i.test(brief)) {
+    return { templateId: "announcement-brief", kind: "announcement" };
+  }
+  if (/\b(how\s+to|how\s+do\s+(?:i|you|we)|steps?|step-by-step|recipe|cook|slice|chop|dice|peel|prepare|assemble|install|set\s+up|fold|tie)\b/i.test(
+    brief
+  )) {
+    return { templateId: "qa-ad", kind: "procedure" };
+  }
+  return { templateId: "qa-ad", kind: "question-answer" };
+}
+function storyboardFrames(args) {
+  if (args.kind === "procedure" && args.templateId === "qa-ad") {
+    return [
+      [
+        "Prepare the setup",
+        "Show the tools, ingredients, and safe starting position."
+      ],
+      [
+        "Show the key action",
+        "Use a close, readable view of the movement the viewer must copy."
+      ],
+      [
+        "Show the result",
+        "End on the finished outcome and the one safety point to remember."
+      ]
+    ].map(([title2, purpose], index) => ({
+      id: `beat-${index + 1}`,
+      title: title2,
+      purpose,
+      visualBrief: `${title2} for ${args.title}. Editorial composition, one clear subject, generous negative space, no words, numbers, logos, or interface elements.`,
+      alt: `${title2}: a proposed visual beat for ${args.title}.`,
+      asset: { kind: "image", state: "proposed" }
+    }));
+  }
+  const frameCopy = {
+    "qa-ad": [
+      [
+        "Open with the question",
+        "Make the viewer recognise the problem or curiosity."
+      ],
+      ["Show the answer", "Show the one idea that resolves it."],
+      ["Leave one next step", "End with the takeaway the viewer can use."]
+    ],
+    "proof-walkthrough": [
+      [
+        "Set the scene",
+        "Establish the ingredients, tools, or starting condition."
+      ],
+      [
+        "Show the essential move",
+        "Show the central action in a close, readable moment."
+      ],
+      [
+        "Land the outcome",
+        "Show the finished result and the one idea to remember."
+      ]
+    ],
+    "announcement-brief": [
+      [
+        "Lead with the news",
+        "Make the new thing unmistakable at first glance."
+      ],
+      ["Show the proof", "Show the detail that makes the announcement matter."],
+      ["Give the next step", "End with a simple, concrete invitation."]
+    ],
+    "social-remix": [
+      [
+        "Find the strongest moment",
+        "Open on the most recognisable moment in the supplied clip."
+      ],
+      [
+        "Add the context",
+        "Use a second visual beat to make the point clear without stopping the clip."
+      ],
+      [
+        "End before it drags",
+        "Leave one memorable line or image as the viewer scrolls on."
+      ]
+    ],
+    "finance-brief": [
+      ["Name the decision", "Establish the question behind the numbers."],
+      [
+        "Make the evidence visible",
+        "Show the comparison or trend as a simple visual fact."
+      ],
+      [
+        "State the recommendation",
+        "End with the decision the evidence supports."
+      ]
+    ]
+  };
+  return frameCopy[args.templateId].map(([title2, purpose], index) => ({
+    id: `beat-${index + 1}`,
+    title: title2,
+    purpose,
+    visualBrief: `${title2} for ${args.title}. Editorial composition, one clear subject, generous negative space, no words, numbers, logos, or interface elements.`,
+    alt: `${title2}: a proposed visual beat for ${args.title}.`,
+    asset: { kind: "image", state: "proposed" }
+  }));
+}
+function proposeVideoStoryboard(args, acceptedPreview) {
+  const title2 = args.title ?? titleFromBrief(args.brief);
+  const recommendation = recommendStoryboardStructure(args.brief);
+  const templateId = args.templateId ?? recommendation.templateId;
+  const kind = recommendation.kind;
+  const template = findPublicTemplate(templateId);
+  const reviewRequired = HEALTH_OR_SAFETY_PATTERN.test(args.brief);
+  const isProcedure = kind === "procedure" && templateId === "qa-ad";
+  return {
+    version: "1.0",
+    brief: args.brief.trim(),
+    title: title2,
+    ...args.body ? { body: args.body } : {},
+    ...args.cta ? { cta: args.cta } : {},
+    aspect: args.aspect,
+    ...args.acceptedDesign ? {
+      acceptedDesign: args.acceptedDesign,
+      acceptedPreview: acceptedPreview?.({ ...args, title: title2 })
+    } : {},
+    template: {
+      id: template.id,
+      name: isProcedure ? "Visual how-to" : template.name,
+      reason: isProcedure ? "Show a physical process as clear visual steps, then the usable outcome." : template.description,
+      variant: isProcedure ? "procedural" : "default"
+    },
+    visualDirection: {
+      communicationJob: "Make the subject and sequence clear at a glance.",
+      style: args.acceptedDesign?.style ?? "Editorial, minimal, and scene-led rather than text-led.",
+      factualReviewRequired: reviewRequired
+    },
+    frames: storyboardFrames({ title: title2, templateId, kind }),
+    imageGeneration: {
+      state: "not-generated",
+      notice: "These are visual briefs, not generated images. GPT-Image-2 drafts require an explicit, signed-in Studio generation step with cost and provenance controls."
+    }
+  };
+}
+function runProposeVideoStoryboardTool(args, acceptedPreview) {
+  const storyboard = proposeVideoStoryboard(args, acceptedPreview);
+  return result(
+    { storyboard },
+    "A three-beat visual storyboard is ready. It is a proposal only: no images were generated, no project was saved, and no render was started."
+  );
+}
+function runListCarouselTemplatesTool() {
+  const templates = CAROUSEL_ARCHETYPES.map(({ id: id2, label: label2, blurb }) => ({
+    id: id2,
+    name: label2,
+    description: blurb,
+    defaultAspect: "4:5",
+    visualStyle: "editorial"
+  }));
+  return result(
+    { templates, creativeGuides: CREATIVE_GUIDE_INDEX },
+    templates.map((template) => `${template.id}: ${template.description}`).join("\n")
+  );
+}
+function runGetCarouselSchemaTool() {
+  return result(
+    { schemaVersion: "1.0", jsonSchema: PUBLIC_CAROUSEL_DECK_JSON_SCHEMA },
+    "CarouselDeck schema version 1.0. Text, branding, numbering, and layout remain deterministic."
+  );
+}
+function runScaffoldCarouselDeckTool(args) {
+  const archetype = getArchetype(args.templateId);
+  if (!archetype) {
+    return {
+      isError: true,
+      content: [{ type: "text", text: "Unknown carousel template." }]
+    };
+  }
+  const deck = archetype.build({
+    hook: args.hook,
+    subtitle: args.subtitle,
+    points: args.points,
+    payoff: args.payoff,
+    cta: args.cta,
+    handle: args.handle
+  });
+  deck.aspect = args.aspect;
+  const validation = validateCarouselDeck(deck);
+  if (!validation.ok) {
+    return {
+      isError: true,
+      structuredContent: { issues: validation.issues },
+      content: [
+        {
+          type: "text",
+          text: `Carousel deck is invalid: ${validation.issues.join("; ")}`
+        }
+      ]
+    };
+  }
+  return result(
+    {
+      schemaVersion: "1.0",
+      templateId: args.templateId,
+      deck,
+      validation
+    },
+    `A ${validation.slideCount}-slide ${args.templateId} deck is ready for local rendering. Review every claim and add only rights-cleared images.`
+  );
+}
+function runListTemplatesTool(args, paired) {
+  const templates = args.aspect ? PUBLIC_VIDEO_TEMPLATES.filter(
+    (template) => template.aspects.includes(args.aspect)
+  ) : PUBLIC_VIDEO_TEMPLATES;
+  return result(
+    {
+      templates: templates.map(
+        (template) => withFrameworks({ ...template }, paired)
+      )
+    },
+    templates.map((template) => `${template.id}: ${template.description}`).join("\n")
+  );
+}
+function runGetTemplateTool(args, paired) {
+  const template = findPublicTemplate(args.templateId);
+  if (!template) {
+    return {
+      isError: true,
+      content: [{ type: "text", text: "Unknown template." }]
+    };
+  }
+  return result(
+    { template: withFrameworks({ ...template }, paired) },
+    `${template.name}
+${template.description}`
+  );
+}
+function runGetVideoSchemaTool() {
+  return result(
+    { schemaVersion: "1.0", jsonSchema: VIDEO_SPEC_JSON_SCHEMA },
+    "VideoSpec schema version 1.0. Use only published template and scene identifiers."
+  );
+}
+function runScaffoldVideoSpecTool(args, paired, acceptedPreview) {
+  const spec = scaffoldVideoSpec(args, { pairedTemplates: paired });
+  return result(
+    {
+      spec,
+      filename: `${String(spec.id)}.video.json`,
+      planningContext: {
+        brief: args.brief,
+        title: args.title,
+        body: args.body,
+        cta: args.cta,
+        aspect: args.aspect,
+        templateId: args.templateId,
+        acceptedDesign: args.acceptedDesign,
+        acceptedPreview: acceptedPreview?.(args)
+      }
     },
-    audio: {
-      mode: "silent",
-      narrationText: "",
-      narrationVolume: 1,
-      musicVolume: 0.16,
-      ducking: true
+    `Starter VideoSpec created for ${args.templateId}. Replace placeholder copy and media before rendering.`
+  );
+}
+function runGetExampleTool(args, paired) {
+  const spec = scaffoldVideoSpec(
+    {
+      templateId: args.templateId,
+      title: `Example ${args.templateId}`,
+      aspect: "9:16"
     },
-    assets: {},
-    scenes
-  };
+    { pairedTemplates: paired }
+  );
+  return result(
+    { templateId: args.templateId, spec },
+    `Example VideoSpec for ${args.templateId}.`
+  );
 }
-function registerPublicTemplateTools(server) {
-  registerCreativeGuides(server);
+function runGetRenderInstructionsTool(args) {
+  const commands = [
+    `git clone ${TEMPLATE_REPOSITORY}.git`,
+    "cd remotion-templates",
+    "npm install",
+    `# Generate narration at ${VOICE_STUDIO_URL}, with one paragraph per scene`,
+    "npm run video:timing -- path/to/video.video.json --audio public/generated/narration.wav --manifest path/to/narration.timing.json",
+    "npm run video:validate -- path/to/video.video.json",
+    "npm run video:preview -- path/to/video.video.json",
+    "npm run video:render -- path/to/video.video.json",
+    "npm run video:qa -- path/to/video.video.json path/to/video.mp4"
+  ];
+  const guidance = args.client === "codex" ? "Ask Codex to clone the repository, read AGENTS.md and the make-video skill, author a VideoSpec, validate it, preview representative frames, and render only after validation passes." : args.client === "claude-code" ? "Ask Claude Code to clone the repository, read CLAUDE.md and the make-video skill, author a VideoSpec, validate it, preview representative frames, and render only after validation passes." : "Follow the repository README and run the commands in order.";
+  return result(
+    {
+      repository: TEMPLATE_REPOSITORY,
+      client: args.client,
+      guidance,
+      commands
+    },
+    `${guidance}
+
+${commands.join("\n")}`
+  );
+}
+function runDiagnoseRenderErrorTool(args) {
+  const text3 = args.errorText.toLowerCase();
+  let diagnosis = "Run validation first, confirm Node 22 or newer, and retry with the smallest included example.";
+  let code = "unknown-render-error";
+  if (text3.includes("enoent") || text3.includes("not found")) {
+    code = "missing-file";
+    diagnosis = "A referenced spec, media, font, or asset path is missing. Resolve paths relative to the repository and confirm exact filename case.";
+  } else if (text3.includes("ffmpeg") || text3.includes("codec")) {
+    code = "media-codec";
+    diagnosis = "The source media or local ffmpeg setup is incompatible. Probe the file, then transcode to H.264 video with AAC audio.";
+  } else if (text3.includes("schema") || text3.includes("invalid") || text3.includes("zod")) {
+    code = "invalid-video-spec";
+    diagnosis = "The VideoSpec does not match schema version 1.0. Fetch get_video_schema and correct the reported field before rendering.";
+  } else if (text3.includes("chrome") || text3.includes("browser")) {
+    code = "browser-runtime";
+    diagnosis = "Remotion could not start its browser runtime. Reinstall dependencies and follow the platform-specific browser setup in the repository README.";
+  }
+  return result(
+    {
+      code,
+      diagnosis,
+      nextStep: "Use get_render_instructions for the canonical local workflow."
+    },
+    `${code}: ${diagnosis}`
+  );
+}
+var READ_ONLY_ANNOTATIONS = {
+  readOnlyHint: true,
+  openWorldHint: false,
+  destructiveHint: false
+};
+function registerSharedTemplateTools(server, options) {
+  const paired = options.pairedTemplates;
+  const meta = (name) => options.toolMeta ? { _meta: options.toolMeta(name) } : {};
+  const catalogue = paired ? "video" : "Remotion";
   server.registerTool(
-    "get_capabilities",
+    "list_carousel_templates",
     {
-      title: "Get video capabilities",
-      description: "Call first. Reports free local features and optional account features.",
+      title: "List carousel templates",
+      description: "List the account-free editorial carousel story structures.",
       inputSchema: {},
-      annotations
+      annotations: {
+        title: "List carousel templates",
+        ...READ_ONLY_ANNOTATIONS
+      },
+      ...meta("list_carousel_templates")
     },
-    async () => result(
-      {
-        authentication: "optional",
-        apiKeyConfigured: Boolean(process.env.INSTAVAR_API_KEY?.trim()),
-        repository: TEMPLATE_REPOSITORY,
-        endpoint: TEMPLATE_ENDPOINT,
-        creativeGuides: CREATIVE_GUIDE_INDEX,
-        localFeatures: [
-          "template discovery",
-          "VideoSpec schema and examples",
-          "deterministic scaffolding",
-          "local render instructions",
-          "render error diagnosis",
-          "keyless on-device narration with scene timing",
-          "every-scene preview frames",
-          "post-render audible-audio verification"
-        ],
-        narration: {
-          url: VOICE_STUDIO_URL,
-          cost: "free",
-          apiKeyRequired: false,
-          guidance: "Write one paragraph per scene. Download the WAV and timing manifest, then apply both before rendering."
-        },
-        accountFeatures: [
-          "managed rendering and storage",
-          "workflow review and approval",
-          "social publishing and metrics"
-        ]
+    async () => runListCarouselTemplatesTool()
+  );
+  server.registerTool(
+    "get_carousel_schema",
+    {
+      title: "Get CarouselDeck schema",
+      description: "Return the JSON Schema for deterministic Instavar carousel decks.",
+      inputSchema: {},
+      annotations: { title: "Get carousel schema", ...READ_ONLY_ANNOTATIONS },
+      ...meta("get_carousel_schema")
+    },
+    async () => runGetCarouselSchemaTool()
+  );
+  server.registerTool(
+    "scaffold_carousel_deck",
+    {
+      title: "Scaffold carousel deck",
+      description: "Build a deterministic editorial carousel deck from accepted copy. This does not render, save, or publish it.",
+      inputSchema: {
+        templateId: carouselTemplateIdSchema.describe(
+          "Story structure from list_carousel_templates."
+        ),
+        hook: z5.string().min(1).max(100).describe("Cover line on the first slide."),
+        subtitle: z5.string().min(1).max(160).optional().describe("Optional cover subtitle under the hook."),
+        points: z5.array(z5.string().min(1).max(120)).min(1).max(5).describe(
+          "Body beats in order. listicle lists them on one slide, manifesto gives each its own slide, before-after uses the first as the problem and the last as the contrast, and value-first-reveal uses the first three."
+        ),
+        payoff: z5.string().min(1).max(120).describe("Closing takeaway on the final slide."),
+        cta: z5.string().min(1).max(140).optional().describe("Optional call to action on the final slide."),
+        handle: z5.string().min(1).max(40).optional().describe("Optional brand handle shown in the slide footer."),
+        aspect: z5.enum(["4:5", "1:1", "9:16"]).default("4:5").describe("Slide aspect ratio. Defaults to 4:5.")
       },
-      process.env.INSTAVAR_API_KEY?.trim() ? "Free local tools and authenticated Instavar Studio tools are available." : "Free local tools are available. Add INSTAVAR_API_KEY to unlock hosted Studio tools."
-    )
+      annotations: {
+        title: "Scaffold carousel deck",
+        ...READ_ONLY_ANNOTATIONS
+      },
+      ...meta("scaffold_carousel_deck")
+    },
+    async (args) => runScaffoldCarouselDeckTool(args)
   );
   server.registerTool(
     "list_templates",
     {
-      title: "List Remotion templates",
-      description: "List public templates, optionally filtered by aspect ratio.",
-      inputSchema: { aspect: aspectSchema.optional() },
-      annotations
+      title: `List ${catalogue} templates`,
+      description: paired ? "List the published video template families, each available in Remotion and HyperFrames, and optionally filter by output aspect ratio." : "List the published Remotion template families and optionally filter by output aspect ratio.",
+      inputSchema: {
+        aspect: aspectSchema.optional().describe(
+          "Only list templates that support this aspect ratio. Omit to list them all."
+        )
+      },
+      annotations: { title: "List templates", ...READ_ONLY_ANNOTATIONS },
+      ...meta("list_templates")
     },
-    async ({ aspect }) => {
-      const filtered = aspect ? templates.filter((template) => template.aspects.includes(aspect)) : templates;
-      return result(
-        { templates: filtered },
-        filtered.map((template) => `${template.id}: ${template.description}`).join("\n")
-      );
-    }
+    async (args) => runListTemplatesTool(args, paired)
   );
   server.registerTool(
     "get_template",
     {
-      title: "Get Remotion template",
-      description: "Get one public template contract.",
-      inputSchema: { templateId: templateIdSchema },
-      annotations
+      title: `Get ${catalogue} template`,
+      description: "Get one template's purpose, aspect ratios, scene kinds, and example identifier.",
+      inputSchema: {
+        templateId: templateIdSchema.describe(
+          "Template family from list_templates."
+        )
+      },
+      annotations: { title: "Get template", ...READ_ONLY_ANNOTATIONS },
+      ...meta("get_template")
     },
-    async ({ templateId }) => {
-      const template = templates.find((item) => item.id === templateId);
-      return result(
-        { template },
-        `${template?.name ?? templateId}
-${template?.description ?? ""}`
-      );
-    }
+    async (args) => runGetTemplateTool(args, paired)
   );
   server.registerTool(
     "get_video_schema",
     {
       title: "Get VideoSpec schema",
-      description: "Return the public VideoSpec JSON Schema.",
+      description: "Return the published JSON Schema for VideoSpec version 1.0.",
       inputSchema: {},
-      annotations
+      annotations: { title: "Get video schema", ...READ_ONLY_ANNOTATIONS },
+      ...meta("get_video_schema")
     },
-    async () => result(
-      { schemaVersion: "1.0", jsonSchema: videoSpecSchema },
-      "VideoSpec schema version 1.0."
-    )
+    async () => runGetVideoSchemaTool()
   );
   server.registerTool(
     "get_example",
     {
       title: "Get VideoSpec example",
-      description: "Return a starter example for one template.",
-      inputSchema: { templateId: templateIdSchema },
-      annotations
+      description: "Return a valid starter example for one template family.",
+      inputSchema: {
+        templateId: templateIdSchema.describe(
+          "Template family whose starter VideoSpec to return."
+        )
+      },
+      annotations: { title: "Get example", ...READ_ONLY_ANNOTATIONS },
+      ...meta("get_example")
     },
-    async ({ templateId }) => result(
-      {
-        templateId,
-        spec: scaffoldVideoSpec({
-          templateId,
-          title: `Example ${templateId}`,
-          aspect: "9:16"
-        })
+    async (args) => runGetExampleTool(args, paired)
+  );
+  server.registerTool(
+    "propose_video_storyboard",
+    {
+      title: "Propose a video storyboard",
+      description: "Turn an ordinary video request into a three-beat visual proposal and recommended template. Pass templateId to preserve an accepted template when changing only the aspect; omit it for a new direction. This tool does not generate images, save a project, render, or publish.",
+      inputSchema: {
+        brief: storyboardBriefSchema.describe(
+          "The user's video request in their own words. It picks the recommended template and, without a title, the working title."
+        ),
+        templateId: templateIdSchema.optional().describe(
+          "Accepted template family to keep, for example when only the aspect changes. Omit for a new direction."
+        ),
+        title: z5.string().min(1).max(160).optional().describe(
+          "Accepted title, if the user supplied one. Omit to derive one from the brief."
+        ),
+        body: z5.string().min(1).max(2e3).optional().describe("Accepted body copy, kept exactly as supplied."),
+        cta: z5.string().min(1).max(500).optional().describe("Accepted call to action, kept exactly as supplied."),
+        acceptedDesign: acceptedDesignSchema.optional().describe(
+          "The design the user accepted: style, duration in seconds, audio, illustration and exclusions. Pass it on to scaffold_video_spec and hosted tools."
+        ),
+        aspect: aspectSchema.default("9:16").describe("Output aspect ratio. Defaults to 9:16.")
       },
-      `Example VideoSpec for ${templateId}.`
-    )
+      annotations: {
+        title: "Propose video storyboard",
+        ...READ_ONLY_ANNOTATIONS
+      },
+      ...meta("propose_video_storyboard")
+    },
+    async (args) => runProposeVideoStoryboardTool(args, options.acceptedPreview)
   );
   server.registerTool(
     "scaffold_video_spec",
     {
       title: "Scaffold VideoSpec",
-      description: "Return a deterministic VideoSpec skeleton without writing files.",
+      description: "Return a deterministic VideoSpec skeleton. This tool does not generate creative copy or write files.",
       inputSchema: {
-        templateId: templateIdSchema,
-        title: z2.string().min(1).max(160),
-        aspect: aspectSchema.default("9:16"),
-        mediaSrc: z2.string().min(1).max(500).optional()
+        templateId: templateIdSchema.describe(
+          "Template family from list_templates."
+        ),
+        title: z5.string().min(1).max(160).describe(
+          "Video title, shown in the opening scene and used for the spec ID."
+        ),
+        brief: z5.string().min(1).max(600).optional().describe(
+          "Original intent and constraints to preserve through planning and handoff. This is not generated video copy."
+        ),
+        aspect: aspectSchema.default("9:16").describe("Output aspect ratio. Defaults to 9:16."),
+        mediaSrc: z5.string().min(1).max(500).optional().describe(
+          "Source video path for the video window in qa-ad and social-remix. Other templates ignore it; without it the spec holds a placeholder path."
+        ),
+        body: z5.string().min(1).max(2e3).optional().describe(
+          "Accepted body copy. It replaces the placeholder copy and appears once."
+        ),
+        cta: z5.string().min(1).max(500).optional().describe("Accepted call to action for the closing scene."),
+        acceptedDesign: acceptedDesignSchema.optional().describe(
+          "The design the user accepted. Returned in planningContext for later steps; it does not change the VideoSpec."
+        )
       },
-      annotations
+      annotations: { title: "Scaffold video spec", ...READ_ONLY_ANNOTATIONS },
+      ...meta("scaffold_video_spec")
     },
-    async (args) => {
-      const spec = scaffoldVideoSpec(args);
-      return result(
-        { spec, filename: `${String(spec.id)}.video.json` },
-        "Starter VideoSpec created. Replace placeholder copy and media."
-      );
-    }
+    async (args) => runScaffoldVideoSpecTool(args, paired, options.acceptedPreview)
   );
   server.registerTool(
     "get_render_instructions",
     {
       title: "Get local render instructions",
-      description: "Return clone, install, validate, preview, and render commands.",
+      description: "Return the clone, install, validate, preview, render, and QA workflow.",
       inputSchema: {
-        client: z2.enum(["codex", "claude-code", "manual"]).default("manual")
+        client: z5.enum(["codex", "claude-code", "manual"]).default("manual").describe(
+          "Who will run the workflow. It changes only the guidance text. Defaults to manual."
+        )
       },
-      annotations
+      annotations: {
+        title: "Get render instructions",
+        ...READ_ONLY_ANNOTATIONS
+      },
+      ...meta("get_render_instructions")
     },
-    async ({ client }) => {
-      const commands = [
-        `git clone ${TEMPLATE_REPOSITORY}.git`,
-        "cd remotion-templates",
-        "npm install",
-        `# Generate one narration paragraph per scene at ${VOICE_STUDIO_URL}`,
-        "npm run video:timing -- path/to/video.video.json --audio public/generated/narration.wav --manifest path/to/narration.timing.json",
-        "npm run video:validate -- path/to/video.video.json",
-        "npm run video:preview -- path/to/video.video.json",
-        "npm run video:render -- path/to/video.video.json",
-        "npm run video:qa -- path/to/video.video.json path/to/video.mp4"
-      ];
-      return result(
-        { repository: TEMPLATE_REPOSITORY, client, commands },
-        commands.join("\n")
-      );
-    }
+    async (args) => runGetRenderInstructionsTool(args)
   );
   server.registerTool(
     "diagnose_render_error",
     {
       title: "Diagnose render error",
-      description: "Classify a local validation or render error.",
-      inputSchema: { errorText: z2.string().min(1).max(1e4) },
+      description: "Classify a local validation or render error and return a safe next step.",
+      inputSchema: {
+        errorText: z5.string().min(1).max(1e4).describe("The validation or render error output to classify.")
+      },
+      annotations: { title: "Diagnose render error", ...READ_ONLY_ANNOTATIONS },
+      ...meta("diagnose_render_error")
+    },
+    async (args) => runDiagnoseRenderErrorTool(args)
+  );
+}
+
+// src/public-templates.ts
+var TEMPLATE_ENDPOINT = "https://instavar.com/api/mcp/templates";
+var annotations = {
+  readOnlyHint: true,
+  openWorldHint: false,
+  destructiveHint: false
+};
+function result2(value, summary) {
+  return {
+    structuredContent: value,
+    content: [{ type: "text", text: summary }]
+  };
+}
+function registerPublicTemplateTools(server, options = {}) {
+  const paired = options.pairedTemplates ?? pairedTemplatesEnabled();
+  registerCreativeGuides(server);
+  registerPairedAnnouncement(server, { pairedCatalogue: paired });
+  if (paired) registerPairedTemplates(server);
+  server.registerTool(
+    "get_capabilities",
+    {
+      title: "Get video capabilities",
+      description: "Call first. Reports free local features and optional account features.",
+      inputSchema: {},
       annotations
     },
-    async ({ errorText }) => {
-      const text = errorText.toLowerCase();
-      const code = text.includes("enoent") || text.includes("not found") ? "missing-file" : text.includes("ffmpeg") || text.includes("codec") ? "media-codec" : text.includes("schema") || text.includes("invalid") || text.includes("zod") ? "invalid-video-spec" : text.includes("chrome") || text.includes("browser") ? "browser-runtime" : "unknown-render-error";
-      return result(
-        {
-          code,
-          nextStep: "Run validation first, confirm Node 22 or newer, and retry with the smallest included example."
+    async () => result2(
+      {
+        authentication: "optional",
+        apiKeyConfigured: Boolean(process.env.INSTAVAR_API_KEY?.trim()),
+        repository: TEMPLATE_REPOSITORY,
+        endpoint: TEMPLATE_ENDPOINT,
+        creativeGuides: CREATIVE_GUIDE_INDEX,
+        pairedAnnouncement: PAIRED_ANNOUNCEMENT_CAPABILITY,
+        ...paired ? { pairedTemplates: PAIRED_TEMPLATE_CAPABILITY } : {},
+        localFeatures: [
+          "template discovery",
+          "three-beat storyboard proposals",
+          "VideoSpec schema and examples",
+          "deterministic scaffolding",
+          "editorial carousel discovery and deterministic deck scaffolding",
+          "local render instructions",
+          "render error diagnosis",
+          "keyless on-device narration with scene timing",
+          "every-scene preview frames",
+          "post-render audible-audio verification"
+        ],
+        narration: {
+          url: VOICE_STUDIO_URL,
+          cost: "free",
+          apiKeyRequired: false,
+          guidance: "Write one paragraph per scene. Download the WAV and timing manifest, then apply both before rendering."
         },
-        `Diagnosis: ${code}.`
-      );
-    }
+        accountFeatures: [
+          "managed rendering and storage",
+          "workflow review and approval",
+          "social publishing and metrics"
+        ]
+      },
+      process.env.INSTAVAR_API_KEY?.trim() ? "Free local tools and authenticated Instavar Studio tools are available." : "Free local tools are available. Add INSTAVAR_API_KEY to unlock hosted Studio tools."
+    )
   );
+  registerSharedTemplateTools(server, { pairedTemplates: paired });
 }
 
 // src/tools.ts
-import { z as z5 } from "zod";
+import { z as z8 } from "zod";
 
 // src/http.ts
 import { randomUUID } from "crypto";
@@ -597,11 +3079,11 @@ function requestFailure(error) {
   return error instanceof Error ? error.message : String(error);
 }
 async function parse(res) {
-  const text = await res.text();
+  const text3 = await res.text();
   try {
-    return JSON.parse(text);
+    return JSON.parse(text3);
   } catch {
-    return text;
+    return text3;
   }
 }
 async function apiGet(path) {
@@ -625,7 +3107,9 @@ async function apiPost(path, payload) {
     method: "POST",
     headers: {
       [API_KEY_HEADER]: getApiKey(),
-      "content-type": "application/json"
+      "content-type": "application/json",
+      // Labels person-consent declarations made through MCP (surface only).
+      "x-instavar-client": "mcp"
     },
     body: JSON.stringify(clean),
     signal: AbortSignal.timeout(API_REQUEST_TIMEOUT_MS)
@@ -647,15 +3131,15 @@ ${open}
 ${json}
 ${close}`;
 }
-function toToolResult(result2) {
+function toToolResult(result3) {
   return {
     content: [
       {
         type: "text",
-        text: fenceForModel(JSON.stringify(result2.body, null, 2))
+        text: fenceForModel(JSON.stringify(result3.body, null, 2))
       }
     ],
-    isError: !result2.ok
+    isError: !result3.ok
   };
 }
 async function runTool(fn) {
@@ -675,7 +3159,7 @@ async function runTool(fn) {
 }
 
 // src/brief-schema.ts
-import { z as z3 } from "zod";
+import { z as z6 } from "zod";
 var PUBLISH_TARGETS = [
   "linkedin",
   "x",
@@ -707,16 +3191,16 @@ var REFERENCE_ROLES = [
   "environment",
   "style"
 ];
-var optionalDirectionText = z3.string().trim().min(1).max(500).optional();
-var visualDirectionSchema = z3.object({
+var optionalDirectionText = z6.string().trim().min(1).max(500).optional();
+var visualDirectionSchema = z6.object({
   communicationJob: optionalDirectionText,
   emotionalTarget: optionalDirectionText,
-  attentionPath: z3.object({
+  attentionPath: z6.object({
     first: optionalDirectionText,
     next: optionalDirectionText,
     proof: optionalDirectionText
   }).optional(),
-  visualLanguage: z3.object({
+  visualLanguage: z6.object({
     space: optionalDirectionText,
     line: optionalDirectionText,
     shape: optionalDirectionText,
@@ -725,24 +3209,24 @@ var visualDirectionSchema = z3.object({
     movement: optionalDirectionText,
     rhythm: optionalDirectionText
   }).optional(),
-  camera: z3.object({
+  camera: z6.object({
     shotSize: optionalDirectionText,
     angle: optionalDirectionText,
     movement: optionalDirectionText,
     lens: optionalDirectionText
   }).optional()
 });
-var generationContractSchema = z3.object({
-  globalInvariants: z3.array(z3.string().trim().min(1).max(300)).max(20).optional(),
-  shotDelta: z3.string().trim().min(1).max(500).optional(),
-  referenceBindings: z3.array(
-    z3.object({
-      assetId: z3.string().trim().min(1).max(200),
-      roles: z3.array(z3.enum(REFERENCE_ROLES)).min(1).max(7)
+var generationContractSchema = z6.object({
+  globalInvariants: z6.array(z6.string().trim().min(1).max(300)).max(20).optional(),
+  shotDelta: z6.string().trim().min(1).max(500).optional(),
+  referenceBindings: z6.array(
+    z6.object({
+      assetId: z6.string().trim().min(1).max(200),
+      roles: z6.array(z6.enum(REFERENCE_ROLES)).min(1).max(7)
     })
   ).max(20).optional(),
-  prohibitedChanges: z3.array(z3.string().trim().min(1).max(300)).max(20).optional(),
-  reviewCriteria: z3.array(z3.string().trim().min(1).max(300)).max(20).optional()
+  prohibitedChanges: z6.array(z6.string().trim().min(1).max(300)).max(20).optional(),
+  reviewCriteria: z6.array(z6.string().trim().min(1).max(300)).max(20).optional()
 });
 var REGION_NAMES = [
   "background",
@@ -759,55 +3243,55 @@ var ASSET_ROLES = [
   "lower-third",
   "diagram-node"
 ];
-var assetSlotStyleSchema = z3.object({
-  opacity: z3.number().min(0).max(1).optional(),
-  fit: z3.enum(["cover", "contain"]).optional(),
-  z: z3.number().optional()
+var assetSlotStyleSchema = z6.object({
+  opacity: z6.number().min(0).max(1).optional(),
+  fit: z6.enum(["cover", "contain"]).optional(),
+  z: z6.number().optional()
 }).strict();
-var assetSlotSchema = z3.object({
-  id: z3.string().min(1),
-  sceneId: z3.string().min(1).optional(),
-  region: z3.enum(REGION_NAMES),
-  role: z3.enum(ASSET_ROLES),
-  kind: z3.enum(["image", "video"]),
-  source: z3.enum(["auto", "stock", "generate"]),
-  intent: z3.string(),
+var assetSlotSchema = z6.object({
+  id: z6.string().min(1),
+  sceneId: z6.string().min(1).optional(),
+  region: z6.enum(REGION_NAMES),
+  role: z6.enum(ASSET_ROLES),
+  kind: z6.enum(["image", "video"]),
+  source: z6.enum(["auto", "stock", "generate"]),
+  intent: z6.string(),
   style: assetSlotStyleSchema.optional(),
-  timing: z3.object({
-    fromPct: z3.number().min(0).max(1).optional(),
-    toPct: z3.number().min(0).max(1).optional()
+  timing: z6.object({
+    fromPct: z6.number().min(0).max(1).optional(),
+    toPct: z6.number().min(0).max(1).optional()
   }).strict().optional(),
-  url: z3.string().url().optional()
+  url: z6.string().url().optional()
 }).strict();
-var briefStepSchema = z3.object({
-  label: z3.string(),
-  latex: z3.string().optional(),
-  explanation: z3.string().optional()
+var briefStepSchema = z6.object({
+  label: z6.string(),
+  latex: z6.string().optional(),
+  explanation: z6.string().optional()
 });
-var briefAudioLayerSchema = z3.object({
-  id: z3.string().min(1),
-  src: z3.string().url(),
-  startFrame: z3.number().int().nonnegative().default(0),
-  durationInFrames: z3.number().int().positive().optional(),
-  volume: z3.number().min(0).max(1).default(1),
-  fadeFrames: z3.number().int().nonnegative().default(0),
-  role: z3.enum(["music", "foley", "transition", "effect"])
+var briefAudioLayerSchema = z6.object({
+  id: z6.string().min(1),
+  src: z6.string().url(),
+  startFrame: z6.number().int().nonnegative().default(0),
+  durationInFrames: z6.number().int().positive().optional(),
+  volume: z6.number().min(0).max(1).default(1),
+  fadeFrames: z6.number().int().nonnegative().default(0),
+  role: z6.enum(["music", "foley", "transition", "effect"])
 });
-var protectedRegionEffectSchema = z3.object({
-  id: z3.string().min(1).max(80),
-  kind: z3.literal("border-glint"),
-  coordinateSpace: z3.literal("output-frame-v1").default("output-frame-v1"),
-  region: z3.object({
-    leftPercent: z3.number().min(0).max(100),
-    topPercent: z3.number().min(0).max(100),
-    widthPercent: z3.number().positive().max(100),
-    heightPercent: z3.number().positive().max(100)
+var protectedRegionEffectSchema = z6.object({
+  id: z6.string().min(1).max(80),
+  kind: z6.literal("border-glint"),
+  coordinateSpace: z6.literal("output-frame-v1").default("output-frame-v1"),
+  region: z6.object({
+    leftPercent: z6.number().min(0).max(100),
+    topPercent: z6.number().min(0).max(100),
+    widthPercent: z6.number().positive().max(100),
+    heightPercent: z6.number().positive().max(100)
   }),
-  startFrame: z3.number().int().nonnegative().default(0),
-  endFrame: z3.number().int().positive(),
-  speedUpFrame: z3.number().int().nonnegative().optional(),
-  color: z3.string().max(64).default("#ffffff"),
-  thicknessPercent: z3.number().positive().max(20).default(3)
+  startFrame: z6.number().int().nonnegative().default(0),
+  endFrame: z6.number().int().positive(),
+  speedUpFrame: z6.number().int().nonnegative().optional(),
+  color: z6.string().max(64).default("#ffffff"),
+  thicknessPercent: z6.number().positive().max(20).default(3)
 }).superRefine((effect2, context) => {
   if (effect2.region.leftPercent + effect2.region.widthPercent > 100) {
     context.addIssue({
@@ -838,13 +3322,13 @@ var protectedRegionEffectSchema = z3.object({
     });
   }
 });
-var beatVisualRequestSchema = z3.object({
-  intent: z3.string().trim().min(1).optional(),
-  media: z3.enum(["still", "motion"]).default("still"),
-  source: z3.enum(["auto", "stock", "generate"]).default("auto")
+var beatVisualRequestSchema = z6.object({
+  intent: z6.string().trim().min(1).optional(),
+  media: z6.enum(["still", "motion"]).default("still"),
+  source: z6.enum(["auto", "stock", "generate"]).default("auto")
 }).strict();
-var briefSceneSchema = z3.object({
-  type: z3.enum([
+var briefSceneSchema = z6.object({
+  type: z6.enum([
     "hero",
     "points",
     "equation",
@@ -867,156 +3351,188 @@ var briefSceneSchema = z3.object({
     "image-window",
     "custom"
   ]),
-  durationInFrames: z3.number().optional(),
-  narrationText: z3.string().optional(),
+  layoutPreset: z6.literal("dark-cafe-announcement").optional().describe(
+    "Built-in portrait coffee illustration with title, subtitle body and text CTA. Use only on a custom scene after the user selects this design. No generated assets."
+  ),
+  durationInFrames: z6.number().optional(),
+  narrationText: z6.string().optional(),
   visualResolution: beatVisualRequestSchema.optional(),
-  title: z3.string().optional(),
-  subtitle: z3.string().optional(),
-  text: z3.string().optional(),
-  points: z3.array(z3.string()).optional(),
-  latex: z3.string().optional(),
-  value: z3.union([z3.string(), z3.number()]).optional(),
-  max: z3.number().optional(),
-  label: z3.string().optional(),
-  unit: z3.string().optional(),
-  prefix: z3.string().optional(),
-  suffix: z3.string().optional(),
-  decimals: z3.number().optional(),
-  color: z3.string().optional(),
-  tone: z3.string().optional(),
-  iconKey: z3.string().optional(),
-  stepNumber: z3.number().optional(),
-  totalSteps: z3.number().optional(),
-  items: z3.array(z3.object({ label: z3.string(), value: z3.number() })).optional(),
-  src: z3.string().optional(),
-  caption: z3.string().optional(),
+  title: z6.string().optional(),
+  subtitle: z6.string().optional(),
+  text: z6.string().optional(),
+  points: z6.array(z6.string()).optional(),
+  latex: z6.string().optional(),
+  value: z6.union([z6.string(), z6.number()]).optional(),
+  max: z6.number().optional(),
+  label: z6.string().optional(),
+  unit: z6.string().optional(),
+  prefix: z6.string().optional(),
+  suffix: z6.string().optional(),
+  decimals: z6.number().optional(),
+  color: z6.string().optional(),
+  tone: z6.string().optional(),
+  iconKey: z6.string().optional(),
+  stepNumber: z6.number().optional(),
+  totalSteps: z6.number().optional(),
+  items: z6.array(z6.object({ label: z6.string(), value: z6.number() })).optional(),
+  src: z6.string().optional(),
+  caption: z6.string().optional(),
   // A-roll generation (video-window scenes): source "generate" triggers
   // flag-gated WaveSpeed image/video gen server-side from generatePrompt;
   // "url" (default) uses src as-is. Kept in sync with the app's
   // briefSceneSchema - see the parity test in the app suite.
-  source: z3.enum(["url", "generate"]).optional(),
-  generatePrompt: z3.string().optional(),
+  source: z6.enum(["url", "generate"]).optional(),
+  generatePrompt: z6.string().optional(),
   generationContract: generationContractSchema.optional(),
-  trimStartSeconds: z3.number().nonnegative().optional(),
-  trimEndSeconds: z3.number().positive().optional(),
-  playbackRate: z3.number().min(0.25).max(8).optional(),
-  objectFit: z3.enum(["cover", "contain"]).optional(),
-  objectPosition: z3.string().optional(),
-  scaleFrom: z3.number().min(0.5).max(2).optional(),
-  scaleTo: z3.number().min(0.5).max(2).optional(),
-  panFromX: z3.number().min(-50).max(50).optional(),
-  panToX: z3.number().min(-50).max(50).optional(),
-  panFromY: z3.number().min(-50).max(50).optional(),
-  panToY: z3.number().min(-50).max(50).optional(),
-  routeFrom: z3.string().optional(),
-  routeTo: z3.string().optional(),
-  routeLabel: z3.string().optional(),
-  overlayKind: z3.enum(["none", "hook", "stage", "end-card"]).optional(),
-  overlayPosition: z3.enum(["center", "top", "bottom"]).optional(),
-  accentColor: z3.string().optional(),
-  overlayBackgroundColor: z3.string().optional(),
-  cutFlash: z3.boolean().optional(),
-  muted: z3.boolean().optional(),
-  protectedRegionEffects: z3.array(protectedRegionEffectSchema).max(4).optional(),
-  flashAtFrame: z3.number().int().nonnegative().optional(),
-  flashDurationFrames: z3.number().int().positive().max(15).optional()
+  trimStartSeconds: z6.number().nonnegative().optional(),
+  trimEndSeconds: z6.number().positive().optional(),
+  playbackRate: z6.number().min(0.25).max(8).optional(),
+  objectFit: z6.enum(["cover", "contain"]).optional(),
+  objectPosition: z6.string().optional(),
+  scaleFrom: z6.number().min(0.5).max(2).optional(),
+  scaleTo: z6.number().min(0.5).max(2).optional(),
+  panFromX: z6.number().min(-50).max(50).optional(),
+  panToX: z6.number().min(-50).max(50).optional(),
+  panFromY: z6.number().min(-50).max(50).optional(),
+  panToY: z6.number().min(-50).max(50).optional(),
+  routeFrom: z6.string().optional(),
+  routeTo: z6.string().optional(),
+  routeLabel: z6.string().optional(),
+  overlayKind: z6.enum(["none", "hook", "stage", "end-card"]).optional(),
+  overlayPosition: z6.enum(["center", "top", "bottom"]).optional(),
+  accentColor: z6.string().optional(),
+  overlayBackgroundColor: z6.string().optional(),
+  cutFlash: z6.boolean().optional(),
+  muted: z6.boolean().optional(),
+  protectedRegionEffects: z6.array(protectedRegionEffectSchema).max(4).optional(),
+  flashAtFrame: z6.number().int().nonnegative().optional(),
+  flashDurationFrames: z6.number().int().positive().max(15).optional()
 });
-var directionsBriefSchema = z3.object({
-  subtitle: z3.string().optional(),
-  unitLabel: z3.string().optional(),
-  distanceTimeChip: z3.string().optional(),
-  clips: z3.array(
-    z3.object({
-      src: z3.string(),
-      trimStartSeconds: z3.number().optional(),
-      trimEndSeconds: z3.number(),
-      speed: z3.number().optional(),
-      mirrorFlip: z3.boolean().optional()
+var directionsBriefSchema = z6.object({
+  subtitle: z6.string().optional(),
+  unitLabel: z6.string().optional(),
+  distanceTimeChip: z6.string().optional(),
+  clips: z6.array(
+    z6.object({
+      src: z6.string(),
+      trimStartSeconds: z6.number().optional(),
+      trimEndSeconds: z6.number(),
+      speed: z6.number().optional(),
+      mirrorFlip: z6.boolean().optional()
     })
   ).min(1),
-  cues: z3.array(
-    z3.object({
-      atSeconds: z3.number(),
-      text: z3.string(),
-      arrow: z3.enum(["left", "right", "forward"]).optional(),
-      step: z3.number().optional()
+  cues: z6.array(
+    z6.object({
+      atSeconds: z6.number(),
+      text: z6.string(),
+      arrow: z6.enum(["left", "right", "forward"]).optional(),
+      step: z6.number().optional()
     })
   ),
-  outro: z3.object({
-    heading: z3.string().optional(),
-    body: z3.array(z3.string()).optional(),
-    seconds: z3.number().optional()
+  outro: z6.object({
+    heading: z6.string().optional(),
+    body: z6.array(z6.string()).optional(),
+    seconds: z6.number().optional()
   }).optional(),
-  music: z3.object({
-    perSegment: z3.array(
-      z3.object({
-        src: z3.string(),
-        clipIndexStart: z3.number().optional(),
-        hotOffsetSeconds: z3.number().optional(),
-        volume: z3.number().optional()
+  music: z6.object({
+    perSegment: z6.array(
+      z6.object({
+        src: z6.string(),
+        clipIndexStart: z6.number().optional(),
+        hotOffsetSeconds: z6.number().optional(),
+        volume: z6.number().optional()
       })
     ).optional(),
-    crossfadeSeconds: z3.number().optional()
+    crossfadeSeconds: z6.number().optional()
   }).optional()
 });
+var PERSON_CONSENT_WORDING_VERSION = "2026-10-19.1";
+var PERSON_CONSENT_WORDING = "I have permission from everyone shown, and no one shown is under 18 unless I am their parent or guardian.";
+var personConsentSchema = z6.object({
+  confirmed: z6.literal(true).describe("Must be true: the caller confirms the declaration below."),
+  wordingVersion: z6.string().describe(
+    `Version of the declaration the caller confirmed. Current: ${PERSON_CONSENT_WORDING_VERSION}.`
+  )
+}).strict().describe(
+  `Required when the brief uses an uploaded image or video. Ask the user to confirm: "${PERSON_CONSENT_WORDING}"`
+);
+var LIKENESS_WARNING_WORDING_VERSION = "2026-10-19.1";
+var LIKENESS_WARNING_WORDING = "This photo seems to show someone other than you. Only continue if you have their permission.";
+var LIKENESS_MINOR_WARNING_WORDING_VERSION = "2026-10-19.1";
+var LIKENESS_MINOR_WARNING_WORDING = "This may show someone under 18. Continue only if you are their parent or guardian, or have their parent or guardian's permission.";
+var likenessAcknowledgementSchema = z6.object({
+  confirmed: z6.literal(true).describe("Must be true: the user accepted the warning below."),
+  kind: z6.enum(["other_person", "guardian"]).optional().describe(
+    `Which warning was accepted. "other_person" (default): "${LIKENESS_WARNING_WORDING}" "guardian": "${LIKENESS_MINOR_WARNING_WORDING}"`
+  ),
+  wordingVersion: z6.string().describe(
+    `Version of the warning accepted. Current: other_person ${LIKENESS_WARNING_WORDING_VERSION}, guardian ${LIKENESS_MINOR_WARNING_WORDING_VERSION}.`
+  )
+}).strict().describe(
+  "Optional. Send only after the user has seen and accepted the warning. Without it, a job that animates an uploaded photo of someone other than the account holder stops with likeness_acknowledgement_required, or likeness_guardian_confirmation_required when the person may be under 18."
+);
 var createBriefShape = {
-  title: z3.string().min(1).max(120).describe("Short title (max 120 chars)"),
-  script: z3.string().min(1).describe("Full narration script (sent to TTS)"),
-  caption: z3.string().min(1).describe("Social caption with hooks, hashtags, CTA"),
-  publishTarget: z3.enum(PUBLISH_TARGETS).describe("Target social platform"),
-  publishTargets: z3.array(z3.enum(PUBLISH_TARGETS)).max(9).optional().describe("All allowed social destinations for this video"),
-  objective: z3.enum(BRIEF_OBJECTIVES).describe("Content objective (drives composition routing)"),
-  targetDurationSeconds: z3.number().int().min(5).max(600).optional().describe("Requested final video duration in seconds"),
-  narrationMode: z3.enum(["tts", "off"]).optional().describe("Disable synthesized narration for source-audio or silent work"),
-  lessonTitle: z3.string().optional().describe("Display title rendered inside the video"),
+  title: z6.string().min(1).max(120).describe("Short title (max 120 chars)"),
+  script: z6.string().min(1).describe("Full narration script (sent to TTS)"),
+  caption: z6.string().min(1).describe("Social caption with hooks, hashtags, CTA"),
+  publishTarget: z6.enum(PUBLISH_TARGETS).describe("Target social platform"),
+  publishTargets: z6.array(z6.enum(PUBLISH_TARGETS)).max(9).optional().describe("All allowed social destinations for this video"),
+  objective: z6.enum(BRIEF_OBJECTIVES).describe("Content objective (drives composition routing)"),
+  targetDurationSeconds: z6.number().int().min(5).max(600).optional().describe("Requested final video duration in seconds"),
+  narrationMode: z6.enum(["tts", "off"]).optional().describe("Disable synthesized narration for source-audio or silent work"),
+  lessonTitle: z6.string().optional().describe("Display title rendered inside the video"),
   visualDirection: visualDirectionSchema.optional().describe(
     "Whole-video communication, attention, visual-language, and camera direction."
   ),
-  steps: z3.array(briefStepSchema).optional().describe("Structured steps for educational content (LaTeX)"),
-  scenes: z3.array(briefSceneSchema).optional().describe("Scene graph for the UniversalVideo composition"),
+  steps: z6.array(briefStepSchema).optional().describe("Structured steps for educational content (LaTeX)"),
+  scenes: z6.array(briefSceneSchema).optional().describe("Scene graph for the UniversalVideo composition"),
   // No zod .default() here: a default would materialize into the parsed tool
   // arguments and relay to /api/v1/jobs as if the caller stated it, corrupting
   // the resolution provenance the API echoes back. Unset must stay absent;
   // the API re-applies 9:16 server-side.
-  aspectRatio: z3.enum(ASPECT_RATIOS).optional().describe("Aspect ratio (defaults to 9:16 when omitted)"),
-  compositionId: z3.string().optional().describe("Remotion composition ID override (advanced)"),
-  voiceId: z3.string().optional().describe(
+  aspectRatio: z6.enum(ASPECT_RATIOS).optional().describe("Aspect ratio (defaults to 9:16 when omitted)"),
+  compositionId: z6.string().optional().describe("Remotion composition ID override (advanced)"),
+  voiceId: z6.string().optional().describe(
     "TTS narrator voice ID. Unknown IDs are rejected before rendering; when omitted, the org's saved voice preference or the system default is used and reported in the response's resolution block."
   ),
   directions: directionsBriefSchema.optional().describe(
     "DirectionsWalkthrough 'find-us' payload: source clips (legs), decision-point cues on the realtime walk timeline, outro, and optional music. Set compositionId 'DirectionsWalkthrough' (or objective 'directions')."
   ),
-  assetSlots: z3.array(assetSlotSchema).optional().describe(
+  assetSlots: z6.array(assetSlotSchema).optional().describe(
     "Optional storyboard asset slots: region-placed image/video assets or placeholders attached to the whole video or a specific scene."
   ),
-  audioLayers: z3.array(briefAudioLayerSchema).optional().describe("Optional typed music, Foley, transition, and effect layers.")
+  audioLayers: z6.array(briefAudioLayerSchema).optional().describe("Optional typed music, Foley, transition, and effect layers."),
+  personConsent: personConsentSchema.optional(),
+  likenessAcknowledgement: likenessAcknowledgementSchema.optional()
 };
 var editBriefShape = {
-  jobId: z3.string().uuid().describe("The job to edit"),
-  title: z3.string().optional().describe("Updated title"),
-  script: z3.string().optional().describe("Updated narration script"),
-  caption: z3.string().optional().describe("Updated social caption"),
-  lessonTitle: z3.string().optional().describe("Updated lesson title"),
-  narrationMode: z3.enum(["tts", "off"]).optional().describe("Updated synthesized narration mode"),
+  jobId: z6.string().uuid().describe("The job to edit"),
+  personConsent: personConsentSchema.optional(),
+  likenessAcknowledgement: likenessAcknowledgementSchema.optional(),
+  title: z6.string().optional().describe("Updated title"),
+  script: z6.string().optional().describe("Updated narration script"),
+  caption: z6.string().optional().describe("Updated social caption"),
+  lessonTitle: z6.string().optional().describe("Updated lesson title"),
+  narrationMode: z6.enum(["tts", "off"]).optional().describe("Updated synthesized narration mode"),
   visualDirection: visualDirectionSchema.optional().describe("Updated whole-video visual direction"),
-  steps: z3.array(briefStepSchema).optional().describe("Updated steps (replaces the array)"),
-  scenes: z3.array(briefSceneSchema).optional().describe("Updated scenes (replaces the array)"),
-  aspectRatio: z3.enum(ASPECT_RATIOS).optional().describe("Updated aspect ratio"),
-  objective: z3.enum(BRIEF_OBJECTIVES).optional().describe(
+  steps: z6.array(briefStepSchema).optional().describe("Updated steps (replaces the array)"),
+  scenes: z6.array(briefSceneSchema).optional().describe("Updated scenes (replaces the array)"),
+  aspectRatio: z6.enum(ASPECT_RATIOS).optional().describe("Updated aspect ratio"),
+  objective: z6.enum(BRIEF_OBJECTIVES).optional().describe(
     "Updated content objective. Re-routes the composition and triggers a re-render."
   ),
-  publishTarget: z3.enum(PUBLISH_TARGETS).optional().describe(
+  publishTarget: z6.enum(PUBLISH_TARGETS).optional().describe(
     "Updated target social platform. Distribution metadata only - does not trigger a re-render."
   ),
-  publishTargets: z3.array(z3.enum(PUBLISH_TARGETS)).max(9).optional().describe("Replacement allowed social destination list"),
-  targetDurationSeconds: z3.number().int().min(5).max(600).optional().describe("Updated final video duration in seconds"),
-  voiceId: z3.string().optional().describe(
+  publishTargets: z6.array(z6.enum(PUBLISH_TARGETS)).max(9).optional().describe("Replacement allowed social destination list"),
+  targetDurationSeconds: z6.number().int().min(5).max(600).optional().describe("Updated final video duration in seconds"),
+  voiceId: z6.string().optional().describe(
     "Updated TTS narrator voice ID. Triggers a re-render with the new voice."
   ),
-  assetSlots: z3.array(assetSlotSchema).optional().describe(
+  assetSlots: z6.array(assetSlotSchema).optional().describe(
     "Replacement storyboard asset slots. Omit to preserve existing slots; pass [] to clear them."
   ),
-  audioLayers: z3.array(briefAudioLayerSchema).optional().describe(
+  audioLayers: z6.array(briefAudioLayerSchema).optional().describe(
     "Replacement typed audio layers. Omit to preserve existing layers; pass [] to clear them."
   )
 };
@@ -1053,7 +3569,7 @@ function verificationMatches(verifications, pattern) {
 }
 function buildRenderDiagnosticSnapshot(params) {
   const failed = [params.jobStatus, params.videoState].find(
-    (result2) => !result2.ok
+    (result3) => !result3.ok
   );
   if (failed) return failed;
   const status = record(params.jobStatus.body);
@@ -1124,165 +3640,165 @@ function buildRenderDiagnosticSnapshot(params) {
 }
 
 // src/design-action-schema.ts
-import { z as z4 } from "zod";
-var id = z4.string().min(1).max(120);
-var point = z4.object({ x: z4.number().min(0).max(1), y: z4.number().min(0).max(1) }).strict();
-var polygonShape = z4.object({
-  kind: z4.literal("polygon"),
-  points: z4.array(point).min(3).max(512)
+import { z as z7 } from "zod";
+var id = z7.string().min(1).max(120);
+var point = z7.object({ x: z7.number().min(0).max(1), y: z7.number().min(0).max(1) }).strict();
+var polygonShape = z7.object({
+  kind: z7.literal("polygon"),
+  points: z7.array(point).min(3).max(512)
 }).strict();
-var rasterShape = z4.object({
-  kind: z4.literal("raster"),
-  source: z4.object({
+var rasterShape = z7.object({
+  kind: z7.literal("raster"),
+  source: z7.object({
     assetId: id,
-    expectedSha256: z4.string().regex(/^[a-f0-9]{64}$/),
-    sourceRange: z4.object({
-      startFrame: z4.number().int().nonnegative(),
-      endFrame: z4.number().int().positive()
+    expectedSha256: z7.string().regex(/^[a-f0-9]{64}$/),
+    sourceRange: z7.object({
+      startFrame: z7.number().int().nonnegative(),
+      endFrame: z7.number().int().positive()
     }).strict().optional()
   }).strict(),
-  widthPx: z4.number().int().positive().max(8192),
-  heightPx: z4.number().int().positive().max(8192)
+  widthPx: z7.number().int().positive().max(8192),
+  heightPx: z7.number().int().positive().max(8192)
 }).strict();
-var shape = z4.discriminatedUnion("kind", [polygonShape, rasterShape]);
-var mask = z4.object({
+var shape = z7.discriminatedUnion("kind", [polygonShape, rasterShape]);
+var mask = z7.object({
   id,
   shape,
-  operation: z4.enum(["add", "subtract"]),
-  inverted: z4.boolean().default(false),
-  feather: z4.number().finite().nonnegative().max(0.25).default(0),
-  allowedSupportMargin: z4.number().finite().nonnegative().max(0.25).default(0),
-  reviewState: z4.enum(["draft", "approved", "rejected"]),
-  provenance: z4.object({
-    kind: z4.enum(["manual", "imported", "model-proposed"]),
+  operation: z7.enum(["add", "subtract"]),
+  inverted: z7.boolean().default(false),
+  feather: z7.number().finite().nonnegative().max(0.25).default(0),
+  allowedSupportMargin: z7.number().finite().nonnegative().max(0.25).default(0),
+  reviewState: z7.enum(["draft", "approved", "rejected"]),
+  provenance: z7.object({
+    kind: z7.enum(["manual", "imported", "model-proposed"]),
     sourceAssetId: id.optional(),
-    modelId: z4.string().min(1).max(160).optional()
+    modelId: z7.string().min(1).max(160).optional()
   }).strict()
 }).strict();
-var transform = z4.object({
-  x: z4.number().min(0).max(1),
-  y: z4.number().min(0).max(1),
-  width: z4.number().positive().max(1),
-  height: z4.number().positive().max(1),
-  rotationDegrees: z4.number().min(-360).max(360),
-  opacity: z4.number().min(0).max(1)
+var transform = z7.object({
+  x: z7.number().min(0).max(1),
+  y: z7.number().min(0).max(1),
+  width: z7.number().positive().max(1),
+  height: z7.number().positive().max(1),
+  rotationDegrees: z7.number().min(-360).max(360),
+  opacity: z7.number().min(0).max(1)
 }).strict();
 var colourParameters = {
-  exposure: z4.number().finite().min(-2).max(2).default(0),
-  contrast: z4.number().finite().min(0.5).max(2).default(1),
-  saturation: z4.number().finite().min(0).max(2).default(1),
-  temperature: z4.number().finite().min(-1).max(1).default(0),
-  tint: z4.number().finite().min(-1).max(1).default(0)
+  exposure: z7.number().finite().min(-2).max(2).default(0),
+  contrast: z7.number().finite().min(0.5).max(2).default(1),
+  saturation: z7.number().finite().min(0).max(2).default(1),
+  temperature: z7.number().finite().min(-1).max(1).default(0),
+  tint: z7.number().finite().min(-1).max(1).default(0)
 };
-var effect = z4.object({
+var effect = z7.object({
   id,
-  kind: z4.literal("local-colour"),
-  version: z4.literal(1),
+  kind: z7.literal("local-colour"),
+  version: z7.literal(1),
   maskId: id,
   ...colourParameters
 }).strict();
-var motionPath = z4.object({
+var motionPath = z7.object({
   id,
-  kind: z4.literal("cubic-bezier"),
-  startFrame: z4.number().int().nonnegative(),
-  endFrame: z4.number().int().positive(),
+  kind: z7.literal("cubic-bezier"),
+  startFrame: z7.number().int().nonnegative(),
+  endFrame: z7.number().int().positive(),
   start: point,
   control1: point,
   control2: point,
   end: point,
-  easing: z4.enum(["linear", "ease-in", "ease-out", "ease-in-out"]),
-  orientToPath: z4.boolean().default(false)
+  easing: z7.enum(["linear", "ease-in", "ease-out", "ease-in-out"]),
+  orientToPath: z7.boolean().default(false)
 }).strict();
-var region = z4.object({ id, shape, label: z4.string().min(1).max(160) }).strict();
+var region = z7.object({ id, shape, label: z7.string().min(1).max(160) }).strict();
 var base = { actionId: id, sceneId: id };
-var vendoredDesignActionSchema = z4.discriminatedUnion("kind", [
-  z4.object({
+var vendoredDesignActionSchema = z7.discriminatedUnion("kind", [
+  z7.object({
     ...base,
-    kind: z4.literal("set-layer-transform"),
+    kind: z7.literal("set-layer-transform"),
     layerId: id,
     transform
   }).strict(),
-  z4.object({
+  z7.object({
     ...base,
-    kind: z4.literal("set-local-colour-effect"),
+    kind: z7.literal("set-local-colour-effect"),
     effectId: id,
-    parameters: z4.object(colourParameters).strict()
+    parameters: z7.object(colourParameters).strict()
   }).strict(),
-  z4.object({ ...base, kind: z4.literal("create-mask"), mask }).strict(),
-  z4.object({ ...base, kind: z4.literal("set-mask"), maskId: id, mask }).strict(),
-  z4.object({
+  z7.object({ ...base, kind: z7.literal("create-mask"), mask }).strict(),
+  z7.object({ ...base, kind: z7.literal("set-mask"), maskId: id, mask }).strict(),
+  z7.object({
     ...base,
-    kind: z4.literal("set-mask-review-state"),
+    kind: z7.literal("set-mask-review-state"),
     maskId: id,
-    reviewState: z4.enum(["draft", "approved", "rejected"])
+    reviewState: z7.enum(["draft", "approved", "rejected"])
   }).strict(),
-  z4.object({ ...base, kind: z4.literal("delete-mask"), maskId: id }).strict(),
-  z4.object({
+  z7.object({ ...base, kind: z7.literal("delete-mask"), maskId: id }).strict(),
+  z7.object({
     ...base,
-    kind: z4.literal("attach-effect"),
+    kind: z7.literal("attach-effect"),
     effect,
-    layerIds: z4.array(id).min(1).max(50)
+    layerIds: z7.array(id).min(1).max(50)
   }).strict(),
-  z4.object({ ...base, kind: z4.literal("remove-effect"), effectId: id }).strict(),
-  z4.object({
+  z7.object({ ...base, kind: z7.literal("remove-effect"), effectId: id }).strict(),
+  z7.object({
     ...base,
-    kind: z4.literal("set-layer-text"),
+    kind: z7.literal("set-layer-text"),
     layerId: id,
-    text: z4.string().max(1e4)
+    text: z7.string().max(1e4)
   }).strict(),
-  z4.object({
+  z7.object({
     ...base,
-    kind: z4.literal("set-layer-visibility"),
+    kind: z7.literal("set-layer-visibility"),
     layerId: id,
-    visible: z4.boolean()
+    visible: z7.boolean()
   }).strict(),
-  z4.object({
+  z7.object({
     ...base,
-    kind: z4.literal("set-layer-locked"),
+    kind: z7.literal("set-layer-locked"),
     layerId: id,
-    locked: z4.boolean()
+    locked: z7.boolean()
   }).strict(),
-  z4.object({
+  z7.object({
     ...base,
-    kind: z4.literal("set-layer-mask-ids"),
+    kind: z7.literal("set-layer-mask-ids"),
     layerId: id,
-    maskIds: z4.array(id).max(16)
+    maskIds: z7.array(id).max(16)
   }).strict(),
-  z4.object({
+  z7.object({
     ...base,
-    kind: z4.literal("set-layer-order"),
-    orderedLayerIds: z4.array(id).min(1).max(500)
+    kind: z7.literal("set-layer-order"),
+    orderedLayerIds: z7.array(id).min(1).max(500)
   }).strict(),
-  z4.object({
+  z7.object({
     ...base,
-    kind: z4.literal("set-motion-path"),
+    kind: z7.literal("set-motion-path"),
     path: motionPath,
-    layerIds: z4.array(id).max(50).default([])
+    layerIds: z7.array(id).max(50).default([])
   }).strict(),
-  z4.object({ ...base, kind: z4.literal("remove-motion-path"), pathId: id }).strict(),
-  z4.object({ ...base, kind: z4.literal("set-protected-region"), region }).strict(),
-  z4.object({
+  z7.object({ ...base, kind: z7.literal("remove-motion-path"), pathId: id }).strict(),
+  z7.object({ ...base, kind: z7.literal("set-protected-region"), region }).strict(),
+  z7.object({
     ...base,
-    kind: z4.literal("remove-protected-region"),
+    kind: z7.literal("remove-protected-region"),
     regionId: id
   }).strict()
 ]);
-var inspectDesignDocumentToolSchema = z4.object({
-  projectId: z4.string().uuid(),
-  documentId: z4.string().uuid(),
-  includeVersions: z4.boolean().default(true)
+var inspectDesignDocumentToolSchema = z7.object({
+  projectId: z7.string().uuid(),
+  documentId: z7.string().uuid(),
+  includeVersions: z7.boolean().default(true)
 }).strict();
-var applyDesignActionsToolSchema = z4.object({
-  projectId: z4.string().uuid(),
-  documentId: z4.string().uuid(),
-  actionGroupId: z4.string().min(1).max(120),
-  expectedVersion: z4.number().int().positive(),
-  actions: z4.array(vendoredDesignActionSchema).min(1).max(50),
-  clientCreatedAt: z4.string().datetime()
+var applyDesignActionsToolSchema = z7.object({
+  projectId: z7.string().uuid(),
+  documentId: z7.string().uuid(),
+  actionGroupId: z7.string().min(1).max(120),
+  expectedVersion: z7.number().int().positive(),
+  actions: z7.array(vendoredDesignActionSchema).min(1).max(50),
+  clientCreatedAt: z7.string().datetime()
 }).strict();
 
 // src/tools.ts
-var uuid = (desc) => z5.string().uuid().describe(desc);
+var uuid = (desc) => z8.string().uuid().describe(desc);
 var READ_ONLY = {
   readOnlyHint: true,
   destructiveHint: false,
@@ -1301,9 +3817,9 @@ function registerTools(server) {
     {
       title: "List jobs",
       description: "List recent video jobs for the current organization (newest first). Start here to discover job IDs; for one job's full detail use get_job_status.",
-      inputSchema: {
-        limit: z5.number().int().min(1).max(50).default(10).describe("Number of jobs to return (default 10, max 50)"),
-        status: z5.enum([
+      inputSchema: z8.object({
+        limit: z8.number().int().min(1).max(50).default(10).describe("Number of jobs to return (default 10, max 50)"),
+        status: z8.enum([
           "queued",
           "rendering",
           "draft_ready",
@@ -1313,7 +3829,7 @@ function registerTools(server) {
           "published",
           "failed"
         ]).optional().describe("Filter by job status")
-      },
+      }).strict(),
       annotations: READ_ONLY
     },
     async ({ limit, status }) => {
@@ -1327,7 +3843,7 @@ function registerTools(server) {
     {
       title: "Get job status",
       description: "Get detailed status for a job: runs, artifacts, verifications, plus the current video and thumbnail URLs. The main polling target after create_video_brief or edit_video_brief; for post-publish engagement numbers use get_job_metrics instead.",
-      inputSchema: { jobId: uuid("The job ID to check") },
+      inputSchema: z8.object({ jobId: uuid("The job ID to check") }).strict(),
       annotations: READ_ONLY
     },
     async ({ jobId }) => runTool(() => apiGet(`/api/v1/jobs/${encodeURIComponent(jobId)}`))
@@ -1337,7 +3853,7 @@ function registerTools(server) {
     {
       title: "Get video state",
       description: "Get the materialized video state for a job (composition decisions: scenes, duration, aspect ratio, etc.). Use it to inspect what the video contains; for pipeline progress and video URLs use get_job_status.",
-      inputSchema: { jobId: uuid("The job ID") },
+      inputSchema: z8.object({ jobId: uuid("The job ID") }).strict(),
       annotations: READ_ONLY
     },
     async ({ jobId }) => runTool(
@@ -1349,7 +3865,7 @@ function registerTools(server) {
     {
       title: "Diagnose render",
       description: "Build one read-only troubleshooting snapshot from the current job status and video state. Reports run failures, artifact binding, duration evidence, retry recommendations, rights checks, and whether blank-frame or placeholder verification evidence exists. It does not visually inspect the video.",
-      inputSchema: { jobId: uuid("The job ID to diagnose") },
+      inputSchema: z8.object({ jobId: uuid("The job ID to diagnose") }).strict(),
       annotations: READ_ONLY
     },
     async ({ jobId }) => runTool(async () => {
@@ -1366,10 +3882,10 @@ function registerTools(server) {
     {
       title: "Get job metrics",
       description: "Get the latest platform engagement metric snapshots for a published job (newest first). Read-only. Only meaningful after publish_job; for render progress use get_job_status.",
-      inputSchema: {
+      inputSchema: z8.object({
         jobId: uuid("The job ID"),
-        limit: z5.number().int().min(1).max(20).default(10).describe("Max metric snapshots (default 10, max 20)")
-      },
+        limit: z8.number().int().min(1).max(20).default(10).describe("Max metric snapshots (default 10, max 20)")
+      }).strict(),
       annotations: READ_ONLY
     },
     async ({ jobId, limit }) => runTool(
@@ -1383,12 +3899,12 @@ function registerTools(server) {
     {
       title: "Get cost summary",
       description: "Query production infrastructure costs (Lambda, RunPod, R2, WaveSpeed, PoYo), optionally with reconciliation drift. This is spend data, not engagement \u2014 for a published job's audience numbers use get_job_metrics.",
-      inputSchema: {
-        since: z5.string().optional().describe("ISO date \u2014 only include events after this date"),
-        provider: z5.enum(["runpod", "lambda", "r2", "wavespeed", "poyo", "all"]).default("all").describe("Filter by provider"),
-        groupBy: z5.enum(["provider", "job", "day"]).default("provider").describe("How to aggregate the summary"),
-        includeReconciliation: z5.boolean().default(false).describe("Include account-wide reconciliation events")
-      },
+      inputSchema: z8.object({
+        since: z8.string().optional().describe("ISO date \u2014 only include events after this date"),
+        provider: z8.enum(["runpod", "lambda", "r2", "wavespeed", "poyo", "all"]).default("all").describe("Filter by provider"),
+        groupBy: z8.enum(["provider", "job", "day"]).default("provider").describe("How to aggregate the summary"),
+        includeReconciliation: z8.boolean().default(false).describe("Include account-wide reconciliation events")
+      }).strict(),
       annotations: READ_ONLY
     },
     async ({ since, provider, groupBy, includeReconciliation }) => {
@@ -1403,7 +3919,7 @@ function registerTools(server) {
     {
       title: "Inspect workflow",
       description: "Inspect the current Studio workflow and its version history for a job.",
-      inputSchema: z5.object({ jobId: uuid("The job ID") }).strict(),
+      inputSchema: z8.object({ jobId: uuid("The job ID") }).strict(),
       annotations: READ_ONLY
     },
     async ({ jobId }) => runTool(
@@ -1452,7 +3968,10 @@ function registerTools(server) {
     {
       title: "Create video brief",
       description: "Create a new video job from a structured brief and trigger the render pipeline. Returns the job and run IDs immediately; rendering continues asynchronously (typically a few minutes) \u2014 poll get_job_status until draft_ready. Requires a key with write scope. To change an existing job, use edit_video_brief instead of creating a duplicate.",
-      inputSchema: createBriefShape,
+      // Strict like the remote Studio tool: an unsupported field such as a
+      // framework choice is rejected instead of being stripped and rendered
+      // with the default renderer.
+      inputSchema: z8.object(createBriefShape).strict(),
       annotations: SAFE_WRITE
     },
     async (input) => runTool(() => apiPost(`/api/v1/jobs`, input))
@@ -1462,7 +3981,7 @@ function registerTools(server) {
     {
       title: "Edit video brief",
       description: "Edit an existing job's brief (only provided fields change). Changing the script, caption, title, lessonTitle, objective, steps, scenes, aspectRatio or voiceId triggers a re-render and returns the new run ID; objective also re-routes the composition. Changing only publishTarget updates the job's target platform without re-rendering. For a brand-new video use create_video_brief.",
-      inputSchema: editBriefShape,
+      inputSchema: z8.object(editBriefShape).strict(),
       annotations: SAFE_WRITE
     },
     async (input) => {
@@ -1483,10 +4002,10 @@ function registerTools(server) {
     {
       title: "Draft workflow",
       description: "Create a durable Documentary Journey or Transformation Montage workflow version. Inspect first and pass its current version, or 0 only when no workflow exists.",
-      inputSchema: z5.object({
+      inputSchema: z8.object({
         jobId: uuid("The job ID"),
-        expectedVersion: z5.number().int().nonnegative().describe("Use 0 when no workflow exists yet"),
-        document: z5.unknown().describe("The complete Studio workflow document")
+        expectedVersion: z8.number().int().nonnegative().describe("Use 0 when no workflow exists yet"),
+        document: z8.unknown().describe("The complete Studio workflow document")
       }).strict(),
       annotations: SAFE_WRITE
     },
@@ -1497,10 +4016,10 @@ function registerTools(server) {
     {
       title: "Patch workflow",
       description: "Create a new workflow version by recursively merging a patch into the current version.",
-      inputSchema: z5.object({
+      inputSchema: z8.object({
         jobId: uuid("The job ID"),
-        expectedVersion: z5.number().int().positive(),
-        patch: z5.record(z5.string(), z5.unknown())
+        expectedVersion: z8.number().int().positive(),
+        patch: z8.record(z8.string(), z8.unknown())
       }).strict(),
       annotations: SAFE_WRITE
     },
@@ -1511,9 +4030,9 @@ function registerTools(server) {
     {
       title: "Validate workflow",
       description: "Validate and compile the inspected workflow version without rendering or publishing it.",
-      inputSchema: z5.object({
+      inputSchema: z8.object({
         jobId: uuid("The job ID"),
-        expectedVersion: z5.number().int().positive()
+        expectedVersion: z8.number().int().positive()
       }).strict(),
       annotations: SAFE_WRITE
     },
@@ -1524,7 +4043,7 @@ function registerTools(server) {
     {
       title: "Preview workflow",
       description: "Return the current workflow's compiled UniversalVideo brief for a safe pre-render preview.",
-      inputSchema: z5.object({ jobId: uuid("The job ID") }).strict(),
+      inputSchema: z8.object({ jobId: uuid("The job ID") }).strict(),
       annotations: READ_ONLY
     },
     async ({ jobId }) => runTool(
@@ -1538,10 +4057,10 @@ function registerTools(server) {
     {
       title: "Compare workflow versions",
       description: "Compare two durable workflow versions field by field.",
-      inputSchema: z5.object({
+      inputSchema: z8.object({
         jobId: uuid("The job ID"),
-        fromVersion: z5.number().int().positive(),
-        toVersion: z5.number().int().positive()
+        fromVersion: z8.number().int().positive(),
+        toVersion: z8.number().int().positive()
       }).strict(),
       annotations: READ_ONLY
     },
@@ -1565,9 +4084,9 @@ function registerTools(server) {
     {
       title: "Approve workflow",
       description: "Validate and approve the inspected workflow version. This does not approve or publish the video job.",
-      inputSchema: z5.object({
+      inputSchema: z8.object({
         jobId: uuid("The job ID"),
-        expectedVersion: z5.number().int().positive()
+        expectedVersion: z8.number().int().positive()
       }).strict(),
       annotations: {
         readOnlyHint: false,
@@ -1583,11 +4102,11 @@ function registerTools(server) {
     {
       title: "Retry video QA",
       description: "Retry the default QA evaluator against the same current frozen video. Use only when get_job_status recommends retryTarget qa_only, or when QA is missing, unavailable, or parse-degraded. This does not regenerate media and cannot clear publish gates by itself.",
-      inputSchema: {
+      inputSchema: z8.object({
         jobId: uuid("The current job ID"),
         runId: uuid("The current render run ID"),
         videoArtifactId: uuid("The current frozen video artifact ID")
-      },
+      }).strict(),
       annotations: SAFE_WRITE
     },
     async ({ jobId, runId, videoArtifactId }) => runTool(
@@ -1602,11 +4121,11 @@ function registerTools(server) {
     {
       title: "Audit video QA",
       description: "Run Qwen3.6-Plus as an advisory second evaluator against the same current frozen video. Use only on an explicit request for another model, second opinion, or evaluator escalation. The result is separate from default QA and has no publish-gate effect.",
-      inputSchema: {
+      inputSchema: z8.object({
         jobId: uuid("The current job ID"),
         runId: uuid("The current render run ID"),
         videoArtifactId: uuid("The current frozen video artifact ID")
-      },
+      }).strict(),
       annotations: SAFE_WRITE
     },
     async ({ jobId, runId, videoArtifactId }) => runTool(
@@ -1621,11 +4140,11 @@ function registerTools(server) {
     {
       title: "Regenerate narration",
       description: "Regenerate narration from the unchanged durable brief and then regenerate its dependent video in a paid adaptation run. Use only on an explicit user request or when get_job_status recommends retryTarget tts. This is an audio_and_video cascade, consumes rerender quota, and requires fresh QA.",
-      inputSchema: {
+      inputSchema: z8.object({
         jobId: uuid("The current job ID"),
         sourceRunId: uuid("The current run ID"),
-        trigger: z5.enum(["user_requested", "verifier_recommendation"])
-      },
+        trigger: z8.enum(["user_requested", "verifier_recommendation"])
+      }).strict(),
       annotations: SAFE_WRITE
     },
     async ({ jobId, sourceRunId, trigger }) => runTool(
@@ -1640,10 +4159,11 @@ function registerTools(server) {
     {
       title: "Approve job",
       description: "Approve a rendered job so it becomes publishable (draft_ready/awaiting_review/needs_changes -> approved) and revoke active review links. Required before publish_job will accept the job.",
-      inputSchema: { jobId: uuid("The job ID to approve") },
+      inputSchema: z8.object({ jobId: uuid("The job ID to approve") }).strict(),
       annotations: {
         readOnlyHint: false,
-        destructiveHint: false,
+        // Approval revokes active review links, so this is not purely additive.
+        destructiveHint: true,
         // Approving an already-approved job does not change state further.
         idempotentHint: true,
         openWorldHint: false
@@ -1658,18 +4178,30 @@ function registerTools(server) {
     {
       title: "Publish job",
       description: "Publish an APPROVED job to its connected social destination via the gated publish API. All production gates run (paid plan, ownership, abuse, QA, disclosure, destination, rights, moderation). Requires a key with publish scope; the post goes live on the external platform and cannot be recalled by the API. For YouTube pass youtubePrivacyStatus:'private' for safe runs.",
-      inputSchema: {
+      inputSchema: z8.object({
         jobId: uuid("The approved job to publish"),
-        youtubePrivacyStatus: z5.enum(["private", "unlisted", "public"]).optional().describe("YouTube only. Use 'private' for safe dogfood runs."),
-        tiktokPostMode: z5.enum(["direct_publish", "draft_upload"]).optional().describe("TikTok only. Use 'draft_upload' for safe dogfood runs."),
-        connectedAccountDestinationId: z5.string().uuid().optional().describe(
+        xPreviewArtifactId: z8.string().min(1).optional().describe("X only. Exact reviewed video artifact ID."),
+        xCaption: z8.string().trim().min(1).max(2e3).optional().describe("X only. Exact post text approved by the user."),
+        xMadeWithAi: z8.boolean().optional().describe("X only. Enable the Made with AI disclosure."),
+        confirmXPublicPost: z8.boolean().optional().describe(
+          "True only after the user authorizes this public X post."
+        ),
+        confirmXAutomationPolicy: z8.boolean().optional().describe(
+          "True only after the user confirms the X automation policy."
+        ),
+        confirmXOriginalContent: z8.boolean().optional().describe(
+          "True only after the user confirms ownership or publishing rights."
+        ),
+        youtubePrivacyStatus: z8.enum(["private", "unlisted", "public"]).optional().describe("YouTube only. Use 'private' for safe dogfood runs."),
+        tiktokPostMode: z8.enum(["direct_publish", "draft_upload"]).optional().describe("TikTok only. Use 'draft_upload' for safe dogfood runs."),
+        connectedAccountDestinationId: z8.string().uuid().optional().describe(
           "Specific destination when the org has multiple accounts for the provider."
         ),
-        confirmSyntheticDisclosure: z5.boolean().optional().describe(
+        confirmSyntheticDisclosure: z8.boolean().optional().describe(
           "Set true when the job requires an AI synthetic-media disclosure."
         ),
-        confirmQaOverride: z5.boolean().optional().describe("Set true to override a non-passing QA gate.")
-      },
+        confirmQaOverride: z8.boolean().optional().describe("Set true to override a non-passing QA gate.")
+      }).strict(),
       annotations: {
         readOnlyHint: false,
         // A live post on an external platform cannot be recalled by the API.
@@ -1690,8 +4222,8 @@ function registerTools(server) {
     {
       title: "Connect social account",
       description: "Start connecting a social account headlessly (no local browser needed). Returns an approve URL + a short confirm code: open the URL in a browser signed in to Instavar, check the code matches THIS terminal, and approve. Then poll connect_account_status with the returned pairingId until it reports 'connected'.",
-      inputSchema: {
-        provider: z5.enum([
+      inputSchema: z8.object({
+        provider: z8.enum([
           "youtube",
           "x",
           "tiktok",
@@ -1700,7 +4232,7 @@ function registerTools(server) {
           "instagram",
           "threads"
         ]).describe("The social platform to connect")
-      },
+      }).strict(),
       annotations: {
         readOnlyHint: false,
         destructiveHint: false,
@@ -1716,9 +4248,9 @@ function registerTools(server) {
     {
       title: "Check account connection",
       description: "Poll a pending account connection started by connect_account. Returns status 'pending' | 'connected' | 'expired', plus the connected account label once connected.",
-      inputSchema: {
+      inputSchema: z8.object({
         pairingId: uuid("The pairingId returned by connect_account")
-      },
+      }).strict(),
       annotations: READ_ONLY
     },
     async ({ pairingId }) => runTool(
@@ -1740,9 +4272,9 @@ function registerConfiguredTools(server, apiKey = process.env.INSTAVAR_API_KEY)
 // package.json
 var package_default = {
   name: "@instavar/mcp-server",
-  version: "0.5.0",
+  version: "0.7.0",
   mcpName: "com.instavar/mcp-server",
-  description: "Make local videos with Instavar Remotion templates for free, then add an API key for hosted Studio workflows.",
+  description: "Make local videos with Instavar templates for Remotion or HyperFrames for free, then add an API key for hosted Studio workflows.",
   type: "module",
   license: "MIT",
   homepage: "https://instavar.com",
@@ -1758,6 +4290,8 @@ var package_default = {
     "model-context-protocol",
     "instavar",
     "video",
+    "remotion",
+    "hyperframes",
     "claude",
     "codex"
   ],
@@ -1817,7 +4351,7 @@ async function main() {
   const server = new McpServer(
     { name: "instavar", version: VERSION },
     {
-      instructions: "Before drafting concise carousel or video copy, call get_creative_guide for visual-copy. Use the carousel-stories, visual-design and human-review guides as relevant. Apply them to the user brief; the guides do not generate, render, save or publish media."
+      instructions: pairedAnnouncementInstructions(pairedTemplatesEnabled()) + (pairedTemplatesEnabled() ? " " + PAIRED_TEMPLATE_INSTRUCTIONS : "") + " Before drafting concise carousel or video copy, call get_creative_guide for visual-copy. Use the carousel-stories, visual-design and human-review guides as relevant. Apply them to the user brief; the guides do not generate, render, save or publish media. For an ordinary video request, call propose_video_storyboard with the user's words and an aspect, passing accepted title, body and CTA as separate fields, and show the three beats before scaffolding. The storyboard contains visual briefs, not generated images. Use scaffold_video_spec only after the user accepts or refines the direction, preserving supplied body and CTA. For a carousel, choose a structure with list_carousel_templates and build it with scaffold_carousel_deck from accepted copy."
     }
   );
   registerConfiguredTools(server);