@downcity/plugins 1.0.145 → 1.0.148

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

@@ -1,53 +1,53 @@
-# Chat Plugin 使用说明
+# Chat Plugin Instructions
 
-## 用户可见回复规则
+## User-Visible Reply Rules
 
-- 当前模式下，直接输出，即会发送消息给到用户对应的channel
+- In the current mode, your direct assistant output is sent as a message to the user's corresponding channel.
 
-## 输出协议
+## Output Protocol
 
-- 需要普通回复时，直接输出文本即可。文本顶部可用 frontmatter metadata (optional)，字段语义与 chat plugin 的 direct send 协议保持一致：
+- For a normal reply, output plain text directly. Optional frontmatter metadata may appear at the very top of the text. Field semantics match the chat plugin direct-send protocol:
 
-- `delay` / `delayMs`：延迟发送毫秒数。
-- `time` / `sendAt` / `sendAtMs`：定时发送时间。
-- `reply`：是否使用 reply 语义发送。
-- `messageId`：目标 `message_id`（群聊推荐）。
-- `react`：发送表情反应。
-  - 单个字符串：`react: "👍"`
-  - 或对象/数组：`emoji/big`
-  - 设置 `messageId` 时，`react` 会优先复用该消息作为目标消息。
-- 附件使用 `<file type="...">path</file>`（支持 `document/photo/voice/audio/video`）。
-- 附件路径必须是项目内可访问的相对路径。多附件可输出多个 `<file>` 标签。
+- `delay` / `delayMs`: delay before sending, in milliseconds.
+- `time` / `sendAt` / `sendAtMs`: scheduled send time.
+- `reply`: whether to send with reply semantics.
+- `messageId`: target `message_id`, recommended for group chats.
+- `react`: send an emoji reaction.
+  - Single string: `react: "thumbs up"`
+  - Or an object/array: `emoji/big`
+  - When `messageId` is set, `react` reuses that message as the target first.
+- Attachments use `<file type="...">path</file>` and support `document/photo/voice/audio/video`.
+- Attachment paths must be relative paths accessible inside the project. For multiple attachments, output multiple `<file>` tags.
 
-### 示例
+### Example
 
 ```text
 ---
 reply: true
 messageId: "128"
 react:
-  - emoji: "✅"
+  - emoji: "done"
 ---
-这是今天的报告。
+Here is today's report.
 <file type="document">reports/daily.md</file>
 ```
 
-### 协议约束
+### Protocol Constraints
 
-- frontmatter 必须位于文本最开头（`---` 包裹）。
-- 除 `<file>` 附件标签外，不要使用尖括号格式做控制参数。
+- Frontmatter must be at the very beginning of the text and wrapped with `---`.
+- Except for `<file>` attachment tags, do not use angle-bracket syntax for control parameters.
 
-## 跨协议/跨平台操作
+## Cross-Protocol Or Cross-Platform Operations
 
-- 当前会话内回复优先直接输出文本，系统会自动发送到当前 channel。
-- 当任务需要跨会话、跨平台或复杂路由，使用 chat plugin action。
-- 如果当前工具集中存在 `plugin_call`，可通过 `plugin_call({ plugin: "chat", action: "send", payload })` 或 `plugin_call({ plugin: "chat", action: "react", payload })` 触发。
-- metadata 只适用于当前会话内的 direct 出站，不要拿 metadata 做跨 chat 路由。
-- 如果不清楚跨 chat 路由参数，应先读取当前 chat context 或调用 chat plugin 的查询类 action，而不是猜测。
+- For replies inside the current conversation, prefer outputting text directly. The system will send it to the current channel automatically.
+- When a task needs cross-conversation, cross-platform, or complex routing, use chat plugin actions.
+- If `plugin_call` is available, call `plugin_call({ plugin: "chat", action: "send", payload })` or `plugin_call({ plugin: "chat", action: "react", payload })`.
+- Metadata applies only to direct outbound messages in the current conversation. Do not use metadata for cross-chat routing.
+- If cross-chat routing parameters are unclear, first read the current chat context or call chat plugin query actions instead of guessing.
 
