@opentiny/next-sdk 0.0.1-alpha.1

package/README.md

@@ -0,0 +1,322 @@
+# next-sdk 使用指南
+
+## 项目简介
+
+`next-sdk` 是基于 `@modelcontextprotocol/sdk` 和 `@opentiny/next` 的客户端和服务端封装，提供了更友好的 API 和更丰富的功能。
+
+---
+
+## 目录结构与主要模块
+
+- `client/`：客户端相关能力
+  - `createClient.ts`：创建客户端实例，提供事件注册、插件机制等核心功能
+  - `connectMcpServer.ts`：遥控端连接服务端的插件，支持 stream/sse 两种传输方式
+  - `createInMemoryTransport.ts`：内存传输实现，便于本地调试和测试
+  - `createMessageChannelTransport.ts`：基于 MessageChannel 的多窗口 iframe 通信的 transport 实现
+  - `createProxy.ts`：创建代理对象和孪生 Transport，支持 stream/sse 两种传输方式
+  - `index.ts`：导出所有客户端模块
+
+- `server/`：服务端相关能力
+  - `createServer.ts`：创建服务端实例，提供事件监听和处理能力
+  - `index.ts`：导出所有服务端模块
+
+- `mcp-host/`：多模型能力平台（MCP）相关实现
+  - `core/`：核心能力实现
+  - `deepseek/`：DeepSeek LLM 接入实现
+  - `index.ts`：统一导出 MCP 相关能力
+
+- `utils/`：工具方法
+  - `dom.ts`：DOM 相关工具方法
+  - `index.ts`：导出所有工具方法
+
+- `type.ts`：类型定义文件
+  - 包含客户端、服务端、传输方式等相关类型定义
+  - 提供完整的 TypeScript 类型支持
+
+- `index.ts`：根入口文件
+  - 统一导出客户端和服务端模块
+  - 方便用户引入使用
+
+---
+
+## 1. 客户端能力
+
+### 1.1 NextClient 类
+
+`NextClient` 封装了底层 Client 实例，提供事件注册、插件机制、连接等能力。
+
+#### 创建 NextClient 实例
+
+```ts
+import { createClient } from '@opentiny/next-sdk'
+
+
+// 通过 createClient 创建 NextClient 实例，便于后续扩展和事件注册。
+const client = createClient({name: 'next-sdk',version: '1.0.0'})
+```
+
+### 1.2 注册插件
+
+```ts
+// 通过插件机制扩展 client 能力，plugin函数执行返回的是一个接收 client 实例的函数。
+await client.use(plugin({options}))
+```
+
+#### 1.2.1 createInMemoryTransport
+
+此插件用于本地或跨 iframe 的消息通道通信。
+
+```ts
+import { createInMemoryTransport } from '@opentiny/next-sdk'
+
+// 设置为 InMemory 通信，适合前端多窗口/iframe 场景。
+await client.use(createInMemoryTransport())
+```
+
+#### 1.2.2 createMessageChannelTransport
+
+此插件用于本地或跨 iframe 的消息通道通信。
+
+```ts
+import { createMessageChannelTransport } from '@opentiny/next-sdk'
+
+// 设置为 MessageChannel 通信，适合前端多窗口/iframe 场景。
+await client.use(createMessageChannelTransport({ endpoint, globalObject }))
+```
+
+#### 1.2.3 createClientProxy
+
+此插件用于通过 stream 或 sse 代理方式与服务端通信。
+
+```ts
+import { createClientProxy } from '@opentiny/next-sdk'
+
+// 根据 type 选择 stream 或 sse 方式，自动管理 session 和连接关闭。
+await client.use(createClientProxy({
+  type: 'stream', // 或 'sse'
+  url: 'https://agent-server.com/mcp',
+  token: 'your-token',
+  sessionId: 'xxx'
+}))
+```
+
+#### 1.2.4 connectMcpServer
+
+此插件用于遥控器端或者业界通用的 `MCP HOST` 直接连接 MCP 服务端，支持 stream/sse。
+
+```ts
+import { connectMcpServer } from 'next-sdk'
+
+// 直接配置服务端地址和鉴权信息，快速建立连接。
+await client.use(connectMcpServer({
+  type: 'stream', // 或 'sse'
+  url: 'https://agent-server.com/mcp?sessionId=xxx',
+  token: 'your-token',
+}))
+```
+
+### 1.3 事件注册
+
+```ts
+// 支持注册通知事件（如 toolListChanged、resourceUpdated 等）和请求事件（如 createMessage、listRoots 等）。
+
+// 监听工具变化事件
+client.on('toolListChanged', callback)
+// 监听资源变化事件
+client.on('resourceUpdated', callback)
+// 监听日志发送事件
+client.on('loggingMessage', callback)
+// 监听listRoots
+client.on('listRoots', callback)
+// 监听创建消息，并返回大模型响应
+client.on('createMessage', callback)
+```
+
+#### 1.4 连接
+
+```ts
+// 建立与服务端的连接，具体传输方式由 插件的 transport 决定。  
+await client.connectTransport()
+```
+
+---
+
+## 2. 服务端能力
+
+### 2.1 NextServer 类
+
+`NextServer` 封装了底层 McpServer 实例，提供事件注册、插件机制、连接等能力。
+
+#### 创建 NextServer 实例
+
+```ts
+import { createServer } from '@opentiny/next-sdk'
+
+// 通过 createServer 创建 NextServer 实例。
+const server = createServer({name: 'next-sdk', version: '1.0.0'})
+```
+
+### 2.2 注册插件
+
+```ts
+// 通过插件机制扩展 server 能力，plugin函数执行返回的是一个接收 server 实例的函数。
+await server.use(plugin({options}))
+```
+
+#### 2.2.1 createInMemoryTransport
+
+此插件用于本地或跨 iframe 的消息通道通信。
+
+```ts
+import { createInMemoryTransport } from '@opentiny/next-sdk'
+
+// 设置为 InMemory 通信，适合前端多窗口/iframe 场景。
+await server.use(createInMemoryTransport())
+```
+
+#### 2.2.2 createMessageChannelTransport
+
+此插件用于本地或跨 iframe 的消息通道通信。
+
+```ts
+import { createMessageChannelTransport } from '@opentiny/next-sdk'
+
+// 设置为 MessageChannel 通信，适合前端多窗口/iframe 场景。
+await server.use(createMessageChannelTransport({ endpoint, globalObject }))
+```
+
+#### 2.2.3 createServerProxy
+
+此插件用于通过 stream 或 sse 代理方式与客户端通信。
+
+```ts
+import { createServerProxy } from '@opentiny/next-sdk'
+
+// 根据 type 选择 stream 或 sse 方式，自动管理 session 和连接关闭。
+await server.use(createServerProxy()) 
+```
+
+### 2.3 事件注册
+
+```ts
+// 注册服务端请求事件（如 subscribe、unsubscribe、listResources 等）。
+
+// 监听订阅资源
+server.on('subscribe', callback)
+// 监听取消订阅资源
+server.on('unsubscribe', callback)
+// 监听设置日志级别
+server.on('setLogLevel', callback)
+// 监听ping
+server.on('ping', callback)
+```
+
+### 2.4 连接
+
+```ts
+// 建立服务端监听，支持 messageChannel 等多种传输方式。
+await server.connectTransport()
+```
+
+---
+
+## 3. 典型用法示例 -- （前端工程MCP 服务端、agent-server代理服务器、遥控端）
+
+### 3.1 前端工程（App.vue）通过 createProxy 代理 stream 方式连接agent-server代理服务器
+
+```ts
+import { createClient, createClientProxy } from '@opentiny/next-sdk'
+
+const nextClient = createClient({name: 'next-sdk',version: '1.0.0'})
+
+const { sessionId, transport } = await nextClient.use(createClientProxy({
+  type: 'stream',
+  url: 'https://agent-server.com/mcp',
+  sessionId: 'xxx',
+  token: 'your-token'
+}))
+
+await client.connectTransport()
+```
+
+### 3.2 MCP 服务端（子路由页面）定义工具或者监听请求
+
+```ts
+import { createServer,createServerProxy } from '@opentiny/next-sdk'
+
+const server = createServer({name: 'next-sdk',version: '1.0.0'})
+
+server.use(createServerProxy())
+
+server.tool('get-weather', 'Get the weather of a city', { value: z.string() }, async ({ value }) => {
+    return { content: [{ type: 'text', text: `The weather of ${value} is sunny` }] }
+})
+
+server.on('subscribe', callback)
+
+await server.connectTransport()
+```
+
+### 3.3 远程遥控端（可以是手机、平板、电脑等）通过 connectMcpServer 连接agent-server代理服务器
+
+```ts
+import { createClient, connectMcpServer } from '@opentiny/next-sdk'
+
+const client = createClient({name: 'next-sdk',version: '1.0.0'})
+
+await client.use(connectMcpServer({
+  type: 'stream',
+  url: 'https://agent-server.com/mcp?sessionId=xxx',
+  token: 'your-token'
+}))
+
+await client.connectTransport()
+```
+
+## 4. 典型用法示例 -- （前端工程MCP 服务端、iframe 帮助文档遥控端）
+
+### 4.1 iframe 帮助文档遥控端通过 messageChannel 连接前端工程
+
+```ts
+import { createClient, createMessageChannelTransport } from '@opentiny/next-sdk'
+
+const client = createClient({name: 'next-sdk',version: '1.0.0'})
+
+client.use(createMessageChannelTransport({
+  endpoint: 'endpoint',
+  globalObject: window.parent
+}))
+
+await client.connectTransport()
+```
+
+### 4.2 前端工程通过 messageChannel 连接 iframe 帮助文档遥控端，并定义工具或者监听请求
+
+```ts
+import { createServer, createMessageChannelTransport } from '@opentiny/next-sdk'
+
+const server = createServer({name: 'next-sdk',version: '1.0.0'})
+
+server.use(createMessageChannelTransport({
+  endpoint: 'endpoint',
+  globalObject: window
+}))
+
+server.tool('get-weather', 'Get the weather of a city', { value: z.string() }, async ({ value }) => {
+    return { content: [{ type: 'text', text: `The weather of ${value} is sunny` }] }
+})
+
+server.on('subscribe', callback)
+
+await server.connectTransport()
+```
+
+---
+
+## 5. 其他说明
+
+- 所有通信方式均支持插件机制，便于灵活扩展。
+- 支持多种事件注册，覆盖通知和请求两大类。
+- 传输方式可根据实际场景选择（如 messageChannel 适合前端多窗口，stream/sse 适合前后端通信）。
+
+---

