@lumencast/runtime 0.9.0 → 0.10.0

package/dist/webrtc/meet-viewer.js

@@ -0,0 +1,379 @@
+// WebRTC viewer (mesh, VIEWER role) — ADR 006 §3.3 (C1), issue #3.
+//
+// A viewer-only port of `Prism/src/renderer/src/lib/meet-client.ts` (§1.4) : it
+// joins a Meet room, receives N peers and exposes one `MediaStream` per peer.
+// It NEVER publishes : no `getUserMedia`, no local stream, every transceiver is
+// `recvonly`. Recovering a WebRTC flow needs no capture permission (ADR §2),
+// which is the whole point of the pivot — Solar-CEF (on-air) and the Prism
+// return webview can both be viewers without a capture grant.
+//
+// It reuses the reference's hard-won mesh logic verbatim in spirit :
+//   - perfect-negotiation (polite/impolite glare handling) ;
+//   - symmetric m-line ordering (audio transceiver first, video second) ;
+//   - STUN-first + per-URL TURN iceServers ;
+//   - one aggregated `MediaStream` per peer (`track` → addTrack, `ended` →
+//     removeTrack), handed to the consumer as `RemoteTrackEvent`.
+//
+// OWNERSHIP : the viewer owns each peer's `RTCPeerConnection` AND the
+// `MediaStream` it aggregates. It is the SOLE authority on the track lifecycle —
+// created on `track`, removed on `ended` / `peer-left` / `connectionstatechange
+// failed|closed`, all torn down on `leave()`. A downstream `<video srcObject>`
+// (the `media` primitive #4) is a pure consumer : unmounting it clears its own
+// `srcObject` and stops nothing. A returning mirror can never kill a peer for
+// the on-air composite.
+//
+// PEER LABEL : the transverse invariant gravé by Conduit (ZabCam contract #6) is
+// a strict STRING equality — `peer_label == MeetClientOptions.name ==
+// RemoteTrackEvent.peerName`, all matching `^[a-z][a-z0-9_-]{0,63}$`. Publishers
+// (#5 Prism / #2 Pulsar) join with `name = peer_label` ; it comes back on the
+// remote side as `PeerInfo.name`, surfaced verbatim as `RemoteTrackEvent.peerName`.
+// The viewer therefore resolves `peer_label → MediaStream` by indexing peers by
+// `peerName` (== label), NEVER by the opaque `peerId`. No separate label channel
+// is needed : the join announce already carries it.
+export class MeetViewer {
+    options;
+    ws = null;
+    remotes = new Map();
+    iceServers = [];
+    selfId = null;
+    listeners = new Map();
+    deps;
+    constructor(options) {
+        this.options = options;
+        this.deps = {
+            WebSocket: options.deps?.WebSocket ?? globalThis.WebSocket,
+            RTCPeerConnection: options.deps?.RTCPeerConnection ?? globalThis.RTCPeerConnection,
+            MediaStream: options.deps?.MediaStream ?? globalThis.MediaStream,
+        };
+    }
+    on(type, listener) {
+        const set = this.listeners.get(type) ?? new Set();
+        this.listeners.set(type, set);
+        set.add(listener);
+        return () => set.delete(listener);
+    }
+    /** Join the room as a VIEWER (recvonly). No capture, no publish. */
+    join() {
+        return this.openSocket();
+    }
+    /** Leave and tear down every peer connection + aggregated stream. As the
+     *  track owner, this is where the streams (and the device-side tracks) end. */
+    leave() {
+        this.send({ type: "leave" });
+        this.ws?.close(1000, "viewer-leave");
+    }
+    /* ---- Socket ------------------------------------------------------- */
+    openSocket() {
+        const url = new URL(this.options.signalingUrl);
+        url.searchParams.set("room", this.options.roomId);
+        url.searchParams.set("token", this.options.token);
+        return new Promise((resolve, reject) => {
+            const ws = new this.deps.WebSocket(url.toString());
+            this.ws = ws;
+            const onOpen = () => {
+                ws.removeEventListener("error", onError);
+                // role:"viewer" — the signaling server allocates no publish slot.
+                this.send({ type: "join", name: this.options.name, role: "viewer" });
+                resolve();
+            };
+            const onError = (event) => {
+                ws.removeEventListener("open", onOpen);
+                reject(event);
+            };
+            ws.addEventListener("open", onOpen, { once: true });
+            ws.addEventListener("error", onError, { once: true });
+            ws.addEventListener("message", (ev) => void this.onMessage(ev.data));
+            ws.addEventListener("close", (ev) => {
+                this.tearDown();
+                this.emit("close", { code: ev.code, reason: ev.reason });
+            });
+        });
+    }
+    send(msg) {
+        if (this.ws && this.ws.readyState === this.deps.WebSocket.OPEN) {
+            this.ws.send(JSON.stringify(msg));
+        }
+    }
+    tearDown() {
+        for (const r of this.remotes.values())
+            r.pc.close();
+        this.remotes.clear();
+    }
+    /* ---- Protocol ----------------------------------------------------- */
+    async onMessage(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(String(raw));
+        }
+        catch {
+            return;
+        }
+        switch (msg.type) {
+            case "joined": {
+                this.selfId = msg.peerId;
+                // TURN ONLY (no STUN). This viewer runs in an Electron <webview> whose
+                // P2P stack has NO mDNS resolver, so host `.local` candidates never
+                // resolve (-105), and it can't resolve STUN *hostnames* either
+                // (stun.l.google.com / stun.cloudflare.com → -105). The only viable
+                // path is the relay, and the server now advertises TURN by IP
+                // (turn:51.91.126.43:3478), which needs no DNS. Dropping the unusable
+                // STUN hostnames removes the -105 noise and the dead srflx gathering.
+                this.iceServers = msg.turn.urls.map((url) => ({
+                    urls: url,
+                    username: msg.turn.username,
+                    credential: msg.turn.credential,
+                }));
+                this.emit("joined", { peerId: msg.peerId, peers: msg.peers });
+                for (const peer of msg.peers)
+                    this.ensureRemote(peer);
+                break;
+            }
+            case "peer-joined": {
+                this.emit("peer-joined", msg.peer);
+                this.ensureRemote(msg.peer);
+                break;
+            }
+            case "peer-left": {
+                const remote = this.remotes.get(msg.peerId);
+                if (remote) {
+                    // The pc owns the tracks — closing it ends them. The registry/consumer
+                    // are notified via the peer-left event (label-keyed).
+                    remote.pc.close();
+                    this.remotes.delete(msg.peerId);
+                    this.emit("peer-left", { peerId: msg.peerId, peerName: remote.info.name });
+                }
+                break;
+            }
+            case "signal": {
+                await this.handleSignal(msg.from, msg.payload);
+                break;
+            }
+            case "error": {
+                this.emit("error", { code: msg.code, message: msg.message });
+                break;
+            }
+        }
+    }
+    async handleSignal(from, payload) {
+        let remote = this.remotes.get(from);
+        if (!remote) {
+            remote = this.ensureRemote({ id: from, name: from.slice(0, 8), role: "publisher" });
+        }
+        const { pc } = remote;
+        if (payload.kind === "sdp") {
+            const desc = payload.description;
+            const offerCollision = desc.type === "offer" && (remote.makingOffer || pc.signalingState !== "stable");
+            remote.ignoreOffer = !this.isPolite(from) && offerCollision;
+            if (remote.ignoreOffer)
+                return;
+            await pc.setRemoteDescription(desc);
+            for (const c of remote.pendingCandidates) {
+                try {
+                    await pc.addIceCandidate(c);
+                }
+                catch {
+                    /* ignore late/stale candidates */
+                }
+            }
+            remote.pendingCandidates = [];
+            if (desc.type === "offer") {
+                await pc.setLocalDescription();
+                if (pc.localDescription) {
+                    this.sendSignal(from, {
+                        kind: "sdp",
+                        description: {
+                            type: pc.localDescription.type,
+                            sdp: pc.localDescription.sdp,
+                        },
+                    });
+                }
+            }
+            return;
+        }
+        if (payload.kind === "ice") {
+            const init = payload.candidate;
+            if (pc.remoteDescription) {
+                try {
+                    await pc.addIceCandidate(init);
+                }
+                catch (err) {
+                    if (!remote.ignoreOffer)
+                        throw err;
+                }
+            }
+            else {
+                remote.pendingCandidates.push(init);
+            }
+            return;
+        }
+        // control payloads ignored — the viewer does not act on screen/mute hints.
+    }
+    /* ---- Peer setup --------------------------------------------------- */
+    ensureRemote(peer) {
+        const existing = this.remotes.get(peer.id);
+        if (existing)
+            return existing;
+        // relay-only: in the Electron <webview> host (.local) and srflx candidates
+        // are unusable (no mDNS resolver, STUN hostnames unresolvable), so force the
+        // ICE agent to gather/use ONLY relay candidates via the by-IP TURN server.
+        // The publisher (browser) gathers all transports incl. relay, so the
+        // relay↔relay pair connects. Avoids ICE stalling on dead host/srflx checks.
+        const pc = new this.deps.RTCPeerConnection({
+            iceServers: this.iceServers,
+            iceTransportPolicy: "relay",
+        });
+        const stream = new this.deps.MediaStream();
+        // VIEWER : both transceivers are recvonly and carry NO local track. Order
+        // (audio first, video second) must match the publisher's so the m-lines
+        // line up — the same invariant as the reference.
+        const audioTx = pc.addTransceiver("audio", { direction: "recvonly" });
+        const videoTx = pc.addTransceiver("video", { direction: "recvonly" });
+        // BUNDLE codec-collision fix (ADR 006 #3). A recvonly viewer offering the
+        // FULL Chromium codec catalogue (VP8/VP9×profiles/H264×profiles/AV1/H265 +
+        // rtx/red/ulpfec/flexfec, audio opus + telephone-event) maximises payload-
+        // type pressure. Under BUNDLE all m-lines share ONE PT namespace, so when
+        // the publisher (answerer, with pre-allocated sendrecv transceivers — see
+        // `meet-client.ts`) reconciles that dense offer, PTs collide ACROSS m-lines
+        // (the observed `126` audio telephone-event vs `39` video H264). A pure
+        // viewer needs ONE coherent codec per kind, not the whole catalogue : we
+        // pin a deduplicated, minimal preference set so the offered PT space is
+        // small and collision-free by construction. This is NOT SDP munging — it is
+        // the spec'd `setCodecPreferences` API ; Chromium still owns PT assignment.
+        pinViewerCodecs(audioTx, videoTx);
+        const state = {
+            info: peer,
+            pc,
+            stream,
+            makingOffer: false,
+            ignoreOffer: false,
+            pendingCandidates: [],
+        };
+        pc.addEventListener("negotiationneeded", () => {
+            void (async () => {
+                try {
+                    state.makingOffer = true;
+                    await pc.setLocalDescription();
+                    if (pc.localDescription) {
+                        this.sendSignal(peer.id, {
+                            kind: "sdp",
+                            description: {
+                                type: pc.localDescription.type,
+                                sdp: pc.localDescription.sdp,
+                            },
+                        });
+                    }
+                }
+                catch {
+                    /* transient — glare or mid-close */
+                }
+                finally {
+                    state.makingOffer = false;
+                }
+            })();
+        });
+        pc.addEventListener("icecandidate", (ev) => {
+            const candidate = ev.candidate;
+            if (!candidate)
+                return;
+            this.sendSignal(peer.id, {
+                kind: "ice",
+                candidate: {
+                    candidate: candidate.candidate,
+                    sdpMid: candidate.sdpMid,
+                    sdpMLineIndex: candidate.sdpMLineIndex,
+                    usernameFragment: candidate.usernameFragment,
+                },
+            });
+        });
+        pc.addEventListener("track", (ev) => {
+            const track = ev.track;
+            // Aggregate every incoming track into the peer's single MediaStream so
+            // the consumer gets one coherent source for `<video srcObject>`.
+            if (!state.stream.getTracks().includes(track)) {
+                state.stream.addTrack(track);
+            }
+            track.addEventListener("ended", () => {
+                state.stream.removeTrack(track);
+            });
+            this.emit("remote-track", {
+                peerId: peer.id,
+                peerName: peer.name,
+                stream: state.stream,
+            });
+        });
+        pc.addEventListener("connectionstatechange", () => {
+            this.emit("connection-state", { peerId: peer.id, state: pc.connectionState });
+            if (pc.connectionState === "failed" || pc.connectionState === "closed") {
+                this.remotes.delete(peer.id);
+                this.emit("peer-left", { peerId: peer.id, peerName: peer.name });
+            }
+        });
+        this.remotes.set(peer.id, state);
+        return state;
+    }
+    /* ---- Helpers ------------------------------------------------------ */
+    isPolite(otherId) {
+        if (!this.selfId)
+            return false;
+        return this.selfId > otherId;
+    }
+    sendSignal(to, payload) {
+        this.send({ type: "signal", to, payload });
+    }
+    emit(type, event) {
+        const set = this.listeners.get(type);
+        if (!set)
+            return;
+        for (const listener of set)
+            listener(event);
+    }
+}
+/* ---- Codec preference (BUNDLE collision fix) ----------------------- */
+/** Pin a minimal, deduplicated codec preference on a viewer's recvonly
+ *  transceivers so the offered payload-type space stays small and BUNDLE-safe.
+ *
+ *  AUDIO  : opus (+ keep telephone-event for spec completeness, it is harmless).
+ *  VIDEO  : H264 + its rtx ONLY (drop VP9/AV1/H265 multi-profile clutter). H264
+ *           is what the publisher (Prism cam / Pulsar NVENC) emits ; a viewer
+ *           that only ever RECEIVES needs no broader set. rtx is kept so NACK
+ *           retransmission still works.
+ *
+ *  Feature-detected end-to-end : if `setCodecPreferences` or
+ *  `RTCRtpReceiver.getCapabilities` is unavailable (older engines, jsdom/test
+ *  fakes), this is a silent no-op and the transceiver keeps Chromium's default
+ *  full list — behaviour is never WORSE than before the fix. */
+function pinViewerCodecs(audioTx, videoTx) {
+    const getCaps = globalThis.RTCRtpReceiver?.getCapabilities;
+    if (typeof getCaps !== "function")
+        return;
+    pinKind(videoTx, getCaps("video"), (mime) => {
+        const m = mime.toLowerCase();
+        // Keep H264 and the generic rtx (retransmission) codec only.
+        return m === "video/h264" || m === "video/rtx";
+    });
+    pinKind(audioTx, getCaps("audio"), (mime) => {
+        const m = mime.toLowerCase();
+        return m === "audio/opus" || m === "audio/telephone-event";
+    });
+}
+/** Apply `setCodecPreferences` with the subset of `caps` whose mimeType passes
+ *  `keep`, preserving the platform's preferred order. Guarded : no transceiver,
+ *  no `setCodecPreferences`, no caps, or an empty filtered set → no-op. */
+function pinKind(tx, caps, keep) {
+    const setPrefs = tx
+        ?.setCodecPreferences;
+    if (typeof setPrefs !== "function" || !caps)
+        return;
+    const codecs = caps.codecs.filter((c) => keep(c.mimeType));
+    if (codecs.length === 0)
+        return; // never offer an empty m-line
+    try {
+        setPrefs.call(tx, codecs);
+    }
+    catch {
+        // Some engines reject a preference list (e.g. rtx without its apt primary in
+        // the same call) — fall back to the default full list rather than break the
+        // transceiver. The fix is best-effort hardening, never a hard dependency.
+    }
+}
+//# sourceMappingURL=meet-viewer.js.map

