realtime-avatar 0.24.1 → 0.25.0

package/dist/chunk-DNHHQ5GZ.js

@@ -0,0 +1,143 @@
+import { RealtimeAvatar, ROUTE_TIMEOUT_MS, isQueued, RealtimeAvatarHttpError, RealtimeAvatarError } from './chunk-GMYGHDY2.js';
+
+// ../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 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" } };
+Object.values(MESSAGE_SHAPE_PATTERNS).map(
+  (pattern) => new RegExp(pattern.source, pattern.flags)
+);
+
+// ../proxy/src/config.ts
+var MISCONFIGURED = "internal_error";
+var TIMED_OUT = "upstream_timeout";
+var json = (body, status = 200) => new Response(JSON.stringify(body), {
+  status,
+  headers: { "content-type": "application/json", "cache-control": "no-store" }
+});
+function relayFailure(operation, error) {
+  const misconfigured = error.status === 401 || error.status === 403;
+  const status = misconfigured ? ERROR_SEMANTICS[MISCONFIGURED].statuses[0] : error.status;
+  const verdict = error.retryable === void 0 ? {} : { retryable: error.retryable };
+  const body = misconfigured ? { code: MISCONFIGURED, status, retryable: false } : error.status === 429 ? throttled(error) : { code: error.isBilling ? error.code ?? "insufficient_credits" : error.code, status, ...verdict };
+  console.error(
+    `realtime-avatar: platform answered ${operation} with ${error.status} (code ${error.code ?? "none"}, requestId ${error.requestId ?? "none"}); relayed as ${status}` + (misconfigured ? " \u2014 the platform refused this route's API key" : "")
+  );
+  const response = json({ ...body, ...error.requestId ? { requestId: error.requestId } : {} }, status);
+  if (error.requestId) response.headers.set("X-Request-ID", error.requestId);
+  return response;
+}
+function timedOut(operation) {
+  const { retryable, statuses: [status] } = ERROR_SEMANTICS[TIMED_OUT];
+  console.error(`realtime-avatar: platform did not answer ${operation} inside the route's budget; answered ${status}`);
+  return json({ code: TIMED_OUT, status, retryable }, status);
+}
+function throttled(error) {
+  const concurrency = error.code === "concurrency_limit_reached";
+  const counts = error.concurrency;
+  const message = concurrency ? counts?.maxConcurrentSessions !== void 0 && counts.activeSessions !== void 0 && counts.connectingSessions !== void 0 && counts.pendingSessions !== void 0 ? `Session limit reached (${counts.maxConcurrentSessions} allowed): ${counts.activeSessions} active, ${counts.connectingSessions} connecting, ${counts.pendingSessions} starting. End a session or wait for pending starts to clear, then retry.` : "The concurrent session limit is reached. Active and starting sessions count. End a session or wait for pending starts to clear, then retry." : "Too many requests. Wait before retrying.";
+  return {
+    error: message,
+    code: concurrency ? "concurrency_limit_reached" : "rate_limited",
+    status: 429,
+    retryable: error.retryable ?? true,
+    ...concurrency ? counts : {}
+  };
+}
+function operationFor(pathname, method) {
+  const tail = pathname.replace(/\/+$/, "").split("/").pop() ?? "";
+  if (method === "POST" && (tail === "connect" || tail === "call")) return "connect";
+  if (method === "POST" && (tail === "end" || tail === "release")) return "end";
+  if (method === "GET" && tail === "avatars") return "avatars";
+  if (method === "GET" && tail === "credits") return "credits";
+  return null;
+}
+function createProxyHandler(config) {
+  const minted = /* @__PURE__ */ new Map();
+  const MINTED_TTL_MS = 30 * 6e4;
+  return async (request) => {
+    const url = new URL(request.url);
+    const operation = operationFor(url.pathname, request.method);
+    if (!operation) return json({ error: "not found" }, 404);
+    const refusal = await config.authorize?.({ request, operation });
+    if (refusal instanceof Response) return refusal;
+    const apiKey = typeof config.apiKey === "function" ? await config.apiKey() : config.apiKey;
+    const rta = new RealtimeAvatar({ apiKey, baseUrl: config.baseUrl, totalTimeoutMs: config.timeoutMs ?? ROUTE_TIMEOUT_MS });
+    try {
+      if (operation === "avatars") return json({ data: await rta.listAvatars() });
+      if (operation === "credits") return json(await rta.creditBalance());
+      if (operation === "end") {
+        const ended = await request.json().catch(() => ({}));
+        const sessionId = ended.session_id ?? ended.queue_ticket_id;
+        if (!sessionId) return json({ error: "session_id or queue_ticket_id is required" }, 422);
+        const owns = config.ownsSession ? await config.ownsSession({ request, sessionId }) : minted.delete(sessionId);
+        if (!owns) return new Response(null, { status: 204 });
+        const reason = ended.reason === "page_hide" || ended.reason === "unmount" ? ended.reason : "manual";
+        await rta.endCall(sessionId, { reason });
+        return new Response(null, { status: 204 });
+      }
+      const body = await request.json().catch(() => ({}));
+      if (!body.avatarId) return json({ error: "avatarId is required" }, 422);
+      const mode = body.mode === "voice" ? "voice" : "avatar";
+      const decided = await config.session?.({ request, avatarId: body.avatarId, mode });
+      if (decided instanceof Response) return decided;
+      const call = await rta.startCall({ avatarId: body.avatarId, mode, ...decided ?? {} });
+      if (isQueued(call)) {
+        if (call.queueTicketId) minted.set(call.queueTicketId, Date.now());
+        return json(
+          {
+            queued: true,
+            position: call.position,
+            size: call.size,
+            retryAfterMs: call.retryAfterMs,
+            queue_ticket_id: call.queueTicketId
+          },
+          429
+        );
+      }
+      const now = Date.now();
+      for (const [id, at] of minted) if (now - at > MINTED_TTL_MS) minted.delete(id);
+      minted.set(call.sessionId, now);
+      return json(call.raw);
+    } catch (error) {
+      if (error instanceof RealtimeAvatarHttpError) return relayFailure(operation, error);
+      if (error instanceof RealtimeAvatarError && error.cause instanceof Error && error.cause.name === "TimeoutError") {
+        return timedOut(operation);
+      }
+      throw error;
+    }
+  };
+}
+
+export { createProxyHandler };

