feat(browser): complete camofox BrowserProvider with tabs, interaction, download capture and control lease

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]>

packages/adapters/src/browser/camofox/capabilities.ts

@@ -18,30 +18,34 @@ export const CAMOFOX_ENDPOINTS: Record<BrowserCapabilityKey, readonly string[]>
   interact: ["post /tabs/{tabId}/click", "post /tabs/{tabId}/type", "post /tabs/{tabId}/select"],
   extract: ["post /tabs/{tabId}/extract"],
   downloadCapture: ["get /tabs/{tabId}/downloads"],
-  // 上游 OpenAPI 无接管端点;VNC 插件(ENABLE_VNC,noVNC 独立端口)是整块虚拟显示,需原型验证
-  takeover: [],
+  // 原站视图接管 = 同一会话的定时截图 + 点击/输入映射(不另起浏览器);VNC 插件未接入
+  takeover: ["get /tabs/{tabId}/screenshot", "post /tabs/{tabId}/click", "post /tabs/{tabId}/type"],
   // 持久化插件默认开启,无需端点;storage_state 端点属插件,不在 OpenAPI 中
   persistentProfile: [],
 };
 
-/** 适配器已实现的能力;其余上游虽有端点,适配器在 M2 实现 */
+/** 适配器已实现的能力(C1-E 起全部实现;是否可用仍取决于 verified) */
 const ADAPTER_IMPLEMENTED: ReadonlySet<BrowserCapabilityKey> = new Set([
   "sessions",
   "tabs",
   "navigate",
   "snapshot",
   "screenshot",
+  "interact",
+  "extract",
+  "downloadCapture",
+  "takeover",
   "persistentProfile",
 ]);
 
 const STATIC_NOTES: Partial<Record<BrowserCapabilityKey, string>> = {
-  sessions: "上游无显式建会话端点:userId 即会话(BrowserContext),首个 POST /tabs 隐式创建;关闭会话适配器 M2",
-  tabs: "仅建首个标签页;列举/关闭适配器 M2",
+  sessions: "上游无显式建会话端点:userId 即会话(BrowserContext),首个 POST /tabs 隐式创建;会话以数据库为准",
+  tabs: "新建/关闭/对账(GET /tabs?userId,上游回收的标 lost)",
   snapshot: "可访问性树文本 + eN 元素引用,支持 offset 分页",
-  interact: "上游有 click/type/select;适配器 M2",
-  extract: "上游 POST /extract 需先 snapshot 建 ref 表(x-ref);适配器 M2",
-  downloadCapture: "上游 GET /downloads 支持 includeData/consume/maxBytes;适配器 M2",
-  takeover: "上游无接管 API;VNC 插件画面/输入与同会话连续操作待原型验证",
+  interact: "click/type/select + scroll/press(后两者不在 1.17.0 OpenAPI,待核验);坐标点击待核验",
+  extract: "POST /extract 需先 snapshot 建 ref 表(x-ref)",
+  downloadCapture: "GET /downloads?includeData&consume&maxBytes(README;字段形状待核验)",
+  takeover: "原站视图:同一会话定时截图 + 输入映射;坐标点击与无目标输入待核验,VNC 未接入",
   persistentProfile: "上游持久化插件默认保存 cookies+localStorage(~/.camofox/profiles),重启恢复待验证",
 };