Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
18 changes: 12 additions & 6 deletions quest/m1/announce-takeover.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,11 +58,17 @@ this quest removes the predecessor machinery and grows to [XL].
`lite/announce.ts` and `lite/subscriber.ts`. Remove the takeover sections
from `drafts/draft-lcurley-moq-lite.md`, `doc/concept/identity.md` and
`doc/concept/moq-lite.md`.
- **Inheriting the instance.** `request.route(options)` from
[One Route handle](/quest/m1/api-audit/route/handle.md) creates the
path's exact route under the prefix route's instance by default, and the
answer it gives the waiting request is that route's broadcast. A job
that serves a held broadcast through `Request::serve`
- **Inheriting the instance.** Decided 2026-11-03 (maintainer, on
[moq-dev/moq#7770](https://github.com/moq-dev/moq/pull/7770)):
`request.route(options)` from
[One Route handle](/quest/m1/api-audit/route/handle.md) mints a fresh
instance by default, and ending a job leaves its prefix route open, with
no history of ended paths. Carrying the prefix route's instance onto the
path's exact route, so that the answer the waiting request gets is that
route's broadcast, is this quest's change, and it must keep those
properties: a restarted job still gets a fresh instance, and job
lifetimes stay independent without per-path history of ended jobs.
A job that serves a held broadcast through `Request::serve`
never announces an exact route, so it needs none of this.
- **One stream per path and instance.** A claim may answer a path under
its instance only while that stream is live. Once the job's route ends,
Expand Down Expand Up @@ -144,7 +150,7 @@ beyond [Instance and epoch](https://github.com/moq-dev/moq/pull/7489)'s fields.

## Required

- [One Route handle](/quest/m1/api-audit/route/handle.md) - `request.route` creates the exact route under the claim's instance
- [One Route handle](/quest/m1/api-audit/route/handle.md) - `request.route` creates the path's exact route, minting a fresh instance by default

## Related

Expand Down
24 changes: 19 additions & 5 deletions quest/m1/api-audit/route/handle.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,11 +64,25 @@ JS and the bindings identical.
- **Prefix routes.** A prefix route yields requests, and each one is
answered by `serve(consumer)`,
by `route(options)`, or by `reject`. `route(options)` creates the path's
exact `Route`, which inherits the prefix route's instance by default so
that the reader continues (see [announce takeover](/quest/m1/announce-takeover.md)).
A prefix route takes cost and auth as an exact one does, so claims can
be priced. Today `Requests::route()` is always the default and
`update_route` is crate-private.
exact `Route`. A prefix route takes cost and auth as an exact one does,
so claims can be priced. Today `Requests::route()` is always the default
and `update_route` is crate-private.
- **A job's instance.** ✅ Decided 2026-11-03 (maintainer, on
[moq-dev/moq#7770](https://github.com/moq-dev/moq/pull/7770)):
`request.route(options)` mints a fresh instance by default, as
`Request::prepare` does today, so a job that ends and restarts beneath
the same prefix gets a new instance for its restarted sequences. An
explicit stable instance in the options is only for a caller that
continues its sequences. Ending a job's route withdraws only that path:
the prefix route stays open and keeps answering later requests, each
with its own job lifetime, and the origin keeps no history of ended
paths. The existing predecessor handling stays until
[announce takeover](/quest/m1/announce-takeover.md) replaces it, and
that quest owns continuing the claim's readers on the job's route.
Rejected: inheriting the prefix route's instance by default and making
the prefix terminal once a materialized job ends, which would change
long-lived services; and inheriting it with automatic restarts, which
needs ended-path history or a retirement design this quest does not own.
- **Visibility, not unannounced broadcasts.** Callers that fill the catalog
first (`moq-cli` hls, rtsp and publish; moq-mux
`ts/programs.rs`) or announce after SDP (`moq-rtc/server/whip.rs`) create
Expand Down