@downcity/agent 1.1.32 → 1.1.35

package/src/types/config/DowncityConfig.ts

@@ -3,13 +3,150 @@
  *
  * 关键点（中文）
  * - 作为全局共享类型，不挂在 console 目录下。
- * - 供 agent、services、control plane 宿主层多处复用，避免反向类型依赖。
+ * - 供 agent、plugin、control plane 宿主层多处复用，避免反向类型依赖。
  */
 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 "@/runtime/sandbox/types/Sandbox.js";
 
+/**
+ * 单个聊天渠道配置。
+ */
+export interface DowncityChatChannelConfig {
+  /**
+   * 当前渠道是否启用。
+   */
+  enabled?: boolean;
+  /**
+   * 绑定的渠道账户 ID。
+   */
+  channelAccountId?: string;
+}
+
+/**
+ * 聊天插件渠道配置集合。
+ */
+export interface DowncityChatPluginChannelsConfig {
+  /**
+   * Telegram 渠道配置。
+   */
+  telegram?: DowncityChatChannelConfig;
+  /**
+   * Feishu 渠道配置。
+   */
+  feishu?: DowncityChatChannelConfig;
+  /**
+   * QQ 渠道配置。
+   */
+  qq?: DowncityChatChannelConfig;
+}
+
+/**
+ * 聊天插件队列配置。
+ */
+export interface DowncityChatPluginQueueConfig {
+  /**
+   * 全局最大并发（不同 chatKey 之间）。
+   * 默认：2
+   */
+  maxConcurrency?: number;
+  /**
+   * 入站消息合并的防抖窗口（毫秒）。
+   *
+   * 关键点（中文）
+   * - 同一 chatKey 在该窗口内连续到达的多条消息，会在一次 run 前一起并入上下文。
+   * - 典型场景：用户先发一句话，再紧接着转发链接/卡片。
+   * - 设为 `0` 或负数可关闭该能力（立即执行首条消息）。
+   *
+   * 默认：600
+   */
+  mergeDebounceMs?: number;
+  /**
+   * 入站消息合并的最长等待时间（毫秒）。
+   *
+   * 关键点（中文）
+   * - 即使用户持续发送新消息，也不会无限延期；达到该上限后会立刻启动 run。
+   * - 用于平衡“尽量合并上下文”与“响应时延可控”。
+   * - 当 `mergeDebounceMs <= 0` 时该字段不会生效。
+   *
+   * 默认：2000
+   */
+  mergeMaxWaitMs?: number;
+}
+
+/**
+ * 聊天插件出站控制配置。
+ */
+export interface DowncityChatPluginEgressConfig {
+  /**
+   * 单次 agent run 内，`chat_send` 允许调用的最大次数。
+   */
+  chatSendMaxCallsPerRun?: number;
+  /**
+   * 是否启用 `chat_send` 幂等去重（基于 inbound messageId + 回复内容 hash）。
+   */
+  chatSendIdempotency?: boolean;
+}
+
+/**
+ * 聊天插件配置。
+ */
+export interface DowncityChatPluginConfig {
+  /**
+   * Chat 调度队列（按 chatKey 分 lane）。
+   */
+  queue?: DowncityChatPluginQueueConfig;
+  /**
+   * 出站（egress）控制：用于限制工具发送、避免重复与无限循环刷屏。
+   */
+  egress?: DowncityChatPluginEgressConfig;
+  /**
+   * 消息平台 channel 配置。
+   */
+  channels?: DowncityChatPluginChannelsConfig;
+}
+
+/**
+ * skill 插件配置。
+ */
+export interface DowncitySkillPluginConfig {
+  /**
+   * 当前插件是否启用。
+   */
+  enabled?: boolean;
+  /**
+   * 技能目录列表。
+   */
+  paths?: string[];
+  /**
+   * 是否允许读取项目外部技能目录。
+   */
+  allowExternalPaths?: boolean;
+}
+
+/**
+ * downcity.json 中的插件配置映射。
+ */
+export interface DowncityPluginConfigMap {
+  /**
+   * chat 插件配置。
+   */
+  chat?: DowncityChatPluginConfig;
+  /**
+   * skill 插件配置。
+   */
+  skill?: DowncitySkillPluginConfig;
+  /**
+   * 其他插件配置。
+   */
+  [pluginName: string]:
+    | JsonObject
+    | DowncityChatPluginConfig
+    | DowncitySkillPluginConfig
+    | undefined;
+}
+
 export interface DowncityConfig {
   $schema?: string;
   name: string;
@@ -23,106 +160,16 @@ export interface DowncityConfig {
     port?: number;
     host?: string;
   };
-  /**
-   * services 配置。
-   *
-   * 关键点（中文）
-   * - 所有服务相关配置统一收敛到 `services` 下，避免顶层散落字段。
-   * - 例如：`services.chat.channels`、`services.chat.queue`。
-   */
-  services?: {
-    /**
-     * Chat service 配置。
-     */
-    chat?: {
-      /**
-       * Chat 调度队列（按 chatKey 分 lane）。
-       */
-      queue?: {
-        /**
-         * 全局最大并发（不同 chatKey 之间）。
-         * 默认：2
-         */
-        maxConcurrency?: number;
-        /**
-         * 入站消息合并的防抖窗口（毫秒）。
-         *
-         * 关键点（中文）
-         * - 同一 chatKey 在该窗口内连续到达的多条消息，会在一次 run 前一起并入上下文。
-         * - 典型场景：用户先发一句话，再紧接着转发链接/卡片。
-         * - 设为 `0` 或负数可关闭该能力（立即执行首条消息）。
-         *
-         * 默认：600
-         */
-        mergeDebounceMs?: number;
-        /**
-         * 入站消息合并的最长等待时间（毫秒）。
-         *
-         * 关键点（中文）
-         * - 即使用户持续发送新消息，也不会无限延期；达到该上限后会立刻启动 run。
-         * - 用于平衡“尽量合并上下文”与“响应时延可控”。
-         * - 当 `mergeDebounceMs <= 0` 时该字段不会生效。
-         *
-         * 默认：2000
-         */
-        mergeMaxWaitMs?: number;
-      };
-      /**
-       * 出站（egress）控制：用于限制工具发送、避免重复与无限循环刷屏。
-       */
-      egress?: {
-        /**
-         * 单次 agent run 内，`chat_send` 允许调用的最大次数。
-         */
-        chatSendMaxCallsPerRun?: number;
-        /**
-         * 是否启用 `chat_send` 幂等去重（基于 inbound messageId + 回复内容 hash）。
-         */
-        chatSendIdempotency?: boolean;
-      };
-      /**
-       * 消息平台 channel 配置。
-       */
-      channels?: {
-        telegram?: {
-          enabled: boolean;
-          /**
-           * 绑定的 channel account id（来源：平台全局 `~/.downcity/downcity.db`）。
-           */
-          channelAccountId?: string;
-        };
-        feishu?: {
-          enabled: boolean;
-          /**
-           * 绑定的 channel account id（来源：平台全局 `~/.downcity/downcity.db`）。
-           */
-          channelAccountId?: string;
-        };
-        qq?: {
-          enabled: boolean;
-          /**
-           * 绑定的 channel account id（来源：平台全局 `~/.downcity/downcity.db`）。
-           */
-          channelAccountId?: string;
-        };
-      };
-    };
-  };
   /**
    * plugins 配置。
    *
    * 关键点（中文）
-   * - 新插件体系的行为配置统一收敛到该字段。
-   * - plugin 私有配置（例如 `plugins.skill.paths`）也放在这里。
+   * - 所有可配置能力统一收敛到 `plugins`，不再保留独立 `services` 域。
+   * - plugin 私有配置（例如 `plugins.skill.paths`、`plugins.chat.channels`）也放在这里。
    * - key 为 plugin 名称，value 为对应插件的结构化配置对象。
    * - 当前阶段允许各 plugin 自定义字段，但必须保持 JSON 可序列化。
    */
-  plugins?: {
-    /**
-     * 插件配置对象映射。
-     */
-    [pluginName: string]: JsonObject;
-  };
+  plugins?: DowncityPluginConfigMap;
   /**
    * 项目执行绑定配置。
    *
@@ -135,7 +182,7 @@ export interface DowncityConfig {
    * shell / CLI 执行 sandbox 配置。
    *
    * 关键点（中文）
-   * - 当前只作用于 shell service 这条命令执行链。
+   * - 当前只作用于 shell plugin 这条命令执行链。
    * - 这里不表达审批、用户授权与复杂策略系统，只表达最小边界。
    */
   sandbox?: SandboxProjectConfig;
@@ -208,7 +255,7 @@ export interface DowncityConfig {
      */
     memory?: {
       /**
-       * 是否启用 memory service。
+       * 是否启用 memory plugin。
        */
       enabled?: boolean;
     };

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

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 这里统一描述由 agent runtime 装配、再挂入 AgentRuntime 的宿主能力。
- * - service / session / plugin 只能消费这些稳定能力，不应直接依赖具体宿主实现。
+ * - plugin runtime / session / plugin 作者 API 只能消费这些稳定能力，不应直接依赖具体宿主实现。
  * - 当前先收敛路径、认证、plugin 配置持久化三类高频能力。
  */
 

package/src/types/runtime/http/InlineInstant.ts

@@ -84,9 +84,9 @@ export interface PlatformInlineInstantRunResult {
 }
 
 /**
- * 平台 Inline 即时执行服务端口。
+ * 平台 Inline 即时执行运行端口。
  */
-export interface PlatformInlineInstantService {
+export interface PlatformInlineInstantRunner {
   /**
    * 运行一次即时执行请求。
    */

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

@@ -76,7 +76,7 @@ export interface PlatformAgentShipSingleChannelConfig {
 }
 
 /**
- * 聊天服务渠道配置集合。
+ * 聊天插件渠道配置集合。
  */
 export interface PlatformAgentShipChatChannelsConfig {
   /**
@@ -96,9 +96,9 @@ export interface PlatformAgentShipChatChannelsConfig {
 }
 
 /**
- * 聊天服务配置。
+ * 聊天插件配置。
  */
-export interface PlatformAgentShipChatServiceConfig {
+export interface PlatformAgentShipChatPluginConfig {
   /**
    * 渠道配置集合。
    */
@@ -106,13 +106,13 @@ export interface PlatformAgentShipChatServiceConfig {
 }
 
 /**
- * downcity.json 中的 services 配置。
+ * downcity.json 中的 plugins 配置。
  */
-export interface PlatformAgentShipServicesConfig {
+export interface PlatformAgentShipPluginsConfig {
   /**
-   * chat 服务配置。
+   * chat 插件配置。
    */
-  chat?: PlatformAgentShipChatServiceConfig;
+  chat?: PlatformAgentShipChatPluginConfig;
 }
 
 /**
@@ -145,9 +145,9 @@ export interface PlatformAgentShipJson {
   execution?: PlatformAgentShipExecutionConfig;
 
   /**
-   * 服务配置。
+   * 插件配置。
    */
-  services?: PlatformAgentShipServicesConfig;
+  plugins?: PlatformAgentShipPluginsConfig;
 
   /**
    * 启动配置。
@@ -156,7 +156,7 @@ export interface PlatformAgentShipJson {
 }
 
 /**
- * chat service status 返回中的单渠道状态。
+ * chat plugin status 返回中的单渠道状态。
  */
 export interface PlatformAgentChatChannelStatus {
   /**

package/src/types/sdk/AgentSessionEvent.ts

@@ -7,7 +7,7 @@
  */
 
 import type { JsonValue } from "@/types/common/Json.js";
-import type { SessionAssistantStepVisibility } from "@/session/types/SessionRun.js";
+import type { SessionAssistantStepVisibility } from "@/executor/types/SessionRun.js";
 
 /**
  * 单个 turn 开始事件。

package/src/types/sdk/AgentSessionTurn.ts

@@ -7,7 +7,7 @@
  * - 增量过程继续通过 `session.subscribe()` 观察；turn handle 只负责等待最终完成结果。
  */
 
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
 
 /**
  * 单个 Session turn 的最终结果。

package/tsconfig.json

@@ -8,8 +8,7 @@
     "rootDir": "src",
     "paths": {
       "@/*": ["./src/*"],
-      "@session/*": ["./src/session/*"],
-      "@services/*": ["./src/service/builtins/*"]
+      "@executor/*": ["./src/executor/*"]
     },
     "strict": true,
     "noImplicitAny": false,