dsh-inner-browser-use 0.11.44 → 0.13.0

package/locale/en.json

@@ -1,26 +1,15 @@
 {
   "meta": {
-    "title": "Inner Browser Use",
-    "description": "Drive the sidebar browser itself: a visible agent pointer, click and type, and a two-way channel to the chat."
+    "title": "Background browser",
+    "description": "A browser the agent drives behind the chat, mirrored into the right column."
   },
-  "type.label": "Inner browser",
-  "guide.title": "Inner browser",
-  "guide.description": "Let the assistant drive a page in the sidebar",
-  "phase.opening": "Opening…",
-  "phase.ready": "Connected",
-  "phase.closed": "Closed",
-  "error.desktopOnly": "Requires the desktop app",
-  "error.lease": "Could not open the browser panel",
-  "pane.address": "Type an address",
-  "error.background": "This chat is not open on screen — open it to drive its page.",
-  "phase.act.navigate": "Opening the page",
-  "phase.act.click": "Clicking",
-  "phase.act.read": "Reading the page",
-  "phase.act.type": "Typing",
-  "phase.act.scroll": "Scrolling",
-  "phase.act.shot": "Taking an image",
-  "phase.act.download": "Saving a file",
-  "phase.act.upload": "Uploading",
-  "phase.act.eval": "Working on the page",
-  "phase.act.select": "Choosing"
+  "side.label": "Background browser",
+  "side.empty": "No page open",
+  "side.connecting": "Connecting…",
+  "side.failed": "The picture did not connect",
+  "side.back": "Back",
+  "side.forward": "Forward",
+  "side.reload": "Reload",
+  "side.address": "Enter an address",
+  "side.type": "Type here"
 }

package/locale/zh.json

