@series-inc/rundot-game-sdk 5.17.0-beta.8 → 5.17.0

package/dist/{AdsApi-CEWQVyKz.d.ts → AdsApi-WlnMwXKa.d.ts}

@@ -1,3 +1,5 @@
+import { H as LeaderboardApi, I as ImageGenApi, A as AudioGenApi, V as VideoGenApi, q as SpriteGenApi, T as ThreeDGenApi } from './LeaderboardApi--NKuV2tJ.js';
+
 interface StorageApi {
     key(index: number): Promise<string | null>;
     clear(): Promise<void>;
@@ -425,6 +427,21 @@ interface TimeApi {
 type AiTextContent = {
     type: 'text';
     text: string;
+    /**
+     * Anthropic prompt-caching marker. When set, the proxy emits a
+     * `cache_control: { type: 'ephemeral' }` annotation on the corresponding
+     * Anthropic block. Ignored by non-Anthropic providers.
+     *
+     * You usually don't need to set this. By default, the proxy auto-caches
+     * the system prefix for Anthropic calls — see `AiChatCompletionRequest`.
+     * Set this explicitly when you want to control which segments are cached
+     * (e.g. caching mid-conversation history alongside the system, or
+     * disabling the proxy's default by claiming the breakpoint yourself on
+     * a different block).
+     */
+    cacheControl?: {
+        type: 'ephemeral';
+    };
 };
 /** Image referenced by URL. OpenAI/DeepSeek accept directly; the proxy fetches and base64-encodes for Anthropic. */
 type AiImageUrlContent = {
@@ -445,7 +462,88 @@ type AiImageContent = {
         data: string;
     };
 };
-type AiContentBlock = AiTextContent | AiImageUrlContent | AiImageContent;
+/**
+ * Assistant-emitted tool invocation, used in multi-turn tool conversations
+ * when echoing prior assistant turns back to the model. The same data is
+ * surfaced on a fresh response via the `toolCalls` field on the assistant
+ * message; this block type exists so callers can replay prior turns.
+ */
+type AiToolUseContent = {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+};
+/**
+ * User-supplied result for a previously emitted tool call. Used when feeding
+ * tool execution output back to the model on the next turn.
+ */
+type AiToolResultContent = {
+    type: 'tool_result';
+    toolUseId: string;
+    content: string | AiContentBlock[];
+    isError?: boolean;
+};
+type AiContentBlock = AiTextContent | AiImageUrlContent | AiImageContent | AiToolUseContent | AiToolResultContent;
+interface Tool {
+    name: string;
+    description: string;
+    /** JSON Schema describing the tool's input arguments. */
+    inputSchema: object;
+}
+type ToolChoice = 'auto' | 'any' | 'none' | {
+    type: 'tool';
+    name: string;
+};
+interface ToolUse {
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Constrains the model's output format.
+ *
+ * - `text`: free-form text (default).
+ * - `json_object`: model is asked to emit valid JSON. No schema enforcement.
+ * - `json_schema`: model is asked to emit JSON matching the given schema.
+ *   The proxy enforces the schema on every provider:
+ *     - OpenAI / DeepSeek: native Structured-Outputs `response_format`.
+ *     - Anthropic: schema is appended to the system prompt; the response is
+ *       parsed and validated server-side. On validation failure the proxy
+ *       retries once with the validator errors fed back to the model. If
+ *       the retry also fails, the request fails with HTTP 422.
+ *     - Gemini: native `responseSchema`.
+ *
+ *   `strict` (default `false`) maps to OpenAI's `strict` Structured-Outputs
+ *   flag and is otherwise informational.
+ *
+ *   For back-compat, the OpenAI native nested shape
+ *   (`json_schema: { name, schema, strict? }`) is also accepted and passed
+ *   through unchanged on the OpenAI path.
+ *
+ *   ### Interaction with `tools`
+ *
+ *   When `tools` is also set on the request, the schema applies ONLY to the
+ *   model's text content. If the model invokes a tool, the tool call IS the
+ *   response and the schema is not enforced (matches OpenAI's native
+ *   behavior). To force schema-conforming text even when tools are
+ *   available, omit `tools` from the request.
+ */
+type AiResponseFormat = {
+    type: 'text';
+} | {
+    type: 'json_object';
+} | {
+    type: 'json_schema';
+    schema?: object;
+    strict?: boolean;
+    json_schema?: {
+        name?: string;
+        description?: string;
+        schema?: object;
+        strict?: boolean | null;
+    };
+};
 interface AiMessage {
     /**
      * Depends on the model you are using. Most common is user, system, and assistant.
@@ -460,6 +558,36 @@ type AiChatCompletionRequest = {
     model: string;
     /** Array of message objects in OpenAI chat format */
     messages: Array<AiMessage>;
+    /**
+     * Structured system prompt. Mirrors Anthropic's `system` field shape so the
+     * caller can mark specific segments of a large static prefix as cacheable
+     * via `cacheControl`.
+     *
+     * - `string`: passed verbatim as the system instruction.
+     * - `Array<AiTextContent>`: each block becomes a system text block.
+     *
+     * ### Anthropic prompt caching (default behavior)
+     *
+     * For Anthropic models, the proxy automatically caches the system prefix:
+     * if neither `system` nor any block in `messages` carries an explicit
+     * `cacheControl` marker, the proxy attaches `cache_control: 'ephemeral'`
+     * to the LAST text block of the system. This is the cheap default —
+     * Anthropic's pricing makes it a net win within ~2 cache hits on the
+     * same prefix within the 5-minute TTL, and sub-threshold systems
+     * (<1024 tokens Sonnet/Opus, <2048 Haiku) are ignored by Anthropic so
+     * the marker is a no-op for small prompts.
+     *
+     * To **override** the default — for example, to cache a specific segment
+     * of the system or to additionally cache a slice of the user-message
+     * history — set `cacheControl: { type: 'ephemeral' }` on the block(s) you
+     * want as cache breakpoints. The presence of any explicit marker disables
+     * the proxy's auto-cache so your strategy isn't interfered with.
+     *
+     * For non-Anthropic providers, the array is flattened to a single string
+     * and `cacheControl` is silently dropped. Coexists with `role: 'system'`
+     * entries in `messages`; both are concatenated.
+     */
+    system?: string | Array<AiTextContent>;
     /** Maximum number of tokens to generate */
     maxTokens?: number;
     /** Upper bound for tokens generated, including visible output and reasoning tokens */
@@ -480,8 +608,8 @@ type AiChatCompletionRequest = {
     frequencyPenalty?: number;
     /** Token logit biases */
     logitBias?: Record<string, number>;
-    /** Object specifying the format that the model must output */
-    responseFormat?: Record<string, any>;
+    /** Object specifying the format that the model must output. See {@link AiResponseFormat}. */
+    responseFormat?: AiResponseFormat;
     /** Random seed for reproducible outputs (Beta feature) */
     seed?: number;
     /** Unique identifier representing your end-user */
@@ -500,6 +628,8 @@ type AiChatCompletionRequest = {
     extraHeaders?: Record<string, any>;
     /** Custom tags for organizing completions */
     tags?: string[];
+    tools?: Tool[];
+    toolChoice?: ToolChoice;
     /**
      * @deprecated No longer used. Local dev uses HttpAiApi with Firebase auth. Will be removed in a future major version.
      */
@@ -520,6 +650,8 @@ type AiChatCompletionData = {
         message: {
             role: string;
             content: string;
+            /** Present only when the model invoked one or more tools on this turn. */
+            toolCalls?: ToolUse[];
         };
         finish_reason: string;
     }>;
@@ -532,9 +664,115 @@ type AiChatCompletionData = {
         cache_write_tokens?: number;
     };
 };
+/**
+ * A single event from a streaming chat completion. Mirrors the wire shape
+ * the proxy emits on `/v1/llm/completion-stream`.
+ *
+ * - `delta`: incremental assistant text. Concatenate `text` across all
+ *   `delta` events to reconstruct the final message.
+ * - `tool_call_chunk`: partial tool-call metadata. Providers stream tool
+ *   arguments as multiple chunks; buffer by `index` until `done`.
+ * - `done`: terminal event for a successful stream. Carries `finishReason`
+ *   and aggregate token totals (same shape as the non-streaming response's
+ *   `usage`). Always the last event yielded.
+ *
+ * Errors are out-of-band — consumers see them as the iterable throwing.
+ */
+type AiChatCompletionStreamChunk = {
+    type: 'delta';
+    text: string;
+} | {
+    type: 'tool_call_chunk';
+    index: number;
+    id?: string;
+    name?: string;
+    argumentsDelta?: string;
+} | {
+    type: 'done';
+    finishReason: string;
+    usage: AiChatCompletionData['usage'];
+};
+interface AiChatCompletionStreamOptions {
+    /**
+     * Caller-supplied AbortSignal. Aborting causes the iterable to stop
+     * yielding and the host to close the upstream SSE socket. Equivalent to
+     * `break`ing out of `for await`; provided as a separate handle for callers
+     * that already manage an AbortController for the surrounding operation.
+     */
+    signal?: AbortSignal;
+}
 interface AiApi {
     requestChatCompletionAsync(request: AiChatCompletionRequest): Promise<AiChatCompletionData>;
     getAvailableCompletionModels(): Promise<Array<string>>;
+    /**
+     * Streaming sibling of `requestChatCompletionAsync`. Returns an async
+     * iterable of chunks. Cancel by `break`ing out of `for await`, calling
+     * `return()` on the iterator, or aborting the optional `signal`.
+     *
+     * @example
+     * Text-only consumption — concatenate `delta.text` and read usage on `done`:
+     * ```ts
+     * const stream = textGen.requestChatCompletionStreamAsync({ ... })
+     * let text = ''
+     * for await (const chunk of stream) {
+     *   if (chunk.type === 'delta') text += chunk.text
+     *   if (chunk.type === 'done') console.log('usage', chunk.usage)
+     * }
+     * ```
+     *
+     * @example
+     * Buffering `tool_call_chunk` events into `ToolUse[]`. Providers stream
+     * tool arguments as a sequence of `argumentsDelta` fragments keyed by
+     * `index`; concatenate them and JSON-parse once `done` arrives. A
+     * `tool_call_chunk` chunk carries the tool's `id` and `name` once they
+     * become known (typically on the first chunk for that index), with
+     * argument-only chunks following:
+     * ```ts
+     * import type {
+     *   AiChatCompletionStreamChunk,
+     *   ToolUse,
+     * } from '@series-inc/rundot-game-sdk'
+     *
+     * interface PartialToolCall { id?: string; name?: string; args: string }
+     *
+     * const buffer = new Map<number, PartialToolCall>()
+     * const toolCalls: ToolUse[] = []
+     * let text = ''
+     *
+     * for await (const chunk of stream) {
+     *   switch (chunk.type) {
+     *     case 'delta':
+     *       text += chunk.text
+     *       break
+     *     case 'tool_call_chunk': {
+     *       const entry = buffer.get(chunk.index) ?? { args: '' }
+     *       if (chunk.id !== undefined) entry.id = chunk.id
+     *       if (chunk.name !== undefined) entry.name = chunk.name
+     *       if (chunk.argumentsDelta !== undefined) {
+     *         entry.args += chunk.argumentsDelta
+     *       }
+     *       buffer.set(chunk.index, entry)
+     *       break
+     *     }
+     *     case 'done':
+     *       for (const entry of buffer.values()) {
+     *         if (entry.id === undefined || entry.name === undefined) continue
+     *         toolCalls.push({
+     *           id: entry.id,
+     *           name: entry.name,
+     *           input: entry.args === '' ? {} : JSON.parse(entry.args),
+     *         })
+     *       }
+     *       break
+     *   }
+     * }
+     * ```
+     *
+     * Gemini note: text streaming is supported; tool-use on Gemini streaming
+     * is deferred — the iterable throws `AppError(400)` when `request.tools`
+     * is non-empty.
+     */
+    requestChatCompletionStreamAsync(request: AiChatCompletionRequest, options?: AiChatCompletionStreamOptions): AsyncIterable<AiChatCompletionStreamChunk>;
 }
 
 type TextGenApi = AiApi;
@@ -789,6 +1027,7 @@ interface ExecuteRecipeResponse {
     outputs?: Record<string, number | string>;
     data?: Record<string, unknown>;
     message?: string;
+    randomSeed?: string;
     amountRequested?: number;
     amountFulfilled?: number;
     partialSuccess?: boolean;
@@ -1291,10 +1530,31 @@ interface PurchaseSubscriptionResponse {
     success: boolean;
 }
 interface SpendCurrencyOptions {
+    /** Screen/route name where the purchase occurred. Used for analytics only. */
     screenName?: string;
+    /**
+     * Short human-readable description of what is being purchased
+     * (e.g. "Unlock level 5", "Continue run"). The host renders this in the
+     * spend-confirmation dialog so the player sees what they are paying for.
+     * Sanitized and truncated by the host before display.
+     */
+    description?: string;
+    /**
+     * Optional profile id of a UGC creator the spend should be attributed to
+     * for revenue share. Forwarded to the server for future revshare bookkeeping.
+     */
+    beneficiaryId?: string;
 }
 interface SpendCurrencyResult {
     success: boolean;
+    /**
+     * Optional failure reason. Defined sentinel values:
+     *
+     * - `'USER_CANCELLED'` — the player declined the host confirmation dialog
+     *   before the spend was sent to the server. No currency was deducted.
+     *
+     * Other values are server-side error messages and are not stable.
+     */
     error?: string;
 }
 interface OpenStoreResult {
@@ -1314,140 +1574,6 @@ interface IapApi {
     hasUserMadePurchase(): Promise<boolean>;
 }
 
-interface LeaderboardModeConfig {
-    displayName: string;
-    minDurationSec?: number;
-    maxDurationSec?: number;
-    minScore?: number;
-    maxScore?: number;
-}
-type LeaderboardPeriodType = 'daily' | 'weekly' | 'monthly' | 'alltime';
-interface LeaderboardPeriodConfig {
-    displayName: string;
-    type: LeaderboardPeriodType;
-}
-interface LeaderboardAntiCheatConfig {
-    enableZScoreDetection: boolean;
-    zScoreThreshold: number;
-    enableRateLimit: boolean;
-    minTimeBetweenSubmissionsSec: number;
-    trustScoreDecayPerFlag: number;
-    shadowBanThreshold: number;
-}
-interface LeaderboardDisplaySettings {
-    maxEntriesPerPage: number;
-}
-interface LeaderboardConfig {
-    minDurationSec: number;
-    maxDurationSec: number;
-    minScore: number;
-    maxScore: number;
-    requiresToken: boolean;
-    enableScoreSealing: boolean;
-    scoreSealingSecret?: string;
-    modes: Record<string, LeaderboardModeConfig>;
-    periods: Record<string, LeaderboardPeriodConfig>;
-    antiCheat: LeaderboardAntiCheatConfig;
-    displaySettings: LeaderboardDisplaySettings;
-}
-interface ScoreToken {
-    token: string;
-    startTime: number;
-    expiresAt: number;
-    sealingNonce?: string | null;
-    sealingSecret?: string | null;
-    mode: string;
-}
-interface SubmitScoreParams {
-    token?: string;
-    score: number;
-    duration: number;
-    mode?: string;
-    period?: string;
-    telemetry?: Record<string, any>;
-    metadata?: Record<string, any>;
-}
-interface SubmitScoreResult {
-    accepted: boolean;
-    rank?: number | null;
-    zScore?: number | null;
-    isAnomaly?: boolean;
-    /** Human-readable explanation when `accepted` is false (e.g., keep-best rejection). */
-    reason?: string | null;
-}
-interface GetPagedScoresOptions {
-    mode?: string;
-    period?: string;
-    periodDate?: number | string;
-    cursor?: string | null;
-    limit?: number;
-    variant?: 'standard' | 'highlight';
-    topCount?: number;
-    contextAhead?: number;
-    contextBehind?: number;
-}
-interface LeaderboardEntry {
-    profileId: string;
-    username: string;
-    avatarUrl: string | null;
-    score: number;
-    duration: number;
-    submittedAt: number;
-    token?: string;
-    rank: number | null;
-    zScore?: number | null;
-    isAnomaly?: boolean;
-    trustScore?: number | null;
-    isShadowBanned?: boolean;
-    expiresAt?: number | null;
-    metadata?: Record<string, any> | null;
-    isSeed?: boolean;
-}
-interface PagedScoresResponse {
-    variant: 'standard' | 'highlight';
-    entries: LeaderboardEntry[];
-    totalEntries: number;
-    nextCursor?: string | null;
-    playerRank: number | null;
-    periodInstance: string;
-}
-interface PlayerRankOptions {
-    mode?: string;
-    period?: string;
-    periodDate?: number | string;
-}
-interface PlayerRankResult {
-    rank: number | null;
-    score?: number;
-    totalPlayers: number;
-    percentile?: number;
-    trustScore: number;
-    periodInstance: string;
-}
-interface PodiumScoresContext {
-    topEntries: LeaderboardEntry[];
-    beforePlayer: LeaderboardEntry[];
-    playerEntry?: LeaderboardEntry | null;
-    afterPlayer: LeaderboardEntry[];
-    totalBefore: number;
-    totalAfter: number;
-    omittedBefore: number;
-    omittedAfter: number;
-}
-interface PodiumScoresResponse extends PagedScoresResponse {
-    variant: 'highlight';
-    context: PodiumScoresContext;
-}
-interface GetPodiumScoresOptions extends Omit<GetPagedScoresOptions, 'variant'> {
-}
-interface LeaderboardApi {
-    createScoreToken(mode?: string): Promise<ScoreToken>;
-    submitScore(params: SubmitScoreParams): Promise<SubmitScoreResult>;
-    getPagedScores(options?: GetPagedScoresOptions): Promise<PagedScoresResponse>;
-    getMyRank(options?: PlayerRankOptions): Promise<PlayerRankResult>;
-    getPodiumScores(options?: GetPodiumScoresOptions): Promise<PodiumScoresResponse>;
-}
-
 /**
  * UGC (User-Generated Content) API
  *
@@ -1501,6 +1627,11 @@ interface UgcListParams {
 type UgcBuiltinSortBy = 'recent' | 'mostLiked' | 'mostUsed';
 type UgcCustomSortBy = `idx_${string}`;
 type UgcSortBy = UgcBuiltinSortBy | UgcCustomSortBy;
+interface UgcRangeFilter {
+    gte?: number;
+    lte?: number;
+}
+type UgcFilterValue = string | number | UgcRangeFilter;
 interface UgcBrowseParams {
     contentType?: string;
     authorId?: string;
@@ -1508,7 +1639,7 @@ interface UgcBrowseParams {
     limit?: number;
     sortBy?: UgcSortBy;
     sortOrder?: 'asc' | 'desc';
-    filters?: Record<string, unknown>;
+    filters?: Record<string, UgcFilterValue>;
 }
 interface UgcGetManyParams {
     entryIds: string[];
@@ -1520,7 +1651,7 @@ interface UgcGetManyResponse {
 }
 interface UgcCountParams {
     contentType?: string;
-    filters?: Record<string, unknown>;
+    filters?: Record<string, UgcFilterValue>;
 }
 interface UgcCrossAppBrowseParams extends UgcBrowseParams {
     targetAppId: string;
@@ -1988,267 +2119,6 @@ interface SocialApi {
     canShareFileAsync(): Promise<CanShareFileResult>;
 }
 
-type ImageGenModel = 'gemini-3.1-flash-image-preview' | 'gemini-3-pro-image-preview';
-type BgRemovalModel = 'bria' | 'birefnet';
-type BiRefNetVariant = 'light' | 'heavy' | 'portrait';
-interface RemoveBackgroundOptions {
-    /** Model to use. Default: 'bria'. */
-    model?: BgRemovalModel;
-    /** BiRefNet variant (ignored when model is 'bria'). Default: 'light'. */
-    variant?: BiRefNetVariant;
-    /** Operating resolution for BiRefNet (ignored for bria). Default: '1024x1024'. */
-    resolution?: '1024x1024' | '2048x2048';
-}
-interface ImageGenParams {
-    prompt: string;
-    negativePrompt?: string;
-    aspectRatio?: '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '4:5' | '5:4' | '9:16' | '16:9' | '21:9';
-    /**
-     * Reference images for style/content guidance.
-     * Each entry can be:
-     * - A file key (e.g. `"sprites/hero.png"`) — resolved server-side from your app's storage
-     * - An HTTPS URL — fetched server-side
-     * - A data URI (`data:image/png;base64,...`)
-     */
-    referenceImages?: string[];
-    seed?: number;
-    /**
-     * When true, removes the background using Bria (default).
-     * When an object, uses the specified model/variant.
-     */
-    removeBackground?: boolean | RemoveBackgroundOptions;
-    /** Model to use. Defaults to 'gemini-3.1-flash-image-preview' (Nano Banana 2). */
-    model?: ImageGenModel;
-}
-interface ImageGenResult {
-    imageUrl: string;
-    prompt: string;
-}
-interface ImageGenJobEvent {
-    jobId: string;
-    status: 'completed' | 'failed';
-    params: ImageGenParams;
-    result?: ImageGenResult;
-    error?: string;
-}
-interface DepthEstimationParams {
-    /** Source image: file key, HTTPS URL, or data URI (HTTP path only). */
-    imageUrl: string;
-    /** Number of inference steps (1–50). Default: 10. */
-    numInferenceSteps?: number;
-    /** Ensemble predictions to average (1–20). Default: 10. */
-    ensembleSize?: number;
-    /** Max processing resolution; 0 = use input size (0–4096). Default: 0. */
-    processingRes?: number;
-}
-interface DepthEstimationResult {
-    depthMapUrl: string;
-    width: number;
-    height: number;
-}
-type RemoveBackgroundParams = RemoveBackgroundOptions & {
-    /** Source image: file key, HTTPS URL, or data URI (HTTP path only). */
-    imageUrl: string;
-};
-interface RemoveBackgroundResult {
-    imageUrl: string;
-    width: number;
-    height: number;
-}
-interface ImageGenApi {
-    generate(params: ImageGenParams): Promise<ImageGenResult>;
-    estimateDepth(params: DepthEstimationParams): Promise<DepthEstimationResult>;
-    removeBackground(params: RemoveBackgroundParams): Promise<RemoveBackgroundResult>;
-    getCompletedJobs(): Promise<ImageGenJobEvent[]>;
-}
-
-type AudioGenType = 'sfx' | 'music' | 'tts';
-type AudioGenProvider = 'elevenlabs';
-interface AudioGenSFXParams {
-    type: 'sfx';
-    provider?: AudioGenProvider;
-    /** Describe materials, intensity, context — "sword clashing against metal shield, heavy impact" */
-    description: string;
-    /** Duration in seconds (0.5–30). Omit for model-decided. */
-    durationSec?: number;
-    /** Opaque correlation ID echoed back in job events for client-side recovery. */
-    clientRef?: string;
-}
-interface AudioGenMusicParams {
-    type: 'music';
-    provider?: AudioGenProvider;
-    /** Genre, tempo, instruments, mood — "orchestral victory fanfare, triumphant brass" */
-    prompt: string;
-    /** Duration in seconds (REQUIRED, 1–300). */
-    durationSec: number;
-    /** Opaque correlation ID echoed back in job events for client-side recovery. */
-    clientRef?: string;
-}
-type TTSModel = 'eleven_v3' | 'eleven_multilingual_v2';
-interface AudioGenTTSParams {
-    type: 'tts';
-    provider?: AudioGenProvider;
-    /** Text to speak. Supports ElevenLabs v3 audio tags: [whispers], [shouts], [pause]. */
-    text: string;
-    /** ElevenLabs voice ID. Use a known voice ID from the ElevenLabs library. */
-    voiceId: string;
-    /** TTS model. Default: 'eleven_v3'. */
-    model?: TTSModel;
-    /** 0–1. Lower = more expressive. Default: 0.5. */
-    stability?: number;
-    /** 0–1. Voice similarity boost. Default: 0.8. */
-    similarityBoost?: number;
-    /** Speech speed 0.5–2.0. Default: 1.0. */
-    speed?: number;
-    /** Opaque correlation ID echoed back in job events for client-side recovery. */
-    clientRef?: string;
-}
-type AudioGenParams = AudioGenSFXParams | AudioGenMusicParams | AudioGenTTSParams;
-interface AudioGenResult {
-    generationId: string;
-    audioUrl: string;
-    type: AudioGenType;
-    durationSec: number;
-    prompt: string;
-}
-interface AudioGenJobEvent {
-    jobId: string;
-    status: 'completed' | 'failed';
-    params: AudioGenParams;
-    result?: AudioGenResult;
-    error?: string;
-}
-interface VoiceLibraryEntry {
-    voiceId: string;
-    name: string;
-    category?: string;
-    description?: string;
-    previewUrl?: string;
-    labels?: Record<string, string>;
-}
-interface ListVoicesResult {
-    voices: VoiceLibraryEntry[];
-}
-interface DesignVoicesParams {
-    /** Natural-language voice description — "Young female, breathy, excited" */
-    description: string;
-    /** Optional sample text (100–1000 chars). ElevenLabs uses a default if omitted. */
-    sampleText?: string;
-}
-interface DesignVoicePreview {
-    /**
-     * Temporary voice ID returned by ElevenLabs createPreviews.
-     * Can be used as a voiceId for TTS generation.
-     *
-     * NOTE: If direct use fails, the host may need an intermediate
-     * textToVoice.create() step — see PRD open question #2.
-     */
-    generatedVoiceId: string;
-    /** Data URI or URL of the audio preview. */
-    audioUrl: string;
-    durationSec: number;
-}
-interface DesignVoicesResult {
-    previews: DesignVoicePreview[];
-    /** The text that was spoken in the previews. */
-    previewText: string;
-}
-interface AudioGenApi {
-    generate(params: AudioGenParams): Promise<AudioGenResult>;
-    getCompletedJobs(): Promise<AudioGenJobEvent[]>;
-    listVoices(): Promise<ListVoicesResult>;
-    designVoices(params: DesignVoicesParams): Promise<DesignVoicesResult>;
-}
-
-type VideoGenProvider = 'seedance-2.0' | 'seedance-2.0-fast' | 'kling-3.0-standard';
-type VideoGenMode = 'text-to-video' | 'image-to-video' | 'reference-to-video';
-type VideoGenAspectRatio = '21:9' | '16:9' | '4:3' | '1:1' | '3:4' | '9:16';
-type VideoGenResolution = '480p' | '720p' | '1080p';
-interface VideoGenBase {
-    prompt?: string;
-    seed?: number;
-    requestOrigin?: string;
-    clientRef?: string;
-}
-interface SeedanceBase extends VideoGenBase {
-    provider: 'seedance-2.0' | 'seedance-2.0-fast';
-    aspectRatio?: VideoGenAspectRatio;
-    resolution?: VideoGenResolution;
-    durationSeconds?: 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15;
-    generateAudio?: boolean;
-    cameraFixed?: boolean;
-}
-interface SeedanceTextToVideoParams extends SeedanceBase {
-    mode: 'text-to-video';
-}
-interface SeedanceImageToVideoParams extends SeedanceBase {
-    mode: 'image-to-video';
-    startImageUrl: string;
-    endImageUrl?: string;
-}
-interface SeedanceReferenceToVideoParams extends SeedanceBase {
-    mode: 'reference-to-video';
-    /** Style/content reference images. Max 9 for Seedance. */
-    imageReferences?: string[];
-    /** Motion reference videos. Max 3 for Seedance. */
-    videoReferences?: string[];
-    /** Audio samples for voice cloning. Max 3 refs, each 3–5s, total <= 15s. Must be re-encoded (not stream-copied) to exact-second boundaries. */
-    audioReferences?: string[];
-}
-interface KlingMultiPromptElement {
-    prompt: string;
-    durationSeconds?: number;
-}
-interface KlingBase extends VideoGenBase {
-    provider: 'kling-3.0-standard';
-    aspectRatio?: '16:9' | '9:16' | '1:1';
-    durationSeconds?: 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15;
-    generateAudio?: boolean;
-    negativePrompt?: string;
-    cfgScale?: number;
-    shotType?: 'customize' | 'intelligent';
-    multiPrompt?: KlingMultiPromptElement[];
-}
-interface KlingTextToVideoParams extends KlingBase {
-    mode: 'text-to-video';
-}
-interface KlingImageToVideoParams extends KlingBase {
-    mode: 'image-to-video';
-    startImageUrl: string;
-    endImageUrl?: string;
-}
-type VideoGenParams = SeedanceTextToVideoParams | SeedanceImageToVideoParams | SeedanceReferenceToVideoParams | KlingTextToVideoParams | KlingImageToVideoParams;
-interface VideoGenResult {
-    generationId: string;
-    videoUrl: string;
-    posterUrl?: string;
-    durationSeconds: number;
-    width: number;
-    height: number;
-    provider: VideoGenProvider;
-    mode: VideoGenMode;
-    prompt: string;
-    seed: number;
-}
-interface VideoGenJobEvent {
-    jobId: string;
-    status: 'completed' | 'failed';
-    params: VideoGenParams;
-    result?: VideoGenResult;
-    error?: string;
-}
-interface VideoGenJobStartedEvent {
-    jobId: string;
-}
-interface VideoGenApi {
-    generate(params: VideoGenParams): Promise<VideoGenResult>;
-    getCompletedJobs(): Promise<VideoGenJobEvent[]>;
-    cancel(jobId: string): Promise<void>;
-    onJobStarted(callback: (event: VideoGenJobStartedEvent) => void): {
-        unsubscribe: () => void;
-    };
-}
-
 interface FileEntry {
     key: string;
     sizeBytes: number;
@@ -2312,6 +2182,23 @@ interface ExistsParams {
     targetAppId?: string;
     targetProfileId?: string;
 }
+interface BatchMetadataParams {
+    keys: string[];
+    targetAppId?: string;
+    targetProfileId?: string;
+}
+interface BatchMetadataResult {
+    entries: Record<string, FileEntry>;
+    ttlMs: number;
+}
+interface BatchExistsParams {
+    keys: string[];
+    targetAppId?: string;
+    targetProfileId?: string;
+}
+interface BatchExistsResult {
+    results: Record<string, boolean>;
+}
 interface StorageQuota {
     usedBytes: number;
     capBytes: number;
@@ -2353,6 +2240,11 @@ type TransformParams = {
     input: string;
     outputKey: string;
     targetResolution?: '720p' | '1080p';
+    model?: 'standard-v2' | 'low-resolution-v2' | 'cgi' | 'high-fidelity-v2' | 'recovery-v2';
+    sharpen?: number;
+    denoise?: number;
+    faceEnhancement?: boolean;
+    outputFormat?: 'png' | 'jpeg';
     clientRef?: string;
 } | {
     op: 'copy';
@@ -2399,229 +2291,67 @@ interface TransformResult {
 interface ConfirmUploadOptions {
     clientRef?: string;
 }
+interface BatchUploadParams {
+    files: Array<{
+        key: string;
+        contentType: string;
+        sizeBytes: number;
+        visibility?: 'private' | 'public';
+    }>;
+}
+interface BatchUploadResult {
+    files: UploadResult[];
+}
+interface BatchConfirmResult {
+    jobs: Array<{
+        key: string;
+        jobId?: string;
+        status: string;
+        error?: string;
+    }>;
+}
+interface ExportToCloudinaryParams {
+    key: string;
+    publicId?: string;
+    folder?: string;
+}
+interface CloudinaryExportResult {
+    secureUrl: string;
+    publicId: string;
+}
 interface FilesJobEvent {
     jobId: string;
-    type: 'fileConfirm' | 'upscale' | 'transform';
+    type: 'fileConfirm' | 'upscale' | 'transform' | 'fileExportCloudinary';
     status: 'completed' | 'failed';
     clientRef?: string;
     params: Record<string, unknown>;
-    result?: FileEntry | TransformResult;
-    error?: string;
+    result?: FileEntry | TransformResult | CloudinaryExportResult;
+    error?: string | {
+        code: string;
+        message: string;
+    };
 }
 interface FilesApi {
     upload(params: UploadParams): Promise<UploadResult>;
     confirmUpload(key: string, options?: ConfirmUploadOptions): Promise<FileEntry>;
+    batchUpload(params: BatchUploadParams): Promise<BatchUploadResult>;
+    batchConfirm(keys: string[], options?: ConfirmUploadOptions): Promise<BatchConfirmResult>;
     getUrl(params: GetUrlParams): Promise<string>;
     getUrls(params: GetUrlsParams): Promise<GetUrlsResult>;
     getMetadata(params: GetMetadataParams): Promise<FileEntry>;
     exists(params: ExistsParams): Promise<boolean>;
+    batchGetMetadata(params: BatchMetadataParams): Promise<BatchMetadataResult>;
+    batchExists(params: BatchExistsParams): Promise<BatchExistsResult>;
     delete(key: string): Promise<void>;
     list(params?: ListParams): Promise<ListResult>;
     getQuota(): Promise<StorageQuota>;
     hasStorageAvailable(sizeBytes: number): Promise<boolean>;
     setVisibility(key: string, visibility: 'private' | 'public'): Promise<FileEntry>;
     transform(params: TransformParams): Promise<TransformResult>;
+    exportToCloudinary(params: ExportToCloudinaryParams): Promise<CloudinaryExportResult>;
     getCompletedJobs(): Promise<FilesJobEvent[]>;
 }
 
-type SpriteGenModel = string;
-interface SpriteGenParams {
-    prompt: string;
-    /** Pixel art (true) or detailed HD art (false). Default true. */
-    pixel?: boolean;
-    width?: number;
-    height?: number;
-    bgMode?: 'transparent' | 'white' | 'include';
-    theme?: string;
-    style?: string;
-    colors?: string[];
-    /** SpriteCook asset ID from a prior generation, for style consistency. */
-    referenceAssetId?: string;
-    /** Creator-storage file key to use as style reference (resolved server-side). */
-    referenceFileKey?: string;
-    model?: SpriteGenModel;
-}
-interface SpriteGenResult {
-    generationId: string;
-    imageUrl: string;
-    spriteCookAssetId: string;
-    prompt: string;
-    model: string;
-    width: number;
-    height: number;
-}
-interface AnimateSpriteParams {
-    /** generationId from a prior spriteGen.generate() call. */
-    sourceGenerationId?: string;
-    /** Or: a creator-storage file key to animate (imported to SpriteCook on the fly). */
-    sourceFileKey?: string;
-    /** Or: an HTTPS URL to import and animate. */
-    sourceImageUrl?: string;
-    /** Motion description, e.g. "walk cycle, side view" or "idle breathing". */
-    prompt: string;
-    /** Frame count. Pixel: 2-16 (even), HD: 2-24 (even). Default 8. */
-    outputFrames?: number;
-    /** Output format. Default 'spritesheet'. */
-    outputFormat?: 'spritesheet' | 'gif' | 'webp';
-    /** Background removal mode. Default 'Basic'. */
-    removeBg?: 'None' | 'Basic' | 'Pro';
-}
-interface AnimateSpriteResult {
-    generationId: string;
-    spriteSheetUrl: string;
-    frameCount: number;
-    frameWidth: number;
-    frameHeight: number;
-    prompt: string;
-}
-interface SpriteGenJobEvent {
-    jobId: string;
-    status: 'completed' | 'failed';
-    /** Firestore job type — always 'spriteGen'. Use params.operation to distinguish generate vs animate. */
-    type: string;
-    params: (SpriteGenParams | AnimateSpriteParams) & {
-        operation: 'generate' | 'animate';
-    };
-    result?: SpriteGenResult | AnimateSpriteResult;
-    error?: string;
-}
-interface SpriteGenApi {
-    generate(params: SpriteGenParams): Promise<SpriteGenResult>;
-    animate(params: AnimateSpriteParams): Promise<AnimateSpriteResult>;
-    getCompletedJobs(): Promise<SpriteGenJobEvent[]>;
-}
-
-type ThreeDGenProvider = 'pixal3d' | 'hunyuan3d-v3.1-pro' | 'trellis-2';
-type ThreeDGenMode = 'image-to-3d' | 'text-to-3d';
-type ThreeDGenQuality = 'draft' | 'standard' | 'high';
-interface ThreeDGenBase {
-    quality?: ThreeDGenQuality;
-    seed?: number;
-    requestOrigin?: string;
-    clientRef?: string;
-    /** Resolve a Files SDK key as the source image (alternative to imageUrl) */
-    imageFileKey?: string;
-}
-interface Pixal3DImageTo3DParams extends ThreeDGenBase {
-    provider: 'pixal3d';
-    mode: 'image-to-3d';
-    imageUrl: string;
-    providerOptions?: {
-        resolution?: 1024 | 1536;
-        decimation_target?: number;
-        texture_size?: 1024 | 2048 | 4096;
-        remesh?: boolean;
-        ss_guidance_strength?: number;
-        ss_sampling_steps?: number;
-        shape_slat_guidance_strength?: number;
-        shape_slat_sampling_steps?: number;
-        tex_slat_guidance_strength?: number;
-        tex_slat_sampling_steps?: number;
-    };
-}
-interface HunyuanImageTo3DParams extends ThreeDGenBase {
-    provider: 'hunyuan3d-v3.1-pro';
-    mode: 'image-to-3d';
-    imageUrl: string;
-    additionalViews?: {
-        backImageUrl?: string;
-        leftImageUrl?: string;
-        rightImageUrl?: string;
-        topImageUrl?: string;
-        bottomImageUrl?: string;
-    };
-    providerOptions?: {
-        face_count?: number;
-        generate_type?: 'Normal' | 'Geometry';
-        enable_pbr?: boolean;
-    };
-}
-interface HunyuanTextTo3DParams extends ThreeDGenBase {
-    provider: 'hunyuan3d-v3.1-pro';
-    mode: 'text-to-3d';
-    prompt: string;
-    providerOptions?: {
-        face_count?: number;
-        generate_type?: 'Normal' | 'Geometry';
-        enable_pbr?: boolean;
-    };
-}
-interface Trellis2ImageTo3DParams extends ThreeDGenBase {
-    provider: 'trellis-2';
-    mode: 'image-to-3d';
-    imageUrl: string;
-    providerOptions?: Record<string, never>;
-}
-type ThreeDGenParams = Pixal3DImageTo3DParams | HunyuanImageTo3DParams | HunyuanTextTo3DParams | Trellis2ImageTo3DParams;
-interface ThreeDGenResult {
-    generationId: string;
-    modelUrl: string;
-    rawModelUrl?: string;
-    thumbnailUrl?: string;
-    provider: ThreeDGenProvider;
-    mode: ThreeDGenMode;
-    quality: ThreeDGenQuality;
-    seed: number;
-    compression?: {
-        inputSizeBytes: number;
-        outputSizeBytes: number;
-        compressionPercent: number;
-    };
-}
-type RemeshTargetPreset = 'character' | 'prop';
-interface RemeshParams {
-    modelUrl: string;
-    targetFaceCount?: number;
-    targetPreset?: RemeshTargetPreset;
-    clientRef?: string;
-}
-interface RemeshResult {
-    remeshId: string;
-    modelUrl: string;
-    faceCount: number;
-    provider: 'meshy';
-}
-interface RigParams {
-    modelUrl: string;
-    heightMeters?: number;
-    clientRef?: string;
-}
-interface RigResult {
-    rigId: string;
-    modelUrl: string;
-    provider: 'meshy';
-}
-type AnimationPreset = 'idle' | 'walk' | 'run' | 'jump' | 'attack' | 'dance' | 'wave' | 'crouch' | 'fall' | 'hit';
-interface AnimateParams {
-    rigId: string;
-    animations: (AnimationPreset | number)[];
-    clientRef?: string;
-}
-interface AnimatedClip {
-    animation: string;
-    modelUrl: string;
-}
-interface AnimateResult {
-    clips: AnimatedClip[];
-    provider: 'meshy';
-}
-type ThreeDGenJobOperation = 'generate' | 'remesh' | 'rig' | 'animate';
-interface ThreeDGenJobEvent {
-    jobId: string;
-    operation: ThreeDGenJobOperation;
-    status: 'completed' | 'failed';
-    params: ThreeDGenParams | RemeshParams | RigParams | AnimateParams;
-    result?: ThreeDGenResult | RemeshResult | RigResult | AnimateResult;
-    error?: string;
-}
-interface ThreeDGenApi {
-    generate(params: ThreeDGenParams): Promise<ThreeDGenResult>;
-    remesh(params: RemeshParams): Promise<RemeshResult>;
-    rig(params: RigParams): Promise<RigResult>;
-    animate(params: AnimateParams): Promise<AnimateResult>;
-    getCompletedJobs(): Promise<ThreeDGenJobEvent[]>;
-}
-
 interface Entitlement {
     docId: string;
     userId: string;
@@ -2926,6 +2656,34 @@ interface VideoApi {
     }) => void): Subscription;
 }
 
+interface AdminGenBrowseParams {
+    profileId?: string;
+    status?: 'active' | 'removed';
+    cursor?: string;
+    limit?: number;
+    sortOrder?: 'asc' | 'desc';
+}
+interface AdminGenBrowseResponse<TEntry> {
+    entries: TEntry[];
+    nextCursor?: string;
+}
+interface AdminGenListReportsParams {
+    status?: 'pending' | 'reviewed' | 'dismissed';
+    cursor?: string;
+    limit?: number;
+}
+interface AdminGenListReportsResponse<TReport> {
+    reports: TReport[];
+    nextCursor?: string;
+}
+type AdminGenResolveAction = 'reviewed' | 'dismissed';
+interface AdminGenApi<TEntry, TReport> {
+    browse(params?: AdminGenBrowseParams): Promise<AdminGenBrowseResponse<TEntry>>;
+    removeEntry(generationId: string): Promise<void>;
+    listReports(params?: AdminGenListReportsParams): Promise<AdminGenListReportsResponse<TReport>>;
+    resolveReport(reportId: string, action: AdminGenResolveAction): Promise<void>;
+}
+
 type AppRole = 'owner' | 'editor' | 'none';
 interface AdminUgcBrowseParams {
     contentType?: string;
@@ -2996,17 +2754,6 @@ interface ImageGenEntry {
     createdAt: number;
     status: 'active' | 'removed';
 }
-interface AdminImageGenBrowseParams {
-    profileId?: string;
-    status?: 'active' | 'removed';
-    cursor?: string;
-    limit?: number;
-    sortOrder?: 'asc' | 'desc';
-}
-interface AdminImageGenBrowseResponse {
-    entries: ImageGenEntry[];
-    nextCursor?: string;
-}
 interface ImageGenReport {
     id: string;
     generationId: string;
@@ -3017,22 +2764,34 @@ interface ImageGenReport {
     createdAt: number;
     status: 'pending' | 'reviewed' | 'dismissed';
 }
-interface AdminImageGenListReportsParams {
-    status?: 'pending' | 'reviewed' | 'dismissed';
-    cursor?: string;
-    limit?: number;
-}
-interface AdminImageGenListReportsResponse {
-    reports: ImageGenReport[];
-    nextCursor?: string;
+type AdminImageGenApi = AdminGenApi<ImageGenEntry, ImageGenReport>;
+interface VideoGenEntry {
+    id: string;
+    appId: string;
+    profileId: string;
+    provider: string;
+    mode: string;
+    prompt: string;
+    videoUrl: string;
+    posterUrl?: string;
+    durationSeconds: number;
+    width: number;
+    height: number;
+    generationCostUsd?: number;
+    createdAt: number;
+    status: 'active' | 'removed';
 }
-type AdminImageGenResolveAction = 'reviewed' | 'dismissed';
-interface AdminImageGenApi {
-    browse(params?: AdminImageGenBrowseParams): Promise<AdminImageGenBrowseResponse>;
-    removeEntry(generationId: string): Promise<void>;
-    listReports(params?: AdminImageGenListReportsParams): Promise<AdminImageGenListReportsResponse>;
-    resolveReport(reportId: string, action: AdminImageGenResolveAction): Promise<void>;
+interface VideoGenReport {
+    id: string;
+    generationId: string;
+    appId: string;
+    reporterId: string;
+    reason: 'inappropriate' | 'spam' | 'harassment' | 'other';
+    details?: string;
+    createdAt: number;
+    status: 'pending' | 'reviewed' | 'dismissed';
 }
+type AdminVideoGenApi = AdminGenApi<VideoGenEntry, VideoGenReport>;
 interface SpriteGenEntry {
     id: string;
     appId: string;
@@ -3049,34 +2808,35 @@ interface SpriteGenEntry {
     frameHeight?: number;
     imageUrl: string;
     creditsUsed?: number;
+    createdAt: number;
+    status: 'active' | 'removed';
 }
-interface ThreeDGenEntry {
+interface SpriteGenReport {
+    id: string;
+    generationId: string;
+    appId: string;
+    reporterId: string;
+    reason: 'inappropriate' | 'spam' | 'harassment' | 'other';
+    details?: string;
+    createdAt: number;
+    status: 'pending' | 'reviewed' | 'dismissed';
+}
+type AdminSpriteGenApi = AdminGenApi<SpriteGenEntry, SpriteGenReport>;
+interface AudioGenEntry {
     id: string;
     appId: string;
     profileId: string;
-    operation: string;
+    type: 'sfx' | 'music' | 'tts';
     provider: string;
-    mode?: string;
-    quality?: string;
-    prompt?: string;
-    modelUrl: string;
-    rawModelUrl?: string;
-    estimatedCostUsd: number;
+    prompt: string;
+    audioUrl: string;
+    durationSec: number;
+    model?: string;
+    voiceId?: string;
     createdAt: number;
     status: 'active' | 'removed';
 }
-interface AdminSpriteGenBrowseParams {
-    profileId?: string;
-    status?: 'active' | 'removed';
-    cursor?: string;
-    limit?: number;
-    sortOrder?: 'asc' | 'desc';
-}
-interface AdminSpriteGenBrowseResponse {
-    entries: SpriteGenEntry[];
-    nextCursor?: string;
-}
-interface SpriteGenReport {
+interface AudioGenReport {
     id: string;
     generationId: string;
     appId: string;
@@ -3086,64 +2846,60 @@ interface SpriteGenReport {
     createdAt: number;
     status: 'pending' | 'reviewed' | 'dismissed';
 }
-interface AdminSpriteGenListReportsParams {
-    status?: 'pending' | 'reviewed' | 'dismissed';
-    cursor?: string;
-    limit?: number;
-}
-interface AdminSpriteGenListReportsResponse {
-    reports: SpriteGenReport[];
-    nextCursor?: string;
-}
-type AdminSpriteGenResolveAction = 'reviewed' | 'dismissed';
-interface AdminSpriteGenApi {
-    browse(params?: AdminSpriteGenBrowseParams): Promise<AdminSpriteGenBrowseResponse>;
-    removeEntry(generationId: string): Promise<void>;
-    listReports(params?: AdminSpriteGenListReportsParams): Promise<AdminSpriteGenListReportsResponse>;
-    resolveReport(reportId: string, action: AdminSpriteGenResolveAction): Promise<void>;
-}
-interface AdminThreeDGenBrowseParams {
-    profileId?: string;
-    status?: 'active' | 'removed';
-    cursor?: string;
-    limit?: number;
-    sortOrder?: 'asc' | 'desc';
-}
-interface AdminThreeDGenBrowseResponse {
-    entries: ThreeDGenEntry[];
-    nextCursor?: string;
+type AdminAudioGenApi = AdminGenApi<AudioGenEntry, AudioGenReport>;
+interface ThreeDGenEntry {
+    id: string;
+    appId: string;
+    profileId: string;
+    operation: string;
+    provider: string;
+    mode?: string;
+    quality?: string;
+    prompt?: string;
+    modelUrl: string;
+    rawModelUrl?: string;
+    estimatedCostUsd?: number;
+    createdAt: number;
+    status: 'active' | 'removed';
 }
 interface ThreeDGenReport {
     id: string;
     generationId: string;
     appId: string;
     reporterId: string;
-    reason: string;
+    reason: 'inappropriate' | 'spam' | 'harassment' | 'other';
     details?: string;
     createdAt: number;
     status: 'pending' | 'reviewed' | 'dismissed';
 }
-interface AdminThreeDGenListReportsParams {
-    status?: 'pending' | 'reviewed' | 'dismissed';
-    cursor?: string;
-    limit?: number;
-}
-interface AdminThreeDGenListReportsResponse {
-    reports: ThreeDGenReport[];
-    nextCursor?: string;
-}
-type AdminThreeDGenResolveAction = 'reviewed' | 'dismissed';
-interface AdminThreeDGenApi {
-    browse(params?: AdminThreeDGenBrowseParams): Promise<AdminThreeDGenBrowseResponse>;
-    removeEntry(generationId: string): Promise<void>;
-    listReports(params?: AdminThreeDGenListReportsParams): Promise<AdminThreeDGenListReportsResponse>;
-    resolveReport(reportId: string, action: AdminThreeDGenResolveAction): Promise<void>;
-}
+type AdminThreeDGenApi = AdminGenApi<ThreeDGenEntry, ThreeDGenReport>;
+type AdminImageGenBrowseParams = AdminGenBrowseParams;
+type AdminImageGenBrowseResponse = AdminGenBrowseResponse<ImageGenEntry>;
+type AdminImageGenListReportsParams = AdminGenListReportsParams;
+type AdminImageGenListReportsResponse = AdminGenListReportsResponse<ImageGenReport>;
+type AdminImageGenResolveAction = AdminGenResolveAction;
+type AdminVideoGenBrowseParams = AdminGenBrowseParams;
+type AdminVideoGenBrowseResponse = AdminGenBrowseResponse<VideoGenEntry>;
+type AdminVideoGenListReportsParams = AdminGenListReportsParams;
+type AdminVideoGenListReportsResponse = AdminGenListReportsResponse<VideoGenReport>;
+type AdminVideoGenResolveAction = AdminGenResolveAction;
+type AdminSpriteGenBrowseParams = AdminGenBrowseParams;
+type AdminSpriteGenBrowseResponse = AdminGenBrowseResponse<SpriteGenEntry>;
+type AdminSpriteGenListReportsParams = AdminGenListReportsParams;
+type AdminSpriteGenListReportsResponse = AdminGenListReportsResponse<SpriteGenReport>;
+type AdminSpriteGenResolveAction = AdminGenResolveAction;
+type AdminThreeDGenBrowseParams = AdminGenBrowseParams;
+type AdminThreeDGenBrowseResponse = AdminGenBrowseResponse<ThreeDGenEntry>;
+type AdminThreeDGenListReportsParams = AdminGenListReportsParams;
+type AdminThreeDGenListReportsResponse = AdminGenListReportsResponse<ThreeDGenReport>;
+type AdminThreeDGenResolveAction = AdminGenResolveAction;
 interface AppApi {
     getMyRole(): Promise<AppRole>;
     readonly adminUgc: AdminUgcApi;
     readonly adminImageGen: AdminImageGenApi;
+    readonly adminVideoGen: AdminVideoGenApi;
     readonly adminSpriteGen: AdminSpriteGenApi;
+    readonly adminAudioGen: AdminAudioGenApi;
     readonly adminThreeDGen: AdminThreeDGenApi;
 }
 
@@ -3767,4 +3523,4 @@ interface AdsApi {
     showInterstitialAd(options?: ShowInterstitialAdOptions): Promise<boolean>;
 }
 
-export { type FetchFromCdnOptions as $, type AnalyticsApi as A, type BatchRecipeRequirementsResult as B, type NotificationsApi as C, type ScheduleLocalNotification as D, type ScheduleNotificationOptions as E, type RCSAvailabilityStatus as F, type ScheduleRCSInput as G, type Host as H, type ScheduleRCSResult as I, type PopupsApi as J, type ShowToastOptions as K, type ShowInterstitialAdOptions as L, type ShowRewardedAdOptions as M, type NavigationApi as N, type ProfileApi as O, type Profile as P, type QuitOptions as Q, type RundotGameAPI as R, type SimulationActiveRunsUpdate as S, type DeviceApi as T, type DeviceInfo as U, type EnvironmentApi as V, type EnvironmentInfo as W, type SystemApi as X, type SafeArea as Y, type AddToHomeScreenResult as Z, type CdnApi as _, type RecipeRequirementQuery as a, type SubscriptionTier as a$, type AssetUrlResult as a0, type TimeApi as a1, type ServerTimeData as a2, type GetFutureTimeOptions as a3, type AiApi as a4, type AiChatCompletionRequest as a5, type AiChatCompletionData as a6, type HapticsApi as a7, HapticFeedbackStyle as a8, type FeaturesApi as a9, type ExecuteScopedRecipeResult as aA, type GetAvailableRecipesOptions as aB, type GetAvailableRecipesResult as aC, type Recipe as aD, type GetBatchRecipeRequirements as aE, type TriggerRecipeChainOptions as aF, type RoomDataUpdate as aG, type RoomMessageEvent as aH, type ProposedMoveEvent as aI, RundotGameTransport as aJ, type RoomsApi as aK, type CreateRoomOptions as aL, type JoinOrCreateRoomOptions as aM, type JoinOrCreateResult as aN, type ListRoomsOptions as aO, type UpdateRoomDataOptions as aP, type RoomMessageRequest as aQ, type StartRoomGameOptions as aR, type ProposeMoveRequest as aS, type ProposeMoveResult as aT, type ValidateMoveVerdict as aU, type ValidateMoveResult as aV, type RoomSubscriptionOptions as aW, type LoggingApi as aX, type IapApi as aY, type SpendCurrencyOptions as aZ, type SpendCurrencyResult as a_, type Experiment as aa, type LifecycleApi as ab, type SleepCallback as ac, type Subscription as ad, type AwakeCallback as ae, type PauseCallback as af, type ResumeCallback as ag, type QuitCallback as ah, type BackButtonCallback as ai, type SimulationApi as aj, type SimulationSlotValidationResult as ak, type SimulationBatchOperation as al, type SimulationBatchOperationsResult as am, type SimulationAvailableItem as an, type SimulationPowerPreview as ao, type SimulationSlotMutationResult as ap, type SimulationSlotContainer as aq, type SimulationAssignment as ar, type SimulationState as as, type ExecuteRecipeOptions as at, type ExecuteRecipeResponse as au, type CollectRecipeResult as av, type ResetStateOptions as aw, type ResetStateResult as ax, type GetActiveRunsOptions as ay, type ExecuteScopedRecipeOptions as az, type RecipeRequirementResult as b, type AdminSpriteGenListReportsResponse as b$, type RunSubscriptionsResponse as b0, type SubscriptionInterval as b1, type PurchaseSubscriptionResponse as b2, type OpenStoreResult as b3, type LoadEmbeddedAssetsResponse as b4, type SharedAssetsApi as b5, type LeaderboardApi as b6, type ScoreToken as b7, type SubmitScoreParams as b8, type SubmitScoreResult as b9, type AccessGateApi as bA, type TextGenApi as bB, type ImageGenApi as bC, type AudioGenApi as bD, type SpriteGenApi as bE, type ThreeDGenApi as bF, type UgcApi as bG, type VideoApi as bH, type AppApi as bI, type AdminUgcApi as bJ, type AdminImageGenApi as bK, type AdminSpriteGenApi as bL, type AdminThreeDGenApi as bM, type AppRole as bN, type AdminUgcBrowseParams as bO, type AdminUgcBrowseResponse as bP, type AdminUgcListReportsParams as bQ, type AdminUgcListReportsResponse as bR, type AdminUgcResolveAction as bS, type AdminImageGenBrowseParams as bT, type AdminImageGenBrowseResponse as bU, type AdminImageGenListReportsParams as bV, type AdminImageGenListReportsResponse as bW, type AdminImageGenResolveAction as bX, type AdminSpriteGenBrowseParams as bY, type AdminSpriteGenBrowseResponse as bZ, type AdminSpriteGenListReportsParams as b_, type GetPagedScoresOptions as ba, type PagedScoresResponse as bb, type PlayerRankOptions as bc, type PlayerRankResult as bd, type GetPodiumScoresOptions as be, type PodiumScoresResponse as bf, type PreloaderApi as bg, type SocialApi as bh, type ShareMetadata as bi, type ShareLinkResult as bj, type SocialQRCodeOptions as bk, type QRCodeResult as bl, type ShareClickData as bm, type ShareFileOptions as bn, type ShareFileResult as bo, type CanShareFileResult as bp, type EntitlementApi as bq, type Entitlement as br, type LedgerEntry as bs, type ShopApi as bt, type StorefrontResponse as bu, type StorefrontItem as bv, type ShopPurchaseResponse as bw, type ShopOrderHistoryResponse as bx, type PromptLoginResult as by, type AccessTier as bz, type RundotGameAvailableRecipe as c, type NotificationTriggerInput as c$, type AdminSpriteGenResolveAction as c0, type Avatar3dApi as c1, type AssetManifest as c2, type Avatar3dConfig as c3, type ShowEditorOptions as c4, type Avatar3dEdits as c5, type AdsApi as c6, type ImageGenParams as c7, type ImageGenResult as c8, type DepthEstimationParams as c9, type AiMessage as cA, type AiTextContent as cB, type Asset as cC, type BgRemovalModel as cD, type BiRefNetVariant as cE, type Category as cF, type ConnectionState as cG, type GetSubscriptionsForTierRequest as cH, type HudInsets as cI, type ImageGenEntry as cJ, type ImageGenModel as cK, type ImageGenReport as cL, type InboundForKeyEntry as cM, type InboundMethodIds as cN, type InboundStorageApi as cO, type IsPlayerSubscribedRequest as cP, type JoinOrCreateRoomEnvelopeResponse as cQ, type JoinRoomMatchCriteria as cR, type LeaderboardAntiCheatConfig as cS, type LeaderboardConfig as cT, type LeaderboardDisplaySettings as cU, type LeaderboardEntry as cV, type LeaderboardModeConfig as cW, type LeaderboardPeriodConfig as cX, type LeaderboardPeriodType as cY, type LoadEmbeddedAssetsRequest as cZ, MockAvatarApi as c_, type DepthEstimationResult as ca, type RemoveBackgroundParams as cb, type RemoveBackgroundResult as cc, type ImageGenJobEvent as cd, type SpriteGenParams as ce, type SpriteGenResult as cf, type AnimateSpriteParams as cg, type AnimateSpriteResult as ch, type SpriteGenJobEvent as ci, type SharedStorageHostApi as cj, type VideoGenApi as ck, type FilesApi as cl, type MultiplayerApi as cm, type AttributionApi as cn, type InitializationContext as co, type InitializationOptions as cp, AccessDeniedError as cq, type AdminThreeDGenBrowseParams as cr, type AdminThreeDGenBrowseResponse as cs, type AdminThreeDGenListReportsParams as ct, type AdminThreeDGenListReportsResponse as cu, type AdminThreeDGenResolveAction as cv, type AdminUgcEntry as cw, type AiContentBlock as cx, type AiImageContent as cy, type AiImageUrlContent as cz, type RundotGameCollectRecipeResult as d, type OnNotificationCallback as d0, type OnRequestCallback as d1, type OnResponseCallback as d2, type PodiumScoresContext as d3, type ProposedMovePayload as d4, type Protocol as d5, type PurchaseSubscriptionRequest as d6, type RCSAvailabilityReason as d7, ROOM_GAME_PHASES as d8, type RecipeInfo as d9, type SimulationPersonalState as dA, type SimulationRoomActiveRecipe as dB, type SimulationRoomState as dC, type SpriteGenEntry as dD, type SpriteGenModel as dE, type SpriteGenReport as dF, type StorefrontCollection as dG, type StorefrontCollectionItem as dH, type SubPath as dI, type ThreeDGenEntry as dJ, type ThreeDGenReport as dK, type TimeIntervalTriggerInput as dL, type UgcReport as dM, createHost as dN, resolveCollectionItemPrice as dO, type RemoveBackgroundOptions as da, type RoomEnvelopeResponse as db, type RoomEvents as dc, type RoomGamePhase as dd, type RoomMessageEventType as de, type RoomMessagePayload as df, type RoomsEnvelopeResponse as dg, RpcInboundStorageApi as dh, RpcSharedAssetsApi as di, type RpcTransport as dj, type RunSubscription as dk, type RundotGameRoomCustomMetadata as dl, type RundotGameRoomPayload as dm, type RundotGameRoomRules as dn, type RundotGameRoomRulesGameState as dp, SHARE_FILE_ALLOWED_MIME_TYPES as dq, SHARE_FILE_MAX_SIZE_BYTES as dr, type ScheduleRCSStatus as ds, type ServerPlayer as dt, type ServerRoom as du, type ShareFileMimeType as dv, type ShopOrder as dw, type SimulationBatchOperationAssign as dx, type SimulationBatchOperationRemove as dy, type SimulationBatchOperationResult as dz, type RundotGameExecuteRecipeOptions as e, type RundotGameExecuteRecipeResult as f, type RundotGameExecuteScopedRecipeOptions as g, RundotGameRoom as h, type RundotGameSimulationConfig as i, type RundotGameSimulationEffect as j, type RundotGameSimulationRecipe as k, type RundotGameSimulationStateResponse as l, type SimulationEntityUpdate as m, type SimulationRunSummary as n, type SimulationSnapshotUpdate as o, type SimulationSubscribeOptions as p, type SimulationUpdateData as q, type SimulationUpdateType as r, type RpcRequest as s, type RpcResponse as t, type RpcNotification as u, RpcClient as v, type StorageApi as w, type NavigationStackInfo as x, type PushAppOptions as y, type NavigateToGameOptions as z };
+export { type FetchFromCdnOptions as $, type AnalyticsApi as A, type BatchRecipeRequirementsResult as B, type NotificationsApi as C, type ScheduleLocalNotification as D, type ScheduleNotificationOptions as E, type RCSAvailabilityStatus as F, type ScheduleRCSInput as G, type Host as H, type ScheduleRCSResult as I, type PopupsApi as J, type ShowToastOptions as K, type ShowInterstitialAdOptions as L, type ShowRewardedAdOptions as M, type NavigationApi as N, type ProfileApi as O, type Profile as P, type QuitOptions as Q, type RundotGameAPI as R, type SimulationActiveRunsUpdate as S, type DeviceApi as T, type DeviceInfo as U, type EnvironmentApi as V, type EnvironmentInfo as W, type SystemApi as X, type SafeArea as Y, type AddToHomeScreenResult as Z, type CdnApi as _, type RecipeRequirementQuery as a, type SpendCurrencyOptions as a$, type AssetUrlResult as a0, type TimeApi as a1, type ServerTimeData as a2, type GetFutureTimeOptions as a3, type AiApi as a4, type AiChatCompletionRequest as a5, type AiChatCompletionData as a6, type AiChatCompletionStreamOptions as a7, type AiChatCompletionStreamChunk as a8, type HapticsApi as a9, type GetActiveRunsOptions as aA, type ExecuteScopedRecipeOptions as aB, type ExecuteScopedRecipeResult as aC, type GetAvailableRecipesOptions as aD, type GetAvailableRecipesResult as aE, type Recipe as aF, type GetBatchRecipeRequirements as aG, type TriggerRecipeChainOptions as aH, type RoomDataUpdate as aI, type RoomMessageEvent as aJ, type ProposedMoveEvent as aK, RundotGameTransport as aL, type RoomsApi as aM, type CreateRoomOptions as aN, type JoinOrCreateRoomOptions as aO, type JoinOrCreateResult as aP, type ListRoomsOptions as aQ, type UpdateRoomDataOptions as aR, type RoomMessageRequest as aS, type StartRoomGameOptions as aT, type ProposeMoveRequest as aU, type ProposeMoveResult as aV, type ValidateMoveVerdict as aW, type ValidateMoveResult as aX, type RoomSubscriptionOptions as aY, type LoggingApi as aZ, type IapApi as a_, HapticFeedbackStyle as aa, type FeaturesApi as ab, type Experiment as ac, type LifecycleApi as ad, type SleepCallback as ae, type Subscription as af, type AwakeCallback as ag, type PauseCallback as ah, type ResumeCallback as ai, type QuitCallback as aj, type BackButtonCallback as ak, type SimulationApi as al, type SimulationSlotValidationResult as am, type SimulationBatchOperation as an, type SimulationBatchOperationsResult as ao, type SimulationAvailableItem as ap, type SimulationPowerPreview as aq, type SimulationSlotMutationResult as ar, type SimulationSlotContainer as as, type SimulationAssignment as at, type SimulationState as au, type ExecuteRecipeOptions as av, type ExecuteRecipeResponse as aw, type CollectRecipeResult as ax, type ResetStateOptions as ay, type ResetStateResult as az, type RecipeRequirementResult as b, type FilesApi as b$, type SpendCurrencyResult as b0, type SubscriptionTier as b1, type RunSubscriptionsResponse as b2, type SubscriptionInterval as b3, type PurchaseSubscriptionResponse as b4, type OpenStoreResult as b5, type LoadEmbeddedAssetsResponse as b6, type SharedAssetsApi as b7, type PreloaderApi as b8, type SocialApi as b9, type AdminSpriteGenApi as bA, type AdminAudioGenApi as bB, type AdminThreeDGenApi as bC, type AppRole as bD, type AdminUgcBrowseParams as bE, type AdminUgcBrowseResponse as bF, type AdminUgcListReportsParams as bG, type AdminUgcListReportsResponse as bH, type AdminUgcResolveAction as bI, type AdminGenBrowseParams as bJ, type AdminGenBrowseResponse as bK, type ImageGenEntry as bL, type AdminGenListReportsParams as bM, type AdminGenListReportsResponse as bN, type ImageGenReport as bO, type AdminGenResolveAction as bP, type SpriteGenEntry as bQ, type SpriteGenReport as bR, type ThreeDGenEntry as bS, type ThreeDGenReport as bT, type Avatar3dApi as bU, type AssetManifest as bV, type Avatar3dConfig as bW, type ShowEditorOptions as bX, type Avatar3dEdits as bY, type AdsApi as bZ, type SharedStorageHostApi as b_, type ShareMetadata as ba, type ShareLinkResult as bb, type SocialQRCodeOptions as bc, type QRCodeResult as bd, type ShareClickData as be, type ShareFileOptions as bf, type ShareFileResult as bg, type CanShareFileResult as bh, type EntitlementApi as bi, type Entitlement as bj, type LedgerEntry as bk, type ShopApi as bl, type StorefrontResponse as bm, type StorefrontItem as bn, type ShopPurchaseResponse as bo, type ShopOrderHistoryResponse as bp, type PromptLoginResult as bq, type AccessTier as br, type AccessGateApi as bs, type TextGenApi as bt, type UgcApi as bu, type VideoApi as bv, type AppApi as bw, type AdminUgcApi as bx, type AdminImageGenApi as by, type AdminVideoGenApi as bz, type RundotGameAvailableRecipe as c, type RoomMessageEventType as c$, type MultiplayerApi as c0, type AttributionApi as c1, type InitializationContext as c2, type InitializationOptions as c3, AccessDeniedError as c4, type AdminGenApi as c5, type AdminImageGenBrowseParams as c6, type AdminImageGenBrowseResponse as c7, type AdminImageGenListReportsParams as c8, type AdminImageGenListReportsResponse as c9, type AudioGenEntry as cA, type AudioGenReport as cB, type Category as cC, type ConnectionState as cD, type GetSubscriptionsForTierRequest as cE, type HudInsets as cF, type InboundForKeyEntry as cG, type InboundMethodIds as cH, type InboundStorageApi as cI, type IsPlayerSubscribedRequest as cJ, type JoinOrCreateRoomEnvelopeResponse as cK, type JoinRoomMatchCriteria as cL, type LoadEmbeddedAssetsRequest as cM, MockAvatarApi as cN, type NotificationTriggerInput as cO, type OnNotificationCallback as cP, type OnRequestCallback as cQ, type OnResponseCallback as cR, type ProposedMovePayload as cS, type Protocol as cT, type PurchaseSubscriptionRequest as cU, type RCSAvailabilityReason as cV, ROOM_GAME_PHASES as cW, type RecipeInfo as cX, type RoomEnvelopeResponse as cY, type RoomEvents as cZ, type RoomGamePhase as c_, type AdminImageGenResolveAction as ca, type AdminSpriteGenBrowseParams as cb, type AdminSpriteGenBrowseResponse as cc, type AdminSpriteGenListReportsParams as cd, type AdminSpriteGenListReportsResponse as ce, type AdminSpriteGenResolveAction as cf, type AdminThreeDGenBrowseParams as cg, type AdminThreeDGenBrowseResponse as ch, type AdminThreeDGenListReportsParams as ci, type AdminThreeDGenListReportsResponse as cj, type AdminThreeDGenResolveAction as ck, type AdminUgcEntry as cl, type AdminVideoGenBrowseParams as cm, type AdminVideoGenBrowseResponse as cn, type AdminVideoGenListReportsParams as co, type AdminVideoGenListReportsResponse as cp, type AdminVideoGenResolveAction as cq, type AiContentBlock as cr, type AiImageContent as cs, type AiImageUrlContent as ct, type AiMessage as cu, type AiResponseFormat as cv, type AiTextContent as cw, type AiToolResultContent as cx, type AiToolUseContent as cy, type Asset as cz, type RundotGameCollectRecipeResult as d, type RoomMessagePayload as d0, type RoomsEnvelopeResponse as d1, RpcInboundStorageApi as d2, RpcSharedAssetsApi as d3, type RpcTransport as d4, type RunSubscription as d5, type RundotGameRoomCustomMetadata as d6, type RundotGameRoomPayload as d7, type RundotGameRoomRules as d8, type RundotGameRoomRulesGameState as d9, SHARE_FILE_ALLOWED_MIME_TYPES as da, SHARE_FILE_MAX_SIZE_BYTES as db, type ScheduleRCSStatus as dc, type ServerPlayer as dd, type ServerRoom as de, type ShareFileMimeType as df, type ShopOrder as dg, type SimulationBatchOperationAssign as dh, type SimulationBatchOperationRemove as di, type SimulationBatchOperationResult as dj, type SimulationPersonalState as dk, type SimulationRoomActiveRecipe as dl, type SimulationRoomState as dm, type StorefrontCollection as dn, type StorefrontCollectionItem as dp, type SubPath as dq, type Tool as dr, type ToolChoice as ds, type ToolUse as dt, type TimeIntervalTriggerInput as du, type UgcReport as dv, type VideoGenEntry as dw, type VideoGenReport as dx, createHost as dy, resolveCollectionItemPrice as dz, type RundotGameExecuteRecipeOptions as e, type RundotGameExecuteRecipeResult as f, type RundotGameExecuteScopedRecipeOptions as g, RundotGameRoom as h, type RundotGameSimulationConfig as i, type RundotGameSimulationEffect as j, type RundotGameSimulationRecipe as k, type RundotGameSimulationStateResponse as l, type SimulationEntityUpdate as m, type SimulationRunSummary as n, type SimulationSnapshotUpdate as o, type SimulationSubscribeOptions as p, type SimulationUpdateData as q, type SimulationUpdateType as r, type RpcRequest as s, type RpcResponse as t, type RpcNotification as u, RpcClient as v, type StorageApi as w, type NavigationStackInfo as x, type PushAppOptions as y, type NavigateToGameOptions as z };