@downcity/agent 1.1.70 → 1.1.72

package/src/runtime/server/http/control/ControlRouter.ts

@@ -1,47 +0,0 @@
-/**
- * Agent Control API 路由入口模块。
- *
- * 职责说明：
- * 1. 为单 agent control API 暴露独立 router。
- * 2. 将控制域的 API 装配收敛在 `server/http/control/` 下。
- * 3. server 只负责挂载该 router，不再持有控制面细节。
- *
- * 命名说明（中文）
- * - 这里的 control 指“单 agent 控制域”。
- * - 它不是 city 的 gateway / control plane。
- * - 当前公开路径统一使用 `/api/control/*`。
- */
-
-import { Hono } from "hono";
-import type { AgentRuntime } from "@/types/runtime/agent/AgentRuntime.js";
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
-import { registerControlApiRoutes } from "@/runtime/server/http/control/ControlApiRoutes.js";
-
-/**
- * control router 参数。
- */
-type ControlRouterOptions = {
-  /**
-   * 读取当前 agent runtime。
-   */
-  getAgentRuntime: () => AgentRuntime;
-  /**
-   * 读取当前 agent 执行上下文。
-   */
-  getAgentContext: () => AgentContext;
-};
-
-/**
- * 创建单 agent control API 专用路由。
- */
-export function createControlRouter(
-  options: ControlRouterOptions,
-): Hono {
-  const router = new Hono();
-  registerControlApiRoutes({
-    app: router,
-    getAgentRuntime: options.getAgentRuntime,
-    getAgentContext: options.getAgentContext,
-  });
-  return router;
-}

package/src/runtime/server/http/control/OverviewRoutes.ts

@@ -1,115 +0,0 @@
-/**
- * Control 概览路由。
- *
- * 关键点（中文）
- * - 聚合 overview 与 plugin 运行态两块轻量只读接口。
- * - 只负责路由层拼装，不承载复杂业务状态机。
- */
-
-import fs from "fs-extra";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-import { listPluginStates } from "@/plugin/core/Manager.js";
-import { buildControlRouteAliases, toLimit } from "./CommonHelpers.js";
-import { listControlSessionSummaries, readRecentLogs } from "./Helpers.js";
-import type { ControlRouteRegistrationParams } from "@/runtime/server/http/control/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";
-  }
-})();
-
-/**
- * 注册概览与运行态 plugin 路由。
- */
-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,
-          agentId: runtime.paths.agentId,
-          executionContext: params.getAgentContext(),
-          limit: sessionLimit,
-        });
-        const runtimePlugins = listPluginStates({
-          context: params.getAgentContext(),
-        });
-        const taskResult = await params.getAgentContext().plugins.runAction({
-          plugin: "task",
-          action: "list",
-        });
-        const taskData =
-          taskResult.data && typeof taskResult.data === "object" && !Array.isArray(taskResult.data)
-            ? taskResult.data as { tasks?: Array<{ status?: string }> }
-            : {};
-        const tasks = Array.isArray(taskData.tasks) ? taskData.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: {
-            id: runtime.config.id,
-            status: "running",
-          },
-          sessions: {
-            total: sessions.length,
-            items: sessions,
-          },
-          plugins: runtimePlugins,
-          tasks: {
-            total: tasks.length,
-            statusCount,
-          },
-          logs,
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/plugins/list")) {
-    app.get(routePath, (c) => {
-      return c.json({
-        success: true,
-        plugins: listPluginStates({
-          context: params.getAgentContext(),
-        }),
-      });
-    });
-  }
-}

package/src/runtime/server/http/control/SessionRoutes.ts

@@ -1,427 +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 "@executor/composer/system/default/SystemDomain.js";
-import {
-  getDowncityChatHistoryPath,
-  getDowncitySessionMessagesArchiveDirPath,
-  getDowncitySessionMessagesArchivePath,
-  getDowncitySessionMessagesPath,
-} from "@/config/Paths.js";
-import type { ControlSessionExecuteRequestBody } from "@/runtime/server/http/control/types/ControlSessionExecute.js";
-import type { ControlRouteRegistrationParams } from "@/runtime/server/http/control/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,
-          agentId: runtime.paths.agentId,
-          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,
-          runtime.paths.agentId,
-          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,
-          runtime.paths.agentId,
-          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,
-          runtime.paths.agentId,
-          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,
-            runtime.paths.agentId,
-            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,
-          runtime.paths.agentId,
-          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);
-      }
-    });
-  }
-
-}