@downcity/agent 1.1.43 → 1.1.62

package/src/runtime/transport/rpc/Client.ts

@@ -1,113 +0,0 @@
-/**
- * Local RPC 客户端。
- *
- * 关键点（中文）
- * - 只用于本机受信任 IPC，不附加 HTTP Bearer 鉴权。
- * - 返回结构与 HTTP `callServer()` 对齐，便于上层透明切换 transport。
- */
-
-import net from "node:net";
-import { nanoid } from "nanoid";
-import type {
-  DaemonJsonApiCallParams,
-  DaemonJsonApiCallResult,
-} from "@/runtime/host/daemon/Api.js";
-import type { LocalRpcRequest, LocalRpcResponse } from "@/types/runtime/rpc/LocalRpc.js";
-import { getLocalRpcEndpoint } from "./Paths.js";
-
-const LOCAL_RPC_TIMEOUT_MS = 5_000;
-
-function toLocalRpcRequest(params: DaemonJsonApiCallParams): LocalRpcRequest {
-  return {
-    requestId: nanoid(),
-    path: String(params.path || "").trim(),
-    method: params.method || "GET",
-    ...(params.body !== undefined ? { body: params.body } : {}),
-  };
-}
-
-/**
- * 通过本地 IPC 调用 agent runtime。
- */
-export async function callLocalServer<T>(
-  params: DaemonJsonApiCallParams,
-): Promise<DaemonJsonApiCallResult<T>> {
-  const endpoint = getLocalRpcEndpoint(params.projectRoot);
-  const request = toLocalRpcRequest(params);
-  const timeoutMs =
-    typeof params.timeoutMs === "number" &&
-    Number.isFinite(params.timeoutMs) &&
-    params.timeoutMs > 0
-      ? Math.floor(params.timeoutMs)
-      : LOCAL_RPC_TIMEOUT_MS;
-
-  return await new Promise<DaemonJsonApiCallResult<T>>((resolve) => {
-    const socket = net.createConnection(endpoint);
-    let settled = false;
-    let buffered = "";
-
-    const finish = (result: DaemonJsonApiCallResult<T>): void => {
-      if (settled) return;
-      settled = true;
-      socket.destroy();
-      resolve(result);
-    };
-
-    socket.setEncoding("utf8");
-    socket.setTimeout(timeoutMs);
-
-    socket.on("connect", () => {
-      socket.write(`${JSON.stringify(request)}\n`);
-    });
-
-    socket.on("data", (chunk) => {
-      buffered += String(chunk || "");
-      const newlineIndex = buffered.indexOf("\n");
-      if (newlineIndex < 0) return;
-      const raw = buffered.slice(0, newlineIndex).trim();
-      if (!raw) {
-        finish({
-          success: false,
-          error: `Local RPC returned empty payload from ${endpoint}`,
-        });
-        return;
-      }
-      try {
-        const response = JSON.parse(raw) as LocalRpcResponse;
-        finish({
-          success: response.success,
-          status: response.status,
-          ...(response.data !== undefined ? { data: response.data as T } : {}),
-          ...(response.error ? { error: response.error } : {}),
-        });
-      } catch (error) {
-        finish({
-          success: false,
-          error: `Local RPC returned invalid JSON from ${endpoint}: ${String(error)}`,
-        });
-      }
-    });
-
-    socket.on("timeout", () => {
-      finish({
-        success: false,
-        error: `Local RPC timed out after ${timeoutMs}ms (${endpoint})`,
-      });
-    });
-
-    socket.on("error", (error) => {
-      finish({
-        success: false,
-        error: `Local RPC unavailable at ${endpoint}: ${String(error)}`,
-      });
-    });
-
-    socket.on("end", () => {
-      if (settled) return;
-      finish({
-        success: false,
-        error: `Local RPC closed without response (${endpoint})`,
-      });
-    });
-  });
-}

package/src/runtime/transport/rpc/Paths.ts

@@ -1,50 +0,0 @@
-/**
- * Local RPC 路径工具。
- *
- * 关键点（中文）
- * - 本地受信任进程之间统一通过 IPC socket/pipe 通信。
- * - Unix 平台使用 city 全局 runtime 目录下的稳定 socket 文件，避免不同启动上下文
- *   的 `TMPDIR` 不一致，导致同一个 agent 被解析到两个不同 socket 路径。
- * - Windows 平台使用命名 pipe，并基于项目路径 hash 保证稳定唯一。
- */
-
-import crypto from "node:crypto";
-import path from "node:path";
-import { getPlatformRootDirPath } from "@/config/PlatformPaths.js";
-
-/**
- * 读取平台级运行目录。
- */
-function getPlatformRuntimeDirPath(): string {
-  return path.join(getPlatformRootDirPath(), "main");
-}
-
-function buildProjectDigest(projectRoot: string): string {
-  return crypto
-    .createHash("sha1")
-    .update(path.resolve(projectRoot))
-    .digest("hex")
-    .slice(0, 16);
-}
-
-function buildWindowsPipeName(projectRoot: string): string {
-  const digest = buildProjectDigest(projectRoot);
-  return `\\\\.\\pipe\\downcity-local-${digest}`;
-}
-
-function getLocalRpcUnixDirPath(): string {
-  return path.join(getPlatformRuntimeDirPath(), "local-rpc");
-}
-
-/**
- * 返回本地 RPC endpoint。
- */
-export function getLocalRpcEndpoint(projectRoot: string): string {
-  if (process.platform === "win32") {
-    return buildWindowsPipeName(projectRoot);
-  }
-  return path.join(
-    getLocalRpcUnixDirPath(),
-    `downcity-local-${buildProjectDigest(projectRoot)}.sock`,
-  );
-}

