realtime-avatar 0.11.4 → 0.12.0

package/dist/{chunk-WUUXNNDP.js → chunk-FQWEKJCX.js}

@@ -1,4 +1,4 @@
-import { RealtimeAvatar, isQueued, RealtimeAvatarHttpError } from './chunk-UMFUVCWT.js';
+import { RealtimeAvatar, isQueued, RealtimeAvatarHttpError } from './chunk-ZFYNUHKB.js';
 
 // ../proxy/src/config.ts
 var json = (body, status = 200) => new Response(JSON.stringify(body), {
@@ -61,6 +61,21 @@ function createProxyHandler(config) {
       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);
       }

package/dist/{chunk-UMFUVCWT.js → chunk-ZFYNUHKB.js}

@@ -11,12 +11,32 @@ var RealtimeAvatarHttpError = class extends RealtimeAvatarError {
   status;
   code;
   body;
-  constructor(status, code, body) {
-    super(`Realtime Avatar API ${status}${code ? ` (${code})` : ""}: ${body || "no body"}`);
+  requestId;
+  concurrency;
+  constructor(status, code, body, requestId) {
+    const bounded = body.slice(0, 400);
+    super(`Realtime Avatar API ${status}${code ? ` (${code})` : ""}: ${bounded || "no body"}`);
     this.name = "RealtimeAvatarHttpError";
     this.status = status;
     this.code = code;
-    this.body = body;
+    this.body = bounded;
+    let parsed = {};
+    try {
+      const value = JSON.parse(body);
+      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;
+    if (status === 429 && code === "concurrency_limit_reached") {
+      this.concurrency = {};
+      for (const key of ["maxConcurrentSessions", "liveSessions", "activeSessions", "connectingSessions", "pendingSessions"]) {
+        const value = parsed[key];
+        if (typeof value === "number" && Number.isSafeInteger(value) && value >= (key === "maxConcurrentSessions" ? 1 : 0)) {
+          this.concurrency[key] = value;
+        }
+      }
+    }
   }
   /** Out of credits, or over this key's spend limit. Surface a paywall, not an error. */
   get isBilling() {
@@ -26,12 +46,12 @@ var RealtimeAvatarHttpError = class extends RealtimeAvatarError {
 var motionIdSchema = z.string().regex(/^[A-Za-z0-9_-]{1,64}$/).refine((value) => !["__proto__", "constructor", "prototype"].includes(value), "Reserved identifier");
 function motionRecord(valueSchema) {
   const record = z.record(motionIdSchema, valueSchema);
-  return z.transform((value, ctx) => {
+  return z.preprocess((value, ctx) => {
     if (value !== null && typeof value === "object" && Object.hasOwn(value, "__proto__")) {
       ctx.addIssue({ code: "custom", path: ["__proto__"], message: "Reserved identifier" });
     }
     return value;
-  }).pipe(record);
+  }, record);
 }
 var clipSourceSchema = z.union([
   z.strictObject({ assetId: z.string().trim().min(1).max(160) }),
@@ -134,9 +154,7 @@ var schema13 = z.strictObject({
   "verdict": schema11,
   "issues": schema12,
   "firstFrameUrl": schema4,
-  "lastFrameUrl": schema4,
-  "trimStartMs": schema8,
-  "trimEndMs": schema8
+  "lastFrameUrl": schema4
 });
 var schema14 = z.union([schema13, schema3]);
 var schema15 = z.strictObject({
@@ -218,7 +236,7 @@ function isTransient(cause) {
 
 // ../http-client/src/client.ts
 var DEFAULT_BASE_URL = "https://realtimeavatar.ai/api/v1";
-var SDK_VERSION = "0.11.4";
+var SDK_VERSION = "0.12.0";
 var RealtimeAvatar = class {
   #apiKey;
   #baseUrl;
@@ -270,14 +288,16 @@ var RealtimeAvatar = class {
     if (options.video !== void 0) Object.assign(body, videoToWire(options.video));
     const response = await this.#request("POST", "/realtime/livekit/session", { json: body });
     if (response.status === 429) {
-      const busy = await response.json();
-      return {
-        queued: true,
-        position: typeof busy.queue_position === "number" ? busy.queue_position : null,
-        size: typeof busy.queue_size === "number" ? busy.queue_size : 0,
-        retryAfterMs: typeof busy.recommended_retry_ms === "number" ? busy.recommended_retry_ms : 3e3,
-        queueTicketId: typeof busy.queue_ticket_id === "string" ? busy.queue_ticket_id : null
-      };
+      const busy = await response.clone().json().catch(() => null);
+      if (isRecord(busy) && !("code" in busy) && typeof busy.queue_size === "number" && Number.isFinite(busy.queue_size) && busy.queue_size >= 0 && typeof busy.recommended_retry_ms === "number" && Number.isFinite(busy.recommended_retry_ms) && busy.recommended_retry_ms >= 0) {
+        return {
+          queued: true,
+          position: typeof busy.queue_position === "number" ? busy.queue_position : null,
+          size: busy.queue_size,
+          retryAfterMs: busy.recommended_retry_ms,
+          queueTicketId: typeof busy.queue_ticket_id === "string" ? busy.queue_ticket_id : null
+        };
+      }
     }
     const grant = await this.#json(response);
     return {
@@ -657,7 +677,7 @@ var RealtimeAvatar = class {
       code = JSON.parse(text).code;
     } catch {
     }
-    throw new RealtimeAvatarHttpError(response.status, code, text.slice(0, 400));
+    throw new RealtimeAvatarHttpError(response.status, code, text, response.headers.get("x-request-id") ?? void 0);
   }
 };
 function toUsageSessionPage(raw) {

package/dist/express.d.ts

@@ -1,5 +1,5 @@
-import { P as ProxyConfig } from './types-9a0bRdXl.js';
-import './types-nxdohaiH.js';
+import { P as ProxyConfig } from './types-CJcTowDB.js';
+import './types-B9GTrpx0.js';
 
 type Expressish = {
     method: string;

package/dist/express.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-WUUXNNDP.js';
-import './chunk-UMFUVCWT.js';
+import { createProxyHandler } from './chunk-FQWEKJCX.js';
+import './chunk-ZFYNUHKB.js';
 
 // ../proxy/src/express.ts
 function realtimeAvatarExpress(config) {

package/dist/hono.d.ts

@@ -1,5 +1,5 @@
-import { P as ProxyConfig } from './types-9a0bRdXl.js';
-import './types-nxdohaiH.js';
+import { P as ProxyConfig } from './types-CJcTowDB.js';
+import './types-B9GTrpx0.js';
 
 /**
  * Hono (and anything else built on Fetch handlers — Workers, Bun, Deno).

package/dist/hono.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-WUUXNNDP.js';
-import './chunk-UMFUVCWT.js';
+import { createProxyHandler } from './chunk-FQWEKJCX.js';
+import './chunk-ZFYNUHKB.js';
 
 // ../proxy/src/hono.ts
 function realtimeAvatarHono(config) {

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 CreditBalance, T as TranscriptPayload } from './types-nxdohaiH.js';
-export { l as AvatarClip, m as CallConnection, n as CallQueued, o as ClipDeclaration, p as ClipLibraryPlan, q as ClipSource, r as ContextMessage, s as EndCallReason, V as VideoPolicy, t as isQueued } from './types-nxdohaiH.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 CreditBalance, T as TranscriptPayload } from './types-B9GTrpx0.js';
+export { l as AvatarClip, m as CallConnection, n as CallQueued, o as ClipDeclaration, p as ClipLibraryPlan, q as ClipSource, r as ContextMessage, s as EndCallReason, V as VideoPolicy, t as isQueued } from './types-B9GTrpx0.js';
 import { z } from 'zod';
 
 interface RealtimeAvatarOptions {
@@ -294,6 +294,7 @@ declare class RealtimeAvatarError extends Error {
  * | `loop_pending` · `anchor_pending` | 409 | one is already in flight — wait, then retry |
  * | `revision_conflict` | 409 | someone declared first. Re-read `listClips`, re-decide, re-declare |
  * | `clip_render_limit` | 429 | a true rate limit; nothing was applied. Retry later |
+ * | `concurrency_limit_reached` | 429 | active and starting sessions occupy the limit; release one or wait for pending starts before retrying |
  * | `clip_screen_unavailable` | 503 | the prose screen could not run. Retry |
  *
  * Pose validation does NOT appear here: a rejected upload is not an error response at all.
@@ -308,7 +309,9 @@ declare class RealtimeAvatarHttpError extends RealtimeAvatarError {
     readonly status: number;
     readonly code: string | undefined;
     readonly body: string;
-    constructor(status: number, code: string | undefined, body: string);
+    readonly requestId?: string;
+    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. */
     get isBilling(): boolean;
 }
@@ -338,32 +341,12 @@ declare const clipLibraryDeclarationSchema: z.ZodObject<{
             clips: z.ZodArray<z.ZodString>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    actions: z.ZodOptional<z.ZodPipe<z.ZodTransform<Record<string, {
-        description: string;
-        clips: string[];
-    }>, Record<string, {
-        description: string;
-        clips: string[];
-    }>>, z.ZodRecord<z.ZodString, z.ZodObject<{
+    actions: z.ZodOptional<z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodObject<{
         description: z.ZodString;
         clips: z.ZodArray<z.ZodString>;
     }, z.core.$strict>>>>;
     expectedRevision: z.ZodInt;
-    clips: z.ZodNonOptional<z.ZodPipe<z.ZodTransform<Record<string, {
-        source: {
-            assetId: string;
-        } | {
-            motionPrompt: string;
-            durationSeconds?: number | undefined;
-        };
-    }>, Record<string, {
-        source: {
-            assetId: string;
-        } | {
-            motionPrompt: string;
-            durationSeconds?: number | undefined;
-        };
-    }>>, z.ZodRecord<z.ZodString, z.ZodObject<{
+    clips: z.ZodNonOptional<z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodObject<{
         source: z.ZodUnion<readonly [z.ZodObject<{
             assetId: z.ZodString;
         }, z.core.$strict>, z.ZodObject<{

package/dist/index.js

@@ -1 +1 @@
-export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, verifyTranscript } from './chunk-UMFUVCWT.js';
+export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, verifyTranscript } from './chunk-ZFYNUHKB.js';

package/dist/nextjs.d.ts

@@ -1,5 +1,5 @@
-import { P as ProxyConfig } from './types-9a0bRdXl.js';
-import './types-nxdohaiH.js';
+import { P as ProxyConfig } from './types-CJcTowDB.js';
+import './types-B9GTrpx0.js';
 
 /**
  * App Router. Mount at `app/api/realtime-avatar/[...path]/route.ts`:

package/dist/nextjs.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-WUUXNNDP.js';
-import './chunk-UMFUVCWT.js';
+import { createProxyHandler } from './chunk-FQWEKJCX.js';
+import './chunk-ZFYNUHKB.js';
 
 // ../proxy/src/nextjs.ts
 function createRealtimeAvatarRoute(config) {

package/dist/react-native.js

@@ -241,6 +241,13 @@ function normalizeRealtimeAvatarError(input) {
   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 };
   }
@@ -723,8 +730,28 @@ var DEFAULT_GOVERNOR_CONFIG = {
   downgradeFreezeMs: 150,
   probationFreezeMs: 100,
   openingDwellMs: 2e3,
-  dwellBaseMs: 8e3,
-  dwellMaxMs: 12e4,
+  // HOW LONG THE PICTURE STAYS SOFT AFTER A DEMOTE. Swept against this reducer, 300 s per
+  // run, five link profiles, scored as switches / percent of time on the top rung / worst
+  // single spell on the low cap:
+  //
+  //   profile                      8s x 2^n max 120s   flat 3s        3s x 2^n max 12s
+  //   a spurious blip, link fine    2 /  94% /  19s    2 /  98% / 6s   2 /  97% /  9s
+  //   ordinary jitter, /30s        20 /  61% /  19s   20 /  80% / 6s  20 /  79% /  9s
+  //   flaky, /10s                   9 /   7% / 123s   59 /  40% / 6s  31 /  25% / 15s
+  //   genuinely bad, 600ms /5s      9 /   4% / 123s   59 /  20% / 8s  31 /  11% / 18s
+  //
+  // Two things that table says. First, the old `dwellMaxMs` of 120 s was the real damage:
+  // a link that is merely flaky could sit soft for TWO MINUTES, which is far worse than
+  // the churn the backoff exists to prevent. Second, removing the backoff entirely (flat
+  // 3 s) buys the last few points of quality at 59 switches instead of 31, and a switch is
+  // a decoder reconfigure plus a keyframe wait, measured at about 1.3 s of dead air on a
+  // weak link. So the shape is kept and only the numbers move: start lower, cap far lower.
+  //
+  // This depends on not charging a layer switch to the link (see the size-change reset in
+  // avatar-video-surface). Probing more often is only safe once a failed probe cannot
+  // trigger the next demotion by itself.
+  dwellBaseMs: 3e3,
+  dwellMaxMs: 12e3,
   cleanMs: 3e3,
   probeMs: 1e4,
   healthyResetMs: 12e4
@@ -2575,8 +2602,13 @@ function createProxyClient(options) {
         requestOptions
       );
       if (response.status === 429) {
-        const busy = await response.json().catch(() => ({}));
-        return { status: "busy", busy };
+        const value = await response.clone().json().catch(() => null);
+        if (value && typeof value === "object" && !Array.isArray(value)) {
+          const busy = value;
+          const valid = (n) => typeof n === "number" && Number.isFinite(n) && n >= 0;
+          const queue2 = busy.queued === true && valid(busy.size) && valid(busy.retryAfterMs) || valid(busy.queue_size) && valid(busy.recommended_retry_ms);
+          if (!("code" in busy) && queue2) return { status: "busy", busy };
+        }
       }
       if (!response.ok) {
         throw await RealtimeAvatarApiError.fromResponse(response);

package/dist/react.js

@@ -394,6 +394,13 @@ function normalizeRealtimeAvatarError(input) {
   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 };
   }
@@ -924,8 +931,28 @@ var DEFAULT_GOVERNOR_CONFIG = {
   downgradeFreezeMs: 150,
   probationFreezeMs: 100,
   openingDwellMs: 2e3,
-  dwellBaseMs: 8e3,
-  dwellMaxMs: 12e4,
+  // HOW LONG THE PICTURE STAYS SOFT AFTER A DEMOTE. Swept against this reducer, 300 s per
+  // run, five link profiles, scored as switches / percent of time on the top rung / worst
+  // single spell on the low cap:
+  //
+  //   profile                      8s x 2^n max 120s   flat 3s        3s x 2^n max 12s
+  //   a spurious blip, link fine    2 /  94% /  19s    2 /  98% / 6s   2 /  97% /  9s
+  //   ordinary jitter, /30s        20 /  61% /  19s   20 /  80% / 6s  20 /  79% /  9s
+  //   flaky, /10s                   9 /   7% / 123s   59 /  40% / 6s  31 /  25% / 15s
+  //   genuinely bad, 600ms /5s      9 /   4% / 123s   59 /  20% / 8s  31 /  11% / 18s
+  //
+  // Two things that table says. First, the old `dwellMaxMs` of 120 s was the real damage:
+  // a link that is merely flaky could sit soft for TWO MINUTES, which is far worse than
+  // the churn the backoff exists to prevent. Second, removing the backoff entirely (flat
+  // 3 s) buys the last few points of quality at 59 switches instead of 31, and a switch is
+  // a decoder reconfigure plus a keyframe wait, measured at about 1.3 s of dead air on a
+  // weak link. So the shape is kept and only the numbers move: start lower, cap far lower.
+  //
+  // This depends on not charging a layer switch to the link (see the size-change reset in
+  // avatar-video-surface). Probing more often is only safe once a failed probe cannot
+  // trigger the next demotion by itself.
+  dwellBaseMs: 3e3,
+  dwellMaxMs: 12e3,
   cleanMs: 3e3,
   probeMs: 1e4,
   healthyResetMs: 12e4
@@ -3194,8 +3221,13 @@ function createProxyClient(options) {
         requestOptions
       );
       if (response.status === 429) {
-        const busy = await response.json().catch(() => ({}));
-        return { status: "busy", busy };
+        const value = await response.clone().json().catch(() => null);
+        if (value && typeof value === "object" && !Array.isArray(value)) {
+          const busy = value;
+          const valid = (n) => typeof n === "number" && Number.isFinite(n) && n >= 0;
+          const queue2 = busy.queued === true && valid(busy.size) && valid(busy.retryAfterMs) || valid(busy.queue_size) && valid(busy.recommended_retry_ms);
+          if (!("code" in busy) && queue2) return { status: "busy", busy };
+        }
       }
       if (!response.ok) {
         throw await RealtimeAvatarApiError.fromResponse(response);

package/dist/server.d.ts

@@ -1,3 +1,3 @@
 export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, RealtimeAvatarOptions, StartCallOptions, clipLibraryDeclarationSchema, verifyTranscript } from './index.js';
-export { h as Asset, g as AssetKind, A as Avatar, l as AvatarClip, c as AvatarSourceSwap, b as AvatarUpdate, m as CallConnection, C as CallMode, a as CallPolicy, n as CallQueued, o as ClipDeclaration, f as ClipLibrary, d as ClipLibraryDeclaration, p as ClipLibraryPlan, e as ClipLibraryUpdate, q as ClipSource, r as ContextMessage, k as CreditBalance, E as EndCallOptions, s as EndCallReason, i as ListSessionsOptions, L as LoopRedirect, S as StartCallResult, T as TranscriptPayload, j as UsageSession, U as UsageSessionPage, V as VideoPolicy, t as isQueued } from './types-nxdohaiH.js';
+export { h as Asset, g as AssetKind, A as Avatar, l as AvatarClip, c as AvatarSourceSwap, b as AvatarUpdate, m as CallConnection, C as CallMode, a as CallPolicy, n as CallQueued, o as ClipDeclaration, f as ClipLibrary, d as ClipLibraryDeclaration, p as ClipLibraryPlan, e as ClipLibraryUpdate, q as ClipSource, r as ContextMessage, k as CreditBalance, E as EndCallOptions, s as EndCallReason, i as ListSessionsOptions, L as LoopRedirect, S as StartCallResult, T as TranscriptPayload, j as UsageSession, U as UsageSessionPage, V as VideoPolicy, t as isQueued } from './types-B9GTrpx0.js';
 import 'zod';

package/dist/server.js

@@ -1 +1 @@
-export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, verifyTranscript } from './chunk-UMFUVCWT.js';
+export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, verifyTranscript } from './chunk-ZFYNUHKB.js';

package/dist/tanstack-start.d.ts

@@ -1,5 +1,5 @@
-import { P as ProxyConfig } from './types-9a0bRdXl.js';
-import './types-nxdohaiH.js';
+import { P as ProxyConfig } from './types-CJcTowDB.js';
+import './types-B9GTrpx0.js';
 
 /**
  * TanStack Start. Mount at `routes/api/realtime-avatar/$.ts` — the trailing `$` is Start's

package/dist/tanstack-start.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-WUUXNNDP.js';
-import './chunk-UMFUVCWT.js';
+import { createProxyHandler } from './chunk-FQWEKJCX.js';
+import './chunk-ZFYNUHKB.js';
 
 // src/tanstack-start.ts
 function realtimeAvatarServerRoute(config) {

package/dist/{types-nxdohaiH.d.ts → types-B9GTrpx0.d.ts}

@@ -343,10 +343,10 @@ interface components {
         CreateApiKeyRequest: {
             name: string;
             /**
-             * @default test
+             * @description Deprecated. Accepted for older clients but ignored; all new keys use the same tic_ format.
              * @enum {string}
              */
-            environment: "live" | "test";
+            environment?: "live" | "test";
             /**
              * @default [
              *       "realtime:write",
@@ -363,15 +363,16 @@ interface components {
             keyId: string;
             tenantId: string;
             name: string;
-            /** @enum {string} */
-            environment: "live" | "test";
             redactedKey: string;
+            /** @default false */
+            canReveal: boolean;
             scopes: ("*" | "api_keys:write" | "credits:read" | "avatars:read" | "avatars:write" | "realtime:write" | "usage:read" | "usage:write")[];
             /** @enum {string} */
             status: "active" | "revoked" | "expired";
             spendLimitCreditMicros: number | null;
             createdAt: string;
             expiresAt: string | null;
+            /** Format: starts_with */
             apiKey: string;
         };
         Asset: {
@@ -482,8 +483,6 @@ interface components {
                     issues: string[];
                     firstFrameUrl: string | null;
                     lastFrameUrl: string | null;
-                    trimStartMs: number | null;
-                    trimEndMs: number | null;
                 } | null;
                 error: {
                     code: string;
@@ -522,6 +521,13 @@ interface components {
                 };
             };
         };
+        ReviewAvatarClipRequest: {
+            clipId: string;
+            uploadAssetId: string;
+            expectedRevision: number;
+            expectedAnchorVersion: number;
+            reason: string;
+        };
         PutAvatarClipsRequest: {
             expectedRevision: number;
             clips: {
@@ -573,8 +579,6 @@ interface components {
                     issues: string[];
                     firstFrameUrl: string | null;
                     lastFrameUrl: string | null;
-                    trimStartMs: number | null;
-                    trimEndMs: number | null;
                 } | null;
                 error: {
                     code: string;
@@ -659,6 +663,16 @@ interface components {
             grantedScopes?: ("*" | "api_keys:write" | "credits:read" | "avatars:read" | "avatars:write" | "realtime:write" | "usage:read" | "usage:write")[];
             /** @description Present on 402 — where to send the user to top up. */
             billingUrl?: string;
+            /** @description On concurrency_limit_reached: the workspace's concurrent session limit. */
+            maxConcurrentSessions?: number;
+            /** @description Legacy concurrency count: occupied reservations, including active, connecting and starting sessions. Not the number of active conversations. */
+            liveSessions?: number;
+            /** @description On concurrency_limit_reached: counted reservations with started media, observed at refusal. */
+            activeSessions?: number;
+            /** @description On concurrency_limit_reached: counted reservations with an attached session that has not started media. */
+            connectingSessions?: number;
+            /** @description On concurrency_limit_reached: counted in-flight starts with no attached session yet. */
+            pendingSessions?: number;
         } & {
             [key: string]: unknown;
         };

package/dist/{types-9a0bRdXl.d.ts → types-CJcTowDB.d.ts}

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

package/package.json

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