@cicctencent/agent-core 0.1.1 → 0.1.3

package/src/llm/openai-provider.ts

@@ -1,200 +0,0 @@
-/**
- * @file OpenAI 兼容 LLM Provider
- * @description 使用原生 fetch 实现，支持任意 OpenAI 兼容端点（OpenAI / DeepSeek / Ollama / vLLM 等）
- */
-
-import type { LLMProvider, ModelConfig, ModelInfo, ChatParams, ChatResponse, ChatChunk } from './types.ts';
-import type { Message } from '../types.ts';
-
-export class OpenAIProvider implements LLMProvider {
-  protected config: Required<Pick<ModelConfig, 'provider' | 'model'>> & ModelConfig;
-
-  constructor(config: ModelConfig) {
-    this.config = {
-      ...config,
-      provider: config.provider || 'openai',
-      model: config.model || 'gpt-4',
-      baseUrl: config.baseUrl || 'https://api.openai.com/v1',
-      temperature: config.temperature ?? 0.7,
-      maxTokens: (typeof config.maxTokens === 'number' && config.maxTokens > 0) ? config.maxTokens : 4096,
-      timeout: config.timeout ?? 120000,
-    };
-  }
-
-  getModel(): ModelInfo {
-    return {
-      provider: this.config.provider,
-      model: this.config.model,
-      contextWindow: 128000,
-      supportsTools: true,
-      supportsStreaming: true,
-    };
-  }
-
-  async ping(): Promise<boolean> {
-    try {
-      const res = await this.doRequest({
-        model: this.config.model,
-        messages: [{ role: 'user', content: 'ping' }],
-        max_tokens: 5,
-      });
-      return res.ok;
-    } catch {
-      return false;
-    }
-  }
-
-  async chat(params: ChatParams): Promise<ChatResponse> {
-    const body = this.buildRequestBody(params, false);
-    const res = await this.doRequest(body, params.abortSignal);
-
-    if (!res.ok) {
-      const errText = await res.text().catch(() => 'Unknown error');
-      throw new Error(`LLM API error ${res.status}: ${errText}`);
-    }
-
-    const data = await res.json();
-    return {
-      choices: data.choices?.map((c: any) => ({
-        message: c.message as Message,
-        finish_reason: c.finish_reason || 'stop',
-      })) || [],
-      usage: data.usage
-        ? {
-            promptTokens: data.usage.prompt_tokens || 0,
-            completionTokens: data.usage.completion_tokens || 0,
-            totalTokens: data.usage.total_tokens || 0,
-          }
-        : undefined,
-    };
-  }
-
-  async *chatStream(params: ChatParams): AsyncGenerator<ChatChunk> {
-    const body = this.buildRequestBody(params, true);
-    const res = await this.doRequest(body, params.abortSignal);
-
-    if (!res.ok) {
-      const errText = await res.text().catch(() => 'Unknown error');
-      throw new Error(`LLM API error ${res.status}: ${errText}`);
-    }
-
-    const reader = res.body?.getReader();
-    if (!reader) throw new Error('No response body');
-
-    const decoder = new TextDecoder();
-    let buffer = '';
-
-    try {
-      while (true) {
-        const { done, value } = await reader.read();
-        if (done) break;
-
-        buffer += decoder.decode(value, { stream: true });
-        const lines = buffer.split('\n');
-        buffer = lines.pop() || '';
-
-        for (const line of lines) {
-          const trimmed = line.trim();
-          if (!trimmed || trimmed === 'data: [DONE]') continue;
-          if (!trimmed.startsWith('data: ')) continue;
-
-          try {
-            const json = JSON.parse(trimmed.slice(6));
-            const delta = json.choices?.[0]?.delta;
-            const finish = json.choices?.[0]?.finish_reason;
-
-            // 解析 usage（通常在最后一个 chunk 中，stream_options.include_usage=true）
-            if (json.usage) {
-              yield {
-                delta: {},
-                finish_reason: finish || undefined,
-                usage: {
-                  promptTokens: json.usage.prompt_tokens || 0,
-                  completionTokens: json.usage.completion_tokens || 0,
-                  totalTokens: json.usage.total_tokens || 0,
-                },
-              };
-              continue;
-            }
-
-            if (delta || finish) {
-              yield {
-                delta: {
-                  content: delta?.content || null,
-                  reasoning_content: delta?.reasoning_content || null,
-                  role: delta?.role,
-                  tool_calls: delta?.tool_calls,
-                },
-                finish_reason: finish || undefined,
-              };
-            }
-          } catch {
-            // skip malformed chunks
-          }
-        }
-      }
-    } finally {
-      reader.releaseLock();
-    }
-  }
-
-  /** 更新配置（如 API Key 变更后） */
-  updateConfig(updates: Partial<ModelConfig>): void {
-    Object.assign(this.config, updates);
-  }
-
-  // ---- 内部方法 ----
-
-  protected buildRequestBody(params: ChatParams, stream: boolean): Record<string, any> {
-    const body: Record<string, any> = {
-      model: this.config.model,
-      messages: params.messages,
-      temperature: params.temperature ?? this.config.temperature,
-      max_tokens: (typeof params.maxTokens === 'number' && params.maxTokens > 0)
-        ? params.maxTokens
-        : (typeof this.config.maxTokens === 'number' && this.config.maxTokens > 0)
-          ? this.config.maxTokens
-          : 4096,
-      stream,
-    };
-
-    if (params.tools?.length) {
-      body.tools = params.tools;
-      if (params.toolChoice) body.tool_choice = params.toolChoice;
-    }
-
-    if (stream) {
-      body.stream_options = { include_usage: true };
-    }
-
-    return body;
-  }
-
-  protected async doRequest(body: Record<string, any>, signal?: AbortSignal): Promise<Response> {
-    const url = `${this.config.baseUrl!.replace(/\/$/, '')}/chat/completions`;
-
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), this.config.timeout);
-
-    // 合并外部 signal
-    if (signal) {
-      if (signal.aborted) controller.abort();
-      else signal.addEventListener('abort', () => controller.abort(), { once: true });
-    }
-
-    try {
-      return await fetch(url, {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          ...(this.config.apiKey ? { Authorization: `Bearer ${this.config.apiKey}` } : {}),
-        },
-        body: JSON.stringify(body),
-        signal: controller.signal,
-        ...(this.config.proxy ? { dispatcher: this.config.proxy } : {}),
-      } as RequestInit);
-    } finally {
-      clearTimeout(timeout);
-    }
-  }
-}

