realtime-avatar 0.1.0

package/dist/session-socket.d.ts

@@ -0,0 +1,96 @@
+import { type AvatarMuxEvent } from "./mux";
+import type { RealtimePrepareRequest, RealtimePrepareResponse, RealtimeTurnRequest } from "./types";
+/** Errors surfaced by the realtime session socket (connection, close, server `error` events). */
+export declare class RealtimeAvatarSessionError extends Error {
+    readonly detail: Record<string, unknown> | null;
+    constructor(message: string, detail?: Record<string, unknown> | null);
+    /** Machine-readable error code from the server `error` event, when present. */
+    readonly code?: string;
+    /** Mirrors RealtimeAvatarApiError so billing failures over the socket raise the same paywall handling. */
+    get isBillingRequired(): boolean;
+}
+/** Structural turn-event source — satisfied by both `RealtimeTurnStream` and {@link RealtimeSessionSocket.turn}. */
+export type AvatarTurnEventSource = {
+    events: AsyncGenerator<AvatarMuxEvent>;
+};
+export type RealtimeSessionSocketOptions = {
+    /** Full ws(s):// URL of the realtime session endpoint. */
+    url: string;
+    /**
+     * Extra headers, e.g. `{ Authorization: "Bearer ..." }`. Server-side
+     * runtimes only (Bun/undici accept headers on `new WebSocket`); browsers
+     * cannot set WebSocket headers and must authenticate via a same-origin
+     * proxy (cookies) instead.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Short-lived signed session token, appended as `?token=` — the browser
+     * auth path (browsers cannot set WebSocket headers). Mint one from your
+     * backend; the platform exposes a cookie-authenticated mint endpoint.
+     */
+    token?: string;
+    /** Override the WebSocket constructor (tests, Node `ws` package). */
+    WebSocketImpl?: typeof WebSocket;
+    /** Abort handshake + session. */
+    signal?: AbortSignal;
+    /**
+     * Idle keepalive interval in ms; `0` disables. Defaults to 25s. Pings are
+     * only sent while no prepare/turn is in flight, and exist so idle proxies
+     * never silently drop the warm session — a dead socket costs the next turn
+     * the full reconnect-and-prepare path.
+     */
+    keepAliveIntervalMs?: number;
+};
+/**
+ * One realtime session over one WebSocket — which on the Modal runtime means
+ * ONE GPU container for `prepare()` and every subsequent turn. The HTTP
+ * endpoints route each request independently, so a turn can land on a
+ * container that never saw the prepare and re-pay the avatar load; this
+ * socket is the low-latency path.
+ *
+ *     const session = await RealtimeSessionSocket.connect({ url, headers });
+ *     const prepared = await session.prepare({ source_kind: "source_video", ... });
+ *     const turn = session.turn({ mode: "speak_text", text: "hi", ... });
+ *     await player.play(turn);   // AvatarPlayer accepts any { events } source
+ *     session.close();
+ *
+ * One operation at a time: a second `prepare()`/`turn()` while one is
+ * streaming rejects immediately.
+ */
+export declare class RealtimeSessionSocket {
+    private readonly socket;
+    private pending;
+    private turnSink;
+    private closed;
+    private keepAlive;
+    private constructor();
+    /** Ping the server on an interval while idle so intermediaries keep the session alive. */
+    private startKeepAlive;
+    private stopKeepAlive;
+    /** Connect and resolve once the server confirms the session (`session_ready`). */
+    static connect(options: RealtimeSessionSocketOptions): Promise<RealtimeSessionSocket>;
+    /** Warm this container for the avatar; resolves with the standard prepare response. */
+    prepare(request: RealtimePrepareRequest): Promise<RealtimePrepareResponse>;
+    /** Round-trip latency probe. Resolves with elapsed milliseconds. */
+    ping(): Promise<number>;
+    /**
+     * Run one turn on this session's container. Returns immediately; consume
+     * `.events` (ends after `done`). Pass directly to `AvatarPlayer.play()`.
+     */
+    turn(request: RealtimeTurnRequest): AvatarTurnEventSource;
+    /**
+     * Stop the in-flight turn server-side (the GPU stops rendering frames nobody
+     * will play) while KEEPING the session socket usable for the next turn.
+     * Resolves once the server confirms (`turn_cancelled`) or the turn ends on
+     * its own; rejects after `timeoutMs` — close the socket if that happens.
+     * No-op when no turn is streaming.
+     */
+    cancelTurn(timeoutMs?: number): Promise<void>;
+    /** True while the socket is connected and usable for prepare/turn calls. */
+    get open(): boolean;
+    close(): void;
+    private assertIdle;
+    private route;
+    private fail;
+}
+//# sourceMappingURL=session-socket.d.ts.map

