openclaw-scheduler 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -2,21 +2,38 @@
 
 All notable changes to this project will be documented in this file.
 
-## [Unreleased]
+## [0.2.1] -- 2026-04-01
 
 ### Fixed
 - fix(watcher): exit cleanly when session status=done (PR #1)
 - fix(watchdog): prevent auto-resolving active sessions with heartbeat + hard ceiling (PR #2)
 - fix(gateway): reset idle timer while fetch is in flight (PR #3)
 - fix(watcher): prevent premature kill of active subagent sessions with JSONL activity signal (PR #7)
+- fix(db): add SQLite busy_timeout (5s) to prevent SQLITE_BUSY on CLI + dispatcher contention
+- fix(approvals): prevent double-dispatch race on auto-approved jobs
+- fix(watcher): cap deadline extension at min(timeout, 4h) to prevent zombie watchers
+- fix(runs): preserve empty string summary/error_message (use ?? instead of ||)
+- fix(runs): guard getTimedOutRuns against NULL run_timeout_ms on legacy rows
+- fix(gateway): use byte length for Telegram message chunking (4096-byte limit)
+- fix(jobs): validate schedule_tz as real IANA timezone via Intl.DateTimeFormat
+- fix(dispatcher): wrap delete_after_run cleanup in transaction
+- fix(dispatch): remove 4000-char truncation in formatMessageForDelivery
+- fix(dispatch): add retry exception path delivery announcement
+- fix(dispatch): fix dispatch CLI subcommand routing in bin wrapper
 
 ### Added
 - feat: v0.2 runtime with identity/trust/authorization/evidence/credential handoff (PR #4)
 - feat: x-openclaw-env-inject header for agent task credentials (PR #5)
+- feat: [IMAGE:path] marker protocol for shell job image attachments
+- feat: auto-delete watcher and watchdog jobs after completion (delete_after_run)
+- feat: enforce delivery_to as required field on job INSERT
+- feat: multi-platform CI (Linux, macOS, Windows)
 - docs: trust architecture, multi-agent gateway routing, agent adoption files
+- docs: AGENTS.md, CONTEXT.md, JOB-QUICK-REF.md for agent adoption
 
 ### Changed
 - chore: replace non-ASCII characters with ASCII equivalents (PR #6)
+- chore: bump output_excerpt_limit and output_summary_limit defaults to 64KB
 
 ## [0.2.0] -- 2026-03-11
 

package/dispatcher-delivery.js

@@ -6,7 +6,7 @@ export function createDeliveryHelpers({ log, resolveDeliveryAlias }) {
     return resolveDeliveryAlias(target);
   }
 
-  async function handleDelivery(job, content) {
+  async function handleDelivery(job, content, opts = {}) {
     if (!['announce', 'announce-always'].includes(job.delivery_mode)) return;
     if (!job.delivery_channel && !job.delivery_to) return;
 
@@ -24,7 +24,7 @@ export function createDeliveryHelpers({ log, resolveDeliveryAlias }) {
 
     try {
       const subject = (job.name || '').slice(0, 100);
-      sendMessage({
+      const msg = {
         from_agent: 'scheduler',
         to_agent:   'main',
         kind:       'result',
@@ -32,8 +32,15 @@ export function createDeliveryHelpers({ log, resolveDeliveryAlias }) {
         body:       content,
         channel,
         delivery_to: target,
-      });
-      log('info', `Enqueued: ${job.name}`, { channel, to: target });
+      };
+      // Pass image attachment paths so the message consumer can deliver them
+      // as photo/file attachments instead of plain text. Scripts signal this
+      // by writing [IMAGE:/path/to/file] markers to stdout.
+      if (opts.imageAttachments?.length > 0) {
+        msg.attachments = opts.imageAttachments;
+      }
+      sendMessage(msg);
+      log('info', `Enqueued: ${job.name}`, { channel, to: target, attachments: opts.imageAttachments?.length || 0 });
     } catch (err) {
       log('error', `Delivery enqueue failed: ${job.name}: ${err.message}`);
     }

package/dispatcher-strategies.js

@@ -203,15 +203,19 @@ export async function finalizeDispatch(job, ctx, result, deps) {
     const shouldAnnounce = ['announce', 'announce-always'].includes(job.delivery_mode)
       && deliveryContent?.trim();
 
+    const deliveryOpts = result.imageAttachments?.length > 0
+      ? { imageAttachments: result.imageAttachments }
+      : {};
+
     if (shouldAnnounce) {
       if (result.deliveryOverride) {
-        await handleDelivery(job, result.deliveryOverride);
+        await handleDelivery(job, result.deliveryOverride, deliveryOpts);
       } else if (result.status === 'error') {
         const willRetry = (job.max_retries ?? 0) > 0 && (ctx.run.retry_count || 0) < job.max_retries;
         const retryLabel = willRetry ? 'will retry' : 'no retries configured';
-        await handleDelivery(job, `\u26a0\ufe0f Job soft-failed (${retryLabel}): ${job.name}\n\n${deliveryContent}`);
+        await handleDelivery(job, `\u26a0\ufe0f Job soft-failed (${retryLabel}): ${job.name}\n\n${deliveryContent}`, deliveryOpts);
       } else {
-        await handleDelivery(job, deliveryContent);
+        await handleDelivery(job, deliveryContent, deliveryOpts);
       }
     }
   }
@@ -1008,6 +1012,9 @@ export async function executeShell(job, ctx, deps) {
   result.summary = shellResult.summary;
   result.errorMessage = shellResult.errorMessage;
   result.content = shellResult.deliveryText;
+  if (shellResult.imageAttachments?.length > 0) {
+    result.imageAttachments = shellResult.imageAttachments;
+  }
   result.runFinishFields = {
     context_summary: shellResult.contextSummary,
     shell_exit_code: shellResult.exitCode,

package/jobs.js

@@ -305,17 +305,46 @@ export function validateJobSpec(opts, currentJob = null, mode = 'create') {
   assertEnum('overlap_policy', merged.overlap_policy || 'skip', VALID_OVERLAP_POLICIES);
   assertEnum('delivery_mode', merged.delivery_mode || 'announce', VALID_DELIVERY_MODES);
 
+  // INSERT-only: enforce delivery_to for all non-exempt jobs.
+  // Exempt from this requirement:
+  //   - job_type='watchdog' (internal health monitor jobs)
+  //   - name starts with 'watchdog:' (watchdog jobs by naming convention)
+  //   - session_target='main' (injects into the main session, no chat routing needed)
+  //   - delivery_mode='none' (explicitly opted out of delivery)
+  if (mode === 'create') {
+    const _target = merged.session_target || 'isolated';
+    const _dmode = merged.delivery_mode || 'announce';
+    const _type = merged.job_type || 'standard';
+    const _name = String(merged.name || '');
+    const _isExempt =
+      _type === 'watchdog' ||
+      _name.startsWith('watchdog:') ||
+      _target === 'main' ||
+      _dmode === 'none';
+    if (!_isExempt && (!merged.delivery_to || String(merged.delivery_to).trim() === '')) {
+      throw new Error(
+        'delivery_to is required on job insert. Set it to the origin chat_id ' +
+        '(e.g. -5240776892 for AI Assisted Degeneracy, or 484946046 for Alex DM).'
+      );
+    }
+  }
+
   // Enforce: delivery_to is required when delivery_mode is explicitly set to
   // 'announce' or 'announce-always'. Validates on create (when delivery_mode is
   // explicitly provided) and on update (when delivery_mode is being changed or
   // the merged record would end up in announce mode without a delivery_to).
+  // Exempt: watchdog jobs, session_target='main' (no external chat routing needed).
   {
     const modeExplicitlySet = 'delivery_mode' in normalized;
     const deliveryToExplicitlySet = 'delivery_to' in normalized;
     const effectiveMode = merged.delivery_mode || 'announce';
     const isAnnounceMode = ['announce', 'announce-always'].includes(effectiveMode);
+    const _announceExempt =
+      (merged.job_type || 'standard') === 'watchdog' ||
+      String(merged.name || '').startsWith('watchdog:') ||
+      (merged.session_target || 'isolated') === 'main';
 
-    if (isAnnounceMode && (mode === 'create' || modeExplicitlySet || deliveryToExplicitlySet)) {
+    if (isAnnounceMode && !_announceExempt && (mode === 'create' || modeExplicitlySet || deliveryToExplicitlySet)) {
       // Re-evaluate: if mode is being set to announce OR delivery_to is being
       // cleared on an announce-mode job, check the merged delivery_to is present.
       if (!merged.delivery_to || (typeof merged.delivery_to === 'string' && merged.delivery_to.trim() === '')) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-scheduler",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "SQLite-backed job scheduler and workflow engine for OpenClaw agents",
   "type": "module",
   "main": "./index.js",

package/scheduler-schema.js

@@ -22,7 +22,9 @@ export const SCHEDULER_SCHEMAS = {
       max_trigger_fanout: { type: 'integer', min: 1, default: 25 },
       delivery_mode: { type: 'string', enum: ['announce', 'announce-always', 'none'], default: 'announce' },
       delivery_channel: { type: 'string', nullable: true },
-      delivery_to: { type: 'string', nullable: true },
+      // REQUIRED on insert for non-exempt jobs. Exempt: job_type='watchdog', name starts with 'watchdog:',
+      // session_target='main', or delivery_mode='none'. Set to the origin chat_id so results reach the right chat.
+      delivery_to: { type: 'string', nullable: true, required: 'non-system jobs', description: 'Target chat/user id for delivery (e.g. telegram chat_id). Required on insert for non-system jobs.' },
       parent_id: { type: 'string', nullable: true },
       trigger_on: { type: 'string', enum: ['success', 'failure', 'complete'], nullable: true },
       trigger_delay_s: { type: 'integer', min: 0, default: 0 },
@@ -38,8 +40,8 @@ export const SCHEDULER_SCHEMAS = {
       context_retrieval: { type: 'string', enum: ['none', 'recent', 'hybrid'], default: 'none' },
       context_retrieval_limit: { type: 'integer', min: 1, default: 5 },
       output_store_limit_bytes: { type: 'integer', min: 128, default: 65536 },
-      output_excerpt_limit_bytes: { type: 'integer', min: 64, default: 2000 },
-      output_summary_limit_bytes: { type: 'integer', min: 64, default: 5000 },
+      output_excerpt_limit_bytes: { type: 'integer', min: 64, default: 65536 },
+      output_summary_limit_bytes: { type: 'integer', min: 64, default: 65536 },
       output_offload_threshold_bytes: { type: 'integer', min: 128, default: 65536 },
       preferred_session_key: { type: 'string', nullable: true },
       auth_profile: { type: 'string', nullable: true, description: 'Auth profile override: null=default, "inherit"=main session profile, or "provider:label"' },

package/schema.sql

@@ -81,8 +81,8 @@ CREATE TABLE IF NOT EXISTS jobs (
 
   -- Output handling (v14)
   output_store_limit_bytes INTEGER NOT NULL DEFAULT 65536,
-  output_excerpt_limit_bytes INTEGER NOT NULL DEFAULT 2000,
-  output_summary_limit_bytes INTEGER NOT NULL DEFAULT 5000,
+  output_excerpt_limit_bytes INTEGER NOT NULL DEFAULT 65536,
+  output_summary_limit_bytes INTEGER NOT NULL DEFAULT 65536,
   output_offload_threshold_bytes INTEGER NOT NULL DEFAULT 65536,
 
   -- Session continuity (v9)

package/scripts/inbox-consumer.mjs

@@ -118,7 +118,7 @@ function formatMessageForDelivery(msg, { brand = 'Scheduler' } = {}) {
   const subject = msg.subject || 'Notification';
   const header = `${brand} | ${subject} | ${age}`;
 
-  return `${header}\n\n${body}`.slice(0, 4000);
+  return `${header}\n\n${body}`;
 }
 
 /**

package/shell-result.js

@@ -4,8 +4,8 @@ import { getResolvedDbPath } from './db.js';
 import { ensureArtifactsDir, resolveArtifactsDir } from './paths.js';
 
 export const DEFAULT_STORE_LIMIT = 64 * 1024;
-export const DEFAULT_EXCERPT_LIMIT = 2000;
-export const DEFAULT_SUMMARY_LIMIT = 5000;
+export const DEFAULT_EXCERPT_LIMIT = 64 * 1024;
+export const DEFAULT_SUMMARY_LIMIT = 64 * 1024;
 export const DEFAULT_OFFLOAD_THRESHOLD = 64 * 1024;
 
 function toText(value) {
@@ -92,7 +92,24 @@ export function normalizeShellResult(
     artifactsDir = resolveArtifactsDir({ dbPath: getResolvedDbPath() }),
   } = {}
 ) {
-  const stdoutText = toText(stdout);
+  const rawStdout = toText(stdout);
+
+  // Extract [IMAGE:path] markers from stdout before processing.
+  // Scripts can signal image attachments by writing lines like:
+  //   [IMAGE:/tmp/chart.png]
+  //   [IMAGE:/tmp/report.pdf]
+  // Extracted paths are passed through to the delivery layer.
+  const IMAGE_MARKER_RE = /^\[IMAGE:(\/[^\]\n]+)\]$/gm;
+  const imageAttachments = [];
+  let match;
+  while ((match = IMAGE_MARKER_RE.exec(rawStdout)) !== null) {
+    imageAttachments.push(match[1]);
+  }
+  // Strip markers from stdout so they don't appear in delivery text
+  const stdoutText = imageAttachments.length > 0
+    ? rawStdout.replace(IMAGE_MARKER_RE, '').replace(/\n{3,}/g, '\n\n').trim()
+    : rawStdout;
+
   const stderrText = toText(stderr);
   const stdoutBytes = textBytes(stdoutText);
   const stderrBytes = textBytes(stderrText);
@@ -144,6 +161,7 @@ export function normalizeShellResult(
     stderrTruncated: stderrStored.truncated,
     summary: truncateText(previewText, summaryLimit).text,
     deliveryText: previewText,
+    imageAttachments,
     errorMessage,
     contextSummary: {
       shell_result: {