package/src/llm/types.ts

@@ -1,91 +0,0 @@
-// ============================================================
-// LLM Provider 类型定义
-// ============================================================
-
-import type { Message, TokenUsage } from '../types.ts';
-import type { ToolDefinition } from '../tool/types.ts';
-import type { Dispatcher } from 'undici';
-
-// ---- ModelConfig — 模型配置 ----
-
-export interface ModelConfig {
-  /** 供应商标识：'openai' | 'anthropic' | 'azure' | 'ollama' | 自定义 */
-  provider: string;
-  /** 模型名称 */
-  model: string;
-  /** API Key */
-  apiKey?: string;
-  /** API Base URL（自定义端点） */
-  baseUrl?: string;
-  /** 温度参数，默认 0.7 */
-  temperature?: number;
-  /** 最大输出 token 数 */
-  maxTokens?: number;
-  /** 请求超时（毫秒） */
-  timeout?: number;
-  /** 供应商特定参数透传 */
-  extra?: Record<string, unknown>;
-  /** 网络代理 dispatcher（运行时注入，不持久化） */
-  proxy?: Dispatcher;
-}
-
-export interface ModelInfo {
-  provider: string;
-  model: string;
-  contextWindow: number;
-  supportsTools: boolean;
-  supportsStreaming: boolean;
-}
-
-// ---- ChatParams / ChatResponse ----
-
-/** LLM 推理请求参数 */
-export interface ChatParams {
-  messages: Message[];
-  /** 可用工具列表（OpenAI Function Calling 格式） */
-  tools?: ToolDefinition[];
-  /** 工具调用策略 */
-  toolChoice?: 'auto' | 'none' | { type: 'function'; function: { name: string } };
-  /** 覆盖 ModelConfig 中的 temperature */
-  temperature?: number;
-  /** 覆盖 ModelConfig 中的 maxTokens */
-  maxTokens?: number;
-  /** 中止信号 */
-  abortSignal?: AbortSignal;
-}
-
-/** LLM 推理响应 */
-export interface ChatResponse {
-  choices: Array<{
-    message: Message;
-    /** 结束原因：'stop' | 'tool_calls' | 'length' | 'content_filter' */
-    finish_reason: string;
-  }>;
-  usage?: TokenUsage;
-}
-
-/** 流式响应片段 */
-export interface ChatChunk {
-  /** 增量内容 */
-  delta: Partial<Message>;
-  finish_reason?: string;
-  /** Token 使用统计（仅最后一个 chunk 可能包含） */
-  usage?: TokenUsage;
-}
-
-// ---- LLMProvider 接口 ----
-
-/** LLM 供应商统一接口 */
-export interface LLMProvider {
-  /** 非流式推理 */
-  chat(params: ChatParams): Promise<ChatResponse>;
-
-  /** 流式推理（返回 AsyncGenerator 逐片段推送） */
-  chatStream(params: ChatParams): AsyncGenerator<ChatChunk>;
-
-  /** 获取当前模型信息 */
-  getModel(): ModelInfo;
-
-  /** 测试连接是否正常 */
-  ping(): Promise<boolean>;
-}

