fix(runner): increase tool timeout defaults

[mmabrouk]

Tool calls that produce no intermediate progress currently stop after five minutes. This interrupts legitimate long-running commands and external operations.

This change raises both limits that can stop a quiet tool call:

• The per-tool-call timeout increases from 300,000 ms (5 minutes) to 1,800,000 ms (30 minutes).
• The no-progress timeout increases from 300,000 ms (5 minutes) to 1,800,000 ms (30 minutes).

The 45-minute overall run deadline remains unchanged. Deployments can still override every limit through the existing environment variables. The Docker Compose examples and self-hosting reference now show the new defaults.

Validation

• pnpm test: 125 test files and 2,133 tests passed.
• pnpm run typecheck: passed.
• git diff --check: passed.

How to review

1. Review services/runner/src/engines/sandbox_agent/run-limits.ts for the runtime defaults.
2. Review the four Docker Compose environment examples for matching values and comments.
3. Review the self-hosting configuration table for the public defaults.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
agenta-documentation	Blocked		Aug 13, 2026 2:16pm

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 945eb8a0-6c70-4bce-8443-34c8efb8b179

📥 Commits

Reviewing files that changed from the base of the PR and between 728f39f and 9a4c064.

📒 Files selected for processing (6)

• docs/docs/self-host/reference/01-configuration.mdx
• hosting/docker-compose/ee/env.ee.dev.example
• hosting/docker-compose/ee/env.ee.gh.example
• hosting/docker-compose/oss/env.oss.dev.example
• hosting/docker-compose/oss/env.oss.gh.example
• services/runner/src/engines/sandbox_agent/run-limits.ts

Disabled knowledge base sources:

• Linear integration is disabled

You can enable these sources in your CodeRabbit configuration.

---

📝 Walkthrough

Summary by CodeRabbit

• New Features
  • Increased the default agent runner idle timeout from 5 to 30 minutes.
  • Increased the default per-tool-call timeout from 5 to 30 minutes.
• Documentation
  • Updated configuration guides and environment examples to reflect the new timeout defaults.
  • Total run timeout and time-to-first-byte timeout remain unchanged.

Walkthrough

The runner’s default idle and per-tool-call timeouts increase from 5 minutes to 30 minutes. The TTFB timeout and total run timeout remain unchanged. Self-host documentation and EE/OSS environment examples reflect the new defaults.

Changes

Runner timeout defaults

Layer / File(s)	Summary
Runtime timeout defaults services/runner/src/engines/sandbox_agent/run-limits.ts	The default idle and per-tool-call timeouts increase to 30 minutes. The default TTFB timeout remains 2 minutes.
Configuration examples and documentation docs/docs/self-host/reference/01-configuration.mdx, hosting/docker-compose/*/env.*.example	Documentation and EE/OSS environment examples use 1,800,000 ms for idle and per-tool-call timeouts. Other timeout values remain unchanged.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

• Agenta-AI/agenta#5520: Updates related runner timeout behavior in run-limits.ts.
• Agenta-AI/agenta#5558: Modifies runner timeout parsing and normalization.
• Agenta-AI/agenta#5567: Changes and tests the same runner timeout defaults.

✨ Finishing Touches 💡 1

🛠️ Fix failing CI checks 💡

• Create stacked PR
• Commit on current branch

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch agent/increase-tool-timeout

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

Railway Preview Environment

Preview URL	https://gateway-pr-6014.up.railway.app/w
Project	agenta-oss-clone-spike
Image tag	pr-6014-a220b43
Status	Deployed
Railway logs	Open logs
Workflow logs	View workflow run
Updated at 2026-08-13T14:27:29.738Z