hunter-mate 0.1.7 → 0.1.11

package/dist/assets/extension/background/service-worker.js

@@ -1,5 +1,5 @@
 // src/shared/messaging.ts
-var SERVER_PORT = 34570;
+var SERVER_PORT = 34571;
 var WS_URL = `ws://localhost:${SERVER_PORT}/ws`;
 var SERVER_HTTP_URL = `http://localhost:${SERVER_PORT}`;
 
@@ -505,6 +505,19 @@ function runControl(command, args) {
   }
   function goto(gotoArgs) {
     if (!gotoArgs.url) return { error: "url_required" };
+    let sameUrl = false;
+    try {
+      sameUrl = new URL(gotoArgs.url, window.location.href).href === window.location.href;
+    } catch {
+      sameUrl = false;
+    }
+    if (sameUrl) {
+      if (gotoArgs.reload === true) {
+        window.location.reload();
+        return { navigated: true, reloaded: true, url: gotoArgs.url };
+      }
+      return { navigated: false, reused: true, url: gotoArgs.url };
+    }
     window.location.href = gotoArgs.url;
     return { navigated: true, url: gotoArgs.url };
   }
@@ -986,13 +999,32 @@ globalThis.__cpRunControl = runControl;
 globalThis.__cpRuntimeVersion = RUNTIME_VERSION;
 
 // src/generated/control-runtime-source.ts
