@renxqoo/renx-code 0.0.3 → 0.0.5

package/vendor/agent-root/src/providers/registry/provider-factory.ts

@@ -0,0 +1,123 @@
+/**
+ * Provider 工厂
+ *
+ * 负责创建 Provider 实例，将创建逻辑从 Registry 中分离
+ */
+
+import { StandardAdapter } from '../adapters/standard';
+import { AnthropicAdapter } from '../adapters/anthropic';
+import { OpenAICompatibleProvider, OpenAICompatibleConfig } from '../openai-compatible';
+import type { BaseProviderConfig, ModelId } from '../types';
+import type { BaseAPIAdapter } from '../adapters/base';
+import { MODEL_DEFINITIONS } from './model-config';
+import { KimiAdapter } from '../adapters/kimi';
+import { ResponsesAdapter } from '../adapters/responses';
+
+/**
+ * Provider 工厂类
+ */
+export class ProviderFactory {
+  /**
+   * 从环境变量创建 Provider
+   *
+   * @param modelId 模型唯一标识
+   * @param overrides 可选的配置覆盖
+   * @returns OpenAI Compatible Provider 实例
+   */
+  static createFromEnv(
+    modelId: ModelId,
+    overrides?: Partial<OpenAICompatibleConfig>
+  ): OpenAICompatibleProvider {
+    if (!modelId) {
+      throw new Error('ModelId is required.');
+    }
+
+    const modelConfig = MODEL_DEFINITIONS[modelId];
+    if (!modelConfig) {
+      throw new Error(`Unknown model: ${modelId}`);
+    }
+
+    const apiKey = process.env[modelConfig.envApiKey] || '';
+    const baseURL = process.env[modelConfig.envBaseURL] || modelConfig.baseURL;
+
+    // Config overrides take precedence over env vars / model defaults
+    const finalConfig: OpenAICompatibleConfig = {
+      apiKey: overrides?.apiKey ?? apiKey,
+      baseURL: overrides?.baseURL ?? baseURL,
+      model: overrides?.model ?? modelConfig.model,
+      temperature: overrides?.temperature ?? modelConfig.temperature ?? 0.1,
+      max_tokens: overrides?.max_tokens ?? modelConfig.max_tokens,
+      LLMMAX_TOKENS: overrides?.LLMMAX_TOKENS ?? modelConfig.LLMMAX_TOKENS,
+      timeout: overrides?.timeout,
+      maxRetries: overrides?.maxRetries,
+      logger: overrides?.logger,
+      organization: overrides?.organization,
+      chatCompletionsPath: overrides?.chatCompletionsPath ?? modelConfig.endpointPath,
+      enableStreamUsage: overrides?.enableStreamUsage,
+      tool_stream: overrides?.tool_stream ?? modelConfig.tool_stream,
+      thinking: overrides?.thinking ?? modelConfig.thinking,
+      model_reasoning_effort:
+        overrides?.model_reasoning_effort ?? modelConfig.model_reasoning_effort,
+    };
+
+    const adapter = ProviderFactory.createAdapter(modelId, finalConfig.logger);
+
+    return new OpenAICompatibleProvider(finalConfig, adapter);
+  }
+
+  /**
+   * 创建指定类型的 Provider
+   *
+   * @param modelId 模型唯一标识
+   * @param config Provider 配置
+   * @returns OpenAI Compatible Provider 实例
+   */
+  static create(modelId: ModelId, config: BaseProviderConfig): OpenAICompatibleProvider {
+    const modelConfig = MODEL_DEFINITIONS[modelId];
+    if (!modelConfig) {
+      throw new Error(`Unknown model: ${modelId}`);
+    }
+
+    const adapter = ProviderFactory.createAdapter(modelId, config.logger);
+    return new OpenAICompatibleProvider(config as OpenAICompatibleConfig, adapter);
+  }
+
+  /**
+   * 创建适配器
+   *
+   * @param modelId 模型唯一标识
+   * @returns API 适配器实例
+   */
+  static createAdapter(
+    modelId: ModelId,
+    logger?: OpenAICompatibleConfig['logger']
+  ): BaseAPIAdapter {
+    const modelConfig = MODEL_DEFINITIONS[modelId];
+    if (modelConfig.provider === 'anthropic') {
+      return new AnthropicAdapter({
+        defaultModel: modelConfig.model,
+        endpointPath: modelConfig.endpointPath || '/v1/messages',
+        logger,
+      });
+    }
+
+    if (modelConfig.provider === 'kimi') {
+      return new KimiAdapter({
+        defaultModel: modelConfig.model,
+        endpointPath: modelConfig.endpointPath || '/chat/completions',
+      });
+    }
+
+    if (modelConfig.endpointPath === '/responses') {
+      return new ResponsesAdapter({
+        defaultModel: modelConfig.model,
+        endpointPath: modelConfig.endpointPath,
+      });
+    }
+
+    return new StandardAdapter({
+      defaultModel: modelConfig.model,
+      endpointPath: modelConfig.endpointPath || '/chat/completions',
+    });
+  }
+}

package/vendor/agent-root/src/providers/registry.ts

@@ -0,0 +1,135 @@
+/**
+ * Provider Registry
+ *
+ * 模型级别的 Provider 工厂和注册表
+ * 支持从环境变量创建 Provider，以具体模型为单位
+ */
+
+import { ProviderFactory } from './registry/provider-factory';
+import { MODEL_DEFINITIONS } from './registry/model-config';
+import type { ModelConfig, ModelId, ProviderType } from './types';
+
+// 导出类型
+export type { ProviderType, ModelId, ModelConfig } from './types';
+
+// 导出模型配置
+export { MODEL_DEFINITIONS as MODEL_CONFIGS } from './registry/model-config';
+
+/**
+ * Provider Registry 类
+ *
+ * 简化为只负责查询和委托创建
+ */
+export class ProviderRegistry {
+  /**
+   * 从环境变量创建 Provider（以模型为单位）
+   *
+   * @param modelId 模型唯一标识，如 'glm-4.7', 'minimax-2.1'
+   * @param config 可选的配置覆盖
+   *
+   * @example
+   * ```ts
+   * // 创建 GLM-4.7 实例
+   * const provider = ProviderRegistry.createFromEnv('glm-4.7');
+   *
+   * // 创建 MiniMax-2.1 实例，并覆盖温度
+   * const provider = ProviderRegistry.createFromEnv('minimax-2.1', { temperature: 0.5 });
+   * ```
+   */
+  static createFromEnv = ProviderFactory.createFromEnv;
+
+  /**
+   * 创建指定类型的 Provider
+   */
+  static create = ProviderFactory.create;
+
+  /**
+   * 获取所有模型配置
+   */
+  static listModels(): ModelConfig[] {
+    return Object.values(MODEL_DEFINITIONS).map((config) => ({
+      ...config,
+      apiKey: undefined,
+    }));
+  }
+
+  /**
+   * 获取指定厂商的所有模型
+   */
+  static listModelsByProvider(provider: ProviderType): ModelConfig[] {
+    return Object.values(MODEL_DEFINITIONS)
+      .filter((m) => m.provider === provider)
+      .map((config) => ({
+        ...config,
+        apiKey: undefined,
+      }));
+  }
+
+  /**
+   * 获取所有模型 ID
+   */
+  static getModelIds(): ModelId[] {
+    return Object.keys(MODEL_DEFINITIONS) as ModelId[];
+  }
+
+  /**
+   * 获取指定模型的配置
+   */
+  static getModelConfig(modelId: ModelId): ModelConfig {
+    const config = MODEL_DEFINITIONS[modelId];
+    if (!config) {
+      throw new Error(`Unknown model: ${modelId}`);
+    }
+    return { ...config, apiKey: undefined };
+  }
+
+  /**
+   * 获取模型显示名称
+   */
+  static getModelName(modelId: ModelId): string {
+    return MODEL_DEFINITIONS[modelId]?.name || modelId;
+  }
+
+  /**
+   * 获取所有支持的厂商类型
+   */
+  static getProviders(): ProviderType[] {
+    const providers = new Set<ProviderType>();
+    Object.values(MODEL_DEFINITIONS).forEach((m) => providers.add(m.provider));
+    return Array.from(providers);
+  }
+}
+
+// =============================================================================
+// 便捷的模型访问器
+// =============================================================================
+
+export const Models = {
+  // GLM
+  get glm47(): ModelConfig {
+    return { ...MODEL_DEFINITIONS['glm-4.7'], apiKey: undefined };
+  },
+  get glm5(): ModelConfig {
+    return { ...MODEL_DEFINITIONS['glm-5'], apiKey: undefined };
+  },
+
+  // MiniMax
+  get minimax25(): ModelConfig {
+    return { ...MODEL_DEFINITIONS['minimax-2.5'], apiKey: undefined };
+  },
+
+  // Kimi
+  get kimiK25(): ModelConfig {
+    return { ...MODEL_DEFINITIONS['kimi-k2.5'], apiKey: undefined };
+  },
+
+  // DeepSeek
+  get deepseekReasoner(): ModelConfig {
+    return { ...MODEL_DEFINITIONS['deepseek-reasoner'], apiKey: undefined };
+  },
+
+  // Qwen
+  get qwen35Plus(): ModelConfig {
+    return { ...MODEL_DEFINITIONS['qwen3.5-plus'], apiKey: undefined };
+  },
+};

package/vendor/agent-root/src/providers/types/api.ts

