@3dsource/angular-unreal-module 0.0.187 → 0.0.189

package/types/3dsource-angular-unreal-module.d.ts

@@ -214,18 +214,12 @@ declare class VideoStatsComponent {
     readonly videoQP: Signal<{
         value: number;
     }>;
+    /** What the window shows: the raw stats plus the few display-only values
+     *  derived here. Shared by the text rows and the graphs. */
+    private readonly view;
     readonly videoStatus: Signal<{
         key: string;
-        value: string | number | Record<string, string> | {
-            local: {
-                type: string;
-                url: string;
-            };
-            remote: {
-                type: string;
-                url: string;
-            };
-        } | null | undefined;
+        value: unknown;
     }[] | undefined>;
     readonly fields: string[];
     private readonly elementsToShow;
@@ -568,6 +562,374 @@ interface SignalingData {
 
 type Quality = 'lime' | 'red' | 'orange';
 
+/**
+ * Wire contract for every event `StreamStatusTelemetryService2` dispatches
+ * through `trackTelemetryData`.
+ *
+ * This file is the **single source of truth** for the producer side. The
+ * consumer side lives in the telemetry viewer
+ * (`253.StreamTelemetry/src/app/telemetry/models/telemetry.types.ts`) — any
+ * change here needs a paired edit there.
+ *
+ * Event taxonomy (8 names, 6 payload shapes):
+ *  | event                      | payload                            |
+ *  |----------------------------|------------------------------------|
+ *  | `stream.session_started`   | {@link SessionStartedData}         |
+ *  | `stream.phase_ended`       | {@link PhaseEndedData}             |
+ *  | `stream.session_ended`     | {@link SessionEndedData}           |
+ *  | `stream.sample`            | {@link SampleData}                 |
+ *  | `stream.quality_degraded`  | {@link QualityAnomalyData}         |
+ *  | `stream.quality_recovered` | {@link QualityAnomalyData}         |
+ *  | `stream.fps_low`           | {@link FpsLowData}                 |
+ *  | `stream.signaling_retry`   | {@link SignalingRetryData}         |
+ */
+/**
+ * Every stable id the service can put on the wire — phases, milestones,
+ * overlays. The viewer's vocabulary maps each member to a human label, so
+ * every id added here needs a paired vocabulary row in the viewer
+ * (`telemetry-vocabulary.ts`).
+ */
+type EventId = 'region-resolving' | 'signaling-connection' | 'webrtc-negotiation' | 'unreal-communication' | 'region-ping-fetch-start' | 'region-ping-fetch-end' | 'region-resolved' | 'polling-started' | 'polling-ended' | 'aws-instance-resolved' | 'signaling-ws-connected' | 'instance-reserved' | 'instance-ready' | 'config-received' | 'ssinfo-received' | 'offer-received' | 'answer-sent' | 'answer-received' | 'first-ice-candidate' | 'last-ice-candidate' | 'datachannel-connected' | 'first-command-started' | 'loopback-sent' | 'loopback-received' | 'viewport-ready' | 'polling-to-instance' | 'signaling-handshake' | 'stabilization-warmup';
+/**
+ * High-level cause of `stream.session_ended`.
+ *  - `disconnected` — Cirrus/WebRTC dropped us mid-stream (granular cause
+ *    rides in {@link SessionEndedData.disconnectReason}).
+ *  - `pagehide` — tab closed / evicted to bfcache.
+ *  - `restart` — a new connection attempt superseded this session.
+ *  - `destroy` — the scene component was torn down (route change).
+ */
+type SessionEndReason = 'disconnected' | 'pagehide' | 'restart' | 'destroy';
+/** Which retry loop in `SignallingService` fired. Mirrors the
+ *  `signalingRetryAttempted` action's `kind`. */
+type SignalingRetryKind = 'ws-retry' | 'connect' | 'orchestration' | 'region-cycle';
+/**
+ * Statistical summary of a time-series metric (bitrate, fps, qp, jitter,
+ * rtt) over one aggregation window (5 s, ~20 samples at 250 ms).
+ *
+ * - `p50` — the typical tick; robust to outliers, primary dashboard signal.
+ * - `p95` — the bad tail where HIGH is bad (rtt, jitter, qp).
+ * - `p05` — the bad tail where HIGH is good (fps, bitrate). Consumers need a
+ *   robust low end, and `min` cannot serve: it is a single tick, so one
+ *   dropped frame defines the window. Sent for every metric so the shape
+ *   stays uniform; only fps and bitrate have a reason to read it.
+ *
+ * All three percentiles use linear interpolation between order statistics
+ * (type 7), matching the consumer's `percentile()` so the word means one
+ * thing across both repos.
+ * - `min` — worst single tick (freeze detection).
+ * - `max` — best single tick (did we ever reach the target?).
+ *
+ * Every field is a percentile of the SAME window, so a consumer may compare
+ * them to each other — but must never average them across windows to obtain
+ * a population percentile.
+ */
+interface WindowAggregate {
+    readonly p50: number;
+    readonly p95: number;
+    readonly p05: number;
+    readonly min: number;
+    readonly max: number;
+}
+/** Milestone pin inside a phase. `id` is stable and kebab-case; the human
+ *  label lives in the viewer's vocabulary. `time` is anchor-relative ms. */
+interface EmittedMilestone {
+    readonly id: EventId;
+    readonly time: number;
+}
+/** Display key/value row, rendered verbatim in the viewer's phase tooltip.
+ *  Always primitives — structured values are pre-formatted by the phase
+ *  closer before flattening. */
+interface PhaseParam {
+    readonly key: string;
+    readonly value: string;
+}
+/** Diagonal-striped region inside a phase bar. Endpoints are
+ *  anchor-relative ms, already resolved by the producer. */
+interface PhaseOverlay {
+    readonly fromMs: number;
+    readonly toMs: number;
+    readonly id: EventId;
+}
+/**
+ * One side of the selected ICE pair, as the browser reports it. Every field is
+ * optional — a browser that does not expose one leaves it unknown.
+ *
+ * `address` / `port` are the ALLOCATED relay endpoint and are only kept for a
+ * relay candidate (host / srflx addresses are never uploaded). They are not
+ * the TURN service endpoint: that one lives in `url`, and the browser→TURN
+ * transport in `relayProtocol` — `protocol` is the candidate's own transport,
+ * relay→peer. `url` / `relayProtocol` exist on the local side only.
+ */
+interface IceCandidateInfo {
+    readonly type?: string;
+    readonly protocol?: string;
+    readonly address?: string;
+    readonly port?: number;
+    readonly url?: string;
+    readonly relayProtocol?: string;
+}
+/** Route description shipped once per {@link RouteSegment.ref} in `stream.sample.routes`. */
+interface IceRoute {
+    readonly local: IceCandidateInfo;
+    readonly remote: IceCandidateInfo;
+}
+/**
+ * Selected WebRTC ICE candidate pair, read off `AggregatedStat` — resolved
+ * through `transport.selectedCandidatePairId`. Flattened to `localCandidate` /
+ * `remoteCandidate` params by the viewport closer.
+ *
+ * `ref` is `<pcEpoch>:<candidatePairId>`: a pair id is only unique inside one
+ * RTCPeerConnection, so the epoch (bumped per attached connection) keeps a
+ * reconnect from reusing the previous connection's ref. The counters are the
+ * PAIR's cumulative payload bytes — they start at 0 with the pair, so they
+ * never mix across pairs or connections.
+ */
+interface SelectedIceCandidatePair extends IceRoute {
+    readonly ref: string;
+    /** Stats timestamp of the pair report, ms. */
+    readonly timestamp?: number;
+    readonly bytesReceived?: number;
+    readonly bytesSent?: number;
+}
+/**
+ * One uninterrupted run of 250 ms stats reads on the same pair inside a
+ * `stream.sample` window. Each tuple is `[first, last]` read of that run:
+ * stats timestamp, and the pair's cumulative `bytesReceived` / `bytesSent`
+ * (`null` when the browser did not report it).
+ *
+ * Time between two segments — inside a window or across windows — was not
+ * observed on any pair and is unattributable; a consumer must not stretch
+ * either neighbour over it.
+ */
+interface RouteSegment {
+    readonly ref: string;
+    readonly ts: readonly [number | null, number | null];
+    readonly rx: readonly [number | null, number | null];
+    readonly tx: readonly [number | null, number | null];
+}
+/** Resource Timing totals for one `initiatorType` (or the grand total).
+ *  `durationMs` is the SUM across the bucket — with `count` it yields the
+ *  average per request, and `maxDurationMs` the slowest single one. */
+interface ResourceBucket {
+    readonly count: number;
+    /** `transferSize === 0 && decodedBodySize > 0` — served from HTTP cache. */
+    readonly cachedCount: number;
+    readonly transferSize: number;
+    readonly encodedBodySize: number;
+    readonly decodedBodySize: number;
+    readonly durationMs: number;
+    readonly maxDurationMs: number;
+}
+interface ResourceTotals extends ResourceBucket {
+    readonly byType: Record<string, ResourceBucket>;
+}
+/** One entry of {@link BootstrapInfo.slowestResources}. */
+interface SlowResource {
+    /** Path only — origin and query stripped (short, stable, no PII). */
+    readonly name: string;
+    /** Resource Timing `initiatorType`: 'script' | 'css' | 'img' | 'fetch' | … */
+    readonly type: string;
+    /** `responseEnd − startTime`, ms. */
+    readonly durationMs: number;
+    /** Bytes over the wire (0 = served from cache). */
+    readonly transferKb: number;
+    /** Fetched after `window.load` (lazy route chunk) vs. during page load. */
+    readonly lazy: boolean;
+}
+/** Navigation / page-load context explaining the "app bootstrap →
+ *  session_started" waterfall row. `null` when the Navigation Timing entry
+ *  is unavailable. */
+interface BootstrapInfo {
+    /** `'navigate' | 'reload' | 'back_forward' | 'prerender'`. */
+    readonly type: NavigationTimingType;
+    /** `nextHopProtocol` — 'h2' / 'h3' / 'http/1.1'. */
+    readonly protocol: string | null;
+    readonly firstByteMs: number;
+    readonly domInteractiveMs: number;
+    readonly domContentLoadedMs: number;
+    readonly loadEventMs: number;
+    readonly navigationTransferSize: number | null;
+    readonly navigationEncodedBodySize: number | null;
+    readonly navigationDecodedBodySize: number | null;
+    /** Resources fetched **before** `loadEventEnd` — page weight. */
+    readonly resources: ResourceTotals | null;
+    /** Resources fetched **after** `loadEventEnd` — typically lazy chunks for
+     *  the route the streamer lives on. */
+    readonly lazyResources: ResourceTotals | null;
+    /** Top-8 slowest individual resources, so the viewer can name the
+     *  offending file / endpoint. */
+    readonly slowestResources: readonly SlowResource[];
+}
+/** Fields present on EVERY event. `userId` is attached centrally by
+ *  `track()`; the server buckets files under `data/<userId>/<sessionId>`. */
+interface TelemetryEventEnvelope {
+    readonly userId: string;
+    /**
+     * The stream's connection id (`selectCirrusConnectionId`) — the id Cirrus
+     * runs this player under, shown as "Connection Id" in the debug overlay. Falls
+     * back to a locally generated uuid only when the attempt never got one.
+     * Stamped centrally by `track()`, so the value the emitters pass is ignored.
+     */
+    readonly sessionId: string;
+}
+/** Lifecycle events additionally carry a phase-local `duration` — ms since
+ *  the previous lifecycle event, NOT anchor-relative. */
+interface TelemetryLifecycleEnvelope extends TelemetryEventEnvelope {
+    readonly duration: number;
+}
+/** `stream.session_started` — once per real connection attempt.
+ *  `duration` = full page-load elapsed on the first session, 0 on resume. */
+interface SessionStartedData extends TelemetryLifecycleEnvelope {
+    readonly startTimeUtc: string;
+    readonly pixelRatio: number;
+    /** `window.innerWidth/innerHeight` at session start — the container that
+     *  gates rendered video resolution, not the physical screen. */
+    readonly browserInnerSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly userAgent: string;
+    readonly sampleWindowMs: number;
+    /** `location.href` — the server-observed `Referer` is origin-truncated. */
+    readonly pageUrl: string;
+    readonly bootstrapInfo?: BootstrapInfo;
+}
+/** `stream.phase_ended` — once per phase closer in the service's catalog.
+ *  No display text on the wire; the viewer's vocabulary resolves every id. */
+interface PhaseEndedData extends TelemetryLifecycleEnvelope {
+    /** Stable 1-based catalog index — the viewer orders phases by this. */
+    readonly phaseNo: number;
+    readonly id: EventId;
+    /** CSS hex color for the bar fill. */
+    readonly color: string;
+    readonly milestones: readonly EmittedMilestone[];
+    readonly params: readonly PhaseParam[];
+    readonly overlays: readonly PhaseOverlay[];
+    /** Set on the connection phases of an ADOPTED prefetched stream: the
+     *  handshake ran in parallel with page load, so the bar is positioned at
+     *  {@link spanStartMs} (left-shifted) instead of sequentially. */
+    readonly prefetched?: boolean;
+    /** Anchor-relative start (ms) of a {@link prefetched} phase's bar. */
+    readonly spanStartMs?: number;
+    /** Anchor-relative moment Angular adopted the prefetched connection — the
+     *  sequential timeline resumes here. */
+    readonly adoptionAtMs?: number;
+    /** The session ended while this phase was running — its closer never fired.
+     *  Sent right before `session_ended` with the milestones reached so far and
+     *  no params, so the viewer can show the step the connection died on. */
+    readonly incomplete?: true;
+}
+/** `stream.session_ended` — once per session, on disconnect / pagehide /
+ *  restart / destroy. Requires `api_transport: 'sendBeacon'` to survive a
+ *  tab close. */
+interface SessionEndedData extends TelemetryLifecycleEnvelope {
+    readonly reason: SessionEndReason;
+    /** Granular cause read from store state. Omitted when state is clean. */
+    readonly disconnectReason?: DisconnectReasonType;
+    /** Free-text message paired with {@link disconnectReason}, only when the
+     *  originating action carried one (e.g. `"Manual Console Drop"`). */
+    readonly disconnectMessage?: string;
+    readonly timestamp: string;
+}
+/** `stream.sample` — every 5 s, window-aggregated. `seq` is monotonic per
+ *  session for server-side ordering & dedup. */
+interface SampleData extends TelemetryEventEnvelope {
+    readonly seq: number;
+    readonly timestamp: string;
+    readonly sampleCount: number;
+    readonly visibilityState: DocumentVisibilityState;
+    readonly bitrate: WindowAggregate;
+    readonly fps: WindowAggregate;
+    readonly qp: WindowAggregate;
+    readonly jitter: WindowAggregate;
+    readonly rtt: WindowAggregate;
+    readonly packetsLost?: number;
+    /**
+     * Bytes the video stream delivered DURING this window — how far
+     * `inbound-rtp.bytesReceived` moved since the previous window closed, not a
+     * running total.
+     *
+     * What turns a bandwidth figure on the receiving end into a measurement.
+     * Volume needs the window's MEAN bitrate; {@link bitrate} carries
+     * p50/p95/min/max and no mean, so without this a consumer has to work the
+     * volume out from the median — which runs low on a stream that spikes at
+     * every keyframe.
+     *
+     * A delta rather than the cumulative counter on purpose: a cumulative value
+     * is only usable if the previous sample survived the trip, so one dropped
+     * POST would move bytes silently into the next window.
+     *
+     * Omitted when the counter is missing or went backwards (a renegotiation
+     * restarts it) — see `CounterWindow`. A consumer reads the gap as "estimate
+     * this window from the bitrate", which is the honest reading; it must never
+     * treat a missing value as zero bytes.
+     */
+    readonly bytes?: number;
+    readonly viewPort: {
+        readonly width?: number;
+        readonly height?: number;
+    };
+    /** Selected-pair runs seen in this window, in order. Omitted when no read
+     *  of the window resolved a selected pair — the whole window is unknown. */
+    readonly routeSegments?: readonly RouteSegment[];
+    /** Full description of every ref seen for the FIRST time in this session.
+     *  Later windows carry only the ref. */
+    readonly routes?: Readonly<Record<string, IceRoute>>;
+}
+/** `stream.quality_degraded` / `stream.quality_recovered` — QP p50 crossing
+ *  the red threshold (35) in either direction. */
+interface QualityAnomalyData extends TelemetryEventEnvelope {
+    readonly seq: number;
+    readonly timestamp: string;
+    readonly qpP50: number;
+    readonly qpP95: number;
+}
+/** `stream.fps_low` — window FPS p50 dropped below 70% of the target. */
+interface FpsLowData extends TelemetryEventEnvelope {
+    readonly seq: number;
+    readonly timestamp: string;
+    /** Requested `maxFps`; `0` means unlimited. */
+    readonly target: number;
+    /** Target actually compared against (60 when `target === 0`). */
+    readonly referenceTarget: number;
+    readonly fpsP50: number;
+    readonly fpsP95: number;
+}
+/** `stream.signaling_retry` — one per `retry({ delay })` fire in
+ *  `SignallingService`. Surfaced in the viewer's Anomalies table. */
+interface SignalingRetryData extends TelemetryEventEnvelope {
+    readonly seq: number;
+    readonly timestamp: string;
+    readonly attempt: number;
+    readonly reason: string;
+    readonly kind: SignalingRetryKind;
+}
+/** Event name → payload. The authoritative index of the wire taxonomy. */
+interface StreamTelemetryEventMap {
+    'stream.session_started': SessionStartedData;
+    'stream.phase_ended': PhaseEndedData;
+    'stream.session_ended': SessionEndedData;
+    'stream.sample': SampleData;
+    'stream.quality_degraded': QualityAnomalyData;
+    'stream.quality_recovered': QualityAnomalyData;
+    'stream.fps_low': FpsLowData;
+    'stream.signaling_retry': SignalingRetryData;
+}
+type StreamTelemetryEventName = keyof StreamTelemetryEventMap;
+/** Names emitted via `emitLifecycle` — the three `duration`-carrying events. */
+type StreamTelemetryLifecycleEventName = 'stream.session_started' | 'stream.phase_ended' | 'stream.session_ended';
+/** Discriminated union of every `trackTelemetryData` envelope. */
+type StreamTelemetryEvent = {
+    [K in StreamTelemetryEventName]: {
+        readonly event: K;
+        readonly data: StreamTelemetryEventMap[K];
+    };
+}[StreamTelemetryEventName];
+/** Payload a caller supplies to `track()` — `userId` is added centrally. */
+type StreamTelemetryTrackData<K extends StreamTelemetryEventName> = Omit<StreamTelemetryEventMap[K], 'userId'>;
+/** Payload a caller supplies to `emitLifecycle()` — `duration` is computed. */
+type StreamTelemetryLifecycleData<K extends StreamTelemetryLifecycleEventName> = Omit<StreamTelemetryEventMap[K], 'userId' | 'duration'>;
+
 interface AggregatedStat {
     quality: Quality;
     aggregatedStats: InboundVideoStats;
@@ -582,16 +944,7 @@ interface InboundVideoStats extends RTCInboundRtpStreamStats {
     videoCodec: string;
     avgBitrate: number;
     avgFrameRate: number;
-    selectedPair: {
-        local: {
-            type: string;
-            url: string;
-        };
-        remote: {
-            type: string;
-            url: string;
-        };
-    } | null;
+    selectedPair: SelectedIceCandidatePair | null;
     currentRoundTripTime: number;
     codecs: Record<string, string>;
     receiveToCompositeMs: number;
@@ -670,559 +1023,246 @@ interface ParkedStream {
      * Socket flow only — parked so the service can tear it down.
      */
     controlWs?: WebSocket;
-    /** `peerConnectionOptions` the machine sent in its `config` message */
-    config?: RTCConfiguration;
-    /**
-     * Reused as-is, none generated: `clientId`/`viewId` from the configurator
-     * cache (same values the host app dispatches), `correlationId` is the
-     * configurator id, `streamRequestId` comes from the orchestration.
-     */
-    ids: {
-        clientId: string;
-        viewId: string;
-        correlationId: string;
-        streamRequestId?: string;
-    };
-    /** DataChannel messages received before adoption, replayed on adopt */
-    dcBuffer: ArrayBuffer[];
-    /** `performance.now()` marks for the prefetch waterfall (telemetry) */
-    timings: Record<string, number>;
-    failReason?: string;
-    failError?: string;
-    /** Stops the script's watchdog and flips state to `adopted`. */
-    adopt: () => ParkedStream;
-    /**
-     * One-shot callback fired the instant the stream settles; on the next
-     * microtask if already settled. Required — adoption waits on it.
-     */
-    onSettled: (cb: (state: ParkedStream['state']) => void) => void;
-}
-/** Marker the service writes when it finds the slot free and connects itself. */
-interface AppOwnedStream {
-    owner: 'app';
-}
-/** True when the slot is the app's own marker rather than a prefetched stream. */
-declare function isAppOwned(slot: ParkedStream | AppOwnedStream): slot is AppOwnedStream;
-declare global {
-    interface Window {
-        /**
-         * The page's stream slot AND the lock: first writer owns the connection,
-         * whoever finds it taken stands down. Both sides read-then-write with no
-         * `await` between, so exactly one wins and a page never builds two
-         * connections. An older script writes no `owner` — still "taken".
-         */
-        __stream?: ParkedStream | AppOwnedStream;
-    }
-}
-
-interface InputProps {
-    controlScheme: ControlSchemeValues;
-    suppressBrowserKeys: boolean;
-}
-
-declare const OrchestrationMessageTypes: {
-    readonly error: "error";
-    readonly offer: "offer";
-    readonly answer: "answer";
-    readonly ssInfo: "ssInfo";
-    readonly config: "config";
-    readonly playerCount: "playerCount";
-    readonly iceCandidate: "iceCandidate";
-    readonly streamerList: "streamerList";
-    readonly requestStream: "requestStream";
-    readonly listStreamers: "listStreamers";
-    readonly instanceReady: "instanceReady";
-    readonly p2pEstablished: "p2pEstablished";
-    readonly instanceReserved: "instanceReserved";
-    readonly interruptClientStream: "interruptClientStream";
-};
-interface InstanceReady extends MessageBase {
-    type: 'instanceReady';
-    correlationId: string;
-    payload: {
-        instanceId: string;
-        originInstanceId: string;
-        ipAddress: string;
-        streamRequestId: string;
-        originInstanceUri: string;
-    };
-}
-interface InstanceReserved extends InstanceMessageBase {
-    type: 'instanceReserved';
-}
-interface OrchestrationErrorMessage {
-    type: 'error';
-    payload: {
-        code: number;
-        message: string;
-    };
-}
-interface InstanceMessageBase extends MessageBase {
-    correlationId: string;
-    payload: {
-        instanceId: string;
-        streamRequestId: string;
-        eta: number;
-    };
-}
-interface MessageBase {
-    type: OrchestrationMessageType;
-}
-interface SSInfo extends MessageBase {
-    type: 'ssInfo';
-    message: string;
-    data: SignalingData;
-}
-interface PlayerCountMessage extends MessageBase {
-    type: 'playerCount';
-    playerCount: number;
-}
-interface StreamerListMessage extends MessageBase {
-    type: 'streamerList';
-    ids: string[];
-}
-interface ConfigMessage extends MessageBase, UnknownFields {
-    type: 'config';
-    peerConnectionOptions: RTCConfiguration;
-}
-interface CandidateMessage extends MessageBase {
-    type: 'iceCandidate';
-    candidate: RTCIceCandidate;
-}
-type UnknownFields = Record<string, unknown>;
-interface InterruptClientStream extends MessageBase {
-    type: 'interruptClientStream';
-    correlationId: string;
-    payload: {
-        environmentId: string;
-    };
-}
-interface ListStreamersMessage extends MessageBase {
-    type: 'listStreamers';
-    correlationId: string;
-}
-interface P2PEstablishedMessage extends MessageBase {
-    type: 'p2pEstablished';
-    source: string;
-    sessionId: string;
-}
-interface RequestStream extends MessageBase {
-    type: 'requestStream';
-    correlationId: string;
-    payload: {
-        environmentId: string;
-        region?: string;
-        /**
-         * The context field is used for plugins of the external
-         * applications for collecting additional statistics, etc.
-         */
-        context: StreamRequestContext;
-    };
-}
-interface MetaboxBasicConfiguratorContext {
-    id: 'metaboxBasicConfigurator';
-    data: {
-        configuratorId: string;
-    };
-}
-interface MetaboxModularConfiguratorContext {
-    id: 'metaboxModularConfigurator';
-    data: {
-        configuratorId: string;
-    };
-}
-interface MetaboxProductContext {
-    id: 'metaboxProduct';
-    data: {
-        productId: string;
-    };
-}
-interface MetaboxEnvironmentContext {
-    id: 'metaboxEnvironment';
-    data: {
-        environmentId: string;
-    };
-}
-interface MetaboxStudioContext {
-    id: 'metaboxStudio';
-    data: {
-        userId: string;
-        workspaceId: string;
-    };
-}
-interface CustomApplicationContext {
-    id: 'customApplication';
-    data: {
-        clientId: string;
-        applicationId: string;
-    };
-}
-interface MetaboxCustomApplicationContext {
-    id: 'metaboxCustomApplication';
-    data: {
-        clientId: string;
-    };
-}
-type StreamRequestContext = MetaboxStudioContext | MetaboxProductContext | CustomApplicationContext | MetaboxCustomApplicationContext | MetaboxEnvironmentContext | MetaboxBasicConfiguratorContext | MetaboxModularConfiguratorContext;
-interface SignalingMessageMap {
-    [OrchestrationMessageTypes.offer]: RTCSessionDescriptionInit;
-    [OrchestrationMessageTypes.error]: OrchestrationErrorMessage;
-    [OrchestrationMessageTypes.ssInfo]: SSInfo;
-    [OrchestrationMessageTypes.config]: ConfigMessage;
-    [OrchestrationMessageTypes.answer]: RTCSessionDescriptionInit;
-    [OrchestrationMessageTypes.playerCount]: PlayerCountMessage;
-    [OrchestrationMessageTypes.iceCandidate]: CandidateMessage;
-    [OrchestrationMessageTypes.streamerList]: StreamerListMessage;
-    [OrchestrationMessageTypes.instanceReady]: InstanceReady;
-    [OrchestrationMessageTypes.requestStream]: RequestStream;
-    [OrchestrationMessageTypes.listStreamers]: ListStreamersMessage;
-    [OrchestrationMessageTypes.p2pEstablished]: P2PEstablishedMessage;
-    [OrchestrationMessageTypes.instanceReserved]: InstanceReserved;
-    [OrchestrationMessageTypes.interruptClientStream]: InterruptClientStream;
-}
-type OrchestrationMessageType = keyof SignalingMessageMap;
-type AnySignalingMessage = SignalingMessageMap[OrchestrationMessageType] | string;
-type SignalingMessageHandler<T extends keyof SignalingMessageMap> = (msg: SignalingMessageMap[T]) => void;
-interface PollingOrchestrationMessage {
-    mm_message?: string;
-    signallingServer?: string;
+    /** `peerConnectionOptions` the machine sent in its `config` message */
+    config?: RTCConfiguration;
     /**
-     * Connection id issued by the orchestration for this stream request. Kept
-     * internally as `connectionId` and handed to Cirrus on the WS upgrade URL.
-     * Absent on older backends — Cirrus then generates one itself.
+     * Reused as-is, none generated: `clientId`/`viewId` from the configurator
+     * cache (same values the host app dispatches), `correlationId` is the
+     * configurator id, `streamRequestId` comes from the orchestration.
      */
-    streamRequestId?: string;
-    error?: string;
-    info?: {
-        age: number | null;
-        left: number | null;
-        percent: number | null;
-        total: number | null;
+    ids: {
+        clientId: string;
+        viewId: string;
+        correlationId: string;
+        streamRequestId?: string;
     };
+    /** DataChannel messages received before adoption, replayed on adopt */
+    dcBuffer: ArrayBuffer[];
+    /** `performance.now()` marks for the prefetch waterfall (telemetry) */
+    timings: Record<string, number>;
+    failReason?: string;
+    failError?: string;
+    /** Stops the script's watchdog and flips state to `adopted`. */
+    adopt: () => ParkedStream;
+    /**
+     * One-shot callback fired the instant the stream settles; on the next
+     * microtask if already settled. Required — adoption waits on it.
+     */
+    onSettled: (cb: (state: ParkedStream['state']) => void) => void;
 }
-
-interface StreamConfig {
-    autoStart: boolean;
-    warnTimeout: number;
+/** Marker the service writes when it finds the slot free and connects itself. */
+interface AppOwnedStream {
+    owner: 'app';
 }
-
-interface StreamResolutionProps {
-    width: number | null;
-    height: number | null;
+/** True when the slot is the app's own marker rather than a prefetched stream. */
+declare function isAppOwned(slot: ParkedStream | AppOwnedStream): slot is AppOwnedStream;
+declare global {
+    interface Window {
+        /**
+         * The page's stream slot AND the lock: first writer owns the connection,
+         * whoever finds it taken stands down. Both sides read-then-write with no
+         * `await` between, so exactly one wins and a page never builds two
+         * connections. An older script writes no `owner` — still "taken".
+         */
+        __stream?: ParkedStream | AppOwnedStream;
+    }
 }
 
-/**
- * Wire contract for every event `StreamStatusTelemetryService2` dispatches
- * through `trackTelemetryData`.
- *
- * This file is the **single source of truth** for the producer side. The
- * consumer side lives in the telemetry viewer
- * (`253.StreamTelemetry/src/app/telemetry/models/telemetry.types.ts`) — any
- * change here needs a paired edit there.
- *
- * Event taxonomy (8 names, 6 payload shapes):
- *  | event                      | payload                            |
- *  |----------------------------|------------------------------------|
- *  | `stream.session_started`   | {@link SessionStartedData}         |
- *  | `stream.phase_ended`       | {@link PhaseEndedData}             |
- *  | `stream.session_ended`     | {@link SessionEndedData}           |
- *  | `stream.sample`            | {@link SampleData}                 |
- *  | `stream.quality_degraded`  | {@link QualityAnomalyData}         |
- *  | `stream.quality_recovered` | {@link QualityAnomalyData}         |
- *  | `stream.fps_low`           | {@link FpsLowData}                 |
- *  | `stream.signaling_retry`   | {@link SignalingRetryData}         |
- */
-/**
- * Every stable id the service can put on the wire — phases, milestones,
- * overlays. The viewer's vocabulary maps each member to a human label, so
- * every id added here needs a paired vocabulary row in the viewer
- * (`telemetry-vocabulary.ts`).
- */
-type EventId = 'region-resolving' | 'signaling-connection' | 'webrtc-negotiation' | 'unreal-communication' | 'region-ping-fetch-start' | 'region-ping-fetch-end' | 'region-resolved' | 'polling-started' | 'polling-ended' | 'aws-instance-resolved' | 'signaling-ws-connected' | 'instance-reserved' | 'instance-ready' | 'config-received' | 'ssinfo-received' | 'offer-received' | 'answer-sent' | 'answer-received' | 'first-ice-candidate' | 'last-ice-candidate' | 'datachannel-connected' | 'first-command-started' | 'loopback-sent' | 'loopback-received' | 'viewport-ready' | 'polling-to-instance' | 'signaling-handshake' | 'stabilization-warmup';
-/**
- * High-level cause of `stream.session_ended`.
- *  - `disconnected` — Cirrus/WebRTC dropped us mid-stream (granular cause
- *    rides in {@link SessionEndedData.disconnectReason}).
- *  - `pagehide` — tab closed / evicted to bfcache.
- *  - `restart` — a new connection attempt superseded this session.
- *  - `destroy` — the scene component was torn down (route change).
- */
-type SessionEndReason = 'disconnected' | 'pagehide' | 'restart' | 'destroy';
-/** Which retry loop in `SignallingService` fired. Mirrors the
- *  `signalingRetryAttempted` action's `kind`. */
-type SignalingRetryKind = 'ws-retry' | 'connect' | 'orchestration' | 'region-cycle';
-/**
- * Statistical summary of a time-series metric (bitrate, fps, qp, jitter,
- * rtt) over one aggregation window (5 s, ~20 samples at 250 ms).
- *
- * - `p50` — the typical tick; robust to outliers, primary dashboard signal.
- * - `p95` — the bad tail where HIGH is bad (rtt, jitter, qp).
- * - `p05` — the bad tail where HIGH is good (fps, bitrate). Consumers need a
- *   robust low end, and `min` cannot serve: it is a single tick, so one
- *   dropped frame defines the window. Sent for every metric so the shape
- *   stays uniform; only fps and bitrate have a reason to read it.
- *
- * All three percentiles use linear interpolation between order statistics
- * (type 7), matching the consumer's `percentile()` so the word means one
- * thing across both repos.
- * - `min` — worst single tick (freeze detection).
- * - `max` — best single tick (did we ever reach the target?).
- *
- * Every field is a percentile of the SAME window, so a consumer may compare
- * them to each other — but must never average them across windows to obtain
- * a population percentile.
- */
-interface WindowAggregate {
-    readonly p50: number;
-    readonly p95: number;
-    readonly p05: number;
-    readonly min: number;
-    readonly max: number;
-}
-/** Milestone pin inside a phase. `id` is stable and kebab-case; the human
- *  label lives in the viewer's vocabulary. `time` is anchor-relative ms. */
-interface EmittedMilestone {
-    readonly id: EventId;
-    readonly time: number;
+interface InputProps {
+    controlScheme: ControlSchemeValues;
+    suppressBrowserKeys: boolean;
 }
-/** Display key/value row, rendered verbatim in the viewer's phase tooltip.
- *  Always primitives — structured values are pre-formatted by the phase
- *  closer before flattening. */
-interface PhaseParam {
-    readonly key: string;
-    readonly value: string;
+
+declare const OrchestrationMessageTypes: {
+    readonly error: "error";
+    readonly offer: "offer";
+    readonly answer: "answer";
+    readonly ssInfo: "ssInfo";
+    readonly config: "config";
+    readonly playerCount: "playerCount";
+    readonly iceCandidate: "iceCandidate";
+    readonly streamerList: "streamerList";
+    readonly requestStream: "requestStream";
+    readonly listStreamers: "listStreamers";
+    readonly instanceReady: "instanceReady";
+    readonly p2pEstablished: "p2pEstablished";
+    readonly instanceReserved: "instanceReserved";
+    readonly interruptClientStream: "interruptClientStream";
+};
+interface InstanceReady extends MessageBase {
+    type: 'instanceReady';
+    correlationId: string;
+    payload: {
+        instanceId: string;
+        originInstanceId: string;
+        ipAddress: string;
+        streamRequestId: string;
+        originInstanceUri: string;
+    };
 }
-/** Diagonal-striped region inside a phase bar. Endpoints are
- *  anchor-relative ms, already resolved by the producer. */
-interface PhaseOverlay {
-    readonly fromMs: number;
-    readonly toMs: number;
-    readonly id: EventId;
+interface InstanceReserved extends InstanceMessageBase {
+    type: 'instanceReserved';
 }
-/** Selected WebRTC ICE candidate pair, read off `AggregatedStat`. Flattened
- *  to `localCandidate` / `remoteCandidate` params by the viewport closer. */
-interface SelectedIceCandidatePair {
-    readonly local: {
-        type: string;
-        url: string;
+interface OrchestrationErrorMessage {
+    type: 'error';
+    payload: {
+        code: number;
+        message: string;
     };
-    readonly remote: {
-        type: string;
-        url: string;
+}
+interface InstanceMessageBase extends MessageBase {
+    correlationId: string;
+    payload: {
+        instanceId: string;
+        streamRequestId: string;
+        eta: number;
     };
 }
-/** Resource Timing totals for one `initiatorType` (or the grand total).
- *  `durationMs` is the SUM across the bucket — with `count` it yields the
- *  average per request, and `maxDurationMs` the slowest single one. */
-interface ResourceBucket {
-    readonly count: number;
-    /** `transferSize === 0 && decodedBodySize > 0` — served from HTTP cache. */
-    readonly cachedCount: number;
-    readonly transferSize: number;
-    readonly encodedBodySize: number;
-    readonly decodedBodySize: number;
-    readonly durationMs: number;
-    readonly maxDurationMs: number;
+interface MessageBase {
+    type: OrchestrationMessageType;
 }
-interface ResourceTotals extends ResourceBucket {
-    readonly byType: Record<string, ResourceBucket>;
+interface SSInfo extends MessageBase {
+    type: 'ssInfo';
+    message: string;
+    data: SignalingData;
 }
-/** One entry of {@link BootstrapInfo.slowestResources}. */
-interface SlowResource {
-    /** Path only — origin and query stripped (short, stable, no PII). */
-    readonly name: string;
-    /** Resource Timing `initiatorType`: 'script' | 'css' | 'img' | 'fetch' | … */
-    readonly type: string;
-    /** `responseEnd − startTime`, ms. */
-    readonly durationMs: number;
-    /** Bytes over the wire (0 = served from cache). */
-    readonly transferKb: number;
-    /** Fetched after `window.load` (lazy route chunk) vs. during page load. */
-    readonly lazy: boolean;
+interface PlayerCountMessage extends MessageBase {
+    type: 'playerCount';
+    playerCount: number;
 }
-/** Navigation / page-load context explaining the "app bootstrap →
- *  session_started" waterfall row. `null` when the Navigation Timing entry
- *  is unavailable. */
-interface BootstrapInfo {
-    /** `'navigate' | 'reload' | 'back_forward' | 'prerender'`. */
-    readonly type: NavigationTimingType;
-    /** `nextHopProtocol` — 'h2' / 'h3' / 'http/1.1'. */
-    readonly protocol: string | null;
-    readonly firstByteMs: number;
-    readonly domInteractiveMs: number;
-    readonly domContentLoadedMs: number;
-    readonly loadEventMs: number;
-    readonly navigationTransferSize: number | null;
-    readonly navigationEncodedBodySize: number | null;
-    readonly navigationDecodedBodySize: number | null;
-    /** Resources fetched **before** `loadEventEnd` — page weight. */
-    readonly resources: ResourceTotals | null;
-    /** Resources fetched **after** `loadEventEnd` — typically lazy chunks for
-     *  the route the streamer lives on. */
-    readonly lazyResources: ResourceTotals | null;
-    /** Top-8 slowest individual resources, so the viewer can name the
-     *  offending file / endpoint. */
-    readonly slowestResources: readonly SlowResource[];
+interface StreamerListMessage extends MessageBase {
+    type: 'streamerList';
+    ids: string[];
+}
+interface ConfigMessage extends MessageBase, UnknownFields {
+    type: 'config';
+    peerConnectionOptions: RTCConfiguration;
+}
+interface CandidateMessage extends MessageBase {
+    type: 'iceCandidate';
+    candidate: RTCIceCandidate;
+}
+type UnknownFields = Record<string, unknown>;
+interface InterruptClientStream extends MessageBase {
+    type: 'interruptClientStream';
+    correlationId: string;
+    payload: {
+        environmentId: string;
+    };
 }
-/** Fields present on EVERY event. `userId` is attached centrally by
- *  `track()`; the server buckets files under `data/<userId>/<sessionId>`. */
-interface TelemetryEventEnvelope {
-    readonly userId: string;
-    /**
-     * The stream's connection id (`selectCirrusConnectionId`) — the id Cirrus
-     * runs this player under, shown as "Connection Id" in the debug overlay. Falls
-     * back to a locally generated uuid only when the attempt never got one.
-     * Stamped centrally by `track()`, so the value the emitters pass is ignored.
-     */
-    readonly sessionId: string;
+interface ListStreamersMessage extends MessageBase {
+    type: 'listStreamers';
+    correlationId: string;
 }
-/** Lifecycle events additionally carry a phase-local `duration` — ms since
- *  the previous lifecycle event, NOT anchor-relative. */
-interface TelemetryLifecycleEnvelope extends TelemetryEventEnvelope {
-    readonly duration: number;
+interface P2PEstablishedMessage extends MessageBase {
+    type: 'p2pEstablished';
+    source: string;
+    sessionId: string;
 }
-/** `stream.session_started` — once per real connection attempt.
- *  `duration` = full page-load elapsed on the first session, 0 on resume. */
-interface SessionStartedData extends TelemetryLifecycleEnvelope {
-    readonly startTimeUtc: string;
-    readonly pixelRatio: number;
-    /** `window.innerWidth/innerHeight` at session start — the container that
-     *  gates rendered video resolution, not the physical screen. */
-    readonly browserInnerSize: {
-        readonly width: number;
-        readonly height: number;
+interface RequestStream extends MessageBase {
+    type: 'requestStream';
+    correlationId: string;
+    payload: {
+        environmentId: string;
+        region?: string;
+        /**
+         * The context field is used for plugins of the external
+         * applications for collecting additional statistics, etc.
+         */
+        context: StreamRequestContext;
     };
-    readonly userAgent: string;
-    readonly sampleWindowMs: number;
-    /** `location.href` — the server-observed `Referer` is origin-truncated. */
-    readonly pageUrl: string;
-    readonly bootstrapInfo?: BootstrapInfo;
 }
-/** `stream.phase_ended` — once per phase closer in the service's catalog.
- *  No display text on the wire; the viewer's vocabulary resolves every id. */
-interface PhaseEndedData extends TelemetryLifecycleEnvelope {
-    /** Stable 1-based catalog index — the viewer orders phases by this. */
-    readonly phaseNo: number;
-    readonly id: EventId;
-    /** CSS hex color for the bar fill. */
-    readonly color: string;
-    readonly milestones: readonly EmittedMilestone[];
-    readonly params: readonly PhaseParam[];
-    readonly overlays: readonly PhaseOverlay[];
-    /** Set on the connection phases of an ADOPTED prefetched stream: the
-     *  handshake ran in parallel with page load, so the bar is positioned at
-     *  {@link spanStartMs} (left-shifted) instead of sequentially. */
-    readonly prefetched?: boolean;
-    /** Anchor-relative start (ms) of a {@link prefetched} phase's bar. */
-    readonly spanStartMs?: number;
-    /** Anchor-relative moment Angular adopted the prefetched connection — the
-     *  sequential timeline resumes here. */
-    readonly adoptionAtMs?: number;
+interface MetaboxBasicConfiguratorContext {
+    id: 'metaboxBasicConfigurator';
+    data: {
+        configuratorId: string;
+    };
 }
-/** `stream.session_ended` — once per session, on disconnect / pagehide /
- *  restart / destroy. Requires `api_transport: 'sendBeacon'` to survive a
- *  tab close. */
-interface SessionEndedData extends TelemetryLifecycleEnvelope {
-    readonly reason: SessionEndReason;
-    /** Granular cause read from store state. Omitted when state is clean. */
-    readonly disconnectReason?: DisconnectReasonType;
-    /** Free-text message paired with {@link disconnectReason}, only when the
-     *  originating action carried one (e.g. `"Manual Console Drop"`). */
-    readonly disconnectMessage?: string;
-    readonly timestamp: string;
+interface MetaboxModularConfiguratorContext {
+    id: 'metaboxModularConfigurator';
+    data: {
+        configuratorId: string;
+    };
 }
-/** `stream.sample` — every 5 s, window-aggregated. `seq` is monotonic per
- *  session for server-side ordering & dedup. */
-interface SampleData extends TelemetryEventEnvelope {
-    readonly seq: number;
-    readonly timestamp: string;
-    readonly sampleCount: number;
-    readonly visibilityState: DocumentVisibilityState;
-    readonly bitrate: WindowAggregate;
-    readonly fps: WindowAggregate;
-    readonly qp: WindowAggregate;
-    readonly jitter: WindowAggregate;
-    readonly rtt: WindowAggregate;
-    readonly packetsLost?: number;
-    /**
-     * Bytes the video stream delivered DURING this window — how far
-     * `inbound-rtp.bytesReceived` moved since the previous window closed, not a
-     * running total.
-     *
-     * What turns a bandwidth figure on the receiving end into a measurement.
-     * Volume needs the window's MEAN bitrate; {@link bitrate} carries
-     * p50/p95/min/max and no mean, so without this a consumer has to work the
-     * volume out from the median — which runs low on a stream that spikes at
-     * every keyframe.
-     *
-     * A delta rather than the cumulative counter on purpose: a cumulative value
-     * is only usable if the previous sample survived the trip, so one dropped
-     * POST would move bytes silently into the next window.
-     *
-     * Omitted when the counter is missing or went backwards (a renegotiation
-     * restarts it) — see `CounterWindow`. A consumer reads the gap as "estimate
-     * this window from the bitrate", which is the honest reading; it must never
-     * treat a missing value as zero bytes.
-     */
-    readonly bytes?: number;
-    readonly viewPort: {
-        readonly width?: number;
-        readonly height?: number;
+interface MetaboxProductContext {
+    id: 'metaboxProduct';
+    data: {
+        productId: string;
     };
 }
-/** `stream.quality_degraded` / `stream.quality_recovered` — QP p50 crossing
- *  the red threshold (35) in either direction. */
-interface QualityAnomalyData extends TelemetryEventEnvelope {
-    readonly seq: number;
-    readonly timestamp: string;
-    readonly qpP50: number;
-    readonly qpP95: number;
+interface MetaboxEnvironmentContext {
+    id: 'metaboxEnvironment';
+    data: {
+        environmentId: string;
+    };
 }
-/** `stream.fps_low` — window FPS p50 dropped below 70% of the target. */
-interface FpsLowData extends TelemetryEventEnvelope {
-    readonly seq: number;
-    readonly timestamp: string;
-    /** Requested `maxFps`; `0` means unlimited. */
-    readonly target: number;
-    /** Target actually compared against (60 when `target === 0`). */
-    readonly referenceTarget: number;
-    readonly fpsP50: number;
-    readonly fpsP95: number;
+interface MetaboxStudioContext {
+    id: 'metaboxStudio';
+    data: {
+        userId: string;
+        workspaceId: string;
+    };
 }
-/** `stream.signaling_retry` — one per `retry({ delay })` fire in
- *  `SignallingService`. Surfaced in the viewer's Anomalies table. */
-interface SignalingRetryData extends TelemetryEventEnvelope {
-    readonly seq: number;
-    readonly timestamp: string;
-    readonly attempt: number;
-    readonly reason: string;
-    readonly kind: SignalingRetryKind;
+interface CustomApplicationContext {
+    id: 'customApplication';
+    data: {
+        clientId: string;
+        applicationId: string;
+    };
 }
-/** Event name → payload. The authoritative index of the wire taxonomy. */
-interface StreamTelemetryEventMap {
-    'stream.session_started': SessionStartedData;
-    'stream.phase_ended': PhaseEndedData;
-    'stream.session_ended': SessionEndedData;
-    'stream.sample': SampleData;
-    'stream.quality_degraded': QualityAnomalyData;
-    'stream.quality_recovered': QualityAnomalyData;
-    'stream.fps_low': FpsLowData;
-    'stream.signaling_retry': SignalingRetryData;
+interface MetaboxCustomApplicationContext {
+    id: 'metaboxCustomApplication';
+    data: {
+        clientId: string;
+    };
 }
-type StreamTelemetryEventName = keyof StreamTelemetryEventMap;
-/** Names emitted via `emitLifecycle` — the three `duration`-carrying events. */
-type StreamTelemetryLifecycleEventName = 'stream.session_started' | 'stream.phase_ended' | 'stream.session_ended';
-/** Discriminated union of every `trackTelemetryData` envelope. */
-type StreamTelemetryEvent = {
-    [K in StreamTelemetryEventName]: {
-        readonly event: K;
-        readonly data: StreamTelemetryEventMap[K];
+type StreamRequestContext = MetaboxStudioContext | MetaboxProductContext | CustomApplicationContext | MetaboxCustomApplicationContext | MetaboxEnvironmentContext | MetaboxBasicConfiguratorContext | MetaboxModularConfiguratorContext;
+interface SignalingMessageMap {
+    [OrchestrationMessageTypes.offer]: RTCSessionDescriptionInit;
+    [OrchestrationMessageTypes.error]: OrchestrationErrorMessage;
+    [OrchestrationMessageTypes.ssInfo]: SSInfo;
+    [OrchestrationMessageTypes.config]: ConfigMessage;
+    [OrchestrationMessageTypes.answer]: RTCSessionDescriptionInit;
+    [OrchestrationMessageTypes.playerCount]: PlayerCountMessage;
+    [OrchestrationMessageTypes.iceCandidate]: CandidateMessage;
+    [OrchestrationMessageTypes.streamerList]: StreamerListMessage;
+    [OrchestrationMessageTypes.instanceReady]: InstanceReady;
+    [OrchestrationMessageTypes.requestStream]: RequestStream;
+    [OrchestrationMessageTypes.listStreamers]: ListStreamersMessage;
+    [OrchestrationMessageTypes.p2pEstablished]: P2PEstablishedMessage;
+    [OrchestrationMessageTypes.instanceReserved]: InstanceReserved;
+    [OrchestrationMessageTypes.interruptClientStream]: InterruptClientStream;
+}
+type OrchestrationMessageType = keyof SignalingMessageMap;
+type AnySignalingMessage = SignalingMessageMap[OrchestrationMessageType] | string;
+type SignalingMessageHandler<T extends keyof SignalingMessageMap> = (msg: SignalingMessageMap[T]) => void;
+interface PollingOrchestrationMessage {
+    mm_message?: string;
+    signallingServer?: string;
+    /**
+     * Connection id issued by the orchestration for this stream request. Kept
+     * internally as `connectionId` and handed to Cirrus on the WS upgrade URL.
+     * Absent on older backends — Cirrus then generates one itself.
+     */
+    streamRequestId?: string;
+    error?: string;
+    info?: {
+        age: number | null;
+        left: number | null;
+        percent: number | null;
+        total: number | null;
     };
-}[StreamTelemetryEventName];
-/** Payload a caller supplies to `track()` — `userId` is added centrally. */
-type StreamTelemetryTrackData<K extends StreamTelemetryEventName> = Omit<StreamTelemetryEventMap[K], 'userId'>;
-/** Payload a caller supplies to `emitLifecycle()` — `duration` is computed. */
-type StreamTelemetryLifecycleData<K extends StreamTelemetryLifecycleEventName> = Omit<StreamTelemetryEventMap[K], 'userId' | 'duration'>;
+}
+
+interface StreamConfig {
+    autoStart: boolean;
+    warnTimeout: number;
+}
+
+interface StreamResolutionProps {
+    width: number | null;
+    height: number | null;
+}
 
 /**
  * Parts of the module UI a host application can restyle by supplying its own
@@ -1276,6 +1316,10 @@ declare const RECONNECT_CONFIG: {
     readonly maxAttempts: 3;
     readonly delayMs: 1000;
 };
+declare const DATA_CHANNEL_TIMEOUT_RESTARTS: {
+    readonly hidden: 3;
+    readonly visible: 10;
+};
 declare const UnrealStatusMessage: {
     readonly CONNECTING_TO_SESSION: "Connecting to session.";
     readonly STARTING_YOUR_SESSION: "Starting your session";
@@ -2047,9 +2091,12 @@ declare class StreamStatusTelemetryService2 {
      * phaseNo (derived from the catalog index), id, color, milestones,
      * params, overlays. No display text on the wire: the viewer's
      * vocabulary maps every id back to a human label, and boundary labels
-     * are derived from neighbor phases.
+     * are derived from neighbor phases. `incomplete` marks the phase the
+     * session ended in, sent from `endSession` instead of from its closer.
      */
     private emitPhaseEnded;
+    /** Move the open phase past `bucketIdx` — phases close in catalog order. */
+    private closePhase;
     /**
      * Emit the region / signaling / webrtc phases for an ADOPTED connection.
      *
@@ -2168,6 +2215,9 @@ declare class VideoService extends SubService {
     private container;
     private latencyTestTimings;
     private videoTrack$;
+    /** Bumped per attached peer connection: candidate-pair ids are only unique
+     *  inside one connection, so the epoch scopes the telemetry route ref. */
+    private pcEpoch;
     private VideoEncoderQP;
     private aggregatedStats;
     /**
@@ -2218,9 +2268,10 @@ declare class VideoService extends SubService {
      */
     private applyInboundVideoReport;
     /**
-     * Resolves the transport's selected candidate pair into the local/remote
-     * descriptors shown in the stats overlay. Silently skips when the pair (or
-     * either of its candidates) is missing from this report.
+     * Resolves the selected candidate pair into its route description, byte
+     * counters and RTT. Anything missing from this report stays unknown, and a
+     * malformed report never throws into the stats loop — the route is optional,
+     * playback is not.
      */
     private applySelectedPair;
     /** Per-session values that do not come from a single report. */
@@ -2335,6 +2386,7 @@ declare class WebRtcPlayerService extends SubService {
      */
     releaseRemoteConnections(reason: DisconnectReasonType): void;
     canSend(): boolean | null;
+    describeConnectionState(): string;
     send(data: ArrayBuffer): void;
     /**
      * Attempts to reconnect the peer when send fails due to DataChannel not being open.
@@ -3390,7 +3442,16 @@ declare class UnrealEffects {
     forceViewportNotReady$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
     resetCirrusOnDestroy$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
     destroyRemoteConnections$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    destroyConnectionAndRestart$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
+    /**
+     * Restarts signalling after a DataChannelTimeout, a limited number of times.
+     *
+     * The counter is the index inside one restart window. A window opens on load,
+     * on a successful data channel, on the user's `startStream` and on a scene
+     * destroy, so only consecutive failures count. Once the limit for the current
+     * tab visibility is reached, `establishingConnection` is cleared and the
+     * resume popup shows.
+     */
+    restartAfterDataChannelTimeout$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
     showUnrealError$: Observable<{
         code: number | null;
         error?: string;
@@ -3789,5 +3850,5 @@ declare class Semaphore {
 
 declare const tapLog: <T>(text: string, ...args: unknown[]) => ((source: Observable<T>) => Observable<T>);
 
-export { AFKService, ALL_KEYBOARD_KEYS, AUTO_HIGH_RESOLUTION_IDLE_MS, AfkTimeoutModalComponent, AggregatorService, AnalyticsService, AnswerHandler, COLOR_CODES, CommandTelemetryService, ConfigHandler, ConsoleExtensionsService, ControlScheme, DATA_CHANNEL_CONNECTION_TIMEOUT, DEBOUNCE_TO_MANY_RESIZE_CALLS, DEFAULT_AFK_TIMEOUT, DEFAULT_AFK_TIMEOUT_PERIOD, DESTROY_DISCONNECT_REASONS, DevModeService, DisconnectReason, FULL_HD_HEIGHT, FULL_HD_WIDTH, Falsy, FileHandlerService, FileReceiverService, FpsMonitorService, FreezeFrameComponent, FreezeFrameService, HEXtoRGB, HSVtoRGB, IME_PROCESS_KEY, INNER_RETRY_LIMIT, INSTANCE_READY_TIMEOUT, IceCandidateHandler, ImageLoadingSrcComponent, InputOptions, InputService, InstanceReadyHandler, InstanceReservedHandler, IntroSrcComponent, LatencyTimings, LoadingProgressService, Logger, MINIMAL_FPS, MODIFIER_KEY_CODES, MessageType, MouseButton, MouseButtonsMask, OUTER_RETRY_DELAY, OnCloseHandler, OnErrorHandler, OnMessageHandler, OnOpenHandler, OrchestrationMessageTypes, POLLING_TIME, PlayerCountHandler, RECONNECT_CONFIG, REGION_PING_ACCURATE_SAMPLES, REGION_PING_BACKGROUND_REFRESH_DELAY_MS, REGION_PING_CACHE_KEY, REGION_PING_CACHE_TTL_MS, REGION_PING_WARMUP_DEADLINE_MS, RGBtoHEX, RGBtoHSV, RegionsPingService, SAME_SIZE_THRESHOLD, SCREEN_LOCKER_CONTAINER_ID, SIGNALLING_PERCENT_VALUE, SSInfoHandler, STREAMING_AUDIO_ID, STREAMING_VIDEO_ID, STREAM_RESOLUTION_LIMITS, SafePipe, Semaphore, SignallingService, StatGraphComponent, StreamAdoptionService, StreamStatusTelemetryService, StreamStatusTelemetryService2, SubService, ToClientMessage, Truthy, UnrealAfkSlotDirective, UnrealCallbackService, UnrealCommunicatorService, UnrealEffects, UnrealKeyCode, UnrealResumeSlotDirective, UnrealSceneComponent, UnrealStatusMessage, UnrealStatusSlotDirective, VideoService, VideoStatsComponent, WSCloseCode_CIRRUS_ABNORMAL_CLOSURE, WSCloseCode_CIRRUS_MAX_PLAYERS_ERROR, WSCloseCode_CIRRUS_PLAYER_DISCONNECTED, WSCloseCode_CIRRUS_STREAMER_KIKED_PLAYER, WSCloseCode_FORCE_CIRRUS_CLOSE, WSCloseCode_NORMAL_AFK_TIMEOUT, WSCloseCode_NORMAL_CLOSURE, WSCloseCode_NORMAL_MANUAL_DISCONNECT, WSCloseCode_UNKNOWN, WSCloseCodes, WS_OPEN_STATE, WS_RETRY_PER_INSTANCE, WS_TIMEOUT, WebRtcPlayerService, WebrtcErrorModalComponent, abortEstablishingConnection, answerSent, changeStatusMainVideoOnScene, changeStreamResolutionAction, clampStreamResolution, clampf, commandCompleted, commandStarted, dataChannelConnected, dataChannelReady, decodeData, destroyRemoteConnections, destroyUnrealScene, disconnectStream, dispatchResize, dropConnection, dropDC, dropPC, fitIntoRectangle, floatToPercents, floatToSmoothPercents, forceResizeViewport, fpIsASameAsB, fromResizeObserver, generateUuid, getActiveUrl, getCanvasCached, getImageFromVideoStream, getResizeStudioValues, getResizeValuesUniversal, getRtcErrorMessage, getSnapshot, iceConnectionFailed, initSignalling, instanceReady, inverseLerp, isAppOwned, isMetaboxMode, keepMaxUntilReset, lerp, makeEven, pollingEnded, pollingStarted, provideUnrealModule, provideUnrealState, qpToQuality, reconnectPeer, reconnectPeerFailed, reconnectPeerSuccess, regionPingFetchEnd, regionPingFetchStart, regionResolved, resetAfk, resetConfig, resetDataChannelForReconnect, resetIntroSrc, resetUserInactivityTimeout, resetWarnTimeout, resolveSkin, saveAnalyticsEvent, selectCirrusConnectionId, selectClientAndViewIds, selectCommandProgress, selectFreezeFrameCombinedDataUrl, selectFreezeFrameDataUrl, selectFreezeFrameDataUrlFromVideo, selectFreezeFrameProgressMessageFromVideo, selectIsAutostart, selectIsExistMatchUrls, selectIsFreezeFrameLoading, selectIsFullyConnected, selectIsLoaderScreenVisible, selectIsVideoPlayingAndDataChannelConnected, selectShowLoader, selectShowReconnectPopup, selectSignalingParameters, selectStreamConfig, selectTotalProgress, selectUserInactivityDetected, selectWarnTimeout, setAfkTimerCountdown, setAfkTimerHide, setAfkTimerVisible, setAwsInstance, setCirrusConnected, setCirrusDisconnected, setConfig, setEstablishingConnection, setFreezeFrame, setFreezeFrameFromVideo, setIntroImageSrc, setIntroVideoSrc, setLoadingImageSrc, setLoopBackCommandIsCompleted, setMaxFps, setOrchestrationContext, setOrchestrationMessage, setOrchestrationParameters, setOrchestrationProgress, setSignalingName, setStatusMessage, setStatusPercentSignallingServer, setStreamClientCompanyId, setStreamViewId, setUnrealPlaywrightConfig, setUserInactivityTimeout, setViewportNotReady, setViewportReady, showLoadingProgress, showResumeStreamPopup, showUnrealErrorMessage, showUserInactivityTimeoutPopup, signalingRetryAttempted, startStream, streamAdopted, tapLog, trackMixpanelEvent, trackTelemetryData, uint8ToBase64, unrealCommandCallback, unrealFeature, unrealReducer, updateCirrusInfo, videoAdaptedToContainer, videoStreamInitialized };
-export type { AggregatedStat, AnySignalingMessage, AppOwnedStream, Area, AwsInstance, BootstrapInfo, CandidateMessage, CirrusRequestKind, CloseReason, CommandInProgress, ConfigMessage, ConnectionError, ControlSchemeValues, Coords, DisconnectReasonType, EmittedMilestone, EventId, FpsLowData, FreezeFrameMessage, IKeyCode, IKeyCodeName, IKeyName, ImageOutputValues, InboundVideoStats, InputProps, InstanceReady, InstanceReserved, InterruptClientStream, ListStreamersMessage, MessageBase, MessageTypeValues, OrchestrationErrorMessage, OrchestrationMessageType, P2PEstablishedMessage, ParkedStream, PhaseEndedData, PhaseOverlay, PhaseParam, PlayerCountMessage, PollingOrchestrationMessage, Quality, QualityAnomalyData, ReceivedFile, Rect, RequestStream, ResourceBucket, ResourceTotals, SSInfo, SampleData, SelectedIceCandidatePair, SessionEndReason, SessionEndedData, SessionStartedData, SignalingData, SignalingMessageHandler, SignalingMessageMap, SignalingRetryData, SignalingRetryKind, Size, SlowResource, StreamConfig, StreamRequestContext, StreamResolutionProps, StreamTelemetryEvent, StreamTelemetryEventMap, StreamTelemetryEventName, StreamTelemetryLifecycleData, StreamTelemetryLifecycleEventName, StreamTelemetryTrackData, StreamerListMessage, TelemetryEventEnvelope, TelemetryLifecycleEnvelope, TelemetryType, UnknownFields, UnrealAfkSlotContext, UnrealCallbackDescriptor, UnrealCallbackEventMap, UnrealCallbackJson, UnrealCallbackJsonWrapped, UnrealResumeSlotContext, UnrealSlotTemplateContext, UnrealState, UnrealStatusSlotContext, UnrealUiClasses, UnrealUiPart, WSCloseCodesValues, WindowAggregate };
+export { AFKService, ALL_KEYBOARD_KEYS, AUTO_HIGH_RESOLUTION_IDLE_MS, AfkTimeoutModalComponent, AggregatorService, AnalyticsService, AnswerHandler, COLOR_CODES, CommandTelemetryService, ConfigHandler, ConsoleExtensionsService, ControlScheme, DATA_CHANNEL_CONNECTION_TIMEOUT, DATA_CHANNEL_TIMEOUT_RESTARTS, DEBOUNCE_TO_MANY_RESIZE_CALLS, DEFAULT_AFK_TIMEOUT, DEFAULT_AFK_TIMEOUT_PERIOD, DESTROY_DISCONNECT_REASONS, DevModeService, DisconnectReason, FULL_HD_HEIGHT, FULL_HD_WIDTH, Falsy, FileHandlerService, FileReceiverService, FpsMonitorService, FreezeFrameComponent, FreezeFrameService, HEXtoRGB, HSVtoRGB, IME_PROCESS_KEY, INNER_RETRY_LIMIT, INSTANCE_READY_TIMEOUT, IceCandidateHandler, ImageLoadingSrcComponent, InputOptions, InputService, InstanceReadyHandler, InstanceReservedHandler, IntroSrcComponent, LatencyTimings, LoadingProgressService, Logger, MINIMAL_FPS, MODIFIER_KEY_CODES, MessageType, MouseButton, MouseButtonsMask, OUTER_RETRY_DELAY, OnCloseHandler, OnErrorHandler, OnMessageHandler, OnOpenHandler, OrchestrationMessageTypes, POLLING_TIME, PlayerCountHandler, RECONNECT_CONFIG, REGION_PING_ACCURATE_SAMPLES, REGION_PING_BACKGROUND_REFRESH_DELAY_MS, REGION_PING_CACHE_KEY, REGION_PING_CACHE_TTL_MS, REGION_PING_WARMUP_DEADLINE_MS, RGBtoHEX, RGBtoHSV, RegionsPingService, SAME_SIZE_THRESHOLD, SCREEN_LOCKER_CONTAINER_ID, SIGNALLING_PERCENT_VALUE, SSInfoHandler, STREAMING_AUDIO_ID, STREAMING_VIDEO_ID, STREAM_RESOLUTION_LIMITS, SafePipe, Semaphore, SignallingService, StatGraphComponent, StreamAdoptionService, StreamStatusTelemetryService, StreamStatusTelemetryService2, SubService, ToClientMessage, Truthy, UnrealAfkSlotDirective, UnrealCallbackService, UnrealCommunicatorService, UnrealEffects, UnrealKeyCode, UnrealResumeSlotDirective, UnrealSceneComponent, UnrealStatusMessage, UnrealStatusSlotDirective, VideoService, VideoStatsComponent, WSCloseCode_CIRRUS_ABNORMAL_CLOSURE, WSCloseCode_CIRRUS_MAX_PLAYERS_ERROR, WSCloseCode_CIRRUS_PLAYER_DISCONNECTED, WSCloseCode_CIRRUS_STREAMER_KIKED_PLAYER, WSCloseCode_FORCE_CIRRUS_CLOSE, WSCloseCode_NORMAL_AFK_TIMEOUT, WSCloseCode_NORMAL_CLOSURE, WSCloseCode_NORMAL_MANUAL_DISCONNECT, WSCloseCode_UNKNOWN, WSCloseCodes, WS_OPEN_STATE, WS_RETRY_PER_INSTANCE, WS_TIMEOUT, WebRtcPlayerService, WebrtcErrorModalComponent, abortEstablishingConnection, answerSent, changeStatusMainVideoOnScene, changeStreamResolutionAction, clampStreamResolution, clampf, commandCompleted, commandStarted, dataChannelConnected, dataChannelReady, decodeData, destroyRemoteConnections, destroyUnrealScene, disconnectStream, dispatchResize, dropConnection, dropDC, dropPC, fitIntoRectangle, floatToPercents, floatToSmoothPercents, forceResizeViewport, fpIsASameAsB, fromResizeObserver, generateUuid, getActiveUrl, getCanvasCached, getImageFromVideoStream, getResizeStudioValues, getResizeValuesUniversal, getRtcErrorMessage, getSnapshot, iceConnectionFailed, initSignalling, instanceReady, inverseLerp, isAppOwned, isMetaboxMode, keepMaxUntilReset, lerp, makeEven, pollingEnded, pollingStarted, provideUnrealModule, provideUnrealState, qpToQuality, reconnectPeer, reconnectPeerFailed, reconnectPeerSuccess, regionPingFetchEnd, regionPingFetchStart, regionResolved, resetAfk, resetConfig, resetDataChannelForReconnect, resetIntroSrc, resetUserInactivityTimeout, resetWarnTimeout, resolveSkin, saveAnalyticsEvent, selectCirrusConnectionId, selectClientAndViewIds, selectCommandProgress, selectFreezeFrameCombinedDataUrl, selectFreezeFrameDataUrl, selectFreezeFrameDataUrlFromVideo, selectFreezeFrameProgressMessageFromVideo, selectIsAutostart, selectIsExistMatchUrls, selectIsFreezeFrameLoading, selectIsFullyConnected, selectIsLoaderScreenVisible, selectIsVideoPlayingAndDataChannelConnected, selectShowLoader, selectShowReconnectPopup, selectSignalingParameters, selectStreamConfig, selectTotalProgress, selectUserInactivityDetected, selectWarnTimeout, setAfkTimerCountdown, setAfkTimerHide, setAfkTimerVisible, setAwsInstance, setCirrusConnected, setCirrusDisconnected, setConfig, setEstablishingConnection, setFreezeFrame, setFreezeFrameFromVideo, setIntroImageSrc, setIntroVideoSrc, setLoadingImageSrc, setLoopBackCommandIsCompleted, setMaxFps, setOrchestrationContext, setOrchestrationMessage, setOrchestrationParameters, setOrchestrationProgress, setSignalingName, setStatusMessage, setStatusPercentSignallingServer, setStreamClientCompanyId, setStreamViewId, setUnrealPlaywrightConfig, setUserInactivityTimeout, setViewportNotReady, setViewportReady, showLoadingProgress, showResumeStreamPopup, showUnrealErrorMessage, showUserInactivityTimeoutPopup, signalingRetryAttempted, startStream, streamAdopted, tapLog, trackMixpanelEvent, trackTelemetryData, uint8ToBase64, unrealCommandCallback, unrealFeature, unrealReducer, updateCirrusInfo, videoAdaptedToContainer, videoStreamInitialized };
+export type { AggregatedStat, AnySignalingMessage, AppOwnedStream, Area, AwsInstance, BootstrapInfo, CandidateMessage, CirrusRequestKind, CloseReason, CommandInProgress, ConfigMessage, ConnectionError, ControlSchemeValues, Coords, DisconnectReasonType, EmittedMilestone, EventId, FpsLowData, FreezeFrameMessage, IKeyCode, IKeyCodeName, IKeyName, IceCandidateInfo, IceRoute, ImageOutputValues, InboundVideoStats, InputProps, InstanceReady, InstanceReserved, InterruptClientStream, ListStreamersMessage, MessageBase, MessageTypeValues, OrchestrationErrorMessage, OrchestrationMessageType, P2PEstablishedMessage, ParkedStream, PhaseEndedData, PhaseOverlay, PhaseParam, PlayerCountMessage, PollingOrchestrationMessage, Quality, QualityAnomalyData, ReceivedFile, Rect, RequestStream, ResourceBucket, ResourceTotals, RouteSegment, SSInfo, SampleData, SelectedIceCandidatePair, SessionEndReason, SessionEndedData, SessionStartedData, SignalingData, SignalingMessageHandler, SignalingMessageMap, SignalingRetryData, SignalingRetryKind, Size, SlowResource, StreamConfig, StreamRequestContext, StreamResolutionProps, StreamTelemetryEvent, StreamTelemetryEventMap, StreamTelemetryEventName, StreamTelemetryLifecycleData, StreamTelemetryLifecycleEventName, StreamTelemetryTrackData, StreamerListMessage, TelemetryEventEnvelope, TelemetryLifecycleEnvelope, TelemetryType, UnknownFields, UnrealAfkSlotContext, UnrealCallbackDescriptor, UnrealCallbackEventMap, UnrealCallbackJson, UnrealCallbackJsonWrapped, UnrealResumeSlotContext, UnrealSlotTemplateContext, UnrealState, UnrealStatusSlotContext, UnrealUiClasses, UnrealUiPart, WSCloseCodesValues, WindowAggregate };