@voqalize/avatar 0.5.7 → 0.6.1

package/README.md

@@ -45,15 +45,16 @@ appeared.
 
 `character` names one of the characters you can meet at
 https://voqalize.com/demos/avatar. Each release of this package can mount a
-fixed set of them, and a name it does not have throws, listing the ones it
-does. `listCharacters()` returns that set:
+fixed set of them. A name it does not have mounts nothing: `createAvatar`
+still returns, and the error goes to the console, listing the names it does
+have. `listCharacters()` returns that set:
 
 ```js
 import { listCharacters } from "@voqalize/avatar";
 
 for (const c of await listCharacters()) {
   // c.name, c.still (an image URL), c.gender, c.age.min, c.age.max,
-  // c.ethnicity[], c.tags[], c.suggestedVoices[]
+  // c.ethnicity[], c.tags[], c.suggestedVoices[], c.languages[]
 }
 ```
 
@@ -61,15 +62,21 @@ Use it to build a picker or a filter rather than writing the names down. The
 words in `gender`, `ethnicity` and `tags` come from closed lists, so a filter
 you build from one call matches the next. `suggestedVoices` lists the voices
 that suit the face, best first, as Voqalize voice ids such as
-`omnivoice/gauri`. It is advice: the avatar never speaks.
+`omnivoice/gauri`. It is advice: the avatar never speaks. `languages` lists
+the languages the first voice speaks, default first (`"en"` or `"hi"`). Send one as the `language` of every speech request: without it the
+voice falls back to English, and Hindi text comes out with an
+English accent.
 
 The gains are optional, from `0` to `2`, and `1` is as authored:
 
 - `mouthGain` sets how far the mouth moves.
 - `gestureGain` sets the size of nods and other gestures.
-- `motionGain` sets the amount of idle motion.
+- `motionGain` sets the amount of idle and speaking motion: the head, trunk and shoulders. Left out, it is `1`, or `0.5` when the reader's system asks for reduced motion.
 
 The client must be connected to a Voqalize session that has the avatar turned on.
+Nothing in the transport changes: the avatar draws in the browser from the
+session's data-channel messages, so there is no video track to turn on, and
+`video_out_enabled` (the path for server-rendered video avatars) stays off.
 
 ## Preload before the call
 

package/dist/index.d.ts

@@ -40,7 +40,7 @@ export interface AvatarOptions {
     readonly mouthGain?: Gain;
     /** Nods and other gestures. */
     readonly gestureGain?: Gain;
-    /** Idle motion. */
+    /** Idle and speaking motion. */
     readonly motionGain?: Gain;
 }
 export interface AvatarInstance {
@@ -70,6 +70,10 @@ export interface CharacterInfo {
     /** Voqalize voice ids that suit this face, best first — `"omnivoice/gauri"`,
      *  for example. Advice only: the avatar never speaks. */
     readonly suggestedVoices: readonly string[];
+    /** The languages the first suggested voice speaks, default first: `"en"` or
+     *  `"hi"`. Send one as the `language` of every speech request;
+     *  without it the voice falls back to English. */
+    readonly languages: readonly string[];
 }
 /** A face `preloadAvatar` is building, or has built, ahead of its mount. */
 export interface PreloadedAvatar {

package/dist/pin.d.ts

@@ -1,2 +1,2 @@
-export declare const RUNTIME_URL = "https://avatar.voqalize.com/runtime/runtime.UTAI5EKI.js";
+export declare const RUNTIME_URL = "https://avatar.voqalize.com/runtime/runtime.R6SM4O5D.js";
 export declare const PROTOCOL = 1;

package/dist/pin.js

@@ -1,3 +1,3 @@
 // Written by scripts/build-runtime.mjs — the runtime this shim is released with.
-export const RUNTIME_URL = "https://avatar.voqalize.com/runtime/runtime.UTAI5EKI.js";
+export const RUNTIME_URL = "https://avatar.voqalize.com/runtime/runtime.R6SM4O5D.js";
 export const PROTOCOL = 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voqalize/avatar",
-  "version": "0.5.7",
+  "version": "0.6.1",
   "description": "A talking head for AI voice calls that embodies your pipecat client. This package loads the Voqalize avatar runtime.",
   "license": "MIT",
   "author": "Voqalize",
@@ -47,6 +47,7 @@
   "scripts": {
     "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "echo 'run pnpm test from the repo root' >&2 && exit 1",
     "prepare": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json"
   },
   "peerDependencies": {