@voqalize/avatar 0.2.2 → 0.3.0

package/dist/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * types.ts — the avatar wire vocabulary, client side.
+ *
+ * The binding definition is `docs/contract-wire.md`; this file is its
+ * TypeScript restatement and must not drift from it. The Python half of the
+ * same vocabulary is `packages/avatar-py/src/voqalize_avatar/messages.py` — the three are
+ * maintained together, and a command added to one without the others is
+ * incomplete.
+ *
+ * A server pushes these as RTVI `server-message`s under the envelope
+ * `{ type: "avatar", ...cmd-specific fields }`. {@link AvatarCommand} describes
+ * what rides inside that envelope; {@link isAvatarMessage} is the envelope
+ * itself, and is the only definition of "this message is for the avatar" the
+ * client has. There is no protocol version field — an unknown `cmd` is simply
+ * ignored, which is the whole forward-compatibility rule.
+ */
+import type { AvatarActionId, VisemeLetter } from "../src/avatar.js";
+/** A viseme cue: `t` is a ms offset into the utterance's clock, `v` is a Rhubarb A–H (or X) letter. */
+export interface AvatarCue {
+    t: number;
+    v: VisemeLetter;
+    /** 0..1 loudness. Absent means full. */
+    i?: number;
+}
+/** A durable, lower-priority server claim. `null` explicitly clears it. */
+export interface AvatarClaimCmd {
+    cmd: "claim";
+    state: "STRAINING" | "THINKING" | "WORKING" | null;
+}
+/** A self-completing authored sequence: face, body, and optionally a hand. */
+export interface AvatarActionCmd {
+    cmd: "action";
+    id: AvatarActionId;
+}
+export interface AvatarCuesCmd {
+    cmd: "cues";
+    ctx: string;
+    /** Discard queued cues at or after this offset (ms), then append `cues`. */
+    from_ms: number;
+    cues: AvatarCue[];
+    /**
+     * True on the one chunk that completes this turn's track: the TTS context is
+     * closed, so no further chunk will splice into `ctx`. What a client may
+     * assume, exactly — nothing about playout. The audio it describes is still
+     * ahead, and Pipecat's `botStoppedSpeaking` remains the end of the turn. It
+     * is safe to stop expecting more cue chunks after `final`.
+     *
+     * Absent on an interrupted turn, deliberately: a turn that was cut never
+     * claims to have completed. Absent chunks are the normal case — the widget's
+     * own track already completes on the trailing `X`, so ignoring `final`
+     * entirely is a correct implementation.
+     */
+    final?: boolean;
+}
+export type AvatarCommand = AvatarClaimCmd | AvatarActionCmd | AvatarCuesCmd;
+/** The full server-message payload: the envelope plus its command. */
+export type AvatarServerMessage = AvatarCommand & {
+    type: "avatar";
+};
+/** An envelope addressed to the avatar, before its payload has been read. */
+export type AvatarEnvelope = {
+    type: "avatar";
+    cmd: string;
+} & Record<string, unknown>;
+/**
+ * Is this server-message payload the avatar's? The envelope is the whole
+ * answer: `{type:"avatar"}` with a string `cmd`. It used to be a per-deployment
+ * `accept` predicate on the client, which meant the library could not state
+ * what an avatar message *is*.
+ *
+ * Addressed to us is not the same as understood by us: {@link parseAvatarCommand}
+ * is the second half.
+ */
+export declare function isAvatarMessage(msg: unknown): msg is AvatarEnvelope;
+/**
+ * Read an envelope's payload into the wire vocabulary, or `null` if this build
+ * cannot act on it — an unknown `cmd`, an id or claim outside the enum, a
+ * malformed `cues` chunk.
+ *
+ * `null` is the forward-compat rule with a type attached: a newer server
+ * talking to an older widget is *expected*, and the older widget ignores what
+ * it does not know rather than guessing. Doing the check here rather than at
+ * each use site is what lets the wire types be closed unions instead of
+ * `string` — the boundary is one function, so it can be the only place that
+ * has to be honest about untrusted input.
+ *
+ * Cues survive individually: one unrecognised letter in a chunk drops that cue,
+ * not the utterance around it. Losing a frame of articulation is a far smaller
+ * regression than losing a sentence of it.
+ */
+export declare function parseAvatarCommand(msg: AvatarEnvelope): AvatarCommand | null;
+/** The envelope `type` the protocol reserves for avatar traffic. */
+export declare const AVATAR_MESSAGE_TYPE = "avatar";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../client/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErE,uGAAuG;AACvG,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,YAAY,CAAC;IAChB,wCAAwC;IACxC,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC;CACpD;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,QAAQ,CAAC;IACd,EAAE,EAAE,cAAc,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,eAAe,GACf,aAAa,CAAC;AAElB,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAErE,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvF;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CAInE;AAKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,aAAa,GAAG,IAAI,CAoC5E;AAED,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,WAAW,CAAC"}

