Application session listing
This specification defines the application-layer session-list contract owned
by core/python/agent_app.
It covers:
- opaque live-session discovery and exact summary lookup;
- shared summary, presentation, ordering, filtering, and diagnostic behavior;
- application-plugin contributions to session summaries;
- summary validity and invalidation;
- complete membership when some session contents are slow or unavailable;
- cross-runtime reuse of derived summaries;
- bounded foreground full resolution after file-attribute enumeration;
- private background resolution, persistence, concurrency, and lifecycle behavior;
- implementation independence behind
SessionListService.
It does not define frontend list rendering, frontend refresh behavior, the Sessions action menu, session snapshot listing, or generic application configuration composition.
Specification documents:
Decision record:
Related specifications:
- Application configuration composition
- Session and message data query
- Application runtime reload
- Sessions actions
Current consumer documentation: