@downcity/agent 1.1.32 → 1.1.35

package/src/{session → executor}/tools/shell/ShellToolFormatting.ts

@@ -2,12 +2,12 @@
  * Shell 工具辅助函数。
  *
  * 关键点（中文）
- * - shell 会话生命周期已经迁移到 `shellService`。
+ * - shell 会话生命周期已经统一收敛到 shell plugin runtime。
  * - 这里仅保留当前仍被 tool 与测试复用的最小能力：命令安全校验与 env 注入。
  */
 
 import { stripInvocationAuthEnv } from "@/runtime/server/http/auth/AuthEnv.js";
-import { getSessionRunScope } from "@session/SessionRunScope.js";
+import { getSessionRunScope } from "@executor/SessionRunScope.js";
 
 function setEnvString(
   env: NodeJS.ProcessEnv,
@@ -63,7 +63,7 @@ export function validateChatSendCommand(cmd: string): string | null {
  * 构建 shell 子进程环境变量。
  *
  * 关键点（中文）
- * - 当前仍用于 shell tool/service 与相关测试。
+ * - 当前仍用于 shell tool / shell runtime 与相关测试。
  * - 优先级：显式注入 > 当前请求上下文变量 > 宿主进程环境。
  * - 默认剥离 Bearer Token，避免通用 shell 隐式走本地 HTTP。
  */

package/src/{session → executor}/tools/shell/ShellToolSchemas.ts

@@ -35,7 +35,7 @@ export const shellStartInputSchema = z.object({
   auto_notify_on_exit: z
     .boolean()
     .optional()
-    .describe("Whether the shell service should auto-return to the owning chat agent when the command exits."),
+    .describe("Whether the shell plugin runtime should auto-return to the owning chat agent when the command exits."),
 });
 
 export const shellExecInputSchema = z.object({

package/src/{session → executor}/types/SessionExecutor.ts

@@ -6,7 +6,7 @@
  * - 当前只有 api 执行模式。
  */
 
-import type { SessionRunInput, SessionRunResult } from "@/session/types/SessionRun.js";
+import type { SessionRunInput, SessionRunResult } from "@/executor/types/SessionRun.js";
 
 /**
  * 单个 session 执行器接口。

package/src/{session → executor}/types/SessionRun.ts

@@ -8,8 +8,8 @@
  */
 
 import type { Tool, UIMessageChunk } from "ai";
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
-import type { SessionSystemMessage } from "@/session/types/SessionPrompts.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
+import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
 
 /**
  * Assistant step 可见性。

package/src/index.ts

@@ -4,15 +4,19 @@
  * 关键点（中文）
  * - 这是 agent 包唯一稳定的公开入口。
  * - 只导出 SDK、plugin 作者 API、city 运行集成 API 与跨包协议类型。
- * - HTTP router、sandbox runner、内部 runtime plugin runner 等实现细节不从根入口暴露。
+ * - HTTP router、sandbox runner、内部 plugin runtime runner 等实现细节不从根入口暴露。
  */
 
 // SDK 入口
 export { Agent } from "./sdk/Agent.js";
-export { Session } from "./sdk/Session.js";
 export { RemoteAgent } from "./sdk/RemoteAgent.js";
-export { AgentCore } from "./core/AgentCore.js";
 export type {
+  AgentMode,
+  AgentSessionCollection,
+  AgentSessionActor,
+  AgentSession,
+  AgentCreateSessionInput,
+  AgentListSessionsInput,
   AgentOptions,
   AgentHttpBinding,
   AgentHttpStartOptions,
@@ -23,12 +27,19 @@ export type {
   RemoteAgentOptions,
   AgentSessionConfigSnapshot,
   AgentSessionForkInput,
-  AgentSessionMetadata,
+  AgentSessionHistoryInput,
+  AgentSessionHistoryPage,
+  AgentSessionHistoryView,
+  AgentSessionInfo,
   AgentSessionSetInput,
+  AgentSessionSummary,
+  AgentSessionSummaryPage,
   AgentSessionSystemBlock,
   AgentSessionSystemBlockSource,
   AgentSessionSystemSessionInfo,
   AgentSessionSystemSnapshot,
+  AgentSessionTimelineEvent,
+  RemoteAgentSession,
 } from "./sdk/AgentSdkTypes.js";
 export type {
   AgentSessionEvent,
@@ -53,7 +64,7 @@ export type {
 // Plugin 作者 API
 export { BasePlugin } from "./plugin/core/BasePlugin.js";
 export { ChatPlugin } from "./plugin/builtins/chat/ChatPlugin.js";
-export { ChatChannelAccountService } from "./plugin/builtins/chat/accounts/ChannelAccountService.js";
+export { ChatChannelAccountManager } from "./plugin/builtins/chat/accounts/ChannelAccountManager.js";
 export type { ChatChannelAccountListItem } from "./plugin/builtins/chat/types/ChannelAccount.js";
 export type {
   ChatPluginChannelAccountProvider,
@@ -62,29 +73,29 @@ export type {
   ChatPluginQqOptions,
   ChatPluginTelegramOptions,
 } from "./plugin/builtins/chat/ChatPluginTypes.js";
-export { authPlugin } from "./plugin/builtins/auth/Plugin.js";
-export { skillPlugin } from "./plugin/builtins/skill/Plugin.js";
-export { webPlugin } from "./plugin/builtins/web/Plugin.js";
-export { asrPlugin } from "./plugin/builtins/asr/Plugin.js";
-export { ttsPlugin } from "./plugin/builtins/tts/Plugin.js";
-export { workboardPlugin } from "./plugin/builtins/workboard/Plugin.js";
+export { AuthPlugin } from "./plugin/builtins/auth/Plugin.js";
+export { SkillPlugin } from "./plugin/builtins/skill/Plugin.js";
+export { WebPlugin } from "./plugin/builtins/web/Plugin.js";
+export { AsrPlugin } from "./plugin/builtins/asr/Plugin.js";
+export { TtsPlugin } from "./plugin/builtins/tts/Plugin.js";
+export { WorkboardPlugin } from "./plugin/builtins/workboard/Plugin.js";
 
 // Session 与即时执行集成
-export { Executor } from "./session/Executor.js";
+export { Executor } from "./executor/Executor.js";
 export {
   drainDeferredPersistedUserMessages,
   getSessionRunScope,
-} from "./session/SessionRunScope.js";
-export { JsonlSessionHistoryComposer } from "./session/composer/history/jsonl/JsonlSessionHistoryComposer.js";
-export { JsonlSessionHistoryStore } from "./session/store/history/jsonl/JsonlSessionHistoryStore.js";
-export { JsonlSessionCompactionComposer } from "./session/composer/compaction/jsonl/JsonlSessionCompactionComposer.js";
-export type { SessionSystemComposer } from "./session/composer/system/SessionSystemComposer.js";
-export { transformPromptsIntoSystemMessages } from "./session/composer/system/default/PromptRenderer.js";
+} from "./executor/SessionRunScope.js";
+export { JsonlSessionHistoryComposer } from "./executor/composer/history/jsonl/JsonlSessionHistoryComposer.js";
+export { JsonlSessionHistoryStore } from "./executor/store/history/jsonl/JsonlSessionHistoryStore.js";
+export { JsonlSessionCompactionComposer } from "./executor/composer/compaction/jsonl/JsonlSessionCompactionComposer.js";
+export type { SessionSystemComposer } from "./executor/composer/system/SessionSystemComposer.js";
+export { transformPromptsIntoSystemMessages } from "./executor/composer/system/default/PromptRenderer.js";
 export {
   loadStaticSystemPrompts,
   StaticPromptCatalog,
-} from "./session/composer/system/default/StaticPromptCatalog.js";
-export { shellTools } from "./session/tools/shell/ShellToolDefinition.js";
+} from "./executor/composer/system/default/StaticPromptCatalog.js";
+export { shellTools } from "./executor/tools/shell/ShellToolDefinition.js";
 
 // Agent server 与 transport 集成
 export { startServer } from "./runtime/server/http/Server.js";
@@ -93,6 +104,8 @@ export { callAgentTransport } from "./runtime/transport/rpc/Transport.js";
 
 // Runtime plugin 运行集成
 export { listRegisteredPlugins } from "./plugin/core/PluginClassRegistry.js";
+export { listManagedPlugins } from "./plugin/core/PluginClassRegistry.js";
+export { listLocalPlugins } from "./plugin/core/PluginClassRegistry.js";
 export {
   startAllPlugins,
   stopAllPlugins,
@@ -119,7 +132,7 @@ export {
 } from "./plugin/core/Catalog.js";
 export { runLocalPluginAction } from "./plugin/core/LocalExecution.js";
 export { registerAllPluginsForCli } from "./plugin/core/PluginCommand.js";
-export { listBuiltinPluginRuntimeAuthPolicies } from "./plugin/core/HttpRoutes.js";
+export { listBuiltinPluginAuthPolicies } from "./plugin/core/HttpRoutes.js";
 export { persistProjectPluginConfig } from "./plugin/core/ProjectConfigStore.js";
 
 // 项目与配置集成
@@ -185,10 +198,11 @@ export type {
   PlatformAgentChatChannelStatus,
   PlatformAgentDaemonMeta,
   PlatformAgentShipChatChannelsConfig,
+  PlatformAgentShipChatPluginConfig,
   PlatformAgentShipExecutionAgentConfig,
   PlatformAgentShipExecutionConfig,
   PlatformAgentShipJson,
-  PlatformAgentShipServicesConfig,
+  PlatformAgentShipPluginsConfig,
   PlatformAgentShipSingleChannelConfig,
   PlatformAgentShipStartConfig,
 } from "./types/runtime/platform/PlatformGateway.js";
@@ -213,7 +227,7 @@ export type {
   InlineInstantExecutorType,
   PlatformInlineInstantRunInput,
   PlatformInlineInstantRunResult,
-  PlatformInlineInstantService,
+  PlatformInlineInstantRunner,
 } from "./types/runtime/http/InlineInstant.js";
 
 // Plugin 作者与控制面类型
@@ -234,10 +248,10 @@ export type {
   PluginPipelineHook,
   PluginPort,
   PluginResolveHook,
-  PluginRuntimeHttpRegistration,
-  PluginServiceInvokeParams,
-  PluginServiceInvokePort,
-  PluginServiceInvokeResult,
+  PluginHttpRegistration,
+  PluginActionInvokeParams,
+  PluginActionInvokePort,
+  PluginActionInvokeResult,
   PluginSetupDefinition,
   PluginSetupField,
   PluginSetupFieldOption,
@@ -248,6 +262,7 @@ export type {
 } from "./plugin/types/Plugin.js";
 export type {
   PluginActionResponse,
+  PluginCatalogResponse,
   PluginAvailabilityResponse,
   PluginAvailabilityView,
 } from "./plugin/types/PluginApi.js";
@@ -269,7 +284,7 @@ export type {
   PluginCommandResponse,
   PluginControlAction,
   PluginControlResponse,
-  PluginListResponse,
+  PluginStateListResponse,
   PluginStateView,
 } from "./plugin/types/Plugins.js";
 export type {

package/src/plugin/builtins/asr/Plugin.ts

@@ -7,6 +7,8 @@
  * - 当前作为 chat 入站消息增强中间件接入语音转写。
  */
 
+import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
+import { BasePlugin } from "@/plugin/core/BasePlugin.js";
 import type { Plugin } from "@/plugin/types/Plugin.js";
 import type { VoicePluginConfig } from "@/plugin/builtins/voice/types/VoicePlugin.js";
 import { CHAT_PLUGIN_POINTS } from "@/plugin/builtins/chat/runtime/PluginPoints.js";
@@ -31,11 +33,9 @@ import {
   writeVoiceTranscriberConfig,
 } from "@/plugin/builtins/asr/Dependency.js";
 
-/**
- * asrPlugin：声明式插件定义。
- */
-export const asrPlugin: Plugin = {
-  name: "asr",
+function createAsrPluginDefinition(plugin: Plugin): Plugin {
+  return {
+    name: "asr",
   title: "Automatic Speech Recognition",
   description:
     "Detects voice and audio attachments in inbound chat messages, runs transcription through the configured ASR dependency, and appends readable text so the agent can work with spoken input like normal message content.",
@@ -113,7 +113,7 @@ export const asrPlugin: Plugin = {
     statusAction: "status",
   },
   async availability(context) {
-    if (!isPluginEnabled({ plugin: asrPlugin, context })) {
+    if (!isPluginEnabled({ plugin, context })) {
       return {
         enabled: false,
         available: false,
@@ -147,7 +147,7 @@ export const asrPlugin: Plugin = {
       },
       execute: async ({ context }) => {
         const config = readVoicePluginConfig(context);
-        const availability = await asrPlugin.availability!(context);
+        const availability = await plugin.availability!(context);
         const transcriberConfig = readVoiceTranscriberConfig(context);
         return {
           success: true,
@@ -401,7 +401,7 @@ export const asrPlugin: Plugin = {
         },
       },
       execute: async ({ context, payload }) => {
-        const pluginStatus = await asrPlugin.availability!(context);
+        const pluginStatus = await plugin.availability!(context);
         if (!pluginStatus.enabled || !pluginStatus.available) {
           return {
             success: false,
@@ -450,7 +450,7 @@ export const asrPlugin: Plugin = {
         },
       },
       execute: async ({ context }) => {
-        const availability = await asrPlugin.availability!(context);
+        const availability = await plugin.availability!(context);
         const dependencyStatus = await checkVoiceTranscriber(context);
         return {
           success: true,
@@ -477,7 +477,7 @@ export const asrPlugin: Plugin = {
   },
   system(context) {
     const config = readVoicePluginConfig(context);
-    if (!isPluginEnabled({ plugin: asrPlugin, context }) || config.injectPrompt !== true) {
+    if (!isPluginEnabled({ plugin, context }) || config.injectPrompt !== true) {
       return "";
     }
     return [
@@ -485,4 +485,17 @@ export const asrPlugin: Plugin = {
       "Audio attachments may be transcribed before agent execution.",
     ].join("\n");
   },
-};
+  };
+}
+
+/**
+ * AsrPlugin：语音识别插件。
+ */
+export class AsrPlugin extends BasePlugin {
+  readonly name = "asr";
+
+  constructor(agent: AgentRuntime | null = null) {
+    super(agent);
+    Object.assign(this, createAsrPluginDefinition(this));
+  }
+}

package/src/plugin/builtins/auth/Plugin.ts

@@ -7,6 +7,8 @@
  * - auth plugin 只负责统一暴露扩展点 / action 边界，不改变底层存储模型。
  */
 
+import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
+import { BasePlugin } from "@/plugin/core/BasePlugin.js";
 import type { Plugin } from "@/plugin/types/Plugin.js";
 import type { JsonValue } from "@/types/common/Json.js";
 import { CHAT_PLUGIN_POINTS } from "@/plugin/builtins/chat/runtime/PluginPoints.js";
@@ -68,11 +70,9 @@ function toSnapshotData(snapshot: ChatAuthorizationSnapshot): JsonValue {
   };
 }
 
-/**
- * authPlugin：统一承载授权能力。
- */
-export const authPlugin: Plugin = {
-  name: "auth",
+function createAuthPluginDefinition(): Plugin {
+  return {
+    name: "auth",
   title: "User Authorization System",
   description:
     "Controls who can talk to the agent in chat channels, records observed users and chats, and resolves each user's effective role for downstream service decisions.",
@@ -206,4 +206,17 @@ export const authPlugin: Plugin = {
       },
     },
   },
-};
+  };
+}
+
+/**
+ * AuthPlugin：统一承载授权能力。
+ */
+export class AuthPlugin extends BasePlugin {
+  readonly name = "auth";
+
+  constructor(agent: AgentRuntime | null = null) {
+    super(agent);
+    Object.assign(this, createAuthPluginDefinition());
+  }
+}

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

@@ -7,7 +7,7 @@
  */
 
 import type { AgentContext } from "@/core/AgentContextTypes.js";
-import { getSessionRunScope } from "@session/SessionRunScope.js";
+import { getSessionRunScope } from "@executor/SessionRunScope.js";
 import {
   sendActionByChatKey,
   sendTextByChatKey,
@@ -111,7 +111,7 @@ export function resolveChatSessionSnapshot(input?: {
  * 将 sessionId 映射为可发送的 chatKey。
  *
  * 关键点（中文）
- * - 当前实现下：chat service 内部把 sessionId 视作可发送 chatKey。
+ * - 当前实现下：chat plugin runtime 内部把 sessionId 视作可发送 chatKey。
  * - 不再依赖字符串规则推导（sessionId 可为随机值）。
  */
 export function mapSessionIdToChatKey(sessionId?: string): string | undefined {
@@ -255,7 +255,7 @@ async function waitBeforeSend(params: {
  * 按 chatKey 发送文本。
  *
  * 关键点（中文）
- * - service 不关心具体平台；由 runtime sender 做 channel 分发。
+ * - chat plugin runtime 不关心具体平台；由 runtime sender 做 channel 分发。
  * - 返回统一结构，便于上层链路做可观测与错误汇总。
  */
 export async function sendChatTextByChatKey(params: {
@@ -397,7 +397,7 @@ export async function sendChatActionByChatKey(params: {
  * 按 sessionId 发送文本。
  *
  * 关键点（中文）
- * - sessionId -> chatKey 映射关系只在 chat service 内部维护。
+ * - sessionId -> chatKey 映射关系只在 chat plugin runtime 内部维护。
  */
 export async function sendChatTextBySessionId(params: {
   context: AgentContext;
@@ -439,7 +439,7 @@ export async function sendChatTextBySessionId(params: {
  * 按 chatKey/sessionId 彻底删除 chat 会话。
  *
  * 关键点（中文）
- * - chatKey 与 sessionId 在 chat service 内部等价使用。
+ * - chatKey 与 sessionId 在 chat plugin runtime 内部等价使用。
  * - 删除包含：路由映射 + chat 审计目录 + session 目录 + 渠道状态清理。
  */
 export async function deleteChatByChatKey(params: {

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

@@ -132,7 +132,7 @@ export class ChatPlugin extends BasePlugin {
   getQueueWorkerConfig(
     context: AgentContext,
   ): Partial<ChatQueueWorkerConfig> | undefined {
-    return this.options.queue || context.config.services?.chat?.queue;
+    return this.options.queue || context.config.plugins?.chat?.queue;
   }
 
   /**
@@ -143,7 +143,7 @@ export class ChatPlugin extends BasePlugin {
     if (explicit) {
       return explicit.enabled !== false;
     }
-    return context.config.services?.chat?.channels?.[channel]?.enabled === true;
+    return context.config.plugins?.chat?.channels?.[channel]?.enabled === true;
   }
 
   /**
@@ -156,7 +156,7 @@ export class ChatPlugin extends BasePlugin {
     const explicit = this.getExplicitChannelOptions(channel);
     const explicitAccountId = String(explicit?.channelAccountId || "").trim();
     if (explicitAccountId) return explicitAccountId;
-    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();

package/src/plugin/builtins/chat/ChatPluginTypes.ts

@@ -137,7 +137,7 @@ export interface ChatPluginOptions {
    * Chat queue worker 运行配置。
    *
    * 说明（中文）
-   * - 显式传入时优先级高于 `downcity.json.services.chat.queue`。
+   * - 显式传入时优先级高于 `downcity.json.plugins.chat.queue`。
    * - 可用于不同 client 定制并发、突发合并等行为。
    */
   queue?: Partial<ChatQueueWorkerConfig>;

package/src/plugin/builtins/chat/PROMPT.direct.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/plugin/builtins/chat/PROMPT.direct.ts.txt
-const TEXT_MODULE_CONTENT = "# Chat Service 使用说明\n\n## 用户可见回复规则\n\n- 当前模式下，直接输出，即会发送消息给到用户对应的channel\n\n## 输出协议\n\n- 需要普通回复时，直接输出文本即可。文本顶部可用 frontmatter metadata (optional)，字段语义与 `city chat send` 保持一致：\n\n- `delay` / `delayMs`：延迟发送毫秒数。\n- `time` / `sendAt` / `sendAtMs`：定时发送时间。\n- `reply`：是否使用 reply 语义发送。\n- `messageId`：目标 `message_id`（群聊推荐）。\n- `react`：发送表情反应。\n  - 单个字符串：`react: \"👍\"`\n  - 或对象/数组：`emoji/big`\n  - 设置 `messageId` 时，`react` 会优先复用该消息作为目标消息。\n- 附件使用 `<file type=\"...\">path</file>`（支持 `document/photo/voice/audio/video`）。\n- 附件路径必须是项目内可访问的相对路径。多附件可输出多个 `<file>` 标签。\n\n### 示例\n\n```text\n---\nreply: true\nmessageId: \"128\"\nreact:\n  - emoji: \"✅\"\n---\n这是今天的报告。\n<file type=\"document\">reports/daily.md</file>\n```\n\n### 协议约束\n\n- frontmatter 必须位于文本最开头（`---` 包裹）。\n- 除 `<file>` 附件标签外，不要使用尖括号格式做控制参数。\n\n## 跨协议/跨平台操作\n\n- 当任务需要跨会话、跨平台或复杂路由，必须使用 `city chat send` / `city chat react`。\n- metadata 只适用于当前会话内的 direct 出站，不要拿 metadata 做跨 chat 路由。\n- 如果需要跨 chat 发送，或者不清楚怎么发送，直接先调用 `city chat --help` 查看方法。\n- 如不确定参数或正文协议，先自行调用：\n  - `city chat --help`\n  - `city chat send --help`\n  - `city chat react --help`\n\n## 入站消息结构（仅供内部理解）\n\n- 每条入队用户消息包含 `<info>...</info>` 元信息块 + 用户正文。\n- `<info>` 仅保留 user/request 元信息，例如 `user_id`、`username`、`message_id`、`permissions`、`received_at`。\n- 当前 chat 路由环境（例如 `channel`、`session_id`、`chat_key`、`chat_id`）会通过 system prompt 单独注入，不再混在 `<info>` 里。\n- `<info>` 不要原样回传给用户。\n";
+const TEXT_MODULE_CONTENT = "# Chat Plugin 使用说明\n\n## 用户可见回复规则\n\n- 当前模式下，直接输出，即会发送消息给到用户对应的channel\n\n## 输出协议\n\n- 需要普通回复时，直接输出文本即可。文本顶部可用 frontmatter metadata (optional)，字段语义与 `city chat send` 保持一致：\n\n- `delay` / `delayMs`：延迟发送毫秒数。\n- `time` / `sendAt` / `sendAtMs`：定时发送时间。\n- `reply`：是否使用 reply 语义发送。\n- `messageId`：目标 `message_id`（群聊推荐）。\n- `react`：发送表情反应。\n  - 单个字符串：`react: \"👍\"`\n  - 或对象/数组：`emoji/big`\n  - 设置 `messageId` 时，`react` 会优先复用该消息作为目标消息。\n- 附件使用 `<file type=\"...\">path</file>`（支持 `document/photo/voice/audio/video`）。\n- 附件路径必须是项目内可访问的相对路径。多附件可输出多个 `<file>` 标签。\n\n### 示例\n\n```text\n---\nreply: true\nmessageId: \"128\"\nreact:\n  - emoji: \"✅\"\n---\n这是今天的报告。\n<file type=\"document\">reports/daily.md</file>\n```\n\n### 协议约束\n\n- frontmatter 必须位于文本最开头（`---` 包裹）。\n- 除 `<file>` 附件标签外，不要使用尖括号格式做控制参数。\n\n## 跨协议/跨平台操作\n\n- 当任务需要跨会话、跨平台或复杂路由，必须使用 `city chat send` / `city chat react`。\n- metadata 只适用于当前会话内的 direct 出站，不要拿 metadata 做跨 chat 路由。\n- 如果需要跨 chat 发送，或者不清楚怎么发送，直接先调用 `city chat --help` 查看方法。\n- 如不确定参数或正文协议，先自行调用：\n  - `city chat --help`\n  - `city chat send --help`\n  - `city chat react --help`\n\n## 入站消息结构（仅供内部理解）\n\n- 每条入队用户消息包含 `<info>...</info>` 元信息块 + 用户正文。\n- `<info>` 仅保留 user/request 元信息，例如 `user_id`、`username`、`message_id`、`permissions`、`received_at`。\n- 当前 chat 路由环境（例如 `channel`、`session_id`、`chat_key`、`chat_id`）会通过 system prompt 单独注入，不再混在 `<info>` 里。\n- `<info>` 不要原样回传给用户。\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/plugin/builtins/chat/PROMPT.direct.ts.txt

@@ -1,4 +1,4 @@
-# Chat Service 使用说明
+# Chat Plugin 使用说明
 
 ## 用户可见回复规则
 

package/src/plugin/builtins/chat/accounts/{ChannelAccountService.ts → ChannelAccountManager.ts}

@@ -1,5 +1,5 @@
 /**
- * Chat channel account 管理服务。
+ * Chat channel account 管理器。
  *
  * 关键点（中文）
  * - 统一封装 agent 运行时下 chat channel account 的 CRUD 与探测。
@@ -66,9 +66,9 @@ function pickFirstNonEmpty(inputs: unknown[]): string {
 }
 
 /**
- * ChatChannelAccountService。
+ * ChatChannelAccountManager。
  */
-export class ChatChannelAccountService {
+export class ChatChannelAccountManager {
   private readonly platform: AgentPlatformRuntime;
 
   constructor(platform: AgentPlatformRuntime) {

package/src/plugin/builtins/chat/channels/feishu/types/FeishuChannel.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 集中声明 Feishu 渠道的配置、事件、消息体与上传下载中间结构。
- * - `service/builtins/chat/channels/feishu/*` 统一依赖这里，避免实现文件内联大量局部类型。
+ * - `plugin/builtins/chat/channels/feishu/*` 统一依赖这里，避免实现文件内联大量局部类型。
  */
 
 /**

package/src/plugin/builtins/chat/channels/qq/PROMPT.direct.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/plugin/builtins/chat/channels/qq/PROMPT.direct.ts.txt
-const TEXT_MODULE_CONTENT = "# QQ Adapter 使用说明（direct 模式）\n\n## 能力范围\n- 负责 QQ 官方机器人网关（WebSocket）消息接入与发送。\n- 入站消息会由 chat service 映射到内部 `sessionId`（随机分配并持久化）。\n\n## 使用约束\n- 在 direct 模式下，你输出的 assistant 文本会自动发送到当前 QQ 会话。\n- QQ 出站回复依赖入站消息上下文（如 `chatType` 与 `messageId`）；跨会话发送请使用 `city chat send --chat-key ...`，不要在 direct metadata 中写 `chatKey`。\n- 群聊消息默认全量接入，不需要 `@` 触发。\n- 适配器会过滤机器人自回环消息并做入站去重，避免“自己回复自己”的循环。\n";
+const TEXT_MODULE_CONTENT = "# QQ Adapter 使用说明（direct 模式）\n\n## 能力范围\n- 负责 QQ 官方机器人网关（WebSocket）消息接入与发送。\n- 入站消息会由 chat plugin runtime 映射到内部 `sessionId`（随机分配并持久化）。\n\n## 使用约束\n- 在 direct 模式下，你输出的 assistant 文本会自动发送到当前 QQ 会话。\n- QQ 出站回复依赖入站消息上下文（如 `chatType` 与 `messageId`）；跨会话发送请使用 `city chat send --chat-key ...`，不要在 direct metadata 中写 `chatKey`。\n- 群聊消息默认全量接入，不需要 `@` 触发。\n- 适配器会过滤机器人自回环消息并做入站去重，避免“自己回复自己”的循环。\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/plugin/builtins/chat/channels/qq/PROMPT.direct.ts.txt

@@ -2,7 +2,7 @@
 
 ## 能力范围
 - 负责 QQ 官方机器人网关（WebSocket）消息接入与发送。
-- 入站消息会由 chat service 映射到内部 `sessionId`（随机分配并持久化）。
+- 入站消息会由 chat plugin runtime 映射到内部 `sessionId`（随机分配并持久化）。
 
 ## 使用约束
 - 在 direct 模式下，你输出的 assistant 文本会自动发送到当前 QQ 会话。

package/src/plugin/builtins/chat/channels/qq/types/QqChannel.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 这里集中放 QQ 渠道的网关载荷、消息结构、状态快照等共享契约。
- * - `service/builtins/chat/channels/qq/*` 只消费这些类型，不再在实现文件里内联大段局部类型。
+ * - `plugin/builtins/chat/channels/qq/*` 只消费这些类型，不再在实现文件里内联大段局部类型。
  * - 字段命名尽量保持与 QQ 官方事件/接口原始字段一致，降低映射心智负担。
  */
 

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

@@ -1,5 +1,5 @@
 /**
- * ChatActionExecution：chat service 的业务 action 执行模块。
+ * ChatActionExecution：chat plugin runtime 的业务 action 执行模块。
  *
  * 关键点（中文）
  * - 这里只放与会话/消息相关的执行逻辑。
@@ -263,7 +263,7 @@ export async function executeChatSendAction(params: {
     text: String(params.payload.text || ""),
     delayMs: params.payload.delayMs,
     sendAtMs: params.payload.sendAtMs,
-    // 关键点（中文）：service action 面向 CLI/API，定时或延迟发送应立即返回，
+    // 关键点（中文）：plugin runtime action 面向 CLI/API，定时或延迟发送应立即返回，
     // 由 runtime 在后台内存中继续等待并到点投递，避免 HTTP 请求长时间挂起。
     ...(shouldScheduleInBackground ? { nonBlockingDelay: true } : {}),
     replyToMessage: params.payload.replyToMessage === true,

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

@@ -1,5 +1,5 @@
 /**
- * ChatActionInput：chat service 的 CLI 输入映射模块。
+ * ChatActionInput：chat plugin runtime 的 CLI 输入映射模块。
  *
  * 关键点（中文）
  * - 这里统一处理命令行到 action payload 的转换。

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

@@ -119,12 +119,12 @@ export async function setChatChannelEnabled(params: {
 }): Promise<void> {
   const { context, channel, enabled } = params;
 
-  const configServices = ((context.config.services ??= {}) as {
+  const configPlugins = ((context.config.plugins ??= {}) as {
     chat?: {
       channels?: Record<string, Record<string, unknown>>;
     };
   });
-  const chatConfig = (configServices.chat ??= {});
+  const chatConfig = (configPlugins.chat ??= {});
   const channelConfigs = (chatConfig.channels ??= {});
   const channelConfig = (channelConfigs[channel] ??= {});
   channelConfig.enabled = enabled;
@@ -141,8 +141,8 @@ export async function setChatChannelEnabled(params: {
     shipJson = {};
   }
 
-  const shipServices = ((shipJson.services ??= {}) as Record<string, unknown>);
-  const shipChat = ((shipServices.chat ??= {}) as Record<string, unknown>);
+  const shipPlugins = ((shipJson.plugins ??= {}) as Record<string, unknown>);
+  const shipChat = ((shipPlugins.chat ??= {}) as Record<string, unknown>);
   const shipChannels = ((shipChat.channels ??= {}) as Record<string, unknown>);
   const shipChannel = ((shipChannels[channel] ??= {}) as Record<string, unknown>);
   shipChannel.enabled = enabled;
@@ -277,12 +277,12 @@ export async function setChatChannelConfig(params: {
   const { context, channel, patch } = params;
   if (Object.keys(patch).length === 0) return;
 
-  const configServices = ((context.config.services ??= {}) as {
+  const configPlugins = ((context.config.plugins ??= {}) as {
     chat?: {
       channels?: Record<string, Record<string, unknown>>;
     };
   });
-  const chatConfig = (configServices.chat ??= {});
+  const chatConfig = (configPlugins.chat ??= {});
   const channelConfigs = (chatConfig.channels ??= {});
   const channelConfig = (channelConfigs[channel] ??= {});
   applyChannelPatch(channelConfig, patch);
@@ -299,8 +299,8 @@ export async function setChatChannelConfig(params: {
     shipJson = {};
   }
 
-  const shipServices = ((shipJson.services ??= {}) as Record<string, unknown>);
-  const shipChat = ((shipServices.chat ??= {}) as Record<string, unknown>);
+  const shipPlugins = ((shipJson.plugins ??= {}) as Record<string, unknown>);
+  const shipChat = ((shipPlugins.chat ??= {}) as Record<string, unknown>);
   const shipChannels = ((shipChat.channels ??= {}) as Record<string, unknown>);
   const shipChannel = ((shipChannels[channel] ??= {}) as Record<string, unknown>);
   applyChannelPatch(shipChannel, patch);