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

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

@@ -1,4 +1,4 @@
-import { $ as ProviderErrorDetail, M as LeaderboardApi, I as ImageGenApi, A as AudioGenApi, V as VideoGenApi, q as SpriteGenApi, T as ThreeDGenApi } from './LeaderboardApi-BJIye4S7.js';
+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';
 
 interface StorageApi {
@@ -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;
     };
 }
@@ -241,10 +243,17 @@ interface ScheduleRCSInput {
     /** Seconds from now; mutually exclusive with triggerAt; max 7 days */
     delaySeconds?: number;
 }
-type ScheduleRCSStatus = 'pending' | 'sent' | 'dry_run' | 'failed';
+/**
+ * `skipped` — nothing was scheduled for a benign reason (e.g. the user is not
+ * RCS-reachable, or an identical message is already scheduled). Distinct from
+ * `failed`, which indicates a hard scheduling error. See `ScheduleRCSResult.reason`.
+ */
+type ScheduleRCSStatus = 'pending' | 'sent' | 'dry_run' | 'skipped' | 'failed';
 interface ScheduleRCSResult {
     scheduleId: string;
     status: ScheduleRCSStatus;
+    /** Why the schedule was skipped. Only set when `status === 'skipped'`. */
+    reason?: string;
     /**
      * Reserved for a future schedule-status API. Not returned by
      * `scheduleRCSAsync` in v1 (rate-cap deferral is handled internally at
@@ -292,14 +301,50 @@ interface RequestRCSOptInResult {
      */
     newlySubscribed: boolean;
 }
+type SubmitMessageChannel = 'local' | 'rcs';
+interface SubmitMessageInput {
+    channels: SubmitMessageChannel[];
+    title?: string;
+    body?: string;
+    templateId?: string;
+    params?: Record<string, string>;
+    collapseKey?: string;
+    ctaUrl?: string;
+    continuationParams?: Record<string, string>;
+    image?: string;
+    triggerAt?: string;
+    delaySeconds?: number;
+    payload?: Record<string, unknown>;
+    notificationId?: string;
+    priority?: number;
+    groupId?: string;
+}
+type SubmitMessageResultChannel = 'local' | 'rcs' | 'inbox';
+interface SubmitMessageChannelResult {
+    channel: SubmitMessageResultChannel;
+    status: 'scheduled' | 'skipped';
+    id?: string;
+    reason?: string;
+}
+interface SubmitMessageResult {
+    messageId: string;
+    results: SubmitMessageChannelResult[];
+}
 interface NotificationsApi {
+    /**
+     * @deprecated Use `submitMessageAsync({ channels: ['local'], ... })` instead.
+     */
     scheduleAsync(title: string, body: string, seconds: number, notificationId?: string, options?: ScheduleNotificationOptions): Promise<string | null>;
     cancelNotification(notificationId: string): Promise<boolean>;
     getAllScheduledLocalNotifications(): Promise<ScheduleLocalNotification[]>;
     isLocalNotificationsEnabled(): Promise<boolean>;
     setLocalNotificationsEnabled(enabled: boolean): Promise<boolean>;
     getRCSAvailableAsync(): Promise<RCSAvailabilityStatus>;
+    /**
+     * @deprecated Use `submitMessageAsync({ channels: ['rcs'], ... })` instead.
+     */
     scheduleRCSAsync(input: ScheduleRCSInput): Promise<ScheduleRCSResult>;
+    submitMessageAsync(input: SubmitMessageInput): Promise<SubmitMessageResult>;
     /**
      * Trigger the platform-owned RCS opt-in modal. The host shows one of the
      * three modal states depending on whether the user has a phone on file and
@@ -896,6 +941,25 @@ type AiChatCompletionStreamChunk = {
     finishReason: string;
     usage: AiChatCompletionData['usage'];
 };
+/**
+ * Request for a templated ("prompt") completion. Games whose textGen config is
+ * `mode: 'templated'` don't send raw `model`/`system`/`messages` — they invoke
+ * a server-authored prompt by id. The server owns the model, the system
+ * prompt, and any `{{var}}` slots; the game contributes only the player's
+ * turn via `input`.
+ */
+interface PromptCompletionRequest {
+    /** Id of a server-authored prompt declared in rundot/textGen.config.json. */
+    promptId: string;
+    /** The player's turn; isolation-wrapped server-side. Text-only in v1. */
+    input?: string;
+}
+/**
+ * Builds the wire object for a templated prompt call explicitly (never
+ * spreads the caller's object) so only the templated-call fields ride the
+ * wire. Shared by every AiApi transport.
+ */
+declare function toPromptWireRequest(request: PromptCompletionRequest): PromptCompletionRequest;
 interface AiChatCompletionStreamOptions {
     /**
      * Caller-supplied AbortSignal. Aborting causes the iterable to stop
@@ -977,6 +1041,53 @@ interface AiApi {
      * is non-empty.
      */
     requestChatCompletionStreamAsync(request: AiChatCompletionRequest, options?: AiChatCompletionStreamOptions): AsyncIterable<AiChatCompletionStreamChunk>;
+    /**
+     * Invoke a server-authored prompt by id (templated textGen mode).
+     *
+     * Unlike `requestChatCompletionAsync`, the game does not choose the model
+     * or author the messages — those live server-side in the prompt declared in
+     * `rundot/textGen.config.json`. The optional `input` carries the player's
+     * turn and is isolation-wrapped server-side; it is text-only in v1.
+     *
+     * There are no client-supplied variables in v1: `{{var}}` slots in the
+     * server-side prompt resolve entirely from a trusted server-side bag, so
+     * the call carries nothing to reconcile or sanitize beyond `input`.
+     *
+     * Note: against a templated game, the open-mode
+     * `requestChatCompletionAsync` is rejected with HTTP 403 and error code
+     * `AI_POLICY_DENIED` — use this method instead.
+     *
+     * @example
+     * ```ts
+     * const response = await textGen.requestPromptCompletionAsync({
+     *   promptId: 'npc-banter',
+     *   input: 'What do you think of the swamp zone?',
+     * })
+     * console.log(response.choices[0].message.content)
+     * ```
+     */
+    requestPromptCompletionAsync(request: PromptCompletionRequest): Promise<AiChatCompletionData>;
+    /**
+     * Streaming sibling of `requestPromptCompletionAsync`. Returns an async
+     * iterable of chunks — the same chunk contract as
+     * `requestChatCompletionStreamAsync` (see its docs for chunk buffering and
+     * cancellation semantics). Cancel by `break`ing out of `for await`, calling
+     * `return()` on the iterator, or aborting the optional `signal`.
+     *
+     * @example
+     * ```ts
+     * const stream = textGen.requestPromptCompletionStreamAsync({
+     *   promptId: 'npc-banter',
+     *   input: 'Tell me a story.',
+     * })
+     * let text = ''
+     * for await (const chunk of stream) {
+     *   if (chunk.type === 'delta') text += chunk.text
+     *   if (chunk.type === 'done') console.log('usage', chunk.usage)
+     * }
+     * ```
+     */
+    requestPromptCompletionStreamAsync(request: PromptCompletionRequest, options?: AiChatCompletionStreamOptions): AsyncIterable<AiChatCompletionStreamChunk>;
 }
 
 type TextGenApi = AiApi;
@@ -1081,6 +1192,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>;
@@ -1092,29 +1208,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. */
@@ -1124,6 +1286,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;
@@ -1697,6 +1860,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). */
@@ -1801,6 +1965,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;
@@ -1808,6 +1983,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';
@@ -1895,6 +2085,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>;
@@ -1904,6 +2118,7 @@ interface IapApi {
     purchaseSubscription(tier: SubscriptionTier, interval: SubscriptionInterval): Promise<PurchaseSubscriptionResponse>;
     isUserSubscribed(tier: SubscriptionTier): Promise<boolean>;
     hasUserMadePurchase(): Promise<boolean>;
+    listDirectPurchaseSkus(gameId: string): Promise<DirectPurchaseSku[]>;
 }
 
 /**
@@ -2664,6 +2879,13 @@ interface ComposeSocialPostOptions {
     title?: string;
     /** Target subreddit (bare name, no `r/` prefix), used only when routed to Reddit. */
     subreddit?: string;
+    /**
+     * OpenGraph metadata for the tracked share link minted from `shareParams`
+     * (same semantics as `shareLinkAsync`). Fields left absent fall back to the
+     * game's values (name/thumbnail). Ignored when `shareParams` is absent — no
+     * link is minted, so there is nothing to attach a preview to.
+     */
+    metadata?: ShareMetadata;
 }
 interface ComposeSocialPostResult {
     /**
@@ -2997,6 +3219,16 @@ type TransformParams = {
     outputKey: string;
     maxDurationSec: number;
     clientRef?: string;
+} | {
+    op: 'overlay';
+    input: string;
+    overlay: string;
+    outputKey: string;
+    position?: 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight';
+    scale?: number;
+    margin?: number;
+    opacity?: number;
+    clientRef?: string;
 } | ArchiveExtractParams;
 interface TransformResult {
     jobId: string;
@@ -4384,6 +4616,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>;
@@ -4593,4 +4830,4 @@ interface AdsApi {
     showInterstitialAd(options?: ShowInterstitialAdOptions): Promise<boolean>;
 }
 
-export { type EnvironmentInfo as $, type AnalyticsApi as A, type BatchRecipeRequirementsResult as B, type NotificationsApi as C, type ScheduleLocalNotification as D, type ScheduleNotificationOptions as E, type RCSAvailabilityStatus as F, type ScheduleRCSInput as G, type Host as H, type ScheduleRCSResult as I, type RequestRCSOptInInput as J, type RequestRCSOptInResult as K, type PopupsApi as L, type ShowToastOptions as M, type NavigationApi as N, type LikeDialogResult as O, type Profile as P, type QuitOptions as Q, type RundotGameAPI as R, type SimulationActiveRunsUpdate as S, type CommentsPanelResult as T, type LikeStateResult as U, type ShowInterstitialAdOptions as V, type ShowRewardedAdOptions as W, type ProfileApi as X, type DeviceApi as Y, type DeviceInfo as Z, type EnvironmentApi as _, type RecipeRequirementQuery as a, type RoomsApi as a$, type SystemApi as a0, type SafeArea as a1, type AddToHomeScreenResult as a2, type CdnApi as a3, type FetchFromCdnOptions as a4, type AssetUrlResult as a5, type TimeApi as a6, type ServerTimeData as a7, type GetFutureTimeOptions as a8, type AiApi as a9, type SimulationApi as aA, type SimulationSlotValidationResult as aB, type SimulationBatchOperation as aC, type SimulationBatchOperationsResult as aD, type SimulationAvailableItem as aE, type SimulationPowerPreview as aF, type SimulationSlotMutationResult as aG, type SimulationSlotContainer as aH, type SimulationAssignment as aI, type SimulationState as aJ, type ExecuteRecipeOptions as aK, type ExecuteRecipeResponse as aL, type CollectRecipeResult as aM, type ResetStateOptions as aN, type ResetStateResult as aO, type GetActiveRunsOptions as aP, type ExecuteScopedRecipeOptions as aQ, type ExecuteScopedRecipeResult as aR, type GetAvailableRecipesOptions as aS, type GetAvailableRecipesResult as aT, type Recipe as aU, type GetBatchRecipeRequirements as aV, type TriggerRecipeChainOptions as aW, type RoomDataUpdate as aX, type RoomMessageEvent as aY, type ProposedMoveEvent as aZ, RundotGameTransport as a_, type AiChatCompletionRequest as aa, type AiChatCompletionData as ab, type AiChatCompletionStreamOptions as ac, type AiChatCompletionStreamChunk as ad, type HapticsApi as ae, HapticFeedbackStyle as af, type GamepadSnapshot as ag, type GamepadConnectionEvent as ah, type Subscription as ai, type GamepadApi as aj, type GamepadLatencyStats as ak, type FeaturesApi as al, type Experiment as am, type LiveOpsApi as an, type LiveOpsConfigResult as ao, type LiveOpsRawConfig as ap, type LiveOpsSection as aq, type LifecycleApi as ar, type SleepCallback as as, type AwakeCallback as at, type PauseCallback as au, type ResumeCallback as av, type QuitCallback as aw, type BackButtonCallback as ax, type IdentityChangedCallback as ay, type IdentityChangedEvent as az, type RecipeRequirementResult as b, type AdminUgcApi as b$, type CreateRoomOptions as b0, type JoinOrCreateRoomOptions as b1, type JoinOrCreateResult as b2, type ListRoomsOptions as b3, type UpdateRoomDataOptions as b4, type RoomMessageRequest as b5, type StartRoomGameOptions as b6, type ProposeMoveRequest as b7, type ProposeMoveResult as b8, type ValidateMoveVerdict as b9, type QRCodeResult as bA, type ShareClickData as bB, type ShareFileOptions as bC, type ShareFileResult as bD, type CanShareFileResult as bE, type ComposeSocialPostOptions as bF, type ComposeSocialPostResult as bG, type EntitlementApi as bH, type Entitlement as bI, type LedgerEntry as bJ, type StatsApi as bK, type GrantInfo as bL, type CollectiblesApi as bM, type CollectibleCard as bN, type VipClaimResult as bO, type ShopApi as bP, type StorefrontResponse as bQ, type StorefrontItem as bR, type ShopPurchaseResponse as bS, type ShopOrderHistoryResponse as bT, type PromptLoginResult as bU, type AccessTier as bV, type AccessGateApi as bW, type TextGenApi as bX, type UgcApi as bY, type VideoApi as bZ, type AppApi as b_, type ValidateMoveResult as ba, type RoomSubscriptionOptions as bb, type LoggingApi as bc, type IapApi as bd, type SpendCurrencyOptions as be, type SpendCurrencyResult as bf, type SubscriptionTier as bg, type RunSubscriptionsResponse as bh, type SubscriptionInterval as bi, type PurchaseSubscriptionResponse as bj, type OpenStoreResult as bk, type LoadEmbeddedAssetsResponse as bl, type SharedAssetsApi as bm, type CreditsApi as bn, type CreditsBillingContext as bo, type CreditBalance as bp, type CreditSubscription as bq, type CreditPlansCatalog as br, type OpenPaywallOptions as bs, type CreditsPurchaseResult as bt, type Unsubscribe as bu, type PreloaderApi as bv, type SocialApi as bw, type ShareMetadata as bx, type ShareLinkResult as by, type SocialQRCodeOptions as bz, type RundotGameAvailableRecipe as c, type AdminUgcEntry as c$, type AdminImageGenApi as c0, type AdminVideoGenApi as c1, type AdminSpriteGenApi as c2, type AdminAudioGenApi as c3, type AdminThreeDGenApi as c4, type AppRole as c5, type ResolveLaunchIntentOptions as c6, type LaunchIntent as c7, type ReleaseNote as c8, type AdminUgcBrowseParams as c9, type InitializationContext as cA, type InitializationOptions as cB, type CaptureConsent as cC, type StartClipRecordingOptions as cD, type ClipBlob as cE, type ClipsSupport as cF, type ClipPersistOptions as cG, type ClipResult as cH, type UgcEntry as cI, type CaptureConsentStatus as cJ, AccessDeniedError as cK, type AdminGenApi as cL, type AdminImageGenBrowseParams as cM, type AdminImageGenBrowseResponse as cN, type AdminImageGenListReportsParams as cO, type AdminImageGenListReportsResponse as cP, type AdminImageGenResolveAction as cQ, type AdminSpriteGenBrowseParams as cR, type AdminSpriteGenBrowseResponse as cS, type AdminSpriteGenListReportsParams as cT, type AdminSpriteGenListReportsResponse as cU, type AdminSpriteGenResolveAction as cV, type AdminThreeDGenBrowseParams as cW, type AdminThreeDGenBrowseResponse as cX, type AdminThreeDGenListReportsParams as cY, type AdminThreeDGenListReportsResponse as cZ, type AdminThreeDGenResolveAction as c_, type AdminUgcBrowseResponse as ca, type AdminUgcListReportsParams as cb, type AdminUgcListReportsResponse as cc, type AdminUgcResolveAction as cd, type AdminGenBrowseParams as ce, type AdminGenBrowseResponse as cf, type ImageGenEntry as cg, type AdminGenListReportsParams as ch, type AdminGenListReportsResponse as ci, type ImageGenReport as cj, type AdminGenResolveAction as ck, type SpriteGenEntry as cl, type SpriteGenReport as cm, type ThreeDGenEntry as cn, type ThreeDGenReport as co, type Avatar3dApi as cp, type AssetManifest as cq, type Avatar3dConfig as cr, type ShowEditorOptions as cs, type Avatar3dEdits as ct, type AdsApi as cu, type RawEnvironmentInfo as cv, type SharedStorageHostApi as cw, type FilesApi as cx, type ClipsApi as cy, type AttributionApi as cz, type RundotGameCollectRecipeResult as d, type RecipeInfo as d$, type AdminVideoGenBrowseParams as d0, type AdminVideoGenBrowseResponse as d1, type AdminVideoGenListReportsParams as d2, type AdminVideoGenListReportsResponse as d3, type AdminVideoGenResolveAction as d4, type AiContentBlock as d5, type AiImageContent as d6, type AiImageUrlContent as d7, type AiMessage as d8, type AiResponseFormat as d9, type GamepadAxes as dA, type GamepadButtonName as dB, type GamepadButtonState as dC, type GamepadSource as dD, type GetSubscriptionsForTierRequest as dE, type HudInsets as dF, type IdentityChangeReason as dG, type InboundForKeyEntry as dH, type InboundMethodIds as dI, type InboundStorageApi as dJ, type IsPlayerSubscribedRequest as dK, type JoinOrCreateRoomEnvelopeResponse as dL, type JoinRoomMatchCriteria as dM, type LaunchIntentKind as dN, type LiveOpsOverride as dO, type LoadEmbeddedAssetsRequest as dP, MockAvatarApi as dQ, type NotificationTriggerInput as dR, type OnNotificationCallback as dS, type OnRequestCallback as dT, type OnResponseCallback as dU, type PlatformCapabilities as dV, type ProposedMovePayload as dW, type PurchaseSubscriptionRequest as dX, type RCSAvailabilityReason as dY, type RCSOptInStatus as dZ, ROOM_GAME_PHASES as d_, type AiTextContent as da, type AiToolResultContent as db, type AiToolUseContent as dc, type Asset as dd, type AudioGenEntry as de, type AudioGenReport as df, CLIP_CONTENT_TYPE as dg, COMPOSE_POST_MAX_TEXT_LENGTH as dh, COMPOSE_POST_MAX_TITLE_LENGTH as di, COMPOSE_POST_SUBREDDIT_PATTERN as dj, CREDITS_EXHAUSTED_CODE as dk, type Category as dl, type ClipAudioOptions as dm, type ClipCameraOptions as dn, type ClipPipLayout as dp, type ClipPipPosition as dq, type ComposeSocialPostMedia as dr, type CreditFreeDailyInfo as ds, type CreditPlan as dt, type CreditTopUpPack as du, type CreditsBilledTo as dv, CreditsExhaustedError as dw, type CreditsExhaustedErrorInfo as dx, type CreditsPurchaseOutcome as dy, GAMEPAD_BUTTON_NAMES as dz, type RundotGameExecuteRecipeOptions as e, type ReleaseType as e0, type ResolvedLiveOps as e1, type RoomEnvelopeResponse as e2, type RoomGamePhase as e3, type RoomMessageEventType as e4, type RoomMessagePayload as e5, type RoomsEnvelopeResponse as e6, RpcInboundStorageApi as e7, RpcSharedAssetsApi as e8, type RpcTransport as e9, type UgcReport as eA, type VideoGenEntry as eB, type VideoGenReport as eC, asCreditsExhaustedError as eD, assertTierSupportsInterval as eE, createHost as eF, isCreditsExhaustedError as eG, mapCreditsExhaustion as eH, resolveCollectionItemPrice as eI, resolveLiveOpsSection as eJ, type RunSubscription as ea, type RundotGameRoomCustomMetadata as eb, type RundotGameRoomPayload as ec, type RundotGameRoomRules as ed, type RundotGameRoomRulesGameState as ee, SHARE_FILE_ALLOWED_MIME_TYPES as ef, SHARE_FILE_MAX_SIZE_BYTES as eg, SOCIAL_COMPOSE_PLATFORMS as eh, type ScheduleRCSStatus as ei, type ShareFileMimeType as ej, type ShopOrder as ek, type SimulationBatchOperationAssign as el, type SimulationBatchOperationRemove as em, type SimulationBatchOperationResult as en, type SimulationPersonalState as eo, type SimulationRoomActiveRecipe as ep, type SimulationRoomState as eq, type SocialComposePlatform as er, type StorefrontCollection as es, type StorefrontCollectionItem as et, type SubPath as eu, TIER_SUPPORTED_INTERVALS as ev, type Tool as ew, type ToolChoice as ex, type ToolUse as ey, type TimeIntervalTriggerInput 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 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 };

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

@@ -1,4 +1,4 @@
-import { h as ReplayFile } from './types-BXxDmID0.js';
+import { h as ReplayFile } from './types-BV8uchSD.js';
 
 type ImageGenModel = 'gemini-3.1-flash-image-preview' | 'gemini-3-pro-image-preview' | 'gpt-image-1' | 'gpt-image-2';
 type BgRemovalModel = 'bria' | 'birefnet';
@@ -450,6 +450,10 @@ interface AnimateSpriteParams {
     sourceFileKey?: string;
     /** Or: an HTTPS URL to import and animate. */
     sourceImageUrl?: string;
+    /** Override source-derived animation mode. Omit to infer from the source asset. */
+    pixel?: boolean;
+    /** Pixel-animation palette size. The animation provider does not accept a fixed hex palette. */
+    paletteSize?: number;
     /** Motion description, e.g. "walk cycle, side view" or "idle breathing". */
     prompt: string;
     /** Frame count. Pixel: 2-16 (even), HD: 2-24 (even). Default 8. */

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

@@ -1,4 +1,5 @@
-import { C as CanonicalValue, h as ReplayFile, O as OfflineSession } from './types-BXxDmID0.js';
+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';
 
 /**
@@ -20,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[];
+    /** Immutable authority-owned consequences applied immediately before this tick's simulation step. */
+    readonly commands?: readonly CanonicalValue[];
     readonly checksum: string;
 }
 interface InputAuthorityConfig {
@@ -63,6 +66,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;
+    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 +176,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 +290,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 +341,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. */
@@ -273,6 +383,7 @@ interface NetworkedSyncplayClient {
     readonly rollbacks: number;
     /** 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. */
@@ -376,4 +487,4 @@ declare function quickMatchSyncplayRoom(api: MultiplayerApi, criteria?: Record<s
  */
 declare function createSyncplayRoom(api: MultiplayerApi): 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 { 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 };