@my-swu/simulator-client 0.1.6 → 0.1.7

package/schema/common.schema.json

@@ -81,6 +81,32 @@
             "seat"
           ]
         },
+        {
+          "description": "One physical leader slot; legacy `Leader` continues to identify slot zero.",
+          "type": "object",
+          "properties": {
+            "leaderIndex": {
+              "description": "Zero-based position in that player's leader list.",
+              "type": "integer",
+              "format": "uint8",
+              "maximum": 255,
+              "minimum": 0
+            },
+            "seat": {
+              "description": "Player who owns the leader slot.",
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
+            },
+            "type": {
+              "type": "string",
+              "const": "leaderByIndex"
+            }
+          },
+          "required": [
+            "type",
+            "seat",
+            "leaderIndex"
+          ]
+        },
         {
           "type": "object",
           "properties": {
@@ -344,6 +370,7 @@
     "ActionAbilitySource": {
       "oneOf": [
         {
+          "description": "Legacy primary-leader action source.\n\nKept for wire compatibility with saved commands and older clients.",
           "type": "object",
           "properties": {
             "type": {
@@ -355,6 +382,27 @@
             "type"
           ]
         },
+        {
+          "description": "One non-primary undeployed leader's printed action.\n\nTwin Suns players can have multiple leader cards. The primary source\nremains `Leader` for backwards compatibility, while every extra slot\ncarries its stable zero-based placement index.",
+          "type": "object",
+          "properties": {
+            "leaderIndex": {
+              "description": "Non-primary leader slots start at one; slot zero uses legacy `Leader`.",
+              "type": "integer",
+              "format": "uint8",
+              "maximum": 255,
+              "minimum": 1
+            },
+            "type": {
+              "type": "string",
+              "const": "leaderByIndex"
+            }
+          },
+          "required": [
+            "type",
+            "leaderIndex"
+          ]
+        },
         {
           "type": "object",
           "properties": {
@@ -457,6 +505,16 @@
         "label": {
           "type": "string"
         },
+        "modeChoice": {
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/ModeChoiceView"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "source": {
           "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/ActionAbilitySource"
         },
@@ -465,6 +523,17 @@
           "items": {
             "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/TargetSelectionGroup"
           }
+        },
+        "text": {
+          "description": "Exact public Action or Epic Action declaration when migrated.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+            },
+            {
+              "type": "null"
+            }
+          ]
         }
       },
       "required": [
@@ -984,6 +1053,17 @@
           "items": {
             "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTargetView"
           }
+        },
+        "text": {
+          "description": "Reviewed card-text and shared-message provenance when this public row\nwas created by a resolving instruction. Absence means this registry\ndoes not retain a display declaration, never that text was inferred.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+            },
+            {
+              "type": "null"
+            }
+          ]
         }
       },
       "required": [
@@ -997,6 +1077,13 @@
       "description": "Compact durable match data safe for an administrator list view.",
       "type": "object",
       "properties": {
+        "aiFeedback": {
+          "description": "Feedback collected for individual completed AI games in this match.",
+          "type": "array",
+          "items": {
+            "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/AiGameFeedback"
+          }
+        },
         "completedAtMs": {
           "type": [
             "integer",
@@ -1054,7 +1141,8 @@
         "series",
         "createdAtMs",
         "updatedAtMs",
-        "replayAvailable"
+        "replayAvailable",
+        "aiFeedback"
       ]
     },
     "AiDecisionDiagnostic": {
@@ -1260,6 +1348,46 @@
         }
       ]
     },
+    "AiGameFeedback": {
+      "description": "One immutable player assessment of an AI opponent for a completed game.",
+      "type": "object",
+      "properties": {
+        "comments": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "gameNumber": {
+          "type": "integer",
+          "format": "uint8",
+          "maximum": 255,
+          "minimum": 0
+        },
+        "rating": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/AiGameFeedbackRating"
+        },
+        "submittedAtMs": {
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "gameNumber",
+        "rating",
+        "submittedAtMs"
+      ]
+    },
+    "AiGameFeedbackRating": {
+      "description": "Rating submitted by a player after completing one Solo-versus-AI game.",
+      "type": "string",
+      "enum": [
+        "poorly",
+        "okay",
+        "good"
+      ]
+    },
     "AiOpponentConfig": {
       "description": "Explicit AI seat configuration.",
       "type": "object",
@@ -1951,6 +2079,32 @@
         "title"
       ]
     },
+    "CardTextRef": {
+      "type": "object",
+      "properties": {
+        "cardId": {
+          "description": "Canonical card identity that owns this reviewed printed slot.",
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0
+        },
+        "contractFingerprint": {
+          "description": "Full semantic-contract fingerprint pinning this reference to reviewed text.",
+          "type": "string",
+          "pattern": "^[0-9A-Fa-f]{64}$"
+        },
+        "slot": {
+          "description": "Durable reviewed slot identifier within the canonical card contract.",
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "cardId",
+        "slot",
+        "contractFingerprint"
+      ]
+    },
     "CardType": {
       "description": "Canonical card families from production card data.",
       "type": "string",
@@ -2676,6 +2830,17 @@
           ],
           "format": "uint32",
           "minimum": 0
+        },
+        "text": {
+          "description": "Reviewed text retained by the delayed follow-up when it was created.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+            },
+            {
+              "type": "null"
+            }
+          ]
         }
       },
       "required": [
@@ -2826,6 +2991,17 @@
             "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTargetView"
           }
         },
