@cueframe/kernel 0.2.57 → 0.2.59-rc.0

package/dist/{chunk-FWSJLHSV.js → chunk-R642352J.js}

@@ -1,6 +1,6 @@
 import {
   TEXT_HI
-} from "./chunk-W2245F6G.js";
+} from "./chunk-WTQRLFR2.js";
 
 // ../execution/primitives/src/lib/text/contrast.ts
 var FLOOR_TEXT = TEXT_HI;

package/dist/{chunk-XELS2BGA.js → chunk-R6HTIP3N.js}

@@ -3,11 +3,9 @@ import { z } from "zod";
 var NonEmptyString = z.string().min(1);
 var ISODateTime = z.string().datetime({ offset: true });
 var EntityId = (_table) => z.string().min(1).brand();
-var ParamsBag = z.record(z.string(), z.unknown());
 
 export {
   NonEmptyString,
   ISODateTime,
-  EntityId,
-  ParamsBag
+  EntityId
 };

package/dist/{chunk-RL5SO653.js → chunk-RQRPSSRT.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-LT4PWSR2.js";
 import {
   resolveContrast
-} from "./chunk-FWSJLHSV.js";
+} from "./chunk-R642352J.js";
 import {
   fadeProgress,
   resolveEasing,

package/dist/chunk-RR7UBEBV.js

@@ -0,0 +1,172 @@
+import {
+  cssLayoutVars
+} from "./chunk-DKBFAQCW.js";
+
+// ../authoring/src/motion/shell.ts
+var MOTION_PRESETS = [
+  "fade-up",
+  "slide-in-left",
+  "slide-in-right",
+  "scale-pop",
+  "stagger-reveal"
+];
+var PRESET_FROM = {
+  "fade-up": { dx: 0, dy: 24, scale: 1 },
+  "slide-in-left": { dx: -48, dy: 0, scale: 1 },
+  "slide-in-right": { dx: 48, dy: 0, scale: 1 },
+  "scale-pop": { dx: 0, dy: 0, scale: 0.92 },
+  "stagger-reveal": { dx: 0, dy: 12, scale: 1 }
+};
+var PRESET_SUSTAIN = {
+  "fade-up": { dx: 0, dy: -6, scale: 0.012 },
+  "slide-in-left": { dx: 14, dy: 0, scale: 8e-3 },
+  "slide-in-right": { dx: -14, dy: 0, scale: 8e-3 },
+  "scale-pop": { dx: 0, dy: -4, scale: 0.012 },
+  "stagger-reveal": { dx: 0, dy: -4, scale: 0.01 }
+};
+var POP_WOBBLE = { amp: 8e-3, tau: 0.45, hz: 1.8 };
+var STAGGER_BREATHE = { amp: 2, periodS: 3.4, phase: 0.9 };
+var MAX_STAGGER_CHILDREN = 8;
+function generateMotionShell(cardHtml, opts) {
+  if (!cardHtml.trim()) throw new Error("generateMotionShell: empty card markup");
+  const enterMs = opts.enterMs ?? 300;
+  const exitMs = opts.exitMs ?? 300;
+  const staggerMs = opts.staggerMs ?? 120;
+  const from = PRESET_FROM[opts.preset];
+  if (!from) throw new Error(`generateMotionShell: unknown preset '${opts.preset}'`);
+  const sustain = PRESET_SUSTAIN[opts.preset];
+  const tokenVars = cssLayoutVars(opts.tokens, void 0);
+  const staggerBlock = opts.preset === "stagger-reveal" ? `
+  const staggerF = Math.max(1, Math.round((${staggerMs} / 1000) * fps));
+  const staggerRules = Array.from({ length: ${MAX_STAGGER_CHILDREN} }, (_, i) => {
+    const s = enterF + i * staggerF;
+    const o = interpolate(frame, [s, s + enterF], [0, 1], { extrapolateLeft: 'clamp', extrapolateRight: 'clamp' });
+    const breathe = ${STAGGER_BREATHE.amp} * Math.sin((tSec / ${STAGGER_BREATHE.periodS}) * Math.PI * 2 + i * ${STAGGER_BREATHE.phase});
+    return '[data-stagger] > *:nth-child(' + (i + 1) + ') { opacity: ' + o + '; translate: 0 ' + breathe.toFixed(3) + 'px; }';
+  }).join('\\n');` : "";
+  const staggerStyleEl = opts.preset === "stagger-reveal" ? `<style>{staggerRules}</style>` : "";
+  return `// generated by @cueframe/authoring generateMotionShell \u2014 preset: ${opts.preset}
+import { Easing, interpolate, useCurrentFrame, useVideoConfig } from 'remotion';
+
+export default function CardMotionShell({ durationInFrames, params }) {
+  const frame = useCurrentFrame();
+  const { fps } = useVideoConfig();
+  const CARD_HTML = ${JSON.stringify(cardHtml)};
+  const enterF = Math.max(1, Math.round((${enterMs} / 1000) * fps));
+  const exitF = Math.max(1, Math.round((${exitMs} / 1000) * fps));
+  const enter = interpolate(frame, [0, enterF], [0, 1],
+    { easing: Easing.out(Easing.cubic), extrapolateLeft: 'clamp', extrapolateRight: 'clamp' });
+  const exit = interpolate(frame,
+    [Math.max(enterF + 1, durationInFrames - exitF), durationInFrames], [1, 0],
+    { easing: Easing.in(Easing.cubic), extrapolateLeft: 'clamp', extrapolateRight: 'clamp' });
+  const opacity = Math.min(enter, exit);
+  const hold = interpolate(frame, [enterF, durationInFrames], [0, 1],
+    { extrapolateLeft: 'clamp', extrapolateRight: 'clamp' });
+  const tSec = Math.max(0, frame - enterF) / fps;
+  const wobble = ${opts.preset === "scale-pop" ? `${POP_WOBBLE.amp} * Math.exp(-tSec / ${POP_WOBBLE.tau}) * Math.sin(tSec * Math.PI * 2 * ${POP_WOBBLE.hz})` : "0"};
+  const dx = ${from.dx} * (1 - enter) + ${sustain.dx} * hold;
+  const dy = ${from.dy} * (1 - enter) + ${sustain.dy} * hold;
+  const scale = ${from.scale} + (1 - ${from.scale}) * enter + ${sustain.scale} * hold + wobble;${staggerBlock}
+  const TOKEN_VARS = ${JSON.stringify(tokenVars)};
+  return (
+    <div style={{ position: 'absolute', inset: 0, ...TOKEN_VARS,
+      opacity, transform: 'translate(' + dx + 'px,' + dy + 'px) scale(' + scale + ')' }}>
+      ${staggerStyleEl}<div style={{ width: '100%', height: '100%' }}
+        dangerouslySetInnerHTML={{ __html: CARD_HTML }} />
+    </div>
+  );
+}
+`;
+}
+
+// ../authoring/src/motion/applyMotionPreset.ts
+var MotionPresetError = class extends Error {
+  constructor(code, message, opIndex) {
+    super(message);
+    this.code = code;
+    this.opIndex = opIndex;
+    this.name = "MotionPresetError";
+  }
+  code;
+  opIndex;
+};
+function resolveMotionPresetCard(composition, input) {
+  if (!MOTION_PRESETS.includes(input.preset)) {
+    throw new MotionPresetError(
+      "motion_preset_unknown",
+      `unknown motion preset '${input.preset}' \u2014 pick one of: ${MOTION_PRESETS.join(", ")}`
+    );
+  }
+  const tracks = composition.tracks ?? [];
+  const sourced = tracks.flatMap((t) => t?.contents ?? []).filter((c) => !!c && typeof c === "object" && "source" in c && "id" in c);
+  const clip = sourced.find((c) => c.id === input.clipId);
+  if (!clip) {
+    const cards = sourced.filter((c) => c.source.kind === "card").map((c) => `'${c.id}'`);
+    throw new MotionPresetError(
+      "motion_preset_target_invalid",
+      `applyMotionPreset: no clip '${input.clipId}' in the composition. ` + (cards.length > 0 ? `Static card clip ids present: ${cards.join(", ")}.` : `No static card clips remain (already shelled or none authored).`)
+    );
+  }
+  if (clip.source.kind !== "card" || !clip.source.html) {
+    throw new MotionPresetError(
+      "motion_preset_target_invalid",
+      `applyMotionPreset targets only static card clips \u2014 clip '${input.clipId}' is '${clip.source.kind}'. Library overlays already move (update them directly); components already carry their authored motion.`
+    );
+  }
+  return {
+    cardHtml: clip.source.html,
+    ...clip.source.tokens !== void 0 ? { tokens: clip.source.tokens } : {},
+    ...clip.source.zPlane !== void 0 ? { zPlane: clip.source.zPlane } : {}
+  };
+}
+
+// ../authoring/src/motion/materializeMotionPresetOps.ts
+var isMotionPresetOp = (op) => !!op && typeof op === "object" && op.type === "applyMotionPreset";
+var hasMotionPresetOp = (ops) => ops.some(isMotionPresetOp);
+async function materializeMotionPresetOpsCore(composition, ops, deps) {
+  const out = [];
+  let current = composition;
+  for (let i = 0; i < ops.length; i++) {
+    const op = ops[i];
+    if (!isMotionPresetOp(op)) {
+      out.push(op);
+      if (deps.apply) current = deps.apply(current, op);
+      continue;
+    }
+    let card;
+    try {
+      card = resolveMotionPresetCard(current, { clipId: op.clipId, preset: op.preset });
+    } catch (err) {
+      if (err instanceof MotionPresetError) err.opIndex = i;
+      throw err;
+    }
+    const componentId = `motion-shell-${op.clipId}`;
+    const tsxSource = generateMotionShell(card.cardHtml, {
+      preset: op.preset,
+      ...op.params?.enterMs !== void 0 ? { enterMs: op.params.enterMs } : {},
+      ...op.params?.exitMs !== void 0 ? { exitMs: op.params.exitMs } : {},
+      ...op.params?.staggerMs !== void 0 ? { staggerMs: op.params.staggerMs } : {},
+      ...card.tokens !== void 0 ? { tokens: card.tokens } : {}
+    });
+    const materialized = await deps.sink({
+      componentId,
+      clipId: op.clipId,
+      preset: op.preset,
+      tsxSource,
+      ...card.zPlane !== void 0 ? { zPlane: card.zPlane } : {}
+    });
+    out.push(materialized);
+    if (deps.apply) current = deps.apply(current, materialized);
+  }
+  return out;
+}
+
+export {
+  MOTION_PRESETS,
+  generateMotionShell,
+  MotionPresetError,
+  resolveMotionPresetCard,
+  isMotionPresetOp,
+  hasMotionPresetOp,
+  materializeMotionPresetOpsCore
+};

package/dist/{chunk-FHMTAZD4.js → chunk-RWJHZCOR.js}

@@ -4386,74 +4386,6 @@ function gridToHeroRecipe(input) {
   return { tiles };
 }
 
-// ../execution/animate/src/index.ts
-var sandboxScope = {
-  smooth,
-  smootherstep,
-  rushInto,
-  rushFrom,
-  Create,
-  GrowFromCenter,
-  FadeIn,
-  Write,
-  Indicate,
-  Wiggle,
-  LaggedStart,
-  AnimationGroup,
-  Succession,
-  Transform,
-  MoveAlongPath,
-  GrowArrow,
-  Arrow,
-  makeArrowPath,
-  BrandBox,
-  Graph,
-  DiGraph,
-  ThreeCanvas,
-  FrameDepthOfField,
-  StageCameraRig,
-  useImageTexture,
-  StudioRig,
-  DeviceMesh,
-  deviceDimensions,
-  lidRotationX,
-  makeDefaultScreenTexture,
-  defaultScreenLayout,
-  solveFlex,
-  flexReady,
-  isFlexReady,
-  leafIds,
-  flexBoxToThree,
-  fitBox,
-  FlexLayout,
-  useFlexReady,
-  PerspectiveStage,
-  StageLayer,
-  ContactShadow,
-  useStage,
-  resolveCamera,
-  cameraToThree,
-  perspectiveFor,
-  worldTransform,
-  dofBlur,
-  CAMERA_PRESETS,
-  dollyIn,
-  dollyOut,
-  drift,
-  tiltReveal,
-  orbit,
-  DEFAULT_CAMERA,
-  MediaTileScene,
-  ImageTileScene,
-  driftWallRecipe,
-  infiniteSpiralRecipe,
-  depthJourneyRecipe,
-  infiniteCanvasRecipe,
-  gridToHeroRecipe,
-  SceneShotV2
-};
-var sandboxScopeNames = Object.keys(sandboxScope);
-
 export {
   smooth,
   smootherstep,
@@ -4555,7 +4487,5 @@ export {
   infiniteSpiralRecipe,
   depthJourneyRecipe,
   infiniteCanvasRecipe,
-  gridToHeroRecipe,
-  sandboxScope,
-  sandboxScopeNames
+  gridToHeroRecipe
 };

package/dist/{chunk-73DQTUWY.js → chunk-TIAJMEQ4.js}

@@ -1,6 +1,6 @@
 import {
   EntityId
-} from "./chunk-XELS2BGA.js";
+} from "./chunk-R6HTIP3N.js";
 
 // ../data-models/media-model/src/generation.ts
 import { z } from "zod";
@@ -91,25 +91,6 @@ var GenerationCapability = z.object({
   supportsQuote: z.boolean()
 });
 var GenerationCapabilities = z.array(GenerationCapability);
-function deriveGenerationStatus(sources) {
-  const { attempt, resource, materialisation } = sources;
-  if (attempt.status === "failed") {
-    return { status: "failed", placementReady: false, ...attempt.failure ? { failure: attempt.failure } : {} };
-  }
-  if (attempt.status === "cancelled") return { status: "cancelled", placementReady: false };
-  if (attempt.status === "cancelling") return { status: "cancelling", placementReady: false };
-  if (materialisation.status === "failed") {
-    return { status: "failed", placementReady: false, ...materialisation.failure ? { failure: materialisation.failure } : {} };
-  }
-  if (!resource.durable) return { status: attempt.status, placementReady: false };
-  if (materialisation.required && (!materialisation.verifiedBytes || materialisation.status !== "complete")) {
-    return { status: "materialising", placementReady: false };
-  }
-  if (!resource.decodable || !resource.metadataReady) {
-    return { status: "processing", placementReady: false };
-  }
-  return { status: "ready", placementReady: resource.placementReady };
-}
 
 export {
   MediaId,
@@ -126,6 +107,5 @@ export {
   GenerationFailure,
   GenerationArtifact,
   GenerationCapability,
-  GenerationCapabilities,
-  deriveGenerationStatus
+  GenerationCapabilities
 };

package/dist/{chunk-2ESYSVXG.js → chunk-U67V476Y.js}

@@ -4,16 +4,7 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
-var __commonJS = (cb, mod) => function __require2() {
+var __commonJS = (cb, mod) => function __require() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
 var __export = (target, all) => {
@@ -36,13 +27,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 export {
-  __require,
-  __esm,
   __commonJS,
   __export,
-  __toESM,
-  __toCommonJS
+  __toESM
 };

package/dist/{chunk-N54EGUVM.js → chunk-U7KSOA2L.js}

@@ -1,20 +1,14 @@
 import {
-  GenerationArtifact,
   MediaId,
   ProjectHome
-} from "./chunk-73DQTUWY.js";
-import {
-  EntityId
-} from "./chunk-XELS2BGA.js";
+} from "./chunk-TIAJMEQ4.js";
 import {
   decodeError,
   scrubSensitive
-} from "./chunk-E63UEO5C.js";
+} from "./chunk-XQGQ5EFS.js";
 
 // ../director/src/domain/chat.ts
 import { z } from "zod";
-var ConversationId = EntityId("conversation");
-var DirectorRunId = EntityId("directorRun");
 var ProjectRef = z.object({
   id: z.string().min(1),
   home: ProjectHome
@@ -34,7 +28,7 @@ var ChatErrorView = z.object({
   title: z.string().min(1),
   recovery: z.string().optional(),
   retryable: z.boolean(),
-  source: z.enum(["provider", "generation", "materialisation", "agent", "transport"]).optional(),
+  source: z.enum(["provider", "generation", "agent", "transport"]).optional(),
   correlationId: z.string().optional(),
   details: z.string().max(4e3).optional()
 });
@@ -71,23 +65,12 @@ function chatErrorViewFromUnknown(error, source = "agent") {
     ...details ? { details } : {}
   };
 }
-var DirectorEvent = z.discriminatedUnion("type", [
-  z.object({ type: z.literal("text-delta"), text: z.string() }),
-  z.object({ type: z.literal("reasoning-delta"), text: z.string() }),
-  z.object({ type: z.literal("phase"), phase: z.string(), detail: z.string().optional() }),
-  z.object({ type: z.literal("generation"), artifact: GenerationArtifact }),
-  z.object({ type: z.literal("error"), error: ChatErrorView }),
-  z.object({ type: z.literal("finish") })
-]);
 
 export {
-  ConversationId,
-  DirectorRunId,
   ProjectRef,
   DirectorTurnContext,
   DirectorTurnEnvelope,
   ChatErrorView,
   chatErrorViewFromEnvelope,
-  chatErrorViewFromUnknown,
-  DirectorEvent
+  chatErrorViewFromUnknown
 };

package/dist/{chunk-K66NLMGX.js → chunk-UGWJC4GA.js}

@@ -1,6 +1,6 @@
 import {
   ComponentRuntimeError
-} from "./chunk-EC6VFQE6.js";
+} from "./chunk-BZVOCVQV.js";
 
 // ../execution/component-runtime/src/allowedImports.ts
 var COMPONENT_IMPORT_ALLOWLIST = Object.freeze([
@@ -23,10 +23,12 @@ var COMPONENT_IMPORT_ALLOWLIST = Object.freeze([
   "gsap",
   "postprocessing"
 ]);
-
-// ../execution/component-runtime/src/importPolicy.ts
-import { parse } from "@babel/parser";
-var ALLOWED_IMPORTS = new Set(COMPONENT_IMPORT_ALLOWLIST);
+var DENIED_AMBIENT_CALLS = /* @__PURE__ */ new Set([
+  "Date",
+  "requestAnimationFrame",
+  "setTimeout",
+  "setInterval"
+]);
 var DENIED_NONDETERMINISTIC_MEMBERS = /* @__PURE__ */ new Set([
   "Math.random",
   "Date.now",
@@ -34,13 +36,17 @@ var DENIED_NONDETERMINISTIC_MEMBERS = /* @__PURE__ */ new Set([
   "crypto.getRandomValues",
   "crypto.randomUUID"
 ]);
-var DENIED_AMBIENT_CALLS = /* @__PURE__ */ new Set([
-  "Date",
-  "requestAnimationFrame",
-  "setTimeout",
-  "setInterval"
+var GUARDED_MEDIA_EXPORTS = /* @__PURE__ */ new Set([
+  "Audio",
+  "Html5Audio",
+  "Html5Video",
+  "OffthreadVideo",
+  "Video"
 ]);
-var GUARDED_MEDIA_EXPORTS = /* @__PURE__ */ new Set(["Audio", "Html5Audio", "Html5Video", "OffthreadVideo", "Video"]);
+
+// ../execution/component-runtime/src/importPolicy.ts
+import { parse } from "@babel/parser";
+var ALLOWED_IMPORTS = new Set(COMPONENT_IMPORT_ALLOWLIST);
 function importedName(specifier) {
   const imported = specifier.imported;
   if (specifier.type !== "ImportSpecifier" || !imported) return null;
@@ -68,9 +74,43 @@ function denied(specifier) {
     `Component import is not allowed: ${JSON.stringify(specifier)}.`
   );
 }
+var IGNORED_KEYS = /* @__PURE__ */ new Set(["loc", "start", "end", "errors", "comments"]);
+function walkableChildren(node) {
+  return Object.entries(node).filter(([key]) => !IGNORED_KEYS.has(key)).map(([, child]) => child);
+}
+function assertMediaTileScenePropsExplicit(value, names) {
+  if (!value || typeof value !== "object") return;
+  if (Array.isArray(value)) {
+    for (const child of value) assertMediaTileScenePropsExplicit(child, names);
+    return;
+  }
+  const node = value;
+  const name = node.name;
+  if (node.type === "JSXOpeningElement" && name?.type === "JSXIdentifier" && names.has(name.name)) {
+    const attributes = Array.isArray(node.attributes) ? node.attributes : [];
+    if (attributes.some((attribute) => attribute.type === "JSXSpreadAttribute")) {
+      throw new ComponentRuntimeError(
+        "component_api_mismatch",
+        "MediaTileScene props must be explicit so the source can be admitted."
+      );
+    }
+    const given = new Set(attributes.flatMap((attribute) => {
+      const key = attribute.name;
+      return attribute.type === "JSXAttribute" && key?.type === "JSXIdentifier" ? [key.name] : [];
+    }));
+    const missing = ["streams", "tiles"].filter((prop) => !given.has(prop));
+    if (missing.length > 0) {
+      throw new ComponentRuntimeError(
+        "component_api_mismatch",
+        `MediaTileScene requires ${missing.map((prop) => `\`${prop}\``).join(" and ")}. Pass \`streams={{ id: { asset: assets.slot } }}\` and make each tile reference that id with \`stream\`.`
+      );
+    }
+  }
+  for (const child of walkableChildren(node)) assertMediaTileScenePropsExplicit(child, names);
+}
 function assertComponentImportsAllowed(tsxSource, graphicsApi) {
   let root;
-  let usesMediaTileScene = false;
+  const mediaTileSceneNames = /* @__PURE__ */ new Set();
   try {
     root = parse(tsxSource, {
       sourceType: "module",
@@ -101,7 +141,12 @@ function assertComponentImportsAllowed(tsxSource, graphicsApi) {
       }
       if (specifier === "@cueframe/animate" && type === "ImportDeclaration") {
         const specifiers = Array.isArray(node.specifiers) ? node.specifiers : [];
-        usesMediaTileScene ||= specifiers.map(importedName).some((name) => name === "MediaTileScene" || name === "ImageTileScene");
+        for (const imported of specifiers) {
+          const name = importedName(imported);
+          if (name !== "MediaTileScene" && name !== "ImageTileScene") continue;
+          const local = imported.local;
+          mediaTileSceneNames.add(typeof local?.name === "string" ? local.name : name);
+        }
       }
     }
     if (type === "ImportExpression") denied("dynamic import()");
@@ -153,13 +198,12 @@ function assertComponentImportsAllowed(tsxSource, graphicsApi) {
         denied(argument.value);
       }
     }
-    for (const [key, child] of Object.entries(node)) {
-      if (key === "loc" || key === "start" || key === "end" || key === "errors" || key === "comments") continue;
-      visit(child);
-    }
+    for (const child of walkableChildren(node)) visit(child);
   };
   visit(root);
-  if (usesMediaTileScene && graphicsApi !== void 0 && graphicsApi !== "webgl2") {
+  if (mediaTileSceneNames.size === 0) return;
+  assertMediaTileScenePropsExplicit(root, mediaTileSceneNames);
+  if (graphicsApi !== void 0 && graphicsApi !== "webgl2") {
     throw new ComponentRuntimeError(
       "component_graphics_mismatch",
       "MediaTileScene requires manifest.graphics.api to be webgl2."

package/dist/chunk-VBYINB74.js

@@ -0,0 +1,136 @@
+// ../authoring/src/prompts/evaluatorPrompt.ts
+var EVALUATOR_PROMPT = `You are a skeptical QA reviewer. Your job is to find problems, not praise work.
+
+SCORING RULES:
+- If something looks "fine" but not "good", that's a 5, not a 7.
+- Never say "overall looks good" then list issues. Issues mean score deductions.
+- If a verification criterion is not met, the phase FAILS regardless of other scores.
+- Compare against the original task: anything skipped is a deduction.
+- Score each dimension independently on a 0-10 scale.
+
+CALIBRATION:
+
+## Timeline Edit: design_quality
+SCORE 3/10 \u2014 FAIL:
+"Centered white text on dark background. No animation. No accent elements."
+
+SCORE 8/10 \u2014 PASS:
+"Staggered entrance with spring physics, accent bar + text with letter-spacing animation, exit choreography in final 15 frames. Multiple animated layers."
+
+THE DIFFERENCE: Layered composition with choreographed timing vs. single static element.
+
+## Timeline Edit: craft
+SCORE 3/10 \u2014 FAIL:
+"Linear fade in, linear fade out. No spring physics. No stagger. Static positioning."
+
+SCORE 8/10 \u2014 PASS:
+"Spring entrance (damping: 12, stiffness: 180), 8-frame stagger between elements, translateY exit with opacity fade, accent bar slides independently."
+
+THE DIFFERENCE: Physics-based motion with choreography vs. basic CSS transitions.
+
+## Artifact: quality
+SCORE 3/10 \u2014 FAIL:
+"Generic summary that could be about any podcast. No specific quotes or moments referenced."
+
+SCORE 8/10 \u2014 PASS:
+"Opens with a specific compelling quote from the episode. References 3 key moments by timestamp. Matches the host's voice and vocabulary."
+
+THE DIFFERENCE: Specific, contextualized content vs. generic filler.
+
+OUTPUT FORMAT:
+Respond with ONLY a JSON object (no markdown, no explanation):
+{
+  "scores": { "dimension_name": 0-10, ... },
+  "critique": "specific issues found",
+  "evidence": ["what you observed"]
+}`;
+
+// ../authoring/src/prompts/plannerPrompt.ts
+function formatPlanSteps(steps) {
+  const arr = steps ?? [];
+  return "PLAN:\n" + arr.map(
+    (s) => `- ${s.time}s: ${s.name} | ${s.overlayType} | ${s.duration}s | text: "${s.text}" | ${s.visual}`
+  ).join("\n");
+}
+function buildExecutionTask(plan, originalTask) {
+  return `## Pre-approved Plan
+
+Execute this plan exactly. Land one element at a time, in order.
+Do NOT re-plan or reconsider \u2014 the plan is locked in.
+
+<plan>
+${plan}
+</plan>
+
+Original request: ${originalTask}
+
+Instructions:
+1. For each line in the plan, apply it with \`apply_composition\`:
+   - A graphic is a \`clip.add\` op \u2014 a \`{ kind: 'card', html, tokens }\` source for
+     copy you write, a \`{ kind: 'overlay', primitiveId, params }\` source for a
+     catalog primitive, or a \`{ kind: 'component', componentId }\` source for a
+     component you authored. Use the plan's timing verbatim.
+   - A change to something already on the timeline is a \`clip.update\` op
+     carrying ONLY the fields that move.
+2. Batch the ops for one element into a single call, then \`preview_frame\` at the
+   moments you touched to verify. Fix what the pixels show, then move to the next.
+3. Do NOT skip or add items outside the plan.
+`;
+}
+function buildPlannerUserMessage(params) {
+  const parts = [
+    PLANNING_INSTRUCTIONS,
+    "\n## User Request\n\n" + params.task
+  ];
+  const history = params.messages.slice(0, -1).filter((m) => m.content.length > 0);
+  if (history.length > 0) {
+    parts.push(
+      "\n## Conversation History\n\n" + history.map((m) => `<${m.role}>
+${m.content}
+</${m.role}>`).join("\n")
+    );
+  }
+  return parts.join("\n");
+}
+var PLANNING_INSTRUCTIONS = `Analyze the project state and transcript to decide if this request needs a multi-overlay plan or can be executed directly.
+
+## Workflow
+
+1. Call get_context to understand the current project state and transcript \u2014 it
+   returns the lead transcript's word timings, so most plans need nothing else.
+2. Call get_media_context for a SPECIFIC media item when you need its own word
+   timings or its detected faces; analyze_transcript when you want the editorial
+   read (summary / chapters / highlights) rather than the words.
+3. Call submit_plan with your decision.
+
+## Decision Criteria
+
+Call submit_plan with type "direct" if:
+- The request is a single action (remove, delete, change, update one thing)
+- No transcript analysis is needed
+
+Call submit_plan with type "plan" if:
+- Multiple overlays or scenes are needed
+- The request involves analyzing the transcript for key moments
+
+## Overlay Types (for plan steps)
+- full-screen: Bold text/graphic covering most of the frame (3-5s)
+- lower-third: Subtitle-style bar in the lower third (3-6s)
+- intro: Title card with ripple insert (3-5s)
+- outro: End card with ripple insert (3-5s)
+- scene: Full-screen designed moment (5-30s) \u2014 a card or component that owns the
+  frame: a stat, a comparison, a sequence, a diagram built from catalog pieces
+
+## Plan Guidelines (when type is "plan")
+- Pick 3-7 key moments, spaced at least 10s apart
+- Text MUST come from the actual transcript \u2014 do not invent quotes
+- Prefer moments where the speaker introduces a concept or transitions topics
+- At most 1 intro and 1 outro`;
+
+export {
+  EVALUATOR_PROMPT,
+  formatPlanSteps,
+  buildExecutionTask,
+  buildPlannerUserMessage,
+  PLANNING_INSTRUCTIONS
+};