@mearl/client 2.22.2 → 2.22.4

package/README.md

@@ -162,6 +162,8 @@ mearl browser_release --session '<sessionId>' --payload '{"closeCreatedTabs":tru
 
 用户在 Popup 的浏览器管理页接管、交还或结束会话。交接后排队旧请求和批次后续步骤停止；已派发动作可能仍然生效。交还后重新取快照。CDP-only 环境可在用户明确确认后用同一 `browser_control` 的 `operation:"resume"` 交还，无需额外 action。会话跨 CLI 连接保留，宿主进程退出后失效；不会根据空闲时间清理用户正在操作的会话。
 
+扩展中新开的后台页面默认加入折叠的 `Mearl` 标签组，前台新页进入展开的 `Mearl · 待操作` 组。两个管理组统一复用同一个已有窗口，同名管理组会合并；页面打开的后续标签也收进该窗口，并继承源组的展开状态。工作窗口关闭后重新选择已有窗口，不额外创建窗口。显式传入 `tab_open.group` 时使用指定分组；复用普通页面时保留原窗口和分组。接管会话只把管理组内的会话页面移入待操作组；交还后，仍在待操作组内的会话页面收回 `Mearl` 组。用户正在查看组内其他页面，或窗口没有其他可显示页面时，保留展开状态。
+
 带 Session 的释放只影响该会话，默认保留页面及环境；`closeCreatedTabs` 只关闭新建页，`keepTabIds` 保留结果页，复用的用户页面始终保留。`preserveEnvironment:false` 清理这些页面的环境。活动会话存在时，浏览器级释放与关闭会被拒绝。
 
 `page_download` 先监听再点击，返回浏览器文件产物；CLI `--output` 或 SDK `saveArtifact(artifact, absolutePath, { session })` 以 256 KiB 分块导出到调用方。`page_upload.files` 接受调用方绝对路径 `{filePath}` 或浏览器 `{artifactId}`，`filePaths` 仍指浏览器宿主路径。单文件最多 256 MiB；保存到调用方的结果独立于临时产物。会话释放清理临时产物，`keepArtifactIds` 可保留指定产物；无会话产物空闲一小时回收，宿主退出清理暂存。
@@ -221,7 +223,7 @@ stdout 在管道或重定向时默认输出紧凑 JSON，在交互终端默认
 需要同时读取全文时显式传 `includeBody:true`。省略正文时不返回 `postData` / `responseBody` 字段；
 未指定字段时默认返回正文。
 
-`send_request` 默认携带所选浏览器中匹配完整目标 URL 的未分区 Cookie，保留不同路径下的同名 Cookie；不额外拼入父站点的 host-only Cookie，也不猜测页面的 Cookie 分区。需要页面分区、页面签名或完整页面身份时，使用目标页面中的 `page_eval` 请求。
+`send_request` 默认携带所选浏览器中匹配完整目标 URL 的普通 Cookie，以及目标 URL 第一方站点对应的 CHIPS Cookie。例如 `https://fbi.alibaba-inc.com/` 使用 `https://alibaba-inc.com` 分区，不依赖已打开页面。站点按协议和公共后缀列表（含私有后缀）确定；排除其他站点、其他协议、跨站祖先及不透明分区。保留不同路径下的同名 Cookie，不额外拼入父站点的 host-only Cookie。嵌入其他站点的第三方分区、页面签名或完整页面身份仍需使用目标页面中的 `page_eval` 请求。
 响应中的 `Set-Cookie` 会更新原浏览器，后续调用可以使用刷新后的登录态；`withCookies:false` 同时关闭自动携带与响应回写。扩展由 Chrome 处理响应 Cookie；CDP 的 Node 请求在返回前通过原页面的浏览器连接回写，支持 HttpOnly、默认路径、过期时间和删除。CDP 响应存在 `Set-Cookie` 时附带 `cookieSync: { updatedCount, rejectedCount, failedCount }`，不返回 Cookie 值；无法确定分区的 Partitioned 响应 Cookie 计入拒绝数。同步失败不撤销已完成的 HTTP 操作，应检查状态而非直接重发业务请求。MTop 普通请求及流式请求使用相同的响应刷新机制。
 扩展的临时凭据注入仅匹配原始完整请求 URL，重定向由 Chrome 按新 URL 选择 Cookie。CDP 的 Node 请求（含 MTop 流式请求）不自动跟随重定向，避免将原 URL 的 Cookie 或签名传到其他地址。
 

package/dist/generated/plugin-host-build.d.ts

@@ -1 +1 @@
-export declare const PLUGIN_HOST_BUILD_ID = "e5c7f6cfb7a597a523293c0ea2929b4970aa9eb86e7aeb672f85a37c317bc258";
+export declare const PLUGIN_HOST_BUILD_ID = "83323695c8ac2e39755494d27cb70be47d162c502111d32a1fc6d6be71981f18";

package/dist/generated/plugin-host-build.js

@@ -1,2 +1,2 @@
 // Generated by scripts/generate-plugin-host-build.mjs.
-export const PLUGIN_HOST_BUILD_ID = 'e5c7f6cfb7a597a523293c0ea2929b4970aa9eb86e7aeb672f85a37c317bc258';
+export const PLUGIN_HOST_BUILD_ID = '83323695c8ac2e39755494d27cb70be47d162c502111d32a1fc6d6be71981f18';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/client",
-  "version": "2.22.2",
+  "version": "2.22.4",
   "description": "Unified Mearl SDK & CLI for local and remote browsers",
   "type": "module",
   "main": "dist/index.js",
@@ -67,10 +67,10 @@
     "commander": "^15.0.0",
     "fastest-levenshtein": "^1.0.16",
     "ws": "^8.18.0",
-    "@mearl/cloud-types": "2.22.2",
-    "@mearl/provider": "2.22.2",
-    "@mearl/agent-runtime": "2.22.2",
-    "@mearl/daemon-core": "2.22.2"
+    "@mearl/daemon-core": "2.22.4",
+    "@mearl/agent-runtime": "2.22.4",
+    "@mearl/cloud-types": "2.22.4",
+    "@mearl/provider": "2.22.4"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",