realtime-avatar 0.18.0 → 0.20.0

package/dist/{chunk-27XNZHSF.js → chunk-PKOWNCDT.js}

@@ -437,6 +437,7 @@ z.object({
   source_kind: avatarSourceKindSchema.default("portrait"),
   source_video_url: nullableUrlSchema.optional(),
   stt_mode: liveKitSttModeSchema.default("server"),
+  camera: z.boolean().optional(),
   video_cache_id: z.string().min(1).max(240).nullable().optional(),
   voice: voiceSpecSchema.nullable().optional(),
   voice_id: z.string().min(1).max(240).nullable().optional(),
@@ -509,6 +510,7 @@ z.object({
   queueTicketId: z.string().min(1).max(160).optional(),
   roomName: z.string().min(1).max(160).optional(),
   sttMode: liveKitSttModeSchema.default("server"),
+  camera: z.boolean().optional(),
   voice: voiceSpecSchema.nullable().optional(),
   voiceId: z.string().min(1).max(240).nullable().optional(),
   // Unbounded, for the same reason as `clip_library` on the wire schema above.
@@ -531,6 +533,7 @@ var liveKitSessionGrantSchema = z.object({
   participant_identity: z.string().min(1),
   reservation_expires_at: z.string().datetime({ offset: true }),
   stt_mode: liveKitSttModeSchema.default("server"),
+  camera: z.boolean().optional(),
   room_created: z.boolean().default(false),
   dispatch_created: z.boolean().default(false),
   join_timeout_seconds: z.number().int().nonnegative().default(0),
@@ -618,7 +621,7 @@ z.enum([
 
 // ../http-client/src/client.ts
 var DEFAULT_BASE_URL = "https://realtimeavatar.ai/api/v1";
-var SDK_VERSION = "0.18.0";
+var SDK_VERSION = "0.20.0";
 var RealtimeAvatar = class {
   #apiKey;
   #baseUrl;
@@ -657,6 +660,7 @@ var RealtimeAvatar = class {
       stt_mode: options.listen === false ? "off" : "server"
     };
     if (options.instructions !== void 0) body.instructions = options.instructions;
+    if (options.camera !== void 0) body.camera = options.camera;
     if (options.context !== void 0) {
       body.initial_context = options.context.map((m) => ({ role: m.role, content: m.content }));
     }

package/dist/{chunk-RKIEGOGJ.js → chunk-QT5UTARL.js}

@@ -1,4 +1,4 @@
-import { RealtimeAvatar, isQueued, RealtimeAvatarHttpError } from './chunk-27XNZHSF.js';
+import { RealtimeAvatar, isQueued, RealtimeAvatarHttpError } from './chunk-PKOWNCDT.js';
 
 // ../proxy/src/config.ts
 var json = (body, status = 200) => new Response(JSON.stringify(body), {

package/dist/express.d.ts

@@ -1,5 +1,5 @@
-import { P as ProxyConfig } from './types-Bzn5PJ0g.js';
-import './types-CxkszIDK.js';
+import { P as ProxyConfig } from './types-TaQCvMPh.js';
+import './types-D76SpA3g.js';
 import 'zod';
 
 type Expressish = {

package/dist/express.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-RKIEGOGJ.js';
-import './chunk-27XNZHSF.js';
+import { createProxyHandler } from './chunk-QT5UTARL.js';
+import './chunk-PKOWNCDT.js';
 import './chunk-MCIXU6XP.js';
 
 // ../proxy/src/express.ts

package/dist/hono.d.ts

@@ -1,5 +1,5 @@
-import { P as ProxyConfig } from './types-Bzn5PJ0g.js';
-import './types-CxkszIDK.js';
+import { P as ProxyConfig } from './types-TaQCvMPh.js';
+import './types-D76SpA3g.js';
 import 'zod';
 
 /**

package/dist/hono.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-RKIEGOGJ.js';
-import './chunk-27XNZHSF.js';
+import { createProxyHandler } from './chunk-QT5UTARL.js';
+import './chunk-PKOWNCDT.js';
 import './chunk-MCIXU6XP.js';
 
 // ../proxy/src/hono.ts

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as CallPolicy, C as CallMode, S as StartCallResult, E as EndCallOptions, A as Avatar, b as AvatarUpdate, c as AvatarSourceSwap, d as ClipLibraryDeclaration, e as ClipLibraryUpdate, L as LoopRedirect, f as ClipLibrary, g as AssetKind, h as Asset, i as ListSessionsOptions, U as UsageSessionPage, j as UsageSession, k as ListRecordingsQuery, l as ListRecordingsResponse, R as RecordingArtifact, m as RecordingAccessResponse, n as CreditBalance, T as TranscriptPayload } from './types-CxkszIDK.js';
-export { o as AvatarClip, p as CallConnection, q as CallQueued, r as ClipDeclaration, s as ClipLibraryPlan, t as ClipSource, u as ContextMessage, v as EndCallReason, w as RecordingArtifactStatus, x as RecordingMode, V as VideoPolicy, y as isQueued, z as listRecordingsResponseSchema, B as recordingAccessResponseSchema, D as recordingArtifactSchema, F as recordingModeSchema } from './types-CxkszIDK.js';
+import { a as CallPolicy, C as CallMode, S as StartCallResult, E as EndCallOptions, A as Avatar, b as AvatarUpdate, c as AvatarSourceSwap, d as ClipLibraryDeclaration, e as ClipLibraryUpdate, L as LoopRedirect, f as ClipLibrary, g as AssetKind, h as Asset, i as ListSessionsOptions, U as UsageSessionPage, j as UsageSession, k as ListRecordingsQuery, l as ListRecordingsResponse, R as RecordingArtifact, m as RecordingAccessResponse, n as CreditBalance, T as TranscriptPayload } from './types-D76SpA3g.js';
+export { o as AvatarClip, p as CallConnection, q as CallQueued, r as ClipDeclaration, s as ClipLibraryPlan, t as ClipSource, u as ContextMessage, v as EndCallReason, w as RecordingArtifactStatus, x as RecordingMode, V as VideoPolicy, y as isQueued, z as listRecordingsResponseSchema, B as recordingAccessResponseSchema, D as recordingArtifactSchema, F as recordingModeSchema } from './types-D76SpA3g.js';
 import { ConnectionHistoryResponse } from './connection-history.js';
 import { z } from 'zod';
 

package/dist/index.js

@@ -1,2 +1,2 @@
-export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, listRecordingsResponseSchema, recordingAccessResponseSchema, recordingArtifactSchema, recordingModeSchema, verifyTranscript } from './chunk-27XNZHSF.js';
+export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, listRecordingsResponseSchema, recordingAccessResponseSchema, recordingArtifactSchema, recordingModeSchema, verifyTranscript } from './chunk-PKOWNCDT.js';
 import './chunk-MCIXU6XP.js';

package/dist/nextjs.d.ts

@@ -1,5 +1,5 @@
-import { P as ProxyConfig } from './types-Bzn5PJ0g.js';
-import './types-CxkszIDK.js';
+import { P as ProxyConfig } from './types-TaQCvMPh.js';
+import './types-D76SpA3g.js';
 import 'zod';
 
 /**

package/dist/nextjs.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-RKIEGOGJ.js';
-import './chunk-27XNZHSF.js';
+import { createProxyHandler } from './chunk-QT5UTARL.js';
+import './chunk-PKOWNCDT.js';
 import './chunk-MCIXU6XP.js';
 
 // ../proxy/src/nextjs.ts

package/dist/{proxy-client-w6prrzGW.d.ts → proxy-client-DpMcj6fI.d.ts}

@@ -1,8 +1,23 @@
+import * as livekit_client from 'livekit-client';
+import { ConnectionQuality, Room, Participant, Track, DisconnectReason, SendTextOptions } from 'livekit-client';
 import { TrackReferenceOrPlaceholder, useTranscriptions, useConnectionState, LiveKitRoomProps } from '@livekit/components-react';
 import { CSSProperties, ReactNode, ReactElement } from 'react';
-import { ConnectionQuality, Room, Participant, Track, DisconnectReason, SendTextOptions } from 'livekit-client';
 import { z } from 'zod';
 
+declare function useAvatarCamera({ allowed, active }: {
+    allowed: boolean;
+    active?: boolean;
+}): {
+    enabled: boolean;
+    pending: boolean;
+    error: "permission_denied" | "unavailable" | null;
+    available: boolean;
+    toggle: () => Promise<void>;
+    setEnabled: (enabled: boolean) => Promise<void>;
+    publication: livekit_client.TrackPublication | undefined;
+    participant: livekit_client.LocalParticipant;
+};
+
 /**
  * Wire schemas for the public Realtime Avatar API.
  *
@@ -144,6 +159,7 @@ declare const liveKitSessionRequestSchema: z.ZodObject<{
         off: "off";
         server: "server";
     }>>;
+    camera: z.ZodOptional<z.ZodBoolean>;
     voice: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
         provider: z.ZodLiteral<"cartesia">;
         model: z.ZodDefault<z.ZodEnum<{
@@ -268,8 +284,8 @@ declare const liveKitSessionGrantSchema: z.ZodObject<{
         retainedUntil: z.ZodString;
         status: z.ZodLiteral<"failed">;
         errorCode: z.ZodEnum<{
-            recording_unavailable: "recording_unavailable";
             recording_failed: "recording_failed";
+            recording_unavailable: "recording_unavailable";
         }>;
     }, z.core.$strict>], "status">>;
     connection_history: z.ZodOptional<z.ZodObject<{
@@ -288,6 +304,7 @@ declare const liveKitSessionGrantSchema: z.ZodObject<{
         off: "off";
         server: "server";
     }>>;
+    camera: z.ZodOptional<z.ZodBoolean>;
     room_created: z.ZodDefault<z.ZodBoolean>;
     dispatch_created: z.ZodDefault<z.ZodBoolean>;
     join_timeout_seconds: z.ZodDefault<z.ZodNumber>;
@@ -1717,4 +1734,4 @@ interface ProxyClientOptions {
 }
 declare function createProxyClient(options: ProxyClientOptions): AvatarSessionClient;
 
-export { type QualityCap as $, type AvatarVideoFit as A, type BehaviorSnapshot as B, type CallTranscript as C, DEFAULT_APPROACHING_END_LEAD_SECONDS as D, type EndReason as E, type FishTtsModel as F, type Governor as G, type GovernorState as H, type GraceWindowClosedEvent as I, type GraceWindowOpenEvent as J, type GraceWindowState as K, type LiveKitSessionGrant as L, type IdleWarningEvent as M, type InboundRtpCursor as N, type InboundRtpReading as O, type KnownBehaviorState as P, type LLMProvider as Q, type LLMSelection as R, type LiveKitAvatarGrantState as S, type LiveKitAvatarGrantStatus as T, type LiveKitCapacityState as U, type LiveKitConnectionStatus as V, type LiveKitSessionRequest as W, type LiveKitSessionStartResult as X, MAX_RECONNECT_ATTEMPTS as Y, MAX_SESSION_INSTRUCTIONS_CHARS as Z, type ProxyClientOptions as _, AdaptivePlayoutController as a, RECONNECT_BACKOFF_MS as a0, type RealtimeAvatarRequestOptions as a1, type RealtimeSessionApi as a2, type RealtimeSessionMedia as a3, type RealtimeSessionRoomSinks as a4, type ReconnectPolicy as a5, type ReconnectingEvent as a6, type RecoveryState as a7, type RetryStep as a8, type SessionBehavior as a9, splitCallTranscript as aA, useAvatarAdaptivePlayoutDelay as aB, useAvatarPlayoutDelay as aC, useAvatarQualityGovernor as aD, useCallTranscript as aE, useLiveKitAvatarGrant as aF, useLiveTrackProducing as aG, useMicLease as aH, useRealtimeSession as aI, useReleaseMicLeaseOnTrackEnded as aJ, useSessionLifecycle as aK, AvatarVideoSurface as aL, type AvatarVideoSurfaceProps as aM, type LivePlaybackKeeper as aN, MIC_LEASE_ENDED_TIMEOUT_MS as aO, type MicLease as aP, NETWORK_QUALITY_POLICY as aQ, type NetworkQualityStatus as aR, type PlayableVideoElement as aS, RealtimeAvatarCapacityError as aT, RealtimeAvatarLiveKitRoom as aU, type RealtimeAvatarLiveKitRoomProps as aV, shouldReplayPendingTurn as aW, type SessionClip as aa, type SessionClocks as ab, type SessionEndReason as ac, type SessionLifecycleApi as ad, type SessionLifecyclePhase as ae, type SessionLifecyclePhaseKind as af, SessionLifecycleRoomBridge as ag, type SessionLifecycleRoomBridgeProps as ah, type SurfaceLayers as ai, type TurnState as aj, type TurnTimeoutEvent as ak, type UseAvatarQualityGovernorInput as al, type UseLiveKitAvatarGrantInput as am, type UseRealtimeSessionInput as an, type UseSessionLifecycleInput as ao, type VoiceSpec as ap, type VoiceSpecInput as aq, capacityErrorFromBusy as ar, capacityStateFromGrant as as, createProxyClient as at, isNativeLiveTrackSubscribed as au, knownBehaviorStates as av, mapTurnState as aw, readInboundRtp as ax, sessionBehaviorSchema as ay, sessionClipSchema as az, type AdaptivePlayoutDecision as b, type AdaptivePlayoutOptions as c, type AdaptivePlayoutSample as d, type ApproachingEndEvent as e, type ApproachingEndReason as f, type AvatarConnectionDetails as g, type AvatarSessionClient as h, type CallTranscriptSegment as i, type CartesiaTtsModel as j, type ClipResult as k, type ClosingTurnResult as l, type CreditsLowEvent as m, DEFAULT_CREDITS_LOW_LEAD_SECONDS as n, DEFAULT_GOVERNOR_CONFIG as o, DEFAULT_GRACE_CEILING_SECONDS as p, DEFAULT_GRACE_WINDOW_LEAD_SECONDS as q, DEFAULT_IDLE_SECONDS as r, DEFAULT_IDLE_WARN_LEAD_SECONDS as s, DEFAULT_TURN_TIMEOUT_SECONDS as t, type EndedEvent as u, type ExtendResult as v, type FreezeReadingFn as w, type GovernorAction as x, type GovernorConfig as y, type GovernorSignal as z };
+export { type QualityCap as $, type AvatarVideoFit as A, type BehaviorSnapshot as B, type CallTranscript as C, DEFAULT_APPROACHING_END_LEAD_SECONDS as D, type EndReason as E, type FishTtsModel as F, type Governor as G, type GovernorState as H, type GraceWindowClosedEvent as I, type GraceWindowOpenEvent as J, type GraceWindowState as K, type LiveKitSessionGrant as L, type IdleWarningEvent as M, type InboundRtpCursor as N, type InboundRtpReading as O, type KnownBehaviorState as P, type LLMProvider as Q, type LLMSelection as R, type LiveKitAvatarGrantState as S, type LiveKitAvatarGrantStatus as T, type LiveKitCapacityState as U, type LiveKitConnectionStatus as V, type LiveKitSessionRequest as W, type LiveKitSessionStartResult as X, MAX_RECONNECT_ATTEMPTS as Y, MAX_SESSION_INSTRUCTIONS_CHARS as Z, type ProxyClientOptions as _, AdaptivePlayoutController as a, RECONNECT_BACKOFF_MS as a0, type RealtimeAvatarRequestOptions as a1, type RealtimeSessionApi as a2, type RealtimeSessionMedia as a3, type RealtimeSessionRoomSinks as a4, type ReconnectPolicy as a5, type ReconnectingEvent as a6, type RecoveryState as a7, type RetryStep as a8, type SessionBehavior as a9, splitCallTranscript as aA, useAvatarAdaptivePlayoutDelay as aB, useAvatarCamera as aC, useAvatarPlayoutDelay as aD, useAvatarQualityGovernor as aE, useCallTranscript as aF, useLiveKitAvatarGrant as aG, useLiveTrackProducing as aH, useMicLease as aI, useRealtimeSession as aJ, useReleaseMicLeaseOnTrackEnded as aK, useSessionLifecycle as aL, AvatarVideoSurface as aM, type AvatarVideoSurfaceProps as aN, type LivePlaybackKeeper as aO, MIC_LEASE_ENDED_TIMEOUT_MS as aP, type MicLease as aQ, NETWORK_QUALITY_POLICY as aR, type NetworkQualityStatus as aS, type PlayableVideoElement as aT, RealtimeAvatarCapacityError as aU, RealtimeAvatarLiveKitRoom as aV, type RealtimeAvatarLiveKitRoomProps as aW, shouldReplayPendingTurn as aX, type SessionClip as aa, type SessionClocks as ab, type SessionEndReason as ac, type SessionLifecycleApi as ad, type SessionLifecyclePhase as ae, type SessionLifecyclePhaseKind as af, SessionLifecycleRoomBridge as ag, type SessionLifecycleRoomBridgeProps as ah, type SurfaceLayers as ai, type TurnState as aj, type TurnTimeoutEvent as ak, type UseAvatarQualityGovernorInput as al, type UseLiveKitAvatarGrantInput as am, type UseRealtimeSessionInput as an, type UseSessionLifecycleInput as ao, type VoiceSpec as ap, type VoiceSpecInput as aq, capacityErrorFromBusy as ar, capacityStateFromGrant as as, createProxyClient as at, isNativeLiveTrackSubscribed as au, knownBehaviorStates as av, mapTurnState as aw, readInboundRtp as ax, sessionBehaviorSchema as ay, sessionClipSchema as az, type AdaptivePlayoutDecision as b, type AdaptivePlayoutOptions as c, type AdaptivePlayoutSample as d, type ApproachingEndEvent as e, type ApproachingEndReason as f, type AvatarConnectionDetails as g, type AvatarSessionClient as h, type CallTranscriptSegment as i, type CartesiaTtsModel as j, type ClipResult as k, type ClosingTurnResult as l, type CreditsLowEvent as m, DEFAULT_CREDITS_LOW_LEAD_SECONDS as n, DEFAULT_GOVERNOR_CONFIG as o, DEFAULT_GRACE_CEILING_SECONDS as p, DEFAULT_GRACE_WINDOW_LEAD_SECONDS as q, DEFAULT_IDLE_SECONDS as r, DEFAULT_IDLE_WARN_LEAD_SECONDS as s, DEFAULT_TURN_TIMEOUT_SECONDS as t, type EndedEvent as u, type ExtendResult as v, type FreezeReadingFn as w, type GovernorAction as x, type GovernorConfig as y, type GovernorSignal as z };

package/dist/react-native.d.ts

@@ -1,8 +1,8 @@
 import { LiveKitRoomProps } from '@livekit/react-native';
 export { AudioSession, VideoTrack, VideoTrackProps, registerGlobals } from '@livekit/react-native';
+import { L as LiveKitSessionGrant, A as AvatarVideoFit } from './proxy-client-DpMcj6fI.js';
+export { a as AdaptivePlayoutController, b as AdaptivePlayoutDecision, c as AdaptivePlayoutOptions, d as AdaptivePlayoutSample, e as ApproachingEndEvent, f as ApproachingEndReason, g as AvatarConnectionDetails, h as AvatarSessionClient, B as BehaviorSnapshot, C as CallTranscript, i as CallTranscriptSegment, j as CartesiaTtsModel, k as ClipResult, l as ClosingTurnResult, m as CreditsLowEvent, D as DEFAULT_APPROACHING_END_LEAD_SECONDS, n as DEFAULT_CREDITS_LOW_LEAD_SECONDS, o as DEFAULT_GOVERNOR_CONFIG, p as DEFAULT_GRACE_CEILING_SECONDS, q as DEFAULT_GRACE_WINDOW_LEAD_SECONDS, r as DEFAULT_IDLE_SECONDS, s as DEFAULT_IDLE_WARN_LEAD_SECONDS, t as DEFAULT_TURN_TIMEOUT_SECONDS, E as EndReason, u as EndedEvent, v as ExtendResult, F as FishTtsModel, w as FreezeReadingFn, G as Governor, x as GovernorAction, y as GovernorConfig, z as GovernorSignal, H as GovernorState, I as GraceWindowClosedEvent, J as GraceWindowOpenEvent, K as GraceWindowState, M as IdleWarningEvent, N as InboundRtpCursor, O as InboundRtpReading, P as KnownBehaviorState, Q as LLMProvider, R as LLMSelection, S as LiveKitAvatarGrantState, T as LiveKitAvatarGrantStatus, U as LiveKitCapacityState, V as LiveKitConnectionStatus, W as LiveKitSessionRequest, X as LiveKitSessionStartResult, Y as MAX_RECONNECT_ATTEMPTS, Z as MAX_SESSION_INSTRUCTIONS_CHARS, _ as ProxyClientOptions, $ as QualityCap, a0 as RECONNECT_BACKOFF_MS, a1 as RealtimeAvatarRequestOptions, a2 as RealtimeSessionApi, a3 as RealtimeSessionMedia, a4 as RealtimeSessionRoomSinks, a5 as ReconnectPolicy, a6 as ReconnectingEvent, a7 as RecoveryState, a8 as RetryStep, a9 as SessionBehavior, aa as SessionClip, ab as SessionClocks, ac as SessionEndReason, ad as SessionLifecycleApi, ae as SessionLifecyclePhase, af as SessionLifecyclePhaseKind, ag as SessionLifecycleRoomBridge, ah as SessionLifecycleRoomBridgeProps, ai as SurfaceLayers, aj as TurnState, ak as TurnTimeoutEvent, al as UseAvatarQualityGovernorInput, am as UseLiveKitAvatarGrantInput, an as UseRealtimeSessionInput, ao as UseSessionLifecycleInput, ap as VoiceSpec, aq as VoiceSpecInput, ar as capacityErrorFromBusy, as as capacityStateFromGrant, at as createProxyClient, au as isNativeLiveTrackSubscribed, av as knownBehaviorStates, aw as mapTurnState, ax as readInboundRtp, ay as sessionBehaviorSchema, az as sessionClipSchema, aA as splitCallTranscript, aB as useAvatarAdaptivePlayoutDelay, aC as useAvatarCamera, aD as useAvatarPlayoutDelay, aE as useAvatarQualityGovernor, aF as useCallTranscript, aG as useLiveKitAvatarGrant, aH as useLiveTrackProducing, aI as useMicLease, aJ as useRealtimeSession, aK as useReleaseMicLeaseOnTrackEnded, aL as useSessionLifecycle } from './proxy-client-DpMcj6fI.js';
 import { ReactNode, ReactElement } from 'react';
-import { L as LiveKitSessionGrant, A as AvatarVideoFit } from './proxy-client-w6prrzGW.js';
-export { a as AdaptivePlayoutController, b as AdaptivePlayoutDecision, c as AdaptivePlayoutOptions, d as AdaptivePlayoutSample, e as ApproachingEndEvent, f as ApproachingEndReason, g as AvatarConnectionDetails, h as AvatarSessionClient, B as BehaviorSnapshot, C as CallTranscript, i as CallTranscriptSegment, j as CartesiaTtsModel, k as ClipResult, l as ClosingTurnResult, m as CreditsLowEvent, D as DEFAULT_APPROACHING_END_LEAD_SECONDS, n as DEFAULT_CREDITS_LOW_LEAD_SECONDS, o as DEFAULT_GOVERNOR_CONFIG, p as DEFAULT_GRACE_CEILING_SECONDS, q as DEFAULT_GRACE_WINDOW_LEAD_SECONDS, r as DEFAULT_IDLE_SECONDS, s as DEFAULT_IDLE_WARN_LEAD_SECONDS, t as DEFAULT_TURN_TIMEOUT_SECONDS, E as EndReason, u as EndedEvent, v as ExtendResult, F as FishTtsModel, w as FreezeReadingFn, G as Governor, x as GovernorAction, y as GovernorConfig, z as GovernorSignal, H as GovernorState, I as GraceWindowClosedEvent, J as GraceWindowOpenEvent, K as GraceWindowState, M as IdleWarningEvent, N as InboundRtpCursor, O as InboundRtpReading, P as KnownBehaviorState, Q as LLMProvider, R as LLMSelection, S as LiveKitAvatarGrantState, T as LiveKitAvatarGrantStatus, U as LiveKitCapacityState, V as LiveKitConnectionStatus, W as LiveKitSessionRequest, X as LiveKitSessionStartResult, Y as MAX_RECONNECT_ATTEMPTS, Z as MAX_SESSION_INSTRUCTIONS_CHARS, _ as ProxyClientOptions, $ as QualityCap, a0 as RECONNECT_BACKOFF_MS, a1 as RealtimeAvatarRequestOptions, a2 as RealtimeSessionApi, a3 as RealtimeSessionMedia, a4 as RealtimeSessionRoomSinks, a5 as ReconnectPolicy, a6 as ReconnectingEvent, a7 as RecoveryState, a8 as RetryStep, a9 as SessionBehavior, aa as SessionClip, ab as SessionClocks, ac as SessionEndReason, ad as SessionLifecycleApi, ae as SessionLifecyclePhase, af as SessionLifecyclePhaseKind, ag as SessionLifecycleRoomBridge, ah as SessionLifecycleRoomBridgeProps, ai as SurfaceLayers, aj as TurnState, ak as TurnTimeoutEvent, al as UseAvatarQualityGovernorInput, am as UseLiveKitAvatarGrantInput, an as UseRealtimeSessionInput, ao as UseSessionLifecycleInput, ap as VoiceSpec, aq as VoiceSpecInput, ar as capacityErrorFromBusy, as as capacityStateFromGrant, at as createProxyClient, au as isNativeLiveTrackSubscribed, av as knownBehaviorStates, aw as mapTurnState, ax as readInboundRtp, ay as sessionBehaviorSchema, az as sessionClipSchema, aA as splitCallTranscript, aB as useAvatarAdaptivePlayoutDelay, aC as useAvatarPlayoutDelay, aD as useAvatarQualityGovernor, aE as useCallTranscript, aF as useLiveKitAvatarGrant, aG as useLiveTrackProducing, aH as useMicLease, aI as useRealtimeSession, aJ as useReleaseMicLeaseOnTrackEnded, aK as useSessionLifecycle } from './proxy-client-w6prrzGW.js';
 import { StyleProp, ViewStyle } from 'react-native';
 export { useChat, useConnectionState, useLocalParticipant, useRoomContext, useTrackToggle, useTranscriptions, useVoiceAssistant } from '@livekit/components-react';
 export { D as DEFAULT_AVATAR_PLAYOUT_DELAY_SECONDS } from './playout-delay-DWOc8iCl.js';

package/dist/react-native.js

@@ -1,14 +1,155 @@
 import { AudioSession, LiveKitRoom, VideoTrack } from '@livekit/react-native';
 export { AudioSession, VideoTrack, registerGlobals } from '@livekit/react-native';
-import { useEffect, createElement, useRef, useState, useCallback, useMemo } from 'react';
-import { useTranscriptions, useLocalParticipant, useMaybeRoomContext, useVoiceAssistant, useConnectionState, isTrackReference, useRoomContext, useChat } from '@livekit/components-react';
+import { useState, useRef, useEffect, useCallback, createElement, useMemo } from 'react';
+import { useLocalParticipant, useConnectionState, useTranscriptions, useMaybeRoomContext, useVoiceAssistant, isTrackReference, useRoomContext, useChat } from '@livekit/components-react';
 export { useChat, useConnectionState, useLocalParticipant, useRoomContext, useTrackToggle, useTranscriptions, useVoiceAssistant } from '@livekit/components-react';
-import { isRemoteTrack, VideoQuality, ConnectionQuality, RoomEvent, TrackEvent, ConnectionState, Track, ConnectionError, ConnectionErrorReason, DisconnectReason, Room } from 'livekit-client';
+import { ConnectionState, isRemoteTrack, VideoQuality, ConnectionQuality, RoomEvent, TrackEvent, Track, ConnectionError, ConnectionErrorReason, DisconnectReason, createLocalVideoTrack, Room } from 'livekit-client';
 export { DisconnectReason, Room, RoomEvent, Track } from 'livekit-client';
 import { Platform, StyleSheet, Animated, Image, View, Text } from 'react-native';
 import { z } from 'zod';
 
 // ../client/src/react-native/index.ts
+
+// ../client/src/camera.ts
+function defaultCameraCaptureOptions() {
+  return { resolution: { width: 640, height: 360, frameRate: 5 }, facingMode: "user" };
+}
+function cameraPublishOptions(grant, video) {
+  if (grant?.camera !== true) return false;
+  return video === true ? defaultCameraCaptureOptions() : video;
+}
+function createCameraControl(driver) {
+  let desired = false;
+  let disposed = false;
+  let generation = 0;
+  let current = null;
+  let opening = null;
+  let closing = Promise.resolve();
+  const retire = (track) => {
+    let stopFailure;
+    try {
+      track.stop();
+    } catch (cause) {
+      stopFailure = new Error("Camera capture could not stop", { cause });
+    }
+    const operation = closing.then(async () => {
+      await driver.unpublish(track);
+      if (stopFailure) throw stopFailure;
+    });
+    closing = operation.catch(() => {
+    });
+    return operation;
+  };
+  async function setEnabled(enabled) {
+    desired = enabled && !disposed;
+    if (!desired) {
+      generation += 1;
+      const track = current;
+      current = null;
+      if (track) await retire(track);
+      return;
+    }
+    if (opening) {
+      await opening;
+      if (desired && !disposed && !current) await setEnabled(true);
+      return;
+    }
+    if (current) return;
+    const attempt = generation;
+    driver.onPending(true);
+    opening = Promise.resolve().then(async () => {
+      await closing;
+      if (!desired || disposed || attempt !== generation) return;
+      const track = await driver.capture(defaultCameraCaptureOptions());
+      if (!desired || disposed || attempt !== generation) {
+        track.stop();
+        return;
+      }
+      current = track;
+      try {
+        await driver.publish(track);
+      } catch (error) {
+        if (current === track) current = null;
+        await retire(track);
+        throw error;
+      }
+      if (!desired || disposed || attempt !== generation) {
+        if (current === track) current = null;
+        await retire(track);
+      }
+    }).finally(() => {
+      opening = null;
+      driver.onPending(false);
+    });
+    return opening;
+  }
+  return {
+    get pending() {
+      return opening !== null;
+    },
+    setEnabled,
+    async close() {
+      disposed = true;
+      await setEnabled(false);
+    }
+  };
+}
+
+// ../client/src/react/use-avatar-camera.ts
+function useAvatarCamera({ allowed, active = true }) {
+  const { localParticipant, cameraTrack, isCameraEnabled } = useLocalParticipant();
+  const connection = useConnectionState();
+  const [pending, setPending] = useState(false);
+  const [error, setError] = useState(null);
+  const control = useRef(null);
+  const available = allowed && active && connection === ConnectionState.Connected;
+  useEffect(() => {
+    let alive = true;
+    const current = createCameraControl({
+      capture: createLocalVideoTrack,
+      publish: (track) => localParticipant.publishTrack(track, { source: Track.Source.Camera }),
+      unpublish: (track) => localParticipant.unpublishTrack(track, true),
+      onPending: (value) => {
+        if (alive) setPending(value);
+      }
+    });
+    control.current = current;
+    return () => {
+      alive = false;
+      control.current = null;
+      void current.close().catch(() => {
+      });
+    };
+  }, [localParticipant]);
+  const setEnabled = useCallback(async (enabled) => {
+    const current = control.current;
+    if (!current) return;
+    setError(null);
+    try {
+      await current.setEnabled(enabled && available);
+    } catch (failure) {
+      if (control.current !== current) return;
+      setError(failure instanceof Error && failure.name === "NotAllowedError" ? "permission_denied" : "unavailable");
+    }
+  }, [available]);
+  useEffect(() => {
+    if (!available) void setEnabled(false);
+  }, [available, setEnabled]);
+  const toggle = useCallback(
+    () => setEnabled(!isCameraEnabled && !control.current?.pending),
+    [isCameraEnabled, setEnabled]
+  );
+  return {
+    enabled: isCameraEnabled,
+    pending,
+    error,
+    available,
+    toggle,
+    setEnabled,
+    publication: cameraTrack,
+    participant: localParticipant
+  };
+}
 function useRealtimeAvatarAudioSession(enabled) {
   useEffect(() => {
     if (!enabled) return;
@@ -40,7 +181,7 @@ function RealtimeAvatarLiveKitRoom(props) {
       token: grant?.participant_token,
       connect: shouldConnect,
       audio: audio ?? grant?.stt_mode === "server",
-      video,
+      video: cameraPublishOptions(grant, video),
       options: roomOptions
     },
     children
@@ -1482,7 +1623,7 @@ z.object({
   expiresAt: z.string().datetime({ offset: true })
 }).strict();
 var ConnectionQuality2 = { Excellent: "excellent", Good: "good", Poor: "poor", Lost: "lost", Unknown: "unknown" };
-var ConnectionState4 = { Disconnected: "disconnected", Connecting: "connecting", Connected: "connected", Reconnecting: "reconnecting", SignalReconnecting: "signalReconnecting" };
+var ConnectionState5 = { Disconnected: "disconnected", Connecting: "connecting", Connected: "connected", Reconnecting: "reconnecting", SignalReconnecting: "signalReconnecting" };
 var MAX_CONNECTION_HISTORY_OBSERVATIONS = 240;
 var MAX_CONNECTION_HISTORY_BATCH = 32;
 var quality = z.enum(ConnectionQuality2);
@@ -1490,7 +1631,7 @@ var connectionHistoryObservationSchema = z.object({
   sequence: z.number().int().min(1).max(MAX_CONNECTION_HISTORY_OBSERVATIONS),
   elapsedMs: z.number().int().min(0).max(864e5),
   clientObservedAt: z.string().datetime({ offset: true }).nullable(),
-  connectionState: z.enum(ConnectionState4),
+  connectionState: z.enum(ConnectionState5),
   localQuality: quality,
   audioQuality: quality.nullable(),
   videoQuality: quality.nullable()
@@ -1657,6 +1798,7 @@ z.object({
   source_kind: avatarSourceKindSchema.default("portrait"),
   source_video_url: nullableUrlSchema.optional(),
   stt_mode: liveKitSttModeSchema.default("server"),
+  camera: z.boolean().optional(),
   video_cache_id: z.string().min(1).max(240).nullable().optional(),
   voice: voiceSpecSchema.nullable().optional(),
   voice_id: z.string().min(1).max(240).nullable().optional(),
@@ -1729,6 +1871,7 @@ z.object({
   queueTicketId: z.string().min(1).max(160).optional(),
   roomName: z.string().min(1).max(160).optional(),
   sttMode: liveKitSttModeSchema.default("server"),
+  camera: z.boolean().optional(),
   voice: voiceSpecSchema.nullable().optional(),
   voiceId: z.string().min(1).max(240).nullable().optional(),
   // Unbounded, for the same reason as `clip_library` on the wire schema above.
@@ -1751,6 +1894,7 @@ z.object({
   participant_identity: z.string().min(1),
   reservation_expires_at: z.string().datetime({ offset: true }),
   stt_mode: liveKitSttModeSchema.default("server"),
+  camera: z.boolean().optional(),
   room_created: z.boolean().default(false),
   dispatch_created: z.boolean().default(false),
   join_timeout_seconds: z.number().int().nonnegative().default(0),
@@ -3105,4 +3249,4 @@ function createProxyClient(options) {
   };
 }
 
-export { AdaptivePlayoutController, AvatarVideoSurface, DEFAULT_APPROACHING_END_LEAD_SECONDS, DEFAULT_AVATAR_PLAYOUT_DELAY_SECONDS, DEFAULT_CREDITS_LOW_LEAD_SECONDS, DEFAULT_GOVERNOR_CONFIG, DEFAULT_GRACE_CEILING_SECONDS, DEFAULT_GRACE_WINDOW_LEAD_SECONDS, DEFAULT_IDLE_SECONDS, DEFAULT_IDLE_WARN_LEAD_SECONDS, DEFAULT_TURN_TIMEOUT_SECONDS, MAX_RECONNECT_ATTEMPTS, MAX_SESSION_INSTRUCTIONS_CHARS, RECONNECT_BACKOFF_MS, RealtimeAvatarLiveKitRoom, SessionLifecycleRoomBridge, capacityErrorFromBusy, capacityStateFromGrant, createProxyClient, isNativeLiveTrackSubscribed, knownBehaviorStates, mapTurnState, readInboundRtp, sessionBehaviorSchema, sessionClipSchema, splitCallTranscript, useAvatarAdaptivePlayoutDelay, useAvatarPlayoutDelay, useAvatarQualityGovernor, useCallTranscript, useLiveKitAvatarGrant, useLiveTrackProducing, useMicLease, useRealtimeAvatarAudioSession, useRealtimeSession, useReleaseMicLeaseOnTrackEnded, useSessionLifecycle };
+export { AdaptivePlayoutController, AvatarVideoSurface, DEFAULT_APPROACHING_END_LEAD_SECONDS, DEFAULT_AVATAR_PLAYOUT_DELAY_SECONDS, DEFAULT_CREDITS_LOW_LEAD_SECONDS, DEFAULT_GOVERNOR_CONFIG, DEFAULT_GRACE_CEILING_SECONDS, DEFAULT_GRACE_WINDOW_LEAD_SECONDS, DEFAULT_IDLE_SECONDS, DEFAULT_IDLE_WARN_LEAD_SECONDS, DEFAULT_TURN_TIMEOUT_SECONDS, MAX_RECONNECT_ATTEMPTS, MAX_SESSION_INSTRUCTIONS_CHARS, RECONNECT_BACKOFF_MS, RealtimeAvatarLiveKitRoom, SessionLifecycleRoomBridge, capacityErrorFromBusy, capacityStateFromGrant, createProxyClient, isNativeLiveTrackSubscribed, knownBehaviorStates, mapTurnState, readInboundRtp, sessionBehaviorSchema, sessionClipSchema, splitCallTranscript, useAvatarAdaptivePlayoutDelay, useAvatarCamera, useAvatarPlayoutDelay, useAvatarQualityGovernor, useCallTranscript, useLiveKitAvatarGrant, useLiveTrackProducing, useMicLease, useRealtimeAvatarAudioSession, useRealtimeSession, useReleaseMicLeaseOnTrackEnded, useSessionLifecycle };

package/dist/react.d.ts

@@ -1,11 +1,11 @@
 import { RegisteredTool, ToolRegistration } from './tools.js';
+import { ah as SessionLifecycleRoomBridgeProps, h as AvatarSessionClient, A as AvatarVideoFit } from './proxy-client-DpMcj6fI.js';
+export { a as AdaptivePlayoutController, b as AdaptivePlayoutDecision, c as AdaptivePlayoutOptions, d as AdaptivePlayoutSample, e as ApproachingEndEvent, f as ApproachingEndReason, g as AvatarConnectionDetails, aM as AvatarVideoSurface, aN as AvatarVideoSurfaceProps, B as BehaviorSnapshot, C as CallTranscript, i as CallTranscriptSegment, j as CartesiaTtsModel, k as ClipResult, l as ClosingTurnResult, m as CreditsLowEvent, D as DEFAULT_APPROACHING_END_LEAD_SECONDS, n as DEFAULT_CREDITS_LOW_LEAD_SECONDS, o as DEFAULT_GOVERNOR_CONFIG, p as DEFAULT_GRACE_CEILING_SECONDS, q as DEFAULT_GRACE_WINDOW_LEAD_SECONDS, r as DEFAULT_IDLE_SECONDS, s as DEFAULT_IDLE_WARN_LEAD_SECONDS, t as DEFAULT_TURN_TIMEOUT_SECONDS, E as EndReason, u as EndedEvent, v as ExtendResult, F as FishTtsModel, w as FreezeReadingFn, G as Governor, x as GovernorAction, y as GovernorConfig, z as GovernorSignal, H as GovernorState, I as GraceWindowClosedEvent, J as GraceWindowOpenEvent, K as GraceWindowState, M as IdleWarningEvent, N as InboundRtpCursor, O as InboundRtpReading, P as KnownBehaviorState, Q as LLMProvider, R as LLMSelection, S as LiveKitAvatarGrantState, T as LiveKitAvatarGrantStatus, U as LiveKitCapacityState, V as LiveKitConnectionStatus, W as LiveKitSessionRequest, X as LiveKitSessionStartResult, aO as LivePlaybackKeeper, Y as MAX_RECONNECT_ATTEMPTS, Z as MAX_SESSION_INSTRUCTIONS_CHARS, aP as MIC_LEASE_ENDED_TIMEOUT_MS, aQ as MicLease, aR as NETWORK_QUALITY_POLICY, aS as NetworkQualityStatus, aT as PlayableVideoElement, _ as ProxyClientOptions, $ as QualityCap, a0 as RECONNECT_BACKOFF_MS, aU as RealtimeAvatarCapacityError, aV as RealtimeAvatarLiveKitRoom, aW as RealtimeAvatarLiveKitRoomProps, a1 as RealtimeAvatarRequestOptions, a2 as RealtimeSessionApi, a3 as RealtimeSessionMedia, a4 as RealtimeSessionRoomSinks, a5 as ReconnectPolicy, a6 as ReconnectingEvent, a7 as RecoveryState, a8 as RetryStep, a9 as SessionBehavior, aa as SessionClip, ab as SessionClocks, ac as SessionEndReason, ad as SessionLifecycleApi, ae as SessionLifecyclePhase, af as SessionLifecyclePhaseKind, ag as SessionLifecycleRoomBridge, ai as SurfaceLayers, aj as TurnState, ak as TurnTimeoutEvent, al as UseAvatarQualityGovernorInput, am as UseLiveKitAvatarGrantInput, an as UseRealtimeSessionInput, ao as UseSessionLifecycleInput, ap as VoiceSpec, aq as VoiceSpecInput, ar as capacityErrorFromBusy, as as capacityStateFromGrant, at as createProxyClient, av as knownBehaviorStates, aw as mapTurnState, ax as readInboundRtp, ay as sessionBehaviorSchema, az as sessionClipSchema, aX as shouldReplayPendingTurn, aA as splitCallTranscript, aB as useAvatarAdaptivePlayoutDelay, aC as useAvatarCamera, aD as useAvatarPlayoutDelay, aE as useAvatarQualityGovernor, aF as useCallTranscript, aG as useLiveKitAvatarGrant, aI as useMicLease, aJ as useRealtimeSession, aK as useReleaseMicLeaseOnTrackEnded, aL as useSessionLifecycle } from './proxy-client-DpMcj6fI.js';
 import { ReactNode } from 'react';
-import { ah as SessionLifecycleRoomBridgeProps, h as AvatarSessionClient, A as AvatarVideoFit } from './proxy-client-w6prrzGW.js';
-export { a as AdaptivePlayoutController, b as AdaptivePlayoutDecision, c as AdaptivePlayoutOptions, d as AdaptivePlayoutSample, e as ApproachingEndEvent, f as ApproachingEndReason, g as AvatarConnectionDetails, aL as AvatarVideoSurface, aM as AvatarVideoSurfaceProps, B as BehaviorSnapshot, C as CallTranscript, i as CallTranscriptSegment, j as CartesiaTtsModel, k as ClipResult, l as ClosingTurnResult, m as CreditsLowEvent, D as DEFAULT_APPROACHING_END_LEAD_SECONDS, n as DEFAULT_CREDITS_LOW_LEAD_SECONDS, o as DEFAULT_GOVERNOR_CONFIG, p as DEFAULT_GRACE_CEILING_SECONDS, q as DEFAULT_GRACE_WINDOW_LEAD_SECONDS, r as DEFAULT_IDLE_SECONDS, s as DEFAULT_IDLE_WARN_LEAD_SECONDS, t as DEFAULT_TURN_TIMEOUT_SECONDS, E as EndReason, u as EndedEvent, v as ExtendResult, F as FishTtsModel, w as FreezeReadingFn, G as Governor, x as GovernorAction, y as GovernorConfig, z as GovernorSignal, H as GovernorState, I as GraceWindowClosedEvent, J as GraceWindowOpenEvent, K as GraceWindowState, M as IdleWarningEvent, N as InboundRtpCursor, O as InboundRtpReading, P as KnownBehaviorState, Q as LLMProvider, R as LLMSelection, S as LiveKitAvatarGrantState, T as LiveKitAvatarGrantStatus, U as LiveKitCapacityState, V as LiveKitConnectionStatus, W as LiveKitSessionRequest, X as LiveKitSessionStartResult, aN as LivePlaybackKeeper, Y as MAX_RECONNECT_ATTEMPTS, Z as MAX_SESSION_INSTRUCTIONS_CHARS, aO as MIC_LEASE_ENDED_TIMEOUT_MS, aP as MicLease, aQ as NETWORK_QUALITY_POLICY, aR as NetworkQualityStatus, aS as PlayableVideoElement, _ as ProxyClientOptions, $ as QualityCap, a0 as RECONNECT_BACKOFF_MS, aT as RealtimeAvatarCapacityError, aU as RealtimeAvatarLiveKitRoom, aV as RealtimeAvatarLiveKitRoomProps, a1 as RealtimeAvatarRequestOptions, a2 as RealtimeSessionApi, a3 as RealtimeSessionMedia, a4 as RealtimeSessionRoomSinks, a5 as ReconnectPolicy, a6 as ReconnectingEvent, a7 as RecoveryState, a8 as RetryStep, a9 as SessionBehavior, aa as SessionClip, ab as SessionClocks, ac as SessionEndReason, ad as SessionLifecycleApi, ae as SessionLifecyclePhase, af as SessionLifecyclePhaseKind, ag as SessionLifecycleRoomBridge, ai as SurfaceLayers, aj as TurnState, ak as TurnTimeoutEvent, al as UseAvatarQualityGovernorInput, am as UseLiveKitAvatarGrantInput, an as UseRealtimeSessionInput, ao as UseSessionLifecycleInput, ap as VoiceSpec, aq as VoiceSpecInput, ar as capacityErrorFromBusy, as as capacityStateFromGrant, at as createProxyClient, av as knownBehaviorStates, aw as mapTurnState, ax as readInboundRtp, ay as sessionBehaviorSchema, az as sessionClipSchema, aW as shouldReplayPendingTurn, aA as splitCallTranscript, aB as useAvatarAdaptivePlayoutDelay, aC as useAvatarPlayoutDelay, aD as useAvatarQualityGovernor, aE as useCallTranscript, aF as useLiveKitAvatarGrant, aH as useMicLease, aI as useRealtimeSession, aJ as useReleaseMicLeaseOnTrackEnded, aK as useSessionLifecycle } from './proxy-client-w6prrzGW.js';
 export { D as DEFAULT_AVATAR_PLAYOUT_DELAY_SECONDS } from './playout-delay-DWOc8iCl.js';
 import 'zod';
-import '@livekit/components-react';
 import 'livekit-client';
+import '@livekit/components-react';
 
 /**
  * Once a link has proven unstable, hold the frozen live frame this long before

package/dist/react.js

@@ -1,7 +1,7 @@
 "use client";
 import { useRef, useState, useEffect, useCallback, useMemo, createElement, Fragment } from 'react';
-import { useRoomContext, useConnectionState, useTranscriptions, useLocalParticipant, RoomAudioRenderer, LiveKitRoom, useMaybeRoomContext, useVoiceAssistant, VideoTrack, useChat } from '@livekit/components-react';
-import { ConnectionState, isRemoteTrack, VideoQuality, ConnectionQuality, RoomEvent, TrackEvent, Track, ConnectionError, ConnectionErrorReason, DisconnectReason, Room } from 'livekit-client';
+import { useRoomContext, useConnectionState, useLocalParticipant, useTranscriptions, RoomAudioRenderer, LiveKitRoom, useMaybeRoomContext, useVoiceAssistant, VideoTrack, useChat } from '@livekit/components-react';
+import { ConnectionState, isRemoteTrack, VideoQuality, ConnectionQuality, RoomEvent, TrackEvent, Track, ConnectionError, ConnectionErrorReason, DisconnectReason, createLocalVideoTrack, Room } from 'livekit-client';
 import { z } from 'zod';
 
 // ../client/src/react/use-character-tools.ts
@@ -199,6 +199,147 @@ function useCharacterTools(tools, options = {}) {
   }, [room, tools, connection]);
   return state;
 }
+
+// ../client/src/camera.ts
+function defaultCameraCaptureOptions() {
+  return { resolution: { width: 640, height: 360, frameRate: 5 }, facingMode: "user" };
+}
+function cameraPublishOptions(grant, video) {
+  if (grant?.camera !== true) return false;
+  return video === true ? defaultCameraCaptureOptions() : video;
+}
+function createCameraControl(driver) {
+  let desired = false;
+  let disposed = false;
+  let generation = 0;
+  let current = null;
+  let opening = null;
+  let closing = Promise.resolve();
+  const retire = (track) => {
+    let stopFailure;
+    try {
+      track.stop();
+    } catch (cause) {
+      stopFailure = new Error("Camera capture could not stop", { cause });
+    }
+    const operation = closing.then(async () => {
+      await driver.unpublish(track);
+      if (stopFailure) throw stopFailure;
+    });
+    closing = operation.catch(() => {
+    });
+    return operation;
+  };
+  async function setEnabled(enabled) {
+    desired = enabled && !disposed;
+    if (!desired) {
+      generation += 1;
+      const track = current;
+      current = null;
+      if (track) await retire(track);
+      return;
+    }
+    if (opening) {
+      await opening;
+      if (desired && !disposed && !current) await setEnabled(true);
+      return;
+    }
+    if (current) return;
+    const attempt = generation;
+    driver.onPending(true);
+    opening = Promise.resolve().then(async () => {
+      await closing;
+      if (!desired || disposed || attempt !== generation) return;
+      const track = await driver.capture(defaultCameraCaptureOptions());
+      if (!desired || disposed || attempt !== generation) {
+        track.stop();
+        return;
+      }
+      current = track;
+      try {
+        await driver.publish(track);
+      } catch (error) {
+        if (current === track) current = null;
+        await retire(track);
+        throw error;
+      }
+      if (!desired || disposed || attempt !== generation) {
+        if (current === track) current = null;
+        await retire(track);
+      }
+    }).finally(() => {
+      opening = null;
+      driver.onPending(false);
+    });
+    return opening;
+  }
+  return {
+    get pending() {
+      return opening !== null;
+    },
+    setEnabled,
+    async close() {
+      disposed = true;
+      await setEnabled(false);
+    }
+  };
+}
+
+// ../client/src/react/use-avatar-camera.ts
+function useAvatarCamera({ allowed, active = true }) {
+  const { localParticipant, cameraTrack, isCameraEnabled } = useLocalParticipant();
+  const connection = useConnectionState();
+  const [pending, setPending] = useState(false);
+  const [error, setError] = useState(null);
+  const control = useRef(null);
+  const available = allowed && active && connection === ConnectionState.Connected;
+  useEffect(() => {
+    let alive = true;
+    const current = createCameraControl({
+      capture: createLocalVideoTrack,
+      publish: (track) => localParticipant.publishTrack(track, { source: Track.Source.Camera }),
+      unpublish: (track) => localParticipant.unpublishTrack(track, true),
+      onPending: (value) => {
+        if (alive) setPending(value);
+      }
+    });
+    control.current = current;
+    return () => {
+      alive = false;
+      control.current = null;
+      void current.close().catch(() => {
+      });
+    };
+  }, [localParticipant]);
+  const setEnabled = useCallback(async (enabled) => {
+    const current = control.current;
+    if (!current) return;
+    setError(null);
+    try {
+      await current.setEnabled(enabled && available);
+    } catch (failure) {
+      if (control.current !== current) return;
+      setError(failure instanceof Error && failure.name === "NotAllowedError" ? "permission_denied" : "unavailable");
+    }
+  }, [available]);
+  useEffect(() => {
+    if (!available) void setEnabled(false);
+  }, [available, setEnabled]);
+  const toggle = useCallback(
+    () => setEnabled(!isCameraEnabled && !control.current?.pending),
+    [isCameraEnabled, setEnabled]
+  );
+  return {
+    enabled: isCameraEnabled,
+    pending,
+    error,
+    available,
+    toggle,
+    setEnabled,
+    publication: cameraTrack,
+    participant: localParticipant
+  };
+}
 var holder = null;
 var queue = [];
 var pendingEnded = null;
@@ -846,7 +987,7 @@ function RealtimeAvatarLiveKitRoom(props) {
       token: grant?.participant_token,
       connect: shouldConnect,
       audio: audio ?? grant?.stt_mode === "server",
-      video,
+      video: cameraPublishOptions(grant, video),
       options: roomOptions
     },
     createElement(Fragment, null, cushion, children, roomAudio)
@@ -2016,7 +2157,7 @@ z.object({
   expiresAt: z.string().datetime({ offset: true })
 }).strict();
 var ConnectionQuality2 = { Excellent: "excellent", Good: "good", Poor: "poor", Lost: "lost", Unknown: "unknown" };
-var ConnectionState4 = { Disconnected: "disconnected", Connecting: "connecting", Connected: "connected", Reconnecting: "reconnecting", SignalReconnecting: "signalReconnecting" };
+var ConnectionState5 = { Disconnected: "disconnected", Connecting: "connecting", Connected: "connected", Reconnecting: "reconnecting", SignalReconnecting: "signalReconnecting" };
 var MAX_CONNECTION_HISTORY_OBSERVATIONS = 240;
 var MAX_CONNECTION_HISTORY_BATCH = 32;
 var quality = z.enum(ConnectionQuality2);
@@ -2024,7 +2165,7 @@ var connectionHistoryObservationSchema = z.object({
   sequence: z.number().int().min(1).max(MAX_CONNECTION_HISTORY_OBSERVATIONS),
   elapsedMs: z.number().int().min(0).max(864e5),
   clientObservedAt: z.string().datetime({ offset: true }).nullable(),
-  connectionState: z.enum(ConnectionState4),
+  connectionState: z.enum(ConnectionState5),
   localQuality: quality,
   audioQuality: quality.nullable(),
   videoQuality: quality.nullable()
@@ -2191,6 +2332,7 @@ z.object({
   source_kind: avatarSourceKindSchema.default("portrait"),
   source_video_url: nullableUrlSchema.optional(),
   stt_mode: liveKitSttModeSchema.default("server"),
+  camera: z.boolean().optional(),
   video_cache_id: z.string().min(1).max(240).nullable().optional(),
   voice: voiceSpecSchema.nullable().optional(),
   voice_id: z.string().min(1).max(240).nullable().optional(),
@@ -2263,6 +2405,7 @@ z.object({
   queueTicketId: z.string().min(1).max(160).optional(),
   roomName: z.string().min(1).max(160).optional(),
   sttMode: liveKitSttModeSchema.default("server"),
+  camera: z.boolean().optional(),
   voice: voiceSpecSchema.nullable().optional(),
   voiceId: z.string().min(1).max(240).nullable().optional(),
   // Unbounded, for the same reason as `clip_library` on the wire schema above.
@@ -2285,6 +2428,7 @@ z.object({
   participant_identity: z.string().min(1),
   reservation_expires_at: z.string().datetime({ offset: true }),
   stt_mode: liveKitSttModeSchema.default("server"),
+  camera: z.boolean().optional(),
   room_created: z.boolean().default(false),
   dispatch_created: z.boolean().default(false),
   join_timeout_seconds: z.number().int().nonnegative().default(0),
@@ -3730,4 +3874,4 @@ function createProxyClient(options) {
   };
 }
 
-export { AdaptivePlayoutController, AvatarCall, AvatarVideoSurface, DEFAULT_APPROACHING_END_LEAD_SECONDS, DEFAULT_AVATAR_PLAYOUT_DELAY_SECONDS, DEFAULT_AVATAR_UNSTABLE_STALL_MS, DEFAULT_CREDITS_LOW_LEAD_SECONDS, DEFAULT_GOVERNOR_CONFIG, DEFAULT_GRACE_CEILING_SECONDS, DEFAULT_GRACE_WINDOW_LEAD_SECONDS, DEFAULT_IDLE_SECONDS, DEFAULT_IDLE_WARN_LEAD_SECONDS, DEFAULT_TURN_TIMEOUT_SECONDS, MAX_RECONNECT_ATTEMPTS, MAX_SESSION_INSTRUCTIONS_CHARS, MIC_LEASE_ENDED_TIMEOUT_MS, NETWORK_QUALITY_POLICY, RECONNECT_BACKOFF_MS, RealtimeAvatarCapacityError, RealtimeAvatarLiveKitRoom, SessionLifecycleRoomBridge, capacityErrorFromBusy, capacityStateFromGrant, createProxyClient, knownBehaviorStates, mapTurnState, readInboundRtp, sessionBehaviorSchema, sessionClipSchema, shouldReplayPendingTurn, splitCallTranscript, useAvatarAdaptivePlayoutDelay, useAvatarCall, useAvatarPlayoutDelay, useAvatarQualityGovernor, useCallTranscript, useCharacterTools, useLiveKitAvatarGrant, useMicLease, useRealtimeSession, useReleaseMicLeaseOnTrackEnded, useSessionLifecycle };
+export { AdaptivePlayoutController, AvatarCall, AvatarVideoSurface, DEFAULT_APPROACHING_END_LEAD_SECONDS, DEFAULT_AVATAR_PLAYOUT_DELAY_SECONDS, DEFAULT_AVATAR_UNSTABLE_STALL_MS, DEFAULT_CREDITS_LOW_LEAD_SECONDS, DEFAULT_GOVERNOR_CONFIG, DEFAULT_GRACE_CEILING_SECONDS, DEFAULT_GRACE_WINDOW_LEAD_SECONDS, DEFAULT_IDLE_SECONDS, DEFAULT_IDLE_WARN_LEAD_SECONDS, DEFAULT_TURN_TIMEOUT_SECONDS, MAX_RECONNECT_ATTEMPTS, MAX_SESSION_INSTRUCTIONS_CHARS, MIC_LEASE_ENDED_TIMEOUT_MS, NETWORK_QUALITY_POLICY, RECONNECT_BACKOFF_MS, RealtimeAvatarCapacityError, RealtimeAvatarLiveKitRoom, SessionLifecycleRoomBridge, capacityErrorFromBusy, capacityStateFromGrant, createProxyClient, knownBehaviorStates, mapTurnState, readInboundRtp, sessionBehaviorSchema, sessionClipSchema, shouldReplayPendingTurn, splitCallTranscript, useAvatarAdaptivePlayoutDelay, useAvatarCall, useAvatarCamera, useAvatarPlayoutDelay, useAvatarQualityGovernor, useCallTranscript, useCharacterTools, useLiveKitAvatarGrant, useMicLease, useRealtimeSession, useReleaseMicLeaseOnTrackEnded, useSessionLifecycle };

package/dist/recording.d.ts

@@ -61,8 +61,8 @@ declare const recordingArtifactSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     retainedUntil: z.ZodString;
     status: z.ZodLiteral<"failed">;
     errorCode: z.ZodEnum<{
-        recording_unavailable: "recording_unavailable";
         recording_failed: "recording_failed";
+        recording_unavailable: "recording_unavailable";
     }>;
 }, z.core.$strict>], "status">;
 type RecordingArtifact = z.infer<typeof recordingArtifactSchema>;
@@ -118,8 +118,8 @@ declare const listRecordingsResponseSchema: z.ZodObject<{
         retainedUntil: z.ZodString;
         status: z.ZodLiteral<"failed">;
         errorCode: z.ZodEnum<{
-            recording_unavailable: "recording_unavailable";
             recording_failed: "recording_failed";
+            recording_unavailable: "recording_unavailable";
         }>;
     }, z.core.$strict>], "status">>;
     nextCursor: z.ZodNullable<z.ZodString>;

package/dist/server.d.ts

@@ -1,4 +1,4 @@
 export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, RealtimeAvatarOptions, StartCallOptions, clipLibraryDeclarationSchema, verifyTranscript } from './index.js';
-export { h as Asset, g as AssetKind, A as Avatar, o as AvatarClip, c as AvatarSourceSwap, b as AvatarUpdate, p as CallConnection, C as CallMode, a as CallPolicy, q as CallQueued, r as ClipDeclaration, f as ClipLibrary, d as ClipLibraryDeclaration, s as ClipLibraryPlan, e as ClipLibraryUpdate, t as ClipSource, u as ContextMessage, n as CreditBalance, E as EndCallOptions, v as EndCallReason, k as ListRecordingsQuery, l as ListRecordingsResponse, i as ListSessionsOptions, L as LoopRedirect, m as RecordingAccessResponse, R as RecordingArtifact, w as RecordingArtifactStatus, x as RecordingMode, S as StartCallResult, T as TranscriptPayload, j as UsageSession, U as UsageSessionPage, V as VideoPolicy, y as isQueued, z as listRecordingsResponseSchema, B as recordingAccessResponseSchema, D as recordingArtifactSchema, F as recordingModeSchema } from './types-CxkszIDK.js';
+export { h as Asset, g as AssetKind, A as Avatar, o as AvatarClip, c as AvatarSourceSwap, b as AvatarUpdate, p as CallConnection, C as CallMode, a as CallPolicy, q as CallQueued, r as ClipDeclaration, f as ClipLibrary, d as ClipLibraryDeclaration, s as ClipLibraryPlan, e as ClipLibraryUpdate, t as ClipSource, u as ContextMessage, n as CreditBalance, E as EndCallOptions, v as EndCallReason, k as ListRecordingsQuery, l as ListRecordingsResponse, i as ListSessionsOptions, L as LoopRedirect, m as RecordingAccessResponse, R as RecordingArtifact, w as RecordingArtifactStatus, x as RecordingMode, S as StartCallResult, T as TranscriptPayload, j as UsageSession, U as UsageSessionPage, V as VideoPolicy, y as isQueued, z as listRecordingsResponseSchema, B as recordingAccessResponseSchema, D as recordingArtifactSchema, F as recordingModeSchema } from './types-D76SpA3g.js';
 import './connection-history.js';
 import 'zod';

package/dist/server.js

@@ -1,2 +1,2 @@
-export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, listRecordingsResponseSchema, recordingAccessResponseSchema, recordingArtifactSchema, recordingModeSchema, verifyTranscript } from './chunk-27XNZHSF.js';
+export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, listRecordingsResponseSchema, recordingAccessResponseSchema, recordingArtifactSchema, recordingModeSchema, verifyTranscript } from './chunk-PKOWNCDT.js';
 import './chunk-MCIXU6XP.js';

package/dist/tanstack-start.d.ts

@@ -1,5 +1,5 @@
-import { P as ProxyConfig } from './types-Bzn5PJ0g.js';
-import './types-CxkszIDK.js';
+import { P as ProxyConfig } from './types-TaQCvMPh.js';
+import './types-D76SpA3g.js';
 import 'zod';
 
 /**

package/dist/tanstack-start.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-RKIEGOGJ.js';
-import './chunk-27XNZHSF.js';
+import { createProxyHandler } from './chunk-QT5UTARL.js';
+import './chunk-PKOWNCDT.js';
 import './chunk-MCIXU6XP.js';
 
 // src/tanstack-start.ts

package/dist/{types-CxkszIDK.d.ts → types-D76SpA3g.d.ts}

@@ -173,6 +173,7 @@ interface components {
             /** @description DEPRECATED, no-op. Accepted and ignored. The faster hesitation ceiling this requested is now the default for every session, so sending it changes nothing. Safe to stop sending; the field is retained only so existing callers do not break. */
             fast_endpointing?: boolean;
             require_ready_clip_library?: boolean;
+            camera?: boolean;
         };
         LiveKitSessionGrant: {
             /** @description Returned only for X-RTA-Release-Evidence: 1. Omitted by default for strict SDK compatibility. Missing deployment or worker evidence remains null. */
@@ -265,6 +266,7 @@ interface components {
                 /** Format: date-time */
                 expiresAt: string;
             };
+            camera?: boolean;
         };
         LiveKitCapacitySnapshot: {
             capacity_pool: string;
@@ -1162,6 +1164,7 @@ interface CallPolicy {
     maxSeconds?: number;
     /** Speech recognition. `server` for a spoken conversation, `off` if you drive turns. */
     listen?: boolean;
+    camera?: Wire["LiveKitSessionRequest"]["camera"];
     /** How she is rendered. */
     video?: VideoPolicy;
     /** Voice override for this call; omit to use the avatar's default. */

package/dist/{types-Bzn5PJ0g.d.ts → types-TaQCvMPh.d.ts}

@@ -1,4 +1,4 @@
-import { C as CallMode, a as CallPolicy } from './types-CxkszIDK.js';
+import { C as CallMode, a as CallPolicy } from './types-D76SpA3g.js';
 
 /** The three things a caller can ask the proxy to do. Gate on these, not on URLs. */
 type ProxyOperation = "connect" | "end" | "avatars" | "credits";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "realtime-avatar",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "Realtime Avatar SDK. `realtime-avatar` and the route adapters hold your API key and are server-only; `realtime-avatar/react`, `/browser` and `/tools` never can — importing a server entry into a browser build throws at bundle time.",
   "license": "MIT",
   "author": "The Influence Company",
@@ -122,7 +122,8 @@
     "@types/react": "19.2.7",
     "react": "19.2.7",
     "react-dom": "19.2.7",
-    "react-native": "0.81.5"
+    "react-native": "0.81.5",
+    "zod": "4.4.3"
   },
   "peerDependencies": {
     "@livekit/components-react": "^2.9.0",
@@ -130,7 +131,8 @@
     "react": ">=18",
     "react-dom": ">=18",
     "react-native": ">=0.78",
-    "livekit-client": "^2.9.0"
+    "livekit-client": "^2.9.0",
+    "zod": "^4.4.3"
   },
   "peerDependenciesMeta": {
     "@livekit/components-react": {
@@ -151,8 +153,5 @@
     "livekit-client": {
       "optional": true
     }
-  },
-  "dependencies": {
-    "zod": "^4.4.3"
   }
 }