package/dist/webrtc/meet-viewer.js.map

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

package/dist/webrtc/peer-stream-registry.d.ts

@@ -0,0 +1,21 @@
+export type PeerStreamListener = (stream: MediaStream | null) => void;
+export interface PeerStreamRegistry {
+    /** #4 contract — the current stream for a label, or `null` if the peer is not
+     *  connected (yet / any more). Synchronous, side-effect free. */
+    resolve(peerLabel: string): MediaStream | null;
+    /** Push channel for the LIVE `media` primitive : invoked immediately with the
+     *  current value, then on every change for `peerLabel`. Returns an
+     *  unsubscribe. */
+    subscribe(peerLabel: string, listener: PeerStreamListener): () => void;
+    /** Viewer-side : publish / replace a peer's stream (peer connected). */
+    set(peerLabel: string, stream: MediaStream): void;
+    /** Viewer-side : drop a peer's stream (peer left / connection failed). The
+     *  registry forgets the reference ; it does NOT stop the tracks (the viewer's
+     *  pc.close() does, as the track owner). */
+    remove(peerLabel: string): void;
+    /** Viewer-side : forget every entry (room teardown). Reference-only, no track
+     *  stops. */
+    clear(): void;
+}
+export declare function createPeerStreamRegistry(): PeerStreamRegistry;
+//# sourceMappingURL=peer-stream-registry.d.ts.map

package/dist/webrtc/peer-stream-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-stream-registry.d.ts","sourceRoot":"","sources":["../../src/webrtc/peer-stream-registry.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IACjC;qEACiE;IACjE,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IAC/C;;uBAEmB;IACnB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAAC;IACvE,wEAAwE;IACxE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAClD;;gDAE4C;IAC5C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;iBACa;IACb,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAgD7D"}

package/dist/webrtc/peer-stream-registry.js

@@ -0,0 +1,77 @@
+// Peer-stream registry — the bridge between the WebRTC viewer (#3) and the
+// `media` primitive's LIVE mode (#4).
+//
+// The viewer feeds this registry one entry per CONNECTED peer, keyed by the
+// peer's STABLE `peer_label` (the ZabCam contract label #6, announced on the
+// mesh as the peer's join `name` — see `PeerInfo.name` / `RemoteTrackEvent`).
+// The `media` primitive resolves `peerLabel → MediaStream` through it.
+//
+// Reactivity : a peer's stream becomes available ASYNCHRONOUSLY (after the room
+// join + SDP/ICE), so a `media` node that mounted before the peer connected
+// must be notified when its stream arrives. The registry exposes both a
+// one-shot `resolvePeerStream` (the #4 contract, synchronous) AND a
+// `subscribePeerStream(label, cb)` push channel the LIVE primitive uses to
+// re-render on connect / disconnect. The store is a plain Map guarded by a
+// listener set — no signals dependency, so it adds nothing to the render path.
+//
+// OWNERSHIP (the #3↔#4 lifecycle decision) : the registry NEVER creates or
+// stops a track. It only HOLDS a reference to a `MediaStream` owned by the
+// viewer's `RTCPeerConnection`. The viewer is the sole authority on the track
+// lifecycle (created on `track`, removed on `ended` / `peer-left` / teardown).
+// A consuming `<video>` unmounting clears its own `srcObject` and nothing else
+// — it can never tear a peer down for the on-air composite.
+export function createPeerStreamRegistry() {
+    const streams = new Map();
+    const listeners = new Map();
+    function notify(peerLabel) {
+        const set = listeners.get(peerLabel);
+        if (set === undefined)
+            return;
+        const value = streams.get(peerLabel) ?? null;
+        for (const listener of set)
+            listener(value);
+    }
+    return {
+        resolve(peerLabel) {
+            return streams.get(peerLabel) ?? null;
+        },
+        subscribe(peerLabel, listener) {
+            let set = listeners.get(peerLabel);
+            if (set === undefined) {
+                set = new Set();
+                listeners.set(peerLabel, set);
+            }
+            set.add(listener);
+            // Emit the current value synchronously so a late subscriber sees an
+            // already-connected peer without waiting for the next change.
+            listener(streams.get(peerLabel) ?? null);
+            return () => {
+                const s = listeners.get(peerLabel);
+                if (s === undefined)
+                    return;
+                s.delete(listener);
+                if (s.size === 0)
+                    listeners.delete(peerLabel);
+            };
+        },
+        set(peerLabel, stream) {
+            if (streams.get(peerLabel) === stream)
+                return; // idempotent re-emit guard
+            streams.set(peerLabel, stream);
+            notify(peerLabel);
+        },
+        remove(peerLabel) {
+            if (!streams.has(peerLabel))
+                return;
+            streams.delete(peerLabel);
+            notify(peerLabel);
+        },
+        clear() {
+            const labels = [...streams.keys()];
+            streams.clear();
+            for (const label of labels)
+                notify(label);
+        },
+    };
+}
+//# sourceMappingURL=peer-stream-registry.js.map

package/dist/webrtc/peer-stream-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-stream-registry.js","sourceRoot":"","sources":["../../src/webrtc/peer-stream-registry.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,sCAAsC;AACtC,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,uEAAuE;AACvE,EAAE;AACF,gFAAgF;AAChF,4EAA4E;AAC5E,wEAAwE;AACxE,oEAAoE;AACpE,2EAA2E;AAC3E,2EAA2E;AAC3E,+EAA+E;AAC/E,EAAE;AACF,2EAA2E;AAC3E,2EAA2E;AAC3E,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,4DAA4D;AAuB5D,MAAM,UAAU,wBAAwB;IACtC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAmC,CAAC;IAE7D,SAAS,MAAM,CAAC,SAAiB;QAC/B,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;QAC7C,KAAK,MAAM,QAAQ,IAAI,GAAG;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,OAAO,CAAC,SAAS;YACf,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;QACxC,CAAC;QACD,SAAS,CAAC,SAAS,EAAE,QAAQ;YAC3B,IAAI,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACnC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;gBAChB,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAChC,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAClB,oEAAoE;YACpE,8DAA8D;YAC9D,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,CAAC;YACzC,OAAO,GAAG,EAAE;gBACV,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACnC,IAAI,CAAC,KAAK,SAAS;oBAAE,OAAO;gBAC5B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACnB,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;oBAAE,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAChD,CAAC,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,SAAS,EAAE,MAAM;YACnB,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,MAAM;gBAAE,OAAO,CAAC,2BAA2B;YAC1E,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC/B,MAAM,CAAC,SAAS,CAAC,CAAC;QACpB,CAAC;QACD,MAAM,CAAC,SAAS;YACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,OAAO;YACpC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC1B,MAAM,CAAC,SAAS,CAAC,CAAC;QACpB,CAAC;QACD,KAAK;YACH,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACnC,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,KAAK,MAAM,KAAK,IAAI,MAAM;gBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumencast/runtime",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Browser runtime for Lumencast — mount(), LSDP/1 transport, leaf-grain store, LSML render, animations, overlays.",
   "license": "Apache-2.0",
   "type": "module",
