[codex] Clarify deterministic rerun docs

[MagMueller]

Summary

• Clarifies deterministic rerun semantics with live-tested cache-hit examples for HTTP/fetch and browser-page tasks.
• Fixes Grow Therapy tutorial cache markers from {{...}} to required @{{...}}.
• Documents autoHeal, recordings, fresh data behavior, isTaskSuccessful: null on cache hits, and create-and-run scope.
• Adds typed Python SDK auto_heal support that serializes to autoHeal, plus a payload serialization test.

Live validation

• HTTP JSON probe: first run created scripts/9fa1f896bc8bcd78.py; cached rerun returned changed httpbin params with totalInputTokens: 0, totalOutputTokens: 0, and llmCostUsd: 0.
• Browser-page probe: first run extracted example.com; cached rerun extracted IANA reserved-domain content with llmCostUsd: 0, confirming reruns fetch current/new target content instead of replaying old output.
• Observed caveats reflected in docs: cached script runs can return isTaskSuccessful: null, and recordingUrls only appear when a browser recording exists and the MP4 is ready.

Checks

• CLOUD_REPO_PATH=/Users/magnus/Developer/cloud uv run pytest tests/test_vibe.py -q
• uv run ruff check src/browser_use_sdk/v3/client.py src/browser_use_sdk/v3/resources/sessions.py tests/test_vibe.py
• python -m json.tool docs/cloud/openapi/v3.json >/dev/null

---

Summary by cubic

Clarifies deterministic rerun behavior and adds an auto_heal toggle in the Python SDK to control cached-script validation and auto-regeneration. Docs now show fresh-data reruns, correct @{{...}} markers, and cost/recording caveats; OpenAPI adds autoHeal.

• New Features

  • Python browser_use_sdk.v3 client.run (sync/async/stream) and sessions.create accept auto_heal, serialized as autoHeal.
  • Added payload serialization test to ensure auto_heal=False sends autoHeal: false.
  • OpenAPI (docs/cloud/openapi/v3.json) exposes autoHeal (default true) with behavior details.

• Docs

  • Deterministic rerun: explains template hashing, cache key rules, and that cache hits fetch fresh data (not replay).
  • Shows how to disable auto-healing (autoHeal: false) and notes possible isTaskSuccessful: null on cache hits.
  • Clarifies browser vs direct fetch on cached runs and when recordingUrls appear.
  • Fixes Grow Therapy tutorial to use @{{...}} parameters and adds examples for HTTP and browser flows.

^{Written for commit c404bef. Summary will update on new commits. Review in cubic}

[mintlify]

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

Project	Status	Preview	Updated (UTC)
browser-use	🟢 Ready	View Preview	May 26, 2026, 7:08 PM

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