@opentiny/next-sdk 0.4.2 → 0.4.3

package/test/page-tools/page-agent-tool-dispatch.test.ts

@@ -1,208 +0,0 @@
-import { describe, it, expect, beforeAll, beforeEach, afterAll, vi } from 'vitest'
-
-/**
- * 保障 page-agent-tool 的 switch(action) 不会 fall-through：
- * 每个 action 只能调用对应 handler 一次，且不得落入后续分支 / default。
- */
-
-const { handlerMocks } = vi.hoisted(() => {
-  const marker = (name: string) => ({
-    content: [{ type: 'text' as const, text: `ok:${name}` }],
-  })
-  return {
-    handlerMocks: {
-      handleBrowserState: vi.fn(async () => marker('browserState')),
-      handleClick: vi.fn(async () => marker('click')),
-      handleFill: vi.fn(async () => marker('fill')),
-      handleSelect: vi.fn(async () => marker('select')),
-      handleScroll: vi.fn(async () => marker('scroll')),
-      handleExecuteJavascript: vi.fn(async () => marker('executeJavascript')),
-      handleSearchTree: vi.fn(async () => marker('searchTree')),
-    },
-  }
-})
-
-vi.mock('../../page-tools/page-agent-mask/SimulatorMask', () => ({
-  SimulatorMask: class SimulatorMask {
-    show() {}
-    hide() {}
-    dispose() {}
-    borderElement() {}
-    removeBorderElement() {}
-  },
-}))
-
-vi.mock('@page-agent/page-controller', () => ({
-  PageController: class PageController {
-    mask = {
-      borderElement() {},
-      removeBorderElement() {},
-    }
-    maskReady = Promise.resolve()
-    async showMask() {}
-    async hideMask() {}
-  },
-}))
-
-vi.mock('../../page-tools/handlers/browserState', () => ({
-  handleBrowserState: handlerMocks.handleBrowserState,
-}))
-vi.mock('../../page-tools/handlers/click', () => ({
-  handleClick: handlerMocks.handleClick,
-}))
-vi.mock('../../page-tools/handlers/fill', () => ({
-  handleFill: handlerMocks.handleFill,
-}))
-vi.mock('../../page-tools/handlers/select', () => ({
-  handleSelect: handlerMocks.handleSelect,
-}))
-vi.mock('../../page-tools/handlers/scroll', () => ({
-  handleScroll: handlerMocks.handleScroll,
-}))
-vi.mock('../../page-tools/handlers/executeJavascript', () => ({
-  handleExecuteJavascript: handlerMocks.handleExecuteJavascript,
-}))
-vi.mock('../../page-tools/handlers/searchTree', () => ({
-  handleSearchTree: handlerMocks.handleSearchTree,
-}))
-
-import { registerPageAgentTool } from '../../page-tools/page-agent-tool'
-import type { PageAgentToolInput } from '../../page-tools/schema'
-
-interface ToolTextContent {
-  type: string
-  text: string
-}
-
-interface ToolExecuteResult {
-  content: ToolTextContent[]
-}
-
-type PageAgentExecute = (args: PageAgentToolInput) => Promise<ToolExecuteResult>
-
-interface RegisterablePageAgentTool {
-  name?: string
-  execute?: PageAgentExecute
-}
-
-interface ModelContextWithRegisterTool {
-  registerTool: (
-    tool: RegisterablePageAgentTool,
-    options?: unknown
-  ) => unknown
-}
-
-interface DocumentWithModelContext {
-  modelContext?: ModelContextWithRegisterTool
-}
-
-const ACTIONS = [
-  'browserState',
-  'click',
-  'fill',
-  'select',
-  'scroll',
-  'executeJavascript',
-  'searchTree',
-] as const
-
-type ActionName = (typeof ACTIONS)[number]
-
-const handlerByAction: Record<ActionName, keyof typeof handlerMocks> = {
-  browserState: 'handleBrowserState',
-  click: 'handleClick',
-  fill: 'handleFill',
-  select: 'handleSelect',
-  scroll: 'handleScroll',
-  executeJavascript: 'handleExecuteJavascript',
-  searchTree: 'handleSearchTree',
-}
-
-function resetWindowGlobals() {
-  delete window.__webmcpcli_toolConfig
-  delete window.__webmcpcli_beforeGetBrowserState
-}
-
-function captureExecute(): PageAgentExecute {
-  const mcp = (document as DocumentWithModelContext).modelContext
-  if (!mcp?.registerTool) {
-    throw new Error('document.modelContext.registerTool unavailable')
-  }
-
-  let execute: PageAgentExecute | null = null
-  const original = mcp.registerTool.bind(mcp)
-  mcp.registerTool = (tool: RegisterablePageAgentTool, options?: unknown) => {
-    if (tool?.name === 'page-agent-tool' && typeof tool.execute === 'function') {
-      execute = tool.execute.bind(tool)
-    }
-    return original(tool, options)
-  }
-
-  try {
-    registerPageAgentTool()
-  } finally {
-    mcp.registerTool = original
-  }
-
-  if (!execute) {
-    throw new Error('failed to capture page-agent-tool execute')
-  }
-  return execute
-}
-
-function argsFor(action: ActionName): PageAgentToolInput {
-  switch (action) {
-    case 'browserState':
-      return { action, responseMode: 'full', contextLines: 2, maxMatches: 20 }
-    case 'click':
-      return { action, index: 0, contextLines: 2, maxMatches: 20 }
-    case 'fill':
-      return { action, index: 0, text: 'hello', contextLines: 2, maxMatches: 20 }
-    case 'select':
-      return { action, index: 0, text: 'opt', contextLines: 2, maxMatches: 20 }
-    case 'scroll':
-      return { action, down: true, numPages: 1, contextLines: 2, maxMatches: 20 }
-    case 'executeJavascript':
-      return { action, script: '1+1', contextLines: 2, maxMatches: 20 }
-    case 'searchTree':
-      return { action, query: 'button', contextLines: 2, maxMatches: 20 }
-  }
-}
-
-describe('page-agent-tool action dispatch（防 switch fall-through）', () => {
-  let execute: PageAgentExecute
-
-  beforeAll(async () => {
-    resetWindowGlobals()
-    execute = captureExecute()
-    // 等待 pageController.maskReady 把 SimulatorMask 挂上
-    await Promise.resolve()
-    await Promise.resolve()
-  })
-
-  beforeEach(() => {
-    for (const mock of Object.values(handlerMocks)) {
-      mock.mockClear()
-    }
-  })
-
-  afterAll(() => {
-    resetWindowGlobals()
-  })
-
-  it.each(ACTIONS)('action=%s 只调用对应 handler，且不落入 default', async (action) => {
-    const result = await execute(argsFor(action))
-
-    expect(result.content[0]?.text).toBe(`ok:${action}`)
-    expect(result.content[0]?.text).not.toMatch(/^未知操作:/)
-
-    const expectedKey = handlerByAction[action]
-    for (const [key, mock] of Object.entries(handlerMocks)) {
-      if (key === expectedKey) {
-        expect(mock, `${key} should be called once`).toHaveBeenCalledTimes(1)
-      } else {
-        expect(mock, `${key} must not be called for action=${action}`).not.toHaveBeenCalled()
-      }
-    }
-  })
-})

