Feature: Agent Decision Timeline & Replay

Problem

When agents work autonomously—especially in swarm mode—it can be difficult to understand how a task progressed. While the final result is visible, developers have limited insight into why specific decisions were made, when tasks were delegated, or how the execution plan evolved.

This makes debugging, optimization, and trust in autonomous workflows more challenging.

Proposed Solution

Add an optional Decision Timeline that records key execution events during a session.

Example timeline:

• Task received
• Plan generated
• Worker A spawned
• Worker B requested file changes
• Memory retrieved
• Browser tool invoked
• Merge completed
• Final response generated

Each event could optionally expose relevant metadata (tool used, duration, affected files, or spawned agent) and allow replaying the execution flow from the UI.

Alternatives Considered

Existing logs contain useful information but are chronological and low-level. A structured timeline would provide a much clearer overview of the agent's reasoning and coordination without replacing detailed logs.

Additional Context

This would be particularly valuable for long-running sessions, swarm workflows, and self-development mode by making autonomous execution easier to understand, debug, and optimize.

No files, tests, or entry points are named. Start by reviewing the existing chronological logs and the session or UI flow, then define the event metadata and replay scope. Done should mean an optional timeline records the listed execution events and exposes a usable replay view.