Skip to content

Design delayed retries for throttled input downloads - #2955

Open
MarcusSorealheis wants to merge 2 commits into
TraceMachina:mainfrom
MarcusSorealheis:codex/tra-1471-throttled-input-design
Open

MarcusSorealheis wants to merge 2 commits into
TraceMachina:mainfrom
MarcusSorealheis:codex/tra-1471-throttled-input-design

Conversation

@MarcusSorealheis

@MarcusSorealheis MarcusSorealheis commented Oct 16, 2026 •

Copy link
Copy Markdown
Member

What and why

Proposes a scheduler delay after input preparation exhausts its deadline on a confirmed upstream throttle. The design covers typed throttle propagation, persisted retry eligibility, result acknowledgments, bounded retry budgets, and a preference for a suitable worker that may retain input data.

Addresses the design item TRA-1471. It accounts for the existing local input retries and reservation holds, and the stream protocol's lack of durable result acknowledgment. Implementation order, mixed-version rollout, rollback, and acceptance checks are included. Runtime behavior and configuration remain unchanged.

How was this verified?

Checked the proposal against the current input preparation, retry, worker stream, and scheduler code, including the result-delivery and execution-ceiling decisions in #2923 and #2925. All relative source links resolve. Repository pre-commit hooks, including Vale and typos, passed for the new document.

No executable code changed; the proposed protocol and scheduling behavior still require implementation and tests.

Risk

Documentation only. The delay defaults are proposals for review. Enabling the future behavior requires result acknowledgment and compatible deferred-state readers on every scheduler sharing the database.

AI assistance

Automated assistance was used to draft the design and run the listed checks.


This change is Reviewable

@vercel

vercel Bot commented Oct 16, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
nativelink Ready Ready Preview Oct 16, 2026 5:34pm UTC
nativelink-aidm Ready Ready Preview Oct 16, 2026 5:34pm UTC

Request Review

This branch was successfully deployed

2 active deployments
Preview – nativelink — 5d3f6e06 Deployed Oct 16, 2026 by vercel[bot]
Preview – nativelink-aidm — 5d3f6e06 Deployed Oct 16, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant