@downcity/agent 1.1.10 → 1.1.12

package/src/{host → transport}/rpc/Paths.ts

@@ -9,8 +9,28 @@
  */
 
 import crypto from "node:crypto";
+import os from "node:os";
 import path from "node:path";
-import { getCityRuntimeDirPath } from "@/host/runtime/CityPaths.js";
+
+/**
+ * 读取 Downcity 平台级根目录。
+ *
+ * 关键点（中文）
+ * - local RPC socket 必须和 city 包使用同一个全局 runtime 目录。
+ * - 这里保留路径约定，但不引入 city runtime/registry 实现。
+ */
+function getPlatformRootDirPath(): string {
+  const explicitRoot = String(process.env.DC_PLATFORM_ROOT || "").trim();
+  if (explicitRoot) return path.resolve(explicitRoot);
+  return path.join(os.homedir(), ".downcity");
+}
+
+/**
+ * 读取平台级运行目录。
+ */
+function getPlatformRuntimeDirPath(): string {
+  return path.join(getPlatformRootDirPath(), "main");
+}
 
 function buildProjectDigest(projectRoot: string): string {
   return crypto
@@ -26,7 +46,7 @@ function buildWindowsPipeName(projectRoot: string): string {
 }
 
 function getLocalRpcUnixDirPath(): string {
-  return path.join(getCityRuntimeDirPath(), "local-rpc");
+  return path.join(getPlatformRuntimeDirPath(), "local-rpc");
 }
 
 /**

package/src/{config/types → types/config}/DowncityConfig.ts

@@ -5,9 +5,9 @@
  * - 作为全局共享类型，不挂在 console 目录下。
  * - 供 agent、services、control plane 宿主层多处复用，避免反向类型依赖。
  */
-import type { LlmConfig } from "@/config/types/LlmConfig.js";
-import type { ExecutionBindingConfig } from "@/config/types/ExecutionBinding.js";
-import type { JsonObject } from "@/utils/types/Json.js";
+import type { LlmConfig } from "@/types/config/LlmConfig.js";
+import type { ExecutionBindingConfig } from "@/types/config/ExecutionBinding.js";
+import type { JsonObject } from "@/types/common/Json.js";
 import type { SandboxProjectConfig } from "@/sandbox/types/Sandbox.js";
 
 export interface DowncityConfig {

package/src/{host/daemon/types → types/daemon}/Daemon.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 这里统一描述 agent daemon 的 pid/log/meta 文件命名与元信息结构。
- * - city 全局后台的运行时文件命名不放在这里，而是放到 `main/city/runtime/CityPaths.ts`。
+ * - city 全局后台的运行时文件命名不放在这里，而是放到 city 包的 process/registry 路径模块。
  */
 
 /** daemon pid 文件名。 */

package/src/{host/types → types/host}/AgentHost.ts

@@ -2,12 +2,12 @@
  * Agent 宿主能力类型定义。
  *
  * 关键点（中文）
- * - 这里统一描述由 main 装配、再挂入 AgentRuntime 的宿主能力。
- * - services / sessions / plugins 只能消费这些稳定能力，不应直接依赖 `main/*` 实现。
+ * - 这里统一描述由 agent runtime 装配、再挂入 AgentRuntime 的宿主能力。
+ * - service / session / plugin 只能消费这些稳定能力，不应直接依赖具体宿主实现。
  * - 当前先收敛路径、认证、plugin 配置持久化三类高频能力。
  */
 
-import type { DowncityConfig } from "@/config/types/DowncityConfig.js";
+import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
 import type {
   ChatAuthorizationChannel,
   ChatAuthorizationConfig,
@@ -22,10 +22,10 @@ import type {
   StoredChannelAccount,
   StoredModel,
   StoredModelProvider,
-} from "@/host/types/Store.js";
+} from "@/types/host/Store.js";
 import type { ChatChannelName } from "@/service/builtins/chat/types/ChannelStatus.js";
-import type { AgentProjectInitializationInput } from "@/agent/project/types/AgentProject.js";
-import type { PlatformModelChoice } from "@/agent/project/AgentInitializer.js";
+import type { AgentProjectInitializationInput } from "@/project/types/AgentProject.js";
+import type { PlatformModelChoice } from "@/project/AgentInitializer.js";
 
 /**
  * Agent 路径能力集合。

package/src/{host/types → types/host}/Store.ts

@@ -5,7 +5,7 @@
  * - 该类型用于平台控制面全局模型池（provider/model）的统一读写。
  * - agent 项目只通过 `execution.modelId` 绑定模型 ID，不直接持有 provider 细节。
  */
-import type { LlmProviderType } from "@/config/types/LlmConfig.js";
+import type { LlmProviderType } from "@/types/config/LlmConfig.js";
 
 /**
  * Channel Account 支持的渠道类型。

package/src/{host/rpc/types → types/rpc}/LocalRpc.ts

@@ -6,7 +6,7 @@
  * - 当前协议采用“一连接一请求一响应”的 JSON 行格式，便于调试与逐步演进。
  */
 
-import type { JsonValue } from "@/utils/types/Json.js";
+import type { JsonValue } from "@/types/common/Json.js";
 import type { DaemonHttpMethod } from "@/host/daemon/Api.js";
 
 /**

package/src/utils/Template.ts

@@ -6,7 +6,7 @@
  * - 供 init 模板与 runtime system prompt 渲染复用，避免重复实现。
  */
 
-import type { TemplateVariableMap } from "@/utils/types/Template.js";
+import type { TemplateVariableMap } from "@/types/common/Template.js";
 
 /**
  * 渲染模板中的 `{{variable}}` 占位符。

package/src/utils/logger/Fetch.ts

@@ -3,7 +3,7 @@ import {
   parseFetchResponseForLog,
   type ProviderFetch,
 } from "./Format.js";
-import type { JsonObject } from "@/utils/types/Json.js";
+import type { JsonObject } from "@/types/common/Json.js";
 
 export type LlmLogContext = {
   sessionId?: string;

package/src/utils/logger/FormatRequest.ts

@@ -6,7 +6,7 @@
  * - system / messages / tool calls 的展示策略统一收敛在本文件。
  */
 
-import type { JsonObject, JsonValue } from "@/utils/types/Json.js";
+import type { JsonObject, JsonValue } from "@/types/common/Json.js";
 import {
   buildInfoAttrs,
   contentToText,
@@ -335,7 +335,7 @@ export function parseFetchRequestForLog(
 } | null {
   // 关键注释：这里的 maxChars 不用于“整体截断请求日志”，仅作为 payload 兜底 stringify 的保护上限。
   const maxChars = 12000;
-  // 统一开关：只由 downcity.json 的 llm.logMessages 控制（见 main/city/model/CreateModel.ts）。
+  // 统一开关：只由 downcity.json 的 llm.logMessages 控制（见 model/CreateModel.ts）。
   // 这里不支持额外的“更敏感 payload”开关，避免不一致与误配置。
   const includePayload = false;
 

package/src/utils/logger/FormatResponse.ts

@@ -6,7 +6,7 @@
  * - 日志里保留状态、内容类型、函数调用摘要，方便定位 provider 行为。
  */
 
-import type { JsonObject, JsonValue } from "@/utils/types/Json.js";
+import type { JsonObject, JsonValue } from "@/types/common/Json.js";
 import {
   formatLogField,
   getArrayField,

package/src/utils/logger/FormatShared.ts

@@ -6,7 +6,7 @@
  * - 请求侧和响应侧各自的业务规则放到独立模块，避免继续堆成单文件巨石。
  */
 
-import type { JsonObject, JsonValue } from "@/utils/types/Json.js";
+import type { JsonObject, JsonValue } from "@/types/common/Json.js";
 
 /**
  * 允许被识别为日志 payload 的解析结果。

package/src/utils/logger/Logger.ts

@@ -10,7 +10,7 @@ import fs from "fs-extra";
 import path from "path";
 import { getLogsDirPath } from "@/config/Paths.js";
 import { getTimestamp } from "@/utils/Time.js";
-import type { JsonObject } from "@/utils/types/Json.js";
+import type { JsonObject } from "@/types/common/Json.js";
 
 type LogDetails = {
   [key: string]: JsonObject[keyof JsonObject] | undefined;

package/src/utils/storage/index.ts

@@ -6,7 +6,7 @@
  * 2. 统一封装 fs-extra 的常用行为，减少业务层重复判断。
  */
 import fs from "fs-extra";
-import type { JsonValue } from "@/utils/types/Json.js";
+import type { JsonValue } from "@/types/common/Json.js";
 
 export async function ensureDir(dir: string): Promise<void> {
   if (!fs.existsSync(dir)) {