ghost-bridge 1.1.0 → 1.2.0

package/README.md

@@ -16,6 +16,8 @@ Most browser-capable AI tools start a separate browser. Ghost Bridge connects AI
 - Inspect page structure, text, screenshots, errors, and network traffic
 - Search and extract script sources, even in production bundles
 - Click, type, scroll, and submit forms on the current page
+- Locate elements by role/name, label, placeholder, text, test ID, or CSS across open Shadow DOM and same-origin iframes
+- Run `locate → act → wait → snapshot` as one browser call instead of model-driven polling
 - Bind multiple Chrome tabs as named targets and operate them independently
 - Share one Chrome transport across multiple MCP clients
 
@@ -94,7 +96,7 @@ Typical prompts:
 | `capture_screenshot` | Visual inspection and UI debugging |
 | `get_page_content` | Text, HTML, and structured DOM extraction |
 | `get_interactive_snapshot` | Find clickable and editable elements |
-| `dispatch_action` | Click, fill, press, scroll, hover, or select; supports selector-based and batched actions |
+| `dispatch_action` | Locate, act, wait, and verify in one call; supports semantic locators and batches |
 | `eval_script` | Execute JavaScript, wait for returned promises, and cap arbitrary output |
 | `page_request` | Send an authenticated page-context request and wait for the response in one call |
 | `bind_tab` | Bind a Chrome tab as a named target such as `cases` or `app` |
@@ -115,12 +117,12 @@ Typical prompts:
 
 Recommended flow:
 
-1. Start with `inspect_page`; its compact response includes a small set of actionable refs
-2. Use `capture_screenshot` for visual issues
+1. When the target is describable, call `dispatch_action` directly with a semantic `locator`
+2. Use `inspect_page` when the page is unfamiliar or a locator is ambiguous; its compact response includes actionable refs
+3. Use `capture_screenshot` for visual issues
    Default is optimized for transfer with JPEG; switch to `png` for pixel-level checks
-3. Use `get_page_content` for DOM or text extraction
-4. Use `get_interactive_snapshot` only when the refs returned by `inspect_page` are insufficient
-5. Put consecutive fills/clicks into one `dispatch_action.actions` call and request `snapshotAfter` when the next page state is needed
+4. Use `get_page_content` for DOM or text extraction
+5. Put consecutive fills/clicks into one `dispatch_action.actions` call; add `waitFor` to the action that changes state and `snapshotAfter` when the resulting UI is needed
 
 Round-trip-efficient examples:
 
@@ -128,14 +130,42 @@ Round-trip-efficient examples:
 {
   "target": "app",
   "actions": [
-    { "selector": "input[name=email]", "action": "fill", "value": "user@example.com" },
-    { "selector": "input[name=password]", "action": "fill", "value": "secret" },
-    { "selector": "button[type=submit]", "action": "click", "waitMs": 1200 }
+    {
+      "locator": { "role": "textbox", "label": "Email" },
+      "action": "fill",
+      "value": "user@example.com"
+    },
+    {
+      "locator": { "role": "textbox", "label": "Password" },
+      "action": "fill",
+      "value": "secret"
+    },
+    {
+      "locator": { "role": "button", "name": "Sign in" },
+      "action": "click",
+      "waitFor": {
+        "type": "element",
+        "locator": { "text": "Signed in" },
+        "state": "visible",
+        "timeoutMs": 10000
+      }
+    }
   ],
   "snapshotAfter": true
 }
 ```
 
+Locator fields are `css`, `testId`, `role` + `name`, `label`, `placeholder`, `text`, `match`, and zero-based `nth`. Matching is exact by default. Ghost Bridge refuses ambiguous action targets and returns compact candidates instead of silently choosing the first element.
+
+`waitFor` supports:
+
+- `element`: `visible`, `hidden`, `attached`, `detached`, or `enabled`
+- `url`: `contains` or `equals`
+- `networkIdle`: optional `idleMs`
+- `expression`: a truthy JavaScript expression, including a returned Promise
+
+Polling happens inside the extension at a short interval, so it does not create repeated model/tool turns. Each condition defaults to 10 seconds and is capped at 30 seconds. The whole batch has a hard deadline of at most 60 seconds; once reached, remaining actions are not executed. Fixed `waitMs` remains for compatibility but defaults to zero.
+
 For API calls that need the page's login state, prefer `page_request`. If custom asynchronous JavaScript is still needed, return the promise from `eval_script` instead of storing a result on `window` and polling it in another tool call:
 
 ```javascript
