@amical/aiagent-sdk 0.1.0 → 0.1.2

package/src/llm/NodeApiHandler.ts

@@ -1,117 +0,0 @@
-import { IApiHandler, ApiStreamChunk, ApiProviderInfo } from './index';
-import { AgentMessage } from '../memory/index';
-import { streamText, ModelMessage } from 'ai';
-import { createOpenAI } from '@ai-sdk/openai';
-import { createDifyProvider } from 'dify-ai-provider';
-
-export interface NodeApiHandlerConfig {
-  providerId?: string; // 标识，例如 'openai', 'deepseek', 'dify'
-  modelId?: string;
-  apiKey: string;
-  baseURL?: string;
-  headers?: Record<string, string>;
-  fetch?: typeof fetch; // 允许注入自定义的 fetch 拦截器
-}
-
-/**
- * Node 端的 LLM API 处理器 (已通过 Vercel AI SDK 重构)
- * 支持灵活对接 OpenAI 及各类兼容 OpenAI 规范的平台 (DeepSeek, Dify 等)
- */
-export class NodeApiHandler implements IApiHandler {
-  private config: NodeApiHandlerConfig;
-  private conversationId?: string;
-
-  constructor(config: NodeApiHandlerConfig) {
-    this.config = config;
-  }
-
-  getModelInfo(): ApiProviderInfo {
-    return {
-      providerId: this.config.providerId || 'openai-compatible',
-      modelId: this.config.modelId,
-    };
-  }
-
-  async *createMessage(systemPrompt: string, messages: AgentMessage[]): AsyncGenerator<ApiStreamChunk, void, unknown> {
-    let model;
-
-    if (this.config.providerId === 'dify') {
-      const customDify = createDifyProvider({
-        baseURL: this.config.baseURL,
-        headers: this.config.headers,
-        fetch: this.config.fetch,
-      });
-      model = customDify(this.config.modelId || '', {
-        apiKey: this.config.apiKey,
-        responseMode: 'streaming',
-      });
-    } else {
-      const customOpenAI = createOpenAI({
-        baseURL: this.config.baseURL,
-        apiKey: this.config.apiKey,
-        headers: this.config.headers,
-        fetch: this.config.fetch,
-      });
-      model = customOpenAI(this.config.modelId || '');
-    }
-
-    try {
-      const streamOptions: any = {
-        model,
-        headers: {
-          ...this.config.headers,
-        },
-        allowSystemInMessages: true,
-      };
-
-      if (this.config.providerId === 'dify' && this.conversationId) {
-        // Dify 自带记忆系统，使用 prompt 模式
-        // 如果是第一次对话（messages 为空或只有一个 system 消息），需要带上 systemPrompt + 用户的需求
-        // 如果不是第一次，则只传递当前最新的用户输入，Dify 会自动处理历史记录
-        streamOptions.headers['chat-id'] = this.conversationId; // Dify 的 conversationId
-      }
-
-      streamOptions.messages = [
-        { role: 'system', content: systemPrompt },
-        ...(messages.map((m) => ({
-          role: m.role === 'system' ? 'system' : m.role === 'user' ? 'user' : 'assistant',
-          content: m.content
-        })) as ModelMessage[]),
-      ];
-
-      // console.log('streamOptions.messages====', streamOptions.messages);
-
-      const { fullStream } = streamText(streamOptions);
-
-      for await (const part of fullStream) {
-        if ((this.config.providerId === 'dify' && !this.conversationId && (part as any)?.providerMetadata?.difyWorkflowData?.conversationId) || (part as any)?.providerMetadata?.dify?.conversationId) {
-          this.conversationId = (part as any).providerMetadata?.difyWorkflowData?.conversationId || (part as any).providerMetadata?.dify?.conversationId;
-        }
-        if (part.type === 'text-delta') {
-          yield {
-            type: 'text',
-            text: (part as any).textDelta || part.text || '',
-          };
-        } else if (part.type === 'finish') {
-          yield {
-            type: 'usage',
-            usage: {
-              inputTokens: (part as any).usage?.promptTokens || (part as any).totalUsage?.promptTokens || (part as any).totalUsage?.inputTokens || 0,
-              outputTokens: (part as any).usage?.completionTokens || (part as any).totalUsage?.completionTokens || (part as any).totalUsage?.outputTokens || 0,
-            },
-          };
-        } else if (part.type === 'error') {
-          yield {
-            type: 'error',
-            error: part.error as Error,
-          };
-        }
-      }
-    } catch (err: any) {
-      yield {
-        type: 'error',
-        error: err,
-      };
-    }
-  }
-}

