dsh-site-bridge 0.4.0 → 0.5.0

package/README.md

@@ -12,7 +12,7 @@ Two halves, one bridge:
 
 | Half | What it does |
 |---|---|
-| **DSH plugin** (`lib/`) | Owns the loopback bridge and exposes eight tools to the model. Writes the snapshot bundle into the session workspace. |
+| **DSH plugin** (`lib/`) | Owns the loopback bridge and exposes eleven tools to the model. Writes the snapshot bundle into the session workspace. |
 | **MV3 extension** (`extension/`) | Lives in your Chrome/Edge profile, works with your cookies, captures markup and network over CDP, drives the page with real input events. Localized: English, Русский, 中文. |
 
 Neither half is useful alone: the plugin holds the model-facing surface and the files, the extension
@@ -70,9 +70,8 @@ candidates checked for uniqueness, and the site's own xhr/fetch calls with heade
 written to files an agent can read. Automation exists so that "this selector works" and "this BFF call
 passes with my cookies" are checked against the live page instead of assumed.
 
-The practical consequence: for generic web browsing, a dedicated automation plugin will have more
-tools than this one, and that is fine — it is solving a different problem. For writing an extension
-that embeds into one specific site, you need the capture, and the input comes with it.
+The practical consequence: this plugin is built for writing an extension for one specific site, and
+the input tools exist to verify that work against the live page rather than to browse the web.
 
 ## Requirements
 
@@ -124,11 +123,14 @@ The popup UI follows the browser language: English, Russian and Simplified Chine
 ## Usage
 
 ```text
-site_status                     → bridge state, pairing path, current tab
-site_tabs {action:"list"}       → tabs; {action:"claim", tabId} binds one
+site_status                     → bridge state, pairing path, tabs
+site_tabs {action:"list"}       → tabs; claim/use/release/open/focus
 site_network {action:"start"}   → begin recording, then act on the page
 site_capture {screenshot:true}  → write the bundle into the workspace
-site_act {steps:"[...]"}        → click/fill/type/select/press/scroll/upload/wait/eval
+site_snapshot {limit:40}        → interactive elements with stable selectors
+site_text {selector:"#cart"}    → visible text, capped, for verification
+site_act {steps:"[...]"}        → click/fill/type/press/scroll/upload/wait/back/eval
+site_pick {action:"wait"}       → the human clicks an element and adds a note
 site_cursor {x,y,click:true}    → virtual cursor, real mouse event
 site_shot {fullPage:true}       → screenshot to captures/shots/*.png
 site_inject {js:"..."}          → run your script in the page to verify it
@@ -181,12 +183,12 @@ The wire protocol is small and documented in [docs/protocol.md](docs/protocol.md
   puts a secret under an unusual key, redaction will not recognise it. Treat a capture bundle as
   sensitive, exactly like any traffic dump.
 
-### Position on trust
+### Trust model
 
-This is a deliberate trade-off, not a claim of superiority. The bridge requires a token and the
-extension asks for `debugger` rather than `<all_urls>`, which costs convenience — a pairing step and
-the Chrome debugging banner — and buys a smaller blast radius. Plugins that skip the token or take
-host permissions are not doing it wrong; they optimise for a different thing.
+The bridge accepts only requests that carry the pairing token. The extension asks for `debugger`
+instead of `<all_urls>` and does not inject a content script into every page. The cost is a pairing
+step and Chrome's debugging banner. In exchange the permission is granted per tab, for the duration
+of a session, and requests are read where they are made — no credential is copied out of the browser.
 
 ## Limitations
 

package/README.ru.md

@@ -70,9 +70,8 @@ site_capture → captures/<host>/<timestamp>/
 которые агент читает. Автоматизация нужна, чтобы «этот селектор работает» и «этот вызов BFF проходит
 с моими куками» проверялись на живой странице, а не предполагались.
 
-Практическое следствие: для обычного браузинга специализированный плагин автоматизации даст больше
-инструментов, и это нормально — он решает другую задачу. Для написания расширения, встраивающегося в
-конкретный сайт, нужен снимок, а ввод идёт в комплекте.
+Практическое следствие: плагин сделан для написания расширения под конкретный сайт, а инструменты
+ввода нужны, чтобы проверять эту работу на живой странице, а не для браузинга.
 
 ## Требования
 
@@ -124,11 +123,14 @@ Chrome покажет плашку «началась отладка этого
 ## Использование
 
 ```text
