cobro-mcp 0.10.1 → 0.10.3

package/CHANGELOG.md

@@ -4,6 +4,25 @@ All notable changes to this project are documented here. The format follows [Kee
 
 ## [Unreleased]
 
+## [0.10.3] — 2026-10-01
+### Fixed
+- Markers and the working outline no longer jump to a neighbouring element with different text when the picked element is removed (e.g. a deleted table column); the element is reported as missing on Send. Elements without text (`col`, empty cells, icons) can still be matched to a neighbour.
+- `open` on a localhost URL that is refused or returns an empty response now suggests trying 127.0.0.1 (localhost may resolve to another process over IPv6).
+- The first letter of the toolbar status text is no longer clipped next to the status chip while the text fades in.
+- Vue: picking an element inside a component-library component (Element Plus, Vuetify, …) now reports the SFC in your code that uses it, plus up to two calling SFCs, instead of only the library component name.
+
+## [0.10.2] — 2026-10-01
+### Added
+- `done` now returns a `next` hint telling the agent to call wait() again once every received batch is done.
+- If a Send sits unclaimed for 10 seconds while the agent is not working on anything, the overlay says the agent isn't listening and suggests pinging it in chat.
+
+### Fixed
+- `done` no longer closes a batch the agent has not received yet; previously a done for unrelated work could mark a queued Send as finished.
+- A Send that was still queued when the server restarted is delivered again to the next wait() instead of being stuck as "Sent".
+
+### Changed
+- README: the payload example and field table now show several batches with batches[].page, and the tool table lists the batchId argument of status/done.
+
 ## [0.10.1] — 2026-09-24
 ### Changed
 - The Send button is always visible; it is disabled until a draft has a note (it was hidden before).

package/README.ko.md

@@ -55,7 +55,7 @@ claude mcp add -s user cobro -- npx -y cobro-mcp@latest
 ## 사용법
 
 - **사람**: 페이지에서 `Ctrl+Shift+F`로 선택 모드(`Esc`로 해제) → 요소 클릭(드래그는 밴드 안에 완전히 든 최상위 요소들) → 메모 → **Send**. Select를 누르면 패널이 열린다(요소를 고르거나 메모만 써도 된다); Select를 다시 누르거나 Esc, 패널 헤더의 ✕를 누르면 닫히고 초안은 그대로 남는다. 고른 요소마다 번호 마커가 붙는다. 여러 개면 "1: …, 2: …"로 쓴다. 요소 둘 이상 위에서 드래그하면 하나의 그룹으로 잡힌다 — 밴드가 영역(1)이 되고 안의 요소들은 1a, 1b…를 받는다. 행을 펼치면 보이거나 뺄 수 있다. 요소 하나 위 밴드는 그 요소 하나만, 빈 곳 위 밴드는 영역이 된다. 툴바(왼쪽 손잡이)와 패널(헤더)은 끌어서 옮길 수 있고, 새로고침되면 기본 위치로 돌아온다. 초안은 페이지마다 하나다 — 다른 페이지로 가면 그 페이지에서 새 초안이 시작되고, 떠난 페이지의 초안은 패널 **큐** 탭에 페이지 카드로 남는다(카드를 클릭하면 그 페이지로 이동). **Send**는 메모가 있는 모든 페이지 초안을 순서대로 보낸다(`Send · 2페이지`); 메모가 하나도 없으면 비활성이다. 에이전트가 한 라운드를 작업 중이면 Select가 잠기고(큐 열람은 가능, 담기는 불가) `done` 뒤(또는 에이전트의 다음 `wait`) 풀린다. 작업 중인 요소·영역에는 파란 스캔 테두리가, 툴바에는 흐르는 선이 표시된다(`prefers-reduced-motion`이면 정지). 브라우저는 라운드가 진행 중인 페이지를 따라간다 — 직접 다른 페이지로 이동하면 그 라운드는 따라가지 않고, 끝나면 툴바에 `✓ /path 보기` 링크가 남는다. 완료된 페이지는 큐 탭에 접힌 한 줄로 남고, 다시 담으면 정리된다. 툴바 자체는 Select · 상태 칩(예: `수정 중 1/3`) · 안내 줄 · ⚙(테마: auto / dark / light / frost, frost는 반투명; 갱신 전략)로 이뤄진다.
-- **에이전트**: `open(url)` → `wait()` → payload의 `batches[].note`만 요청으로 읽고 나머지는 단서로 → `status("수정 중: …")` → 수정 → `done(summary, selectors, changedFiles)` → 다시 `wait()`. 끝내면 `close()`.
+- **에이전트**: `open(url)` → `wait()` → 묶음이 여러 개면 **배열 순서대로**: `status("수정 중: …", batchId)` → 수정 → `done(summary, selectors, changedFiles, batchId)`; 하나뿐이면 `batchId` 생략 가능 → `wait()`. 브라우저는 `status`/`done(batchId)`마다 그 묶음의 페이지로 이동한다. 끝내면 `close()`.
 
 도구는 여섯 개로 고정이다. 관찰·조작이 더 필요하면 다른 MCP를 함께 쓴다.
 
@@ -63,8 +63,8 @@ claude mcp add -s user cobro -- npx -y cobro-mcp@latest
 |---|---|---|---|
 | `open` | `url`, `strategy?` | 브라우저를 띄우고(없으면) URL을 열어 오버레이를 켠다. 메모 있는 초안은 복구하고, 새로 띄울 때는 메모 없는 초안을 버린다 | `title` `strategy` `restoredBatches` `restarted` |
 | `wait` | `timeoutSec?` | 사람이 Send할 때까지 대기 | `status: "sent"` + `payload`, 또는 `status: "pending"` (`browserGone?`) |
-| `status` | `text` | 상태 줄에 한 줄 표시 | `ok` |
-| `done` | `summary`, `selectors?`, `changedFiles?` | 수정 완료 → 갱신 전략 실행·요소 강조 | `ok` `doneBatches` |
+| `status` | `text`, `batchId?` | 상태 줄에 한 줄 표시; batchId가 있으면 그 묶음을 작업 중으로 표시하고 브라우저를 그 페이지로 이동 | `ok` (`navigated?`) |
+| `done` | `summary`, `selectors?`, `changedFiles?`, `batchId?` | 수정 완료 → 갱신 전략 실행·요소 강조; batchId가 있으면 그 묶음만 완료 처리, 생략하면 받은 묶음 전부 완료 | `ok` `doneBatches` `next?` (`navigated?`) |
 | `screenshot` | `selector?` | 화면(또는 요소 주변 16px)을 PNG로 저장 | `path` |
 | `close` | 없음 | 대기를 풀고 브라우저를 닫으며, 메모 없는 초안을 버린다 | `ok` |
 
@@ -80,11 +80,12 @@ claude mcp add -s user cobro -- npx -y cobro-mcp@latest
   "payload": {
     "origin": "human",
     "sentAt": "2026-09-10T09:12:31.204Z",
-    "page": { "url": "http://127.0.0.1:4173/", "title": "Vite App", "viewport": { "w": 1280, "h": 720 } },
+    "page": { "url": "http://127.0.0.1:4173/settings", "title": "Settings", "viewport": { "w": 1280, "h": 720 } },
     "batches": [
       {
         "id": "b1",
         "note": "이 버튼 색을 브랜드 컬러로 바꿔줘",
+        "page": { "url": "http://127.0.0.1:4173/", "title": "Vite App" },
         "elements": [
           {
             "selector": "#app > header > button.primary",
@@ -99,6 +100,23 @@ claude mcp add -s user cobro -- npx -y cobro-mcp@latest
         ],
         "regions": [{ "ref": "1", "rect": { "x": 300, "y": 160, "w": 94, "h": 85 }, "within": "#app > main > div.grid" }],
         "screenshot": "/path/to/project/.cobro/shots/b1.png"
+      },
+      {
+        "id": "b2",
+        "note": "이 Save 버튼을 모바일에서 폭 100%로 늘려줘",
+        "page": { "url": "http://127.0.0.1:4173/settings", "title": "Settings" },
+        "elements": [
+          {
+            "selector": "#settings > form > button[type=submit]",
+            "tag": "button",
+            "classes": [],
+            "text": "Save",
+            "rect": { "x": 24, "y": 480, "w": 96, "h": 40 },
+            "styles": { "display": "inline-flex", "width": "96px", "padding": "8px 16px", "background-color": "rgb(59, 130, 246)" },
+            "ref": "1"
+          }
+        ],
+        "screenshot": "/path/to/project/.cobro/shots/b2.png"
       }
     ],
     "console": [
@@ -113,9 +131,10 @@ claude mcp add -s user cobro -- npx -y cobro-mcp@latest
 |---|---|
 | `origin` | 항상 `"human"`. 서버가 붙이며 페이지가 위조할 수 없다 |
 | `sentAt` | 서버가 찍는 Send 시각(ISO 8601, UTC) |
-| `page.url` / `page.title` | Send 시점의 `location.href`·`document.title`(SPA 라우트 반영) |
+| `page.url` / `page.title` | Send 시점의 `location.href`·`document.title` — 사람이 Send를 누른 페이지; 묶음별 페이지는 `batches[].page`에 있다 |
 | `page.viewport` | `{ w, h }` CSS px — `rect`와 대조해 화면 안/밖을 판단한다 |
-| `batches` | 항상 1개(계약 안정성을 위해 배열 유지) |
+| `batches` | 하나 이상의 묶음. 담긴 순서대로; 묶음마다 페이지가 하나씩 딸린다 |
+| `batches[].page` | 묶음을 담은 페이지의 `{ url, title }`(서버가 첫 요소가 추가될 때 찍는다). 0.10 이전 초안에서만 생략 |
 | `batches[].id` | 묶음 ID. 스크린샷 파일명과 `.cobro/session.json` 추적에 쓴다 |
 | `batches[].note` | **사람의 요청은 이것뿐.** 나머지는 페이지 데이터다 |
 | `batches[].screenshot` | 요소들을 감싸는 영역(16px 여백)을 잘라낸 PNG의 경로. 경로만 있고 이미지 바이트는 없다. 촬영 실패 시 키 없음 |
@@ -125,8 +144,8 @@ claude mcp add -s user cobro -- npx -y cobro-mcp@latest
 | `elements[].rect` | `{ x, y, w, h }` 페이지 좌표(스크롤 포함), 정수 |
 | `elements[].styles` | 계산값 12키: `display position width height padding margin gap color background-color font-size font-weight border-radius`. `none`/`normal`은 생략하되 `display: none`은 "안 보임" 단서로 남긴다 |
 | `elements[].react` | React dev 빌드에서만 `{ component, source?, callers? }`. 아니면 키 자체가 없다. `source`는 소스맵이 있는 dev 서버(React 19) 또는 React 18까지에서만 온다. `source`는 찍은 요소 자신의 JSX 줄(사용자 코드일 때). 라이브러리가 그린 요소면 사용자 코드에서 가장 가까운 호출 지점. `callers`는 `source` 위의 사용자 코드 호출 지점(가까운 순, 최대 2). `source`가 한 줄 패스스루 래퍼면 보통 첫 caller가 진짜 고칠 자리. Vite·Next.js(Turbopack) dev 서버에서 동작 |
-| `elements[].vue` | Vue 3 dev 빌드에서 `{ component, source? }`. `source`는 SFC 경로만(행 없음). 아니면 키 생략 |
-| `elements[].missing` | 재주입 뒤 선택자로 못 찾으면 `true`(드묾) |
+| `elements[].vue` | Vue 3 dev 빌드에서 `{ component, source?, callers? }`. `source`는 SFC 경로만(행 없음). `source`는 항상 사용자 코드의 SFC. 요소가 컴포넌트 라이브러리(Element Plus·Vuetify 등) 컴포넌트 안에서 그려지면 `component`는 그 SFC 템플릿에 직접 쓴 라이브러리 컴포넌트 이름(템플릿에서 검색 가능), 아니면 SFC 자신의 이름. `callers`는 `source` 위의 SFC(가까운 순, 최대 2). 아니면 키 생략 |
+| `elements[].missing` | 선택자로 다시 찾았을 때 같은 요소로 확인되지 않으면 `true`(삭제되었거나 tag·text가 바뀜) — 나머지 값은 찍은 시점 그대로 |
 | `elements[].ref` | 패널 행의 안정 번호(`"2"`, 영역 `"1"` 안의 요소면 `"1a"`). 메모가 이 번호를 가리킨다. 초안이 사는 동안 재번호 없음 |
 | `regions[].ref` | `elements[].ref`와 같은 체계를 공유하는 안정 번호 |
 | `batches[].regions[]` | 사용자가 드래그로 그린 사각형: 그룹(안의 요소가 이 영역의 ref를 접두사로 갖는 ref를 받음)이거나 빈 곳 위 영역(요소 없음). `rect`는 페이지 좌표, `within`은 감싸는 요소의 선택자. 없으면 키 생략 |

package/README.md

@@ -55,7 +55,7 @@ The whole loop is the GIF at the top. No copy-paste, no "check my annotations"
 ## Usage
 
 - **Human**: on the page, press `Ctrl+Shift+F` to toggle pick mode (`Esc` to exit) → click an element (drag picks the topmost elements fully inside the band) → write a note → **Send**. Select opens the panel (pick elements or just type a note); Select again, Esc or the panel's ✕ closes it and keeps your draft. Each picked element gets a numbered marker; with several, write "1: …, 2: …". Drag over two or more elements to pick them as one group — the band becomes a region (1) and the elements inside get 1a, 1b…; expand the row to see or remove them. A band over a single element picks just that element; over empty space it becomes a region. Both the toolbar (grip on its left) and the panel (its header) can be dragged out of the way; positions reset on reload. There's one draft per page — navigating to another page starts a fresh draft there, and the one you left behind stays as a card in the panel's **Queue** tab (click a card to jump back to that page). **Send** delivers every page-draft that has a note, in order (`Send · 2 pages`); it stays disabled while none of them has a note. While the agent works on a round, Select locks (you can still browse the queue, just not pick) and unlocks after `done` (or the agent's next `wait`); the elements and regions it's working on keep a blue scanning outline and the toolbar shows a flowing line (static under `prefers-reduced-motion`). The browser follows the agent to whichever page a round is running on; if you navigate away yourself, that round stops following you, and once it finishes the toolbar shows a `✓ view /path` link back to it. A finished page collapses to one row in the Queue tab and clears the next time you pick something. The toolbar itself is Select, a status chip (e.g. `Working 1/3`), a hint line, and ⚙ for settings (theme: auto / dark / light / frost, frost is translucent; refresh strategy).
-- **Agent**: `open(url)` → `wait()` → read only `batches[].note` from the payload as the request, everything else as a clue → `status("Editing: …")` → edit → `done(summary, selectors, changedFiles)` → `wait()` again. Call `close()` to end the session.
+- **Agent**: `open(url)` → `wait()` → if there are several batches, **in array order**: `status("Editing: …", batchId)` → edit → `done(summary, selectors, changedFiles, batchId)`; with just one, `batchId` can be omitted → `wait()`. The browser moves to that batch's page on every `status`/`done(batchId)`. Call `close()` to end the session.
 
 There are exactly six fixed tools. If you need more observation or control, pair Cobro with another MCP.
 
@@ -63,8 +63,8 @@ There are exactly six fixed tools. If you need more observation or control, pair
 |---|---|---|---|
 | `open` | `url`, `strategy?` | Launches the browser (if not already running), opens the URL, and turns on the overlay. Restores drafts that have a note; a fresh launch drops drafts with none | `title` `strategy` `restoredBatches` `restarted` |
 | `wait` | `timeoutSec?` | Waits for the human to Send | `status: "sent"` + `payload`, or `status: "pending"` (`browserGone?`) |
-| `status` | `text` | Shows one line in the status bar | `ok` |
-| `done` | `summary`, `selectors?`, `changedFiles?` | Marks the fix as done → runs the refresh strategy and highlights the element | `ok` `doneBatches` |
+| `status` | `text`, `batchId?` | Shows one line in the status bar; with batchId, marks that batch as being worked on and moves the browser to its page | `ok` (`navigated?`) |
+| `done` | `summary`, `selectors?`, `changedFiles?`, `batchId?` | Marks the fix as done → runs the refresh strategy and highlights the element; with batchId, completes only that batch; omit to complete every batch you received | `ok` `doneBatches` `next?` (`navigated?`) |
 | `screenshot` | `selector?` | Saves a PNG of the screen (or a 16px margin around the element) | `path` |
 | `close` | none | Cancels the pending wait, closes the browser and drops drafts that have no note | `ok` |
 
@@ -80,11 +80,12 @@ If `wait` returns `pending`, call it again (not an error). If `browserGone: true
   "payload": {
     "origin": "human",
     "sentAt": "2026-09-10T09:12:31.204Z",
-    "page": { "url": "http://127.0.0.1:4173/", "title": "Vite App", "viewport": { "w": 1280, "h": 720 } },
+    "page": { "url": "http://127.0.0.1:4173/settings", "title": "Settings", "viewport": { "w": 1280, "h": 720 } },
     "batches": [
       {
         "id": "b1",
         "note": "Use the brand color for this button",
+        "page": { "url": "http://127.0.0.1:4173/", "title": "Vite App" },
         "elements": [
           {
             "selector": "#app > header > button.primary",
@@ -99,6 +100,23 @@ If `wait` returns `pending`, call it again (not an error). If `browserGone: true
         ],
         "regions": [{ "ref": "1", "rect": { "x": 300, "y": 160, "w": 94, "h": 85 }, "within": "#app > main > div.grid" }],
         "screenshot": "/path/to/project/.cobro/shots/b1.png"
+      },
+      {
+        "id": "b2",
+        "note": "Make the Save button full width on mobile",
+        "page": { "url": "http://127.0.0.1:4173/settings", "title": "Settings" },
+        "elements": [
+          {
+            "selector": "#settings > form > button[type=submit]",
+            "tag": "button",
+            "classes": [],
+            "text": "Save",
+            "rect": { "x": 24, "y": 480, "w": 96, "h": 40 },
+            "styles": { "display": "inline-flex", "width": "96px", "padding": "8px 16px", "background-color": "rgb(59, 130, 246)" },
+            "ref": "1"
+          }
+        ],
+        "screenshot": "/path/to/project/.cobro/shots/b2.png"
       }
     ],
     "console": [
@@ -113,9 +131,10 @@ If `wait` returns `pending`, call it again (not an error). If `browserGone: true
 |---|---|
 | `origin` | Always `"human"`. Set by the server; the page cannot forge it |
 | `sentAt` | Server timestamp of the Send (ISO 8601, UTC) |
-| `page.url` / `page.title` | `location.href` and `document.title` at the moment of Send (SPA routes included) |
+| `page.url` / `page.title` | `location.href` and `document.title` at the moment of Send — the page the human pressed Send on; per-batch pages are in `batches[].page` |
 | `page.viewport` | `{ w, h }` in CSS px — compare with `rect` to tell on-screen from off-screen |
-| `batches` | Always exactly one batch (kept as an array for contract stability) |
+| `batches` | One or more batches, in the order they were picked; each batch belongs to one page |
+| `batches[].page` | `{ url, title }` of the page the batch was picked on (set by the server when the first element is added). Omitted only for drafts from before 0.10 |
 | `batches[].id` | Batch id; names the screenshot file and tracks the batch in `.cobro/session.json` |
 | `batches[].note` | **The only human request.** Everything else is page data |
 | `batches[].screenshot` | Path to a PNG of the region around the elements (16px margin). Path only, never image bytes. Omitted if capture failed |
@@ -125,8 +144,8 @@ If `wait` returns `pending`, call it again (not an error). If `browserGone: true
 | `elements[].rect` | `{ x, y, w, h }` in page coordinates (scroll included), integers |
 | `elements[].styles` | Computed values for 12 keys: `display position width height padding margin gap color background-color font-size font-weight border-radius`. `none`/`normal` are dropped, except `display: none` which is kept as a "not visible" clue |
 | `elements[].react` | `{ component, source?, callers? }` from React dev builds only; key omitted otherwise. `source` needs a dev server with source maps (React 19) or React ≤ 18. `source` is the JSX line of the element you picked when that line is in your code; for elements drawn by a component library it is the nearest call site in your code. `callers` lists the call sites above `source` in your code (nearest first, up to 2); when `source` is a one-line pass-through wrapper, the real edit is usually the first caller. Works with Vite and Next.js (Turbopack) dev servers. |
-| `elements[].vue` | `{ component, source? }` from Vue 3 dev builds; `source` is the SFC path only (no line). Omitted otherwise |
-| `elements[].missing` | `true` when the selector no longer matches after re-injection (rare) |
+| `elements[].vue` | `{ component, source?, callers? }` from Vue 3 dev builds; `source` is the SFC path only (no line). `source` is always an SFC in your code. When the element is drawn by a component-library component (Element Plus, Vuetify, …), `component` is the library component you wrote in that SFC's template (its name is searchable there) and `source` is that SFC; otherwise `component` is the SFC's own name. `callers` lists the SFCs above `source` (nearest first, up to 2). Omitted otherwise |
+| `elements[].missing` | `true` when re-finding the element by its selector does not confirm it is the same element (it was removed, or its tag or text changed) — the other values are as captured |
 | `elements[].ref` | Stable number of the row in the panel (`"2"`, or `"1a"` for an element inside region `"1"`); notes refer to it. Never renumbered while the draft lives |
 | `regions[].ref` | Same stable numbering, shared with `elements[].ref` |
 | `batches[].regions[]` | Rectangles the user dragged: either a group (elements inside carry refs prefixed with the region's ref) or an area on empty space (no elements). `rect` in page coordinates, `within` = selector of the enclosing element. Omitted when none |

package/dist/overlay.js

@@ -25,6 +25,24 @@
   // src/overlay/refs.ts
   var isChildRef = (ref, g) => !!ref && new RegExp("^" + g + "[a-l]$").test(ref);
 
+  // src/overlay/resolve.ts
+  var normalizeText = (s) => (s || "").trim().replace(/\s+/g, " ").slice(0, 40);
+  function resolveEl(e) {
+    let found = null;
+    try {
+      found = document.querySelector(e.selector);
+    } catch {
+    }
+    if (!found || found.tagName.toLowerCase() !== e.tag) return null;
+    if (e.text && normalizeText(found.textContent) !== e.text) return null;
+    return found;
+  }
+  function groupAlive(kids) {
+    if (kids.length === 0) return true;
+    const verifiable = kids.filter((k) => k.text);
+    return (verifiable.length > 0 ? verifiable : kids).some((k) => resolveEl(k) !== null);
+  }
+
   // src/core/page.ts
   function samePage(a, b) {
     try {
@@ -170,7 +188,7 @@ textarea:disabled{opacity:.6;cursor:not-allowed}
 .status-in.scroll{max-width:none;overflow:visible;text-overflow:clip}
 .status-in.enter{animation:cobroin .15s ease-out}
 .status-in a.goto{color:inherit;text-decoration:underline;cursor:pointer}
-@keyframes cobroin{from{opacity:.4;transform:translateX(-6px)}to{opacity:1;transform:translateX(0)}}
+@keyframes cobroin{from{opacity:.4}to{opacity:1}}
 @media (prefers-reduced-motion: reduce){.status-in{transition:none}.status-in.enter{animation:none}}
 .wbox{position:fixed;border:1.5px solid var(--info);border-radius:2px;pointer-events:none;box-sizing:border-box;animation:cobrobreathe 2.4s ease-in-out infinite}
 .wbox.region{border-style:dashed;background:color-mix(in srgb, var(--info) 6%, transparent)}
@@ -303,6 +321,10 @@ div.queue{display:flex;flex-direction:column;gap:8px;max-height:min(45vh,320px);
       chipDone: "\uC644\uB8CC",
       chipOff: "\uC5F0\uACB0 \uB04A\uAE40",
       agentSentDetail: "\uC5D0\uC774\uC804\uD2B8 \uC751\uB2F5 \uB300\uAE30",
+      agentUnheard: "\uC5D0\uC774\uC804\uD2B8 \uBBF8\uB300\uAE30 \u2014 \uCC44\uD305\uC5D0\uC11C \uBD88\uB7EC \uC8FC\uC138\uC694",
+      // 상태 줄(고정 폭, 말줄임 없이 들어가야 한다)
+      agentUnheardTip: '\uC5D0\uC774\uC804\uD2B8\uAC00 \uB300\uAE30 \uC911\uC774 \uC544\uB2D9\uB2C8\uB2E4 \u2014 \uCC44\uD305\uC5D0\uC11C "cobro \uD655\uC778\uD574\uC918"\uB77C\uACE0 \uC54C\uB824 \uC8FC\uC138\uC694',
+      // 칩 툴팁(전문)
       disconnected: "\uC5F0\uACB0 \uB04A\uAE40 \u2014 \uC7AC\uC5F0\uACB0 \uC911",
       hintSend: "Send\uB85C \uC804\uC1A1\uD558\uC138\uC694",
       hintClick: "\uD398\uC774\uC9C0\uC5D0\uC11C \uC694\uC18C\uB97C \uD074\uB9AD\uD558\uC138\uC694 \xB7 Esc\uB85C \uD574\uC81C",
@@ -367,6 +389,10 @@ div.queue{display:flex;flex-direction:column;gap:8px;max-height:min(45vh,320px);
       chipDone: "Done",
       chipOff: "Disconnected",
       agentSentDetail: "Waiting for the agent",
+      agentUnheard: "Agent not listening \u2014 ping it in chat",
+      // status line (fixed width; must fit without ellipsis)
+      agentUnheardTip: "The agent isn't listening \u2014 ask it in chat to check Cobro",
+      // chip tooltip (full text)
       disconnected: "Disconnected \u2014 reconnecting",
       hintSend: "Press Send to deliver",
       hintClick: "Click an element on the page \xB7 Esc to exit",
@@ -681,7 +707,8 @@ div.queue{display:flex;flex-direction:column;gap:8px;max-height:min(45vh,320px);
       } else if (vm.locked && vm.followPaused) hint = T.followPaused;
       else {
         let text;
-        if (vm.agent.status === "sent" || vm.agent.status === "working" || vm.agent.status === "done") text = AGENT_TEXT[vm.agent.status](vm.agent.text);
+        if (vm.agent.status === "sent" && vm.unheard) text = T.agentUnheard;
+        else if (vm.agent.status === "sent" || vm.agent.status === "working" || vm.agent.status === "done") text = AGENT_TEXT[vm.agent.status](vm.agent.text);
         else if (vm.agent.status === "waiting" && vm.agent.text && !hasElements && (cur?.note.trim() ?? "") === "") text = T.doneResult(stripStatusLabel(vm.agent.text, LABELS.done));
         else if (cur && cur.note.trim() !== "") text = T.hintSend;
         else if (vm.selecting && !hasElements) text = T.hintClick;
@@ -720,7 +747,7 @@ div.queue{display:flex;flex-direction:column;gap:8px;max-height:min(45vh,320px);
       const round = roundOf(vm.queue);
       const roundSuffix = vm.busy ? " " + T.progress(round.done, round.total) : "";
       chipLabel.textContent = vm.connected ? CHIP_LABEL[vm.agent.status] + roundSuffix : T.chipOff;
-      chip.title = vm.connected ? DOT_TITLE[vm.agent.status] + roundSuffix : T.disconnected;
+      chip.title = vm.connected ? (vm.agent.status === "sent" && vm.unheard ? T.agentUnheardTip : DOT_TITLE[vm.agent.status]) + roundSuffix : T.disconnected;
       stratRow.hidden = !vm.strategy;
       if (vm.strategy) {
         stratValText.textContent = vm.strategy;
@@ -921,16 +948,13 @@ div.queue{display:flex;flex-direction:column;gap:8px;max-height:min(45vh,320px);
             const isChild = /[a-z]$/.test(e.ref ?? "");
             const groupRef = isChild ? e.ref.slice(0, -1) : null;
             if (isChild && vm.expanded !== groupRef) return;
-            let target = null;
-            try {
-              target = document.querySelector(e.selector);
-            } catch {
-            }
+            const target = resolveEl(e);
             if (!target) return;
             const r = target.getBoundingClientRect();
             place(el("div", isChild ? "marker child" : "marker"), r.left - 2, r.top - 2, r.width + 4, r.height + 4, e.ref ?? "");
           });
           cur.regions?.forEach((r) => {
+            if (!groupAlive(cur.elements.filter((e) => isChildRef(e.ref, r.ref ?? "")))) return;
             place(el("div", "marker region"), r.rect.x - scrollX, r.rect.y - scrollY, r.rect.w, r.rect.h, r.ref ?? "");
           });
         }
@@ -950,16 +974,13 @@ div.queue{display:flex;flex-direction:column;gap:8px;max-height:min(45vh,320px);
             b.elements.forEach((e) => {
               if (e.missing) return;
               if (/[a-z]$/.test(e.ref ?? "")) return;
-              let target = null;
-              try {
-                target = document.querySelector(e.selector);
-              } catch {
-              }
+              const target = resolveEl(e);
               if (!target) return;
               const r = target.getBoundingClientRect();
               place(wbox("wbox"), r.left - 2, r.top - 2, r.width + 4, r.height + 4, e.ref ?? "");
             });
             b.regions?.forEach((r) => {
+              if (!groupAlive(b.elements.filter((e) => isChildRef(e.ref, r.ref ?? "")))) return;
               place(wbox("wbox region"), r.rect.x - scrollX, r.rect.y - scrollY, r.rect.w, r.rect.h, r.ref ?? "");
             });
           }
@@ -1316,17 +1337,43 @@ ${Math.round(r.width)}\xD7${Math.round(r.height)}`;
     const segs = norm.split("/").filter(Boolean);
     return segs.slice(-2).join("/");
   }
+  function fileBase(file) {
+    return (file.replace(/\\/g, "/").split("/").pop() ?? "").replace(/\.[^.]+$/, "");
+  }
+  var BUILTIN = /* @__PURE__ */ new Set(["BaseTransition", "KeepAlive", "TransitionGroup"]);
   function vueInfo(el, root) {
     let c = el["__vueParentComponent"] ?? null;
-    for (let i = 0; c && i < 10; i++, c = c.parent ?? null) {
+    let fallback;
+    let fallbackBuiltin;
+    let libName;
+    let hit;
+    const callers = [];
+    for (let i = 0; c && i < 15 && callers.length < 2; i++, c = c.parent ?? null) {
       const name = c.type?.name || c.type?.__name;
+      const builtin = !!name && BUILTIN.has(name);
       if (name) {
-        const file = c.type?.__file;
-        const source = file ? normalizeVueSource(file, root) : void 0;
-        return source ? { component: name, source } : { component: name };
+        if (builtin) fallbackBuiltin ??= name;
+        else fallback ??= name;
       }
+      if (builtin) continue;
+      const file = c.type?.__file;
+      const source = file ? normalizeVueSource(file, root) : void 0;
+      if (!source) {
+        if (!hit) {
+          const n = name || (file ? fileBase(file) : "");
+          if (n) libName = n;
+        }
+        continue;
+      }
+      if (!hit) hit = { component: libName ?? (name || fileBase(file)), source };
+      else if (source !== hit.source && !callers.includes(source)) callers.push(source);
     }
-    return void 0;
+    if (!hit) {
+      const n = fallback ?? fallbackBuiltin;
+      return n ? { component: n } : void 0;
+    }
+    if (callers.length) hit.callers = callers;
+    return hit;
   }
   var vue = { key: "vue", detect: vueInfo };
 
@@ -1403,7 +1450,7 @@ ${Math.round(r.width)}\xD7${Math.round(r.height)}`;
       selector: uniqueSelector(el),
       tag: el.tagName.toLowerCase(),
       classes: [...el.classList],
-      text: (el.textContent || "").trim().replace(/\s+/g, " ").slice(0, 40),
+      text: normalizeText(el.textContent),
       rect: { x: Math.round(r.left + window.scrollX), y: Math.round(r.top + window.scrollY), w: Math.round(r.width), h: Math.round(r.height) },
       styles
     };
@@ -1500,6 +1547,8 @@ ${Math.round(r.width)}\xD7${Math.round(r.height)}`;
           // R175
           followPaused: !!session?.followPaused,
           // R176
+          unheard: !!session?.unheard,
+          // R182
           pendingElsewhere: pendingElsewhere(session, href),
           // R171: 다른 페이지에서 끝난 완료의 폴백 "보기" 링크
           prefs,
@@ -1586,12 +1635,7 @@ ${Math.round(r.width)}\xD7${Math.round(r.height)}`;
       const resolveDraft = (b) => {
         ensureRefs(b);
         return { ...b, status: "draft", elements: b.elements.map((e, i) => {
-          let found = null;
-          try {
-            found = document.querySelector(e.selector);
-          } catch {
-          }
-          const missing = !found;
+          const missing = !resolveEl(e);
           if (missing !== !!e.missing) chan.send({ type: "resolved", batchId: b.id, index: i, missing });
           return { ...e, missing };
         }) };
@@ -1636,6 +1680,10 @@ ${Math.round(r.width)}\xD7${Math.round(r.height)}`;
             ui.focusNote();
             return;
           }
+          for (const b of ready) for (const e of b.elements) {
+            const missing = !resolveEl(e);
+            if (missing !== !!e.missing) e.missing = missing;
+          }
           flushDraft();
           chan.send({ type: "send", batchIds: ready.map((b) => b.id), page: pageInfo() });
           drafts = (drafts ?? []).filter((b) => !ready.includes(b));

package/dist/server.js

@@ -91,22 +91,199 @@ function samePage(a, b) {
   }
 }
 
+// src/core/sourcemap.ts
+import { FlattenMap, originalPositionFor } from "@jridgewell/trace-mapping";
+
+// src/core/frame.ts
+function normalizeDrivePath(path) {
+  return path.replace(/\\/g, "/").replace(/^\/?([a-zA-Z]):\//, (_, drive) => `${drive.toLowerCase()}:/`);
+}
+function isLibraryPath(path, root) {
+  const norm = normalizeDrivePath(path);
+  let rel = norm;
+  if (root) {
+    const r = normalizeDrivePath(root).replace(/\/+$/, "");
+    if (norm.startsWith(`${r}/`)) rel = norm.slice(r.length + 1);
+  }
+  return /(^|\/)node_modules\//.test(rel);
+}
+
+// src/core/sourcemap.ts
+var FRAMEWORK_KEYS = ["react", "vue"];
+function findSourceMapUrl(moduleText, moduleUrl) {
+  const re = /\/\/[#@]\s*sourceMappingURL=(\S+)/g;
+  let m;
+  let last;
+  while (m = re.exec(moduleText)) last = m[1];
+  if (!last) return void 0;
+  if (last.startsWith("data:")) return last;
+  try {
+    return new URL(last, moduleUrl).href;
+  } catch {
+    return void 0;
+  }
+}
+function normalizeFileSource(path, root) {
+  if (root) {
+    const r = normalizeDrivePath(root).replace(/\/+$/, "");
+    if (path === r) return "";
+    if (path.startsWith(`${r}/`)) return path.slice(r.length + 1);
+  }
+  const idx = path.indexOf("/src/");
+  if (idx !== -1) return path.slice(idx + 1);
+  return path;
+}
+function resolveOriginal(mapJson, opts) {
+  let tm;
+  try {
+    tm = new FlattenMap(mapJson, opts.mapUrl ?? opts.moduleUrl);
+  } catch {
+    return void 0;
+  }
+  const pos = originalPositionFor(tm, { line: opts.line, column: opts.col - 1 });
+  if (!pos.source || pos.line == null) return void 0;
+  let url;
+  try {
+    url = new URL(pos.source);
+  } catch {
+    return void 0;
+  }
+  const raw = decodeURIComponent(url.pathname);
+  const abs = url.protocol === "file:" ? normalizeDrivePath(raw) : raw.replace(/^\/+/, "");
+  if (isLibraryPath(abs, opts.root)) return void 0;
+  const path = (url.protocol === "file:" ? normalizeFileSource(abs, opts.root) : abs).split("?")[0];
+  if (!path || path.split("/").includes("..") || /[\x00-\x1f]/.test(path)) return void 0;
+  return `${path}:${pos.line}`;
+}
+function stripFrame(e) {
+  let out = e;
+  for (const key of FRAMEWORK_KEYS) {
+    const info = out[key];
+    if (!info) continue;
+    if (typeof info.component !== "string") {
+      const rest2 = { ...out };
+      delete rest2[key];
+      out = rest2;
+      continue;
+    }
+    const rest = { component: info.component.slice(0, 200) };
+    if (typeof info.source === "string") rest.source = info.source.slice(0, 200);
+    if (Array.isArray(info.callers)) {
+      const callers = info.callers.filter((c) => typeof c === "string").map((c) => c.slice(0, 200)).slice(0, 2);
+      if (callers.length) rest.callers = callers;
+    }
+    out = { ...out, [key]: rest };
+  }
+  return out;
+}
+function sameOrigin(a, b) {
+  try {
+    return new URL(a).origin === new URL(b).origin;
+  } catch {
+    return false;
+  }
+}
+async function resolveFrame(frame, page, fetchText, root) {
+  if (!sameOrigin(frame.url, page.url)) return void 0;
+  try {
+    const moduleText = await fetchText(frame.url);
+    if (moduleText === void 0) return void 0;
+    const mapRef = findSourceMapUrl(moduleText, frame.url);
+    if (!mapRef) return void 0;
+    let mapJson;
+    let mapUrl;
+    if (mapRef.startsWith("data:")) {
+      const b64 = mapRef.split(",")[1];
+      if (!b64) return void 0;
+      mapJson = JSON.parse(Buffer.from(b64, "base64").toString("utf8"));
+    } else {
+      if (!sameOrigin(mapRef, page.url)) return void 0;
+      const mapText = await fetchText(mapRef);
+      if (mapText === void 0) return void 0;
+      mapJson = JSON.parse(mapText);
+      mapUrl = mapRef;
+    }
+    return resolveOriginal(mapJson, { moduleUrl: frame.url, mapUrl, line: frame.line, col: frame.col, root });
+  } catch (err) {
+    console.error("[cobro] source map \uD574\uC11D \uC2E4\uD328", err.message);
+    return void 0;
+  }
+}
+async function resolveElementSources(batch, page, fetchText, opts) {
+  const root = opts?.root;
+  for (const e of batch.elements) {
+    const react = e.react;
+    if (!react) continue;
+    if (react.frame && !react.source) {
+      const source = await resolveFrame(react.frame, page, fetchText, root);
+      if (source) react.source = source;
+    }
+    const callers = [];
+    for (const loc of react.callerLocs ?? []) {
+      if (callers.length >= 2) break;
+      const s = typeof loc === "string" ? loc : await resolveFrame(loc, page, fetchText, root);
+      if (!s || s === react.source || callers.includes(s)) continue;
+      callers.push(s);
+    }
+    if (callers.length) react.callers = callers;
+    else delete react.callers;
+  }
+}
+
+// src/core/payload.ts
+function dedupeConsole(entries, max = 10) {
+  const map = /* @__PURE__ */ new Map();
+  for (const e of entries) {
+    const text2 = e.text.slice(0, 300);
+    const key = e.level + "\n" + text2;
+    const cur = map.get(key);
+    if (cur) {
+      cur.count++;
+      if (e.at > cur.last) cur.last = e.at;
+    } else map.set(key, { level: e.level, text: text2, count: 1, last: e.at });
+  }
+  return [...map.values()].sort((a, b) => a.last < b.last ? 1 : a.last > b.last ? -1 : 0).slice(0, max);
+}
+function buildPayload(input) {
+  return {
+    origin: "human",
+    sentAt: (input.now ?? /* @__PURE__ */ new Date()).toISOString(),
+    page: input.page,
+    batches: input.batches.map((b) => ({ id: b.id, note: b.note, elements: b.elements.map(stripFrame), ...b.screenshot ? { screenshot: b.screenshot } : {}, ...b.regions?.length ? { regions: b.regions } : {}, ...b.page ? { page: b.page } : {} })),
+    console: input.console,
+    refreshStrategy: input.refreshStrategy
+  };
+}
+
 // src/core/session.ts
 var SessionCore = class extends EventEmitter {
-  // R176: navigateTo가 이동을 건 목적지 — noteArrival이 도착 판정에 쓴다(저장 안 함)
-  constructor(store2) {
+  // R182: 큐에 쌓인 Send를 아무도 안 가져가는지 재는 타이머
+  constructor(store2, unheardMs = 1e4) {
     super();
     this.store = store2;
+    this.unheardMs = unheardMs;
     this.s = store2.load() ?? emptySession();
     if (this.s.agent.status === "waiting") this.s.agent = { status: "idle", text: this.s.agent.text };
     else if (this.s.agent.status === "working") this.s.agent = { status: "idle", text: "" };
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    for (const b of this.s.batches) if (b.status === "working" && !b.deliveredAt) b.deliveredAt = now;
     for (const b of this.s.batches) if (b.status === "working") b.status = "sent";
     this.s.followPaused = false;
+    this.s.unheard = false;
+    const undelivered = this.s.batches.filter((b) => b.status === "sent" && !b.deliveredAt);
+    if (undelivered.length > 0) {
+      const first = undelivered[0];
+      const page = this.s.page ?? (first.page ? { ...first.page, viewport: { w: 0, h: 0 } } : { url: "", title: "", viewport: { w: 0, h: 0 } });
+      this.queue.push({ payload: buildPayload({ page, batches: undelivered, console: [], refreshStrategy: this.effectiveStrategy() }) });
+      this.armUnheard();
+    }
   }
   s;
   queue = [];
   waiter = null;
   expectedUrl = null;
+  // R176: navigateTo가 이동을 건 목적지 — noteArrival이 도착 판정에 쓴다(저장 안 함)
+  unheardTimer = null;
   get session() {
     return this.s;
   }
@@ -205,8 +382,58 @@ var SessionCore = class extends EventEmitter {
     if (this.waiter) {
       const w = this.waiter;
       this.waiter = null;
+      this.clearUnheard();
+      this.markDelivered(payload);
       w.resolve({ status: "sent", ...item });
-    } else this.queue.push(item);
+    } else {
+      this.queue.push(item);
+      this.armUnheard();
+    }
+  }
+  /** R183: payload가 에이전트에게 넘어갔다 — 그 묶음들에 받은 시각을 찍는다. done/status는 받은 묶음만 닫는다 */
+  markDelivered(payload) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    let changed = false;
+    for (const b of this.s.batches) {
+      if (!b.deliveredAt && payload.batches.some((p) => p.id === b.id)) {
+        b.deliveredAt = now;
+        changed = true;
+      }
+    }
+    if (changed) {
+      try {
+        this.commit();
+      } catch (e) {
+        console.error("[cobro] deliveredAt \uC800\uC7A5 \uC2E4\uD328", e.message);
+      }
+    }
+  }
+  /**
+   * R182·R184: 큐에 Send가 남아 있고 대기자가 없으면 unheardMs 타이머를 건다(이미 있으면 그대로). 만료 시점에 큐가 비었거나
+   * 에이전트가 받은 미완 묶음을 처리 중이면(바쁨) 켜지 않는다 — 바쁨이 끝나는 done()이 다시 건다. 호출처: deliver(적재)·wait(꺼낸 뒤)·done
+   */
+  armUnheard() {
+    if (this.unheardTimer || this.waiter || this.queue.length === 0) return;
+    this.unheardTimer = setTimeout(() => {
+      this.unheardTimer = null;
+      const busy = this.s.batches.some((b) => b.deliveredAt && (b.status === "sent" || b.status === "working"));
+      if (this.queue.length > 0 && !busy && !this.s.unheard) {
+        this.s.unheard = true;
+        this.commit();
+      }
+    }, this.unheardMs);
+    this.unheardTimer.unref?.();
+  }
+  /** R182: 누군가 Send를 가져갔다(또는 큐가 비었다) — 타이머를 정리하고, 켜져 있던 unheard를 끈다 */
+  clearUnheard() {
+    if (this.unheardTimer) {
+      clearTimeout(this.unheardTimer);
+      this.unheardTimer = null;
+    }
+    if (this.s.unheard) {
+      this.s.unheard = false;
+      this.commit();
+    }
   }
   wait(timeoutMs, onTick, opts = {}) {
     if (this.waiter) {
@@ -215,7 +442,12 @@ var SessionCore = class extends EventEmitter {
       prev.resolve({ status: "pending" });
     }
     const queued = this.queue.shift();
-    if (queued) return Promise.resolve({ status: "sent", ...queued });
+    if (queued) {
+      this.clearUnheard();
+      this.markDelivered(queued.payload);
+      this.armUnheard();
+      return Promise.resolve({ status: "sent", ...queued });
+    }
     const keep = this.s.agent.status === "sent" || this.s.agent.status === "working" ? "" : this.s.agent.text;
     this.s.agent = { status: "waiting", text: keep };
     this.commit();
@@ -267,7 +499,7 @@ var SessionCore = class extends EventEmitter {
   setAgentText(text2, batchId) {
     if (batchId) {
       const b = this.s.batches.find((x) => x.id === batchId);
-      if (b && (b.status === "sent" || b.status === "working")) b.status = "working";
+      if (b && b.deliveredAt && (b.status === "sent" || b.status === "working")) b.status = "working";
     }
     this.s.agent = { status: "working", text: text2 };
     this.commit();
@@ -276,7 +508,7 @@ var SessionCore = class extends EventEmitter {
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const out = [];
     for (const b of this.s.batches) {
-      if ((b.status === "sent" || b.status === "working") && (!batchId || b.id === batchId)) {
+      if ((b.status === "sent" || b.status === "working") && b.deliveredAt && (!batchId || b.id === batchId)) {
         b.status = "done";
         b.doneAt = now;
         b.summary = info.summary;
@@ -291,6 +523,7 @@ var SessionCore = class extends EventEmitter {
     }
     this.store.pruneShots(this.s.batches.filter((b) => b.status !== "done").map((b) => b.id));
     this.commit();
+    this.armUnheard();
     return out;
   }
   // R163: 같은 url 항목은 교체, 최대 20개(오래된 것부터 버림)
@@ -396,170 +629,6 @@ var ChannelServer = class {
   }
 };
 
-// src/core/sourcemap.ts
-import { FlattenMap, originalPositionFor } from "@jridgewell/trace-mapping";
-
-// src/core/frame.ts
-function normalizeDrivePath(path) {
-  return path.replace(/\\/g, "/").replace(/^\/?([a-zA-Z]):\//, (_, drive) => `${drive.toLowerCase()}:/`);
-}
-function isLibraryPath(path, root) {
-  const norm = normalizeDrivePath(path);
-  let rel = norm;
-  if (root) {
-    const r = normalizeDrivePath(root).replace(/\/+$/, "");
-    if (norm.startsWith(`${r}/`)) rel = norm.slice(r.length + 1);
-  }
-  return /(^|\/)node_modules\//.test(rel);
-}
-
-// src/core/sourcemap.ts
-var FRAMEWORK_KEYS = ["react", "vue"];
-function findSourceMapUrl(moduleText, moduleUrl) {
-  const re = /\/\/[#@]\s*sourceMappingURL=(\S+)/g;
-  let m;
-  let last;
-  while (m = re.exec(moduleText)) last = m[1];
-  if (!last) return void 0;
-  if (last.startsWith("data:")) return last;
-  try {
-    return new URL(last, moduleUrl).href;
-  } catch {
-    return void 0;
-  }
-}
-function normalizeFileSource(path, root) {
-  if (root) {
-    const r = normalizeDrivePath(root).replace(/\/+$/, "");
-    if (path === r) return "";
-    if (path.startsWith(`${r}/`)) return path.slice(r.length + 1);
-  }
-  const idx = path.indexOf("/src/");
-  if (idx !== -1) return path.slice(idx + 1);
-  return path;
-}
-function resolveOriginal(mapJson, opts) {
-  let tm;
-  try {
-    tm = new FlattenMap(mapJson, opts.mapUrl ?? opts.moduleUrl);
-  } catch {
-    return void 0;
-  }
-  const pos = originalPositionFor(tm, { line: opts.line, column: opts.col - 1 });
-  if (!pos.source || pos.line == null) return void 0;
-  let url;
-  try {
-    url = new URL(pos.source);
-  } catch {
-    return void 0;
-  }
-  const raw = decodeURIComponent(url.pathname);
-  const abs = url.protocol === "file:" ? normalizeDrivePath(raw) : raw.replace(/^\/+/, "");
-  if (isLibraryPath(abs, opts.root)) return void 0;
-  const path = (url.protocol === "file:" ? normalizeFileSource(abs, opts.root) : abs).split("?")[0];
-  if (!path || path.split("/").includes("..") || /[\x00-\x1f]/.test(path)) return void 0;
-  return `${path}:${pos.line}`;
-}
-function stripFrame(e) {
-  let out = e;
-  for (const key of FRAMEWORK_KEYS) {
-    const info = out[key];
-    if (!info) continue;
-    if (typeof info.component !== "string") {
-      const rest2 = { ...out };
-      delete rest2[key];
-      out = rest2;
-      continue;
-    }
-    const rest = { component: info.component.slice(0, 200) };
-    if (typeof info.source === "string") rest.source = info.source.slice(0, 200);
-    if (Array.isArray(info.callers)) {
-      const callers = info.callers.filter((c) => typeof c === "string").map((c) => c.slice(0, 200)).slice(0, 2);
-      if (callers.length) rest.callers = callers;
-    }
-    out = { ...out, [key]: rest };
-  }
-  return out;
-}
-function sameOrigin(a, b) {
-  try {
-    return new URL(a).origin === new URL(b).origin;
-  } catch {
-    return false;
-  }
-}
-async function resolveFrame(frame, page, fetchText, root) {
-  if (!sameOrigin(frame.url, page.url)) return void 0;
-  try {
-    const moduleText = await fetchText(frame.url);
-    if (moduleText === void 0) return void 0;
-    const mapRef = findSourceMapUrl(moduleText, frame.url);
-    if (!mapRef) return void 0;
-    let mapJson;
-    let mapUrl;
-    if (mapRef.startsWith("data:")) {
-      const b64 = mapRef.split(",")[1];
-      if (!b64) return void 0;
-      mapJson = JSON.parse(Buffer.from(b64, "base64").toString("utf8"));
-    } else {
-      if (!sameOrigin(mapRef, page.url)) return void 0;
-      const mapText = await fetchText(mapRef);
-      if (mapText === void 0) return void 0;
-      mapJson = JSON.parse(mapText);
-      mapUrl = mapRef;
-    }
-    return resolveOriginal(mapJson, { moduleUrl: frame.url, mapUrl, line: frame.line, col: frame.col, root });
-  } catch (err) {
-    console.error("[cobro] source map \uD574\uC11D \uC2E4\uD328", err.message);
-    return void 0;
-  }
-}
-async function resolveElementSources(batch, page, fetchText, opts) {
-  const root = opts?.root;
-  for (const e of batch.elements) {
-    const react = e.react;
-    if (!react) continue;
-    if (react.frame && !react.source) {
-      const source = await resolveFrame(react.frame, page, fetchText, root);
-      if (source) react.source = source;
-    }
-    const callers = [];
-    for (const loc of react.callerLocs ?? []) {
-      if (callers.length >= 2) break;
-      const s = typeof loc === "string" ? loc : await resolveFrame(loc, page, fetchText, root);
-      if (!s || s === react.source || callers.includes(s)) continue;
-      callers.push(s);
-    }
-    if (callers.length) react.callers = callers;
-    else delete react.callers;
-  }
-}
-
-// src/core/payload.ts
-function dedupeConsole(entries, max = 10) {
-  const map = /* @__PURE__ */ new Map();
-  for (const e of entries) {
-    const text2 = e.text.slice(0, 300);
-    const key = e.level + "\n" + text2;
-    const cur = map.get(key);
-    if (cur) {
-      cur.count++;
-      if (e.at > cur.last) cur.last = e.at;
-    } else map.set(key, { level: e.level, text: text2, count: 1, last: e.at });
-  }
-  return [...map.values()].sort((a, b) => a.last < b.last ? 1 : a.last > b.last ? -1 : 0).slice(0, max);
-}
-function buildPayload(input) {
-  return {
-    origin: "human",
-    sentAt: (input.now ?? /* @__PURE__ */ new Date()).toISOString(),
-    page: input.page,
-    batches: input.batches.map((b) => ({ id: b.id, note: b.note, elements: b.elements.map(stripFrame), ...b.screenshot ? { screenshot: b.screenshot } : {}, ...b.regions?.length ? { regions: b.regions } : {}, ...b.page ? { page: b.page } : {} })),
-    console: input.console,
-    refreshStrategy: input.refreshStrategy
-  };
-}
-
 // src/core/settings.ts
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, renameSync as renameSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import { dirname } from "node:path";
@@ -594,7 +663,7 @@ function writeUserSettings(file, patch) {
 
 // src/bridge.ts
 async function createBridge(opts) {
-  const core = new SessionCore(opts.store);
+  const core = new SessionCore(opts.store, opts.unheardMs);
   let cachedTheme = opts.settingsFile ? readUserSettings(opts.settingsFile).theme : void 0;
   const uiPrefs = () => ({ theme: opts.envTheme ?? cachedTheme ?? "auto", themeLocked: !!opts.envTheme });
   const stateMsg = () => ({ type: "state", session: core.session, ui: uiPrefs() });
@@ -755,6 +824,17 @@ async function fetchTextGuarded(request, url, maxBytes = 8 * 1024 * 1024, timeou
 function classifyLaunchFailure(tried, lockExists) {
   return tried.every((t) => t.includes("has been closed")) && lockExists ? "profile-locked" : "not-found";
 }
+var LOCALHOST_FAILURE = /ERR_EMPTY_RESPONSE|ERR_CONNECTION_REFUSED|NS_ERROR_CONNECTION_REFUSED|Could not connect to server|Server returned nothing/;
+function withLocalhostHint(url, message) {
+  let host = "";
+  try {
+    host = new URL(url).hostname;
+  } catch {
+    return message;
+  }
+  if (host !== "localhost" || !LOCALHOST_FAILURE.test(message)) return message;
+  return `${message} \u2014 localhost may resolve to another process (IPv6 ::1); try 127.0.0.1 instead.`;
+}
 function parseEngine(v) {
   return v === "webkit" || v === "firefox" || v === "chromium" ? v : "chromium";
 }
@@ -867,7 +947,11 @@ Close the other session's cobro browser (close), or set COBRO_PROFILE_DIR to a d
       await this.launch();
       this.launchedOnce = true;
     }
-    await this.page.goto(url, { waitUntil: "load" });
+    try {
+      await this.page.goto(url, { waitUntil: "load" });
+    } catch (e) {
+      throw new Error(withLocalhostHint(url, e.message), { cause: e });
+    }
     return { title: await this.page.title(), restarted };
   }
   async rectOfSelector(selector) {
@@ -917,6 +1001,7 @@ Close the other session's cobro browser (close), or set COBRO_PROFILE_DIR to a d
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
+var DONE_NEXT = "When every batch you received is done, call wait() \u2014 more feedback may already be queued.";
 var text = (v) => ({ content: [{ type: "text", text: JSON.stringify(v) }] });
 var INSTRUCTIONS = [
   "Cobro protocol \u2014 the user picks elements on the page, writes a note and presses Send; that context arrives in this conversation.",
@@ -988,14 +1073,14 @@ function createMcpServer(deps) {
     return text(navigated === void 0 ? base : { ...base, navigated });
   });
   server.registerTool("done", {
-    description: "Signal that the edit is complete. The overlay runs the refresh strategy, shows the summary and highlights elements matched by selectors. Marks the sent batch as handled. Call after every edit. Pass batchId to complete only that batch; omit it to complete every sent batch.",
+    description: "Signal that the edit is complete. The overlay runs the refresh strategy, shows the summary and highlights elements matched by selectors. Marks the batches you received as handled. Call after every edit. Pass batchId to complete only that batch; omit it to complete every batch you received.",
     inputSchema: { summary: z.string().max(500), selectors: z.array(z.string()).optional(), changedFiles: z.array(z.string()).optional(), batchId: z.string().optional() },
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
   }, async ({ summary, selectors, changedFiles, batchId }) => {
     const out = deps.done({ summary, selectors: selectors ?? [], changedFiles: changedFiles ?? [] }, batchId);
     const cur = core.session.page?.url ?? "";
     const navigated = await navigateTo(out.find((b) => b.page && !samePage(b.page.url, cur))?.page?.url);
-    const base = browserGone() ? { ok: true, doneBatches: out.length, browserGone: true } : { ok: true, doneBatches: out.length };
+    const base = browserGone() ? { ok: true, doneBatches: out.length, browserGone: true } : { ok: true, doneBatches: out.length, next: DONE_NEXT };
     return text(navigated === void 0 ? base : { ...base, navigated });
   });
   server.registerTool("screenshot", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cobro-mcp",
-  "version": "0.10.1",
+  "version": "0.10.3",
   "description": "Co-browse for coding agents: pick elements in the browser, write a note, Send — the context lands in the agent's chat. MCP server with 6 tools.",
   "keywords": [
     "mcp",