@blockcast/mmt-container 0.3.0 → 0.4.0-main.1cd3cdea89da

package/dist/repair-fetch.d.ts

@@ -1,14 +1,19 @@
 /**
  * D-28 shared repair-fetch scheduler.
  *
- * Player-agnostic orchestration for per-SBN on-demand MoQ FEC repair
+ * Player-agnostic orchestration for per-block on-demand MoQ FEC repair
  * backfill. Each player (moqtail client, hang watch, Shaka MSF bridge)
- * supplies only its protocol verb via {@link RepairFetchTransport}:
+ * supplies only its protocol verb via {@link RepairFetchTransport}, fetching
+ * one block's repair group. Blocks are `iso-ssbg1-v1` (ISO/IEC 23008-1
+ * ssbg_mode1, the only FEC block profile), so that group's MoQ id is the
+ * 62-bit wrap-epoch-extended SS_Start, `extSsStart(wrapEpoch, ssStart)` from
+ * `@blockcast/mmt-fec` -- never the 32-bit block key itself (see
+ * `RepairFetchRequest.sbn`):
  *
- *   - moqtail: standalone FETCH (FetchType.Standalone) for group [sbn, sbn+1)
- *   - moq-lite/hang: Subscribe with startGroup=sbn, endGroup=sbn (the relay
- *     propagates startGroup upstream to pull the past group from the origin's
- *     producer cache)
+ *   - moqtail: standalone FETCH (FetchType.Standalone) of that one group
+ *   - moq-lite/hang: Subscribe with startGroup = endGroup = that group (the
+ *     relay propagates startGroup upstream to pull the past group from the
+ *     origin's producer cache)
  *
  * Everything else — registration, fire-time repair-track resolution,
  * keyframe-first admission, preemption, feeding symbols, and in-flight slot
@@ -52,13 +57,36 @@
  * than sent and cancelled -- and an admitted FETCH holds the block open to
  * that deadline, so the multicast span elapsing never aborts it.
  *
+ * Keyframe late-repair budget: a block that may hold a RAP may be given a
+ * longer deadline than the playout budget (`keyframeRepairBudgetMs`). Losing
+ * such a block costs every frame up to the next keyframe, so holding it open
+ * for a FETCH that lands within the budget trades a short hold for a GOP-long
+ * freeze. At a small playout budget (a low-latency target) the presentation
+ * deadline alone leaves less than one round trip by the time the multicast
+ * wait gives up on the block, so every keyframe request would be refused
+ * (`rtt-exceeds-budget`). Eligible (`keyframeBudgetEligible`): a `keyframe`
+ * block (in-band RAP evidence), and an `unknown` block only while its
+ * stream's classifier is `classifying`, where `unknown` means the window rule
+ * could not exclude a RAP. Under `all-protected` every block reads `unknown`
+ * whatever it holds, so there only RAP evidence earns the budget. Never
+ * audio (P1) or delta (P2), and never a block its repair group cannot
+ * complete (received sources + RSB_length < K'). The hold ends when its
+ * FETCH ends without making the block decodable, not at the budget.
+ *
+ * Every deadline is capped by the release gate's hold ceiling measured the
+ * way the gate measures it: from the earliest frame it holds for the stream
+ * (a surviving frame of the block itself is routed before a repair symbol
+ * states the block, so before its anchor), never later than from the anchor.
+ * A FETCH landing after the gate forced that frame out would recover media
+ * the gate then drops as stale.
+ *
  * The scheduler arms no timers. A fetch ends when its transport completes or
  * throws, when it is preempted, when any later scheduling event finds it past
  * its presentation deadline, when its block resolves (recovered, or failed at
  * that deadline), on track reset, or on dispose.
  */
-import type { FecBlockProfile } from '@blockcast/mmt-base';
-import { type BlockClass } from './block-policy.js';
+import { type FecBlockProfile } from '@blockcast/mmt-base';
+import { type BlockClass, type ClassifierMode, type RepairPriority } from './block-policy.js';
 import type { RepairLifecycleObserver } from './multicast-manager.js';
 /**
  * The highest value in the Source Media priority range of
@@ -100,18 +128,24 @@ export interface RepairFetchRequest {
     /** Repair track whose block `sbn` is fetched. */
     readonly repairTrack: string;
     /**
-     * The block's key, by `blockProfile` (BLO-35597 D2a):
-     * - `k-padded-v1`: the source block number, which IS the repair-track MoQ
-     *   group id (fetch `[sbn, sbn]`).
-     * - `iso-ssbg1-v1`: the block's 32-bit SS_Start. The MoQ group id is the
-     *   62-bit `extSsStart(wrapEpoch, sbn)`; a receiver that knows only a lost
-     *   SS_ID fetches `repairFetchRange(lostSsId, kMax, anchor)`, where `anchor`
-     *   is `{ previousBlockStart }` (the extended start of the last block
-     *   delimited before it) or `{ reference }` (an epoch reference). Never use
-     *   it as a group id directly.
+     * The block's key: its 32-bit SS_Start (ISO/IEC 23008-1 C.5.3). The field
+     * keeps its historical name, but ssbg_mode1 blocks have no source block
+     * number (BLO-35597 D2a). The repair group's MoQ id is the 62-bit
+     * `extSsStart(wrapEpoch, sbn)`; a receiver that knows only a lost SS_ID
+     * fetches `repairFetchRange(lostSsId, kMax, anchor)`, where `anchor` is
+     * `{ previousBlockStart }` (the extended start of the last block delimited
+     * before it) or `{ reference }` (an epoch reference). Never use it as a
+     * group id directly: SS_Start wraps at 2^32, a MoQ group id never goes
+     * backwards.
      */
     readonly sbn: number;
-    /** The block profile `sbn` is keyed by (the catalog `fec.blockProfile`). */
+    /**
+     * The block profile `sbn` is keyed by: the catalog `fec.blockProfile`,
+     * which is always `iso-ssbg1-v1`. Required, and validated with
+     * `parseFecBlockProfile` when the request is queued, so a stream configured
+     * with any other token (the retired `k-padded-v1` included) never reaches
+     * the transport.
+     */
     readonly blockProfile: FecBlockProfile;
     /** The source packetId the block belongs to. */
     readonly packetId: number;
@@ -191,6 +225,22 @@ export type RepairFetchPriority = {
  *   least 192, i.e. max(repair, 192); declined when it carries none.
  */
 export declare function repairFetchSubscriberPriority(blockClass: BlockClass, target: Pick<RepairTarget, 'sourcePriority' | 'repairPriority'>): RepairFetchPriority;
+/** What `RepairFetchHost.fecManager.blockSymbolCounts` reports for one open block. */
+export interface BlockSymbolCounts {
+    readonly sources: number;
+    readonly repairs: number;
+    readonly authoredLength: number | undefined;
+    readonly repairGroupLength: number | undefined;
+}
+/**
+ * Whether a block of `blockClass` may get the keyframe late-repair budget:
+ * a `keyframe` block always (in-band RAP evidence), an `unknown` block only
+ * while its stream's classifier is `classifying` (the window rule could not
+ * exclude a RAP). An `all-protected` stream reads `unknown` for every block,
+ * delta-only ones included, so there `unknown` is no evidence of a RAP and
+ * earns no hold. Audio and delta never do.
+ */
+export declare function keyframeBudgetEligible(blockClass: BlockClass, classifierMode: ClassifierMode | undefined): boolean;
 export interface WireRepairFetchOptions {
     resolveTarget: ResolveRepairTarget;
     transport: RepairFetchTransport;
@@ -217,6 +267,20 @@ export interface WireRepairFetchOptions {
      * (`presentation-delay-unavailable`).
      */
     presentationDelayMs: (packetId: number, catalogTrackName?: string) => number;
+    /**
+     * How long after the first symbol of a block that may hold a RAP a repair
+     * FETCH of it may still land, in ms (optional). Such a block
+     * (`keyframeBudgetEligible`) gets the larger of this and
+     * `presentationDelayMs`, still never later than the release gate's hold
+     * ceiling and never earlier than the multicast wait; RTT admission is
+     * unchanged. Losing a keyframe block costs the rest of its GOP, so a player
+     * may hold the block (and the frames released after it) while its FETCH is
+     * in flight rather than freeze to the next keyframe. Absent, throwing, or
+     * not finite and positive: every block gets the presentation deadline
+     * alone. Never applied to audio, delta, or an `unknown` block of an
+     * `all-protected` stream.
+     */
+    keyframeRepairBudgetMs?: (packetId: number, catalogTrackName?: string) => number;
 }
 /** Why the D-28 layer asked for a repair: the block's class at its deadline. */
 export type RepairSubscribeCallback = (sbn: number, packetId: number, catalogTrackName: string | undefined, blockClass: BlockClass) => void;
@@ -232,17 +296,38 @@ export type RepairSkipReason =
 export interface RepairFetchHost {
     readonly fecManager: {
         blockProfileForPacket(packetId: number): FecBlockProfile | undefined;
-        repairFetchTimeoutMsForBlock(sbn: number, packetId: number, catalogTrackName?: string): number;
+        repairFetchTimeoutMsForBlock(sbn: number, packetId: number, catalogTrackName?: string): number | undefined;
         /** Receiver-local time of the block's first accepted symbol, if any. */
         blockAnchorAtMs(sbn: number, packetId: number, catalogTrackName?: string): number | undefined;
+        /** The stream's classifier mode (optional; absent reads as unknown). */
+        classifierModeFor?(packetId: number, catalogTrackName?: string): {
+            readonly mode: ClassifierMode;
+        };
+        /**
+         * An open block's received sources and distinct repair symbols, its K'
+         * (SSB_length) and RSB_length (optional). The repair group carries
+         * RSB_length symbols, so it can complete the block only when
+         * sources + RSB_length >= K'; a FETCH that ended leaving fewer than K'
+         * distinct symbols cannot be decoding it.
+         */
+        blockSymbolCounts?(sbn: number, packetId: number, catalogTrackName?: string): BlockSymbolCounts | undefined;
         /** How long a terminal block stays authoritative: the release-gate hold ceiling. */
-        terminalRetentionMsForPacket(packetId: number): number;
+        terminalRetentionMsForPacket(packetId: number): number | undefined;
         /** Keep the block open to `untilAtMs` for an admitted FETCH. */
         holdBlockForRepair(sbn: number, packetId: number, catalogTrackName: string | undefined, untilAtMs: number): boolean;
         /** The admitted FETCH ended without delivering: back to the multicast wait. */
         releaseRepairHold(sbn: number, packetId: number, catalogTrackName?: string): void;
     };
     onRepairSubscribe(cb: RepairSubscribeCallback): void;
+    /**
+     * Arrival time of the earliest frame the in-order release gate holds for
+     * the stream, or undefined (optional; absent, the block's anchor bounds the
+     * ceiling alone). The gate releases that frame `terminalRetentionMsForPacket`
+     * after it, whatever its blocks are doing.
+     */
+    earliestGatedFrameAtMs?(packetId: number, catalogTrackName?: string): number | undefined;
+    /** The keyframe budget extended a request's deadline by `extensionMs` (optional). */
+    noteKeyframeBudgetGranted?(extensionMs: number, sbn: number, packetId: number, catalogTrackName?: string): void;
     addRepairLifecycleObserver(observer: RepairLifecycleObserver): () => void;
     addTrackResetObserver(observer: (packetId: number, catalogTrackName: string) => void): () => void;
     clearRepairForBlock(sbn: number, packetId: number, catalogTrackName?: string): void;
@@ -250,11 +335,21 @@ export interface RepairFetchHost {
     noteRepairScheduling(type: 'repair-preempted' | 'repair-deferred', sbn: number, packetId: number, catalogTrackName?: string): void;
     /** A request whose wire priority the catalog could not supply. */
     noteRepairPriority(action: 'omitted' | 'declined', reason: RepairPriorityReason, blockClass: BlockClass, sbn: number, packetId: number, catalogTrackName?: string): void;
-    /** A request the scheduler did not send (see RepairSkipReason). */
+    /**
+     * A request the scheduler did not send (see RepairSkipReason).
+     * `measurement.priority` is the request's repair priority (0 keyframe or
+     * unknown, 1 audio, 2 delta).
+     */
     noteRepairSkipped(reason: RepairSkipReason, measurement: {
         readonly rttMs: number | null;
         readonly budgetMs: number;
+        readonly priority?: RepairPriority;
     }, sbn: number, packetId: number, catalogTrackName?: string): void;
+    /**
+     * A FETCH the scheduler admitted and handed to the transport (optional):
+     * every attempt, a retry or a reprioritised restart included.
+     */
+    noteRepairFetchSent?(priority: RepairPriority, sbn: number, packetId: number, catalogTrackName?: string): void;
 }
 /**
  * Wire the D-28 repair-fetch scheduler onto a MulticastManager.

package/dist/repair-fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repair-fetch.d.ts","sourceRoot":"","sources":["../src/repair-fetch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"repair-fetch.d.ts","sourceRoot":"","sources":["../src/repair-fetch.ts"],"names":[],"mappings":"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"}

package/dist/repair-fetch.js

@@ -1,27 +1,8 @@
-// src/block-policy.ts
-import { deriveFecInterleaveDepth } from "@blockcast/mmt-fec";
-function repairPriorityForClass(blockClass) {
-  switch (blockClass) {
-    case "keyframe":
-    case "unknown":
-      return 0;
-    case "audio":
-      return 1;
-    case "delta":
-      return 2;
-  }
-}
-
-// ../mmt-alta-parse/dist/index.js
+// ../mmt-base/dist/mmtp.js
 var MPU_HEADER_SIZE = 8;
 var MPU_LENGTH_FIELD_SIZE = 2;
 var MPU_HEADER_REMAINDER_SIZE = MPU_HEADER_SIZE - MPU_LENGTH_FIELD_SIZE;
 
-// ../mmt-base/dist/mmtp.js
-var MPU_HEADER_SIZE2 = 8;
-var MPU_LENGTH_FIELD_SIZE2 = 2;
-var MPU_HEADER_REMAINDER_SIZE2 = MPU_HEADER_SIZE2 - MPU_LENGTH_FIELD_SIZE2;
-
 // ../mmt-base/dist/ntp-short.js
 var NTP_SHORT_BITS = 32;
 var NTP_SHORT_MODULUS = 2 ** NTP_SHORT_BITS;
@@ -29,9 +10,33 @@ var NTP_SHORT_HALF_RANGE = 2 ** (NTP_SHORT_BITS - 1);
 
 // ../mmt-base/dist/fec-block-profile.js
 var FEC_BLOCK_PROFILES = Object.freeze([
-  "k-padded-v1",
   "iso-ssbg1-v1"
 ]);
+function isFecBlockProfile(value) {
+  return value === "iso-ssbg1-v1";
+}
+function parseFecBlockProfile(value, where) {
+  if (isFecBlockProfile(value))
+    return value;
+  if (value === void 0) {
+    throw new Error(`${where} is required: name the FEC block profile ("iso-ssbg1-v1")`);
+  }
+  throw new Error(`${where} must be "iso-ssbg1-v1" (got ${JSON.stringify(value)})`);
+}
+
+// src/block-policy.ts
+import { deriveFecInterleaveDepth } from "@blockcast/mmt-fec";
+function repairPriorityForClass(blockClass) {
+  switch (blockClass) {
+    case "keyframe":
+    case "unknown":
+      return 0;
+    case "audio":
+      return 1;
+    case "delta":
+      return 2;
+  }
+}
 
 // src/repair-layers.ts
 var REPAIR_PRIORITY_MIN = 192;
@@ -54,6 +59,10 @@ function repairFetchSubscriberPriority(blockClass, target) {
   if (!isMoqtPriority(repair)) return { kind: "decline", reason: "repair-priority-invalid" };
   return { kind: "carry", subscriberPriority: Math.max(repair, REPAIR_PRIORITY_MIN) };
 }
+function keyframeBudgetEligible(blockClass, classifierMode) {
+  if (blockClass === "keyframe") return true;
+  return blockClass === "unknown" && classifierMode === "classifying";
+}
 function wireRepairFetch(mc, opts) {
   if (!Number.isSafeInteger(opts.attemptLimit) || opts.attemptLimit < 1) {
     throw new Error(
@@ -91,6 +100,16 @@ function wireRepairFetch(mc, opts) {
     run.controller.abort();
     if (reason === "preempted") releaseHold(entry);
   };
+  const readKeyframeBudget = (packetId, catalogTrackName) => {
+    const reader = opts.keyframeRepairBudgetMs;
+    if (reader === void 0) return null;
+    try {
+      const budgetMs = reader(packetId, catalogTrackName);
+      return Number.isFinite(budgetMs) && budgetMs > 0 ? budgetMs : null;
+    } catch {
+      return null;
+    }
+  };
   const readRtt = () => {
     try {
       const rtt = opts.reliableRttMs();
@@ -108,7 +127,7 @@ function wireRepairFetch(mc, opts) {
     clearRepair(entry.sbn, entry.packetId, entry.catalogTrackName);
     mc.noteRepairSkipped(
       rttMs === null ? "rtt-unmeasured" : "rtt-exceeds-budget",
-      { rttMs, budgetMs },
+      { rttMs, budgetMs, priority: entry.priority },
       entry.sbn,
       entry.packetId,
       entry.catalogTrackName
@@ -147,6 +166,7 @@ function wireRepairFetch(mc, opts) {
   const start = (entry, counted = true) => {
     if (!admit(entry, performance.now())) return;
     if (counted) entry.attempts++;
+    mc.noteRepairFetchSent?.(entry.priority, entry.sbn, entry.packetId, entry.catalogTrackName);
     const run = { controller: new AbortController(), stopped: null };
     entry.running = run;
     mc.fecManager.holdBlockForRepair(
@@ -184,6 +204,25 @@ function wireRepairFetch(mc, opts) {
     if (urgentOutstanding()) return;
     queued.filter((entry) => entry.priority === 2).sort((a, b) => a.deadlineAt - b.deadlineAt || a.order - b.order).forEach((entry) => start(entry));
   };
+  const symbolCounts = (sbn, packetId, catalogTrackName) => {
+    try {
+      return mc.fecManager.blockSymbolCounts?.(sbn, packetId, catalogTrackName);
+    } catch {
+      return void 0;
+    }
+  };
+  const decodable = (entry) => {
+    const counts = symbolCounts(entry.sbn, entry.packetId, entry.catalogTrackName);
+    if (counts === void 0 || counts.authoredLength === void 0) return true;
+    return counts.sources + counts.repairs >= counts.authoredLength;
+  };
+  const groupCanComplete = (sbn, packetId, catalogTrackName) => {
+    const counts = symbolCounts(sbn, packetId, catalogTrackName);
+    if (counts === void 0 || counts.authoredLength === void 0 || counts.repairGroupLength === void 0) {
+      return true;
+    }
+    return counts.sources + counts.repairGroupLength >= counts.authoredLength;
+  };
   const finish = (entry, run, fed, error) => {
     if (run.stopped !== null || entry.running !== run || entries.get(entry.key) !== entry) {
       return;
@@ -191,7 +230,7 @@ function wireRepairFetch(mc, opts) {
     entry.running = null;
     if (error === void 0) {
       retire(entry);
-      if (fed === 0) {
+      if (fed === 0 || !decodable(entry)) {
         releaseHold(entry);
         clearRepair(entry.sbn, entry.packetId, entry.catalogTrackName);
       }
@@ -217,7 +256,7 @@ function wireRepairFetch(mc, opts) {
     if (profile === void 0) {
       throw new Error(`[RepairFetch] packetId=${packetId} has no configured fec.blockProfile`);
     }
-    return profile;
+    return parseFecBlockProfile(profile, `[RepairFetch] packetId=${packetId} fec.blockProfile`);
   };
   const execute = async (entry, run) => {
     let fed = 0;
@@ -265,6 +304,17 @@ function wireRepairFetch(mc, opts) {
       if (wire === null) return;
       entry2.priority = promoted;
       entry2.subscriberPriority = wire.subscriberPriority;
+      const promotedDeadline = presentationDeadlineAt(
+        entry2.sbn,
+        entry2.packetId,
+        entry2.catalogTrackName,
+        performance.now(),
+        event.to
+      );
+      if (promotedDeadline !== null && promotedDeadline.deadlineAt > entry2.deadlineAt) {
+        entry2.deadlineAt = promotedDeadline.deadlineAt;
+        noteBudget(entry2, promotedDeadline.extensionMs);
+      }
       if (entry2.running) {
         stop(entry2, "reprioritized");
         start(entry2, false);
@@ -283,10 +333,12 @@ function wireRepairFetch(mc, opts) {
     else if (entry.priority === 2 && entry.attempts === 0) note("repair-deferred", entry);
     dispatch();
   });
-  const presentationDeadlineAt = (sbn, packetId, catalogTrackName, now) => {
-    const waitDeadlineAt = now + mc.fecManager.repairFetchTimeoutMsForBlock(sbn, packetId, catalogTrackName);
+  const presentationDeadlineAt = (sbn, packetId, catalogTrackName, now, blockClass) => {
+    const waitMs = mc.fecManager.repairFetchTimeoutMsForBlock(sbn, packetId, catalogTrackName);
+    if (waitMs === void 0) return null;
+    const waitDeadlineAt = now + waitMs;
     const anchor = mc.fecManager.blockAnchorAtMs(sbn, packetId, catalogTrackName);
-    if (anchor === void 0) return waitDeadlineAt;
+    if (anchor === void 0) return { deadlineAt: waitDeadlineAt, extensionMs: 0 };
     let delayMs;
     try {
       delayMs = opts.presentationDelayMs(packetId, catalogTrackName);
@@ -294,8 +346,33 @@ function wireRepairFetch(mc, opts) {
       return null;
     }
     if (!(Number.isFinite(delayMs) && delayMs > 0)) return null;
-    const ceilingAt = anchor + mc.fecManager.terminalRetentionMsForPacket(packetId);
-    return Math.max(waitDeadlineAt, Math.min(anchor + delayMs, ceilingAt));
+    const retentionMs = mc.fecManager.terminalRetentionMsForPacket(packetId);
+    if (retentionMs === void 0) return null;
+    const ceilingAt = Math.min(anchor, earliestGatedFrameAt(packetId, catalogTrackName) ?? anchor) + retentionMs;
+    const deadlineAt = (delay) => Math.max(waitDeadlineAt, Math.min(anchor + delay, ceilingAt));
+    const base = deadlineAt(delayMs);
+    const budgetMs = keyframeBudgetEligible(blockClass, classifierMode(packetId, catalogTrackName)) && groupCanComplete(sbn, packetId, catalogTrackName) ? readKeyframeBudget(packetId, catalogTrackName) : null;
+    if (budgetMs === null || budgetMs <= delayMs) return { deadlineAt: base, extensionMs: 0 };
+    const extended = deadlineAt(budgetMs);
+    return { deadlineAt: extended, extensionMs: extended - base };
+  };
+  const earliestGatedFrameAt = (packetId, catalogTrackName) => {
+    try {
+      const at = mc.earliestGatedFrameAtMs?.(packetId, catalogTrackName);
+      return at !== void 0 && Number.isFinite(at) ? at : void 0;
+    } catch {
+      return void 0;
+    }
+  };
+  const classifierMode = (packetId, catalogTrackName) => {
+    try {
+      return mc.fecManager.classifierModeFor?.(packetId, catalogTrackName).mode;
+    } catch {
+      return void 0;
+    }
+  };
+  const noteBudget = (entry, extensionMs) => {
+    if (extensionMs > 0) mc.noteKeyframeBudgetGranted?.(extensionMs, entry.sbn, entry.packetId, entry.catalogTrackName);
   };
   mc.onRepairSubscribe((sbn, packetId, catalogTrackName, blockClass) => {
     if (disposed) {
@@ -333,12 +410,13 @@ function wireRepairFetch(mc, opts) {
       return;
     }
     const now = performance.now();
-    const deadlineAt = presentationDeadlineAt(sbn, packetId, catalogTrackName, now);
-    if (deadlineAt === null) {
+    const priority = repairPriorityForClass(blockClass);
+    const deadline = presentationDeadlineAt(sbn, packetId, catalogTrackName, now, blockClass);
+    if (deadline === null) {
       clearRepair(sbn, packetId, catalogTrackName);
       mc.noteRepairSkipped(
         "presentation-delay-unavailable",
-        { rttMs: readRtt(), budgetMs: 0 },
+        { rttMs: readRtt(), budgetMs: 0, priority },
         sbn,
         packetId,
         catalogTrackName
@@ -350,14 +428,15 @@ function wireRepairFetch(mc, opts) {
       ...identity,
       repairTrack: target.repairTrack,
       blockProfile,
-      priority: repairPriorityForClass(blockClass),
+      priority,
       subscriberPriority: wire.subscriberPriority,
-      deadlineAt,
+      deadlineAt: deadline.deadlineAt,
       order: enqueueOrder++,
       attempts: 0,
       running: null
     };
     entries.set(key, entry);
+    noteBudget(entry, deadline.extensionMs);
     if (entry.priority < 2) preemptDeltas();
     dispatch();
   });
@@ -375,6 +454,7 @@ function wireRepairFetch(mc, opts) {
 }
 export {
   SOURCE_MEDIA_PRIORITY_MAX,
+  keyframeBudgetEligible,
   repairFetchSubscriberPriority,
   wireRepairFetch
 };