[columbia11]

Refs #556

Problem

When the click overlay guard can't clear the extension overlay, input_not_ready returns only "Could not clear the extension overlay from the click point". There are no coordinates and nothing about which step failed. The dispatcher's bypassOverlay also swallows chrome.tabs.sendMessage failures, so an unreachable content script left no trace. In #556 the page also had its own mask, and the agent couldn't tell which layer was in the way.

Change

• click-overlay.ts: input_not_ready now includes

  • data.point: the click point in CSS px;
  • data.overlay.hit: the last hit-test result (absent / clear / covered / unknown);
  • data.overlay.bypass: not_needed / enabled / undelivered / failed / unavailable;
  • data.overlay.passthrough: not_needed / sent / failed;
  • data.overlay.deadline_reached.

  The same facts go into the message for text output, e.g. … (10, 20): hit-test covered, bypass undelivered, passthrough failed.

• dispatcher.ts: bypassOverlay still never throws, but now resolves true or false depending on whether the content script received the request. The five bypassOverlay type declarations widen from Promise<void> to Promise<boolean | void> (type-only).

Not included: the element hit at the point and the overlay part (data-slot). The hit-test runs in the page's main world and sees only the overlay host, not its shadow contents, so that would need a content-script query. I left it out to keep this small.

Tests

• New click-overlay.test.ts: a covered point with an undelivered bypass and a failed passthrough, and a covered point with no bypass but a delivered passthrough. Both fail without the change.
• Click, drag, wheel, dispatcher and interaction tests: 279 passed. Full extension vitest run: 3604 passed, 2 failed (the png 120k-scanline test and the human-loop child-process test, which time out under full parallel load and pass alone).
• tsc --noEmit: exit 0. biome check on the changed files: clean.

I used Claude Code to write the change and tests and run the checks above.

🤖 Generated with Claude Code