@downcity/agent 1.1.212 → 1.1.216

package/src/index.ts

@@ -146,11 +146,6 @@ export type {
   SessionComposerOptions,
 } from "./types/session/SessionComposerOptions.js";
 export { transformPromptsIntoSystemMessages } from "./executor/composer/system/default/PromptRenderer.js";
-export {
-  loadStaticSystemPrompts,
-  StaticPromptCatalog,
-} from "./executor/composer/system/default/StaticPromptCatalog.js";
-
 // 通用 plugin 宿主工具
 export {
   buildStaticPluginAvailability,
@@ -198,10 +193,12 @@ export type {
 // 项目与配置集成
 export {
   initializeAgentProject,
-  isAgentProjectInitialized,
   normalizeDefaultAgentId,
 } from "./config/AgentInitializer.js";
-export { loadDowncityConfig } from "./config/Config.js";
+export {
+  load_project_dotenv,
+  resolve_agent_env,
+} from "./config/AgentEnv.js";
 export {
   getDowncityChatHistoryPath,
   getDowncitySessionMessagesPath,
@@ -238,7 +235,14 @@ export type {
 export type { ExecutionBindingConfig } from "./types/config/ExecutionBinding.js";
 
 // 配置与模型类型
-export type { DowncityConfig } from "./types/config/DowncityConfig.js";
+export type {
+  DowncityChatChannelConfig,
+  DowncityChatPluginChannelsConfig,
+  DowncityChatPluginConfig,
+  DowncityChatPluginQueueConfig,
+  DowncityConfig,
+  DowncityPluginConfigMap,
+} from "./types/config/DowncityConfig.js";
 export type {
   LlmConfig,
   LlmModelConfig,
@@ -266,14 +270,6 @@ export type {
 
 export type {
   PlatformAgentChatChannelStatus,
-  PlatformAgentShipChatChannelsConfig,
-  PlatformAgentShipChatPluginConfig,
-  PlatformAgentShipExecutionAgentConfig,
-  PlatformAgentShipExecutionConfig,
-  PlatformAgentShipJson,
-  PlatformAgentShipPluginsConfig,
-  PlatformAgentShipSingleChannelConfig,
-  PlatformAgentShipStartConfig,
 } from "./types/runtime/platform/PlatformGateway.js";
 
 // Inline instant 协议类型

package/src/plugin/core/PluginLocalExecution.ts

@@ -9,7 +9,7 @@
 
 import path from "node:path";
 import { logger as defaultLogger } from "@/utils/logger/Logger.js";
-import { resolveAgentEnv } from "@/config/Config.js";
+import { resolve_agent_env } from "@/config/AgentEnv.js";
 import { findPluginByName } from "@/plugin/core/PluginCatalog.js";
 import {
   createAgentPathRuntime,
@@ -39,7 +39,7 @@ export function createLocalPluginCommandContext(
 ): PluginCommandContext {
   const projectRoot = typeof input === "string" ? input : input.projectRoot;
   const rootPath = path.resolve(String(projectRoot || "").trim() || ".");
-  const env = resolveAgentEnv(rootPath);
+  const env = resolve_agent_env(rootPath);
   const config = typeof input === "string" || !input.config
     ? createFallbackSdkConfig(path.basename(rootPath) || "agent")
     : input.config;

package/src/types/agent/AgentOptions.ts

@@ -11,6 +11,7 @@ import type { Shell } from "@downcity/shell";
 import type { Plugin } from "@/types/plugin/PluginDefinition.js";
 import type { AgentModel } from "@/model/CityModelAdapter.js";
 import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
+import type { AgentPluginConfigRuntime } from "@/types/agent/AgentRuntimeAssembly.js";
 import type {
   AgentManagedSession,
   SessionOptions,
@@ -66,7 +67,7 @@ export interface AgentOptions {
    *
    * 关键点（中文）
    * - `instruction` 是稳定、缓存友好的 system 前缀，不做动态变量替换。
-   * - SDK 不主动读取 `PROFILE.md` / `SOUL.md`；这类项目文件应由 city 或调用方读取后传入。
+   * - 项目目录不再提供隐式 prompt 文件；调用方需要的指令必须显式传入。
    * - 未传入时，SDK 会使用包内最小 core instruction 作为 fallback。
    */
   instruction?: string | string[];
@@ -116,8 +117,17 @@ export interface AgentOptions {
    * 宿主显式传入的运行时配置。
    *
    * 关键点（中文）
-   * - SDK 不要求项目目录存在 `downcity.json`。
-   * - CLI / Console 可从自己的配置存储读取后传入这里。
+   * - SDK 不读取项目配置文件。
+   * - CLI / Console 从自己的全局配置存储读取后传入这里。
    */
   config?: DowncityConfig;
+
+  /**
+   * 宿主提供的 plugin 配置持久化能力。
+   *
+   * 关键点（中文）
+   * - SDK 默认会拒绝持久化操作；CLI 等宿主可在这里接入自己的全局数据库。
+   * - plugin 只依赖该稳定接口，不感知 SQLite、文件或远端服务等具体实现。
+   */
+  plugin_config?: AgentPluginConfigRuntime;
 }

package/src/types/common/EnvFile.ts

@@ -2,7 +2,7 @@
  * Env 文件工具相关类型定义。
  *
  * 职责说明（中文）
- * - 统一描述 `.env` / `.env.example` 写入工具使用的最小数据结构。
+ * - 统一描述项目 `.env` 写入工具使用的最小数据结构。
  * - 避免工具模块直接内联匿名对象，便于后续在其他初始化流程中复用。
  * - 这里只描述“文件写入条目”，不承载运行时环境变量快照语义。
  */

package/src/types/config/DowncityConfig.ts

@@ -74,20 +74,6 @@ export interface DowncityChatPluginQueueConfig {
   mergeMaxWaitMs?: number;
 }
 
-/**
- * 聊天插件出站控制配置。
- */
-export interface DowncityChatPluginEgressConfig {
-  /**
-   * 单次 agent run 内，`chat_send` 允许调用的最大次数。
-   */
-  chatSendMaxCallsPerRun?: number;
-  /**
-   * 是否启用 `chat_send` 幂等去重（基于 inbound messageId + 回复内容 hash）。
-   */
-  chatSendIdempotency?: boolean;
-}
-
 /**
  * 聊天插件配置。
  */
@@ -96,10 +82,6 @@ export interface DowncityChatPluginConfig {
    * Chat 调度队列（按 chatKey 分 lane）。
    */
   queue?: DowncityChatPluginQueueConfig;
-  /**
-   * 出站（egress）控制：用于限制工具发送、避免重复与无限循环刷屏。
-   */
-  egress?: DowncityChatPluginEgressConfig;
   /**
    * 消息平台 channel 配置。
    */
@@ -107,7 +89,7 @@ export interface DowncityChatPluginConfig {
 }
 
 /**
- * downcity.json 中的插件配置映射。
+ * Agent 全局配置中的插件配置映射。
  */
 export interface DowncityPluginConfigMap {
   /**
@@ -124,7 +106,6 @@ export interface DowncityPluginConfigMap {
 }
 
 export interface DowncityConfig {
-  $schema?: string;
   /**
    * agent 唯一标识。
    *
@@ -147,7 +128,7 @@ export interface DowncityConfig {
    *
    * 关键点（中文）
    * - 所有可配置能力统一收敛到 `plugins`，不再保留独立 `services` 域。
-   * - 需要持久化到项目文件的 plugin 配置（例如 `plugins.chat.channels`）放在这里。
+   * - 需要持久化的 plugin 配置（例如 `plugins.chat.channels`）由宿主写入全局配置存储。
    * - key 为 plugin 名称，value 为对应插件的结构化配置对象。
    * - 当前阶段允许各 plugin 自定义字段，但必须保持 JSON 可序列化。
    */
@@ -166,7 +147,7 @@ export interface DowncityConfig {
    * 关键点（中文）
    * - `@downcity/agent` 本地 SDK 不直接消费该字段。
    * - 宿主侧（例如 `downcity`）可读取该字段控制模型工厂行为，例如 `llm.logMessages`。
-   * - 对于项目内 `downcity.json`，通常不需要显式写 provider/model 明细。
+   * - 该字段通常由宿主平台装配，不由 Agent SDK 解析。
    */
   llm?: LlmConfig;
 }

package/src/types/config/ExecutionBinding.ts

@@ -4,7 +4,7 @@
  * 关键点（中文）
  * - 项目运行入口只有一种执行模式：`api`。
  * - 绑定 City AIService 暴露的模型 ID。
- * - 该类型是项目 `downcity.json` 中唯一的执行配置。
+ * - 该类型是 Agent 全局配置中的执行绑定结构。
  */
 
 /**

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

@@ -17,7 +17,7 @@ export interface PlatformAgentOption {
   id: string;
 
   /**
-   * agent 项目自身的稳定标识（优先 downcity.json.id，回退目录名推导）。
+   * Agent 全局配置中的稳定标识。
    */
   agentId: string;
 
@@ -90,7 +90,7 @@ export interface PlatformAgentOption {
   }>;
 
   /**
-   * 当前 agent 绑定的 console 模型 ID（downcity.json.execution.modelId）。
+   * 当前 Agent 全局配置绑定的模型 ID。
    */
   modelId?: string;
 }
@@ -154,16 +154,6 @@ export interface PlatformAgentDirectoryInspection {
    */
   initialized: boolean;
 
-  /**
-   * `downcity.json` 是否存在。
-   */
-  hasShipJson: boolean;
-
-  /**
-   * `PROFILE.md` 是否存在。
-   */
-  hasProfileMd: boolean;
-
   /** 该目录是否已出现在 managed agent registry 中。 */
   knownAgent: boolean;
 
@@ -266,7 +256,7 @@ export interface ControlPlaneRuntimeStatus {
  */
 export interface PlatformConfigFileStatusItem {
   /**
-   * 配置文件逻辑名称（例如 `ship_json`、`control_plane_pid`）。
+   * 配置状态逻辑名称（例如 `agent_config`、`control_plane_pid`）。
    */
   key: string;
 
@@ -336,7 +326,7 @@ export interface PlatformConfigStatusResponse {
   selectedAgentId: string;
 
   /**
-   * 当前选中的 agent 项目 id（即 `downcity.json.id`，可能为空）。
+   * 当前选中的 Agent 配置 id（可能为空）。
    */
   selectedAgentProjectId: string;
 

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

@@ -1,146 +1,10 @@
 /**
- * 平台控制面读取 agent 项目配置与 runtime 状态时使用的宽松类型。
+ * 平台控制面读取 Agent runtime 状态时使用的宽松类型。
  *
  * 关键点（中文）
  * - 仅承载平台 gateway / control plane 内部使用的结构化类型。
- * - 所有字段保持宽松输入，便于兼容磁盘 JSON 与运行时 API 的非强约束数据。
+ * - 所有字段保持宽松输入，便于兼容运行时 API 的非强约束数据。
  */
-
-/**
- * downcity.json 中的 ACP agent 配置。
- */
-export interface PlatformAgentShipExecutionAgentConfig {
-  /**
-   * ACP agent 类型。
-   */
-  type?: unknown;
-  /**
-   * 自定义启动命令。
-   */
-  command?: unknown;
-  /**
-   * 自定义启动参数。
-   */
-  args?: unknown;
-  /**
-   * 自定义环境变量。
-   */
-  env?: unknown;
-}
-
-/**
- * downcity.json 中的 execution 配置。
- */
-export interface PlatformAgentShipExecutionConfig {
-  /**
-   * 执行模式。
-   */
-  type?: unknown;
-  /**
-   * 模型执行模式下的模型 ID。
-   */
-  modelId?: unknown;
-  /**
-   * ACP 执行模式下的 agent 配置。
-   */
-  agent?: PlatformAgentShipExecutionAgentConfig;
-}
-
-/**
- * 单个聊天渠道配置。
- */
-export interface PlatformAgentShipSingleChannelConfig {
-  /**
-   * 渠道是否启用。
-   */
-  enabled?: unknown;
-
-  /**
-   * 绑定的渠道账户 id。
-   */
-  channelAccountId?: unknown;
-}
-
-/**
- * 聊天插件渠道配置集合。
- */
-export interface PlatformAgentShipChatChannelsConfig {
-  /**
-   * Telegram 渠道配置。
-   */
-  telegram?: PlatformAgentShipSingleChannelConfig;
-
-  /**
-   * 飞书渠道配置。
-   */
-  feishu?: PlatformAgentShipSingleChannelConfig;
-
-  /**
-   * QQ 渠道配置。
-   */
-  qq?: PlatformAgentShipSingleChannelConfig;
-}
-
-/**
- * 聊天插件配置。
- */
-export interface PlatformAgentShipChatPluginConfig {
-  /**
-   * 渠道配置集合。
-   */
-  channels?: PlatformAgentShipChatChannelsConfig;
-}
-
-/**
- * downcity.json 中的 plugins 配置。
- */
-export interface PlatformAgentShipPluginsConfig {
-  /**
-   * chat 插件配置。
-   */
-  chat?: PlatformAgentShipChatPluginConfig;
-}
-
-/**
- * downcity.json 中的启动配置。
- */
-export interface PlatformAgentShipStartConfig {
-  /**
-   * downcity Agent HTTP gateway host。
-   */
-  host?: unknown;
-
-  /**
-   * downcity Agent HTTP gateway port。
-   */
-  port?: unknown;
-}
-
-/**
- * downcity.json 宽松结构。
- */
-export interface PlatformAgentShipJson {
-  /**
-   * agent 稳定标识。
-   */
-  id?: unknown;
-
-  /**
-   * 执行配置。
-   */
-  execution?: PlatformAgentShipExecutionConfig;
-
-  /**
-   * 插件配置。
-   */
-  plugins?: PlatformAgentShipPluginsConfig;
-
-  /**
-   * 启动配置。
-   */
-  start?: PlatformAgentShipStartConfig;
-}
-
 /**
  * chat plugin status 返回中的单渠道状态。
  */

package/src/utils/logger/FormatRequest.ts

@@ -335,7 +335,7 @@ export function parseFetchRequestForLog(
 } | null {
   // 关键注释：这里的 maxChars 不用于“整体截断请求日志”，仅作为 payload 兜底 stringify 的保护上限。
   const maxChars = 12000;
-  // 统一开关：只由 downcity.json 的 llm.logMessages 控制（由宿主模型工厂读取）。
+  // 统一开关：只由宿主配置的 llm.logMessages 控制（由宿主模型工厂读取）。
   // 这里不支持额外的“更敏感 payload”开关，避免不一致与误配置。
   const includePayload = false;