@downcity/agent 1.1.7 → 1.1.10

package/src/http/control/ModelRoutes.ts

@@ -1,107 +0,0 @@
-/**
- * Control 模型路由。
- *
- * 关键点（中文）
- * - 仅承接当前 agent 视角下的模型展示与切换。
- * - 控制面全局模型池管理仍由 `/api/ui/model*` 处理。
- */
-
-import fs from "fs-extra";
-import { getDowncityJsonPath } from "@/config/Paths.js";
-import { PlatformStore } from "@shared/utils/store/index.js";
-import type { ControlRouteRegistrationParams } from "@/shared/types/ControlRoutes.js";
-import { buildControlRouteAliases } from "@/http/control/CommonHelpers.js";
-
-/**
- * 注册模型相关路由。
- */
-export function registerControlModelRoutes(
-  params: ControlRouteRegistrationParams,
-): void {
-  const { app } = params;
-
-  for (const routePath of buildControlRouteAliases("/model")) {
-    app.get(routePath, async (c) => {
-      try {
-        const agentState = params.getAgentRuntime();
-        const agentPrimaryModelId = String(agentState.config.execution?.type === "api" ? agentState.config.execution.modelId || "" : "").trim();
-        const store = new PlatformStore();
-        const models = store.listModels();
-        const providers = await store.listProviders();
-        const providerMap = new Map(providers.map((x) => [x.id, x] as const));
-        const activeModel = agentPrimaryModelId
-          ? models.find((x) => x.id === agentPrimaryModelId)
-          : undefined;
-        const providerKey = String(activeModel?.providerId || "").trim();
-        const provider = providerKey ? providerMap.get(providerKey) : undefined;
-        const availableModels = models.map((model) => {
-          const providerConfig = providerMap.get(model.providerId);
-          return {
-            id: model.id,
-            name: model.name,
-            providerKey: model.providerId,
-            providerType: String(providerConfig?.type || "").trim(),
-          };
-        });
-        store.close();
-
-        return c.json({
-          success: true,
-          model: {
-            primaryModelId: agentPrimaryModelId,
-            primaryModelName: String(activeModel?.name || "").trim(),
-            providerKey,
-            providerType: String(provider?.type || "").trim(),
-            baseUrl: String(provider?.baseUrl || "").trim(),
-            agentPrimaryModelId,
-            availableModels,
-          },
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/model/switch")) {
-    app.post(routePath, async (c) => {
-      try {
-        const agentState = params.getAgentRuntime();
-        const body = (await c.req.json().catch(() => ({}))) as {
-          primaryModelId?: string;
-        };
-        const nextPrimaryModelId = String(body.primaryModelId || "").trim();
-        if (!nextPrimaryModelId) {
-          return c.json({ success: false, error: "Missing primaryModelId" }, 400);
-        }
-        const store = new PlatformStore();
-        const targetModel = store.getModel(nextPrimaryModelId);
-        store.close();
-        if (!targetModel) {
-          return c.json(
-            { success: false, error: `Model not found: ${nextPrimaryModelId}` },
-            400,
-          );
-        }
-
-        const shipJsonPath = getDowncityJsonPath(agentState.rootPath);
-        const agentShip = (await fs.readJson(shipJsonPath)) as {
-          execution?: { type?: string; modelId?: string };
-        };
-        agentShip.execution = { type: "api", modelId: nextPrimaryModelId };
-        await fs.writeJson(shipJsonPath, agentShip, { spaces: 2 });
-
-        agentState.config.execution = { type: "api", modelId: nextPrimaryModelId };
-
-        return c.json({
-          success: true,
-          primaryModelId: nextPrimaryModelId,
-          restartRequired: true,
-          message: "Agent primary model updated. Restart agent to fully apply the new model instance.",
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-}

package/src/http/control/OverviewRoutes.ts

@@ -1,106 +0,0 @@
-/**
- * Control 概览路由。
- *
- * 关键点（中文）
- * - 聚合 overview 与 services 两块轻量只读接口。
- * - 只负责路由层拼装，不承载复杂业务状态机。
- */
-
-import fs from "fs-extra";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-import { listServiceStates } from "@/service/core/Manager.js";
-import { listTaskDefinitions } from "@/service/builtins/task/Action.js";
-import { buildControlRouteAliases, toLimit } from "./CommonHelpers.js";
-import { listControlSessionSummaries, readRecentLogs } from "./Helpers.js";
-import type { ControlRouteRegistrationParams } from "@/shared/types/ControlRoutes.js";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-/**
- * 当前 DC 版本号（用于 Overview 显示）。
- */
-const DC_VERSION = (() => {
-  try {
-    const pkg = fs.readJsonSync(join(__dirname, "../../../package.json")) as {
-      version?: string;
-    };
-    const version = String(pkg?.version || "").trim();
-    return version || "unknown";
-  } catch {
-    return "unknown";
-  }
-})();
-
-/**
- * 注册概览与服务路由。
- */
-export function registerControlOverviewRoutes(
-  params: ControlRouteRegistrationParams,
-): void {
-  const { app } = params;
-
-  for (const routePath of buildControlRouteAliases("/overview")) {
-    app.get(routePath, async (c) => {
-      try {
-        const runtime = params.getAgentRuntime();
-        const sessionLimit = toLimit(
-          c.req.query("sessionLimit") || c.req.query("contextLimit"),
-          20,
-        );
-        const sessions = await listControlSessionSummaries({
-          projectRoot: runtime.rootPath,
-          executionContext: params.getAgentContext(),
-          limit: sessionLimit,
-        });
-        const services = listServiceStates();
-        const taskResult = await listTaskDefinitions({
-          projectRoot: runtime.rootPath,
-        });
-        const tasks = Array.isArray(taskResult.tasks) ? taskResult.tasks : [];
-        const logs = await readRecentLogs({
-          projectRoot: runtime.rootPath,
-          limit: 50,
-        });
-
-        const statusCount = {
-          enabled: tasks.filter((x) => x.status === "enabled").length,
-          paused: tasks.filter((x) => x.status === "paused").length,
-          disabled: tasks.filter((x) => x.status === "disabled").length,
-        };
-
-        return c.json({
-          success: true,
-          cityVersion: DC_VERSION,
-          now: new Date().toISOString(),
-          agent: {
-            name: runtime.config.name,
-            status: "running",
-          },
-          sessions: {
-            total: sessions.length,
-            items: sessions,
-          },
-          services,
-          tasks: {
-            total: tasks.length,
-            statusCount,
-          },
-          logs,
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/services")) {
-    app.get(routePath, (c) => {
-      return c.json({
-        success: true,
-        services: listServiceStates(),
-      });
-    });
-  }
-}

package/src/http/control/SessionRoutes.ts

@@ -1,414 +0,0 @@
-/**
- * 单 agent control API 会话路由。
- *
- * 关键点（中文）
- * - 聚合控制面会话消息、归档、system prompt 与执行相关接口。
- * - 仅负责编排请求与响应；消息读取、时间线映射、执行拼装复用 helper。
- * - 会话控制接口统一暴露在 `/api/control/*` 下。
- */
-
-import type { SystemModelMessage } from "ai";
-import fs from "fs-extra";
-import { dirname } from "path";
-import { resolveSessionSystemMessages } from "@session/composer/system/default/SystemDomain.js";
-import {
-  getDowncityChatHistoryPath,
-  getDowncitySessionMessagesArchiveDirPath,
-  getDowncitySessionMessagesArchivePath,
-  getDowncitySessionMessagesPath,
-} from "@/config/Paths.js";
-import type { ControlSessionExecuteRequestBody } from "@/shared/types/ControlSessionExecute.js";
-import type { ControlRouteRegistrationParams } from "@/shared/types/ControlRoutes.js";
-import {
-  buildControlRouteAliases,
-  decodeMaybe,
-  toLimit,
-} from "./CommonHelpers.js";
-import {
-  listControlSessionSummaries,
-  loadSessionMessagesFromFile,
-  toUiMessageTimeline,
-} from "./Helpers.js";
-import { executeBySessionId } from "./ExecuteBySession.js";
-const CONSOLEUI_SESSION_ID = "consoleui-chat-main";
-
-function normalizeSystemText(input: string | null | undefined): string {
-  return String(input || "").trim();
-}
-
-function toSystemMessageText(message: SystemModelMessage): string {
-  const content = message.content as unknown;
-  if (typeof content === "string") return normalizeSystemText(content);
-  if (!Array.isArray(content)) return "";
-  const parts = content as Array<{ text?: unknown }>;
-  const texts: string[] = [];
-  for (const part of parts) {
-    if (!part || typeof part !== "object") continue;
-    const text = normalizeSystemText(String(part.text || ""));
-    if (!text) continue;
-    texts.push(text);
-  }
-  return texts.join("\n").trim();
-}
-
-/**
- * 把 system messages 转成 control UI 可渲染结构。
- */
-function toSystemPromptPayload(messages: SystemModelMessage[]): {
-  sections: Array<{
-    key: string;
-    title: string;
-    items: Array<{ index: number; content: string }>;
-  }>;
-  totalMessages: number;
-  totalChars: number;
-} {
-  const items = messages
-    .map((message, index) => ({
-      index: index + 1,
-      content: toSystemMessageText(message),
-    }))
-    .filter((item) => item.content);
-  const totalChars = items.reduce(
-    (acc, item) => acc + String(item.content || "").length,
-    0,
-  );
-  return {
-    sections: [
-      {
-        key: "resolved",
-        title: "Resolved System Messages",
-        items,
-      },
-    ],
-    totalMessages: items.length,
-    totalChars,
-  };
-}
-
-/**
- * 注册上下文相关路由。
- */
-export function registerControlSessionRoutes(
-  params: ControlRouteRegistrationParams,
-): void {
-  const { app } = params;
-
-  for (const routePath of buildControlRouteAliases("/sessions")) {
-    app.get(routePath, async (c) => {
-      try {
-        const runtime = params.getAgentRuntime();
-        const limit = toLimit(c.req.query("limit"));
-        const executingSessionIds = new Set<string>(
-          runtime.listExecutingSessionIds(),
-        );
-        const sessions = await listControlSessionSummaries({
-          projectRoot: runtime.rootPath,
-          executionContext: params.getAgentContext(),
-          limit,
-          executingSessionIds,
-        });
-        const hasConsoleSession = sessions.some(
-          (item) => String(item.sessionId || "").trim() === CONSOLEUI_SESSION_ID,
-        );
-        const enrichedSessions = hasConsoleSession
-          ? sessions
-          : [
-              {
-                sessionId: CONSOLEUI_SESSION_ID,
-                messageCount: 0,
-                updatedAt: Date.now(),
-                lastRole: "system" as const,
-                lastText: "consoleui channel",
-                channel: "consoleui",
-                ...(executingSessionIds.has(CONSOLEUI_SESSION_ID) ? { executing: true } : {}),
-              },
-              ...sessions,
-            ];
-        return c.json({
-          success: true,
-          sessions: enrichedSessions,
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/sessions/:sessionId/messages")) {
-    app.get(routePath, async (c) => {
-      try {
-        const runtime = params.getAgentRuntime();
-        const limit = toLimit(c.req.query("limit"), 200);
-        const sessionId = decodeMaybe(String(c.req.param("sessionId") || "").trim());
-        if (!sessionId) {
-          return c.json({ success: false, error: "Missing sessionId" }, 400);
-        }
-
-        const filePath = getDowncitySessionMessagesPath(runtime.rootPath, sessionId);
-        const messages = await loadSessionMessagesFromFile(filePath);
-        const sliced = messages
-          .slice(-limit)
-          .flatMap((message) => toUiMessageTimeline(message));
-        return c.json({
-          success: true,
-          sessionId,
-          total: sliced.length,
-          rawTotal: messages.length,
-          messages: sliced,
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/sessions/:sessionId/messages")) {
-    app.delete(routePath, async (c) => {
-      try {
-        const runtime = params.getAgentRuntime();
-        const sessionId = decodeMaybe(String(c.req.param("sessionId") || "").trim());
-        if (!sessionId) {
-          return c.json({ success: false, error: "Missing sessionId" }, 400);
-        }
-
-        const messagesPath = getDowncitySessionMessagesPath(runtime.rootPath, sessionId);
-        const messagesDirPath = dirname(messagesPath);
-        await fs.remove(messagesDirPath);
-        // 关键点（中文）：清理消息文件后，同步清掉内存中的 session runtime，避免旧上下文继续运行。
-        runtime.getSession(sessionId).clearExecutor();
-
-        return c.json({
-          success: true,
-          sessionId,
-          cleared: true,
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/sessions/:sessionId/chat-history")) {
-    app.delete(routePath, async (c) => {
-      try {
-        const runtime = params.getAgentRuntime();
-        const sessionId = decodeMaybe(String(c.req.param("sessionId") || "").trim());
-        if (!sessionId) {
-          return c.json({ success: false, error: "Missing sessionId" }, 400);
-        }
-
-        const historyPath = getDowncityChatHistoryPath(runtime.rootPath, sessionId);
-        await fs.remove(historyPath);
-
-        return c.json({
-          success: true,
-          sessionId,
-          cleared: true,
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/sessions/:sessionId/archives")) {
-    app.get(routePath, async (c) => {
-      try {
-        const runtime = params.getAgentRuntime();
-        const limit = toLimit(c.req.query("limit"), 100);
-        const sessionId = decodeMaybe(String(c.req.param("sessionId") || "").trim());
-        if (!sessionId) {
-          return c.json({ success: false, error: "Missing sessionId" }, 400);
-        }
-
-        const archiveDirPath = getDowncitySessionMessagesArchiveDirPath(
-          runtime.rootPath,
-          sessionId,
-        );
-        if (!(await fs.pathExists(archiveDirPath))) {
-          return c.json({
-            success: true,
-            sessionId,
-            archives: [],
-          });
-        }
-
-        const entries = await fs.readdir(archiveDirPath, { withFileTypes: true });
-        const archives: Array<{
-          archiveId: string;
-          archivedAt?: number;
-          messageCount: number;
-        }> = [];
-
-        for (const entry of entries) {
-          if (!entry.isFile() || !entry.name.endsWith(".json")) continue;
-          const archiveId = decodeMaybe(entry.name.slice(0, -5));
-          if (!archiveId) continue;
-
-          const archivePath = getDowncitySessionMessagesArchivePath(
-            runtime.rootPath,
-            sessionId,
-            archiveId,
-          );
-          const payload = (await fs.readJson(archivePath).catch(() => null)) as
-            | {
-                archivedAt?: unknown;
-                messages?: unknown;
-              }
-            | null;
-          const archivedAtFromPayload =
-            typeof payload?.archivedAt === "number" &&
-            Number.isFinite(payload.archivedAt)
-              ? payload.archivedAt
-              : undefined;
-          const archivedAtFromStat =
-            typeof archivedAtFromPayload === "number"
-              ? undefined
-              : await fs
-                  .stat(archivePath)
-                  .then((stat) => stat.mtimeMs)
-                  .catch(() => undefined);
-          const messageCount = Array.isArray(payload?.messages)
-            ? payload.messages.length
-            : 0;
-
-          archives.push({
-            archiveId,
-            ...(typeof archivedAtFromPayload === "number"
-              ? { archivedAt: archivedAtFromPayload }
-              : typeof archivedAtFromStat === "number"
-                ? { archivedAt: archivedAtFromStat }
-                : {}),
-            messageCount,
-          });
-        }
-
-        archives.sort((a, b) => (b.archivedAt || 0) - (a.archivedAt || 0));
-
-        return c.json({
-          success: true,
-          sessionId,
-          archives: archives.slice(0, limit),
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/sessions/:sessionId/archives/:archiveId")) {
-    app.get(routePath, async (c) => {
-      try {
-        const runtime = params.getAgentRuntime();
-        const sessionId = decodeMaybe(String(c.req.param("sessionId") || "").trim());
-        const archiveId = decodeMaybe(String(c.req.param("archiveId") || "").trim());
-        if (!sessionId) {
-          return c.json({ success: false, error: "Missing sessionId" }, 400);
-        }
-        if (!archiveId) {
-          return c.json({ success: false, error: "Missing archiveId" }, 400);
-        }
-
-        const archivePath = getDowncitySessionMessagesArchivePath(
-          runtime.rootPath,
-          sessionId,
-          archiveId,
-        );
-        if (!(await fs.pathExists(archivePath))) {
-          return c.json(
-            { success: false, error: `Archive not found: ${archiveId}` },
-            404,
-          );
-        }
-
-        const payload = (await fs.readJson(archivePath).catch(() => null)) as
-          | {
-              archivedAt?: unknown;
-              messages?: unknown;
-            }
-          | null;
-        const archivedAt =
-          typeof payload?.archivedAt === "number" &&
-          Number.isFinite(payload.archivedAt)
-            ? payload.archivedAt
-            : undefined;
-        const archivedMessages = Array.isArray(payload?.messages)
-          ? payload.messages
-          : [];
-        const messages = archivedMessages.flatMap((message) =>
-          toUiMessageTimeline(message as Parameters<typeof toUiMessageTimeline>[0]),
-        );
-
-        return c.json({
-          success: true,
-          sessionId,
-          archiveId,
-          ...(typeof archivedAt === "number" ? { archivedAt } : {}),
-          total: messages.length,
-          rawTotal: archivedMessages.length,
-          messages,
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/system-prompt")) {
-    app.get(routePath, async (c) => {
-      try {
-        const runtime = params.getAgentRuntime();
-        const sessionId =
-          decodeMaybe(String(c.req.query("sessionId") || "").trim()) ||
-          CONSOLEUI_SESSION_ID;
-        const systemMessages = await resolveSessionSystemMessages({
-          projectRoot: runtime.rootPath,
-          sessionId,
-          profile: "chat",
-          staticSystemPrompts: runtime.systems,
-          context: params.getAgentContext(),
-        });
-        return c.json({
-          success: true,
-          sessionId,
-          ...toSystemPromptPayload(systemMessages),
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/sessions/:sessionId/execute")) {
-    app.post(routePath, async (c) => {
-      try {
-        const runtime = params.getAgentRuntime();
-        const sessionId = decodeMaybe(String(c.req.param("sessionId") || "").trim());
-        const body = (await c.req.json().catch(() => ({}))) as Partial<ControlSessionExecuteRequestBody>;
-        const instructions = String(body.instructions || "").trim();
-        if (!sessionId) {
-          return c.json({ success: false, error: "Missing sessionId" }, 400);
-        }
-        if (!instructions) {
-          return c.json({ success: false, error: "Missing instructions" }, 400);
-        }
-
-        const result = await executeBySessionId({
-          agentState: runtime,
-          executionContext: params.getAgentContext(),
-          sessionId,
-          instructions,
-          attachments: Array.isArray(body.attachments) ? body.attachments : undefined,
-        });
-        return c.json({
-          success: true,
-          sessionId,
-          result,
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-}

package/src/http/control/SessionSummaryStore.ts

@@ -1,76 +0,0 @@
-/**
- * Control 会话摘要读取 helper。
- *
- * 关键点（中文）
- * - 负责会话列表聚合。
- * - 只返回控制面视图需要的摘要字段。
- */
-
-import fs from "fs-extra";
-import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import {
-  getDowncitySessionMessagesPath,
-  getDowncitySessionRootDirPath,
-} from "@/config/Paths.js";
-import { readChatMetaBySessionId } from "@/service/builtins/chat/runtime/ChatMetaStore.js";
-import type { ControlSessionSummary } from "@/shared/types/ControlViewData.js";
-import { decodeMaybe, truncateText } from "./CommonHelpers.js";
-import { loadSessionMessagesFromFile, resolveUiMessagePreview } from "./MessageTimeline.js";
-
-/**
- * 枚举控制面所需的 session 摘要。
- */
-export async function listControlSessionSummaries(params: {
-  projectRoot: string;
-  executionContext?: AgentContext;
-  limit: number;
-  executingSessionIds?: Set<string>;
-}): Promise<ControlSessionSummary[]> {
-  const rootDir = getDowncitySessionRootDirPath(params.projectRoot);
-  if (!(await fs.pathExists(rootDir))) return [];
-
-  const entries = await fs.readdir(rootDir, { withFileTypes: true });
-  const items: ControlSessionSummary[] = [];
-
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    const sessionId = decodeMaybe(entry.name);
-    if (!sessionId) continue;
-
-    const filePath = getDowncitySessionMessagesPath(params.projectRoot, sessionId);
-    const messages = await loadSessionMessagesFromFile(filePath);
-    const last = messages.at(-1);
-    const lastTs =
-      typeof last?.metadata?.ts === "number" ? last.metadata.ts : undefined;
-    const stat = await fs
-      .stat(filePath)
-      .then((s) => s)
-      .catch(() => null);
-    const updatedAt = lastTs || (stat ? stat.mtimeMs : undefined);
-    const chatMeta = params.executionContext
-      ? await readChatMetaBySessionId({
-          context: params.executionContext,
-          sessionId,
-        })
-      : null;
-
-    items.push({
-      sessionId,
-      messageCount: messages.length,
-      ...(typeof updatedAt === "number" ? { updatedAt } : {}),
-      ...(last?.role ? { lastRole: last.role } : {}),
-      ...(last
-        ? { lastText: truncateText(resolveUiMessagePreview(last), 180) }
-        : {}),
-      ...(typeof chatMeta?.channel === "string" ? { channel: chatMeta.channel } : {}),
-      ...(typeof chatMeta?.chatId === "string" ? { chatId: chatMeta.chatId } : {}),
-      ...(typeof chatMeta?.chatTitle === "string" ? { chatTitle: chatMeta.chatTitle } : {}),
-      ...(typeof chatMeta?.targetType === "string" ? { chatType: chatMeta.targetType } : {}),
-      ...(typeof chatMeta?.threadId === "number" ? { threadId: chatMeta.threadId } : {}),
-      ...(params.executingSessionIds?.has(sessionId) ? { executing: true } : {}),
-    });
-  }
-
-  items.sort((a, b) => (b.updatedAt || 0) - (a.updatedAt || 0));
-  return items.slice(0, params.limit);
-}