@my-swu/simulator-client 0.1.2 → 0.1.3

package/schema/common.schema.json

@@ -997,6 +997,70 @@
         "description"
       ]
     },
+    "AdminMatchSummary": {
+      "description": "Compact durable match data safe for an administrator list view.",
+      "type": "object",
+      "properties": {
+        "completedAtMs": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint64",
+          "minimum": 0
+        },
+        "createdAtMs": {
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        },
+        "format": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/MatchFormat"
+        },
+        "historyId": {
+          "type": "string",
+          "format": "uuid"
+        },
+        "players": {
+          "type": "array",
+          "items": {
+            "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/MatchHistoryPlayerSummary"
+          }
+        },
+        "replayAvailable": {
+          "type": "boolean"
+        },
+        "result": true,
+        "section": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/HistorySection"
+        },
+        "series": true,
+        "sourceMatchId": {
+          "type": "string",
+          "format": "uuid"
+        },
+        "status": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/HistoryStatus"
+        },
+        "updatedAtMs": {
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "historyId",
+        "sourceMatchId",
+        "section",
+        "status",
+        "format",
+        "players",
+        "series",
+        "createdAtMs",
+        "updatedAtMs",
+        "replayAvailable"
+      ]
+    },
     "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": [
@@ -7336,6 +7400,7 @@
       "type": "string",
       "enum": [
         "completedSeries",
+        "abandoned",
         "unsupportedSection",
         "learnScenario",
         "invalidAiTopology",
@@ -7353,11 +7418,23 @@
       ]
     },
     "HistoryStatus": {
-      "description": "Durable history entry status.",
-      "type": "string",
-      "enum": [
-        "saved",
-        "result"
+      "description": "Durable history entry status.\n\nLives here rather than the `server-protocol`-gated history module because\n`MatchRuntimeRecord` embeds it in every build, including wasm and bench.",
+      "oneOf": [
+        {
+          "description": "Live checkpoint that can still be resumed when policy allows.",
+          "type": "string",
+          "const": "saved"
+        },
+        {
+          "description": "Game or series reached its ordinary terminal result.",
+          "type": "string",
+          "const": "result"
+        },
+        {
+          "description": "Host intentionally retired an unfinished Solo-versus-AI runtime.",
+          "type": "string",
+          "const": "abandoned"
+        }
       ]
     },
     "InitiativeChoiceReason": {
@@ -8890,11 +8967,9 @@
         "matchSeed": {
           "description": "Fixed match seed when configured.",
           "type": [
-            "integer",
+            "string",
             "null"
-          ],
-          "format": "uint64",
-          "minimum": 0
+          ]
         },
         "matchmaking": {
           "anyOf": [
@@ -8909,11 +8984,9 @@
         "packSeed": {
           "description": "Fixed limited pack/leader seed when configured.",
           "type": [
-            "integer",
+            "string",
             "null"
-          ],
-          "format": "uint64",
-          "minimum": 0
+          ]
         },
         "players": {
           "type": "array",
@@ -9119,9 +9192,7 @@
         },
         "replaySeed": {
           "description": "Resolved seed for a private solo-vs-AI match. Never projected in live state.",
-          "type": "integer",
-          "format": "uint64",
-          "minimum": 0
+          "type": "string"
         },
         "seat": {
           "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
@@ -9338,9 +9409,7 @@
           "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/HistorySection"
         },
         "seed": {
-          "type": "integer",
-          "format": "uint64",
-          "minimum": 0
+          "type": "string"
         },
         "series": true,
         "sourceMatchId": {
@@ -10212,6 +10281,15 @@
             }
           ]
         },
+        "revealedCardIds": {
+          "description": "Publicly revealed cards which caused this instructed attack. Omitted\nfor ordinary attacks and intentionally projected only to chooser.",
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "format": "uint32",
+            "minimum": 0
+          }
+        },
         "sourceCardId": {
           "type": "integer",
           "format": "uint32",
@@ -12487,6 +12565,81 @@
         "available"
       ]
     },
+    "SimulatorReportResponse": {
+      "description": "Full sanitized support bundle returned only by the simulator admin API.",
+      "type": "object",
+      "properties": {
+        "bundle": true,
+        "bundleAvailable": {
+          "type": "boolean"
+        },
+        "failureKind": {
+          "type": "string"
+        },
+        "firstOccurredAtMs": {
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        },
+        "matchId": {
+          "type": "string",
+          "format": "uuid"
+        },
+        "message": {
+          "type": "string"
+        },
+        "occurredAtMs": {
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        },
+        "occurrenceCount": {
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0
+        },
+        "operation": {
+          "type": "string"
+        },
+        "reportId": {
+          "type": "string",
+          "format": "uuid"
+        },
+        "seat": {
+          "anyOf": [
+            {
+              "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "snapshotRevision": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint64",
+          "minimum": 0
+        },
+        "source": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "reportId",
+        "firstOccurredAtMs",
+        "occurredAtMs",
+        "occurrenceCount",
+        "matchId",
+        "source",
+        "operation",
+        "failureKind",
+        "bundleAvailable",
+        "message"
+      ]
+    },
     "SimulatorReportSummary": {
       "description": "Metadata safe to return in administrator report lists.",
       "type": "object",
@@ -13480,20 +13633,16 @@
         "matchSeed": {
           "description": "Fixed duel match seed when configured.",
           "type": [
-            "integer",
+            "string",
             "null"
-          ],
-          "format": "uint64",
-          "minimum": 0
+          ]
         },
         "packSeed": {
           "description": "Fixed limited pack/leader seed when configured.",
           "type": [
-            "integer",
+            "string",
             "null"
-          ],
-          "format": "uint64",
-          "minimum": 0
+          ]
         },
         "players": {
           "type": "array",

package/schema/create-limited-event-request.schema.json

@@ -39,11 +39,9 @@
     "seed": {
       "description": "Optional deterministic seed for generated boosters and draft leaders.",
       "type": [
-        "integer",
+        "string",
         "null"
-      ],
-      "format": "uint64",
-      "minimum": 0
+      ]
     },
     "setCode": {
       "description": "Set code used for booster generation.",

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

@@ -37,20 +37,16 @@
     "matchSeed": {
       "description": "Optional deterministic seed reused for limited duel matches.",
       "type": [
-        "integer",
+        "string",
         "null"
-      ],
-      "format": "uint64",
-      "minimum": 0
+      ]
     },
     "packSeed": {
       "description": "Optional deterministic seed for limited pack/leader generation.",
       "type": [
-        "integer",
+        "string",
         "null"
-      ],
-      "format": "uint64",
-      "minimum": 0
+      ]
     },
     "visibility": {
       "description": "Whether the lobby should appear in public browsing surfaces.",

package/schema/create-match-history-replay-share-request.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "CreateMatchHistoryReplayShareRequest",
+  "description": "Participant-authorized request to create one permanent replay-share link.",
+  "type": "object",
+  "properties": {
+    "identities": {
+      "type": "array",
+      "items": {
+        "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/HistoryIdentityInput"
+      }
+    },
+    "includeHiddenInformation": {
+      "description": "Whether this capability may retrieve post-match private-zone views.",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "identities",
+    "includeHiddenInformation"
+  ]
+}

package/schema/create-match-history-replay-share-response.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "CreateMatchHistoryReplayShareResponse",
+  "description": "Opaque capability returned after a participant creates a replay share.",
+  "type": "object",
+  "properties": {
+    "shareToken": {
+      "type": "string",
+      "format": "uuid"
+    }
+  },
+  "required": [
+    "shareToken"
+  ]
+}

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

@@ -104,11 +104,10 @@
     "seed": {
       "description": "Optional deterministic match seed.",
       "type": [
-        "integer",
+        "string",
         "null"
       ],
-      "format": "uint64",
-      "minimum": 0
+      "default": null
     }
   },
   "additionalProperties": false,

package/schema/create-tournament-room-request.schema.json

