From 94a63aaf4222e2b0696b745abfcacd7baee57f73 Mon Sep 17 00:00:00 2001
From: Thomas Kosiewski <tk@coder.com>
Date: Thu, 30 Apr 2026 07:59:58 +0000
Subject: [PATCH 1/4] refactor: share screenshot capture and artifact
 persistence

Live host screenshot RPCs and CLI offline replay screenshots now both flow
through a single `captureScreenshotResult(...)` helper in
`src/screenshot/capture.ts`, mirroring the snapshot capture refactor in
#69. The shared seam owns:

- temp-file allocation under the session artifacts directory
- renderer screenshot invocation (with optional `showCursor` threaded
  through)
- the union of the live and offline runtime invariants (sessionId,
  profileName, pngSizeBytes, requested vs returned artifactPath, sha256)
- allowlisted public `ScreenshotResult` construction
- Zod validation through `ScreenshotResultSchema` *before* any rename or
  manifest append side effect
- the final `screenshot-<seq>-<profile>.png` rename
- artifact manifest entry creation with the same metadata fields as
  before
- temp-file cleanup on failure

Public CLI/RPC behavior, screenshot filenames, manifest entries, and
`screenshot --json` output are unchanged (verified by the
`dogfood/issue-64-share-screenshot-capture/` proof bundle: byte-identical
PNGs and identical manifest metadata before and after, against parent
commit b2d5068).

