@poolzin/pool-bot 2026.4.18 → 2026.4.20

package/dist/agents/system-prompt.js

@@ -162,7 +162,7 @@ export function buildAgentSystemPrompt(params) {
         browser: "Control web browser",
         canvas: "Present/eval/snapshot the Canvas",
         nodes: "List/describe/notify/camera/screen on paired nodes",
-        cron: "Manage cron jobs and wake events (use for reminders; when scheduling a reminder, write the systemEvent text as something that will read like a reminder when it fires, and mention that it is a reminder depending on the time gap between setting and firing; include recent context in reminder text if appropriate)",
+        cron: "Manage cron jobs and wake events. SCHEDULING MODES: (1) Reminders — use systemEvent payload to inject text into your session when it fires; write the text as something that reads like a reminder. (2) Background tasks — use agentTurn payload with a message describing the work; results auto-deliver back to the originating chat. CRITICAL: When the user asks you to do something 'later', 'tonight', 'overnight', 'tomorrow morning', 'when I wake up', or any future time — IMMEDIATELY schedule a cron job with schedule.kind='at' at the appropriate time and payload.kind='agentTurn' with a descriptive message. Do NOT just say you'll do it. Actually schedule it. Use delivery.mode='announce' (default) to deliver results back to the user's chat.",
         message: "Send messages and channel actions",
         gateway: "Restart, apply config, or run updates on the running Pool Bot process",
         agents_list: "List agent ids allowed for sessions_spawn",
@@ -326,7 +326,7 @@ export function buildAgentSystemPrompt(params) {
                 "- browser: control Pool Bot's dedicated browser",
                 "- canvas: present/eval/snapshot the Canvas",
                 "- nodes: list/describe/notify/camera/screen on paired nodes",
-                "- cron: manage cron jobs and wake events (use for reminders; when scheduling a reminder, write the systemEvent text as something that will read like a reminder when it fires, and mention that it is a reminder depending on the time gap between setting and firing; include recent context in reminder text if appropriate)",
+                "- cron: manage cron jobs and wake events (use systemEvent for reminders, agentTurn for background tasks; when user asks for future work — 'later', 'tonight', 'tomorrow' — schedule an agentTurn cron job with schedule.kind='at')",
                 "- sessions_list: list sessions",
                 "- sessions_history: fetch session history",
                 "- sessions_send: send to another session",

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026.4.18",
+  "version": "2026.4.20",
   "commit": "4e1f8d4b27c26618d3a69049dbe44698929a6ba8",
-  "builtAt": "2026-03-27T01:18:30.781Z"
+  "builtAt": "2026-03-27T04:37:21.576Z"
 }

package/dist/config/types.cron.d.ts

@@ -15,5 +15,11 @@ export type CronConfig = {
      * Default: "24h".
      */
     sessionRetention?: string | false;
+    /**
+     * Default timeout for cron jobs in seconds.
+     * Per-job `timeoutSeconds` overrides this. Set to 0 to disable timeout (not recommended).
+     * Default: 7200 (2 hours).
+     */
+    defaultJobTimeoutSeconds?: number;
 };
 //# sourceMappingURL=types.cron.d.ts.map

package/dist/config/types.cron.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.cron.d.ts","sourceRoot":"","sources":["../../src/config/types.cron.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACnC,CAAC"}
+{"version":3,"file":"types.cron.d.ts","sourceRoot":"","sources":["../../src/config/types.cron.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAClC;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC,CAAC"}

package/dist/cron/delivery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../src/cron/delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAqBF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CA+CtE"}
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../src/cron/delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAqBF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAiDtE"}

package/dist/cron/delivery.js

@@ -25,9 +25,11 @@ export function resolveCronDeliveryPlan(job) {
         ? "announce"
         : normalizedMode === "none"
             ? "none"
-            : normalizedMode === "deliver"
-                ? "announce"
-                : undefined;
+            : normalizedMode === "webhook"
+                ? "webhook"
+                : normalizedMode === "deliver"
+                    ? "announce"
+                    : undefined;
     const payloadChannel = normalizeChannel(payload?.channel);
     const payloadTo = normalizeTo(payload?.to);
     const deliveryChannel = normalizeChannel(delivery?.channel);
@@ -41,7 +43,7 @@ export function resolveCronDeliveryPlan(job) {
             channel,
             to,
             source: "delivery",
-            requested: resolvedMode === "announce",
+            requested: resolvedMode === "announce" || resolvedMode === "webhook",
         };
     }
     const legacyMode = payload?.deliver === true ? "explicit" : payload?.deliver === false ? "off" : "auto";

package/dist/cron/isolated-agent/session.d.ts

@@ -1,15 +1,18 @@
 import type { PoolBotConfig } from "../../config/config.js";
 import { type SessionEntry } from "../../config/sessions.js";
-export declare function resolveCronSession(params: {
-    cfg: PoolBotConfig;
-    sessionKey: string;
-    nowMs: number;
-    agentId: string;
-}): {
+export type CronSessionResult = {
     storePath: string;
     store: Record<string, SessionEntry>;
     sessionEntry: SessionEntry;
     systemSent: boolean;
     isNewSession: boolean;
+    reusedSessionId?: string;
 };
+export declare function resolveCronSession(params: {
+    cfg: PoolBotConfig;
+    sessionKey: string;
+    nowMs: number;
+    agentId: string;
+    forceNew?: boolean;
+}): CronSessionResult;
 //# sourceMappingURL=session.d.ts.map

package/dist/cron/isolated-agent/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/cron/isolated-agent/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAsC,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEjG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,GAAG,EAAE,aAAa,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;;;;;;EA0BA"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/cron/isolated-agent/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAsC,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIjG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpC,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,GAAG,EAAE,aAAa,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,iBAAiB,CAgDpB"}

package/dist/cron/isolated-agent/session.js

@@ -1,5 +1,6 @@
 import crypto from "node:crypto";
 import { loadSessionStore, resolveStorePath } from "../../config/sessions.js";
+const SESSION_FRESHNESS_MS = 10 * 60_000; // 10 minutes
 export function resolveCronSession(params) {
     const sessionCfg = params.cfg.session;
     const storePath = resolveStorePath(sessionCfg?.store, {
@@ -7,6 +8,25 @@ export function resolveCronSession(params) {
     });
     const store = loadSessionStore(storePath);
     const entry = store[params.sessionKey];
+    // Check if we can reuse the existing session (fresh and forceNew is not set)
+    const forceNew = params.forceNew !== false;
+    const isFresh = entry?.updatedAt && params.nowMs - entry.updatedAt < SESSION_FRESHNESS_MS;
+    if (!forceNew && isFresh && entry) {
+        // Reuse existing session — preserve context continuity
+        const sessionEntry = {
+            ...entry,
+            updatedAt: params.nowMs,
+        };
+        return {
+            storePath,
+            store,
+            sessionEntry,
+            systemSent: entry.systemSent ?? false,
+            isNewSession: false,
+            reusedSessionId: entry.sessionId,
+        };
+    }
+    // Create fresh session
     const sessionId = crypto.randomUUID();
     const systemSent = false;
     const sessionEntry = {

package/dist/cron/isolated-agent/subagent-followup.d.ts

@@ -4,6 +4,11 @@ export declare function readDescendantSubagentFallbackReply(params: {
     sessionKey: string;
     runStartedAt: number;
 }): Promise<string | undefined>;
+/**
+ * Wait for descendant subagents with exponential backoff.
+ * Starts at 500ms, doubles up to 10s between polls.
+ * This dramatically reduces CPU usage for long-running overnight tasks.
+ */
 export declare function waitForDescendantSubagentSummary(params: {
     sessionKey: string;
     initialReply?: string;

package/dist/cron/isolated-agent/subagent-followup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-followup.d.ts","sourceRoot":"","sources":["../../../src/cron/isolated-agent/subagent-followup.ts"],"names":[],"mappings":"AAWA,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CA6BjE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAa9D;AAED,wBAAsB,mCAAmC,CAAC,MAAM,EAAE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA2C9B;AAED,wBAAsB,gCAAgC,CAAC,MAAM,EAAE;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAyC9B"}
+{"version":3,"file":"subagent-followup.d.ts","sourceRoot":"","sources":["../../../src/cron/isolated-agent/subagent-followup.ts"],"names":[],"mappings":"AAYA,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CA6BjE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAa9D;AAED,wBAAsB,mCAAmC,CAAC,MAAM,EAAE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA2C9B;AAED;;;;GAIG;AACH,wBAAsB,gCAAgC,CAAC,MAAM,EAAE;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiD9B"}

package/dist/cron/isolated-agent/subagent-followup.js

@@ -1,7 +1,8 @@
 import { countActiveDescendantRuns, listDescendantRunsForRequester, } from "../../agents/subagent-registry.js";
 import { readLatestAssistantReply } from "../../agents/tools/agent-step.js";
 import { SILENT_REPLY_TOKEN } from "../../auto-reply/tokens.js";
-const CRON_SUBAGENT_WAIT_POLL_MS = 500;
+const CRON_SUBAGENT_WAIT_INITIAL_POLL_MS = 500;
+const CRON_SUBAGENT_WAIT_MAX_POLL_MS = 10_000;
 const CRON_SUBAGENT_WAIT_MIN_MS = 30_000;
 const CRON_SUBAGENT_FINAL_REPLY_GRACE_MS = 5_000;
 export function isLikelyInterimCronMessage(value) {
@@ -87,19 +88,29 @@ export async function readDescendantSubagentFallbackReply(params) {
     }
     return replies.join("\n\n");
 }
+/**
+ * Wait for descendant subagents with exponential backoff.
+ * Starts at 500ms, doubles up to 10s between polls.
+ * This dramatically reduces CPU usage for long-running overnight tasks.
+ */
 export async function waitForDescendantSubagentSummary(params) {
     const initialReply = params.initialReply?.trim();
     const deadline = Date.now() + Math.max(CRON_SUBAGENT_WAIT_MIN_MS, Math.floor(params.timeoutMs));
     let sawActiveDescendants = params.observedActiveDescendants === true;
     let drainedAtMs;
+    let pollInterval = CRON_SUBAGENT_WAIT_INITIAL_POLL_MS;
     while (Date.now() < deadline) {
         const activeDescendants = countActiveDescendantRuns(params.sessionKey);
         if (activeDescendants > 0) {
             sawActiveDescendants = true;
             drainedAtMs = undefined;
-            await new Promise((resolve) => setTimeout(resolve, CRON_SUBAGENT_WAIT_POLL_MS));
+            // Exponential backoff: 500ms → 1s → 2s → 4s → 8s → 10s (cap)
+            await new Promise((resolve) => setTimeout(resolve, pollInterval));
+            pollInterval = Math.min(pollInterval * 2, CRON_SUBAGENT_WAIT_MAX_POLL_MS);
             continue;
         }
+        // Reset poll interval when descendants drain
+        pollInterval = CRON_SUBAGENT_WAIT_INITIAL_POLL_MS;
         if (!sawActiveDescendants) {
             return initialReply;
         }
@@ -115,7 +126,7 @@ export async function waitForDescendantSubagentSummary(params) {
         if (Date.now() - drainedAtMs >= CRON_SUBAGENT_FINAL_REPLY_GRACE_MS) {
             return undefined;
         }
-        await new Promise((resolve) => setTimeout(resolve, CRON_SUBAGENT_WAIT_POLL_MS));
+        await new Promise((resolve) => setTimeout(resolve, CRON_SUBAGENT_WAIT_INITIAL_POLL_MS));
     }
     const latest = (await readLatestAssistantReply({ sessionKey: params.sessionKey }))?.trim();
     if (latest &&

package/dist/cron/service/timer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../../src/cron/service/timer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAmD,MAAM,aAAa,CAAC;AAQ5F,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA+I9D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,gBAAgB,QAuC/C;AAED,wBAAsB,OAAO,CAAC,KAAK,EAAE,gBAAgB,iBA2MpD;AAyDD,wBAAsB,aAAa,CACjC,KAAK,EAAE,gBAAgB,EACvB,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,iBA6F5C;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,gBAAgB,iBASvD;AAuHD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,iBAoC3B;AAmDD,wBAAgB,IAAI,CAClB,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE;IAAE,IAAI,EAAE,KAAK,GAAG,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;;;;EAWvD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,gBAAgB,QAKhD;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,SAAS,QAM3D"}
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../../src/cron/service/timer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAmD,MAAM,aAAa,CAAC;AAQ5F,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA+I9D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,gBAAgB,QAuC/C;AAED,wBAAsB,OAAO,CAAC,KAAK,EAAE,gBAAgB,iBAkNpD;AAyDD,wBAAsB,aAAa,CACjC,KAAK,EAAE,gBAAgB,EACvB,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,iBA6F5C;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,gBAAgB,iBASvD;AAuHD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,iBAoC3B;AAmDD,wBAAgB,IAAI,CAClB,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE;IAAE,IAAI,EAAE,KAAK,GAAG,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;;;;EAWvD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,gBAAgB,QAKhD;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,SAAS,QAM3D"}

package/dist/cron/service/timer.js

@@ -18,7 +18,7 @@ const MIN_REFIRE_GAP_MS = 2_000;
  * on top of the per-provider / per-agent timeouts to prevent one stuck job
  * from wedging the entire cron lane.
  */
-const DEFAULT_JOB_TIMEOUT_MS = 10 * 60_000; // 10 minutes
+const DEFAULT_JOB_TIMEOUT_MS = 2 * 60 * 60_000; // 2 hours (allows overnight/long-running tasks)
 function resolveRunConcurrency(state) {
     const raw = state.deps.cronConfig?.maxConcurrentRuns;
     if (typeof raw !== "number" || !Number.isFinite(raw)) {
@@ -203,11 +203,17 @@ export async function onTimer(state) {
             const configuredTimeoutMs = job.payload.kind === "agentTurn" && typeof job.payload.timeoutSeconds === "number"
                 ? Math.floor(job.payload.timeoutSeconds * 1_000)
                 : undefined;
+            const cronDefaultTimeoutMs = typeof state.deps.cronConfig?.defaultJobTimeoutSeconds === "number"
+                ? state.deps.cronConfig.defaultJobTimeoutSeconds <= 0
+                    ? undefined
+                    : Math.floor(state.deps.cronConfig.defaultJobTimeoutSeconds * 1_000)
+                : undefined;
+            const effectiveDefaultMs = cronDefaultTimeoutMs ?? DEFAULT_JOB_TIMEOUT_MS;
             const jobTimeoutMs = configuredTimeoutMs !== undefined
                 ? configuredTimeoutMs <= 0
                     ? undefined
                     : configuredTimeoutMs
-                : DEFAULT_JOB_TIMEOUT_MS;
+                : effectiveDefaultMs;
             try {
                 const result = typeof jobTimeoutMs === "number"
                     ? await (async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poolzin/pool-bot",
-  "version": "2026.4.18",
+  "version": "2026.4.20",
   "description": "🎱 Pool Bot - AI assistant with PLCODE integrations",
   "keywords": [],
   "license": "MIT",