@opentiny/next-sdk 0.4.1 → 0.4.3

package/page-tools/constants.ts

@@ -1,72 +0,0 @@
-/** 校验错误默认选择器：ARIA 标准 + 主流 UI 框架 */
-export const DEFAULT_ERROR_SELECTORS: string[] = [
-  // W3C ARIA 标准（最可靠，框架无关）
-  '[role="alert"]',
-  '[aria-invalid="true"]',
-  // Tiny3 / Lego（华为云）
-  '.ti3-unifyvalid-error',
-  '.ti3-error',
-  '.ti-error',
-  '.lego-text-error',
-  '.lego-error',
-  // Element UI / Element Plus
-  '.el-form-item__error',
-  // Ant Design
-  '.ant-form-item-explain-error',
-  // Bootstrap
-  '.is-invalid',
-  '.invalid-feedback',
-  // Angular
-  '.ng-invalid',
-  // 通用命名约定
-  '.error-msg',
-  '.error-message',
-  '.error-text',
-  '.field-error',
-  '.form-error',
-  '.is-error',
-  '.has-error',
-  '.validate-error',
-  '.valid-error'
-]
-
-/** 模态弹窗默认选择器：ARIA 标准 + 主流 UI 框架 */
-export const DEFAULT_DIALOG_SELECTORS: string[] = [
-  // W3C ARIA 标准
-  '[role="dialog"]',
-  '[role="alertdialog"]',
-  // Tiny3 / Lego（华为云）
-  '[class*="ti3-modal"]',
-  '[class*="ti3-message-box"]',
-  // Element UI / Element Plus
-  '[class*="el-dialog"]',
-  '[class*="el-message-box"]',
-  // Ant Design
-  '[class*="ant-modal"]',
-  // Bootstrap
-  '[class*="modal-content"]',
-  // Vuetify
-  '[class*="v-dialog"]',
-  // Naive UI
-  '[class*="n-modal"]'
-]
-
-export interface PageAgentToolOptions {
-  /** 允许在无障碍树节点中额外暴露的 DOM 属性白名单 */
-  exposedAttributes?: string[]
-  /** 是否启用元素高亮 */
-  enableHighlight?: boolean
-}
-
-declare global {
-  interface Window {
-    __webmcpcli_interactiveWhitelist?: Element[]
-    __webmcpcli_interactiveBlacklist?: Element[]
-    __webmcpcli_exposedAttributes?: string[]
-    __webmcpcli_beforeGetBrowserState?: (() => void) | null
-    /** 校验错误元素 CSS 选择器列表（覆盖默认，用于检测页面可见的校验错误） */
-    __webmcpcli_errorSelectors?: string[]
-    /** 模态弹窗元素 CSS 选择器列表（覆盖默认，用于检测阻塞交互的弹窗） */
-    __webmcpcli_dialogSelectors?: string[]
-  }
-}

package/page-tools/context.ts

@@ -1,13 +0,0 @@
-import type { PageController } from '@page-agent/page-controller'
-import type { PageStateCache } from './page-state-cache'
-import type { RefMap } from './a11y-tree'
-
-export interface ActionContext {
-  pageController: PageController
-  stateCache: PageStateCache
-  getRefMap: () => RefMap
-  setRefMap: (map: RefMap) => void
-  buildBrowserStateResponse: (mode?: 'full' | 'diff' | 'both') => Promise<{ content: Array<{ type: 'text'; text: string }> }>
-  refreshOnStaleRef: (action: string, index: number) => Promise<{ content: Array<{ type: 'text'; text: string }> }>
-  errContent: (msg: string) => Promise<{ content: Array<{ type: 'text'; text: string }> }>
-}

package/page-tools/effects.ts

