@voqalize/avatar 0.0.1

package/client/dist/Avatar.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Avatar — a call-tile-ready wrapper around the widget.
+ *
+ * Thin by design: `useAvatar` does the work; this is the div it mounts into
+ * plus prop plumbing.
+ *
+ *     <Avatar client={session.client} className="avatar-tile" />
+ *
+ * The widget has no hot-swap-avatar API — `createFace` runs once per mount —
+ * so `avatar`/`theme`/`mouthGain`/`gestureGain` are read once, at mount. To
+ * switch avatars at runtime, remount with a `key` prop:
+ *
+ *     <Avatar key={name} avatar={name} client={session.client} />
+ */
+import type { CSSProperties } from "react";
+import type { UseAvatarOptions } from "./useAvatar.js";
+export interface AvatarProps extends UseAvatarOptions {
+    className?: string;
+    style?: CSSProperties;
+    /** Forwarded to the mount `<div>`. */
+    "aria-label"?: string;
+}
+export declare function Avatar({ className, style, "aria-label": ariaLabel, ...options }: AvatarProps): import("react").JSX.Element;
+//# sourceMappingURL=Avatar.d.ts.map

package/client/dist/Avatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../src/Avatar.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,EAAE,WAAW,+BAW5F"}

package/client/dist/Avatar.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useAvatar } from "./useAvatar.js";
+export function Avatar({ className, style, "aria-label": ariaLabel, ...options }) {
+    const { containerRef } = useAvatar(options);
+    return (_jsx("div", { ref: containerRef, className: className, style: style, "aria-label": ariaLabel ?? "avatar", role: "img" }));
+}
+//# sourceMappingURL=Avatar.js.map

package/client/dist/Avatar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Avatar.js","sourceRoot":"","sources":["../src/Avatar.tsx"],"names":[],"mappings":";AAiBA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAS3C,MAAM,UAAU,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,OAAO,EAAe;IAC3F,MAAM,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,CACL,cACE,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,gBACA,SAAS,IAAI,QAAQ,EACjC,IAAI,EAAC,KAAK,GACV,CACH,CAAC;AACJ,CAAC"}

package/client/dist/AvatarClient.d.ts

