Skip to content

agent session transcript: download raw transcript files#32

Merged
hbrooks merged 1 commit into
mainfrom
session-transcript
Jul 7, 2026
Merged

agent session transcript: download raw transcript files#32
hbrooks merged 1 commit into
mainfrom
session-transcript

Conversation

@hbrooks

@hbrooks hbrooks commented Jul 7, 2026

Copy link
Copy Markdown
Member

Adds the flat session transcript <sessionId> verb per documents/eng/TRANSCRIPT_DOWNLOAD.md in the monorepo (backend endpoint = ellipsis-dev/ellipsis#5691, which must merge + deploy first).

  • Default: fetch GET /v1/sessions/{id}/transcripts, download the latest process's transcript, gunzip, stream raw JSONL to stdout (pipe-friendly, mirrors session steps).
  • -o <path> file output, --process <id> pick an attempt, --all -d <dir> one file per process, --json metadata only, --gzip raw bytes.
  • write_status: failed warns on stderr and still downloads; storage 404 maps to a log-retention explanation; 403 suggests the presigned URL expired.
  • 5 new tests (fetchTranscript gunzip/gzip/404/warning + API path); bun run typecheck, test (172), build, and a compiled-binary --help smoke all green.

Do not merge/release without Hunter — sequencing: merge #5691, deploy, then this + tag v0.7.0.

Wraps GET /v1/sessions/{id}/transcripts (presigned S3 two-step, like
asset get): default streams the latest process's gunzipped JSONL to
stdout; -o writes a file; --process picks an attempt; --all -d <dir>
downloads every process; --json prints the metadata; --gzip keeps the
raw .jsonl.gz bytes. A failed final write warns on stderr and still
downloads; a retention-deleted object gets a curated 404 message.

Flat verb beside steps/ide/port per the CLI grammar rule (monorepo
architecture skill §7; documents/eng/TRANSCRIPT_DOWNLOAD.md).
@hbrooks hbrooks merged commit 4fe369d into main Jul 7, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant