Dual-Path Task Event Publication Pipeline TaskExecutionContext and Worker publish QueueEvents to QueueEventPublisher, which persists durable history before broadcasting to ChannelsQueueEventSink SSE/WebSocket streams. Task & Worker Lifecycle TaskExecutionContext ctx.progress(percent, stage=...) ctx.log(message, level="info") ctx.event(event_type, data=...) enqueued • started • completed Event Coordinator QueueEventPublisher Commit-before-live ordering Assigns monotonic sequence ID delivery="background" | "strict" Path A Path B Durable History (QueueEventLog) EventHistoryConfig(batch_size=20) Batched record_events_batch() commits Query via query_events() & summarize_stages() Live Browser Fan-Out ChannelsQueueEventSink -> /queues/events WS `/queues/events` & SSE `/queues/events/sse` Queue / Task / Global topic channels
Gap-Free Cursor Replay & Planned Stream Rollover SSE and WebSocket subscribers replay missed history from Last-Event-ID or after_sequence, deduplicate live frames, and reconnect seamlessly on max_stream_duration. Subscribe & Replay Last-Event-ID / after_sequence Subscribes to live Channels topic first Replays QueueEventLog(after_sequence=N) Deduplicates live frames <= replayed seq Zero missed events on reconnect Planned Stream Rollover max_stream_duration=1500.0 Closes cleanly before Cloud Run timeout Emits `retry: <retry_ms>` SSE hint WebSocket close code 1001 (`stream_rollover`) Browser EventSource auto-resumes Shielded Teardown CancelScope(shield=True) Shields subscriber cleanup on disconnect Prevents leaked Channels subscriptions Flushes pending EventBuffer on shutdown Safe under high client churn