package/dist/client/index.d.ts

@@ -0,0 +1 @@
+export * from './createClient';

package/dist/error.d.ts

@@ -0,0 +1,9 @@
+declare enum ErrorCode {
+    ConnectionClosed = -32000,
+    RequestTimeout = -32001,
+    ParseError = -32700,
+    InvalidRequest = -32600,
+    MethodNotFound = -32601,
+    InvalidParams = -32602,
+    InternalError = -32603
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './client';
+export * from './server';
+export * from './mcp-host';
+export * from './plugins/createMessageChannelTransport';
+export * from './plugins/createProxy';
+export * from './plugins/connectMcpServer';
+export * from './plugins/createInMemoryTransport';

package/dist/index.mjs

@@ -0,0 +1,357 @@
+var b = Object.defineProperty;
+var x = (s, e, t) => e in s ? b(s, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : s[e] = t;
+var i = (s, e, t) => x(s, typeof e != "symbol" ? e + "" : e, t);
+import { Client as v } from "@modelcontextprotocol/sdk/client/index.js";
+import { LoggingMessageNotificationSchema as O, PromptListChangedNotificationSchema as P, ResourceUpdatedNotificationSchema as D, ToolListChangedNotificationSchema as q, ElicitRequestSchema as U, ListRootsRequestSchema as w, CreateMessageRequestSchema as y, PingRequestSchema as H, SetLevelRequestSchema as k, ListResourcesRequestSchema as _, UnsubscribeRequestSchema as $, SubscribeRequestSchema as j } from "@modelcontextprotocol/sdk/types.js";
+import { McpServer as Y } from "@modelcontextprotocol/sdk/server/mcp.js";
+import F from "openai";
+import { MessageChannelClientTransport as K, MessageChannelServerTransport as B, createTransportPair as J, createStreamProxy as V, createSseProxy as W, streamOptions as X, sseOptions as z } from "@opentiny/next";
+import { StreamableHTTPClientTransport as R } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { SSEClientTransport as A } from "@modelcontextprotocol/sdk/client/sse.js";
+import { InMemoryTransport as G } from "@modelcontextprotocol/sdk/inMemory.js";
+const S = {
+  toolListChanged: q,
+  resourceUpdated: D,
+  promptListChanged: P,
+  loggingMessage: O
+}, Q = {
+  createMessage: y,
+  listRoots: w,
+  elicit: U
+};
+class L extends v {
+  constructor(t, o) {
+    super(t, o);
+    i(this, "nextTransport", null);
+    i(this, "isMessageChannel", !1);
+  }
+  // 注册插件
+  use(t) {
+    return t(this);
+  }
+  // 注册事件,包括notification以及requestHandle
+  on(t, o) {
+    t in S ? this.setNotificationHandler(S[t], o) : this.setRequestHandler(Q[t], o);
+  }
+  async connectTransport() {
+    return await this.connect(this.nextTransport);
+  }
+}
+const de = (s, e) => new L(s, e), Z = {
+  subscribe: j,
+  unsubscribe: $,
+  listResources: _,
+  createMessage: y,
+  listRoots: w,
+  setLevel: k,
+  ping: H
+};
+class ee extends Y {
+  constructor(t, o) {
+    super(t, o);
+    i(this, "nextTransport");
+    i(this, "isMessageChannel", !1);
+  }
+  use(t) {
+    return t(this);
+  }
+  async connectTransport() {
+    var t, o;
+    return this.isMessageChannel && await ((o = (t = this.nextTransport) == null ? void 0 : t.listen) == null ? void 0 : o.call(t)), await this.connect(this.nextTransport);
+  }
+  on(t, o) {
+    this.server.setRequestHandler(Z[t], o);
+  }
+}
+const Se = (s, e) => new ee(s, e);
+var c = /* @__PURE__ */ ((s) => (s.FUNCTION = "function", s.USER = "user", s.ASSISTANT = "assistant", s.DEVELOPER = "developer", s.SYSTEM = "system", s.TOOL = "tool", s))(c || {});
+const C = 3;
+class te {
+  // 最大迭代次数
+  constructor({ llmOption: e, mcpClients: t }) {
+    i(this, "llmOption");
+    i(this, "mcpClients");
+    i(this, "llm");
+    i(this, "mcpClientMap", /* @__PURE__ */ new Map());
+    i(this, "messages", []);
+    i(this, "toolClientMap", /* @__PURE__ */ new Map());
+    i(this, "iteration", C);
+    this.llmOption = e, this.mcpClients = t, this.messages.push({ role: c.SYSTEM, content: "You are a helpful assistant with access to tools." });
+  }
+  async generateMcpClient() {
+    for (let e = 0; e < this.mcpClients.length; e++) {
+      const t = this.mcpClients[e], { tools: o } = await t.listTools();
+      this.mcpClientMap.set(t, o), o.forEach((a) => {
+        this.toolClientMap.set(a.name, t);
+      });
+    }
+  }
+  init() {
+    this.llm = new F({
+      baseURL: this.llmOption.url,
+      apiKey: this.llmOption.apiKey,
+      dangerouslyAllowBrowser: !0
+    });
+  }
+  validateRequest(e) {
+    if (!e.messages || !Array.isArray(e.messages) || e.messages.length === 0)
+      throw new Error("请求必须包含至少一条消息");
+    for (const t of e.messages)
+      if (!t.role || !t.content)
+        throw new Error("每条消息必须包含角色和内容");
+  }
+  async getMcpTools() {
+    const e = [];
+    for (const [, o] of this.mcpClientMap.entries())
+      e.push(...o);
+    return e.map((o) => ({
+      type: "function",
+      function: {
+        name: o.name,
+        description: o.description,
+        parameters: o.inputSchema
+      }
+    }));
+  }
+  async doLLMChart() {
+    const e = await this.getMcpTools();
+    return await this.llm.chat.completions.create({
+      messages: this.messages,
+      model: this.llmOption.model,
+      tools: e,
+      stream: !0
+    });
+  }
+  /**
+   * 解析 LLM 回复，提取工具调用和最终回复内容
+   * @param response LLM 回复对象
+   * @returns [工具调用数组, 回复内容]
+   */
+  async parseToolCalls(e, t) {
+    var h, p, f, n;
+    const o = /* @__PURE__ */ new Map();
+    let a = "", r = "";
+    for await (const T of e) {
+      const u = T.choices[0].delta, g = u == null ? void 0 : u.tool_calls, d = u == null ? void 0 : u.content;
+      if (d && (a += d, t.onData({
+        delta: {
+          role: "assistant",
+          content: d
+        }
+      })), g && g.length > 0) {
+        const l = g[0];
+        if (l.id) {
+          r = l.id;
+          const m = {
+            id: l.id,
+            type: l.type,
+            function: {
+              name: ((h = l.function) == null ? void 0 : h.name) || "",
+              arguments: ((p = l.function) == null ? void 0 : p.arguments) || ""
+            }
+          };
+          o.set(r, m), t.onData({
+            delta: {
+              role: c.ASSISTANT,
+              content: `
+
+正在调用工具：${m.function.name}
+
+参数：`
+            }
+          });
+        }
+        if (o.has(r)) {
+          const m = o.get(r);
+          m && (m.function.arguments += ((f = l.function) == null ? void 0 : f.arguments) || "", t.onData({
+            delta: {
+              role: c.ASSISTANT,
+              content: `${(n = l.function) == null ? void 0 : n.arguments}`
+            }
+          }));
+        }
+      }
+    }
+    return t.onData({
+      delta: {
+        role: "assistant",
+        content: `
+
+`
+      }
+    }), [Array.from(o.values()), a];
+  }
+  /**
+   * 执行工具调用
+   * @param toolCalls 工具调用请求列表
+   * @returns 工具调用结果和消息
+   */
+  async callTools(e, t) {
+    var o, a, r, h;
+    try {
+      const p = [], f = [];
+      for (const n of e) {
+        const T = n.function.name, u = this.toolClientMap.get(T);
+        if (!u)
+          continue;
+        let g = {};
+        try {
+          g = typeof n.function.arguments == "string" ? JSON.parse(n.function.arguments) : n.function.arguments;
+        } catch (N) {
+          console.error(`Failed to parse tool arguments for ${T}:`, N), g = {};
+        }
+        const d = {
+          id: n.id,
+          type: n.type,
+          function: {
+            name: ((o = n.function) == null ? void 0 : o.name) || "",
+            arguments: ((a = n.function) == null ? void 0 : a.arguments) || ""
+          }
+        };
+        t.onData({
+          delta: {
+            role: c.TOOL,
+            toolCall: d
+          }
+        });
+        const l = await u.callTool({
+          name: T,
+          arguments: g
+        }), m = this.getToolCallMessage(l), I = {
+          role: c.TOOL,
+          tool_call_id: n.id,
+          content: m
+        }, E = {
+          id: n.id,
+          type: n.type,
+          callToolContent: m,
+          function: {
+            name: ((r = n.function) == null ? void 0 : r.name) || "",
+            arguments: ((h = n.function) == null ? void 0 : h.arguments) || ""
+          }
+        };
+        t.onData({
+          delta: {
+            role: c.TOOL,
+            toolCall: E
+          }
+        }), f.push(I), p.push({
+          call: T,
+          result: l
+        });
+      }
+      return { toolResults: p, toolCallMessages: f };
+    } catch (p) {
+      return console.error("Error calling tools:", p), { toolResults: [], toolCallMessages: [{ role: c.ASSISTANT, content: "call tools failed!" }] };
+    }
+  }
+  /**
+   * 解析工具调用结果，拼接为字符串
+   * @param toolCallResult 工具调用结果
+   * @returns 拼接后的字符串
+   */
+  getToolCallMessage(e) {
+    var o;
+    let t = "";
+    return (o = e.content) != null && o.length && e.content.forEach((a) => {
+      switch (a.type) {
+        case "text":
+          t += a.text;
+          break;
+        case "image":
+        case "audio":
+        case "resource":
+          t += a.data;
+          break;
+      }
+    }), t;
+  }
+  async chatStream(e, t) {
+    return await this.generateMcpClient(), typeof e == "string" ? this.messages.push({ role: c.USER, content: e }) : this.messages.push(e.messages[e.messages.length - 1]), this.iteration = C, await this.processSteamToolCallsAndResponses(t).catch((o) => {
+      console.error("Chat failed:", o);
+    }), "ok";
+  }
+  /**
+   * 聊天迭代主流程，支持多轮工具调用和最终回复
+   */
+  async processSteamToolCallsAndResponses(e) {
+    try {
+      const t = [];
+      for (; this.iteration > 0; ) {
+        const o = await this.doLLMChart(), [a, r] = await this.parseToolCalls(o, e);
+        if (a.length) {
+          const h = {
+            role: c.ASSISTANT,
+            content: `调用工具:${a.map((n) => n.function.name).join(",")}`,
+            tool_calls: a.map((n) => ({
+              id: n.id,
+              type: n.type,
+              function: n.function
+            }))
+          };
+          this.messages.push(h);
+          const { toolResults: p, toolCallMessages: f } = await this.callTools(a, e);
+          t.push(...p), f.forEach((n) => this.messages.push(n)), this.iteration--;
+        } else
+          this.messages.push({ role: c.ASSISTANT, content: r }), this.iteration = 0;
+      }
+      e.onDone();
+    } catch (t) {
+      throw console.error("Chat iteration failed:", t), t;
+    }
+  }
+}
+class se extends te {
+  constructor({ llmOption: e, mcpClients: t }) {
+    super({ llmOption: e, mcpClients: t });
+  }
+}
+const Ce = ({ llmOption: s, mcpClients: e }) => {
+  let t;
+  return s.llm === "deepseek" && (t = new se({ llmOption: s, mcpClients: e }), t.init()), t;
+}, Me = (s) => (e) => {
+  e.nextTransport ? e.nextTransport = new K(s.endpoint, s.globalObject) : e.nextTransport = new B(s.endpoint, s.globalObject), e.isMessageChannel = !0;
+}, oe = () => typeof window < "u", ne = (s, e) => {
+  const t = async () => {
+    e instanceof R ? await (e == null ? void 0 : e.terminateSession()) : e instanceof A && await (e == null ? void 0 : e.close()), s.close();
+  };
+  oe() && (window.addEventListener("beforeunload", t), window.addEventListener("pagehide", t));
+}, [ae, M] = J(), we = () => (s) => (s.nextTransport = M, M), ye = (s) => async (e) => {
+  let t = "", o = null;
+  if (s.type === "stream") {
+    const { sessionId: a, transport: r } = await V({
+      client: e,
+      ...s
+    });
+    t = a, o = r;
+  } else {
+    const { sessionId: a, transport: r } = await W({
+      client: e,
+      ...s
+    });
+    t = a, o = r;
+  }
+  return e.nextTransport = ae, ne(e, o), {
+    sessionId: t,
+    transport: o
+  };
+}, Re = (s) => (e) => {
+  const { type: t, url: o, token: a } = s;
+  let r = null;
+  t === "stream" ? r = new R(new URL(o), X(a)) : t === "sse" && (r = new A(new URL(o), z(a))), e.nextTransport = r;
+}, [re, ie] = G.createLinkedPair(), Ae = () => (s) => {
+  s instanceof L ? s.nextTransport = re : s.nextTransport = ie;
+};
+export {
+  L as NextClient,
+  ee as NextServer,
+  Re as connectMcpServer,
+  de as createClient,
+  ye as createClientProxy,
+  Ae as createInMemoryTransport,
+  Ce as createMCPHost,
+  Me as createMessageChannelTransport,
+  Se as createServer,
+  we as createServerProxy,
+  M as serverTransport
+};

package/dist/index.umd.js

@@ -0,0 +1,7 @@
+(function(n,l){typeof exports=="object"&&typeof module<"u"?l(exports,require("@modelcontextprotocol/sdk/client/index.js"),require("@modelcontextprotocol/sdk/types.js"),require("@modelcontextprotocol/sdk/server/mcp.js"),require("openai"),require("@opentiny/next"),require("@modelcontextprotocol/sdk/client/streamableHttp.js"),require("@modelcontextprotocol/sdk/client/sse.js"),require("@modelcontextprotocol/sdk/inMemory.js")):typeof define=="function"&&define.amd?define(["exports","@modelcontextprotocol/sdk/client/index.js","@modelcontextprotocol/sdk/types.js","@modelcontextprotocol/sdk/server/mcp.js","openai","@opentiny/next","@modelcontextprotocol/sdk/client/streamableHttp.js","@modelcontextprotocol/sdk/client/sse.js","@modelcontextprotocol/sdk/inMemory.js"],l):(n=typeof globalThis<"u"?globalThis:n||self,l(n.NextSDK={},n.index_js,n.types_js,n.mcp_js,n.OpenAI,n.next,n.streamableHttp_js,n.sse_js,n.inMemory_js))})(this,function(n,l,i,E,N,T,x,A,k){"use strict";var Z=Object.defineProperty;var _=(n,l,i)=>l in n?Z(n,l,{enumerable:!0,configurable:!0,writable:!0,value:i}):n[l]=i;var u=(n,l,i)=>_(n,typeof l!="symbol"?l+"":l,i);const L={toolListChanged:i.ToolListChangedNotificationSchema,resourceUpdated:i.ResourceUpdatedNotificationSchema,promptListChanged:i.PromptListChangedNotificationSchema,loggingMessage:i.LoggingMessageNotificationSchema},q={createMessage:i.CreateMessageRequestSchema,listRoots:i.ListRootsRequestSchema,elicit:i.ElicitRequestSchema};class y extends l.Client{constructor(e,s){super(e,s);u(this,"nextTransport",null);u(this,"isMessageChannel",!1)}use(e){return e(this)}on(e,s){e in L?this.setNotificationHandler(L[e],s):this.setRequestHandler(q[e],s)}async connectTransport(){return await this.connect(this.nextTransport)}}const P=(o,t)=>new y(o,t),b={subscribe:i.SubscribeRequestSchema,unsubscribe:i.UnsubscribeRequestSchema,listResources:i.ListResourcesRequestSchema,createMessage:i.CreateMessageRequestSchema,listRoots:i.ListRootsRequestSchema,setLevel:i.SetLevelRequestSchema,ping:i.PingRequestSchema};class v extends E.McpServer{constructor(e,s){super(e,s);u(this,"nextTransport");u(this,"isMessageChannel",!1)}use(e){return e(this)}async connectTransport(){var e,s;return this.isMessageChannel&&await((s=(e=this.nextTransport)==null?void 0:e.listen)==null?void 0:s.call(e)),await this.connect(this.nextTransport)}on(e,s){this.server.setRequestHandler(b[e],s)}}const O=(o,t)=>new v(o,t);var p=(o=>(o.FUNCTION="function",o.USER="user",o.ASSISTANT="assistant",o.DEVELOPER="developer",o.SYSTEM="system",o.TOOL="tool",o))(p||{});const I=3;class D{constructor({llmOption:t,mcpClients:e}){u(this,"llmOption");u(this,"mcpClients");u(this,"llm");u(this,"mcpClientMap",new Map);u(this,"messages",[]);u(this,"toolClientMap",new Map);u(this,"iteration",I);this.llmOption=t,this.mcpClients=e,this.messages.push({role:p.SYSTEM,content:"You are a helpful assistant with access to tools."})}async generateMcpClient(){for(let t=0;t<this.mcpClients.length;t++){const e=this.mcpClients[t],{tools:s}=await e.listTools();this.mcpClientMap.set(e,s),s.forEach(r=>{this.toolClientMap.set(r.name,e)})}}init(){this.llm=new N({baseURL:this.llmOption.url,apiKey:this.llmOption.apiKey,dangerouslyAllowBrowser:!0})}validateRequest(t){if(!t.messages||!Array.isArray(t.messages)||t.messages.length===0)throw new Error("请求必须包含至少一条消息");for(const e of t.messages)if(!e.role||!e.content)throw new Error("每条消息必须包含角色和内容")}async getMcpTools(){const t=[];for(const[,s]of this.mcpClientMap.entries())t.push(...s);return t.map(s=>({type:"function",function:{name:s.name,description:s.description,parameters:s.inputSchema}}))}async doLLMChart(){const t=await this.getMcpTools();return await this.llm.chat.completions.create({messages:this.messages,model:this.llmOption.model,tools:t,stream:!0})}async parseToolCalls(t,e){var g,h,S,a;const s=new Map;let r="",c="";for await(const M of t){const d=M.choices[0].delta,C=d==null?void 0:d.tool_calls,w=d==null?void 0:d.content;if(w&&(r+=w,e.onData({delta:{role:"assistant",content:w}})),C&&C.length>0){const m=C[0];if(m.id){c=m.id;const f={id:m.id,type:m.type,function:{name:((g=m.function)==null?void 0:g.name)||"",arguments:((h=m.function)==null?void 0:h.arguments)||""}};s.set(c,f),e.onData({delta:{role:p.ASSISTANT,content:`
+
+正在调用工具：${f.function.name}
+
+参数：`}})}if(s.has(c)){const f=s.get(c);f&&(f.function.arguments+=((S=m.function)==null?void 0:S.arguments)||"",e.onData({delta:{role:p.ASSISTANT,content:`${(a=m.function)==null?void 0:a.arguments}`}}))}}}return e.onData({delta:{role:"assistant",content:`
+
+`}}),[Array.from(s.values()),r]}async callTools(t,e){var s,r,c,g;try{const h=[],S=[];for(const a of t){const M=a.function.name,d=this.toolClientMap.get(M);if(!d)continue;let C={};try{C=typeof a.function.arguments=="string"?JSON.parse(a.function.arguments):a.function.arguments}catch(Q){console.error(`Failed to parse tool arguments for ${M}:`,Q),C={}}const w={id:a.id,type:a.type,function:{name:((s=a.function)==null?void 0:s.name)||"",arguments:((r=a.function)==null?void 0:r.arguments)||""}};e.onData({delta:{role:p.TOOL,toolCall:w}});const m=await d.callTool({name:M,arguments:C}),f=this.getToolCallMessage(m),z={role:p.TOOL,tool_call_id:a.id,content:f},G={id:a.id,type:a.type,callToolContent:f,function:{name:((c=a.function)==null?void 0:c.name)||"",arguments:((g=a.function)==null?void 0:g.arguments)||""}};e.onData({delta:{role:p.TOOL,toolCall:G}}),S.push(z),h.push({call:M,result:m})}return{toolResults:h,toolCallMessages:S}}catch(h){return console.error("Error calling tools:",h),{toolResults:[],toolCallMessages:[{role:p.ASSISTANT,content:"call tools failed!"}]}}}getToolCallMessage(t){var s;let e="";return(s=t.content)!=null&&s.length&&t.content.forEach(r=>{switch(r.type){case"text":e+=r.text;break;case"image":case"audio":case"resource":e+=r.data;break}}),e}async chatStream(t,e){return await this.generateMcpClient(),typeof t=="string"?this.messages.push({role:p.USER,content:t}):this.messages.push(t.messages[t.messages.length-1]),this.iteration=I,await this.processSteamToolCallsAndResponses(e).catch(s=>{console.error("Chat failed:",s)}),"ok"}async processSteamToolCallsAndResponses(t){try{const e=[];for(;this.iteration>0;){const s=await this.doLLMChart(),[r,c]=await this.parseToolCalls(s,t);if(r.length){const g={role:p.ASSISTANT,content:`调用工具:${r.map(a=>a.function.name).join(",")}`,tool_calls:r.map(a=>({id:a.id,type:a.type,function:a.function}))};this.messages.push(g);const{toolResults:h,toolCallMessages:S}=await this.callTools(r,t);e.push(...h),S.forEach(a=>this.messages.push(a)),this.iteration--}else this.messages.push({role:p.ASSISTANT,content:c}),this.iteration=0}t.onDone()}catch(e){throw console.error("Chat iteration failed:",e),e}}}class H extends D{constructor({llmOption:t,mcpClients:e}){super({llmOption:t,mcpClients:e})}}const U=({llmOption:o,mcpClients:t})=>{let e;return o.llm==="deepseek"&&(e=new H({llmOption:o,mcpClients:t}),e.init()),e},j=o=>t=>{t.nextTransport?t.nextTransport=new T.MessageChannelClientTransport(o.endpoint,o.globalObject):t.nextTransport=new T.MessageChannelServerTransport(o.endpoint,o.globalObject),t.isMessageChannel=!0},$=()=>typeof window<"u",K=(o,t)=>{const e=async()=>{t instanceof x.StreamableHTTPClientTransport?await(t==null?void 0:t.terminateSession()):t instanceof A.SSEClientTransport&&await(t==null?void 0:t.close()),o.close()};$()&&(window.addEventListener("beforeunload",e),window.addEventListener("pagehide",e))},[Y,R]=T.createTransportPair(),F=()=>o=>(o.nextTransport=R,R),B=o=>async t=>{let e="",s=null;if(o.type==="stream"){const{sessionId:r,transport:c}=await T.createStreamProxy({client:t,...o});e=r,s=c}else{const{sessionId:r,transport:c}=await T.createSseProxy({client:t,...o});e=r,s=c}return t.nextTransport=Y,K(t,s),{sessionId:e,transport:s}},J=o=>t=>{const{type:e,url:s,token:r}=o;let c=null;e==="stream"?c=new x.StreamableHTTPClientTransport(new URL(s),T.streamOptions(r)):e==="sse"&&(c=new A.SSEClientTransport(new URL(s),T.sseOptions(r))),t.nextTransport=c},[V,W]=k.InMemoryTransport.createLinkedPair(),X=()=>o=>{o instanceof y?o.nextTransport=V:o.nextTransport=W};n.NextClient=y,n.NextServer=v,n.connectMcpServer=J,n.createClient=P,n.createClientProxy=B,n.createInMemoryTransport=X,n.createMCPHost=U,n.createMessageChannelTransport=j,n.createServer=O,n.createServerProxy=F,n.serverTransport=R,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})});

