Fix documented sandbox idle-timeout default (300s → 0 / persistent)

[opencomputerdev]

Verified the SDK/CLI/API surfaces against the actual code in this repo. Found one substantive, repo-wide divergence: the documented default idle timeout was 300s in ~14 places, but the real default is 0 = persistent (never auto-hibernate) in both SDKs (sandbox.ts / sandbox.py), the oc CLI flags, and the worker's sandbox router (DefaultTimeout left unset, and 0 disables the auto-hibernate timer). The dedicated docs/sandboxes/timeout.mdx page already documented the correct default — only the reference tables/ParamFields, the HTTP API reference, and several prose claims (how-it-works, sandboxes/overview, troubleshooting, cli/sandbox) were stale.

Fixes: updated all timeout-default values from 300 → 0 and reworded the prose to say sandboxes are persistent by default and only auto-hibernate when a positive timeout is set. Did NOT touch example code that explicitly passes timeout: 300 — that's valid usage, not a default claim.

Also spot-checked and confirmed ACCURATE (no change): default template base (SDK) vs README's explicit default (a real seeded template per migration 008); env vars OPENCOMPUTER_API_KEY/OPENCOMPUTER_API_URL; oc config set api-key; exec.run() 60s default; and the getAllowedHosts baseSecretStore/union-allowlist behavior (matches internal/api/sandbox_allowed_hosts.go).

Unverified (no access): the managed-agents product surfaces under docs/agents/, docs/agents-api/, and docs/sessions-api/ describe services that AGENTS.md states are not implemented in this repo — left untouched.

Findings (4)

• divergence SDK reference docs claim timeout default 300s; both SDKs default to 0 (persistent) — sdks/typescript/src/sandbox.ts:236 (timeout: opts.timeout ?? 0); sdks/python/opencomputer/sandbox.py:94 (timeout: int = 0)
• divergence CLI reference docs claim --timeout default 300; CLI flag defaults to 0 — cmd/oc/internal/commands/sandbox.go:290 (Int("timeout", 0, "... 0 = never hibernate")) and :301 (wake flag default 0)
• divergence HTTP API reference (create/wake/fork) claim timeout default 300; server treats 0 as persistent and uses no default — internal/api/sandbox.go:206-210 (timeout==0 means persistent); internal/sandbox/router.go:90-97 (defaultTimeout 0 = no auto-timeout); cmd/worker/main.go:531 (RouterConfig leaves DefaultTimeout unset = 0)
• divergence Prose claims (how-it-works, overview, troubleshooting, cli/sandbox) say sandboxes auto-hibernate after 300s by default; actual default never auto-hibernates — internal/sandbox/router.go:112-138 (timer only created when timeout>0); docs/sandboxes/timeout.mdx already documents the correct default of 0 (persistent)

---

🤖 Opened by the OpenComputer docs-reconciler — a scheduled backstop. Review and merge, or push your own commits and it will leave this PR alone.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
opencomputer	🟢 Ready	View Preview	Jun 17, 2026, 4:04 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[2027-evals]

2027 — Eval complete for commit 86d854e

URL	Mapping
digger.dev	→ opensandbox-oc-s-762ac928075c46d2828bcb22.mintlify.app
opencomputer.dev	→ opensandbox-oc-s-762ac928075c46d2828bcb22.mintlify.app

2027 // complete the getting started guide at https://opencomputer.d — Did not finish

- ⚠️ Score nulled: AI judge determined the task was not completed — "Sandbox creation failed with 402 'free trial credits exhausted'; the final Hello World output step of the quickstart was never achieved."

Prompt

complete the getting started guide at https://opencomputer.dev

Commit 86d854e · View report →

---

Evaluating agent experience using 2027.dev · View dashboard