feat(web): add the Agents panel (4/5)

[shivamhwp]

Fourth of five stacked PRs replacing #4551. Stacked on #4662 — review that first.

Surfaces the subagent data the previous PRs record. A new right-panel tab lists every subagent on the thread with its role, model, status, token usage, recent activity, and the runs it has been activated for. Read-only — it renders what the projection already contains.

Grouping lives in client-runtime rather than the component so it stays testable: workflow coordinators own their phases, phase status derives from its members, and members orphaned by a missing coordinator fall back to the flat list rather than disappearing.

Coordinators are agents too

A workflow coordinator has its own model, usage and activations, and before its members are spawned it is the only row on the thread. So it renders as a card rather than a bare heading, and it is counted in the tallies — but only while it has no members, since afterwards they represent the same work and counting both double-reports it.

Without that, a thread running a workflow showed 0 active · 0 waiting · 0 settled with nothing listed, and unexplained tokens in the header.

Token accounting

Same rule: the total keeps whatever the members did not account for. Dropping the coordinator outright erased the entire workflow whenever a provider reported workflow usage while omitting per-agent tokens — the header then read "Usage unavailable" for a workflow that had spent thousands. Both fields are populated independently in the Claude adapter, so this is reachable, not theoretical.

Testing

Typecheck and lint clean. Web 1,500 passing, client-runtime 486 passing.

Verified in a browser against a real Codex subagent run: the tab renders the agent with its role and model badges, idle status, a real token count and run count, and an expandable "Activity and runs" section.

Reviewed by an independent agent pass; the token-collapse bug and the missing coordinator card both came out of it and are fixed here.

Note

The workflow path itself (phases, coordinators) is Claude-only — no other adapter emits kind: "workflow" — so that branch has unit coverage but has not been exercised against a live provider.

---

Note

Low Risk
Read-only UI over existing projection data with no auth or persistence changes; layout tweaks are localized to the right panel.

Overview
Adds a read-only Agents right-panel surface that lists orchestration V2 subagents from the thread projection—roles, models, status, token usage, runs, and recent activity.

deriveOrchestrationV2SubagentPanelState in client-runtime groups agents by workflow and phase, indexes activations, and aggregates tokens without double-counting coordinators when members report usage. Coordinators without members still count as active and render as cards (not bare headings); settled agents prefer result over stale progress.

ChatView lazy-loads AgentsPanelV2, opens the agents singleton via the tab bar + menu, and passes serverProjection. Right panel chrome moves maximize into the tab bar layoutControls instead of the main title bar when the panel is open.

^{Reviewed by Cursor Bugbot for commit b1bc757. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add Agents panel to the right panel UI for orchestration V2 subagents

• Adds AgentsPanelV2 component that groups subagents by workflow/phase, shows a coordinator card, per-member AgentCard components with collapsible activity/activations, and a header with total token usage and active/waiting/settled counts.
• Adds deriveOrchestrationV2SubagentPanelState to derive structured panel state from raw subagent data, including phase ordering, activation indexing, and token aggregation that avoids double-counting workflow coordinators.
• Registers 'agents' as a new singleton surface kind in rightPanelStore.ts and wires it into ChatView and RightPanelTabs so users can open the panel from the + menu or empty state.
• Moves the right panel maximize control into the tab bar layout controls instead of the main title bar when the panel is open.

^{Macroscope summarized b1bc757.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 974dd6ca-8529-4d41-828f-6336d20e5405

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch subagent-obs/04-agents-panel

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[macroscopeapp]

Approvability

Verdict: Needs human review

This PR introduces a new user-facing feature (Agents panel) with substantial new UI logic and state derivation code. New features with new components and non-trivial business logic warrant human review.

No code changes detected at b1bc757. Prior analysis still applies.

^{You can customize Macroscope's approvability policy. Learn more.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit b1bc757. Configure here.}

[cursor]

Token total exceeds workflow usage

Medium Severity

When per-member usage.totalTokens sum to more than the workflow coordinator’s inclusive total, reportedUsage drops the coordinator contribution entirely but still adds each member’s full usage, so the Agents header can over-report tokens relative to the workflow aggregate the derivation assumes is authoritative.

 

^{Reviewed by Cursor Bugbot for commit b1bc757. Configure here.}