@my-swu/simulator-client 0.1.4 → 0.1.5

package/dist/generated/schemas.js

@@ -103,6 +103,9 @@ export const schemaNames = [
     'rematch-match-response',
     'set-ai-paused-request',
     'set-ai-paused-response',
+    'set-playground-ai-seat-request',
+    'playground-export-payload',
+    'create-playground-share-response',
     'get-match-response',
     'match-history-list-request',
     'match-history-list-response',
@@ -1208,6 +1211,184 @@ export const sdkSchemaCommon = {
                 "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": [
@@ -1299,6 +1480,9 @@ export const sdkSchemaCommon = {
         "AiSeatStatusPayload": {
             "type": "object",
             "properties": {
+                "difficulty": {
+                    "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/AiDifficulty"
+                },
                 "paused": {
                     "type": "boolean"
                 },
@@ -1312,6 +1496,7 @@ export const sdkSchemaCommon = {
             "required": [
                 "seat",
                 "paused",
+                "difficulty",
                 "trilogyFormatMode"
             ]
         },
@@ -4185,6 +4370,26 @@ export const sdkSchemaCommon = {
                         "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": {
@@ -7178,6 +7383,21 @@ export const sdkSchemaCommon = {
                         "$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"
                 },
@@ -9743,6 +9963,14 @@ export const sdkSchemaCommon = {
             "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",
@@ -9858,6 +10086,14 @@ export const sdkSchemaCommon = {
                     "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",
@@ -11353,6 +11589,244 @@ export const sdkSchemaCommon = {
                 }
             ]
         },
+        "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": [
@@ -13249,6 +13723,26 @@ export const sdkSchemaCommon = {
                         "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",
@@ -15712,6 +16206,11 @@ export const sdkSchemas = {
                 "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": [
@@ -17959,6 +18458,90 @@ export const sdkSchemas = {
             "seats"
         ]
     },
+    'set-playground-ai-seat-request': {
+        "$schema": "https://json-schema.org/draft/2020-12/schema",
+        "title": "SetPlaygroundAiSeatRequest",
+        "description": "Host-authored AI controller settings for one Playground seat.",
+        "type": "object",
+        "properties": {
+            "difficulty": {
+                "description": "`None` removes the AI controller from this seat.",
+                "anyOf": [
+                    {
+                        "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/AiDifficulty"
+                    },
+                    {
+                        "type": "null"
+                    }
+                ]
+            },
+            "paused": {
+                "description": "Manual per-seat pause state. Ignored when `difficulty` is `None`.",
+                "type": "boolean"
+            },
+            "seat": {
+                "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
+            },
+            "seatToken": {
+                "type": "string"
+            }
+        },
+        "additionalProperties": false,
+        "required": [
+            "seatToken",
+            "seat",
+            "difficulty",
+            "paused"
+        ]
+    },
+    'playground-export-payload': {
+        "$schema": "https://json-schema.org/draft/2020-12/schema",
+        "title": "PlaygroundExportPayload",
+        "description": "Portable Playground file. `restore_token` is a dedicated capability and\nnever contains a live match seat token.",
+        "type": "object",
+        "properties": {
+            "restoreToken": {
+                "type": "string"
+            },
+            "save": {
+                "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/MatchSavePayload"
+            },
+            "version": {
+                "type": "integer",
+                "format": "uint8",
+                "maximum": 1,
+                "minimum": 1
+            }
+        },
+        "additionalProperties": false,
+        "required": [
+            "version",
+            "save",
+            "restoreToken"
+        ]
+    },
+    'create-playground-share-response': {
+        "$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"
+        ]
+    },
     'get-match-response': {
         "$schema": "https://json-schema.org/draft/2020-12/schema",
         "title": "GetMatchResponse",
@@ -18898,6 +19481,26 @@ export const sdkSchemas = {
                     "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": {
@@ -21895,6 +22498,21 @@ export const sdkSchemas = {
                     "$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"
             },
@@ -22110,6 +22728,14 @@ export const sdkSchemas = {
                 "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",