Skip to content

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:

Current consumer documentation: