@downcity/city 1.1.1 → 1.1.4

package/src/runtime/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 "@/plugin/ProjectConfigStore.js";
-import type {
-  AgentPathRuntime,
-  AgentPluginConfigRuntime,
-} from "@/shared/types/AgentHost.js";
-import type { DowncityConfig } from "@/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 } : {}),
-        },
-      });
-    },
-  };
-}

package/src/runtime/CityPaths.ts

@@ -1,101 +0,0 @@
-/**
- * CityPaths：city 全局运行态与 Console 模块共享的路径规则。
- *
- * 关键点（中文）
- * - Downcity 的全局根目录固定在用户目录 `~/.downcity/`。
- * - `~/.downcity/downcity.db`：全局 SQLite 数据库，保存模型池与平台级配置。
- * - `~/.downcity/main/*`：city 后台与 Console 模块共享的运行文件目录。
- * - 这里定义的是“全局路径约定”，不是单个 agent 项目的 `.downcity/` 路径。
- */
-
-import os from "node:os";
-import path from "node:path";
-
-/**
- * 全局根目录（用户级）。
- *
- * 关键点（中文）
- * - 测试或多实例隔离场景可通过 `DC_CONSOLE_ROOT` 显式覆盖。
- */
-export function getConsoleRootDirPath(): string {
-  const explicitRoot = String(process.env.DC_CONSOLE_ROOT || "").trim();
-  if (explicitRoot) return path.resolve(explicitRoot);
-  return path.join(os.homedir(), ".downcity");
-}
-
-/**
- * 历史兼容：旧版 downcity.json 路径（当前不再使用）。
- */
-export function getConsoleShipJsonPath(): string {
-  return path.join(getConsoleRootDirPath(), "downcity.json");
-}
-
-/**
- * 全局 SQLite 数据库路径（用户级）。
- */
-export function getConsoleShipDbPath(): string {
-  return path.join(getConsoleRootDirPath(), "downcity.db");
-}
-
-/**
- * 历史兼容：旧版 .env 路径（当前不再使用）。
- */
-export function getConsoleDotenvPath(): string {
-  return path.join(getConsoleRootDirPath(), ".env");
-}
-
-/**
- * city 全局运行目录（pid/log/registry）。
- */
-export function getCityRuntimeDirPath(): string {
-  return path.join(getConsoleRootDirPath(), "main");
-}
-
-/**
- * 全局模型存储密钥文件路径。
- */
-export function getConsoleModelDbKeyPath(): string {
-  return path.join(getCityRuntimeDirPath(), "model-db.key");
-}
-
-/**
- * city 后台 pid 文件路径。
- */
-export function getCityPidPath(): string {
-  return path.join(getCityRuntimeDirPath(), "city.pid");
-}
-
-/**
- * city 后台日志路径（stdout/stderr 合并）。
- */
-export function getCityLogPath(): string {
-  return path.join(getCityRuntimeDirPath(), "city.log");
-}
-
-/**
- * Console 模块 pid 文件路径。
- */
-export function getConsolePidPath(): string {
-  return path.join(getCityRuntimeDirPath(), "console.pid");
-}
-
-/**
- * Console 模块日志路径（stdout/stderr 合并）。
- */
-export function getConsoleLogPath(): string {
-  return path.join(getCityRuntimeDirPath(), "console.log");
-}
-
-/**
- * Console 模块元数据路径。
- */
-export function getConsoleMetaPath(): string {
-  return path.join(getCityRuntimeDirPath(), "console.json");
-}
-
-/**
- * agent registry 文件路径（city 维护的运行中 agent 清单）。
- */
-export function getConsoleAgentRegistryPath(): string {
-  return path.join(getCityRuntimeDirPath(), "agents.json");
-}

package/src/runtime/CityRegistry.ts