@@ -1,345 +0,0 @@
-/**
- * page-tools/effects - 页面工具调用提示效果模块（框架无关）
- *
- * 作用：
- * - 在调用通过 withPageTools 注册的页面工具时，显示页面级的调用状态提示
- * - 以左下角小 tip 形式展示“当前正在调用的工具”文案，尽量不打扰用户操作
- * - 纯 DOM + CSS 实现，不依赖 Vue/React 等框架
- */
-
-export type ToolInvokeEffectConfig = {
-  /**
-   * 自定义提示文案，默认使用“工具标题 || 工具名称”
-   * 例如："正在为你整理订单数据"
-   */
-  label?: string
-}
-
-type RuntimeEffectConfig = {
-  label: string
-}
-
-let overlayElement: HTMLDivElement | null = null
-let labelElement: HTMLDivElement | null = null
-let styleElement: HTMLStyleElement | null = null
-let activeCount = 0
-
-import { isDomAvailable } from '../utils/env'
-
-const BODY_GLOW_CLASS = 'next-sdk-tool-body-glow'
-
-function ensureDomReady() {
-  return isDomAvailable()
-}
-
-function ensureStyleElement() {
-  if (!ensureDomReady()) return
-  if (styleElement) return
-
-  const style = document.createElement('style')
-  style.textContent = `
-  .${BODY_GLOW_CLASS} {
-    position: relative;
-  }
-
-  .next-sdk-tool-overlay {
-    position: fixed;
-    inset: 0;
-    z-index: 999999;
-    pointer-events: none;
-    display: flex;
-    align-items: flex-end;
-    justify-content: flex-start;
-    padding: 0 0 18px 18px;
-    background: transparent;
-    animation: next-sdk-overlay-fade-in 260ms ease-out;
-  }
-
-  .next-sdk-tool-overlay--exit {
-    animation: next-sdk-overlay-fade-out 220ms ease-in forwards;
-  }
-
-  .next-sdk-tool-overlay__glow-ring {
-    display: none;
-  }
-
-  .next-sdk-tool-overlay__panel {
-    position: relative;
-    min-width: min(320px, 78vw);
-    max-width: min(420px, 82vw);
-    padding: 10px 14px;
-    border-radius: 999px;
-    background:
-      linear-gradient(135deg, rgba(15, 23, 42, 0.9), rgba(17, 24, 39, 0.9)),
-      radial-gradient(circle at top left, rgba(96, 165, 250, 0.25), transparent 55%),
-      radial-gradient(circle at bottom right, rgba(45, 212, 191, 0.22), transparent 60%);
-    box-shadow:
-      0 12px 28px rgba(15, 23, 42, 0.78),
-      0 0 0 1px rgba(148, 163, 184, 0.26);
-    display: flex;
-    align-items: center;
-    gap: 10px;
-    pointer-events: none;
-    transform-origin: center;
-    animation: next-sdk-panel-pop-in 260ms cubic-bezier(0.18, 0.89, 0.32, 1.28);
-    color: #e5e7eb;
-    font-family: system-ui, -apple-system, BlinkMacSystemFont, "SF Pro Text", sans-serif;
-  }
-
-  .next-sdk-tool-overlay__indicator {
-    width: 26px;
-    height: 26px;
-    border-radius: 999px;
-    background: radial-gradient(circle at 30% 10%, #f9fafb, #93c5fd);
-    box-shadow:
-      0 0 0 1px rgba(191, 219, 254, 0.6),
-      0 8px 18px rgba(37, 99, 235, 0.8),
-      0 0 28px rgba(56, 189, 248, 0.9);
-    position: relative;
-    flex-shrink: 0;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    overflow: hidden;
-  }
-
-  .next-sdk-tool-overlay__indicator-orbit {
-    position: absolute;
-    inset: 2px;
-    border-radius: inherit;
-    border: 1px solid rgba(248, 250, 252, 0.6);
-    box-sizing: border-box;
-    opacity: 0.9;
-  }
-
-  .next-sdk-tool-overlay__indicator-orbit::before {
-    content: '';
-    position: absolute;
-    width: 6px;
-    height: 6px;
-    border-radius: 999px;
-    background: #f9fafb;
-    box-shadow:
-      0 0 12px rgba(248, 250, 252, 0.9),
-      0 0 24px rgba(250, 249, 246, 0.9);
-    top: 0;
-    left: 50%;
-    transform: translate(-50%, -50%);
-    transform-origin: 50% 18px;
-    animation: next-sdk-indicator-orbit 1.4s linear infinite;
-  }
-
-  .next-sdk-tool-overlay__indicator-core {
-    width: 14px;
-    height: 14px;
-    border-radius: inherit;
-    background: radial-gradient(circle at 30% 20%, #f9fafb, #bfdbfe);
-    box-shadow:
-      0 0 12px rgba(248, 250, 252, 0.9),
-      0 0 32px rgba(191, 219, 254, 0.8);
-    opacity: 0.96;
-  }
-
-  .next-sdk-tool-overlay__content {
-    display: flex;
-    flex-direction: column;
-    gap: 1px;
-    min-width: 0;
-  }
-
-  .next-sdk-tool-overlay__title {
-    font-size: 11px;
-    letter-spacing: 0.08em;
-    text-transform: uppercase;
-    color: rgba(156, 163, 175, 0.96);
-    display: flex;
-    align-items: center;
-    gap: 6px;
-  }
-
-  .next-sdk-tool-overlay__title-dot {
-    width: 6px;
-    height: 6px;
-    border-radius: 999px;
-    background: #22c55e;
-    box-shadow:
-      0 0 8px rgba(34, 197, 94, 0.9),
-      0 0 14px rgba(22, 163, 74, 0.9);
-  }
-
-  .next-sdk-tool-overlay__label {
-    font-size: 12px;
-    font-weight: 500;
-    color: #e5e7eb;
-    white-space: nowrap;
-    text-overflow: ellipsis;
-    overflow: hidden;
-  }
-
-  @keyframes next-sdk-overlay-fade-in {
-    from { opacity: 0; }
-    to { opacity: 1; }
-  }
-
-  @keyframes next-sdk-overlay-fade-out {
-    from { opacity: 1; }
-    to { opacity: 0; }
-  }
-
-  @keyframes next-sdk-indicator-orbit {
-    from {
-      transform: translate(-50%, -50%) rotate(0deg) translateY(0);
-    }
-    to {
-      transform: translate(-50%, -50%) rotate(360deg) translateY(0);
-    }
-  }
-
-  @keyframes next-sdk-panel-pop-in {
-    0% {
-      opacity: 0;
-      transform: scale(0.92) translateY(10px);
-    }
-    100% {
-      opacity: 1;
-      transform: scale(1) translateY(0);
-    }
-  }
-  `
-
-  document.head.appendChild(style)
-  styleElement = style
-}
-
-function ensureOverlayElement() {
-  if (!ensureDomReady()) return
-  if (overlayElement) return
-
-  ensureStyleElement()
-
-  const overlay = document.createElement('div')
-  overlay.className = 'next-sdk-tool-overlay'
-
-  const glowRing = document.createElement('div')
-  glowRing.className = 'next-sdk-tool-overlay__glow-ring'
-
-  const panel = document.createElement('div')
-  panel.className = 'next-sdk-tool-overlay__panel'
-
-  const indicator = document.createElement('div')
-  indicator.className = 'next-sdk-tool-overlay__indicator'
-
-  const indicatorOrbit = document.createElement('div')
-  indicatorOrbit.className = 'next-sdk-tool-overlay__indicator-orbit'
-
-  const indicatorCore = document.createElement('div')
-  indicatorCore.className = 'next-sdk-tool-overlay__indicator-core'
-
-  const content = document.createElement('div')
-  content.className = 'next-sdk-tool-overlay__content'
-
-  const titleRow = document.createElement('div')
-  titleRow.className = 'next-sdk-tool-overlay__title'
-  titleRow.textContent = 'AI 正在调用页面工具'
-
-  const titleDot = document.createElement('span')
-  titleDot.className = 'next-sdk-tool-overlay__title-dot'
-
-  const label = document.createElement('div')
-  label.className = 'next-sdk-tool-overlay__label'
-
-  titleRow.prepend(titleDot)
-  content.appendChild(titleRow)
-  content.appendChild(label)
-
-  indicator.appendChild(indicatorOrbit)
-  indicator.appendChild(indicatorCore)
-  panel.appendChild(indicator)
-  panel.appendChild(content)
-  overlay.appendChild(glowRing)
-  overlay.appendChild(panel)
-
-  document.body.appendChild(overlay)
-
-  overlayElement = overlay
-  labelElement = label
-}
-
-function updateOverlay(config: RuntimeEffectConfig) {
-  if (!ensureDomReady()) return
-  ensureOverlayElement()
-  if (!overlayElement || !labelElement) return
-  overlayElement.classList.remove('next-sdk-tool-overlay--exit')
-  labelElement.textContent = config.label
-}
-
-function removeOverlayWithAnimation() {
-  if (!overlayElement) return
-  overlayElement.classList.add('next-sdk-tool-overlay--exit')
-  const localOverlay = overlayElement
-  let handled = false
-  let timerId: ReturnType<typeof setTimeout> | undefined
-  const handle = () => {
-    if (handled) return
-    handled = true
-    if (timerId !== undefined) {
-      clearTimeout(timerId)
-      timerId = undefined
-    }
-    if (localOverlay.parentNode) {
-      localOverlay.parentNode.removeChild(localOverlay)
-    }
-    if (overlayElement === localOverlay) {
-      overlayElement = null
-      labelElement = null
-    }
-    localOverlay.removeEventListener('animationend', handle)
-  }
-  localOverlay.addEventListener('animationend', handle)
-  // 兜底：若 animationend 未触发（如 prefers-reduced-motion 或样式被覆盖），确保清理
-  timerId = setTimeout(handle, 500)
-}
-
-/**
- * 在页面上显示工具调用提示效果。
- * - 若当前已有其他工具在执行，仅更新文案，不重复创建 DOM
- * - 会增加 activeCount 计数，需配对调用 hideToolInvokeEffect
- */
-export function showToolInvokeEffect(config: RuntimeEffectConfig) {
-  if (!ensureDomReady()) return
-  activeCount += 1
-  updateOverlay(config)
-}
-
-/**
- * 隐藏工具调用提示效果。
- * - 使用引用计数：只有当所有调用结束后才真正移除 Overlay
- */
-export function hideToolInvokeEffect() {
-  if (!ensureDomReady() || activeCount <= 0) return
-  activeCount -= 1
-  if (activeCount === 0) {
-    removeOverlayWithAnimation()
-  }
-}
-
-/**
- * 将 RouteConfig 中的 invokeEffect 配置编译成运行时效果配置。
- * - boolean / undefined：关闭或开启默认文案
- * - 对象：允许自定义 label
- */
-export function resolveRuntimeEffectConfig(
-  toolName: string,
-  toolTitle: string | undefined,
-  value: boolean | ToolInvokeEffectConfig | undefined
-): RuntimeEffectConfig | undefined {
-  if (!value) return undefined
-  const baseLabel = toolTitle || toolName
-  if (typeof value === 'boolean') {
-    return value ? { label: baseLabel } : undefined
-  }
-  return {
-    label: value.label || baseLabel
-  }
-}
-