package/test/page-tools/page-agent-tool.test.ts

@@ -1,102 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest'
-
-// jsdom 无 WebGL2，避免 SimulatorMask → ai-motion 初始化刷 stderr
-vi.mock('../../page-tools/page-agent-mask/SimulatorMask', () => ({
-  SimulatorMask: class SimulatorMask {
-    show() {}
-    hide() {}
-    dispose() {}
-  },
-}))
-
-import { registerPageAgentTool } from '../../page-tools/page-agent-tool'
-import { getPageAgentToolConfig, setPageAgentToolConfig } from '../../page-tools/tool-config'
-
-function resetWindowGlobals() {
-  delete window.__webmcpcli_toolConfig
-  delete window.__webmcpcli_beforeGetBrowserState
-  // 注意：initializeBuiltinWebMCP() 内部用模块级单例 flag 控制只初始化一次 document.modelContext，
-  // 且没有对外暴露重置能力，因此这里不删除 document.modelContext，避免二次调用时因单例 flag
-  // 仍为 true 而不会重新创建 modelContext，导致 registerTool 拿到 undefined
-}
-
-beforeEach(() => {
-  resetWindowGlobals()
-})
-
-afterEach(() => {
-  resetWindowGlobals()
-})
-
-describe('registerPageAgentTool - 统一无障碍配置接入', () => {
-  it('仅传 options.a11yConfig 时，与默认配置合并生效', () => {
-    registerPageAgentTool({
-      a11yConfig: { roles: [{ role: 'tab', selector: '.tab-item' }] },
-    })
-    const config = getPageAgentToolConfig().a11yConfig
-    expect(config.roles).toEqual([{ role: 'tab', selector: '.tab-item' }])
-    // 默认内置规则仍然存在（不会被覆盖丢失）
-    expect(config.states.error?.length).toBeGreaterThan(0)
-    expect(window.__webmcpcli_toolConfig?.a11yConfig).toBe(config)
-  })
-
-  it('不传 a11yConfig 时，使用默认配置初始化', () => {
-    registerPageAgentTool()
-    const config = getPageAgentToolConfig().a11yConfig
-    expect(config.roles).toEqual([])
-    expect(config.states.error?.length).toBeGreaterThan(0)
-  })
-
-  it('a11yConfig 中的 whitelist/exposedAttributes 与默认配置合并，互不覆盖', () => {
-    registerPageAgentTool({
-      a11yConfig: {
-        whitelist: ['.new-whitelist'],
-        exposedAttributes: ['data-config-attr'],
-      },
-    })
-    const config = getPageAgentToolConfig().a11yConfig
-    expect(config.whitelist).toContain('.new-whitelist')
-    expect(config.exposedAttributes).toContain('data-config-attr')
-  })
-
-  it('重复调用 registerPageAgentTool 以 replace 模式重新初始化，不会无限累加旧配置', () => {
-    registerPageAgentTool({ a11yConfig: { roles: [{ role: 'tab', selector: '.v1' }] } })
-    registerPageAgentTool({ a11yConfig: { roles: [{ role: 'tab', selector: '.v2' }] } })
-    const config = getPageAgentToolConfig().a11yConfig
-    expect(config.roles).toEqual([{ role: 'tab', selector: '.v2' }])
-  })
-})
-
-describe('registerPageAgentTool - 顶层工具配置（PageAgentToolConfig）接入', () => {
-  it('不传 enableHighlight 时默认关闭元素高亮', () => {
-    registerPageAgentTool()
-    expect(getPageAgentToolConfig().enableHighlight).toBe(false)
-  })
-
-  it('options.enableHighlight = true 时运行期配置同步生效', () => {
-    registerPageAgentTool({ enableHighlight: true })
-    expect(getPageAgentToolConfig().enableHighlight).toBe(true)
-    expect(window.__webmcpcli_toolConfig?.enableHighlight).toBe(true)
-  })
-
-  it('注册后可通过 setPageAgentToolConfig 在运行期动态修改，无需重新 registerPageAgentTool', () => {
-    registerPageAgentTool({ enableHighlight: true })
-    setPageAgentToolConfig({ enableHighlight: false })
-    expect(getPageAgentToolConfig().enableHighlight).toBe(false)
-  })
-
-  it('重复调用 registerPageAgentTool 以 replace 模式重新初始化顶层配置', () => {
-    registerPageAgentTool({ enableHighlight: false })
-    registerPageAgentTool({ enableHighlight: true })
-    expect(getPageAgentToolConfig().enableHighlight).toBe(true)
-  })
-
-  it('a11yConfig 与顶层配置项互不影响，分别合并生效', () => {
-    registerPageAgentTool({
-      enableHighlight: false,
-      a11yConfig: { roles: [{ role: 'tab', selector: '.tab-item' }] },
-    })
-    expect(getPageAgentToolConfig().enableHighlight).toBe(false)
-    expect(getPageAgentToolConfig().a11yConfig.roles).toEqual([{ role: 'tab', selector: '.tab-item' }])
-  })
-})

