@downcity/agent 1.1.71 → 1.1.73

package/bin/types/config/Start.js

@@ -1,13 +0,0 @@
-/**
- * run/start/restart 命令参数类型。
- *
- * 字段说明（中文）
- * - `port`/`host`：主 API 服务监听地址。
- *   - `agent start/restart` 中的 `port` 由 console 自动分配（CLI 不再暴露 `--port`）。
- * - `rpcPort`：Agent 本机 RPC 监听端口。
- *   - 属于内部启动参数，通常由 city 自动分配，不面向普通用户。
- * - `daemon`：兼容旧参数（显式声明后台/前台）。
- * - `foreground`：显式前台启动。
- */
-export {};
-//# sourceMappingURL=Start.js.map

package/bin/types/config/Start.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Start.js","sourceRoot":"","sources":["../../../src/types/config/Start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/bin/types/runtime/daemon/Daemon.d.ts

@@ -1,46 +0,0 @@
-/**
- * 后台常驻（daemon）相关类型与常量。
- *
- * 关键点（中文）
- * - 这里统一描述 agent daemon 的 pid/log/meta 文件命名与元信息结构。
- * - city 全局后台的运行时文件命名不放在这里，而是放到 city 包的 process/registry 路径模块。
- */
-/** daemon pid 文件名。 */
-export declare const DAEMON_PID_FILENAME = "downcity.pid";
-/** daemon 日志文件名。 */
-export declare const DAEMON_LOG_FILENAME = "downcity.daemon.log";
-/** daemon 元数据文件名。 */
-export declare 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;
-}
-//# sourceMappingURL=Daemon.d.ts.map

package/bin/types/runtime/daemon/Daemon.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Daemon.d.ts","sourceRoot":"","sources":["../../../../src/types/runtime/daemon/Daemon.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sBAAsB;AACtB,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,oBAAoB;AACpB,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,qBAAqB;AACrB,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EACA,mBAAmB,GACnB,cAAc,GACd,cAAc,GACd,mBAAmB,GACnB,uBAAuB,CAAC;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/bin/types/runtime/daemon/Daemon.js

@@ -1,14 +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";
-//# sourceMappingURL=Daemon.js.map

package/bin/types/runtime/daemon/Daemon.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Daemon.js","sourceRoot":"","sources":["../../../../src/types/runtime/daemon/Daemon.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sBAAsB;AACtB,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAClD,oBAAoB;AACpB,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AACzD,qBAAqB;AACrB,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC"}

package/src/runtime/host/daemon/Api.ts

@@ -1,64 +0,0 @@
-/**
- * Daemon API 协议类型模块。
- *
- * 关键点（中文）
- * - 这里描述的是 CLI 与 agent daemon 之间的远程访问契约，不包含具体 HTTP 实现。
- * - plugin runtime 等上层模块只依赖这些协议类型，不需要感知 city/daemon 的内部实现细节。
- * - 该文件属于 agent daemon 访问协议边界，而不是通用 HTTP 类型目录。
- */
-
-import type { JsonValue } from "@/types/common/Json.js";
-
-/**
- * Daemon 服务端点。
- */
-export type DaemonEndpoint = {
-  host: string;
-  port: number;
-  baseUrl: string;
-};
-
-/**
- * Daemon HTTP 方法白名单。
- */
-export type DaemonHttpMethod = "GET" | "POST" | "PUT" | "DELETE";
-
-/**
- * JSON API 调用参数。
- *
- * 关键点（中文）
- * - `projectRoot` 用于解析 downcity.json 与默认 endpoint。
- * - `host/port` 可显式覆盖自动解析结果。
- */
-export type DaemonJsonApiCallParams = {
-  projectRoot: string;
-  path: string;
-  method?: DaemonHttpMethod;
-  body?: JsonValue;
-  /**
-   * 单次调用超时（毫秒）。
-   *
-   * 说明（中文）
-   * - HTTP daemon client 可消费该参数。
-   * - 用于 `session execute`、`plugin command` 这类可能持续几十秒的请求，
-   *   避免被默认短超时误判成“Agent server 未启动”。
-   */
-  timeoutMs?: number;
-  host?: string;
-  port?: number;
-  authToken?: string;
-};
-
-/**
- * JSON API 通用返回结构。
- *
- * 语义（中文）
- * - `success=true` 时读取 `data`。
- * - `success=false` 时读取 `error`（可选 `status`）。
- */
-export type DaemonJsonApiCallResult<T> = {
-  success: boolean;
-  status?: number;
-  data?: T;
-  error?: string;
-};