package/dist/session-socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-socket.d.ts","sourceRoot":"","sources":["../src/session-socket.ts"],"names":[],"mappings":"AACA,OAAO,EAA0C,KAAK,cAAc,EAAuB,MAAM,OAAO,CAAC;AACzG,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEpG,iGAAiG;AACjG,qBAAa,0BAA2B,SAAQ,KAAK;IAGjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;gBAD/C,OAAO,EAAE,MAAM,EACN,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAW;IAOxD,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB,0GAA0G;IAC1G,IAAI,iBAAiB,IAAI,OAAO,CAE/B;CACF;AAID,oHAAoH;AACpH,MAAM,MAAM,qBAAqB,GAAG;IAAE,MAAM,EAAE,cAAc,CAAC,cAAc,CAAC,CAAA;CAAE,CAAC;AAE/E,MAAM,MAAM,4BAA4B,GAAG;IACzC,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,aAAa,CAAC,EAAE,OAAO,SAAS,CAAC;IACjC,iCAAiC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,qBAAqB;IAgBZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAf3C,OAAO,CAAC,OAAO,CAIC;IAChB,OAAO,CAAC,QAAQ,CAMA;IAChB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,SAAS,CAA+C;IAEhE,OAAO;IAEP,0FAA0F;IAC1F,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,aAAa;IAOrB,kFAAkF;IAClF,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA+DrF,uFAAuF;IACvF,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAS1E,oEAAoE;IACpE,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAUvB;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,qBAAqB;IAgDzD;;;;;;OAMG;IACH,UAAU,CAAC,SAAS,SAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB5C,4EAA4E;IAC5E,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,KAAK;IAwCb,OAAO,CAAC,IAAI;CAcb"}

package/dist/session-socket.js

