@downcity/agent 1.1.71 → 1.1.73

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

@@ -1,436 +0,0 @@
-/**
- * Control 任务与日志路由。
- *
- * 关键点（中文）
- * - 聚合 tasks/runs/logs 相关接口。
- * - 任务动作统一复用 task plugin runtime command，不在 UI 层重复实现业务语义。
- */
-
-import fs from "fs-extra";
-import { basename, dirname, join } from "path";
-import { getDowncityTasksDirPath } from "@/config/Paths.js";
-import { runPluginCommand } from "@/plugin/core/Manager.js";
-import type { ControlRouteRegistrationParams } from "@/runtime/server/http/control/types/ControlRoutes.js";
-import {
-  buildControlRouteAliases,
-  decodeMaybe,
-  toLimit,
-  toOptionalString,
-} from "./CommonHelpers.js";
-import {
-  TASK_RUN_DIR_REGEX,
-  listTaskRuns,
-  readRecentLogs,
-  readTaskRunDetail,
-} from "./Helpers.js";
-
-type TaskListItem = {
-  title?: string;
-  status?: string;
-  taskMdPath?: string;
-  lastRunTimestamp?: string;
-  [key: string]: unknown;
-};
-
-function resolveTaskIdFromTaskMdPath(taskMdPath: unknown): string {
-  const text = String(taskMdPath || "").trim();
-  if (!text) return "";
-  return basename(dirname(text));
-}
-
-async function listTasksViaPlugin(params: {
-  routes: ControlRouteRegistrationParams;
-  status?: string;
-}): Promise<TaskListItem[]> {
-  const result = await params.routes.getAgentContext().plugins.runAction({
-    plugin: "task",
-    action: "list",
-    payload: params.status ? { status: params.status } : undefined,
-  });
-  if (!result.success) {
-    throw new Error(result.error || result.message || "task list failed");
-  }
-  const data =
-    result.data && typeof result.data === "object" && !Array.isArray(result.data)
-      ? result.data as { tasks?: TaskListItem[] }
-      : {};
-  return Array.isArray(data.tasks) ? data.tasks : [];
-}
-
-async function resolveTaskIdByTitleViaPlugin(params: {
-  routes: ControlRouteRegistrationParams;
-  title: string;
-}): Promise<string> {
-  const title = String(params.title || "").trim();
-  const tasks = await listTasksViaPlugin({ routes: params.routes });
-  const matched = tasks.filter((task) => String(task.title || "").trim() === title);
-  if (matched.length !== 1) throw new Error(`Task not found: ${title}`);
-  const taskId = resolveTaskIdFromTaskMdPath(matched[0]?.taskMdPath);
-  if (!taskId) throw new Error(`Task id not found: ${title}`);
-  return taskId;
-}
-
-/**
- * 读取任务当前是否仍在执行。
- */
-async function readTaskRunningState(params: {
-  projectRoot: string;
-  routes: ControlRouteRegistrationParams;
-  title: string;
-  lastRunTimestamp?: string;
-}): Promise<boolean> {
-  const title = String(params.title || "").trim();
-  const timestamp = String(params.lastRunTimestamp || "").trim();
-  if (!title || !timestamp || !TASK_RUN_DIR_REGEX.test(timestamp)) return false;
-
-  let taskId = "";
-  try {
-    taskId = await resolveTaskIdByTitleViaPlugin({
-      routes: params.routes,
-      title,
-    });
-  } catch {
-    return false;
-  }
-
-  const progressPath = join(
-    getDowncityTasksDirPath(params.projectRoot),
-    taskId,
-    timestamp,
-    "run-progress.json",
-  );
-  const progress = (await fs.readJson(progressPath).catch(() => null)) as {
-    status?: string;
-  } | null;
-  return String(progress?.status || "").trim().toLowerCase() === "running";
-}
-
-/**
- * 注册任务与日志路由。
- */
-export function registerControlTaskRoutes(
-  params: ControlRouteRegistrationParams,
-): void {
-  const { app } = params;
-
-  for (const routePath of buildControlRouteAliases("/tasks")) {
-    app.get(routePath, async (c) => {
-      try {
-        const runtime = params.getAgentRuntime();
-        const status = toOptionalString(c.req.query("status"));
-        const tasks = await listTasksViaPlugin({
-          routes: params,
-          ...(status ? { status } : {}),
-        });
-        const tasksWithRunning = await Promise.all(
-          tasks.map(async (task) => {
-            const running = await readTaskRunningState({
-              projectRoot: runtime.rootPath,
-              routes: params,
-              title: String(task.title || "").trim(),
-              lastRunTimestamp: task.lastRunTimestamp,
-            });
-            return running ? { ...task, running } : task;
-          }),
-        );
-        return c.json({
-          success: true,
-          tasks: tasksWithRunning,
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/tasks/run")) {
-    app.post(routePath, async (c) => {
-      try {
-        const body = (await c.req.json().catch(() => ({}))) as {
-          title?: string;
-          reason?: string;
-        };
-        const title = String(body.title || "").trim();
-        if (!title) {
-          return c.json({ success: false, error: "Invalid title" }, 400);
-        }
-
-        const reason = toOptionalString(body.reason);
-        const result = await runPluginCommand({
-          pluginName: "task",
-          command: "run",
-          payload: {
-            title,
-            ...(reason ? { reason } : {}),
-          },
-          context: params.getAgentContext(),
-        });
-        return c.json(result, result.success ? 200 : 400);
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/tasks/:title/status")) {
-    app.post(routePath, async (c) => {
-      try {
-        const title = decodeMaybe(String(c.req.param("title") || "").trim());
-        const body = (await c.req.json().catch(() => ({}))) as {
-          status?: string;
-        };
-        const status = String(body.status || "").trim();
-        if (!title) {
-          return c.json({ success: false, error: "Invalid title" }, 400);
-        }
-        if (!["enabled", "paused", "disabled"].includes(status)) {
-          return c.json({ success: false, error: "Invalid status" }, 400);
-        }
-
-        const result = await runPluginCommand({
-          pluginName: "task",
-          command: "status",
-          payload: {
-            title,
-            status,
-          },
-          context: params.getAgentContext(),
-        });
-        if (!result.success) {
-          return c.json(
-            { success: false, error: result.message || "task status update failed" },
-            400,
-          );
-        }
-        const data =
-          result.data && typeof result.data === "object" && !Array.isArray(result.data)
-            ? result.data
-            : {};
-        return c.json({
-          success: true,
-          ...data,
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/tasks/:title")) {
-    app.delete(routePath, async (c) => {
-      try {
-        const title = decodeMaybe(String(c.req.param("title") || "").trim());
-        if (!title) {
-          return c.json({ success: false, error: "Invalid title" }, 400);
-        }
-
-        const result = await runPluginCommand({
-          pluginName: "task",
-          command: "delete",
-          payload: {
-            title,
-          },
-          context: params.getAgentContext(),
-        });
-        if (!result.success) {
-          return c.json({ success: false, error: result.message || "task delete failed" }, 400);
-        }
-        const data =
-          result.data && typeof result.data === "object" && !Array.isArray(result.data)
-            ? result.data
-            : {};
-        return c.json({
-          success: true,
-          ...data,
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/tasks/:title/runs/:timestamp")) {
-    app.delete(routePath, async (c) => {
-      try {
-        const runtime = params.getAgentRuntime();
-        const title = decodeMaybe(String(c.req.param("title") || "").trim());
-        const timestamp = String(c.req.param("timestamp") || "").trim();
-        if (!title) {
-          return c.json({ success: false, error: "Invalid title" }, 400);
-        }
-        if (!TASK_RUN_DIR_REGEX.test(timestamp)) {
-          return c.json({ success: false, error: "Invalid timestamp" }, 400);
-        }
-
-        let taskId = "";
-        try {
-          taskId = await resolveTaskIdByTitleViaPlugin({
-            routes: params,
-            title,
-          });
-        } catch {
-          return c.json({ success: false, error: "Task not found" }, 404);
-        }
-        const runDir = join(getDowncityTasksDirPath(runtime.rootPath), taskId, timestamp);
-        if (!(await fs.pathExists(runDir))) {
-          return c.json({ success: false, error: "Run not found" }, 404);
-        }
-
-        const progressPath = join(runDir, "run-progress.json");
-        const progress = (await fs.readJson(progressPath).catch(() => null)) as {
-          status?: string;
-        } | null;
-        if (String(progress?.status || "").trim().toLowerCase() === "running") {
-          return c.json(
-            { success: false, error: "Run is still in progress and cannot be deleted" },
-            409,
-          );
-        }
-
-        await fs.remove(runDir);
-        return c.json({
-          success: true,
-          title,
-          timestamp,
-          deleted: true,
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/tasks/:title/runs")) {
-    app.delete(routePath, async (c) => {
-      try {
-        const runtime = params.getAgentRuntime();
-        const title = decodeMaybe(String(c.req.param("title") || "").trim());
-        if (!title) {
-          return c.json({ success: false, error: "Invalid title" }, 400);
-        }
-
-        let taskId = "";
-        try {
-          taskId = await resolveTaskIdByTitleViaPlugin({
-            routes: params,
-            title,
-          });
-        } catch {
-          return c.json({ success: false, error: "Task not found" }, 404);
-        }
-
-        const taskDir = join(getDowncityTasksDirPath(runtime.rootPath), taskId);
-        if (!(await fs.pathExists(taskDir))) {
-          return c.json({
-            success: true,
-            title,
-            deletedCount: 0,
-            skippedRunningCount: 0,
-            deletedTimestamps: [],
-            skippedRunningTimestamps: [],
-          });
-        }
-
-        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();
-        const deletedTimestamps: string[] = [];
-        const skippedRunningTimestamps: string[] = [];
-
-        for (const timestamp of timestamps) {
-          const runDir = join(taskDir, timestamp);
-          const progressPath = join(runDir, "run-progress.json");
-          const progress = (await fs.readJson(progressPath).catch(() => null)) as {
-            status?: string;
-          } | null;
-          if (String(progress?.status || "").trim().toLowerCase() === "running") {
-            skippedRunningTimestamps.push(timestamp);
-            continue;
-          }
-          await fs.remove(runDir);
-          deletedTimestamps.push(timestamp);
-        }
-
-        return c.json({
-          success: true,
-          title,
-          deletedCount: deletedTimestamps.length,
-          skippedRunningCount: skippedRunningTimestamps.length,
-          deletedTimestamps,
-          skippedRunningTimestamps,
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-
-    app.get(routePath, async (c) => {
-      try {
-        const runtime = params.getAgentRuntime();
-        const title = decodeMaybe(String(c.req.param("title") || "").trim());
-        if (!title) {
-          return c.json({ success: false, error: "Invalid title" }, 400);
-        }
-
-        const limit = toLimit(c.req.query("limit"), 50);
-        const runs = await listTaskRuns({
-          projectRoot: runtime.rootPath,
-          title,
-          limit,
-        });
-        return c.json({ success: true, title, runs });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/tasks/:title/runs/:timestamp")) {
-    app.get(routePath, async (c) => {
-      try {
-        const runtime = params.getAgentRuntime();
-        const title = decodeMaybe(String(c.req.param("title") || "").trim());
-        const timestamp = String(c.req.param("timestamp") || "").trim();
-        if (!title) {
-          return c.json({ success: false, error: "Invalid title" }, 400);
-        }
-        if (!TASK_RUN_DIR_REGEX.test(timestamp)) {
-          return c.json({ success: false, error: "Invalid timestamp" }, 400);
-        }
-
-        const detail = await readTaskRunDetail({
-          projectRoot: runtime.rootPath,
-          title,
-          timestamp,
-        });
-        if (!detail) {
-          return c.json({ success: false, error: "Run not found" }, 404);
-        }
-        return c.json({ success: true, ...detail });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/logs")) {
-    app.get(routePath, async (c) => {
-      try {
-        const runtime = params.getAgentRuntime();
-        const limit = toLimit(c.req.query("limit"), 200);
-        const logs = await readRecentLogs({
-          projectRoot: runtime.rootPath,
-          limit,
-        });
-        return c.json({
-          success: true,
-          logs,
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-}

package/src/runtime/server/http/control/types/ControlRoutes.ts

@@ -1,31 +0,0 @@
-/**
- * Control 路由注册类型定义。
- *
- * 关键点（中文）
- * - 统一描述单 agent 控制面路由的公共依赖。
- * - 各路由模块共享同一份入参，避免重复声明与漂移。
- */
-
-import type { Hono } from "hono";
-import type { AgentRuntime } from "@/types/runtime/agent/AgentRuntime.js";
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
-
-/**
- * Control 路由注册入参。
- */
-export interface ControlRouteRegistrationParams {
-  /**
-   * Hono 应用实例。
-   */
-  app: Hono;
-
-  /**
-   * 读取当前 agent 状态。
-   */
-  getAgentRuntime: () => AgentRuntime;
-
-  /**
-   * 读取当前统一执行上下文。
-   */
-  getAgentContext: () => AgentContext;
-}

package/src/runtime/server/http/execute/execute.ts

@@ -1,97 +0,0 @@
-/**
- * 执行入口路由模块。
- *
- * 职责说明：
- * 1. 接收 `/api/execute` 请求。
- * 2. 完成请求解析、context 注入、agent 执行与结果回写。
- * 3. 统一处理接口层错误返回。
- */
-
-import { Hono } from "hono";
-import type { AgentRuntime } from "@/types/runtime/agent/AgentRuntime.js";
-
-/**
- * 执行入口路由参数。
- */
-type ExecuteRouterOptions = {
-  /**
-   * 读取当前 agent runtime。
-   */
-  getAgentRuntime: () => AgentRuntime;
-};
-
-/**
- * 创建执行入口路由。
- */
-export function createExecuteRouter(
-  options: ExecuteRouterOptions,
-): Hono {
-  const router = new Hono();
-
-  router.post("/api/execute", async (c) => {
-    let bodyText = "";
-    try {
-      bodyText = await c.req.text();
-    } catch {
-      return c.json(
-        { success: false, message: "Unable to read request body" },
-        400,
-      );
-    }
-
-    if (!bodyText) {
-      return c.json({ success: false, message: "Request body is empty" }, 400);
-    }
-
-    let body: {
-      instructions?: string;
-      chatId?: string;
-      userId?: string;
-      actorId?: string;
-      messageId?: string;
-    };
-    try {
-      body = JSON.parse(bodyText) as typeof body;
-    } catch {
-      return c.json(
-        {
-          success: false,
-          message: `JSON parse failed: ${bodyText.substring(0, 50)}...`,
-        },
-        400,
-      );
-    }
-
-    const instructions = body?.instructions;
-    const chatId =
-      typeof body?.chatId === "string" && body.chatId.trim()
-        ? body.chatId.trim()
-        : "default";
-    if (!instructions) {
-      return c.json(
-        { success: false, message: "Missing instructions field" },
-        400,
-      );
-    }
-
-    try {
-      const sessionId = `api:chat:${chatId}`;
-      const agentState = options.getAgentRuntime();
-      const session = agentState.getSession(sessionId);
-      const turn = await session.prompt({
-        query: String(instructions),
-      });
-      const result = await turn.finished;
-
-      return c.json({
-        success: result.success,
-        ...(result.error ? { error: result.error } : {}),
-        assistantMessage: result.assistantMessage,
-      });
-    } catch (error) {
-      return c.json({ success: false, message: String(error) }, 500);
-    }
-  });
-
-  return router;
-}

package/src/runtime/server/http/health/health.ts

@@ -1,27 +0,0 @@
-/**
- * 健康检查路由模块。
- *
- * 职责说明：
- * 1. 提供基础健康检查接口。
- * 2. 提供当前进程状态接口。
- * 3. 不依赖业务域实现。
- */
-
-import { Hono } from "hono";
-
-/**
- * 健康检查路由。
- */
-export const healthRouter = new Hono();
-
-healthRouter.get("/health", (c) => {
-  return c.json({ status: "ok", timestamp: new Date().toISOString() });
-});
-
-healthRouter.get("/api/status", (c) => {
-  return c.json({
-    name: "downcity",
-    status: "running",
-    timestamp: new Date().toISOString(),
-  });
-});