@downcity/agent 1.1.8 → 1.1.10

package/src/service/builtins/chat/types/ChatService.ts

@@ -0,0 +1,165 @@
+/**
+ * ChatService 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里集中声明 chat service action 的输入 payload。
+ * - 这些类型属于跨模块共享契约，因此统一放到 `types/` 下。
+ * - 字段命名保持与 CLI/API 参数一致，降低映射心智负担。
+ */
+
+import type { JsonValue } from "@/utils/types/Json.js";
+import type {
+  ChatDeleteRequest,
+  ChatHistoryRequest,
+  ChatInfoRequest,
+  ChatListRequest,
+  ChatReactRequest,
+} from "@/service/builtins/chat/types/ChatCommand.js";
+import type { ChatChannelName } from "@/service/builtins/chat/types/ChannelStatus.js";
+
+/**
+ * `chat.send` action 的输入载荷。
+ */
+export type ChatSendActionPayload = {
+  /**
+   * 要发送的正文文本。
+   */
+  text: string;
+  /**
+   * 目标 chatKey；未显式传入时可由执行上下文补全。
+   */
+  chatKey?: string;
+  /**
+   * 延迟发送毫秒数；与 `sendAtMs` 互斥。
+   */
+  delayMs?: number;
+  /**
+   * 绝对发送时间戳（毫秒）；与 `delayMs` 互斥。
+   */
+  sendAtMs?: number;
+  /**
+   * 是否使用 reply_to_message 语义回复目标消息。
+   */
+  replyToMessage?: boolean;
+  /**
+   * 显式指定目标消息 ID；通常用于 reply/react 等场景。
+   */
+  messageId?: string;
+};
+
+/**
+ * 读取会话上下文类 action 的输入载荷。
+ */
+export type ChatSessionActionPayload = {
+  /**
+   * 目标 chatKey；与 sessionId 二选一即可。
+   */
+  chatKey?: string;
+  /**
+   * 目标 sessionId；优先级高于 chatKey。
+   */
+  sessionId?: string;
+};
+
+/**
+ * `chat.history` action 的输入载荷。
+ */
+export type ChatHistoryActionPayload = ChatHistoryRequest;
+
+/**
+ * `chat.react` action 的输入载荷。
+ */
+export type ChatReactActionPayload = ChatReactRequest;
+
+/**
+ * `chat.delete` action 的输入载荷。
+ */
+export type ChatDeleteActionPayload = ChatDeleteRequest;
+
+/**
+ * `chat.list` action 的输入载荷。
+ */
+export type ChatListActionPayload = ChatListRequest;
+
+/**
+ * `chat.info` action 的输入载荷。
+ */
+export type ChatInfoActionPayload = ChatInfoRequest;
+
+/**
+ * `chat.status` action 的输入载荷。
+ */
+export type ChatStatusActionPayload = {
+  /**
+   * 指定目标渠道；省略时表示全部渠道。
+   */
+  channel?: ChatChannelName;
+};
+
+/**
+ * `chat.test` action 的输入载荷。
+ */
+export type ChatTestActionPayload = {
+  /**
+   * 指定目标渠道；省略时表示全部渠道。
+   */
+  channel?: ChatChannelName;
+};
+
+/**
+ * `chat.reconnect` action 的输入载荷。
+ */
+export type ChatReconnectActionPayload = {
+  /**
+   * 指定目标渠道；省略时表示全部渠道。
+   */
+  channel?: ChatChannelName;
+};
+
+/**
+ * `chat.open` action 的输入载荷。
+ */
+export type ChatOpenActionPayload = {
+  /**
+   * 指定目标渠道；省略时表示全部渠道。
+   */
+  channel?: ChatChannelName;
+};
+
+/**
+ * `chat.close` action 的输入载荷。
+ */
+export type ChatCloseActionPayload = {
+  /**
+   * 指定目标渠道；省略时表示全部渠道。
+   */
+  channel?: ChatChannelName;
+};
+
+/**
+ * `chat.configuration` action 的输入载荷。
+ */
+export type ChatConfigurationActionPayload = {
+  /**
+   * 指定目标渠道；省略时表示全部渠道。
+   */
+  channel?: ChatChannelName;
+};
+
+/**
+ * `chat.configure` action 的输入载荷。
+ */
+export type ChatConfigureActionPayload = {
+  /**
+   * 要更新的目标渠道。
+   */
+  channel: ChatChannelName;
+  /**
+   * 渠道配置 patch；值类型遵循 channel configuration 元信息。
+   */
+  config: Record<string, JsonValue>;
+  /**
+   * 配置完成后是否立即重启目标渠道；默认由上层解释为 true。
+   */
+  restart?: boolean;
+};

package/src/service/builtins/contact/ContactService.ts

@@ -10,8 +10,8 @@
 import type { Command } from "commander";
 import type { AgentRuntime } from "@/agent/AgentRuntimeTypes.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { JsonObject, JsonValue } from "@/shared/types/Json.js";
-import type { ServiceActions } from "@/shared/types/Service.js";
+import type { JsonObject, JsonValue } from "@/utils/types/Json.js";
+import type { ServiceActions } from "@/service/types/Service.js";
 import { BaseService } from "@/service/builtins/BaseService.js";
 import type {
   ContactApproveCommandPayload,

package/src/service/builtins/contact/PROMPT.ts

@@ -0,0 +1,9 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+
+// Source: src/service/builtins/contact/PROMPT.ts.txt
+const TEXT_MODULE_CONTENT = "Contact service\n\ncontact service 用来管理和其他 agent 的联系方式。一个 contact 代表一个已建立联系的远端 agent，并固定拥有一条长期对话历史。contact 可以是单向的：只要本 agent 能访问对方，就可以 check、chat、share。\n\n可用命令：\n- `city contact link`：生成一次性联系码，交给另一个 agent。\n- `city contact approve <code>`：使用对方给的联系码建立 contact。\n- `city contact list`：查看已保存的 agent 联系方式。\n- `city contact check <contact>` / `city contact check --to <ip:port>`：检查对方是否在线可用。\n- `city contact chat --to <contact> \"<message>\"`：和某个 agent 对话。\n- `city contact share --to <contact> --text ... | --link ... | <path...>`：分享文本、链接、文件或目录。\n- `city contact inbox`：查看收到的分享。\n- `city contact receive <share_id>`：接收某条分享。\n\n边界：\n- chat 用于对话，share 用于资料交接。\n- `city contact link` 返回中的 notes 会说明联系码适合本机、局域网还是公网 agent 使用；本地 localhost 联系码不能交给 server agent approve。\n- public-looking endpoint 仍可能被防火墙/NAT 阻断；以返回的 notes 为准，不要承诺公网一定可达。\n- `city start` 会自动写入 `DOWNCITY_PUBLIC_HOST` 供 contact link 使用；这不是要求用户手动配置的 token 或 endpoint。\n- `city contact approve` 会先建立单向关系，再由对方主动 ping 回本 agent，ping 成功才升级为 bidirectional。\n- local/private agent 连接 public agent 时通常只能 outbound-only，不要说成双向。\n- contact token 由 link/approve 自动交换；不要要求用户手动配置 token 环境变量。\n- `Contact link not found` 表示请求打到的 agent runtime 没有这条 link 记录，优先检查 endpoint/端口/agent 是否一致；过期会明确返回 `Contact link expired`。\n- receive 只接收内容，不自动执行、不安装 skill、不修改项目业务文件。\n- 不自动 approve 或 receive，除非用户明确要求。\n";
+
+export default TEXT_MODULE_CONTENT;

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * ContactPromptAssets：contact service 静态提示词资产。
+ *
+ * 关键点（中文）
+ * - contact prompt 文本真实来源是 `PROMPT.ts.txt`。
+ * - 这里统一做 `trim()`，避免运行时行为漂移。
+ */
+
+import contactPromptText from "@/service/builtins/contact/PROMPT.js";
+
+/**
+ * contact service system prompt。
+ */
+export const CONTACT_SERVICE_PROMPT = contactPromptText.trim();

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

@@ -6,7 +6,7 @@
  * - 已建联后的敏感调用必须携带 contact token。
  */
 
-import type { JsonValue } from "@/shared/types/Json.js";
+import type { JsonValue } from "@/utils/types/Json.js";
 
 type JsonRecord = Record<string, unknown>;
 

package/src/service/builtins/contact/runtime/SystemProvider.ts

@@ -3,20 +3,13 @@
  *
  * 关键点（中文）
  * - session system composer 通过静态 provider 清单读取 service system。
- * - contact prompt 在这里统一读取，避免 service 实例和 system 域产生耦合。
+ * - contact prompt 在这里统一暴露，避免 service 实例和 system 域产生耦合。
  */
-
-import { readFileSync } from "node:fs";
-
-const CONTACT_PROMPT_FILE_URL = new URL("../PROMPT.txt", import.meta.url);
+import { CONTACT_SERVICE_PROMPT } from "@/service/builtins/contact/runtime/ContactPromptAssets.js";
 
 /**
  * 构建 contact service system 文本。
  */
 export function buildContactServiceSystemText(): string {
-  try {
-    return readFileSync(CONTACT_PROMPT_FILE_URL, "utf-8").trim();
-  } catch {
-    return "";
-  }
+  return CONTACT_SERVICE_PROMPT;
 }

package/src/service/builtins/memory/Action.ts

@@ -6,9 +6,9 @@
  * - 所有动作统一返回结构化结果，失败不抛给上层。
  */
 
-import type { ServiceActionResult } from "@/shared/types/Service.js";
+import type { ServiceActionResult } from "@/service/types/Service.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { JsonValue } from "@/shared/types/Json.js";
+import type { JsonValue } from "@/utils/types/Json.js";
 import type {
   MemoryFlushPayload,
   MemoryGetPayload,

package/src/service/builtins/memory/MemoryService.ts

@@ -8,9 +8,9 @@
  */
 
 import type { Command } from "commander";
-import type { JsonObject, JsonValue } from "@/shared/types/Json.js";
+import type { JsonObject, JsonValue } from "@/utils/types/Json.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { ServiceActions } from "@/shared/types/Service.js";
+import type { ServiceActions } from "@/service/types/Service.js";
 import { BaseService } from "@/service/builtins/BaseService.js";
 import {
   flushMemoryAction,

package/src/service/builtins/memory/types/Memory.ts

@@ -6,7 +6,7 @@
  * - 字段注释完整，供 CLI/API/运行时统一复用。
  */
 
-import type { JsonValue } from "@/shared/types/Json.js";
+import type { JsonValue } from "@/utils/types/Json.js";
 
 /**
  * 记忆来源类型。

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

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

package/src/service/builtins/shell/ShellService.ts

@@ -9,7 +9,7 @@
 
 import type { AgentRuntime } from "@/agent/AgentRuntimeTypes.js";
 import { BaseService } from "@/service/builtins/BaseService.js";
-import type { ServiceActions } from "@/shared/types/Service.js";
+import type { ServiceActions } from "@/service/types/Service.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
 import type {
   ShellServiceState,

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

@@ -15,7 +15,7 @@ import type {
   ShellSessionRuntimeState,
   ShellSessionWaiter,
 } from "@/service/builtins/shell/ShellRuntimeTypes.js";
-import { generateId } from "@shared/utils/Id.js";
+import { generateId } from "@/utils/Id.js";
 import type {
   ShellActionResponse,
   ShellCloseRequest,

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

@@ -9,7 +9,7 @@
 import path from "node:path";
 import fs from "fs-extra";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import { stripInvocationAuthEnv } from "@/http/auth/AuthEnv.js";
+import { stripInvocationAuthEnv } from "@/host/http/auth/AuthEnv.js";
 import type {
   ShellServiceState,
   ShellSessionRuntimeState,

package/src/service/builtins/task/Action.ts

@@ -9,7 +9,7 @@
 import path from "node:path";
 import type { ShipTaskStatus } from "./types/Task.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { JsonValue } from "@/shared/types/Json.js";
+import type { JsonValue } from "@/utils/types/Json.js";
 import {
   deriveTaskIdFromTitle,
   normalizeTaskId,

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

@@ -0,0 +1,9 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+
+// Source: src/service/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";
+
+export default TEXT_MODULE_CONTENT;

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

@@ -15,7 +15,7 @@ import {
 import { listTasks, readTask, writeTask } from "./runtime/Store.js";
 import { runTaskNow } from "./runtime/Runner.js";
 import { ServiceCronEngine } from "./types/Cron.js";
-import { resolveRuntimeTimezone } from "@/shared/utils/Time.js";
+import { resolveRuntimeTimezone } from "@/utils/Time.js";
 
 const TASK_LOG_PREFIX = "[TASK]";
 

package/src/service/builtins/task/TaskService.ts

@@ -9,12 +9,12 @@
 
 import type { AgentRuntime } from "@/agent/AgentRuntimeTypes.js";
 import { BaseService } from "@/service/builtins/BaseService.js";
-import type { ServiceActions } from "@/shared/types/Service.js";
+import type { ServiceActions } from "@/service/types/Service.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
 import type {
   TaskCronRegisterResult,
   TaskSchedulerReloadResult,
-} from "@/shared/types/TaskService.js";
+} from "@/service/builtins/task/types/TaskService.js";
 import { TaskCronTriggerEngine } from "@/service/builtins/task/runtime/CronTrigger.js";
 import { registerTaskCronJobs } from "@/service/builtins/task/Scheduler.js";
 import {

package/src/service/builtins/task/runtime/Model.ts

@@ -17,7 +17,7 @@ import type {
   ShipTaskKind,
   ShipTaskStatus,
 } from "@/service/builtins/task/types/Task.js";
-import type { JsonObject, JsonValue } from "@/shared/types/Json.js";
+import type { JsonObject, JsonValue } from "@/utils/types/Json.js";
 
 /**
  * 必填 frontmatter 字段清单。

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

@@ -11,7 +11,7 @@ import type {
   TaskCronRegisterResult,
   TaskListActionPayload,
   TaskSchedulerReloadResult,
-} from "@/shared/types/TaskService.js";
+} from "@/service/builtins/task/types/TaskService.js";
 import type {
   TaskCreateRequest,
   TaskDeleteRequest,
@@ -55,7 +55,7 @@ export type TaskSchedulerReloadPort = (params: {
 /**
  * 启动后的 task cron runtime 统计结果。
  */
-export type { TaskCronRegisterResult } from "@/shared/types/TaskService.js";
+export type { TaskCronRegisterResult } from "@/service/builtins/task/types/TaskService.js";
 
 /**
  * 任务定义变更后重载 scheduler。

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

@@ -7,8 +7,8 @@
  */
 
 import { resolveSessionId } from "@session/ids/resolveSessionId.js";
-import type { JsonObject, JsonValue } from "@/shared/types/Json.js";
-import type { ServiceActionCommandInput } from "@/shared/types/Service.js";
+import type { JsonObject, JsonValue } from "@/utils/types/Json.js";
+import type { ServiceActionCommandInput } from "@/service/types/Service.js";
 import type { ShipTaskKind, ShipTaskStatus } from "@/service/builtins/task/types/Task.js";
 import type {
   TaskCreateRequest,
@@ -17,7 +17,7 @@ import type {
   TaskSetStatusRequest,
   TaskUpdateRequest,
 } from "@/service/builtins/task/types/TaskCommand.js";
-import type { TaskListActionPayload } from "@/shared/types/TaskService.js";
+import type { TaskListActionPayload } from "@/service/builtins/task/types/TaskService.js";
 
 function parseJsonBodyObject(rawBody: JsonValue): JsonObject {
   if (rawBody && typeof rawBody === "object" && !Array.isArray(rawBody)) {

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

@@ -0,0 +1,14 @@
+/**
+ * TaskPromptAssets：task service 静态提示词资产。
+ *
+ * 关键点（中文）
+ * - task prompt 文本真实来源是 `PROMPT.ts.txt`。
+ * - 这里统一做 `trim()`，保持 service system 文本行为稳定。
+ */
+
+import taskServicePromptText from "@/service/builtins/task/PROMPT.js";
+
+/**
+ * task service 固定 system prompt 文本。
+ */
+export const TASK_SERVICE_PROMPT = taskServicePromptText.trim();

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

@@ -8,11 +8,11 @@
 
 import path from "node:path";
 import fs from "fs-extra";
-import { stripInvocationAuthEnv } from "@/http/auth/AuthEnv.js";
+import { stripInvocationAuthEnv } from "@/host/http/auth/AuthEnv.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
 import { runSandboxCommand } from "@/sandbox/SandboxRunner.js";
-import type { SessionRunResult } from "@/types/session/SessionRun.js";
-import type { JsonObject } from "@/shared/types/Json.js";
+import type { SessionRunResult } from "@/session/types/SessionRun.js";
+import type { JsonObject } from "@/utils/types/Json.js";
 import type {
   ChatSendOutputPick,
   ScriptExecutionResult,

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

@@ -10,7 +10,7 @@
 
 import path from "node:path";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { SessionRunResult } from "@/types/session/SessionRun.js";
+import type { SessionRunResult } from "@/session/types/SessionRun.js";
 import type { TaskSessionRuntimePort } from "@/service/builtins/task/runtime/TaskRunnerTypes.js";
 import { LocalSessionCore } from "@session/executors/local/LocalSessionCore.js";
 import { drainDeferredPersistedUserMessages } from "@session/SessionRunScope.js";
@@ -19,7 +19,7 @@ import { JsonlSessionCompactionComposer } from "@session/composer/compaction/jso
 import { LocalSessionExecutionComposer } from "@session/composer/execution/LocalSessionExecutionComposer.js";
 import { DefaultSessionSystemComposer } from "@session/composer/system/default/DefaultSessionSystemComposer.js";
 import { shellTools } from "@session/tools/shell/ShellToolDefinition.js";
-import type { SessionExecutor } from "@/types/session/SessionExecutor.js";
+import type { SessionExecutor } from "@/session/types/SessionExecutor.js";
 
 /**
  * 把 task round 的 user query 落盘到对应 run context。

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

@@ -7,7 +7,7 @@
  */
 
 import type { JsonlSessionHistoryComposer } from "@session/composer/history/jsonl/JsonlSessionHistoryComposer.js";
-import type { SessionExecutor } from "@/types/session/SessionExecutor.js";
+import type { SessionExecutor } from "@/session/types/SessionExecutor.js";
 import type {
   ShipTaskRunExecutionStatusV1,
   ShipTaskRunProgressPhaseV1,

package/src/service/builtins/task/runtime/TaskServiceActions.ts

@@ -7,8 +7,8 @@
  */
 
 import type { Command } from "commander";
-import type { ServiceActions } from "@/shared/types/Service.js";
-import type { TaskListActionPayload } from "@/shared/types/TaskService.js";
+import type { ServiceActions } from "@/service/types/Service.js";
+import type { TaskListActionPayload } from "@/service/builtins/task/types/TaskService.js";
 import type {
   TaskCreateRequest,
   TaskDeleteRequest,

package/src/service/builtins/task/runtime/TaskServiceSystem.ts

@@ -3,28 +3,6 @@
  *
  * 关键点（中文）
  * - task service prompt 属于静态资产。
- * - 在模块初始化时读取，确保运行时行为稳定且可预期。
+ * - 当前直接从 TS 常量导出，避免运行时文件系统依赖。
  */
-
-import { readFileSync } from "node:fs";
-
-const TASK_PROMPT_FILE_URL = new URL("../PROMPT.txt", import.meta.url);
-
-/**
- * 加载 task service 使用说明提示词。
- */
-function loadTaskServicePrompt(): string {
-  try {
-    return readFileSync(TASK_PROMPT_FILE_URL, "utf-8").trim();
-  } catch (error) {
-    const reason = error instanceof Error ? error.message : String(error);
-    throw new Error(
-      `failed to load task service prompt from ${TASK_PROMPT_FILE_URL.pathname}: ${reason}`,
-    );
-  }
-}
-
-/**
- * task service 固定 system prompt 文本。
- */
-export const TASK_SERVICE_PROMPT = loadTaskServicePrompt();
+export { TASK_SERVICE_PROMPT } from "@/service/builtins/task/runtime/TaskPromptAssets.js";

package/src/service/builtins/task/types/TaskService.ts

@@ -0,0 +1,55 @@
+/**
+ * TaskService 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里集中声明 task service 在类化拆分后共享的 action payload 与调度结果类型。
+ * - 跨模块复用的 task service 类型统一收敛在 `service/builtins/task/types/`。
+ */
+
+import type { ShipTaskStatus } from "@/service/builtins/task/types/Task.js";
+
+/**
+ * `task.list` action 的输入载荷。
+ */
+export type TaskListActionPayload = {
+  /**
+   * 按任务状态过滤；省略时返回全部状态。
+   */
+  status?: ShipTaskStatus;
+};
+
+/**
+ * task cron runtime 启动或重载后的统计结果。
+ */
+export type TaskCronRegisterResult = {
+  /**
+   * 本次扫描到的任务定义数量。
+   */
+  tasksFound: number;
+  /**
+   * 本次成功注册到 cron engine 的作业数量。
+   */
+  jobsScheduled: number;
+};
+
+/**
+ * 任务定义变更后 scheduler 重载结果。
+ */
+export type TaskSchedulerReloadResult = {
+  /**
+   * scheduler 是否成功完成重载。
+   */
+  reloaded: boolean;
+  /**
+   * 成功重载时扫描到的任务数量。
+   */
+  tasksFound?: number;
+  /**
+   * 成功重载时注册成功的 cron 作业数量。
+   */
+  jobsScheduled?: number;
+  /**
+   * 重载失败时的错误文本。
+   */
+  error?: string;
+};

package/src/service/core/Manager.ts

@@ -11,7 +11,7 @@ export type {
   ServiceStateControlAction,
   ServiceStateControlResult,
   ServiceStateSnapshot,
-} from "@/shared/types/ServiceState.js";
+} from "@/service/types/ServiceState.js";
 export {
   controlServiceState,
   getServiceRootCommandNames,

package/src/service/core/ServiceActionApi.ts

@@ -8,13 +8,13 @@
  */
 
 import type { Context as HonoContext, Hono } from "hono";
-import type { JsonObject, JsonValue } from "@/shared/types/Json.js";
+import type { JsonObject, JsonValue } from "@/utils/types/Json.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { ServiceCommandScheduleInput } from "@/shared/types/ServiceSchedule.js";
+import type { ServiceCommandScheduleInput } from "@/service/types/ServiceSchedule.js";
 import type { BaseService } from "@/service/builtins/BaseService.js";
 import { parseScheduledRunAtMsOrThrow } from "../schedule/Time.js";
 import { normalizeRunAtMsOrThrow } from "../schedule/Time.js";
-import type { ServiceAction } from "@/shared/types/Service.js";
+import type { ServiceAction } from "@/service/types/Service.js";
 import {
   ensureServiceStateRecord,
   isServiceRunning,