exo-core Internal Modules

Stability Warning: These are internal APIs, subject to change without notice. They are documented here for contributors and advanced users who need to understand the framework’s internals. Do not depend on these APIs in production code — use the public API from exo.* instead.

Overview

The exo._internal package contains the implementation machinery that powers the public exo API. These modules handle message construction, response parsing, execution state tracking, the core run loop, handler abstractions, agent group primitives, nesting support, graph algorithms, and background task management.

Import Pattern

python

from exo._internal.message_builder import build_messages
from exo._internal.output_parser import parse_response
from exo._internal.state import RunState, RunNode, RunNodeStatus
from exo._internal.call_runner import call_runner
from exo._internal.handlers import Handler, AgentHandler, ToolHandler, GroupHandler
from exo._internal.agent_group import ParallelGroup, SerialGroup
from exo._internal.nested import SwarmNode
from exo._internal.graph import Graph, parse_flow_dsl, topological_sort
from exo._internal.background import BackgroundTaskHandler, BackgroundTask, PendingQueue

Note: ParallelGroup, SerialGroup, and SwarmNode are re-exported from exo.__init__ as public API.

Modules

Module	Description
message_builder	Build ordered message lists for LLM provider calls
output_parser	Parse LLM responses into agent-level output types
state	Run state tracking with execution nodes and lifecycle management
call_runner	Core execution loop with state tracking and loop detection
handlers	Handler abstractions for composable agent, tool, and group execution
agent_group	ParallelGroup and SerialGroup execution primitives
nested	SwarmNode for nesting swarms within swarms
graph	Directed graph, topological sort, and flow DSL parser
background	Background task handler with hot-merge and wake-up-merge patterns