weacpx 0.4.10 → 0.5.1

package/README.md

@@ -182,6 +182,8 @@ weacpx restart
 | `weacpx workspace list` | 查看本机已注册的 workspace |
 | `weacpx workspace add [name] [--raw]` | 把当前目录注册成 workspace；不传 `name` 时使用当前目录名，含特殊字符的名称会被自动规范化 |
 | `weacpx workspace rm <name>` | 删除 workspace |
+| `weacpx later list` / `weacpx lt list` | 在终端查看本机待执行定时任务 |
+| `weacpx later cancel <id>` / `weacpx lt cancel <id>` | 在终端取消本机待执行定时任务 |
 
 首次运行 `weacpx start` 或 `weacpx run` 时，如果没有会话、workspace 和插件，CLI 会询问是否把当前目录创建为 workspace，并选择一个内置 agent 模板；服务启动后会通过正常会话创建流程创建初始 acpx 会话。
 
@@ -323,6 +325,34 @@ opencode, qoder, qwen, trae
 /cancel
 ```
 
+### 定时任务（/later）
+
+让 agent 在未来某个时间自动收到一条消息。**默认在一个为该任务新建的临时会话里执行**（沿用创建时当前会话的 agent 与工作区，对话历史全新，跑完即销毁）；加 `--bind` 则发送到创建时绑定的当前会话。到点后把消息作为普通 prompt 投递，结果推回原聊天。
+
+| 命令 | 说明 |
+|------|------|
+| `/lt <时间> <消息>` | 创建定时任务（默认临时会话执行；`/later` 同义） |
+| `/lt --bind <时间> <消息>` | 改为发送到当前会话 |
+| `/lt list` | 查看全局待执行任务 |
+| `/lt cancel <id>` | 取消待执行任务 |
+
+最常见例子：
+
+```text
+/lt in 2h 检查 CI 是否通过        # 临时会话（默认）
+/lt --bind 明天 09:00 看 PR        # 绑定当前会话
+/lt list
+```
+
+说明：
+
+- 默认临时会话执行，`--bind` 绑定当前会话；默认模式可用配置 `later.defaultMode`（`temp` / `bind`，默认 `temp`）修改
+- 只支持一次性任务，时间必须在 10 秒之后、7 天之内
+- 时间格式是固定白名单（相对时间 / 今天·明天·后天 / 星期几 + 时刻），不支持自然语言
+- 普通对话中 agent 也可以通过当前会话内部工具创建、查看与取消定时任务（`scheduled_create` / `scheduled_list` / `scheduled_cancel`）；路由和权限由 daemon 从当前聊天会话解析，外部 `mcp-stdio` 不暴露这些工具
+- 终端里也可以用 `weacpx later list` / `weacpx later cancel <id>` 管理待执行任务；CLI 只做查看和取消，不创建定时任务
+- 完整时间格式、临时/绑定模式、任务状态与限制见 [docs/later-command.md](./docs/later-command.md)
+
 ### 配置与权限
 
 | 命令 | 说明 |
@@ -383,6 +413,8 @@ README 里只保留用户视角的最常用命令。
 
 `delegate_request` 支持 MCP Tasks：支持该能力的 host 可以让委派请求立即返回原生 task handle，之后通过 `tasks/get` / `tasks/result` / `tasks/cancel` 获取状态、结果或取消任务；worker 输出的 `[PROGRESS] ...` 会显示在 `tasks/get` / `tasks/list` 的 `statusMessage` 里；`input_required` 状态下的 `tasks/result` 会返回下一步操作提示并结束本次 result stream，而不是长时间阻塞；client 按提示调用 `task_get` / `task_approve` / `coordinator_answer_question` 等工具后，再继续 `tasks/get` / `tasks/result` 轮询。不支持 MCP Tasks 的 host 仍可使用兼容工具 `task_get` / `task_list` / `task_watch` / `task_cancel`。
 
+定时任务的自然语言创建工具是 weacpx 当前会话内部能力，不会出现在外部 `weacpx mcp-stdio` 的工具列表里。
+
 先启动 daemon：
 
 ```bash
@@ -514,6 +546,7 @@ bun run dev
 ### 日常使用
 
 - 想查看完整聊天命令参考：[docs/commands.md](./docs/commands.md)
+- 想用定时任务（`/later`）安排一次性的未来消息：[docs/later-command.md](./docs/later-command.md)
 - 想理解什么时候该用 delegate、什么时候该开 group：[docs/weacpx-group-usage-guide.md](./docs/weacpx-group-usage-guide.md)
 
 ### 排错与验证

package/config.example.json

@@ -36,13 +36,9 @@
     }
   },
   "workspaces": {
-    "backend": {
-      "cwd": "/absolute/path/to/backend",
-      "description": "backend repo"
-    },
-    "weacpx-console": {
-      "cwd": "/Users/your-name/Projects/weacpx/.worktrees/weacpx-console-v1",
-      "description": "weacpx console worktree"
+    "home": {
+      "cwd": "~",
+      "description": "用户主目录"
     }
   }
 }

package/dist/bridge/bridge-main.js

@@ -843,7 +843,7 @@ function buildWeacpxMcpServerSpec(input) {
       "mcp-stdio",
       "--coordinator-session",
       input.coordinatorSession,
-      ...input.sourceHandle ? ["--source-handle", input.sourceHandle] : []
+      ...input.sourceHandle ? ["--source-handle", input.sourceHandle] : ["--internal-session-tools"]
     ]
   };
 }

package/dist/channels/types.d.ts

@@ -22,6 +22,28 @@ export interface CoordinatorMessageInput {
     replyContextToken?: string;
     text: string;
 }
+export interface ScheduledSessionDescriptor {
+    alias: string;
+    agent: string;
+    workspace: string;
+    transportSession: string;
+}
+export interface ScheduledChannelMessageInput {
+    chatKey: string;
+    taskId?: string;
+    sessionAlias: string;
+    /**
+     * When present, the scheduled prompt runs in a transient session described
+     * here (temp mode) instead of the persisted logical session named by
+     * `sessionAlias`. `sessionAlias` still records the origin session for display.
+     */
+    sessionDescriptor?: ScheduledSessionDescriptor;
+    accountId?: string;
+    replyContextToken?: string;
+    noticeText: string;
+    promptText: string;
+    abortSignal?: AbortSignal;
+}
 export interface ChannelStartInput {
     agent: ChatAgent;
     abortSignal: AbortSignal;
@@ -60,6 +82,7 @@ export interface MessageChannelRuntime {
     notifyTaskCompletion(task: OrchestrationTaskRecord): Promise<void>;
     notifyTaskProgress(task: OrchestrationTaskRecord, text: string): Promise<void>;
     sendCoordinatorMessage(input: CoordinatorMessageInput): Promise<void>;
+    sendScheduledMessage?(input: ScheduledChannelMessageInput): Promise<void>;
 }
 export type ToolUseStatus = "running" | "success" | "error";
 export type ToolUseKind = "read" | "search" | "execute" | "edit" | "think" | "other";

package/dist/channels/weixin-channel.d.ts

@@ -1,8 +1,9 @@
-import type { MessageChannelRuntime, ChannelStartInput, CoordinatorMessageInput, OrchestrationDeliveryCallbacks, ConsumerLock, ConsumerLockOptions } from "./types.js";
+import type { MessageChannelRuntime, ChannelStartInput, CoordinatorMessageInput, OrchestrationDeliveryCallbacks, ConsumerLock, ConsumerLockOptions, ScheduledChannelMessageInput } from "./types.js";
 import type { RuntimeMediaStore } from "./media-store.js";
 import type { OrchestrationTaskRecord } from "../orchestration/orchestration-types.js";
 export declare class WeixinChannel implements MessageChannelRuntime {
     readonly id = "weixin";
+    private agent;
     private quota;
     private logger;
     private markDelivered;
@@ -19,4 +20,5 @@ export declare class WeixinChannel implements MessageChannelRuntime {
     notifyTaskCompletion(task: OrchestrationTaskRecord): Promise<void>;
     notifyTaskProgress(task: OrchestrationTaskRecord, text: string): Promise<void>;
     sendCoordinatorMessage(input: CoordinatorMessageInput): Promise<void>;
+    sendScheduledMessage(input: ScheduledChannelMessageInput): Promise<void>;
 }