@downcity/agent 1.1.43 → 1.1.62

package/bin/runtime/transport/rpc/Transport.js

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

package/bin/runtime/transport/rpc/Transport.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Transport.js","sourceRoot":"","sources":["../../../../src/runtime/transport/rpc/Transport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAGtC;IACC,OAAO,OAAO,CACZ,CAAC,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACvD,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAChC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAA+B;IAE/B,IAAI,sBAAsB,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC,EAAE,CAAC;QACH,OAAO,MAAM,UAAU,CAAI,MAAM,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,MAAM,eAAe,CAAI,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/bin/types/common/ResolvedConfigValue.d.ts

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

package/bin/types/common/ResolvedConfigValue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ResolvedConfigValue.d.ts","sourceRoot":"","sources":["../../../src/types/common/ResolvedConfigValue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAA;CAAE,GACtC,mBAAmB,EAAE,CAAC"}

package/bin/types/common/ResolvedConfigValue.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=ResolvedConfigValue.js.map

package/bin/types/common/ResolvedConfigValue.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ResolvedConfigValue.js","sourceRoot":"","sources":["../../../src/types/common/ResolvedConfigValue.ts"],"names":[],"mappings":""}

package/bin/types/runtime/rpc/LocalRpc.d.ts

@@ -1,69 +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>;
-}
-//# sourceMappingURL=LocalRpc.d.ts.map

