@series-inc/rundot-game-sdk 5.24.0-beta.2 → 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-CDJtVB3I.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>;
@@ -37,6 +37,8 @@ interface RpcResponse {
         detail?: string;
         /** Structured provider rejection detail, when available. */
         errorDetail?: ProviderErrorDetail;
+        /** Milliseconds the caller should wait before retrying a rate-limited request. */
+        retryAfterMs?: number;
         stack?: string;
     };
 }
@@ -791,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>;
@@ -829,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) */
@@ -1190,6 +1215,11 @@ interface Experiment {
     readonly groupName: string | null;
 }
 interface FeaturesApi {
+    /**
+     * @deprecated Platform-managed (1p-only) experiments. For your own A/B
+     * tests use LiveOps experiments: `liveops.getConfigAsync()` → `assignments`.
+     * Slated for removal once remaining 1p callers migrate.
+     */
     getExperiment(experimentName: string): Promise<Experiment | null>;
     getFeatureFlag(flagName: string): Promise<boolean>;
     getFeatureGate(gateName: string): Promise<boolean>;
@@ -1201,29 +1231,75 @@ interface LiveOpsOverride {
     expiresAt?: string;
     values: Record<string, unknown>;
 }
+interface LiveOpsVariant {
+    id: string;
+    weight: number;
+    values: Record<string, unknown>;
+}
+interface LiveOpsExperiment {
+    id: string;
+    salt?: string;
+    activeAt?: string;
+    expiresAt?: string;
+    variants: LiveOpsVariant[];
+    /** Mock-mode only: short-circuits hashing. Rejected by push-time validators. */
+    forceVariant?: string;
+}
+interface ExperimentAssignment {
+    experimentId: string;
+    variantId: string;
+    /** Configured weights, forwarded into the exposure event so the warehouse can
+     *  compare the observed split against the intended one (sample-ratio check). */
+    variantWeight: number;
+    totalWeight: number;
+}
+/** assignVariant's return: the winning variant plus the weight sum it won under. */
+interface AssignedVariant {
+    variant: LiveOpsVariant;
+    totalWeight: number;
+}
 interface LiveOpsSection {
     values?: Record<string, unknown>;
     overrides?: LiveOpsOverride[];
+    experiments?: LiveOpsExperiment[];
 }
 interface ResolvedLiveOps {
     values: Record<string, unknown>;
     activeOverrideIds: string[];
+    assignments: ExperimentAssignment[];
     /** Epoch-ms of the next window boundary that changes the active set, or null. */
     nextChangeAt: number | null;
 }
+/** FNV-1a 32-bit. Stable, portable; do not change without re-shuffling every live experiment. */
+declare function fnv1a32(input: string): number;
+declare const BUCKET_COUNT = 10000;
+/** Double-hash into [0, BUCKET_COUNT). The double pass is load-bearing: bit 0 of a
+ *  single fnv1a32 is a parity function of the input chars (odd-char XOR flips it,
+ *  odd-prime multiply preserves it), so `hash % 2` gave every 50/50 experiment the
+ *  same global player split (verified: 0%/100% cross-experiment agreement). Hashing
+ *  the first hash's decimal string breaks that structure (cf. GrowthBook hashVersion 2).
+ *  Do not change without re-shuffling every live experiment. */
+declare function assignmentBucket(seed: string, unitId: string): number;
+/** Pure deterministic assignment; null on malformed input (degrade-not-throw).
+ *  Variants own contiguous bucket ranges in array order, boundaries scaled to
+ *  BUCKET_COUNT, so a constant-total weight edit moves only the boundaries,
+ *  which is what makes the documented ramp recipe safe. */
+declare function assignVariant(experiment: LiveOpsExperiment, unitId: string): AssignedVariant | null;
 /**
  * Resolve a LiveOps `client` section against a caller-supplied clock. Pure: never
  * reads an ambient clock (`nowMs` is server-anchored in the SDK real paths,
  * `Date.now()` in Mock, UTC now in the CLI preview). Purity is load-bearing — the
  * MP authority resolves once at match start with a frozen timestamp.
  */
-declare function resolveLiveOpsSection(section: LiveOpsSection | undefined, nowMs: number): ResolvedLiveOps;
+declare function resolveLiveOpsSection(section: LiveOpsSection | undefined, nowMs: number, unitId?: string): ResolvedLiveOps;
 
 /** Resolved config — the foot-gun-free default. */
 interface LiveOpsConfigResult {
-    /** Resolved client-visible values (base + currently-active overrides). */
+    /** Resolved client-visible values (base + active overrides + assigned variants). */
     values: Record<string, unknown>;
     activeOverrideIds: string[];
+    /** Deterministic experiment assignments for the current profile (empty pre-identity). */
+    assignments: ExperimentAssignment[];
     /** Server config snapshot id the rules came from — quote it in bug reports. */
     configVersion: string;
     /** Epoch-ms (server clock) of the next schedule flip, or null. Re-call at/after it. */
@@ -1233,6 +1309,7 @@ interface LiveOpsConfigResult {
 interface LiveOpsRawConfig {
     values: Record<string, unknown>;
     overrides: LiveOpsOverride[];
+    experiments: LiveOpsExperiment[];
     configVersion: string;
     /** Authoritative server clock at fetch, for callers doing their own resolution. */
     serverTimeMs: number;
@@ -1806,6 +1883,7 @@ interface RundotGameMessage {
         data?: any;
         error?: string;
         errorCode?: string;
+        retryAfterMs?: number;
         /** Legacy flattened provider detail STRING — the field name is wire-frozen. */
         errorDetail?: string;
         /** Structured provider rejection detail (new wire field; see errors.ts). */
@@ -1910,6 +1988,17 @@ declare class RpcSharedAssetsApi implements SharedAssetsApi {
     private readonly rpcClient;
     constructor(rpcClient: RpcClient, rundotGameApi: RundotGameAPI);
     loadAssetsBundle(game: string, bundleKey: string, fileType?: string): Promise<ArrayBuffer>;
+    /**
+     * Pull the asset from the host in chunks. Only a host that predates the
+     * chunk protocol (BEGIN rejected with "Unsupported message type") falls
+     * back to the legacy single-shot RPC. A failure DURING the chunked
+     * transfer must NOT fall back to single-shot: pushing the whole asset
+     * through the bridge in one message is the exact Android wedge this
+     * protocol exists to avoid (venus issue #2749). Those errors propagate to
+     * the caller's CDN fallback instead.
+     */
+    private loadViaHostRpc;
+    private loadSingleShot;
 }
 interface LoadEmbeddedAssetsRequest {
     assetKey: string;
@@ -1917,6 +2006,21 @@ interface LoadEmbeddedAssetsRequest {
 interface LoadEmbeddedAssetsResponse {
     base64Data: string;
 }
+interface LoadEmbeddedAssetBeginRequest {
+    assetKey: string;
+}
+interface LoadEmbeddedAssetBeginResponse {
+    totalBytes: number;
+    maxChunkBytes: number;
+}
+interface LoadEmbeddedAssetChunkRequest {
+    assetKey: string;
+    position: number;
+    length: number;
+}
+interface LoadEmbeddedAssetChunkResponse {
+    base64Data: string;
+}
 
 /** the different subscription tiers RUN offers. LITE is lowest, ULTIMATE is highest */
 type SubscriptionTier = 'LITE' | 'CORE' | 'PLUS' | 'PRIME' | 'ULTIMATE';
@@ -2004,6 +2108,30 @@ interface OpenStoreResult {
     /** The updated balance after the store closed (saves a refetch) */
     newBalance: number;
 }
+type DirectPurchaseGrantKind = 'consumable' | 'durable';
+type DirectPurchaseStorePlatform = 'web' | 'ios' | 'android' | 'steam' | 'telegram';
+interface DirectPurchaseStorePrice {
+    platform: DirectPurchaseStorePlatform;
+    displayPrice?: string;
+    appStoreProductId?: string;
+    playProductId?: string;
+    stripePriceIds?: Record<string, string>;
+    taxBehavior?: 'inclusive' | 'exclusive';
+    amountByCurrency?: Record<string, number>;
+    stars?: number;
+}
+interface DirectPurchaseSku {
+    sku: string;
+    gameId: string;
+    tierId: string;
+    nominalUsd: number;
+    storePrices: DirectPurchaseStorePrice[];
+    grant: {
+        entitlementId: string;
+        quantity: number;
+        kind: DirectPurchaseGrantKind;
+    };
+}
 interface IapApi {
     getHardCurrencyBalance(): Promise<number>;
     spendCurrency(productId: string, amount: number, options?: SpendCurrencyOptions): Promise<SpendCurrencyResult>;
@@ -2013,6 +2141,7 @@ interface IapApi {
     purchaseSubscription(tier: SubscriptionTier, interval: SubscriptionInterval): Promise<PurchaseSubscriptionResponse>;
     isUserSubscribed(tier: SubscriptionTier): Promise<boolean>;
     hasUserMadePurchase(): Promise<boolean>;
+    listDirectPurchaseSkus(gameId: string): Promise<DirectPurchaseSku[]>;
 }
 
 /**
@@ -2089,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;
@@ -2134,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
@@ -4290,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;
@@ -4510,6 +4669,11 @@ interface RundotGameAPI {
         eventName: string;
         params?: Record<string, any>;
     }): Promise<void>;
+    /**
+     * @deprecated Platform-managed (1p-only) experiments. For your own A/B
+     * tests use LiveOps experiments: `liveops.getConfigAsync()` → `assignments`.
+     * Slated for removal once remaining 1p callers migrate.
+     */
     getExperiment(options: {
         experimentName: string;
     }): Promise<any>;
@@ -4719,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 RoomMessageEvent 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 BackButtonCallback as aA, type IdentityChangedCallback as aB, type IdentityChangedEvent as aC, type SimulationApi as aD, type SimulationSlotValidationResult as aE, type SimulationBatchOperation as aF, type SimulationBatchOperationsResult as aG, type SimulationAvailableItem as aH, type SimulationPowerPreview as aI, type SimulationSlotMutationResult as aJ, type SimulationSlotContainer as aK, type SimulationAssignment as aL, type SimulationState as aM, type ExecuteRecipeOptions as aN, type ExecuteRecipeResponse as aO, type CollectRecipeResult as aP, type ResetStateOptions as aQ, type ResetStateResult as aR, type GetActiveRunsOptions as aS, type ExecuteScopedRecipeOptions as aT, type ExecuteScopedRecipeResult as aU, type GetAvailableRecipesOptions as aV, type GetAvailableRecipesResult as aW, type Recipe as aX, type GetBatchRecipeRequirements as aY, type TriggerRecipeChainOptions as aZ, type RoomDataUpdate 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 LiveOpsApi as aq, type LiveOpsConfigResult as ar, type LiveOpsRawConfig as as, type LiveOpsSection as at, type LifecycleApi as au, type SleepCallback as av, type AwakeCallback as aw, type PauseCallback as ax, type ResumeCallback as ay, type QuitCallback as az, type RecipeRequirementResult as b, type UgcApi as b$, type ProposedMoveEvent as b0, RundotGameTransport as b1, type RoomsApi as b2, type CreateRoomOptions as b3, type JoinOrCreateRoomOptions as b4, type JoinOrCreateResult as b5, type ListRoomsOptions as b6, type UpdateRoomDataOptions as b7, type RoomMessageRequest as b8, type StartRoomGameOptions as b9, 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 ComposeSocialPostOptions as bI, type ComposeSocialPostResult as bJ, type EntitlementApi as bK, type Entitlement as bL, type LedgerEntry as bM, type StatsApi as bN, type GrantInfo as bO, type CollectiblesApi as bP, type CollectibleCard as bQ, type VipClaimResult as bR, type ShopApi as bS, type StorefrontResponse as bT, type StorefrontItem as bU, type ShopPurchaseResponse as bV, type ShopOrderHistoryResponse as bW, type PromptLoginResult as bX, type AccessTier as bY, type AccessGateApi as bZ, type TextGenApi as b_, type ProposeMoveRequest as ba, type ProposeMoveResult as bb, type ValidateMoveVerdict as bc, type ValidateMoveResult as bd, type RoomSubscriptionOptions as be, type LoggingApi as bf, type IapApi as bg, type SpendCurrencyOptions as bh, type SpendCurrencyResult as bi, type SubscriptionTier as bj, type RunSubscriptionsResponse as bk, type SubscriptionInterval as bl, type PurchaseSubscriptionResponse as bm, type OpenStoreResult as bn, type LoadEmbeddedAssetsResponse as bo, type SharedAssetsApi as bp, type CreditsApi as bq, type CreditsBillingContext as br, type CreditBalance as bs, type CreditSubscription as bt, type CreditPlansCatalog as bu, type OpenPaywallOptions as bv, type CreditsPurchaseResult as bw, type Unsubscribe as bx, type PreloaderApi as by, type SocialApi as bz, type RundotGameAvailableRecipe as c, type AdminThreeDGenListReportsParams as c$, type VideoApi as c0, type AppApi as c1, type AdminUgcApi as c2, type AdminImageGenApi as c3, type AdminVideoGenApi as c4, type AdminSpriteGenApi as c5, type AdminAudioGenApi as c6, type AdminThreeDGenApi as c7, type AppRole as c8, type ResolveLaunchIntentOptions as c9, type FilesApi as cA, type ClipsApi as cB, type AttributionApi as cC, type InitializationContext as cD, type InitializationOptions as cE, type CaptureConsent as cF, type StartClipRecordingOptions as cG, type ClipBlob as cH, type ClipsSupport as cI, type ClipPersistOptions as cJ, type ClipResult as cK, type UgcEntry as cL, type CaptureConsentStatus as cM, AccessDeniedError as cN, type AdminGenApi as cO, type AdminImageGenBrowseParams as cP, type AdminImageGenBrowseResponse as cQ, type AdminImageGenListReportsParams as cR, type AdminImageGenListReportsResponse as cS, type AdminImageGenResolveAction as cT, type AdminSpriteGenBrowseParams as cU, type AdminSpriteGenBrowseResponse as cV, type AdminSpriteGenListReportsParams as cW, type AdminSpriteGenListReportsResponse as cX, type AdminSpriteGenResolveAction as cY, type AdminThreeDGenBrowseParams as cZ, type AdminThreeDGenBrowseResponse as c_, type LaunchIntent as ca, type ReleaseNote as cb, type AdminUgcBrowseParams as cc, type AdminUgcBrowseResponse as cd, type AdminUgcListReportsParams as ce, type AdminUgcListReportsResponse as cf, type AdminUgcResolveAction as cg, type AdminGenBrowseParams as ch, type AdminGenBrowseResponse as ci, type ImageGenEntry as cj, type AdminGenListReportsParams as ck, type AdminGenListReportsResponse as cl, type ImageGenReport as cm, type AdminGenResolveAction as cn, type SpriteGenEntry as co, type SpriteGenReport as cp, type ThreeDGenEntry as cq, type ThreeDGenReport as cr, type Avatar3dApi as cs, type AssetManifest as ct, type Avatar3dConfig as cu, type ShowEditorOptions as cv, type Avatar3dEdits as cw, type AdsApi as cx, type RawEnvironmentInfo as cy, type SharedStorageHostApi as cz, type RundotGameCollectRecipeResult as d, type RCSAvailabilityReason as d$, type AdminThreeDGenListReportsResponse as d0, type AdminThreeDGenResolveAction as d1, type AdminUgcEntry as d2, type AdminVideoGenBrowseParams as d3, type AdminVideoGenBrowseResponse as d4, type AdminVideoGenListReportsParams as d5, type AdminVideoGenListReportsResponse as d6, type AdminVideoGenResolveAction as d7, type AiContentBlock as d8, type AiImageContent as d9, type CreditsExhaustedErrorInfo as dA, type CreditsPurchaseOutcome as dB, GAMEPAD_BUTTON_NAMES as dC, type GamepadAxes as dD, type GamepadButtonName as dE, type GamepadButtonState as dF, type GamepadSource as dG, type GetSubscriptionsForTierRequest as dH, type HudInsets as dI, type IdentityChangeReason as dJ, type InboundForKeyEntry as dK, type InboundMethodIds as dL, type InboundStorageApi as dM, type IsPlayerSubscribedRequest as dN, type JoinOrCreateRoomEnvelopeResponse as dO, type JoinRoomMatchCriteria as dP, type LaunchIntentKind as dQ, type LiveOpsOverride as dR, type LoadEmbeddedAssetsRequest as dS, MockAvatarApi as dT, type NotificationTriggerInput as dU, type OnNotificationCallback as dV, type OnRequestCallback as dW, type OnResponseCallback as dX, type PlatformCapabilities as dY, type ProposedMovePayload as dZ, type PurchaseSubscriptionRequest as d_, type AiImageUrlContent as da, type AiMessage as db, type AiResponseFormat as dc, type AiTextContent as dd, type AiToolResultContent as de, type AiToolUseContent as df, type Asset as dg, type AudioGenEntry as dh, type AudioGenReport as di, CLIP_CONTENT_TYPE as dj, COMPOSE_POST_MAX_TEXT_LENGTH as dk, COMPOSE_POST_MAX_TITLE_LENGTH as dl, COMPOSE_POST_SUBREDDIT_PATTERN as dm, CREDITS_EXHAUSTED_CODE as dn, type Category as dp, type ClipAudioOptions as dq, type ClipCameraOptions as dr, type ClipPipLayout as ds, type ClipPipPosition as dt, type ComposeSocialPostMedia as du, type CreditFreeDailyInfo as dv, type CreditPlan as dw, type CreditTopUpPack as dx, type CreditsBilledTo as dy, CreditsExhaustedError as dz, type RundotGameExecuteRecipeOptions as e, type RCSOptInStatus as e0, ROOM_GAME_PHASES as e1, type RecipeInfo as e2, type ReleaseType as e3, type ResolvedLiveOps as e4, type RoomEnvelopeResponse as e5, type RoomGamePhase as e6, type RoomMessageEventType as e7, type RoomMessagePayload as e8, type RoomsEnvelopeResponse as e9, type SubmitMessageResultChannel as eA, TIER_SUPPORTED_INTERVALS as eB, type Tool as eC, type ToolChoice as eD, type ToolUse as eE, type TimeIntervalTriggerInput as eF, type UgcReport as eG, type VideoGenEntry as eH, type VideoGenReport as eI, asCreditsExhaustedError as eJ, assertTierSupportsInterval as eK, createHost as eL, isCreditsExhaustedError as eM, mapCreditsExhaustion as eN, resolveCollectionItemPrice as eO, resolveLiveOpsSection as eP, toPromptWireRequest as eQ, RpcInboundStorageApi as ea, RpcSharedAssetsApi as eb, type RpcTransport as ec, type RunSubscription as ed, type RundotGameRoomCustomMetadata as ee, type RundotGameRoomPayload as ef, type RundotGameRoomRules as eg, type RundotGameRoomRulesGameState as eh, SHARE_FILE_ALLOWED_MIME_TYPES as ei, SHARE_FILE_MAX_SIZE_BYTES as ej, SOCIAL_COMPOSE_PLATFORMS as ek, type ScheduleRCSStatus as el, type ShareFileMimeType as em, type ShopOrder as en, type SimulationBatchOperationAssign as eo, type SimulationBatchOperationRemove as ep, type SimulationBatchOperationResult as eq, type SimulationPersonalState as er, type SimulationRoomActiveRecipe as es, type SimulationRoomState as et, type SocialComposePlatform as eu, type StorefrontCollection as ev, type StorefrontCollectionItem as ew, type SubPath as ex, type SubmitMessageChannel as ey, type SubmitMessageChannelResult as ez, 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 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-BZFFN-il.d.ts → SyncplayRoomTransport-DCrXJ4QQ.d.ts}

@@ -1,5 +1,6 @@
-import { C as CanonicalValue, h as ReplayFile, O as OfflineSession } from './types-BV8uchSD.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).
@@ -20,6 +21,10 @@ 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;
 }
 interface InputAuthorityConfig {
@@ -63,6 +68,8 @@ 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[];
     /** A confirmed frame still inside the retained window, for redundant re-broadcast. */
@@ -172,6 +179,107 @@ type DeterministicSessionDecodeResult = {
 declare function encodeDeterministicSessionMessage(message: DeterministicSessionMessage): string;
 declare function decodeDeterministicSessionMessage(text: string): DeterministicSessionDecodeResult;
 
+interface SyncplaySecretAuthorityCrypto {
+    readonly kid: string;
+    readonly publicKeySpki: string;
+    randomBytes(length: number): Uint8Array;
+    sha256(bytes: Uint8Array): Uint8Array;
+    sign(bytes: Uint8Array): Uint8Array;
+}
+interface SyncplaySecretBrowserCrypto {
+    randomBytes(length: number): Uint8Array;
+    sha256(bytes: Uint8Array): Promise<Uint8Array>;
+    verify(publicKeySpki: string, bytes: Uint8Array, signature: Uint8Array): Promise<boolean>;
+}
+declare function createBrowserSyncplaySecretCrypto(): SyncplaySecretBrowserCrypto;
+declare function verifySyncplaySignedReceipt(receipt: SyncplaySignedReceipt, publicKeySpki: string, cryptoProvider?: SyncplaySecretBrowserCrypto): Promise<boolean>;
+
+interface SyncplaySecretClientTransport {
+    sendSecret?(text: string): void;
+    onSecretMessage?(handler: (text: string) => void): void;
+}
+interface SyncplaySecretConnectionIdentity {
+    readonly playerId?: string;
+    readonly slot: number;
+    readonly role: 'player' | 'spectator';
+}
+interface SyncplayOwnedSecret<T> {
+    readonly tokenId: string;
+    readonly systemId: string;
+    readonly ownerSlot: number;
+    readonly value: T;
+}
+interface SyncplayChoiceResolvedEvent<T> {
+    readonly systemId: string;
+    readonly requestId: string;
+    readonly roundId: string;
+    readonly reveals: Readonly<Record<number, T>>;
+    readonly missingSlots: readonly number[];
+    readonly missingReveal: 'omit' | 'forfeit';
+}
+interface SyncplayRandomDrawnEvent {
+    readonly systemId: string;
+    readonly requestId: string;
+    readonly drawIndex: number;
+    readonly value: number;
+}
+interface SyncplayCollectionRevealedEvent<T> {
+    readonly systemId: string;
+    readonly requestId: string;
+    readonly ownerSlot: number;
+    readonly tokenId: string;
+    readonly action: 'reveal' | 'play';
+    readonly value: T;
+}
+interface SyncplayRoleRevealedEvent<T> {
+    readonly systemId: string;
+    readonly requestId: string;
+    readonly slot: number;
+    readonly tokenId: string;
+    readonly value: T;
+}
+interface SyncplayChoiceClient<T> {
+    commit(roundId: string, value: T): Promise<SyncplaySignedReceipt>;
+    reveal(roundId: string): Promise<SyncplaySignedReceipt>;
+    resolved(roundId: string): Promise<SyncplayChoiceResolvedEvent<T>>;
+}
+interface SyncplayRandomClient {
+    draw(): Promise<SyncplayRandomDrawnEvent>;
+}
+interface SyncplayCollectionClient<T> {
+    draw(count?: number): Promise<readonly SyncplayOwnedSecret<T>[]>;
+    hand(): readonly SyncplayOwnedSecret<T>[];
+    reveal(tokenId: string): Promise<SyncplayCollectionRevealedEvent<T>>;
+    play(tokenId: string): Promise<SyncplayCollectionRevealedEvent<T>>;
+}
+interface SyncplayRoleClient<T> {
+    current(): SyncplayOwnedSecret<T> | undefined;
+    whenAssigned(): Promise<SyncplayOwnedSecret<T>>;
+    reveal(): Promise<SyncplayRoleRevealedEvent<T>>;
+}
+interface SyncplaySecretsClient {
+    whenReady(): Promise<void>;
+    choice<T>(systemId: string): SyncplayChoiceClient<T>;
+    random(systemId: string): SyncplayRandomClient;
+    deck<T>(systemId: string): SyncplayCollectionClient<T>;
+    bag<T>(systemId: string): SyncplayCollectionClient<T>;
+    role<T>(systemId: string): SyncplayRoleClient<T>;
+    acceptConfirmedCommands(commands: readonly CanonicalValue[]): Promise<void>;
+}
+interface CreateSyncplaySecretsClientOptions {
+    readonly transport: SyncplaySecretClientTransport;
+    readonly connection: () => SyncplaySecretConnectionIdentity;
+    readonly crypto?: SyncplaySecretBrowserCrypto;
+}
+declare function createSyncplaySecretsClient(options: CreateSyncplaySecretsClientOptions): SyncplaySecretsClient;
+interface SyncplaySecretEventReader {
+    choiceResolved<T>(systemId: string): readonly SyncplayChoiceResolvedEvent<T>[];
+    randomDrawn(systemId: string): readonly SyncplayRandomDrawnEvent[];
+    collectionRevealed<T>(systemId: string): readonly SyncplayCollectionRevealedEvent<T>[];
+    roleRevealed<T>(systemId: string): readonly SyncplayRoleRevealedEvent<T>[];
+}
+declare function createSyncplaySecretEventReader(ctx: Pick<DeterministicStepContext, 'commands'>): SyncplaySecretEventReader;
+
 /**
  * Reusable client transport for game-agnostic deterministic multiplayer (§6 M4).
  *
@@ -185,6 +293,9 @@ declare function decodeDeterministicSessionMessage(text: string): DeterministicS
 interface NetworkedClientTransport {
     send(text: string): void;
     onMessage(handler: (text: string) => void): void;
+    sendSecret?(text: string): void;
+    onSecretMessage?(handler: (text: string) => void): void;
+    readonly playerId?: string;
 }
 interface NetworkedSyncplayClientOptions<State, Input> {
     readonly transport: NetworkedClientTransport;
@@ -233,6 +344,8 @@ interface NetworkedSyncplayClientOptions<State, Input> {
     readonly inputDelay?: NetworkedSyncplayClientInputDelayOptions;
     /** Monotonic-enough clock for RTT measurement. Default Date.now. NEVER used by the sim. */
     readonly now?: () => number;
+    readonly playerId?: string;
+    readonly secretCrypto?: SyncplaySecretBrowserCrypto;
 }
 interface NetworkedSyncplayClientPacingOptions {
     /** Interval between time-sync pings while pumpPaced is driven. Default 1000. */
@@ -263,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. */
@@ -271,8 +385,11 @@ 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;
     /** Resolves once `session-start` has been received. */
     whenReady(): Promise<void>;
     /** Predict and submit local input up to the prediction budget. */
@@ -318,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;
     /**
@@ -333,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
@@ -340,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.
@@ -374,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 { type ConfirmedInputFrame as C, type DeterministicSessionDecodeRejection as D, type EncodedInput as E, type InputAuthority as I, type NetworkedClientTransport as N, type QuickMatchSyncplayOptions as Q, type SyncplayRoomTransport 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, createInputAuthority as o, createNetworkedSyncplayClient as p, createSyncplayRoom as q, decodeDeterministicSessionMessage as r, deterministicSessionWireVersion as s, encodeDeterministicSessionMessage as t, joinSyncplayRoomByCode as u, quickMatchSyncplayRoom as v };
+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 };