Spec 0241 — Orchestrator: per-turn liveness — heartbeat thread, per-turn BaseException capture, whole-turn cap wrapping stream consumption; verifier I2.8

dev

0241

per-turn-liveness-heartbeat-exception-capture-and-stream-wrapping-cap

Orchestrator: per-turn liveness — heartbeat thread, per-turn BaseException capture, whole-turn cap wrapping stream consumption; verifier I2.8

new-feature

new-feature

MINOR

TBD

deployed

['0222', '0239']

M

2026-05-27

2026-05-27T23:14:17Z

2026-05-27T23:29:35Z

2026-05-27T23:33:06Z

https://github.com/Lexiz/dual-research/pull/277

handoffs/2026-05-28-spec-0241-per-turn-liveness-heartbeat-exception-capture-and-stream-wrapping-cap.md

ship

Live re-run 20260527-200213 cleared phases 0-3 (parser fix worked, organic phase-2 convergence over 3 rounds, full draft-v1.md produced) then phase 4 issued turn_started -> turn_inputs and died silently with no terminal event, no tombstone, metrics.ended_at=None. Process was NOT killed by the user (verified). The existing 600s httpx timeout in anthropic_agent.py:79 / openai_agent.py:46 is request-establishment-only — does not bound mid-stream stalls. 0222's run-loop tombstone does not catch per-turn API-wrapper exceptions. Result: the orchestrator can die silently in any long-running streamed-agent turn, untraceable. This spec closes the per-turn liveness gap with one authoritative timeout, structured exception capture, and observable heartbeats.

{}

{}

{"branch": "spec/0241-per-turn-liveness-heartbeat-exception-capture-and-stream-wrapping-cap", "from": "main@a6c2bd2"}

{}

{"files_changed": 10, "commits": 0}

{}

{"passed": 2263}

{"url": "https://github.com/Lexiz/dual-research/pull/277"}

{"pr": "https://github.com/Lexiz/dual-research/pull/277"}

{}

{"version": "1.56.0"}

{}

{"path": "handoffs/2026-05-28-spec-0241-per-turn-liveness-heartbeat-exception-capture-and-stream-wrapping-cap.md"}