-## 入站消息结构（仅供内部理解）
+## Inbound Message Structure
 
-- 每条入队用户消息包含 `<info>...</info>` 元信息块 + 用户正文。
-- `<info>` 仅保留 user/request 元信息，例如 `user_id`、`username`、`message_id`、`permissions`、`received_at`。
-- 当前 chat 路由环境（例如 `channel`、`session_id`、`chat_key`、`chat_id`）会通过 system prompt 单独注入，不再混在 `<info>` 里。
-- `<info>` 不要原样回传给用户。
+- Each queued user message contains an `<info>...</info>` metadata block plus the user text.
+- `<info>` keeps only user/request metadata such as `user_id`, `username`, `message_id`, `permissions`, and `received_at`.
+- The current chat routing environment, such as `channel`, `session_id`, `chat_key`, and `chat_id`, is injected separately through the system prompt and is no longer mixed into `<info>`.
+- Do not echo `<info>` back to the user.

package/src/chat/channels/feishu/PROMPT.direct.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/chat/channels/feishu/PROMPT.direct.ts.txt
-const TEXT_MODULE_CONTENT = "# Feishu Channel\n\n## 使用约束\n\n- 你的直接输出自动发送到当前飞书会话。\n";
+const TEXT_MODULE_CONTENT = "# Feishu Channel\n\n## Usage Constraints\n\n- Your direct output is automatically sent to the current Feishu conversation.\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/chat/channels/feishu/PROMPT.direct.ts.txt

@@ -1,5 +1,5 @@
 # Feishu Channel
 
-## 使用约束
+## Usage Constraints
 
-- 你的直接输出自动发送到当前飞书会话。
+- Your direct output is automatically sent to the current Feishu conversation.

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

@@ -4,6 +4,6 @@
  */
 
 // Source: src/chat/channels/qq/PROMPT.direct.ts.txt