@@ -150,6 +180,8 @@ Notes:
 
 - Use `bind_tab` when a workflow spans multiple pages. For example, bind a checklist page as `cases` and a business page as `app`, then call tools with `target: "cases"` or `target: "app"`.
 - All browser tools accept an optional `target` parameter. When named targets are bound, `dispatch_action` requires `target` so refs from one page are not accidentally used on another page.
+- Semantic locators traverse open Shadow DOM and readable same-origin iframes. Cross-origin iframe DOM is not accessible and is skipped explicitly.
+- `get_page_content` reports iframe counters and uses contiguous `offset`/`maxLength` slices, so pagination does not duplicate or skip the hidden middle of a head/tail truncation.
 - Use `pin_current_tab` when you are debugging a page and need to switch to other tabs without changing the AI target. Use `unpin_tab` to restore the original follow-focused-tab behavior.
 - `list_network_requests` and `get_network_detail` automatically summarize `data:` URLs and very long URLs so inline images or oversized query strings do not overwhelm model context
 

package/dist/server.js

@@ -28536,6 +28536,178 @@ var packageJsonPath = path.resolve(__dirname, "../package.json");
 var packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
 var GHOST_BRIDGE_VERSION = packageJson.version;
 
+// src/bridge-utils.js
+var DEFAULT_DISPATCH_TIMEOUT_MS = 3e4;
+var MAX_DISPATCH_TIMEOUT_MS = 6e4;
+function jsonText(data) {
+  return typeof data === "string" ? data : JSON.stringify(data);
+}
+function compact(value) {
+  if (Array.isArray(value)) {
+    const cleaned = value.map(compact).filter((item) => item !== void 0);
+    return cleaned.length ? cleaned : void 0;
+  }
+  if (value && typeof value === "object") {
+    const cleaned = {};
+    for (const [key, item] of Object.entries(value)) {
+      const compacted = compact(item);
+      if (compacted !== void 0) cleaned[key] = compacted;
+    }
+    return Object.keys(cleaned).length ? cleaned : void 0;
+  }
+  if (value === null || value === "") return void 0;
+  return value;
+}
+function out(data) {
+  return jsonText(compact(data));
+}
+function clampNumber(value, fallback, min, max) {
+  const number3 = Number(value);
+  if (!Number.isFinite(number3)) return fallback;
+  return Math.min(max, Math.max(min, Math.round(number3)));
+}
+function buildTruncatedOutput(text, retainedChars) {
+  const headLength = Math.ceil(retainedChars * 0.8);
+  const tailLength = Math.max(0, retainedChars - headLength);
+  const omitted = Math.max(0, text.length - headLength - tailLength);
+  return out({
+    truncated: true,
+    originalLength: text.length,
+    content: `${text.slice(0, headLength)}
+... [\u5DF2\u7701\u7565 ${omitted} \u4E2A\u5B57\u7B26] ...
+${tailLength ? text.slice(-tailLength) : ""}`,
+    hint: "\u9700\u8981\u66F4\u591A\u7ED3\u679C\u65F6\u8BF7\u6536\u7A84\u8FD4\u56DE\u5B57\u6BB5\uFF1B\u4E0D\u8981\u901A\u8FC7\u8FDE\u7EED\u8F6E\u8BE2\u5206\u7247\u83B7\u53D6\u5927\u5BF9\u8C61"
+  });
+}
+function boundedOut(data, maxLength, { defaultLength = 8e3, maxAllowed = 5e4 } = {}) {
+  const text = out(data) ?? "undefined";
+  const limit = clampNumber(maxLength, defaultLength, 200, maxAllowed);
+  if (text.length <= limit) return text;
+  let low = 0;
+  let high = text.length;
+  let best = buildTruncatedOutput(text, 0);
+  if (best.length > limit) {
+    return JSON.stringify({ truncated: true });
+  }
+  while (low <= high) {
+    const middle = Math.floor((low + high) / 2);
+    const candidate = buildTruncatedOutput(text, middle);
+    if (candidate.length <= limit) {
+      best = candidate;
+      low = middle + 1;
+    } else {
+      high = middle - 1;
+    }
+  }
+  return best;
+}
+function calculateDispatchBudget(args = {}) {
+  const steps = Array.isArray(args.actions) ? args.actions : [args];
+  if (!steps.length || steps.length > 20) throw new Error("actions \u6570\u91CF\u5FC5\u987B\u5728 1-20 \u4E4B\u95F4");
+  const totalLegacyWaitMs = steps.reduce(
+    (sum, step) => sum + clampNumber(step.waitMs, 0, 0, 3e3),
+    0
+  );
+  const totalConditionWaitMs = steps.reduce(
+    (sum, step) => sum + (step.waitFor ? clampNumber(step.waitFor.timeoutMs, 1e4, 100, 3e4) : 0),
+    0
+  );
+  const estimatedActionMs = steps.length * 750;
+  const snapshotMs = args.snapshotAfter ? 2e3 : 0;
+  const estimatedExecutionMs = 2e3 + estimatedActionMs + totalLegacyWaitMs + totalConditionWaitMs + snapshotMs;
+  const explicitTimeout = args.timeoutMs === void 0 ? null : clampNumber(args.timeoutMs, DEFAULT_DISPATCH_TIMEOUT_MS, 1e3, MAX_DISPATCH_TIMEOUT_MS);
+  if (explicitTimeout === null && estimatedExecutionMs > MAX_DISPATCH_TIMEOUT_MS) {
+    throw new Error(
+      `\u6279\u5904\u7406\u6700\u574F\u6267\u884C\u9884\u7B97 ${estimatedExecutionMs}ms \u8D85\u8FC7 ${MAX_DISPATCH_TIMEOUT_MS}ms\uFF1B\u8BF7\u51CF\u5C11\u52A8\u4F5C/\u7B49\u5F85\u6570\u91CF\u3001\u7F29\u77ED waitFor.timeoutMs\uFF0C\u6216\u663E\u5F0F\u8BBE\u7F6E\u8F83\u5C0F\u7684\u6574\u4F53 timeoutMs \u8BA9\u6279\u5904\u7406\u6309\u622A\u6B62\u65F6\u95F4\u505C\u6B62`
+    );
+  }
+  const executionTimeoutMs = explicitTimeout ?? Math.max(5e3, Math.min(MAX_DISPATCH_TIMEOUT_MS, estimatedExecutionMs));
+  return {
+    steps,
+    estimatedExecutionMs,
+    executionTimeoutMs,
+    serverTimeoutMs: executionTimeoutMs + 5e3
+  };
+}
+
+// src/tool-schemas.js
+var LOCATOR_REF = { $ref: "#/$defs/locator" };
+var WAIT_FOR_REF = { $ref: "#/$defs/wait" };
+var LOCATOR_DEFINITION = {
+  type: "object",
+  description: "\u591A\u5B57\u6BB5\u540C\u65F6\u6EE1\u8DB3\uFF1B\u9ED8\u8BA4 exact\uFF0C\u6B67\u4E49\u65F6\u7528 nth \u6216\u6536\u7A84\u6761\u4EF6\u3002",
+  properties: {
+    css: { type: "string", description: "CSS \u9009\u62E9\u5668" },
+    testId: { type: "string", description: "data-testid" },
+    role: { type: "string", description: "ARIA/\u9690\u5F0F role" },
+    name: { type: "string", description: "\u53EF\u8BBF\u95EE\u540D\u79F0" },
+    label: { type: "string", description: "\u8868\u5355 label/aria-label" },
+    placeholder: { type: "string" },
+    text: { type: "string", description: "\u5143\u7D20\u6587\u672C" },
+    nth: { type: "integer", minimum: 0, description: "\u4ECE 0 \u5F00\u59CB" },
+    match: { enum: ["exact", "contains"], description: "\u9ED8\u8BA4 exact" }
+  }
+};
+var WAIT_FOR_DEFINITION = {
+  type: "object",
+  description: "\u52A8\u4F5C\u540E\u5728\u6269\u5C55\u5185\u90E8\u7B49\u5F85\uFF0C\u4E0D\u589E\u52A0\u6A21\u578B\u5F80\u8FD4\u3002",
+  properties: {
+    type: { enum: ["element", "url", "networkIdle", "expression"] },
+    locator: { ...LOCATOR_REF, description: "element \u6761\u4EF6\u7684\u5B9A\u4F4D\u5668\uFF1B\u7701\u7565\u65F6\u590D\u7528\u52A8\u4F5C locator" },
+    state: { enum: ["visible", "hidden", "attached", "detached", "enabled"], description: "element \u9ED8\u8BA4 visible" },
+    contains: { type: "string", description: "URL \u5305\u542B" },
+    equals: { type: "string", description: "URL \u7B49\u4E8E" },
+    idleMs: { type: "number", minimum: 100, maximum: 1e4, description: "networkIdle \u7A7A\u95F2\u65F6\u95F4" },
+    expression: { type: "string", description: "JS \u771F\u503C\u8868\u8FBE\u5F0F\uFF0C\u53EF\u8FD4\u56DE Promise" },
+    timeoutMs: { type: "number", minimum: 100, maximum: 3e4, description: "\u9ED8\u8BA4 10000" }
+  },
+  required: ["type"]
+};
+var ACTION_PROPERTIES = {
+  ref: { type: "string" },
+  selector: { type: "string" },
+  locator: LOCATOR_REF,
+  action: { enum: ["click", "fill", "press", "scroll", "select", "hover", "focus"] },
+  value: { type: "string" },
+  key: { type: "string" },
+  deltaX: { type: "number" },
+  deltaY: { type: "number" },
+  waitMs: { type: "number", minimum: 0, maximum: 3e3 },
+  waitFor: WAIT_FOR_REF
+};
+var ACTION_DEFINITION = {
+  type: "object",
+  properties: ACTION_PROPERTIES,
+  required: ["action"]
+};
+var DISPATCH_ACTION_TOOL = {
+  name: "dispatch_action",
+  description: "\u5B9A\u4F4D\u2192\u64CD\u4F5C\u2192\u7B49\u5F85\u2192\u5FEB\u7167\u4E00\u6B21\u5B8C\u6210\u3002\u5355\u52A8\u4F20 ref/selector/locator+action\uFF0C\u6279\u91CF\u4F20 actions\uFF1Bfill/select \u7528 value\uFF0Cpress \u7528 key\u3002",
+  inputSchema: {
+    type: "object",
+    $defs: {
+      locator: LOCATOR_DEFINITION,
+      wait: WAIT_FOR_DEFINITION,
+      action: ACTION_DEFINITION
+    },
+    properties: {
+      target: { type: "string" },
+      ...ACTION_PROPERTIES,
+      timeoutMs: { type: "number", minimum: 1e3, maximum: 6e4 },
+      actions: {
+        type: "array",
+        minItems: 1,
+        maxItems: 20,
+        items: { $ref: "#/$defs/action" }
+      },
+      stopOnError: { type: "boolean" },
+      snapshotAfter: { type: "boolean" },
+      snapshotSelector: { type: "string" },
+      snapshotMaxElements: { type: "number" }
+    }
+  }
+};
+
 // src/server.js
 var BASE_PORT = Number(process.env.GHOST_BRIDGE_PORT || 33333);
 var DEFAULT_WS_TOKEN = "ghost-bridge-local";