@@ -1,256 +0,0 @@
-/**
- * CityRegistry：city 后台维护的 agent registry（`~/.downcity/main/agents.json`）。
- *
- * 关键点（中文）
- * - registry 只维护“city 认知到的 agent 项目列表”，用于统一观测与批量管理。
- * - registry 不承载实时健康检查：status/list 会读取每个项目的 daemon pid 并判活。
- * - agent daemon 启动成功后必须登记到 city 后台（强约束）。
- */
-
-import fs from "fs-extra";
-import path from "node:path";
-import type {
-  ConsoleAgentRegistryEntry,
-  ConsoleAgentRegistryV1,
-} from "@/shared/types/Console.js";
-import { getConsoleAgentRegistryPath, getCityRuntimeDirPath } from "./CityPaths.js";
-import { isCityRunning } from "./CityRuntime.js";
-
-const CONSOLE_DIR = getCityRuntimeDirPath();
-const CONSOLE_AGENTS_FILE = getConsoleAgentRegistryPath();
-
-function buildEmptyRegistry(): ConsoleAgentRegistryV1 {
-  return {
-    v: 1,
-    updatedAt: new Date().toISOString(),
-    agents: [],
-  };
-}
-
-function normalizeProjectRoot(projectRoot: string): string {
-  const resolved = path.resolve(String(projectRoot || "").trim());
-  if (!resolved) throw new Error("projectRoot is required");
-  return resolved;
-}
-
-function normalizePid(pid: number): number {
-  if (!Number.isFinite(pid) || Number.isNaN(pid) || !Number.isInteger(pid) || pid < 1) {
-    throw new Error(`Invalid pid: ${pid}`);
-  }
-  return pid;
-}
-
-function normalizeIsoTime(input: string | undefined): string {
-  const value = String(input || "").trim();
-  if (!value) return new Date().toISOString();
-  const ms = Date.parse(value);
-  if (!Number.isFinite(ms)) return new Date().toISOString();
-  return new Date(ms).toISOString();
-}
-
-function normalizeRegistryEntry(
-  entry: Partial<ConsoleAgentRegistryEntry>,
-): ConsoleAgentRegistryEntry | null {
-  try {
-    const projectRoot = normalizeProjectRoot(String(entry.projectRoot || ""));
-    const pid = normalizePid(Number(entry.pid));
-    const startedAt = normalizeIsoTime(
-      typeof entry.startedAt === "string" ? entry.startedAt : undefined,
-    );
-    const updatedAt = normalizeIsoTime(
-      typeof entry.updatedAt === "string" ? entry.updatedAt : undefined,
-    );
-    return {
-      projectRoot,
-      pid,
-      startedAt,
-      updatedAt,
-      status:
-        entry.status === "stopped"
-          ? "stopped"
-          : "running",
-      stoppedAt:
-        entry.status === "stopped"
-          ? normalizeIsoTime(
-              typeof entry.stoppedAt === "string"
-                ? entry.stoppedAt
-                : undefined,
-            )
-          : undefined,
-    };
-  } catch {
-    return null;
-  }
-}
-
-function normalizeRegistry(
-  value: Partial<ConsoleAgentRegistryV1> | null | undefined,
-): ConsoleAgentRegistryV1 {
-  if (!value || typeof value !== "object") return buildEmptyRegistry();
-  const source = Array.isArray(value.agents) ? value.agents : [];
-  const normalizedAgents: ConsoleAgentRegistryEntry[] = [];
-  for (const item of source) {
-    if (!item || typeof item !== "object") continue;
-    const normalized = normalizeRegistryEntry(item as ConsoleAgentRegistryEntry);
-    if (!normalized) continue;
-    const existingIndex = normalizedAgents.findIndex(
-      (entry) => entry.projectRoot === normalized.projectRoot,
-    );
-    if (existingIndex >= 0) {
-      normalizedAgents[existingIndex] = normalized;
-      continue;
-    }
-    normalizedAgents.push(normalized);
-  }
-  return {
-    v: 1,
-    updatedAt: normalizeIsoTime(
-      typeof value.updatedAt === "string" ? value.updatedAt : undefined,
-    ),
-    agents: normalizedAgents.sort((a, b) =>
-      a.projectRoot.localeCompare(b.projectRoot),
-    ),
-  };
-}
-
-async function writeConsoleAgentRegistry(
-  registry: ConsoleAgentRegistryV1,
-): Promise<void> {
-  await fs.ensureDir(CONSOLE_DIR);
-  await fs.writeJson(CONSOLE_AGENTS_FILE, normalizeRegistry(registry), {
-    spaces: 2,
-  });
-}
-
-/**
- * 确保 city agent registry 文件存在。
- *
- * 关键点（中文）
- * - 空 city 运行态也应拥有显式的空 registry，避免 Console 将“尚未启动任何 agent”误判为异常。
- * - 若文件已存在则不覆盖，保持历史记录不丢失。
- */
-export async function ensureConsoleAgentRegistry(): Promise<void> {
-  await fs.ensureDir(CONSOLE_DIR);
-  if (await fs.pathExists(CONSOLE_AGENTS_FILE)) {
-    return;
-  }
-  await writeConsoleAgentRegistry(buildEmptyRegistry());
-}
-
-/**
- * 获取 city agent registry 文件路径。
- */
-export function getConsoleAgentsRegistryPath(): string {
-  return CONSOLE_AGENTS_FILE;
-}
-
-/**
- * 读取 city agent registry（容错）。
- *
- * 关键点（中文）
- * - 文件不存在或损坏时返回空 registry，避免影响主流程。
- */
-export async function readConsoleAgentRegistry(): Promise<ConsoleAgentRegistryV1> {
-  try {
-    if (!(await fs.pathExists(CONSOLE_AGENTS_FILE))) {
-      return buildEmptyRegistry();
-    }
-    const raw = (await fs.readJson(CONSOLE_AGENTS_FILE)) as Partial<ConsoleAgentRegistryV1>;
-    return normalizeRegistry(raw);
-  } catch {
-    return buildEmptyRegistry();
-  }
-}
-
-/**
- * 列出 city registry 中记录的 agent（按 projectRoot 排序）。
- */
-export async function listConsoleAgents(): Promise<ConsoleAgentRegistryEntry[]> {
-  const registry = await readConsoleAgentRegistry();
-  return [...registry.agents].sort((a, b) => a.projectRoot.localeCompare(b.projectRoot));
-}
-
-/**
- * 新增或更新一条 city agent 记录。
- */
-export async function upsertConsoleAgentEntry(input: {
-  projectRoot: string;
-  pid: number;
-  startedAt?: string;
-  status?: "running" | "stopped";
-  stoppedAt?: string;
-}): Promise<void> {
-  // 关键点（中文）：agent 必须登记到 city 后台才“有效”，因此 city 未启动时拒绝写入 registry。
-  if (!(await isCityRunning())) {
-    throw new Error("city runtime is not running");
-  }
-
-  const projectRoot = normalizeProjectRoot(input.projectRoot);
-  const pid = normalizePid(input.pid);
-  const nowIso = new Date().toISOString();
-
-  const registry = await readConsoleAgentRegistry();
-  const index = registry.agents.findIndex((entry) => entry.projectRoot === projectRoot);
-  if (index >= 0) {
-    const existing = registry.agents[index];
-    registry.agents[index] = {
-      projectRoot,
-      pid,
-      startedAt: normalizeIsoTime(existing.startedAt || input.startedAt),
-      updatedAt: nowIso,
-      status: input.status === "stopped" ? "stopped" : "running",
-      stoppedAt:
-        input.status === "stopped"
-          ? normalizeIsoTime(input.stoppedAt || nowIso)
-          : undefined,
-    };
-  } else {
-    registry.agents.push({
-      projectRoot,
-      pid,
-      startedAt: normalizeIsoTime(input.startedAt),
-      updatedAt: nowIso,
-      status: input.status === "stopped" ? "stopped" : "running",
-      stoppedAt:
-        input.status === "stopped"
-          ? normalizeIsoTime(input.stoppedAt || nowIso)
-          : undefined,
-    });
-  }
-
-  registry.updatedAt = nowIso;
-  await writeConsoleAgentRegistry(registry);
-}
-
-/**
- * 标记 agent 为 stopped（保留历史记录，不删除）。
- */
-export async function markConsoleAgentStopped(projectRoot: string): Promise<void> {
-  const key = normalizeProjectRoot(projectRoot);
-  const registry = await readConsoleAgentRegistry();
-  const index = registry.agents.findIndex((entry) => entry.projectRoot === key);
-  if (index < 0) return;
-  const nowIso = new Date().toISOString();
-  const current = registry.agents[index];
-  registry.agents[index] = {
-    ...current,
-    status: "stopped",
-    stoppedAt: nowIso,
-    updatedAt: nowIso,
-  };
-  registry.updatedAt = nowIso;
-  await writeConsoleAgentRegistry(registry);
-}
-
-/**
- * 按 projectRoot 移除一条 agent 记录。
- */
-export async function removeConsoleAgentEntry(projectRoot: string): Promise<void> {
-  const key = normalizeProjectRoot(projectRoot);
-  const registry = await readConsoleAgentRegistry();
-  const nextAgents = registry.agents.filter((entry) => entry.projectRoot !== key);
-  if (nextAgents.length === registry.agents.length) return;
-  registry.agents = nextAgents;
-  registry.updatedAt = new Date().toISOString();
-  await writeConsoleAgentRegistry(registry);
-}

