first commit

2026-07-11 14:56:10 +08:00
commit 7e05d0a4e7
660 changed files with 78119 additions and 0 deletions
@@ -0,0 +1,17 @@
+# Game Client Bridge Contract
+
+The game client bridge is optional and exists only for games that need in-game command execution or snapshots.
+
+## Payloads
+
+- `ClientHello`: game client credential, server instance ID, version, and display name.
+- `ClientHeartbeat`: session token, version, status, and game connection status.
+- `ClientCommandPoll`: session token and batch limit.
+- `ClientCommandResult`: command ID, status, bounded output, and timestamp.
+- `ClientSnapshot`: snapshot mode, raw bounded text or structured data reference, and timestamp.
+
+## Rules
+
+- The bridge must not carry run lifecycle jobs.
+- The bridge must not carry run log ingest batches.
+- Games without in-game bridge needs should not enable this channel.