dsh-site-bridge 0.4.1 → 0.5.1

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
@@ -123,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

package/README.ru.md

@@ -123,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:"..."}          → выполнить ваш скрипт в странице для проверки

package/README.zh-CN.md

@@ -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:"..."}          → 在页面里执行你的脚本以验证
 ```
 
 编写页内扩展的典型循环：

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.1",
+  "version": "0.5.1",
   "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/icon.svg

@@ -0,0 +1,27 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128" role="img" aria-label="DSH Site Bridge">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#5b7cff"/>
+      <stop offset="1" stop-color="#2a45e0"/>
+    </linearGradient>
+    <linearGradient id="ink" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#3f5cf0"/>
+      <stop offset="1" stop-color="#2a3fd6"/>
+    </linearGradient>
+  </defs>
+
+  <rect width="128" height="128" rx="26" fill="url(#bg)"/>
+
+  <!-- optical size: inverted tile keeps contrast at 16px -->
+  <rect x="13" y="15" width="102" height="98" rx="20" fill="#ffffff"/>
+
+  <!-- the browser bar, so the tile reads as a page and not a card -->
+  <line x1="13" y1="41" x2="115" y2="41" stroke="url(#ink)" stroke-width="7"/>
+  <circle cx="27" cy="28" r="3.4" fill="url(#ink)"/>
+  <circle cx="39" cy="28" r="3.4" fill="url(#ink)" opacity="0.65"/>
+
+  <!-- whale cut out of the page -->
+  <path d="M72 60 L 96 43 L 88 65 L 96 87 L 70 76 Z" fill="url(#ink)"/>
+  <path d="M24 86 C 24 67, 42 53, 63 55 C 82 57, 91 68, 90 80 C 89 94, 72 101, 53 97 C 37 94, 24 93, 24 86 Z"
+        fill="url(#ink)"/>
+</svg>

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,7 +1,8 @@
 {
   "name": "dsh-site-bridge",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "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.",
+  "icon": "./icon.svg",
   "type": "module",
   "main": "./lib/index.js",
   "exports": {
@@ -15,7 +16,8 @@
     "docs",
     "scripts",
     "tools",
-    "cordis.patch.yml"
+    "cordis.patch.yml",
+    "icon.svg"
   ],
   "keywords": [
     "deepseek-harness",
@@ -40,7 +42,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,