package/dist/types.js

@@ -0,0 +1,93 @@
+/**
+ * types.ts — the avatar wire vocabulary, client side.
+ *
+ * The binding definition is `docs/contract-wire.md`; this file is its
+ * TypeScript restatement and must not drift from it. The Python half of the
+ * same vocabulary is `packages/avatar-py/src/voqalize_avatar/messages.py` — the three are
+ * maintained together, and a command added to one without the others is
+ * incomplete.
+ *
+ * A server pushes these as RTVI `server-message`s under the envelope
+ * `{ type: "avatar", ...cmd-specific fields }`. {@link AvatarCommand} describes
+ * what rides inside that envelope; {@link isAvatarMessage} is the envelope
+ * itself, and is the only definition of "this message is for the avatar" the
+ * client has. There is no protocol version field — an unknown `cmd` is simply
+ * ignored, which is the whole forward-compatibility rule.
+ */
+import { ACTION_IDS, VISEME_LETTERS } from "../src/avatar.js";
+/**
+ * Is this server-message payload the avatar's? The envelope is the whole
+ * answer: `{type:"avatar"}` with a string `cmd`. It used to be a per-deployment
+ * `accept` predicate on the client, which meant the library could not state
+ * what an avatar message *is*.
+ *
+ * Addressed to us is not the same as understood by us: {@link parseAvatarCommand}
+ * is the second half.
+ */
+export function isAvatarMessage(msg) {
+    if (typeof msg !== "object" || msg === null)
+        return false;
+    const m = msg;
+    return m.type === AVATAR_MESSAGE_TYPE && typeof m.cmd === "string";
+}
+const ACTIONS = new Set(ACTION_IDS);
+const LETTERS = new Set(VISEME_LETTERS);
+/**
+ * Read an envelope's payload into the wire vocabulary, or `null` if this build
+ * cannot act on it — an unknown `cmd`, an id or claim outside the enum, a
+ * malformed `cues` chunk.
+ *
+ * `null` is the forward-compat rule with a type attached: a newer server
+ * talking to an older widget is *expected*, and the older widget ignores what
+ * it does not know rather than guessing. Doing the check here rather than at
+ * each use site is what lets the wire types be closed unions instead of
+ * `string` — the boundary is one function, so it can be the only place that
+ * has to be honest about untrusted input.
+ *
+ * Cues survive individually: one unrecognised letter in a chunk drops that cue,
+ * not the utterance around it. Losing a frame of articulation is a far smaller
+ * regression than losing a sentence of it.
+ */
+export function parseAvatarCommand(msg) {
+    switch (msg.cmd) {
+        case "claim": {
+            const state = msg.state;
+            if (state === null || state === "STRAINING" || state === "THINKING" || state === "WORKING") {
+                return { cmd: "claim", state };
+            }
+            return null;
+        }
+        case "action":
+            return typeof msg.id === "string" && ACTIONS.has(msg.id)
+                ? { cmd: "action", id: msg.id }
+                : null;
+        case "cues": {
+            if (typeof msg.ctx !== "string" || !Number.isFinite(msg.from_ms) || !Array.isArray(msg.cues)) {
+                return null;
+            }
+            const cues = [];
+            for (const c of msg.cues) {
+                if (typeof c !== "object" || c === null)
+                    continue;
+                const { t, v, i } = c;
+                if (typeof t !== "number" || !Number.isFinite(t))
+                    continue;
+                if (typeof v !== "string" || !LETTERS.has(v))
+                    continue;
+                cues.push(typeof i === "number" ? { t, v: v, i } : { t, v: v });
+            }
+            return {
+                cmd: "cues",
+                ctx: msg.ctx,
+                from_ms: msg.from_ms,
+                cues,
+                ...(msg.final === true ? { final: true } : {}),
+            };
+        }
+        default:
+            return null;
+    }
+}
+/** The envelope `type` the protocol reserves for avatar traffic. */
+export const AVATAR_MESSAGE_TYPE = "avatar";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/useAvatar.d.ts