package/src/mcp/base-client.ts

@@ -1,159 +0,0 @@
-// ============================================================
-// MCPClientBase — JSON-RPC 2.0 基础层
-// ============================================================
-
-import type { MCPClient, MCPServerConfig } from './types.ts';
-import type { ToolDefinition } from '../tool/types.ts';
-
-/** JSON-RPC 请求 */
-interface JsonRpcRequest {
-  jsonrpc: '2.0';
-  id: number;
-  method: string;
-  params?: Record<string, unknown>;
-}
-
-/** JSON-RPC 响应 */
-interface JsonRpcResponse {
-  jsonrpc: '2.0';
-  id: number;
-  result?: unknown;
-  error?: { code: number; message: string; data?: unknown };
-}
-
-/**
- * MCPClient 抽象基类
- * 子类只需实现 send() 和 doConnect() / doDisconnect()
- */
-export abstract class MCPClientBase implements MCPClient {
-  protected config!: MCPServerConfig;
-  protected connected = false;
-  private requestId = 0;
-  /** 等待响应的 Promise 队列：id → { resolve, reject, timer } */
-  private pending = new Map<number, {
-    resolve: (v: unknown) => void;
-    reject: (e: Error) => void;
-    timer: ReturnType<typeof setTimeout>;
-  }>();
-
-  // ---- 抽象方法（子类实现） ----
-
-  /** 建立物理连接 */
-  protected abstract doConnect(config: MCPServerConfig): Promise<void>;
-
-  /** 断开物理连接 */
-  protected abstract doDisconnect(): void;
-
-  /** 发送 JSON-RPC 消息到 MCP 服务端 */
-  protected abstract send(request: JsonRpcRequest): void;
-
-  // ---- 公共接口 ----
-
-  async connect(config: MCPServerConfig): Promise<void> {
-    this.config = config;
-    await this.doConnect(config);
-    this.connected = true;
-
-    // MCP 协议握手
-    await this.call('initialize', {
-      protocolVersion: '2024-11-05',
-      capabilities: {},
-      clientInfo: { name: 'work_agent', version: '1.0.0' },
-    });
-    // 通知初始化完成
-    this.notify('notifications/initialized');
-  }
-
-  async listTools(): Promise<ToolDefinition[]> {
-    const result = await this.call('tools/list', {}) as { tools?: any[] };
-    if (!result?.tools) return [];
-
-    return result.tools.map((t: any) => ({
-      type: 'function' as const,
-      function: {
-        name: t.name,
-        description: t.description || '',
-        parameters: t.inputSchema || { type: 'object', properties: {} },
-      },
-    }));
-  }
-
-  async callTool(name: string, args: Record<string, unknown>): Promise<string> {
-    const result = await this.call('tools/call', { name, arguments: args }) as {
-      content?: Array<{ type: string; text?: string }>;
-      isError?: boolean;
-    };
-
-    if (result?.isError) {
-      const errMsg = result.content?.map(c => c.text || '').join('\n') || 'MCP tool returned error';
-      throw new Error(errMsg);
-    }
-
-    // 提取文本结果
-    return result?.content?.map(c => c.text || JSON.stringify(c)).join('\n') || '';
-  }
-
-  disconnect(): void {
-    // 拒绝所有等待中的请求
-    for (const [id, p] of this.pending) {
-      clearTimeout(p.timer);
-      p.reject(new Error('MCP client disconnected'));
-    }
-    this.pending.clear();
-    this.connected = false;
-    this.doDisconnect();
-  }
-
-  isConnected(): boolean {
-    return this.connected;
-  }
-
-  // ---- JSON-RPC 核心 ----
-
-  /** 发送 JSON-RPC 请求并等待响应 */
-  protected call(method: string, params?: Record<string, unknown>): Promise<unknown> {
-    const id = ++this.requestId;
-    const timeout = this.config.timeout || 30000;
-
-    return new Promise((resolve, reject) => {
-      const timer = setTimeout(() => {
-        this.pending.delete(id);
-        reject(new Error(`MCP call '${method}' timed out after ${timeout}ms`));
-      }, timeout);
-
-      this.pending.set(id, { resolve, reject, timer });
-
-      try {
-        this.send({ jsonrpc: '2.0', id, method, params });
-      } catch (e: any) {
-        clearTimeout(timer);
-        this.pending.delete(id);
-        reject(e);
-      }
-    });
-  }
-
-  /** 发送 JSON-RPC 通知（无 id，无响应） */
-  protected notify(method: string, params?: Record<string, unknown>): void {
-    try {
-      this.send({ jsonrpc: '2.0', id: 0, method, params });
-    } catch {
-      // 通知失败静默忽略
-    }
-  }
-
-  /** 子类收到 JSON-RPC 响应时调用此方法 */
-  protected handleResponse(data: JsonRpcResponse): void {
-    const pending = this.pending.get(data.id);
-    if (!pending) return;
-
-    this.pending.delete(data.id);
-    clearTimeout(pending.timer);
-
-    if (data.error) {
-      pending.reject(new Error(`MCP error ${data.error.code}: ${data.error.message}`));
-    } else {
-      pending.resolve(data.result);
-    }
-  }
-}

