@pyrokine/mcp-chrome 2.3.2 → 2.4.1

package/extension/dist/assets/{index.ts-CJXGbOcp.js → index.ts-GG6dPUPX.js}

@@ -15,6 +15,272 @@ function isExpectedOperationError(err) {
 	return err instanceof ExpectedOperationError;
 }
 //#endregion
+//#region src/background/tab-state.ts
+/**
+* Managed tab/window 状态与 storage 恢复。
+*/
+var STORAGE_KEY = "mcp_managed_tab_ids";
+var mcpTabGroupId = null;
+var mcpWindowId = null;
+var managedTabIds = /* @__PURE__ */ new Set();
+function getMcpTabGroupId() {
+	return mcpTabGroupId;
+}
+function getMcpWindowId() {
+	return mcpWindowId;
+}
+function setMcpTabGroupId(groupId) {
+	mcpTabGroupId = groupId;
+}
+function setMcpWindowId(windowId) {
+	mcpWindowId = windowId;
+}
+async function markManagedTab(tabId) {
+	managedTabIds.add(tabId);
+	await chrome.storage.local.set({ [STORAGE_KEY]: [...managedTabIds] });
+}
+async function unmarkManagedTab(tabId) {
+	managedTabIds.delete(tabId);
+	await chrome.storage.local.set({ [STORAGE_KEY]: [...managedTabIds] });
+}
+function isManagedTab(tab, context) {
+	if (tab.id !== void 0 && managedTabIds.has(tab.id)) return true;
+	return context.mcpTabGroupId !== null && tab.groupId === context.mcpTabGroupId;
+}
+/** Extension 启动时调用，从 storage 恢复 managed tab 集合 */
+async function restoreManagedTabs() {
+	const result = await chrome.storage.local.get(STORAGE_KEY);
+	const stored = Array.isArray(result[STORAGE_KEY]) ? result[STORAGE_KEY] : [];
+	for (const id of stored) managedTabIds.add(id);
+	const tabs = await chrome.tabs.query({});
+	const existingIds = new Set(tabs.map((t) => t.id).filter((id) => id !== void 0));
+	for (const id of managedTabIds) if (!existingIds.has(id)) managedTabIds.delete(id);
+	await chrome.storage.local.set({ [STORAGE_KEY]: [...managedTabIds] });
+}
+//#endregion
+//#region src/background/action-utils.ts
+function isRestrictedUrl(url) {
+	if (!url) return true;
+	return url === "about:blank" || url.startsWith("about:") || url.startsWith("chrome://") || url.startsWith("chrome-extension://");
+}
+async function assertScriptable(tabId) {
+	const tab = await chrome.tabs.get(tabId);
+	if (isRestrictedUrl(tab.url)) throw new ExpectedOperationError(`Cannot execute on restricted URL "${tab.url}". Navigate to an http/https page first.`);
+}
+async function getTargetTabId(tabId) {
+	if (tabId !== void 0 && tabId !== null) {
+		try {
+			await chrome.tabs.get(tabId);
+		} catch {
+			throw new ExpectedOperationError(`Tab ${tabId} 不存在（可能已被关闭）`);
+		}
+		return tabId;
+	}
+	const [activeTab] = await chrome.tabs.query({
+		active: true,
+		currentWindow: true
+	});
+	if (!activeTab?.id) throw new ExpectedOperationError("No active tab found");
+	return activeTab.id;
+}
+function tabToInfo(tab, context) {
+	return {
+		id: tab.id,
+		url: tab.url || "",
+		title: tab.title || "",
+		active: tab.active,
+		windowId: tab.windowId,
+		index: tab.index,
+		groupId: tab.groupId,
+		pinned: tab.pinned,
+		incognito: tab.incognito,
+		managed: isManagedTab(tab, context),
+		status: tab.status || "unknown"
+	};
+}
+async function assertManagedTab(tabId, context, operation) {
+	let tab;
+	try {
+		tab = await chrome.tabs.get(tabId);
+	} catch {
+		throw new ExpectedOperationError(`Tab ${tabId} 不存在（可能已被关闭）`);
+	}
+	if (!isManagedTab(tab, context)) throw new ExpectedOperationError(`${operation} 拒绝操作非托管 tab, ${JSON.stringify({
+		tabId,
+		managed: false,
+		groupId: tab.groupId,
+		mcpTabGroupId: context.mcpTabGroupId,
+		windowId: tab.windowId,
+		mcpWindowId: context.mcpWindowId
+	})}, 请使用 browse(action="list") 选择 managed=true 的受控 tab, 或用 manage(action="newPage") 创建受控页面`);
+	return tab;
+}
+var FRAME_PROBE_TIMEOUT_MS = 500;
+var pendingDomFrameProbes = /* @__PURE__ */ new Map();
+function recordDomFrameProbe(message, sender) {
+	const pending = pendingDomFrameProbes.get(message.token);
+	if (!pending || sender.tab?.id !== pending.tabId || sender.frameId === void 0 || sender.frameId === 0 || !Number.isInteger(message.index) || message.index < 0) return { accepted: false };
+	const frameIds = pending.frameIdsByIndex.get(message.index) ?? [];
+	if (!frameIds.includes(sender.frameId)) {
+		frameIds.push(sender.frameId);
+		pending.frameIdsByIndex.set(message.index, frameIds);
+	}
+	return { accepted: true };
+}
+/**
+* 将父文档里的 DOM iframe 与 Chrome frameId 建立可验证映射
+*
+* webNavigation 可能包含页面 DOM 不可见的其他 Extension frame，因此不能按两个列表的顺序配对
+* 这里向每个 DOM iframe 的 contentWindow 发送一次随机 probe，再从对应 content script 的 sender 读取实际 frameId
+*/
+async function getDomFrameSnapshot(tabId, parentFrameId, selection) {
+	const token = crypto.randomUUID();
+	const pendingProbe = {
+		tabId,
+		frameIdsByIndex: /* @__PURE__ */ new Map()
+	};
+	pendingDomFrameProbes.set(token, pendingProbe);
+	try {
+		const parentResult = (await chrome.scripting.executeScript({
+			target: {
+				tabId,
+				frameIds: [parentFrameId]
+			},
+			func: async (probeToken, requestedSelection, timeoutMs) => {
+				const iframes = Array.from(document.querySelectorAll("iframe, frame"));
+				let selectedIndex = null;
+				let selectionStatus = "not-requested";
+				let selectionError;
+				if (typeof requestedSelection === "number") if (requestedSelection < 0 || requestedSelection >= iframes.length) selectionStatus = "out-of-range";
+				else {
+					selectedIndex = requestedSelection;
+					selectionStatus = "found";
+				}
+				else if (typeof requestedSelection === "string") try {
+					const selected = document.querySelector(requestedSelection);
+					if (!selected) selectionStatus = "not-found";
+					else if (!selected.matches("iframe, frame")) selectionStatus = "not-frame";
+					else {
+						selectedIndex = iframes.indexOf(selected);
+						selectionStatus = selectedIndex >= 0 ? "found" : "not-found";
+					}
+				} catch (error) {
+					selectionStatus = "invalid-selector";
+					selectionError = (error instanceof Error ? error.message : String(error)).slice(0, 300);
+				}
+				const acknowledged = await Promise.all(iframes.map((frame, index) => new Promise((resolve) => {
+					const child = frame.contentWindow;
+					if (!child) {
+						resolve(false);
+						return;
+					}
+					let settled = false;
+					const finish = (value) => {
+						if (settled) return;
+						settled = true;
+						window.clearTimeout(timer);
+						window.removeEventListener("message", onMessage);
+						resolve(value);
+					};
+					const onMessage = (event) => {
+						const data = event.data;
+						if (event.source === child && data?.type === "mcp-frame-probe-ack" && data.token === probeToken && data.index === index) finish(true);
+					};
+					const timer = window.setTimeout(() => finish(false), timeoutMs);
+					window.addEventListener("message", onMessage);
+					child.postMessage({
+						type: "mcp-frame-probe",
+						token: probeToken,
+						index
+					}, "*");
+				})));
+				return {
+					parent: {
+						title: document.title || null,
+						rect: {
+							x: 0,
+							y: 0,
+							width: window.innerWidth,
+							height: window.innerHeight
+						}
+					},
+					frames: iframes.map((frame, index) => {
+						const rect = frame.getBoundingClientRect();
+						return {
+							index,
+							acknowledged: acknowledged[index],
+							url: frame.src || "",
+							title: frame.title || null,
+							name: frame.name || null,
+							selector: frame.id ? `#${CSS.escape(frame.id)}` : `${frame.tagName.toLowerCase()}:nth-of-type(${index + 1})`,
+							rect: {
+								x: rect.x,
+								y: rect.y,
+								width: rect.width,
+								height: rect.height
+							},
+							contentOffset: {
+								x: rect.x + frame.clientLeft,
+								y: rect.y + frame.clientTop
+							}
+						};
+					}),
+					selectedIndex,
+					selectionStatus,
+					selectionError
+				};
+			},
+			args: [
+				token,
+				selection ?? null,
+				FRAME_PROBE_TIMEOUT_MS
+			]
+		}))[0]?.result;
+		if (!parentResult) throw new ExpectedOperationError(`无法读取 parent frame ${parentFrameId} 的 iframe DOM`);
+		return {
+			parent: parentResult.parent,
+			frames: parentResult.frames.map(({ acknowledged, ...frame }) => {
+				const candidateFrameIds = acknowledged ? pendingProbe.frameIdsByIndex.get(frame.index) ?? [] : [];
+				return {
+					...frame,
+					frameId: candidateFrameIds.length === 1 ? candidateFrameIds[0] : null,
+					candidateFrameIds: candidateFrameIds.slice(0, 10)
+				};
+			}),
+			selectedIndex: parentResult.selectedIndex,
+			selectionStatus: parentResult.selectionStatus,
+			...parentResult.selectionError ? { selectionError: parentResult.selectionError } : {}
+		};
+	} finally {
+		pendingDomFrameProbes.delete(token);
+	}
+}
+/**
+* 递归计算 iframe 在页面坐标系中的偏移量
+*
+* 对于嵌套 iframe，递归累加各层偏移，clientLeft/clientTop 补偿 iframe border
+*/
+async function getFrameOffset(tabId, frameId) {
+	const targetFrame = (await chrome.webNavigation.getAllFrames({ tabId }))?.find((frame) => frame.frameId === frameId);
+	if (!targetFrame || targetFrame.parentFrameId === -1) return null;
+	if (isRestrictedUrl((await chrome.tabs.get(tabId)).url)) return null;
+	let parentOffset = {
+		x: 0,
+		y: 0
+	};
+	if (targetFrame.parentFrameId !== 0) {
+		const resolvedParentOffset = await getFrameOffset(tabId, targetFrame.parentFrameId);
+		if (!resolvedParentOffset) return null;
+		parentOffset = resolvedParentOffset;
+	}
+	const mappedFrame = (await getDomFrameSnapshot(tabId, targetFrame.parentFrameId)).frames.find((frame) => frame.frameId === frameId);
+	if (!mappedFrame) return null;
+	return {
+		x: parentOffset.x + mappedFrame.contentOffset.x,
+		y: parentOffset.y + mappedFrame.contentOffset.y
+	};
+}
+//#endregion
 //#region node_modules/zod/v4/core/core.js
 var _a$1;
 function $constructor(name, initializer, params) {
@@ -136,7 +402,10 @@ function assignProp(target, prop, value) {
 }
 function mergeDefs(...defs) {
 	const mergedDescriptors = {};
-	for (const def of defs) Object.assign(mergedDescriptors, Object.getOwnPropertyDescriptors(def));
+	for (const def of defs) {
+		const descriptors = Object.getOwnPropertyDescriptors(def);
+		Object.assign(mergedDescriptors, descriptors);
+	}
 	return Object.defineProperties({}, mergedDescriptors);
 }
 function esc(str) {
@@ -458,7 +727,7 @@ var _parse = (_Err) => (schema, value, _ctx, _params) => {
 	}, ctx);
 	if (result instanceof Promise) throw new $ZodAsyncError();
 	if (result.issues.length) {
-		const e = new (_params?.Err ?? _Err)(result.issues.map((iss) => finalizeIssue(iss, ctx, config())));
+		const e = new ((_params?.Err) ?? _Err)(result.issues.map((iss) => finalizeIssue(iss, ctx, config())));
 		captureStackTrace(e, _params?.callee);
 		throw e;
 	}
@@ -475,7 +744,7 @@ var _parseAsync = (_Err) => async (schema, value, _ctx, params) => {
 	}, ctx);
 	if (result instanceof Promise) result = await result;
 	if (result.issues.length) {
-		const e = new (params?.Err ?? _Err)(result.issues.map((iss) => finalizeIssue(iss, ctx, config())));
+		const e = new ((params?.Err) ?? _Err)(result.issues.map((iss) => finalizeIssue(iss, ctx, config())));
 		captureStackTrace(e, params?.callee);
 		throw e;
 	}