@@ -0,0 +1,39 @@
+/**
+ * useAvatar — mount an avatar into a ref'd element for as long as there is a
+ * client to embody, and tear it down after.
+ *
+ * Internal; `<Avatar>` is the only thing the React entry exports. The whole
+ * hook is one effect, because the factory takes the client at construction:
+ * there is no separate attach step to keep in its own lifecycle any more.
+ */
+import type { PipecatClient } from "@pipecat-ai/client-js";
+import { type AvatarFactory, type AvatarOptions, type SvgAvatarOptions } from "./createAvatar.js";
+export interface UseAvatarOptions<O extends AvatarOptions = SvgAvatarOptions> {
+    /** The live `PipecatClient`, or `null` before connect. Nothing mounts until
+     * this is non-null — an avatar with nothing to embody has nothing to do. */
+    client?: PipecatClient | null;
+    /** The avatar implementation. Defaults to the bundled SVG faces. */
+    create?: AvatarFactory<O>;
+    /** Implementation options, forwarded verbatim. Read at mount only. */
+    options?: Omit<O, keyof AvatarOptions>;
+}
+/**
+ * The mount ref's type, written out rather than named as React's `RefObject`.
+ *
+ * React 18 and 19 declare that alias with different type arguments — 18's
+ * `useRef<T>(null)` yields `RefObject<T>`, 19's yields `RefObject<T | null>` —
+ * and because both are the *same alias*, TypeScript compares them by variance
+ * and rejects whichever one we didn't pick. An anonymous shape forces a
+ * structural comparison instead, which both versions satisfy, and which the
+ * `ref` prop accepts on both. This is the only place the 18-vs-19 split shows
+ * up in the binding; keep it that way.
+ */
+export type AvatarMountRef = {
+    current: HTMLDivElement | null;
+};
+export interface UseAvatarHandle {
+    /** Attach to the mount element: `<div ref={containerRef} />`. */
+    containerRef: AvatarMountRef;
+}
+export declare function useAvatar<O extends AvatarOptions = SvgAvatarOptions>({ client, create, options }?: UseAvatarOptions<O>): UseAvatarHandle;
+//# sourceMappingURL=useAvatar.d.ts.map

package/dist/useAvatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAvatar.d.ts","sourceRoot":"","sources":["../client/useAvatar.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,aAAa,GAAG,gBAAgB;IAC1E;gFAC4E;IAC5E,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,oEAAoE;IACpE,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,sEAAsE;IACtE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,MAAM,aAAa,CAAC,CAAC;CACxC;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,YAAY,EAAE,cAAc,CAAC;CAC9B;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,aAAa,GAAG,gBAAgB,EAClE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAE,gBAAgB,CAAC,CAAC,CAAM,GACpD,eAAe,CAyBjB"}

package/dist/useAvatar.js