package/page-tools/handlers/browserState.ts

@@ -1,12 +0,0 @@
-import type { ActionContext } from '../context'
-
-export async function handleBrowserState(args: any, ctx: ActionContext) {
-  if (window.__webmcpcli_beforeGetBrowserState) {
-    try {
-      window.__webmcpcli_beforeGetBrowserState()
-    } catch (e) {
-      console.warn('__webmcpcli_beforeGetBrowserState error:', e)
-    }
-  }
-  return ctx.buildBrowserStateResponse(args.responseMode ?? 'diff')
-}

package/page-tools/handlers/click.ts

@@ -1,26 +0,0 @@
-import { clickElement } from '@page-agent/page-controller'
-import { waitForDomSettled } from '../utils/dom'
-import type { ActionContext } from '../context'
-
-export async function handleClick(args: any, ctx: ActionContext) {
-  const mode = args.responseMode ?? 'diff'
-  if (args.index === undefined) return ctx.errContent('点击结果: 缺少元素索引')
-  const el = ctx.getRefMap().get(args.index)
-  if (!el) return ctx.refreshOnStaleRef('点击', args.index)
-
-  // 若 ref 指向 shadow host，解析其内部真正的可点击元素
-  let targetEl = el as HTMLElement
-  if (el.shadowRoot && !(el instanceof HTMLButtonElement) && !(el instanceof HTMLAnchorElement)) {
-    const innerClickable = el.shadowRoot.querySelector(
-      'button, a, [role="button"], [role="link"]'
-    ) as HTMLElement | null
-    if (innerClickable) {
-      targetEl = innerClickable
-    }
-  }
-  await clickElement(targetEl)
-  // 等待框架异步插入的校验错误/条件渲染内容稳定后再采集状态
-  await waitForDomSettled()
-  // 操作成功后自动返回 diff/both/full
-  return ctx.buildBrowserStateResponse(mode)
-}

package/page-tools/handlers/executeJavascript.ts

@@ -1,22 +0,0 @@
-import type { ActionContext } from '../context'
-
-export async function handleExecuteJavascript(args: any, ctx: ActionContext) {
-  if (!args.script) return ctx.errContent('脚本执行异常: 缺少javascript代码')
-  // eslint-disable-next-line no-new-func
-  // 方式1：将脚本包裹在 async IIFE 中执行，允许 return 语句
-  let result = await new Function(`return (async () => { ${args.script} })()`)()
-  // 方式2：若 result 为 undefined（脚本没有 return），降级尝试以表达式方式求值
-  // 场景：Agent 写了 "Array.from(...).map(...)" 但没有 return 关键字
-  if (result === undefined) {
-    try {
-      // eslint-disable-next-line no-new-func
-      result = await new Function(`return (async () => (${args.script}))()`)()
-    } catch {
-      // 表达式求值也失败（如含 await/let/const 等语句），保持 undefined
-    }
-  }
-  await ctx.pageController.hideMask()
-  return {
-    content: [{ type: 'text' as const, text: `脚本执行结果: ${JSON.stringify(result)}` }]
-  }
-}

package/page-tools/handlers/fill.ts

@@ -1,60 +0,0 @@
-import { inputTextElement } from '@page-agent/page-controller'
-import { dispatchComposedEvents, isInShadowDom, waitForDomSettled } from '../utils/dom'
-import type { ActionContext } from '../context'
-
-export async function handleFill(args: any, ctx: ActionContext) {
-  const mode = args.responseMode ?? 'diff'
-  if (args.index === undefined || typeof args.text !== 'string') return ctx.errContent('填写结果: 缺少元素索引或文本内容')
-  const el = ctx.getRefMap().get(args.index)
-  if (!el) return ctx.refreshOnStaleRef('填写', args.index)
-
-  let targetEl = el
-  if (!(targetEl instanceof HTMLInputElement) && !(targetEl instanceof HTMLTextAreaElement)) {
-    // querySelector 不穿透 shadow boundary，对 shadow host 补查其 shadowRoot
-    const innerInput = el.querySelector('input, textarea')
-      ?? (el.shadowRoot?.querySelector('input, textarea') as HTMLElement | null)
-    if (innerInput) {
-      targetEl = innerInput as HTMLElement
-    }
-  }
-
-  if (targetEl instanceof HTMLInputElement && targetEl.readOnly) {
-    targetEl.value = args.text
-    // composed:true 确保事件穿透 shadow boundary，事件委托框架可捕获
-    dispatchComposedEvents(targetEl, 'input', 'change', 'blur')
-  } else {
-    // 优先尝试标准方式（支持 contenteditable、普通 input/textarea）
-    let fillSuccess = false
-    try {
-      await inputTextElement(targetEl, args.text)
-      fillSuccess = true
-    } catch (fillErr) {
-      // inputTextElement 失败时（如 Angular/React 组件包装的密码框），
-      // 降级使用原生 input value 描述符触发框架变更检测
-      const nativeInputValueSetter = Object.getOwnPropertyDescriptor(
-        (targetEl instanceof HTMLTextAreaElement ? HTMLTextAreaElement : HTMLInputElement).prototype,
-        'value'
-      )?.set
-      if (nativeInputValueSetter && (targetEl instanceof HTMLInputElement || targetEl instanceof HTMLTextAreaElement)) {
-        nativeInputValueSetter.call(targetEl, args.text)
-        // 发送完整事件序列，触发 Angular ngModel / React 合成事件的变更检测
-        targetEl.dispatchEvent(new Event('focus', { bubbles: true, composed: true }))
-        targetEl.dispatchEvent(new Event('input', { bubbles: true, composed: true }))
-        targetEl.dispatchEvent(new Event('change', { bubbles: true, composed: true }))
-        targetEl.dispatchEvent(new Event('blur', { bubbles: true, composed: true }))
-        fillSuccess = true
-      }
-    }
-    if (!fillSuccess) {
-      return ctx.errContent(`填写结果: 无法填写元素 ${args.index}，元素不是 input、textarea 或 contenteditable`)
-    }
-    // shadow DOM 内元素：inputTextElement 派发的合成事件 composed:false，
-    // 补发 composed:true 事件确保事件委托框架（如 React）能收到
-    if (isInShadowDom(targetEl)) {
-      dispatchComposedEvents(targetEl, 'input', 'change')
-    }
-  }
-  // 等待框架异步插入的校验错误/条件渲染内容稳定后再采集状态
-  await waitForDomSettled()
-  return ctx.buildBrowserStateResponse(mode)
-}

