realtime-avatar 0.1.0

package/dist/session.js

@@ -0,0 +1,192 @@
+/**
+ * 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 class AvatarSession {
+    client;
+    config;
+    socket = null;
+    constructor(client, config) {
+        this.client = client;
+        this.config = config;
+    }
+    get avatarId() {
+        return this.config.avatarId;
+    }
+    /** True while a live session socket is open; turns will ride it. */
+    get connected() {
+        return this.socket?.open === true;
+    }
+    /** Transport the NEXT turn will use. */
+    get transport() {
+        return this.connected ? "socket" : "http";
+    }
+    /**
+     * 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).
+     */
+    async connect(options = {}) {
+        return (await this.connectWithGrant(options)).prepared;
+    }
+    /**
+     * 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.
+     */
+    async connectWithGrant(options = {}) {
+        this.disconnect();
+        const grant = await this.client.createSessionGrant({ signal: options.signal });
+        options.onGrant?.(grant);
+        const socket = await this.client.connectRealtimeSession({
+            signal: options.signal,
+            WebSocketImpl: options.WebSocketImpl,
+            grant,
+        });
+        try {
+            const prepared = await socket.prepare(this.prepareRequest());
+            this.socket = socket;
+            return { grant, prepared };
+        }
+        catch (error) {
+            socket.close();
+            throw error;
+        }
+    }
+    /** Close the session socket (if any); turns fall back to HTTP. */
+    disconnect() {
+        this.socket?.close();
+        this.socket = null;
+    }
+    /**
+     * 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.
+     */
+    async cancel() {
+        const socket = this.socket;
+        if (!socket)
+            return;
+        try {
+            await socket.cancelTurn();
+        }
+        catch {
+            if (this.socket === socket)
+                this.socket = null;
+            socket.close();
+        }
+    }
+    prepare(options = {}) {
+        if (this.connected && this.socket)
+            return this.socket.prepare(this.prepareRequest());
+        return this.client.prepare(this.prepareRequest(), options);
+    }
+    /** The prepare payload this session sends — reusable over a `RealtimeSessionSocket`. */
+    prepareRequest() {
+        return defined({
+            avatar_id: this.config.avatarId,
+            source_kind: this.config.sourceKind,
+            portrait_url: this.config.portraitUrl,
+            source_video_url: this.config.sourceVideoUrl,
+            video_cache_id: this.config.videoCacheId,
+        });
+    }
+    async chat(text, options = {}) {
+        const { history, turn, ...requestOptions } = options;
+        const socketTurn = await this.socketTurn({ ...this.chatRequest(text, history), ...turn });
+        if (socketTurn)
+            return socketTurn;
+        return this.client.chat({ ...this.turnBase(), ...turn, avatarId: this.config.avatarId, text, history }, requestOptions);
+    }
+    async speak(text, options = {}) {
+        const { turn, ...requestOptions } = options;
+        const socketTurn = await this.socketTurn({ ...this.speakRequest(text), ...turn });
+        if (socketTurn)
+            return socketTurn;
+        return this.client.speak({ ...this.turnBase(), ...turn, avatarId: this.config.avatarId, text }, requestOptions);
+    }
+    /** The chat turn payload — reusable over a `RealtimeSessionSocket`. */
+    chatRequest(text, history) {
+        return {
+            ...this.turnBase(),
+            mode: "chat",
+            avatar_id: this.config.avatarId,
+            messages: boundTurnMessages([...(history ?? []), { role: "user", content: text }]),
+        };
+    }
+    /** The speak-text turn payload — reusable over a `RealtimeSessionSocket`. */
+    speakRequest(text) {
+        return {
+            ...this.turnBase(),
+            mode: "speak_text",
+            avatar_id: this.config.avatarId,
+            text,
+        };
+    }
+    /**
+     * 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.
+     */
+    async socketTurn(request) {
+        const socket = this.socket;
+        if (!socket || !socket.open)
+            return null;
+        try {
+            await socket.cancelTurn();
+            return socket.turn(request);
+        }
+        catch {
+            if (this.socket === socket)
+                this.socket = null;
+            socket.close();
+            return null;
+        }
+    }
+    turnBase() {
+        return {
+            // Hardware H.264 playback (~6x less bandwidth than MJPEG) whenever the
+            // runtime can decode it; turnDefaults.video_codec overrides.
+            ...(supportsWebCodecsH264() ? { video_codec: "h264" } : {}),
+            ...this.config.turnDefaults,
+            ...defined({
+                source_kind: this.config.sourceKind,
+                portrait_url: this.config.portraitUrl,
+                source_video_url: this.config.sourceVideoUrl,
+                video_cache_id: this.config.videoCacheId,
+                voice_id: this.config.voiceId,
+                background_id: this.config.backgroundId,
+            }),
+        };
+    }
+}
+function defined(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, v]) => v !== undefined));
+}
+// Server cap on chat context per turn (RealtimeTurnRequest.messages). Long
+// histories are trimmed to system prompts + the most recent remainder so
+// callers can keep appending forever — an unbounded prompt would fail
+// validation AND inflate LLM first-token latency on every turn.
+const MAX_TURN_MESSAGES = 24;
+const MAX_TURN_SYSTEM_MESSAGES = 4;
+function boundTurnMessages(messages) {
+    if (messages.length <= MAX_TURN_MESSAGES)
+        return messages;
+    const system = messages.filter((m) => m.role === "system").slice(0, MAX_TURN_SYSTEM_MESSAGES);
+    const rest = messages.filter((m) => m.role !== "system");
+    const keep = Math.max(MAX_TURN_MESSAGES - system.length, 1);
+    return [...system, ...rest.slice(-keep)];
+}
+function supportsWebCodecsH264() {
+    return typeof VideoDecoder === "function" && typeof EncodedVideoChunk === "function";
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+import type { components } from "./generated/openapi";
+export type ArtifactStatus = components["schemas"]["ArtifactStatus"];
+export type HealthResponse = components["schemas"]["HealthResponse"];
+export type LiveChunkInfo = components["schemas"]["LiveChunkInfo"];
+export type RealtimeChatMessage = components["schemas"]["RealtimeChatMessage"];
+export type RealtimeTurnRequest = components["schemas"]["RealtimeTurnRequest"] & {
+    /**
+     * source_video turns: ping-pong playback cursor to start rendering from.
+     * Clients pass the idle loop's current position so the live render continues
+     * seamlessly; the `done` event returns the final cursor as `sourceVideo`.
+     * (Server-supported; not yet present in the generated OpenAPI snapshot.)
+     */
+    source_start_frame?: number | null;
+};
+export type RealtimePrepareRequest = components["schemas"]["RealtimePrepareRequest"];
+export type RealtimePrepareResponse = components["schemas"]["RealtimePrepareResponse"];
+export type SourceVideoCacheSettings = components["schemas"]["SourceVideoCacheSettings"];
+export type VideoAvatarCacheManifest = components["schemas"]["VideoAvatarCacheManifest"];
+export type VideoCachePaths = components["schemas"]["VideoCachePaths"];
+export type VideoCachePlan = components["schemas"]["VideoCachePlan"];
+export type VideoCachePlanRequest = components["schemas"]["VideoCachePlanRequest"];
+export type VideoCachePlanResponse = components["schemas"]["VideoCachePlanResponse"];
+export type AvatarSourceKind = NonNullable<RealtimeTurnRequest["source_kind"]>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,gBAAgB,CAAC,CAAC;AACrE,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,gBAAgB,CAAC,CAAC;AACrE,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,CAAC;AACnE,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAC;AAC/E,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,GAAG;IAC/E;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,wBAAwB,CAAC,CAAC;AACrF,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,yBAAyB,CAAC,CAAC;AACvF,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,0BAA0B,CAAC,CAAC;AACzF,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,0BAA0B,CAAC,CAAC;AACzF,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,iBAAiB,CAAC,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,gBAAgB,CAAC,CAAC;AACrE,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,uBAAuB,CAAC,CAAC;AACnF,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,wBAAwB,CAAC,CAAC;AAErF,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "realtime-avatar",
+  "version": "0.1.0",
+  "description": "Agent-ready TypeScript SDK for realtime AI avatars, lipsync MP4 rendering, and audio-clocked talking-avatar streams.",
+  "license": "MIT",
+  "author": "The Influence Company",
+  "homepage": "https://docs.realtimeavatar.ai/sdks/typescript",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/theinfluencecompany/realtime-avatar.git",
+    "directory": "packages/realtime-avatar"
+  },
+  "bugs": {
+    "url": "https://github.com/theinfluencecompany/realtime-avatar/issues"
+  },
+  "keywords": [
+    "realtime-avatar",
+    "realtime avatar",
+    "ai avatar",
+    "talking avatar",
+    "talking head",
+    "avatar",
+    "lipsync",
+    "lip sync",
+    "ai",
+    "video",
+    "sdk",
+    "tts",
+    "mcp",
+    "agents"
+  ],
+  "private": false,
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser/index.d.ts",
+      "default": "./dist/browser/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    },
+    "./generated/openapi": {
+      "types": "./dist/generated/openapi.d.ts",
+      "default": "./dist/generated/openapi.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "AGENTS.md",
+    "CLAUDE.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "check": "tsc --noEmit",
+    "test": "bun test",
+    "prepublishOnly": "bun run build",
+    "publish:dry": "bun run build && npm publish --dry-run",
+    "contracts:openapi": "uv run --project ../.. python ../../scripts/export_realtime_avatar_openapi.py",
+    "contracts:ts": "bunx openapi-typescript openapi/realtime-avatar.openapi.json --default-non-nullable false -o src/generated/openapi.ts"
+  },
+  "dependencies": {
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "typescript": "6.0.3",
+    "react": "19.2.7",
+    "@types/react": "19.2.7"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  }
+}