@downcity/agent 1.1.32 → 1.1.35

package/src/plugin/builtins/chat/runtime/ChatChannelCore.ts

@@ -14,7 +14,7 @@ import type { ChatChannelState } from "@/plugin/builtins/chat/types/ChatRuntime.
 
 const CHAT_CHANNEL_NAMES: ChatChannelName[] = ["telegram", "feishu", "qq"];
 
-type ChatServiceRuntimeBindings = {
+type ChatRuntimeBindings = {
   getChannelAccountId?(context: AgentContext, channel: ChatChannelName): string;
   resolveChannelAccount?(
     context: AgentContext,
@@ -23,11 +23,11 @@ type ChatServiceRuntimeBindings = {
   isChannelEnabled?(context: AgentContext, channel: ChatChannelName): boolean;
 };
 
-function resolveChatServiceBindings(
+function resolveChatPluginBindings(
   context: AgentContext,
-): ChatServiceRuntimeBindings | null {
-  const candidate = context.agent?.runtimePlugins?.get?.("chat") as
-    | ChatServiceRuntimeBindings
+): ChatRuntimeBindings | null {
+  const candidate = context.agent?.pluginInstances?.get?.("chat") as
+    | ChatRuntimeBindings
     | undefined;
   return candidate || null;
 }
@@ -74,10 +74,10 @@ export function resolveChannelAccountId(
   context: AgentContext,
   channel: ChatChannelName,
 ): string {
-  const service = resolveChatServiceBindings(context);
-  const explicit = String(service?.getChannelAccountId?.(context, channel) || "").trim();
+  const plugin = resolveChatPluginBindings(context);
+  const explicit = String(plugin?.getChannelAccountId?.(context, channel) || "").trim();
   if (explicit) return explicit;
-  const config = context.config.services?.chat?.channels?.[channel] as
+  const config = context.config.plugins?.chat?.channels?.[channel] as
     | { channelAccountId?: unknown }
     | undefined;
   return String(config?.channelAccountId || "").trim();
@@ -90,8 +90,8 @@ export function resolveChannelAccount(
   context: AgentContext,
   channel: ChatChannelName,
 ): StoredChannelAccount | null {
-  const service = resolveChatServiceBindings(context);
-  const explicit = service?.resolveChannelAccount?.(context, channel);
+  const plugin = resolveChatPluginBindings(context);
+  const explicit = plugin?.resolveChannelAccount?.(context, channel);
   if (explicit) return explicit;
   const channelAccountId = resolveChannelAccountId(context, channel);
   const account = context.platform.resolveChannelAccount?.({
@@ -125,11 +125,11 @@ export function isChatChannelEnabled(
   context: AgentContext,
   channel: ChatChannelName,
 ): boolean {
-  const service = resolveChatServiceBindings(context);
-  if (typeof service?.isChannelEnabled === "function") {
-    return service.isChannelEnabled(context, channel);
+  const plugin = resolveChatPluginBindings(context);
+  if (typeof plugin?.isChannelEnabled === "function") {
+    return plugin.isChannelEnabled(context, channel);
   }
-  return context.config.services?.chat?.channels?.[channel]?.enabled === true;
+  return context.config.plugins?.chat?.channels?.[channel]?.enabled === true;
 }
 
 /**

package/src/plugin/builtins/chat/runtime/ChatChannelFacade.ts

@@ -4,7 +4,7 @@
  * 关键点（中文）
  * - 这里只负责把 channel 相关子模块重新聚合为一个稳定入口。
  * - 内部实现已经拆为 core / lifecycle / config / actions 四层。
- * - 这样可以在不影响 ChatService 与 action 调用方的前提下，持续收敛复杂度。
+ * - 这样可以在不影响 `ChatPlugin` 与 action 调用方的前提下，持续收敛复杂度。
  */
 
 export {

package/src/plugin/builtins/chat/runtime/ChatChannelLifecycle.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 渠道 bot 的创建、启动、停止逻辑统一收敛在这里。
- * - bot 实例状态归属于 ChatService 实例持有的 ChatChannelState。
+ * - 渠道 bot 状态归属于 chat plugin runtime 实例持有的 `ChatChannelState`。
  * - 本模块不处理 downcity.json 写入，也不负责 action 输入输出包装。
  */
 

package/src/plugin/builtins/chat/runtime/ChatMetaStore.ts

@@ -2,8 +2,8 @@
  * ChatMetaStore：按 sessionId 维护 chat 路由元信息。
  *
  * 关键点（中文）
- * - 入站消息到达时由 service/builtins/chat 写入
- * - 出站按 sessionId/chatKey 发送时由 service/builtins/chat 读取
+ * - 入站消息到达时由 chat plugin runtime 写入
+ * - 出站按 sessionId/chatKey 发送时由 chat plugin runtime 读取
  * - 底层数据落在 `.downcity/channel/meta.json`，由 ChannelContextStore 统一维护
  */
 

package/src/plugin/builtins/chat/runtime/ChatPluginActionRegistry.ts

@@ -1,9 +1,9 @@
 /**
- * ChatPluginActions：chat service 的 action 注册表模块。
+ * ChatPluginActions：chat plugin runtime 的 action 注册表模块。
  *
  * 关键点（中文）
  * - 这里专门负责把 chat 的 CLI/execute 定义装配成 `PluginActions`。
- * - ChatService 本体只保留实例状态与 lifecycle，不再承载大段 action 声明。
+ * - `ChatPlugin` 本体只保留实例状态与 lifecycle，不再承载大段 action 声明。
  * - action 执行仍然复用各 runtime 模块，确保行为与现有实现保持一致。
  */
 
@@ -95,7 +95,7 @@ function attachCommandHelpText(command: Command, text: string): void {
 }
 
 /**
- * 创建 chat service 的 action 定义表。
+ * 创建 chat plugin runtime 的 action 定义表。
  */
 export function createChatPluginActions(params: {
   channelState: ChatChannelState;

package/src/plugin/builtins/chat/runtime/ChatPluginSystem.ts

@@ -12,7 +12,7 @@ import {
   resolveCurrentChatEnvironmentPromptInput,
 } from "@/plugin/builtins/chat/runtime/SystemPrompt.js";
 import {
-  CHAT_SERVICE_PROMPT,
+  CHAT_PLUGIN_PROMPT,
   FEISHU_CHAT_CHANNEL_PROMPT,
   QQ_CHAT_CHANNEL_PROMPT,
   TELEGRAM_CHAT_CHANNEL_PROMPT,
@@ -61,7 +61,7 @@ export async function buildChatPluginSystem(
   context: AgentContext,
 ): Promise<string> {
   return [
-    CHAT_SERVICE_PROMPT,
+    CHAT_PLUGIN_PROMPT,
     await buildCurrentChatEnvironmentPrompt(context),
     ...(await buildCurrentChannelPrompts(context)),
   ]

package/src/plugin/builtins/chat/runtime/ChatPromptAssets.ts

@@ -1,20 +1,20 @@
 /**
- * ChatPromptAssets：chat service 静态提示词资产。
+ * ChatPromptAssets：chat plugin runtime 静态提示词资产。
  *
  * 关键点（中文）
  * - prompt 文本真实来源是 `*.ts.txt` 文本文件。
  * - 这里统一做 `trim()`，避免多渠道 prompt 行为不一致。
  */
 
-import chatServicePromptText from "@/plugin/builtins/chat/PROMPT.direct.js";
+import chatPluginPromptText from "@/plugin/builtins/chat/PROMPT.direct.js";
 import feishuChatPromptText from "@/plugin/builtins/chat/channels/feishu/PROMPT.direct.js";
 import qqChatPromptText from "@/plugin/builtins/chat/channels/qq/PROMPT.direct.js";
 import telegramChatPromptText from "@/plugin/builtins/chat/channels/telegram/PROMPT.direct.js";
 
 /**
- * chat service 基础 prompt。
+ * chat plugin runtime 基础 prompt。
  */
-export const CHAT_SERVICE_PROMPT = chatServicePromptText.trim();
+export const CHAT_PLUGIN_PROMPT = chatPluginPromptText.trim();
 
 /**
  * 飞书 channel prompt。

package/src/plugin/builtins/chat/runtime/ChatQueueStore.ts

@@ -1,9 +1,9 @@
 /**
- * ChatQueueStore：chat service 队列存储。
+ * ChatQueueStore：chat plugin runtime 队列存储。
  *
  * 关键点（中文）
  * - 这是 chat queue 的实例级状态容器。
- * - 允许 `ChatService` 持有自己的 queue store，而不是完全依赖模块级全局状态。
+ * - 允许 `ChatPlugin` 持有自己的 queue store，而不是完全依赖模块级全局状态。
  * - 旧的 `ChatQueue.ts` 会保留共享门面，逐步迁移到显式实例注入。
  */
 
@@ -20,7 +20,7 @@ import type {
 export type ChatQueueEnqueueListener = (laneKey: string) => void;
 
 /**
- * ChatService queue store 的最小能力接口。
+ * ChatPlugin queue store 的最小能力接口。
  */
 export interface ChatQueueStorePort {
   /**
@@ -171,11 +171,11 @@ export function getSharedChatQueueStore(): ChatQueueStore {
  * 从运行时解析 chat queue store。
  *
  * 关键点（中文）
- * - 新路径优先读取 `runtime.agent.runtimePlugins.chat.queueStore`。
+ * - 新路径优先读取 `runtime.agent.pluginInstances.chat.queueStore`。
  * - 迁移阶段若拿不到，则回退到共享 queue store，保证旧入口可继续工作。
  */
 export function resolveChatQueueStore(runtime?: AgentContext): ChatQueueStorePort {
-  const chatService = runtime?.agent?.runtimePlugins?.get?.("chat") as
+  const chatService = runtime?.agent?.pluginInstances?.get?.("chat") as
     | { queueStore?: ChatQueueStorePort }
     | undefined;
   if (chatService?.queueStore) {

package/src/plugin/builtins/chat/runtime/ChatQueueWorker.ts

@@ -1,8 +1,8 @@
 /**
- * ChatQueueWorker：chat service 侧队列执行器。
+ * ChatQueueWorker：chat plugin runtime 侧队列执行器。
  *
  * 关键点（中文）
- * - 消费 services / chat 的队列模块
+ * - 消费 chat plugin runtime 持有的队列模块
  * - 只负责把 lane 中的新输入持续提交给 `session.prompt()`
  * - turn 并入策略、history 落盘、assistant 收敛统一交给 Session
  */
@@ -198,7 +198,7 @@ export class ChatQueueWorker {
    * 在单次执行期间维持“正在输入”心跳。
    *
    * 关键点（中文）
-   * - 通过 services / chat 的 dispatcher 发送动作（不经过 main bindings）
+   * - 通过 chat plugin runtime 的 dispatcher 发送动作（不经过 main bindings）
    * - 先发送一次，再按固定间隔续发
    * - 发送失败不影响主执行流程（best-effort）
    */

package/src/plugin/builtins/chat/runtime/ChatSession.ts

@@ -8,15 +8,15 @@
  */
 
 import type { LanguageModel, Tool } from "ai";
-import { Executor } from "@session/Executor.js";
-import type { SessionHistoryComposer } from "@session/composer/history/SessionHistoryComposer.js";
-import type { SessionHistoryStore } from "@/session/store/history/SessionHistoryStore.js";
-import type { SessionCompactionComposer } from "@session/composer/compaction/SessionCompactionComposer.js";
-import type { SessionSystemComposer } from "@session/composer/system/SessionSystemComposer.js";
+import { Executor } from "@executor/Executor.js";
+import type { SessionHistoryComposer } from "@executor/composer/history/SessionHistoryComposer.js";
+import type { SessionHistoryStore } from "@/executor/store/history/SessionHistoryStore.js";
+import type { SessionCompactionComposer } from "@executor/composer/compaction/SessionCompactionComposer.js";
+import type { SessionSystemComposer } from "@executor/composer/system/SessionSystemComposer.js";
 import type { ChatSessionContextComposer } from "@/plugin/builtins/chat/runtime/ChatSessionContextComposer.js";
 import type { Logger } from "@/utils/logger/Logger.js";
-import type { SessionAssistantStepCallback } from "@/session/types/SessionRun.js";
-import type { SessionRunResult } from "@/session/types/SessionRun.js";
+import type { SessionAssistantStepCallback } from "@/executor/types/SessionRun.js";
+import type { SessionRunResult } from "@/executor/types/SessionRun.js";
 import type { ChatSessionTurnState } from "@/plugin/builtins/chat/runtime/ChatSessionTypes.js";
 
 type ChatSessionOptions = {

package/src/plugin/builtins/chat/runtime/ChatSessionContextComposer.ts

@@ -8,10 +8,10 @@
  */
 
 import type { ModelMessage, Tool } from "ai";
-import { drainInjectedUserMessages } from "@session/SessionRunScope.js";
-import { LocalSessionContextComposer } from "@session/composer/context/LocalSessionContextComposer.js";
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
-import type { SessionSystemMessage } from "@/session/types/SessionPrompts.js";
+import { drainInjectedUserMessages } from "@executor/SessionRunScope.js";
+import { LocalSessionContextComposer } from "@executor/composer/context/LocalSessionContextComposer.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
+import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
 import type { ChatSessionTurnState } from "@/plugin/builtins/chat/runtime/ChatSessionTypes.js";
 
 type ChatSessionContextComposerOptions = {

package/src/plugin/builtins/chat/runtime/ChatSessionTypes.ts

@@ -6,8 +6,8 @@
  * - 普通 Session 仍可复用基础 `run / append*` 能力，不强耦合 chat 语义。
  */
 
-import type { SessionUserMessageV1 } from "@/session/types/SessionMessages.js";
-import type { SessionAssistantStepCallback } from "@/session/types/SessionRun.js";
+import type { SessionUserMessageV1 } from "@/executor/types/SessionMessages.js";
+import type { SessionAssistantStepCallback } from "@/executor/types/SessionRun.js";
 
 /**
  * ChatSession 单次 turn 绑定的运行态。

package/src/plugin/builtins/chat/runtime/ChatkeySend.ts

@@ -21,7 +21,7 @@ import { readChatMetaBySessionId } from "./ChatMetaStore.js";
  * 解析实际分发目标。
  *
  * 规则（中文）
- * - 仅使用 service/builtins/chat 维护的 session 路由映射。
+ * - 仅使用 chat plugin runtime 维护的 session 路由映射。
  * - 不再支持 legacy chatKey 字符串解析回退。
  */
 export async function resolveDispatchTargetByChatKey(params: {

package/src/plugin/builtins/chat/runtime/InboundAugment.ts

@@ -2,7 +2,7 @@
  * Chat inbound augment helper。
  *
  * 关键点（中文）
- * - chat service 先构造基础输入，再交给 plugin pipeline 做增强。
+ * - chat plugin runtime 先构造基础输入，再交给 plugin pipeline 做增强。
  * - 最终拼装顺序固定为：attachmentText -> pluginSections -> bodyText。
  */
 

package/src/plugin/builtins/chat/runtime/PluginDispatch.ts

@@ -2,7 +2,7 @@
  * PluginDispatch：chat 领域的 plugin 调用辅助。
  *
  * 关键点（中文）
- * - chat service 只依赖这里，不直接依赖某个具体 plugin 模块路径。
+ * - chat plugin runtime 只依赖这里，不直接依赖某个具体 plugin 模块路径。
  * - 这里封装 chat 领域的 plugin 点调用语义，保持 service 边界稳定。
  */
 
@@ -48,7 +48,7 @@ export async function observeIncomingChatPrincipal(params: {
  *
  * 关键点（中文）
  * - 这是 guard 语义：允许则静默返回，拒绝则直接抛错。
- * - 这样 chat service 可以像处理中间件一样串联 guard 点。
+ * - 这样 chat plugin runtime 可以像处理中间件一样串联 guard 点。
  */
 export async function guardIncomingChat(params: {
   context: AgentContext;

package/src/plugin/builtins/chat/runtime/PluginPoints.ts

@@ -1,21 +1,21 @@
 /**
- * Chat service plugin 点定义。
+ * Chat plugin 点定义。
  *
  * 关键点（中文）
- * - plugin 点由 chat service 定义，不由具体 plugin 定义。
- * - service 只依赖这些稳定点名，具体 plugin 负责实现其中某些点。
+ * - plugin 点由 chat plugin runtime 定义，不由具体 plugin 定义。
+ * - chat plugin runtime 只依赖这些稳定点名，具体 plugin 负责实现其中某些点。
  * - 后续新增 chat 生命周期 plugin 点，也应统一收敛到这里。
  */
 
 /**
- * Chat service 对外暴露的 plugin 点目录。
+ * Chat runtime 对外暴露的 plugin 点目录。
  */
 export const CHAT_PLUGIN_POINTS = {
   /**
    * 增强入站消息正文。
    *
    * 说明（中文）
-   * - service 先构造基础 attachment/body 文本。
+   * - chat plugin runtime 先构造基础 attachment/body 文本。
    * - plugin 通过 pipeline 往 `pluginSections` 中追加中间块。
    */
   augmentInbound: "chat.augmentInbound",
@@ -23,7 +23,7 @@ export const CHAT_PLUGIN_POINTS = {
    * 回复前文本增强。
    *
    * 说明（中文）
-   * - service 在真正回发到 channel 前调用。
+   * - chat plugin runtime 在真正回发到 channel 前调用。
    * - plugin 可在这里做收尾改写、格式整理、签名注入等。
    */
   beforeReply: "chat.beforeReply",
@@ -31,7 +31,7 @@ export const CHAT_PLUGIN_POINTS = {
    * 回复后事件通知。
    *
    * 说明（中文）
-   * - service 在一次回复发送完成后触发。
+   * - chat plugin runtime 在一次回复发送完成后触发。
    * - plugin 可在这里做审计、统计、回执同步等副作用。
    */
   afterReply: "chat.afterReply",
@@ -39,7 +39,7 @@ export const CHAT_PLUGIN_POINTS = {
    * 入队前数据增强。
    *
    * 说明（中文）
-   * - service 在 append ingress / enqueue 之前调用。
+   * - chat plugin runtime 在 append ingress / enqueue 之前调用。
    * - plugin 可在这里改写入队文本或补充 extra metadata。
    */
   beforeEnqueue: "chat.beforeEnqueue",
@@ -47,7 +47,7 @@ export const CHAT_PLUGIN_POINTS = {
    * 入队后事件通知。
    *
    * 说明（中文）
-   * - service 在消息真正入队完成后调用。
+   * - chat plugin runtime 在消息真正入队完成后调用。
    * - plugin 可在这里做统计、观测、调试落点。
    */
   afterEnqueue: "chat.afterEnqueue",
@@ -63,7 +63,7 @@ export const CHAT_PLUGIN_POINTS = {
    * 判定当前入站消息是否允许执行。
    *
    * 说明（中文）
-   * - 由 service 在 ingress 阶段显式调用。
+   * - 由 chat plugin runtime 在 ingress 阶段显式调用。
    * - 典型实现方是 auth plugin。
    */
   authorizeIncoming: "chat.authorizeIncoming",

package/src/plugin/builtins/chat/runtime/SystemPrompt.ts

@@ -7,7 +7,7 @@
  * - 统一从 request context + ChatMetaStore 读取当前 chat 元信息。
  */
 
-import { getSessionRunScope } from "@session/SessionRunScope.js";
+import { getSessionRunScope } from "@executor/SessionRunScope.js";
 import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type { ChatEnvironmentPromptInput } from "@/plugin/builtins/chat/types/ChatPromptContext.js";
 import { readChatMetaBySessionId } from "@/plugin/builtins/chat/runtime/ChatMetaStore.js";

package/src/plugin/builtins/chat/runtime/UIMessageTransformer.ts

@@ -14,7 +14,7 @@ import {
   type UIMessagePart,
   type UITools,
 } from "ai";
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
 import type { JsonObject, JsonValue } from "@/types/common/Json.js";
 
 type AnyUiMessagePart = UIMessagePart<UIDataTypes, UITools>;

package/src/plugin/builtins/chat/runtime/UserVisibleText.ts

@@ -7,7 +7,7 @@
  * - 因此需要一个稳定的、与 Agent 解耦的提取逻辑（属于 chat/egress 语义）
  */
 
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
 import {
   extractTextFromUiMessage,
   extractToolCallsFromUiMessage,

package/src/plugin/builtins/chat/types/ChannelContext.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 描述渠道目标（platform target）与内部 sessionId 的映射结构。
- * - 映射由 chat service 维护，sessionId 对外保持稳定但不可推导。
+ * - 映射由 chat plugin runtime 维护，sessionId 对外保持稳定但不可推导。
  */
 
 import type { ChatDispatchChannel } from "./ChatDispatcher.js";

package/src/plugin/builtins/chat/types/ChannelStatus.ts

@@ -42,7 +42,7 @@ export type ChatChannelStateSnapshot = {
    */
   channel: ChatChannelName;
   /**
-   * 是否在配置中启用（`downcity.json` 的 `services.chat.channels.<channel>.enabled`）。
+   * 是否在配置中启用（`downcity.json` 的 `plugins.chat.channels.<channel>.enabled`）。
    */
   enabled: boolean;
   /**

package/src/plugin/builtins/chat/types/ChatMessageMarkup.ts

@@ -2,7 +2,7 @@
  * Chat 消息标记语法类型。
  *
  * 关键点（中文）
- * - 统一描述 chat service 中可见的消息协议：frontmatter metadata + `<file>` 标签。
+ * - 统一描述 chat plugin runtime 中可见的消息协议：frontmatter metadata + `<file>` 标签。
  * - direct 模式、`city chat send`、入站附件注入、渠道出站解析都应复用本类型。
  */
 

package/src/plugin/builtins/chat/types/ChatMeta.ts

@@ -1,9 +1,9 @@
 /**
- * ChatMeta：chat 服务维护的 session 路由元信息。
+ * ChatMeta：chat plugin runtime 维护的 session 路由元信息。
  *
  * 关键点（中文）
  * - 只描述“如何把 sessionId 路由回平台 chat”
- * - 由 service/builtins/chat 在接收入站消息时更新
+ * - 由 chat plugin runtime 在接收入站消息时更新
  * - 不属于 core context message schema
  */
 

package/src/plugin/builtins/chat/types/ChatPlugin.ts

@@ -1,9 +1,9 @@
 /**
- * Chat service plugin 交互类型定义。
+ * Chat plugin 交互类型定义。
  *
  * 关键点（中文）
- * - 统一描述 chat service 与 plugin 之间的扩展 payload。
- * - service 负责定义结构，plugin 只消费这些稳定字段。
+ * - 统一描述 chat plugin runtime 与 plugin 之间的扩展 payload。
+ * - chat plugin runtime 负责定义结构，plugin 只消费这些稳定字段。
  * - 字段全部保持 Json 兼容，避免把函数或运行时私有对象塞进 plugin 点。
  */
 
@@ -36,7 +36,7 @@ export interface ChatPluginAttachment {
    * 附件本地绝对路径。
    *
    * 说明（中文）
-   * - 若 service 尚未把附件落地，则该字段可为空。
+   * - 若 chat plugin runtime 尚未把附件落地，则该字段可为空。
    * - 依赖本地文件的 plugin 应在缺失时跳过处理。
    */
   path?: string;
@@ -87,14 +87,14 @@ export interface ChatInboundAugmentInput {
    */
   rootPath: string;
   /**
-   * service 已生成的附件文本块。
+   * chat plugin runtime 已生成的附件文本块。
    *
    * 说明（中文）
    * - 一般是 `<file ...>` 标签拼接后的结果。
    */
   attachmentText?: string;
   /**
-   * service 已抽取的正文文本。
+   * chat plugin runtime 已抽取的正文文本。
    */
   bodyText?: string;
   /**

package/src/plugin/builtins/chat/types/ChatPluginActionPayload.ts

@@ -1,8 +1,8 @@
 /**
- * ChatService 类型定义。
+ * ChatPlugin action 类型定义。
  *
  * 关键点（中文）
- * - 这里集中声明 chat service action 的输入 payload。
+ * - 这里集中声明 chat plugin runtime action 的输入 payload。
  * - 这些类型属于跨模块共享契约，因此统一放到 `types/` 下。
  * - 字段命名保持与 CLI/API 参数一致，降低映射心智负担。
  */

package/src/plugin/builtins/chat/types/ChatPromptContext.ts

@@ -19,7 +19,7 @@ export interface ChatEnvironmentPromptInput {
    *
    * 说明（中文）
    * - 对外统一使用 `sessionId` 语义。
-   * - chat service 内部统一按 session 语义路由与持久化。
+   * - chat plugin runtime 内部统一按 session 语义路由与持久化。
    */
   sessionId: string;
 
@@ -27,7 +27,7 @@ export interface ChatEnvironmentPromptInput {
    * 当前 chatKey。
    *
    * 说明（中文）
-   * - chat service 里通常与 `sessionId` 一致。
+   * - chat plugin runtime 里通常与 `sessionId` 一致。
    * - 保留独立字段，避免未来路由键语义调整时影响调用方。
    */
   chatKey: string;

package/src/plugin/builtins/chat/types/ChatRuntime.ts

@@ -2,8 +2,8 @@
  * ChatRuntime 类型定义。
  *
  * 关键点（中文）
- * - 这些类型描述 chat service 的实例级运行态。
- * - channel bots 的状态所有权归属于 ChatService 实例，而不是模块级单例。
+ * - 这些类型描述 chat plugin runtime 的实例级运行态。
+ * - channel bots 的状态所有权归属于 `ChatPlugin` 实例，而不是模块级单例。
  */
 
 import type { FeishuBot } from "@/plugin/builtins/chat/channels/feishu/Feishu.js";
@@ -11,7 +11,7 @@ import type { QQBot } from "@/plugin/builtins/chat/channels/qq/QQ.js";
 import type { TelegramBot } from "@/plugin/builtins/chat/channels/telegram/Bot.js";
 
 /**
- * ChatService 实例持有的渠道状态。
+ * `ChatPlugin` 实例持有的渠道状态。
  *
  * 关键点（中文）
  * - 这里显式把 3 个内建渠道拆成独立槽位，避免继续使用弱类型 map。

package/src/plugin/builtins/contact/Action.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 这里只负责 CLI action 与内部远端 command action 映射，不承载 contact 业务实现。
- * - 业务动作通过 handlers 注入，保持 `ContactService` 类本身更薄。
+ * - 业务动作通过 handlers 注入，保持 `ContactPlugin` 类本身更薄。
  */
 
 import type { AgentContext } from "@/core/AgentContextTypes.js";
@@ -36,7 +36,7 @@ import {
 } from "./runtime/ContactPayload.js";
 
 /**
- * ContactService 注入给 action 注册表的业务动作。
+ * ContactPlugin 注入给 action 注册表的业务动作。
  */
 export type ContactActionHandlers = {
   /**
@@ -90,7 +90,7 @@ export type ContactActionHandlers = {
 };
 
 /**
- * 创建 contact service action 表。
+ * 创建 contact plugin action 表。
  */
 export function createContactActions(handlers: ContactActionHandlers): PluginActions {
   return {

package/src/plugin/builtins/contact/ContactPlugin.ts

@@ -434,14 +434,14 @@ export class ContactPlugin extends BasePlugin {
       return {
         success: true,
         agentName: getAgentName(context),
-        service: "contact",
+        plugin: "contact",
       };
     }
     const contact = await findContactByInboundToken(context.rootPath, token);
     return {
       success: true,
       agentName: getAgentName(context),
-      service: "contact",
+      plugin: "contact",
       authenticated: Boolean(contact && contact.status === "trusted"),
     };
   }

package/src/plugin/builtins/contact/runtime/ChatRuntime.ts

@@ -8,7 +8,7 @@
 
 import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type { ContactChatResponse } from "@/plugin/builtins/contact/types/ContactChat.js";
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
 import {
   appendContactMessage,
   findContactByInboundToken,

package/src/plugin/builtins/contact/runtime/ContactPromptAssets.ts

@@ -1,5 +1,5 @@
 /**
- * ContactPromptAssets：contact service 静态提示词资产。
+ * ContactPromptAssets：contact plugin runtime 静态提示词资产。
  *
  * 关键点（中文）
  * - contact prompt 文本真实来源是 `PROMPT.ts.txt`。
@@ -9,6 +9,6 @@
 import contactPromptText from "@/plugin/builtins/contact/PROMPT.js";
 
 /**
- * contact service system prompt。
+ * contact plugin runtime system prompt。
  */
 export const CONTACT_SERVICE_PROMPT = contactPromptText.trim();

package/src/plugin/builtins/contact/runtime/Paths.ts

@@ -1,5 +1,5 @@
 /**
- * contact service 路径规则。
+ * contact plugin runtime 路径规则。
  *
  * 关键点（中文）
  * - 所有 contact 运行时状态都收敛在 `.downcity/contact`。