@opentiny/next-sdk 0.1.15 → 0.2.0

package/dist/agent/AgentModelProvider.d.ts

@@ -32,6 +32,8 @@ export declare class AgentModelProvider {
     onClientDisconnected?: (serverName: string, reason?: string) => void;
     /** 缓存 ai-sdk response 中的 多轮会话的上下文 */
     messages: any[];
+    /** 是否使用 ReAct 模式（通过提示词而非 function calling 进行工具调用） */
+    useReActMode: boolean;
     constructor({ llmConfig, mcpServers }: IAgentModelProviderOption);
     /** 创建一个 ai-sdk的 mcpClient, 创建失败则返回 null */
     private _createOneClient;
@@ -50,11 +52,43 @@ export declare class AgentModelProvider {
     /** 全量更新所有的 mcpServers */
     updateMcpServers(mcpServers?: Record<string, McpServerConfig>): Promise<void>;
     /** 插入一个新的mcpServer，如果已经存在则返回false */
-    insertMcpServer(serverName: string, mcpServer: McpServerConfig): Promise<false | WebMcpClient | import('ai').experimental_MCPClient | null>;
+    insertMcpServer(serverName: string, mcpServer: McpServerConfig): Promise<false | WebMcpClient | import('@ai-sdk/mcp').experimental_MCPClient | null>;
     /** 通过服务器名称删除mcpServer： mcpServers mcpClients  mcpTools ignoreToolnames  */
     removeMcpServer(serverName: string): Promise<void>;
     /** 创建临时允许调用的tools集合 */
     private _tempMergeTools;
+    /** 生成 ReAct 模式的系统提示词（包含工具描述） */
+    private _generateReActSystemPrompt;
+    /** 执行 ReAct 模式下的工具调用 */
+    private _executeReActToolCall;
+    /** ReAct 模式的对话实现 */
+    private _chatReAct;
+    /**
+     * 检查消息内容是否包含图片
+     * @param content 消息内容
+     * @returns 是否包含图片
+     */
+    private _messageHasImage;
+    /**
+     * 从消息中移除图片，但保留文本内容
+     * @param message 原始消息
+     * @returns 移除图片后的消息（如果只有图片没有文本，返回 null）
+     */
+    private _removeImageFromMessage;
+    /**
+     * 构建用于模型调用的消息列表（magentic-ui 风格）
+     * 策略：保留所有文本消息，仅限制图片数量（类似 magentic-ui 的 maybe_remove_old_screenshots）
+     *
+     * @param systemMessage 系统提示词
+     * @param allMessages 所有消息历史（包括初始消息和后续对话）
+     * @param maxImages 最多保留的图片数量（默认3张）
+     * @returns 构建好的消息列表
+     */
+    private _buildMessagesForModel;
+    /** ReAct 模式非流式对话 */
+    private _chatReActNonStream;
+    /** ReAct 模式流式对话 */
+    private _chatReActStream;
     private _chat;
     chat(options: Parameters<typeof generateText>[0] & {
         maxSteps?: number;

package/dist/agent/type.d.ts

@@ -1,6 +1,7 @@
 import { ProviderV2 } from '@ai-sdk/provider';
-import { MCPTransport } from 'ai';
-export type { experimental_MCPClient as MCPClient } from 'ai';
+import { experimental_MCPClientConfig as MCPClientConfig } from '@ai-sdk/mcp';
+
+export type MCPTransport = MCPClientConfig['transport'];
 type ProviderFactory = 'openai' | 'deepseek' | ((options: any) => ProviderV2);
 type LlmFactoryConfig = {
     /** API密钥 */
@@ -11,6 +12,8 @@ type LlmFactoryConfig = {
     providerType: ProviderFactory;
     /** 互斥：当使用 providerType 分支时不允许传入 llm */
     llm?: never;
+    /** 是否使用 ReAct 模式（通过提示词而非 function calling 进行工具调用），默认为 false */
+    useReActMode?: boolean;
 };
 type LlmInstanceConfig = {
     /** 自定义 Provider 实例，优先级最高 */
@@ -19,6 +22,8 @@ type LlmInstanceConfig = {
     apiKey?: never;
     baseURL?: never;
     providerType?: never;
+    /** 是否使用 ReAct 模式（通过提示词而非 function calling 进行工具调用），默认为 false */
+    useReActMode?: boolean;
 };
 /** 代理模型提供器的大语言配置对象, 通过 XOR 表达二选一 */
 export type IAgentModelProviderLlmConfig = LlmFactoryConfig | LlmInstanceConfig;
@@ -47,3 +52,4 @@ export interface IAgentModelProviderOption {
     /** Mcp Server的配置对象的集合，键为服务器名称，值为配置对象 */
     mcpServers?: Record<string, McpServerConfig>;
 }
+export {};

package/dist/agent/utils/generateReActPrompt.d.ts

@@ -0,0 +1,9 @@
+import { ToolSet } from 'ai';
+
+/**
+ * 生成 ReAct 模式的工具描述提示词（统一使用 XML 格式）
+ * 将工具集合转换为 ReAct 格式的文本描述，用于添加到系统提示词中
+ * @param tools - 工具集合对象
+ * @returns 格式化的工具描述字符串
+ */
+export declare function generateReActToolsPrompt(tools: ToolSet): string;

package/dist/agent/utils/parseReActAction.d.ts

@@ -0,0 +1,14 @@
+import { ToolSet } from 'ai';
+
+/**
+ * 解析 ReAct 格式的工具调用
+ * 从模型输出文本中提取工具名称和参数
+ * 现在统一使用 XML 格式（<call> 标签），同时保留对其他格式的兼容性支持
+ * @param text - 模型输出的文本
+ * @param availableTools - 可用的工具集合，用于验证工具名称
+ * @returns 解析出的工具调用信息，如果未找到则返回 null
+ */
+export declare function parseReActAction(text: string, availableTools: ToolSet): {
+    toolName: string;
+    arguments: any;
+} | null;