@poolzin/pool-bot 2026.2.0 → 2026.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (230) hide show
  1. package/dist/agents/bash-tools.exec.js +76 -25
  2. package/dist/agents/cli-runner/helpers.js +9 -11
  3. package/dist/agents/identity.js +47 -7
  4. package/dist/agents/memory-search.js +25 -8
  5. package/dist/agents/model-selection.js +21 -0
  6. package/dist/agents/pi-embedded-block-chunker.js +117 -42
  7. package/dist/agents/pi-embedded-helpers/errors.js +183 -78
  8. package/dist/agents/pi-embedded-helpers.js +1 -1
  9. package/dist/agents/pi-embedded-runner/compact.js +1 -0
  10. package/dist/agents/pi-embedded-runner/model.js +61 -2
  11. package/dist/agents/pi-embedded-runner/run/attempt.js +21 -11
  12. package/dist/agents/pi-embedded-runner/run.js +199 -46
  13. package/dist/agents/pi-embedded-runner/system-prompt.js +10 -2
  14. package/dist/agents/pi-embedded-subscribe.js +118 -29
  15. package/dist/agents/pi-tools.js +10 -5
  16. package/dist/agents/poolbot-tools.js +15 -10
  17. package/dist/agents/sandbox-paths.js +31 -0
  18. package/dist/agents/session-tool-result-guard.js +94 -15
  19. package/dist/agents/shell-utils.js +51 -0
  20. package/dist/agents/skills/bundled-context.js +23 -0
  21. package/dist/agents/skills/bundled-dir.js +41 -7
  22. package/dist/agents/skills-install.js +60 -23
  23. package/dist/agents/subagent-announce.js +79 -34
  24. package/dist/agents/tool-policy.conformance.js +14 -0
  25. package/dist/agents/tool-policy.js +24 -0
  26. package/dist/agents/tools/cron-tool.js +166 -19
  27. package/dist/agents/tools/discord-actions-presence.js +78 -0
  28. package/dist/agents/tools/message-tool.js +56 -2
  29. package/dist/agents/tools/sessions-history-tool.js +69 -1
  30. package/dist/agents/tools/web-search.js +211 -42
  31. package/dist/agents/usage.js +23 -1
  32. package/dist/agents/workspace-run.js +67 -0
  33. package/dist/agents/workspace-templates.js +44 -0
  34. package/dist/auto-reply/command-auth.js +121 -6
  35. package/dist/auto-reply/envelope.js +50 -72
  36. package/dist/auto-reply/reply/commands-compact.js +1 -0
  37. package/dist/auto-reply/reply/commands-context-report.js +1 -0
  38. package/dist/auto-reply/reply/commands-context.js +1 -0
  39. package/dist/auto-reply/reply/commands-models.js +107 -60
  40. package/dist/auto-reply/reply/commands-ptt.js +171 -0
  41. package/dist/auto-reply/reply/get-reply-run.js +2 -1
  42. package/dist/auto-reply/reply/inbound-context.js +5 -1
  43. package/dist/auto-reply/reply/model-selection.js +3 -3
  44. package/dist/auto-reply/thinking.js +88 -43
  45. package/dist/browser/bridge-server.js +13 -0
  46. package/dist/browser/cdp.helpers.js +38 -24
  47. package/dist/browser/client-fetch.js +50 -7
  48. package/dist/browser/config.js +1 -10
  49. package/dist/browser/extension-relay.js +101 -40
  50. package/dist/browser/pw-ai.js +1 -1
  51. package/dist/browser/pw-session.js +143 -8
  52. package/dist/browser/pw-tools-core.interactions.js +125 -27
  53. package/dist/browser/pw-tools-core.responses.js +1 -1
  54. package/dist/browser/pw-tools-core.state.js +1 -1
  55. package/dist/browser/routes/agent.act.js +86 -41
  56. package/dist/browser/routes/dispatcher.js +4 -4
  57. package/dist/browser/screenshot.js +1 -1
  58. package/dist/browser/server.js +13 -0
  59. package/dist/build-info.json +3 -3
  60. package/dist/channels/reply-prefix.js +8 -1
  61. package/dist/cli/cron-cli/register.cron-add.js +61 -40
  62. package/dist/cli/cron-cli/register.cron-edit.js +60 -34
  63. package/dist/cli/cron-cli/shared.js +56 -41
  64. package/dist/cli/dns-cli.js +26 -14
  65. package/dist/cli/gateway-cli/register.js +37 -19
  66. package/dist/cli/memory-cli.js +5 -5
  67. package/dist/cli/parse-bytes.js +37 -0
  68. package/dist/cli/update-cli.js +173 -52
  69. package/dist/commands/agent.js +1 -0
  70. package/dist/commands/doctor-config-flow.js +61 -5
  71. package/dist/commands/doctor-state-migrations.js +1 -1
  72. package/dist/commands/health.js +1 -1
  73. package/dist/commands/model-allowlist.js +29 -0
  74. package/dist/commands/model-picker.js +2 -1
  75. package/dist/commands/models/list.status-command.js +43 -23
  76. package/dist/commands/models/shared.js +15 -0
  77. package/dist/commands/onboard-custom.js +384 -0
  78. package/dist/commands/onboard-non-interactive/local/auth-choice-inference.js +35 -0
  79. package/dist/commands/onboard-non-interactive/local/auth-choice.js +6 -3
  80. package/dist/commands/onboard-skills.js +63 -38
  81. package/dist/commands/openai-model-default.js +41 -0
  82. package/dist/config/defaults.js +3 -2
  83. package/dist/config/paths.js +136 -35
  84. package/dist/config/plugin-auto-enable.js +21 -5
  85. package/dist/config/redact-snapshot.js +153 -0
  86. package/dist/config/schema.field-metadata.js +590 -0
  87. package/dist/config/schema.js +2 -2
  88. package/dist/config/sessions/store.js +291 -23
  89. package/dist/config/zod-schema.agent-defaults.js +3 -0
  90. package/dist/config/zod-schema.agent-runtime.js +13 -2
  91. package/dist/config/zod-schema.providers-core.js +142 -0
  92. package/dist/config/zod-schema.session.js +3 -0
  93. package/dist/cron/delivery.js +57 -0
  94. package/dist/cron/isolated-agent/delivery-target.js +18 -3
  95. package/dist/cron/isolated-agent/helpers.js +22 -5
  96. package/dist/cron/isolated-agent/run.js +171 -63
  97. package/dist/cron/isolated-agent/session.js +2 -0
  98. package/dist/cron/normalize.js +356 -28
  99. package/dist/cron/parse.js +10 -5
  100. package/dist/cron/run-log.js +35 -10
  101. package/dist/cron/schedule.js +41 -6
  102. package/dist/cron/service/jobs.js +208 -35
  103. package/dist/cron/service/ops.js +72 -16
  104. package/dist/cron/service/state.js +2 -0
  105. package/dist/cron/service/store.js +386 -14
  106. package/dist/cron/service/timer.js +390 -147
  107. package/dist/cron/session-reaper.js +86 -0
  108. package/dist/cron/store.js +23 -8
  109. package/dist/cron/validate-timestamp.js +43 -0
  110. package/dist/discord/monitor/agent-components.js +438 -0
  111. package/dist/discord/monitor/allow-list.js +28 -5
  112. package/dist/discord/monitor/gateway-registry.js +29 -0
  113. package/dist/discord/monitor/native-command.js +44 -23
  114. package/dist/discord/monitor/sender-identity.js +45 -0
  115. package/dist/discord/pluralkit.js +27 -0
  116. package/dist/discord/send.outbound.js +92 -5
  117. package/dist/discord/send.shared.js +60 -23
  118. package/dist/discord/targets.js +84 -1
  119. package/dist/entry.js +15 -9
  120. package/dist/extensionAPI.js +8 -0
  121. package/dist/gateway/control-ui.js +8 -1
  122. package/dist/gateway/hooks-mapping.js +3 -0
  123. package/dist/gateway/hooks.js +65 -0
  124. package/dist/gateway/net.js +96 -31
  125. package/dist/gateway/node-command-policy.js +50 -15
  126. package/dist/gateway/origin-check.js +56 -0
  127. package/dist/gateway/protocol/client-info.js +9 -0
  128. package/dist/gateway/protocol/index.js +9 -2
  129. package/dist/gateway/protocol/schema/agents-models-skills.js +71 -1
  130. package/dist/gateway/protocol/schema/cron.js +22 -10
  131. package/dist/gateway/protocol/schema/protocol-schemas.js +16 -2
  132. package/dist/gateway/protocol/schema/sessions.js +12 -0
  133. package/dist/gateway/server/hooks.js +1 -1
  134. package/dist/gateway/server-broadcast.js +26 -9
  135. package/dist/gateway/server-chat.js +112 -23
  136. package/dist/gateway/server-discovery-runtime.js +10 -2
  137. package/dist/gateway/server-http.js +109 -11
  138. package/dist/gateway/server-methods/agent-timestamp.js +60 -0
  139. package/dist/gateway/server-methods/agents.js +321 -2
  140. package/dist/gateway/server-methods/usage.js +559 -16
  141. package/dist/gateway/server-runtime-state.js +22 -8
  142. package/dist/gateway/server-startup-memory.js +16 -0
  143. package/dist/gateway/server.impl.js +5 -1
  144. package/dist/gateway/session-utils.fs.js +23 -25
  145. package/dist/gateway/session-utils.js +20 -10
  146. package/dist/gateway/sessions-patch.js +7 -22
  147. package/dist/gateway/test-helpers.server.js +35 -2
  148. package/dist/imessage/constants.js +2 -0
  149. package/dist/imessage/monitor/deliver.js +4 -1
  150. package/dist/imessage/monitor/monitor-provider.js +51 -1
  151. package/dist/infra/bonjour-discovery.js +131 -70
  152. package/dist/infra/control-ui-assets.js +134 -12
  153. package/dist/infra/errors.js +12 -0
  154. package/dist/infra/exec-approvals.js +266 -57
  155. package/dist/infra/format-time/format-datetime.js +79 -0
  156. package/dist/infra/format-time/format-duration.js +81 -0
  157. package/dist/infra/format-time/format-relative.js +80 -0
  158. package/dist/infra/heartbeat-runner.js +140 -49
  159. package/dist/infra/home-dir.js +54 -0
  160. package/dist/infra/net/fetch-guard.js +122 -0
  161. package/dist/infra/net/ssrf.js +65 -29
  162. package/dist/infra/outbound/abort.js +14 -0
  163. package/dist/infra/outbound/message-action-runner.js +77 -13
  164. package/dist/infra/outbound/outbound-session.js +143 -37
  165. package/dist/infra/poolbot-root.js +43 -1
  166. package/dist/infra/session-cost-usage.js +631 -41
  167. package/dist/infra/state-migrations.js +317 -47
  168. package/dist/infra/update-global.js +35 -0
  169. package/dist/infra/update-runner.js +149 -43
  170. package/dist/infra/warning-filter.js +65 -0
  171. package/dist/infra/widearea-dns.js +30 -9
  172. package/dist/logging/redact-identifier.js +12 -0
  173. package/dist/media/fetch.js +81 -58
  174. package/dist/media-understanding/apply.js +403 -3
  175. package/dist/media-understanding/attachments.js +38 -27
  176. package/dist/media-understanding/defaults.js +16 -0
  177. package/dist/media-understanding/providers/deepgram/audio.js +22 -14
  178. package/dist/media-understanding/providers/google/audio.js +24 -17
  179. package/dist/media-understanding/providers/google/video.js +24 -17
  180. package/dist/media-understanding/providers/image.js +2 -2
  181. package/dist/media-understanding/providers/index.js +4 -1
  182. package/dist/media-understanding/providers/openai/audio.js +22 -14
  183. package/dist/media-understanding/providers/shared.js +16 -11
  184. package/dist/media-understanding/providers/zai/index.js +6 -0
  185. package/dist/media-understanding/runner.js +158 -90
  186. package/dist/memory/batch-voyage.js +277 -0
  187. package/dist/memory/embeddings-voyage.js +75 -0
  188. package/dist/memory/embeddings.js +28 -16
  189. package/dist/memory/internal.js +101 -18
  190. package/dist/memory/manager.js +154 -48
  191. package/dist/memory/search-manager.js +173 -0
  192. package/dist/memory/session-files.js +9 -3
  193. package/dist/node-host/runner.js +34 -24
  194. package/dist/node-host/with-timeout.js +27 -0
  195. package/dist/plugins/commands.js +5 -1
  196. package/dist/plugins/config-state.js +86 -7
  197. package/dist/plugins/source-display.js +51 -0
  198. package/dist/process/exec.js +20 -2
  199. package/dist/routing/resolve-route.js +12 -0
  200. package/dist/routing/session-key.js +15 -0
  201. package/dist/runtime.js +2 -0
  202. package/dist/security/audit-extra.async.js +601 -0
  203. package/dist/security/audit-extra.js +2 -830
  204. package/dist/security/audit-extra.sync.js +505 -0
  205. package/dist/security/channel-metadata.js +34 -0
  206. package/dist/security/external-content.js +88 -6
  207. package/dist/security/skill-scanner.js +330 -0
  208. package/dist/sessions/session-key-utils.js +7 -0
  209. package/dist/signal/monitor/event-handler.js +80 -1
  210. package/dist/slack/monitor/media.js +85 -15
  211. package/dist/tailscale/detect.js +1 -2
  212. package/dist/telegram/bot/helpers.js +109 -28
  213. package/dist/telegram/bot-handlers.js +144 -3
  214. package/dist/telegram/bot-message-context.js +37 -10
  215. package/dist/telegram/bot-message-dispatch.js +48 -15
  216. package/dist/telegram/bot-native-commands.js +86 -29
  217. package/dist/telegram/bot.js +30 -29
  218. package/dist/telegram/model-buttons.js +163 -0
  219. package/dist/telegram/monitor.js +110 -85
  220. package/dist/telegram/send.js +129 -47
  221. package/dist/terminal/restore.js +45 -0
  222. package/dist/test-helpers/state-dir-env.js +16 -0
  223. package/dist/tts/tts.js +12 -6
  224. package/dist/tui/tui-session-actions.js +166 -54
  225. package/dist/utils/fetch-timeout.js +20 -0
  226. package/dist/utils/normalize-secret-input.js +19 -0
  227. package/dist/utils/transcript-tools.js +58 -0
  228. package/dist/utils.js +45 -14
  229. package/dist/version.js +42 -5
  230. package/package.json +1 -1