Tracking #64.
---
 CHANGELOG.md                                  |   1 +
 CONTEXT.md                                    |  12 +
 .../README.md                                 |  95 ++++
 .../after/01-create-live.json                 |  12 +
 .../after/02-wait-live.json                   |  13 +
 .../after/03-screenshot-live-default.json     |  20 +
 .../after/04-screenshot-live-show-cursor.json |  20 +
 .../after/10-create-offline.json              |  12 +
 .../after/11-wait-offline.json                |   9 +
 .../after/12-screenshot-offline-default.json  |  20 +
 .../13-screenshot-offline-show-cursor.json    |  20 +
 .../after/98-destroy-offline.json             |   9 +
 .../after/99-destroy-live.json                |   9 +
 .../after/agent-tty-home.txt                  |   1 +
 .../after/live-session-id.txt                 |   1 +
 .../after/manifest-live.json                  |  46 ++
 .../after/manifest-offline.json               |  46 ++
 .../after/offline-session-id.txt              |   1 +
 .../after/screenshot-live-default.png         | Bin 0 -> 3790 bytes
 .../after/screenshot-live-show-cursor.png     | Bin 0 -> 3790 bytes
 .../after/screenshot-offline-default.png      | Bin 0 -> 3749 bytes
 .../after/screenshot-offline-show-cursor.png  | Bin 0 -> 3749 bytes
 .../after/sha256-summary.txt                  |   8 +
 .../after/transcript.txt                      | 152 ++++++
 .../before/01-create-live.json                |  12 +
 .../before/02-wait-live.json                  |  13 +
 .../before/03-screenshot-live-default.json    |  20 +
 .../04-screenshot-live-show-cursor.json       |  20 +
 .../before/10-create-offline.json             |  12 +
 .../before/11-wait-offline.json               |   9 +
 .../before/12-screenshot-offline-default.json |  20 +
 .../13-screenshot-offline-show-cursor.json    |  20 +
 .../before/98-destroy-offline.json            |   9 +
 .../before/99-destroy-live.json               |   9 +
 .../before/agent-tty-home.txt                 |   1 +
 .../before/live-session-id.txt                |   1 +
 .../before/manifest-live.json                 |  46 ++
 .../before/manifest-offline.json              |  46 ++
 .../before/offline-session-id.txt             |   1 +
 .../before/screenshot-live-default.png        | Bin 0 -> 3790 bytes
 .../before/screenshot-live-show-cursor.png    | Bin 0 -> 3790 bytes
 .../before/screenshot-offline-default.png     | Bin 0 -> 3749 bytes
 .../before/screenshot-offline-show-cursor.png | Bin 0 -> 3749 bytes
 .../before/sha256-summary.txt                 |   8 +
 .../before/transcript.txt                     | 152 ++++++
 .../commands.sh                               | 126 +++++
 src/cli/commands/screenshot.ts                | 146 +-----
 src/host/hostMain.ts                          |  97 +---
 src/screenshot/capture.ts                     | 146 ++++++
 test/unit/screenshot/capture.test.ts          | 468 ++++++++++++++++++
 50 files changed, 1682 insertions(+), 207 deletions(-)
 create mode 100644 dogfood/issue-64-share-screenshot-capture/README.md
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/01-create-live.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/02-wait-live.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/03-screenshot-live-default.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/04-screenshot-live-show-cursor.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/10-create-offline.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/11-wait-offline.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/12-screenshot-offline-default.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/13-screenshot-offline-show-cursor.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/98-destroy-offline.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/99-destroy-live.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/agent-tty-home.txt
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/live-session-id.txt
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/manifest-live.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/manifest-offline.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/offline-session-id.txt
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/screenshot-live-default.png
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/screenshot-live-show-cursor.png
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/screenshot-offline-default.png
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/screenshot-offline-show-cursor.png
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/sha256-summary.txt
 create mode 100644 dogfood/issue-64-share-screenshot-capture/after/transcript.txt
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/01-create-live.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/02-wait-live.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/03-screenshot-live-default.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/04-screenshot-live-show-cursor.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/10-create-offline.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/11-wait-offline.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/12-screenshot-offline-default.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/13-screenshot-offline-show-cursor.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/98-destroy-offline.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/99-destroy-live.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/agent-tty-home.txt
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/live-session-id.txt
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/manifest-live.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/manifest-offline.json
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/offline-session-id.txt
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/screenshot-live-default.png
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/screenshot-live-show-cursor.png
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/screenshot-offline-default.png
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/screenshot-offline-show-cursor.png
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/sha256-summary.txt
 create mode 100644 dogfood/issue-64-share-screenshot-capture/before/transcript.txt
 create mode 100755 dogfood/issue-64-share-screenshot-capture/commands.sh
 create mode 100644 src/screenshot/capture.ts
 create mode 100644 test/unit/screenshot/capture.test.ts

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c85e952..4a85cbd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -17,6 +17,7 @@
 - Session-status policy is now centralized in a single module that classifies every `SessionStatus` as active, terminal, commandable, live-host eligible, offline-replay eligible, collectable, and destroyed; lifecycle, inspect, gc, wait, host, and command-state checks share the same predicates. CLI JSON, protocol schemas, event-log behavior, and artifact formats are unchanged ([#67](https://github.com/coder/agent-tty/pull/67)).
 - Persisted event-log validation, JSONL parsing, and contiguous-sequence checks for live hydration, offline replay, and `record export` now flow through a shared codec at `src/storage/eventLogCodec.ts`. Validation errors use neutral event-log wording; missing-log policy remains caller-specific (offline replay treats missing logs as empty; `record export` still surfaces missing logs as an error) ([#68](https://github.com/coder/agent-tty/pull/68)).
 - Snapshot result construction and artifact persistence are now shared between live host RPCs and offline replay through `src/snapshot/capture.ts`. Snapshot artifact filenames, JSON formatting (two-space indent + trailing newline), manifest metadata, and `rendererBackend` reporting are unchanged ([#69](https://github.com/coder/agent-tty/pull/69)).
+- Screenshot capture, validation, and artifact persistence are now shared between live host RPCs and offline replay through `src/screenshot/capture.ts`. The shared seam owns temporary-file allocation, renderer screenshot invocation, allowlisted public result construction, Zod validation before any rename or manifest append, manifest metadata creation, and temp-file cleanup on failure. Screenshot filenames, final PNG paths, manifest entry shape (`profileName`, `cols`, `rows`, `pngSizeBytes`, `cursorVisible`, `rendererBackend`, `pixelWidth`, `pixelHeight`, `sha256`, `renderProfileHash`), and `screenshot --json` output are unchanged (tracking [#64](https://github.com/coder/agent-tty/issues/64)).
 - Waited-run completion bookkeeping (sentinel scanning, postamble sanitization, waiter resolution, timeout, exit, `run_complete` appends) moved out of `hostMain` into a dedicated `RunCompletionCoordinator`. No public CLI, protocol, or event-log changes ([#70](https://github.com/coder/agent-tty/pull/70)).
 - Refreshed contributor and agent guidance in `AGENTS.md` with an outcome-first operating contract, validation guidance, and grouped project invariants ([#46](https://github.com/coder/agent-tty/pull/46)). Added in-repo agent skills under `.agents/skills/` (`diagnose`, `tdd`, `triage`, `improve-codebase-architecture`, `grill-with-docs`, `to-issues`, `to-prd`) plus matching links from `.claude/skills/` and `.mux/skills/` ([#65](https://github.com/coder/agent-tty/pull/65)).
 
diff --git a/CONTEXT.md b/CONTEXT.md
index 20870a7..0fcb703 100644
--- a/CONTEXT.md
+++ b/CONTEXT.md
@@ -69,6 +69,16 @@ A persisted JSON artifact containing exactly the **Snapshot Result** returned to
 The operation that derives a **Snapshot Result** from a **Semantic Snapshot** and records the matching **Snapshot Artifact**.
 _Avoid_: Renderer capture
 
+**Screenshot Result**:
+A public screenshot payload returned to a caller describing the rendered PNG of a **Session** at a captured event-log sequence.
+
+**Screenshot Artifact**:
+A persisted PNG file plus its manifest entry recording the **Screenshot Result** for a **Session** at a captured event-log sequence.
+
+**Screenshot Capture**:
+The operation that invokes the renderer to produce the PNG, builds the **Screenshot Result**, and records the matching **Screenshot Artifact**.
+_Avoid_: Renderer capture
+
 **Release Prep Workflow**:
 The maintainer-facing process for choosing the next release version and preparing release changes for review before they land on the default branch.
 
@@ -90,6 +100,8 @@ The tag-triggered automation that validates, packages, and publishes a release a
 - An **Offline Replay Eligible Session** is reconstructed from its persisted **Event Log** and manifest.
 - A **Snapshot Result** is derived from exactly one **Semantic Snapshot**.
 - A **Snapshot Artifact** contains exactly the **Snapshot Result** emitted to the caller.
+- A **Screenshot Capture** produces exactly one **Screenshot Result** and exactly one **Screenshot Artifact** for the same captured event-log sequence.
+- A **Screenshot Artifact** is the persisted PNG plus its manifest entry that the **Screenshot Result** describes to the caller.
 - A **Command Target** is exactly one **Commandable Session** selected by an input or control command.
 - A **Commandable Session** can accept a **Waited Run**.
 - A **Render Wait** may include text, regex, cursor, or **Screen Stability** conditions.
diff --git a/dogfood/issue-64-share-screenshot-capture/README.md b/dogfood/issue-64-share-screenshot-capture/README.md
new file mode 100644
index 0000000..4ca3623
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/README.md
@@ -0,0 +1,95 @@
+# Issue 64 — Share screenshot capture and artifact persistence
+
+This bundle compares screenshot output from the running session (live) and
+exited session (offline replay) paths, before and after the refactor that
+moves both paths through the shared `captureScreenshotResult(...)` helper in
+`src/screenshot/capture.ts`.
+
+## How it was generated
+
+The same `commands.sh` was run twice:
+
+1. **before**: against parent commit `b2d5068` (`refactor: share render wait
+matching (#76)`) in a temporary `git worktree`. This still has the
+   inline screenshot logic in `src/host/hostMain.ts` and a duplicate
+   implementation in `src/cli/commands/screenshot.ts`.
+2. **after**: against this branch, where both paths call the new
+   `captureScreenshotResult(...)` helper.
+
+Each run uses an isolated absolute `AGENT_TTY_HOME` (recorded in
+`<label>/agent-tty-home.txt`) and writes its outputs under
+`<label>/`.
+
+The script is idempotent and safe to re-run:
+
+```sh
+bash dogfood/issue-64-share-screenshot-capture/commands.sh after
+# or, in a worktree of the parent commit:
+bash dogfood/issue-64-share-screenshot-capture/commands.sh before
+```
+
+## Scenarios captured
+
+For both `before/` and `after/` directories:
+
+| File                                     | Description                                         |
+| ---------------------------------------- | --------------------------------------------------- |
+| `03-screenshot-live-default.json`        | Live (running) screenshot, default cursor           |
+| `04-screenshot-live-show-cursor.json`    | Live (running) screenshot with `--show-cursor`      |
+| `12-screenshot-offline-default.json`     | Offline (exited) screenshot, default cursor         |
+| `13-screenshot-offline-show-cursor.json` | Offline (exited) screenshot with `--show-cursor`    |
+| `screenshot-live-default.png`            | Live default-cursor PNG                             |
+| `screenshot-live-show-cursor.png`        | Live show-cursor PNG                                |
+| `screenshot-offline-default.png`         | Offline default-cursor PNG                          |
+| `screenshot-offline-show-cursor.png`     | Offline show-cursor PNG                             |
+| `manifest-live.json`                     | Artifact manifest after live session screenshots    |
+| `manifest-offline.json`                  | Artifact manifest after offline session screenshots |
+| `sha256-summary.txt`                     | One-line-per-PNG SHA-256 summary                    |
+| `transcript.txt`                         | Full command transcript                             |
+
+Default profile is `reference-dark` (the only profile this refactor needs to
+preserve).
+
+## Parity verdict
+
+| Comparison                                                                                                                           | Result                 |
+| ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- |
+| `sha256-summary.txt` (live + offline, with and without cursor)                                                                       | **identical**          |
+| All four screenshot result envelopes, excluding session IDs and the absolute `artifactPath` (which embeds the temp `AGENT_TTY_HOME`) | **identical fields**   |
+| Artifact manifest entries, excluding ULID `id`, `sessionId`, and `createdAt` timestamps                                              | **identical metadata** |
+| All four PNG files, byte-for-byte (`cmp -s`)                                                                                         | **identical bytes**    |
+
+Specifically:
+
+- Live default and live show-cursor PNGs both hash to
+  `a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb` in both
+  before and after.
+- Offline default and offline show-cursor PNGs both hash to
+  `993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d` in both
+  before and after.
+- All result envelopes preserve `profileName=reference-dark`,
+  `cols=80`, `rows=24`, `pngSizeBytes`, `pixelWidth=640`, `pixelHeight=384`,
+  `cursorVisible`, `rendererBackend=ghostty-web`, and `renderProfileHash`.
+
+## Reviewer reproduction
+
+To independently verify these comparisons:
+
+```sh
+node -e "
+  const fs = require('node:fs');
+  function strip(p) {
+    const e = JSON.parse(fs.readFileSync(p, 'utf8'));
+    const r = e.result; delete r.sessionId; delete r.artifactPath;
+    delete e.timestamp;
+    return e;
+  }
+  for (const f of ['03-screenshot-live-default','04-screenshot-live-show-cursor','12-screenshot-offline-default','13-screenshot-offline-show-cursor']) {
+    const a = strip(\`before/\${f}.json\`);
+    const b = strip(\`after/\${f}.json\`);
+    console.log(f, JSON.stringify(a)===JSON.stringify(b) ? 'IDENTICAL' : 'DIFFER');
+  }
+"
+cmp -s before/screenshot-live-default.png after/screenshot-live-default.png && echo "live-default PNG IDENTICAL"
+cmp -s before/screenshot-offline-default.png after/screenshot-offline-default.png && echo "offline-default PNG IDENTICAL"
+```
diff --git a/dogfood/issue-64-share-screenshot-capture/after/01-create-live.json b/dogfood/issue-64-share-screenshot-capture/after/01-create-live.json
new file mode 100644
index 0000000..1f2cc8b
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/01-create-live.json
@@ -0,0 +1,12 @@
+{
+  "ok": true,
+  "command": "create",
+  "timestamp": "2026-04-30T07:53:01.428Z",
+  "result": {
+    "sessionId": "01KQEP0YDSTXK6A7EB7ABAK8SS",
+    "createdAt": "2026-04-30T07:53:00.604Z",
+    "cols": 80,
+    "rows": 24,
+    "shell": "/bin/bash"
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/after/02-wait-live.json b/dogfood/issue-64-share-screenshot-capture/after/02-wait-live.json
new file mode 100644
index 0000000..481d0d4
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/02-wait-live.json
@@ -0,0 +1,13 @@
+{
+  "ok": true,
+  "command": "wait",
+  "timestamp": "2026-04-30T07:53:03.114Z",
+  "result": {
+    "matched": true,
+    "timedOut": false,
+    "matchedText": "live screenshot fixture",
+    "cursorRow": 1,
+    "cursorCol": 0,
+    "capturedAtSeq": 0
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/after/03-screenshot-live-default.json b/dogfood/issue-64-share-screenshot-capture/after/03-screenshot-live-default.json
new file mode 100644
index 0000000..e17584f
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/03-screenshot-live-default.json
@@ -0,0 +1,20 @@
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:53:04.412Z",
+  "result": {
+    "sessionId": "01KQEP0YDSTXK6A7EB7ABAK8SS",
+    "capturedAtSeq": 0,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.p97cQahYjP/sessions/01KQEP0YDSTXK6A7EB7ABAK8SS/artifacts/screenshot-0-reference-dark.png",
+    "pngSizeBytes": 3790,
+    "cursorVisible": false,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/after/04-screenshot-live-show-cursor.json b/dogfood/issue-64-share-screenshot-capture/after/04-screenshot-live-show-cursor.json
new file mode 100644
index 0000000..7cb9542
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/04-screenshot-live-show-cursor.json
@@ -0,0 +1,20 @@
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:53:05.670Z",
+  "result": {
+    "sessionId": "01KQEP0YDSTXK6A7EB7ABAK8SS",
+    "capturedAtSeq": 0,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.p97cQahYjP/sessions/01KQEP0YDSTXK6A7EB7ABAK8SS/artifacts/screenshot-0-reference-dark.png",
+    "pngSizeBytes": 3790,
+    "cursorVisible": true,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/after/10-create-offline.json b/dogfood/issue-64-share-screenshot-capture/after/10-create-offline.json
new file mode 100644
index 0000000..5701e44
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/10-create-offline.json
@@ -0,0 +1,12 @@
+{
+  "ok": true,
+  "command": "create",
+  "timestamp": "2026-04-30T07:53:07.504Z",
+  "result": {
+    "sessionId": "01KQEP14EXSSGJX9RRSTAVYGK2",
+    "createdAt": "2026-04-30T07:53:06.784Z",
+    "cols": 80,
+    "rows": 24,
+    "shell": "/bin/bash"
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/after/11-wait-offline.json b/dogfood/issue-64-share-screenshot-capture/after/11-wait-offline.json
new file mode 100644
index 0000000..b6b4836
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/11-wait-offline.json
@@ -0,0 +1,9 @@
+{
+  "ok": true,
+  "command": "wait",
+  "timestamp": "2026-04-30T07:53:08.644Z",
+  "result": {
+    "timedOut": false,
+    "exitCode": 0
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/after/12-screenshot-offline-default.json b/dogfood/issue-64-share-screenshot-capture/after/12-screenshot-offline-default.json
new file mode 100644
index 0000000..5487628
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/12-screenshot-offline-default.json
@@ -0,0 +1,20 @@
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:53:10.283Z",
+  "result": {
+    "sessionId": "01KQEP14EXSSGJX9RRSTAVYGK2",
+    "capturedAtSeq": 1,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.p97cQahYjP/sessions/01KQEP14EXSSGJX9RRSTAVYGK2/artifacts/screenshot-1-reference-dark.png",
+    "pngSizeBytes": 3749,
+    "cursorVisible": false,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/after/13-screenshot-offline-show-cursor.json b/dogfood/issue-64-share-screenshot-capture/after/13-screenshot-offline-show-cursor.json
new file mode 100644
index 0000000..d1e357e
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/13-screenshot-offline-show-cursor.json
@@ -0,0 +1,20 @@
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:53:16.766Z",
+  "result": {
+    "sessionId": "01KQEP14EXSSGJX9RRSTAVYGK2",
+    "capturedAtSeq": 1,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.p97cQahYjP/sessions/01KQEP14EXSSGJX9RRSTAVYGK2/artifacts/screenshot-1-reference-dark.png",
+    "pngSizeBytes": 3749,
+    "cursorVisible": true,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/after/98-destroy-offline.json b/dogfood/issue-64-share-screenshot-capture/after/98-destroy-offline.json
new file mode 100644
index 0000000..edb602e
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/98-destroy-offline.json
@@ -0,0 +1,9 @@
+{
+  "ok": true,
+  "command": "destroy",
+  "timestamp": "2026-04-30T07:53:24.099Z",
+  "result": {
+    "sessionId": "01KQEP14EXSSGJX9RRSTAVYGK2",
+    "destroyed": true
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/after/99-destroy-live.json b/dogfood/issue-64-share-screenshot-capture/after/99-destroy-live.json
new file mode 100644
index 0000000..035c9a3
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/99-destroy-live.json
@@ -0,0 +1,9 @@
+{
+  "ok": true,
+  "command": "destroy",
+  "timestamp": "2026-04-30T07:53:23.059Z",
+  "result": {
+    "sessionId": "01KQEP0YDSTXK6A7EB7ABAK8SS",
+    "destroyed": true
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/after/agent-tty-home.txt b/dogfood/issue-64-share-screenshot-capture/after/agent-tty-home.txt
new file mode 100644
index 0000000..33214ac
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/agent-tty-home.txt
@@ -0,0 +1 @@
+/tmp/tmp.p97cQahYjP
diff --git a/dogfood/issue-64-share-screenshot-capture/after/live-session-id.txt b/dogfood/issue-64-share-screenshot-capture/after/live-session-id.txt
new file mode 100644
index 0000000..3a8e47a
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/live-session-id.txt
@@ -0,0 +1 @@
+01KQEP0YDSTXK6A7EB7ABAK8SS
diff --git a/dogfood/issue-64-share-screenshot-capture/after/manifest-live.json b/dogfood/issue-64-share-screenshot-capture/after/manifest-live.json
new file mode 100644
index 0000000..de0ffc8
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/manifest-live.json
@@ -0,0 +1,46 @@
+{
+  "version": 1,
+  "sessionId": "01KQEP0YDSTXK6A7EB7ABAK8SS",
+  "artifacts": [
+    {
+      "id": "01KQEP124PSDQBCK39NM2JRG0Q",
+      "kind": "screenshot",
+      "filename": "screenshot-0-reference-dark.png",
+      "sessionId": "01KQEP0YDSTXK6A7EB7ABAK8SS",
+      "capturedAtSeq": 0,
+      "createdAt": "2026-04-30T07:53:04.406Z",
+      "sha256": "a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb",
+      "metadata": {
+        "profileName": "reference-dark",
+        "cols": 80,
+        "rows": 24,
+        "pngSizeBytes": 3790,
+        "cursorVisible": false,
+        "rendererBackend": "ghostty-web",
+        "pixelWidth": 640,
+        "pixelHeight": 384,
+        "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+      }
+    },
+    {
+      "id": "01KQEP13C2VTX38AMZV3F92STZ",
+      "kind": "screenshot",
+      "filename": "screenshot-0-reference-dark.png",
+      "sessionId": "01KQEP0YDSTXK6A7EB7ABAK8SS",
+      "capturedAtSeq": 0,
+      "createdAt": "2026-04-30T07:53:05.667Z",
+      "sha256": "a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb",
+      "metadata": {
+        "profileName": "reference-dark",
+        "cols": 80,
+        "rows": 24,
+        "pngSizeBytes": 3790,
+        "cursorVisible": true,
+        "rendererBackend": "ghostty-web",
+        "pixelWidth": 640,
+        "pixelHeight": 384,
+        "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+      }
+    }
+  ]
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/after/manifest-offline.json b/dogfood/issue-64-share-screenshot-capture/after/manifest-offline.json
new file mode 100644
index 0000000..eaaa729
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/manifest-offline.json
@@ -0,0 +1,46 @@
+{
+  "version": 1,
+  "sessionId": "01KQEP14EXSSGJX9RRSTAVYGK2",
+  "artifacts": [
+    {
+      "id": "01KQEP17V1X05S77G8CX5X7VPE",
+      "kind": "screenshot",
+      "filename": "screenshot-1-reference-dark.png",
+      "sessionId": "01KQEP14EXSSGJX9RRSTAVYGK2",
+      "capturedAtSeq": 1,
+      "createdAt": "2026-04-30T07:53:10.241Z",
+      "sha256": "993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d",
+      "metadata": {
+        "profileName": "reference-dark",
+        "cols": 80,
+        "rows": 24,
+        "pngSizeBytes": 3749,
+        "cursorVisible": false,
+        "rendererBackend": "ghostty-web",
+        "pixelWidth": 640,
+        "pixelHeight": 384,
+        "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+      }
+    },
+    {
+      "id": "01KQEP1E5KMKCHYK9BEZJ6TD0G",
+      "kind": "screenshot",
+      "filename": "screenshot-1-reference-dark.png",
+      "sessionId": "01KQEP14EXSSGJX9RRSTAVYGK2",
+      "capturedAtSeq": 1,
+      "createdAt": "2026-04-30T07:53:16.723Z",
+      "sha256": "993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d",
+      "metadata": {
+        "profileName": "reference-dark",
+        "cols": 80,
+        "rows": 24,
+        "pngSizeBytes": 3749,
+        "cursorVisible": true,
+        "rendererBackend": "ghostty-web",
+        "pixelWidth": 640,
+        "pixelHeight": 384,
+        "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+      }
+    }
+  ]
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/after/offline-session-id.txt b/dogfood/issue-64-share-screenshot-capture/after/offline-session-id.txt
new file mode 100644
index 0000000..e9d1b19
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/offline-session-id.txt
@@ -0,0 +1 @@
+01KQEP14EXSSGJX9RRSTAVYGK2
diff --git a/dogfood/issue-64-share-screenshot-capture/after/screenshot-live-default.png b/dogfood/issue-64-share-screenshot-capture/after/screenshot-live-default.png
new file mode 100644
index 0000000000000000000000000000000000000000..376bebca63b7baab69291584fba8253ffcb91b47
GIT binary patch
literal 3790
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

literal 0
HcmV?d00001

diff --git a/dogfood/issue-64-share-screenshot-capture/after/screenshot-live-show-cursor.png b/dogfood/issue-64-share-screenshot-capture/after/screenshot-live-show-cursor.png
new file mode 100644
index 0000000000000000000000000000000000000000..376bebca63b7baab69291584fba8253ffcb91b47
GIT binary patch
literal 3790
zcmeHK`&-h78pq?A?Z!M?C!IQVXM0vF1DAQpD|2biI%>|mCSduXkwd&8q5_s@)s8dk
zQFPK2w^FpcUl29;+EQ7dl6gxos0c|B5D-zh9rnZd2hI=Yr+#>!=Y2lEz3=<^eBS5t
z<LT%K@Vn0Mf<Pc}<hNnpfk1yL1A%PH-u{af>5T|m1%W;&j|>YvQ}oOFvv+Rn(_P}I
z{VsfM_ti`AXJaLBu&C+F^Y=HdbyDy2f8>MONc!R>CY+Zw?n7;5=2kj;pLp>0#j)z=
zJr{FWo;9b!KDc=*cGPCy=>p3!4|N*i<IBd2ezX`CbvGskP&T$)WUIucjHDr=;rc#M
z+IY(9h$~)jp?XTtk4bb>0WiGTNI)j18>R!@aqB<s<p2o1Xq^kY6Xk1?IY3g{%dkK=
zFX3$AG6N$lq@0{u_Q&boYao|d>ZqR-{c%o)C<r&D_e~8Ncb&hO6e=G#qwXb8$Y&xp
zkDU|SlApHH=NK0Vku)*xY1-{(GWTY1vB*1TgFrJKU!Ngb#(6F{bKN-r6xME}5uwm3
zuVIOqQ^%ZOmD|-u{4kM(Zl>_=)e8hC?q6Kem6V9_ix@v~j_v@hR5LEE46yLJk)Y2K
zIyD2&^a8TVWNs#v;%G>=Kl&S|(vpFN%my+Vz4a<`uN){aMgl*7l|6aGU`NSKCd)B_
z6i^Lik0{Ty?4N%q9w)ZkP-PE9$>$e8w(MrvgNHJojHxT|EI1uH07?1DIb^*t)K<nf
zbdz2<xDGmntpCt}HzDBgXT);5=#OCxlIhCU$e5J#OOD{DK{_OrnR82lFHQfQ8Hkm`
z=-GujNn2anCpjCxB9UbE)&amj_iGCqWpKd`@62#$PwqrkYvv`<K}6A2_nJ^Zj69mR
zeQG`?yf0&ld(d>ASXX4`)yBX^^vs?v6Z(0SbQULQ$8+mtdO%GjXjgpt#hTSuk=SLj
zUV(Z<&FUcTE;;IkHZKph#K5m;-x<|Bxx-x))gK|wU900%y2kB~pUTRTJF@*s5-^ww
z_^=|`f*$f7=7<b2RAwvK;Fj}8EN7GIi_=tB!Fo{~%(Q|S-h4NB#C@Zh=5{n=^V*1V
zJAKGRc(f1jNIcEcu=K&L-suaIcp5?D8HgA5>6;VhyMToNx$-eV1|3nF$0SvZ6rIo!
zNx~3(PNM)Y1PMH}6T@CVW+)cO%2iIFqMt{wi0HfOzXuj5hqnSSKrd;@%)cJE`V5~D
zq@7E59TX|=S2#dCI}RPdOuoK}3Ocu(g-Ugc&lZz1A6D)G6MBPE7%2m?gPHSH_OLai
zOMs>MvAz9}zWejy{wzy_2F<VLr*x-1xR!{x+biC3^-V2l@YTg&1qGDeftILSkcT^e
zP4mC&YfC~seNQ?wtXng<ZkKyP$&7*voKD+aIC26$tTc<(>u;ZU-$T+lq6mIv4n-~K
zmhx$=m5D$>Kb$O>^K%iHi{<#AHz&4t<@fl(CNa>q*@<Ke8x6)qTRogS^&8FL8DyA4
zXTq7;w-~eZC<qOjy8UQeMvJwp3O35*1~F?EIzp+(A2)R51$A9_COwO<ql6Mxb7s1_
z5b09`CnH<}8h3SACWD{2;Mw(!8?k5uyogAyt#aErNfV1w0aKpS(EQzdL`#!<@UiX2
zna{7r-=&7&PO9>wA?032h-n+}hgXA<6SFPRZFy#7sd@F+s*t1=wY_Oa3HDuPF806>
z{SD}9mjQ8cWdLm-sFp_YsPx;sxrdzd`lj^!O5jnEh^>Y4gZ%qR1YRw~Z@H-N^ODW>
z!^0V8<3c(YiYpJnnC|5DUrqML8G<AHNbc{<UIEgLkn<o@^#Cd)sI&(qR=HSS)}%Ya
zP|?rY$0ebIVlNE$)uBJ9wrcq}RJ*R}VKAg46eqB2%yD_0zkEHpF9bF{XkO8eglSiZ
zNtaWS=YFrE-`_c5+QzPx=%kihxW&t4QedI=K3N&4WS_Ot1W*!*dd9iypL@l>c;^lV
zZ(#)es|mvIEn|-(*z9RKjg&%as;g*?XB;)_j?m3Ude?Qgo|*lYf@MCRxyfbg2EVF%
zV#15JG^h9wDGB&d(zc`7^6*HAimJx?U{aDv&bSbp?LZ>hE>+vyaz?uzcO3sTw{CT|
zWwIe|a9a_sbu9HR9_zL-VOtLmJgVL=D&(m=XskiGy{%GQTG7E>;1*IzjkPUP3I6LF
zZsn>W)+ED4@a=H}9Knf00Toq!R;5cNm)~+vNVt|>+_*Ipp|yB#tfXIu;a+(>%wPxJ
z=5n>NsjP+eWD}F1_)TJbUOqIxfHe|qn|jOv4@(RkXz3LtL#Rq}vpNqUxp&9mY@NFH
zEGBW{*7uBXCr@+ui#+?@_E|K&GX{2~K<#h>Ol}jp8NO%1WnQ^Kudl+Cc*BkO1T+FA
zW<|sF+$_W50^>`GPJsK;J(HhOa0&m)!?RX+L+YyykTVpysa>os|EA8)PHv&IK&1(2
zJY;}yhODkCb<o9fwx~Y&EC0&17@#lpvIR&|cbd>OV3Eeph}R2mT$v_26$n`d3b00$
zPZ4>|s=R*`tK({!;zfk(5}KYZeJgH=Qu6vm1mHuwICKf#woCL`yKmF|zB#~_J%AK@
zHLNir^j@T$ahd0_kwrBt+G;pgbjaY{?P?yUC;dbN;mHgoTovvNLuu|<rHq?)3U<W4
zsD-5_W;-<Izd(6(^nX|1jVM(6YggiLeJIM8bvPpO<{|iyGsy*e3SPL{W*-tBmXQ1q
zar>Jx8%uJRqU+BgOXj;AOBJeoV(foU*O7>nv}-*fLYmc3Jw1=*t35xYJSZa(tG1Wk
z@wo~aZhb6&N}IEM6np!y+K4QgK6s$9P-*>w*IoNwgZYW(H8B*}ZBZIrjib*)!3sSC
zCSqy^**HzT%nyq&yv&bT1Z4Mi_4BP-yHT&!WF`5%VH7W3*pKm3>JkCXo-dqP4GA4w
z?@e7#7u2{dX-)wynV?;g9iTIH5=qqg&|_}huaO60LE=_ti<2#=y@;pD`W7@Qjx4kJ
zv}xss*i+`pnsWW>cQzolQ^qLhZ=e2;b$XUf<h%>&K3{KR`*j)UO}*K{8xFkTz#9(y
sKRGaJv4&BL<=<50UTb6bXB@Q!X)0E0?E4TxD*}oPj}GhnChhWn0P#05jQ{`u

literal 0
HcmV?d00001

diff --git a/dogfood/issue-64-share-screenshot-capture/after/screenshot-offline-default.png b/dogfood/issue-64-share-screenshot-capture/after/screenshot-offline-default.png
new file mode 100644
index 0000000000000000000000000000000000000000..2f9738ba177ff40d4c6dd8bcf6f5bb3c3f13e3a1
GIT binary patch
literal 3749
zcmeH~=~LPV8plbT#HOh=yV-0v8g)C_O^+nf#2Abym|}HfqBixQXq0qQCBdsiMMMF!
zX=6K$rin4cc;Hbb4IYh(s3_!UVJaf^Kq4R>1c-78C_j*E-G8Ak_ElbdXP)`a^Xi$;
z^PTyA_h~|`&zpX4f<PdjGyjVI3<TO<0RnBScw_sP(;FMT0s_6Ab|(6CGNC~y-}OWC
z#x=ev<}Y7@d?WTmpS#KL9VWCbUps%0mm{9Po7#G2e?)54FNbHarCo#3d-owPJ!wAn
zVT|b+l#qKu+kMRR@t^kGMnp%Q|Hx~#qSZkgj~fb`pV+f3%7D>USBWn5Mw!Q5l0qqU
z-A6GoBE>$?;`d^_FqBO;!~{T#6^{V?JR5kJEIo4J(*@mTaK@}lnw?&xRkX<!q>`o9
zPkaQrFDo1Ik(+}x^h8p-JJFb&8dsm^W(7d;&h44xJ|orcZTk$hQOL3xDr(+_>AoGv
zligE6W9C0H4=)M3(K%hgWdQu=l~}|?(E3b`XK0)pcb_GDY;0szcXoDG`+c=MF6r<r
zW2pVk4~hezjb%$&&$|b0;wwpMw!2s(lA)%Ys@@&NC?{6{woMK&U##_!WNu8x28lC0
zeJzMFmmYvCbYw$7<Rkfq{V}ouM*d_DV|aMtC?$>wFj6es1N<G$Dem{4I1C;@mMfu`
zFWyV)PmihoeDLDasiRU>0lbj6o&^);bb2~RIk>1f%CtEJL2*iNUWpg*n+Th72nLMm
z{ZbZy55}aaUgn;5K?OJIxe==!Ik3p4><#$h&s-T%#$<PfY}8VN0t-bqSCXiKL<fwd
z4aYZpl&_0yi#>`ZaIdKDjj{qD*18P9MkJA3q_)`j`tTtuu08{O$tmVdcf_lj5xzYp
zB6Y&kQ4fTxzfMA;vTDuK%0yV(k_#AnR>eJVk}NM|(wF;;XZtK@YdH^foqmpNuRbrK
zR%WpC2&>JOm`q4#OG}FsCwN{Lk~!)z$i^NNOVT|z`+^S;P4<HEI_3e(t|+BO2k{Np
zIryG6JxlFg0&Z<6vK@us18J$`teW`PTcxe?@ZwD6k4d83G?@7n<<S6#cTDjBih1_E
zD6uZ$r-tO>hm7=La$6ObxcF{miShAdQX))&q0UdZBrWk;0iha(U(}&OXapxKeM4bw
zcuEzMeH`oXSI`A0e(INZjKeO8%B=Z>>S`^&o;GWA2oZ51YEhZPH_@3dAv@mU*v2~a
z67BHQYN%dXa%<GBHN`@E9;<&iTiG)-D-Eqq&m%ESNdLsg$^>@L0@Hy(8!;Mg|D$u#
zAHP!y%>5sLsj90CoPB`jn9@0^AH$EU6$h*Res9wt$DY?DoGLUe{|e@;U8qu8<%F6I
zHa>?)WaAmsQD%;Wd`i8yB5r#BTE5F#x_;ZcJAhn@Y6^3I(*ozVqytszaUyALj$Rw8
ziq<^!HuyoTE4>kAvs#O0RIJ<d;}gEng{TIs(hMuy7Ie=(d3G-^gOsHVo!mc7&#+B1
zW>F=hQ!Vp=yky+fCO}DOGzb3+$$Ta+q--`vY~?P+_=^a|*lB>Fl3MoFK8@D`atxP3
zS>xo~2qhcf7XAW_tlr^Yq=jLuo#wB8yL0PC1JKsH_TnISDEs9+TQ{J&?}$M{^Q%lJ
zpl+=4iqtJ#LQv;8b9S%;j6PVBd8y0G*FKBzm51P*FXH0GiXK0UM>n15=C}FQT5Oe+
zLI4SwD_X=Y<jY06x~}m2np7cXM@0vSTG&yd78MX903l?|m6p?!1bbiLUDR&s+juTP
zmocvlondYWTHH0pi-J<@P!B`9j?c=cCp4a%EBfB}cGyo-w#K~rcI8h4HT<A5Tg7#5
zvEdtPJndwAu9dw2>$izK-fW#Fk=Ag0f>byGrxE2-^dk>x+@jL;Jcy7?%AU3g16e%6
zg8&NCluQ~;QFEvKe0+>xzT^1vqq83U>TT6Jpg~?ZL2-|anX%&XRM6$kH;0AvK#J4E
zuLai}Z!%xY<V1Hp7S13KHCnG5M^Bi3?a8x3_@2eschIobl|N_io~Hm^A~=w|`<6rU
zw?w>K){n|!;`JXMPGG3_UThZ=c8**&dFx^JHw?eGAcoK*HrE)sS?IyWF=|cc%5l1*
z2Yd4DN!b(k$=Z1Ck=?3QWl#PPS8^}?RuCYkqmgVYBMA4h!rL&U?;0u?unr!^Mub+g
z|E=Mwsv}p{ePN#$@gMqEM=tf7z&9HKtK82YjJ<q$fkT?US~<+aaR9}$G#QJm0Hp?2
zVY2t~B9Xz8yajr}P&9EJ=cN(VL-NL6j+u#;syR~0LJoT?$5`<YW6JEh^lE+Yh<H{;
zRS5@P^d2eLN>0DB_mwLwfGo@9CY{1XybR)!lzEp@(W8hey>}CCLiId$R$P2U;BS2~
zDCdT7O}iB)a7210lGa#a96k+f<NG>!WN)!V0_Nk8GX(4bmek2*|4iQcGnsxcX}Wx%
zr&Nx8B&48Tv5+1C<+x4lA9J^dBY0=>ENx1MLzAzR(=s;ogO+^NXNINNKnt${rP_{f
zS8K82k!_vHexizkO|dwq1f?0b1n0{J^jir-DR(#Db6!0k3RwtiZAjRVu_-9BdyX!G
z=Pd5>61}*rjDJ8Tj_;!1b^KOy=&jAAV`A&4yrkg2Hj$qGGb=*%^~RldF_058;Ri=F
z6ZPQ1S7Y^t^1&&>j-uc6tP7sa@%>qLp7uuV-rrAa-ul3S8f+%pYT+5qI<823N7?<*
zG!vH3w1aoE<YCJXjkFi)Z+YN-I|G5ncJ43YtHKG-4h)TGUeU;*#F>|8sys_}GtDVz
zM`kQgJcyw3i$zSOVpFS4&B$XW?QE2^Am;lLBj?sB94xmxRp|dDu3bpA7Mw0w?T=v@
zB0EORQ)qL~HJ+=;a3KMKu5(V^@rCD3T2rdotvm}Q!+xB5mRhVCZ<>3i7y3u_aYnZ7
ztnlz*p2YLpL5CYaUQto?m_sK#_5Y|eNLbrJ&f+kyofV+1r9YyIlaXcCZV(841oH&6
z=kKre`UbBVc+J3T2L7)MtSxMHOpnJT|FLCj*!jPf=>@v@!;LTAgT^&&IiNG2Bt&<A
IeDOd31!CHMIRF3v

literal 0
HcmV?d00001

diff --git a/dogfood/issue-64-share-screenshot-capture/after/screenshot-offline-show-cursor.png b/dogfood/issue-64-share-screenshot-capture/after/screenshot-offline-show-cursor.png
new file mode 100644
index 0000000000000000000000000000000000000000..2f9738ba177ff40d4c6dd8bcf6f5bb3c3f13e3a1
GIT binary patch
literal 3749
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
IeDOd31!CHMIRF3v

literal 0
HcmV?d00001

diff --git a/dogfood/issue-64-share-screenshot-capture/after/sha256-summary.txt b/dogfood/issue-64-share-screenshot-capture/after/sha256-summary.txt
new file mode 100644
index 0000000..3737de7
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/sha256-summary.txt
@@ -0,0 +1,8 @@
+screenshot-live-default.png:
+a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb
+screenshot-live-show-cursor.png:
+a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb
+screenshot-offline-default.png:
+993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d
+screenshot-offline-show-cursor.png:
+993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d
diff --git a/dogfood/issue-64-share-screenshot-capture/after/transcript.txt b/dogfood/issue-64-share-screenshot-capture/after/transcript.txt
new file mode 100644
index 0000000..0c789bf
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/after/transcript.txt
@@ -0,0 +1,152 @@
+Running with label: after
+Repo HEAD: b2d506802110a97ebd4cc8b985970a19211fd36b
++ npx tsx src/cli/main.ts create --json --name issue-64-live -- /bin/sh -c printf\ \"live\ screenshot\ fixture\\n\"\;\ sleep\ 60
+{
+  "ok": true,
+  "command": "create",
+  "timestamp": "2026-04-30T07:53:01.428Z",
+  "result": {
+    "sessionId": "01KQEP0YDSTXK6A7EB7ABAK8SS",
+    "createdAt": "2026-04-30T07:53:00.604Z",
+    "cols": 80,
+    "rows": 24,
+    "shell": "/bin/bash"
+  }
+}
+
++ npx tsx src/cli/main.ts wait 01KQEP0YDSTXK6A7EB7ABAK8SS --text live\ screenshot\ fixture --timeout 5000 --json
+{
+  "ok": true,
+  "command": "wait",
+  "timestamp": "2026-04-30T07:53:03.114Z",
+  "result": {
+    "matched": true,
+    "timedOut": false,
+    "matchedText": "live screenshot fixture",
+    "cursorRow": 1,
+    "cursorCol": 0,
+    "capturedAtSeq": 0
+  }
+}
+
++ npx tsx src/cli/main.ts screenshot 01KQEP0YDSTXK6A7EB7ABAK8SS --json
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:53:04.412Z",
+  "result": {
+    "sessionId": "01KQEP0YDSTXK6A7EB7ABAK8SS",
+    "capturedAtSeq": 0,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.p97cQahYjP/sessions/01KQEP0YDSTXK6A7EB7ABAK8SS/artifacts/screenshot-0-reference-dark.png",
+    "pngSizeBytes": 3790,
+    "cursorVisible": false,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
+
++ npx tsx src/cli/main.ts screenshot 01KQEP0YDSTXK6A7EB7ABAK8SS --show-cursor --json
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:53:05.670Z",
+  "result": {
+    "sessionId": "01KQEP0YDSTXK6A7EB7ABAK8SS",
+    "capturedAtSeq": 0,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.p97cQahYjP/sessions/01KQEP0YDSTXK6A7EB7ABAK8SS/artifacts/screenshot-0-reference-dark.png",
+    "pngSizeBytes": 3790,
+    "cursorVisible": true,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
+
++ npx tsx src/cli/main.ts create --json --name issue-64-offline -- /bin/sh -c printf\ \"offline\ screenshot\ fixture\\n\"
+{
+  "ok": true,
+  "command": "create",
+  "timestamp": "2026-04-30T07:53:07.504Z",
+  "result": {
+    "sessionId": "01KQEP14EXSSGJX9RRSTAVYGK2",
+    "createdAt": "2026-04-30T07:53:06.784Z",
+    "cols": 80,
+    "rows": 24,
+    "shell": "/bin/bash"
+  }
+}
+
++ npx tsx src/cli/main.ts wait 01KQEP14EXSSGJX9RRSTAVYGK2 --exit --timeout 10000 --json
+{
+  "ok": true,
+  "command": "wait",
+  "timestamp": "2026-04-30T07:53:08.644Z",
+  "result": {
+    "timedOut": false,
+    "exitCode": 0
+  }
+}
+
++ npx tsx src/cli/main.ts screenshot 01KQEP14EXSSGJX9RRSTAVYGK2 --json
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:53:10.283Z",
+  "result": {
+    "sessionId": "01KQEP14EXSSGJX9RRSTAVYGK2",
+    "capturedAtSeq": 1,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.p97cQahYjP/sessions/01KQEP14EXSSGJX9RRSTAVYGK2/artifacts/screenshot-1-reference-dark.png",
+    "pngSizeBytes": 3749,
+    "cursorVisible": false,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
+
++ npx tsx src/cli/main.ts screenshot 01KQEP14EXSSGJX9RRSTAVYGK2 --show-cursor --json
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:53:16.766Z",
+  "result": {
+    "sessionId": "01KQEP14EXSSGJX9RRSTAVYGK2",
+    "capturedAtSeq": 1,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.p97cQahYjP/sessions/01KQEP14EXSSGJX9RRSTAVYGK2/artifacts/screenshot-1-reference-dark.png",
+    "pngSizeBytes": 3749,
+    "cursorVisible": true,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
+
+screenshot-live-default.png:
+a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb
+screenshot-live-show-cursor.png:
+a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb
+screenshot-offline-default.png:
+993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d
+screenshot-offline-show-cursor.png:
+993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d
diff --git a/dogfood/issue-64-share-screenshot-capture/before/01-create-live.json b/dogfood/issue-64-share-screenshot-capture/before/01-create-live.json
new file mode 100644
index 0000000..0c2d134
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/01-create-live.json
@@ -0,0 +1,12 @@
+{
+  "ok": true,
+  "command": "create",
+  "timestamp": "2026-04-30T07:54:21.162Z",
+  "result": {
+    "sessionId": "01KQEP3C9F2CMDX15SQWFTW9MK",
+    "createdAt": "2026-04-30T07:54:20.338Z",
+    "cols": 80,
+    "rows": 24,
+    "shell": "/bin/bash"
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/before/02-wait-live.json b/dogfood/issue-64-share-screenshot-capture/before/02-wait-live.json
new file mode 100644
index 0000000..403c3d1
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/02-wait-live.json
@@ -0,0 +1,13 @@
+{
+  "ok": true,
+  "command": "wait",
+  "timestamp": "2026-04-30T07:54:22.828Z",
+  "result": {
+    "matched": true,
+    "timedOut": false,
+    "matchedText": "live screenshot fixture",
+    "cursorRow": 1,
+    "cursorCol": 0,
+    "capturedAtSeq": 0
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/before/03-screenshot-live-default.json b/dogfood/issue-64-share-screenshot-capture/before/03-screenshot-live-default.json
new file mode 100644
index 0000000..6cc54fd
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/03-screenshot-live-default.json
@@ -0,0 +1,20 @@
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:54:24.088Z",
+  "result": {
+    "sessionId": "01KQEP3C9F2CMDX15SQWFTW9MK",
+    "capturedAtSeq": 0,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.XjcTHC008g/sessions/01KQEP3C9F2CMDX15SQWFTW9MK/artifacts/screenshot-0-reference-dark.png",
+    "pngSizeBytes": 3790,
+    "cursorVisible": false,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/before/04-screenshot-live-show-cursor.json b/dogfood/issue-64-share-screenshot-capture/before/04-screenshot-live-show-cursor.json
new file mode 100644
index 0000000..300de33
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/04-screenshot-live-show-cursor.json
@@ -0,0 +1,20 @@
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:54:25.484Z",
+  "result": {
+    "sessionId": "01KQEP3C9F2CMDX15SQWFTW9MK",
+    "capturedAtSeq": 0,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.XjcTHC008g/sessions/01KQEP3C9F2CMDX15SQWFTW9MK/artifacts/screenshot-0-reference-dark.png",
+    "pngSizeBytes": 3790,
+    "cursorVisible": true,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/before/10-create-offline.json b/dogfood/issue-64-share-screenshot-capture/before/10-create-offline.json
new file mode 100644
index 0000000..714bae0
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/10-create-offline.json
@@ -0,0 +1,12 @@
+{
+  "ok": true,
+  "command": "create",
+  "timestamp": "2026-04-30T07:54:27.342Z",
+  "result": {
+    "sessionId": "01KQEP3JANHPG9CKX3X9B2B15K",
+    "createdAt": "2026-04-30T07:54:26.519Z",
+    "cols": 80,
+    "rows": 24,
+    "shell": "/bin/bash"
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/before/11-wait-offline.json b/dogfood/issue-64-share-screenshot-capture/before/11-wait-offline.json
new file mode 100644
index 0000000..a1f0450
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/11-wait-offline.json
@@ -0,0 +1,9 @@
+{
+  "ok": true,
+  "command": "wait",
+  "timestamp": "2026-04-30T07:54:28.557Z",
+  "result": {
+    "timedOut": false,
+    "exitCode": 0
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/before/12-screenshot-offline-default.json b/dogfood/issue-64-share-screenshot-capture/before/12-screenshot-offline-default.json
new file mode 100644
index 0000000..cc9204a
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/12-screenshot-offline-default.json
@@ -0,0 +1,20 @@
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:54:30.111Z",
+  "result": {
+    "sessionId": "01KQEP3JANHPG9CKX3X9B2B15K",
+    "capturedAtSeq": 1,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.XjcTHC008g/sessions/01KQEP3JANHPG9CKX3X9B2B15K/artifacts/screenshot-1-reference-dark.png",
+    "pngSizeBytes": 3749,
+    "cursorVisible": false,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/before/13-screenshot-offline-show-cursor.json b/dogfood/issue-64-share-screenshot-capture/before/13-screenshot-offline-show-cursor.json
new file mode 100644
index 0000000..66a5750
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/13-screenshot-offline-show-cursor.json
@@ -0,0 +1,20 @@
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:54:36.717Z",
+  "result": {
+    "sessionId": "01KQEP3JANHPG9CKX3X9B2B15K",
+    "capturedAtSeq": 1,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.XjcTHC008g/sessions/01KQEP3JANHPG9CKX3X9B2B15K/artifacts/screenshot-1-reference-dark.png",
+    "pngSizeBytes": 3749,
+    "cursorVisible": true,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/before/98-destroy-offline.json b/dogfood/issue-64-share-screenshot-capture/before/98-destroy-offline.json
new file mode 100644
index 0000000..51a7681
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/98-destroy-offline.json
@@ -0,0 +1,9 @@
+{
+  "ok": true,
+  "command": "destroy",
+  "timestamp": "2026-04-30T07:54:44.132Z",
+  "result": {
+    "sessionId": "01KQEP3JANHPG9CKX3X9B2B15K",
+    "destroyed": true
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/before/99-destroy-live.json b/dogfood/issue-64-share-screenshot-capture/before/99-destroy-live.json
new file mode 100644
index 0000000..041174a
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/99-destroy-live.json
@@ -0,0 +1,9 @@
+{
+  "ok": true,
+  "command": "destroy",
+  "timestamp": "2026-04-30T07:54:43.071Z",
+  "result": {
+    "sessionId": "01KQEP3C9F2CMDX15SQWFTW9MK",
+    "destroyed": true
+  }
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/before/agent-tty-home.txt b/dogfood/issue-64-share-screenshot-capture/before/agent-tty-home.txt
new file mode 100644
index 0000000..83ca466
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/agent-tty-home.txt
@@ -0,0 +1 @@
+/tmp/tmp.XjcTHC008g
diff --git a/dogfood/issue-64-share-screenshot-capture/before/live-session-id.txt b/dogfood/issue-64-share-screenshot-capture/before/live-session-id.txt
new file mode 100644
index 0000000..78678c7
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/live-session-id.txt
@@ -0,0 +1 @@
+01KQEP3C9F2CMDX15SQWFTW9MK
diff --git a/dogfood/issue-64-share-screenshot-capture/before/manifest-live.json b/dogfood/issue-64-share-screenshot-capture/before/manifest-live.json
new file mode 100644
index 0000000..eaa18c5
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/manifest-live.json
@@ -0,0 +1,46 @@
+{
+  "version": 1,
+  "sessionId": "01KQEP3C9F2CMDX15SQWFTW9MK",
+  "artifacts": [
+    {
+      "id": "01KQEP3FYJCBS7P29WTCM3BCNQ",
+      "kind": "screenshot",
+      "filename": "screenshot-0-reference-dark.png",
+      "sessionId": "01KQEP3C9F2CMDX15SQWFTW9MK",
+      "capturedAtSeq": 0,
+      "createdAt": "2026-04-30T07:54:24.082Z",
+      "sha256": "a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb",
+      "metadata": {
+        "profileName": "reference-dark",
+        "cols": 80,
+        "rows": 24,
+        "pngSizeBytes": 3790,
+        "cursorVisible": false,
+        "rendererBackend": "ghostty-web",
+        "pixelWidth": 640,
+        "pixelHeight": 384,
+        "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+      }
+    },
+    {
+      "id": "01KQEP3HA9GE8KJW8CYQMBEDC1",
+      "kind": "screenshot",
+      "filename": "screenshot-0-reference-dark.png",
+      "sessionId": "01KQEP3C9F2CMDX15SQWFTW9MK",
+      "capturedAtSeq": 0,
+      "createdAt": "2026-04-30T07:54:25.481Z",
+      "sha256": "a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb",
+      "metadata": {
+        "profileName": "reference-dark",
+        "cols": 80,
+        "rows": 24,
+        "pngSizeBytes": 3790,
+        "cursorVisible": true,
+        "rendererBackend": "ghostty-web",
+        "pixelWidth": 640,
+        "pixelHeight": 384,
+        "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+      }
+    }
+  ]
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/before/manifest-offline.json b/dogfood/issue-64-share-screenshot-capture/before/manifest-offline.json
new file mode 100644
index 0000000..f250b71
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/manifest-offline.json
@@ -0,0 +1,46 @@
+{
+  "version": 1,
+  "sessionId": "01KQEP3JANHPG9CKX3X9B2B15K",
+  "artifacts": [
+    {
+      "id": "01KQEP3NSKDDYAV1QXM953RNMH",
+      "kind": "screenshot",
+      "filename": "screenshot-1-reference-dark.png",
+      "sessionId": "01KQEP3JANHPG9CKX3X9B2B15K",
+      "capturedAtSeq": 1,
+      "createdAt": "2026-04-30T07:54:30.067Z",
+      "sha256": "993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d",
+      "metadata": {
+        "profileName": "reference-dark",
+        "cols": 80,
+        "rows": 24,
+        "pngSizeBytes": 3749,
+        "cursorVisible": false,
+        "rendererBackend": "ghostty-web",
+        "pixelWidth": 640,
+        "pixelHeight": 384,
+        "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+      }
+    },
+    {
+      "id": "01KQEP3W85YF3P43GJCXNZPKC3",
+      "kind": "screenshot",
+      "filename": "screenshot-1-reference-dark.png",
+      "sessionId": "01KQEP3JANHPG9CKX3X9B2B15K",
+      "capturedAtSeq": 1,
+      "createdAt": "2026-04-30T07:54:36.677Z",
+      "sha256": "993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d",
+      "metadata": {
+        "profileName": "reference-dark",
+        "cols": 80,
+        "rows": 24,
+        "pngSizeBytes": 3749,
+        "cursorVisible": true,
+        "rendererBackend": "ghostty-web",
+        "pixelWidth": 640,
+        "pixelHeight": 384,
+        "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+      }
+    }
+  ]
+}
diff --git a/dogfood/issue-64-share-screenshot-capture/before/offline-session-id.txt b/dogfood/issue-64-share-screenshot-capture/before/offline-session-id.txt
new file mode 100644
index 0000000..f89499d
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/offline-session-id.txt
@@ -0,0 +1 @@
+01KQEP3JANHPG9CKX3X9B2B15K
diff --git a/dogfood/issue-64-share-screenshot-capture/before/screenshot-live-default.png b/dogfood/issue-64-share-screenshot-capture/before/screenshot-live-default.png
new file mode 100644
index 0000000000000000000000000000000000000000..376bebca63b7baab69291584fba8253ffcb91b47
GIT binary patch
literal 3790
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

literal 0
HcmV?d00001

diff --git a/dogfood/issue-64-share-screenshot-capture/before/screenshot-live-show-cursor.png b/dogfood/issue-64-share-screenshot-capture/before/screenshot-live-show-cursor.png
new file mode 100644
index 0000000000000000000000000000000000000000..376bebca63b7baab69291584fba8253ffcb91b47
GIT binary patch
literal 3790
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

literal 0
HcmV?d00001

diff --git a/dogfood/issue-64-share-screenshot-capture/before/screenshot-offline-default.png b/dogfood/issue-64-share-screenshot-capture/before/screenshot-offline-default.png
new file mode 100644
index 0000000000000000000000000000000000000000..2f9738ba177ff40d4c6dd8bcf6f5bb3c3f13e3a1
GIT binary patch
literal 3749
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
IeDOd31!CHMIRF3v

literal 0
HcmV?d00001

diff --git a/dogfood/issue-64-share-screenshot-capture/before/screenshot-offline-show-cursor.png b/dogfood/issue-64-share-screenshot-capture/before/screenshot-offline-show-cursor.png
new file mode 100644
index 0000000000000000000000000000000000000000..2f9738ba177ff40d4c6dd8bcf6f5bb3c3f13e3a1
GIT binary patch
literal 3749
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
IeDOd31!CHMIRF3v

literal 0
HcmV?d00001

diff --git a/dogfood/issue-64-share-screenshot-capture/before/sha256-summary.txt b/dogfood/issue-64-share-screenshot-capture/before/sha256-summary.txt
new file mode 100644
index 0000000..3737de7
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/sha256-summary.txt
@@ -0,0 +1,8 @@
+screenshot-live-default.png:
+a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb
+screenshot-live-show-cursor.png:
+a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb
+screenshot-offline-default.png:
+993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d
+screenshot-offline-show-cursor.png:
+993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d
diff --git a/dogfood/issue-64-share-screenshot-capture/before/transcript.txt b/dogfood/issue-64-share-screenshot-capture/before/transcript.txt
new file mode 100644
index 0000000..2e2f361
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/before/transcript.txt
@@ -0,0 +1,152 @@
+Running with label: before
+Repo HEAD: b2d506802110a97ebd4cc8b985970a19211fd36b
++ npx tsx src/cli/main.ts create --json --name issue-64-live -- /bin/sh -c printf\ \"live\ screenshot\ fixture\\n\"\;\ sleep\ 60
+{
+  "ok": true,
+  "command": "create",
+  "timestamp": "2026-04-30T07:54:21.162Z",
+  "result": {
+    "sessionId": "01KQEP3C9F2CMDX15SQWFTW9MK",
+    "createdAt": "2026-04-30T07:54:20.338Z",
+    "cols": 80,
+    "rows": 24,
+    "shell": "/bin/bash"
+  }
+}
+
++ npx tsx src/cli/main.ts wait 01KQEP3C9F2CMDX15SQWFTW9MK --text live\ screenshot\ fixture --timeout 5000 --json
+{
+  "ok": true,
+  "command": "wait",
+  "timestamp": "2026-04-30T07:54:22.828Z",
+  "result": {
+    "matched": true,
+    "timedOut": false,
+    "matchedText": "live screenshot fixture",
+    "cursorRow": 1,
+    "cursorCol": 0,
+    "capturedAtSeq": 0
+  }
+}
+
++ npx tsx src/cli/main.ts screenshot 01KQEP3C9F2CMDX15SQWFTW9MK --json
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:54:24.088Z",
+  "result": {
+    "sessionId": "01KQEP3C9F2CMDX15SQWFTW9MK",
+    "capturedAtSeq": 0,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.XjcTHC008g/sessions/01KQEP3C9F2CMDX15SQWFTW9MK/artifacts/screenshot-0-reference-dark.png",
+    "pngSizeBytes": 3790,
+    "cursorVisible": false,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
+
++ npx tsx src/cli/main.ts screenshot 01KQEP3C9F2CMDX15SQWFTW9MK --show-cursor --json
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:54:25.484Z",
+  "result": {
+    "sessionId": "01KQEP3C9F2CMDX15SQWFTW9MK",
+    "capturedAtSeq": 0,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.XjcTHC008g/sessions/01KQEP3C9F2CMDX15SQWFTW9MK/artifacts/screenshot-0-reference-dark.png",
+    "pngSizeBytes": 3790,
+    "cursorVisible": true,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
+
++ npx tsx src/cli/main.ts create --json --name issue-64-offline -- /bin/sh -c printf\ \"offline\ screenshot\ fixture\\n\"
+{
+  "ok": true,
+  "command": "create",
+  "timestamp": "2026-04-30T07:54:27.342Z",
+  "result": {
+    "sessionId": "01KQEP3JANHPG9CKX3X9B2B15K",
+    "createdAt": "2026-04-30T07:54:26.519Z",
+    "cols": 80,
+    "rows": 24,
+    "shell": "/bin/bash"
+  }
+}
+
++ npx tsx src/cli/main.ts wait 01KQEP3JANHPG9CKX3X9B2B15K --exit --timeout 10000 --json
+{
+  "ok": true,
+  "command": "wait",
+  "timestamp": "2026-04-30T07:54:28.557Z",
+  "result": {
+    "timedOut": false,
+    "exitCode": 0
+  }
+}
+
++ npx tsx src/cli/main.ts screenshot 01KQEP3JANHPG9CKX3X9B2B15K --json
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:54:30.111Z",
+  "result": {
+    "sessionId": "01KQEP3JANHPG9CKX3X9B2B15K",
+    "capturedAtSeq": 1,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.XjcTHC008g/sessions/01KQEP3JANHPG9CKX3X9B2B15K/artifacts/screenshot-1-reference-dark.png",
+    "pngSizeBytes": 3749,
+    "cursorVisible": false,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
+
++ npx tsx src/cli/main.ts screenshot 01KQEP3JANHPG9CKX3X9B2B15K --show-cursor --json
+{
+  "ok": true,
+  "command": "screenshot",
+  "timestamp": "2026-04-30T07:54:36.717Z",
+  "result": {
+    "sessionId": "01KQEP3JANHPG9CKX3X9B2B15K",
+    "capturedAtSeq": 1,
+    "profileName": "reference-dark",
+    "cols": 80,
+    "rows": 24,
+    "artifactPath": "/tmp/tmp.XjcTHC008g/sessions/01KQEP3JANHPG9CKX3X9B2B15K/artifacts/screenshot-1-reference-dark.png",
+    "pngSizeBytes": 3749,
+    "cursorVisible": true,
+    "rendererBackend": "ghostty-web",
+    "pixelWidth": 640,
+    "pixelHeight": 384,
+    "sha256": "993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d",
+    "renderProfileHash": "8ffed6af301ec7c0e6b69599c3be0d1d12096f9fcdfc59d0bbb4cc474d64c53d"
+  }
+}
+
+screenshot-live-default.png:
+a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb
+screenshot-live-show-cursor.png:
+a658e720e18b2943fd6203e8947a9fe4e60fa0759cb5d0f9c74668abfe267ceb
+screenshot-offline-default.png:
+993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d
+screenshot-offline-show-cursor.png:
+993fb5f9fe5b9ec7ed456b4005ec40478f5ee6bc3c6d5a65f6dbc78fbd60406d
diff --git a/dogfood/issue-64-share-screenshot-capture/commands.sh b/dogfood/issue-64-share-screenshot-capture/commands.sh
new file mode 100755
index 0000000..1110bd6
--- /dev/null
+++ b/dogfood/issue-64-share-screenshot-capture/commands.sh
@@ -0,0 +1,126 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Issue 64: Share screenshot capture and artifact persistence.
+#
+# This script captures four screenshot scenarios:
+#
+# 1. Live (running session) screenshot, default cursor.
+# 2. Live (running session) screenshot, --show-cursor.
+# 3. Offline (destroyed session) screenshot, default cursor.
+# 4. Offline (destroyed session) screenshot, --show-cursor.
+#
+# It records each screenshot's JSON envelope, the captured PNG, and the
+# session's artifact manifest entry so a reviewer can compare the live and
+# offline paths field-by-field. Run twice — once on the refactor branch and
+# once on the parent commit — to compare before/after parity:
+#
+#   bash dogfood/issue-64-share-screenshot-capture/commands.sh refactor
+#   bash dogfood/issue-64-share-screenshot-capture/commands.sh main
+#
+# Each invocation writes to the corresponding sub-directory under the bundle.
+
+BUNDLE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO="$(cd "$BUNDLE/../.." && pwd)"
+LABEL="${1:-after}"
+OUT="$BUNDLE/$LABEL"
+mkdir -p "$OUT"
+
+export AGENT_TTY_HOME="$(mktemp -d)"
+printf '%s\n' "$AGENT_TTY_HOME" > "$OUT/agent-tty-home.txt"
+
+cd "$REPO"
+exec > >(tee "$OUT/transcript.txt") 2>&1
+printf 'Running with label: %s\nRepo HEAD: %s\n' "$LABEL" "$(git rev-parse HEAD)"
+
+run_json() {
+  local output="$1"
+  shift
+  printf '+'
+  for argument in "$@"; do
+    printf ' %q' "$argument"
+  done
+  printf '\n'
+  "$@" > "$output"
+  cat "$output"
+  printf '\n'
+}
+
+json_field() {
+  local file="$1"
+  local expression="$2"
+  node -e "const fs = require('node:fs'); const envelope = JSON.parse(fs.readFileSync(process.argv[1], 'utf8')); console.log($expression);" "$file"
+}
+
+cleanup() {
+  if [[ -n "${LIVE_SESSION_ID:-}" ]]; then
+    npx tsx src/cli/main.ts destroy "$LIVE_SESSION_ID" --json > "$OUT/99-destroy-live.json" || true
+  fi
+  if [[ -n "${OFFLINE_SESSION_ID:-}" ]]; then
+    npx tsx src/cli/main.ts destroy "$OFFLINE_SESSION_ID" --json > "$OUT/98-destroy-offline.json" || true
+  fi
+  if [[ -n "${AGENT_TTY_HOME:-}" ]]; then
+    rm -rf "$AGENT_TTY_HOME"
+  fi
+}
+trap cleanup EXIT
+
+# --- Live session: capture screenshots while it is still running. ---
+run_json "$OUT/01-create-live.json" \
+  npx tsx src/cli/main.ts create --json --name issue-64-live -- /bin/sh -c 'printf "live screenshot fixture\n"; sleep 60'
+LIVE_SESSION_ID="$(json_field "$OUT/01-create-live.json" 'envelope.result.sessionId')"
+printf '%s\n' "$LIVE_SESSION_ID" > "$OUT/live-session-id.txt"
+
+# Wait for the prompt to settle so the rendered output is deterministic.
+run_json "$OUT/02-wait-live.json" \
+  npx tsx src/cli/main.ts wait "$LIVE_SESSION_ID" --text 'live screenshot fixture' --timeout 5000 --json
+
+run_json "$OUT/03-screenshot-live-default.json" \
+  npx tsx src/cli/main.ts screenshot "$LIVE_SESSION_ID" --json
+LIVE_DEFAULT_PATH="$(json_field "$OUT/03-screenshot-live-default.json" 'envelope.result.artifactPath')"
+cp "$LIVE_DEFAULT_PATH" "$OUT/screenshot-live-default.png"
+
+run_json "$OUT/04-screenshot-live-show-cursor.json" \
+  npx tsx src/cli/main.ts screenshot "$LIVE_SESSION_ID" --show-cursor --json
+LIVE_CURSOR_PATH="$(json_field "$OUT/04-screenshot-live-show-cursor.json" 'envelope.result.artifactPath')"
+cp "$LIVE_CURSOR_PATH" "$OUT/screenshot-live-show-cursor.png"
+
+LIVE_SESSION_DIR="$AGENT_TTY_HOME/sessions/$LIVE_SESSION_ID"
+cp "$LIVE_SESSION_DIR/artifacts/manifest.json" "$OUT/manifest-live.json"
+
+# --- Offline session: capture screenshots after the session has exited. ---
+run_json "$OUT/10-create-offline.json" \
+  npx tsx src/cli/main.ts create --json --name issue-64-offline -- /bin/sh -c 'printf "offline screenshot fixture\n"'
+OFFLINE_SESSION_ID="$(json_field "$OUT/10-create-offline.json" 'envelope.result.sessionId')"
+printf '%s\n' "$OFFLINE_SESSION_ID" > "$OUT/offline-session-id.txt"
+
+# Wait for the short-lived session to exit so subsequent screenshot RPCs
+# fall through to the offline replay path.
+run_json "$OUT/11-wait-offline.json" \
+  npx tsx src/cli/main.ts wait "$OFFLINE_SESSION_ID" --exit --timeout 10000 --json
+
+run_json "$OUT/12-screenshot-offline-default.json" \
+  npx tsx src/cli/main.ts screenshot "$OFFLINE_SESSION_ID" --json
+OFFLINE_DEFAULT_PATH="$(json_field "$OUT/12-screenshot-offline-default.json" 'envelope.result.artifactPath')"
+cp "$OFFLINE_DEFAULT_PATH" "$OUT/screenshot-offline-default.png"
+
+run_json "$OUT/13-screenshot-offline-show-cursor.json" \
+  npx tsx src/cli/main.ts screenshot "$OFFLINE_SESSION_ID" --show-cursor --json
+OFFLINE_CURSOR_PATH="$(json_field "$OUT/13-screenshot-offline-show-cursor.json" 'envelope.result.artifactPath')"
+cp "$OFFLINE_CURSOR_PATH" "$OUT/screenshot-offline-show-cursor.png"
+
+OFFLINE_SESSION_DIR="$AGENT_TTY_HOME/sessions/$OFFLINE_SESSION_ID"
+cp "$OFFLINE_SESSION_DIR/artifacts/manifest.json" "$OUT/manifest-offline.json"
+
+# Record SHA-256 sums for quick visual diffing across before/after runs.
+{
+  printf 'screenshot-live-default.png:\n'
+  json_field "$OUT/03-screenshot-live-default.json" 'envelope.result.sha256'
+  printf 'screenshot-live-show-cursor.png:\n'
+  json_field "$OUT/04-screenshot-live-show-cursor.json" 'envelope.result.sha256'
+  printf 'screenshot-offline-default.png:\n'
+  json_field "$OUT/12-screenshot-offline-default.json" 'envelope.result.sha256'
+  printf 'screenshot-offline-show-cursor.png:\n'
+  json_field "$OUT/13-screenshot-offline-show-cursor.json" 'envelope.result.sha256'
+} > "$OUT/sha256-summary.txt"
+cat "$OUT/sha256-summary.txt"
diff --git a/src/cli/commands/screenshot.ts b/src/cli/commands/screenshot.ts
index 0e9f2fe..691b4f4 100644
--- a/src/cli/commands/screenshot.ts
+++ b/src/cli/commands/screenshot.ts
@@ -1,7 +1,3 @@
-import { rename, rm } from 'node:fs/promises';
-
-import { ulid } from 'ulid';
-
 import type { ScreenshotResult } from '../../protocol/messages.js';
 
 import type { CommandContext } from '../context.js';
@@ -10,25 +6,18 @@ import { emitSuccess } from '../output.js';
 import { CliError } from '../../cli/errors.js';
 import { sendRpc } from '../../host/rpcClient.js';
 import { ScreenshotParamsSchema } from '../../protocol/messages.js';
-import { ScreenshotResultSchema } from '../../protocol/schemas.js';
 import { ERROR_CODES, makeCliError } from '../../protocol/errors.js';
 import { withOfflineReplayRenderer } from '../../replay/offlineReplay.js';
 import {
-  appendArtifact,
-  createArtifactEntry,
-} from '../../storage/artifactManifest.js';
-import {
-  artifactPath,
-  ensureArtifactsDir,
-  screenshotFilename,
-} from '../../storage/artifactPaths.js';
+  captureScreenshotResult,
+  parseScreenshotResult,
+} from '../../screenshot/capture.js';
 import { readManifestIfExists } from '../../storage/manifests.js';
 import {
   manifestPath,
   sessionDir,
   socketPath,
 } from '../../storage/sessionPaths.js';
-import { invariant } from '../../util/assert.js';
 
 const DEFAULT_SCREENSHOT_PROFILE = 'reference-dark';
 
@@ -113,21 +102,6 @@ function formatScreenshotLines(result: ScreenshotResult): string[] {
   return lines;
 }
 
-function parseScreenshotResult(
-  rawResult: unknown,
-  invalidResultMessage: string,
-): ScreenshotResult {
-  const parsedResult = ScreenshotResultSchema.safeParse(rawResult);
-  if (!parsedResult.success) {
-    throw makeCliError(ERROR_CODES.PROTOCOL_ERROR, {
-      message: invalidResultMessage,
-      details: { issues: parsedResult.error.issues },
-    });
-  }
-
-  return parsedResult.data;
-}
-
 async function runOfflineScreenshot(
   sessionDirectory: string,
   rendererName: CommandContext['rendererDefault'],
@@ -136,83 +110,14 @@ async function runOfflineScreenshot(
 ): Promise<ScreenshotResult> {
   return withOfflineReplayRenderer(
     { sessionDir: sessionDirectory, profileName: profile, rendererName },
-    async ({ backend, manifest }) => {
-      await ensureArtifactsDir(sessionDirectory);
-      const temporaryOutputPath = artifactPath(
-        sessionDirectory,
-        `.tmp-screenshot-${ulid()}.png`,
-      );
-
-      try {
-        const result = await backend.screenshot(
-          temporaryOutputPath,
-          showCursor === undefined ? undefined : { showCursor },
-        );
-        invariant(
-          result.sessionId === manifest.sessionId,
-          'offline screenshot sessionId must match the manifest sessionId',
-        );
-        invariant(
-          result.profileName === profile,
-          'offline screenshot profileName must match the requested profile',
-        );
-        invariant(
-          result.pngSizeBytes > 0,
-          'offline screenshot pngSizeBytes must be positive',
-        );
-        invariant(
-          result.sha256 !== undefined,
-          'offline screenshot must produce sha256',
-        );
-
-        const filename = screenshotFilename(
-          result.capturedAtSeq,
-          result.profileName,
-        );
-        const finalArtifactPath = artifactPath(sessionDirectory, filename);
-        await rename(temporaryOutputPath, finalArtifactPath);
-        await appendArtifact(
-          sessionDirectory,
-          createArtifactEntry({
-            kind: 'screenshot',
-            filename,
-            sessionId: result.sessionId,
-            capturedAtSeq: result.capturedAtSeq,
-            sha256: result.sha256,
-            metadata: {
-              profileName: result.profileName,
-              cols: result.cols,
-              rows: result.rows,
-              pngSizeBytes: result.pngSizeBytes,
-              cursorVisible: result.cursorVisible,
-              rendererBackend: result.rendererBackend,
-              pixelWidth: result.pixelWidth,
-              pixelHeight: result.pixelHeight,
-              renderProfileHash: result.renderProfileHash,
-            },
-          }),
-        );
-
-        return {
-          sessionId: result.sessionId,
-          capturedAtSeq: result.capturedAtSeq,
-          profileName: result.profileName,
-          cols: result.cols,
-          rows: result.rows,
-          artifactPath: finalArtifactPath,
-          pngSizeBytes: result.pngSizeBytes,
-          cursorVisible: result.cursorVisible,
-          rendererBackend: result.rendererBackend,
-          pixelWidth: result.pixelWidth,
-          pixelHeight: result.pixelHeight,
-          sha256: result.sha256,
-          renderProfileHash: result.renderProfileHash,
-        };
-      } catch (error) {
-        await rm(temporaryOutputPath, { force: true }).catch(() => undefined);
-        throw error;
-      }
-    },
+    async ({ backend, manifest }) =>
+      captureScreenshotResult({
+        backend,
+        sessionDir: sessionDirectory,
+        profileName: profile,
+        expectedSessionId: manifest.sessionId,
+        ...(showCursor === undefined ? {} : { showCursor }),
+      }),
   );
 }
 
@@ -252,19 +157,26 @@ export async function runScreenshotCommand(
     });
   }
 
-  let rawResult: unknown;
-  let invalidResultMessage = 'Unexpected response from host';
+  let result: ScreenshotResult;
 
   // Snapshot and screenshot intentionally keep their narrower legacy live-RPC
   // gate. `exiting` sessions are live-host eligible for inspect, but these
   // commands preserve their existing offline-replay capture behavior.
   if (manifest.status === 'running') {
     try {
-      rawResult = await sendRpc(socketPath(sessionDirectory), 'screenshot', {
-        profile,
-        rendererName: options.context.rendererDefault,
-        ...(showCursor === undefined ? {} : { showCursor }),
-      });
+      const rawResult = await sendRpc(
+        socketPath(sessionDirectory),
+        'screenshot',
+        {
+          profile,
+          rendererName: options.context.rendererDefault,
+          ...(showCursor === undefined ? {} : { showCursor }),
+        },
+      );
+      result = parseScreenshotResult(
+        rawResult,
+        'Unexpected response from host',
+      );
     } catch (error) {
       if (
         !(error instanceof CliError) ||
@@ -273,26 +185,22 @@ export async function runScreenshotCommand(
         throw error;
       }
 
-      rawResult = await runOfflineScreenshot(
+      result = await runOfflineScreenshot(
         sessionDirectory,
         options.context.rendererDefault,
         profile,
         showCursor,
       );
-      invalidResultMessage = 'Unexpected screenshot result from offline replay';
     }
   } else {
-    rawResult = await runOfflineScreenshot(
+    result = await runOfflineScreenshot(
       sessionDirectory,
       options.context.rendererDefault,
       profile,
       showCursor,
     );
-    invalidResultMessage = 'Unexpected screenshot result from offline replay';
   }
 
-  const result = parseScreenshotResult(rawResult, invalidResultMessage);
-
   emitSuccess({
     command: 'screenshot',
     json: options.json,
diff --git a/src/host/hostMain.ts b/src/host/hostMain.ts
index 84f1414..25ea8f8 100644
--- a/src/host/hostMain.ts
+++ b/src/host/hostMain.ts
@@ -1,9 +1,7 @@
-import { mkdir, rename, rm } from 'node:fs/promises';
+import { mkdir } from 'node:fs/promises';
 import { dirname } from 'node:path';
 import process from 'node:process';
 
-import { ulid } from 'ulid';
-
 import {
   matchRenderWaitSnapshot,
   prepareRenderWaitCondition,
@@ -41,16 +39,8 @@ import {
 } from '../renderer/names.js';
 import { resolveProfile } from '../renderer/profiles.js';
 import { createRendererBackend } from '../renderer/registry.js';
+import { captureScreenshotResult } from '../screenshot/capture.js';
 import { captureSnapshotResult } from '../snapshot/capture.js';
-import {
-  appendArtifact,
-  createArtifactEntry,
-} from '../storage/artifactManifest.js';
-import {
-  artifactPath,
-  ensureArtifactsDir,
-  screenshotFilename,
-} from '../storage/artifactPaths.js';
 import { resolveHome } from '../storage/home.js';
 import { readManifest, writeManifest } from '../storage/manifests.js';
 import {
@@ -436,83 +426,14 @@ export async function runHost(sessionId: string): Promise<void> {
         profile,
         replayInput,
       );
-      await ensureArtifactsDir(sessDir);
-      const temporaryOutputPath = artifactPath(
-        sessDir,
-        `.tmp-screenshot-${ulid()}.png`,
-      );
-
-      try {
-        const result = await backend.screenshot(
-          temporaryOutputPath,
-          showCursor === undefined ? undefined : { showCursor },
-        );
-
-        invariant(
-          result.sessionId === sessionId,
-          'renderer screenshot sessionId must match host sessionId',
-        );
-        invariant(
-          result.profileName === profile.name,
-          'renderer screenshot profileName must match the requested profile',
-        );
-        invariant(
-          result.artifactPath === temporaryOutputPath,
-          'renderer screenshot path must match the requested output path',
-        );
-        invariant(
-          result.pngSizeBytes > 0,
-          'renderer screenshot pngSizeBytes must be positive',
-        );
 
-        const filename = screenshotFilename(
-          result.capturedAtSeq,
-          result.profileName,
-        );
-        const finalArtifactPath = artifactPath(sessDir, filename);
-
-        await rename(temporaryOutputPath, finalArtifactPath);
-        await appendArtifact(
-          sessDir,
-          createArtifactEntry({
-            kind: 'screenshot',
-            filename,
-            sessionId: result.sessionId,
-            capturedAtSeq: result.capturedAtSeq,
-            sha256: result.sha256,
-            metadata: {
-              profileName: result.profileName,
-              cols: result.cols,
-              rows: result.rows,
-              pngSizeBytes: result.pngSizeBytes,
-              cursorVisible: result.cursorVisible,
-              rendererBackend: result.rendererBackend,
-              pixelWidth: result.pixelWidth,
-              pixelHeight: result.pixelHeight,
-              renderProfileHash: result.renderProfileHash,
-            },
-          }),
-        );
-
-        return {
-          sessionId: result.sessionId,
-          capturedAtSeq: result.capturedAtSeq,
-          profileName: result.profileName,
-          cols: result.cols,
-          rows: result.rows,
-          artifactPath: finalArtifactPath,
-          pngSizeBytes: result.pngSizeBytes,
-          cursorVisible: result.cursorVisible,
-          rendererBackend: result.rendererBackend,
-          pixelWidth: result.pixelWidth,
-          pixelHeight: result.pixelHeight,
-          sha256: result.sha256,
-          renderProfileHash: result.renderProfileHash,
-        };
-      } catch (error) {
-        await rm(temporaryOutputPath, { force: true }).catch(() => undefined);
-        throw error;
-      }
+      return await captureScreenshotResult({
+        backend,
+        sessionDir: sessDir,
+        profileName: profile.name,
+        expectedSessionId: sessionId,
+        ...(showCursor === undefined ? {} : { showCursor }),
+      });
     },
     type: async (params: unknown) => {
       const { text } = params as TypeParams;
diff --git a/src/screenshot/capture.ts b/src/screenshot/capture.ts
new file mode 100644
index 0000000..68ccd0c
--- /dev/null
+++ b/src/screenshot/capture.ts
@@ -0,0 +1,146 @@
+import { rename, rm } from 'node:fs/promises';
+
+import { ulid } from 'ulid';
+
+import type { ScreenshotResult } from '../protocol/messages.js';
+import type { RendererBackend } from '../renderer/backend.js';
+
+import { ERROR_CODES, makeCliError } from '../protocol/errors.js';
+import { ScreenshotResultSchema } from '../protocol/schemas.js';
+import {
+  appendArtifact,
+  createArtifactEntry,
+} from '../storage/artifactManifest.js';
+import {
+  artifactPath,
+  ensureArtifactsDir,
+  screenshotFilename,
+} from '../storage/artifactPaths.js';
+import { invariant } from '../util/assert.js';
+
+export interface CaptureScreenshotResultOptions {
+  backend: RendererBackend;
+  sessionDir: string;
+  profileName: string;
+  expectedSessionId: string;
+  showCursor?: boolean;
+}
+
+export function parseScreenshotResult(
+  rawResult: unknown,
+  message = 'Unexpected response from host',
+): ScreenshotResult {
+  const parsedResult = ScreenshotResultSchema.safeParse(rawResult);
+  if (!parsedResult.success) {
+    throw makeCliError(ERROR_CODES.PROTOCOL_ERROR, {
+      message,
+      details: { issues: parsedResult.error.issues },
+    });
+  }
+
+  return parsedResult.data;
+}
+
+export async function captureScreenshotResult(
+  options: CaptureScreenshotResultOptions,
+): Promise<ScreenshotResult> {
+  invariant(
+    options.sessionDir.length > 0,
+    'sessionDir must be a non-empty string',
+  );
+  invariant(
+    options.profileName.length > 0,
+    'profileName must be a non-empty string',
+  );
+  invariant(
+    options.expectedSessionId.length > 0,
+    'expectedSessionId must be a non-empty string',
+  );
+
+  await ensureArtifactsDir(options.sessionDir);
+  const temporaryOutputPath = artifactPath(
+    options.sessionDir,
+    `.tmp-screenshot-${ulid()}.png`,
+  );
+
+  try {
+    const rendererResult = await options.backend.screenshot(
+      temporaryOutputPath,
+      options.showCursor === undefined
+        ? undefined
+        : { showCursor: options.showCursor },
+    );
+
+    invariant(
+      rendererResult.sessionId === options.expectedSessionId,
+      'renderer screenshot sessionId must match expected sessionId',
+    );
+    invariant(
+      rendererResult.profileName === options.profileName,
+      'renderer screenshot profileName must match the requested profile',
+    );
+    invariant(
+      rendererResult.pngSizeBytes > 0,
+      'renderer screenshot pngSizeBytes must be positive',
+    );
+    invariant(
+      rendererResult.artifactPath === temporaryOutputPath,
+      'renderer screenshot path must match the requested output path',
+    );
+    const sha256 = rendererResult.sha256;
+    invariant(sha256 !== undefined, 'renderer screenshot must produce sha256');
+
+    const filename = screenshotFilename(
+      rendererResult.capturedAtSeq,
+      rendererResult.profileName,
+    );
+    const finalArtifactPath = artifactPath(options.sessionDir, filename);
+
+    const publicResult = parseScreenshotResult(
+      {
+        sessionId: rendererResult.sessionId,
+        capturedAtSeq: rendererResult.capturedAtSeq,
+        profileName: rendererResult.profileName,
+        cols: rendererResult.cols,
+        rows: rendererResult.rows,
+        artifactPath: finalArtifactPath,
+        pngSizeBytes: rendererResult.pngSizeBytes,
+        cursorVisible: rendererResult.cursorVisible,
+        rendererBackend: rendererResult.rendererBackend,
+        pixelWidth: rendererResult.pixelWidth,
+        pixelHeight: rendererResult.pixelHeight,
+        sha256,
+        renderProfileHash: rendererResult.renderProfileHash,
+      },
+      'Screenshot result validation failed.',
+    );
+
+    await rename(temporaryOutputPath, finalArtifactPath);
+    await appendArtifact(
+      options.sessionDir,
+      createArtifactEntry({
+        kind: 'screenshot',
+        filename,
+        sessionId: publicResult.sessionId,
+        capturedAtSeq: publicResult.capturedAtSeq,
+        sha256,
+        metadata: {
+          profileName: publicResult.profileName,
+          cols: publicResult.cols,
+          rows: publicResult.rows,
+          pngSizeBytes: publicResult.pngSizeBytes,
+          cursorVisible: publicResult.cursorVisible,
+          rendererBackend: publicResult.rendererBackend,
+          pixelWidth: publicResult.pixelWidth,
+          pixelHeight: publicResult.pixelHeight,
+          renderProfileHash: publicResult.renderProfileHash,
+        },
+      }),
+    );
+
+    return publicResult;
+  } catch (error) {
+    await rm(temporaryOutputPath, { force: true }).catch(() => undefined);
+    throw error;
+  }
+}
diff --git a/test/unit/screenshot/capture.test.ts b/test/unit/screenshot/capture.test.ts
new file mode 100644
index 0000000..8f0ea67
--- /dev/null
+++ b/test/unit/screenshot/capture.test.ts
@@ -0,0 +1,468 @@
+import { access, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+
+import { describe, expect, it, vi } from 'vitest';
+
+import { createTemporarySessionDir } from '../../helpers.js';
+
+import type { RendererBackend } from '../../../src/renderer/backend.js';
+import type { ScreenshotResult } from '../../../src/protocol/messages.js';
+import type {
+  ReplayInput,
+  ReplayState,
+  SemanticSnapshot,
+} from '../../../src/renderer/types.js';
+
+import {
+  captureScreenshotResult,
+  parseScreenshotResult,
+} from '../../../src/screenshot/capture.js';
+import { readArtifactManifest } from '../../../src/storage/artifactManifest.js';
+import {
+  artifactPath,
+  screenshotFilename,
+} from '../../../src/storage/artifactPaths.js';
+
+const TEST_SHA256 = 'a'.repeat(64);
+const TEST_RENDER_PROFILE_HASH = 'b'.repeat(64);
+
+interface FakeBackendOptions {
+  resultOverrides?: Partial<ScreenshotResult>;
+  writePng?: boolean;
+  fail?: Error;
+  onScreenshot?: (
+    outputPath: string,
+    options?: { showCursor?: boolean },
+  ) => void;
+}
+
+function createFakeBackend(options: FakeBackendOptions = {}): RendererBackend {
+  const writePng = options.writePng ?? true;
+
+  return {
+    rendererBackend: 'fake-renderer',
+    isBooted: false,
+    boot: vi.fn().mockResolvedValue(undefined),
+    replayTo: vi.fn(
+      (input: ReplayInput): Promise<ReplayState> =>
+        Promise.resolve({
+          lastSeq: input.targetSeq,
+          cols: input.initialCols,
+          rows: input.initialRows,
+          cursorRow: 0,
+          cursorCol: 0,
+        }),
+    ),
+    snapshot: vi.fn(
+      (): Promise<SemanticSnapshot> =>
+        Promise.resolve({
+          sessionId: 'session-01',
+          capturedAtSeq: 0,
+          cols: 80,
+          rows: 24,
+          cursorRow: 0,
+          cursorCol: 0,
+          isAltScreen: false,
+          visibleLines: [],
+        }),
+    ),
+    screenshot: vi.fn(
+      async (
+        outputPath: string,
+        screenshotOptions?: { showCursor?: boolean },
+      ): Promise<ScreenshotResult> => {
+        options.onScreenshot?.(outputPath, screenshotOptions);
+        if (options.fail !== undefined) {
+          throw options.fail;
+        }
+        if (writePng) {
+          await writeFile(outputPath, Buffer.from([0x89, 0x50, 0x4e, 0x47]));
+        }
+        return {
+          sessionId: 'session-01',
+          capturedAtSeq: 5,
+          profileName: 'reference-dark',
+          cols: 80,
+          rows: 24,
+          artifactPath: outputPath,
+          pngSizeBytes: 4,
+          cursorVisible: screenshotOptions?.showCursor === true,
+          rendererBackend: 'fake-renderer',
+          pixelWidth: 800,
+          pixelHeight: 600,
+          sha256: TEST_SHA256,
+          renderProfileHash: TEST_RENDER_PROFILE_HASH,
+          ...options.resultOverrides,
+        };
+      },
+    ),
+    getVisibleText: vi.fn().mockResolvedValue(''),
+    dispose: vi.fn().mockResolvedValue(undefined),
+  };
+}
+
+async function createSessionDir(sessionId = 'session-01'): Promise<string> {
+  return await createTemporarySessionDir(
+    'agent-tty-screenshot-capture-',
+    sessionId,
+  );
+}
+
+describe('parseScreenshotResult', () => {
+  it('returns the validated screenshot result on success', () => {
+    const result = parseScreenshotResult({
+      sessionId: 'session-01',
+      capturedAtSeq: 5,
+      profileName: 'reference-dark',
+      cols: 80,
+      rows: 24,
+      artifactPath: '/tmp/screenshot.png',
+      pngSizeBytes: 4,
+      sha256: TEST_SHA256,
+    });
+
+    expect(result.sessionId).toBe('session-01');
+    expect(result.sha256).toBe(TEST_SHA256);
+  });
+
+  it('throws PROTOCOL_ERROR with the supplied message on schema failure', () => {
+    expect(() =>
+      parseScreenshotResult(
+        {
+          sessionId: 'session-01',
+          capturedAtSeq: 5,
+          // missing profileName, cols, rows, artifactPath, pngSizeBytes
+        },
+        'custom error message',
+      ),
+    ).toThrow(
+      expect.objectContaining({
+        code: 'PROTOCOL_ERROR',
+        message: 'custom error message',
+      }) as object,
+    );
+  });
+
+  it('uses a default message when none is supplied', () => {
+    expect(() => parseScreenshotResult({})).toThrow(
+      expect.objectContaining({
+        code: 'PROTOCOL_ERROR',
+        message: 'Unexpected response from host',
+      }) as object,
+    );
+  });
+});
+
+describe('screenshot capture', () => {
+  it('writes the PNG to the final artifact path and returns a typed result', async () => {
+    const sessionDirectory = await createSessionDir();
+    const backend = createFakeBackend();
+
+    const result = await captureScreenshotResult({
+      backend,
+      sessionDir: sessionDirectory,
+      profileName: 'reference-dark',
+      expectedSessionId: 'session-01',
+    });
+
+    const expectedFilename = screenshotFilename(5, 'reference-dark');
+    const expectedPath = artifactPath(sessionDirectory, expectedFilename);
+
+    expect(result).toEqual({
+      sessionId: 'session-01',
+      capturedAtSeq: 5,
+      profileName: 'reference-dark',
+      cols: 80,
+      rows: 24,
+      artifactPath: expectedPath,
+      pngSizeBytes: 4,
+      cursorVisible: false,
+      rendererBackend: 'fake-renderer',
+      pixelWidth: 800,
+      pixelHeight: 600,
+      sha256: TEST_SHA256,
+      renderProfileHash: TEST_RENDER_PROFILE_HASH,
+    });
+
+    await expect(access(expectedPath)).resolves.toBeUndefined();
+    await expect(readFile(expectedPath)).resolves.toEqual(
+      Buffer.from([0x89, 0x50, 0x4e, 0x47]),
+    );
+
+    const manifest = await readArtifactManifest(sessionDirectory);
+    expect(manifest.artifacts).toHaveLength(1);
+    expect(manifest.artifacts[0]).toMatchObject({
+      kind: 'screenshot',
+      filename: expectedFilename,
+      sessionId: 'session-01',
+      capturedAtSeq: 5,
+      sha256: TEST_SHA256,
+      metadata: {
+        profileName: 'reference-dark',
+        cols: 80,
+        rows: 24,
+        pngSizeBytes: 4,
+        cursorVisible: false,
+        rendererBackend: 'fake-renderer',
+        pixelWidth: 800,
+        pixelHeight: 600,
+        renderProfileHash: TEST_RENDER_PROFILE_HASH,
+      },
+    });
+  });
+
+  it('omits screenshot options when showCursor is undefined and threads it when set', async () => {
+    const sessionDirectory = await createSessionDir();
+    const observed: Array<{
+      outputPath: string;
+      options: { showCursor?: boolean } | undefined;
+    }> = [];
+    const backend = createFakeBackend({
+      onScreenshot: (outputPath, screenshotOptions) => {
+        observed.push({ outputPath, options: screenshotOptions });
+      },
+    });
+
+    await captureScreenshotResult({
+      backend,
+      sessionDir: sessionDirectory,
+      profileName: 'reference-dark',
+      expectedSessionId: 'session-01',
+    });
+
+    expect(observed.at(-1)?.options).toBeUndefined();
+
+    const sessionDirectory2 = await createSessionDir('session-02');
+    const backendWithCursor = createFakeBackend({
+      onScreenshot: (outputPath, screenshotOptions) => {
+        observed.push({ outputPath, options: screenshotOptions });
+      },
+      resultOverrides: { sessionId: 'session-02' },
+    });
+
+    const cursorResult = await captureScreenshotResult({
+      backend: backendWithCursor,
+      sessionDir: sessionDirectory2,
+      profileName: 'reference-dark',
+      expectedSessionId: 'session-02',
+      showCursor: true,
+    });
+
+    expect(observed.at(-1)?.options).toEqual({ showCursor: true });
+    expect(cursorResult.cursorVisible).toBe(true);
+  });
+
+  it('rejects renderer results that violate the shared invariants', async () => {
+    const cases: Array<{
+      name: string;
+      overrides: Partial<ScreenshotResult>;
+      pattern: RegExp;
+    }> = [
+      {
+        name: 'sessionId mismatch',
+        overrides: { sessionId: 'other-session' },
+        pattern: /sessionId must match expected sessionId/u,
+      },
+      {
+        name: 'profileName mismatch',
+        overrides: { profileName: 'reference-light' },
+        pattern: /profileName must match the requested profile/u,
+      },
+      {
+        name: 'non-positive pngSizeBytes',
+        // pngSizeBytes is asserted before the schema runs, so the loose cast is
+        // intentional to exercise the runtime invariant the same way a buggy
+        // backend would surface.
+        overrides: { pngSizeBytes: 0 } as unknown as Partial<ScreenshotResult>,
+        pattern: /pngSizeBytes must be positive/u,
+      },
+      {
+        name: 'mismatched artifactPath',
+        overrides: { artifactPath: '/wrong/path.png' },
+        pattern: /path must match the requested output path/u,
+      },
+      {
+        name: 'missing sha256',
+        overrides: { sha256: undefined },
+        pattern: /must produce sha256/u,
+      },
+    ];
+
+    for (const testCase of cases) {
+      const sessionDirectory = await createSessionDir(
+        `session-inv-${testCase.name.replace(/\W+/gu, '-')}`,
+      );
+      const backend = createFakeBackend({
+        resultOverrides: {
+          ...testCase.overrides,
+          sessionId:
+            testCase.overrides.sessionId ??
+            `session-inv-${testCase.name.replace(/\W+/gu, '-')}`,
+        },
+      });
+      const expectedSessionId = `session-inv-${testCase.name.replace(/\W+/gu, '-')}`;
+
+      await expect(
+        captureScreenshotResult({
+          backend,
+          sessionDir: sessionDirectory,
+          profileName: 'reference-dark',
+          expectedSessionId,
+        }),
+      ).rejects.toThrow(testCase.pattern);
+
+      const manifest = await readArtifactManifest(sessionDirectory);
+      expect(manifest.artifacts, `case: ${testCase.name}`).toEqual([]);
+      // The temp file should have been cleaned up; final filename should not
+      // exist either since rename never ran.
+      await expect(
+        access(
+          artifactPath(
+            sessionDirectory,
+            screenshotFilename(5, 'reference-dark'),
+          ),
+        ),
+      ).rejects.toMatchObject({ code: 'ENOENT' });
+    }
+  });
+
+  it('rejects malformed public results before rename or manifest append', async () => {
+    const sessionDirectory = await createSessionDir();
+    const backend = createFakeBackend({
+      // cols=0 passes the runtime invariants but trips the strict
+      // ScreenshotResultSchema PositiveIntSchema validation.
+      resultOverrides: { cols: 0 } as unknown as Partial<ScreenshotResult>,
+    });
+
+    await expect(
+      captureScreenshotResult({
+        backend,
+        sessionDir: sessionDirectory,
+        profileName: 'reference-dark',
+        expectedSessionId: 'session-01',
+      }),
+    ).rejects.toMatchObject({
+      code: 'PROTOCOL_ERROR',
+      message: 'Screenshot result validation failed.',
+      details: { issues: expect.any(Array) as unknown },
+    });
+
+    const manifest = await readArtifactManifest(sessionDirectory);
+    expect(manifest.artifacts).toEqual([]);
+    await expect(
+      access(
+        artifactPath(sessionDirectory, screenshotFilename(5, 'reference-dark')),
+      ),
+    ).rejects.toMatchObject({ code: 'ENOENT' });
+  });
+
+  it('removes the temp file when rename fails after a successful render', async () => {
+    const sessionDirectory = await createSessionDir();
+    const finalFilename = screenshotFilename(5, 'reference-dark');
+    const finalPath = artifactPath(sessionDirectory, finalFilename);
+    // Pre-create a non-empty directory at the final destination so rename
+    // cannot replace it with the temp file (ENOTEMPTY/EISDIR on POSIX).
+    await mkdir(finalPath, { recursive: true });
+    await writeFile(`${finalPath}/blocker`, 'present');
+
+    let observedTempPath: string | undefined;
+    const backend = createFakeBackend({
+      onScreenshot: (outputPath) => {
+        observedTempPath = outputPath;
+      },
+    });
+
+    await expect(
+      captureScreenshotResult({
+        backend,
+        sessionDir: sessionDirectory,
+        profileName: 'reference-dark',
+        expectedSessionId: 'session-01',
+      }),
+    ).rejects.toThrow();
+
+    expect(observedTempPath).toMatch(/\/artifacts\/\.tmp-screenshot-.*\.png$/u);
+    if (observedTempPath !== undefined) {
+      await expect(access(observedTempPath)).rejects.toMatchObject({
+        code: 'ENOENT',
+      });
+    }
+    const manifest = await readArtifactManifest(sessionDirectory);
+    expect(manifest.artifacts).toEqual([]);
+  });
+
+  it('preserves the renamed final PNG when manifest append fails after rename', async () => {
+    const sessionDirectory = await createSessionDir();
+    const finalFilename = screenshotFilename(5, 'reference-dark');
+    const finalPath = artifactPath(sessionDirectory, finalFilename);
+    // Pre-write a manifest whose sessionId does not match the directory so
+    // `appendArtifact` raises a MANIFEST_VALIDATION_ERROR after the temp file
+    // has already been renamed into place.
+    const manifestFilePath = artifactPath(sessionDirectory, 'manifest.json');
+    await mkdir(dirname(manifestFilePath), { recursive: true });
+    await writeFile(
+      manifestFilePath,
+      `${JSON.stringify({
+        version: 1,
+        sessionId: 'unrelated-session',
+        artifacts: [],
+      })}\n`,
+    );
+
+    let observedTempPath: string | undefined;
+    const backend = createFakeBackend({
+      onScreenshot: (outputPath) => {
+        observedTempPath = outputPath;
+      },
+    });
+
+    await expect(
+      captureScreenshotResult({
+        backend,
+        sessionDir: sessionDirectory,
+        profileName: 'reference-dark',
+        expectedSessionId: 'session-01',
+      }),
+    ).rejects.toMatchObject({ code: 'MANIFEST_VALIDATION_ERROR' });
+
+    // Final PNG remains as a documented G1 orphan — there is no rollback
+    // for the rename when the manifest append fails afterwards.
+    await expect(access(finalPath)).resolves.toBeUndefined();
+    if (observedTempPath !== undefined) {
+      await expect(access(observedTempPath)).rejects.toMatchObject({
+        code: 'ENOENT',
+      });
+    }
+  });
+
+  it('removes the temp file and rethrows when the renderer screenshot rejects', async () => {
+    const sessionDirectory = await createSessionDir();
+    const captureError = new Error('renderer crashed');
+    let observedTempPath: string | undefined;
+    const backend = createFakeBackend({
+      writePng: false,
+      onScreenshot: (outputPath) => {
+        observedTempPath = outputPath;
+      },
+      fail: captureError,
+    });
+
+    await expect(
+      captureScreenshotResult({
+        backend,
+        sessionDir: sessionDirectory,
+        profileName: 'reference-dark',
+        expectedSessionId: 'session-01',
+      }),
+    ).rejects.toBe(captureError);
+
+    expect(observedTempPath).toMatch(/\/artifacts\/\.tmp-screenshot-.*\.png$/u);
+    if (observedTempPath !== undefined) {
+      await expect(access(observedTempPath)).rejects.toMatchObject({
+        code: 'ENOENT',
+      });
+    }
+    const manifest = await readArtifactManifest(sessionDirectory);
+    expect(manifest.artifacts).toEqual([]);
+  });
+});

From dc38272038020c50544fa685978c50482b743760 Mon Sep 17 00:00:00 2001
From: Thomas Kosiewski <tk@coder.com>
Date: Thu, 30 Apr 2026 08:42:09 +0000
Subject: [PATCH 2/4] fix: address coder-agents-review on screenshot capture
 refactor

- DEREM-1 (P3): add showCursor: false test as a distinct value vs undefined
- DEREM-2 (P3): add empty-precondition tests for sessionDir / profileName
  / expectedSessionId
- DEREM-3 (P3): replace 'G1 orphan' jargon with a plain explanation in the
  manifest-append-fails test
- DEREM-4 (Nit): add temp-file ENOENT check inside the invariant violation
  loop, matching the rigor of the renderer-throws and rename-fails tests
- DEREM-5 (Nit): point the CHANGELOG entry to PR #78 rather than the
  tracking issue
- DEREM-6 (Nit): build the public result as a typed
  CapturedScreenshotResult intermediate before parseScreenshotResult, so a
  misspelled field surfaces at compile time (mirrors src/snapshot/capture.ts)
- DEREM-7 (P4): trim duplicated rename / createArtifactEntry /
  appendArtifact assertions from test/unit/commands/screenshot.test.ts;
  those manifest-entry internals are now exercised by the dedicated
  capture.test.ts unit suite
- DEREM-8 (Note): narrow the helper's backend parameter to
  Pick<RendererBackend, 'screenshot'> so future edits cannot reach for
  unrelated lifecycle methods
- DEREM-9 (Note): refine the helper return type to
  ScreenshotResult & { sha256: string } so the runtime invariant is
  visible to TypeScript at every callsite

DEREM-10 (P4) and DEREM-11 (Note) are deferred per the reviewer's own
framing (parser duplication is shared with snapshot capture and is not
this PR's debt; two of the three test fakes predate this PR).
---
 CHANGELOG.md                          |  2 +-
 src/screenshot/capture.ts             | 56 ++++++++++++------
 test/unit/commands/screenshot.test.ts | 46 ++-------------
 test/unit/screenshot/capture.test.ts  | 85 +++++++++++++++++++++++++--
 4 files changed, 126 insertions(+), 63 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4a85cbd..f7753e5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -17,7 +17,7 @@
 - Session-status policy is now centralized in a single module that classifies every `SessionStatus` as active, terminal, commandable, live-host eligible, offline-replay eligible, collectable, and destroyed; lifecycle, inspect, gc, wait, host, and command-state checks share the same predicates. CLI JSON, protocol schemas, event-log behavior, and artifact formats are unchanged ([#67](https://github.com/coder/agent-tty/pull/67)).
 - Persisted event-log validation, JSONL parsing, and contiguous-sequence checks for live hydration, offline replay, and `record export` now flow through a shared codec at `src/storage/eventLogCodec.ts`. Validation errors use neutral event-log wording; missing-log policy remains caller-specific (offline replay treats missing logs as empty; `record export` still surfaces missing logs as an error) ([#68](https://github.com/coder/agent-tty/pull/68)).
 - Snapshot result construction and artifact persistence are now shared between live host RPCs and offline replay through `src/snapshot/capture.ts`. Snapshot artifact filenames, JSON formatting (two-space indent + trailing newline), manifest metadata, and `rendererBackend` reporting are unchanged ([#69](https://github.com/coder/agent-tty/pull/69)).
-- Screenshot capture, validation, and artifact persistence are now shared between live host RPCs and offline replay through `src/screenshot/capture.ts`. The shared seam owns temporary-file allocation, renderer screenshot invocation, allowlisted public result construction, Zod validation before any rename or manifest append, manifest metadata creation, and temp-file cleanup on failure. Screenshot filenames, final PNG paths, manifest entry shape (`profileName`, `cols`, `rows`, `pngSizeBytes`, `cursorVisible`, `rendererBackend`, `pixelWidth`, `pixelHeight`, `sha256`, `renderProfileHash`), and `screenshot --json` output are unchanged (tracking [#64](https://github.com/coder/agent-tty/issues/64)).
+- Screenshot capture, validation, and artifact persistence are now shared between live host RPCs and offline replay through `src/screenshot/capture.ts`. The shared seam owns temporary-file allocation, renderer screenshot invocation, allowlisted public result construction, Zod validation before any rename or manifest append, manifest metadata creation, and temp-file cleanup on failure. Screenshot filenames, final PNG paths, manifest entry shape (`profileName`, `cols`, `rows`, `pngSizeBytes`, `cursorVisible`, `rendererBackend`, `pixelWidth`, `pixelHeight`, `sha256`, `renderProfileHash`), and `screenshot --json` output are unchanged ([#78](https://github.com/coder/agent-tty/pull/78)).
 - Waited-run completion bookkeeping (sentinel scanning, postamble sanitization, waiter resolution, timeout, exit, `run_complete` appends) moved out of `hostMain` into a dedicated `RunCompletionCoordinator`. No public CLI, protocol, or event-log changes ([#70](https://github.com/coder/agent-tty/pull/70)).
 - Refreshed contributor and agent guidance in `AGENTS.md` with an outcome-first operating contract, validation guidance, and grouped project invariants ([#46](https://github.com/coder/agent-tty/pull/46)). Added in-repo agent skills under `.agents/skills/` (`diagnose`, `tdd`, `triage`, `improve-codebase-architecture`, `grill-with-docs`, `to-issues`, `to-prd`) plus matching links from `.claude/skills/` and `.mux/skills/` ([#65](https://github.com/coder/agent-tty/pull/65)).
 
diff --git a/src/screenshot/capture.ts b/src/screenshot/capture.ts
index 68ccd0c..81586e8 100644
--- a/src/screenshot/capture.ts
+++ b/src/screenshot/capture.ts
@@ -18,8 +18,24 @@ import {
 } from '../storage/artifactPaths.js';
 import { invariant } from '../util/assert.js';
 
+/**
+ * The narrow renderer surface the capture helper needs. Accepting only
+ * `screenshot()` makes it impossible for future edits to reach for unrelated
+ * lifecycle methods (`boot`, `replayTo`, `dispose`, etc.) from inside the
+ * capture seam. Callers already hold a full `RendererBackend`, which is
+ * structurally assignable to this `Pick<...>`.
+ */
+export type CaptureScreenshotBackend = Pick<RendererBackend, 'screenshot'>;
+
+/**
+ * The shared capture path enforces `sha256` as a runtime invariant on every
+ * successful screenshot. We refine the public schema's optional `sha256` to
+ * `string` here so callers — and TypeScript — see that guarantee directly.
+ */
+export type CapturedScreenshotResult = ScreenshotResult & { sha256: string };
+
 export interface CaptureScreenshotResultOptions {
-  backend: RendererBackend;
+  backend: CaptureScreenshotBackend;
   sessionDir: string;
   profileName: string;
   expectedSessionId: string;
@@ -43,7 +59,7 @@ export function parseScreenshotResult(
 
 export async function captureScreenshotResult(
   options: CaptureScreenshotResultOptions,
-): Promise<ScreenshotResult> {
+): Promise<CapturedScreenshotResult> {
   invariant(
     options.sessionDir.length > 0,
     'sessionDir must be a non-empty string',
@@ -96,24 +112,28 @@ export async function captureScreenshotResult(
     );
     const finalArtifactPath = artifactPath(options.sessionDir, filename);
 
+    // Mirror `src/snapshot/capture.ts` by building a typed intermediate
+    // before validation. A misspelled field name surfaces at compile time
+    // here rather than only at Zod runtime.
+    const publicResultCandidate: CapturedScreenshotResult = {
+      sessionId: rendererResult.sessionId,
+      capturedAtSeq: rendererResult.capturedAtSeq,
+      profileName: rendererResult.profileName,
+      cols: rendererResult.cols,
+      rows: rendererResult.rows,
+      artifactPath: finalArtifactPath,
+      pngSizeBytes: rendererResult.pngSizeBytes,
+      cursorVisible: rendererResult.cursorVisible,
+      rendererBackend: rendererResult.rendererBackend,
+      pixelWidth: rendererResult.pixelWidth,
+      pixelHeight: rendererResult.pixelHeight,
+      sha256,
+      renderProfileHash: rendererResult.renderProfileHash,
+    };
     const publicResult = parseScreenshotResult(
-      {
-        sessionId: rendererResult.sessionId,
-        capturedAtSeq: rendererResult.capturedAtSeq,
-        profileName: rendererResult.profileName,
-        cols: rendererResult.cols,
-        rows: rendererResult.rows,
-        artifactPath: finalArtifactPath,
-        pngSizeBytes: rendererResult.pngSizeBytes,
-        cursorVisible: rendererResult.cursorVisible,
-        rendererBackend: rendererResult.rendererBackend,
-        pixelWidth: rendererResult.pixelWidth,
-        pixelHeight: rendererResult.pixelHeight,
-        sha256,
-        renderProfileHash: rendererResult.renderProfileHash,
-      },
+      publicResultCandidate,
       'Screenshot result validation failed.',
-    );
+    ) as CapturedScreenshotResult;
 
     await rename(temporaryOutputPath, finalArtifactPath);
     await appendArtifact(
diff --git a/test/unit/commands/screenshot.test.ts b/test/unit/commands/screenshot.test.ts
index c28abc9..0844f5f 100644
--- a/test/unit/commands/screenshot.test.ts
+++ b/test/unit/commands/screenshot.test.ts
@@ -363,38 +363,9 @@ describe('screenshot command', () => {
       },
       expect.any(Function),
     );
-    expect(mocks.rename).toHaveBeenCalledWith(
-      expect.stringMatching(/^\/artifacts\/\.tmp-screenshot-.*\.png$/),
-      '/artifacts/screenshot-5-reference-dark.png',
-    );
-    expect(mocks.createArtifactEntry).toHaveBeenCalledWith({
-      kind: 'screenshot',
-      filename: 'screenshot-5-reference-dark.png',
-      sessionId: 'session-01',
-      capturedAtSeq: 5,
-      sha256: TEST_SCREENSHOT_SHA256,
-      metadata: {
-        profileName: 'reference-dark',
-        cols: 80,
-        rows: 24,
-        pngSizeBytes: 2048,
-        cursorVisible: false,
-        rendererBackend: 'ghostty-web',
-        pixelWidth: 800,
-        pixelHeight: 600,
-        renderProfileHash: TEST_RENDER_PROFILE_HASH,
-      },
-    });
-    expect(mocks.appendArtifact).toHaveBeenCalledWith(
-      '/tmp/agent-tty/sessions/session-01',
-      expect.objectContaining({
-        kind: 'screenshot',
-        filename: 'screenshot-5-reference-dark.png',
-        sessionId: 'session-01',
-        capturedAtSeq: 5,
-        sha256: TEST_SCREENSHOT_SHA256,
-      }),
-    );
+    // Rename, manifest-entry construction, and manifest append are exercised
+    // by `test/unit/screenshot/capture.test.ts`. Here we only check the
+    // routing-level surface of the offline path.
     expect(mocks.emitSuccess).toHaveBeenCalledWith({
       command: 'screenshot',
       json: false,
@@ -462,14 +433,9 @@ describe('screenshot command', () => {
       expect.stringMatching(/^\/artifacts\/\.tmp-screenshot-.*\.png$/),
       { showCursor: true },
     );
-    expect(mocks.createArtifactEntry).toHaveBeenCalled();
-    const artifactEntryArg = mocks.createArtifactEntry.mock.calls.at(
-      -1,
-    )?.[0] as {
-      metadata?: { cursorVisible?: boolean };
-    };
-    expect(artifactEntryArg.metadata?.cursorVisible).toBe(true);
-
+    // Manifest-entry metadata for `cursorVisible` is exercised by
+    // `test/unit/screenshot/capture.test.ts`; here we only check that the
+    // command-level result reflects the requested `showCursor` value.
     expect(mocks.emitSuccess).toHaveBeenCalled();
     const emitSuccessArg = mocks.emitSuccess.mock.calls.at(-1)?.[0] as {
       result?: { cursorVisible?: boolean };
diff --git a/test/unit/screenshot/capture.test.ts b/test/unit/screenshot/capture.test.ts
index 8f0ea67..24c9ee3 100644
--- a/test/unit/screenshot/capture.test.ts
+++ b/test/unit/screenshot/capture.test.ts
@@ -250,6 +250,67 @@ describe('screenshot capture', () => {
 
     expect(observed.at(-1)?.options).toEqual({ showCursor: true });
     expect(cursorResult.cursorVisible).toBe(true);
+
+    // showCursor: false must be threaded through as a distinct value (not
+    // collapsed to undefined). Guards against the ternary regressing to a
+    // truthy-only check.
+    const sessionDirectoryFalse = await createSessionDir('session-03');
+    const backendShowFalse = createFakeBackend({
+      onScreenshot: (outputPath, screenshotOptions) => {
+        observed.push({ outputPath, options: screenshotOptions });
+      },
+      resultOverrides: { sessionId: 'session-03' },
+    });
+
+    const falseResult = await captureScreenshotResult({
+      backend: backendShowFalse,
+      sessionDir: sessionDirectoryFalse,
+      profileName: 'reference-dark',
+      expectedSessionId: 'session-03',
+      showCursor: false,
+    });
+
+    expect(observed.at(-1)?.options).toEqual({ showCursor: false });
+    expect(falseResult.cursorVisible).toBe(false);
+  });
+
+  it('rejects empty sessionDir, profileName, or expectedSessionId before invoking the backend', async () => {
+    const sessionDirectory = await createSessionDir();
+    const observed: Array<string> = [];
+    const backend = createFakeBackend({
+      onScreenshot: (outputPath) => {
+        observed.push(outputPath);
+      },
+    });
+
+    await expect(
+      captureScreenshotResult({
+        backend,
+        sessionDir: '',
+        profileName: 'reference-dark',
+        expectedSessionId: 'session-01',
+      }),
+    ).rejects.toThrow(/sessionDir must be a non-empty string/u);
+
+    await expect(
+      captureScreenshotResult({
+        backend,
+        sessionDir: sessionDirectory,
+        profileName: '',
+        expectedSessionId: 'session-01',
+      }),
+    ).rejects.toThrow(/profileName must be a non-empty string/u);
+
+    await expect(
+      captureScreenshotResult({
+        backend,
+        sessionDir: sessionDirectory,
+        profileName: 'reference-dark',
+        expectedSessionId: '',
+      }),
+    ).rejects.toThrow(/expectedSessionId must be a non-empty string/u);
+
+    expect(observed).toEqual([]);
   });
 
   it('rejects renderer results that violate the shared invariants', async () => {
@@ -292,6 +353,7 @@ describe('screenshot capture', () => {
       const sessionDirectory = await createSessionDir(
         `session-inv-${testCase.name.replace(/\W+/gu, '-')}`,
       );
+      let observedTempPath: string | undefined;
       const backend = createFakeBackend({
         resultOverrides: {
           ...testCase.overrides,
@@ -299,6 +361,9 @@ describe('screenshot capture', () => {
             testCase.overrides.sessionId ??
             `session-inv-${testCase.name.replace(/\W+/gu, '-')}`,
         },
+        onScreenshot: (outputPath) => {
+          observedTempPath = outputPath;
+        },
       });
       const expectedSessionId = `session-inv-${testCase.name.replace(/\W+/gu, '-')}`;
 
@@ -313,8 +378,17 @@ describe('screenshot capture', () => {
 
       const manifest = await readArtifactManifest(sessionDirectory);
       expect(manifest.artifacts, `case: ${testCase.name}`).toEqual([]);
-      // The temp file should have been cleaned up; final filename should not
-      // exist either since rename never ran.
+      // The temp file written by the fake backend should have been removed.
+      expect(observedTempPath, `case: ${testCase.name}`).toMatch(
+        /\/artifacts\/\.tmp-screenshot-.*\.png$/u,
+      );
+      if (observedTempPath !== undefined) {
+        await expect(
+          access(observedTempPath),
+          `case: ${testCase.name} (temp removed)`,
+        ).rejects.toMatchObject({ code: 'ENOENT' });
+      }
+      // The final filename should not exist either since rename never ran.
       await expect(
         access(
           artifactPath(
@@ -425,8 +499,11 @@ describe('screenshot capture', () => {
       }),
     ).rejects.toMatchObject({ code: 'MANIFEST_VALIDATION_ERROR' });
 
-    // Final PNG remains as a documented G1 orphan — there is no rollback
-    // for the rename when the manifest append fails afterwards.
+    // The final PNG survives because cleanup only removes the temp file,
+    // not the already-renamed artifact. This is intentional: the rename
+    // succeeded, so the PNG is valid; only the manifest entry is missing.
+    // Adding rename rollback is explicitly out of scope for this refactor
+    // and is tracked as a follow-up.
     await expect(access(finalPath)).resolves.toBeUndefined();
     if (observedTempPath !== undefined) {
       await expect(access(observedTempPath)).rejects.toMatchObject({

From e9d2d628c129cc5b6d18ae35a048fb82deb369e7 Mon Sep 17 00:00:00 2001
From: Thomas Kosiewski <tk@coder.com>
Date: Thu, 30 Apr 2026 09:24:17 +0000
Subject: [PATCH 3/4] fix: address coder-agents-review R2 on screenshot capture
 refactor
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- DEREM-12 (P3): replace unverified "tracked as a follow-up" wording with
  an explicit reference to the filed follow-up issue (#79 — rename
  rollback when manifest append fails)
- DEREM-13 (Nit): drop the `as unknown as Partial<ScreenshotResult>`
  casts; `pngSizeBytes: 0` and `cols: 0` are valid `number` values
- DEREM-14 (Nit): align the commands.sh header examples with the
  `before`/`after` labels actually written to disk and used by the README
- DEREM-15 (Nit): extract a local `PNG_HEADER` constant in capture.test.ts
  so the magic bytes are named in one place
- DEREM-16 (Nit): match `src/snapshot/capture.ts`'s invariant wording
  (`'sessionDir must be non-empty'` etc.)
- DEREM-17 (Note): replace the `as CapturedScreenshotResult` cast with a
  post-parse `invariant(sha256 !== undefined, ...)` plus an explicit
  intermediate, so a future schema change that strips `sha256` would fail
  loudly instead of silently regressing

Also filed three follow-up issues per reviewer's request for human
decisions on the deferred items:
- #79 — rename rollback when manifest append fails (DEREM-12 / R1 risk)
- #80 — generic parseValidatedResult<T> helper (DEREM-10)
- #81 — shared test/helpers/fakeBackend.ts (DEREM-11)
---
 .../commands.sh                               |  7 +++--
 src/screenshot/capture.ts                     | 28 +++++++++++-------
 test/unit/screenshot/capture.test.ts          | 29 ++++++++++---------
 3 files changed, 36 insertions(+), 28 deletions(-)

diff --git a/dogfood/issue-64-share-screenshot-capture/commands.sh b/dogfood/issue-64-share-screenshot-capture/commands.sh
index 1110bd6..142f1f5 100755
--- a/dogfood/issue-64-share-screenshot-capture/commands.sh
+++ b/dogfood/issue-64-share-screenshot-capture/commands.sh
@@ -15,10 +15,11 @@ set -euo pipefail
 # offline paths field-by-field. Run twice — once on the refactor branch and
 # once on the parent commit — to compare before/after parity:
 #
-#   bash dogfood/issue-64-share-screenshot-capture/commands.sh refactor
-#   bash dogfood/issue-64-share-screenshot-capture/commands.sh main
+#   bash dogfood/issue-64-share-screenshot-capture/commands.sh after
+#   bash dogfood/issue-64-share-screenshot-capture/commands.sh before
 #
-# Each invocation writes to the corresponding sub-directory under the bundle.
+# Each invocation writes to the corresponding sub-directory under the bundle
+# (`after/` or `before/`). The label argument defaults to `after` if omitted.
 
 BUNDLE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO="$(cd "$BUNDLE/../.." && pwd)"
diff --git a/src/screenshot/capture.ts b/src/screenshot/capture.ts
index 81586e8..84d3282 100644
--- a/src/screenshot/capture.ts
+++ b/src/screenshot/capture.ts
@@ -60,17 +60,11 @@ export function parseScreenshotResult(
 export async function captureScreenshotResult(
   options: CaptureScreenshotResultOptions,
 ): Promise<CapturedScreenshotResult> {
-  invariant(
-    options.sessionDir.length > 0,
-    'sessionDir must be a non-empty string',
-  );
-  invariant(
-    options.profileName.length > 0,
-    'profileName must be a non-empty string',
-  );
+  invariant(options.sessionDir.length > 0, 'sessionDir must be non-empty');
+  invariant(options.profileName.length > 0, 'profileName must be non-empty');
   invariant(
     options.expectedSessionId.length > 0,
-    'expectedSessionId must be a non-empty string',
+    'expectedSessionId must be non-empty',
   );
 
   await ensureArtifactsDir(options.sessionDir);
@@ -130,10 +124,22 @@ export async function captureScreenshotResult(
       sha256,
       renderProfileHash: rendererResult.renderProfileHash,
     };
-    const publicResult = parseScreenshotResult(
+    const parsedResult = parseScreenshotResult(
       publicResultCandidate,
       'Screenshot result validation failed.',
-    ) as CapturedScreenshotResult;
+    );
+    // Re-narrow `sha256` after the parse instead of asserting through a
+    // type cast. If `ScreenshotResultSchema` is ever changed to strip or
+    // transform `sha256`, this invariant catches it instead of silently
+    // hiding the regression.
+    invariant(
+      parsedResult.sha256 !== undefined,
+      'parsed screenshot result must preserve sha256',
+    );
+    const publicResult: CapturedScreenshotResult = {
+      ...parsedResult,
+      sha256: parsedResult.sha256,
+    };
 
     await rename(temporaryOutputPath, finalArtifactPath);
     await appendArtifact(
diff --git a/test/unit/screenshot/capture.test.ts b/test/unit/screenshot/capture.test.ts
index 24c9ee3..b3a21a5 100644
--- a/test/unit/screenshot/capture.test.ts
+++ b/test/unit/screenshot/capture.test.ts
@@ -25,6 +25,10 @@ import {
 
 const TEST_SHA256 = 'a'.repeat(64);
 const TEST_RENDER_PROFILE_HASH = 'b'.repeat(64);
+// First four bytes of the PNG magic signature (0x89 'P' 'N' 'G'). Enough to
+// satisfy the test that we wrote/read the same buffer; the renderer
+// produces a real PNG, but these unit tests do not validate the format.
+const PNG_HEADER = Buffer.from([0x89, 0x50, 0x4e, 0x47]);
 
 interface FakeBackendOptions {
   resultOverrides?: Partial<ScreenshotResult>;
@@ -76,7 +80,7 @@ function createFakeBackend(options: FakeBackendOptions = {}): RendererBackend {
           throw options.fail;
         }
         if (writePng) {
-          await writeFile(outputPath, Buffer.from([0x89, 0x50, 0x4e, 0x47]));
+          await writeFile(outputPath, PNG_HEADER);
         }
         return {
           sessionId: 'session-01',
@@ -185,9 +189,7 @@ describe('screenshot capture', () => {
     });
 
     await expect(access(expectedPath)).resolves.toBeUndefined();
-    await expect(readFile(expectedPath)).resolves.toEqual(
-      Buffer.from([0x89, 0x50, 0x4e, 0x47]),
-    );
+    await expect(readFile(expectedPath)).resolves.toEqual(PNG_HEADER);
 
     const manifest = await readArtifactManifest(sessionDirectory);
     expect(manifest.artifacts).toHaveLength(1);
@@ -290,7 +292,7 @@ describe('screenshot capture', () => {
         profileName: 'reference-dark',
         expectedSessionId: 'session-01',
       }),
-    ).rejects.toThrow(/sessionDir must be a non-empty string/u);
+    ).rejects.toThrow(/sessionDir must be non-empty/u);
 
     await expect(
       captureScreenshotResult({
@@ -299,7 +301,7 @@ describe('screenshot capture', () => {
         profileName: '',
         expectedSessionId: 'session-01',
       }),
-    ).rejects.toThrow(/profileName must be a non-empty string/u);
+    ).rejects.toThrow(/profileName must be non-empty/u);
 
     await expect(
       captureScreenshotResult({
@@ -308,7 +310,7 @@ describe('screenshot capture', () => {
         profileName: 'reference-dark',
         expectedSessionId: '',
       }),
-    ).rejects.toThrow(/expectedSessionId must be a non-empty string/u);
+    ).rejects.toThrow(/expectedSessionId must be non-empty/u);
 
     expect(observed).toEqual([]);
   });
@@ -331,10 +333,9 @@ describe('screenshot capture', () => {
       },
       {
         name: 'non-positive pngSizeBytes',
-        // pngSizeBytes is asserted before the schema runs, so the loose cast is
-        // intentional to exercise the runtime invariant the same way a buggy
-        // backend would surface.
-        overrides: { pngSizeBytes: 0 } as unknown as Partial<ScreenshotResult>,
+        // pngSizeBytes is asserted before the schema runs, so passing 0
+        // exercises the runtime invariant the same way a buggy backend would.
+        overrides: { pngSizeBytes: 0 },
         pattern: /pngSizeBytes must be positive/u,
       },
       {
@@ -405,7 +406,7 @@ describe('screenshot capture', () => {
     const backend = createFakeBackend({
       // cols=0 passes the runtime invariants but trips the strict
       // ScreenshotResultSchema PositiveIntSchema validation.
-      resultOverrides: { cols: 0 } as unknown as Partial<ScreenshotResult>,
+      resultOverrides: { cols: 0 },
     });
 
     await expect(
@@ -502,8 +503,8 @@ describe('screenshot capture', () => {
     // The final PNG survives because cleanup only removes the temp file,
     // not the already-renamed artifact. This is intentional: the rename
     // succeeded, so the PNG is valid; only the manifest entry is missing.
-    // Adding rename rollback is explicitly out of scope for this refactor
-    // and is tracked as a follow-up.
+    // Adding rename rollback is not addressed in this refactor; the
+    // follow-up is tracked in #79.
     await expect(access(finalPath)).resolves.toBeUndefined();
     if (observedTempPath !== undefined) {
       await expect(access(observedTempPath)).rejects.toMatchObject({

From 10833dfb0874eb4db25f5f2cc846044567bddaf9 Mon Sep 17 00:00:00 2001
From: Thomas Kosiewski <tk@coder.com>
Date: Thu, 30 Apr 2026 09:59:13 +0000
Subject: [PATCH 4/4] test: split invariant cases into it.each per DEREM-19

Previously the five invariant cases lived inside a single `it()` and a
`for` loop, so a failure in case 2 hid the status of cases 3-5. Migrating
to `it.each(...)` runs each row as an independent test (with the case
name in the title), matching the per-invariant style used by
`test/unit/snapshot/capture.test.ts` and giving precise failure surface
when a single invariant regresses.

No behavior change to `captureScreenshotResult`. Verified by
`npm run test -- test/unit/screenshot/capture.test.ts` (15 tests, all
pass).

Also reflects the updated PR description note from review (DEREM-20)
that the suite reports more independent tests (15 in
`screenshot/capture.test.ts` after this change).
---
 test/unit/screenshot/capture.test.ts | 105 +++++++++++++--------------
 1 file changed, 51 insertions(+), 54 deletions(-)

diff --git a/test/unit/screenshot/capture.test.ts b/test/unit/screenshot/capture.test.ts
index b3a21a5..b52ae8e 100644
--- a/test/unit/screenshot/capture.test.ts
+++ b/test/unit/screenshot/capture.test.ts
@@ -315,79 +315,76 @@ describe('screenshot capture', () => {
     expect(observed).toEqual([]);
   });
 
-  it('rejects renderer results that violate the shared invariants', async () => {
-    const cases: Array<{
-      name: string;
-      overrides: Partial<ScreenshotResult>;
-      pattern: RegExp;
-    }> = [
-      {
-        name: 'sessionId mismatch',
-        overrides: { sessionId: 'other-session' },
-        pattern: /sessionId must match expected sessionId/u,
-      },
-      {
-        name: 'profileName mismatch',
-        overrides: { profileName: 'reference-light' },
-        pattern: /profileName must match the requested profile/u,
-      },
-      {
-        name: 'non-positive pngSizeBytes',
-        // pngSizeBytes is asserted before the schema runs, so passing 0
-        // exercises the runtime invariant the same way a buggy backend would.
-        overrides: { pngSizeBytes: 0 },
-        pattern: /pngSizeBytes must be positive/u,
-      },
-      {
-        name: 'mismatched artifactPath',
-        overrides: { artifactPath: '/wrong/path.png' },
-        pattern: /path must match the requested output path/u,
-      },
-      {
-        name: 'missing sha256',
-        overrides: { sha256: undefined },
-        pattern: /must produce sha256/u,
-      },
-    ];
-
-    for (const testCase of cases) {
-      const sessionDirectory = await createSessionDir(
-        `session-inv-${testCase.name.replace(/\W+/gu, '-')}`,
-      );
+  // Each invariant gets its own test so that a single failure does not
+  // mask the others. Using `it.each` keeps the table-driven readability
+  // while reporting one independent test per row.
+  it.each([
+    {
+      name: 'sessionId mismatch',
+      overrides: { sessionId: 'other-session' } as Partial<ScreenshotResult>,
+      pattern: /sessionId must match expected sessionId/u,
+    },
+    {
+      name: 'profileName mismatch',
+      overrides: {
+        profileName: 'reference-light',
+      } as Partial<ScreenshotResult>,
+      pattern: /profileName must match the requested profile/u,
+    },
+    {
+      // pngSizeBytes is asserted before the schema runs, so passing 0
+      // exercises the runtime invariant the same way a buggy backend would.
+      name: 'non-positive pngSizeBytes',
+      overrides: { pngSizeBytes: 0 } as Partial<ScreenshotResult>,
+      pattern: /pngSizeBytes must be positive/u,
+    },
+    {
+      name: 'mismatched artifactPath',
+      overrides: {
+        artifactPath: '/wrong/path.png',
+      } as Partial<ScreenshotResult>,
+      pattern: /path must match the requested output path/u,
+    },
+    {
+      name: 'missing sha256',
+      overrides: { sha256: undefined } as Partial<ScreenshotResult>,
+      pattern: /must produce sha256/u,
+    },
+  ])(
+    'rejects $name and removes the temp file before any persistence',
+    async ({ name, overrides, pattern }) => {
+      const sessionId = `session-inv-${name.replace(/\W+/gu, '-')}`;
+      const sessionDirectory = await createSessionDir(sessionId);
       let observedTempPath: string | undefined;
       const backend = createFakeBackend({
         resultOverrides: {
-          ...testCase.overrides,
-          sessionId:
-            testCase.overrides.sessionId ??
-            `session-inv-${testCase.name.replace(/\W+/gu, '-')}`,
+          ...overrides,
+          sessionId: overrides.sessionId ?? sessionId,
         },
         onScreenshot: (outputPath) => {
           observedTempPath = outputPath;
         },
       });
-      const expectedSessionId = `session-inv-${testCase.name.replace(/\W+/gu, '-')}`;
 
       await expect(
         captureScreenshotResult({
           backend,
           sessionDir: sessionDirectory,
           profileName: 'reference-dark',
-          expectedSessionId,
+          expectedSessionId: sessionId,
         }),
-      ).rejects.toThrow(testCase.pattern);
+      ).rejects.toThrow(pattern);
 
       const manifest = await readArtifactManifest(sessionDirectory);
-      expect(manifest.artifacts, `case: ${testCase.name}`).toEqual([]);
+      expect(manifest.artifacts).toEqual([]);
       // The temp file written by the fake backend should have been removed.
-      expect(observedTempPath, `case: ${testCase.name}`).toMatch(
+      expect(observedTempPath).toMatch(
         /\/artifacts\/\.tmp-screenshot-.*\.png$/u,
       );
       if (observedTempPath !== undefined) {
-        await expect(
-          access(observedTempPath),
-          `case: ${testCase.name} (temp removed)`,
-        ).rejects.toMatchObject({ code: 'ENOENT' });
+        await expect(access(observedTempPath)).rejects.toMatchObject({
+          code: 'ENOENT',
+        });
       }
       // The final filename should not exist either since rename never ran.
       await expect(
@@ -398,8 +395,8 @@ describe('screenshot capture', () => {
           ),
         ),
       ).rejects.toMatchObject({ code: 'ENOENT' });
-    }
-  });
+    },
+  );
 
   it('rejects malformed public results before rename or manifest append', async () => {
     const sessionDirectory = await createSessionDir();