@opentiny/next-sdk 0.4.1 → 0.4.3

package/agent/type.ts

@@ -1,91 +0,0 @@
-import type { ProviderV2 } from '@ai-sdk/provider'
-import type { MCPClientConfig } from '@ai-sdk/mcp'
-
-// 从 MCPClientConfig 中提取 transport 类型
-export type MCPTransport = MCPClientConfig['transport']
-
-/**
- * 浏览器内置 WebMCP 测试 API 接口 (如 document.modelContext)
- */
-export interface BuiltinMcpClient {
-  listTools?: () => Promise<any[]>
-  getTools?: () => Promise<any[]>
-  executeTool: (tool: any, input: string) => Promise<any>
-  registerTool?: (config: { name: string; execute: (input: any) => Promise<any> | any; [key: string]: any }) => void
-  unregisterTool?: (name: string) => void
-}
-
-type ProviderFactory = 'openai' | 'deepseek' | ((options: any) => ProviderV2)
-
-type LlmFactoryConfig = {
-  /** API密钥 */
-  apiKey: string
-  /** API基础URL */
-  baseURL: string
-  /** 内置或自定义 Provider 工厂函数 */
-  providerType: ProviderFactory
-  /** 互斥：当使用 providerType 分支时不允许传入 llm */
-  llm?: never
-  /** 是否使用 ReAct 模式（通过提示词而非 function calling 进行工具调用），默认为 false */
-  useReActMode?: boolean
-}
-
-type LlmInstanceConfig = {
-  /** 自定义 Provider 实例，优先级最高 */
-  llm: ProviderV2
-  /** 互斥：当传入 llm 实例时不需要 apiKey/baseURL/providerType */
-  apiKey?: never
-  baseURL?: never
-  providerType?: never
-  /** 是否使用 ReAct 模式（通过提示词而非 function calling 进行工具调用），默认为 false */
-  useReActMode?: boolean
-}
-
-/** 代理模型提供器的大语言配置对象, 通过 XOR 表达二选一 */
-export type IAgentModelProviderLlmConfig = LlmFactoryConfig | LlmInstanceConfig
-
-/** Mcp Server的配置对象 */
-export type McpServerConfig =
-  | {
-      type: 'streamableHttp'
-      url: string
-      useAISdkClient?: boolean
-      headers?: Record<string, string>
-      name?: string
-      description?: string
-    }
-  | {
-      type: 'sse'
-      url: string
-      useAISdkClient?: boolean
-      headers?: Record<string, string>
-      name?: string
-      description?: string
-    }
-  | {
-      type: 'local'
-      transport: MCPTransport
-      useAISdkClient?: boolean
-      name?: string
-      description?: string
-    }
-  | {
-      /**
-       * 浏览器内置 WebMCP 类型。
-       * 将 `document.modelContext` 作为 MCP 工具数据源，
-       * 通过 `getBuiltinMcpTools` 适配为 ai-sdk 可调用的 ToolSet。
-       */
-      type: 'builtin'
-      /** 传入 `document.modelContext` 对象 */
-      client: BuiltinMcpClient
-      name?: string
-      description?: string
-    }
-
-/** */
-export interface IAgentModelProviderOption {
-  /** 代理模型提供器的大语言配置对象 */
-  llmConfig: IAgentModelProviderLlmConfig
-  /** Mcp Server的配置对象的集合，键为服务器名称，值为配置对象 */
-  mcpServers?: Record<string, McpServerConfig>
-}

package/agent/utils/generateReActPrompt.ts

