@my-swu/simulator-client 0.1.4 → 0.1.5

package/schema/common.schema.json

@@ -1061,6 +1061,184 @@
         "replayAvailable"
       ]
     },
+    "AiDecisionDiagnostic": {
+      "description": "One AI decision's search-budget diagnostics, safe for durable storage.",
+      "type": "object",
+      "properties": {
+        "abilityId": {
+          "description": "Pending ability the chosen command answered, when applicable.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint64",
+          "minimum": 0
+        },
+        "commandKind": {
+          "description": "Privacy-safe chosen-command shape: snake_case command kind only.",
+          "type": "string"
+        },
+        "difficulty": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/AiDifficulty"
+        },
+        "elapsedMs": {
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        },
+        "eventsApplied": {
+          "description": "Engine event counter of the searched state; exact cross-check key.",
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        },
+        "frameIndex": {
+          "description": "Index of the replay frame this decision was made on (the state BEFORE\nthe chosen command applied). `None` when no frame was recorded yet.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint32",
+          "minimum": 0
+        },
+        "hardFloorOverrun": {
+          "description": "Whether the minimum-iteration floor pushed past the wall-clock budget.",
+          "type": "boolean"
+        },
+        "iterationCeiling": {
+          "description": "Idle-stretch ceiling granted for this decision, when one was.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint32",
+          "minimum": 0
+        },
+        "iterationsBudget": {
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0
+        },
+        "iterationsDone": {
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0
+        },
+        "legalCount": {
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0
+        },
+        "minIterations": {
+          "description": "Minimum-iteration floor the search guarantees past the wall clock.",
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0
+        },
+        "queueMs": {
+          "description": "Time spent waiting for scheduler admission before the search started.",
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        },
+        "schedulerIdle": {
+          "description": "Whether the AI scheduler was idle when this decision was admitted.",
+          "type": "boolean"
+        },
+        "searchMode": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/AiDecisionSearchMode"
+        },
+        "seat": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
+        },
+        "snapshotRevision": {
+          "description": "Gameplay snapshot marker the searched state carried. An undo between\nsearch and record makes this disagree with the frame at `frame_index`.",
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        },
+        "sourceCardId": {
+          "description": "Public source card of that pending ability, when applicable.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint32",
+          "minimum": 0
+        },
+        "starvationFallback": {
+          "description": "The starved-search guard discarded the search result entirely and\nanswered from a one-ply heuristic ranking instead.",
+          "type": "boolean"
+        },
+        "starved": {
+          "description": "Starved search: the wall clock cut the decision at (or below) its\nminimum-iteration floor, so the move rests on noise-level visit\ncounts. Any blunder on a starved decision is explained first by this\nflag, not by enumeration or evaluation defects.",
+          "type": "boolean"
+        },
+        "timeBudgetMs": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint32",
+          "minimum": 0
+        },
+        "timeLimited": {
+          "description": "Whether the wall clock cut the search before its iteration budget.",
+          "type": "boolean"
+        },
+        "workersCompleted": {
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0
+        },
+        "workersRequested": {
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "seat",
+        "difficulty",
+        "snapshotRevision",
+        "eventsApplied",
+        "searchMode",
+        "commandKind",
+        "queueMs",
+        "elapsedMs",
+        "iterationsDone",
+        "iterationsBudget",
+        "minIterations",
+        "workersRequested",
+        "workersCompleted",
+        "schedulerIdle",
+        "legalCount",
+        "timeLimited",
+        "hardFloorOverrun",
+        "starved",
+        "starvationFallback"
+      ]
+    },
+    "AiDecisionSearchMode": {
+      "description": "Decision algorithm that produced one recorded AI choice.",
+      "oneOf": [
+        {
+          "description": "Normal MCTS root search.",
+          "type": "string",
+          "const": "mcts"
+        },
+        {
+          "description": "One-ply evaluation of every legal setup choice.",
+          "type": "string",
+          "const": "setupEvaluator"
+        },
+        {
+          "description": "A single legal action or another constant-time guard selected the move.",
+          "type": "string",
+          "const": "fastPath"
+        }
+      ]
+    },
     "AiDifficulty": {
       "description": "Public difficulty presets. Internal tuning (iteration counts, time\nbudgets) lives in `crate::r#match::registry::ai_factory` so it can be\nadjusted without changing the SDK surface.",
       "oneOf": [
@@ -1152,6 +1330,9 @@
     "AiSeatStatusPayload": {
       "type": "object",
       "properties": {
+        "difficulty": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/AiDifficulty"
+        },
         "paused": {
           "type": "boolean"
         },
@@ -1165,6 +1346,7 @@
       "required": [
         "seat",
         "paused",
+        "difficulty",
         "trilogyFormatMode"
       ]
     },
@@ -4038,6 +4220,26 @@
             "concede"
           ]
         },
