Skip to content

Commit ef3eb7b

Browse files
committed
[Doc] State the Listen Stream Delivery Semantics
The Subscriptions page documented the acknowledgement-first contract but not what delivery means: the stream carries only changes that happen after the acknowledgement, nothing is queued while no stream is connected, and a dropped stream is gone together with anything it missed. The Python SDK's subscriptions page states the same contract ("It is not a replay log"). Spelling it out gives client implementers the fetch-after-subscribing guidance and makes the acknowledgement-window behavior explicit.
1 parent 8e0ae73 commit ef3eb7b

1 file changed

Lines changed: 7 additions & 0 deletions

File tree

‎docs/_server/subscriptions.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,13 @@ The first SSE event on the stream is the acknowledgement:
4949
}
5050
```
5151

52+
## Delivery Semantics
53+
54+
A stream delivers only the changes that happen after its acknowledgement; it is not a replay log.
55+
Nothing is queued while no stream is connected, and a dropped stream is gone together with anything it missed.
56+
Clients fetch the current state after subscribing and treat each notification as a cue to refetch,
57+
rather than as a payload.
58+
5259
## Transport Support
5360

5461
The stream is served on the Streamable HTTP modern path; stdio answers `-32601`.

0 commit comments

Comments
 (0)