@downcity/city 1.1.1 → 1.1.5

package/src/console/gateway/GatewaySupport.ts

@@ -1,59 +0,0 @@
-/**
- * Console gateway 共享辅助函数。
- *
- * 关键点（中文）
- * - 提供与路由层正交的纯文本/纯 payload 组装能力。
- * - 让 `ConsoleGateway` 与 route 注册模块不再重复拼接阻塞文案。
- */
-
-/**
- * Console workload 安全检查结果。
- */
-export interface ConsoleWorkloadSafetyCheck {
-  /**
-   * 当前仍在运行的上下文列表。
-   */
-  activeContexts: string[];
-  /**
-   * 当前仍在运行的任务列表。
-   */
-  activeTasks: string[];
-}
-
-/**
- * 生成 workload 阻塞详情文本。
- */
-export function buildConsoleWorkloadBlockDetail(
-  checks: ConsoleWorkloadSafetyCheck,
-): string {
-  const contextLabel =
-    checks.activeContexts.length > 0
-      ? `contexts: ${checks.activeContexts.join(", ")}`
-      : "";
-  const taskLabel =
-    checks.activeTasks.length > 0 ? `tasks: ${checks.activeTasks.join(", ")}` : "";
-  return [contextLabel, taskLabel].filter(Boolean).join(" | ");
-}
-
-/**
- * 生成 stop/restart 被阻塞时的统一响应 payload。
- */
-export function buildConsoleWorkloadBlockPayload(
-  action: "stop" | "restart",
-  checks: ConsoleWorkloadSafetyCheck,
-): {
-  success: false;
-  error: string;
-  activeContexts: string[];
-  activeTasks: string[];
-} {
-  const detail = buildConsoleWorkloadBlockDetail(checks);
-  return {
-    success: false,
-    error: detail
-      ? `Agent has running workload, ${action} blocked (${detail})`
-      : `Agent has running workload, ${action} blocked`,
-    activeContexts: checks.activeContexts,
-    activeTasks: checks.activeTasks,
-  };
-}

package/src/console/gateway/Proxy.ts

@@ -1,62 +0,0 @@
-/**
- * Console 代理转发辅助。
- *
- * 关键点（中文）
- * - 负责把 `/api/*` 请求转发到选中 agent。
- * - 保持最小职责，不参与 agent 选择逻辑。
- */
-
-/**
- * 构造上游请求地址。
- */
-export function buildConsoleUpstreamUrl(
-  requestUrl: URL,
-  baseUrl: string,
-): string {
-  const upstreamPath = new URL(requestUrl.pathname + requestUrl.search, baseUrl);
-  upstreamPath.searchParams.delete("agent");
-  return upstreamPath.toString();
-}
-
-/**
- * 转发请求到目标 runtime。
- */
-export async function forwardConsoleRequest(
-  request: Request,
-  upstreamUrl: string,
-): Promise<Response> {
-  const method = request.method || "GET";
-  const headers = new Headers();
-  for (const [key, value] of request.headers.entries()) {
-    const lower = key.toLowerCase();
-    if (
-      lower === "host" ||
-      lower === "content-length" ||
-      lower === "x-city-agent"
-    ) {
-      continue;
-    }
-    headers.set(key, value);
-  }
-
-  const body =
-    method === "GET" || method === "HEAD"
-      ? undefined
-      : Buffer.from(await request.arrayBuffer());
-
-  const response = await fetch(upstreamUrl, {
-    method,
-    headers,
-    body,
-  });
-  const buffer = Buffer.from(await response.arrayBuffer());
-  const outHeaders = new Headers();
-  outHeaders.set(
-    "content-type",
-    response.headers.get("content-type") || "application/octet-stream",
-  );
-  return new Response(buffer, {
-    status: response.status,
-    headers: outHeaders,
-  });
-}

package/src/daemon/Api.ts

