realtime-avatar 0.17.0 → 0.18.0

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

@@ -71,9 +71,27 @@ var clipListSchema = z.array(motionIdSchema).min(1).max(32).superRefine((clips,
     seen.add(clip);
   });
 });
+var idleWeightSchema = z.number().min(0).max(100);
 var idleSchema = z.strictObject({
   clips: clipListSchema,
-  weight: z.number().min(0).max(100).optional()
+  /** Legacy aggregate weight. Mutually exclusive with member weights. */
+  weight: idleWeightSchema.optional(),
+  /** Per-member weights, including `primary`; omitted members default to 1. */
+  weights: motionRecord(idleWeightSchema).optional()
+}).superRefine((idle, ctx) => {
+  if (idle.weights === void 0) return;
+  if (idle.weight !== void 0) {
+    ctx.addIssue({ code: "custom", path: ["weight"], message: "Use weight or weights, not both" });
+  }
+  const members = /* @__PURE__ */ new Set(["primary", ...idle.clips]);
+  for (const clip of Object.keys(idle.weights)) {
+    if (!members.has(clip)) {
+      ctx.addIssue({ code: "custom", path: ["weights", clip], message: "Unknown idle member" });
+    }
+  }
+  if (![...members].some((clip) => (idle.weights?.[clip] ?? 1) > 0)) {
+    ctx.addIssue({ code: "custom", path: ["weights"], message: "Idle pool needs a positive member" });
+  }
 });
 var clipActionSchema = z.strictObject({
   description: z.string().trim().min(1).max(512),
@@ -600,7 +618,7 @@ z.enum([
 
 // ../http-client/src/client.ts
 var DEFAULT_BASE_URL = "https://realtimeavatar.ai/api/v1";
-var SDK_VERSION = "0.17.0";
+var SDK_VERSION = "0.18.0";
 var RealtimeAvatar = class {
   #apiKey;
   #baseUrl;

package/dist/{chunk-27BB4DQ2.js → chunk-RKIEGOGJ.js}

@@ -1,4 +1,4 @@
-import { RealtimeAvatar, isQueued, RealtimeAvatarHttpError } from './chunk-OESXLLQB.js';
+import { RealtimeAvatar, isQueued, RealtimeAvatarHttpError } from './chunk-27XNZHSF.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-CFkiNV3f.js';
-import './types-BnlnrYgN.js';
+import { P as ProxyConfig } from './types-Bzn5PJ0g.js';
+import './types-CxkszIDK.js';
 import 'zod';
 
 type Expressish = {

package/dist/express.js

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

package/dist/hono.d.ts

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

package/dist/hono.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-27BB4DQ2.js';
-import './chunk-OESXLLQB.js';
+import { createProxyHandler } from './chunk-RKIEGOGJ.js';
+import './chunk-27XNZHSF.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-BnlnrYgN.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-BnlnrYgN.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-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 { ConnectionHistoryResponse } from './connection-history.js';
 import { z } from 'zod';
 
@@ -344,6 +344,7 @@ declare const clipLibraryDeclarationSchema: z.ZodObject<{
     idle: z.ZodOptional<z.ZodObject<{
         clips: z.ZodArray<z.ZodString>;
         weight: z.ZodOptional<z.ZodNumber>;
+        weights: z.ZodOptional<z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodNumber>>>;
     }, z.core.$strict>>;
     on: z.ZodOptional<z.ZodObject<{
         userSpeechStarted: z.ZodOptional<z.ZodObject<{

package/dist/index.js

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

package/dist/nextjs.d.ts

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

package/dist/nextjs.js

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

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 { ReactNode, ReactElement } from 'react';
-import { L as LiveKitSessionGrant, A as AvatarVideoFit } from './proxy-client-DmJVj18Z.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-DmJVj18Z.js';
+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

@@ -148,6 +148,131 @@ function playoutDelayTarget(track) {
   return typeof candidate?.setPlayoutDelay === "function" ? candidate : void 0;
 }
 
+// ../http-client/src/generated/error-semantics.ts
+var ERROR_SEMANTICS = {
+  "bad_request": { statuses: [400], message: "Check the request and try again.", retryable: false },
+  "unauthorized": { statuses: [401], message: "Authentication is required to use Realtime Avatar.", retryable: false },
+  "payment_required": { statuses: [402], message: "Add credits to continue using realtime avatars.", retryable: false },
+  "forbidden": { statuses: [403], message: "This API key does not have access to that action.", retryable: false },
+  "not_found": { statuses: [404], message: "We could not find that avatar or resource.", retryable: false },
+  "method_not_allowed": { statuses: [405], message: "This request method is not supported.", retryable: false },
+  "not_acceptable": { statuses: [406], message: "The requested response format is not supported.", retryable: false },
+  "request_aborted": { statuses: [408], message: "The session request was cancelled.", retryable: false },
+  "conflict": { statuses: [409], message: "That request is already in progress. Try again in a moment.", retryable: true },
+  "length_required": { statuses: [411], message: "A request content length is required.", retryable: false },
+  "payload_too_large": { statuses: [413], message: "The request is too large.", retryable: false },
+  "unprocessable_entity": { statuses: [422], message: "Check the request and try again.", retryable: false },
+  "rate_limited": { statuses: [429], message: "Too many realtime requests. Please slow down and retry.", retryable: true },
+  "internal_error": { statuses: [500], message: "The session service encountered an error. Try again.", retryable: true },
+  "unavailable": { statuses: [503], message: "Realtime Avatar is temporarily unavailable. Try again in a moment.", retryable: true },
+  "insufficient_scope": { statuses: [403], message: "This API key is missing a required permission.", retryable: false },
+  "loop_pending": { statuses: [409], message: "An avatar loop update is still in progress. Try again shortly.", retryable: true },
+  "rate_limit_exceeded": { statuses: [429], message: "Too many realtime requests. Please slow down and retry.", retryable: true },
+  "upstream_failed": { statuses: [500, 502, 503], message: "The session service could not complete the request. Try again.", retryable: true },
+  "upstream_unreachable": { statuses: [502, 503], message: "The session service could not be reached. Try again.", retryable: true },
+  "invalid_upstream_response": { statuses: [502], message: "The session service returned an invalid response. Try again.", retryable: true },
+  "upstream_timeout": { statuses: [504], message: "The session service took too long to respond. Try again.", retryable: true },
+  "capacity_unavailable": { statuses: [503], message: "Session availability could not be checked. Try again.", retryable: true },
+  "session_dispatch_failed": { statuses: [503], message: "The avatar session could not be started. Try again.", retryable: true },
+  "admission_unavailable": { statuses: [503], message: "Session admission is temporarily unavailable. Try again.", retryable: true },
+  "service_warming": { statuses: [503], message: "Realtime Avatar is warming up. Try again in a moment.", retryable: true },
+  "avatar_not_ready": { statuses: [409], message: "This avatar is still being built \u2014 it is usually ready within a minute. Try again then.", retryable: true },
+  "clip_library_not_ready": { statuses: [409], message: "This avatar's motion clips are still rendering. Try again in a minute.", retryable: true },
+  "recording_unsupported": { statuses: [501], message: "Session recording is not enabled for this deployment.", retryable: false },
+  "recording_requires_new_room": { statuses: [422], message: "Recording requires a new session room. Start a fresh session to record it.", retryable: false },
+  "recording_unavailable": { statuses: [503], message: "Session recording is temporarily unavailable. Try again in a moment.", retryable: true }
+};
+var UNCOPIED_ERROR_CODES = [
+  "capacity_busy",
+  "concurrency_limit_reached",
+  "insufficient_credits",
+  "spend_limit_exceeded",
+  "billing_required",
+  "network_error"
+];
+var MESSAGE_SHAPE_PATTERNS = { "machine": { "source": "[_=<>{}\\[\\]|\\\\$`]|\\w+\\.\\w+\\.\\w|\\S:\\d|\\w\\(\\)|^\\s*(?:at|File)\\b|\\bTraceback \\(most recent call last\\)", "flags": "mu" }, "locator": { "source": "https?://|/[\\w.-]+/|[\\w.+-]+@[\\w.-]+\\.[a-z]{2,}|\\bbearer\\s|[\\r\\n]", "flags": "i" } };
+var MESSAGE_MAX_LENGTH = 180;
+var SHAPE_TESTS = Object.values(MESSAGE_SHAPE_PATTERNS).map(
+  (pattern) => new RegExp(pattern.source, pattern.flags)
+);
+function hasInternalDetail(message) {
+  return SHAPE_TESTS.some((pattern) => pattern.test(message));
+}
+function userSafeMessage(message) {
+  const trimmed = message.trim();
+  if (!trimmed || hasInternalDetail(trimmed)) return null;
+  return trimmed.length > MESSAGE_MAX_LENGTH ? `${trimmed.slice(0, MESSAGE_MAX_LENGTH - 3)}...` : trimmed;
+}
+function isCopiedErrorCode(code) {
+  return Object.hasOwn(ERROR_SEMANTICS, code);
+}
+function isKnownErrorCode(code) {
+  return isCopiedErrorCode(code) || UNCOPIED_ERROR_CODES.some((known) => known === code);
+}
+function semanticsFor(code) {
+  return isCopiedErrorCode(code) ? ERROR_SEMANTICS[code] : void 0;
+}
+function semanticsForStatus(status) {
+  return Object.values(ERROR_SEMANTICS).find(
+    (entry) => entry.statuses.some((allowed) => allowed === status)
+  );
+}
+function defaultCodeForStatus(status) {
+  const match = Object.entries(ERROR_SEMANTICS).find(
+    ([, entry]) => entry.statuses.some((allowed) => allowed === status)
+  );
+  return match ? match[0] : "request_failed";
+}
+function normalizeError(input, overrides) {
+  const status = input.status ?? 0;
+  const rawCode = input.code?.trim() || null;
+  const rawMessage = input.message?.trim() || "";
+  if (rawCode) {
+    const semantics = semanticsFor(rawCode);
+    if (semantics?.statuses.some((allowed) => allowed === status)) {
+      return { code: rawCode, message: semantics.message, retryable: semantics.retryable };
+    }
+  }
+  if (status === 402) {
+    return {
+      code: rawCode === "insufficient_credits" || rawCode === "spend_limit_exceeded" ? rawCode : "billing_required",
+      message: userSafeMessage(rawMessage) ?? ERROR_SEMANTICS.payment_required.message,
+      retryable: false
+    };
+  }
+  if (status === 429 && rawCode === "concurrency_limit_reached") {
+    return {
+      code: "concurrency_limit_reached",
+      message: userSafeMessage(rawMessage) ?? overrides.concurrencyLimitFallback,
+      retryable: true
+    };
+  }
+  if (status === 400 || status === 422) {
+    return {
+      code: "invalid_request",
+      message: userSafeMessage(rawMessage) ?? ERROR_SEMANTICS.bad_request.message,
+      retryable: false
+    };
+  }
+  const recognised = !rawCode || isKnownErrorCode(rawCode);
+  const byStatus = recognised && status < 500 ? semanticsForStatus(status) : void 0;
+  if (byStatus) {
+    return {
+      code: status === 503 ? "service_unavailable" : defaultCodeForStatus(status),
+      message: byStatus.message,
+      retryable: byStatus.retryable
+    };
+  }
+  if (status >= 500) {
+    return { code: "service_unavailable", message: ERROR_SEMANTICS.unavailable.message, retryable: true };
+  }
+  return {
+    code: status === 0 && rawCode === "network_error" ? "network_error" : "request_failed",
+    message: userSafeMessage(rawMessage) ?? overrides.requestFailedFallback,
+    retryable: status === 0 || status >= 500
+  };
+}
+
 // ../client/src/errors.ts
 var RealtimeAvatarApiError = class _RealtimeAvatarApiError extends Error {
   constructor(message, status, body, response, metadata = {}) {
@@ -206,72 +331,27 @@ var RealtimeAvatarCapacityError = class extends Error {
     return this.busy.recommended_retry_ms;
   }
 };
+function readRecord(value) {
+  return typeof value === "object" && value !== null ? { ...value } : null;
+}
 function extractErrorMessage(body) {
-  if (!body || typeof body !== "object") return typeof body === "string" && body ? body : null;
-  const record = body;
-  const detail = readMessageValue(record.detail);
-  if (detail) return detail;
-  const error = readMessageValue(record.error);
-  if (error) return error;
-  const message = readMessageValue(record.message);
-  if (message) return message;
-  return null;
+  if (typeof body === "string") return body || null;
+  const record = readRecord(body);
+  if (!record) return null;
+  return readMessageValue(record.detail) ?? readMessageValue(record.error) ?? readMessageValue(record.message);
 }
 function normalizeRealtimeAvatarError(input) {
-  const status = input.status ?? 0;
-  const rawCode = input.code?.trim() || null;
-  const rawMessage = input.message?.trim() || "";
-  const blob = `${rawCode ?? ""} ${rawMessage}`.toLowerCase();
-  if (rawCode === "insufficient_credits" || rawCode === "spend_limit_exceeded" || status === 402) {
-    return {
-      code: rawCode ?? "billing_required",
-      message: rawMessage && !hasInternalDetail(rawMessage) ? rawMessage : "Add credits to continue using realtime avatars.",
-      retryable: false
-    };
-  }
-  if (status === 401) {
-    return { code: "unauthorized", message: "Authentication is required to use Realtime Avatar.", retryable: false };
-  }
-  if (status === 403) {
-    return { code: "forbidden", message: "This API key does not have access to that action.", retryable: false };
-  }
-  if (status === 404 || blob.includes("unknown avatar_id") || blob.includes("avatar not found")) {
-    return { code: "not_found", message: "We could not find that avatar or resource.", retryable: false };
-  }
-  if (status === 409) {
-    return { code: "conflict", message: "That request is already in progress. Try again in a moment.", retryable: true };
-  }
-  if (status === 429 && rawCode === "concurrency_limit_reached") {
-    return {
-      code: rawCode,
-      message: userSafeMessage(rawMessage) ?? "The concurrent session limit is reached. Active and starting sessions count. End a session or wait for pending starts to clear, then retry.",
-      retryable: true
-    };
-  }
-  if (status === 429) {
-    return { code: "rate_limited", message: "Too many realtime requests. Please slow down and retry.", retryable: true };
-  }
-  if (isWarmingMessage(blob)) {
-    return { code: "service_unavailable", message: "Realtime Avatar is warming up. Try again in a moment.", retryable: true };
-  }
-  if (status === 400 || status === 422) {
-    return { code: "invalid_request", message: userSafeMessage(rawMessage) ?? "Check the request and try again.", retryable: false };
-  }
-  if (status >= 500) {
-    return { code: "service_unavailable", message: "Realtime Avatar is temporarily unavailable. Try again in a moment.", retryable: true };
-  }
-  return {
-    code: isPublicErrorCode(rawCode) ? rawCode : "request_failed",
-    message: userSafeMessage(rawMessage) ?? "Realtime Avatar request failed. Try again.",
-    retryable: status === 0 || status >= 500
-  };
+  return normalizeError(input, {
+    concurrencyLimitFallback: CONCURRENCY_LIMIT_FALLBACK_MESSAGE,
+    requestFailedFallback: "Realtime Avatar request failed. Try again."
+  });
 }
 function extractErrorMetadata(body, status, rawMessage) {
-  if (!body || typeof body !== "object") {
+  const record = readRecord(body);
+  if (!record) {
     const normalized2 = normalizeRealtimeAvatarError({ status, message: rawMessage });
     return { ...normalized2, rawMessage };
   }
-  const record = body;
   const code = typeof record.code === "string" ? record.code : null;
   const normalized = normalizeRealtimeAvatarError({ status, code, message: rawMessage });
   return {
@@ -282,38 +362,13 @@ function extractErrorMetadata(body, status, rawMessage) {
     message: normalized.message
   };
 }
-var PUBLIC_ERROR_CODES = /* @__PURE__ */ new Set([
-  "billing_required",
-  "invalid_request",
-  "unauthorized",
-  "forbidden",
-  "not_found",
-  "conflict",
-  "rate_limited",
-  "service_unavailable",
-  "request_failed",
-  "network_error"
-]);
-function isPublicErrorCode(code) {
-  return Boolean(code && PUBLIC_ERROR_CODES.has(code));
-}
+var CONCURRENCY_LIMIT_FALLBACK_MESSAGE = "The concurrent session limit is reached. Active and starting sessions count. End a session or wait for pending starts to clear, then retry.";
 function readMessageValue(value) {
   if (typeof value === "string") return value.trim() || null;
-  if (!value || typeof value !== "object") return null;
-  const record = value;
+  const record = readRecord(value);
+  if (!record) return null;
   return readMessageValue(record.message) ?? readMessageValue(record.error) ?? readMessageValue(record.detail);
 }
-function userSafeMessage(message) {
-  if (!message || hasInternalDetail(message)) return null;
-  return message.length > 180 ? `${message.slice(0, 177)}...` : message;
-}
-function isWarmingMessage(blob) {
-  return blob.includes("warming") || blob.includes("not ready") || blob.includes("starting up");
-}
-var MACHINE_SHAPED = /[_=<>{}\[\]|\\$`]|\w+\.\w+\.\w|\S:\d|\w\(\)|^\s*(?:at|File)\b/mu;
-function hasInternalDetail(message) {
-  return MACHINE_SHAPED.test(message);
-}
 function splitCallTranscript(all, localIdentity) {
   if (!localIdentity) return { user: [], agent: all };
   const user = [];
@@ -2383,7 +2438,7 @@ function SessionLifecycleRoomBridge({
   }, [connectionHistoryGrant, detailsSessionId]);
   useEffect(() => {
     const collector = connectionHistoryRef.current;
-    if (!collector || typeof window === "undefined") return;
+    if (!collector || typeof window === "undefined" || typeof window.addEventListener !== "function" || typeof window.removeEventListener !== "function") return;
     const flush = () => {
       void collector.flush();
     };

package/dist/react.d.ts

@@ -1,7 +1,7 @@
 import { RegisteredTool, ToolRegistration } from './tools.js';
 import { ReactNode } from 'react';
-import { ah as SessionLifecycleRoomBridgeProps, h as AvatarSessionClient, A as AvatarVideoFit } from './proxy-client-DmJVj18Z.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-DmJVj18Z.js';
+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';

package/dist/react.js

@@ -301,6 +301,131 @@ function playoutDelayTarget(track) {
   return typeof candidate?.setPlayoutDelay === "function" ? candidate : void 0;
 }
 
+// ../http-client/src/generated/error-semantics.ts
+var ERROR_SEMANTICS = {
+  "bad_request": { statuses: [400], message: "Check the request and try again.", retryable: false },
+  "unauthorized": { statuses: [401], message: "Authentication is required to use Realtime Avatar.", retryable: false },
+  "payment_required": { statuses: [402], message: "Add credits to continue using realtime avatars.", retryable: false },
+  "forbidden": { statuses: [403], message: "This API key does not have access to that action.", retryable: false },
+  "not_found": { statuses: [404], message: "We could not find that avatar or resource.", retryable: false },
+  "method_not_allowed": { statuses: [405], message: "This request method is not supported.", retryable: false },
+  "not_acceptable": { statuses: [406], message: "The requested response format is not supported.", retryable: false },
+  "request_aborted": { statuses: [408], message: "The session request was cancelled.", retryable: false },
+  "conflict": { statuses: [409], message: "That request is already in progress. Try again in a moment.", retryable: true },
+  "length_required": { statuses: [411], message: "A request content length is required.", retryable: false },
+  "payload_too_large": { statuses: [413], message: "The request is too large.", retryable: false },
+  "unprocessable_entity": { statuses: [422], message: "Check the request and try again.", retryable: false },
+  "rate_limited": { statuses: [429], message: "Too many realtime requests. Please slow down and retry.", retryable: true },
+  "internal_error": { statuses: [500], message: "The session service encountered an error. Try again.", retryable: true },
+  "unavailable": { statuses: [503], message: "Realtime Avatar is temporarily unavailable. Try again in a moment.", retryable: true },
+  "insufficient_scope": { statuses: [403], message: "This API key is missing a required permission.", retryable: false },
+  "loop_pending": { statuses: [409], message: "An avatar loop update is still in progress. Try again shortly.", retryable: true },
+  "rate_limit_exceeded": { statuses: [429], message: "Too many realtime requests. Please slow down and retry.", retryable: true },
+  "upstream_failed": { statuses: [500, 502, 503], message: "The session service could not complete the request. Try again.", retryable: true },
+  "upstream_unreachable": { statuses: [502, 503], message: "The session service could not be reached. Try again.", retryable: true },
+  "invalid_upstream_response": { statuses: [502], message: "The session service returned an invalid response. Try again.", retryable: true },
+  "upstream_timeout": { statuses: [504], message: "The session service took too long to respond. Try again.", retryable: true },
+  "capacity_unavailable": { statuses: [503], message: "Session availability could not be checked. Try again.", retryable: true },
+  "session_dispatch_failed": { statuses: [503], message: "The avatar session could not be started. Try again.", retryable: true },
+  "admission_unavailable": { statuses: [503], message: "Session admission is temporarily unavailable. Try again.", retryable: true },
+  "service_warming": { statuses: [503], message: "Realtime Avatar is warming up. Try again in a moment.", retryable: true },
+  "avatar_not_ready": { statuses: [409], message: "This avatar is still being built \u2014 it is usually ready within a minute. Try again then.", retryable: true },
+  "clip_library_not_ready": { statuses: [409], message: "This avatar's motion clips are still rendering. Try again in a minute.", retryable: true },
+  "recording_unsupported": { statuses: [501], message: "Session recording is not enabled for this deployment.", retryable: false },
+  "recording_requires_new_room": { statuses: [422], message: "Recording requires a new session room. Start a fresh session to record it.", retryable: false },
+  "recording_unavailable": { statuses: [503], message: "Session recording is temporarily unavailable. Try again in a moment.", retryable: true }
+};
+var UNCOPIED_ERROR_CODES = [
+  "capacity_busy",
+  "concurrency_limit_reached",
+  "insufficient_credits",
+  "spend_limit_exceeded",
+  "billing_required",
+  "network_error"
+];
+var MESSAGE_SHAPE_PATTERNS = { "machine": { "source": "[_=<>{}\\[\\]|\\\\$`]|\\w+\\.\\w+\\.\\w|\\S:\\d|\\w\\(\\)|^\\s*(?:at|File)\\b|\\bTraceback \\(most recent call last\\)", "flags": "mu" }, "locator": { "source": "https?://|/[\\w.-]+/|[\\w.+-]+@[\\w.-]+\\.[a-z]{2,}|\\bbearer\\s|[\\r\\n]", "flags": "i" } };
+var MESSAGE_MAX_LENGTH = 180;
+var SHAPE_TESTS = Object.values(MESSAGE_SHAPE_PATTERNS).map(
+  (pattern) => new RegExp(pattern.source, pattern.flags)
+);
+function hasInternalDetail(message) {
+  return SHAPE_TESTS.some((pattern) => pattern.test(message));
+}
+function userSafeMessage(message) {
+  const trimmed = message.trim();
+  if (!trimmed || hasInternalDetail(trimmed)) return null;
+  return trimmed.length > MESSAGE_MAX_LENGTH ? `${trimmed.slice(0, MESSAGE_MAX_LENGTH - 3)}...` : trimmed;
+}
+function isCopiedErrorCode(code) {
+  return Object.hasOwn(ERROR_SEMANTICS, code);
+}
+function isKnownErrorCode(code) {
+  return isCopiedErrorCode(code) || UNCOPIED_ERROR_CODES.some((known) => known === code);
+}
+function semanticsFor(code) {
+  return isCopiedErrorCode(code) ? ERROR_SEMANTICS[code] : void 0;
+}
+function semanticsForStatus(status) {
+  return Object.values(ERROR_SEMANTICS).find(
+    (entry) => entry.statuses.some((allowed) => allowed === status)
+  );
+}
+function defaultCodeForStatus(status) {
+  const match = Object.entries(ERROR_SEMANTICS).find(
+    ([, entry]) => entry.statuses.some((allowed) => allowed === status)
+  );
+  return match ? match[0] : "request_failed";
+}
+function normalizeError(input, overrides) {
+  const status = input.status ?? 0;
+  const rawCode = input.code?.trim() || null;
+  const rawMessage = input.message?.trim() || "";
+  if (rawCode) {
+    const semantics = semanticsFor(rawCode);
+    if (semantics?.statuses.some((allowed) => allowed === status)) {
+      return { code: rawCode, message: semantics.message, retryable: semantics.retryable };
+    }
+  }
+  if (status === 402) {
+    return {
+      code: rawCode === "insufficient_credits" || rawCode === "spend_limit_exceeded" ? rawCode : "billing_required",
+      message: userSafeMessage(rawMessage) ?? ERROR_SEMANTICS.payment_required.message,
+      retryable: false
+    };
+  }
+  if (status === 429 && rawCode === "concurrency_limit_reached") {
+    return {
+      code: "concurrency_limit_reached",
+      message: userSafeMessage(rawMessage) ?? overrides.concurrencyLimitFallback,
+      retryable: true
+    };
+  }
+  if (status === 400 || status === 422) {
+    return {
+      code: "invalid_request",
+      message: userSafeMessage(rawMessage) ?? ERROR_SEMANTICS.bad_request.message,
+      retryable: false
+    };
+  }
+  const recognised = !rawCode || isKnownErrorCode(rawCode);
+  const byStatus = recognised && status < 500 ? semanticsForStatus(status) : void 0;
+  if (byStatus) {
+    return {
+      code: status === 503 ? "service_unavailable" : defaultCodeForStatus(status),
+      message: byStatus.message,
+      retryable: byStatus.retryable
+    };
+  }
+  if (status >= 500) {
+    return { code: "service_unavailable", message: ERROR_SEMANTICS.unavailable.message, retryable: true };
+  }
+  return {
+    code: status === 0 && rawCode === "network_error" ? "network_error" : "request_failed",
+    message: userSafeMessage(rawMessage) ?? overrides.requestFailedFallback,
+    retryable: status === 0 || status >= 500
+  };
+}
+
 // ../client/src/errors.ts
 var RealtimeAvatarApiError = class _RealtimeAvatarApiError extends Error {
   constructor(message, status, body, response, metadata = {}) {
@@ -359,72 +484,27 @@ var RealtimeAvatarCapacityError = class extends Error {
     return this.busy.recommended_retry_ms;
   }
 };
+function readRecord(value) {
+  return typeof value === "object" && value !== null ? { ...value } : null;
+}
 function extractErrorMessage(body) {
-  if (!body || typeof body !== "object") return typeof body === "string" && body ? body : null;
-  const record = body;
-  const detail = readMessageValue(record.detail);
-  if (detail) return detail;
-  const error = readMessageValue(record.error);
-  if (error) return error;
-  const message = readMessageValue(record.message);
-  if (message) return message;
-  return null;
+  if (typeof body === "string") return body || null;
+  const record = readRecord(body);
+  if (!record) return null;
+  return readMessageValue(record.detail) ?? readMessageValue(record.error) ?? readMessageValue(record.message);
 }
 function normalizeRealtimeAvatarError(input) {
-  const status = input.status ?? 0;
-  const rawCode = input.code?.trim() || null;
-  const rawMessage = input.message?.trim() || "";
-  const blob = `${rawCode ?? ""} ${rawMessage}`.toLowerCase();
-  if (rawCode === "insufficient_credits" || rawCode === "spend_limit_exceeded" || status === 402) {
-    return {
-      code: rawCode ?? "billing_required",
-      message: rawMessage && !hasInternalDetail(rawMessage) ? rawMessage : "Add credits to continue using realtime avatars.",
-      retryable: false
-    };
-  }
-  if (status === 401) {
-    return { code: "unauthorized", message: "Authentication is required to use Realtime Avatar.", retryable: false };
-  }
-  if (status === 403) {
-    return { code: "forbidden", message: "This API key does not have access to that action.", retryable: false };
-  }
-  if (status === 404 || blob.includes("unknown avatar_id") || blob.includes("avatar not found")) {
-    return { code: "not_found", message: "We could not find that avatar or resource.", retryable: false };
-  }
-  if (status === 409) {
-    return { code: "conflict", message: "That request is already in progress. Try again in a moment.", retryable: true };
-  }
-  if (status === 429 && rawCode === "concurrency_limit_reached") {
-    return {
-      code: rawCode,
-      message: userSafeMessage(rawMessage) ?? "The concurrent session limit is reached. Active and starting sessions count. End a session or wait for pending starts to clear, then retry.",
-      retryable: true
-    };
-  }
-  if (status === 429) {
-    return { code: "rate_limited", message: "Too many realtime requests. Please slow down and retry.", retryable: true };
-  }
-  if (isWarmingMessage(blob)) {
-    return { code: "service_unavailable", message: "Realtime Avatar is warming up. Try again in a moment.", retryable: true };
-  }
-  if (status === 400 || status === 422) {
-    return { code: "invalid_request", message: userSafeMessage(rawMessage) ?? "Check the request and try again.", retryable: false };
-  }
-  if (status >= 500) {
-    return { code: "service_unavailable", message: "Realtime Avatar is temporarily unavailable. Try again in a moment.", retryable: true };
-  }
-  return {
-    code: isPublicErrorCode(rawCode) ? rawCode : "request_failed",
-    message: userSafeMessage(rawMessage) ?? "Realtime Avatar request failed. Try again.",
-    retryable: status === 0 || status >= 500
-  };
+  return normalizeError(input, {
+    concurrencyLimitFallback: CONCURRENCY_LIMIT_FALLBACK_MESSAGE,
+    requestFailedFallback: "Realtime Avatar request failed. Try again."
+  });
 }
 function extractErrorMetadata(body, status, rawMessage) {
-  if (!body || typeof body !== "object") {
+  const record = readRecord(body);
+  if (!record) {
     const normalized2 = normalizeRealtimeAvatarError({ status, message: rawMessage });
     return { ...normalized2, rawMessage };
   }
-  const record = body;
   const code = typeof record.code === "string" ? record.code : null;
   const normalized = normalizeRealtimeAvatarError({ status, code, message: rawMessage });
   return {
@@ -435,38 +515,13 @@ function extractErrorMetadata(body, status, rawMessage) {
     message: normalized.message
   };
 }
-var PUBLIC_ERROR_CODES = /* @__PURE__ */ new Set([
-  "billing_required",
-  "invalid_request",
-  "unauthorized",
-  "forbidden",
-  "not_found",
-  "conflict",
-  "rate_limited",
-  "service_unavailable",
-  "request_failed",
-  "network_error"
-]);
-function isPublicErrorCode(code) {
-  return Boolean(code && PUBLIC_ERROR_CODES.has(code));
-}
+var CONCURRENCY_LIMIT_FALLBACK_MESSAGE = "The concurrent session limit is reached. Active and starting sessions count. End a session or wait for pending starts to clear, then retry.";
 function readMessageValue(value) {
   if (typeof value === "string") return value.trim() || null;
-  if (!value || typeof value !== "object") return null;
-  const record = value;
+  const record = readRecord(value);
+  if (!record) return null;
   return readMessageValue(record.message) ?? readMessageValue(record.error) ?? readMessageValue(record.detail);
 }
-function userSafeMessage(message) {
-  if (!message || hasInternalDetail(message)) return null;
-  return message.length > 180 ? `${message.slice(0, 177)}...` : message;
-}
-function isWarmingMessage(blob) {
-  return blob.includes("warming") || blob.includes("not ready") || blob.includes("starting up");
-}
-var MACHINE_SHAPED = /[_=<>{}\[\]|\\$`]|\w+\.\w+\.\w|\S:\d|\w\(\)|^\s*(?:at|File)\b/mu;
-function hasInternalDetail(message) {
-  return MACHINE_SHAPED.test(message);
-}
 function splitCallTranscript(all, localIdentity) {
   if (!localIdentity) return { user: [], agent: all };
   const user = [];
@@ -2922,7 +2977,7 @@ function SessionLifecycleRoomBridge({
   }, [connectionHistoryGrant, detailsSessionId]);
   useEffect(() => {
     const collector = connectionHistoryRef.current;
-    if (!collector || typeof window === "undefined") return;
+    if (!collector || typeof window === "undefined" || typeof window.addEventListener !== "function" || typeof window.removeEventListener !== "function") return;
     const flush = () => {
       void collector.flush();
     };

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_failed: "recording_failed";
         recording_unavailable: "recording_unavailable";
+        recording_failed: "recording_failed";
     }>;
 }, 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_failed: "recording_failed";
             recording_unavailable: "recording_unavailable";
+            recording_failed: "recording_failed";
         }>;
     }, 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-BnlnrYgN.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';
 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-OESXLLQB.js';
+export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, listRecordingsResponseSchema, recordingAccessResponseSchema, recordingArtifactSchema, recordingModeSchema, verifyTranscript } from './chunk-27XNZHSF.js';
 import './chunk-MCIXU6XP.js';

package/dist/tanstack-start.d.ts

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

package/dist/tanstack-start.js

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

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

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

@@ -110,6 +110,9 @@ interface components {
                 idle?: {
                     clips: string[];
                     weight?: number;
+                    weights?: {
+                        [key: string]: number;
+                    };
                 };
                 on?: {
                     userSpeechStarted?: {
@@ -172,6 +175,19 @@ interface components {
             require_ready_clip_library?: 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. */
+            readonly releaseIdentity?: {
+                deploymentId: string | null;
+                workerRevision: string | null;
+                provenance: {
+                    /** @constant */
+                    deploymentSource: "cloudflare-worker-version";
+                    workerSource: "authenticated-worker-heartbeat" | null;
+                    workerId: string | null;
+                    podStartedAtMs: number | null;
+                    workerObservedAt: string | null;
+                };
+            };
             /**
              * @default ready
              * @constant
@@ -471,6 +487,19 @@ interface components {
         ListUsageSessionsResponse: {
             data: {
                 sessionId: string;
+                /** @description Returned only for X-RTA-Release-Evidence: 1. Omitted by default for strict client compatibility. Evidence is stored against this session; missing evidence remains null. */
+                readonly releaseIdentity?: {
+                    deploymentId: string | null;
+                    workerRevision: string | null;
+                    provenance: {
+                        /** @constant */
+                        deploymentSource: "cloudflare-worker-version";
+                        workerSource: "authenticated-worker-heartbeat" | null;
+                        workerId: string | null;
+                        podStartedAtMs: number | null;
+                        workerObservedAt: string | null;
+                    };
+                };
                 avatarId: string | null;
                 avatarName: string | null;
                 /** @enum {string} */
@@ -667,6 +696,9 @@ interface components {
                 idle?: {
                     clips: string[];
                     weight?: number;
+                    weights?: {
+                        [key: string]: number;
+                    };
                 };
                 on?: {
                     userSpeechStarted?: {
@@ -703,6 +735,9 @@ interface components {
             idle?: {
                 clips: string[];
                 weight?: number;
+                weights?: {
+                    [key: string]: number;
+                };
             };
             on?: {
                 userSpeechStarted?: {
@@ -763,6 +798,9 @@ interface components {
                 idle?: {
                     clips: string[];
                     weight?: number;
+                    weights?: {
+                        [key: string]: number;
+                    };
                 };
                 on?: {
                     userSpeechStarted?: {

package/package.json

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

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

@@ -268,8 +268,8 @@ declare const liveKitSessionGrantSchema: z.ZodObject<{
         retainedUntil: z.ZodString;
         status: z.ZodLiteral<"failed">;
         errorCode: z.ZodEnum<{
-            recording_failed: "recording_failed";
             recording_unavailable: "recording_unavailable";
+            recording_failed: "recording_failed";
         }>;
     }, z.core.$strict>], "status">>;
     connection_history: z.ZodOptional<z.ZodObject<{