@my-swu/simulator-client 0.1.3 → 0.1.5

package/dist/generated/types/admin-match-debug-bundle.d.ts

@@ -1 +1 @@
-export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AdminMatchDebugBundle, AdminMatchSummary, AiDifficulty, AiOpponentConfig, AiTrilogyFormatMode, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardDrawSource, CardInstanceView, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckPlacement, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ExploitOptionsView, FormatSeatView, FormatSetupInput, GameEvent, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, HistorySection, HistoryStatus, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchEndReason, MatchFormat, MatchHistoryDeckSummary, MatchHistoryPlayerSummary, MatchHistoryReplayArchive, MatchPhase, MatchResult, MatchSavePayload, MatchSaveSeat, MatchSeriesView, MatchStatus, MctsConfigOverride, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, SharedCounterState, SimulatorReportResponse, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TurnPassSource, TwinSunsCounter, TwinSunsCountersView, UndoCancelReason, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitCopiedCardEntry, UnitDefeatCause, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, } from './common.js';
+export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AdminMatchDebugBundle, AdminMatchSummary, AiDecisionDiagnostic, AiDecisionSearchMode, AiDifficulty, AiOpponentConfig, AiTrilogyFormatMode, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardDrawSource, CardInstanceView, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckPlacement, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ExploitOptionsView, FormatSeatView, FormatSetupInput, GameEvent, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, HistorySection, HistoryStatus, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchEndReason, MatchFormat, MatchHistoryDeckSummary, MatchHistoryPlayerSummary, MatchHistoryReplayArchive, MatchPhase, MatchResult, MatchSavePayload, MatchSaveSeat, MatchSeriesView, MatchStatus, MctsConfigOverride, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, SharedCounterState, SimulatorReportResponse, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TurnPassSource, TwinSunsCounter, TwinSunsCountersView, UndoCancelReason, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitCopiedCardEntry, UnitDefeatCause, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, } from './common.js';

package/dist/generated/types/admin-match-replay-response.d.ts

@@ -1 +1 @@
-export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AdminMatchReplayResponse, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardDrawSource, CardInstanceView, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckPlacement, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ExploitOptionsView, FormatSeatView, GameEvent, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchEndReason, MatchFormat, MatchHistoryReplayArchive, MatchPhase, MatchResult, MatchSeriesView, MatchStatus, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, SharedCounterState, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TurnPassSource, TwinSunsCounter, TwinSunsCountersView, UndoCancelReason, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitDefeatCause, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, } from './common.js';
+export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AdminMatchReplayResponse, AiDecisionDiagnostic, AiDecisionSearchMode, AiDifficulty, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardDrawSource, CardInstanceView, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckPlacement, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ExploitOptionsView, FormatSeatView, GameEvent, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchEndReason, MatchFormat, MatchHistoryReplayArchive, MatchPhase, MatchResult, MatchSeriesView, MatchStatus, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, SharedCounterState, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TurnPassSource, TwinSunsCounter, TwinSunsCountersView, UndoCancelReason, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitDefeatCause, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, } from './common.js';

package/dist/generated/types/client-message.d.ts

@@ -1 +1 @@
-export type { AbilityTarget, ActionAbilitySource, AttackTarget, CaptureSelection, CardInteractionCueKind, CardInteractionCueRequest, CardInteractionCueState, CardInteractionDragOffset, ClientMessage, DeckInput, DistributionAssignment, FormatEventCommand, GameCommand, Seat, SmuggleKind, TwinSunsCounter, } from './common.js';
+export type { AbilityTarget, ActionAbilitySource, AttackTarget, CaptureSelection, CardInteractionCueKind, CardInteractionCueRequest, CardInteractionCueState, CardInteractionDragOffset, ClientMessage, DeckInput, DistributionAssignment, FormatEventCommand, GameCommand, PlaygroundCommand, PlaygroundDamageTarget, PlaygroundDefeatTarget, Seat, SmuggleKind, TwinSunsCounter, } from './common.js';

package/dist/generated/types/common.d.ts

@@ -278,6 +278,87 @@ export interface AdminMatchSummary {
     status: HistoryStatus;
     updatedAtMs: number;
 }
