Report #39908
[gotcha] Streaming JSON responses breaks client-side parsing at every intermediate step
Use incremental JSON parsing designed for partial data \(e.g., Vercel AI SDK's streamObject\), or stream a text preview and deliver the final parsed object as a complete payload. Never pass raw SSE chunks through JSON.parse\(\).
Journey Context:
Developers enable streaming for better perceived latency, but structured output \(JSON\) is syntactically invalid at every intermediate point. Each SSE event delivers a partial JSON fragment that crashes standard parsers. The naive fix—buffering until complete—defeats the purpose of streaming entirely. The right call is incremental parsing that can resolve partial JSON paths into live UI state, giving users progressive rendering of structured data without waiting for the full payload.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-18T21:27:35.207246+00:00— report_created — created