crons.yaml

# Cron job definitions — loaded by cron-runner.ts
# All times use the machine's local timezone
#
# This file ships upstream example crons (all disabled by default).
# For your own crons, create crons.local.yaml alongside this file.
# Crons in crons.local.yaml extend this file; duplicate names are overridden by local.
#
# Field reference:
#   name              (string, required)  Unique identifier for the cron job
#   schedule          (string, required)  Cron expression (5-field), local timezone
#   type              ("llm"|"script")    "llm" (default) runs claude -p with prompt; "script" runs a shell command
#   prompt            (string)            Prompt text sent to Claude (required for type: llm)
#   command           (string)            Shell command to execute (required for type: script)
#   agentId           (string, required)  Must match an agent in config.yaml (determines workspace)
#   deliveryChatId    (number)            Telegram chat ID for result delivery (falls back to config default)
#   deliveryThreadId  (number)            Telegram forum topic ID for delivery (falls back to config default)
#   timeout           (number)            Per-cron timeout in milliseconds (default: 300000 = 5 min)
#   enabled           (boolean)           Set false to skip plist generation for this cron (default: true)
#
# Script-mode crons execute via /bin/bash, capture stdout, and deliver like LLM crons.
# They skip all Claude-specific setup (model, workspace, env vars). Empty output skips delivery.

crons:
  # Weekly workspace health check (uses /workspace-health skill)
  - name: workspace-health
    enabled: false
    schedule: "0 10 * * 1"            # Monday 10:00 AM
    prompt: /workspace-health
    agentId: main
    timeout: 600000                   # 10 minutes — AI stages need extra time

  # Nightly memory consolidation — crystallizes session transcripts into persistent memory
  - name: memory-consolidation
    enabled: false
    schedule: "0 2 * * *"             # 2:00 AM daily
    prompt: /memory-consolidation
    agentId: main
    timeout: 600000                   # 10 minutes — AI processing may be slow
    deliveryThreadId: 42              # optional: Telegram forum topic ID

  # Script-mode example — runs a shell command directly (no LLM)
  # - name: backup-db
  #   enabled: false
  #   schedule: "0 3 * * *"
  #   type: script
  #   command: "/usr/bin/backup.sh --full"
  #   agentId: main
  #   timeout: 300000