+/**
+ * One AI decision's search-budget diagnostics, safe for durable storage.
+ */
+export interface AiDecisionDiagnostic {
+    /**
+     * Pending ability the chosen command answered, when applicable.
+     */
+    abilityId?: (number | null);
+    /**
+     * Privacy-safe chosen-command shape: snake_case command kind only.
+     */
+    commandKind: string;
+    difficulty: AiDifficulty;
+    elapsedMs: number;
+    /**
+     * Engine event counter of the searched state; exact cross-check key.
+     */
+    eventsApplied: number;
+    /**
+     * Index of the replay frame this decision was made on (the state BEFORE
+     * the chosen command applied). `None` when no frame was recorded yet.
+     */
+    frameIndex?: (number | null);
+    /**
+     * Whether the minimum-iteration floor pushed past the wall-clock budget.
+     */
+    hardFloorOverrun: boolean;
+    /**
+     * Idle-stretch ceiling granted for this decision, when one was.
+     */
+    iterationCeiling?: (number | null);
+    iterationsBudget: number;
+    iterationsDone: number;
+    legalCount: number;
+    /**
+     * Minimum-iteration floor the search guarantees past the wall clock.
+     */
+    minIterations: number;
+    /**
+     * Time spent waiting for scheduler admission before the search started.
+     */
+    queueMs: number;
+    /**
+     * Whether the AI scheduler was idle when this decision was admitted.
+     */
+    schedulerIdle: boolean;
+    searchMode: AiDecisionSearchMode;
+    seat: Seat;
+    /**
+     * Gameplay snapshot marker the searched state carried. An undo between
+     * search and record makes this disagree with the frame at `frame_index`.
+     */
+    snapshotRevision: number;
+    /**
+     * Public source card of that pending ability, when applicable.
+     */
+    sourceCardId?: (number | null);
+    /**
+     * The starved-search guard discarded the search result entirely and
+     * answered from a one-ply heuristic ranking instead.
+     */
+    starvationFallback: boolean;
+    /**
+     * Starved search: the wall clock cut the decision at (or below) its
+     * minimum-iteration floor, so the move rests on noise-level visit
+     * counts. Any blunder on a starved decision is explained first by this
+     * flag, not by enumeration or evaluation defects.
+     */
+    starved: boolean;
+    timeBudgetMs?: (number | null);
+    /**
+     * Whether the wall clock cut the search before its iteration budget.
+     */
+    timeLimited: boolean;
+    workersCompleted: number;
+    workersRequested: number;
+}
+/**
+ * Decision algorithm that produced one recorded AI choice.
+ */
+export type AiDecisionSearchMode = ("mcts" | "setupEvaluator" | "fastPath");
 /**
  * Public difficulty presets. Internal tuning (iteration counts, time
  * budgets) lives in `crate::r#match::registry::ai_factory` so it can be
@@ -320,6 +401,7 @@ export interface AiOpponentConfig {
     trilogyFormatMode: AiTrilogyFormatMode;
 }
 export interface AiSeatStatusPayload {
+    difficulty: AiDifficulty;
     paused: boolean;
     seat: Seat;
     trilogyFormatMode: AiTrilogyFormatMode;
@@ -699,6 +781,11 @@ export interface CreateMatchRequest {
      * currently support exactly 2 players.
      */
     playerCount: number;
+    /**
+     * Enables the server-owned scenario Playground runtime. Normal matches
+     * retain the default and never accept Playground mutations.
+     */
+    playground?: boolean;
     /**
      * Optional authored scenario selector for direct Learn match creation.
      */
@@ -719,6 +806,13 @@ export interface CreateMetaWindowRequest {
     startsAtMs?: (number | null);
     title: string;
 }
+/**
+ * Opaque 30-day Playground share capability.
+ */
+export interface CreatePlaygroundShareResponse {
+    expiresAtMs: number;
+    shareToken: string;
+}
 /**
  * Request body for creating one sealed/draft tournament room.
  */