@@ -0,0 +1,299 @@
+import { RealtimeAvatarConfigError } from "./errors";
+import { decodeAvatarMuxFrame, toAvatarMuxEvent } from "./mux";
+/** Errors surfaced by the realtime session socket (connection, close, server `error` events). */
+export class RealtimeAvatarSessionError extends Error {
+    detail;
+    constructor(message, detail = null) {
+        super(message);
+        this.detail = detail;
+        this.name = "RealtimeAvatarSessionError";
+        this.code = typeof detail?.code === "string" ? detail.code : undefined;
+    }
+    /** Machine-readable error code from the server `error` event, when present. */
+    code;
+    /** Mirrors RealtimeAvatarApiError so billing failures over the socket raise the same paywall handling. */
+    get isBillingRequired() {
+        return this.code === "insufficient_credits" || this.code === "spend_limit_exceeded";
+    }
+}
+/**
+ * One realtime session over one WebSocket — which on the Modal runtime means
+ * ONE GPU container for `prepare()` and every subsequent turn. The HTTP
+ * endpoints route each request independently, so a turn can land on a
+ * container that never saw the prepare and re-pay the avatar load; this
+ * socket is the low-latency path.
+ *
+ *     const session = await RealtimeSessionSocket.connect({ url, headers });
+ *     const prepared = await session.prepare({ source_kind: "source_video", ... });
+ *     const turn = session.turn({ mode: "speak_text", text: "hi", ... });
+ *     await player.play(turn);   // AvatarPlayer accepts any { events } source
+ *     session.close();
+ *
+ * One operation at a time: a second `prepare()`/`turn()` while one is
+ * streaming rejects immediately.
+ */
+export class RealtimeSessionSocket {
+    socket;
+    pending = null;
+    turnSink = null;
+    closed = null;
+    keepAlive = null;
+    constructor(socket) {
+        this.socket = socket;
+    }
+    /** Ping the server on an interval while idle so intermediaries keep the session alive. */
+    startKeepAlive(intervalMs) {
+        if (intervalMs <= 0)
+            return;
+        const timer = setInterval(() => {
+            if (!this.open || this.pending || this.turnSink)
+                return;
+            try {
+                this.socket.send(JSON.stringify({ type: "ping" }));
+            }
+            catch {
+                // The close handler tears the session down; nothing to do here.
+            }
+        }, intervalMs);
+        // Node timers hold the event loop open; a keepalive must not.
+        timer.unref?.();
+        this.keepAlive = timer;
+    }
+    stopKeepAlive() {
+        if (this.keepAlive !== null) {
+            clearInterval(this.keepAlive);
+            this.keepAlive = null;
+        }
+    }
+    /** Connect and resolve once the server confirms the session (`session_ready`). */
+    static connect(options) {
+        const WebSocketCtor = options.WebSocketImpl ?? globalThis.WebSocket;
+        if (!WebSocketCtor) {
+            throw new RealtimeAvatarConfigError("A WebSocket implementation is required for realtime sessions");
+        }
+        const url = options.token
+            ? `${options.url}${options.url.includes("?") ? "&" : "?"}token=${encodeURIComponent(options.token)}`
+            : options.url;
+        const socket = options.headers
+            ? new WebSocketCtor(url, { headers: options.headers })
+            : new WebSocketCtor(url);
+        socket.binaryType = "arraybuffer";
+        const session = new RealtimeSessionSocket(socket);
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const settle = (fn) => {
+                if (!settled) {
+                    settled = true;
+                    fn();
+                }
+            };
+            options.signal?.addEventListener("abort", () => {
+                socket.close();
+                settle(() => reject(new RealtimeAvatarSessionError("Realtime session aborted")));
+            }, { once: true });
+            socket.addEventListener("message", (message) => {
+                let frame;
+                try {
+                    frame = decodeAvatarMuxFrame(toBytes(message.data));
+                }
+                catch (error) {
+                    session.fail(error instanceof Error ? error : new Error(String(error)));
+                    return;
+                }
+                if (frame.type === "session_ready") {
+                    settle(() => {
+                        session.startKeepAlive(options.keepAliveIntervalMs ?? 25_000);
+                        resolve(session);
+                    });
+                    return;
+                }
+                session.route(frame);
+            });
+            socket.addEventListener("close", (event) => {
+                session.fail(new RealtimeAvatarSessionError(`Realtime session closed (${event.code}${event.reason ? `: ${event.reason}` : ""})`), 
+                /* graceful */ event.code === 1000);
+                settle(() => reject(new RealtimeAvatarSessionError("Realtime session closed before it was ready")));
+            });
+            socket.addEventListener("error", () => {
+                settle(() => reject(new RealtimeAvatarSessionError("Realtime session connection failed")));
+            });
+        });
+    }
+    /** Warm this container for the avatar; resolves with the standard prepare response. */
+    prepare(request) {
+        this.assertIdle();
+        const frame = new Promise((resolve, reject) => {
+            this.pending = { resolve, reject, kind: "prepare" };
+        });
+        this.socket.send(JSON.stringify({ type: "prepare", ...request }));
+        return frame.then(({ header }) => header);
+    }
+    /** Round-trip latency probe. Resolves with elapsed milliseconds. */
+    ping() {
+        this.assertIdle();
+        const started = nowMs();
+        const frame = new Promise((resolve, reject) => {
+            this.pending = { resolve, reject, kind: "pong" };
+        });
+        this.socket.send(JSON.stringify({ type: "ping" }));
+        return frame.then(() => nowMs() - started);
+    }
+    /**
+     * Run one turn on this session's container. Returns immediately; consume
+     * `.events` (ends after `done`). Pass directly to `AvatarPlayer.play()`.
+     */
+    turn(request) {
+        this.assertIdle();
+        const queue = [];
+        let wake = null;
+        let finished = false;
+        let failure = null;
+        let settle;
+        const settled = new Promise((resolve) => {
+            settle = resolve;
+        });
+        // Sink lifetime is owned by `route()`/`fail()` (cleared on done/error/
+        // turn_cancelled/socket loss), NOT by the consumer: a player that stops
+        // reading mid-turn must not orphan the cancel confirmation.
+        const sink = {
+            push: (event) => {
+                queue.push(event);
+                wake?.();
+            },
+            fail: (error) => {
+                failure = error;
+                finished = true;
+                settle();
+                wake?.();
+            },
+            end: () => {
+                finished = true;
+                settle();
+                wake?.();
+            },
+            settled,
+        };
+        this.turnSink = sink;
+        this.socket.send(JSON.stringify({ type: "turn", ...request }));
+        async function* events() {
+            while (true) {
+                while (queue.length > 0)
+                    yield queue.shift();
+                if (failure)
+                    throw failure;
+                if (finished)
+                    return;
+                await new Promise((resolve) => {
+                    wake = resolve;
+                });
+                wake = null;
+            }
+        }
+        return { events: events() };
+    }
+    /**
+     * Stop the in-flight turn server-side (the GPU stops rendering frames nobody
+     * will play) while KEEPING the session socket usable for the next turn.
+     * Resolves once the server confirms (`turn_cancelled`) or the turn ends on
+     * its own; rejects after `timeoutMs` — close the socket if that happens.
+     * No-op when no turn is streaming.
+     */
+    cancelTurn(timeoutMs = 5_000) {
+        const sink = this.turnSink;
+        if (this.closed || !sink)
+            return Promise.resolve();
+        this.socket.send(JSON.stringify({ type: "cancel" }));
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new RealtimeAvatarSessionError("Turn cancel was not confirmed in time")), timeoutMs);
+            void sink.settled.then(() => {
+                clearTimeout(timer);
+                resolve();
+            });
+        });
+    }
+    /** True while the socket is connected and usable for prepare/turn calls. */
+    get open() {
+        return this.closed === null && this.socket.readyState === 1;
+    }
+    close() {
+        this.stopKeepAlive();
+        this.socket.close(1000);
+    }
+    assertIdle() {
+        if (this.closed)
+            throw this.closed;
+        if (this.pending || this.turnSink) {
+            throw new RealtimeAvatarConfigError("The realtime session already has an operation in flight");
+        }
+    }
+    route(frame) {
+        if (frame.type === "prepared" || frame.type === "pong") {
+            const pending = this.pending;
+            // Drop strays: keepalive pongs nobody awaits, and frames whose kind
+            // doesn't match the pending operation (a pong must never resolve a
+            // prepare with the wrong header).
+            if (!pending || (frame.type === "prepared") !== (pending.kind === "prepare"))
+                return;
+            this.pending = null;
+            pending.resolve(frame);
+            return;
+        }
+        if (frame.type === "error" && this.pending) {
+            const pending = this.pending;
+            this.pending = null;
+            pending.reject(new RealtimeAvatarSessionError(String(frame.header.message ?? "Realtime session error"), frame.header));
+            return;
+        }
+        const sink = this.turnSink;
+        if (!sink)
+            return; // stray event outside any operation
+        if (frame.type === "turn_cancelled") {
+            sink.end();
+            this.turnSink = null;
+            return;
+        }
+        let event;
+        try {
+            event = toAvatarMuxEvent(frame);
+        }
+        catch (error) {
+            sink.fail(error instanceof Error ? error : new Error(String(error)));
+            this.turnSink = null;
+            return;
+        }
+        sink.push(event);
+        // `error` terminates the turn but keeps the session usable; `done` ends it.
+        if (event.header.type === "done" || event.header.type === "error") {
+            sink.end();
+            this.turnSink = null;
+        }
+    }
+    fail(error, graceful = false) {
+        if (this.closed)
+            return;
+        this.closed = error;
+        this.stopKeepAlive();
+        const pending = this.pending;
+        this.pending = null;
+        pending?.reject(error);
+        const sink = this.turnSink;
+        this.turnSink = null;
+        if (sink) {
+            if (graceful)
+                sink.end();
+            else
+                sink.fail(error);
+        }
+    }
+}
+function toBytes(data) {
+    if (data instanceof ArrayBuffer)
+        return new Uint8Array(data);
+    if (data instanceof Uint8Array)
+        return data;
+    throw new Error("Realtime session expected binary WebSocket messages");
+}
+function nowMs() {
+    return typeof performance !== "undefined" ? performance.now() : Date.now();
+}
+//# sourceMappingURL=session-socket.js.map