@@ -0,0 +1,35 @@
+/**
+ * useAvatar — mount an avatar into a ref'd element for as long as there is a
+ * client to embody, and tear it down after.
+ *
+ * Internal; `<Avatar>` is the only thing the React entry exports. The whole
+ * hook is one effect, because the factory takes the client at construction:
+ * there is no separate attach step to keep in its own lifecycle any more.
+ */
+import { useEffect, useRef } from "react";
+import { createAvatar as createSvgAvatar, } from "./createAvatar.js";
+export function useAvatar({ client, create, options } = {}) {
+    const containerRef = useRef(null);
+    // Latest-options ref, so the mount effect reads the live values without
+    // remounting the face every time a caller passes a fresh object literal.
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    useEffect(() => {
+        const mount = containerRef.current;
+        if (!mount || !client)
+            return;
+        const factory = (create ?? createSvgAvatar);
+        // The cast is the seam between "O minus the two we supply" and O. It is
+        // sound by construction and TypeScript cannot see through the spread of a
+        // generic; the two halves are typed at the boundary the caller touches.
+        const instance = factory({ mount, client, ...optionsRef.current });
+        return () => instance.destroy();
+        // A new client identity is a new thing to embody, so the avatar is rebuilt
+        // rather than re-pointed. Hosts keep one `PipecatClient` across
+        // connect/disconnect cycles, so this does not fire on an ordinary
+        // reconnect; if yours constructs a fresh client per session, expect the
+        // face to remount with it.
+    }, [client, create]);
+    return { containerRef };
+}
+//# sourceMappingURL=useAvatar.js.map

package/dist/useAvatar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAvatar.js","sourceRoot":"","sources":["../client/useAvatar.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,EACL,YAAY,IAAI,eAAe,GAIhC,MAAM,mBAAmB,CAAC;AA8B3B,MAAM,UAAU,SAAS,CACvB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAA0B,EAAE;IAErD,MAAM,YAAY,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAElD,wEAAwE;IACxE,yEAAyE;IACzE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC;QACnC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM;YAAE,OAAO;QAC9B,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,eAAe,CAAqB,CAAC;QAChE,wEAAwE;QACxE,0EAA0E;QAC1E,wEAAwE;QACxE,MAAM,QAAQ,GAAG,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,EAAkB,CAAC,CAAC;QACnF,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAChC,2EAA2E;QAC3E,gEAAgE;QAChE,kEAAkE;QAClE,wEAAwE;QACxE,2BAA2B;IAC7B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAErB,OAAO,EAAE,YAAY,EAAE,CAAC;AAC1B,CAAC"}

package/dist/vikram.d.ts

@@ -0,0 +1,6 @@
+/** Polished professional male avatar, authored to read at call-tile size. */
+import type { CanvasAvatarOptions } from './createCanvasAvatar.js';
+import type { AvatarInstance } from './createAvatar.js';
+export type { CanvasAvatarOptions };
+export declare function createAvatar(options: CanvasAvatarOptions): AvatarInstance;
+//# sourceMappingURL=vikram.d.ts.map

package/dist/vikram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vikram.d.ts","sourceRoot":"","sources":["../client/vikram.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAG7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAUxD,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,cAAc,CAOzE"}

package/dist/vikram.js

@@ -0,0 +1,18 @@
+/** Polished professional male avatar, authored to read at call-tile size. */
+import { createCanvasAvatar } from './createCanvasAvatar.js';
+const RIG_URL = new URL('../src/canvas/data/professional-male-a.rig.json', import.meta.url);
+const IMAGES = {
+    'professional-male-a-top-body.webp': new URL('../src/canvas/data/img/professional-male-a-top-body.webp', import.meta.url),
+    'professional-male-a-hair-back.webp': new URL('../src/canvas/data/img/professional-male-a-hair-back.webp', import.meta.url),
+    'professional-male-a-hair-front.webp': new URL('../src/canvas/data/img/professional-male-a-hair-front.webp', import.meta.url),
+};
+const FACE = () => import('../src/canvas/avatars/round/face.mjs');
+export function createAvatar(options) {
+    return createCanvasAvatar(options, {
+        rigUrl: RIG_URL,
+        images: IMAGES,
+        face: FACE,
+        label: 'Vikram — polished professional male avatar',
+    });
+}
+//# sourceMappingURL=vikram.js.map

package/dist/vikram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vikram.js","sourceRoot":"","sources":["../client/vikram.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAI7D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,iDAAiD,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5F,MAAM,MAAM,GAAG;IACb,mCAAmC,EAAE,IAAI,GAAG,CAAC,0DAA0D,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IACzH,oCAAoC,EAAE,IAAI,GAAG,CAAC,2DAA2D,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IAC3H,qCAAqC,EAAE,IAAI,GAAG,CAAC,4DAA4D,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;CACrH,CAAC;AACX,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,sCAAsC,CAAC,CAAC;AAIlE,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,OAAO,kBAAkB,CAAC,OAAO,EAAE;QACjC,MAAM,EAAE,OAAO;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,4CAA4C;KACpD,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@voqalize/avatar",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "A JavaScript-programmable 2-D talking head for AI voice calls: server-synced lipsync, state through motion, zero dependencies.",
-  "license": "AGPL-3.0-only",
+  "license": "MIT",
   "author": "Voqalize",
   "homepage": "https://github.com/voqalize/avatar#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/voqalize/avatar.git"