@@ -29130,50 +29302,6 @@ async function askChrome(command, params = {}, options = {}) {
     });
   });
 }
-function jsonText(data) {
-  return typeof data === "string" ? data : JSON.stringify(data);
-}
-function compact(value) {
-  if (Array.isArray(value)) {
-    const cleaned = value.map(compact).filter((v) => v !== void 0);
-    return cleaned.length ? cleaned : void 0;
-  }
-  if (value && typeof value === "object") {
-    const cleaned = {};
-    for (const [k, v] of Object.entries(value)) {
-      const c = compact(v);
-      if (c !== void 0) cleaned[k] = c;
-    }
-    return Object.keys(cleaned).length ? cleaned : void 0;
-  }
-  if (value === null || value === "") return void 0;
-  return value;
-}
-function out(data) {
-  return jsonText(compact(data));
-}
-function clampNumber(value, fallback, min, max) {
-  const number3 = Number(value);
-  if (!Number.isFinite(number3)) return fallback;
-  return Math.min(max, Math.max(min, Math.round(number3)));
-}
-function boundedOut(data, maxLength = DEFAULT_EVAL_OUTPUT_LENGTH) {
-  const text = out(data) ?? "undefined";
-  const limit = clampNumber(maxLength, DEFAULT_EVAL_OUTPUT_LENGTH, 200, MAX_EVAL_OUTPUT_LENGTH);
-  if (text.length <= limit) return text;
-  const markerBudget = 100;
-  const headLength = Math.max(100, Math.floor((limit - markerBudget) * 0.8));
-  const tailLength = Math.max(50, limit - markerBudget - headLength);
-  const omitted = Math.max(0, text.length - headLength - tailLength);
-  return out({
-    truncated: true,
-    originalLength: text.length,
-    content: `${text.slice(0, headLength)}
-... [\u5DF2\u7701\u7565 ${omitted} \u4E2A\u5B57\u7B26] ...
-${text.slice(-tailLength)}`,
-    hint: "\u9700\u8981\u66F4\u591A\u7ED3\u679C\u65F6\u8BF7\u6536\u7A84\u8FD4\u56DE\u5B57\u6BB5\uFF1B\u4E0D\u8981\u901A\u8FC7\u8FDE\u7EED\u8F6E\u8BE2\u5206\u7247\u83B7\u53D6\u5927\u5BF9\u8C61"
-  });
-}
 function truncateUrl(url2, maxLen = 200) {
   if (typeof url2 !== "string" || url2.length <= maxLen) return url2;
   return url2.slice(0, maxLen) + "\u2026";
@@ -29568,7 +29696,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: "get_interactive_snapshot",
-      description: "\u626B\u63CF\u53EF\u89C1\u53EF\u4EA4\u4E92\u5143\u7D20\uFF0C\u8FD4\u56DE\u5E26 ref \u7684\u7CBE\u7B80\u5217\u8868\u4F9B dispatch_action \u4F7F\u7528\uFF08\u5148\u5FEB\u7167\u540E\u64CD\u4F5C\uFF09\u3002\u9ED8\u8BA4 30 \u4E2A\uFF0C\u9700\u8981\u66F4\u591A\u4F20 maxElements \u6216\u7528 selector \u6536\u7A84\u3002\u652F\u6301 Shadow DOM\u3002",
+      description: "\u5F53\u65E0\u6CD5\u76F4\u63A5\u5199\u51FA\u8BED\u4E49 locator \u65F6\uFF0C\u626B\u63CF\u53EF\u89C1\u53EF\u4EA4\u4E92\u5143\u7D20\u5E76\u8FD4\u56DE ref\u3002\u9ED8\u8BA4 30 \u4E2A\uFF0C\u9700\u8981\u66F4\u591A\u4F20 maxElements \u6216\u7528 selector \u6536\u7A84\u3002\u652F\u6301 Shadow DOM\u3002",
       inputSchema: {
         type: "object",
         properties: {
@@ -29588,83 +29716,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         }
       }
     },
