@memberjunction/ai-realtime-client 6.2.0-edge.3 → 6.2.0-edge.4

package/dist/media/attachVideoSource.js

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview ATTACH VIDEO SOURCE: shows any {@link MediaVideoSource} in a `<video>` element and hands back
+ * a function that takes it out again. UI code calls this instead of a vendor's `track.attach(element)`, so a
+ * tile renders a camera, a shared screen, a meeting participant or an avatar the same way.
+ *
+ * - A **stream** source (a camera, a shared screen, a WebRTC track) plays muted and inline. A video surface
+ *   never plays audio: the realtime client or the meeting room plays each voice exactly once.
+ * - An **element** source (a player that must own the element, such as MSE playout of an avatar's MP4) is
+ *   handed the element and decides everything, including its audio: an avatar's voice is in its video.
+ *
+ * Detaching never stops the source's tracks; whoever opened them stops them.
+ *
+ * @module @memberjunction/ai-realtime-client/media
+ */
+/**
+ * Shows a video source in a `<video>` element.
+ *
+ * @returns A function that takes the source out of the element. Calling it twice does nothing, and it leaves
+ *   the element alone if another source has been attached to it since.
+ */
+export function AttachVideoSource(source, element) {
+    if (source.Kind === 'element') {
+        return once(source.Attach(element));
+    }
+    element.muted = true;
+    element.playsInline = true;
+    element.autoplay = true;
+    element.srcObject = source.Stream;
+    void element.play().catch(() => {
+        // Muted inline video may play; if the browser still waits (a hidden element), autoplay starts it later.
+    });
+    return once(() => {
+        if (element.srcObject === source.Stream) {
+            element.pause();
+            element.srcObject = null;
+        }
+    });
+}
+/** Wraps a function so that only its first call does anything. */
+function once(action) {
+    let done = false;
+    return () => {
+        if (!done) {
+            done = true;
+            action();
+        }
+    };
+}
+//# sourceMappingURL=attachVideoSource.js.map

package/dist/media/attachVideoSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachVideoSource.js","sourceRoot":"","sources":["../../src/media/attachVideoSource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAwB,EAAE,OAAyB;IACjF,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IACrB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;QAC3B,wGAAwG;IAC5G,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,CAAC,SAAS,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;YACtC,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;QAC7B,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC;AAED,kEAAkE;AAClE,SAAS,IAAI,CAAC,MAAkB;IAC5B,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,OAAO,GAAG,EAAE;QACR,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,IAAI,GAAG,IAAI,CAAC;YACZ,MAAM,EAAE,CAAC;QACb,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}

package/dist/media/channelVideoSource.d.ts

@@ -1,19 +1,25 @@
 /**
  * @fileoverview SHARED CHANNEL INBOUND VIDEO BRIDGE (Phase F5).
  *
- * Single shared implementation used by both Whiteboard and Remote Browser channels
- * to source inbound video frames into a realtime session when the model supports it.
+ * Single shared implementation used by the Whiteboard, Remote Browser and any other channel that
+ * shows the model pixels. It no longer writes to the model directly: it REGISTERS its channel as a
+ * source with the session's {@link VideoSourceArbiter} and pushes frames to it, so the arbiter stays
+ * the single writer of inbound video and decides which source the model sees when several are live.
  *
  * Enforces:
  *  1. Model capability & track gate: if the session has not established an inbound video track,
  *     falls back to tool-only behaviour — NO frames sent and NO errors raised.
- *  2. Cadence throttling: capped at 1 frame per second maximum (1 fps ceiling per Live API capabilities guide).
- *  3. Clean teardown on Stop().
+ *  2. Cadence: the poller (when used) runs at the NEGOTIATED inbound rate, read from the client;
+ *     there is no rate constant here. The arbiter and the driver enforce the same rate as a spacing.
+ *  3. Clean teardown on Stop(), which also unregisters the source.
+ *
+ * An owner that sends frames only when its picture changes learns from {@link ChannelInboundVideoBridge.OnSourceActivated}
+ * when the arbiter starts sending its source to the model again, so it can send the picture the model missed.
  *
  * @module @memberjunction/ai-realtime-client
  * @author MemberJunction.com
  */