@@ -1567,13 +1836,13 @@ var $ZodObject = /*@__PURE__*/ $constructor("$ZodObject", (inst, def) => {
 		}
 		return propValues;
 	});
-	const isObject$1 = isObject;
+	const isObject$2 = isObject;
 	const catchall = def.catchall;
 	let value;
 	inst._zod.parse = (payload, ctx) => {
 		value ?? (value = _normalized.value);
 		const input = payload.value;
-		if (!isObject$1(input)) {
+		if (!isObject$2(input)) {
 			payload.issues.push({
 				expected: "object",
 				code: "invalid_type",
@@ -1696,7 +1965,7 @@ var $ZodObjectJIT = /*@__PURE__*/ $constructor("$ZodObjectJIT", (inst, def) => {
 		return (payload, ctx) => fn(shape, payload, ctx);
 	};
 	let fastpass;
-	const isObject$2 = isObject;
+	const isObject$1 = isObject;
 	const jit = !globalConfig.jitless;
 	const fastEnabled = jit && allowsEval.value;
 	const catchall = def.catchall;
@@ -1704,7 +1973,7 @@ var $ZodObjectJIT = /*@__PURE__*/ $constructor("$ZodObjectJIT", (inst, def) => {
 	inst._zod.parse = (payload, ctx) => {
 		value ?? (value = _normalized.value);
 		const input = payload.value;
-		if (!isObject$2(input)) {
+		if (!isObject$1(input)) {
 			payload.issues.push({
 				expected: "object",
 				code: "invalid_type",
@@ -2032,7 +2301,7 @@ var $ZodOptional = /*@__PURE__*/ $constructor("$ZodOptional", (inst, def) => {
 	inst._zod.optin = "optional";
 	inst._zod.optout = "optional";
 	defineLazy(inst._zod, "values", () => {
-		return def.innerType._zod.values ? new Set([...def.innerType._zod.values, void 0]) : void 0;
+		return def.innerType._zod.values ? /* @__PURE__ */ new Set([...def.innerType._zod.values, void 0]) : void 0;
 	});
 	defineLazy(inst._zod, "pattern", () => {
 		const pattern = def.innerType._zod.pattern;
@@ -2066,7 +2335,7 @@ var $ZodNullable = /*@__PURE__*/ $constructor("$ZodNullable", (inst, def) => {
 		return pattern ? new RegExp(`^(${cleanRegex(pattern.source)}|null)$`) : void 0;
 	});
 	defineLazy(inst._zod, "values", () => {
-		return def.innerType._zod.values ? new Set([...def.innerType._zod.values, null]) : void 0;
+		return def.innerType._zod.values ? /* @__PURE__ */ new Set([...def.innerType._zod.values, null]) : void 0;
 	});
 	inst._zod.parse = (payload, ctx) => {
 		if (payload.value === null) return payload;
@@ -4564,172 +4833,10 @@ var EvaluateInFrameSchema = object({
 	tabId: tabIdOpt,
 	frameId: number().int().nonnegative(),
 	expression: string().min(1),
-	timeout: number().nonnegative().optional()
+	timeout: number().nonnegative().optional(),
+	staleContextRetry: _enum(["never", "readOnly"]).default("never")
 });
 //#endregion
-//#region src/background/tab-state.ts
-/**
-* Managed tab/window 状态与 storage 恢复。
-*/
-var STORAGE_KEY = "mcp_managed_tab_ids";
-var mcpTabGroupId = null;
-var mcpWindowId = null;
-var managedTabIds = /* @__PURE__ */ new Set();
-function getMcpTabGroupId() {
-	return mcpTabGroupId;
-}
-function getMcpWindowId() {
-	return mcpWindowId;
-}
-function setMcpTabGroupId(groupId) {
-	mcpTabGroupId = groupId;
-}
-function setMcpWindowId(windowId) {
-	mcpWindowId = windowId;
-}
-async function markManagedTab(tabId) {
-	managedTabIds.add(tabId);
-	await chrome.storage.local.set({ [STORAGE_KEY]: [...managedTabIds] });
-}
-async function unmarkManagedTab(tabId) {
-	managedTabIds.delete(tabId);
-	await chrome.storage.local.set({ [STORAGE_KEY]: [...managedTabIds] });
-}
-function isManagedTab(tab, context) {
-	if (tab.id !== void 0 && managedTabIds.has(tab.id)) return true;
-	return context.mcpTabGroupId !== null && tab.groupId === context.mcpTabGroupId;
-}
-/** Extension 启动时调用，从 storage 恢复 managed tab 集合 */
-async function restoreManagedTabs() {
-	const result = await chrome.storage.local.get(STORAGE_KEY);
-	const stored = Array.isArray(result[STORAGE_KEY]) ? result[STORAGE_KEY] : [];
-	for (const id of stored) managedTabIds.add(id);
-	const tabs = await chrome.tabs.query({});
-	const existingIds = new Set(tabs.map((t) => t.id).filter((id) => id !== void 0));
-	for (const id of managedTabIds) if (!existingIds.has(id)) managedTabIds.delete(id);
-	await chrome.storage.local.set({ [STORAGE_KEY]: [...managedTabIds] });
-}
-//#endregion
-//#region src/background/action-utils.ts
-/**
-* Action 处理器共享工具函数
-*
-* 纯工具函数，不依赖任何实例状态，可被多个 handler 模块直接 import 使用
-*/
-function isRestrictedUrl(url) {
-	if (!url) return true;
-	return url === "about:blank" || url.startsWith("about:") || url.startsWith("chrome://") || url.startsWith("chrome-extension://");
-}
-async function assertScriptable(tabId) {
-	const tab = await chrome.tabs.get(tabId);
-	if (isRestrictedUrl(tab.url)) throw new ExpectedOperationError(`Cannot execute on restricted URL "${tab.url}". Navigate to an http/https page first.`);
-}
-async function getTargetTabId(tabId) {
-	if (tabId !== void 0 && tabId !== null) {
-		try {
-			await chrome.tabs.get(tabId);
-		} catch {
-			throw new ExpectedOperationError(`Tab ${tabId} 不存在（可能已被关闭）`);
-		}
-		return tabId;
-	}
-	const [activeTab] = await chrome.tabs.query({
-		active: true,
-		currentWindow: true
-	});
-	if (!activeTab?.id) throw new ExpectedOperationError("No active tab found");
-	return activeTab.id;
-}
-function tabToInfo(tab, context) {
-	return {
-		id: tab.id,
-		url: tab.url || "",
-		title: tab.title || "",
-		active: tab.active,
-		windowId: tab.windowId,
-		index: tab.index,
-		groupId: tab.groupId,
-		pinned: tab.pinned,
-		incognito: tab.incognito,
-		managed: isManagedTab(tab, context),
-		status: tab.status || "unknown"
-	};
-}
-async function assertManagedTab(tabId, context, operation) {
-	let tab;
-	try {
-		tab = await chrome.tabs.get(tabId);
-	} catch {
-		throw new ExpectedOperationError(`Tab ${tabId} 不存在（可能已被关闭）`);
-	}
-	if (!isManagedTab(tab, context)) throw new ExpectedOperationError(`${operation} 拒绝操作非托管 tab, ${JSON.stringify({
-		tabId,
-		managed: false,
-		groupId: tab.groupId,
-		mcpTabGroupId: context.mcpTabGroupId,
-		windowId: tab.windowId,
-		mcpWindowId: context.mcpWindowId
-	})}, 请使用 browse(action="list") 选择 managed=true 的受控 tab, 或用 manage(action="newPage") 创建受控页面`);
-	return tab;
-}
-/**
-* 递归计算 iframe 在页面坐标系中的偏移量
-*
-* 对于嵌套 iframe，递归累加各层偏移，
-* 当多个 iframe 共享同一 URL 时，优先按同 URL 的出现顺序匹配，
-* clientLeft/clientTop 补偿 iframe 的 border，确保坐标指向内容区域起点
-*/
-async function getFrameOffset(tabId, frameId) {
-	const allFrames = await chrome.webNavigation.getAllFrames({ tabId });
-	if (!allFrames) return null;
-	const targetFrame = allFrames.find((f) => f.frameId === frameId);
-	if (!targetFrame || targetFrame.parentFrameId === -1) return null;
-	if (isRestrictedUrl((await chrome.tabs.get(tabId)).url)) return null;
-	let parentOffset = {
-		x: 0,
-		y: 0
-	};
-	if (targetFrame.parentFrameId !== 0) {
-		const po = await getFrameOffset(tabId, targetFrame.parentFrameId);
-		if (po) parentOffset = po;
-	}
-	const siblingFrames = allFrames.filter((f) => f.parentFrameId === targetFrame.parentFrameId && f.frameId !== targetFrame.parentFrameId);
-	const frameIndex = siblingFrames.findIndex((f) => f.frameId === frameId);
-	const sameUrlIndex = siblingFrames.filter((f) => f.url === targetFrame.url).findIndex((f) => f.frameId === frameId);
-	const localOffset = (await chrome.scripting.executeScript({
-		target: {
-			tabId,
-			frameIds: [targetFrame.parentFrameId]
-		},
-		world: "MAIN",
-		func: (frameUrl, frameIndex, sameUrlIndex) => {
-			const iframes = Array.from(document.querySelectorAll("iframe, frame"));
-			const urlMatches = frameUrl ? iframes.filter((iframe) => iframe.src === frameUrl) : [];
-			let target;
-			if (urlMatches.length === 1) target = urlMatches[0];
-			else if (sameUrlIndex >= 0 && sameUrlIndex < urlMatches.length) target = urlMatches[sameUrlIndex];
-			else if (frameIndex >= 0 && frameIndex < iframes.length) target = iframes[frameIndex];
-			else if (urlMatches.length > 0) target = urlMatches[0];
-			if (!target) return null;
-			const rect = target.getBoundingClientRect();
-			return {
-				x: rect.x + target.clientLeft,
-				y: rect.y + target.clientTop
-			};
-		},
-		args: [
-			targetFrame.url,
-			frameIndex,
-			sameUrlIndex
-		]
-	}))[0]?.result;
-	if (!localOffset) return null;
-	return {
-		x: parentOffset.x + localOffset.x,
-		y: parentOffset.y + localOffset.y
-	};
-}
-//#endregion
 //#region src/background/debugger-manager.ts
 var DebuggerBlockedError = class extends ExpectedOperationError {
 	code = "DEBUGGER_BLOCKED";
@@ -4778,6 +4885,13 @@ var DebuggerManager = class {
 	getExecutionContexts(tabId) {
 		return this.executionContexts.get(tabId) ?? [];
 	}
+	invalidateExecutionContext(tabId, contextId) {
+		const contexts = this.executionContexts.get(tabId);
+		if (!contexts) return;
+		const next = contexts.filter((context) => context.id !== contextId);
+		if (next.length > 0) this.executionContexts.set(tabId, next);
+		else this.executionContexts.delete(tabId);
+	}
 	setupListeners() {
 		if (this.listenersBound) return;
 		this.listenersBound = true;
@@ -5548,7 +5662,8 @@ async function simulateKeyboardType(text, delay) {
 		success: false,
 		error: `Active element is not inputable: ${activeElement.tagName}`
 	};
-	const valueSetter = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(activeElement), "value") ?? Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "value") ?? Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, "value");
+	const proto = Object.getPrototypeOf(activeElement);
+	const valueSetter = Object.getOwnPropertyDescriptor(proto, "value") ?? Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "value") ?? Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, "value");
 	const setNativeValue = (val) => {
 		if (valueSetter?.set) valueSetter.set.call(activeElement, val);
 		else if ("value" in activeElement) activeElement.value = val;
@@ -5666,7 +5781,8 @@ function injectStealthScripts() {
 		configurable: true
 	});
 	const originalChrome = window.chrome;
-	if (originalChrome && Object.getOwnPropertyDescriptor(window, "chrome")?.configurable) Object.defineProperty(window, "chrome", {
+	const chromeDescriptor = Object.getOwnPropertyDescriptor(window, "chrome");
+	if (originalChrome && chromeDescriptor?.configurable) Object.defineProperty(window, "chrome", {
 		get: () => {
 			const chrome = { ...originalChrome };
 			delete chrome.runtime;
@@ -6017,7 +6133,8 @@ function dispatchInputToElement(refId, val) {
 		error: `Element ${refId} not found`
 	};
 	el.focus();
-	const setter = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(el), "value") ?? Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "value") ?? Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, "value");
+	const proto = Object.getPrototypeOf(el);
+	const setter = Object.getOwnPropertyDescriptor(proto, "value") ?? Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "value") ?? Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, "value");
 	if (setter?.set) setter.set.call(el, val);
 	else el.value = val;
 	el.dispatchEvent(new Event("input", { bubbles: true }));
@@ -6497,53 +6614,28 @@ var FrameResolver = class {
 	async resolveFrame(params, context) {
 		const p = ResolveFrameSchema.parse(params);
 		const tabId = await this.getManagedScriptableTabId(p.tabId, context, "resolve_frame");
-		const allFrames = await chrome.webNavigation.getAllFrames({ tabId });
-		if (!allFrames) throw new Error("Failed to get frames");
-		const allChildFrames = allFrames.filter((f) => f.frameId !== 0);
-		if (allChildFrames.length === 0) throw new Error("No iframes found in page");
-		const directChildFrames = allFrames.filter((f) => f.parentFrameId === 0 && f.frameId !== 0);
-		const info = (await chrome.scripting.executeScript({
-			target: {
-				tabId,
-				frameIds: [0]
-			},
-			world: "MAIN",
-			func: (frame) => {
-				const iframes = Array.from(document.querySelectorAll("iframe, frame"));
-				let target;
-				let index = -1;
-				if (typeof frame === "number") {
-					if (frame < 0 || frame >= iframes.length) return null;
-					target = iframes[frame];
-					index = frame;
-				} else {
-					target = document.querySelector(frame);
-					if (target) index = iframes.indexOf(target);
-				}
-				if (!target) return null;
-				let absoluteSrc = target.src || "";
-				if (absoluteSrc && !absoluteSrc.startsWith("http") && !absoluteSrc.startsWith("about:")) try {
-					absoluteSrc = new URL(absoluteSrc, location.href).href;
-				} catch {}
-				return {
-					src: absoluteSrc,
-					index
-				};
-			},
-			args: [p.frame]
-		}))[0]?.result;
-		if (!info) throw new ExpectedOperationError(`iframe not found: ${typeof p.frame === "number" ? `index ${p.frame}` : `selector "${p.frame}"`}`);
-		let matchedFrameId;
-		if (info.src) {
-			const urlMatches = allChildFrames.filter((f) => f.url === info.src);
-			if (urlMatches.length === 1) matchedFrameId = urlMatches[0].frameId;
+		const snapshot = await getDomFrameSnapshot(tabId, 0, p.frame);
+		if (snapshot.selectionStatus !== "found" || snapshot.selectedIndex === null) {
+			const desc = typeof p.frame === "number" ? `index ${p.frame}` : `selector "${p.frame}"`;
+			const detail = snapshot.selectionError ? `: ${snapshot.selectionError}` : "";
+			throw new ExpectedOperationError(`iframe not found: ${desc} (${snapshot.selectionStatus})${detail}`);
 		}
-		if (matchedFrameId === void 0 && info.index >= 0 && info.index < directChildFrames.length) matchedFrameId = directChildFrames[info.index].frameId;
-		if (matchedFrameId === void 0) throw new Error(`Cannot resolve iframe to frameId. src: "${info.src}", directChildren: ${directChildFrames.length}, allFrames: ${allChildFrames.length}`);
-		const offset = await getFrameOffset(tabId, matchedFrameId);
+		const selected = snapshot.frames.find((frame) => frame.index === snapshot.selectedIndex);
+		if (!selected || selected.frameId === null) throw new ExpectedOperationError(JSON.stringify({ error: {
+			code: "FRAME_IDENTITY_UNAVAILABLE",
+			message: "Cannot map the selected DOM iframe to one Chrome frameId",
+			suggestion: "请等待 iframe 完成加载后重试；工具不会按 webNavigation 列表顺序选择其他 frame",
+			context: {
+				tabId,
+				selection: p.frame,
+				domIndex: snapshot.selectedIndex,
+				candidateFrameIds: selected?.candidateFrameIds ?? [],
+				domFrameCount: snapshot.frames.length
+			}
+		} }));
 		return {
-			frameId: matchedFrameId,
-			offset
+			frameId: selected.frameId,
+			offset: selected.contentOffset
 		};
 	}
 	async getAllFrames(params, context) {
@@ -6551,80 +6643,20 @@ var FrameResolver = class {
 		const tabId = await this.getManagedScriptableTabId(p.tabId, context, "get_all_frames");
 		const frames = await chrome.webNavigation.getAllFrames({ tabId });
 		if (!frames) throw new Error("Failed to get frames");
-		let mainFrameInfo = {
-			title: null,
-			rect: {
-				x: 0,
-				y: 0,
-				width: 0,
-				height: 0
-			}
-		};
-		let domFrames = [];
-		try {
-			const pageFrames = (await chrome.scripting.executeScript({
-				target: {
-					tabId,
-					frameIds: [0]
-				},
-				world: "MAIN",
-				func: () => ({
-					main: {
-						title: document.title || null,
-						rect: {
-							x: 0,
-							y: 0,
-							width: window.innerWidth,
-							height: window.innerHeight
-						}
-					},
-					frames: Array.from(document.querySelectorAll("iframe, frame")).map((frame, index) => {
-						const el = frame;
-						const rect = el.getBoundingClientRect();
-						const selector = el.id ? `#${CSS.escape(el.id)}` : `${el.tagName.toLowerCase()}:nth-of-type(${index + 1})`;
-						return {
-							index,
-							url: el.src || "",
-							title: el.title || null,
-							name: el.name || null,
-							selector,
-							rect: {
-								x: rect.x,
-								y: rect.y,
-								width: rect.width,
-								height: rect.height
-							}
-						};
-					})
-				})
-			}))[0]?.result;
-			mainFrameInfo = pageFrames?.main ?? mainFrameInfo;
-			domFrames = pageFrames?.frames ?? [];
-		} catch {
-			domFrames = [];
-		}
-		const directChildFrames = frames.filter((frame) => frame.parentFrameId === 0 && frame.frameId !== 0);
-		const getDomFrame = (frame) => {
-			if (frame.parentFrameId !== 0) return;
-			const directIndex = directChildFrames.findIndex((candidate) => candidate.frameId === frame.frameId);
-			const byIndex = directIndex >= 0 ? domFrames[directIndex] : void 0;
-			if (byIndex) return byIndex;
-			const navigationMatches = directChildFrames.filter((candidate) => candidate.url === frame.url);
-			const domMatches = domFrames.filter((candidate) => candidate.url === frame.url);
-			return navigationMatches.length === 1 && domMatches.length === 1 ? domMatches[0] : void 0;
-		};
+		const snapshot = await getDomFrameSnapshot(tabId, 0);
+		const domFramesByFrameId = new Map(snapshot.frames.filter((frame) => frame.frameId !== null).map((frame) => [frame.frameId, frame]));
 		return { frames: frames.map((frame, index) => {
 			const isMainFrame = frame.frameId === 0;
-			const dom = isMainFrame ? void 0 : getDomFrame(frame);
+			const dom = isMainFrame ? void 0 : domFramesByFrameId.get(frame.frameId);
 			return {
 				index,
 				frameId: frame.frameId,
 				parentFrameId: isMainFrame ? null : frame.parentFrameId,
 				url: frame.url,
-				title: isMainFrame ? mainFrameInfo.title : dom?.title ?? null,
+				title: isMainFrame ? snapshot.parent.title : dom?.title ?? null,
 				name: isMainFrame ? null : dom?.name ?? null,
 				selector: isMainFrame ? null : dom?.selector ?? null,
-				rect: isMainFrame ? mainFrameInfo.rect : dom?.rect ?? null
+				rect: isMainFrame ? snapshot.parent.rect : dom?.rect ?? null
 			};
 		}) };
 	}
@@ -6636,40 +6668,154 @@ var FrameResolver = class {
 	*/
 	async evaluateInFrame(params, context) {
 		const p = EvaluateInFrameSchema.parse(params);
-		const returnByValue = params?.returnByValue;
-		const awaitPromise = params?.awaitPromise;
+		const options = params;
 		const tabId = await this.getManagedScriptableTabId(p.tabId, context, "evaluate_in_frame");
 		await this.debuggerManager.ensureAttached(tabId);
-		const extFrames = await chrome.webNavigation.getAllFrames({ tabId });
-		if (!extFrames) throw new Error("Failed to enumerate frames");
-		const targetFrame = extFrames.find((f) => f.frameId === p.frameId);
-		if (!targetFrame) throw new ExpectedOperationError(`Frame ${p.frameId} not found`);
-		const treeResult = await chrome.debugger.sendCommand({ tabId }, "Page.getFrameTree");
-		const cdpFrameIds = this.findCdpFrameIds(treeResult.frameTree, targetFrame.url);
-		if (cdpFrameIds.length === 0) throw new Error(`Cannot resolve CDP frame for URL: ${targetFrame.url}`);
-		if (cdpFrameIds.length > 1) throw new ExpectedOperationError(`Multiple CDP frames (${cdpFrameIds.length}) match URL "${targetFrame.url}". Cannot uniquely identify target iframe for precise evaluate. Use stealth mode or ensure iframes have distinct URLs.`);
-		const cdpFrameId = cdpFrameIds[0];
-		let contexts = this.debuggerManager.getExecutionContexts(tabId);
-		if (contexts.length === 0) await chrome.debugger.sendCommand({ tabId }, "Runtime.enable");
-		let targetCtx = contexts.find((c) => c.frameId === cdpFrameId && c.isDefault);
-		if (!targetCtx) {
-			const maxAttempts = Math.ceil((p.timeout ?? 2e3) / 100);
-			for (let i = 0; i < maxAttempts; i++) {
-				await new Promise((resolve) => setTimeout(resolve, 100));
+		const startedAt = Date.now();
+		const originalFrame = await this.getExtensionFrameIdentity(tabId, p.frameId);
+		let retryAttempted = false;
+		let retryReason;
+		const maxAttempts = p.staleContextRetry === "readOnly" ? 2 : 1;
+		for (let attempt = 0; attempt < maxAttempts; attempt++) {
+			const remaining = p.timeout === void 0 ? void 0 : p.timeout - (Date.now() - startedAt);
+			if (remaining !== void 0 && remaining <= 0) throw this.frameEvaluationError("FRAME_EVALUATION_TIMEOUT", "Frame evaluation timed out before resolution", {
+				tabId,
+				extensionFrameId: p.frameId,
+				timeout: p.timeout,
+				retryAttempted,
+				retryReason
+			});
+			const identity = await this.getExtensionFrameIdentity(tabId, p.frameId);
+			if (identity.parentFrameId !== originalFrame.parentFrameId || identity.frameId !== originalFrame.frameId) throw this.frameEvaluationError("FRAME_IDENTITY_CHANGED", "Frame identity changed before stale-context retry; refusing to guess target", {
+				tabId,
+				retryAttempted,
+				retryReason,
+				originalFrame: this.frameIdentitySummary(originalFrame),
+				currentFrame: this.frameIdentitySummary(identity)
+			});
+			const resolved = await this.resolveCdpFrame(tabId, identity.url);
+			let contexts = this.debuggerManager.getExecutionContexts(tabId);
+			if (contexts.length === 0 || attempt > 0) await chrome.debugger.sendCommand({ tabId }, "Runtime.enable");
+			let targetCtx = contexts.find((item) => item.frameId === resolved.cdpFrameId && item.isDefault);
+			const deadline = p.timeout === void 0 ? Date.now() + 2e3 : startedAt + p.timeout;
+			while (!targetCtx && Date.now() < deadline) {
+				await new Promise((resolve) => setTimeout(resolve, Math.min(100, Math.max(1, deadline - Date.now()))));
 				contexts = this.debuggerManager.getExecutionContexts(tabId);
-				targetCtx = contexts.find((c) => c.frameId === cdpFrameId && c.isDefault);
-				if (targetCtx) break;
+				targetCtx = contexts.find((item) => item.frameId === resolved.cdpFrameId && item.isDefault);
+			}
+			if (!targetCtx) throw this.frameEvaluationError("FRAME_CONTEXT_UNAVAILABLE", "No execution context for frame", {
+				tabId,
+				...this.frameIdentitySummary(identity),
+				cdpFrameId: resolved.cdpFrameId,
+				contextCount: contexts.length,
+				retryAttempted,
+				retryReason
+			});
+			const evaluationTimeout = p.timeout === void 0 ? void 0 : p.timeout - (Date.now() - startedAt);
+			if (evaluationTimeout !== void 0 && evaluationTimeout <= 0) throw this.frameEvaluationError("FRAME_EVALUATION_TIMEOUT", "Frame evaluation timed out before Runtime.evaluate", {
+				tabId,
+				...this.frameIdentitySummary(identity),
+				cdpFrameId: resolved.cdpFrameId,
+				executionContextId: targetCtx.id,
+				timeout: p.timeout,
+				retryAttempted,
+				retryReason
+			});
+			const evalParams = {
+				contextId: targetCtx.id,
+				expression: p.expression,
+				returnByValue: options.returnByValue ?? true,
+				awaitPromise: options.awaitPromise ?? true,
+				...evaluationTimeout !== void 0 ? { timeout: evaluationTimeout } : {}
+			};
+			try {
+				return {
+					...await chrome.debugger.sendCommand({ tabId }, "Runtime.evaluate", evalParams),
+					retryAttempted,
+					retryReason,
+					staleContextRetry: p.staleContextRetry,
+					frameContext: {
+						tabId,
+						extensionFrameId: identity.frameId,
+						parentFrameId: identity.parentFrameId,
+						url: identity.url.slice(0, 500),
+						originalUrl: originalFrame.url.slice(0, 500),
+						urlChanged: identity.url !== originalFrame.url,
+						cdpFrameId: resolved.cdpFrameId,
+						executionContextId: targetCtx.id
+					}
+				};
+			} catch (error) {
+				const message = error instanceof Error ? error.message : String(error);
+				const staleContext = /context.*(?:destroyed|not found|invalid)|Cannot find context|Execution context/i.test(message);
+				if (attempt > 0) throw this.frameEvaluationError("FRAME_EVALUATION_FAILED", message.slice(0, 500), {
+					tabId,
+					...this.frameIdentitySummary(identity),
+					cdpFrameId: resolved.cdpFrameId,
+					executionContextId: targetCtx.id,
+					retryAttempted,
+					retryReason
+				});
+				if (!staleContext) throw error;
+				if (p.staleContextRetry !== "readOnly") throw this.frameEvaluationError("FRAME_STALE_CONTEXT", "Execution context became stale; script was not replayed because staleContextRetry is never", {
+					tabId,
+					...this.frameIdentitySummary(identity),
+					cdpFrameId: resolved.cdpFrameId,
+					executionContextId: targetCtx.id,
+					retryAttempted: false,
+					staleContextRetry: p.staleContextRetry
+				});
+				retryAttempted = true;
+				retryReason = message.slice(0, 500);
+				this.debuggerManager.invalidateExecutionContext(tabId, targetCtx.id);
+				if (p.timeout !== void 0 && Date.now() - startedAt >= p.timeout) throw this.frameEvaluationError("FRAME_EVALUATION_TIMEOUT", message.slice(0, 500), {
+					tabId,
+					...this.frameIdentitySummary(identity),
+					cdpFrameId: resolved.cdpFrameId,
+					executionContextId: targetCtx.id,
+					timeout: p.timeout,
+					retryAttempted,
+					retryReason
+				});
 			}
 		}
-		if (!targetCtx) throw new Error(`No execution context for frame (CDP: ${cdpFrameId}, contexts: ${contexts.length})`);
-		const evalParams = {
-			contextId: targetCtx.id,
-			expression: p.expression,
-			returnByValue: returnByValue ?? true,
-			awaitPromise: awaitPromise ?? true
+		throw new Error("Stale execution context retry exhausted");
+	}
+	frameIdentitySummary(frame) {
+		return {
+			extensionFrameId: frame.frameId,
+			parentFrameId: frame.parentFrameId,
+			url: frame.url.slice(0, 500)
 		};
-		if (p.timeout !== void 0) evalParams.timeout = p.timeout;
-		return await chrome.debugger.sendCommand({ tabId }, "Runtime.evaluate", evalParams);
+	}
+	frameEvaluationError(code, message, context) {
+		return new ExpectedOperationError(JSON.stringify({ error: {
+			code,
+			message,
+			suggestion: "请重新读取 frame 列表和页面状态；若 frame 候选不唯一，请改用唯一 URL 或 selector",
+			context
+		} }));
+	}
+	async getExtensionFrameIdentity(tabId, frameId) {
+		const frame = (await chrome.webNavigation.getAllFrames({ tabId }))?.find((candidate) => candidate.frameId === frameId);
+		if (!frame) throw new ExpectedOperationError(`Frame ${frameId} not found`);
+		return frame;
+	}
+	async resolveCdpFrame(tabId, targetUrl) {
+		const treeResult = await chrome.debugger.sendCommand({ tabId }, "Page.getFrameTree");
+		const candidates = this.findCdpFrameIds(treeResult.frameTree, targetUrl);
+		if (candidates.length === 0) throw this.frameEvaluationError("FRAME_CDP_UNAVAILABLE", "Cannot resolve CDP frame for URL", {
+			tabId,
+			url: targetUrl.slice(0, 500),
+			candidateCount: 0
+		});
+		if (candidates.length > 1) throw this.frameEvaluationError("FRAME_AMBIGUOUS", "Multiple CDP frames match the same URL; refusing to guess target", {
+			tabId,
+			url: targetUrl.slice(0, 500),
+			candidateCount: candidates.length,
+			candidates: candidates.slice(0, 10)
+		});
+		return { cdpFrameId: candidates[0] };
 	}
 	async getManagedScriptableTabId(tabId, context, operation) {
 		const resolvedTabId = await getTargetTabId(tabId);
@@ -8143,6 +8289,25 @@ function randomHex(bytes = 16) {
 	crypto.getRandomValues(data);
 	return bytesToHex(data);
 }
+var backgroundBundleHashPromise;
+async function loadBackgroundBundleHash() {
+	try {
+		const response = await fetch(chrome.runtime.getURL("service-worker-loader.js"), { cache: "no-store" });
+		if (!response.ok) {
+			console.warn(`[HTTP] Cannot read Extension service worker loader: HTTP ${response.status}`);
+			return;
+		}
+		const digest = await crypto.subtle.digest("SHA-256", await response.arrayBuffer());
+		return `sha256:${bytesToHex(new Uint8Array(digest))}`;
+	} catch (error) {
+		console.warn("[HTTP] Cannot compute Extension background bundle hash:", error instanceof Error ? error.message : String(error));
+		return;
+	}
+}
+function getBackgroundBundleHash() {
+	backgroundBundleHashPromise ??= loadBackgroundBundleHash();
+	return backgroundBundleHashPromise;
+}
 async function hmacHex(token, payload) {
 	const encoder = new TextEncoder();
 	const key = await crypto.subtle.importKey("raw", encoder.encode(token), {
@@ -8164,6 +8329,7 @@ var HttpClient = class {
 	pairingToken = null;
 	pairingTokenLoaded = false;
 	allowInsecureNoToken = null;
+	lastServerFailureSummary = "";
 	onMessage(handler) {
 		this.messageHandler = handler;
 	}
@@ -8212,7 +8378,11 @@ var HttpClient = class {
 				};
 			}
 			const newPorts = healthyPorts.filter((p) => !this.connections.has(p));
-			if ((await Promise.allSettled(newPorts.map((port) => this.connectToPort(port)))).filter((r) => r.status === "fulfilled" && r.value).length > 0) this.reconnectAttempts = 0;
+			const results = await Promise.allSettled(newPorts.map((port) => this.connectToPort(port)));
+			const successCount = results.filter((r) => r.status === "fulfilled" && r.value).length;
+			const failedPorts = newPorts.filter((_, index) => results[index].status !== "fulfilled" || !results[index].value);
+			if (failedPorts.length > 0) console.debug(`[HTTP] ${failedPorts.length} candidate WebSocket connection(s) rejected before open: ${failedPorts.slice(0, 10).join(", ")}${failedPorts.length > 10 ? ", ..." : ""}`);
+			if (successCount > 0) this.reconnectAttempts = 0;
 			const ports = this.getConnectedPorts();
 			if (ports.length === 0 && this.shouldReconnect) this.scheduleReconnect();
 			return {
@@ -8277,18 +8447,27 @@ var HttpClient = class {
 				const auth = this.verifiedAuth.get(port);
 				const url = `ws://127.0.0.1:${port}/${auth ? `?clientNonce=${encodeURIComponent(auth.clientNonce)}&serverNonce=${encodeURIComponent(auth.serverNonce)}&clientProof=${encodeURIComponent(auth.clientProof)}` : ""}`;
 				const ws = new WebSocket(url);
+				let opened = false;
 				let resolved = false;
+				const rejectCandidate = () => {
+					if (!resolved) {
+						resolved = true;
+						resolve(false);
+					}
+				};
 				const connectionTimeout = setTimeout(() => {
 					if (ws.readyState !== WebSocket.OPEN) {
+						rejectCandidate();
 						ws.close();
-						if (!resolved) {
-							resolved = true;
-							resolve(false);
-						}
 					}
 				}, 5e3);
 				ws.onopen = () => {
 					clearTimeout(connectionTimeout);
+					if (resolved) {
+						ws.close();
+						return;
+					}
+					opened = true;
 					resolved = true;
 					const conn = {
 						ws,
@@ -8296,10 +8475,14 @@ var HttpClient = class {
 					};
 					this.connections.set(port, conn);
 					this.resetHeartbeat(port);
-					ws.send(JSON.stringify({
-						type: "hello",
-						version: chrome.runtime.getManifest().version
-					}));
+					getBackgroundBundleHash().then((backgroundBundleHash) => {
+						if (ws.readyState !== WebSocket.OPEN) return;
+						ws.send(JSON.stringify({
+							type: "hello",
+							version: chrome.runtime.getManifest().version,
+							...backgroundBundleHash ? { backgroundBundleHash } : {}
+						}));
+					});
 					console.log(`[HTTP] Connected to MCP Server at port ${port} (total: ${this.connections.size})`);
 					this.statusHandler?.("connected", this.connections.size);
 					resolve(true);
@@ -8308,17 +8491,22 @@ var HttpClient = class {
 					this.handleMessage(event.data, port);
 				};
 				ws.onclose = () => {
+					clearTimeout(connectionTimeout);
+					if (!opened) {
+						rejectCandidate();
+						return;
+					}
 					console.log(`[HTTP] WebSocket closed for port ${port}`);
 					this.removeConnection(port);
 				};
 				ws.onerror = (error) => {
 					clearTimeout(connectionTimeout);
-					console.error(`[HTTP] WebSocket error for port ${port}:`, error);
-					if (resolved) this.removeConnection(port);
-					else {
-						resolved = true;
-						resolve(false);
+					if (opened) {
+						console.error(`[HTTP] Established WebSocket error for port ${port}:`, error);
+						this.removeConnection(port);
+						return;
 					}
+					rejectCandidate();
 				};
 			} catch {
 				resolve(false);
@@ -8345,41 +8533,74 @@ var HttpClient = class {
 	* 完整扫描整段范围，保证多 CC 并存时新启动的 server 能被发现
 	*/
 	async discoverServers() {
-		const healthyPorts = [];
 		const checks = [];
-		for (let port = PORT_RANGE_START; port <= PORT_RANGE_END; port++) checks.push(this.checkPort(port).then((ok) => {
-			if (ok) healthyPorts.push(port);
-		}));
-		await Promise.all(checks);
+		for (let port = PORT_RANGE_START; port <= PORT_RANGE_END; port++) checks.push(this.checkPort(port).then((result) => ({
+			port,
+			result
+		})));
+		const results = await Promise.all(checks);
+		const healthyPorts = results.filter(({ result }) => result.healthy).map(({ port }) => port);
+		const selectedFailures = results.filter(({ result }) => result.failureKind);
+		const failureSummary = selectedFailures.slice(0, 10).map(({ port, result }) => `${port} (${result.failureKind}: ${result.reason})`).join(", ");
+		if (failureSummary && failureSummary !== this.lastServerFailureSummary) console.warn(`[HTTP] ${selectedFailures.length} MCP Server candidate(s) rejected after health identification: ${failureSummary}${selectedFailures.length > 10 ? ", ..." : ""}`);
+		this.lastServerFailureSummary = failureSummary;
 		if (healthyPorts.length > 0) console.log(`[HTTP] Found ${healthyPorts.length} MCP Server(s) at ports: ${healthyPorts.sort((a, b) => a - b).join(", ")}`);
 		else console.log("[HTTP] No MCP Server found in port range");
 		return healthyPorts.sort((a, b) => a - b);
 	}
 	async checkPort(port) {
+		const controller = new AbortController();
+		const timeoutId = setTimeout(() => controller.abort(), HEALTH_CHECK_TIMEOUT);
 		try {
 			const token = await this.getPairingToken();
 			const clientNonce = randomHex();
-			const controller = new AbortController();
-			const timeoutId = setTimeout(() => controller.abort(), HEALTH_CHECK_TIMEOUT);
 			const response = await fetch(`http://127.0.0.1:${port}/api/health?clientNonce=${clientNonce}`, { signal: controller.signal });
-			clearTimeout(timeoutId);
-			if (!response.ok) return false;
+			if (!response.ok) return { healthy: false };
 			const health = await response.json().catch(() => null);
-			if (health?.authRequired) {
-				if (!token || !health.auth?.serverNonce || !health.auth.serverProof) return false;
-				if (await hmacHex(token, `server:${clientNonce}:${health.auth.serverNonce}`) !== health.auth.serverProof) return false;
+			if (!health || typeof health.authRequired !== "boolean") return { healthy: false };
+			if (health.authRequired) {
+				if (!token) return {
+					healthy: false,
+					failureKind: "authentication",
+					reason: "pairing token missing"
+				};
+				if (!health.auth?.serverNonce || !health.auth.serverProof) return {
+					healthy: false,
+					failureKind: "protocol",
+					reason: "authentication challenge incomplete"
+				};
+				if (await hmacHex(token, `server:${clientNonce}:${health.auth.serverNonce}`) !== health.auth.serverProof) return {
+					healthy: false,
+					failureKind: "authentication",
+					reason: "server proof mismatch"
+				};
 				this.verifiedAuth.set(port, {
 					clientNonce,
 					serverNonce: health.auth.serverNonce,
 					clientProof: await hmacHex(token, `client:${clientNonce}:${health.auth.serverNonce}`)
 				});
-				return true;
+				return { healthy: true };
 			}
-			if (token || !await this.getAllowInsecureNoToken()) return false;
+			if (token) return {
+				healthy: false,
+				failureKind: "authentication",
+				reason: "client token configured for no-token server"
+			};
+			if (!await this.getAllowInsecureNoToken()) return {
+				healthy: false,
+				failureKind: "authentication",
+				reason: "local no-token policy disabled"
+			};
 			this.verifiedAuth.delete(port);
-			return health?.status === "ok";
+			return health.status === "ok" ? { healthy: true } : {
+				healthy: false,
+				failureKind: "protocol",
+				reason: "health status is not ok"
+			};
 		} catch {
-			return false;
+			return { healthy: false };
+		} finally {
+			clearTimeout(timeoutId);
 		}
 	}
 	handleMessage(data, port) {
@@ -8466,11 +8687,11 @@ httpClient.onStatusChange((status, count) => {
 	updateBadge(status, count);
 	broadcastStatus(status, count);
 });
-chrome.runtime.onMessage.addListener((message, _sender, sendResponse) => {
-	handleInternalMessage(message).then(sendResponse);
+chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
+	handleInternalMessage(message, sender).then(sendResponse);
 	return true;
 });
-async function handleInternalMessage(message) {
+async function handleInternalMessage(message, sender) {
 	switch (message.type) {
 		case "CONNECT": return httpClient.connect();
 		case "DISCONNECT":
@@ -8488,6 +8709,7 @@ async function handleInternalMessage(message) {
 			pairingTokenConfigured: await httpClient.hasPairingToken(),
 			allowInsecureNoToken: await httpClient.isAllowInsecureNoToken()
 		};
+		case "MCP_FRAME_PROBE": return recordDomFrameProbe(message, sender);
 		default: return { error: "Unknown message type" };
 	}
 }