opendevbrowser 0.0.19 → 0.0.21

package/dist/skills/skill-loader.js

@@ -1,6 +1,6 @@
 import {
   SkillLoader
-} from "../chunk-YBQECXZX.js";
+} from "../chunk-3VA6XR25.js";
 export {
   SkillLoader
 };

package/dist/tools/automation-shared.d.ts

@@ -0,0 +1,6 @@
+import type { SessionInspectorHandle } from "../browser/manager-types";
+import type { AutomationCoordinatorLike } from "../automation/coordinator";
+import type { ToolDeps } from "./deps";
+export declare function requireAutomationCoordinator(deps: ToolDeps): AutomationCoordinatorLike | string;
+export declare function requireSessionInspectorHandle(deps: ToolDeps): SessionInspectorHandle | string;
+//# sourceMappingURL=automation-shared.d.ts.map

package/dist/tools/automation-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation-shared.d.ts","sourceRoot":"","sources":["../../src/tools/automation-shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAGvC,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,QAAQ,GACb,yBAAyB,GAAG,MAAM,CAGpC;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,QAAQ,GACb,sBAAsB,GAAG,MAAM,CAOjC"}

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAmEvC,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAE5E,eAAO,MAAM,qBAAqB,aAAiD,CAAC;AAEpF,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAsF1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAwEvC,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAE5E,eAAO,MAAM,qBAAqB,aAAiD,CAAC;AAEpF,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAoG1E"}

package/dist/tools/inspiredesign_run.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { ToolDeps } from "./deps";
+export declare function createInspiredesignRunTool(deps: ToolDeps): ToolDefinition;
+//# sourceMappingURL=inspiredesign_run.d.ts.map

package/dist/tools/inspiredesign_run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspiredesign_run.d.ts","sourceRoot":"","sources":["../../src/tools/inspiredesign_run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAYvC,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAgDzE"}

package/dist/tools/review_desktop.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { ToolDeps } from "./deps";
+export declare function createReviewDesktopTool(deps: ToolDeps): ToolDefinition;
+//# sourceMappingURL=review_desktop.d.ts.map

package/dist/tools/review_desktop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review_desktop.d.ts","sourceRoot":"","sources":["../../src/tools/review_desktop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAMvC,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CA6BtE"}

package/dist/tools/session_inspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session_inspector.d.ts","sourceRoot":"","sources":["../../src/tools/session_inspector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAKvC,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAqCzE"}
+{"version":3,"file":"session_inspector.d.ts","sourceRoot":"","sources":["../../src/tools/session_inspector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAMvC,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAqCzE"}

package/dist/tools/session_inspector_audit.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { ToolDeps } from "./deps";
+export declare function createSessionInspectorAuditTool(deps: ToolDeps): ToolDefinition;
+//# sourceMappingURL=session_inspector_audit.d.ts.map

package/dist/tools/session_inspector_audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_inspector_audit.d.ts","sourceRoot":"","sources":["../../src/tools/session_inspector_audit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAUvC,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CA6D9E"}

package/dist/tools/session_inspector_plan.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { ToolDeps } from "./deps";
+export declare function createSessionInspectorPlanTool(deps: ToolDeps): ToolDefinition;
+//# sourceMappingURL=session_inspector_plan.d.ts.map

package/dist/tools/session_inspector_plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_inspector_plan.d.ts","sourceRoot":"","sources":["../../src/tools/session_inspector_plan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAOvC,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAyB7E"}

package/dist/tools/status_capabilities.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { ToolDeps } from "./deps";
+export declare function createStatusCapabilitiesTool(deps: ToolDeps): ToolDefinition;
+//# sourceMappingURL=status_capabilities.d.ts.map

package/dist/tools/status_capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status_capabilities.d.ts","sourceRoot":"","sources":["../../src/tools/status_capabilities.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAOvC,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAyB3E"}

package/extension/dist/background.js

@@ -27,6 +27,7 @@ const nativePort = new NativePortManager({
     },
     onDisconnect: () => {
         updateBadge(getEffectiveStatus());
+        void refreshBadgeFromBackgroundStatus();
     }
 });
 let autoConnectInFlight = false;