@@ -0,0 +1,284 @@
+/**
+ * LLM API 相关类型定义
+ *
+ * 统一的 API 类型定义，包含请求、响应、消息、工具调用等核心类型
+ */
+
+/**
+ * 工具调用
+ */
+export type ToolCall = {
+  id: string;
+  type: string;
+  index: number;
+  function: {
+    name: string;
+    arguments: string;
+  };
+};
+
+/**
+ * 消息角色类型
+ */
+export type Role = 'system' | 'assistant' | 'user' | 'tool';
+
+/**
+ * 多模态消息内容片段（OpenAI Chat Completions 风格）
+ */
+export interface TextContentPart {
+  type: 'text';
+  text: string;
+}
+
+export interface ImageUrlContentPart {
+  type: 'image_url';
+  image_url: {
+    url: string;
+    detail?: 'auto' | 'low' | 'high';
+  };
+}
+
+export interface InputAudioContentPart {
+  type: 'input_audio';
+  input_audio: {
+    data: string;
+    format: 'wav' | 'mp3';
+  };
+}
+
+export interface InputVideoContentPart {
+  type: 'input_video';
+  input_video: {
+    url?: string;
+    file_id?: string;
+    data?: string;
+    format?: 'mp4' | 'mov' | 'webm';
+  };
+}
+
+export interface FileContentPart {
+  type: 'file';
+  file: {
+    file_id?: string;
+    file_data?: string;
+    filename?: string;
+  };
+}
+
+export type InputContentPart =
+  | TextContentPart
+  | ImageUrlContentPart
+  | InputAudioContentPart
+  | InputVideoContentPart
+  | FileContentPart;
+
+/**
+ * 消息内容：纯文本或多模态数组
+ */
+export type MessageContent = string | InputContentPart[];
+
+/**
+ * Token 使用情况（统一类型，移除重复定义）
+ */
+export interface Usage {
+  /** 用户 prompt 所包含的 token 数 */
+  prompt_tokens: number;
+  /** 模型 completion 产生的 token 数 */
+  completion_tokens: number;
+  /** 该请求中，所有 token 的数量（prompt + completion） */
+  total_tokens: number;
+  /** 用户 prompt 中未命中缓存的 token 数（可选，部分提供商支持） */
+  prompt_cache_miss_tokens?: number;
+  /** 用户 prompt 中命中缓存的 token 数（可选，部分提供商支持） */
+  prompt_cache_hit_tokens?: number;
+  [key: string]: unknown;
+}
+
+/**
+ * 流式输出选项
+ */
+export interface StreamOptions {
+  /**
+   * 请求服务端在流结束时返回 usage 信息
+   * 兼容 OpenAI `stream_options.include_usage` 语义
+   */
+  include_usage?: boolean;
+  [key: string]: unknown;
+}
+
+/**
+ * 基础消息类型
+ */
+export interface BaseLLMMessage {
+  /** 消息 ID */
+  content: MessageContent;
+  role: Role;
+  reasoning_content?: string;
+  [key: string]: unknown; // 添加索引签名以兼容 Record<string, unknown>
+}
+
+/**
+ * LLM 响应消息
+ */
+export interface LLMResponseMessage extends BaseLLMMessage {
+  tool_calls?: ToolCall[];
+}
+
+/**
+ * LLM 请求消息
+ */
+export interface LLMRequestMessage extends BaseLLMMessage {
+  tool_call_id?: string;
+  tool_calls?: ToolCall[];
+}
+
+/**
+ * 完成原因
+ * - stop: 正常完成
+ * - length: 达到 token 限制
+ * - content_filter: 内容过滤
+ * - tool_calls: 工具调用
+ * - abort: 请求被中断
+ */
+export type FinishReason = 'stop' | 'length' | 'content_filter' | 'tool_calls' | 'abort' | null;
+
+/**
+ * LLM 响应
+ */
+export interface LLMResponse {
+  id: string;
+  object: string;
+  created: number;
+  model: string;
+  choices: Array<{
+    index: number;
+    message: LLMResponseMessage;
+    finish_reason?: FinishReason;
+  }>;
+  usage?: Usage;
+  [key: string]: unknown; // 添加索引签名以兼容 Record<string, unknown>
+}
+
+/**
+ * 流式错误对象（部分 OpenAI 兼容服务会在 SSE chunk 中返回）
+ */
+export interface StreamChunkError {
+  code?: string | null;
+  param?: string | null;
+  message?: string;
+  type?: string;
+  [key: string]: unknown;
+}
+
+/**
+ * 流式响应块
+ */
+export interface Chunk {
+  id?: string;
+  index: number;
+  choices?: Array<{
+    index: number;
+    delta: LLMResponseMessage;
+    finish_reason?: FinishReason;
+  }>;
+  usage?: Usage;
+  model?: string;
+  object?: string;
+  created?: number;
+  error?: StreamChunkError;
+}
+
+/**
+ * 流式回调函数
+ */
+export type StreamCallback = (chunk: Chunk) => void;
+
+/**
+ * 工具定义
+ */
+export type Tool = {
+  type: string;
+  function: {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+  };
+};
+
+/**
+ * LLM 生成选项（传给 generate 方法的可选参数）
+ */
+export interface LLMGenerateOptions {
+  /** 模型名称（覆盖默认模型） */
+  model?: string;
+  /** 最大生成 token 数 */
+  max_tokens?: number;
+  /** 温度参数 */
+  temperature?: number;
+  /** 思考模式（部分 Provider 支持） */
+  thinking?: boolean;
+  /** 是否启用流式响应 */
+  stream?: boolean;
+  /** 是否启用工具流式输出（与 stream 一致的布尔语义） */
+  tool_stream?: boolean;
+  /** 推理强度（部分 Provider 支持） */
+  model_reasoning_effort?: 'low' | 'medium' | 'high';
+  /** 流式输出选项 */
+  stream_options?: StreamOptions;
+  /** 中止信号 */
+  abortSignal?: AbortSignal;
+  /** 工具列表 */
+  tools?: Tool[];
+  /** Prompt cache routing key for providers that support sticky prefix caching */
+  prompt_cache_key?: string;
+  /** Prompt cache retention hint for providers that support configurable cache retention */
+  prompt_cache_retention?: string;
+  /** Responses API continuation id for providers that support server-side chaining */
+  previous_response_id?: string;
+  [key: string]: unknown; // 添加索引签名以兼容 Record<string, unknown>
+}
+
+/**
+ * 完整的 LLM 请求（包含消息）
+ */
+export interface LLMRequest extends LLMGenerateOptions {
+  /** 模型名称 */
+  model: string;
+  /** 对话消息列表 */
+  messages: LLMRequestMessage[];
+}
+
+/**
+ * Anthropic 流式事件类型
+ */
+export interface AnthropicStreamEvent {
+  type: string;
+  message?: {
+    id: string;
+    type: 'message';
+    role: 'assistant';
+    content: Array<{ type: string; text?: string }>;
+    model: string;
+    stop_reason: string | null;
+    stop_sequence: string | null;
+    usage: { input_tokens: number; output_tokens: number };
+  };
+  index?: number;
+  content_block?: {
+    type: 'text' | 'image' | 'tool_use' | 'tool_result';
+    text?: string;
+    id?: string;
+    name?: string;
+    input?: Record<string, unknown>;
+  };
+  delta?: {
+    type: string;
+    text?: string;
+    stop_reason?: string;
+    partial_json?: string;
+  };
+  usage?: {
+    input_tokens: number;
+    output_tokens: number;
+  };
+}

