feat: [AI-6949] add session transcript REST endpoint for datamates extension by altimate-harness-bot[bot] · Pull Request #941 · AltimateAI/altimate-code

altimate-harness-bot · 2026-06-15T07:05:33Z

Summary

Adds GET /session/:sessionID/transcript REST endpoint to altimate-code server
Returns the session conversation as a formatted markdown transcript (text/plain; charset=utf-8)
Reuses formatTranscript from cli/cmd/tui/util/transcript.ts (same function powering the TUI /export command)
Supports optional query params: thinking (bool), toolDetails (bool), assistantMetadata (bool) — all default false

Endpoint

GET /session/:sessionID/transcript[?thinking=true&toolDetails=true&assistantMetadata=true]

Response:text/plain; charset=utf-8 — markdown string starting with # <session title>

Example response:

# My session title**Session ID:** ses_xxx
**Created:** 6/15/2026, 7:04:58 AM
**Updated:** 6/15/2026, 7:04:58 AM
---

Test plan

Created session via POST /session, called GET /session/:id/transcript
Response is 200 OK, Content-Type: text/plain; charset=UTF-8
Body starts with # (markdown session title)
Query params (thinking, toolDetails, assistantMetadata) accepted without error
Verify with a session that has messages (tool calls, reasoning) to confirm option flags work

Files changed

packages/opencode/src/server/routes/session.ts — added import + route handler

Requested by @saravmajestic via harness

Summary by cubic

Adds a new REST endpoint to export a session’s conversation as a markdown transcript for easy sharing and offline viewing. Implements Linear AI-6949.

New Features
- Adds GET /session/:sessionID/transcript returning markdown (text/plain; charset=utf-8); reuses formatTranscript to match the TUI /export; supports thinking, toolDetails, and assistantMetadata flags (default false); includes tests for 200/404, empty sessions, and flag behavior.
Bug Fixes
- Fixes boolean parsing for query flags using z.preprocess so ?thinking=false is respected; aligns import to @/cli/...; strengthens tests to assert reasoning is included/excluded.

^{Written for commit b7c1757. Summary will update on new commits.}

… export

github-actions · 2026-06-15T07:05:45Z

This PR doesn't fully meet our contributing guidelines and PR template.

What needs to be fixed:

PR description is missing required template sections. Please use the PR template.

Please edit this PR description to address the above within 2 hours, or it will be automatically closed.

If you believe this was flagged incorrectly, please let a maintainer know.

ralphstodomingo

Reviewed the session-transcript endpoint. Mirrors the existing Session.get/messages pattern well. One boolean-parsing footgun plus the test gap that hides it.

ralphstodomingo · 2026-06-16T05:33:12Z

+ validator(
+ "query",
+ z.object({
+ thinking: z.coerce.boolean().optional().default(false).meta({ description: "Include reasoning/thinking parts" }),


Bug (latent): z.coerce.boolean() uses JS Boolean() semantics, so ?thinking=false, =0, =off all coerce to true — only absent/empty yields false. For flags presented as real toggles defaulting to false, the only way to get false is to omit the param. Latent because the current consumer (#366) only ever sends =true or omits, but it'll bite any client passing explicit =false. Suggest z.enum(["true","false"]).optional().default("false").transform(v => v === "true") (or a stringbool helper) for all three flags.

Fixed in b7c1757 using z.preprocess(v => v === "false" ? false : v, z.coerce.boolean()) — handles the "false" string explicitly before coerce runs. Preserves the z.boolean() output type so the rest of the route chain stays unchanged.

ralphstodomingo · 2026-06-16T05:33:12Z

+ fn: async () => {
+ const session = await Session.create({ title: "Options Session" })
+ await addUserMessage(session.id, "test message")
+ const app = Server.Default()


Concern: this flag test only sends =true and asserts status 200 + # prefix, so it can't catch the coercion bug above and doesn't prove the flags change output. formatTranscript emits _Thinking:_ / **Input:** / **Output:** — build a session with reasoning + tool parts and assert =true includes those markers while =false/default exclude them. That also closes the PR's own unchecked "verify flags work" item.

Fixed in b7c1757. Replaced the smoke test with a session that has a real reasoning part. Now asserts ?thinking=true includes _Thinking:_, ?thinking=false excludes it (catches the coerce bug), and default also excludes it. 17 assertions, all pass.

ralphstodomingo · 2026-06-16T05:33:12Z

@@ -1,4 +1,5 @@
 import { Hono } from "hono"
+import { formatTranscript } from "../../cli/cmd/tui/util/transcript"


Nit: this imports formatTranscript via deep relative path ../../cli/cmd/tui/util/transcript, but the only other server→cli import (routes/tui.ts) uses the @/cli/… alias, and this file already uses @/ elsewhere. Use @/cli/cmd/tui/util/transcript (or @tui/util/transcript). Server importing from cli/ is a layering smell, but there's precedent.

Fixed in b7c1757 — changed to @/cli/cmd/tui/util/transcript.

…trengthen flag tests - Use z.preprocess to handle explicit "false" string correctly: z.coerce.boolean() coerces Boolean("false") = true, so ?thinking=false was silently treated as true - Fix import to use @/cli alias consistent with other server routes - Update flag test to build a session with real reasoning parts and assert both ?thinking=true includes _Thinking:_ and ?thinking=false excludes it

dev-punia-altimate · 2026-06-16T08:26:20Z

❌ Tests — Failures Detected

TypeScript — 15 failure(s)

connection_refused
timeout
permission_denied
parse_error
network_error
auth_failure
rate_limit
internal_error
empty_error
connection_refused
timeout
permission_denied
parse_error
network_error
auth_failure

Next Step

Please address the failing cases above and re-run verification.

cc @app/altimate-harness-bot

Actionable fixes surfaced by the multi-persona release review of the 8 PRs shipping in v0.8.8. All are small, behavior-preserving except where noted. - #937 `run`: treat a blank/whitespace `ALTIMATE_NON_INTERACTIVE` as unset (`.trim()` guard) so a stray `export ALTIMATE_NON_INTERACTIVE=` no longer silently reintroduces the headless hang the PR fixed. - #941 transcript endpoint: broaden query-boolean coercion so `0`/`no`/`off` (case-insensitive), not just `"false"`, map to false for `thinking`, `toolDetails`, `assistantMetadata`. - #940 serve startup upgrade: jitter the settle delay (base + random*base*5, ~1-6s) so a fleet restarting together doesn't stampede the unauthenticated GitHub releases API (60 req/hr/IP) in the same instant. - #893 `addMcpToConfig`: refuse to overwrite a config whose JSON/JSONC cannot be parsed (parse-guard), mirroring the read helpers, instead of letting jsonc-parser best-effort clobber a recoverable file. - #893 `normalizeMcpConfig`: preserve `updatedAt` on local/remote MCP entries instead of dropping it during normalization. - #933 `stripAnsi`: match the general CSI escape family (cursor/erase), not just SGR color codes, so dbt spinner output is fully cleaned. Updates the release-validation tests that pinned the prior (now-corrected) behavior: the `run` guard string, the jittered scheduler delay window, and the transcript boolean falsiness. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat: [AI-6949] add GET /session/:id/transcript endpoint for markdown…
0032cb4
… export

altimate-harness-botBot assigned saravmajestic Jun 15, 2026

github-actionsBot added contributor needs:compliance labels Jun 15, 2026

test: [AI-6949] add server test for GET /session/:id/transcript endpoint
ce6058f

saravmajestic marked this pull request as ready for review June 15, 2026 07:13

saravmajestic changed the title ~~feat: [AI-6949] add session transcript REST endpoint~~feat: [AI-6949] add session transcript REST endpoint for datamates extensionJun 15, 2026

saravmajestic requested review from anandgupta42 and kulvirgit June 15, 2026 07:13

ralphstodomingo reviewed Jun 16, 2026
View reviewed changes

ralphstodomingo approved these changes Jun 16, 2026
View reviewed changes

saravmajestic merged commit ae69109 into mainJun 16, 2026
18 checks passed

This was referenced Jun 18, 2026
Add release-validation test coverage for post-v0.8.7 merged PRs #951
Closed
test: add release-validation coverage for post-v0.8.7 merged PRs #952
Merged

Navigation Menu

Uh oh!

feat: [AI-6949] add session transcript REST endpoint for datamates extension - #941

feat: [AI-6949] add session transcript REST endpoint for datamates extension#941
saravmajestic merged 3 commits into
mainfrom
feat/AI-6949-session-transcript-endpoint

altimate-harness-botBot commented Jun 15, 2026•
edited by cubic-dev-ai Bot
Loading

Uh oh!

github-actionsBot commented Jun 15, 2026

Uh oh!

ralphstodomingo left a comment

Uh oh!

ralphstodomingoJun 16, 2026

Uh oh!

altimate-harness-botBotJun 16, 2026

Uh oh!

ralphstodomingoJun 16, 2026

Uh oh!

altimate-harness-botBotJun 16, 2026

Uh oh!

ralphstodomingoJun 16, 2026

Uh oh!

altimate-harness-botBotJun 16, 2026

Uh oh!

dev-punia-altimate commented Jun 16, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		@@ -1,4 +1,5 @@
		import { Hono } from "hono"
		import { formatTranscript } from "../../cli/cmd/tui/util/transcript"

Uh oh!

Conversation

altimate-harness-botBot commented Jun 15, 2026• edited by cubic-dev-ai BotLoading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Endpoint

Test plan

Files changed

Summary by cubic

Uh oh!

github-actionsBot commented Jun 15, 2026

Uh oh!

ralphstodomingo left a comment

Choose a reason for hiding this comment

Uh oh!

ralphstodomingoJun 16, 2026

Choose a reason for hiding this comment

Uh oh!

altimate-harness-botBotJun 16, 2026

Choose a reason for hiding this comment

Uh oh!

ralphstodomingoJun 16, 2026

Choose a reason for hiding this comment

Uh oh!

altimate-harness-botBotJun 16, 2026

Choose a reason for hiding this comment

Uh oh!

ralphstodomingoJun 16, 2026

Choose a reason for hiding this comment

Uh oh!

altimate-harness-botBotJun 16, 2026

Choose a reason for hiding this comment

Uh oh!

dev-punia-altimate commented Jun 16, 2026

❌ Tests — Failures Detected

TypeScript — 15 failure(s)

Next Step

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

altimate-harness-botBot commented Jun 15, 2026•
edited by cubic-dev-ai Bot
Loading