urma-mcp 0.1.0-rc.1

package/dist/src/acquisition/transcript.js

@@ -0,0 +1,367 @@
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { UrmaError } from "../core/errors.js";
+import { deterministicRequestKey } from "../core/request-key.js";
+import { parseTrackRef } from "../core/ids.js";
+import { BlobStore } from "../store/blob-store.js";
+import { YtDlp } from "../subprocess/ytdlp.js";
+import { ensureRemoteProxy } from "../remote/worker.js";
+import { collectBinaryVersions } from "../subprocess/versions.js";
+import { URMA_VERSION } from "../version.js";
+import { parseLocalSnapshot } from "../sources/local.js";
+import { startAcquisition } from "./records.js";
+import { assertRemoteDirectoryWithinBudget, withRemoteAcquisitionDirectory, } from "./remote-budget.js";
+function cleanText(value) {
+    return value
+        .replace(/<\/?(?:c(?:\.[^>]*)?|v(?:\s[^>]*)?|i|b|u|ruby|rt)>/gi, "")
+        .replace(/<\d{1,2}:\d{2}(?::\d{2})?\.\d{3}>/g, "")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/[ \t]+/g, " ")
+        .replace(/\s*\n\s*/g, " ")
+        .trim();
+}
+function timeMs(value) {
+    const pieces = value.split(":").map(Number);
+    return Math.round(pieces.reduce((total, piece) => total * 60 + piece, 0) * 1000);
+}
+export function parseJson3Captions(value, trackId) {
+    const document = JSON.parse(value);
+    const output = [];
+    for (const event of document.events ?? []) {
+        const startMs = Number(event.tStartMs);
+        const durationMs = Number(event.dDurationMs ?? 0);
+        const chunks = Array.isArray(event.segs)
+            ? event.segs
+            : [];
+        const text = cleanText(chunks
+            .map((chunk) => (typeof chunk.utf8 === "string" ? chunk.utf8 : ""))
+            .join(""));
+        if (!Number.isFinite(startMs) || !text)
+            continue;
+        output.push({
+            trackId,
+            startMs: Math.max(0, Math.round(startMs)),
+            endMs: Math.max(Math.round(startMs), Math.round(startMs + (Number.isFinite(durationMs) ? durationMs : 0))),
+            text,
+            ordinal: output.length,
+        });
+    }
+    return output;
+}
+export function parseVttCaptions(value, trackId) {
+    const blocks = value
+        .replace(/^\uFEFF/, "")
+        .replace(/\r\n/g, "\n")
+        .split(/\n{2,}/);
+    const output = [];
+    const timing = /(?<start>(?:\d{1,2}:)?\d{2}:\d{2}\.\d{3})\s+-->\s+(?<end>(?:\d{1,2}:)?\d{2}:\d{2}\.\d{3})/;
+    for (const block of blocks) {
+        const lines = block.split("\n");
+        const index = lines.findIndex((line) => timing.test(line));
+        const match = index < 0 ? null : lines[index].match(timing);
+        const text = cleanText(lines.slice(index + 1).join("\n"));
+        if (!match?.groups || !text)
+            continue;
+        output.push({
+            trackId,
+            startMs: timeMs(match.groups.start),
+            endMs: timeMs(match.groups.end),
+            text,
+            ordinal: output.length,
+        });
+    }
+    return output;
+}
+export function parseSrtCaptions(value, trackId) {
+    return parseVttCaptions(value.replace(/(\d{2}:\d{2}:\d{2}),(\d{3})/g, "$1.$2"), trackId);
+}
+export function chooseTrack(tracks, preferredLanguage = null) {
+    return ([...tracks].sort((a, b) => {
+        const preferred = preferredLanguage?.toLowerCase() ?? null;
+        const language = (track) => {
+            const value = track.language.toLowerCase();
+            if (preferred && value === preferred)
+                return 0;
+            if (preferred && value.split("-")[0] === preferred.split("-")[0]) {
+                return 1;
+            }
+            if (value === "en")
+                return 2;
+            if (value.startsWith("en-"))
+                return 3;
+            return 4;
+        };
+        const kind = (track) => track.kind === "manual"
+            ? 0
+            : track.kind === "sidecar"
+                ? 1
+                : track.kind === "automatic"
+                    ? 2
+                    : 3;
+        const lexical = a.language < b.language
+            ? -1
+            : a.language > b.language
+                ? 1
+                : a.trackRef < b.trackRef
+                    ? -1
+                    : a.trackRef > b.trackRef
+                        ? 1
+                        : 0;
+        return kind(a) - kind(b) || language(a) - language(b) || lexical;
+    })[0] ?? null);
+}
+export function selectTrack(source, requested) {
+    if (requested !== undefined) {
+        let ref;
+        try {
+            ref = parseTrackRef(requested);
+        }
+        catch (error) {
+            throw new UrmaError("INVALID_SOURCE", "Caption trackRef is malformed or does not belong to this source revision", { cause: error });
+        }
+        const selected = source.captionTracks.find((track) => track.trackRef === ref);
+        if (!selected) {
+            throw new UrmaError("INVALID_SOURCE", "Caption trackRef is unavailable for this source revision; use a trackRef returned by inspect_video");
+        }
+        return selected;
+    }
+    const preferred = typeof source.safeMetadata.originalLanguage === "string"
+        ? source.safeMetadata.originalLanguage
+        : null;
+    const selected = chooseTrack(source.captionTracks, preferred);
+    if (!selected) {
+        throw new UrmaError("CAPTIONS_UNAVAILABLE", "This source has no supported native or allowed local sidecar caption track; Urma v0.1 does not perform speech-to-text");
+    }
+    return selected;
+}
+export function transcriptTrackId(trackRef) {
+    return `track:${trackRef.slice("urma:track:".length)}`;
+}
+export class TranscriptAcquirer {
+    config;
+    store;
+    blobs;
+    remoteContext;
+    constructor(config, store, blobs, remoteContext = null) {
+        this.config = config;
+        this.store = store;
+        this.blobs = blobs;
+        this.remoteContext = remoteContext;
+    }
+    async ensure(source, investigationRef, requestedTrackRef, signal) {
+        const selected = selectTrack(source, requestedTrackRef);
+        const trackId = transcriptTrackId(selected.trackRef);
+        const cached = this.store
+            .listTranscriptTracks(source.sourceRef, source.revision)
+            .find((track) => track.id === trackId);
+        if (cached) {
+            const artifacts = this.store.listArtifacts(source.sourceRef, source.revision);
+            const artifact = artifacts.find((item) => item.kind === "caption" && item.params.trackId === cached.id);
+            if (artifact) {
+                try {
+                    await this.blobs.verify(artifact.artifactId, artifact.blobPath);
+                    const acquisition = startAcquisition(this.store, {
+                        sourceRef: source.sourceRef,
+                        sourceRevision: source.revision,
+                        investigationRef,
+                        operation: "transcript-cache",
+                        requestKey: `cache:${cached.id}`,
+                        method: "cache",
+                        debug: this.config.debug,
+                    });
+                    acquisition.succeed({
+                        networkBytes: 0,
+                        networkAccountingComplete: true,
+                        metadata: {
+                            artifactId: artifact.artifactId,
+                            trackRef: selected.trackRef,
+                            providerTrackId: selected.providerTrackId,
+                            cacheHit: true,
+                        },
+                    });
+                    return {
+                        track: cached,
+                        segments: this.store.listTranscriptSegments(cached.id),
+                        artifact,
+                        cacheHit: true,
+                    };
+                }
+                catch {
+                }
+            }
+        }
+        if (selected.kind === "unknown") {
+            throw new UrmaError("CAPTIONS_UNAVAILABLE", "The selected caption track has an unknown origin and cannot be acquired safely; choose a manual, automatic, or sidecar track");
+        }
+        if (selected.kind !== "sidecar") {
+            await ensureRemoteProxy(this.remoteContext);
+        }
+        const requestKey = deterministicRequestKey(source.revision, "transcript", {
+            trackRef: selected.trackRef,
+            language: selected.language,
+            kind: selected.kind,
+        }, "transcript-parser");
+        const acquisition = startAcquisition(this.store, {
+            sourceRef: source.sourceRef,
+            sourceRevision: source.revision,
+            investigationRef,
+            operation: "acquire-transcript",
+            requestKey,
+            method: selected.kind === "sidecar" ? "local-file" : "yt-dlp-caption",
+            debug: this.config.debug,
+        });
+        try {
+            let body;
+            let extension;
+            let bytes;
+            if (selected.kind === "sidecar") {
+                const snapshot = source.kind === "local"
+                    ? parseLocalSnapshot(source.safeMetadata.localSnapshot)
+                    : null;
+                if (!snapshot?.caption) {
+                    throw new UrmaError("CAPTIONS_UNAVAILABLE", "Local source advertised captions but its pinned sidecar content is unavailable; inspect the source again");
+                }
+                bytes = await this.blobs.read(snapshot.caption.artifactId, snapshot.caption.blobPath, this.config.limits.resourceBytes);
+                body = bytes.toString("utf8");
+                extension = snapshot.caption.extension ??
+                    `.${selected.formats[0] ?? "vtt"}`.toLowerCase();
+            }
+            else {
+                const downloaded = await withRemoteAcquisitionDirectory(this.config, "caption", this.config.limits.resourceBytes, signal, async (temporary, remoteSignal) => {
+                    const flag = selected.kind === "manual"
+                        ? "--write-subs"
+                        : "--write-auto-subs";
+                    await new YtDlp(this.config, undefined, this.remoteContext).run([
+                        "--skip-download",
+                        flag,
+                        "--sub-langs",
+                        selected.language,
+                        "--sub-format",
+                        selected.formats.length > 0
+                            ? `${selected.formats.join("/")}/best`
+                            : "json3/vtt/srt/best",
+                        "--paths",
+                        temporary,
+                        "-o",
+                        "caption.%(ext)s",
+                        source.canonicalLocator,
+                    ], {
+                        signal: remoteSignal,
+                        timeoutMs: this.config.limits.maxRemoteAcquisitionWallMs,
+                        remote: true,
+                    });
+                    await assertRemoteDirectoryWithinBudget(temporary, this.config.limits.resourceBytes, "caption");
+                    const names = (await readdir(temporary)).filter((item) => /^caption(?:\.[A-Za-z0-9._-]{1,128})?\.(?:json3|vtt|srt)$/u.test(item));
+                    const preferredNames = selected.formats
+                        .map((format) => `.${format.toLowerCase()}`)
+                        .flatMap((suffix) => names.filter((item) => item.toLowerCase().endsWith(suffix)));
+                    const fallbackNames = names.filter((item) => item.toLowerCase().endsWith(".json3") ||
+                        item.toLowerCase().endsWith(".vtt") ||
+                        item.toLowerCase().endsWith(".srt"));
+                    const candidates = preferredNames.length > 0 ? preferredNames : fallbackNames;
+                    if (candidates.length !== 1) {
+                        throw new UrmaError("CAPTIONS_UNAVAILABLE", candidates.length === 0
+                            ? "yt-dlp completed without a JSON3, VTT, or SRT caption artifact; update yt-dlp or choose another captioned source"
+                            : "yt-dlp completed with ambiguous caption artifacts for the selected track");
+                    }
+                    return {
+                        bytes: await readFile(path.join(temporary, candidates[0])),
+                        extension: path.extname(candidates[0]).toLowerCase(),
+                    };
+                });
+                bytes = downloaded.bytes;
+                body = bytes.toString("utf8");
+                extension = downloaded.extension;
+            }
+            const parsed = extension === ".json3"
+                ? parseJson3Captions(body, trackId)
+                : extension === ".srt"
+                    ? parseSrtCaptions(body, trackId)
+                    : parseVttCaptions(body, trackId);
+            if (parsed.length === 0) {
+                throw new UrmaError("CAPTIONS_UNAVAILABLE", "Caption artifact parsed successfully but contained no textual timestamped segments");
+            }
+            if (parsed.some((segment) => segment.text.length > 16_000)) {
+                throw new UrmaError("OUTPUT_LIMIT_EXCEEDED", "Caption artifact contains an individual cue above the 16,000-character safety ceiling; split or repair the caption track before importing it");
+            }
+            const blob = await this.blobs.put(bytes, () => {
+                if (parsed.length === 0)
+                    throw new Error("empty captions");
+            });
+            const acquiredAt = new Date().toISOString();
+            const versions = await collectBinaryVersions(this.config, selected.kind === "sidecar" ? [] : ["ytdlp"], signal);
+            const track = {
+                id: trackId,
+                sourceRef: source.sourceRef,
+                sourceRevision: source.revision,
+                language: selected.language,
+                kind: selected.kind,
+                providerTrackId: selected.providerTrackId,
+                acquiredAt,
+                metadata: {
+                    parser: "transcript-parser",
+                    segmentCount: parsed.length,
+                    trackRef: selected.trackRef,
+                    displayName: selected.displayName,
+                },
+            };
+            this.store.putTranscript(track, parsed);
+            const artifact = {
+                artifactId: blob.artifactId,
+                sourceRef: source.sourceRef,
+                sourceRevision: source.revision,
+                kind: "caption",
+                role: "evidence",
+                mimeType: extension === ".json3"
+                    ? "application/json"
+                    : extension === ".srt"
+                        ? "application/x-subrip"
+                        : "text/vtt",
+                sha256: blob.sha256,
+                byteSize: blob.byteSize,
+                blobPath: blob.relativePath,
+                startMs: 0,
+                endMs: parsed.at(-1).endMs,
+                params: {
+                    trackId,
+                    trackRef: selected.trackRef,
+                    language: selected.language,
+                    kind: selected.kind,
+                    providerTrackId: selected.providerTrackId,
+                },
+                producer: {
+                    version: "transcript-parser",
+                    urmaVersion: URMA_VERSION,
+                    ...versions,
+                },
+                createdAt: acquiredAt,
+            };
+            this.store.putArtifact(artifact, { requestKey, operation: "transcript" });
+            acquisition.succeed({
+                networkBytes: selected.kind === "sidecar" ? 0 : null,
+                networkAccountingComplete: selected.kind === "sidecar",
+                metadata: {
+                    artifactId: artifact.artifactId,
+                    trackRef: selected.trackRef,
+                    providerTrackId: selected.providerTrackId,
+                    segments: parsed.length,
+                    ...versions,
+                },
+            });
+            return {
+                track,
+                segments: this.store.listTranscriptSegments(track.id),
+                artifact,
+                cacheHit: false,
+            };
+        }
+        catch (error) {
+            acquisition.fail(error);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=transcript.js.map

package/dist/src/acquisition/transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../../../src/acquisition/transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAOnD,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAA+B,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,oBAAoB,CAAC;AAE5B,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK;SACT,OAAO,CAAC,sDAAsD,EAAE,EAAE,CAAC;SACnE,OAAO,CAAC,oCAAoC,EAAE,EAAE,CAAC;SACjD,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC;SACzB,IAAI,EAAE,CAAC;AACZ,CAAC;AACD,SAAS,MAAM,CAAC,KAAa;IAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,KAAK,CACf,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,GAAG,IAAI,CAC9D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,OAAe;IAEf,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAEhC,CAAC;IACF,MAAM,MAAM,GAAgC,EAAE,CAAC;IAC/C,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;YACtC,CAAC,CAAE,KAAK,CAAC,IAAuC;YAChD,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,GAAG,SAAS,CACpB,MAAM;aACH,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aAClE,IAAI,CAAC,EAAE,CAAC,CACZ,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI;YAAE,SAAS;QACjD,MAAM,CAAC,IAAI,CAAC;YACV,OAAO;YACP,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACzC,KAAK,EAAE,IAAI,CAAC,GAAG,CACb,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EACnB,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACrE;YACD,IAAI;YACJ,OAAO,EAAE,MAAM,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AACD,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,OAAe;IAEf,MAAM,MAAM,GAAG,KAAK;SACjB,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnB,MAAM,MAAM,GAAgC,EAAE,CAAC;IAC/C,MAAM,MAAM,GACV,2FAA2F,CAAC;IAC9F,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,IAAI;YAAE,SAAS;QACtC,MAAM,CAAC,IAAI,CAAC;YACV,OAAO;YACP,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAM,CAAC;YACpC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAI,CAAC;YAChC,IAAI;YACJ,OAAO,EAAE,MAAM,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AACD,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,OAAe;IAEf,OAAO,gBAAgB,CACrB,KAAK,CAAC,OAAO,CAAC,8BAA8B,EAAE,OAAO,CAAC,EACtD,OAAO,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,MAAsC,EACtC,iBAAiB,GAAkB,IAAI;IAEvC,OAAO,CACL,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACxB,MAAM,SAAS,GAAG,iBAAiB,EAAE,WAAW,EAAE,IAAI,IAAI,CAAC;QAC3D,MAAM,QAAQ,GAAG,CAAC,KAA0B,EAAE,EAAE;YAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC3C,IAAI,SAAS,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,CAAC,CAAC;YAC/C,IAAI,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjE,OAAO,CAAC,CAAC;YACX,CAAC;YACD,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,CAAC,CAAC;YAC7B,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC;YACtC,OAAO,CAAC,CAAC;QACX,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,CAAC,KAA0B,EAAE,EAAE,CAC1C,KAAK,CAAC,IAAI,KAAK,QAAQ;YACrB,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;gBAC1B,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW;oBAC5B,CAAC,CAAC,CAAC;oBACH,CAAC,CAAC,CAAC,CAAC;QACR,MAAM,OAAO,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ;YACrC,CAAC,CAAC,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ;gBACzB,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ;oBACzB,CAAC,CAAC,CAAC,CAAC;oBACJ,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ;wBACzB,CAAC,CAAC,CAAC;wBACH,CAAC,CAAC,CAAC,CAAC;QACN,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IACnE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CACd,CAAC;AACJ,CAAC;AACD,MAAM,UAAU,WAAW,CACzB,MAAsB,EACtB,SAA6B;IAE7B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,SAAS,CACjB,gBAAgB,EAChB,0EAA0E,EAC1E,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CACxC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,GAAG,CAClC,CAAC;QACF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,SAAS,CACjB,gBAAgB,EAChB,oGAAoG,CACrG,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,YAAY,CAAC,gBAAgB,KAAK,QAAQ;QACxE,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,gBAAgB;QACtC,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,SAAS,CACjB,sBAAsB,EACtB,uHAAuH,CACxH,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AACD,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,OAAO,SAAS,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,OAAO,kBAAkB;IAElB,MAAM;IACN,KAAK;IACL,KAAK;IACL,aAAa;IAJxB,YACW,MAAkB,EAClB,KAAgB,EAChB,KAAgB,EAChB,aAAa,GAAkC,IAAI;sBAHnD,MAAM;qBACN,KAAK;qBACL,KAAK;6BACL,aAAa;IACrB,CAAC;IACJ,KAAK,CAAC,MAAM,CACV,MAAsB,EACtB,gBAAkC,EAClC,iBAA0B,EAC1B,MAAoB;QAOpB,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK;aACtB,oBAAoB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC;aACvD,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;QACzC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CACxC,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,QAAQ,CAChB,CAAC;YACF,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAC7B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,EAAE,CACvE,CAAC;YACF,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;oBAChE,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE;wBAC/C,SAAS,EAAE,MAAM,CAAC,SAAS;wBAC3B,cAAc,EAAE,MAAM,CAAC,QAAQ;wBAC/B,gBAAgB;wBAChB,SAAS,EAAE,kBAAkB;wBAC7B,UAAU,EAAE,SAAS,MAAM,CAAC,EAAE,EAAE;wBAChC,MAAM,EAAE,OAAO;wBACf,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;qBACzB,CAAC,CAAC;oBACH,WAAW,CAAC,OAAO,CAAC;wBAClB,YAAY,EAAE,CAAC;wBACf,yBAAyB,EAAE,IAAI;wBAC/B,QAAQ,EAAE;4BACR,UAAU,EAAE,QAAQ,CAAC,UAAU;4BAC/B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;4BAC3B,eAAe,EAAE,QAAQ,CAAC,eAAe;4BACzC,QAAQ,EAAE,IAAI;yBACf;qBACF,CAAC,CAAC;oBACH,OAAO;wBACL,KAAK,EAAE,MAAM;wBACb,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;wBACtD,QAAQ;wBACR,QAAQ,EAAE,IAAI;qBACf,CAAC;gBACJ,CAAC;gBAAC,MAAM,CAAC;gBACT,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,SAAS,CACjB,sBAAsB,EACtB,8HAA8H,CAC/H,CAAC;QACJ,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,UAAU,GAAG,uBAAuB,CACxC,MAAM,CAAC,QAAQ,EACf,YAAY,EACZ;YACE,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI;SACpB,EACD,mBAAmB,CACpB,CAAC;QACF,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE;YAC/C,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,cAAc,EAAE,MAAM,CAAC,QAAQ;YAC/B,gBAAgB;YAChB,SAAS,EAAE,oBAAoB;YAC/B,UAAU;YACV,MAAM,EAAE,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,gBAAgB;YACrE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SACzB,CAAC,CAAC;QACH,IAAI,CAAC;YACH,IAAI,IAAY,CAAC;YACjB,IAAI,SAAiB,CAAC;YACtB,IAAI,KAAa,CAAC;YAClB,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,KAAK,OAAO;oBACtC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC;oBACvD,CAAC,CAAC,IAAI,CAAC;gBACT,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;oBACvB,MAAM,IAAI,SAAS,CACjB,sBAAsB,EACtB,0GAA0G,CAC3G,CAAC;gBACJ,CAAC;gBACD,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAC3B,QAAQ,CAAC,OAAO,CAAC,UAAU,EAC3B,QAAQ,CAAC,OAAO,CAAC,QAAQ,EACzB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CACjC,CAAC;gBACF,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC9B,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS;oBACpC,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,WAAW,EAAE,CAAC;YACrD,CAAC;iBAAM,CAAC;gBACN,MAAM,UAAU,GAAG,MAAM,8BAA8B,CACrD,IAAI,CAAC,MAAM,EACX,SAAS,EACT,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,EAChC,MAAM,EACN,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE;oBAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,KAAK,QAAQ;wBACrC,CAAC,CAAC,cAAc;wBAChB,CAAC,CAAC,mBAAmB,CAAC;oBACxB,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,CAC7D;wBACE,iBAAiB;wBACjB,IAAI;wBACJ,aAAa;wBACb,QAAQ,CAAC,QAAQ;wBACjB,cAAc;wBACd,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;4BACzB,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO;4BACtC,CAAC,CAAC,oBAAoB;wBACxB,SAAS;wBACT,SAAS;wBACT,IAAI;wBACJ,iBAAiB;wBACjB,MAAM,CAAC,gBAAgB;qBACxB,EACD;wBACE,MAAM,EAAE,YAAY;wBACpB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,0BAA0B;wBACxD,MAAM,EAAE,IAAI;qBACb,CACF,CAAC;oBACF,MAAM,iCAAiC,CACrC,SAAS,EACT,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,EAChC,SAAS,CACV,CAAC;oBACF,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACvD,2DAA2D,CAAC,IAAI,CAAC,IAAI,CAAC,CACvE,CAAC;oBACF,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO;yBACpC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;yBAC3C,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;oBACpF,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC1C,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;wBACrC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;wBACnC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CACpC,CAAC;oBACF,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;oBAC9E,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAC5B,MAAM,IAAI,SAAS,CACjB,sBAAsB,EACtB,UAAU,CAAC,MAAM,KAAK,CAAC;4BACrB,CAAC,CAAC,kHAAkH;4BACpH,CAAC,CAAC,0EAA0E,CAC/E,CAAC;oBACJ,CAAC;oBACD,OAAO;wBACL,KAAK,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC;wBAC3D,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC,WAAW,EAAE;qBACtD,CAAC;gBACJ,CAAC,CACF,CAAC;gBACF,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;gBACzB,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC9B,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;YACnC,CAAC;YACD,MAAM,MAAM,GAAG,SAAS,KAAK,QAAQ;gBACnC,CAAC,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC;gBACnC,CAAC,CAAC,SAAS,KAAK,MAAM;oBACtB,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC;oBACjC,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,SAAS,CACjB,sBAAsB,EACtB,oFAAoF,CACrF,CAAC;YACJ,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,SAAS,CACjB,uBAAuB,EACvB,8IAA8I,CAC/I,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE;gBAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAC7D,CAAC,CAAC,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAC1C,IAAI,CAAC,MAAM,EACX,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAC5C,MAAM,CACP,CAAC;YACF,MAAM,KAAK,GAAgB;gBACzB,EAAE,EAAE,OAAO;gBACX,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,cAAc,EAAE,MAAM,CAAC,QAAQ;gBAC/B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,IAAI,EAAE,QAAQ,CAAC,IAAsB;gBACrC,eAAe,EAAE,QAAQ,CAAC,eAAe;gBACzC,UAAU;gBACV,QAAQ,EAAE;oBACR,MAAM,EAAE,mBAAmB;oBAC3B,YAAY,EAAE,MAAM,CAAC,MAAM;oBAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;oBAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW;iBAClC;aACF,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACxC,MAAM,QAAQ,GAAmB;gBAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,cAAc,EAAE,MAAM,CAAC,QAAQ;gBAC/B,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,SAAS,KAAK,QAAQ;oBAC9B,CAAC,CAAC,kBAAkB;oBACpB,CAAC,CAAC,SAAS,KAAK,MAAM;wBACtB,CAAC,CAAC,sBAAsB;wBACxB,CAAC,CAAC,UAAU;gBACd,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,QAAQ,EAAE,IAAI,CAAC,YAAY;gBAC3B,OAAO,EAAE,CAAC;gBACV,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,KAAK;gBAC3B,MAAM,EAAE;oBACN,OAAO;oBACP,QAAQ,EAAE,QAAQ,CAAC,QAAQ;oBAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;oBAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,eAAe,EAAE,QAAQ,CAAC,eAAe;iBAC1C;gBACD,QAAQ,EAAE;oBACR,OAAO,EAAE,mBAAmB;oBAC5B,WAAW,EAAE,YAAY;oBACzB,GAAG,QAAQ;iBACZ;gBACD,SAAS,EAAE,UAAU;aACtB,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;YAC1E,WAAW,CAAC,OAAO,CAAC;gBAClB,YAAY,EAAE,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;gBACpD,yBAAyB,EAAE,QAAQ,CAAC,IAAI,KAAK,SAAS;gBACtD,QAAQ,EAAE;oBACR,UAAU,EAAE,QAAQ,CAAC,UAAU;oBAC/B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;oBAC3B,eAAe,EAAE,QAAQ,CAAC,eAAe;oBACzC,QAAQ,EAAE,MAAM,CAAC,MAAM;oBACvB,GAAG,QAAQ;iBACZ;aACF,CAAC,CAAC;YACH,OAAO;gBACL,KAAK;gBACL,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrD,QAAQ;gBACR,QAAQ,EAAE,KAAK;aAChB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/src/acquisition/transport-policy.d.ts

@@ -0,0 +1,7 @@
+import type { ResolvedSource } from "../sources/types.js";
+export type FrameTransportDecision = Readonly<{
+    primary: "local-direct" | "hls-bounded-section" | "reusable-evidence";
+    fallback: "none" | "reusable-evidence";
+    basis: "local-source" | "targetable-hls-advertised" | "no-targetable-hls";
+}>;
+export declare function chooseFrameTransport(source: ResolvedSource): FrameTransportDecision;

package/dist/src/acquisition/transport-policy.js

@@ -0,0 +1,22 @@
+export function chooseFrameTransport(source) {
+    if (source.kind === "local") {
+        return { primary: "local-direct", fallback: "none", basis: "local-source" };
+    }
+    const hls = source.formats.some((format) => format.protocol?.startsWith("m3u8") === true &&
+        format.videoCodec !== null &&
+        format.videoCodec !== "none" &&
+        format.ext !== "mhtml" &&
+        (format.height ?? 0) <= 1080);
+    return hls
+        ? {
+            primary: "hls-bounded-section",
+            fallback: "none",
+            basis: "targetable-hls-advertised",
+        }
+        : {
+            primary: "reusable-evidence",
+            fallback: "none",
+            basis: "no-targetable-hls",
+        };
+}
+//# sourceMappingURL=transport-policy.js.map

package/dist/src/acquisition/transport-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-policy.js","sourceRoot":"","sources":["../../../src/acquisition/transport-policy.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,oBAAoB,CAClC,MAAsB;IAEtB,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAC9E,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAC7B,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,IAAI;QAC5C,MAAM,CAAC,UAAU,KAAK,IAAI;QAC1B,MAAM,CAAC,UAAU,KAAK,MAAM;QAC5B,MAAM,CAAC,GAAG,KAAK,OAAO;QACtB,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,IAAI,CAC/B,CAAC;IACF,OAAO,GAAG;QACR,CAAC,CAAC;YACA,OAAO,EAAE,qBAAqB;YAC9B,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,2BAA2B;SACnC;QACD,CAAC,CAAC;YACA,OAAO,EAAE,mBAAmB;YAC5B,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,mBAAmB;SAC3B,CAAC;AACN,CAAC"}

package/dist/src/acquisition/video-timing.d.ts

@@ -0,0 +1,24 @@
+type Rational = Readonly<{
+    numerator: bigint;
+    denominator: bigint;
+}>;
+export type VideoPtsCoverage = Readonly<{
+    start: Rational;
+    end: Rational;
+    startSeconds: number;
+    endSeconds: number;
+    startPts: string | null;
+    endPts: string | null;
+    durationTs: string | null;
+    timeBase: string | null;
+}>;
+/** Parse retained presentation-time coverage from the selected video stream */
+export declare function parseVideoStreamCoverage(stream: Readonly<Record<string, unknown>>): VideoPtsCoverage | null;
+/** Parse retained PTS-aware producer fields for exact media paths */
+export declare function parseStoredVideoCoverage(producer: Readonly<Record<string, unknown>>): VideoPtsCoverage | null;
+/** Parse the bounded-section PTS-aware producer contract */
+export declare function parseStoredBoundedVideoCoverage(producer: Readonly<Record<string, unknown>>): VideoPtsCoverage | null;
+export declare function serializeVideoPtsCoverage(coverage: VideoPtsCoverage): Readonly<Record<string, unknown>>;
+export declare function isTimestampCovered(coverage: VideoPtsCoverage, nominalLocalMs: number): boolean;
+export declare function physicalSeekMs(coverage: VideoPtsCoverage, nominalLocalMs: number): number;
+export {};