Files
orca/docs/reference
NeilandOrca 5ed7114c6a docs(terminal): record why the duplicate-resume fix was not built
I recommended adding a typed end-reason so a user quit stops looking like
a resume candidate, then went to implement it and stopped.

`SleepingAgentSessionRecord` already carries three fields that each exist
to stop something resuming that should not have — `origin`,
`restoreOnTabOpenOnly`, and `automaticResumeBlockedBy` — each traceable
to its own incident, consulted at 22 non-test sites. A fourth predicate,
however well typed, is the fifth containment cycle.

The designs without this bug do not have a better flag; they resume only
on an explicit action, into a new terminal id, and make two agents in one
terminal unrepresentable in the schema. The first of those is a product
decision about whether automatic resume stays a feature, so it is the
user's call rather than mine.

Co-authored-by: Orca <help@stably.ai>
2026-08-08 19:11:54 -07:00
..