package/dist/mcp-host/core/index.d.ts

@@ -0,0 +1,57 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { ChatCompleteResponse, ToolCall, ToolResults, Message, ChatCompleteRequest, StreamHandler } from '../../type';
+export declare class MCPHost {
+    protected llmOption: any;
+    protected mcpClients: Client[];
+    protected llm: any;
+    protected mcpClientMap: Map<Client, any>;
+    messages: any[];
+    protected toolClientMap: Map<string, Client>;
+    protected iteration: number;
+    constructor({ llmOption, mcpClients }: {
+        llmOption: any;
+        mcpClients: Client[];
+    });
+    generateMcpClient(): Promise<void>;
+    init(): void;
+    protected validateRequest(request: ChatCompleteRequest): void;
+    getMcpTools(): Promise<{
+        type: string;
+        function: {
+            name: any;
+            description: any;
+            parameters: any;
+        };
+    }[]>;
+    doLLMChart(): Promise<any>;
+    /**
+     * 解析 LLM 回复，提取工具调用和最终回复内容
+     * @param response LLM 回复对象
+     * @returns [工具调用数组, 回复内容]
+     */
+    protected parseToolCalls(response: ChatCompleteResponse, handler: StreamHandler): Promise<[ToolCall[], string]>;
+    /**
+     * 执行工具调用
+     * @param toolCalls 工具调用请求列表
+     * @returns 工具调用结果和消息
+     */
+    protected callTools(toolCalls: ToolCall[], handler: StreamHandler): Promise<{
+        toolResults: ToolResults;
+        toolCallMessages: Message[];
+    }>;
+    /**
+     * 解析工具调用结果，拼接为字符串
+     * @param toolCallResult 工具调用结果
+     * @returns 拼接后的字符串
+     */
+    protected getToolCallMessage(toolCallResult: CallToolResult): string;
+    chatStream(message: string | {
+        messages: Message[];
+        options: any;
+    }, handler: StreamHandler): Promise<string>;
+    /**
+     * 聊天迭代主流程，支持多轮工具调用和最终回复
+     */
+    protected processSteamToolCallsAndResponses(handler: StreamHandler): Promise<void>;
+}

