> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ctrlnode.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Real-time updates

> SignalR, Bridge file events, and live dashboard

## SignalR hub

The web app maintains a SignalR connection to `/hubs/agents`. Push events update:

* **Tasks** board and detail (status, activity)
* **Events** feed (new rows prepended or invalidated)
* **Dashboard** live strip
* **Agents** connectivity (IDLE / RUNNING / OFFLINE)

## Bridge → platform events

When agents write files in the workspace, the Bridge notifies the API. Common paths:

| Path pattern                | Effect                                                                      |
| --------------------------- | --------------------------------------------------------------------------- |
| `tasks/{folder}/output/...` | Output file detected; may advance **Inbox → In progress** and add a message |
| Other workspace files       | File tree refresh for Files / task artifacts                                |

Task completion also arrives via **`task_complete`** (and related) so Done/Blocked/Failed states stay in sync even if a file event was missed.

## Dashboard vs Events page

| Surface            | Use                                      |
| ------------------ | ---------------------------------------- |
| **Dashboard** feed | Quick glance at the latest few items     |
| **Events** page    | Full history, filters, and investigation |

<Tip>
  If the UI looks stale, check **Bridge** connection in the footer banner and open **Events** to see whether commands are reaching the platform.
</Tip>

## Designer live updates

An active **workflow** in the designer may poll or invalidate pipeline events on a short interval while the run is live — use the Events page for cross-project auditing.
