@opentiny/next-sdk 0.4.0 → 0.4.2

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

@@ -0,0 +1,208 @@
+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

@@ -0,0 +1,102 @@
+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

@@ -0,0 +1,112 @@
+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

@@ -0,0 +1,122 @@
+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/utils/builtinProxy.ts

@@ -1,17 +1,45 @@
 import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js'
 
+/** 浏览器内置 WebMCP 原生上下文接口 */
+interface NativeModelContext {
+  getTools(): Promise<NativeTool[]> | NativeTool[]
+  executeTool(tool: NativeTool, argsStr: string): Promise<unknown>
+}
+
+/** 原生工具描述 */
+interface NativeTool {
+  name: string
+  description?: string
+  title?: string
+  inputSchema?: unknown
+}
+
+/** JSON-RPC 消息基础结构 */
+interface JsonRpcMessage {
+  jsonrpc: string
+  id?: string | number
+  method?: string
+  params?: {
+    name?: string
+    arguments?: Record<string, unknown>
+    [key: string]: unknown
+  }
+}
+
 /**
  * 建立原生的 JSON-RPC 拦截层：
- * 将发向 remote 的 MCP 请求拦截，代理给所在浏览器的 navigator.modelContextTesting 上执行。
+ * 将发向 remote 的 MCP 请求拦截，代理给所在浏览器的 document.modelContext 上执行。
  */
 export const setupBuiltinProxy = (transport: Transport) => {
-  const getNativeCtx = () => {
-    if (typeof navigator === 'undefined') return null
-    const nav = navigator as any
-    return nav.modelContextTesting || null
+  const getNativeCtx = (): NativeModelContext | null => {
+    let ctx: NativeModelContext | null = null
+    if (typeof document !== 'undefined') ctx = ctx || ((document as unknown as Record<string, unknown>).modelContext as NativeModelContext | null)
+    if (typeof navigator !== 'undefined') ctx = ctx || ((navigator as unknown as Record<string, unknown>).modelContext as NativeModelContext | null)
+    ctx = ctx || ((globalThis as unknown as Record<string, unknown>).modelContext as NativeModelContext | null)
+    return ctx || null
   }
 
-  transport.onmessage = async (message: any) => {
+  transport.onmessage = async (message: JsonRpcMessage) => {
     if (!message || typeof message !== 'object') return
     const id = message.id
     const method = message.method
@@ -36,8 +64,8 @@ export const setupBuiltinProxy = (transport: Transport) => {
         await transport.send({ jsonrpc: '2.0', id, result: {} })
       } else if (method === 'tools/list') {
         const nativeCtx = getNativeCtx()
-        if (nativeCtx && nativeCtx.listTools) {
-          const rawTools = await nativeCtx.listTools()
+        if (nativeCtx && nativeCtx.getTools) {
+          const rawTools = await nativeCtx.getTools()
           const tools = rawTools.map((t: any) => {
             let schemaObj: any = {}
             if (typeof t.inputSchema === 'string') {
@@ -67,19 +95,22 @@ export const setupBuiltinProxy = (transport: Transport) => {
         const nativeCtx = getNativeCtx()
         if (nativeCtx && nativeCtx.executeTool) {
           if (!message.params || typeof message.params !== 'object' || !message.params.name) {
-            const error: any = new Error('Invalid params: "name" is required and params must be an object')
+            const error: Error & { code?: number } = new Error('Invalid params: "name" is required and params must be an object')
             error.code = -32602 // Invalid params
             throw error
           }
           const { name, arguments: args } = message.params
-          const result = await nativeCtx.executeTool(name, JSON.stringify(args || {}))
+          const tools = await (nativeCtx.getTools ? nativeCtx.getTools() : [])
+          const toolObj = tools.find((t: any) => t.name === name)
+          if (!toolObj) throw new Error(`Tool ${name} not found`)
+          const result = await nativeCtx.executeTool(toolObj, JSON.stringify(args || {}))
           const finalResult =
             result && typeof result === 'object' && 'content' in result
               ? result
               : { content: [{ type: 'text', text: typeof result === 'string' ? result : JSON.stringify(result) }] }
           await transport.send({ jsonrpc: '2.0', id, result: finalResult })
         } else {
-          const error: any = new Error('executeTool not implemented in Browser built-in WebMCP')
+          const error: Error & { code?: number } = new Error('executeTool not implemented in Browser built-in WebMCP')
           error.code = -32601 // Method not found
           throw error
         }
@@ -99,12 +130,13 @@ export const setupBuiltinProxy = (transport: Transport) => {
           error: { code: -32601, message: `Method not found: ${method}` }
         })
       }
-    } catch (err: any) {
+    } catch (err: unknown) {
       if (id !== undefined) {
+        const errObj = err as { code?: number; message?: string }
         await transport.send({
           jsonrpc: '2.0',
           id,
-          error: { code: err.code || -32000, message: err.message || String(err) }
+          error: { code: errObj.code || -32000, message: errObj.message || String(err) }
         })
       }
     }

package/vite.config.runtime.ts

@@ -0,0 +1,22 @@
+import { defineConfig } from 'vite'
+
+export default defineConfig(() => {
+  return {
+    define: {
+      'process.env.NODE_ENV': JSON.stringify('production')
+    },
+    build: {
+      emptyOutDir: false,
+      lib: {
+        entry: 'runtime.ts',
+        name: 'WebMCPSDK',
+        formats: ['iife'] as any,
+        fileName: () => 'runtime.js'
+      },
+      rollupOptions: {
+        // 全量打包第三方依赖，便于浏览器中直接注入或运行
+        external: []
+      }
+    }
+  }
+})