@@ -0,0 +1,173 @@
+/**
+ * AvatarClient — the avatar's server-message dispatcher, turn clock, and cue
+ * splice, framework-free (no React; the hook and component wrap this).
+ *
+ * ## Turn clock anchoring
+ *
+ * A turn's `t0` is anchored to `performance.now()` **at the moment this client
+ * receives the `{cmd:"speech", event:"start"}` message** — cues are
+ * client-anchored, not per-cue server-released. That message rides the RTVI
+ * data channel, ahead of the jitter-buffered audio path, so the residual error
+ * lands on the video-leads side — the side `docs/contract-protocol.md` says
+ * perceptual tolerance favours (+125 ms vs -45 ms).
+ *
+ * We investigated anchoring on pipecat client-js's own `RTVIEvent
+ * .BotStartedSpeaking`/`BotStoppedSpeaking` instead (or as a refinement) and
+ * chose not to, for two reasons:
+ *
+ *   1. **No turn correlation.** Those events carry no payload — no `ctx` — so
+ *      there is no way to tell which turn a firing belongs to. Our own
+ *      `speech` command carries `ctx`, which the splice logic below needs
+ *      regardless, so anchoring off it costs nothing extra.
+ *   2. **Same source, same path, no accuracy gain.** The `AvatarProcessor`
+ *      sits between the TTS service and the output transport and observes the
+ *      transport's own `BotStarted/StoppedSpeakingFrame` broadcasts — the exact
+ *      frame pipecat's built-in speaking detection is *also* driven from. Both
+ *      notifications travel the same data-channel path to the browser. There is
+ *      no local "truly audible now" signal cheaply available: the audio arrives
+ *      on a `MediaStreamTrack` whose only lifecycle events (`unmute`/`mute`)
+ *      fire once per call, not per utterance. Tapping the decoded remote audio
+ *      with a WebAudio `AnalyserNode` RMS gate *would* give one, but it adds
+ *      its own onset latency and a real audio pipeline to build and tune, and
+ *      it would eat into the intentional video-first safety margin rather than
+ *      improve it. Left as a documented option, not built.
+ *
+ * `attach()` still subscribes to both pipecat events, but only to report a
+ * **diagnostic** drift (`onSpeakingDrift`) between our anchor and pipecat's —
+ * useful for noticing in logs if the two ever separate by more than jitter,
+ * never used to move `t0` itself.
+ *
+ * ## Cue splice
+ *
+ * The widget has two cue-track primitives: `speak({cues, clock})` (a full
+ * replace) and `pushCues(cues)` (a pure union that can only grow the track,
+ * never shrink it). Neither is "discard queued cues at or after `from_ms`,
+ * then append" on its own — `pushCues` has no way to drop a stale tail. So
+ * this client keeps the turn's canonical cue array itself (kept portion +
+ * every appended chunk, spliced on each `cues` message) and picks the cheapest
+ * widget call that stays correct:
+ *
+ *   - if the splice's `from_ms` doesn't reach back into anything already
+ *     queued — the common case past a turn's first sentence, since only the
+ *     first sentence genuinely plays fast-leg cues — nothing needs discarding:
+ *     `pushCues(newCues)` is the cheap, correct append.
+ *   - if it does reach back (a real fast→accurate splice), `pushCues` cannot
+ *     express the discard; we call `speak()` again with the full spliced
+ *     canonical array on the turn's original clock. `speak()` is otherwise
+ *     documented as also killing an in-flight spoken interjection and
+ *     re-entering `SPEAKING` — both harmless mid-splice (an interjection
+ *     should not be running while a server track owns the mouth; re-entering
+ *     an unchanged state is a no-op past the profile/gaze reset the widget
+ *     already does for a same-name `setState`).
+ *
+ * Cues commonly arrive **before** `speech start` — the fast leg starts the
+ * moment a sentence is handed to TTS, well before `BotStartedSpeakingFrame`.
+ * Chunks that arrive before the clock is anchored are spliced into the
+ * canonical array but not yet handed to the widget; `speech start` hands over
+ * whatever has accumulated as the turn's first `speak()` call. So "the first
+ * chunk of a turn starts speak()" means the first *widget* call, not
+ * necessarily the first *message*.
+ */
+import type { PipecatClient } from "@pipecat-ai/client-js";
+import type { AvatarApi } from "../../src/avatar.js";
+import { type AvatarCommand, type AvatarCue, type AvatarHintCmd, type AvatarUnknownCmd } from "./types.js";
+export interface AvatarClientOptions {
+    /** `{cmd:"hint"}` is a no-op hook today — the widget's listening engine
+     * already handles acks; a host may still want to know a hint arrived. */
+    onHint?: (kind: string, msg: AvatarHintCmd) => void;
+    /** An unrecognized `cmd` (forward compat) — the protocol says ignore
+     * silently, so this is purely an observability hook, not required. */
+    onUnknownCmd?: (msg: AvatarUnknownCmd) => void;
+    /** A dispatch threw (e.g. an unknown state or interjection id, which the
+     * widget throws on). Defaults to `console.warn`. */
+    onError?: (err: unknown, msg: AvatarCommand) => void;
+    /** Diagnostic only (see the class doc's "Turn clock anchoring" section) —
+     * never moves the anchor, just reports how far pipecat's own
+     * botStartedSpeaking/botStoppedSpeaking landed from it. */
+    onSpeakingDrift?: (info: {
+        event: "start" | "stop";
+        ctx: string | null;
+        driftMs: number;
+    }) => void;
+    /**
+     * Which server-messages `attach()` should look inside. Defaults to the
+     * protocol's own envelope, `type === "avatar"`.
+     *
+     * The escape hatch exists because an application may tunnel avatar commands
+     * inside a message type of its own — one deployment routes them through a
+     * generic `ui_command` envelope so an LLM tool call can drive the face — and
+     * teaching this library that envelope would be teaching it one consumer's
+     * private vocabulary. Widen it here instead:
+     *
+     *     accept: (m) => m.type === "avatar" ||
+     *                    (m.type === "ui_command" && m.action === "avatar")
+     *
+     * The predicate only decides *whether to look*; the payload still has to
+     * carry a string `cmd` to dispatch at all.
+     */
+    accept?: (message: Record<string, unknown>) => boolean;
+    /** Override for tests. Defaults to `performance.now`. */
+    now?: () => number;
+}
+/**
+ * The three `RTVIEvent` members `attach()` subscribes to, spelled as their
+ * values.
+ *
+ * Written out rather than imported because that enum was this module's *only*
+ * runtime reference to `@pipecat-ai/client-js`, and one runtime reference makes
+ * the whole `/pipecat` subpath fail to load without the peer installed — even
+ * for a host that drives `dispatch()` from its own transport and never calls
+ * `attach()`. The peer is declared optional; this is what makes that true
+ * rather than aspirational.
+ *
+ * String enums are nominal in TypeScript, so the compiler cannot check these
+ * against the real ones from a type-only import. `client/test/AvatarClient.test.ts`
+ * does it instead, against the actual enum — the devDependency is present
+ * exactly where the check belongs and absent from what we ship.
+ */
+export declare const RTVI_EVENTS: {
+    readonly serverMessage: "serverMessage";
+    readonly botStartedSpeaking: "botStartedSpeaking";
+    readonly botStoppedSpeaking: "botStoppedSpeaking";
+};
+export declare class AvatarClient {
+    private readonly avatar;
+    private readonly opts;
+    private readonly now;
+    private readonly accept;
+    private turn;
+    constructor(avatar: AvatarApi, opts?: AvatarClientOptions);
+    /** The active turn's ctx, or `null` between turns. For tests and telemetry. */
+    get turnCtx(): string | null;
+    /** The active turn's canonical (already-spliced) cue track. For tests and telemetry. */
+    get turnCues(): AvatarCue[];
+    /** Dispatch one avatar command. Accepts anything with a string `cmd` — an
+     * already-unwrapped `{type:"avatar", cmd, ...}` server message, or a bare
+     * `{cmd, ...}` payload from whatever else the host is carrying them in.
+     * Unknown `cmd`s are ignored, per the wire protocol's forward-compat rule. */
+    dispatch(raw: unknown): void;
+    private handleState;
+    private handlePerform;
+    /** Ride the named turn's clock if it's the one we're currently anchored to;
+     * otherwise (no active turn, or `perform` names a ctx we never saw a
+     * `speech start` for) fall back to a fresh clock anchored at this call — the
+     * same "elapsed ms since this call" default `avatar.perform()` itself uses
+     * when given no clock and no audio. */
+    private resolveClock;
+    private ensureTurn;
+    private handleCues;
+    private handleSpeech;
+    private reportDrift;
+    /**
+     * Subscribe to a live `PipecatClient`'s server messages and dispatch the
+     * avatar commands among them. Which messages count is the `accept` option;
+     * by default, the protocol's own `{type:"avatar"}` envelope.
+     *
+     * Also wires the diagnostic drift cross-check described in the class doc.
+     * Never throws on a malformed or irrelevant message.
+     *
+     * @returns an unsubscribe function; call it on unmount or disconnect.
+     */
+    attach(client: PipecatClient): () => void;
+}
+//# sourceMappingURL=AvatarClient.d.ts.map

package/client/dist/AvatarClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AvatarClient.d.ts","sourceRoot":"","sources":["../src/AvatarClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,SAAS,EAEd,KAAK,aAAa,EAIlB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAYpB,MAAM,WAAW,mBAAmB;IAClC;6EACyE;IACzE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IACpD;0EACsE;IACtE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC/C;wDACoD;IACpD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IACrD;;+DAE2D;IAC3D,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACnG;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IACvD,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW;;;;CAImB,CAAC;AAU5C,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgD;IACvE,OAAO,CAAC,IAAI,CAAqB;gBAErB,MAAM,EAAE,SAAS,EAAE,IAAI,GAAE,mBAAwB;IAO7D,+EAA+E;IAC/E,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAE3B;IAED,wFAAwF;IACxF,IAAI,QAAQ,IAAI,SAAS,EAAE,CAE1B;IAED;;;kFAG8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAsC5B,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,aAAa;IAIrB;;;;2CAIuC;IACvC,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,WAAW;IAOnB;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,IAAI;CAuB1C"}

package/client/dist/AvatarClient.js

@@ -0,0 +1,274 @@
+/**
+ * AvatarClient — the avatar's server-message dispatcher, turn clock, and cue
+ * splice, framework-free (no React; the hook and component wrap this).
+ *
+ * ## Turn clock anchoring
+ *
+ * A turn's `t0` is anchored to `performance.now()` **at the moment this client
+ * receives the `{cmd:"speech", event:"start"}` message** — cues are
+ * client-anchored, not per-cue server-released. That message rides the RTVI
+ * data channel, ahead of the jitter-buffered audio path, so the residual error
+ * lands on the video-leads side — the side `docs/contract-protocol.md` says
+ * perceptual tolerance favours (+125 ms vs -45 ms).
+ *
+ * We investigated anchoring on pipecat client-js's own `RTVIEvent
+ * .BotStartedSpeaking`/`BotStoppedSpeaking` instead (or as a refinement) and
+ * chose not to, for two reasons:
+ *
+ *   1. **No turn correlation.** Those events carry no payload — no `ctx` — so
+ *      there is no way to tell which turn a firing belongs to. Our own
+ *      `speech` command carries `ctx`, which the splice logic below needs
+ *      regardless, so anchoring off it costs nothing extra.
+ *   2. **Same source, same path, no accuracy gain.** The `AvatarProcessor`
+ *      sits between the TTS service and the output transport and observes the
+ *      transport's own `BotStarted/StoppedSpeakingFrame` broadcasts — the exact
+ *      frame pipecat's built-in speaking detection is *also* driven from. Both
+ *      notifications travel the same data-channel path to the browser. There is
+ *      no local "truly audible now" signal cheaply available: the audio arrives
+ *      on a `MediaStreamTrack` whose only lifecycle events (`unmute`/`mute`)
+ *      fire once per call, not per utterance. Tapping the decoded remote audio
+ *      with a WebAudio `AnalyserNode` RMS gate *would* give one, but it adds
+ *      its own onset latency and a real audio pipeline to build and tune, and
+ *      it would eat into the intentional video-first safety margin rather than
+ *      improve it. Left as a documented option, not built.
+ *
+ * `attach()` still subscribes to both pipecat events, but only to report a
+ * **diagnostic** drift (`onSpeakingDrift`) between our anchor and pipecat's —
+ * useful for noticing in logs if the two ever separate by more than jitter,
+ * never used to move `t0` itself.
+ *
+ * ## Cue splice
+ *
+ * The widget has two cue-track primitives: `speak({cues, clock})` (a full
+ * replace) and `pushCues(cues)` (a pure union that can only grow the track,
+ * never shrink it). Neither is "discard queued cues at or after `from_ms`,
+ * then append" on its own — `pushCues` has no way to drop a stale tail. So
+ * this client keeps the turn's canonical cue array itself (kept portion +
+ * every appended chunk, spliced on each `cues` message) and picks the cheapest
+ * widget call that stays correct:
+ *
+ *   - if the splice's `from_ms` doesn't reach back into anything already
+ *     queued — the common case past a turn's first sentence, since only the
+ *     first sentence genuinely plays fast-leg cues — nothing needs discarding:
+ *     `pushCues(newCues)` is the cheap, correct append.
+ *   - if it does reach back (a real fast→accurate splice), `pushCues` cannot
+ *     express the discard; we call `speak()` again with the full spliced
+ *     canonical array on the turn's original clock. `speak()` is otherwise
+ *     documented as also killing an in-flight spoken interjection and
+ *     re-entering `SPEAKING` — both harmless mid-splice (an interjection
+ *     should not be running while a server track owns the mouth; re-entering
+ *     an unchanged state is a no-op past the profile/gaze reset the widget
+ *     already does for a same-name `setState`).
+ *
+ * Cues commonly arrive **before** `speech start` — the fast leg starts the
+ * moment a sentence is handed to TTS, well before `BotStartedSpeakingFrame`.
+ * Chunks that arrive before the clock is anchored are spliced into the
+ * canonical array but not yet handed to the widget; `speech start` hands over
+ * whatever has accumulated as the turn's first `speak()` call. So "the first
+ * chunk of a turn starts speak()" means the first *widget* call, not
+ * necessarily the first *message*.
+ */
+import { AVATAR_MESSAGE_TYPE, isAvatarMessage, } from "./types.js";
+/**
+ * The three `RTVIEvent` members `attach()` subscribes to, spelled as their
+ * values.
+ *
+ * Written out rather than imported because that enum was this module's *only*
+ * runtime reference to `@pipecat-ai/client-js`, and one runtime reference makes
+ * the whole `/pipecat` subpath fail to load without the peer installed — even
+ * for a host that drives `dispatch()` from its own transport and never calls
+ * `attach()`. The peer is declared optional; this is what makes that true
+ * rather than aspirational.
+ *
+ * String enums are nominal in TypeScript, so the compiler cannot check these
+ * against the real ones from a type-only import. `client/test/AvatarClient.test.ts`
+ * does it instead, against the actual enum — the devDependency is present
+ * exactly where the check belongs and absent from what we ship.
+ */
+export const RTVI_EVENTS = {
+    serverMessage: "serverMessage",
+    botStartedSpeaking: "botStartedSpeaking",
+    botStoppedSpeaking: "botStoppedSpeaking",
+};
+/** Defensive unwrap for the `RTVIEvent.ServerMessage` `{ data }` quirk: some
+ * transports deliver the payload directly and some wrap it once more. */
+function unwrapServerMessage(raw) {
+    const obj = (raw ?? {});
+    const inner = obj["data"];
+    return inner && "type" in inner ? inner : obj;
+}
+export class AvatarClient {
+    avatar;
+    opts;
+    now;
+    accept;
+    turn = null;
+    constructor(avatar, opts = {}) {
+        this.avatar = avatar;
+        this.opts = opts;
+        this.now = opts.now ?? (() => performance.now());
+        this.accept = opts.accept ?? ((m) => m.type === AVATAR_MESSAGE_TYPE);
+    }
+    /** The active turn's ctx, or `null` between turns. For tests and telemetry. */
+    get turnCtx() {
+        return this.turn?.ctx ?? null;
+    }
+    /** The active turn's canonical (already-spliced) cue track. For tests and telemetry. */
+    get turnCues() {
+        return this.turn ? [...this.turn.cues] : [];
+    }
+    /** Dispatch one avatar command. Accepts anything with a string `cmd` — an
+     * already-unwrapped `{type:"avatar", cmd, ...}` server message, or a bare
+     * `{cmd, ...}` payload from whatever else the host is carrying them in.
+     * Unknown `cmd`s are ignored, per the wire protocol's forward-compat rule. */
+    dispatch(raw) {
+        if (!isAvatarMessage(raw))
+            return;
+        const msg = raw;
+        try {
+            switch (msg.cmd) {
+                case "state":
+                    this.handleState(msg);
+                    break;
+                case "interject":
+                    this.avatar.interject(msg.id);
+                    break;
+                case "perform":
+                    this.handlePerform(msg);
+                    break;
+                case "cues":
+                    this.handleCues(msg);
+                    break;
+                case "speech":
+                    this.handleSpeech(msg);
+                    break;
+                case "user":
+                    this.avatar.setUserSpeaking(msg.speaking);
+                    break;
+                case "hint": {
+                    const hint = msg;
+                    this.opts.onHint?.(hint.kind, hint);
+                    break;
+                }
+                default:
+                    this.opts.onUnknownCmd?.(msg);
+                    break;
+            }
+        }
+        catch (err) {
+            if (this.opts.onError)
+                this.opts.onError(err, msg);
+            else
+                console.warn("[avatar] dispatch failed", msg, err);
+        }
+    }
+    handleState(msg) {
+        // Deliberately no client-side dedup: pass every `state` command straight
+        // through. The widget's own setState already no-ops the parts that matter
+        // for an unchanged name (`changed` gates the blink and the 'state' event in
+        // avatar.js), and a server resending the same state name as a
+        // keepalive/resync must still land so an `emotion`/`gaze` override on this
+        // particular message takes effect.
+        this.avatar.setState(msg.name, { emotion: msg.emotion, gaze: msg.gaze });
+    }
+    handlePerform(msg) {
+        this.avatar.perform(msg.actions, { clock: this.resolveClock(msg.ctx) });
+    }
+    /** Ride the named turn's clock if it's the one we're currently anchored to;
+     * otherwise (no active turn, or `perform` names a ctx we never saw a
+     * `speech start` for) fall back to a fresh clock anchored at this call — the
+     * same "elapsed ms since this call" default `avatar.perform()` itself uses
+     * when given no clock and no audio. */
+    resolveClock(ctx) {
+        if (ctx && this.turn && this.turn.ctx === ctx && this.turn.clock) {
+            return this.turn.clock;
+        }
+        const start = this.now();
+        return () => this.now() - start;
+    }
+    ensureTurn(ctx) {
+        if (!this.turn || this.turn.ctx !== ctx) {
+            // A different ctx supersedes whatever turn we had — a stale trailing
+            // message for the old ctx will find `this.turn.ctx !== ctx` in
+            // handleSpeech's stop-guard and be ignored, rather than cutting off the
+            // new turn.
+            this.turn = { ctx, cues: [], started: false, clock: null, t0: null };
+        }
+        return this.turn;
+    }
+    handleCues(msg) {
+        const turn = this.ensureTurn(msg.ctx);
+        const kept = turn.cues.filter((c) => c.t < msg.from_ms);
+        const discarded = turn.cues.length - kept.length;
+        turn.cues = [...kept, ...msg.cues].sort((a, b) => a.t - b.t);
+        if (!turn.started) {
+            // No clock yet — buffer. `speech start` will hand this over as the turn's
+            // first speak() call.
+            return;
+        }
+        if (discarded === 0) {
+            this.avatar.pushCues(msg.cues);
+        }
+        else {
+            this.avatar.speak({ cues: turn.cues, clock: turn.clock });
+        }
+    }
+    handleSpeech(msg) {
+        if (msg.event === "start") {
+            const turn = this.ensureTurn(msg.ctx);
+            const t0 = this.now();
+            const clock = () => this.now() - t0;
+            turn.t0 = t0;
+            turn.clock = clock;
+            turn.started = true;
+            this.avatar.speak({ cues: turn.cues, clock });
+            return;
+        }
+        // "stop": only act if it names the turn we're actually riding. A stale stop
+        // for an already-superseded ctx must not cut off a newer turn.
+        if (this.turn && this.turn.ctx === msg.ctx) {
+            this.avatar.stopSpeaking();
+            this.turn = null;
+        }
+    }
+    reportDrift(event) {
+        if (!this.opts.onSpeakingDrift)
+            return;
+        const t0 = this.turn?.t0;
+        if (t0 == null)
+            return;
+        this.opts.onSpeakingDrift({ event, ctx: this.turn?.ctx ?? null, driftMs: this.now() - t0 });
+    }
+    /**
+     * Subscribe to a live `PipecatClient`'s server messages and dispatch the
+     * avatar commands among them. Which messages count is the `accept` option;
+     * by default, the protocol's own `{type:"avatar"}` envelope.
+     *
+     * Also wires the diagnostic drift cross-check described in the class doc.
+     * Never throws on a malformed or irrelevant message.
+     *
+     * @returns an unsubscribe function; call it on unmount or disconnect.
+     */
+    attach(client) {
+        const onServerMessage = (raw) => {
+            const message = unwrapServerMessage(raw);
+            if (!this.accept(message))
+                return;
+            this.dispatch(message);
+        };
+        const onBotStartedSpeaking = () => this.reportDrift("start");
+        const onBotStoppedSpeaking = () => this.reportDrift("stop");
+        const serverMessage = RTVI_EVENTS.serverMessage;
+        const started = RTVI_EVENTS.botStartedSpeaking;
+        const stopped = RTVI_EVENTS.botStoppedSpeaking;
+        client.on(serverMessage, onServerMessage);
+        client.on(started, onBotStartedSpeaking);
+        client.on(stopped, onBotStoppedSpeaking);
+        return () => {
+            client.off(serverMessage, onServerMessage);
+            client.off(started, onBotStartedSpeaking);
+            client.off(stopped, onBotStoppedSpeaking);
+        };
+    }
+}
+//# sourceMappingURL=AvatarClient.js.map

