@convai/embody 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @convai/embody
 
+## 0.6.0
+
+### Minor Changes
+
+- b9b1e4c: **embody is the 3D character only.** `@convai/embody/react` no longer re-exports `ConvaiWidget`, `AudioRenderer` or `AudioContext`: `@convai/web-sdk` 2.0 moved its chat UI to `@convai/web-widget`, so import them from `@convai/web-widget/react` and install it next to embody. `useWidgetClient` stays: hand its result to the widget so the chat and the character share one connection.
+
+  ```diff
+  - import { ConvaiCharacter, ConvaiWidget, useWidgetClient } from '@convai/embody/react'
+  + import { ConvaiCharacter, useWidgetClient } from '@convai/embody/react'
+  + import { ConvaiWidget } from '@convai/web-widget/react'
+  ```
+
+  The `@convai/web-sdk` peer range now also admits the 2.0 prereleases (`>=1.8.0-beta.4 || >=2.0.0-beta.0`); `>=1.8.0-beta.4` alone made npm refuse `2.0.0-beta.x` with ERESOLVE.
+
 ## 0.5.0
 
 ### Minor Changes

package/README.md

@@ -85,9 +85,8 @@ a second one. Lift it out with `onReady`; chat UI is DOM, so it lives outside
 the canvas:
 
 ```tsx
-import {
-  ConvaiCharacter, ConvaiWidget, useWidgetClient, type ConvaiClient,
-} from '@convai/embody/react'
+import { ConvaiCharacter, useWidgetClient, type ConvaiClient } from '@convai/embody/react'
+import { ConvaiWidget } from '@convai/web-widget/react'
 
 function App() {
   const [client, setClient] = useState<ConvaiClient | null>(null)
@@ -105,8 +104,9 @@ function App() {
 }
 ```
 
