@instavar/mcp-server 0.5.0 → 0.6.0

package/dist/index.js

@@ -1,11 +1,283 @@
 #!/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 registerPairedAnnouncement(server) {
+  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. " + PAIRED_ANNOUNCEMENT_INSTRUCTIONS,
+      inputSchema: pairedAnnouncementInput,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false
+      },
+      _meta: { securitySchemes: [{ type: "noauth" }] }
+    },
+    async (args) => {
+      try {
+        const result2 = prepareAnnouncement(args);
+        return {
+          structuredContent: result2,
+          content: [{ type: "text", text: JSON.stringify(result2) }]
+        };
+      } catch (error) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: error instanceof Error ? error.message : "Invalid announcement 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 z2 } from "zod";
 
 // src/creative-guides.generated.ts
 var CREATIVE_GUIDES = [
@@ -36,7 +308,7 @@ var CREATIVE_GUIDES = [
 ];
 
 // src/creative-guides.ts
-var creativeGuideIdSchema = z.enum([
+var creativeGuideIdSchema = z2.enum([
   "visual-copy",
   "carousel-stories",
   "visual-design",
@@ -97,7 +369,7 @@ function registerCreativeGuides(server) {
 }
 
 // src/public-templates.ts
-import { z as z2 } from "zod";
+import { z as z3 } 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";
@@ -108,8 +380,8 @@ var templateIds = [
   "social-remix",
   "finance-brief"
 ];
-var templateIdSchema = z2.enum(templateIds);
-var aspectSchema = z2.enum(["9:16", "4:5", "1:1"]);
+var templateIdSchema = z3.enum(templateIds);
+var aspectSchema = z3.enum(["9:16", "4:5", "1:1"]);
 var templates = [
   {
     id: "qa-ad",
@@ -373,6 +645,7 @@ function scaffoldVideoSpec(args) {
 }
 function registerPublicTemplateTools(server) {
   registerCreativeGuides(server);
+  registerPairedAnnouncement(server);
   server.registerTool(
     "get_capabilities",
     {
@@ -388,6 +661,7 @@ function registerPublicTemplateTools(server) {
         repository: TEMPLATE_REPOSITORY,
         endpoint: TEMPLATE_ENDPOINT,
         creativeGuides: CREATIVE_GUIDE_INDEX,
+        pairedAnnouncement: PAIRED_ANNOUNCEMENT_CAPABILITY,
         localFeatures: [
           "template discovery",
           "VideoSpec schema and examples",
@@ -486,9 +760,9 @@ ${template?.description ?? ""}`
       description: "Return a deterministic VideoSpec skeleton without writing files.",
       inputSchema: {
         templateId: templateIdSchema,
-        title: z2.string().min(1).max(160),
+        title: z3.string().min(1).max(160),
         aspect: aspectSchema.default("9:16"),
-        mediaSrc: z2.string().min(1).max(500).optional()
+        mediaSrc: z3.string().min(1).max(500).optional()
       },
       annotations
     },
@@ -506,7 +780,7 @@ ${template?.description ?? ""}`
       title: "Get local render instructions",
       description: "Return clone, install, validate, preview, and render commands.",
       inputSchema: {
-        client: z2.enum(["codex", "claude-code", "manual"]).default("manual")
+        client: z3.enum(["codex", "claude-code", "manual"]).default("manual")
       },
       annotations
     },
@@ -533,12 +807,12 @@ ${template?.description ?? ""}`
     {
       title: "Diagnose render error",
       description: "Classify a local validation or render error.",
-      inputSchema: { errorText: z2.string().min(1).max(1e4) },
+      inputSchema: { errorText: z3.string().min(1).max(1e4) },
       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";
+      const text2 = errorText.toLowerCase();
+      const code = text2.includes("enoent") || text2.includes("not found") ? "missing-file" : text2.includes("ffmpeg") || text2.includes("codec") ? "media-codec" : text2.includes("schema") || text2.includes("invalid") || text2.includes("zod") ? "invalid-video-spec" : text2.includes("chrome") || text2.includes("browser") ? "browser-runtime" : "unknown-render-error";
       return result(
         {
           code,
@@ -551,7 +825,7 @@ ${template?.description ?? ""}`
 }
 
 // src/tools.ts
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 
 // src/http.ts
 import { randomUUID } from "crypto";
@@ -597,11 +871,11 @@ function requestFailure(error) {
   return error instanceof Error ? error.message : String(error);
 }
 async function parse(res) {
-  const text = await res.text();
+  const text2 = await res.text();
   try {
-    return JSON.parse(text);
+    return JSON.parse(text2);
   } catch {
-    return text;
+    return text2;
   }
 }
 async function apiGet(path) {
@@ -625,7 +899,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)
@@ -675,7 +951,7 @@ async function runTool(fn) {
 }
 
 // src/brief-schema.ts
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 var PUBLISH_TARGETS = [
   "linkedin",
   "x",
@@ -707,16 +983,16 @@ var REFERENCE_ROLES = [
   "environment",
   "style"
 ];
-var optionalDirectionText = z3.string().trim().min(1).max(500).optional();
-var visualDirectionSchema = z3.object({
+var optionalDirectionText = z4.string().trim().min(1).max(500).optional();
+var visualDirectionSchema = z4.object({
   communicationJob: optionalDirectionText,
   emotionalTarget: optionalDirectionText,
-  attentionPath: z3.object({
+  attentionPath: z4.object({
     first: optionalDirectionText,
     next: optionalDirectionText,
     proof: optionalDirectionText
   }).optional(),
-  visualLanguage: z3.object({
+  visualLanguage: z4.object({
     space: optionalDirectionText,
     line: optionalDirectionText,
     shape: optionalDirectionText,
@@ -725,24 +1001,24 @@ var visualDirectionSchema = z3.object({
     movement: optionalDirectionText,
     rhythm: optionalDirectionText
   }).optional(),
-  camera: z3.object({
+  camera: z4.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 = z4.object({
+  globalInvariants: z4.array(z4.string().trim().min(1).max(300)).max(20).optional(),
+  shotDelta: z4.string().trim().min(1).max(500).optional(),
+  referenceBindings: z4.array(
+    z4.object({
+      assetId: z4.string().trim().min(1).max(200),
+      roles: z4.array(z4.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: z4.array(z4.string().trim().min(1).max(300)).max(20).optional(),
+  reviewCriteria: z4.array(z4.string().trim().min(1).max(300)).max(20).optional()
 });
 var REGION_NAMES = [
   "background",
@@ -759,55 +1035,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 = z4.object({
+  opacity: z4.number().min(0).max(1).optional(),
+  fit: z4.enum(["cover", "contain"]).optional(),
+  z: z4.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 = z4.object({
+  id: z4.string().min(1),
+  sceneId: z4.string().min(1).optional(),
+  region: z4.enum(REGION_NAMES),
+  role: z4.enum(ASSET_ROLES),
+  kind: z4.enum(["image", "video"]),
+  source: z4.enum(["auto", "stock", "generate"]),
+  intent: z4.string(),
   style: assetSlotStyleSchema.optional(),
-  timing: z3.object({
-    fromPct: z3.number().min(0).max(1).optional(),
-    toPct: z3.number().min(0).max(1).optional()
+  timing: z4.object({
+    fromPct: z4.number().min(0).max(1).optional(),
+    toPct: z4.number().min(0).max(1).optional()
   }).strict().optional(),
-  url: z3.string().url().optional()
+  url: z4.string().url().optional()
 }).strict();
-var briefStepSchema = z3.object({
-  label: z3.string(),
-  latex: z3.string().optional(),
-  explanation: z3.string().optional()
+var briefStepSchema = z4.object({
+  label: z4.string(),
+  latex: z4.string().optional(),
+  explanation: z4.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 = z4.object({
+  id: z4.string().min(1),
+  src: z4.string().url(),
+  startFrame: z4.number().int().nonnegative().default(0),
+  durationInFrames: z4.number().int().positive().optional(),
+  volume: z4.number().min(0).max(1).default(1),
+  fadeFrames: z4.number().int().nonnegative().default(0),
+  role: z4.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 = z4.object({
+  id: z4.string().min(1).max(80),
+  kind: z4.literal("border-glint"),
+  coordinateSpace: z4.literal("output-frame-v1").default("output-frame-v1"),
+  region: z4.object({
+    leftPercent: z4.number().min(0).max(100),
+    topPercent: z4.number().min(0).max(100),
+    widthPercent: z4.number().positive().max(100),
+    heightPercent: z4.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: z4.number().int().nonnegative().default(0),
+  endFrame: z4.number().int().positive(),
+  speedUpFrame: z4.number().int().nonnegative().optional(),
+  color: z4.string().max(64).default("#ffffff"),
+  thicknessPercent: z4.number().positive().max(20).default(3)
 }).superRefine((effect2, context) => {
   if (effect2.region.leftPercent + effect2.region.widthPercent > 100) {
     context.addIssue({
@@ -838,13 +1114,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 = z4.object({
+  intent: z4.string().trim().min(1).optional(),
+  media: z4.enum(["still", "motion"]).default("still"),
+  source: z4.enum(["auto", "stock", "generate"]).default("auto")
 }).strict();
-var briefSceneSchema = z3.object({
-  type: z3.enum([
+var briefSceneSchema = z4.object({
+  type: z4.enum([
     "hero",
     "points",
     "equation",
@@ -867,156 +1143,188 @@ var briefSceneSchema = z3.object({
     "image-window",
     "custom"
   ]),
-  durationInFrames: z3.number().optional(),
-  narrationText: z3.string().optional(),
+  layoutPreset: z4.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: z4.number().optional(),
+  narrationText: z4.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: z4.string().optional(),
+  subtitle: z4.string().optional(),
+  text: z4.string().optional(),
+  points: z4.array(z4.string()).optional(),
+  latex: z4.string().optional(),
+  value: z4.union([z4.string(), z4.number()]).optional(),
+  max: z4.number().optional(),
+  label: z4.string().optional(),
+  unit: z4.string().optional(),
+  prefix: z4.string().optional(),
+  suffix: z4.string().optional(),
+  decimals: z4.number().optional(),
+  color: z4.string().optional(),
+  tone: z4.string().optional(),
+  iconKey: z4.string().optional(),
+  stepNumber: z4.number().optional(),
+  totalSteps: z4.number().optional(),
+  items: z4.array(z4.object({ label: z4.string(), value: z4.number() })).optional(),
+  src: z4.string().optional(),
+  caption: z4.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: z4.enum(["url", "generate"]).optional(),
+  generatePrompt: z4.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: z4.number().nonnegative().optional(),
+  trimEndSeconds: z4.number().positive().optional(),
+  playbackRate: z4.number().min(0.25).max(8).optional(),
+  objectFit: z4.enum(["cover", "contain"]).optional(),
+  objectPosition: z4.string().optional(),
+  scaleFrom: z4.number().min(0.5).max(2).optional(),
+  scaleTo: z4.number().min(0.5).max(2).optional(),
+  panFromX: z4.number().min(-50).max(50).optional(),
+  panToX: z4.number().min(-50).max(50).optional(),
+  panFromY: z4.number().min(-50).max(50).optional(),
+  panToY: z4.number().min(-50).max(50).optional(),
+  routeFrom: z4.string().optional(),
+  routeTo: z4.string().optional(),
+  routeLabel: z4.string().optional(),
+  overlayKind: z4.enum(["none", "hook", "stage", "end-card"]).optional(),
+  overlayPosition: z4.enum(["center", "top", "bottom"]).optional(),
+  accentColor: z4.string().optional(),
+  overlayBackgroundColor: z4.string().optional(),
+  cutFlash: z4.boolean().optional(),
+  muted: z4.boolean().optional(),
+  protectedRegionEffects: z4.array(protectedRegionEffectSchema).max(4).optional(),
+  flashAtFrame: z4.number().int().nonnegative().optional(),
+  flashDurationFrames: z4.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 = z4.object({
+  subtitle: z4.string().optional(),
+  unitLabel: z4.string().optional(),
+  distanceTimeChip: z4.string().optional(),
+  clips: z4.array(
+    z4.object({
+      src: z4.string(),
+      trimStartSeconds: z4.number().optional(),
+      trimEndSeconds: z4.number(),
+      speed: z4.number().optional(),
+      mirrorFlip: z4.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: z4.array(
+    z4.object({
+      atSeconds: z4.number(),
+      text: z4.string(),
+      arrow: z4.enum(["left", "right", "forward"]).optional(),
+      step: z4.number().optional()
     })
   ),
-  outro: z3.object({
-    heading: z3.string().optional(),
-    body: z3.array(z3.string()).optional(),
-    seconds: z3.number().optional()
+  outro: z4.object({
+    heading: z4.string().optional(),
+    body: z4.array(z4.string()).optional(),
+    seconds: z4.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: z4.object({
+    perSegment: z4.array(
+      z4.object({
+        src: z4.string(),
+        clipIndexStart: z4.number().optional(),
+        hotOffsetSeconds: z4.number().optional(),
+        volume: z4.number().optional()
       })
     ).optional(),
-    crossfadeSeconds: z3.number().optional()
+    crossfadeSeconds: z4.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 = z4.object({
+  confirmed: z4.literal(true).describe("Must be true: the caller confirms the declaration below."),
+  wordingVersion: z4.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 = z4.object({
+  confirmed: z4.literal(true).describe("Must be true: the user accepted the warning below."),
+  kind: z4.enum(["other_person", "guardian"]).optional().describe(
+    `Which warning was accepted. "other_person" (default): "${LIKENESS_WARNING_WORDING}" "guardian": "${LIKENESS_MINOR_WARNING_WORDING}"`
+  ),
+  wordingVersion: z4.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: z4.string().min(1).max(120).describe("Short title (max 120 chars)"),
+  script: z4.string().min(1).describe("Full narration script (sent to TTS)"),
+  caption: z4.string().min(1).describe("Social caption with hooks, hashtags, CTA"),
+  publishTarget: z4.enum(PUBLISH_TARGETS).describe("Target social platform"),
+  publishTargets: z4.array(z4.enum(PUBLISH_TARGETS)).max(9).optional().describe("All allowed social destinations for this video"),
+  objective: z4.enum(BRIEF_OBJECTIVES).describe("Content objective (drives composition routing)"),
+  targetDurationSeconds: z4.number().int().min(5).max(600).optional().describe("Requested final video duration in seconds"),
+  narrationMode: z4.enum(["tts", "off"]).optional().describe("Disable synthesized narration for source-audio or silent work"),
+  lessonTitle: z4.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: z4.array(briefStepSchema).optional().describe("Structured steps for educational content (LaTeX)"),
+  scenes: z4.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: z4.enum(ASPECT_RATIOS).optional().describe("Aspect ratio (defaults to 9:16 when omitted)"),
+  compositionId: z4.string().optional().describe("Remotion composition ID override (advanced)"),
+  voiceId: z4.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: z4.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: z4.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: z4.string().uuid().describe("The job to edit"),
+  personConsent: personConsentSchema.optional(),
+  likenessAcknowledgement: likenessAcknowledgementSchema.optional(),
+  title: z4.string().optional().describe("Updated title"),
+  script: z4.string().optional().describe("Updated narration script"),
+  caption: z4.string().optional().describe("Updated social caption"),
+  lessonTitle: z4.string().optional().describe("Updated lesson title"),
+  narrationMode: z4.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: z4.array(briefStepSchema).optional().describe("Updated steps (replaces the array)"),
+  scenes: z4.array(briefSceneSchema).optional().describe("Updated scenes (replaces the array)"),
+  aspectRatio: z4.enum(ASPECT_RATIOS).optional().describe("Updated aspect ratio"),
+  objective: z4.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: z4.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: z4.array(z4.enum(PUBLISH_TARGETS)).max(9).optional().describe("Replacement allowed social destination list"),
+  targetDurationSeconds: z4.number().int().min(5).max(600).optional().describe("Updated final video duration in seconds"),
+  voiceId: z4.string().optional().describe(
     "Updated TTS narrator voice ID. Triggers a re-render with the new voice."
   ),
-  assetSlots: z3.array(assetSlotSchema).optional().describe(
+  assetSlots: z4.array(assetSlotSchema).optional().describe(
     "Replacement storyboard asset slots. Omit to preserve existing slots; pass [] to clear them."
   ),
-  audioLayers: z3.array(briefAudioLayerSchema).optional().describe(
+  audioLayers: z4.array(briefAudioLayerSchema).optional().describe(
     "Replacement typed audio layers. Omit to preserve existing layers; pass [] to clear them."
   )
 };
@@ -1124,165 +1432,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 z5 } from "zod";
+var id = z5.string().min(1).max(120);
+var point = z5.object({ x: z5.number().min(0).max(1), y: z5.number().min(0).max(1) }).strict();
+var polygonShape = z5.object({
+  kind: z5.literal("polygon"),
+  points: z5.array(point).min(3).max(512)
 }).strict();
-var rasterShape = z4.object({
-  kind: z4.literal("raster"),
-  source: z4.object({
+var rasterShape = z5.object({
+  kind: z5.literal("raster"),
+  source: z5.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: z5.string().regex(/^[a-f0-9]{64}$/),
+    sourceRange: z5.object({
+      startFrame: z5.number().int().nonnegative(),
+      endFrame: z5.number().int().positive()
     }).strict().optional()
   }).strict(),
-  widthPx: z4.number().int().positive().max(8192),
-  heightPx: z4.number().int().positive().max(8192)
+  widthPx: z5.number().int().positive().max(8192),
+  heightPx: z5.number().int().positive().max(8192)
 }).strict();
-var shape = z4.discriminatedUnion("kind", [polygonShape, rasterShape]);
-var mask = z4.object({
+var shape = z5.discriminatedUnion("kind", [polygonShape, rasterShape]);
+var mask = z5.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: z5.enum(["add", "subtract"]),
+  inverted: z5.boolean().default(false),
+  feather: z5.number().finite().nonnegative().max(0.25).default(0),
+  allowedSupportMargin: z5.number().finite().nonnegative().max(0.25).default(0),
+  reviewState: z5.enum(["draft", "approved", "rejected"]),
+  provenance: z5.object({
+    kind: z5.enum(["manual", "imported", "model-proposed"]),
     sourceAssetId: id.optional(),
-    modelId: z4.string().min(1).max(160).optional()
+    modelId: z5.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 = z5.object({
+  x: z5.number().min(0).max(1),
+  y: z5.number().min(0).max(1),
+  width: z5.number().positive().max(1),
+  height: z5.number().positive().max(1),
+  rotationDegrees: z5.number().min(-360).max(360),
+  opacity: z5.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: z5.number().finite().min(-2).max(2).default(0),
+  contrast: z5.number().finite().min(0.5).max(2).default(1),
+  saturation: z5.number().finite().min(0).max(2).default(1),
+  temperature: z5.number().finite().min(-1).max(1).default(0),
+  tint: z5.number().finite().min(-1).max(1).default(0)
 };
-var effect = z4.object({
+var effect = z5.object({
   id,
-  kind: z4.literal("local-colour"),
-  version: z4.literal(1),
+  kind: z5.literal("local-colour"),
+  version: z5.literal(1),
   maskId: id,
   ...colourParameters
 }).strict();
-var motionPath = z4.object({
+var motionPath = z5.object({
   id,
-  kind: z4.literal("cubic-bezier"),
-  startFrame: z4.number().int().nonnegative(),
-  endFrame: z4.number().int().positive(),
+  kind: z5.literal("cubic-bezier"),
+  startFrame: z5.number().int().nonnegative(),
+  endFrame: z5.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: z5.enum(["linear", "ease-in", "ease-out", "ease-in-out"]),
+  orientToPath: z5.boolean().default(false)
 }).strict();
-var region = z4.object({ id, shape, label: z4.string().min(1).max(160) }).strict();
+var region = z5.object({ id, shape, label: z5.string().min(1).max(160) }).strict();
 var base = { actionId: id, sceneId: id };
-var vendoredDesignActionSchema = z4.discriminatedUnion("kind", [
-  z4.object({
+var vendoredDesignActionSchema = z5.discriminatedUnion("kind", [
+  z5.object({
     ...base,
-    kind: z4.literal("set-layer-transform"),
+    kind: z5.literal("set-layer-transform"),
     layerId: id,
     transform
   }).strict(),
-  z4.object({
+  z5.object({
     ...base,
-    kind: z4.literal("set-local-colour-effect"),
+    kind: z5.literal("set-local-colour-effect"),
     effectId: id,
-    parameters: z4.object(colourParameters).strict()
+    parameters: z5.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({
+  z5.object({ ...base, kind: z5.literal("create-mask"), mask }).strict(),
+  z5.object({ ...base, kind: z5.literal("set-mask"), maskId: id, mask }).strict(),
+  z5.object({
     ...base,
-    kind: z4.literal("set-mask-review-state"),
+    kind: z5.literal("set-mask-review-state"),
     maskId: id,
-    reviewState: z4.enum(["draft", "approved", "rejected"])
+    reviewState: z5.enum(["draft", "approved", "rejected"])
   }).strict(),
-  z4.object({ ...base, kind: z4.literal("delete-mask"), maskId: id }).strict(),
-  z4.object({
+  z5.object({ ...base, kind: z5.literal("delete-mask"), maskId: id }).strict(),
+  z5.object({
     ...base,
-    kind: z4.literal("attach-effect"),
+    kind: z5.literal("attach-effect"),
     effect,
-    layerIds: z4.array(id).min(1).max(50)
+    layerIds: z5.array(id).min(1).max(50)
   }).strict(),
-  z4.object({ ...base, kind: z4.literal("remove-effect"), effectId: id }).strict(),
-  z4.object({
+  z5.object({ ...base, kind: z5.literal("remove-effect"), effectId: id }).strict(),
+  z5.object({
     ...base,
-    kind: z4.literal("set-layer-text"),
+    kind: z5.literal("set-layer-text"),
     layerId: id,
-    text: z4.string().max(1e4)
+    text: z5.string().max(1e4)
   }).strict(),
-  z4.object({
+  z5.object({
     ...base,
-    kind: z4.literal("set-layer-visibility"),
+    kind: z5.literal("set-layer-visibility"),
     layerId: id,
-    visible: z4.boolean()
+    visible: z5.boolean()
   }).strict(),
-  z4.object({
+  z5.object({
     ...base,
-    kind: z4.literal("set-layer-locked"),
+    kind: z5.literal("set-layer-locked"),
     layerId: id,
-    locked: z4.boolean()
+    locked: z5.boolean()
   }).strict(),
-  z4.object({
+  z5.object({
     ...base,
-    kind: z4.literal("set-layer-mask-ids"),
+    kind: z5.literal("set-layer-mask-ids"),
     layerId: id,
-    maskIds: z4.array(id).max(16)
+    maskIds: z5.array(id).max(16)
   }).strict(),
-  z4.object({
+  z5.object({
     ...base,
-    kind: z4.literal("set-layer-order"),
-    orderedLayerIds: z4.array(id).min(1).max(500)
+    kind: z5.literal("set-layer-order"),
+    orderedLayerIds: z5.array(id).min(1).max(500)
   }).strict(),
-  z4.object({
+  z5.object({
     ...base,
-    kind: z4.literal("set-motion-path"),
+    kind: z5.literal("set-motion-path"),
     path: motionPath,
-    layerIds: z4.array(id).max(50).default([])
+    layerIds: z5.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({
+  z5.object({ ...base, kind: z5.literal("remove-motion-path"), pathId: id }).strict(),
+  z5.object({ ...base, kind: z5.literal("set-protected-region"), region }).strict(),
+  z5.object({
     ...base,
-    kind: z4.literal("remove-protected-region"),
+    kind: z5.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 = z5.object({
+  projectId: z5.string().uuid(),
+  documentId: z5.string().uuid(),
+  includeVersions: z5.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 = z5.object({
+  projectId: z5.string().uuid(),
+  documentId: z5.string().uuid(),
+  actionGroupId: z5.string().min(1).max(120),
+  expectedVersion: z5.number().int().positive(),
+  actions: z5.array(vendoredDesignActionSchema).min(1).max(50),
+  clientCreatedAt: z5.string().datetime()
 }).strict();
 
 // src/tools.ts
-var uuid = (desc) => z5.string().uuid().describe(desc);
+var uuid = (desc) => z6.string().uuid().describe(desc);
 var READ_ONLY = {
   readOnlyHint: true,
   destructiveHint: false,
@@ -1302,8 +1610,8 @@ 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([
+        limit: z6.number().int().min(1).max(50).default(10).describe("Number of jobs to return (default 10, max 50)"),
+        status: z6.enum([
           "queued",
           "rendering",
           "draft_ready",
@@ -1368,7 +1676,7 @@ function registerTools(server) {
       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: {
         jobId: uuid("The job ID"),
-        limit: z5.number().int().min(1).max(20).default(10).describe("Max metric snapshots (default 10, max 20)")
+        limit: z6.number().int().min(1).max(20).default(10).describe("Max metric snapshots (default 10, max 20)")
       },
       annotations: READ_ONLY
     },
@@ -1384,10 +1692,10 @@ 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")
+        since: z6.string().optional().describe("ISO date \u2014 only include events after this date"),
+        provider: z6.enum(["runpod", "lambda", "r2", "wavespeed", "poyo", "all"]).default("all").describe("Filter by provider"),
+        groupBy: z6.enum(["provider", "job", "day"]).default("provider").describe("How to aggregate the summary"),
+        includeReconciliation: z6.boolean().default(false).describe("Include account-wide reconciliation events")
       },
       annotations: READ_ONLY
     },
@@ -1403,7 +1711,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: z6.object({ jobId: uuid("The job ID") }).strict(),
       annotations: READ_ONLY
     },
     async ({ jobId }) => runTool(
@@ -1483,10 +1791,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: z6.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: z6.number().int().nonnegative().describe("Use 0 when no workflow exists yet"),
+        document: z6.unknown().describe("The complete Studio workflow document")
       }).strict(),
       annotations: SAFE_WRITE
     },
@@ -1497,10 +1805,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: z6.object({
         jobId: uuid("The job ID"),
-        expectedVersion: z5.number().int().positive(),
-        patch: z5.record(z5.string(), z5.unknown())
+        expectedVersion: z6.number().int().positive(),
+        patch: z6.record(z6.string(), z6.unknown())
       }).strict(),
       annotations: SAFE_WRITE
     },
@@ -1511,9 +1819,9 @@ function registerTools(server) {
     {
       title: "Validate workflow",
       description: "Validate and compile the inspected workflow version without rendering or publishing it.",
-      inputSchema: z5.object({
+      inputSchema: z6.object({
         jobId: uuid("The job ID"),
-        expectedVersion: z5.number().int().positive()
+        expectedVersion: z6.number().int().positive()
       }).strict(),
       annotations: SAFE_WRITE
     },
@@ -1524,7 +1832,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: z6.object({ jobId: uuid("The job ID") }).strict(),
       annotations: READ_ONLY
     },
     async ({ jobId }) => runTool(
@@ -1538,10 +1846,10 @@ function registerTools(server) {
     {
       title: "Compare workflow versions",
       description: "Compare two durable workflow versions field by field.",
-      inputSchema: z5.object({
+      inputSchema: z6.object({
         jobId: uuid("The job ID"),
-        fromVersion: z5.number().int().positive(),
-        toVersion: z5.number().int().positive()
+        fromVersion: z6.number().int().positive(),
+        toVersion: z6.number().int().positive()
       }).strict(),
       annotations: READ_ONLY
     },
@@ -1565,9 +1873,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: z6.object({
         jobId: uuid("The job ID"),
-        expectedVersion: z5.number().int().positive()
+        expectedVersion: z6.number().int().positive()
       }).strict(),
       annotations: {
         readOnlyHint: false,
@@ -1624,7 +1932,7 @@ function registerTools(server) {
       inputSchema: {
         jobId: uuid("The current job ID"),
         sourceRunId: uuid("The current run ID"),
-        trigger: z5.enum(["user_requested", "verifier_recommendation"])
+        trigger: z6.enum(["user_requested", "verifier_recommendation"])
       },
       annotations: SAFE_WRITE
     },
@@ -1643,7 +1951,8 @@ function registerTools(server) {
       inputSchema: { jobId: uuid("The job ID to approve") },
       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
@@ -1660,15 +1969,25 @@ function registerTools(server) {
       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: {
         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: z6.string().min(1).optional().describe("X only. Exact reviewed video artifact ID."),
+        xCaption: z6.string().trim().min(1).max(2e3).optional().describe("X only. Exact post text approved by the user."),
+        xMadeWithAi: z6.boolean().optional().describe("X only. Enable the Made with AI disclosure."),
+        confirmXPublicPost: z6.boolean().optional().describe("True only after the user authorizes this public X post."),
+        confirmXAutomationPolicy: z6.boolean().optional().describe(
+          "True only after the user confirms the X automation policy."
+        ),
+        confirmXOriginalContent: z6.boolean().optional().describe(
+          "True only after the user confirms ownership or publishing rights."
+        ),
+        youtubePrivacyStatus: z6.enum(["private", "unlisted", "public"]).optional().describe("YouTube only. Use 'private' for safe dogfood runs."),
+        tiktokPostMode: z6.enum(["direct_publish", "draft_upload"]).optional().describe("TikTok only. Use 'draft_upload' for safe dogfood runs."),
+        connectedAccountDestinationId: z6.string().uuid().optional().describe(
           "Specific destination when the org has multiple accounts for the provider."
         ),
-        confirmSyntheticDisclosure: z5.boolean().optional().describe(
+        confirmSyntheticDisclosure: z6.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: z6.boolean().optional().describe("Set true to override a non-passing QA gate.")
       },
       annotations: {
         readOnlyHint: false,
@@ -1691,7 +2010,7 @@ 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([
+        provider: z6.enum([
           "youtube",
           "x",
           "tiktok",
@@ -1740,7 +2059,7 @@ function registerConfiguredTools(server, apiKey = process.env.INSTAVAR_API_KEY)
 // package.json
 var package_default = {
   name: "@instavar/mcp-server",
-  version: "0.5.0",
+  version: "0.6.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.",
   type: "module",
@@ -1817,7 +2136,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: PAIRED_ANNOUNCEMENT_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."
     }
   );
   registerConfiguredTools(server);