weacpx 0.4.9 → 0.5.0

package/README.md

@@ -323,6 +323,30 @@ opencode, qoder, qwen, trae
 /cancel
 ```
 
+### 定时任务（/later）
+
+让 agent 在未来某个时间自动收到一条消息。任务绑定「创建时的当前会话」，到点后把这条消息作为普通 prompt 发给那个会话。
+
+| 命令 | 说明 |
+|------|------|
+| `/lt <时间> <消息>` | 创建一次性定时任务（`/later` 同义） |
+| `/lt list` | 查看全局待执行任务 |
+| `/lt cancel <id>` | 取消待执行任务 |
+
+最常见例子：
+
+```text
+/lt in 2h 检查 CI 是否通过
+/lt 明天 09:00 看 PR
+/lt list
+```
+
+说明：
+
+- 只支持一次性任务，时间必须在 10 秒之后、7 天之内
+- 时间格式是固定白名单（相对时间 / 今天·明天·后天 / 星期几 + 时刻），不支持自然语言
+- 完整时间格式、任务状态与限制见 [docs/later-command.md](./docs/later-command.md)
+
 ### 配置与权限
 
 | 命令 | 说明 |
@@ -514,6 +538,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/dist/bridge/bridge-main.js

@@ -1042,6 +1042,13 @@ function normalizeBridgePermissionMode(value) {
 function normalizeBridgeNonInteractivePermissions(value) {
   return value === "deny" || value === "fail" ? value : "deny";
 }
+function normalizeBridgeQueueOwnerTtlSeconds(value) {
+  if (value === undefined) {
+    return;
+  }
+  const parsed = Number(value);
+  return Number.isFinite(parsed) && parsed >= 0 ? parsed : undefined;
+}
 
 // src/bridge/bridge-server.ts
 init_prompt_output();
@@ -1125,7 +1132,8 @@ class BridgeRuntime {
   queueOwnerLauncher;
   acpxVerboseSupported = undefined;
   constructor(command = "acpx", run = defaultRunner, runSessionCreate = shellSessionCreateRunner, options = {}, runPromptCommand = defaultPromptRunner, repairSessionIndex = tryRepairAcpxSessionIndex, queueOwnerLauncher = new AcpxQueueOwnerLauncher({
-    acpxCommand: command
+    acpxCommand: command,
+    ...typeof options.queueOwnerTtlSeconds === "number" && Number.isFinite(options.queueOwnerTtlSeconds) ? { ttlMs: options.queueOwnerTtlSeconds * 1000 } : {}
   })) {
     this.command = command;
     this.run = run;
@@ -1381,13 +1389,21 @@ class BridgeRuntime {
       "--json-strict",
       "--cwd",
       input.cwd,
-      ...this.buildPermissionArgs()
+      ...this.buildPermissionArgs(),
+      ...this.buildQueueOwnerTtlArgs()
     ];
     if (input.agentCommand) {
       return [...prefix, "--agent", input.agentCommand, ...tail];
     }
     return [...prefix, input.agent, ...tail];
   }
+  buildQueueOwnerTtlArgs() {
+    const ttl = this.options.queueOwnerTtlSeconds;
+    if (typeof ttl !== "number" || !Number.isFinite(ttl)) {
+      return [];
+    }
+    return ["--ttl", String(ttl)];
+  }
   buildPermissionArgs() {
     const permissionMode = this.options.permissionMode ?? "approve-all";
     const nonInteractivePermissions = this.options.nonInteractivePermissions ?? "deny";
@@ -1924,7 +1940,8 @@ async function processBridgeInput(options) {
 async function runBridgeMain() {
   const server = new BridgeServer(new BridgeRuntime(process.env.WEACPX_BRIDGE_ACPX_COMMAND ?? "acpx", undefined, undefined, {
     permissionMode: normalizeBridgePermissionMode(process.env.WEACPX_BRIDGE_PERMISSION_MODE),
-    nonInteractivePermissions: normalizeBridgeNonInteractivePermissions(process.env.WEACPX_BRIDGE_NON_INTERACTIVE_PERMISSIONS)
+    nonInteractivePermissions: normalizeBridgeNonInteractivePermissions(process.env.WEACPX_BRIDGE_NON_INTERACTIVE_PERMISSIONS),
+    queueOwnerTtlSeconds: normalizeBridgeQueueOwnerTtlSeconds(process.env.WEACPX_BRIDGE_QUEUE_OWNER_TTL_SECONDS)
   }));
   const input = createInterface({
     input: process.stdin,

package/dist/channels/types.d.ts

@@ -22,6 +22,16 @@ export interface CoordinatorMessageInput {
     replyContextToken?: string;
     text: string;
 }
+export interface ScheduledChannelMessageInput {
+    chatKey: string;
+    taskId?: string;
+    sessionAlias: string;
+    accountId?: string;
+    replyContextToken?: string;
+    noticeText: string;
+    promptText: string;
+    abortSignal?: AbortSignal;
+}
 export interface ChannelStartInput {
     agent: ChatAgent;
     abortSignal: AbortSignal;
@@ -60,6 +70,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>;
 }