fix(browser): keep tab stable across snapshot and act

src/browser/server-context.ensure-tab-available.prefers-last-target.test.ts

@@ -0,0 +1,100 @@
+import { describe, expect, it, vi } from "vitest";
+
+import type { BrowserServerState } from "./server-context.js";
+import { createBrowserRouteContext } from "./server-context.js";
+
+vi.mock("./chrome.js", () => ({
+  isChromeCdpReady: vi.fn(async () => true),
+  isChromeReachable: vi.fn(async () => true),
+  launchClawdChrome: vi.fn(async () => {
+    throw new Error("unexpected launch");
+  }),
+  resolveClawdUserDataDir: vi.fn(() => "/tmp/clawd"),
+  stopClawdChrome: vi.fn(async () => {}),
+}));
+
+describe("browser server-context ensureTabAvailable", () => {
+  it("sticks to the last selected target when targetId is omitted", async () => {
+    const fetchMock = vi.fn();
+    // 1st call (snapshot): stable ordering A then B (twice)
+    // 2nd call (act): reversed ordering B then A (twice)
+    const responses = [
+      [
+        { id: "A", type: "page", url: "https://a.example", webSocketDebuggerUrl: "ws://x/a" },
+        { id: "B", type: "page", url: "https://b.example", webSocketDebuggerUrl: "ws://x/b" },
+      ],
+      [
+        { id: "A", type: "page", url: "https://a.example", webSocketDebuggerUrl: "ws://x/a" },
+        { id: "B", type: "page", url: "https://b.example", webSocketDebuggerUrl: "ws://x/b" },
+      ],
+      [
+        { id: "B", type: "page", url: "https://b.example", webSocketDebuggerUrl: "ws://x/b" },
+        { id: "A", type: "page", url: "https://a.example", webSocketDebuggerUrl: "ws://x/a" },
+      ],
+      [
+        { id: "B", type: "page", url: "https://b.example", webSocketDebuggerUrl: "ws://x/b" },
+        { id: "A", type: "page", url: "https://a.example", webSocketDebuggerUrl: "ws://x/a" },
+      ],
+    ];
+
+    fetchMock.mockImplementation(async (url: unknown) => {
+      const u = String(url);
+      if (!u.includes("/json/list")) {
+        throw new Error(`unexpected fetch: ${u}`);
+      }
+      const next = responses.shift();
+      if (!next) {
+        throw new Error("no more responses");
+      }
+      return {
+        ok: true,
+        json: async () => next,
+      } as unknown as Response;
+    });
+
+    // @ts-expect-error test override
+    global.fetch = fetchMock;
+
+    const state: BrowserServerState = {
+      // unused in these tests
+      // biome-ignore lint/suspicious/noExplicitAny: test stub
+      server: null as any,
+      port: 0,
+      resolved: {
+        enabled: true,
+        controlUrl: "http://127.0.0.1:18791",
+        controlHost: "127.0.0.1",
+        controlPort: 18791,
+        cdpProtocol: "http",
+        cdpHost: "127.0.0.1",
+        cdpIsLoopback: true,
+        color: "#FF4500",
+        headless: true,
+        noSandbox: false,
+        attachOnly: false,
+        defaultProfile: "chrome",
+        profiles: {
+          chrome: {
+            driver: "extension",
+            cdpUrl: "http://127.0.0.1:18792",
+            cdpPort: 18792,
+            color: "#00AA00",
+          },
+          clawd: { cdpPort: 18800, color: "#FF4500" },
+        },
+      },
+      profiles: new Map(),
+    };
+
+    const ctx = createBrowserRouteContext({
+      getState: () => state,
+    });
+
+    const chrome = ctx.forProfile("chrome");
+    const first = await chrome.ensureTabAvailable();
+    expect(first.targetId).toBe("A");
+    const second = await chrome.ensureTabAvailable();
+    expect(second.targetId).toBe("A");
+  });
+});
+