package/client/dist/AvatarClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AvatarClient.js","sourceRoot":"","sources":["../src/AvatarClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AAIH,OAAO,EACL,mBAAmB,EACnB,eAAe,GAShB,MAAM,YAAY,CAAC;AA+CpB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,aAAa,EAAE,eAAe;IAC9B,kBAAkB,EAAE,oBAAoB;IACxC,kBAAkB,EAAE,oBAAoB;CACC,CAAC;AAE5C;yEACyE;AACzE,SAAS,mBAAmB,CAAC,GAAY;IACvC,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,CAA4B,CAAC;IACnD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAwC,CAAC;IACjE,OAAO,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;AAChD,CAAC;AAED,MAAM,OAAO,YAAY;IACN,MAAM,CAAY;IAClB,IAAI,CAAsB;IAC1B,GAAG,CAAe;IAClB,MAAM,CAAgD;IAC/D,IAAI,GAAgB,IAAI,CAAC;IAEjC,YAAY,MAAiB,EAAE,OAA4B,EAAE;QAC3D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC;IACvE,CAAC;IAED,+EAA+E;IAC/E,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;IAChC,CAAC;IAED,wFAAwF;IACxF,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED;;;kFAG8E;IAC9E,QAAQ,CAAC,GAAY;QACnB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;YAAE,OAAO;QAClC,MAAM,GAAG,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC;YACH,QAAQ,GAAG,CAAC,GAAG,EAAE,CAAC;gBAChB,KAAK,OAAO;oBACV,IAAI,CAAC,WAAW,CAAC,GAAqB,CAAC,CAAC;oBACxC,MAAM;gBACR,KAAK,WAAW;oBACd,IAAI,CAAC,MAAM,CAAC,SAAS,CAAE,GAAsB,CAAC,EAAE,CAAC,CAAC;oBAClD,MAAM;gBACR,KAAK,SAAS;oBACZ,IAAI,CAAC,aAAa,CAAC,GAAuB,CAAC,CAAC;oBAC5C,MAAM;gBACR,KAAK,MAAM;oBACT,IAAI,CAAC,UAAU,CAAC,GAAoB,CAAC,CAAC;oBACtC,MAAM;gBACR,KAAK,QAAQ;oBACX,IAAI,CAAC,YAAY,CAAC,GAAsB,CAAC,CAAC;oBAC1C,MAAM;gBACR,KAAK,MAAM;oBACT,IAAI,CAAC,MAAM,CAAC,eAAe,CAAE,GAA6B,CAAC,QAAQ,CAAC,CAAC;oBACrE,MAAM;gBACR,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,MAAM,IAAI,GAAG,GAAoB,CAAC;oBAClC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBACpC,MAAM;gBACR,CAAC;gBACD;oBACE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,GAAuB,CAAC,CAAC;oBAClD,MAAM;YACV,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;;gBAC9C,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,GAAmB;QACrC,yEAAyE;QACzE,0EAA0E;QAC1E,4EAA4E;QAC5E,8DAA8D;QAC9D,2EAA2E;QAC3E,mCAAmC;QACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IAEO,aAAa,CAAC,GAAqB;QACzC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;;;2CAIuC;IAC/B,YAAY,CAAC,GAAuB;QAC1C,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACjE,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QACzB,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IAClC,CAAC;IAEO,UAAU,CAAC,GAAW;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;YACxC,qEAAqE;YACrE,+DAA+D;YAC/D,wEAAwE;YACxE,YAAY;YACZ,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QACvE,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAEO,UAAU,CAAC,GAAkB;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAE7D,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,0EAA0E;YAC1E,sBAAsB;YACtB,OAAO;QACT,CAAC;QACD,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAM,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,GAAoB;QACvC,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;YACpC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACnB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,4EAA4E;QAC5E,+DAA+D;QAC/D,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,EAAE,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,KAAuB;QACzC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,OAAO;QACvC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACzB,IAAI,EAAE,IAAI,IAAI;YAAE,OAAO;QACvB,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAqB;QAC1B,MAAM,eAAe,GAAG,CAAC,GAAY,EAAE,EAAE;YACvC,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;gBAAE,OAAO;YAClC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC,CAAC;QACF,MAAM,oBAAoB,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC7D,MAAM,oBAAoB,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAE5D,MAAM,aAAa,GAAG,WAAW,CAAC,aAA0B,CAAC;QAC7D,MAAM,OAAO,GAAG,WAAW,CAAC,kBAA+B,CAAC;QAC5D,MAAM,OAAO,GAAG,WAAW,CAAC,kBAA+B,CAAC;QAE5D,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;QAC1C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;QACzC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;QAEzC,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;YAC3C,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;YAC1C,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;QAC5C,CAAC,CAAC;IACJ,CAAC;CACF"}

package/client/dist/pipecat.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `@voqalize/avatar/pipecat` — drive the widget from a pipecat session.
+ *
+ * Framework-free: everything here is plain TypeScript over the `AvatarApi` the
+ * root export returns. `AvatarClient` is the whole surface — construct it
+ * around a mounted widget and either `attach()` it to a live `PipecatClient`
+ * or feed it messages yourself with `dispatch()`.
+ *
+ *     import { createAvatar } from "@voqalize/avatar";
+ *     import { AvatarClient } from "@voqalize/avatar/pipecat";
+ *
+ *     const avatar = createAvatar({ mount: "#tile" });
+ *     const detach = new AvatarClient(avatar).attach(pipecatClient);
+ *
+ * `@pipecat-ai/client-js` is a peer dependency of this subpath only — the root
+ * export has no dependencies at all, and a host that carries avatar commands
+ * over its own transport can import this module and never call `attach()`.
+ */
+export { AvatarClient, type AvatarClientOptions } from "./AvatarClient.js";
+export { isAvatarMessage, AVATAR_MESSAGE_TYPE, AVATAR_PROTOCOL_VERSION, type AvatarCommand, type AvatarCue, type AvatarCuesCmd, type AvatarHintCmd, type AvatarInterjectCmd, type AvatarPerformAction, type AvatarPerformCmd, type AvatarServerMessage, type AvatarSpeechCmd, type AvatarStateCmd, type AvatarUnknownCmd, type AvatarUserCmd, } from "./types.js";
+//# sourceMappingURL=pipecat.d.ts.map

