Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 18 additions & 6 deletions apps/web/src/components/app/docs-sections/events.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -48,10 +48,18 @@ export function EventsContent() {
them to build the activity and active-hours heatmaps, working-time
stats, and the status breakdown chart.
</P>
<P>
Sub agent rows and the <strong>Session details</strong> dialog show
the agent's current state instead of a stale event: an agent that has
stopped reads <strong>Stopped</strong> (or <strong>Error</strong> if
it failed), whatever its last reported event was, and one that hasn't
reported yet reads <strong>Running</strong>. The timestamp next to it
is still the last event's.
</P>
</Section>

<Section>
<H3>Automatic status correction</H3>
<H3 id="status-correction">Automatic status correction</H3>
<P>
Agents don't always report accurately, so Dispatch cross-checks each
running agent's status against its terminal activity. If the terminal
Expand All @@ -69,11 +77,15 @@ export function EventsContent() {
<H3>Configuring agent instructions</H3>
<P>
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 <Code>CLAUDE.md</Code> (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 <strong>Use short startup rules</strong> on
(Settings → Agents → Launch guidance), that rule keeps the timing and
the <Code>blocked</Code> distinction but leaves the list of types to
the <Code>dispatch_event</Code> tool description. To reinforce or
customize the behavior, add instructions to your repo's{" "}
<Code>CLAUDE.md</Code> (or equivalent config) covering the checkpoints
that matter to you: start of turn, phase transitions, and a terminal
event before the final response.
</P>
</Section>
</>
Expand Down
8 changes: 8 additions & 0 deletions apps/web/src/lib/tips/tips.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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 {
Expand Down
Loading