cobro-mcp 0.10.1 → 0.10.2

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to this project are documented here. The format follows [Kee
 
 ## [Unreleased]
 
+## [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의 경로. 경로만 있고 이미지 바이트는 없다. 촬영 실패 시 키 없음 |

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 |

package/dist/overlay.js

@@ -303,6 +303,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 +371,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 +689,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 +729,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;
@@ -1500,6 +1509,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,

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() });
@@ -917,6 +986,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 +1058,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.2",
   "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",