@@ -1,71 +0,0 @@
-import type { ToolSet } from 'ai'
-
-/**
- * 生成 ReAct 模式的工具描述提示词（统一使用 XML 格式）
- * 将工具集合转换为 ReAct 格式的文本描述，用于添加到系统提示词中
- * @param tools - 工具集合对象
- * @returns 格式化的工具描述字符串
- */
-export function generateReActToolsPrompt(tools: ToolSet): string {
-  const toolEntries = Object.entries(tools)
-
-  // 如果没有工具，返回空字符串
-  if (toolEntries.length === 0) {
-    return ''
-  }
-
-  let prompt = `
-# 工具调用
-
-你可以根据需要调用以下工具：
-
-<tools>
-  `
-
-  // 遍历所有工具，生成工具描述
-  toolEntries.forEach(([toolName, tool]) => {
-    const toolInfo = tool as any
-    const description = toolInfo.description || '无描述'
-    const schema = toolInfo.parameters || toolInfo.inputSchema || {}
-
-    // 构造类似 OpenAI function 的格式但放在 XML 中
-    const toolJson = {
-      name: toolName,
-      description: description,
-      parameters: schema
-    }
-    prompt += `${JSON.stringify(toolJson, null, 2)}\n`
-  })
-
-  prompt += `
-</tools>
-
-## 工具调用格式
-
-要调用工具，请使用以下 XML 格式：
-Thought: [你的思考过程]
-<tool_call>
-  {"name": "toolName", "arguments": {"arg1": "value1"}}
-</tool_call>
-
-工具执行后，你将收到 <tool_response> 格式的结果。你可以继续思考或调用其他工具。
-
-## 使用示例
-
-如果用户要求"获取今天的日期"，你可以这样调用工具：
-Thought: 用户想要获取今天的日期，我需要调用日期相关的工具。
-<tool_call>{"name": "get-today", "arguments": {}}</tool_call>
-
-然后等待工具返回结果（Observation），再根据结果给出最终答案。
-
-## 任务完成
-
-当任务完成或无法继续时，直接给出最终答案即可。
-
-**重要提示**：
-- 必须严格按照 XML 格式调用工具
-- arguments 必须是有效的 JSON 格式
-- 如果不需要调用工具，直接给出最终答案即可
-`
-  return prompt
-}

package/agent/utils/getAISDKTools.ts

@@ -1,34 +0,0 @@
-import { dynamicTool, jsonSchema, Tool, ToolExecutionOptions, ToolSet } from 'ai'
-import { WebMcpClient } from '../../WebMcpClient'
-
-/**
- * 快速从官方 mcp 或 WebMcpClient 这2种client中读取 tools 数组，并转换成 ai-sdk 的tool的对象格式。
- * @params client  一个已连接好的 WebMcpClient
- * @returns ai-sdk的dynamicTool对象。
- */
-export const getAISDKTools = async (client: WebMcpClient): Promise<ToolSet> => {
-  const tools: Record<string, Tool> = {}
-
-  try {
-    const listToolsResult = await client.listTools()
-    for (const { name, description, inputSchema } of listToolsResult.tools) {
-      const execute = async (args: any, options: ToolExecutionOptions): Promise<any> => {
-        return client.callTool({ name, arguments: args }, { signal: options?.abortSignal })
-      }
-
-      tools[name] = dynamicTool({
-        description,
-        inputSchema: jsonSchema({
-          ...inputSchema,
-          properties: (inputSchema.properties as Record<string, any>) ?? {},
-          additionalProperties: false
-        }),
-        execute
-      })
-    }
-
-    return tools
-  } catch (error) {
-    throw error
-  }
-}

package/agent/utils/getBuiltinMcpTools.ts

@@ -1,86 +0,0 @@
-import { dynamicTool, jsonSchema, Tool, ToolSet } from 'ai'
-
-/**
- * 浏览器内置 WebMCP 测试 API 的工具描述格式（Chrome document.modelContext）
- */
-type BuiltinToolDescriptor = {
-  name: string
-  description?: string
-  inputSchema?: {
-    type?: string
-    properties?: Record<string, unknown>
-    required?: string[]
-    [key: string]: unknown
-  }
-}
-
-type BuiltinModelContextTesting = {
-  listTools?: () => Promise<BuiltinToolDescriptor[]>
-  getTools?: () => Promise<BuiltinToolDescriptor[]>
-  executeTool?: (tool: { name: string }, input: string) => Promise<unknown>
-}
-
-/**
- * 将浏览器内置 WebMCP 的 `document.modelContext` 适配为 ai-sdk 的 ToolSet。
- *
- * 类似 getAISDKTools，但数据源是浏览器原生 API 而非 MCP client。
- * 工具执行时通过 `executeTool(toolObj, JSON.stringify(args))` 代理给浏览器。
- *
- * @param client - `document.modelContext` 对象
- * @returns ai-sdk 格式的 ToolSet，可直接传入 streamText/generateText 的 tools 参数
- */
-export const getBuiltinMcpTools = async (client: object | undefined | null): Promise<ToolSet> => {
-  const tools: Record<string, Tool> = {}
-  if (!client) {
-    return tools
-  }
-
-  const testing = client as BuiltinModelContextTesting
-
-  // 优先使用 listTools，降级到 getTools
-  const listFn = testing.listTools ?? testing.getTools
-  if (!listFn) {
-    return tools
-  }
-
-  const rawList = await listFn.call(testing)
-  const list = Array.isArray(rawList) ? (rawList as BuiltinToolDescriptor[]) : []
-
-  for (const descriptor of list) {
-    const { name, description } = descriptor
-    const rawInputSchema = descriptor.inputSchema
-    let schemaObj: Record<string, any> = {}
-
-    if (typeof rawInputSchema === 'string') {
-      try {
-        schemaObj = JSON.parse(rawInputSchema)
-      } catch (e) {
-        console.error('Failed to parse inputSchema in getBuiltinMcpTools:', e)
-      }
-    } else if (typeof rawInputSchema === 'object' && rawInputSchema !== null) {
-      schemaObj = rawInputSchema as Record<string, any>
-    }
-
-    // 规范化 inputSchema：补全 properties/additionalProperties 字段
-    const normalizedSchema = {
-      type: 'object' as const,
-      properties: (schemaObj.properties ?? {}) as Record<string, unknown>,
-      ...(schemaObj.required ? { required: schemaObj.required } : {}),
-      additionalProperties: false,
-      ...schemaObj
-    }
-
-    tools[name] = dynamicTool({
-      description: description ?? '',
-      inputSchema: jsonSchema(normalizedSchema as Parameters<typeof jsonSchema>[0]),
-      async execute(args) {
-        if (!testing.executeTool) {
-          throw new Error(`document.modelContext.executeTool is not available`)
-        }
-        return testing.executeTool(descriptor, JSON.stringify(args ?? {}))
-      }
-    })
-  }
-
-  return tools
-}

