@downcity/agent 1.1.43 → 1.1.62

package/src/types/config/DowncityConfig.ts

@@ -149,11 +149,17 @@ 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`.
+   * Runtime startup configuration used by `town agent start`.
    * CLI flags (if provided) take precedence over this config.
    */
   start?: {
@@ -175,7 +181,7 @@ export interface DowncityConfig {
    *
    * 关键点（中文）
    * - 项目只有一种执行模式：`api`。
-   * - 绑定平台全局模型池中的模型 ID。
+   * - 绑定 City AIService 暴露的模型 ID。
    */
   execution?: ExecutionBindingConfig;
   /**
@@ -191,73 +197,8 @@ export interface DowncityConfig {
    *
    * 关键点（中文）
    * - `@downcity/agent` 本地 SDK 不直接消费该字段。
-   * - 宿主侧（例如 `@downcity/city`）可读取该字段控制模型工厂行为，例如 `llm.logMessages`。
+   * - 宿主侧（例如 `downcity`）可读取该字段控制模型工厂行为，例如 `llm.logMessages`。
    * - 对于项目内 `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/ExecutionBinding.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 项目运行入口只有一种执行模式：`api`。
- * - 绑定平台全局模型池中的模型 ID。
+ * - 绑定 City AIService 暴露的模型 ID。
  * - 该类型是项目 `downcity.json` 中唯一的执行配置。
  */
 
@@ -17,11 +17,11 @@ export interface ExecutionBindingConfig {
   type: "api";
 
   /**
-   * 平台全局模型池中的模型 ID。
+   * City AIService 中的模型 ID。
    *
    * 说明（中文）
-   * - 必须能在 `~/.downcity/downcity.db` 的模型池中解析到。
-   * - 例如：`default`、`fast`、`quality`。
+   * - 必须能通过 City 的 `/v1/ai/models` 目录查询到。
+   * - 例如：`deepseek-v4-flash`、`fast`、`quality`。
    */
   modelId: string;
 }

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/auth/AuthPermission.ts

@@ -44,8 +44,8 @@ export const AUTH_PERMISSION_DESCRIPTIONS: Record<AuthPermissionKey, string> = {
   "agent.execute": "触发 agent 执行与会话运行。",
   "task.read": "查看 task 定义与运行结果。",
   "task.run": "创建或手动执行 task。",
-  "model.read": "查看模型池与模型绑定。",
-  "model.write": "修改模型池与模型绑定。",
+  "model.read": "查看 City AIService 模型与模型绑定。",
+  "model.write": "修改模型绑定。",
   "env.read": "查看环境变量配置。",
   "env.write": "修改环境变量配置。",
   "channel.read": "查看渠道账号与渠道状态。",

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

@@ -1,200 +1,16 @@
 /**
- * 模型存储（SQLite）类型定义。
+ * 平台宿主存储类型定义。
  *
  * 关键点（中文）
- * - 该类型用于平台控制面全局模型池（provider/model）的统一读写。
- * - agent 项目只通过 `execution.modelId` 绑定模型 ID，不直接持有 provider 细节。
+ * - Town 只保存平台级 env、channel account 与安全配置。
+ * - 模型能力由 City AIService 暴露，Town 不再声明 provider/model 存储类型。
  */
-import type { LlmProviderType } from "@/types/config/LlmConfig.js";
 
 /**
  * Channel Account 支持的渠道类型。
  */
 export type StoredChannelAccountChannel = "telegram" | "feishu" | "qq";
 
-/**
- * 模型 provider 记录。
- */
-export interface StoredModelProvider {
-  /**
-   * provider 主键 ID（例如：`openai_main`、`default`）。
-   */
-  id: string;
-  /**
-   * provider 类型（决定 SDK 分支与默认网关行为）。
-   */
-  type: LlmProviderType;
-  /**
-   * provider 基础地址（可选）。
-   */
-  baseUrl?: string;
-  /**
-   * provider API Key（解密后的明文；仅在运行时内存中使用）。
-   */
-  apiKey?: string;
-  /**
-   * 创建时间（ISO 字符串）。
-   */
-  createdAt: string;
-  /**
-   * 更新时间（ISO 字符串）。
-   */
-  updatedAt: string;
-}
-
-/**
- * provider 元信息。
- *
- * 关键点（中文）
- * - 仅保留同步读取所需的轻量字段。
- * - 不包含解密后的 API Key，避免在只读展示链路中泄露敏感信息。
- */
-export interface StoredProviderMeta {
-  /**
-   * provider 主键 ID。
-   */
-  id: string;
-  /**
-   * provider 类型。
-   */
-  type: LlmProviderType;
-  /**
-   * provider 基础地址（可选）。
-   */
-  baseUrl?: string;
-}
-
-/**
- * 模型记录。
- */
-export interface StoredModel {
-  /**
-   * 模型主键 ID（例如：`default`、`fast`、`quality`）。
-   */
-  id: string;
-  /**
-   * 关联 provider ID。
-   */
-  providerId: string;
-  /**
-   * 上游模型名称（例如 `gpt-4o-mini`）。
-   */
-  name: string;
-  /**
-   * 采样温度（可选）。
-   */
-  temperature?: number;
-  /**
-   * 最大输出 token（可选）。
-   */
-  maxTokens?: number;
-  /**
-   * topP（可选）。
-   */
-  topP?: number;
-  /**
-   * frequencyPenalty（可选）。
-   */
-  frequencyPenalty?: number;
-  /**
-   * presencePenalty（可选）。
-   */
-  presencePenalty?: number;
-  /**
-   * Anthropic 版本字段（可选）。
-   */
-  anthropicVersion?: string;
-  /**
-   * 是否暂停该模型。
-   *
-   * 关键点（中文）
-   * - 暂停后禁止作为 `execution.modelId` 被运行时加载。
-   * - 用于模型维护窗口、成本管控或临时故障隔离。
-   */
-  isPaused: boolean;
-  /**
-   * 创建时间（ISO 字符串）。
-   */
-  createdAt: string;
-  /**
-   * 更新时间（ISO 字符串）。
-   */
-  updatedAt: string;
-}
-
-/**
- * provider 写入参数。
- */
-export interface UpsertModelProviderInput {
-  /**
-   * provider ID。
-   */
-  id: string;
-  /**
-   * provider 类型。
-   */
-  type: LlmProviderType;
-  /**
-   * provider baseUrl（可选）。
-   */
-  baseUrl?: string;
-  /**
-   * provider apiKey（可选）。
-   */
-  apiKey?: string;
-}
-
-/**
- * model 写入参数。
- */
-export interface UpsertModelInput {
-  /**
-   * 模型 ID。
-   */
-  id: string;
-  /**
-   * provider ID。
-   */
-  providerId: string;
-  /**
-   * 上游模型名称。
-   */
-  name: string;
-  /**
-   * 采样温度（可选）。
-   */
-  temperature?: number;
-  /**
-   * 最大输出 token（可选）。
-   */
-  maxTokens?: number;
-  /**
-   * topP（可选）。
-   */
-  topP?: number;
-  /**
-   * frequencyPenalty（可选）。
-   */
-  frequencyPenalty?: number;
-  /**
-   * presencePenalty（可选）。
-   */
-  presencePenalty?: number;
-  /**
-   * Anthropic 版本字段（可选）。
-   */
-  anthropicVersion?: string;
-  /**
-   * 是否暂停该模型（可选）。
-   */
-  isPaused?: boolean;
-}
-
-/**
- * Env 条目作用域。
- */
-export type StoredEnvScope = "global" | "agent";
-
 /**
  * 平台环境变量记录。
  */
@@ -203,18 +19,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 +55,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 +80,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/http/InlineInstant.ts

@@ -40,7 +40,7 @@ export interface PlatformInlineInstantRunInput {
   pageContext?: string;
 
   /**
-   * `model` executor 对应的模型池 modelId。
+   * `model` executor 对应的 City AIService modelId。
    */
   modelId?: string;
 

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;
 
   /**
    * 配置文件状态列表。
@@ -402,7 +402,7 @@ export interface ManagedAgentRegistryV1 {
 }
 
 /**
- * `city agent list --running` 输出可复用的受管 agent 运行态视图。
+ * `town agent list --running` 输出可复用的受管 agent 运行态视图。
  */
 export interface ManagedAgentProcessView {
   /**

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>;
-}

package/tsconfig.json

@@ -4,6 +4,7 @@
     "module": "NodeNext",
     "moduleResolution": "NodeNext",
     "lib": ["ES2022"],
+    "types": ["node"],
     "outDir": "./bin",
     "rootDir": "src",
     "paths": {