run/protocol/game-client-bridge.md

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.