fix(tui): clarify device approval preview hint

RomneyDa · RomneyDa · commit 04c502ae43c5 · 2026-06-30T14:18:59.000-07:00
diff --git a/src/tui/tui.test.ts b/src/tui/tui.test.ts
@@ -349,8 +349,9 @@ describe("resolveGatewayDisconnectState", () => {
   it("returns scope-upgrade recovery guidance when disconnect reason requires pairing", () => {
     const state = resolveGatewayDisconnectState("gateway closed (1008): pairing required");
     expect(state.connectionStatus).toContain("pairing required");
-    expect(state.activityStatus).toBe("scope upgrade needed: run openclaw devices approve");
+    expect(state.activityStatus).toBe("device approval needed: preview latest request");
     expect(state.pairingHint).toContain("openclaw devices approve --latest");
+    expect(state.pairingHint).toContain("openclaw devices approve <requestId>");
     expect(state.pairingHint).toContain("--token");
     // Must steer users to `devices`, not the unrelated chat-DM `pairing` command.
     expect(state.pairingHint).not.toContain("openclaw pairing");
@@ -360,8 +361,9 @@ describe("resolveGatewayDisconnectState", () => {
     const state = resolveGatewayDisconnectState(
       "gateway closed (1008): scope upgrade pending approval",
     );
-    expect(state.activityStatus).toBe("scope upgrade needed: run openclaw devices approve");
+    expect(state.activityStatus).toBe("device approval needed: preview latest request");
     expect(state.pairingHint).toContain("openclaw devices approve --latest");
+    expect(state.pairingHint).toContain("openclaw devices approve <requestId>");
   });
 
   it("falls back to idle for generic disconnect reasons", () => {
diff --git a/src/tui/tui.ts b/src/tui/tui.ts
@@ -234,10 +234,11 @@ export function resolveGatewayDisconnectState(reason?: string): {
   if (/pairing required|scope upgrade/i.test(reasonLabel)) {
     return {
       connectionStatus: `gateway disconnected: ${reasonLabel}`,
-      activityStatus: "scope upgrade needed: run openclaw devices approve",
+      activityStatus: "device approval needed: preview latest request",
       pairingHint:
-        "Device scope upgrade needed. Run `openclaw devices approve --latest` " +
-        "(add `--token` if it can't approve its own upgrade), then reconnect.",
+        "Device approval needed. Run `openclaw devices approve --latest` to preview the pending request, " +
+        "then rerun the printed `openclaw devices approve <requestId>` command " +
+        "(reuse `--token` or other auth flags if needed), then reconnect.",
     };
   }
   return {
