Skip to content

docs(adr): basic cronjob support#591

Merged
thepagent merged 9 commits intomainfrom
adr/basic-cronjob
Apr 27, 2026
Merged

docs(adr): basic cronjob support#591
thepagent merged 9 commits intomainfrom
adr/basic-cronjob

Conversation

@chaodu-agent
Copy link
Copy Markdown
Collaborator

@chaodu-agent chaodu-agent commented Apr 27, 2026

Summary

Proposes config-driven [[cronjobs]] in config.toml as Phase 1 for scheduled message support in OAB.

Motivation

Users want simple recurring prompts (daily summaries, weekly reports) without setting up external infrastructure. At the same time, we want to avoid the "in-app cronjob" pattern (agent self-configuring cron) which has known opacity and reliability issues.

Design

  • Declarative cron expressions in config.toml
  • Lightweight internal scheduler evaluates expressions once per minute
  • Fires message into existing session pool as if a user typed it
  • Reply posted to target channel via normal platform adapter
  • Stateless, restart-safe, fire-and-forget on failure

Explicitly Out of Scope

  • Agent self-configuring cron (Lobster lesson)
  • Retries, conditional logic, DAGs
  • Runtime API for cron management

Complex use cases should use external schedulers (K8s CronJob, GitHub Actions).

References

DC: https://discord.com/channels/1491295327620169908/1491365150664560881/1498150170574192710

Propose config-driven [[cronjobs]] in config.toml as Phase 1 for
scheduled message support. Covers cron expression evaluation,
session injection, failure handling, and Helm mapping.

Explicitly out of scope: agent self-configuration, retries,
conditional logic, DAGs (deferred to external schedulers).
@chaodu-agent chaodu-agent requested a review from thepagent as a code owner April 27, 2026 03:21
@github-actions github-actions Bot added pending-screening PR awaiting automated screening closing-soon PR missing Discord Discussion URL — will auto-close in 3 days labels Apr 27, 2026
@thepagent thepagent marked this pull request as draft April 27, 2026 03:28
@thepagent thepagent added p1 High — address this sprint ADR and removed closing-soon PR missing Discord Discussion URL — will auto-close in 3 days pending-screening PR awaiting automated screening labels Apr 27, 2026
@thepagent thepagent marked this pull request as ready for review April 27, 2026 03:46
@github-actions github-actions Bot added closing-soon PR missing Discord Discussion URL — will auto-close in 3 days and removed closing-soon PR missing Discord Discussion URL — will auto-close in 3 days labels Apr 27, 2026
@thepagent thepagent merged commit 1d4d414 into main Apr 27, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ADR p1 High — address this sprint

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants