Skip to main content
GET
Read what a session changed on disk

Path Parameters

sessionId
string<uuid>
required

The session's id.

Query Parameters

path
string

Filter to one file, by the absolute path this operation reports for it, and serve that file's before content. Without it the answer covers every file the session changed and carries no content at all — a change list stays cheap, and the one file a diff view is opening is the one it asks for. A path this session never changed is an empty answer, not an error.

Maximum string length: 4096
entryId
string<uuid>

Answer for ONE step of the conversation instead of for the session: what the tool call recorded on this entry did to each file it mutated, measured from the restore point taken before that entry to the one taken at it. Both sides are then served (beforeContent and afterContent), because the after side is a moment that has since been edited over and nothing on disk remembers it. It exists because the session-scoped answer above is the wrong one under an old receipt: a file edited five times has one row carrying all five edits, so drawing it under the first receipt credits that call with every line that came after it. An entry whose step mutated nothing is an empty answer, not an error, and a step the host never snapshotted comes back with beforeState "too-large" — nothing was kept — rather than as an empty diff. path and entryId are not combined; entryId wins when both are given.

Response

The files this session changed.

Every file a session changed, in the order the session first met them. Not paginated: the set is bounded by what one conversation's tools actually mutated, and a client that wants one file asks for it by path.

items
object[]
required