From 20730af20b7e7be7192e15a0e60b041b6b42a9df Mon Sep 17 00:00:00 2001
From: Taras Shynkarenko <taras.shinkarenko@gmail.com>
Date: Wed, 25 Feb 2026 11:21:39 +0100
Subject: [PATCH] fix(browser): stop wrapping application errors with Can't
 reach message

---
 src/browser/client-fetch.ts | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/src/browser/client-fetch.ts b/src/browser/client-fetch.ts
index a349cf22a67..9f9f6daf07d 100644
--- a/src/browser/client-fetch.ts
+++ b/src/browser/client-fetch.ts
@@ -9,6 +9,15 @@ import {
 } from "./control-service.js";
 import { createBrowserRouteDispatcher } from "./routes/dispatcher.js";
 
+// Application-level error from the browser control service (service is reachable
+// but returned an error response). Must NOT be wrapped with "Can't reach ..." messaging.
+class BrowserServiceError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "BrowserServiceError";
+  }
+}
+
 type LoopbackBrowserAuthDeps = {
   loadConfig: typeof loadConfig;
   resolveBrowserControlAuth: typeof resolveBrowserControlAuth;
@@ -140,7 +149,7 @@ async function fetchHttpJson<T>(
     const res = await fetch(url, { ...init, signal: ctrl.signal });
     if (!res.ok) {
       const text = await res.text().catch(() => "");
-      throw new Error(text || `HTTP ${res.status}`);
+      throw new BrowserServiceError(text || `HTTP ${res.status}`);
     }
     return (await res.json()) as T;
   } finally {
@@ -235,10 +244,13 @@ export async function fetchBrowserJson<T>(
         result.body && typeof result.body === "object" && "error" in result.body
           ? String((result.body as { error?: unknown }).error)
           : `HTTP ${result.status}`;
-      throw new Error(message);
+      throw new BrowserServiceError(message);
     }
     return result.body as T;
   } catch (err) {
+    if (err instanceof BrowserServiceError) {
+      throw err;
+    }
     throw enhanceBrowserFetchError(url, err, timeoutMs);
   }
 }