package/agent/utils/parseReActAction.ts

@@ -1,34 +0,0 @@
-import type { ToolSet } from 'ai'
-
-/**
- * 解析 ReAct 格式的工具调用
- * 从模型输出文本中提取工具名称和参数
- * 现在统一使用 XML 格式（<call> 标签），同时保留对其他格式的兼容性支持
- * @param text - 模型输出的文本
- * @param availableTools - 可用的工具集合，用于验证工具名称
- * @returns 解析出的工具调用信息，如果未找到则返回 null
- */
-export function parseReActAction(text: string, availableTools: ToolSet): { toolName: string; arguments: any } | null {
-  if (!text || typeof text !== 'string') {
-    return null
-  }
-
-  // XML 格式 <tool_call>
-  const toolCallMatchLegacy = text.match(/<tool_call>([\s\S]*?)<\/tool_call>/i)
-  if (toolCallMatchLegacy) {
-    try {
-      const jsonContent = toolCallMatchLegacy[1].trim()
-      const parsed = JSON.parse(jsonContent)
-      const toolName = parsed.name || parsed.action || parsed.tool
-      const args = parsed.arguments || parsed.args || parsed.input || {}
-
-      if (toolName && availableTools[toolName]) {
-        return { toolName, arguments: args }
-      }
-    } catch {
-      // 解析失败，继续尝试其他方法
-    }
-  }
-
-  return null
-}

package/core.ts

