realtime-avatar 0.27.1 → 0.27.3

package/README.md

@@ -86,8 +86,12 @@ if (recording.status === "ready") {
 
 Omitted or `"off"` disables recording. `"audio"` records published user and avatar audio;
 `"video"` records published video without audio; `"audio_video"` keeps both on one media timeline.
+`"participants"` keeps each participant's voice and camera in its own continuous file.
+`"tracks"` saves separate published audio/video tracks and replacement-camera segments;
+use `listRecordings({ sessionId: call.sessionId })` because its initial grant omits recording
+metadata so older installed clients remain compatible.
 Recording does not enable the microphone, camera, or screen sharing. Only tracks that participants
-authorize and publish can be recorded. Camera controls remain a future SDK feature.
+authorize and publish can be recorded.
 
 Recordings may finish processing after a call ends. Use `listRecordings({ sessionId })` to find
 them, or refresh `getRecording(recordingId)` while processing. These methods and
@@ -98,6 +102,15 @@ default); each URL expires at `expiresAt` (up to one hour, capped by retention).
 access before replaying or seeking after expiry. An expired URL does not delete the file.
 Treat the URL as private: anyone who has it can play that file until it expires.
 
+For participant replay, pass every ready `{ recording, url }` asset to `RecordingPlayer`
+from `realtime-avatar/react`. It accepts combined participant MP4s and separate audio/video
+segments, including camera republication. Follow `nextCursor` when listing a session's recordings.
+The optional `mediaStartOffsetMs` preserves a file's first native media timestamp; it delays
+that track's visibility without shifting its playback clock. The player preserves native
+timestamps across gaps and uses the artifact's duration instead of an initially truncated
+WebM container duration. `mediaMutedIntervalsMs` hides a muted camera while keeping media
+clocks and audio running, including audio carried by a legacy combined file.
+
 ## Optional connection history
 
 Set `connectionHistory: true` in the server's `startCall` policy when the caller needs a
@@ -220,9 +233,22 @@ the top of that file with the reason for each: two are gaps in the contract itse
 query parameters for `GET /v1/usage/sessions`, and the transcript webhook body is not in it at
 all), and the `video` policy types are deliberately not one-to-one with the wire.
 
+`contentPolicy: "minor-sexual-content-v1"` is an optional **server-owned** call policy,
+serialized as `content_policy`. Omission sends no policy field and preserves existing behavior.
+Unknown values, `null`, and disable values are refused before the request is sent. Set it in
+`startCall` or a proxy `session` callback, never from browser input: the proxy strips both
+`contentPolicy` and `content_policy` from incoming client bodies.
+
+Pre-release contract provenance: this field was generated with
+`node scripts/generate-clip-schema.mjs --sync <absolute sibling realtime-policy-platform root>`
+from `packages/realtime-avatar-contracts/openapi/realtime-avatar.openapi.json`, then
+`npm run spec:types`. The checked-in snapshot is that reviewed platform artifact, not the
+older deployed spec. **Before release, deploy the platform and regenerate with `npm run spec`
+against its deployed OpenAPI, then run `npm run check`.** Do not hand-edit the generated enum.
+
 ```ts
 // calls
-rta.startCall({ avatarId, mode?, instructions?, context?, maxSeconds?, video?, recording?, connectionHistory?, transcript?, metadata?, llm? })
+rta.startCall({ avatarId, mode?, instructions?, context?, maxSeconds?, video?, recording?, connectionHistory?, contentPolicy?, transcript?, metadata?, llm? })
 rta.endCall(sessionId, { reason? })     // free an abandoned call's slot; idempotent, never throws
 rta.leaveQueue(queueTicketId, { reason? }) // give up a queued call's place in line; idempotent, never throws
 

package/dist/{chunk-DOHZ365B.js → chunk-QBOIOZ3O.js}

@@ -1,4 +1,4 @@
-import { sessionModeSchema, liveKitSessionReleaseReasonSchema, RealtimeAvatar, ROUTE_TIMEOUT_MS, isQueued, RealtimeAvatarHttpError, RealtimeAvatarError } from './chunk-4IEGR75H.js';
+import { sessionModeSchema, liveKitSessionReleaseReasonSchema, RealtimeAvatar, ROUTE_TIMEOUT_MS, isQueued, RealtimeAvatarHttpError, RealtimeAvatarError } from './chunk-W4DGBG4Z.js';
 import { z } from 'zod';
 
 // ../http-client/src/generated/error-semantics.ts

package/dist/{chunk-4IEGR75H.js → chunk-W4DGBG4Z.js}

@@ -239,13 +239,17 @@ var schema26 = z.strictObject({
 var clipLibraryResponseSchema = schema24;
 var clipLibraryUpdateSchema = schema26;
 var RECORDED_MEDIA_MODES = ["audio", "video", "audio_video"];
-var recordingModeSchema = z.enum(["off", ...RECORDED_MEDIA_MODES, "participants"]).describe("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.");
+var recordingModeSchema = z.enum(["off", ...RECORDED_MEDIA_MODES, "participants", "tracks"]).describe("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. tracks saves each published participant audio/video track separately; list recordings by session after capture.");
 var RECORDING_STATUSES = ["pending", "recording", "processing", "ready", "failed", "expired"];
 z.enum(RECORDING_STATUSES);
 var recordingParticipantSchema = z.object({
   participantIdentity: z.string().min(1).max(160),
   role: z.enum(["user", "avatar"])
 }).strict();
+var recordingMutedIntervalSchema = z.object({
+  startMs: z.number().int().min(0),
+  endMs: z.number().int().positive()
+}).strict().refine((interval) => interval.endMs > interval.startMs, "Muted interval must end after it starts");
 var recordingMetadataSchema = z.object({
   sessionId: z.string().min(1),
   recordingId: z.string().min(1),
@@ -254,13 +258,15 @@ var recordingMetadataSchema = z.object({
   retainedUntil: z.string().datetime({ offset: true }),
   participant: recordingParticipantSchema.optional(),
   mediaStartedAt: z.string().datetime({ offset: true }).optional(),
-  mediaEndedAt: z.string().datetime({ offset: true }).optional()
+  mediaEndedAt: z.string().datetime({ offset: true }).optional(),
+  mediaStartOffsetMs: z.number().int().min(0).optional().describe("First playable native media timestamp relative to mediaStartedAt. Playback retains this offset; it does not reset the file clock to zero."),
+  mediaMutedIntervalsMs: z.array(recordingMutedIntervalSchema).optional().describe("Intervals of hidden camera video relative to mediaStartedAt, using native media timestamps. Audio playback continues through these intervals.")
 });
 var recordingArtifactSchema = z.discriminatedUnion("status", [
   recordingMetadataSchema.extend({ status: z.enum(["pending", "recording", "processing", "expired"]) }).strict(),
   recordingMetadataSchema.extend({
     status: z.literal("ready"),
-    mediaType: z.enum(["audio/mp4", "video/mp4"]),
+    mediaType: z.enum(["audio/mp4", "video/mp4", "audio/ogg", "video/webm"]),
     sizeBytes: z.number().int().positive(),
     durationMs: z.number().int().nonnegative().nullable()
   }).strict(),
@@ -328,6 +334,8 @@ function transcriptionToWire(input) {
     ...options.customVocabulary !== void 0 ? { custom_vocabulary: options.customVocabulary } : {}
   };
 }
+var schema03 = z.enum(["minor-sexual-content-v1"]);
+var contentPolicySchema = schema03;
 
 // ../client/src/wire.ts
 var DEFAULT_AVATAR_ID = "maria";
@@ -494,7 +502,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({
@@ -562,7 +571,8 @@ z.object({
   supportEdits: sessionSupportEditsSchema.optional(),
   transcriptWebhook: transcriptWebhookSchema.optional(),
   clientMetadata: clientMetadataSchema.optional(),
-  connectionHistory: z.boolean().optional()
+  connectionHistory: z.boolean().optional(),
+  contentPolicy: contentPolicySchema.optional()
 }).strict();
 var liveKitSessionGrantSchema = z.object({
   recording: recordingArtifactSchema.optional(),
@@ -665,7 +675,7 @@ var liveKitSessionReleaseReasonSchema = z.enum([
 
 // ../http-client/src/client.ts
 var DEFAULT_BASE_URL = "https://realtimeavatar.ai/api/v1";
-var SDK_VERSION = "0.27.1";
+var SDK_VERSION = "0.27.3";
 var RealtimeAvatar = class {
   #apiKey;
   #baseUrl;
@@ -716,6 +726,7 @@ var RealtimeAvatar = class {
     if (options.metadata !== void 0) body.client_metadata = options.metadata;
     if (options.recording !== void 0) body.recording = recordingModeSchema.parse(options.recording);
     if (options.connectionHistory !== void 0) body.connection_history = options.connectionHistory;
+    if (options.contentPolicy !== void 0) body.content_policy = contentPolicySchema.parse(options.contentPolicy);
     if (options.clientTools) body.capabilities = ["client_tools"];
     if (options.llm !== void 0) {
       const { backend, model, baseUrl, token } = options.llm;

package/dist/express.d.ts

@@ -1,5 +1,5 @@
-import { P as ProxyConfig } from './types-JtCwa0Ip.js';
-import './types-6MUqx800.js';
+import { P as ProxyConfig } from './types-lgS4Z9rd.js';
+import './types-kgmS7ECd.js';
 import 'zod';
 
 type Expressish = {

package/dist/express.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-DOHZ365B.js';
-import './chunk-4IEGR75H.js';
+import { createProxyHandler } from './chunk-QBOIOZ3O.js';
+import './chunk-W4DGBG4Z.js';
 import './chunk-MCIXU6XP.js';
 
 // ../proxy/src/express.ts

package/dist/hono.d.ts

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

package/dist/hono.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-DOHZ365B.js';
-import './chunk-4IEGR75H.js';
+import { createProxyHandler } from './chunk-QBOIOZ3O.js';
+import './chunk-W4DGBG4Z.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-6MUqx800.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 ExternalLlm, x as RecordingArtifactStatus, y as RecordingMode, V as VideoPolicy, z as isQueued, B as listRecordingsResponseSchema, D as recordingAccessResponseSchema, F as recordingArtifactSchema, G as recordingModeSchema } from './types-6MUqx800.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-kgmS7ECd.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 ExternalLlm, x as RecordingArtifactStatus, y as RecordingMode, V as VideoPolicy, z as isQueued, B as listRecordingsResponseSchema, D as recordingAccessResponseSchema, F as recordingArtifactSchema, G as recordingModeSchema } from './types-kgmS7ECd.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-4IEGR75H.js';
+export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, listRecordingsResponseSchema, recordingAccessResponseSchema, recordingArtifactSchema, recordingModeSchema, verifyTranscript } from './chunk-W4DGBG4Z.js';
 import './chunk-MCIXU6XP.js';

package/dist/nextjs.d.ts

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

package/dist/nextjs.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-DOHZ365B.js';
-import './chunk-4IEGR75H.js';
+import { createProxyHandler } from './chunk-QBOIOZ3O.js';
+import './chunk-W4DGBG4Z.js';
 import './chunk-MCIXU6XP.js';
 
 // ../proxy/src/nextjs.ts

package/dist/{proxy-client-Cs2azqD1.d.ts → proxy-client-BAY77sJZ.d.ts}

@@ -242,6 +242,9 @@ declare const liveKitSessionRequestSchema: z.ZodObject<{
     }, z.core.$strict>>;
     clientMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     connectionHistory: z.ZodOptional<z.ZodBoolean>;
+    contentPolicy: z.ZodOptional<z.ZodEnum<{
+        "minor-sexual-content-v1": "minor-sexual-content-v1";
+    }>>;
 }, z.core.$strict>;
 declare const liveKitSessionGrantSchema: z.ZodObject<{
     recording: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -263,6 +266,11 @@ declare const liveKitSessionGrantSchema: z.ZodObject<{
         }, z.core.$strict>>;
         mediaStartedAt: z.ZodOptional<z.ZodString>;
         mediaEndedAt: z.ZodOptional<z.ZodString>;
+        mediaStartOffsetMs: z.ZodOptional<z.ZodNumber>;
+        mediaMutedIntervalsMs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strict>>>;
         status: z.ZodEnum<{
             pending: "pending";
             recording: "recording";
@@ -288,10 +296,17 @@ declare const liveKitSessionGrantSchema: z.ZodObject<{
         }, z.core.$strict>>;
         mediaStartedAt: z.ZodOptional<z.ZodString>;
         mediaEndedAt: z.ZodOptional<z.ZodString>;
+        mediaStartOffsetMs: z.ZodOptional<z.ZodNumber>;
+        mediaMutedIntervalsMs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strict>>>;
         status: z.ZodLiteral<"ready">;
         mediaType: z.ZodEnum<{
             "audio/mp4": "audio/mp4";
             "video/mp4": "video/mp4";
+            "audio/ogg": "audio/ogg";
+            "video/webm": "video/webm";
         }>;
         sizeBytes: z.ZodNumber;
         durationMs: z.ZodNullable<z.ZodNumber>;
@@ -314,6 +329,11 @@ declare const liveKitSessionGrantSchema: z.ZodObject<{
         }, z.core.$strict>>;
         mediaStartedAt: z.ZodOptional<z.ZodString>;
         mediaEndedAt: z.ZodOptional<z.ZodString>;
+        mediaStartOffsetMs: z.ZodOptional<z.ZodNumber>;
+        mediaMutedIntervalsMs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strict>>>;
         status: z.ZodLiteral<"failed">;
         errorCode: z.ZodEnum<{
             recording_failed: "recording_failed";
@@ -326,6 +346,7 @@ declare const liveKitSessionGrantSchema: z.ZodObject<{
         audio_video: "audio_video";
         off: "off";
         participants: "participants";
+        tracks: "tracks";
     }>>;
     recordings: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         sessionId: z.ZodString;
@@ -346,6 +367,11 @@ declare const liveKitSessionGrantSchema: z.ZodObject<{
         }, z.core.$strict>>;
         mediaStartedAt: z.ZodOptional<z.ZodString>;
         mediaEndedAt: z.ZodOptional<z.ZodString>;
+        mediaStartOffsetMs: z.ZodOptional<z.ZodNumber>;
+        mediaMutedIntervalsMs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strict>>>;
         status: z.ZodEnum<{
             pending: "pending";
             recording: "recording";
@@ -371,10 +397,17 @@ declare const liveKitSessionGrantSchema: z.ZodObject<{
         }, z.core.$strict>>;
         mediaStartedAt: z.ZodOptional<z.ZodString>;
         mediaEndedAt: z.ZodOptional<z.ZodString>;
+        mediaStartOffsetMs: z.ZodOptional<z.ZodNumber>;
+        mediaMutedIntervalsMs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strict>>>;
         status: z.ZodLiteral<"ready">;
         mediaType: z.ZodEnum<{
             "audio/mp4": "audio/mp4";
             "video/mp4": "video/mp4";
+            "audio/ogg": "audio/ogg";
+            "video/webm": "video/webm";
         }>;
         sizeBytes: z.ZodNumber;
         durationMs: z.ZodNullable<z.ZodNumber>;
@@ -397,6 +430,11 @@ declare const liveKitSessionGrantSchema: z.ZodObject<{
         }, z.core.$strict>>;
         mediaStartedAt: z.ZodOptional<z.ZodString>;
         mediaEndedAt: z.ZodOptional<z.ZodString>;
+        mediaStartOffsetMs: z.ZodOptional<z.ZodNumber>;
+        mediaMutedIntervalsMs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strict>>>;
         status: z.ZodLiteral<"failed">;
         errorCode: z.ZodEnum<{
             recording_failed: "recording_failed";

package/dist/react-native.d.ts

@@ -1,7 +1,7 @@
 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-Cs2azqD1.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_READY_TIMEOUT_SECONDS, u as DEFAULT_TURN_TIMEOUT_SECONDS, v as DeclaredInputSource, E as EndReason, w as EndedEvent, x as ExtendResult, F as FishTtsModel, y as FreezeReadingFn, G as Governor, z as GovernorAction, H as GovernorConfig, I as GovernorSignal, J as GovernorState, K as GraceWindowClosedEvent, M as GraceWindowOpenEvent, N as GraceWindowState, O as IdleWarningEvent, P as InboundRtpCursor, Q as InboundRtpReading, R as KnownBehaviorState, S as LLMProvider, T as LLMSelection, U as LiveKitAvatarGrantState, V as LiveKitAvatarGrantStatus, W as LiveKitCapacityState, X as LiveKitConnectionStatus, Y as LiveKitSessionRequest, Z as LiveKitSessionStartResult, _ as MAX_RECONNECT_ATTEMPTS, $ as MAX_SESSION_INSTRUCTIONS_CHARS, a0 as ProxyClientOptions, a1 as QualityCap, a2 as RECONNECT_BACKOFF_MS, a3 as RealtimeAvatarRequestOptions, a4 as RealtimeSessionApi, a5 as RealtimeSessionMedia, a6 as RealtimeSessionRoomSinks, a7 as ReconnectPolicy, a8 as ReconnectingEvent, a9 as RecoveryState, aa as RetryStep, ab as SendTurnOptions, ac as SessionBehavior, ad as SessionClip, ae as SessionClocks, af as SessionEndReason, ag as SessionLifecycleApi, ah as SessionLifecyclePhase, ai as SessionLifecyclePhaseKind, aj as SessionLifecycleRoomBridge, ak as SessionLifecycleRoomBridgeProps, al as SessionReadinessFailure, am as SurfaceLayers, an as TranscriptSender, ao as TranscriptSenderOptions, ap as TurnState, aq as TurnTimeoutEvent, ar as UseAvatarQualityGovernorInput, as as UseLiveKitAvatarGrantInput, at as UseRealtimeSessionInput, au as UseSessionLifecycleInput, av as VoiceSpec, aw as VoiceSpecInput, ax as capacityErrorFromBusy, ay as capacityStateFromGrant, az as createProxyClient, aA as isNativeLiveTrackSubscribed, aB as knownBehaviorStates, aC as mapTurnState, aD as readInboundRtp, aE as sessionBehaviorSchema, aF as sessionClipSchema, aG as splitCallTranscript, aH as useAvatarAdaptivePlayoutDelay, aI as useAvatarCamera, aJ as useAvatarPlayoutDelay, aK as useAvatarQualityGovernor, aL as useCallTranscript, aM as useLiveKitAvatarGrant, aN as useLiveTrackProducing, aO as useMicLease, aP as useRealtimeSession, aQ as useReleaseMicLeaseOnTrackEnded, aR as useSessionLifecycle } from './proxy-client-Cs2azqD1.js';
+import { L as LiveKitSessionGrant, A as AvatarVideoFit } from './proxy-client-BAY77sJZ.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_READY_TIMEOUT_SECONDS, u as DEFAULT_TURN_TIMEOUT_SECONDS, v as DeclaredInputSource, E as EndReason, w as EndedEvent, x as ExtendResult, F as FishTtsModel, y as FreezeReadingFn, G as Governor, z as GovernorAction, H as GovernorConfig, I as GovernorSignal, J as GovernorState, K as GraceWindowClosedEvent, M as GraceWindowOpenEvent, N as GraceWindowState, O as IdleWarningEvent, P as InboundRtpCursor, Q as InboundRtpReading, R as KnownBehaviorState, S as LLMProvider, T as LLMSelection, U as LiveKitAvatarGrantState, V as LiveKitAvatarGrantStatus, W as LiveKitCapacityState, X as LiveKitConnectionStatus, Y as LiveKitSessionRequest, Z as LiveKitSessionStartResult, _ as MAX_RECONNECT_ATTEMPTS, $ as MAX_SESSION_INSTRUCTIONS_CHARS, a0 as ProxyClientOptions, a1 as QualityCap, a2 as RECONNECT_BACKOFF_MS, a3 as RealtimeAvatarRequestOptions, a4 as RealtimeSessionApi, a5 as RealtimeSessionMedia, a6 as RealtimeSessionRoomSinks, a7 as ReconnectPolicy, a8 as ReconnectingEvent, a9 as RecoveryState, aa as RetryStep, ab as SendTurnOptions, ac as SessionBehavior, ad as SessionClip, ae as SessionClocks, af as SessionEndReason, ag as SessionLifecycleApi, ah as SessionLifecyclePhase, ai as SessionLifecyclePhaseKind, aj as SessionLifecycleRoomBridge, ak as SessionLifecycleRoomBridgeProps, al as SessionReadinessFailure, am as SurfaceLayers, an as TranscriptSender, ao as TranscriptSenderOptions, ap as TurnState, aq as TurnTimeoutEvent, ar as UseAvatarQualityGovernorInput, as as UseLiveKitAvatarGrantInput, at as UseRealtimeSessionInput, au as UseSessionLifecycleInput, av as VoiceSpec, aw as VoiceSpecInput, ax as capacityErrorFromBusy, ay as capacityStateFromGrant, az as createProxyClient, aA as isNativeLiveTrackSubscribed, aB as knownBehaviorStates, aC as mapTurnState, aD as readInboundRtp, aE as sessionBehaviorSchema, aF as sessionClipSchema, aG as splitCallTranscript, aH as useAvatarAdaptivePlayoutDelay, aI as useAvatarCamera, aJ as useAvatarPlayoutDelay, aK as useAvatarQualityGovernor, aL as useCallTranscript, aM as useLiveKitAvatarGrant, aN as useLiveTrackProducing, aO as useMicLease, aP as useRealtimeSession, aQ as useReleaseMicLeaseOnTrackEnded, aR as useSessionLifecycle } from './proxy-client-BAY77sJZ.js';
 import { ReactNode, ReactElement } from 'react';
 import { StyleProp, ViewStyle } from 'react-native';
 export { useChat, useConnectionState, useLocalParticipant, useRoomContext, useTrackToggle, useTranscriptions, useVoiceAssistant } from '@livekit/components-react';

package/dist/react-native.js

@@ -1630,13 +1630,17 @@ var styles = StyleSheet.create({
   }
 });
 var RECORDED_MEDIA_MODES = ["audio", "video", "audio_video"];
-var recordingModeSchema = z.enum(["off", ...RECORDED_MEDIA_MODES, "participants"]).describe("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.");
+var recordingModeSchema = z.enum(["off", ...RECORDED_MEDIA_MODES, "participants", "tracks"]).describe("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. tracks saves each published participant audio/video track separately; list recordings by session after capture.");
 var RECORDING_STATUSES = ["pending", "recording", "processing", "ready", "failed", "expired"];
 z.enum(RECORDING_STATUSES);
 var recordingParticipantSchema = z.object({
   participantIdentity: z.string().min(1).max(160),
   role: z.enum(["user", "avatar"])
 }).strict();
+var recordingMutedIntervalSchema = z.object({
+  startMs: z.number().int().min(0),
+  endMs: z.number().int().positive()
+}).strict().refine((interval) => interval.endMs > interval.startMs, "Muted interval must end after it starts");
 var recordingMetadataSchema = z.object({
   sessionId: z.string().min(1),
   recordingId: z.string().min(1),
@@ -1645,13 +1649,15 @@ var recordingMetadataSchema = z.object({
   retainedUntil: z.string().datetime({ offset: true }),
   participant: recordingParticipantSchema.optional(),
   mediaStartedAt: z.string().datetime({ offset: true }).optional(),
-  mediaEndedAt: z.string().datetime({ offset: true }).optional()
+  mediaEndedAt: z.string().datetime({ offset: true }).optional(),
+  mediaStartOffsetMs: z.number().int().min(0).optional().describe("First playable native media timestamp relative to mediaStartedAt. Playback retains this offset; it does not reset the file clock to zero."),
+  mediaMutedIntervalsMs: z.array(recordingMutedIntervalSchema).optional().describe("Intervals of hidden camera video relative to mediaStartedAt, using native media timestamps. Audio playback continues through these intervals.")
 });
 var recordingArtifactSchema = z.discriminatedUnion("status", [
   recordingMetadataSchema.extend({ status: z.enum(["pending", "recording", "processing", "expired"]) }).strict(),
   recordingMetadataSchema.extend({
     status: z.literal("ready"),
-    mediaType: z.enum(["audio/mp4", "video/mp4"]),
+    mediaType: z.enum(["audio/mp4", "video/mp4", "audio/ogg", "video/webm"]),
     sizeBytes: z.number().int().positive(),
     durationMs: z.number().int().nonnegative().nullable()
   }).strict(),
@@ -1714,6 +1720,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";
@@ -1880,7 +1888,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({
@@ -1948,7 +1957,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(),

package/dist/react.d.ts

@@ -1,9 +1,9 @@
 import { ToolRegistration, RegisteredTool } from './tools.js';
-import { ak as SessionLifecycleRoomBridgeProps, h as AvatarSessionClient, A as AvatarVideoFit, aS as CallMicrophone, aT as CallAudioPlayback, aU as CallMicrophoneProblem } from './proxy-client-Cs2azqD1.js';
-export { a as AdaptivePlayoutController, b as AdaptivePlayoutDecision, c as AdaptivePlayoutOptions, d as AdaptivePlayoutSample, e as ApproachingEndEvent, f as ApproachingEndReason, g as AvatarConnectionDetails, aV as AvatarVideoSurface, aW 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_READY_TIMEOUT_SECONDS, u as DEFAULT_TURN_TIMEOUT_SECONDS, v as DeclaredInputSource, E as EndReason, w as EndedEvent, x as ExtendResult, F as FishTtsModel, y as FreezeReadingFn, G as Governor, z as GovernorAction, H as GovernorConfig, I as GovernorSignal, J as GovernorState, K as GraceWindowClosedEvent, M as GraceWindowOpenEvent, N as GraceWindowState, O as IdleWarningEvent, P as InboundRtpCursor, Q as InboundRtpReading, R as KnownBehaviorState, S as LLMProvider, T as LLMSelection, U as LiveKitAvatarGrantState, V as LiveKitAvatarGrantStatus, W as LiveKitCapacityState, X as LiveKitConnectionStatus, Y as LiveKitSessionRequest, Z as LiveKitSessionStartResult, aX as LivePlaybackKeeper, _ as MAX_RECONNECT_ATTEMPTS, $ as MAX_SESSION_INSTRUCTIONS_CHARS, aY as MIC_LEASE_ENDED_TIMEOUT_MS, aZ as MicLease, a_ as NETWORK_QUALITY_POLICY, a$ as NetworkQualityStatus, b0 as PlayableVideoElement, a0 as ProxyClientOptions, a1 as QualityCap, a2 as RECONNECT_BACKOFF_MS, b1 as RealtimeAvatarCapacityError, b2 as RealtimeAvatarLiveKitRoom, b3 as RealtimeAvatarLiveKitRoomProps, a3 as RealtimeAvatarRequestOptions, a4 as RealtimeSessionApi, a5 as RealtimeSessionMedia, a6 as RealtimeSessionRoomSinks, a7 as ReconnectPolicy, a8 as ReconnectingEvent, a9 as RecoveryState, aa as RetryStep, ab as SendTurnOptions, ac as SessionBehavior, ad as SessionClip, ae as SessionClocks, af as SessionEndReason, ag as SessionLifecycleApi, ah as SessionLifecyclePhase, ai as SessionLifecyclePhaseKind, aj as SessionLifecycleRoomBridge, al as SessionReadinessFailure, am as SurfaceLayers, an as TranscriptSender, ao as TranscriptSenderOptions, ap as TurnState, aq as TurnTimeoutEvent, ar as UseAvatarQualityGovernorInput, as as UseLiveKitAvatarGrantInput, at as UseRealtimeSessionInput, au as UseSessionLifecycleInput, av as VoiceSpec, aw as VoiceSpecInput, ax as capacityErrorFromBusy, ay as capacityStateFromGrant, az as createProxyClient, aB as knownBehaviorStates, aC as mapTurnState, aD as readInboundRtp, aE as sessionBehaviorSchema, aF as sessionClipSchema, b4 as shouldReplayPendingTurn, aG as splitCallTranscript, aH as useAvatarAdaptivePlayoutDelay, aI as useAvatarCamera, aJ as useAvatarPlayoutDelay, aK as useAvatarQualityGovernor, aL as useCallTranscript, aM as useLiveKitAvatarGrant, aO as useMicLease, aP as useRealtimeSession, aQ as useReleaseMicLeaseOnTrackEnded, aR as useSessionLifecycle } from './proxy-client-Cs2azqD1.js';
+import { ak as SessionLifecycleRoomBridgeProps, h as AvatarSessionClient, A as AvatarVideoFit, aS as CallMicrophone, aT as CallAudioPlayback, aU as CallMicrophoneProblem } from './proxy-client-BAY77sJZ.js';
+export { a as AdaptivePlayoutController, b as AdaptivePlayoutDecision, c as AdaptivePlayoutOptions, d as AdaptivePlayoutSample, e as ApproachingEndEvent, f as ApproachingEndReason, g as AvatarConnectionDetails, aV as AvatarVideoSurface, aW 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_READY_TIMEOUT_SECONDS, u as DEFAULT_TURN_TIMEOUT_SECONDS, v as DeclaredInputSource, E as EndReason, w as EndedEvent, x as ExtendResult, F as FishTtsModel, y as FreezeReadingFn, G as Governor, z as GovernorAction, H as GovernorConfig, I as GovernorSignal, J as GovernorState, K as GraceWindowClosedEvent, M as GraceWindowOpenEvent, N as GraceWindowState, O as IdleWarningEvent, P as InboundRtpCursor, Q as InboundRtpReading, R as KnownBehaviorState, S as LLMProvider, T as LLMSelection, U as LiveKitAvatarGrantState, V as LiveKitAvatarGrantStatus, W as LiveKitCapacityState, X as LiveKitConnectionStatus, Y as LiveKitSessionRequest, Z as LiveKitSessionStartResult, aX as LivePlaybackKeeper, _ as MAX_RECONNECT_ATTEMPTS, $ as MAX_SESSION_INSTRUCTIONS_CHARS, aY as MIC_LEASE_ENDED_TIMEOUT_MS, aZ as MicLease, a_ as NETWORK_QUALITY_POLICY, a$ as NetworkQualityStatus, b0 as PlayableVideoElement, a0 as ProxyClientOptions, a1 as QualityCap, a2 as RECONNECT_BACKOFF_MS, b1 as RealtimeAvatarCapacityError, b2 as RealtimeAvatarLiveKitRoom, b3 as RealtimeAvatarLiveKitRoomProps, a3 as RealtimeAvatarRequestOptions, a4 as RealtimeSessionApi, a5 as RealtimeSessionMedia, a6 as RealtimeSessionRoomSinks, a7 as ReconnectPolicy, a8 as ReconnectingEvent, a9 as RecoveryState, aa as RetryStep, ab as SendTurnOptions, ac as SessionBehavior, ad as SessionClip, ae as SessionClocks, af as SessionEndReason, ag as SessionLifecycleApi, ah as SessionLifecyclePhase, ai as SessionLifecyclePhaseKind, aj as SessionLifecycleRoomBridge, al as SessionReadinessFailure, am as SurfaceLayers, an as TranscriptSender, ao as TranscriptSenderOptions, ap as TurnState, aq as TurnTimeoutEvent, ar as UseAvatarQualityGovernorInput, as as UseLiveKitAvatarGrantInput, at as UseRealtimeSessionInput, au as UseSessionLifecycleInput, av as VoiceSpec, aw as VoiceSpecInput, ax as capacityErrorFromBusy, ay as capacityStateFromGrant, az as createProxyClient, aB as knownBehaviorStates, aC as mapTurnState, aD as readInboundRtp, aE as sessionBehaviorSchema, aF as sessionClipSchema, b4 as shouldReplayPendingTurn, aG as splitCallTranscript, aH as useAvatarAdaptivePlayoutDelay, aI as useAvatarCamera, aJ as useAvatarPlayoutDelay, aK as useAvatarQualityGovernor, aL as useCallTranscript, aM as useLiveKitAvatarGrant, aO as useMicLease, aP as useRealtimeSession, aQ as useReleaseMicLeaseOnTrackEnded, aR as useSessionLifecycle } from './proxy-client-BAY77sJZ.js';
 import { CSSProperties, ReactNode } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { R as RecordingArtifact } from './recording-DjswTx5B.js';
+import { R as RecordingArtifact } from './recording-ydFVySSd.js';
 export { D as DEFAULT_AVATAR_PLAYOUT_DELAY_SECONDS } from './playout-delay-CtRZdtsj.js';
 import 'zod';
 import 'livekit-client';
@@ -201,7 +201,7 @@ type RecordingPlaybackAsset = {
     recording: RecordingArtifact;
     url: string;
 };
-/** Each participant file carries only its own voice; one clock drives both files. */
+/** Participant files and separate track segments share one clock without mixing voices. */
 declare function RecordingPlayer({ assets, className }: {
     assets: readonly RecordingPlaybackAsset[];
     className?: string;