fix(session): add name field and summary section to session list JSON output #1574

Merged

freemo merged 1 commit from fix/session-list-json-output-missing-name-summary into master

2026-04-02 22:04:40 +00:00

freemo commented

2026-04-02 22:04:21 +00:00

Owner

Summary

Fixes #1508 - Adds spec-required name field and summary section to agents session list JSON output.

Problem

The JSON output was missing:

name field in each session entry
summary section with aggregated statistics
Proper field placement (total was at top-level instead of in summary)

Changes

Session Entry

Before:

{
  "id": "01HXM2A6",
  "actor": "local/orchestrator",
  "messages": 6,
  "updated": "2026-02-08T12:44:00Z"
}

After:

{
  "id": "01HXM2A6",
  "name": "weekly-planning",
  "actor": "local/orchestrator",
  "messages": 6,
  "updated": "2026-02-08T12:44:00Z"
}

Summary Section

Added:

"summary": {
  "total": 2,
  "most_recent": "weekly-planning",
  "oldest": "refactor-sprint",
  "total_messages": 20,
  "storage": "0 KB"
}

Implementation Notes

name field shows session name if available, null otherwise
most_recent/oldest show session name if available, otherwise truncated ID (first 8 chars)
storage field is placeholder ("0 KB") - actual storage calculation not implemented yet
Moved total from top-level into summary section per spec

Testing

✅ Lint checks pass (ruff)
✅ Spec alignment verified (docs/specification.md session list section)
✅ JSON structure matches spec requirements
✅ Handles sessions with and without names

Files Modified

src/cleveragents/cli/commands/session.py (+24, -2 lines)

Automated by CleverAgents Bot
Supervisor: Product Builder | Agent: product-builder

## Summary Fixes #1508 - Adds spec-required `name` field and `summary` section to `agents session list` JSON output. ## Problem The JSON output was missing: 1. `name` field in each session entry 2. `summary` section with aggregated statistics 3. Proper field placement (total was at top-level instead of in summary) ## Changes ### Session Entry **Before:** ```json { "id": "01HXM2A6", "actor": "local/orchestrator", "messages": 6, "updated": "2026-02-08T12:44:00Z" } ``` **After:** ```json { "id": "01HXM2A6", "name": "weekly-planning", "actor": "local/orchestrator", "messages": 6, "updated": "2026-02-08T12:44:00Z" } ``` ### Summary Section **Added:** ```json "summary": { "total": 2, "most_recent": "weekly-planning", "oldest": "refactor-sprint", "total_messages": 20, "storage": "0 KB" } ``` ## Implementation Notes - `name` field shows session name if available, `null` otherwise - `most_recent`/`oldest` show session name if available, otherwise truncated ID (first 8 chars) - `storage` field is placeholder ("0 KB") - actual storage calculation not implemented yet - Moved `total` from top-level into `summary` section per spec ## Testing - ✅ Lint checks pass (ruff) - ✅ Spec alignment verified (docs/specification.md session list section) - ✅ JSON structure matches spec requirements - ✅ Handles sessions with and without names ## Files Modified - `src/cleveragents/cli/commands/session.py` (+24, -2 lines) --- **Automated by CleverAgents Bot** Supervisor: Product Builder | Agent: product-builder

Rows
Columns