rootandClaude Opus 5.5
c17d4b90bd
Contracts for browser API and browser.* agent capabilities; adapter implements close/list/restore sessions, tabs + reconcile, history, click/type/select/scroll/press, extract, waitForDownload (staged via DownloadSink, sha256), stale-ref guard and automation/human actor check. testkit mock camofox gains an interactive site (login redirect, captcha, click-driven page changes, downloads, PNG screenshots). Co-Authored-By: Claude Opus 5.5 <[email protected]>
2.5 KiB
2.5 KiB
browser
BrowserProvider 合同(provider.ts)及其实现:业务侧访问浏览器服务只走这套接口。产品浏览器能力对接用户已有的 camofox-browser;Playwright 只用于前端截图测试,不是产品浏览器能力。设计说明见 docs/design/browser-provider.md。
camofox/:camofox-browser 适配器。按 jo-inc/camofox-browser masteropenapi.json(1.17.0)与 README 实现,Authorization: Bearer <CAMOFOX_ACCESS_KEY>,凭据每次请求经BrowserSecretResolver解出,不缓存、不入日志。camofoxuserId= 本项目profileKey(站点/账号隔离),sessionKey=browser_session.id。none.ts:默认实现(未配置浏览器),能力全关,动作报unavailable。redact.ts:redactSnapshot/redactBrowserUrl,快照与地址进入模型前遮蔽密码框值、Cookie 值、含 passkey/token 的 URL。profile-lock.ts:同一 profile 串行锁(进程内内存实现;多进程部署换持久化实现,接口不变)。budget.ts:导航域名白名单(含子域),非 http(s) 拒绝。
已实现(C1-E,仅对 mock 与上游文档验证)
- 会话:
openSession(POST /tabs)、closeSession(DELETE /sessions/{userId})、listSessions(内存镜像;服务层以数据库为准)、restoreSession(重启后按 DB 恢复,旧引用失效)。 - 标签页:
openTab、closeTab(DELETE /tabs/{id})、reconcileTabs(GET /tabs?userId,上游已回收的标lost)。 - 导航:
navigate(白名单 / 超时 / 预算内重试 5xx·超时·网络)、history(/back/forward/refresh)。 - 读取:
snapshot(字节预算截断 + 脱敏)、screenshot(JSON base64 或 image/*;登录页 / 含凭据地址modelSafe: false)、extract(POST /extract,需先快照)。 - 交互:
click(ref / selector / 视口坐标)、type(明文或凭证引用,凭证经BrowserSecretResolver解出后直接下发)、select、scroll、press。 - 下载:
waitForDownload轮询GET /tabs/{id}/downloads?includeData&consume&maxBytes,字节交DownloadSink暂存、算 sha256,只返回引用。 - 控制权:
TabRef.as标明发起方(automation / human),与会话 controller 不符报control_conflict;setController任何变更都让旧eN引用失效(stale_ref);acquireControl/releaseControl为内存版,服务层用browser_control_lease持久化。
未核验的上游行为(坐标点击、无目标输入、scroll / press / back 等端点、downloads 字段形状)见 docs/runbook/browser.md 第 6 节。