package/src/runtime/host/daemon/Client.ts

@@ -1,204 +0,0 @@
-/**
- * Daemon API 客户端（process 子模块）。
- *
- * 关键点（中文）
- * - 业务模块统一通过 daemon API 与运行时通信。
- * - HTTP gateway 与本机 RPC 的地址解析分开，避免端口语义混淆。
- */
-
-import fs from "fs-extra";
-import {
-  type DaemonEndpoint,
-  type DaemonJsonApiCallParams,
-  type DaemonJsonApiCallResult,
-} from "./Api.js";
-import {
-  formatCliBearerHeaderValue,
-  resolveCliAuthToken,
-} from "@/runtime/server/http/auth/CliAuthStateStore.js";
-import { getDaemonMetaPath } from "@/runtime/host/daemon/Paths.js";
-import type { JsonObject, JsonValue } from "@/types/common/Json.js";
-
-/**
- * 解析端口值。
- *
- * 关键点（中文）
- * - 仅接受 1~65535 的整数；非法值返回 undefined。
- */
-function parsePortLike(input: string | number | undefined): number | undefined {
-  if (input === undefined || input === null || input === "") return undefined;
-  const raw =
-    typeof input === "number" ? input : Number.parseInt(String(input), 10);
-  if (!Number.isFinite(raw) || Number.isNaN(raw)) return undefined;
-  if (!Number.isInteger(raw) || raw <= 0 || raw > 65535) return undefined;
-  return raw;
-}
-
-/**
- * 归一化 host。
- *
- * 关键点（中文）
- * - `0.0.0.0`/`::` 会转换为 `127.0.0.1`，避免客户端直连通配地址失败。
- */
-function normalizeHost(input: string | undefined): string | undefined {
-  const host = typeof input === "string" ? input.trim() : "";
-  if (!host) return undefined;
-  if (host === "0.0.0.0" || host === "::") return "127.0.0.1";
-  return host;
-}
-
-function parseErrorMessageFromPayload(data: JsonValue | null): string | null {
-  if (!data || typeof data !== "object" || Array.isArray(data)) return null;
-  const payload = data as JsonObject;
-  if (typeof payload.error === "string") return payload.error;
-  if (typeof payload.message === "string") return payload.message;
-  return null;
-}
-
-function pickArgValue(args: string[], key: string): string | undefined {
-  const idx = args.findIndex((item) => String(item).trim() === key);
-  if (idx < 0) return undefined;
-  const next = String(args[idx + 1] || "").trim();
-  return next || undefined;
-}
-
-type ResolveDaemonEndpointParams = {
-  projectRoot: string;
-  host?: string;
-  port?: number;
-};
-
-function resolveDaemonEndpointFromSources(params: {
-  projectRoot: string;
-  explicit_host?: string;
-  explicit_port?: number;
-  env_host_name: string;
-  env_port_name: string;
-  arg_port_name: string;
-  default_host: string;
-  default_port: number;
-}): DaemonEndpoint {
-  const explicitHost = normalizeHost(params.explicit_host);
-  const explicitPort = parsePortLike(params.explicit_port);
-
-  const envHost = normalizeHost(process.env[params.env_host_name]);
-  const envPort = parsePortLike(process.env[params.env_port_name]);
-
-  let daemonArgHost: string | undefined;
-  let daemonArgPort: number | undefined;
-  try {
-    const metaPath = getDaemonMetaPath(params.projectRoot);
-    if (fs.existsSync(metaPath)) {
-      const raw = fs.readJsonSync(metaPath) as { args?: unknown };
-      const args = Array.isArray(raw?.args)
-        ? raw.args.map((item) => String(item))
-        : [];
-      daemonArgHost = normalizeHost(pickArgValue(args, "--host"));
-      daemonArgPort = parsePortLike(pickArgValue(args, params.arg_port_name));
-    }
-  } catch {
-    // ignore daemon meta errors, fallback to other sources
-  }
-
-  const host = explicitHost || envHost || daemonArgHost || params.default_host;
-  const port = explicitPort || envPort || daemonArgPort || params.default_port;
-
-  return {
-    host,
-    port,
-    baseUrl: `http://${host}:${port}`,
-  };
-}
-
-/**
- * 解析 daemon endpoint。
- *
- * 优先级（中文）
- * 1) 显式入参 `host/port`
- * 2) 环境变量 `DC_CITY_HOST/DC_CITY_PORT`
- * 3) daemon meta args（`downcity.daemon.json`）
- * 4) 默认 `127.0.0.1:5314`
- */
-function resolveDaemonEndpoint(
-  params: ResolveDaemonEndpointParams,
-): DaemonEndpoint {
-  return resolveDaemonEndpointFromSources({
-    projectRoot: params.projectRoot,
-    explicit_host: params.host,
-    explicit_port: params.port,
-    env_host_name: "DC_CITY_HOST",
-    env_port_name: "DC_CITY_PORT",
-    arg_port_name: "--port",
-    default_host: "127.0.0.1",
-    default_port: 5314,
-  });
-}
-
-/**
- * 调用 daemon JSON API。
- *
- * 错误语义（中文）
- * - 网络异常：`success=false` + `error`（无 status）。
- * - HTTP 非 2xx：`success=false` + `status` + `error`。
- */
-export async function callServer<T>(
-  params: DaemonJsonApiCallParams,
-): Promise<DaemonJsonApiCallResult<T>> {
-  const endpoint = resolveDaemonEndpoint({
-    projectRoot: params.projectRoot,
-    host: params.host,
-    port: params.port,
-  });
-
-  const url = new URL(params.path, endpoint.baseUrl).toString();
-  const method = params.method || "GET";
-  const hasBody = params.body !== undefined && method !== "GET";
-  const headers: Record<string, string> = {};
-  const authHeaderValue = formatCliBearerHeaderValue(
-    resolveCliAuthToken({
-      explicitToken: params.authToken,
-    }),
-  );
-  if (hasBody) {
-    headers["Content-Type"] = "application/json";
-  }
-  if (authHeaderValue) {
-    headers.Authorization = authHeaderValue;
-  }
-
-  try {
-    const response = await fetch(url, {
-      method,
-      headers: Object.keys(headers).length > 0 ? headers : undefined,
-      body: hasBody ? JSON.stringify(params.body) : undefined,
-    });
-
-    let data: JsonValue | null = null;
-    try {
-      data = (await response.json()) as JsonValue;
-    } catch {
-      data = null;
-    }
-
-    if (!response.ok) {
-      const messageFromData =
-        parseErrorMessageFromPayload(data) || `HTTP ${response.status}`;
-      return {
-        success: false,
-        status: response.status,
-        error: messageFromData,
-      };
-    }
-
-    return {
-      success: true,
-      status: response.status,
-      data: data as T,
-    };
-  } catch (error) {
-    return {
-      success: false,
-      error: `Failed to call ${url}: ${String(error)}`,
-    };
-  }
-}