package/test/page-tools/tool-config.test.ts

@@ -1,112 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from 'vitest'
-import {
-  getPageAgentToolConfig,
-  setPageAgentToolConfig,
-  DEFAULT_PAGE_AGENT_TOOL_CONFIG
-} from '../../page-tools/tool-config'
-
-function resetWindowGlobals() {
-  delete window.__webmcpcli_toolConfig
-}
-
-beforeEach(() => {
-  resetWindowGlobals()
-})
-
-afterEach(() => {
-  resetWindowGlobals()
-})
-
-describe('getPageAgentToolConfig / setPageAgentToolConfig', () => {
-  it('未初始化时返回默认配置', () => {
-    expect(getPageAgentToolConfig()).toEqual(DEFAULT_PAGE_AGENT_TOOL_CONFIG)
-  })
-
-  it('merge 模式下只覆盖传入的字段，未传入字段保持原值', () => {
-    setPageAgentToolConfig({ enableHighlight: false })
-    const current = getPageAgentToolConfig()
-    expect(current.enableHighlight).toBe(false)
-  })
-
-  it('merge 模式下只覆盖传入的字段，removeMaskAfterToolCall字段保持原值', () => {
-    setPageAgentToolConfig({ removeMaskAfterToolCall: false })
-    const current = getPageAgentToolConfig()
-    expect(current.removeMaskAfterToolCall).toBe(false)
-  })
-
-  it('merge 模式下只覆盖传入的字段，removeMaskAfterToolCall字段保持原值', () => {
-    setPageAgentToolConfig({ removeMaskAfterToolCall: true })
-    const current = getPageAgentToolConfig()
-    expect(current.removeMaskAfterToolCall).toBe(true)
-  })
-
-  it('函数式 patch：入参为当前生效配置，返回值与默认配置合并', () => {
-    setPageAgentToolConfig({ enableHighlight: false })
-    const next = setPageAgentToolConfig((current) => ({ enableHighlight: !current.enableHighlight }))
-    expect(next.enableHighlight).toBe(true)
-    expect(getPageAgentToolConfig().enableHighlight).toBe(true)
-  })
-
-  it('replace 模式丢弃之前的运行期状态，只与默认值重新合并', () => {
-    setPageAgentToolConfig({ enableHighlight: true })
-    setPageAgentToolConfig({}, { mode: 'replace' })
-    expect(getPageAgentToolConfig().enableHighlight).toBe(false)
-  })
-
-  it('setPageAgentToolConfig 后 getPageAgentToolConfig 读到最新值', () => {
-    const next = setPageAgentToolConfig({ enableHighlight: false })
-    expect(getPageAgentToolConfig()).toEqual(next)
-  })
-})
-
-describe('setPageAgentToolConfig - a11yConfig 子字段', () => {
-  it('未初始化时 a11yConfig 与默认无障碍配置等价', () => {
-    const config = getPageAgentToolConfig().a11yConfig
-    expect(config.roles).toEqual([])
-    expect(config.whitelist).toEqual([])
-    expect(config.blacklist).toEqual([])
-    expect(config.exposedAttributes).toEqual([])
-    expect(config.dialogSelectors).toEqual(DEFAULT_PAGE_AGENT_TOOL_CONFIG.a11yConfig.dialogSelectors)
-  })
-
-  it('merge 模式下多次调用累加合并（拼接而非覆盖）', () => {
-    setPageAgentToolConfig({ a11yConfig: { roles: [{ role: 'tab', selector: '.tab-1' }] } })
-    setPageAgentToolConfig({ a11yConfig: { roles: [{ role: 'tabpanel', selector: '.panel-1' }] } })
-    const current = getPageAgentToolConfig().a11yConfig
-    expect(current.roles).toEqual([
-      { role: 'tab', selector: '.tab-1' },
-      { role: 'tabpanel', selector: '.panel-1' }
-    ])
-  })
-
-  it('函数式 patch 可用于过滤/移除旧规则（真正移除，不会因再次合并而复活）', () => {
-    setPageAgentToolConfig({
-      a11yConfig: {
-        roles: [
-          { role: 'tab', selector: '.tab-1' },
-          { role: 'keep-me', selector: '.k' }
-        ]
-      }
-    })
-    setPageAgentToolConfig((current) => ({
-      a11yConfig: { roles: current.a11yConfig.roles.filter((r) => r.role !== 'tab') }
-    }))
-    const result = getPageAgentToolConfig().a11yConfig
-    expect(result.roles.some((r) => r.role === 'tab')).toBe(false)
-    expect(result.roles.some((r) => r.role === 'keep-me')).toBe(true)
-  })
-
-  it('replace 模式丢弃之前的运行期状态，只与默认值重新合并', () => {
-    setPageAgentToolConfig({ a11yConfig: { roles: [{ role: 'tab', selector: '.old' }] } })
-    setPageAgentToolConfig({ a11yConfig: { roles: [{ role: 'v2', selector: '.new' }] } }, { mode: 'replace' })
-    const result = getPageAgentToolConfig().a11yConfig
-    expect(result.roles).toEqual([{ role: 'v2', selector: '.new' }])
-  })
-
-  it('a11yConfig 与 enableHighlight 可在同一次 patch 中一起设置，互不影响', () => {
-    setPageAgentToolConfig({ enableHighlight: false, a11yConfig: { dialogSelectors: ['.my-modal'] } })
-    const current = getPageAgentToolConfig()
-    expect(current.enableHighlight).toBe(false)
-    expect(current.a11yConfig.dialogSelectors).toContain('.my-modal')
-  })
-})