@@ -1,9 +1,9 @@
1
1
  import { danger } from "../../globals.js";
2
- import { defaultRuntime } from "../../runtime.js";
3
2
  import { sanitizeAgentId } from "../../routing/session-key.js";
3
+ import { defaultRuntime } from "../../runtime.js";
4
4
  import { addGatewayClientOptions, callGatewayFromCli } from "../gateway-rpc.js";
5
5
  import { parsePositiveIntOrUndefined } from "../program/helpers.js";
6
- import { getCronChannelOptions, parseAtMs, parseDurationMs, printCronList, warnIfCronSchedulerDisabled, } from "./shared.js";
6
+ import { getCronChannelOptions, parseAt, parseDurationMs, printCronList, warnIfCronSchedulerDisabled, } from "./shared.js";
7
7
  export function registerCronStatusCommand(cron) {
8
8
  addGatewayClientOptions(cron
9
9
  .command("status")
@@ -53,9 +53,10 @@ export function registerCronAddCommand(cron) {
53
53
  .option("--description <text>", "Optional description")
54
54
  .option("--disabled", "Create job disabled", false)
55
55
  .option("--delete-after-run", "Delete one-shot job after it succeeds", false)
56
+ .option("--keep-after-run", "Keep one-shot job after it succeeds", false)
56
57
  .option("--agent <id>", "Agent id for this job")
57
- .option("--session <target>", "Session target (main|isolated)", "main")
58
- .option("--wake <mode>", "Wake mode (now|next-heartbeat)", "next-heartbeat")
58
+ .option("--session <target>", "Session target (main|isolated)")
59
+ .option("--wake <mode>", "Wake mode (now|next-heartbeat)", "now")
59
60
  .option("--at <when>", "Run once at time (ISO) or +duration (e.g. 20m)")
60
61
  .option("--every <duration>", "Run every duration (e.g. 10m, 1h)")
61
62
  .option("--cron <expr>", "Cron expression (5-field)")
@@ -65,15 +66,14 @@ export function registerCronAddCommand(cron) {
65
66
  .option("--thinking <level>", "Thinking level for agent jobs (off|minimal|low|medium|high)")
66
67
  .option("--model <model>", "Model override for agent jobs (provider/model or alias)")
67
68
  .option("--timeout-seconds <n>", "Timeout seconds for agent jobs")
68
- .option("--deliver", "Deliver agent output (required when using last-route delivery without --to)", false)
69
+ .option("--announce", "Announce summary to a chat (subagent-style)", false)
70
+ .option("--deliver", "Deprecated (use --announce). Announces a summary to a chat.")
71
+ .option("--no-deliver", "Disable announce delivery and skip main-session summary")
69
72
  .option("--channel <channel>", `Delivery channel (${getCronChannelOptions()})`, "last")
70
73
  .option("--to <dest>", "Delivery destination (E.164, Telegram chatId, or Discord channel/user)")
71
74
  .option("--best-effort-deliver", "Do not fail the job if delivery fails", false)
72
- .option("--post-prefix <prefix>", "Prefix for main-session post", "Cron")
73
- .option("--post-mode <mode>", "What to post back to main for isolated jobs (summary|full)", "summary")
74
- .option("--post-max-chars <n>", "Max chars when --post-mode=full (default 8000)", "8000")
75
75
  .option("--json", "Output JSON", false)
76
- .action(async (opts) => {
76
+ .action(async (opts, cmd) => {
77
77
  try {
78
78
  const schedule = (() => {
79
79
  const at = typeof opts.at === "string" ? opts.at : "";
@@ -84,15 +84,17 @@ export function registerCronAddCommand(cron) {
84
84
  throw new Error("Choose exactly one schedule: --at, --every, or --cron");
85
85
  }
86
86
  if (at) {
87
- const atMs = parseAtMs(at);
88
- if (!atMs)
87
+ const atIso = parseAt(at);
88
+ if (!atIso) {
89
89
  throw new Error("Invalid --at; use ISO time or duration like 20m");
90
- return { kind: "at", atMs };
90
+ }
91
+ return { kind: "at", at: atIso };
91
92
  }
92
93
  if (every) {
93
94
  const everyMs = parseDurationMs(every);
94
- if (!everyMs)
95
+ if (!everyMs) {
95
96
  throw new Error("Invalid --every; use e.g. 10m, 1h, 1d");
97
+ }
96
98
  return { kind: "every", everyMs };
97
99
  }
98
100
  return {
@@ -101,19 +103,20 @@ export function registerCronAddCommand(cron) {
101
103
  tz: typeof opts.tz === "string" && opts.tz.trim() ? opts.tz.trim() : undefined,
102
104
  };
103
105
  })();
104
- const sessionTargetRaw = typeof opts.session === "string" ? opts.session : "main";
105
- const sessionTarget = sessionTargetRaw.trim() || "main";
106
- if (sessionTarget !== "main" && sessionTarget !== "isolated") {
107
- throw new Error("--session must be main or isolated");
108
- }
109
- const wakeModeRaw = typeof opts.wake === "string" ? opts.wake : "next-heartbeat";
110
- const wakeMode = wakeModeRaw.trim() || "next-heartbeat";
106
+ const wakeModeRaw = typeof opts.wake === "string" ? opts.wake : "now";
107
+ const wakeMode = wakeModeRaw.trim() || "now";
111
108
  if (wakeMode !== "now" && wakeMode !== "next-heartbeat") {
112
109
  throw new Error("--wake must be now or next-heartbeat");
113
110
  }
114
111
  const agentId = typeof opts.agent === "string" && opts.agent.trim()
115
112
  ? sanitizeAgentId(opts.agent.trim())
116
113
  : undefined;
114
+ const hasAnnounce = Boolean(opts.announce) || opts.deliver === true;
115
+ const hasNoDeliver = opts.deliver === false;
116
+ const deliveryFlagCount = [hasAnnounce, hasNoDeliver].filter(Boolean).length;
117
+ if (deliveryFlagCount > 1) {
118
+ throw new Error("Choose at most one of --announce or --no-deliver");
119
+ }
117
120
  const payload = (() => {
118
121
  const systemEvent = typeof opts.systemEvent === "string" ? opts.systemEvent.trim() : "";
119
122
  const message = typeof opts.message === "string" ? opts.message.trim() : "";
@@ -121,8 +124,9 @@ export function registerCronAddCommand(cron) {
121
124
  if (chosen !== 1) {
122
125
  throw new Error("Choose exactly one payload: --system-event or --message");
123
126
  }
124
- if (systemEvent)
127
+ if (systemEvent) {
125
128
  return { kind: "systemEvent", text: systemEvent };
129
+ }
126
130
  const timeoutSeconds = parsePositiveIntOrUndefined(opts.timeoutSeconds);
127
131
  return {
128
132
  kind: "agentTurn",
@@ -132,35 +136,43 @@ export function registerCronAddCommand(cron) {
132
136
  ? opts.thinking.trim()
133
137
  : undefined,
134
138
  timeoutSeconds: timeoutSeconds && Number.isFinite(timeoutSeconds) ? timeoutSeconds : undefined,
135
- deliver: opts.deliver ? true : undefined,
136
- channel: typeof opts.channel === "string" ? opts.channel : "last",
137
- to: typeof opts.to === "string" && opts.to.trim() ? opts.to.trim() : undefined,
138
- bestEffortDeliver: opts.bestEffortDeliver ? true : undefined,
139
139
  };
140
140
  })();
141
+ const optionSource = typeof cmd?.getOptionValueSource === "function"
142
+ ? (name) => cmd.getOptionValueSource(name)
143
+ : () => undefined;
144
+ const sessionSource = optionSource("session");
145
+ const sessionTargetRaw = typeof opts.session === "string" ? opts.session.trim() : "";
146
+ const inferredSessionTarget = payload.kind === "agentTurn" ? "isolated" : "main";
147
+ const sessionTarget = sessionSource === "cli" ? sessionTargetRaw || "" : inferredSessionTarget;
148
+ if (sessionTarget !== "main" && sessionTarget !== "isolated") {
149
+ throw new Error("--session must be main or isolated");
150
+ }
151
+ if (opts.deleteAfterRun && opts.keepAfterRun) {
152
+ throw new Error("Choose --delete-after-run or --keep-after-run, not both");
153
+ }
141
154
  if (sessionTarget === "main" && payload.kind !== "systemEvent") {
142
155
  throw new Error("Main jobs require --system-event (systemEvent).");
143
156
  }
144
157
  if (sessionTarget === "isolated" && payload.kind !== "agentTurn") {
145
158
  throw new Error("Isolated jobs require --message (agentTurn).");
146
159
  }
147
- const isolation = sessionTarget === "isolated"
148
- ? {
149
- postToMainPrefix: typeof opts.postPrefix === "string" && opts.postPrefix.trim()
150
- ? opts.postPrefix.trim()
151
- : "Cron",
152
- postToMainMode: opts.postMode === "full" || opts.postMode === "summary"
153
- ? opts.postMode
154
- : undefined,
155
- postToMainMaxChars: typeof opts.postMaxChars === "string" && /^\d+$/.test(opts.postMaxChars)
156
- ? Number.parseInt(opts.postMaxChars, 10)
157
- : undefined,
158
- }
160
+ if ((opts.announce || typeof opts.deliver === "boolean") &&
161
+ (sessionTarget !== "isolated" || payload.kind !== "agentTurn")) {
162
+ throw new Error("--announce/--no-deliver require --session isolated.");
163
+ }
164
+ const deliveryMode = sessionTarget === "isolated" && payload.kind === "agentTurn"
165
+ ? hasAnnounce
166
+ ? "announce"
167
+ : hasNoDeliver
168
+ ? "none"
169
+ : "announce"
159
170
  : undefined;
160
171
  const nameRaw = typeof opts.name === "string" ? opts.name : "";
161
172
  const name = nameRaw.trim();
162
- if (!name)
173
+ if (!name) {
163
174
  throw new Error("--name is required");
175
+ }
164
176
  const description = typeof opts.description === "string" && opts.description.trim()
165
177
  ? opts.description.trim()
166
178
  : undefined;
@@ -168,13 +180,22 @@ export function registerCronAddCommand(cron) {
168
180
  name,
169
181
  description,
170
182
  enabled: !opts.disabled,
171
- deleteAfterRun: Boolean(opts.deleteAfterRun),
183
+ deleteAfterRun: opts.deleteAfterRun ? true : opts.keepAfterRun ? false : undefined,
172
184
  agentId,
173
185
  schedule,
174
186
  sessionTarget,
175
187
  wakeMode,
176
188
  payload,
177
- isolation,
189
+ delivery: deliveryMode
190
+ ? {
191
+ mode: deliveryMode,
192
+ channel: typeof opts.channel === "string" && opts.channel.trim()
193
+ ? opts.channel.trim()
194
+ : undefined,
195
+ to: typeof opts.to === "string" && opts.to.trim() ? opts.to.trim() : undefined,
196
+ bestEffort: opts.bestEffortDeliver ? true : undefined,
197
+ }
198
+ : undefined,
178
199
  };
179
200
  const res = await callGatewayFromCli("cron.add", opts, params);
180
201
  defaultRuntime.log(JSON.stringify(res, null, 2));
@@ -1,11 +1,12 @@
1
1
  import { danger } from "../../globals.js";
2
- import { defaultRuntime } from "../../runtime.js";
3
2
  import { sanitizeAgentId } from "../../routing/session-key.js";
3
+ import { defaultRuntime } from "../../runtime.js";
4
4
  import { addGatewayClientOptions, callGatewayFromCli } from "../gateway-rpc.js";
5
- import { getCronChannelOptions, parseAtMs, parseDurationMs, warnIfCronSchedulerDisabled, } from "./shared.js";
5
+ import { getCronChannelOptions, parseAt, parseDurationMs, warnIfCronSchedulerDisabled, } from "./shared.js";
6
6
  const assignIf = (target, key, value, shouldAssign) => {
7
- if (shouldAssign)
7
+ if (shouldAssign) {
8
8
  target[key] = value;
9
+ }
9
10
  };
10
11
  export function registerCronEditCommand(cron) {
11
12
  addGatewayClientOptions(cron
@@ -31,13 +32,13 @@ export function registerCronEditCommand(cron) {
31
32
  .option("--thinking <level>", "Thinking level for agent jobs")
32
33
  .option("--model <model>", "Model override for agent jobs")
33
34
  .option("--timeout-seconds <n>", "Timeout seconds for agent jobs")
34
- .option("--deliver", "Deliver agent output (required when using last-route delivery without --to)")
35
- .option("--no-deliver", "Disable delivery")
35
+ .option("--announce", "Announce summary to a chat (subagent-style)")
36
+ .option("--deliver", "Deprecated (use --announce). Announces a summary to a chat.")
37
+ .option("--no-deliver", "Disable announce delivery")
36
38
  .option("--channel <channel>", `Delivery channel (${getCronChannelOptions()})`)
37
39
  .option("--to <dest>", "Delivery destination (E.164, Telegram chatId, or Discord channel/user)")
38
40
  .option("--best-effort-deliver", "Do not fail job if delivery fails")
39
41
  .option("--no-best-effort-deliver", "Fail job when delivery fails")
40
- .option("--post-prefix <prefix>", "Prefix for summary system event")
41
42
  .action(async (id, opts) => {
42
43
  try {
43
44
  if (opts.session === "main" && opts.message) {
@@ -46,31 +47,40 @@ export function registerCronEditCommand(cron) {
46
47
  if (opts.session === "isolated" && opts.systemEvent) {
47
48
  throw new Error("Isolated jobs cannot use --system-event; use --message or --session main.");
48
49
  }
49
- if (opts.session === "main" && typeof opts.postPrefix === "string") {
50
- throw new Error("--post-prefix only applies to isolated jobs.");
50
+ if (opts.announce && typeof opts.deliver === "boolean") {
51
+ throw new Error("Choose --announce or --no-deliver (not multiple).");
51
52
  }
52
53
  const patch = {};
53
- if (typeof opts.name === "string")
54
+ if (typeof opts.name === "string") {
54
55
  patch.name = opts.name;
55
- if (typeof opts.description === "string")
56
+ }
57
+ if (typeof opts.description === "string") {
56
58
  patch.description = opts.description;
57
- if (opts.enable && opts.disable)
59
+ }
60
+ if (opts.enable && opts.disable) {
58
61
  throw new Error("Choose --enable or --disable, not both");
59
- if (opts.enable)
62
+ }
63
+ if (opts.enable) {
60
64
  patch.enabled = true;
61
- if (opts.disable)
65
+ }
66
+ if (opts.disable) {
62
67
  patch.enabled = false;
68
+ }
63
69
  if (opts.deleteAfterRun && opts.keepAfterRun) {
64
70
  throw new Error("Choose --delete-after-run or --keep-after-run, not both");
65
71
  }
66
- if (opts.deleteAfterRun)
72
+ if (opts.deleteAfterRun) {
67
73
  patch.deleteAfterRun = true;
68
- if (opts.keepAfterRun)
74
+ }
75
+ if (opts.keepAfterRun) {
69
76
  patch.deleteAfterRun = false;
70
- if (typeof opts.session === "string")
77
+ }
78
+ if (typeof opts.session === "string") {
71
79
  patch.sessionTarget = opts.session;
72
- if (typeof opts.wake === "string")
80
+ }
81
+ if (typeof opts.wake === "string") {
73
82
  patch.wakeMode = opts.wake;
83
+ }
74
84
  if (opts.agent && opts.clearAgent) {
75
85
  throw new Error("Use --agent or --clear-agent, not both");
76
86
  }
@@ -81,18 +91,21 @@ export function registerCronEditCommand(cron) {
81
91
  patch.agentId = null;
82
92
  }
83
93
  const scheduleChosen = [opts.at, opts.every, opts.cron].filter(Boolean).length;
84
- if (scheduleChosen > 1)
94
+ if (scheduleChosen > 1) {
85
95
  throw new Error("Choose at most one schedule change");
96
+ }
86
97
  if (opts.at) {
87
- const atMs = parseAtMs(String(opts.at));
88
- if (!atMs)
98
+ const atIso = parseAt(String(opts.at));
99
+ if (!atIso) {
89
100
  throw new Error("Invalid --at");
90
- patch.schedule = { kind: "at", atMs };
101
+ }
102
+ patch.schedule = { kind: "at", at: atIso };
91
103
  }
92
104
  else if (opts.every) {
93
105
  const everyMs = parseDurationMs(String(opts.every));
94
- if (!everyMs)
106
+ if (!everyMs) {
95
107
  throw new Error("Invalid --every");
108
+ }
96
109
  patch.schedule = { kind: "every", everyMs };
97
110
  }
98
111
  else if (opts.cron) {
@@ -111,14 +124,16 @@ export function registerCronEditCommand(cron) {
111
124
  ? Number.parseInt(String(opts.timeoutSeconds), 10)
112
125
  : undefined;
113
126
  const hasTimeoutSeconds = Boolean(timeoutSeconds && Number.isFinite(timeoutSeconds));
127
+ const hasDeliveryModeFlag = opts.announce || typeof opts.deliver === "boolean";
128
+ const hasDeliveryTarget = typeof opts.channel === "string" || typeof opts.to === "string";
129
+ const hasBestEffort = typeof opts.bestEffortDeliver === "boolean";
114
130
  const hasAgentTurnPatch = typeof opts.message === "string" ||
115
131
  Boolean(model) ||
116
132
  Boolean(thinking) ||
117
133
  hasTimeoutSeconds ||
118
- typeof opts.deliver === "boolean" ||
119
- typeof opts.channel === "string" ||
120
- typeof opts.to === "string" ||
121
- typeof opts.bestEffortDeliver === "boolean";
134
+ hasDeliveryModeFlag ||
135
+ hasDeliveryTarget ||
136
+ hasBestEffort;
122
137
  if (hasSystemEventPatch && hasAgentTurnPatch) {
123
138
  throw new Error("Choose at most one payload change");
124
139
  }
@@ -134,16 +149,27 @@ export function registerCronEditCommand(cron) {
134
149
  assignIf(payload, "model", model, Boolean(model));
135
150
  assignIf(payload, "thinking", thinking, Boolean(thinking));
136
151
  assignIf(payload, "timeoutSeconds", timeoutSeconds, hasTimeoutSeconds);
137
- assignIf(payload, "deliver", opts.deliver, typeof opts.deliver === "boolean");
138
- assignIf(payload, "channel", opts.channel, typeof opts.channel === "string");
139
- assignIf(payload, "to", opts.to, typeof opts.to === "string");
140
- assignIf(payload, "bestEffortDeliver", opts.bestEffortDeliver, typeof opts.bestEffortDeliver === "boolean");
141
152
  patch.payload = payload;
142
153
  }
143
- if (typeof opts.postPrefix === "string") {
144
- patch.isolation = {
145
- postToMainPrefix: opts.postPrefix.trim() ? opts.postPrefix : "Cron",
146
- };
154
+ if (hasDeliveryModeFlag || hasDeliveryTarget || hasBestEffort) {
155
+ const deliveryMode = opts.announce || opts.deliver === true
156
+ ? "announce"
157
+ : opts.deliver === false
158
+ ? "none"
159
+ : "announce";
160
+ const delivery = { mode: deliveryMode };
161
+ if (typeof opts.channel === "string") {
162
+ const channel = opts.channel.trim();
163
+ delivery.channel = channel ? channel : undefined;
164
+ }
165
+ if (typeof opts.to === "string") {
166
+ const to = opts.to.trim();
167
+ delivery.to = to ? to : undefined;
168
+ }
169
+ if (typeof opts.bestEffortDeliver === "boolean") {
170
+ delivery.bestEffort = opts.bestEffortDeliver;
171
+ }
172
+ patch.delivery = delivery;
147
173
  }
148
174
  const res = await callGatewayFromCli("cron.update", opts, {
149
175
  id,
@@ -1,5 +1,6 @@
1
1
  import { listChannelPlugins } from "../../channels/plugins/index.js";
2
2
  import { parseAbsoluteTimeMs } from "../../cron/parse.js";
3
+ import { formatDurationHuman } from "../../infra/format-time/format-duration.js";
3
4
  import { defaultRuntime } from "../../runtime.js";
4
5
  import { colorize, isRich, theme } from "../../terminal/theme.js";
5
6
  import { callGatewayFromCli } from "../gateway-rpc.js";
@@ -7,8 +8,9 @@ export const getCronChannelOptions = () => ["last", ...listChannelPlugins().map(
7
8
  export async function warnIfCronSchedulerDisabled(opts) {
8
9
  try {
9
10
  const res = (await callGatewayFromCli("cron.status", opts, {}));
10
- if (res?.enabled === true)
11
+ if (res?.enabled === true) {
11
12
  return;
13
+ }
12
14
  const store = typeof res?.storePath === "string" ? res.storePath : "";
13
15
  defaultRuntime.error([
14
16
  "warning: cron scheduler is disabled in the Gateway; jobs are saved but will not run automatically.",
@@ -24,14 +26,17 @@ export async function warnIfCronSchedulerDisabled(opts) {
24
26
  }
25
27
  export function parseDurationMs(input) {
26
28
  const raw = input.trim();
27
- if (!raw)
29
+ if (!raw) {
28
30
  return null;
31
+ }
29
32
  const match = raw.match(/^(\d+(?:\.\d+)?)(ms|s|m|h|d)$/i);
30
- if (!match)
33
+ if (!match) {
31
34
  return null;
35
+ }
32
36
  const n = Number.parseFloat(match[1] ?? "");
33
- if (!Number.isFinite(n) || n <= 0)
37
+ if (!Number.isFinite(n) || n <= 0) {
34
38
  return null;
39
+ }
35
40
  const unit = (match[2] ?? "").toLowerCase();
36
41
  const factor = unit === "ms"
37
42
  ? 1
@@ -44,16 +49,19 @@ export function parseDurationMs(input) {
44
49
  : 86_400_000;
45
50
  return Math.floor(n * factor);
46
51
  }
47
- export function parseAtMs(input) {
52
+ export function parseAt(input) {
48
53
  const raw = input.trim();
49
- if (!raw)
54
+ if (!raw) {
50
55
  return null;
56
+ }
51
57
  const absolute = parseAbsoluteTimeMs(raw);
52
- if (absolute)
53
- return absolute;
58
+ if (absolute !== null) {
59
+ return new Date(absolute).toISOString();
60
+ }
54
61
  const dur = parseDurationMs(raw);
55
- if (dur)
56
- return Date.now() + dur;
62
+ if (dur !== null) {
63
+ return new Date(Date.now() + dur).toISOString();
64
+ }
57
65
  return null;
58
66
  }
59
67
  const CRON_ID_PAD = 36;
@@ -66,56 +74,59 @@ const CRON_TARGET_PAD = 9;
66
74
  const CRON_AGENT_PAD = 10;
67
75
  const pad = (value, width) => value.padEnd(width);
68
76
  const truncate = (value, width) => {
69
- if (value.length <= width)
77
+ if (value.length <= width) {
70
78
  return value;
71
- if (width <= 3)
79
+ }
80
+ if (width <= 3) {
72
81
  return value.slice(0, width);
82
+ }
73
83
  return `${value.slice(0, width - 3)}...`;
74
84
  };
75
- const formatIsoMinute = (ms) => {
76
- const d = new Date(ms);
77
- if (Number.isNaN(d.getTime()))
85
+ const formatIsoMinute = (iso) => {
86
+ const parsed = parseAbsoluteTimeMs(iso);
87
+ const d = new Date(parsed ?? NaN);
88
+ if (Number.isNaN(d.getTime())) {
78
89
  return "-";
79
- const iso = d.toISOString();
80
- return `${iso.slice(0, 10)} ${iso.slice(11, 16)}Z`;
81
- };
82
- const formatDuration = (ms) => {
83
- if (ms < 60_000)
84
- return `${Math.max(1, Math.round(ms / 1000))}s`;
85
- if (ms < 3_600_000)
86
- return `${Math.round(ms / 60_000)}m`;
87
- if (ms < 86_400_000)
88
- return `${Math.round(ms / 3_600_000)}h`;
89
- return `${Math.round(ms / 86_400_000)}d`;
90
+ }
91
+ const isoStr = d.toISOString();
92
+ return `${isoStr.slice(0, 10)} ${isoStr.slice(11, 16)}Z`;
90
93
  };
91
94
  const formatSpan = (ms) => {
92
- if (ms < 60_000)
95
+ if (ms < 60_000) {
93
96
  return "<1m";
94
- if (ms < 3_600_000)
97
+ }
98
+ if (ms < 3_600_000) {
95
99
  return `${Math.round(ms / 60_000)}m`;
96
- if (ms < 86_400_000)
100
+ }
101
+ if (ms < 86_400_000) {
97
102
  return `${Math.round(ms / 3_600_000)}h`;
103
+ }
98
104
  return `${Math.round(ms / 86_400_000)}d`;
99
105
  };
100
106
  const formatRelative = (ms, nowMs) => {
101
- if (!ms)
107
+ if (!ms) {
102
108
  return "-";
109
+ }
103
110
  const delta = ms - nowMs;
104
111
  const label = formatSpan(Math.abs(delta));
105
112
  return delta >= 0 ? `in ${label}` : `${label} ago`;
106
113
  };
107
114
  const formatSchedule = (schedule) => {
108
- if (schedule.kind === "at")
109
- return `at ${formatIsoMinute(schedule.atMs)}`;
110
- if (schedule.kind === "every")
111
- return `every ${formatDuration(schedule.everyMs)}`;
115
+ if (schedule.kind === "at") {
116
+ return `at ${formatIsoMinute(schedule.at)}`;
117
+ }
118
+ if (schedule.kind === "every") {
119
+ return `every ${formatDurationHuman(schedule.everyMs)}`;
120
+ }
112
121
  return schedule.tz ? `cron ${schedule.expr} @ ${schedule.tz}` : `cron ${schedule.expr}`;
113
122
  };
114
123
  const formatStatus = (job) => {
115
- if (!job.enabled)
124
+ if (!job.enabled) {
116
125
  return "disabled";
117
- if (job.state.runningAtMs)
126
+ }
127
+ if (job.state.runningAtMs) {
118
128
  return "running";
129
+ }
119
130
  return job.state.lastStatus ?? "idle";
120
131
  };
121
132
  export function printCronList(jobs, runtime = defaultRuntime) {
@@ -144,17 +155,21 @@ export function printCronList(jobs, runtime = defaultRuntime) {
144
155
  const lastLabel = pad(formatRelative(job.state.lastRunAtMs, now), CRON_LAST_PAD);
145
156
  const statusRaw = formatStatus(job);
146
157
  const statusLabel = pad(statusRaw, CRON_STATUS_PAD);
147
- const targetLabel = pad(job.sessionTarget, CRON_TARGET_PAD);
158
+ const targetLabel = pad(job.sessionTarget ?? "-", CRON_TARGET_PAD);
148
159
  const agentLabel = pad(truncate(job.agentId ?? "default", CRON_AGENT_PAD), CRON_AGENT_PAD);
149
160
  const coloredStatus = (() => {
150
- if (statusRaw === "ok")
161
+ if (statusRaw === "ok") {
151
162
  return colorize(rich, theme.success, statusLabel);
152
- if (statusRaw === "error")
163
+ }
164
+ if (statusRaw === "error") {
153
165
  return colorize(rich, theme.error, statusLabel);
154
- if (statusRaw === "running")
166
+ }
167
+ if (statusRaw === "running") {
155
168
  return colorize(rich, theme.warn, statusLabel);
156
- if (statusRaw === "skipped")
169
+ }
170
+ if (statusRaw === "skipped") {
157
171
  return colorize(rich, theme.muted, statusLabel);
172
+ }
158
173
  return colorize(rich, theme.muted, statusLabel);
159
174
  })();
160
175
  const coloredTarget = job.sessionTarget === "isolated"