-    {
-      name: "dispatch_action",
-      description: "\u6267\u884C\u5355\u4E2A\u6216\u4E00\u6279\u4EA4\u4E92\u52A8\u4F5C\u3002\u53EF\u7528\u5FEB\u7167 ref \u6216 CSS selector \u5B9A\u4F4D\uFF1B\u4F18\u5148\u7528 actions \u6279\u91CF\u5B8C\u6210\u8FDE\u7EED\u586B\u5199/\u70B9\u51FB\uFF0CsnapshotAfter:true \u53EF\u5728\u540C\u4E00\u6B21\u8C03\u7528\u8FD4\u56DE\u64CD\u4F5C\u540E\u5143\u7D20\uFF0C\u51CF\u5C11\u6A21\u578B\u5F80\u8FD4\u3002",
-      inputSchema: {
-        type: "object",
-        properties: {
-          target: TARGET_ARG,
-          ref: {
-            type: "string",
-            description: "\u5143\u7D20 ref\uFF0C\u5982 'e1'\uFF08\u6765\u81EA get_interactive_snapshot\uFF09"
-          },
-          selector: {
-            type: "string",
-            description: "CSS \u9009\u62E9\u5668\uFF1B\u5DF2\u77E5\u9009\u62E9\u5668\u65F6\u53EF\u66FF\u4EE3 ref\uFF0C\u7701\u53BB\u524D\u7F6E\u5FEB\u7167"
-          },
-          action: {
-            type: "string",
-            enum: ["click", "fill", "press", "scroll", "select", "hover", "focus"]
-          },
-          value: {
-            type: "string",
-            description: "fill \u7684\u6587\u672C / select \u7684 option value"
-          },
-          key: {
-            type: "string",
-            description: "press \u6309\u952E\uFF0C\u9ED8\u8BA4 'Enter'"
-          },
-          deltaX: {
-            type: "number",
-            description: "\u6C34\u5E73\u6EDA\u52A8\u91CF\uFF0C\u9ED8\u8BA4 0"
-          },
-          deltaY: {
-            type: "number",
-            description: "\u5782\u76F4\u6EDA\u52A8\u91CF\uFF0C\u9ED8\u8BA4 300\uFF08\u6B63\u6570\u5411\u4E0B\uFF09"
-          },
-          waitMs: {
-            type: "number",
-            description: "\u64CD\u4F5C\u540E\u7B49\u5F85 ms\uFF0C\u9ED8\u8BA4 500\uFF0C\u6700\u5927 3000"
-          },
-          actions: {
-            type: "array",
-            maxItems: 20,
-            description: "\u987A\u5E8F\u6267\u884C\u7684\u52A8\u4F5C\uFF0C\u6700\u591A 20 \u4E2A\uFF1B\u6BCF\u9879\u652F\u6301 ref/selector\u3001action\u3001value/key\u3001deltaX/deltaY\u3001waitMs",
-            items: {
-              type: "object",
-              properties: {
-                ref: { type: "string" },
-                selector: { type: "string" },
-                action: { type: "string", enum: ["click", "fill", "press", "scroll", "select", "hover", "focus"] },
-                value: { type: "string" },
-                key: { type: "string" },
-                deltaX: { type: "number" },
-                deltaY: { type: "number" },
-                waitMs: { type: "number" }
-              },
-              required: ["action"]
-            }
-          },
-          stopOnError: {
-            type: "boolean",
-            description: "\u6279\u91CF\u52A8\u4F5C\u5931\u8D25\u65F6\u7ACB\u5373\u505C\u6B62\uFF0C\u9ED8\u8BA4 true"
-          },
-          snapshotAfter: {
-            type: "boolean",
-            description: "\u5728\u6700\u540E\u4E00\u4E2A\u52A8\u4F5C\u540E\u8FD4\u56DE\u65B0\u7684\u4EA4\u4E92\u5FEB\u7167\uFF0C\u9ED8\u8BA4 false"
-          },
-          snapshotSelector: {
-            type: "string",
-            description: "\u9650\u5236\u64CD\u4F5C\u540E\u5FEB\u7167\u8303\u56F4"
-          },
-          snapshotMaxElements: {
-            type: "number",
-            description: "\u64CD\u4F5C\u540E\u5FEB\u7167\u5143\u7D20\u4E0A\u9650\uFF0C\u9ED8\u8BA4 20"
-          }
-        }
-      }
-    }
+    DISPATCH_ACTION_TOOL
   ]
 }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