package/src/mcp/client.ts

@@ -1,81 +0,0 @@
-// ============================================================
-// MCP Client — 工具自动注册辅助函数
-// ============================================================
-
-import type { MCPClient } from './types.ts';
-import type { ToolRegistry } from '../tool/registry.ts';
-
-/** MCP 工具名前缀，用于与 builtin/skill 等工具区分 */
-export const MCP_TOOL_PREFIX = 'mcp_';
-
-/**
- * 将名称中的非安全字符替换为下划线，确保可安全用于工具名拼接
- */
-export function sanitizeForToolName(name: string): string {
-  return name
-    .replace(/[^a-zA-Z0-9_]/g, '_')  // 非安全字符 → _
-    .replace(/_+/g, '_')              // 合并连续下划线
-    .replace(/^_|_$/g, '');           // 去除首尾下划线
-}
-
-/**
- * 构建带命名空间的 MCP 工具名
- *
- * - 连接器工具：`mcp_{connectorId}_{serverName}_{toolName}`
- * - 独立工具：`mcp_{serverName}_{toolName}`
- *
- * 命名空间从根源上解决多 MCP 服务器工具名冲突问题。
- */
-export function buildMCPToolName(toolName: string, serverName: string, connectorId?: string): string {
-  const safeTool = sanitizeForToolName(toolName);
-  const safeServer = sanitizeForToolName(serverName);
-  if (connectorId) {
-    const safeConn = sanitizeForToolName(connectorId);
-    return `${MCP_TOOL_PREFIX}${safeConn}_${safeServer}_${safeTool}`;
-  }
-  return `${MCP_TOOL_PREFIX}${safeServer}_${safeTool}`;
-}
-
-/**
- * 将 MCP 服务的远程工具批量注册到 ToolRegistry
- *
- * 工具名自动添加命名空间前缀 `mcp_[{connectorId}_]{serverName}_{toolName}`，
- * 避免多 MCP 服务器间工具名冲突。调用 MCP 服务时使用原始名字。
- *
- * @param connectorId 连接器 ID（公有 MCP 服务器传 undefined，连接器私有传连接器 ID）
- */
-export async function registerMCPTools(
-  registry: ToolRegistry,
-  mcpClient: MCPClient,
-  serverName: string,
-  connectorId?: string,
-  serverId?: number | string,
-): Promise<void> {
-  const remoteTools = await mcpClient.listTools();
-  console.log(`[MCP] registerMCPTools for '${serverName}' (connector=${connectorId || 'none'}): ${remoteTools.length} tools — ${remoteTools.map(t => t.function.name).join(', ')}`);
-  for (const def of remoteTools) {
-    const originalName = def.function.name;
-    const prefixedName = buildMCPToolName(originalName, serverName, connectorId);
-    registry.register({
-      definition: {
-        ...def,
-        function: { ...def.function, name: prefixedName },
-      },
-      executor: async (args) => {
-        console.log(`[MCP] executor '${prefixedName}' called (server=${serverName})`);
-        console.log(`  → args: ${JSON.stringify(args)}`);
-        try {
-          const result = await mcpClient.callTool(originalName, args);
-          console.log(`  ← result (${result.length} chars): ${result.substring(0, 200)}${result.length > 200 ? '...' : ''}`);
-          return result;
-        } catch (e: any) {
-          console.error(`  ✗ executor '${prefixedName}' failed: ${e?.message || e}`);
-          throw e;
-        }
-      },
-      category: 'mcp',
-      concurrent: true,  // MCP 工具默认可并发（纯网络请求）
-      metadata: { mcpServer: serverName, serverId, originalName, connectorId },
-    });
-  }
-}

