@vkontakte/videoplayer-core 2.0.181-dev.05b016920.0 → 2.0.181-dev.132333d53.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.181-dev.05b016920.0",
+  "version": "2.0.181-dev.132333d53.0",
   "author": "vk.ru",
   "description": "Videoplayer core library based on the vk.ru platform",
   "homepage": "https://vk.ru",
@@ -42,6 +42,6 @@
     "**/*.d.ts"
   ],
   "dependencies": {
-    "@vkontakte/videoplayer-shared": "1.0.110-dev.05b016920.0"
+    "@vkontakte/videoplayer-shared": "1.0.110-dev.132333d53.0"
   }
 }

package/types/index.d.ts

@@ -1,11 +1,13 @@
 import { VERSION } from "./env";
 import type { IMpegSource, IDashSource, IHLSSource, IDashURLSource, IHLSLiveSource, ISeekRequest, URLSource, RawSource, URLSourceWithSeek } from "./player/types";
 import type { VideoCodec } from "./player/types";
+import type { ICoreInstanceData, MlModelResolver } from "./player/types";
 import { VideoFormat, Surface, PredefinedQualityLimits, VideoCodecName } from "./player/types";
 import Player from "./player/Player";
 import type { IPlayer, IPlayerInfo, IPlayerEvents, IConfig, ISources, IExternalTextTrack, ITextTrack, PlaybackRate, IVideoStream, IAudioStream, StartEnd, HttpConnectionMetrics, HttpDownloadMetrics } from "./player/types";
 import { PlaybackState, ChromecastState, HttpConnectionType } from "./player/types";
 import type { IOptionalTuningConfig } from "./utils/tuningConfig";
+import type { UserHappinessTrigger } from "./utils/userHappinessTriggers";
 export { clientChecker, isMobile } from "./utils/ClientChecker";
 export { areValidLiveRecordSources } from "./utils/videoFormat";
 export { WebmCodecStrategy } from "./enums/WebmCodecStrategy";
@@ -15,5 +17,5 @@ import { Subscription, Observable, Subject, ValueSubject, VideoQuality } from "@
 * @deprecated
 */
 declare const SDK_VERSION: string;
-export type { IPlayer, IPlayerInfo, IPlayerEvents, IConfig, IOptionalTuningConfig, ILogEntry, ISources, IExternalTextTrack, ITextTrack, ISubscription, IUnsubscriber, IObservable, IEmitter, IValueObservable, IValue, IOperator, IListener, IMpegSource, IDashSource, IDashURLSource, IHLSSource, IHLSLiveSource, URLSource, RawSource, URLSourceWithSeek, ExactVideoQuality, IRange, ISeekRequest, PlaybackRate, IVideoStream, IAudioStream, StartEnd, HttpConnectionMetrics, HttpDownloadMetrics };
+export type { IPlayer, IPlayerInfo, IPlayerEvents, IConfig, IOptionalTuningConfig, UserHappinessTrigger, ILogEntry, ISources, IExternalTextTrack, ITextTrack, ISubscription, IUnsubscriber, IObservable, IEmitter, IValueObservable, IValue, IOperator, IListener, IMpegSource, IDashSource, IDashURLSource, IHLSSource, IHLSLiveSource, URLSource, RawSource, URLSourceWithSeek, ExactVideoQuality, IRange, ISeekRequest, PlaybackRate, IVideoStream, IAudioStream, StartEnd, HttpConnectionMetrics, HttpDownloadMetrics, ICoreInstanceData, MlModelResolver };
 export { Player, PlaybackState, ChromecastState, HttpConnectionType, Surface, Subscription, VideoFormat, VideoQuality, Observable, Subject, ValueSubject, VERSION, SDK_VERSION, PredefinedQualityLimits, VideoCodec, VideoCodecName };

package/types/player/Player.d.ts

