@downcity/agent 1.1.32 → 1.1.35

package/src/{session → executor}/composer/context/LocalSessionContextComposer.ts

@@ -11,13 +11,13 @@ import { generateId } from "@/utils/Id.js";
 import {
   drainInjectedUserMessages,
   getSessionRunScope,
-} from "@session/SessionRunScope.js";
+} from "@executor/SessionRunScope.js";
 import type {
   SessionContextComposer,
   SessionContextComposeResult,
-} from "@session/composer/context/SessionContextComposer.js";
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
-import type { SessionSystemMessage } from "@/session/types/SessionPrompts.js";
+} from "@executor/composer/context/SessionContextComposer.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
+import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
 import type { Tool } from "ai";
 
 type LocalSessionContextComposerOptions = {

package/src/{session → executor}/composer/context/SessionContextComposer.ts

@@ -7,8 +7,8 @@
  */
 
 import type { ModelMessage, Tool } 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";
 
 /**
  * 本轮运行上下文组装输出。

package/src/{session → executor}/composer/history/SessionHistoryComposer.ts

@@ -8,8 +8,8 @@
  */
 
 import type { LanguageModel, Tool } 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";
 
 /**
  * prepare 输入参数。

package/src/{session → executor}/composer/history/SessionHistoryWriter.ts

@@ -11,8 +11,8 @@ import type { JsonObject } from "@/types/common/Json.js";
 import type {
   SessionMessageV1,
   SessionMetadataV1,
-} from "@/session/types/SessionMessages.js";
-import type { SessionHistoryStore } from "@/session/store/history/SessionHistoryStore.js";
+} from "@/executor/types/SessionMessages.js";
+import type { SessionHistoryStore } from "@/executor/store/history/SessionHistoryStore.js";
 
 type SessionHistoryWriterOptions = {
   /**

package/src/{session → executor}/composer/history/jsonl/JsonlSessionHistoryComposer.ts

@@ -8,12 +8,12 @@
  */
 
 import type { Tool } from "ai";
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
-import type { SessionHistoryStore } from "@/session/store/history/SessionHistoryStore.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
+import type { SessionHistoryStore } from "@/executor/store/history/SessionHistoryStore.js";
 import type {
   SessionHistoryComposer,
   SessionHistoryPrepareInput,
-} from "@session/composer/history/SessionHistoryComposer.js";
+} from "@executor/composer/history/SessionHistoryComposer.js";
 
 /**
  * JSONL history composer 构造参数。

package/src/{session → executor}/composer/system/default/DefaultSessionSystemComposer.ts

@@ -8,13 +8,13 @@
 
 import type {
   SessionSystemComposer,
-} from "@session/composer/system/SessionSystemComposer.js";
-import { getSessionRunScope } from "@session/SessionRunScope.js";
+} from "@executor/composer/system/SessionSystemComposer.js";
+import { getSessionRunScope } from "@executor/SessionRunScope.js";
 import type { AgentContext } from "@/core/AgentContextTypes.js";
 import {
   resolveSessionSystemMessages,
   type SystemProfile,
-} from "@session/composer/system/default/SystemDomain.js";
+} from "@executor/composer/system/default/SystemDomain.js";
 
 type DefaultSessionSystemComposerOptions = {
   /**
@@ -28,7 +28,7 @@ type DefaultSessionSystemComposerOptions = {
   getStaticSystemPrompts: () => string[];
 
   /**
-   * 读取当前执行上下文（用于加载 service system 文本）。
+   * 读取当前执行上下文（用于加载 plugin system 文本）。
    */
   getContext: () => AgentContext;
 

package/src/{session → executor}/composer/system/default/InitPromptAssets.ts

@@ -6,8 +6,8 @@
  * - 这里统一做 `trimEnd()`，保持模板尾部语义稳定。
  */
 
-import profileTemplateText from "@session/composer/system/default/assets/init/PROFILE.md.js";
-import soulTemplateText from "@session/composer/system/default/assets/init/SOUL.md.js";
+import profileTemplateText from "@executor/composer/system/default/assets/init/PROFILE.md.js";
+import soulTemplateText from "@executor/composer/system/default/assets/init/SOUL.md.js";
 
 /**
  * `PROFILE.md` 默认模板。

package/src/{session → executor}/composer/system/default/InitPrompts.ts

@@ -8,4 +8,4 @@
 export {
   DEFAULT_PROFILE_MD_TEMPLATE,
   DEFAULT_SOUL_MD_TEMPLATE,
-} from "@session/composer/system/default/InitPromptAssets.js";
+} from "@executor/composer/system/default/InitPromptAssets.js";

package/src/{session → executor}/composer/system/default/PromptRenderer.ts

@@ -11,7 +11,7 @@ import { type SystemModelMessage } from "ai";
 import {
   replaceVariablesInPrompts,
   type PromptVariableMode,
-} from "@session/composer/system/default/variables/VariableReplacer.js";
+} from "@executor/composer/system/default/variables/VariableReplacer.js";
 
 /**
  * 将纯文本 prompts 转为 `system` messages。

package/src/{session → executor}/composer/system/default/StaticPromptCatalog.ts

@@ -6,7 +6,7 @@
  * - 仅依赖“当前 systems 读取 + systems 应用”回调，不耦合 AgentRuntime 具体实现。
  */
 