-var control_runtime_source_default = '"use strict";\n(() => {\n  // src/shared/control-runtime.ts\n  function getRefStore() {\n    const g = globalThis;\n    if (!g.__cpRefs) {\n      g.__cpRefs = { counter: 1, refs: /* @__PURE__ */ new Map(), cssPaths: /* @__PURE__ */ new Map() };\n    }\n    return g.__cpRefs;\n  }\n  function allocRef(el) {\n    const store = getRefStore();\n    for (const [ref2, existing] of store.refs) {\n      if (existing === el) return ref2;\n    }\n    const ref = store.counter++;\n    store.refs.set(ref, el);\n    store.cssPaths.set(ref, uniqueCssPath(el));\n    return ref;\n  }\n  function uniqueCssPath(el) {\n    if (el.id) return `#${CSS.escape(el.id)}`;\n    const parts = [];\n    let cur = el;\n    while (cur && cur !== document.body && cur !== document.documentElement) {\n      let sel = cur.tagName.toLowerCase();\n      if (cur.id) {\n        parts.unshift(`#${CSS.escape(cur.id)}`);\n        break;\n      }\n      const parent = cur.parentElement;\n      if (parent) {\n        const sameTag = Array.from(parent.children).filter((c) => c.tagName === cur.tagName);\n        if (sameTag.length > 1) {\n          const idx = sameTag.indexOf(cur) + 1;\n          sel += `:nth-of-type(${idx})`;\n        }\n      }\n      parts.unshift(sel);\n      cur = parent;\n    }\n    return parts.join(" > ");\n  }\n  function err(code, message, extra) {\n    return { error: { code, message, ...extra || {} } };\n  }\n  var ERROR_CODES = {\n    NOT_FOUND: "not_found",\n    STALE_REF: "stale_ref",\n    INVALID_SELECTOR: "invalid_selector",\n    SELECTOR_NOT_FOUND: "selector_not_found",\n    SELECTOR_AMBIGUOUS: "selector_ambiguous",\n    SELECTOR_NTH_OUT_OF_RANGE: "selector_nth_out_of_range",\n    OPTION_NOT_FOUND: "option_not_found",\n    NOT_A_SELECT: "not_a_select"\n  };\n  var IMPLICIT_ROLE = {\n    a: "link",\n    button: "button",\n    select: "combobox",\n    textarea: "textbox",\n    h1: "heading",\n    h2: "heading",\n    h3: "heading",\n    h4: "heading",\n    h5: "heading",\n    h6: "heading",\n    img: "img",\n    nav: "navigation",\n    ul: "list",\n    ol: "list",\n    li: "listitem",\n    main: "main",\n    article: "article",\n    aside: "complementary",\n    header: "banner",\n    footer: "contentinfo",\n    form: "form",\n    table: "table",\n    summary: "button",\n    option: "option",\n    output: "status"\n  };\n  function roleOf(el) {\n    const explicit = el.getAttribute("role");\n    if (explicit) return explicit.split(/\\s+/)[0];\n    const tag = el.tagName.toLowerCase();\n    if (tag === "input") {\n      const type = el.type || "text";\n      if (type === "hidden") return null;\n      if (type === "checkbox") return "checkbox";\n      if (type === "radio") return "radio";\n      if (type === "button" || type === "submit" || type === "reset") return "button";\n      if (type === "range") return "slider";\n      return "textbox";\n    }\n    if (tag === "progress") return "progressbar";\n    if (tag === "meter") return "meter";\n    return IMPLICIT_ROLE[tag] ?? null;\n  }\n  function accessibleName(el) {\n    const aria = el.getAttribute("aria-label");\n    if (aria) return aria.trim();\n    const labelledby = el.getAttribute("aria-labelledby");\n    if (labelledby) {\n      const parts = labelledby.split(/\\s+/).map((id2) => document.getElementById(id2)?.textContent?.trim() || "");\n      const joined = parts.filter(Boolean).join(" ");\n      if (joined) return joined.slice(0, 120);\n    }\n    const id = el.getAttribute("id");\n    if (id) {\n      const label = document.querySelector(`label[for="${CSS.escape(id)}"]`);\n      if (label?.textContent?.trim()) return label.textContent.trim().slice(0, 120);\n    }\n    if (el.tagName.toLowerCase() === "input") {\n      const type = el.type;\n      if (type === "button" || type === "submit" || type === "reset") {\n        const v = el.value;\n        if (v) return v;\n      }\n    }\n    const alt = el.getAttribute("alt");\n    if (alt) return alt;\n    const title = el.getAttribute("title");\n    if (title) return title;\n    const placeholder = el.getAttribute("placeholder");\n    if (placeholder) return placeholder;\n    return (el.textContent || "").replace(/\\s+/g, " ").trim().slice(0, 120);\n  }\n  function isVisible(el) {\n    if (!(el instanceof HTMLElement) && !(el instanceof SVGElement)) return false;\n    const html = el;\n    if (html.hasAttribute("hidden")) return false;\n    if (html.closest("[hidden]")) return false;\n    const style = window.getComputedStyle(html);\n    if (style.display === "none" || style.visibility === "hidden" || style.opacity === "0") return false;\n    if (el instanceof HTMLElement && el.offsetParent === null) {\n      const pos = style.position;\n      if (pos !== "fixed" && pos !== "sticky") return false;\n    }\n    return true;\n  }\n  var INTERACTIVE_SELECTOR = "a[href], button, input, textarea, select, summary, [role], [contenteditable=\'\'], [contenteditable=\'true\'], [onclick], [tabindex]";\n  function isInteractive(el) {\n    return el.matches(INTERACTIVE_SELECTOR);\n  }\n  function testidSelector(testid) {\n    return `[data-testid="${CSS.escape(testid)}"], [data-test-id="${CSS.escape(testid)}"], [data-test="${CSS.escape(testid)}"], [data-cy="${CSS.escape(testid)}"]`;\n  }\n  function resolveTargetRich(sel) {\n    const targetDesc = sel.ref != null ? String(sel.ref) : sel.css ?? (sel.role || sel.name || sel.label || sel.testid || sel.text ? `${sel.role ? `role=${sel.role} ` : ""}${sel.name ? `name=${sel.name} ` : ""}${sel.label ? `label=${sel.label} ` : ""}${sel.testid ? `testid=${sel.testid} ` : ""}${sel.text ? `text=${sel.text}` : ""}`.trim() : "");\n    if (sel.ref != null) {\n      const store = getRefStore();\n      const el = store.refs.get(sel.ref);\n      if (el && document.contains(el) && isVisible(el)) {\n        return { el, matches_n: 1, match_level: "exact", target: targetDesc };\n      }\n      if (el && !document.contains(el)) {\n        const cssPath = store.cssPaths.get(sel.ref);\n        if (cssPath) {\n          const re = document.querySelector(cssPath);\n          if (re && isVisible(re)) {\n            store.refs.set(sel.ref, re);\n            return { el: re, matches_n: 1, match_level: "reidentified", target: targetDesc };\n          }\n        }\n        return { errorEnvelope: err(ERROR_CODES.STALE_REF, "Numeric ref is no longer in the DOM. Re-run state.") };\n      }\n      return { errorEnvelope: err(ERROR_CODES.NOT_FOUND, "Numeric ref is no longer in the DOM. Re-run state.") };\n    }\n    let candidates = [];\n    if (sel.css) {\n      try {\n        candidates = Array.from(document.querySelectorAll(sel.css));\n      } catch {\n        return { errorEnvelope: err(ERROR_CODES.INVALID_SELECTOR, "CSS was rejected by querySelectorAll.", { selector: sel.css }) };\n      }\n      if (candidates.length === 0) {\n        return { errorEnvelope: err(ERROR_CODES.SELECTOR_NOT_FOUND, "CSS matches 0 elements.", { selector: sel.css, candidates: suggestCandidates() }) };\n      }\n    } else if (sel.testid) {\n      try {\n        candidates = Array.from(document.querySelectorAll(testidSelector(sel.testid)));\n      } catch {\n        return { errorEnvelope: err(ERROR_CODES.INVALID_SELECTOR, "Invalid testid.", { testid: sel.testid }) };\n      }\n    } else if (sel.role || sel.name || sel.label || sel.text) {\n      const wantRole = sel.role ? sel.role.toLowerCase() : null;\n      const wantName = sel.name ? sel.name.toLowerCase() : null;\n      const wantText = sel.text ? sel.text.toLowerCase() : null;\n      let labelTargets = [];\n      if (sel.label) {\n        const lower = sel.label.toLowerCase();\n        labelTargets = Array.from(document.querySelectorAll("label")).filter((l) => (l.textContent || "").trim().toLowerCase().includes(lower)).map((l) => {\n          const forId = l.getAttribute("for");\n          if (forId) return document.getElementById(forId);\n          return l.querySelector("input, select, textarea");\n        }).filter((x) => !!x);\n      }\n      const all = Array.from(document.querySelectorAll("*"));\n      candidates = all.filter((el) => {\n        if (!isVisible(el)) return false;\n        const role = roleOf(el);\n        if (wantRole && (!role || role.toLowerCase() !== wantRole)) return false;\n        if (wantName) {\n          const name = accessibleName(el).toLowerCase();\n          if (!name.includes(wantName)) return false;\n        }\n        if (wantText) {\n          const t = (el.textContent || "").replace(/\\s+/g, " ").trim().toLowerCase();\n          if (!t.includes(wantText)) return false;\n        }\n        return true;\n      });\n      if (labelTargets.length) {\n        const set = new Set(labelTargets);\n        candidates = labelTargets.concat(candidates.filter((c) => !set.has(c)));\n      }\n      if (candidates.length === 0) {\n        return {\n          errorEnvelope: err(\n            ERROR_CODES.SELECTOR_NOT_FOUND,\n            "Semantic locator matches 0 elements.",\n            { role: sel.role, name: sel.name, label: sel.label, text: sel.text, candidates: suggestCandidates() }\n          )\n        };\n      }\n    } else {\n      return { errorEnvelope: err("no_target", "Provide a numeric ref, CSS selector, or semantic locator (--role/--name/--label/--text/--testid).") };\n    }\n    const visible = candidates.filter(isVisible);\n    const pool = visible.length ? visible : candidates;\n    if (sel.nth != null) {\n      if (sel.nth < 0 || sel.nth >= pool.length) {\n        return { errorEnvelope: err(ERROR_CODES.SELECTOR_NTH_OUT_OF_RANGE, `--nth ${sel.nth} beyond match count ${pool.length}.`) };\n      }\n      const el = pool[sel.nth];\n      return { el, matches_n: pool.length, match_level: "reidentified", target: targetDesc };\n    }\n    if (pool.length > 1) {\n      return {\n        errorEnvelope: err(ERROR_CODES.SELECTOR_AMBIGUOUS, `CSS matches ${pool.length} elements and no --nth given.`, {\n          matches_n: pool.length,\n          candidates: pool.slice(0, 5).map((el) => uniqueCssPath(el))\n        })\n      };\n    }\n    return { el: pool[0], matches_n: 1, match_level: "reidentified", target: targetDesc };\n  }\n  function suggestCandidates() {\n    const store = getRefStore();\n    const recent = Array.from(store.refs.entries()).slice(-5).map(([, el]) => uniqueCssPath(el));\n    return recent;\n  }\n  function compoundOf(el) {\n    const tag = el.tagName.toLowerCase();\n    if (tag === "input") {\n      const input = el;\n      const type = input.type;\n      if (["date", "time", "datetime-local", "month", "week"].includes(type)) {\n        const formatMap = {\n          date: "YYYY-MM-DD",\n          time: "HH:mm",\n          "datetime-local": "YYYY-MM-DDTHH:mm",\n          month: "YYYY-MM",\n          week: "YYYY-Www"\n        };\n        return {\n          control: type,\n          format: formatMap[type] ?? type,\n          current: input.value || "",\n          min: input.min || null,\n          max: input.max || null\n        };\n      }\n      if (type === "file") {\n        const current = Array.from(input.files ?? []).map((f) => f.name);\n        return { control: "file", multiple: input.multiple, current, accept: input.accept || null };\n      }\n      return null;\n    }\n    if (tag === "select") {\n      const select = el;\n      const options = Array.from(select.options).slice(0, 50).map((o) => ({\n        label: (o.textContent || "").trim(),\n        value: o.value,\n        selected: o.selected\n      }));\n      return {\n        control: "select",\n        multiple: select.multiple,\n        current: select.selectedOptions[0] ? (select.selectedOptions[0].textContent || "").trim() : "",\n        options,\n        options_total: select.options.length\n      };\n    }\n    return null;\n  }\n  var SKIP_TAGS = /* @__PURE__ */ new Set(["script", "style", "noscript", "meta", "link", "head", "base", "template", "path", "circle", "rect", "g", "defs", "polygon", "line"]);\n  function describeElement(el, ref) {\n    const tag = el.tagName.toLowerCase();\n    const role = el.getAttribute("role") ?? null;\n    const name = accessibleName(el);\n    const parts = [];\n    if (ref != null) parts.push(`[${ref}]`);\n    parts.push(tag);\n    if (role && role !== IMPLICIT_ROLE[tag]) parts.push(`role=${role}`);\n    if (tag === "input") {\n      const input = el;\n      if (input.type && input.type !== "text") parts.push(`[${input.type}]`);\n      if (input.disabled) parts.push("(disabled)");\n    }\n    if (name) parts.push(JSON.stringify(name.length > 60 ? name.slice(0, 57) + "\\u2026" : name));\n    if (tag === "a") {\n      const href = el.getAttribute("href");\n      if (href) parts.push(`\\u2192 ${href.slice(0, 50)}`);\n    }\n    if (el.disabled) parts.push("(disabled)");\n    return parts.join(" ");\n  }\n  function buildStateTree() {\n    const lines = [];\n    const compounds = {};\n    const budget = { nodes: 0, chars: 0, truncated: false };\n    const MAX_NODES = 400;\n    const MAX_CHARS = 9e3;\n    let hiddenInteractive = 0;\n    function emit(depth, text) {\n      const line = "  ".repeat(Math.min(depth, 12)) + text;\n      lines.push(line);\n      budget.chars += line.length;\n    }\n    function walk(el, depth) {\n      if (budget.nodes >= MAX_NODES || budget.chars >= MAX_CHARS) {\n        budget.truncated = true;\n        return;\n      }\n      const tag = el.tagName.toLowerCase();\n      if (SKIP_TAGS.has(tag)) return;\n      budget.nodes++;\n      const visible = isVisible(el);\n      const interactive = isInteractive(el);\n      if (interactive) {\n        if (visible) {\n          const ref = allocRef(el);\n          emit(depth, describeElement(el, ref));\n          const compound = compoundOf(el);\n          if (compound) compounds[String(ref)] = compound;\n        } else {\n          hiddenInteractive++;\n          return;\n        }\n      } else if (visible) {\n        if (/^h[1-6]$/.test(tag)) {\n          const t = accessibleName(el);\n          if (t) emit(depth, `${"#".repeat(Number(tag[1]))} ${t}`);\n        } else if (tag === "p" || tag === "li" || tag === "td" || tag === "th" || tag === "figcaption" || tag === "blockquote") {\n          const ownText = ownTextOf(el);\n          if (ownText) emit(depth, ownText.slice(0, 100));\n        } else if (tag === "img") {\n          const alt = el.getAttribute("alt") || "";\n          if (alt) emit(depth, `img ${JSON.stringify(alt.slice(0, 60))}`);\n        }\n      }\n      if (depth < 14) {\n        for (const child of Array.from(el.children)) {\n          walk(child, depth + 1);\n          if (budget.truncated) return;\n        }\n      }\n    }\n    function ownTextOf(el) {\n      let text = "";\n      for (const node of Array.from(el.childNodes)) {\n        if (node.nodeType === Node.TEXT_NODE) text += node.textContent || "";\n      }\n      return text.replace(/\\s+/g, " ").trim();\n    }\n    const root = document.querySelector("main") || document.querySelector("#root") || document.body;\n    emit(0, `# ${document.title}`);\n    walk(root, 0);\n    const scrollable = document.documentElement.scrollHeight > window.innerHeight + 200;\n    if (scrollable) {\n      emit(0, "\\u2195 page is scrollable \\u2014 run cp.scroll down to reveal more");\n    }\n    if (hiddenInteractive > 0) {\n      emit(0, `\\u2139 ${hiddenInteractive} hidden interactive element(s) not tagged`);\n    }\n    if (budget.truncated) {\n      emit(0, "\\u2026 (snapshot truncated by budget \\u2014 narrow with a selector or scroll)");\n    }\n    return {\n      url: location.href,\n      title: document.title,\n      text: lines.join("\\n"),\n      compounds,\n      hints: { scroll: scrollable, hidden_interactive: hiddenInteractive },\n      truncated: budget.truncated\n    };\n  }\n  function runControl(command, args) {\n    const a = args || {};\n    function getVisibleText(el) {\n      return (el.textContent || "").trim().replace(/\\s+/g, " ").slice(0, 120);\n    }\n    function getAttrs(el) {\n      const attrs = {};\n      for (const name of ["id", "class", "name", "type", "href", "src", "placeholder", "value", "role", "aria-label", "data-testid"]) {\n        attrs[name] = el.getAttribute(name);\n      }\n      return attrs;\n    }\n    function sel() {\n      return {\n        ref: a.ref,\n        css: a.css,\n        nth: a.nth,\n        role: a.role,\n        name: a.name,\n        label: a.label,\n        text: a.text,\n        testid: a.testid\n      };\n    }\n    function findElements(findArgs) {\n      const limit = findArgs.limit ?? 20;\n      const textMax = findArgs["text-max"] ?? 120;\n      let elements = [];\n      if (findArgs.css) {\n        try {\n          elements = Array.from(document.querySelectorAll(findArgs.css));\n        } catch {\n          return err(ERROR_CODES.INVALID_SELECTOR, "CSS was rejected by querySelectorAll.", { selector: findArgs.css });\n        }\n      } else if (findArgs.testid) {\n        try {\n          elements = Array.from(document.querySelectorAll(testidSelector(findArgs.testid)));\n        } catch {\n          return err(ERROR_CODES.INVALID_SELECTOR, "Invalid testid.");\n        }\n      } else if (findArgs.role || findArgs.name || findArgs.label) {\n        const r = resolveTargetRich({ role: findArgs.role, name: findArgs.name, label: findArgs.label, text: findArgs.text });\n        if ("errorEnvelope" in r) return r.errorEnvelope;\n        elements = document.querySelectorAll("*").length ? semanticCandidates(findArgs) : [];\n      } else if (findArgs.text) {\n        const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);\n        const lower = findArgs.text.toLowerCase();\n        const seen = /* @__PURE__ */ new Set();\n        let node;\n        while (node = walker.nextNode()) {\n          if (node.textContent?.toLowerCase().includes(lower)) {\n            const el = node.parentElement;\n            if (el && !seen.has(el)) {\n              seen.add(el);\n              elements.push(el);\n              if (elements.length >= limit) break;\n            }\n          }\n        }\n      } else {\n        elements = Array.from(document.querySelectorAll(INTERACTIVE_SELECTOR));\n      }\n      const out = elements.slice(0, limit).map((el, i) => {\n        const ref = allocRef(el);\n        return {\n          nth: i,\n          ref,\n          tag: el.tagName.toLowerCase(),\n          role: roleOf(el),\n          text: getVisibleText(el).slice(0, textMax),\n          attrs: getAttrs(el),\n          visible: isVisible(el),\n          compound: compoundOf(el) ?? void 0\n        };\n      });\n      return out;\n    }\n    function semanticCandidates(findArgs) {\n      const wantRole = findArgs.role ? findArgs.role.toLowerCase() : null;\n      const wantName = findArgs.name ? findArgs.name.toLowerCase() : null;\n      const wantText = findArgs.text ? findArgs.text.toLowerCase() : null;\n      const all = Array.from(document.querySelectorAll("*"));\n      return all.filter((el) => {\n        if (!isVisible(el)) return false;\n        if (wantRole) {\n          const role = roleOf(el);\n          if (!role || role.toLowerCase() !== wantRole) return false;\n        }\n        if (wantName && !accessibleName(el).toLowerCase().includes(wantName)) return false;\n        if (wantText && !(el.textContent || "").toLowerCase().includes(wantText)) return false;\n        return true;\n      });\n    }\n    function pageState() {\n      return {\n        url: location.href,\n        title: document.title,\n        width: window.innerWidth,\n        height: window.innerHeight,\n        devicePixelRatio: window.devicePixelRatio\n      };\n    }\n    function goto(gotoArgs) {\n      if (!gotoArgs.url) return { error: "url_required" };\n      window.location.href = gotoArgs.url;\n      return { navigated: true, url: gotoArgs.url };\n    }\n    function evalScript(evalArgs) {\n      if (!evalArgs.script) return { error: "script_required" };\n      try {\n        const fn = new Function(evalArgs.script);\n        const result = fn();\n        return { result };\n      } catch (e) {\n        return { error: String(e) };\n      }\n    }\n    function fillElement(fArgs) {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      const input = el;\n      if (el.tagName === "INPUT" || el.tagName === "TEXTAREA" || el.isContentEditable) {\n        const isContentEditable = el.isContentEditable;\n        if (isContentEditable) {\n          el.innerText = fArgs.text ?? "";\n        } else {\n          input.value = fArgs.text ?? "";\n        }\n        input.dispatchEvent(new Event("input", { bubbles: true }));\n        input.dispatchEvent(new Event("change", { bubbles: true }));\n        const actual = isContentEditable ? el.innerText : input.value;\n        return actual === (fArgs.text ?? "") ? { filled: true, verified: true, text: fArgs.text, actual, target, matches_n, match_level } : err("verify_failed", "Input value diverged after fill (controlled component?).", { actual });\n      }\n      return err("invalid_type", "fill only supports input, textarea, and contenteditable.");\n    }\n    function typeElement(tArgs) {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      const input = el;\n      el.focus({ preventScroll: true });\n      input.value = tArgs.text ?? "";\n      input.dispatchEvent(new Event("input", { bubbles: true }));\n      input.dispatchEvent(new Event("change", { bubbles: true }));\n      let autocomplete = false;\n      try {\n        autocomplete = !!document.querySelector("[role=\'listbox\'], [role=\'combobox\'] [role=\'listbox\'], datalist, .ant-select-dropdown:not([style*=\'hidden\']), [id^=\'listbox\']");\n      } catch {\n      }\n      return { typed: true, text: tArgs.text, target, matches_n, match_level, autocomplete };\n    }\n    function clickElement() {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      el.scrollIntoView({ block: "center" });\n      el.click();\n      return { clicked: true, target, matches_n, match_level, tag: el.tagName.toLowerCase(), text: getVisibleText(el) };\n    }\n    function selectElement(sArgs) {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      if (el.tagName !== "SELECT") {\n        return err(ERROR_CODES.NOT_A_SELECT, "select was called on a non-<select> element.", { tag: el.tagName.toLowerCase() });\n      }\n      const select = el;\n      const want = sArgs.label ?? sArgs.value ?? sArgs.option;\n      if (!want) return err("option_required", "Provide label or value.");\n      const byLabel = Array.from(select.options).find((o) => (o.textContent || "").trim() === want);\n      const byValue = Array.from(select.options).find((o) => o.value === want);\n      const opt = byLabel ?? byValue;\n      if (!opt) {\n        const available = Array.from(select.options).slice(0, 50).map((o) => (o.textContent || "").trim());\n        return err(ERROR_CODES.OPTION_NOT_FOUND, "Option not found.", { available });\n      }\n      select.value = opt.value;\n      select.dispatchEvent(new Event("input", { bubbles: true }));\n      select.dispatchEvent(new Event("change", { bubbles: true }));\n      return { selected: true, value: select.value, target, matches_n, match_level };\n    }\n    function pressKeys(kArgs) {\n      const keyCombo = kArgs.keys ?? kArgs.key ?? "";\n      if (!keyCombo) return { error: "keys_required" };\n      const comboParts = keyCombo.split("+").map((s) => s.trim());\n      const main = comboParts[comboParts.length - 1];\n      const ctrl = comboParts.includes("Control") || comboParts.includes("Ctrl") || comboParts.includes("Meta") || comboParts.includes("Cmd");\n      const alt = comboParts.includes("Alt");\n      const shift = comboParts.includes("Shift");\n      const target = document.activeElement ?? document.body;\n      const opts = { key: main, bubbles: true, cancelable: true, ctrlKey: ctrl, altKey: alt, shiftKey: shift, metaKey: comboParts.includes("Meta") || comboParts.includes("Cmd") };\n      target.dispatchEvent(new KeyboardEvent("keydown", opts));\n      target.dispatchEvent(new KeyboardEvent("keypress", opts));\n      target.dispatchEvent(new KeyboardEvent("keyup", opts));\n      return { pressed: true, key: keyCombo };\n    }\n    function hoverElement() {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      const rect = el.getBoundingClientRect();\n      const opts = { bubbles: true, cancelable: true, clientX: rect.x + rect.width / 2, clientY: rect.y + rect.height / 2 };\n      el.dispatchEvent(new MouseEvent("mouseover", opts));\n      el.dispatchEvent(new MouseEvent("mousemove", opts));\n      return { hovered: true, target, matches_n, match_level };\n    }\n    function focusElement() {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      el.focus({ preventScroll: true });\n      return { focused: true, target, matches_n, match_level };\n    }\n    function dblclickElement() {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      el.dispatchEvent(new MouseEvent("dblclick", { bubbles: true, cancelable: true }));\n      return { dblclicked: true, target, matches_n, match_level };\n    }\n    function setChecked(want) {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      const input = el;\n      const isAria = input.type !== "checkbox" && input.type !== "radio" && el.getAttribute("aria-checked") != null;\n      if (!isAria && input.type !== "checkbox" && input.type !== "radio") {\n        return err("invalid_type", "Target is not a checkbox/radio/aria-checked control.", { tag: el.tagName.toLowerCase() });\n      }\n      if (isAria) {\n        el.setAttribute("aria-checked", String(want));\n        el.dispatchEvent(new Event("change", { bubbles: true }));\n        return { [want ? "checked" : "unchecked"]: true, changed: true, target, matches_n, match_level, kind: "aria" };\n      }\n      if (input.type === "radio" && !want) {\n        return err("invalid_type", "Radio buttons cannot be unchecked directly; select another radio in the group.");\n      }\n      const changed = input.checked !== want;\n      input.checked = want;\n      input.dispatchEvent(new Event("input", { bubbles: true }));\n      input.dispatchEvent(new Event("change", { bubbles: true }));\n      return { [want ? "checked" : "unchecked"]: true, changed, target, matches_n, match_level, kind: input.type };\n    }\n    function scrollElement(sArgs) {\n      const dir = sArgs.direction ?? "down";\n      const amount = sArgs.amount ?? 500;\n      if (dir !== "up" && dir !== "down") return { error: "invalid_direction" };\n      const dy = dir === "down" ? amount : -amount;\n      window.scrollBy({ top: dy, behavior: "instant" });\n      return {\n        scrolled: true,\n        direction: dir,\n        amount,\n        scrollY: Math.round(window.scrollY),\n        scrollHeight: document.documentElement.scrollHeight\n      };\n    }\n    function backNav() {\n      history.back();\n      return { back: true };\n    }\n    function htmlJsonTree(el, depth, maxDepth, childrenMax, textMax, truncated) {\n      const children = Array.from(el.children);\n      const ownText = (el.textContent || "").replace(/\\s+/g, " ").trim();\n      const node = {\n        tag: el.tagName.toLowerCase(),\n        attrs: getAttrs(el),\n        text: ownText.length > textMax ? (ownText.slice(0, textMax), truncated.text_truncated = (truncated.text_truncated || 0) + 1, ownText.slice(0, textMax)) : ownText,\n        children: [],\n        compound: compoundOf(el) ?? void 0\n      };\n      if (depth < maxDepth) {\n        let kids = children;\n        if (children.length > childrenMax) {\n          truncated.children_dropped = (truncated.children_dropped || 0) + (children.length - childrenMax);\n          kids = children.slice(0, childrenMax);\n        }\n        node.children = kids.map((c) => htmlJsonTree(c, depth + 1, maxDepth, childrenMax, textMax, truncated));\n      } else if (children.length) {\n        truncated.depth = (truncated.depth || 0) + 1;\n      }\n      return node;\n    }\n    function getElement(gArgs) {\n      const what = gArgs.what ?? "text";\n      if (what === "title") return { value: document.title, matches_n: 1, match_level: "exact" };\n      if (what === "url") return { value: location.href, matches_n: 1, match_level: "exact" };\n      if (what === "html") {\n        if (gArgs["as"] === "json") {\n          const root2 = gArgs.css ? document.querySelector(gArgs.css) : document.body;\n          if (!root2) return err(ERROR_CODES.SELECTOR_NOT_FOUND, "CSS matches 0 elements.", { selector: gArgs.css });\n          const truncated = {};\n          const tree = htmlJsonTree(root2, 0, gArgs.depth ?? 6, gArgs["children-max"] ?? 20, gArgs["text-max"] ?? 200, truncated);\n          return {\n            value: tree,\n            truncated: Object.keys(truncated).length ? truncated : void 0\n          };\n        }\n        const root = gArgs.css ? document.querySelector(gArgs.css) : document.body;\n        if (!root) return err(ERROR_CODES.SELECTOR_NOT_FOUND, "CSS matches 0 elements.", { selector: gArgs.css });\n        let html = root.outerHTML;\n        if (gArgs.max && html.length > gArgs.max) html = html.slice(0, gArgs.max) + "\\u2026";\n        return { value: html };\n      }\n      const r = resolveTargetRich(gArgs);\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level } = r;\n      switch (what) {\n        case "text": {\n          const t = getVisibleText(el);\n          return { value: t.length > 2e3 ? t.slice(0, 2e3) : t, matches_n, match_level };\n        }\n        case "value":\n          return { value: el.value ?? el.innerText ?? null, matches_n, match_level };\n        case "attributes":\n          return { value: getAttrs(el), matches_n, match_level };\n        default:\n          return { error: `unknown_what: ${what}` };\n      }\n    }\n    function extractMarkdown(eArgs) {\n      const chunkSize = eArgs["chunk-size"] ?? 0;\n      const start = eArgs.start ?? 0;\n      const scope = eArgs.selector ? document.querySelector(eArgs.selector) : document.querySelector("main") || document.querySelector("article") || document.body;\n      if (!scope) return { error: "scope_not_found" };\n      const parts = [];\n      const walker = document.createTreeWalker(scope, NodeFilter.SHOW_ELEMENT);\n      let node;\n      while (node = walker.nextNode()) {\n        const el = node;\n        const tag = el.tagName.toLowerCase();\n        const text = getVisibleText(el);\n        if (!text) continue;\n        if (tag === "h1") parts.push(`# ${text}`);\n        else if (tag === "h2") parts.push(`## ${text}`);\n        else if (tag === "h3") parts.push(`### ${text}`);\n        else if (tag === "p" || tag === "li") parts.push(text);\n        else if (tag === "a") parts.push(`[${text}](${el.getAttribute("href") ?? ""})`);\n      }\n      const full = parts.join("\\n\\n");\n      const sliced = chunkSize > 0 ? full.slice(start, start + chunkSize) : full.slice(start);\n      return {\n        url: location.href,\n        title: document.title,\n        selector: eArgs.selector ?? "auto",\n        total_chars: full.length,\n        chunk_size: chunkSize,\n        start,\n        end: start + sliced.length,\n        next_start_char: start + sliced.length < full.length ? start + sliced.length : null,\n        content: sliced\n      };\n    }\n    function listFrames() {\n      const frames = Array.from(document.querySelectorAll("iframe")).map((f, index) => {\n        const src = f.getAttribute("src") ?? "";\n        let crossOrigin = false;\n        try {\n          if (src && /^https?:/.test(src)) crossOrigin = new URL(src, location.href).origin !== location.origin;\n        } catch {\n        }\n        return { index, url: src, name: f.getAttribute("name") ?? "", cross_origin: crossOrigin };\n      });\n      return { frames };\n    }\n    function screenshotMeta() {\n      return {\n        width: window.innerWidth,\n        height: window.innerHeight,\n        url: location.href,\n        title: document.title\n      };\n    }\n    function startTitleMarquee(tArgs) {\n      const g = globalThis;\n      if (g.__cpMarquee) {\n        clearInterval(g.__cpMarquee.interval);\n      } else {\n        g.__cpMarquee = { original: document.title, interval: 0 };\n      }\n      const prefix = tArgs.text ?? "\\u{1F916}";\n      const base = g.__cpMarquee.original;\n      const full = `${prefix} ${base}`;\n      const speed = Math.max(100, Math.min(2e3, tArgs.speed ?? 300));\n      let pos = 0;\n      const tick = () => {\n        const display = full.slice(pos) + "  " + full.slice(0, pos);\n        document.title = display.slice(0, 60);\n        pos = (pos + 1) % (full.length + 1 || 1);\n      };\n      tick();\n      g.__cpMarquee.interval = window.setInterval(tick, speed);\n      return { started: true, original: base, prefix, speed };\n    }\n    function stopTitleMarquee() {\n      const g = globalThis;\n      const state = g.__cpMarquee;\n      if (!state) return { restored: false, reason: "no_active_marquee" };\n      clearInterval(state.interval);\n      document.title = state.original;\n      delete g.__cpMarquee;\n      return { restored: true, original: state.original };\n    }\n    function networkEntriesLegacy(nArgs) {\n      const all = performance.getEntriesByType("resource").map((e) => ({\n        url: e.name,\n        type: e.initiatorType ?? "unknown",\n        duration: Math.round(e.duration)\n      }));\n      let entries = all;\n      if (nArgs.filter) {\n        const keywords = nArgs.filter.split(",").map((s) => s.trim().toLowerCase());\n        entries = all.filter((e) => keywords.some((kw) => e.url.toLowerCase().includes(kw)));\n      }\n      return { entries, count: entries.length, source: "performance-api" };\n    }\n    async function waitForCondition(wArgs) {\n      const timeout = wArgs.timeout ?? 1e4;\n      if (wArgs.time != null) {\n        await new Promise((res) => setTimeout(res, Math.min(wArgs.time * 1e3, 3e4)));\n        return { waited: true, kind: "time", seconds: wArgs.time };\n      }\n      const deadline = Date.now() + timeout;\n      const pollInterval = 200;\n      if (wArgs.selector) {\n        while (Date.now() < deadline) {\n          if (document.querySelector(wArgs.selector)) return { waited: true, kind: "selector", selector: wArgs.selector, elapsedMs: timeout - (deadline - Date.now()) };\n          await new Promise((res) => setTimeout(res, pollInterval));\n        }\n        return err("wait_timeout", `Selector not found within ${timeout}ms.`, { selector: wArgs.selector });\n      }\n      if (wArgs.text) {\n        const lower = wArgs.text.toLowerCase();\n        while (Date.now() < deadline) {\n          if ((document.body.textContent || "").toLowerCase().includes(lower)) {\n            return { waited: true, kind: "text", text: wArgs.text, elapsedMs: timeout - (deadline - Date.now()) };\n          }\n          await new Promise((res) => setTimeout(res, pollInterval));\n        }\n        return err("wait_timeout", `Text not found within ${timeout}ms.`, { text: wArgs.text });\n      }\n      return { error: "no_condition" };\n    }\n    function uploadFiles(uArgs) {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      const input = el;\n      if (input.type !== "file") return err("invalid_type", "Target is not an input[type=file].", { tag: el.tagName.toLowerCase() });\n      try {\n        const dt = new DataTransfer();\n        for (const name of uArgs.files ?? []) {\n          dt.items.add(new File([""], name.split("/").pop() || name));\n        }\n        input.files = dt.files;\n      } catch {\n      }\n      input.dispatchEvent(new Event("change", { bubbles: true }));\n      return {\n        uploaded: true,\n        files: uArgs.files ?? [],\n        file_names: (uArgs.files ?? []).map((f) => f.split("/").pop()),\n        target,\n        matches_n,\n        match_level,\n        multiple: input.multiple,\n        accept: input.accept || null\n      };\n    }\n    function dragElements(dArgs) {\n      const r1 = resolveTargetRich(sel());\n      if ("errorEnvelope" in r1) return r1.errorEnvelope;\n      const r2 = resolveTargetRich({ ref: dArgs.ref2, css: dArgs.css2 });\n      if ("errorEnvelope" in r2) return r2.errorEnvelope;\n      const src = r1.el;\n      const tgt = r2.el;\n      const make = (type) => {\n        const r1rect = src.getBoundingClientRect();\n        return new DragEvent(type, { bubbles: true, cancelable: true, clientX: r1rect.x + r1rect.width / 2, clientY: r1rect.y + r1rect.height / 2 });\n      };\n      src.dispatchEvent(make("dragstart"));\n      tgt.dispatchEvent(new DragEvent("dragenter", { bubbles: true }));\n      tgt.dispatchEvent(new DragEvent("dragover", { bubbles: true, cancelable: true }));\n      tgt.dispatchEvent(new DragEvent("drop", { bubbles: true, cancelable: true }));\n      src.dispatchEvent(new DragEvent("dragend", { bubbles: true }));\n      return { dragged: true, source: String(sel().ref ?? sel().css ?? ""), target: String(dArgs.ref2 ?? dArgs.css2 ?? ""), source_matches_n: r1.matches_n, target_matches_n: r2.matches_n };\n    }\n    switch (command) {\n      case "cp.state":\n        return a.tree === false ? pageState() : buildStateTree();\n      case "cp.snapshot":\n        return buildStateTree();\n      case "cp.find":\n        return findElements({\n          css: a.css,\n          text: a.text,\n          limit: a.limit,\n          role: a.role,\n          name: a.name,\n          label: a.label,\n          testid: a.testid,\n          "text-max": a["text-max"]\n        });\n      case "cp.click":\n        return clickElement();\n      case "cp.type":\n        return typeElement({ text: a.text });\n      case "cp.goto":\n        return goto({ url: a.url });\n      case "cp.eval":\n        return evalScript({ script: a.script });\n      case "cp.fill":\n        return fillElement({ text: a.text });\n      case "cp.select":\n        return selectElement({ label: a.label, value: a.value, option: a.option });\n      case "cp.keys":\n        return pressKeys({ keys: a.keys, key: a.key });\n      case "cp.hover":\n        return hoverElement();\n      case "cp.focus":\n        return focusElement();\n      case "cp.dblclick":\n        return dblclickElement();\n      case "cp.check":\n        return setChecked(true);\n      case "cp.uncheck":\n        return setChecked(false);\n      case "cp.scroll":\n        return scrollElement({ direction: a.direction, amount: a.amount });\n      case "cp.back":\n        return backNav();\n      case "cp.get":\n        return getElement({\n          what: a.what,\n          css: a.css,\n          ref: a.ref,\n          nth: a.nth,\n          "as": a["as"],\n          depth: a.depth,\n          "children-max": a["children-max"],\n          "text-max": a["text-max"],\n          max: a.max,\n          role: a.role,\n          name: a.name,\n          label: a.label,\n          text: a.text,\n          testid: a.testid\n        });\n      case "cp.extract":\n        return extractMarkdown({\n          "chunk-size": a["chunk-size"],\n          start: a.start,\n          selector: a.selector\n        });\n      case "cp.frames":\n        return listFrames();\n      case "cp.screenshot":\n        return screenshotMeta();\n      case "cp.network":\n        return networkEntriesLegacy({ filter: a.filter });\n      case "cp.wait":\n        return waitForCondition({\n          selector: a.selector,\n          text: a.text,\n          time: a.time,\n          timeout: a.timeout\n        });\n      case "cp.upload":\n        return uploadFiles({ files: a.files });\n      case "cp.drag":\n        return dragElements({ ref2: a.ref2, css2: a.css2 });\n      case "cp.title.marquee":\n        return startTitleMarquee({ text: a.text, speed: a.speed });\n      case "cp.title.restore":\n        return stopTitleMarquee();\n      default:\n        return { error: `unknown_command: ${command}` };\n    }\n  }\n  var RUNTIME_VERSION = "0.3.0-opencli-parity";\n  globalThis.__cpRunControl = runControl;\n  globalThis.__cpRuntimeVersion = RUNTIME_VERSION;\n})();\n';
+var control_runtime_source_default = '"use strict";\n(() => {\n  // src/shared/control-runtime.ts\n  function getRefStore() {\n    const g = globalThis;\n    if (!g.__cpRefs) {\n      g.__cpRefs = { counter: 1, refs: /* @__PURE__ */ new Map(), cssPaths: /* @__PURE__ */ new Map() };\n    }\n    return g.__cpRefs;\n  }\n  function allocRef(el) {\n    const store = getRefStore();\n    for (const [ref2, existing] of store.refs) {\n      if (existing === el) return ref2;\n    }\n    const ref = store.counter++;\n    store.refs.set(ref, el);\n    store.cssPaths.set(ref, uniqueCssPath(el));\n    return ref;\n  }\n  function uniqueCssPath(el) {\n    if (el.id) return `#${CSS.escape(el.id)}`;\n    const parts = [];\n    let cur = el;\n    while (cur && cur !== document.body && cur !== document.documentElement) {\n      let sel = cur.tagName.toLowerCase();\n      if (cur.id) {\n        parts.unshift(`#${CSS.escape(cur.id)}`);\n        break;\n      }\n      const parent = cur.parentElement;\n      if (parent) {\n        const sameTag = Array.from(parent.children).filter((c) => c.tagName === cur.tagName);\n        if (sameTag.length > 1) {\n          const idx = sameTag.indexOf(cur) + 1;\n          sel += `:nth-of-type(${idx})`;\n        }\n      }\n      parts.unshift(sel);\n      cur = parent;\n    }\n    return parts.join(" > ");\n  }\n  function err(code, message, extra) {\n    return { error: { code, message, ...extra || {} } };\n  }\n  var ERROR_CODES = {\n    NOT_FOUND: "not_found",\n    STALE_REF: "stale_ref",\n    INVALID_SELECTOR: "invalid_selector",\n    SELECTOR_NOT_FOUND: "selector_not_found",\n    SELECTOR_AMBIGUOUS: "selector_ambiguous",\n    SELECTOR_NTH_OUT_OF_RANGE: "selector_nth_out_of_range",\n    OPTION_NOT_FOUND: "option_not_found",\n    NOT_A_SELECT: "not_a_select"\n  };\n  var IMPLICIT_ROLE = {\n    a: "link",\n    button: "button",\n    select: "combobox",\n    textarea: "textbox",\n    h1: "heading",\n    h2: "heading",\n    h3: "heading",\n    h4: "heading",\n    h5: "heading",\n    h6: "heading",\n    img: "img",\n    nav: "navigation",\n    ul: "list",\n    ol: "list",\n    li: "listitem",\n    main: "main",\n    article: "article",\n    aside: "complementary",\n    header: "banner",\n    footer: "contentinfo",\n    form: "form",\n    table: "table",\n    summary: "button",\n    option: "option",\n    output: "status"\n  };\n  function roleOf(el) {\n    const explicit = el.getAttribute("role");\n    if (explicit) return explicit.split(/\\s+/)[0];\n    const tag = el.tagName.toLowerCase();\n    if (tag === "input") {\n      const type = el.type || "text";\n      if (type === "hidden") return null;\n      if (type === "checkbox") return "checkbox";\n      if (type === "radio") return "radio";\n      if (type === "button" || type === "submit" || type === "reset") return "button";\n      if (type === "range") return "slider";\n      return "textbox";\n    }\n    if (tag === "progress") return "progressbar";\n    if (tag === "meter") return "meter";\n    return IMPLICIT_ROLE[tag] ?? null;\n  }\n  function accessibleName(el) {\n    const aria = el.getAttribute("aria-label");\n    if (aria) return aria.trim();\n    const labelledby = el.getAttribute("aria-labelledby");\n    if (labelledby) {\n      const parts = labelledby.split(/\\s+/).map((id2) => document.getElementById(id2)?.textContent?.trim() || "");\n      const joined = parts.filter(Boolean).join(" ");\n      if (joined) return joined.slice(0, 120);\n    }\n    const id = el.getAttribute("id");\n    if (id) {\n      const label = document.querySelector(`label[for="${CSS.escape(id)}"]`);\n      if (label?.textContent?.trim()) return label.textContent.trim().slice(0, 120);\n    }\n    if (el.tagName.toLowerCase() === "input") {\n      const type = el.type;\n      if (type === "button" || type === "submit" || type === "reset") {\n        const v = el.value;\n        if (v) return v;\n      }\n    }\n    const alt = el.getAttribute("alt");\n    if (alt) return alt;\n    const title = el.getAttribute("title");\n    if (title) return title;\n    const placeholder = el.getAttribute("placeholder");\n    if (placeholder) return placeholder;\n    return (el.textContent || "").replace(/\\s+/g, " ").trim().slice(0, 120);\n  }\n  function isVisible(el) {\n    if (!(el instanceof HTMLElement) && !(el instanceof SVGElement)) return false;\n    const html = el;\n    if (html.hasAttribute("hidden")) return false;\n    if (html.closest("[hidden]")) return false;\n    const style = window.getComputedStyle(html);\n    if (style.display === "none" || style.visibility === "hidden" || style.opacity === "0") return false;\n    if (el instanceof HTMLElement && el.offsetParent === null) {\n      const pos = style.position;\n      if (pos !== "fixed" && pos !== "sticky") return false;\n    }\n    return true;\n  }\n  var INTERACTIVE_SELECTOR = "a[href], button, input, textarea, select, summary, [role], [contenteditable=\'\'], [contenteditable=\'true\'], [onclick], [tabindex]";\n  function isInteractive(el) {\n    return el.matches(INTERACTIVE_SELECTOR);\n  }\n  function testidSelector(testid) {\n    return `[data-testid="${CSS.escape(testid)}"], [data-test-id="${CSS.escape(testid)}"], [data-test="${CSS.escape(testid)}"], [data-cy="${CSS.escape(testid)}"]`;\n  }\n  function resolveTargetRich(sel) {\n    const targetDesc = sel.ref != null ? String(sel.ref) : sel.css ?? (sel.role || sel.name || sel.label || sel.testid || sel.text ? `${sel.role ? `role=${sel.role} ` : ""}${sel.name ? `name=${sel.name} ` : ""}${sel.label ? `label=${sel.label} ` : ""}${sel.testid ? `testid=${sel.testid} ` : ""}${sel.text ? `text=${sel.text}` : ""}`.trim() : "");\n    if (sel.ref != null) {\n      const store = getRefStore();\n      const el = store.refs.get(sel.ref);\n      if (el && document.contains(el) && isVisible(el)) {\n        return { el, matches_n: 1, match_level: "exact", target: targetDesc };\n      }\n      if (el && !document.contains(el)) {\n        const cssPath = store.cssPaths.get(sel.ref);\n        if (cssPath) {\n          const re = document.querySelector(cssPath);\n          if (re && isVisible(re)) {\n            store.refs.set(sel.ref, re);\n            return { el: re, matches_n: 1, match_level: "reidentified", target: targetDesc };\n          }\n        }\n        return { errorEnvelope: err(ERROR_CODES.STALE_REF, "Numeric ref is no longer in the DOM. Re-run state.") };\n      }\n      return { errorEnvelope: err(ERROR_CODES.NOT_FOUND, "Numeric ref is no longer in the DOM. Re-run state.") };\n    }\n    let candidates = [];\n    if (sel.css) {\n      try {\n        candidates = Array.from(document.querySelectorAll(sel.css));\n      } catch {\n        return { errorEnvelope: err(ERROR_CODES.INVALID_SELECTOR, "CSS was rejected by querySelectorAll.", { selector: sel.css }) };\n      }\n      if (candidates.length === 0) {\n        return { errorEnvelope: err(ERROR_CODES.SELECTOR_NOT_FOUND, "CSS matches 0 elements.", { selector: sel.css, candidates: suggestCandidates() }) };\n      }\n    } else if (sel.testid) {\n      try {\n        candidates = Array.from(document.querySelectorAll(testidSelector(sel.testid)));\n      } catch {\n        return { errorEnvelope: err(ERROR_CODES.INVALID_SELECTOR, "Invalid testid.", { testid: sel.testid }) };\n      }\n    } else if (sel.role || sel.name || sel.label || sel.text) {\n      const wantRole = sel.role ? sel.role.toLowerCase() : null;\n      const wantName = sel.name ? sel.name.toLowerCase() : null;\n      const wantText = sel.text ? sel.text.toLowerCase() : null;\n      let labelTargets = [];\n      if (sel.label) {\n        const lower = sel.label.toLowerCase();\n        labelTargets = Array.from(document.querySelectorAll("label")).filter((l) => (l.textContent || "").trim().toLowerCase().includes(lower)).map((l) => {\n          const forId = l.getAttribute("for");\n          if (forId) return document.getElementById(forId);\n          return l.querySelector("input, select, textarea");\n        }).filter((x) => !!x);\n      }\n      const all = Array.from(document.querySelectorAll("*"));\n      candidates = all.filter((el) => {\n        if (!isVisible(el)) return false;\n        const role = roleOf(el);\n        if (wantRole && (!role || role.toLowerCase() !== wantRole)) return false;\n        if (wantName) {\n          const name = accessibleName(el).toLowerCase();\n          if (!name.includes(wantName)) return false;\n        }\n        if (wantText) {\n          const t = (el.textContent || "").replace(/\\s+/g, " ").trim().toLowerCase();\n          if (!t.includes(wantText)) return false;\n        }\n        return true;\n      });\n      if (labelTargets.length) {\n        const set = new Set(labelTargets);\n        candidates = labelTargets.concat(candidates.filter((c) => !set.has(c)));\n      }\n      if (candidates.length === 0) {\n        return {\n          errorEnvelope: err(\n            ERROR_CODES.SELECTOR_NOT_FOUND,\n            "Semantic locator matches 0 elements.",\n            { role: sel.role, name: sel.name, label: sel.label, text: sel.text, candidates: suggestCandidates() }\n          )\n        };\n      }\n    } else {\n      return { errorEnvelope: err("no_target", "Provide a numeric ref, CSS selector, or semantic locator (--role/--name/--label/--text/--testid).") };\n    }\n    const visible = candidates.filter(isVisible);\n    const pool = visible.length ? visible : candidates;\n    if (sel.nth != null) {\n      if (sel.nth < 0 || sel.nth >= pool.length) {\n        return { errorEnvelope: err(ERROR_CODES.SELECTOR_NTH_OUT_OF_RANGE, `--nth ${sel.nth} beyond match count ${pool.length}.`) };\n      }\n      const el = pool[sel.nth];\n      return { el, matches_n: pool.length, match_level: "reidentified", target: targetDesc };\n    }\n    if (pool.length > 1) {\n      return {\n        errorEnvelope: err(ERROR_CODES.SELECTOR_AMBIGUOUS, `CSS matches ${pool.length} elements and no --nth given.`, {\n          matches_n: pool.length,\n          candidates: pool.slice(0, 5).map((el) => uniqueCssPath(el))\n        })\n      };\n    }\n    return { el: pool[0], matches_n: 1, match_level: "reidentified", target: targetDesc };\n  }\n  function suggestCandidates() {\n    const store = getRefStore();\n    const recent = Array.from(store.refs.entries()).slice(-5).map(([, el]) => uniqueCssPath(el));\n    return recent;\n  }\n  function compoundOf(el) {\n    const tag = el.tagName.toLowerCase();\n    if (tag === "input") {\n      const input = el;\n      const type = input.type;\n      if (["date", "time", "datetime-local", "month", "week"].includes(type)) {\n        const formatMap = {\n          date: "YYYY-MM-DD",\n          time: "HH:mm",\n          "datetime-local": "YYYY-MM-DDTHH:mm",\n          month: "YYYY-MM",\n          week: "YYYY-Www"\n        };\n        return {\n          control: type,\n          format: formatMap[type] ?? type,\n          current: input.value || "",\n          min: input.min || null,\n          max: input.max || null\n        };\n      }\n      if (type === "file") {\n        const current = Array.from(input.files ?? []).map((f) => f.name);\n        return { control: "file", multiple: input.multiple, current, accept: input.accept || null };\n      }\n      return null;\n    }\n    if (tag === "select") {\n      const select = el;\n      const options = Array.from(select.options).slice(0, 50).map((o) => ({\n        label: (o.textContent || "").trim(),\n        value: o.value,\n        selected: o.selected\n      }));\n      return {\n        control: "select",\n        multiple: select.multiple,\n        current: select.selectedOptions[0] ? (select.selectedOptions[0].textContent || "").trim() : "",\n        options,\n        options_total: select.options.length\n      };\n    }\n    return null;\n  }\n  var SKIP_TAGS = /* @__PURE__ */ new Set(["script", "style", "noscript", "meta", "link", "head", "base", "template", "path", "circle", "rect", "g", "defs", "polygon", "line"]);\n  function describeElement(el, ref) {\n    const tag = el.tagName.toLowerCase();\n    const role = el.getAttribute("role") ?? null;\n    const name = accessibleName(el);\n    const parts = [];\n    if (ref != null) parts.push(`[${ref}]`);\n    parts.push(tag);\n    if (role && role !== IMPLICIT_ROLE[tag]) parts.push(`role=${role}`);\n    if (tag === "input") {\n      const input = el;\n      if (input.type && input.type !== "text") parts.push(`[${input.type}]`);\n      if (input.disabled) parts.push("(disabled)");\n    }\n    if (name) parts.push(JSON.stringify(name.length > 60 ? name.slice(0, 57) + "\\u2026" : name));\n    if (tag === "a") {\n      const href = el.getAttribute("href");\n      if (href) parts.push(`\\u2192 ${href.slice(0, 50)}`);\n    }\n    if (el.disabled) parts.push("(disabled)");\n    return parts.join(" ");\n  }\n  function buildStateTree() {\n    const lines = [];\n    const compounds = {};\n    const budget = { nodes: 0, chars: 0, truncated: false };\n    const MAX_NODES = 400;\n    const MAX_CHARS = 9e3;\n    let hiddenInteractive = 0;\n    function emit(depth, text) {\n      const line = "  ".repeat(Math.min(depth, 12)) + text;\n      lines.push(line);\n      budget.chars += line.length;\n    }\n    function walk(el, depth) {\n      if (budget.nodes >= MAX_NODES || budget.chars >= MAX_CHARS) {\n        budget.truncated = true;\n        return;\n      }\n      const tag = el.tagName.toLowerCase();\n      if (SKIP_TAGS.has(tag)) return;\n      budget.nodes++;\n      const visible = isVisible(el);\n      const interactive = isInteractive(el);\n      if (interactive) {\n        if (visible) {\n          const ref = allocRef(el);\n          emit(depth, describeElement(el, ref));\n          const compound = compoundOf(el);\n          if (compound) compounds[String(ref)] = compound;\n        } else {\n          hiddenInteractive++;\n          return;\n        }\n      } else if (visible) {\n        if (/^h[1-6]$/.test(tag)) {\n          const t = accessibleName(el);\n          if (t) emit(depth, `${"#".repeat(Number(tag[1]))} ${t}`);\n        } else if (tag === "p" || tag === "li" || tag === "td" || tag === "th" || tag === "figcaption" || tag === "blockquote") {\n          const ownText = ownTextOf(el);\n          if (ownText) emit(depth, ownText.slice(0, 100));\n        } else if (tag === "img") {\n          const alt = el.getAttribute("alt") || "";\n          if (alt) emit(depth, `img ${JSON.stringify(alt.slice(0, 60))}`);\n        }\n      }\n      if (depth < 14) {\n        for (const child of Array.from(el.children)) {\n          walk(child, depth + 1);\n          if (budget.truncated) return;\n        }\n      }\n    }\n    function ownTextOf(el) {\n      let text = "";\n      for (const node of Array.from(el.childNodes)) {\n        if (node.nodeType === Node.TEXT_NODE) text += node.textContent || "";\n      }\n      return text.replace(/\\s+/g, " ").trim();\n    }\n    const root = document.querySelector("main") || document.querySelector("#root") || document.body;\n    emit(0, `# ${document.title}`);\n    walk(root, 0);\n    const scrollable = document.documentElement.scrollHeight > window.innerHeight + 200;\n    if (scrollable) {\n      emit(0, "\\u2195 page is scrollable \\u2014 run cp.scroll down to reveal more");\n    }\n    if (hiddenInteractive > 0) {\n      emit(0, `\\u2139 ${hiddenInteractive} hidden interactive element(s) not tagged`);\n    }\n    if (budget.truncated) {\n      emit(0, "\\u2026 (snapshot truncated by budget \\u2014 narrow with a selector or scroll)");\n    }\n    return {\n      url: location.href,\n      title: document.title,\n      text: lines.join("\\n"),\n      compounds,\n      hints: { scroll: scrollable, hidden_interactive: hiddenInteractive },\n      truncated: budget.truncated\n    };\n  }\n  function runControl(command, args) {\n    const a = args || {};\n    function getVisibleText(el) {\n      return (el.textContent || "").trim().replace(/\\s+/g, " ").slice(0, 120);\n    }\n    function getAttrs(el) {\n      const attrs = {};\n      for (const name of ["id", "class", "name", "type", "href", "src", "placeholder", "value", "role", "aria-label", "data-testid"]) {\n        attrs[name] = el.getAttribute(name);\n      }\n      return attrs;\n    }\n    function sel() {\n      return {\n        ref: a.ref,\n        css: a.css,\n        nth: a.nth,\n        role: a.role,\n        name: a.name,\n        label: a.label,\n        text: a.text,\n        testid: a.testid\n      };\n    }\n    function findElements(findArgs) {\n      const limit = findArgs.limit ?? 20;\n      const textMax = findArgs["text-max"] ?? 120;\n      let elements = [];\n      if (findArgs.css) {\n        try {\n          elements = Array.from(document.querySelectorAll(findArgs.css));\n        } catch {\n          return err(ERROR_CODES.INVALID_SELECTOR, "CSS was rejected by querySelectorAll.", { selector: findArgs.css });\n        }\n      } else if (findArgs.testid) {\n        try {\n          elements = Array.from(document.querySelectorAll(testidSelector(findArgs.testid)));\n        } catch {\n          return err(ERROR_CODES.INVALID_SELECTOR, "Invalid testid.");\n        }\n      } else if (findArgs.role || findArgs.name || findArgs.label) {\n        const r = resolveTargetRich({ role: findArgs.role, name: findArgs.name, label: findArgs.label, text: findArgs.text });\n        if ("errorEnvelope" in r) return r.errorEnvelope;\n        elements = document.querySelectorAll("*").length ? semanticCandidates(findArgs) : [];\n      } else if (findArgs.text) {\n        const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);\n        const lower = findArgs.text.toLowerCase();\n        const seen = /* @__PURE__ */ new Set();\n        let node;\n        while (node = walker.nextNode()) {\n          if (node.textContent?.toLowerCase().includes(lower)) {\n            const el = node.parentElement;\n            if (el && !seen.has(el)) {\n              seen.add(el);\n              elements.push(el);\n              if (elements.length >= limit) break;\n            }\n          }\n        }\n      } else {\n        elements = Array.from(document.querySelectorAll(INTERACTIVE_SELECTOR));\n      }\n      const out = elements.slice(0, limit).map((el, i) => {\n        const ref = allocRef(el);\n        return {\n          nth: i,\n          ref,\n          tag: el.tagName.toLowerCase(),\n          role: roleOf(el),\n          text: getVisibleText(el).slice(0, textMax),\n          attrs: getAttrs(el),\n          visible: isVisible(el),\n          compound: compoundOf(el) ?? void 0\n        };\n      });\n      return out;\n    }\n    function semanticCandidates(findArgs) {\n      const wantRole = findArgs.role ? findArgs.role.toLowerCase() : null;\n      const wantName = findArgs.name ? findArgs.name.toLowerCase() : null;\n      const wantText = findArgs.text ? findArgs.text.toLowerCase() : null;\n      const all = Array.from(document.querySelectorAll("*"));\n      return all.filter((el) => {\n        if (!isVisible(el)) return false;\n        if (wantRole) {\n          const role = roleOf(el);\n          if (!role || role.toLowerCase() !== wantRole) return false;\n        }\n        if (wantName && !accessibleName(el).toLowerCase().includes(wantName)) return false;\n        if (wantText && !(el.textContent || "").toLowerCase().includes(wantText)) return false;\n        return true;\n      });\n    }\n    function pageState() {\n      return {\n        url: location.href,\n        title: document.title,\n        width: window.innerWidth,\n        height: window.innerHeight,\n        devicePixelRatio: window.devicePixelRatio\n      };\n    }\n    function goto(gotoArgs) {\n      if (!gotoArgs.url) return { error: "url_required" };\n      let sameUrl = false;\n      try {\n        sameUrl = new URL(gotoArgs.url, window.location.href).href === window.location.href;\n      } catch {\n        sameUrl = false;\n      }\n      if (sameUrl) {\n        if (gotoArgs.reload === true) {\n          window.location.reload();\n          return { navigated: true, reloaded: true, url: gotoArgs.url };\n        }\n        return { navigated: false, reused: true, url: gotoArgs.url };\n      }\n      window.location.href = gotoArgs.url;\n      return { navigated: true, url: gotoArgs.url };\n    }\n    function evalScript(evalArgs) {\n      if (!evalArgs.script) return { error: "script_required" };\n      try {\n        const fn = new Function(evalArgs.script);\n        const result = fn();\n        return { result };\n      } catch (e) {\n        return { error: String(e) };\n      }\n    }\n    function fillElement(fArgs) {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      const input = el;\n      if (el.tagName === "INPUT" || el.tagName === "TEXTAREA" || el.isContentEditable) {\n        const isContentEditable = el.isContentEditable;\n        if (isContentEditable) {\n          el.innerText = fArgs.text ?? "";\n        } else {\n          input.value = fArgs.text ?? "";\n        }\n        input.dispatchEvent(new Event("input", { bubbles: true }));\n        input.dispatchEvent(new Event("change", { bubbles: true }));\n        const actual = isContentEditable ? el.innerText : input.value;\n        return actual === (fArgs.text ?? "") ? { filled: true, verified: true, text: fArgs.text, actual, target, matches_n, match_level } : err("verify_failed", "Input value diverged after fill (controlled component?).", { actual });\n      }\n      return err("invalid_type", "fill only supports input, textarea, and contenteditable.");\n    }\n    function typeElement(tArgs) {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      const input = el;\n      el.focus({ preventScroll: true });\n      input.value = tArgs.text ?? "";\n      input.dispatchEvent(new Event("input", { bubbles: true }));\n      input.dispatchEvent(new Event("change", { bubbles: true }));\n      let autocomplete = false;\n      try {\n        autocomplete = !!document.querySelector("[role=\'listbox\'], [role=\'combobox\'] [role=\'listbox\'], datalist, .ant-select-dropdown:not([style*=\'hidden\']), [id^=\'listbox\']");\n      } catch {\n      }\n      return { typed: true, text: tArgs.text, target, matches_n, match_level, autocomplete };\n    }\n    function clickElement() {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      el.scrollIntoView({ block: "center" });\n      el.click();\n      return { clicked: true, target, matches_n, match_level, tag: el.tagName.toLowerCase(), text: getVisibleText(el) };\n    }\n    function selectElement(sArgs) {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      if (el.tagName !== "SELECT") {\n        return err(ERROR_CODES.NOT_A_SELECT, "select was called on a non-<select> element.", { tag: el.tagName.toLowerCase() });\n      }\n      const select = el;\n      const want = sArgs.label ?? sArgs.value ?? sArgs.option;\n      if (!want) return err("option_required", "Provide label or value.");\n      const byLabel = Array.from(select.options).find((o) => (o.textContent || "").trim() === want);\n      const byValue = Array.from(select.options).find((o) => o.value === want);\n      const opt = byLabel ?? byValue;\n      if (!opt) {\n        const available = Array.from(select.options).slice(0, 50).map((o) => (o.textContent || "").trim());\n        return err(ERROR_CODES.OPTION_NOT_FOUND, "Option not found.", { available });\n      }\n      select.value = opt.value;\n      select.dispatchEvent(new Event("input", { bubbles: true }));\n      select.dispatchEvent(new Event("change", { bubbles: true }));\n      return { selected: true, value: select.value, target, matches_n, match_level };\n    }\n    function pressKeys(kArgs) {\n      const keyCombo = kArgs.keys ?? kArgs.key ?? "";\n      if (!keyCombo) return { error: "keys_required" };\n      const comboParts = keyCombo.split("+").map((s) => s.trim());\n      const main = comboParts[comboParts.length - 1];\n      const ctrl = comboParts.includes("Control") || comboParts.includes("Ctrl") || comboParts.includes("Meta") || comboParts.includes("Cmd");\n      const alt = comboParts.includes("Alt");\n      const shift = comboParts.includes("Shift");\n      const target = document.activeElement ?? document.body;\n      const opts = { key: main, bubbles: true, cancelable: true, ctrlKey: ctrl, altKey: alt, shiftKey: shift, metaKey: comboParts.includes("Meta") || comboParts.includes("Cmd") };\n      target.dispatchEvent(new KeyboardEvent("keydown", opts));\n      target.dispatchEvent(new KeyboardEvent("keypress", opts));\n      target.dispatchEvent(new KeyboardEvent("keyup", opts));\n      return { pressed: true, key: keyCombo };\n    }\n    function hoverElement() {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      const rect = el.getBoundingClientRect();\n      const opts = { bubbles: true, cancelable: true, clientX: rect.x + rect.width / 2, clientY: rect.y + rect.height / 2 };\n      el.dispatchEvent(new MouseEvent("mouseover", opts));\n      el.dispatchEvent(new MouseEvent("mousemove", opts));\n      return { hovered: true, target, matches_n, match_level };\n    }\n    function focusElement() {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      el.focus({ preventScroll: true });\n      return { focused: true, target, matches_n, match_level };\n    }\n    function dblclickElement() {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      el.dispatchEvent(new MouseEvent("dblclick", { bubbles: true, cancelable: true }));\n      return { dblclicked: true, target, matches_n, match_level };\n    }\n    function setChecked(want) {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      const input = el;\n      const isAria = input.type !== "checkbox" && input.type !== "radio" && el.getAttribute("aria-checked") != null;\n      if (!isAria && input.type !== "checkbox" && input.type !== "radio") {\n        return err("invalid_type", "Target is not a checkbox/radio/aria-checked control.", { tag: el.tagName.toLowerCase() });\n      }\n      if (isAria) {\n        el.setAttribute("aria-checked", String(want));\n        el.dispatchEvent(new Event("change", { bubbles: true }));\n        return { [want ? "checked" : "unchecked"]: true, changed: true, target, matches_n, match_level, kind: "aria" };\n      }\n      if (input.type === "radio" && !want) {\n        return err("invalid_type", "Radio buttons cannot be unchecked directly; select another radio in the group.");\n      }\n      const changed = input.checked !== want;\n      input.checked = want;\n      input.dispatchEvent(new Event("input", { bubbles: true }));\n      input.dispatchEvent(new Event("change", { bubbles: true }));\n      return { [want ? "checked" : "unchecked"]: true, changed, target, matches_n, match_level, kind: input.type };\n    }\n    function scrollElement(sArgs) {\n      const dir = sArgs.direction ?? "down";\n      const amount = sArgs.amount ?? 500;\n      if (dir !== "up" && dir !== "down") return { error: "invalid_direction" };\n      const dy = dir === "down" ? amount : -amount;\n      window.scrollBy({ top: dy, behavior: "instant" });\n      return {\n        scrolled: true,\n        direction: dir,\n        amount,\n        scrollY: Math.round(window.scrollY),\n        scrollHeight: document.documentElement.scrollHeight\n      };\n    }\n    function backNav() {\n      history.back();\n      return { back: true };\n    }\n    function htmlJsonTree(el, depth, maxDepth, childrenMax, textMax, truncated) {\n      const children = Array.from(el.children);\n      const ownText = (el.textContent || "").replace(/\\s+/g, " ").trim();\n      const node = {\n        tag: el.tagName.toLowerCase(),\n        attrs: getAttrs(el),\n        text: ownText.length > textMax ? (ownText.slice(0, textMax), truncated.text_truncated = (truncated.text_truncated || 0) + 1, ownText.slice(0, textMax)) : ownText,\n        children: [],\n        compound: compoundOf(el) ?? void 0\n      };\n      if (depth < maxDepth) {\n        let kids = children;\n        if (children.length > childrenMax) {\n          truncated.children_dropped = (truncated.children_dropped || 0) + (children.length - childrenMax);\n          kids = children.slice(0, childrenMax);\n        }\n        node.children = kids.map((c) => htmlJsonTree(c, depth + 1, maxDepth, childrenMax, textMax, truncated));\n      } else if (children.length) {\n        truncated.depth = (truncated.depth || 0) + 1;\n      }\n      return node;\n    }\n    function getElement(gArgs) {\n      const what = gArgs.what ?? "text";\n      if (what === "title") return { value: document.title, matches_n: 1, match_level: "exact" };\n      if (what === "url") return { value: location.href, matches_n: 1, match_level: "exact" };\n      if (what === "html") {\n        if (gArgs["as"] === "json") {\n          const root2 = gArgs.css ? document.querySelector(gArgs.css) : document.body;\n          if (!root2) return err(ERROR_CODES.SELECTOR_NOT_FOUND, "CSS matches 0 elements.", { selector: gArgs.css });\n          const truncated = {};\n          const tree = htmlJsonTree(root2, 0, gArgs.depth ?? 6, gArgs["children-max"] ?? 20, gArgs["text-max"] ?? 200, truncated);\n          return {\n            value: tree,\n            truncated: Object.keys(truncated).length ? truncated : void 0\n          };\n        }\n        const root = gArgs.css ? document.querySelector(gArgs.css) : document.body;\n        if (!root) return err(ERROR_CODES.SELECTOR_NOT_FOUND, "CSS matches 0 elements.", { selector: gArgs.css });\n        let html = root.outerHTML;\n        if (gArgs.max && html.length > gArgs.max) html = html.slice(0, gArgs.max) + "\\u2026";\n        return { value: html };\n      }\n      const r = resolveTargetRich(gArgs);\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level } = r;\n      switch (what) {\n        case "text": {\n          const t = getVisibleText(el);\n          return { value: t.length > 2e3 ? t.slice(0, 2e3) : t, matches_n, match_level };\n        }\n        case "value":\n          return { value: el.value ?? el.innerText ?? null, matches_n, match_level };\n        case "attributes":\n          return { value: getAttrs(el), matches_n, match_level };\n        default:\n          return { error: `unknown_what: ${what}` };\n      }\n    }\n    function extractMarkdown(eArgs) {\n      const chunkSize = eArgs["chunk-size"] ?? 0;\n      const start = eArgs.start ?? 0;\n      const scope = eArgs.selector ? document.querySelector(eArgs.selector) : document.querySelector("main") || document.querySelector("article") || document.body;\n      if (!scope) return { error: "scope_not_found" };\n      const parts = [];\n      const walker = document.createTreeWalker(scope, NodeFilter.SHOW_ELEMENT);\n      let node;\n      while (node = walker.nextNode()) {\n        const el = node;\n        const tag = el.tagName.toLowerCase();\n        const text = getVisibleText(el);\n        if (!text) continue;\n        if (tag === "h1") parts.push(`# ${text}`);\n        else if (tag === "h2") parts.push(`## ${text}`);\n        else if (tag === "h3") parts.push(`### ${text}`);\n        else if (tag === "p" || tag === "li") parts.push(text);\n        else if (tag === "a") parts.push(`[${text}](${el.getAttribute("href") ?? ""})`);\n      }\n      const full = parts.join("\\n\\n");\n      const sliced = chunkSize > 0 ? full.slice(start, start + chunkSize) : full.slice(start);\n      return {\n        url: location.href,\n        title: document.title,\n        selector: eArgs.selector ?? "auto",\n        total_chars: full.length,\n        chunk_size: chunkSize,\n        start,\n        end: start + sliced.length,\n        next_start_char: start + sliced.length < full.length ? start + sliced.length : null,\n        content: sliced\n      };\n    }\n    function listFrames() {\n      const frames = Array.from(document.querySelectorAll("iframe")).map((f, index) => {\n        const src = f.getAttribute("src") ?? "";\n        let crossOrigin = false;\n        try {\n          if (src && /^https?:/.test(src)) crossOrigin = new URL(src, location.href).origin !== location.origin;\n        } catch {\n        }\n        return { index, url: src, name: f.getAttribute("name") ?? "", cross_origin: crossOrigin };\n      });\n      return { frames };\n    }\n    function screenshotMeta() {\n      return {\n        width: window.innerWidth,\n        height: window.innerHeight,\n        url: location.href,\n        title: document.title\n      };\n    }\n    function startTitleMarquee(tArgs) {\n      const g = globalThis;\n      if (g.__cpMarquee) {\n        clearInterval(g.__cpMarquee.interval);\n      } else {\n        g.__cpMarquee = { original: document.title, interval: 0 };\n      }\n      const prefix = tArgs.text ?? "\\u{1F916}";\n      const base = g.__cpMarquee.original;\n      const full = `${prefix} ${base}`;\n      const speed = Math.max(100, Math.min(2e3, tArgs.speed ?? 300));\n      let pos = 0;\n      const tick = () => {\n        const display = full.slice(pos) + "  " + full.slice(0, pos);\n        document.title = display.slice(0, 60);\n        pos = (pos + 1) % (full.length + 1 || 1);\n      };\n      tick();\n      g.__cpMarquee.interval = window.setInterval(tick, speed);\n      return { started: true, original: base, prefix, speed };\n    }\n    function stopTitleMarquee() {\n      const g = globalThis;\n      const state = g.__cpMarquee;\n      if (!state) return { restored: false, reason: "no_active_marquee" };\n      clearInterval(state.interval);\n      document.title = state.original;\n      delete g.__cpMarquee;\n      return { restored: true, original: state.original };\n    }\n    function networkEntriesLegacy(nArgs) {\n      const all = performance.getEntriesByType("resource").map((e) => ({\n        url: e.name,\n        type: e.initiatorType ?? "unknown",\n        duration: Math.round(e.duration)\n      }));\n      let entries = all;\n      if (nArgs.filter) {\n        const keywords = nArgs.filter.split(",").map((s) => s.trim().toLowerCase());\n        entries = all.filter((e) => keywords.some((kw) => e.url.toLowerCase().includes(kw)));\n      }\n      return { entries, count: entries.length, source: "performance-api" };\n    }\n    async function waitForCondition(wArgs) {\n      const timeout = wArgs.timeout ?? 1e4;\n      if (wArgs.time != null) {\n        await new Promise((res) => setTimeout(res, Math.min(wArgs.time * 1e3, 3e4)));\n        return { waited: true, kind: "time", seconds: wArgs.time };\n      }\n      const deadline = Date.now() + timeout;\n      const pollInterval = 200;\n      if (wArgs.selector) {\n        while (Date.now() < deadline) {\n          if (document.querySelector(wArgs.selector)) return { waited: true, kind: "selector", selector: wArgs.selector, elapsedMs: timeout - (deadline - Date.now()) };\n          await new Promise((res) => setTimeout(res, pollInterval));\n        }\n        return err("wait_timeout", `Selector not found within ${timeout}ms.`, { selector: wArgs.selector });\n      }\n      if (wArgs.text) {\n        const lower = wArgs.text.toLowerCase();\n        while (Date.now() < deadline) {\n          if ((document.body.textContent || "").toLowerCase().includes(lower)) {\n            return { waited: true, kind: "text", text: wArgs.text, elapsedMs: timeout - (deadline - Date.now()) };\n          }\n          await new Promise((res) => setTimeout(res, pollInterval));\n        }\n        return err("wait_timeout", `Text not found within ${timeout}ms.`, { text: wArgs.text });\n      }\n      return { error: "no_condition" };\n    }\n    function uploadFiles(uArgs) {\n      const r = resolveTargetRich(sel());\n      if ("errorEnvelope" in r) return r.errorEnvelope;\n      const { el, matches_n, match_level, target } = r;\n      const input = el;\n      if (input.type !== "file") return err("invalid_type", "Target is not an input[type=file].", { tag: el.tagName.toLowerCase() });\n      try {\n        const dt = new DataTransfer();\n        for (const name of uArgs.files ?? []) {\n          dt.items.add(new File([""], name.split("/").pop() || name));\n        }\n        input.files = dt.files;\n      } catch {\n      }\n      input.dispatchEvent(new Event("change", { bubbles: true }));\n      return {\n        uploaded: true,\n        files: uArgs.files ?? [],\n        file_names: (uArgs.files ?? []).map((f) => f.split("/").pop()),\n        target,\n        matches_n,\n        match_level,\n        multiple: input.multiple,\n        accept: input.accept || null\n      };\n    }\n    function dragElements(dArgs) {\n      const r1 = resolveTargetRich(sel());\n      if ("errorEnvelope" in r1) return r1.errorEnvelope;\n      const r2 = resolveTargetRich({ ref: dArgs.ref2, css: dArgs.css2 });\n      if ("errorEnvelope" in r2) return r2.errorEnvelope;\n      const src = r1.el;\n      const tgt = r2.el;\n      const make = (type) => {\n        const r1rect = src.getBoundingClientRect();\n        return new DragEvent(type, { bubbles: true, cancelable: true, clientX: r1rect.x + r1rect.width / 2, clientY: r1rect.y + r1rect.height / 2 });\n      };\n      src.dispatchEvent(make("dragstart"));\n      tgt.dispatchEvent(new DragEvent("dragenter", { bubbles: true }));\n      tgt.dispatchEvent(new DragEvent("dragover", { bubbles: true, cancelable: true }));\n      tgt.dispatchEvent(new DragEvent("drop", { bubbles: true, cancelable: true }));\n      src.dispatchEvent(new DragEvent("dragend", { bubbles: true }));\n      return { dragged: true, source: String(sel().ref ?? sel().css ?? ""), target: String(dArgs.ref2 ?? dArgs.css2 ?? ""), source_matches_n: r1.matches_n, target_matches_n: r2.matches_n };\n    }\n    switch (command) {\n      case "cp.state":\n        return a.tree === false ? pageState() : buildStateTree();\n      case "cp.snapshot":\n        return buildStateTree();\n      case "cp.find":\n        return findElements({\n          css: a.css,\n          text: a.text,\n          limit: a.limit,\n          role: a.role,\n          name: a.name,\n          label: a.label,\n          testid: a.testid,\n          "text-max": a["text-max"]\n        });\n      case "cp.click":\n        return clickElement();\n      case "cp.type":\n        return typeElement({ text: a.text });\n      case "cp.goto":\n        return goto({ url: a.url });\n      case "cp.eval":\n        return evalScript({ script: a.script });\n      case "cp.fill":\n        return fillElement({ text: a.text });\n      case "cp.select":\n        return selectElement({ label: a.label, value: a.value, option: a.option });\n      case "cp.keys":\n        return pressKeys({ keys: a.keys, key: a.key });\n      case "cp.hover":\n        return hoverElement();\n      case "cp.focus":\n        return focusElement();\n      case "cp.dblclick":\n        return dblclickElement();\n      case "cp.check":\n        return setChecked(true);\n      case "cp.uncheck":\n        return setChecked(false);\n      case "cp.scroll":\n        return scrollElement({ direction: a.direction, amount: a.amount });\n      case "cp.back":\n        return backNav();\n      case "cp.get":\n        return getElement({\n          what: a.what,\n          css: a.css,\n          ref: a.ref,\n          nth: a.nth,\n          "as": a["as"],\n          depth: a.depth,\n          "children-max": a["children-max"],\n          "text-max": a["text-max"],\n          max: a.max,\n          role: a.role,\n          name: a.name,\n          label: a.label,\n          text: a.text,\n          testid: a.testid\n        });\n      case "cp.extract":\n        return extractMarkdown({\n          "chunk-size": a["chunk-size"],\n          start: a.start,\n          selector: a.selector\n        });\n      case "cp.frames":\n        return listFrames();\n      case "cp.screenshot":\n        return screenshotMeta();\n      case "cp.network":\n        return networkEntriesLegacy({ filter: a.filter });\n      case "cp.wait":\n        return waitForCondition({\n          selector: a.selector,\n          text: a.text,\n          time: a.time,\n          timeout: a.timeout\n        });\n      case "cp.upload":\n        return uploadFiles({ files: a.files });\n      case "cp.drag":\n        return dragElements({ ref2: a.ref2, css2: a.css2 });\n      case "cp.title.marquee":\n        return startTitleMarquee({ text: a.text, speed: a.speed });\n      case "cp.title.restore":\n        return stopTitleMarquee();\n      default:\n        return { error: `unknown_command: ${command}` };\n    }\n  }\n  var RUNTIME_VERSION = "0.3.0-opencli-parity";\n  globalThis.__cpRunControl = runControl;\n  globalThis.__cpRuntimeVersion = RUNTIME_VERSION;\n})();\n';
 
 // src/background/cdp.ts
 var attached = /* @__PURE__ */ new Set();
 var CDP_COMMAND_TIMEOUT_MS = 15e3;