@@ -49,6 +50,7 @@ const LAST_AGENT_ANNOTATION_PAYLOAD_KEY = "annotationAgentPayloadSansScreenshots
 const LAST_ANNOTATABLE_TAB_ID_KEY = "annotationLastTabId";
 const POPUP_ANNOTATION_TARGET_TTL_MS = 10_000;
 const BADGE_CONNECTED_DOT_COLOR = "#16a34a";
+const BADGE_WARNING_DOT_COLOR = "#f59e0b";
 const BADGE_DISCONNECTED_DOT_COLOR = "#dc2626";
 const annotationSessions = new Map();
 let lastAnnotationFull = null;
@@ -66,9 +68,12 @@ connection.onOpsMessage((message) => {
 connection.onCanvasMessage((message) => {
     canvasRuntime.handleMessage(message);
 });
-const updateBadge = (status) => {
-    const isConnected = status === "connected";
-    const dotColor = isConnected ? BADGE_CONNECTED_DOT_COLOR : BADGE_DISCONNECTED_DOT_COLOR;
+const updateBadge = (tone) => {
+    const dotColor = tone === "connected"
+        ? BADGE_CONNECTED_DOT_COLOR
+        : tone === "warning"
+            ? BADGE_WARNING_DOT_COLOR
+            : BADGE_DISCONNECTED_DOT_COLOR;
     chrome.action.setBadgeText({ text: "●" });
     if (typeof chrome.action.setBadgeTextColor === "function") {
         chrome.action.setBadgeTextColor({ color: dotColor });
@@ -86,10 +91,31 @@ const getEffectiveStatus = () => {
     }
     return "disconnected";
 };
+const hasReadyRelayHandshake = (health) => {
+    return health?.extensionConnected === true && health.extensionHandshakeComplete === true;
+};
+const deriveBackgroundStatus = (relayStatus, nativeHealth, relayHealth, reconnectSuppressed) => {
+    if (relayStatus === "connected") {
+        return "connected";
+    }
+    if (nativeHealth?.status === "connected") {
+        return "connected";
+    }
+    if (reconnectSuppressed) {
+        return "disconnected";
+    }
+    return hasReadyRelayHandshake(relayHealth) ? "connected" : "disconnected";
+};
+const deriveBadgeTone = (status, relayHealth) => {
+    if (status === "connected") {
+        return "connected";
+    }
+    return hasReadyRelayHandshake(relayHealth) ? "warning" : "disconnected";
+};
 const buildStatusMessage = async () => {
     const error = connection.getLastError();
     const relayStatus = connection.getStatus();
-    const status = getEffectiveStatus();
+    const reconnectSuppressed = connection.isReconnectSuppressed();
     let note = error?.message;
     let relayHealth = null;
     const isNativeEnabled = nativeEnabled;
@@ -123,12 +149,18 @@ const buildStatusMessage = async () => {
             });
             const port = parsePort(stored.relayPort) ?? DEFAULT_RELAY_PORT;
             relayHealth = await fetchRelayHealth(port);
-            note = statusNoteOverride ?? buildRelayHealthNote(relayHealth);
-            if (!statusNoteOverride && isNativeEnabled && nativeHealth?.status === "error") {
+            if (hasReadyRelayHandshake(relayHealth)) {
+                note = `Connected to 127.0.0.1:${port}`;
+            }
+            else {
+                note = statusNoteOverride ?? buildRelayHealthNote(relayHealth);
+            }
+            if (!hasReadyRelayHandshake(relayHealth) && !statusNoteOverride && isNativeEnabled && nativeHealth?.status === "error") {
                 note = buildNativeHealthNote(nativeHealth);
             }
         }
     }
+    const status = deriveBackgroundStatus(relayStatus, nativeHealth, relayHealth, reconnectSuppressed);
     if (!error) {
         const relayNotice = connection.getRelayNotice();
         if (relayNotice) {
@@ -144,6 +176,21 @@ const buildStatusMessage = async () => {
         nativeEnabled: isNativeEnabled
     };
 };
+let badgeRefreshVersion = 0;
+const refreshBadgeFromBackgroundStatus = async () => {
+    const refreshVersion = ++badgeRefreshVersion;
+    let tone = getEffectiveStatus();
+    try {
+        const statusMessage = await buildStatusMessage();
+        tone = deriveBadgeTone(statusMessage.status, statusMessage.relayHealth ?? null);
+    }
+    catch {
+        // Keep the synchronous local status when relay/native health cannot be fetched.
+    }
+    if (refreshVersion === badgeRefreshVersion) {
+        updateBadge(tone);
+    }
+};
 const setStorage = (items) => {
     return new Promise((resolve) => {
         chrome.storage.local.set(items, () => resolve());
@@ -248,6 +295,7 @@ const attemptNativeConnect = async () => {
         logError("native_port.ping", error, { code: "native_ping_failed" });
     }
     updateBadge(getEffectiveStatus());
+    await refreshBadgeFromBackgroundStatus();
     return nativePort.isConnected();
 };
 const parsePort = (value) => {
@@ -1271,7 +1319,7 @@ const attemptAutoConnect = async () => {
     });
     const autoConnect = typeof data.autoConnect === "boolean" ? data.autoConnect : DEFAULT_AUTO_CONNECT;
     autoConnectEnabled = autoConnect;
-    if (!autoConnect || connection.getStatus() === "connected") {
+    if (!autoConnect || connection.getStatus() === "connected" || connection.isReconnectSuppressed()) {
         clearRetry();
         return;
     }
@@ -1382,6 +1430,7 @@ const autoConnect = async () => {
 connection.onStatus((status) => {
     const effectiveStatus = status === "connected" ? "connected" : (nativeEnabled && nativePort.isConnected()) ? "connected" : "disconnected";
     updateBadge(effectiveStatus);
+    void refreshBadgeFromBackgroundStatus();
     if (status === "connected") {
         nativePort.disconnect();
         setStatusNoteOverride(null);
@@ -1392,6 +1441,10 @@ connection.onStatus((status) => {
             clearTimeout(session.timeoutId);
         }
         annotationSessions.clear();
+        if (connection.isReconnectSuppressed()) {
+            clearRetry();
+            return;
+        }
         if (autoConnectEnabled) {
             scheduleRetry();
         }
@@ -1471,6 +1524,7 @@ chrome.storage.onChanged.addListener((changes, area) => {
             nativePort.disconnect();
         }
         updateBadge(getEffectiveStatus());
+        void refreshBadgeFromBackgroundStatus();
     }
     if (changes.autoConnect) {
         autoConnectEnabled =
@@ -1496,7 +1550,9 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
     };
     if (message.type === "status") {
         (async () => {
-            respond(await buildStatusMessage());
+            const statusMessage = await buildStatusMessage();
+            updateBadge(deriveBadgeTone(statusMessage.status, statusMessage.relayHealth ?? null));
+            respond(statusMessage);
         })().catch((error) => {
             logError("popup.status", error, { code: "status_failed" });
             respond({
@@ -1513,7 +1569,9 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
             if (connection.getStatus() !== "connected") {
                 await attemptNativeConnect();
             }
-            respond(await buildStatusMessage());
+            const statusMessage = await buildStatusMessage();
+            updateBadge(deriveBadgeTone(statusMessage.status, statusMessage.relayHealth ?? null));
+            respond(statusMessage);
         })().catch((error) => {
             logError("popup.connect", error, { code: "connect_failed" });
             connection.disconnect();
@@ -1531,7 +1589,9 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
             await connection.disconnect();
             nativePort.disconnect();
             connection.clearLastError();
-            respond(await buildStatusMessage());
+            const statusMessage = await buildStatusMessage();
+            updateBadge(deriveBadgeTone(statusMessage.status, statusMessage.relayHealth ?? null));
+            respond(statusMessage);
         })().catch((error) => {
             logError("popup.disconnect", error, { code: "disconnect_failed" });
             connection.disconnect();

package/extension/dist/canvas/canvas-runtime.js

@@ -180,6 +180,9 @@ export class CanvasRuntime {
             return;
         }
         for (const session of this.sessions.listOwnedBy(clientId)) {
+            if (this.shouldPreserveSessionOnDisconnect(session)) {
+                continue;
+            }
             void this.closeRuntimeSession(session, "client_disconnected");
         }
         for (const [sessionId, session] of this.overlaySessions.entries()) {
@@ -524,6 +527,10 @@ export class CanvasRuntime {
             overlayState: result?.overlayState ?? "mounted"
         };
     }
+    shouldPreserveSessionOnDisconnect(session) {
+        return typeof session.designTabTargetId === "string"
+            && session.targets.has(session.designTabTargetId);
+    }
     createOrReplaceSession(message, tabId, document, previewMode, record) {
         const canvasSessionId = resolveCanvasSessionId(message, record);
         const clientId = requireString(message.clientId, "clientId");
@@ -632,7 +639,13 @@ export class CanvasRuntime {
         const session = resolveSessionForMessage(this.sessions, message, payload);
         const clientId = requireString(message.clientId, "clientId");
         const leaseId = optionalString(message.leaseId);
-        if (session.ownerClientId !== clientId || (leaseId && session.leaseId !== leaseId)) {
+        if (session.ownerClientId !== clientId) {
+            if (!leaseId || session.leaseId !== leaseId) {
+                throw new Error("Canvas session ownership mismatch.");
+            }
+            session.ownerClientId = clientId;
+        }
+        if (leaseId && session.leaseId !== leaseId) {
             throw new Error("Canvas session ownership mismatch.");
         }
         return session;

package/extension/dist/ops/ops-runtime.js

@@ -3570,7 +3570,12 @@ export class OpsRuntime {
             this.sendError(message, buildError("invalid_request", "No active target", false));
             return null;
         }
-        const target = this.resolveRequestedTargetContext(session, targetId, explicitTargetId !== null);
+        let target = this.resolveRequestedTargetContext(session, targetId, explicitTargetId !== null);
+        if (!target
+            && explicitTargetId !== null
+            && this.shouldRecoverExplicitCanvasOverlayTarget(message.command, targetId)) {
+            target = this.recoverExplicitCanvasOverlayTarget(session, targetId);
+        }
         if (!target) {
             this.sendError(message, buildError("invalid_request", "Active target missing", false));
             return null;
@@ -3592,6 +3597,18 @@ export class OpsRuntime {
         }
         return target;
     }
+    shouldRecoverExplicitCanvasOverlayTarget(command, targetId) {
+        return command.startsWith("canvas.overlay.") && parseTabTargetId(targetId) !== null;
+    }
+    recoverExplicitCanvasOverlayTarget(session, targetId) {
+        const tabId = parseTabTargetId(targetId);
+        if (tabId === null) {
+            return null;
+        }
+        const recoveredTarget = session.targets.get(targetId) ?? this.sessions.addTarget(session.id, tabId);
+        session.activeTargetId = recoveredTarget.targetId;
+        return this.resolveRequestedTargetContext(session, recoveredTarget.targetId, true);
+    }
     isAllowedCanvasRestrictionTarget(session, targetId, target) {
         if (this.isAllowedCanvasTargetUrl(target.url)) {
             return true;

package/extension/dist/popup.js

@@ -82,18 +82,31 @@ const setHealthNote = (message) => {
     currentHealthNote = next;
     healthNote.textContent = next;
 };
-const setStatus = (status) => {
-    const isConnected = status === "connected";
-    statusEl.textContent = isConnected ? "Connected" : "Disconnected";
+const hasRelayHealthyMismatch = (response) => {
+    return response.status === "disconnected"
+        && response.relayHealth?.extensionConnected === true
+        && response.relayHealth.extensionHandshakeComplete === true;
+};
+const applyStatusTone = (label, tone) => {
+    const isConnected = tone === "connected";
+    const isWarning = tone === "warning";
+    statusEl.textContent = label;
     toggleButton.textContent = isConnected ? "Disconnect" : "Connect";
-    if (isConnected) {
-        statusIndicator.classList.add("connected");
-        statusPill.classList.add("connected");
+    statusIndicator.classList.toggle("connected", isConnected);
+    statusPill.classList.toggle("connected", isConnected);
+    statusIndicator.classList.toggle("warning", isWarning);
+    statusPill.classList.toggle("warning", isWarning);
+};
+const setStatus = (response) => {
+    if (response.status === "connected") {
+        applyStatusTone("Connected", "connected");
+        return;
     }
-    else {
-        statusIndicator.classList.remove("connected");
-        statusPill.classList.remove("connected");
+    if (hasRelayHealthyMismatch(response)) {
+        applyStatusTone("Relay active", "warning");
+        return;
     }
+    applyStatusTone("Disconnected", "disconnected");
 };
 const setHealthValue = (element, value, tone) => {
     element.textContent = value;
@@ -180,7 +193,7 @@ const setNativeHealth = (health, enabled) => {
     }
 };
 const applyStatus = (response) => {
-    setStatus(response.status);
+    setStatus(response);
     setNote(response.note);
     setHealth(response.relayHealth ?? null);
     setNativeHealth(response.nativeHealth ?? null, response.nativeEnabled === true);
@@ -239,7 +252,7 @@ const refreshStatus = async () => {
     }
     catch (error) {
         logError("popup.status_refresh", error, { code: "status_refresh_failed" });
-        setStatus("disconnected");
+        setStatus({ status: "disconnected", relayHealth: null });
         const message = error instanceof Error ? error.message : "Background unavailable";
         setNote(message);
         setHealth(null);
@@ -563,7 +576,7 @@ const toggle = async () => {
                 });
             }
             else {
-                setStatus("disconnected");
+                setStatus({ status: "disconnected", relayHealth: null });
                 setNote("Auto-pair failed. Start the daemon and retry.");
                 setTimeout(() => refreshStatus(), 2000);
                 return;
@@ -579,7 +592,7 @@ const toggle = async () => {
     }
     catch (error) {
         logError("popup.toggle", error, { code: "toggle_failed" });
-        setStatus("disconnected");
+        setStatus({ status: "disconnected", relayHealth: null });
         const message = error instanceof Error ? error.message : "Background unavailable";
         setNote(message);
         setHealth(null);
@@ -588,7 +601,7 @@ const toggle = async () => {
 toggleButton.addEventListener("click", () => {
     toggle().catch((error) => {
         logError("popup.toggle", error, { code: "toggle_failed" });
-        setStatus("disconnected");
+        setStatus({ status: "disconnected", relayHealth: null });
     });
 });
 annotationStartButton.addEventListener("click", () => {
@@ -663,7 +676,7 @@ autoConnectInput.addEventListener("change", () => {
     if (enabled && statusEl.textContent !== "Connected") {
         toggle().catch((error) => {
             logError("popup.auto_connect", error, { code: "auto_connect_failed" });
-            setStatus("disconnected");
+            setStatus({ status: "disconnected", relayHealth: null });
             setNote();
         });
     }
@@ -702,7 +715,7 @@ relayPortInput.addEventListener("input", () => {
 });
 refreshStatus().catch((error) => {
     logError("popup.refresh_status", error, { code: "status_refresh_failed" });
-    setStatus("disconnected");
+    setStatus({ status: "disconnected", relayHealth: null });
     setNote();
 });
 loadSettings().catch((error) => {

package/extension/dist/services/ConnectionManager.js

@@ -65,6 +65,7 @@ export class ConnectionManager {
     relayEpoch = null;
     relayConfirmedPort = null;
     relayNotice = null;
+    reconnectSuppressed = false;
     maxReconnectDelayMs = RECONNECT_MAX_DELAY_MS;
     connectPromise = null;
     annotationHandler = null;
@@ -96,6 +97,9 @@ export class ConnectionManager {
     getRelayNotice() {
         return this.relayNotice;
     }
+    isReconnectSuppressed() {
+        return this.reconnectSuppressed;
+    }
     getLastError() {
         return this.lastError;
     }
@@ -245,6 +249,7 @@ export class ConnectionManager {
             }
             try {
                 this.clearLastError();
+                this.reconnectSuppressed = false;
                 this.relayNotice = null;
                 this.shouldReconnect = true;
                 this.reconnectAttempts = 0;
@@ -275,6 +280,7 @@ export class ConnectionManager {
         if (this.disconnecting)
             return;
         this.disconnecting = true;
+        this.reconnectSuppressed = false;
         this.shouldReconnect = false;
         this.clearReconnectTimer();
         this.stopHeartbeat();
@@ -512,7 +518,7 @@ export class ConnectionManager {
                 this.canvasHandler?.(message);
             },
             onClose: (detail) => {
-                this.handleRelayClose(detail);
+                this.handleRelayClose(relay, detail);
             }
         });
         this.relay = relay;
@@ -563,10 +569,25 @@ export class ConnectionManager {
             throw new ConnectionError("relay_connect_failed", "Relay connection failed. Start the daemon and retry.");
         }
     }
-    handleRelayClose(detail) {
+    handleRelayClose(closedRelay, detail) {
+        if (this.relay !== closedRelay) {
+            return;
+        }
         this.stopHeartbeat();
         this.relay = null;
         this.cdp.markClientClosed();
+        if (this.isRelayReplacedByNewClient(detail)) {
+            this.reconnectSuppressed = true;
+            this.shouldReconnect = false;
+            this.clearReconnectTimer();
+            this.setStatus("disconnected");
+            this.relayInstanceId = null;
+            this.relayConfirmedPort = null;
+            this.relayEpoch = null;
+            this.relayNotice = "Another extension client took over the relay connection. This client will stay disconnected until you reconnect it explicitly.";
+            return;
+        }
+        this.reconnectSuppressed = false;
         if (detail && (detail.code === 1008 || detail.reason?.includes("Invalid pairing token"))) {
             this.clearStoredPairingToken();
         }
@@ -1005,11 +1026,15 @@ export class ConnectionManager {
             this.reconnectTimer = null;
         }
     }
+    isRelayReplacedByNewClient(detail) {
+        return detail?.reason === "Replaced by a new extension client";
+    }
     async verifyHandshakeHealth(relay, source) {
         try {
             const health = await relay.sendPing(this.heartbeatTimeoutMs);
             if (health.extensionConnected && health.extensionHandshakeComplete) {
                 if (this.relay === relay) {
+                    this.reconnectSuppressed = false;
                     this.relayNotice = null;
                 }
                 return true;

package/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "OpenDevBrowser Relay",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "description": "Optional bridge to reuse existing Chrome tabs with OpenDevBrowser.",
   "permissions": [
     "debugger",

package/extension/popup.html

@@ -126,6 +126,12 @@
         background: var(--accent-soft);
       }
 
+      .status-pill.warning {
+        color: var(--text);
+        border-color: rgba(245, 158, 11, 0.55);
+        background: rgba(245, 158, 11, 0.18);
+      }
+
       .status-indicator {
         width: 8px;
         height: 8px;
@@ -140,6 +146,11 @@
         box-shadow: 0 0 12px rgba(32, 213, 198, 0.55);
       }
 
+      .status-indicator.warning {
+        background: #f59e0b;
+        box-shadow: 0 0 12px rgba(245, 158, 11, 0.45);
+      }
+
       .panel {
         position: relative;
         display: flex;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opendevbrowser",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "description": "Browser automation runtime with snapshot-refs-actions, browser replay screencasts, public read-only desktop observation, and browser-scoped computer-use orchestration",
   "type": "module",
   "main": "dist/index.js",
@@ -45,10 +45,10 @@
     "node": ">=18"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/cli/index.ts src/skills/skill-loader.ts --format esm --clean --sourcemap && tsc --emitDeclarationOnly --declaration --declarationMap -p tsconfig.json && node scripts/postbuild-dist.mjs",
+    "build": "node scripts/run-package-tool.mjs tsup src/index.ts src/cli/index.ts src/skills/skill-loader.ts --format esm --clean --sourcemap && node scripts/run-package-tool.mjs tsc --emitDeclarationOnly --declaration --declarationMap -p tsconfig.json && node scripts/postbuild-dist.mjs",
     "dev": "tsup src/index.ts src/cli/index.ts src/skills/skill-loader.ts --format esm --dts --watch",
-    "lint": "eslint \"src/**/*.ts\" \"tests/**/*.ts\"",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "lint": "node scripts/run-package-tool.mjs eslint \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "typecheck": "node scripts/run-package-tool.mjs tsc --noEmit -p tsconfig.json",
     "test": "node scripts/run-vitest-coverage.mjs",
     "test:release-gate": "node scripts/release-gate-test-groups.mjs",
     "test:release-gate:g1": "node scripts/release-gate-test-groups.mjs --group 1",
@@ -57,7 +57,7 @@
     "test:release-gate:g4": "node scripts/release-gate-test-groups.mjs --group 4",
     "test:release-gate:g5": "node scripts/release-gate-test-groups.mjs --group 5",
     "extension:sync": "node scripts/sync-extension-version.mjs",
-    "extension:build": "npm run extension:sync && tsc -p extension/tsconfig.json && node scripts/copy-extension-assets.mjs",
+    "extension:build": "npm run extension:sync && node scripts/run-package-tool.mjs tsc -p extension/tsconfig.json && node scripts/copy-extension-assets.mjs",
     "extension:pack": "cd extension && zip -r ../opendevbrowser-extension.zip manifest.json popup.html canvas.html dist/ icons/",
     "extension:store": "node scripts/chrome-store-publish.mjs",
     "version:check": "node scripts/verify-versions.mjs",

package/skills/AGENTS.md

@@ -39,9 +39,9 @@ Content organized by topic for filtering.
 3. `.codex/skills/` (project compatibility)
 4. `$CODEX_HOME/skills` (global compatibility; fallback `~/.codex/skills`)
 5. `.claude/skills/` (ClaudeCode project compatibility)
-6. `$CLAUDECODE_HOME/skills` or `$CLAUDE_HOME/skills` (ClaudeCode global compatibility; fallback `~/.claude/skills`)
+6. `$CLAUDECODE_HOME/skills` (ClaudeCode global compatibility; fallback `~/.claude/skills`)
 7. `.amp/skills/` (AmpCLI project compatibility)
-8. `$AMPCLI_HOME/skills` or `$AMP_CLI_HOME/skills` or `$AMP_HOME/skills` (AmpCLI global compatibility; fallback `~/.amp/skills`)
+8. `$AMP_CLI_HOME/skills` (AmpCLI global compatibility; fallback `~/.amp/skills`)
 9. `skillPaths` config (custom)
 10. Bundled package `skills/` directory as a fallback when no installed copy is available