Skip to content

docs(gate): call entry.record() at the end of a completed turn - #8

Merged
sanctrl merged 1 commit into
mainfrom
docs/record-reply-after-turn
Nov 5, 2026
Merged

sanctrl merged 1 commit into
mainfrom
docs/record-reply-after-turn

Conversation

@sanctrl

@sanctrl sanctrl commented Nov 5, 2026

Copy link
Copy Markdown
Contributor

Docs/docstrings only: a reply verdict's record() is called at the end of a turn that completed — never before the turn, never at its start (the turn's own agentchat_inbox call then saw an empty tray). A completed turn that looked counts as read even if it sent nothing; a crashed turn, or one that could not look, records nothing and the next wake retries. dismiss/defer unchanged. No code change, no version bump.

… at its start

Documents the rule decided after today's production live-fire: the host
calls a reply verdict's record() only once the turn has completed. A
completed turn that looked counts as read even if it sent nothing; a
crashed turn, or one that could not look, records nothing so the
conversation stays on the tray and the next wake retries. dismiss/defer
are still recorded by gate.run at once.

Recording at the start marked the conversation read before the turn's own
agentchat_inbox call (empty tray, parked for the wait window), and a crash
after recording left the peer blocked by the cold-DM one-message rule.

Docs and docstrings only; no behaviour change, no version bump.
@sanctrl
sanctrl merged commit e191121 into main Nov 5, 2026
10 checks passed
@sanctrl
sanctrl deleted the docs/record-reply-after-turn branch November 11, 2026 08:39
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