-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`）；跨会话发送请使用 chat plugin action，不要在 direct metadata 中写 `chatKey`。\n- 群聊消息默认全量接入，不需要 `@` 触发。\n- 适配器会过滤机器人自回环消息并做入站去重，避免“自己回复自己”的循环。\n";
+const TEXT_MODULE_CONTENT = "# QQ Adapter Instructions (Direct Mode)\n\n## Capability Scope\n\n- Handles message ingress and sending for the official QQ bot gateway over WebSocket.\n- Inbound messages are mapped by the chat plugin runtime to an internal `sessionId`, which is randomly assigned and persisted.\n\n## Usage Constraints\n\n- In direct mode, your assistant text output is automatically sent to the current QQ conversation.\n- QQ outbound replies depend on inbound message context such as `chatType` and `messageId`. For cross-conversation sending, use chat plugin actions instead of writing `chatKey` in direct metadata.\n- Group messages are ingested in full by default and do not require an `@` mention.\n- The adapter filters bot self-loop messages and deduplicates inbound messages to avoid \"replying to itself\" loops.\n";
 
 export default TEXT_MODULE_CONTENT;

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

@@ -1,11 +1,13 @@
-# QQ Adapter 使用说明（direct 模式）
+# QQ Adapter Instructions (Direct Mode)
 
-## 能力范围
-- 负责 QQ 官方机器人网关（WebSocket）消息接入与发送。
-- 入站消息会由 chat plugin runtime 映射到内部 `sessionId`（随机分配并持久化）。
+## Capability Scope
 
-## 使用约束
-- 在 direct 模式下，你输出的 assistant 文本会自动发送到当前 QQ 会话。
-- QQ 出站回复依赖入站消息上下文（如 `chatType` 与 `messageId`）；跨会话发送请使用 chat plugin action，不要在 direct metadata 中写 `chatKey`。
-- 群聊消息默认全量接入，不需要 `@` 触发。
-- 适配器会过滤机器人自回环消息并做入站去重，避免“自己回复自己”的循环。
+- Handles message ingress and sending for the official QQ bot gateway over WebSocket.
+- Inbound messages are mapped by the chat plugin runtime to an internal `sessionId`, which is randomly assigned and persisted.
+
+## Usage Constraints
+
+- In direct mode, your assistant text output is automatically sent to the current QQ conversation.
+- QQ outbound replies depend on inbound message context such as `chatType` and `messageId`. For cross-conversation sending, use chat plugin actions instead of writing `chatKey` in direct metadata.
+- Group messages are ingested in full by default and do not require an `@` mention.
+- The adapter filters bot self-loop messages and deduplicates inbound messages to avoid "replying to itself" loops.

package/src/chat/runtime/ChatAuthorizationRuntime.ts

@@ -165,7 +165,7 @@ export function createChatAuthorizationResolves(): PluginResolves {
 export function createChatAuthorizationActions(): PluginActions {
   return {
     [CHAT_AUTHORIZATION_ACTIONS.snapshot]: createAction({
-      description: "读取 chat 授权快照（catalog/config/users/chats）。",
+      description: "Read chat authorization snapshot (catalog/config/users/chats).",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {} },
@@ -181,7 +181,7 @@ export function createChatAuthorizationActions(): PluginActions {
       },
     }),
     [CHAT_AUTHORIZATION_ACTIONS.readConfig]: createAction({
-      description: "读取当前 chat 授权配置。",
+      description: "Read current chat authorization config.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {} },
@@ -194,7 +194,7 @@ export function createChatAuthorizationActions(): PluginActions {
       },
     }),
     [CHAT_AUTHORIZATION_ACTIONS.writeConfig]: createAction({
-      description: "写入 chat 授权配置（整体覆盖）。",
+      description: "Write chat authorization config as a full replacement.",
       input_schema: {
         zod: z.object({
           config: z.record(z.string(), z.unknown()).optional(),
@@ -202,7 +202,7 @@ export function createChatAuthorizationActions(): PluginActions {
         json_schema: {
           type: "object",
           properties: {
-            config: { type: "object", description: "授权配置" },
+            config: { type: "object", description: "Authorization config." },
           },
         },
       },
@@ -225,7 +225,7 @@ export function createChatAuthorizationActions(): PluginActions {
       },
     }),
     [CHAT_AUTHORIZATION_ACTIONS.setUserRole]: createAction({
-      description: "为某个渠道用户设置角色。",
+      description: "Set the role for a channel user.",
       input_schema: {
         zod: z.object({
           channel: z.enum(["telegram", "feishu", "qq"]),

package/src/chat/runtime/ChatPluginActionRegistry.ts

@@ -104,15 +104,15 @@ export function createChatPluginActions(params: {
 }): PluginActions {
   return {
     status: createAction({
-      description: "查看 chat 渠道连接状态。",
+      description: "View chat channel connection status.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "查看 chat 渠道连接状态",
+        description: "View chat channel connection status.",
         configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+          command.option("--channel <name>", "Specify channel (telegram|feishu|qq).");
         },
         mapInput: mapChatChannelCommandInput,
       },
@@ -125,15 +125,15 @@ export function createChatPluginActions(params: {
       },
     }),
     test: createAction({
-      description: "测试 chat 渠道连通性。",
+      description: "Test chat channel connectivity.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "测试 chat 渠道连通性",
+        description: "Test chat channel connectivity.",
         configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+          command.option("--channel <name>", "Specify channel (telegram|feishu|qq).");
         },
         mapInput: mapChatChannelCommandInput,
       },
@@ -146,15 +146,15 @@ export function createChatPluginActions(params: {
       },
     }),
     reconnect: createAction({
-      description: "重连 chat 渠道（默认全部）。",
+      description: "Reconnect chat channels, all by default.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "重连 chat 渠道（默认全部）",
+        description: "Reconnect chat channels, all by default.",
         configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+          command.option("--channel <name>", "Specify channel (telegram|feishu|qq).");
         },
         mapInput: mapChatChannelCommandInput,
       },
@@ -167,15 +167,15 @@ export function createChatPluginActions(params: {
       },
     }),
     open: createAction({
-      description: "打开（启用）指定 chat 渠道。",
+      description: "Open and enable the specified chat channel.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "打开 chat 渠道（enabled=true，已配置则尝试启动）",
+        description: "Open chat channel (enabled=true, and start it if configured).",
         configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+          command.option("--channel <name>", "Specify channel (telegram|feishu|qq).");
         },
         mapInput: mapChatChannelCommandInput,
       },
@@ -188,15 +188,15 @@ export function createChatPluginActions(params: {
       },
     }),
     close: createAction({
-      description: "关闭（禁用）指定 chat 渠道。",
+      description: "Close and disable the specified chat channel.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "关闭 chat 渠道（enabled=false，并停止运行）",
+        description: "Close chat channel (enabled=false and stop runtime).",
         configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+          command.option("--channel <name>", "Specify channel (telegram|feishu|qq).");
         },
         mapInput: mapChatChannelCommandInput,
       },
@@ -209,15 +209,15 @@ export function createChatPluginActions(params: {
       },
     }),
     configuration: createAction({
-      description: "查看 chat 渠道配置元信息。",
+      description: "View chat channel configuration metadata.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "查看 chat 渠道配置元信息（字段、类型、说明）",
+        description: "View chat channel configuration metadata (fields, types, descriptions).",
         configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+          command.option("--channel <name>", "Specify channel (telegram|feishu|qq).");
         },
         mapInput: mapChatChannelCommandInput,
       },
@@ -229,21 +229,21 @@ export function createChatPluginActions(params: {
       },
     }),
     configure: createAction({
-      description: "更新 chat 渠道运行态参数。",
+      description: "Update runtime parameters for a chat channel.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "更新 chat 渠道运行态参数（可选立即重载）",
+        description: "Update runtime parameters for a chat channel, optionally restarting it immediately.",
         configure(command: Command) {
           command
-            .requiredOption("--channel <name>", "指定渠道（telegram|feishu|qq）")
+            .requiredOption("--channel <name>", "Specify channel (telegram|feishu|qq).")
             .requiredOption(
               "--config-json <json>",
-              "配置 patch JSON（例如 '{\"channelAccountId\":\"qq-main\",\"enabled\":true}'）",
+              "Configuration patch JSON, for example '{\"channelAccountId\":\"qq-main\",\"enabled\":true}'.",
             )
-            .option("--restart", "配置后立即重载渠道", false);
+            .option("--restart", "Restart the channel immediately after configuration.", false);
         },
         mapInput: mapChatConfigureCommandInput,
       },
@@ -256,18 +256,18 @@ export function createChatPluginActions(params: {
       },
     }),
     list: createAction({
-      description: "列出当前 agent 已记录的 chat 会话。",
+      description: "List chat conversations recorded by the current agent.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "列出当前 agent 已记录的 chat 会话（chatTitle/chatKey）",
+        description: "List chat conversations recorded by the current agent (chatTitle/chatKey).",
         configure(command: Command) {
           command
-            .option("--channel <name>", "渠道过滤（telegram|feishu|qq）")
-            .option("--limit <n>", "返回最近 N 条（默认 50）")
-            .option("--q <text>", "关键词过滤（title/chatId/sessionId/actor）");
+            .option("--channel <name>", "Filter by channel (telegram|feishu|qq).")
+            .option("--limit <n>", "Return the latest N records, default 50.")
+            .option("--q <text>", "Keyword filter (title/chatId/sessionId/actor).");
         },
         mapInput: mapChatListCommandInput,
       },
@@ -279,17 +279,17 @@ export function createChatPluginActions(params: {
       },
     }),
     info: createAction({
-      description: "查看指定 chat 会话的路由/路径/上下文快照。",
+      description: "View route, paths, and context snapshot for a specified chat conversation.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "查看指定 chat 会话信息（路由/本地路径/上下文快照）",
+        description: "View specified chat conversation info (route/local paths/context snapshot).",
         configure(command: Command) {
           command
-            .option("--chat-key <chatKey>", "目标 chatKey（不传则尝试读取 DC_CTX_CHAT_KEY）")
-            .option("--session-id <sessionId>", "显式指定 sessionId（优先级更高）");
+            .option("--chat-key <chatKey>", "Target chatKey; reads DC_CTX_CHAT_KEY if omitted.")
+            .option("--session-id <sessionId>", "Explicit sessionId, with higher priority.");
         },
         mapInput: mapChatInfoCommandInput,
       },
@@ -301,23 +301,23 @@ export function createChatPluginActions(params: {
       },
     }),
     send: createAction({
-      description: "向目标 chatKey 发送消息（支持文本/附件/延迟）。",
+      description: "Send a message to the target chatKey, supporting text, attachments, and delay.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "发送消息到目标 chatKey",
+        description: "Send a message to the target chatKey.",
         configure(command: Command) {
           command
-            .option("--text <text>", "消息正文")
-            .option("--stdin", "从标准输入读取消息正文", false)
-            .option("--text-file <file>", "从文件读取消息正文（相对当前目录）")
-            .option("--reply", "显式使用 reply_to_message 回复目标消息", false)
-            .option("--message-id <id>", "显式指定 reply 目标消息 ID")
+            .option("--text <text>", "Message body.")
+            .option("--stdin", "Read message body from stdin.", false)
+            .option("--text-file <file>", "Read message body from a file relative to the current directory.")
+            .option("--reply", "Explicitly reply to the target message with reply_to_message.", false)
+            .option("--message-id <id>", "Explicit reply target message ID.")
             .option(
               "--chat-key <chatKey>",
-              "目标 chatKey（不传则尝试读取 DC_CTX_CHAT_KEY）",
+              "Target chatKey; reads DC_CTX_CHAT_KEY if omitted.",
             );
           attachCommandHelpText(command, CHAT_SEND_HELP_TEXT);
         },
@@ -331,21 +331,21 @@ export function createChatPluginActions(params: {
       },
     }),
     react: createAction({
-      description: "给目标消息贴表情（当前仅 Telegram 支持）。",
+      description: "React to a target message, currently supported only by Telegram.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "给目标消息贴表情（当前仅 Telegram 支持）",
+        description: "React to a target message, currently supported only by Telegram.",
         configure(command: Command) {
           command
-            .option("--emoji <emoji>", "表情字符（默认 👍）")
-            .option("--big", "使用大表情效果（Telegram is_big）", false)
-            .option("--message-id <id>", "目标消息 ID（默认尝试从 chat meta 回填）")
+            .option("--emoji <emoji>", "Emoji character, default thumbs-up.")
+            .option("--big", "Use large reaction effect (Telegram is_big).", false)
+            .option("--message-id <id>", "Target message ID; defaults to chat meta when available.")
             .option(
               "--chat-key <chatKey>",
-              "目标 chatKey（不传则尝试读取 DC_CTX_CHAT_KEY）",
+              "Target chatKey; reads DC_CTX_CHAT_KEY if omitted.",
             );
           attachCommandHelpText(command, CHAT_REACT_HELP_TEXT);
         },
@@ -359,15 +359,15 @@ export function createChatPluginActions(params: {
       },
     }),
     context: createAction({
-      description: "查看当前会话上下文快照。",
+      description: "View current conversation context snapshot.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "查看当前会话上下文快照",
+        description: "View current conversation context snapshot.",
         configure(command: Command) {
-          command.option("--chat-key <chatKey>", "显式覆盖 chatKey");
+          command.option("--chat-key <chatKey>", "Explicitly override chatKey.");
         },
         mapInput(input) {
           const chatKey =
@@ -385,17 +385,17 @@ export function createChatPluginActions(params: {
       },
     }),
     delete: createAction({
-      description: "彻底删除指定 chat 会话（映射+历史+context）。",
+      description: "Permanently delete a specified chat conversation, including mapping, history, and context.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "彻底删除指定 chat 会话（映射+历史+context）",
+        description: "Permanently delete a specified chat conversation, including mapping, history, and context.",
         configure(command: Command) {
           command
-            .option("--chat-key <chatKey>", "显式指定 chatKey")
-            .option("--session-id <sessionId>", "显式指定 sessionId");
+            .option("--chat-key <chatKey>", "Explicit chatKey.")
+            .option("--session-id <sessionId>", "Explicit sessionId.");
         },
         mapInput: mapChatDeleteCommandInput,
       },
@@ -407,24 +407,24 @@ export function createChatPluginActions(params: {
       },
     }),
     history: createAction({
-      description: "读取 chat 历史消息。",
+      description: "Read chat history messages.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "读取 chat 历史消息（默认最近 30 条）",
+        description: "Read chat history messages, defaulting to the latest 30.",
         configure(command: Command) {
           command
-            .option("--chat-key <chatKey>", "显式覆盖 chatKey")
-            .option("--session-id <sessionId>", "显式覆盖 sessionId")
-            .option("--limit <n>", "返回最近 N 条（默认 30）")
+            .option("--chat-key <chatKey>", "Explicitly override chatKey.")
+            .option("--session-id <sessionId>", "Explicitly override sessionId.")
+            .option("--limit <n>", "Return the latest N records, default 30.")
             .option(
               "--direction <direction>",
-              "方向过滤（all|inbound|outbound）",
+              "Direction filter (all|inbound|outbound).",
             )
-            .option("--before-ts <ts>", "仅返回 ts 小于该值的记录（毫秒）")
-            .option("--after-ts <ts>", "仅返回 ts 大于该值的记录（毫秒）");
+            .option("--before-ts <ts>", "Return only records with ts lower than this value, in milliseconds.")
+            .option("--after-ts <ts>", "Return only records with ts greater than this value, in milliseconds.");
         },
         mapInput: mapChatHistoryCommandInput,
       },

package/src/chat/runtime/ChatSessionContextComposer.ts

@@ -10,7 +10,7 @@
 import type { ModelMessage, Tool } from "ai";
 import { drainInjectedUserMessages } from "@downcity/agent/internal/executor/SessionRunScope.js";
 import { LocalSessionContextComposer } from "@downcity/agent/internal/executor/composer/context/LocalSessionContextComposer.js";
-import type { SessionMessageV1 } from "@downcity/agent/internal/executor/types/SessionMessages.js";
+import type { SessionRecordV1 } from "@downcity/agent/internal/executor/types/SessionRecords.js";
 import type { SessionSystemMessage } from "@downcity/agent/internal/executor/types/SessionPrompts.js";
 import type { ChatSessionTurnState } from "@/chat/runtime/ChatSessionTypes.js";
 
@@ -49,7 +49,7 @@ export class ChatSessionContextComposer extends LocalSessionContextComposer {
     input: {
       system: SessionSystemMessage[];
       appendMergedUserMessages: (
-        messages: SessionMessageV1[],
+        messages: SessionRecordV1[],
       ) => Promise<ModelMessage[]>;
     },
   ): (input: { messages?: ModelMessage[] }) => Promise<{

package/src/chat/runtime/ChatSessionTypes.ts

@@ -6,7 +6,7 @@
  * - 普通 Session 仍可复用基础 `run / append*` 能力，不强耦合 chat 语义。
  */
 
-import type { SessionUserMessageV1 } from "@downcity/agent/internal/executor/types/SessionMessages.js";
+import type { SessionUserMessageV1 } from "@downcity/agent/internal/executor/types/SessionRecords.js";
 import type { SessionAssistantStepCallback } from "@downcity/agent/internal/executor/types/SessionRun.js";
 
 /**