fix(claude): preview images read from the workspace

[t3dotgg]

Claude Read tool calls stayed as generic tool rows. Activity projection also removed the full file path, so the existing web and mobile image renderer had no stable path to load.

Classify a Claude Read call as image_view only after its streamed input identifies an image file. Preserve the full path as imagePath through projection and work-log lifecycle merging. The projection also derives this field from old completed Claude payloads, while normal text reads stay unchanged. Legacy rows that carry an image path now group and icon as reads instead of "Used 1 tool".

The image renderer landed in #8936. This change composes with the external-host asset access work in #9023 and does not change asset authorization.

Known gap: tool.updated rows recorded before this change were slimmed at ingest without the input, so an old interrupted image read still shows no image. Completed reads backfill.

Checks:

• 195 focused tests passed, plus a new toolGroupAction case.
• Typechecks passed for server, client runtime, web, and mobile.

Not yet verified in a running client.

First commit by GPT-5.6 Sol with Codex in T3 Code. Audit and follow-up fix by Claude Fable 5.1 with Claude Code.

---

Note

Low Risk
Display and activity-shaping changes only; no auth or asset-access changes, with broad test coverage on adapter, projection, and client merge behavior.

Overview
Claude Read calls on workspace image files now surface as image_view in the thread work log instead of generic tool rows, including while the tool input is still streaming.

The Claude adapter classifies reads using isWorkspaceImagePreviewPath on the parsed file_path/path, updates item type and detail as input_json_delta arrives, and uses the image path as the summary when applicable. Activity projection adds projectViewedImagePath so the full path is stored as data.imagePath (including on re-projection and from legacy Read payloads); plain text reads are unchanged.

Web and mobile work-log derivation adds viewedImagePath and keeps it when tool.updated events collapse into tool.completed, so truncated detail strings no longer drop the path. Client-runtime presentation prefers viewedImagePath for previews and treats entries with that field as read actions for grouping.

^{Reviewed by Cursor Bugbot for commit b9f4464. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add regression test for streamed Claude Read image metadata in buildThreadFeed

Adds a test in threadActivity.test.ts that exercises an in-progress and completed image-view activity sharing the same tool call, where only the update carries the full image path. The test verifies that collapsing the lifecycle into one activity group preserves the full viewed image path.

^{Macroscope summarized b9f4464.}

[github-actions]

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.3 KiB	13.4 KiB	+158 B (+1.2%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	+2 B (+0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.4 KiB	6.6 KiB	+156 B (+2.4%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	55.6 KiB	57.0 KiB	+1.4 KiB (+2.6%)	66.4 KiB	✅
Codex	Live turn messages	10	10	0 (0.0%)	21	✅
Claude	Total thread wire	13.2 KiB	13.2 KiB	+93 B (+0.7%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+7 B (+0.1%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.3 KiB	6.3 KiB	+86 B (+1.3%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	55.5 KiB	56.3 KiB	+840 B (+1.5%)	66.4 KiB	✅
Claude	Live turn messages	8	8	0 (0.0%)	21	✅

Baseline: 04efa79 · PR result: b9f4464 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

• Codex decoded thread snapshot: 109.4 KiB
• Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

[macroscopeapp]

Approvability

Verdict: Approved at b9f4464

Macroscope's review found this PR approvable — This is a focused fix that carries Claude workspace image paths through the existing server and web/mobile work-log pipeline, with ordinary text reads unaffected. The behavior is narrowly scoped and covered by targeted streaming, projection, grouping, and rendering tests.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate b9f4464

[t3dotgg]

Claude Read tool calls stayed as generic tool rows. Activity projection also removed the full file path, so the existing web and mobile image renderer had no stable path to load.

Classify a Claude Read call as image_view only after its streamed input identifies an image file. Preserve the full path as imagePath through projection and work-log lifecycle merging. The projection also derives this field from old completed Claude payloads, while normal text reads stay unchanged. Legacy rows that carry an image path now group and icon as reads instead of "Used 1 tool".

The image renderer landed in #8936. This change composes with the external-host asset access work in #9023 and does not change asset authorization.

Known gap: tool.updated rows recorded before this change were slimmed at ingest without the input, so an old interrupted image read still shows no image. Completed reads backfill.

Checks:

• 195 focused tests passed, plus a new toolGroupAction case.
• Typechecks passed for server, client runtime, web, and mobile.

Not yet verified in a running client.

First commit by GPT-5.6 Sol with Codex in T3 Code. Audit and follow-up fix by Claude Fable 5.1 with Claude Code.

---

Note

Low Risk
Display and activity-shaping changes only; no auth or asset-access changes, with broad test coverage on adapter, projection, and client merge behavior.

Overview
Claude Read calls on workspace image files now surface as image_view in the thread work log instead of generic tool rows, including while the tool input is still streaming.

The Claude adapter classifies reads using isWorkspaceImagePreviewPath on the parsed file_path/path, updates item type and detail as input_json_delta arrives, and uses the image path as the summary when applicable. Activity projection adds projectViewedImagePath so the full path is stored as data.imagePath (including on re-projection and from legacy Read payloads); plain text reads are unchanged.

Web and mobile work-log derivation adds viewedImagePath and keeps it when tool.updated events collapse into tool.completed, so truncated detail strings no longer drop the path. Client-runtime presentation prefers viewedImagePath for previews and treats entries with that field as read actions for grouping.

^{Reviewed by Cursor Bugbot for commit b9f4464. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add regression test for streamed Claude Read image metadata in buildThreadFeed

Adds a test in threadActivity.test.ts that exercises an in-progress and completed image-view activity sharing the same tool call, where only the update carries the full image path. The test verifies that collapsing the lifecycle into one activity group preserves the full viewed image path.

^{Macroscope summarized b9f4464.}

[github-actions]

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.3 KiB	13.4 KiB	+158 B (+1.2%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	+2 B (+0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.4 KiB	6.6 KiB	+156 B (+2.4%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	55.6 KiB	57.0 KiB	+1.4 KiB (+2.6%)	66.4 KiB	✅
Codex	Live turn messages	10	10	0 (0.0%)	21	✅
Claude	Total thread wire	13.2 KiB	13.2 KiB	+93 B (+0.7%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+7 B (+0.1%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.3 KiB	6.3 KiB	+86 B (+1.3%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	55.5 KiB	56.3 KiB	+840 B (+1.5%)	66.4 KiB	✅
Claude	Live turn messages	8	8	0 (0.0%)	21	✅

Baseline: 04efa79 · PR result: b9f4464 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

• Codex decoded thread snapshot: 109.4 KiB
• Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

[macroscopeapp]

Approvability

Verdict: Approved at b9f4464

Macroscope's review found this PR approvable — This is a focused fix that carries Claude workspace image paths through the existing server and web/mobile work-log pipeline, with ordinary text reads unaffected. The behavior is narrowly scoped and covered by targeted streaming, projection, grouping, and rendering tests.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate b9f4464

[t3dotgg]

Claude Read tool calls stayed as generic tool rows. Activity projection also removed the full file path, so the existing web and mobile image renderer had no stable path to load.

Classify a Claude Read call as image_view only after its streamed input identifies an image file. Preserve the full path as imagePath through projection and work-log lifecycle merging. The projection also derives this field from old completed Claude payloads, while normal text reads stay unchanged. Legacy rows that carry an image path now group and icon as reads instead of "Used 1 tool".

The image renderer landed in #8936. This change composes with the external-host asset access work in #9023 and does not change asset authorization.

Known gap: tool.updated rows recorded before this change were slimmed at ingest without the input, so an old interrupted image read still shows no image. Completed reads backfill.

Checks:

• 195 focused tests passed, plus a new toolGroupAction case.
• Typechecks passed for server, client runtime, web, and mobile.

Not yet verified in a running client.

First commit by GPT-5.6 Sol with Codex in T3 Code. Audit and follow-up fix by Claude Fable 5.1 with Claude Code.

---

Note

Low Risk
Display and activity-shaping changes only; no auth or asset-access changes, with broad test coverage on adapter, projection, and client merge behavior.

Overview
Claude Read calls on workspace image files now surface as image_view in the thread work log instead of generic tool rows, including while the tool input is still streaming.

The Claude adapter classifies reads using isWorkspaceImagePreviewPath on the parsed file_path/path, updates item type and detail as input_json_delta arrives, and uses the image path as the summary when applicable. Activity projection adds projectViewedImagePath so the full path is stored as data.imagePath (including on re-projection and from legacy Read payloads); plain text reads are unchanged.

Web and mobile work-log derivation adds viewedImagePath and keeps it when tool.updated events collapse into tool.completed, so truncated detail strings no longer drop the path. Client-runtime presentation prefers viewedImagePath for previews and treats entries with that field as read actions for grouping.

^{Reviewed by Cursor Bugbot for commit b9f4464. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add regression test for streamed Claude Read image metadata in buildThreadFeed

Adds a test in threadActivity.test.ts that exercises an in-progress and completed image-view activity sharing the same tool call, where only the update carries the full image path. The test verifies that collapsing the lifecycle into one activity group preserves the full viewed image path.

^{Macroscope summarized b9f4464.}

[github-actions]

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.3 KiB	13.4 KiB	+158 B (+1.2%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	+2 B (+0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.4 KiB	6.6 KiB	+156 B (+2.4%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	55.6 KiB	57.0 KiB	+1.4 KiB (+2.6%)	66.4 KiB	✅
Codex	Live turn messages	10	10	0 (0.0%)	21	✅
Claude	Total thread wire	13.2 KiB	13.2 KiB	+93 B (+0.7%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+7 B (+0.1%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.3 KiB	6.3 KiB	+86 B (+1.3%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	55.5 KiB	56.3 KiB	+840 B (+1.5%)	66.4 KiB	✅
Claude	Live turn messages	8	8	0 (0.0%)	21	✅

Baseline: 04efa79 · PR result: b9f4464 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

• Codex decoded thread snapshot: 109.4 KiB
• Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

[macroscopeapp]

Approvability

Verdict: Approved at b9f4464

Macroscope's review found this PR approvable — This is a focused fix that carries Claude workspace image paths through the existing server and web/mobile work-log pipeline, with ordinary text reads unaffected. The behavior is narrowly scoped and covered by targeted streaming, projection, grouping, and rendering tests.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate b9f4464

[t3dotgg]

Claude Read tool calls stayed as generic tool rows. Activity projection also removed the full file path, so the existing web and mobile image renderer had no stable path to load.

Classify a Claude Read call as image_view only after its streamed input identifies an image file. Preserve the full path as imagePath through projection and work-log lifecycle merging. The projection also derives this field from old completed Claude payloads, while normal text reads stay unchanged. Legacy rows that carry an image path now group and icon as reads instead of "Used 1 tool".

The image renderer landed in #8936. This change composes with the external-host asset access work in #9023 and does not change asset authorization.

Known gap: tool.updated rows recorded before this change were slimmed at ingest without the input, so an old interrupted image read still shows no image. Completed reads backfill.

Checks:

• 195 focused tests passed, plus a new toolGroupAction case.
• Typechecks passed for server, client runtime, web, and mobile.

Not yet verified in a running client.

First commit by GPT-5.6 Sol with Codex in T3 Code. Audit and follow-up fix by Claude Fable 5.1 with Claude Code.

---

Note

Low Risk
Display and activity-shaping changes only; no auth or asset-access changes, with broad test coverage on adapter, projection, and client merge behavior.

Overview
Claude Read calls on workspace image files now surface as image_view in the thread work log instead of generic tool rows, including while the tool input is still streaming.

The Claude adapter classifies reads using isWorkspaceImagePreviewPath on the parsed file_path/path, updates item type and detail as input_json_delta arrives, and uses the image path as the summary when applicable. Activity projection adds projectViewedImagePath so the full path is stored as data.imagePath (including on re-projection and from legacy Read payloads); plain text reads are unchanged.

Web and mobile work-log derivation adds viewedImagePath and keeps it when tool.updated events collapse into tool.completed, so truncated detail strings no longer drop the path. Client-runtime presentation prefers viewedImagePath for previews and treats entries with that field as read actions for grouping.

^{Reviewed by Cursor Bugbot for commit b9f4464. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add regression test for streamed Claude Read image metadata in buildThreadFeed

Adds a test in threadActivity.test.ts that exercises an in-progress and completed image-view activity sharing the same tool call, where only the update carries the full image path. The test verifies that collapsing the lifecycle into one activity group preserves the full viewed image path.

^{Macroscope summarized b9f4464.}

[github-actions]

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.3 KiB	13.4 KiB	+158 B (+1.2%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	+2 B (+0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.4 KiB	6.6 KiB	+156 B (+2.4%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	55.6 KiB	57.0 KiB	+1.4 KiB (+2.6%)	66.4 KiB	✅
Codex	Live turn messages	10	10	0 (0.0%)	21	✅
Claude	Total thread wire	13.2 KiB	13.2 KiB	+93 B (+0.7%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+7 B (+0.1%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.3 KiB	6.3 KiB	+86 B (+1.3%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	55.5 KiB	56.3 KiB	+840 B (+1.5%)	66.4 KiB	✅
Claude	Live turn messages	8	8	0 (0.0%)	21	✅

Baseline: 04efa79 · PR result: b9f4464 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

• Codex decoded thread snapshot: 109.4 KiB
• Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

[macroscopeapp]

Approvability

Verdict: Approved at b9f4464

Macroscope's review found this PR approvable — This is a focused fix that carries Claude workspace image paths through the existing server and web/mobile work-log pipeline, with ordinary text reads unaffected. The behavior is narrowly scoped and covered by targeted streaming, projection, grouping, and rendering tests.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate b9f4464

[t3dotgg]

Claude Read tool calls stayed as generic tool rows. Activity projection also removed the full file path, so the existing web and mobile image renderer had no stable path to load.

Classify a Claude Read call as image_view only after its streamed input identifies an image file. Preserve the full path as imagePath through projection and work-log lifecycle merging. The projection also derives this field from old completed Claude payloads, while normal text reads stay unchanged. Legacy rows that carry an image path now group and icon as reads instead of "Used 1 tool".

The image renderer landed in #8936. This change composes with the external-host asset access work in #9023 and does not change asset authorization.

Known gap: tool.updated rows recorded before this change were slimmed at ingest without the input, so an old interrupted image read still shows no image. Completed reads backfill.

Checks:

• 195 focused tests passed, plus a new toolGroupAction case.
• Typechecks passed for server, client runtime, web, and mobile.

Not yet verified in a running client.

First commit by GPT-5.6 Sol with Codex in T3 Code. Audit and follow-up fix by Claude Fable 5.1 with Claude Code.

---

Note

Low Risk
Display and activity-shaping changes only; no auth or asset-access changes, with broad test coverage on adapter, projection, and client merge behavior.

Overview
Claude Read calls on workspace image files now surface as image_view in the thread work log instead of generic tool rows, including while the tool input is still streaming.

The Claude adapter classifies reads using isWorkspaceImagePreviewPath on the parsed file_path/path, updates item type and detail as input_json_delta arrives, and uses the image path as the summary when applicable. Activity projection adds projectViewedImagePath so the full path is stored as data.imagePath (including on re-projection and from legacy Read payloads); plain text reads are unchanged.

Web and mobile work-log derivation adds viewedImagePath and keeps it when tool.updated events collapse into tool.completed, so truncated detail strings no longer drop the path. Client-runtime presentation prefers viewedImagePath for previews and treats entries with that field as read actions for grouping.

^{Reviewed by Cursor Bugbot for commit b9f4464. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add regression test for streamed Claude Read image metadata in buildThreadFeed

Adds a test in threadActivity.test.ts that exercises an in-progress and completed image-view activity sharing the same tool call, where only the update carries the full image path. The test verifies that collapsing the lifecycle into one activity group preserves the full viewed image path.

^{Macroscope summarized b9f4464.}

[github-actions]

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.3 KiB	13.4 KiB	+158 B (+1.2%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	+2 B (+0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.4 KiB	6.6 KiB	+156 B (+2.4%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	55.6 KiB	57.0 KiB	+1.4 KiB (+2.6%)	66.4 KiB	✅
Codex	Live turn messages	10	10	0 (0.0%)	21	✅
Claude	Total thread wire	13.2 KiB	13.2 KiB	+93 B (+0.7%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+7 B (+0.1%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.3 KiB	6.3 KiB	+86 B (+1.3%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	55.5 KiB	56.3 KiB	+840 B (+1.5%)	66.4 KiB	✅
Claude	Live turn messages	8	8	0 (0.0%)	21	✅

Baseline: 04efa79 · PR result: b9f4464 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

• Codex decoded thread snapshot: 109.4 KiB
• Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

[macroscopeapp]

Approvability

Verdict: Approved at b9f4464

Macroscope's review found this PR approvable — This is a focused fix that carries Claude workspace image paths through the existing server and web/mobile work-log pipeline, with ordinary text reads unaffected. The behavior is narrowly scoped and covered by targeted streaming, projection, grouping, and rendering tests.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate b9f4464

[t3dotgg]

Claude Read tool calls stayed as generic tool rows. Activity projection also removed the full file path, so the existing web and mobile image renderer had no stable path to load.

Classify a Claude Read call as image_view only after its streamed input identifies an image file. Preserve the full path as imagePath through projection and work-log lifecycle merging. The projection also derives this field from old completed Claude payloads, while normal text reads stay unchanged. Legacy rows that carry an image path now group and icon as reads instead of "Used 1 tool".

The image renderer landed in #8936. This change composes with the external-host asset access work in #9023 and does not change asset authorization.

Known gap: tool.updated rows recorded before this change were slimmed at ingest without the input, so an old interrupted image read still shows no image. Completed reads backfill.

Checks:

• 195 focused tests passed, plus a new toolGroupAction case.
• Typechecks passed for server, client runtime, web, and mobile.

Not yet verified in a running client.

First commit by GPT-5.6 Sol with Codex in T3 Code. Audit and follow-up fix by Claude Fable 5.1 with Claude Code.

---

Note

Low Risk
Display and activity-shaping changes only; no auth or asset-access changes, with broad test coverage on adapter, projection, and client merge behavior.

Overview
Claude Read calls on workspace image files now surface as image_view in the thread work log instead of generic tool rows, including while the tool input is still streaming.

The Claude adapter classifies reads using isWorkspaceImagePreviewPath on the parsed file_path/path, updates item type and detail as input_json_delta arrives, and uses the image path as the summary when applicable. Activity projection adds projectViewedImagePath so the full path is stored as data.imagePath (including on re-projection and from legacy Read payloads); plain text reads are unchanged.

Web and mobile work-log derivation adds viewedImagePath and keeps it when tool.updated events collapse into tool.completed, so truncated detail strings no longer drop the path. Client-runtime presentation prefers viewedImagePath for previews and treats entries with that field as read actions for grouping.

^{Reviewed by Cursor Bugbot for commit b9f4464. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add regression test for streamed Claude Read image metadata in buildThreadFeed

Adds a test in threadActivity.test.ts that exercises an in-progress and completed image-view activity sharing the same tool call, where only the update carries the full image path. The test verifies that collapsing the lifecycle into one activity group preserves the full viewed image path.

^{Macroscope summarized b9f4464.}

[github-actions]

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.3 KiB	13.4 KiB	+158 B (+1.2%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	+2 B (+0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.4 KiB	6.6 KiB	+156 B (+2.4%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	55.6 KiB	57.0 KiB	+1.4 KiB (+2.6%)	66.4 KiB	✅
Codex	Live turn messages	10	10	0 (0.0%)	21	✅
Claude	Total thread wire	13.2 KiB	13.2 KiB	+93 B (+0.7%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+7 B (+0.1%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.3 KiB	6.3 KiB	+86 B (+1.3%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	55.5 KiB	56.3 KiB	+840 B (+1.5%)	66.4 KiB	✅
Claude	Live turn messages	8	8	0 (0.0%)	21	✅

Baseline: 04efa79 · PR result: b9f4464 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

• Codex decoded thread snapshot: 109.4 KiB
• Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

[macroscopeapp]

Approvability

Verdict: Approved at b9f4464

Macroscope's review found this PR approvable — This is a focused fix that carries Claude workspace image paths through the existing server and web/mobile work-log pipeline, with ordinary text reads unaffected. The behavior is narrowly scoped and covered by targeted streaming, projection, grouping, and rendering tests.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate b9f4464

[t3dotgg]

Claude Read tool calls stayed as generic tool rows. Activity projection also removed the full file path, so the existing web and mobile image renderer had no stable path to load.

Classify a Claude Read call as image_view only after its streamed input identifies an image file. Preserve the full path as imagePath through projection and work-log lifecycle merging. The projection also derives this field from old completed Claude payloads, while normal text reads stay unchanged. Legacy rows that carry an image path now group and icon as reads instead of "Used 1 tool".

The image renderer landed in #8936. This change composes with the external-host asset access work in #9023 and does not change asset authorization.

Known gap: tool.updated rows recorded before this change were slimmed at ingest without the input, so an old interrupted image read still shows no image. Completed reads backfill.

Checks:

• 195 focused tests passed, plus a new toolGroupAction case.
• Typechecks passed for server, client runtime, web, and mobile.

Not yet verified in a running client.

First commit by GPT-5.6 Sol with Codex in T3 Code. Audit and follow-up fix by Claude Fable 5.1 with Claude Code.

---

Note

Low Risk
Display and activity-shaping changes only; no auth or asset-access changes, with broad test coverage on adapter, projection, and client merge behavior.

Overview
Claude Read calls on workspace image files now surface as image_view in the thread work log instead of generic tool rows, including while the tool input is still streaming.

The Claude adapter classifies reads using isWorkspaceImagePreviewPath on the parsed file_path/path, updates item type and detail as input_json_delta arrives, and uses the image path as the summary when applicable. Activity projection adds projectViewedImagePath so the full path is stored as data.imagePath (including on re-projection and from legacy Read payloads); plain text reads are unchanged.

Web and mobile work-log derivation adds viewedImagePath and keeps it when tool.updated events collapse into tool.completed, so truncated detail strings no longer drop the path. Client-runtime presentation prefers viewedImagePath for previews and treats entries with that field as read actions for grouping.

^{Reviewed by Cursor Bugbot for commit b9f4464. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add regression test for streamed Claude Read image metadata in buildThreadFeed

Adds a test in threadActivity.test.ts that exercises an in-progress and completed image-view activity sharing the same tool call, where only the update carries the full image path. The test verifies that collapsing the lifecycle into one activity group preserves the full viewed image path.

^{Macroscope summarized b9f4464.}

[github-actions]

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.3 KiB	13.4 KiB	+158 B (+1.2%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	+2 B (+0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.4 KiB	6.6 KiB	+156 B (+2.4%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	55.6 KiB	57.0 KiB	+1.4 KiB (+2.6%)	66.4 KiB	✅
Codex	Live turn messages	10	10	0 (0.0%)	21	✅
Claude	Total thread wire	13.2 KiB	13.2 KiB	+93 B (+0.7%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+7 B (+0.1%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.3 KiB	6.3 KiB	+86 B (+1.3%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	55.5 KiB	56.3 KiB	+840 B (+1.5%)	66.4 KiB	✅
Claude	Live turn messages	8	8	0 (0.0%)	21	✅

Baseline: 04efa79 · PR result: b9f4464 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

• Codex decoded thread snapshot: 109.4 KiB
• Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

[macroscopeapp]

Approvability

Verdict: Approved at b9f4464

Macroscope's review found this PR approvable — This is a focused fix that carries Claude workspace image paths through the existing server and web/mobile work-log pipeline, with ordinary text reads unaffected. The behavior is narrowly scoped and covered by targeted streaming, projection, grouping, and rendering tests.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate b9f4464

[t3dotgg]

Claude Read tool calls stayed as generic tool rows. Activity projection also removed the full file path, so the existing web and mobile image renderer had no stable path to load.

Classify a Claude Read call as image_view only after its streamed input identifies an image file. Preserve the full path as imagePath through projection and work-log lifecycle merging. The projection also derives this field from old completed Claude payloads, while normal text reads stay unchanged. Legacy rows that carry an image path now group and icon as reads instead of "Used 1 tool".

The image renderer landed in #8936. This change composes with the external-host asset access work in #9023 and does not change asset authorization.

Known gap: tool.updated rows recorded before this change were slimmed at ingest without the input, so an old interrupted image read still shows no image. Completed reads backfill.

Checks:

• 195 focused tests passed, plus a new toolGroupAction case.
• Typechecks passed for server, client runtime, web, and mobile.

Not yet verified in a running client.

First commit by GPT-5.6 Sol with Codex in T3 Code. Audit and follow-up fix by Claude Fable 5.1 with Claude Code.

---

Note

Low Risk
Display and activity-shaping changes only; no auth or asset-access changes, with broad test coverage on adapter, projection, and client merge behavior.

Overview
Claude Read calls on workspace image files now surface as image_view in the thread work log instead of generic tool rows, including while the tool input is still streaming.

The Claude adapter classifies reads using isWorkspaceImagePreviewPath on the parsed file_path/path, updates item type and detail as input_json_delta arrives, and uses the image path as the summary when applicable. Activity projection adds projectViewedImagePath so the full path is stored as data.imagePath (including on re-projection and from legacy Read payloads); plain text reads are unchanged.

Web and mobile work-log derivation adds viewedImagePath and keeps it when tool.updated events collapse into tool.completed, so truncated detail strings no longer drop the path. Client-runtime presentation prefers viewedImagePath for previews and treats entries with that field as read actions for grouping.

^{Reviewed by Cursor Bugbot for commit b9f4464. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add regression test for streamed Claude Read image metadata in buildThreadFeed

Adds a test in threadActivity.test.ts that exercises an in-progress and completed image-view activity sharing the same tool call, where only the update carries the full image path. The test verifies that collapsing the lifecycle into one activity group preserves the full viewed image path.

^{Macroscope summarized b9f4464.}

[github-actions]

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.3 KiB	13.4 KiB	+158 B (+1.2%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	+2 B (+0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.4 KiB	6.6 KiB	+156 B (+2.4%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	55.6 KiB	57.0 KiB	+1.4 KiB (+2.6%)	66.4 KiB	✅
Codex	Live turn messages	10	10	0 (0.0%)	21	✅
Claude	Total thread wire	13.2 KiB	13.2 KiB	+93 B (+0.7%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+7 B (+0.1%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.3 KiB	6.3 KiB	+86 B (+1.3%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	55.5 KiB	56.3 KiB	+840 B (+1.5%)	66.4 KiB	✅
Claude	Live turn messages	8	8	0 (0.0%)	21	✅

Baseline: 04efa79 · PR result: b9f4464 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

• Codex decoded thread snapshot: 109.4 KiB
• Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

[macroscopeapp]

Approvability

Verdict: Approved at b9f4464

Macroscope's review found this PR approvable — This is a focused fix that carries Claude workspace image paths through the existing server and web/mobile work-log pipeline, with ordinary text reads unaffected. The behavior is narrowly scoped and covered by targeted streaming, projection, grouping, and rendering tests.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate b9f4464