feat(engine): publish and validate a bounded loop shortcut's own declaration

client/src/adapter/generated/interaction/index.ts

@@ -83,6 +83,12 @@ export type InteractionDamageAssignmentMode = "normal" | "asThoughUnblocked";
 
 export type InteractionShortcutCountSpec = { "type": "fixed", "data": { min: number, max: number, suggested: number, } } | { "type": "untilLethal" };
 
+export type InteractionShortcutPreviewFamily = "mana" | "life" | "damage" | "mill" | "counters" | "tokens" | "cards" | "casts" | "combats" | "turns" | "triggers";
+
+export type InteractionShortcutPreviewEntry = { family: InteractionShortcutPreviewFamily, player: number | null, amount: number, };
+
+export type InteractionShortcutPreview = { count: number, entries: Array<InteractionShortcutPreviewEntry>, };
+
 export type InteractionShortcutPointKind = "targets" | "convokeTaps" | "mode" | "mayChoice" | "unlessBreak" | "manaColor";
 
 export type InteractionShortcutPoint = { group: number, kind: InteractionShortcutPointKind, min: number, max: number, unique: boolean, ordered: boolean, readOnly: boolean, candidateIds: Array<InteractionChoiceId>, };
@@ -93,7 +99,7 @@ export type InteractionShortcutDecision = { "type": "decline" } | { "type": "acc
 
 export type InteractionShortcutReply = { "type": "accept" } | { "type": "shorten", "data": { atIteration: number, } };
 
-export type InteractionResponseSpec = { "type": "select", "data": { constraint: SelectionConstraint, confirm: ConfirmSemantics, } } | { "type": "assignAmounts", "data": { minTotal: number, maxTotal: number, exactTotal: number | null, } } | { "type": "assignDamage", "data": { total: number, modes: Array<InteractionDamageAssignmentMode>, confirm: ConfirmSemantics, } } | { "type": "sequence", "data": { min: number, max: number, unique: boolean, includeAll: boolean, engineValidated: boolean, escape: InteractionChoiceId | null, confirm: ConfirmSemantics, } } | { "type": "groupedSequence", "data": { groups: Array<InteractionGroupConstraint>, unique: boolean, confirm: ConfirmSemantics, } } | { "type": "manaGroups", "data": { groups: Array<InteractionGroupConstraint>, maxBatch: number, escape: InteractionChoiceId | null, confirm: ConfirmSemantics, } } | { "type": "text", "data": { allowArbitrary: boolean, maxLen: number, confirm: ConfirmSemantics, } } | { "type": "deckPartition", "data": { minMainTotal: number, maxMainTotal: number, confirm: ConfirmSemantics, } } | { "type": "relations", "data": { edges: Array<InteractionRelationConstraint>, min: number, max: number, sourceConstraint: InteractionRelationSourceConstraint, allowGroups: boolean, confirm: ConfirmSemantics, } } | { "type": "number", "data": { min: number, max: number, confirm: ConfirmSemantics, } } | { "type": "shortcut", "data": { count: InteractionShortcutCountSpec, points: Array<InteractionShortcutPoint>, allowDecline: boolean, confirm: ConfirmSemantics, } } | { "type": "shortcutReply", "data": { minIteration: number, maxIteration: number, confirm: ConfirmSemantics, } };
+export type InteractionResponseSpec = { "type": "select", "data": { constraint: SelectionConstraint, confirm: ConfirmSemantics, } } | { "type": "assignAmounts", "data": { minTotal: number, maxTotal: number, exactTotal: number | null, } } | { "type": "assignDamage", "data": { total: number, modes: Array<InteractionDamageAssignmentMode>, confirm: ConfirmSemantics, } } | { "type": "sequence", "data": { min: number, max: number, unique: boolean, includeAll: boolean, engineValidated: boolean, escape: InteractionChoiceId | null, confirm: ConfirmSemantics, } } | { "type": "groupedSequence", "data": { groups: Array<InteractionGroupConstraint>, unique: boolean, confirm: ConfirmSemantics, } } | { "type": "manaGroups", "data": { groups: Array<InteractionGroupConstraint>, maxBatch: number, escape: InteractionChoiceId | null, confirm: ConfirmSemantics, } } | { "type": "text", "data": { allowArbitrary: boolean, maxLen: number, confirm: ConfirmSemantics, } } | { "type": "deckPartition", "data": { minMainTotal: number, maxMainTotal: number, confirm: ConfirmSemantics, } } | { "type": "relations", "data": { edges: Array<InteractionRelationConstraint>, min: number, max: number, sourceConstraint: InteractionRelationSourceConstraint, allowGroups: boolean, confirm: ConfirmSemantics, } } | { "type": "number", "data": { min: number, max: number, confirm: ConfirmSemantics, } } | { "type": "shortcut", "data": { count: InteractionShortcutCountSpec, points: Array<InteractionShortcutPoint>, allowDecline: boolean, preview: InteractionShortcutPreview | null, confirm: ConfirmSemantics, } } | { "type": "shortcutReply", "data": { minIteration: number, maxIteration: number, confirm: ConfirmSemantics, } };
 
 export type InteractionOpportunityResponse = { "type": "exactChoices", "data": { choices: Array<InteractionChoice>, } } | { "type": "schema", "data": { spec: InteractionResponseSpec, candidates: Array<InteractionChoice>, } };
 

client/src/adapter/ws-adapter.ts

@@ -203,6 +203,24 @@ export class NativeEngineVersionMismatchError extends Error {
  * `crates/server-core/src/protocol.rs`. Bump in lockstep when either side
  * adds, removes, renames, or changes the type of a protocol variant field.
  *
+ * 31 — WaitingFor::LoopShortcut publishes the engine-issued declaration, and
+ *      InteractionResponseSpec::Shortcut publishes preview, the per-axis
+ *      consequence of the offered count. Both are optional and neither type
+ *      sets deny_unknown_fields, so a v30 peer still PARSES the frame — a
+ *      capability bump like 24, not a parse bump. UNLIKE 24, no pairing is left
+ *      for the capability gap to bite in, so this entry names no silent-drop
+ *      hazard: full-game floors are exact-match on BOTH sides
+ *      (MIN_SUPPORTED_SERVER_PROTOCOL below, and MIN_SUPPORTED_PROTOCOL in
+ *      crates/server-core/src/protocol.rs, each equal to their own
+ *      PROTOCOL_VERSION), so a v31/v30 full-game pair is refused at the
+ *      handshake and never sends an action frame. The one-version window that
+ *      does exist is lobby-only (LOBBY_MIN_SUPPORTED_SERVER_PROTOCOL below /
+ *      MIN_SUPPORTED_PROTOCOL in crates/lobby-broker/src/protocol.rs) and it
+ *      cannot carry this capability either: DeclareShortcut rides
+ *      ClientMessage::Action, which LobbyClientMessage has no variant for at
+ *      all, and which reject_if_disabled in crates/phase-server/src/main.rs
+ *      answers under ServerMode::LobbyOnly with an explicit rejection rather
+ *      than a silent drop.
  * 30 — Serialized player-action completion provenance and modal continuations.
  * 29 — Added requester-correlated ResolveAllRejected response frames.
  * 28 — Added native ResolveAll request/result frames.
@@ -237,7 +255,7 @@ export class NativeEngineVersionMismatchError extends Error {
  *      into a MulliganDecisionPhase::BottomCards sub-phase on
  *      WaitingFor::MulliganDecision.
  */
-export const PROTOCOL_VERSION = 30;
+export const PROTOCOL_VERSION = 31;
 
 /**
  * Lowest server protocol version this client will accept in the handshake.

client/src/components/hud/HudBadges.tsx

@@ -444,7 +444,10 @@ const UNBOUNDED_FAMILY_GLYPH: Record<UnboundedFamily, string> = {
   triggers: "✴",
 };
 
-const UNBOUNDED_FAMILY_LABEL_KEY: Record<UnboundedFamily, string> = {
+/** Exported for `LoopShortcutModal`'s preview lines: the engine's
+ *  `InteractionShortcutPreviewFamily` is the same 11 literals as `UnboundedFamily`, so the preview
+ *  reuses these labels instead of minting a parallel 11-key catalog in 7 locales. */
+export const UNBOUNDED_FAMILY_LABEL_KEY: Record<UnboundedFamily, string> = {
   mana: "badges.unboundedMana",
   life: "badges.unboundedLife",
   damage: "badges.unboundedDamage",