@downcity/city 1.1.4 → 1.1.6

package/src/http/dashboard/TaskStore.ts

@@ -1,222 +0,0 @@
-/**
- * Dashboard 任务与日志数据 helper。
- *
- * 关键点（中文）
- * - 聚合 logs 与 task runs 读取逻辑。
- * - 仅负责磁盘侧读取与 dashboard 视图映射。
- */
-
-import fs from "fs-extra";
-import path from "node:path";
-import { getLogsDirPath, getDowncityTasksDirPath } from "@/config/Paths.js";
-import { resolveTaskIdByTitle } from "@downcity/agent/services/task/runtime/Store.js";
-import type {
-  DashboardLogEntry,
-  DashboardTaskRunDetail,
-  DashboardTaskRunSummary,
-} from "@downcity/agent/shared/types/DashboardData.js";
-import { truncateText } from "./CommonHelpers.js";
-import { loadSessionMessagesFromFile, toUiMessageTimeline } from "./MessageTimeline.js";
-
-export const TASK_RUN_DIR_REGEX = /^\d{8}-\d{6}-\d{3}$/;
-
-/**
- * 读取近期日志。
- */
-export async function readRecentLogs(params: {
-  projectRoot: string;
-  limit: number;
-}): Promise<DashboardLogEntry[]> {
-  const logsDir = getLogsDirPath(params.projectRoot);
-  if (!(await fs.pathExists(logsDir))) return [];
-
-  const files = (await fs.readdir(logsDir, { withFileTypes: true }))
-    .filter((x) => x.isFile() && x.name.endsWith(".jsonl"))
-    .map((x) => x.name)
-    .sort()
-    .reverse();
-
-  const out: DashboardLogEntry[] = [];
-
-  for (const fileName of files) {
-    if (out.length >= params.limit) break;
-    const abs = path.join(logsDir, fileName);
-    const raw = await fs.readFile(abs, "utf-8").catch(() => "");
-    const lines = raw.split("\n").filter(Boolean);
-
-    for (let index = lines.length - 1; index >= 0; index -= 1) {
-      if (out.length >= params.limit) break;
-      try {
-        const parsed = JSON.parse(lines[index]) as DashboardLogEntry;
-        if (!parsed || typeof parsed !== "object") continue;
-        out.push({
-          ...(typeof parsed.timestamp === "string" ? { timestamp: parsed.timestamp } : {}),
-          ...(typeof parsed.type === "string" ? { type: parsed.type } : {}),
-          ...(typeof parsed.level === "string" ? { level: parsed.level } : {}),
-          ...(typeof parsed.message === "string" ? { message: parsed.message } : {}),
-          ...(parsed.details && typeof parsed.details === "object"
-            ? { details: parsed.details }
-            : {}),
-        });
-      } catch {
-        // ignore
-      }
-    }
-  }
-
-  return out;
-}
-
-async function resolveTaskDir(projectRoot: string, title: string): Promise<string> {
-  const taskId = await resolveTaskIdByTitle({ projectRoot, title });
-  return path.join(getDowncityTasksDirPath(projectRoot), taskId);
-}
-
-/**
- * 枚举任务运行摘要。
- */
-export async function listTaskRuns(params: {
-  projectRoot: string;
-  title: string;
-  limit: number;
-}): Promise<DashboardTaskRunSummary[]> {
-  const taskDir = await resolveTaskDir(params.projectRoot, params.title);
-  if (!(await fs.pathExists(taskDir))) return [];
-
-  const entries = await fs.readdir(taskDir, { withFileTypes: true });
-  const timestamps = entries
-    .filter((x) => x.isDirectory() && TASK_RUN_DIR_REGEX.test(x.name))
-    .map((x) => x.name)
-    .sort()
-    .reverse()
-    .slice(0, params.limit);
-
-  const out: DashboardTaskRunSummary[] = [];
-
-  for (const timestamp of timestamps) {
-    const runDir = path.join(taskDir, timestamp);
-    const metaPath = path.join(runDir, "run.json");
-    const progressPath = path.join(runDir, "run-progress.json");
-    const runDirRel = path.relative(params.projectRoot, runDir).split(path.sep).join("/");
-    const meta = (await fs.readJson(metaPath).catch(() => null)) as {
-      status?: string;
-      executionStatus?: string;
-      resultStatus?: string;
-      startedAt?: number;
-      endedAt?: number;
-      dialogueRounds?: number;
-      userSimulatorSatisfied?: boolean;
-      error?: string;
-    } | null;
-    const progress = (await fs.readJson(progressPath).catch(() => null)) as {
-      status?: string;
-      phase?: string;
-      message?: string;
-      updatedAt?: number;
-      round?: number;
-      maxRounds?: number;
-    } | null;
-
-    const progressStatus =
-      typeof progress?.status === "string" ? progress.status : undefined;
-    const inProgress =
-      progressStatus === "running" ||
-      (!meta && (await fs.pathExists(progressPath)));
-    const displayStatus =
-      inProgress
-        ? "running"
-        : typeof meta?.status === "string"
-          ? meta.status
-          : progressStatus;
-
-    out.push({
-      timestamp,
-      ...(typeof displayStatus === "string" ? { status: displayStatus } : {}),
-      ...(typeof meta?.executionStatus === "string" ? { executionStatus: meta.executionStatus } : {}),
-      ...(typeof meta?.resultStatus === "string" ? { resultStatus: meta.resultStatus } : {}),
-      ...(inProgress ? { inProgress: true } : {}),
-      ...(typeof progress?.phase === "string" ? { progressPhase: progress.phase } : {}),
-      ...(typeof progress?.message === "string" ? { progressMessage: progress.message } : {}),
-      ...(typeof progress?.updatedAt === "number" ? { progressUpdatedAt: progress.updatedAt } : {}),
-      ...(typeof progress?.round === "number" ? { progressRound: progress.round } : {}),
-      ...(typeof progress?.maxRounds === "number" ? { progressMaxRounds: progress.maxRounds } : {}),
-      ...(typeof meta?.startedAt === "number" ? { startedAt: meta.startedAt } : {}),
-      ...(typeof meta?.endedAt === "number" ? { endedAt: meta.endedAt } : {}),
-      ...(typeof meta?.dialogueRounds === "number" ? { dialogueRounds: meta.dialogueRounds } : {}),
-      ...(typeof meta?.userSimulatorSatisfied === "boolean"
-        ? { userSimulatorSatisfied: meta.userSimulatorSatisfied }
-        : {}),
-      ...(typeof meta?.error === "string" ? { error: meta.error } : {}),
-      runDirRel,
-    });
-  }
-
-  return out;
-}
-
-/**
- * 读取任务运行详情。
- */
-export async function readTaskRunDetail(params: {
-  projectRoot: string;
-  title: string;
-  timestamp: string;
-}): Promise<DashboardTaskRunDetail | null> {
-  const taskDir = await resolveTaskDir(params.projectRoot, params.title);
-  const runDir = path.join(taskDir, params.timestamp);
-  if (!(await fs.pathExists(runDir))) return null;
-
-  const readText = async (name: string, maxChars = 80_000): Promise<string | undefined> => {
-    const abs = path.join(runDir, name);
-    if (!(await fs.pathExists(abs))) return undefined;
-    const raw = await fs.readFile(abs, "utf-8").catch(() => "");
-    return truncateText(raw, maxChars);
-  };
-
-  const readJson = async <T>(name: string): Promise<T | undefined> => {
-    const abs = path.join(runDir, name);
-    if (!(await fs.pathExists(abs))) return undefined;
-    return (await fs.readJson(abs).catch(() => undefined)) as T | undefined;
-  };
-
-  const messagesPath = path.join(runDir, "messages.jsonl");
-  const messages = await loadSessionMessagesFromFile(messagesPath);
-  const progress = await readJson<{
-    status?: string;
-    phase?: string;
-    message?: string;
-    startedAt?: number;
-    updatedAt?: number;
-    endedAt?: number;
-    round?: number;
-    maxRounds?: number;
-    runStatus?: string;
-    executionStatus?: string;
-    resultStatus?: string;
-    events?: Array<{
-      at?: number;
-      phase?: string;
-      message?: string;
-      round?: number;
-      maxRounds?: number;
-    }>;
-  }>("run-progress.json");
-  const outputText = (await readText("output.md")) || (await readText("result.md"));
-
-  return {
-    title: params.title,
-    timestamp: params.timestamp,
-    runDirRel: path.relative(params.projectRoot, runDir).split(path.sep).join("/"),
-    meta: await readJson<Record<string, unknown>>("run.json"),
-    ...(progress ? { progress } : {}),
-    dialogue: await readJson<Record<string, unknown>>("dialogue.json"),
-    artifacts: {
-      input: await readText("input.md"),
-      output: outputText,
-      result: await readText("result.md"),
-      dialogue: await readText("dialogue.md"),
-      error: await readText("error.md"),
-    },
-    messages: messages.slice(-120).flatMap((message) => toUiMessageTimeline(message)),
-  };
-}