@@ -1410,6 +1504,10 @@ export type FormatSetupInput = ({
     type: "draft";
 });
 export type GameCommand = (("deployLeader" | "takeInitiative" | "pass" | "concede") | {
+    playground: {
+        command: PlaygroundCommand;
+    };
+} | {
     chooseInitiativePlayer: {
         seat: Seat;
     };
@@ -2004,6 +2102,14 @@ export interface GameState {
      */
     playerCount: number;
     players: SeatState[];
+    /**
+     * Whether this snapshot belongs to a server-authorized Playground match.
+     */
+    playground?: boolean;
+    /**
+     * Printed cards supplied by every configured Playground deck.
+     */
+    playgroundDeckCardIds?: number[];
     prompt: PromptState;
     rejectedPlayReasons: RejectedPlayView[];
     result?: (MatchResult | null);
@@ -3258,6 +3364,11 @@ export interface MatchHistoryPlayerSummary {
  * `revealed_frames` is returned only after both completion and ownership checks.
  */
 export interface MatchHistoryReplayArchive {
+    /**
+     * Per-AI-decision search diagnostics (budget, workers, starvation), in
+     * decision order. Additive: older archives decode with an empty list.
+     */
+    aiDecisions?: AiDecisionDiagnostic[];
     /**
      * Events folded into each matching replay frame. Older archives decode
      * without this additive field and remain playable without captions.
@@ -3368,6 +3479,11 @@ export interface MatchSavePayload {
      * Whether AI was manually paused when this snapshot was captured.
      */
     aiPaused: boolean;
+    /**
+     * Exact manually paused AI seats. Empty payloads from older clients use
+     * `ai_paused` as the all-seat compatibility fallback.
+     */
+    aiPausedSeats?: Seat[];
     /**
      * Wire mirror of the [`UnitState::copied_card`] Arcs that the inner
      * state could not embed. Keyed by `unit.instance_id`. Empty when no
@@ -3944,6 +4060,65 @@ export type PlayerPresenceStatus = ("joined" | "disconnected" | "reconnected" |
 export type PlayerTargetPattern = (("SelfPlayer" | "EachPlayer" | "OpponentPlayer" | "ChosenOpponent" | "ChosenPlayer" | "DefendingPlayer" | "RememberedPlayer" | "RememberedUnitController" | "OtherThanRememberedPlayer") | "EachOpponent" | "EachOpponentWhoseBaseDamagedBySourceThisPhase" | "RememberedTargetController" | {
     RelativeToRememberedPlayer: SeatDirection;
 } | "ControllerOfLowerCostRememberedUnit");
+/**
+ * Host-authorized raw scenario mutation for a Playground match.
+ */
+export type PlaygroundCommand = ({
+    card_ids: number[];
+    seat: Seat;
+    type: "setDrawQueue";
+} | {
+    attachedToUnitId?: (number | null);
+    cardId: number;
+    seat: Seat;
+    type: "putCardInPlay";
+} | {
+    attachedToUnitId?: (number | null);
+    cardId: number;
+    seat: Seat;
+    type: "playCardForFree";
+} | {
+    amount: number;
+    target: PlaygroundDamageTarget;
+    type: "setDamage";
+} | {
+    target: PlaygroundDefeatTarget;
+    type: "defeatCard";
+} | {
+    captorUnitId: number;
+    cardId: number;
+    ownerSeat: Seat;
+    type: "captureCard";
+});
+/**
+ * One board target whose damage counter Playground may set exactly.
+ */
+export type PlaygroundDamageTarget = ({
+    seat: Seat;
+    type: "base";
+} | {
+    type: "unit";
+    unit_id: number;
+});
+/**
+ * One in-play card Playground may defeat through normal leave-play handling.
+ */
+export type PlaygroundDefeatTarget = ({
+    type: "unit";
+    unit_id: number;
+} | {
+    type: "upgrade";
+    upgrade_id: number;
+});
+/**
+ * Portable Playground file. `restore_token` is a dedicated capability and
+ * never contains a live match seat token.
+ */
+export interface PlaygroundExportPayload {
+    restoreToken: string;
+    save: MatchSavePayload;
+    version: number;
+}
 /**
  * Asks the limited-event host to prebuild every server-AI deck after the
  * shared pool is complete. Human players may continue constructing decks
@@ -4567,6 +4742,21 @@ export interface SetAiPausedRequest {
      */
     seatToken: string;
 }
+/**
+ * Host-authored AI controller settings for one Playground seat.
+ */
+export interface SetPlaygroundAiSeatRequest {
+    /**
+     * `None` removes the AI controller from this seat.
+     */
+    difficulty: (AiDifficulty | null);
+    /**
+     * Manual per-seat pause state. Ignored when `difficulty` is `None`.
+     */
+    paused: boolean;
+    seat: Seat;
+    seatToken: string;
+}
 /**
  * Request body for allowing or pausing new ranked queue admissions.
  */
@@ -4871,6 +5061,9 @@ export type TargetGroupPurpose = ({
     kind: "attachUpgrade";
 } | {
     kind: "exhaust";
+} | {
+    amount: number;
+    kind: "payToAvoidExhaust";
 } | {
     kind: "ready";
 } | {

package/dist/generated/types/create-playground-share-response.d.ts

@@ -0,0 +1 @@
+export type { CreatePlaygroundShareResponse, } from './common.js';

package/dist/generated/types/create-playground-share-response.js

@@ -0,0 +1,2 @@
+/* eslint-disable */
+export {};

package/dist/generated/types/game-command.d.ts

@@ -1 +1 @@
-export type { AbilityTarget, ActionAbilitySource, AttackTarget, CaptureSelection, DistributionAssignment, GameCommand, Seat, SmuggleKind, TwinSunsCounter, } from './common.js';
+export type { AbilityTarget, ActionAbilitySource, AttackTarget, CaptureSelection, DistributionAssignment, GameCommand, PlaygroundCommand, PlaygroundDamageTarget, PlaygroundDefeatTarget, Seat, SmuggleKind, TwinSunsCounter, } from './common.js';

package/dist/generated/types/match-history-replay-response.d.ts

@@ -1 +1 @@
-export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardDrawSource, CardInstanceView, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckPlacement, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ExploitOptionsView, FormatSeatView, GameEvent, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchEndReason, MatchFormat, MatchHistoryReplayArchive, MatchHistoryReplayResponse, MatchPhase, MatchResult, MatchSeriesView, MatchStatus, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, SharedCounterState, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TurnPassSource, TwinSunsCounter, TwinSunsCountersView, UndoCancelReason, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitDefeatCause, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, } from './common.js';
+export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AiDecisionDiagnostic, AiDecisionSearchMode, AiDifficulty, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardDrawSource, CardInstanceView, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckPlacement, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ExploitOptionsView, FormatSeatView, GameEvent, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchEndReason, MatchFormat, MatchHistoryReplayArchive, MatchHistoryReplayResponse, MatchPhase, MatchResult, MatchSeriesView, MatchStatus, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, SharedCounterState, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TurnPassSource, TwinSunsCounter, TwinSunsCountersView, UndoCancelReason, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitDefeatCause, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, } from './common.js';

package/dist/generated/types/playground-export-payload.d.ts

@@ -0,0 +1 @@
+export type { AiDifficulty, AiOpponentConfig, AiTrilogyFormatMode, ConstructedFormat, DeckInput, FormatSetupInput, MatchSavePayload, MatchSaveSeat, MctsConfigOverride, PlaygroundExportPayload, Seat, UnitCopiedCardEntry, } from './common.js';

package/dist/generated/types/playground-export-payload.js

@@ -0,0 +1,2 @@
+/* eslint-disable */
+export {};

package/dist/generated/types/server-message.d.ts

@@ -1 +1 @@
-export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AiSeatStatusPayload, AiStatusPayload, AiTrilogyFormatMode, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardDrawSource, CardInstanceView, CardInteractionCue, CardInteractionCueKind, CardInteractionCueState, CardInteractionDragOffset, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckPlacement, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ErrorPayload, ExploitOptionsView, FormatSeatView, GameEvent, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchChatMessage, MatchConnectionRole, MatchEndReason, MatchFormat, MatchHistoryFeedEntry, MatchHistoryFeedEntry1, MatchHistorySnapshot, MatchPhase, MatchQuickPhrase, MatchResult, MatchSeriesView, MatchStatus, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerPresenceStatus, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, ServerMessage, SharedCounterState, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TurnPassSource, TwinSunsCounter, TwinSunsCountersView, UndoCancelReason, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitDefeatCause, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, WelcomePayload, } from './common.js';
+export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AiDifficulty, AiSeatStatusPayload, AiStatusPayload, AiTrilogyFormatMode, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardDrawSource, CardInstanceView, CardInteractionCue, CardInteractionCueKind, CardInteractionCueState, CardInteractionDragOffset, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckPlacement, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ErrorPayload, ExploitOptionsView, FormatSeatView, GameEvent, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchChatMessage, MatchConnectionRole, MatchEndReason, MatchFormat, MatchHistoryFeedEntry, MatchHistoryFeedEntry1, MatchHistorySnapshot, MatchPhase, MatchQuickPhrase, MatchResult, MatchSeriesView, MatchStatus, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerPresenceStatus, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, ServerMessage, SharedCounterState, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TurnPassSource, TwinSunsCounter, TwinSunsCountersView, UndoCancelReason, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitDefeatCause, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, WelcomePayload, } from './common.js';

package/dist/generated/types/set-ai-paused-response.d.ts

@@ -1 +1 @@
-export type { AiSeatStatusPayload, AiStatusPayload, AiTrilogyFormatMode, Seat, } from './common.js';
+export type { AiDifficulty, AiSeatStatusPayload, AiStatusPayload, AiTrilogyFormatMode, Seat, } from './common.js';

package/dist/generated/types/set-playground-ai-seat-request.d.ts

@@ -0,0 +1 @@
+export type { AiDifficulty, Seat, SetPlaygroundAiSeatRequest, } from './common.js';

package/dist/generated/types/set-playground-ai-seat-request.js

@@ -0,0 +1,2 @@
+/* eslint-disable */
+export {};

package/dist/generated/types/shared-match-history-replay-response.d.ts

@@ -1 +1 @@
-export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardDrawSource, CardInstanceView, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckPlacement, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ExploitOptionsView, FormatSeatView, GameEvent, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchEndReason, MatchFormat, MatchHistoryReplayArchive, MatchPhase, MatchResult, MatchSeriesView, MatchStatus, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, SharedCounterState, SharedMatchHistoryReplayResponse, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TurnPassSource, TwinSunsCounter, TwinSunsCountersView, UndoCancelReason, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitDefeatCause, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, } from './common.js';
+export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AiDecisionDiagnostic, AiDecisionSearchMode, AiDifficulty, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardDrawSource, CardInstanceView, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckPlacement, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ExploitOptionsView, FormatSeatView, GameEvent, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchEndReason, MatchFormat, MatchHistoryReplayArchive, MatchPhase, MatchResult, MatchSeriesView, MatchStatus, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, SharedCounterState, SharedMatchHistoryReplayResponse, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TurnPassSource, TwinSunsCounter, TwinSunsCountersView, UndoCancelReason, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitDefeatCause, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, } from './common.js';

package/dist/generated/types/welcome-payload.d.ts

@@ -1 +1 @@
-export type { AiSeatStatusPayload, AiStatusPayload, AiTrilogyFormatMode, MatchConnectionRole, Seat, WelcomePayload, } from './common.js';
+export type { AiDifficulty, AiSeatStatusPayload, AiStatusPayload, AiTrilogyFormatMode, MatchConnectionRole, Seat, WelcomePayload, } from './common.js';

package/dist/generated/version.d.ts

@@ -13,4 +13,4 @@
  *
  * @see https://simulator-sdk.my-swu.com/guide/versioning
  */
-export declare const schemaVersion: "e4a6c8c3043fdb5779d215ad8f673458da5a45bd6d196f0dbd5cc721aa189045";
+export declare const schemaVersion: "0ae978dcaa4b3cbec5778eb3174a0126f642b3d441a76d97dc48044416d4ae06";

package/dist/generated/version.js

@@ -13,4 +13,4 @@
  *
  * @see https://simulator-sdk.my-swu.com/guide/versioning
  */
-export const schemaVersion = "e4a6c8c3043fdb5779d215ad8f673458da5a45bd6d196f0dbd5cc721aa189045";
+export const schemaVersion = "0ae978dcaa4b3cbec5778eb3174a0126f642b3d441a76d97dc48044416d4ae06";

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export { canDeployAnyLeader, flattenTargetGroups, getDeployableLeaderIndices, ge
 export type { TargetingActionView } from './actionable.js';
 export type { SimulatorClient, SimulatorClientOptions } from './client.js';
 export type { AbandonMatchRequest, AbandonMatchResponse, ApiErrorResponse, AiStatusPayload, CardsResponse, CardCatalogRefreshResponse, ClientMessage, CreateLimitedEventRequest, CreateMetaWindowRequest, CreateMatchRequest, ErrorPayload, FormatEventResponse, FormatEventRequest, GameCommand, GameEvent, GameState, GetMatchResponse, HealthResponse, JoinLimitedEventRequest, JoinMatchRequest, LeaveMatchRequest, LeaveMatchResponse, LimitedEventAccessResponse, LimitedEventCommandRequest, LimitedEventPreflightResponse, LimitedEventResponse, ListActiveAiMatchesRequest, ListActiveAiMatchesResponse, MatchAccessResponse, MatchChatLookupResponse, MatchConnectionRole, MatchHistoryDeckStatsRequest, MatchHistoryDeckStatsResponse, MatchHistoryListRequest, MatchHistoryListResponse, MatchHistoryReplayRequest, MatchHistoryReplayResponse, MatchHistoryRestoreRequest, MatchRecoveryRequest, MatchRecoveryResponse, RestoreHistoryResponse, MatchSavePayload, MatchSpectatorAccessResponse, MetaWindow, MetaWindowsResponse, ResolveCardIdsRequest, ResolveCardIdsResponse, RankedAdminStatus, RankedLeaderboardEntry, RankedLeaderboardQuery, RankedLeaderboardResponse, RankedMatchmakingView, RankedProfileRequest, RankedProfileResponse, RankedQueue, RematchMatchRequest, RematchMatchResponse, RestoreMatchSaveRequest, RestoreMatchSaveResponse, SaveMatchRequest, ServerMessage, SetAiPausedRequest, SetRankedAdmissionRequest, SetSimulatorMaintenanceRequest, SimulatorAdminStatusResponse, SimulatorAvailabilityResponse, SpectateMatchRequest, SubmitMatchDeckRequest, SubmitMatchDeckResponse, UndoMatchRequest, UndoMatchResponse, UndoRespondMatchRequest, WelcomePayload, } from './generated/index.js';
+export type { PlaygroundCommand, PlaygroundDamageTarget, PlaygroundDefeatTarget, } from './generated/types/game-command.js';
 export type { UndoCancelReason } from './generated/types/game-event.js';
 export type { LimitedSideboardPoolView } from './generated/types/game-state.js';
 export type { HistoryIdentityInput, HistorySection, HistoryStatus, } from './generated/types/match-history-list-request.js';

package/dist/match-session/controller.d.ts

@@ -37,6 +37,7 @@ export declare class MatchSessionController implements MatchSession {
     get errorMessages(): readonly string[];
     get matchId(): string | undefined;
     get reconnectState(): MatchSessionReconnectState;
+    get snapshotRevision(): number;
     get snapshot(): GameState | undefined;
     get seat(): MatchSeat | undefined;
     get state(): MatchSessionState;

package/dist/match-session/controller.js

@@ -92,6 +92,9 @@ export class MatchSessionController {
     get reconnectState() {
         return this.#reconnectState;
     }
+    get snapshotRevision() {
+        return this.#connection?.snapshotRevision ?? 0;
+    }
     get snapshot() {
         return this.#snapshot;
     }

package/dist/match-session/types.d.ts

@@ -45,6 +45,8 @@ export interface MatchSession extends MatchSessionMethods {
     readonly matchId: string | undefined;
     /** Automatic reconnect progress after an abnormal socket close. */
     readonly reconnectState: MatchSessionReconnectState;
+    /** Monotonic revision of the latest authoritative match snapshot. */
+    readonly snapshotRevision: number;
     /** Latest authoritative private snapshot for this seat. */
     readonly snapshot: GameState | undefined;
     /** Seat controlled by this session when known. */

package/dist/resources/admin.d.ts

@@ -1,4 +1,4 @@
-import type { AdminMatchDebugBundle, AdminMatchListResponse, AdminMatchReplayResponse, SimulatorReportListResponse, SimulatorReportResponse, CardCatalogRefreshResponse, CreateMetaWindowRequest, MatchChatLookupResponse, MetaWindowsResponse, RankedLeaderboardQuery, RankedLeaderboardResponse, RankedProfileRequest, RankedProfileResponse, SetRankedAdmissionRequest, SetSimulatorMaintenanceRequest, SimulatorAdminStatusResponse } from '../generated/index.js';
+import type { AdminMatchDebugBundle, AdminMatchListResponse, AdminMatchReplayResponse, CreateMatchHistoryReplayShareResponse, SimulatorReportListResponse, SimulatorReportResponse, CardCatalogRefreshResponse, CreateMetaWindowRequest, MatchChatLookupResponse, MetaWindowsResponse, RankedLeaderboardQuery, RankedLeaderboardResponse, RankedProfileRequest, RankedProfileResponse, SetRankedAdmissionRequest, SetSimulatorMaintenanceRequest, SimulatorAdminStatusResponse } from '../generated/index.js';
 import type { SimulatorRequestOptions } from '../http/options.js';
 import type { EngineHttpRequester } from '../http/request.js';
 /**
@@ -36,6 +36,8 @@ export interface AdminResource {
     getGameDebugBundle(auth: SimulatorAdminAuth, historyId: string, options?: SimulatorRequestOptions): Promise<AdminMatchDebugBundle>;
     /** Returns a completed replay archive for one match. */
     getGameReplay(auth: SimulatorAdminAuth, historyId: string, options?: SimulatorRequestOptions): Promise<AdminMatchReplayResponse>;
+    /** Creates or returns the hidden-information replay capability for one completed game. */
+    createGameReplayShare(auth: SimulatorAdminAuth, historyId: string, options?: SimulatorRequestOptions): Promise<CreateMatchHistoryReplayShareResponse>;
     /** Lists safe metadata for retained simulator diagnostic reports. */
     listSimulatorReports(auth: SimulatorAdminAuth, query?: SimulatorReportListOptions, options?: SimulatorRequestOptions): Promise<SimulatorReportListResponse>;
     /** Returns one full sanitized simulator support bundle. */

package/dist/resources/admin.js

@@ -7,6 +7,7 @@ export function createAdminResource(requester) {
         listGames: (auth, query, options) => requester.request('admin-match-list-response', adminGamesPath(query ?? {}), { headers: authHeaders(auth) }, options),
         getGameDebugBundle: (auth, historyId, options) => requester.request('admin-match-debug-bundle', `/api/admin/games/${encodeURIComponent(historyId)}/debug`, { headers: authHeaders(auth) }, options),
         getGameReplay: (auth, historyId, options) => requester.request('admin-match-replay-response', `/api/admin/games/${encodeURIComponent(historyId)}/replay`, { headers: authHeaders(auth) }, options),
+        createGameReplayShare: (auth, historyId, options) => requester.request('create-match-history-replay-share-response', `/api/admin/games/${encodeURIComponent(historyId)}/replay-shares`, { headers: authHeaders(auth), method: 'POST' }, options),
         listSimulatorReports: (auth, query, options) => requester.request('simulator-report-list-response', simulatorReportsPath(query ?? {}), { headers: authHeaders(auth) }, options),
         getSimulatorReport: (auth, reportId, options) => requester.request('simulator-report-response', `/api/admin/reports/${encodeURIComponent(reportId)}`, { headers: authHeaders(auth) }, options),
         refreshCardCatalog: (auth, options) => requester.request('card-catalog-refresh-response', '/api/admin/card-catalog/refresh', { headers: authHeaders(auth), method: 'POST' }, options),

package/dist/resources/match-types.d.ts

@@ -1,4 +1,4 @@
-import type { AiStatusPayload, CreateMatchRequest, GameState, JoinMatchRequest, ListActiveAiMatchesRequest, ListActiveAiMatchesResponse, MatchAccessRecoveryRequest, MatchAccessRecoveryResponse, MatchAccessResponse, MatchSpectatorAccessResponse, MatchSavePayload, RematchMatchResponse, RestoreMatchSaveResponse, SpectateMatchRequest, SubmitMatchDeckRequest } from '../generated/index.js';
+import type { AiStatusPayload, CreatePlaygroundShareResponse, CreateMatchRequest, GameState, JoinMatchRequest, ListActiveAiMatchesRequest, ListActiveAiMatchesResponse, MatchAccessRecoveryRequest, MatchAccessRecoveryResponse, MatchAccessResponse, MatchSpectatorAccessResponse, MatchSavePayload, PlaygroundExportPayload, RematchMatchResponse, RestoreMatchSaveResponse, SetPlaygroundAiSeatRequest, SpectateMatchRequest, SubmitMatchDeckRequest } from '../generated/index.js';
 import type { FormatEventCommand } from '../generated/types/format-event-request.js';
 import type { SimulatorRequestOptions } from '../http/options.js';
 /**
@@ -402,6 +402,16 @@ export interface MatchesResource {
      * @see https://simulator-sdk.my-swu.com/guide/driving-gameplay
      */
     setAiPaused(access: MatchAccessInput, paused: boolean, options?: SimulatorRequestOptions): Promise<AiStatusPayload>;
+    /** Attaches, updates, pauses, or removes one AI controller in a Playground. */
+    setPlaygroundAiSeat(access: MatchAccessInput, request: Omit<SetPlaygroundAiSeatRequest, 'seatToken'>, options?: SimulatorRequestOptions): Promise<AiStatusPayload>;
+    /** Creates a portable Playground file with a dedicated restore capability. */
+    exportPlayground(access: MatchAccessInput, options?: SimulatorRequestOptions): Promise<PlaygroundExportPayload>;
+    /** Restores a portable Playground file without source-match credentials. */
+    restorePlaygroundExport(payload: PlaygroundExportPayload, options?: SimulatorRequestOptions): Promise<RestoreMatchSaveResponse>;
+    /** Creates one 30-day URL share capability for a Playground. */
+    createPlaygroundShare(access: MatchAccessInput, options?: SimulatorRequestOptions): Promise<CreatePlaygroundShareResponse>;
+    /** Restores one unexpired Playground URL share into a fresh match. */
+    restorePlaygroundShare(shareToken: string, options?: SimulatorRequestOptions): Promise<RestoreMatchSaveResponse>;
     /**
      * Captures a full state snapshot of an authorized, finished match.
      *

package/dist/resources/matches.js

@@ -96,6 +96,38 @@ export function createMatchesResource(options) {
             headers: jsonHeaders(),
             method: 'POST',
         }, options),
+        setPlaygroundAiSeat: (access, request, options) => requester.request('set-ai-paused-response', `/api/matches/${matchIdFrom(access)}/playground/ai`, {
+            body: jsonBody(requester.validate('set-playground-ai-seat-request', {
+                ...request,
+                seatToken: access.seatToken,
+            })),
+            headers: jsonHeaders(),
+            method: 'POST',
+        }, options),
+        exportPlayground: (access, options) => requester.request('playground-export-payload', `/api/matches/${matchIdFrom(access)}/playground/export`, {
+            body: jsonBody(requester.validate('save-match-request', { seatToken: access.seatToken })),
+            headers: jsonHeaders(),
+            method: 'POST',
+        }, options),
+        restorePlaygroundExport: (payload, options) => {
+            const validated = validatePlaygroundExport(requester.validate('playground-export-payload', payload));
+            return requester.request('restore-match-save-response', '/api/matches/restore', {
+                body: jsonBody(requester.validate('restore-match-save-request', {
+                    save: validated.save,
+                    seatToken: validated.restoreToken,
+                })),
+                headers: jsonHeaders(),
+                method: 'POST',
+            }, options);
+        },
+        createPlaygroundShare: (access, options) => requester.request('create-playground-share-response', `/api/matches/${matchIdFrom(access)}/playground-shares`, {
+            body: jsonBody(requester.validate('save-match-request', { seatToken: access.seatToken })),
+            headers: jsonHeaders(),
+            method: 'POST',
+        }, options),
+        restorePlaygroundShare: (shareToken, options) => requester.request('restore-match-save-response', `/api/playground-shares/${encodeURIComponent(shareToken)}/restore`, {
+            method: 'POST',
+        }, options),
         save: (access, options) => requester.request('match-save-payload', `/api/matches/${matchIdFrom(access)}/save`, {
             body: jsonBody(requester.validate('save-match-request', { seatToken: access.seatToken })),
             headers: jsonHeaders(),
@@ -111,6 +143,23 @@ export function createMatchesResource(options) {
         }, options),
     };
 }
+/** Enforces portable Playground markers even when optional SDK validation is disabled. */
+function validatePlaygroundExport(payload) {
+    if (!payload || typeof payload !== 'object')
+        throw new TypeError('Playground export must be an object');
+    const candidate = payload;
+    if (candidate.version !== 1)
+        throw new TypeError('Playground export version is not supported');
+    if (typeof candidate.restoreToken !== 'string' || !candidate.restoreToken)
+        throw new TypeError('Playground export restore capability is missing');
+    const save = candidate.save;
+    if (!save || typeof save !== 'object')
+        throw new TypeError('Playground export save is missing');
+    const state = save.state;
+    if (!state || typeof state !== 'object' || state.playground !== true)
+        throw new TypeError('Playground export does not contain a Playground match');
+    return payload;
+}
 /**
  * Reads a match id from either a public id string or match reference object.
  */

package/dist/validators.d.ts

@@ -1,4 +1,4 @@
-import type { AdminMatchDebugBundle, AdminMatchListResponse, AdminMatchReplayResponse, SimulatorReportListResponse, SimulatorReportResponse, CloseTournamentRoomRequest, AbandonMatchRequest, AbandonMatchResponse, AddLobbyAiPlayerRequest, ApiErrorResponse, CardCatalogRefreshResponse, CardsResponse, ClientMessage, CreateMatchHistoryReplayShareRequest, CreateMatchHistoryReplayShareResponse, CreateLimitedEventRequest, CreateLobbyRequest, CreateMetaWindowRequest, CreateMatchRequest, CreateTournamentRoomRequest, CreateTournamentTableRequest, ErrorPayload, FormatEventRequest, FormatEventResponse, GameCommand, GameEvent, GameState, GetMatchResponse, HealthResponse, JoinLimitedEventRequest, JoinLobbyRequest, JoinMatchRequest, JoinTournamentRoomRequest, JoinTournamentTableRequest, KickLobbyPlayerRequest, KickLobbySpectatorRequest, LeaveLobbyRequest, LeaveMatchRequest, LeaveMatchResponse, LeaveTournamentRoomRequest, LimitedEventAccessResponse, LimitedEventCommandRequest, LimitedEventPreflightResponse, LimitedEventResponse, LobbyAccessResponse, LobbyChatRequest, LobbyChatResponse, LobbyListResponse, LobbyListServerMessage, LobbyMatchmakingDecisionRequest, PrepareLobbyLimitedAiDecksRequest, LobbyResponse, LobbyServerMessage, LobbySyncRequest, ListActiveAiMatchesRequest, ListActiveAiMatchesResponse, MatchAccessRecoveryRequest, MatchAccessRecoveryResponse, MatchAccessResponse, MatchChatLookupResponse, MatchConnectionRole, MatchHistoryDeckStatsRequest, MatchHistoryDeckStatsResponse, MatchHistoryEntry, MatchHistoryListRequest, MatchHistoryListResponse, MatchHistoryReplayRequest, MatchHistoryReplayResponse, MatchHistoryRestoreRequest, MatchRecoveryRequest, MatchRecoveryResponse, RestoreHistoryResponse, MatchSavePayload, MatchSpectatorAccessResponse, MetaWindow, MetaWindowsResponse, LobbyMatchmakingRequest, ResolveCardIdsRequest, ResolveCardIdsResponse, RankedAdminStatus, RankedLeaderboardEntry, RankedLeaderboardQuery, RankedLeaderboardResponse, RankedMatchmakingView, RankedProfileRequest, RankedProfileResponse, RankedQueue, RematchMatchRequest, RematchMatchResponse, SaveMatchRequest, ReturnLobbyMatchRequest, ReturnTournamentMatchRequest, RestoreMatchSaveRequest, RestoreMatchSaveResponse, ServerMessage, AiStatusPayload, SetRankedAdmissionRequest, SetSimulatorMaintenanceRequest, SetAiPausedRequest, SharedMatchHistoryReplayResponse, SimulatorAdminStatusResponse, SimulatorAvailabilityResponse, SpectateLobbyRequest, SpectateMatchRequest, StartLobbyLimitedMatchRequest, StartLobbyRequest, StartTournamentEventRequest, SubmitLobbyLimitedDeckRequest, SubmitMatchDeckRequest, SubmitMatchDeckResponse, SubmitTournamentDeckRequest, TournamentEventCommandRequest, TournamentRoomAccessResponse, TournamentRoomChatRequest, TournamentRoomChatResponse, TournamentRoomListResponse, TournamentRoomResponse, TournamentRoomServerMessage, TournamentRoomSyncRequest, UndoMatchRequest, UndoMatchResponse, UndoRespondMatchRequest, UpdateLobbyAiPlayerRequest, UpdateLobbyPlayerRequest, UpdateLobbySettingsRequest, UpdateTournamentRoomPlayerRequest, UpdateTournamentRoomSettingsRequest, WelcomePayload } from './generated/index.js';
+import type { AdminMatchDebugBundle, AdminMatchListResponse, AdminMatchReplayResponse, SimulatorReportListResponse, SimulatorReportResponse, CloseTournamentRoomRequest, AbandonMatchRequest, AbandonMatchResponse, AddLobbyAiPlayerRequest, ApiErrorResponse, CardCatalogRefreshResponse, CardsResponse, ClientMessage, CreateMatchHistoryReplayShareRequest, CreateMatchHistoryReplayShareResponse, CreateLimitedEventRequest, CreateLobbyRequest, CreateMetaWindowRequest, CreateMatchRequest, CreatePlaygroundShareResponse, CreateTournamentRoomRequest, CreateTournamentTableRequest, ErrorPayload, FormatEventRequest, FormatEventResponse, GameCommand, GameEvent, GameState, GetMatchResponse, HealthResponse, JoinLimitedEventRequest, JoinLobbyRequest, JoinMatchRequest, JoinTournamentRoomRequest, JoinTournamentTableRequest, KickLobbyPlayerRequest, KickLobbySpectatorRequest, LeaveLobbyRequest, LeaveMatchRequest, LeaveMatchResponse, LeaveTournamentRoomRequest, LimitedEventAccessResponse, LimitedEventCommandRequest, LimitedEventPreflightResponse, LimitedEventResponse, LobbyAccessResponse, LobbyChatRequest, LobbyChatResponse, LobbyListResponse, LobbyListServerMessage, LobbyMatchmakingDecisionRequest, PrepareLobbyLimitedAiDecksRequest, LobbyResponse, LobbyServerMessage, LobbySyncRequest, ListActiveAiMatchesRequest, ListActiveAiMatchesResponse, MatchAccessRecoveryRequest, MatchAccessRecoveryResponse, MatchAccessResponse, MatchChatLookupResponse, MatchConnectionRole, MatchHistoryDeckStatsRequest, MatchHistoryDeckStatsResponse, MatchHistoryEntry, MatchHistoryListRequest, MatchHistoryListResponse, MatchHistoryReplayRequest, MatchHistoryReplayResponse, MatchHistoryRestoreRequest, MatchRecoveryRequest, MatchRecoveryResponse, RestoreHistoryResponse, MatchSavePayload, PlaygroundExportPayload, MatchSpectatorAccessResponse, MetaWindow, MetaWindowsResponse, LobbyMatchmakingRequest, ResolveCardIdsRequest, ResolveCardIdsResponse, RankedAdminStatus, RankedLeaderboardEntry, RankedLeaderboardQuery, RankedLeaderboardResponse, RankedMatchmakingView, RankedProfileRequest, RankedProfileResponse, RankedQueue, RematchMatchRequest, RematchMatchResponse, SaveMatchRequest, ReturnLobbyMatchRequest, ReturnTournamentMatchRequest, RestoreMatchSaveRequest, RestoreMatchSaveResponse, ServerMessage, AiStatusPayload, SetRankedAdmissionRequest, SetSimulatorMaintenanceRequest, SetAiPausedRequest, SetPlaygroundAiSeatRequest, SharedMatchHistoryReplayResponse, SimulatorAdminStatusResponse, SimulatorAvailabilityResponse, SpectateLobbyRequest, SpectateMatchRequest, StartLobbyLimitedMatchRequest, StartLobbyRequest, StartTournamentEventRequest, SubmitLobbyLimitedDeckRequest, SubmitMatchDeckRequest, SubmitMatchDeckResponse, SubmitTournamentDeckRequest, TournamentEventCommandRequest, TournamentRoomAccessResponse, TournamentRoomChatRequest, TournamentRoomChatResponse, TournamentRoomListResponse, TournamentRoomResponse, TournamentRoomServerMessage, TournamentRoomSyncRequest, UndoMatchRequest, UndoMatchResponse, UndoRespondMatchRequest, UpdateLobbyAiPlayerRequest, UpdateLobbyPlayerRequest, UpdateLobbySettingsRequest, UpdateTournamentRoomPlayerRequest, UpdateTournamentRoomSettingsRequest, WelcomePayload } from './generated/index.js';
 import type { SchemaValidator } from './validators/validator.js';
 /**
  * Exact schema-to-type map generated from Rust public wire contracts.
@@ -106,6 +106,9 @@ export interface SchemaTypeMap {
     'server-message': ServerMessage;
     'set-ai-paused-request': SetAiPausedRequest;
     'set-ai-paused-response': AiStatusPayload;
+    'set-playground-ai-seat-request': SetPlaygroundAiSeatRequest;
+    'playground-export-payload': PlaygroundExportPayload;
+    'create-playground-share-response': CreatePlaygroundShareResponse;
     'set-ranked-admission-request': SetRankedAdmissionRequest;
     'set-simulator-maintenance-request': SetSimulatorMaintenanceRequest;
     'simulator-admin-status-response': SimulatorAdminStatusResponse;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@my-swu/simulator-client",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Typed TypeScript client for the swu-simulator HTTP and WebSocket engine.",
   "keywords": [
     "swu",