+        {
+          "type": "object",
+          "properties": {
+            "playground": {
+              "type": "object",
+              "properties": {
+                "command": {
+                  "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/PlaygroundCommand"
+                }
+              },
+              "required": [
+                "command"
+              ]
+            }
+          },
+          "additionalProperties": false,
+          "required": [
+            "playground"
+          ]
+        },
         {
           "type": "object",
           "properties": {
@@ -7031,6 +7233,21 @@
             "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/SeatState"
           }
         },
+        "playground": {
+          "description": "Whether this snapshot belongs to a server-authorized Playground match.",
+          "type": "boolean",
+          "default": false
+        },
+        "playgroundDeckCardIds": {
+          "description": "Printed cards supplied by every configured Playground deck.",
+          "type": "array",
+          "default": [],
+          "items": {
+            "type": "integer",
+            "format": "uint32",
+            "minimum": 0
+          }
+        },
         "prompt": {
           "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/PromptState"
         },
@@ -9596,6 +9813,14 @@
       "description": "Safe completed-series replay archive. `frames` never contains private zones;\n`revealed_frames` is returned only after both completion and ownership checks.",
       "type": "object",
       "properties": {
+        "aiDecisions": {
+          "description": "Per-AI-decision search diagnostics (budget, workers, starvation), in\ndecision order. Additive: older archives decode with an empty list.",
+          "type": "array",
+          "default": [],
+          "items": {
+            "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/AiDecisionDiagnostic"
+          }
+        },
         "frameEvents": {
           "description": "Events folded into each matching replay frame. Older archives decode\nwithout this additive field and remain playable without captions.",
           "type": "array",
@@ -9711,6 +9936,14 @@
           "description": "Whether AI was manually paused when this snapshot was captured.",
           "type": "boolean"
         },
+        "aiPausedSeats": {
+          "description": "Exact manually paused AI seats. Empty payloads from older clients use\n`ai_paused` as the all-seat compatibility fallback.",
+          "type": "array",
+          "default": [],
+          "items": {
+            "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
+          }
+        },
         "copiedCards": {
           "description": "Wire mirror of the [`UnitState::copied_card`] Arcs that the inner\nstate could not embed. Keyed by `unit.instance_id`. Empty when no\nactive unit has a copied card.",
           "type": "array",
@@ -11206,6 +11439,244 @@
         }
       ]
     },
+    "PlaygroundCommand": {
+      "description": "Host-authorized raw scenario mutation for a Playground match.",
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "card_ids": {
+              "type": "array",
+              "items": {
+                "type": "integer",
+                "format": "uint32",
+                "minimum": 0
+              }
+            },
+            "seat": {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
+            },
+            "type": {
+              "type": "string",
+              "const": "setDrawQueue"
+            }
+          },
+          "required": [
+            "type",
+            "seat",
+            "card_ids"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "attachedToUnitId": {
+              "type": [
+                "integer",
+                "null"
+              ],
+              "format": "uint64",
+              "minimum": 0
+            },
+            "cardId": {
+              "type": "integer",
+              "format": "uint32",
+              "minimum": 0
+            },
+            "seat": {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
+            },
+            "type": {
+              "type": "string",
+              "const": "putCardInPlay"
+            }
+          },
+          "required": [
+            "type",
+            "seat",
+            "cardId"
+          ]
+        },
+        {
+          "description": "Plays a minted hand card without paying its resource cost, preserving\nnormal play triggers and restrictions.",
+          "type": "object",
+          "properties": {
+            "attachedToUnitId": {
+              "type": [
+                "integer",
+                "null"
+              ],
+              "format": "uint64",
+              "minimum": 0
+            },
+            "cardId": {
+              "type": "integer",
+              "format": "uint32",
+              "minimum": 0
+            },
+            "seat": {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
+            },
+            "type": {
+              "type": "string",
+              "const": "playCardForFree"
+            }
+          },
+          "required": [
+            "type",
+            "seat",
+            "cardId"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "amount": {
+              "type": "integer",
+              "format": "int16",
+              "maximum": 32767,
+              "minimum": -32768
+            },
+            "target": {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/PlaygroundDamageTarget"
+            },
+            "type": {
+              "type": "string",
+              "const": "setDamage"
+            }
+          },
+          "required": [
+            "type",
+            "target",
+            "amount"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "target": {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/PlaygroundDefeatTarget"
+            },
+            "type": {
+              "type": "string",
+              "const": "defeatCard"
+            }
+          },
+          "required": [
+            "type",
+            "target"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "captorUnitId": {
+              "type": "integer",
+              "format": "uint64",
+              "minimum": 0
+            },
+            "cardId": {
+              "type": "integer",
+              "format": "uint32",
+              "minimum": 0
+            },
+            "ownerSeat": {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
+            },
+            "type": {
+              "type": "string",
+              "const": "captureCard"
+            }
+          },
+          "required": [
+            "type",
+            "ownerSeat",
+            "cardId",
+            "captorUnitId"
+          ]
+        }
+      ]
+    },
+    "PlaygroundDamageTarget": {
+      "description": "One board target whose damage counter Playground may set exactly.",
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "seat": {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
+            },
+            "type": {
+              "type": "string",
+              "const": "base"
+            }
+          },
+          "required": [
+            "type",
+            "seat"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "unit"
+            },
+            "unit_id": {
+              "type": "integer",
+              "format": "uint64",
+              "minimum": 0
+            }
+          },
+          "required": [
+            "type",
+            "unit_id"
+          ]
+        }
+      ]
+    },
+    "PlaygroundDefeatTarget": {
+      "description": "One in-play card Playground may defeat through normal leave-play handling.",
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "unit"
+            },
+            "unit_id": {
+              "type": "integer",
+              "format": "uint64",
+              "minimum": 0
+            }
+          },
+          "required": [
+            "type",
+            "unit_id"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "upgrade"
+            },
+            "upgrade_id": {
+              "type": "integer",
+              "format": "uint64",
+              "minimum": 0
+            }
+          },
+          "required": [
+            "type",
+            "upgrade_id"
+          ]
+        }
+      ]
+    },
     "PresenceFilter": {
       "type": "string",
       "enum": [
@@ -13102,6 +13573,26 @@
             "kind"
           ]
         },
