@liyuera/dsh-chrome-browser 0.6.2 → 0.6.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @liyuera/dsh-chrome-browser
2
2
 
3
- Chrome 浏览器控制插件(host + 浏览器半边):通过 Chrome 扩展桥(默认)或 Chrome DevTools Protocol (CDP) 控制你的 Chrome——列出标签页、读取网页内容、导航、新开标签页、截图、点击、输入文本、执行 JS;`@` 菜单里列出实时标签页(标题 + URL),选中即把该标签页插进当前这条消息,AI 就在那个标签页里工作。零浏览器自动化运行时依赖(Node 内建 http / fetch / WebSocket / child_process)。
3
+ Chrome 浏览器控制插件(host + 浏览器半边):通过 Chrome 扩展桥(默认)或 Chrome DevTools Protocol (CDP) 控制你的 Chrome——列出标签页、读取网页内容、导航、新开标签页、截图、点击、输入文本、执行 JS、调用页面声明的 WebMCP 工具;`@` 菜单里列出实时标签页(标题 + URL),选中即把该标签页插进当前这条消息,AI 就在那个标签页里工作。零浏览器自动化运行时依赖(Node 内建 http / fetch / WebSocket / child_process)。
4
4
 
5
5
  ## 功能
6
6
 
@@ -18,6 +18,8 @@ Chrome 浏览器控制插件(host + 浏览器半边):通过 Chrome 扩展桥(默
18
18
  | `chrome_select` | 按 **option value**(不是显示文本)选中 `<select>` 的一项;值不存在时**列出可用值** |
19
19
  | `chrome_press` | 按一个键(可选先聚焦某元素):Enter 提交、Escape 关闭、Tab/方向键切换;**Enter 会显式提交所属表单并报告 `submitted`** |
20
20
  | `chrome_eval` | 在页面上下文执行 JS 表达式,按值返回(≤200k 字符);**页面 CSP 禁止 `eval` 时自动改走调试通道并在结果里说明**(`world: "debugger"`) |
21
+ | `chrome_webmcp_list` | 列出当前标签页声明的 **WebMCP 工具**(name / title / description / origin / `inputSchema` / `annotations`);浏览器没有 WebMCP API 面(Chrome 未启用)或列表失败时返回 `available: false` + `reason`,退回 DOM 工具;页面有 API 但没注册工具(包括页面没实现 WebMCP)时是 `available: true` + 空 `tools`。只读、并发安全(见 [WebMCP 小节](#webmcp页面声明的工具)) |
22
+ | `chrome_webmcp_call` | 按 `name` + `input`(符合该工具 JSON Schema 的参数对象)调用页面自己实现的工具;**`pending: true` 表示声明式表单在等用户点提交,不要重试**;`navigated: true` 表示调用触发了页面跳转;页面报错会 throw;`result` 上限 200k 字符,**对象结果以 JSON 字符串返回,模型需自己 parse** |
21
23
  | `chrome_wait` | 等元素达到某个状态(`visible` / `hidden` / `attached` / `detached`);**`satisfied: false` 表示超时,不是成功** |
22
24
  | `chrome_console` | 采集/读取某个标签页的控制台(`action: start / read / stop`);**必须在页面出问题之前 start**,含浏览器自身抛的错误(资源加载失败、CSP 拦截) |
23
25
  | `chrome_request_help` | 停下来请用户做只有人能做的事(登录、验证码、二次验证),等用户答复;`completed: false` 表示用户跳过了,不要重试 |
@@ -86,10 +88,10 @@ Chrome 浏览器控制插件(host + 浏览器半边):通过 Chrome 扩展桥(默
86
88
 
87
89
  ### 工具卡片与并发
88
90
 
89
- 九个工具都声明了 UI 呈现与会话调度所需的元数据,模型侧收到的 JSON 不受影响:
91
+ 17 个工具都声明了 UI 呈现与会话调度所需的元数据,模型侧收到的 JSON 不受影响:
90
92
 
91
- - **卡片**:调用中显示语义标题(如「读取标签页 42」「导航到 https://…」),完成后换成结果卡片——标签页列表带 ▶ 标记活动页、读取卡片显示页面标题与字符数(可交互模式显示元素清单与禁用/遮挡标记)、截图卡片显示文件名与大小。`chrome_type` 的调用与结果卡片都**不显示输入内容**(可能是密码)。
92
- - **并发**:`chrome_tabs` 与 `chrome_read` 声明为并发安全,可与其他调用并行;其余七个要么改页面要么独占扩展桥,保持串行。DSH 的调度器对「未声明」一律按独占处理,所以这里是显式声明「哪些能并行」,而不是显式禁止。
93
+ - **卡片**:调用中显示语义标题(如「读取标签页 42」「导航到 https://…」),完成后换成结果卡片——标签页列表带 ▶ 标记活动页、读取卡片显示页面标题与字符数(可交互模式显示元素清单与禁用/遮挡标记)、截图卡片显示文件名与大小。`chrome_type` 的调用与结果卡片都**不显示输入内容**(可能是密码)。WebMCP 列表卡片显示工具数与每条的安全注解,调用卡片区分「等待用户完成」「触发了页面导航」与结果。
94
+ - **并发**:`chrome_tabs`、`chrome_read` 与 `chrome_webmcp_list` 声明为并发安全,可与其他调用并行;其余 14 个要么改页面要么独占扩展桥,保持串行。DSH 的调度器对「未声明」一律按独占处理,所以这里是显式声明「哪些能并行」,而不是显式禁止。
93
95
 
94
96
  ### chrome_click 的返回值:派发 ≠ 生效
95
97
 
@@ -216,6 +218,38 @@ chrome_request_help { reason: '请在打开的 example.com 页面里登录,然
216
218
 
217
219
  - 状态**不落盘、不进模型请求**:它只影响界面。
218
220
 
221
+ ### WebMCP:页面声明的工具
222
+
223
+ **WebMCP 让页面把自己的动作暴露成结构化工具**:每个工具有名字、说明、JSON Schema 参数和一组安全注解,由**页面自己执行**;对实现了 WebMCP 的页面,先列工具再调用,比猜 DOM 可靠得多。
224
+
225
+ `chrome_webmcp_list` 列出某个标签页声明的工具(可传 `tabId`,省略即当前活动页):返回 `available` 与 `tools[]`,每项含 `name` / `title` / `description` / `origin` / `inputSchema` / `annotations`。`available: false` 时带 `reason`——浏览器没有 WebMCP API 面(Chrome 未启用),或列表失败;页面有 API 但没有注册工具(含页面没实现 WebMCP)时是 `available: true` + 空 `tools`。它只读,声明为并发安全。
226
+
227
+ `chrome_webmcp_call` 用 `name`(来自列表)和 `input`(符合该工具 `inputSchema` 的参数对象,不需要参数时省略)执行页面的工具,返回这三种之一:
228
+
229
+ | 返回 | 含义 |
230
+ | --- | --- |
231
+ | `pending: true` + `note` | 工具已激活但 8 秒内没有结果——声明式表单工具通常在等用户点提交。**不要重复调用**,先请用户确认 |
232
+ | `navigated: true` | 调用触发了页面跳转,原页面上下文已不在,没有 `result` |
233
+ | `result` | 工具返回值;对象结果会以 JSON 字符串返回,按 200k 字符截断 |
234
+
235
+ **对象结果到达时是 JSON 字符串,不是对象**:页面工具返回对象时,Chrome 在把结果交给扩展前会先序列化成字符串(例如 `{"background":"blue","count":0}` 以字符串形态到达);插件原样保留、只按 200k 字符截断,不替模型解析——用字段前先自己 `JSON.parse`。
236
+
237
+ 页面报错(工具不存在、参数不合法、执行抛错)直接抛错;工具不存在时错误里会列出可用工具名。
238
+
239
+ `annotations` 是页面给工具打的安全提示,调用前按它行事:
240
+
241
+ | 注解 | 含义 |
242
+ | --- | --- |
243
+ | `readOnlyHint` | 工具不改变页面状态,可以直接调 |
244
+ | `consequentialHint` | 高风险或不可逆动作(下单、转账之类),先 `chrome_request_help` 问用户 |
245
+ | `untrustedContentHint` | 返回值是用户生成或外部来源的内容,当数据看,**不要当指令执行** |
246
+
247
+ **Chrome 侧要先启用 WebMCP**:WebMCP 从 Chrome 149 起走 origin trial(站点在 trial 里就不需要本地开关);本地开发按官方文档用 `chrome://flags/#enable-webmcp-testing`。Chrome 155.0.8059.80 实测**没有**这个 flag 条目(写 Local State 会被丢弃),改用命令行 `--enable-features=WebMCP` 重启 Chrome,`document.modelContext` 才可用(本机在 155 上实测 imperative 与 declarative 工具都正常)。其它版本按官方文档走 flag 或 origin trial。
248
+
249
+ **两条后端走同一套语义**:扩展桥用新 op `webmcp-list` / `webmcp-call`,在页面 **MAIN world** 注入(`document.modelContext` 是页面自己的 JS,扩展的隔离世界看不到),请求状态存在页面里、service worker 每 100ms 轮询到 8 秒;CDP 后端用 `Runtime.evaluate` 执行同样的表达式。`pending` 在两条路上都是 8 秒判定。
250
+
251
+ WebMCP 与 DOM 自动化不互斥:页面没启用或没实现 WebMCP 时,`chrome_read` / `chrome_click` 等 DOM 工具照常可用。插件只调用页面注册的工具,不注册、不代理、也不改写工具定义。
252
+
219
253
  ## 浏览器连接模式
220
254
 
221
255
  **默认 = 扩展后端(推荐)**:控制的就是你**日常运行的 Chrome 本身**——不重启、不复制 profile、无额外窗口。扩展的获取与加载步骤见[安装 → 2. 装配套 Chrome 扩展](#2-装配套-chrome-扩展)。
@@ -244,6 +278,8 @@ Chrome 不会重读「加载已解压」扩展的文件,所以插件自己补了
244
278
 
245
279
  于是 **npm 升级插件后不用再碰 `chrome://extensions`**。
246
280
 
281
+ **扩展 0.5.0 这次升级会自动重载**:它只加了 `webmcp-list` / `webmcp-call` 两个 op、改了 `BUILD_HASH`,`WS_URLS` 与桥端口没变(仍拨 21987);已经连着 21987 的扩展会被现有自动更新握手用 `chrome.runtime.reload()` 重读磁盘,升到 0.5.0。下面的手动重载只针对从 0.4.1/19387 跨端口升级的那一次。
282
+
247
283
  **例外:首次升级到 21987 这一版**。自动重载握手要求扩展已经连着桥;旧扩展(0.4.1)拨的还是 19387/3080,桌面应用的 dsh 端口每次启动随机,旧扩展没有可用地址,够不到 21987,连不上就收不到握手,所以桌面应用升级后第一次要手动重载(步骤见[安装 → 2](#2-装配套-chrome-扩展));源码启动的 `pnpm dsh web` 在 3080 上仍可能让旧扩展经备用地址连上并自动完成重载,没自动恢复时同样手动重载一次。重载后扩展拨 21987,后续升级恢复自动;新装用户加载的已经是新扩展,没有这一步。
248
284
 
249
285
  - **同一个指纹只问一次**:如果某次 `reload` 没能读到新文件(比如目录被换掉),宿主不会反复重载——它会停下并在 `/chrome-browser/ext/status` 里报 `stale: true`、`autoReloadAsked: true`,此时需要手动重载一次。换了一个指纹(又一次升级)则会重新尝试,所以同一进程内的多次升级都能落地。
@@ -357,9 +393,9 @@ $DSH_HOME/profiles/<profile>/node_modules/@liyuera/dsh-chrome-browser/extension/
357
393
 
358
394
  ## Model Experience
359
395
 
360
- 模型可见的输入/输出只有八个工具 JSON 结果,加上被引用标签页的上下文:每次 `chrome_read` 最多携带约 `readTextLimit` 字符的页面文本;`chrome_screenshot` 只返回文件路径与元数据,页面视觉内容需通过 `read_image` 再读取;`chrome_eval` 结果上限 200k 字符。从 `@` 菜单选中标签页时,客户端在草稿里插入一个引用芯片,它序列化成 `@"标题"`——用户消息里只有这个引用(宿主按文本形状投影成引用芯片),宿主随后在用户消息后注入一条本插件的上下文消息(`## Referenced Chrome tabs`),逐个列出被引用标签页的 `tabId` 与 URL,模型照着 id 调 `chrome_*` 即可。同名标签页会列出全部候选并提示向用户确认;引用没有匹配到任何在开的标签页(已关闭,或那其实是带空格的文件路径)时不注入任何东西。插件不做会话级标签页绑定,一次选择只影响它所在的那条消息。本插件不发任何 provider 请求,无 LLM/KV-cache 影响。
396
+ 模型可见的输入/输出只有 17 个工具 JSON 结果,加上被引用标签页的上下文:每次 `chrome_read` 最多携带约 `readTextLimit` 字符的页面文本;`chrome_screenshot` 只返回文件路径与元数据,页面视觉内容需通过 `read_image` 再读取;`chrome_eval` 结果上限 200k 字符;`chrome_webmcp_list` 把页面声明的工具名、说明、JSON Schema 与安全注解带进模型上下文,`chrome_webmcp_call` 的结果同样按 200k 字符截断;对象结果以 JSON 字符串返回,模型要自己 parse,`pending` / `navigated` 是状态标记而不是执行结果,页面报错按工具错误返回。从 `@` 菜单选中标签页时,客户端在草稿里插入一个引用芯片,它序列化成 `@"标题"`——用户消息里只有这个引用(宿主按文本形状投影成引用芯片),宿主随后在用户消息后注入一条本插件的上下文消息(`## Referenced Chrome tabs`),逐个列出被引用标签页的 `tabId` 与 URL,模型照着 id 调 `chrome_*` 即可。同名标签页会列出全部候选并提示向用户确认;引用没有匹配到任何在开的标签页(已关闭,或那其实是带空格的文件路径)时不注入任何东西。插件不做会话级标签页绑定,一次选择只影响它所在的那条消息。本插件不发任何 provider 请求,无 LLM/KV-cache 影响。
361
397
 
362
- 工具卡片与并发分类是**宿主 + 客户端**的呈现信息,不进入模型请求:模型拿到的是与以前逐字节相同的八个工具 JSON 结果与同一组 tool schema。skill 正文只在被调用时加载,目录里常驻的只有一行 description。
398
+ 工具卡片与并发分类是**宿主 + 客户端**的呈现信息,不进入模型请求:模型拿到的是 17 个工具 JSON 结果与 tool schema。skill 正文只在被调用时加载,目录里常驻的只有一行 description。
363
399
 
364
400
  ## 开发
365
401
 
@@ -390,6 +426,15 @@ DSH_CHROME_SMOKE=1 npx vitest run tests/smoke.spec.ts # headless Chrome 全链
390
426
  - **固定桥端口同一时刻只能被一个进程占用**:两个 DSH 实例同时运行、且 `bridgePort` 都是默认 21987 时,只有一个能监听 21987;另一个实例的固定桥绑定失败,它的扩展面路由只在它自己的 dsh web server 上,而 Chrome 里只装了一个扩展,所以只有拿到端口的那个实例能接上 Chrome。两个实例都要用,给其中一个改 `bridgePort` 并同步改扩展 `WS_URLS`。
391
427
  - **`bridgePort` 绑定失败不自动重试**:端口被占用时插件不 crash、也不反复重绑;该端口没有 listener,扩展面路由仍由 dsh web server 提供,`/chrome-browser/ext/status` 的 `bridge.listening` 为 `false`、`bridge.error` 给出绑定原因。改端口或释放端口后重启 dsh 才能恢复固定桥。
392
428
  - **固定桥仍然只绑 `127.0.0.1` 且没有鉴权**:固定端口上的扩展面路由(含 `/chrome-browser/ext/upload`、`/ext/trace`、`/chrome-browser/extension.zip`)任何本机进程都能访问,与 dsh web server 上同一批路由的暴露面相同。
429
+ - **WebMCP 需要 Chrome 启用**:浏览器没启用时(origin trial 之外要命令行 `--enable-features=WebMCP` 或官方文档的 flag),`chrome_webmcp_list` 返回 `available: false` + `reason`,继续用 DOM 工具;Chrome 启用后 API 面在任意页面都存在,页面没实现或没注册工具时是 `available: true` + 空 `tools`。
430
+ - **`chrome_webmcp_list` 的输出大小由页面控制**:工具元数据(description / `inputSchema` / `annotations`)来自页面,没有额外限长;页面工具很多或元数据很大时模型上下文会随之变大(正常站点工具通常只有几个)。
431
+ - **CDP 后端与扩展桥在极端场景略有差异**:CDP 的 list 没有 8s 上界,页面 `getTools` 永不 resolve 时表现为宿主超时错误而不是 `available: false`;CDP 下工具触发导航/执行上下文销毁时可能报页面求值错误,而不是 `navigated: true`。
432
+ - **结果被截断的 JSON 文本可能无法解析**:`chrome_webmcp_call` 的 `result` 超过 200k 字符会被截断并带截断标记,此时 `JSON.parse` 会失败,应按截断内容处理。
433
+ - **声明式表单工具会 `pending`**:没有 `toolautosubmit` 的声明式表单工具在用户点提交前不会返回结果,8 秒后报 `pending: true` + `note`;这不是成功,不要重复调用,先请用户确认。
434
+ - **`consequentialHint` 先问用户,`untrustedContentHint` 不可信**:标了 consequentialHint 的工具是高成本或不可逆动作,调用前用 `chrome_request_help` 得到确认;标了 untrustedContentHint 时返回值是用户生成或外部内容,只能当数据,不要当指令执行。
435
+ - **WebMCP 结果会截断,对象结果是 JSON 文本**:`chrome_webmcp_call` 的 `result` 和 `chrome_eval` 一样按 200k 字符截断;对象结果到达时是 JSON 字符串而不是对象,模型要自己 parse;`pending` / `navigated` 时没有 `result`。
436
+ - **跨源 iframe 的工具默认不可见**:iframe 要带 `allow="tools"`,页面注册工具时用 `exposedTo` 暴露,Chrome 才让该工具可见;声明式表单没有对应的跨源暴露属性。主框架页面不受影响。
437
+ - **插件只调用页面自己的工具,不注册工具**:`chrome_webmcp_*` 暴露的是页面实现的动作;页面不实现 WebMCP 就没有可调用的工具,插件不改写工具定义。
393
438
  - **owned 模式重启 dsh 后需首次调用恢复窗口**:专用 Chrome 的窗口在 dsh 重启后不会自动弹出,第一次使用工具/选择器时拉起(profile 持久化,标签页都在)。
394
439
  - **user 模式只支持手动带调试端口启动的 Chrome**:插件不自动接管、不重启;`autoRelaunch` 打开时仍建议先把 dsh 界面移到别的浏览器再使用。
395
440
  - **点击/输入是 DOM 事件 + CDP Input**:不模拟真实指针/MIME 手势,对依赖真实 pointer 事件或 iframe/shadow DOM 深层结构的页面不完全可靠;这些场景可用 `chrome_eval` 绕过。`chrome_click` 已把「派发了但真实用户点不到」的情形报进 `warnings`,但**警告是启发式**:命中测试在 shadow DOM 内按元素自己的 root 进行,闭合 shadow root 与 iframe 内部无法判定。
@@ -2,7 +2,7 @@
2
2
  "manifest_version": 3,
3
3
  "name": "dsh Chrome Control",
4
4
  "description": "Lets the local dsh agent drive this Chrome: list tabs, read pages, click and type, run JS, capture screenshots, read console output. Talks to dsh on this machine only.",
5
- "version": "0.4.2",
5
+ "version": "0.5.0",
6
6
  "permissions": [
7
7
  "tabs",
8
8
  "scripting",
@@ -98,7 +98,7 @@ chrome.runtime.onInstalled.addListener(() => connect())
98
98
  const SUPPORTED_OPS = [
99
99
  'list-tabs', 'read', 'inventory', 'wait', 'hover', 'press', 'select', 'eval',
100
100
  'click', 'type', 'console-start', 'console-stop', 'close', 'navigate', 'open',
101
- 'screenshot', 'trace', 'reload',
101
+ 'screenshot', 'trace', 'reload', 'webmcp-list', 'webmcp-call',
102
102
  ]
103
103
 
104
104
  /**
@@ -112,7 +112,7 @@ const SUPPORTED_OPS = [
112
112
  * user stayed on a stale extension with nothing to show for it. Only a value
113
113
  * carried by the loaded code can tell the host which code is loaded.
114
114
  */
115
- const BUILD_HASH = '65be701f5531310569fcb63cc5742009504abac3a41227bd89337ae723bf81df'
115
+ const BUILD_HASH = '6d025c12bba2e73376b264ef911282489baadba72c42e29cb419a5ec7ccdd407'
116
116
 
117
117
  /** Introduce this worker: what it runs, what it can answer, and which code it is. */
118
118
  async function hello() {
@@ -422,6 +422,16 @@ async function run(command) {
422
422
  return pageExec(command.args.tabId, selectOption, [command.args.selector, command.args.value])
423
423
  case 'eval':
424
424
  return evalInPage(command.args.tabId, command.args.expression)
425
+ case 'webmcp-list':
426
+ // WebMCP lives on `document.modelContext` in the page's MAIN world: it is
427
+ // page JavaScript, so the extension's isolated world cannot see it.
428
+ return webmcpRequest(command.args.tabId, { mode: 'list' })
429
+ case 'webmcp-call':
430
+ return webmcpRequest(command.args.tabId, {
431
+ mode: 'call',
432
+ name: command.args.name,
433
+ input: command.args.input || {},
434
+ })
425
435
  case 'click':
426
436
  return pageExec(command.args.tabId, pageAgent, [
427
437
  { op: 'click', selector: command.args.selector, all: command.args.all === true },
@@ -837,6 +847,132 @@ function readPage(includeHtml) {
837
847
  }
838
848
  }
839
849
 
850
+ /**
851
+ * Begin one WebMCP request in the page's MAIN world.
852
+ *
853
+ * `document.modelContext` is page JavaScript: the extension's isolated world has
854
+ * a separate `document` and cannot see it. The async APIs cannot be awaited by
855
+ * `chrome.scripting.executeScript` here (the returned promise is serialized, not
856
+ * awaited), so the request stores its state on the page and the service worker
857
+ * polls it with {@link webmcpPoll}.
858
+ *
859
+ * A missing modelContext is an ANSWER, not an error: the browser flag or origin
860
+ * trial is off, or the page implements no WebMCP, and the model needs to know
861
+ * which before falling back to DOM automation.
862
+ */
863
+ function webmcpBegin(request) {
864
+ const state = { done: false }
865
+ window.__dshWebmcp = state
866
+ const reason = 'document.modelContext 不存在:Chrome 未启用 WebMCP(需 --enable-features=WebMCP 或站点在 origin trial 中),或该页面未实现 WebMCP。'
867
+ const fail = (error) => {
868
+ const message = String((error && error.message) || error)
869
+ if (request.mode === 'call') Object.assign(state, { done: true, __dshWebmcp: 1, ok: false, error: message })
870
+ else Object.assign(state, { done: true, __dshWebmcp: 1, available: false, reason: message })
871
+ }
872
+ try {
873
+ const mc = typeof document === 'object' && document !== null ? document.modelContext : undefined
874
+ if (request.mode === 'call') {
875
+ if (mc === undefined || mc === null || typeof mc.executeTool !== 'function' || typeof mc.getTools !== 'function') {
876
+ Object.assign(state, { done: true, __dshWebmcp: 1, ok: false, error: reason })
877
+ return true
878
+ }
879
+ Promise.resolve(mc.getTools())
880
+ .then((tools) => {
881
+ const tool = tools.find(candidate => candidate.name === request.name)
882
+ if (tool === undefined) {
883
+ const available = tools.map(candidate => candidate.name)
884
+ throw new Error(available.length === 0
885
+ ? '当前页面没有注册任何 WebMCP 工具'
886
+ : '当前页面没有名为 "' + request.name + '" 的 WebMCP 工具;可用: ' + available.join(', '))
887
+ }
888
+ return mc.executeTool(tool, request.input || {})
889
+ })
890
+ .then((result) => {
891
+ if (result === null || result === undefined) {
892
+ Object.assign(state, { done: true, __dshWebmcp: 1, ok: true, tool: request.name, navigated: true })
893
+ return
894
+ }
895
+ Object.assign(state, { done: true, __dshWebmcp: 1, ok: true, tool: request.name, result })
896
+ })
897
+ .catch(fail)
898
+ return true
899
+ }
900
+ if (mc === undefined || mc === null || typeof mc.getTools !== 'function') {
901
+ Object.assign(state, { done: true, __dshWebmcp: 1, available: false, reason })
902
+ return true
903
+ }
904
+ Promise.resolve(mc.getTools())
905
+ .then((tools) => {
906
+ Object.assign(state, {
907
+ done: true,
908
+ __dshWebmcp: 1,
909
+ available: true,
910
+ tools: tools.map(tool => ({
911
+ name: tool.name,
912
+ title: tool.title || '',
913
+ description: tool.description || '',
914
+ origin: tool.origin || location.origin,
915
+ inputSchema: tool.inputSchema === undefined ? null : tool.inputSchema,
916
+ annotations: tool.annotations || {},
917
+ })),
918
+ })
919
+ })
920
+ .catch(fail)
921
+ return true
922
+ } catch (error) {
923
+ fail(error)
924
+ return true
925
+ }
926
+ }
927
+
928
+ /** Read the WebMCP request state the page stored; null before/after a navigation. */
929
+ function webmcpPoll() {
930
+ return window.__dshWebmcp || null
931
+ }
932
+
933
+ /**
934
+ * Drive one WebMCP request: start it in the page, then poll the state it stored.
935
+ *
936
+ * A declarative form tool without `toolautosubmit` never settles until the user
937
+ * clicks Submit, so an unfinished request is reported as `pending` rather than
938
+ * as success or as a timeout.
939
+ */
940
+ async function webmcpRequest(tabId, request) {
941
+ const before = await chrome.tabs.get(Number(tabId)).catch(() => null)
942
+ await pageExec(tabId, webmcpBegin, [request])
943
+ const deadline = Date.now() + 8000
944
+ while (Date.now() < deadline) {
945
+ const state = await pageExec(tabId, webmcpPoll)
946
+ if (state !== null && state !== undefined && state.done === true) {
947
+ const value = Object.assign({}, state)
948
+ delete value.done
949
+ return value
950
+ }
951
+ await new Promise(resolve => setTimeout(resolve, 100))
952
+ }
953
+ const after = await chrome.tabs.get(Number(tabId)).catch(() => null)
954
+ const navigated = before !== null && after !== null && before.url !== after.url
955
+ if (request.mode === 'list') {
956
+ return {
957
+ __dshWebmcp: 1,
958
+ available: false,
959
+ reason: navigated ? '读取 WebMCP 工具期间页面发生了导航' : '读取 WebMCP 工具超时(8s)',
960
+ }
961
+ }
962
+ // A tool that navigated the tab may have destroyed the state before a poll
963
+ // could read it; the URL change is the only remaining evidence.
964
+ if (navigated) {
965
+ return { __dshWebmcp: 1, ok: true, tool: request.name || '', navigated: true }
966
+ }
967
+ return {
968
+ __dshWebmcp: 1,
969
+ ok: true,
970
+ tool: request.name,
971
+ pending: true,
972
+ note: '工具已激活,但 8 秒内没有返回结果:声明式表单通常需要用户在页面上点提交。不要重复调用,先请用户确认。',
973
+ }
974
+ }
975
+
840
976
  /**
841
977
  * Evaluate one expression and report the outcome as data.
842
978
  *
package/lib/backend.d.ts CHANGED
@@ -116,6 +116,55 @@ export interface SelectOutcome {
116
116
  /** Why the control could not be selected, when it is not a `<select>`. */
117
117
  reason?: string;
118
118
  }
119
+ /** One tool a page declares through WebMCP. */
120
+ export interface WebMcpTool {
121
+ name: string;
122
+ title: string;
123
+ description: string;
124
+ origin: string;
125
+ /** JSON Schema of the tool's input, or null when the page declares none. */
126
+ inputSchema: unknown;
127
+ /** Safety hints the page attached: readOnlyHint, consequentialHint, untrustedContentHint, debugging. */
128
+ annotations: Record<string, unknown>;
129
+ }
130
+ /** What one tab's WebMCP surface looks like. */
131
+ export interface WebMcpTools {
132
+ /** Whether the browser and page expose a WebMCP surface at all. */
133
+ available: boolean;
134
+ /** Why there is no surface, or why listing failed. */
135
+ reason?: string;
136
+ tools: WebMcpTool[];
137
+ }
138
+ /** One WebMCP tool invocation. */
139
+ export interface WebMcpCallOutcome {
140
+ /** Tool name the page executed. */
141
+ tool: string;
142
+ /** The tool's return value; absent when `navigated` or `pending` is set. */
143
+ result?: unknown;
144
+ /** The tool caused a navigation, so the page context changed. */
145
+ navigated?: boolean;
146
+ /**
147
+ * The tool was activated but had not settled when the call returned — a
148
+ * declarative form tool usually waits for the user to click Submit.
149
+ */
150
+ pending?: boolean;
151
+ /** What the user still needs to do when `pending` is set. */
152
+ note?: string;
153
+ }
154
+ /**
155
+ * Map a WebMCP listing envelope from either backend onto {@link WebMcpTools}.
156
+ * @param value - the `__dshWebmcp` envelope.
157
+ * @returns the listing, with unreadable rows dropped.
158
+ */
159
+ export declare function mapWebMcpTools(value: unknown): WebMcpTools;
160
+ /**
161
+ * Map a WebMCP invocation envelope from either backend onto
162
+ * {@link WebMcpCallOutcome}; a page-reported failure becomes a thrown error so
163
+ * the model sees the reason and can pick another tool.
164
+ * @param value - the `__dshWebmcp` envelope.
165
+ * @returns the outcome.
166
+ */
167
+ export declare function mapWebMcpCall(value: unknown): WebMcpCallOutcome;
119
168
  /** What one hover did. */
120
169
  export interface HoverOutcome {
121
170
  /** Elements the selector matched. */
@@ -149,6 +198,18 @@ export interface BrowserBackend {
149
198
  * first evaluation, and on backends that have only the one route.
150
199
  */
151
200
  readonly lastEvalWorld: 'main' | 'debugger' | undefined;
201
+ /**
202
+ * Tools the page declares through WebMCP. `available: false` means the browser
203
+ * exposes no WebMCP surface (flag or origin trial off) or the page implements
204
+ * none — an answer, not an error, so the caller can fall back to DOM automation.
205
+ */
206
+ webmcpTools(tabId: string): Promise<WebMcpTools>;
207
+ /**
208
+ * Execute one page-declared WebMCP tool. `pending` means the page activated it
209
+ * but had not settled when the call returned (a declarative form waiting for
210
+ * the user), not that it succeeded.
211
+ */
212
+ webmcpCall(tabId: string, name: string, input: Record<string, unknown>): Promise<WebMcpCallOutcome>;
152
213
  click(tabId: string, selector: string, all: boolean): Promise<ClickOutcome>;
153
214
  /** Dispatch hover input on the first element matching the selector. */
154
215
  hover(tabId: string, selector: string): Promise<HoverOutcome>;
@@ -274,6 +335,8 @@ export declare class ExtensionBackend implements BrowserBackend {
274
335
  navigate(tabId: string, url: string, waitLoad: boolean, waitLoadMs: number): Promise<void>;
275
336
  waitForLoad(tabId: string, waitLoadMs: number): Promise<void>;
276
337
  evaluate(tabId: string, expression: string): Promise<unknown>;
338
+ webmcpTools(tabId: string): Promise<WebMcpTools>;
339
+ webmcpCall(tabId: string, name: string, input: Record<string, unknown>): Promise<WebMcpCallOutcome>;
277
340
  click(tabId: string, selector: string, all: boolean): Promise<ClickOutcome>;
278
341
  hover(tabId: string, selector: string): Promise<HoverOutcome>;
279
342
  press(tabId: string, key: string, selector?: string): Promise<PressOutcome>;
@@ -354,6 +417,8 @@ export declare class CdpBackend implements BrowserBackend {
354
417
  navigate(tabId: string, url: string, waitLoad: boolean, waitLoadMs: number): Promise<void>;
355
418
  waitForLoad(tabId: string, waitLoadMs: number): Promise<void>;
356
419
  evaluate(tabId: string, expression: string): Promise<unknown>;
420
+ webmcpTools(tabId: string): Promise<WebMcpTools>;
421
+ webmcpCall(tabId: string, name: string, input: Record<string, unknown>): Promise<WebMcpCallOutcome>;
357
422
  click(tabId: string, selector: string, all: boolean): Promise<ClickOutcome>;
358
423
  hover(tabId: string, selector: string): Promise<HoverOutcome>;
359
424
  press(tabId: string, key: string, selector?: string): Promise<PressOutcome>;
@@ -1 +1 @@
1
- {"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"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"}
package/lib/backend.js CHANGED
@@ -9,7 +9,7 @@
9
9
  * @module @liyuera/dsh-chrome-browser/backend
10
10
  */
11
11
  import { consoleMessageFrom } from "./console-events.js";
12
- import { clickExpression, focusAndSelectExpression, focusExpression, hoverExpression, inventoryExpression, pressExpression, readPageExpression, readyStateExpression, selectExpression, waitExpression, } from "./expressions.js";
12
+ import { clickExpression, focusAndSelectExpression, focusExpression, hoverExpression, inventoryExpression, pressExpression, readPageExpression, readyStateExpression, selectExpression, waitExpression, webmcpCallExpression, webmcpListExpression, } from "./expressions.js";
13
13
  import { Chrome } from "./chrome.js";
14
14
  import { WsConnection, wsHandshake } from "./ws.js";
15
15
  import { pageSizeExpression, rectExpression } from "./expressions.js";
@@ -22,6 +22,72 @@ import { extensionStamp, extensionVersion } from "./extension-package.js";
22
22
  * scale, so the aspect ratio stays the page's.
23
23
  */
24
24
  const MAX_CAPTURE_PX = 16_000;
25
+ /** Read one untrusted value as a plain record, or undefined. */
26
+ function recordOf(value) {
27
+ return typeof value === 'object' && value !== null && !Array.isArray(value)
28
+ ? value
29
+ : undefined;
30
+ }
31
+ /**
32
+ * Map a WebMCP listing envelope from either backend onto {@link WebMcpTools}.
33
+ * @param value - the `__dshWebmcp` envelope.
34
+ * @returns the listing, with unreadable rows dropped.
35
+ */
36
+ export function mapWebMcpTools(value) {
37
+ const envelope = recordOf(value);
38
+ if (envelope === undefined || envelope.__dshWebmcp !== 1)
39
+ throw new Error('WebMCP 列表应答格式无法识别');
40
+ if (envelope.available !== true) {
41
+ return {
42
+ available: false,
43
+ reason: typeof envelope.reason === 'string' && envelope.reason !== '' ? envelope.reason : '该页面没有可用的 WebMCP 工具',
44
+ tools: [],
45
+ };
46
+ }
47
+ const rows = Array.isArray(envelope.tools) ? envelope.tools : [];
48
+ return {
49
+ available: true,
50
+ tools: rows.flatMap((row) => {
51
+ const tool = recordOf(row);
52
+ if (tool === undefined || typeof tool.name !== 'string' || tool.name === '')
53
+ return [];
54
+ return [{
55
+ name: tool.name,
56
+ title: typeof tool.title === 'string' ? tool.title : '',
57
+ description: typeof tool.description === 'string' ? tool.description : '',
58
+ origin: typeof tool.origin === 'string' ? tool.origin : '',
59
+ inputSchema: tool.inputSchema === undefined ? null : tool.inputSchema,
60
+ annotations: recordOf(tool.annotations) ?? {},
61
+ }];
62
+ }),
63
+ };
64
+ }
65
+ /**
66
+ * Map a WebMCP invocation envelope from either backend onto
67
+ * {@link WebMcpCallOutcome}; a page-reported failure becomes a thrown error so
68
+ * the model sees the reason and can pick another tool.
69
+ * @param value - the `__dshWebmcp` envelope.
70
+ * @returns the outcome.
71
+ */
72
+ export function mapWebMcpCall(value) {
73
+ const envelope = recordOf(value);
74
+ if (envelope === undefined || envelope.__dshWebmcp !== 1)
75
+ throw new Error('WebMCP 调用应答格式无法识别');
76
+ if (envelope.ok !== true) {
77
+ throw new Error(typeof envelope.error === 'string' && envelope.error !== '' ? envelope.error : 'WebMCP 工具调用失败');
78
+ }
79
+ const tool = typeof envelope.tool === 'string' ? envelope.tool : '';
80
+ if (envelope.pending === true) {
81
+ return {
82
+ tool,
83
+ pending: true,
84
+ ...(typeof envelope.note === 'string' && envelope.note !== '' ? { note: envelope.note } : {}),
85
+ };
86
+ }
87
+ if (envelope.navigated === true)
88
+ return { tool, navigated: true };
89
+ return { tool, result: envelope.result };
90
+ }
25
91
  /** Shared sleep. */
26
92
  const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));
27
93
  /** Map one extension tab row to the backend face. */
@@ -215,7 +281,7 @@ export class ExtensionBackend {
215
281
  * how a restarted service worker gets its capture back.
216
282
  */
217
283
  static SAFE_RETRY_OPS = new Set([
218
- 'list-tabs', 'read', 'eval', 'screenshot', 'console-start', 'console-stop',
284
+ 'list-tabs', 'read', 'eval', 'screenshot', 'console-start', 'console-stop', 'webmcp-list',
219
285
  ]);
220
286
  /**
221
287
  * In-flight dedupe keys for side-effectful ops: a second identical command
@@ -413,6 +479,14 @@ export class ExtensionBackend {
413
479
  this.lastEvalWorld = envelope.world === 'debugger' ? 'debugger' : 'main';
414
480
  return envelope.value;
415
481
  }
482
+ async webmcpTools(tabId) {
483
+ return mapWebMcpTools(await this.push('webmcp-list', { tabId }));
484
+ }
485
+ async webmcpCall(tabId, name, input) {
486
+ // Arguments are sent as one object: the page's `executeTool(tool, input)`
487
+ // takes a single JSON-serializable value, never a spread argument list.
488
+ return mapWebMcpCall(await this.push('webmcp-call', { tabId, name, input }));
489
+ }
416
490
  async click(tabId, selector, all) {
417
491
  return mapClickOutcome(await this.push('click', { tabId, selector, all }));
418
492
  }
@@ -732,6 +806,14 @@ export class CdpBackend {
732
806
  this.lastEvalWorld = 'main';
733
807
  return this.withTab(tabId, endpoint => this.evaluatePage(endpoint, expression));
734
808
  }
809
+ async webmcpTools(tabId) {
810
+ // Runtime.evaluate runs in the page's main world and awaits the expression's
811
+ // promise, so the WebMCP surface is reachable without an extension.
812
+ return mapWebMcpTools(await this.withTab(tabId, endpoint => this.evaluatePage(endpoint, webmcpListExpression())));
813
+ }
814
+ async webmcpCall(tabId, name, input) {
815
+ return mapWebMcpCall(await this.withTab(tabId, endpoint => this.evaluatePage(endpoint, webmcpCallExpression(name, input))));
816
+ }
735
817
  async click(tabId, selector, all) {
736
818
  return this.withTab(tabId, async (endpoint) => (mapClickOutcome(await this.evaluatePage(endpoint, clickExpression(selector, all)))));
737
819
  }