package/client/dist/pipecat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipecat.d.ts","sourceRoot":"","sources":["../src/pipecat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE3E,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC"}

package/client/dist/pipecat.js

@@ -0,0 +1,21 @@
+/**
+ * `@voqalize/avatar/pipecat` — drive the widget from a pipecat session.
+ *
+ * Framework-free: everything here is plain TypeScript over the `AvatarApi` the
+ * root export returns. `AvatarClient` is the whole surface — construct it
+ * around a mounted widget and either `attach()` it to a live `PipecatClient`
+ * or feed it messages yourself with `dispatch()`.
+ *
+ *     import { createAvatar } from "@voqalize/avatar";
+ *     import { AvatarClient } from "@voqalize/avatar/pipecat";
+ *
+ *     const avatar = createAvatar({ mount: "#tile" });
+ *     const detach = new AvatarClient(avatar).attach(pipecatClient);
+ *
+ * `@pipecat-ai/client-js` is a peer dependency of this subpath only — the root
+ * export has no dependencies at all, and a host that carries avatar commands
+ * over its own transport can import this module and never call `attach()`.
+ */
+export { AvatarClient } from "./AvatarClient.js";
+export { isAvatarMessage, AVATAR_MESSAGE_TYPE, AVATAR_PROTOCOL_VERSION, } from "./types.js";
+//# sourceMappingURL=pipecat.js.map