@@ -26,6 +26,7 @@ export default class Player implements IPlayer {
 	private wasSetStartedQuality;
 	private desiredState;
 	info: PlayerInfoImpl;
+	private userHappinessController;
 	events: PlayerEventsImpl;
 	experimental: PlayerExperimentalImpl;
 	private devNullLog;
@@ -37,6 +38,7 @@ export default class Player implements IPlayer {
 	* Очищает необходимые поля при переключении на другое видео
 	*/
 	private resetDesiredState;
+	private createUserHappinessController;
 	/**
 	* Возвращает плеер в начальное состояние
 	* Позвонялет переиспользовать для другого видео

package/types/player/types.d.ts

@@ -519,7 +519,7 @@ export interface PlayerEventsImpl {
 	fetcherError$: Subject<IError>;
 	severeStallOccured$: Subject<boolean>;
 }
-interface IPlayerExperimental {
+export interface IPlayerExperimental {
 	/**
 	* Элемент, который сейчас вставлен в container.
 	* Может быть видеоэлементом, iframe и вообще чем угодно в общем случае.
@@ -562,6 +562,8 @@ export interface IConfig {
 	* Нужно ли recoverableError обрабатывать как ошибку провайдера или будет снаружи обрабатываться.
 	*/
 	handleNetworkRecoverableErrorAsProviderError?: boolean;
+	/** Инстанс-данные слоёв: сессионный контекст приложения (UVP-12133). */
+	instance?: ICoreInstanceData;
 }
 export interface ISources {
 	[VideoFormat.MPEG]?: IMpegSource;
@@ -661,6 +663,21 @@ export interface IVideoTrack extends IBaseTrack {
 	streamId?: IVideoStream["id"];
 	tvDisabled?: boolean;
 }
+/**
+* Провайдер байтов ML-артефакта. Возвращает расшифрованный бандл или null —
+* null означает «юзер-специфичной модели нет», и фича идёт в гостевом режиме
+* либо деградирует. Общий контракт для будущих ML-фич плеера (UVP-12133).
+*/
+export type MlModelResolver = () => Promise<ArrayBuffer | null>;
+/**
+* Инстанс-данные слоя core: сессионный контекст приложения, передаётся первым
+* параметром initPlayer в адресованной секции `instance.core` — в один ряд с
+* statAuthToken/refreshStatAuthToken, а не в поведенческий sdkConfig.
+*/
+export interface ICoreInstanceData {
+	/** Модель ABR: расшифрованный бандл из account.getModels (приложение) | null → гостевая (UVP-12133). */
+	getAbrMLModel?: MlModelResolver;
+}
 export interface IAudioStream {
 	id: string;
 	language?: string;

package/types/providers/DashProvider/baseDashProvider.d.ts

@@ -11,6 +11,7 @@ import DroppedFramesManager from "../utils/HTMLVideoElement/DroppedFramesManager
 import TextTrackManager from "../utils/TextTrackManager";
 import StallsManager from "../utils/StallsManager";
 import { AbrManager } from "../utils/Abr/abrManager";
+import type { IChunkDownloadHistory } from "../utils/Abr/mlAbr/chunkDownloadHistory";
 import { ElementSizeManager } from "../utils/HTMLVideoElement/ElementSizeManager";
 type IParams = IProviderParams<IDashURLSource> & {
 	sourceHls?: IHLSSource;
@@ -32,6 +33,8 @@ export default abstract class BaseDashProvider implements IProvider {
 	protected stallsManager: StallsManager;
 	protected elementSizeManager: ElementSizeManager;
 	protected abrManager: AbrManager;
+	/** Один на плеер: оба DASH-провайдера пишут, правило MlAbr читает (UVP-12133). */
+	protected chunkDownloadHistory: IChunkDownloadHistory;
 	protected videoTracksMap: Map<IVideoTrack, {
 		stream: Stream;
 		representation: Representation;

package/types/providers/DashProvider/lib/buffer.d.ts

@@ -2,8 +2,10 @@ import type { ITuningConfig } from "../../../utils/tuningConfig";
 import type { IError, IRange, ISubject, ITracer, IValueSubject, Milliseconds } from "@vkontakte/videoplayer-shared";
 import { abortable } from "@vkontakte/videoplayer-shared";
 import type { Fetcher } from "./fetcher";
-import type { CommonInit, Manifest, Representation, Segment, Stream, StreamKind } from "../../utils/parsers/types";
+import type { CommonInit, Manifest, Representation, Segment, Stream } from "../../utils/parsers/types";
+import { StreamKind } from "../../utils/parsers/types";
 import type { VideoSegmentLoadProgress } from "../../utils/Abr/types";
+import type { IChunkDownloadHistory } from "../../utils/Abr/mlAbr/chunkDownloadHistory";
 export interface Dependencies {
 	fetcher: Fetcher;
 	tuning: ITuningConfig;
@@ -13,6 +15,7 @@ export interface Dependencies {
 	manifest: Manifest | null;
 	tracer: ITracer;
 	getSeekTargetPosition?: () => Milliseconds | undefined;
+	chunkDownloadHistory?: IChunkDownloadHistory;
 }
 export interface Gap extends IRange<Milliseconds> {
 	representation: Representation["id"];
@@ -39,6 +42,7 @@ export declare class BufferManager {
 	updateEnd$: IValueSubject<void>;
 	private subscription;
 	private kind;
+	private chunkDownloadHistory;
 	private initData;
 	private parsedInitData;
 	private representations;
@@ -80,7 +84,7 @@ export declare class BufferManager {
 	private lastDataObtainedTimestampMs;
 	private loadByteRangeSegmentsTimeoutId;
 	private brokenSegmentAppendDetected;
-	constructor(kind: StreamKind, mediaSource: MediaSource, representations: Representation[], { fetcher, tuning, getCurrentPosition, getSeekTargetPosition, isActiveLowLatency, compatibilityMode, manifest, tracer }: Dependencies);
+	constructor(kind: StreamKind, mediaSource: MediaSource, representations: Representation[], { fetcher, tuning, getCurrentPosition, getSeekTargetPosition, isActiveLowLatency, compatibilityMode, manifest, tracer, chunkDownloadHistory }: Dependencies);
 	startWith: ReturnType<typeof abortable<[Representation["id"]]>>;
 	switchToWithPreviousAbort(newRepresentationId: Representation["id"], dropBuffer?: boolean): Promise<void | undefined>;
 	switchTo: ReturnType<typeof abortable<[Representation["id"], boolean | undefined], void>>;
@@ -124,9 +128,25 @@ export declare class BufferManager {
 	* @private
 	*/
 	private onSomeByteRangesDataLoaded;
+	/**
+	* Запись в историю чанков для MlAbr. Байты приходят параметром: у каждого пути
+	* аппенда свой источник истины о размере (результат fetch'а, диапазон батча,
+	* накопленные подкармливания), на SegmentProgress его нет. Пропуск без
+	* startedAtMs — у батчей byte-range время общее на группу сегментов, а без
+	* известного старта fetch'а время загрузки не выводится.
+	*/
+	private recordChunkDownload;
 	private onSegmentFullyAppended;
 	private detectBrokenSegmentAppend;
 	private abortSegment;
+	/**
+	* Прогрев sidx всех репрезентаций для MlAbr: модели нужны размеры будущих
+	* сегментов каждого качества к первому решению, а без прогрева индексы
+	* приезжают лениво — только при первом переключении на качество. Idle-очередь
+	* качает по одному индексу между делом; здесь грузим все недостающие параллельно.
+	* loadInit регистрирует промис в initData синхронно и ошибок наружу не бросает.
+	*/
+	private warmUpRepresentations;
 	private loadNextInit;
 	private isFirstSegmentPreloadEnabled;
 	private isStartPositionWithinFirstSegment;

package/types/providers/DashProvider/lib/player.d.ts

@@ -8,6 +8,7 @@ import type { ITuningConfig } from "../../../utils/tuningConfig";
 import type { ExactVideoQuality, IError, ISubject, ITracer, IValueSubject, Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
 import { abortable, Subject } from "@vkontakte/videoplayer-shared";
 import type { VideoSegmentLoadProgress } from "../../utils/Abr/types";
+import type { IChunkDownloadHistory } from "../../utils/Abr/mlAbr/chunkDownloadHistory";
 export declare enum State {
 	NONE = "none",
 	MANIFEST_READY = "manifest_ready",
@@ -23,6 +24,7 @@ export interface Params {
 	isOnDemand: boolean;
 	dashMaxTvVideoQuality: Nullable<ExactVideoQuality>;
 	getSeekTargetPosition?: () => Milliseconds | undefined;
+	chunkDownloadHistory?: IChunkDownloadHistory;
 }
 export declare class Player {
 	private element;
@@ -91,6 +93,7 @@ export declare class Player {
 	private isOnDemand;
 	private dashMaxTvVideoQuality;
 	private getSeekTargetPosition;
+	private chunkDownloadHistory;
 	private destroyController;
 	constructor(params: Params);
 	initManifest: ReturnType<typeof abortable<[HTMLMediaElement, string, number]>>;

package/types/providers/DashProviderVirtual/baseDashProvider.d.ts

@@ -12,6 +12,7 @@ import StallsManager from "../utils/StallsManager";
 import { ElementSizeManager } from "../utils/HTMLVideoElement/ElementSizeManager";
 import type { BasePlayer } from "./lib/player/basePlayer";
 import { AbrManager } from "../utils/Abr/abrManager";
+import type { IChunkDownloadHistory } from "../utils/Abr/mlAbr/chunkDownloadHistory";
 type IParams = IProviderParams<IDashURLSource> & {
 	sourceHls?: IHLSSource;
 	forceVideoCodec?: VideoCodec;
@@ -32,6 +33,8 @@ export default abstract class BaseDashProvider implements IProvider {
 	protected stallsManager: StallsManager;
 	protected elementSizeManager: ElementSizeManager;
 	protected abrManager: AbrManager;
+	/** Один на плеер: оба DASH-провайдера пишут, правило MlAbr читает (UVP-12133). */
+	protected chunkDownloadHistory: IChunkDownloadHistory;
 	protected videoTracksMap: Map<IVideoTrack, {
 		stream: Stream;
 		representation: Representation;

package/types/providers/DashProviderVirtual/lib/buffer/types.d.ts

@@ -4,6 +4,7 @@ import type { Fetcher } from "../fetcher";
 import type { ITuningConfig } from "../../../../utils/tuningConfig";
 import type { VideoSegmentLoadProgress } from "../../../utils/Abr/types";
 import type { ISegmentCacheStorage } from "../../../utils/segmentCache";
+import type { IChunkDownloadHistory } from "../../../utils/Abr/mlAbr/chunkDownloadHistory";
 export type TRepresentationSwitchMode = "lazy" | "force";
 export declare enum SwithRepresentationMode {
 	Lazy = "lazy",
@@ -17,6 +18,7 @@ export interface Dependencies {
 	compatibilityMode?: boolean;
 	manifest: Manifest | null;
 	segmentCacheService?: ISegmentCacheStorage;
+	chunkDownloadHistory?: IChunkDownloadHistory;
 	getCurrentPosition(): Milliseconds | undefined;
 	getCurrentStallDuration(): Milliseconds;
 	isActiveLowLatency(): boolean;

package/types/providers/DashProviderVirtual/lib/buffer/virtualBuffer/baseVirtualBufferManager.d.ts

@@ -22,6 +22,7 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	protected readonly tuning: ITuningConfig;
 	protected readonly segmentCacheService: ISegmentCacheStorage | undefined;
 	protected representations: Map<Representation["id"], Representation>;
+	private chunkDownloadHistory;
 	protected playingRepresentationId: Representation["id"] | undefined;
 	protected downloadingRepresentationId: Representation["id"] | undefined;
 	protected switchingRepresentationId: Representation["id"] | null;
@@ -57,7 +58,7 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	protected readonly getCurrentStallDuration: () => Milliseconds | undefined;
 	protected readonly getSeekTargetPosition: (() => Milliseconds | undefined) | undefined;
 	protected brokenSegmentAppendDetected: boolean;
-	protected constructor(kind: StreamKind, nativeBufferManager: NativeBufferManager, representations: Representation[], { fetcher, tracer, tuning, getCurrentPosition, getCurrentStallDuration, getSeekTargetPosition, manifest, segmentCacheService }: Dependencies);
+	protected constructor(kind: StreamKind, nativeBufferManager: NativeBufferManager, representations: Representation[], { fetcher, tracer, tuning, getCurrentPosition, getCurrentStallDuration, getSeekTargetPosition, manifest, segmentCacheService, chunkDownloadHistory }: Dependencies);
 	protected abstract loadItems(itemsToLoad: IBufferPlaybackQueueItem<T>[], representation: Representation, priority?: Priority): Promise<void>;
 	protected abstract selectItemsToLoad(): IBufferPlaybackQueueItem<T>[];
 	protected abstract prepareFetchParams(items: IBufferPlaybackQueueItem<T>[], representation: Representation): FetchParamsWithUrl;
@@ -108,7 +109,13 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	protected abortDownload(): void;
 	protected abortDownloadingItems(): void;
 	protected abortNativeBuffer(): Promise<boolean>;
-	protected loadInits(): Promise<void>;
+	/**
+	* Прогрев индексов остальных репрезентаций. За mlAbr.enabled — параллельно и
+	* сразу: MlAbr нужны размеры сегментов всех качеств к первому решению модели,
+	* idle-отсрочка опоздала бы. loadInitIfNeeded дедупится initDataPromises, ошибок
+	* наружу не бросает.
+	*/
+	protected loadInits(): void;
 	protected loadInitIfNeeded(representation: Representation, requestedPriority?: Priority, critical?: boolean): Promise<void>;
 	protected loadInit(representation: Representation, requestedPriority?: Priority, critical?: boolean): Promise<void>;
 	private isStartPositionWithinFirstSegment;
@@ -131,6 +138,12 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	protected onItemFullyAppended(appendedItem: IBufferPlaybackQueueItem<T>): void;
 	private detectBrokenSegmentAppend;
 	protected removeSegment(nextRemoveItem: IBufferPlaybackQueueItem<T>, signal: AbortSignal): Promise<void>;
+	/**
+	* Запись в историю чанков для MlAbr. Без size или startedAtMs запись не
+	* выводится корректно (размер неизвестен до sidx, старт — до перевода в
+	* DOWNLOADING): молча пропускаем, история просто копится медленнее.
+	*/
+	private recordChunkDownload;
 	protected onDownloadItem(downloadedItem: IBufferPlaybackQueueItem<T>): void;
 	protected pruneVirtualBuffer(currentPosition: Milliseconds): void;
 	protected updateRepresentationsBaseUrlIfNeeded(): void;

package/types/providers/DashProviderVirtual/lib/player/basePlayer.d.ts

@@ -81,6 +81,7 @@ export declare abstract class BasePlayer {
 	private isOnDemand;
 	private dashMaxTvVideoQuality;
 	private getSeekTargetPosition;
+	private chunkDownloadHistory;
 	protected constructor(params: Params);
 	protected abstract prepareManifestUrlString(manifestBaseUrlString: string, offset: number): string;
 	protected abstract setSourceInitDuration(): void;

package/types/providers/DashProviderVirtual/lib/player/types.d.ts

@@ -2,6 +2,7 @@ import type ThroughputEstimator from "../../../../utils/ThroughputEstimator";
 import type { ITuningConfig } from "../../../../utils/tuningConfig";
 import type { VideoCodec } from "../../../../player/types";
 import type { ExactVideoQuality, ITracer, Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
+import type { IChunkDownloadHistory } from "../../../utils/Abr/mlAbr/chunkDownloadHistory";
 export declare enum State {
 	NONE = "none",
 	MANIFEST_READY = "manifest_ready",
@@ -17,4 +18,5 @@ export interface Params {
 	isOnDemand?: boolean;
 	dashMaxTvVideoQuality?: Nullable<ExactVideoQuality>;
 	getSeekTargetPosition?: () => Milliseconds | undefined;
+	chunkDownloadHistory?: IChunkDownloadHistory;
 }

package/types/providers/ProviderContainer/index.d.ts

@@ -1,5 +1,6 @@
 import type { IMetadata, ISources } from "../../player/types";
 import { VideoFormat } from "../../player/types";
+import type { ICoreInstanceData } from "../../player/types";
 import type { ITuningConfig } from "../../utils/tuningConfig";
 import type { IError, ISubject, IValueSubject, IRectangle } from "@vkontakte/videoplayer-shared";
 import { ValueSubject } from "@vkontakte/videoplayer-shared";
@@ -16,6 +17,7 @@ interface IParams extends IProviderDependencies {
 	panelSize?: IRectangle;
 	skipVideoElVolumeSync$: ValueSubject<boolean>;
 	handleNetworkRecoverableErrorAsProviderError?: boolean;
+	instanceData?: ICoreInstanceData;
 }
 export default class ProviderContainer implements IProviderContainer {
 	current$: IValueSubject<IProviderEntry>;

package/types/providers/types.d.ts

@@ -2,7 +2,7 @@ import type { ITuningConfig } from "../utils/tuningConfig";
 import type { IComponentLogger, IError, ILogger, IRange, IRectangle, ISubject, ITracer, IValueSubject, IWarning, Milliseconds, QualityLimits, Seconds } from "@vkontakte/videoplayer-shared";
 import type { IChromecastInitializer } from "./ChromecastProvider/ChromecastInitializer/types";
 import type { IExternalTextTrack, IInternalTextTrack, ITextTrack, IVideoTrack, IVolumeState, PlaybackRate, PlaybackState } from "../player/types";
-import type { AudioCodec, HttpConnectionMetrics, HttpConnectionType, HttpDownloadMetrics, IAudioStream, IAudioTrack, ISources, IVideoStream, SeekState, VideoCodec } from "../player/types";
+import type { AudioCodec, HttpConnectionMetrics, HttpConnectionType, HttpDownloadMetrics, IAudioStream, IAudioTrack, ICoreInstanceData, ISources, IVideoStream, SeekState, VideoCodec } from "../player/types";
 import type { IStateMachine } from "../utils/StateMachine/types";
 import type ThroughputEstimator from "../utils/ThroughputEstimator";
 export interface IProvider {
@@ -25,6 +25,7 @@ export interface IProviderParams<TSourceType> extends IProviderDependencies {
 	tuning: ITuningConfig;
 	panelSize?: IRectangle;
 	skipVideoElVolumeSync$: IValueSubject<boolean>;
+	instanceData?: ICoreInstanceData;
 }
 export interface DesiredStateValues {
 	audioStream: IAudioStream | undefined;

package/types/providers/utils/Abr/abrManager.d.ts

@@ -11,11 +11,13 @@ export declare class AbrManager {
 	private context;
 	private phaseController;
 	private allVideoRules;
+	private mlAbrRule;
 	private tracer;
 	init(context: IInitAbrManagerContext): void;
 	updateContext(updateContext: IUpdatableAbrManagerContext): void;
 	private getAudioReserve;
 	autoSelectTrack<T extends IVideoTrack | IAudioTrack>(kind: Exclude<StreamKind, StreamKind.TEXT>): T;
+	private withoutClassicDecisionOwners;
 	destroy(): void;
 	private initVideoElementAbrContext;
 	private updateTracksIfneeded;

package/types/providers/utils/Abr/mlAbr/chunkDownloadHistory.d.ts

@@ -0,0 +1,34 @@
+import type { Byte, IObservable, Milliseconds, VideoQuality } from "@vkontakte/videoplayer-shared";
+import { Subject } from "@vkontakte/videoplayer-shared";
+import type { Representation } from "../../parsers/types";
+export interface IChunkDownloadRecord {
+	bytes: Byte;
+	loadTimeMs: Milliseconds;
+	representationId: Representation["id"];
+	/**
+	* Неопределён, когда качество репрезентации не выводится ни из строки
+	* манифеста, ни из размеров: запись всё равно полезна истории полосы
+	* (bytes/loadTime), а построитель входов модели оставит её без one-hot.
+	*/
+	quality: VideoQuality | undefined;
+}
+export interface IChunkDownloadHistory {
+	/** Пушится на каждую запись; подписка правила пересчитывает кэш решения. */
+	readonly segmentDownloaded$: IObservable<IChunkDownloadRecord>;
+	add(record: IChunkDownloadRecord): void;
+	/** Записи от старых к новым; паддинг нулями делает построитель входов модели. */
+	snapshot(): readonly IChunkDownloadRecord[];
+	clear(): void;
+}
+/** Глубина истории модели PPO: H=24 зашита в артефакт (UVP-12133). */
+export declare const CHUNK_HISTORY_CAPACITY = 24;
+export declare class ChunkDownloadHistoryCollector implements IChunkDownloadHistory {
+	private readonly capacity;
+	readonly segmentDownloaded$: Subject<IChunkDownloadRecord>;
+	private readonly records;
+	constructor(capacity?: number);
+	add(record: IChunkDownloadRecord): void;
+	snapshot(): readonly IChunkDownloadRecord[];
+	clear(): void;
+}
+export declare const representationToQuality: (representation: Representation) => VideoQuality | undefined;

package/types/providers/utils/Abr/mlAbr/modelInput.d.ts

@@ -0,0 +1,47 @@
+import type { Byte } from "@vkontakte/videoplayer-shared";
+import { VideoQuality } from "@vkontakte/videoplayer-shared";
+import type { IChunkDownloadRecord } from "./chunkDownloadHistory";
+/**
+* Контракт модели PPO ABR, версия артефакта 22.10 (карточка модели — Confluence
+* pageId=2177405140). Константы зашиты в .tflite и конфигурироваться не могут.
+*/
+export declare const ML_ABR_ACTIONS = 8;
+export declare const ML_ABR_HISTORY = 24;
+/** Горизонт размеров будущих чанков (v22.10): 4 чанка вперёд на качество. */
+export declare const ML_ABR_FOREHORON = 4;
+/** Лестница модели: индекс массива — индекс действия артефакта. */
+export declare const ML_ABR_LADDER: readonly VideoQuality[];
+export declare const ladderIndexOfQuality: (quality: VideoQuality) => number;
+export interface IMlAbrInputSource {
+	/** История загрузок, от старых к новым; длиннее H — берутся последние H. */
+	history: readonly IChunkDownloadRecord[];
+	/** Размеры будущих чанков по качествам лестницы (F=4, от следующего); оценка в байтах уже подставлена правилом. */
+	nextChunkSizes: ReadonlyMap<VideoQuality, readonly Byte[]>;
+	/** Доступные качества: лестница ∩ внешние лимиты. Вход маски модели. */
+	availableQualities: ReadonlySet<VideoQuality>;
+	/** Заполненность буфера в секундах, до преобразования speed. */
+	bufferSeconds: number;
+	/** Флаг размера буфера: 0 → 70 с, 1 → 120 с. */
+	bufferFlag: 0 | 1;
+	/** Доля оставшегося видео: remaining / total. */
+	remainingRatio: number;
+	/** playbackRate: v22.10 поддерживает ≠1 двумя преобразованиями (buffer/speed, download×speed). */
+	playbackRate: number;
+}
+export interface IMlAbrModelInput {
+	/** [H] измеренная полоса чанка, Mbps/10. */
+	readonly throughput: Float32Array;
+	/** [H] время загрузки чанка, с/10 (уже ×speed). */
+	readonly download: Float32Array;
+	/** [A×H] one-hot история выборов. */
+	readonly actionHistory: Float32Array;
+	/** [A×F] размеры будущих чанков, байт/1e6. */
+	readonly chunkSizes: Float32Array;
+	/** [A×H] размеры скачанных чанков, байт/1e6. */
+	readonly prevChunkSizes: Float32Array;
+	/** [A] маска доступности, строго 0/1. */
+	readonly actionMask: Float32Array;
+	/** [3] buffer_s (÷speed), buffer_flag, remaining/total. */
+	readonly actorScalars: Float32Array;
+}
+export declare const buildMlAbrModelInput: (source: IMlAbrInputSource) => IMlAbrModelInput;

package/types/providers/utils/Abr/mlAbr/workerClient.d.ts

@@ -0,0 +1,57 @@
+import type { IMlAbrModelInput } from "./modelInput";
+import type { TMlAbrWorkerResponse } from "./workerProtocol";
+export declare enum MlAbrRuntimeStatus {
+	NotStarted = "not_started",
+	InProgress = "in_progress",
+	Completed = "completed",
+	Failed = "failed"
+}
+export interface IMlAbrDecision {
+	/** Индекс качества в лестнице модели. */
+	qualityIndex: number;
+	/** Вероятности по действиям; для телеметрии (top-3). */
+	probs: Float32Array;
+}
+interface IMinimalWorker {
+	onmessage: ((event: MessageEvent<TMlAbrWorkerResponse>) => void) | null;
+	postMessage(message: unknown, transfer?: Transferable[]): void;
+	terminate(): void;
+}
+export interface IMlAbrWorkerClientDeps {
+	/** Точка подмены в тестах; в проде — глобальный fetch. */
+	fetch?: typeof fetch;
+	/** Точка подмены в тестах; в проде — глобальный Worker. */
+	Worker?: new (workerUrl: string) => IMinimalWorker;
+}
+export interface IMlAbrWorkerClientOptions {
+	/** URL артефакта worker.js на CDN (версионируемый путь — ручка экспериментов). */
+	workerJsUrl: string;
+	/** Байты модели: instance-провайдер или fetch гостевого URL; null — источника нет. */
+	model: Promise<ArrayBuffer | null>;
+	/** Каталог litert-артефакта; оттуда параллельно префетчатся iife и wasm. */
+	litertWasmUrl?: string;
+	/** Таймаут от создания до init-result; превышение гасит воркер. */
+	initTimeoutMs?: number;
+	deps?: IMlAbrWorkerClientDeps;
+}
+export interface IMlAbrWorkerClient {
+	readonly status: MlAbrRuntimeStatus;
+	readonly failureReason: string | undefined;
+	/** Резолвится после init-result; отказ — исключением с причиной. */
+	readonly ready: Promise<void>;
+	predict(input: IMlAbrModelInput): Promise<IMlAbrDecision>;
+	destroy(): void;
+}
+/**
+* Клиент воркера: все сетевые заходы стартуют ПАРАЛЛЕЛЬНО с момента
+* создания — код воркера, litert iife, wasm-бинарь (10+ МБ — главный
+* полюс, вариант выбирается той же пробой relaxedSimd, что у loadLiteRt)
+* и модель. Воркер собирается из уже скачанного кода через blob, получает
+* всё предзагруженное первым сообщением и не ходит в сеть сам.
+*
+* Статусная машина вместо исключений: конвейер ABR синхронен, любую
+* неготовность превращает в воздержание правила; причина отказа — строкой
+* в debug-лог. Артефакты кросс-доменные — fetch требует CORS на CDN-ресурсе.
+*/
+export declare const createMlAbrWorkerClient: (options: IMlAbrWorkerClientOptions) => IMlAbrWorkerClient;
+export {};

package/types/providers/utils/Abr/mlAbr/workerProtocol.d.ts

@@ -0,0 +1,67 @@
+import type { IMlAbrModelInput } from "./modelInput";
+/**
+* Протокол воркера ML ABR (артефакт uvp-deps на CDN, репозиторий
+* uvp-deps — источник правды схемы). Контракт зеркалируется типами сюда:
+* SDK не зависит от пакета воркера, расхождение ловится интеграционным
+* прогоном, а не типами.
+*
+* Один init (модель transferable), затем поток predict. Ответы несут id
+* запроса: порядок predict'ов не гарантирован, потребитель сверяется по id.
+* Массивы входа передаются transferable — после отправки буферы
+* отсоединены, пересозданием занимается отправитель (построитель входов
+* собирает свежие массивы на каждый цикл).
+*/
+export declare const ML_ABR_WORKER_PROTOCOL_VERSION = 1;
+export interface IMlAbrInitMessage {
+	type: "init";
+	id: number;
+	/** Байты .tflite-артефакта; воркер забирает буфер transferable. */
+	model: ArrayBuffer;
+	/** Код iife-сборки litert, предзагруженный клиентом параллельно; без него — litertJsUrl. */
+	litertJsCode?: string;
+	/** Байты wasm-бинаря; воркер резолвит их через blob и locateFile. */
+	litertWasmBytes?: ArrayBuffer;
+	/** Fallback: URL iife-сборки LiteRT, если код не предзагружен. */
+	litertJsUrl?: string;
+	/** Каталог wasm-бинарёй: оттуда loadLiteRt берёт .js-лоадер (кэш прогрет префетчем клиента). */
+	litertWasmUrl?: string;
+}
+export interface IMlAbrPredictMessage {
+	type: "predict";
+	id: number;
+	input: IMlAbrModelInput;
+}
+export interface IMlAbrDestroyMessage {
+	type: "destroy";
+}
+export type TMlAbrWorkerRequest = IMlAbrInitMessage | IMlAbrPredictMessage | IMlAbrDestroyMessage;
+export interface IMlAbrInitOk {
+	type: "init-result";
+	id: number;
+	ok: true;
+	protocolVersion: typeof ML_ABR_WORKER_PROTOCOL_VERSION;
+	/** Фактические имена входов артефакта (args_N или семантические). */
+	inputNames: string[];
+}
+export interface IMlAbrInitFail {
+	type: "init-result";
+	id: number;
+	ok: false;
+	reason: string;
+}
+export interface IMlAbrPredictOk {
+	type: "predict-result";
+	id: number;
+	ok: true;
+	/** Индекс качества в лестнице модели. */
+	qualityIndex: number;
+	/** Вероятности по действиям; transferable обратно. */
+	probs: Float32Array;
+}
+export interface IMlAbrPredictFail {
+	type: "predict-result";
+	id: number;
+	ok: false;
+	reason: string;
+}
+export type TMlAbrWorkerResponse = IMlAbrInitOk | IMlAbrInitFail | IMlAbrPredictOk | IMlAbrPredictFail;

package/types/providers/utils/Abr/rules/baseRule.d.ts

@@ -12,7 +12,8 @@ export declare abstract class BaseRule<
 	readonly activePhases: ReadonlySet<AbrPhase>;
 	protected subscription: Subscription;
 	protected type: RuleType;
-	protected name: string;
+	/** Имя правила: публично — AbrManager фильтрует набор по именам в ML-режиме. */
+	name: string;
 	protected confidence: RuleConfidence;
 	constructor(phaseConfig: RulePhaseConfig);
 	init(_initContext: IRuleInitContext): void;

package/types/providers/utils/Abr/rules/video/mlAbrRule.d.ts

@@ -0,0 +1,52 @@
+import type { IAbrRule, IAbrRuleResolution, IRuleInitContext, IVideoAbrContext, RuleLogData } from "../../types";
+import type { IVideoTrack } from "../../../../../player/types";
+import { LimitAboveRule } from "../limitAboveRule";
+import type { RulePhaseConfig } from "../../controllers/abrPhaseController";
+import { type IMlAbrDecision } from "../../mlAbr/workerClient";
+export type MlAbrModelSource = "getModels" | "guest";
+/**
+* Голос модели в конвейере. Синхронный контракт execute сохранён: инференс
+* асинхронный, результат живёт в кэше с dirty-флагом, пересчёт запускается
+* мимо execute. До готовности и при любом отказе правило голосует воздержанием —
+* конвейер работает на классическом наборе.
+*/
+export declare class MlAbrRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
+	private initContext;
+	private history;
+	private modelResolver;
+	private modelSource;
+	private runtime;
+	private decision;
+	private decisionDirty;
+	private predictInFlight;
+	private lastLoggedStatus;
+	private decisionOwner;
+	constructor(phaseConfig: RulePhaseConfig);
+	/** Владелец решения: конвейер гасит Throughput/Bola, пока модель реально голосует. */
+	isDecisionOwner(): boolean;
+	init(initContext: IRuleInitContext): void;
+	destroy(): void;
+	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
+	protected createLogData(selectedTrack: IVideoTrack, decision: IMlAbrDecision | undefined, sizesEstimated: boolean | undefined, warmup: number, abstainReason: string | undefined): RuleLogData;
+	private lastSizesEstimated;
+	private modelSourceOf;
+	private warmupOf;
+	private warmupFallback;
+	/** Гейты входа в ML-режим (PRD «Steady модели»); undefined — можно голосовать. */
+	private abstainReason;
+	/**
+	* «Сначала байты, потом чанк»: рантайм (и его dynamic import) не трогается,
+	* пока байты модели не в руках. Провайдер → null и нет guestUrl → вообще
+	* ничего не грузим, правило навсегда воздерживается.
+	*/
+	private ensureModelLoaded;
+	private maybePredict;
+	private buildInputSource;
+	private nextSizesOf;
+	private isWithinLimits;
+	private trackOfQuality;
+	/** remaining/total требует позиции плейхеда; ближайшая оценка — левый край окна сегментов. */
+	private approxPlayedMs;
+	/** Наблюдаемость (требование тикета): переходы состояний — в debug-лог, дубли не пишем. */
+	private logState;
+}