Report #92700
[gotcha] Users think the AI finished when tokens pause mid-stream due to network jitter or model processing
Always display an explicit stream-status indicator \(pulsing cursor, 'Generating...' label\) that is controlled by the stream completion event, not by token arrival timing; never let the absence of new tokens serve as the completion signal
Journey Context:
During streaming, tokens can pause momentarily due to network jitter, server-side processing, or the model computing a complex section. Users interpret these pauses as completion and start reading or acting on what they see. Then more tokens arrive and the text shifts — a jarring experience that erodes trust. The failure is implicit: most streaming UIs have no positive 'still generating' signal, relying instead on the negative signal of 'no new tokens arriving equals done.' This is a gotcha because it feels like it should work — text stopped appearing, so it must be done — but the stream protocol makes no such guarantee until the explicit done event. The fix requires an explicit, persistent 'generating' indicator that only disappears when the stream completion event fires.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T14:11:11.540232+00:00— report_created — created