package/vendor/agent-root/src/providers/types/config.ts

@@ -0,0 +1,58 @@
+/**
+ * 配置相关类型定义
+ *
+ * 统一的配置类型，包括基础配置、Provider 配置和 OpenAI 兼容配置
+ */
+import type { ChildLogger, Logger } from '../../logger';
+
+export type ProviderLogger = Logger | ChildLogger;
+
+/**
+ * 基础 API 配置接口
+ */
+export interface BaseAPIConfig {
+  /** API 基础 URL */
+  baseURL: string;
+  /** 模型名称 */
+  model: string;
+  /** 最大生成 token 数 */
+  max_tokens: number;
+  /** 最大上下文 token 数 */
+  LLMMAX_TOKENS: number;
+  /** 温度参数 */
+  temperature: number;
+  /** 请求超时时间（毫秒） */
+  timeout?: number;
+  /** 最大重试次数（由上层重试策略使用） */
+  maxRetries?: number;
+  /** 可选日志器（建议注入 Agent 的 child logger） */
+  logger?: ProviderLogger;
+}
+
+/**
+ * Provider 基础配置
+ */
+export interface BaseProviderConfig extends BaseAPIConfig {
+  /** API 密钥或凭证 */
+  apiKey: string;
+  /** 思考模式（部分 Provider 支持） */
+  thinking?: boolean;
+  /** 其他扩展字段 */
+  [key: string]: unknown;
+}
+
+/**
+ * OpenAI 兼容服务配置
+ */
+export interface OpenAICompatibleConfig extends BaseProviderConfig {
+  /** 可选的组织 ID（部分提供商需要） */
+  organization?: string;
+  /** 聊天补全接口路径，默认为 '/chat/completions' */
+  chatCompletionsPath?: string;
+  /** 是否在流式请求中默认要求返回 usage（默认 true） */
+  enableStreamUsage?: boolean;
+  /** 默认是否启用工具流式输出（请求级可被 generate options 覆盖） */
+  tool_stream?: boolean;
+  /** 默认推理强度（请求级可被 generate options 覆盖） */
+  model_reasoning_effort?: 'low' | 'medium' | 'high';
+}