viktor/beadboard
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: document Agent Sessions Hub, Timeline, and API endpoints

Browse source 
Add comprehensive documentation for recent feature additions:

- Agent Sessions Hub (/sessions): Epic-grouped task feed, cross-agent
  communication, productivity metrics, and derived activity engine
- Timeline feature (/timeline): Real-time chronological activity feed
- Complete API reference for all endpoints including agent coordination,
  sessions management, activity streaming, and bead operations

Updated README.md with new feature sections and links.

Covers commits from the last 5 days including:
- feat(skills): beadboard-driver skill (1ae7efb)
- feat(observability): timeline and agent productivity APIs (bfe4f85)
- feat(ui): Social-Dense Agent Sessions Hub (f3558dc)
- feat(logic): derived-activity engine and agent-session protocols (ab05195)

Co-Authored-By: Warp <agent@warp.dev>
This commit is contained in:
Warp 2026-02-16 06:00:47 +00:00
parent 38e7498070
commit 4251bd144b
3 changed files with 428 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

15
README.md
View file

@ -36,6 +36,21 @@ Understand the "Why" and "What's Next".
- **Focus Mode**: Minimizable dependency strip and deep-linking support for sharing exact views.
- **Smart Metadata**: See bead counts, priorities, and status health at a glance.
### 4. Agent Sessions Hub (`/sessions`)
Coordinate multi-agent workflows with social-dense visibility.
- **Epic-Grouped Task Feed**: Tasks organized by parent Epic with session state indicators (active, reviewing, needs_input, stale).
- **Cross-Agent Communication**: Built-in messaging with HANDOFF, BLOCKED, and INFO categories.
- **Agent Productivity Metrics**: Real-time stats showing active tasks, completions, and recent wins.
- **Derived Activity Engine**: O(N) snapshot diffing computes project history on-demand without separate event storage.
- **`bb agent` CLI Integration**: Visualizes data from agent registry, reservations, and mailboxes.
### 5. Chronological Timeline (`/timeline`)
Real-time activity feed for all project events.
- **Live Updates**: Server-Sent Events stream changes instantly.
- **Date Grouping**: Events organized by day (Today, Yesterday, etc.).
- **Polymorphic Cards**: Distinct visual styles for Status, Lifecycle, and Diff events.
- **History Buffer**: Recent events preserved across server restarts.
## 🛠️ Stack
- **Framework**: Next.js 15 (App Router)
- **UI Engine**: React 19 + Framer Motion