@my-swu/simulator-client 0.1.4 → 0.1.6

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,29 @@
         "$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
+    },
+    "playgroundActionAbilities": {
+      "description": "Host-only Playground ability projection. Empty for normal matches and\nwhile a resolution owns the command boundary.",
+      "type": "array",
+      "default": [],
+      "items": {
+        "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/PlaygroundActionAbilityView"
+      }
+    },
+    "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": "f0334cd661de38164d34b780eea4872102c9f26c8e44630d13130a0c30054717",
   "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",
@@ -52,7 +60,7 @@
       "description": "The serialized engine state. Catalog `Arc`s are skip-default here\nand grafted on by the restore path before the state goes live.\n\nOpaque to the public schema — SDK consumers should treat this as an\nimplementation-defined object that round-trips byte-for-byte. Pinning\nevery engine sub-struct into the schema would couple the SDK type\nsurface to the entire engine, which we explicitly do not want."
     },
     "version": {
-      "description": "Wire-format version. Always [`MATCH_SAVE_VERSION`] for newly minted\npayloads; restore rejects mismatches.",
+      "description": "Wire-format version. Always [`MATCH_SAVE_VERSION`] for newly minted\npayloads; restore accepts every [`SUPPORTED_SAVE_VERSIONS`] entry and\nrejects anything else.",
       "type": "integer",
       "format": "uint8",
       "maximum": 255,

package/schema/playground-export-payload.schema.json

@@ -0,0 +1,26 @@
+{
+  "$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"
+  ]
+}

package/schema/route-manifest.json

@@ -32,6 +32,17 @@
       "method": "getGameReplay"
     }
   },
+  {
+    "operationId": "createAdminGameReplayShare",
+    "method": "POST",
+    "path": "/api/admin/games/{history_id}/replay-shares",
+    "responseSchema": "create-match-history-replay-share-response",
+    "sdk": {
+      "kind": "required",
+      "resource": "admin",
+      "method": "createGameReplayShare"
+    }
+  },
   {
     "operationId": "listSimulatorReports",
     "method": "GET",
@@ -401,6 +412,41 @@
       "method": "save"
     }
   },
+  {
+    "operationId": "match_playground_export",
+    "method": "POST",
+    "path": "/api/matches/{match_id}/playground/export",
+    "requestSchema": "save-match-request",
+    "responseSchema": "playground-export-payload",
+    "sdk": {
+      "kind": "required",
+      "resource": "matches",
+      "method": "exportPlayground"
+    }
+  },
+  {
+    "operationId": "match_playground_share_create",
+    "method": "POST",
+    "path": "/api/matches/{match_id}/playground-shares",
+    "requestSchema": "save-match-request",
+    "responseSchema": "create-playground-share-response",
+    "sdk": {
+      "kind": "required",
+      "resource": "matches",
+      "method": "createPlaygroundShare"
+    }
+  },
+  {
+    "operationId": "match_playground_share_restore",
+    "method": "POST",
+    "path": "/api/playground-shares/{share_token}/restore",
+    "responseSchema": "restore-match-save-response",
+    "sdk": {
+      "kind": "required",
+      "resource": "matches",
+      "method": "restorePlaygroundShare"
+    }
+  },
   {
     "operationId": "match_undo",
     "method": "POST",
@@ -449,6 +495,18 @@
       "method": "setAiPaused"
     }
   },
+  {
+    "operationId": "match_playground_ai_seat",
+    "method": "POST",
+    "path": "/api/matches/{match_id}/playground/ai",
+    "requestSchema": "set-playground-ai-seat-request",
+    "responseSchema": "set-ai-paused-response",
+    "sdk": {
+      "kind": "required",
+      "resource": "matches",
+      "method": "setPlaygroundAiSeat"
+    }
+  },
   {
     "operationId": "match_join",
     "method": "POST",

package/schema/set-playground-ai-seat-request.schema.json

@@ -0,0 +1,36 @@
+{
+  "$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"
+  ]
+}