Flow reference

A flow is the execution process an agent follows. Flows contain skills, state, event subscriptions, and persona configuration. Each agent can have multiple flows, and the platform routes events to the correct flow based on the event subscription configuration.

This page lists all flows in the Newo Agent Framework (NAF) by agent type.

ConvoAgent flows

ConvoAgent is the primary user-facing AI Employee. Its flows handle all user-facing conversation logic, tool execution, RAG, scheduling, and session management.

Flow	Purpose	Triggering events
`CAMainFlow`	Primary routing flow. Receives `user_message` and routes to the correct processing flow based on conversation state.	`user_message`, `conversation_started`
`CAMessageFlow`	Processes user messages and generates agent responses. Calls Observer, executes skills, manages conversation history.	Routed from `CAMainFlow`
`CAObserverFlow`	Runs the Observer system — analyzes conversation history, generates directives, injects guidance into the next turn.	Triggered per message turn
`CANewoToolCaller`	Monitors for tool call conditions and executes the appropriate tool when triggered.	Triggered by Supervisor detection
`CAThinkFlow`	Extended thinking flow for complex multi-step reasoning before responding.	Triggered by `CAMessageFlow`
`CARagFlow`	Retrieves relevant documents from the AKB using semantic or fuzzy search and injects them into the prompt.	Triggered before generation
`CADataInjectionFlow`	Injects dynamic data from `FetchData()` or external sources into the active prompt context.	Triggered before generation
`CABookingManagementFlow`	Handles booking lifecycle — check availability, create booking, search, cancel, send confirmation.	Triggered by booking tool
`CAScheduleFlow`	Manages scheduling logic — working hours validation, timezone conversion, available slot generation.	Triggered by scheduling tool
`CACalculatorFlow`	Performs arithmetic and formula evaluation (e.g., ASR calculations, pricing).	Triggered by calculator tool
`CABroadcastConversationFlow`	Manages broadcast messaging — sending outbound messages to multiple personas simultaneously.	`broadcast_analyze_conversation`
`CAAssessmentFlow`	Evaluates conversation quality, classifies success, and calculates scoring metrics (OSS, CSS, LSS, ASR).	`session_ended`, `call_ended`
`CAUserManagementFlow`	Handles actor merging and persona unification across channels.	`user_management_event`
`CAExecuteExternalTasksFlow`	Executes external tasks delegated via the Magic API or incoming webhooks.	`magic_api_response`
`CAActionCallTransferFlow`	Executes a live call transfer to a human agent or external number.	Triggered by `transfer_call_tool`
`CAActionCallHangUpFlow`	Ends an active phone call.	Triggered by `end_conversation_tool`
`CAActionCallDefineVoiceMailFlow`	Handles voicemail detection during outbound calls — drops the call or leaves a voicemail.	Triggered by voicemail detection
`CAEndSessionFlow`	Executes end-of-session cleanup: disables follow-up timers, stores session summary, fires `session_ended`.	`conversation_ended`, `call_aborted`
`CAFollowUpFlow`	Manages follow-up timer execution — sends re-engagement messages when the inactivity timer fires.	`follow_up_message` timer event

GeneralManagerAgent flows

GeneralManagerAgent is the system administration agent. It manages outbound calling, lead lists, and AKB configuration.

Flow	Purpose
`GMAMainFlow`	Primary routing flow for system admin tasks.
`GMAOutboundCallerFlow`	Manages the outbound call list — reads lead data, initiates calls via `make_call`, processes call outcomes.
`GMALeadNurtureFlow`	Schedules and triggers follow-up outreach sequences for leads.

EmailWorker flows

EmailWorker handles email sessions triggered by inbound email events.

Flow	Purpose
`EmailWorkerMainFlow`	Processes inbound email events, generates replies, and sends outbound email responses.

SmsWorker flows

SmsWorker handles SMS sessions independently of ConvoAgent.

Flow	Purpose
`SmsWorkerMainFlow`	Processes inbound SMS events, generates replies, and sends outbound SMS responses.

TaskManager flows

TaskManager coordinates background tasks delegated from ConvoAgent.

Flow	Purpose
`TaskManagerMainFlow`	Receives task delegations, executes them, and returns results to the requesting agent.

MagicWorker flows

MagicWorker handles browser automation and external API orchestration tasks.

Flow	Purpose
`MagicWorkerMainFlow`	Processes `magic_browser_command` and `magic_api_command` tasks, executes web actions, and returns `magic_browser_response` / `magic_api_response` events.

MultiLocationAgent flows

MultiLocationAgent routes conversations to the correct location-specific ConvoAgent instance.

Flow	Purpose
`MultiLocationMainFlow`	Validates the user's ZIP code or location input and routes to the matched regional agent.