package/page-tools/handlers/scroll.ts

@@ -1,66 +0,0 @@
-import { getScrollInfo, waitForScrollEnd } from '../utils/scroll'
-import type { ActionContext } from '../context'
-
-export async function handleScroll(args: any, ctx: ActionContext) {
-  const mode = args.responseMode ?? 'diff'
-  if (args.down === undefined && args.right === undefined) return ctx.errContent('滚动结果: 缺少滚动方向参数')
-
-  // 确定滚动目标（有 index 时滚动该元素容器，否则滚动整个文档）
-  let scrollTarget: Element | Window = window
-  if (args.index !== undefined) {
-    const el = ctx.getRefMap().get(args.index)
-    if (!el) return ctx.refreshOnStaleRef('滚动', args.index)
-    scrollTarget = el
-  }
-
-  // 滚动前快照
-  const before = getScrollInfo(scrollTarget)
-
-  if (args.right !== undefined) {
-    const pixels = args.pixels ?? 300
-    scrollTarget.scrollBy({ left: args.right ? pixels : -pixels, behavior: 'smooth' })
-  } else {
-    const pixels = args.pixels ?? Math.round((args.numPages ?? 1) * window.innerHeight)
-    scrollTarget.scrollBy({ top: args.down ? pixels : -pixels, behavior: 'smooth' })
-  }
-
-  // 等待滚动动画完成后再采集状态（scrollend + 超时兜底）
-  await waitForScrollEnd(scrollTarget)
-
-  // 滚动后快照，计算实际位移
-  const after = getScrollInfo(scrollTarget)
-  const deltaY = Math.round(after.scrollY - before.scrollY)
-  const deltaX = Math.round(after.scrollX - before.scrollX)
-  const isHorizontal = args.right !== undefined
-
-  let scrollMsg: string
-  if (Math.abs(deltaY) < 1 && Math.abs(deltaX) < 1) {
-    // 实际未发生位移，说明已到达边界
-    if (isHorizontal) {
-      scrollMsg = args.right ? '⚠️ 已到达右边界，无法继续向右滚动' : '⚠️ 已到达左边界，无法继续向左滚动'
-    } else {
-      scrollMsg = args.down ? '⚠️ 已到达底部，无法继续向下滚动' : '⚠️ 已到达顶部，无法继续向上滚动'
-    }
-  } else {
-    const axis = isHorizontal ? `水平滚动 ${deltaX}px` : `垂直滚动 ${deltaY}px`
-    let boundary = ''
-    if (isHorizontal) {
-      if (args.right && after.atRight) boundary = '，已到达右边界'
-      else if (!args.right && after.atLeft) boundary = '，已到达左边界'
-    } else {
-      if (args.down && after.atBottom) boundary = '，已到达底部'
-      else if (!args.down && after.atTop) boundary = '，已到达顶部'
-    }
-    scrollMsg = `✅ ${axis}${boundary}`
-  }
-
-  // 附加位置信息（参考 page-agent getPageInfo 格式）
-  const posInfo = args.right !== undefined
-    ? `当前水平滚动位置: scrollX=${Math.round(after.scrollX)}px，左侧 ${after.pagesAbove.toFixed(1)} 屏，右侧 ${after.pagesBelow.toFixed(1)} 屏`
-    : `当前滚动位置: scrollY=${Math.round(after.scrollY)}px，上方 ${after.pagesAbove.toFixed(1)} 屏，下方 ${after.pagesBelow.toFixed(1)} 屏`
-  const scrollResult = `[滚动结果] ${scrollMsg}\n${posInfo}`
-
-  const stateResult = await ctx.buildBrowserStateResponse(mode)
-  stateResult.content[0].text = `${scrollResult}\n\n${stateResult.content[0].text}`
-  return stateResult
-}