+    "url": "git+https://github.com/voqalize/avatar.git",
+    "directory": "packages/avatar"
   },
   "bugs": {
     "url": "https://github.com/voqalize/avatar/issues"
@@ -31,26 +32,92 @@
   },
   "type": "module",
   "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./client/dist/index.d.ts",
-      "default": "./client/dist/index.js"
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "default": "./dist/react.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "default": "./dist/internal.js"
+    },
+    "./faces/peep": {
+      "types": "./src/face-peep.d.ts",
+      "default": "./src/face-peep.js"
+    },
+    "./faces/wren": {
+      "types": "./src/face-wren.d.ts",
+      "default": "./src/face-wren.js"
+    },
+    "./faces/myna": {
+      "types": "./src/face-myna.d.ts",
+      "default": "./src/face-myna.js"
+    },
+    "./avatars/arjun": {
+      "types": "./dist/arjun.d.ts",
+      "default": "./dist/arjun.js"
+    },
+    "./avatars/meera": {
+      "types": "./dist/meera.d.ts",
+      "default": "./dist/meera.js"
+    },
+    "./avatars/vikram": {
+      "types": "./dist/vikram.d.ts",
+      "default": "./dist/vikram.js"
+    },
+    "./avatars/ishita": {
+      "types": "./dist/ishita.d.ts",
+      "default": "./dist/ishita.js"
+    },
+    "./avatars/kabir": {
+      "types": "./dist/kabir.d.ts",
+      "default": "./dist/kabir.js"
+    },
+    "./avatars/naina": {
+      "types": "./dist/naina.d.ts",
+      "default": "./dist/naina.js"
+    },
+    "./avatars/interviewer-male": {
+      "types": "./dist/interviewer-male.d.ts",
+      "default": "./dist/interviewer-male.js"
+    },
+    "./avatars/interviewer-female": {
+      "types": "./dist/interviewer-female.d.ts",
+      "default": "./dist/interviewer-female.js"
+    },
+    "./avatars/professional-male-a": {
+      "types": "./dist/professional-male-a.d.ts",
+      "default": "./dist/professional-male-a.js"
+    },
+    "./avatars/professional-female-a": {
+      "types": "./dist/professional-female-a.d.ts",
+      "default": "./dist/professional-female-a.js"
+    },
+    "./avatars/professional-male-b": {
+      "types": "./dist/professional-male-b.d.ts",
+      "default": "./dist/professional-male-b.js"
+    },
+    "./avatars/professional-female-b": {
+      "types": "./dist/professional-female-b.d.ts",
+      "default": "./dist/professional-female-b.js"
     },
     "./package.json": "./package.json"
   },
   "files": [
     "src",
-    "client/dist",
-    "client/src",
-    "docs/contract-protocol.md",
-    "docs/contract-avatar.md",
-    "README.md"
+    "client",
+    "dist"
   ],
   "scripts": {
-    "build": "tsc -p client/tsconfig.json",
-    "typecheck": "tsc -p client/tsconfig.json --noEmit",
-    "test": "vitest run",
-    "prepare": "tsc -p client/tsconfig.json"
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepare": "tsc -p tsconfig.json"
   },
   "peerDependencies": {
     "@pipecat-ai/client-js": ">=1.4 <2",
@@ -67,15 +134,5 @@
     "react-dom": {
       "optional": true
     }
-  },
-  "devDependencies": {
-    "@pipecat-ai/client-js": "1.7.0",
-    "@types/react": "^18.3.3",
-    "@types/react-dom": "^18.3.0",
-    "jsdom": "^25.0.1",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "typescript": "^5.7.3",
-    "vitest": "^3.2.7"
   }
 }