@opentiny/next-sdk 0.1.14 → 0.1.15-beta.1

package/dist/WebMcpServer.d.ts

@@ -1,13 +1,11 @@
 import { MessageChannelServerTransport } from '@opentiny/next';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { z, ZodObject, ZodLiteral, ZodType, ZodOptional } from 'zod';
-import { SetLevelRequestSchema, SubscribeRequestSchema, UnsubscribeRequestSchema, ListResourcesRequestSchema, RootsListChangedNotificationSchema } from '@modelcontextprotocol/sdk/types.js';
-import type { ToolCallback, RegisteredTool, PromptCallback, RegisteredPrompt, ResourceMetadata, ResourceTemplate, RegisteredResource, ReadResourceCallback, RegisteredResourceTemplate, ReadResourceTemplateCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { Result, Request, Notification, Implementation, ToolAnnotations, ClientCapabilities, ElicitResult, ElicitRequest, ListRootsRequest, CreateMessageRequest, LoggingMessageNotification, ResourceUpdatedNotification } from '@modelcontextprotocol/sdk/types.js';
-import type { ZodRawShape, ZodTypeDef } from 'zod';
-import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
-import type { ServerOptions } from '@modelcontextprotocol/sdk/server/index.js';
-import type { RequestOptions, NotificationOptions, RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import { McpServer, ToolCallback, RegisteredTool, PromptCallback, RegisteredPrompt, ResourceMetadata, ResourceTemplate, RegisteredResource, ReadResourceCallback, RegisteredResourceTemplate, ReadResourceTemplateCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z, ZodObject, ZodLiteral, ZodType, ZodOptional, ZodRawShape, ZodTypeDef } from 'zod';
+import { SetLevelRequestSchema, SubscribeRequestSchema, UnsubscribeRequestSchema, ListResourcesRequestSchema, RootsListChangedNotificationSchema, Result, Request, Notification, Implementation, ToolAnnotations, ClientCapabilities, ElicitResult, ElicitRequest, ListRootsRequest, CreateMessageRequest, LoggingMessageNotification, ResourceUpdatedNotification } from '@modelcontextprotocol/sdk/types.js';
+import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { ServerOptions } from '@modelcontextprotocol/sdk/server/index.js';
+import { RequestOptions, NotificationOptions, RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+
 type PromptArgsRawShape = {
     [k: string]: ZodType<string, ZodTypeDef, string> | ZodOptional<ZodType<string, ZodTypeDef, string>>;
 };
@@ -100,61 +98,66 @@ export declare class WebMcpServer {
      * Sends a ping to the client to check if it is still connected.
      */
     ping(): Promise<{
-        _meta?: import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough"> | undefined;
+        _meta?: {
+            [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
+        } | undefined;
     }>;
     /**
      * Creates a LLM message to be sent to the client.
      */
-    createMessage(params: CreateMessageRequest['params'], options?: RequestOptions): Promise<z.objectOutputType<{
-        _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-    } & {
-        model: import("zod").ZodString;
-        stopReason: import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodEnum<["endTurn", "stopSequence", "maxTokens"]>, import("zod").ZodString]>>;
-        role: import("zod").ZodEnum<["user", "assistant"]>;
-        content: import("zod").ZodDiscriminatedUnion<"type", [import("zod").ZodObject<{
-            type: import("zod").ZodLiteral<"text">;
-            text: import("zod").ZodString;
-            _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-        }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
-            type: import("zod").ZodLiteral<"text">;
-            text: import("zod").ZodString;
-            _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-        }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
-            type: import("zod").ZodLiteral<"text">;
-            text: import("zod").ZodString;
-            _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-        }, import("zod").ZodTypeAny, "passthrough">>, import("zod").ZodObject<{
-            type: import("zod").ZodLiteral<"image">;
-            data: import("zod").ZodEffects<import("zod").ZodString, string, string>;
-            mimeType: import("zod").ZodString;
-            _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-        }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
-            type: import("zod").ZodLiteral<"image">;
-            data: import("zod").ZodEffects<import("zod").ZodString, string, string>;
-            mimeType: import("zod").ZodString;
-            _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-        }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
-            type: import("zod").ZodLiteral<"image">;
-            data: import("zod").ZodEffects<import("zod").ZodString, string, string>;
-            mimeType: import("zod").ZodString;
-            _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-        }, import("zod").ZodTypeAny, "passthrough">>, import("zod").ZodObject<{
-            type: import("zod").ZodLiteral<"audio">;
-            data: import("zod").ZodEffects<import("zod").ZodString, string, string>;
-            mimeType: import("zod").ZodString;
-            _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-        }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
-            type: import("zod").ZodLiteral<"audio">;
-            data: import("zod").ZodEffects<import("zod").ZodString, string, string>;
-            mimeType: import("zod").ZodString;
-            _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-        }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
-            type: import("zod").ZodLiteral<"audio">;
-            data: import("zod").ZodEffects<import("zod").ZodString, string, string>;
-            mimeType: import("zod").ZodString;
-            _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-        }, import("zod").ZodTypeAny, "passthrough">>]>;
-    }, z.ZodTypeAny, "passthrough">>;
+    createMessage(params: CreateMessageRequest['params'], options?: RequestOptions): Promise<{
+        [x: string]: unknown;
+        model: string;
+        role: "user" | "assistant";
+        content: {
+            type: "text";
+            text: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "image";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "audio";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        };
+        _meta?: {
+            [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        stopReason?: string | undefined;
+    }>;
     /**
      * Elicits input from the client, such as a prompt or resource.
      */
@@ -162,23 +165,21 @@ export declare class WebMcpServer {
     /**
      * Lists the root resources available to the client.
      */
-    listRoots(params?: ListRootsRequest['params'], options?: RequestOptions): Promise<z.objectOutputType<{
-        _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-    } & {
-        roots: import("zod").ZodArray<import("zod").ZodObject<{
-            uri: import("zod").ZodString;
-            name: import("zod").ZodOptional<import("zod").ZodString>;
-            _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-        }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
-            uri: import("zod").ZodString;
-            name: import("zod").ZodOptional<import("zod").ZodString>;
-            _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-        }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
-            uri: import("zod").ZodString;
-            name: import("zod").ZodOptional<import("zod").ZodString>;
-            _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-        }, import("zod").ZodTypeAny, "passthrough">>, "many">;
-    }, z.ZodTypeAny, "passthrough">>;
+    listRoots(params?: ListRootsRequest['params'], options?: RequestOptions): Promise<{
+        [x: string]: unknown;
+        roots: {
+            uri: string;
+            name?: string | undefined;
+            _meta?: Record<string, unknown> | undefined;
+        }[];
+        _meta?: {
+            [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    }>;
     /**
      * Sends a logging message to the client.
      */
@@ -253,7 +254,7 @@ export declare const createMessageChannelServerTransport: (endpoint: string, glo
 /**
  * Creates a pair of transports for communication between a server and client using MessageChannel.
  */
-export declare const createMessageChannelPairTransport: () => [import("@opentiny/next").MessageChannelTransport, import("@opentiny/next").MessageChannelTransport];
+export declare const createMessageChannelPairTransport: () => [import('@opentiny/next').MessageChannelTransport, import('@opentiny/next').MessageChannelTransport];
 /**
  * Checks if the transport is a MessageChannelServerTransport.
  */

package/dist/Zod.d.ts

@@ -0,0 +1 @@
+export { z } from 'zod';

package/dist/agent/AgentModelProvider.d.ts

@@ -1,10 +1,10 @@
 import { streamText, generateText } from 'ai';
-import type { IAgentModelProviderOption, McpServerConfig } from './type';
+import { IAgentModelProviderOption, McpServerConfig } from './type';
 import { ProviderV2 } from '@ai-sdk/provider';
-import { OpenAIProvider } from '@ai-sdk/openai';
-import { createOpenAI } from '@ai-sdk/openai';
+import { OpenAIProvider, createOpenAI } from '@ai-sdk/openai';
 import { createDeepSeek } from '@ai-sdk/deepseek';
 import { WebMcpClient } from '../WebMcpClient';
+
 export declare const AIProviderFactories: {
     openai: typeof createOpenAI;
     deepseek: typeof createDeepSeek;
@@ -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;
@@ -39,6 +41,8 @@ export declare class AgentModelProvider {
     private _closeOneClient;
     /** 创建所有 mcpClients */
     private _createMpcClients;
+    /** 兼容两种 client 类型的 tools 获取方法 */
+    private _getClientTools;
     /** 查询所有 mcpClients 的 tools, 失败则保存为null */
     private _createMpcTools;
     /** 关闭所有的 clients */
@@ -48,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 | 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 @@
-export type { experimental_MCPClient as MCPClient } from 'ai';
-import type { ProviderV2 } from '@ai-sdk/provider';
-import type { MCPTransport } from 'ai';
+import { ProviderV2 } from '@ai-sdk/provider';
+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;
@@ -26,15 +31,19 @@ export type IAgentModelProviderLlmConfig = LlmFactoryConfig | LlmInstanceConfig;
 export type McpServerConfig = {
     type: 'streamableHttp';
     url: string;
+    useAISdkClient?: boolean;
 } | {
     type: 'sse';
     url: string;
+    useAISdkClient?: boolean;
 } | {
     type: 'extension';
     url: string;
     sessionId: string;
+    useAISdkClient?: boolean;
 } | {
     transport: MCPTransport;
+    useAISdkClient?: boolean;
 };
 /** */
 export interface IAgentModelProviderOption {
@@ -43,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/getAISDKTools.d.ts

@@ -1,5 +1,6 @@
 import { ToolSet } from 'ai';
 import { WebMcpClient } from '../../WebMcpClient';
+
 /**
  * 快速从官方 mcp 或 WebMcpClient 这2种client中读取 tools 数组，并转换成 ai-sdk 的tool的对象格式。
  * @params client  一个已连接好的 WebMcpClient

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;

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import Ajv from 'ajv';
+import { default as Ajv } from 'ajv';
+
 export { Ajv };
 export { z } from 'zod';
 export { AuthClientProvider } from '@opentiny/next';