package/src/runtime/host/daemon/Paths.ts

@@ -1,33 +0,0 @@
-/**
- * Agent daemon 路径模块。
- *
- * 关键点（中文）
- * - 这里只保留 agent 侧访问 daemon meta 所需的项目级路径。
- * - daemon 进程启停、pid 清理、registry 同步属于 `downcity`，不放在 agent 包内。
- */
-
-import path from "node:path";
-import { getDowncityDebugDirPath } from "@/config/Paths.js";
-import {
-  DAEMON_LOG_FILENAME,
-  DAEMON_META_FILENAME,
-  DAEMON_PID_FILENAME,
-} from "@/types/runtime/daemon/Daemon.js";
-
-/**
- * 计算 daemon pid 文件路径。
- */
-export const getDaemonPidPath = (projectRoot: string): string =>
-  path.join(getDowncityDebugDirPath(projectRoot), DAEMON_PID_FILENAME);
-
-/**
- * 计算 daemon 日志文件路径。
- */
-export const getDaemonLogPath = (projectRoot: string): string =>
-  path.join(getDowncityDebugDirPath(projectRoot), DAEMON_LOG_FILENAME);
-
-/**
- * 计算 daemon 元数据文件路径。
- */
-export const getDaemonMetaPath = (projectRoot: string): string =>
-  path.join(getDowncityDebugDirPath(projectRoot), DAEMON_META_FILENAME);

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