-site_status                     → состояние моста, путь к токену, текущая вкладка
-site_tabs {action:"list"}       → вкладки; {action:"claim", tabId} привязывает одну
-site_network {action:"start"}   → начать запись, затем действуйте на странице
-site_capture {screenshot:true}  → записать пакет в рабочее пространство
-site_act {steps:"[...]"}        → click/fill/type/select/press/scroll/upload/wait/eval
+site_status                     → состояние моста, путь к спариванию, вкладки
+site_tabs {action:"list"}       → вкладки; claim/use/release/open/focus
+site_network {action:"start"}   → начать запись, затем действовать на странице
+site_capture {screenshot:true}  → записать пакет снимка в рабочее пространство
+site_snapshot {limit:40}        → интерактивные элементы с устойчивыми селекторами
+site_text {selector:"#cart"}    → видимый текст с лимитом, для проверки
+site_act {steps:"[...]"}        → click/fill/type/press/scroll/upload/wait/back/eval
+site_pick {action:"wait"}       → человек кликает элемент и пишет примечание
 site_cursor {x,y,click:true}    → виртуальный курсор, настоящее событие мыши
 site_shot {fullPage:true}       → скриншот в captures/shots/*.png
 site_inject {js:"..."}          → выполнить ваш скрипт в странице для проверки
@@ -180,12 +182,12 @@ site_inject {js:"..."}          → выполнить ваш скрипт в с
   сайт кладёт секрет под нестандартным ключом, редакция его не узнает. Считайте пакет снимка
   чувствительным, как и любой дамп трафика.
 
-### Позиция по доверию
+### Модель доверия
 
-Это осознанный трейд-офф, а не заявка на превосходство. Мост требует токен, а расширение просит
-`debugger` вместо `<all_urls>`: теряется удобство — шаг сопряжения и плашка отладки Chrome — и
-уменьшается радиус поражения. Плагины, которые обходятся без токена или берут права на все сайты, не
-делают что-то неправильно; они оптимизируют другое.
+Мост принимает только запросы с токеном сопряжения. Расширение просит `debugger`, а не
+`<all_urls>`, и не внедряет content script в каждую страницу. Цена — шаг сопряжения и плашка отладки
+Chrome. Взамен право выдаётся на вкладку и на время сессии, а запросы читаются там, где они сделаны:
+учётные данные не покидают браузер.
 
 ## Ограничения
 

package/README.zh-CN.md

@@ -56,8 +56,8 @@ site_capture → captures/<host>/<timestamp>/
 xhr/fetch（含请求头与请求体），全部写成智能体可读的文件。自动化的作用是让「这个选择器可用」和
 「这个 BFF 调用能带着我的 Cookie 通过」在活页面上被验证，而不是被假设。
 
-实际后果：如果只是让智能体浏览网页，专门的自动化插件会提供更多工具，这很正常——它解决的是另一个
-问题。如果要写嵌入某个具体网站的扩展，你需要抓取，而输入能力随之而来。
+实际后果：本项目是为编写面向某个具体网站的扩展而做的，输入工具用来在活页面上验证这些工作，而不是
+用来浏览网页。
 
 ## 环境要求
 
@@ -102,14 +102,17 @@ Chrome 会显示「已开始调试此浏览器」提示条：这正是全部功
 ## 用法
 
 ```text
-site_status                     → 网桥状态、令牌路径、当前标签页
-site_tabs {action:"list"}       → 标签页列表；{action:"claim", tabId} 绑定其一
+site_status                     → 网桥状态、配对路径、标签页
+site_tabs {action:"list"}       → 标签页；claim/use/release/open/focus
 site_network {action:"start"}   → 开始录制，然后在页面上操作
 site_capture {screenshot:true}  → 把快照包写入工作区
-site_act {steps:"[...]"}        → click/fill/type/select/press/scroll/upload/wait/eval
+site_snapshot {limit:40}        → 带稳定选择器的可交互元素
+site_text {selector:"#cart"}    → 可见文本（带上限），用于验证
+site_act {steps:"[...]"}        → click/fill/type/press/scroll/upload/wait/back/eval
+site_pick {action:"wait"}       → 由人点击元素并写备注
 site_cursor {x,y,click:true}    → 虚拟光标，真实鼠标事件
-site_shot {fullPage:true}       → 截图到 captures/shots/*.png
-site_inject {js:"..."}          → 在页面中执行你的脚本以验证
+site_shot {fullPage:true}       → 截图保存到 captures/shots/*.png
+site_inject {js:"..."}          → 在页面里执行你的脚本以验证
 ```
 
 编写页内扩展的典型循环：
@@ -147,11 +150,11 @@ site_inject {js:"..."}          → 在页面中执行你的脚本以验证
 - **仅回环。** 网桥只绑定 `127.0.0.1`，任何没有 32 字节配对令牌的请求都会被拒绝。`site_status` 打印的是令牌文件路径，而不是令牌本身。
 - **残余风险。** 请求头与请求体仍会经过 DSH 进程的内存。如果站点把密钥放在非常规字段名下，脱敏无法识别。请像对待任何流量转储一样，把快照包视为敏感数据。
 
-### 关于信任的取舍
+### 信任模型
 
-这是有意的权衡，而不是优越性声明。网桥要求令牌，扩展申请 `debugger` 而不是 `<all_urls>`：代价是
-便利性——需要配对步骤、Chrome 会显示调试提示条——换来更小的爆炸半径。省略令牌或申请全站权限的插件
-并没有做错，它们优化的是另一件事。
+网桥只接受携带配对令牌的请求。扩展申请 `debugger` 而不是 `<all_urls>`，也不会向每个页面注入
+content script。代价是配对步骤与 Chrome 的调试提示条。换来的是：权限按标签页、按会话授予，请求在
+产生的地方被读取，凭据不离开浏览器。
 
 ## 限制
 

package/docs/listing/awesome-dsh-plugin.yml

@@ -10,12 +10,12 @@
 #   - real, working code (not a placeholder)                              ✔
 #   - repository at least 1 day old                                       ⏳ created 2026-11-01, check before submitting
 #   - dsh-plugin topic on the repository                                  — add with gh
-#   - description states only what the code does                          ✔ (8 tools, MV3 extension)
+#   - description states only what the code does                          ✔ (11 tools, MV3 extension)
 
 url: https://github.com/kesha4/dsh-site-bridge
 name: kesha4/dsh-site-bridge
 category: browser
 icon: https://raw.githubusercontent.com/kesha4/dsh-site-bridge/main/extension/icons/icon-128.png
 description:
-  en: Browser bridge for DeepSeek Harness — captures page markup and BFF traffic into a workspace bundle, drives pages with trusted CDP input, and verifies injected scripts; ships a DSH plugin with eight tools and an MV3 extension that uses the browser's own session.
-  zh: 面向 DeepSeek Harness 的浏览器桥接——把页面结构与 BFF 流量抓取为工作区快照包，用可信 CDP 输入驱动页面并验证注入脚本；包含带八个工具的 DSH 插件与使用浏览器自身会话的 MV3 扩展。
+  en: Browser bridge for DeepSeek Harness — captures page markup and BFF traffic into a workspace bundle, drives pages with trusted CDP input, and verifies injected scripts; ships a DSH plugin with eleven tools and an MV3 extension that uses the browser's own session.
+  zh: 面向 DeepSeek Harness 的浏览器桥接——把页面结构与 BFF 流量抓取为工作区快照包，用可信 CDP 输入驱动页面并验证注入脚本；包含带十一个工具的 DSH 插件与使用浏览器自身会话的 MV3 扩展。

package/extension/_locales/en/messages.json

@@ -143,5 +143,11 @@
   },
   "pickArmed": {
     "message": "Click an element on the page — Enter adds a note, Esc cancels"
+  },
+  "attachAnother": {
+    "message": "Attach another tab"
+  },
+  "disconnectTab": {
+    "message": "Disconnect this tab"
   }
 }

package/extension/_locales/ru/messages.json

@@ -143,5 +143,11 @@
   },
   "pickArmed": {
     "message": "Кликните по элементу на странице — Enter добавит примечание, Esc отменит"
+  },
+  "attachAnother": {
+    "message": "Подключить ещё вкладку"
+  },
+  "disconnectTab": {
+    "message": "Отключить эту вкладку"
   }
 }

package/extension/_locales/zh_CN/messages.json

@@ -143,5 +143,11 @@
   },
   "pickArmed": {
     "message": "点击页面上的元素 — Enter 添加备注，Esc 取消"
+  },
+  "attachAnother": {
+    "message": "连接另一个标签页"
+  },
+  "disconnectTab": {
+    "message": "断开此标签页"
   }
 }

package/extension/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": 3,
   "default_locale": "en",
   "name": "__MSG_appName__",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "__MSG_appDesc__",
   "minimum_chrome_version": "116",
   "permissions": [

package/extension/popup.html

@@ -57,7 +57,7 @@
       @keyframes spin { to { transform: rotate(360deg); } }
       @media (prefers-reduced-motion: reduce) { .spin { animation-duration: 2.4s; } }
 
-      .target { margin: 8px 0; padding: 7px 8px; background: #15181e; border: 1px solid var(--line); border-radius: 7px; }
+      .target { display: flex; align-items: flex-start; justify-content: space-between; gap: 8px; margin: 8px 0; padding: 7px 8px; background: #15181e; border: 1px solid var(--line); border-radius: 7px; }
       .target-title { font-size: 12px; font-weight: 500; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
       .target-url { margin-top: 1px; color: var(--muted); font-size: 10.5px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
       .target.empty .target-title { color: var(--muted); font-weight: 400; }
@@ -74,6 +74,7 @@
       }
       button:hover:not(:disabled) { border-color: #3a4150; background: #242935; }
       button:disabled { opacity: 0.45; cursor: default; }
+      button.primary#claim-more { margin-top: 8px; font-size: 12px; padding: 7px 10px; }
       button.primary { width: 100%; background: var(--accent); border-color: var(--accent); color: var(--accent-ink); font-weight: 600; }
       button.primary:hover:not(:disabled) { background: #6b8aff; border-color: #6b8aff; }
       button.primary:disabled { background: #20242d; border-color: var(--line); color: var(--muted); font-weight: 500; }
@@ -92,6 +93,7 @@
       }
       button.link:hover:not(:disabled) { color: #7e98ff; background: none; }
 
+      .target-text { min-width: 0; flex: 1; display: flex; flex-direction: column; gap: 2px; }
       .capture-row { display: flex; align-items: center; justify-content: space-between; gap: 8px; margin-top: 8px; padding-top: 8px; border-top: 1px solid var(--line); }
       .capture-row button { padding: 5px 9px; font-size: 11.5px; }
       select {
@@ -139,22 +141,26 @@
     <section class="card">
       <div class="card-head">
         <span class="pill"><i class="dot" id="dot"></i><i class="spin" id="spin" hidden></i><span id="connection-text" data-i18n="statusConnecting">Проверяю…</span></span>
-        <span style="display:flex;gap:6px;align-items:center">
-          <button class="icon" id="pick" data-i18n-title="pickHint" title="Pick an element">
-            <svg width="14" height="14" viewBox="0 0 20 20" aria-hidden="true"><path d="M3 2 L3 16 L7.2 12.2 L9.6 17.6 L12.2 16.4 L9.8 11.2 L15 11.2 Z" fill="currentColor"/></svg>
-          </button>
-          <button class="ghost" id="release" hidden data-i18n="disconnect">Отключить</button>
-        </span>
+        <button class="icon" id="pick" data-i18n-title="pickHint" title="Pick an element">
+          <svg width="14" height="14" viewBox="0 0 20 20" aria-hidden="true"><path d="M3 2 L3 16 L7.2 12.2 L9.6 17.6 L12.2 16.4 L9.8 11.2 L15 11.2 Z" fill="currentColor"/></svg>
+        </button>
       </div>
 
       <div class="target empty" id="target-block">
-        <div class="target-title" id="target-title" data-i18n="targetNoneTitle">Вкладка не подключена</div>
-        <div class="target-url" id="target-url" data-i18n="targetNoneUrl">Откройте нужную страницу и подключите её</div>
+        <div class="target-text">
+          <div class="target-title" id="target-title" data-i18n="targetNoneTitle">Вкладка не подключена</div>
+          <div class="target-url" id="target-url" data-i18n="targetNoneUrl">Откройте нужную страницу и подключите её</div>
+        </div>
+        <button class="icon" id="release" hidden data-i18n-title="disconnectTab" title="Отключить вкладку">
+          <svg width="12" height="12" viewBox="0 0 12 12" aria-hidden="true"><path d="M2 2 L10 10 M10 2 L2 10" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/></svg>
+        </button>
       </div>
 
       <button class="primary" id="claim" data-i18n="connectTab">Подключить эту вкладку</button>
       <p class="status-note" id="status-note" hidden></p>
 
+      <button class="primary" id="claim-more" hidden data-i18n="attachAnother">Подключить ещё вкладку</button>
+
       <div class="capture-row" id="tabs-row" hidden>
         <span class="muted" data-i18n="tabsLabel">Вкладки</span>
         <select id="tabs-select"></select>

package/extension/popup.js

@@ -101,6 +101,7 @@ function render(status) {
   const targets = Array.isArray(status.targets) ? status.targets : []
   const tabsRow = $('tabs-row')
   const tabsSelect = $('tabs-select')
+  $('claim-more').hidden = !hasTarget
   if (targets.length > 1) {
     tabsRow.hidden = false
     tabsSelect.textContent = ''
@@ -267,6 +268,12 @@ $('pick').addEventListener('click', async () => {
   await refresh()
 })
 
+$('claim-more').addEventListener('click', async () => {
+  const result = await send({ type: 'claim' })
+  if (!result?.ok && result?.error) setNote(String(result.error), true)
+  await refresh()
+})
+
 $('tabs-select').addEventListener('change', async (event) => {
   const tabId = Number(event.target.value)
   if (!Number.isFinite(tabId)) return

package/extension/sw.js

@@ -665,6 +665,99 @@ async function readPick(tabId) {
   return result?.value ?? null
 }
 
+/**
+ * Injected into the page: a compact list of what a person can act on, with a
+ * stable selector for each, so the agent can pick one without reading the
+ * whole snapshot bundle.
+ */
+function compactSnapshotInPage(options) {
+  const limit = Math.max(1, Math.min(Number(options?.limit ?? 120), 400))
+  const cssEsc = (value) => (window.CSS && CSS.escape ? CSS.escape(value) : String(value).replace(/[^a-zA-Z0-9_-]/g, '\\$&'))
+  const count = (selector) => {
+    try { return document.querySelectorAll(selector).length } catch { return -1 }
+  }
+
+  function selectorFor(el) {
+    const candidates = []
+    if (el.id) candidates.push('#' + cssEsc(el.id))
+    for (const attr of ['data-testid', 'data-test', 'data-qa', 'data-cy']) {
+      const value = el.getAttribute(attr)
+      if (value) candidates.push('[' + attr + '="' + value.replace(/"/g, '\\"') + '"]')
+    }
+    if (el.getAttribute('name')) {
+      candidates.push(el.tagName.toLowerCase() + '[name="' + el.getAttribute('name').replace(/"/g, '\\"') + '"]')
+    }
+    if (el.getAttribute('aria-label')) {
+      candidates.push('[aria-label="' + el.getAttribute('aria-label').replace(/"/g, '\\"') + '"]')
+    }
+    const classes = [...el.classList].filter((name) => /^[a-zA-Z][\w-]{2,}$/.test(name)).slice(0, 2)
+    if (classes.length > 0) {
+      candidates.push(el.tagName.toLowerCase() + classes.map((name) => '.' + cssEsc(name)).join(''))
+    }
+    const parts = []
+    let current = el
+    while (current && current.nodeType === 1 && parts.length < 8) {
+      let part = current.tagName.toLowerCase()
+      if (current.id) { parts.unshift('#' + cssEsc(current.id)); break }
+      const parent = current.parentElement
+      if (parent) {
+        const siblings = [...parent.children].filter((node) => node.tagName === current.tagName)
+        if (siblings.length > 1) part += ':nth-of-type(' + (siblings.indexOf(current) + 1) + ')'
+      }
+      parts.unshift(part)
+      current = parent
+    }
+    candidates.push(parts.join(' > '))
+    const unique = candidates.find((selector) => count(selector) === 1)
+    return unique ?? candidates[candidates.length - 1]
+  }
+
+  const SELECTOR = [
+    'a[href]', 'button', 'input', 'select', 'textarea', 'summary',
+    '[role="button"]', '[role="link"]', '[role="tab"]', '[role="menuitem"]',
+    '[role="checkbox"]', '[role="radio"]', '[role="switch"]',
+    '[contenteditable=""]', '[contenteditable="true"]', '[onclick]'
+  ].join(',')
+
+  const nodes = [...document.querySelectorAll(SELECTOR)]
+  const items = []
+  for (const el of nodes) {
+    if (el.closest('#__dsh_pick_overlay__')) continue
+    const style = getComputedStyle(el)
+    if (style.display === 'none' || style.visibility === 'hidden' || Number(style.opacity) === 0) continue
+    const rect = el.getBoundingClientRect()
+    if (rect.width === 0 && rect.height === 0) continue
+    const label = (el.getAttribute('aria-label') ?? '') ||
+      (el.getAttribute('placeholder') ?? '') ||
+      (el.innerText ?? '').trim().replace(/\s+/g, ' ') ||
+      (el.getAttribute('title') ?? '') ||
+      (el.getAttribute('value') ?? '')
+    const item = {
+      tag: el.tagName.toLowerCase(),
+      name: String(label).slice(0, 80),
+      selector: selectorFor(el),
+      box: { x: Math.round(rect.left), y: Math.round(rect.top), w: Math.round(rect.width), h: Math.round(rect.height) }
+    }
+    if (el.getAttribute('type')) item.type = el.getAttribute('type')
+    if (el.getAttribute('role')) item.role = el.getAttribute('role')
+    if (el.disabled === true || el.getAttribute('aria-disabled') === 'true') item.disabled = true
+    if (el.checked === true) item.checked = true
+    if (typeof el.value === 'string' && el.value !== '') item.value = el.value.slice(0, 60)
+    if (el.href && el.tagName === 'A') item.href = String(el.href).slice(0, 200)
+    items.push(item)
+    if (items.length >= limit) break
+  }
+
+  return {
+    url: location.href,
+    title: document.title,
+    total: nodes.length,
+    returned: items.length,
+    truncated: nodes.length > items.length,
+    items
+  }
+}
+
 /* ------------------------------------------------------------------ cursor */
 
 const CURSOR_ID = '__dsh_site_bridge_cursor__'
@@ -978,6 +1071,13 @@ async function runStep(op, step) {
       return { uploaded: files.length, to: step.selector }
     }
     case 'goto': {
+      if (step.back === true || step.forward === true) {
+        await cdp('Runtime.evaluate', {
+          expression: step.back === true ? 'history.back(); true' : 'history.forward(); true',
+          returnByValue: true
+        })
+        return { navigated: step.back === true ? 'back' : 'forward' }
+      }
       await cdp('Page.navigate', { url: String(step.url) })
       return { navigated: step.url }
     }
@@ -990,19 +1090,53 @@ async function runStep(op, step) {
         await sleep(Math.min(Number(step.ms), 60000))
         return { waitedMs: Number(step.ms) }
       }
+      if (step.state === 'settle') {
+        const quietMs = Math.min(Number(step.quietMs ?? 400), 5000)
+        const budget = Math.min(Number(step.timeoutMs ?? 15000), 60000)
+        const { result } = await cdp('Runtime.evaluate', {
+          expression: `new Promise((resolve) => {
+            let timer = null;
+            const done = () => { observer.disconnect(); resolve(true); };
+            const restart = () => { clearTimeout(timer); timer = setTimeout(done, ${quietMs}); };
+            const observer = new MutationObserver(restart);
+            observer.observe(document.documentElement, { childList: true, subtree: true, attributes: true, characterData: true });
+            restart();
+            setTimeout(() => { observer.disconnect(); resolve(false); }, ${budget});
+          })`,
+          awaitPromise: true,
+          returnByValue: true
+        })
+        if (result?.value !== true) throw new Error(`page did not settle within ${budget} ms`)
+        return { settled: true, quietMs }
+      }
+      const wantHidden = step.state === 'hidden'
       const deadline = Date.now() + Math.min(Number(step.timeoutMs ?? 15000), 60000)
+      let lastValue = null
       while (Date.now() < deadline) {
-        const { result } = await cdp('Runtime.evaluate', {
+        const { result, exceptionDetails } = await cdp('Runtime.evaluate', {
           expression: `(() => {
             ${PAGE_RESOLVER}
-            return Boolean(__dshDeep(${JSON.stringify(step.selector)}));
+            const hit = __dshDeep(${JSON.stringify(step.selector)});
+            if (!hit || !hit.el) return ${wantHidden ? 'true' : 'false'};
+            if (${wantHidden ? 'true' : 'false'}) {
+              const el = hit.el;
+              const style = getComputedStyle(el);
+              const rect = el.getBoundingClientRect();
+              return style.display === 'none' || style.visibility === 'hidden' || Number(style.opacity) === 0 ||
+                (rect.width === 0 && rect.height === 0);
+            }
+            return true;
           })()`,
           returnByValue: true
         })
-        if (result?.value === true) return { appeared: step.selector }
+        if (exceptionDetails) throw new Error(`не удалось проверить ${step.selector}: ${exceptionDetails.exception?.description ?? exceptionDetails.text ?? 'ошибка в странице'}`)
+        lastValue = result?.value
+        if (lastValue === true) {
+          return wantHidden ? { hidden: step.selector } : { appeared: step.selector }
+        }
         await sleep(200)
       }
-      throw new Error(`timed out waiting for ${step.selector}`)
+      throw new Error(`timed out waiting for ${step.selector} to be ${wantHidden ? 'hidden' : 'visible'} (last value: ${JSON.stringify(lastValue)})`)
     }
     case 'eval': {
       const { result, exceptionDetails } = await cdp('Runtime.evaluate', {
@@ -1353,6 +1487,48 @@ async function dispatch(op, args) {
       const active = activeSession()
       return { target: active?.target ?? null, attached: state.activeTabId, tabs: [...state.sessions.keys()] }
     }
+    case 'tab.open': {
+      const tab = await chrome.tabs.create({ url: String(args.url ?? 'about:blank'), active: args.active !== false })
+      await attach(tab.id)
+      return { target: state.sessions.get(tab.id)?.target ?? { id: tab.id, url: tab.url, title: tab.title } }
+    }
+    case 'tab.focus': {
+      const session = requireSession(args.tabId)
+      await chrome.tabs.update(session.tabId, { active: true })
+      const tab = await chrome.tabs.get(session.tabId)
+      if (tab.windowId != null) await chrome.windows.update(tab.windowId, { focused: true }).catch(() => {})
+      return { focused: session.tabId }
+    }
+    case 'snapshot.compact': {
+      const session = requireSession(args.tabId)
+      const { result } = await cdp('Runtime.evaluate', {
+        expression: `(${compactSnapshotInPage.toString()})(${JSON.stringify({ limit: args.limit })})`,
+        returnByValue: true
+      }, session.tabId)
+      return result?.value ?? { items: [], total: 0, returned: 0, truncated: false }
+    }
+    case 'text.get': {
+      const session = requireSession(args.tabId)
+      const maxChars = Math.max(20, Math.min(Number(args.maxChars ?? 8000), 40000))
+      const root = args.selector ? `__dshDeep(${JSON.stringify(String(args.selector))})` : 'document.body'
+      const { result } = await cdp('Runtime.evaluate', {
+        expression: `(() => {
+          ${PAGE_RESOLVER}
+          const root = ${root};
+          if (!root) return { error: 'element not found' };
+          const text = (root.innerText ?? root.textContent ?? '').replace(/\\n{3,}/g, '\\n\\n').trim();
+          return {
+            text: text.slice(0, ${maxChars}),
+            chars: text.length,
+            truncated: text.length > ${maxChars},
+            url: location.href,
+            title: document.title
+          };
+        })()`,
+        returnByValue: true
+      }, session.tabId)
+      return result?.value ?? { text: '', chars: 0, truncated: false }
+    }
     case 'net.start': {
       const session = requireSession(args.tabId)
       return { recording: await setRecording(session, true), tabId: session.tabId }

package/lib/index.js

@@ -42,8 +42,8 @@ const DOCS = {
     'press {key}',
     'scroll {selector?} | scroll {dx, dy}',
     'upload {selector, files: ["C:\\\\abs\\\\path.pdf"]} — absolute paths on this machine',
-    'goto {url} | reload {hard?}',
-    'wait {selector, timeoutMs?} | wait {ms}',
+    'goto {url} | goto {back:true} | goto {forward:true} | reload {hard?}',
+    'wait {selector, state:"visible"|"hidden", timeoutMs?} | wait {state:"settle", quietMs?} | wait {ms}',
     'exists {selector}',
     'eval {expression}',
     'screenshot {fullPage?} — лучше site_shot: он пишет файл, а не base64 в контекст'
@@ -258,14 +258,31 @@ export function apply(ctx, config) {
     tool(
       'site_tabs',
       'Вкладки браузера и выбор рабочей вкладки. Можно держать подключёнными несколько вкладок: ' +
-      'claim добавляет ещё одну, use переключает активную, release отключает. Вкладка должна быть http(s) или file://.',
+      'claim добавляет ещё одну, use переключает активную, release отключает, open открывает новую и сразу ' +
+      'подключает её, focus выводит вкладку на передний план. Вкладка должна быть http(s) или file://.',
       {
-        action: { type: 'string', description: 'list | claim | use | release' },
-        tabId: { type: 'number', description: 'id вкладки для claim / use / release (из action=list)' }
+        action: { type: 'string', description: 'list | claim | use | release | open | focus' },
+        tabId: { type: 'number', description: 'id вкладки для claim / use / release / focus (из action=list)' },
+        url: { type: 'string', description: 'адрес для action=open (по умолчанию about:blank)' }
       },
       async (args) => {
         const instance = await ensureBridge()
         const action = String(args.action ?? 'list')
+        if (action === 'open') {
+          const result = await instance.enqueue(
+            'tab.open',
+            { url: String(args.url ?? 'about:blank') },
+            { timeout: 30000 }
+          )
+          const target = result?.target ?? null
+          return ok(`Открыта и подключена вкладка: ${target?.title || ''} — ${target?.url || ''}`, { target })
+        }
+        if (action === 'focus') {
+          const tabId = Number(args.tabId ?? instance.state().activeTabId)
+          if (!Number.isFinite(tabId)) throw new Error('нечего выводить на передний план: нет подключённой вкладки')
+          await instance.enqueue('tab.focus', { tabId }, { timeout: 20000 })
+          return ok(`Вкладка ${tabId} на переднем плане.`, { tabId })
+        }
         if (action === 'claim' || action === 'use' || action === 'release') {
           const tabId = Number(args.tabId)
           if (!Number.isFinite(tabId)) throw new Error(`tabId is required for action=${action}`)
@@ -653,6 +670,63 @@ export function apply(ctx, config) {
     )
   )
 
+  ctx.tools.register(
+    tool(
+      'site_snapshot',
+      'Компактный список интерактивных элементов страницы (кнопки, ссылки, поля, role=button и подобное): ' +
+      'подпись, тип, состояние и устойчивый CSS-селектор для каждого. Нужен, чтобы выбрать элемент для site_act, ' +
+      'не открывая пакет снимка целиком.',
+      {
+        limit: { type: 'number', description: 'Сколько элементов вернуть (по умолчанию 120, максимум 400)' },
+        tab: { type: 'number', description: 'id вкладки (по умолчанию активная)' }
+      },
+      async (args) => {
+        const instance = await ensureBridge()
+        pickTarget(instance, args.tab)
+        const data = await instance.enqueue(
+          'snapshot.compact',
+          { limit: args.limit, ...tabArgs(args) },
+          { timeout: 30000 }
+        )
+        const items = Array.isArray(data?.items) ? data.items : []
+        if (items.length === 0) return ok('Интерактивных элементов не найдено.', { snapshot: data })
+        const lines = items.map((item, index) => {
+          const kind = item.type ? `${item.tag}[${item.type}]` : item.tag
+          const flags = item.disabled ? ' — недоступен' : item.checked ? ' — отмечен' : ''
+          return `${index + 1}. ${kind} «${item.name || '(без подписи)'}» → ${item.selector}${flags}`
+        })
+        const head = `Интерактивные элементы: ${data?.returned ?? items.length} из ${data?.total ?? items.length}${data?.truncated ? ' (список обрезан)' : ''}`
+        return ok(`${head}\n${lines.join('\n')}`, { snapshot: data })
+      }
+    )
+  )
+
+  ctx.tools.register(
+    tool(
+      'site_text',
+      'Видимый текст страницы или её поддерева — проверить, что после действия появилось нужное сообщение. ' +
+      'Возвращает текст с лимитом и пометкой обрезки.',
+      {
+        selector: { type: 'string', description: 'Поддерево (по умолчанию вся страница)' },
+        maxChars: { type: 'number', description: 'Лимит символов (по умолчанию 8000, максимум 40000)' },
+        tab: { type: 'number', description: 'id вкладки (по умолчанию активная)' }
+      },
+      async (args) => {
+        const instance = await ensureBridge()
+        pickTarget(instance, args.tab)
+        const data = await instance.enqueue(
+          'text.get',
+          { selector: args.selector, maxChars: args.maxChars, ...tabArgs(args) },
+          { timeout: 30000 }
+        )
+        if (data?.error) throw new Error(String(data.error))
+        const text = String(data?.text ?? '')
+        const note = data?.truncated ? `\n… обрезано, всего ${data.chars} символов` : ''
+        return ok(`${text || '(пусто)'}${note}`, { text, chars: data?.chars ?? text.length, truncated: data?.truncated === true })
+      }
+    )
+  )
+
   if (settings.autoStart) {
     void ensureBridge().catch((error) => {
       ctx.logger?.warn?.(`[dsh-site-bridge] bridge did not start: ${String(error?.message ?? error)}`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-site-bridge",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Chrome/Edge MV3 bridge for DeepSeek Harness: capture page markup (DOM, styles, selectors) and BFF traffic (xhr/fetch with headers and bodies) into a workspace snapshot bundle, drive the page with trusted CDP input, and verify injected scripts. Authorization never leaves the browser and is never written to disk.",
   "type": "module",
   "main": "./lib/index.js",
@@ -40,7 +40,8 @@
     "version:check": "node tools/version.mjs check",
     "version:bump": "node tools/version.mjs bump",
     "stage": "powershell -NoProfile -ExecutionPolicy Bypass -File scripts/install.ps1 -StageOnly",
-    "test:picker": "node test/picker.mjs"
+    "test:picker": "node test/picker.mjs",
+    "test:ops": "node test/browser-ops.mjs"
   },
   "dsh": {
     "bundle": {

package/tools/preview-popup.mjs

@@ -21,6 +21,14 @@ const chromePath = process.env.CHROME_PATH ?? 'C:\\Program Files\\Google\\Chrome
 const sleep = (ms) => new Promise((done) => setTimeout(done, ms))
 
 const statuses = {
+  'connected-one': {
+    ok: true, configured: true, connected: true, port: 47321, recording: false, captured: 0,
+    activeTabId: 1,
+    target: { id: 1, title: 'Example Store — Products', url: 'https://shop.example/products' },
+    targets: [
+      { id: 1, title: 'Example Store — Products', url: 'https://shop.example/products', recording: false, captured: 0 }
+    ]
+  },
   connected: {
     ok: true, configured: true, connected: true, port: 47321, recording: true, captured: 12,
     activeTabId: 1,