package/dist/session-socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-socket.js","sourceRoot":"","sources":["../src/session-socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAA4C,MAAM,OAAO,CAAC;AAGzG,iGAAiG;AACjG,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAGxC;IAFX,YACE,OAAe,EACN,SAAyC,IAAI;QAEtD,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,WAAM,GAAN,MAAM,CAAuC;QAGtD,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,OAAO,MAAM,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,CAAC;IAED,+EAA+E;IACtE,IAAI,CAAU;IAEvB,0GAA0G;IAC1G,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,IAAI,KAAK,sBAAsB,IAAI,IAAI,CAAC,IAAI,KAAK,sBAAsB,CAAC;IACtF,CAAC;CACF;AAoCD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,qBAAqB;IAgBK;IAf7B,OAAO,GAIJ,IAAI,CAAC;IACR,QAAQ,GAML,IAAI,CAAC;IACR,MAAM,GAAiB,IAAI,CAAC;IAC5B,SAAS,GAA0C,IAAI,CAAC;IAEhE,YAAqC,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAE1D,0FAA0F;IAClF,cAAc,CAAC,UAAkB;QACvC,IAAI,UAAU,IAAI,CAAC;YAAE,OAAO;QAC5B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ;gBAAE,OAAO;YACxD,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YACrD,CAAC;YAAC,MAAM,CAAC;gBACP,gEAAgE;YAClE,CAAC;QACH,CAAC,EAAE,UAAU,CAAC,CAAC;QACf,8DAA8D;QAC7D,KAA2C,CAAC,KAAK,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAEO,aAAa;QACnB,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC5B,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;IAED,kFAAkF;IAClF,MAAM,CAAC,OAAO,CAAC,OAAqC;QAClD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,UAAU,CAAC,SAAS,CAAC;QACpE,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,yBAAyB,CAAC,8DAA8D,CAAC,CAAC;QACtG,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK;YACvB,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACpG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;QAChB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO;YAC5B,CAAC,CAAC,IAAK,aAAsG,CACzG,GAAG,EACH,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAC7B;YACH,CAAC,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,CAAC,UAAU,GAAG,aAAa,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAElD,OAAO,IAAI,OAAO,CAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC5D,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,MAAM,MAAM,GAAG,CAAC,EAAc,EAAE,EAAE;gBAChC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,GAAG,IAAI,CAAC;oBACf,EAAE,EAAE,CAAC;gBACP,CAAC;YACH,CAAC,CAAC;YACF,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAC9B,OAAO,EACP,GAAG,EAAE;gBACH,MAAM,CAAC,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,0BAA0B,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC;YACnF,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;YACF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,OAAqB,EAAE,EAAE;gBAC3D,IAAI,KAAqB,CAAC;gBAC1B,IAAI,CAAC;oBACH,KAAK,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;gBACtD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACxE,OAAO;gBACT,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;oBACnC,MAAM,CAAC,GAAG,EAAE;wBACV,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,mBAAmB,IAAI,MAAM,CAAC,CAAC;wBAC9D,OAAO,CAAC,OAAO,CAAC,CAAC;oBACnB,CAAC,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,KAAiB,EAAE,EAAE;gBACrD,OAAO,CAAC,IAAI,CACV,IAAI,0BAA0B,CAAC,4BAA4B,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;gBACnH,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CACnC,CAAC;gBACF,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,0BAA0B,CAAC,6CAA6C,CAAC,CAAC,CAAC,CAAC;YACtG,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;gBACpC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,0BAA0B,CAAC,oCAAoC,CAAC,CAAC,CAAC,CAAC;YAC7F,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,uFAAuF;IACvF,OAAO,CAAC,OAA+B;QACrC,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC5D,IAAI,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACtD,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAA4C,CAAC,CAAC;IAClF,CAAC;IAED,oEAAoE;IACpE,IAAI;QACF,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC5D,IAAI,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACnD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,OAA4B;QAC/B,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,KAAK,GAAqB,EAAE,CAAC;QACnC,IAAI,IAAI,GAAwB,IAAI,CAAC;QACrC,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,OAAO,GAAiB,IAAI,CAAC;QACjC,IAAI,MAAmB,CAAC;QACxB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5C,MAAM,GAAG,OAAO,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,uEAAuE;QACvE,wEAAwE;QACxE,4DAA4D;QAC5D,MAAM,IAAI,GAAG;YACX,IAAI,EAAE,CAAC,KAAqB,EAAE,EAAE;gBAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClB,IAAI,EAAE,EAAE,CAAC;YACX,CAAC;YACD,IAAI,EAAE,CAAC,KAAY,EAAE,EAAE;gBACrB,OAAO,GAAG,KAAK,CAAC;gBAChB,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,EAAE,CAAC;gBACT,IAAI,EAAE,EAAE,CAAC;YACX,CAAC;YACD,GAAG,EAAE,GAAG,EAAE;gBACR,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,EAAE,CAAC;gBACT,IAAI,EAAE,EAAE,CAAC;YACX,CAAC;YACD,OAAO;SACR,CAAC;QACF,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;QAE/D,KAAK,SAAS,CAAC,CAAC,MAAM;YACpB,OAAO,IAAI,EAAE,CAAC;gBACZ,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,MAAM,KAAK,CAAC,KAAK,EAAoB,CAAC;gBAC/D,IAAI,OAAO;oBAAE,MAAM,OAAO,CAAC;gBAC3B,IAAI,QAAQ;oBAAE,OAAO;gBACrB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;oBAClC,IAAI,GAAG,OAAO,CAAC;gBACjB,CAAC,CAAC,CAAC;gBACH,IAAI,GAAG,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,SAAS,GAAG,KAAK;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3B,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QACnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QACrD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,0BAA0B,CAAC,uCAAuC,CAAC,CAAC,EACrF,SAAS,CACV,CAAC;YACF,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC1B,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK;QACH,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEO,UAAU;QAChB,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC;QACnC,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,MAAM,IAAI,yBAAyB,CAAC,yDAAyD,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,KAAqB;QACjC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACvD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,oEAAoE;YACpE,mEAAmE;YACnE,kCAAkC;YAClC,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC;gBAAE,OAAO;YACrF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACvB,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,IAAI,0BAA0B,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,IAAI,wBAAwB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YACvH,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3B,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,oCAAoC;QACvD,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,KAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACrE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,4EAA4E;QAC5E,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAClE,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;IAEO,IAAI,CAAC,KAAY,EAAE,QAAQ,GAAG,KAAK;QACzC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,QAAQ;gBAAE,IAAI,CAAC,GAAG,EAAE,CAAC;;gBACpB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF;AAED,SAAS,OAAO,CAAC,IAAa;IAC5B,IAAI,IAAI,YAAY,WAAW;QAAE,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,IAAI,YAAY,UAAU;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,KAAK;IACZ,OAAO,OAAO,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;AAC7E,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,107 @@
+import type { RealtimeTurnStream, RealtimeAvatarClient, RealtimeAvatarRequestOptions, RealtimeSessionGrant } from "./client";
+import type { AvatarTurnEventSource } from "./session-socket";
+import type { AvatarSourceKind, RealtimePrepareRequest, RealtimePrepareResponse, RealtimeTurnRequest } from "./types";
+export type AvatarSessionConfig = {
+    avatarId: string;
+    /**
+     * Direct/web-proxy callers can pin the render source; the platform API
+     * resolves it server-side from the avatar id, so only `avatarId` is required
+     * there.
+     */
+    sourceKind?: AvatarSourceKind;
+    portraitUrl?: string | null;
+    sourceVideoUrl?: string | null;
+    videoCacheId?: string | null;
+    voiceId?: string;
+    backgroundId?: string;
+    /** Defaults merged into every turn (emotion, speed, playout_delay_ms, …). */
+    turnDefaults?: Partial<RealtimeTurnRequest>;
+};
+/**
+ * What `chat()`/`speak()` return: an HTTP `RealtimeTurnStream` or a socket
+ * turn. Both expose `.events` and both play directly via `AvatarPlayer.play()`.
+ */
+export type AvatarTurnSource = RealtimeTurnStream | AvatarTurnEventSource;
+/** How the session is currently running turns. */
+export type AvatarSessionTransport = "socket" | "http";
+export type AvatarSessionConnectResult = {
+    grant: RealtimeSessionGrant;
+    prepared: RealtimePrepareResponse;
+};
+export type AvatarSessionConnectOptions = {
+    signal?: AbortSignal;
+    WebSocketImpl?: typeof WebSocket;
+    /**
+     * Called as soon as the browser-safe session grant is minted, before the
+     * socket prepare starts. Media helpers use this to preconnect WHEP while the
+     * GPU is still preparing, hiding Cloudflare SDP/ICE latency off the turn path.
+     */
+    onGrant?: (grant: RealtimeSessionGrant) => void;
+};
+/**
+ * A reusable handle for one avatar: carries the avatar id + render source so
+ * callers don't repeat them on every turn, and warms the renderer via
+ * `prepare()` — or `connect()`, which pins prepare AND every turn to one GPU
+ * container over a single WebSocket (the low-latency path) with transparent
+ * HTTP fallback when the socket drops.
+ *
+ *     const session = client.session({ avatarId });
+ *     await session.connect().catch(() => session.prepare());  // socket, else HTTP
+ *     const stream = await session.chat("who are you?");        // rides the socket when open
+ */
+export declare class AvatarSession {
+    private readonly client;
+    private readonly config;
+    private socket;
+    constructor(client: RealtimeAvatarClient, config: AvatarSessionConfig);
+    get avatarId(): string;
+    /** True while a live session socket is open; turns will ride it. */
+    get connected(): boolean;
+    /** Transport the NEXT turn will use. */
+    get transport(): AvatarSessionTransport;
+    /**
+     * Open a single-socket realtime session and prepare the avatar on it: every
+     * subsequent `chat()`/`speak()` runs on the SAME GPU container until
+     * `disconnect()`. Throws when the socket cannot be established — callers that
+     * want graceful degradation just fall back to `prepare()` (HTTP turns).
+     */
+    connect(options?: AvatarSessionConnectOptions): Promise<RealtimePrepareResponse>;
+    /**
+     * Same as `connect()`, but also exposes the session grant minted by the
+     * platform. The grant may contain an advisory media-plane plan (for example
+     * Cloudflare WHEP playback) that the browser can attach without another API call.
+     */
+    connectWithGrant(options?: AvatarSessionConnectOptions): Promise<AvatarSessionConnectResult>;
+    /** Close the session socket (if any); turns fall back to HTTP. */
+    disconnect(): void;
+    /**
+     * Stop the in-flight socket turn server-side (the GPU stops rendering frames
+     * nobody will play) while KEEPING the socket warm for the next turn. The
+     * socket is dropped only if the server never confirms. No-op on the HTTP
+     * path — abort the fetch via its `signal` instead.
+     */
+    cancel(): Promise<void>;
+    prepare(options?: RealtimeAvatarRequestOptions): Promise<RealtimePrepareResponse>;
+    /** The prepare payload this session sends — reusable over a `RealtimeSessionSocket`. */
+    prepareRequest(): RealtimePrepareRequest;
+    chat(text: string, options?: RealtimeAvatarRequestOptions & {
+        history?: RealtimeTurnRequest["messages"];
+        /** Per-turn request overrides (e.g. `source_start_frame` for seamless idle handoff). */
+        turn?: Partial<RealtimeTurnRequest>;
+    }): Promise<AvatarTurnSource>;
+    speak(text: string, options?: RealtimeAvatarRequestOptions & {
+        turn?: Partial<RealtimeTurnRequest>;
+    }): Promise<AvatarTurnSource>;
+    /** The chat turn payload — reusable over a `RealtimeSessionSocket`. */
+    chatRequest(text: string, history?: RealtimeTurnRequest["messages"]): RealtimeTurnRequest;
+    /** The speak-text turn payload — reusable over a `RealtimeSessionSocket`. */
+    speakRequest(text: string): RealtimeTurnRequest;
+    /**
+     * Run the turn on the live socket when one is open. Waits out a previous
+     * turn that is still draining its cancel (no-op when idle); a socket that
+     * fails the drain is dropped so the caller's turn falls back to HTTP.
+     */
+    private socketTurn;
+    private turnBase;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

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