@@ -29704,7 +29756,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 summary,
                 page,
                 interactive,
-                nextStepHint: "\u89C6\u89C9\u7528 capture_screenshot\uFF1B\u70B9\u51FB/\u8F93\u5165\u7528 get_interactive_snapshot + dispatch_action\uFF1B\u8BF7\u6C42/\u6027\u80FD\u7528 list_network_requests / perf_metrics\u3002"
+                nextStepHint: "\u89C6\u89C9\u7528 capture_screenshot\uFF1B\u70B9\u51FB/\u8F93\u5165\u4F18\u5148\u7528 dispatch_action \u8BED\u4E49 locator\uFF0C\u5F53\u524D refs \u4E5F\u53EF\u76F4\u63A5\u4F7F\u7528\uFF1B\u8BF7\u6C42/\u6027\u80FD\u7528 list_network_requests / perf_metrics\u3002"
               } : {
                 summary,
                 interactive: elements ? { viewport: interactive?.viewport, elements } : void 0,
@@ -29924,6 +29976,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     }
     if (name === "get_page_content") {
       const { target, mode = "text", selector, maxLength = 8e3, offset = 0, includeMetadata = true } = args;
+      const safeMaxLength = clampNumber(maxLength, 8e3, 1, 5e4);
+      const safeOffset = clampNumber(offset, 0, 0, 1e8);
       const validModes = ["text", "html", "structured"];
       if (mode && !validModes.includes(mode)) {
         return {
@@ -29933,22 +29987,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           }]
         };
       }
