Diagnostics

Read-only local and cluster diagnostics for stuck runner, placement, resource, and process inspection.

📄️ Get local node diagnostics

Return a read-only diagnostic bundle for this API node, including runtime identity, placement analysis, live runner-supervisor state, local resources, and relevant OS processes.

📄️ Request direct local runner cancellation

Request cooperative cancellation for one live task on one local runner supervisor. This is a best-effort control path intended for diagnostics and may not stop a runner wedged in native code.

📄️ Capture local node diagnostic bundle

Collect an on-demand diagnostic bundle for this node, optionally focused on one live runner or task. The bundle includes current node diagnostics, runner flight-recorder entries, the latest MLX memory snapshot, and best-effort macOS process samples.

📄️ Get cluster diagnostics

Fan out to reachable peer APIs and return read-only diagnostic bundles for the local node and peers. Unreachable peers are reported as partial failures instead of failing the whole request.

📄️ Get cross-rank runner timeline

Stitch every reachable node's runner-supervisor diagnostics into one cross-rank chronological view. Returns a per-runner synopsis (rank, current phase, seconds-in-phase, MLX memory) and every flight-recorder entry across all ranks merged and sorted by wall-clock timestamp. The intended use is debugging distributed deadlocks where the rank-disagreement signature is invisible from any single node's local diagnostics.

📄️ Get one cluster node diagnostic bundle

Return diagnostics for the requested node from local state or by proxying to a reachable peer API.

📄️ Capture one cluster node diagnostic bundle

Return an on-demand diagnostic capture bundle for the requested node, proxying to a reachable peer API when the target is remote.

📄️ Request direct runner cancellation on one cluster node

Proxy a cooperative live-task cancellation request to the requested node's local diagnostics control endpoint. This is best-effort and may not stop a runner wedged in native code.