This listener web surface is the first truthful shell for the current platform. It is built around live queue planning, feedback, explainability, and playback handoff boundaries that already exist in recommendation-api and playback-api.
This is the first live listener wiring. It sends an inline session payload to
the same-origin listener edge at POST /api/session/queue, preserves the
planner contract used by POST /v1/session/queue, keeps today's public
path on a deployed ingest-backed catalog plus active-analysis join, and still keeps a
contract-grade inline fallback pack available for local env-free runs when listener
Pages env wiring is absent.
No live request sent yet. Run the probe to call the same-origin listener queue edge.
Queued tracks will appear here with explainability and applied constraints.
Filtered candidates will appear here with explicit reasons.
Metadata and policy metrics will appear here after the first successful probe.
These are the product-facing states already backed by current services. The shell stays static-first for now, but the copy and structure map directly to live routes.
Capture territory, explicit-policy, blocked artists, blocked assets, and manual tag controls before ranking.
Turn listener actions into deterministic feedback state that can alter the next queue outcome within seconds.
Queue planning alone is not enough. The shell also points clearly to startup, authorize, and CDN handoff so the listener understands when rights gates re-run.
The listener shell should surface these product promises because they already match the backend contract and validation suite.
These routes are the source of truth for the shell. This page should help product and design work stay aligned to the current service reality.
Set live session intent controls and constraints before queue planning.
Apply save, replay, skip, dislike, and manual controls into deterministic behavior state.
Resolve current session intent and behavior into a policy-aware queue plan.
Build startup and buffer tracks while revalidating rights on the playback path.
Produce deterministic allow or deny decisions with reason codes and applied constraints.
Move from planned queue into listener-ready streaming or explicit blocked fallback state.
This shell now includes a read-only live queue probe through inline session payloads and a same-origin listener edge. Public production now activates live candidate-source mode through deployed ingest-backed catalog and active-analysis workers, while local env-free runs still fall back to the inline probe pack. The public worker URLs stay stable, but their backing source is now a bounded read-only ingest seed rather than the old contract-grade bootstrap dataset.