package/src/model/ModelCommand.ts

@@ -1,95 +0,0 @@
-/**
- * ModelCommand：命令层模型能力入口。
- *
- * 关键点（中文）
- * - commands 不直接访问模型预设常量，统一通过该模块获取。
- * - 底层委托给 model/ModelManager，命令层只关心交互与配置生成需要的数据形状。
- */
-
-import type { LlmProviderType } from "@downcity/agent/shared/types/LlmConfig.js";
-import {
-  ModelManager,
-  type ModelPreset,
-} from "@/model/ModelManager.js";
-
-const manager = new ModelManager();
-
-/**
- * Init 交互选择项。
- */
-export type InitModelChoice = {
-  /**
-   * 展示标题。
-   */
-  title: string;
-
-  /**
-   * 选择值（模型预设 ID）。
-   */
-  value: string;
-};
-
-/**
- * Init 模型解析结果。
- */
-export type ResolvedInitModel = {
-  /**
-   * 最终采用的模型预设 ID。
-   */
-  modelId: string;
-
-  /**
-   * provider 类型（写入 `llm.providers.<id>.type`）。
-   */
-  providerType: LlmProviderType;
-
-  /**
-   * 是否由环境变量注入模型名（`LLM_MODEL`）。
-   */
-  useCustomModelName: boolean;
-
-  /**
-   * 预设标题（用于提示信息输出）。
-   */
-  title: string;
-};
-
-/**
- * 获取 init 的模型选择列表。
- */
-export function listInitModelChoices(): InitModelChoice[] {
-  return manager.listPresets().map((preset) => ({
-    title: preset.title,
-    value: preset.id,
-  }));
-}
-
-/**
- * 获取 init 默认选择索引。
- */
-export function getInitModelDefaultIndex(): number {
-  const presets = manager.listPresets();
-  const defaultId = manager.getDefaultPreset().id;
-  const index = presets.findIndex((preset) => preset.id === defaultId);
-  return index >= 0 ? index : 0;
-}
-
-/**
- * 解析 init 的模型输入。
- */
-export function resolveInitModel(input?: string): ResolvedInitModel {
-  const resolved = manager.resolveInitPreset(input);
-  return {
-    modelId: resolved.preset.id,
-    providerType: resolved.preset.providerTypes[0],
-    useCustomModelName: resolved.preset.useCustomModelName,
-    title: resolved.preset.title,
-  };
-}
-
-/**
- * 列出模型预设（供其他命令扩展使用）。
- */
-export function listModelPresets(): ModelPreset[] {
-  return manager.listPresets();
-}