-`ConvaiWidget` and `ConvaiClient` are re-exported from `@convai/web-sdk`, so
-`@convai/embody` is the only import your app needs. `useWidgetClient` adapts
+embody is the 3D character only; the chat panel is
+[`@convai/web-widget`](https://www.npmjs.com/package/@convai/web-widget)
+(`npm install @convai/web-widget`). `useWidgetClient` adapts
 embody's client to the widget's props — the SDK's own `useConvaiClient` would
 *construct a second client*, and so open a second connection, which is exactly
 what embody exists to avoid.
@@ -280,4 +280,4 @@ feature and adding its test are the same commit.
 
 ## License
 
-Apache-2.0. See [LICENSE](./LICENSE).
+Licensed under the [Apache License 2.0](./LICENSE). Copyright 2026 Convai.

package/dist/react/index.d.ts

@@ -9,20 +9,23 @@
  * </Canvas>
  * ```
  *
- * The SDK's own React surface is re-exported so an app can build chat UI
- * without adding a second dependency — or a second connection. `ConvaiWidget`
- * takes a client, and `character.client` is one.
+ * embody is the 3D character only. For a chat panel, install
+ * `@convai/web-widget` and hand it the character's own client — one session,
+ * not two. `useWidgetClient` adapts that client to the widget's props.
  *
  * Chat UI is DOM and the character is a `<Canvas>` child, so lift the client
  * out rather than rendering the widget from inside the scene:
  *
  * ```tsx
+ * import { ConvaiWidget } from '@convai/web-widget/react'
+ *
  * const [client, setClient] = useState<ConvaiClient | null>(null)
+ * const widgetClient = useWidgetClient(client)
  * <Canvas>
  *   <ConvaiCharacter apiKey={apiKey} characterId={characterId}
  *                    onReady={(c) => setClient(c.client)} />
  * </Canvas>
- * {client && <ConvaiWidget convaiClient={client} />}
+ * {widgetClient && <ConvaiWidget convaiClient={widgetClient} />}
  * ```
  */
 export { useCharacter } from './useCharacter.js';
@@ -35,6 +38,6 @@ export { OrbitRig } from './OrbitRig.js';
 export type { OrbitOptions, OrbitRigProps } from './OrbitRig.js';
 export { useWidgetClient } from './useWidgetClient.js';
 export type { WidgetClient } from './useWidgetClient.js';
-export { ConvaiWidget, useConvaiClient, AudioRenderer, AudioContext } from '@convai/web-sdk/react';
+export { useConvaiClient } from '@convai/web-sdk/react';
 export { ConvaiClient } from '@convai/web-sdk/core';
 export type { ConvaiConfig } from '@convai/web-sdk/core';

package/dist/react/index.js

@@ -9,20 +9,23 @@
  * </Canvas>
  * ```
  *
- * The SDK's own React surface is re-exported so an app can build chat UI
- * without adding a second dependency — or a second connection. `ConvaiWidget`
- * takes a client, and `character.client` is one.
+ * embody is the 3D character only. For a chat panel, install
+ * `@convai/web-widget` and hand it the character's own client — one session,
+ * not two. `useWidgetClient` adapts that client to the widget's props.
  *
  * Chat UI is DOM and the character is a `<Canvas>` child, so lift the client
  * out rather than rendering the widget from inside the scene:
  *
  * ```tsx
+ * import { ConvaiWidget } from '@convai/web-widget/react'
+ *
  * const [client, setClient] = useState<ConvaiClient | null>(null)
+ * const widgetClient = useWidgetClient(client)
  * <Canvas>
  *   <ConvaiCharacter apiKey={apiKey} characterId={characterId}
  *                    onReady={(c) => setClient(c.client)} />
  * </Canvas>
- * {client && <ConvaiWidget convaiClient={client} />}
+ * {widgetClient && <ConvaiWidget convaiClient={widgetClient} />}
  * ```
  */
 export { useCharacter } from './useCharacter.js';
@@ -32,6 +35,7 @@ export { CharacterModel } from './CharacterModel.js';
 // still want the orbit behaviour ConvaiCharacter gives for free.
 export { OrbitRig } from './OrbitRig.js';
 export { useWidgetClient } from './useWidgetClient.js';
-// ── Chat / conversation surface, re-exported from @convai/web-sdk/react ────
-export { ConvaiWidget, useConvaiClient, AudioRenderer, AudioContext } from '@convai/web-sdk/react';
+// ── The client, re-exported from @convai/web-sdk ──────────────────────────
+// No UI: ConvaiWidget, AudioRenderer and AudioContext are @convai/web-widget's.
+export { useConvaiClient } from '@convai/web-sdk/react';
 export { ConvaiClient } from '@convai/web-sdk/core';

package/dist/react/useWidgetClient.js

@@ -1,5 +1,5 @@
 /**
- * Makes embody's client usable by the SDK's `<ConvaiWidget/>`.
+ * Makes embody's client usable by `<ConvaiWidget/>` from `@convai/web-widget`.
  *
  * The widget wants `IConvaiClient` plus four pieces of reactive UI state
  * (`activity`, `isAudioMuted`, `isVideoEnabled`, `isScreenShareActive`). The

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@convai/embody",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Give a Convai character a body: resolve 3D characters by characterId and drive them with lipsync and animation. Layered on @convai/web-sdk.",
   "license": "Apache-2.0",
   "author": "Convai <support@convai.com>",
@@ -58,7 +58,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@convai/web-sdk": ">=1.8.0-beta.4",
+    "@convai/web-sdk": ">=1.8.0-beta.4 || >=2.0.0-beta.0",
     "@react-three/fiber": ">=8",
     "react": ">=18",
     "three": ">=0.160"
@@ -73,7 +73,8 @@
   },
   "devDependencies": {
     "@changesets/cli": "^2.27.0",
-    "@convai/web-sdk": "1.8.0-beta.4",
+    "@convai/web-sdk": "2.0.0-beta.0",
+    "@convai/web-widget": "0.2.1",
     "@react-three/fiber": "^8.18.0",
     "@types/react": "^18.3.31",
     "@types/react-dom": "^19.2.7",