package/bin/types/runtime/rpc/LocalRpc.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"LocalRpc.d.ts","sourceRoot":"","sources":["../../../../src/types/runtime/rpc/LocalRpc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,EAAE,gBAAgB,CAAC;IACzB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/bin/types/runtime/rpc/LocalRpc.js

@@ -1,9 +0,0 @@
-/**
- * LocalRpc：本地 IPC 调用协议类型。
- *
- * 关键点（中文）
- * - 仅用于本机受信任进程之间的调用，不承担外部 HTTP 鉴权职责。
- * - 当前协议采用“一连接一请求一响应”的 JSON 行格式，便于调试与逐步演进。
- */
-export {};
-//# sourceMappingURL=LocalRpc.js.map

package/bin/types/runtime/rpc/LocalRpc.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"LocalRpc.js","sourceRoot":"","sources":["../../../../src/types/runtime/rpc/LocalRpc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/src/config/ConfigEnvResolver.ts

@@ -1,52 +0,0 @@
-/**
- * Agent 配置域环境变量占位符解析模块。
- *
- * 职责说明（中文）
- * - 负责把配置树中的 `${ENV_NAME}` 形式占位符替换为运行时可见的环境变量值。
- * - 服务 `downcity.json` 等配置载体的解析流程，让配置读取相关逻辑集中留在 `config/` 语义域。
- *
- * 边界说明（中文）
- * - 该模块只处理结构遍历与替换，不读取文件，也不决定环境变量来源优先级。
- * - 这里只负责“如何替换”，不负责“缺失变量时是否报错”的业务策略。
- */
-
-import type { JsonObject } from "@/types/common/Json.js";
-import type { ResolvedConfigValue } from "@/types/common/ResolvedConfigValue.js";
-
-/**
- * 递归解析配置值中的环境变量占位符。
- *
- * 关键点（中文）
- * - 仅替换“整个字符串就是 `${VAR}`”的场景，不处理字符串内插值拼接。
- * - 数组与对象会递归遍历，保持原有结构不变。
- * - 未命中的环境变量会返回 `undefined`，由调用方决定后续行为。
- */
-export function resolveEnvPlaceholdersDeep(
-  value: ResolvedConfigValue,
-  resolveEnvVar: (name: string) => string | undefined,
-): ResolvedConfigValue {
-  if (typeof value === "string") {
-    const match = value.match(/^\$\{([A-Z0-9_]+)\}$/);
-    if (!match) return value;
-    const envVar = match[1];
-    return resolveEnvVar(envVar);
-  }
-
-  if (Array.isArray(value)) {
-    return value.map((item) => resolveEnvPlaceholdersDeep(item, resolveEnvVar));
-  }
-
-  if (value && typeof value === "object") {
-    const obj = value as JsonObject;
-    const out: { [key: string]: ResolvedConfigValue } = {};
-    for (const [key, child] of Object.entries(obj)) {
-      out[key] = resolveEnvPlaceholdersDeep(
-        child as ResolvedConfigValue,
-        resolveEnvVar,
-      );
-    }
-    return out;
-  }
-
-  return value;
-}

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

@@ -1,408 +0,0 @@
-/**
- * Local RPC server。
- *
- * 关键点（中文）
- * - 只服务本地受信任进程，不暴露 HTTP 协议。
- * - 这里承接本机 CLI 访问 agent runtime 的 IPC 路由，并与 HTTP 能力保持语义一致。
- */
-
-import fs from "fs-extra";
-import net, { type Server } from "node:net";
-import path from "node:path";
-import type { AgentRuntime } from "@/types/runtime/agent/AgentRuntime.js";
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
-import type { JsonValue } from "@/types/common/Json.js";
-import type { LocalRpcRequest, LocalRpcResponse, LocalRpcServerHandle } from "@/types/runtime/rpc/LocalRpc.js";
-import type { ControlSessionExecuteRequestBody } from "@/runtime/server/http/control/types/ControlSessionExecute.js";
-import type {
-  PluginActionResponse,
-  PluginAvailabilityResponse,
-  PluginCatalogResponse,
-} from "@/plugin/types/PluginApi.js";
-import type {
-  PluginControlAction,
-  PluginCommandResponse,
-  PluginControlResponse,
-  PluginStateListResponse,
-} from "@/plugin/types/Plugins.js";
-import { listPluginStates, controlPluginState } from "@/plugin/core/PluginStateController.js";
-import { runPluginCommand } from "@/plugin/core/PluginActionRunner.js";
-import { parsePluginCommandRequestBody } from "@/plugin/core/PluginCommandRequest.js";
-import { executeBySessionId } from "@/runtime/server/http/control/ExecuteBySession.js";
-import { getLocalRpcEndpoint } from "@/runtime/transport/rpc/Paths.js";
-
-async function isSocketEndpointActive(endpoint: string): Promise<boolean> {
-  return await new Promise<boolean>((resolve) => {
-    const socket = net.createConnection(endpoint);
-    let settled = false;
-    const finish = (value: boolean): void => {
-      if (settled) return;
-      settled = true;
-      socket.destroy();
-      resolve(value);
-    };
-    socket.setTimeout(200);
-    socket.on("connect", () => finish(true));
-    socket.on("timeout", () => finish(false));
-    socket.on("error", () => finish(false));
-  });
-}
-
-function isObjectRecord(value: unknown): value is Record<string, unknown> {
-  return Boolean(value && typeof value === "object" && !Array.isArray(value));
-}
-
-function createSuccessResponse(
-  requestId: string,
-  data: JsonValue,
-  status = 200,
-): LocalRpcResponse {
-  return {
-    requestId,
-    status,
-    success: true,
-    data,
-  };
-}
-
-function createErrorResponse(
-  requestId: string,
-  status: number,
-  error: string,
-): LocalRpcResponse {
-  return {
-    requestId,
-    status,
-    success: false,
-    error,
-  };
-}
-
-async function handlePluginControl(params: {
-  requestId: string;
-  body: JsonValue | undefined;
-  context: AgentContext;
-}): Promise<LocalRpcResponse> {
-  const body = isObjectRecord(params.body) ? params.body : {};
-  const pluginName = String(body.pluginName || "").trim();
-  const action = String(body.action || "").trim() as PluginControlAction;
-  if (!pluginName || !action) {
-    return createErrorResponse(params.requestId, 400, "pluginName and action are required");
-  }
-  const result = await controlPluginState({
-    pluginName,
-    action,
-    context: params.context,
-  });
-  const payload: PluginControlResponse = {
-    success: result.success,
-    ...(result.plugin ? { plugin: result.plugin } : {}),
-    ...(result.error ? { error: result.error } : {}),
-  };
-  return createSuccessResponse(params.requestId, payload as unknown as JsonValue);
-}
-
-async function handlePluginCommand(params: {
-  requestId: string;
-  body: JsonValue | undefined;
-  context: AgentContext;
-}): Promise<LocalRpcResponse> {
-  let body;
-  try {
-    body = parsePluginCommandRequestBody(params.body);
-  } catch (error) {
-    return createErrorResponse(params.requestId, 400, String(error));
-  }
-  if (!body.pluginName || !body.command) {
-    return createErrorResponse(params.requestId, 400, "pluginName and command are required");
-  }
-  const result = await runPluginCommand({
-    pluginName: body.pluginName,
-    command: body.command,
-    payload: body.payload,
-    schedule: body.schedule,
-    context: params.context,
-  });
-  const payload: PluginCommandResponse = {
-    success: result.success,
-    ...(result.plugin ? { plugin: result.plugin } : {}),
-    ...(result.data !== undefined ? { data: result.data } : {}),
-    ...(result.message ? { message: result.message } : {}),
-    ...(result.success ? {} : { error: result.message || "plugin command failed" }),
-  };
-  return createSuccessResponse(params.requestId, payload as unknown as JsonValue);
-}
-
-async function handlePluginAvailability(params: {
-  requestId: string;
-  body: JsonValue | undefined;
-  context: AgentContext;
-}): Promise<LocalRpcResponse> {
-  const body = isObjectRecord(params.body) ? params.body : {};
-  const pluginName = String(body.pluginName || "").trim();
-  if (!pluginName) {
-    return createErrorResponse(params.requestId, 400, "pluginName is required");
-  }
-  const availability = await params.context.plugins.availability(pluginName);
-  const payload: PluginAvailabilityResponse = {
-    success: true,
-    pluginName,
-    availability,
-  };
-  return createSuccessResponse(params.requestId, payload as unknown as JsonValue);
-}
-
-async function handlePluginAction(params: {
-  requestId: string;
-  body: JsonValue | undefined;
-  context: AgentContext;
-}): Promise<LocalRpcResponse> {
-  const body = isObjectRecord(params.body) ? params.body : {};
-  const pluginName = String(body.pluginName || "").trim();
-  const actionName = String(body.actionName || "").trim();
-  if (!pluginName) {
-    return createErrorResponse(params.requestId, 400, "pluginName is required");
-  }
-  if (!actionName) {
-    return createErrorResponse(params.requestId, 400, "actionName is required");
-  }
-  const result = await params.context.plugins.runAction({
-    plugin: pluginName,
-    action: actionName,
-    payload: body.payload,
-  });
-  const payload: PluginActionResponse = {
-    success: result.success,
-    pluginName,
-    actionName,
-    ...(result.data !== undefined ? { data: result.data } : {}),
-    ...(result.message ? { message: result.message } : {}),
-    ...(result.error ? { error: result.error } : {}),
-  };
-  return createSuccessResponse(
-    params.requestId,
-    payload as unknown as JsonValue,
-    result.success ? 200 : 400,
-  );
-}
-
-function matchControlSessionExecutePath(pathname: string): string | null {
-  const match = /^\/api\/control\/sessions\/([^/]+)\/execute$/.exec(
-    String(pathname || "").trim(),
-  );
-  if (!match) return null;
-  try {
-    return decodeURIComponent(match[1] || "").trim() || null;
-  } catch {
-    return null;
-  }
-}
-
-async function handleControlSessionExecute(params: {
-  requestId: string;
-  body: JsonValue | undefined;
-  context: AgentContext;
-  runtime?: AgentRuntime;
-  sessionId: string;
-}): Promise<LocalRpcResponse> {
-  if (!params.runtime) {
-    return createErrorResponse(
-      params.requestId,
-      500,
-      "Local RPC control execute requires agent runtime",
-    );
-  }
-  const body = isObjectRecord(params.body) ? params.body : {};
-  const instructions = String(body.instructions || "").trim();
-  const attachments = Array.isArray(body.attachments)
-    ? (body.attachments as ControlSessionExecuteRequestBody["attachments"])
-    : undefined;
-  if (!params.sessionId) {
-    return createErrorResponse(params.requestId, 400, "sessionId is required");
-  }
-  if (!instructions) {
-    return createErrorResponse(params.requestId, 400, "instructions are required");
-  }
-  try {
-    const result = await executeBySessionId({
-      agentState: params.runtime,
-      executionContext: params.context,
-      sessionId: params.sessionId,
-      instructions,
-      attachments,
-    });
-    return createSuccessResponse(
-      params.requestId,
-      {
-        success: true,
-        sessionId: params.sessionId,
-        result,
-      } as unknown as JsonValue,
-    );
-  } catch (error) {
-    return createErrorResponse(params.requestId, 500, String(error));
-  }
-}
-
-async function dispatchRequest(params: {
-  request: LocalRpcRequest;
-  context: AgentContext;
-  runtime?: AgentRuntime;
-}): Promise<LocalRpcResponse> {
-  const { request } = params;
-  if (
-    request.method === "GET" &&
-    request.path === "/api/plugins/list"
-  ) {
-    const payload: PluginStateListResponse = {
-      success: true,
-      plugins: listPluginStates({ context: params.context }),
-    };
-    return createSuccessResponse(request.requestId, payload as unknown as JsonValue);
-  }
-  if (
-    request.method === "POST" &&
-    request.path === "/api/plugins/control"
-  ) {
-    return await handlePluginControl({
-      requestId: request.requestId,
-      body: request.body,
-      context: params.context,
-    });
-  }
-  if (
-    request.method === "POST" &&
-    request.path === "/api/plugins/command"
-  ) {
-    return await handlePluginCommand({
-      requestId: request.requestId,
-      body: request.body,
-      context: params.context,
-    });
-  }
-  if (request.method === "GET" && request.path === "/api/plugins/catalog") {
-    const payload: PluginCatalogResponse = {
-      success: true,
-      plugins: params.context.plugins.list(),
-    };
-    return createSuccessResponse(request.requestId, payload as unknown as JsonValue);
-  }
-  if (request.method === "POST" && request.path === "/api/plugins/availability") {
-    return await handlePluginAvailability({
-      requestId: request.requestId,
-      body: request.body,
-      context: params.context,
-    });
-  }
-  if (request.method === "POST" && request.path === "/api/plugins/action") {
-    return await handlePluginAction({
-      requestId: request.requestId,
-      body: request.body,
-      context: params.context,
-    });
-  }
-  const controlSessionId =
-    request.method === "POST"
-      ? matchControlSessionExecutePath(request.path)
-      : null;
-  if (controlSessionId) {
-    return await handleControlSessionExecute({
-      requestId: request.requestId,
-      body: request.body,
-      context: params.context,
-      runtime: params.runtime,
-      sessionId: controlSessionId,
-    });
-  }
-  return createErrorResponse(
-    request.requestId,
-    404,
-    `Unknown local RPC path: ${request.method} ${request.path}`,
-  );
-}
-
-async function ensureEndpointReady(endpoint: string): Promise<void> {
-  if (process.platform === "win32") return;
-  await fs.ensureDir(path.dirname(endpoint));
-  const exists = await fs.pathExists(endpoint);
-  if (!exists) return;
-  if (await isSocketEndpointActive(endpoint)) {
-    throw new Error(`Local RPC endpoint already in use: ${endpoint}`);
-  }
-  await fs.remove(endpoint);
-}
-
-function writeResponse(socket: net.Socket, response: LocalRpcResponse): void {
-  socket.end(`${JSON.stringify(response)}\n`);
-}
-
-function bindConnectionHandler(params: {
-  server: Server;
-  context: AgentContext;
-  runtime?: AgentRuntime;
-}): void {
-  const { server, context, runtime } = params;
-  server.on("connection", (socket) => {
-    let buffered = "";
-    socket.setEncoding("utf8");
-    socket.on("data", async (chunk) => {
-      buffered += String(chunk || "");
-      const newlineIndex = buffered.indexOf("\n");
-      if (newlineIndex < 0) return;
-      const raw = buffered.slice(0, newlineIndex).trim();
-      if (!raw) {
-        writeResponse(socket, createErrorResponse("unknown", 400, "Empty local RPC payload"));
-        return;
-      }
-      try {
-        const request = JSON.parse(raw) as LocalRpcRequest;
-        const response = await dispatchRequest({
-          request,
-          context,
-          runtime,
-        });
-        writeResponse(socket, response);
-      } catch (error) {
-        writeResponse(
-          socket,
-          createErrorResponse("unknown", 400, `Invalid local RPC request: ${String(error)}`),
-        );
-      }
-    });
-  });
-}
-
-/**
- * 启动本地 RPC server。
- */
-export async function startLocalRpcServer(params: {
-  context: AgentContext;
-  runtime: AgentRuntime;
-}): Promise<LocalRpcServerHandle> {
-  const endpoint = getLocalRpcEndpoint(params.context.rootPath);
-  await ensureEndpointReady(endpoint);
-
-  const server = net.createServer();
-  bindConnectionHandler({
-    server,
-    context: params.context,
-    runtime: params.runtime,
-  });
-
-  await new Promise<void>((resolve, reject) => {
-    server.once("error", reject);
-    server.listen(endpoint, () => resolve());
-  });
-
-  return {
-    endpoint,
-    async stop() {
-      await new Promise<void>((resolve) => {
-        server.close(() => resolve());
-      });
-      if (process.platform !== "win32") {
-        await fs.remove(endpoint);
-      }
-    },
-  };
-}