@cueframe/kernel 0.1.2 → 0.1.3

package/dist/{chunk-K2IUBCND.js → chunk-HFC3MKXA.js}

@@ -127,55 +127,6 @@ Call submit_plan with type "plan" if:
 - Prefer moments where the speaker introduces a concept or transitions topics
 - At most 1 intro and 1 outro`;
 
-// ../authoring/src/prompts/designReviewerPrompt.ts
-var DESIGN_REVIEWER_PROMPT = `You are a design quality reviewer for motion graphics in CueFrame.
-
-## Workflow
-
-1. Call \`get_context\` to understand the current project state and brand kit.
-2. Call \`get_composition\` to read the graphics themselves \u2014 a card clip carries its
-   \`html\` and \`tokens\` verbatim; an overlay or component clip carries its params.
-   For a component's animation code, call \`get_component_source\` with its componentId.
-3. Call \`preview_frame\` with EVERY beat you need to see in ONE call \u2014 the rendered
-   pixels, not your reading of the source.
-4. Assess quality against the checklist below. If improvements are needed, send the
-   fixes as ONE \`apply_composition\` batch \u2014 a \`clip.update\` op per graphic carrying
-   only the fields that change \u2014 then re-preview the beats you touched to verify.
-
-## Quality Checklist
-
-- **Visual hierarchy**: Title large/bold, subtext smaller/lighter, decorative elements subtle
-- **Animation choreography**: Elements arrive in sequence with staggered timing, not all at once
-- **Spring physics**: Use \`spring()\` for organic entrances instead of plain linear interpolation
-- **Color usage**: Read ALL colors from params (accentColor, textColor, backgroundColor) \u2014 never hardcode
-- **Entrance + exit**: Choreographed entrance sequence AND fade-out in final 15 frames
-- **Layered composition**: Multiple animated elements (text + accent line + shape + bg glow), not just a single element with opacity
-- **Typography**: Appropriate font from FONTS.*, proper letter-spacing, readable sizing
-- **Atmosphere**: Subtle glows, gradients, or accent color bleeds for depth
-
-## Component Contract
-
-- Signature: \`export default function Name({ durationInFrames, params }) { ... }\`
-- ONLY \`useCurrentFrame()\` and \`useVideoConfig()\` hooks. NO useEffect/useState/useMemo/useCallback/useRef.
-- Inline styles only. No imports, no CSS files, no \`document\` access. Max 10000 chars.
-- All animation driven by frame number.
-
-## Guidelines
-
-- Be specific in feedback: cite which element, which frame range, what to change.
-- Prefer refinement over complete rewrites \u2014 preserve the designer's intent.
-- A still cannot show motion. Judge timing and choreography from the source; judge
-  layout, contrast and legibility from the frame.
-- After fixing, always re-preview to confirm the improvement visually.
-`;
-var DESIGN_REVIEWER_TOOLS = [
-  "get_context",
-  "get_composition",
-  "get_component_source",
-  "preview_frame",
-  "apply_composition"
-];
-
 // ../authoring/src/prompts/graphics.ts
 var CODE_GEN_FEW_SHOT_EXAMPLES = `
 ## Reference Examples (study these patterns, then write your component)
@@ -404,8 +355,6 @@ export {
   buildExecutionTask,
   buildPlannerUserMessage,
   PLANNING_INSTRUCTIONS,
-  DESIGN_REVIEWER_PROMPT,
-  DESIGN_REVIEWER_TOOLS,
   CODE_GEN_FEW_SHOT_EXAMPLES,
   COMPONENT_CONTRACT,
   TOOLKIT_REFERENCE,

package/dist/{chunk-TD347SSX.js → chunk-KFECIHED.js}

@@ -1,6 +1,6 @@
 import {
   waitForJob
-} from "./chunk-QETYXKQQ.js";
+} from "./chunk-SDCEJAO2.js";
 import {
   GENERATED_OPERATIONS,
   apiErrorFrom,
@@ -17,10 +17,10 @@ import {
   sniffImageMediaType,
   text,
   withMedia
-} from "./chunk-W3SIWT7J.js";
+} from "./chunk-DL7WYISQ.js";
 import {
   CURATED_TOOLS
-} from "./chunk-AO744WIK.js";
+} from "./chunk-DJW3UGBH.js";
 
 // ../mcp/src/prompts.ts
 var skillListCache = null;
@@ -91,17 +91,17 @@ CLIPPING (find the best short-form moments in a long video): \`suggest_briefs\`
 
 Every expensive step has a cheap, inspectable check \u2014 prefer reading a value over rendering and eyeballing:
 - Framing & timing are data: \`get_media_context\` BEFORE you compose.
-- Evidence beats guessing: \`preview_frame\` (whole-composition stills), \`preview_component\` (ONE graphic as a MOTION clip \u2014 the same bake production composites), \`preview_clip\` (a fromSec\u2192toSec window as a watchable MP4, max 60s, capture-priced \u2014 judge a cut or transition at full fidelity WITHOUT paying for a full render). These are STATELESS: nothing to open, warm, or close; concurrent previews do not contend. \`preview_frame\` defaults to the PERSISTED composition and echoes \`previewed.{source, compositionId, etag}\` \u2014 what you saw is what create_render encodes.
+- Evidence beats guessing: \`preview_frame\` (whole-composition stills), \`preview_component\` (ONE authored graphic: \`executionMode:"live"\` returns a PNG image; \`executionMode:"baked"\` returns a transparent VP9 motion clip \u2014 exactly the lane production composites), \`preview_clip\` (a fromSec\u2192toSec window as a watchable MP4, max 60s, capture-priced \u2014 judge a cut or transition at full fidelity WITHOUT paying for a full render). These are STATELESS: nothing to open, warm, or close; concurrent previews do not contend. \`preview_frame\` defaults to the PERSISTED composition and echoes \`previewed.{source, compositionId, etag}\` \u2014 what you saw is what create_render encodes.
 - Quality is a number: \`score_composition\` returns scores + critique + a checkpointId; the compose result carries the winner's composite. **score vs consult**: score answers "how good IS this" (grounded numbers); \`consult\` answers "what SHOULD I change" (advice + an adoptable fix via \`select_candidate\`).
 
 ## Async model
 
 Every long job is either polled or pushed \u2014 never guessed:
-- \`wait_job\` kinds: \`render\`, \`compose\`, \`suggestions\`, \`verify\` (score jobs), \`preview\` (component clips), \`brand_kit_extract\`, \`consult\`. It blocks up to its window and returns a CONTINUATION when still running \u2014 re-call it.
+- \`wait_job\` kinds: \`media\` (imports/generation), \`render\`, \`compose\`, \`suggestions\`, \`verify\` (score jobs), \`preview_frame\` (composition stills), \`preview\` (component image-or-motion previews), \`brand_kit_extract\`, \`consult\`. It blocks up to its window and returns a CONTINUATION when still running \u2014 re-call it.
 - Webhooks (\`create_webhook\`): ONE terminal event per kind with status INSIDE the payload \u2014 \`render.completed\`, \`compose.completed\`, \`media.completed\`, \`suggest.completed\` \u2014 plus \`checkpoint.ready\` (a held compose paused for review). Read \`cueframe://webhook-events\` for the full contract before building a receiver.
 - Presigned URLs (stills, clips, render outputs) expire \u2014 render outputs last ~7 days (refresh via the render's refresh-url op); preview stills/clips ~1 hour. Re-read for a fresh link instead of caching one.
 
-CUSTOM GRAPHICS \u2014 author or FORK: \`create_component\` (tsxSource) from scratch, or \`get_component_source\` on a built-in primitive (e.g. \`cinematic-title\`) to fork its editable module. Iterate author\u2192preview\u2192fix with \`preview_component\` (202 + jobId; \`wait_job(kind:"preview")\` returns the clip URL \u2014 a compile failure lands on the job's FAILED terminal carrying the sanitized compiler error) \u2192 fix via \`update_component\` \u2192 preview again. Place it via \`apply_composition\` as an \`alpha-layer\` clip \u2014 the shared renderer never runs your code (it bakes to transparent video first).
+CUSTOM GRAPHICS \u2014 author or FORK: \`create_component\` (tsxSource) from scratch, or \`get_component_source\` on a built-in primitive (e.g. \`cinematic-title\`) to fork its editable module. Iterate author\u2192preview\u2192fix with \`preview_component\` (202 + jobId; \`wait_job(kind:"preview")\` returns a PNG image for \`executionMode:"live"\` or a VP9 motion URL for \`executionMode:"baked"\`; a compile failure lands on the job's FAILED terminal carrying the sanitized compiler error) \u2192 fix via \`update_component\` \u2192 preview again. Place baked components via \`apply_composition\` as an \`alpha-layer\` clip \u2014 the shared renderer never runs authored source code (it composites the transparent baked video).
 
 Cleanup: \`delete_project\` / \`delete_media\` / \`delete_webhook\` / \`delete_composition\`. \`list_projects\` re-orients you in an existing workspace; \`list_media\` (filter by \`source\`/\`tag\`) lists the library.
 
@@ -436,12 +436,16 @@ function registerCuratedTools(server, ex, opts) {
     for (const friendly of Object.keys(spec.pathArgs ?? {})) {
       inputSchema[friendly] = z.string().describe(`${friendly} (path).`);
     }
+    for (const [queryArg, description] of Object.entries(spec.queryArgs ?? {})) {
+      inputSchema[queryArg] = z.string().optional().describe(description);
+    }
     const bodySchema = bodySchemaFor(op);
     if (bodySchema) inputSchema.body = bodySchema;
     const annotations = { ...op.annotations, ...spec.annotations };
     server.registerTool(spec.name, { title: spec.title ?? titleCase(spec.name), description: spec.description, inputSchema, annotations }, async (args, extra) => timed(opts?.onEvent, spec.name, async (report) => {
       const a = args;
       try {
+        const query = Object.keys(spec.queryArgs ?? {}).filter((name) => a[name] !== void 0 && a[name] !== null && a[name] !== "").map((name) => `${encodeURIComponent(name)}=${encodeURIComponent(String(a[name]))}`).join("&");
         return await dispatchOp(ex, op, (p) => a[reverse[p]], a.body, extra, spec.name, async (res) => {
           if (spec.okText) return text(spec.okText(a));
           const json = res.text ? safeParse(res.text) : void 0;
@@ -454,17 +458,17 @@ function registerCuratedTools(server, ex, opts) {
             if (data.length) return withMedia(payload, data.map((d) => ({ data: d, kind })));
           }
           return text(payload);
-        });
+        }, query || void 0);
       } catch (err) {
         return errText(`${spec.name} failed: ${fmtErr(err)}`);
       }
     }));
   }
   registerWaitJob(server, ex, opts?.waitCapMs, opts?.onEvent);
-  registerPreviewCard(server, ex, opts?.onEvent);
+  registerPreviewCard(server, ex, opts?.waitCapMs, opts?.onEvent);
 }
-function registerPreviewCard(server, ex, onEvent) {
-  const op = opById("previewFrame");
+function registerPreviewCard(server, ex, waitCapMs, onEvent) {
+  const op = opById("previewFrameJob");
   server.registerTool(
     "preview_card",
     {
@@ -508,12 +512,19 @@ function registerPreviewCard(server, ex, onEvent) {
           "preview_card",
           async (res) => {
             const json = res.text ? safeParse(res.text) : void 0;
-            const urls = (Array.isArray(json?.stills) ? json.stills : []).map(
-              (st) => st?.url
-            );
+            const jobId = json?.jobId;
+            if (typeof jobId !== "string" || !jobId) {
+              return errText("preview_card enqueue returned no jobId");
+            }
+            const waitMs = Math.min(waitCapMs ?? 3e4, 3e4);
+            const done = await waitForJob(ex, "preview_frame", jobId, void 0, Date.now() + waitMs);
+            if (!done.ok) return errText(done.text);
+            if (done.stillRunning) return text(`${done.text}
+jobId: ${jobId}`);
+            const urls = done.mediaUrls ?? [];
             const data = await fetchPreviews(urls, 2);
             report({ preview: { urls: urls.filter(Boolean).length, fetched: data.length } });
-            const payload = res.text || `previewed card (${a.aspectRatio ?? "9:16"})`;
+            const payload = done.text || `previewed card (${a.aspectRatio ?? "9:16"})`;
             return data.length ? withMedia(payload, data.map((d) => ({ data: d, kind: "image" }))) : text(payload);
           }
         );
@@ -529,10 +540,10 @@ function registerWaitJob(server, ex, waitCapMs, onEvent) {
     {
       title: "Wait for Job",
       annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
-      description: "Wait for a long-running job and return the resolved result \u2014 a BOUNDED long-poll. Polls the job status (render / compose / consult / clip-suggestions / verify) and blocks up to the transport window (30s on the hosted transport); if the job is still running at the window it returns a `Still running` continuation \u2014 call wait_job again with the same arguments to keep waiting (the job keeps executing server-side; nothing is lost between calls). Call this right after compose / create_render / consult / suggest_briefs / score_composition / preview_component. For event-driven fan-out, create_webhook delivers the terminal instead.",
+      description: "Wait for a long-running job and return the resolved result \u2014 a BOUNDED long-poll. Polls job status (media import/generation / render / compose / consult / clip-suggestions / verify / preview-frame) and blocks up to the transport window (30s on the hosted transport); if still running, it returns a continuation \u2014 call wait_job again with the same arguments (the job keeps executing server-side). Call this after import_media / generate_media / finalize_upload / import_resource / compose / create_render / consult / suggest_briefs / score_composition / preview_frame / preview_component. For event-driven fan-out, create_webhook delivers the terminal instead.",
       inputSchema: {
-        kind: z.enum(["render", "suggestions", "compose", "verify", "preview", "brand_kit_extract", "consult"]).describe("What to wait on: a render job, a compose job, a consult advisory, AI clip-suggestion analysis, or a generic async job (verify / preview / brand-kit extract \u2014 the kind is named in the enqueue receipt)."),
-        id: z.string().describe('kind="render": renderId. kind="compose": composeJobId. kind="consult": the consultJobId from the consult receipt (surfaces the advisory envelope \u2014 assessment, proposals, principles). kind="suggestions": mediaItemId. kind="verify"/"preview"/"brand_kit_extract": the jobId from the enqueue receipt.'),
+        kind: z.enum(["media", "render", "suggestions", "compose", "verify", "preview_frame", "preview", "brand_kit_extract", "consult"]).describe("What to wait on: media ingest/generation, render, compose, consult, clip-suggestion analysis, or a generic async job (verify / preview_frame / preview / brand-kit extract \u2014 use the enqueue receipt kind)."),
+        id: z.string().describe('kind="media": mediaItemId returned by import/generate/finalize/import_resource. kind="render": renderId. kind="compose": composeJobId. kind="consult": consultJobId. kind="suggestions": mediaItemId. Generic kinds use the jobId from the enqueue receipt.'),
         projectId: z.string().optional().describe('Required when kind="render", "compose", or "consult".'),
         timeoutMs: z.number().int().min(1e3).max(30 * 60 * 1e3).optional().describe("Maximum wait in ms (default 30 min for render/compose, 5 min for suggestions).")
       }
@@ -542,7 +553,7 @@ function registerWaitJob(server, ex, waitCapMs, onEvent) {
       if ((kind === "render" || kind === "compose" || kind === "consult") && !args.projectId) {
         return errText(`wait_job(kind="${kind}") requires a projectId.`);
       }
-      const defaultCap = kind === "suggestions" ? 5 * 60 * 1e3 : 30 * 60 * 1e3;
+      const defaultCap = kind === "suggestions" || kind === "media" ? 5 * 60 * 1e3 : 30 * 60 * 1e3;
       const requested = args.timeoutMs ?? defaultCap;
       const deadline = Date.now() + (waitCapMs ? Math.min(requested, waitCapMs) : requested);
       const res = await waitForJob(ex, kind, args.id, args.projectId, deadline);

package/dist/{chunk-VHF66LCQ.js → chunk-NQSMEUJ6.js}

@@ -20,7 +20,7 @@ import {
   scoreAndRank,
   segmentShots,
   stabilizeSelectionHysteresis
-} from "./chunk-XQ72DZKJ.js";
+} from "./chunk-ZPRBGW4Y.js";
 import {
   flattenCompoundClips,
   hasCompoundClips
@@ -36,7 +36,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-LLUW26BS.js";
+} from "./chunk-AW57IWNW.js";
 
 // ../execution/core/src/render/emphasis.ts
 function buildEmphasisSet(emphasisWords) {

package/dist/{chunk-QETYXKQQ.js → chunk-SDCEJAO2.js}

@@ -5,7 +5,7 @@ import {
   isOk,
   opById,
   safeParse
-} from "./chunk-W3SIWT7J.js";
+} from "./chunk-DL7WYISQ.js";
 
 // ../mcp/src/wait.ts
 var defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));
@@ -14,7 +14,47 @@ var DEFAULT_POLL_MS = 3e3;
 function fmtTime(sec) {
   return `${Math.floor(sec / 60)}:${String(Math.floor(sec % 60)).padStart(2, "0")}`;
 }
+function describeProgress(json, nowMs) {
+  const status = json?.processingStatus?.phase ?? json?.status;
+  const phase = json?.progress?.phase;
+  const percent = json?.processingStatus?.percent ?? json?.progress?.percent;
+  const updatedAt = json?.updatedAt ?? json?.progress?.updatedAt;
+  const parts = [];
+  if (typeof status === "string" && status) parts.push(`Last status: ${status}`);
+  if (typeof phase === "string" && phase && phase !== status) parts.push(`phase: ${phase}`);
+  if (typeof percent === "number" && Number.isFinite(percent)) parts.push(`progress: ${percent}%`);
+  if (typeof updatedAt === "string" && updatedAt) {
+    parts.push(`updatedAt: ${updatedAt}`);
+    const parsed = Date.parse(updatedAt);
+    if (Number.isFinite(parsed) && nowMs >= parsed) {
+      const staleSec = Math.floor((nowMs - parsed) / 1e3);
+      if (staleSec >= 60) parts.push(`unchanged for ~${fmtTime(staleSec)}`);
+    }
+  }
+  return parts.join("; ");
+}
 var KINDS = {
+  media: {
+    operationId: "getMedia",
+    mapArg: (_p, id) => id,
+    terminal: (j) => {
+      const phase = String(j?.processingStatus?.phase ?? j?.status ?? "");
+      if (phase === "complete" || phase === "completed" || phase === "ready") {
+        const lines = ["Media ready."];
+        if (j?.id) lines.push(`Media ID: ${j.id}`);
+        if (j?.name) lines.push(`Name: ${j.name}`);
+        if (typeof j?.duration === "number") lines.push(`Duration: ${j.duration.toFixed(2)}s`);
+        if (j?.mimeType) lines.push(`Type: ${j.mimeType}`);
+        lines.push("\nUse this media ID with get_media_context, suggest_briefs, or as a composition source.");
+        return { ok: true, text: lines.join("\n") };
+      }
+      if (phase === "error" || phase === "failed" || phase === "cancelled") {
+        const cause = j?.processingStatus?.error ?? j?.processingStatus?.message ?? j?.error ?? "";
+        return { ok: false, text: `Media ${phase}${cause ? `: ${typeof cause === "string" ? cause : JSON.stringify(cause)}` : ""}.` };
+      }
+      return null;
+    }
+  },
   render: {
     operationId: "getRender",
     mapArg: (p, id, projectId) => p === "renderId" ? id : projectId,
@@ -33,9 +73,15 @@ Download URL: ${url}`);
         const lines = [`Render ${s}${cause ? `: ${cause}` : ""}.`];
         if (j?.errorCode) lines.push(`Code: ${j.errorCode}${j?.category ? ` (${j.category})` : ""}`);
         if (typeof j?.retryable === "boolean") {
-          lines.push(
-            j.retryable ? "retryable: true \u2014 transient pipeline failure; call retry_render to re-attempt." : `retryable: false \u2014 deterministic defect${j?.category ? ` (category ${j.category})` : ""}; fix the composition before re-rendering \u2014 retry_render alone will not help.`
-          );
+          if (j?.category === "internal") {
+            lines.push(
+              `retryable: ${j.retryable} \u2014 Cueframe reported an INTERNAL pipeline defect. The composition has not been proven invalid; do not mutate it to work around this failure. Correlate the renderId/requestId in Axiom or Sentry and fix the failing pipeline stage.`
+            );
+          } else {
+            lines.push(
+              j.retryable ? "retryable: true \u2014 transient pipeline failure; call retry_render to re-attempt." : `retryable: false \u2014 deterministic defect${j?.category ? ` (category ${j.category})` : ""}; fix the composition before re-rendering \u2014 retry_render alone will not help.`
+            );
+          }
         }
         return { ok: false, text: lines.join("\n") };
       }
@@ -219,7 +265,35 @@ Worst-first critique: ${r.critique}`);
         lines.push("\nFix the lowest criterion via apply_composition, then re-verify.");
         return { ok: true, text: lines.join("\n") };
       }
-      if (s === "failed") return jobFailedResult("Verify", "score_composition", j);
+      if (s === "failed" || s === "cancelled") return jobFailedResult("Verify", "score_composition", j);
+      return null;
+    }
+  },
+  preview_frame: {
+    operationId: "getJob",
+    mapArg: (_p, id) => id,
+    terminal: (j) => {
+      const status = String(j?.status ?? "");
+      if (status === "succeeded") {
+        const result = j?.result ?? {};
+        const artifacts = Array.isArray(result.artifacts) ? result.artifacts : [];
+        const urls = artifacts.map((artifact) => artifact.url).filter((url) => typeof url === "string" && url.length > 0);
+        const lines = [`Preview-frame complete: ${artifacts.length} artifact(s).`];
+        for (const artifact of artifacts) {
+          lines.push(
+            `- ${typeof artifact.beatSec === "number" ? `${artifact.beatSec.toFixed(2)}s` : artifact.id ?? "frame"}${artifact.url ? ` \u2014 ${artifact.url}` : " \u2014 missing presigned URL"}`
+          );
+        }
+        lines.push(`
+Snapshot provenance: ${JSON.stringify(result.previewed ?? {})}`);
+        lines.push(`Geometry: ${JSON.stringify(result.geometry ?? {})}`);
+        if (result.warnings?.length) lines.push(`Warnings: ${JSON.stringify(result.warnings)}`);
+        lines.push("\nThe images ride with this result; judge the pixels and use layers/geometry as evidence.");
+        return { ok: urls.length === artifacts.length && artifacts.length > 0, text: lines.join("\n"), mediaUrls: urls };
+      }
+      if (status === "failed" || status === "cancelled") {
+        return jobFailedResult("Preview-frame", "preview_frame", j);
+      }
       return null;
     }
   },
@@ -230,18 +304,23 @@ Worst-first critique: ${r.critique}`);
       const s = String(j?.status ?? "");
       if (s === "succeeded") {
         const r = j?.result ?? {};
+        const isImage = r.artifactKind === "image" || r.contentType?.startsWith("image/") === true || !r.artifactKind && !r.contentType && /\.(?:png|jpe?g|webp)(?:\?|$)/i.test(r.url ?? "");
+        const label = isImage ? "Image" : r.artifactKind === "motion" ? "Motion clip" : "Artifact";
         return {
           ok: true,
-          mediaUrls: r.url ? [r.url] : void 0,
+          // MCP image blocks are image-only. Motion remains a truthful URL;
+          // attaching WebM bytes as an image corrupts the model-facing media type.
+          mediaUrls: r.url && isImage ? [r.url] : void 0,
           text: r.url ? `Preview ready.
 
-Clip: ${r.url}${r.urlExpiresAt ? `
+${label}: ${r.url}${r.contentType ? `
+Content-Type: ${r.contentType}` : ""}${r.urlExpiresAt ? `
 (link valid until ${r.urlExpiresAt})` : ""}
 
 Inspect it, fix the component via create_component if needed, and re-preview.` : "Preview succeeded but returned no url \u2014 inspect GET /v1/jobs for the raw result."
         };
       }
-      if (s === "failed") return jobFailedResult("Preview", "preview_component", j);
+      if (s === "failed" || s === "cancelled") return jobFailedResult("Preview", "preview_component", j);
       return null;
     }
   },
@@ -270,10 +349,14 @@ Review the tokens, then create_brand_kit to persist a kit. (0 tokens usually mea
   }
 };
 function jobFailedResult(label, reEnqueueTool, j) {
-  const code = String(j?.error?.code ?? "unknown");
+  const cancelled = j?.status === "cancelled";
+  const code = String(j?.error?.code ?? (cancelled ? "cancelled" : "unknown"));
   const msg = typeof j?.error?.message === "string" ? j.error.message : "";
-  const retryHint = code === "job_timeout" ? ` The executor died mid-run and the stall sweep reaped the job \u2014 re-enqueue ${reEnqueueTool} to retry.` : "";
-  return { ok: false, text: `${label} failed (${code})${msg ? `: ${msg}` : ""}.${retryHint}` };
+  const retryHint = code === "job_timeout" ? ` The executor died mid-run and the stall sweep reaped the job \u2014 inspect this jobId in Axiom/Sentry before retrying; re-enqueue ${reEnqueueTool} only after the failing pipeline stage is healthy.` : "";
+  return {
+    ok: false,
+    text: `${label} ${cancelled ? "cancelled" : "failed"} (${code})${msg ? `: ${msg}` : ""}.${retryHint}`
+  };
 }
 async function waitForJob(ex, kind, id, projectId, deadline, deps = {}) {
   const sleep = deps.sleep ?? defaultSleep;
@@ -281,7 +364,7 @@ async function waitForJob(ex, kind, id, projectId, deadline, deps = {}) {
   const pollMs = deps.pollMs ?? DEFAULT_POLL_MS;
   const cfg = KINDS[kind];
   const op = opById(cfg.operationId);
-  let lastStatus = "";
+  let lastProgress = "";
   const INVOKE_BUDGET_MS = deps.invokeBudgetMs ?? 2e3;
   let firstPoll = true;
   while (firstPoll || now() + INVOKE_BUDGET_MS < deadline) {
@@ -300,12 +383,12 @@ async function waitForJob(ex, kind, id, projectId, deadline, deps = {}) {
       const json = safeParse(res.text);
       const t = cfg.terminal(json);
       if (t) return t;
-      if (json && typeof json.status === "string") lastStatus = json.status;
+      lastProgress = describeProgress(json, now());
     }
     if (now() + pollMs + INVOKE_BUDGET_MS >= deadline) break;
     await sleep(pollMs);
   }
-  const tail = lastStatus ? ` Last status: ${lastStatus}.` : "";
+  const tail = lastProgress ? ` ${lastProgress}.` : "";
   return {
     ok: true,
     stillRunning: true,

package/dist/{chunk-LJ5W4ZBU.js → chunk-TMB5AY6Q.js}

@@ -1,7 +1,7 @@
 import {
   ChatErrorView,
   DirectorTurnContext
-} from "./chunk-ZPLJ24OV.js";
+} from "./chunk-TO4BFNLJ.js";
 import {
   GenerationArtifact
 } from "./chunk-73DQTUWY.js";

package/dist/{chunk-ZPLJ24OV.js → chunk-TO4BFNLJ.js}

@@ -9,7 +9,7 @@ import {
 import {
   decodeError,
   scrubSensitive
-} from "./chunk-LLUW26BS.js";
+} from "./chunk-AW57IWNW.js";
 
 // ../director/src/domain/chat.ts
 import { z } from "zod";

package/dist/{chunk-VFMW3JUY.js → chunk-TXSFYUZH.js}

@@ -1,6 +1,6 @@
 import {
   resolveBookendTimeline
-} from "./chunk-VHF66LCQ.js";
+} from "./chunk-NQSMEUJ6.js";
 
 // ../execution/compose/src/tokenResolver.ts
 var DEFAULTS = {

package/dist/{chunk-XQ72DZKJ.js → chunk-ZPRBGW4Y.js}

@@ -1,7 +1,7 @@
 import {
   CueframeError,
   encodeError
-} from "./chunk-LLUW26BS.js";
+} from "./chunk-AW57IWNW.js";
 
 // ../execution/core/src/render/vcam/constants.ts
 var P_MIN = 0.5;

package/dist/compose/renderer.js

@@ -1,6 +1,6 @@
 import {
   resolvePrimitive
-} from "../chunk-CAJQ7H5A.js";
+} from "../chunk-HBVAZXYO.js";
 import "../chunk-H5LMJKZU.js";
 import "../chunk-MFHXCHRI.js";
 import "../chunk-JQMPHKLU.js";
@@ -33,7 +33,7 @@ import "../chunk-JF4JJAFP.js";
 import {
   CueframeError,
   encodeError
-} from "../chunk-LLUW26BS.js";
+} from "../chunk-AW57IWNW.js";
 import "../chunk-2ESYSVXG.js";
 
 // ../execution/compose/src/CompositionRenderer.tsx

package/dist/compose.js

@@ -1,7 +1,7 @@
 import {
   resolveTokens,
   sceneToRenderInput
-} from "./chunk-VFMW3JUY.js";
+} from "./chunk-TXSFYUZH.js";
 import {
   allCatalogs,
   getPrimitiveSubtext,
@@ -13,7 +13,7 @@ import {
   resetPrimitiveOverrides,
   resolvePrimitive,
   resolveTransitionPresentation
-} from "./chunk-CAJQ7H5A.js";
+} from "./chunk-HBVAZXYO.js";
 import "./chunk-H5LMJKZU.js";
 import "./chunk-MFHXCHRI.js";
 import "./chunk-JQMPHKLU.js";
@@ -42,9 +42,9 @@ import {
   getPrimitiveTextParam,
   listPrimitivesByCategory
 } from "./chunk-DCVJWGIA.js";
-import "./chunk-VHF66LCQ.js";
+import "./chunk-NQSMEUJ6.js";
 import "./chunk-QH3YI3ND.js";
-import "./chunk-XQ72DZKJ.js";
+import "./chunk-ZPRBGW4Y.js";
 import "./chunk-23HFEKV7.js";
 import "./chunk-VZ7TYX6Z.js";
 import "./chunk-7PA7FGLD.js";
@@ -52,7 +52,7 @@ import "./chunk-KYRDKK2D.js";
 import "./chunk-JF4JJAFP.js";
 import "./chunk-DENF4TPI.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-LLUW26BS.js";
+import "./chunk-AW57IWNW.js";
 import "./chunk-2ESYSVXG.js";
 export {
   allCatalogs,

package/dist/composition/projection.js

@@ -30,7 +30,7 @@ import {
   silhouetteKeepOutForWindow,
   sourceRectToOutput,
   sourceWindowKey
-} from "../chunk-PIURX6IZ.js";
+} from "../chunk-GIA2SVVB.js";
 import {
   BRAND_TOKEN_REFS,
   BRAND_TOKEN_ROOT_KEYS,
@@ -71,7 +71,7 @@ import {
   apcaLc
 } from "../chunk-DSMLHYJ4.js";
 import "../chunk-JF4JJAFP.js";
-import "../chunk-LLUW26BS.js";
+import "../chunk-AW57IWNW.js";
 import "../chunk-2ESYSVXG.js";
 export {
   BEHIND_BAND,

package/dist/composition-ops.js

@@ -6,9 +6,9 @@ import {
 } from "./chunk-ICSZF37W.js";
 import {
   playableSpans
-} from "./chunk-VHF66LCQ.js";
+} from "./chunk-NQSMEUJ6.js";
 import "./chunk-QH3YI3ND.js";
-import "./chunk-XQ72DZKJ.js";
+import "./chunk-ZPRBGW4Y.js";
 import "./chunk-23HFEKV7.js";
 import "./chunk-VZ7TYX6Z.js";
 import "./chunk-7PA7FGLD.js";
@@ -30,7 +30,7 @@ import {
 } from "./chunk-2B5VJZHL.js";
 import "./chunk-DENF4TPI.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-LLUW26BS.js";
+import "./chunk-AW57IWNW.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../composition-ops/src/index.ts

package/dist/composition.js

@@ -44,7 +44,7 @@ import {
   silhouetteKeepOutForWindow,
   sourceRectToOutput,
   sourceWindowKey
-} from "./chunk-PIURX6IZ.js";
+} from "./chunk-GIA2SVVB.js";
 import {
   BRAND_TOKEN_REFS,
   BRAND_TOKEN_ROOT_KEYS,
@@ -190,7 +190,7 @@ import {
   isSourceKindCompatible
 } from "./chunk-DENF4TPI.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-LLUW26BS.js";
+import "./chunk-AW57IWNW.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../composition/src/color-grade.ts

package/dist/core/render.js

@@ -42,20 +42,20 @@ import {
   sliceTranscriptWords,
   splitIntoSentences,
   validateComposition
-} from "../chunk-VHF66LCQ.js";
+} from "../chunk-NQSMEUJ6.js";
 import {
   buildEasedZooms,
   buildPannedCenters,
   easeOutCubic
 } from "../chunk-QH3YI3ND.js";
-import "../chunk-XQ72DZKJ.js";
+import "../chunk-ZPRBGW4Y.js";
 import "../chunk-23HFEKV7.js";
 import "../chunk-VZ7TYX6Z.js";
 import "../chunk-7PA7FGLD.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-DENF4TPI.js";
 import "../chunk-WREYUH2E.js";
-import "../chunk-LLUW26BS.js";
+import "../chunk-AW57IWNW.js";
 import "../chunk-2ESYSVXG.js";
 export {
   CARD_BOOKEND_DEFAULT_MS,

package/dist/core/select.js

@@ -7,8 +7,8 @@ import {
   stabilizeIncumbentChallenger,
   stabilizePresenceGate,
   stabilizeSelectionHysteresis
-} from "../chunk-XQ72DZKJ.js";
-import "../chunk-LLUW26BS.js";
+} from "../chunk-ZPRBGW4Y.js";
+import "../chunk-AW57IWNW.js";
 import "../chunk-2ESYSVXG.js";
 
 // ../execution/core/src/select/errorCodes.ts

package/dist/core.js

@@ -10,16 +10,16 @@ import {
   ensureEven,
   extractCaptionWordsFromDoc,
   isEmphasized
-} from "./chunk-VHF66LCQ.js";
+} from "./chunk-NQSMEUJ6.js";
 import "./chunk-QH3YI3ND.js";
-import "./chunk-XQ72DZKJ.js";
+import "./chunk-ZPRBGW4Y.js";
 import "./chunk-23HFEKV7.js";
 import "./chunk-VZ7TYX6Z.js";
 import "./chunk-7PA7FGLD.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-DENF4TPI.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-LLUW26BS.js";
+import "./chunk-AW57IWNW.js";
 import "./chunk-2ESYSVXG.js";
 export {
   DEFAULT_FPS,

package/dist/director/ai-sdk.js

@@ -10,13 +10,13 @@ import {
   dataChunk,
   generationArtifactFromToolResult,
   projectDirectorHistory
-} from "../chunk-LJ5W4ZBU.js";
-import "../chunk-ZPLJ24OV.js";
+} from "../chunk-TMB5AY6Q.js";
+import "../chunk-TO4BFNLJ.js";
 import "../chunk-73DQTUWY.js";
 import "../chunk-BADZHXLR.js";
 import "../chunk-U3JPILZS.js";
 import "../chunk-XELS2BGA.js";
-import "../chunk-LLUW26BS.js";
+import "../chunk-AW57IWNW.js";
 import "../chunk-2ESYSVXG.js";
 export {
   CueFrameIteration,

package/dist/director/domain.js

@@ -9,7 +9,7 @@ import {
   ProjectRef,
   chatErrorViewFromEnvelope,
   chatErrorViewFromUnknown
-} from "../chunk-ZPLJ24OV.js";
+} from "../chunk-TO4BFNLJ.js";
 import {
   ClientRequestId,
   GenerateMediaCommand,
@@ -31,7 +31,7 @@ import {
 import "../chunk-BADZHXLR.js";
 import "../chunk-U3JPILZS.js";
 import "../chunk-XELS2BGA.js";
-import "../chunk-LLUW26BS.js";
+import "../chunk-AW57IWNW.js";
 import "../chunk-2ESYSVXG.js";
 export {
   ChatErrorView,