aipeek 0.2.4 → 0.2.6

package/dist/{chunk-72ZKZ42D.js → chunk-XA2LT6I4.js}

@@ -67,6 +67,47 @@ function check(raw) {
 function truncate(s, max) {
   return s.length > max ? `${s.slice(0, max)}\u2026` : s;
 }
+function formatValue(v, seen = /* @__PURE__ */ new Set()) {
+  if (v === null || v === void 0)
+    return String(v);
+  const t = typeof v;
+  if (t === "string")
+    return v;
+  if (t === "number" || t === "boolean" || t === "bigint")
+    return String(v);
+  if (t === "symbol")
+    return v.toString();
+  if (t === "function")
+    return `[Function: ${v.name || "anonymous"}]`;
+  const obj = v;
+  if (seen.has(obj))
+    return "[Circular]";
+  if (v instanceof Error)
+    return v.stack || `${v.name}: ${v.message}`;
+  seen.add(obj);
+  if (v instanceof Map) {
+    const items = [...v.entries()].slice(0, 15).map(([k, val]) => `${formatValue(k, seen)} => ${formatValue(val, seen)}`);
+    return `Map(${v.size}) {${items.join(", ")}${v.size > 15 ? ", \u2026" : ""}}`;
+  }
+  if (v instanceof Set) {
+    const items = [...v.values()].slice(0, 15).map((val) => formatValue(val, seen));
+    return `Set(${v.size}) {${items.join(", ")}${v.size > 15 ? ", \u2026" : ""}}`;
+  }
+  if (Array.isArray(v)) {
+    const items = v.slice(0, 30).map((val) => formatValue(val, seen));
+    return `[${items.join(", ")}${v.length > 30 ? ", \u2026" : ""}]`;
+  }
+  try {
+    return JSON.stringify(v);
+  } catch {
+    const entries = Object.entries(v).slice(0, 15);
+    const parts = entries.map(([k, val]) => `${k}: ${formatValue(val, seen)}`);
+    return `{${parts.join(", ")}}`;
+  }
+}
+function appStackFrames(stack, max) {
+  return stack.split("\n").map((l) => l.trim()).filter((l) => l.startsWith("at ") && !l.includes("node_modules") && !l.includes("<anonymous>")).slice(0, max);
+}
 function compactUrl(url, search) {
   try {
     const u = new URL(url);
@@ -283,17 +324,12 @@ function compactErrors(errors) {
   for (const err of seen.values()) {
     lines.push(err.message);
     if (err.stack) {
-      const frames = filterStack(err.stack);
-      for (const frame of frames) {
-        lines.push(`  at ${frame}`);
-      }
+      for (const frame of appStackFrames(err.stack, 5))
+        lines.push(`  ${frame}`);
     }
   }
   return lines.join("\n");
 }
-function filterStack(stack) {
-  return stack.split("\n").map((l) => l.trim()).filter((l) => l.startsWith("at ")).map((l) => l.slice(3)).filter((l) => !l.includes("node_modules") && !l.includes("<anonymous>")).slice(0, 5);
-}
 function compactState(state) {
   if (!state || !Object.keys(state).length)
     return "";
@@ -302,7 +338,7 @@ function compactState(state) {
     lines.push(`${name}:`);
     if (typeof value === "object" && value !== null) {
       for (const [k, v] of Object.entries(value)) {
-        lines.push(`  ${k}: ${formatValue(v)}`);
+        lines.push(`  ${k}: ${truncate(formatValue(v), 120)}`);
       }
     } else {
       lines.push(`  ${String(value)}`);
@@ -310,19 +346,6 @@ function compactState(state) {
   }
   return lines.join("\n");
 }
-function formatValue(v) {
-  if (v === null || v === void 0)
-    return String(v);
-  if (typeof v === "string")
-    return v;
-  if (typeof v === "number" || typeof v === "boolean")
-    return String(v);
-  if (typeof v === "object") {
-    const s = JSON.stringify(v);
-    return s.length > 120 ? `${s.slice(0, 120)}\u2026` : s;
-  }
-  return String(v);
-}
 function compact(raw) {
   return {
     url: raw.url,
@@ -459,12 +482,10 @@ function detailError(errors, index, full) {
   }
   const lines = [err.message];
   if (err.stack) {
-    const appFrames = err.stack.split("\n").map((l) => l.trim()).filter((l) => l.startsWith("at ") && !l.includes("node_modules")).slice(0, 3);
-    if (appFrames.length)
-      lines.push(...appFrames);
-    const totalApp = err.stack.split("\n").filter((l) => l.trim().startsWith("at ") && !l.includes("node_modules")).length;
-    if (totalApp > 3)
-      lines.push(`  ... ${totalApp - 3} more app frames`);
+    const all = appStackFrames(err.stack, Infinity);
+    lines.push(...all.slice(0, 3));
+    if (all.length > 3)
+      lines.push(`  ... ${all.length - 3} more app frames`);
   }
   if (err.line != null)
     lines.push(`location: ${err.source || ""}:${err.line}:${err.column ?? 0}`);
@@ -482,9 +503,9 @@ function detailState(state, name, full) {
   const value = state[name];
   if (full) {
     try {
-      return JSON.stringify(value, null, 2);
+      return JSON.stringify(value, null, 2) ?? formatValue(value);
     } catch {
-      return String(value);
+      return formatValue(value);
     }
   }
   if (typeof value !== "object" || value === null)
@@ -502,20 +523,9 @@ function isArraySentinel(v) {
   return digits.length > 0 && [...digits].every((c) => c >= "0" && c <= "9");
 }
 function formatSummaryValue(v) {
-  if (v === null || v === void 0)
-    return String(v);
-  if (typeof v === "string") {
-    if (isArraySentinel(v))
-      return v;
-    return v.length > 80 ? `${v.slice(0, 80)}\u2026` : v;
-  }
-  if (typeof v === "number" || typeof v === "boolean")
-    return String(v);
-  if (typeof v === "object") {
-    const s = JSON.stringify(v);
-    return s.length > 80 ? `${s.slice(0, 80)}\u2026` : s;
-  }
-  return String(v);
+  if (typeof v === "string" && isArraySentinel(v))
+    return v;
+  return truncate(formatValue(v), 80);
 }
 function jsonSchema(sample) {
   try {
@@ -749,6 +759,10 @@ function readBody(req) {
     req.on("end", () => resolve2(s));
   });
 }
+function send(res, status, body) {
+  res.writeHead(status, { "Content-Type": "text/plain; charset=utf-8" });
+  res.end(body);
+}
 var __dirname2 = dirname(fileURLToPath(import.meta.url));
 var clientDir = existsSync(resolve(__dirname2, "../client")) ? resolve(__dirname2, "../client") : resolve(__dirname2, "../src/client");
 var clientPath = resolve(clientDir, "client.ts");
@@ -826,61 +840,29 @@ JS in the page and returns the result \u2014 for anything the typed endpoints ca
 aipeek auto-detects errors after HMR and prints them to the terminal \u2014 watch for \`[aipeek]\` messages.
 `;
 }
-function norm(line) {
-  const t = line.trim();
-  const i = t.indexOf("localhost:");
-  if (i === -1)
-    return t;
-  let j = i + "localhost:".length;
-  while (j < t.length && t[j] >= "0" && t[j] <= "9") j++;
-  return `${t.slice(0, i)}localhost:PORT${t.slice(j)}`;
-}
-function stripBlocks(content, snippet) {
-  const known = new Set(snippet.split("\n").map(norm).filter((l) => l.length > 3));
-  const lines = content.split("\n");
-  const keep = [];
-  let inside = false;
-  let buf = [];
-  let hits = 0;
-  const flush = () => {
-    if (buf.length && hits / buf.length <= 0.5)
-      keep.push(...buf);
-    buf = [];
-    hits = 0;
-    inside = false;
-  };
-  for (const line of lines) {
-    const isKnown = known.has(norm(line));
-    if (!inside) {
-      if (isKnown) {
-        inside = true;
-        buf = [line];
-        hits = 1;
-      } else {
-        keep.push(line);
-      }
-      continue;
-    }
-    buf.push(line);
-    if (isKnown)
-      hits++;
-    else if (buf.slice(-3).every((l) => !known.has(norm(l))))
-      flush();
-  }
-  flush();
-  return keep.join("\n");
-}
+var START_TAG = "<!-- AIPEEK:START -->";
+var END_TAG = "<!-- AIPEEK:END -->";
 function injectClaudeMd(root, port) {
   const path = resolve(root, "CLAUDE.md");
-  const snippet = aipeekSnippet(port);
+  const block = `${START_TAG}
+${aipeekSnippet(port).trim()}
+${END_TAG}
+`;
   try {
     if (!existsSync(path)) {
-      writeFileSync(path, snippet.trimStart());
+      writeFileSync(path, block);
+      return;
+    }
+    const content = readFileSync(path, "utf-8");
+    const si = content.indexOf(START_TAG);
+    const ei = content.indexOf(END_TAG);
+    if (si !== -1 && ei !== -1) {
+      writeFileSync(path, content.slice(0, si) + block.trimEnd() + content.slice(ei + END_TAG.length));
       return;
     }
-    const stripped = stripBlocks(readFileSync(path, "utf-8"), snippet).trimEnd();
-    writeFileSync(path, `${stripped}
-${snippet}`);
+    const sep = content.endsWith("\n") ? "" : "\n";
+    writeFileSync(path, `${content}${sep}
+${block}`);
   } catch {
   }
 }
@@ -1043,13 +1025,11 @@ function aipeekPlugin() {
             if (!code && req.method === "POST")
               code = await readBody(req);
             if (!code) {
-              res.writeHead(400, { "Content-Type": "text/plain; charset=utf-8" });
-              res.end("eval needs ?code= or a POST body");
+              send(res, 400, "eval needs ?code= or a POST body");
               return;
             }
             const r = await evalInClient(code);
-            res.writeHead(r.ok ? 200 : 422, { "Content-Type": "text/plain; charset=utf-8" });
-            res.end(r.ok ? r.value ?? "undefined" : `error: ${r.error}`);
+            send(res, r.ok ? 200 : 422, r.ok ? r.value ?? "undefined" : `error: ${r.error}`);
             return;
           }
           if (parts[0] === "dom") {
@@ -1057,14 +1037,12 @@ function aipeekPlugin() {
               url.searchParams.get("scope") || void 0,
               url.searchParams.get("sel") || void 0
             );
-            res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" });
-            res.end(dom || "(empty)");
+            send(res, 200, dom || "(empty)");
             return;
           }
           if (parts[0] === "screen") {
             const screen = await collectScreenFromClient();
-            res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" });
-            res.end(screen || "(empty)");
+            send(res, 200, screen || "(empty)");
             return;
           }
           if (parts[0] === "chain") {
@@ -1075,8 +1053,7 @@ function aipeekPlugin() {
               if (!Array.isArray(steps))
                 throw new Error("body must be a JSON array");
             } catch (e) {
-              res.writeHead(400, { "Content-Type": "text/plain; charset=utf-8" });
-              res.end(`invalid chain body: ${e instanceof Error ? e.message : String(e)}`);
+              send(res, 400, `invalid chain body: ${e instanceof Error ? e.message : String(e)}`);
               return;
             }
             lastRaw = null;
@@ -1102,8 +1079,7 @@ function aipeekPlugin() {
                 break;
               }
             }
-            res.writeHead(allOk ? 200 : 422, { "Content-Type": "text/plain; charset=utf-8" });
-            res.end(lastUi ? `${lines.join("\n")}
+            send(res, allOk ? 200 : 422, lastUi ? `${lines.join("\n")}
 
 --- ui after ---
 ${lastUi}` : lines.join("\n"));
@@ -1121,8 +1097,7 @@ ${lastUi}` : lines.join("\n"));
             };
             const check2 = resolveAction(parts[0], args);
             if (!check2.valid) {
-              res.writeHead(400, { "Content-Type": "text/plain; charset=utf-8" });
-              res.end(check2.error);
+              send(res, 400, check2.error ?? "invalid action");
               return;
             }
             const result = await sendAction(parts[0], args);
@@ -1133,15 +1108,13 @@ ${lastUi}` : lines.join("\n"));
               const name = q.get("out") || `shot-${result.dataUrl.length}.png`;
               const file = resolve(dir, name);
               writeFileSync(file, Buffer.from(result.dataUrl.split(",")[1], "base64"));
-              res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" });
-              res.end(`saved: ${file}`);
+              send(res, 200, `saved: ${file}`);
               return;
             }
-            res.writeHead(result.ok ? 200 : 422, { "Content-Type": "text/plain; charset=utf-8" });
             const head = result.ok ? result.detail || "ok" : `${result.error}${result.detail ? `
 
 clickable: ${result.detail}` : ""}`;
-            res.end(result.ui ? `${head}
+            send(res, result.ok ? 200 : 422, result.ui ? `${head}
 
 --- ui after ---
 ${result.ui}` : head);
@@ -1152,8 +1125,7 @@ ${result.ui}` : head);
             lastRaw = raw2;
             const result = check(raw2);
             const output = emitCheck(result);
-            res.writeHead(result.pass ? 200 : 417, { "Content-Type": "text/plain; charset=utf-8" });
-            res.end(output);
+            send(res, result.pass ? 200 : 417, output);
             return;
           }
           if (parts.length >= 1) {
@@ -1161,29 +1133,22 @@ ${result.ui}` : head);
               lastRaw = await collectFromClient();
             const result = detail(lastRaw, parts[0], parts[1], full);
             if (result !== null) {
-              res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" });
-              res.end(result);
+              send(res, 200, result);
               return;
             }
-            res.writeHead(404, { "Content-Type": "text/plain" });
-            res.end(`not found: ${parts.join("/")}`);
+            send(res, 404, `not found: ${parts.join("/")}`);
             return;
           }
           const raw = await collectFromClient();
           lastRaw = raw;
           if (full) {
             const compacted = compact(raw);
-            const output = emit(compacted);
-            res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" });
-            res.end(output);
+            send(res, 200, emit(compacted));
           } else {
-            const output = emitSummary(raw);
-            res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" });
-            res.end(output);
+            send(res, 200, emitSummary(raw));
           }
         } catch (err) {
-          res.writeHead(504, { "Content-Type": "text/plain" });
-          res.end(err instanceof Error ? err.message : "unknown error");
+          send(res, 504, err instanceof Error ? err.message : "unknown error");
         }
       });
     }
@@ -1196,5 +1161,8 @@ export {
   emitSummary,
   emitCheck,
   emitDiff,
+  START_TAG,
+  END_TAG,
+  injectClaudeMd,
   aipeekPlugin
 };

package/dist/index.cjs

@@ -5,7 +5,7 @@
 
 
 
-var _chunk3NVB3GGEcjs = require('./chunk-3NVB3GGE.cjs');
+var _chunk5ZZYOETFcjs = require('./chunk-5ZZYOETF.cjs');
 require('./chunk-Z2Y65YOY.cjs');
 
 
@@ -14,4 +14,4 @@ require('./chunk-Z2Y65YOY.cjs');
 
 
 
-exports.aipeekPlugin = _chunk3NVB3GGEcjs.aipeekPlugin; exports.check = _chunk3NVB3GGEcjs.check; exports.diffState = _chunk3NVB3GGEcjs.diffState; exports.emitCheck = _chunk3NVB3GGEcjs.emitCheck; exports.emitDiff = _chunk3NVB3GGEcjs.emitDiff; exports.emitSummary = _chunk3NVB3GGEcjs.emitSummary;
+exports.aipeekPlugin = _chunk5ZZYOETFcjs.aipeekPlugin; exports.check = _chunk5ZZYOETFcjs.check; exports.diffState = _chunk5ZZYOETFcjs.diffState; exports.emitCheck = _chunk5ZZYOETFcjs.emitCheck; exports.emitDiff = _chunk5ZZYOETFcjs.emitDiff; exports.emitSummary = _chunk5ZZYOETFcjs.emitSummary;

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   emitCheck,
   emitDiff,
   emitSummary
-} from "./chunk-72ZKZ42D.js";
+} from "./chunk-XA2LT6I4.js";
 export {
   aipeekPlugin,
   check,

package/dist/plugin.cjs

@@ -1,7 +1,13 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunk3NVB3GGEcjs = require('./chunk-3NVB3GGE.cjs');
+
+
+
+var _chunk5ZZYOETFcjs = require('./chunk-5ZZYOETF.cjs');
 require('./chunk-Z2Y65YOY.cjs');
 
 
-exports.aipeekPlugin = _chunk3NVB3GGEcjs.aipeekPlugin;
+
+
+
+exports.END_TAG = _chunk5ZZYOETFcjs.END_TAG; exports.START_TAG = _chunk5ZZYOETFcjs.START_TAG; exports.aipeekPlugin = _chunk5ZZYOETFcjs.aipeekPlugin; exports.injectClaudeMd = _chunk5ZZYOETFcjs.injectClaudeMd;

package/dist/plugin.js

@@ -1,6 +1,12 @@
 import {
-  aipeekPlugin
-} from "./chunk-72ZKZ42D.js";
+  END_TAG,
+  START_TAG,
+  aipeekPlugin,
+  injectClaudeMd
+} from "./chunk-XA2LT6I4.js";
 export {
-  aipeekPlugin
+  END_TAG,
+  START_TAG,
+  aipeekPlugin,
+  injectClaudeMd
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "aipeek",
-    "version": "0.2.4",
+    "version": "0.2.6",
     "description": "Gives AI a peek into your running browser app — UI tree, console, network, errors, state",
     "license": "MIT",
     "repository": {
@@ -42,6 +42,7 @@
     },
     "devDependencies": {
         "jsdom": "^29.1.1",
+        "teact": "file:../teact",
         "tsup": "^8.4.0",
         "typescript": "~5.7.2",
         "vitest": "^3.1.2"

package/src/client/client-patch.ts

@@ -39,7 +39,7 @@ for (const level of ['log', 'info', 'warn', 'error', 'debug'] as const) {
     console[level] = (...args: unknown[]) => {
         pushBounded(consoleLogs, {
             level,
-            text: args.map(a => typeof a === 'string' ? a : tryStringify(a)).join(' '),
+            text: args.map(a => typeof a === 'string' ? a : formatValue(a)).join(' '),
             timestamp: Date.now(),
         }, MAX_CONSOLE)
         orig.apply(console, args)
@@ -302,11 +302,43 @@ function sampleOf(v: unknown, d: number): unknown {
     return null
 }
 
-function tryStringify(v: unknown): string {
+// client-patch 是自包含内联脚本（esbuild transformSync，无模块解析）——不能 import core/util。
+// 这是 core/util.ts formatValue 的镜像；两处契约由各自单测守，client 侧靠运行时验证。
+function formatValue(v: unknown, seen: Set<object> = new Set()): string {
+    if (v === null || v === undefined)
+        return String(v)
+    const t = typeof v
+    if (t === 'string')
+        return v as string
+    if (t === 'number' || t === 'boolean' || t === 'bigint')
+        return String(v)
+    if (t === 'symbol')
+        return (v as symbol).toString()
+    if (t === 'function')
+        return `[Function: ${(v as { name?: string }).name || 'anonymous'}]`
+    const obj = v as object
+    if (seen.has(obj))
+        return '[Circular]'
+    if (v instanceof Error)
+        return v.stack || `${v.name}: ${v.message}`
+    seen.add(obj)
+    if (v instanceof Map) {
+        const items = [...v.entries()].slice(0, 15).map(([k, val]) => `${formatValue(k, seen)} => ${formatValue(val, seen)}`)
+        return `Map(${v.size}) {${items.join(', ')}${v.size > 15 ? ', …' : ''}}`
+    }
+    if (v instanceof Set) {
+        const items = [...v.values()].slice(0, 15).map(val => formatValue(val, seen))
+        return `Set(${v.size}) {${items.join(', ')}${v.size > 15 ? ', …' : ''}}`
+    }
+    if (Array.isArray(v)) {
+        const items = v.slice(0, 30).map(val => formatValue(val, seen))
+        return `[${items.join(', ')}${v.length > 30 ? ', …' : ''}]`
+    }
     try {
         return JSON.stringify(v)
     }
     catch {
-        return String(v)
+        const entries = Object.entries(v as Record<string, unknown>).slice(0, 15)
+        return `{${entries.map(([k, val]) => `${k}: ${formatValue(val, seen)}`).join(', ')}}`
     }
 }

package/src/client/client.ts

@@ -5,7 +5,7 @@
 
 import type { ActionArgs, ActionType } from '../core/action'
 import type { ErrorEntry, LogEntry, NetworkRequest } from '../core/types'
-import { INTERACTIVE, performAction } from '../core/action'
+import { INTERACTIVE, performAction, runEval, withDialogGuard } from '../core/action'
 
 declare global {
     interface Window { __AIPEEK_STORES__?: Record<string, unknown> }
@@ -643,7 +643,10 @@ if (import.meta.hot) {
     import.meta.hot.on('aipeek:action', async (msg: { id: number, type: ActionType, args: ActionArgs, requireVisible?: boolean }) => {
         if (skip(msg))
             return
-        const result = await performAction(msg.type, msg.args)
+        // Guard against native alert/confirm/prompt freezing the probe (see withDialogGuard).
+        const { result, dialogs } = await withDialogGuard(() => performAction(msg.type, msg.args))
+        if (dialogs.length)
+            result.detail = `${result.detail ?? ''} [auto-dismissed ${dialogs.join('; ')}]`.trim()
         // For mutating actions, settle the DOM then ship both the full UI tree and
         // the compact screen projection — the caller skips a round-trip to /ui, and
         // /chain uses the per-step screen so an interaction's every transition shows.
@@ -654,24 +657,11 @@ if (import.meta.hot) {
         import.meta.hot!.send('aipeek:result', { id: msg.id, ...result })
     })
 
-    // eval: run server-supplied code in the page. Wrapped in an async IIFE so the
-    // code can `await` and use `return`; non-string results are JSON-stringified.
+    // eval: run server-supplied code in the page with auto-return (see runEval).
     import.meta.hot.on('aipeek:eval', async (msg: { id: number, code: string, requireVisible?: boolean }) => {
         if (skip(msg))
             return
-        let ok = true
-        let value: string | undefined
-        let error: string | undefined
-        try {
-            // eslint-disable-next-line no-new-func
-            const fn = new Function(`return (async () => { ${msg.code} })()`)
-            const result = await fn()
-            value = typeof result === 'string' ? result : JSON.stringify(result, null, 2)
-        }
-        catch (e) {
-            ok = false
-            error = e instanceof Error ? `${e.message}\n${e.stack ?? ''}` : String(e)
-        }
+        const { ok, value, error } = await runEval(msg.code)
         import.meta.hot!.send('aipeek:eval-result', { id: msg.id, ok, value, error })
     })
 

package/src/core/action.ts

@@ -57,7 +57,7 @@ export function resolveAction(type: string, args: ActionArgs): { valid: boolean,
 
 // --- Browser-side execution (client.ts only) ---
 
-export const INTERACTIVE = 'a, button, input, textarea, select, [role], [onclick], [tabindex], [contenteditable]'
+export const INTERACTIVE = 'a, button, input, textarea, select, [role], [onclick], [tabindex], [contenteditable], [aria-label]'
 
 function visibleText(el: Element): string {
     const aria = el.getAttribute('aria-label')
@@ -114,6 +114,59 @@ export async function performAction(type: ActionType, args: ActionArgs): Promise
     }
 }
 
+export interface EvalResult { ok: boolean, value?: string, error?: string }
+
+// Run server-supplied JS in the page with auto-return (Chrome-console / Node-REPL
+// ergonomics): try the whole code as a single expression first so `qsa(...).length`
+// or `1+1` yield a value without an explicit `return`. If that fails to *compile*
+// (multi-statement, contains `return`, etc.) fall back to a plain statement block.
+// A compile error only swaps the wrapper; a runtime throw surfaces as the error.
+// undefined results are dropped (no value); objects are JSON-stringified.
+export async function runEval(code: string): Promise<EvalResult> {
+    try {
+        let fn: () => Promise<unknown>
+        try {
+            // eslint-disable-next-line no-new-func
+            fn = new Function(`return (async () => (${code}))()`) as () => Promise<unknown>
+        }
+        catch {
+            // eslint-disable-next-line no-new-func
+            fn = new Function(`return (async () => { ${code} })()`) as () => Promise<unknown>
+        }
+        const result = await fn()
+        const value = result === undefined ? undefined : typeof result === 'string' ? result : JSON.stringify(result, null, 2)
+        return { ok: true, value }
+    }
+    catch (e) {
+        return { ok: false, error: e instanceof Error ? `${e.message}\n${e.stack ?? ''}` : String(e) }
+    }
+}
+
+// Native alert/confirm/prompt are *synchronous* and freeze the whole JS thread until
+// a human dismisses them — which deadlocks the probe (it runs on that same thread, so
+// the HMR channel can never answer and every curl times out). A click that hits a
+// `copy-to-clipboard` fallback or a `confirm("delete?")` would hang aipeek forever.
+// So we stub them for the duration of `fn`: auto-answer (confirm→true, prompt→default,
+// alert→noop) and return what was suppressed so the caller can report it. Always
+// restored in finally — the page's own dialogs work again after the action settles.
+export async function withDialogGuard<T>(fn: () => Promise<T>): Promise<{ result: T, dialogs: string[] }> {
+    const realAlert = window.alert
+    const realConfirm = window.confirm
+    const realPrompt = window.prompt
+    const dialogs: string[] = []
+    window.alert = (m?: unknown) => { dialogs.push(`alert: ${String(m ?? '')}`.slice(0, 80)) }
+    window.confirm = (m?: unknown) => { dialogs.push(`confirm→true: ${String(m ?? '')}`.slice(0, 80)); return true }
+    window.prompt = (m?: unknown, d?: string) => { dialogs.push(`prompt→default: ${String(m ?? '')}`.slice(0, 80)); return d ?? '' }
+    try {
+        return { result: await fn(), dialogs }
+    }
+    finally {
+        window.alert = realAlert
+        window.confirm = realConfirm
+        window.prompt = realPrompt
+    }
+}
+
 // Click like a human, not like el.click(). A real click is a *position* the browser
 // hit-tests, then a full event sequence at that point — hover, pointerdown/mousedown,
 // browser-decided focus, pointerup/mouseup, click. Two things matter that el.click()