package/page-tools/handlers/searchTree.ts

@@ -1,30 +0,0 @@
-import { searchA11yTree } from '../a11y-tree'
-import { detectPageDialog, detectValidationErrors } from '../utils/dom'
-import { DEFAULT_ERROR_SELECTORS } from '../constants'
-import type { ActionContext } from '../context'
-
-export async function handleSearchTree(args: any, ctx: ActionContext) {
-  if (!args.query) return ctx.errContent('搜索失败: 缺少 query 参数')
-  const blacklist = (window.__webmcpcli_interactiveBlacklist ?? []) as Element[]
-  const whitelist = (window.__webmcpcli_interactiveWhitelist ?? []) as Element[]
-  const exposedAttributes = (window.__webmcpcli_exposedAttributes ?? []) as string[]
-  const result = searchA11yTree(args.query, document.body, blacklist, whitelist, {
-    contextLines: args.contextLines,
-    maxMatches: args.maxMatches,
-    exposedAttributes,
-    errorSelectors: (window.__webmcpcli_errorSelectors ?? DEFAULT_ERROR_SELECTORS).join(', '),
-  })
-  
-  ctx.setRefMap(result.refMap)
-  ctx.stateCache.update(window.location.href, result.yaml)
-  
-  await ctx.pageController.hideMask()
-  // 检测页面弹窗/遮罩层，帮助 AI 发现可能遮挡目标的确认弹窗
-  const dialogAlert = detectPageDialog()
-  // 检测表单校验错误，提醒 AI 优先修复
-  const validationErrors = detectValidationErrors()
-  const alerts = `${dialogAlert}${validationErrors}`
-  return {
-    content: [{ type: 'text' as const, text: alerts ? `${alerts}\n${result.text}` : result.text }]
-  }
-}