package/test/page-tools/utils/dom.test.ts

@@ -1,122 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from 'vitest'
-import { detectPageDialog, detectValidationErrors, deepQuerySelectorAll } from '../../../page-tools/utils/dom'
-import { setPageAgentToolConfig } from '../../../page-tools/tool-config'
-
-function mockRect(el: Element, rect: Partial<DOMRect>) {
-  const full: DOMRect = {
-    x: 0,
-    y: 0,
-    width: 0,
-    height: 0,
-    top: 0,
-    left: 0,
-    right: 0,
-    bottom: 0,
-    toJSON: () => ({}),
-    ...rect,
-  }
-  Object.defineProperty(el, 'getBoundingClientRect', {
-    configurable: true,
-    value: () => full,
-  })
-}
-
-function resetWindowGlobals() {
-  delete window.__webmcpcli_toolConfig
-}
-
-beforeEach(() => {
-  resetWindowGlobals()
-  document.body.innerHTML = ''
-})
-
-afterEach(() => {
-  resetWindowGlobals()
-  document.body.innerHTML = ''
-})
-
-describe('detectValidationErrors', () => {
-  it('通过默认 states.error 选择器（ARIA 标准 + 主流框架）检出校验错误', () => {
-    const err = document.createElement('div')
-    err.className = 'el-form-item__error'
-    err.textContent = '用户名不能为空'
-    document.body.appendChild(err)
-    mockRect(err, { width: 100, height: 20 })
-
-    const result = detectValidationErrors()
-    expect(result).toContain('用户名不能为空')
-    expect(result).toContain('[校验提示]')
-  })
-
-  it('通过 setPageAgentToolConfig 追加的自定义 states.error 选择器检出', () => {
-    setPageAgentToolConfig({ a11yConfig: { states: { error: { selector: '.my-custom-error' } } } })
-    const err = document.createElement('div')
-    err.className = 'my-custom-error'
-    err.textContent = '自定义错误文案'
-    document.body.appendChild(err)
-    mockRect(err, { width: 100, height: 20 })
-
-    expect(detectValidationErrors()).toContain('自定义错误文案')
-  })
-
-  it('无校验错误时返回空字符串', () => {
-    expect(detectValidationErrors()).toBe('')
-  })
-})
-
-describe('detectPageDialog', () => {
-  it('通过默认 dialogSelectors（role=dialog）检出真正阻塞交互的模态弹窗', () => {
-    const dialog = document.createElement('div')
-    dialog.setAttribute('role', 'dialog')
-    dialog.textContent = '确认删除该记录吗？此操作不可撤销。'
-    dialog.style.position = 'fixed'
-    dialog.style.zIndex = '1000'
-    document.body.appendChild(dialog)
-    mockRect(dialog, { width: 400, height: 200, left: 300, right: 700, top: 250, bottom: 450 })
-
-    const result = detectPageDialog()
-    expect(result).toContain('[页面弹窗检测]')
-    expect(result).toContain('确认删除该记录吗')
-  })
-
-  it('通过 setPageAgentToolConfig 追加的自定义 dialogSelectors 检出', () => {
-    setPageAgentToolConfig({ a11yConfig: { dialogSelectors: ['.my-modal'] } })
-    const dialog = document.createElement('div')
-    dialog.className = 'my-modal'
-    dialog.textContent = '自定义配置检测到的模态弹窗内容'
-    dialog.style.position = 'fixed'
-    dialog.style.zIndex = '1000'
-    document.body.appendChild(dialog)
-    mockRect(dialog, { width: 400, height: 200, left: 300, right: 700, top: 250, bottom: 450 })
-
-    expect(detectPageDialog()).toContain('自定义配置检测到的模态弹窗内容')
-  })
-
-  it('非模态（非 fixed/absolute 或 z-index 过低）的弹窗不会被误报', () => {
-    const notModal = document.createElement('div')
-    notModal.setAttribute('role', 'dialog')
-    notModal.textContent = '这是一个静态定位的普通提示框内容'
-    document.body.appendChild(notModal)
-    mockRect(notModal, { width: 400, height: 200, left: 300, right: 700, top: 250, bottom: 450 })
-
-    expect(detectPageDialog()).toBe('')
-  })
-
-  it('无弹窗时返回空字符串', () => {
-    expect(detectPageDialog()).toBe('')
-  })
-})
-
-describe('deepQuerySelectorAll', () => {
-  it('可以穿透 Shadow DOM 查询元素', () => {
-    const host = document.createElement('div')
-    document.body.appendChild(host)
-    const shadow = host.attachShadow({ mode: 'open' })
-    const btn = document.createElement('button')
-    btn.textContent = 'Shadow 内部按钮'
-    shadow.appendChild(btn)
-
-    const found = deepQuerySelectorAll('button', document.body)
-    expect(found).toContain(btn)
-  })
-})

package/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "declaration": true,
-    "outDir": "dist",
-    "target": "ES2015",
-    "lib": ["ES2015", "DOM"],
-    "moduleResolution": "node",
-    "module": "esnext",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "types": ["vite/client"]
-  },
-  "include": ["**/*.ts"],
-  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
-}