Add automatic retry for timeout errors with configurable intervals #143
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Adding CLAUDE.md with task information for AI processing. This file will be removed when the task is complete. Issue: #142
This reverts commit 424c33d.
Contributor
Author
🤖 Solution Draft LogThis log file contains the complete execution trace of the AI solution draft process. 💰 Cost estimation:
Now working session is ended, feel free to review and add any feedback on the solution draft. |
Contributor
Author
|
🤖 AI Work Session Started Starting automated work session at 2026-01-30T17:59:25.788Z The PR has been converted to draft mode while work is in progress. This comment marks the beginning of an AI work session. Please wait working session to finish, and provide your feedback. |
Document the root cause analysis of why timeout errors are not retried, including error propagation path through AI SDK and the agent's error handling. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Detect DOMException TimeoutError (from AbortSignal.timeout()) and generic timeout errors, creating a retryable TimeoutError that triggers automatic retry with configurable delays (30s, 60s, 120s for up to 3 attempts). Previously, timeout errors fell through to NamedError.Unknown and were not retried, causing immediate session failure on transient network issues. Fixes #142 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
konard
changed the title
The operation timed out, not fail immediatelyCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Contributor
Author
🤖 Solution Draft LogThis log file contains the complete execution trace of the AI solution draft process. 💰 Cost estimation:
Now working session is ended, feel free to review and add any feedback on the solution draft. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Fixes #142
Adds automatic retry when API requests time out with
"The operation timed out."error, instead of failing immediately. Uses configurable retry intervals of 30s, 60s, and 120s (3 retries max).Root Cause
The
"The operation timed out."error is aDOMExceptionwithname === 'TimeoutError', generated byAbortSignal.timeout(). The AI SDK'shandleFetchError()re-throws this error as-is (not wrapped inAPICallError), so it bypasses the existing retry logic and creates an unretryableNamedError.Unknown.Changes
js/src/session/message-v2.ts: AddedTimeoutErrorerror type; detectDOMExceptionwithname === 'TimeoutError'and generic timeout errors infromError()js/src/session/retry.ts: Added timeout-specific retry configuration: 3 retries with 30s, 60s, 120s delaysjs/src/session/processor.ts: Added retry handling forTimeoutErroralongside existingAPIErrorandSocketConnectionErrorretry pathsjs/tests/timeout-retry.test.js: 16 tests covering timeout error detection, retry configuration, and delay calculationdocs/case-studies/issue-142/: Case study with root cause analysis and original error logRetryable errors now handled
APIError(isRetryable)SocketConnectionErrorTimeoutError(NEW)AbortSignal.timeout()Test Results
All 29 retry-related tests pass (16 new + 13 existing socket-retry tests). Lint passes with no warnings.