@@ -1,183 +0,0 @@
-/**
- * Agent HTTP Server 装配模块。
- *
- * 职责说明：
- * 1. 创建主 Hono 应用并挂载各路由模块。
- * 2. 管理 Node HTTP Server 的启动与停止。
- * 3. 保持 server 层只做协议装配，不混入具体路由实现。
- */
-
-import { Hono } from "hono";
-import { cors } from "hono/cors";
-import { logger } from "hono/logger";
-import http from "node:http";
-import { Readable } from "node:stream";
-import { finished } from "node:stream/promises";
-import { logger as serverLogger } from "@/utils/logger/Logger.js";
-import { createExecuteRouter } from "@/runtime/server/http/execute/execute.js";
-import { healthRouter } from "@/runtime/server/http/health/health.js";
-import { createPluginsRouter } from "@/runtime/server/http/plugins/plugins.js";
-import { createStaticRouter } from "@/runtime/server/http/static/static.js";
-import { createControlRouter } from "@/runtime/server/http/control/ControlRouter.js";
-import { createSdkRouter } from "@/runtime/server/http/sdk/Router.js";
-import type { AgentRuntime } from "@/types/runtime/agent/AgentRuntime.js";
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
-import type { AgentSessionCollection } from "@/types/agent/AgentTypes.js";
-
-/**
- * Server 启动参数。
- */
-export interface ServerStartOptions {
-  /** HTTP 服务监听端口。 */
-  port: number;
-  /** HTTP 服务监听主机。 */
-  host: string;
-  /** 当前 agent runtime 读取函数。 */
-  getAgentRuntime: () => AgentRuntime;
-  /** 当前 agent context 读取函数。 */
-  getAgentContext: () => AgentContext;
-  /** 可选 SDK Session 集合绑定。 */
-  sessionCollection?: AgentSessionCollection;
-}
-
-/**
- * Server 运行实例。
- */
-export interface ServerInstance {
-  /** Hono 应用实例。 */
-  app: Hono;
-  /** 原生 HTTP Server 实例。 */
-  server: http.Server;
-  /** 停止当前服务。 */
-  stop(): Promise<void>;
-}
-
-/**
- * 创建主 Hono 应用。
- */
-export function createServerApp(
-  options: Pick<
-    ServerStartOptions,
-    "getAgentRuntime" | "getAgentContext" | "sessionCollection"
-  >,
-): Hono {
-  const app = new Hono();
-
-  app.use("*", logger());
-  app.use(
-    "*",
-    cors({
-      origin: "*",
-      allowMethods: ["GET", "POST", "PUT", "DELETE", "OPTIONS"],
-      allowHeaders: ["Content-Type", "Authorization"],
-    }),
-  );
-
-  // 关键点（中文）：按路由域挂载，server 模块只保留装配职责。
-  app.route("/", createStaticRouter({
-    getAgentRuntime: options.getAgentRuntime,
-  }));
-  app.route("/", healthRouter);
-  app.route("/", createPluginsRouter({
-    getAgentContext: options.getAgentContext,
-  }));
-  app.route("/", createExecuteRouter({
-    getAgentRuntime: options.getAgentRuntime,
-  }));
-  app.route("/", createControlRouter({
-    getAgentRuntime: options.getAgentRuntime,
-    getAgentContext: options.getAgentContext,
-  }));
-  if (options.sessionCollection) {
-    app.route("/", createSdkRouter(options.sessionCollection));
-  }
-  for (const plugin of options.getAgentContext().agent.pluginInstances.values()) {
-    plugin.http?.server?.register({
-      app,
-      getContext: options.getAgentContext,
-      pluginName: plugin.name,
-    });
-  }
-
-  return app;
-}
-
-/**
- * 启动主 HTTP 服务。
- */
-export async function startServer(
-  options: ServerStartOptions,
-): Promise<ServerInstance> {
-  const app = createServerApp(options);
-  const server = createNodeServer(app, options);
-
-  await new Promise<void>((resolve) => {
-    server.listen(options.port, options.host, () => {
-      serverLogger.info(
-        `🚀 Agent Server started: http://${options.host}:${options.port}`,
-      );
-      serverLogger.info("Available APIs:");
-      resolve();
-    });
-  });
-
-  return {
-    app,
-    server,
-    async stop(): Promise<void> {
-      await serverLogger.saveAllLogs();
-      await new Promise<void>((resolve) => {
-        server.close(() => resolve());
-      });
-      serverLogger.info("Agent Server stopped");
-    },
-  };
-}
-
-/**
- * 创建 Node HTTP Server 适配层。
- */
-function createNodeServer(app: Hono, options: ServerStartOptions): http.Server {
-  return http.createServer(async (req, res) => {
-    try {
-      const url = new URL(req.url || "/", `http://${options.host}:${options.port}`);
-      const method = req.method || "GET";
-      const bodyBuffer = await readRequestBody(req);
-      const request = new Request(url.toString(), {
-        method,
-        headers: new Headers(req.headers as Record<string, string>),
-        body: bodyBuffer.length > 0 ? bodyBuffer : undefined,
-      });
-
-      const response = await app.fetch(request);
-      res.statusCode = response.status;
-      for (const [key, value] of response.headers.entries()) {
-        res.setHeader(key, value);
-      }
-      if (!response.body) {
-        res.end();
-        return;
-      }
-      const bodyStream = Readable.fromWeb(
-        response.body as unknown as globalThis.ReadableStream<Uint8Array>,
-      );
-      bodyStream.pipe(res);
-      await finished(bodyStream).catch(() => undefined);
-    } catch {
-      res.statusCode = 500;
-      res.end("Internal Server Error");
-    }
-  });
-}
-
-/**
- * 读取原生请求体。
- */
-async function readRequestBody(req: http.IncomingMessage): Promise<Buffer> {
-  return new Promise<Buffer>((resolve, reject) => {
-    const chunks: Buffer[] = [];
-    req.on("data", (chunk) => chunks.push(chunk));
-    req.on("end", () => resolve(Buffer.concat(chunks)));
-    req.on("error", reject);
-  });
-}

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

@@ -1,29 +0,0 @@
-/**
- * Agent Control API 路由聚合入口。
- *
- * 关键点（中文）
- * - 本文件只做模块装配，不再承载具体业务逻辑。
- * - 单 agent control API 子路由按 overview/session/task/auth 四类拆分，便于继续维护。
- * - 单 agent control API 统一暴露在 `/api/control/*` 下。
- */
-
-import type { ControlRouteRegistrationParams } from "@/runtime/server/http/control/types/ControlRoutes.js";
-import { registerControlAuthorizationRoutes } from "@/runtime/server/http/control/ControlAuthorizationRoutes.js";
-import { registerControlSessionRoutes } from "@/runtime/server/http/control/SessionRoutes.js";
-import { registerControlOverviewRoutes } from "@/runtime/server/http/control/OverviewRoutes.js";
-import { registerControlTaskRoutes } from "@/runtime/server/http/control/TaskRoutes.js";
-
-/**
- * 注册单 agent control API 路由。
- */
-export function registerControlApiRoutes(
-  params: ControlRouteRegistrationParams,
-): void {
-  registerControlAuthorizationRoutes({
-    app: params.app,
-    getAgentContext: params.getAgentContext,
-  });
-  registerControlOverviewRoutes(params);
-  registerControlSessionRoutes(params);
-  registerControlTaskRoutes(params);
-}