@downcity/agent 1.1.71 → 1.1.72

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

@@ -1,150 +0,0 @@
-/**
- * Plugin 路由模块。
- *
- * 职责说明：
- * 1. 提供 plugin catalog / state / availability 接口。
- * 2. 提供 plugin lifecycle 控制接口。
- * 3. 提供 plugin command / action 桥接接口。
- */
-
-import { Hono } from "hono";
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
-import {
-  controlPluginState,
-  listPluginStates,
-} from "@/plugin/core/PluginStateController.js";
-import type { PluginStateControlAction } from "@/plugin/types/Plugin.js";
-import { parsePluginCommandRequestBody } from "@/plugin/core/PluginCommandRequest.js";
-import { runPluginCommand } from "@/plugin/core/PluginActionRunner.js";
-
-/**
- * Plugin 路由参数。
- */
-type PluginsRouterOptions = {
-  /**
-   * 读取当前 agent 执行上下文。
-   */
-  getAgentContext: () => AgentContext;
-};
-
-/**
- * 创建 plugin 路由。
- */
-export function createPluginsRouter(
-  options: PluginsRouterOptions,
-): Hono {
-  const router = new Hono();
-
-  router.get("/api/plugins/catalog", (c) => {
-    return c.json({
-      success: true,
-      plugins: options.getAgentContext().plugins.list(),
-    });
-  });
-
-  router.get("/api/plugins/list", (c) => {
-    return c.json({
-      success: true,
-      plugins: listPluginStates({
-        context: options.getAgentContext(),
-      }),
-    });
-  });
-
-  router.post("/api/plugins/control", async (c) => {
-    const body = await c.req.json().catch(() => null);
-    const pluginName = String(body?.pluginName || "").trim();
-    const action = String(body?.action || "")
-      .trim()
-      .toLowerCase();
-
-    if (!pluginName) {
-      return c.json({ success: false, error: "pluginName is required" }, 400);
-    }
-    if (!action) {
-      return c.json({ success: false, error: "action is required" }, 400);
-    }
-    if (!["start", "stop", "restart", "status"].includes(action)) {
-      return c.json({ success: false, error: "invalid action" }, 400);
-    }
-
-    const result = await controlPluginState({
-      pluginName,
-      action: action as PluginStateControlAction,
-      context: options.getAgentContext(),
-    });
-    return c.json(result, result.success ? 200 : 400);
-  });
-
-  router.post("/api/plugins/command", async (c) => {
-    const body = await c.req.json().catch(() => null);
-    let requestBody;
-    try {
-      requestBody = parsePluginCommandRequestBody(body);
-    } catch (error) {
-      return c.json({ success: false, error: String(error) }, 400);
-    }
-
-    if (!requestBody.pluginName) {
-      return c.json({ success: false, error: "pluginName is required" }, 400);
-    }
-    if (!requestBody.command) {
-      return c.json({ success: false, error: "command is required" }, 400);
-    }
-
-    const result = await runPluginCommand({
-      pluginName: requestBody.pluginName,
-      command: requestBody.command,
-      payload: requestBody.payload,
-      schedule: requestBody.schedule,
-      context: options.getAgentContext(),
-    });
-    return c.json(result, result.success ? 200 : 400);
-  });
-
-  router.post("/api/plugins/availability", async (c) => {
-    const body = await c.req.json().catch(() => null);
-    const pluginName = String(body?.pluginName || "").trim();
-
-    if (!pluginName) {
-      return c.json({ success: false, error: "pluginName is required" }, 400);
-    }
-
-    const availability =
-      await options.getAgentContext().plugins.availability(pluginName);
-    return c.json({
-      success: true,
-      pluginName,
-      availability,
-    });
-  });
-
-  router.post("/api/plugins/action", async (c) => {
-    const body = await c.req.json().catch(() => null);
-    const pluginName = String(body?.pluginName || "").trim();
-    const actionName = String(body?.actionName || "").trim();
-
-    if (!pluginName) {
-      return c.json({ success: false, error: "pluginName is required" }, 400);
-    }
-    if (!actionName) {
-      return c.json({ success: false, error: "actionName is required" }, 400);
-    }
-
-    const result = await options.getAgentContext().plugins.runAction({
-      plugin: pluginName,
-      action: actionName,
-      payload: body?.payload,
-    });
-    return c.json(
-      {
-        ...result,
-        pluginName,
-        actionName,
-      },
-      result.success ? 200 : 400,
-    );
-  });
-
-  return router;
-}

package/src/runtime/server/http/sdk/Router.ts

@@ -1,22 +0,0 @@
-/**
- * SDK HTTP 路由入口模块。
- *
- * 关键点（中文）
- * - 这里专门承载 `RemoteAgent` 对应的最小 SDK transport。
- * - 路由面围绕 Session actor 公开能力展开，不混入 control UI 语义。
- */
-
-import { Hono } from "hono";
-import type { AgentSessionCollection } from "@/types/agent/AgentTypes.js";
-import { registerSdkSessionRoutes } from "@/runtime/server/http/sdk/SessionRoutes.js";
-
-/**
- * 创建 SDK HTTP router。
- */
-export function createSdkRouter(
-  sessionCollection: AgentSessionCollection,
-): Hono {
-  const router = new Hono();
-  registerSdkSessionRoutes(router, sessionCollection);
-  return router;
-}

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

@@ -1,300 +0,0 @@
-/**
- * SDK HTTP session 路由。
- *
- * 关键点（中文）
- * - 这组路由面向 `RemoteAgent`，只暴露最小 Session actor 使用面。
- * - 当前公开输入收口到 `prompt()`，公开输出收口到 `events` 长连接。
- * - 不复用 control API 的控制台语义，避免 transport 面混入非 SDK 约束。
- */
-
-import { Hono } from "hono";
-import type {
-  AgentListSessionsInput,
-  AgentSessionCollection,
-} from "@/types/agent/AgentTypes.js";
-import type { AgentSessionPromptInput } from "@/types/sdk/AgentSessionPrompt.js";
-import type { AgentSessionEvent } from "@/types/sdk/AgentSessionEvent.js";
-
-const NDJSON_CONTENT_TYPE = "application/x-ndjson; charset=utf-8";
-const SDK_EVENTS_READY_FRAME = {
-  type: "sdk-events-ready",
-} as const;
-
-/**
- * 注册 SDK session 路由。
- */
-export function registerSdkSessionRoutes(
-  app: Hono,
-  sessionCollection: AgentSessionCollection,
-): void {
-  app.get("/api/sdk/sessions", async (c) => {
-    try {
-      const input: AgentListSessionsInput = {
-        ...(c.req.query("limit") ? { limit: Number(c.req.query("limit")) } : {}),
-        ...(c.req.query("cursor") ? { cursor: c.req.query("cursor") } : {}),
-        ...(c.req.query("query") ? { query: c.req.query("query") } : {}),
-      };
-      const page = await sessionCollection.listSessions(input);
-      return c.json({
-        success: true,
-        page,
-        sessions: page.items,
-      });
-    } catch (error) {
-      return c.json(
-        {
-          success: false,
-          error: error instanceof Error ? error.message : String(error),
-        },
-        500,
-      );
-    }
-  });
-
-  app.post("/api/sdk/sessions", async (c) => {
-    try {
-      const body = (await c.req.json().catch(() => ({}))) as {
-        sessionId?: unknown;
-      };
-      const session = await sessionCollection.createSession({
-        ...(body.sessionId ? { sessionId: String(body.sessionId).trim() } : {}),
-      });
-      return c.json({
-        success: true,
-        session: await session.getInfo(),
-      });
-    } catch (error) {
-      return c.json(
-        {
-          success: false,
-          error: error instanceof Error ? error.message : String(error),
-        },
-        500,
-      );
-    }
-  });
-
-  app.get("/api/sdk/sessions/:sessionId", async (c) => {
-    try {
-      const sessionId = String(c.req.param("sessionId") || "").trim();
-      if (!sessionId) {
-        return c.json({ success: false, error: "Missing sessionId" }, 400);
-      }
-      const session = await sessionCollection.getSession(sessionId);
-      return c.json({
-        success: true,
-        session: await session.getInfo(),
-      });
-    } catch (error) {
-      return c.json(
-        {
-          success: false,
-          error: error instanceof Error ? error.message : String(error),
-        },
-        500,
-      );
-    }
-  });
-
-  app.post("/api/sdk/sessions/:sessionId/prompt", async (c) => {
-    try {
-      const sessionId = String(c.req.param("sessionId") || "").trim();
-      if (!sessionId) {
-        return c.json({ success: false, error: "Missing sessionId" }, 400);
-      }
-      const body = (await c.req.json()) as AgentSessionPromptInput;
-      const session = await sessionCollection.getSession(sessionId);
-      const turn = await session.prompt(body);
-      return c.json({
-        success: true,
-        turn: {
-          id: turn.id,
-        },
-      });
-    } catch (error) {
-      return c.json(
-        {
-          success: false,
-          error: error instanceof Error ? error.message : String(error),
-        },
-        500,
-      );
-    }
-  });
-
-  app.get("/api/sdk/sessions/:sessionId/events", async (c) => {
-    const sessionId = String(c.req.param("sessionId") || "").trim();
-    if (!sessionId) {
-      return c.json({ success: false, error: "Missing sessionId" }, 400);
-    }
-
-    try {
-      const session = await sessionCollection.getSession(sessionId);
-      const encoder = new TextEncoder();
-      const requestSignal = c.req.raw.signal;
-
-      let cleanupEventsConnection = (): void => {};
-      const stream = new ReadableStream<Uint8Array>({
-        cancel() {
-          cleanupEventsConnection();
-        },
-        start(controller) {
-          const writeLine = (value: unknown): void => {
-            controller.enqueue(encoder.encode(`${JSON.stringify(value)}\n`));
-          };
-
-          const unsubscribe = session.subscribe((event) => {
-            writeLine(event);
-          });
-
-          const closeStream = (): void => {
-            cleanupEventsConnection();
-            try {
-              controller.close();
-            } catch {
-              // ignore duplicate close attempts
-            }
-          };
-
-          cleanupEventsConnection = (): void => {
-            unsubscribe();
-            requestSignal.removeEventListener("abort", closeStream);
-          };
-
-          if (requestSignal.aborted) {
-            closeStream();
-            return;
-          }
-
-          requestSignal.addEventListener("abort", closeStream, { once: true });
-          writeLine(SDK_EVENTS_READY_FRAME);
-        },
-      });
-
-      return new Response(stream, {
-        status: 200,
-        headers: {
-          "Content-Type": NDJSON_CONTENT_TYPE,
-          "Cache-Control": "no-cache, no-transform",
-          "X-Accel-Buffering": "no",
-        },
-      });
-    } catch (error) {
-      return c.json(
-        {
-          success: false,
-          error: error instanceof Error ? error.message : String(error),
-        },
-        500,
-      );
-    }
-  });
-
-  app.get("/api/sdk/sessions/:sessionId/history", async (c) => {
-    try {
-      const sessionId = String(c.req.param("sessionId") || "").trim();
-      if (!sessionId) {
-        return c.json({ success: false, error: "Missing sessionId" }, 400);
-      }
-      const session = await sessionCollection.getSession(sessionId);
-      const history = await session.history({
-        ...(c.req.query("limit") ? { limit: Number(c.req.query("limit")) } : {}),
-        ...(c.req.query("cursor") ? { cursor: c.req.query("cursor") } : {}),
-        ...(c.req.query("order")
-          ? { order: c.req.query("order") as "asc" | "desc" }
-          : {}),
-        ...(c.req.query("view")
-          ? { view: c.req.query("view") as "message" | "timeline" }
-          : {}),
-      });
-      return c.json({
-        success: true,
-        history,
-      });
-    } catch (error) {
-      return c.json(
-        {
-          success: false,
-          error: error instanceof Error ? error.message : String(error),
-        },
-        500,
-      );
-    }
-  });
-
-  app.get("/api/sdk/sessions/:sessionId/messages", async (c) => {
-    try {
-      const sessionId = String(c.req.param("sessionId") || "").trim();
-      if (!sessionId) {
-        return c.json({ success: false, error: "Missing sessionId" }, 400);
-      }
-      const session = await sessionCollection.getSession(sessionId);
-      const history = await session.history({
-        view: "message",
-      });
-      return c.json({
-        success: true,
-        messages: history.items,
-        history,
-      });
-    } catch (error) {
-      return c.json(
-        {
-          success: false,
-          error: error instanceof Error ? error.message : String(error),
-        },
-        500,
-      );
-    }
-  });
-
-  app.get("/api/sdk/sessions/:sessionId/system", async (c) => {
-    try {
-      const sessionId = String(c.req.param("sessionId") || "").trim();
-      if (!sessionId) {
-        return c.json({ success: false, error: "Missing sessionId" }, 400);
-      }
-      const session = await sessionCollection.getSession(sessionId);
-      return c.json({
-        success: true,
-        system: await session.system(),
-      });
-    } catch (error) {
-      return c.json(
-        {
-          success: false,
-          error: error instanceof Error ? error.message : String(error),
-        },
-        500,
-      );
-    }
-  });
-
-  app.post("/api/sdk/sessions/:sessionId/fork", async (c) => {
-    try {
-      const sessionId = String(c.req.param("sessionId") || "").trim();
-      if (!sessionId) {
-        return c.json({ success: false, error: "Missing sessionId" }, 400);
-      }
-      const body = (await c.req.json().catch(() => ({}))) as {
-        messageId?: unknown;
-      };
-      const session = await sessionCollection.getSession(sessionId);
-      const forked = await session.fork(
-        String(body.messageId || "").trim() || undefined,
-      );
-      return c.json({
-        success: true,
-        session: await forked.getInfo(),
-      });
-    } catch (error) {
-      return c.json(
-        {
-          success: false,
-          error: error instanceof Error ? error.message : String(error),
-        },
-        500,
-      );
-    }
-  });
-}

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

@@ -1,120 +0,0 @@
-/**
- * 静态资源路由模块。
- *
- * 职责说明：
- * 1. 提供根目录前端静态文件访问。
- * 2. 提供 `.downcity/public` 的受限文件暴露。
- * 3. 只处理静态资源协议，不承载业务逻辑。
- */
-
-import { Hono } from "hono";
-import fs from "fs-extra";
-import path from "path";
-import { getDowncityPublicDirPath } from "@/config/Paths.js";
-import type { AgentRuntime } from "@/types/runtime/agent/AgentRuntime.js";
-
-/**
- * 静态资源路由参数。
- */
-type StaticRouterOptions = {
-  /**
-   * 读取当前 agent runtime。
-   */
-  getAgentRuntime: () => AgentRuntime;
-};
-
-/**
- * 创建静态资源路由。
- */
-export function createStaticRouter(
-  options: StaticRouterOptions,
-): Hono {
-  const router = new Hono();
-
-  router.get("/", async (c) => {
-    const indexPath = path.join(options.getAgentRuntime().rootPath, "public", "index.html");
-    if (await fs.pathExists(indexPath)) {
-      const content = await fs.readFile(indexPath, "utf-8");
-      return c.body(content, 200, {
-        "Content-Type": "text/html; charset=utf-8",
-        "Cache-Control": "no-cache",
-      });
-    }
-    return c.text("Downcity Agent Server", 200);
-  });
-
-  router.get("/styles.css", async (c) => {
-    const cssPath = path.join(options.getAgentRuntime().rootPath, "public", "styles.css");
-    if (await fs.pathExists(cssPath)) {
-      const content = await fs.readFile(cssPath, "utf-8");
-      return c.body(content, 200, {
-        "Content-Type": "text/css; charset=utf-8",
-        "Cache-Control": "no-cache",
-      });
-    }
-    return c.text("Not Found", 404);
-  });
-
-  router.get("/app.js", async (c) => {
-    const jsPath = path.join(options.getAgentRuntime().rootPath, "public", "app.js");
-    if (await fs.pathExists(jsPath)) {
-      const content = await fs.readFile(jsPath, "utf-8");
-      return c.body(content, 200, {
-        "Content-Type": "application/javascript; charset=utf-8",
-        "Cache-Control": "no-cache",
-      });
-    }
-    return c.text("Not Found", 404);
-  });
-
-  router.get("/downcity/public/*", async (c) => {
-    const root = getDowncityPublicDirPath(options.getAgentRuntime().rootPath);
-    const prefix = "/downcity/public/";
-    const requestPath = c.req.path;
-    const rel = requestPath.startsWith(prefix)
-      ? requestPath.slice(prefix.length)
-      : "";
-    if (!rel) return c.text("Not Found", 404);
-
-    const full = path.resolve(root, rel);
-    const rootResolved = path.resolve(root);
-    if (full !== rootResolved && !full.startsWith(rootResolved + path.sep)) {
-      return c.text("Forbidden", 403);
-    }
-
-    try {
-      const stat = await fs.stat(full);
-      if (!stat.isFile()) return c.text("Not Found", 404);
-    } catch {
-      return c.text("Not Found", 404);
-    }
-
-    const ext = path.extname(full).toLowerCase();
-    const contentType =
-      ext === ".html"
-        ? "text/html; charset=utf-8"
-        : ext === ".css"
-          ? "text/css; charset=utf-8"
-          : ext === ".js"
-            ? "application/javascript; charset=utf-8"
-            : ext === ".json"
-              ? "application/json; charset=utf-8"
-              : ext === ".txt" || ext === ".md"
-                ? "text/plain; charset=utf-8"
-                : ext === ".pdf"
-                  ? "application/pdf"
-                  : ext === ".png"
-                    ? "image/png"
-                    : ext === ".jpg" || ext === ".jpeg"
-                      ? "image/jpeg"
-                      : "application/octet-stream";
-
-    const buf = await fs.readFile(full);
-    return c.body(buf, 200, {
-      "Content-Type": contentType,
-      "Cache-Control": "no-cache",
-    });
-  });
-
-  return router;
-}

