@attson/atwebpilot-mcp 0.0.72 → 0.0.74

package/README.md

@@ -49,7 +49,7 @@ listen 端口的能力，所以方向只能如此。这也是配对页存在的
 ## 工具面
 
 - 控制面 4 个：`list_tabs / open_session / close_session / get_quota`
-- 发现 1 个：`browser_discoverTools` —— 不带参数返回未发布工具目录（按 `export / network / storage / browser-data / inspect / legacy-dom / form / tabs` 分组）；带 `enable: [...]` 把它们加进本进程的 `tools/list`（发送 `tools/list_changed`），并直接返回完整 schema。
+- 发现 1 个：`browser_discoverTools` —— 已知工具时直接传 `enable: [...]`，已知分组时直接传 `enableGroups: ["export", ...]`；只有两者都未知时才不带参数读取目录。启用后会加入本进程的 `tools/list`（发送 `tools/list_changed`），并直接返回完整 schema。
 - 执行面默认 **core 31 个** `browser_*`：浏览 / 采集 / 填表 / 导航 / 截图 闭环所需的工具。其余 20 个由 AI 按需 `discoverTools` 拉取，用户不用配置。
 - 不暴露 `askUser`（MCP 会话没有人在侧边栏应答）和 `attachTab` / `detachTab`（目标 tab 已由 `open_session` 绑定）。
 
