import { Command } from "commander"; import { describe, expect, it, vi } from "vitest"; const defaultGatewayMock = async ( method: string, _opts: unknown, params?: unknown, _timeoutMs?: number, ) => { if (method === "cron.status") { return { enabled: true }; } return { ok: true, params }; }; const callGatewayFromCli = vi.fn(defaultGatewayMock); vi.mock("./gateway-rpc.js", async () => { const actual = await vi.importActual("./gateway-rpc.js"); return { ...actual, callGatewayFromCli: (method: string, opts: unknown, params?: unknown, extra?: unknown) => callGatewayFromCli(method, opts, params, extra as number | undefined), }; }); vi.mock("../runtime.js", () => ({ defaultRuntime: { log: vi.fn(), error: vi.fn(), exit: (code: number) => { throw new Error(`__exit__:${code}`); }, }, })); const { registerCronCli } = await import("./cron-cli.js"); type CronUpdatePatch = { patch?: { payload?: { message?: string }; delivery?: { mode?: string; channel?: string; to?: string; bestEffort?: boolean }; }; }; function buildProgram() { const program = new Command(); program.exitOverride(); registerCronCli(program); return program; } function resetGatewayMock() { callGatewayFromCli.mockReset(); callGatewayFromCli.mockImplementation(defaultGatewayMock); } async function runCronEditAndGetPatch(editArgs: string[]): Promise { resetGatewayMock(); const program = buildProgram(); await program.parseAsync(["cron", "edit", "job-1", ...editArgs], { from: "user" }); const updateCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.update"); return (updateCall?.[2] ?? {}) as CronUpdatePatch; } describe("cron cli", () => { it("trims model and thinking on cron add", { timeout: 60_000 }, async () => { resetGatewayMock(); const program = buildProgram(); await program.parseAsync( [ "cron", "add", "--name", "Daily", "--cron", "* * * * *", "--session", "isolated", "--message", "hello", "--model", " opus ", "--thinking", " low ", ], { from: "user" }, ); const addCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.add"); const params = addCall?.[2] as { payload?: { model?: string; thinking?: string }; }; expect(params?.payload?.model).toBe("opus"); expect(params?.payload?.thinking).toBe("low"); }); it("defaults isolated cron add to announce delivery", async () => { resetGatewayMock(); const program = buildProgram(); await program.parseAsync( [ "cron", "add", "--name", "Daily", "--cron", "* * * * *", "--session", "isolated", "--message", "hello", ], { from: "user" }, ); const addCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.add"); const params = addCall?.[2] as { delivery?: { mode?: string } }; expect(params?.delivery?.mode).toBe("announce"); }); it("infers sessionTarget from payload when --session is omitted", async () => { resetGatewayMock(); const program = buildProgram(); await program.parseAsync( ["cron", "add", "--name", "Main reminder", "--cron", "* * * * *", "--system-event", "hi"], { from: "user" }, ); let addCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.add"); let params = addCall?.[2] as { sessionTarget?: string; payload?: { kind?: string } }; expect(params?.sessionTarget).toBe("main"); expect(params?.payload?.kind).toBe("systemEvent"); resetGatewayMock(); await program.parseAsync( ["cron", "add", "--name", "Isolated task", "--cron", "* * * * *", "--message", "hello"], { from: "user" }, ); addCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.add"); params = addCall?.[2] as { sessionTarget?: string; payload?: { kind?: string } }; expect(params?.sessionTarget).toBe("isolated"); expect(params?.payload?.kind).toBe("agentTurn"); }); it("supports --keep-after-run on cron add", async () => { resetGatewayMock(); const program = buildProgram(); await program.parseAsync( [ "cron", "add", "--name", "Keep me", "--at", "20m", "--session", "main", "--system-event", "hello", "--keep-after-run", ], { from: "user" }, ); const addCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.add"); const params = addCall?.[2] as { deleteAfterRun?: boolean }; expect(params?.deleteAfterRun).toBe(false); }); it("sends agent id on cron add", async () => { resetGatewayMock(); const program = buildProgram(); await program.parseAsync( [ "cron", "add", "--name", "Agent pinned", "--cron", "* * * * *", "--session", "isolated", "--message", "hi", "--agent", "ops", ], { from: "user" }, ); const addCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.add"); const params = addCall?.[2] as { agentId?: string }; expect(params?.agentId).toBe("ops"); }); it("omits empty model and thinking on cron edit", async () => { resetGatewayMock(); const program = buildProgram(); await program.parseAsync( ["cron", "edit", "job-1", "--message", "hello", "--model", " ", "--thinking", " "], { from: "user" }, ); const updateCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.update"); const patch = updateCall?.[2] as { patch?: { payload?: { model?: string; thinking?: string } }; }; expect(patch?.patch?.payload?.model).toBeUndefined(); expect(patch?.patch?.payload?.thinking).toBeUndefined(); }); it("trims model and thinking on cron edit", async () => { resetGatewayMock(); const program = buildProgram(); await program.parseAsync( [ "cron", "edit", "job-1", "--message", "hello", "--model", " opus ", "--thinking", " high ", ], { from: "user" }, ); const updateCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.update"); const patch = updateCall?.[2] as { patch?: { payload?: { model?: string; thinking?: string } }; }; expect(patch?.patch?.payload?.model).toBe("opus"); expect(patch?.patch?.payload?.thinking).toBe("high"); }); it("sets and clears agent id on cron edit", async () => { resetGatewayMock(); const program = buildProgram(); await program.parseAsync(["cron", "edit", "job-1", "--agent", " Ops ", "--message", "hello"], { from: "user", }); const updateCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.update"); const patch = updateCall?.[2] as { patch?: { agentId?: unknown } }; expect(patch?.patch?.agentId).toBe("ops"); resetGatewayMock(); await program.parseAsync(["cron", "edit", "job-2", "--clear-agent"], { from: "user", }); const clearCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.update"); const clearPatch = clearCall?.[2] as { patch?: { agentId?: unknown } }; expect(clearPatch?.patch?.agentId).toBeNull(); }); it("allows model/thinking updates without --message", async () => { resetGatewayMock(); const program = buildProgram(); await program.parseAsync(["cron", "edit", "job-1", "--model", "opus", "--thinking", "low"], { from: "user", }); const updateCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.update"); const patch = updateCall?.[2] as { patch?: { payload?: { kind?: string; model?: string; thinking?: string } }; }; expect(patch?.patch?.payload?.kind).toBe("agentTurn"); expect(patch?.patch?.payload?.model).toBe("opus"); expect(patch?.patch?.payload?.thinking).toBe("low"); }); it("updates delivery settings without requiring --message", async () => { resetGatewayMock(); const program = buildProgram(); await program.parseAsync( ["cron", "edit", "job-1", "--deliver", "--channel", "telegram", "--to", "19098680"], { from: "user" }, ); const updateCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.update"); const patch = updateCall?.[2] as { patch?: { payload?: { kind?: string; message?: string }; delivery?: { mode?: string; channel?: string; to?: string }; }; }; expect(patch?.patch?.payload?.kind).toBe("agentTurn"); expect(patch?.patch?.delivery?.mode).toBe("announce"); expect(patch?.patch?.delivery?.channel).toBe("telegram"); expect(patch?.patch?.delivery?.to).toBe("19098680"); expect(patch?.patch?.payload?.message).toBeUndefined(); }); it("supports --no-deliver on cron edit", async () => { resetGatewayMock(); const program = buildProgram(); await program.parseAsync(["cron", "edit", "job-1", "--no-deliver"], { from: "user" }); const updateCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.update"); const patch = updateCall?.[2] as { patch?: { payload?: { kind?: string }; delivery?: { mode?: string } }; }; expect(patch?.patch?.payload?.kind).toBe("agentTurn"); expect(patch?.patch?.delivery?.mode).toBe("none"); }); it("does not include undefined delivery fields when updating message", async () => { resetGatewayMock(); const program = buildProgram(); // Update message without delivery flags - should NOT include undefined delivery fields await program.parseAsync(["cron", "edit", "job-1", "--message", "Updated message"], { from: "user", }); const updateCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.update"); const patch = updateCall?.[2] as { patch?: { payload?: { message?: string; deliver?: boolean; channel?: string; to?: string; bestEffortDeliver?: boolean; }; delivery?: unknown; }; }; // Should include the new message expect(patch?.patch?.payload?.message).toBe("Updated message"); // Should NOT include delivery fields at all (to preserve existing values) expect(patch?.patch?.payload).not.toHaveProperty("deliver"); expect(patch?.patch?.payload).not.toHaveProperty("channel"); expect(patch?.patch?.payload).not.toHaveProperty("to"); expect(patch?.patch?.payload).not.toHaveProperty("bestEffortDeliver"); expect(patch?.patch).not.toHaveProperty("delivery"); }); it("includes delivery fields when explicitly provided with message", async () => { const patch = await runCronEditAndGetPatch([ "--message", "Updated message", "--deliver", "--channel", "telegram", "--to", "19098680", ]); // Should include everything expect(patch?.patch?.payload?.message).toBe("Updated message"); expect(patch?.patch?.delivery?.mode).toBe("announce"); expect(patch?.patch?.delivery?.channel).toBe("telegram"); expect(patch?.patch?.delivery?.to).toBe("19098680"); }); it("includes best-effort delivery when provided with message", async () => { const patch = await runCronEditAndGetPatch([ "--message", "Updated message", "--best-effort-deliver", ]); expect(patch?.patch?.payload?.message).toBe("Updated message"); expect(patch?.patch?.delivery?.mode).toBe("announce"); expect(patch?.patch?.delivery?.bestEffort).toBe(true); }); it("includes no-best-effort delivery when provided with message", async () => { const patch = await runCronEditAndGetPatch([ "--message", "Updated message", "--no-best-effort-deliver", ]); expect(patch?.patch?.payload?.message).toBe("Updated message"); expect(patch?.patch?.delivery?.mode).toBe("announce"); expect(patch?.patch?.delivery?.bestEffort).toBe(false); }); it("sets explicit stagger for cron add", async () => { resetGatewayMock(); const program = buildProgram(); await program.parseAsync( [ "cron", "add", "--name", "staggered", "--cron", "0 * * * *", "--stagger", "45s", "--session", "main", "--system-event", "tick", ], { from: "user" }, ); const addCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.add"); const params = addCall?.[2] as { schedule?: { kind?: string; staggerMs?: number } }; expect(params?.schedule?.kind).toBe("cron"); expect(params?.schedule?.staggerMs).toBe(45_000); }); it("sets exact cron mode on add", async () => { resetGatewayMock(); const program = buildProgram(); await program.parseAsync( [ "cron", "add", "--name", "exact", "--cron", "0 * * * *", "--exact", "--session", "main", "--system-event", "tick", ], { from: "user" }, ); const addCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.add"); const params = addCall?.[2] as { schedule?: { kind?: string; staggerMs?: number } }; expect(params?.schedule?.kind).toBe("cron"); expect(params?.schedule?.staggerMs).toBe(0); }); it("rejects --stagger with --exact on add", async () => { resetGatewayMock(); const program = buildProgram(); await expect( program.parseAsync( [ "cron", "add", "--name", "invalid", "--cron", "0 * * * *", "--stagger", "1m", "--exact", "--session", "main", "--system-event", "tick", ], { from: "user" }, ), ).rejects.toThrow("__exit__:1"); }); it("rejects --stagger when schedule is not cron", async () => { resetGatewayMock(); const program = buildProgram(); await expect( program.parseAsync( [ "cron", "add", "--name", "invalid", "--every", "10m", "--stagger", "30s", "--session", "main", "--system-event", "tick", ], { from: "user" }, ), ).rejects.toThrow("__exit__:1"); }); it("sets explicit stagger for cron edit", async () => { resetGatewayMock(); const program = buildProgram(); await program.parseAsync(["cron", "edit", "job-1", "--cron", "0 * * * *", "--stagger", "30s"], { from: "user", }); const updateCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.update"); const patch = updateCall?.[2] as { patch?: { schedule?: { kind?: string; staggerMs?: number } }; }; expect(patch?.patch?.schedule?.kind).toBe("cron"); expect(patch?.patch?.schedule?.staggerMs).toBe(30_000); }); it("applies --exact to existing cron job without requiring --cron on edit", async () => { resetGatewayMock(); callGatewayFromCli.mockImplementation( async (method: string, _opts: unknown, params?: unknown) => { if (method === "cron.status") { return { enabled: true }; } if (method === "cron.list") { return { ok: true, params: {}, jobs: [ { id: "job-1", schedule: { kind: "cron", expr: "0 */2 * * *", tz: "UTC", staggerMs: 300_000 }, }, ], }; } return { ok: true, params }; }, ); const program = buildProgram(); await program.parseAsync(["cron", "edit", "job-1", "--exact"], { from: "user" }); const updateCall = callGatewayFromCli.mock.calls.find((call) => call[0] === "cron.update"); const patch = updateCall?.[2] as { patch?: { schedule?: { kind?: string; expr?: string; tz?: string; staggerMs?: number } }; }; expect(patch?.patch?.schedule).toEqual({ kind: "cron", expr: "0 */2 * * *", tz: "UTC", staggerMs: 0, }); }); it("rejects --exact on edit when existing job is not cron", async () => { resetGatewayMock(); callGatewayFromCli.mockImplementation( async (method: string, _opts: unknown, params?: unknown) => { if (method === "cron.status") { return { enabled: true }; } if (method === "cron.list") { return { ok: true, params: {}, jobs: [{ id: "job-1", schedule: { kind: "every", everyMs: 60_000 } }], }; } return { ok: true, params }; }, ); const program = buildProgram(); await expect( program.parseAsync(["cron", "edit", "job-1", "--exact"], { from: "user" }), ).rejects.toThrow("__exit__:1"); }); });