package/src/model/ModelManager.ts

@@ -1,242 +0,0 @@
-/**
- * ModelManager：LLM 模型预设管理器。
- *
- * 关键点（中文）
- * - 统一管理 init 场景的“模型预设清单 + providerType 映射 + 自定义模型标记”。
- * - 避免命令层直接依赖硬编码常量，提升可维护性与一致性。
- */
-
-import type { LlmProviderType } from "@downcity/agent/shared/types/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/registry/AgentHostRuntime.ts

@@ -1,65 +0,0 @@
-/**
- * AgentHostRuntime：装配 AgentRuntime 宿主能力。
- *
- * 关键点（中文）
- * - `main/agent/*` 负责创建这些宿主能力对象，再注入到 AgentRuntime。
- * - services / session / plugins 只消费这些对象，不再直接 import `main/*`。
- * - 当前先收敛路径与 plugin 配置持久化两类宿主能力。
- */
-import {
-  getCacheDirPath,
-  getDowncityChannelDirPath,
-  getDowncityChannelMetaPath,
-  getDowncityChatHistoryPath,
-  getDowncityDirPath,
-  getDowncityMemoryDailyDirPath,
-  getDowncityMemoryDailyPath,
-  getDowncityMemoryIndexPath,
-  getDowncityMemoryLongTermPath,
-  getDowncitySessionDirPath,
-  getDowncitySessionRootDirPath,
-} from "@/config/Paths.js";
-import { persistProjectPluginConfig } from "@downcity/agent/plugin/ProjectConfigStore.js";
-import type {
-  AgentPathRuntime,
-  AgentPluginConfigRuntime,
-} from "@downcity/agent/shared/types/AgentHost.js";
-import type { DowncityConfig } from "@downcity/agent/shared/types/DowncityConfig.js";
-
-/**
- * 创建当前项目的路径能力集合。
- */
-export function createAgentPathRuntime(projectRoot: string): AgentPathRuntime {
-  const rootPath = String(projectRoot || "").trim();
-  return {
-    projectRoot: rootPath,
-    getDowncityDirPath: () => getDowncityDirPath(rootPath),
-    getCacheDirPath: () => getCacheDirPath(rootPath),
-    getDowncityChannelDirPath: () => getDowncityChannelDirPath(rootPath),
-    getDowncityChannelMetaPath: () => getDowncityChannelMetaPath(rootPath),
-    getDowncityChatHistoryPath: (sessionId) => getDowncityChatHistoryPath(rootPath, sessionId),
-    getDowncityMemoryIndexPath: () => getDowncityMemoryIndexPath(rootPath),
-    getDowncityMemoryLongTermPath: () => getDowncityMemoryLongTermPath(rootPath),
-    getDowncityMemoryDailyDirPath: () => getDowncityMemoryDailyDirPath(rootPath),
-    getDowncityMemoryDailyPath: (date) => getDowncityMemoryDailyPath(rootPath, date),
-    getDowncitySessionRootDirPath: () => getDowncitySessionRootDirPath(rootPath),
-    getDowncitySessionDirPath: (sessionId) => getDowncitySessionDirPath(rootPath, sessionId),
-  };
-}
-
-/**
- * 创建 plugin 配置持久化能力集合。
- */
-export function createAgentPluginConfigRuntime(projectRoot: string): AgentPluginConfigRuntime {
-  const rootPath = String(projectRoot || "").trim();
-  return {
-    async persistProjectPlugins(plugins: DowncityConfig["plugins"] | undefined): Promise<string> {
-      return persistProjectPluginConfig({
-        projectRoot: rootPath,
-        sections: {
-          ...(plugins !== undefined ? { plugins } : {}),
-        },
-      });
-    },
-  };
-}