+        {
+          "description": "Pay the stated number of resources for each selected unit instead of\napplying the accompanying exhaustion instruction.",
+          "type": "object",
+          "properties": {
+            "amount": {
+              "type": "integer",
+              "format": "uint8",
+              "maximum": 255,
+              "minimum": 0
+            },
+            "kind": {
+              "type": "string",
+              "const": "payToAvoidExhaust"
+            }
+          },
+          "required": [
+            "kind",
+            "amount"
+          ]
+        },
         {
           "description": "Ready the selected unit(s).",
           "type": "object",

package/schema/create-match-request.schema.json

@@ -90,6 +90,11 @@
       "maximum": 255,
       "minimum": 0
     },
+    "playground": {
+      "description": "Enables the server-owned scenario Playground runtime. Normal matches\nretain the default and never accept Playground mutations.",
+      "type": "boolean",
+      "default": false
+    },
     "scenario": {
       "description": "Optional authored scenario selector for direct Learn match creation.",
       "anyOf": [

package/schema/create-playground-share-response.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "CreatePlaygroundShareResponse",
+  "description": "Opaque 30-day Playground share capability.",
+  "type": "object",
+  "properties": {
+    "expiresAtMs": {
+      "type": "integer",
+      "format": "uint64",
+      "minimum": 0
+    },
+    "shareToken": {
+      "type": "string",
+      "format": "uuid"
+    }
+  },
+  "additionalProperties": false,
+  "required": [
+    "shareToken",
+    "expiresAtMs"
+  ]
+}

package/schema/game-command.schema.json

@@ -11,6 +11,26 @@
         "concede"
       ]
     },
+    {
+      "type": "object",
+      "properties": {
+        "playground": {
+          "type": "object",
+          "properties": {
+            "command": {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/PlaygroundCommand"
+            }
+          },
+          "required": [
+            "command"
+          ]
+        }
+      },
+      "additionalProperties": false,
+      "required": [
+        "playground"
+      ]
+    },
     {
       "type": "object",
       "properties": {

package/schema/game-state.schema.json

@@ -165,6 +165,21 @@
         "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/SeatState"
       }
     },
+    "playground": {
+      "description": "Whether this snapshot belongs to a server-authorized Playground match.",
+      "type": "boolean",
+      "default": false
+    },
+    "playgroundDeckCardIds": {
+      "description": "Printed cards supplied by every configured Playground deck.",
+      "type": "array",
+      "default": [],
+      "items": {
+        "type": "integer",
+        "format": "uint32",
+        "minimum": 0
+      }
+    },
     "prompt": {
       "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/PromptState"
     },

package/schema/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "e4a6c8c3043fdb5779d215ad8f673458da5a45bd6d196f0dbd5cc721aa189045",
+  "version": "0ae978dcaa4b3cbec5778eb3174a0126f642b3d441a76d97dc48044416d4ae06",
   "files": [
     "admin-match-list-response.schema.json",
     "admin-match-debug-bundle.schema.json",
@@ -96,6 +96,9 @@
     "rematch-match-response.schema.json",
     "set-ai-paused-request.schema.json",
     "set-ai-paused-response.schema.json",
+    "set-playground-ai-seat-request.schema.json",
+    "playground-export-payload.schema.json",
+    "create-playground-share-response.schema.json",
     "get-match-response.schema.json",
     "match-history-list-request.schema.json",
     "match-history-list-response.schema.json",

package/schema/match-save-payload.schema.json

@@ -15,6 +15,14 @@
       "description": "Whether AI was manually paused when this snapshot was captured.",
       "type": "boolean"
     },
+    "aiPausedSeats": {
+      "description": "Exact manually paused AI seats. Empty payloads from older clients use\n`ai_paused` as the all-seat compatibility fallback.",
+      "type": "array",
+      "default": [],
+      "items": {
+        "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
+      }
+    },
     "copiedCards": {
       "description": "Wire mirror of the [`UnitState::copied_card`] Arcs that the inner\nstate could not embed. Keyed by `unit.instance_id`. Empty when no\nactive unit has a copied card.",
       "type": "array",