@@ -48,20 +48,16 @@
     "matchSeed": {
       "description": "Optional deterministic seed reused for every duel table match.",
       "type": [
-        "integer",
+        "string",
         "null"
-      ],
-      "format": "uint64",
-      "minimum": 0
+      ]
     },
     "packSeed": {
       "description": "Optional deterministic seed for limited pack/leader generation.",
       "type": [
-        "integer",
+        "string",
         "null"
-      ],
-      "format": "uint64",
-      "minimum": 0
+      ]
     },
     "pickTimerEnabled": {
       "description": "Enables the per-pick countdown with auto-pick on timeout (draft only).",

package/schema/limited-event-preflight-response.schema.json

@@ -13,9 +13,7 @@
     },
     "seed": {
       "description": "Deterministic seed used by successful creation after this check.",
-      "type": "integer",
-      "format": "uint64",
-      "minimum": 0
+      "type": "string"
     }
   },
   "required": [

package/schema/manifest.json

@@ -1,6 +1,9 @@
 {
-  "version": "ab26122fba623256a421399b458338eb67af059d2240ba7b1594c6116d6fc030",
+  "version": "e4a6c8c3043fdb5779d215ad8f673458da5a45bd6d196f0dbd5cc721aa189045",
   "files": [
+    "admin-match-list-response.schema.json",
+    "admin-match-debug-bundle.schema.json",
+    "admin-match-replay-response.schema.json",
     "simulator-report-list-response.schema.json",
     "simulator-report-response.schema.json",
     "health-response.schema.json",
@@ -101,9 +104,16 @@
     "match-history-entry.schema.json",
     "match-history-replay-request.schema.json",
     "match-history-replay-response.schema.json",
+    "create-match-history-replay-share-request.schema.json",
+    "create-match-history-replay-share-response.schema.json",
+    "shared-match-history-replay-response.schema.json",
     "match-chat-lookup-response.schema.json",
     "match-history-restore-request.schema.json",
     "restore-history-response.schema.json",
+    "match-recovery-request.schema.json",
+    "match-recovery-response.schema.json",
+    "match-access-recovery-request.schema.json",
+    "match-access-recovery-response.schema.json",
     "cards-response.schema.json",
     "resolve-card-ids-request.schema.json",
     "resolve-card-ids-response.schema.json",

package/schema/match-access-recovery-request.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MatchAccessRecoveryRequest",
+  "description": "Ownership proof used to recover current access for one live Solo-versus-AI\nmatch when browser-stored seat credentials are stale.",
+  "type": "object",
+  "properties": {
+    "identities": {
+      "type": "array",
+      "items": {
+        "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/HistoryIdentityInput"
+      }
+    }
+  },
+  "required": [
+    "identities"
+  ]
+}

package/schema/match-access-recovery-response.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MatchAccessRecoveryResponse",
+  "description": "Result of recovering current private access for a live Solo-versus-AI match.\n\n`Unavailable` deliberately combines unknown, unauthorized, inactive, and\nineligible matches so this endpoint cannot be used to probe match state.",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "access": {
+          "description": "Current private host capability for the existing live runtime.",
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/MatchAccessResponse"
+        },
+        "kind": {
+          "type": "string",
+          "const": "recovered"
+        }
+      },
+      "required": [
+        "kind",
+        "access"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "const": "unavailable"
+        }
+      },
+      "required": [
+        "kind"
+      ]
+    }
+  ]
+}

package/schema/match-access-response.schema.json

@@ -9,9 +9,7 @@
     },
     "replaySeed": {
       "description": "Resolved seed for a private solo-vs-AI match. Never projected in live state.",
-      "type": "integer",
-      "format": "uint64",
-      "minimum": 0
+      "type": "string"
     },
     "seat": {
       "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"

package/schema/match-history-entry.schema.json

@@ -43,9 +43,7 @@
       "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/HistorySection"
     },
     "seed": {
-      "type": "integer",
-      "format": "uint64",
-      "minimum": 0
+      "type": "string"
     },
     "series": true,
     "sourceMatchId": {

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

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MatchRecoveryRequest",
+  "description": "Request to restore an unfinished Solo-versus-AI match whose original live\nruntime is no longer available.",
+  "type": "object",
+  "properties": {
+    "identities": {
+      "type": "array",
+      "items": {
+        "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/HistoryIdentityInput"
+      }
+    },
+    "restoreRequestId": {
+      "description": "Stable browser-generated id that makes recovery retries idempotent.",
+      "type": "string",
+      "format": "uuid"
+    },
+    "section": {
+      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/HistorySection"
+    },
+    "sourceMatchId": {
+      "description": "Id of the original runtime, never a public history id.",
+      "type": "string",
+      "format": "uuid"
+    }
+  },
+  "required": [
+    "sourceMatchId",
+    "section",
+    "identities",
+    "restoreRequestId"
+  ]
+}

package/schema/match-recovery-response.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MatchRecoveryResponse",
+  "description": "Result of looking up a lost-runtime recovery source.\n\n`Unavailable` intentionally combines unknown, unauthorized, live, and\nineligible sources so callers cannot probe match lifecycle metadata.",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "access": {
+          "description": "Fresh host capability for the restored runtime.",
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/MatchAccessResponse"
+        },
+        "kind": {
+          "type": "string",
+          "const": "restored"
+        }
+      },
+      "required": [
+        "kind",
+        "access"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "const": "unavailable"
+        }
+      },
+      "required": [
+        "kind"
+      ]
+    }
+  ]
+}