Browse documentation

Technical documentation / Reference

Browse local sessions

Use backend discovery to list saved sessions without reading its storage directly or running a prompt.

Choose a discovery method

Negotiate the method you need during initialization. Follow opaque cursors, including empty progress pages; page length does not prove completion. Restart discovery after a stale revision and discard provisional rows.

Open a result

  1. Show the supplied title, or the exact session ID when no title is available.
  2. Treat busy and unverified-workspace labels as advisory.
  3. Call session.open with the selected exact ID while idle.
  4. Read history using the attachment revision, not the discovery revision.

A failed open leaves the previous attachment unchanged. Keep the client draft unchanged too. Never create a replacement session or replay a prompt just to browse history.

Exact contracts: session.list and incremental discovery.

Archived discovery observations retain revision-specific process evidence and its limits.

Edit this page on GitHub ↗