Nexus
In plain words: Model Status Board
Guide to the Model Status Board (Nexus) at /nexus: see which models are active, warming or cold, preview a model switch plan, and request a real transition.
- 1Viewing changes nothing; Preview is non-binding and reserves nothing.
- 2Request transition runs at maximum operator priority; the server recalculates before acting.
- 3Plan cost only counts evictions; no VRAM, time or energy estimate yet.
Partial Board and transitions work locally; resource-aware planning is Designed.
Words on this page, decoded click one for its card
Model Status Board Nexus
Shows which models are ready, busy or loading, and lets you request a switch.
It's like: The departures board at an airport.
Click a dot to open that part's card.
Use NexusModel Status Board to understand the current readiness of the iron before changing it. Begin with its observations, open Preview to calculate a nonbinding plan, then choose Request transition only when you intend the real maximum-priority lifecycle mutation. Viewing the board alone changes no lifecycle state.
Complete Altar’s startup and local-access steps, then open
http://127.0.0.1:7134/nexus within the same-host browser boundary.
Read the observation before planning
The board loads a timestamped snapshot, refreshes every five seconds, and refreshes when a ticket settles. Stop if Runtime admission is contained appears: runtime admission is fenced.
Managed capabilities are grouped under their SoulstoneLocal Model's first CovenModel Group, falling back to the
AnimatorModel Runtime. A row shows its capability key, normally {animator}:{family}:{model_id}, a state chip,
its checked time or freshness unknown, and Preview. Compare checked with the board's
snapshot time before treating a row as current.
| Displayed chip | Raw observation |
|---|---|
active |
warm |
warming |
warming |
awaited |
activatable on a dynamic capability |
fault |
error |
cold |
Everything else, including cold, unknown, and non-dynamic activatable |
Expand a capability's Observation details for the served warm, health, and reason,
AnimatorModel Runtime, runtime and model. The checked time remains on the row. An unknown value remains unknown even when its compact
chip reads cold. /orchestrator/status also exposes raw phase and process-wide
mutation_containment.
PortalsCloud Models remain read-only. Delegated runtime pools also remain read-only and show display/delivery state, adapter and transport, owning extension, CoffinSandbox profiles, Provider Gate posture, capacity posture, and declared limitations. These are cached observations, not probes or reservations. A refresh does not reserve a capability for a later RunJob Record.
Preview the change you intend
Choose Preview on the managed capability you intend to use. The target stays visible during
loading, and closing the preview prevents a late response from reopening it. Read the
Non-binding preview for action (NO_OP, SOFT_SWAP, or HARD_SWAP), target, AnimatorModel Runtime ids
selected for evict and launch, and policy cost.
That cost currently counts planned evictions. It supplies no estimate of VRAM, time, energy, or topology.
NO_OP disables the action. Otherwise, Request transition submits the real request at maximum
operator priority. The server recalculates before acting, so the preview reserves nothing and
cannot promise the same eviction set.
Evictions are named by AnimatorModel Runtime while board rows are keyed by capability. A CovenModel Group cannot hold two conflicting AnimatorsModel Runtimes, so an eviction lands on another card, not the previewed one. The current board does not mark those affected rows from the plan; read the served eviction identities directly.
Keep one request identity through uncertainty
The browser allocates a request id before submission. If the response is uncertain, keep NexusModel Status Board open and choose Request transition again for the same target to reuse that id. Admission reserves the first target before task launch. PostgreSQL preserves this fence across VesselEngine Room restarts; the memory profile preserves it for one process. Reusing the id for a different target is rejected.
A retry returns the live ticket if one is still available. When its ticket has expired or its process has ended, the same request id is refused without relaunch: the remaining ticket state cannot establish the physical outcome.
NexusModel Status Board keeps that refused id while the page stays open. Leaving or reloading discards the prepared retry, so cancel the navigation warning while the outcome remains unknown. PostgreSQL retains the admission fence, not the browser's retry state. Keep the original identity until the physical outcome is reconciled; losing the answer does not justify creating another physical request.
Follow the ticket and the physical observation
An accepted request returns HTTP 202 with a process-local ticket:
| Ticket | What it establishes |
|---|---|
warming |
No terminal task result has been observed. |
settled |
The task returned; NexusModel Status Board refreshes the board. |
failed |
The task raised or was cancelled. |
The Request ticket keeps its target, current transition phase, and full request id visible even while you preview a different target. Request outcomes also retains full identities after uncertain submission, including after you close the preview.
Terminal ticket truth remains for a 60-second reconnect window by default. If the bounded store is full, it refuses new work before launch instead of evicting active or fresh-terminal tickets. Tickets provide no cancellation, durable history, or restart recovery. Durable admission prevents duplicate effects but cannot settle, fail, or resume a ticket that was lost.
Latest transition observations shows up to 24 newest retained requests from RunJob Record and operator
sources. Select one, or open /nexus?transition={request_id}, to inspect request, source,
target, phase, chosen action, RunJob Record occurrence when supplied, physical transition identity,
and compensation identity labeled restoration.
Its phases are requested, arbitrating, draining, actuating, verifying, compensating,
completed, declined_no_effect, failed_restored, cancelled_restored, contained_uncertain,
or failed. Ticket settlement and these physical observations answer different questions; read
both before judging what happened.
AnA OrbRun Inspector link may add event={event_id}. NexusModel Status Board keeps it only while that request is selected and,
when RunJob Record correlation exists, offers the return to /orb/{run_id}?event={event_id}. Closing the
inspector or selecting another transition drops the event context.
When the accounts disagree
If a chip, raw status and host disagree—or a lost ticket leaves the outcome unknown—follow the existing runtime-transition contract and its Host Reactor observations. Keep the original request identity while reconciling the physical outcome. A contained or unresolved result needs operator recovery; another transition request cannot clear that uncertainty. Reconcile a unit/probe mismatch before retrying.
The current surface is a grouped observation board, preview, request ticket, and latest-observation inspector. Narrow screens place details in the reading flow. It shows no queue order, leases, GPU/VRAM/topology/thermal pressure, durable history, configuration editing, provider accounts, billing, or credentials.
Its semantic board remains primary; any future body map starts as a read-only lens over validated observations. The Frontend Covenant owns that design and its admission gates.
Reading direction
For interface review and design, use the following composition and acceptance case.
The current layout keeps snapshot time and containment first, then grouped observations with their freshness, one selected preview, and its explicit request. Aligned eviction and launch lists make the consequence easier to compare than an inferred topology graph. Preserve the distinction between a capability row and the AnimatorModel Runtime that would be evicted; affected-row highlighting requires exact identity mapping from the served data.
Ticket outcome and physical observation stay separately identified by request, target and time. A recently observed phase is not a complete progress rail, and the latest bounded list is not full history. Unknown or stale states remain recognizable even when a compact chip merges several raw values. New memory, temperature, duration, impact, or health graphics need actual observations and their interpretation before they gain a place on the board.
Acceptance case: inspect a proposed target while an older request is observed as verifying, then lose the response to the new request. Keep both identities clear, retain the original request, and avoid treating a settled ticket as physical success or making a fresh request to cover the unknown result. Check keyboard return from the inspector and a narrow layout with long AnimatorModel Runtime ids. These presentation targets do not deliver durable observation history, restart recovery, or a body map.