Agent Wiring Checklist
Apply when creating new agents or adding capabilities in lib/services/aria/.
Walk through:
- •Which agent handles this? (FollowUpAgent, SentimentAgent, RecoveryAgent, RevenueEngagementAgent, SmsPilot, or new?)
- •What event triggers it? (call_ended, booking_created, form_submit, inbound_sms, cron?)
- •Where does the trigger fire? (vapi-webhook-ultimate.js, sms-handler.js, SequenceEngine, ops-scheduler.js?)
- •What data does the agent need? What tables does it query?
- •What action does it take? (send SMS, update thread state, alert owner, log decision?)
- •What gets logged in aria_orchestration_log? (every agent decision needs a receipt with reasoning)
- •What oversight tier? (Tier 1 auto, Tier 2 supervised with delay, Tier 3 human required)
- •What safety rails? (rate limit, opt-out check, active sequence check, loop prevention?)
Register in AriaAgentOrchestrator.js following existing pattern. All agents must be non-blocking (setImmediate or fire-and-forget with try/catch).