@impractical-ai/motion 0.1.7 → 0.1.9

package/dist/{stdio-XUVQKDCB.js → stdio-MJ4LTXME.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   openBrowser
-} from "./chunk-M7SHFM25.js";
+} from "./chunk-NG3Q3BYW.js";
 import {
   ApiError,
   admitMcpCall,
@@ -11,12 +11,13 @@ import {
   saveConfig,
   validateApiResponse,
   withAdmissionReceipt
-} from "./chunk-MQKW7NFI.js";
+} from "./chunk-KI5E2464.js";
 import {
+  BUILD_COMMIT,
   PACKAGE_VERSION,
   PRODUCTION_APP_URL,
   PRODUCTION_SUPABASE_URL
-} from "./chunk-Z74SLKEU.js";
+} from "./chunk-H5TR3QJN.js";
 import {
   __commonJS,
   __export,
@@ -3639,9 +3640,9 @@ var require_fast_uri = __commonJS({
       if (baseMalformed || relativeMalformed) {
         throw new Error(baseParsed.error || relativeParsed.error || "URI is malformed.");
       }
-      const resolved = resolveComponent(baseParsed, relativeParsed, schemelessOptions, true);
+      const resolved2 = resolveComponent(baseParsed, relativeParsed, schemelessOptions, true);
       schemelessOptions.skipEscape = true;
-      return serialize(resolved, schemelessOptions);
+      return serialize(resolved2, schemelessOptions);
     }
     function resolveComponent(base, relative, options, skipNormalization) {
       const target = {};
@@ -6907,7 +6908,7 @@ var require_dist = __commonJS({
 
 // src/mcp/stdio.ts
 import { readFileSync as readFileSync2 } from "node:fs";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+import { fileURLToPath } from "node:url";
 
 // node_modules/zod/v3/helpers/util.js
 var util;
@@ -25139,8 +25140,8 @@ function convertBaseSchema(schema, ctx) {
       });
     }
     ctx.processing.add(refPath);
-    const resolved = resolveRef(refPath, ctx);
-    const zodSchema2 = convertSchema(resolved, ctx);
+    const resolved2 = resolveRef(refPath, ctx);
+    const zodSchema2 = convertSchema(resolved2, ctx);
     ctx.refs.set(refPath, zodSchema2);
     ctx.processing.delete(refPath);
     return zodSchema2;
@@ -31012,1226 +31013,807 @@ var UNMETERED_MCP_TOOLS = /* @__PURE__ */ new Set([
 var encoder = new TextEncoder();
 var decoder = new TextDecoder();
 
-// src/mcp/quality-loop.ts
-var QUALITY_LOOP_ENV = "IMPRACTICAL_QUALITY_LOOP";
-var meaningful = (label, minimum = 12) => external_exports.string().trim().min(minimum, `${label} must be specific enough to direct from.`);
-var creativeContractSchema = external_exports.object({
-  audience: meaningful("audience", 3),
-  singleIdea: meaningful("singleIdea"),
-  visualProof: meaningful("visualProof"),
-  referenceStrategy: meaningful("referenceStrategy"),
-  productSource: meaningful("productSource"),
-  opening: meaningful("opening"),
-  proof: meaningful("proof"),
-  payoff: meaningful("payoff")
-});
-var qualityScoresSchema = external_exports.object({
-  narrativeClarity: external_exports.number().int().min(1).max(5),
-  visualProof: external_exports.number().int().min(1).max(5),
-  productAuthenticity: external_exports.number().int().min(1).max(5),
-  composition: external_exports.number().int().min(1).max(5),
-  legibility: external_exports.number().int().min(1).max(5),
-  pacing: external_exports.number().int().min(1).max(5),
-  referenceFidelity: external_exports.number().int().min(1).max(5),
-  technicalIntegrity: external_exports.number().int().min(1).max(5)
-});
-var qualityReviewSchema = external_exports.object({
-  reviewedRevision: external_exports.number().int().min(0),
-  singleIdea: meaningful("singleIdea"),
-  visualProof: meaningful("visualProof"),
-  referenceComparison: meaningful("referenceComparison"),
-  scores: qualityScoresSchema,
-  timestampEvidence: external_exports.array(
-    external_exports.object({
-      time: external_exports.number().min(0),
-      finding: meaningful("finding", 5)
-    })
-  ).min(3),
-  blockingIssues: external_exports.array(external_exports.string().trim().min(1))
-});
-var createQualityLoopState = () => ({
-  finalReviewByDraft: /* @__PURE__ */ new Map(),
-  finalMotionReviewByDraft: /* @__PURE__ */ new Map(),
-  lockedContentByDraft: /* @__PURE__ */ new Map(),
-  beatsByDraft: /* @__PURE__ */ new Map(),
-  referenceLedger: null
-});
-function qualityLoopEnabled(env = process.env) {
-  return !/^(0|false|off|no)$/i.test(env[QUALITY_LOOP_ENV]?.trim() ?? "");
+// src/mcp/frames.ts
+import { chromium as chromium3 } from "playwright-core";
+
+// src/mcp/browser-pool.ts
+import { cpus } from "node:os";
+import { chromium as chromium2 } from "playwright-core";
+
+// src/mcp/browser-daemon.ts
+import { spawn } from "node:child_process";
+import {
+  existsSync,
+  mkdirSync,
+  mkdtempSync,
+  readdirSync,
+  readFileSync,
+  renameSync,
+  rmSync,
+  writeFileSync
+} from "node:fs";
+import { homedir, tmpdir } from "node:os";
+import { join } from "node:path";
+import { chromium } from "playwright-core";
+var PROTOCOL = 3;
+var MAX_AGE_MS = 12 * 60 * 60 * 1e3;
+var STATE_DIR = () => join(homedir(), ".impractical");
+var ADVERT = () => join(STATE_DIR(), "frames-daemon.json");
+var LOCK = () => join(STATE_DIR(), "frames-daemon.lock");
+var CLIENTS = () => join(STATE_DIR(), "frames-clients");
+var BINARIES = () => join(STATE_DIR(), "frames-binaries.json");
+function alive(pid) {
+  if (!Number.isInteger(pid) || pid <= 0) return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error51) {
+    return error51.code === "EPERM";
+  }
 }
-var hasOpening = (times) => times.some((time3) => time3 <= 0.15);
-var hasEnding = (times, duration3) => duration3 <= 0 || times.some((time3) => time3 >= Math.max(0, duration3 - 0.25));
-function finalReviewCoverageError(times, duration3) {
-  if (times.length < 8) return "Final review needs at least 8 representative frames.";
-  if (!hasOpening(times)) return "Final review must include the opening frame at t=0.";
-  if (!hasEnding(times, duration3)) {
-    return `Final review must include a settled closing frame near t=${duration3.toFixed(2)}s.`;
+function registerClient() {
+  try {
+    mkdirSync(CLIENTS(), { recursive: true });
+    writeFileSync(join(CLIENTS(), String(process.pid)), String(Date.now()));
+  } catch {
   }
-  return null;
 }
-function recordFinalReviewCapture(state, draftId, capture) {
-  state?.finalReviewByDraft.set(draftId, capture);
+function unregisterClient() {
+  rmSync(join(CLIENTS(), String(process.pid)), { force: true });
 }
-function qualityReviewPrompt(mode, contract) {
-  const contractNote = contract ? `
-Creative contract: ${contract.singleIdea} Visual proof: ${contract.visualProof}` : "";
-  if (mode === "proof") {
-    return "\nQUALITY LOOP \u2014 PROOF-SHOT REVIEW. Judge the visible pixels, not the effort or code. Answer with timestamped evidence: (1) can a stranger understand the product transformation, (2) is the real product large and legible, (3) is the result impressive without explanatory copy, (4) is reconstructed UI clearly disclosed rather than called exact, and (5) what must change before building the rest of the film. Do not describe the shot as merely clean." + contractNote;
-  }
-  if (mode === "final") {
-    return "\nQUALITY LOOP \u2014 FINAL CRITIC REVIEW. Treat this as a fresh design-director pass. Score 1\u20135 with timestamped visible evidence: narrative clarity, visual proof, product authenticity, composition/hierarchy, legibility, pacing/variation, reference fidelity, and technical integrity. An empty opening, unreadable product UI, an unsupported marketing claim, stale/reconstructed UI presented as exact, any score below 3, or an average below 4 blocks export. Do not reward implementation effort and do not equate artifact-free with good." + contractNote;
+function otherClients() {
+  try {
+    return readdirSync(CLIENTS()).filter((name) => {
+      const pid = Number(name);
+      if (!Number.isInteger(pid) || pid === process.pid) return false;
+      if (alive(pid)) return true;
+      rmSync(join(CLIENTS(), name), { force: true });
+      return false;
+    }).length;
+  } catch {
+    return 0;
   }
-  return "\nQUALITY LOOP \u2014 LAYOUT REVIEW. Identify the primary subject at each timestamp and report clipping, unreadable text, weak occupancy, competing hierarchy, missing assets, or empty frames. Use visible evidence rather than saying the frames look clean.";
 }
-function motionCoverageFailure(input) {
-  if (!input.motionLab) return null;
-  if (!input.capture) {
-    return 'The motion lab requires full-duration motion coverage: call get_motion({ draftId, reviewMode: "final" }) and resolve the dead air and imperceptible tweens it reports before exporting.';
-  }
-  if (input.capture.revision !== input.frameReviewRevision) {
-    return `The motion review covered revision ${input.capture.revision}, but the final frame review covered revision ${input.frameReviewRevision}. Review the same revision with both.`;
+function readAdvert() {
+  try {
+    const advert = JSON.parse(readFileSync(ADVERT(), "utf8"));
+    if (advert.protocol !== PROTOCOL) return void 0;
+    return advert;
+  } catch {
+    return void 0;
   }
-  return null;
 }
-function qualityReviewFailure(input) {
-  const { draftRevision, capture, review } = input;
-  if (!capture) {
-    return 'No eligible final review exists. Call get_frames with reviewMode="final" on at least 8 timestamps including t=0 and the settled closing frame.';
+function writeAdvert(advert) {
+  mkdirSync(STATE_DIR(), { recursive: true });
+  const temp = `${ADVERT()}.${process.pid}.tmp`;
+  writeFileSync(temp, JSON.stringify(advert, null, 2));
+  renameSync(temp, ADVERT());
+}
+function clearAdvert() {
+  rmSync(ADVERT(), { force: true });
+}
+async function healthy(advert) {
+  if (!alive(advert.pid)) return false;
+  if (Date.now() - Date.parse(advert.startedAt) > MAX_AGE_MS) return false;
+  try {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 2e3);
+    const response = await fetch(`http://127.0.0.1:${advert.port}/json/version`, {
+      signal: controller.signal
+    });
+    clearTimeout(timer);
+    return response.ok;
+  } catch {
+    return false;
   }
-  if (capture.revision !== draftRevision) {
-    return `The final review covered revision ${capture.revision}, but the draft is now revision ${draftRevision}. Review the current revision again.`;
+}
+function killDaemon(advert) {
+  try {
+    process.kill(advert.pid, "SIGTERM");
+  } catch {
   }
-  if (!review) {
-    return "Attach the timestamped qualityReview scorecard required by the local quality loop.";
+  if (advert.userDataDir.includes("impractical-frames")) {
+    try {
+      rmSync(advert.userDataDir, { recursive: true, force: true });
+    } catch {
+    }
   }
-  if (review.reviewedRevision !== draftRevision) {
-    return `qualityReview says revision ${review.reviewedRevision}, but the current draft is revision ${draftRevision}.`;
+  clearAdvert();
+}
+function cachedBinary(launcher) {
+  try {
+    const cache = JSON.parse(readFileSync(BINARIES(), "utf8"));
+    const path = cache[launcher];
+    return path && existsSync(path) ? path : void 0;
+  } catch {
+    return void 0;
   }
-  if (review.blockingIssues.length) {
-    return `The review still has blocking issues: ${review.blockingIssues.join("; ")}`;
+}
+function cacheBinary(launcher, path) {
+  try {
+    mkdirSync(STATE_DIR(), { recursive: true });
+    let cache = {};
+    try {
+      cache = JSON.parse(readFileSync(BINARIES(), "utf8"));
+    } catch {
+    }
+    cache[launcher] = path;
+    writeFileSync(BINARIES(), JSON.stringify(cache, null, 2));
+  } catch {
   }
-  const scores = Object.entries(review.scores);
-  const low = scores.filter(([, score]) => score < 3);
-  if (low.length) {
-    return `Scores below 3 block export: ${low.map(([name, score]) => `${name}=${score}`).join(", ")}.`;
+}
+async function resolveBinary(launcher, options) {
+  const cached2 = cachedBinary(launcher);
+  if (cached2) return cached2;
+  const server = await chromium.launchServer(options);
+  try {
+    const path = server.process()?.spawnfile;
+    if (!path) throw new Error("Playwright launched a browser without recording its path");
+    cacheBinary(launcher, path);
+    return path;
+  } finally {
+    await server.close().catch(() => void 0);
   }
-  const average = scores.reduce((sum, [, score]) => sum + score, 0) / scores.length;
-  if (average < 4) return `Quality score average ${average.toFixed(2)} is below the 4.0 export floor.`;
-  return null;
 }
-function qualityLoopServerInstructions() {
-  return `
-
-LOCAL QUALITY LOOP IS ENABLED \u2014 this is an opt-in experiment and it is mandatory for new videos:
-1. Before create_video, write and pass its creativeContract: audience, one memorable idea, one visible proof, how the reference will be translated rather than copied, the real product source, and opening/proof/payoff beats.
-2. Build the proof beat first. Call get_frames with reviewMode="proof" and judge whether the product transformation is understandable and impressive before completing the rest.
-3. After the complete cut, call get_frames with reviewMode="final" on at least 8 representative timestamps including t=0 and the settled closing frame. Score what is visibly present; "clean" is not a verdict.
-4. Export only with a timestamped qualityReview for the exact reviewed revision. Any unresolved blocking issue, score below 3, or average below 4 must be fixed and reviewed again.
-This loop changes no scene schema or renderer behavior. It exists to stop technically valid but creatively weak cuts from self-approving.`;
+function browserArgs(executable, port, userDataDir) {
+  const shell = /headless_shell/i.test(executable);
+  return [
+    ...shell ? [] : ["--headless=new"],
+    // Playwright passes this on CI runners and containers; a hand-rolled spawn
+    // has to as well. Chrome refuses to start as root without it, and the only
+    // symptom is that the debugging port never opens — which is exactly how
+    // this first broke CI.
+    ...process.env.CI || process.getuid?.() === 0 ? ["--no-sandbox"] : [],
+    `--remote-debugging-port=${port}`,
+    `--user-data-dir=${userDataDir}`,
+    "--enable-unsafe-swiftshader",
+    "--force-color-profile=srgb",
+    "--hide-scrollbars",
+    "--mute-audio",
+    "--no-first-run",
+    "--no-default-browser-check",
+    "--disable-extensions",
+    "--disable-background-networking",
+    "--disable-component-update",
+    "--disable-default-apps",
+    "--disable-dev-shm-usage",
+    "--disable-popup-blocking",
+    "--metrics-recording-only"
+  ];
 }
-
-// src/mcp/phased-flow.ts
-var PHASED_FLOW_ENV = "IMPRACTICAL_PHASED_FLOW";
-function phasedFlowEnabled(env = process.env) {
-  return !/^(0|false|off|no)$/i.test(env[PHASED_FLOW_ENV]?.trim() ?? "");
+var delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+async function waitForPort(userDataDir, timeoutMs = 3e4) {
+  const file2 = join(userDataDir, "DevToolsActivePort");
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    try {
+      const [line] = readFileSync(file2, "utf8").split("\n");
+      const port = Number(line);
+      if (Number.isInteger(port) && port > 0) return port;
+    } catch {
+    }
+    await delay(100);
+  }
+  throw new Error("The browser never opened its debugging port.");
 }
-var meaningful2 = (label, minimum) => external_exports.string().trim().min(minimum, `${label} must be specific enough to direct from.`);
-var conceptSchema = external_exports.object({
-  /** One sentence: product, user, and the change the viewer will believe. */
-  premise: meaningful2("premise", 20),
-  /** The thing the viewer follows across the whole film (an invoice, a request…). */
-  recurringArtifact: meaningful2("recurringArtifact", 6),
-  /** Evidence gathered BEFORE inventing UI: real code, the product site, images. */
-  references: external_exports.array(
-    external_exports.object({
-      kind: external_exports.enum(["local-code", "website", "screenshot", "image-search"]),
-      detail: meaningful2("reference detail", 5)
-    })
-  ).min(1, "Gather at least one real reference before designing components."),
-  /** Every beat names a MOVE — a beat with no move is not a beat. */
-  beats: external_exports.array(
-    external_exports.object({
-      start: external_exports.number().min(0),
-      end: external_exports.number().min(0),
-      subject: meaningful2("beat subject", 3),
-      move: meaningful2("beat move", 8),
-      purpose: meaningful2("beat purpose", 5),
-      /** Declared energy: rest is legitimate stillness; high must visibly move. */
-      energy: external_exports.enum(["rest", "low", "high"]),
-      /**
-       * What happens to the elements ALREADY on stage when this beat starts:
-       * exit (and how), transform, or deliberately stay. First beat may say
-       * "empty stage". Entrances are cheap; exits are choreography, and a
-       * beat that only describes what enters leaves the last scene's props
-       * loitering in frame.
-       */
-      outgoing: meaningful2("beat outgoing (what the elements already on stage do)", 6)
-    })
-  ).min(4),
-  /**
-   * Every component the film will show, each answering: must this look 1:1
-   * real? 'exact-product' = the actual product's UI; 'realistic-class' = a
-   * real-world object class (a terminal, an invoice); 'stylized' = abstract/
-   * editorial, no reference needed. Non-stylized components MUST name the
-   * reference source that was pulled and viewed for them.
-   */
-  componentInventory: external_exports.array(
-    external_exports.object({
-      name: meaningful2("component", 3),
-      realism: external_exports.enum(["exact-product", "realistic-class", "stylized"]),
-      referenceSource: external_exports.string().trim().min(4).optional()
-    })
-  ).min(1)
-});
-var contentSchema = external_exports.object({
-  /** Every editorial line the film will show, in viewing order. Locked. */
-  lines: external_exports.array(
-    external_exports.object({
-      text: external_exports.string().trim().min(2).max(90),
-      kind: external_exports.enum(["statement", "label", "endcard"])
-    })
-  ).min(3)
-});
-function phasedGateFailure(args) {
-  if (!args.concept || !args.content) {
-    return "The phased flow requires BOTH `concept` and `content` before scaffolding. Phase 1 (concept): from the brief alone \u2014 premise, recurringArtifact, references (look for the product's real code or site FIRST), beats (each with start, end, subject, move, purpose, energy, and outgoing \u2014 what the elements already on stage do when the beat starts), componentInventory. Phase 2 (content): every editorial line the film will show, in viewing order, each marked statement/label/endcard, written so someone who has never heard of the product could repeat it. Do this BEFORE studying the engine or library. The lines are locked: the motion report diffs the rendered film against them.";
+async function spawnDaemon(launcher, executable) {
+  mkdirSync(STATE_DIR(), { recursive: true });
+  const userDataDir = mkdtempSync(join(tmpdir(), "impractical-frames-"));
+  const child = spawn(executable, browserArgs(executable, 0, userDataDir), {
+    detached: true,
+    stdio: "ignore"
+  });
+  child.unref();
+  if (!child.pid) throw new Error("Could not start a browser process.");
+  try {
+    const port = await waitForPort(userDataDir);
+    const raced = readAdvert();
+    if (raced && await healthy(raced)) {
+      try {
+        process.kill(child.pid, "SIGKILL");
+      } catch {
+      }
+      try {
+        rmSync(userDataDir, { recursive: true, force: true });
+      } catch {
+      }
+      return raced;
+    }
+    const advert = {
+      protocol: PROTOCOL,
+      pid: child.pid,
+      port,
+      userDataDir,
+      launcher,
+      executable,
+      startedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    writeAdvert(advert);
+    return advert;
+  } catch (error51) {
+    try {
+      process.kill(child.pid, "SIGKILL");
+    } catch {
+    }
+    rmSync(userDataDir, { recursive: true, force: true });
+    throw error51;
   }
-  const concept = conceptSchema.safeParse(args.concept);
-  if (!concept.success) {
-    const issue2 = concept.error.issues[0];
-    const at = issue2?.path?.length ? ` at ${issue2.path.join(".")}` : "";
-    return `concept invalid${at}: ${issue2?.message ?? "schema mismatch"}`;
+}
+function tryLock() {
+  mkdirSync(STATE_DIR(), { recursive: true });
+  try {
+    writeFileSync(LOCK(), String(Date.now()), { flag: "wx" });
+    return true;
+  } catch {
+    try {
+      const stamp = Number(readFileSync(LOCK(), "utf8"));
+      if (!Number.isFinite(stamp) || stamp <= 0) return false;
+      if (Date.now() - stamp <= 6e4) return false;
+      rmSync(LOCK(), { force: true });
+      writeFileSync(LOCK(), String(Date.now()), { flag: "wx" });
+      return true;
+    } catch {
+      return false;
+    }
   }
-  const content = contentSchema.safeParse(args.content);
-  if (!content.success) {
-    const issue2 = content.error.issues[0];
-    const at = issue2?.path?.length ? ` at ${issue2.path.join(".")}` : "";
-    return `content invalid${at}: ${issue2?.message ?? "schema mismatch"}`;
+}
+function releaseLock() {
+  rmSync(LOCK(), { force: true });
+}
+function lockHeld() {
+  return existsSync(LOCK());
+}
+async function connect(advert) {
+  return chromium.connectOverCDP(`http://127.0.0.1:${advert.port}`, { timeout: 15e3 });
+}
+async function obtain(resolve) {
+  for (let attempt = 0; attempt < 3; attempt += 1) {
+    const existing = readAdvert();
+    if (existing) {
+      if (await healthy(existing)) {
+        return { browser: await connect(existing), advert: existing };
+      }
+      killDaemon(existing);
+    }
+    if (!tryLock()) {
+      const adopted = await waitForAdvert();
+      if (adopted) return adopted;
+      continue;
+    }
+    try {
+      const fresh = readAdvert();
+      if (fresh && await healthy(fresh)) {
+        return { browser: await connect(fresh), advert: fresh };
+      }
+      const launcher = await resolve();
+      const executable = await resolveBinary(launcher.name, launcher.options);
+      const advert = await spawnDaemon(launcher.name, executable);
+      return { browser: await connect(advert), advert };
+    } finally {
+      releaseLock();
+    }
   }
-  const missing = concept.data.componentInventory.filter(
-    (component) => component.realism !== "stylized" && !component.referenceSource
+  throw new Error(
+    "Could not obtain a shared browser: another process held the start lock and never advertised one. Remove ~/.impractical/frames-daemon.lock and retry."
   );
-  if (missing.length) {
-    return `concept invalid: these components are marked as needing realism but have no referenceSource: ${missing.map((component) => component.name).join(", ")}. For each, pull a real reference image (gather_references / your image search), VIEW it, and record its source \u2014 or mark the component stylized if it genuinely needs no real-world counterpart.`;
+}
+async function waitForAdvert() {
+  for (let attempt = 0; attempt < 60; attempt += 1) {
+    await delay(500);
+    const advert = readAdvert();
+    if (advert && await healthy(advert)) {
+      return { browser: await connect(advert), advert };
+    }
+    if (!lockHeld()) return void 0;
   }
-  return null;
+  return void 0;
 }
-var CONTENT_DOCTRINE_ENV = "IMPRACTICAL_CONTENT_DOCTRINE";
-function contentDoctrineEnabled(env = process.env) {
-  return !/^(0|false|off|no)$/i.test(env[CONTENT_DOCTRINE_ENV]?.trim() ?? "");
+async function detach(browser) {
+  await browser?.close().catch(() => void 0);
 }
-var contentDoctrine = () => contentDoctrineEnabled() ? ` Write every line so a smart 16-year-old who has never heard of the product gets it on first read \u2014 if they couldn't repeat it back in their own words, rewrite it. No insider jargon: name what the thing DOES in plain words, not its category ("your agent gets its own email address", never "agentic email infrastructure"). Say it, then show it: a statement makes ONE plain claim, and the very next thing the film does is prove that claim on camera. One thing to read at a time \u2014 never two lines competing for the same moment.` : " Write them plain enough for someone who has never heard of the product.";
-var contentTextRule = () => contentDoctrineEnabled() ? " That floor governs EDITORIAL lines \u2014 the film's own statements and labels \u2014 and it is not a ban on words inside the product you are showing. Recreate the product's own content as real, plausible words at whatever size the real interface uses. NEVER replace product content with grey placeholder bars or skeleton rectangles: a wireframe reads as a loading screen, and a film that claims the software works while showing an empty shell has proved nothing. Small real text is what makes an interface look real; the rule is that the viewer must never NEED to read it, not that it must be absent." : "";
-function phasedServerInstructions() {
-  return `
-
-PHASED FLOW IS ENABLED \u2014 work in three phases, in order:
-1. CONCEPT \u2014 from the brief alone, before engine_types or motion_context: FIRST study references, then call gather_references (required \u2014 create_video refuses without it). If you have native web/image search and an image-viewing tool, USE THEM: search real screenshots of the product in use and of each component class, download and VIEW them before designing anything. Hunt references of the ACTUAL SOFTWARE, not the marketing homepage \u2014 the product's real front-end code on this machine (pass it as appCode) \u2192 screenshots of the product IN USE (its app/editor/dashboard, found via its docs, help center, changelog, demo videos, review sites) \u2192 its site code \u2192 marketing site (styling tokens only) \u2192 real images of the component class \u2192 mockups; design components to match what the references actually show. Then ask of every component the film will show: MUST THIS LOOK 1:1 REAL? Product UI and real-world objects (a terminal, an invoice, a dashboard) do; abstract backdrops and statement cards do not. For each realism-required component, pull a real reference image, VIEW it, and record it as that component's referenceSource in the inventory. Then write the premise, the one recurring artifact the viewer follows, and beats where every beat names a MOVE, declares its energy (rest / low / high) \u2014 rest is legitimate stillness, high must visibly move; the motion report verdicts each beat against its declaration \u2014 and declares its OUTGOING: what the elements already on stage do when this beat starts. Nothing new enters without saying what the things still showing do \u2014 exit (and how), transform into the new thing, or deliberately stay. Entrances are cheap; exits are choreography. A beat that only describes what arrives leaves the last scene's props loitering in frame. The first beat may say "empty stage".
-2. CONTENT \u2014 write every editorial line of the film in viewing order (statement/label/endcard).${contentDoctrine()} Statements are the big lines the film is built around \u2014 10-15% of frame height each; no text anyone MUST read below 4% unless the user explicitly asks.${contentTextRule()} These lines are LOCKED once passed to create_video: the motion report flags any on-screen line that is not in the list, and any listed line the camera never shows.
-RUNTIME \u2014 when the user gives no duration, plan 20-30 seconds and EARN it with at least two distinct proof chapters (different capabilities or angles), never by stretching holds. A user-specified runtime always wins.
-3. CREATION \u2014 only now read engine_types and motion_context. Call install_kits on the new draft FIRST and import the primitives from './kit/*' \u2014 the cursor actor, showpieces, looks and sentence typography are already built and tuned; hand-rolling them produces cursors that teleport and clicks that fire early. Then cast the beats onto the library and kits, build, measure, revise, review, export.
-create_video requires the concept and content artifacts and will refuse without them.`;
+function lastOneOut() {
+  unregisterClient();
+  if (otherClients() > 0) return;
+  const advert = readAdvert();
+  if (advert) killDaemon(advert);
 }
 
-// src/mcp/preflight.ts
-var esbuildPromise = null;
-function loadEsbuild() {
-  esbuildPromise ??= import("./main-BEONOBG5.js").then(
-    (mod) => mod,
-    () => null
+// src/mcp/browser-pool.ts
+var CANDIDATES = [
+  { name: "chromium-headless-shell", options: { channel: "chromium-headless-shell", headless: true } },
+  { name: "chromium", options: { headless: true } },
+  {
+    name: "system-chrome",
+    options: { channel: "chrome", headless: true },
+    advice: "Frame capture is using your installed Google Chrome because no Playwright browser is available. Run `npx playwright install chromium-headless-shell` for a smaller, faster browser that is not shared with your own."
+  }
+];
+var resolved;
+function launcherCandidates() {
+  const forced = process.env.PLAYWRIGHT_CHANNEL?.trim();
+  if (forced) return [{ name: `channel:${forced}`, options: { channel: forced, headless: true } }];
+  const exe = process.env.IMPRACTICAL_CHROMIUM?.trim();
+  if (exe) return [{ name: `executable:${exe}`, options: { executablePath: exe, headless: true } }];
+  if (process.env.CI) return CANDIDATES.filter((candidate) => candidate.name !== "system-chrome");
+  return CANDIDATES;
+}
+async function resolveLauncher() {
+  if (resolved) return resolved;
+  const advert = readAdvert();
+  if (advert) {
+    const known = launcherCandidates().find((candidate) => candidate.name === advert.launcher);
+    if (known) {
+      resolved = known;
+      return known;
+    }
+  }
+  return pickLauncher();
+}
+function firstLine(error51) {
+  return String(error51 instanceof Error ? error51.message : error51).split("\n")[0].slice(0, 160);
+}
+function noBrowser(failures) {
+  if (process.env.CI) {
+    return new Error(
+      "CI requires the Playwright-managed Chromium pinned by cli/package-lock.json. Run `npx playwright-core install chromium-headless-shell`; the system Chrome fallback is disabled in CI.\nTried:\n  " + failures.join("\n  ")
+    );
+  }
+  return new Error(
+    "No usable Chromium found for frame capture. Install one with `npx playwright install chromium-headless-shell`, or install Google Chrome. If Chrome is present but blocked by Gatekeeper, set PLAYWRIGHT_CHANNEL=chrome. You can also point IMPRACTICAL_CHROMIUM at a browser binary directly.\nTried:\n  " + failures.join("\n  ")
   );
-  return esbuildPromise;
 }
-var LOADERS = {
-  ".tsx": "tsx",
-  ".ts": "ts",
-  ".jsx": "jsx",
-  ".js": "js",
-  ".css": "css",
-  ".json": "json"
-};
-function resolveDraftPath(files, request) {
-  const clean = request.replace(/^\.\//, "");
-  const candidates = [
-    clean,
-    `${clean}.ts`,
-    `${clean}.tsx`,
-    `${clean}.js`,
-    `${clean}.jsx`,
-    `${clean}/index.ts`,
-    `${clean}/index.tsx`
-  ];
-  return candidates.find((candidate) => candidate in files) ?? null;
+var registered = false;
+var exitHooked = false;
+var local;
+async function pickLauncher() {
+  const failures = [];
+  for (const candidate of launcherCandidates()) {
+    try {
+      const probe = await chromium2.launch(candidate.options);
+      await probe.close().catch(() => void 0);
+      resolved = candidate;
+      return candidate;
+    } catch (error51) {
+      failures.push(`${candidate.name}: ${firstLine(error51)}`);
+    }
+  }
+  throw noBrowser(failures);
 }
-async function preflightDraft(files) {
-  const esbuild = await loadEsbuild();
-  if (!esbuild) return null;
-  const entries = ["App.tsx", "direction.ts"].filter((entry) => entry in files);
-  if (!entries.length) return null;
+async function attachLocal() {
+  if (!local) {
+    local = (async () => {
+      const launcher2 = resolved ?? await pickLauncher();
+      return chromium2.launch(launcher2.options);
+    })();
+  }
   try {
-    await esbuild.build({
-      entryPoints: entries.map((entry) => `draft:${entry}`),
-      bundle: true,
-      write: false,
-      // write:false never touches disk; outdir is still required for multiple entries.
-      outdir: "preflight-virtual",
-      platform: "browser",
-      format: "esm",
-      logLevel: "silent",
-      plugins: [
-        {
-          name: "draft-virtual-fs",
-          setup(build) {
-            build.onResolve({ filter: /^draft:/ }, (args) => ({
-              path: args.path.slice("draft:".length),
-              namespace: "draft"
-            }));
-            build.onResolve({ filter: /.*/ }, (args) => {
-              if (args.namespace !== "draft") return void 0;
-              if (args.path.startsWith("./")) {
-                const dir = args.importer.includes("/") ? args.importer.slice(0, args.importer.lastIndexOf("/") + 1) : "";
-                const joined = dir + args.path.slice(2);
-                const resolved = resolveDraftPath(files, joined);
-                if (resolved) return { path: resolved, namespace: "draft" };
-                return {
-                  errors: [
-                    {
-                      text: `"${args.path}" (from ${args.importer}) does not match any draft file. Draft files: ${Object.keys(files).sort().join(", ")}`
-                    }
-                  ]
-                };
-              }
-              return { path: args.path, external: true };
-            });
-            build.onLoad({ filter: /.*/, namespace: "draft" }, (args) => {
-              const ext = args.path.slice(args.path.lastIndexOf("."));
-              return {
-                contents: files[args.path],
-                loader: LOADERS[ext] ?? "ts"
-              };
-            });
-          }
-        }
-      ]
+    const browser = await local;
+    if (browser.isConnected()) return { browser, shared: false };
+  } catch {
+  }
+  local = void 0;
+  const launcher = resolved ?? await pickLauncher();
+  local = chromium2.launch(launcher.options);
+  return { browser: await local, shared: false };
+}
+async function attach() {
+  if (!exitHooked) {
+    exitHooked = true;
+    process.once("exit", lastOneOut);
+    for (const signal of ["SIGINT", "SIGTERM"]) {
+      process.once(signal, () => {
+        lastOneOut();
+        process.exit(0);
+      });
+    }
+  }
+  if (local) return attachLocal();
+  try {
+    const { browser, advert } = await obtain(async () => {
+      const launcher = await pickLauncher();
+      return { name: launcher.name, options: launcher.options };
     });
-    return null;
+    if (!resolved) {
+      resolved = launcherCandidates().find((candidate) => candidate.name === advert.launcher) ?? { name: advert.launcher, options: {} };
+    }
+    if (!registered) {
+      registerClient();
+      registered = true;
+    }
+    return { browser, shared: true };
   } catch (error51) {
-    const message = error51 instanceof Error ? error51.message : String(error51);
-    return message;
+    if (/No usable Chromium|CI requires the Playwright-managed/.test(String(error51))) throw error51;
+    return attachLocal();
   }
 }
-
-// src/mcp/tools.ts
-var json2 = (value) => ({ text: JSON.stringify(value, null, 2) });
-var fail = (text) => ({ text, isError: true });
-var nap = (ctx, ms) => ctx.sleep ? ctx.sleep(ms) : new Promise((resolve) => setTimeout(resolve, ms));
-var TERMINAL = /* @__PURE__ */ new Set(["completed", "failed", "canceled"]);
-var POLL_ERROR_LIMIT = 5;
-var JOB_WAIT_SECONDS = 300;
-var BRAND_WAIT_SECONDS = 300;
-var MAX_WAIT_SECONDS = 540;
-var maxWaitSeconds = () => {
-  const override = Number(process.env.IMPRACTICAL_MAX_WAIT_SECONDS);
-  return Number.isFinite(override) && override > 0 ? override : MAX_WAIT_SECONDS;
-};
-function waitBudgetMs(requested, fallbackSeconds) {
-  const asked = Number(requested);
-  const seconds = Number.isFinite(asked) && asked > 0 ? asked : fallbackSeconds;
-  return Math.min(seconds, maxWaitSeconds()) * 1e3;
+function browserVanished(error51) {
+  return /has been closed|Target (page|browser).*closed|Connection closed|disconnected|ECONNREFUSED/i.test(
+    String(error51 instanceof Error ? error51.message : error51)
+  );
 }
-var waitWasClamped = (requested) => {
-  const asked = Number(requested);
-  return Number.isFinite(asked) && asked > maxWaitSeconds();
-};
-var clampNote = (requested) => waitWasClamped(requested) ? ` Waiting was capped at ${maxWaitSeconds()}s (you asked for ${Number(requested)}s) because MCP clients drop a request that stays open too long, which would report this job as failed while it is still running.` : "";
-function describeJob(jobId, row, consecutiveErrors, lastError) {
-  if (consecutiveErrors) return `${jobId}: status check failed (${lastError}), retrying`;
-  const stage = row?.stage ? ` \u2014 ${row.stage}` : "";
-  const pct = typeof row?.progress === "number" ? ` ${Math.round(row.progress * 100)}%` : "";
-  return `${jobId}: ${row?.status ?? "queued"}${stage}${pct}`;
+var MAX_CONCURRENT = Math.max(1, Math.min(4, (cpus()?.length ?? 4) - 2));
+var active = 0;
+var waiting = [];
+async function enter() {
+  if (active < MAX_CONCURRENT) {
+    active += 1;
+    return;
+  }
+  await new Promise((resolve) => waiting.push(resolve));
+  active += 1;
 }
-var resumeWith = (jobId) => `job_status({ jobIds: ["${jobId}"], wait: true })`;
-var getDraft = (ctx, draftId) => ctx.invoke("get-draft", { draftId });
-var studioLink = (ctx, projectId, slug) => {
-  const base = (ctx.appUrl ?? "https://motion.impractical.ai").replace(/\/$/, "");
-  return `${base}/projects/${projectId}/studio${slug ? `?scene=${slug}` : ""}`;
-};
-async function saveDraft(ctx, draftId, apply) {
-  let conflicts = 0;
-  while (true) {
-    const draft = await getDraft(ctx, draftId);
-    if (draft.lockedByJobId) {
-      return fail(
-        `Draft ${draftId} is locked by job ${draft.lockedByJobId}. Wait for it with job_status({ jobIds: ["${draft.lockedByJobId}"], wait: true }), then retry.`
-      );
-    }
-    const change = apply(draft);
-    const changedCount = Object.keys(change.files).length;
-    if (!changedCount && !change.deletedPaths.length) {
-      return { text: `No change \u2014 the draft already matches at revision ${draft.revision}.` };
+function leave() {
+  active -= 1;
+  const next = waiting.shift();
+  if (next) next();
+}
+async function acquireContext(viewport = { width: 1920, height: 1080 }) {
+  await enter();
+  let attached;
+  let context;
+  try {
+    attached = await attach();
+    try {
+      context = await attached.browser.newContext({ viewport, deviceScaleFactor: 1 });
+    } catch (error51) {
+      if (!browserVanished(error51)) throw error51;
+      if (attached.shared) await detach(attached.browser);
+      attached = await attach();
+      context = await attached.browser.newContext({ viewport, deviceScaleFactor: 1 });
     }
-    const merged = { ...draft.files, ...change.files };
-    for (const deleted of change.deletedPaths) delete merged[deleted];
-    const preflightError = await preflightDraft(merged);
-    if (preflightError) {
-      return fail(
-        "Local build preflight failed \u2014 nothing was sent to the cloud, fix and save again:\n" + preflightError
+  } catch (error51) {
+    if (attached?.shared) await detach(attached.browser);
+    leave();
+    throw error51;
+  }
+  const owned = attached;
+  let released = false;
+  const release = async () => {
+    if (released) return;
+    released = true;
+    await context?.close().catch(() => void 0);
+    if (owned.shared) await detach(owned.browser);
+    leave();
+  };
+  return { context, release };
+}
+async function launcherAdvice() {
+  try {
+    return (await resolveLauncher()).advice;
+  } catch {
+    return void 0;
+  }
+}
+
+// src/mcp/frames.ts
+var PREVIEW_ORIGIN = "https://preview.impractical.local";
+var PREVIEW_URL = `${PREVIEW_ORIGIN}/stage.html`;
+var FRAME_TYPE = "jpeg";
+var FRAME_QUALITY = 80;
+var FRAME_MIME = "image/jpeg";
+async function launchChromium(launcher = chromium3) {
+  if (process.env.CI) {
+    try {
+      return await launcher.launch({ headless: true });
+    } catch (error51) {
+      throw new Error(
+        "CI requires the Playwright-managed Chromium pinned by cli/package-lock.json. Run `npx playwright-core install chromium`; system Chrome fallback is disabled in CI.",
+        { cause: error51 }
       );
     }
+  }
+  if (process.env.PLAYWRIGHT_CHANNEL === "chrome") {
+    return launcher.launch({ channel: "chrome", headless: true });
+  }
+  try {
+    return await launcher.launch({ headless: true });
+  } catch {
     try {
-      const saved = await ctx.invoke("save-draft", {
-        draftId,
-        expectedRevision: draft.revision,
-        files: change.files,
-        deletedPaths: change.deletedPaths
-      });
-      ctx.qualityLoopState?.finalReviewByDraft.delete(draftId);
-      ctx.qualityLoopState?.finalMotionReviewByDraft.delete(draftId);
-      return reportBuildStart(
-        draftId,
-        saved,
-        changedCount,
-        change.deletedPaths.length
-      );
+      return await launcher.launch({ channel: "chrome", headless: true });
     } catch (error51) {
-      const status = error51.status;
-      const message = error51 instanceof Error ? error51.message : String(error51);
-      if (status === 409 && conflicts < 1 && !/locked by an active job/i.test(message)) {
-        conflicts += 1;
-        continue;
-      }
-      if (status === 409) {
-        return fail(
-          `Save rejected (409): ${message}. The draft changed underneath this edit \u2014 re-read the file and re-apply your change on top of the new content.`
-        );
-      }
-      throw error51;
+      throw new Error(
+        `No usable Chromium found for frame capture. Install Google Chrome, or run \`npx playwright install chromium\`. If Chrome is installed but blocked by Gatekeeper, set PLAYWRIGHT_CHANNEL=chrome.
+Underlying error: ${error51 instanceof Error ? error51.message : String(error51)}`
+      );
     }
   }
 }
-function reportBuildStart(draftId, saved, changed, deleted) {
-  const summary = `Saved ${changed} file(s)` + (deleted ? `, deleted ${deleted}` : "") + ` as revision ${saved.revision}.`;
-  if (!saved.jobId) {
-    return json2({
-      committed: true,
-      draftId,
-      revision: saved.revision,
-      jobId: null,
-      previewQueued: false,
-      summary,
-      note: "No preview build was queued \u2014 a draft needs both App.tsx and direction.ts before it can render."
-    });
-  }
-  return json2({
-    committed: true,
-    draftId,
-    revision: saved.revision,
-    jobId: saved.jobId,
-    previewQueued: true,
-    status: "queued",
-    summary,
-    resumeWith: resumeWith(saved.jobId),
-    note: "The save committed. Do not re-apply it. Follow the preview build with resumeWith; if a transport timeout ever hides a mutation reply, read the changed file before retrying."
-  });
-}
-var accountStatus = {
-  name: "account_status",
-  title: "Show account, plan, and MCP usage",
-  description: "Show the connected workspace, current role, plan, weekly MCP usage, reset time, seats, and billing state. Run this once at the start of a session to confirm the connection works.",
-  inputSchema: {},
-  handler: async (_args, ctx) => json2(await ctx.invoke("workspace-bootstrap"))
-};
-var whoami = {
-  ...accountStatus,
-  name: "whoami",
-  title: "Show the connected workspace (legacy alias)",
-  description: "Deprecated alias for account_status. Use account_status to show the connected workspace, plan, weekly MCP usage, reset time, seats, and billing state."
-};
-var upgradeTool = {
-  name: "upgrade",
-  title: "Explain Pro and get the billing link",
-  description: "Explain what Pro costs and unlocks for this workspace, and return the authenticated billing URL. Only a workspace admin can buy \u2014 checking out subscribes the whole workspace. Set open=true only after the user explicitly asks to open it in their browser.",
-  inputSchema: {
-    open: external_exports.boolean().optional().describe("Open billing in the user's browser. Defaults to false.")
-  },
-  local: true,
-  handler: async (args, ctx) => {
-    const url2 = `${(ctx.appUrl ?? "https://motion.impractical.ai").replace(/\/$/, "")}/account/billing`;
-    const account = await ctx.invoke("workspace-bootstrap").catch(() => null);
-    const role = account?.role === "admin" ? "admin" : "member";
-    const canPurchase = role === "admin";
-    const plan = account?.plan ?? "free";
-    const seats = Math.max(1, account?.billing?.seatCount ?? 1);
-    const limit = account?.quota?.limit ?? FREE_WEEKLY_LIMIT;
-    const remaining = account?.quota?.remaining ?? 0;
-    const opened = args.open === true ? ctx.openExternal?.(url2) ?? false : false;
-    return json2({
-      plan,
-      role,
-      canPurchase,
-      price: { amountUsd: 50, per: "user / month" },
-      billedFor: `${seats} seat${seats === 1 ? "" : "s"} \u2014 every admin and member is a paid seat`,
-      unlocks: [
-        "Unlimited videos and exports \u2014 no weekly ceiling",
-        "Iterate on one video as many times as it takes",
-        "A dedicated allowance per person, not shared across workspaces"
-      ],
-      // Exact, because we meter calls. How many videos that is depends on how
-      // hard they iterate, so do not turn it into a per-user video count.
-      freePlanNow: limit >= 1e6 ? "This workspace is already on Pro." : `${remaining} of ${limit} free calls left this week (${FREE_WEEKLY_VIDEO_ESTIMATE}).`,
-      url: url2,
-      opened,
-      instructions: "Summarise the value in one or two sentences, then give the URL. Do not open a browser unless asked. " + (canPurchase ? "Checking out subscribes the whole workspace \u2014 say so before they act on it." : "Only a workspace admin can approve the purchase, so tell this user to ask an admin to upgrade.")
-    });
-  }
-};
-var listProjects = {
-  name: "list_projects",
-  title: "List video projects",
-  description: "List video projects in the connected workspace, newest first. Large workspaces: pass limit/offset to page instead of relying on a truncated dump, and nameFilter to search.",
-  inputSchema: {
-    limit: external_exports.number().int().min(1).max(200).optional().describe("Return at most this many projects (default: all)."),
-    offset: external_exports.number().int().min(0).optional().describe("Skip this many projects, for paging."),
-    nameFilter: external_exports.string().optional().describe("Case-insensitive substring match on the project name/slug.")
-  },
-  handler: async (args, ctx) => {
-    const result = await ctx.invoke("list-projects", {});
-    let projects = result.projects ?? [];
-    const total = projects.length;
-    const filter = typeof args.nameFilter === "string" ? args.nameFilter.trim().toLowerCase() : "";
-    if (filter) {
-      projects = projects.filter(
-        (project) => `${project.name ?? ""} ${project.slug ?? ""}`.toLowerCase().includes(filter)
+async function renderSettledFrame(page, time3) {
+  await page.evaluate(
+    (seconds) => (async () => {
+      const stage = window;
+      if (stage.__renderAt) stage.__renderAt(seconds);
+      else stage.__seek(seconds);
+      if (stage.__frameSettle) {
+        await stage.__frameSettle();
+      } else {
+        await new Promise((resolve) => {
+          const pending = [...document.querySelectorAll("video")].filter(
+            (video) => video.currentSrc && !video.error && video.seeking
+          );
+          if (!pending.length) {
+            resolve();
+            return;
+          }
+          let finished = false;
+          let remaining = pending.length;
+          const finish = () => {
+            if (finished) return;
+            finished = true;
+            clearTimeout(cap);
+            resolve();
+          };
+          const cap = setTimeout(finish, 1e3);
+          for (const video of pending) {
+            video.addEventListener(
+              "seeked",
+              () => {
+                remaining -= 1;
+                if (remaining === 0) finish();
+              },
+              { once: true }
+            );
+          }
+        });
+      }
+      await new Promise(
+        (resolve) => requestAnimationFrame(() => requestAnimationFrame(() => resolve()))
       );
-    }
-    const matched = projects.length;
-    const offset = typeof args.offset === "number" ? args.offset : 0;
-    const limit = typeof args.limit === "number" ? args.limit : projects.length;
-    projects = projects.slice(offset, offset + limit);
-    return json2({
-      total,
-      matched,
-      offset,
-      returned: projects.length,
-      hasMore: offset + projects.length < matched,
-      projects
+    })(),
+    time3
+  );
+}
+async function captureReferenceFrames(input) {
+  const { context, release } = await acquireContext({ width: 1920, height: 1080 });
+  try {
+    const page = await context.newPage();
+    const base = input.appUrl.replace(/\/$/, "");
+    const url2 = `${base}/stage.html?scene=${encodeURIComponent(input.scene)}`;
+    await page.goto(url2, { waitUntil: "load", timeout: 6e4 });
+    await page.waitForFunction(() => window.__ready === true, void 0, {
+      timeout: 6e4
     });
-  }
-};
-var getProject = {
-  name: "get_project",
-  title: "Get one project",
-  description: "Get one project with its drafts (each draft is one cut of the video) and recent jobs. Use this to find the draftId you need for the editing tools.",
-  inputSchema: { projectId: external_exports.string().describe("The project id.") },
-  handler: async (args, ctx) => json2(await ctx.invoke("list-projects", { projectId: args.projectId }))
-};
-var createVideo = {
-  name: "create_video",
-  title: "Create a video project",
-  description: "Create a new video project and an empty draft for you to direct. This does NOT run Impractical's own director \u2014 it scaffolds App.tsx, direction.ts and brand.json and hands them to you. Read the `impractical://engine.d.ts` resource, then write the scene yourself with edit_draft_file / write_draft_files.",
-  inputSchema: {
-    valueProp: external_exports.string().min(1).describe("One or two sentences on what ships and why it matters."),
-    name: external_exports.string().optional().describe("Human-readable project name. Defaults to the slug."),
-    slug: external_exports.string().optional().describe("URL-safe project slug. Generated when omitted."),
-    vibe: external_exports.string().optional().describe("Tone, e.g. 'confident'. Defaults to 'confident'."),
-    brandSlug: external_exports.string().optional().describe("Brand kit slug from brand_list. Its colors and fonts become brand.json."),
-    appCode: external_exports.string().optional().describe("The product's front-end code, used as the starting point for App.tsx."),
-    templateId: external_exports.string().optional().describe("Template id recommended by motion_context. Defaults to a blank direction."),
-    templateParams: external_exports.record(external_exports.string(), external_exports.string()).optional().describe("Parameters for templateId, using the schema returned by motion_context."),
-    motionContextId: external_exports.string().optional().describe(
-      "contextId from the motion_context result. Pins the draft to the personalized recommendations that produced it. Omit to resolve a fresh context."
-    ),
-    creativeContract: creativeContractSchema.optional().describe(
-      "Required only when the local quality-loop experiment is enabled: the audience, one memorable idea, visible proof, reference strategy, product source, and opening/proof/payoff."
-    ),
-    concept: conceptSchema.optional().describe(
-      "Required only when the phased flow is enabled: premise, recurringArtifact, references, beats (each with a MOVE), and componentInventory \u2014 authored from the brief alone."
-    ),
-    content: contentSchema.optional().describe(
-      "Required only when the phased flow is enabled: every editorial line in viewing order (claim/label/endcard). Locked \u2014 the motion report diffs the film against these lines."
-    )
-  },
-  handler: async (args, ctx) => {
-    if (ctx.qualityLoop && !args.creativeContract) {
-      return fail(
-        "The local quality loop requires creativeContract before scaffolding. Name the audience, singleIdea, visualProof, referenceStrategy, productSource, opening, proof, and payoff. This is a planning gate only; it does not change the scene schema."
-      );
-    }
-    if (ctx.phasedFlow) {
-      const gate = phasedGateFailure({ concept: args.concept, content: args.content });
-      if (gate) return fail(gate);
-      if (!ctx.qualityLoopState?.referenceLedger) {
-        return fail(
-          "The phased flow requires gather_references BEFORE create_video: record the real references this film is designed against (or an honest noneFound after exhausting the ladder: local code -> product site -> screenshots -> component-class images)."
-        );
-      }
+    const config2 = await page.evaluate(() => window.__config);
+    if (config2?.width && config2?.height) {
+      await page.setViewportSize({ width: config2.width, height: config2.height });
     }
-    let brand = null;
-    if (args.brandSlug) {
-      const result = await ctx.invoke("brand-kits", {
-        action: "get",
-        slug: args.brandSlug
-      });
-      brand = result.brand;
+    const duration3 = Number(await page.evaluate(() => window.__duration)) || 0;
+    const count = Math.max(1, Math.min(input.count ?? 4, 6));
+    const times = Array.from(
+      { length: count },
+      (_, index) => duration3 > 0 ? index / Math.max(1, count - 1) * Math.max(0, duration3 - 0.05) : index
+    );
+    const images = [];
+    for (const time3 of times) {
+      await renderSettledFrame(page, time3);
+      const frame = await page.screenshot({ type: FRAME_TYPE, quality: FRAME_QUALITY });
+      images.push({ base64: frame.toString("base64"), mimeType: FRAME_MIME });
     }
-    const valueProp = String(args.valueProp).trim();
-    const slug = args.slug ?? `${valueProp.toLowerCase().replace(/[^a-z0-9\s-]/g, "").trim().split(/\s+/).slice(0, 4).join("-") || "video"}-${Math.floor(Math.random() * 65536).toString(16).padStart(4, "0")}`;
-    const prepared = await ctx.invoke("prepare-generation", {
-      name: (args.name ?? slug).replace(/[-_]/g, " "),
-      slug,
-      valueProp,
-      vibe: args.vibe ?? "confident",
-      directorIds: ["d1"],
-      append: false,
-      appCode: args.appCode,
-      brand,
-      templateId: args.templateId,
-      templateParams: args.templateParams,
-      ...args.motionContextId ? { motionContextId: args.motionContextId } : {}
+    return { images, duration: duration3 };
+  } finally {
+    await release();
+  }
+}
+function normalizeBundle(html) {
+  return html.replace(
+    "style-src 'unsafe-inline';",
+    "style-src 'unsafe-inline' https://fonts.googleapis.com;"
+  ).replace("font-src data:;", "font-src data: https://fonts.gstatic.com;");
+}
+var INLINEABLE = /\.(png|jpe?g|gif|webp|svg|mp4|webm|mov|woff2)$/i;
+function skippedMedia(html, slug) {
+  const pattern = new RegExp(`/scenes/${slug.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}/[^"'\\s)]+`, "g");
+  return [...new Set(html.match(pattern) ?? [])].filter((path) => INLINEABLE.test(path));
+}
+async function resolvePreview(ctx, draftId) {
+  const draft = await ctx.invoke("get-draft", { draftId });
+  const result = await ctx.invoke("list-projects", { projectId: draft.projectId });
+  const row = result.project.drafts.find((entry) => entry.id === draftId);
+  const preview = (row?.artifacts ?? []).find((artifact) => artifact.kind === "preview");
+  if (!preview?.url) {
+    throw new Error(
+      `Draft ${draftId} has no preview bundle yet. Save App.tsx and direction.ts with write_draft_files, wait for the build to finish, then capture frames.`
+    );
+  }
+  return {
+    url: preview.url,
+    slug: draft.slug,
+    revision: draft.revision,
+    artifactRevision: preview.source_revision
+  };
+}
+async function openPreview(ctx, draftId) {
+  const preview = await resolvePreview(ctx, draftId);
+  const warnings = [];
+  if (preview.artifactRevision !== preview.revision) {
+    warnings.push(
+      `The preview bundle is at revision ${preview.artifactRevision} but the draft is at ${preview.revision}. These frames show older code \u2014 save again and wait for the build.`
+    );
+  }
+  const response = await fetch(preview.url);
+  if (!response.ok) {
+    throw new Error(
+      `Preview download failed (${response.status}). Signed preview URLs expire after 15 minutes; retry to get a fresh one.`
+    );
+  }
+  const html = normalizeBundle(await response.text());
+  const skipped = skippedMedia(html, preview.slug);
+  if (skipped.length) {
+    warnings.push(
+      `The preview omits ${skipped.length} asset(s) that were too large to inline (${skipped.join(", ")}). They render blank or black here but will be correct in the exported MP4.`
+    );
+  }
+  const advice = await launcherAdvice();
+  if (advice) warnings.push(advice);
+  const { context, release } = await acquireContext({ width: 1920, height: 1080 });
+  try {
+    const page = await context.newPage();
+    await page.route(
+      `${PREVIEW_ORIGIN}/**`,
+      (route) => route.fulfill({ status: 200, contentType: "text/html; charset=utf-8", body: html })
+    );
+    await page.goto(PREVIEW_URL, { waitUntil: "load", timeout: 6e4 });
+    await page.waitForFunction(() => window.__ready === true, void 0, {
+      timeout: 6e4
     });
-    const draft = prepared.drafts[0];
-    if (ctx.phasedFlow && draft?.id && args.content) {
-      const parsedContent = contentSchema.safeParse(args.content);
-      if (parsedContent.success) {
-        ctx.qualityLoopState?.lockedContentByDraft.set(draft.id, parsedContent.data.lines);
-      }
-      const parsedConcept = conceptSchema.safeParse(args.concept);
-      if (parsedConcept.success) {
-        ctx.qualityLoopState?.beatsByDraft.set(
-          draft.id,
-          parsedConcept.data.beats.map((beat) => ({
-            start: beat.start,
-            end: beat.end,
-            subject: beat.subject,
-            energy: beat.energy
-          }))
-        );
-      }
+    const config2 = await page.evaluate(() => window.__config);
+    if (config2?.width && config2?.height) {
+      await page.setViewportSize({ width: config2.width, height: config2.height });
     }
-    return json2({
-      projectId: prepared.projectId,
-      draftId: draft?.id,
-      slug: draft?.slug,
-      starterFiles: prepared.starterFiles,
-      libraryVersion: prepared.libraryVersion,
-      engineVersion: prepared.engineVersion,
-      studioUrl: studioLink(ctx, prepared.projectId, draft?.slug),
-      ...ctx.qualityLoop ? {
-        creativeContract: args.creativeContract,
-        qualityLoop: {
-          enabled: true,
-          next: 'Build the proof beat first, then call get_frames with reviewMode="proof" before completing the full film.'
-        }
-      } : {},
-      next: ctx.qualityLoop ? "Read impractical://engine.d.ts, build the proof beat first, then review it before completing the film." : "Read impractical://engine.d.ts, then write App.tsx and direction.ts."
-    });
-  }
-};
-var listDraftFiles = {
-  name: "list_draft_files",
-  title: "List a draft's files",
-  description: "List the source files of a draft with their sizes and the current revision. Cheap orientation \u2014 prefer this over reading every file. If notes.json is present, it holds the user's queued timecoded edit requests \u2014 read it before directing.",
-  inputSchema: { draftId: external_exports.string().describe("The draft id.") },
-  handler: async (args, ctx) => {
-    const draft = await getDraft(ctx, String(args.draftId));
-    return json2({
-      draftId: draft.draftId,
-      projectId: draft.projectId,
-      slug: draft.slug,
-      status: draft.status,
-      revision: draft.revision,
-      lockedByJobId: draft.lockedByJobId,
-      files: Object.entries(draft.files).map(([path, content]) => ({ path, bytes: Buffer.byteLength(content, "utf8") })).sort((a, b) => a.path.localeCompare(b.path))
+    const duration3 = Number(await page.evaluate(() => window.__duration)) || 0;
+    const fps = Number(config2?.fps) || 30;
+    const fontsFailed = await page.evaluate(async () => {
+      await document.fonts.ready;
+      return [...document.fonts].some((font) => font.status === "error");
     });
-  }
-};
-var readDraftFile = {
-  name: "read_draft_file",
-  title: "Read one draft file",
-  description: "Read the contents of a single file in a draft. notes.json, when present, is the user's edit queue: [{ id, at, text, done, mentions? }] \u2014 timecoded requests written while watching. Address open items and set done: true on each one you handle.",
-  inputSchema: {
-    draftId: external_exports.string().describe("The draft id."),
-    path: external_exports.string().describe("File path within the draft, e.g. 'direction.ts'."),
-    startLine: external_exports.number().int().min(1).optional().describe("1-based first line to return \u2014 page large files instead of truncating."),
-    lineCount: external_exports.number().int().min(1).optional().describe("Number of lines to return from startLine.")
-  },
-  handler: async (args, ctx) => {
-    const draft = await getDraft(ctx, String(args.draftId));
-    const path = String(args.path);
-    const content = draft.files[path];
-    if (content === void 0) {
-      return fail(
-        `No file "${path}" in draft ${args.draftId}. Available: ${Object.keys(draft.files).sort().join(", ")}`
+    if (fontsFailed) {
+      warnings.push(
+        "Some web fonts failed to load, so typography in these frames is not final. Frame capture needs network access to fonts.googleapis.com."
       );
     }
-    const lines = content.split("\n");
-    const startLine = typeof args.startLine === "number" ? Math.max(1, args.startLine) : 1;
-    const lineCount = typeof args.lineCount === "number" ? Math.max(1, args.lineCount) : lines.length;
-    if (startLine === 1 && lineCount >= lines.length) return { text: content };
-    const slice = lines.slice(startLine - 1, startLine - 1 + lineCount);
-    if (slice.length === 0) {
-      return {
-        text: `[no lines returned: startLine ${startLine} is beyond ${lines.length} lines \u2014 page with startLine/lineCount]`
-      };
+    return { context, page, duration: duration3, fps, revision: preview.artifactRevision, warnings, release };
+  } catch (error51) {
+    await release();
+    throw error51;
+  }
+}
+async function captureFrames(ctx, input) {
+  const session = await openPreview(ctx, input.draftId);
+  const { page, duration: duration3, warnings, revision } = session;
+  try {
+    const images = [];
+    for (const time3 of input.times) {
+      const clamped = duration3 > 0 ? Math.max(0, Math.min(time3, duration3)) : Math.max(0, time3);
+      await renderSettledFrame(page, clamped);
+      const frame = await page.screenshot({ type: FRAME_TYPE, quality: FRAME_QUALITY });
+      images.push({ base64: frame.toString("base64"), mimeType: FRAME_MIME });
     }
+    return { images, warnings, revision, duration: duration3 };
+  } finally {
+    await session.release();
+  }
+}
+var MEASURE_REPORT_CAP = 48;
+async function measureStage(ctx, draftId) {
+  const session = await openPreview(ctx, draftId);
+  try {
+    await renderSettledFrame(session.page, 0);
+    const probe = await session.page.evaluate(
+      ({ cap }) => {
+        let tweenCount = 0;
+        const countLeaves = (node) => {
+          for (const child of node.getChildren?.(false, true, true) ?? []) {
+            if (typeof child.getChildren === "function") countLeaves(child);
+            else tweenCount += 1;
+          }
+        };
+        const root = window.__timeline;
+        if (root && typeof root.getChildren === "function") countLeaves(root);
+        const width = window.innerWidth;
+        const height = window.innerHeight;
+        const seen = /* @__PURE__ */ new Map();
+        const elements = [];
+        let truncated = 0;
+        for (const el of Array.from(document.querySelectorAll("*"))) {
+          const attr = Array.from(el.attributes).find(
+            (a) => a.name.startsWith("data-") && !a.name.startsWith("data-studio-")
+          );
+          if (!attr) continue;
+          const base = attr.value ? `[${attr.name}="${attr.value}"]` : `[${attr.name}]`;
+          const count = (seen.get(base) ?? 0) + 1;
+          seen.set(base, count);
+          if (elements.length >= cap) {
+            truncated += 1;
+            continue;
+          }
+          const sel = count > 1 ? `${base}~${count}` : base;
+          const rect = el.getBoundingClientRect();
+          const style = getComputedStyle(el);
+          const hidden = rect.width * rect.height < 1 || style.display === "none" || style.visibility === "hidden" || Number(style.opacity) < 0.02;
+          const offstage = !hidden && (rect.right <= 0 || rect.bottom <= 0 || rect.left >= width || rect.top >= height);
+          elements.push({
+            sel,
+            x: rect.x,
+            y: rect.y,
+            w: rect.width,
+            h: rect.height,
+            ...hidden ? { hidden: true } : {},
+            ...offstage ? { offstage: true } : {}
+          });
+        }
+        return { tweenCount, elements, truncated };
+      },
+      { cap: MEASURE_REPORT_CAP }
+    );
     return {
-      text: `[lines ${startLine}-${startLine - 1 + slice.length} of ${lines.length} \u2014 page with startLine/lineCount]
-` + slice.join("\n")
+      revision: session.revision,
+      duration: session.duration,
+      tweenCount: probe.tweenCount,
+      elements: probe.elements,
+      truncated: probe.truncated
     };
+  } finally {
+    await session.release();
   }
-};
-var writeDraftFiles = {
-  name: "write_draft_files",
-  title: "Write draft files",
-  description: "Create or overwrite whole files in a draft, and optionally delete others. Returns the committed revision and preview-build job id immediately; follow that id with job_status. Prefer edit_draft_file for small changes. Only .ts/.tsx/.js/.jsx/.css/.json paths sync, max 100 files per draft. Never edit project.json.",
-  inputSchema: {
-    draftId: external_exports.string().describe("The draft id."),
-    files: external_exports.record(external_exports.string(), external_exports.string()).describe("Map of file path to full file content."),
-    deletedPaths: external_exports.array(external_exports.string()).optional().describe("Paths to remove from the draft.")
-  },
-  handler: async (args, ctx) => {
-    const files = args.files ?? {};
-    const deletedPaths = args.deletedPaths ?? [];
-    return saveDraft(ctx, String(args.draftId), () => ({ files, deletedPaths }));
-  }
-};
-var editDraftFile = {
-  name: "edit_draft_file",
-  title: "Edit one draft file",
-  description: "Replace an exact string in one draft file. The read, the edit and the write happen in a single call against the current revision, so concurrent edits from the web tweak chat cannot clobber yours. Returns the committed revision and preview-build job id immediately; follow that id with job_status.",
+}
+var getFramesTool = {
+  name: "get_frames",
+  title: "See rendered frames",
+  description: "Render frames of the draft at the given times (in seconds) and return them as images, so you can SEE your work instead of guessing. Runs on this machine against the cloud preview bundle \u2014 it needs Chrome installed. Ask for several times in one call: the frames are nearly free once the page is open. Always look at frames before telling the user a change is done.",
   inputSchema: {
     draftId: external_exports.string().describe("The draft id."),
-    path: external_exports.string().describe("File path within the draft, e.g. 'direction.ts'."),
-    oldString: external_exports.string().describe("Exact text to replace. Must appear in the file."),
-    newString: external_exports.string().describe("Replacement text."),
-    replaceAll: external_exports.boolean().optional().describe("Replace every occurrence. Default false, which requires a unique match.")
+    times: external_exports.array(external_exports.number().min(0)).min(1).max(12).describe("Timeline positions in seconds, e.g. [0, 1.5, 3]."),
+    reviewMode: external_exports.enum(["layout", "proof", "final"]).optional().describe(
+      "Opt-in quality-loop lens. proof judges the core transformation before the full film; final requires broad timeline coverage and produces export-eligible review evidence."
+    )
   },
+  local: true,
   handler: async (args, ctx) => {
-    const path = String(args.path);
-    const oldString = String(args.oldString);
-    const newString = String(args.newString);
-    let problem = null;
-    const output = await saveDraft(
-      ctx,
-      String(args.draftId),
-      (draft) => {
-        const content = draft.files[path];
-        if (content === void 0) {
-          problem = `No file "${path}" in this draft. Available: ${Object.keys(draft.files).sort().join(", ")}`;
-          return { files: {}, deletedPaths: [] };
-        }
-        const occurrences = content.split(oldString).length - 1;
-        if (occurrences === 0) {
-          problem = `oldString was not found in ${path}. Read the file and match its exact text.`;
-          return { files: {}, deletedPaths: [] };
-        }
-        if (occurrences > 1 && !args.replaceAll) {
-          problem = `oldString appears ${occurrences} times in ${path}. Add more surrounding context to make it unique, or pass replaceAll: true.`;
-          return { files: {}, deletedPaths: [] };
+    const capture = await captureFrames(ctx, {
+      draftId: String(args.draftId),
+      times: args.times
+    });
+    ctx.sessionState?.lastCaptureByDraft.set(String(args.draftId), {
+      revision: capture.revision,
+      times: [...args.times]
+    });
+    const lines = [
+      `Captured ${capture.images.length} frame(s) at revision ${capture.revision} (scene duration ${capture.duration.toFixed(2)}s).`,
+      ...capture.warnings.map((warning) => `WARNING: ${warning}`)
+    ];
+    const reviewMode = args.reviewMode;
+    if (ctx.qualityLoop) {
+      if (!reviewMode) {
+        lines.push(
+          'QUALITY LOOP: choose reviewMode="proof" for the core proof beat or reviewMode="final" for the export review.'
+        );
+      } else {
+        if (reviewMode === "final") {
+          const coverageError = finalReviewCoverageError(args.times, capture.duration);
+          const stalePreview = capture.warnings.some(
+            (warning) => warning.startsWith("The preview bundle is at revision ")
+          );
+          if (stalePreview) {
+            lines.push(
+              "QUALITY REVIEW NOT RECORDED: these frames came from a stale preview bundle. Wait for the current revision to build, then review it again."
+            );
+          } else if (coverageError) {
+            lines.push(`QUALITY REVIEW NOT RECORDED: ${coverageError}`);
+          } else {
+            recordFinalReviewCapture(ctx.qualityLoopState, String(args.draftId), {
+              revision: capture.revision,
+              duration: capture.duration,
+              times: [...args.times]
+            });
+            lines.push(
+              `FINAL REVIEW RECORDED for revision ${capture.revision}. Any later edit invalidates this evidence.`
+            );
+          }
         }
-        const next = args.replaceAll ? content.split(oldString).join(newString) : content.replace(oldString, newString);
-        return { files: { [path]: next }, deletedPaths: [] };
+        lines.push(qualityReviewPrompt(reviewMode));
       }
-    );
-    return problem ? fail(problem) : output;
-  }
-};
-var jobStatus = {
-  name: "job_status",
-  title: "Check job status",
-  description: "Check Impractical Motion jobs (preview builds, exports). Set wait to poll until they finish.",
-  inputSchema: {
-    jobIds: external_exports.array(external_exports.string()).min(1).max(20).describe("Job ids to check."),
-    wait: external_exports.boolean().optional().describe("Poll until every job reaches a terminal state."),
-    waitSeconds: external_exports.number().optional().describe(`Polling budget when wait is true. Default ${JOB_WAIT_SECONDS}, capped at ${maxWaitSeconds()}s. When the budget runs out the call returns the job ids instead of failing \u2014 call it again to keep waiting.`)
-  },
-  handler: async (args, ctx, progress) => {
-    const jobIds = args.jobIds;
-    if (!args.wait) return json2(await ctx.invoke("job-status", { jobIds }));
-    const budgetMs = waitBudgetMs(args.waitSeconds, JOB_WAIT_SECONDS);
-    const now = ctx.now ?? Date.now;
-    const started = now();
-    const deadline = started + budgetMs;
-    let rows = [];
-    let consecutiveErrors = 0;
-    let lastError = "";
-    while (now() < deadline) {
-      if (progress?.signal?.aborted) break;
-      try {
-        const result = await ctx.invoke("job-status", { jobIds });
-        rows = result.jobs;
-        consecutiveErrors = 0;
-        if (rows.length && rows.every((row) => TERMINAL.has(row.status))) return json2(rows);
-      } catch (error51) {
-        lastError = error51 instanceof Error ? error51.message : String(error51);
-        if (++consecutiveErrors >= POLL_ERROR_LIMIT) {
-          return json2({ pollError: lastError, stillRunning: jobIds, jobs: rows });
-        }
-      }
-      progress?.report?.({
-        progress: Math.min(now() - started, budgetMs),
-        total: budgetMs,
-        message: rows.length ? rows.map((row) => describeJob(row.id, row, consecutiveErrors, lastError)).join("; ") : jobIds.join(", ")
-      });
-      const remainingMs = deadline - now();
-      if (remainingMs > 0) await nap(ctx, Math.min(2e3, remainingMs));
-    }
-    return json2({
-      timedOut: true,
-      stillRunning: jobIds,
-      jobs: rows,
-      resumeWith: `job_status({ jobIds: ${JSON.stringify(jobIds)}, wait: true })`,
-      note: "The jobs are still running in the cloud \u2014 this is a pause, not a failure. Call the command in resumeWith to keep following them." + clampNote(args.waitSeconds)
-    });
-  }
-};
-var exportVideo = {
-  name: "export_video",
-  title: "Export the final MP4",
-  description: "Start the final MP4 render and return its job id immediately. Follow that id with job_status for the signed download URL. Only export once the user is happy with the frames.",
-  inputSchema: {
-    draftId: external_exports.string().describe("The draft id."),
-    qualityReview: qualityReviewSchema.optional().describe(
-      "Required only by the opt-in local quality loop: the exact reviewed revision, creative claim/proof, reference comparison, eight category scores, timestamp evidence, and blockers."
-    )
-  },
-  handler: async (args, ctx) => {
-    if (ctx.qualityLoop) {
-      const capture = ctx.qualityLoopState?.finalReviewByDraft.get(String(args.draftId));
-      const failure = qualityReviewFailure({
-        draftRevision: capture?.revision ?? -1,
-        capture,
-        review: args.qualityReview
-      }) ?? motionCoverageFailure({
-        motionLab: ctx.motionLab === true,
-        capture: ctx.qualityLoopState?.finalMotionReviewByDraft.get(String(args.draftId)),
-        frameReviewRevision: capture?.revision ?? -1
-      });
-      if (failure) return fail(`Quality gate blocked export: ${failure}`);
-    }
-    const started = await ctx.invoke("start-export", { draftId: args.draftId });
-    return json2({
-      started: true,
-      draftId: String(args.draftId),
-      jobId: started.jobId,
-      status: "queued",
-      resumeWith: resumeWith(started.jobId),
-      note: "Export started. Do not start another export. Follow this job with resumeWith to obtain the signed download URL."
-    });
-  }
-};
-var brandList = {
-  name: "brand_list",
-  title: "List brand kits",
-  description: "List the brand kits saved in this workspace.",
-  inputSchema: {},
-  handler: async (_args, ctx) => json2(await ctx.invoke("brand-kits", { action: "list" }))
-};
-var brandGet = {
-  name: "brand_get",
-  title: "Get a brand kit",
-  description: "Get one brand kit \u2014 its colors, fonts and logo. Treat these as law when directing.",
-  inputSchema: { slug: external_exports.string().describe("Brand kit slug.") },
-  handler: async (args, ctx) => json2(await ctx.invoke("brand-kits", { action: "get", slug: args.slug }))
-};
-var brandExtract = {
-  name: "brand_extract",
-  title: "Extract a brand kit from a URL",
-  description: "Start extracting a brand kit (colors, fonts, logo) from a website and return the run id immediately. To observe an existing run, call this tool with jobId instead of url; that status mode never starts another extraction.",
-  inputSchema: {
-    url: external_exports.string().optional().describe("The brand website URL. Omit when continuing by jobId."),
-    jobId: external_exports.string().optional().describe("Run id returned by a previous brand_extract call."),
-    reextract: external_exports.boolean().optional().describe("Re-extract even if a kit already exists."),
-    wait: external_exports.boolean().optional().describe("With jobId, poll until this extraction is terminal."),
-    waitSeconds: external_exports.number().optional().describe(
-      `With jobId and wait, poll for up to ${BRAND_WAIT_SECONDS}s by default, capped at ${maxWaitSeconds()}s.`
-    )
-  },
-  handler: async (args, ctx, progress) => {
-    const url2 = typeof args.url === "string" ? args.url : "";
-    const jobId = typeof args.jobId === "string" ? args.jobId : "";
-    if (url2 && jobId) return fail("Pass either url to start or jobId to continue, not both.");
-    if (!url2 && !jobId) return fail("Pass url to start an extraction, or jobId to continue one.");
-    if (url2) {
-      const started = await ctx.invoke("brand-extraction", {
-        action: "start",
-        url: url2,
-        ...args.reextract ? { reextract: true } : {}
-      });
-      return json2({
-        started: true,
-        jobId: started.job,
-        slug: started.slug,
-        status: "queued",
-        resumeWith: `brand_extract({ jobId: "${started.job}", wait: true })`,
-        note: "Brand extraction started. Do not call brand_extract with the URL again. Continue this exact run with resumeWith, then pass the completed slug to create_video as brandSlug."
-      });
-    }
-    const readStatus = () => ctx.invoke("brand-extraction", { action: "status", job: jobId });
-    if (!args.wait) {
-      const status = await readStatus();
-      if (status.status === "error" || status.status === "failed" || status.error) {
-        return fail(`Brand extraction failed${status.error ? `: ${status.error}` : ""}`);
-      }
-      return json2({ jobId, ...status });
-    }
-    const budgetMs = waitBudgetMs(args.waitSeconds, BRAND_WAIT_SECONDS);
-    const startedAt = Date.now();
-    const deadline = startedAt + budgetMs;
-    let consecutiveErrors = 0;
-    let lastError = "";
-    let stage = "";
-    let lastStatus = {};
-    while (Date.now() < deadline) {
-      if (progress?.signal?.aborted) break;
-      try {
-        const status = await readStatus();
-        lastStatus = status;
-        consecutiveErrors = 0;
-        stage = status.stage ?? stage;
-        if (status.status === "done") {
-          return json2({ jobId, ...status });
-        }
-        if (status.status === "error" || status.status === "failed" || status.error) {
-          return fail(`Brand extraction failed${status.error ? `: ${status.error}` : ""}`);
-        }
-      } catch (error51) {
-        lastError = error51 instanceof Error ? error51.message : String(error51);
-        if (++consecutiveErrors >= POLL_ERROR_LIMIT) break;
-      }
-      progress?.report?.({
-        progress: Math.min(Date.now() - startedAt, budgetMs),
-        total: budgetMs,
-        message: `brand run ${jobId}: ${stage || "extracting"}`
-      });
-      await nap(ctx, 2e3);
-    }
-    return json2({
-      timedOut: true,
-      jobId,
-      status: lastStatus,
-      ...lastError ? { pollError: lastError } : {},
-      resumeWith: `brand_extract({ jobId: "${jobId}", wait: true })`,
-      note: "The extraction is still running \u2014 this is a pause, not a failure. Continue the same run with resumeWith; never call brand_extract with the URL again for this run." + clampNote(args.waitSeconds)
-    });
-  }
-};
-var motionProfile = {
-  name: "motion_profile",
-  title: "Manage the personal motion profile",
-  description: "Inspect and manage the user's learned motion preferences. Call with action 'get' to see the effective profile before directing. Use 'remember' ONLY when the user explicitly asks to remember a preference; use 'propose' to submit an inferred preference as a pending proposal for the user to confirm \u2014 never confirm an inferred preference yourself. 'confirm'/'reject' decide a pending proposal after asking the user; 'forget', 'pause', 'resume' and 'reset' manage stored preferences on the user's behalf.",
-  inputSchema: {
-    action: external_exports.enum(["get", "remember", "propose", "confirm", "reject", "forget", "pause", "resume", "reset"]).describe("The profile command to run."),
-    rule: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe(
-      "Structured preference for remember/propose, e.g. {kind:'trait',trait:'pacing',value:'fast'}, {kind:'library',itemType:'style',itemId:'optical',stance:'prefer'}, {kind:'freeform',text:'...'}, {kind:'duration',max:15}, or {kind:'example',draftId:'...'}."
-    ),
-    eventId: external_exports.string().optional().describe("Pending proposal id for confirm/reject."),
-    ruleKey: external_exports.string().optional().describe("Rule key to forget, from the get result."),
-    scope: external_exports.enum(["workspace", "brand", "user", "user_brand"]).optional().describe("Target layer. Defaults to the personal layer; shared layers need admin."),
-    brandSlug: external_exports.string().optional().describe("Brand slug for brand-scoped preferences."),
-    contentType: external_exports.string().optional().describe("Content type this preference applies to."),
-    draftId: external_exports.string().optional().describe("Draft that motivated a proposal.")
-  },
-  handler: async (args, ctx) => json2(await ctx.invoke("motion-profile", args))
-};
-var studioLinkTool = {
-  name: "studio_link",
-  title: "Get the studio URL",
-  description: "Get the web studio URL where the user watches the cuts and tweaks them visually. Always give this to the user after a change lands.",
-  inputSchema: {
-    projectId: external_exports.string().describe("The project id."),
-    slug: external_exports.string().optional().describe("Draft slug to open directly.")
-  },
-  handler: async (args, ctx) => ({
-    text: studioLink(ctx, String(args.projectId), args.slug)
-  })
-};
-var REMOTE_SAFE_TOOLS = [
-  accountStatus,
-  whoami,
-  listProjects,
-  getProject,
-  createVideo,
-  listDraftFiles,
-  readDraftFile,
-  writeDraftFiles,
-  editDraftFile,
-  jobStatus,
-  exportVideo,
-  brandList,
-  brandGet,
-  brandExtract,
-  motionProfile,
-  studioLinkTool
-];
-
-// src/mcp/frames.ts
-import { chromium } from "playwright-core";
-var PREVIEW_ORIGIN = "https://preview.impractical.local";
-var PREVIEW_URL = `${PREVIEW_ORIGIN}/stage.html`;
-var FRAME_TYPE = "jpeg";
-var FRAME_QUALITY = 80;
-var FRAME_MIME = "image/jpeg";
-async function launchChromium(launcher = chromium) {
-  if (process.env.CI) {
-    try {
-      return await launcher.launch({ headless: true });
-    } catch (error51) {
-      throw new Error(
-        "CI requires the Playwright-managed Chromium pinned by cli/package-lock.json. Run `npx playwright-core install chromium`; system Chrome fallback is disabled in CI.",
-        { cause: error51 }
-      );
-    }
-  }
-  if (process.env.PLAYWRIGHT_CHANNEL === "chrome") {
-    return launcher.launch({ channel: "chrome", headless: true });
-  }
-  try {
-    return await launcher.launch({ headless: true });
-  } catch {
-    try {
-      return await launcher.launch({ channel: "chrome", headless: true });
-    } catch (error51) {
-      throw new Error(
-        `No usable Chromium found for frame capture. Install Google Chrome, or run \`npx playwright install chromium\`. If Chrome is installed but blocked by Gatekeeper, set PLAYWRIGHT_CHANNEL=chrome.
-Underlying error: ${error51 instanceof Error ? error51.message : String(error51)}`
-      );
-    }
-  }
-}
-async function renderSettledFrame(page, time3) {
-  await page.evaluate(
-    (seconds) => (async () => {
-      const stage = window;
-      if (stage.__renderAt) stage.__renderAt(seconds);
-      else stage.__seek(seconds);
-      if (stage.__frameSettle) {
-        await stage.__frameSettle();
-      } else {
-        await new Promise((resolve) => {
-          const pending = [...document.querySelectorAll("video")].filter(
-            (video) => video.currentSrc && !video.error && video.seeking
-          );
-          if (!pending.length) {
-            resolve();
-            return;
-          }
-          let finished = false;
-          let remaining = pending.length;
-          const finish = () => {
-            if (finished) return;
-            finished = true;
-            clearTimeout(cap);
-            resolve();
-          };
-          const cap = setTimeout(finish, 1e3);
-          for (const video of pending) {
-            video.addEventListener(
-              "seeked",
-              () => {
-                remaining -= 1;
-                if (remaining === 0) finish();
-              },
-              { once: true }
-            );
-          }
-        });
-      }
-      await new Promise(
-        (resolve) => requestAnimationFrame(() => requestAnimationFrame(() => resolve()))
-      );
-    })(),
-    time3
-  );
-}
-async function captureReferenceFrames(input) {
-  const browser = await launchChromium();
-  try {
-    const page = await browser.newPage({
-      viewport: { width: 1920, height: 1080 },
-      deviceScaleFactor: 1
-    });
-    const base = input.appUrl.replace(/\/$/, "");
-    const url2 = `${base}/stage.html?scene=${encodeURIComponent(input.scene)}`;
-    await page.goto(url2, { waitUntil: "load", timeout: 6e4 });
-    await page.waitForFunction(() => window.__ready === true, void 0, {
-      timeout: 6e4
-    });
-    const config2 = await page.evaluate(() => window.__config);
-    if (config2?.width && config2?.height) {
-      await page.setViewportSize({ width: config2.width, height: config2.height });
-    }
-    const duration3 = Number(await page.evaluate(() => window.__duration)) || 0;
-    const count = Math.max(1, Math.min(input.count ?? 4, 6));
-    const times = Array.from(
-      { length: count },
-      (_, index) => duration3 > 0 ? index / Math.max(1, count - 1) * Math.max(0, duration3 - 0.05) : index
-    );
-    const images = [];
-    for (const time3 of times) {
-      await renderSettledFrame(page, time3);
-      const frame = await page.screenshot({ type: FRAME_TYPE, quality: FRAME_QUALITY });
-      images.push({ base64: frame.toString("base64"), mimeType: FRAME_MIME });
-    }
-    return { images, duration: duration3 };
-  } finally {
-    await browser.close().catch(() => void 0);
-  }
-}
-function normalizeBundle(html) {
-  return html.replace(
-    "style-src 'unsafe-inline';",
-    "style-src 'unsafe-inline' https://fonts.googleapis.com;"
-  ).replace("font-src data:;", "font-src data: https://fonts.gstatic.com;");
-}
-var INLINEABLE = /\.(png|jpe?g|gif|webp|svg|mp4|webm|mov|woff2)$/i;
-function skippedMedia(html, slug) {
-  const pattern = new RegExp(`/scenes/${slug.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}/[^"'\\s)]+`, "g");
-  return [...new Set(html.match(pattern) ?? [])].filter((path) => INLINEABLE.test(path));
-}
-async function resolvePreview(ctx, draftId) {
-  const draft = await ctx.invoke("get-draft", { draftId });
-  const result = await ctx.invoke("list-projects", { projectId: draft.projectId });
-  const row = result.project.drafts.find((entry) => entry.id === draftId);
-  const preview = (row?.artifacts ?? []).find((artifact) => artifact.kind === "preview");
-  if (!preview?.url) {
-    throw new Error(
-      `Draft ${draftId} has no preview bundle yet. Save App.tsx and direction.ts with write_draft_files, wait for the build to finish, then capture frames.`
-    );
-  }
-  return {
-    url: preview.url,
-    slug: draft.slug,
-    revision: draft.revision,
-    artifactRevision: preview.source_revision
-  };
-}
-async function openPreview(ctx, draftId) {
-  const preview = await resolvePreview(ctx, draftId);
-  const warnings = [];
-  if (preview.artifactRevision !== preview.revision) {
-    warnings.push(
-      `The preview bundle is at revision ${preview.artifactRevision} but the draft is at ${preview.revision}. These frames show older code \u2014 save again and wait for the build.`
-    );
-  }
-  const response = await fetch(preview.url);
-  if (!response.ok) {
-    throw new Error(
-      `Preview download failed (${response.status}). Signed preview URLs expire after 15 minutes; retry to get a fresh one.`
-    );
-  }
-  const html = normalizeBundle(await response.text());
-  const skipped = skippedMedia(html, preview.slug);
-  if (skipped.length) {
-    warnings.push(
-      `The preview omits ${skipped.length} asset(s) that were too large to inline (${skipped.join(", ")}). They render blank or black here but will be correct in the exported MP4.`
-    );
-  }
-  const browser = await launchChromium();
-  try {
-    const page = await browser.newPage({
-      viewport: { width: 1920, height: 1080 },
-      deviceScaleFactor: 1
-    });
-    await page.route(
-      `${PREVIEW_ORIGIN}/**`,
-      (route) => route.fulfill({ status: 200, contentType: "text/html; charset=utf-8", body: html })
-    );
-    await page.goto(PREVIEW_URL, { waitUntil: "load", timeout: 6e4 });
-    await page.waitForFunction(() => window.__ready === true, void 0, {
-      timeout: 6e4
-    });
-    const config2 = await page.evaluate(() => window.__config);
-    if (config2?.width && config2?.height) {
-      await page.setViewportSize({ width: config2.width, height: config2.height });
-    }
-    const duration3 = Number(await page.evaluate(() => window.__duration)) || 0;
-    const fps = Number(config2?.fps) || 30;
-    const fontsFailed = await page.evaluate(async () => {
-      await document.fonts.ready;
-      return [...document.fonts].some((font) => font.status === "error");
-    });
-    if (fontsFailed) {
-      warnings.push(
-        "Some web fonts failed to load, so typography in these frames is not final. Frame capture needs network access to fonts.googleapis.com."
-      );
-    }
-    return { browser, page, duration: duration3, fps, revision: preview.artifactRevision, warnings };
-  } catch (error51) {
-    await browser.close().catch(() => void 0);
-    throw error51;
-  }
-}
-async function captureFrames(ctx, input) {
-  const session = await openPreview(ctx, input.draftId);
-  const { page, duration: duration3, warnings, revision } = session;
-  try {
-    const images = [];
-    for (const time3 of input.times) {
-      const clamped = duration3 > 0 ? Math.max(0, Math.min(time3, duration3)) : Math.max(0, time3);
-      await renderSettledFrame(page, clamped);
-      const frame = await page.screenshot({ type: FRAME_TYPE, quality: FRAME_QUALITY });
-      images.push({ base64: frame.toString("base64"), mimeType: FRAME_MIME });
-    }
-    return { images, warnings, revision, duration: duration3 };
-  } finally {
-    await session.browser.close().catch(() => void 0);
-  }
-}
-var getFramesTool = {
-  name: "get_frames",
-  title: "See rendered frames",
-  description: "Render frames of the draft at the given times (in seconds) and return them as images, so you can SEE your work instead of guessing. Runs on this machine against the cloud preview bundle \u2014 it needs Chrome installed. Ask for several times in one call: the frames are nearly free once the page is open. Always look at frames before telling the user a change is done.",
-  inputSchema: {
-    draftId: external_exports.string().describe("The draft id."),
-    times: external_exports.array(external_exports.number().min(0)).min(1).max(12).describe("Timeline positions in seconds, e.g. [0, 1.5, 3]."),
-    reviewMode: external_exports.enum(["layout", "proof", "final"]).optional().describe(
-      "Opt-in quality-loop lens. proof judges the core transformation before the full film; final requires broad timeline coverage and produces export-eligible review evidence."
-    )
-  },
-  local: true,
-  handler: async (args, ctx) => {
-    const capture = await captureFrames(ctx, {
-      draftId: String(args.draftId),
-      times: args.times
-    });
-    const lines = [
-      `Captured ${capture.images.length} frame(s) at revision ${capture.revision} (scene duration ${capture.duration.toFixed(2)}s).`,
-      ...capture.warnings.map((warning) => `WARNING: ${warning}`)
-    ];
-    const reviewMode = args.reviewMode;
-    if (ctx.qualityLoop) {
-      if (!reviewMode) {
-        lines.push(
-          'QUALITY LOOP: choose reviewMode="proof" for the core proof beat or reviewMode="final" for the export review.'
-        );
-      } else {
-        if (reviewMode === "final") {
-          const coverageError = finalReviewCoverageError(args.times, capture.duration);
-          const stalePreview = capture.warnings.some(
-            (warning) => warning.startsWith("The preview bundle is at revision ")
-          );
-          if (stalePreview) {
-            lines.push(
-              "QUALITY REVIEW NOT RECORDED: these frames came from a stale preview bundle. Wait for the current revision to build, then review it again."
-            );
-          } else if (coverageError) {
-            lines.push(`QUALITY REVIEW NOT RECORDED: ${coverageError}`);
-          } else {
-            recordFinalReviewCapture(ctx.qualityLoopState, String(args.draftId), {
-              revision: capture.revision,
-              duration: capture.duration,
-              times: [...args.times]
-            });
-            lines.push(
-              `FINAL REVIEW RECORDED for revision ${capture.revision}. Any later edit invalidates this evidence.`
-            );
-          }
-        }
-        lines.push(qualityReviewPrompt(reviewMode));
-      }
-    }
-    return { text: lines.join("\n"), images: capture.images };
+    }
+    return { text: lines.join("\n"), images: capture.images };
   }
 };
 
@@ -32847,6 +32429,7 @@ function motionLabEnabled(env = process.env) {
   return !/^(0|false|off|no)$/i.test(env[MOTION_LAB_ENV]?.trim() ?? "");
 }
 var DEFAULT_EVERY_NTH_FRAME = 5;
+var SAMPLING_BASE_FPS = 30;
 var MAX_SAMPLES = 48;
 var REVIEW_MAX_SAMPLES = 160;
 var QUICK_EVERY_NTH_FRAME = 10;
@@ -32856,17 +32439,20 @@ function defaultDetail(env = process.env) {
   return value === "full" || value === "quick" ? value : void 0;
 }
 function motionPassPlan(args) {
+  const fpsScale = Math.max(1, Math.round((Number(args.fps) || SAMPLING_BASE_FPS) / SAMPLING_BASE_FPS));
+  const defaultNth = DEFAULT_EVERY_NTH_FRAME * fpsScale;
+  const quickNth = QUICK_EVERY_NTH_FRAME * fpsScale;
   const full = args.finalReview || (args.detail ?? defaultDetail()) === "full";
   if (full) {
     return {
-      everyNthFrame: args.finalReview ? Math.min(Number(args.everyNthFrame ?? DEFAULT_EVERY_NTH_FRAME), DEFAULT_EVERY_NTH_FRAME) : Number(args.everyNthFrame ?? DEFAULT_EVERY_NTH_FRAME),
+      everyNthFrame: args.finalReview ? Math.min(Number(args.everyNthFrame ?? defaultNth), defaultNth) : Number(args.everyNthFrame ?? defaultNth),
       maxSamples: args.finalReview ? REVIEW_MAX_SAMPLES : MAX_SAMPLES,
       includeSheets: true,
       includeCatalog: true
     };
   }
   return {
-    everyNthFrame: Number(args.everyNthFrame ?? QUICK_EVERY_NTH_FRAME),
+    everyNthFrame: Number(args.everyNthFrame ?? quickNth),
     maxSamples: QUICK_MAX_SAMPLES,
     includeSheets: false,
     includeCatalog: false
@@ -32973,11 +32559,11 @@ function imperceptibleTweens(tweens, intervals, options = {}) {
   const threshold = options.threshold ?? IMPERCEPTIBLE_THRESHOLD;
   return tweens.filter((tween) => {
     if (tween.end - tween.start < minDuration) return false;
-    const active = intervals.filter(
+    const active2 = intervals.filter(
       (interval) => interval.end > tween.start && interval.start < tween.end
     );
-    if (!active.length) return false;
-    const mean2 = active.reduce((sum, interval) => sum + interval.changed, 0) / active.length;
+    if (!active2.length) return false;
+    const mean2 = active2.reduce((sum, interval) => sum + interval.changed, 0) / active2.length;
     return mean2 < threshold;
   });
 }
@@ -32999,11 +32585,11 @@ var FOCAL_GRID_ROWS = 6;
 var FOCAL_CELL_THRESHOLD = 0.15;
 var FOCAL_BUDGET = 2;
 function focalClusters(cells, cols = FOCAL_GRID_COLS, rows = FOCAL_GRID_ROWS, threshold = FOCAL_CELL_THRESHOLD) {
-  const active = cells.map((cell) => cell >= threshold);
+  const active2 = cells.map((cell) => cell >= threshold);
   const seen = new Array(cells.length).fill(false);
   let clusters = 0;
   for (let start = 0; start < cells.length; start += 1) {
-    if (!active[start] || seen[start]) continue;
+    if (!active2[start] || seen[start]) continue;
     clusters += 1;
     const stack = [start];
     seen[start] = true;
@@ -33014,7 +32600,7 @@ function focalClusters(cells, cols = FOCAL_GRID_COLS, rows = FOCAL_GRID_ROWS, th
       for (const [nx, ny] of [[x - 1, y], [x + 1, y], [x, y - 1], [x, y + 1]]) {
         if (nx < 0 || ny < 0 || nx >= cols || ny >= rows) continue;
         const neighbour = ny * cols + nx;
-        if (active[neighbour] && !seen[neighbour]) {
+        if (active2[neighbour] && !seen[neighbour]) {
           seen[neighbour] = true;
           stack.push(neighbour);
         }
@@ -33428,9 +33014,9 @@ function displacementDebt(tweens, duration3, model = buildSceneModel(tweens, dur
     const key = `${scene}\0${target}`;
     const state = states.get(key) ?? { values: /* @__PURE__ */ new Map(), lastMove: 0, exited: false };
     const alphaValue = tween.values?.autoAlpha ?? tween.values?.opacity;
-    const isEntrance = typeof alphaValue === "number" && alphaValue > 0.5;
+    const isEntrance2 = typeof alphaValue === "number" && alphaValue > 0.5;
     for (const prop of tween.props) {
-      if (tween.yoyo || isEntrance) break;
+      if (tween.yoyo || isEntrance2) break;
       if (TRANSFORM_PROPS.has(prop) && typeof tween.values?.[prop] === "number") {
         state.values.set(prop, tween.values[prop]);
         state.lastMove = tween.end;
@@ -33619,6 +33205,60 @@ async function extractTimeline(page) {
     return out;
   });
 }
+var FRAMING_ABANDONED_MAX_COVERAGE = 0.08;
+var FRAMING_ABANDONED_MIN_OFFSET = 0.25;
+var FRAMING_ABANDONED_MIN_SECONDS = 0.9;
+var FRAMING_ACTIVE_MEDIAN_DIFF = 0.05;
+var FRAMING_STILL_MOVE_MAX_DIFF = 0.012;
+var FRAMING_STILL_MOVE_MIN_SECONDS = 0.3;
+function framingFindings(input) {
+  const { times, diffs, flatness, coverage, contentOffset, cameraSpans: cameraSpans2 } = input;
+  const findings = [];
+  const notes = [];
+  const abandoned = (i) => coverage[i] <= FRAMING_ABANDONED_MAX_COVERAGE && contentOffset[i] >= FRAMING_ABANDONED_MIN_OFFSET;
+  let runStart = -1;
+  for (let i = 0; i <= times.length; i += 1) {
+    const bad = i < times.length && abandoned(i);
+    if (bad && runStart < 0) runStart = i;
+    if (!bad && runStart >= 0) {
+      const last = Math.min(i, times.length - 1);
+      const seconds = times[last] - times[runStart];
+      if (seconds >= FRAMING_ABANDONED_MIN_SECONDS) {
+        const peak = Math.max(...flatness.slice(runStart, Math.max(runStart + 1, i)));
+        const inside = [];
+        for (let k = runStart; k <= i - 2 && k < diffs.length; k += 1) {
+          inside.push(diffs[k]);
+        }
+        const sorted = [...inside].sort((a, b) => a - b);
+        const median2 = sorted.length ? sorted[Math.floor(sorted.length / 2)] : 0;
+        if (median2 >= FRAMING_ACTIVE_MEDIAN_DIFF) {
+          notes.push(
+            `HELD CLOSE-UP ${times[runStart].toFixed(2)}-${times[last].toFixed(2)}s: sparse framing but the content is alive (median change ${(median2 * 100).toFixed(1)}%/sample) \u2014 reads as an intentional close-up, not gated. Confirm it looks deliberate.`
+          );
+        } else {
+          findings.push(
+            `ABANDONED FRAME ${times[runStart].toFixed(2)}-${times[last].toFixed(2)}s: for ${seconds.toFixed(1)}s the frame is ${Math.round(peak * 100)}% one flat color with the remaining content pushed into a corner and nothing moving (median change ${(median2 * 100).toFixed(1)}%/sample). The camera is pointed at nothing \u2014 look at these frames, find what SHOULD be on screen here, and reframe on it.`
+          );
+        }
+      }
+      runStart = -1;
+    }
+  }
+  for (const span of cameraSpans2) {
+    if (span.end - span.start < FRAMING_STILL_MOVE_MIN_SECONDS) continue;
+    const inside = [];
+    for (let i = 0; i < diffs.length; i += 1) {
+      const mid = (times[i] + times[i + 1]) / 2;
+      if (mid >= span.start && mid <= span.end) inside.push(diffs[i]);
+    }
+    if (inside.length >= 2 && Math.max(...inside) < FRAMING_STILL_MOVE_MAX_DIFF) {
+      findings.push(
+        `CAMERA MOVE WITHOUT CHANGE ${span.start.toFixed(2)}-${span.end.toFixed(2)}s: this move leaves the frame visually identical (peak pixel change ${(Math.max(...inside) * 100).toFixed(1)}%). The shot before and after are the same - cut it, or make it a real reframe the viewer can feel.`
+      );
+    }
+  }
+  return { failures: findings, notes };
+}
 async function compositeAndDiff(page, frames, options = {}) {
   return page.evaluate(
     async (input) => {
@@ -33642,6 +33282,9 @@ async function compositeAndDiff(page, frames, options = {}) {
       let prev = null;
       const diffs = [];
       const cellDiffs = [];
+      const flatness = [];
+      const coverage = [];
+      const contentOffset = [];
       const gridCols = 8;
       const gridRows = 6;
       const cellW = dw / gridCols;
@@ -33649,6 +33292,40 @@ async function compositeAndDiff(page, frames, options = {}) {
       for (const img of imgs) {
         diffCtx.drawImage(img, 0, 0, dw, dh);
         const data = diffCtx.getImageData(0, 0, dw, dh).data;
+        {
+          const buckets = /* @__PURE__ */ new Map();
+          for (let i = 0; i < data.length; i += 4) {
+            const key = data[i] >> 4 << 8 | data[i + 1] >> 4 << 4 | data[i + 2] >> 4;
+            buckets.set(key, (buckets.get(key) ?? 0) + 1);
+          }
+          let dominantKey = -1;
+          let dominant = 0;
+          for (const [key, count2] of buckets) {
+            if (count2 > dominant) {
+              dominant = count2;
+              dominantKey = key;
+            }
+          }
+          flatness.push(dominant / (dw * dh));
+          const dr = (dominantKey >> 8 & 15) << 4;
+          const dg = (dominantKey >> 4 & 15) << 4;
+          const db = (dominantKey & 15) << 4;
+          let count = 0;
+          let sumX = 0;
+          let sumY = 0;
+          for (let i = 0; i < data.length; i += 4) {
+            const delta = Math.abs(data[i] - dr) + Math.abs(data[i + 1] - dg) + Math.abs(data[i + 2] - db);
+            if (delta > 90) {
+              count += 1;
+              sumX += i / 4 % dw;
+              sumY = sumY + Math.floor(i / 4 / dw);
+            }
+          }
+          coverage.push(count / (dw * dh));
+          contentOffset.push(
+            count ? Math.hypot(sumX / count / dw - 0.5, sumY / count / dh - 0.5) : 0
+          );
+        }
         if (prev) {
           let changed = 0;
           const cells = new Array(gridCols * gridRows).fill(0);
@@ -33656,266 +33333,1809 @@ async function compositeAndDiff(page, frames, options = {}) {
             const delta = Math.abs(data[i] - prev[i]) + Math.abs(data[i + 1] - prev[i + 1]) + Math.abs(data[i + 2] - prev[i + 2]);
             if (delta > 60) {
               changed += 1;
-              const px = i / 4 % dw;
+              const px2 = i / 4 % dw;
               const py = Math.floor(i / 4 / dw);
-              cells[Math.floor(py / cellH) * gridCols + Math.floor(px / cellW)] += 1;
+              cells[Math.floor(py / cellH) * gridCols + Math.floor(px2 / cellW)] += 1;
             }
           }
           diffs.push(changed / (dw * dh));
           cellDiffs.push(cells.map((count) => count / (cellW * cellH)));
         }
-        prev = data.slice();
+        prev = data.slice();
+      }
+      if (!input.includeSheets) return { sheets: [], diffs, cellDiffs, flatness, coverage, contentOffset };
+      const ratio = imgs[0].naturalHeight / Math.max(1, imgs[0].naturalWidth);
+      const tw = input.tileWidth;
+      const th = Math.round(tw * ratio);
+      const sheets = [];
+      for (let s = 0; s * input.perSheet < imgs.length; s += 1) {
+        const slice = imgs.slice(s * input.perSheet, (s + 1) * input.perSheet);
+        const rows = Math.ceil(slice.length / input.columns);
+        const canvas = document.createElement("canvas");
+        canvas.width = input.columns * tw;
+        canvas.height = rows * th;
+        const ctx = canvas.getContext("2d");
+        if (!ctx) throw new Error("2d canvas unavailable");
+        ctx.fillStyle = "#000";
+        ctx.fillRect(0, 0, canvas.width, canvas.height);
+        slice.forEach((img, i) => {
+          const x = i % input.columns * tw;
+          const y = Math.floor(i / input.columns) * th;
+          ctx.drawImage(img, x, y, tw, th);
+          const label = input.frames[s * input.perSheet + i].time.toFixed(2) + "s";
+          ctx.font = "bold 16px monospace";
+          const width = ctx.measureText(label).width + 10;
+          ctx.fillStyle = "rgba(0,0,0,0.72)";
+          ctx.fillRect(x, y, width, 22);
+          ctx.fillStyle = "#ffd21f";
+          ctx.fillText(label, x + 5, y + 16);
+        });
+        sheets.push(canvas.toDataURL("image/jpeg", 0.8).split(",")[1]);
+      }
+      return { sheets, diffs, cellDiffs, flatness, coverage, contentOffset };
+    },
+    {
+      frames,
+      columns: options.columns ?? 4,
+      tileWidth: options.tileWidth ?? 480,
+      perSheet: options.perSheet ?? 16,
+      includeSheets: options.includeSheets ?? true
+    }
+  );
+}
+var getMotionTool = {
+  name: "get_motion",
+  title: "See and measure motion over an interval",
+  description: "MOTION LAB (local experiment). Sample the draft densely across a time window and return (1) timestamp-labelled contact sheets \u2014 adjacent tiles are one sample apart, so the difference between tiles IS the motion \u2014 and (2) a measured report: % of pixels changing per interval, dead-air spans where nothing perceptible moves, and every tween the built timeline actually schedules in the window, flagging tweens that run without producing visible change. Static frames cannot show velocity, overlap, or dead air; this can. Call it over the full duration after every preview build, then narrow in on weak windows. Use get_frames for composition close-ups only.",
+  inputSchema: {
+    draftId: external_exports.string().describe("The draft id."),
+    from: external_exports.number().min(0).optional().describe("Window start in seconds. Defaults to 0."),
+    to: external_exports.number().min(0).optional().describe("Window end in seconds. Defaults to the scene duration."),
+    everyNthFrame: external_exports.number().int().min(1).max(30).optional().describe(
+      `Sample one frame in N. The default keeps 6 samples/second at the scene's fps \u2014 the density at which motion becomes readable across stills.`
+    ),
+    detail: external_exports.enum(["quick", "full"]).optional().describe(
+      'quick (default): numbers only \u2014 dead air, focal budget, text census \u2014 sparser sampling, NO contact-sheet images, no metric catalog. Cheap enough to run after every revision. full: dense sampling with contact sheets and the catalog, when you need to SEE motion mid-flight. Measure at most twice per revision; finish with reviewMode "final".'
+    ),
+    reviewMode: external_exports.enum(["final"]).optional().describe(
+      'Quality-loop lens: "final" forces a full-duration pass at one-frame-in-five density and records export-eligible motion-coverage evidence for the current revision.'
+    )
+  },
+  local: true,
+  // Metered as a frame capture: the deployed admission policy budgets
+  // get_frames for exactly the routes this tool invokes (get-draft,
+  // list-projects), and one motion pass is one capture.
+  admitAs: "get_frames",
+  handler: async (args, ctx, progress) => {
+    const finalReview = args.reviewMode === "final";
+    const session = await openPreview(ctx, String(args.draftId));
+    try {
+      const duration3 = session.duration;
+      const from = finalReview ? 0 : Math.max(0, Math.min(Number(args.from ?? 0), duration3));
+      const to = finalReview ? duration3 : Math.max(0, Math.min(Number(args.to ?? duration3), duration3));
+      if (to <= from) {
+        return {
+          text: `get_motion needs from < to within 0\u2013${formatTime(duration3)}s (got ${from}\u2013${to}).`,
+          isError: true
+        };
+      }
+      const passPlan = motionPassPlan({
+        finalReview,
+        detail: args.detail ? String(args.detail) : void 0,
+        everyNthFrame: args.everyNthFrame === void 0 ? void 0 : Number(args.everyNthFrame),
+        fps: session.fps
+      });
+      const everyNthFrame = passPlan.everyNthFrame;
+      const plan = sampleTimes({
+        from,
+        to,
+        fps: session.fps,
+        everyNthFrame,
+        maxSamples: passPlan.maxSamples
+      });
+      const frames = [];
+      const textSamples = [];
+      const censusOn = textCensusEnabled();
+      for (const [index, time3] of plan.times.entries()) {
+        if (progress?.signal?.aborted) break;
+        await renderSettledFrame(session.page, time3);
+        const shot = await session.page.screenshot({ type: "jpeg", quality: 80 });
+        frames.push({ time: time3, base64: shot.toString("base64") });
+        if (censusOn) {
+          try {
+            textSamples.push({ time: time3, blocks: await sampleTextBlocks(session.page, CANDIDATE_MIN_PX) });
+          } catch {
+          }
+        }
+        progress?.report?.({
+          progress: index + 1,
+          total: plan.times.length,
+          message: `sampled t=${formatTime(time3)}s`
+        });
+      }
+      const tweensAll = await extractTimeline(session.page);
+      const tweens = tweensAll ? tweensAll.filter((tween) => tween.end > from && tween.start < to) : null;
+      const craftOn = craftLabEnabled();
+      const engineTweens = await extractEngineTweens(session.page);
+      const camSpans = cameraSpans(engineTweens);
+      const sheetPage = await session.context.newPage();
+      const { sheets, diffs, cellDiffs, flatness, coverage, contentOffset } = await compositeAndDiff(
+        sheetPage,
+        frames,
+        { includeSheets: passPlan.includeSheets }
+      );
+      const framingResult = framingFindings({
+        times: plan.times,
+        diffs,
+        flatness,
+        coverage,
+        contentOffset,
+        cameraSpans: camSpans.filter((span) => span.end > from && span.start < to)
+      });
+      const framing = framingResult.failures;
+      let catalogSection = "";
+      if (passPlan.includeCatalog && metricCatalogEnabled() && frames.length >= 2) {
+        try {
+          const features = await sampleCatalogFeatures(sheetPage, frames);
+          const records = computeCatalogMetrics({
+            features,
+            dtSeconds: plan.stepSeconds,
+            durationSeconds: to - from
+          });
+          catalogSection = formatCatalogReport(records);
+        } catch (error51) {
+          catalogSection = "CANONICAL METRICS unavailable this pass: " + (error51 instanceof Error ? error51.message : String(error51));
+        }
+      }
+      const intervals = buildIntervals(
+        frames.map((frame) => frame.time),
+        diffs
+      );
+      const censusSection = censusOn && textSamples.length ? textCensusReport(textSamples) : "";
+      let contractSection = "";
+      if (textContractEnabled() && textSamples.length >= 2) {
+        try {
+          const dims = await session.page.evaluate(() => ({
+            width: window.innerWidth,
+            height: window.innerHeight
+          }));
+          contractSection = formatTextContractReport(
+            analyzeTextContract({
+              samples: textSamples,
+              diffs,
+              frameWidth: dims.width,
+              frameHeight: dims.height,
+              stepSeconds: plan.stepSeconds,
+              lockedContent: ctx.qualityLoopState?.lockedContentByDraft.get(String(args.draftId)),
+              inspectV2: inspectV2Enabled()
+            })
+          );
+        } catch {
+        }
+      }
+      let v2Section = "";
+      if (inspectV2Enabled()) {
+        const v2Lines = [];
+        const envelope = envelopeLine(intervals);
+        if (envelope) v2Lines.push(envelope);
+        const beats = ctx.qualityLoopState?.beatsByDraft.get(String(args.draftId)) ?? [];
+        v2Lines.push(...beatVerdicts(beats, intervals));
+        v2Lines.push(
+          ...repairMenu({
+            deadSpans: deadAirSpans(intervals),
+            imperceptible: tweens ? imperceptibleTweens(tweens, intervals) : [],
+            textSamples
+          })
+        );
+        v2Section = v2Lines.join("\n");
+      }
+      let scoreSection = "";
+      if (motionScoreEnabled() && tweensAll?.length) {
+        try {
+          scoreSection = motionScoreSection({
+            tweens: tweensAll,
+            beats: ctx.qualityLoopState?.beatsByDraft.get(String(args.draftId)) ?? [],
+            duration: duration3
+          });
+        } catch {
+        }
+      }
+      let splitFocus = splitFocusMoments(
+        frames.map((frame) => frame.time),
+        cellDiffs
+      );
+      let breathless = breathlessSpans(intervals);
+      let cadence = tweens ? cadenceMoments(tweens) : void 0;
+      let cameraExemptions = 0;
+      if (craftOn && camSpans.length) {
+        const before = breathless.length + splitFocus.length;
+        breathless = breathless.filter((span) => cameraCoverageOf(span, camSpans) < 0.6);
+        splitFocus = splitFocus.filter((moment) => cameraCoverageOf(moment, camSpans) < 0.6);
+        cameraExemptions = before - breathless.length - splitFocus.length;
+        cadence = tweens ? cadenceMoments(tweens.filter((tween) => !startsWithCamera(tween, camSpans))) : void 0;
+      }
+      let craftSection = "";
+      let craftFindings = null;
+      if (craftOn && tweensAll?.length) {
+        try {
+          const focalStarts = actionEvents(
+            tweensAll.filter((tween) => !startsWithCamera(tween, camSpans))
+          );
+          craftFindings = computeCraftFindings({
+            records: tweensAll,
+            engine: engineTweens,
+            duration: duration3,
+            actionStarts: focalStarts
+          });
+          craftSection = craftReport(craftFindings);
+          if (cameraExemptions > 0) {
+            craftSection += `
+  ROLE EXEMPTIONS \u2014 ${cameraExemptions} high-motion/split-focus span(s) attributed to camera moves and removed from the restraint verdicts above.`;
+          }
+        } catch {
+        }
+      }
+      const report = motionReport({ from, to, plan, everyNthFrame, intervals, tweens, duration: duration3, splitFocus, breathless, cadence });
+      const lines = [
+        report,
+        ...passPlan.includeSheets ? [] : [
+          "",
+          'QUICK PASS \u2014 numbers only, no frames attached. Run detail: "full" when you need to SEE the motion, and reviewMode: "final" for the export-evidence review.'
+        ],
+        ...censusSection ? ["", censusSection] : [],
+        ...contractSection ? ["", contractSection] : [],
+        ...scoreSection ? ["", scoreSection] : [],
+        ...v2Section ? ["", v2Section] : [],
+        ...framing.length || framingResult.notes.length ? [
+          "",
+          "FRAMING (deterministic):",
+          ...framing.map((finding) => `- ${finding}`),
+          ...framingResult.notes.map((note) => `- ${note}`)
+        ] : [],
+        ...craftSection ? ["", craftSection] : [],
+        ...catalogSection ? ["", catalogSection] : [],
+        ...session.warnings.map((warning) => `WARNING: ${warning}`),
+        "",
+        "These are measurements, not style rules. Dead air and imperceptible tweens are time no one is directing \u2014 decide narratively what should own that time, change the direction, and measure again."
+      ];
+      if (ctx.qualityLoop) {
+        if (!finalReview) {
+          lines.push(
+            'QUALITY LOOP: this pass is not export evidence. Record motion coverage with get_motion({ draftId, reviewMode: "final" }) once the cut is complete.'
+          );
+        } else {
+          const stalePreview = session.warnings.some(
+            (warning) => warning.startsWith("The preview bundle is at revision ")
+          );
+          if (stalePreview) {
+            lines.push(
+              "MOTION REVIEW NOT RECORDED: these samples came from a stale preview bundle. Wait for the current revision to build, then review it again."
+            );
+          } else {
+            let craftCapture;
+            if (craftOn) {
+              const beats = ctx.qualityLoopState?.beatsByDraft.get(String(args.draftId)) ?? [];
+              const mismatches = beatVerdicts(beats, intervals).filter(
+                (verdict) => verdict.startsWith("BEAT MISMATCH")
+              ).length;
+              const dead = deadAirSpans(intervals);
+              craftCapture = {
+                cameraMoves: craftFindings?.cameraMoves ?? camSpans.length,
+                deformations: craftFindings?.deformations.length ?? 0,
+                beatMismatches: mismatches,
+                deadAirSpans: dead.length,
+                longestDeadAirSeconds: dead.reduce(
+                  (longest, span) => Math.max(longest, span.end - span.start),
+                  0
+                ),
+                hardCutShare: craftFindings?.continuity.hardCutShare ?? null
+              };
+            }
+            ctx.qualityLoopState?.finalMotionReviewByDraft.set(String(args.draftId), {
+              revision: session.revision,
+              duration: duration3,
+              stepSeconds: plan.stepSeconds,
+              samples: plan.times.length,
+              craft: craftCapture,
+              framingFailures: framing
+            });
+            lines.push(
+              `FINAL MOTION REVIEW RECORDED for revision ${session.revision} \u2014 ${plan.times.length} samples, ${plan.stepSeconds.toFixed(3)}s apart` + (plan.coarsened ? " (coarsened below one-in-five by film length)" : "") + ". Any later edit invalidates this evidence."
+            );
+            lines.push(qualityReviewPrompt("final"));
+          }
+        }
+      }
+      return {
+        text: lines.join("\n"),
+        images: sheets.map((base643) => ({ base64: base643, mimeType: "image/jpeg" }))
+      };
+    } finally {
+      await session.release();
+    }
+  }
+};
+function motionLabServerInstructions() {
+  return `
+
+MOTION LAB IS ENABLED \u2014 an opt-in local experiment:
+Static frames measure composition; they are blind to velocity, overlap, and dead air. After every successful preview build, call get_motion across the full duration BEFORE judging the cut, and again on any window you edit. Treat its output as measurements, not style rules: a dead-air span or a flagged imperceptible tween is time no one is directing \u2014 decide what should own that time, fix the direction, and measure again. A cut is not done while the report shows dead air you did not choose deliberately. get_frames remains the tool for composition close-ups.
+When the quality loop is also enabled, the final review is two-part and export requires both on the same revision: get_frames({ reviewMode: "final" }) for composition and legibility at native resolution, and get_motion({ draftId, reviewMode: "final" }) for full-duration motion coverage at one frame in five.`;
+}
+
+// src/mcp/craft.ts
+var CRAFT_LAB_ENV = "IMPRACTICAL_CRAFT_LAB";
+function craftLabEnabled(env = process.env) {
+  return /^(1|true|on|yes)$/i.test(env[CRAFT_LAB_ENV]?.trim() ?? "");
+}
+async function extractEngineTweens(page) {
+  return page.evaluate(() => {
+    const scene = window.__scene;
+    if (!scene?.tweens) return null;
+    return scene.tweens.map((tween) => ({
+      kind: tween.kind,
+      start: tween.start,
+      end: tween.start + tween.total,
+      ease: tween.ease || "default"
+    }));
+  });
+}
+var CAMERA_MIN_MOVE_SECONDS = 0.15;
+function cameraSpans(engine) {
+  if (!engine) return [];
+  return engine.filter((tween) => tween.kind === "camera" && tween.end - tween.start >= CAMERA_MIN_MOVE_SECONDS).map((tween) => ({ start: tween.start, end: tween.end })).sort((a, b) => a.start - b.start);
+}
+var overlaps = (a, b) => Math.max(0, Math.min(a.end, b.end) - Math.max(a.start, b.start));
+function startsWithCamera(tween, spans2, tolerance = 0.05) {
+  return spans2.some((span) => tween.start >= span.start - tolerance && tween.start <= span.end + tolerance);
+}
+function cameraCoverageOf(span, spans2) {
+  const length = span.end - span.start;
+  if (length <= 0) return 0;
+  let covered = 0;
+  for (const cam of spans2) covered += overlaps(span, cam);
+  return Math.min(1, covered / length);
+}
+var SLIDE_PROPS = /* @__PURE__ */ new Set(["x", "y", "xPercent", "yPercent", "left", "top", "right", "bottom"]);
+var SCALE_PROPS = /* @__PURE__ */ new Set(["scale", "scaleX", "scaleY"]);
+var ROTATE_PROPS = /* @__PURE__ */ new Set(["rotation", "rotationX", "rotationY", "rotationZ", "skewX", "skewY"]);
+var CLIP_PROPS = /* @__PURE__ */ new Set(["clipPath", "webkitClipPath", "maskImage", "maskPosition"]);
+var DRAW_PROPS = /* @__PURE__ */ new Set(["strokeDashoffset", "strokeDasharray", "drawSVG"]);
+var COLOR_PROPS = /* @__PURE__ */ new Set(["backgroundColor", "borderColor", "color", "fill", "stroke", "background"]);
+var FILTER_PROPS = /* @__PURE__ */ new Set(["filter", "backdropFilter", "opacity"]);
+var TEXT_PROPS = /* @__PURE__ */ new Set(["text", "textContent", "innerText"]);
+function moveFamily(record2) {
+  const props = record2.props.filter((prop) => prop !== "transformOrigin" && prop !== "transformPerspective");
+  const has = (set2) => props.some((prop) => set2.has(prop));
+  const families = [];
+  if (has(SLIDE_PROPS)) families.push("slide");
+  if (has(SCALE_PROPS)) families.push("scale");
+  if (has(ROTATE_PROPS)) families.push("rotate");
+  if (has(CLIP_PROPS)) families.push("clip");
+  if (has(DRAW_PROPS)) families.push("draw");
+  if (has(COLOR_PROPS)) families.push("color");
+  if (has(TEXT_PROPS)) families.push("text");
+  if (families.length === 0 && has(FILTER_PROPS)) families.push("filter");
+  if (families.length === 0 && props.some((prop) => prop === "autoAlpha" || prop === "alpha")) {
+    return "fade";
+  }
+  if (families.length === 0) return "mixed";
+  if (families.length === 1) return families[0];
+  return "mixed";
+}
+function isEntrance(record2) {
+  const alpha = record2.values?.autoAlpha ?? record2.values?.alpha ?? record2.values?.opacity;
+  return typeof alpha === "number" && alpha > 0.5 && record2.end > record2.start;
+}
+var durationBucket = (record2) => Math.round((record2.end - record2.start) / 0.15);
+function entranceSignature(record2) {
+  return `${moveFamily(record2)}|${record2.ease}|${durationBucket(record2)}`;
+}
+var DEFORMATION_MAX_RATIO = 3;
+function deformationViolations(records) {
+  const state = /* @__PURE__ */ new Map();
+  const out = [];
+  const sorted = [...records].sort((a, b) => a.start - b.start);
+  for (const record2 of sorted) {
+    const sx = record2.values?.scaleX;
+    const sy = record2.values?.scaleY;
+    const uniform = record2.values?.scale;
+    if (typeof sx !== "number" && typeof sy !== "number" && typeof uniform !== "number") continue;
+    for (const target of record2.targets) {
+      const previous = state.get(target) ?? { x: 1, y: 1 };
+      const next = {
+        x: typeof uniform === "number" ? uniform : typeof sx === "number" ? sx : previous.x,
+        y: typeof uniform === "number" ? uniform : typeof sy === "number" ? sy : previous.y
+      };
+      state.set(target, next);
+      if (next.x > 0 && next.y > 0) {
+        const ratio = Math.max(next.x / next.y, next.y / next.x);
+        if (ratio >= DEFORMATION_MAX_RATIO) {
+          out.push({ target, time: record2.start, ratio: Number(ratio.toFixed(1)) });
+        }
+      }
+    }
+  }
+  return out;
+}
+function rhythmStats(actionStarts) {
+  const events = actionStarts.length;
+  if (events < 3) return { events, meanInterval: null, cv: null, lag1: null };
+  const intervals = [];
+  for (let i = 1; i < actionStarts.length; i += 1) {
+    intervals.push(actionStarts[i] - actionStarts[i - 1]);
+  }
+  const mean2 = intervals.reduce((sum, value) => sum + value, 0) / intervals.length;
+  const variance = intervals.reduce((sum, value) => sum + (value - mean2) ** 2, 0) / intervals.length;
+  const sd = Math.sqrt(variance);
+  const cv = mean2 > 0 ? sd / mean2 : null;
+  let lag1 = null;
+  if (intervals.length >= 3 && sd > 0) {
+    let cov = 0;
+    for (let i = 1; i < intervals.length; i += 1) {
+      cov += (intervals[i] - mean2) * (intervals[i - 1] - mean2);
+    }
+    lag1 = cov / ((intervals.length - 1) * variance);
+  }
+  return {
+    events,
+    meanInterval: Number(mean2.toFixed(2)),
+    cv: cv === null ? null : Number(cv.toFixed(2)),
+    lag1: lag1 === null ? null : Number(lag1.toFixed(2))
+  };
+}
+var COVERING_FAMILIES = /* @__PURE__ */ new Set(["clip", "filter"]);
+var COVERING_KINDS = /* @__PURE__ */ new Set(["camera", "mask", "filter", "three"]);
+function continuityStats(records, engine) {
+  const switches = sceneSwitches(records);
+  if (!switches.length) return { switches: 0, hardCuts: 0, hardCutShare: null };
+  const covering = [];
+  for (const record2 of records) {
+    if (COVERING_FAMILIES.has(moveFamily(record2)) && record2.end > record2.start) {
+      covering.push({ start: record2.start, end: record2.end });
+    }
+  }
+  for (const tween of engine ?? []) {
+    if (COVERING_KINDS.has(tween.kind) && tween.end - tween.start >= CAMERA_MIN_MOVE_SECONDS) {
+      covering.push({ start: tween.start, end: tween.end });
+    }
+  }
+  let hardCuts = 0;
+  for (const cut of switches) {
+    const window2 = {
+      start: cut.time - CUT_BOUNDARY_TOLERANCE_SECONDS,
+      end: cut.time + CUT_BOUNDARY_TOLERANCE_SECONDS
+    };
+    const covered = covering.some((span) => overlaps(span, window2) > 0);
+    if (!covered) hardCuts += 1;
+  }
+  return {
+    switches: switches.length,
+    hardCuts,
+    hardCutShare: Number((hardCuts / switches.length).toFixed(2))
+  };
+}
+function layeredMotionMoments(records, spans2) {
+  const movers = records.filter(
+    (record2) => record2.props.some((prop) => SLIDE_PROPS.has(prop)) && record2.end - record2.start >= 0.3 && !startsWithCamera(record2, spans2)
+  );
+  let moments = 0;
+  for (let i = 0; i < movers.length; i += 1) {
+    for (let j = i + 1; j < movers.length; j += 1) {
+      const a = movers[i];
+      const b = movers[j];
+      if (a.targets[0] === b.targets[0]) continue;
+      if (overlaps(a, b) < 0.4) continue;
+      const ratio = (a.end - a.start) / (b.end - b.start);
+      if (ratio > 0.2 && ratio < 0.8) moments += 1;
+      else if (ratio > 1.25 && ratio < 5) moments += 1;
+    }
+  }
+  return moments;
+}
+function computeCraftFindings(input) {
+  const spans2 = cameraSpans(input.engine);
+  const focal = input.records.filter((record2) => !startsWithCamera(record2, spans2));
+  const familySet = /* @__PURE__ */ new Set();
+  for (const record2 of focal) familySet.add(moveFamily(record2));
+  const entrances = focal.filter(isEntrance);
+  const signatureCounts = /* @__PURE__ */ new Map();
+  for (const record2 of entrances) {
+    const signature = entranceSignature(record2);
+    signatureCounts.set(signature, (signatureCounts.get(signature) ?? 0) + 1);
+  }
+  let topSignature = null;
+  let topCount = 0;
+  for (const [signature, count] of signatureCounts) {
+    if (count > topCount) {
+      topCount = count;
+      topSignature = signature;
+    }
+  }
+  const eases = new Set(focal.map((record2) => record2.ease));
+  const wholeFilm = { start: 0, end: input.duration };
+  return {
+    duration: input.duration,
+    cameraMoves: spans2.length,
+    cameraCoverage: Number(cameraCoverageOf(wholeFilm, spans2).toFixed(3)),
+    layeredMoments: layeredMotionMoments(input.records, spans2),
+    families: [...familySet].sort(),
+    entrances: entrances.length,
+    topEntranceSignature: topSignature,
+    topEntranceShare: entrances.length >= 3 ? Number((topCount / entrances.length).toFixed(2)) : null,
+    easeCount: eases.size,
+    rhythm: rhythmStats(input.actionStarts),
+    continuity: continuityStats(input.records, input.engine),
+    deformations: deformationViolations(input.records)
+  };
+}
+var CRAFT_BANDS = {
+  cameraMovesPer30s: { low: 3, high: 9 },
+  familiesMin: 5,
+  topEntranceShareMax: 0.35,
+  rhythmCv: { low: 0.3, high: 0.9 },
+  hardCutShareMax: 0.4
+};
+var inBand = (value, low, high) => value < low ? `below band [${low}\u2013${high}]` : value > high ? `above band [${low}\u2013${high}]` : `in band [${low}\u2013${high}]`;
+function craftReport(findings) {
+  const lines = [];
+  const per30 = findings.duration > 0 ? findings.cameraMoves / findings.duration * 30 : 0;
+  lines.push(
+    "CRAFT ENVELOPE (craft-lab v1 \u2014 all bands PROVISIONAL until reference calibration; richness is band-scored, never maximized):"
+  );
+  lines.push(
+    `  DEPTH \u2014 camera: ${findings.cameraMoves} move(s) (${per30.toFixed(1)}/30s, ${inBand(per30, CRAFT_BANDS.cameraMovesPer30s.low, CRAFT_BANDS.cameraMovesPer30s.high)}), ${(findings.cameraCoverage * 100).toFixed(0)}% of runtime under camera motion; layered-motion moments: ${findings.layeredMoments}.` + (findings.cameraMoves === 0 ? " \u26A0 ZERO camera moves \u2014 a locked full-frame camera for the whole film reads as a slideshow." : "")
+  );
+  lines.push(
+    `  VOCABULARY \u2014 ${findings.families.length} move families (${findings.families.join(", ") || "none"}); ${findings.easeCount} distinct eases; ` + (findings.topEntranceShare !== null ? `top entrance signature ${(findings.topEntranceShare * 100).toFixed(0)}% of ${findings.entrances} entrances` + (findings.topEntranceShare > CRAFT_BANDS.topEntranceShareMax ? ` \u26A0 over the ${CRAFT_BANDS.topEntranceShareMax * 100}% repeat ceiling (${findings.topEntranceSignature})` : "") : "too few entrances to judge repetition")
+  );
+  const rhythm = findings.rhythm;
+  lines.push(
+    `  RHYTHM \u2014 ${rhythm.events} focal actions` + (rhythm.cv !== null ? `, interval CV ${rhythm.cv} (${inBand(rhythm.cv, CRAFT_BANDS.rhythmCv.low, CRAFT_BANDS.rhythmCv.high)}; <${CRAFT_BANDS.rhythmCv.low} = metronomic, >${CRAFT_BANDS.rhythmCv.high} = erratic)` + (rhythm.lag1 !== null ? `, lag-1 autocorr ${rhythm.lag1}` : "") + "." : " \u2014 too few to measure rhythm.")
+  );
+  const continuity = findings.continuity;
+  lines.push(
+    `  CONTINUITY \u2014 ${continuity.switches} scene changes, ${continuity.hardCuts} hard cut(s)` + (continuity.hardCutShare !== null ? ` (${(continuity.hardCutShare * 100).toFixed(0)}%` + (continuity.hardCutShare > CRAFT_BANDS.hardCutShareMax ? ` \u26A0 over the ${CRAFT_BANDS.hardCutShareMax * 100}% ceiling \u2014 carry more cuts with a camera move, mask, or transition` : "") + ")" : "") + "."
+  );
+  if (findings.deformations.length) {
+    lines.push(
+      `  GEOMETRY \u2014 \u26A0 ${findings.deformations.length} deformation violation(s) (aspect distortion \u2265 ${DEFORMATION_MAX_RATIO}:1): ` + findings.deformations.slice(0, 3).map((violation) => `${violation.target} at ${violation.time.toFixed(2)}s (${violation.ratio}:1)`).join("; ") + ". Smeared elements are defects, not style."
+    );
+  } else {
+    lines.push("  GEOMETRY \u2014 no deformation violations.");
+  }
+  return lines.join("\n");
+}
+var CAMERA_FLOOR_MIN_DURATION = 8;
+var DEAD_AIR_BLOCK_SECONDS = 2.5;
+function craftGateFailures(capture, duration3) {
+  const failures = [];
+  if (capture.beatMismatches > 0) {
+    failures.push(
+      `${capture.beatMismatches} unresolved BEAT MISMATCH finding(s) \u2014 declared energy the film does not deliver. Fix the beats or re-declare them honestly, then review again.`
+    );
+  }
+  if (duration3 >= CAMERA_FLOOR_MIN_DURATION && capture.cameraMoves === 0) {
+    failures.push(
+      "Zero camera moves. The house floor is at least one real camera move per film (camera.move / camera.focus) \u2014 a locked full-frame camera reads as a slideshow."
+    );
+  }
+  if (capture.deformations > 0) {
+    failures.push(
+      `${capture.deformations} geometry deformation violation(s) (aspect distortion \u2265 ${DEFORMATION_MAX_RATIO}:1). Fix the scaling before export.`
+    );
+  }
+  if (capture.longestDeadAirSeconds > DEAD_AIR_BLOCK_SECONDS) {
+    failures.push(
+      `A ${capture.longestDeadAirSeconds.toFixed(1)}s dead-air span exceeds the ${DEAD_AIR_BLOCK_SECONDS}s ceiling. Rest is legitimate; abandonment is not \u2014 decide what owns that time.`
+    );
+  }
+  return failures;
+}
+
+// src/mcp/quality-loop.ts
+var QUALITY_LOOP_ENV = "IMPRACTICAL_QUALITY_LOOP";
+var meaningful = (label, minimum = 12) => external_exports.string().trim().min(minimum, `${label} must be specific enough to direct from.`);
+var creativeContractSchema = external_exports.object({
+  audience: meaningful("audience", 3),
+  singleIdea: meaningful("singleIdea"),
+  visualProof: meaningful("visualProof"),
+  referenceStrategy: meaningful("referenceStrategy"),
+  productSource: meaningful("productSource"),
+  opening: meaningful("opening"),
+  proof: meaningful("proof"),
+  payoff: meaningful("payoff")
+});
+var qualityScoresSchema = external_exports.object({
+  narrativeClarity: external_exports.number().int().min(1).max(5),
+  visualProof: external_exports.number().int().min(1).max(5),
+  productAuthenticity: external_exports.number().int().min(1).max(5),
+  composition: external_exports.number().int().min(1).max(5),
+  legibility: external_exports.number().int().min(1).max(5),
+  pacing: external_exports.number().int().min(1).max(5),
+  referenceFidelity: external_exports.number().int().min(1).max(5),
+  technicalIntegrity: external_exports.number().int().min(1).max(5)
+});
+var qualityReviewSchema = external_exports.object({
+  reviewedRevision: external_exports.number().int().min(0),
+  singleIdea: meaningful("singleIdea"),
+  visualProof: meaningful("visualProof"),
+  referenceComparison: meaningful("referenceComparison"),
+  scores: qualityScoresSchema,
+  timestampEvidence: external_exports.array(
+    external_exports.object({
+      time: external_exports.number().min(0),
+      finding: meaningful("finding", 5)
+    })
+  ).min(3),
+  blockingIssues: external_exports.array(external_exports.string().trim().min(1))
+});
+var FRAME_RESOLVE_TOLERANCE_SECONDS = 0.6;
+var createQualityLoopState = () => ({
+  finalReviewByDraft: /* @__PURE__ */ new Map(),
+  finalMotionReviewByDraft: /* @__PURE__ */ new Map(),
+  lockedContentByDraft: /* @__PURE__ */ new Map(),
+  beatsByDraft: /* @__PURE__ */ new Map(),
+  referenceLedger: null,
+  scoreSignatures: /* @__PURE__ */ new Map()
+});
+function qualityLoopEnabled(env = process.env) {
+  return !/^(0|false|off|no)$/i.test(env[QUALITY_LOOP_ENV]?.trim() ?? "");
+}
+var hasOpening = (times) => times.some((time3) => time3 <= 0.15);
+var hasEnding = (times, duration3) => duration3 <= 0 || times.some((time3) => time3 >= Math.max(0, duration3 - 0.25));
+function finalReviewCoverageError(times, duration3) {
+  if (times.length < 8) return "Final review needs at least 8 representative frames.";
+  if (!hasOpening(times)) return "Final review must include the opening frame at t=0.";
+  if (!hasEnding(times, duration3)) {
+    return `Final review must include a settled closing frame near t=${duration3.toFixed(2)}s.`;
+  }
+  return null;
+}
+function recordFinalReviewCapture(state, draftId, capture) {
+  state?.finalReviewByDraft.set(draftId, capture);
+}
+function qualityReviewPrompt(mode, contract) {
+  const contractNote = contract ? `
+Creative contract: ${contract.singleIdea} Visual proof: ${contract.visualProof}` : "";
+  if (mode === "proof") {
+    return "\nQUALITY LOOP \u2014 PROOF-SHOT REVIEW. Judge the visible pixels, not the effort or code. Answer with timestamped evidence: (1) can a stranger understand the product transformation, (2) is the real product large and legible, (3) is the result impressive without explanatory copy, (4) is reconstructed UI clearly disclosed rather than called exact, and (5) what must change before building the rest of the film. Do not describe the shot as merely clean." + contractNote;
+  }
+  if (mode === "final") {
+    return "\nQUALITY LOOP \u2014 FINAL CRITIC REVIEW. Treat this as a fresh design-director pass. Score 1\u20135 with timestamped visible evidence: narrative clarity, visual proof, product authenticity, composition/hierarchy, legibility, pacing/variation, reference fidelity, and technical integrity. An empty opening, unreadable product UI, an unsupported marketing claim, stale/reconstructed UI presented as exact, any score below 3, or an average below 4 blocks export. Do not reward implementation effort and do not equate artifact-free with good." + contractNote;
+  }
+  return "\nQUALITY LOOP \u2014 LAYOUT REVIEW. Identify the primary subject at each timestamp and report clipping, unreadable text, weak occupancy, competing hierarchy, missing assets, or empty frames. Use visible evidence rather than saying the frames look clean.";
+}
+function motionCoverageFailure(input) {
+  if (!input.motionLab) return null;
+  if (!input.capture) {
+    return 'The motion lab requires full-duration motion coverage: call get_motion({ draftId, reviewMode: "final" }) and resolve the dead air and imperceptible tweens it reports before exporting.';
+  }
+  if (input.capture.revision !== input.frameReviewRevision) {
+    return `The motion review covered revision ${input.capture.revision}, but the final frame review covered revision ${input.frameReviewRevision}. Review the same revision with both.`;
+  }
+  return null;
+}
+function framingMotionFailure(capture) {
+  if (!capture?.framingFailures?.length) return null;
+  return "The final motion review found broken framing \u2014 fix these shots and review again:\n" + capture.framingFailures.map((finding) => `- ${finding}`).join("\n");
+}
+function craftMotionFailure(input) {
+  if (!input.craftLab) return null;
+  const craft = input.capture?.craft;
+  if (!craft) return null;
+  const failures = craftGateFailures(craft, input.capture?.duration ?? 0);
+  if (!failures.length) return null;
+  return `Craft floors block export: ${failures.join(" ")}`;
+}
+function qualityReviewFailure(input) {
+  const { draftRevision, capture, review } = input;
+  if (!capture) {
+    return 'No eligible final review exists. Call get_frames with reviewMode="final" on at least 8 timestamps including t=0 and the settled closing frame.';
+  }
+  if (capture.revision !== draftRevision) {
+    return `The final review covered revision ${capture.revision}, but the draft is now revision ${draftRevision}. Review the current revision again.`;
+  }
+  if (!review) {
+    return "Attach the timestamped qualityReview scorecard required by the local quality loop.";
+  }
+  if (review.reviewedRevision !== draftRevision) {
+    return `qualityReview says revision ${review.reviewedRevision}, but the current draft is revision ${draftRevision}.`;
+  }
+  if (review.blockingIssues.length) {
+    return `The review still has blocking issues: ${review.blockingIssues.join("; ")}`;
+  }
+  const unresolved = capture.times.filter(
+    (time3) => !review.timestampEvidence.some((entry) => Math.abs(entry.time - time3) <= FRAME_RESOLVE_TOLERANCE_SECONDS)
+  );
+  if (unresolved.length) {
+    return `Unverified frames: the final capture rendered stills at ${capture.times.map((t) => t.toFixed(1)).join(", ")}s but timestampEvidence resolves nothing near t=${unresolved.map((t) => t.toFixed(1)).join(", ")}s. Look at each captured frame and record what you actually see there \u2014 every still must be marked with a finding before export. If your context was compacted since the capture, call get_frames again: summarized claims about frames you can no longer see do not count.`;
+  }
+  if (input.craftLab) {
+    if (input.scoreSignatures && input.draftId) {
+      const signature = JSON.stringify(review.scores);
+      const previous = input.scoreSignatures.get(signature);
+      if (previous && previous !== input.draftId) {
+        return "This scorecard is identical to one already submitted for a different draft this session. Review THIS film with fresh eyes \u2014 identical numbers across different films are a rubber stamp, not a judgment.";
+      }
+      input.scoreSignatures.set(signature, input.draftId);
+    }
+    return null;
+  }
+  const scores = Object.entries(review.scores);
+  const low = scores.filter(([, score]) => score < 3);
+  if (low.length) {
+    return `Scores below 3 block export: ${low.map(([name, score]) => `${name}=${score}`).join(", ")}.`;
+  }
+  const average = scores.reduce((sum, [, score]) => sum + score, 0) / scores.length;
+  if (average < 4) return `Quality score average ${average.toFixed(2)} is below the 4.0 export floor.`;
+  return null;
+}
+function qualityLoopServerInstructions() {
+  return `
+
+LOCAL QUALITY LOOP IS ENABLED \u2014 this is an opt-in experiment and it is mandatory for new videos:
+1. Before create_video, write and pass its creativeContract: audience, one memorable idea, one visible proof, how the reference will be translated rather than copied, the real product source, and opening/proof/payoff beats.
+2. Build the proof beat first. Call get_frames with reviewMode="proof" and judge whether the product transformation is understandable and impressive before completing the rest.
+3. After the complete cut, call get_frames with reviewMode="final" on at least 8 representative timestamps including t=0 and the settled closing frame. Score what is visibly present; "clean" is not a verdict. Every captured still is an open observation: your qualityReview's timestampEvidence must record a finding at each captured time, or export is blocked with the unresolved list. If your context is ever compacted, re-run get_frames before exporting \u2014 claims about frames you can no longer see do not count.
+4. Export only with a timestamped qualityReview for the exact reviewed revision. Any unresolved blocking issue, score below 3, or average below 4 must be fixed and reviewed again.
+This loop changes no scene schema or renderer behavior. It exists to stop technically valid but creatively weak cuts from self-approving.`;
+}
+
+// src/mcp/phased-flow.ts
+var PHASED_FLOW_ENV = "IMPRACTICAL_PHASED_FLOW";
+function phasedFlowEnabled(env = process.env) {
+  return !/^(0|false|off|no)$/i.test(env[PHASED_FLOW_ENV]?.trim() ?? "");
+}
+var meaningful2 = (label, minimum) => external_exports.string().trim().min(minimum, `${label} must be specific enough to direct from.`);
+var conceptSchema = external_exports.object({
+  /** One sentence: product, user, and the change the viewer will believe. */
+  premise: meaningful2("premise", 20),
+  /** The thing the viewer follows across the whole film (an invoice, a request…). */
+  recurringArtifact: meaningful2("recurringArtifact", 6),
+  /** Evidence gathered BEFORE inventing UI: real code, the product site, images. */
+  references: external_exports.array(
+    external_exports.object({
+      kind: external_exports.enum(["local-code", "website", "screenshot", "image-search"]),
+      detail: meaningful2("reference detail", 5)
+    })
+  ).min(1, "Gather at least one real reference before designing components."),
+  /** Every beat names a MOVE — a beat with no move is not a beat. */
+  beats: external_exports.array(
+    external_exports.object({
+      start: external_exports.number().min(0),
+      end: external_exports.number().min(0),
+      subject: meaningful2("beat subject", 3),
+      move: meaningful2("beat move", 8),
+      purpose: meaningful2("beat purpose", 5),
+      /** Declared energy: rest is legitimate stillness; high must visibly move. */
+      energy: external_exports.enum(["rest", "low", "high"]),
+      /**
+       * What happens to the elements ALREADY on stage when this beat starts:
+       * exit (and how), transform, or deliberately stay. First beat may say
+       * "empty stage". Entrances are cheap; exits are choreography, and a
+       * beat that only describes what enters leaves the last scene's props
+       * loitering in frame.
+       */
+      outgoing: meaningful2("beat outgoing (what the elements already on stage do)", 6)
+    })
+  ).min(4),
+  /**
+   * Every component the film will show, each answering: must this look 1:1
+   * real? 'exact-product' = the actual product's UI; 'realistic-class' = a
+   * real-world object class (a terminal, an invoice); 'stylized' = abstract/
+   * editorial, no reference needed. Non-stylized components MUST name the
+   * reference source that was pulled and viewed for them.
+   */
+  componentInventory: external_exports.array(
+    external_exports.object({
+      name: meaningful2("component", 3),
+      realism: external_exports.enum(["exact-product", "realistic-class", "stylized"]),
+      referenceSource: external_exports.string().trim().min(4).optional()
+    })
+  ).min(1)
+});
+var contentSchema = external_exports.object({
+  /** Every editorial line the film will show, in viewing order. Locked. */
+  lines: external_exports.array(
+    external_exports.object({
+      text: external_exports.string().trim().min(2).max(90),
+      kind: external_exports.enum(["statement", "label", "endcard"])
+    })
+  ).min(3)
+});
+function phasedGateFailure(args) {
+  if (!args.concept || !args.content) {
+    return "The phased flow requires BOTH `concept` and `content` before scaffolding. Phase 1 (concept): from the brief alone \u2014 premise, recurringArtifact, references (look for the product's real code or site FIRST), beats (each with start, end, subject, move, purpose, energy, and outgoing \u2014 what the elements already on stage do when the beat starts), componentInventory. Phase 2 (content): every editorial line the film will show, in viewing order, each marked statement/label/endcard, written so someone who has never heard of the product could repeat it. Do this BEFORE studying the engine or library. The lines are locked: the motion report diffs the rendered film against them.";
+  }
+  const concept = conceptSchema.safeParse(args.concept);
+  if (!concept.success) {
+    const issue2 = concept.error.issues[0];
+    const at = issue2?.path?.length ? ` at ${issue2.path.join(".")}` : "";
+    return `concept invalid${at}: ${issue2?.message ?? "schema mismatch"}`;
+  }
+  const content = contentSchema.safeParse(args.content);
+  if (!content.success) {
+    const issue2 = content.error.issues[0];
+    const at = issue2?.path?.length ? ` at ${issue2.path.join(".")}` : "";
+    return `content invalid${at}: ${issue2?.message ?? "schema mismatch"}`;
+  }
+  const missing = concept.data.componentInventory.filter(
+    (component) => component.realism !== "stylized" && !component.referenceSource
+  );
+  if (missing.length) {
+    return `concept invalid: these components are marked as needing realism but have no referenceSource: ${missing.map((component) => component.name).join(", ")}. For each, pull a real reference image (gather_references / your image search), VIEW it, and record its source \u2014 or mark the component stylized if it genuinely needs no real-world counterpart.`;
+  }
+  return null;
+}
+var CONTENT_DOCTRINE_ENV = "IMPRACTICAL_CONTENT_DOCTRINE";
+function contentDoctrineEnabled(env = process.env) {
+  return !/^(0|false|off|no)$/i.test(env[CONTENT_DOCTRINE_ENV]?.trim() ?? "");
+}
+var contentDoctrine = () => contentDoctrineEnabled() ? ` Write every line so a smart 16-year-old who has never heard of the product gets it on first read \u2014 if they couldn't repeat it back in their own words, rewrite it. No insider jargon: name what the thing DOES in plain words, not its category ("your agent gets its own email address", never "agentic email infrastructure"). Say it, then show it: a statement makes ONE plain claim, and the very next thing the film does is prove that claim on camera. One thing to read at a time \u2014 never two lines competing for the same moment.` : " Write them plain enough for someone who has never heard of the product.";
+var contentTextRule = () => contentDoctrineEnabled() ? " That floor governs EDITORIAL lines \u2014 the film's own statements and labels \u2014 and it is not a ban on words inside the product you are showing. Recreate the product's own content as real, plausible words at whatever size the real interface uses. NEVER replace product content with grey placeholder bars or skeleton rectangles: a wireframe reads as a loading screen, and a film that claims the software works while showing an empty shell has proved nothing. Small real text is what makes an interface look real; the rule is that the viewer must never NEED to read it, not that it must be absent." : "";
+function phasedServerInstructions() {
+  return `
+
+PHASED FLOW IS ENABLED \u2014 work in three phases, in order:
+1. CONCEPT \u2014 from the brief alone, before engine_types or motion_context: FIRST study references, then call gather_references (required \u2014 create_video refuses without it). If you have native web/image search and an image-viewing tool, USE THEM: search real screenshots of the product in use and of each component class, download and VIEW them before designing anything. Hunt references of the ACTUAL SOFTWARE, not the marketing homepage \u2014 the product's real front-end code on this machine (pass it as appCode) \u2192 screenshots of the product IN USE (its app/editor/dashboard, found via its docs, help center, changelog, demo videos, review sites) \u2192 its site code \u2192 marketing site (styling tokens only) \u2192 real images of the component class \u2192 mockups; design components to match what the references actually show. Then ask of every component the film will show: MUST THIS LOOK 1:1 REAL? Product UI and real-world objects (a terminal, an invoice, a dashboard) do; abstract backdrops and statement cards do not. For each realism-required component, pull a real reference image, VIEW it, and record it as that component's referenceSource in the inventory. Then write the premise, the one recurring artifact the viewer follows, and beats where every beat names a MOVE, declares its energy (rest / low / high) \u2014 rest is legitimate stillness, high must visibly move; the motion report verdicts each beat against its declaration \u2014 and declares its OUTGOING: what the elements already on stage do when this beat starts. Nothing new enters without saying what the things still showing do \u2014 exit (and how), transform into the new thing, or deliberately stay. Entrances are cheap; exits are choreography. A beat that only describes what arrives leaves the last scene's props loitering in frame. The first beat may say "empty stage".
+2. CONTENT \u2014 write every editorial line of the film in viewing order (statement/label/endcard).${contentDoctrine()} Statements are the big lines the film is built around \u2014 10-15% of frame height each; no text anyone MUST read below 4% unless the user explicitly asks.${contentTextRule()} These lines are LOCKED once passed to create_video: the motion report flags any on-screen line that is not in the list, and any listed line the camera never shows.
+RUNTIME \u2014 when the user gives no duration, plan 20-30 seconds and EARN it with at least two distinct proof chapters (different capabilities or angles), never by stretching holds. A user-specified runtime always wins.
+3. CREATION \u2014 only now read engine_types and motion_context. Call install_kits on the new draft FIRST and import the primitives from './kit/*' \u2014 the cursor actor, showpieces, looks and sentence typography are already built and tuned; hand-rolling them produces cursors that teleport and clicks that fire early. Then cast the beats onto the library and kits, build, measure, revise, review, export.
+create_video requires the concept and content artifacts and will refuse without them.`;
+}
+
+// src/mcp/preflight.ts
+var esbuildPromise = null;
+function loadEsbuild() {
+  esbuildPromise ??= import("./main-BEONOBG5.js").then(
+    (mod) => mod,
+    () => null
+  );
+  return esbuildPromise;
+}
+var LOADERS = {
+  ".tsx": "tsx",
+  ".ts": "ts",
+  ".jsx": "jsx",
+  ".js": "js",
+  ".css": "css",
+  ".json": "json"
+};
+function resolveDraftPath(files, request) {
+  const clean = request.replace(/^\.\//, "");
+  const candidates = [
+    clean,
+    `${clean}.ts`,
+    `${clean}.tsx`,
+    `${clean}.js`,
+    `${clean}.jsx`,
+    `${clean}/index.ts`,
+    `${clean}/index.tsx`
+  ];
+  return candidates.find((candidate) => candidate in files) ?? null;
+}
+async function preflightDraft(files) {
+  const assetErrors = [...assetReferenceErrors(files), ...unbundledFontErrors(files)];
+  if (assetErrors.length) return assetErrors.join("\n");
+  const esbuild = await loadEsbuild();
+  if (!esbuild) return null;
+  const entries = ["App.tsx", "direction.ts"].filter((entry) => entry in files);
+  if (!entries.length) return null;
+  try {
+    await esbuild.build({
+      entryPoints: entries.map((entry) => `draft:${entry}`),
+      bundle: true,
+      write: false,
+      // write:false never touches disk; outdir is still required for multiple entries.
+      outdir: "preflight-virtual",
+      platform: "browser",
+      format: "esm",
+      logLevel: "silent",
+      plugins: [
+        {
+          name: "draft-virtual-fs",
+          setup(build) {
+            build.onResolve({ filter: /^draft:/ }, (args) => ({
+              path: args.path.slice("draft:".length),
+              namespace: "draft"
+            }));
+            build.onResolve({ filter: /.*/ }, (args) => {
+              if (args.namespace !== "draft") return void 0;
+              if (args.path.startsWith("./")) {
+                const dir = args.importer.includes("/") ? args.importer.slice(0, args.importer.lastIndexOf("/") + 1) : "";
+                const joined = dir + args.path.slice(2);
+                const resolved2 = resolveDraftPath(files, joined);
+                if (resolved2) return { path: resolved2, namespace: "draft" };
+                return {
+                  errors: [
+                    {
+                      text: `"${args.path}" (from ${args.importer}) does not match any draft file. Draft files: ${Object.keys(files).sort().join(", ")}`
+                    }
+                  ]
+                };
+              }
+              return { path: args.path, external: true };
+            });
+            build.onLoad({ filter: /.*/, namespace: "draft" }, (args) => {
+              const ext = args.path.slice(args.path.lastIndexOf("."));
+              return {
+                contents: files[args.path],
+                loader: LOADERS[ext] ?? "ts"
+              };
+            });
+          }
+        }
+      ]
+    });
+    return null;
+  } catch (error51) {
+    const message = error51 instanceof Error ? error51.message : String(error51);
+    return message;
+  }
+}
+var URL_REF_RE = /(?<![\w.$])(?<!new\s)url\(\s*(['"])([^'"\n]{1,300})\1\s*\)/gi;
+var FONT_EXT_RE = /\.(woff2?|ttf|otf|eot)(\?|#|$)/i;
+var ALLOWED_FONT_HOSTS = /* @__PURE__ */ new Set(["fonts.googleapis.com", "fonts.gstatic.com"]);
+function hostOf(reference) {
+  try {
+    return new URL(reference).hostname;
+  } catch {
+    return null;
+  }
+}
+function assetReferenceErrors(files) {
+  const errors = [];
+  for (const [file2, content] of Object.entries(files)) {
+    if (typeof content !== "string") continue;
+    for (const match of content.matchAll(URL_REF_RE)) {
+      const reference = match[2].trim();
+      if (!reference || reference.startsWith("#")) continue;
+      if (reference.includes("${")) continue;
+      if (/^(data|blob):/i.test(reference)) continue;
+      if (/^https?:/i.test(reference) || reference.startsWith("//")) {
+        if (FONT_EXT_RE.test(reference)) {
+          const host = hostOf(reference.startsWith("//") ? `https:${reference}` : reference);
+          if (!host || !ALLOWED_FONT_HOSTS.has(host)) {
+            errors.push(
+              `${file2}: url('${reference}') loads a font from a host the render blocks. Use install_font to inline the family, or a fonts.googleapis.com stylesheet.`
+            );
+          }
+        }
+        continue;
+      }
+      if (reference.startsWith("/")) {
+        if (!/^\/(scenes|brands)\//.test(reference)) {
+          errors.push(
+            `${file2}: url('${reference}') is an absolute path outside the workspace roots \u2014 nothing serves it at render time. Assets live under /scenes/<scene>/\u2026 or /brands/<slug>/\u2026 (see brand_get), or inline with install_font / data: URIs.`
+          );
+        }
+        continue;
+      }
+      const clean = reference.replace(/[?#].*$/, "");
+      if (!resolveDraftPath(files, clean) && !(clean in files)) {
+        errors.push(
+          `${file2}: url('${reference}') does not match any draft file, so the render will fail with a NetworkError (fonts report "Render font failed to load"). Drafts cannot hold binary assets \u2014 use install_font to inline an open-licensed font, reference the brand kit's real files by absolute path (/brands/<slug>/fonts/\u2026, from brand_get), or a data: URI.`
+        );
+      }
+    }
+  }
+  return errors;
+}
+var BUNDLED_FAMILY_ALIASES = new Set(
+  [
+    "Space Grotesk",
+    "Impractical Space Grotesk",
+    "Geist",
+    "Geist Variable",
+    "Geist Mono",
+    "Geist Mono Variable",
+    "Inter",
+    "Inter Variable"
+  ].map((family) => family.toLowerCase())
+);
+var PORTABLE_FAMILIES = /* @__PURE__ */ new Set([
+  "-apple-system",
+  "blinkmacsystemfont",
+  "system-ui",
+  "ui-sans-serif",
+  "ui-serif",
+  "ui-monospace",
+  "ui-rounded",
+  "sans-serif",
+  "serif",
+  "monospace",
+  "cursive",
+  "fantasy",
+  "emoji",
+  "math",
+  "fangsong"
+]);
+var GENERIC_STACK_TAIL_RE = /(system-ui|sans-serif|serif|monospace|ui-monospace|ui-sans-serif|ui-serif)\s*$/i;
+var FONT_FACE_FAMILY_RE = /@font-face[^}]*?font-family:\s*['"]?([^'";}]+)/gi;
+var CSS_FONT_FAMILY_RE = /font-family:\s*([^;}\n]+)/gi;
+var JS_FONT_FAMILY_RE = /fontFamily:\s*(['"`])([^'"`\n]+)\1/g;
+var STACK_LITERAL_RE = /(['"`])([A-Za-z][\w '.-]*(?:,\s*[\w '.-]+)+)\1/g;
+function primaryFamily(stack) {
+  return (stack.split(",")[0] ?? "").trim().replace(/^['"]|['"]$/g, "");
+}
+function unbundledFontErrors(files) {
+  const declared = /* @__PURE__ */ new Set();
+  for (const content of Object.values(files)) {
+    if (typeof content !== "string") continue;
+    for (const match of content.matchAll(FONT_FACE_FAMILY_RE)) {
+      declared.add(primaryFamily(match[1]).toLowerCase());
+    }
+  }
+  const resolvable = (family) => {
+    const normalized = family.toLowerCase();
+    return !normalized || normalized.includes("${") || BUNDLED_FAMILY_ALIASES.has(normalized) || PORTABLE_FAMILIES.has(normalized) || declared.has(normalized);
+  };
+  const errors = [];
+  const flagged = /* @__PURE__ */ new Set();
+  const flag = (file2, family) => {
+    const key = `${file2}\0${family.toLowerCase()}`;
+    if (flagged.has(key)) return;
+    flagged.add(key);
+    errors.push(
+      `${file2}: font-family leads with "${family}", which is neither bundled (Space Grotesk, Geist, Geist Mono, Inter), declared via @font-face in the draft, nor a portable generic. The render guard will throw and the stage will never reach ready \u2014 no frame can show you this. Use a bundled family, or install_font to inline an open-licensed face, and say so if you substituted.`
+    );
+  };
+  for (const [file2, content] of Object.entries(files)) {
+    if (typeof content !== "string") continue;
+    if (file2.endsWith(".json") || file2.endsWith(".md")) continue;
+    const stacks = [];
+    if (file2.endsWith(".css")) {
+      for (const match of content.matchAll(CSS_FONT_FAMILY_RE)) stacks.push(match[1]);
+    } else {
+      for (const match of content.matchAll(JS_FONT_FAMILY_RE)) stacks.push(match[2]);
+      for (const match of content.matchAll(STACK_LITERAL_RE)) {
+        if (GENERIC_STACK_TAIL_RE.test(match[2])) stacks.push(match[2]);
+      }
+      for (const match of content.matchAll(CSS_FONT_FAMILY_RE)) stacks.push(match[1]);
+    }
+    for (const stack of stacks) {
+      const family = primaryFamily(stack);
+      if (!resolvable(family)) flag(file2, family);
+    }
+  }
+  return errors;
+}
+
+// src/mcp/tools.ts
+var createSessionState = () => ({
+  lastCaptureByDraft: /* @__PURE__ */ new Map(),
+  measuredByDraft: /* @__PURE__ */ new Map()
+});
+var json2 = (value) => ({ text: JSON.stringify(value, null, 2) });
+var fail = (text) => ({ text, isError: true });
+var nap = (ctx, ms) => ctx.sleep ? ctx.sleep(ms) : new Promise((resolve) => setTimeout(resolve, ms));
+var TERMINAL = /* @__PURE__ */ new Set(["completed", "failed", "canceled"]);
+var POLL_ERROR_LIMIT = 5;
+var JOB_WAIT_SECONDS = 300;
+var BRAND_WAIT_SECONDS = 300;
+var MAX_WAIT_SECONDS = 540;
+var maxWaitSeconds = () => {
+  const override = Number(process.env.IMPRACTICAL_MAX_WAIT_SECONDS);
+  return Number.isFinite(override) && override > 0 ? override : MAX_WAIT_SECONDS;
+};
+function waitBudgetMs(requested, fallbackSeconds) {
+  const asked = Number(requested);
+  const seconds = Number.isFinite(asked) && asked > 0 ? asked : fallbackSeconds;
+  return Math.min(seconds, maxWaitSeconds()) * 1e3;
+}
+var waitWasClamped = (requested) => {
+  const asked = Number(requested);
+  return Number.isFinite(asked) && asked > maxWaitSeconds();
+};
+var clampNote = (requested) => waitWasClamped(requested) ? ` Waiting was capped at ${maxWaitSeconds()}s (you asked for ${Number(requested)}s) because MCP clients drop a request that stays open too long, which would report this job as failed while it is still running.` : "";
+function describeJob(jobId, row, consecutiveErrors, lastError) {
+  if (consecutiveErrors) return `${jobId}: status check failed (${lastError}), retrying`;
+  const stage = row?.stage ? ` \u2014 ${row.stage}` : "";
+  const pct = typeof row?.progress === "number" ? ` ${Math.round(row.progress * 100)}%` : "";
+  return `${jobId}: ${row?.status ?? "queued"}${stage}${pct}`;
+}
+var resumeWith = (jobId) => `job_status({ jobIds: ["${jobId}"], wait: true })`;
+var px = (value) => String(Math.round(value));
+var describeRect = (el) => `${el.sel} ${px(el.w)}\xD7${px(el.h)}@(${px(el.x)},${px(el.y)})`;
+var listSome = (sels, cap = 6) => sels.slice(0, cap).join(", ") + (sels.length > cap ? ` +${sels.length - cap} more` : "");
+function renderMeasured(draftId, measured, previous) {
+  const placed = measured.elements.filter((el) => !el.hidden && !el.offstage);
+  const hidden = measured.elements.filter((el) => el.hidden || el.offstage);
+  const lines = [
+    `MEASURED ${draftId} @ revision ${measured.revision}: duration ${measured.duration.toFixed(2)}s, ${measured.tweenCount} tween(s), ${placed.length} data-attributed element(s) placed at t=0` + (measured.truncated ? ` (+${measured.truncated} beyond the reporting cap)` : "") + ". This is what the build produced, not what the code intended."
+  ];
+  if (placed.length) {
+    lines.push("  " + placed.slice(0, 12).map(describeRect).join(" \xB7 ") + (placed.length > 12 ? ` \xB7 +${placed.length - 12} more` : ""));
+  }
+  if (hidden.length) {
+    lines.push(`  not visible at t=0: ${listSome(hidden.map((el) => el.sel))}`);
+  }
+  if (previous) {
+    const visible = (stage) => new Map(stage.elements.filter((el) => !el.hidden && !el.offstage).map((el) => [el.sel, el]));
+    const before = visible(previous);
+    const after = visible(measured);
+    const appeared = [...after.keys()].filter((sel) => !before.has(sel));
+    const gone = [...before.keys()].filter((sel) => !after.has(sel));
+    const moved = [...after.entries()].filter(([sel, el]) => {
+      const prior = before.get(sel);
+      return prior && (Math.abs(prior.x - el.x) + Math.abs(prior.y - el.y) > 1.5 || Math.abs(prior.w - el.w) + Math.abs(prior.h - el.h) > 1.5);
+    }).map(([sel]) => sel);
+    const deltas = [
+      appeared.length ? `appeared: ${listSome(appeared)}` : "",
+      gone.length ? `gone: ${listSome(gone)}` : "",
+      moved.length ? `moved/resized: ${listSome(moved)}` : ""
+    ].filter(Boolean);
+    lines.push(`  vs revision ${previous.revision}: ${deltas.length ? deltas.join("; ") : "no layout change at t=0"}`);
+  }
+  return lines.join("\n");
+}
+async function measuredBlock(ctx, rows) {
+  if (!ctx.measurePreview) return "";
+  const byDraft = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    if (row.status !== "completed" || row.master || !row.draft_id) continue;
+    byDraft.set(row.draft_id, row);
+  }
+  const parts = [];
+  for (const [draftId, row] of byDraft) {
+    const previous = ctx.sessionState?.measuredByDraft.get(draftId);
+    if (previous && row.revision != null && previous.revision === row.revision) continue;
+    try {
+      const measured = await ctx.measurePreview(ctx, draftId);
+      if (previous && previous.revision === measured.revision) continue;
+      ctx.sessionState?.measuredByDraft.set(draftId, measured);
+      parts.push(renderMeasured(draftId, measured, previous));
+    } catch (error51) {
+      parts.push(
+        `MEASUREMENT UNAVAILABLE for ${draftId}: ${error51 instanceof Error ? error51.message : String(error51)} \u2014 use get_frames to verify instead.`
+      );
+    }
+  }
+  return parts.length ? "\n\n" + parts.join("\n") : "";
+}
+var getDraft = (ctx, draftId) => ctx.invoke("get-draft", { draftId });
+var studioLink = (ctx, projectId, slug) => {
+  const base = (ctx.appUrl ?? "https://motion.impractical.ai").replace(/\/$/, "");
+  return `${base}/projects/${projectId}/studio${slug ? `?scene=${slug}` : ""}`;
+};
+async function saveDraft(ctx, draftId, apply) {
+  let conflicts = 0;
+  while (true) {
+    const draft = await getDraft(ctx, draftId);
+    if (draft.lockedByJobId) {
+      return fail(
+        `Draft ${draftId} is locked by job ${draft.lockedByJobId}. Wait for it with job_status({ jobIds: ["${draft.lockedByJobId}"], wait: true }), then retry.`
+      );
+    }
+    const change = apply(draft);
+    const changedCount = Object.keys(change.files).length;
+    if (!changedCount && !change.deletedPaths.length) {
+      return { text: `No change \u2014 the draft already matches at revision ${draft.revision}.` };
+    }
+    const merged = { ...draft.files, ...change.files };
+    for (const deleted of change.deletedPaths) delete merged[deleted];
+    const preflightError = await preflightDraft(merged);
+    if (preflightError) {
+      return fail(
+        "Local build preflight failed \u2014 nothing was sent to the cloud, fix and save again:\n" + preflightError
+      );
+    }
+    try {
+      const saved = await ctx.invoke("save-draft", {
+        draftId,
+        expectedRevision: draft.revision,
+        files: change.files,
+        deletedPaths: change.deletedPaths
+      });
+      ctx.qualityLoopState?.finalReviewByDraft.delete(draftId);
+      ctx.qualityLoopState?.finalMotionReviewByDraft.delete(draftId);
+      const staleNotes = [];
+      const changedPaths = Object.keys(change.files);
+      if (changedPaths.length) {
+        staleNotes.push(
+          `All prior reads of ${changedPaths.join(", ")} are stale as of revision ${saved.revision} \u2014 re-read before further exact-string edits to them.`
+        );
+      }
+      const capture = ctx.sessionState?.lastCaptureByDraft.get(draftId);
+      if (capture) {
+        staleNotes.push(
+          `The ${capture.times.length} frame(s) you captured at revision ${capture.revision} no longer show this draft \u2014 call get_frames again before judging this change.`
+        );
+      }
+      return reportBuildStart(draftId, saved, changedCount, change.deletedPaths.length, staleNotes);
+    } catch (error51) {
+      const status = error51.status;
+      const message = error51 instanceof Error ? error51.message : String(error51);
+      if (status === 409 && conflicts < 1 && !/locked by an active job/i.test(message)) {
+        conflicts += 1;
+        continue;
+      }
+      if (status === 409) {
+        return fail(
+          `Save rejected (409): ${message}. The draft changed underneath this edit \u2014 re-read the file and re-apply your change on top of the new content.`
+        );
+      }
+      throw error51;
+    }
+  }
+}
+function reportBuildStart(draftId, saved, changed, deleted, staleNotes = []) {
+  const summary = `Saved ${changed} file(s)` + (deleted ? `, deleted ${deleted}` : "") + ` as revision ${saved.revision}.`;
+  if (!saved.jobId) {
+    return json2({
+      committed: true,
+      draftId,
+      revision: saved.revision,
+      jobId: null,
+      previewQueued: false,
+      summary,
+      ...staleNotes.length ? { stale: staleNotes } : {},
+      note: "No preview build was queued \u2014 a draft needs both App.tsx and direction.ts before it can render."
+    });
+  }
+  return json2({
+    committed: true,
+    draftId,
+    revision: saved.revision,
+    jobId: saved.jobId,
+    previewQueued: true,
+    status: "queued",
+    summary,
+    ...staleNotes.length ? { stale: staleNotes } : {},
+    resumeWith: resumeWith(saved.jobId),
+    note: "The save committed. Do not re-apply it. Follow the preview build with resumeWith; if a transport timeout ever hides a mutation reply, read the changed file before retrying."
+  });
+}
+var accountStatus = {
+  name: "account_status",
+  title: "Show account, plan, and MCP usage",
+  description: "Show the connected workspace, current role, plan, weekly MCP usage, reset time, seats, and billing state. Run this once at the start of a session to confirm the connection works.",
+  inputSchema: {},
+  handler: async (_args, ctx) => json2(await ctx.invoke("workspace-bootstrap"))
+};
+var whoami = {
+  ...accountStatus,
+  name: "whoami",
+  title: "Show the connected workspace (legacy alias)",
+  description: "Deprecated alias for account_status. Use account_status to show the connected workspace, plan, weekly MCP usage, reset time, seats, and billing state."
+};
+var upgradeTool = {
+  name: "upgrade",
+  title: "Explain Pro and get the billing link",
+  description: "Explain what Pro costs and unlocks for this workspace, and return the authenticated billing URL. Only a workspace admin can buy \u2014 checking out subscribes the whole workspace. Set open=true only after the user explicitly asks to open it in their browser.",
+  inputSchema: {
+    open: external_exports.boolean().optional().describe("Open billing in the user's browser. Defaults to false.")
+  },
+  local: true,
+  handler: async (args, ctx) => {
+    const url2 = `${(ctx.appUrl ?? "https://motion.impractical.ai").replace(/\/$/, "")}/account/billing`;
+    const account = await ctx.invoke("workspace-bootstrap").catch(() => null);
+    const role = account?.role === "admin" ? "admin" : "member";
+    const canPurchase = role === "admin";
+    const plan = account?.plan ?? "free";
+    const seats = Math.max(1, account?.billing?.seatCount ?? 1);
+    const limit = account?.quota?.limit ?? FREE_WEEKLY_LIMIT;
+    const remaining = account?.quota?.remaining ?? 0;
+    const opened = args.open === true ? ctx.openExternal?.(url2) ?? false : false;
+    return json2({
+      plan,
+      role,
+      canPurchase,
+      price: { amountUsd: 50, per: "user / month" },
+      billedFor: `${seats} seat${seats === 1 ? "" : "s"} \u2014 every admin and member is a paid seat`,
+      unlocks: [
+        "Unlimited videos and exports \u2014 no weekly ceiling",
+        "Iterate on one video as many times as it takes",
+        "A dedicated allowance per person, not shared across workspaces"
+      ],
+      // Exact, because we meter calls. How many videos that is depends on how
+      // hard they iterate, so do not turn it into a per-user video count.
+      freePlanNow: limit >= 1e6 ? "This workspace is already on Pro." : `${remaining} of ${limit} free calls left this week (${FREE_WEEKLY_VIDEO_ESTIMATE}).`,
+      url: url2,
+      opened,
+      instructions: "Summarise the value in one or two sentences, then give the URL. Do not open a browser unless asked. " + (canPurchase ? "Checking out subscribes the whole workspace \u2014 say so before they act on it." : "Only a workspace admin can approve the purchase, so tell this user to ask an admin to upgrade.")
+    });
+  }
+};
+var listProjects = {
+  name: "list_projects",
+  title: "List video projects",
+  description: "List video projects in the connected workspace, newest first. Large workspaces: pass limit/offset to page instead of relying on a truncated dump, and nameFilter to search.",
+  inputSchema: {
+    limit: external_exports.number().int().min(1).max(200).optional().describe("Return at most this many projects (default: all)."),
+    offset: external_exports.number().int().min(0).optional().describe("Skip this many projects, for paging."),
+    nameFilter: external_exports.string().optional().describe("Case-insensitive substring match on the project name/slug.")
+  },
+  handler: async (args, ctx) => {
+    const result = await ctx.invoke("list-projects", {});
+    let projects = result.projects ?? [];
+    const total = projects.length;
+    const filter = typeof args.nameFilter === "string" ? args.nameFilter.trim().toLowerCase() : "";
+    if (filter) {
+      projects = projects.filter(
+        (project) => `${project.name ?? ""} ${project.slug ?? ""}`.toLowerCase().includes(filter)
+      );
+    }
+    const matched = projects.length;
+    const offset = typeof args.offset === "number" ? args.offset : 0;
+    const limit = typeof args.limit === "number" ? args.limit : projects.length;
+    projects = projects.slice(offset, offset + limit);
+    return json2({
+      total,
+      matched,
+      offset,
+      returned: projects.length,
+      hasMore: offset + projects.length < matched,
+      projects
+    });
+  }
+};
+var getProject = {
+  name: "get_project",
+  title: "Get one project",
+  description: "Get one project with its drafts (each draft is one cut of the video) and recent jobs. Use this to find the draftId you need for the editing tools.",
+  inputSchema: { projectId: external_exports.string().describe("The project id.") },
+  handler: async (args, ctx) => json2(await ctx.invoke("list-projects", { projectId: args.projectId }))
+};
+var createVideo = {
+  name: "create_video",
+  title: "Create a video project",
+  description: "Create a new video project and an empty draft for you to direct. This does NOT run Impractical's own director \u2014 it scaffolds App.tsx, direction.ts and brand.json and hands them to you. Read the `impractical://engine.d.ts` resource, then write the scene yourself with edit_draft_file / write_draft_files.",
+  inputSchema: {
+    valueProp: external_exports.string().min(1).describe("One or two sentences on what ships and why it matters."),
+    name: external_exports.string().optional().describe("Human-readable project name. Defaults to the slug."),
+    slug: external_exports.string().optional().describe("URL-safe project slug. Generated when omitted."),
+    vibe: external_exports.string().optional().describe("Tone, e.g. 'confident'. Defaults to 'confident'."),
+    brandSlug: external_exports.string().optional().describe("Brand kit slug from brand_list. Its colors and fonts become brand.json."),
+    appCode: external_exports.string().optional().describe("The product's front-end code, used as the starting point for App.tsx."),
+    templateId: external_exports.string().optional().describe("Template id recommended by motion_context. Defaults to a blank direction."),
+    templateParams: external_exports.record(external_exports.string(), external_exports.string()).optional().describe("Parameters for templateId, using the schema returned by motion_context."),
+    motionContextId: external_exports.string().optional().describe(
+      "contextId from the motion_context result. Pins the draft to the personalized recommendations that produced it. Omit to resolve a fresh context."
+    ),
+    creativeContract: creativeContractSchema.optional().describe(
+      "Required only when the local quality-loop experiment is enabled: the audience, one memorable idea, visible proof, reference strategy, product source, and opening/proof/payoff."
+    ),
+    concept: conceptSchema.optional().describe(
+      "Required only when the phased flow is enabled: premise, recurringArtifact, references, beats (each with a MOVE), and componentInventory \u2014 authored from the brief alone."
+    ),
+    content: contentSchema.optional().describe(
+      "Required only when the phased flow is enabled: every editorial line in viewing order (claim/label/endcard). Locked \u2014 the motion report diffs the film against these lines."
+    )
+  },
+  handler: async (args, ctx) => {
+    if (ctx.qualityLoop && !args.creativeContract) {
+      return fail(
+        "The local quality loop requires creativeContract before scaffolding. Name the audience, singleIdea, visualProof, referenceStrategy, productSource, opening, proof, and payoff. This is a planning gate only; it does not change the scene schema."
+      );
+    }
+    if (ctx.phasedFlow) {
+      const gate = phasedGateFailure({ concept: args.concept, content: args.content });
+      if (gate) return fail(gate);
+      if (!ctx.qualityLoopState?.referenceLedger) {
+        return fail(
+          "The phased flow requires gather_references BEFORE create_video: record the real references this film is designed against (or an honest noneFound after exhausting the ladder: local code -> product site -> screenshots -> component-class images)."
+        );
+      }
+    }
+    let brand = null;
+    if (args.brandSlug) {
+      const result = await ctx.invoke("brand-kits", {
+        action: "get",
+        slug: args.brandSlug
+      });
+      brand = result.brand;
+    }
+    const valueProp = String(args.valueProp).trim();
+    const slug = args.slug ?? `${valueProp.toLowerCase().replace(/[^a-z0-9\s-]/g, "").trim().split(/\s+/).slice(0, 4).join("-") || "video"}-${Math.floor(Math.random() * 65536).toString(16).padStart(4, "0")}`;
+    const prepared = await ctx.invoke("prepare-generation", {
+      name: (args.name ?? slug).replace(/[-_]/g, " "),
+      slug,
+      valueProp,
+      vibe: args.vibe ?? "confident",
+      directorIds: ["d1"],
+      append: false,
+      appCode: args.appCode,
+      brand,
+      templateId: args.templateId,
+      templateParams: args.templateParams,
+      ...args.motionContextId ? { motionContextId: args.motionContextId } : {}
+    });
+    const draft = prepared.drafts[0];
+    if (ctx.phasedFlow && draft?.id && args.content) {
+      const parsedContent = contentSchema.safeParse(args.content);
+      if (parsedContent.success) {
+        ctx.qualityLoopState?.lockedContentByDraft.set(draft.id, parsedContent.data.lines);
+      }
+      const parsedConcept = conceptSchema.safeParse(args.concept);
+      if (parsedConcept.success) {
+        ctx.qualityLoopState?.beatsByDraft.set(
+          draft.id,
+          parsedConcept.data.beats.map((beat) => ({
+            start: beat.start,
+            end: beat.end,
+            subject: beat.subject,
+            energy: beat.energy
+          }))
+        );
+      }
+    }
+    return json2({
+      projectId: prepared.projectId,
+      draftId: draft?.id,
+      slug: draft?.slug,
+      starterFiles: prepared.starterFiles,
+      libraryVersion: prepared.libraryVersion,
+      engineVersion: prepared.engineVersion,
+      studioUrl: studioLink(ctx, prepared.projectId, draft?.slug),
+      ...ctx.qualityLoop ? {
+        creativeContract: args.creativeContract,
+        qualityLoop: {
+          enabled: true,
+          next: 'Build the proof beat first, then call get_frames with reviewMode="proof" before completing the full film.'
+        }
+      } : {},
+      next: ctx.qualityLoop ? "Read impractical://engine.d.ts, build the proof beat first, then review it before completing the film." : "Read impractical://engine.d.ts, then write App.tsx and direction.ts."
+    });
+  }
+};
+var listDraftFiles = {
+  name: "list_draft_files",
+  title: "List a draft's files",
+  description: "List the source files of a draft with their sizes and the current revision. Cheap orientation \u2014 prefer this over reading every file. If notes.json is present, it holds the user's queued timecoded edit requests \u2014 read it before directing.",
+  inputSchema: { draftId: external_exports.string().describe("The draft id.") },
+  handler: async (args, ctx) => {
+    const draft = await getDraft(ctx, String(args.draftId));
+    return json2({
+      draftId: draft.draftId,
+      projectId: draft.projectId,
+      slug: draft.slug,
+      status: draft.status,
+      revision: draft.revision,
+      staleNote: `Any file contents read before revision ${draft.revision} are stale \u2014 re-read before editing them.`,
+      lockedByJobId: draft.lockedByJobId,
+      files: Object.entries(draft.files).map(([path, content]) => ({ path, bytes: Buffer.byteLength(content, "utf8") })).sort((a, b) => a.path.localeCompare(b.path))
+    });
+  }
+};
+var readDraftFile = {
+  name: "read_draft_file",
+  title: "Read one draft file",
+  description: "Read the contents of a single file in a draft. notes.json, when present, is the user's edit queue: [{ id, at, text, done, mentions? }] \u2014 timecoded requests written while watching. Address open items and set done: true on each one you handle.",
+  inputSchema: {
+    draftId: external_exports.string().describe("The draft id."),
+    path: external_exports.string().describe("File path within the draft, e.g. 'direction.ts'."),
+    startLine: external_exports.number().int().min(1).optional().describe("1-based first line to return \u2014 page large files instead of truncating."),
+    lineCount: external_exports.number().int().min(1).optional().describe("Number of lines to return from startLine.")
+  },
+  handler: async (args, ctx) => {
+    const draft = await getDraft(ctx, String(args.draftId));
+    const path = String(args.path);
+    const content = draft.files[path];
+    if (content === void 0) {
+      return fail(
+        `No file "${path}" in draft ${args.draftId}. Available: ${Object.keys(draft.files).sort().join(", ")}`
+      );
+    }
+    const stamp = `[${path} @ revision ${draft.revision} \u2014 earlier copies of this file in your context are stale if this revision is newer]`;
+    const lines = content.split("\n");
+    const startLine = typeof args.startLine === "number" ? Math.max(1, args.startLine) : 1;
+    const lineCount = typeof args.lineCount === "number" ? Math.max(1, args.lineCount) : lines.length;
+    if (startLine === 1 && lineCount >= lines.length) return { text: `${stamp}
+${content}` };
+    const slice = lines.slice(startLine - 1, startLine - 1 + lineCount);
+    if (slice.length === 0) {
+      return {
+        text: `[no lines returned: startLine ${startLine} is beyond ${lines.length} lines \u2014 page with startLine/lineCount]`
+      };
+    }
+    return {
+      text: `[lines ${startLine}-${startLine - 1 + slice.length} of ${lines.length}, ${path} @ revision ${draft.revision} \u2014 page with startLine/lineCount]
+` + slice.join("\n")
+    };
+  }
+};
+var writeDraftFiles = {
+  name: "write_draft_files",
+  title: "Write draft files",
+  description: "Create or overwrite whole files in a draft, and optionally delete others. Returns the committed revision and preview-build job id immediately; follow that id with job_status. Prefer edit_draft_file for small changes. Only .ts/.tsx/.js/.jsx/.css/.json paths sync, max 100 files per draft. Never edit project.json.",
+  inputSchema: {
+    draftId: external_exports.string().describe("The draft id."),
+    files: external_exports.record(external_exports.string(), external_exports.string()).describe("Map of file path to full file content."),
+    deletedPaths: external_exports.array(external_exports.string()).optional().describe("Paths to remove from the draft.")
+  },
+  handler: async (args, ctx) => {
+    const files = args.files ?? {};
+    const deletedPaths = args.deletedPaths ?? [];
+    return saveDraft(ctx, String(args.draftId), () => ({ files, deletedPaths }));
+  }
+};
+var editDraftFile = {
+  name: "edit_draft_file",
+  title: "Edit one draft file",
+  description: "Replace an exact string in one draft file. The read, the edit and the write happen in a single call against the current revision, so concurrent edits from the web tweak chat cannot clobber yours. Returns the committed revision and preview-build job id immediately; follow that id with job_status.",
+  inputSchema: {
+    draftId: external_exports.string().describe("The draft id."),
+    path: external_exports.string().describe("File path within the draft, e.g. 'direction.ts'."),
+    oldString: external_exports.string().describe("Exact text to replace. Must appear in the file."),
+    newString: external_exports.string().describe("Replacement text."),
+    replaceAll: external_exports.boolean().optional().describe("Replace every occurrence. Default false, which requires a unique match.")
+  },
+  handler: async (args, ctx) => {
+    const path = String(args.path);
+    const oldString = String(args.oldString);
+    const newString = String(args.newString);
+    let problem = null;
+    const output = await saveDraft(
+      ctx,
+      String(args.draftId),
+      (draft) => {
+        const content = draft.files[path];
+        if (content === void 0) {
+          problem = `No file "${path}" in this draft. Available: ${Object.keys(draft.files).sort().join(", ")}`;
+          return { files: {}, deletedPaths: [] };
+        }
+        const occurrences = content.split(oldString).length - 1;
+        if (occurrences === 0) {
+          problem = `oldString was not found in ${path} at revision ${draft.revision}. Either the match is inexact, or your copy of this file is stale \u2014 if you last read it at an earlier revision, read_draft_file again and re-apply the edit against the current text.`;
+          return { files: {}, deletedPaths: [] };
+        }
+        if (occurrences > 1 && !args.replaceAll) {
+          problem = `oldString appears ${occurrences} times in ${path} at revision ${draft.revision}. Add more surrounding context to make it unique, or pass replaceAll: true.`;
+          return { files: {}, deletedPaths: [] };
+        }
+        const next = args.replaceAll ? content.split(oldString).join(newString) : content.replace(oldString, newString);
+        return { files: { [path]: next }, deletedPaths: [] };
       }
-      if (!input.includeSheets) return { sheets: [], diffs, cellDiffs };
-      const ratio = imgs[0].naturalHeight / Math.max(1, imgs[0].naturalWidth);
-      const tw = input.tileWidth;
-      const th = Math.round(tw * ratio);
-      const sheets = [];
-      for (let s = 0; s * input.perSheet < imgs.length; s += 1) {
-        const slice = imgs.slice(s * input.perSheet, (s + 1) * input.perSheet);
-        const rows = Math.ceil(slice.length / input.columns);
-        const canvas = document.createElement("canvas");
-        canvas.width = input.columns * tw;
-        canvas.height = rows * th;
-        const ctx = canvas.getContext("2d");
-        if (!ctx) throw new Error("2d canvas unavailable");
-        ctx.fillStyle = "#000";
-        ctx.fillRect(0, 0, canvas.width, canvas.height);
-        slice.forEach((img, i) => {
-          const x = i % input.columns * tw;
-          const y = Math.floor(i / input.columns) * th;
-          ctx.drawImage(img, x, y, tw, th);
-          const label = input.frames[s * input.perSheet + i].time.toFixed(2) + "s";
-          ctx.font = "bold 16px monospace";
-          const width = ctx.measureText(label).width + 10;
-          ctx.fillStyle = "rgba(0,0,0,0.72)";
-          ctx.fillRect(x, y, width, 22);
-          ctx.fillStyle = "#ffd21f";
-          ctx.fillText(label, x + 5, y + 16);
-        });
-        sheets.push(canvas.toDataURL("image/jpeg", 0.8).split(",")[1]);
+    );
+    return problem ? fail(problem) : output;
+  }
+};
+var jobStatus = {
+  name: "job_status",
+  title: "Check job status",
+  description: "Check Impractical Motion jobs (preview builds, exports). Set wait to poll until they finish.",
+  inputSchema: {
+    jobIds: external_exports.array(external_exports.string()).min(1).max(20).describe("Job ids to check."),
+    wait: external_exports.boolean().optional().describe("Poll until every job reaches a terminal state."),
+    waitSeconds: external_exports.number().optional().describe(`Polling budget when wait is true. Default ${JOB_WAIT_SECONDS}, capped at ${maxWaitSeconds()}s. When the budget runs out the call returns the job ids instead of failing \u2014 call it again to keep waiting.`)
+  },
+  handler: async (args, ctx, progress) => {
+    const jobIds = args.jobIds;
+    if (!args.wait) {
+      const result = await ctx.invoke("job-status", { jobIds });
+      const measured = await measuredBlock(ctx, result.jobs ?? []);
+      return { text: json2(result).text + measured };
+    }
+    const budgetMs = waitBudgetMs(args.waitSeconds, JOB_WAIT_SECONDS);
+    const now = ctx.now ?? Date.now;
+    const started = now();
+    const deadline = started + budgetMs;
+    let rows = [];
+    let consecutiveErrors = 0;
+    let lastError = "";
+    while (now() < deadline) {
+      if (progress?.signal?.aborted) break;
+      try {
+        const result = await ctx.invoke("job-status", { jobIds });
+        rows = result.jobs;
+        consecutiveErrors = 0;
+        if (rows.length && rows.every((row) => TERMINAL.has(row.status))) {
+          const measured = await measuredBlock(ctx, rows);
+          return { text: json2(rows).text + measured };
+        }
+      } catch (error51) {
+        lastError = error51 instanceof Error ? error51.message : String(error51);
+        if (++consecutiveErrors >= POLL_ERROR_LIMIT) {
+          return json2({ pollError: lastError, stillRunning: jobIds, jobs: rows });
+        }
       }
-      return { sheets, diffs, cellDiffs };
-    },
-    {
-      frames,
-      columns: options.columns ?? 4,
-      tileWidth: options.tileWidth ?? 480,
-      perSheet: options.perSheet ?? 16,
-      includeSheets: options.includeSheets ?? true
+      progress?.report?.({
+        progress: Math.min(now() - started, budgetMs),
+        total: budgetMs,
+        message: rows.length ? rows.map((row) => describeJob(row.id, row, consecutiveErrors, lastError)).join("; ") : jobIds.join(", ")
+      });
+      const remainingMs = deadline - now();
+      if (remainingMs > 0) await nap(ctx, Math.min(2e3, remainingMs));
     }
-  );
-}
-var getMotionTool = {
-  name: "get_motion",
-  title: "See and measure motion over an interval",
-  description: "MOTION LAB (local experiment). Sample the draft densely across a time window and return (1) timestamp-labelled contact sheets \u2014 adjacent tiles are one sample apart, so the difference between tiles IS the motion \u2014 and (2) a measured report: % of pixels changing per interval, dead-air spans where nothing perceptible moves, and every tween the built timeline actually schedules in the window, flagging tweens that run without producing visible change. Static frames cannot show velocity, overlap, or dead air; this can. Call it over the full duration after every preview build, then narrow in on weak windows. Use get_frames for composition close-ups only.",
+    return json2({
+      timedOut: true,
+      stillRunning: jobIds,
+      jobs: rows,
+      resumeWith: `job_status({ jobIds: ${JSON.stringify(jobIds)}, wait: true })`,
+      note: "The jobs are still running in the cloud \u2014 this is a pause, not a failure. Call the command in resumeWith to keep following them." + clampNote(args.waitSeconds)
+    });
+  }
+};
+var exportVideo = {
+  name: "export_video",
+  title: "Export the final MP4",
+  description: "Start the final MP4 render and return its job id immediately. Follow that id with job_status for the signed download URL. Only export once the user is happy with the frames.",
   inputSchema: {
     draftId: external_exports.string().describe("The draft id."),
-    from: external_exports.number().min(0).optional().describe("Window start in seconds. Defaults to 0."),
-    to: external_exports.number().min(0).optional().describe("Window end in seconds. Defaults to the scene duration."),
-    everyNthFrame: external_exports.number().int().min(1).max(30).optional().describe(
-      `Sample one frame in N. Default ${DEFAULT_EVERY_NTH_FRAME} (6 samples/second at 30fps) \u2014 the density at which motion becomes readable across stills.`
-    ),
-    detail: external_exports.enum(["quick", "full"]).optional().describe(
-      'quick (default): numbers only \u2014 dead air, focal budget, text census \u2014 sparser sampling, NO contact-sheet images, no metric catalog. Cheap enough to run after every revision. full: dense sampling with contact sheets and the catalog, when you need to SEE motion mid-flight. Measure at most twice per revision; finish with reviewMode "final".'
-    ),
-    reviewMode: external_exports.enum(["final"]).optional().describe(
-      'Quality-loop lens: "final" forces a full-duration pass at one-frame-in-five density and records export-eligible motion-coverage evidence for the current revision.'
+    qualityReview: qualityReviewSchema.optional().describe(
+      "Required only by the opt-in local quality loop: the exact reviewed revision, creative claim/proof, reference comparison, eight category scores, timestamp evidence, and blockers."
+    )
+  },
+  handler: async (args, ctx) => {
+    if (ctx.qualityLoop) {
+      const capture = ctx.qualityLoopState?.finalReviewByDraft.get(String(args.draftId));
+      const failure = qualityReviewFailure({
+        draftRevision: capture?.revision ?? -1,
+        capture,
+        review: args.qualityReview,
+        craftLab: ctx.craftLab === true,
+        scoreSignatures: ctx.qualityLoopState?.scoreSignatures,
+        draftId: String(args.draftId)
+      }) ?? motionCoverageFailure({
+        motionLab: ctx.motionLab === true,
+        capture: ctx.qualityLoopState?.finalMotionReviewByDraft.get(String(args.draftId)),
+        frameReviewRevision: capture?.revision ?? -1
+      }) ?? craftMotionFailure({
+        craftLab: ctx.craftLab === true,
+        capture: ctx.qualityLoopState?.finalMotionReviewByDraft.get(String(args.draftId))
+      }) ?? framingMotionFailure(ctx.qualityLoopState?.finalMotionReviewByDraft.get(String(args.draftId)));
+      if (failure) return fail(`Quality gate blocked export: ${failure}`);
+    }
+    const started = await ctx.invoke("start-export", { draftId: args.draftId });
+    return json2({
+      started: true,
+      draftId: String(args.draftId),
+      jobId: started.jobId,
+      status: "queued",
+      resumeWith: resumeWith(started.jobId),
+      note: "Export started. Do not start another export. Follow this job with resumeWith to obtain the signed download URL."
+    });
+  }
+};
+var brandList = {
+  name: "brand_list",
+  title: "List brand kits",
+  description: "List the brand kits saved in this workspace.",
+  inputSchema: {},
+  handler: async (_args, ctx) => json2(await ctx.invoke("brand-kits", { action: "list" }))
+};
+var brandGet = {
+  name: "brand_get",
+  title: "Get a brand kit",
+  description: "Get one brand kit \u2014 its colors, fonts and logo. Treat these as law when directing.",
+  inputSchema: { slug: external_exports.string().describe("Brand kit slug.") },
+  handler: async (args, ctx) => json2(await ctx.invoke("brand-kits", { action: "get", slug: args.slug }))
+};
+var brandExtract = {
+  name: "brand_extract",
+  title: "Extract a brand kit from a URL",
+  description: "Start extracting a brand kit (colors, fonts, logo) from a website and return the run id immediately. To observe an existing run, call this tool with jobId instead of url; that status mode never starts another extraction.",
+  inputSchema: {
+    url: external_exports.string().optional().describe("The brand website URL. Omit when continuing by jobId."),
+    jobId: external_exports.string().optional().describe("Run id returned by a previous brand_extract call."),
+    reextract: external_exports.boolean().optional().describe("Re-extract even if a kit already exists."),
+    wait: external_exports.boolean().optional().describe("With jobId, poll until this extraction is terminal."),
+    waitSeconds: external_exports.number().optional().describe(
+      `With jobId and wait, poll for up to ${BRAND_WAIT_SECONDS}s by default, capped at ${maxWaitSeconds()}s.`
     )
   },
-  local: true,
-  // Metered as a frame capture: the deployed admission policy budgets
-  // get_frames for exactly the routes this tool invokes (get-draft,
-  // list-projects), and one motion pass is one capture.
-  admitAs: "get_frames",
   handler: async (args, ctx, progress) => {
-    const finalReview = args.reviewMode === "final";
-    const session = await openPreview(ctx, String(args.draftId));
-    try {
-      const duration3 = session.duration;
-      const from = finalReview ? 0 : Math.max(0, Math.min(Number(args.from ?? 0), duration3));
-      const to = finalReview ? duration3 : Math.max(0, Math.min(Number(args.to ?? duration3), duration3));
-      if (to <= from) {
-        return {
-          text: `get_motion needs from < to within 0\u2013${formatTime(duration3)}s (got ${from}\u2013${to}).`,
-          isError: true
-        };
-      }
-      const passPlan = motionPassPlan({
-        finalReview,
-        detail: args.detail ? String(args.detail) : void 0,
-        everyNthFrame: args.everyNthFrame === void 0 ? void 0 : Number(args.everyNthFrame)
-      });
-      const everyNthFrame = passPlan.everyNthFrame;
-      const plan = sampleTimes({
-        from,
-        to,
-        fps: session.fps,
-        everyNthFrame,
-        maxSamples: passPlan.maxSamples
+    const url2 = typeof args.url === "string" ? args.url : "";
+    const jobId = typeof args.jobId === "string" ? args.jobId : "";
+    if (url2 && jobId) return fail("Pass either url to start or jobId to continue, not both.");
+    if (!url2 && !jobId) return fail("Pass url to start an extraction, or jobId to continue one.");
+    if (url2) {
+      const started = await ctx.invoke("brand-extraction", {
+        action: "start",
+        url: url2,
+        ...args.reextract ? { reextract: true } : {}
       });
-      const frames = [];
-      const textSamples = [];
-      const censusOn = textCensusEnabled();
-      for (const [index, time3] of plan.times.entries()) {
-        if (progress?.signal?.aborted) break;
-        await renderSettledFrame(session.page, time3);
-        const shot = await session.page.screenshot({ type: "jpeg", quality: 80 });
-        frames.push({ time: time3, base64: shot.toString("base64") });
-        if (censusOn) {
-          try {
-            textSamples.push({ time: time3, blocks: await sampleTextBlocks(session.page, CANDIDATE_MIN_PX) });
-          } catch {
-          }
-        }
-        progress?.report?.({
-          progress: index + 1,
-          total: plan.times.length,
-          message: `sampled t=${formatTime(time3)}s`
-        });
-      }
-      const tweensAll = await extractTimeline(session.page);
-      const tweens = tweensAll ? tweensAll.filter((tween) => tween.end > from && tween.start < to) : null;
-      const sheetPage = await session.browser.newPage();
-      const { sheets, diffs, cellDiffs } = await compositeAndDiff(sheetPage, frames, {
-        includeSheets: passPlan.includeSheets
+      return json2({
+        started: true,
+        jobId: started.job,
+        slug: started.slug,
+        status: "queued",
+        resumeWith: `brand_extract({ jobId: "${started.job}", wait: true })`,
+        note: "Brand extraction started. Do not call brand_extract with the URL again. Continue this exact run with resumeWith, then pass the completed slug to create_video as brandSlug."
       });
-      let catalogSection = "";
-      if (passPlan.includeCatalog && metricCatalogEnabled() && frames.length >= 2) {
-        try {
-          const features = await sampleCatalogFeatures(sheetPage, frames);
-          const records = computeCatalogMetrics({
-            features,
-            dtSeconds: plan.stepSeconds,
-            durationSeconds: to - from
-          });
-          catalogSection = formatCatalogReport(records);
-        } catch (error51) {
-          catalogSection = "CANONICAL METRICS unavailable this pass: " + (error51 instanceof Error ? error51.message : String(error51));
-        }
-      }
-      const intervals = buildIntervals(
-        frames.map((frame) => frame.time),
-        diffs
-      );
-      const censusSection = censusOn && textSamples.length ? textCensusReport(textSamples) : "";
-      let contractSection = "";
-      if (textContractEnabled() && textSamples.length >= 2) {
-        try {
-          const dims = await session.page.evaluate(() => ({
-            width: window.innerWidth,
-            height: window.innerHeight
-          }));
-          contractSection = formatTextContractReport(
-            analyzeTextContract({
-              samples: textSamples,
-              diffs,
-              frameWidth: dims.width,
-              frameHeight: dims.height,
-              stepSeconds: plan.stepSeconds,
-              lockedContent: ctx.qualityLoopState?.lockedContentByDraft.get(String(args.draftId)),
-              inspectV2: inspectV2Enabled()
-            })
-          );
-        } catch {
-        }
-      }
-      let v2Section = "";
-      if (inspectV2Enabled()) {
-        const v2Lines = [];
-        const envelope = envelopeLine(intervals);
-        if (envelope) v2Lines.push(envelope);
-        const beats = ctx.qualityLoopState?.beatsByDraft.get(String(args.draftId)) ?? [];
-        v2Lines.push(...beatVerdicts(beats, intervals));
-        v2Lines.push(
-          ...repairMenu({
-            deadSpans: deadAirSpans(intervals),
-            imperceptible: tweens ? imperceptibleTweens(tweens, intervals) : [],
-            textSamples
-          })
-        );
-        v2Section = v2Lines.join("\n");
+    }
+    const readStatus = () => ctx.invoke("brand-extraction", { action: "status", job: jobId });
+    if (!args.wait) {
+      const status = await readStatus();
+      if (status.status === "error" || status.status === "failed" || status.error) {
+        return fail(`Brand extraction failed${status.error ? `: ${status.error}` : ""}`);
       }
-      let scoreSection = "";
-      if (motionScoreEnabled() && tweensAll?.length) {
-        try {
-          scoreSection = motionScoreSection({
-            tweens: tweensAll,
-            beats: ctx.qualityLoopState?.beatsByDraft.get(String(args.draftId)) ?? [],
-            duration: duration3
-          });
-        } catch {
+      return json2({ jobId, ...status });
+    }
+    const budgetMs = waitBudgetMs(args.waitSeconds, BRAND_WAIT_SECONDS);
+    const startedAt = Date.now();
+    const deadline = startedAt + budgetMs;
+    let consecutiveErrors = 0;
+    let lastError = "";
+    let stage = "";
+    let lastStatus = {};
+    while (Date.now() < deadline) {
+      if (progress?.signal?.aborted) break;
+      try {
+        const status = await readStatus();
+        lastStatus = status;
+        consecutiveErrors = 0;
+        stage = status.stage ?? stage;
+        if (status.status === "done") {
+          return json2({ jobId, ...status });
         }
-      }
-      const splitFocus = splitFocusMoments(
-        frames.map((frame) => frame.time),
-        cellDiffs
-      );
-      const breathless = breathlessSpans(intervals);
-      const cadence = tweens ? cadenceMoments(tweens) : void 0;
-      const report = motionReport({ from, to, plan, everyNthFrame, intervals, tweens, duration: duration3, splitFocus, breathless, cadence });
-      const lines = [
-        report,
-        ...passPlan.includeSheets ? [] : [
-          "",
-          'QUICK PASS \u2014 numbers only, no frames attached. Run detail: "full" when you need to SEE the motion, and reviewMode: "final" for the export-evidence review.'
-        ],
-        ...censusSection ? ["", censusSection] : [],
-        ...contractSection ? ["", contractSection] : [],
-        ...scoreSection ? ["", scoreSection] : [],
-        ...v2Section ? ["", v2Section] : [],
-        ...catalogSection ? ["", catalogSection] : [],
-        ...session.warnings.map((warning) => `WARNING: ${warning}`),
-        "",
-        "These are measurements, not style rules. Dead air and imperceptible tweens are time no one is directing \u2014 decide narratively what should own that time, change the direction, and measure again."
-      ];
-      if (ctx.qualityLoop) {
-        if (!finalReview) {
-          lines.push(
-            'QUALITY LOOP: this pass is not export evidence. Record motion coverage with get_motion({ draftId, reviewMode: "final" }) once the cut is complete.'
-          );
-        } else {
-          const stalePreview = session.warnings.some(
-            (warning) => warning.startsWith("The preview bundle is at revision ")
-          );
-          if (stalePreview) {
-            lines.push(
-              "MOTION REVIEW NOT RECORDED: these samples came from a stale preview bundle. Wait for the current revision to build, then review it again."
-            );
-          } else {
-            ctx.qualityLoopState?.finalMotionReviewByDraft.set(String(args.draftId), {
-              revision: session.revision,
-              duration: duration3,
-              stepSeconds: plan.stepSeconds,
-              samples: plan.times.length
-            });
-            lines.push(
-              `FINAL MOTION REVIEW RECORDED for revision ${session.revision} \u2014 ${plan.times.length} samples, ${plan.stepSeconds.toFixed(3)}s apart` + (plan.coarsened ? " (coarsened below one-in-five by film length)" : "") + ". Any later edit invalidates this evidence."
-            );
-            lines.push(qualityReviewPrompt("final"));
-          }
+        if (status.status === "error" || status.status === "failed" || status.error) {
+          return fail(`Brand extraction failed${status.error ? `: ${status.error}` : ""}`);
         }
+      } catch (error51) {
+        lastError = error51 instanceof Error ? error51.message : String(error51);
+        if (++consecutiveErrors >= POLL_ERROR_LIMIT) break;
       }
-      return {
-        text: lines.join("\n"),
-        images: sheets.map((base643) => ({ base64: base643, mimeType: "image/jpeg" }))
-      };
-    } finally {
-      await session.browser.close().catch(() => void 0);
+      progress?.report?.({
+        progress: Math.min(Date.now() - startedAt, budgetMs),
+        total: budgetMs,
+        message: `brand run ${jobId}: ${stage || "extracting"}`
+      });
+      await nap(ctx, 2e3);
     }
+    return json2({
+      timedOut: true,
+      jobId,
+      status: lastStatus,
+      ...lastError ? { pollError: lastError } : {},
+      resumeWith: `brand_extract({ jobId: "${jobId}", wait: true })`,
+      note: "The extraction is still running \u2014 this is a pause, not a failure. Continue the same run with resumeWith; never call brand_extract with the URL again for this run." + clampNote(args.waitSeconds)
+    });
   }
 };
-function motionLabServerInstructions() {
-  return `
-
-MOTION LAB IS ENABLED \u2014 an opt-in local experiment:
-Static frames measure composition; they are blind to velocity, overlap, and dead air. After every successful preview build, call get_motion across the full duration BEFORE judging the cut, and again on any window you edit. Treat its output as measurements, not style rules: a dead-air span or a flagged imperceptible tween is time no one is directing \u2014 decide what should own that time, fix the direction, and measure again. A cut is not done while the report shows dead air you did not choose deliberately. get_frames remains the tool for composition close-ups.
-When the quality loop is also enabled, the final review is two-part and export requires both on the same revision: get_frames({ reviewMode: "final" }) for composition and legibility at native resolution, and get_motion({ draftId, reviewMode: "final" }) for full-duration motion coverage at one frame in five.`;
-}
+var motionProfile = {
+  name: "motion_profile",
+  title: "Manage the personal motion profile",
+  description: "Inspect and manage the user's learned motion preferences. Call with action 'get' to see the effective profile before directing. Use 'remember' ONLY when the user explicitly asks to remember a preference; use 'propose' to submit an inferred preference as a pending proposal for the user to confirm \u2014 never confirm an inferred preference yourself. 'confirm'/'reject' decide a pending proposal after asking the user; 'forget', 'pause', 'resume' and 'reset' manage stored preferences on the user's behalf.",
+  inputSchema: {
+    action: external_exports.enum(["get", "remember", "propose", "confirm", "reject", "forget", "pause", "resume", "reset"]).describe("The profile command to run."),
+    rule: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe(
+      "Structured preference for remember/propose, e.g. {kind:'trait',trait:'pacing',value:'fast'}, {kind:'library',itemType:'style',itemId:'optical',stance:'prefer'}, {kind:'freeform',text:'...'}, {kind:'duration',max:15}, or {kind:'example',draftId:'...'}."
+    ),
+    eventId: external_exports.string().optional().describe("Pending proposal id for confirm/reject."),
+    ruleKey: external_exports.string().optional().describe("Rule key to forget, from the get result."),
+    scope: external_exports.enum(["workspace", "brand", "user", "user_brand"]).optional().describe("Target layer. Defaults to the personal layer; shared layers need admin."),
+    brandSlug: external_exports.string().optional().describe("Brand slug for brand-scoped preferences."),
+    contentType: external_exports.string().optional().describe("Content type this preference applies to."),
+    draftId: external_exports.string().optional().describe("Draft that motivated a proposal.")
+  },
+  handler: async (args, ctx) => json2(await ctx.invoke("motion-profile", args))
+};
+var studioLinkTool = {
+  name: "studio_link",
+  title: "Get the studio URL",
+  description: "Get the web studio URL where the user watches the cuts and tweaks them visually. Always give this to the user after a change lands.",
+  inputSchema: {
+    projectId: external_exports.string().describe("The project id."),
+    slug: external_exports.string().optional().describe("Draft slug to open directly.")
+  },
+  handler: async (args, ctx) => ({
+    text: studioLink(ctx, String(args.projectId), args.slug)
+  })
+};
+var REMOTE_SAFE_TOOLS = [
+  accountStatus,
+  whoami,
+  listProjects,
+  getProject,
+  createVideo,
+  listDraftFiles,
+  readDraftFile,
+  writeDraftFiles,
+  editDraftFile,
+  jobStatus,
+  exportVideo,
+  brandList,
+  brandGet,
+  brandExtract,
+  motionProfile,
+  studioLinkTool
+];
 
 // src/mcp/gather-references.ts
-import { existsSync, statSync } from "node:fs";
+import { existsSync as existsSync2, statSync } from "node:fs";
 var referenceEntry = external_exports.object({
   kind: external_exports.enum(["local-code", "product-ui-screenshot", "site-code", "website", "screenshot", "image-to-use", "component-class-image", "mockup"]),
   /** URL or local file path. */
@@ -33948,7 +35168,7 @@ async function captureSource(source) {
     }
   }
   try {
-    return { verified: existsSync(source) && statSync(source).size > 0 };
+    return { verified: existsSync2(source) && statSync(source).size > 0 };
   } catch {
     return { verified: false };
   }
@@ -33995,33 +35215,47 @@ var gatherReferencesTool = {
 };
 
 // src/mcp/install-kits.ts
-import { readFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-var KIT_FILES = [
-  "kits",
-  "reveal",
-  "actions",
-  "ensemble",
-  "looks",
-  "sentence",
-  "morphkit",
-  "highlight",
-  "impact",
-  "streamkit"
-];
-function readKitSources() {
-  return KIT_FILES.map((name) => ({
-    path: `kit/${name}.ts`,
-    content: readFileSync(
-      fileURLToPath(new URL(`../assets/kits/${name}.ts`, import.meta.url)),
-      "utf8"
-    )
-  }));
+var kitSourceShape = external_exports.object({
+  kits: external_exports.array(external_exports.object({ path: external_exports.string().min(1), content: external_exports.string().min(1) })).min(1)
+});
+async function fetchKitSources(ctx) {
+  const response = await ctx.invoke("motion-library", { kitsOnly: true });
+  const parsed = kitSourceShape.safeParse(response);
+  if (!parsed.success) {
+    throw new Error(
+      "The motion library did not return kit sources \u2014 the server may predate kit serving. Retry after updating, or continue without install_kits."
+    );
+  }
+  return parsed.data.kits.filter((kit) => /^kit\/[a-z]+\.ts$/.test(kit.path));
+}
+function kitCatalog(sources) {
+  const lines = [];
+  for (const file2 of sources) {
+    const match = /^kit\/([\w-]+)\.ts$/.exec(file2.path);
+    if (!match) continue;
+    const name = match[1];
+    const header = [];
+    for (const raw of file2.content.split("\n")) {
+      const line = raw.trim();
+      if (!line.startsWith("//")) {
+        if (header.length) break;
+        continue;
+      }
+      const text = line.replace(/^\/\/\s*/, "").replace(/[─]+/g, "").trim();
+      if (text) header.push(text);
+      if (header.length >= 2) break;
+    }
+    const exports = [...file2.content.matchAll(/^export (?:const|function) (\w+)/gm)].map((m) => m[1]).filter((n) => !n.startsWith("_"));
+    lines.push(
+      `- kit/${name}: ${header.join(" ") || "(no header)"}` + (exports.length ? ` [exports: ${exports.slice(0, 8).join(", ")}${exports.length > 8 ? ", \u2026" : ""}]` : "")
+    );
+  }
+  return lines.join("\n");
 }
 var installKitsTool = {
   name: "install_kits",
   title: "Install the interaction and showpiece kits into a draft",
-  description: "Write the house kits into the draft under kit/ so direction.ts can import them instead of hand-rolling primitives. Call this ONCE right after create_video, before writing your own files. Provides: kit/actions (a STATEFUL cursor actor \u2014 travels from where it is, decelerates into targets, presses with squash, types with a real caret; plus scroll and ui.set state changes), kit/ensemble (fountain, confetti, assemble, scatter, dropIn showpieces with closed-form ballistics), kit/looks (hero angle-zoom, tilt, dropIn entrances), kit/sentence (append/swap/stress/morphWord/chip typography), kit/morphkit, kit/highlight, kit/impact, kit/streamkit. Import as e.g. `import { createCursorKit } from './kit/actions'`. NEVER hand-roll a cursor, click, confetti burst, or fountain when the kit already does it \u2014 hand-rolled cursors teleport and click before they arrive.",
+  description: "Write the house kits into the draft under kit/ so direction.ts can import them instead of hand-rolling primitives. Call this ONCE right after create_video, before writing your own files. Provides: kit/actions (a STATEFUL cursor actor \u2014 travels from where it is, decelerates into targets, presses with squash, types with a real caret; plus scroll and ui.set state changes), kit/ensemble (fountain, confetti, assemble, scatter, dropIn showpieces with closed-form ballistics), kit/looks (hero angle-zoom, tilt, dropIn entrances), kit/sentence (append/swap/stress/morphWord/chip typography), kit/morphkit (morph one element INTO another \u2014 box/radius/parts crossfade with matched sub-parts, plus chip-to-fullbleed expand: THE transformation verb), kit/highlight (draw attention: glow, underline, ring), kit/impact (hits and emphasis), kit/streamkit (live-data motion), kit/editorial (frame-authored cuts, settles, arrivals, cursor actions, depth fixes, and cadence), and kit/depthkit (the depth world: layered parallax rig under the camera, quickTilt product framing, frost glass, elevation-light lift, whip zoom and rack focus \u2014 the default stage for product beats). Import as e.g. `import { createCursorKit } from './kit/actions'`. NEVER hand-roll a cursor, click, confetti burst, or fountain when the kit already does it \u2014 hand-rolled cursors teleport and click before they arrive.",
   inputSchema: {
     draftId: external_exports.string().describe("The draft to install the kits into.")
   },
@@ -34029,7 +35263,7 @@ var installKitsTool = {
   // This is a draft write in route terms; meter it as one.
   admitAs: "write_draft_files",
   handler: async (args, ctx) => {
-    const sources = readKitSources();
+    const sources = await fetchKitSources(ctx);
     const files = Object.fromEntries(sources.map((file2) => [file2.path, file2.content]));
     const output = await saveDraft(ctx, String(args.draftId), () => ({
       files,
@@ -34037,8 +35271,8 @@ var installKitsTool = {
     }));
     if (output.isError) return output;
     return {
-      text: `Installed ${sources.length} kit files under kit/. Import from './kit/actions', './kit/ensemble', './kit/looks', './kit/sentence' etc. in direction.ts. NEVER hand-roll what they provide.
-` + output.text
+      text: `Installed ${sources.length} kit files under kit/. Import from './kit/<name>' in direction.ts; NEVER hand-roll what a kit provides. What arrived:
+` + kitCatalog(sources) + "\n" + output.text
     };
   }
 };
@@ -34387,23 +35621,22 @@ function parseLocalMotionLibrary(source, filePath = "local motion library") {
   }
   return data;
 }
-var replaceSelectedItems = (selected, local) => {
+var replaceSelectedItems = (selected, local2) => {
   if (!selected?.length) return [];
-  const byId = new Map(local.map((item) => [item.id, item]));
+  const byId = new Map(local2.map((item) => [item.id, item]));
   return selected.map((item) => byId.get(item.id) ?? item);
 };
-function overlayLocalMotionLibrary(remote, local, filePath, detail) {
+function overlayLocalMotionLibrary(remote, local2, filePath, detail) {
   const productionLibraryVersion = remote.libraryVersion;
   return {
     ...remote,
-    schemaVersion: local.schemaVersion,
-    libraryVersion: local.version,
-    engineVersion: local.engineVersion,
-    catalog: local.catalog,
-    guidance: local.guidance,
-    styles: replaceSelectedItems(remote.styles, local.styles),
-    templates: replaceSelectedItems(remote.templates, local.templates),
-    sharedReferences: detail === "full" ? local.sharedReferences : void 0,
+    schemaVersion: local2.schemaVersion,
+    libraryVersion: local2.version,
+    engineVersion: local2.engineVersion,
+    catalog: local2.catalog,
+    guidance: local2.guidance,
+    styles: replaceSelectedItems(remote.styles, local2.styles),
+    templates: replaceSelectedItems(remote.templates, local2.templates),
     localLibraryOverride: {
       enabled: true,
       source: filePath,
@@ -34644,7 +35877,7 @@ ${formatUsageNotice(admission.warning)}`;
 }
 var ENGINE_DTS_URI = "impractical://engine.d.ts";
 function readEngineTypes() {
-  return readFileSync2(fileURLToPath2(new URL("../assets/engine.d.ts", import.meta.url)), "utf8");
+  return readFileSync2(fileURLToPath(new URL("../assets/engine.d.ts", import.meta.url)), "utf8");
 }
 function registerEngineResource(server) {
   server.registerResource(
@@ -34661,15 +35894,41 @@ function registerEngineResource(server) {
   );
 }
 function buildServerInstructions(ctx) {
-  return "Impractical Motion makes studio-quality motion-graphics videos. Draft source lives in the cloud \u2014 there is no working copy on disk, so edit through these tools rather than writing files.\n\nTHE USER'S EDITS COME FIRST. While watching a draft in the Studio the user queues timecoded edit requests into its notes.json (\"Edits for agent\"). Before directing an existing draft, read_draft_file notes.json (it may not exist \u2014 that is fine); address the open items, and mark each one you have handled by setting its `done` to true with edit_draft_file, leaving the rest of the entry intact. The Studio shows the user what you resolved.\n\nYou are the director. Call engine_types first to learn the API, then motion_context to study the current house library and production references, then create_video, then write App.tsx (the stage markup) and direction.ts (the GSAP choreography) with edit_draft_file / write_draft_files. Every save returns its committed revision and preview-build job id immediately. Follow that id with job_status and fix any build error it returns. Call get_frames to SEE the result before telling the user it is done, then call export_video, follow its returned job id with job_status, and hand the user the studio_link.\n\nJOBS OUTLIVE TOOL CALLS. Job-producing mutations return their durable job id BEFORE any wait; resume that exact id with job_status({ jobIds: [...], wait: true }). Never start a second export or re-apply an edit after a committed revision. If the MCP client kills a call and shows only a timeout, assume the acknowledgment may have been lost: DO NOT blindly retry a mutating or metered tool. Verify state first. For a write/edit, use list_draft_files and read_draft_file to confirm the intended source and revision. For an export or other project mutation, use get_project/list_projects to check whether it already started or completed. brand_extract returns a durable run handle; continue that exact jobId in status mode and never re-extract blindly. If its start acknowledgement is lost, check brand_list/brand_get before starting again. Retry only when those reads prove the mutation did not commit; otherwise continue from the observed state.\n\nTHE MOTION FLOOR \u2014 these hold even if you read nothing else:\n1. Beat out the story before writing code: every beat needs a time, a visible subject, and a narrative purpose. An intentional reading hold is a valid beat.\n2. Text enters on RISE \u2014 text.reveal(el, 'rise') on promo-out, lines ~0.2s apart. Do NOT default type to 'blur': word-by-word de-blur reads as out-of-focus and a staggered blur turns to mush. Blur is for whole-frame moves \u2014 fx.spike(el, 'blur') alongside a whip or dive, where it hides the cut. Never animate blur above 20px.\n3. Every ease is a named house curve \u2014 ease-out-* for entrances, ease-in-out-* for travel and ALL camera moves, ease-in-* for exits and dives only. Never leave an ease unspecified, and never put an ease-in-* on an entrance.\n4. Motion is decisive: entrances 0.4-0.6s, exits shorter, line staggers ~0.2s apart. Longer movement needs a narrative reason; important states may hold still to be read.\n5. One primary and at most one supporting motion at a time. Keep backgrounds stable unless their movement is explicitly authored. Cuts are HARD (tl.set), never crossfades.\n6. Determinism: no Date.now, Math.random, setTimeout, or CSS transitions. The exporter renders by seeking, so wall-clock motion shimmers or vanishes.\n7. Never claim a video is done without calling get_frames and judging the visible story, hierarchy, proof, legibility, reference fidelity, and technical integrity \u2014 artifact-free is not the same as good.\n" + // Item 8 is the content doctrine, which is still under experiment: it ships
-  // only when IMPRACTICAL_CONTENT_DOCTRINE is set, so the same switch governs
-  // the doctrine here and in the phased flow's phase 2.
-  (contentDoctrineEnabled() ? "8. CONTENT: pretend the viewer has never heard of this product. Figure out the one thing they should walk away knowing, and say it in as few words as possible. If a smart 16-year-old could not repeat a line back in their own words, the line means nothing \u2014 cut it. No buzzwords, no vague taglines. Say a thing, then show it happening \u2014 in that order, one after the other, never both at once. Give the viewer exactly one thing to read at a time: no little label above a headline, no subtitle under it." : "") + "\n9. ICONS: always use real icons from the icon library, never typographic or ASCII stand-ins. lucide-react is available in every draft \u2014 `import { ArrowRight, Check } from 'lucide-react'`. An arrow is <ArrowRight/>, not \u2192 or ->; a tick is <Check/>, not \u2713; a chevron is <ChevronRight/>, not >; a play control is <Play/>, not \u25B6. Glyphs inherit the text font, so they land on the baseline at the wrong weight and optical size and read as a placeholder, and they cannot take a stroke width or animate as their own element. The same goes for emoji standing in for a UI affordance.\n10. FOCAL BUDGET: one focal point at a time. At most ONE region of the frame changes at once (a full-frame camera move is one change; a subject plus its direct reaction is the limit). A claim and the product may NEVER share the same space: while a statement is up, the product is fully cleared or fully hidden \u2014 dimming it under the words is not separation. Never stack anything on top of a dashboard while the dashboard is the subject. An element that finished its job exits before the next enters; the motion report now measures split focus and stacked text, and the film is not done while either fires.\n11. COMPONENT REHEARSAL: build and judge the hero components BEFORE choreographing the film. For each component that must look real (the dashboard, the inbox, the editor): build it, render it with get_frames in each state the beats will put it through, compare it against the reference you studied, and iterate until it holds up as a still. Only then write the timeline. A component that cannot survive a paused frame will not survive motion, and choreographing a broken component wastes every revision that follows.\n12. SCALE TRUTH: a product element never exceeds its native proportion. When a toast, button, or label must be readable, push the CAMERA to it so the whole UI scales together \u2014 never blow one element up inside otherwise-small chrome; an oversized toast over tiny UI text reads as a fake. The same for pointers: a cursor or caret is sized relative to the UI it operates on (match the product's zoom factor; at 67% zoom the cursor is 67% size), a caret pins to its text baseline, and a cursor tip lands ON its target, never near it. The census measures inflated elements; the film is not done while it fires.\n13. PACING: slow down. Stillness is a tool, not a defect \u2014 the dead-air check finds UNOWNED time, not quiet time. After every claim and every proof, HOLD: the viewer needs settled time to focus before the next change. The motion report flags nonstop motion (TOO FAST) exactly like it flags dead air, and the film is not done while either fires. THE CADENCE: one action at a time, about one every 1\u20131.5 seconds \u2014 a click, a panel opening, a card landing each count as one action. Let each settle before the next. The kit and camera defaults are already tuned to this; never override their durations to be FASTER. The report measures action frequency and flags stretches that pack more.\n14. CUTS: a scene change lands ONLY on a declared beat boundary \u2014 never mid-beat, never mid-read. A transition is either a real camera move (the house dolly) or a hard cut covered by the incoming element; a 0.1\u20130.3s squash-collapse is neither. Vary how scenes leave \u2014 the same exit mechanism back to back reads as a loop, and a scene alive under ~2 seconds never registered. The motion score measures all of this." + (ctx.qualityLoop ? qualityLoopServerInstructions() : "") + (ctx.motionLab ? motionLabServerInstructions() : "") + (ctx.phasedFlow ? phasedServerInstructions() : "");
+  return (
+    // Which BUILD is answering, as opposed to which release. Several agents
+    // on one machine routinely run different builds of this CLI — a
+    // published npx copy, a shared build dir, somebody's worktree — and the
+    // version alone cannot separate them, which is how a stale dist goes
+    // unnoticed. It lives here and not in serverInfo.version because that
+    // field means "the published release" and two test suites assert it.
+    `Impractical Motion CLI build: ${PACKAGE_VERSION}+${BUILD_COMMIT}
+Impractical Motion makes studio-quality motion-graphics videos. Draft source lives in the cloud \u2014 there is no working copy on disk, so edit through these tools rather than writing files.
+
+THE USER'S EDITS COME FIRST. While watching a draft in the Studio the user queues timecoded edit requests into its notes.json ("Edits for agent"). Before directing an existing draft, read_draft_file notes.json (it may not exist \u2014 that is fine); address the open items, and mark each one you have handled by setting its \`done\` to true with edit_draft_file, leaving the rest of the entry intact. The Studio shows the user what you resolved.
+
+You are the director. Call engine_types first to learn the API, then motion_context to study the current house library and production references, then create_video, then write App.tsx (the stage markup) and direction.ts (the GSAP choreography) with edit_draft_file / write_draft_files. Every save returns its committed revision and preview-build job id immediately. Follow that id with job_status and fix any build error it returns. Call get_frames to SEE the result before telling the user it is done, then call export_video, follow its returned job id with job_status, and hand the user the studio_link.
+
+JOBS OUTLIVE TOOL CALLS. Job-producing mutations return their durable job id BEFORE any wait; resume that exact id with job_status({ jobIds: [...], wait: true }). Never start a second export or re-apply an edit after a committed revision. If the MCP client kills a call and shows only a timeout, assume the acknowledgment may have been lost: DO NOT blindly retry a mutating or metered tool. Verify state first. For a write/edit, use list_draft_files and read_draft_file to confirm the intended source and revision. For an export or other project mutation, use get_project/list_projects to check whether it already started or completed. brand_extract returns a durable run handle; continue that exact jobId in status mode and never re-extract blindly. If its start acknowledgement is lost, check brand_list/brand_get before starting again. Retry only when those reads prove the mutation did not commit; otherwise continue from the observed state.
+
+THE MOTION FLOOR \u2014 these hold even if you read nothing else:
+1. Beat out the story before writing code: every beat needs a time, a visible subject, and a narrative purpose. An intentional reading hold is a valid beat.
+2. Text enters on RISE \u2014 text.reveal(el, 'rise') on promo-out, lines ~0.2s apart. Do NOT default type to 'blur': word-by-word de-blur reads as out-of-focus and a staggered blur turns to mush. Blur is for whole-frame moves \u2014 fx.spike(el, 'blur') alongside a whip or dive, where it hides the cut. Never animate blur above 20px.
+3. Every ease is a named house curve \u2014 ease-out-* for entrances, ease-in-out-* for travel and ALL camera moves, ease-in-* for exits and dives only. Never leave an ease unspecified, and never put an ease-in-* on an entrance.
+4. Motion is decisive: entrances 0.4-0.6s, exits shorter, line staggers ~0.2s apart. Longer movement needs a narrative reason; important states may hold still to be read.
+5. One primary and at most one supporting motion at a time. Keep backgrounds stable unless their movement is explicitly authored. Cuts are HARD (tl.set), never crossfades.
+6. Determinism: no Date.now, Math.random, setTimeout, or CSS transitions. The exporter renders by seeking, so wall-clock motion shimmers or vanishes.
+7. Never claim a video is done without calling get_frames and judging the visible story, hierarchy, proof, legibility, reference fidelity, and technical integrity \u2014 artifact-free is not the same as good.
+` + // Item 8 is the content doctrine, which is still under experiment: it ships
+    // only when IMPRACTICAL_CONTENT_DOCTRINE is set, so the same switch governs
+    // the doctrine here and in the phased flow's phase 2.
+    (contentDoctrineEnabled() ? "8. CONTENT: pretend the viewer has never heard of this product. Figure out the one thing they should walk away knowing, and say it in as few words as possible. If a smart 16-year-old could not repeat a line back in their own words, the line means nothing \u2014 cut it. No buzzwords, no vague taglines. Say a thing, then show it happening \u2014 in that order, one after the other, never both at once. Give the viewer exactly one thing to read at a time: no little label above a headline, no subtitle under it." : "") + "\n9. ICONS: always use real icons from the icon library, never typographic or ASCII stand-ins. lucide-react is available in every draft \u2014 `import { ArrowRight, Check } from 'lucide-react'`. An arrow is <ArrowRight/>, not \u2192 or ->; a tick is <Check/>, not \u2713; a chevron is <ChevronRight/>, not >; a play control is <Play/>, not \u25B6. Glyphs inherit the text font, so they land on the baseline at the wrong weight and optical size and read as a placeholder, and they cannot take a stroke width or animate as their own element. The same goes for emoji standing in for a UI affordance.\n10. FOCAL BUDGET: one focal point at a time. At most ONE region of the frame changes at once (a full-frame camera move is one change; a subject plus its direct reaction is the limit). A claim and the product may NEVER share the same space: while a statement is up, the product is fully cleared or fully hidden \u2014 dimming it under the words is not separation. Never stack anything on top of a dashboard while the dashboard is the subject. An element that finished its job exits before the next enters; the motion report now measures split focus and stacked text, and the film is not done while either fires.\n11. COMPONENT REHEARSAL: build and judge the hero components BEFORE choreographing the film. For each component that must look real (the dashboard, the inbox, the editor): build it, render it with get_frames in each state the beats will put it through, compare it against the reference you studied, and iterate until it holds up as a still. Only then write the timeline. A component that cannot survive a paused frame will not survive motion, and choreographing a broken component wastes every revision that follows.\n12. SCALE TRUTH: a product element never exceeds its native proportion. When a toast, button, or label must be readable, push the CAMERA to it so the whole UI scales together \u2014 never blow one element up inside otherwise-small chrome; an oversized toast over tiny UI text reads as a fake. The same for pointers: a cursor or caret is sized relative to the UI it operates on (match the product's zoom factor; at 67% zoom the cursor is 67% size), a caret pins to its text baseline, and a cursor tip lands ON its target, never near it. The census measures inflated elements; the film is not done while it fires.\n13. PACING: slow down. Stillness is a tool, not a defect \u2014 the dead-air check finds UNOWNED time, not quiet time. After every claim and every proof, HOLD: the viewer needs settled time to focus before the next change. The motion report flags nonstop motion (TOO FAST) exactly like it flags dead air, and the film is not done while either fires. THE CADENCE: one action at a time, about one every 1\u20131.5 seconds \u2014 a click, a panel opening, a card landing each count as one action. Let each settle before the next. The kit and camera defaults are already tuned to this; never override their durations to be FASTER. The report measures action frequency and flags stretches that pack more.\n14. CUTS: a scene change lands ONLY on a declared beat boundary \u2014 never mid-beat, never mid-read. A transition is either a real camera move (the house dolly) or a hard cut covered by the incoming element; a 0.1\u20130.3s squash-collapse is neither. Vary how scenes leave \u2014 the same exit mechanism back to back reads as a loop, and a scene alive under ~2 seconds never registered. The motion score measures all of this.\n15. THE GO-THROUGH: to dive into a button/card/color until it takes over the frame and becomes the next scene, ALWAYS use transition.through(target, { swap, land }) \u2014 never hand-roll it with a big camera.move scale plus a timed tl.set swap. Hand-rolled dives aim at build-time positions and miss; through() measures the target at the dive's start time, computes the exact cover scale, and guarantees the cut lands under full cover." + (ctx.qualityLoop ? qualityLoopServerInstructions() : "") + (ctx.motionLab ? motionLabServerInstructions() : "") + (ctx.craftLab ? "\n\nCRAFT LAB IS ENABLED \u2014 get_motion additionally prints a CRAFT ENVELOPE (depth, vocabulary, rhythm, continuity, geometry) band-scored against the house references. Camera motion is exempt from the restraint verdicts. Export enforces objective craft floors: at least one camera move, zero unresolved beat mismatches, zero geometry deformations, no dead-air span over 2.5s. Self-scores are recorded but do not gate; identical scorecards across drafts are rejected." : "") + (ctx.phasedFlow ? phasedServerInstructions() : "")
+  );
 }
 function createServer(ctx) {
   const qualityLoopState = ctx.qualityLoop ? ctx.qualityLoopState ?? createQualityLoopState() : void 0;
   const validatedCtx = {
     ...ctx,
+    sessionState: ctx.sessionState ?? createSessionState(),
     qualityLoopState,
     invoke: async (name, body = {}) => validateApiResponse(name, body, await ctx.invoke(name, body))
   };
@@ -34711,7 +35970,11 @@ async function runStdioServer() {
     appUrl: config2.appUrl,
     qualityLoop: qualityLoopEnabled(),
     motionLab: motionLabEnabled(),
-    phasedFlow: phasedFlowEnabled()
+    craftLab: craftLabEnabled(),
+    phasedFlow: phasedFlowEnabled(),
+    // stdio runs on the user's machine, so completed preview builds can be
+    // measured in the local browser and answered with what the frame became.
+    measurePreview: measureStage
   });
   await server.connect(new StdioServerTransport());
   const served = TOOLS.length + 2 + (motionLabEnabled() ? 1 : 0) + (phasedFlowEnabled() ? 1 : 0);