package/client/dist/pipecat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipecat.js","sourceRoot":"","sources":["../src/pipecat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,YAAY,EAA4B,MAAM,mBAAmB,CAAC;AAE3E,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,uBAAuB,GAaxB,MAAM,YAAY,CAAC"}

package/client/dist/react.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `@voqalize/avatar/react` — the React binding.
+ *
+ *     import { Avatar } from "@voqalize/avatar/react";
+ *
+ *     <Avatar client={pipecatClient} className="tile" />
+ *
+ * Peers: `react >= 18` and `@pipecat-ai/client-js`. Everything a non-React
+ * host needs is in `@voqalize/avatar/pipecat`; this module adds a mount
+ * lifecycle and nothing else.
+ */
+export { useAvatar, type UseAvatarHandle, type UseAvatarOptions } from "./useAvatar.js";
+export { Avatar, type AvatarProps } from "./Avatar.js";
+export { AvatarClient, type AvatarClientOptions } from "./AvatarClient.js";
+export { isAvatarMessage, AVATAR_MESSAGE_TYPE, AVATAR_PROTOCOL_VERSION, type AvatarCommand, type AvatarCue, type AvatarCuesCmd, type AvatarHintCmd, type AvatarInterjectCmd, type AvatarPerformAction, type AvatarPerformCmd, type AvatarServerMessage, type AvatarSpeechCmd, type AvatarStateCmd, type AvatarUnknownCmd, type AvatarUserCmd, } from "./types.js";
+//# sourceMappingURL=react.d.ts.map

package/client/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC"}

package/client/dist/react.js

@@ -0,0 +1,17 @@
+/**
+ * `@voqalize/avatar/react` — the React binding.
+ *
+ *     import { Avatar } from "@voqalize/avatar/react";
+ *
+ *     <Avatar client={pipecatClient} className="tile" />
+ *
+ * Peers: `react >= 18` and `@pipecat-ai/client-js`. Everything a non-React
+ * host needs is in `@voqalize/avatar/pipecat`; this module adds a mount
+ * lifecycle and nothing else.
+ */
+export { useAvatar } from "./useAvatar.js";
+export { Avatar } from "./Avatar.js";
+// Re-exported so a React consumer needs one import for the common case.
+export { AvatarClient } from "./AvatarClient.js";
+export { isAvatarMessage, AVATAR_MESSAGE_TYPE, AVATAR_PROTOCOL_VERSION, } from "./types.js";
+//# sourceMappingURL=react.js.map

package/client/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAA+C,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAAE,MAAM,EAAoB,MAAM,aAAa,CAAC;AAEvD,wEAAwE;AACxE,OAAO,EAAE,YAAY,EAA4B,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,uBAAuB,GAaxB,MAAM,YAAY,CAAC"}