@cueframe/kernel 0.2.28 → 0.2.30

package/dist/_members/errors/registry.d.ts

@@ -403,6 +403,642 @@ export declare const ERROR_CODES: {
         readonly retryable: false;
         readonly httpStatus: 422;
     };
+    readonly brief_not_found: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 404;
+    };
+    readonly brief_modified: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 409;
+    };
+    readonly brief_media_missing: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly brief_audio_media_invalid: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly brief_no_window: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly brief_multi_source: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly brief_beats_invalid_window: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly brief_beats_noncontiguous: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly brief_beat_duration_unhonorable: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly brief_duration_unhonorable: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly brief_captions_conflict: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly brief_gates_conflict: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly brief_graphic_conflict: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly brief_graphic_excluded: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly brief_graphic_invalid_role: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly invalid_clip_window: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly invalid_trim_bounds: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly invalid_window: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly window_out_of_range: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly timeline_empty: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly timeline_too_long: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly invalid_transition: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly composition_active: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 409;
+    };
+    readonly composition_not_found: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 404;
+    };
+    readonly no_composition: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly scratch_not_found: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 404;
+    };
+    readonly stale_revision: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 409;
+    };
+    readonly project_not_found: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 404;
+    };
+    readonly batch_too_large: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 413;
+    };
+    readonly payload_too_large: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 413;
+    };
+    readonly invalid_media_id: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly invalid_webhook_url: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly invalid_age: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly unsupported_fact_scope: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly media_not_found: {
+        readonly stage: "import";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 404;
+    };
+    readonly media_unavailable: {
+        readonly stage: "import";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly no_bytes_uploaded: {
+        readonly stage: "import";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly no_audio_role: {
+        readonly stage: "import";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly no_video_roles: {
+        readonly stage: "import";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly not_ready: {
+        readonly stage: "import";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 409;
+    };
+    readonly suggestion_not_found: {
+        readonly stage: "import";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 404;
+    };
+    readonly transcript_payload_unavailable: {
+        readonly stage: "import";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly fact_not_found: {
+        readonly stage: "import";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 404;
+    };
+    readonly fact_media_ownership_mismatch: {
+        readonly stage: "import";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 403;
+    };
+    readonly fact_org_mismatch: {
+        readonly stage: "import";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 403;
+    };
+    readonly fact_scope_mismatch: {
+        readonly stage: "import";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly job_not_found: {
+        readonly stage: "compose";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 404;
+    };
+    readonly compose_job_not_found: {
+        readonly stage: "compose";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 404;
+    };
+    readonly render_job_not_found: {
+        readonly stage: "render";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 404;
+    };
+    readonly invalid_job_terminal: {
+        readonly stage: "compose";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 409;
+    };
+    readonly not_awaiting: {
+        readonly stage: "compose";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 409;
+    };
+    readonly not_refreshable: {
+        readonly stage: "render";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 409;
+    };
+    readonly generation_in_flight: {
+        readonly stage: "compose";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 409;
+    };
+    readonly renders_in_flight: {
+        readonly stage: "render";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 409;
+    };
+    readonly revision_cycles_exhausted: {
+        readonly stage: "compose";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly generation_insufficient_balance: {
+        readonly stage: "billing";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 402;
+    };
+    readonly render_insufficient_balance: {
+        readonly stage: "billing";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 402;
+    };
+    readonly missing_payment_blob: {
+        readonly stage: "billing";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 402;
+    };
+    readonly nonce_replay: {
+        readonly stage: "billing";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 409;
+    };
+    readonly x402_row_not_found: {
+        readonly stage: "billing";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 404;
+    };
+    readonly facilitator_missing_amount: {
+        readonly stage: "billing";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 402;
+    };
+    readonly facilitator_missing_nonce: {
+        readonly stage: "billing";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 402;
+    };
+    readonly facilitator_missing_payer: {
+        readonly stage: "billing";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 402;
+    };
+    readonly facilitator_missing_valid_before: {
+        readonly stage: "billing";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 402;
+    };
+    readonly unauthenticated: {
+        readonly stage: "auth";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 401;
+    };
+    readonly webhook_unverified: {
+        readonly stage: "auth";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 401;
+    };
+    readonly embedding_dimension_mismatch: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly embedding_model_mismatch: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
+    readonly facilitator_verify_failed: {
+        readonly stage: "billing";
+        readonly category: "transient";
+        readonly retryable: true;
+        readonly httpStatus: 503;
+    };
+    readonly facilitator_settle_failed: {
+        readonly stage: "billing";
+        readonly category: "transient";
+        readonly retryable: true;
+        readonly httpStatus: 503;
+    };
+    readonly embedding_provider_failed: {
+        readonly stage: "validate";
+        readonly category: "transient";
+        readonly retryable: true;
+        readonly httpStatus: 503;
+    };
+    readonly generator_unavailable: {
+        readonly stage: "compose";
+        readonly category: "transient";
+        readonly retryable: true;
+        readonly httpStatus: 503;
+    };
+    readonly pipeline_unavailable: {
+        readonly stage: "import";
+        readonly category: "transient";
+        readonly retryable: true;
+        readonly httpStatus: 503;
+    };
+    readonly mux_unavailable: {
+        readonly stage: "export";
+        readonly category: "transient";
+        readonly retryable: true;
+        readonly httpStatus: 503;
+    };
+    readonly import_unavailable: {
+        readonly stage: "import";
+        readonly category: "transient";
+        readonly retryable: true;
+        readonly httpStatus: 503;
+    };
+    readonly analysis_unconfigured: {
+        readonly stage: "compose";
+        readonly category: "transient";
+        readonly retryable: true;
+        readonly httpStatus: 503;
+    };
+    readonly search_unconfigured: {
+        readonly stage: "validate";
+        readonly category: "transient";
+        readonly retryable: true;
+        readonly httpStatus: 503;
+    };
+    readonly cdp_not_configured: {
+        readonly stage: "billing";
+        readonly category: "transient";
+        readonly retryable: false;
+        readonly httpStatus: 503;
+    };
+    readonly cdp_not_implemented: {
+        readonly stage: "billing";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 501;
+    };
+    readonly analysis_failed: {
+        readonly stage: "compose";
+        readonly category: "internal";
+        readonly retryable: true;
+        readonly httpStatus: 500;
+    };
+    readonly generator_dispatch_failed: {
+        readonly stage: "compose";
+        readonly category: "internal";
+        readonly retryable: true;
+        readonly httpStatus: 500;
+    };
+    readonly import_dispatch_failed: {
+        readonly stage: "import";
+        readonly category: "internal";
+        readonly retryable: true;
+        readonly httpStatus: 500;
+    };
+    readonly mux_dispatch_failed: {
+        readonly stage: "export";
+        readonly category: "internal";
+        readonly retryable: true;
+        readonly httpStatus: 500;
+    };
+    readonly trigger_failed: {
+        readonly stage: "compose";
+        readonly category: "internal";
+        readonly retryable: true;
+        readonly httpStatus: 500;
+    };
+    readonly cancel_unreachable: {
+        readonly stage: "compose";
+        readonly category: "internal";
+        readonly retryable: true;
+        readonly httpStatus: 500;
+    };
+    readonly presign_failed: {
+        readonly stage: "import";
+        readonly category: "internal";
+        readonly retryable: true;
+        readonly httpStatus: 500;
+    };
+    readonly refresh_failed: {
+        readonly stage: "render";
+        readonly category: "internal";
+        readonly retryable: true;
+        readonly httpStatus: 500;
+    };
+    readonly sweep_failed: {
+        readonly stage: "system";
+        readonly category: "internal";
+        readonly retryable: true;
+        readonly httpStatus: 500;
+    };
+    readonly create_failed: {
+        readonly stage: "auth";
+        readonly category: "internal";
+        readonly retryable: true;
+        readonly httpStatus: 500;
+    };
+    readonly transcription_result_missing: {
+        readonly stage: "import";
+        readonly category: "internal";
+        readonly retryable: true;
+        readonly httpStatus: 500;
+    };
+    readonly transcript_model_missing: {
+        readonly stage: "import";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 500;
+    };
+    readonly output_missing: {
+        readonly stage: "render";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 500;
+    };
+    readonly snapshot_missing: {
+        readonly stage: "render";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 500;
+    };
+    readonly snapshot_assets_missing: {
+        readonly stage: "render";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 500;
+    };
+    readonly matte_clip_id_missing: {
+        readonly stage: "render";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 500;
+    };
+    readonly matte_consumers_missing: {
+        readonly stage: "render";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 500;
+    };
+    readonly intent_key_drift: {
+        readonly stage: "render";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 500;
+    };
+    readonly content_anchor: {
+        readonly stage: "compose";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 500;
+    };
+    readonly card_params_corrupt: {
+        readonly stage: "validate";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 500;
+    };
+    readonly original_row_missing: {
+        readonly stage: "system";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 500;
+    };
+    readonly malformed_pending_fact: {
+        readonly stage: "system";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 500;
+    };
+    readonly fact_identity_collision: {
+        readonly stage: "system";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 500;
+    };
+    readonly fact_request_cause_mismatch: {
+        readonly stage: "system";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 500;
+    };
+    readonly fact_dispatch_fence_rejected: {
+        readonly stage: "system";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 409;
+    };
+    readonly mux_state_drift: {
+        readonly stage: "export";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 500;
+    };
+    readonly corrupt_session: {
+        readonly stage: "compose";
+        readonly category: "internal";
+        readonly retryable: false;
+        readonly httpStatus: 500;
+    };
     readonly component_deadline_exceeded: {
         readonly stage: "render";
         readonly category: "transient";

package/dist/authoring/scene.js

@@ -13,7 +13,7 @@ import {
   sceneTrackIdFor,
   validateSceneAdd,
   validateSceneUpdate
-} from "../chunk-USAXWI4T.js";
+} from "../chunk-4MK6YGKV.js";
 import {
   SCENE_TRANSITION_KINDS,
   collectSceneClipIssues,

package/dist/authoring.js

@@ -4,7 +4,7 @@ import {
   hasSceneOp,
   isSceneOp,
   materializeSceneOpsCore
-} from "./chunk-USAXWI4T.js";
+} from "./chunk-4MK6YGKV.js";
 import {
   ZERO_USAGE,
   buildDirectorTools,
@@ -48,7 +48,7 @@ import {
   formatPlanSteps,
   initCodeGenPrompts
 } from "./chunk-Y4HPN4BC.js";
-import "./chunk-QSQFZAZV.js";
+import "./chunk-SYOAAD5J.js";
 import {
   cssLayoutVars
 } from "./chunk-W5W3FDDI.js";
@@ -62,7 +62,7 @@ import "./chunk-WPZKOVYF.js";
 import "./chunk-B7J5UUUV.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-ABJBQCW2.js";
+import "./chunk-TABHHNVY.js";
 import "./chunk-7PA7FGLD.js";
 import {
   collectSceneClipIssues,

package/dist/{chunk-2RVANTUG.js → chunk-2FKR6UTY.js}

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

package/dist/{chunk-QAALM5BW.js → chunk-3SXCFAND.js}

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

package/dist/{chunk-USAXWI4T.js → chunk-4MK6YGKV.js}

@@ -260,7 +260,17 @@ async function materializeSceneOpsCore(composition, ops, deps) {
   for (let i = 0; i < ops.length; i++) {
     const op = ops[i];
     if (!isSceneOp(op)) {
-      current = emit(op, current);
+      try {
+        current = emit(op, current);
+      } catch (error) {
+        if (error instanceof SceneAuthoringError) throw error;
+        throw new SceneAuthoringError(
+          "invalid_composition",
+          `ops[${i}]`,
+          error instanceof Error ? error.message : String(error),
+          { opIndex: i }
+        );
+      }
       continue;
     }
     try {

package/dist/{chunk-PMBPLTKU.js → chunk-I3TP2HIJ.js}

@@ -1,6 +1,6 @@
 import {
   CueframeError
-} from "./chunk-ABJBQCW2.js";
+} from "./chunk-TABHHNVY.js";
 
 // ../execution/render-harness/src/cardAssetAdmission.ts
 import parseCss from "css-tree/parser";

package/dist/{chunk-XT3SK7HR.js → chunk-LB54TVWM.js}

@@ -24,7 +24,7 @@ import {
   scoreAndRank,
   segmentShots,
   stabilizeSelectionHysteresis
-} from "./chunk-QAALM5BW.js";
+} from "./chunk-3SXCFAND.js";
 import {
   compositionHasVo,
   roleDefaultGainDb
@@ -36,7 +36,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-ABJBQCW2.js";
+} from "./chunk-TABHHNVY.js";
 import {
   SCENE_CAPTURE_IDENTITY_FIELDS_V1,
   SCENE_PRESET_TRIANGLES,

package/dist/{chunk-QSQFZAZV.js → chunk-SYOAAD5J.js}

@@ -6,7 +6,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-ABJBQCW2.js";
+} from "./chunk-TABHHNVY.js";
 
 // ../composition/src/projection/cardTokens.ts
 var CARD_MOTION_VAR_NAMES = [

package/dist/{chunk-ABJBQCW2.js → chunk-TABHHNVY.js}

@@ -66,6 +66,138 @@ var ERROR_CODES = {
   component_runtime_error: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   component_source_unavailable: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   scene_materialization_failed: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  // ── CUE-28: codes that were thrown typed and arrived as internal_error 500 ──
+  //
+  // Every entry below was already a deliberate `ConvexError({ code })` at its
+  // throw site. Without a registry row `translateToEnvelope` resolved none of
+  // them, so all of them reached the caller as an opaque 500 with the message
+  // replaced — the CUE-12 defect, 103 times over.
+  //
+  // `category` is the load-bearing field, not `httpStatus`: `authoring` puts the
+  // throw site's sentence on the wire (scrubbed), everything else replaces it
+  // with a generic string. So it is set to `authoring` only where the caller's
+  // own request explains the failure, and left `internal` where the message
+  // would describe our infrastructure instead.
+  // Brief validation — each of these throws with a full `message:` naming the
+  // offending field and value. They were the most expensive to lose.
+  brief_not_found: { stage: "validate", category: "authoring", retryable: false, httpStatus: 404 },
+  brief_modified: { stage: "validate", category: "authoring", retryable: false, httpStatus: 409 },
+  brief_media_missing: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  brief_audio_media_invalid: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  brief_no_window: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  brief_multi_source: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  brief_beats_invalid_window: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  brief_beats_noncontiguous: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  brief_beat_duration_unhonorable: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  brief_duration_unhonorable: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  brief_captions_conflict: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  brief_gates_conflict: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  brief_graphic_conflict: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  brief_graphic_excluded: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  brief_graphic_invalid_role: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  // Composition / timeline authoring
+  invalid_clip_window: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  invalid_trim_bounds: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  invalid_window: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  window_out_of_range: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  timeline_empty: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  timeline_too_long: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  invalid_transition: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  composition_active: { stage: "validate", category: "authoring", retryable: false, httpStatus: 409 },
+  composition_not_found: { stage: "validate", category: "authoring", retryable: false, httpStatus: 404 },
+  no_composition: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  scratch_not_found: { stage: "validate", category: "authoring", retryable: false, httpStatus: 404 },
+  stale_revision: { stage: "validate", category: "authoring", retryable: false, httpStatus: 409 },
+  project_not_found: { stage: "validate", category: "authoring", retryable: false, httpStatus: 404 },
+  batch_too_large: { stage: "validate", category: "authoring", retryable: false, httpStatus: 413 },
+  payload_too_large: { stage: "validate", category: "authoring", retryable: false, httpStatus: 413 },
+  invalid_media_id: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  invalid_webhook_url: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  invalid_age: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  unsupported_fact_scope: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  // Media lifecycle
+  media_not_found: { stage: "import", category: "authoring", retryable: false, httpStatus: 404 },
+  media_unavailable: { stage: "import", category: "authoring", retryable: false, httpStatus: 422 },
+  no_bytes_uploaded: { stage: "import", category: "authoring", retryable: false, httpStatus: 422 },
+  no_audio_role: { stage: "import", category: "authoring", retryable: false, httpStatus: 422 },
+  no_video_roles: { stage: "import", category: "authoring", retryable: false, httpStatus: 422 },
+  not_ready: { stage: "import", category: "authoring", retryable: false, httpStatus: 409 },
+  suggestion_not_found: { stage: "import", category: "authoring", retryable: false, httpStatus: 404 },
+  transcript_payload_unavailable: { stage: "import", category: "authoring", retryable: false, httpStatus: 422 },
+  fact_not_found: { stage: "import", category: "authoring", retryable: false, httpStatus: 404 },
+  fact_media_ownership_mismatch: { stage: "import", category: "authoring", retryable: false, httpStatus: 403 },
+  fact_org_mismatch: { stage: "import", category: "authoring", retryable: false, httpStatus: 403 },
+  fact_scope_mismatch: { stage: "import", category: "authoring", retryable: false, httpStatus: 422 },
+  // Job / lifecycle state the caller can reconcile by re-reading
+  job_not_found: { stage: "compose", category: "authoring", retryable: false, httpStatus: 404 },
+  compose_job_not_found: { stage: "compose", category: "authoring", retryable: false, httpStatus: 404 },
+  render_job_not_found: { stage: "render", category: "authoring", retryable: false, httpStatus: 404 },
+  invalid_job_terminal: { stage: "compose", category: "authoring", retryable: false, httpStatus: 409 },
+  not_awaiting: { stage: "compose", category: "authoring", retryable: false, httpStatus: 409 },
+  not_refreshable: { stage: "render", category: "authoring", retryable: false, httpStatus: 409 },
+  generation_in_flight: { stage: "compose", category: "authoring", retryable: false, httpStatus: 409 },
+  renders_in_flight: { stage: "render", category: "authoring", retryable: false, httpStatus: 409 },
+  revision_cycles_exhausted: { stage: "compose", category: "authoring", retryable: false, httpStatus: 422 },
+  // Billing — the caller's balance explains these
+  generation_insufficient_balance: { stage: "billing", category: "authoring", retryable: false, httpStatus: 402 },
+  render_insufficient_balance: { stage: "billing", category: "authoring", retryable: false, httpStatus: 402 },
+  // x402 — the payload the caller signed explains these
+  missing_payment_blob: { stage: "billing", category: "authoring", retryable: false, httpStatus: 402 },
+  nonce_replay: { stage: "billing", category: "authoring", retryable: false, httpStatus: 409 },
+  x402_row_not_found: { stage: "billing", category: "authoring", retryable: false, httpStatus: 404 },
+  facilitator_missing_amount: { stage: "billing", category: "authoring", retryable: false, httpStatus: 402 },
+  facilitator_missing_nonce: { stage: "billing", category: "authoring", retryable: false, httpStatus: 402 },
+  facilitator_missing_payer: { stage: "billing", category: "authoring", retryable: false, httpStatus: 402 },
+  facilitator_missing_valid_before: { stage: "billing", category: "authoring", retryable: false, httpStatus: 402 },
+  // Auth
+  unauthenticated: { stage: "auth", category: "authoring", retryable: false, httpStatus: 401 },
+  webhook_unverified: { stage: "auth", category: "authoring", retryable: false, httpStatus: 401 },
+  // Embedding / search — the request's own vector or model explains these
+  embedding_dimension_mismatch: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  embedding_model_mismatch: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  // ── TRANSIENT: ours, but retrying is the right response ──
+  facilitator_verify_failed: { stage: "billing", category: "transient", retryable: true, httpStatus: 503 },
+  facilitator_settle_failed: { stage: "billing", category: "transient", retryable: true, httpStatus: 503 },
+  embedding_provider_failed: { stage: "validate", category: "transient", retryable: true, httpStatus: 503 },
+  generator_unavailable: { stage: "compose", category: "transient", retryable: true, httpStatus: 503 },
+  pipeline_unavailable: { stage: "import", category: "transient", retryable: true, httpStatus: 503 },
+  mux_unavailable: { stage: "export", category: "transient", retryable: true, httpStatus: 503 },
+  import_unavailable: { stage: "import", category: "transient", retryable: true, httpStatus: 503 },
+  analysis_unconfigured: { stage: "compose", category: "transient", retryable: true, httpStatus: 503 },
+  search_unconfigured: { stage: "validate", category: "transient", retryable: true, httpStatus: 503 },
+  cdp_not_configured: { stage: "billing", category: "transient", retryable: false, httpStatus: 503 },
+  cdp_not_implemented: { stage: "billing", category: "internal", retryable: false, httpStatus: 501 },
+  // ── INTERNAL: the message would describe our infrastructure, not the request.
+  // Registered anyway, so the CODE and `retryable` are still honest even though
+  // the message is replaced — a caller can at least tell these apart from one
+  // another and knows whether to retry.
+  analysis_failed: { stage: "compose", category: "internal", retryable: true, httpStatus: 500 },
+  generator_dispatch_failed: { stage: "compose", category: "internal", retryable: true, httpStatus: 500 },
+  import_dispatch_failed: { stage: "import", category: "internal", retryable: true, httpStatus: 500 },
+  mux_dispatch_failed: { stage: "export", category: "internal", retryable: true, httpStatus: 500 },
+  trigger_failed: { stage: "compose", category: "internal", retryable: true, httpStatus: 500 },
+  cancel_unreachable: { stage: "compose", category: "internal", retryable: true, httpStatus: 500 },
+  presign_failed: { stage: "import", category: "internal", retryable: true, httpStatus: 500 },
+  refresh_failed: { stage: "render", category: "internal", retryable: true, httpStatus: 500 },
+  sweep_failed: { stage: "system", category: "internal", retryable: true, httpStatus: 500 },
+  create_failed: { stage: "auth", category: "internal", retryable: true, httpStatus: 500 },
+  transcription_result_missing: { stage: "import", category: "internal", retryable: true, httpStatus: 500 },
+  transcript_model_missing: { stage: "import", category: "internal", retryable: false, httpStatus: 500 },
+  output_missing: { stage: "render", category: "internal", retryable: false, httpStatus: 500 },
+  snapshot_missing: { stage: "render", category: "internal", retryable: false, httpStatus: 500 },
+  snapshot_assets_missing: { stage: "render", category: "internal", retryable: false, httpStatus: 500 },
+  matte_clip_id_missing: { stage: "render", category: "internal", retryable: false, httpStatus: 500 },
+  matte_consumers_missing: { stage: "render", category: "internal", retryable: false, httpStatus: 500 },
+  intent_key_drift: { stage: "render", category: "internal", retryable: false, httpStatus: 500 },
+  content_anchor: { stage: "compose", category: "internal", retryable: false, httpStatus: 500 },
+  card_params_corrupt: { stage: "validate", category: "internal", retryable: false, httpStatus: 500 },
+  original_row_missing: { stage: "system", category: "internal", retryable: false, httpStatus: 500 },
+  malformed_pending_fact: { stage: "system", category: "internal", retryable: false, httpStatus: 500 },
+  fact_identity_collision: { stage: "system", category: "internal", retryable: false, httpStatus: 500 },
+  fact_request_cause_mismatch: { stage: "system", category: "internal", retryable: false, httpStatus: 500 },
+  fact_dispatch_fence_rejected: { stage: "system", category: "internal", retryable: false, httpStatus: 409 },
+  mux_state_drift: { stage: "export", category: "internal", retryable: false, httpStatus: 500 },
+  corrupt_session: { stage: "compose", category: "internal", retryable: false, httpStatus: 500 },
   component_deadline_exceeded: { stage: "render", category: "transient", retryable: true, httpStatus: 503 },
   component_resource_exhausted: { stage: "render", category: "transient", retryable: true, httpStatus: 503 },
   component_asset_undeclared: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },

package/dist/{chunk-JEJKLW2N.js → chunk-ZS2WRJZ4.js}

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

package/dist/compose.js

@@ -54,7 +54,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-ABJBQCW2.js";
+} from "./chunk-TABHHNVY.js";
 import "./chunk-7PA7FGLD.js";
 import "./chunk-XACXNDFL.js";
 import "./chunk-2L7PYYJK.js";

package/dist/composition/projection.js

@@ -32,7 +32,7 @@ import {
   silhouetteKeepOutForWindow,
   sourceRectToOutput,
   sourceWindowKey
-} from "../chunk-QSQFZAZV.js";
+} from "../chunk-SYOAAD5J.js";
 import {
   BRAND_TOKEN_REFS,
   BRAND_TOKEN_ROOT_KEYS,
@@ -74,7 +74,7 @@ import {
   contrastRatio
 } from "../chunk-ILO4NEZ3.js";
 import "../chunk-VG2ND6PX.js";
-import "../chunk-ABJBQCW2.js";
+import "../chunk-TABHHNVY.js";
 import "../chunk-AVTEPAWI.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/composition-ops.js

@@ -1,9 +1,9 @@
 import {
   playableSpans
-} from "./chunk-XT3SK7HR.js";
+} from "./chunk-LB54TVWM.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-QISFYLBB.js";
-import "./chunk-QAALM5BW.js";
+import "./chunk-3SXCFAND.js";
 import "./chunk-VZ7TYX6Z.js";
 import "./chunk-DENF4TPI.js";
 import {
@@ -30,7 +30,7 @@ import {
 } from "./chunk-B7J5UUUV.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-ABJBQCW2.js";
+import "./chunk-TABHHNVY.js";
 import "./chunk-7PA7FGLD.js";
 import {
   SCENE_SLOT_MEDIA_FORMATS,

package/dist/composition.js

@@ -46,7 +46,7 @@ import {
   silhouetteKeepOutForWindow,
   sourceRectToOutput,
   sourceWindowKey
-} from "./chunk-QSQFZAZV.js";
+} from "./chunk-SYOAAD5J.js";
 import {
   BRAND_TOKEN_REFS,
   BRAND_TOKEN_ROOT_KEYS,
@@ -194,7 +194,7 @@ import {
   ReframeSegmentFields
 } from "./chunk-B7J5UUUV.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-ABJBQCW2.js";
+import "./chunk-TABHHNVY.js";
 import "./chunk-AVTEPAWI.js";
 import "./chunk-2ESYSVXG.js";
 

package/dist/core/render.js

@@ -66,19 +66,19 @@ import {
   sliceTranscriptWords,
   splitIntoSentences,
   validateComposition
-} from "../chunk-XT3SK7HR.js";
+} from "../chunk-LB54TVWM.js";
 import {
   buildEasedZooms,
   buildPannedCenters,
   easeOutCubic
 } from "../chunk-QH3YI3ND.js";
 import "../chunk-QISFYLBB.js";
-import "../chunk-QAALM5BW.js";
+import "../chunk-3SXCFAND.js";
 import "../chunk-VZ7TYX6Z.js";
 import "../chunk-DENF4TPI.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-WREYUH2E.js";
-import "../chunk-ABJBQCW2.js";
+import "../chunk-TABHHNVY.js";
 import "../chunk-7PA7FGLD.js";
 import "../chunk-XACXNDFL.js";
 import "../chunk-2L7PYYJK.js";

package/dist/core/select.js

@@ -7,8 +7,8 @@ import {
   stabilizeIncumbentChallenger,
   stabilizePresenceGate,
   stabilizeSelectionHysteresis
-} from "../chunk-QAALM5BW.js";
-import "../chunk-ABJBQCW2.js";
+} from "../chunk-3SXCFAND.js";
+import "../chunk-TABHHNVY.js";
 import "../chunk-2ESYSVXG.js";
 
 // ../execution/core/src/select/errorCodes.ts

package/dist/core.js

@@ -10,15 +10,15 @@ import {
   ensureEven,
   extractCaptionWordsFromDoc,
   isEmphasized
-} from "./chunk-XT3SK7HR.js";
+} from "./chunk-LB54TVWM.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-QISFYLBB.js";
-import "./chunk-QAALM5BW.js";
+import "./chunk-3SXCFAND.js";
 import "./chunk-VZ7TYX6Z.js";
 import "./chunk-DENF4TPI.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-ABJBQCW2.js";
+import "./chunk-TABHHNVY.js";
 import "./chunk-7PA7FGLD.js";
 import "./chunk-XACXNDFL.js";
 import "./chunk-2L7PYYJK.js";

package/dist/director/ai-sdk.js

@@ -10,13 +10,13 @@ import {
   dataChunk,
   generationArtifactFromToolResult,
   projectDirectorHistory
-} from "../chunk-JEJKLW2N.js";
-import "../chunk-2RVANTUG.js";
+} from "../chunk-ZS2WRJZ4.js";
+import "../chunk-2FKR6UTY.js";
 import "../chunk-73DQTUWY.js";
 import "../chunk-BADZHXLR.js";
 import "../chunk-U3JPILZS.js";
 import "../chunk-XELS2BGA.js";
-import "../chunk-ABJBQCW2.js";
+import "../chunk-TABHHNVY.js";
 import "../chunk-2ESYSVXG.js";
 export {
   CueFrameIteration,

package/dist/director/domain.js

@@ -9,7 +9,7 @@ import {
   ProjectRef,
   chatErrorViewFromEnvelope,
   chatErrorViewFromUnknown
-} from "../chunk-2RVANTUG.js";
+} from "../chunk-2FKR6UTY.js";
 import {
   ClientRequestId,
   GenerateMediaCommand,
@@ -31,7 +31,7 @@ import {
 import "../chunk-BADZHXLR.js";
 import "../chunk-U3JPILZS.js";
 import "../chunk-XELS2BGA.js";
-import "../chunk-ABJBQCW2.js";
+import "../chunk-TABHHNVY.js";
 import "../chunk-2ESYSVXG.js";
 export {
   ChatErrorView,

package/dist/director.js

@@ -10,7 +10,7 @@ import {
   dataChunk,
   generationArtifactFromToolResult,
   projectDirectorHistory
-} from "./chunk-JEJKLW2N.js";
+} from "./chunk-ZS2WRJZ4.js";
 import "./chunk-FTVZF4GO.js";
 import {
   ChatErrorView,
@@ -22,7 +22,7 @@ import {
   ProjectRef,
   chatErrorViewFromEnvelope,
   chatErrorViewFromUnknown
-} from "./chunk-2RVANTUG.js";
+} from "./chunk-2FKR6UTY.js";
 import {
   ClientRequestId,
   GenerateMediaCommand,
@@ -44,7 +44,7 @@ import {
 import "./chunk-BADZHXLR.js";
 import "./chunk-U3JPILZS.js";
 import "./chunk-XELS2BGA.js";
-import "./chunk-ABJBQCW2.js";
+import "./chunk-TABHHNVY.js";
 import "./chunk-2ESYSVXG.js";
 export {
   ChatErrorView,

package/dist/errors.js

@@ -5,7 +5,7 @@ import {
   encodeError,
   scrubSensitive,
   toWireEnvelope
-} from "./chunk-ABJBQCW2.js";
+} from "./chunk-TABHHNVY.js";
 import "./chunk-2ESYSVXG.js";
 export {
   CueframeError,

package/dist/render-harness/cardAssetAdmission.js

@@ -1,7 +1,7 @@
 import {
   assertCardHtmlAssetFree
-} from "../chunk-PMBPLTKU.js";
-import "../chunk-ABJBQCW2.js";
+} from "../chunk-I3TP2HIJ.js";
+import "../chunk-TABHHNVY.js";
 import "../chunk-2ESYSVXG.js";
 export {
   assertCardHtmlAssetFree

package/dist/render-harness.js

@@ -1,6 +1,6 @@
 import {
   assertCardHtmlAssetFree
-} from "./chunk-PMBPLTKU.js";
+} from "./chunk-I3TP2HIJ.js";
 import {
   assertNoRemoteRefs,
   assetSlots,
@@ -42,17 +42,17 @@ import {
   parseSceneComponentCaptureIntentV1,
   prepareSceneShotRenderInput,
   readSceneShotManifest
-} from "./chunk-XT3SK7HR.js";
+} from "./chunk-LB54TVWM.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-QISFYLBB.js";
-import "./chunk-QAALM5BW.js";
+import "./chunk-3SXCFAND.js";
 import "./chunk-VZ7TYX6Z.js";
 import "./chunk-DENF4TPI.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";
 import {
   CueframeError
-} from "./chunk-ABJBQCW2.js";
+} from "./chunk-TABHHNVY.js";
 import "./chunk-7PA7FGLD.js";
 import {
   evaluateScene,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cueframe/kernel",
-  "version": "0.2.28",
+  "version": "0.2.30",
   "type": "module",
   "description": "Publish-only aggregate of CueFrame's isomorphic kernel packages — composition, primitives, authoring, MCP, and friends shipped as one npm artifact. Members remain separate workspace packages; this only changes what ships.",
   "files": [
@@ -16,26 +16,26 @@
   "devDependencies": {
     "tsup": "^8.3.5",
     "typescript": "^5.9.3",
+    "@cueframe/animate": "0.1.0",
+    "@cueframe/cloud-import": "0.1.0",
     "@cueframe/account-model": "0.1.0",
     "@cueframe/authoring": "0.1.0",
-    "@cueframe/composition-ops": "0.1.0",
+    "@cueframe/composition": "0.1.0",
     "@cueframe/component-runtime": "0.1.0",
-    "@cueframe/cloud-import": "0.1.0",
-    "@cueframe/animate": "0.1.0",
     "@cueframe/core": "0.1.0",
-    "@cueframe/composition": "0.1.0",
+    "@cueframe/brand-derivation": "0.1.0",
+    "@cueframe/media-model": "0.1.0",
     "@cueframe/director": "0.1.0",
     "@cueframe/compose": "0.1.0",
-    "@cueframe/media-model": "0.1.0",
-    "@cueframe/mcp": "0.1.0",
     "@cueframe/foundation": "0.1.0",
-    "@cueframe/errors": "0.1.0",
     "@cueframe/nle-export": "0.1.0",
+    "@cueframe/perception": "0.1.0",
     "@cueframe/plane": "0.1.0",
     "@cueframe/primitives": "0.1.0",
-    "@cueframe/brand-derivation": "0.1.0",
-    "@cueframe/perception": "0.1.0",
-    "@cueframe/render-harness": "0.1.0"
+    "@cueframe/errors": "0.1.0",
+    "@cueframe/composition-ops": "0.1.0",
+    "@cueframe/render-harness": "0.1.0",
+    "@cueframe/mcp": "0.1.0"
   },
   "peerDependencies": {
     "gsap": "3.13.0",