@@ -1,26 +1,15 @@
 {
   "meta": {
-    "title": "内置浏览器",
-    "description": "直接操作侧边栏里的浏览器：看得见的助手指针、点击与输入，以及与聊天互通的数据通道。"
+    "title": "后台浏览器",
+    "description": "助手在后台操作的浏览器，画面镜像到右栏。"
   },
-  "type.label": "内置浏览器",
-  "guide.title": "内置浏览器",
-  "guide.description": "让助手在侧边栏里操作页面",
-  "phase.opening": "正在打开…",
-  "phase.ready": "已连接",
-  "phase.closed": "已关闭",
-  "error.desktopOnly": "需要在桌面版中使用",
-  "error.lease": "无法打开浏览器面板",
-  "pane.address": "输入网址",
-  "error.background": "这个会话没在当前屏幕，切到它才能操作页面。",
-  "phase.act.navigate": "正在打开页面",
-  "phase.act.click": "正在点击",
-  "phase.act.read": "正在读取页面",
-  "phase.act.type": "正在输入",
-  "phase.act.scroll": "正在滚动",
-  "phase.act.shot": "正在截图",
-  "phase.act.download": "正在下载",
-  "phase.act.upload": "正在上传",
-  "phase.act.eval": "正在操作页面",
-  "phase.act.select": "正在选择"
+  "side.label": "后台浏览器",
+  "side.empty": "还没有打开的页面",
+  "side.connecting": "正在连接…",
+  "side.failed": "画面没有连上",
+  "side.back": "后退",
+  "side.forward": "前进",
+  "side.reload": "刷新",
+  "side.address": "输入地址",
+  "side.type": "输入文字"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-inner-browser-use",
-  "version": "0.11.44",
-  "description": "Drive the DeepSeek Harness sidebar browser itself: a leased inner-browser tab with a visible agent pointer, click and type, and a two-way data channel to the chat.",
+  "version": "0.13.0",
+  "description": "An agent-owned Chromium sidecar mirrored into the DeepSeek Harness right column: the agent drives it, the person watches and can take the mouse, and logins survive restarts.",
   "type": "module",
   "main": "index.js",
   "exports": {
@@ -13,10 +13,12 @@
   },
   "files": [
     "index.js",
+    "sidecar.js",
     "client.js",
     "locale/*.json",
     "cordis.patch.yml",
     "icon.svg",
+    "scripts/doctor.mjs",
     "docs/",
     "README.md",
     "README.zh.md",
@@ -28,8 +30,9 @@
     "dsh-plugin",
     "browser-use",
     "computer-use",
-    "sidebar-browser",
-    "webview",
+    "chrome",
+    "cdp",
+    "screencast",
     "deepseek"
   ],
   "engines": {
@@ -38,7 +41,8 @@
   },
   "scripts": {
     "test": "node --test test/*.test.mjs",
-    "doctor": "node scripts/doctor.mjs"
+    "doctor": "node scripts/doctor.mjs",
+    "breadth": "node scripts/breadth.mjs"
   },
   "license": "MIT",
   "author": "regrevia",

package/scripts/doctor.mjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+/**
+ * Report what the sidecar browser is doing right now: whether the Host answers,
+ * whether a Chromium is attached, which profile it uses, and whether that
+ * profile is outside the Host so logins outlive a restart. Reads only; nothing
+ * is started, attached, or closed.
+ *
+ *   node scripts/doctor.mjs
+ */
+
+import { execFile } from 'node:child_process'
+import { existsSync, readFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { promisify } from 'node:util'
+
+const run = promisify(execFile)
+const ROUTE = '/dsh-inner-browser-use'
+const PROFILES = join(homedir(), '.dsh', 'inner-browser-use', 'chrome')
+
+/**
+ * The Host picks its port each time it starts, so try the asked-for address
+ * first and then whatever the running app is listening on.
+ * @returns {Promise<string[]>} candidate addresses, without trailing slash.
+ */
+async function addresses() {
+  const asked = (process.env.DSH_BRIDGE ?? '').trim().replace(/\/+$/, '')
+  const found = asked === '' ? [] : [asked]
+  found.push('http://127.0.0.1:60930')
+  try {
+    const { stdout } = await run('lsof', ['-nP', '-iTCP', '-sTCP:LISTEN', '-a', '-c', 'DeepSeek'], { timeout: 4_000 })
+    for (const line of String(stdout).split('\n')) {
+      const hit = /127\.0\.0\.1:(\d{4,5})\s/.exec(line)
+      if (hit === null) continue
+      const address = `http://127.0.0.1:${hit[1]}`
+      if (found.includes(address) === false) found.push(address)
+    }
+  } catch {
+    /* no lsof, or nothing listening: the default address is all that is left */
+  }
+  return found
+}
+
+let base = ''
+
+/**
+ * @param {string} path - route under this plugin.
+ * @returns {Promise<any>} parsed body, or null when no address answers.
+ */
+async function get(path) {
+  const tried = base === '' ? await addresses() : [base]
+  for (const address of tried) {
+    try {
+      const response = await fetch(address + path, { signal: AbortSignal.timeout(4_000) })
+      if (response.ok !== true) continue
+      base = address
+      return await response.json()
+    } catch {
+      /* the next address may be the one this app is on */
+    }
+  }
+  return null
+}
+
+const state = await get(`${ROUTE}/sidecar/state`)
+console.log(`host     ${state === null ? `not answering under ${ROUTE}` : base}`)
+if (state === null) {
+  console.log('         start the app, or set DSH_BRIDGE to the app address')
+  process.exit(0)
+}
+
+console.log(`browser  ${state.alive === true ? `attached, ${state.headless === true ? 'headless' : 'with a window'}` : 'not running'}`)
+const profileDir = join(PROFILES, String(state.profile ?? ''))
+console.log(`profile  ${state.profile} in ${profileDir}`)
+console.log(`stored   ${existsSync(profileDir) ? 'on disk, so cookies and logins survive a restart' : 'not created yet'}`)
+if (state.alive === true) {
+  console.log(`page     ${String(state.title ?? '') === '' ? String(state.url ?? '') : state.title}`)
+  console.log(`viewers  ${state.viewers} | frames ${state.frames} | pointer ${state.pointer === null ? 'none' : `${state.pointer.x},${state.pointer.y}`}`)
+}
+
+const portFile = join(profileDir, 'DevToolsActivePort')
+if (existsSync(portFile)) {
+  const [port = '', path = ''] = readFileSync(portFile, 'utf8').trim().split('\n')
+  console.log(`control  port ${port}, ${path.startsWith('/devtools/') ? 'endpoint file present' : 'endpoint file odd'}`)
+} else {
+  console.log('control  no DevToolsActivePort yet')
+}
+
+if (String(state.error ?? '') !== '') console.log(`error    ${state.error}`)