fix(react): refresh transport across renders in useChat#15380
Closed
naumanAhmed3 wants to merge 1 commit into
Closed
fix(react): refresh transport across renders in useChat#15380naumanAhmed3 wants to merge 1 commit into
naumanAhmed3 wants to merge 1 commit into
Conversation
useChat previously captured the transport (and any inline body / headers / prepareSendMessagesRequest baked into it) on the very first render, so inline transports closing over component state forever sent the first-render value. Apply the same pattern already used for onFinish / onError / onToolCall: keep the user's transport in a ref, and pass Chat a stable delegating proxy that reads the latest transport on every sendMessages / reconnectToStream call. Closes vercel#7819.
This was referenced May 17, 2026
5 tasks
pull Bot
pushed a commit
to ben-vargas/ai
that referenced
this pull request
Jul 1, 2026
…one (vercel#16546) ## Background `useChat()` creates its `Chat` instance once and stores it in a `useRef()`, so as a result, a `transport` passed to `useChat()` was captured and then frozen at its value in the first render. If react state later changes, the `transport` becomes stale. A very similar problem was addressed in vercel#8985 but with callbacks. ## Summary Rather than passing the transport directly to `Chat`, this passes a proxy object that always reads the latest transport (or falls back to a default one). This uses the same solution as in vercel#8985 for callbacks. ## Manual Verification Added a route to the ai-e2e-next example at `/chat/stale-transport-demo`. It reproduces the bug without the changes made, and then is fixed with these changes. ## Related Issues Fixes vercel#7819 Closes vercel#12330 Closes vercel#13464 Closes vercel#15380 Closes vercel#16326
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
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.
What
useChatpreviously capturedtransport(and anybody/headers/prepareSendMessagesRequestbaked into it) on the very first render via the initialnew Chat(...)call, so an inline transport closing over component state would forever send the value from that first render. The community report in #7819 shows the most common shape:The other callback options (
onFinish,onError,onToolCall, ...) already use acallbacksRefpattern to stay fresh across renders. This PR extends the same pattern totransport:userTransportRefthat gets refreshed on every render.ChatTransportproxy once. Its identity never changes, soChathappily keeps it across renders, but eachsendMessages/reconnectToStreamcall reads through to whatever the most-recent user transport is.If the user does not supply a transport, the ref stays unset and
Chatfalls back to its built-in default (no behavior change for that path).Why this approach
callbacksRefpattern foronFinish/onError/onToolCallalready present in this hook — least surprising for readers.ChatAPI change.transportisprivate readonlyonAbstractChatand stays that way; the proxy lives on the React side only.new DefaultChatTransport({ body: { state } })recreated each renderuserTransportRef.Tests
Adds one regression test (
describe('transport state stays fresh across renders (#7819)')) that mirrors the exact issue body:[subagent, setSubagent] = useState('todos-agent')body: { subagent }on aDefaultChatTransportconstructed inline'research-agent'subagentis'research-agent', not the stale'todos-agent'Before this fix the assertion would fail with
'todos-agent'.Notes
Closes #7819.