@cueframe/kernel 0.1.2 → 0.1.4

package/dist/{chunk-QETYXKQQ.js → chunk-7V3F5HO4.js}

@@ -5,7 +5,7 @@ import {
   isOk,
   opById,
   safeParse
-} from "./chunk-W3SIWT7J.js";
+} from "./chunk-RQ2G4DXI.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-BZZTVOGG.js → chunk-D2EGO543.js}

@@ -4,16 +4,16 @@ import {
 import {
   getPrimitiveSubtextParam,
   getPrimitiveTextParam
-} from "./chunk-DCVJWGIA.js";
+} from "./chunk-JY26PIRP.js";
 import {
   selectAllOverlays
-} from "./chunk-ICSZF37W.js";
+} from "./chunk-JRIPQ7DN.js";
 import {
   ComposePlan
-} from "./chunk-TFGKUWHY.js";
+} from "./chunk-JTVFIN6H.js";
 import {
   OverlayClipSource
-} from "./chunk-WZH57M53.js";
+} from "./chunk-2SNY75AR.js";
 
 // ../authoring/src/tools/toolSets.ts
 var COMPOSE_PLANNER_TOOLS = [
@@ -63,7 +63,7 @@ var COMPOSE_ROLE_TOOLS = Object.freeze({
     schema: z.object({}),
     metadata: { label: "Get Context" },
     handler: async (_args, capabilities) => {
-      const { buildDirectorContext } = await import("./context-JLLU3MYD.js");
+      const { buildDirectorContext } = await import("./context-XWNT6QZH.js");
       return buildDirectorContext(capabilities);
     }
   },

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

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

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-ICSZF37W.js → chunk-JRIPQ7DN.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-KYRDKK2D.js";
 import {
   Composition
-} from "./chunk-WZH57M53.js";
+} from "./chunk-2SNY75AR.js";
 
 // ../composition/src/ops/compositionOps.shared.ts
 function findOrCreateTrackByKind(composition, kind) {

package/dist/{chunk-TFGKUWHY.js → chunk-JTVFIN6H.js}

@@ -2,8 +2,9 @@ import {
   Composition,
   Copy,
   Format,
-  GraphicRole
-} from "./chunk-WZH57M53.js";
+  GraphicRole,
+  OpaqueId
+} from "./chunk-2SNY75AR.js";
 
 // ../composition/src/validators/composePlan.ts
 import { z } from "zod";
@@ -77,7 +78,6 @@ var ComposePlan = z.object({
 
 // ../composition/src/validators/brandKit.ts
 import { z as z2 } from "zod";
-import { zid } from "convex-helpers/server/zod3";
 var EasingValue = z2.union([
   z2.enum(["linear", "ease", "ease-in", "ease-out", "ease-in-out"]),
   z2.object({
@@ -101,7 +101,7 @@ var FontRef = z2.union([
   }),
   z2.object({
     kind: z2.literal("uploaded"),
-    fontId: zid("fonts"),
+    fontId: OpaqueId,
     family: z2.string().optional()
   })
 ]);
@@ -331,7 +331,6 @@ var Font = z3.object({
 
 // ../composition/src/validators/render.ts
 import { z as z4 } from "zod";
-import { zid as zid2 } from "convex-helpers/server/zod3";
 var RenderPriority = z4.enum(["interactive", "standard", "background"]);
 var RenderIntent = z4.enum(["preview", "final"]);
 var RenderMode = z4.enum(["offline", "live"]);
@@ -362,7 +361,7 @@ var RegistryPin = z4.object({
   version: z4.string().min(1)
 });
 var MediaSourceSnapshot = z4.object({
-  mediaId: zid2("mediaItems"),
+  mediaId: OpaqueId,
   presignedUrl: z4.string().url(),
   expiresAt: z4.number().optional()
 });
@@ -425,9 +424,9 @@ var DestinationResult = z4.object({
   error: z4.string().optional()
 });
 var RenderJob = z4.object({
-  id: zid2("renderJobs"),
-  projectId: zid2("projects").optional(),
-  compositionId: zid2("compositions"),
+  id: OpaqueId,
+  projectId: OpaqueId.optional(),
+  compositionId: OpaqueId,
   compositionVersionId: z4.string().min(1),
   status: RenderStatus,
   progress: RenderProgressPhase.optional(),
@@ -452,7 +451,7 @@ var RenderJob = z4.object({
   updatedAt: z4.number()
 });
 var RenderProgress = z4.object({
-  jobId: zid2("renderJobs"),
+  jobId: OpaqueId,
   status: RenderStatus,
   percent: z4.number().min(0).max(100).optional(),
   framesRendered: z4.number().int().nonnegative().optional(),
@@ -504,13 +503,12 @@ var PrimitiveRegistryEntry = z5.object({
 
 // ../composition/src/validators/project.ts
 import { z as z6 } from "zod";
-import { zid as zid3 } from "convex-helpers/server/zod3";
 var Project = z6.object({
-  id: zid3("projects"),
+  id: OpaqueId,
   name: z6.string().min(1),
   defaultFormat: Format.optional(),
   palConformDefault: z6.union([z6.literal(24), z6.literal(30)]).optional(),
-  activeCompositionId: zid3("compositions").nullable().optional(),
+  activeCompositionId: OpaqueId.nullable().optional(),
   brandKitId: z6.string().optional(),
   ownerOrgId: z6.string().optional(),
   createdAt: z6.number(),
@@ -519,7 +517,6 @@ var Project = z6.object({
 
 // ../composition/src/validators/session.ts
 import { z as z7 } from "zod";
-import { zid as zid4 } from "convex-helpers/server/zod3";
 var SessionMediaRole = z7.enum([
   "main",
   "wide",
@@ -528,7 +525,7 @@ var SessionMediaRole = z7.enum([
   "audio"
 ]);
 var SessionMember = z7.object({
-  mediaId: zid4("mediaItems"),
+  mediaId: OpaqueId,
   role: SessionMediaRole,
   label: z7.string().optional()
   // human-readable annotation, e.g., "host's camera"
@@ -538,7 +535,7 @@ var SessionMux = z7.object({
   audioRole: z7.literal("audio")
 });
 var Session = z7.object({
-  id: zid4("sessions"),
+  id: OpaqueId,
   name: z7.string().min(1),
   members: z7.array(SessionMember).nonempty(),
   mux: z7.array(SessionMux).optional(),
@@ -549,7 +546,6 @@ var Session = z7.object({
 
 // ../composition/src/validators/webhook.ts
 import { z as z8 } from "zod";
-import { zid as zid5 } from "convex-helpers/server/zod3";
 var SubstrateWebhookEvent = z8.enum([
   "render.completed",
   "media.transcribed",
@@ -565,7 +561,7 @@ var WebhookDeliveryStatus = z8.enum([
   // retry budget burned through
 ]);
 var Webhook = z8.object({
-  id: zid5("webhooks"),
+  id: OpaqueId,
   url: z8.string().url(),
   events: z8.array(z8.string().min(1)).nonempty(),
   signingKeyId: z8.string().optional(),
@@ -577,7 +573,7 @@ var Webhook = z8.object({
 });
 var WebhookDelivery = z8.object({
   id: z8.string().min(1),
-  webhookId: zid5("webhooks"),
+  webhookId: OpaqueId,
   event: z8.string().min(1),
   payload: z8.record(z8.string(), z8.unknown()),
   status: WebhookDeliveryStatus,

package/dist/{chunk-DCVJWGIA.js → chunk-JY26PIRP.js}

@@ -15221,8 +15221,8 @@ function resolution(h) {
 }
 function sceneFps(fps) {
   if (fps === void 0) return void 0;
-  if (fps === 24 || fps === 30 || fps === 60) return fps;
-  throw new Error(`sceneFormat: unsupported scene fps ${fps} (expected 24|30|60)`);
+  if (fps === 24 || fps === 25 || fps === 30 || fps === 60) return fps;
+  throw new Error(`sceneFormat: unsupported scene fps ${fps} (expected 24|25|30|60)`);
 }
 function sceneFormat(m) {
   if (m.kind !== "scene") return void 0;

package/dist/{chunk-DWLNPNC4.js → chunk-LSP4HN5N.js}

@@ -2,7 +2,7 @@ import {
   selectAllClips,
   selectAllOverlays,
   selectSceneMarkers
-} from "./chunk-ICSZF37W.js";
+} from "./chunk-JRIPQ7DN.js";
 
 // ../authoring/src/context/transcript.ts
 var MAX_TRANSCRIPT_CHARS = 6e4;