Merge pull request #552 from koic/document_listen_delivery_semantics

[Doc] State the Listen Stream Delivery Semantics
This commit is contained in:
Koichi ITO 2026-09-14 22:29:28 +09:00 • committed by GitHub
commit a18c628787
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -49,6 +49,13 @@ The first SSE event on the stream is the acknowledgement:
}
```
## Delivery Semantics
A stream delivers only the changes that happen after its acknowledgement; it is not a replay log.
Nothing is queued while no stream is connected, and a dropped stream is gone together with anything it missed.
Clients fetch the current state after subscribing and treat each notification as a cue to refetch,
rather than as a payload.
## Transport Support
The stream is served on the Streamable HTTP modern path; stdio answers `-32601`.