urma-mcp 0.1.0-rc.1

package/dist/src/acquisition/media.d.ts

@@ -0,0 +1,59 @@
+import type { UrmaConfig } from "../config.js";
+import type { InvestigationRef } from "../core/ids.js";
+import type { ArtifactKind } from "../core/model.js";
+import type { FormatSummary, ResolvedSource } from "../sources/types.js";
+import { YtDlp } from "../subprocess/ytdlp.js";
+import type { RemoteOperationContext } from "../remote/worker.js";
+import { BlobStore } from "../store/blob-store.js";
+import type { StoredArtifact, UrmaStore } from "../store/store.js";
+type Downloader = Pick<YtDlp, "run"> & Partial<Pick<YtDlp, "lease">>;
+type DownloadSpec = Readonly<{
+    operation: string;
+    kind: ArtifactKind;
+    startMs: number;
+    endMs: number;
+    format: FormatSummary;
+    args: string[];
+    version: string;
+    params: Record<string, unknown>;
+}>;
+type AcquiredMedia = Readonly<{
+    artifact: StoredArtifact;
+    path: string;
+    cacheHit: boolean;
+}>;
+export type SectionBatchRequirement = Readonly<{
+    source: ResolvedSource;
+    investigationRef: InvestigationRef;
+    startMs: number;
+    endMs: number;
+}>;
+export type SectionAcquisitionOutcome = Readonly<{
+    requirement: SectionBatchRequirement;
+    status: "fulfilled";
+    value: AcquiredMedia;
+}> | Readonly<{
+    requirement: SectionBatchRequirement;
+    status: "rejected";
+    reason: unknown;
+}>;
+/** Describe the selected exact-frame transport representation without acquiring media */
+export declare function frameEvidenceRepresentation(config: UrmaConfig, source: ResolvedSource): Readonly<Record<string, unknown>>;
+/** Group section requests by the effective bounded-section acquisition key */
+export declare function groupCompatibleSectionRequirements(config: UrmaConfig, requirements: readonly SectionBatchRequirement[]): SectionBatchRequirement[][];
+export declare function mediaBudgetBytes(config: UrmaConfig, kind: ArtifactKind): number;
+export declare function expectedMediaBytes(source: ResolvedSource, spec: Pick<DownloadSpec, "kind" | "startMs" | "endMs" | "format">): number | null;
+export declare class MediaAcquirer {
+    #private;
+    readonly config: UrmaConfig;
+    readonly store: UrmaStore;
+    readonly blobs: BlobStore;
+    readonly remoteContext: RemoteOperationContext | null;
+    readonly downloader: Downloader;
+    constructor(config: UrmaConfig, store: UrmaStore, blobs: BlobStore, downloader?: Downloader, remoteContext?: RemoteOperationContext | null);
+    navigation(source: ResolvedSource, ref: InvestigationRef, signal?: AbortSignal): Promise<AcquiredMedia>;
+    reusableEvidence(source: ResolvedSource, ref: InvestigationRef, signal?: AbortSignal): Promise<AcquiredMedia>;
+    section(source: ResolvedSource, ref: InvestigationRef, startMs: number, endMs: number, signal?: AbortSignal): Promise<AcquiredMedia>;
+    sections(requirements: readonly SectionBatchRequirement[], signal?: AbortSignal): Promise<SectionAcquisitionOutcome[]>;
+}
+export {};