diff --git a/apps/web/src/components/app/docs-sections/events.tsx b/apps/web/src/components/app/docs-sections/events.tsx index 141bbe8a..c08f0650 100644 --- a/apps/web/src/components/app/docs-sections/events.tsx +++ b/apps/web/src/components/app/docs-sections/events.tsx @@ -48,10 +48,18 @@ export function EventsContent() { them to build the activity and active-hours heatmaps, working-time stats, and the status breakdown chart.

+

+ Sub agent rows and the Session details dialog show + the agent's current state instead of a stale event: an agent that has + stopped reads Stopped (or Error if + it failed), whatever its last reported event was, and one that hasn't + reported yet reads Running. The timestamp next to it + is still the last event's. +

-

Automatic status correction

+

Automatic status correction

Agents don't always report accurately, so Dispatch cross-checks each running agent's status against its terminal activity. If the terminal @@ -69,11 +77,15 @@ export function EventsContent() {

Configuring agent instructions

Dispatch already injects startup rules at launch telling the agent - which event types to use and when to emit them, so reporting works - without any setup. To reinforce or customize the behavior, add - instructions to your repo's CLAUDE.md (or equivalent - config) covering the checkpoints that matter to you: start of turn, - phase transitions, and a terminal event before the final response. + what each event type means and when to emit them, so reporting works + without any setup. With Use short startup rules on + (Settings → Agents → Launch guidance), that rule keeps the timing and + the blocked distinction but leaves the list of types to + the dispatch_event tool description. To reinforce or + customize the behavior, add instructions to your repo's{" "} + CLAUDE.md (or equivalent config) covering the checkpoints + that matter to you: start of turn, phase transitions, and a terminal + event before the final response.

diff --git a/apps/web/src/lib/tips/tips.ts b/apps/web/src/lib/tips/tips.ts index 8c962178..d7e7f570 100644 --- a/apps/web/src/lib/tips/tips.ts +++ b/apps/web/src/lib/tips/tips.ts @@ -308,6 +308,14 @@ export const tips: Tip[] = [ since: "0.35.0", surfaces: ["ambient"], }, + { + id: "status-correction", + title: "Status Correction", + body: 'Agent statuses are self-reported, so Dispatch cross-checks them against terminal activity. An expanded card showing "Activity detected" or "No recent activity detected" is that correction, not something the agent reported.', + docsSection: "events#status-correction", + since: "0.21.9", + surfaces: ["ambient"], + }, ]; export function getTipById(id: string): Tip | undefined {