@@ -1,26 +0,0 @@
-// 核心导出，仅包含无 DOM 依赖（Node.js / Service Worker 安全）的内容
-import Ajv from 'ajv'
-export { Ajv }
-export { z } from 'zod'
-export { AuthClientProvider } from '@opentiny/next'
-export { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'
-export { UriTemplate } from '@modelcontextprotocol/sdk/shared/uriTemplate.js'
-export { completable } from '@modelcontextprotocol/sdk/server/completable.js'
-export { getDisplayName } from '@modelcontextprotocol/sdk/shared/metadataUtils.js'
-export { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js'
-export type * from 'zod'
-export type * from '@opentiny/next'
-export type * from '@modelcontextprotocol/sdk/types.js'
-export type * from '@modelcontextprotocol/sdk/shared/protocol.js'
-export type * from '@modelcontextprotocol/sdk/shared/transport.js'
-export type * from '@modelcontextprotocol/sdk/client/sse.js'
-export type * from '@modelcontextprotocol/sdk/client/streamableHttp.js'
-export type * from '@modelcontextprotocol/sdk/server/mcp.js'
-
-export * from './WebMcpServer'
-export * from './WebMcpClient'
-
-export { AgentModelProvider } from './agent/AgentModelProvider'
-export { getAISDKTools } from './agent/utils/getAISDKTools'
-export type * from './agent/type'
-export { initializeBuiltinWebMCP } from './page-tools/initialize-builtin-WebMCP'

package/index.ts

@@ -1,56 +0,0 @@
-// 从相关包中，导出一些常用变量，方便用户导入
-import Ajv from 'ajv'
-export { Ajv }
-export { z } from 'zod'
-export { AuthClientProvider } from '@opentiny/next'
-export { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'
-export { UriTemplate } from '@modelcontextprotocol/sdk/shared/uriTemplate.js'
-export { completable } from '@modelcontextprotocol/sdk/server/completable.js'
-export { getDisplayName } from '@modelcontextprotocol/sdk/shared/metadataUtils.js'
-export { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js'
-export type * from 'zod'
-export type * from '@opentiny/next'
-export type * from '@modelcontextprotocol/sdk/types.js'
-export type * from '@modelcontextprotocol/sdk/shared/protocol.js'
-export type * from '@modelcontextprotocol/sdk/shared/transport.js'
-export type * from '@modelcontextprotocol/sdk/client/sse.js'
-export type * from '@modelcontextprotocol/sdk/client/streamableHttp.js'
-export type * from '@modelcontextprotocol/sdk/server/mcp.js'
-
-// 2大核心模块
-export * from './WebMcpServer'
-export * from './WebMcpClient'
-
-// 快速创建一个悬浮图标和菜单，是扫码和聊天框的入口
-export * from './remoter/createRemoter'
-
-// 一个通用的ai-sdk的agent封装
-export { AgentModelProvider } from './agent/AgentModelProvider'
-
-// 快速 从官方 mcp 或 WebMcpClient 这2种client中， 抽取成 ai-sdk 所需要的 tool的对象
-export { getAISDKTools } from './agent/utils/getAISDKTools'
-
-// 方便的二维码类
-export { QrCode, type QrCodeOption } from './remoter/QrCode'
-export type * from './agent/type'
-
-// Web MCP 页面工具桥接：工具调用自动导航 + 页面消息通信
-export * from './page-tools/bridge'
-
-// Web 端 Skill 公共能力：解析 skill 文档、生成 systemPrompt、内置 list_skills / get_skill_content 工具
-export {
-  getSkillOverviews,
-  formatSkillsForSystemPrompt,
-  getSkillMdContent,
-  getMainSkillPaths,
-  getMainSkillPathByName,
-  parseSkillFrontMatter,
-  createSkillTools,
-  type SkillMeta,
-  type SkillToolsSet
-} from './skills/index'
-
-export * from '@mcp-b/webmcp-polyfill'
-
-export { initializeBuiltinWebMCP } from './page-tools/initialize-builtin-WebMCP'
-export { registerPageAgentTool } from './page-tools/page-agent-tool'

package/page-tools/a11y/build.ts

@@ -1,70 +0,0 @@
-/**
- * a11y/build.ts
- *
- * 暴露生成整棵无障碍树的主逻辑方法。
- */
-
-import type { A11yTreeOptions, A11yTreeResult, RefMap } from './types'
-import { DEFAULT_ERROR_SELECTORS, DEFAULT_WARNING_SELECTORS } from './constants'
-import { buildVNode, serializeVNode } from './vnode'
-import { getComposedChildren } from './utils'
-import { HIGHLIGHT_CONTAINER_ID } from '../page-agent-highlight'
-
-const DEFAULT_OPTIONS: Required<A11yTreeOptions> = {
-  pruneUnnamed: true,
-  preserveRoles: [],
-  exposedAttributes: [],
-  errorSelectors: DEFAULT_ERROR_SELECTORS,
-  warningSelectors: DEFAULT_WARNING_SELECTORS
-}
-
-/**
- * 生成当前页面的语义化 ARIA YAML 树
- *
- * @param root 遍历起点，默认 document.body
- * @param blacklist 需要跳过的元素（用户自定义黑名单）
- * @param whitelist 需要识别为可交互的白名单元素列表
- * @param options 过滤选项
- */
-export function buildA11yTree(
-  root: Element = document.body,
-  blacklist: Element[] = [],
-  whitelist: Element[] = [],
-  options?: A11yTreeOptions
-): A11yTreeResult {
-  const opts: Required<A11yTreeOptions> = { ...DEFAULT_OPTIONS, ...options }
-  // 使用对象引用避免全局可变状态，消除并发调用隐患
-  const refCounter = { value: 0 }
-  const refMap: RefMap = new Map()
-  const blacklistSet = new Set(blacklist)
-  const whitelistSet = new Set(whitelist)
-  const lines: string[] = []
-
-  // 永远过滤高亮容器
-  blacklistSet.add(document.getElementById(HIGHLIGHT_CONTAINER_ID)!)
-
-  for (const child of getComposedChildren(root)) {
-    const vnode = buildVNode(
-      child,
-      refCounter,
-      refMap,
-      blacklistSet,
-      whitelistSet,
-      opts.exposedAttributes,
-      opts.errorSelectors,
-      opts.warningSelectors
-    )
-    if (vnode) {
-      lines.push(...serializeVNode(vnode, 0, opts))
-    }
-  }
-
-  const yaml = '```yaml\n' + lines.join('\n') + '\n```'
-
-  return {
-    yaml,
-    refMap,
-    interactiveCount: refMap.size,
-    lines
-  }
-}

package/page-tools/a11y/constants.ts

@@ -1,110 +0,0 @@
-/**
- * a11y/constants.ts
- *
- * 存放无障碍树依赖的静态常量配置、默认选择器及角色映射表。
- */
-
-// ─── 默认校验错误/警告选择器（ARIA 标准 + 主流 UI 框架） ──────────────────
-
-export const DEFAULT_ERROR_SELECTORS = [
-  '[role="alert"]', '[aria-invalid="true"]',
-  '.ti3-unifyvalid-error', '.ti3-error', '.ti-error',
-  '.lego-text-error', '.lego-error',
-  '.el-form-item__error',
-  '.ant-form-item-explain-error',
-  '.is-invalid', '.invalid-feedback',
-  '.ng-invalid',
-  '.error-msg', '.error-message', '.error-text',
-  '.field-error', '.form-error',
-  '.is-error', '.has-error',
-  '.validate-error', '.valid-error',
-]
-
-export const DEFAULT_WARNING_SELECTORS = [
-  '.ti3-warning', '.ti-warning', '.lego-text-warning',
-  '.warning-msg', '.warning-text', '.is-warning', '.has-warning',
-]
-
-// ─── ARIA 隐式角色静态映射表（覆盖页面 95%+ 的常用标签）───────────────────────
-
-export const TAG_ROLE_MAP: Record<string, string> = {
-  a: 'link',
-  article: 'article',
-  aside: 'complementary',
-  button: 'button',
-  caption: 'caption',
-  cell: 'cell',
-  checkbox: 'checkbox',
-  code: 'code',
-  columnheader: 'columnheader',
-  combobox: 'combobox',
-  datalist: 'listbox',
-  dd: 'definition',
-  details: 'group',
-  dialog: 'dialog',
-  dt: 'term',
-  em: 'emphasis',
-  fieldset: 'group',
-  figure: 'figure',
-  footer: 'contentinfo',
-  form: 'form',
-  h1: 'heading',
-  h2: 'heading',
-  h3: 'heading',
-  h4: 'heading',
-  h5: 'heading',
-  h6: 'heading',
-  header: 'banner',
-  hr: 'separator',
-  img: 'img',
-  input: 'textbox',         // 默认，具体 type 下面会覆盖
-  li: 'listitem',
-  link: 'link',
-  main: 'main',
-  mark: 'mark',
-  math: 'math',
-  menu: 'list',
-  menuitem: 'menuitem',
-  meter: 'meter',
-  nav: 'navigation',
-  ol: 'list',
-  option: 'option',
-  output: 'status',
-  p: 'paragraph',
-  progress: 'progressbar',
-  rowheader: 'rowheader',
-  search: 'search',
-  section: 'region',
-  select: 'listbox',
-  strong: 'strong',
-  summary: 'button',
-  table: 'table',
-  tbody: 'rowgroup',
-  td: 'cell',
-  textarea: 'textbox',
-  tfoot: 'rowgroup',
-  th: 'columnheader',
-  thead: 'rowgroup',
-  time: 'time',
-  tr: 'row',
-  ul: 'list',
-}
-
-// input[type=*] 的角色覆盖
-export const INPUT_TYPE_ROLE: Record<string, string> = {
-  button: 'button',
-  checkbox: 'checkbox',
-  color: 'textbox',
-  email: 'textbox',
-  file: 'textbox',
-  image: 'button',
-  number: 'spinbutton',
-  radio: 'radio',
-  range: 'slider',
-  reset: 'button',
-  search: 'searchbox',
-  submit: 'button',
-  tel: 'textbox',
-  text: 'textbox',
-  url: 'textbox',
-}