package/src/llm/WebApiHandler.ts

@@ -1,118 +0,0 @@
-import { IApiHandler, ApiStreamChunk, ApiProviderInfo } from './index';
-import { AgentMessage } from '../memory/index';
-import { streamText, ModelMessage } from 'ai';
-import { createOpenAI } from '@ai-sdk/openai';
-import { createDifyProvider } from 'dify-ai-provider';
-
-export interface WebApiHandlerConfig {
-  providerId?: string; // 标识，例如 'openai', 'deepseek', 'dify'
-  modelId?: string;
-  apiKey: string;
-  baseURL?: string;
-  headers?: Record<string, string>;
-  fetch?: typeof fetch; // 允许注入自定义的 fetch 拦截器
-}
-
-/**
- * Web 端的 LLM API 处理器 (已通过 Vercel AI SDK 重构)
- * 支持灵活对接 OpenAI 及各类兼容 OpenAI 规范的平台 (DeepSeek, Dify 等)
- * 由于 Vercel AI SDK 底层统一使用标准的 Web Fetch API，Web 端的逻辑可以做到与 Node 端完全一致。
- */
-export class WebApiHandler implements IApiHandler {
-  private config: WebApiHandlerConfig;
-  private conversationId?: string;
-
-  constructor(config: WebApiHandlerConfig) {
-    this.config = config;
-  }
-
-  getModelInfo(): ApiProviderInfo {
-    return {
-      providerId: this.config.providerId || 'openai-compatible',
-      modelId: this.config.modelId,
-    };
-  }
-
-  async *createMessage(systemPrompt: string, messages: AgentMessage[]): AsyncGenerator<ApiStreamChunk, void, unknown> {
-    let model;
-
-    if (this.config.providerId === 'dify') {
-      const customDify = createDifyProvider({
-        baseURL: this.config.baseURL,
-        headers: this.config.headers,
-        fetch: this.config.fetch,
-      });
-      model = customDify(this.config.modelId || '', {
-        apiKey: this.config.apiKey,
-        responseMode: 'streaming',
-      });
-    } else {
-      const customOpenAI = createOpenAI({
-        baseURL: this.config.baseURL,
-        apiKey: this.config.apiKey,
-        headers: this.config.headers,
-        fetch: this.config.fetch,
-      });
-      model = customOpenAI(this.config.modelId || '');
-    }
-
-    try {
-      const streamOptions: any = {
-        model,
-        headers: {
-          ...this.config.headers,
-        },
-        allowSystemInMessages: true,
-      };
-
-      if (this.config.providerId === 'dify' && this.conversationId) {
-        // Dify 自带记忆系统，使用 prompt 模式
-        // 如果是第一次对话（messages 为空或只有一个 system 消息），需要带上 systemPrompt + 用户的需求
-        // 如果不是第一次，则只传递当前最新的用户输入，Dify 会自动处理历史记录
-        streamOptions.headers['chat-id'] = this.conversationId; // Dify 的 conversationId
-      }
-
-      streamOptions.messages = [
-        { role: 'system', content: systemPrompt },
-        ...(messages.map((m) => ({
-          role: m.role === 'system' ? 'system' : m.role === 'user' ? 'user' : 'assistant',
-          content: m.content,
-        })) as ModelMessage[]),
-      ];
-
-      // console.log('streamOptions.messages====', streamOptions.messages);
-
-      const { fullStream } = streamText(streamOptions);
-
-      for await (const part of fullStream) {
-        if ((this.config.providerId === 'dify' && !this.conversationId && (part as any)?.providerMetadata?.difyWorkflowData?.conversationId) || (part as any)?.providerMetadata?.dify?.conversationId) {
-          this.conversationId = (part as any).providerMetadata?.difyWorkflowData?.conversationId || (part as any).providerMetadata?.dify?.conversationId;
-        }
-        if (part.type === 'text-delta') {
-          yield {
-            type: 'text',
-            text: (part as any).textDelta || part.text || '',
-          };
-        } else if (part.type === 'finish') {
-          yield {
-            type: 'usage',
-            usage: {
-              inputTokens: (part as any).usage?.promptTokens || (part as any).totalUsage?.promptTokens || (part as any).totalUsage?.inputTokens || 0,
-              outputTokens: (part as any).usage?.completionTokens || (part as any).totalUsage?.completionTokens || (part as any).totalUsage?.outputTokens || 0,
-            },
-          };
-        } else if (part.type === 'error') {
-          yield {
-            type: 'error',
-            error: part.error as Error,
-          };
-        }
-      }
-    } catch (err: any) {
-      yield {
-        type: 'error',
-        error: err,
-      };
-    }
-  }
-}

