@my-swu/simulator-client 0.1.5 → 0.1.7

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

@@ -29,6 +29,16 @@ export type AbilityTarget = ({
 } | {
     seat: Seat;
     type: "leader";
+} | {
+    /**
+     * Zero-based position in that player's leader list.
+     */
+    leaderIndex: number;
+    /**
+     * Player who owns the leader slot.
+     */
+    seat: Seat;
+    type: "leaderByIndex";
 } | {
     seat: Seat;
     type: "base";
@@ -39,9 +49,18 @@ export type AbilityTarget = ({
 /**
  * Trigger window for a parsed ability. Identifies WHEN the ability
  * fires; the WHAT is carried by `TriggeredEffect`.
+ *
+ * This type is on the public SDK schema — it reaches `GameState` through
+ * `PendingAbilityView.window` and `GameEvent` — but only ever server to
+ * client: no `GameCommand` carries one, so a consumer reads it and never
+ * constructs it. The two variants that carry a [`crate::effect::UnitFilter`]
+ * are therefore exported opaquely, the way `MatchSavePayload::state` is: the
+ * variant discriminant stays on the wire so a UI can still switch on the
+ * window, while the engine filter behind it does not pin ~60 internal fields
+ * and their whole reference closure into the SDK type surface.
  */
 export type AbilityWindow = (("AfterPlayOrDeploy" | "WhenActionPhaseStarts" | "WhenFirstActionPhaseStarts" | "WhenYouDrawCardsDuringActionPhase" | "WhenAnOpponentDrawsCardsDuringActionPhase" | "WhenAPlayerDrawsCardsDuringActionPhase" | "WhenYouTakeInitiative" | "WhenYouDeployLeader" | "WhenEntersPlay" | "OnAttack" | "OnDefense" | "WhenFriendlyUnitAttacks" | "WhenThisUnitIsAttacked" | "WhenThisUnitReadies" | "WhenDamageIsDealtToThisUnit" | "WhenCombatDamageIsDealtToThisUnit" | "WhenThisUnitIsHealed" | "WhenDamageIsDealtToYourBase" | "WhenFriendlyUnitDealsDamageToEnemyUnit" | "WhenEnemyUnitAttacks" | "WhenEnemyUnitAttacksYourBase" | "WhenPilotAttachesToThisUnit" | "WhenFriendlyUnitIsDefeated" | "WhenThisUnitDealsCombatDamageToBase" | "WhenThisUnitDealsCombatDamageToUnit" | "WhenFriendlyUnitDealsCombatDamageToBase" | "WhenEnemyUnitDealsCombatDamageToYourBase" | "WhenAttackEnds" | "WhenFriendlyUnitAttackEnds" | "WhenCaptured" | "WhenDefeated" | "WhenEnemyUnitDefeated" | "WhenIndirectDamageDealtToUnit" | "WhenYouDealNonCombatDamage" | "WhenRevealOrDiscardFromHand" | "WhenAPlayerDiscardsFromHand" | "WhenOpponentPlaysCard" | "WhenOpponentPlaysEvent" | "WhenOpponentPlaysSecondCardEachPhase" | "WhenYouUseTheForce" | "WhenRegroupPhaseStarts" | "WhenFriendlyForceUnitAttacks" | "AtStartOfTurn" | "AtEndOfTurn") | "WhenYouDrawCards" | "WhenEnemyUnitReadiesDuringActionPhase" | "WhenFriendlyUnitDealtDamageAndSurvives" | {
-    WhenFriendlyUnitDealtCombatDamageAndSurvives: UnitFilter;
+    WhenFriendlyUnitDealtCombatDamageAndSurvives: unknown;
 } | "WhenEnemyGroundUnitAttacksYourBase" | {
     WhenAnotherFriendlyTraitUnitAttacks: string;
 } | "WhenUpgradeAttachesToThisUnit" | "WhenAnotherFriendlyUnitIsDefeated" | "WhenFriendlyUpgradeIsDefeated" | {
@@ -49,12 +68,18 @@ export type AbilityWindow = (("AfterPlayOrDeploy" | "WhenActionPhaseStarts" | "W
 } | "WhenYouDealDamageToEnemyBase" | {
     WhenFriendlyTraitUnitAttackEnds: string;
 } | "WhenThisUnitWouldBeCaptured" | {
-    WhenUnitDefeated: UnitFilter;
+    WhenUnitDefeated: unknown;
 } | {
     WhenUnitLeavesPlay: RelationFilter;
 } | "WhenYouReadyCardsDuringRegroup" | "WhenFriendlyUnitAttacksAndDefeats" | "WhenFriendlyUnitDefeatedWhileAttacking" | "WhenYouPlayEvent" | "WhenYouPlayAUnit" | "WhenYouPlayOrCreateAUnit" | "WhenFriendlyUnitEntersPlay" | "WhenYouPlayAnotherUnit" | "WhenYouPlayAnUpgrade" | "WhenYouCollectABounty" | "WhenYouDiscardFromDeck");
 export type ActionAbilitySource = ({
     type: "leader";
+} | {
+    /**
+     * Non-primary leader slots start at one; slot zero uses legacy `Leader`.
+     */
+    leaderIndex: number;
+    type: "leaderByIndex";
 } | {
     actionIndex: number;
     type: "leaderUnit";
@@ -73,8 +98,13 @@ export type ActionAbilitySource = ({
 export interface ActionAbilityView {
     creditTokenCounts: number[];
     label: string;
+    modeChoice?: (ModeChoiceView | null);
     source: ActionAbilitySource;
     targetGroups: TargetSelectionGroup[];
+    /**
+     * Exact public Action or Epic Action declaration when migrated.
+     */
+    text?: (EffectTextRefsView | null);
 }
 /**
  * Admission scope that blocked creation of an AI-backed match.
@@ -222,6 +252,12 @@ export interface ActiveEffectView {
     inactive?: boolean;
     source?: (EffectSourceView | null);
     targets: EffectTargetView[];
+    /**
+     * Reviewed card-text and shared-message provenance when this public row
+     * was created by a resolving instruction. Absence means this registry
+     * does not retain a display declaration, never that text was inferred.
+     */
+    text?: (EffectTextRefsView | null);
 }
 export interface AddLobbyAiPlayerRequest {
     /**
@@ -265,6 +301,10 @@ export interface AdminMatchReplayResponse {
  * Compact durable match data safe for an administrator list view.
  */
 export interface AdminMatchSummary {
+    /**
+     * Feedback collected for individual completed AI games in this match.
+     */
+    aiFeedback: AiGameFeedback[];
     completedAtMs?: (number | null);
     createdAtMs: number;
     format: MatchFormat;
@@ -365,6 +405,19 @@ export type AiDecisionSearchMode = ("mcts" | "setupEvaluator" | "fastPath");
  * adjusted without changing the SDK surface.
  */
 export type AiDifficulty = ("easy" | "medium" | "hard" | "unfair");
+/**
+ * One immutable player assessment of an AI opponent for a completed game.
+ */
+export interface AiGameFeedback {
+    comments?: (string | null);
+    gameNumber: number;
+    rating: AiGameFeedbackRating;
+    submittedAtMs: number;
+}
+/**
+ * Rating submitted by a player after completing one Solo-versus-AI game.
+ */
+export type AiGameFeedbackRating = ("poorly" | "okay" | "good");
 /**
  * Explicit AI seat configuration.
  */
@@ -578,6 +631,20 @@ export interface CardReferenceMatchView {
     cardType: CardType;
     title: string;
 }
+export interface CardTextRef {
+    /**
+     * Canonical card identity that owns this reviewed printed slot.
+     */
+    cardId: number;
+    /**
+     * Full semantic-contract fingerprint pinning this reference to reviewed text.
+     */
+    contractFingerprint: string;
+    /**
+     * Durable reviewed slot identifier within the canonical card contract.
+     */
+    slot: string;
+}
 /**
  * Canonical card families from production card data.
  */
@@ -675,6 +742,10 @@ export interface CreateLimitedEventRequest {
      * Set code used for booster generation.
      */
     setCode: string;
+    /**
+     * Optional lobby-owned pick and deck-construction schedule.
+     */
+    timerSettings?: (LimitedLobbyTimerSettings | null);
 }
 export interface CreateLobbyRequest {
     config: LobbyConfig;
@@ -1045,6 +1116,10 @@ export interface DelayedEffectOrderOptionView {
     label: string;
     occurrenceSequence: number;
     sourceCardId?: (number | null);
+    /**
+     * Reviewed text retained by the delayed follow-up when it was created.
+     */
+    text?: (EffectTextRefsView | null);
 }
 /**
  * Public trigger point for a delayed effect.
@@ -1077,6 +1152,10 @@ export interface DelayedEffectView {
     id: string;
     source?: (EffectSourceView | null);
     targets: EffectTargetView[];
+    /**
+     * Reviewed card-text and shared-message provenance for this public row.
+     */
+    text?: (EffectTextRefsView | null);
     timing: DelayedEffectTimingView;
 }
 export interface DistributionAssignment {
@@ -1105,6 +1184,24 @@ export interface DistributionTargetView {
     target: AbilityTarget;
 }
 export type DistributionTokenKindView = ("experience" | "shield" | "advantage");
+/**
+ * Draft pick schedule. Vectors are ordered by remaining choices: leader
+ * values cover 2 through 8, pack values cover 2 through 14.
+ */
+export interface DraftLobbyTimerSettings {
+    /**
+     * Leader-pick duration in seconds for 2 through 8 leaders remaining.
+     */
+    leaderPickSeconds: number[];
+    /**
+     * Pack-pick duration in seconds for 2 through 14 cards remaining.
+     */
+    packPickSeconds: number[];
+    /**
+     * Review duration between booster packs in seconds.
+     */
+    reviewSeconds: number;
+}
 /**
  * One configured booster round for a chaos draft.
  */
@@ -1114,14 +1211,6 @@ export interface DraftRoundConfig {
      */
     setCode: string;
 }
-/**
- * Typed game-state source for a dynamic Unit power ceiling.
- */
-export type DynamicPowerLimit = {
-    UpgradesOnUnits: {
-        relation: RelationFilter;
-    };
-};
 /**
  * Public card subset affected by a play or cost modifier.
  */
@@ -1156,36 +1245,46 @@ export type EffectResolutionDraftStepView = ({
     purpose: TargetGroupPurpose;
     selected: AbilityTarget[];
     stepId: string;
+    text?: (EffectTextRefsView | null);
 } | {
     editable: boolean;
     kind: "amount";
     label: string;
     selected: number;
     stepId: string;
+    text?: (EffectTextRefsView | null);
 } | {
     editable: boolean;
     kind: "modes";
     label: string;
+    /**
+     * Exact reviewed Mode wrappers for every selected executable option.
+     */
+    modeTextReferences?: (CardTextRef | null)[];
     selected: number[];
     stepId: string;
+    text?: (EffectTextRefsView | null);
 } | {
     editable: boolean;
     kind: "cards";
     label: string;
     selected: number[];
     stepId: string;
+    text?: (EffectTextRefsView | null);
 } | {
     editable: boolean;
     kind: "name";
     label: string;
     selected: string;
     stepId: string;
+    text?: (EffectTextRefsView | null);
 } | {
     editable: boolean;
     kind: "aspect";
     label: string;
     selected: string;
     stepId: string;
+    text?: (EffectTextRefsView | null);
 } | {
     attackerId: number;
     editable: boolean;
@@ -1193,12 +1292,14 @@ export type EffectResolutionDraftStepView = ({
     label: string;
     stepId: string;
     target: AttackTarget;
+    text?: (EffectTextRefsView | null);
 } | {
     editable: boolean;
     kind: "distribution";
     label: string;
     selected: DistributionAssignment[];
     stepId: string;
+    text?: (EffectTextRefsView | null);
 });
 /**
  * Engine-owned answers collected for one uncommitted semantic effect.
@@ -1212,6 +1313,10 @@ export interface EffectResolutionDraftView {
      * Printed label of originating effect, retained for descendants.
      */
     originLabel: string;
+    /**
+     * Exact reviewed text owner for the originating command.
+     */
+    originText?: (EffectTextRefsView | null);
     sourceCardId: number;
     steps: EffectResolutionDraftStepView[];
 }
@@ -1259,6 +1364,10 @@ export type EffectTargetView = ({
 } | {
     seat: Seat;
     type: "leader";
+} | {
+    leaderIndex: number;
+    seat: Seat;
+    type: "leaderByIndex";
 } | {
     seat: Seat;
     type: "base";
@@ -1269,6 +1378,32 @@ export type EffectTargetView = ({
     cardId: number;
     type: "card";
 });
+/**
+ * Locale-neutral reviewed text that owns visible effect work.
+ *
+ * Clients resolve these catalog references in their selected locale. Empty
+ * fields mean runtime work came from an unmigrated declaration; they never
+ * authorize reconstructing English from a label. Explicit system messages
+ * remain present in `shared_messages` instead of being mistaken for absence.
+ */
+export interface EffectTextRefsView {
+    /**
+     * Printed ability that created this resolution.
+     */
+    ability?: (CardTextRef | null);
+    /**
+     * Nested printed effects enclosing this visible work, outermost first.
+     */
+    effects?: CardTextRef[];
+    /**
+     * Printed mode selected before the current continuation, if any.
+     */
+    selectedMode?: (CardTextRef | null);
+    /**
+     * Finite SDK messages explicitly declared for this outcome.
+     */
+    sharedMessages?: SimulatorMessage[];
+}
 export interface ErrorPayload {
     code: string;
     message: string;
@@ -1282,6 +1417,35 @@ export interface ErrorPayload {
      */
     retryAtMs?: (number | null);
 }
+/**
+ * Reviewed printed ownership for inputs accepted by one event-play command.
+ *
+ * Target groups retain their native ownership/order. Mode references stay
+ * position-aligned with submitted mode indexes, including legacy `None`
+ * entries, so sparse bindings never shift a selected option's identity.
+ */
+export interface EventPlayInputProvenance {
+    /**
+     * One explicit Mode reference per submitted mode index, in command order.
+     */
+    modeTextReferences?: (CardTextRef | null)[];
+    /**
+     * One compact ownership record per submitted target or capture pair, in
+     * command order.
+     *
+     * This intentionally excludes target candidates and the selected target
+     * itself. Event history needs printed ownership, while candidate lists can
+     * reveal hidden resources and live board information.
+     */
+    targetInputs?: EventPlayTargetInputProvenance[];
+}
+/**
+ * Printed ownership for one submitted event target.
+ */
+export interface EventPlayTargetInputProvenance {
+    purpose: TargetGroupPurpose;
+    textReferences?: CardTextRef[];
+}
 export interface ExploitOptionsView {
     candidateUnitIds: number[];
     max: number;
@@ -1692,8 +1856,21 @@ export type GameEvent = ("setupCompleted" | {
 } | {
     eventPlayed: {
         cardId: number;
+        /**
+         * Exact reviewed owners for inputs supplied while playing this event.
+         *
+         * This is emitted only for migrated declarations. It captures the
+         * play command before later event clauses can replace the active
+         * prompt, which lets draft/history consumers retain the source input
+         * rather than borrowing a descendant's text.
+         */
+        inputProvenance?: (EventPlayInputProvenance | null);
         playedWithSmuggle: boolean;
         seat: Seat;
+        /**
+         * Exact printed event declaration exposed when this public event was played.
+         */
+        text?: (EffectTextRefsView | null);
     };
 } | {
     upgradePlayed: {
@@ -1785,6 +1962,17 @@ export type GameEvent = ("setupCompleted" | {
         cardIds: number[];
         seat: Seat;
     };
+} | {
+    cardsChosenFromDiscard: {
+        /**
+         * Printed card identities in command order; duplicates represent distinct copies.
+         */
+        cardIds: number[];
+        /**
+         * Player who made the selection, which may differ from the discard-pile owner.
+         */
+        seat: Seat;
+    };
 } | {
     namedCardChosen: {
         name: string;
@@ -1824,6 +2012,10 @@ export type GameEvent = ("setupCompleted" | {
         source: ActionAbilitySource;
         sourceCardId?: (number | null);
         targets?: AbilityTarget[];
+        /**
+         * Exact public Action or Epic Action declaration that was used.
+         */
+        text?: (EffectTextRefsView | null);
     };
 } | {
     triggeredAbilityResolved: {
@@ -1831,6 +2023,10 @@ export type GameEvent = ("setupCompleted" | {
         seat: Seat;
         sourceCardId: number;
         sourceUnitId?: (number | null);
+        /**
+         * Exact public trigger declaration and currently resolved effect.
+         */
+        text?: (EffectTextRefsView | null);
         window: AbilityWindow;
     };
 } | {
@@ -2106,6 +2302,11 @@ export interface GameState {
      * Whether this snapshot belongs to a server-authorized Playground match.
      */
     playground?: boolean;
+    /**
+     * Host-only Playground ability projection. Empty for normal matches and
+     * while a resolution owns the command boundary.
+     */
+    playgroundActionAbilities?: PlaygroundActionAbilityView[];
     /**
      * Printed cards supplied by every configured Playground deck.
      */
@@ -2353,7 +2554,12 @@ export interface KickLobbySpectatorRequest {
 export interface LeaderActionView {
     creditTokenCounts: number[];
     label: string;
+    modeChoice?: (ModeChoiceView | null);
     targetGroups: TargetSelectionGroup[];
+    /**
+     * Reviewed declaration text for a migrated leader action.
+     */
+    text?: (EffectTextRefsView | null);
 }
 export interface LeaderDeployActionView {
     /**
@@ -2428,6 +2634,15 @@ export interface LeaderStateView {
     flipped: boolean;
     unitId?: (number | null);
 }
+/**
+ * Explicit departure from one direct Limited Event seat.
+ */
+export interface LeaveLimitedEventRequest {
+    /**
+     * Seat token returned by create or join.
+     */
+    seatToken: string;
+}
 export interface LeaveLobbyRequest {
     playerToken: string;
 }
@@ -2652,6 +2867,21 @@ export interface LimitedEventSeatView {
      */
     seatIndex: number;
 }
+/**
+ * Server messages emitted by direct Limited Event sockets.
+ */
+export type LimitedEventServerMessage = ({
+    payload: LimitedEventSnapshot;
+    type: "snapshot";
+} | {
+    payload: {
+        nonce?: (string | null);
+    };
+    type: "pong";
+} | {
+    payload: ErrorPayload;
+    type: "error";
+});
 /**
  * Public snapshot of one limited event.
  */
@@ -2750,6 +2980,23 @@ export interface LimitedEventViewerView {
      */
     seatIndex: number;
 }
+/**
+ * Limited-event timing controls owned by a lobby host.
+ */
+export interface LimitedLobbyTimerSettings {
+    /**
+     * Deck construction duration in seconds.
+     */
+    deckBuildingSeconds: number;
+    /**
+     * Enables informational deck construction deadline displays.
+     */
+    deckBuildingTimerEnabled: boolean;
+    /**
+     * Draft-only pick and review schedule. Sealed lobbies omit it.
+     */
+    draft?: (DraftLobbyTimerSettings | null);
+}
 /**
  * One generated pack card plus collation metadata.
  */
@@ -2896,6 +3143,19 @@ export interface LobbyDeckSetPreview {
      */
     leader?: (number | null);
 }
+/**
+ * Per-game clock values shared by constructed and Limited lobbies.
+ */
+export interface LobbyGameTimerSettings {
+    /**
+     * Seconds of reserve time granted to each player.
+     */
+    reserveSeconds: number;
+    /**
+     * Seconds allocated to each normal turn before reserve is used.
+     */
+    turnSeconds: number;
+}
 export interface LobbyKickedPayload {
     /**
      * Player or spectator identity removed from this lobby.
@@ -3100,6 +3360,11 @@ export interface LobbySnapshot {
     requiredPlayerCount: number;
     spectators?: LobbySpectatorView[];
     status: LobbyStatus;
+    /**
+     * Host-selected timer schedule for this lobby. Missing values identify
+     * records created before configurable timers were introduced.
+     */
+    timerSettings?: (LobbyTimerSettings | null);
     visibility: LobbyVisibility;
 }
 export interface LobbySpectatorView {
@@ -3134,6 +3399,19 @@ export type LobbyStatus = ("waiting" | "started" | "closed");
 export interface LobbySyncRequest {
     playerToken: string;
 }
+/**
+ * Host-selected timing rules for a lobby and its started event or match.
+ */
+export interface LobbyTimerSettings {
+    /**
+     * Per-turn and reserve-bank settings for the final game.
+     */
+    game: LobbyGameTimerSettings;
+    /**
+     * Limited-only draft and deck-construction settings.
+     */
+    limited?: (LimitedLobbyTimerSettings | null);
+}
 export type LobbyVisibility = ("private" | "public");
 export interface LobbyWelcomePayload {
     lobbyId: string;
@@ -3527,7 +3805,8 @@ export interface MatchSavePayload {
     };
     /**
      * Wire-format version. Always [`MATCH_SAVE_VERSION`] for newly minted
-     * payloads; restore rejects mismatches.
+     * payloads; restore accepts every [`SUPPORTED_SAVE_VERSIONS`] entry and
+     * rejects anything else.
      */
     version: number;
 }
@@ -3720,6 +3999,10 @@ export interface PendingAbilityAspectChoiceView {
      */
     promptProvenance?: (PromptProvenanceView | null);
     sourceCardId: number;
+    /**
+     * Reviewed printed text owning this chooser payload.
+     */
+    text?: (EffectTextRefsView | null);
 }
 export interface PendingAbilityAttackChoiceView {
     abilityId: number;
@@ -3748,6 +4031,10 @@ export interface PendingAbilityAttackChoiceView {
      */
     revealedCardIds?: number[];
     sourceCardId: number;
+    /**
+     * Reviewed printed text owning this chooser payload.
+     */
+    text?: (EffectTextRefsView | null);
 }
 export interface PendingAbilityCardChoiceView {
     abilityId: number;
@@ -3781,6 +4068,10 @@ export interface PendingAbilityCardChoiceView {
     revealMode: HiddenCardChoiceMode;
     searchedCards: CardInstanceView[];
     sourceCardId: number;
+    /**
+     * Reviewed printed text owning this private chooser payload.
+     */
+    text?: (EffectTextRefsView | null);
 }
 /**
  * Coarse family of one pending ability: [`PendingAbilityKind`]'s variant
@@ -3814,11 +4105,22 @@ export interface PendingAbilityModeChoiceView {
     max: number;
     min: number;
     optionLabels: string[];
+    /**
+     * Reviewed printed text for each matching mode option.
+     *
+     * Index aligns with `option_labels`; `None` denotes an engine/system
+     * option rather than inferred prose.
+     */
+    optionTextReferences?: (CardTextRef | null)[];
     /**
      * Parent/stage identity and interaction policy inherited from resolution.
      */
     promptProvenance?: (PromptProvenanceView | null);
     sourceCardId: number;
+    /**
+     * Reviewed printed text owning this chooser payload.
+     */
+    text?: (EffectTextRefsView | null);
 }
 export interface PendingAbilityNameChoiceView {
     abilityId: number;
@@ -3833,6 +4135,10 @@ export interface PendingAbilityNameChoiceView {
      */
     promptProvenance?: (PromptProvenanceView | null);
     sourceCardId: number;
+    /**
+     * Reviewed printed text owning this chooser payload.
+     */
+    text?: (EffectTextRefsView | null);
 }
 /**
  * One queued ability shown while a player-order choice is pending.
@@ -3845,6 +4151,11 @@ export interface PendingAbilityOrderAbilityView {
     id: number;
     label: string;
     sourceCardId: number;
+    /**
+     * Reviewed text retained by the queued ability when its producer made it
+     * public. The order prompt does not infer ownership from source cards.
+     */
+    text?: (EffectTextRefsView | null);
 }
 /**
  * Payload for [`PromptState::ChooseTriggeredAbilityPlayerOrder`].
@@ -3910,6 +4221,10 @@ export interface PendingAbilityView {
      * Groups retain ordering, bounds, and structural purpose together.
      */
     targetPlan: TargetSelectionPlanView;
+    /**
+     * Reviewed printed ability, selected mode, and current effect ownership.
+     */
+    text?: (EffectTextRefsView | null);
     /**
      * Trigger window this ability was collected in.
      *
@@ -3980,6 +4295,10 @@ export interface PendingDistributionView {
      */
     promptProvenance?: (PromptProvenanceView | null);
     sourceCardId: number;
+    /**
+     * Reviewed printed text owning this chooser payload.
+     */
+    text?: (EffectTextRefsView | null);
     title: string;
     validTargets: DistributionTargetView[];
 }
@@ -4057,13 +4376,54 @@ export type PlayCardZone = ("hand" | "resource" | "discardPile");
  * One server-authoritative human-player room lifecycle event.
  */
 export type PlayerPresenceStatus = ("joined" | "disconnected" | "reconnected" | "left");
-export type PlayerTargetPattern = (("SelfPlayer" | "EachPlayer" | "OpponentPlayer" | "ChosenOpponent" | "ChosenPlayer" | "DefendingPlayer" | "RememberedPlayer" | "RememberedUnitController" | "OtherThanRememberedPlayer") | "EachOpponent" | "EachOpponentWhoseBaseDamagedBySourceThisPhase" | "RememberedTargetController" | {
-    RelativeToRememberedPlayer: SeatDirection;
-} | "ControllerOfLowerCostRememberedUnit");
+/**
+ * Playground-only action ability that may be executed without normal action
+ * timing, usage, condition, or cost gates.
+ */
+export interface PlaygroundActionAbilityView {
+    label: string;
+    modeChoice?: (ModeChoiceView | null);
+    seat: Seat;
+    source: ActionAbilitySource;
+    targetGroups: TargetSelectionGroup[];
+    /**
+     * Exact public Action or Epic Action declaration when migrated.
+     */
+    text?: (EffectTextRefsView | null);
+}
+/**
+ * One in-play card whose Playground-editable state may be set exactly.
+ *
+ * Every field is a target value rather than a delta, so a client that shows
+ * current counts can submit what the board should look like instead of
+ * reconstructing the sequence of adjustments that gets there. Anything the
+ * engine derives — keywords, clone identity, controller, arena, card text —
+ * stays out of this patch and remains read-only.
+ */
+export type PlaygroundCardStateChange = ({
+    advantageTokens?: (number | null);
+    damage?: (number | null);
+    experienceTokens?: (number | null);
+    /**
+     * `true` readies the unit even while an effect forbids readying.
+     */
+    ready?: (boolean | null);
+    shieldTokens?: (number | null);
+    type: "unit";
+    unitId: number;
+} | {
+    damage: number;
+    seat: Seat;
+    type: "base";
+});
 /**
  * Host-authorized raw scenario mutation for a Playground match.
  */
 export type PlaygroundCommand = ({
+    cardId: number;
+    seat: Seat;
+    type: "addResource";
+} | {
     card_ids: number[];
     seat: Seat;
     type: "setDrawQueue";
@@ -4077,10 +4437,20 @@ export type PlaygroundCommand = ({
     cardId: number;
     seat: Seat;
     type: "playCardForFree";
+} | {
+    modeIndices: number[];
+    seat: Seat;
+    source: ActionAbilitySource;
+    target?: (AbilityTarget | null);
+    targets: AbilityTarget[];
+    type: "executeActionAbility";
 } | {
     amount: number;
     target: PlaygroundDamageTarget;
     type: "setDamage";
+} | {
+    change: PlaygroundCardStateChange;
+    type: "changeCardState";
 } | {
     target: PlaygroundDefeatTarget;
     type: "defeatCard";
@@ -4089,6 +4459,15 @@ export type PlaygroundCommand = ({
     cardId: number;
     ownerSeat: Seat;
     type: "captureCard";
+} | {
+    cardId: number;
+    leaderIndex: number;
+    seat: Seat;
+    type: "swapLeader";
+} | {
+    cardId: number;
+    seat: Seat;
+    type: "swapBase";
 });
 /**
  * One board target whose damage counter Playground may set exactly.
@@ -4127,7 +4506,6 @@ export interface PlaygroundExportPayload {
 export interface PrepareLobbyLimitedAiDecksRequest {
     playerToken: string;
 }
-export type PresenceFilter = ("Any" | "Required" | "Forbidden");
 /**
  * Stable parent/stage identity shared by every prompt opened during an effect.
  */
@@ -4391,6 +4769,9 @@ export interface RejectedPlayView {
     cardInstanceId: number;
     reason: string;
 }
+/**
+ * Restricts a target by controller relation to the effect source.
+ */
 export type RelationFilter = ("Any" | "Friendly" | "Enemy");
 /**
  * HTTP request body for offering, accepting, or declining a rematch.
@@ -4532,10 +4913,6 @@ export interface SaveMatchRequest {
  * Player slot in clockwise multiplayer order.
  */
 export type Seat = ("one" | "two" | "three" | "four");
-/**
- * Relative multiplayer seat direction.
- */
-export type SeatDirection = ("Left" | "Right");
 /**
  * Per-seat stance on a two-sided post-game offer.
  *
@@ -4644,10 +5021,6 @@ export interface SeatState {
      */
     sideboardCount: number;
 }
-/**
- * How far back an `exclude_previously_selected` filter looks.
- */
-export type SelectionScope = ("ThisEffect" | "ThisClause");
 /**
  * Public reason a match series ended.
  */
@@ -4831,6 +5204,65 @@ export interface SimulatorAvailabilityResponse {
      */
     maintenance: MaintenanceStatus;
 }
+/**
+ * Typed engine-origin simulator copy with a stable SDK message id.
+ */
+export type SimulatorMessage = ({
+    kind: "abilityUnavailable";
+} | {
+    kind: "action.exhaust";
+} | {
+    count: number;
+    kind: "amount.resources";
+} | {
+    kind: "choice.none";
+} | {
+    kind: "chooseTarget";
+} | {
+    kind: "chooseTargets";
+    max: number;
+    min: number;
+} | {
+    kind: "controls.cancel";
+} | {
+    kind: "controls.confirm";
+} | {
+    kind: "controls.decline";
+} | {
+    kind: "controls.done";
+} | {
+    kind: "duration.phase";
+} | {
+    count: number;
+    kind: "duration.rounds";
+} | {
+    keyword: string;
+    kind: "keyword.name";
+} | {
+    kind: "keyword.overwhelm";
+} | {
+    kind: "keyword.raid";
+} | {
+    kind: "keyword.sentinel";
+} | {
+    kind: "legacyText";
+    text: string;
+} | {
+    kind: "targetPurpose.attachUpgrade";
+} | {
+    kind: "targetPurpose.chooseTarget";
+} | {
+    amount: number;
+    kind: "targetPurpose.dealDamage";
+} | {
+    amount: number;
+    kind: "targetPurpose.giveShield";
+} | {
+    amount: number;
+    kind: "targetPurpose.heal";
+} | {
+    kind: "timing.onceEachRound";
+});
 /**
  * One cursor-paginated admin report list page.
  */
@@ -4950,6 +5382,28 @@ export interface StartLobbyRequest {
 export interface StartTournamentEventRequest {
     playerToken: string;
 }
+/**
+ * Participant-authorized feedback for one completed Solo-versus-AI game.
+ */
+export interface SubmitAiGameFeedbackRequest {
+    comments?: (string | null);
+    gameNumber: number;
+    /**
+     * @minItems 1
+     */
+    identities: [HistoryIdentityInput, ...(HistoryIdentityInput)[]];
+    rating: AiGameFeedbackRating;
+}
+/**
+ * Result of an idempotent AI-game-feedback submission.
+ */
+export interface SubmitAiGameFeedbackResponse {
+    /**
+     * `false` means this game had already received feedback.
+     */
+    created: boolean;
+    feedback: AiGameFeedback;
+}
 export interface SubmitLobbyLimitedDeckRequest {
     deck: DeckInput;
     deckId?: (string | null);
@@ -5129,6 +5583,13 @@ export interface TargetSelectionGroup {
      * effect requests targets but has no classifiable structural meaning.
      */
     purpose?: (TargetGroupPurpose | null);
+    /**
+     * Reviewed printed text that produced this exact group.
+     *
+     * References are locale-neutral and preserve nested printed-effect
+     * ownership without placing card prose in public match state.
+     */
+    textReferences?: CardTextRef[];
     validTargets: AbilityTarget[];
 }
 /**
@@ -5198,6 +5659,10 @@ export interface TournamentRoomPlayerView {
     deck?: (LobbyDeckPreview | null);
     deckReady: boolean;
     host: boolean;
+    /**
+     * Whether server automation permanently controls this participant.
+     */
+    isAi?: boolean;
     joinedAtMs: number;
     name: string;
     playerId: string;
@@ -5359,7 +5824,6 @@ export interface UndoRespondMatchRequest {
      */
     seatToken: string;
 }
-export type UniquenessFilter = ("Any" | "Unique" | "NonUnique");
 export type UnitAbilitySuppressionView = ("none" | "partial" | "full");
 /**
  * Mirror of one [`UnitState::copied_card`] value on the wire.
@@ -5378,242 +5842,6 @@ export interface UnitCopiedCardEntry {
     unitInstanceId: number;
 }
 export type UnitDefeatCause = ("other" | "damage");
-export type UnitExtremum = ("LeastRemainingHp" | "MostPower" | "HighestPrintedCost");
-export interface UnitFilter {
-    /**
-     * Matches when any complete alternative filter matches.
-     *
-     * This keeps `one_of((unit_selector_a, unit_selector_b))` orthogonal
-     * without flattening distinct restrictions into one lossy filter.
-     */
-    alternatives?: UnitFilter[];
-    arena?: (CardArena | null);
-    attacked_base_this_phase: boolean;
-    /**
-     * Requires current control by one typed player independently from the
-     * broad source-relative relation.
-     */
-    controller?: (PlayerTargetPattern | null);
-    /**
-     * Marks a count whose Units must all be controlled by one other player.
-     *
-     * This is consumed by `Condition::AnotherPlayerControlsUnitsAtLeast`
-     * before the filter reaches ordinary target matching.
-     */
-    controller_is_another_player?: boolean;
-    controller_is_remembered_player: boolean;
-    dealt_base_damage_this_phase: boolean;
-    /**
-     * Matches a Unit in the arena opposite the resolving source Unit.
-     */
-    different_arena_from_source?: boolean;
-    different_aspect_from_remembered_card: boolean;
-    /**
-     * Requires legal attachment for Upgrade retained by preceding choice.
-     */
-    eligible_for_remembered_upgrade?: boolean;
-    exact_cost?: (number | null);
-    /**
-     * Only matches units whose cost equals context.remembered_unit_cost.
-     */
-    exact_cost_same_as_remembered_cost?: boolean;
-    exact_power_equal_ready_resources: boolean;
-    exact_remaining_hp_equal_ready_resources: boolean;
-    exact_title?: (string | null);
-    /**
-     * Matches any unit whose title is in this list. When combined with
-     * required_traits_any, either a matching title or trait satisfies the
-     * name/trait requirement.
-     */
-    exact_titles_any: string[];
-    /**
-     * Excludes Unit hosting resolving source Upgrade.
-     */
-    exclude_attached_unit?: boolean;
-    /**
-     * Excludes only the Unit that dealt the immediately preceding damage.
-     */
-    exclude_previous_damage_dealer?: boolean;
-    /**
-     * Excludes every Unit already selected earlier in the resolving effect.
-     *
-     * Distinct from `require_other`, which only knows the source Unit and the
-     * single most recent selection: a third sequential choice ("Give a third
-     * friendly unit +1/+1") has to exclude both earlier picks.
-     */
-    exclude_previously_selected?: (SelectionScope | null);
-    /**
-     * Excludes units retained by a preceding multi-target choice.
-     */
-    exclude_remembered_units?: boolean;
-    excluded_aspects: string[];
-    /**
-     * Excludes units currently controlled by one typed player.
-     */
-    excluded_controller?: (PlayerTargetPattern | null);
-    /**
-     * Excludes units with any listed canonical title.
-     */
-    excluded_titles?: string[];
-    excluded_traits: string[];
-    /**
-     * Restricts iteration to Units exploited while playing resolving source card.
-     */
-    exploited_to_play_source?: boolean;
-    extremum?: (UnitExtremum | null);
-    max_cost?: (number | null);
-    /**
-     * Only matches units whose printed cost is strictly less than the amount of
-     * combat damage dealt to a base this attack
-     * (`context.combat_damage_dealt_to_base`). Shin Hati ASH 51762.
-     */
-    max_cost_less_than_combat_damage_to_base?: boolean;
-    /**
-     * Filters out units whose cost exceeds the cost stored in context.remembered_unit_cost.
-     */
-    max_cost_same_or_less_than_remembered_cost: boolean;
-    /**
-     * Filters out units whose printed cost exceeds resources paid to play the
-     * source card for current trigger.
-     */
-    max_cost_same_or_less_than_resources_paid_to_play?: boolean;
-    max_cost_same_or_less_than_source: boolean;
-    max_power?: (number | null);
-    /**
-     * Dynamic alternative to a fixed `max_power`.
-     */
-    max_power_dynamic?: (DynamicPowerLimit | null);
-    /**
-     * Only matches a unit whose power is strictly less than at least one
-     * friendly unit's power (Ahsoka Tano 51727 action target restriction).
-     */
-    max_power_less_than_any_friendly?: boolean;
-    /**
-     * Only matches Units with strictly less power than remembered Unit.
-     */
-    max_power_less_than_remembered_power?: boolean;
-    max_power_less_than_source: boolean;
-    /**
-     * Filters out units whose power exceeds the power stored in context.remembered_unit_power.
-     */
-    max_power_same_or_less_than_remembered_power: boolean;
-    max_remaining_hp?: (number | null);
-    max_remaining_hp_less_than_source: boolean;
-    min_cost?: (number | null);
-    /**
-     * Only matches units whose cost is strictly greater than the cost stored in
-     * context.remembered_unit_cost (e.g. Reckless Sacrifice's "a unit that costs
-     * more than the discarded card").
-     */
-    min_cost_greater_than_remembered_cost?: boolean;
-    min_hp?: (number | null);
-    min_power?: (number | null);
-    min_remaining_hp?: (number | null);
-    /**
-     * Only matches Units with at least this many distinct active keywords.
-     */
-    minimum_distinct_keywords?: (number | null);
-    non_leader: boolean;
-    /**
-     * Requires canonical ownership by one typed player independently from
-     * current controller relation.
-     */
-    owner?: (PlayerTargetPattern | null);
-    relation: RelationFilter;
-    /**
-     * Only matches units that attacked during the current phase.
-     */
-    require_attacked_this_phase?: boolean;
-    require_damaged: boolean;
-    /**
-     * Only matches units that entered play this phase (UnitState::entered_this_phase).
-     */
-    require_entered_this_phase: boolean;
-    require_exhausted: boolean;
-    /**
-     * Only matches units that have at least one keyword (printed or granted).
-     */
-    require_has_keyword?: boolean;
-    /**
-     * Only matches Units healed at least once during current phase.
-     */
-    require_healed_this_phase?: boolean;
-    /**
-     * Restrict to leader units (deployed leaders). Set by "a friendly leader"
-     * targets, e.g. Mando's N-1 Starfighter (ASH 52696).
-     */
-    require_leader?: boolean;
-    /**
-     * Filters out units that have an Experience token attached.
-     */
-    require_no_experience: boolean;
-    require_no_pilot: boolean;
-    /**
-     * Filters out units that attacked earlier this phase.
-     */
-    require_not_attacked_this_phase: boolean;
-    /**
-     * Only matches Units that did not enter play during current phase.
-     */
-    require_not_entered_this_phase?: boolean;
-    /**
-     * Only matches Units that did not enter play during current round.
-     */
-    require_not_entered_this_round?: boolean;
-    require_other: boolean;
-    require_ready: boolean;
-    /**
-     * Only matches units that have at least one Shield token attached.
-     */
-    require_shield_token?: boolean;
-    require_undamaged: boolean;
-    required_aspects: string[];
-    required_aspects_any: string[];
-    required_card_or_upgrade_traits_any: string[];
-    required_keywords_any: string[];
-    required_traits: string[];
-    required_traits_any: string[];
-    requires_chosen_aspect: boolean;
-    /**
-     * Matches the arena occupied by Unit selected earlier in this ability.
-     */
-    same_arena_as_remembered_unit?: boolean;
-    same_arena_as_source: boolean;
-    same_name_as_remembered_card: boolean;
-    /**
-     * Matches Units with same name as Unit stored by preceding target choice.
-     */
-    same_name_as_remembered_unit?: boolean;
-    /**
-     * Requires the selected units' printed costs to be at most this value.
-     */
-    selected_max_combined_cost?: (number | null);
-    /**
-     * Requires selected Units' current combined power to be at most this value.
-     */
-    selected_max_combined_power?: (number | null);
-    /**
-     * Requires the selected units' combined remaining HP to be at most this
-     * value (Pre Vizsla ASH 51947: "with a total of N or less remaining HP").
-     */
-    selected_max_combined_remaining_hp?: (number | null);
-    /**
-     * Requires every selected unit in a multi-unit selection to share an arena.
-     */
-    selected_same_arena?: boolean;
-    /**
-     * Requires every selected Unit to share at least one Trait.
-     */
-    selected_share_trait?: boolean;
-    shares_aspect_with_context_unit: boolean;
-    /**
-     * Requires the target to share a trait with a leader card controlled by the source player.
-     */
-    shares_trait_with_friendly_leader: boolean;
-    token_filter: PresenceFilter;
-    uniqueness_filter: UniquenessFilter;
-    upgrade_filter: PresenceFilter;
-}
 export interface UnitStateView {
     /**
      * Whether the unit currently loses all or most of its abilities.
@@ -5744,13 +5972,49 @@ export interface UpdateLobbySettingsRequest {
      * Replacement BO1/BO3 length for one-deck Duel lobbies.
      */
     bestOfMatches?: (number | null);
+    /**
+     * Clears the deterministic match seed, restoring random matches.
+     */
+    clearMatchSeed?: boolean;
+    /**
+     * Clears the deterministic Limited pool seed, restoring random pools.
+     */
+    clearPackSeed?: boolean;
+    /**
+     * Replacement Chaos Draft booster sequence.
+     */
+    draftRounds?: (DraftRoundConfig[] | null);
     gameTimerEnabled?: (boolean | null);
     /**
      * Replacement constructed format for one-deck Duel lobbies.
      */
     matchFormat?: (ConstructedFormat | null);
+    /**
+     * Replacement deterministic match seed.
+     */
+    matchSeed?: (string | null);
+    /**
+     * Replacement deterministic Limited pool seed.
+     */
+    packSeed?: (string | null);
+    /**
+     * Enables or disables draft pick auto-selection countdowns.
+     */
+    pickTimerEnabled?: (boolean | null);
     playerCount?: (number | null);
     playerToken: string;
+    /**
+     * Replacement Sealed booster count.
+     */
+    sealedPackCount?: (number | null);
+    /**
+     * Replacement Limited set code for sealed and normal Draft lobbies.
+     */
+    setCode?: (string | null);
+    /**
+     * Replaces timer durations for the final match and Limited event.
+     */
+    timerSettings?: (LobbyTimerSettings | null);
     /**
      * Replacement legality profile for Trilogy lobbies.
      */