[yuhengcai1]

• I have read and reviewed the documentation changes to the best of my ability.
• If the change is significant, I have run the documentation site locally and confirmed it renders as expected.

Summary of changes

Document the corrective nudge after the configured number of failing calls and the hard stop after one further failure. Clarify that action_observation does not shorten the action_error recovery window, while other patterns remain independent.

Companion implementation: OpenHands/software-agent-sdk#6236

Validation: matched the text to the native run-loop regression tests (18 related tests pass), and ran git diff --check. No example code or MDX components changed; the site was not rendered locally. Keep this draft until the companion implementation is accepted.

[mintlify]

Preview approval required

This pull request comes from a fork, so Mintlify won't build a preview until someone with write access approves commit 8fb4dcb.

Approve preview