@@ -70,6 +70,20 @@ hover / uploadFile / scroll / waitFor`）；`browser_storage` 也不会列出，
 
 无法识别的值（包括已移除的 `parity`）按 `core` 处理，并往 stderr 打一条提示。
 
+## 本地会话效率分析
+
+在仓库根目录运行：
+
+```bash
+pnpm analyze:sessions
+pnpm analyze:sessions -- --since 7d --clients claude --format json
+```
+
+分析器只读扫描 `~/.claude/projects` 与 `~/.codex/sessions` 中最近 30 天的
+JSONL，识别真实 AtWebPilot 工具调用及重复验证、固定等待、重复截图、可批量填表等
+模式。输出只包含聚合计数、参数字段名与不可逆指纹；不会输出或保存 prompt、参数值、
+工具结果正文、凭证或绝对会话路径。使用 `--help` 查看目录覆盖等选项。
+
 ### 从 0.0.70 及更早版本迁移
 
 | 旧 | 新 |

package/dist/index.js

@@ -895,7 +895,9 @@ var Coordinator = class {
     return session;
   }
   closeSession(id) {
+    const session = this.sessions.get(id);
     this.sessions.close(id);
+    if (session) this.notifySessionClosed(session);
   }
   // === Tool calls ===
   validateCall(input) {
@@ -920,8 +922,22 @@ var Coordinator = class {
   // === Periodic housekeeping ===
   tick() {
     const expired_sessions = this.sessions.tick();
+    for (const id of expired_sessions) {
+      const session = this.sessions.get(id);
+      if (session) this.notifySessionClosed(session);
+    }
     return { expired_sessions };
   }
+  notifySessionClosed(session) {
+    void this.hub.send(session.worker_id, {
+      type: "CLOSE_SESSION",
+      nonce: this.idGen.next("nonce"),
+      ts: this.clock.now(),
+      protocol_version: PROTOCOL_VERSION,
+      session_id: session.id
+    }).catch(() => {
+    });
+  }
 };
 
 // src/mcp-server.ts
@@ -1830,7 +1846,7 @@ var TOOL_DEFS = [
   {
     name: "resize",
     description: "[FLOW] \u628A\u89C6\u53E3\u8C03\u6574\u5230\u6307\u5B9A\u5C3A\u5BF8\u3002main-world \u6863\u91CF\u53D6 outerWidth-innerWidth \u53CD\u63A8\u6D4F\u89C8\u5668\u8FB9\u6846\u540E\u6539\u7A97\u53E3\u5916\u6846\uFF0C\u89C6\u53E3\u7CBE\u786E\u4F46**\u7528\u6237\u7684\u7A97\u53E3\u4F1A\u771F\u7684\u53D8\u5927\u5C0F**\uFF1Bcdp \u6863\u7528 Emulation \u8986\u76D6\u8BBE\u5907\u5C3A\u5BF8\uFF0C\u4E0D\u52A8\u771F\u5B9E\u7A97\u53E3\u3002",
-    mcp: { description: "Resize the viewport to width\xD7height." },
+    mcp: { description: "Resize the viewport to width\xD7height and return the measured actualViewport plus verified status. Do not re-measure with runJS." },
     input_schema: {
       type: "object",
       properties: {
@@ -2087,13 +2103,19 @@ function discoveryCatalog(all, advertised) {
 }
 
 // src/discover-tool.ts
+var DISCOVER_GROUPS = Object.keys(DISCOVERABLE_GROUPS);
 var DISCOVER_TOOL = {
   name: "browser_discoverTools",
-  description: "The default tool list is the core set. Call with no arguments to see the catalog of additional browser tools (export, network, storage, browser-data, inspect, legacy-dom, form). Call with enable=[names] to add them to tools/list for this server; the response includes their full schemas so you can call them immediately. Use this instead of rebuilding missing capabilities with runJS.",
+  description: "The default tool list is the core set. Enable known extras directly with enable=[names] or enableGroups=[groups]. Omit both only when you need the catalog. Groups: export, network, storage, browser-data, inspect, legacy-dom, form, tabs. Enabled tools join tools/list and the response includes their full schemas so you can call them immediately. Use this instead of rebuilding missing capabilities with runJS.",
   inputSchema: {
     type: "object",
     properties: {
-      enable: { type: "array", items: { type: "string" }, description: "Tool names from the catalog to advertise" }
+      enable: { type: "array", items: { type: "string" }, description: "Tool names from the catalog to advertise" },
+      enableGroups: {
+        type: "array",
+        items: { type: "string", enum: DISCOVER_GROUPS },
+        description: "Known groups to advertise directly, without a catalog round trip"
+      }
     },
     additionalProperties: false
   }
@@ -2104,23 +2126,36 @@ function isRunnable(t, supported) {
 function handleDiscover(input) {
   const { all, advertised, args, supported } = input;
   const byName = new Map(all.map((t) => [t.name, t]));
-  const requested = Array.isArray(args.enable) ? args.enable.map(String) : null;
-  if (!requested) {
+  const hasSelection = Array.isArray(args.enable) || Array.isArray(args.enableGroups);
+  if (!hasSelection) {
     const runnable = all.filter((t) => isRunnable(t, supported));
     return { catalog: discoveryCatalog(runnable, advertised), changed: false };
   }
+  const explicit = Array.isArray(args.enable) ? args.enable.map(String) : [];
+  const groups = Array.isArray(args.enableGroups) ? args.enableGroups.map(String) : [];
+  const unknownGroups = groups.filter((group) => !DISCOVER_GROUPS.includes(group));
+  const grouped = groups.flatMap(
+    (group) => DISCOVERABLE_GROUPS[group] ?? []
+  );
+  const requestedByName = /* @__PURE__ */ new Map();
+  for (const raw of explicit) {
+    const name = raw.startsWith("browser_") ? raw : `browser_${raw}`;
+    requestedByName.set(name, raw);
+  }
+  for (const name of grouped) {
+    if (!requestedByName.has(name)) requestedByName.set(name, name);
+  }
   const enabled = [];
   const unknown = [];
   const unsupported = [];
-  for (const raw of requested) {
-    const name = raw.startsWith("browser_") ? raw : `browser_${raw}`;
+  for (const [name, reportAs] of requestedByName) {
     const t = byName.get(name);
     if (!t) {
-      unknown.push(raw);
+      unknown.push(reportAs);
       continue;
     }
     if (!isRunnable(t, supported)) {
-      unsupported.push(raw);
+      unsupported.push(reportAs);
       continue;
     }
     if (advertised.has(name)) continue;
@@ -2130,6 +2165,7 @@ function handleDiscover(input) {
   return {
     enabled,
     ...unknown.length ? { unknown } : {},
+    ...unknownGroups.length ? { unknownGroups } : {},
     ...unsupported.length ? { unsupported } : {},
     changed: enabled.length > 0
   };
@@ -2434,7 +2470,12 @@ function toolResult(gen, data) {
   const d = data ?? {};
   if (typeof d.data !== "string") return ok(data);
   const mimeType = typeof d.media_type === "string" ? d.media_type : "image/png";
-  return { content: [{ type: "image", data: d.data, mimeType }] };
+  const { data: imageData, media_type: _mediaType, ...metadata } = d;
+  const content = [{ type: "image", data: imageData, mimeType }];
+  if (Object.keys(metadata).length > 0) {
+    content.push({ type: "text", text: JSON.stringify(metadata) });
+  }
+  return { content };
 }
 var fail2 = (message) => ({ content: [{ type: "text", text: message }], isError: true });
 async function dispatchCall(deps, name, args, onPairingRequired, state = DEFAULT_STATE, onListChanged) {
@@ -2986,6 +3027,7 @@ function processInfo(cwd = process.cwd()) {
 
 // src/ensure-hub.ts
 var DEFAULT_WORKER_WAIT_TIMEOUT_MS = 9e4;
+var SESSION_SWEEP_INTERVAL_MS = 3e4;
 function createHubEnsurer(d) {
   let bundle = null;
   let inflight = null;
@@ -2994,6 +3036,7 @@ function createHubEnsurer(d) {
   let opening = null;
   let hubIsClosed = false;
   let pendingDenial = false;
+  let sessionSweepTimer = null;
   let workerWait = null;
   const info = d.processInfo ?? processInfo();
   function connectedWorkerId(coordinator) {
@@ -3029,6 +3072,10 @@ function createHubEnsurer(d) {
   }
   function hubClosed() {
     hubIsClosed = true;
+    if (sessionSweepTimer) {
+      clearInterval(sessionSweepTimer);
+      sessionSweepTimer = null;
+    }
     if (workerWait) {
       finishWorkerWait({ error: new Error("\u6D4F\u89C8\u5668\u914D\u5BF9\u670D\u52A1\u5DF2\u5173\u95ED\u3002") });
     }
@@ -3057,6 +3104,8 @@ function createHubEnsurer(d) {
     }
     saveLastPort(port, d.identityDir);
     const coordinator = new Coordinator({ hub, clock: d.clock, idGen: d.idGen });
+    sessionSweepTimer = setInterval(() => coordinator.tick(), SESSION_SWEEP_INTERVAL_MS);
+    sessionSweepTimer.unref?.();
     installWire(hub, coordinator, d.clock, () => notifyWorkerReady(coordinator));
     pairUrlValue = `http://127.0.0.1:${port}/pair`;
     return { coordinator, hub, port };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attson/atwebpilot-mcp",
-  "version": "0.0.72",
+  "version": "0.0.74",
   "license": "Apache-2.0",
   "description": "MCP server for the atwebpilot browser extension - let Codex or Claude Code drive your browser.",
   "homepage": "https://github.com/attson/atwebpilot#readme",
@@ -27,7 +27,8 @@
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "build": "tsup",
-    "start": "tsx src/index.ts"
+    "start": "tsx src/index.ts",
+    "analyze:sessions": "tsx src/session-analysis/cli.ts"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",