@downcity/agent 1.1.32 → 1.1.35

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

@@ -2,7 +2,7 @@
  * contact 远端 HTTP 客户端。
  *
  * 关键点（中文）
- * - contact 的 agent-to-agent 调用统一走 runtime plugin command 接口。
+ * - contact 的 agent-to-agent 调用统一走 plugin runtime command 接口。
  * - 已建联后的敏感调用必须携带 contact token。
  */
 
@@ -42,7 +42,7 @@ async function postPluginCommand<T>(params: {
   token?: string;
   wrapBody?: boolean;
 }): Promise<T> {
-  const url = new URL("/api/plugins/runtime/command", normalizeEndpoint(params.endpoint)).toString();
+  const url = new URL("/api/plugins/command", normalizeEndpoint(params.endpoint)).toString();
   const payloadBody =
     params.wrapBody
       ? {

package/src/plugin/builtins/contact/types/ContactCheck.ts

@@ -19,9 +19,9 @@ export interface ContactPingResponse {
    */
   agentName: string;
   /**
-   * 对方 contact service 是否可用。
+   * 对方 contact plugin 是否可用。
    */
-  service: "contact";
+  plugin: "contact";
   /**
    * token 校验是否通过。
    */

package/src/plugin/builtins/contact/types/ContactCommand.ts

@@ -1,5 +1,5 @@
 /**
- * contact service command 类型。
+ * contact plugin command 类型。
  *
  * 关键点（中文）
  * - 这里只描述 action payload/response，不承载运行时存储逻辑。

package/src/plugin/builtins/memory/MemoryPlugin.ts

@@ -257,7 +257,7 @@ export class MemoryPlugin extends BasePlugin {
   };
 
   /**
-   * 获取或创建当前实例绑定的 memory service state。
+   * 获取或创建当前实例绑定的 memory plugin state。
    */
   private getOrCreateRuntimeState(context: AgentContext): MemoryRuntimeState {
     if (!this.runtimeState) {

package/src/plugin/builtins/memory/runtime/Search.ts

@@ -229,7 +229,7 @@ export async function searchMemory(
       mode: "scan",
       results: [],
       disabled: true,
-      error: "memory service disabled",
+      error: "memory plugin disabled",
       action: "Set context.memory.enabled=true or remove the config override.",
     };
   }

package/src/plugin/builtins/memory/runtime/Store.ts

@@ -155,11 +155,11 @@ export function isMemoryEnabled(context: AgentContext): boolean {
 }
 
 /**
- * 创建一个新的 memory service state。
+ * 创建一个新的 memory plugin state。
  *
  * 关键点（中文）
- * - 每个 MemoryService 实例都持有自己的 state。
- * - 不再按 rootPath 落到模块级 Map，避免 service 实例之间共享状态。
+ * - 每个 `MemoryPlugin` 实例都持有自己的 state。
+ * - 不再按 rootPath 落到模块级 Map，避免 plugin runtime 实例之间共享状态。
  */
 export function createMemoryRuntimeState(
   context: AgentContext,

package/src/plugin/builtins/shell/ShellRuntimeTypes.ts

@@ -2,9 +2,9 @@
  * ShellRuntime 类型定义。
  *
  * 关键点（中文）
- * - 这些类型描述 shell service 的实例级运行态。
- * - 状态所有权归属于 ShellService 实例，而不是模块级单例。
- * - 统一归档到 `src/service/builtins/shell/` 相邻层级，避免继续分散在跨域目录里。
+ * - 这些类型描述 shell plugin runtime 的实例级运行态。
+ * - 状态所有权归属于 `ShellPlugin` 实例，而不是模块级单例。
+ * - 统一归档到 `src/plugin/builtins/shell/` 相邻层级，避免继续分散在跨域目录里。
  */
 
 import type { ChildProcessWithoutNullStreams } from "node:child_process";
@@ -76,7 +76,7 @@ export type ShellSessionRuntimeState = {
 };
 
 /**
- * ShellService 实例级状态。
+ * `ShellPlugin` 实例级状态。
  */
 export type ShellPluginState = {
   /**

package/src/plugin/builtins/shell/runtime/ShellActionRuntime.ts

@@ -2,7 +2,7 @@
  * Shell action 运行时编排入口。
  *
  * 关键点（中文）
- * - 这里只负责编排 shell service 的公开动作：start/status/read/write/wait/close/exec。
+ * - 这里只负责编排 shell plugin runtime 的公开动作：start/status/read/write/wait/close/exec。
  * - 持久化、输出裁剪、waiter 协调、session 查找等共享细节拆到 `ShellActionRuntimeSupport.ts`。
  * - 新版本所有状态都通过 ShellPluginState 显式传入，不再使用模块级单例。
  */
@@ -52,7 +52,7 @@ import { attachShellProcessEventHandlers } from "./ShellProcessEvents.js";
 export { createShellPluginState } from "./ShellActionRuntimeSupport.js";
 
 /**
- * 绑定当前 shell service 实例的 execution runtime。
+ * 绑定当前 shell plugin runtime 实例的 execution runtime。
  */
 export function bindShellRuntime(
   state: ShellPluginState,

package/src/plugin/builtins/shell/runtime/ShellActionRuntimeSupport.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 统一承载 ShellActionRuntime 的内部共享逻辑：环境组装、持久化、waiter 协调、session 查找。
- * - 对外暴露给 ShellActionRuntime 的只有纯运行时辅助函数，不直接承担 service action 编排。
+ * - 对外暴露给 ShellActionRuntime 的只有纯运行时辅助函数，不直接承担 plugin action 编排。
  */
 
 import path from "node:path";
@@ -53,7 +53,7 @@ export const DEFAULT_WAIT_TIMEOUT_MS = 10_000;
 export const DEFAULT_EXEC_TIMEOUT_MS = 60_000;
 
 /**
- * 创建 shell service 初始状态。
+ * 创建 shell plugin runtime 初始状态。
  */
 export function createShellPluginState(): ShellPluginState {
   return {

package/src/plugin/builtins/shell/runtime/ShellProcessEvents.ts

@@ -33,7 +33,7 @@ async function finalizeExitAfterOutputDrain(
  */
 export function attachShellProcessEventHandlers(params: {
   /**
-   * 当前 shell service 状态。
+   * 当前 shell plugin runtime 状态。
    */
   state: ShellPluginState;
   /**

package/src/plugin/builtins/shell/runtime/ShellRuntimeEnvironment.ts

@@ -9,7 +9,7 @@
 import path from "node:path";
 import type { AgentContext } from "@/core/AgentContextTypes.js";
 import { stripInvocationAuthEnv } from "@/runtime/server/http/auth/AuthEnv.js";
-import { getSessionRunScope } from "@session/SessionRunScope.js";
+import { getSessionRunScope } from "@executor/SessionRunScope.js";
 
 /**
  * 构造 shell 子进程环境变量。

package/src/plugin/builtins/shell/types/ShellPlugin.ts

@@ -1,9 +1,9 @@
 /**
- * Shell service 类型定义。
+ * Shell plugin runtime 类型定义。
  *
  * 关键点（中文）
  * - `shell_id` 是 shell 会话的唯一标识，与 chat `sessionId` 严格区分。
- * - 这些类型同时服务于 service 层状态管理与 agent tool 协议。
+ * - 这些类型同时服务于 shell runtime 状态管理与 agent tool 协议。
  */
 
 export type ShellSessionStatus =
@@ -34,7 +34,7 @@ export type ShellExternalRef = {
  * shell 会话快照。
  *
  * 说明（中文）
- * - 该对象是 shell service 对外暴露的统一状态视图。
+ * - 该对象是 shell plugin runtime 对外暴露的统一状态视图。
  * - 内部运行态（child process / waiter 集合）不会暴露给上层。
  */
 export type ShellSessionSnapshot = {
@@ -221,7 +221,7 @@ export type ShellOutputChunk = {
 };
 
 /**
- * shell service 对 agent tool 返回的统一数据结构。
+ * shell plugin runtime 对 agent tool 返回的统一数据结构。
  */
 export type ShellActionResponse = {
   /** shell 当前快照。 */

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

@@ -4,9 +4,11 @@
  * 关键点（中文）
  * - skill 不再作为 service 存在，而是作为显式 action + system 提供者接入 plugin 体系。
  * - `find/install/list/lookup` 全部通过 plugin actions 暴露。
- * - skills overview 文本通过 `plugin.system` 注入，不再依赖 service.system。
+ * - skills overview 文本通过 `plugin.system` 注入，不再依赖 plugin.system。
  */
 
+import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
+import { BasePlugin } from "@/plugin/core/BasePlugin.js";
 import type { Plugin } from "@/plugin/types/Plugin.js";
 import type { JsonObject, JsonValue } from "@/types/common/Json.js";
 import { isPluginEnabled } from "@/plugin/core/Activation.js";
@@ -90,11 +92,9 @@ function inferSkillQueryFromSpec(spec: string): string {
   return "";
 }
 
-/**
- * skillPlugin：技能发现、安装、读取与 system 注入。
- */
-export const skillPlugin: Plugin = {
-  name: "skill",
+function createSkillPluginDefinition(plugin: Plugin): Plugin {
+  return {
+    name: "skill",
   title: "Skill Catalog And Loader",
   description:
     "Finds, installs, lists, and reads local skills, and injects the current skill overview into system prompts so the agent knows what capabilities are available.",
@@ -106,7 +106,7 @@ export const skillPlugin: Plugin = {
     },
   },
   availability(context) {
-    if (!isPluginEnabled({ plugin: skillPlugin, context })) {
+    if (!isPluginEnabled({ plugin, context })) {
       return {
         enabled: false,
         available: false,
@@ -331,4 +331,17 @@ export const skillPlugin: Plugin = {
       },
     },
   },
-};
+  };
+}
+
+/**
+ * SkillPlugin：技能发现、安装、读取与 system 注入。
+ */
+export class SkillPlugin extends BasePlugin {
+  readonly name = "skill";
+
+  constructor(agent: AgentRuntime | null = null) {
+    super(agent);
+    Object.assign(this, createSkillPluginDefinition(this));
+  }
+}

package/src/plugin/builtins/skill/runtime/SystemProvider.ts

@@ -7,7 +7,7 @@
  * - `lookup` 行为为无状态：由 action 读取 SKILL.md 后通过协议注入 user message
  */
 
-import { getSessionRunScope } from "@session/SessionRunScope.js";
+import { getSessionRunScope } from "@executor/SessionRunScope.js";
 import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
 import { discoverClaudeSkillsSync } from "./Discovery.js";
 import { renderClaudeSkillsPromptSection } from "./Prompt.js";

package/src/plugin/builtins/task/PROMPT.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/plugin/builtins/task/PROMPT.ts.txt
-const TEXT_MODULE_CONTENT = "# Task Service\n\n你可以通过 `task` service 管理任务定义、执行、调度与状态控制。\n\n## 任务模型\n\n每个任务定义在 `./.downcity/task/<title>/task.md`，包含：\n- frontmatter（结构化字段）\n- body（任务正文）\n\nfrontmatter 核心字段：\n- `title`：任务唯一标识（唯一）\n- `description`：任务描述\n- `when`：触发条件，支持：`@manual` / cron / `time:<ISO8601-with-timezone>`\n- `sessionId`：任务执行会话\n- `status`：`enabled|paused|disabled`\n- `kind`：`agent|script`（默认 `agent`）\n\n执行时会产生 run 目录：\n- `./.downcity/task/<title>/<timestamp>/`\n\n常见产物：\n- `input.md`\n- `output.md`（本次任务的最终输出正文）\n- `result.md`（执行摘要）\n- `run.json`\n- `run-progress.json`\n- `dialogue.md` / `dialogue.json`（agent 多轮）\n- `error.md`（失败时）\n\n## 执行类型（kind）\n\n1. `kind=agent`\n- 将正文交给 agent 执行\n- 默认单轮完成；仅当 frontmatter 显式设置 `review: true` 时启用模拟用户多轮复核\n- 适合研究、分析、报告生成\n\n2. `kind=script`\n- 将正文当作 shell 脚本执行\n- 正文不能为空，必须是可执行脚本\n\n## 可用 action\n\n- `list`\n- `create`\n- `run`\n- `delete`\n- `update`\n- `status`\n- `enable`\n- `disable`\n\n## CLI 示例\n\n- `city task list [--status enabled|paused|disabled]`\n- `city task create --title '...' --description '...' --session-id <sessionId> [--when '@manual'] [--kind agent|script] [--status ...|--activate]`\n- `city task run <title> [--reason '...']`\n- `city task update <title> [--title ...] [--description ...] [--when ...] [--status ...|--activate] [--session-id ...]`\n- `city task delete <title>`\n\n## 关键约束\n\n- `title` 唯一；create 去重仅按 `title` 精确匹配。\n- `when=time:...` 触发后会自动置为 `paused`，并回退为 `when=@manual`。\n- `run` 为异步受理：立即返回 `accepted=true`、`message`、`executionId`；调用方应把它视为“任务已进入后台执行，结果会自动通过 chat service 发送，当前流程无需阻塞等待”。\n- 如果 `run` 返回 `accepted=true`：\n  - 不要手动把 task 产出再转发给用户。\n  - 不要主动读取 run 目录、`run-progress.json`、`output.md` 做轮询。\n  - 只有当用户明确要求排查、查看产物或确认执行细节时，才进入 run 目录检查。\n- agent 任务默认只要求产生有效输出；仅当任务正文明确要求外发时，才应发送到外部 channel。\n\n## 如何设计 task 正文\n\n### agent task 推荐结构\n\n建议正文至少包含这些标题：\n\n```md\n# 任务目标\n\n- 这次任务要交付什么最终结果\n\n# 背景与输入\n\n- 数据来源、范围、约束、参考材料\n\n# 执行步骤\n\n1. 先做什么\n2. 再做什么\n3. 关键中间产物落在哪里\n\n# 输出要求\n\n- 最终结果用什么格式返回\n- 是否需要表格 / JSON / Markdown\n- 不要包含什么内容\n\n# 触发与状态建议\n\n- 这个任务为什么适合 `@manual` / cron / `time:...`\n- 当前应该是 `paused` 还是 `enabled`\n\n# 注意事项\n\n- 风险、边界、不要做什么\n```\n\n### agent task 正文编写约束\n\n- task 正文必须像一份“交付合同”，让另一个执行器拿到后可以直接执行，不依赖当前聊天语境补全含义。\n- `# 任务目标` 必须写清楚最终要交付什么，不要只写“看一下”“研究一下”“处理一下”这类模糊目标。\n- `# 背景与输入` 必须写清来源、范围、对象、时间、限制条件；不要假设执行器还能看到原始聊天上下文。\n- `# 执行步骤` 应描述任务流程，不应描述 task 管理动作；不要写“先检查有没有同名任务”“再创建任务”“然后触发任务”。\n- `# 输出要求` 必须清楚声明最终成品的格式、结构、语气、长度，以及“不要输出什么”。\n- 要明确写出：**最后一条 assistant 返回会被直接写入 `output.md` 并发送给用户**；因此最终回答必须直接等于成品内容。\n- 内容生成类任务（如日报、提醒、晨读、摘要、报告）必须明确要求“最终输出直接是成品正文”，不要让执行器输出过程说明。\n- 如果任务要把结果发给用户，正文应要求“输出可直接发送的正文内容”，而不是要求执行器解释自己已经发送了什么。\n- 除非确有需要，不要在正文中要求执行器复述 task title、sessionId、执行时间、状态等元信息。\n- 正文中的约束要可执行、可判断，尽量避免“适当”“尽量”“看情况”这类弱约束词。\n- 不要把创建 task、更新 task、查看 task 状态、确认 task 是否存在等管理动作写进正文；这些属于 task service 的职责，不属于 task 正文交付物。\n\n### agent task 正文禁止写法\n\n- 不要把正文写成聊天回复口吻，例如：\n  - “我来为你……”\n  - “首先让我……”\n  - “我先检查一下……”\n  - “我看到已经有一个同名任务……”\n- 不要把正文写成任务管理说明，例如：\n  - “如果任务已存在则更新，否则创建”\n  - “先 list 再 run”\n  - “完成后告诉用户任务已启动”\n- 不要把正文写成状态汇报模板，例如：\n  - “任务状态总结”\n  - “已发送 / 已完成 / 已更新”\n  - “当前任务配置如下”\n- 不要只描述动作，不描述成品，例如：\n  - “去搜集一些资料”\n  - “生成一个内容看看”\n  - “做完后反馈结果”\n- 不要把正文写成依赖当前上下文的指代，例如：\n  - “按上面说的做”\n  - “继续刚才那个”\n  - “把这个发出去”\n\n### 如何判断正文写得对不对\n\n- 如果把 task 正文单独复制出来给另一个 agent，它仍然能理解任务目标、输入、步骤和交付物，说明正文合格。\n- 如果最终输出章节删掉后，正文只剩“去做一下”式描述，说明正文不合格。\n- 如果正文更像“创建/更新任务的操作说明”，而不是“任务执行说明”，说明分层错了，必须重写。\n- 如果正文天然会诱导执行器输出过程汇报，而不是最终成品，说明 `# 输出要求` 写得不够强，必须补充禁止项。\n\n### script task 推荐结构\n\n- 正文必须是纯 shell 脚本，不要混入解释性自然语言。\n- 开头尽量写注释说明脚本目的、输入依赖、失败条件。\n- 输出保持稳定，便于直接作为最终结果发送给用户。\n- 如需生成文件，写到 run 目录或明确的项目路径。\n\n### 输出设计原则\n\n- task 完成后，系统会自动把**最终结果正文**通过 chat service `send` 发回 `sessionId` 绑定的 chat。\n- 当前实现采用最简规则：**最后一条 assistant 返回**会被直接视为最终结果正文，并写入 `output.md`。\n- 因此正文里的“输出要求”要面向最终用户阅读，不要只写给开发者看。\n- 对于面向用户的 agent task，正文应要求“最后一条 assistant 返回直接输出最终交付物本身”，不要让执行器在最后回答里输出自己如何创建、检查、更新、触发或发送任务。\n- 如果任务是内容生成类（例如日报、提醒、晨读、摘要），最后输出应直接是那段内容本身，不要附带“我来为你处理”“任务已发送”“任务状态总结”等过程汇报。\n- 默认不要在正文里再次要求执行器调用 `city chat send`。\n- 只有在“跨会话发送”“额外抄送”“多渠道通知”这类场景下，才显式要求 `city chat send`。\n\n### `when` / `status` 怎么选\n\n- task 创建默认就是 `status=enabled`；如果还在试任务、容易失败、需要人工确认，再显式切到 `paused`。\n- 已经验证稳定、需要自动运行：直接使用 cron + `status=enabled`。\n- 明确只执行一次：使用 `time:<带时区 ISO 时间>`；执行后系统会自动回退到 `@manual` + `paused`。\n- 如果用户只是“先存起来以后再跑”，不要直接启用调度。\n\n## 正文模板\n\n### agent 模板\n\n```md\n# 任务目标\n\n- 产出一份可直接发给用户的最终结果。\n\n# 背景与输入\n\n- 在这里补充上下文、文件、链接、范围和假设。\n\n# 执行步骤\n\n1. 理解任务目标与完成标准。\n2. 收集必要信息并执行任务。\n3. 把关键中间产物写入 run 目录。\n4. 输出最终结果正文。\n\n# 输出要求\n\n- 最后一条 assistant 返回直接作为最终结果，不要附带冗长日志。\n- 最后一条 assistant 返回直接输出交付物本身，不要输出任务管理过程、发送过程或状态汇报。\n- 不要使用“我来为你…… / 首先让我…… / 已发送……”这类元话术。\n- 默认不要再次调用 `city chat send`。\n\n# 触发与状态建议\n\n- 默认创建后立即启用；如果只是先保存草稿或等待人工确认，再改成 `paused`。\n\n# 注意事项\n\n- 仅在明确需要跨会话或额外通知时，才调用 `city chat send`。\n```\n\n### script 模板\n\n```bash\n# 任务目标：一句话说明脚本要做什么\n# 输入依赖：列出环境变量、文件、命令依赖\n# 失败条件：列出应该 exit 1 的情况\n\nset -euo pipefail\n\n# 1. 准备输入\n\n# 2. 执行主逻辑\n\n# 3. 输出最终结果（这段输出会被直接发送给用户）\n```\n\n## 建议\n\n- 先 `list`，再 `create`/`update`。\n- 简单内容生成任务优先保持默认单轮；只有确实需要“先生成、再复核、再修订”时再设置 `review: true`。\n- script 任务正文保持纯脚本，不要混入冗余自然语言。\n- 如果用户只是先存起来以后再跑，创建后显式设成 `paused`；否则保持默认启用。\n- task 正文要写“最终结果长什么样”，不要只写“去做一下看看”。\n- 对内容生成任务，要明确写“最后一条 assistant 返回只能是成品正文”，避免执行器把过程说明误当成最终结果。\n";
+const TEXT_MODULE_CONTENT = "# Task Plugin\n\n你可以通过 `task` plugin 管理任务定义、执行、调度与状态控制。\n\n## 任务模型\n\n每个任务定义在 `./.downcity/task/<title>/task.md`，包含：\n- frontmatter（结构化字段）\n- body（任务正文）\n\nfrontmatter 核心字段：\n- `title`：任务唯一标识（唯一）\n- `description`：任务描述\n- `when`：触发条件，支持：`@manual` / cron / `time:<ISO8601-with-timezone>`\n- `sessionId`：任务执行会话\n- `status`：`enabled|paused|disabled`\n- `kind`：`agent|script`（默认 `agent`）\n\n执行时会产生 run 目录：\n- `./.downcity/task/<title>/<timestamp>/`\n\n常见产物：\n- `input.md`\n- `output.md`（本次任务的最终输出正文）\n- `result.md`（执行摘要）\n- `run.json`\n- `run-progress.json`\n- `dialogue.md` / `dialogue.json`（agent 多轮）\n- `error.md`（失败时）\n\n## 执行类型（kind）\n\n1. `kind=agent`\n- 将正文交给 agent 执行\n- 默认单轮完成；仅当 frontmatter 显式设置 `review: true` 时启用模拟用户多轮复核\n- 适合研究、分析、报告生成\n\n2. `kind=script`\n- 将正文当作 shell 脚本执行\n- 正文不能为空，必须是可执行脚本\n\n## 可用 action\n\n- `list`\n- `create`\n- `run`\n- `delete`\n- `update`\n- `status`\n- `enable`\n- `disable`\n\n## CLI 示例\n\n- `city task list [--status enabled|paused|disabled]`\n- `city task create --title '...' --description '...' --session-id <sessionId> [--when '@manual'] [--kind agent|script] [--status ...|--activate]`\n- `city task run <title> [--reason '...']`\n- `city task update <title> [--title ...] [--description ...] [--when ...] [--status ...|--activate] [--session-id ...]`\n- `city task delete <title>`\n\n## 关键约束\n\n- `title` 唯一；create 去重仅按 `title` 精确匹配。\n- `when=time:...` 触发后会自动置为 `paused`，并回退为 `when=@manual`。\n- `run` 为异步受理：立即返回 `accepted=true`、`message`、`executionId`；调用方应把它视为“任务已进入后台执行，结果会自动通过 chat plugin runtime 发送，当前流程无需阻塞等待”。\n- 如果 `run` 返回 `accepted=true`：\n  - 不要手动把 task 产出再转发给用户。\n  - 不要主动读取 run 目录、`run-progress.json`、`output.md` 做轮询。\n  - 只有当用户明确要求排查、查看产物或确认执行细节时，才进入 run 目录检查。\n- agent 任务默认只要求产生有效输出；仅当任务正文明确要求外发时，才应发送到外部 channel。\n\n## 如何设计 task 正文\n\n### agent task 推荐结构\n\n建议正文至少包含这些标题：\n\n```md\n# 任务目标\n\n- 这次任务要交付什么最终结果\n\n# 背景与输入\n\n- 数据来源、范围、约束、参考材料\n\n# 执行步骤\n\n1. 先做什么\n2. 再做什么\n3. 关键中间产物落在哪里\n\n# 输出要求\n\n- 最终结果用什么格式返回\n- 是否需要表格 / JSON / Markdown\n- 不要包含什么内容\n\n# 触发与状态建议\n\n- 这个任务为什么适合 `@manual` / cron / `time:...`\n- 当前应该是 `paused` 还是 `enabled`\n\n# 注意事项\n\n- 风险、边界、不要做什么\n```\n\n### agent task 正文编写约束\n\n- task 正文必须像一份“交付合同”，让另一个执行器拿到后可以直接执行，不依赖当前聊天语境补全含义。\n- `# 任务目标` 必须写清楚最终要交付什么，不要只写“看一下”“研究一下”“处理一下”这类模糊目标。\n- `# 背景与输入` 必须写清来源、范围、对象、时间、限制条件；不要假设执行器还能看到原始聊天上下文。\n- `# 执行步骤` 应描述任务流程，不应描述 task 管理动作；不要写“先检查有没有同名任务”“再创建任务”“然后触发任务”。\n- `# 输出要求` 必须清楚声明最终成品的格式、结构、语气、长度，以及“不要输出什么”。\n- 要明确写出：**最后一条 assistant 返回会被直接写入 `output.md` 并发送给用户**；因此最终回答必须直接等于成品内容。\n- 内容生成类任务（如日报、提醒、晨读、摘要、报告）必须明确要求“最终输出直接是成品正文”，不要让执行器输出过程说明。\n- 如果任务要把结果发给用户，正文应要求“输出可直接发送的正文内容”，而不是要求执行器解释自己已经发送了什么。\n- 除非确有需要，不要在正文中要求执行器复述 task title、sessionId、执行时间、状态等元信息。\n- 正文中的约束要可执行、可判断，尽量避免“适当”“尽量”“看情况”这类弱约束词。\n- 不要把创建 task、更新 task、查看 task 状态、确认 task 是否存在等管理动作写进正文；这些属于 task plugin 的职责，不属于 task 正文交付物。\n\n### agent task 正文禁止写法\n\n- 不要把正文写成聊天回复口吻，例如：\n  - “我来为你……”\n  - “首先让我……”\n  - “我先检查一下……”\n  - “我看到已经有一个同名任务……”\n- 不要把正文写成任务管理说明，例如：\n  - “如果任务已存在则更新，否则创建”\n  - “先 list 再 run”\n  - “完成后告诉用户任务已启动”\n- 不要把正文写成状态汇报模板，例如：\n  - “任务状态总结”\n  - “已发送 / 已完成 / 已更新”\n  - “当前任务配置如下”\n- 不要只描述动作，不描述成品，例如：\n  - “去搜集一些资料”\n  - “生成一个内容看看”\n  - “做完后反馈结果”\n- 不要把正文写成依赖当前上下文的指代，例如：\n  - “按上面说的做”\n  - “继续刚才那个”\n  - “把这个发出去”\n\n### 如何判断正文写得对不对\n\n- 如果把 task 正文单独复制出来给另一个 agent，它仍然能理解任务目标、输入、步骤和交付物，说明正文合格。\n- 如果最终输出章节删掉后，正文只剩“去做一下”式描述，说明正文不合格。\n- 如果正文更像“创建/更新任务的操作说明”，而不是“任务执行说明”，说明分层错了，必须重写。\n- 如果正文天然会诱导执行器输出过程汇报，而不是最终成品，说明 `# 输出要求` 写得不够强，必须补充禁止项。\n\n### script task 推荐结构\n\n- 正文必须是纯 shell 脚本，不要混入解释性自然语言。\n- 开头尽量写注释说明脚本目的、输入依赖、失败条件。\n- 输出保持稳定，便于直接作为最终结果发送给用户。\n- 如需生成文件，写到 run 目录或明确的项目路径。\n\n### 输出设计原则\n\n- task 完成后，系统会自动把**最终结果正文**通过 chat plugin runtime 的 `send` 发回 `sessionId` 绑定的 chat。\n- 当前实现采用最简规则：**最后一条 assistant 返回**会被直接视为最终结果正文，并写入 `output.md`。\n- 因此正文里的“输出要求”要面向最终用户阅读，不要只写给开发者看。\n- 对于面向用户的 agent task，正文应要求“最后一条 assistant 返回直接输出最终交付物本身”，不要让执行器在最后回答里输出自己如何创建、检查、更新、触发或发送任务。\n- 如果任务是内容生成类（例如日报、提醒、晨读、摘要），最后输出应直接是那段内容本身，不要附带“我来为你处理”“任务已发送”“任务状态总结”等过程汇报。\n- 默认不要在正文里再次要求执行器调用 `city chat send`。\n- 只有在“跨会话发送”“额外抄送”“多渠道通知”这类场景下，才显式要求 `city chat send`。\n\n### `when` / `status` 怎么选\n\n- task 创建默认就是 `status=enabled`；如果还在试任务、容易失败、需要人工确认，再显式切到 `paused`。\n- 已经验证稳定、需要自动运行：直接使用 cron + `status=enabled`。\n- 明确只执行一次：使用 `time:<带时区 ISO 时间>`；执行后系统会自动回退到 `@manual` + `paused`。\n- 如果用户只是“先存起来以后再跑”，不要直接启用调度。\n\n## 正文模板\n\n### agent 模板\n\n```md\n# 任务目标\n\n- 产出一份可直接发给用户的最终结果。\n\n# 背景与输入\n\n- 在这里补充上下文、文件、链接、范围和假设。\n\n# 执行步骤\n\n1. 理解任务目标与完成标准。\n2. 收集必要信息并执行任务。\n3. 把关键中间产物写入 run 目录。\n4. 输出最终结果正文。\n\n# 输出要求\n\n- 最后一条 assistant 返回直接作为最终结果，不要附带冗长日志。\n- 最后一条 assistant 返回直接输出交付物本身，不要输出任务管理过程、发送过程或状态汇报。\n- 不要使用“我来为你…… / 首先让我…… / 已发送……”这类元话术。\n- 默认不要再次调用 `city chat send`。\n\n# 触发与状态建议\n\n- 默认创建后立即启用；如果只是先保存草稿或等待人工确认，再改成 `paused`。\n\n# 注意事项\n\n- 仅在明确需要跨会话或额外通知时，才调用 `city chat send`。\n```\n\n### script 模板\n\n```bash\n# 任务目标：一句话说明脚本要做什么\n# 输入依赖：列出环境变量、文件、命令依赖\n# 失败条件：列出应该 exit 1 的情况\n\nset -euo pipefail\n\n# 1. 准备输入\n\n# 2. 执行主逻辑\n\n# 3. 输出最终结果（这段输出会被直接发送给用户）\n```\n\n## 建议\n\n- 先 `list`，再 `create`/`update`。\n- 简单内容生成任务优先保持默认单轮；只有确实需要“先生成、再复核、再修订”时再设置 `review: true`。\n- script 任务正文保持纯脚本，不要混入冗余自然语言。\n- 如果用户只是先存起来以后再跑，创建后显式设成 `paused`；否则保持默认启用。\n- task 正文要写“最终结果长什么样”，不要只写“去做一下看看”。\n- 对内容生成任务，要明确写“最后一条 assistant 返回只能是成品正文”，避免执行器把过程说明误当成最终结果。\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/plugin/builtins/task/PROMPT.ts.txt

@@ -1,6 +1,6 @@
-# Task Service
+# Task Plugin
 
-你可以通过 `task` service 管理任务定义、执行、调度与状态控制。
+你可以通过 `task` plugin 管理任务定义、执行、调度与状态控制。
 
 ## 任务模型
 
@@ -62,7 +62,7 @@ frontmatter 核心字段：
 
 - `title` 唯一；create 去重仅按 `title` 精确匹配。
 - `when=time:...` 触发后会自动置为 `paused`，并回退为 `when=@manual`。
-- `run` 为异步受理：立即返回 `accepted=true`、`message`、`executionId`；调用方应把它视为“任务已进入后台执行，结果会自动通过 chat service 发送，当前流程无需阻塞等待”。
+- `run` 为异步受理：立即返回 `accepted=true`、`message`、`executionId`；调用方应把它视为“任务已进入后台执行，结果会自动通过 chat plugin runtime 发送，当前流程无需阻塞等待”。
 - 如果 `run` 返回 `accepted=true`：
   - 不要手动把 task 产出再转发给用户。
   - 不要主动读取 run 目录、`run-progress.json`、`output.md` 做轮询。
@@ -118,7 +118,7 @@ frontmatter 核心字段：
 - 如果任务要把结果发给用户，正文应要求“输出可直接发送的正文内容”，而不是要求执行器解释自己已经发送了什么。
 - 除非确有需要，不要在正文中要求执行器复述 task title、sessionId、执行时间、状态等元信息。
 - 正文中的约束要可执行、可判断，尽量避免“适当”“尽量”“看情况”这类弱约束词。
-- 不要把创建 task、更新 task、查看 task 状态、确认 task 是否存在等管理动作写进正文；这些属于 task service 的职责，不属于 task 正文交付物。
+- 不要把创建 task、更新 task、查看 task 状态、确认 task 是否存在等管理动作写进正文；这些属于 task plugin 的职责，不属于 task 正文交付物。
 
 ### agent task 正文禁止写法
 
@@ -160,7 +160,7 @@ frontmatter 核心字段：
 
 ### 输出设计原则
 
-- task 完成后，系统会自动把**最终结果正文**通过 chat service `send` 发回 `sessionId` 绑定的 chat。
+- task 完成后，系统会自动把**最终结果正文**通过 chat plugin runtime 的 `send` 发回 `sessionId` 绑定的 chat。
 - 当前实现采用最简规则：**最后一条 assistant 返回**会被直接视为最终结果正文，并写入 `output.md`。
 - 因此正文里的“输出要求”要面向最终用户阅读，不要只写给开发者看。
 - 对于面向用户的 agent task，正文应要求“最后一条 assistant 返回直接输出最终交付物本身”，不要让执行器在最后回答里输出自己如何创建、检查、更新、触发或发送任务。

package/src/plugin/builtins/task/Scheduler.ts

@@ -2,8 +2,8 @@
  * Task 调度注册（集成层）。
  *
  * 关键点（中文）
- * - task 语义（status/when/串行保护）放在 service。
- * - cron 调度执行器由 server 注入，service 不依赖具体实现。
+ * - task 语义（status/when/串行保护）放在 task plugin runtime。
+ * - cron 调度执行器由宿主注入，task runtime 不依赖具体实现。
  */
 
 import type { AgentContext } from "@/core/AgentContextTypes.js";
@@ -14,7 +14,7 @@ import {
 } from "./runtime/Model.js";
 import { listTasks, readTask, writeTask } from "./runtime/Store.js";
 import { runTaskNow } from "./runtime/Runner.js";
-import { ServiceCronEngine } from "./types/Cron.js";
+import { TaskCronEngine } from "./types/Cron.js";
 import { resolveRuntimeTimezone } from "@/utils/Time.js";
 
 const TASK_LOG_PREFIX = "[TASK]";
@@ -25,7 +25,7 @@ function formatTaskLogMessage(message: string): string {
 
 export async function registerTaskCronJobs(params: {
   context: AgentContext;
-  engine: ServiceCronEngine;
+  engine: TaskCronEngine;
 }): Promise<{ tasksFound: number; jobsScheduled: number }> {
   const context = params.context;
   const logger = context.logger;

package/src/plugin/builtins/task/runtime/CronTrigger.ts

@@ -2,26 +2,26 @@
  * Task cron 触发引擎。
  *
  * 关键点（中文）
- * - 该模块仅服务于 task service，不放在 core。
+ * - 该模块仅服务于 task plugin runtime，不放在 core。
  * - 只提供 cron 注册与调度，不承载 task 业务语义。
  */
 
 import cron from "node-cron";
 import type { ScheduledTask } from "node-cron";
 import {
-  ServiceCronEngine,
-  ServiceCronTriggerDefinition,
+  TaskCronEngine,
+  TaskCronTriggerDefinition,
 } from "../types/Cron.js";
 
-export class TaskCronTriggerEngine implements ServiceCronEngine {
-  private readonly definitions: Map<string, ServiceCronTriggerDefinition> =
+export class TaskCronTriggerEngine implements TaskCronEngine {
+  private readonly definitions: Map<string, TaskCronTriggerDefinition> =
     new Map();
   private readonly scheduledJobs: Map<string, ScheduledTask> = new Map();
   private started = false;
 
-  register(definition: ServiceCronTriggerDefinition): void {
+  register(definition: TaskCronTriggerDefinition): void {
     const id = String(definition.id || "").trim();
-    if (!id) throw new Error("ServiceCronTriggerDefinition.id is required");
+    if (!id) throw new Error("TaskCronTriggerDefinition.id is required");
 
     const expression = String(definition.expression || "").trim();
     if (!expression)
@@ -30,7 +30,7 @@ export class TaskCronTriggerEngine implements ServiceCronEngine {
       throw new Error(`Invalid cron expression for job ${id}: ${expression}`);
     }
 
-    const normalized: ServiceCronTriggerDefinition = {
+    const normalized: TaskCronTriggerDefinition = {
       ...definition,
       id,
       expression,
@@ -82,7 +82,7 @@ export class TaskCronTriggerEngine implements ServiceCronEngine {
     this.scheduledJobs.clear();
   }
 
-  private scheduleOne(definition: ServiceCronTriggerDefinition): void {
+  private scheduleOne(definition: TaskCronTriggerDefinition): void {
     const previous = this.scheduledJobs.get(definition.id);
     if (previous) {
       try {

package/src/plugin/builtins/task/runtime/TaskActionExecution.ts

@@ -1,5 +1,5 @@
 /**
- * TaskActionExecution：task service 的业务执行模块。
+ * TaskActionExecution：task plugin runtime 的业务执行模块。
  *
  * 关键点（中文）
  * - 这里只放 task 的领域执行逻辑，不放 CLI/API 声明。

package/src/plugin/builtins/task/runtime/TaskActionInput.ts

@@ -1,12 +1,12 @@
 /**
- * TaskActionInput：task service 的 CLI 输入映射模块。
+ * TaskActionInput：task plugin runtime 的 CLI 输入映射模块。
  *
  * 关键点（中文）
  * - 统一处理命令行到 task action payload 的转换。
  * - 参数校验尽量前置到输入层，避免进入执行层后才发现字段非法。
  */
 
-import { resolveSessionId } from "@session/ids/resolveSessionId.js";
+import { resolveSessionId } from "@executor/ids/resolveSessionId.js";
 import type { JsonValue } from "@/types/common/Json.js";
 import type { PluginActionCommandInput } from "@/plugin/types/Plugin.js";
 import type { ShipTaskKind, ShipTaskStatus } from "@/plugin/builtins/task/types/Task.js";

package/src/plugin/builtins/task/runtime/TaskPluginActionRegistry.ts

@@ -1,9 +1,9 @@
 /**
- * TaskPluginActions：task service 的 action 注册表模块。
+ * TaskPluginActions：task plugin runtime 的 action 注册表模块。
  *
  * 关键点（中文）
  * - 这里专门负责把 task 的 CLI/execute 定义装配成 `PluginActions`。
- * - TaskService 本体只保留实例状态与 lifecycle，不再承载大段 action 声明。
+ * - task plugin runtime 本体只保留实例状态与 lifecycle，不再承载大段 action 声明。
  */
 
 import type { Command } from "commander";
@@ -37,7 +37,7 @@ import {
 } from "./TaskActionInput.js";
 
 /**
- * 创建 task service 的 action 定义表。
+ * 创建 task plugin runtime 的 action 定义表。
  */
 export function createTaskPluginActions(params: {
   reloadSchedulerAfterMutation: TaskSchedulerReloadPort;

package/src/plugin/builtins/task/runtime/TaskPromptAssets.ts

@@ -6,9 +6,9 @@
  * - 这里统一做 `trim()`，保持 plugin system 文本行为稳定。
  */
 
-import taskServicePromptText from "@/plugin/builtins/task/PROMPT.js";
+import taskPluginPromptText from "@/plugin/builtins/task/PROMPT.js";
 
 /**
  * task plugin 固定 system prompt 文本。
  */
-export const TASK_PLUGIN_PROMPT = taskServicePromptText.trim();
+export const TASK_PLUGIN_PROMPT = taskPluginPromptText.trim();

package/src/plugin/builtins/task/runtime/TaskRunChatDispatch.ts

@@ -2,7 +2,7 @@
  * TaskRunChatDispatch：task 执行完成后的 chat 回发模块。
  *
  * 关键点（中文）
- * - task 完成后统一通过 chat service `send` action 回发结果。
+ * - task 完成后统一通过 chat plugin runtime 的 `send` action 回发结果。
  * - 默认只发送最终结果正文，不额外包裹标题/状态摘要。
  * - 回发失败只记录日志，不影响 task run 自身状态。
  */
@@ -32,7 +32,7 @@ function resolveTaskFinalText(params: {
 }
 
 /**
- * 通过 chat service 发送 task 最终结果。
+ * 通过 chat plugin runtime 发送 task 最终结果。
  */
 export async function dispatchTaskRunCompletionToChat(params: {
   context: AgentContext;

package/src/plugin/builtins/task/runtime/TaskRunnerRound.ts

@@ -11,7 +11,7 @@ import fs from "fs-extra";
 import { stripInvocationAuthEnv } from "@/runtime/server/http/auth/AuthEnv.js";
 import type { AgentContext } from "@/core/AgentContextTypes.js";
 import { runSandboxCommand } from "@/runtime/sandbox/SandboxRunner.js";
-import type { SessionRunResult } from "@/session/types/SessionRun.js";
+import type { SessionRunResult } from "@/executor/types/SessionRun.js";
 import type { JsonObject } from "@/types/common/Json.js";
 import type {
   ChatSendOutputPick,
@@ -20,7 +20,7 @@ import type {
   TaskSessionRuntimePort,
   UserSimulatorDecision,
 } from "@/plugin/builtins/task/runtime/TaskRunnerTypes.js";
-import { withSessionRunScope } from "@session/SessionRunScope.js";
+import { withSessionRunScope } from "@executor/SessionRunScope.js";
 import { appendTaskRoundUserMessage } from "./TaskRunnerSession.js";
 
 /**

package/src/plugin/builtins/task/runtime/TaskRunnerSession.ts

@@ -11,17 +11,17 @@
 import path from "node:path";
 import type { LanguageModel } from "ai";
 import type { AgentContext } from "@/core/AgentContextTypes.js";
-import { Executor } from "@/session/Executor.js";
-import type { SessionRunResult } from "@/session/types/SessionRun.js";
+import { Executor } from "@/executor/Executor.js";
+import type { SessionRunResult } from "@/executor/types/SessionRun.js";
 import type { TaskSessionRuntimePort } from "@/plugin/builtins/task/runtime/TaskRunnerTypes.js";
-import { drainDeferredPersistedUserMessages } from "@session/SessionRunScope.js";
-import { JsonlSessionHistoryComposer } from "@session/composer/history/jsonl/JsonlSessionHistoryComposer.js";
-import { JsonlSessionHistoryStore } from "@/session/store/history/jsonl/JsonlSessionHistoryStore.js";
-import { JsonlSessionCompactionComposer } from "@session/composer/compaction/jsonl/JsonlSessionCompactionComposer.js";
-import { LocalSessionContextComposer } from "@session/composer/context/LocalSessionContextComposer.js";
-import { DefaultSessionSystemComposer } from "@session/composer/system/default/DefaultSessionSystemComposer.js";
-import { shellTools } from "@session/tools/shell/ShellToolDefinition.js";
-import type { SessionExecutor } from "@/session/types/SessionExecutor.js";
+import { drainDeferredPersistedUserMessages } from "@executor/SessionRunScope.js";
+import { JsonlSessionHistoryComposer } from "@executor/composer/history/jsonl/JsonlSessionHistoryComposer.js";
+import { JsonlSessionHistoryStore } from "@/executor/store/history/jsonl/JsonlSessionHistoryStore.js";
+import { JsonlSessionCompactionComposer } from "@executor/composer/compaction/jsonl/JsonlSessionCompactionComposer.js";
+import { LocalSessionContextComposer } from "@executor/composer/context/LocalSessionContextComposer.js";
+import { DefaultSessionSystemComposer } from "@executor/composer/system/default/DefaultSessionSystemComposer.js";
+import { shellTools } from "@executor/tools/shell/ShellToolDefinition.js";
+import type { SessionExecutor } from "@/executor/types/SessionExecutor.js";
 
 /**
  * 把 task round 的 user query 落盘到对应 run context。

package/src/plugin/builtins/task/runtime/TaskRunnerTypes.ts

@@ -6,8 +6,8 @@
  * - 这些类型服务于 task 运行链路，统一归档到 `src/types/task/`。
  */
 
-import type { JsonlSessionHistoryStore } from "@/session/store/history/jsonl/JsonlSessionHistoryStore.js";
-import type { SessionExecutor } from "@/session/types/SessionExecutor.js";
+import type { JsonlSessionHistoryStore } from "@/executor/store/history/jsonl/JsonlSessionHistoryStore.js";
+import type { SessionExecutor } from "@/executor/types/SessionExecutor.js";
 import type {
   ShipTaskRunExecutionStatusV1,
   ShipTaskRunProgressPhaseV1,

package/src/plugin/builtins/task/types/Cron.ts

@@ -1,7 +1,7 @@
 /**
  * cron 触发定义。
  */
-export type ServiceCronTriggerDefinition = {
+export type TaskCronTriggerDefinition = {
   id: string;
   expression: string;
   timezone?: string;
@@ -11,6 +11,6 @@ export type ServiceCronTriggerDefinition = {
 /**
  * cron 引擎端口。
  */
-export type ServiceCronEngine = {
-  register(definition: ServiceCronTriggerDefinition): void;
+export type TaskCronEngine = {
+  register(definition: TaskCronTriggerDefinition): void;
 };

package/src/plugin/builtins/task/types/TaskPluginTypes.ts

@@ -1,9 +1,9 @@
 /**
- * TaskService 类型定义。
+ * Task plugin runtime 类型定义。
  *
  * 关键点（中文）
- * - 这里集中声明 task service 在类化拆分后共享的 action payload 与调度结果类型。
- * - 跨模块复用的 task service 类型统一收敛在 `service/builtins/task/types/`。
+ * - 这里集中声明 task plugin runtime 在类化拆分后共享的 action payload 与调度结果类型。
+ * - 跨模块复用的 task plugin runtime 类型统一收敛在 `plugin/builtins/task/types/`。
  */
 
 import type { ShipTaskStatus } from "@/plugin/builtins/task/types/Task.js";