The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.
App Providers
This directory contains the React context providers that manage the global state and services of the application.
CoreStateProvider
Source: CoreStateProvider.tsx.
Manages the authoritative global state of the application, including user authentication, session tokens, and the application snapshot.
Turn-Boundary Refetch Contract
To ensure that the UI stays in sync with the backend state (especially during onboarding and context gathering), the application follows a refetch-on-turn-end contract:
- Refetch Timing: After every agent reply completes (the
chat_doneevent inChatRuntimeProvider), the application refetches the authoritative user state viauserApi.getMe(). - Debounce: Multiple rapid turn-finalized events within 750ms are collapsed into a single refetch call to avoid unnecessary network traffic.
- Single Source of Truth: The refetched state is merged into the global snapshot using
patchSnapshot. Components should bind to this global snapshot to ensure they reflect the latest backend state without requiring a full remount. - Fire-and-Forget: The refetch operation is non-blocking and fires on a microtask after the chat UI has painted the final response.
ChatRuntimeProvider
Source: ChatRuntimeProvider.tsx.
Manages the live chat state, including message streaming, tool execution timeline, and subagent orchestration. It subscribes to socket events and updates the Redux store.
SocketProvider
Source: SocketProvider.tsx.
Manages the Socket.IO connection to the Rust core, providing the underlying transport for real-time chat events.
Further reading
- Frontend architecture, including the provider chain generated from
App.tsx. - Chat, the feature these providers drive.
app/README.md.