up

api/main.proto

@@ -675,6 +675,7 @@ service EveningDetectiveServer {
     };
   }
 
+  // Each request creates a fresh setup package, replacing any unfinished preparation.
   rpc StartGameExport(StartGameExportReq) returns (GameExportRsp) {
     option (google.api.http) = {
       post: "/api/games/{ID}/export"
@@ -682,6 +683,14 @@ service EveningDetectiveServer {
     };
   }
 
+  // Release the transfer without discarding ready packages or their future results.
+  rpc ResetGameLocalMode(ResetGameLocalModeReq) returns (ResetGameLocalModeRsp) {
+    option (google.api.http) = {
+      post: "/api/games/{ID}/local-mode/reset"
+      body: "*"
+    };
+  }
+
   rpc GetGameExport(GetGameExportReq) returns (GameExportRsp) {
     option (google.api.http) = {get: "/api/games/{ID}/export"};
   }
@@ -1719,7 +1728,7 @@ message Game {
 // GET /api/games/{ID}/export/download (not an HttpBody RPC).
 message GameExport {
   string ID        = 1;
-  string state     = 2; // preparing, ready or failed; preparing/ready lock game writes.
+  string state     = 2; // preparing, ready or failed; ready indicates a completed package.
   string packageID = 3;
   int64  size      = 4;
   string sha256    = 5;
@@ -1736,6 +1745,13 @@ message StartGameExportReq { int32 ID = 1; }
 
 message GetGameExportReq { int32 ID = 1; }
 
+message ResetGameLocalModeReq {
+  int32  ID       = 1;
+  string exportID = 2; // Expected latest export, protecting against stale confirmations.
+}
+
+message ResetGameLocalModeRsp {}
+
 message GameExportRsp { GameExport export = 1; }
 
 enum ScreenMode {