-      if (offset > 0 && mode === "text") {
-        const selectorExpr = selector ? `(document.querySelector(${JSON.stringify(selector)}) || document.body)` : "document.body";
-        const code = `(function(){try{function ct(el){var t=el.innerText||el.textContent||"";try{var fs=el.querySelectorAll("iframe");for(var i=0;i<fs.length;i++){try{var d=fs[i].contentDocument;if(d&&d.body)t+="\\n\\n"+ct(d.body);}catch(e){}}}catch(e){}return t;}var text=ct(${selectorExpr});var start=${offset};var end=${offset + maxLength};return {content:text.slice(start,end),offset:start,totalLength:text.length,hasMore:text.length>end};}catch(e){return {error:e.message}}})()`;
-        const res2 = await askChrome("eval", { target, code });
-        return { content: [{ type: "text", text: out(res2) }] };
-      }
-      if (offset > 0 && mode === "html") {
-        const res2 = await askChrome("getPageContent", { target, mode, selector, maxLength: offset + maxLength, includeMetadata: false });
-        if (typeof res2?.content === "string") {
-          res2.content = res2.content.slice(offset, offset + maxLength);
-          res2.offset = offset;
-          res2.hasMore = (res2.contentLength || 0) > offset + maxLength;
-        }
-        return { content: [{ type: "text", text: out(res2) }] };
-      }
-      const res = await askChrome("getPageContent", { target, mode, selector, maxLength, includeMetadata });
+      const res = await askChrome("getPageContent", {
+        target,
+        mode,
+        selector,
+        maxLength: safeMaxLength,
+        offset: safeOffset,
+        includeMetadata
+      });
       if (typeof res?.metadata?.url === "string" && res.metadata.url.length > 200) {
         res.metadata.url = truncateUrl(res.metadata.url);
         res.metadata.urlTruncated = true;
@@ -29961,11 +30007,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       return { content: [{ type: "text", text: out(res) }] };
     }
     if (name === "dispatch_action") {
-      const steps = Array.isArray(args.actions) ? args.actions : [args];
-      if (!steps.length || steps.length > 20) throw new Error("actions \u6570\u91CF\u5FC5\u987B\u5728 1-20 \u4E4B\u95F4");
-      const totalWaitMs = steps.reduce((sum, step) => sum + clampNumber(step.waitMs, 500, 0, 3e3), 0);
-      const timeoutMs = Math.min(45e3, 1e4 + totalWaitMs);
-      const res = await askChrome("dispatchAction", args, { timeoutMs });
+      const budget = calculateDispatchBudget(args);
+      const res = await askChrome(
+        "dispatchAction",
+        { ...args, timeoutMs: budget.executionTimeoutMs },
+        { timeoutMs: budget.serverTimeoutMs }
+      );
       return { content: [{ type: "text", text: out(res) }] };
     }
     return { content: [{ type: "text", text: `\u672A\u77E5\u5DE5\u5177\uFF1A${name}` }] };