package/src/types/runtime/daemon/Daemon.ts

@@ -1,53 +0,0 @@
-/**
- * 后台常驻（daemon）相关类型与常量。
- *
- * 关键点（中文）
- * - 这里统一描述 agent daemon 的 pid/log/meta 文件命名与元信息结构。
- * - city 全局后台的运行时文件命名不放在这里，而是放到 city 包的 process/registry 路径模块。
- */
-
-/** daemon pid 文件名。 */
-export const DAEMON_PID_FILENAME = "downcity.pid";
-/** daemon 日志文件名。 */
-export const DAEMON_LOG_FILENAME = "downcity.daemon.log";
-/** daemon 元数据文件名。 */
-export const DAEMON_META_FILENAME = "downcity.daemon.json";
-
-/**
- * daemon 元数据文件结构。
- */
-export interface DaemonMeta {
-  /** 当前 daemon 进程的操作系统 pid。 */
-  pid: number;
-  /** daemon 所属 agent 项目的绝对路径。 */
-  projectRoot: string;
-  /** daemon 启动时间（ISO 时间字符串）。 */
-  startedAt: string;
-  /** 启动 daemon 时使用的命令。 */
-  command: string;
-  /** 启动 daemon 时使用的参数列表。 */
-  args: string[];
-  /** 当前 node 可执行文件路径。 */
-  node: string;
-  /** 当前运行平台。 */
-  platform: NodeJS.Platform;
-}
-
-/**
- * daemon 进入 stale 状态的诊断项。
- */
-export interface DaemonStaleReason {
-  /**
-   * 机器可读的原因编码。
-   */
-  code:
-    | "process_not_alive"
-    | "meta_missing"
-    | "meta_invalid"
-    | "meta_pid_mismatch"
-    | "meta_project_mismatch";
-  /**
-   * 面向用户展示的原因说明。
-   */
-  message: string;
-}