realtime-avatar 0.27.0 → 0.27.2

package/dist/react.js

@@ -1074,6 +1074,8 @@ function RealtimeAvatarLiveKitRoom(props) {
     LiveKitRoom,
     {
       ...roomProps,
+      // A new grant owns a new room and bridge; an old room must not report its agent into it.
+      key: grant?.session_id ?? "no-session",
       serverUrl: grant?.livekit_url,
       token: grant?.participant_token,
       connect: shouldConnect,
@@ -2331,6 +2333,8 @@ var transcriptionOptionsSchema = z.object({
   languageCodes: transcriptionWireSchema.shape.language_codes,
   customVocabulary: transcriptionWireSchema.shape.custom_vocabulary
 }).strict();
+var schema02 = z.enum(["minor-sexual-content-v1"]);
+var contentPolicySchema = schema02;
 
 // ../client/src/wire.ts
 var DEFAULT_AVATAR_ID = "maria";
@@ -2497,7 +2501,8 @@ z.object({
   support_edits: sessionSupportEditsSchema.optional(),
   transcript_webhook: transcriptWebhookSchema.optional(),
   client_metadata: clientMetadataSchema.optional(),
-  connection_history: z.boolean().optional()
+  connection_history: z.boolean().optional(),
+  content_policy: contentPolicySchema.optional()
 }).strict().superRefine((value, ctx) => {
   if (value.support_edits && value.render_backend === "generative") {
     ctx.addIssue({
@@ -2565,7 +2570,8 @@ z.object({
   supportEdits: sessionSupportEditsSchema.optional(),
   transcriptWebhook: transcriptWebhookSchema.optional(),
   clientMetadata: clientMetadataSchema.optional(),
-  connectionHistory: z.boolean().optional()
+  connectionHistory: z.boolean().optional(),
+  contentPolicy: contentPolicySchema.optional()
 }).strict();
 z.object({
   recording: recordingArtifactSchema.optional(),
@@ -3019,7 +3025,8 @@ function lifecyclePhaseFrom(args) {
       kind: "reconnectable",
       reconnecting: true,
       attempt: recovery.attempt,
-      strategy: "fresh-grant"
+      strategy: "fresh-grant",
+      ...recovery.reason ? { reason: recovery.reason } : {}
     };
   }
   if (recovery.kind === "failed") {
@@ -3027,11 +3034,16 @@ function lifecyclePhaseFrom(args) {
       kind: "reconnectable",
       reconnecting: false,
       attempt: MAX_RECONNECT_ATTEMPTS,
-      strategy: "fresh-grant"
+      strategy: "fresh-grant",
+      ...recovery.reason ? { reason: recovery.reason } : {}
     };
   }
   if (recovery.kind === "ended") {
-    return recovery.reason ? { kind: "ended", reason: recovery.reason } : { kind: "ended" };
+    return {
+      kind: "ended",
+      ...recovery.reason ? { reason: recovery.reason } : {},
+      ...recovery.code ? { code: recovery.code } : {}
+    };
   }
   switch (capacity.kind) {
     case "idle":
@@ -3044,7 +3056,7 @@ function lifecyclePhaseFrom(args) {
       return { kind: "ended", reason: "error" };
     case "active": {
       if (!connected || !agentPresent) {
-        return { kind: "connecting", grant: capacity.grant };
+        return { kind: "connecting", grant: capacity.grant, waitingFor: connected ? "agent" : "transport" };
       }
       if (idle.kind === "idle-warning") {
         return { kind: "idle-warning", secondsRemaining: idle.secondsRemaining, deadlineAt: idle.deadlineAt };
@@ -3072,6 +3084,7 @@ function resolveIdleTimeoutMs(args) {
   return DEFAULT_IDLE_SECONDS * 1e3;
 }
 var DEFAULT_CONNECT_WATCHDOG_SECONDS = 12;
+var DEFAULT_READY_TIMEOUT_SECONDS = 30;
 function resolveWarnBeforeMs(idleTimeoutMs, override, idleWarnLeadSeconds) {
   if (idleTimeoutMs <= 0) return 0;
   const maxLeadMs = Math.max(0, idleTimeoutMs - 1e3);
@@ -3097,6 +3110,7 @@ function useSessionLifecycle(input) {
     maxReconnectAttempts,
     autoRetryBusy = true,
     connectWatchdogSeconds,
+    readyTimeoutSeconds,
     requestOptions,
     onBehaviorChange
   } = input;
@@ -3107,17 +3121,27 @@ function useSessionLifecycle(input) {
   const reconnectPolicyRef = useRef(reconnectPolicy);
   reconnectPolicyRef.current = reconnectPolicy;
   const connectWatchdogMs = typeof connectWatchdogSeconds === "number" && Number.isFinite(connectWatchdogSeconds) ? Math.max(0, Math.floor(connectWatchdogSeconds)) * 1e3 : DEFAULT_CONNECT_WATCHDOG_SECONDS * 1e3;
+  const readyTimeoutMs = typeof readyTimeoutSeconds === "number" && Number.isFinite(readyTimeoutSeconds) && readyTimeoutSeconds > 0 ? Math.max(1, Math.floor(readyTimeoutSeconds)) * 1e3 : DEFAULT_READY_TIMEOUT_SECONDS * 1e3;
   const [userEnded, setUserEnded] = useState(false);
   const userEndedRef = useRef(false);
+  const [readinessFailed, setReadinessFailed] = useState(false);
+  const readinessFailureRef = useRef(null);
+  const readinessRef = useRef(null);
+  const readyGrantRef = useRef(null);
+  const agentWaitRef = useRef(null);
   const phaseRef = useRef({ kind: "idle" });
   const grantState = useLiveKitAvatarGrant({
     client,
     session,
-    active: active && !userEnded,
+    active: active && !userEnded && !readinessFailed,
     autoRetryBusy,
     requestOptions
   });
   const capacity = grantState.capacity;
+  const grantId = grantState.grant?.session_id ?? null;
+  const grantIdRef = useRef(null);
+  grantIdRef.current = grantId;
+  const retiredGrantRef = useRef(null);
   const [recovery, setRecovery] = useState({ kind: "connected" });
   const recoveryRef = useRef(recovery);
   recoveryRef.current = recovery;
@@ -3140,8 +3164,19 @@ function useSessionLifecycle(input) {
     grantIdleSeconds: grantState.grant?.idle_timeout_seconds ?? 0
   });
   const warnAtMs = resolveWarnBeforeMs(idleTimeoutMs, warnBeforeMs, idleWarnLeadSeconds);
-  const [agentPresent, setAgentPresentState] = useState(false);
-  const [connected, setConnected] = useState(false);
+  const [agentObservation, setAgentObservation] = useState({ grantId: null, present: false });
+  const [connectionObservation, setConnectionObservation] = useState({ grantId: null, connected: false });
+  const agentPresent = agentObservation.grantId === grantId && agentObservation.present;
+  const connected = connectionObservation.grantId === grantId && connectionObservation.connected;
+  connectedRef.current = connected;
+  const setAgentPresentState = useCallback((present) => {
+    const owner = grantIdRef.current;
+    setAgentObservation((prev) => prev.grantId === owner && prev.present === present ? prev : { grantId: owner, present });
+  }, []);
+  const setConnected = useCallback((value) => {
+    const owner = grantIdRef.current;
+    setConnectionObservation((prev) => prev.grantId === owner && prev.connected === value ? prev : { grantId: owner, connected: value });
+  }, []);
   const lastActivityRef = useRef(Date.now());
   const leaveRoomRef = useRef(null);
   const [, setClockTick] = useState(0);
@@ -3158,7 +3193,11 @@ function useSessionLifecycle(input) {
     refreshBaselineCapacityRef.current = null;
     attemptRef.current = 0;
     setAttempt(0);
-    setRecovery(userEndedRef.current ? { kind: "ended", reason: "user" } : { kind: "connected" });
+    readinessRef.current = null;
+    readyGrantRef.current = null;
+    agentWaitRef.current = null;
+    retiredGrantRef.current = null;
+    setRecovery(userEndedRef.current ? { kind: "ended", reason: "user" } : readinessFailureRef.current ? { kind: "ended", reason: "error", code: readinessFailureRef.current } : { kind: "connected" });
     setConnected(false);
     setAgentPresentState(false);
     lastActivityRef.current = Date.now();
@@ -3167,26 +3206,33 @@ function useSessionLifecycle(input) {
     if (active) return;
     userEndedRef.current = false;
     setUserEnded(false);
+    readinessFailureRef.current = null;
+    setReadinessFailed(false);
     reset();
   }, [active, reset]);
   const markActivity = useCallback(() => {
+    if (grantId === null || grantIdRef.current !== grantId) return;
     lastActivityRef.current = Date.now();
     setClockTick((value) => value + 1);
-  }, []);
+  }, [grantId]);
   const stayConnected = useCallback(() => {
+    if (grantId === null || grantIdRef.current !== grantId) return;
     if (!connectedRef.current) return;
     lastActivityRef.current = Date.now();
     setClockTick((value) => value + 1);
-  }, []);
+  }, [grantId]);
   const setAgentPresent = useCallback((present) => {
-    setAgentPresentState((prev) => {
-      if (present && !prev) lastActivityRef.current = Date.now();
-      return present;
+    if (grantId === null || grantIdRef.current !== grantId) return;
+    if (userEndedRef.current || readinessFailureRef.current || retiredGrantRef.current !== null && retiredGrantRef.current === grantIdRef.current) return;
+    setAgentObservation((prev) => {
+      if (present && (prev.grantId !== grantId || !prev.present)) lastActivityRef.current = Date.now();
+      return prev.grantId === grantId && prev.present === present ? prev : { grantId, present };
     });
-  }, []);
+  }, [grantId]);
   const registerLeaveRoom = useCallback((leave) => {
+    if (grantId === null || grantIdRef.current !== grantId) return;
     leaveRoomRef.current = leave;
-  }, []);
+  }, [grantId]);
   const endIdle = useCallback(() => {
     if (!connectedRef.current) return;
     clearTimer();
@@ -3198,24 +3244,25 @@ function useSessionLifecycle(input) {
     leaveRoomRef.current?.();
   }, [clearTimer]);
   const onConnected = useCallback(() => {
-    if (userEndedRef.current) return;
+    if (grantId === null || grantIdRef.current !== grantId) return;
+    if (userEndedRef.current || readinessFailureRef.current || retiredGrantRef.current !== null && retiredGrantRef.current === grantIdRef.current) return;
     clearTimer();
     connectedRef.current = true;
     manualReconnectPendingRef.current = false;
     refreshBaselineCapacityRef.current = null;
     setConnected(true);
-    attemptRef.current = 0;
-    setAttempt(0);
+    if (readinessRef.current) readinessRef.current.sawTransport = true;
     setRecovery({ kind: "connected" });
     lastActivityRef.current = Date.now();
-  }, [clearTimer]);
+  }, [clearTimer, grantId]);
   const onDisconnected = useCallback(
     (reason) => {
-      if (!active || userEndedRef.current) return;
+      if (grantId === null || grantIdRef.current !== grantId) return;
+      if (!active || userEndedRef.current || readinessFailureRef.current) return;
       const action = disconnectAction(reason, connectedRef.current);
       if (action === "noop") return;
       if (action === "reset") {
-        if (recoveryRef.current.kind === "refreshing") return;
+        if (recoveryRef.current.kind === "refreshing" || recoveryRef.current.kind === "reconnecting") return;
         reset();
         return;
       }
@@ -3232,11 +3279,12 @@ function useSessionLifecycle(input) {
       refreshBaselineCapacityRef.current = null;
       setRecovery({ kind: "reconnecting", attempt: attemptRef.current });
     },
-    [active, reset]
+    [active, reset, grantId]
   );
   const onConnectionError = useCallback(
     (error) => {
-      if (!active || userEndedRef.current || !isRecoverableConnectionError(error)) return;
+      if (grantId === null || grantIdRef.current !== grantId) return;
+      if (!active || userEndedRef.current || readinessFailureRef.current || !isRecoverableConnectionError(error)) return;
       connectedRef.current = false;
       setConnected(false);
       setAgentPresentState(false);
@@ -3247,7 +3295,7 @@ function useSessionLifecycle(input) {
         return { kind: "reconnecting", attempt: attemptRef.current };
       });
     },
-    [active]
+    [active, grantId]
   );
   useEffect(() => {
     if (capacity.kind === "error" && recovery.kind === "connected") manualReconnectPendingRef.current = false;
@@ -3257,11 +3305,12 @@ function useSessionLifecycle(input) {
     const baseline = refreshBaselineCapacityRef.current;
     if (baseline?.kind === "error" && baseline.error === capacity.error) return;
     refreshBaselineCapacityRef.current = null;
-    setRecovery({ kind: "reconnecting", attempt: recovery.attempt });
+    setRecovery({ kind: "reconnecting", attempt: recovery.attempt, ...recovery.reason ? { reason: recovery.reason } : {} });
   }, [capacity, recovery]);
   const onConnectionStateChange = useCallback(
     (state) => {
-      if (!active || userEndedRef.current) return;
+      if (grantId === null || grantIdRef.current !== grantId) return;
+      if (!active || userEndedRef.current || readinessFailureRef.current) return;
       if (state === "connected") {
         onConnected();
         return;
@@ -3275,14 +3324,78 @@ function useSessionLifecycle(input) {
         }
       }
     },
-    [active, onConnected]
+    [active, onConnected, grantId]
   );
+  useEffect(() => {
+    if (!active || userEnded || readinessFailed || !connected || !agentPresent || !grantState.grant) return;
+    readyGrantRef.current = grantState.grant.session_id;
+    readinessRef.current = null;
+    agentWaitRef.current = null;
+    attemptRef.current = 0;
+    setAttempt(0);
+  }, [active, userEnded, readinessFailed, connected, agentPresent, grantState.grant]);
+  const failReadiness = useCallback((code) => {
+    if (userEndedRef.current || readinessFailureRef.current) return;
+    readinessFailureRef.current = code;
+    clearTimer();
+    connectedRef.current = false;
+    manualReconnectPendingRef.current = false;
+    refreshBaselineCapacityRef.current = null;
+    const ended = { kind: "ended", reason: "error", code };
+    recoveryRef.current = ended;
+    setRecovery(ended);
+    setConnected(false);
+    setAgentPresentState(false);
+    releaseRef.current("disconnected");
+    setReadinessFailed(true);
+    leaveRoomRef.current?.();
+  }, [clearTimer]);
+  useEffect(() => {
+    if (!active || userEnded || readinessFailed) return;
+    if (recovery.kind === "ended" || recovery.kind === "failed") return;
+    if (grantState.grant && readyGrantRef.current === grantState.grant.session_id) return;
+    if (!readinessRef.current && grantState.grant) {
+      readinessRef.current = { startedAt: Date.now(), sawTransport: connected };
+    }
+    const budget = readinessRef.current;
+    if (!budget) return;
+    const timer = window.setTimeout(() => {
+      if (readinessRef.current !== budget) return;
+      failReadiness(budget.sawTransport ? "agent_timeout" : "connection_timeout");
+    }, Math.max(0, budget.startedAt + readyTimeoutMs - Date.now()));
+    return () => window.clearTimeout(timer);
+  }, [active, userEnded, readinessFailed, connected, agentPresent, grantState.grant, recovery.kind, readyTimeoutMs, failReadiness]);
+  useEffect(() => {
+    const sessionId = grantState.grant?.session_id;
+    if (!active || userEnded || readinessFailed || !sessionId || readyGrantRef.current === sessionId || agentPresent) return;
+    if (recovery.kind === "reconnecting" || recovery.kind === "failed" || recovery.kind === "ended") return;
+    if (agentWaitRef.current?.sessionId !== sessionId) {
+      if (!connected) return;
+      agentWaitRef.current = { sessionId, startedAt: Date.now() };
+    }
+    const wait = agentWaitRef.current;
+    if (connectWatchdogMs <= 0) return;
+    const timer = window.setTimeout(() => {
+      if (agentWaitRef.current !== wait || readinessFailureRef.current || userEndedRef.current) return;
+      retiredGrantRef.current = sessionId;
+      connectedRef.current = false;
+      setConnected(false);
+      setAgentPresentState(false);
+      const next = { kind: "reconnecting", attempt: attemptRef.current, reason: "agent_timeout" };
+      recoveryRef.current = next;
+      setRecovery(next);
+      releaseRef.current("disconnected");
+      leaveRoomRef.current?.();
+    }, Math.max(0, wait.startedAt + connectWatchdogMs - Date.now()));
+    return () => window.clearTimeout(timer);
+  }, [active, userEnded, readinessFailed, connected, agentPresent, grantState.grant, recovery.kind, connectWatchdogMs]);
   useEffect(() => {
     if (!active || connected || connectWatchdogMs <= 0) return;
     if (grantState.status !== "ready" || !grantState.grant) return;
     if (recovery.kind === "failed" || recovery.kind === "ended") return;
     if (recovery.kind === "in-place-reconnecting") return;
     const timer = window.setTimeout(() => {
+      if (readinessFailureRef.current || userEndedRef.current) return;
       releaseRef.current("disconnected");
       setRecovery({ kind: "reconnecting", attempt: attemptRef.current });
     }, connectWatchdogMs);
@@ -3292,6 +3405,10 @@ function useSessionLifecycle(input) {
     if (!active || !needsFreshGrant(recovery)) return;
     const step2 = retryStep(attemptRef.current, reconnectPolicyRef.current);
     if (step2.kind === "give-up") {
+      if (readinessRef.current) {
+        failReadiness(readinessRef.current.sawTransport ? "agent_timeout" : "connection_timeout");
+        return;
+      }
       manualReconnectPendingRef.current = false;
       refreshBaselineCapacityRef.current = null;
       releaseRef.current("disconnected");
@@ -3300,15 +3417,16 @@ function useSessionLifecycle(input) {
     }
     timerRef.current = window.setTimeout(() => {
       timerRef.current = null;
+      if (readinessFailureRef.current || userEndedRef.current) return;
       attemptRef.current = step2.attempt;
       setAttempt(step2.attempt);
       refreshBaselineCapacityRef.current = capacityRef.current;
       releaseRef.current("superseded");
-      setRecovery({ kind: "refreshing", attempt: step2.attempt });
+      setRecovery({ kind: "refreshing", attempt: step2.attempt, ...recovery.reason ? { reason: recovery.reason } : {} });
       refreshRef.current();
     }, step2.delayMs);
     return clearTimer;
-  }, [recovery.kind, active, attempt, clearTimer]);
+  }, [recovery.kind, active, attempt, clearTimer, failReadiness]);
   const end = useCallback(() => {
     if (!active || userEndedRef.current || phaseRef.current.kind === "ended") return;
     userEndedRef.current = true;
@@ -3325,6 +3443,13 @@ function useSessionLifecycle(input) {
   }, [active, clearTimer]);
   const reconnect = useCallback(() => {
     if (!active) return;
+    if (readinessFailureRef.current) {
+      readinessFailureRef.current = null;
+      setReadinessFailed(false);
+      reset();
+      manualReconnectPendingRef.current = true;
+      return;
+    }
     if (userEndedRef.current) {
       userEndedRef.current = false;
       setUserEnded(false);
@@ -3335,6 +3460,12 @@ function useSessionLifecycle(input) {
     if (manualReconnectPendingRef.current || recovery.kind === "in-place-reconnecting") return;
     manualReconnectPendingRef.current = true;
     clearTimer();
+    readinessRef.current = null;
+    agentWaitRef.current = null;
+    readyGrantRef.current = null;
+    connectedRef.current = false;
+    setConnected(false);
+    setAgentPresentState(false);
     attemptRef.current = 0;
     setAttempt(0);
     refreshBaselineCapacityRef.current = capacityRef.current;
@@ -3454,6 +3585,7 @@ function SessionLifecycleRoomBridge({
   const assistant = useVoiceAssistant();
   const transcriptions = useTranscriptions();
   const room = useRoomContext();
+  const roomMatchesGrant = lifecycle.grant === void 0 || lifecycle.grant !== null && room.name === lifecycle.grant.room_name;
   useCallMedia(room, {
     setMicrophoneFacts,
     setAudioPlayback,
@@ -3607,11 +3739,11 @@ function SessionLifecycleRoomBridge({
     detailsEnabled ? video?.publication : void 0
   ]);
   useEffect(() => {
-    onConnectionStateChange(connectionState);
-  }, [connectionState, onConnectionStateChange]);
+    if (roomMatchesGrant) onConnectionStateChange(connectionState);
+  }, [connectionState, onConnectionStateChange, roomMatchesGrant]);
   useEffect(() => {
-    setAgentPresent(agentPresent);
-  }, [agentPresent, setAgentPresent]);
+    if (roomMatchesGrant) setAgentPresent(agentPresent);
+  }, [agentPresent, setAgentPresent, roomMatchesGrant]);
   useEffect(() => {
     const active = isCallActivity({
       assistantState,
@@ -4675,4 +4807,4 @@ function RecordingPlayer({ assets, className }) {
   ] });
 }
 
-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, RecordingPlayer, SessionLifecycleRoomBridge, capacityErrorFromBusy, capacityStateFromGrant, createProxyClient, knownBehaviorStates, mapTurnState, readInboundRtp, sessionBehaviorSchema, sessionClipSchema, shouldReplayPendingTurn, splitCallTranscript, useAvatarAdaptivePlayoutDelay, useAvatarCall, useAvatarCamera, 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_READY_TIMEOUT_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, RecordingPlayer, 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/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, w as ExternalLlm, k as ListRecordingsQuery, l as ListRecordingsResponse, i as ListSessionsOptions, L as LoopRedirect, m as RecordingAccessResponse, R as RecordingArtifact, x as RecordingArtifactStatus, y as RecordingMode, S as StartCallResult, T as TranscriptPayload, j as UsageSession, U as UsageSessionPage, V as VideoPolicy, z as isQueued, B as listRecordingsResponseSchema, D as recordingAccessResponseSchema, F as recordingArtifactSchema, G as recordingModeSchema } from './types-6MUqx800.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, w as ExternalLlm, k as ListRecordingsQuery, l as ListRecordingsResponse, i as ListSessionsOptions, L as LoopRedirect, m as RecordingAccessResponse, R as RecordingArtifact, x as RecordingArtifactStatus, y as RecordingMode, S as StartCallResult, T as TranscriptPayload, j as UsageSession, U as UsageSessionPage, V as VideoPolicy, z as isQueued, B as listRecordingsResponseSchema, D as recordingAccessResponseSchema, F as recordingArtifactSchema, G as recordingModeSchema } from './types-D_s7ff7w.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-NMJQEGYW.js';
+export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, listRecordingsResponseSchema, recordingAccessResponseSchema, recordingArtifactSchema, recordingModeSchema, verifyTranscript } from './chunk-YR5NJTEO.js';
 import './chunk-MCIXU6XP.js';

package/dist/tanstack-start.d.ts

@@ -1,5 +1,5 @@
-import { P as ProxyConfig } from './types-JtCwa0Ip.js';
-import './types-6MUqx800.js';
+import { P as ProxyConfig } from './types-BH9O5leB.js';
+import './types-D_s7ff7w.js';
 import 'zod';
 
 /**

package/dist/tanstack-start.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-SUKZ77GL.js';
-import './chunk-NMJQEGYW.js';
+import { createProxyHandler } from './chunk-SP5SYYSS.js';
+import './chunk-YR5NJTEO.js';
 import './chunk-MCIXU6XP.js';
 
 // src/tanstack-start.ts

package/dist/{types-JtCwa0Ip.d.ts → types-BH9O5leB.d.ts}

@@ -1,4 +1,4 @@
-import { C as CallMode, a as CallPolicy } from './types-6MUqx800.js';
+import { C as CallMode, a as CallPolicy } from './types-D_s7ff7w.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/dist/{types-6MUqx800.d.ts → types-D_s7ff7w.d.ts}

@@ -170,6 +170,11 @@ interface components {
                 url: string;
                 secret: string;
             };
+            /**
+             * @description Server-authored content enforcement policy. API-key integrators may request it; browser mints strip it. No default. Requires worker enforcement before emission; transport alone does not provide protection.
+             * @enum {string}
+             */
+            content_policy?: "minor-sexual-content-v1";
             /**
              * @description Server-owned recording policy; omitted means off. Legacy audio includes user and avatar audio. participants saves one continuous audio/video file per participant, without mixing their voices.
              * @enum {string}
@@ -1663,6 +1668,8 @@ interface ExternalLlm {
 }
 /** What YOUR SERVER decides about a call. Never accept any of this from a browser. */
 interface CallPolicy {
+    /** Optional server-owned content safety policy. Never accept a selection or disable from the browser. */
+    contentPolicy?: Wire["LiveKitSessionRequest"]["content_policy"];
     /** Ask the platform to grant the SDK's optional LiveKit connection history collector. */
     connectionHistory?: boolean;
     /** Optional server recording policy. Omitted means off; obtain user consent before enabling. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "realtime-avatar",
-  "version": "0.27.0",
+  "version": "0.27.2",
   "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",