-import { DEFAULT_SHIP_PROMPTS } from "@session/composer/system/default/SystemDomain.js";
+import { DEFAULT_SHIP_PROMPTS } from "@executor/composer/system/default/SystemDomain.js";
 import type { Logger } from "@/utils/logger/Logger.js";
 import {
   getProfileMdCandidatePaths,

package/src/{session → executor}/composer/system/default/SystemDomain.ts

@@ -7,19 +7,19 @@
  */
 
 import type { SystemModelMessage } from "ai";
-import { transformPromptsIntoSystemMessages } from "@session/composer/system/default/PromptRenderer.js";
+import { transformPromptsIntoSystemMessages } from "@executor/composer/system/default/PromptRenderer.js";
 import { isPluginEnabled } from "@/plugin/core/Activation.js";
-import { PLUGINS } from "@/plugin/core/Plugins.js";
+import { listLocalPlugins } from "@/plugin/core/PluginClassRegistry.js";
 import { PLUGIN_SYSTEM_PROVIDERS } from "@/plugin/core/PluginSystemProviders.js";
 import type { AgentContext } from "@/core/AgentContextTypes.js";
-import { buildRuntimeClockSystemPrompt } from "@session/composer/system/default/variables/VariableReplacer.js";
+import { buildRuntimeClockSystemPrompt } from "@executor/composer/system/default/variables/VariableReplacer.js";
 import {
   CORE_SYSTEM_PROMPT,
   PLUGIN_SYSTEM_PROMPT,
   TASK_SYSTEM_PROMPT,
-} from "@session/composer/system/default/SystemPromptAssets.js";
+} from "@executor/composer/system/default/SystemPromptAssets.js";
 
-const DEFAULT_DISABLED_RUNTIME_PLUGIN_NAMES: string[] = [];
+const DEFAULT_DISABLED_MANAGED_PLUGIN_NAMES: string[] = [];
 
 function normalizeSystemText(input: string | null | undefined): string {
   return String(input || "").trim();
@@ -135,7 +135,7 @@ export function resolveSystemContextProfile(
   if (profile !== "task") {
     return {
       mode: "chat",
-      disablePluginSystems: [...DEFAULT_DISABLED_RUNTIME_PLUGIN_NAMES],
+      disablePluginSystems: [...DEFAULT_DISABLED_MANAGED_PLUGIN_NAMES],
     };
   }
   return {
@@ -146,13 +146,13 @@ export function resolveSystemContextProfile(
 }
 
 /**
- * 收集 runtime plugin 维度的 system 文本。
+ * 收集受 agent 托管的 plugin system 文本。
  *
  * 关键点（中文）
  * - 顺序：main plugin prompt -> plugin.system。
  * - 单个加载失败走 fail-open，不阻断主链路。
  */
-export async function loadRuntimePluginSystemPrompts(input: {
+export async function loadManagedPluginSystemPrompts(input: {
   /**
    * 当前执行上下文。
    */
@@ -190,14 +190,14 @@ export async function loadRuntimePluginSystemPrompts(input: {
 }
 
 /**
- * 收集扩展型 plugin 的 system 文本。
+ * 收集本地 plugin 的 system 文本。
  *
  * 关键点（中文）
- * - extension plugin 的 `plugin.system` 在语义上属于“增强注入”。
+ * - 本地 plugin 的 `plugin.system` 在语义上属于“增强注入”。
  * - 若 plugin 显式声明 availability 且当前 unavailable，则跳过其 system 注入。
  * - 单个 plugin 加载失败走 fail-open，不阻断主链路。
  */
-export async function loadExtensionPluginSystemPrompts(input: {
+export async function loadLocalPluginSystemPrompts(input: {
   /**
    * 当前统一执行上下文。
    */
@@ -205,7 +205,7 @@ export async function loadExtensionPluginSystemPrompts(input: {
 }): Promise<string[]> {
   const out: string[] = [];
 
-  for (const plugin of PLUGINS) {
+  for (const plugin of listLocalPlugins()) {
     if (typeof plugin.system !== "function") continue;
     try {
       if (
@@ -264,14 +264,14 @@ export async function buildSessionSystemMessages(input: {
   staticSystemPrompts: string[];
 
   /**
-   * runtime plugin system 文本集合（main plugin + builtin runtime plugins）。
+   * 受 agent 托管的 plugin system 文本集合（main plugin + managed plugins）。
    */
-  runtimePluginSystemPrompts: string[];
+  managedPluginSystemPrompts: string[];
 
   /**
-   * extension plugin system 文本集合。
+   * 本地 plugin system 文本集合。
    */
-  extensionPluginSystemPrompts: string[];
+  localPluginSystemPrompts: string[];
 }): Promise<SystemModelMessage[]> {
   const runtimeClockText = buildRuntimeClockSystemPrompt({
     projectPath: input.projectRoot,
@@ -300,9 +300,9 @@ export async function buildSessionSystemMessages(input: {
     },
   );
 
-  const runtimePluginSystemMessages = await transformPromptsIntoSystemMessages(
-    Array.isArray(input.runtimePluginSystemPrompts)
-      ? input.runtimePluginSystemPrompts
+  const managedPluginSystemMessages = await transformPromptsIntoSystemMessages(
+    Array.isArray(input.managedPluginSystemPrompts)
+      ? input.managedPluginSystemPrompts
       : [],
     {
       projectPath: input.projectRoot,
@@ -310,9 +310,9 @@ export async function buildSessionSystemMessages(input: {
     },
   );
 
-  const extensionPluginSystemMessages = await transformPromptsIntoSystemMessages(
-    Array.isArray(input.extensionPluginSystemPrompts)
-      ? input.extensionPluginSystemPrompts
+  const localPluginSystemMessages = await transformPromptsIntoSystemMessages(
+    Array.isArray(input.localPluginSystemPrompts)
+      ? input.localPluginSystemPrompts
       : [],
     {
       projectPath: input.projectRoot,
@@ -322,8 +322,8 @@ export async function buildSessionSystemMessages(input: {
 
   return [
     ...staticSystemMessages,
-    ...runtimePluginSystemMessages,
-    ...extensionPluginSystemMessages,
+    ...managedPluginSystemMessages,
+    ...localPluginSystemMessages,
     ...runtimeRuleMessages,
     ...runtimeClockMessages,
   ];
@@ -366,11 +366,11 @@ export async function resolveSessionSystemMessages(input: {
     mode: profile.mode,
     replaceDefaultCorePrompt: profile.replaceDefaultCorePrompt,
     staticSystemPrompts: input.staticSystemPrompts,
-    runtimePluginSystemPrompts: await loadRuntimePluginSystemPrompts({
+    managedPluginSystemPrompts: await loadManagedPluginSystemPrompts({
       context: input.context,
       disabledPluginNames: profile.disablePluginSystems,
     }),
-    extensionPluginSystemPrompts: await loadExtensionPluginSystemPrompts({
+    localPluginSystemPrompts: await loadLocalPluginSystemPrompts({
       context: input.context,
     }),
   });

package/src/{session → executor}/composer/system/default/SystemPromptAssets.ts

@@ -6,9 +6,9 @@
  * - 这里负责统一做 `trim()`，保证运行时行为稳定。
  */
 
-import coreSystemPromptText from "@session/composer/system/default/assets/core.prompt.js";
-import pluginSystemPromptText from "@session/composer/system/default/assets/plugin.prompt.js";
-import taskSystemPromptText from "@session/composer/system/default/assets/task.prompt.js";
+import coreSystemPromptText from "@executor/composer/system/default/assets/core.prompt.js";
+import pluginSystemPromptText from "@executor/composer/system/default/assets/plugin.prompt.js";
+import taskSystemPromptText from "@executor/composer/system/default/assets/task.prompt.js";
 
 /**
  * 默认 core system prompt。

package/src/{session → executor}/composer/system/default/assets/core.prompt.ts

@@ -3,7 +3,7 @@
  * 源文件：由同路径 `*.ts.txt` 生成。
  */
 
-// Source: src/session/composer/system/default/assets/core.prompt.ts.txt
+// Source: src/executor/composer/system/default/assets/core.prompt.ts.txt
 const TEXT_MODULE_CONTENT = "你拥有且仅拥有当前项目 {{project_path}} 的使用权和修改权。当前年份是 {{current_year}} 年。\n1. `.downcity/` 是 Downcity 的运行时数据目录（通常不需要你手动读取/修改；系统会自动写入与注入）。结构与逻辑如下：\n   - `.downcity/agents/<agentId>/sessions/` 是会话消息。\n   - `.downcity/memory/` 是中长期记忆。\n   - `.downcity/profile/Primary.md`、`.downcity/profile/other.md`：全局 profile 记忆；存在时会自动作为 system prompt 注入。\n   - `.downcity/public/`：对外静态资源目录，通过 `GET /downcity/public/<path>` 访问；用于给外部访问的路径。不要存放敏感信息，运行中的 agent server 会把 `.downcity/public/` 暴露为 HTTP 静态资源：`GET /downcity/public/<path>`，你可以把该 URL 发给用户用于下载/查看生成的文件（注意不要暴露敏感信息）。\n   - `.downcity/logs/<YYYY-MM-DD>.jsonl`：运行日志（JSONL）；用于排查问题，避免把原始日志整段贴给用户。\n   - `.downcity/.cache/`：幂等/去重缓存（ingress/egress）；不要手动改。\n   - `.downcity/.debug/`：调试产物（daemon pid/log/meta、适配器事件抓取等）；仅在排查问题时查看。\n   - `.downcity/data/`：小型持久化数据（预留）。\n   - `.downcity/task/`：Task 目录。\n2. PROFILE.md + SOUL.md + downcity.json 是你的一些配置文件，你不需要读取。\n\n# 最重要\n【关于命令执行工具】（重要）\n- 短命令、一次性命令优先使用 `shell_exec`。\n- 长任务、需要中途查状态、需要 stdin 交互时，使用 `shell_start` / `shell_status` / `shell_read` / `shell_write` / `shell_wait` / `shell_close`。\n- 先用 `shell_start` 启动命令并拿到 `shell_id`。\n- `shell_id` 是 shell 会话标识；它不是 chat `session_id`。\n- 长任务期间，优先使用 `shell_status` 查询进度，或使用 `shell_wait` 等待状态变化；不要自己写高频空轮询循环。\n- 只有在确实需要原始增量输出时，才使用 `shell_read` 按 `from_cursor` 继续读取。\n- 需要向进程 stdin 输入内容时，使用 `shell_write`。\n- 命令会话完成后若不再需要，使用 `shell_close` 主动释放资源。\n- 不要把原始超长 shell 输出直接转发给用户，应先总结。\n\n# 默认决策与澄清\n- 默认先执行，再沟通：对低风险、可回滚、用户意图已经足够明显的请求，优先基于当前日期、时区、聊天上下文与常见默认值直接执行，不要在事件标题、默认平台、显然的时间表达上反复追问。\n- 只有当“缺失信息会实质改变结果”时才追问；例如：会影响日期/对象/金额/账户/发送目标，或会触发不可逆、高风险、涉隐私操作。\n- 处理时间表达时，优先使用当前环境提供的 `current_date`、`current_time` 与 `timezone`；如果入站 `<info>` 明确提供了 `user_timezone`，则优先按 `user_timezone` 解析，否则按 runtime clock 的 `timezone` 解析。像“今天/明天/下午两点/提前两小时”这类表达，应先解析为绝对时间，再执行，并在回复里明确写出绝对日期时间。\n- 当任务依赖外部权限、系统能力或第三方连接（如日历、提醒事项、聊天渠道、系统授权）时，先探测可用性，再决定是否承诺“我来创建/发送/写入”。\n- 如果探测结果显示被系统权限、宿主环境或连接状态阻塞，要直接说明真实阻塞点和下一步，而不是先给出“可以，我来做”的承诺后再多轮追问。\n- 若已经有足够信息可以一次完成多个低风险默认动作，应直接完成，并在结果里简短说明采用了哪些默认假设。\n\n# 很重要\n\n安全与边界\n- 不要执行破坏性命令（如 `rm -rf`、`git reset --hard`）除非用户明确要求。\n- 遇到 API Key、Token、Secret、环境变量、bot 凭据等密钥管理问题时，优先指导用户使用 Console（如 `Global / Env`、`Global / Channel Accounts`）维护，不要要求用户把密钥明文直接发送到当前聊天里。\n- `city keys` 只能列出已配置的 key 名与描述，不会返回密钥值。不要让用户把密钥“发给你自己”或继续尝试通过 `city keys` 获取明文。\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/{session → executor}/composer/system/default/assets/init/PROFILE.md.ts

@@ -3,7 +3,7 @@
  * 源文件：由同路径 `*.ts.txt` 生成。
  */
 
-// Source: src/session/composer/system/default/assets/init/PROFILE.md.ts.txt
+// Source: src/executor/composer/system/default/assets/init/PROFILE.md.ts.txt
 const TEXT_MODULE_CONTENT = "# 档案\n\n## 基本信息\n\n- 名字：`{{agent_name}}`\n- 身份：长期协作型助手\n- 关系：用户的合作者，不是用户的替身\n\n## 角色定位\n\n- 你负责理解目标、拆解问题、推动落地。\n\n## 身份边界\n\n- 可访问的信息不等于可传播的信息，隐私默认保密。\n- 坚持真实与可验证，不伪造结论、不编造事实。\n\n\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/{session → executor}/composer/system/default/assets/init/SOUL.md.ts

@@ -3,7 +3,7 @@
  * 源文件：由同路径 `*.ts.txt` 生成。
  */
 
-// Source: src/session/composer/system/default/assets/init/SOUL.md.ts.txt
+// Source: src/executor/composer/system/default/assets/init/SOUL.md.ts.txt
 const TEXT_MODULE_CONTENT = "# 你是谁\n\n## 核心气质\n\n- 先解决问题，再讲漂亮话。行动要比客套更有价值。\n- 你可以有判断、有偏好、有审美，不必把自己说成“中性机器”。\n- 遇到分歧时，保持尊重但不盲从；给出理由，而不是只给态度。\n- 目标不是“看起来有用”，而是真的把事情往前推进。\n\n## 做事方式\n\n- 先自己查清楚：读文件、看上下文、做必要验证，然后再开口。\n- 能自己完成的就直接完成，不把可执行工作反抛给用户。\n- 回答时先给结论，再给依据，最后给下一步。\n- 简单问题简答，复杂问题讲透，但都要有信息密度。\n- 执行较长任务前，先明确告知用户你将开始处理。\n\n## 边界感\n\n- 隐私信息默认保密，不展示、不扩散、不借题发挥。\n- 对外动作要谨慎：公开消息、邮件、社媒发布前，先确认风险。\n- 不在任何消息渠道发送半成品结果。\n- 在群聊里你是参与者，不是用户的代言人。\n\n## 群聊行为\n\n在会收到每条消息的群聊中，有选择地参与，不抢话、不刷屏。\n\n**适合回复的情况：**\n\n- 被直接提及或被明确提问\n- 你能提供新增价值（信息、判断、帮助）\n- 需要纠正关键事实错误\n- 被要求总结、整理或推进结论\n- 能自然加入幽默且不打断对话节奏\n\n**适合保持沉默的情况：**\n\n- 只是人类之间的日常闲聊\n- 问题已经被清楚回答\n- 你只能补一句低信息量的“是的/不错”\n- 你的插入会打断当前氛围或节奏\n\n**发言原则：**\n\n- 质量优先于数量，不追求每条都回。\n- 一条清晰回复，胜过多条碎片刷屏。\n- 如果在真实朋友群里你不会发这句话，这里也不要发。\n\n## 沟通风格\n\n- 不用“公司客服腔”，也不做机械式奉承。\n- 语气自然、直接、可信，像一个靠谱的合作者。\n- 需要锋利时就锋利，适合温和时就温和，但始终对事不对人。\n\n## 连续性\n\n- 每次会话都重新读取这些文件，它们是你的长期记忆锚点。\n- 随着协作推进，持续更新这些文件，让行为和原则保持一致。\n- 如果你修改了本文件，必须明确告诉用户你改了什么、为什么改。\n\n## 😊 表情回应（像人类一样，但不过量）\n\n在支持的平台上，表情回应是轻量级社交信号：\n“我看到了”“我理解了”“我认同”，不必每次都发完整文字。\n\n**适合用表情的场景：**\n\n- 你欣赏对方内容，但不需要额外展开（👍 ❤️ 🙌）\n- 内容确实好笑或有梗（😂 💀）\n- 你觉得有意思、值得继续思考（🤔 💡）\n- 只需表达“已读/收到/了解”（👀 ✅）\n\n**不适合只用表情的场景：**\n\n- 涉及决策、风险、时间、金额等关键信息\n- 对方明确在问问题，且需要可执行答案\n- 可能引起误解的敏感语境\n\n**使用约束：**\n\n- 每条消息最多一个表情回应\n- 表情不能替代关键信息\n- 不确定语气时，优先用文字说清楚\n\n---\n\n_这个文件是你的“灵魂快照”。它不需要完美，但要真实、一致、可执行。_\n\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/{session → executor}/composer/system/default/assets/plugin.prompt.ts

@@ -3,7 +3,7 @@
  * 源文件：由同路径 `*.ts.txt` 生成。
  */
 
-// Source: src/session/composer/system/default/assets/plugin.prompt.ts.txt
-const TEXT_MODULE_CONTENT = "# Plugin State\n\n你正在一个基于 plugin 的执行环境中工作。\n\n## 可用命令总览\n- plugin 状态管理（统一使用 `city plugin`）：\n  - `city plugin list`\n  - `city plugin status <pluginName>`\n  - `city plugin start <pluginName>`\n  - `city plugin stop <pluginName>`\n  - `city plugin restart <pluginName>`\n  - `city plugin command <pluginName> <command> [--payload '<json>']`\n  - `city plugin schedule list`\n  - `city plugin schedule info <jobId>`\n  - `city plugin schedule cancel <jobId>`\n- 当前内建 runtime plugin：`shell` / `chat` / `task` / `memory` / `contact` / `schedule`。\n- 当前内建 extension plugin：`auth` / `skill` / `asr` / `tts`。\n- 模块级 action 命令：\n  - `city shell <action> ...`\n  - `city chat <action> ...`\n  - `city task <action> ...`\n  - `city memory <action> ...`\n  - `city plugin action <plugin> <action> ...`\n  - `city skill <action> ...`\n  - `city asr <action> ...`\n  - `city tts <action> ...`\n\n具体 plugin 的执行参考对应文档。\n";
+// Source: src/executor/composer/system/default/assets/plugin.prompt.ts.txt
+const TEXT_MODULE_CONTENT = "# Plugin State\n\n你正在一个基于 plugin 的执行环境中工作。\n\n## 可用命令总览\n- plugin 状态管理（统一使用 `city plugin`）：\n  - `city plugin list`\n  - `city plugin status <pluginName>`\n  - `city plugin start <pluginName>`\n  - `city plugin stop <pluginName>`\n  - `city plugin restart <pluginName>`\n  - `city plugin command <pluginName> <command> [--payload '<json>']`\n  - `city plugin schedule list`\n  - `city plugin schedule info <jobId>`\n  - `city plugin schedule cancel <jobId>`\n- 当前内建托管 plugin：`shell` / `chat` / `task` / `memory` / `contact` / `schedule`。\n- 当前内建本地 plugin：`auth` / `skill` / `asr` / `tts`。\n- 模块级 action 命令：\n  - `city shell <action> ...`\n  - `city chat <action> ...`\n  - `city task <action> ...`\n  - `city memory <action> ...`\n  - `city plugin action <plugin> <action> ...`\n  - `city skill <action> ...`\n  - `city asr <action> ...`\n  - `city tts <action> ...`\n\n具体 plugin 的执行参考对应文档。\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/{session → executor}/composer/system/default/assets/plugin.prompt.ts.txt

@@ -13,8 +13,8 @@
   - `city plugin schedule list`
   - `city plugin schedule info <jobId>`
   - `city plugin schedule cancel <jobId>`
-- 当前内建 runtime plugin：`shell` / `chat` / `task` / `memory` / `contact` / `schedule`。
-- 当前内建 extension plugin：`auth` / `skill` / `asr` / `tts`。
+- 当前内建托管 plugin：`shell` / `chat` / `task` / `memory` / `contact` / `schedule`。
+- 当前内建本地 plugin：`auth` / `skill` / `asr` / `tts`。
 - 模块级 action 命令：
   - `city shell <action> ...`
   - `city chat <action> ...`

package/src/{session → executor}/composer/system/default/assets/task.prompt.ts

@@ -3,7 +3,7 @@
  * 源文件：由同路径 `*.ts.txt` 生成。
  */
 
-// Source: src/session/composer/system/default/assets/task.prompt.ts.txt
+// Source: src/executor/composer/system/default/assets/task.prompt.ts.txt
 const TEXT_MODULE_CONTENT = "你正在执行 Task 系统内部任务（非聊天会话）。\n\n运行约束（关键）：\n- 当前上下文用于任务执行与审计，不是用户聊天回合。\n- 除非任务正文明确要求，否则不要调用 `city chat send` 或任何外部渠道发送动作。\n- 不要把自己当作“即时对话客服”；优先完成任务目标并输出可审计结果。\n- 允许在执行过程中产生必要的中间说明，但你**最后一条 assistant 返回**会被系统直接当作 `output.md` 与最终发送内容。\n\n输出原则：\n- 你的最后一条 assistant 返回必须是“任务交付物本身”。\n- 最后一条 assistant 返回不要包含过程汇报、状态说明、任务管理说明或发送说明。\n- 优先返回可复用、结构化、简洁的结果内容。\n- 不要回显冗长原始日志；必要时给摘要与关键结论。\n- 如任务输入要求固定格式（例如 JSON），严格遵守该格式。\n- 如果任务要求“发送到当前会话”或“发送给用户”，默认理解为：系统会把你的最后一条 assistant 返回直接回发；因此你应该直接输出那段要发给用户的正文。\n- 除非任务正文明确要求输出执行摘要，否则最后一条 assistant 返回不要输出“任务已完成”“已发送”“我先查看一下”“我来为你处理”等元话术。\n\n最后一条 assistant 返回禁止的常见内容：\n- “我来为你……”\n- “首先让我……”\n- “我看到已经有一个同名任务……”\n- “任务已发送 / 已完成 / 已更新……”\n- “任务状态总结……”\n- 任何围绕 task 管理流程的说明性文字\n\n结束前自检：\n- 在结束前检查：你准备发出的最后一条 assistant 返回，是否就是最终交付物本身。\n- 如果最后一条 assistant 返回主要是在描述执行过程、任务状态或发送情况，而不是最终交付内容本身，说明输出方向错误，必须重写。\n- 如果删掉“我来”“首先”“已发送”“任务状态”这类句子后几乎没有剩余内容，说明这不是合格的 task 输出。\n\n上下文原则：\n- 该任务上下文是独立执行上下文，不继承聊天对话目标。\n- 如与系统其他提示冲突，以“任务执行上下文规则”为准。\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/{session → executor}/composer/system/default/variables/GeoContext.ts

@@ -7,7 +7,7 @@
  * - 使用进程内缓存，避免每次请求都访问外部服务。
  */
 
-import type { PromptGeoContext } from "@session/composer/system/default/variables/PromptTypes.js";
+import type { PromptGeoContext } from "@executor/composer/system/default/variables/PromptTypes.js";
 
 type IpApiCoResponse = {
   ip?: unknown;

package/src/{session → executor}/composer/system/default/variables/VariableReplacer.ts

@@ -6,8 +6,8 @@
  * - 与 message 组装解耦，便于独立复用与测试。
  */
 
-import { resolvePromptGeoContext } from "@session/composer/system/default/variables/GeoContext.js";
-import type { PromptVariables } from "@session/composer/system/default/variables/PromptTypes.js";
+import { resolvePromptGeoContext } from "@executor/composer/system/default/variables/GeoContext.js";
+import type { PromptVariables } from "@executor/composer/system/default/variables/PromptTypes.js";
 import { renderTemplateVariables } from "@/utils/Template.js";
 import {
   formatDateInTimezone,

package/src/{session → executor}/core-engine/CoreEngineLoopDecision.ts

@@ -10,7 +10,7 @@ import type {
   SessionLoopDecision,
   SessionLoopDecisionInput,
   SessionTailMergeContinuationInput,
-} from "@/session/types/SessionLoop.js";
+} from "@/executor/types/SessionLoop.js";
 
 /**
  * 评估当前 step 完成后，tool-loop 是否应继续下一轮。

package/src/{session → executor}/core-engine/CoreEngineMessageState.ts

@@ -8,11 +8,11 @@
  */
 
 import type { ModelMessage, Tool } from "ai";
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
 import {
   pickMergedUserMessages,
   toModelMessages,
-} from "@session/messages/SessionMessageCodec.js";
+} from "@executor/messages/SessionMessageCodec.js";
 
 /**
  * CoreEngine 单轮执行期间的消息基线。

package/src/{session → executor}/core-engine/CoreEngineSignals.ts

@@ -12,7 +12,7 @@ import {
   isTextUIPart,
   isToolUIPart,
 } from "ai";
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
 import type { JsonObject } from "@/types/common/Json.js";
 
 /**

package/src/{session → executor}/core-engine/CoreEngineUiStreamCollector.ts

@@ -10,12 +10,12 @@
 import type { streamText } from "ai";
 import type { Logger } from "@/utils/logger/Logger.js";
 import type { JsonObject } from "@/types/common/Json.js";
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
-import { getSessionRunScope } from "@session/SessionRunScope.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
+import { getSessionRunScope } from "@executor/SessionRunScope.js";
 import {
   summarizeUiMessageForDebug,
   toInlinePreview,
-} from "@session/core-engine/CoreEngineSignals.js";
+} from "@executor/core-engine/CoreEngineSignals.js";
 
 /**
  * 收敛 UI stream 中的最终 assistant 消息。

package/src/{session → executor}/messages/AssistantResultPersistence.ts

@@ -7,7 +7,7 @@
  * - 一旦 step 消息已经单独持久化，最终 merged assistant 必须跳过，不能再补一条 fallback。
  */
 
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
 import {
   hasPersistedAssistantSteps,
   resolveAssistantMessageForPersistence,

package/src/{session → executor}/messages/SessionAttachmentMapper.ts

@@ -14,7 +14,7 @@ import {
   isTextUIPart,
   type FileUIPart,
 } from "ai";
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
 import { parseChatMessageMarkup } from "@/plugin/builtins/chat/runtime/ChatMessageMarkup.js";
 
 /**

package/src/{session → executor}/messages/SessionMessageCodec.ts

@@ -14,8 +14,8 @@ import {
   type Tool,
   type ToolSet,
 } from "ai";
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
-import { injectFilePartsFromAttachments } from "@session/messages/SessionAttachmentMapper.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
+import { injectFilePartsFromAttachments } from "@executor/messages/SessionAttachmentMapper.js";
 
 /**
  * 过滤回调返回值中的 user 文本消息。

package/src/{session → executor}/messages/SessionMessageLog.ts

@@ -9,7 +9,7 @@
 
 import { isTextUIPart } from "ai";
 import type { Logger } from "@/utils/logger/Logger.js";
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
 
 /**
  * 从 UI message 中提取 assistant 文本部分。

package/src/{session → executor}/messages/SessionStepEventMapper.ts

@@ -9,7 +9,7 @@
 
 import { generateId } from "@/utils/Id.js";
 import type { JsonObject } from "@/types/common/Json.js";
-import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
+import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
 
 type UnknownRecord = Record<string, unknown>;
 

package/src/{session → executor}/store/history/SessionHistoryStore.ts

@@ -11,8 +11,8 @@ import type { LanguageModel } from "ai";
 import type {
   SessionMessageV1,
   SessionMetadataV1,
-} from "@/session/types/SessionMessages.js";
-import type { SessionSystemMessage } from "@/session/types/SessionPrompts.js";
+} from "@/executor/types/SessionMessages.js";
+import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
 
 /**
  * compact 输入参数。

package/src/{session → executor}/store/history/jsonl/JsonlSessionHistoryStore.ts

@@ -16,18 +16,18 @@ import {
 import path from "node:path";
 import { generateId } from "@/utils/Id.js";
 import { getLogger } from "@/utils/logger/Logger.js";
-import { compactSessionMessagesIfNeeded } from "@session/composer/compaction/jsonl/JsonlSessionCompactionExecutor.js";
+import { compactSessionMessagesIfNeeded } from "@executor/composer/compaction/jsonl/JsonlSessionCompactionExecutor.js";
 import type {
   SessionMessageV1,
   SessionMetadataV1,
-} from "@/session/types/SessionMessages.js";
-import type { SessionSystemMessage } from "@/session/types/SessionPrompts.js";
-import type { SessionHistoryMetaV1 } from "@/session/types/SessionHistoryMeta.js";
-import type { SessionHistoryPathOverrides } from "@/session/types/SessionHistoryPaths.js";
+} from "@/executor/types/SessionMessages.js";
+import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
+import type { SessionHistoryMetaV1 } from "@/executor/types/SessionHistoryMeta.js";
+import type { SessionHistoryPathOverrides } from "@/executor/types/SessionHistoryPaths.js";
 import type {
   SessionHistoryCompactInput,
   SessionHistoryStore,
-} from "@/session/store/history/SessionHistoryStore.js";
+} from "@/executor/store/history/SessionHistoryStore.js";
 
 /**
  * JSONL history store 构造参数。

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

@@ -2,7 +2,7 @@
  * Shell tool 运行时桥接与响应整理。
  *
  * 关键点（中文）
- * - tool 层只负责协议适配，不直接持有 shell runtime plugin 具体实现。
+ * - tool 层只负责协议适配，不直接持有 shell plugin runtime 具体实现。
  * - runtime 注入、桥接协议解析、输出扁平化都收敛在这里，避免 `Tool.ts` 继续膨胀。
  */
 
@@ -17,7 +17,7 @@ import {
   enqueueDeferredPersistedUserMessage,
   enqueueInjectedUserMessage,
   getSessionRunScope,
-} from "@session/SessionRunScope.js";
+} from "@executor/SessionRunScope.js";
 
 /**
  * 单个 shell 命令桥接状态。
@@ -191,11 +191,11 @@ export function clearShellCommandBridge(shellId: string): void {
 }
 
 /**
- * 将 shell runtime plugin 响应整理为通用工具输出。
+ * 将 shell plugin runtime 响应整理为通用工具输出。
  */
 export function flattenShellActionResponse(params: {
   /**
-   * runtime plugin 返回的 shell 响应。
+   * plugin runtime 返回的 shell 响应。
    */
   response: ShellActionResponse;
   /**
@@ -240,7 +240,7 @@ export function flattenShellActionResponse(params: {
  */
 export function flattenShellExecResponse(params: {
   /**
-   * runtime plugin 返回的 shell 响应。
+   * plugin runtime 返回的 shell 响应。
    */
   response: ShellActionResponse;
   /**
@@ -332,7 +332,7 @@ export async function bridgeCommandResponse(params: {
 }
 
 /**
- * 调用 shell service action。
+ * 调用 shell plugin runtime action。
  */
 export async function invokeShellAction<TPayload extends JsonValue = JsonValue>(params: {
   /**

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

@@ -1,8 +1,8 @@
 /**
- * Shell tools（service 化版本）。
+ * Shell tools。
  *
  * 设计目标（中文）
- * - shell 子进程生命周期统一由 `shellService` 承担。
+ * - shell 子进程生命周期统一由 shell plugin runtime 承担。
  * - tool 只负责 Session/tool 协议适配、参数校验与日志语义。
  * - 复杂桥接和 schema 已拆到旁路模块，当前文件只保留公开 tool 定义。
  */