Pull Request

Related Issue

N/A — maintainer-directed work; no linked issue required for this PR.

Description

Draft. This branch only adds the plan, docs/workforce-worker-sessions-plan.md. The implementation will follow in the pull requests listed in §8 of the plan.

Problem

A Workforce Session has several workers running in parallel, but the sidebar shows one row and the chat shows the coordinator's view. To follow one worker, people have to open the side panel and read that worker's task log. There is no way to see a worker's whole history as a timeline.

Approach

Show each worker as a row nested under its Session in the sidebar, like sub-sessions in a coding agent. Opening a worker row shows that worker's full timeline: the tasks it was given, its messages, tool calls, approvals, outputs and changed files, across every Run of the Session.

The first version builds worker rows as views over the events the Session already stores (events already carry the worker's agent_id), so nothing new has to be synced or migrated. The plan compares this with real child Sessions and a side-panel-only option, lists the behaviour rules, the Brain endpoints (/runs/{run_id}/agents and an actor_id filter on /runs/{run_id}/events), the renderer and sidebar work, and open questions.

Testing

Not started. This branch only adds the plan document, which passes the repository's Prettier check. Testing will follow §9 of the plan.

Testing Evidence (REQUIRED)

• I have included human-verified testing evidence in this PR.
• This PR includes frontend/UI changes, and I attached screenshot(s) or screen recording(s).
• No frontend/UI changes in this PR.

Not yet available: the branch currently contains only the plan document.

What is the purpose of this pull request?

• Bug fix
• New Feature
• Documentation update
• Other

Contribution Guidelines Acknowledgement

• I have read and agree to the Eigent Contribution Guideline