-import type { BaseRealtimeClient } from '../generic/baseRealtimeClient.js';
+import { VideoSourceArbiter, type IVideoFrameSink, type VideoSourceKind } from './videoSourceArbiter.js';
 /**
  * Provider implemented by a channel or surface to produce visual frames.
  */
@@ -28,13 +34,36 @@ export interface IChannelFrameProvider {
  * Options for the inbound channel video bridge.
  */
 export interface ChannelInboundVideoBridgeOptions {
-    /** Target frame rate in fps (capped at 1 fps maximum). Defaults to 1. */
+    /**
+     * Target poll rate in fps for {@link ChannelInboundVideoBridge.Start}.
+     *
+     * @deprecated The poll follows the rate the inbound video track NEGOTIATED (the model's own
+     *   ceiling), read from the client. When set, the poll runs at the lower of this and the negotiated
+     *   rate; it is no longer clamped to a constant 1 fps.
+     */
     Rate?: number;
     /** Output MIME type. Defaults to 'image/jpeg'. */
     MimeType?: string;
+    /**
+     * The id this source registers under. Defaults to a unique generated id. A channel passes a stable
+     * one (`<channel>#<instance>`) so the UI can address the source.
+     */
+    SourceID?: string;
+    /** Human-readable name used in notes to the model and in the UI's "agent can see" list. Defaults to the source id. */
+    Label?: string;
+    /** What kind of source this is. Defaults to `'surface'` (a channel surface, not a user capture). */
+    Kind?: VideoSourceKind;
+    /** The channel this source belongs to, so the UI can map it to the user's persisted per-channel choice. */
+    ChannelKey?: string;
+    /**
+     * The arbiter to register with. Defaults to the one for the session's client
+     * ({@link VideoSourceArbiter.ForSink}), which is what makes it a single writer. Override for tests.
+     */
+    Arbiter?: VideoSourceArbiter;
 }
 /**
- * Shared bridge connecting a visual channel surface to the session's inbound video track.
+ * Shared bridge connecting a visual channel surface to the session's inbound video track, by way of
+ * the session's {@link VideoSourceArbiter}.
  */
 export declare class ChannelInboundVideoBridge {
     private readonly clientOrGetter;
@@ -43,8 +72,63 @@ export declare class ChannelInboundVideoBridge {
     private timer;
     private active;
     private frameErrorLogged;
-    constructor(clientOrGetter: BaseRealtimeClient | (() => BaseRealtimeClient | null | undefined) | null | undefined, provider: IChannelFrameProvider, options?: ChannelInboundVideoBridgeOptions);
+    private readonly sourceId;
+    /** The arbiter this bridge is currently registered with; `null` when it is not registered. */
+    private registeredWith;
+    /** Whether the owner switched this source off (exposure policy or the user). Survives re-registration. */
+    private sourceEnabled;
+    /** The owner's handlers for {@link OnSourceActivated}. They survive re-registration. */
+    private readonly activatedHandlers;
+    /** Stops following the arbiter's changes; `null` while not following (not registered, or no handler). */
+    private stopFollowingArbiter;
+    /** Whether the arbiter was sending this source to the model as of its last change. */
+    private forwarded;
+    /**
+     * @param clientOrGetter The session's client, or a getter for it (a reconnect replaces the client). Any
+     *   {@link IVideoFrameSink} works; a `BaseRealtimeClient` is one.
+     * @param provider Produces the frames.
+     * @param options Source identity, MIME type and the deprecated rate cap.
+     */
+    constructor(clientOrGetter: IVideoFrameSink | (() => IVideoFrameSink | null | undefined) | null | undefined, provider: IChannelFrameProvider, options?: ChannelInboundVideoBridgeOptions);
     private get client();
+    /** The id this bridge's source is registered under. */
+    get SourceID(): string;
+    /** The arbiter for the current client, or `null` when there is no client yet. */
+    private resolveArbiter;
+    /**
+     * Registers this bridge's source with the session's arbiter (idempotent). A new session means a new
+     * client and so a new arbiter: the source is re-registered there and removed from the old one, so a
+     * reconnect never leaves a ghost source behind.
+     *
+     * @returns The arbiter, or `null` when there is no client to register with.
+     */
+    private ensureRegistered;
+    /**
+     * Calls `handler` each time the arbiter starts sending this source to the model after it was not: another source
+     * that held the model's only stream stopped or was set aside, or this source was switched back on. The source's
+     * first registration does not count. A frame offered while the source was not sent never reached the model, so an
+     * owner that sends frames only when its picture changes sends its current picture here.
+     *
+     * The handler is kept across a re-registration (a reconnect's new client) and called until removed.
+     *
+     * @param handler Called synchronously from the arbiter's change event; it should not throw.
+     * @returns A function that removes the handler.
+     */
+    OnSourceActivated(handler: () => void): () => void;
+    /** Starts following the arbiter this source is registered with, when an owner asked to hear of activations. */
+    private followArbiter;
+    /** Stops following the arbiter's changes. */
+    private unfollowArbiter;
+    /** Calls each activation handler, containing a handler that throws. */
+    private notifyActivated;
+    /**
+     * Registers this bridge's source with the session's arbiter now, without starting any poll — so the
+     * source is LISTED (and can be switched on or off) before it has pushed a frame. A source that is
+     * switched off never pushes one, so without this it could never be switched back on.
+     *
+     * @returns `true` if registered; `false` when there is no client or no inbound video track (nothing to register with).
+     */
+    Register(): boolean;
     /**
      * Starts the periodic frame pump if the session has an established inbound video track.
      *
@@ -52,21 +136,32 @@ export declare class ChannelInboundVideoBridge {
      *   inbound video (or track was not established), falling back to tool-only behaviour.
      */
     Start(): boolean;
+    /** The poll interval: the negotiated rate, capped by the (deprecated) `Rate` option when one was given. */
+    private pollIntervalMs;
     /**
-     * Directly sends a frame through the client when the inbound video track is established
-     * and the client implements `SendVideoFrame`.
+     * Offers a frame to the arbiter, which forwards it only if this source is among those the model
+     * should see (and enabled, and inside the negotiated pacing interval).
      *
-     * @returns `true` if dispatched to the client; `false` otherwise.
+     * @returns `true` if dispatched to the model; `false` otherwise.
      */
     private sendFrameDirect;
     /**
      * Pushes an event-driven frame (e.g. screencast push from RemoteBrowser or stroke completion).
-     * Dispatches directly to the client's authoritative throttle gate.
+     * Registers the source on first use, so a purely event-driven channel never needs {@link Start}.
      *
      * @param base64Jpeg The base64-encoded image frame.
-     * @returns `true` if the frame was sent; `false` if dropped (throttled, track unestablished, or driver lacks video support).
+     * @returns `true` if the frame was sent; `false` if dropped (throttled, not the source the model is
+     *   viewing, turned off, track unestablished, or driver lacks video support).
      */
     PushFrame(base64Jpeg: string): boolean;
+    /**
+     * Turns this source on or off at the arbiter (a no-op before the first registration other than
+     * remembering the choice). A disabled source is not a candidate and forwards nothing.
+     *
+     * @param enabled Whether the model may see this source.
+     * @param notify Whether the arbiter tells the model. Pass `false` when the caller sends its own note.
+     */
+    SetSourceEnabled(enabled: boolean, notify?: boolean): void;
     /**
      * Periodic poll tick that fetches the latest frame from the provider and pushes it.
      * Uses `sendFrameDirect` so periodic polling paced by `setInterval` does not fight
@@ -74,7 +169,8 @@ export declare class ChannelInboundVideoBridge {
      */
     private pumpFrame;
     /**
-     * Stops the bridge and clears any active polling timer.
+     * Stops the bridge: clears the poll timer and removes this source from the arbiter. Activation handlers stay, and
+     * are called again if the source registers again.
      */
     Stop(): void;
     /** Whether the video bridge is currently actively pumping frames. */

package/dist/media/channelVideoSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channelVideoSource.d.ts","sourceRoot":"","sources":["../../src/media/channelVideoSource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC7C,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,yBAAyB;IAM9B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP5B,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAS;gBAGZ,cAAc,EAAE,kBAAkB,GAAG,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,EACrG,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,GAAE,gCAAqC;IAGnE,OAAO,KAAK,MAAM,GAEjB;IAED;;;;;OAKG;IACI,KAAK,IAAI,OAAO;IAiBvB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAUvB;;;;;;OAMG;IACI,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI7C;;;;OAIG;YACW,SAAS;IAkBvB;;OAEG;IACI,IAAI,IAAI,IAAI;IASnB,qEAAqE;IACrE,IAAW,QAAQ,IAAI,OAAO,CAE7B;CACJ"}
+{"version":3,"file":"channelVideoSource.d.ts","sourceRoot":"","sources":["../../src/media/channelVideoSource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEtG;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC7C;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sHAAsH;IACtH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oGAAoG;IACpG,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,2GAA2G;IAC3G,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAKD;;;GAGG;AACH,qBAAa,yBAAyB;IAuB9B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAxB5B,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,8FAA8F;IAC9F,OAAO,CAAC,cAAc,CAAmC;IACzD,0GAA0G;IAC1G,OAAO,CAAC,aAAa,CAAQ;IAC7B,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyB;IAC3D,yGAAyG;IACzG,OAAO,CAAC,oBAAoB,CAA6B;IACzD,sFAAsF;IACtF,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;;OAKG;gBAEkB,cAAc,EAAE,eAAe,GAAG,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,EAC/F,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,GAAE,gCAAqC;IAKnE,OAAO,KAAK,MAAM,GAEjB;IAED,uDAAuD;IACvD,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,iFAAiF;IACjF,OAAO,CAAC,cAAc;IAQtB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;;;;;;;;;OAUG;IACI,iBAAiB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAWzD,+GAA+G;IAC/G,OAAO,CAAC,aAAa;IAgBrB,6CAA6C;IAC7C,OAAO,CAAC,eAAe;IAMvB,uEAAuE;IACvE,OAAO,CAAC,eAAe;IAUvB;;;;;;OAMG;IACI,QAAQ,IAAI,OAAO;IAQ1B;;;;;OAKG;IACI,KAAK,IAAI,OAAO;IAiBvB,2GAA2G;IAC3G,OAAO,CAAC,cAAc;IAUtB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAYvB;;;;;;;OAOG;IACI,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI7C;;;;;;OAMG;IACI,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAO,GAAG,IAAI;IAK9D;;;;OAIG;YACW,SAAS;IAkBvB;;;OAGG;IACI,IAAI,IAAI,IAAI;IAYnB,qEAAqE;IACrE,IAAW,QAAQ,IAAI,OAAO,CAE7B;CACJ"}

package/dist/media/channelVideoSource.js

@@ -1,22 +1,39 @@
 /**
  * @fileoverview SHARED CHANNEL INBOUND VIDEO BRIDGE (Phase F5).
  *
- * Single shared implementation used by both Whiteboard and Remote Browser channels
- * to source inbound video frames into a realtime session when the model supports it.
+ * Single shared implementation used by the Whiteboard, Remote Browser and any other channel that
+ * shows the model pixels. It no longer writes to the model directly: it REGISTERS its channel as a
+ * source with the session's {@link VideoSourceArbiter} and pushes frames to it, so the arbiter stays
+ * the single writer of inbound video and decides which source the model sees when several are live.
  *
  * Enforces:
  *  1. Model capability & track gate: if the session has not established an inbound video track,
  *     falls back to tool-only behaviour — NO frames sent and NO errors raised.
- *  2. Cadence throttling: capped at 1 frame per second maximum (1 fps ceiling per Live API capabilities guide).
- *  3. Clean teardown on Stop().
+ *  2. Cadence: the poller (when used) runs at the NEGOTIATED inbound rate, read from the client;
+ *     there is no rate constant here. The arbiter and the driver enforce the same rate as a spacing.
+ *  3. Clean teardown on Stop(), which also unregisters the source.
+ *
+ * An owner that sends frames only when its picture changes learns from {@link ChannelInboundVideoBridge.OnSourceActivated}
+ * when the arbiter starts sending its source to the model again, so it can send the picture the model missed.
  *
  * @module @memberjunction/ai-realtime-client
  * @author MemberJunction.com
  */
+import { NominalVideoFrameIntervalMs } from './videoPacing.js';
+import { VideoSourceArbiter } from './videoSourceArbiter.js';
+/** Counter behind the generated source ids. */
+let generatedSourceCounter = 0;
 /**
- * Shared bridge connecting a visual channel surface to the session's inbound video track.
+ * Shared bridge connecting a visual channel surface to the session's inbound video track, by way of
+ * the session's {@link VideoSourceArbiter}.
  */
 export class ChannelInboundVideoBridge {
+    /**
+     * @param clientOrGetter The session's client, or a getter for it (a reconnect replaces the client). Any
+     *   {@link IVideoFrameSink} works; a `BaseRealtimeClient` is one.
+     * @param provider Produces the frames.
+     * @param options Source identity, MIME type and the deprecated rate cap.
+     */
     constructor(clientOrGetter, provider, options = {}) {
         this.clientOrGetter = clientOrGetter;
         this.provider = provider;
@@ -24,10 +41,131 @@ export class ChannelInboundVideoBridge {
         this.timer = null;
         this.active = false;
         this.frameErrorLogged = false;
+        /** The arbiter this bridge is currently registered with; `null` when it is not registered. */
+        this.registeredWith = null;
+        /** Whether the owner switched this source off (exposure policy or the user). Survives re-registration. */
+        this.sourceEnabled = true;
+        /** The owner's handlers for {@link OnSourceActivated}. They survive re-registration. */
+        this.activatedHandlers = new Set();
+        /** Stops following the arbiter's changes; `null` while not following (not registered, or no handler). */
+        this.stopFollowingArbiter = null;
+        /** Whether the arbiter was sending this source to the model as of its last change. */
+        this.forwarded = false;
+        this.sourceId = options.SourceID ?? `channel-video-${++generatedSourceCounter}`;
     }
     get client() {
         return typeof this.clientOrGetter === 'function' ? this.clientOrGetter() : this.clientOrGetter;
     }
+    /** The id this bridge's source is registered under. */
+    get SourceID() {
+        return this.sourceId;
+    }
+    /** The arbiter for the current client, or `null` when there is no client yet. */
+    resolveArbiter() {
+        if (this.options.Arbiter) {
+            return this.options.Arbiter;
+        }
+        const client = this.client;
+        return client ? VideoSourceArbiter.ForSink(client) : null;
+    }
+    /**
+     * Registers this bridge's source with the session's arbiter (idempotent). A new session means a new
+     * client and so a new arbiter: the source is re-registered there and removed from the old one, so a
+     * reconnect never leaves a ghost source behind.
+     *
+     * @returns The arbiter, or `null` when there is no client to register with.
+     */
+    ensureRegistered() {
+        const arbiter = this.resolveArbiter();
+        if (!arbiter) {
+            return null;
+        }
+        if (this.registeredWith !== arbiter) {
+            this.unfollowArbiter();
+            this.registeredWith?.UnregisterSource(this.sourceId);
+            arbiter.RegisterSource({
+                SourceID: this.sourceId,
+                Label: this.options.Label ?? this.sourceId,
+                Kind: this.options.Kind ?? 'surface',
+                ChannelKey: this.options.ChannelKey,
+            });
+            this.registeredWith = arbiter;
+            if (!this.sourceEnabled) {
+                arbiter.SetSourceEnabled(this.sourceId, false, false);
+            }
+            // Followed from here, once registered as it will stay: the registration itself is not an activation.
+            this.followArbiter();
+        }
+        return arbiter;
+    }
+    /**
+     * Calls `handler` each time the arbiter starts sending this source to the model after it was not: another source
+     * that held the model's only stream stopped or was set aside, or this source was switched back on. The source's
+     * first registration does not count. A frame offered while the source was not sent never reached the model, so an
+     * owner that sends frames only when its picture changes sends its current picture here.
+     *
+     * The handler is kept across a re-registration (a reconnect's new client) and called until removed.
+     *
+     * @param handler Called synchronously from the arbiter's change event; it should not throw.
+     * @returns A function that removes the handler.
+     */
+    OnSourceActivated(handler) {
+        this.activatedHandlers.add(handler);
+        this.followArbiter();
+        return () => {
+            this.activatedHandlers.delete(handler);
+            if (this.activatedHandlers.size === 0) {
+                this.unfollowArbiter();
+            }
+        };
+    }
+    /** Starts following the arbiter this source is registered with, when an owner asked to hear of activations. */
+    followArbiter() {
+        const arbiter = this.registeredWith;
+        if (!arbiter || this.stopFollowingArbiter || this.activatedHandlers.size === 0) {
+            return;
+        }
+        this.forwarded = arbiter.GetActiveSourceIDs().includes(this.sourceId);
+        this.stopFollowingArbiter = arbiter.OnChange(() => {
+            const forwarded = arbiter.GetActiveSourceIDs().includes(this.sourceId);
+            const activated = forwarded && !this.forwarded;
+            this.forwarded = forwarded;
+            if (activated) {
+                this.notifyActivated();
+            }
+        });
+    }
+    /** Stops following the arbiter's changes. */
+    unfollowArbiter() {
+        this.stopFollowingArbiter?.();
+        this.stopFollowingArbiter = null;
+        this.forwarded = false;
+    }
+    /** Calls each activation handler, containing a handler that throws. */
+    notifyActivated() {
+        for (const handler of [...this.activatedHandlers]) {
+            try {
+                handler();
+            }
+            catch (err) {
+                console.error('[ChannelInboundVideoBridge] Error in a source-activated handler:', err);
+            }
+        }
+    }
+    /**
+     * Registers this bridge's source with the session's arbiter now, without starting any poll — so the
+     * source is LISTED (and can be switched on or off) before it has pushed a frame. A source that is
+     * switched off never pushes one, so without this it could never be switched back on.
+     *
+     * @returns `true` if registered; `false` when there is no client or no inbound video track (nothing to register with).
+     */
+    Register() {
+        const client = this.client;
+        if (!client || !client.IsTrackEstablished('video', 'inbound')) {
+            return false;
+        }
+        return this.ensureRegistered() !== null;
+    }
     /**
      * Starts the periodic frame pump if the session has an established inbound video track.
      *
@@ -38,43 +176,66 @@ export class ChannelInboundVideoBridge {
         if (this.active) {
             return true;
         }
-        if (!this.client || !this.client.IsTrackEstablished('video', 'inbound')) {
+        const client = this.client;
+        if (!client || !client.IsTrackEstablished('video', 'inbound')) {
             // Non-video model or unrequested video track: graceful fallback with no error
             return false;
         }
+        this.ensureRegistered();
         this.active = true;
-        const rate = Math.min(Math.max(this.options.Rate ?? 1, 0.1), 1);
-        const intervalMs = Math.floor(1000 / rate);
         this.timer = setInterval(() => {
             void this.pumpFrame();
-        }, intervalMs);
+        }, this.pollIntervalMs(client));
         return true;
     }
+    /** The poll interval: the negotiated rate, capped by the (deprecated) `Rate` option when one was given. */
+    pollIntervalMs(client) {
+        const negotiated = client.InboundVideoRate;
+        const requested = this.options.Rate;
+        const rate = typeof requested === 'number' && requested > 0
+            ? Math.max(0.1, typeof negotiated === 'number' ? Math.min(requested, negotiated) : requested)
+            : negotiated;
+        return NominalVideoFrameIntervalMs(rate);
+    }
     /**
-     * Directly sends a frame through the client when the inbound video track is established
-     * and the client implements `SendVideoFrame`.
+     * Offers a frame to the arbiter, which forwards it only if this source is among those the model
+     * should see (and enabled, and inside the negotiated pacing interval).
      *
-     * @returns `true` if dispatched to the client; `false` otherwise.
+     * @returns `true` if dispatched to the model; `false` otherwise.
      */
     sendFrameDirect(base64Jpeg) {
-        if (!this.client || !this.client.IsTrackEstablished('video', 'inbound')) {
+        const client = this.client;
+        if (!client || !client.IsTrackEstablished('video', 'inbound')) {
             return false;
         }
-        if (typeof this.client.SendVideoFrame !== 'function') {
+        if (typeof client.SendVideoFrame !== 'function') {
             return false;
         }
-        return Boolean(this.client.SendVideoFrame(base64Jpeg, this.options.MimeType ?? 'image/jpeg'));
+        const arbiter = this.ensureRegistered();
+        return arbiter ? arbiter.PushFrame(this.sourceId, base64Jpeg, this.options.MimeType ?? 'image/jpeg') : false;
     }
     /**
      * Pushes an event-driven frame (e.g. screencast push from RemoteBrowser or stroke completion).
-     * Dispatches directly to the client's authoritative throttle gate.
+     * Registers the source on first use, so a purely event-driven channel never needs {@link Start}.
      *
      * @param base64Jpeg The base64-encoded image frame.
-     * @returns `true` if the frame was sent; `false` if dropped (throttled, track unestablished, or driver lacks video support).
+     * @returns `true` if the frame was sent; `false` if dropped (throttled, not the source the model is
+     *   viewing, turned off, track unestablished, or driver lacks video support).
      */
     PushFrame(base64Jpeg) {
         return this.sendFrameDirect(base64Jpeg);
     }
+    /**
+     * Turns this source on or off at the arbiter (a no-op before the first registration other than
+     * remembering the choice). A disabled source is not a candidate and forwards nothing.
+     *
+     * @param enabled Whether the model may see this source.
+     * @param notify Whether the arbiter tells the model. Pass `false` when the caller sends its own note.
+     */
+    SetSourceEnabled(enabled, notify = true) {
+        this.sourceEnabled = enabled;
+        this.registeredWith?.SetSourceEnabled(this.sourceId, enabled, notify);
+    }
     /**
      * Periodic poll tick that fetches the latest frame from the provider and pushes it.
      * Uses `sendFrameDirect` so periodic polling paced by `setInterval` does not fight
@@ -99,7 +260,8 @@ export class ChannelInboundVideoBridge {
         }
     }
     /**
-     * Stops the bridge and clears any active polling timer.
+     * Stops the bridge: clears the poll timer and removes this source from the arbiter. Activation handlers stay, and
+     * are called again if the source registers again.
      */
     Stop() {
         this.active = false;
@@ -108,6 +270,9 @@ export class ChannelInboundVideoBridge {
             clearInterval(this.timer);
             this.timer = null;
         }
+        this.unfollowArbiter();
+        this.registeredWith?.UnregisterSource(this.sourceId);
+        this.registeredWith = null;
     }
     /** Whether the video bridge is currently actively pumping frames. */
     get IsActive() {

package/dist/media/channelVideoSource.js.map

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