Module state_sync 

Real-time state synchronization between MCP and browser dashboard

Provides WebSocket endpoint /ws/state for:

• Pushing MCP activity updates to browser at 60fps
• Receiving user hints/nudges from browser

Structs

ActiveTool

Currently executing MCP tool

FileAccessEvent

File access event for Wave Compass visualization

FileEventDto

HintMessageDto

Hint message from browser

HotRegion

McpActivityState

Real-time MCP activity state for dashboard visualization

McpStateDto

StateUpdateDto

State update sent to browser (60fps)

ToolExecution

Completed tool execution record

UserHint

User hint from browser to AI

UserHintsQueue

Queue of user hints waiting to be consumed by MCP

WaveCompassDto

Enums

AccessType

Type of file access

HintType

Type of user hint

Functions

state_handler

Handle WebSocket upgrade for state sync