@cueframe/kernel 0.1.3 → 0.2.0

package/dist/{chunk-DJW3UGBH.js → chunk-ZN6P3KOJ.js}

@@ -3,6 +3,64 @@ function fmtClock(sec) {
   return `${Math.floor(sec / 60)}:${String(Math.floor(sec % 60)).padStart(2, "0")}`;
 }
 
+// ../mcp/src/mediaContextFormat.ts
+var CONTEXT_WINDOW_CAP = 6;
+var CONTEXT_FACE_CAP = 3;
+var CONTEXT_SAMPLE_WORDS = 24;
+function formatMediaContext(json) {
+  const lines = [];
+  const dims = json?.width && json?.height ? `${json.width}\xD7${json.height}` : "unknown dimensions";
+  const duration = typeof json?.durationSec === "number" ? fmtClock(json.durationSec) : "unknown duration";
+  lines.push(`Media ${json?.mediaId ?? "?"} \u2014 ${dims}, ${duration}`);
+  if (json?.thumbnail?.url) lines.push(`thumbnail: ${json.thumbnail.url}`);
+  const windows = Array.isArray(json?.faces?.windows) ? json.faces.windows : [];
+  lines.push(`faces: ${json?.faces?.status ?? "unknown"} (${windows.length} source window(s))`);
+  for (const window of windows.slice(0, CONTEXT_WINDOW_CAP)) {
+    const faces = Array.isArray(window?.faces) ? window.faces : [];
+    const roster = faces.slice(0, CONTEXT_FACE_CAP).map((face) => {
+      const bbox = face?.bbox ?? {};
+      const box = [bbox.x, bbox.y, bbox.width, bbox.height].every((value) => typeof value === "number") ? ` bbox:${[bbox.x, bbox.y, bbox.width, bbox.height].map((n) => n.toFixed(3)).join(",")}` : "";
+      const speaking = typeof face?.speakingShare === "number" ? ` speaking:${Math.round(face.speakingShare * 100)}%` : "";
+      return `${face?.faceId ?? "?"}${box}${speaking}`;
+    });
+    lines.push(`- ${window?.window?.startSec ?? "?"}\u2192${window?.window?.endSec ?? "?"}s: ${roster.join(" | ") || "no usable subjects"}`);
+  }
+  if (windows.length > CONTEXT_WINDOW_CAP) lines.push(`- \u2026 ${windows.length - CONTEXT_WINDOW_CAP} more face windows elided`);
+  const transcript = json?.transcript;
+  const utterances = Array.isArray(transcript?.data?.utterances) ? transcript.data.utterances : Array.isArray(transcript?.data?.data) ? transcript.data.data : [];
+  const words = utterances.flatMap((utterance) => Array.isArray(utterance?.words) ? utterance.words : []);
+  const sample = words.slice(0, CONTEXT_SAMPLE_WORDS).map((word) => {
+    const start = typeof word?.start === "number" ? `@${word.start.toFixed(2)}s` : "";
+    return `${word?.word ?? word?.text ?? ""}${start}`;
+  }).filter(Boolean);
+  lines.push(`transcript: ${transcript?.status ?? "unknown"} (${utterances.length} utterance(s), ${words.length} word(s))`);
+  if (sample.length) lines.push(`sample: ${sample.join(" ")}`);
+  if (transcript?.status === "ready") {
+    lines.push("Use get_transcript(mediaItemId, limit, after/before) for exact paginated word timings.");
+  }
+  if (json?.beatGrid) {
+    const beats = Array.isArray(json.beatGrid.beatTimesMs) ? json.beatGrid.beatTimesMs : [];
+    lines.push(`beatGrid: ${json.beatGrid.bpm ?? "?"} bpm, ${beats.length} beats, ${json.beatGrid.method ?? "?"}${beats.length ? `; first ms: ${beats.slice(0, 12).join(",")}` : ""}`);
+  } else lines.push("beatGrid: none");
+  const wordTimes = Array.isArray(json?.wordGrid?.wordTimesMs) ? json.wordGrid.wordTimesMs : [];
+  lines.push(`wordGrid: ${wordTimes.length} onsets${wordTimes.length ? `; first ms: ${wordTimes.slice(0, 12).join(",")}` : ""}`);
+  lines.push(`audio: role=${json?.audioRole ?? "none"} envelope=${json?.envelope?.envelopeClass ?? "none"}`);
+  const facts = Array.isArray(json?.facts) ? json.facts : [];
+  const offers = Array.isArray(json?.offers) ? json.offers : [];
+  lines.push(`facts: ${facts.map((fact) => `${fact?.kind ?? "?"}:${fact?.status ?? "?"}`).join(", ") || "none"}`);
+  lines.push(`offers: ${offers.map((offer) => `${offer?.kind ?? "?"}${offer?.quotedUsd != null ? `($${offer.quotedUsd})` : ""}`).join(", ") || "none"}`);
+  return lines.join("\n");
+}
+function formatTranscriptPage(json) {
+  const utterances = Array.isArray(json?.data) ? json.data : Array.isArray(json?.utterances) ? json.utterances : [];
+  return JSON.stringify({
+    mediaItemId: json?.mediaItemId,
+    language: json?.language,
+    utterances,
+    ...json?.pagination ? { pagination: json.pagination } : {}
+  }, null, 2);
+}
+
 // ../mcp/src/generated/catalogPreviews.ts
 var CATALOG_PREVIEWS = {
   "animated-bar-chart": "https://cdn.cueframe.ai/previews/animated-bar-chart@0.2.1.jpg",
@@ -112,7 +170,7 @@ ${lines.join("\n")}`;
 function formatComponentList(json) {
   const data = Array.isArray(json?.data) ? json.data : [];
   if (data.length === 0) {
-    return "No components match. Drop a filter, or browse unfiltered (list_catalog with no args returns the whole built-in catalog).";
+    return "No components match. Drop a filter, or browse the default first page with list_catalog().";
   }
   const lines = data.map((e) => {
     const facets = [e.category, e.kind, e.tier].filter(Boolean).join(" \xB7 ");
@@ -121,7 +179,10 @@ function formatComponentList(json) {
     const baked = Array.isArray(e.fixedCopy) && e.fixedCopy.length ? `  [bakes fixed copy]` : "";
     return `- ${e.id}  ${e.name} (${facets})${uc}${baked}${place}`;
   });
-  const more = json?.pagination?.hasMore ? "\n\n(more \u2014 pass `after` to page)" : "";
+  const nextCursor = json?.pagination?.nextCursor;
+  const more = json?.pagination?.hasMore && typeof nextCursor === "string" ? `
+
+(more \u2014 pass after=${JSON.stringify(nextCursor)})` : "";
   return `${data.length} component${data.length !== 1 ? "s" : ""} (recommended-tier first when filtered):
 
 ${lines.join("\n")}${more}`;
@@ -209,7 +270,10 @@ function formatComposition(json) {
   ];
   if (json?.captions) {
     const segs = json.captions.segments?.length ?? 0;
-    const words = json.captions.words?.length ?? 0;
+    const words = Array.isArray(json.captions.segments) ? json.captions.segments.reduce(
+      (total, segment) => total + (Array.isArray(segment?.words) ? segment.words.length : 0),
+      0
+    ) : 0;
     lines.push(`captions: ${segs} segment(s), ${words} word(s) [text elided]`);
   }
   if (Array.isArray(json?.markers) && json.markers.length) {
@@ -233,11 +297,10 @@ var CURATED_TOOLS = [
     name: "compose",
     operationId: "compose",
     pathArgs: { projectId: "id" },
-    description: 'Start the async Director compose workflow: it authors an ensemble of full composition candidates, verifies each, and saves the winner to the project. Body must set EXACTLY ONE source (mutually exclusive): `briefId` \u2014 author FROM a persisted Brief (the PLANNED path: create_brief first; every Brief field is honored or the compose is refused loudly naming the field); `fromComposition: true` \u2014 author from the project\'s CURRENT composition (the GENERAL path: seed it with apply_composition first \u2014 your media clips are the intent, and any graphics you authored are CARRIED VERBATIM as locked clips the Director authors around, never re-authors or drops); or `suggestionId` \u2014 author from an AI clip suggestion (the CLIPPING path, paired with suggest_briefs). Returns { composeJobId, workflowId, status, streamUrl }. Then call wait_job(kind="compose", id=composeJobId, projectId=...) to block until the winner is selected.',
-    okFormat: (j, a) => `Compose workflow started.
+    description: 'Start an async Director compose job: it authors an ensemble of full composition candidates, verifies each, and saves the winner to the project. Body must set EXACTLY ONE source (mutually exclusive): `briefId` \u2014 author FROM a persisted Brief (the PLANNED path: create_brief first; every Brief field is honored or the compose is refused loudly naming the field); `fromComposition: true` \u2014 author from the project\'s CURRENT composition (the GENERAL path: seed it with apply_composition first \u2014 your media clips are the intent, and any graphics you authored are CARRIED VERBATIM as locked clips the Director authors around, never re-authors or drops); or `suggestionId` \u2014 author from an AI clip suggestion (the CLIPPING path, paired with suggest_briefs). Returns { composeJobId, status, streamUrl }. Then call wait_job(kind="compose", id=composeJobId, projectId=...) to block until the winner is selected.',
+    okFormat: (j, a) => `Compose job started.
 
 composeJobId: ${j.composeJobId}
-workflowId: ${j.workflowId}
 status: ${j.status}${j.streamUrl ? `
 streamUrl: ${j.streamUrl}` : ""}
 
@@ -309,13 +372,13 @@ Call wait_job(kind="preview_frame", id="${j.jobId}") for the rendered images.`,
     name: "preview_component",
     operationId: "previewComponent",
     pathArgs: { projectId: "id" },
-    description: 'Queue a typed preview artifact for ONE org-installed component \u2014 ASYNC: returns a jobId immediately; then wait_job(kind="preview", id=jobId). Live components return artifactKind="image" with image/png or image/jpeg still evidence; baked components return artifactKind="motion" with the SAME content-addressed video/webm VP9-alpha object the production render composites. `body.componentId` selects the component; pass `body.params` to render it with props. Compile/runtime failures land on the job terminal with sanitized author-fixable messages. Idempotent per (componentId, params, dims).',
+    description: 'Queue a typed preview artifact for ONE org-installed component \u2014 ASYNC: returns a jobId immediately; then wait_job(kind="preview", id=jobId). The preview and production compositor consume the same content-addressed component bundle and verified artifact contract. `body.componentId` selects the component; pass `body.params` to render it with props. Compile/runtime/capability failures land on the job terminal with sanitized author-fixable messages. Idempotent per immutable render key.',
     okFormat: (j) => `Preview job queued.
 
 jobId: ${j.jobId}
 status: ${j.status}
 
-Call wait_job(kind="preview", id="${j.jobId}") for the typed preview artifact (live=image, baked=motion; re-call it if it returns still-running).`,
+Call wait_job(kind="preview", id="${j.jobId}") for the verified preview artifact; re-call it if it returns still-running.`,
     annotations: { idempotentHint: true }
   },
   {
@@ -373,10 +436,6 @@ Call wait_job(kind="verify", id="${j.jobId}") to block until the scores + checkp
     name: "list_briefs",
     operationId: "listBriefs",
     description: 'List briefs. DEFAULT shows human-authored briefs only; kind:"clip" shows the machine-minted clip briefs (suggest_briefs output), kind:"all" shows everything. Each carries its quote.',
-    queryArgs: {
-      projectId: "Scope to one project.",
-      kind: "'authored' (default) | 'clip' | 'all'."
-    },
     annotations: { readOnlyHint: true }
   },
   {
@@ -394,10 +453,6 @@ Call wait_job(kind="verify", id="${j.jobId}") to block until the scores + checkp
     name: "list_checkpoints",
     operationId: "listCheckpoints",
     description: "List checkpoint packets newest-first (filter with composeJobId for one run's v1\u2192vN gate history, or projectId). The version stack with per-version status + decisions IS the review history \u2014 nothing is deleted.",
-    queryArgs: {
-      composeJobId: "One compose run's gate history (v1\u2192vN).",
-      projectId: "Scope to one project."
-    },
     annotations: { readOnlyHint: true }
   },
   {
@@ -427,7 +482,8 @@ Call wait_job(kind="verify", id="${j.jobId}") to block until the scores + checkp
   {
     name: "list_catalog",
     operationId: "listCatalog",
-    description: "DISCOVER WHAT TO BUILD WITH \u2014 list the component catalog: the FULL built-in primitive catalog (text, effects, transitions, layouts, backgrounds, and scenes: lower-third, cinematic-title, color-grade, product-launch-trailer, \u2026) PLUS your org-installed components. Use it for UTILITY furniture (captions, grades, transitions, backgrounds, scenes) and as REFERENCE CODE (get_component_source) \u2014 for BRAND or text graphics, default to authoring your OWN `kind:'card'` clip (your HTML + tokens, poster-grade typography) shelled with `applyMotionPreset`; a catalog text primitive is the quick generic fallback, not the identity path. Narrow with filters: `category` (text|effects|transitions|layouts|backgrounds|ui-blocks|scenes), `kind` (component|transition|scene), `tier` (recommended|standard|niche), `useCase` (intro|outro|full-scene|title-over-footage|transition|background|grade|emphasis|explainer|social-cut), `mood`, or free-text `q`/`intent` (e.g. intent='intro'). When any filter is set, results are recommended-tier-first. With NO `limit` the whole filtered catalog returns in one page. Each entry carries a `placement` hint = exactly how to author it via apply_composition ({kind:'overlay'|'effect', primitiveId} for built-ins; {kind:'component', componentId} for installed), `tier`/`useCase` to pick by, and `fixedCopy` (on-screen strings it BAKES that no param changes \u2014 fork via get_component_source to edit). Read cueframe://component/{id} for the full prop schema.",
+    defaults: { limit: 20 },
+    description: "DISCOVER WHAT TO BUILD WITH \u2014 list the component catalog: the built-in primitive catalog plus your org-installed components. The agent-safe default page is 20 entries; use pagination.nextCursor as `after`, or narrow with category, kind, tier, useCase, mood, q, or intent. Results are recommended-tier-first when filtered. Each entry carries the exact placement hint for apply_composition and fixedCopy warnings; use get_component_source to fork a primitive when baked copy must change. Read cueframe://component/{id} for the full prop schema.",
     okFormat: (j) => formatComponentList(j),
     annotations: { readOnlyHint: true },
     preview: {
@@ -451,7 +507,16 @@ ${j.tsxSource}`,
     name: "get_media_context",
     operationId: "getMediaContext",
     pathArgs: { mediaItemId: "id" },
-    description: "Fetch the authoring context for a media item: detected faces (subject boxes per frame) and the transcript. Use this before composing/applying so your crop intents, captions, and timing line up with what is actually in the footage.",
+    description: "Fetch bounded authoring context for a media item: dimensions/thumbnail, compact face roster, transcript counts/sample, temporal grids, and fact readiness. The full transcript body is deliberately elided so this read cannot overflow MCP; follow with get_transcript for exact paginated word timings.",
+    okFormat: (j) => formatMediaContext(j),
+    annotations: { readOnlyHint: true }
+  },
+  {
+    name: "get_transcript",
+    operationId: "getMediaTranscript",
+    pathArgs: { mediaItemId: "id" },
+    description: "Read exact source-time transcript words in bounded utterance pages. Word start/end values are seconds from the source media start. Pass limit (20 recommended), then pagination.nextCursor as after; the formatter omits the unbounded fullText duplicate.",
+    okFormat: (j) => formatTranscriptPage(j),
     annotations: { readOnlyHint: true }
   },
   {
@@ -472,11 +537,6 @@ Poll get_media_facts(mediaItemId="${a.mediaItemId}", kind="${a.body?.kind}", sta
     name: "get_media_facts",
     operationId: "listMediaFacts",
     pathArgs: { mediaItemId: "id" },
-    queryArgs: {
-      kind: "Optional exact fact kind: subjectTrack | matte. Requires startSec and endSec.",
-      startSec: "Source-window start in seconds. Send together with kind and endSec.",
-      endSec: "Source-window end in seconds. Send together with kind and startSec."
-    },
     description: "Read prepared subject tracks and behind-subject mattes for one media item. For an exact readiness check, pass kind + startSec + endSec together using the same SOURCE window sent to prepare_media; exact.state is pending | ready | failed | available | unavailable. Use this after prepare_media and do not call preview_frame / score_composition until the required exact fact is ready.",
     annotations: { readOnlyHint: true, idempotentHint: true }
   },
@@ -484,11 +544,6 @@ Poll get_media_facts(mediaItemId="${a.mediaItemId}", kind="${a.body?.kind}", sta
     name: "list_media",
     operationId: "listMedia",
     description: "List the media in your CueFrame library. Filter a real library with kind (video|audio|image|gif|asset|source|stock), source (upload|generated|import-url|stock), or tag \u2014 so you find YOUR footage, not e2e debris. Returns media item IDs and metadata; use an ID with get_media_context, suggest_briefs, or as a composition source.",
-    queryArgs: {
-      kind: "video | audio | image | gif | asset | source | stock.",
-      source: "upload | generated | import-url | stock.",
-      tag: "Exact tag match."
-    },
     okFormat: (j) => formatMediaList(j),
     annotations: { readOnlyHint: true }
   },
@@ -556,12 +611,12 @@ Render it with create_render(projectId="${a.projectId}", body={ compositionId: "
   {
     name: "generate_media",
     operationId: "generateMedia",
-    description: 'Generate one first-class Library media item from a prompt. Choose generator: text-to-video | text-to-image | image-to-video | text-to-music | text-to-speech | text-to-sfx | auto. Put aspect/duration/voice/model controls in body.style and first/last/image references in body.refs. Returns { id, status:"generating", workflowId?, estimateUsd? }; returns 402 if the estimate exceeds the per-call ceiling. Async \u2014 call wait_job(kind="media", id=mediaItemId) or use a webhook (media.completed \u2014 status rides the payload). Use the returned id like any other media item.'
+    description: 'Generate one first-class Library media item from a prompt. Choose generator: text-to-video | text-to-image | image-to-video | text-to-music | text-to-speech | text-to-sfx | auto. Put supported presentation controls in body.style and first/last/image references in body.refs. Returns { id, status:"generating", estimateUsd? }; returns 402 if the estimate exceeds the per-call ceiling. Async \u2014 call wait_job(kind="media", id=mediaItemId) or use a webhook (media.completed \u2014 status rides the payload). Use the returned id like any other media item.'
   },
   {
     name: "create_upload",
     operationId: "createMediaUpload",
-    description: "Ingest a LOCAL file \u2014 bytes you hold, when there is no public URL to hand import_media (prefer import_media whenever the bytes already sit at an https URL). TWO steps: (1) this tool reserves a media row and returns { id, uploadUrl, expiresAt } \u2014 a short-lived presigned PUT URL. PUT the raw file bytes straight to uploadUrl over HTTPS with your declared Content-Type (the bytes go direct to R2, never through MCP; \u2264 ~5 GB per PUT). (2) call finalize_upload({ mediaItemId: id }) to start processing. Body: filename, contentType (allowed enum), size (bytes). Thereafter it is async exactly like import_media: poll list_media for processingStatus, or register a webhook (create_webhook on media.completed). Use the returned id with get_media_context, suggest_briefs, or as a composition source."
+    description: "Ingest a LOCAL file \u2014 bytes you hold, when there is no public URL to hand import_media (prefer import_media whenever the bytes already sit at an https URL). TWO steps: (1) this tool reserves a media item and returns { id, uploadUrl, expiresAt } \u2014 a short-lived PUT URL. PUT the raw file bytes to uploadUrl over HTTPS with your declared Content-Type (\u2264 ~5 GB per PUT). (2) call finalize_upload({ mediaItemId: id }) to start processing. Body: filename, contentType (allowed enum), size (bytes). Thereafter it is async exactly like import_media: poll list_media for processingStatus, or register a webhook (create_webhook on media.completed). Use the returned id with get_media_context, suggest_briefs, or as a composition source."
   },
   {
     name: "finalize_upload",
@@ -572,10 +627,10 @@ Render it with create_render(projectId="${a.projectId}", body={ compositionId: "
   {
     name: "search_resources",
     operationId: "searchResources",
-    description: "Search licensed STOCK media to compose with \u2014 video/photo (Pexels + Pixabay fallback), sfx (Freesound, CC0-only), gif (Klipy). Pass query for ONE search, or queries[] (\u226410) to run them all in a SINGLE call \u2014 strongly prefer the batch when you know several things you need (a 64-search session spent 5m10s on serial round-trips). A batch returns results[], one per query in order, each with its own candidates; a query that fails carries an error and never discards the others. Optional kind [default video], provider pin, limit \u226450 apply to every query in the batch. Returns ranked candidates, each with an opaque candidateId + attribution (author, assetUrl) + license, and a preview URL in the text. FREE + rate-limited + 7-day cached \u2014 reach for this before generate_media when real footage beats synthesis. TO SEE the candidates rather than read about them, pass limit \u22652: thumbnails/audio are attached only when you asked for options to compare, because a preview of a single forced choice is pure cost. Import a chosen candidate into a project with import_resource. Candidates expire after 7 days (re-search to refresh a candidateId).",
+    description: "Search licensed stock media to compose with across video, photo, sound effects, and GIFs. Pass query for ONE search, or queries[] (\u226410) to run them all in a SINGLE call \u2014 strongly prefer the batch when you know several things you need. A batch returns results[], one per query in order, each with its own candidates; a query that fails carries an error and never discards the others. Optional kind [default video], provider pin, and limit \u226450 apply to every query in the batch. Returns ranked candidates, each with an opaque candidateId + attribution (author, assetUrl) + license, and a preview URL in the text. FREE + rate-limited + cached \u2014 reach for this before generate_media when real footage beats synthesis. TO SEE the candidates rather than read about them, pass limit \u22652: thumbnails/audio are attached only when you asked for options to compare. Import a chosen candidate into a project with import_resource. Candidate handles expire; re-search to refresh one.",
     okFormat: (j) => formatResourceCandidates(j),
     preview: {
-      urls: (j) => (Array.isArray(j?.results) ? j.results.flatMap((r) => Array.isArray(r?.candidates) ? r.candidates : []) : Array.isArray(j?.candidates) ? j.candidates : []).map((c) => c?.previewUrl),
+      urls: (j) => (Array.isArray(j?.results) ? j.results.flatMap((r) => Array.isArray(r?.candidates) ? r.candidates : []) : Array.isArray(j?.candidates) ? j.candidates : []).map((c) => (j?.kind ?? j?.results?.[0]?.kind) === "sfx" ? c?.previewUrl : c?.thumbnail),
       kind: (j) => (j?.kind ?? j?.results?.[0]?.kind) === "sfx" ? "audio" : "image",
       cap: 12,
       attach: (j) => Array.isArray(j?.results) ? true : (Array.isArray(j?.candidates) ? j.candidates.length : 0) > 1
@@ -598,7 +653,7 @@ Render it with create_render(projectId="${a.projectId}", body={ compositionId: "
     name: "suggest_briefs",
     operationId: "suggestBriefs",
     pathArgs: { mediaItemId: "id" },
-    description: `Run AI clip-suggestion analysis on a long-form media item \u2014 the CLIPPING path (find the best short-form moments). Returns { workflowId, status }; then wait_job(kind="suggestions", id=mediaItemId) \u2014 its terminal lists each suggestion WITH its briefId. When the media belongs to a PROJECT, each finalized suggestion is promoted to a kind-'clip' BRIEF (its window pinned as a beat) \u2014 list_briefs {kind:"clip"} shows them and compose({ briefId }) runs the flagship path from one. Project-less media: pass the suggestion id to compose({ suggestionId }) directly. Clipping is a vertical, NOT the general path.`
+    description: `Run AI clip-suggestion analysis on a long-form media item \u2014 the CLIPPING path (find the best short-form moments). Returns { status, alreadyRunning? }; then wait_job(kind="suggestions", id=mediaItemId) \u2014 its terminal lists each suggestion WITH its briefId. When the media belongs to a PROJECT, each finalized suggestion is promoted to a kind-'clip' BRIEF (its window pinned as a beat) \u2014 list_briefs {kind:"clip"} shows them and compose({ briefId }) runs the flagship path from one. Project-less media: pass the suggestion id to compose({ suggestionId }) directly. Clipping is a vertical, NOT the general path.`
   },
   {
     name: "create_webhook",
@@ -733,12 +788,6 @@ Render it with create_render(projectId="${a.projectId}", body={ compositionId: "
     name: "get_usage",
     operationId: "getUsage",
     description: `The A2 usage ledger: every metered billing event newest-first with attribution \u2014 featureId, amount, the project/job that produced it, and the event's LIST price in USD (a plan allowance may zero it on the invoice). Answer "what did project X cost this period?" with a query instead of summing your own quotes. Filter by projectId, jobId, and/or a [from, to) epoch-ms window. Requires the billing:read scope.`,
-    queryArgs: {
-      projectId: "Scope to one project.",
-      jobId: "One job/render/compose/media id.",
-      from: "Period start, epoch-ms (inclusive).",
-      to: "Period end, epoch-ms (exclusive)."
-    },
     annotations: { readOnlyHint: true }
   },
   {
@@ -911,6 +960,8 @@ var CRUD_COVERAGE = [
 ];
 
 export {
+  formatMediaContext,
+  formatTranscriptPage,
   formatMediaList,
   formatComponentList,
   formatResourceCandidates,

package/dist/chunk-ZZRBKGDA.js

@@ -0,0 +1,109 @@
+// ../execution/primitives/src/lib/schema.ts
+import { z } from "zod";
+function zodToJsonSchemaFor(schema, _name) {
+  return z.toJSONSchema(schema, {
+    target: "draft-7",
+    io: "input",
+    reused: "inline"
+  });
+}
+function zodToDefaults(schema) {
+  if (!(schema instanceof z.ZodObject)) {
+    return {};
+  }
+  const out = {};
+  for (const [key, field] of Object.entries(schema.shape)) {
+    const parsed = field.safeParse(void 0);
+    if (parsed.success && parsed.data !== void 0) {
+      out[key] = parsed.data;
+      continue;
+    }
+    if (field instanceof z.ZodObject) {
+      const nested = zodToDefaults(field);
+      if (Object.keys(nested).length > 0) {
+        out[key] = nested;
+      }
+    }
+  }
+  return out;
+}
+function zodToControls(schema) {
+  if (!(schema instanceof z.ZodObject)) return [];
+  const controls = [];
+  for (const [name, field] of Object.entries(schema.shape)) {
+    const control = fieldToControl(name, field);
+    if (control) controls.push(control);
+  }
+  return controls;
+}
+function fieldToControl(name, field) {
+  let current = field;
+  let required = true;
+  let defaultValue;
+  while (true) {
+    if (current instanceof z.ZodOptional) {
+      required = false;
+      current = current.unwrap();
+      continue;
+    }
+    if (current instanceof z.ZodDefault) {
+      required = false;
+      const parsed = current.safeParse(void 0);
+      if (parsed.success) defaultValue = parsed.data;
+      current = current.unwrap();
+      continue;
+    }
+    break;
+  }
+  const description = current.description;
+  const label = humanize(name);
+  if (current instanceof z.ZodString) {
+    const looksLikeColor = /color|colour|hex/i.test(name);
+    return {
+      name,
+      label,
+      description,
+      type: looksLikeColor ? "color" : "string",
+      defaultValue,
+      required
+    };
+  }
+  if (current instanceof z.ZodNumber) {
+    const min = current.minValue ?? void 0;
+    const max = current.maxValue ?? void 0;
+    const step = inferStep(min, max);
+    return { name, label, description, type: "number", defaultValue, min, max, step, required };
+  }
+  if (current instanceof z.ZodBoolean) {
+    return { name, label, description, type: "boolean", defaultValue, required };
+  }
+  if (current instanceof z.ZodEnum) {
+    return {
+      name,
+      label,
+      description,
+      type: "select",
+      defaultValue,
+      options: current.options.filter((value) => typeof value === "string"),
+      required
+    };
+  }
+  return null;
+}
+function humanize(name) {
+  return name.replace(/([A-Z])/g, " $1").replace(/[-_]/g, " ").replace(/\s+/g, " ").trim().replace(/^./, (c) => c.toUpperCase());
+}
+function inferStep(min, max) {
+  if (min === void 0 || max === void 0) return 1;
+  const range = max - min;
+  if (range <= 1) return 0.01;
+  if (range <= 10) return 0.1;
+  if (range <= 100) return 1;
+  return Math.max(1, Math.round(range / 100));
+}
+
+export {
+  zodToJsonSchemaFor,
+  zodToDefaults,
+  zodToControls
+};

package/dist/cloud-import.js

@@ -1,7 +1,3 @@
-import {
-  multipartUpload
-} from "./chunk-EP2Y6M2J.js";
-import "./chunk-6IU2UQI5.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../cloud-import/src/ImportProvider.tsx
@@ -10,62 +6,12 @@ import { UppyContextProvider } from "@uppy/react";
 
 // ../cloud-import/src/CloudImportService.ts
 import Uppy from "@uppy/core";
-import AwsS3 from "@uppy/aws-s3";
-
-// ../cloud-import/src/MediaItemPreprocessor.ts
-import { BasePlugin } from "@uppy/core";
-var MediaItemPreprocessor = class _MediaItemPreprocessor extends BasePlugin {
-  static pluginId = "MediaItemPreprocessor";
-  createFn = null;
-  preprocessBound;
-  constructor(uppy, opts) {
-    super(uppy, opts ?? {});
-    this.id = _MediaItemPreprocessor.pluginId;
-    this.type = "preprocessor";
-    this.preprocessBound = this.preprocess.bind(this);
-  }
-  setCreateFn(fn) {
-    this.createFn = fn;
-  }
-  install() {
-    this.uppy.addPreProcessor(this.preprocessBound);
-  }
-  uninstall() {
-    this.uppy.removePreProcessor(this.preprocessBound);
-  }
-  async preprocess(fileIDs) {
-    if (!this.createFn) return;
-    for (const fileID of fileIDs) {
-      const file = this.uppy.getFile(fileID);
-      if (!file) continue;
-      if (file.meta.convexMediaItemId) continue;
-      this.uppy.emit("preprocess-progress", file, {
-        mode: "indeterminate",
-        message: "Preparing upload\u2026"
-      });
-      try {
-        const mediaItemId = await this.createFn({
-          name: file.name ?? "unknown",
-          size: file.size ?? 0,
-          mimeType: file.type ?? "video/mp4"
-        });
-        this.uppy.setFileMeta(fileID, { convexMediaItemId: mediaItemId });
-      } catch (err) {
-        this.uppy.log(`[MediaItemPreprocessor] Failed for ${fileID}: ${err}`, "error");
-      }
-      this.uppy.emit("preprocess-complete", file);
-    }
-  }
-};
-
-// ../cloud-import/src/CloudImportService.ts
 var CloudImportService = class {
   uppy = null;
   config = null;
   init(config) {
     if (this.uppy) return this.uppy;
     this.config = config;
-    const signingUrl = this.config.uploadSigningUrl.replace(/\/$/, "");
     const createUppy = Uppy;
     const uppy = new createUppy({
       id: "cloud-import",
@@ -73,14 +19,23 @@ var CloudImportService = class {
         allowedFileTypes: ["video/*", "audio/*"]
       }
     });
-    const plugins = uppy;
-    plugins.use(AwsS3, {
-      endpoint: signingUrl,
-      shouldUseMultipart: true,
-      limit: 3,
-      retryDelays: [1e3, 3e3, 5e3, 1e4]
+    const uploadFile = this.config.uploadFile;
+    uppy.addUploader(async (ids) => {
+      for (const id of ids) {
+        const file = uppy.getFile(id);
+        if (!file) continue;
+        try {
+          const uploadURL = await uploadFile(file.data, (fraction) => {
+            uppy.emit("upload-progress", file, { uploadStarted: Date.now(), bytesUploaded: Math.round((file.size ?? 0) * fraction), bytesTotal: file.size ?? 0 });
+          });
+          uppy.setFileState(id, { response: { status: 200, body: {}, uploadURL } });
+          uppy.emit("upload-success", file, { status: 200, body: {}, uploadURL });
+        } catch (error) {
+          uppy.emit("upload-error", file, error instanceof Error ? error : new Error(String(error)));
+          throw error;
+        }
+      }
     });
-    plugins.use(MediaItemPreprocessor);
     this.uppy = uppy;
     return this.uppy;
   }
@@ -88,18 +43,6 @@ var CloudImportService = class {
     if (!this.uppy) throw new Error("CloudImportService not initialized \u2014 call init() first");
     return this.uppy;
   }
-  getPreprocessor() {
-    return this.getUppy().getPlugin(MediaItemPreprocessor.pluginId);
-  }
-  setMeta(meta) {
-    this.uppy?.setMeta(meta);
-    if (meta.uploadToken) {
-      const plugin = this.uppy?.getPlugin("AwsS3Multipart");
-      if (plugin) {
-        plugin.setOptions({ headers: { "uppy-auth-token": meta.uploadToken } });
-      }
-    }
-  }
 };
 var cloudImportService = new CloudImportService();
 
@@ -109,9 +52,7 @@ function ImportProvider({
   children,
   available,
   dialogSlot,
-  uploadSigningUrl,
-  getUploadMeta,
-  createMediaItem,
+  uploadFile,
   onUploadComplete,
   onError
 }) {
@@ -120,7 +61,7 @@ function ImportProvider({
   const onErrorRef = useRef(onError);
   onCompleteRef.current = onUploadComplete;
   onErrorRef.current = onError;
-  const [uppy] = useState(() => cloudImportService.init({ uploadSigningUrl }));
+  const [uppy] = useState(() => cloudImportService.init({ uploadFile }));
   useEffect(() => {
     const handleComplete = (result) => {
       const successful = result?.successful ?? [];
@@ -144,25 +85,9 @@ function ImportProvider({
       uppy.off("error", handleError);
     };
   }, [uppy]);
-  useEffect(() => {
-    try {
-      const preprocessor = cloudImportService.getPreprocessor();
-      preprocessor.setCreateFn(createMediaItem ?? null);
-    } catch {
-    }
-  }, [createMediaItem]);
-  const openModal = useCallback(async () => {
-    if (getUploadMeta) {
-      try {
-        const meta = await getUploadMeta();
-        cloudImportService.setMeta(meta);
-      } catch (err) {
-        console.error("[Import] Failed to get upload metadata:", err);
-        return;
-      }
-    }
+  const openModal = useCallback(() => {
     setIsOpen(true);
-  }, [getUploadMeta]);
+  }, []);
   const closeModal = useCallback(() => {
     setIsOpen(false);
   }, []);
@@ -179,20 +104,6 @@ function useImportIfAvailable() {
 }
 
 // ../cloud-import/src/cloudConfig.ts
-var ENVIRONMENTS = {
-  dev: {
-    convexUrl: "https://api-dev.cueframe.ai",
-    uploadSigningUrl: "http://localhost:8787"
-  },
-  staging: {
-    convexUrl: "https://api-dev.cueframe.ai",
-    uploadSigningUrl: "https://upload-signing.cueframelabs.workers.dev"
-  },
-  production: {
-    convexUrl: "https://api.cueframe.ai",
-    uploadSigningUrl: "https://upload.cueframe.ai"
-  }
-};
 function detectEnvironment(convexUrl) {
   if (!convexUrl) return "dev";
   if (/\b(api-dev|data-dev)\.cueframe\.ai/.test(convexUrl)) return "staging";
@@ -201,10 +112,6 @@ function detectEnvironment(convexUrl) {
   if (/\bexample-prod\.convex\.(cloud|site)/.test(convexUrl)) return "production";
   return "dev";
 }
-function getEndpoints(convexUrl) {
-  const env = detectEnvironment(convexUrl);
-  return ENVIRONMENTS[env];
-}
 
 // ../cloud-import/src/index.ts
 import {
@@ -213,12 +120,9 @@ import {
   useUppyEvent
 } from "@uppy/react";
 export {
-  ENVIRONMENTS,
   ImportProvider,
   cloudImportService,
   detectEnvironment,
-  getEndpoints,
-  multipartUpload,
   useDropzone,
   useImport,
   useImportIfAvailable,

package/dist/component-runtime/browserOptions.d.ts

@@ -0,0 +1 @@
+export * from "../_members/component-runtime/browserOptions.js";

package/dist/component-runtime/browserOptions.js

@@ -0,0 +1,7 @@
+import {
+  COMPONENT_CHROMIUM_OPTIONS
+} from "../chunk-CGHTMZNC.js";
+import "../chunk-2ESYSVXG.js";
+export {
+  COMPONENT_CHROMIUM_OPTIONS
+};

package/dist/component-runtime/contracts.d.ts

@@ -0,0 +1 @@
+export * from "../_members/component-runtime/contracts.js";

package/dist/component-runtime/contracts.js

@@ -0,0 +1,49 @@
+import {
+  CANVAS2D_COMPONENT_MANIFEST_V2,
+  COMPONENT_BUNDLE_VERSION,
+  COMPONENT_RECEIPT_VERSION,
+  COMPONENT_RUNTIME_ERROR_CODES,
+  COMPONENT_SOURCE_VERSION,
+  ComponentAssetBindingV2,
+  ComponentAssetDeclarationV2,
+  ComponentAssetFileV2,
+  ComponentAssetInputV2,
+  ComponentAssetKind,
+  ComponentBakeJobV2,
+  ComponentBakeRequestV2,
+  ComponentBundleV2,
+  ComponentGraphicsActualV2,
+  ComponentGraphicsRequirementV2,
+  ComponentManifestV2,
+  ComponentRenderReceiptV2,
+  ComponentRenderRequestV2,
+  ComponentRuntimeError,
+  ComponentRuntimeErrorCode,
+  ComponentSourceV2,
+  assertGraphicsReceiptMatches
+} from "../chunk-LQUWKBST.js";
+import "../chunk-2ESYSVXG.js";
+export {
+  CANVAS2D_COMPONENT_MANIFEST_V2,
+  COMPONENT_BUNDLE_VERSION,
+  COMPONENT_RECEIPT_VERSION,
+  COMPONENT_RUNTIME_ERROR_CODES,
+  COMPONENT_SOURCE_VERSION,
+  ComponentAssetBindingV2,
+  ComponentAssetDeclarationV2,
+  ComponentAssetFileV2,
+  ComponentAssetInputV2,
+  ComponentAssetKind,
+  ComponentBakeJobV2,
+  ComponentBakeRequestV2,
+  ComponentBundleV2,
+  ComponentGraphicsActualV2,
+  ComponentGraphicsRequirementV2,
+  ComponentManifestV2,
+  ComponentRenderReceiptV2,
+  ComponentRenderRequestV2,
+  ComponentRuntimeError,
+  ComponentRuntimeErrorCode,
+  ComponentSourceV2,
+  assertGraphicsReceiptMatches
+};

package/dist/component-runtime/identity/browser.d.ts

@@ -0,0 +1 @@
+export * from "../../_members/component-runtime/browserIdentity.js";