@downcity/agent 1.1.43 → 1.1.51

package/src/types/config/DowncityConfig.ts

@@ -149,9 +149,15 @@ export interface DowncityPluginConfigMap {
 
 export interface DowncityConfig {
   $schema?: string;
-  name: string;
+  /**
+   * agent 唯一标识。
+   *
+   * 关键点（中文）
+   * - `@downcity/agent` 只关心稳定标识，不承担展示名语义。
+   * - 该字段同时用于 session/runtime/storage 目录归属。
+   */
+  id: string;
   version: string;
-  description?: string;
   /**
    * Runtime startup configuration used by `downcity agent start`.
    * CLI flags (if provided) take precedence over this config.
@@ -195,69 +201,4 @@ export interface DowncityConfig {
    * - 对于项目内 `downcity.json`，通常不需要显式写 provider/model 明细。
    */
   llm?: LlmConfig;
-  /**
-   * 上下文管理（工程向配置）。
-   *
-   * 说明
-   * - 对话消息以 UIMessage[] 为唯一事实源（`.downcity/agents/<agentId>/sessions/<sessionId>/messages/messages.jsonl`）。
-   * - Agent 每次执行直接把 UIMessage[] 转成 ModelMessage[] 作为 messages 输入。
-   * - 超出上下文窗口时会自动 compact（更早段压缩为摘要 + 保留最近窗口）。
-   */
-  context?: {
-    /**
-     * messages（唯一上下文消息来源）的 compact 策略。
-     */
-    messages?: {
-      /**
-       * 历史兼容字段（保留）。
-       *
-       * 说明（中文）
-       * - 当前默认策略按 `compactRatio` 压缩前段消息。
-       * - 该字段仍会写入 compact 元信息，便于观测与旧配置兼容。
-       *
-       * 默认：30
-       */
-      keepLastMessages?: number;
-      /**
-       * 输入预算（近似 token 数）。
-       *
-       * 说明（中文）
-       * - 这里是近似值，用于在调用 provider 前提前触发 compact
-       * - 实际超窗仍会被 provider 拒绝并进入 retry（更激进 compact）
-       *
-       * 默认：128000
-       */
-      maxInputTokensApprox?: number;
-      /**
-       * compact 时是否归档被折叠的原始消息段（写入 messages/archive/）。
-       * 默认：true
-       */
-      archiveOnCompact?: boolean;
-
-      /**
-       * 前段压缩比例（0-1）。
-       *
-       * 说明（中文）
-       * - 触发 compact 后，优先压缩最早一段消息。
-       * - `0.5` 代表优先压缩“最早 50% 的 UIMessage”。
-       * - 实际切分会做边界保护（至少保留 1 条最近消息）。
-       *
-       * 默认：0.5
-       */
-      compactRatio?: number;
-    };
-    /**
-     * 记忆管理配置。
-     *
-     * 设计目标
-     * - 默认开启，开箱即用（零配置）
-     * - 仅保留总开关，避免复杂配置负担
-     */
-    memory?: {
-      /**
-       * 是否启用 memory plugin。
-       */
-      enabled?: boolean;
-    };
-  };
 }

package/src/types/config/LlmConfig.ts

@@ -47,7 +47,7 @@ export interface LlmProviderConfig {
   baseUrl?: string;
   /**
    * Provider API 密钥。
-   * 建议使用 `${ENV_VAR}` 形式，启动时会自动解析环境变量。
+   * 建议由 Console 模型池直接保存，或由宿主在运行时显式注入 env 后再回退读取。
    */
   apiKey?: string;
 }

package/src/types/config/Start.ts

@@ -4,6 +4,8 @@
  * 字段说明（中文）
  * - `port`/`host`：主 API 服务监听地址。
  *   - `agent start/restart` 中的 `port` 由 console 自动分配（CLI 不再暴露 `--port`）。
+ * - `rpcPort`：Agent 本机 RPC 监听端口。
+ *   - 属于内部启动参数，通常由 city 自动分配，不面向普通用户。
  * - `daemon`：兼容旧参数（显式声明后台/前台）。
  * - `foreground`：显式前台启动。
  */
@@ -11,6 +13,7 @@
 export interface StartOptions {
   port?: number | string;
   host?: string;
+  rpcPort?: number | string;
   daemon?: boolean | string;
   foreground?: boolean | string;
 }

package/src/types/runtime/host/Store.ts

@@ -190,11 +190,6 @@ export interface UpsertModelInput {
   isPaused?: boolean;
 }
 
-/**
- * Env 条目作用域。
- */
-export type StoredEnvScope = "global" | "agent";
-
 /**
  * 平台环境变量记录。
  */
@@ -203,18 +198,10 @@ export interface StoredEnvEntry {
    * Env 作用域。
    *
    * 关键点（中文）
-   * - `global` 表示平台控制面全局共享变量。
-   * - `agent` 表示仅某个 agent 可见的私有变量。
-   */
-  scope: StoredEnvScope;
-  /**
-   * Agent 唯一标识（使用 projectRoot 绝对路径）。
-   *
-   * 关键点（中文）
-   * - 仅当 `scope=agent` 时有值。
-   * - `scope=global` 时为空。
+   * - 当前版本只保留 `global` 单一作用域。
+   * - 所有平台 Env 都视为宿主级共享变量，由宿主决定是否注入具体运行实例。
    */
-  agentId?: string;
+  scope: "global";
   /**
    * 环境变量 key（例如 `OPENAI_API_KEY`）。
    */
@@ -247,16 +234,12 @@ export interface StoredEnvEntry {
 export interface UpsertEnvEntryInput {
   /**
    * Env 作用域。
-   */
-  scope: StoredEnvScope;
-  /**
-   * Agent 唯一标识（projectRoot）。
    *
    * 关键点（中文）
-   * - 仅 `scope=agent` 时必填。
-   * - `scope=global` 时忽略。
+   * - 当前只允许写入 `global`。
+   * - 保留该字段是为了让宿主侧调用点显式表达“这是平台全局 env 写入”。
    */
-  agentId?: string;
+  scope: "global";
   /**
    * 环境变量 key。
    */
@@ -276,42 +259,13 @@ export interface UpsertEnvEntryInput {
 
 /**
  * 全局环境变量记录。
- *
- * 关键点（中文）
- * - 作为统一 `StoredEnvEntry` 的别名保留。
- * - 调用方可继续按全局 env 语义使用。
  */
 export type StoredGlobalEnvEntry = StoredEnvEntry;
 
-/**
- * Agent 私有环境变量记录。
- *
- * 关键点（中文）
- * - 作为统一 `StoredEnvEntry` 的别名保留。
- * - 调用方可继续按 agent env 语义使用。
- */
-export type StoredAgentEnvEntry = StoredEnvEntry;
-
 /**
  * 全局环境变量写入参数。
- *
- * 关键点（中文）
- * - 作为统一 `UpsertEnvEntryInput` 的别名保留。
- */
-export type UpsertGlobalEnvEntryInput = Omit<UpsertEnvEntryInput, "scope" | "agentId">;
-
-/**
- * Agent 私有环境变量写入参数。
- *
- * 关键点（中文）
- * - 作为统一 `UpsertEnvEntryInput` 的别名保留。
  */
-export type UpsertAgentEnvEntryInput = Omit<UpsertEnvEntryInput, "scope"> & {
-  /**
-   * Agent 唯一标识（projectRoot）。
-   */
-  agentId: string;
-};
+export type UpsertGlobalEnvEntryInput = Omit<UpsertEnvEntryInput, "scope">;
 
 /**
  * Channel Account 记录。

package/src/types/runtime/platform/Platform.ts

@@ -17,9 +17,9 @@ export interface PlatformAgentOption {
   id: string;
 
   /**
-   * agent 显示名称（优先 downcity.json.name，回退目录名）。
+   * agent 项目自身的稳定标识（优先 downcity.json.id，回退目录名推导）。
    */
-  name: string;
+  agentId: string;
 
   /**
    * agent 项目根目录（绝对路径）。
@@ -173,9 +173,9 @@ export interface PlatformAgentDirectoryInspection {
   running: boolean;
 
   /**
-   * 展示名称（优先 downcity.json.name，回退目录名）。
+   * 当前目录解析出的 agent id（若存在）。
    */
-  displayName: string;
+  agentId?: string;
 
   /**
    * 当前读取到的主模型 ID（若存在）。
@@ -336,9 +336,9 @@ export interface PlatformConfigStatusResponse {
   selectedAgentId: string;
 
   /**
-   * 当前选中的 agent 名称（可能为空）。
+   * 当前选中的 agent 项目 id（即 `downcity.json.id`，可能为空）。
    */
-  selectedAgentName: string;
+  selectedAgentProjectId: string;
 
   /**
    * 配置文件状态列表。

package/src/types/runtime/platform/PlatformGateway.ts

@@ -135,9 +135,9 @@ export interface PlatformAgentShipStartConfig {
  */
 export interface PlatformAgentShipJson {
   /**
-   * agent 展示名称。
+   * agent 稳定标识。
    */
-  name?: unknown;
+  id?: unknown;
 
   /**
    * 执行配置。

package/src/utils/Time.ts

@@ -10,12 +10,6 @@ export function getTimestamp(): string {
   return new Date().toISOString();
 }
 
-export function formatDuration(ms: number): string {
-  if (ms < 1000) return `${ms}ms`;
-  if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;
-  return `${(ms / 60000).toFixed(1)}m`;
-}
-
 export function resolveRuntimeTimezone(): string {
   const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
   return String(timezone || "").trim() || "UTC";

package/src/utils/storage/index.ts

@@ -17,10 +17,3 @@ export async function ensureDir(dir: string): Promise<void> {
 export async function saveJson(filePath: string, data: JsonValue | object): Promise<void> {
   await fs.writeJson(filePath, data, { spaces: 2 });
 }
-
-export async function loadJson<T>(filePath: string): Promise<T | null> {
-  if (!fs.existsSync(filePath)) {
-    return null;
-  }
-  return fs.readJson(filePath) as Promise<T>;
-}