package/page-tools/handlers/select.ts

@@ -1,34 +0,0 @@
-import { selectOptionElement } from '@page-agent/page-controller'
-import { dispatchComposedEvents, isInShadowDom, waitForDomSettled } from '../utils/dom'
-import type { ActionContext } from '../context'
-
-export async function handleSelect(args: any, ctx: ActionContext) {
-  const mode = args.responseMode ?? 'diff'
-  if (args.index === undefined || typeof args.text !== 'string') return ctx.errContent('选择结果: 缺少元素索引或文本内容')
-  let el = ctx.getRefMap().get(args.index) as HTMLSelectElement | HTMLElement | undefined
-  if (!el) return ctx.refreshOnStaleRef('选择', args.index)
-  // 若 ref 指向 shadow host，解析其内部真正的 <select>（与 fill 一致）
-  let targetSelect: HTMLSelectElement | null = null
-  if (el instanceof HTMLSelectElement) {
-    targetSelect = el
-  } else {
-    const innerSelect = el.querySelector('select')
-      ?? (el.shadowRoot?.querySelector('select') as HTMLSelectElement | null)
-    if (innerSelect) {
-      targetSelect = innerSelect
-    }
-  }
-
-  if (!targetSelect) {
-    return ctx.errContent(`选择结果: 无法选择元素 ${args.index}，未找到对应的 <select> 元素`)
-  }
-
-  await selectOptionElement(targetSelect, args.text)
-  // shadow DOM 内元素：补发 composed:true 的 change 事件
-  if (isInShadowDom(targetSelect)) {
-    dispatchComposedEvents(targetSelect, 'change')
-  }
-  // 等待框架异步插入的校验错误/条件渲染内容稳定后再采集状态
-  await waitForDomSettled()
-  return ctx.buildBrowserStateResponse(mode)
-}