Skip to content

feat(acp): raise the default background hold cap to 30 minutes - #944

Merged
matt2e merged 1 commit into
mainfrom
how-long-for-background-tasks
Sep 4, 2026
Merged

feat(acp): raise the default background hold cap to 30 minutes#944
matt2e merged 1 commit into
mainfrom
how-long-for-background-tasks

Conversation

@matt2e

@matt2e matt2e commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Sessions holding open for background work were capped at 10 minutes — one Bash-tool max timeout — which truncated longer chains of background shells and the continuations they wake before they could finish.

  • BackgroundHoldConfig::default().hold_cap goes from 600s to 1800s, with the doc comment explaining the new rationale (three Bash-tool ceilings of headroom, still bounded so a hung shell can't hold a session open forever).
  • Updated the session_commands.rs policy doc comment and its default-cap assertion.

Quiescence detection is unchanged, so the typical hold still ends within seconds of the background work going quiet; STAGED_BACKGROUND_HOLD_CAP_SECS still overrides the cap without a rebuild, and STAGED_BACKGROUND_HOLD=0 still disables the hold entirely.

Sessions holding for background work were truncated at the previous
10-minute cap — one Bash-tool max timeout — before longer chains of
background shells and their continuations could finish. Triple the
default; quiescence still ends the typical hold within seconds, and
STAGED_BACKGROUND_HOLD_CAP_SECS still overrides without a rebuild.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Signed-off-by: Matt Toohey <contact@matttoohey.com>
@matt2e
matt2e merged commit d32b152 into main Sep 4, 2026
6 checks passed
@matt2e
matt2e deleted the how-long-for-background-tasks branch September 4, 2026 06:58
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