+        "text": {
+          "description": "Reviewed card-text and shared-message provenance for this public row.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "timing": {
           "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/DelayedEffectTimingView"
         }
@@ -2980,6 +3156,44 @@
         "advantage"
       ]
     },
+    "DraftLobbyTimerSettings": {
+      "description": "Draft pick schedule. Vectors are ordered by remaining choices: leader\nvalues cover 2 through 8, pack values cover 2 through 14.",
+      "type": "object",
+      "properties": {
+        "leaderPickSeconds": {
+          "description": "Leader-pick duration in seconds for 2 through 8 leaders remaining.",
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "uint16",
+            "maximum": 65535,
+            "minimum": 0
+          }
+        },
+        "packPickSeconds": {
+          "description": "Pack-pick duration in seconds for 2 through 14 cards remaining.",
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "uint16",
+            "maximum": 65535,
+            "minimum": 0
+          }
+        },
+        "reviewSeconds": {
+          "description": "Review duration between booster packs in seconds.",
+          "type": "integer",
+          "format": "uint16",
+          "maximum": 65535,
+          "minimum": 0
+        }
+      },
+      "required": [
+        "leaderPickSeconds",
+        "packPickSeconds",
+        "reviewSeconds"
+      ]
+    },
     "DraftRoundConfig": {
       "description": "One configured booster round for a chaos draft.",
       "type": "object",
@@ -3128,6 +3342,16 @@
             },
             "stepId": {
               "type": "string"
+            },
+            "text": {
+              "anyOf": [
+                {
+                  "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+                },
+                {
+                  "type": "null"
+                }
+              ]
             }
           },
           "required": [
@@ -3160,6 +3384,16 @@
             },
             "stepId": {
               "type": "string"
+            },
+            "text": {
+              "anyOf": [
+                {
+                  "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+                },
+                {
+                  "type": "null"
+                }
+              ]
             }
           },
           "required": [
@@ -3183,6 +3417,20 @@
             "label": {
               "type": "string"
             },
+            "modeTextReferences": {
+              "description": "Exact reviewed Mode wrappers for every selected executable option.",
+              "type": "array",
+              "items": {
+                "anyOf": [
+                  {
+                    "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/CardTextRef"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
             "selected": {
               "type": "array",
               "items": {
@@ -3193,6 +3441,16 @@
             },
             "stepId": {
               "type": "string"
+            },
+            "text": {
+              "anyOf": [
+                {
+                  "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+                },
+                {
+                  "type": "null"
+                }
+              ]
             }
           },
           "required": [
@@ -3226,6 +3484,16 @@
             },
             "stepId": {
               "type": "string"
+            },
+            "text": {
+              "anyOf": [
+                {
+                  "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+                },
+                {
+                  "type": "null"
+                }
+              ]
             }
           },
           "required": [
@@ -3254,6 +3522,16 @@
             },
             "stepId": {
               "type": "string"
+            },
+            "text": {
+              "anyOf": [
+                {
+                  "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+                },
+                {
+                  "type": "null"
+                }
+              ]
             }
           },
           "required": [
@@ -3282,6 +3560,16 @@
             },
             "stepId": {
               "type": "string"
+            },
+            "text": {
+              "anyOf": [
+                {
+                  "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+                },
+                {
+                  "type": "null"
+                }
+              ]
             }
           },
           "required": [
@@ -3315,6 +3603,16 @@
             },
             "target": {
               "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/AttackTarget"
+            },
+            "text": {
+              "anyOf": [
+                {
+                  "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+                },
+                {
+                  "type": "null"
+                }
+              ]
             }
           },
           "required": [
@@ -3347,6 +3645,16 @@
             },
             "stepId": {
               "type": "string"
+            },
+            "text": {
+              "anyOf": [
+                {
+                  "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+                },
+                {
+                  "type": "null"
+                }
+              ]
             }
           },
           "required": [
@@ -3383,6 +3691,17 @@
           "description": "Printed label of originating effect, retained for descendants.",
           "type": "string"
         },
+        "originText": {
+          "description": "Exact reviewed text owner for the originating command.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "sourceCardId": {
           "type": "integer",
           "format": "uint32",
@@ -3543,6 +3862,30 @@
             "seat"
           ]
         },
+        {
+          "description": "Exact physical leader slot affected by this effect.",
+          "type": "object",
+          "properties": {
+            "leaderIndex": {
+              "type": "integer",
+              "format": "uint8",
+              "maximum": 255,
+              "minimum": 0
+            },
+            "seat": {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
+            },
+            "type": {
+              "type": "string",
+              "const": "leaderByIndex"
+            }
+          },
+          "required": [
+            "type",
+            "seat",
+            "leaderIndex"
+          ]
+        },
         {
           "type": "object",
           "properties": {
@@ -3596,6 +3939,48 @@
         }
       ]
     },
+    "EffectTextRefsView": {
+      "description": "Locale-neutral reviewed text that owns visible effect work.\n\nClients resolve these catalog references in their selected locale. Empty\nfields mean runtime work came from an unmigrated declaration; they never\nauthorize reconstructing English from a label. Explicit system messages\nremain present in `shared_messages` instead of being mistaken for absence.",
+      "type": "object",
+      "properties": {
+        "ability": {
+          "description": "Printed ability that created this resolution.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/CardTextRef"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "effects": {
+          "description": "Nested printed effects enclosing this visible work, outermost first.",
+          "type": "array",
+          "items": {
+            "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/CardTextRef"
+          }
+        },
+        "selectedMode": {
+          "description": "Printed mode selected before the current continuation, if any.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/CardTextRef"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "sharedMessages": {
+          "description": "Finite SDK messages explicitly declared for this outcome.",
+          "type": "array",
+          "items": {
+            "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/SimulatorMessage"
+          }
+        }
+      }
+    },
     "ErrorPayload": {
       "type": "object",
       "properties": {
@@ -3628,6 +4013,51 @@
         "message"
       ]
     },
+    "EventPlayInputProvenance": {
+      "description": "Reviewed printed ownership for inputs accepted by one event-play command.\n\nTarget groups retain their native ownership/order. Mode references stay\nposition-aligned with submitted mode indexes, including legacy `None`\nentries, so sparse bindings never shift a selected option's identity.",
+      "type": "object",
+      "properties": {
+        "modeTextReferences": {
+          "description": "One explicit Mode reference per submitted mode index, in command order.",
+          "type": "array",
+          "items": {
+            "anyOf": [
+              {
+                "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/CardTextRef"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "targetInputs": {
+          "description": "One compact ownership record per submitted target or capture pair, in\ncommand order.\n\nThis intentionally excludes target candidates and the selected target\nitself. Event history needs printed ownership, while candidate lists can\nreveal hidden resources and live board information.",
+          "type": "array",
+          "items": {
+            "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EventPlayTargetInputProvenance"
+          }
+        }
+      }
+    },
+    "EventPlayTargetInputProvenance": {
+      "description": "Printed ownership for one submitted event target.",
+      "type": "object",
+      "properties": {
+        "purpose": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/TargetGroupPurpose"
+        },
+        "textReferences": {
+          "type": "array",
+          "items": {
+            "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/CardTextRef"
+          }
+        }
+      },
+      "required": [
+        "purpose"
+      ]
+    },
     "ExploitOptionsView": {
       "type": "object",
       "properties": {
@@ -5256,11 +5686,33 @@
                   "format": "uint32",
                   "minimum": 0
                 },
+                "inputProvenance": {
+                  "description": "Exact reviewed owners for inputs supplied while playing this event.\n\nThis is emitted only for migrated declarations. It captures the\nplay command before later event clauses can replace the active\nprompt, which lets draft/history consumers retain the source input\nrather than borrowing a descendant's text.",
+                  "anyOf": [
+                    {
+                      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EventPlayInputProvenance"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
                 "playedWithSmuggle": {
                   "type": "boolean"
                 },
                 "seat": {
                   "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
+                },
+                "text": {
+                  "description": "Exact printed event declaration exposed when this public event was played.",
+                  "anyOf": [
+                    {
+                      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
                 }
               },
               "required": [
@@ -5727,6 +6179,38 @@
             "cardsRevealed"
           ]
         },
+        {
+          "description": "Public cards explicitly selected from a discard pile during ability resolution.",
+          "type": "object",
+          "properties": {
+            "cardsChosenFromDiscard": {
+              "type": "object",
+              "properties": {
+                "cardIds": {
+                  "description": "Printed card identities in command order; duplicates represent distinct copies.",
+                  "type": "array",
+                  "items": {
+                    "type": "integer",
+                    "format": "uint32",
+                    "minimum": 0
+                  }
+                },
+                "seat": {
+                  "description": "Player who made the selection, which may differ from the discard-pile owner.",
+                  "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
+                }
+              },
+              "required": [
+                "seat",
+                "cardIds"
+              ]
+            }
+          },
+          "additionalProperties": false,
+          "required": [
+            "cardsChosenFromDiscard"
+          ]
+        },
         {
           "type": "object",
           "properties": {
@@ -5919,6 +6403,17 @@
                   "items": {
                     "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/AbilityTarget"
                   }
+                },
+                "text": {
+                  "description": "Exact public Action or Epic Action declaration that was used.",
+                  "anyOf": [
+                    {
+                      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
                 }
               },
               "required": [
@@ -5958,6 +6453,17 @@
                   "format": "uint64",
                   "minimum": 0
                 },
+                "text": {
+                  "description": "Exact public trigger declaration and currently resolved effect.",
+                  "anyOf": [
+                    {
+                      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
                 "window": {
                   "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/AbilityWindow"
                 }
@@ -7704,11 +8210,32 @@
         "label": {
           "type": "string"
         },
+        "modeChoice": {
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/ModeChoiceView"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "targetGroups": {
           "type": "array",
           "items": {
             "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/TargetSelectionGroup"
           }
+        },
+        "text": {
+          "description": "Reviewed declaration text for a migrated leader action.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+            },
+            {
+              "type": "null"
+            }
+          ]
         }
       },
       "required": [
@@ -8488,6 +9015,38 @@
         "draftedCardCount"
       ]
     },
+    "LimitedLobbyTimerSettings": {
+      "description": "Limited-event timing controls owned by a lobby host.",
+      "type": "object",
+      "properties": {
+        "deckBuildingSeconds": {
+          "description": "Deck construction duration in seconds.",
+          "type": "integer",
+          "format": "uint16",
+          "maximum": 65535,
+          "minimum": 0
+        },
+        "deckBuildingTimerEnabled": {
+          "description": "Enables informational deck construction deadline displays.",
+          "type": "boolean"
+        },
+        "draft": {
+          "description": "Draft-only pick and review schedule. Sealed lobbies omit it.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/DraftLobbyTimerSettings"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "deckBuildingTimerEnabled",
+        "deckBuildingSeconds"
+      ]
+    },
     "LimitedPackCardView": {
       "description": "One generated pack card plus collation metadata.",
       "type": "object",
@@ -8795,6 +9354,30 @@
         }
       }
     },
+    "LobbyGameTimerSettings": {
+      "description": "Per-game clock values shared by constructed and Limited lobbies.",
+      "type": "object",
+      "properties": {
+        "reserveSeconds": {
+          "description": "Seconds of reserve time granted to each player.",
+          "type": "integer",
+          "format": "uint16",
+          "maximum": 65535,
+          "minimum": 0
+        },
+        "turnSeconds": {
+          "description": "Seconds allocated to each normal turn before reserve is used.",
+          "type": "integer",
+          "format": "uint16",
+          "maximum": 65535,
+          "minimum": 0
+        }
+      },
+      "required": [
+        "turnSeconds",
+        "reserveSeconds"
+      ]
+    },
     "LobbyKickedPayload": {
       "type": "object",
       "properties": {
@@ -9204,6 +9787,17 @@
         "status": {
           "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbyStatus"
         },
+        "timerSettings": {
+          "description": "Host-selected timer schedule for this lobby. Missing values identify\nrecords created before configurable timers were introduced.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbyTimerSettings"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "visibility": {
           "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbyVisibility"
         }
@@ -9325,6 +9919,30 @@
         "closed"
       ]
     },
+    "LobbyTimerSettings": {
+      "description": "Host-selected timing rules for a lobby and its started event or match.",
+      "type": "object",
+      "properties": {
+        "game": {
+          "description": "Per-turn and reserve-bank settings for the final game.",
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbyGameTimerSettings"
+        },
+        "limited": {
+          "description": "Limited-only draft and deck-construction settings.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LimitedLobbyTimerSettings"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "game"
+      ]
+    },
     "LobbyVisibility": {
       "type": "string",
       "enum": [
@@ -10425,6 +11043,17 @@
           "type": "integer",
           "format": "uint32",
           "minimum": 0
+        },
+        "text": {
+          "description": "Reviewed printed text owning this chooser payload.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+            },
+            {
+              "type": "null"
+            }
+          ]
         }
       },
       "required": [
@@ -10505,6 +11134,17 @@
           "type": "integer",
           "format": "uint32",
           "minimum": 0
+        },
+        "text": {
+          "description": "Reviewed printed text owning this chooser payload.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+            },
+            {
+              "type": "null"
+            }
+          ]
         }
       },
       "required": [
@@ -10610,6 +11250,17 @@
           "type": "integer",
           "format": "uint32",
           "minimum": 0
+        },
+        "text": {
+          "description": "Reviewed printed text owning this private chooser payload.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+            },
+            {
+              "type": "null"
+            }
+          ]
         }
       },
       "required": [
@@ -10724,6 +11375,20 @@
             "type": "string"
           }
         },
+        "optionTextReferences": {
+          "description": "Reviewed printed text for each matching mode option.\n\nIndex aligns with `option_labels`; `None` denotes an engine/system\noption rather than inferred prose.",
+          "type": "array",
+          "items": {
+            "anyOf": [
+              {
+                "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/CardTextRef"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
         "promptProvenance": {
           "description": "Parent/stage identity and interaction policy inherited from resolution.",
           "anyOf": [
@@ -10739,6 +11404,17 @@
           "type": "integer",
           "format": "uint32",
           "minimum": 0
+        },
+        "text": {
+          "description": "Reviewed printed text owning this chooser payload.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+            },
+            {
+              "type": "null"
+            }
+          ]
         }
       },
       "required": [
@@ -10789,6 +11465,17 @@
           "type": "integer",
           "format": "uint32",
           "minimum": 0
+        },
+        "text": {
+          "description": "Reviewed printed text owning this chooser payload.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+            },
+            {
+              "type": "null"
+            }
+          ]
         }
       },
       "required": [
@@ -10814,6 +11501,17 @@
           "type": "integer",
           "format": "uint32",
           "minimum": 0
+        },
+        "text": {
+          "description": "Reviewed text retained by the queued ability when its producer made it\npublic. The order prompt does not infer ownership from source cards.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+            },
+            {
+              "type": "null"
+            }
+          ]
         }
       },
       "required": [
@@ -10965,6 +11663,17 @@
           "description": "Complete target-selection contract for this pending ability.\n\nGroups retain ordering, bounds, and structural purpose together.",
           "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/TargetSelectionPlanView"
         },
+        "text": {
+          "description": "Reviewed printed ability, selected mode, and current effect ownership.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "window": {
           "description": "Trigger window this ability was collected in.\n\nPart of the ability's stable identity: with `source_card_id`,\n`source_unit_id`, `clause_id`, and `family` it addresses one queued\nability without depending on queue position.",
           "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/AbilityWindow"
@@ -11158,6 +11867,17 @@
           "format": "uint32",
           "minimum": 0
         },
+        "text": {
+          "description": "Reviewed printed text owning this chooser payload.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "title": {
           "type": "string"
         },
@@ -11373,6 +12093,16 @@
         "label": {
           "type": "string"
         },
+        "modeChoice": {
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/ModeChoiceView"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "seat": {
           "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
         },
@@ -11384,6 +12114,17 @@
           "items": {
             "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/TargetSelectionGroup"
           }
+        },
+        "text": {
+          "description": "Exact public Action or Epic Action declaration when migrated.",
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/EffectTextRefsView"
+            },
+            {
+              "type": "null"
+            }
+          ]
         }
       },
       "required": [
@@ -13188,6 +13929,344 @@
         "available"
       ]
     },
+    "SimulatorMessage": {
+      "description": "Typed engine-origin simulator copy with a stable SDK message id.",
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "abilityUnavailable"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "action.exhaust"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "count": {
+              "type": "integer",
+              "format": "int64",
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991
+            },
+            "kind": {
+              "type": "string",
+              "const": "amount.resources"
+            }
+          },
+          "required": [
+            "kind",
+            "count"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "choice.none"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "chooseTarget"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "chooseTargets"
+            },
+            "max": {
+              "type": "integer",
+              "format": "int64",
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991
+            },
+            "min": {
+              "type": "integer",
+              "format": "int64",
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991
+            }
+          },
+          "required": [
+            "kind",
+            "min",
+            "max"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "controls.cancel"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "controls.confirm"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "controls.decline"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "controls.done"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "duration.phase"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "count": {
+              "type": "integer",
+              "format": "int64",
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991
+            },
+            "kind": {
+              "type": "string",
+              "const": "duration.rounds"
+            }
+          },
+          "required": [
+            "kind",
+            "count"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "keyword": {
+              "type": "string"
+            },
+            "kind": {
+              "type": "string",
+              "const": "keyword.name"
+            }
+          },
+          "required": [
+            "kind",
+            "keyword"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "keyword.overwhelm"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "keyword.raid"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "keyword.sentinel"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "legacyText"
+            },
+            "text": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "kind",
+            "text"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "targetPurpose.attachUpgrade"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "targetPurpose.chooseTarget"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "amount": {
+              "type": "integer",
+              "format": "int64",
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991
+            },
+            "kind": {
+              "type": "string",
+              "const": "targetPurpose.dealDamage"
+            }
+          },
+          "required": [
+            "kind",
+            "amount"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "amount": {
+              "type": "integer",
+              "format": "int64",
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991
+            },
+            "kind": {
+              "type": "string",
+              "const": "targetPurpose.giveShield"
+            }
+          },
+          "required": [
+            "kind",
+            "amount"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "amount": {
+              "type": "integer",
+              "format": "int64",
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991
+            },
+            "kind": {
+              "type": "string",
+              "const": "targetPurpose.heal"
+            }
+          },
+          "required": [
+            "kind",
+            "amount"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "timing.onceEachRound"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        }
+      ]
+    },
     "SimulatorReportResponse": {
       "description": "Full sanitized support bundle returned only by the simulator admin API.",
       "type": "object",
@@ -14071,6 +15150,13 @@
             }
           ]
         },
+        "textReferences": {
+          "description": "Reviewed printed text that produced this exact group.\n\nReferences are locale-neutral and preserve nested printed-effect\nownership without placing card prose in public match state.",
+          "type": "array",
+          "items": {
+            "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/CardTextRef"
+          }
+        },
         "validTargets": {
           "type": "array",
           "items": {
@@ -14157,6 +15243,11 @@
         "host": {
           "type": "boolean"
         },
+        "isAi": {
+          "description": "Whether server automation permanently controls this participant.",
+          "type": "boolean",
+          "default": false
+        },
         "joinedAtMs": {
           "type": "integer",
           "format": "uint64",