@downcity/agent 1.1.15 → 1.1.17

package/src/model/CreateModel.ts

@@ -1,350 +0,0 @@
-/**
- * LLM provider/model factory.
- *
- * 设计目标（中文，关键点）
- * - 这是“核心能力”，不应该依赖 server/RuntimeContext（避免隐式初始化时序）。
- * - `execution.type=api` 时，从平台全局 `llm.models` / `llm.providers` 解析最终模型。
- * - 当前只有 `api` 执行模式。
- */
-
-import { createAnthropic } from "@ai-sdk/anthropic";
-import { createGoogleGenerativeAI } from "@ai-sdk/google";
-import { createHuggingFace } from "@ai-sdk/huggingface";
-import { createMoonshotAI } from "@ai-sdk/moonshotai";
-import { createOpenResponses } from "@ai-sdk/open-responses";
-import { createOpenAI } from "@ai-sdk/openai";
-import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
-import { createXai } from "@ai-sdk/xai";
-import { createOpenRouter } from "@openrouter/ai-sdk-provider";
-import { type LanguageModel } from "ai";
-import { createLlmLoggingFetch } from "@/utils/logger/Fetch.js";
-import { getLogger } from "@/utils/logger/Logger.js";
-import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
-import type { LlmProviderType } from "@/types/config/LlmConfig.js";
-import { readProjectExecutionBinding } from "@/config/ExecutionBinding.js";
-import type { AgentPlatformRuntime } from "@/types/host/AgentHost.js";
-
-type ModelLogContext = {
-  sessionId?: string;
-};
-
-function buildResponsesUrl(baseUrl?: string): string {
-  const trimmed = String(baseUrl || "")
-    .trim()
-    .replace(/\/+$/, "");
-  if (!trimmed) return "https://api.openai.com/v1/responses";
-  if (trimmed.endsWith("/responses")) return trimmed;
-  return `${trimmed}/responses`;
-}
-
-function normalizeOptionalBaseUrl(value: string | undefined): string | undefined {
-  const trimmed = String(value || "")
-    .trim()
-    .replace(/\/+$/, "");
-  return trimmed || undefined;
-}
-
-/**
- * provider 默认 baseUrl。
- *
- * 关键点（中文）
- * - 当 `downcity.json.llm.providers.<id>.baseUrl` 省略时，按 provider type 自动补全。
- * - 保持“只配置 provider type + apiKey + modelName”也能跑通常见 provider。
- */
-function resolveProviderDefaultBaseUrl(
-  providerType: LlmProviderType,
-): string | undefined {
-  if (providerType === "deepseek") return "https://api.deepseek.com/v1";
-  if (providerType === "moonshot-cn") return "https://api.moonshot.cn/v1";
-  if (providerType === "moonshot-ai") return "https://api.moonshot.ai/v1";
-  if (providerType === "kimi-code") return "https://api.kimi.com/coding/v1";
-  if (providerType === "xai") return "https://api.x.ai/v1";
-  if (providerType === "openrouter") return "https://openrouter.ai/api/v1";
-  return undefined;
-}
-
-function resolveEnvPlaceholder(value: string | undefined): string | undefined {
-  if (!value) return value;
-  if (value.startsWith("${") && value.endsWith("}")) {
-    const envVar = value.slice(2, -1);
-    return process.env[envVar];
-  }
-  return value;
-}
-
-function resolveApiKeyFallback(providerType: LlmProviderType): string | undefined {
-  if (providerType === "gemini") {
-    return (
-      process.env.GEMINI_API_KEY ||
-      process.env.GOOGLE_API_KEY ||
-      process.env.GOOGLE_GENERATIVE_AI_API_KEY ||
-      process.env.API_KEY
-    );
-  }
-  if (providerType === "anthropic") {
-    return process.env.ANTHROPIC_API_KEY || process.env.API_KEY;
-  }
-  if (providerType === "deepseek") {
-    return (
-      process.env.DEEPSEEK_API_KEY ||
-      process.env.OPENAI_API_KEY ||
-      process.env.API_KEY
-    );
-  }
-  if (providerType === "xai") {
-    return process.env.XAI_API_KEY || process.env.API_KEY;
-  }
-  if (providerType === "huggingface") {
-    return (
-      process.env.HUGGINGFACE_API_KEY ||
-      process.env.HF_TOKEN ||
-      process.env.API_KEY
-    );
-  }
-  if (providerType === "openrouter") {
-    return process.env.OPENROUTER_API_KEY || process.env.API_KEY;
-  }
-  if (providerType === "moonshot-cn" || providerType === "moonshot-ai") {
-    return (
-      process.env.MOONSHOT_API_KEY ||
-      process.env.KIMI_API_KEY ||
-      process.env.API_KEY
-    );
-  }
-  if (providerType === "kimi-code") {
-    return (
-      process.env.KIMI_CODE_API_KEY ||
-      process.env.KIMI_API_KEY ||
-      process.env.MOONSHOT_API_KEY ||
-      process.env.API_KEY
-    );
-  }
-  return process.env.OPENAI_API_KEY || process.env.API_KEY;
-}
-
-function normalizeProviderType(value: unknown): LlmProviderType | null {
-  if (value === "anthropic") return value;
-  if (value === "openai") return value;
-  if (value === "deepseek") return value;
-  if (value === "gemini") return value;
-  if (value === "open-compatible") return value;
-  if (value === "open-responses") return value;
-  if (value === "moonshot-cn") return value;
-  if (value === "moonshot-ai") return value;
-  if (value === "kimi-code") return value;
-  if (value === "xai") return value;
-  if (value === "huggingface") return value;
-  if (value === "openrouter") return value;
-  return null;
-}
-
-/**
- * 创建 LanguageModel 实例。
- *
- * 解析策略（中文）
- * 1) 读取 `execution`，确认是 `api` 模式。
- * `api`：定位平台全局 `llm.models[modelId]` 与 `llm.providers[providerKey]`。
- * 创建带日志拦截的 fetch，并按 provider type 分发到 SDK 工厂。
- */
-export async function createModel(input: {
-  config: DowncityConfig;
-  getSessionRunScope?: () => ModelLogContext | undefined;
-  platform?: AgentPlatformRuntime;
-  projectRoot?: string;
-}): Promise<LanguageModel> {
-  const logger = getLogger();
-  const execution = readProjectExecutionBinding(input.config);
-  if (!execution) {
-    await logger.log("warn", "No agent execution configured");
-    throw Error("No agent execution configured");
-  }
-
-  // 日志策略（中文）：默认开启 LLM 请求日志；可通过 llm.logMessages 关闭。
-  const configLog = input.config.llm?.logMessages;
-  const logLlmMessages = typeof configLog === "boolean" ? configLog : true;
-  const loggingFetch = createLlmLoggingFetch({
-    logger,
-    enabled: logLlmMessages,
-    getSessionRunScope: input.getSessionRunScope,
-  });
-  if (!execution || execution.type !== "api") {
-    await logger.log("warn", `Unsupported agent execution for createModel: ${execution.type}`);
-    throw Error(`Unsupported agent execution for createModel: ${execution.type}`);
-  }
-
-  const primaryModelId = execution.modelId;
-
-  const platform = input.platform;
-  const modelConfig = platform?.getModel(primaryModelId) || null;
-  const providerConfigs = await (platform?.listProviders?.() || Promise.resolve([]));
-  const providerMap = new Map(providerConfigs.map((item) => [item.id, item] as const));
-  const providerConfig = modelConfig
-    ? providerMap.get(String(modelConfig.providerId || "").trim()) || null
-    : null;
-  if (!modelConfig || !providerConfig) {
-    await logger.log("warn", `LLM model config not found in platform runtime: ${primaryModelId}`);
-    throw Error(`LLM model config not found in platform runtime: ${primaryModelId}`);
-  }
-  const selectedModelConfig = modelConfig;
-  const selectedProviderConfig = providerConfig;
-  if (selectedModelConfig.isPaused === true) {
-    await logger.log(
-      "warn",
-      `LLM model is paused in platform runtime: ${primaryModelId}`,
-    );
-    throw Error(`LLM model is paused: ${primaryModelId}`);
-  }
-  const providerKey = selectedProviderConfig.id;
-
-  const providerType = normalizeProviderType(selectedProviderConfig.type);
-  if (!providerType) {
-    await logger.log("warn", `Unsupported LLM provider type: ${selectedProviderConfig.type}`);
-    throw Error(`Unsupported LLM provider type: ${selectedProviderConfig.type}`);
-  }
-
-  const resolvedModel = resolveEnvPlaceholder(selectedModelConfig.name);
-  if (!resolvedModel || resolvedModel === "${}") {
-    await logger.log("warn", "No LLM model name configured");
-    throw Error("No LLM model name configured");
-  }
-
-  const resolvedBaseUrl = normalizeOptionalBaseUrl(
-    resolveEnvPlaceholder(selectedProviderConfig.baseUrl) ||
-      resolveProviderDefaultBaseUrl(providerType),
-  );
-
-  let resolvedApiKey = resolveEnvPlaceholder(selectedProviderConfig.apiKey);
-  if (!resolvedApiKey) {
-    resolvedApiKey = resolveApiKeyFallback(providerType);
-  }
-  if (!resolvedApiKey) {
-    await logger.log("warn", "No API Key configured, will use simulation mode");
-    throw Error("No API Key configured, will use simulation mode");
-  }
-
-  // 关键点（中文）：启动阶段只打印一次当前生效模型状态，便于快速确认路由是否正确。
-  await logger.log(
-    "info",
-    `[main] model primary=${primaryModelId} provider=${providerType}/${providerKey} name=${resolvedModel}${resolvedBaseUrl ? ` baseUrl=${resolvedBaseUrl}` : ""}`,
-    {
-      kind: "llm_model_ready",
-      primaryModel: primaryModelId,
-      providerType,
-      providerKey,
-      model: resolvedModel,
-      ...(resolvedBaseUrl ? { baseUrl: resolvedBaseUrl } : {}),
-      logMessages: logLlmMessages,
-    },
-  );
-
-  if (providerType === "anthropic") {
-    const anthropicProvider = createAnthropic({
-      apiKey: resolvedApiKey,
-      baseURL: resolvedBaseUrl,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return anthropicProvider(resolvedModel);
-  }
-
-  if (providerType === "gemini") {
-    const googleProvider = createGoogleGenerativeAI({
-      apiKey: resolvedApiKey,
-      baseURL: resolvedBaseUrl,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return googleProvider(resolvedModel);
-  }
-
-  if (providerType === "open-responses") {
-    const responsesProvider = createOpenResponses({
-      url: buildResponsesUrl(resolvedBaseUrl),
-      name: providerKey,
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return responsesProvider(resolvedModel);
-  }
-
-  if (providerType === "open-compatible") {
-    const compatibleBaseUrl = resolvedBaseUrl || "https://api.openai.com/v1";
-    const compatibleProvider = createOpenAICompatible({
-      name: providerKey,
-      baseURL: compatibleBaseUrl,
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return compatibleProvider(resolvedModel);
-  }
-
-  if (providerType === "kimi-code") {
-    const compatibleBaseUrl = resolvedBaseUrl || "https://api.kimi.com/coding/v1";
-    const compatibleProvider = createOpenAICompatible({
-      name: providerKey,
-      baseURL: compatibleBaseUrl,
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return compatibleProvider(resolvedModel);
-  }
-
-  if (providerType === "moonshot-cn" || providerType === "moonshot-ai") {
-    const moonshotProvider = createMoonshotAI({
-      baseURL: resolvedBaseUrl,
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return moonshotProvider(resolvedModel);
-  }
-
-  if (providerType === "xai") {
-    const xaiProvider = createXai({
-      baseURL: resolvedBaseUrl,
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return xaiProvider(resolvedModel);
-  }
-
-  if (providerType === "huggingface") {
-    const huggingFaceProvider = createHuggingFace({
-      baseURL: resolvedBaseUrl,
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return huggingFaceProvider(resolvedModel);
-  }
-
-  if (providerType === "openrouter") {
-    const openRouterProvider = createOpenRouter({
-      baseURL: resolvedBaseUrl,
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return openRouterProvider(resolvedModel);
-  }
-
-  if (providerType === "deepseek") {
-    // 关键点（中文）：
-    // - DeepSeek 提供的是 OpenAI-compatible chat/completions 接口，不支持
-    //   `createOpenAI()` 默认语言模型走的 `/responses` 路径。
-    // - 若继续使用 `createOpenAI()`，请求会落到
-    //   `https://api.deepseek.com/v1/responses` 并直接返回 404。
-    const deepseekCompatibleProvider = createOpenAICompatible({
-      name: providerKey,
-      baseURL: resolvedBaseUrl || "https://api.deepseek.com/v1",
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return deepseekCompatibleProvider(resolvedModel);
-  }
-
-  // OpenAI 官方 provider（中文）：
-  // - 只在真正的 OpenAI provider 下使用 `createOpenAI()`。
-  // - 该 SDK 默认语言模型使用 Responses API，适配官方 OpenAI 路径。
-  const openaiProvider = createOpenAI({
-    apiKey: resolvedApiKey,
-    baseURL: resolvedBaseUrl,
-    fetch: loggingFetch as typeof fetch,
-  });
-  return openaiProvider(resolvedModel);
-}

package/src/model/ModelManager.ts

@@ -1,242 +0,0 @@
-/**
- * ModelManager：LLM 模型预设管理器。
- *
- * 关键点（中文）
- * - 统一管理 init 场景的“模型预设清单 + providerType 映射 + 自定义模型标记”。
- * - 避免命令层直接依赖硬编码常量，提升可维护性与一致性。
- */
-
-import type { LlmProviderType } from "@/types/config/LlmConfig.js";
-
-/**
- * 单个模型预设定义。
- */
-export type ModelPreset = {
-  /**
-   * 预设 ID（同时作为模型名称写入 `llm.models.<active>.name`，除自定义模型外）。
-   */
-  id: string;
-
-  /**
-   * 预设标题（用于 CLI 交互显示）。
-   */
-  title: string;
-
-  /**
-   * 对应 provider 类型（用于生成 `llm.providers.<id>.type`）。
-   */
-  providerTypes: readonly LlmProviderType[];
-
-  /**
-   * 是否属于“模型名由环境变量注入”的自定义模型类型。
-   */
-  useCustomModelName: boolean;
-};
-
-const CUSTOM_MODEL_IDS = new Set<string>(["open-compatible", "open-responses"]);
-
-const MODEL_PRESETS: ModelPreset[] = [
-  // Claude 系列
-  {
-    id: "claude-sonnet-4-5",
-    title: "Claude Sonnet 4",
-    providerTypes: ["anthropic"],
-    useCustomModelName: false,
-  },
-  {
-    id: "claude-haiku",
-    title: "Claude Haiku",
-    providerTypes: ["anthropic"],
-    useCustomModelName: false,
-  },
-  {
-    id: "claude-3-5-sonnet-20241022",
-    title: "Claude 3.5 Sonnet",
-    providerTypes: ["anthropic"],
-    useCustomModelName: false,
-  },
-  {
-    id: "claude-3-opus-20240229",
-    title: "Claude 3 Opus",
-    providerTypes: ["anthropic"],
-    useCustomModelName: false,
-  },
-  // OpenAI GPT 系列
-  {
-    id: "gpt-4",
-    title: "GPT-4",
-    providerTypes: ["openai"],
-    useCustomModelName: false,
-  },
-  {
-    id: "gpt-4-turbo",
-    title: "GPT-4 Turbo",
-    providerTypes: ["openai"],
-    useCustomModelName: false,
-  },
-  {
-    id: "gpt-4o",
-    title: "GPT-4o",
-    providerTypes: ["openai"],
-    useCustomModelName: false,
-  },
-  {
-    id: "gpt-3.5-turbo",
-    title: "GPT-3.5 Turbo",
-    providerTypes: ["openai"],
-    useCustomModelName: false,
-  },
-  // DeepSeek
-  {
-    id: "deepseek-chat",
-    title: "DeepSeek Chat",
-    providerTypes: ["deepseek"],
-    useCustomModelName: false,
-  },
-  // Gemini
-  {
-    id: "gemini-2.5-pro",
-    title: "Gemini 2.5 Pro",
-    providerTypes: ["gemini"],
-    useCustomModelName: false,
-  },
-  {
-    id: "gemini-2.5-flash",
-    title: "Gemini 2.5 Flash",
-    providerTypes: ["gemini"],
-    useCustomModelName: false,
-  },
-  // xAI
-  {
-    id: "grok-3",
-    title: "xAI Grok 3",
-    providerTypes: ["xai"],
-    useCustomModelName: false,
-  },
-  // HuggingFace Router
-  {
-    id: "meta-llama/Llama-3.1-8B-Instruct",
-    title: "HF Llama 3.1 8B",
-    providerTypes: ["huggingface"],
-    useCustomModelName: false,
-  },
-  // OpenRouter
-  {
-    id: "openrouter/auto",
-    title: "OpenRouter Auto",
-    providerTypes: ["openrouter"],
-    useCustomModelName: false,
-  },
-  // Moonshot(Kimi)
-  {
-    id: "kimi-k2.5",
-    title: "Kimi K2.5",
-    providerTypes: ["moonshot-cn", "moonshot-ai"],
-    useCustomModelName: false,
-  },
-  {
-    id: "kimi-for-coding",
-    title: "Kimi For Coding",
-    providerTypes: ["kimi-code"],
-    useCustomModelName: false,
-  },
-  // OpenAI-compatible（Chat Completions）
-  {
-    id: "open-compatible",
-    title: "Open-compatible model",
-    providerTypes: ["open-compatible"],
-    useCustomModelName: true,
-  },
-  // OpenAI-compatible（Responses）
-  {
-    id: "open-responses",
-    title: "Open-responses model",
-    providerTypes: ["open-responses"],
-    useCustomModelName: true,
-  },
-];
-
-const DEFAULT_MODEL_PRESET_ID = "claude-sonnet-4-5";
-const FALLBACK_MODEL_PRESET_ID = "open-compatible";
-
-/**
- * init 模型选择解析结果。
- */
-export type ResolvedInitModelPreset = {
-  /**
-   * 规范化后的模型预设 ID。
-   */
-  selectedModelId: string;
-
-  /**
-   * 选中的模型预设。
-   */
-  preset: ModelPreset;
-};
-
-/**
- * 模型预设管理器。
- */
-export class ModelManager {
-  private readonly presets: ModelPreset[];
-  private readonly presetsById: Map<string, ModelPreset>;
-
-  constructor() {
-    this.presets = [...MODEL_PRESETS];
-    this.presetsById = new Map(
-      this.presets.map((preset) => [preset.id, preset] as const),
-    );
-  }
-
-  /**
-   * 列出所有可选模型预设（按定义顺序）。
-   */
-  listPresets(): ModelPreset[] {
-    return [...this.presets];
-  }
-
-  /**
-   * 根据预设 ID 获取模型预设。
-   */
-  getPreset(id: string): ModelPreset | undefined {
-    const key = String(id || "").trim();
-    if (!key) return undefined;
-    return this.presetsById.get(key);
-  }
-
-  /**
-   * 判断预设是否支持指定 provider 类型。
-   */
-  supportsProviderType(preset: ModelPreset, providerType: LlmProviderType): boolean {
-    return preset.providerTypes.includes(providerType);
-  }
-
-  /**
-   * 获取默认模型预设。
-   */
-  getDefaultPreset(): ModelPreset {
-    return (
-      this.getPreset(DEFAULT_MODEL_PRESET_ID) ||
-      this.getPreset(FALLBACK_MODEL_PRESET_ID) ||
-      this.presets[0]
-    );
-  }
-
-  /**
-   * 解析 init 输入的模型选择，并返回稳定的预设结果。
-   */
-  resolveInitPreset(input?: string): ResolvedInitModelPreset {
-    const selectedModelId = String(input || "").trim();
-    const preset =
-      this.getPreset(selectedModelId) ||
-      this.getPreset(FALLBACK_MODEL_PRESET_ID) ||
-      this.getDefaultPreset();
-    return {
-      selectedModelId: selectedModelId || preset.id,
-      preset: {
-        ...preset,
-        useCustomModelName: CUSTOM_MODEL_IDS.has(preset.id),
-      },
-    };
-  }
-}

package/src/session/composer/SessionComposer.ts

@@ -1,34 +0,0 @@
-/**
- * SessionComposer：Session Composer 层的最小公共基类。
- *
- * 关键点（中文）
- * - 这里只提供统一的生命周期壳，不承载具体业务语义。
- * - 具体职责必须由子类自己表达，例如 HistoryStore / CompactionPolicy / SystemResolver / ExecutionComposer。
- */
-export abstract class SessionComposer {
-  /**
-   * Composer 名称（用于日志与诊断）。
-   */
-  abstract readonly name: string;
-
-  /**
-   * 可选初始化钩子。
-   *
-   * 关键点（中文）
-   * - Executor / Runner 启动时可统一调用。
-   * - 无需初始化的 Composer 可不实现。
-   */
-  async init(): Promise<void> {
-    // no-op
-  }
-
-  /**
-   * 可选释放钩子。
-   *
-   * 关键点（中文）
-   * - Session 运行时关停时统一释放资源（连接、句柄、缓存等）。
-   */
-  async dispose(): Promise<void> {
-    // no-op
-  }
-}