package/dist/mcp-host/deepseek/index.d.ts

@@ -0,0 +1,7 @@
+import { MCPHost } from '../core';
+export declare class DeepSeekMcpHost extends MCPHost {
+    constructor({ llmOption, mcpClients }: {
+        llmOption: any;
+        mcpClients: any;
+    });
+}

package/dist/mcp-host/index.d.ts

@@ -0,0 +1,4 @@
+export declare const createMCPHost: ({ llmOption, mcpClients }: {
+    llmOption: any;
+    mcpClients: any;
+}) => any;

package/dist/plugins/connectMcpServer.d.ts

@@ -0,0 +1,3 @@
+import { McpServerInfo } from '../type';
+import { NextClient } from '../client/createClient';
+export declare const connectMcpServer: (options: McpServerInfo) => (nextClient: NextClient) => void;

package/dist/plugins/createInMemoryTransport.d.ts

@@ -0,0 +1,3 @@
+import { NextClient } from '../client/createClient';
+import { NextServer } from '../server/createServer';
+export declare const createInMemoryTransport: () => (nextClientOrServer: NextClient | NextServer) => void;

package/dist/plugins/createMessageChannelTransport.d.ts

@@ -0,0 +1,3 @@
+import { NextClient } from '../client/createClient';
+import { NextServer } from '../server/createServer';
+export declare const createMessageChannelTransport: (options: Record<string, any>) => (nextClientOrServer: NextClient | NextServer) => void;

