--- a/seobeo/README.md	Tue Aug 04 16:49:01 2026 -0700
+++ b/seobeo/README.md	Tue Aug 04 16:49:11 2026 -0700
@@ -8,6 +8,7 @@
 - SSL/TLS support
 - Async networking with libuv
 - Joinable/detached tasks and bounded worker pools
+- Server-Sent Events routes and event framing
 - Snapshot testing utilities
 
 ## Files
@@ -18,6 +19,7 @@
 | `seobeo_internal.h` | Internal declarations |
 | `s_http_client.c` | HTTP client implementation |
 | `s_network.c` | Network utilities |
+| `s_sse.c` | Server-Sent Events framing and stream lifecycle |
 | `s_ssl.c` | SSL/TLS handling |
 | `s_logging.c` | Logging utilities |
 | `s_worker.c` | Thread and worker-pool implementation |
@@ -88,6 +90,42 @@
 discarded by a non-draining shutdown. User callbacks never run while the pool
 mutex is held.
 
+## Server-Sent Events
+
+Register an SSE route separately from ordinary response and stream handlers:
+
+```c
+static void Build_Events(
+    Seobeo_SSE_Stream *p_stream,
+    Seobeo_Request_Entry *p_request,
+    Dowa_Arena *p_arena)
+{
+  (void)p_request;
+  (void)p_arena;
+  Seobeo_SSE_Event event = {
+    .event = "build",
+    .id = "42",
+    .data = "started\ncompiling",
+    .retry_ms = 2000,
+  };
+  Seobeo_SSE_Send(p_stream, &event);
+  Seobeo_SSE_Send_Comment(p_stream, "heartbeat");
+}
+
+Seobeo_Router_Register_SSE("/events/builds", Build_Events);
+```
+
+SSE handlers run once when a client connects and must return promptly so edge
+workers remain available. Call `Seobeo_SSE_Retain` before storing a stream for
+later work and pair it with `Seobeo_SSE_Release`; use
+`Seobeo_SSE_Is_Open` before sending. Do not retain the request map or arena
+after the handler returns. A return value of `1` means the record was retained
+behind socket backpressure and `Seobeo_SSE_Flush` should be retried later.
+`SEOBEO_SSE_BACKPRESSURE` means the bounded pending queue is full and the new
+record was not accepted. Events are bounded by the handle write-buffer
+capacity so one record is queued atomically; larger records return
+`SEOBEO_SSE_EVENT_TOO_LARGE`.
+
 ## Dependencies
 
 - libuv (via //third_party/libuv)