Automation
Run AGH agents on schedules, in response to runtime events, or from signed external HTTP requests.
- Audience
- Operators running durable agent work
- Focus
- Automation guidance shaped for scanability, day-two clarity, and operator context.
Automation is the unattended-run surface around three primitives: schedules that fire on a clock, triggers that react to runtime events, and webhooks that accept signed HTTP from outside the daemon. All three resolve to the same dispatcher and produce the same audit trail as interactive sessions.
In this section
Schedules
Jobs and scheduling
Use this page when you need cron, interval, or one-time scheduled agent runs with retry policy and run history.
Reactive
Event triggers
Use this page when the next run should react to runtime events such as session stops or memory consolidation.
Ingress
Webhook activation
Use this page to accept signed HTTP requests from external systems and route them as automation triggers.
Tool and CLI parity
Automation lifecycle is agent-manageable. The agh__automation toolset and the matching
agh automation CLI both reach the same validators and writers:
| Surface | Read tools | Mutation tools | CLI parity |
|---|---|---|---|
| Jobs | agh__automation_jobs_list, agh__automation_jobs_get, agh__automation_jobs_history | agh__automation_jobs_create, agh__automation_jobs_update, agh__automation_jobs_delete, agh__automation_jobs_trigger, agh__automation_jobs_enable, agh__automation_jobs_disable | agh automation jobs ... |
| Triggers | agh__automation_triggers_list, agh__automation_triggers_get, agh__automation_triggers_history | agh__automation_triggers_create, agh__automation_triggers_update, agh__automation_triggers_delete, agh__automation_triggers_enable, agh__automation_triggers_disable | agh automation triggers ... |
| Runs | agh__automation_runs_list, agh__automation_runs_get | — | agh automation runs ... |
Mutations require approval, run through the same domain validators as CLI/HTTP, and reject raw
webhook secrets with deterministic codes including AUTOMATION_SCOPE_FORBIDDEN,
AUTOMATION_SECRET_INPUT_FORBIDDEN, AUTOMATION_VALIDATION_FAILED, and
AUTOMATION_APPROVAL_REQUIRED. Webhook secret material stays write-only on mutation surfaces and is
referenced through webhook_secret_ref.