Skip to content

docs(adr): interrupt ends only the Turn and a mid-Turn message is a native Steer (#255) - #257

Merged
Sandstorm831 merged 16 commits into
mainfrom
docs/interrupt-steer
Sep 29, 2026
Merged

Sandstorm831 merged 16 commits into
mainfrom
docs/interrupt-steer

Conversation

@Sandstorm831

Copy link
Copy Markdown
Collaborator

Records the decision made on Decide how the human interrupts a Turn and sends a message while a Turn is working.

  • ADR 0035 — Interrupt ends only the Turn (the Run waits blocked on the human; an Agent step's follow-up Turn stays in the same Attempt and auto-advances on a clean end); a mid-Turn message is a native Steer in both agent Step kinds; a Turn lasts until every Steer is delivered (Codex leftovers re-delivered inside the Adapter); Interrupt drops undelivered Steers; Claude Code stops with the raw interrupt control request, SIGTERM + --resume as fallback; Steer and stop recording.
  • ADR 0022 — dated inline edit of the controls paragraph.
  • Glossary — Agent step, Turn, Entry Turn, Steer, Interrupt, the blocked row, and the related-decisions link.
  • docs/headless-parity.md — new information doc listing the TUI capabilities headless lacks, pointed to from src/headless/AGENTS.md's new Read next.
  • Research — merges research/255-claude-live-interrupt (live Claude Code 2.1.284 interrupt and mid-Turn send tests) and corrects one wrong line in the Establish how T3 Code and the native Claude Code and Codex clients interrupt a Turn and queue a message typed mid-Turn #254 note.

Merge with a merge commit (not squash/rebase) so the pinned research commit links survive.

Docs only; prettier --check and the guidance-structure suite pass.

🤖 Generated with Claude Code

…rmission bridge on 2.1.284 (#255)

Round 2 of the live note: a raw interrupt while a tool waits on a stand-in
MCP permission bridge, SIGTERM in the same state, and mid-Turn user frames
across multi-call rounds, MCP calls, and a permission wait.
@Sandstorm831

Copy link
Copy Markdown
Collaborator Author

Added the second live recording (96a07c1, merged with a merge commit) and tightened ADR 0035's Steer boundary and permission-wait stop to match it (12ad256). See the #255 addendum.

…#255)

Live codex-cli 0.157.1 app-server runs: empty-input turn/start is accepted on an idle thread and answers a leftover steer; a steer during a Stop hook is answered in the same Turn; the leftover window after the regular-task pending-input check is hit 6/22 by steering on the Stop hook's hook/completed; same-text re-delivery records the text twice.
@Sandstorm831

Copy link
Copy Markdown
Collaborator Author

Merged the third live round: Claude Code a271c4a and Codex 32c8f72, each with a merge commit. ADR 0035 now settles Codex leftover re-delivery on an empty turn/start. See the latest #255 addendum.

@Sandstorm831

Copy link
Copy Markdown
Collaborator Author

Merged the Windows live recording (db84242, with a merge commit) and recorded ADR 0035's Windows tool-process limit and per-OS process-stop fallback (09b02bc). Guidance-structure checks pass. See the Windows addendum on #255.

@Sandstorm831
Sandstorm831 merged commit c9057c9 into main Sep 29, 2026
18 checks passed
@Sandstorm831
Sandstorm831 deleted the docs/interrupt-steer branch September 29, 2026 08:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant