shipmyagent 1.0.217 → 1.0.229

package/bin/utils/logger/Logger.js

@@ -11,8 +11,30 @@ import { getLogsDirPath } from "../../main/server/env/Paths.js";
 import { getTimestamp } from "../../main/utils/Time.js";
 const ANSI_RESET = "\x1b[0m";
 const ANSI_BOLD = "\x1b[1m";
-const ANSI_DIM = "\x1b[2m";
 const TASK_BRACKET_COLOR = "\x1b[95m"; // bright magenta
+const ALLOWED_MESSAGE_LABELS = new Set([
+    "main",
+    "system",
+    "user",
+    "assistant",
+    "tool",
+    "tool_result",
+    "agent",
+]);
+const FIXED_BRACKET_COLORS = {
+    INFO: "\x1b[36m", // cyan
+    WARN: "\x1b[33m", // yellow
+    ERROR: "\x1b[31m", // red
+    DEBUG: "\x1b[90m", // gray
+    ACTION: "\x1b[96m", // bright cyan
+    SYSTEM: "\x1b[90m", // gray
+    USER: "\x1b[33m", // yellow
+    ASSISTANT: "\x1b[32m", // green
+    TOOL: "\x1b[95m", // bright magenta
+    TOOL_RESULT: "\x1b[34m", // blue
+    AGENT: "\x1b[36m", // cyan
+    MAIN: "\x1b[90m", // gray
+};
 const BRACKET_COLOR_PALETTE = [
     "\x1b[36m", // cyan
     "\x1b[32m", // green
@@ -41,26 +63,87 @@ function hashText(input) {
 }
 function colorizeBracketedPrefix(label) {
     const normalized = String(label || "").trim().toUpperCase();
+    const baseLabel = normalized.split(/[.\s]+/)[0].replace(/[^A-Z0-9_]/g, "");
     // 关键点（中文）：task 日志标签使用固定高可见色，避免随机色导致辨识度不稳定。
     if (normalized === "TASK") {
         return `${TASK_BRACKET_COLOR}[${label}]${ANSI_RESET}`;
     }
+    const fixedColor = FIXED_BRACKET_COLORS[normalized] || FIXED_BRACKET_COLORS[baseLabel];
+    if (fixedColor) {
+        return `${fixedColor}[${label}]${ANSI_RESET}`;
+    }
     const color = BRACKET_COLOR_PALETTE[hashText(label) % BRACKET_COLOR_PALETTE.length];
     return `${color}[${label}]${ANSI_RESET}`;
 }
-function colorizeLeadingBracketTokens(line) {
-    if (!line)
-        return line;
-    return line.replace(/^\[([^\]]+)\]/, (_match, label) => {
-        return colorizeBracketedPrefix(String(label || "").trim());
+function colorizeMessageBracketPrefixes(message) {
+    // 关键点（中文）：紧凑单行展示时，给消息中的标签 token 着色，正文保持原样。
+    return String(message || "").replace(/\[([^\]\n]+)\]/g, (full, label) => {
+        const normalized = String(label || "").trim();
+        const base = normalized
+            .toUpperCase()
+            .split(/[.\s:]+/)[0]
+            .replace(/[^A-Z0-9_]/g, "");
+        if (!base || !/[A-Z]/.test(base))
+            return full;
+        return colorizeBracketedPrefix(normalized);
     });
 }
-function colorizeMessageBracketPrefixes(message) {
-    // 关键点（中文）：仅给每行“行首 [] 标签”着色，正文不染色，避免可读性下降。
-    return String(message || "")
-        .split("\n")
-        .map((line) => colorizeLeadingBracketTokens(line))
-        .join("\n");
+/**
+ * 压缩日志为“可分段的紧凑展示”。
+ *
+ * 关键点（中文）
+ * - 段内换行转义为字面量 `\n`，避免一条消息占多行。
+ * - 段与段之间保留真实换行，确保不同 message 可清晰区分。
+ */
+function compactMessageForConsole(message) {
+    const normalized = String(message || "").replace(/\r\n/g, "\n");
+    const blocks = normalized
+        .split(/\n{2,}/)
+        .map((block) => String(block || "").replace(/\n/g, "\\n").trim())
+        .filter(Boolean);
+    if (blocks.length === 0)
+        return "";
+    return blocks.join("\n");
+}
+function normalizeToAllowedMessageLabels(message) {
+    const normalizedLines = [];
+    let activeLabel = null;
+    for (const rawLine of String(message || "").split("\n")) {
+        const line = String(rawLine || "");
+        const trimmed = line.trim();
+        if (!trimmed) {
+            normalizedLines.push("");
+            continue;
+        }
+        const matched = trimmed.match(/^\[([^\]]+)\]\s*:?\s*(.*)$/);
+        if (matched) {
+            const rawLabel = String(matched[1] || "").trim();
+            const lowerLabel = rawLabel.toLowerCase();
+            const labelToken = lowerLabel.split(/\s+/)[0] || "";
+            const baseLabel = labelToken.split(".")[0];
+            const content = String(matched[2] || "").trim();
+            if (ALLOWED_MESSAGE_LABELS.has(baseLabel)) {
+                activeLabel = baseLabel;
+                const attrsRaw = rawLabel.slice(labelToken.length).trim();
+                const normalizedLabel = attrsRaw ? `${baseLabel} ${attrsRaw}` : baseLabel;
+                normalizedLines.push(`[${normalizedLabel}]${content ? ` ${content}` : ""}`);
+            }
+            else {
+                activeLabel = "main";
+                normalizedLines.push(`[main] ${content || trimmed}`);
+            }
+            continue;
+        }
+        if (activeLabel) {
+            // 关键点（中文）：同一消息块的续行不重复打标签。
+            normalizedLines.push(line);
+            continue;
+        }
+        normalizedLines.push(`[main] ${trimmed}`);
+    }
+    if (normalizedLines.length === 0)
+        return "[main] -";
+    return normalizedLines.join("\n");
 }
 /**
  * Logger：项目级日志器。
@@ -136,7 +219,7 @@ export class Logger {
             id: this.generateId(),
             timestamp: getTimestamp(),
             type,
-            message,
+            message: normalizeToAllowedMessageLabels(message),
             details: normalizeLogDetails(details),
             level: type,
         };
@@ -152,26 +235,25 @@ export class Logger {
         await this.writeChain;
     }
     printLog(entry) {
-        const timestamp = new Date(entry.timestamp).toLocaleTimeString("zh-CN");
-        const level = entry.type.toUpperCase().padEnd(7);
-        const timestampToken = `${ANSI_DIM}[${timestamp}]${ANSI_RESET}`;
-        const levelToken = `${ANSI_BOLD}${colorizeBracketedPrefix(level)}${ANSI_RESET}`;
-        const body = colorizeMessageBracketPrefixes(entry.message);
-        const message = `${timestampToken} ${levelToken} ${body}`;
+        // 关键点（中文）：控制台输出不展示前置时间戳，减少聊天链路日志噪音。
+        // 时间信息仍保存在 JSONL 落盘字段 `timestamp` 中。
+        const compactBody = compactMessageForConsole(entry.message);
+        const body = colorizeMessageBracketPrefixes(compactBody);
+        const message = body;
         switch (entry.type) {
             case "error":
-                console.error(`\x1b[31m${message}${ANSI_RESET}`);
+                console.error(message);
                 break;
             case "warn":
-                console.warn(`\x1b[33m${message}${ANSI_RESET}`);
+                console.warn(message);
                 break;
             case "debug":
                 if (this.logLevel === "debug") {
-                    console.log(`\x1b[90m${message}${ANSI_RESET}`);
+                    console.log(message);
                 }
                 break;
             case "action":
-                console.log(`\x1b[36m${message}${ANSI_RESET}`);
+                console.log(message);
                 break;
             default:
                 console.log(message);
@@ -186,7 +268,7 @@ export class Logger {
         if (!this.projectRoot)
             return;
         const logsDir = getLogsDirPath(this.projectRoot);
-        const date = new Date().toISOString().split("T")[0];
+        const date = String(entry.timestamp || "").slice(0, 10) || new Date().toISOString().slice(0, 10);
         const logFile = path.join(logsDir, `${date}.jsonl`);
         const logLine = JSON.stringify(entry) + "\n";
         await fs.ensureDir(logsDir);

package/bin/utils/logger/Logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../../src/utils/logger/Logger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../../src/utils/logger/Logger.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shipmyagent",
-  "version": "1.0.217",
+  "version": "1.0.229",
   "type": "module",
   "description": "把一个代码仓库，启动成一个可对话、可审计的 Agent Runtime",
   "bin": {

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

@@ -9,36 +9,48 @@
 - 当前会话会自动投递 assistant 文本（按 step 分条发送），不需要通过 CLI 发送。
 - 保持简洁清晰，避免连续空行（`\n\n`）。
 
-## 参数传递协议（标签格式，可选）
-以下标签都是可选的，按实际需要使用（可组合）：
+## 参数传递协议（frontmatter metadata，可选）
+控制参数统一放在文本顶部 frontmatter；正文继续写自然语言。  
+除附件外，不要再使用尖括号控制标签。
 
-- `<chatKey>目标会话键</chatKey>`：仅在跨对话/跨会话发送时使用；当前会话回复不要写。
-- `<reply>true</reply>`：主文本按 reply 语义发送。
-- `<delay>3000</delay>`：主文本延迟发送毫秒数（非负整数）。
-- `<time>2026-03-05T20:00:00+08:00</time>`：主文本定时发送（支持 Unix 时间戳秒/毫秒 或 ISO 时间）。
-- `<file type="document">相对路径</file>`：发送附件（支持 `document/photo/voice/audio`）。
-- `<react>👍</react>`：发送表情反应（可加属性：`chatKey`、`messageId`、`big`）。
+可用 metadata 字段（可选）：
+- `chatKey`：覆盖主文本目标会话（跨会话发送）。
+- `reply`：目标 `message_id`（推荐）。设置后按该消息 ID reply。
+- `message_id` / `messageId`：目标 `message_id`（与 `reply` 等价，二选一）。
+- `react` / `reactions`：发送表情反应。
+  - 单个字符串：`react: "👍"`
+  - 或对象/数组：`emoji/chatKey/messageId/big`
+  - 若未提供 `messageId`，会默认复用 `reply/message_id`（同一 chatKey）。
+- 附件仍使用 `<file type="...">path</file>`（支持 `document/photo/voice/audio`）。
 
-示例（跨对话 + 定时 + reply + 附件 + react）：
+示例（跨对话 + reply + 附件 + react）：
 ```text
-<chatKey>telegram-chat-123</chatKey>
-<time>2026-03-05T20:00:00+08:00</time>
-<reply>true</reply>
+---
+chatKey: telegram-chat-123
+reply: "128"
+react:
+  - emoji: "✅"
+    messageId: "128"
+---
 这是给用户的正文。
 <file type="document">reports/daily.md</file>
-<react messageId="128">✅</react>
 ```
 
-示例（普通当前会话回复，无需任何标签）：
+示例（普通当前会话回复，无 metadata）：
 ```text
 已完成修复，核心原因是缓存键冲突，现已改为按会话隔离。
 ```
 
 协议约束：
-- 标签是“控制参数”，正文仍直接写自然语言。
-- 只有需要控制参数时才加标签；普通回复只写正文。
-- `<delay>` 与 `<time>` 不要同时输出（若同时输出，系统会优先按 `<time>` 处理）。
+- 只有需要控制参数时才写 frontmatter；普通回复只写正文。
+- frontmatter 必须位于文本最开头（`---` 包裹）。
+- `reply` 的值必须是目标 `message_id`（字符串或数字），不要写 `reply: true/false`。
+- 除 `<file>` 附件标签外，不要使用尖括号格式做控制参数。
 - 不要输出 JSON 或 CLI 命令作为用户可见内容。
+- direct metadata 不支持 `delay/time/sendAt`。
+- 需要延迟或定时发送时，使用 shell 执行 `sma chat send`：
+  - `sma chat send --text '...' --delay <ms>`
+  - `sma chat send --text '...' --time '<ISO|timestamp>'`
 
 ## 跨协议/跨平台操作
 - 当任务需要跨会话、跨平台或复杂路由，允许使用 `sma chat`。

package/src/services/chat/PROMPT.txt

@@ -67,7 +67,7 @@ User-facing output rules:
 - 不要滥用 `--reply`：仅在消息密集、需要把回复明确挂到某条消息时再使用。
 - 默认使用单引号包裹 `--text`，例如：`sma chat send --text '你好'`。
 - `send` 支持 `--delay <ms>`（非负整数，毫秒）用于延迟发送。
-- `send` 支持 `--time <time>`（Unix 时间戳秒/毫秒或 ISO 时间）用于定时发送。
+- `send` 支持 `--time <time>`（Unix 时间戳秒/毫秒或 ISO 时间；ISO 必须显式时区）用于定时发送。
 - `--delay` 与 `--time` 互斥，不能同时传。
 - 多行正文使用 heredoc 管道到 stdin，例如：
   `cat <<'EOF' | sma chat send --stdin --chat-key <chatKey>`

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

@@ -7,6 +7,6 @@
 ## 使用约束
 - 在 direct 模式下，你输出的 assistant 文本会自动发送到当前飞书会话。
 - 群聊可配置管理员白名单（`adminUserIds`）；若群内无法触发，优先检查发起人/管理员权限策略。
-- 如需跨会话发送，请输出 `<chatKey>...</chatKey>` 覆盖目标会话。
+- 如需跨会话发送，请在 frontmatter metadata 中设置 `chatKey` 覆盖目标会话。
 - 自动发送时由适配器按 chat 类型选择回复模式（群聊优先 reply、私聊直发）。
 - 平台事件可能重复投递，适配器会做去重；业务层无需重复实现去重逻辑。

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

@@ -6,6 +6,6 @@
 
 ## 使用约束
 - 在 direct 模式下，你输出的 assistant 文本会自动发送到当前 QQ 会话。
-- QQ 出站回复依赖入站消息上下文（如 `chatType` 与 `messageId`）；跨 context 发送时，`<chatKey>` 必须可解析到 QQ 元信息。
+- QQ 出站回复依赖入站消息上下文（如 `chatType` 与 `messageId`）；跨 context 发送时，frontmatter metadata 的 `chatKey` 必须可解析到 QQ 元信息。
 - 群聊权限支持 `anyone` 与 `initiator_or_admin` 两种门禁策略；群内无响应时优先检查该配置。
 - 适配器会过滤机器人自回环消息并做入站去重，避免“自己回复自己”的循环。

package/src/services/chat/channels/telegram/PROMPT.direct.txt

@@ -7,8 +7,8 @@
 ## 使用约束
 - 在 direct 模式下，你输出的 assistant 文本会自动发送到当前 Telegram 会话。
 - Telegram 会在入站 `<info>` 中注入 `is_master` 字段（yes/no/unknown）；涉及执行权限时应优先遵循 master 指令。
-- 自动发送默认是普通消息；仅当你输出 `<reply>true</reply>` 时，才会尝试按 `messageId` 走 `reply_to_message`。
-- `<reply>` 仅用于必要场景（例如群里消息很多，需要精确指向某条消息）；常规回复不要开启。
+- 自动发送默认是普通消息；仅当 frontmatter metadata 中提供目标 `message_id`（`reply` 或 `message_id/messageId`，值为消息 ID）时，才会按该消息 reply。
+- 仅在必要场景设置 `reply/message_id`（例如群里消息很多，需要精确指向某条消息）；常规回复不要开启。
 - 群聊场景存在权限与 follow-up 窗口策略；如果用户反馈“机器人没响应”，优先检查是否触发群聊权限限制。
 - 旧消息会在启动时执行 pending drain 入队审计，避免重启后补回复历史消息。
 

package/src/services/task/PROMPT.txt

@@ -53,10 +53,10 @@
 
 - 常用 action（CLI）：
   - `sma task list [--status enabled|paused|disabled]`
-  - `sma task create --title '...' --description '...' --context-id <contextId> [--cron '@manual'] [--kind agent|script]`
+  - `sma task create --title '...' --description '...' --context-id <contextId> [--cron '@manual'] [--kind agent|script] [--status ...|--activate]`
   - `sma task run <taskId> [--reason '...']`
   - `sma task delete <taskId>`
-  - `sma task update <taskId> [--title ...] [--description ...] [--cron ...] [--status ...] [--context-id ...]`
+  - `sma task update <taskId> [--title ...] [--description ...] [--cron ...] [--status ...|--activate] [--context-id ...]`
   - `sma task status <taskId> <enabled|paused|disabled>`
   - `sma task enable <taskId>`
   - `sma task disable <taskId>`
@@ -66,6 +66,10 @@
 - 调度重载命令（task lifecycle command）：
   - `sma service command task reschedule`
 
+关键行为（中文）：
+- `create/update/delete/status/enable/disable` 成功后，task scheduler 会自动重载一次（等价于内部执行 `reschedule`）。
+- 仍可手动执行 `sma service command task reschedule` 做显式重载。
+
 ## 状态语义
 
 - `enabled`：可被 cron 调度执行
@@ -85,7 +89,7 @@
 - `contextId`：结果回发目标（必填）
 - `status`：`enabled|paused|disabled`（必填）
 - `kind`：`agent|script`（可选，默认 `agent`）
-- `time`：单次计划时间（可选，ISO8601；到点执行一次）
+- `time`：单次计划时间（可选，ISO8601 且必须显式时区，如 `2026-03-05T20:00:00+08:00`；到点执行一次）
 
 ### 可选字段
 - `timezone`：IANA 时区（如 `Asia/Shanghai`）
@@ -95,7 +99,8 @@
 
 ### 冲突与校验
 - 更新时所有 `set` 与 `clear` 选项必须互斥。
-- `time` 适合“单次计划”；触发后系统会自动将任务置为 `paused` 并清空 `time`。
+- `time` 适合“单次计划”；请与 `cron=@manual` 搭配使用。
+- `time` 触发后系统会自动将任务置为 `paused` 并清空 `time`。
 - `kind=script` 时，正文不能为空且应为脚本；不要配置成空 body。
 - `requiredArtifacts` 应是 run 目录内相对路径。
 

package/test/chat/direct-delay-nonblocking.test.mjs

@@ -0,0 +1,112 @@
+/**
+ * direct delay 非阻塞调度测试（node:test）。
+ *
+ * 关键点（中文）
+ * - `nonBlockingDelay=true` 时应立即返回，实际发送由后台延迟调度。
+ * - 默认行为仍应阻塞等待，避免破坏 `chat send` 既有语义。
+ */
+
+import assert from "node:assert/strict";
+import test from "node:test";
+import { sendChatTextByChatKey } from "../../bin/services/chat/Action.js";
+import {
+  getChatSender,
+  registerChatSender,
+  unregisterChatSender,
+} from "../../bin/services/chat/runtime/ChatSendRegistry.js";
+
+const TELEGRAM_CHANNEL = "telegram";
+const CHAT_KEY = "telegram-chat-10001";
+
+function buildRuntime() {
+  return {
+    rootPath: "",
+    logger: {
+      warn() {},
+    },
+  };
+}
+
+test("sendChatTextByChatKey schedules delayed send without blocking when nonBlockingDelay=true", async () => {
+  const previous = getChatSender(TELEGRAM_CHANNEL);
+  const calls = [];
+  registerChatSender(TELEGRAM_CHANNEL, {
+    async sendText(payload) {
+      calls.push({
+        ts: Date.now(),
+        payload,
+      });
+      return { success: true };
+    },
+  });
+
+  try {
+    const start = Date.now();
+    const result = await sendChatTextByChatKey({
+      context: buildRuntime(),
+      chatKey: CHAT_KEY,
+      text: "delayed-message",
+      delayMs: 120,
+      nonBlockingDelay: true,
+    });
+    const elapsedMs = Date.now() - start;
+
+    assert.equal(result.success, true);
+    assert.equal(result.chatKey, CHAT_KEY);
+    assert.equal(calls.length, 0);
+    assert.ok(
+      elapsedMs < 80,
+      `expected non-blocking return (<80ms), got ${elapsedMs}ms`,
+    );
+
+    await new Promise((resolve) => setTimeout(resolve, 180));
+    assert.equal(calls.length, 1);
+    assert.equal(calls[0].payload.chatId, "10001");
+    assert.equal(calls[0].payload.text, "delayed-message");
+  } finally {
+    if (previous) {
+      registerChatSender(TELEGRAM_CHANNEL, previous);
+    } else {
+      unregisterChatSender(TELEGRAM_CHANNEL);
+    }
+  }
+});
+
+test("sendChatTextByChatKey keeps blocking behavior by default", async () => {
+  const previous = getChatSender(TELEGRAM_CHANNEL);
+  const calls = [];
+  registerChatSender(TELEGRAM_CHANNEL, {
+    async sendText(payload) {
+      calls.push({
+        ts: Date.now(),
+        payload,
+      });
+      return { success: true };
+    },
+  });
+
+  try {
+    const start = Date.now();
+    const result = await sendChatTextByChatKey({
+      context: buildRuntime(),
+      chatKey: CHAT_KEY,
+      text: "blocking-message",
+      delayMs: 120,
+    });
+    const elapsedMs = Date.now() - start;
+
+    assert.equal(result.success, true);
+    assert.equal(result.chatKey, CHAT_KEY);
+    assert.equal(calls.length, 1);
+    assert.ok(
+      elapsedMs >= 90,
+      `expected blocking return (>=90ms), got ${elapsedMs}ms`,
+    );
+  } finally {
+    if (previous) {
+      registerChatSender(TELEGRAM_CHANNEL, previous);
+    } else {
+      unregisterChatSender(TELEGRAM_CHANNEL);
+    }
+  }
+});

package/test/chat/direct-dispatch-parser.test.mjs

@@ -0,0 +1,43 @@
+/**
+ * direct dispatch parser 行为测试（node:test）。
+ *
+ * 关键点（中文）
+ * - direct frontmatter 仅支持 `chatKey/reply/message_id/react` 等字段。
+ * - `delay/time/sendAt/sendAtMs` 在 direct 模式下应被忽略，不能进入发送参数。
+ */
+
+import assert from "node:assert/strict";
+import test from "node:test";
+import { parseDirectDispatchAssistantText } from "../../bin/services/chat/runtime/DirectDispatchParser.js";
+
+test("parseDirectDispatchAssistantText ignores delay/time metadata in direct mode", () => {
+  const plan = parseDirectDispatchAssistantText({
+    fallbackChatKey: "telegram-chat-999",
+    assistantText: `---
+chatKey: telegram-chat-123
+reply: "556"
+delay: 3000
+time: 2026-03-08T20:00:00+08:00
+sendAt: 2026-03-08T21:00:00+08:00
+sendAtMs: 1767225600000
+react: "👍"
+---
+hello direct`,
+  });
+
+  assert.ok(plan, "expected non-null direct dispatch plan");
+  assert.ok(plan.text, "expected text plan");
+  assert.equal(plan.text.chatKey, "telegram-chat-123");
+  assert.equal(plan.text.replyToMessage, true);
+  assert.equal(plan.text.messageId, "556");
+  assert.equal(plan.text.text, "hello direct");
+
+  // 关键点（中文）：delay/time 字段必须被忽略，避免 direct 自动调度。
+  assert.equal(Object.hasOwn(plan.text, "delayMs"), false);
+  assert.equal(Object.hasOwn(plan.text, "sendAtMs"), false);
+
+  assert.equal(plan.reactions.length, 1);
+  assert.equal(plan.reactions[0].emoji, "👍");
+  assert.equal(plan.reactions[0].chatKey, "telegram-chat-123");
+  assert.equal(plan.reactions[0].messageId, "556");
+});

package/test/chat/send-time-timezone-parse.test.mjs

@@ -0,0 +1,47 @@
+/**
+ * Chat send 时间参数解析测试（node:test）。
+ *
+ * 关键点（中文）
+ * - `sendAt/sendAtMs/time` 若传 ISO 日期时间，必须带显式时区（`Z` 或 `+08:00`）。
+ * - 秒级时间戳会自动归一化为毫秒。
+ */
+
+import assert from "node:assert/strict";
+import test from "node:test";
+import { chatService } from "../../bin/services/chat/Index.js";
+
+async function mapSendApiInput(payload) {
+  return chatService.actions.send.api.mapInput({
+    req: {
+      async json() {
+        return payload;
+      },
+    },
+  });
+}
+
+test("chat send api rejects ISO datetime without timezone", async () => {
+  await assert.rejects(
+    mapSendApiInput({
+      text: "hello",
+      sendAt: "2026-03-08T10:30:00",
+    }),
+    /ISO datetime must include timezone offset/i,
+  );
+});
+
+test("chat send api accepts timezone-aware ISO datetime", async () => {
+  const result = await mapSendApiInput({
+    text: "hello",
+    sendAt: "2026-03-08T10:30:00+08:00",
+  });
+  assert.equal(result.sendAtMs, Date.parse("2026-03-08T10:30:00+08:00"));
+});
+
+test("chat send api normalizes second timestamp to milliseconds", async () => {
+  const result = await mapSendApiInput({
+    text: "hello",
+    time: "1767225600",
+  });
+  assert.equal(result.sendAtMs, 1767225600 * 1000);
+});