sessions: enumerate and inspect prior session transcripts
Nobody has claimed this yet.
- Dominant language
- Go
- Stars
- 152
- Forks
- 16
- Avg merge
- 14h 48m
- Merged PRs (30d)
- 536
Description
Problem
The harness exposes limited run-local child transcript inspection, but it has no first-class surface for enumerating persisted prior main-session transcripts and opening one for inspection. Operators who know a conversation occurred cannot discover its session identifier or review its transcript without finding storage implementation details or already possessing an ID.
Proposed capability
Add a first-class session-transcript inventory and inspection surface that lets applicable clients enumerate persisted sessions and retrieve a bounded, paginated transcript for a selected session.
Acceptance criteria
- An operator can list persisted sessions they are authorized to access without already knowing a session ID.
- List results expose stable session identity plus concise metadata useful for selection, such as workspace, timestamps, state, profile/provider/model where available, and a bounded summary or preview.
- An operator can request a selected session transcript with explicit pagination/bounds; the response preserves message/event ordering and distinguishes unavailable or expired content from an empty transcript.
- The surface respects session-store retention, ownership/access boundaries, and redaction rules; it must not expose child/private session content outside its authorized scope.
- Define consistent behavior for stores that cannot efficiently enumerate or retain transcripts, including capability/error semantics rather than silently returning an incomplete inventory.
- Make the capability available through the relevant API/client surfaces and document the persistence and retention expectations.
Relationship
Related to #801. That issue covers search when an operator remembers the topic but not the session. This issue supplies the browse-and-inspect path: enumerate available sessions, select one, and read its transcript. The two capabilities should share identity, authorization, retention, and pagination semantics.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
No files or tests are named; start by locating the session-store implementation and the relevant API/client surfaces, then compare their identity, authorization, retention, and pagination behavior with #801. Done means authorized clients can enumerate sessions, retrieve bounded ordered transcripts, receive explicit capability or availability errors, and find the persistence and retention expectations documented.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- go, grpc
- Domain
- api, backend, backend-api-design, documentation
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100