@@ -1,64 +0,0 @@
-/**
- * Daemon API 协议类型模块。
- *
- * 关键点（中文）
- * - 这里描述的是 CLI 与 agent daemon 之间的远程访问契约，不包含具体 HTTP 实现。
- * - service 等上层模块只依赖这些协议类型，不需要感知 city/daemon 的内部实现细节。
- * - 该文件属于 `main/city/daemon/*` 的协议边界，而不是通用 HTTP 类型目录。
- */
-
-import type { JsonValue } from "@/shared/types/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;
-  /**
-   * 单次调用超时（毫秒）。
-   *
-   * 说明（中文）
-   * - 仅本地 IPC transport 当前会消费该参数。
-   * - 用于 `session execute`、`service 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/daemon/CliArgs.ts

@@ -1,39 +0,0 @@
-/**
- * 负责把 commander 解析到的 options 转换成子进程 CLI 参数。
- *
- * 关键点
- * - daemon（来自 `agent start` / `agent restart`）会拉起一个前台 `agent start`
- *   进程（显式 `--foreground true`），这里负责拼装其 argv。
- */
-
-import type { StartOptions } from "@/shared/types/Start.js";
-import { allocateAvailablePort } from "@/daemon/PortAllocator.js";
-
-/**
- * 将 daemon 选项转换为 `agent start` 子进程 argv。
- *
- * 关键点（中文）
- * - daemon 始终启动 `agent start` 前台流程，因此参数统一映射到 `agent start` CLI 形态。
- * - 只透传用户显式传入的字段，避免污染默认值决策。
- */
-export const buildRunArgsFromOptions = async (
-  projectRoot: string,
-  options: StartOptions,
-): Promise<string[]> => {
-  // 关键点（中文）：daemon 子进程必须强制前台模式，避免再次进入 startCommand 形成递归拉起。
-  const args: string[] = ["agent", "start", projectRoot, "--foreground", "true"];
-
-  // 关键点（中文）：host 未指定时统一落到 0.0.0.0，保持历史监听行为。
-  const host = String(options.host || "0.0.0.0").trim() || "0.0.0.0";
-
-  // 关键点（中文）：agent 端口统一由 console 分配，不接受命令行显式覆盖。
-  const port = await allocateAvailablePort({ host });
-  if (!Number.isFinite(port) || Number.isNaN(port) || port <= 0 || port > 65535) {
-    throw new Error(`Invalid allocated port: ${String(port)}`);
-  }
-
-  args.push("--port", String(port));
-  args.push("--host", host);
-
-  return args;
-};

package/src/daemon/Client.ts

@@ -1,182 +0,0 @@
-/**
- * Daemon API 客户端（process 子模块）。
- *
- * 关键点（中文）
- * - 业务模块统一通过 daemon API 与运行时通信。
- * - 地址解析优先级：CLI 参数 > 环境变量 > daemon meta > 默认值。
- */
-
-import fs from "fs-extra";
-import {
-  type DaemonEndpoint,
-  type DaemonJsonApiCallParams,
-  type DaemonJsonApiCallResult,
-} from "./Api.js";
-import {
-  formatCliBearerHeaderValue,
-  resolveCliAuthToken,
-} from "@/http/auth/CliAuthStateStore.js";
-import { getDaemonMetaPath } from "@/daemon/Manager.js";
-import type { JsonObject, JsonValue } from "@/shared/types/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;
-}
-
-/**
- * 解析 daemon endpoint。
- *
- * 优先级（中文）
- * 1) 显式入参 `host/port`
- * 2) 环境变量 `DC_SERVER_*` / `DC_CTX_SERVER_*`
- * 3) daemon meta args（`downcity.daemon.json`）
- * 4) 默认 `127.0.0.1:5314`
- */
-function resolveDaemonEndpoint(params: {
-  projectRoot: string;
-  host?: string;
-  port?: number;
-}): DaemonEndpoint {
-  const explicitHost = normalizeHost(params.host);
-  const explicitPort = parsePortLike(params.port);
-
-  const envHost =
-    normalizeHost(process.env.DC_SERVER_HOST) ||
-    normalizeHost(process.env.DC_CTX_SERVER_HOST);
-  const envPort =
-    parsePortLike(process.env.DC_SERVER_PORT) ||
-    parsePortLike(process.env.DC_CTX_SERVER_PORT);
-
-  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, "--port"));
-    }
-  } catch {
-    // ignore daemon meta errors, fallback to other sources
-  }
-
-  const host = explicitHost || envHost || daemonArgHost || "127.0.0.1";
-  const port = explicitPort || envPort || daemonArgPort || 5314;
-
-  return {
-    host,
-    port,
-    baseUrl: `http://${host}:${port}`,
-  };
-}
-
-/**
- * 调用 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)}`,
-    };
-  }
-}