package/src/llm/index.ts

@@ -1,47 +0,0 @@
-import { AgentMessage } from "../memory/index";
-
-/**
- * 统一的 API 响应流数据块
- */
-export interface ApiStreamChunk {
-  type: "text" | "usage" | "error";
-  text?: string;
-  usage?: {
-    inputTokens: number;
-    outputTokens: number;
-  };
-  error?: Error;
-}
-
-/**
- * 通用的 LLM 提供者信息
- */
-export interface ApiProviderInfo {
-  providerId: string;
-  modelId?: string;
-}
-
-/**
- * 抽象的 LLM API 处理器接口。
- * 宿主环境（VSCode/Web/Node CLI）可以选择注入 AnthropicSDK、OpenAISDK 或是 Fetch 调用实现。
- */
-export interface IApiHandler {
-  /**
-   * 发起一次到大模型的请求，返回一个可异步迭代的流。
-   */
-  createMessage(
-    systemPrompt: string,
-    messages: AgentMessage[]
-  ): AsyncGenerator<ApiStreamChunk, void, unknown>;
-
-  /**
-   * 获取当前配置的模型信息
-   */
-  getModelInfo(): ApiProviderInfo;
-}
-
-/**
- * 生成大模型 API 处理器的工厂接口
- */
-export * from "./NodeApiHandler";
-export * from "./WebApiHandler";

package/src/mcp/NodeMcpManager.ts

@@ -1,158 +0,0 @@
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
-import { IMcpManager, McpServerInfo, McpTool, McpToolCallResult } from "./index";
-
-export interface StdioServerConfig {
-  command: string;
-  args?: string[];
-  env?: Record<string, string>;
-}
-
-export interface NodeMcpManagerConfig {
-  servers: Record<string, StdioServerConfig>;
-}
-
-export class NodeMcpManager implements IMcpManager {
-  private config: NodeMcpManagerConfig;
-  private clients: Map<string, Client> = new Map();
-  private transports: Map<string, StdioClientTransport> = new Map();
-  private serverStatuses: Map<string, McpServerInfo> = new Map();
-
-  constructor(config: NodeMcpManagerConfig) {
-    this.config = config;
-  }
-
-  /**
-   * 初始化并连接所有的 MCP Servers
-   */
-  public async init(): Promise<void> {
-    const connectPromises = Object.entries(this.config.servers).map(async ([name, serverConfig]) => {
-      this.serverStatuses.set(name, { name, status: "connecting" });
-
-      try {
-        const transport = new StdioClientTransport({
-          command: serverConfig.command,
-          args: serverConfig.args,
-          env: { ...process.env, ...serverConfig.env } as Record<string, string>,
-        });
-
-        const client = new Client(
-          {
-            name: "cline-agent-sdk",
-            version: "0.1.0",
-          },
-          {
-            capabilities: {},
-          }
-        );
-
-        await client.connect(transport);
-
-        this.clients.set(name, client);
-        this.transports.set(name, transport);
-        this.serverStatuses.set(name, { name, status: "connected" });
-      } catch (err: any) {
-        this.serverStatuses.set(name, { name, status: "disconnected", error: err.message });
-      }
-    });
-
-    await Promise.all(connectPromises);
-  }
-
-  public getServers(): McpServerInfo[] {
-    return Array.from(this.serverStatuses.values());
-  }
-
-  public async getTools(): Promise<McpTool[]> {
-    const allTools: McpTool[] = [];
-
-    for (const [serverName, client] of this.clients.entries()) {
-      try {
-        const response = await client.listTools();
-        if (response && response.tools) {
-          for (const tool of response.tools) {
-            allTools.push({
-              name: `${serverName}__${tool.name}`,
-              description: tool.description,
-              inputSchema: tool.inputSchema,
-            });
-          }
-        }
-      } catch (err: any) {
-        console.error(`Failed to get tools from MCP server [${serverName}]: ${err.message}`);
-      }
-    }
-
-    return allTools;
-  }
-
-  public async callTool(serverName: string, toolName: string, args: any): Promise<McpToolCallResult> {
-    const client = this.clients.get(serverName);
-    if (!client) {
-      return {
-        content: [{ type: "text", text: `MCP Server [${serverName}] is not connected.` }],
-        isError: true,
-      };
-    }
-
-    // 如果 Agent 传回来的 toolName 包含了 serverName__ 前缀，自动剥离它
-    const prefix = `${serverName}__`;
-    const actualToolName = toolName.startsWith(prefix) ? toolName.slice(prefix.length) : toolName;
-
-    try {
-      const response = await client.callTool({
-        name: actualToolName,
-        arguments: args,
-      });
-
-      return {
-        content: response.content as any,
-        isError: !!response.isError,
-      };
-    } catch (err: any) {
-      return {
-        content: [{ type: "text", text: `Error calling tool ${toolName} on server ${serverName}: ${err.message}` }],
-        isError: true,
-      };
-    }
-  }
-
-  public async readResource(serverName: string, uri: string): Promise<any> {
-    const client = this.clients.get(serverName);
-    if (!client) {
-      throw new Error(`MCP Server [${serverName}] is not connected.`);
-    }
-
-    try {
-      const response = await client.readResource({ uri });
-      return response.contents;
-    } catch (err: any) {
-      throw new Error(`Error reading resource ${uri} from server ${serverName}: ${err.message}`);
-    }
-  }
-
-  /**
-   * 断开并清理所有的 MCP Servers
-   */
-  public async destroy(): Promise<void> {
-    for (const [name, client] of this.clients.entries()) {
-      try {
-        await client.close();
-      } catch (e) {
-        // ignore
-      }
-    }
-    
-    for (const [name, transport] of this.transports.entries()) {
-      try {
-        await transport.close();
-      } catch (e) {
-        // ignore
-      }
-    }
-
-    this.clients.clear();
-    this.transports.clear();
-    this.serverStatuses.clear();
-  }
-}

package/src/mcp/WebMcpManager.ts

@@ -1,30 +0,0 @@
-import { IMcpManager, McpServerInfo, McpTool, McpToolCallResult } from "./index";
-
-export class WebMcpManager implements IMcpManager {
-  constructor() {
-    // 浏览器环境中，直接使用官方的 StdioClientTransport 不可行（依赖 Node 的 child_process），
-    // 尽管有 SSEClientTransport，但其内部依赖了 Node 端的 eventsource 等包。
-    // 在纯 Web 环境下，通常需要通过 WebSocket 或 SSE 桥接到后端的代理服务。
-    // 因此这里暂时作为一个空实现，留待后续结合具体的 Web Backend 代理来完善。
-    console.warn("WebMcpManager is initialized as an empty stub. MCP relies on Node.js processes or a proxy backend.");
-  }
-
-  public getServers(): McpServerInfo[] {
-    return [];
-  }
-
-  public async getTools(): Promise<McpTool[]> {
-    return [];
-  }
-
-  public async callTool(serverName: string, toolName: string, args: any): Promise<McpToolCallResult> {
-    return {
-      content: [{ type: "text", text: `MCP is not supported in the pure Web environment.` }],
-      isError: true,
-    };
-  }
-
-  public async readResource(serverName: string, uri: string): Promise<any> {
-    throw new Error("MCP readResource is not supported in the pure Web environment.");
-  }
-}

package/src/mcp/index.ts

@@ -1,56 +0,0 @@
-/**
- * MCP Server 描述信息
- */
-export interface McpServerInfo {
-  name: string;
-  status: "connected" | "disconnected" | "connecting";
-  error?: string;
-}
-
-/**
- * MCP 工具定义
- */
-export interface McpTool {
-  name: string;
-  description?: string;
-  inputSchema: any; // JSON Schema
-}
-
-/**
- * MCP 工具调用结果
- */
-export interface McpToolCallResult {
-  content: Array<{ type: string; text?: string; data?: any }>;
-  isError?: boolean;
-}
-
-/**
- * 抽象的 MCP 管理器接口。
- * 宿主环境（VSCode/Node）使用基于 StdIO 的 MCP SDK 实现，Web 环境可能使用 SSE 或其他代理机制实现。
- * 通过注入 IMcpManager，Agent 可以无缝使用 MCP 提供的拓展工具。
- */
-export interface IMcpManager {
-  /**
-   * 获取所有连接的 MCP 服务器状态
-   */
-  getServers(): McpServerInfo[];
-
-  /**
-   * 获取所有可用的 MCP 工具
-   */
-  getTools(): Promise<McpTool[]>;
-
-  /**
-   * 调用特定的 MCP 工具
-   * @param serverName 提供该工具的服务器名称
-   * @param toolName 工具名称
-   * @param args 工具参数
-   */
-  callTool(serverName: string, toolName: string, args: any): Promise<McpToolCallResult>;
-
-  /**
-   * 读取 MCP 资源
-   */
-  readResource?(serverName: string, uri: string): Promise<any>;
-}
-

package/src/memory/NodeMemoryManager.ts

@@ -1,82 +0,0 @@
-import { IMemoryManager, AgentMessage } from "./index";
-import * as fs from "fs/promises";
-import * as path from "path";
-
-/**
- * Node 端 MemoryManager 实现
- * 将对话历史持久化到本地文件系统（JSON 格式）。
- */
-export class NodeMemoryManager implements IMemoryManager {
-  private filePath: string;
-  private maxMessages: number;
-
-  /**
-   * @param dbPath 存储历史记录的本地文件路径（例如：'./.cline_memory.json'）
-   * @param maxMessages 保留的最大消息数量，用于简单的历史截断（默认 150）
-   */
-  constructor(dbPath: string, maxMessages: number = 150) {
-    this.filePath = path.resolve(dbPath);
-    this.maxMessages = maxMessages;
-  }
-
-  private async ensureFile(): Promise<void> {
-    try {
-      await fs.access(this.filePath);
-    } catch {
-      // 文件不存在则初始化为空数组
-      const dir = path.dirname(this.filePath);
-      await fs.mkdir(dir, { recursive: true });
-      await fs.writeFile(this.filePath, "[]", "utf-8");
-    }
-  }
-
-  private async readMessages(): Promise<AgentMessage[]> {
-    await this.ensureFile();
-    const data = await fs.readFile(this.filePath, "utf-8");
-    try {
-      return JSON.parse(data) as AgentMessage[];
-    } catch {
-      return [];
-    }
-  }
-
-  private async writeMessages(messages: AgentMessage[]): Promise<void> {
-    await this.ensureFile();
-    await fs.writeFile(this.filePath, JSON.stringify(messages, null, 2), "utf-8");
-  }
-
-  async getHistory(): Promise<AgentMessage[]> {
-    return this.readMessages();
-  }
-
-  async appendMessage(message: AgentMessage): Promise<void> {
-    const messages = await this.readMessages();
-    messages.push(message);
-    await this.writeMessages(messages);
-    await this.condenseHistory();
-  }
-
-  async condenseHistory(): Promise<void> {
-    const messages = await this.readMessages();
-    if (messages.length > this.maxMessages) {
-      // 简单截断：保留最早的系统消息（如果有）和最近的 N 条消息
-      const firstMessage = messages[0];
-      const isFirstSystem = firstMessage && firstMessage.role === "system";
-      
-      const sliceCount = messages.length - this.maxMessages;
-      let condensed: AgentMessage[];
-      
-      if (isFirstSystem) {
-        condensed = [firstMessage, ...messages.slice(sliceCount + 1)];
-      } else {
-        condensed = messages.slice(sliceCount);
-      }
-      
-      await this.writeMessages(condensed);
-    }
-  }
-
-  async clear(): Promise<void> {
-    await this.writeMessages([]);
-  }
-}