package/src/mcp/factory.ts

@@ -1,45 +0,0 @@
-// ============================================================
-// MCPClient Factory — 根据 transport 类型创建对应 Client
-// 支持上层应用通过 registerTransport 注册自定义 transport
-// ============================================================
-
-import type { MCPClient, MCPServerConfig } from './types.ts';
-import { StdioMCPClient } from './stdio-client.ts';
-import { HttpMCPClient } from './http-client.ts';
-
-/** 自定义 transport 工厂函数签名 */
-export type TransportFactory = () => MCPClient;
-
-/** 已注册的自定义 transport 工厂映射 */
-const customTransports = new Map<string, TransportFactory>();
-
-/**
- * 注册自定义 transport 工厂
- * 上层应用通过此方法扩展 core 层不内置的 transport 类型（如 api-bridge）
- */
-export function registerTransport(transport: string, factory: TransportFactory): void {
-  customTransports.set(transport, factory);
-  console.log(`[MCP Factory] registered custom transport: ${transport}`);
-}
-
-/**
- * 根据 MCPServerConfig.transport 创建对应的 MCPClient 实例
- *
- * 内置支持：stdio / http / sse
- * 自定义 transport：通过 registerTransport 注册后支持
- */
-export function createMCPClient(config: MCPServerConfig): MCPClient {
-  switch (config.transport) {
-    case 'stdio':
-      return new StdioMCPClient();
-    case 'http':
-    case 'sse':
-    case 'streamableHttp':
-      return new HttpMCPClient();
-    default: {
-      const factory = customTransports.get(config.transport);
-      if (factory) return factory();
-      throw new Error(`Unsupported MCP transport: ${config.transport}`);
-    }
-  }
-}