Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
0e440a4
quest: claim m1/archive/subscribe-tracks-outbound
kixelated Oct 22, 2026
bf0bd8a
feat(ietf): list a moq-transport peer's tracks with SUBSCRIBE_TRACKS …
kixelated Oct 22, 2026
93f46ac
feat(ietf): hold listed PUBLISHes paused and resume them for readers
kixelated Oct 22, 2026
f52f2da
docs: describe outbound SUBSCRIBE_TRACKS and retire its quest
kixelated Oct 22, 2026
fd04e75
refactor(ietf): name what a subscription acquires
kixelated Oct 22, 2026
214a568
Merge branch 'main' into quest/m1/archive/subscribe-tracks-outbound
kixelated Oct 22, 2026
8c10c5d
quest: the IETF answerer pauses any subscription
kixelated Oct 22, 2026
19a5f3a
fix(ietf): remove a listed track only on TRACK_ENDED
kixelated Oct 22, 2026
0955ac1
Merge branch 'main' into quest/m1/archive/subscribe-tracks-outbound
kixelated Oct 22, 2026
6882b09
fix(ietf): end a listing entry quietly only on TRACK_ENDED, resumed o…
kixelated Oct 22, 2026
601bad0
docs: name the SUBSCRIBE_TRACKS exceptions to deduplication
kixelated Oct 22, 2026
77f7962
fix(ietf): open a skipped track's paused SUBSCRIBE in the default order
kixelated Oct 22, 2026
f2cd6dc
Merge branch 'main' into quest/m1/archive/subscribe-tracks-outbound
kixelated Oct 22, 2026
f4f120f
quest: reuse the planned SUBSCRIBE pause quest instead of a duplicate
kixelated Oct 22, 2026
960f0ba
quest(m1): settle the listing end reason's API and lite-07 event
kixelated Oct 22, 2026
aa4bbe2
Merge remote-tracking branch 'origin/main' into quest/m1/archive/subs…
kixelated Oct 22, 2026
5b42255
fix(ietf): fail a listing on an unsupported PUBLISH, check owed answe…
kixelated Oct 22, 2026
3b354f3
fix(ietf): refuse a forwarding PUBLISH for a paused listing, resubscr…
kixelated Oct 22, 2026
1711184
Merge remote-tracking branch 'origin/main' into quest/m1/archive/subs…
kixelated Oct 22, 2026
c0ae830
Merge remote-tracking branch 'origin/main' into quest/m1/archive/subs…
kixelated Oct 22, 2026
ba280a2
Merge remote-tracking branch 'origin/main' into quest/m1/archive/subs…
kixelated Oct 22, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 5 additions & 4 deletions doc/concept/standard.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,8 +25,9 @@ maps everything else to "not supported" or a harmless equivalent. The
[moq-lite page](/concept/moq-lite#what-moq-lite-leaves-out) lists what the
subset drops. What a peer actually observes against this implementation:

- **Pull.** Subscribers ask. Single-track `PUBLISH` offers are declined; announce a namespace and serve the resulting subscriptions. Announcements go out unsolicited, and we also ask for every prefix we may discover. The solicit `SETUP` option makes us wait to be asked. Without it, a draft 16+ peer also gets each match as a `NAMESPACE` on its `SUBSCRIBE_NAMESPACE` stream, so it hears the namespace twice. We send `PUBLISH` only to answer a `SUBSCRIBE_TRACKS` (below): on drafts 16 and 17 a `SUBSCRIBE_NAMESPACE` asking only for `PUBLISH` is refused, one asking for both gets only `NAMESPACE`, and any other Subscribe Options value closes the session.
- **`SUBSCRIBE_TRACKS` lists, it never pushes.** On draft 18 and later, it lists every track of every broadcast under its prefix, later ones included. With `FORWARD=0`, each track gets a paused `PUBLISH` carrying its Track Properties, and an error `PUBLISH_DONE` once the track is no longer listed, never `TRACK_ENDED`, since the track may go on elsewhere. A `REQUEST_UPDATE` with `FORWARD=1` resumes one, served from the cache like a `SUBSCRIBE` with the update's filter and answered with `LARGEST_OBJECT`; `FORWARD=0` pauses it again. Each paused `PUBLISH` holds a subscription slot, and past the cap a track gets `PUBLISH_SKIPPED` (`PUBLISH_BLOCKED` on draft 18) instead. A listing that omits `FORWARD` or sets it to 1 asks for every track's objects: from draft 19 each track gets `PUBLISH_SKIPPED`, and the subscriber `SUBSCRIBE`s to what it wants; draft 18 has no such skip, so the request is refused with `NOT_SUPPORTED`. A prefix overlapping another listing gets `PREFIX_OVERLAP`, a `TRACK_PROPERTY_FILTER` gets `NOT_SUPPORTED`, and a `REQUEST_UPDATE` on the listing itself ends it. On draft 18, a `SUBSCRIBE` to a track we `PUBLISH`ed gets `DUPLICATE_SUBSCRIPTION`. Cancelling the listing stops new `PUBLISH`es, while those sent live on. A broadcast is listed only while our publish grant covers it, from scratch once it does. Neither implementation sends `SUBSCRIBE_TRACKS` upstream.
- **Pull.** Subscribers ask. Single-track `PUBLISH` offers are declined, unless they answer our `SUBSCRIBE_TRACKS` (below); announce a namespace and serve the resulting subscriptions. Announcements go out unsolicited, and we also ask for every prefix we may discover. The solicit `SETUP` option makes us wait to be asked. Without it, a draft 16+ peer also gets each match as a `NAMESPACE` on its `SUBSCRIBE_NAMESPACE` stream, so it hears the namespace twice. We send `PUBLISH` only to answer a `SUBSCRIBE_TRACKS` (below): on drafts 16 and 17 a `SUBSCRIBE_NAMESPACE` asking only for `PUBLISH` is refused, one asking for both gets only `NAMESPACE`, and any other Subscribe Options value closes the session.
- **`SUBSCRIBE_TRACKS` lists, it never pushes.** On draft 18 and later, it lists every track of every broadcast under its prefix, later ones included. With `FORWARD=0`, each track gets a paused `PUBLISH` carrying its Track Properties, and an error `PUBLISH_DONE` once the track is no longer listed, never `TRACK_ENDED`, since the track may go on elsewhere. A `REQUEST_UPDATE` with `FORWARD=1` resumes one, served from the cache like a `SUBSCRIBE` with the update's filter and answered with `LARGEST_OBJECT`; `FORWARD=0` pauses it again. Each paused `PUBLISH` holds a subscription slot, and past the cap a track gets `PUBLISH_SKIPPED` (`PUBLISH_BLOCKED` on draft 18) instead. A listing that omits `FORWARD` or sets it to 1 asks for every track's objects: from draft 19 each track gets `PUBLISH_SKIPPED`, and the subscriber `SUBSCRIBE`s to what it wants; draft 18 has no such skip, so the request is refused with `NOT_SUPPORTED`. A prefix overlapping another listing gets `PREFIX_OVERLAP`, a `TRACK_PROPERTY_FILTER` gets `NOT_SUPPORTED`, and a `REQUEST_UPDATE` on the listing itself ends it. On draft 18, a `SUBSCRIBE` to a track we `PUBLISH`ed gets `DUPLICATE_SUBSCRIPTION`. Cancelling the listing stops new `PUBLISH`es, while those sent live on. A broadcast is listed only while our publish grant covers it, from scratch once it does. Rust sends it upstream for a listing (below); JavaScript does not.
- **A Rust TRACKS listing sends `SUBSCRIBE_TRACKS` upstream, only on demand.** Listing a broadcast from a moq-transport peer on draft 18 and later sends `SUBSCRIBE_TRACKS` with `FORWARD=0` while someone lists it, never on connect, announce, or subscribe, so a peer that refuses, resets, or ignores it affects only that listing. Before draft 18 the listing is refused as unsupported. Each listed track's paused `PUBLISH` is its upstream copy, which a reader resumes rather than subscribing again. Only a `PUBLISH_DONE` with `TRACK_ENDED` removes a listed track; any other end, including the error our own answerer sends for an unlisted track, fails the listing, and readers list again.
- **History is one group.** In Rust, Object ID gaps must be marked by Prior Object ID Gap properties for a group to be fetchable. A `FETCH` returns one group from the cache, or on drafts 14 through 19 the saved prefix of the group a new subscription just joined. A range of groups is refused, as is a draft 20+ `LOCATION_FILTER` that ends at Largest Object rather than an absolute End Location. On draft 20 and later, `FETCH_OK`'s End Location is the requested end, capped at Largest Object: a range holding no objects gets an empty fetch stream, and only a start past Largest Object is refused, with `INVALID_RANGE`. A relay's copy with no upstream subscription can't know Largest Object short of the track's end, so it echoes the requested end instead. JavaScript publishing refuses every `FETCH`. Datagrams are never fetchable. A Rust reader that only fetches learns the track from `TRACK_STATUS` instead of subscribing, so a finished track stays fetchable; draft 17 still subscribes, since its `TRACK_STATUS` answer cannot say whether the track is timed, and so does a reader whose publisher refuses `TRACK_STATUS` as `NOT_SUPPORTED`.
- **Compression.** Rust peers on draft 17 and later exchange compressed tracks when both offer the [Flate extension](/draft/moq-flate). Older peers receive one shared inflated copy. A publisher that seals the compression declaration makes that fallback unavailable: an incompatible peer is refused, preserving the sealed metadata. JavaScript does not offer the IETF extension.
- **Timing.** A track whose `SUBSCRIBE_OK` declares no `TIMESCALE` is untimed, as is every track on drafts 14 through 16. A Rust reader that never subscribed takes the units from `TRACK_STATUS` on draft 18 and later.
Expand Down Expand Up @@ -105,8 +106,8 @@ choices. They follow the product model.
termination code, so we close the session with it.

- **Deduplicated subscriptions and discovery.** Shared subscriptions and overlapping
namespace prefixes are coalesced internally, so `DUPLICATE_SUBSCRIPTION` and
`PREFIX_OVERLAP` are never sent.
namespace prefixes are coalesced internally. Only `SUBSCRIBE_TRACKS`, described
above, sends `PREFIX_OVERLAP`, and on draft 18 `DUPLICATE_SUBSCRIPTION`.

- **Subscriber max age is negotiated.** The [Timestamp extension](/draft/moq-timestamp)
carries a subscriber's `max_delay` in `SUBSCRIBE` and `REQUEST_UPDATE` only
Expand Down
3 changes: 2 additions & 1 deletion quest/m1/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,8 @@ tracks, so per-group stats stop costing cluster announces.
- [A widened max age re-offers cached groups](/quest/m1/resolved-demand.md) - a warm relay serves a reader with a wider max age the cached groups a cold relay would, with no wire change
- [Drop set](/quest/m1/drop-set.md) - each cursor judges missing groups against its own budget, so a narrow reader drops promptly and a widening re-offers groups already reported dropped on lite-07
- [Broadcast archives](/quest/m1/archive/README.md) - ANNOUNCE, TRACKS, and a SUBSCRIBE per track record every track under a prefix to any object_store, a host serves a stored broadcast back, and the catalog drops its archive pointer for an opt-in `hls` field
- [Pause an IETF SUBSCRIBE](/quest/m1/ietf-subscribe-pause.md) - Forward=0 pauses a SUBSCRIBE without demand upstream and Forward=1 resumes it, instead of ending it
- [A listing says whether a removed track finished](/quest/m1/listing-end-reason.md) - a listing removal carries whether the track finished, at every hop, so the IETF answerer ends a finished track's PUBLISH with TRACK_ENDED and a Rust-to-Rust IETF listing removes it without a reset
- [Compressed tracks](/quest/m1/compress/README.md) - a track flagged `compress` is DEFLATEd per group by moq-net, forwarded compressed, and inflated once on the relay for peers that cannot signal it; `catalog.json.z` and moq-flate go away
- [lite-06 max sequence](/quest/m1/lite06-max-sequence.md) - group sequence 2^62-1 reaches a lite-06 subscriber or is refused loudly, instead of vanishing
- [Finalize moq-lite-07](/quest/m1/lite07-finalize.md) - when the maintainer cuts it, lite-07 negotiates as `moq-lite-07` and the next release ships it
Expand All @@ -100,7 +102,6 @@ tracks, so per-group stats stop costing cluster announces.
- [A public model](/quest/m1/public-model/README.md) - every model item a built-in session reaches is public, unnecessary, or marked deliberately private, so a custom publisher, subscriber, or relay builds from the public model alone
- [A smaller, safer API than release](/quest/m1/api-audit/README.md) - every surface added since release has a consumer or is gone, overlapping operations are collapsed, names mirror across Rust, JS, and the bindings, and every break has its MIGRATE entry
- [FETCH_OK whole group](/quest/m1/ietf-fetch-end-location.md) - on drafts 14 to 19, FETCH_OK End Object 0 means the whole group in both directions, and a FETCH ending at the maximum group is refused as unsupported
- [Pause an IETF SUBSCRIBE](/quest/m1/ietf-subscribe-pause.md) - Forward=0 pauses a SUBSCRIBE without demand upstream and Forward=1 resumes it, instead of ending it
- [JavaScript FETCH](/quest/m1/js-fetch.md) - browser publishers answer IETF FETCH through the JS ranges request surface
- [IETF fill timeout](/quest/m1/ietf-fill-timeout.md) - native FILL_TIMEOUT bounds upstream waiting on drafts 18-22, alongside local content-age enforcement
- [Rust identity enforcement](/quest/m1/catalog-identity-rs.md) - `moq-mux` refuses a redefined rendition, and every Rust publisher mints a new rendition name for a decoder identity change and updates everything else in place
Expand Down
6 changes: 2 additions & 4 deletions quest/m1/archive/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,9 +31,8 @@ archive (per-track `.timeline.z` records named by the catalog's root
track, gating the lite-07 cut (`broadcast::Consumer::tracks` in Rust,
`broadcast.Consumer.tracks()` in JS).
moq-transport answers SUBSCRIBE_TRACKS through the same hook in Rust and
JavaScript, and learns an
IETF peer's tracks with a FORWARD=0 SUBSCRIBE_TRACKS
([outbound SUBSCRIBE_TRACKS](/quest/m1/archive/subscribe-tracks-outbound.md)). Rejected:
JavaScript and, in Rust, learns an IETF peer's tracks with a FORWARD=0
SUBSCRIBE_TRACKS whose held PUBLISHes resume for data. Rejected:
SUBSCRIBE_ALL, whose relay had to merge pushed feeds into pulled copies
([moq-dev/moq#5931](https://github.com/moq-dev/moq/pull/5931)). The archive
no longer selects tracks from a catalog.
Expand Down Expand Up @@ -87,7 +86,6 @@ from a host. Each child fixes the stale docs it touches.

- [Archive consumer](/quest/m1/archive/consumer.md) - `archive::Consumer` serves a stored prefix as a broadcast from its key listing, and `moq export/import archive` use the new pair
- [Catalog HLS field](/quest/m1/archive/catalog-hls.md) - the root `archive` section is gone; an opt-in per-rendition `hls` field marks each aligned HLS segment's first group and pts and declares its nominal duration
- [Outbound SUBSCRIBE_TRACKS](/quest/m1/archive/subscribe-tracks-outbound.md) - an IETF peer's tracks are listed through the TRACKS hook by a FORWARD=0 SUBSCRIBE_TRACKS, whose held PUBLISH resumes for data
- [Fixed HLS target duration](/quest/m1/archive/hls-target.md) - one `EXT-X-TARGETDURATION` for the run, from the declared `hls` duration; an overrun is listed with a warning
- [History from the retained floor](/quest/m1/archive/history-floor.md) - HLS history over an archive consumer broadcast whose start was pruned lists from its oldest stored segment

Expand Down
103 changes: 0 additions & 103 deletions quest/m1/archive/subscribe-tracks-outbound.md

This file was deleted.

4 changes: 2 additions & 2 deletions quest/m1/ietf-subscribe-pause.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ paused wait watches only listing removal, session close, and the auth gate, so
a SUBSCRIBE paused there would never see its track end. Keep a watcher for the
track's end while paused, so a track that ends sends PUBLISH_DONE with
TRACK_ENDED, which the paused-SUBSCRIBE removal in
[outbound SUBSCRIBE_TRACKS](/quest/m1/archive/subscribe-tracks-outbound.md)
outbound SUBSCRIBE_TRACKS ([moq-dev/moq#6280](https://github.com/moq-dev/moq/pull/6280))
relies on. Carry the SUBSCRIBE's grant across the pause too:
`apply_subscription_update` returns `Served::Paused` before it starts
`verify_renewal`, and the paused loop refuses AUTHORIZATION TOKEN. A
Expand All @@ -58,4 +58,4 @@ served instead of refused.

## Related

- [Outbound SUBSCRIBE_TRACKS](/quest/m1/archive/subscribe-tracks-outbound.md) - the subscriber side that sends Forward=0 and toggles it
- [Broadcast archives](/quest/m1/archive/README.md) - lists an IETF peer's tracks through SUBSCRIBE_TRACKS, which sends Forward=0 and toggles it
Loading
Loading