@opentiny/next-sdk 0.4.2 → 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,91 +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'
-export { PAGE_AGENT_TOOL_CALL_EVENT, PAGE_AGENT_TOOL_RESULT_EVENT } from './page-tools/page-agent-tool-event'
-export type { PageAgentToolCallEventDetail, PageAgentToolResultEventDetail } from './page-tools/page-agent-tool-event'
-export type { PageAgentToolOptions } from './page-tools/tool-config'
-
-// registerPageAgentTool 完整运行期配置（顶层选项 enableHighlight + 统一无障碍配置 a11yConfig）
-// 的唯一一套读写 API：注册时初始化一次，之后可随时读取/修改
-export { DEFAULT_PAGE_AGENT_TOOL_CONFIG, getPageAgentToolConfig, setPageAgentToolConfig } from './page-tools/tool-config'
-export type { PageAgentToolConfig, PageAgentToolConfigPatch } from './page-tools/tool-config'
-
-// 站点预设：云控制台（consoleCloud）等 PageAgentToolOptions，可直接传给 registerPageAgentTool
-export {
-  consoleCloudPageAgentToolOptions,
-  isConsoleCloudHost,
-} from './page-tools/configs/console-cloud'
-
-// 统一无障碍配置（A11yConfig）：角色/状态规则、白/黑名单、自定义属性、弹窗选择器，
-// 以及供用户直接调用的底层解析函数（运行期读写请使用上面的 getPageAgentToolConfig/setPageAgentToolConfig）
-export {
-  DEFAULT_A11Y_CONFIG,
-  defineA11yConfig,
-  resolveA11yInfo,
-  resolveA11yRole,
-  resolveA11yStates,
-  mergeA11yConfig,
-  mergeA11yConfigs,
-  ensureResolvedA11yConfig,
-  isResolvedA11yConfig,
-  extractSelectors,
-} from './page-tools/a11y/config'
-export type { A11yConfig, ResolvedA11yConfig, A11yRoleRule, A11yMatcher, A11yStateName, A11yInfo } from './page-tools/a11y/config'
-
-// 无障碍树构建与搜索：供高级用户直接生成/搜索自定义根节点下的无障碍树
-export { buildA11yTree } from './page-tools/a11y/build'
-export { searchA11yTree } from './page-tools/a11y/search'
-export type { A11yTreeOptions, A11yTreeResult, SearchA11yTreeOptions, SearchA11yTreeResult, VNode, RefMap } from './page-tools/a11y/types'

package/page-tools/a11y/build.ts

@@ -1,74 +0,0 @@
-/**
- * a11y/build.ts
- *
- * 暴露生成整棵无障碍树的主逻辑方法。
- */
-
-import type { A11yTreeOptions, A11yTreeResult, A11yTreeShapeOptions, RefMap } from './types'
-import type { A11yConfig } from './config'
-import { ensureResolvedA11yConfig } from './config'
-import { buildVNode, serializeVNode } from './vnode'
-import { getComposedChildren, collectHoverPointerElements } from './utils'
-import { deepQuerySelectorAll } from '../utils/dom'
-import { HIGHLIGHT_CONTAINER_ID } from '../page-agent-highlight'
-
-/** 将 whitelist/blacklist 中的 Element 引用与 CSS 选择器字符串统一解析为元素集合（字符串每次动态解析，适配 SPA 重渲染） */
-function resolveElementList(list: Array<Element | string>, root: Element): Set<Element> {
-  const set = new Set<Element>()
-  for (const item of list) {
-    if (typeof item === 'string') {
-      try {
-        for (const el of deepQuerySelectorAll(item, root)) set.add(el)
-      } catch {
-        // 忽略非法选择器
-      }
-    } else if (item) {
-      set.add(item)
-    }
-  }
-  return set
-}
-
-/**
- * 生成当前页面的语义化 ARIA YAML 树
- *
- * @param root 遍历起点，默认 document.body
- * @param config 统一无障碍配置（角色/状态规则、白/黑名单、自定义属性等）+ 树形状选项（pruneUnnamed/preserveRoles）
- */
-export function buildA11yTree(root: Element = document.body, config?: A11yConfig & A11yTreeOptions): A11yTreeResult {
-  const { pruneUnnamed = true, preserveRoles = [], ...a11yConfig } = config ?? {}
-  // 运行期 a11yConfig 通常已是 ResolvedA11yConfig，走快路径避免再次与默认配置拼接
-  const resolved = ensureResolvedA11yConfig(a11yConfig)
-  const shapeOpts: A11yTreeShapeOptions = { pruneUnnamed, preserveRoles }
-
-  // 使用对象引用避免全局可变状态，消除并发调用隐患
-  const refCounter = { value: 0 }
-  const refMap: RefMap = new Map()
-  const blacklistSet = resolveElementList(resolved.blacklist, root)
-  const whitelistSet = resolveElementList(resolved.whitelist, root)
-  const lines: string[] = []
-
-  // 永远过滤高亮容器
-  const highlightContainer = document.getElementById(HIGHLIGHT_CONTAINER_ID)
-  if (highlightContainer) blacklistSet.add(highlightContainer)
-
-  // 一次性扫描样式表，收集只在 :hover/:focus/:active 下声明 cursor:pointer 的元素。
-  // 这类元素静止态 getComputedStyle 读到 auto，需靠样式表兜底才能识别为可点击。
-  const hoverPointerSet = collectHoverPointerElements(root)
-
-  for (const child of getComposedChildren(root)) {
-    const vnode = buildVNode(child, refCounter, refMap, blacklistSet, whitelistSet, resolved, hoverPointerSet)
-    if (vnode) {
-      lines.push(...serializeVNode(vnode, 0, shapeOpts))
-    }
-  }
-
-  const yaml = '```yaml\n' + lines.join('\n') + '\n```'
-
-  return {
-    yaml,
-    refMap,
-    interactiveCount: refMap.size,
-    lines,
-  }
-}