package/dist/{chunk-EODL5S3A.js → chunk-GMYGHDY2.js}

@@ -8,11 +8,16 @@ var RealtimeAvatarError = class extends Error {
     this.name = "RealtimeAvatarError";
   }
 };
+function isRequestId(value) {
+  return typeof value === "string" && /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i.test(value);
+}
 var RealtimeAvatarHttpError = class extends RealtimeAvatarError {
   status;
   code;
   body;
   requestId;
+  /** The platform's own verdict on retrying as-is, when its body gave one. */
+  retryable;
   concurrency;
   constructor(status, code, body, requestId) {
     const bounded = body.slice(0, 400);
@@ -27,8 +32,8 @@ var RealtimeAvatarHttpError = class extends RealtimeAvatarError {
       if (value && typeof value === "object" && !Array.isArray(value)) parsed = value;
     } catch {
     }
-    const validId = (value) => typeof value === "string" && /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i.test(value);
-    this.requestId = validId(parsed.requestId) ? parsed.requestId : validId(requestId) ? requestId : void 0;
+    this.requestId = isRequestId(parsed.requestId) ? parsed.requestId : isRequestId(requestId) ? requestId : void 0;
+    if (typeof parsed.retryable === "boolean") this.retryable = parsed.retryable;
     if (status === 429 && code === "concurrency_limit_reached") {
       this.concurrency = {};
       for (const key of ["maxConcurrentSessions", "liveSessions", "activeSessions", "connectingSessions", "pendingSessions"]) {
@@ -293,6 +298,12 @@ function backoffMs(attempt, retryAfter) {
   return Math.random() * Math.min(500 * 2 ** attempt, 8e3);
 }
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var PROXY_CLIENT_TIMEOUT_MS = 6e4;
+var ROUTE_TIMEOUT_MS = PROXY_CLIENT_TIMEOUT_MS - 1e4;
+function retryFits(attemptStartedAt, waitMs, deadline) {
+  const now = Date.now();
+  return now + waitMs + (now - attemptStartedAt) <= deadline;
+}
 function isTransient(cause) {
   const name = cause?.name;
   return name === "TimeoutError" || name === "TypeError" || name === "FetchError";
@@ -654,12 +665,13 @@ z.enum([
 
 // ../http-client/src/client.ts
 var DEFAULT_BASE_URL = "https://realtimeavatar.ai/api/v1";
-var SDK_VERSION = "0.24.1";
+var SDK_VERSION = "0.25.0";
 var RealtimeAvatar = class {
   #apiKey;
   #baseUrl;
   #fetch;
   #timeoutMs;
+  #totalTimeoutMs;
   #maxRetries;
   #userAgent;
   constructor(options) {
@@ -673,6 +685,7 @@ var RealtimeAvatar = class {
     this.#baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
     this.#fetch = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
     this.#timeoutMs = options.timeoutMs ?? 6e4;
+    this.#totalTimeoutMs = options.totalTimeoutMs;
     this.#maxRetries = Math.max(0, options.maxRetries ?? 2);
     this.#userAgent = [`realtime-avatar-sdk/${SDK_VERSION}`, runtimeTag(), options.userAgent].filter(Boolean).join(" ");
   }
@@ -1099,24 +1112,29 @@ var RealtimeAvatar = class {
       body = JSON.stringify(init.json);
     }
     if (MUTATING.has(method)) headers["idempotency-key"] = newIdempotencyKey();
+    const deadline = this.#totalTimeoutMs === void 0 ? Infinity : Date.now() + this.#totalTimeoutMs;
     let lastError;
     for (let attempt = 0; ; attempt++) {
+      const startedAt = Date.now();
       try {
-        const signal = AbortSignal.timeout(this.#timeoutMs);
+        const signal = AbortSignal.timeout(Math.max(0, Math.min(this.#timeoutMs, deadline - startedAt)));
         const response = await this.#fetch(`${this.#baseUrl}${path}`, { method, headers, body, signal });
         if (attempt >= this.#maxRetries || !RETRYABLE_STATUS.has(response.status)) return response;
+        const wait = backoffMs(attempt, response.headers.get("retry-after"));
+        if (!retryFits(startedAt, wait, deadline)) return response;
         await response.body?.cancel().catch(() => {
         });
-        await sleep(backoffMs(attempt, response.headers.get("retry-after")));
+        await sleep(wait);
       } catch (cause) {
         lastError = cause;
-        if (attempt >= this.#maxRetries || !isTransient(cause) || isStream(body)) {
+        const wait = backoffMs(attempt, null);
+        if (attempt >= this.#maxRetries || !isTransient(cause) || isStream(body) || !retryFits(startedAt, wait, deadline)) {
           throw new RealtimeAvatarError(
             `${method} ${path} failed after ${attempt + 1} attempt(s): ${cause.message}`,
             { cause: lastError }
           );
         }
-        await sleep(backoffMs(attempt, null));
+        await sleep(wait);
       }
     }
   }
@@ -1263,4 +1281,4 @@ function isQueued(result) {
   return "queued" in result;
 }
 
-export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, listRecordingsResponseSchema, recordingAccessResponseSchema, recordingArtifactSchema, recordingModeSchema, verifyTranscript };
+export { ROUTE_TIMEOUT_MS, RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, listRecordingsResponseSchema, recordingAccessResponseSchema, recordingArtifactSchema, recordingModeSchema, verifyTranscript };

package/dist/express.d.ts

@@ -1,4 +1,4 @@
-import { P as ProxyConfig } from './types-CpqMHna3.js';
+import { P as ProxyConfig } from './types-C7B7jOx6.js';
 import './types-D77jgSms.js';
 import 'zod';
 

package/dist/express.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-4PWWEERK.js';
-import './chunk-EODL5S3A.js';
+import { createProxyHandler } from './chunk-DNHHQ5GZ.js';
+import './chunk-GMYGHDY2.js';
 import './chunk-MCIXU6XP.js';
 
 // ../proxy/src/express.ts
@@ -16,7 +16,9 @@ function realtimeAvatarExpress(config) {
       body: req.method === "GET" ? void 0 : JSON.stringify(req.body ?? {})
     });
     const response = await handler(request);
-    res.status(response.status).set("content-type", "application/json").send(await response.text());
+    res.status(response.status).set("content-type", "application/json");
+    response.headers.forEach((value, field) => res.set(field, value));
+    res.send(await response.text());
   };
 }
 

package/dist/hono.d.ts

@@ -1,4 +1,4 @@
-import { P as ProxyConfig } from './types-CpqMHna3.js';
+import { P as ProxyConfig } from './types-C7B7jOx6.js';
 import './types-D77jgSms.js';
 import 'zod';
 

package/dist/hono.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-4PWWEERK.js';
-import './chunk-EODL5S3A.js';
+import { createProxyHandler } from './chunk-DNHHQ5GZ.js';
+import './chunk-GMYGHDY2.js';
 import './chunk-MCIXU6XP.js';
 
 // ../proxy/src/hono.ts

package/dist/index.d.ts

@@ -8,8 +8,17 @@ interface RealtimeAvatarOptions {
     apiKey: string;
     baseUrl?: string;
     fetch?: typeof fetch;
-    /** Per-request timeout. Default 60s; starting a call does real work upstream. */
+    /** Per-attempt timeout. Default 60s; starting a call does real work upstream. */
     timeoutMs?: number;
+    /**
+     * The whole request: every attempt and the backoff between them. Default unbounded, so the
+     * worst case is `timeoutMs` per attempt plus up to 20s of `Retry-After` between them.
+     *
+     * Set it when something else is waiting on this request with a deadline of its own (a
+     * browser, a serverless max duration). An attempt is cut off at the budget, and a retry is
+     * started only if it can take as long as the attempt before it and still finish inside it.
+     */
+    totalTimeoutMs?: number;
     /**
      * Extra attempts after a transient failure. Default 2, so 3 attempts in total.
      *
@@ -319,6 +328,8 @@ declare class RealtimeAvatarHttpError extends RealtimeAvatarError {
     readonly code: string | undefined;
     readonly body: string;
     readonly requestId?: string;
+    /** The platform's own verdict on retrying as-is, when its body gave one. */
+    readonly retryable?: boolean;
     readonly concurrency?: Partial<Record<"maxConcurrentSessions" | "liveSessions" | "activeSessions" | "connectingSessions" | "pendingSessions", number>>;
     constructor(status: number, code: string | undefined, body: string, requestId?: string);
     /** Out of credits, or over this key's spend limit. Surface a paywall, not an error. */

package/dist/index.js

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

package/dist/nextjs.d.ts

@@ -1,4 +1,4 @@
-import { P as ProxyConfig } from './types-CpqMHna3.js';
+import { P as ProxyConfig } from './types-C7B7jOx6.js';
 import './types-D77jgSms.js';
 import 'zod';
 

package/dist/nextjs.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-4PWWEERK.js';
-import './chunk-EODL5S3A.js';
+import { createProxyHandler } from './chunk-DNHHQ5GZ.js';
+import './chunk-GMYGHDY2.js';
 import './chunk-MCIXU6XP.js';
 
 // ../proxy/src/nextjs.ts

package/dist/{proxy-client-DlFXaXtn.d.ts → proxy-client-O-Mu9JKt.d.ts}

@@ -1858,7 +1858,11 @@ interface ProxyClientOptions {
     /** Swap the transport — a test double, or a fetch that carries your session cookie. */
     fetch?: typeof globalThis.fetch;
     /**
-     * Per-request deadline, default 60s, `0` to disable.
+     * Per-request deadline, default 60s, `0` to disable. Keep it above your route's `timeoutMs`
+     * (default 50s), so the route's answer arrives before the page stops listening. Running out throws a
+     * `RealtimeAvatarApiError` with `code: "upstream_timeout"` (status 504, `response: null`).
+     * Do not re-send a timed-out `connect` automatically: your route may still be minting it, and
+     * this client never retries a mint — the server client inside your route owns that retry.
      *
      * Not optional in spirit: a proxy that accepts the connection and then never answers leaves
      * a promise that never settles, which presents as a page stuck on "connecting" with no error

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

@@ -414,7 +414,13 @@ function normalizeError(input, overrides) {
   };
 }
 
+// ../http-client/src/errors.ts
+function isRequestId(value) {
+  return typeof value === "string" && /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i.test(value);
+}
+
 // ../client/src/errors.ts
+var TIMEOUT_CODE = "upstream_timeout";
 var RealtimeAvatarApiError = class _RealtimeAvatarApiError extends Error {
   constructor(message, status, body, response, metadata = {}) {
     super(message);
@@ -426,6 +432,7 @@ var RealtimeAvatarApiError = class _RealtimeAvatarApiError extends Error {
     this.retryable = metadata.retryable;
     this.billingUrl = metadata.billingUrl;
     this.rawMessage = metadata.rawMessage ?? null;
+    this.requestId = metadata.requestId;
   }
   status;
   body;
@@ -435,6 +442,8 @@ var RealtimeAvatarApiError = class _RealtimeAvatarApiError extends Error {
   billingUrl;
   /** Debug detail returned by the API. Do not render directly in user-facing UI. */
   rawMessage;
+  /** The platform's correlation ID for this attempt. Quote it to support. */
+  requestId;
   get isBillingRequired() {
     return this.status === 402 || this.code === "insufficient_credits" || this.code === "spend_limit_exceeded";
   }
@@ -443,14 +452,31 @@ var RealtimeAvatarApiError = class _RealtimeAvatarApiError extends Error {
     const body = contentType.includes("application/json") ? await response.clone().json().catch(() => null) : await response.clone().text().catch(() => "");
     const rawMessage = (extractErrorMessage(body) ?? response.statusText) || null;
     const metadata = extractErrorMetadata(body, response.status, rawMessage);
+    const bodyRequestId = readRecord(body)?.requestId;
+    const headerRequestId = response.headers.get("x-request-id");
     return new _RealtimeAvatarApiError(
       metadata.message,
       response.status,
       body,
       response,
-      metadata
+      {
+        ...metadata,
+        requestId: isRequestId(bodyRequestId) ? bodyRequestId : isRequestId(headerRequestId) ? headerRequestId : void 0
+      }
     );
   }
+  /**
+   * A request that got no answer before its deadline. The status is the one the vocabulary pairs
+   * with the code, so `normalizeRealtimeAvatarError` reads it back as the same failure.
+   */
+  static timeout(timeoutMs) {
+    const { message, retryable, statuses: [status] } = ERROR_SEMANTICS[TIMEOUT_CODE];
+    return new _RealtimeAvatarApiError(message, status, null, null, {
+      code: TIMEOUT_CODE,
+      retryable,
+      rawMessage: `No response within ${timeoutMs}ms.`
+    });
+  }
 };
 var RealtimeAvatarCapacityError = class extends Error {
   constructor(message, busy) {
@@ -3270,26 +3296,30 @@ function useRealtimeSession(input) {
   );
 }
 
+// ../http-client/src/retry.ts
+var PROXY_CLIENT_TIMEOUT_MS = 6e4;
+
 // ../client/src/proxy-client.ts
-var DEFAULT_TIMEOUT_MS = 6e4;
 var normalize = (url) => url.replace(/\/+$/, "");
 function createProxyClient(options) {
   const base = normalize(options.proxyUrl);
   const doFetch = options.fetch ?? globalThis.fetch?.bind(globalThis);
-  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-  const deadline = (caller) => {
-    if (!timeoutMs) return caller;
-    const timer = AbortSignal.timeout(timeoutMs);
-    return caller ? AbortSignal.any([caller, timer]) : timer;
-  };
+  const timeoutMs = options.timeoutMs ?? PROXY_CLIENT_TIMEOUT_MS;
   const post = async (path, body, request) => {
     if (!doFetch) throw new Error("realtime-avatar: no fetch available \u2014 pass one via `fetch`.");
-    return doFetch(`${base}${path}`, {
-      method: "POST",
-      headers: { "content-type": "application/json", ...request?.headers ?? {} },
-      body: JSON.stringify(body),
-      signal: deadline(request?.signal)
-    });
+    const caller = request?.signal;
+    const timer = timeoutMs ? AbortSignal.timeout(timeoutMs) : void 0;
+    try {
+      return await doFetch(`${base}${path}`, {
+        method: "POST",
+        headers: { "content-type": "application/json", ...request?.headers ?? {} },
+        body: JSON.stringify(body),
+        signal: timer && caller ? AbortSignal.any([caller, timer]) : timer ?? caller
+      });
+    } catch (cause) {
+      if (timer?.aborted && !caller?.aborted) throw RealtimeAvatarApiError.timeout(timeoutMs);
+      throw cause;
+    }
   };
   const beacon = (path, body) => {
     const send = globalThis.navigator?.sendBeacon?.bind(globalThis.navigator);

package/dist/react.d.ts

@@ -1,6 +1,6 @@
 import { RegisteredTool, ToolRegistration } from './tools.js';
-import { aj as SessionLifecycleRoomBridgeProps, h as AvatarSessionClient, A as AvatarVideoFit } from './proxy-client-DlFXaXtn.js';
-export { a as AdaptivePlayoutController, b as AdaptivePlayoutDecision, c as AdaptivePlayoutOptions, d as AdaptivePlayoutSample, e as ApproachingEndEvent, f as ApproachingEndReason, g as AvatarConnectionDetails, aQ as AvatarVideoSurface, aR 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, u as DeclaredInputSource, E as EndReason, v as EndedEvent, w as ExtendResult, F as FishTtsModel, x as FreezeReadingFn, G as Governor, y as GovernorAction, z as GovernorConfig, H as GovernorSignal, I as GovernorState, J as GraceWindowClosedEvent, K as GraceWindowOpenEvent, M as GraceWindowState, N as IdleWarningEvent, O as InboundRtpCursor, P as InboundRtpReading, Q as KnownBehaviorState, R as LLMProvider, S as LLMSelection, T as LiveKitAvatarGrantState, U as LiveKitAvatarGrantStatus, V as LiveKitCapacityState, W as LiveKitConnectionStatus, X as LiveKitSessionRequest, Y as LiveKitSessionStartResult, aS as LivePlaybackKeeper, Z as MAX_RECONNECT_ATTEMPTS, _ as MAX_SESSION_INSTRUCTIONS_CHARS, aT as MIC_LEASE_ENDED_TIMEOUT_MS, aU as MicLease, aV as NETWORK_QUALITY_POLICY, aW as NetworkQualityStatus, aX as PlayableVideoElement, $ as ProxyClientOptions, a0 as QualityCap, a1 as RECONNECT_BACKOFF_MS, aY as RealtimeAvatarCapacityError, aZ as RealtimeAvatarLiveKitRoom, a_ as RealtimeAvatarLiveKitRoomProps, a2 as RealtimeAvatarRequestOptions, a3 as RealtimeSessionApi, a4 as RealtimeSessionMedia, a5 as RealtimeSessionRoomSinks, a6 as ReconnectPolicy, a7 as ReconnectingEvent, a8 as RecoveryState, a9 as RetryStep, aa as SendTurnOptions, ab as SessionBehavior, ac as SessionClip, ad as SessionClocks, ae as SessionEndReason, af as SessionLifecycleApi, ag as SessionLifecyclePhase, ah as SessionLifecyclePhaseKind, ai as SessionLifecycleRoomBridge, ak as SurfaceLayers, al as TranscriptSender, am as TranscriptSenderOptions, an as TurnState, ao as TurnTimeoutEvent, ap as UseAvatarQualityGovernorInput, aq as UseLiveKitAvatarGrantInput, ar as UseRealtimeSessionInput, as as UseSessionLifecycleInput, at as VoiceSpec, au as VoiceSpecInput, av as capacityErrorFromBusy, aw as capacityStateFromGrant, ax as createProxyClient, az as knownBehaviorStates, aA as mapTurnState, aB as readInboundRtp, aC as sessionBehaviorSchema, aD as sessionClipSchema, a$ as shouldReplayPendingTurn, aE as splitCallTranscript, aF as useAvatarAdaptivePlayoutDelay, aG as useAvatarCamera, aH as useAvatarPlayoutDelay, aI as useAvatarQualityGovernor, aJ as useCallTranscript, aK as useLiveKitAvatarGrant, aM as useMicLease, aN as useRealtimeSession, aO as useReleaseMicLeaseOnTrackEnded, aP as useSessionLifecycle } from './proxy-client-DlFXaXtn.js';
+import { aj as SessionLifecycleRoomBridgeProps, h as AvatarSessionClient, A as AvatarVideoFit } from './proxy-client-O-Mu9JKt.js';
+export { a as AdaptivePlayoutController, b as AdaptivePlayoutDecision, c as AdaptivePlayoutOptions, d as AdaptivePlayoutSample, e as ApproachingEndEvent, f as ApproachingEndReason, g as AvatarConnectionDetails, aQ as AvatarVideoSurface, aR 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, u as DeclaredInputSource, E as EndReason, v as EndedEvent, w as ExtendResult, F as FishTtsModel, x as FreezeReadingFn, G as Governor, y as GovernorAction, z as GovernorConfig, H as GovernorSignal, I as GovernorState, J as GraceWindowClosedEvent, K as GraceWindowOpenEvent, M as GraceWindowState, N as IdleWarningEvent, O as InboundRtpCursor, P as InboundRtpReading, Q as KnownBehaviorState, R as LLMProvider, S as LLMSelection, T as LiveKitAvatarGrantState, U as LiveKitAvatarGrantStatus, V as LiveKitCapacityState, W as LiveKitConnectionStatus, X as LiveKitSessionRequest, Y as LiveKitSessionStartResult, aS as LivePlaybackKeeper, Z as MAX_RECONNECT_ATTEMPTS, _ as MAX_SESSION_INSTRUCTIONS_CHARS, aT as MIC_LEASE_ENDED_TIMEOUT_MS, aU as MicLease, aV as NETWORK_QUALITY_POLICY, aW as NetworkQualityStatus, aX as PlayableVideoElement, $ as ProxyClientOptions, a0 as QualityCap, a1 as RECONNECT_BACKOFF_MS, aY as RealtimeAvatarCapacityError, aZ as RealtimeAvatarLiveKitRoom, a_ as RealtimeAvatarLiveKitRoomProps, a2 as RealtimeAvatarRequestOptions, a3 as RealtimeSessionApi, a4 as RealtimeSessionMedia, a5 as RealtimeSessionRoomSinks, a6 as ReconnectPolicy, a7 as ReconnectingEvent, a8 as RecoveryState, a9 as RetryStep, aa as SendTurnOptions, ab as SessionBehavior, ac as SessionClip, ad as SessionClocks, ae as SessionEndReason, af as SessionLifecycleApi, ag as SessionLifecyclePhase, ah as SessionLifecyclePhaseKind, ai as SessionLifecycleRoomBridge, ak as SurfaceLayers, al as TranscriptSender, am as TranscriptSenderOptions, an as TurnState, ao as TurnTimeoutEvent, ap as UseAvatarQualityGovernorInput, aq as UseLiveKitAvatarGrantInput, ar as UseRealtimeSessionInput, as as UseSessionLifecycleInput, at as VoiceSpec, au as VoiceSpecInput, av as capacityErrorFromBusy, aw as capacityStateFromGrant, ax as createProxyClient, az as knownBehaviorStates, aA as mapTurnState, aB as readInboundRtp, aC as sessionBehaviorSchema, aD as sessionClipSchema, a$ as shouldReplayPendingTurn, aE as splitCallTranscript, aF as useAvatarAdaptivePlayoutDelay, aG as useAvatarCamera, aH as useAvatarPlayoutDelay, aI as useAvatarQualityGovernor, aJ as useCallTranscript, aK as useLiveKitAvatarGrant, aM as useMicLease, aN as useRealtimeSession, aO as useReleaseMicLeaseOnTrackEnded, aP as useSessionLifecycle } from './proxy-client-O-Mu9JKt.js';
 import { ReactNode } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { R as RecordingArtifact } from './recording-DjswTx5B.js';

package/dist/react.js

@@ -568,7 +568,13 @@ function normalizeError(input, overrides) {
   };
 }
 
+// ../http-client/src/errors.ts
+function isRequestId(value) {
+  return typeof value === "string" && /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i.test(value);
+}
+
 // ../client/src/errors.ts
+var TIMEOUT_CODE = "upstream_timeout";
 var RealtimeAvatarApiError = class _RealtimeAvatarApiError extends Error {
   constructor(message, status, body, response, metadata = {}) {
     super(message);
@@ -580,6 +586,7 @@ var RealtimeAvatarApiError = class _RealtimeAvatarApiError extends Error {
     this.retryable = metadata.retryable;
     this.billingUrl = metadata.billingUrl;
     this.rawMessage = metadata.rawMessage ?? null;
+    this.requestId = metadata.requestId;
   }
   status;
   body;
@@ -589,6 +596,8 @@ var RealtimeAvatarApiError = class _RealtimeAvatarApiError extends Error {
   billingUrl;
   /** Debug detail returned by the API. Do not render directly in user-facing UI. */
   rawMessage;
+  /** The platform's correlation ID for this attempt. Quote it to support. */
+  requestId;
   get isBillingRequired() {
     return this.status === 402 || this.code === "insufficient_credits" || this.code === "spend_limit_exceeded";
   }
@@ -597,14 +606,31 @@ var RealtimeAvatarApiError = class _RealtimeAvatarApiError extends Error {
     const body = contentType.includes("application/json") ? await response.clone().json().catch(() => null) : await response.clone().text().catch(() => "");
     const rawMessage = (extractErrorMessage(body) ?? response.statusText) || null;
     const metadata = extractErrorMetadata(body, response.status, rawMessage);
+    const bodyRequestId = readRecord(body)?.requestId;
+    const headerRequestId = response.headers.get("x-request-id");
     return new _RealtimeAvatarApiError(
       metadata.message,
       response.status,
       body,
       response,
-      metadata
+      {
+        ...metadata,
+        requestId: isRequestId(bodyRequestId) ? bodyRequestId : isRequestId(headerRequestId) ? headerRequestId : void 0
+      }
     );
   }
+  /**
+   * A request that got no answer before its deadline. The status is the one the vocabulary pairs
+   * with the code, so `normalizeRealtimeAvatarError` reads it back as the same failure.
+   */
+  static timeout(timeoutMs) {
+    const { message, retryable, statuses: [status] } = ERROR_SEMANTICS[TIMEOUT_CODE];
+    return new _RealtimeAvatarApiError(message, status, null, null, {
+      code: TIMEOUT_CODE,
+      retryable,
+      rawMessage: `No response within ${timeoutMs}ms.`
+    });
+  }
 };
 var RealtimeAvatarCapacityError = class extends Error {
   constructor(message, busy) {
@@ -3896,26 +3922,30 @@ function AvatarCall(props) {
   return view;
 }
 
+// ../http-client/src/retry.ts
+var PROXY_CLIENT_TIMEOUT_MS = 6e4;
+
 // ../client/src/proxy-client.ts
-var DEFAULT_TIMEOUT_MS = 6e4;
 var normalize = (url) => url.replace(/\/+$/, "");
 function createProxyClient(options) {
   const base = normalize(options.proxyUrl);
   const doFetch = options.fetch ?? globalThis.fetch?.bind(globalThis);
-  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-  const deadline = (caller) => {
-    if (!timeoutMs) return caller;
-    const timer = AbortSignal.timeout(timeoutMs);
-    return caller ? AbortSignal.any([caller, timer]) : timer;
-  };
+  const timeoutMs = options.timeoutMs ?? PROXY_CLIENT_TIMEOUT_MS;
   const post = async (path, body, request) => {
     if (!doFetch) throw new Error("realtime-avatar: no fetch available \u2014 pass one via `fetch`.");
-    return doFetch(`${base}${path}`, {
-      method: "POST",
-      headers: { "content-type": "application/json", ...request?.headers ?? {} },
-      body: JSON.stringify(body),
-      signal: deadline(request?.signal)
-    });
+    const caller = request?.signal;
+    const timer = timeoutMs ? AbortSignal.timeout(timeoutMs) : void 0;
+    try {
+      return await doFetch(`${base}${path}`, {
+        method: "POST",
+        headers: { "content-type": "application/json", ...request?.headers ?? {} },
+        body: JSON.stringify(body),
+        signal: timer && caller ? AbortSignal.any([caller, timer]) : timer ?? caller
+      });
+    } catch (cause) {
+      if (timer?.aborted && !caller?.aborted) throw RealtimeAvatarApiError.timeout(timeoutMs);
+      throw cause;
+    }
   };
   const beacon = (path, body) => {
     const send = globalThis.navigator?.sendBeacon?.bind(globalThis.navigator);

package/dist/server.js

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

package/dist/tanstack-start.d.ts

@@ -1,4 +1,4 @@
-import { P as ProxyConfig } from './types-CpqMHna3.js';
+import { P as ProxyConfig } from './types-C7B7jOx6.js';
 import './types-D77jgSms.js';
 import 'zod';
 

package/dist/tanstack-start.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-4PWWEERK.js';
-import './chunk-EODL5S3A.js';
+import { createProxyHandler } from './chunk-DNHHQ5GZ.js';
+import './chunk-GMYGHDY2.js';
 import './chunk-MCIXU6XP.js';
 
 // src/tanstack-start.ts

package/dist/{types-CpqMHna3.d.ts → types-C7B7jOx6.d.ts}

@@ -16,6 +16,13 @@ interface ProxyConfig {
     /** Server-only. `tic_live_…` / `tic_test_…`. */
     apiKey: string | (() => string | Promise<string>);
     baseUrl?: string;
+    /**
+     * How long this route spends on one platform request, every retry and backoff included.
+     * Default 50s, below `createProxyClient`'s default 60s wait so the page hears the answer. Raise
+     * the browser's `timeoutMs` if you raise this, and keep it under your host's max function
+     * duration. Running out answers `504` `upstream_timeout`.
+     */
+    timeoutMs?: number;
     /**
      * Who may do this. Return a `Response` to refuse, or nothing to allow.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "realtime-avatar",
-  "version": "0.24.1",
+  "version": "0.25.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/chunk-4PWWEERK.js

@@ -1,87 +0,0 @@
-import { RealtimeAvatar, isQueued, RealtimeAvatarHttpError } from './chunk-EODL5S3A.js';
-
-// ../proxy/src/config.ts
-var json = (body, status = 200) => new Response(JSON.stringify(body), {
-  status,
-  headers: { "content-type": "application/json", "cache-control": "no-store" }
-});
-function operationFor(pathname, method) {
-  const tail = pathname.replace(/\/+$/, "").split("/").pop() ?? "";
-  if (method === "POST" && (tail === "connect" || tail === "call")) return "connect";
-  if (method === "POST" && (tail === "end" || tail === "release")) return "end";
-  if (method === "GET" && tail === "avatars") return "avatars";
-  if (method === "GET" && tail === "credits") return "credits";
-  return null;
-}
-function createProxyHandler(config) {
-  const minted = /* @__PURE__ */ new Map();
-  const MINTED_TTL_MS = 30 * 6e4;
-  return async (request) => {
-    const url = new URL(request.url);
-    const operation = operationFor(url.pathname, request.method);
-    if (!operation) return json({ error: "not found" }, 404);
-    const refusal = await config.authorize?.({ request, operation });
-    if (refusal instanceof Response) return refusal;
-    const apiKey = typeof config.apiKey === "function" ? await config.apiKey() : config.apiKey;
-    const rta = new RealtimeAvatar({ apiKey, baseUrl: config.baseUrl });
-    try {
-      if (operation === "avatars") return json({ data: await rta.listAvatars() });
-      if (operation === "credits") return json(await rta.creditBalance());
-      if (operation === "end") {
-        const ended = await request.json().catch(() => ({}));
-        const sessionId = ended.session_id ?? ended.queue_ticket_id;
-        if (!sessionId) return json({ error: "session_id or queue_ticket_id is required" }, 422);
-        const owns = config.ownsSession ? await config.ownsSession({ request, sessionId }) : minted.delete(sessionId);
-        if (!owns) return new Response(null, { status: 204 });
-        const reason = ended.reason === "page_hide" || ended.reason === "unmount" ? ended.reason : "manual";
-        await rta.endCall(sessionId, { reason });
-        return new Response(null, { status: 204 });
-      }
-      const body = await request.json().catch(() => ({}));
-      if (!body.avatarId) return json({ error: "avatarId is required" }, 422);
-      const mode = body.mode === "voice" ? "voice" : "avatar";
-      const decided = await config.session?.({ request, avatarId: body.avatarId, mode });
-      if (decided instanceof Response) return decided;
-      const call = await rta.startCall({ avatarId: body.avatarId, mode, ...decided ?? {} });
-      if (isQueued(call)) {
-        if (call.queueTicketId) minted.set(call.queueTicketId, Date.now());
-        return json(
-          {
-            queued: true,
-            position: call.position,
-            size: call.size,
-            retryAfterMs: call.retryAfterMs,
-            queue_ticket_id: call.queueTicketId
-          },
-          429
-        );
-      }
-      const now = Date.now();
-      for (const [id, at] of minted) if (now - at > MINTED_TTL_MS) minted.delete(id);
-      minted.set(call.sessionId, now);
-      return json(call.raw);
-    } catch (error) {
-      if (error instanceof RealtimeAvatarHttpError && error.status === 429) {
-        const concurrency = error.code === "concurrency_limit_reached";
-        const counts = error.concurrency;
-        const message = concurrency ? counts?.maxConcurrentSessions !== void 0 && counts.activeSessions !== void 0 && counts.connectingSessions !== void 0 && counts.pendingSessions !== void 0 ? `Session limit reached (${counts.maxConcurrentSessions} allowed): ${counts.activeSessions} active, ${counts.connectingSessions} connecting, ${counts.pendingSessions} starting. End a session or wait for pending starts to clear, then retry.` : "The concurrent session limit is reached. Active and starting sessions count. End a session or wait for pending starts to clear, then retry." : "Too many requests. Wait before retrying.";
-        const response = json({
-          error: message,
-          code: concurrency ? "concurrency_limit_reached" : "rate_limited",
-          status: 429,
-          retryable: true,
-          ...concurrency ? counts : {},
-          ...error.requestId ? { requestId: error.requestId } : {}
-        }, 429);
-        if (error.requestId) response.headers.set("X-Request-ID", error.requestId);
-        return response;
-      }
-      if (error instanceof RealtimeAvatarHttpError && error.isBilling) {
-        return json({ code: error.code ?? "insufficient_credits" }, 402);
-      }
-      throw error;
-    }
-  };
-}
-
-export { createProxyHandler };