Prototype voluntary seat handover with durable private retries

Let a current owner issue, cancel or replace a private 24-hour one-time offer.
Recipients accept the same faction and saved game while old browser sessions,
recovery keys and entry receipts lose authority. Preserve exact claim retries
across refresh, restart and later offers, with private tab-scoped continuation.

Fence every claim mutation to its winning transaction. Add durable receipts
and additive backfill for already-issued offers without changing game JSON or
existing seat authority. Block competing navigation during unresolved owner
operations; remove invalidated owner kits on confirmed recovery.

Record the pending CHOAM Nexus after-victory secrecy/window decision without
inventing the unresolved gameplay or opening mode/publication gates.

Validation: types/lint and 4,364 offline tests passed; production build passed;
43 HTTP tests passed. Added 19 offline and 3 HTTP regressions. Independent
privacy/persistence review passed, including deterministic CAS interleavings,
rollback, legacy migration and exact receipt restoration. Browser room 2EMYG4CY
retained private setup choices after handover/refresh and continued into Storm;
follow-up recovery removed its invalid offer with cards/forces/spice unchanged.
All 218 opening rooms preserved (291 after QA and both broad runs). The opening
456 seat, 49 recovery-key, 56 recovery-receipt and 106 entry-receipt rows were
also verified unchanged. Server reused; no restart or recurring automation.

Final private report: ~/.local/share/dune/checkpoints/20260913-seat-handover/
verification-final/report.json. Source fingerprint:
8949cdf58eb8bc8bd33f2657c6b21352b3ee5e17e2a556c684a89073015632f4.
Check/build/HTTP duration: 140565/6689/24835 ms. The earlier broad run passed;
a final recovery-UI review fix required the second source-bound run.
Goal aggregate counter 64,301,976 -> 65,031,751 before Git (729,775) for this
bounded capability and its concurrency/recovery review; full goal remains active.

app/api/rooms/[code]/control/route.ts

@@ -1,5 +1,8 @@
 import {
   authenticate,
+  createSeatHandover,
+  revokeSeatHandover,
+  claimSeatHandover,
   recoverSeat,
   SeatControlError,
   setRecoveryKey,
@@ -37,36 +40,78 @@ export async function POST(req: Request) {
         400,
       );
     const input = body as Record<string, unknown>;
-    if (input.type === 'setRecoveryKey') {
-      const token =
-        req.headers
-          .get('cookie')
-          ?.split(';')
-          .map((part) => part.trim())
-          .find((part) => part.startsWith(`dune_${code}=`))
-          ?.split('=')[1] ?? '';
+    const token =
+      req.headers
+        .get('cookie')
+        ?.split(';')
+        .map((part) => part.trim())
+        .find((part) => part.startsWith(`dune_${code}=`))
+        ?.split('=')[1] ?? '';
+    if (
+      input.type === 'setRecoveryKey' ||
+      input.type === 'createSeatHandover' ||
+      input.type === 'revokeSeatHandover'
+    ) {
       const auth = await authenticate(code, token);
+      if (input.type === 'createSeatHandover')
+        return Response.json(
+          await createSeatHandover(code, auth, input.version, {
+            offerId: input.offerId,
+            handoverSecret: input.handoverSecret,
+          }),
+          { headers: noStore },
+        );
+      if (input.type === 'revokeSeatHandover')
+        return Response.json(
+          await revokeSeatHandover(code, auth, input.version, input.offerId),
+          { headers: noStore },
+        );
       return Response.json(
         await setRecoveryKey(code, auth, input.version, input.recoverySecret),
         { headers: noStore },
       );
     }
-    if (input.type !== 'recoverSeat')
+    if (input.type !== 'recoverSeat' && input.type !== 'claimSeatHandover')
       throw new SeatControlError(
         'Choose a recovery operation.',
         'INVALID_CONTROL_REQUEST',
         400,
       );
-    const result = await recoverSeat(code, {
-      playerId: input.playerId,
-      recoverySecret: input.recoverySecret,
-      operationId: input.operationId,
-      newSessionToken: input.newSessionToken,
-    });
+    if (input.type === 'claimSeatHandover' && token) {
+      let existing;
+      try {
+        existing = await authenticate(code, token);
+      } catch (error) {
+        if (!(error instanceof RuleError)) throw error;
+      }
+      if (existing && existing.playerId !== input.playerId)
+        throw new SeatControlError(
+          'This browser already controls another seat in this room. Use a separate browser profile to accept the handover.',
+          'ALREADY_SEATED',
+          409,
+        );
+    }
+    const result =
+      input.type === 'claimSeatHandover'
+        ? await claimSeatHandover(code, {
+            playerId: input.playerId,
+            offerId: input.offerId,
+            handoverSecret: input.handoverSecret,
+            operationId: input.operationId,
+            newSessionToken: input.newSessionToken,
+          })
+        : await recoverSeat(code, {
+            playerId: input.playerId,
+            recoverySecret: input.recoverySecret,
+            operationId: input.operationId,
+            newSessionToken: input.newSessionToken,
+          });
     return Response.json(
       {
         view: result.view,
-        recovered: result.recovered,
+        ...('transferred' in result
+          ? { transferred: result.transferred }
+          : { recovered: result.recovered }),
         replayed: result.replayed,
       },
       {
@@ -84,7 +129,7 @@ export async function POST(req: Request) {
             ? error.message
             : error instanceof SyntaxError
               ? 'Invalid JSON.'
-              : 'The server could not complete seat recovery.',
+              : 'The server could not complete this seat request.',
         code:
           error instanceof SeatControlError
             ? error.code