-function send(target, method, params) {
-  return chrome.debugger.sendCommand(target, method, params ?? {});
+function send(target, method, params, timeoutMs = CDP_COMMAND_TIMEOUT_MS) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      if (target.tabId !== void 0) {
+        chrome.debugger.detach({ tabId: target.tabId }).catch(() => void 0).then(() => {
+          attached.delete(target.tabId);
+        });
+      }
+      reject(new Error(`cdp_timeout: ${method} after ${timeoutMs}ms (tab frozen or unresponsive)`));
+    }, timeoutMs);
+    chrome.debugger.sendCommand(target, method, params ?? {}).then(
+      (v) => {
+        clearTimeout(timer);
+        resolve(v);
+      },
+      (err3) => {
+        clearTimeout(timer);
+        reject(err3);
+      }
+    );
+  });
 }
 function isAttachableUrl(url) {
   if (!url) return false;
@@ -1326,6 +1358,21 @@ chrome.debugger.onDetach.addListener((source) => {
     networkEnabledTabs.delete(source.tabId);
   }
 });
+async function detachIfAttached(tabId) {
+  if (!attached.has(tabId)) return;
+  try {
+    await chrome.debugger.detach({ tabId });
+  } catch {
+  }
+  attached.delete(tabId);
+  networkEnabledTabs.delete(tabId);
+}
+chrome.tabs.onUpdated.addListener((tabId, changeInfo) => {
+  if (changeInfo.status !== "loading") return;
+  attached.delete(tabId);
+  networkEnabledTabs.delete(tabId);
+  chrome.debugger.detach({ tabId }).catch(() => void 0);
+});
 var CDP_ALLOWLIST = /* @__PURE__ */ new Set([
   "Accessibility.enable",
   "Accessibility.getFullAXTree",
@@ -1362,10 +1409,11 @@ async function insertText(tabId, text) {
 }
 async function cdpEvaluate(tabId, expression, timeoutMs = CDP_COMMAND_TIMEOUT_MS) {
   await ensureAttached(tabId);
-  const result = await chrome.debugger.sendCommand(
+  const result = await send(
     { tabId },
     "Runtime.evaluate",
-    { expression, returnByValue: true, awaitPromise: true }
+    { expression, returnByValue: true, awaitPromise: true },
+    timeoutMs
   );
   if (result.exceptionDetails) {
     const errMsg = result.exceptionDetails.exception?.description || result.exceptionDetails.text || "Eval error";
@@ -1897,6 +1945,19 @@ async function executeControlCommand(rawCommand, rawArgs, options = {}) {
         return err2(e instanceof Error ? e.message : String(e), code);
       }
     }
+    if (command === "hm.liepin.search") {
+      try {
+        const result = await runLiepinSearch(controlArgs, log, {
+          sessionId,
+          groupTitle,
+          explicitTab
+        });
+        return ok(result);
+      } catch (e) {
+        const code = e instanceof ControlBlockedError ? e.code : void 0;
+        return err2(e instanceof Error ? e.message : String(e), code);
+      }
+    }
     let tab = await getControlTab(tabOverride);
     if (!tab?.id) {
       if (command === "cp.goto" && typeof controlArgs.url === "string" && controlArgs.url) {
@@ -2029,6 +2090,17 @@ async function executeControlCommand(rawCommand, rawArgs, options = {}) {
           return err2(e instanceof Error ? e.message : String(e));
         }
       }
+      if (command === "hm.liepin.extract") {
+        if (!isAttachableUrl(tab.url)) {
+          return err2("liepin_extract_requires_http_page");
+        }
+        try {
+          const result = await cdpEvaluate(tab.id, LIEPIN_EXTRACT_SOURCE);
+          return ok(result);
+        } catch (e) {
+          return err2(e instanceof Error ? e.message : String(e));
+        }
+      }
       if (command.startsWith("hm.")) {
         return { status: "error", code: "not_implemented", message: `${command} is not implemented yet` };
       }
@@ -2316,6 +2388,8 @@ async function runLinkedInSearch(args, log, ctx) {
   const filters = args.filters && typeof args.filters === "object" ? args.filters : {};
   const maxPages = Math.min(Math.max(Number(args.maxPages) || 3, 1), 10);
   const keepTab = args.keepTab === true;
+  const activateTab = args.activateTab !== false;
+  const loadTimeoutMs = Math.min(Math.max(Number(args.loadTimeoutMs) || 25e3, 5e3), 3e5);
   const delayBase = typeof args.delayMs === "number" ? Number(args.delayMs) : 2500;
   let effectiveKeywords = keywords;
   if (!filters.geoUrn && typeof filters.location === "string" && filters.location.trim()) {
@@ -2330,7 +2404,12 @@ async function runLinkedInSearch(args, log, ctx) {
   if (typeof filters.company === "string" && filters.company) u.searchParams.set("company", filters.company);
   if (typeof filters.school === "string" && filters.school) u.searchParams.set("school", filters.school);
   const tab = await chrome.tabs.create({ url: u.toString(), active: false });
-  log("info", "hm.linkedin.search tab created", { tabId: tab.id, url: u.toString(), maxPages });
+  log("info", "hm.linkedin.search tab created", { tabId: tab.id, url: u.toString(), maxPages, activateTab });
+  if (activateTab && tab.id != null) {
+    await chrome.tabs.update(tab.id, { active: true }).catch(
+      (err3) => log("warn", "hm.linkedin.search activate tab failed", { tabId: tab.id, error: err3.message })
+    );
+  }
   if (ctx.sessionId && !ctx.explicitTab && tab.id) {
     addTabToSessionGroup(ctx.sessionId, ctx.groupTitle, tab).catch(
       (err3) => log("warn", "hm.linkedin.search addTabToSessionGroup failed", { error: err3.message })
@@ -2342,7 +2421,7 @@ async function runLinkedInSearch(args, log, ctx) {
   try {
     for (let page = 1; page <= maxPages; page++) {
       if (tab.id == null) break;
-      await waitTabLoaded(tab.id, 25e3);
+      await waitTabLoaded(tab.id, loadTimeoutMs);
       const blocked = await cdpEvaluate(tab.id, LINKEDIN_WALL_CHECK_SOURCE).catch(() => null);
       if (blocked === "CAPTCHA" || blocked === "LOGIN_WALL") {
         log("warn", "hm.linkedin.search blocked by linkedin risk control", { blocked, page, url: lastUrl });
@@ -2374,8 +2453,20 @@ async function runLinkedInSearch(args, log, ctx) {
     }
   } finally {
     if (!keepTab && tab.id != null) {
-      await chrome.tabs.remove(tab.id).catch(() => {
-      });
+      await closeTabGracefully(tab.id);
+    }
+  }
+  let diagnostics = null;
+  if (leads.size === 0 && tab.id != null) {
+    const t = await chrome.tabs.get(tab.id).catch(() => null);
+    const signal = t && t.id != null ? await cdpEvaluate(t.id, LIEPIN_WALL_CHECK_SOURCE).catch(() => null) : null;
+    const bodySnippet = t && t.id != null && (!t.url || t.url !== "about:blank") ? await cdpEvaluate(
+      t.id,
+      '(() => { const b = document.body && document.body.innerText; return b ? b.replace(/\\s+/g, " ").trim().slice(0, 300) : null; })()'
+    ).catch(() => null) : null;
+    diagnostics = { url: t?.url ?? null, title: t?.title ?? null, signal, bodySnippet };
+    if (signal) {
+      log("warn", "hm.liepin.search 0 leads with risk-control signal", { signal, url: diagnostics.url });
     }
   }
   return {
@@ -2385,7 +2476,553 @@ async function runLinkedInSearch(args, log, ctx) {
     leadCount: leads.size,
     leads: Array.from(leads.values()),
     keepTab,
-    tabId: keepTab ? tab.id ?? null : null
+    tabId: keepTab ? tab.id ?? null : null,
+    // Issue #24 P0:0 leads 不等于"没搜到",可能是登录墙/反爬页根本没渲染结果。
+    // 带出诊断字段,由调用方决定 degraded;真实 0 结果 diagnostics.signal 为 null。
+    ...leads.size === 0 && diagnostics ? { diagnostics, degraded: diagnostics.signal !== null, degradedReason: diagnostics.signal ?? void 0 } : {}
+  };
+}
+var LIEPIN_WALL_CHECK_SOURCE = String.raw`(() => {
+  try {
+    if (location.href === 'about:blank' || !location.hostname) return 'BLANK_KILL';
+    const url = location.href;
+    if (/liepin\.com\/(login|passport|signin)/i.test(url)) return 'LOGIN_WALL';
+    if (/liepin\.com\/(safe|verify|check|captcha|slide)/i.test(url)) return 'CAPTCHA';
+    const bodyText = (document.body && document.body.innerText ? document.body.innerText : '').slice(0, 4000);
+    if (/滑块|拖动验证|安全验证|验证码|verify you are human|请完成安全验证/.test(bodyText)) return 'CAPTCHA';
+    if (document.querySelector('[class*="captcha"], [id*="captcha"], iframe[src*="captcha"], iframe[src*="slide"]')) return 'CAPTCHA';
+    if (/请先登录|登录后查看|立即登录/.test(bodyText) && !document.querySelector('#resume-detail-basic-info')) return 'LOGIN_WALL';
+  } catch (e) { /* 检测失败不阻断 */ }
+  return null;
+})()`;
+var LIEPIN_EXTRACT_SOURCE = String.raw`(async () => {
+  const waitFor = (fn, timeout, interval) => new Promise((resolve) => {
+    const t0 = Date.now();
+    const tick = () => {
+      let v = null;
+      try { v = fn(); } catch (e) {}
+      if (v) return resolve(v);
+      if (Date.now() - t0 > (timeout || 8000)) return resolve(null);
+      setTimeout(tick, interval || 250);
+    };
+    tick();
+  });
+  if (document.readyState !== 'complete') {
+    await waitFor(() => document.readyState === 'complete', 12000, 200);
+  }
+  const clean = (s) => {
+    if (s == null) return null;
+    const t = String(s).replace(/\s+/g, ' ').trim();
+    return t || null;
+  };
+  const txt = (el) => clean(el ? el.textContent : null);
+  const first = (sel, root) => (root || document).querySelector(sel);
+  const attr = (el, name) => (el ? (el.getAttribute(name) || null) : null);
+  const abs = (href) => {
+    if (!href) return null;
+    try { return new URL(href, location.href).toString(); } catch (e) { return href; }
+  };
+  /* sep-info 用 <i></i> 作分隔符:转 | 后按段切分 */
+  const splitByI = (el) => {
+    if (!el) return [];
+    const html = el.innerHTML || '';
+    const holder = document.createElement('div');
+    return html.replace(/<i[^>]*>\s*<\/i>/g, '|').split('|').map((seg) => {
+      holder.innerHTML = seg;
+      return clean(holder.textContent);
+    }).filter(Boolean);
+  };
+  /* (2012.07 - 至今, 14年2个月) → { start, end, duration } */
+  const parsePeriod = (text) => {
+    const m = (text || '').match(/[（(]\s*([^)）]*?)\s*[)）]/);
+    if (!m) return { start: null, end: null, duration: null };
+    const parts = m[1].split(',').map((s) => clean(s)).filter(Boolean);
+    const range = (parts[0] || '').split('-').map((s) => clean(s));
+    return { start: range[0] || null, end: range[1] || null, duration: parts[1] || null };
+  };
+  /* rd-info-col 映射:每个 col 是 title+cont 对(一行可能两个 col) */
+  const readInfoCols = (root) => {
+    const out = {};
+    (root || document).querySelectorAll('.rd-info-col').forEach((col) => {
+      const title = txt(first('.rd-info-col-title', col));
+      const cont = txt(first('.rd-info-col-cont', col));
+      if (title && cont) out[title.replace(/[:：]\s*$/, '')] = cont;
+    });
+    return out;
+  };
+  const resIdFrom = (href, scm) => {
+    if (scm) {
+      const m = scm.match(/cid=([^&]+)/);
+      if (m) return m[1];
+    }
+    if (href) {
+      const m = href.match(/res_id_encode=([^&]+)/);
+      if (m) return m[1];
+    }
+    return null;
+  };
+
+  const url = location.href;
+  const canonical = (document.querySelector('link[rel="canonical"]') || {}).href || url.split('?')[0];
+  const entities = [];
+  const links = { talent: [], company: [], job: [] };
+
+  if (document.querySelector('#resume-detail-basic-info')) {
+    const basic = first('#resume-detail-basic-info');
+    const sepInfos = basic.querySelectorAll('.basic-cont .sep-info');
+    const parts0 = sepInfos.length > 0 ? splitByI(sepInfos[0]) : [];
+    const parts1 = sepInfos.length > 1 ? splitByI(sepInfos[1]) : [];
+    const joined0 = parts0.join(' ');
+    const age = joined0.match(/(\d+)\s*岁/);
+    const workYears = joined0.match(/工作\s*(\d+)\s*年/);
+    const name = txt(first('.name-box .name', basic));
+    const statusBox = first('.res-status-box', basic);
+    const contactTimeRaw = txt(statusBox);
+    const scm = attr(document.querySelector('[data-tlg-scm]'), 'data-tlg-scm');
+
+    const intentRoot = first('#resume-detail-job-exp-info');
+    const workExperiences = [];
+    document.querySelectorAll('#resume-detail-work-info .rd-work-item-cont').forEach((item) => {
+      const cols = readInfoCols(item);
+      workExperiences.push({
+        company: attr(first('.rd-work-comp h5', item), 'title') || txt(first('.rd-work-comp h5', item)),
+        ...parsePeriod(txt(first('.rd-work-time', item))),
+        position: txt(first('.job-name', item)),
+        department: cols['所在部门'] || null,
+        location: cols['工作地点'] || null,
+        subordinates: cols['下属人数'] != null ? Number(cols['下属人数']) : null,
+        reportsTo: cols['汇报对象'] || null,
+        responsibilities: cols['职责业绩'] || null,
+      });
+    });
+    const projects = [];
+    document.querySelectorAll('#resume-detail-project-info .rd-project-item-cont').forEach((item) => {
+      const cols = readInfoCols(item);
+      projects.push({
+        name: attr(first('.rd-project-name h5', item), 'title') || txt(first('.rd-project-name h5', item)),
+        ...parsePeriod(txt(first('.rd-project-time', item))),
+        role: cols['项目职务'] || null,
+        company: cols['所在公司'] || null,
+        description: cols['项目描述'] || null,
+        duties: cols['项目职责'] || null,
+      });
+    });
+    const education = [];
+    document.querySelectorAll('#resume-detail-edu-info .rd-edu-info-item').forEach((item) => {
+      education.push({
+        school: attr(first('.school-name', item), 'title') || txt(first('.school-name', item)),
+        major: attr(first('.school-special', item), 'title') || txt(first('.school-special', item)),
+        degree: attr(first('.school-degree', item), 'title') || txt(first('.school-degree', item)),
+        period: txt(first('.school-time', item)),
+        tags: Array.from(item.querySelectorAll('.edu-school-tags .tag-item')).map((t) => txt(t)).filter(Boolean),
+      });
+    });
+
+    entities.push({
+      entityType: 'talent',
+      platform: 'liepin',
+      resId: resIdFrom(url, scm),
+      name,
+      nameMasked: name ? /\*/.test(name) : undefined,
+      statusTag: txt(first('.user-status-tag', basic)),
+      gender: parts0.find((p) => /^(男|女)$/.test(p)) || null,
+      age: age ? Number(age[1]) : null,
+      city: parts0.find((p) => /^(北京|上海|广州|深圳|天津|重庆|杭州|南京|苏州|成都|武汉|西安|[一-龥]{2,6})$/.test(p) && !/^(男|女|保密)$/.test(p) && !/岁|年/.test(p)) || null,
+      degree: parts0.find((p) => /(博士|硕士|MBA|本科|大专|专科|高中|中专|初中)/.test(p)) || null,
+      workYears: workYears ? Number(workYears[1]) : null,
+      currentCompany: parts0.length ? parts0[parts0.length - 1] : null,
+      currentCompanyMasked: parts0.includes('保密') ? true : undefined,
+      currentPosition: parts1.length ? parts1[0] : null,
+      contactTime: contactTimeRaw ? contactTimeRaw.replace(/^方便联系时间[:：]\s*/, '') : null,
+      photoUrl: (() => { const img = first('.logo-box img', basic); return img ? abs(img.getAttribute('src')) : null; })(),
+      intent: intentRoot ? {
+        position: attr(first('.tabs .title', intentRoot), 'title') || txt(first('.tabs .title', intentRoot)),
+        salary: txt(first('.tabs .salary', intentRoot)),
+        city: txt(first('.dqname-wrap', intentRoot)),
+        industries: Array.from(intentRoot.querySelectorAll('.lebels-wrap span')).map((s) => txt(s)).filter(Boolean),
+      } : null,
+      workExperiences,
+      projects,
+      education,
+      languages: Array.from(document.querySelectorAll('#resume-detail-lang-info .rd-lang-item .lang-name')).map((el) => txt(el)).filter(Boolean),
+      selfEvaluation: txt(first('#resume-detail-self-eva-info .resume-detail-template-cont')),
+      statement: txt(first('.c-detail-statement')),
+      hasAntiScrapeWatermark: document.querySelectorAll('.cozue').length > 0,
+      url: canonical,
+      source: 'liepin',
+    });
+  } else if (document.querySelector('.talent-resume-card')) {
+    /* 人才管理页/搜索结果列表:.talent-resume-card 卡片(事实源 §7) */
+    document.querySelectorAll('.talent-resume-card').forEach((card) => {
+      const a = first('a.resume-title', card) || first('a[href*="showresumedetail"]', card);
+      const href = a ? abs(attr(a, 'href')) : null;
+      const scm = attr(card, 'data-tlg-scm') || '';
+      const titleLine = attr(a, 'title') || txt(a);
+      const eduItem = Array.from(card.querySelectorAll('.info-item')).find((el) => /最高学历/.test(el.textContent || ''));
+      const workLines = [];
+      card.querySelectorAll('.work-info .info-cont p, .info-cont p').forEach((p) => {
+        const comp = first('.comp', p);
+        const pos = first('.rw-title', p);
+        if (comp || pos) {
+          workLines.push({
+            period: txt(p.querySelector('i')),
+            company: attr(comp, 'title') || txt(comp),
+            position: attr(pos, 'title') || txt(pos),
+          });
+        }
+      });
+      const acquired = txt(first('.right-extension .temp-side', card));
+      const lead = {
+        url: href,
+        name: titleLine ? (titleLine.split(/\s*[|｜]\s*/)[0] || titleLine) : null,
+        titleLine,
+        resId: resIdFrom(href, scm),
+        education: eduItem ? clean((eduItem.textContent || '').replace(/^最高学历[:：]?/, '')) : null,
+        recentWork: workLines,
+        acquiredAt: acquired ? acquired.replace(/^获取时间[:：]?/, '') : null,
+        source: 'liepin',
+      };
+      if (lead.url && !links.talent.some((l) => l.url === lead.url)) links.talent.push(lead);
+    });
+  } else {
+    /* 兜底:任何含简历详情链接的页面,提取链接名单 */
+    document.querySelectorAll('a[href*="showresumedetail"]').forEach((a) => {
+      const href = abs(attr(a, 'href'));
+      if (href && !links.talent.some((l) => l.url === href)) {
+        links.talent.push({ url: href, name: txt(a), resId: resIdFrom(href, ''), source: 'liepin' });
+      }
+    });
+  }
+
+  const pageClass = document.querySelector('#resume-detail-basic-info')
+    ? 'talent'
+    : (document.querySelector('.talent-resume-card') ? 'resume-list' : (links.talent.length ? 'list' : 'unknown'));
+  return {
+    url,
+    canonical,
+    pageClass,
+    title: clean(document.title),
+    extractedAt: new Date().toISOString(),
+    entities,
+    links,
+  };
+})()`;
+var LIEPIN_FILL_AND_SEARCH_SOURCE = String.raw`(async (P) => {
+  const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+  const clean = (s) => (s == null ? null : String(s).replace(/\s+/g, ' ').trim() || null);
+  const delay = P.fieldDelayMs && P.fieldDelayMs >= 0 ? P.fieldDelayMs : 1500;
+  const applied = [];
+  const errors = [];
+
+  /* React 受控输入兼容:native setter + input/change 事件 */
+  const setNativeValue = (el, value) => {
+    const setter = Object.getOwnPropertyDescriptor(
+      el instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype,
+      'value',
+    ).set;
+    setter.call(el, value);
+    el.dispatchEvent(new Event('input', { bubbles: true }));
+    el.dispatchEvent(new Event('change', { bubbles: true }));
+  };
+  const setInput = (sel, value) => {
+    const el = document.querySelector(sel);
+    if (!el) { errors.push('missing_input:' + sel); return false; }
+    if (el.disabled) { errors.push('disabled_input:' + sel); return false; }
+    el.focus();
+    setNativeValue(el, String(value));
+    el.blur();
+    return true;
+  };
+  /* 在某个容器内点击包含指定文本的按钮(如"确 定"/"搜 索") */
+  const clickButtonIn = (rootSel, text) => {
+    const root = rootSel ? document.querySelector(rootSel) : document;
+    if (!root) { errors.push('missing_root:' + rootSel); return false; }
+    const btn = Array.from(root.querySelectorAll('button, span, a')).find((b) => {
+      const t = clean(b.textContent);
+      return t && t.replace(/\s+/g, '') === text;
+    });
+    if (!btn) { errors.push('missing_button:' + text + '@' + rootSel); return false; }
+    btn.click();
+    return true;
+  };
+  /* 点击条件 tag(容器可带 #N 出现序号:如 '.sfilter-city#2' = 第 2 个 sfilter-city,即期望城市) */
+  const clickTag = (containerSel, text) => {
+    let sel = containerSel;
+    let idx = 0;
+    const m = String(containerSel).match(/^(.*)#(\d+)$/);
+    if (m) { sel = m[1]; idx = parseInt(m[2], 10) - 1; }
+    const containers = document.querySelectorAll(sel);
+    const container = containers.length > idx ? containers[idx] : null;
+    if (!container) { errors.push('missing_container:' + containerSel); return false; }
+    const tag = Array.from(container.querySelectorAll('label.tag-item, .tag-item, span')).find((el) => {
+      const t = clean(el.textContent);
+      return t && (t === text || t.replace(/\s+/g, '') === String(text).replace(/\s+/g, ''));
+    });
+    if (!tag) {
+      const available = Array.from(container.querySelectorAll('label.tag-item, .tag-item'))
+        .map((el) => clean(el.textContent))
+        .filter(Boolean)
+        .slice(0, 20);
+      errors.push('missing_tag:' + text + '@' + containerSel
+        + (available.length ? '; available=[' + available.join(', ') + ']' : ''));
+      return false;
+    }
+    tag.click();
+    return true;
+  };
+
+  try {
+    /* 1) 关键词:顶部自动补全输入框(与 .search-btn 同容器,placeholder 搜职位/公司/行业等) */
+    if (P.keyword) {
+      const okInput = (() => {
+        const box = document.querySelector('.auto-input-wrap-v3') || document.querySelector('.ant-select-auto-complete');
+        const el = box ? box.querySelector('input.ant-select-selection-search-input') : null;
+        if (!el) { errors.push('missing_input:keyword'); return false; }
+        el.focus();
+        setNativeValue(el, String(P.keyword));
+        el.dispatchEvent(new Event('input', { bubbles: true }));
+        el.dispatchEvent(new Event('change', { bubbles: true }));
+        el.blur();
+        return true;
+      })();
+      if (okInput) applied.push('keyword');
+      await sleep(delay);
+    }
+
+    /* 2) tag 类条件(每次点击后 human-paced) */
+    const tagSteps = [];
+    if (P.city) tagSteps.push(['.sfilter-city', P.city, 'city']);
+    if (P.expectCity) tagSteps.push(['.sfilter-city#2', P.expectCity, 'expectCity']);
+    if (P.workYear) tagSteps.push(['.sfilter-work-year', P.workYear, 'workYear']);
+    if (P.education) tagSteps.push(['.sfilter-edu', P.education, 'education']);
+    if (P.schoolTag) tagSteps.push(['.sfilter-additional', P.schoolTag, 'schoolTag']);
+    if (P.language) tagSteps.push(['.sfilter-lang', P.language, 'language']);
+    for (const [sel, text, key] of tagSteps) {
+      if (clickTag(sel, text)) applied.push(key);
+      await sleep(delay);
+    }
+
+    /* 3) 区间输入类条件:填输入 + 点容器内"确定" */
+    const rangeSteps = [];
+    if (P.ageMin != null || P.ageMax != null) {
+      rangeSteps.push(['#ageLow', P.ageMin, '#ageHigh', P.ageMax, '.age-shadow-box', 'age']);
+    }
+    if (P.wantSalaryMin != null || P.wantSalaryMax != null) {
+      rangeSteps.push(['#wantSalaryLow', P.wantSalaryMin, '#wantSalaryHigh', P.wantSalaryMax, '.sfilter-salary .search-resume-shadow-box', 'wantSalary']);
+    }
+    if (P.nowSalaryMin != null || P.nowSalaryMax != null) {
+      rangeSteps.push(['#nowSalaryLow', P.nowSalaryMin, '#nowSalaryHigh', P.nowSalaryMax, null, 'nowSalary']);
+    }
+    for (const [loSel, lo, hiSel, hi, boxSel, key] of rangeSteps) {
+      let ok = true;
+      if (lo != null) ok = setInput(loSel, lo) && ok;
+      await sleep(Math.max(600, Math.floor(delay / 2)));
+      if (hi != null) ok = setInput(hiSel, hi) && ok;
+      await sleep(Math.max(600, Math.floor(delay / 2)));
+      /* 确定按钮:优先容器内,其次全局匹配(目前年薪容器无专属 class) */
+      if (ok && !clickButtonIn(boxSel, '确定')) {
+        ok = clickButtonIn(null, '确定');
+      }
+      if (ok) applied.push(key);
+      await sleep(delay);
+    }
+
+    /* 4) 工作年限自定义:先点"自定义"tag 解锁输入,再填 + 确定 */
+    if (P.workYearsMin != null || P.workYearsMax != null) {
+      if (clickTag('.sfilter-work-year', '自定义')) {
+        applied.push('workYearCustom');
+        await sleep(delay);
+        let ok = true;
+        if (P.workYearsMin != null) ok = setInput('#workYearsLow', P.workYearsMin) && ok;
+        await sleep(Math.max(600, Math.floor(delay / 2)));
+        if (P.workYearsMax != null) ok = setInput('#workYearsHigh', P.workYearsMax) && ok;
+        await sleep(Math.max(600, Math.floor(delay / 2)));
+        if (ok && clickButtonIn('.year-custom-box', '确定')) applied.push('workYears');
+      }
+      await sleep(delay);
+    }
+
+    /* 5) 复选框:海外工作经验 / 管理经验 */
+    for (const [name, key] of [['workAbroad', 'workAbroad'], ['managerial', 'managerial']]) {
+      if (P[key]) {
+        const input = document.querySelector('input[name="' + name + '"]');
+        if (input && !input.checked) {
+          const wrapper = input.closest('label') || input;
+          wrapper.click();
+          applied.push(key);
+          await sleep(delay);
+        } else if (!input) {
+          errors.push('missing_checkbox:' + name);
+        }
+      }
+    }
+
+    /* 6) 提交搜索前停顿(类人工审阅),点击顶部"搜 索" */
+    await sleep(Math.max(1500, delay));
+    const searchBtn = document.querySelector('button.search-btn');
+    if (!searchBtn) { errors.push('missing_button:search'); return { applied, errors, submitted: false }; }
+    searchBtn.click();
+    applied.push('submit');
+    return { applied, errors, submitted: true };
+  } catch (e) {
+    errors.push('fill_exception:' + String((e && e.message) || e));
+    return { applied, errors, submitted: false };
+  }
+})`;
+var LIEPIN_RESULT_WAIT_SOURCE = String.raw`(() => {
+  return new Promise((resolve) => {
+    const t0 = Date.now();
+    const tick = () => {
+      let hit = false;
+      try {
+        hit = !!(document.querySelector('.talent-resume-card') || document.querySelector('a[href*="showresumedetail"]'));
+        if (!hit && /没有找到|暂无相关|0\s*条结果|共\s*0\s*条/.test(document.body ? document.body.innerText : '')) return resolve('empty');
+      } catch (e) {}
+      if (hit) return resolve(true);
+      if (Date.now() - t0 > 20000) return resolve(false);
+      setTimeout(tick, 400);
+    };
+    tick();
+  });
+})()`;
+var LIEPIN_NEXT_CLICK_SOURCE = String.raw`(async () => {
+  const next = document.querySelector('.ant-pagination-next button')
+    || document.querySelector('.ant-pagination-next')
+    || document.querySelector('button[aria-label="下一页"]');
+  if (!next || next.getAttribute('aria-disabled') === 'true' || next.disabled) return false;
+  next.click();
+  return true;
+})()`;
+function liepinBlockedCode(blocked) {
+  if (blocked === "LOGIN_WALL") return "LIE_PIN_LOGIN_WALL";
+  if (blocked === "BLANK_KILL") return "LIE_PIN_BLANK_KILL";
+  return "LIE_PIN_CAPTCHA";
+}
+async function runLiepinSearch(args, log, ctx) {
+  const keyword = typeof args.keyword === "string" ? args.keyword.trim() : "";
+  if (!keyword) throw new Error("liepin_search_requires_keyword");
+  const maxPages = Math.min(Math.max(Number(args.maxPages) || 1, 1), 5);
+  const keepTab = args.keepTab === true;
+  const fieldDelayMs = typeof args.delayMs === "number" ? Number(args.delayMs) : 1500;
+  const fillParams = { keyword, fieldDelayMs };
+  for (const k of [
+    "city",
+    "expectCity",
+    "workYear",
+    "education",
+    "schoolTag",
+    "language",
+    "ageMin",
+    "ageMax",
+    "wantSalaryMin",
+    "wantSalaryMax",
+    "nowSalaryMin",
+    "nowSalaryMax",
+    "workYearsMin",
+    "workYearsMax",
+    "workAbroad",
+    "managerial"
+  ]) {
+    if (args[k] !== void 0) fillParams[k] = args[k];
+  }
+  const searchUrl = "https://h.liepin.com/search/getConditionItem";
+  const existing = await chrome.tabs.query({ url: "https://h.liepin.com/search/getConditionItem*" }).catch(() => []);
+  const reusable = existing.find((t) => !!t.id && !!t.url && t.url.startsWith("https://h.liepin.com/search/"));
+  let tab;
+  let reusedExisting = false;
+  if (reusable && reusable.id != null) {
+    tab = reusable;
+    reusedExisting = true;
+    log("info", "hm.liepin.search reusing existing search tab", { tabId: tab.id, url: tab.url });
+  } else {
+    tab = await chrome.tabs.create({ url: searchUrl, active: false });
+    log("info", "hm.liepin.search tab created", { tabId: tab.id, url: searchUrl, maxPages, keyword });
+  }
+  if (ctx.sessionId && !ctx.explicitTab && tab.id) {
+    addTabToSessionGroup(ctx.sessionId, ctx.groupTitle, tab).catch(
+      (err3) => log("warn", "hm.liepin.search addTabToSessionGroup failed", { error: err3.message })
+    );
+  }
+  const leads = /* @__PURE__ */ new Map();
+  const applied = [];
+  const fillErrors = [];
+  let pagesScanned = 0;
+  const assertNotBlocked = async (phase) => {
+    if (tab.id == null) return;
+    const t = await chrome.tabs.get(tab.id).catch(() => null);
+    if (!t) throw new Error(`tab closed while ${phase}`);
+    if (!t.url || t.url === "about:blank") {
+      throw new ControlBlockedError("LIE_PIN_BLANK_KILL", `liepin search aborted at ${phase}: page killed to about:blank (secscan)`);
+    }
+    const blocked = await cdpEvaluate(tab.id, LIEPIN_WALL_CHECK_SOURCE).catch(() => null);
+    if (blocked) {
+      const code = liepinBlockedCode(blocked);
+      log("warn", "hm.liepin.search blocked by liepin risk control", { blocked, code, phase });
+      throw new ControlBlockedError(code, `liepin search aborted at ${phase}: ${blocked}`);
+    }
+  };
+  try {
+    if (tab.id == null) throw new Error("failed_to_create_tab");
+    await waitTabLoaded(tab.id, 3e4);
+    await sleep(1500);
+    await assertNotBlocked("after-load");
+    const fillExpr = "(() => { const P = " + JSON.stringify(fillParams) + "; return (" + LIEPIN_FILL_AND_SEARCH_SOURCE + ")(P); })()";
+    const fillResult = await cdpEvaluate(tab.id, fillExpr, 6e4);
+    applied.push(...fillResult?.applied ?? []);
+    fillErrors.push(...fillResult?.errors ?? []);
+    if (!fillResult?.submitted) {
+      log("warn", "hm.liepin.search fill did not submit", { fillErrors });
+      throw new Error("liepin_search_fill_failed: " + fillErrors.join(";"));
+    }
+    log("info", "hm.liepin.search form submitted", { applied, fillErrors });
+    for (let page = 1; page <= maxPages; page++) {
+      if (tab.id == null) break;
+      const waited = await cdpEvaluate(tab.id, LIEPIN_RESULT_WAIT_SOURCE, 3e4).catch(() => false);
+      await sleep(1200);
+      await assertNotBlocked(`page-${page}`);
+      if (waited === "empty") {
+        log("info", "hm.liepin.search empty result", { page });
+        break;
+      }
+      const extracted = await cdpEvaluate(tab.id, LIEPIN_EXTRACT_SOURCE, 3e4);
+      const pageLeads = extracted?.links?.talent || [];
+      for (const l of pageLeads) {
+        if (l.url && !leads.has(l.url)) {
+          leads.set(l.url, {
+            url: l.url,
+            name: l.name ?? null,
+            titleLine: l.titleLine ?? null,
+            resId: l.resId ?? null,
+            page,
+            source: "liepin"
+          });
+        }
+      }
+      pagesScanned = page;
+      log("info", "hm.liepin.search page extracted", { page, pageLeads: pageLeads.length, total: leads.size });
+      if (page >= maxPages) break;
+      const clicked = await cdpEvaluate(tab.id, LIEPIN_NEXT_CLICK_SOURCE).catch(() => false);
+      if (!clicked) break;
+      await sleep(3e3 + Math.random() * 2e3);
+      await assertNotBlocked(`page-${page}-next`);
+    }
+  } finally {
+    if (!keepTab && !reusedExisting && tab.id != null) {
+      await closeTabGracefully(tab.id);
+    }
+  }
+  return {
+    keyword,
+    searchUrl,
+    pagesScanned,
+    leadCount: leads.size,
+    leads: Array.from(leads.values()),
+    applied,
+    fillErrors,
+    keepTab,
+    reusedExisting,
+    // tabId 如实记录:自建 tab 关闭后置 null;复用 tab 一定返回其 id(调用方可追踪/不再开)
+    tabId: reusedExisting ? tab.id ?? null : keepTab ? tab.id ?? null : null
   };
 }
 var HIREDCHINA_EXTRACT_SOURCE = String.raw`(async () => {
@@ -2611,6 +3248,14 @@ async function handleCookiesCommand(args) {
   }
   throw new Error(`cookies_unknown_action: ${action}`);
 }
+async function closeTabGracefully(tabId) {
+  await detachIfAttached(tabId);
+  await Promise.race([
+    chrome.tabs.remove(tabId),
+    new Promise((_, reject) => setTimeout(() => reject(new Error("tab_remove_timeout")), 5e3))
+  ]).catch(() => {
+  });
+}
 async function handleTabCommand(command, args, log) {
   const tabArg = args.tab ?? args.targetId ?? args.page;
   switch (command) {
@@ -2632,6 +3277,23 @@ async function handleTabCommand(command, args, log) {
       log("info", "cp.tab.new created", { page: String(tab.id), url: tab.url ?? url, active });
       return { page: String(tab.id), url: tab.url ?? url };
     }
+    case "cp.tab.open": {
+      const url = typeof args.url === "string" && args.url.trim() ? args.url.trim() : "";
+      if (!url) throw new Error("tab_open_requires_url");
+      if (!/^https?:\/\//.test(url)) throw new Error("tab_open_requires_http_url: " + url);
+      const active = args.active === true;
+      const pattern = url.includes("*") ? url : url + "*";
+      const candidates = await chrome.tabs.query({ url: pattern }).catch(() => []);
+      const hit = candidates.find((t) => !!t.id && !!t.url && t.url.startsWith("http"));
+      if (hit && hit.id != null) {
+        await chrome.tabs.update(hit.id, { active }).catch(() => void 0);
+        log("info", "cp.tab.open reused existing tab", { page: String(hit.id), url: hit.url, active });
+        return { page: String(hit.id), url: hit.url, reused: true };
+      }
+      const tab = await chrome.tabs.create({ url, active });
+      log("info", "cp.tab.open created tab", { page: String(tab.id), url: tab.url ?? url, active });
+      return { page: String(tab.id), url: tab.url ?? url, reused: false };
+    }
     case "cp.tab.select": {
       if (!tabArg) throw new Error("tab_select_requires_tab_id");
       const tabId = Number(tabArg);
@@ -2642,7 +3304,7 @@ async function handleTabCommand(command, args, log) {
     }
     case "cp.tab.close": {
       if (!tabArg) throw new Error("tab_close_requires_tab_id");
-      await chrome.tabs.remove(Number(tabArg));
+      await closeTabGracefully(Number(tabArg));
       return { closed: true, page: String(tabArg) };
     }
     case "cp.tab.bind": {
@@ -2825,7 +3487,7 @@ function maybeDiscover(url, title) {
   });
 }
 
-// ../../node_modules/.pnpm/@chromepilot+logger-kit@0.1.3_@nestjs+common@10.4.22_class-transformer@0.5.1_class-validator@_v44hq6ikmqzoani6tawke4nway/node_modules/@chromepilot/logger-kit/dist/client/logger.js
+// ../../node_modules/.pnpm/@chromepilot+logger-kit@0.1.4_@nestjs+common@10.4.22_class-transformer@0.5.1_class-validator@_legcruqwso5xb42h6lrzoll4b4/node_modules/@chromepilot/logger-kit/dist/client/logger.js
 function stringifyArg(arg) {
   if (typeof arg === "string")
     return arg;
@@ -2977,7 +3639,7 @@ var Logger = class {
   }
 };
 
-// ../../node_modules/.pnpm/@chromepilot+logger-kit@0.1.3_@nestjs+common@10.4.22_class-transformer@0.5.1_class-validator@_v44hq6ikmqzoani6tawke4nway/node_modules/@chromepilot/logger-kit/dist/client/transports/http-transport.js
+// ../../node_modules/.pnpm/@chromepilot+logger-kit@0.1.4_@nestjs+common@10.4.22_class-transformer@0.5.1_class-validator@_legcruqwso5xb42h6lrzoll4b4/node_modules/@chromepilot/logger-kit/dist/client/transports/http-transport.js
 async function createHttpTransport(opts) {
   const serverUrl = opts.serverUrl.replace(/\/$/, "");
   return async (logs) => {
@@ -3164,36 +3826,58 @@ createBackgroundLogForwarder({
 }).then((f) => {
   logForwarder = f;
 });
-var socket = null;
-var SEND_QUEUE_LIMIT = 500;
-var sendQueue = [];
-var queuedDropped = 0;
-function isFullSnapshot(payload) {
-  return payload?.type === "rrweb" && payload?.payload?.type === 2;
-}
-function enqueueRecordingEvent(payload) {
-  sendQueue.push({ raw: JSON.stringify(payload), isSnapshot: isFullSnapshot(payload) });
-  while (sendQueue.length > SEND_QUEUE_LIMIT) {
-    const idx = sendQueue.findIndex((item) => !item.isSnapshot);
-    if (idx === -1) break;
-    sendQueue.splice(idx, 1);
-    queuedDropped++;
-  }
-}
-function flushSendQueue() {
-  if (!socket || socket.readyState !== WebSocket.OPEN || !sendQueue.length) return;
-  while (sendQueue.length) {
-    const item = sendQueue.shift();
+var OFFSCREEN_URL = "offscreen/offscreen.html";
+function sendToOffscreen(raw) {
+  chrome.runtime.sendMessage({ type: "offscreen:send", raw }).catch(() => {
+  });
+}
+function sendInitToOffscreen() {
+  const manifest = chrome.runtime.getManifest();
+  chrome.runtime.sendMessage({ type: "offscreen:init", extensionId: chrome.runtime.id, version: manifest.version }).catch(() => {
+  });
+}
+async function ensureOffscreen() {
+  try {
+    const contexts = await chrome.runtime.getContexts({
+      contextTypes: [chrome.runtime.ContextType.OFFSCREEN_DOCUMENT]
+    });
+    if (contexts.length > 0) {
+      sendInitToOffscreen();
+      return;
+    }
     try {
-      socket.send(item.raw);
-    } catch (e) {
-      console.error("[HunterMate] flush send failed", e);
-      break;
+      await chrome.offscreen.createDocument({
+        url: OFFSCREEN_URL,
+        // D1: WEBSOCKET 枚举从未在正式 Chrome 落地(152 实测抛枚举非法),必须用 WORKERS;
+        // @types/chrome 0.0.268 的 Reason 枚举同样没有 WEBSOCKET 成员,断言方向一致
+        reasons: ["WORKERS"],
+        justification: "hunter-mate \u9700\u4E0E\u672C\u5730 server \u4FDD\u6301\u5E38\u9A7B WebSocket \u8FDE\u63A5(MV3 SW \u4F1A\u88AB\u7A7A\u95F2\u56DE\u6536)"
+      });
+      sendInitToOffscreen();
+    } catch (createErr) {
+      const msg = createErr instanceof Error ? createErr.message : String(createErr);
+      sendLog("warn", "ensureOffscreen createDocument failed, retry after closeDocument", { error: msg });
+      try {
+        await chrome.offscreen.closeDocument();
+      } catch {
+      }
+      await new Promise((r) => setTimeout(r, 1e3));
+      await chrome.offscreen.createDocument({
+        url: OFFSCREEN_URL,
+        reasons: ["WORKERS"],
+        justification: "hunter-mate \u9700\u4E0E\u672C\u5730 server \u4FDD\u6301\u5E38\u9A7B WebSocket \u8FDE\u63A5(MV3 SW \u4F1A\u88AB\u7A7A\u95F2\u56DE\u6536)"
+      });
+      sendInitToOffscreen();
     }
+  } catch (err3) {
+    console.error("[HunterMate] ensureOffscreen failed", err3);
+    sendLog("error", "ensureOffscreen failed", { error: err3 instanceof Error ? err3.message : String(err3) });
   }
-  if (queuedDropped > 0) {
-    console.warn(`[HunterMate] send queue overflow, dropped ${queuedDropped} incremental events (snapshots kept)`);
-    queuedDropped = 0;
+  try {
+    const st = await chrome.runtime.sendMessage({ type: "offscreen:get-state" });
+    state.wsConnected = !!st?.wsConnected;
+    broadcastState();
+  } catch {
   }
 }
 function sendLog(level, message, meta) {
@@ -3201,14 +3885,7 @@ function sendLog(level, message, meta) {
     backgroundLogger[level === "debug" ? "debug" : level]("extension:sendLog", { message, meta });
   } catch {
   }
-  const ws = socket;
-  if (ws?.readyState === WebSocket.OPEN) {
-    try {
-      ws.send(JSON.stringify({ type: "log", level, message, meta }));
-    } catch (e) {
-      console.error("[HunterMate] sendLog failed", e);
-    }
-  }
+  sendToOffscreen(JSON.stringify({ type: "log", level, message, meta }));
   const prefix = `[HunterMate] ${message}`;
   if (level === "debug") {
     console.debug(prefix, meta ?? "");
@@ -3281,101 +3958,72 @@ function broadcastState() {
     });
   });
 }
-function connect() {
-  if (socket) return;
-  socket = new WebSocket(WS_URL);
-  socket.onopen = () => {
-    state.wsConnected = true;
-    console.log("[HunterMate] connected to local server");
-    socket?.send(
-      JSON.stringify({
-        type: "hello",
-        extensionId: chrome.runtime.id,
-        version: chrome.runtime.getManifest().version,
-        capabilities: ["cp.*", "hm.*"]
-      })
-    );
-    flushSendQueue();
-    broadcastState();
-    backgroundLogger.info("ws:connected", { extensionId: chrome.runtime.id });
-  };
-  socket.onclose = () => {
-    socket = null;
-    state.wsConnected = false;
-    broadcastState();
-    backgroundLogger.warn("ws:closed", { reconnectDelayMs: 5e3 });
-    setTimeout(connect, 5e3);
-  };
-  socket.onerror = (err3) => {
-    backgroundLogger.error("ws:error", { message: String(err3) });
-  };
-  socket.onmessage = async (event) => {
-    let data;
-    try {
-      data = JSON.parse(event.data);
-    } catch {
-      return;
-    }
-    if (data.type === "pong" || data.type === "status" || data.type === "ack") return;
-    if (data.type === "reload") {
-      console.log("[HunterMate] received reload broadcast, reloading extension in 200ms...");
-      setTimeout(() => chrome.runtime.reload(), 200);
-      return;
-    }
-    if (data.type === "cmd" && data.requestId) {
-      const startedAt = Date.now();
-      sendLog("info", "extension handling control command", { command: data.command, requestId: data.requestId, params: data.params });
-      let outcome;
-      if (data.command === "hm.status") {
-        const manifest = chrome.runtime.getManifest();
-        outcome = {
-          status: "ok",
-          result: {
-            ...state,
-            tabStatesCount: tabStates.size,
-            extBasePath: chrome.runtime.getURL(""),
-            manifestPermissions: manifest.permissions,
-            hasSidePanelInManifest: manifest.permissions?.includes("sidePanel"),
-            chromeSidePanelType: typeof chrome.sidePanel
-          }
-        };
-      } else {
-        try {
-          outcome = await executeControlCommand(String(data.command ?? ""), data.params ?? {}, {
-            onLog: (level, message, meta) => sendLog(level, message, meta),
-            sessionId: typeof data.sessionId === "string" ? data.sessionId : void 0
-          });
-        } catch (e) {
-          outcome = { status: "error", message: e instanceof Error ? e.message : String(e) };
-        }
-      }
-      const resp = outcome.status === "ok" ? {
-        type: "cmd_response",
-        requestId: data.requestId,
+async function handleServerMessage(data) {
+  if (!data || typeof data !== "object") return;
+  if (data.type === "pong" || data.type === "status" || data.type === "ack") return;
+  if (data.type === "reload") {
+    console.log("[HunterMate] received reload broadcast, reloading extension in 200ms...");
+    setTimeout(() => chrome.runtime.reload(), 200);
+    return;
+  }
+  if (data.type === "cmd" && data.requestId) {
+    const startedAt = Date.now();
+    sendLog("info", "extension handling control command", { command: data.command, requestId: data.requestId, params: data.params });
+    let outcome;
+    if (data.command === "hm.status") {
+      const manifest = chrome.runtime.getManifest();
+      outcome = {
         status: "ok",
-        // undefined 显式归一为 null:JSON.stringify 会丢 undefined 键,
-        // 调用方无法区分"无 result 键"与"result 为 undefined"
-        result: outcome.result === void 0 ? null : outcome.result,
-        durationMs: Date.now() - startedAt
-      } : {
-        type: "cmd_response",
-        requestId: data.requestId,
-        status: "error",
-        error: { code: outcome.code, message: outcome.message },
-        durationMs: Date.now() - startedAt
+        result: {
+          ...state,
+          tabStatesCount: tabStates.size,
+          extBasePath: chrome.runtime.getURL(""),
+          manifestPermissions: manifest.permissions,
+          hasSidePanelInManifest: manifest.permissions?.includes("sidePanel"),
+          chromeSidePanelType: typeof chrome.sidePanel,
+          wsHeldBy: "offscreen"
+        }
       };
+    } else {
       try {
-        socket?.send(JSON.stringify(resp));
-        sendLog("debug", "cmd_response sent", { requestId: data.requestId, status: resp.status, durationMs: resp.durationMs });
+        outcome = await executeControlCommand(String(data.command ?? ""), data.params ?? {}, {
+          onLog: (level, message, meta) => sendLog(level, message, meta),
+          sessionId: typeof data.sessionId === "string" ? data.sessionId : void 0
+        });
       } catch (e) {
-        sendLog("error", "cmd_response send failed", { requestId: data.requestId, error: e instanceof Error ? e.message : String(e) });
+        outcome = { status: "error", message: e instanceof Error ? e.message : String(e) };
       }
-      return;
     }
-    console.log("[HunterMate] server message", data);
-  };
+    const resp = outcome.status === "ok" ? {
+      type: "cmd_response",
+      requestId: data.requestId,
+      status: "ok",
+      // undefined 显式归一为 null:JSON.stringify 会丢 undefined 键,
+      // 调用方无法区分"无 result 键"与"result 为 undefined"
+      result: outcome.result === void 0 ? null : outcome.result,
+      durationMs: Date.now() - startedAt
+    } : {
+      type: "cmd_response",
+      requestId: data.requestId,
+      status: "error",
+      error: { code: outcome.code, message: outcome.message },
+      durationMs: Date.now() - startedAt
+    };
+    sendToOffscreen(JSON.stringify(resp));
+    sendLog("debug", "cmd_response sent", { requestId: data.requestId, status: resp.status, durationMs: resp.durationMs });
+  }
 }
-connect();
+chrome.runtime.onMessage.addListener((message) => {
+  if (message?.type === "offscreen:ws-state") {
+    state.wsConnected = !!message.wsConnected;
+    broadcastState();
+    return;
+  }
+  if (message?.type === "offscreen:ws-message") {
+    void handleServerMessage(message.payload);
+    return;
+  }
+});
 var RECONNECT_ALARM_NAME = "hm:reconnect";
 function ensureReconnectAlarm() {
   chrome.alarms.create(RECONNECT_ALARM_NAME, { periodInMinutes: 0.5 }).catch((err3) => console.error("[HunterMate] create reconnect alarm failed", err3));
@@ -3383,21 +4031,24 @@ function ensureReconnectAlarm() {
 chrome.alarms.onAlarm.addListener((alarm) => {
   if (alarm.name !== RECONNECT_ALARM_NAME) return;
   checkHttpHealth();
-  if (socket && socket.readyState !== WebSocket.OPEN && socket.readyState !== WebSocket.CONNECTING) {
-    socket = null;
-  }
-  if (!socket) {
-    connect();
-  }
+  sendLog("debug", "sw:alarm-tick", { wsConnected: state.wsConnected });
+  void ensureOffscreen();
 });
 ensureReconnectAlarm();
+void ensureOffscreen();
+chrome.runtime.onInstalled.addListener(() => {
+  console.log("[HunterMate] onInstalled: cold-start offscreen");
+  ensureReconnectAlarm();
+  void ensureOffscreen();
+});
+chrome.runtime.onStartup.addListener(() => {
+  console.log("[HunterMate] onStartup: cold-start offscreen");
+  ensureReconnectAlarm();
+  void ensureOffscreen();
+});
 setInterval(() => {
   checkHttpHealth();
-  if (socket?.readyState === WebSocket.OPEN) {
-    socket.send(JSON.stringify({ type: "ping" }));
-  } else {
-    connect();
-  }
+  void ensureOffscreen();
   broadcastState();
 }, 2e4);
 setInterval(() => {
@@ -3433,6 +4084,14 @@ chrome.tabs.onUpdated.addListener((_tabId, changeInfo, tab) => {
   }
   if (changeInfo.url) {
     broadcastState();
+    if (state.wsConnected) {
+      sendToOffscreen(JSON.stringify({ type: "tab_event", event: "navigated", tabId: _tabId, url: changeInfo.url, ts: Date.now() }));
+    }
+  }
+});
+chrome.tabs.onCreated.addListener((t) => {
+  if (state.wsConnected) {
+    sendToOffscreen(JSON.stringify({ type: "tab_event", event: "created", tabId: t.id, url: t.url ?? null, openerTabId: t.openerTabId ?? null, windowId: t.windowId, index: t.index, ts: Date.now() }));
   }
 });
 chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
@@ -3482,11 +4141,7 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
   if (message.type === "recording-event") {
     const tabId = sender.tab?.id ?? -1;
     const payload = { ...message.payload, tabId };
-    if (socket?.readyState === WebSocket.OPEN) {
-      socket.send(JSON.stringify(payload));
-    } else {
-      enqueueRecordingEvent(payload);
-    }
+    sendToOffscreen(JSON.stringify(payload));
     const ts = tabStates.get(tabId);
     if (ts && message.payload?.sessionId === ts.recordingSessionId) {
       ts.eventCount++;