package/src/runtime/transport/rpc/Transport.ts

@@ -1,43 +0,0 @@
-/**
- * 本地/远程 transport 选择器。
- *
- * 关键点（中文）
- * - 本地受信任调用默认优先使用 IPC。
- * - 只有显式传入 `host/port` 时，才视为外部 HTTP 调用。
- * - 当前返回结构与 `callServer()` 保持一致，方便命令层复用。
- */
-
-import type {
-  DaemonJsonApiCallParams,
-  DaemonJsonApiCallResult,
-} from "@/runtime/host/daemon/Api.js";
-import { callServer } from "@/runtime/host/daemon/Client.js";
-import { callLocalServer } from "./Client.js";
-
-/**
- * 判断是否应强制使用 HTTP transport。
- */
-export function shouldUseHttpTransport(params: {
-  host?: string;
-  port?: number;
-}): boolean {
-  return Boolean(
-    (typeof params.host === "string" && params.host.trim()) ||
-    typeof params.port === "number",
-  );
-}
-
-/**
- * 统一调用 agent transport。
- */
-export async function callAgentTransport<T>(
-  params: DaemonJsonApiCallParams,
-): Promise<DaemonJsonApiCallResult<T>> {
-  if (shouldUseHttpTransport({
-    host: params.host,
-    port: params.port,
-  })) {
-    return await callServer<T>(params);
-  }
-  return await callLocalServer<T>(params);
-}

package/src/types/common/ResolvedConfigValue.ts

@@ -1,16 +0,0 @@
-/**
- * 配置值递归结构类型。
- *
- * 职责说明（中文）
- * - 描述 `downcity.json` 在“读取原始 JSON -> 解析环境变量占位符”阶段可接受的值结构。
- * - 允许对象、数组、JSON 标量与 `undefined` 递归嵌套，供配置解析工具复用。
- * - 该类型只服务配置装配阶段，不承诺运行时最终配置的严格业务语义。
- */
-export type ResolvedConfigValue =
-  | string
-  | number
-  | boolean
-  | null
-  | undefined
-  | { [key: string]: ResolvedConfigValue }
-  | ResolvedConfigValue[];

package/src/types/runtime/rpc/LocalRpc.ts

@@ -1,72 +0,0 @@
-/**
- * LocalRpc：本地 IPC 调用协议类型。
- *
- * 关键点（中文）
- * - 仅用于本机受信任进程之间的调用，不承担外部 HTTP 鉴权职责。
- * - 当前协议采用“一连接一请求一响应”的 JSON 行格式，便于调试与逐步演进。
- */
-
-import type { JsonValue } from "@/types/common/Json.js";
-import type { DaemonHttpMethod } from "@/runtime/host/daemon/Api.js";
-
-/**
- * 单次本地 RPC 请求。
- */
-export interface LocalRpcRequest {
-  /**
-   * 请求唯一标识。
-   */
-  requestId: string;
-  /**
-   * 目标 API 路径。
-   */
-  path: string;
-  /**
-   * 调用方法。
-   */
-  method: DaemonHttpMethod;
-  /**
-   * 可选结构化请求体。
-   */
-  body?: JsonValue;
-}
-
-/**
- * 单次本地 RPC 响应。
- */
-export interface LocalRpcResponse {
-  /**
-   * 对应请求标识。
-   */
-  requestId: string;
-  /**
-   * HTTP 风格状态码。
-   */
-  status: number;
-  /**
-   * 调用是否成功。
-   */
-  success: boolean;
-  /**
-   * 成功时的数据。
-   */
-  data?: JsonValue;
-  /**
-   * 失败时的错误信息。
-   */
-  error?: string;
-}
-
-/**
- * 本地 RPC server 句柄。
- */
-export interface LocalRpcServerHandle {
-  /**
-   * 当前绑定的 socket/pipe 地址。
-   */
-  endpoint: string;
-  /**
-   * 停止本地 RPC server。
-   */
-  stop(): Promise<void>;
-}