Skip to content

The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.

2.0 KB
Raw Blame

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_done event in ChatRuntimeProvider), the application refetches the authoritative user state via userApi.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