Background mode and triggers

runtime.mode values (schema.Mode): conversation, one_shot, background, pipeline.

Background apps arm runtime.triggers[] (TriggerConfig) and/or tools.channels adapters (see Channels).

Trigger types

type	Fields commonly used
cron	schedule (5-field), message, routing, routing_key
watch	paths / path, message, routing
http	path, method, port, message, routing

yaml

runtime:
  mode: background
  entry_agent: worker
  triggers:
    - id: hourly
      type: cron
      schedule: "0 * * * *"
      message: "Hourly health check."
      routing: broadcast

Session limits: session_mode (mono | multi), max_sessions_per_user, max_concurrent_activations.

Do not confuse file/path watch triggers with fictional watch_start agent tools. Periodic agent checks use background_run(watch=true, ...) or scheduler.schedule.

Related

• Channels
• Background sessions
• scheduler
• App config