feat(cron): enhance delivery modes and job configuration

- Updated isolated cron jobs to support new delivery modes: `announce` and `none`, improving output management.
- Refactored job configuration to remove legacy fields and streamline delivery settings.
- Enhanced the `CronJobEditor` UI to reflect changes in delivery options, including a new segmented control for delivery mode selection.
- Updated documentation to clarify the new delivery configurations and their implications for job execution.
- Improved tests to validate the new delivery behavior and ensure backward compatibility with legacy settings.

This update provides users with greater flexibility in managing how isolated jobs deliver their outputs, enhancing overall usability and clarity in job configurations.

src/cron/service.store.migration.test.ts

@@ -0,0 +1,101 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { loadCronStore } from "../store.js";
+import { CronService } from "./service.js";
+
+const noopLogger = {
+  debug: vi.fn(),
+  info: vi.fn(),
+  warn: vi.fn(),
+  error: vi.fn(),
+};
+
+async function makeStorePath() {
+  const dir = await fs.mkdtemp(path.join(os.tmpdir(), "openclaw-cron-migrate-"));
+  return {
+    dir,
+    storePath: path.join(dir, "cron", "jobs.json"),
+    cleanup: async () => {
+      await fs.rm(dir, { recursive: true, force: true });
+    },
+  };
+}
+
+describe("cron store migration", () => {
+  beforeEach(() => {
+    noopLogger.debug.mockClear();
+    noopLogger.info.mockClear();
+    noopLogger.warn.mockClear();
+    noopLogger.error.mockClear();
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  it("migrates isolated jobs to announce delivery and drops isolation", async () => {
+    const store = await makeStorePath();
+    const atMs = 1_700_000_000_000;
+    const legacyJob = {
+      id: "job-1",
+      agentId: undefined,
+      name: "Legacy job",
+      description: null,
+      enabled: true,
+      deleteAfterRun: false,
+      createdAtMs: 1_700_000_000_000,
+      updatedAtMs: 1_700_000_000_000,
+      schedule: { kind: "at", atMs },
+      sessionTarget: "isolated",
+      wakeMode: "next-heartbeat",
+      payload: {
+        kind: "agentTurn",
+        message: "hi",
+        deliver: true,
+        channel: "telegram",
+        to: "7200373102",
+        bestEffortDeliver: true,
+      },
+      isolation: { postToMainPrefix: "Cron" },
+      state: {},
+    };
+    await fs.mkdir(path.dirname(store.storePath), { recursive: true });
+    await fs.writeFile(store.storePath, JSON.stringify({ version: 1, jobs: [legacyJob] }, null, 2));
+
+    const cron = new CronService({
+      storePath: store.storePath,
+      cronEnabled: true,
+      log: noopLogger,
+      enqueueSystemEvent: vi.fn(),
+      requestHeartbeatNow: vi.fn(),
+      runIsolatedAgentJob: vi.fn(async () => ({ status: "ok" })),
+    });
+
+    await cron.start();
+    cron.stop();
+
+    const loaded = await loadCronStore(store.storePath);
+    const migrated = loaded.jobs[0] as Record<string, unknown>;
+    expect(migrated.delivery).toEqual({
+      mode: "announce",
+      channel: "telegram",
+      to: "7200373102",
+      bestEffort: true,
+    });
+    expect("isolation" in migrated).toBe(false);
+
+    const payload = migrated.payload as Record<string, unknown>;
+    expect(payload.deliver).toBeUndefined();
+    expect(payload.channel).toBeUndefined();
+    expect(payload.to).toBeUndefined();
+    expect(payload.bestEffortDeliver).toBeUndefined();
+
+    const schedule = migrated.schedule as Record<string, unknown>;
+    expect(schedule.kind).toBe("at");
+    expect(schedule.at).toBe(new Date(atMs).toISOString());
+
+    await store.cleanup();
+  });
+});