@series-inc/rundot-game-sdk 5.24.0-beta.3 → 5.24.0-beta.4

package/README.md

@@ -1,10 +1,10 @@
-# RUN.game SDK API
+# RUN.world SDK API
 
-Build connected HTML5 games that integrate deeply with the RUN.game platform. This package provides the client SDK used by hosted games as well as the local mock environment for development.
+Build connected HTML5 games that integrate deeply with the RUN.world platform. This package provides the client SDK used by hosted games as well as the local mock environment for development.
 
 ## Highlights
 
-- Typed APIs for RUN.game platform services (simulation, rooms, analytics, ads, and more)
+- Typed APIs for RUN.world platform services (simulation, rooms, analytics, ads, and more)
 - Host-aware tooling including lifecycle hooks, safe-area utilities, and asset loading helpers
 
 ## Quick Start
@@ -37,7 +37,7 @@ await RundotGameAPI.initializeAsync()
 
 ## Documentation
 
-The complete RUN.game SDK manuals live on [Run.game Docs](https://series-1.gitbook.io/rundot-docs). Start there for setup guides, API references, tutorials, and best practices.
+The complete RUN.world SDK manuals live on [RUN.world Docs](https://series-1.gitbook.io/rundot-docs). Start there for setup guides, API references, tutorials, and best practices.
 
 ## Support & Links
 

package/dist/{AdsApi-CscCuIMY.d.ts → AdsApi-CUkS1Vn7.d.ts}

@@ -1,5 +1,5 @@
-import { $ as ProviderErrorDetail, M as LeaderboardApi, I as ImageGenApi, A as AudioGenApi, V as VideoGenApi, q as SpriteGenApi, T as ThreeDGenApi } from './LeaderboardApi-CrWxakrr.js';
-import { M as MultiplayerApi } from './MultiplayerApi-nnrGTTcO.js';
+import { $ as ProviderErrorDetail, M as LeaderboardApi, I as ImageGenApi, A as AudioGenApi, V as VideoGenApi, q as SpriteGenApi, T as ThreeDGenApi } from './LeaderboardApi-Bp1wndvJ.js';
+import { M as MultiplayerApi } from './MultiplayerApi-TQr01JT7.js';
 
 interface StorageApi {
     key(index: number): Promise<string | null>;
@@ -793,7 +793,7 @@ interface AiMessage {
     content: string | AiContentBlock[];
 }
 type AiChatCompletionRequest = {
-    /** Model identifier (e.g., 'gpt-4o', 'claude-3-5-sonnet-20241022') */
+    /** Model identifier (e.g., 'gpt-5.6-luna', 'claude-sonnet-4-6') */
     model: string;
     /** Array of message objects in OpenAI chat format */
     messages: Array<AiMessage>;
@@ -831,6 +831,29 @@ type AiChatCompletionRequest = {
     maxTokens?: number;
     /** Upper bound for tokens generated, including visible output and reasoning tokens */
     maxCompletionTokens?: number;
+    /**
+     * Requested reasoning (thinking) effort for reasoning-capable models.
+     *
+     * Per-provider support:
+     * - **OpenAI** (`gpt-5` family): all levels, passed through natively as
+     *   `reasoning_effort`.
+     * - **Gemini**: all levels, translated to the model generation's thinking
+     *   config (thinking level on Gemini 3.x, thinking budget on Gemini 2.5).
+     * - **Anthropic** (`claude-*`) and **DeepSeek**: not yet supported — a
+     *   request carrying this field is rejected with HTTP 400.
+     *
+     * `'none'` requests minimal/disabled reasoning where the model allows it;
+     * models that cannot fully disable thinking (e.g. `gemini-2.5-pro`,
+     * Gemini 3.x) clamp to their minimum instead.
+     *
+     * Reasoning tokens are billed as OUTPUT tokens, so higher efforts increase
+     * completion-token usage and cost. When the model reasons, the response's
+     * `usage.reasoning_tokens` reports how many of the completion tokens were
+     * spent on reasoning.
+     *
+     * Older backends that predate this field silently ignore it.
+     */
+    reasoningEffort?: 'none' | 'low' | 'medium' | 'high';
     /** Sampling temperature (0.0 to 2.0) */
     temperature?: number;
     /** Nucleus sampling parameter (0.0 to 1.0) */
@@ -2195,6 +2218,35 @@ interface CreditsPurchaseResult {
     /** Refreshed balance after the paywall closed, or `null` if it couldn't be read. */
     balance: CreditBalance | null;
 }
+type GenerationCostEstimateKind = 'image' | 'music' | 'sfx' | 'video' | 'sprite' | 'animate-sprite' | 'sprite-character-animate' | 'tts' | 'text';
+interface GenerationCostEstimateRequest {
+    kind: GenerationCostEstimateKind;
+    model?: string;
+    provider?: string;
+    mode?: string;
+    durationSeconds?: number;
+    imageSize?: string;
+    removeBackground?: boolean;
+    bgRemovalModel?: string;
+    generateAudio?: boolean;
+    resolution?: string;
+    text?: string;
+    messages?: AiMessage[];
+    system?: string | AiTextContent[];
+    maxTokens?: number;
+    maxCompletionTokens?: number;
+    quantity?: number;
+}
+interface GenerationCostEstimate {
+    kind: GenerationCostEstimateKind;
+    credits: number;
+    lowCredits: number;
+    highCredits: number;
+    lowerPercent: number;
+    upperPercent: number;
+    exact: boolean;
+    reason: string;
+}
 /** Construction payload for {@link CreditsExhaustedError}. */
 interface CreditsExhaustedErrorInfo {
     billedTo: CreditsBilledTo;
@@ -2240,6 +2292,7 @@ interface CreditsApi {
     getBalance(): Promise<CreditBalance>;
     getSubscription(): Promise<CreditSubscription>;
     getPlans(): Promise<CreditPlansCatalog>;
+    estimateGenerationCost(request: GenerationCostEstimateRequest): Promise<GenerationCostEstimate>;
     /**
      * Open the host's combined paywall (plan upgrade now; top-up packs in a later
      * release). Resolves once the player closes it. Reuses the same host UI the
@@ -4396,9 +4449,9 @@ declare class MockAvatarApi implements Avatar3dApi {
 /**
  * DEFINITIVE TypeScript definitions for Rundot Game API
  *
- * This is the single source of truth for all RUN.game games.
+ * This is the single source of truth for all RUN.world games.
  *
- * Usage in RUN.game games:
+ * Usage in RUN.world games:
  * ```typescript
  * import type { RundotGameAPI } from '../../rundot-game-api/types';
  * declare const RundotGameAPI: RundotGameAPI;
@@ -4830,4 +4883,4 @@ interface AdsApi {
     showInterstitialAd(options?: ShowInterstitialAdOptions): Promise<boolean>;
 }
 
-export { type DeviceInfo as $, type AnalyticsApi as A, type BatchRecipeRequirementsResult as B, type NotificationsApi as C, type ScheduleLocalNotification as D, type SubmitMessageInput as E, type SubmitMessageResult as F, type ScheduleNotificationOptions as G, type Host as H, type RCSAvailabilityStatus as I, type ScheduleRCSInput as J, type ScheduleRCSResult as K, type RequestRCSOptInInput as L, type RequestRCSOptInResult as M, type NavigationApi as N, type PopupsApi as O, type Profile as P, type QuitOptions as Q, type RundotGameAPI as R, type SimulationActiveRunsUpdate as S, type ShowToastOptions as T, type LikeDialogResult as U, type CommentsPanelResult as V, type LikeStateResult as W, type ShowInterstitialAdOptions as X, type ShowRewardedAdOptions as Y, type ProfileApi as Z, type DeviceApi as _, type RecipeRequirementQuery as a, type RoomDataUpdate as a$, type EnvironmentApi as a0, type EnvironmentInfo as a1, type SystemApi as a2, type SafeArea as a3, type AddToHomeScreenResult as a4, type CdnApi as a5, type FetchFromCdnOptions as a6, type AssetUrlResult as a7, type TimeApi as a8, type ServerTimeData as a9, type QuitCallback as aA, type BackButtonCallback as aB, type IdentityChangedCallback as aC, type IdentityChangedEvent as aD, type SimulationApi as aE, type SimulationSlotValidationResult as aF, type SimulationBatchOperation as aG, type SimulationBatchOperationsResult as aH, type SimulationAvailableItem as aI, type SimulationPowerPreview as aJ, type SimulationSlotMutationResult as aK, type SimulationSlotContainer as aL, type SimulationAssignment as aM, type SimulationState as aN, type ExecuteRecipeOptions as aO, type ExecuteRecipeResponse as aP, type CollectRecipeResult as aQ, type ResetStateOptions as aR, type ResetStateResult as aS, type GetActiveRunsOptions as aT, type ExecuteScopedRecipeOptions as aU, type ExecuteScopedRecipeResult as aV, type GetAvailableRecipesOptions as aW, type GetAvailableRecipesResult as aX, type Recipe as aY, type GetBatchRecipeRequirements as aZ, type TriggerRecipeChainOptions as a_, type GetFutureTimeOptions as aa, type AiApi as ab, type AiChatCompletionRequest as ac, type AiChatCompletionData as ad, type PromptCompletionRequest as ae, type AiChatCompletionStreamOptions as af, type AiChatCompletionStreamChunk as ag, type HapticsApi as ah, HapticFeedbackStyle as ai, type GamepadSnapshot as aj, type GamepadConnectionEvent as ak, type Subscription as al, type GamepadApi as am, type GamepadLatencyStats as an, type FeaturesApi as ao, type Experiment as ap, type ExperimentAssignment as aq, type LiveOpsApi as ar, type LiveOpsConfigResult as as, type LiveOpsRawConfig as at, type LiveOpsSection as au, type LifecycleApi as av, type SleepCallback as aw, type AwakeCallback as ax, type PauseCallback as ay, type ResumeCallback as az, type RecipeRequirementResult as b, type AccessGateApi as b$, type RoomMessageEvent as b0, type ProposedMoveEvent as b1, RundotGameTransport as b2, type RoomsApi as b3, type CreateRoomOptions as b4, type JoinOrCreateRoomOptions as b5, type JoinOrCreateResult as b6, type ListRoomsOptions as b7, type UpdateRoomDataOptions as b8, type RoomMessageRequest as b9, type PreloaderApi as bA, type SocialApi as bB, type ShareMetadata as bC, type ShareLinkResult as bD, type SocialQRCodeOptions as bE, type QRCodeResult as bF, type ShareClickData as bG, type ShareFileOptions as bH, type ShareFileResult as bI, type CanShareFileResult as bJ, type ComposeSocialPostOptions as bK, type ComposeSocialPostResult as bL, type EntitlementApi as bM, type Entitlement as bN, type LedgerEntry as bO, type StatsApi as bP, type GrantInfo as bQ, type CollectiblesApi as bR, type CollectibleCard as bS, type VipClaimResult as bT, type ShopApi as bU, type StorefrontResponse as bV, type StorefrontItem as bW, type ShopPurchaseResponse as bX, type ShopOrderHistoryResponse as bY, type PromptLoginResult as bZ, type AccessTier as b_, type StartRoomGameOptions as ba, type ProposeMoveRequest as bb, type ProposeMoveResult as bc, type ValidateMoveVerdict as bd, type ValidateMoveResult as be, type RoomSubscriptionOptions as bf, type LoggingApi as bg, type IapApi as bh, type SpendCurrencyOptions as bi, type SpendCurrencyResult as bj, type SubscriptionTier as bk, type RunSubscriptionsResponse as bl, type SubscriptionInterval as bm, type PurchaseSubscriptionResponse as bn, type OpenStoreResult as bo, type LoadEmbeddedAssetsResponse as bp, type DirectPurchaseSku as bq, type SharedAssetsApi as br, type CreditsApi as bs, type CreditsBillingContext as bt, type CreditBalance as bu, type CreditSubscription as bv, type CreditPlansCatalog as bw, type OpenPaywallOptions as bx, type CreditsPurchaseResult as by, type Unsubscribe as bz, type RundotGameAvailableRecipe as c, type AdminThreeDGenBrowseParams as c$, type TextGenApi as c0, type UgcApi as c1, type VideoApi as c2, type AppApi as c3, type AdminUgcApi as c4, type AdminImageGenApi as c5, type AdminVideoGenApi as c6, type AdminSpriteGenApi as c7, type AdminAudioGenApi as c8, type AdminThreeDGenApi as c9, type RawEnvironmentInfo as cA, type SharedStorageHostApi as cB, type FilesApi as cC, type ClipsApi as cD, type AttributionApi as cE, type InitializationContext as cF, type InitializationOptions as cG, type CaptureConsent as cH, type StartClipRecordingOptions as cI, type ClipBlob as cJ, type ClipsSupport as cK, type ClipPersistOptions as cL, type ClipResult as cM, type UgcEntry as cN, type CaptureConsentStatus as cO, AccessDeniedError as cP, type AdminGenApi as cQ, type AdminImageGenBrowseParams as cR, type AdminImageGenBrowseResponse as cS, type AdminImageGenListReportsParams as cT, type AdminImageGenListReportsResponse as cU, type AdminImageGenResolveAction as cV, type AdminSpriteGenBrowseParams as cW, type AdminSpriteGenBrowseResponse as cX, type AdminSpriteGenListReportsParams as cY, type AdminSpriteGenListReportsResponse as cZ, type AdminSpriteGenResolveAction as c_, type AppRole as ca, type ResolveLaunchIntentOptions as cb, type LaunchIntent as cc, type ReleaseNote as cd, type AdminUgcBrowseParams as ce, type AdminUgcBrowseResponse as cf, type AdminUgcListReportsParams as cg, type AdminUgcListReportsResponse as ch, type AdminUgcResolveAction as ci, type AdminGenBrowseParams as cj, type AdminGenBrowseResponse as ck, type ImageGenEntry as cl, type AdminGenListReportsParams as cm, type AdminGenListReportsResponse as cn, type ImageGenReport as co, type AdminGenResolveAction as cp, type SpriteGenEntry as cq, type SpriteGenReport as cr, type ThreeDGenEntry as cs, type ThreeDGenReport as ct, type Avatar3dApi as cu, type AssetManifest as cv, type Avatar3dConfig as cw, type ShowEditorOptions as cx, type Avatar3dEdits as cy, type AdsApi as cz, type RundotGameCollectRecipeResult as d, type LoadEmbeddedAssetBeginRequest as d$, type AdminThreeDGenBrowseResponse as d0, type AdminThreeDGenListReportsParams as d1, type AdminThreeDGenListReportsResponse as d2, type AdminThreeDGenResolveAction as d3, type AdminUgcEntry as d4, type AdminVideoGenBrowseParams as d5, type AdminVideoGenBrowseResponse as d6, type AdminVideoGenListReportsParams as d7, type AdminVideoGenListReportsResponse as d8, type AdminVideoGenResolveAction as d9, type CreditPlan as dA, type CreditTopUpPack as dB, type CreditsBilledTo as dC, CreditsExhaustedError as dD, type CreditsExhaustedErrorInfo as dE, type CreditsPurchaseOutcome as dF, type DirectPurchaseGrantKind as dG, type DirectPurchaseStorePlatform as dH, type DirectPurchaseStorePrice as dI, GAMEPAD_BUTTON_NAMES as dJ, type GamepadAxes as dK, type GamepadButtonName as dL, type GamepadButtonState as dM, type GamepadSource as dN, type GetSubscriptionsForTierRequest as dO, type HudInsets as dP, type IdentityChangeReason as dQ, type InboundForKeyEntry as dR, type InboundMethodIds as dS, type InboundStorageApi as dT, type IsPlayerSubscribedRequest as dU, type JoinOrCreateRoomEnvelopeResponse as dV, type JoinRoomMatchCriteria as dW, type LaunchIntentKind as dX, type LiveOpsExperiment as dY, type LiveOpsOverride as dZ, type LiveOpsVariant as d_, type AiContentBlock as da, type AiImageContent as db, type AiImageUrlContent as dc, type AiMessage as dd, type AiResponseFormat as de, type AiTextContent as df, type AiToolResultContent as dg, type AiToolUseContent as dh, type Asset as di, type AssignedVariant as dj, type AudioGenEntry as dk, type AudioGenReport as dl, BUCKET_COUNT as dm, CLIP_CONTENT_TYPE as dn, COMPOSE_POST_MAX_TEXT_LENGTH as dp, COMPOSE_POST_MAX_TITLE_LENGTH as dq, COMPOSE_POST_SUBREDDIT_PATTERN as dr, CREDITS_EXHAUSTED_CODE as ds, type Category as dt, type ClipAudioOptions as du, type ClipCameraOptions as dv, type ClipPipLayout as dw, type ClipPipPosition as dx, type ComposeSocialPostMedia as dy, type CreditFreeDailyInfo as dz, type RundotGameExecuteRecipeOptions as e, fnv1a32 as e$, type LoadEmbeddedAssetBeginResponse as e0, type LoadEmbeddedAssetChunkRequest as e1, type LoadEmbeddedAssetChunkResponse as e2, type LoadEmbeddedAssetsRequest as e3, MockAvatarApi as e4, type NotificationTriggerInput as e5, type OnNotificationCallback as e6, type OnRequestCallback as e7, type OnResponseCallback as e8, type PlatformCapabilities as e9, type ShopOrder as eA, type SimulationBatchOperationAssign as eB, type SimulationBatchOperationRemove as eC, type SimulationBatchOperationResult as eD, type SimulationPersonalState as eE, type SimulationRoomActiveRecipe as eF, type SimulationRoomState as eG, type SocialComposePlatform as eH, type StorefrontCollection as eI, type StorefrontCollectionItem as eJ, type SubPath as eK, type SubmitMessageChannel as eL, type SubmitMessageChannelResult as eM, type SubmitMessageResultChannel as eN, TIER_SUPPORTED_INTERVALS as eO, type Tool as eP, type ToolChoice as eQ, type ToolUse as eR, type TimeIntervalTriggerInput as eS, type UgcReport as eT, type VideoGenEntry as eU, type VideoGenReport as eV, asCreditsExhaustedError as eW, assertTierSupportsInterval as eX, assignVariant as eY, assignmentBucket as eZ, createHost as e_, type ProposedMovePayload as ea, type PurchaseSubscriptionRequest as eb, type RCSAvailabilityReason as ec, type RCSOptInStatus as ed, ROOM_GAME_PHASES as ee, type RecipeInfo as ef, type ReleaseType as eg, type ResolvedLiveOps as eh, type RoomEnvelopeResponse as ei, type RoomGamePhase as ej, type RoomMessageEventType as ek, type RoomMessagePayload as el, type RoomsEnvelopeResponse as em, RpcInboundStorageApi as en, RpcSharedAssetsApi as eo, type RpcTransport as ep, type RunSubscription as eq, type RundotGameRoomCustomMetadata as er, type RundotGameRoomPayload as es, type RundotGameRoomRules as et, type RundotGameRoomRulesGameState as eu, SHARE_FILE_ALLOWED_MIME_TYPES as ev, SHARE_FILE_MAX_SIZE_BYTES as ew, SOCIAL_COMPOSE_PLATFORMS as ex, type ScheduleRCSStatus as ey, type ShareFileMimeType as ez, type RundotGameExecuteRecipeResult as f, isCreditsExhaustedError as f0, mapCreditsExhaustion as f1, resolveCollectionItemPrice as f2, resolveLiveOpsSection as f3, toPromptWireRequest as f4, 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 DeviceInfo as $, type AnalyticsApi as A, type BatchRecipeRequirementsResult as B, type NotificationsApi as C, type ScheduleLocalNotification as D, type SubmitMessageInput as E, type SubmitMessageResult as F, type ScheduleNotificationOptions as G, type Host as H, type RCSAvailabilityStatus as I, type ScheduleRCSInput as J, type ScheduleRCSResult as K, type RequestRCSOptInInput as L, type RequestRCSOptInResult as M, type NavigationApi as N, type PopupsApi as O, type Profile as P, type QuitOptions as Q, type RundotGameAPI as R, type SimulationActiveRunsUpdate as S, type ShowToastOptions as T, type LikeDialogResult as U, type CommentsPanelResult as V, type LikeStateResult as W, type ShowInterstitialAdOptions as X, type ShowRewardedAdOptions as Y, type ProfileApi as Z, type DeviceApi as _, type RecipeRequirementQuery as a, type RoomDataUpdate as a$, type EnvironmentApi as a0, type EnvironmentInfo as a1, type SystemApi as a2, type SafeArea as a3, type AddToHomeScreenResult as a4, type CdnApi as a5, type FetchFromCdnOptions as a6, type AssetUrlResult as a7, type TimeApi as a8, type ServerTimeData as a9, type QuitCallback as aA, type BackButtonCallback as aB, type IdentityChangedCallback as aC, type IdentityChangedEvent as aD, type SimulationApi as aE, type SimulationSlotValidationResult as aF, type SimulationBatchOperation as aG, type SimulationBatchOperationsResult as aH, type SimulationAvailableItem as aI, type SimulationPowerPreview as aJ, type SimulationSlotMutationResult as aK, type SimulationSlotContainer as aL, type SimulationAssignment as aM, type SimulationState as aN, type ExecuteRecipeOptions as aO, type ExecuteRecipeResponse as aP, type CollectRecipeResult as aQ, type ResetStateOptions as aR, type ResetStateResult as aS, type GetActiveRunsOptions as aT, type ExecuteScopedRecipeOptions as aU, type ExecuteScopedRecipeResult as aV, type GetAvailableRecipesOptions as aW, type GetAvailableRecipesResult as aX, type Recipe as aY, type GetBatchRecipeRequirements as aZ, type TriggerRecipeChainOptions as a_, type GetFutureTimeOptions as aa, type AiApi as ab, type AiChatCompletionRequest as ac, type AiChatCompletionData as ad, type PromptCompletionRequest as ae, type AiChatCompletionStreamOptions as af, type AiChatCompletionStreamChunk as ag, type HapticsApi as ah, HapticFeedbackStyle as ai, type GamepadSnapshot as aj, type GamepadConnectionEvent as ak, type Subscription as al, type GamepadApi as am, type GamepadLatencyStats as an, type FeaturesApi as ao, type Experiment as ap, type ExperimentAssignment as aq, type LiveOpsApi as ar, type LiveOpsConfigResult as as, type LiveOpsRawConfig as at, type LiveOpsSection as au, type LifecycleApi as av, type SleepCallback as aw, type AwakeCallback as ax, type PauseCallback as ay, type ResumeCallback as az, type RecipeRequirementResult as b, type PromptLoginResult as b$, type RoomMessageEvent as b0, type ProposedMoveEvent as b1, RundotGameTransport as b2, type RoomsApi as b3, type CreateRoomOptions as b4, type JoinOrCreateRoomOptions as b5, type JoinOrCreateResult as b6, type ListRoomsOptions as b7, type UpdateRoomDataOptions as b8, type RoomMessageRequest as b9, type CreditsPurchaseResult as bA, type Unsubscribe as bB, type PreloaderApi as bC, type SocialApi as bD, type ShareMetadata as bE, type ShareLinkResult as bF, type SocialQRCodeOptions as bG, type QRCodeResult as bH, type ShareClickData as bI, type ShareFileOptions as bJ, type ShareFileResult as bK, type CanShareFileResult as bL, type ComposeSocialPostOptions as bM, type ComposeSocialPostResult as bN, type EntitlementApi as bO, type Entitlement as bP, type LedgerEntry as bQ, type StatsApi as bR, type GrantInfo as bS, type CollectiblesApi as bT, type CollectibleCard as bU, type VipClaimResult as bV, type ShopApi as bW, type StorefrontResponse as bX, type StorefrontItem as bY, type ShopPurchaseResponse as bZ, type ShopOrderHistoryResponse as b_, type StartRoomGameOptions as ba, type ProposeMoveRequest as bb, type ProposeMoveResult as bc, type ValidateMoveVerdict as bd, type ValidateMoveResult as be, type RoomSubscriptionOptions as bf, type LoggingApi as bg, type IapApi as bh, type SpendCurrencyOptions as bi, type SpendCurrencyResult as bj, type SubscriptionTier as bk, type RunSubscriptionsResponse as bl, type SubscriptionInterval as bm, type PurchaseSubscriptionResponse as bn, type OpenStoreResult as bo, type LoadEmbeddedAssetsResponse as bp, type DirectPurchaseSku as bq, type SharedAssetsApi as br, type CreditsApi as bs, type CreditsBillingContext as bt, type CreditBalance as bu, type CreditSubscription as bv, type CreditPlansCatalog as bw, type GenerationCostEstimateRequest as bx, type GenerationCostEstimate as by, type OpenPaywallOptions as bz, type RundotGameAvailableRecipe as c, type AdminSpriteGenListReportsResponse as c$, type AccessTier as c0, type AccessGateApi as c1, type TextGenApi as c2, type UgcApi as c3, type VideoApi as c4, type AppApi as c5, type AdminUgcApi as c6, type AdminImageGenApi as c7, type AdminVideoGenApi as c8, type AdminSpriteGenApi as c9, type Avatar3dEdits as cA, type AdsApi as cB, type RawEnvironmentInfo as cC, type SharedStorageHostApi as cD, type FilesApi as cE, type ClipsApi as cF, type AttributionApi as cG, type InitializationContext as cH, type InitializationOptions as cI, type CaptureConsent as cJ, type StartClipRecordingOptions as cK, type ClipBlob as cL, type ClipsSupport as cM, type ClipPersistOptions as cN, type ClipResult as cO, type UgcEntry as cP, type CaptureConsentStatus as cQ, AccessDeniedError as cR, type AdminGenApi as cS, type AdminImageGenBrowseParams as cT, type AdminImageGenBrowseResponse as cU, type AdminImageGenListReportsParams as cV, type AdminImageGenListReportsResponse as cW, type AdminImageGenResolveAction as cX, type AdminSpriteGenBrowseParams as cY, type AdminSpriteGenBrowseResponse as cZ, type AdminSpriteGenListReportsParams as c_, type AdminAudioGenApi as ca, type AdminThreeDGenApi as cb, type AppRole as cc, type ResolveLaunchIntentOptions as cd, type LaunchIntent as ce, type ReleaseNote as cf, type AdminUgcBrowseParams as cg, type AdminUgcBrowseResponse as ch, type AdminUgcListReportsParams as ci, type AdminUgcListReportsResponse as cj, type AdminUgcResolveAction as ck, type AdminGenBrowseParams as cl, type AdminGenBrowseResponse as cm, type ImageGenEntry as cn, type AdminGenListReportsParams as co, type AdminGenListReportsResponse as cp, type ImageGenReport as cq, type AdminGenResolveAction as cr, type SpriteGenEntry as cs, type SpriteGenReport as ct, type ThreeDGenEntry as cu, type ThreeDGenReport as cv, type Avatar3dApi as cw, type AssetManifest as cx, type Avatar3dConfig as cy, type ShowEditorOptions as cz, type RundotGameCollectRecipeResult as d, type LiveOpsExperiment as d$, type AdminSpriteGenResolveAction as d0, type AdminThreeDGenBrowseParams as d1, type AdminThreeDGenBrowseResponse as d2, type AdminThreeDGenListReportsParams as d3, type AdminThreeDGenListReportsResponse as d4, type AdminThreeDGenResolveAction as d5, type AdminUgcEntry as d6, type AdminVideoGenBrowseParams as d7, type AdminVideoGenBrowseResponse as d8, type AdminVideoGenListReportsParams as d9, type ComposeSocialPostMedia as dA, type CreditFreeDailyInfo as dB, type CreditPlan as dC, type CreditTopUpPack as dD, type CreditsBilledTo as dE, CreditsExhaustedError as dF, type CreditsExhaustedErrorInfo as dG, type CreditsPurchaseOutcome as dH, type DirectPurchaseGrantKind as dI, type DirectPurchaseStorePlatform as dJ, type DirectPurchaseStorePrice as dK, GAMEPAD_BUTTON_NAMES as dL, type GamepadAxes as dM, type GamepadButtonName as dN, type GamepadButtonState as dO, type GamepadSource as dP, type GenerationCostEstimateKind as dQ, type GetSubscriptionsForTierRequest as dR, type HudInsets as dS, type IdentityChangeReason as dT, type InboundForKeyEntry as dU, type InboundMethodIds as dV, type InboundStorageApi as dW, type IsPlayerSubscribedRequest as dX, type JoinOrCreateRoomEnvelopeResponse as dY, type JoinRoomMatchCriteria as dZ, type LaunchIntentKind as d_, type AdminVideoGenListReportsResponse as da, type AdminVideoGenResolveAction as db, type AiContentBlock as dc, type AiImageContent as dd, type AiImageUrlContent as de, type AiMessage as df, type AiResponseFormat as dg, type AiTextContent as dh, type AiToolResultContent as di, type AiToolUseContent as dj, type Asset as dk, type AssignedVariant as dl, type AudioGenEntry as dm, type AudioGenReport as dn, BUCKET_COUNT as dp, CLIP_CONTENT_TYPE as dq, COMPOSE_POST_MAX_TEXT_LENGTH as dr, COMPOSE_POST_MAX_TITLE_LENGTH as ds, COMPOSE_POST_SUBREDDIT_PATTERN as dt, CREDITS_EXHAUSTED_CODE as du, type Category as dv, type ClipAudioOptions as dw, type ClipCameraOptions as dx, type ClipPipLayout as dy, type ClipPipPosition as dz, type RundotGameExecuteRecipeOptions as e, assignVariant as e$, type LiveOpsOverride as e0, type LiveOpsVariant as e1, type LoadEmbeddedAssetBeginRequest as e2, type LoadEmbeddedAssetBeginResponse as e3, type LoadEmbeddedAssetChunkRequest as e4, type LoadEmbeddedAssetChunkResponse as e5, type LoadEmbeddedAssetsRequest as e6, MockAvatarApi as e7, type NotificationTriggerInput as e8, type OnNotificationCallback as e9, SOCIAL_COMPOSE_PLATFORMS as eA, type ScheduleRCSStatus as eB, type ShareFileMimeType as eC, type ShopOrder as eD, type SimulationBatchOperationAssign as eE, type SimulationBatchOperationRemove as eF, type SimulationBatchOperationResult as eG, type SimulationPersonalState as eH, type SimulationRoomActiveRecipe as eI, type SimulationRoomState as eJ, type SocialComposePlatform as eK, type StorefrontCollection as eL, type StorefrontCollectionItem as eM, type SubPath as eN, type SubmitMessageChannel as eO, type SubmitMessageChannelResult as eP, type SubmitMessageResultChannel as eQ, TIER_SUPPORTED_INTERVALS as eR, type Tool as eS, type ToolChoice as eT, type ToolUse as eU, type TimeIntervalTriggerInput as eV, type UgcReport as eW, type VideoGenEntry as eX, type VideoGenReport as eY, asCreditsExhaustedError as eZ, assertTierSupportsInterval as e_, type OnRequestCallback as ea, type OnResponseCallback as eb, type PlatformCapabilities as ec, type ProposedMovePayload as ed, type PurchaseSubscriptionRequest as ee, type RCSAvailabilityReason as ef, type RCSOptInStatus as eg, ROOM_GAME_PHASES as eh, type RecipeInfo as ei, type ReleaseType as ej, type ResolvedLiveOps as ek, type RoomEnvelopeResponse as el, type RoomGamePhase as em, type RoomMessageEventType as en, type RoomMessagePayload as eo, type RoomsEnvelopeResponse as ep, RpcInboundStorageApi as eq, RpcSharedAssetsApi as er, type RpcTransport as es, type RunSubscription as et, type RundotGameRoomCustomMetadata as eu, type RundotGameRoomPayload as ev, type RundotGameRoomRules as ew, type RundotGameRoomRulesGameState as ex, SHARE_FILE_ALLOWED_MIME_TYPES as ey, SHARE_FILE_MAX_SIZE_BYTES as ez, type RundotGameExecuteRecipeResult as f, assignmentBucket as f0, createHost as f1, fnv1a32 as f2, isCreditsExhaustedError as f3, mapCreditsExhaustion as f4, resolveCollectionItemPrice as f5, resolveLiveOpsSection as f6, toPromptWireRequest as f7, 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 };

package/dist/{LeaderboardApi-CrWxakrr.d.ts → LeaderboardApi-Bp1wndvJ.d.ts}

@@ -1,4 +1,4 @@
-import { h as ReplayFile } from './types-BV8uchSD.js';
+import { h as ReplayFile } from './types-ChJ9TO_o.js';
 
 type ImageGenModel = 'gemini-3.1-flash-image-preview' | 'gemini-3-pro-image-preview' | 'gpt-image-1' | 'gpt-image-2';
 type BgRemovalModel = 'bria' | 'birefnet';

package/dist/{MultiplayerApi-nnrGTTcO.d.ts → MultiplayerApi-TQr01JT7.d.ts}

@@ -77,6 +77,12 @@ interface ServerRoom<P extends Protocol> {
     readonly playerId: string;
     /** Whether the room is locked */
     readonly locked: boolean;
+    /** Authoritative current room roster. */
+    readonly players: readonly ServerPlayer[];
+    /** Effective server-enforced capacity. */
+    readonly maxPlayers: number;
+    /** Whether this player created the room. */
+    readonly isCreator: boolean;
     /** Current latency in ms (round-trip / 2) */
     readonly latency: number;
     /** Connection state */
@@ -85,6 +91,8 @@ interface ServerRoom<P extends Protocol> {
     on(events: RoomEvents<P>): void;
     /** Send a typed message to the server room. */
     send(message: P): void;
+    /** Open or close the room to new seats. Only the room creator is authorized. */
+    setSeatingOpen(open: boolean): void;
     /**
      * Send an opaque payload under `msgType` without the typed-message envelope
      * transform. `data` is delivered verbatim (a raw string stays a string), so
@@ -193,4 +201,4 @@ type MatchmakeOptions = Pick<RoomOptions, 'criteria'> & {
     pollIntervalMs?: number;
 };
 
-export type { ChatMessageData as C, JoinTicketRequest as J, ListUserRoomsOptions as L, MultiplayerApi as M, Protocol as P, RealtimeRoomSummary as R, ServerRoom as S, RoomOptions as a, MatchmakeOptions as b, ConnectionState as c, RoomEvents as d, ServerPlayer as e };
+export type { ChatMessageData as C, JoinTicketRequest as J, ListUserRoomsOptions as L, MultiplayerApi as M, Protocol as P, RealtimeRoomSummary as R, ServerPlayer as S, RoomOptions as a, ServerRoom as b, MatchmakeOptions as c, ConnectionState as d, RoomEvents as e };

package/dist/{SyncplayRoomTransport-Bfv_KE63.d.ts → SyncplayRoomTransport-DCrXJ4QQ.d.ts}

@@ -1,6 +1,6 @@
-import { C as CanonicalValue, c as DeterministicStepContext, h as ReplayFile, O as OfflineSession } from './types-BV8uchSD.js';
-import { S as SyncplaySignedReceipt } from './secret-protocol-hnhTHLBs.js';
-import { M as MultiplayerApi } from './MultiplayerApi-nnrGTTcO.js';
+import { C as CanonicalValue, c as DeterministicStepContext, h as ReplayFile, O as OfflineSession } from './types-ChJ9TO_o.js';
+import { S as SyncplaySignedReceipt } from './secret-protocol-DY332qWW.js';
+import { S as ServerPlayer, M as MultiplayerApi } from './MultiplayerApi-TQr01JT7.js';
 
 /**
  * Game-agnostic input authority (server orders inputs, clients simulate — §2 Option 1).
@@ -21,6 +21,8 @@ interface ConfirmedInputFrame {
     readonly inputs: readonly EncodedInput[];
     /** Slots whose input was substituted (repeated) because it never arrived in time. */
     readonly substitutedSlots: readonly number[];
+    /** Human-occupied slots at this authority tick. Omitted by legacy authorities. */
+    readonly occupiedSlots?: readonly number[];
     /** Immutable authority-owned consequences applied immediately before this tick's simulation step. */
     readonly commands?: readonly CanonicalValue[];
     readonly checksum: string;
@@ -66,6 +68,7 @@ interface InputAuthority {
     /** Lowest confirmed tick still retained, or -1 when nothing is confirmed yet. */
     readonly earliestRetainedTick: number;
     receiveInput(slot: number, tick: number, input: EncodedInput): InputSubmissionResult;
+    recordOccupiedSlots(tick: number, slots: readonly number[]): void;
     queueCommand(tick: number, command: CanonicalValue): void;
     /** Confirm every tick that can be confirmed up to and including `now`. Returns the new frames in order. */
     advance(now: number): readonly ConfirmedInputFrame[];
@@ -373,6 +376,7 @@ interface NetworkedSyncplayClientNetStats {
     readonly rollbacks: number;
     readonly maxRollbackDepth: number;
 }
+type NetworkedSyncplaySlotPresence = 'human' | 'substituted' | 'empty' | 'unknown';
 interface NetworkedSyncplayClient {
     readonly slot: number;
     /** 'player' (holds a slot) or 'spectator' (read-only follower, slot -1). From session-start. */
@@ -381,6 +385,8 @@ interface NetworkedSyncplayClient {
     readonly predictedThrough: number;
     readonly appliedThrough: number;
     readonly rollbacks: number;
+    /** Human occupancy at the latest contiguous authority-confirmed frame. */
+    readonly confirmedPlayerPresence: readonly NetworkedSyncplaySlotPresence[];
     /** Live local netcode telemetry (RTT, timescale, delay, rollback depth). */
     readonly netStats: NetworkedSyncplayClientNetStats;
     readonly secrets: SyncplaySecretsClient;
@@ -429,11 +435,23 @@ type SyncplayConnectionEvent = {
 } | {
     readonly kind: 'reconnecting';
 };
+interface SyncplayRoomOptions {
+    readonly maxPlayers?: number;
+}
+interface SyncplayOccupancySnapshot {
+    readonly players: readonly ServerPlayer[];
+    readonly occupied: number;
+    readonly maxPlayers: number;
+    readonly full: boolean;
+    readonly locked: boolean;
+}
 interface SyncplayRoomTransport extends NetworkedClientTransport {
     /** The shareable room code (e.g. "HX9KWR"). */
     readonly roomCode: string;
     /** This client's player id, as assigned by the server on join. */
     readonly playerId: string;
+    readonly occupancy: SyncplayOccupancySnapshot;
+    readonly isCreator: boolean;
     /** Leave the deterministic room and close the underlying connection. */
     close(): void;
     /**
@@ -444,6 +462,8 @@ interface SyncplayRoomTransport extends NetworkedClientTransport {
      * the match down.
      */
     onConnectionEvent(handler: (event: SyncplayConnectionEvent) => void): void;
+    onOccupancyChange(handler: (snapshot: SyncplayOccupancySnapshot) => void): () => void;
+    setSeatingOpen(open: boolean): void;
 }
 /**
  * Join an existing deterministic room by its 6-char code and return a transport
@@ -451,7 +471,7 @@ interface SyncplayRoomTransport extends NetworkedClientTransport {
  */
 declare function joinSyncplayRoomByCode(api: MultiplayerApi, code: string): Promise<SyncplayRoomTransport>;
 /** Options for {@link quickMatchSyncplayRoom}. */
-interface QuickMatchSyncplayOptions {
+interface QuickMatchSyncplayOptions extends SyncplayRoomOptions {
     /**
      * Auto-inject a coarse `region` criterion (default true). See
      * {@link quickMatchSyncplayRoom} for the semantics and the tradeoff.
@@ -485,6 +505,6 @@ declare function quickMatchSyncplayRoom(api: MultiplayerApi, criteria?: Record<s
  * (Caller-chosen codes are not supported on create — when the platform grows
  * that path, this signature gains a typed parameter rather than a dead one.)
  */
-declare function createSyncplayRoom(api: MultiplayerApi): Promise<SyncplayRoomTransport>;
+declare function createSyncplayRoom(api: MultiplayerApi, options?: SyncplayRoomOptions): Promise<SyncplayRoomTransport>;
 
-export { createBrowserSyncplaySecretCrypto as A, createInputAuthority as B, type ConfirmedInputFrame as C, type DeterministicSessionDecodeRejection as D, type EncodedInput as E, createNetworkedSyncplayClient as F, createSyncplayRoom as G, createSyncplaySecretEventReader as H, type InputAuthority as I, createSyncplaySecretsClient as J, decodeDeterministicSessionMessage as K, deterministicSessionWireVersion as L, encodeDeterministicSessionMessage as M, type NetworkedClientTransport as N, joinSyncplayRoomByCode as O, quickMatchSyncplayRoom as P, type QuickMatchSyncplayOptions as Q, verifySyncplaySignedReceipt as R, type SyncplaySecretAuthorityCrypto as S, type DeterministicSessionDecodeResult as a, type DeterministicSessionMessage as b, type DeterministicSessionMessageKind as c, type DeterministicSessionRole as d, type InputAuthorityConfig as e, type InputAuthorityRestoreState as f, type InputAuthorityStats as g, type InputRejectionReason as h, type InputSubmissionResult as i, type NetworkedSyncplayClient as j, type NetworkedSyncplayClientInputDelayOptions as k, type NetworkedSyncplayClientNetStats as l, type NetworkedSyncplayClientOptions as m, type NetworkedSyncplayClientPacingOptions as n, type SyncplayChoiceClient as o, type SyncplayChoiceResolvedEvent as p, type SyncplayCollectionClient as q, type SyncplayCollectionRevealedEvent as r, type SyncplayOwnedSecret as s, type SyncplayRandomClient as t, type SyncplayRandomDrawnEvent as u, type SyncplayRoleClient as v, type SyncplayRoleRevealedEvent as w, type SyncplayRoomTransport as x, type SyncplaySecretEventReader as y, type SyncplaySecretsClient as z };
+export { type SyncplayRoomTransport as A, type SyncplaySecretEventReader as B, type ConfirmedInputFrame as C, type DeterministicSessionDecodeRejection as D, type EncodedInput as E, type SyncplaySecretsClient as F, createBrowserSyncplaySecretCrypto as G, createInputAuthority as H, type InputAuthority as I, createNetworkedSyncplayClient as J, createSyncplayRoom as K, createSyncplaySecretEventReader as L, createSyncplaySecretsClient as M, type NetworkedClientTransport as N, decodeDeterministicSessionMessage as O, deterministicSessionWireVersion as P, type QuickMatchSyncplayOptions as Q, encodeDeterministicSessionMessage as R, type SyncplaySecretAuthorityCrypto as S, joinSyncplayRoomByCode as T, quickMatchSyncplayRoom as U, verifySyncplaySignedReceipt as V, type DeterministicSessionDecodeResult as a, type DeterministicSessionMessage as b, type DeterministicSessionMessageKind as c, type DeterministicSessionRole as d, type InputAuthorityConfig as e, type InputAuthorityRestoreState as f, type InputAuthorityStats as g, type InputRejectionReason as h, type InputSubmissionResult as i, type NetworkedSyncplayClient as j, type NetworkedSyncplayClientInputDelayOptions as k, type NetworkedSyncplayClientNetStats as l, type NetworkedSyncplayClientOptions as m, type NetworkedSyncplayClientPacingOptions as n, type NetworkedSyncplaySlotPresence as o, type SyncplayChoiceClient as p, type SyncplayChoiceResolvedEvent as q, type SyncplayCollectionClient as r, type SyncplayCollectionRevealedEvent as s, type SyncplayOccupancySnapshot as t, type SyncplayOwnedSecret as u, type SyncplayRandomClient as v, type SyncplayRandomDrawnEvent as w, type SyncplayRoleClient as x, type SyncplayRoleRevealedEvent as y, type SyncplayRoomOptions as z };

package/dist/{callRemoteFunction-NBIrdLoa.d.ts → callRemoteFunction-DeGLqhjj.d.ts}

@@ -1,3 +1,19 @@
+/**
+ * Backend HTTP dependencies injected into the Http*Api classes so they are
+ * decoupled from the SDK playground globals (getFirebaseClient/getCloudRunUrl).
+ * Each host (PlaygroundHost, Telegram shell, future Steam shell) supplies its own.
+ */
+interface BackendHttpDeps {
+    getIdToken(): Promise<string>;
+    getCloudRunUrl(): string;
+    /**
+     * Returns the host's game-session token (`x-h5-game-session`) for the current
+     * game+user, or `null` when unavailable. Optional so non-playground shells
+     * that don't mint a GST omit the header and stay fail-safe.
+     */
+    getGameSessionToken?(): Promise<string | null>;
+}
+
 /**
  * HTTP wrapper for calling Cloud Functions.
  *
@@ -20,4 +36,4 @@
  */
 type RemoteFunctionInvoker = <TResponse>(functionName: string, payload?: unknown) => Promise<TResponse>;
 
-export type { RemoteFunctionInvoker as R };
+export type { BackendHttpDeps as B, RemoteFunctionInvoker as R };

package/dist/{chunk-XQC54EPQ.js → chunk-2RSDZJHS.js}

@@ -905,6 +905,23 @@ function createDeterministicMath(fixedScale = 1e3, minFixed = DEFAULT_MIN_FIXED,
       }
       return saturate(x, minFixed, maxFixed);
     },
+    integerSqrt(value) {
+      if (!Number.isSafeInteger(value) || value < 0) {
+        throw new Error("DeterministicMath.integerSqrt: value must be a non-negative safe integer");
+      }
+      if (value < 2) return value;
+      let low = 1;
+      let high = Math.min(value, 94906266);
+      while (low <= high) {
+        const mid = low + Math.trunc((high - low) / 2);
+        if (mid <= Math.trunc(value / mid)) {
+          low = mid + 1;
+        } else {
+          high = mid - 1;
+        }
+      }
+      return high;
+    },
     abs(value) {
       assertFixed(value);
       return saturate(value < 0 ? -value : value, minFixed, maxFixed);
@@ -1057,6 +1074,11 @@ function createDeterministicMath(fixedScale = 1e3, minFixed = DEFAULT_MIN_FIXED,
       }
       return (full % fixedScale + fixedScale) % fixedScale;
     },
+    atan2Signed(y, x) {
+      const turn = this.atan2(y, x);
+      const half = fixedScale / 2;
+      return turn >= half ? turn - fixedScale : turn;
+    },
     wrapTurns(t) {
       assertFixed(t);
       return (t % fixedScale + fixedScale) % fixedScale;
@@ -3498,5 +3520,5 @@ function createSessionFromPromotionSnapshot(config, blob) {
 }
 
 export { DEFAULT_MAX_SNAPSHOT_BYTES, DEFAULT_SNAPSHOT_CHUNK_SIZE, DeterministicRandom, SyncplayError, assertDeterministicPayloadFields, base64ToBytes, buildDeterministicSession, bytesToBase64, canonicalStringify, canonicalize, cloneCanonical, createDeterministicCommandTimeline, createDeterministicCommandTimelineSnapshot, createDeterministicMath, createInstantReplayRunner, createOfflineSession, createPauseController, createSchemaArtifacts, createSessionFromPromotionSnapshot, createSnapshotTransferCollector, createSnapshotTransferFromBytes, createStableIndexedMap, createSyncplayOfflineRuntime, decodeCanonicalBytes, decodeCanonicalValue, decodeDeterministicStateSnapshot, decodeSyncplaySecretPrivateMessage, decodeSyncplaySecretRequest, decodeUtf8, defaultChecksum, defineSyncplayGame, deserializeStateWith, deterministicPayloadMatchesFields, deterministicRoomDescriptorHash, deterministicShuffle, encodeCanonicalBytes, encodeDeterministicStateSnapshot, encodeSyncplaySecretPrivateMessage, encodeSyncplaySecretRequest, encodeUtf8, evaluateDeterministicCommandTimelineMigrationResult, exportPromotionSnapshot, hasSyncplaySecretCommandPrefix, invariant, isSyncplaySecretCommand, runInstantReplay, serializeStateWith, stableDescriptorId, stableEntries, stableSortedKeys, syncplaySecretProtocol, verifyReplay, verifyReplayWithDescriptor, withRuntimeDeterminismGuards };
-//# sourceMappingURL=chunk-XQC54EPQ.js.map
-//# sourceMappingURL=chunk-XQC54EPQ.js.map
+//# sourceMappingURL=chunk-2RSDZJHS.js.map
+//# sourceMappingURL=chunk-2RSDZJHS.js.map