package/src/runtime/CityRuntime.ts

@@ -1,45 +0,0 @@
-/**
- * CityRuntime：city 后台进程状态工具。
- *
- * 关键点（中文）
- * - city 后台负责统一管理/观测多个 agent daemon。
- * - 这里处理的是 city 后台自身的 pid 与判活，不涉及 Console 模块的 UI 进程。
- * - agent daemon 启动前必须确保 city 后台已启动（强约束）。
- */
-
-import fs from "fs-extra";
-import { getCityPidPath } from "./CityPaths.js";
-
-/**
- * 读取 city 后台 pid（读取失败或内容非法返回 null）。
- */
-export async function readCityPid(): Promise<number | null> {
-  try {
-    const raw = await fs.readFile(getCityPidPath(), "utf-8");
-    const pid = Number.parseInt(String(raw).trim(), 10);
-    return Number.isFinite(pid) && pid > 0 ? pid : null;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * 判断 city 后台进程是否存活。
- */
-export function isCityProcessAlive(pid: number): boolean {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * 判断 city 后台是否在运行（基于 pid file + 判活）。
- */
-export async function isCityRunning(): Promise<boolean> {
-  const pid = await readCityPid();
-  if (!pid) return false;
-  return isCityProcessAlive(pid);
-}

package/src/runtime/PluginRuntime.ts

@@ -1,42 +0,0 @@
-/**
- * PluginRuntime：city 级 plugin 运行时注入模块。
- *
- * 关键点（中文）
- * - PluginRegistry / PluginManager 属于 city runtime，不应直接反向 import agent AgentContext 单例。
- * - 当前模块只负责保存“当前执行上下文 resolver”的注入入口。
- * - agent runtime 仅作为 context provider 注册方，不再成为 plugin manager 的宿主。
- */
-
-import type { AgentContext } from "@/types/agent/AgentContext.js";
-
-type AgentContextResolver = () => AgentContext;
-
-let executionContextResolver: AgentContextResolver | null = null;
-
-/**
- * 设置当前 city plugin runtime 的执行上下文 resolver。
- */
-export function setPluginRuntimeContextResolver(
-  resolver: AgentContextResolver,
-): void {
-  executionContextResolver = resolver;
-}
-
-/**
- * 清理当前 city plugin runtime 的执行上下文 resolver。
- */
-export function clearPluginRuntimeContextResolver(): void {
-  executionContextResolver = null;
-}
-
-/**
- * 读取当前 city plugin runtime 的执行上下文 resolver。
- */
-export function getPluginRuntimeContextResolver(): AgentContextResolver {
-  if (!executionContextResolver) {
-    throw new Error(
-      "Plugin runtime context resolver is not configured. Configure city plugin runtime before using PluginManager.",
-    );
-  }
-  return executionContextResolver;
-}