package/src/memory/WebMemoryManager.ts

@@ -1,89 +0,0 @@
-import { IMemoryManager, AgentMessage } from "./index";
-
-/**
- * Web 端 MemoryManager 实现
- * 使用 IndexedDB (通过封装) 或 LocalStorage / SessionStorage 来持久化对话历史。
- * 此处提供一个基于 SessionStorage / 内存 回退的轻量实现。
- */
-export class WebMemoryManager implements IMemoryManager {
-  private storageKey: string;
-  private maxMessages: number;
-  private inMemoryFallback: AgentMessage[] = [];
-
-  /**
-   * @param storageKey SessionStorage 中的键名
-   * @param maxMessages 保留的最大消息数量，用于简单的历史截断（默认 150）
-   */
-  constructor(storageKey: string = "cline_agent_memory", maxMessages: number = 150) {
-    this.storageKey = storageKey;
-    this.maxMessages = maxMessages;
-  }
-
-  private isStorageAvailable(): boolean {
-    try {
-      return typeof window !== "undefined" && typeof window.sessionStorage !== "undefined";
-    } catch {
-      return false;
-    }
-  }
-
-  private readMessages(): AgentMessage[] {
-    if (this.isStorageAvailable()) {
-      const data = window.sessionStorage.getItem(this.storageKey);
-      if (data) {
-        try {
-          return JSON.parse(data) as AgentMessage[];
-        } catch {
-          return [];
-        }
-      }
-      return [];
-    }
-    return this.inMemoryFallback;
-  }
-
-  private writeMessages(messages: AgentMessage[]): void {
-    if (this.isStorageAvailable()) {
-      window.sessionStorage.setItem(this.storageKey, JSON.stringify(messages));
-    } else {
-      this.inMemoryFallback = messages;
-    }
-  }
-
-  async getHistory(): Promise<AgentMessage[]> {
-    return Promise.resolve(this.readMessages());
-  }
-
-  async appendMessage(message: AgentMessage): Promise<void> {
-    const messages = this.readMessages();
-    messages.push(message);
-    this.writeMessages(messages);
-    await this.condenseHistory();
-  }
-
-  async condenseHistory(): Promise<void> {
-    const messages = this.readMessages();
-    if (messages.length > this.maxMessages) {
-      // 简单截断：保留最早的系统消息（如果有）和最近的 N 条消息
-      const firstMessage = messages[0];
-      const isFirstSystem = firstMessage && firstMessage.role === "system";
-      
-      const sliceCount = messages.length - this.maxMessages;
-      let condensed: AgentMessage[];
-      
-      if (isFirstSystem) {
-        condensed = [firstMessage, ...messages.slice(sliceCount + 1)];
-      } else {
-        condensed = messages.slice(sliceCount);
-      }
-      
-      this.writeMessages(condensed);
-    }
-    return Promise.resolve();
-  }
-
-  async clear(): Promise<void> {
-    this.writeMessages([]);
-    return Promise.resolve();
-  }
-}