package/dist/plugins/createProxy.d.ts

@@ -0,0 +1,10 @@
+import { NextClient } from '../client/createClient';
+import { INextClientProxyOption } from '../type';
+import { NextServer } from '../server/createServer';
+declare const serverTransport: import('@opentiny/next').MessageChannelTransport;
+export { serverTransport };
+export declare const createServerProxy: () => (nextServer: NextServer) => import('@opentiny/next').MessageChannelTransport;
+export declare const createClientProxy: (proxyOptions: INextClientProxyOption) => (nextClient: NextClient) => Promise<{
+    sessionId: string;
+    transport: any;
+}>;

package/dist/server/index.d.ts

@@ -0,0 +1 @@
+export * from './createServer';

package/dist/type.d.ts

@@ -0,0 +1,266 @@
+import { ClientProxyOption } from '@opentiny/next';
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+export interface McpServerInfo {
+    /**
+     * 代理类型
+     */
+    type: 'stream' | 'sse';
+    /**
+     * 代理服务器的 URL
+     */
+    url: string;
+    /**
+     * 代理服务器的身份验证令牌
+     */
+    token?: string;
+}
+export interface INextClientProxyOption extends Omit<ClientProxyOption, 'client'> {
+    /**
+     * 代理类型
+     */
+    type?: 'stream' | 'sse';
+}
+export interface McpServer {
+    url: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    customTransport: never;
+    type: 'sse' | 'stream';
+}
+export interface CustomTransportMcpServer<T = any> {
+    config: T;
+    customTransport: Transport | ((config: T) => Transport);
+}
+export type McpServers = Record<string, McpServer | CustomTransportMcpServer>;
+export interface McpServerConfig {
+    mcpServers: McpServers;
+}
+export type McpServersConfig = Record<string, McpServerConfig | any>;
+export declare enum AgentStrategy {
+    FUNCTION_CALLING = "Function Calling",// 函数调用策略
+    RE_ACT = "ReAct"
+}
+export interface MCPClientOptions {
+    agentStrategy?: AgentStrategy;
+    llmConfig: {
+        url: string;
+        apiKey: string;
+        model: string;
+        systemPrompt: string;
+        summarySystemPrompt?: string;
+    };
+    mcpServersConfig: McpServersConfig;
+    maxIterationSteps?: number;
+}
+export interface AvailableTool {
+    type: 'function';
+    function: {
+        name: string;
+        description?: string;
+        parameters: {
+            type: 'object';
+            properties?: Record<string, unknown>;
+            required?: string[];
+        };
+    };
+}
+export interface CallToolsParams {
+    toolCalls: ToolCall[];
+}
+export interface ChatBody {
+    stream?: boolean;
+    model: string;
+    messages: Message[];
+    tools?: AvailableTool[];
+}
+export type ToolResults = Array<{
+    call: string;
+    result: CallToolResult;
+}>;
+export declare enum Role {
+    FUNCTION = "function",// 函数角色
+    USER = "user",// 用户角色
+    ASSISTANT = "assistant",// 助手角色
+    DEVELOPER = "developer",// 开发者角色
+    SYSTEM = "system",// 系统角色
+    TOOL = "tool"
+}
+export type ErrorResponse = {
+    code: number;
+    message: string;
+    metadata?: Record<string, unknown>;
+};
+export type FunctionCall = {
+    name: string;
+    arguments: string;
+};
+export type ToolCall = {
+    id: string;
+    type: 'function';
+    function: FunctionCall;
+};
+export type NonChatChoice = {
+    finish_reason: string | null;
+    text: string;
+    error?: ErrorResponse;
+};
+export type NonStreamingChoice = {
+    finish_reason: string | null;
+    native_finish_reason: string | null;
+    message: {
+        content: string | null;
+        role: Role;
+        tool_calls?: ToolCall[];
+    };
+    error?: ErrorResponse;
+};
+export type StreamingChoice = {
+    finish_reason: string | null;
+    native_finish_reason: string | null;
+    delta: {
+        content: string | null;
+        role?: Role;
+        tool_calls?: ToolCall[];
+    };
+    error?: ErrorResponse;
+};
+export type ResponseUsage = {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+};
+export type ChatCompleteResponse = {
+    id: string;
+    choices: (NonStreamingChoice | StreamingChoice | NonChatChoice)[];
+    created: number;
+    model: string;
+    object: 'chat.completion' | 'chat.completion.chunk';
+    system_fingerprint?: string;
+    usage?: ResponseUsage;
+};
+export type TextContent = {
+    type: 'text';
+    text: string;
+};
+export type ImageContentPart = {
+    type: 'image_url';
+    image_url: {
+        url: string;
+        detail?: string;
+    };
+};
+export type ContentPart = TextContent | ImageContentPart;
+/**
+ * 消息角色类型
+ */
+export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+export type Message = {
+    role: MessageRole;
+    content: string | ContentPart[];
+    name?: string;
+    tool_call_id?: string;
+};
+export type FunctionDescription = {
+    description?: string;
+    name: string;
+    parameters: object;
+};
+export type Tool = {
+    type: 'function';
+    function: FunctionDescription;
+};
+export type ToolChoice = 'none' | 'auto' | {
+    type: 'function';
+    function: {
+        name: string;
+    };
+};
+export type ChatCompleteRequest = {
+    messages?: Message[];
+    prompt?: string;
+    model?: string;
+    response_format?: {
+        type: 'json_object';
+    };
+    stop?: string | string[];
+    stream?: boolean;
+    max_tokens?: number;
+    temperature?: number;
+    tools?: Tool[];
+    tool_choice?: ToolChoice;
+    seed?: number;
+    top_p?: number;
+    top_k?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    repetition_penalty?: number;
+    logit_bias?: Record<number, number>;
+    top_logprobs?: number;
+    min_p?: number;
+    top_a?: number;
+    prediction?: {
+        type: 'content';
+        content: string;
+    };
+    transforms?: string[];
+    models?: string[];
+    route?: 'fallback';
+};
+export interface IChatOptions {
+    toolCallResponse?: boolean;
+}
+export interface ChatCreatePromptArgs {
+    suffix?: string;
+    prefix?: string;
+    humanMessageTemplate?: string;
+    formatInstructions?: string;
+    inputVariables?: string[];
+}
+/**
+ * 流式聊天完成响应增量
+ */
+export interface ChatCompletionStreamResponseDelta {
+    content?: string;
+    role?: MessageRole;
+    toolCall?: ToolCall;
+}
+/**
+ * 流式聊天完成响应
+ */
+export interface ChatCompletionStreamResponse {
+    delta: ChatCompletionStreamResponseDelta;
+}
+/**
+ * 错误类型
+ */
+export declare enum ErrorType {
+    NETWORK_ERROR = "network_error",
+    AUTHENTICATION_ERROR = "authentication_error",
+    RATE_LIMIT_ERROR = "rate_limit_error",
+    SERVER_ERROR = "server_error",
+    MODEL_ERROR = "model_error",
+    TIMEOUT_ERROR = "timeout_error",
+    UNKNOWN_ERROR = "unknown_error"
+}
+/**
+ * AI适配器错误
+ */
+export interface AIAdapterError {
+    type: ErrorType;
+    message: string;
+    statusCode?: number;
+    originalError?: object;
+}
+/**
+ * 流式响应处理器
+ */
+export interface StreamHandler {
+    onData: (data: ChatCompletionStreamResponse) => void;
+    onError: (error: AIAdapterError) => void;
+    onMessage?: (msgObj: {
+        type: string;
+        [extra: string]: unknown;
+    }) => void;
+    onDone: () => void;
+}

package/dist/utils/dom.d.ts

@@ -0,0 +1,6 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
+import { MessageChannelClientTransport } from '@opentiny/next';
+export declare const isWindow: () => boolean;
+export declare const createCloseTransport: (client: Client, transport: StreamableHTTPClientTransport | SSEClientTransport | MessageChannelClientTransport | null) => void;

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+import { StreamHandler } from '../type';
+/**
+ * 处理SSE流式响应
+ * @param response fetch响应对象
+ * @param handler 流处理器
+ */
+export declare function handleSSEStream(response: Response, handler: StreamHandler, signal?: AbortSignal): Promise<void>;

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@opentiny/next-sdk",
+  "version": "0.0.1-alpha.1",
+  "description": "",
+  "module": "src/index.ts",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.15.1",
+    "@opentiny/next": "^0.2.1",
+    "openai": "^5.9.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "vite": "^6.3.5",
+    "vite-plugin-dts": "^4.5.4"
+  },
+  "scripts": {
+    "build": "vite build",
+    "prepare-readme": "cp ../../README.md ./README.md"
+  },
+  "main": "dist/index.mjs"
+}