@@ -36,7 +36,7 @@
     "framer-motion": "^12.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@lumencast/protocol": "0.9.0"
+    "@lumencast/protocol": "0.10.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.49.1",
@@ -50,8 +50,8 @@
     "vite-plugin-dts": "^4.5.0",
     "vitest": "^4.1.5",
     "ws": "^8.18.0",
-    "@lumencast/server": "0.9.0",
-    "@lumencast/dev-server": "0.9.0"
+    "@lumencast/dev-server": "0.10.0",
+    "@lumencast/server": "0.10.0"
   },
   "scripts": {
     "dev": "vite",

package/src/app.tsx

@@ -19,6 +19,7 @@ import type { RenderBundle } from "./render/bundle.js";
 import type { ConnectionStatus } from "./transport/ws.js";
 import { LumencastRuntimeProvider } from "./overlay/runtime-context.js";
 import type { ResolveCaptureDevice } from "./render/primitives/capture.js";
+import type { ResolvePeerStream, SubscribePeerStream } from "./render/primitives/media.js";
 import type { LumencastMode } from "./types.js";
 
 const LazyBroadcastMode = lazy(() =>
@@ -38,6 +39,10 @@ export interface LumencastAppProps {
   sendInput: (patches: Patch[]) => void;
   /** ADR 004 §A1.3 — host resolver for `x-zab.capture` ACQUIRE mode. */
   resolveCaptureDevice?: ResolveCaptureDevice;
+  /** ADR 006 #4 — host resolver for the `media` primitive's LIVE mode. */
+  resolvePeerStream?: ResolvePeerStream;
+  /** ADR 006 #3 — reactive peer-stream channel (preferred over the resolver). */
+  subscribePeerStream?: SubscribePeerStream;
 }
 
 export function LumencastApp({
@@ -48,6 +53,8 @@ export function LumencastApp({
   crossfadeKeySignal,
   sendInput,
   resolveCaptureDevice,
+  resolvePeerStream,
+  subscribePeerStream,
 }: LumencastAppProps) {
   useSignals();
 
@@ -77,6 +84,8 @@ export function LumencastApp({
             status,
             sendInput,
             ...(resolveCaptureDevice !== undefined ? { resolveCaptureDevice } : {}),
+            ...(resolvePeerStream !== undefined ? { resolvePeerStream } : {}),
+            ...(subscribePeerStream !== undefined ? { subscribePeerStream } : {}),
           }}
         >
           <Suspense fallback={null}>

package/src/index.ts

@@ -31,6 +31,41 @@ export { PRIMITIVE_PROP_ALLOWLIST } from "./render/prop-allowlist.js";
 // app (Prism/Solar) types its injected resolver against the runtime's contract.
 export type { ResolveCaptureDevice } from "./render/primitives/capture.js";
 
+// ADR 006 #4 — host resolver mapping a `peerLabel` to a peer's live MediaStream
+// (the `media` primitive's LIVE mode), supplied via `MountOptions.resolvePeerStream`.
+// Exported so the WebRTC viewer (#3) types its injected resolver against the
+// runtime's contract.
+export type { ResolvePeerStream, SubscribePeerStream } from "./render/primitives/media.js";
+
+// ADR 006 #3 — WebRTC viewer (mesh, viewer role) + peer-stream registry. The
+// #3↔#4 bridge : a viewer joins Meet room(s), receives N peers and returns the
+// `resolvePeerStream` / `subscribePeerStream` the `media`/`meet.peer` LIVE render
+// consumes via `MountOptions`. The viewer never publishes (no getUserMedia) ; it
+// owns the peer connections + the track lifecycle.
+//
+// FINAL MODEL : `createMultiRoomPeerViewer({ rooms: [...] })` joins EVERY room
+// and aggregates all peers into ONE registry (first-connected-wins on a label
+// collision). `createPeerViewerFromInjection` normalises the host-injected
+// `window.__ZAB_PEER_VIEWER__` (multi-room `{rooms}` OR legacy single-room).
+export {
+  createPeerViewer,
+  createMultiRoomPeerViewer,
+  createPeerViewerFromInjection,
+  MeetViewer,
+  createPeerStreamRegistry,
+  type PeerViewer,
+  type MultiRoomPeerViewer,
+  type MultiRoomPeerViewerOptions,
+  type RoomOptions,
+  type PeerViewerInjection,
+  type MeetViewerOptions,
+  type MeetViewerDeps,
+  type PeerInfo,
+  type RemoteTrackEvent,
+  type PeerStreamRegistry,
+  type PeerStreamListener,
+} from "./webrtc/index.js";
+
 // Bundle types are useful for hosts that want to typecheck pre-compiled scenes.
 export type {
   RenderBundle,

package/src/mount.ts

@@ -123,6 +123,17 @@ export function mount(options: MountOptions): LumencastHandle {
       ...(options.resolveCaptureDevice !== undefined
         ? { resolveCaptureDevice: options.resolveCaptureDevice }
         : {}),
+      // ADR 006 #4 — thread the host peer-stream resolver (supplied by the
+      // WebRTC viewer #3) so the `media` primitive's LIVE mode can render a
+      // peer's MediaStream in `srcObject`.
+      ...(options.resolvePeerStream !== undefined
+        ? { resolvePeerStream: options.resolvePeerStream }
+        : {}),
+      // ADR 006 #3 — reactive variant : the LIVE `media` node re-renders when a
+      // peer connects/leaves mid-show. `createPeerViewer()` supplies it.
+      ...(options.subscribePeerStream !== undefined
+        ? { subscribePeerStream: options.subscribePeerStream }
+        : {}),
     }),
   );
 

package/src/overlay/runtime-context.tsx

@@ -5,6 +5,7 @@ import type { RenderBundle } from "../render/bundle";
 import type { ConnectionStatus } from "../transport/ws";
 import type { LumencastMode } from "../types";
 import type { ResolveCaptureDevice } from "../render/primitives/capture";
+import type { ResolvePeerStream, SubscribePeerStream } from "../render/primitives/media";
 
 export interface LumencastRuntime {
   mode: LumencastMode;
@@ -17,6 +18,15 @@ export interface LumencastRuntime {
    *  physical `deviceId` for the `x-zab.capture` primitive's ACQUIRE mode.
    *  Injected from `MountOptions`, NOT the bundle. Absent → default device. */
   resolveCaptureDevice?: ResolveCaptureDevice;
+  /** ADR 006 #4 — host-provided resolver mapping a LOGICAL `peerLabel` to the
+   *  live `MediaStream` of a `meet.peer`, for the `media` primitive's LIVE mode.
+   *  Injected from `MountOptions` (supplied by the WebRTC viewer #3), NOT the
+   *  bundle. Absent → the live `media` node is a stream-less box. */
+  resolvePeerStream?: ResolvePeerStream;
+  /** ADR 006 #3 — reactive variant : the viewer pushes a peer's stream on
+   *  connect and `null` on leave, so a LIVE `media` node re-renders when its
+   *  peer joins mid-show. Preferred over `resolvePeerStream` when present. */
+  subscribePeerStream?: SubscribePeerStream;
 }
 
 const Ctx = createContext<LumencastRuntime | null>(null);