texas2step 2.4.3__tar.gz → 2.4.5__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (68) hide show
  1. {texas2step-2.4.3 → texas2step-2.4.5}/PKG-INFO +5 -5
  2. {texas2step-2.4.3 → texas2step-2.4.5}/README.md +4 -4
  3. {texas2step-2.4.3 → texas2step-2.4.5}/docs/api.md +8 -3
  4. {texas2step-2.4.3 → texas2step-2.4.5}/docs/configuration.md +5 -3
  5. {texas2step-2.4.3 → texas2step-2.4.5}/docs/methodology.md +19 -2
  6. {texas2step-2.4.3 → texas2step-2.4.5}/docs/roadmap.md +20 -0
  7. {texas2step-2.4.3 → texas2step-2.4.5}/docs/traffic.md +3 -1
  8. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/__init__.py +1 -1
  9. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/api/meta.py +2 -0
  10. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/api/wire.py +9 -1
  11. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/app.py +2 -1
  12. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/config.py +18 -2
  13. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/config_template.toml +4 -0
  14. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/page.py +5 -0
  15. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/rtc.py +17 -0
  16. texas2step-2.4.5/src/texas2step/static/assets/app.css +1 -0
  17. texas2step-2.4.5/src/texas2step/static/assets/app.js +8 -0
  18. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/static/index.html +3 -2
  19. texas2step-2.4.3/src/texas2step/static/assets/app.css +0 -1
  20. texas2step-2.4.3/src/texas2step/static/assets/app.js +0 -8
  21. {texas2step-2.4.3 → texas2step-2.4.5}/.gitignore +0 -0
  22. {texas2step-2.4.3 → texas2step-2.4.5}/LICENSE.md +0 -0
  23. {texas2step-2.4.3 → texas2step-2.4.5}/deploy/nginx/texas2step-http.conf +0 -0
  24. {texas2step-2.4.3 → texas2step-2.4.5}/deploy/nginx/texas2step-log.conf +0 -0
  25. {texas2step-2.4.3 → texas2step-2.4.5}/deploy/nginx/texas2step-speedtest.conf +0 -0
  26. {texas2step-2.4.3 → texas2step-2.4.5}/deploy/nginx/texas2step.conf +0 -0
  27. {texas2step-2.4.3 → texas2step-2.4.5}/deploy/texas2step-update.service +0 -0
  28. {texas2step-2.4.3 → texas2step-2.4.5}/deploy/texas2step-update.timer +0 -0
  29. {texas2step-2.4.3 → texas2step-2.4.5}/deploy/texas2step.default +0 -0
  30. {texas2step-2.4.3 → texas2step-2.4.5}/deploy/texas2step.service +0 -0
  31. {texas2step-2.4.3 → texas2step-2.4.5}/docs/access.md +0 -0
  32. {texas2step-2.4.3 → texas2step-2.4.5}/docs/development.md +0 -0
  33. {texas2step-2.4.3 → texas2step-2.4.5}/docs/experience.md +0 -0
  34. {texas2step-2.4.3 → texas2step-2.4.5}/docs/images/hero-dark.jpg +0 -0
  35. {texas2step-2.4.3 → texas2step-2.4.5}/docs/images/results-dark.jpg +0 -0
  36. {texas2step-2.4.3 → texas2step-2.4.5}/docs/images/results-light.jpg +0 -0
  37. {texas2step-2.4.3 → texas2step-2.4.5}/docs/images/upload-light.jpg +0 -0
  38. {texas2step-2.4.3 → texas2step-2.4.5}/docs/install.md +0 -0
  39. {texas2step-2.4.3 → texas2step-2.4.5}/docs/security.md +0 -0
  40. {texas2step-2.4.3 → texas2step-2.4.5}/legacy/README.md +0 -0
  41. {texas2step-2.4.3 → texas2step-2.4.5}/pyproject.toml +0 -0
  42. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/__main__.py +0 -0
  43. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/access.py +0 -0
  44. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/api/__init__.py +0 -0
  45. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/api/access.py +0 -0
  46. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/api/measure.py +0 -0
  47. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/api/results.py +0 -0
  48. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/cli.py +0 -0
  49. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/cluster.py +0 -0
  50. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/config_edit.py +0 -0
  51. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/config_merge.py +0 -0
  52. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/engine.py +0 -0
  53. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/iface.py +0 -0
  54. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/lockouts.py +0 -0
  55. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/logs.py +0 -0
  56. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/payload.py +0 -0
  57. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/quality.py +0 -0
  58. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/static/assets/swagger/LICENSE +0 -0
  59. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/static/assets/swagger/NOTICE +0 -0
  60. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/static/assets/swagger/swagger-ui-bundle.js +0 -0
  61. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/static/assets/swagger/swagger-ui-bundle.js.LICENSE.txt +0 -0
  62. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/static/assets/swagger/swagger-ui.css +0 -0
  63. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/static/favicon.svg +0 -0
  64. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/stats.py +0 -0
  65. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/store.py +0 -0
  66. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/traffic.py +0 -0
  67. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/update.py +0 -0
  68. {texas2step-2.4.3 → texas2step-2.4.5}/src/texas2step/words.txt +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: texas2step
3
- Version: 2.4.3
3
+ Version: 2.4.5
4
4
  Summary: Web-centric throughput, latency, jitter and packet-loss measurement between endpoints.
5
5
  Project-URL: Homepage, https://github.com/robert-patrick-texas/texas2step
6
6
  Project-URL: Documentation, https://robert-patrick-texas.github.io/texas2step/
@@ -62,14 +62,14 @@ to the people using a connection: [docs/experience.md](https://github.com/robert
62
62
 
63
63
  ![Results](https://raw.githubusercontent.com/robert-patrick-texas/texas2step/main/docs/images/results-light.jpg)
64
64
 
65
- The UI has five views: **Test** (gauge, live link animation, charts, exportable and
65
+ The UI has six views: **Test** (gauge, live link animation, charts, exportable and
66
66
  shareable results), **Monitor** (continuous UDP probing with a scrolling RTT and loss
67
67
  trace, to one server or to two at once for a side-by-side comparison, or a voice or video
68
68
  call's packets scored every 10 seconds), **Diag** (HTTP/1.1,
69
69
  HTTP/2 and HTTP/3, WebSocket and UDP over IPv4 and IPv6, tried once a second, with your addresses, NAT,
70
- TLS and an event log), **History** (saved runs and trend), and **API** (copy-ready
71
- examples). A site can hide any of them (`page_test`, `page_monitor`, `page_diag`,
72
- `page_history`, `page_api`). Every
70
+ TLS and an event log), **History** (saved runs and trend), **?** (what the tool does, in plain
71
+ words, for anyone), and **API** (copy-ready examples). A site can hide any of them
72
+ (`page_test`, `page_monitor`, `page_diag`, `page_history`, `page_help`, `page_api`). Every
73
73
  chart has a hover readout and a table equivalent.
74
74
 
75
75
  Visitors pick a theme from the header: Light, Dark, America, Energy, Federal, Military or
@@ -34,14 +34,14 @@ to the people using a connection: [docs/experience.md](docs/experience.md).
34
34
 
35
35
  ![Results](docs/images/results-light.jpg)
36
36
 
37
- The UI has five views: **Test** (gauge, live link animation, charts, exportable and
37
+ The UI has six views: **Test** (gauge, live link animation, charts, exportable and
38
38
  shareable results), **Monitor** (continuous UDP probing with a scrolling RTT and loss
39
39
  trace, to one server or to two at once for a side-by-side comparison, or a voice or video
40
40
  call's packets scored every 10 seconds), **Diag** (HTTP/1.1,
41
41
  HTTP/2 and HTTP/3, WebSocket and UDP over IPv4 and IPv6, tried once a second, with your addresses, NAT,
42
- TLS and an event log), **History** (saved runs and trend), and **API** (copy-ready
43
- examples). A site can hide any of them (`page_test`, `page_monitor`, `page_diag`,
44
- `page_history`, `page_api`). Every
42
+ TLS and an event log), **History** (saved runs and trend), **?** (what the tool does, in plain
43
+ words, for anyone), and **API** (copy-ready examples). A site can hide any of them
44
+ (`page_test`, `page_monitor`, `page_diag`, `page_history`, `page_help`, `page_api`). Every
45
45
  chart has a hover readout and a table equivalent.
46
46
 
47
47
  Visitors pick a theme from the header: Light, Dark, America, Energy, Federal, Military or
@@ -20,7 +20,7 @@ headers. Measurement endpoints add `Server-Timing` so clients can subtract serve
20
20
  | GET | `/api/v1/down?bytes=N` | Exactly N random bytes (≤ `max_download_bytes`) with `Content-Length` |
21
21
  | GET | `/api/v1/down?seconds=S` | Stream random bytes for S seconds (chunked, ≤ `max_stream_seconds`) |
22
22
  | POST | `/api/v1/up` | Read and discard the body; returns `{"bytes", "rx_ms", "mbps"}` measured server-side |
23
- | WS | `/api/v1/ws` | Echo every message unchanged |
23
+ | WS | `/api/v1/ws` | Echo every message unchanged; closed with code `4001` once `session_max_runtime` is up |
24
24
  | POST | `/api/v1/rtc/offer` | WebRTC signalling for the UDP probe (see below) |
25
25
 
26
26
  ```bash
@@ -84,7 +84,12 @@ sending the offer. The offer must include data channels:
84
84
  server sends `{"op":"limit","message":…,"url":…}` unasked and from then on echoes only
85
85
  probes of up to 64 bytes.
86
86
 
87
- Sessions close when the peer disconnects or after `rtc_session_timeout` seconds idle.
87
+ Once `session_max_runtime` is up, the server sends `{"op":"ended","reason":"runtime","seconds":…}`
88
+ unasked and closes the session a few seconds later. texas2step's pages then stop and ask
89
+ for a reload rather than open another session.
90
+
91
+ Sessions close when the peer disconnects, after `rtc_session_timeout` seconds idle, or
92
+ after `session_max_runtime` seconds in all, where it is set.
88
93
  The server answers `503` when it already holds `max_rtc_sessions` sessions, or when
89
94
  every port in its `rtc_port_min`–`rtc_port_max` range is taken.
90
95
 
@@ -92,7 +97,7 @@ every port in its `rtc_port_min`–`rtc_port_max` range is taken.
92
97
 
93
98
  | Method | Path | Returns |
94
99
  |---|---|---|
95
- | GET | `/api/v1/info` | name, version (left out for clients outside `internal_networks`), server identity, capabilities (`stamps`: the UDP probe can [stamp](#udp-probe-protocol) its echoes), limits, ICE servers, UI defaults (`one_stream`: whether a test downloads over one stream too, unless asked otherwise), `monitor` (`profile`: Monitor's until a visitor picks; `voice`, `video`: whether the Voice call and Video call profiles are offered); with a [traffic limit](traffic.md), `traffic` (below) |
100
+ | GET | `/api/v1/info` | name, version (left out for clients outside `internal_networks`), server identity, capabilities (`stamps`: the UDP probe can [stamp](#udp-probe-protocol) its echoes), limits (`max_session_seconds`: `session_max_runtime`, `0` for none), ICE servers, UI defaults (`one_stream`: whether a test downloads over one stream too, unless asked otherwise), `monitor` (`profile`: Monitor's until a visitor picks; `voice`, `video`: whether the Voice call and Video call profiles are offered); with a [traffic limit](traffic.md), `traffic` (below) |
96
101
  | GET | `/api/v1/whoami` | client IP, port, family, scheme, HTTP version, user agent |
97
102
  | GET | `/api/v1/diag/http` | both ends of this HTTP connection, its HTTP version and TLS, the server's TCP RTT and clock (below) |
98
103
  | GET | `/api/v1/locations` | servers offered in the picker (this one first) |
@@ -30,17 +30,19 @@ file up to date with the new version's template and keeps your values; see
30
30
  | `ice_servers` | `[]` | STUN/TURN URLs given to both peers, e.g. `["stun:stun.example:3478"]`. No public STUN server is used unless listed here. |
31
31
  | `max_rtc_sessions` | 32 | Concurrent UDP probe sessions per worker. Each costs the server some CPU: about 1 % of a core for Monitor's Path profile at 10 probes a second, 3 % for its Voice call and 8 % for its Video call, measured on a 2019 server CPU. |
32
32
  | `rtc_session_timeout` | 120 | Seconds of inactivity before a session is closed |
33
+ | `session_max_runtime` | 0 | Seconds any one UDP probe session or echo socket may last, however busy: 0 for no limit, else 300 or more. The server then ends it and says why, and Monitor or Diag stops and asks for a reload rather than open another. A test's own sessions last a minute or two; a long `texas2step loss` run is cut off too. Unlike the page limits below, it holds for any client, though one that ignores it can open a new session. |
33
34
  | `rtc_port_min` / `rtc_port_max` | 0 / 0 | Inclusive UDP port range for the probe's server sockets, so a firewall can open just that range. Both 0 lets the OS pick ports. See [Pinning the UDP ports](install.md#pinning-the-udp-ports). |
34
35
  | `results_enabled` | `true` | Store results and serve History. `sudo texas2step results clear` deletes those saved; see [Clear saved results](install.md#clear-saved-results). |
35
36
  | `results_path` | `texas2step.db` | SQLite file (relative to the working directory) |
36
37
  | `results_max_rows` | 10000 | Oldest results are pruned beyond this |
37
38
  | `measure_enabled` | `true` | Enable `/api/v1/measure/*` |
38
39
  | `allow_any_target` | `false` | Let `/measure/*` target any URL, not just configured locations. Leave off on shared networks: it turns the server into a request relay. |
39
- | `page_test` / `page_monitor` / `page_diag` / `page_history` / `page_api` | `true` | Show that tab of the web UI. Any can be hidden, but not all. A hidden page's address opens the first page shown. The API stays on: `results_enabled` and `measure_enabled` turn parts of it off, and `/api/docs` stays reachable without the API tab. |
40
+ | `page_test` / `page_monitor` / `page_diag` / `page_history` / `page_help` / `page_api` | `true` | Show that tab of the web UI. `page_help` is the **?** tab: what the tool does, a summary for anyone and then a section on each page shown, never naming the tool, so it reads right on a renamed site. Any can be hidden, but not all, and the ? tab alone doesn't count. A hidden page's address opens the first page shown. The API stays on: `results_enabled` and `measure_enabled` turn parts of it off, and `/api/docs` stays reachable without the API tab. |
41
+ | `page_monitor_max_runtime` / `page_diag_max_runtime` | 0 | Seconds Monitor runs from each Start, and Diag each time it's shown, before it stops: 0 for no limit, else 60 or more, as `900` or `3600`. For pages left open unattended. The page stops as it does for another page, keeps its chart and figures, says why, and starts again only once it's reloaded; a small Runtime box on it counts the seconds against the limit. Every visitor gets the limit, inside `internal_networks` too. The page keeps it, so a client that scripts the API isn't held to it; `session_max_runtime` is the server's own. |
40
42
  | `default_streams` / `default_seconds` / `default_packets` | 4 / 10 / 500 | Defaults advertised by `/api/v1/info` |
41
43
  | `monitor_profile` | `path` | Monitor's profile until a visitor picks one: `path` (small probes, to follow the path), `voice` or `video` (a call's packets, scored every 10 seconds); see [Live monitor](methodology.md#live-monitor) |
42
- | `monitor_voice` | `true` | Offer Monitor's Voice call profile, about 150 kb/s each way while a tab runs it. With `false`, the page shows no Voice call button and the server refuses the profile. |
43
- | `monitor_video` | `true` | Offer Monitor's Video call profile, about 1.4 Mb/s each way while a tab runs it. With `false`, the page shows no Video call button and the server refuses the profile. With both `false`, Monitor runs Path only, and shows no profile switch. Voice and video count toward a [traffic limit](traffic.md#monitors-call-profiles). |
44
+ | `monitor_voice` | `true` | Offer Monitor's Voice call profile, about 160 kb/s each way while a tab runs it. With `false`, the page shows no Voice call button and the server refuses the profile. |
45
+ | `monitor_video` | `true` | Offer Monitor's Video call profile, about 1.5 Mb/s each way while a tab runs it. With `false`, the page shows no Video call button and the server refuses the profile. With both `false`, Monitor runs Path only, and shows no profile switch. Voice and video count toward a [traffic limit](traffic.md#monitors-call-profiles). |
44
46
  | `default_one_stream` | `true` | Whether a test also downloads over [one stream](methodology.md#one-stream), unless the visitor chooses in Test options or the command line with `--one-stream` or `--no-one-stream`. It can add up to half again to a test's traffic, so a server whose traffic is billed may want `false`; see [Traffic limits](traffic.md#what-a-test-moves). |
45
47
  | `cors_origins` | `["*"]` | Origins allowed to call the API from a browser |
46
48
  | `trusted_proxies` | `["127.0.0.1", "::1"]` | Peers whose `X-Forwarded-For`, `X-Forwarded-Proto`, `X-Forwarded-Prefix` and `X-Client-Protocol` are believed |
@@ -280,8 +280,12 @@ the nearest one offered.
280
280
  | Profile | Sends | Each way, as the network carries it |
281
281
  |---|---|---|
282
282
  | **Path** | Small probes, 64 bytes, 5 to 50 a second (10 by default): a running record of the path's round trip, jitter and loss | about 25 kb/s at 10 a second |
283
- | **Voice call** | A voice call's packets: 200 bytes every 20 ms | about 150 kb/s |
284
- | **Video call** | The voice packets, and 30 video frames a second, each a burst of 1,100-byte packets (4 for 1 Mb/s of video) | about 1.4 Mb/s |
283
+ | **Voice call** | A voice call's packets: 200 bytes every 20 ms | about 160 kb/s |
284
+ | **Video call** | The voice packets, and 30 video frames a second, each a burst of 1,100-byte packets (4 for 1 Mb/s of video) | about 1.5 Mb/s |
285
+
286
+ The call figures, as the page states them, count each packet's headers, encryption and a
287
+ VPN's wrapping. Options change them: 0.8 Mb/s for 0.5 Mb/s of video, 3.0 Mb/s for 2.5 Mb/s.
288
+ Comparing two servers sends the same to each, so twice as much in all.
285
289
 
286
290
  Video packets are 1,100 bytes so that each travels as a single UDP packet: a browser
287
291
  splits a data-channel message much larger than that, and one lost piece would lose the
@@ -311,6 +315,13 @@ screenshot of. The window can still be changed, to look back over the last 15 mi
311
315
  The 10 seconds cut short by Stop aren't scored. Going to another page stops the monitor
312
316
  the same way, and the page says so when you come back to it.
313
317
 
318
+ **Time limits.** A site can stop Monitor a set time after each Start
319
+ (`page_monitor_max_runtime`), for pages left running unattended, and a server can end any
320
+ session after a set time (`session_max_runtime`). Either way Monitor stops as Stop does,
321
+ holds its chart and figures, says why, and starts again only once the page is reloaded.
322
+ With a site limit, a small **Runtime** box in the toolbar counts the seconds since Start
323
+ against it ("312s of 900s"); it holds at Stop, and the next Start counts from zero.
324
+
314
325
  **Outages.** A server that hasn't answered for 3 seconds has gone quiet: when Wi-Fi or
315
326
  mobile data drops while you move around, say, or when the server restarts. The line
316
327
  beside the chart's title says so. Its probes keep their places and count as lost, so
@@ -384,6 +395,12 @@ An attempt not answered within 2 s (1.5 s for WebSocket and UDP) counts as misse
384
395
  method that has answered before shows a miss as loss (red). One that hasn't answered
385
396
  yet stays grey and keeps trying. One the server turns out not to offer, such as UDP in
386
397
  a family it has no address in, is grey and isn't tried again.
398
+ A site can stop Diag a set time after it's shown (`page_diag_max_runtime`), and a server
399
+ can end its WebSocket or UDP session after a set time (`session_max_runtime`). Either way
400
+ Diag stops as it does for another page, keeps its rows and events, says why, and starts
401
+ again only once the page is reloaded. With a site limit, a small **Runtime** box beside
402
+ Keep screen on counts the seconds since Diag was last shown against it; coming back to
403
+ Diag counts from zero.
387
404
  One whose address asks for the access code, as a server's IPv4-only name can for a
388
405
  visitor inside on IPv6 only, says **Restricted** (amber) and doesn't count as loss:
389
406
  its HTTP rows are tried every 10 s until the code is in, and no WebSocket is opened there
@@ -112,6 +112,26 @@ is. Call quality, responsiveness, one stream and Monitor's call profiles came in
112
112
 
113
113
  Newest first. Each release's notes have the details and its upgrade steps.
114
114
 
115
+ ### [2.4.5](https://github.com/robert-patrick-texas/texas2step/releases/tag/v2.4.5) (2026-10-26)
116
+
117
+ - [x] **A ? tab**: what the tool does, in a one-minute summary for anyone, then more on
118
+ Test, Monitor and Diag. It never names the tool, so it reads right on a renamed site;
119
+ `page_help` hides it.
120
+ - [x] **Time limits** for pages left open: `page_monitor_max_runtime` and
121
+ `page_diag_max_runtime` stop Monitor and Diag a set time after each start, and
122
+ `session_max_runtime` has each server end any UDP or WebSocket session that old. A
123
+ stopped page keeps what it shows and starts again once reloaded; a small Runtime box
124
+ counts the time against the page's limit.
125
+ - [x] Monitor gives a call's rate as the network carries it, with headers, encryption and
126
+ a VPN's wrapping: about 160 kb/s for voice and 1.5 Mb/s for video, each way per server.
127
+ - [x] A finished test says **Saved as Result ID**, with the ID in a box that a click
128
+ copies; History's access code too.
129
+ - [x] Durations in seconds read "10s", so the unit can't wrap onto the next line.
130
+
131
+ ### [2.4.4](https://github.com/robert-patrick-texas/texas2step/releases/tag/v2.4.4) (2026-10-26)
132
+
133
+ - [x] **Download JSON** saves a result as `results-<time>.json`, on renamed sites too.
134
+
115
135
  ### [2.4.3](https://github.com/robert-patrick-texas/texas2step/releases/tag/v2.4.3) (2026-10-26)
116
136
 
117
137
  - [x] With `brand_logo` set, the logo is the browser tab's icon, in the API explorer too.
@@ -144,7 +144,9 @@ Path profile, which aren't counted, and Monitor says so with the site's message
144
144
  Until the limit opens again, a call profile is refused at its start.
145
145
  `monitor_video = false` in the settings withholds the Video call profile altogether, and
146
146
  `monitor_voice = false` the Voice call one: the page doesn't offer them, and the server
147
- refuses them. With both, Monitor runs only the uncounted Path profile.
147
+ refuses them. With both, Monitor runs only the uncounted Path profile. To bound how long
148
+ a page left open keeps sending, see `page_monitor_max_runtime`, `page_diag_max_runtime`
149
+ and `session_max_runtime` in [Configuration](configuration.md).
148
150
 
149
151
  ## What isn't counted
150
152
 
@@ -1,3 +1,3 @@
1
1
  """texas2step: web-centric throughput, latency, jitter and packet-loss measurement."""
2
2
 
3
- __version__ = "2.4.3"
3
+ __version__ = "2.4.5"
@@ -80,6 +80,8 @@ async def info(request: Request) -> dict[str, Any]:
80
80
  "max_download_bytes": s.max_download_bytes,
81
81
  "max_upload_bytes": s.max_upload_bytes,
82
82
  "max_stream_seconds": s.max_stream_seconds,
83
+ # 0: sessions run until the client closes them, or go idle.
84
+ "max_session_seconds": s.session_max_runtime,
83
85
  },
84
86
  "ice_servers": [{"urls": url} for url in s.ice_servers],
85
87
  "defaults": {
@@ -25,6 +25,10 @@ from .meta import client_address
25
25
 
26
26
  router = APIRouter(prefix="/api/v1", tags=["wire"])
27
27
 
28
+ # The echo socket's close code at session_max_runtime: the page stops rather than open
29
+ # another (docs/api.md). 4000-4999 are for applications to define.
30
+ RUNTIME_CLOSE = 4001
31
+
28
32
  NO_STORE = {"Cache-Control": "no-store, no-cache, must-revalidate, max-age=0", "Pragma": "no-cache"}
29
33
 
30
34
 
@@ -165,7 +169,8 @@ async def ws_echo(ws: WebSocket) -> None:
165
169
  ip, _ = client_address(ws)
166
170
  blocks = ws.app.state.blocks if ws.app.state.codes is not None else None
167
171
  issued = await pass_issued(ws)
168
- checked = time.monotonic()
172
+ checked = opened = time.monotonic()
173
+ limit = ws.app.state.settings.session_max_runtime
169
174
  try:
170
175
  while True:
171
176
  message = await ws.receive()
@@ -177,6 +182,9 @@ async def ws_echo(ws: WebSocket) -> None:
177
182
  return
178
183
  if message["type"] == "websocket.disconnect":
179
184
  return
185
+ if limit and time.monotonic() - opened > limit:
186
+ await ws.close(code=RUNTIME_CLOSE, reason="session_max_runtime")
187
+ return
180
188
  if message.get("bytes") is not None:
181
189
  await ws.send_bytes(message["bytes"])
182
190
  elif message.get("text") is not None:
@@ -40,7 +40,7 @@ log = logging.getLogger(__name__)
40
40
  access = logging.getLogger("texas2step.access")
41
41
 
42
42
  STATIC = Path(__file__).parent / "static"
43
- SPA_ROUTES = ("/", "/monitor", "/diag", "/history", "/api", "/r/{rid}")
43
+ SPA_ROUTES = ("/", "/monitor", "/diag", "/history", "/help", "/api", "/r/{rid}")
44
44
  PREFIX = re.compile(r"(?:/(?!\.\.?(?:/|$))[A-Za-z0-9._~-]+)+") # no "." or ".." segments
45
45
  # The first message of a response, which settles its status for RequestLog. A WebSocket
46
46
  # closed before it was accepted gets a 403 from uvicorn.
@@ -444,6 +444,7 @@ def create_app(settings: Settings | None = None) -> FastAPI:
444
444
  port_range=settings.rtc_ports,
445
445
  voice=settings.monitor_voice,
446
446
  video=settings.monitor_video,
447
+ max_runtime=settings.session_max_runtime,
447
448
  )
448
449
  app.state.rtc.meter = app.state.traffic
449
450
  app.state.rtc.blocks = app.state.blocks
@@ -25,7 +25,7 @@ from zoneinfo import ZoneInfo, ZoneInfoNotFoundError
25
25
  from .access import INTERVALS
26
26
 
27
27
  ENV_PREFIX = "TEXAS2STEP_"
28
- PAGES = ("test", "monitor", "diag", "history", "api") # the web UI's tabs, in order
28
+ PAGES = ("test", "monitor", "diag", "history", "help", "api") # the web UI's tabs, in order
29
29
  THEMES = ("system", "light", "dark", "america", "energy", "federal", "military", "texas")
30
30
  # Branding URLs end up in href attributes, so only these schemes are accepted.
31
31
  LINK_SCHEMES = ("https://", "http://", "mailto:", "tel:")
@@ -106,6 +106,9 @@ class Settings:
106
106
  max_download_bytes: int = 1 << 30
107
107
  max_upload_bytes: int = 1 << 30
108
108
  max_stream_seconds: float = 60.0
109
+ # The longest any one UDP probe session or echo socket lasts, in seconds; 0, no limit.
110
+ # The server then ends it and says why, and the page stops until it's reloaded.
111
+ session_max_runtime: int = 0
109
112
 
110
113
  # UDP probing over WebRTC data channels.
111
114
  webrtc_enabled: bool = True
@@ -132,7 +135,12 @@ class Settings:
132
135
  page_monitor: bool = True
133
136
  page_diag: bool = True
134
137
  page_history: bool = True
138
+ page_help: bool = True
135
139
  page_api: bool = True
140
+ # How long Monitor and Diag run before they stop and ask for a reload, in seconds; 0,
141
+ # no limit. Monitor's clock starts at each Start, Diag's each time it is shown.
142
+ page_monitor_max_runtime: int = 0
143
+ page_diag_max_runtime: int = 0
136
144
 
137
145
  # Defaults offered to the browser UI.
138
146
  default_streams: int = 4
@@ -243,10 +251,18 @@ class Settings:
243
251
  raise ValueError(
244
252
  f"rtc_port_min/rtc_port_max: need 1 <= min <= max <= 65535, or both 0; got {ports}"
245
253
  )
246
- if not self.pages:
254
+ if not set(self.pages) - {"help"}:
247
255
  raise ValueError(
248
256
  "page_test, page_monitor, page_diag, page_history, page_api: keep one shown"
249
257
  )
258
+ for name in ("page_monitor_max_runtime", "page_diag_max_runtime"):
259
+ if getattr(self, name) != 0 and not 60 <= getattr(self, name) <= 31_536_000:
260
+ raise ValueError(f"{name}: expected 0 (no limit) or 60 to 31536000 seconds")
261
+ # A test's own sessions last a minute or two: a shorter limit would cut them off.
262
+ if self.session_max_runtime != 0 and not 300 <= self.session_max_runtime <= 31_536_000:
263
+ raise ValueError(
264
+ "session_max_runtime: expected 0 (no limit) or 300 to 31536000 seconds"
265
+ )
250
266
  if self.default_theme not in THEMES:
251
267
  raise ValueError(f"default_theme: expected one of {', '.join(THEMES)}")
252
268
  if self.monitor_profile not in MONITOR_PROFILES:
@@ -19,6 +19,7 @@
19
19
  # max_download_bytes = 1073741824
20
20
  # max_upload_bytes = 1073741824
21
21
  # max_stream_seconds = 60.0
22
+ # session_max_runtime = 0 # seconds a UDP or WebSocket session may last; 0 = no limit
22
23
 
23
24
  # --- UDP probe (WebRTC) ----------------------------------------------------------------
24
25
  # webrtc_enabled = true
@@ -42,7 +43,10 @@ results_path = "/var/lib/texas2step/results.db"
42
43
  # page_monitor = true # the Monitor tab
43
44
  # page_diag = true # the Diag tab
44
45
  # page_history = true # the History tab
46
+ # page_help = true # the ? tab: what each page does, for anyone
45
47
  # page_api = true # the API tab
48
+ # page_monitor_max_runtime = 0 # seconds Monitor runs before it stops; 0 = no limit
49
+ # page_diag_max_runtime = 0 # seconds Diag runs before it stops; 0 = no limit
46
50
 
47
51
  # --- Defaults offered to the browser UI --------------------------------------------------
48
52
  # default_streams = 4
@@ -87,6 +87,11 @@ class Shell:
87
87
  root = ['lang="en"']
88
88
  if s.default_theme != "system":
89
89
  root.append(f'data-default-theme="{s.default_theme}"')
90
+ # How long Monitor and Diag may run, where the site limits them (ui/runtime.ts).
91
+ if s.page_monitor_max_runtime:
92
+ root.append(f'data-monitor-max="{s.page_monitor_max_runtime}"')
93
+ if s.page_diag_max_runtime:
94
+ root.append(f'data-diag-max="{s.page_diag_max_runtime}"')
90
95
  if pages != list(PAGES):
91
96
  # The tabs of hidden pages go, and the UI is told which pages it has.
92
97
  root.append(f'data-pages="{" ".join(pages)}"')
@@ -235,6 +235,7 @@ class Session:
235
235
  profile: str = "path"
236
236
  limited: bool = False # held to path probes by a traffic limit
237
237
  control: Any = None # the control channel, to tell the client of a limit reached
238
+ ending: float | None = None # when it was told session_max_runtime is up
238
239
 
239
240
  def counters(self) -> dict[str, int]:
240
241
  return {"rx": self.rx, "tx": self.tx, "rx_bytes": self.rx_bytes}
@@ -265,6 +266,7 @@ class RtcEcho:
265
266
  port_range: tuple[int, int] | None = None,
266
267
  voice: bool = True,
267
268
  video: bool = True,
269
+ max_runtime: float = 0,
268
270
  ) -> None:
269
271
  self.enabled = enabled and AVAILABLE
270
272
  self.offered = {"path": True, "voice": voice, "video": video} # monitor_voice, _video
@@ -274,6 +276,7 @@ class RtcEcho:
274
276
  self.ice_servers = ice_servers
275
277
  self.max_sessions = max_sessions
276
278
  self.timeout = timeout
279
+ self.max_runtime = max_runtime # session_max_runtime; 0, none
277
280
  self.port_range = port_range
278
281
  self.sessions: dict[str, Session] = {}
279
282
  self._reaper: asyncio.Task[None] | None = None
@@ -456,3 +459,17 @@ class RtcEcho:
456
459
  ):
457
460
  log.debug("closing rtc session %s: its pass was ended", session.id)
458
461
  await self._close(session)
462
+ elif self.max_runtime and now - session.created > self.max_runtime:
463
+ await self._end(session, now)
464
+
465
+ async def _end(self, session: Session, now: float) -> None:
466
+ """At session_max_runtime: tell the client why, so it doesn't open another session
467
+ in its place, then close it on the reaper's next round."""
468
+ if session.ending is not None:
469
+ log.debug("closing rtc session %s: session_max_runtime", session.id)
470
+ await self._close(session)
471
+ return
472
+ session.ending = now
473
+ reply = {"op": "ended", "reason": "runtime", "seconds": self.max_runtime}
474
+ with contextlib.suppress(Exception):
475
+ session.control.send(json.dumps(reply))
@@ -0,0 +1 @@
1
+ :root,[data-theme=light]{color-scheme:light;--page: #f3f2ee;--surface: #fdfdfc;--surface-2: #f6f5f1;--ink: #0e1013;--ink-2: #4a4f57;--muted: #646972;--grid: #e7e6e0;--axis: #c7c6be;--border: rgba(14, 16, 19, .08);--shadow: 0 1px 2px rgba(20, 22, 30, .04), 0 12px 32px -16px rgba(20, 22, 40, .18);--dl: #2a78d6;--ul: #eb6834;--idle: #1baf7a;--dl-from: #86b6ef;--ul-from: #f6b08e;--idle-from: #8fdcbf;--good-ink: #006300;--good: #0ca30c;--warning: #fab219;--serious: #ec835a;--critical: #d03b3b;--sun-1: #f5a524;--sun-2: #e8467c;--sun-3: #7c5cff;--brand: linear-gradient(120deg, var(--sun-1), var(--sun-2) 55%, var(--sun-3));--mark-1: var(--sun-1);--mark-2: var(--sun-2);--mark-3: var(--sun-3);--mark-star: #ffffff;--on-brand: #ffffff;--radius: 18px;--radius-sm: 10px;--radius-pill: 999px;--font: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;--font-display: var(--font);--mono: ui-monospace, "SF Mono", "Cascadia Code", "JetBrains Mono", Menlo, Consolas, monospace;--ease: cubic-bezier(.2, .7, .2, 1);--notice: #0e1013;--notice-ink: #f3f2ee;--urgent: #b83a14;--on-urgent: #ffffff}@media(prefers-color-scheme:dark){:root:not([data-theme]){color-scheme:dark;--page: #090b0f;--surface: #121419;--surface-2: #0e1015;--ink: #eef0f3;--ink-2: #b4b9c2;--muted: #8a909a;--grid: #22252c;--axis: #353943;--border: rgba(255, 255, 255, .07);--shadow: 0 1px 0 rgba(255, 255, 255, .03) inset, 0 20px 40px -24px rgba(0, 0, 0, .8);--dl: #3987e5;--ul: #d95926;--idle: #199e70;--dl-from: #1c5cab;--ul-from: #8f3612;--idle-from: #0f5e43;--good-ink: #0ca30c;--sun-1: #f5a524;--sun-2: #e8467c;--sun-3: #7c5cff;--brand: linear-gradient(120deg, var(--sun-1), var(--sun-2) 55%, var(--sun-3));--mark-1: var(--sun-1);--mark-2: var(--sun-2);--mark-3: var(--sun-3);--mark-star: #ffffff;--notice: #1b1e25;--notice-ink: #d4d8df}}[data-theme=dark]{color-scheme:dark;--page: #090b0f;--surface: #121419;--surface-2: #0e1015;--ink: #eef0f3;--ink-2: #b4b9c2;--muted: #8a909a;--grid: #22252c;--axis: #353943;--border: rgba(255, 255, 255, .07);--shadow: 0 1px 0 rgba(255, 255, 255, .03) inset, 0 20px 40px -24px rgba(0, 0, 0, .8);--dl: #3987e5;--ul: #d95926;--idle: #199e70;--dl-from: #1c5cab;--ul-from: #8f3612;--idle-from: #0f5e43;--good-ink: #0ca30c;--sun-1: #f5a524;--sun-2: #e8467c;--sun-3: #7c5cff;--brand: linear-gradient(120deg, var(--sun-1), var(--sun-2) 55%, var(--sun-3));--mark-1: var(--sun-1);--mark-2: var(--sun-2);--mark-3: var(--sun-3);--mark-star: #ffffff;--notice: #1b1e25;--notice-ink: #d4d8df}[data-theme=federal]{color-scheme:light;--page: #eef1f6;--surface: #ffffff;--surface-2: #f4f6f9;--ink: #0d132d;--ink-2: #39415a;--muted: #646d82;--grid: #dfe4ec;--axis: #b6bfcf;--border: rgba(13, 19, 45, .13);--shadow: 0 1px 2px rgba(13, 19, 45, .06), 0 10px 26px -18px rgba(13, 19, 45, .35);--dl: #2a78d6;--ul: #eb6834;--idle: #1baf7a;--dl-from: #86b6ef;--ul-from: #f6b08e;--idle-from: #8fdcbf;--good-ink: #006300;--sun-1: #2f5bd0;--sun-2: #ffbd00;--sun-3: #0d132d;--brand: linear-gradient(140deg, #2a4fb3, #141f4d 62%, #0d132d);--mark-1: #2f5bd0;--mark-2: #1a2d74;--mark-3: #0d132d;--mark-star: #ffbd00;--on-brand: #ffffff;--radius: 6px;--radius-sm: 4px;--radius-pill: 4px;--font-display: "Iowan Old Style", "Palatino Linotype", Palatino, "Book Antiqua", Georgia, Cambria, "Times New Roman", serif;--notice: #060a1a;--notice-ink: #d9dee8}[data-theme=texas]{color-scheme:dark;--page: #070b15;--surface: #0e1424;--surface-2: #0a101d;--ink: #f3f4f7;--ink-2: #bcc3d1;--muted: #8d95a8;--grid: #1d2537;--axis: #2f3a52;--border: rgba(255, 255, 255, .08);--shadow: 0 1px 0 rgba(255, 255, 255, .03) inset, 0 22px 44px -26px rgba(0, 0, 0, .9);--dl: #3987e5;--ul: #d95926;--idle: #199e70;--dl-from: #1c5cab;--ul-from: #8f3612;--idle-from: #0f5e43;--good-ink: #0ca30c;--sun-1: #bf0a30;--sun-2: #f05a28;--sun-3: #f6b73c;--brand: linear-gradient(120deg, var(--sun-1), var(--sun-2) 55%, var(--sun-3));--mark-1: #002868;--mark-2: #4b1f5c;--mark-3: #bf0a30;--mark-star: #ffffff;--on-brand: #ffffff;--radius: 12px;--radius-sm: 7px;--radius-pill: 8px;--font-display: var(--font);--notice: #0b1a3a;--notice-ink: #d2d8e4}[data-theme=america]{color-scheme:light;--page: #f2f5fa;--surface: #ffffff;--surface-2: #eef2f8;--ink: #0a1630;--ink-2: #33405c;--muted: #5f6b86;--grid: #e0e5ee;--axis: #bcc6d8;--border: rgba(10, 49, 97, .15);--shadow: 0 1px 2px rgba(10, 22, 48, .05), 0 12px 30px -18px rgba(10, 22, 48, .3);--dl: #2a78d6;--ul: #eb6834;--idle: #1baf7a;--dl-from: #86b6ef;--ul-from: #f6b08e;--idle-from: #8fdcbf;--good-ink: #006300;--sun-1: #b31942;--sun-2: #1d4c95;--sun-3: #0a3161;--brand: linear-gradient(125deg, #c8203f, #b31942 16%, #0a3161 58%, #163f80);--mark-1: #0a3161;--mark-2: #0a3161;--mark-3: #b31942;--mark-star: #ffffff;--on-brand: #ffffff;--radius: 10px;--radius-sm: 6px;--radius-pill: 6px;--font-display: var(--font);--notice: #0a3161;--notice-ink: #ffffff}[data-theme=energy]{color-scheme:dark;--page: #04080f;--surface: #0a121f;--surface-2: #070d18;--ink: #eaf2fa;--ink-2: #aabdd0;--muted: #8195aa;--grid: #18243a;--axis: #2b3c58;--border: rgba(122, 200, 255, .11);--shadow: 0 1px 0 rgba(255, 255, 255, .03) inset, 0 22px 44px -26px rgba(0, 0, 0, .9);--dl: #3987e5;--ul: #d95926;--idle: #199e70;--dl-from: #1c5cab;--ul-from: #8f3612;--idle-from: #0f5e43;--good-ink: #0ca30c;--sun-1: #1fd2ff;--sun-2: #1fb8ff;--sun-3: #8f5cff;--brand: linear-gradient(120deg, #0fb5e6, #1f5fe0 50%, #7440f0);--mark-1: #1fd2ff;--mark-2: #1f5fe0;--mark-3: #7440f0;--mark-star: #ffffff;--on-brand: #ffffff;--radius: 8px;--radius-sm: 5px;--radius-pill: 6px;--font-display: var(--font);--notice: #06213a;--notice-ink: #c4e9ff}[data-theme=military]{color-scheme:light;--page: #e9e5d6;--surface: #faf8f1;--surface-2: #f2efe3;--ink: #1b1f14;--ink-2: #454a38;--muted: #5a5e4a;--grid: #d9d4c1;--axis: #b6b09a;--border: rgba(40, 45, 25, .16);--shadow: 0 1px 2px rgba(30, 34, 20, .07), 0 10px 26px -18px rgba(30, 34, 20, .4);--dl: #2a78d6;--ul: #eb6834;--idle: #1baf7a;--dl-from: #86b6ef;--ul-from: #f6b08e;--idle-from: #8fdcbf;--good-ink: #006300;--sun-1: #b09656;--sun-2: #56652b;--sun-3: #262c1b;--brand: linear-gradient(135deg, #6f7d3c, #4b5320 50%, #2c3320);--mark-1: #7d8c47;--mark-2: #4b5320;--mark-3: #2c3320;--mark-star: #ece3c4;--on-brand: #ffffff;--radius: 4px;--radius-sm: 3px;--radius-pill: 3px;--font-display: "DIN Condensed", Bahnschrift, "Ubuntu Condensed", "Roboto Condensed", "Arial Narrow", "DejaVu Sans Condensed", var(--font);--notice: #262c1b;--notice-ink: #ebe5cf}*{box-sizing:border-box}html{-webkit-text-size-adjust:100%}body{zoom:var(--ui-zoom, 1);margin:0;min-height:100vh;background:var(--page);color:var(--ink);font:15px/1.5 var(--font);-webkit-font-smoothing:antialiased;display:flex;flex-direction:column}a{color:inherit}h1,h2,h3{margin:0;letter-spacing:-.015em;font-family:var(--font-display)}button{font:inherit;color:inherit}:focus-visible{outline:2px solid var(--dl);outline-offset:2px;border-radius:6px}.backdrop{position:fixed;inset:0;z-index:-1;pointer-events:none;background:radial-gradient(60vw 42vw at 8% -12%,color-mix(in srgb,var(--sun-1) 16%,transparent),transparent 70%),radial-gradient(50vw 36vw at 62% -18%,color-mix(in srgb,var(--sun-2) 11%,transparent),transparent 70%),radial-gradient(46vw 40vw at 100% -6%,color-mix(in srgb,var(--sun-3) 12%,transparent),transparent 70%),var(--page)}.backdrop:after{content:"";position:absolute;inset:0;opacity:.05;background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='160' height='160'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='.8' numOctaves='3' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)'/%3E%3C/svg%3E")}.topbar{position:sticky;top:0;z-index:10;display:flex;align-items:center;gap:10px 24px;padding:12px max(16px,calc((100vw - 1240px)/2));-webkit-backdrop-filter:saturate(1.4) blur(14px);backdrop-filter:saturate(1.4) blur(14px);background:color-mix(in srgb,var(--page) 72%,transparent);border-bottom:1px solid var(--border)}.brand{display:flex;align-items:center;gap:10px;text-decoration:none;font-weight:650;font-size:18px;letter-spacing:-.02em}.brand-mark{width:30px;height:30px;filter:drop-shadow(0 4px 10px color-mix(in srgb,var(--sun-2) 35%,transparent))}.brand-word em{font-style:normal;background:var(--brand);-webkit-background-clip:text;background-clip:text;color:transparent;padding:0 1px}.tabs{display:flex;gap:4px}.tabs a{position:relative;padding:8px 12px;border-radius:var(--radius-pill);text-decoration:none;color:var(--ink-2);font-weight:550;font-size:14px;transition:color .2s,background .2s}.tabs a:hover{color:var(--ink);background:color-mix(in srgb,var(--ink) 5%,transparent)}.tabs a[aria-current]{color:var(--ink);background:var(--surface);box-shadow:0 0 0 1px var(--border),0 4px 12px -6px #0003}.topbar-actions{margin-left:auto;display:flex;align-items:center;gap:10px}.picker{display:flex;align-items:center;gap:8px;padding:6px 12px;border-radius:var(--radius-pill);background:var(--surface);box-shadow:0 0 0 1px var(--border);font-size:13px;max-width:320px}.picker-status{width:8px;height:8px;border-radius:50%;background:var(--good);box-shadow:0 0 0 3px color-mix(in srgb,var(--good) 22%,transparent);flex:none}.picker-status.down{background:var(--critical);box-shadow:0 0 0 3px color-mix(in srgb,var(--critical) 22%,transparent)}.picker-status.code{background:var(--warning);box-shadow:0 0 0 3px color-mix(in srgb,var(--warning) 22%,transparent)}.picker-name{font-weight:600;white-space:nowrap}.picker-loc{color:var(--muted);white-space:nowrap}.picker-select{border:0;background:transparent;color:var(--ink);font:inherit;font-weight:600;max-width:260px;cursor:pointer}.picker-select option{background:var(--surface);color:var(--ink)}.icon-btn{width:36px;height:36px;display:grid;place-items:center;border:0;border-radius:50%;background:var(--surface);box-shadow:0 0 0 1px var(--border);cursor:pointer}.icon-btn svg{width:18px;height:18px;fill:none;stroke:currentColor;stroke-width:1.8;stroke-linecap:round}.icon-btn svg path{fill:currentColor;fill-opacity:.12}.icon-btn svg circle{fill:currentColor;stroke:none}#view{width:100%;max-width:1240px;margin:0 auto;padding:20px 16px 36px;flex:1;outline:none}.footer{display:flex;flex-wrap:wrap;gap:8px;justify-content:center;padding:24px 16px 32px;color:var(--muted);font-size:13px}.footer a{color:var(--ink-2)}.own-footer{flex:0 0 100%}.own-footer-body{max-width:1208px;margin:0 auto 12px;padding:20px 0 22px;border-top:1px solid var(--border);border-bottom:1px solid var(--border);display:grid;grid-template-columns:minmax(0,1fr) auto;gap:14px 56px;text-align:left;line-height:1.6}.own-footer-body.solo{grid-template-columns:minmax(0,1fr);justify-items:center;text-align:center}.own-footer-text p{max-width:80ch;margin:0 0 8px}.own-footer-text p:last-child{margin-bottom:0}.own-footer-links ul{display:grid;gap:6px;margin:0;padding:0;list-style:none}@media(max-width:640px){.own-footer-body{grid-template-columns:minmax(0,1fr)}}.bm-1{stop-color:var(--mark-1)}.bm-2{stop-color:var(--mark-2)}.bm-3{stop-color:var(--mark-3)}.bm-star{fill:var(--mark-star)}img.brand-mark{width:auto;max-width:180px;object-fit:contain;filter:none}.brand-org{margin-left:-10px;padding-left:14px;border-left:1px solid var(--border);color:var(--ink-2);font-size:13px;font-weight:550;white-space:nowrap;text-decoration:none}a.brand-org:hover,.topbar-links a:hover{color:var(--ink);text-decoration:underline;text-underline-offset:3px}.topbar-links{display:flex;gap:16px;font-size:13px;font-weight:550}.topbar-links a{color:var(--ink-2);text-decoration:none;white-space:nowrap}.notice{padding:7px max(16px,calc((100vw - 1240px)/2));background:var(--notice);color:var(--notice-ink);font-size:13px;line-height:1.45;text-align:center}.theme-menu{position:relative}.size-picker,.family-picker{padding:6px 6px 6px 12px}.picker-glyph{color:var(--muted);font-size:12px;font-weight:700;letter-spacing:-.02em}.theme-pop{position:absolute;top:calc(100% + 8px);right:0;z-index:30;min-width:228px;padding:6px;background:var(--surface);color:var(--ink);border-radius:var(--radius-sm);box-shadow:0 0 0 1px var(--border),0 22px 44px -18px #00000073}.theme-pop[hidden]{display:none}.theme-pop-title{padding:6px 10px;color:var(--muted);font-size:11px;font-weight:650;letter-spacing:.08em;text-transform:uppercase}.theme-item{display:flex;align-items:center;gap:12px;width:100%;padding:7px 10px;border:0;border-radius:calc(var(--radius-sm) - 2px);background:none;font-size:14px;text-align:left;cursor:pointer}.theme-item:hover,.theme-item:focus-visible{background:color-mix(in srgb,var(--ink) 7%,transparent);outline:none}.theme-item[aria-checked=true]{font-weight:650}.theme-check{width:16px;height:16px;margin-left:auto;fill:none;stroke:currentColor;stroke-width:2.2;stroke-linecap:round;stroke-linejoin:round;opacity:0}.theme-item[aria-checked=true] .theme-check{opacity:1}.theme-swatch{position:relative;flex:none;width:36px;height:24px;border-radius:5px;background:var(--page);box-shadow:0 0 0 1px color-mix(in srgb,var(--ink) 18%,transparent);overflow:hidden}.theme-swatch:before{content:"";position:absolute;top:4px;left:4px;width:15px;height:8px;border-radius:2px;background:var(--surface);box-shadow:0 0 0 1px var(--border)}.theme-swatch:after{content:"";position:absolute;right:4px;bottom:4px;left:4px;height:5px;border-radius:3px;background:var(--brand)}.theme-swatch.split{display:grid;grid-template-columns:1fr 1fr}.theme-swatch.split:before,.theme-swatch.split:after{display:none}.theme-swatch.split>span{background:var(--page)}[data-theme=federal] .topbar{--surface: #182046;--ink: #ffffff;--ink-2: #c9d0e0;--muted: #9ba4bc;--border: rgba(255, 255, 255, .16);color-scheme:dark;background:#0d132d;color:var(--ink);border-bottom:3px solid var(--sun-2);-webkit-backdrop-filter:none;backdrop-filter:none}[data-theme=federal] .tabs a[aria-current]{background:transparent;box-shadow:inset 0 -2px 0 var(--sun-2)}[data-theme=federal] .brand-word em{background:none;color:var(--sun-2)}[data-theme=federal] .backdrop{background:linear-gradient(180deg,#dde3ee,var(--page) 520px)}[data-theme=texas] .topbar:after,[data-theme=energy] .topbar:after{content:"";position:absolute;right:0;left:0;pointer-events:none}[data-theme=texas] .topbar:after{bottom:-1px;height:2px;background:linear-gradient(90deg,#002868 0 33.3%,#fff 33.3% 66.6%,#bf0a30 66.6%)}[data-theme=texas] .tabs a[aria-current],[data-theme=america] .tabs a[aria-current],[data-theme=energy] .tabs a[aria-current]{box-shadow:0 0 0 1px var(--border),inset 0 -2px 0 var(--sun-1)}[data-theme=texas] .backdrop{background:radial-gradient(80vw 40vw at 88% -14%,rgba(0,40,104,.6),transparent 70%),radial-gradient(100vw 32vw at 50% 118%,color-mix(in srgb,var(--sun-2) 22%,transparent),transparent 72%),radial-gradient(60vw 26vw at 8% 112%,color-mix(in srgb,var(--sun-1) 20%,transparent),transparent 70%),var(--page)}[data-theme=america] .topbar{--ink-2: var(--ink);background:linear-gradient(105deg,color-mix(in srgb,#5b85c9 90%,transparent),color-mix(in srgb,#a6bde3 90%,transparent))}[data-theme=america] body:before{--edge: clamp(6px, (100vw - 1240px) / 2 - 10px, 12px);content:"";position:fixed;inset:0;z-index:30;pointer-events:none;background:linear-gradient(#0a3161,#0a3161) top / 100% 4px no-repeat,linear-gradient(#8f1435,#8f1435) left / var(--edge) 100% no-repeat,linear-gradient(#8f1435,#8f1435) right / var(--edge) 100% no-repeat}[data-theme=america] .backdrop{background:radial-gradient(55vw 34vw at 0% -12%,color-mix(in srgb,#0a3161 18%,transparent),transparent 70%),radial-gradient(55vw 34vw at 100% -12%,color-mix(in srgb,#1d4c95 12%,transparent),transparent 70%),var(--page)}[data-theme=america] .backdrop:before{content:"";position:absolute;inset:0;background:radial-gradient(circle,color-mix(in srgb,#0a3161 34%,transparent) 1.2px,transparent 1.8px) 0 0 / 24px 24px;-webkit-mask-image:radial-gradient(58vw 32vw at 0% 0%,#000,transparent 72%);mask-image:radial-gradient(58vw 32vw at 0% 0%,#000,transparent 72%)}[data-theme=energy] .topbar{background:color-mix(in srgb,#02050b 80%,transparent)}[data-theme=energy] .topbar:after{bottom:-1px;height:1px;background:linear-gradient(90deg,transparent,var(--sun-1) 25%,var(--sun-3) 75%,transparent);box-shadow:0 0 10px 1px color-mix(in srgb,var(--sun-1) 45%,transparent)}[data-theme=energy] .backdrop{background:radial-gradient(70vw 36vw at 30% -16%,color-mix(in srgb,var(--sun-1) 13%,transparent),transparent 70%),radial-gradient(56vw 34vw at 100% 112%,color-mix(in srgb,var(--sun-3) 15%,transparent),transparent 70%),var(--page)}[data-theme=energy] .backdrop:before{content:"";position:absolute;inset:0;background:linear-gradient(color-mix(in srgb,var(--sun-1) 9%,transparent) 1px,transparent 1px) 0 0 / 36px 36px,linear-gradient(90deg,color-mix(in srgb,var(--sun-1) 9%,transparent) 1px,transparent 1px) 0 0 / 36px 36px;-webkit-mask-image:radial-gradient(90vw 46vw at 30% 0%,#000,transparent 75%);mask-image:radial-gradient(90vw 46vw at 30% 0%,#000,transparent 75%)}[data-theme=military] .topbar{--surface: #353c26;--ink: #f3efe0;--ink-2: #d2ccb4;--muted: #a9a68c;--border: rgba(243, 239, 224, .16);color-scheme:dark;background:#232918;color:var(--ink);border-bottom:3px solid var(--sun-1);-webkit-backdrop-filter:none;backdrop-filter:none}[data-theme=military] .tabs a{font-size:13px;letter-spacing:.08em;text-transform:uppercase}[data-theme=military] .tabs a[aria-current]{background:transparent;box-shadow:inset 0 -2px 0 var(--sun-1)}[data-theme=military] .brand-word em{background:none;color:var(--sun-1)}[data-theme=military] :is(h1,h2,h3){font-stretch:condensed;letter-spacing:.01em;text-transform:uppercase}[data-theme=military] .backdrop{background:radial-gradient(64vw 40vw at 0% -10%,color-mix(in srgb,var(--sun-2) 16%,transparent),transparent 70%),var(--page)}[data-theme=military] .backdrop:before{content:"";position:absolute;inset:0;opacity:.12;background:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='720' height='720'%3E%3Cfilter id='t' x='0' y='0' width='100%25' height='100%25'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='.004' numOctaves='2' seed='4' stitchTiles='stitch'/%3E%3CfeColorMatrix values='0 0 0 0 .29 0 0 0 0 .33 0 0 0 0 .13 2.2 0 0 0 -0.6'/%3E%3CfeComponentTransfer%3E%3CfeFuncA type='table' tableValues='0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0'/%3E%3C/feComponentTransfer%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23t)'/%3E%3C/svg%3E") 0 0 / 720px 720px}.card{background:var(--surface);border-radius:var(--radius);box-shadow:0 0 0 1px var(--border),var(--shadow);padding:18px 20px}.banner{display:flex;flex-wrap:wrap;gap:12px;align-items:center;justify-content:space-between;margin-bottom:20px;padding:12px 16px;border-radius:var(--radius-sm);background:color-mix(in srgb,var(--dl) 9%,var(--surface));box-shadow:0 0 0 1px color-mix(in srgb,var(--dl) 25%,transparent);font-size:14px}.banner[hidden]{display:none}.hero{display:grid;grid-template-columns:minmax(280px,400px) 1fr;gap:32px;align-items:center;margin-bottom:18px}.hero-head h1{font-size:clamp(24px,3vw,34px);line-height:1.12;font-weight:680;letter-spacing:-.03em;max-width:18em}.status{margin:10px 0 0;color:var(--ink-2);min-height:1.5em}.code-chip{position:relative;padding:1px 7px;border-radius:6px;background:color-mix(in srgb,var(--sun-1) 22%,var(--surface));box-shadow:inset 0 0 0 1px color-mix(in srgb,var(--sun-1) 60%,transparent);color:var(--ink);font-family:var(--mono);font-weight:700;letter-spacing:.03em;white-space:nowrap;-webkit-user-select:all;user-select:all;cursor:copy}.code-chip:hover{background:color-mix(in srgb,var(--sun-1) 34%,var(--surface))}.code-copied{position:absolute;bottom:calc(100% + 5px);left:50%;translate:-50% 0;padding:2px 8px;border-radius:6px;background:var(--notice);color:var(--notice-ink);font-family:var(--font);font-size:12px;font-weight:600;letter-spacing:0;pointer-events:none;-webkit-user-select:none;user-select:none;animation:code-copied 1.2s var(--ease) both}@keyframes code-copied{0%{opacity:0;translate:-50% 3px}15%,75%{opacity:1;translate:-50% 0}to{opacity:0}}@media(prefers-reduced-motion:reduce){.code-copied{animation:none}}.gauge{position:relative;width:100%;max-width:400px;aspect-ratio:1;margin:0 auto;--level: 0}.gauge-svg{width:100%;height:100%;overflow:visible}.gauge-ring{fill:none;stroke:var(--border)}.gauge-ring.ring-1{fill:color-mix(in srgb,var(--surface) 70%,transparent);stroke:var(--border)}.gauge-ring.ring-2{stroke-dasharray:2 6;stroke:var(--axis);opacity:.5;transform-origin:200px 200px}.gauge-ring.ring-3{stroke:var(--grid)}.gauge.running .ring-2{animation:spin 24s linear infinite;opacity:.9}.gauge-track{fill:none;stroke:var(--grid);stroke-width:14;stroke-linecap:round}.gauge-value{fill:none;stroke:url(#g-latency);stroke-width:14;stroke-linecap:round}.gauge-glow{fill:none;stroke:url(#g-latency);stroke-width:26;stroke-linecap:round;filter:url(#g-blur);opacity:calc(.25 + var(--level) * .55)}.gauge[data-tone=download] :is(.gauge-value,.gauge-glow){stroke:url(#g-download)}.gauge[data-tone=upload] :is(.gauge-value,.gauge-glow){stroke:url(#g-upload)}.gauge-tip{fill:var(--surface);stroke:var(--idle);stroke-width:3;opacity:0;transition:opacity .3s}.gauge[data-tone=download] .gauge-tip{stroke:var(--dl);opacity:1}.gauge[data-tone=upload] .gauge-tip{stroke:var(--ul);opacity:1}.gauge-ticks line{stroke:var(--axis);stroke-linecap:round}.gauge-ticks line.major{stroke:var(--muted);stroke-width:1.5}.gauge-label{fill:var(--muted);font-size:12px;font-weight:600;text-anchor:middle;dominant-baseline:middle}.gauge-readout{position:absolute;inset:30% 18% 26%;display:flex;flex-direction:column;align-items:center;justify-content:center;text-align:center;opacity:0;transform:scale(.96);transition:opacity .35s var(--ease),transform .35s var(--ease);pointer-events:none}.gauge.running .gauge-readout{opacity:1;transform:none}.gauge-caption{color:var(--ink-2);font-size:13px;font-weight:600;letter-spacing:.02em}.gauge-number{font-size:clamp(44px,7vw,68px);font-weight:650;letter-spacing:-.04em;line-height:1.05}.gauge-unit{color:var(--muted);font-size:14px;font-weight:600}.start-btn{position:absolute;left:50%;top:50%;width:46%;aspect-ratio:1;translate:-50% -50%;border:0;border-radius:50%;cursor:pointer;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:2px;color:var(--on-brand);background:var(--brand);box-shadow:0 18px 50px -12px color-mix(in srgb,var(--sun-2) 55%,transparent),inset 0 1px #ffffff59;transition:transform .25s var(--ease),opacity .3s,box-shadow .25s}.start-btn:before{content:"";position:absolute;inset:-10px;border-radius:50%;border:2px solid color-mix(in srgb,var(--sun-2) 45%,transparent);animation:pulse 2.6s var(--ease) infinite}.start-btn:hover{transform:scale(1.03)}.start-btn:active{transform:scale(.98)}.start-label{font-size:clamp(26px,4vw,34px);font-weight:700;letter-spacing:-.02em}.start-sub{font-size:12px;font-weight:550;opacity:.85}.gauge.running .start-btn{top:79%;width:54px;font-size:0;background:var(--surface);color:var(--ink-2);box-shadow:0 0 0 1px var(--border),var(--shadow)}.gauge.running .start-btn:before{display:none}.gauge.running .start-btn:after{content:"";width:14px;height:14px;border-radius:3px;background:currentColor}.gauge.running .start-label,.gauge.running .start-sub{display:none}@keyframes pulse{0%{transform:scale(.94);opacity:.9}70%,to{transform:scale(1.18);opacity:0}}@keyframes spin{to{transform:rotate(360deg)}}.rail{list-style:none;margin:22px 0 18px;padding:0;display:grid;grid-template-columns:repeat(5,1fr);gap:8px}.rail-step{position:relative;display:grid;grid-template-columns:auto 1fr;grid-template-rows:auto auto;column-gap:8px;padding:10px 12px;border-radius:12px;background:color-mix(in srgb,var(--surface) 70%,transparent);box-shadow:0 0 0 1px var(--border);overflow:hidden}.rail-dot{grid-row:span 2;align-self:center;width:10px;height:10px;border-radius:50%;background:var(--grid);box-shadow:0 0 0 3px transparent;transition:background .3s,box-shadow .3s}.rail-name{font-size:13px;font-weight:600}.rail-value{font-size:12px;color:var(--ink-2);min-height:1.4em;white-space:nowrap}.rail-step[data-state=active] .rail-dot{background:var(--sun-2);box-shadow:0 0 0 4px color-mix(in srgb,var(--sun-2) 25%,transparent);animation:blink 1.2s ease-in-out infinite}.rail-step[data-state=active]:after{content:"";position:absolute;left:0;right:0;bottom:0;height:2px;background:var(--brand);animation:sweep 1.6s linear infinite;transform-origin:left}.rail-step[data-state=done] .rail-dot{position:relative;background:none}.rail-step[data-state=done] .rail-dot:after{content:"";position:absolute;left:3px;top:-1px;width:4px;height:9px;border:solid var(--good);border-width:0 2px 2px 0;transform:rotate(45deg)}.rail-step[data-state=skipped]{opacity:.5}@keyframes blink{50%{opacity:.45}}@keyframes sweep{0%{transform:scaleX(0)}to{transform:scaleX(1)}}.hero-set{min-width:0;margin:14px 0 0;padding:2px 10px 10px;border:1px solid var(--border);border-radius:var(--radius)}.hero-set+.hero-set{margin-top:10px}.hero-set legend{padding:0 6px;color:var(--muted);font-size:11.5px;font-weight:650;letter-spacing:.06em;text-transform:uppercase}.hero-set .rail{margin:0}.tiles{display:grid;grid-template-columns:repeat(3,1fr);gap:10px}.tiles.six{grid-template-columns:repeat(6,1fr);margin-bottom:20px}.tiles[hidden]{display:none}.tile{padding:11px 15px;border-radius:14px;background:var(--surface);box-shadow:0 0 0 1px var(--border),var(--shadow);min-width:0}.tile-label{display:flex;align-items:center;gap:7px;color:var(--ink-2);font-size:13px;font-weight:550}.tile-figure{display:flex;align-items:baseline;gap:6px;margin-top:4px}.tile-value{font-size:clamp(24px,2.6vw,32px);font-weight:650;letter-spacing:-.03em;line-height:1.1;white-space:nowrap}.tile.compact .tile-value{font-size:22px}.tile-count{align-self:center;color:var(--muted);font-size:14px;font-weight:650;font-variant-numeric:tabular-nums;white-space:nowrap}.tile.compact .tile-figure{flex-wrap:wrap;row-gap:0}.tile-count.bad{color:var(--critical)}.tile-unit{color:var(--muted);font-size:13px;font-weight:600}.tile-sub{margin-top:4px;color:var(--muted);font-size:12px;min-height:1.5em;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.grade{display:inline-flex;align-items:center;padding:0 7px;border-radius:var(--radius-pill);font-weight:650;color:var(--ink);background:color-mix(in srgb,var(--good) 18%,transparent);box-shadow:inset 0 0 0 1px color-mix(in srgb,var(--good) 45%,transparent)}.grade[data-grade=B]{background:color-mix(in srgb,var(--warning) 22%,transparent);box-shadow:inset 0 0 0 1px color-mix(in srgb,var(--warning) 55%,transparent)}.grade[data-grade=C],.grade[data-grade=D]{background:color-mix(in srgb,var(--serious) 22%,transparent);box-shadow:inset 0 0 0 1px color-mix(in srgb,var(--serious) 55%,transparent)}.grade[data-grade=F]{background:color-mix(in srgb,var(--critical) 20%,transparent);box-shadow:inset 0 0 0 1px color-mix(in srgb,var(--critical) 55%,transparent)}.grade[data-rating=fair]{background:color-mix(in srgb,var(--warning) 22%,transparent);box-shadow:inset 0 0 0 1px color-mix(in srgb,var(--warning) 55%,transparent)}.grade[data-rating=poor]{background:color-mix(in srgb,var(--serious) 22%,transparent);box-shadow:inset 0 0 0 1px color-mix(in srgb,var(--serious) 55%,transparent)}.grade[data-rating=bad]{background:color-mix(in srgb,var(--critical) 20%,transparent);box-shadow:inset 0 0 0 1px color-mix(in srgb,var(--critical) 55%,transparent)}.options{margin-top:14px}.options summary{cursor:pointer;color:var(--ink-2);font-size:13px;font-weight:600;width:fit-content;list-style:none;display:flex;align-items:center;gap:6px}.options summary::-webkit-details-marker{display:none}.options summary:before{content:"";width:7px;height:7px;border-right:1.6px solid currentColor;border-bottom:1.6px solid currentColor;transform:rotate(-45deg);transition:transform .2s}.options[open] summary:before{transform:rotate(45deg)}.opt-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:12px 20px;margin-top:12px}.opt{display:flex;flex-direction:column;gap:6px}.opt-label{font-size:12px;color:var(--muted);font-weight:600}.seg{display:inline-flex;padding:3px;border-radius:10px;background:color-mix(in srgb,var(--ink) 5%,transparent);width:fit-content;flex-wrap:wrap}.seg button{border:0;background:transparent;padding:5px 11px;border-radius:7px;font-size:13px;font-weight:550;color:var(--ink-2);cursor:pointer}.seg button[aria-checked=true]{background:var(--surface);color:var(--ink);box-shadow:0 0 0 1px var(--border),0 2px 6px -2px #0003}.link{display:grid;grid-template-columns:minmax(120px,300px) 1fr minmax(120px,300px);align-items:center;gap:16px;padding:18px 22px;margin-bottom:24px}.node{min-width:0}.node-server{text-align:right}.node-icon{width:40px;height:40px;display:grid;place-items:center;border-radius:12px;background:var(--surface-2);box-shadow:0 0 0 1px var(--border);color:var(--ink-2);margin-bottom:8px}.node-server .node-icon{margin-left:auto}.node-icon svg{width:22px;height:22px}.node-title{font-weight:650;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.node-detail{color:var(--muted);font-size:12.5px;font-family:var(--mono);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.link-wire{position:relative;height:96px}.link-canvas{width:100%;height:100%;display:block}.lane-label{position:absolute;font-size:11px;color:var(--muted);left:50%;translate:-50% 0;white-space:nowrap}.lane-down{top:2px}.lane-up{bottom:2px}.link-center{position:absolute;inset:0;display:grid;place-items:center;font-weight:650;font-size:14px;pointer-events:none;text-shadow:0 0 12px var(--surface),0 0 4px var(--surface)}.grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:20px}.span-2{grid-column:span 2}.card-head{margin-bottom:10px}.card-head h2{font-size:17px;font-weight:650}.card-head p{margin:4px 0 0;color:var(--muted);font-size:13px;max-width:70ch}.chart-plot{width:100%;min-height:60px}.chart-svg{display:block;overflow:visible;font-family:var(--font)}.chart-svg .grid{stroke:var(--grid);stroke-width:1;shape-rendering:crispEdges}.chart-svg .baseline{stroke:var(--axis);stroke-width:1;shape-rendering:crispEdges}.chart-svg .tick{fill:var(--muted);font-size:11px;font-variant-numeric:tabular-nums}.chart-svg .row-label{fill:var(--ink-2);font-size:12.5px;font-weight:550}.chart-svg .direct-label,.chart-svg .bar-label{fill:var(--ink);font-size:12px;font-weight:600;paint-order:stroke;stroke:var(--surface);stroke-width:3px;stroke-linejoin:round}.chart-svg .bar-label{fill:var(--ink-2);font-weight:550}.chart-svg .annot,.chart-svg .empty{fill:var(--muted);font-size:12px}.chart-svg .warmup{fill:color-mix(in srgb,var(--ink) 3.5%,transparent)}.chart-svg .area{opacity:.1}.chart-svg .line{fill:none;stroke-width:2;stroke-linejoin:round;stroke-linecap:round}.chart-svg .line.dashed{stroke-dasharray:5 4}.chart-svg .ref{stroke-width:1;opacity:.75}.chart-svg .dot{stroke:var(--surface);stroke-width:2}.chart-svg .iqr{opacity:.14}.chart-svg .median{stroke-width:2.5;stroke-linecap:round}.chart-svg .placeholder{stroke:var(--grid);stroke-dasharray:none}.chart-svg .crosshair{stroke:var(--axis);stroke-width:1}.chart-svg .hit{fill:transparent}.chart-svg .bar:hover{filter:brightness(1.12)}.legend{display:flex;flex-wrap:wrap;gap:4px 16px;margin-bottom:10px;font-size:12.5px;color:var(--ink-2)}.legend-item{display:inline-flex;align-items:center;gap:6px}.legend-key{display:inline-block;flex:none;background:var(--key)}.legend-key.line{width:14px;height:2.5px;border-radius:2px}.legend-key.dash{width:14px;height:2.5px;background:repeating-linear-gradient(90deg,var(--key) 0 4px,transparent 4px 7px)}.legend-key.square{width:10px;height:10px;border-radius:3px}.legend-key.dot{width:8px;height:8px;border-radius:50%}.fairness{display:flex;flex-wrap:wrap;gap:6px 18px;margin-top:10px;font-size:12.5px;color:var(--ink-2)}.fair-item{display:inline-flex;align-items:center;gap:6px}.fair-item strong{color:var(--ink)}.packet-body{display:grid;grid-template-columns:minmax(0,1fr);gap:16px}.packet-canvas{display:block;max-width:100%}.packet-scale{display:flex;flex-wrap:wrap;align-items:center;gap:6px;margin-top:10px;font-size:12px;color:var(--ink-2)}.scale-bar{width:90px;height:8px;border-radius:4px}.scale-gap{width:10px}.stats-list{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:2px 18px;margin:0;font-size:13px}.stats-list dt{color:var(--muted);grid-column:1}.stats-list dd{margin:0;grid-column:2;font-weight:600;font-variant-numeric:tabular-nums}.chart-note{margin:10px 0 0;color:var(--ink-2);font-size:12.5px}.chart-note[hidden]{display:none}.stats-list .note{grid-column:1 / -1;margin:8px 0 0;color:var(--ink-2);font-size:12.5px}.readiness{list-style:none;margin:0;padding:0;display:grid;gap:8px}.ready-row{display:grid;grid-template-columns:auto 1fr auto;gap:12px;align-items:center;padding:10px 12px;border-radius:12px;background:var(--surface-2);box-shadow:0 0 0 1px var(--border)}.ready-text{display:flex;flex-direction:column;min-width:0}.ready-text strong{font-size:14px}.ready-text span{color:var(--muted);font-size:12.5px}.glyph{width:22px;height:22px;fill:none;stroke:currentColor;stroke-width:1.7;stroke-linecap:round;stroke-linejoin:round}.glyph.use{color:var(--ink-2)}.glyph.lvl{width:14px;height:14px;stroke-width:2.6}.level{display:inline-flex;align-items:center;gap:5px;padding:3px 10px 3px 7px;border-radius:var(--radius-pill);font-size:12.5px;font-weight:650;--tone: var(--muted);background:color-mix(in srgb,var(--tone) 16%,transparent);box-shadow:inset 0 0 0 1px color-mix(in srgb,var(--tone) 45%,transparent)}.level .glyph{color:var(--tone)}.level[data-level=great],.level[data-level=good]{--tone: var(--good)}.level[data-level=fair]{--tone: var(--warning)}.level[data-level=poor]{--tone: var(--critical)}.empty-note{color:var(--muted);font-size:13px}.table{width:100%;border-collapse:collapse;font-size:13.5px}.table th,.table td{padding:9px 10px;text-align:left;border-bottom:1px solid var(--grid);vertical-align:top}.table tbody th{width:190px;color:var(--ink-2);font-weight:550}.details .table td{overflow-wrap:anywhere}.table.data thead th{color:var(--muted);font-size:12px;font-weight:600}.table .num{text-align:right;font-variant-numeric:tabular-nums;white-space:nowrap}.table .mono{font-family:var(--mono);font-size:12.5px}.table .cell-sub{display:block;color:var(--muted)}.table .when{white-space:nowrap}.table .addr{overflow-wrap:anywhere}.table tbody tr:hover td{background:color-mix(in srgb,var(--ink) 2.5%,transparent)}.table-wrap{overflow-x:auto}.actions{display:flex;flex-wrap:wrap;gap:8px;margin-top:16px}.btn{display:inline-flex;align-items:center;gap:6px;padding:8px 14px;border:0;border-radius:10px;background:var(--surface);box-shadow:0 0 0 1px var(--border),0 2px 6px -3px #0003;font-size:13.5px;font-weight:600;text-decoration:none;cursor:pointer;white-space:nowrap}.btn:hover{background:var(--surface-2)}.btn.primary{color:var(--on-brand);background:var(--brand);box-shadow:0 6px 18px -8px color-mix(in srgb,var(--sun-2) 70%,transparent)}.btn.big{padding:11px 20px;font-size:15px}.btn.small{padding:5px 10px;font-size:13px}.btn.urgent{color:var(--on-urgent);background:var(--urgent);box-shadow:inset 0 1px #fff3,0 0 0 1px color-mix(in srgb,var(--urgent) 65%,#000),0 2px 6px -3px #00000059}.btn.urgent:hover{background:color-mix(in srgb,var(--urgent) 86%,#000)}.btn.small.urgent{padding-top:3px;padding-bottom:3px}.btn:disabled{opacity:.6;cursor:progress}.page-head{display:flex;flex-wrap:wrap;gap:16px;align-items:flex-end;justify-content:space-between;margin-bottom:16px}.page-head h1{font-size:clamp(24px,2.6vw,30px);font-weight:680;letter-spacing:-.03em}.lede{margin:4px 0 0;color:var(--ink-2);max-width:88ch}.monitor-notice,.diag-notice{margin:6px 0 0;max-width:88ch;color:var(--ink);font-weight:550}.monitor-notice[hidden],.diag-notice[hidden]{display:none}.runtime{display:inline-flex;align-items:center;padding:8px 11px;border-radius:10px;background:color-mix(in srgb,var(--ink) 5%,transparent);font-size:13px;color:var(--muted);font-variant-numeric:tabular-nums;white-space:nowrap;width:fit-content}.runtime-ran{margin-right:.3em;color:var(--ink-2);font-weight:600}.head-actions{display:flex;gap:10px;align-items:center;flex-wrap:wrap}.chip{padding:5px 10px;border-radius:var(--radius-pill);font-size:12.5px;font-weight:600;color:var(--ink-2);background:var(--surface);box-shadow:0 0 0 1px var(--border)}.toolbar{display:flex;flex-wrap:wrap;gap:12px 28px;margin-bottom:14px}.live-canvas,.loss-strip{display:block;width:100%}.strip-label{display:flex;align-items:center;gap:6px;margin:10px 0 4px 46px;font-size:12px;color:var(--muted)}.dest-box{display:contents}.options.monitor-sizes{align-self:flex-end;margin:0 0 9px}.options.monitor-sizes[open]{flex-basis:100%;margin-bottom:0}.seg.seg-feature{background:color-mix(in srgb,var(--sun-2) 10%,transparent);box-shadow:0 0 0 1.5px color-mix(in srgb,var(--sun-2) 55%,transparent)}.seg.seg-feature.invite{animation:invite 1.6s var(--ease) .6s 2}@keyframes invite{50%{box-shadow:0 0 0 1.5px color-mix(in srgb,var(--sun-2) 55%,transparent),0 0 0 7px color-mix(in srgb,var(--sun-2) 18%,transparent)}}.seg-dots{display:inline-flex;gap:3px;margin-left:6px;vertical-align:1px}.servers-opt .opt-label{color:var(--ink-2);font-weight:650}.card-head.head-inline{display:flex;flex-wrap:wrap;align-items:baseline;gap:2px 14px}.card-head.head-inline p{margin:0}.card-head.head-inline .chip{margin-left:auto;align-self:center}.loss-strip+.loss-strip{margin-top:4px}.visually-hidden{position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%);white-space:nowrap}.gated .tabs{display:none}.gated .server-picker,.gated #family-picker{visibility:hidden}.gate{display:grid;place-items:center;padding:clamp(16px,8vh,72px) 0}.gate-card{width:min(100%,460px);padding:26px 28px}.gate-card :is(h1,h2){font-size:clamp(22px,2.4vw,26px);font-weight:680;letter-spacing:-.02em}.code-dialog{width:min(100% - 32px,460px);max-width:none;padding:0;border:0;background:transparent;color:var(--ink);overflow:visible}.code-dialog .gate-card{width:100%}.code-dialog::backdrop{background:color-mix(in srgb,var(--page) 55%,transparent);-webkit-backdrop-filter:blur(3px);backdrop-filter:blur(3px)}.gate-later{display:flex;justify-content:flex-end;margin-top:12px}.gate-form{display:flex;gap:10px;margin-top:18px}.gate-form .btn{justify-content:center}.code-input{flex:1;min-width:0;padding:10px 14px;border:0;border-radius:10px;background:var(--surface-2);box-shadow:inset 0 0 0 1px var(--border);color:var(--ink);font:inherit;font-size:17px;letter-spacing:.02em}.code-input:focus{outline:2px solid var(--dl);outline-offset:1px}.code-input.small{flex:none;width:9.5em;padding:5px 10px;font-size:13.5px}.gate-error{min-height:1.4em;margin:10px 0 0;color:var(--ul);font-weight:600}.gate-note{margin:2px 0 0;color:var(--muted);font-size:13.5px}.result-id{align-self:center;margin:0;color:var(--ink-2)}.desk-tools{display:flex;flex-wrap:wrap;gap:8px 18px;align-items:center}.desk-code{margin:0;color:var(--ink-2)}.desk-open{display:flex;gap:6px}@media(max-width:600px){.gate-card{padding:20px 18px}.gate-form{flex-direction:column}}.diag-card{margin-bottom:20px}.diag-addresses{display:grid;gap:6px}.diag-you{display:flex;flex-wrap:wrap;gap:4px 40px}.diag-addr{display:flex;align-items:baseline;gap:10px;min-width:0}.diag-fam{color:var(--muted);font-size:13px;font-weight:600;white-space:nowrap}.diag-ip{font-family:var(--mono);font-size:clamp(16px,calc((100vw - 170px) / 24),26px);font-weight:650;overflow-wrap:anywhere}.diag-ip.none{font-family:var(--font);font-size:15px;font-weight:500;color:var(--muted)}.diag-clock{color:var(--ink-2);font-size:13px}.lede.wide,.card-head p.chart-status{max-width:none;color:var(--ink);font-weight:550}.card-head p.wide{max-width:none}.diag-rows{--diag-cols: 150px minmax(120px, 1fr) minmax(240px, 1.5fr) minmax(150px, 300px)}.diag-cols{display:grid;grid-template-columns:var(--diag-cols);gap:14px;padding:0 2px 6px;border-bottom:1px solid var(--grid);color:var(--muted);font-size:12px;font-weight:600}.diag-group{display:flex;flex-wrap:wrap;align-items:baseline;gap:2px 14px;margin-top:12px;padding:6px 10px;border-radius:var(--radius-sm);background:var(--surface-2)}.diag-group h3{margin:0;font-size:15px;font-weight:650}.diag-group-server{color:var(--ink-2);font-family:var(--mono);font-size:13px;overflow-wrap:anywhere}.diag-row{display:grid;grid-template-columns:var(--diag-cols);align-items:center;gap:14px;padding:7px 2px;border-bottom:1px solid var(--grid)}.diag-row:last-child{border-bottom:0}.diag-row[data-tone=off]{opacity:.65}.diag-what{display:flex;flex-wrap:wrap;align-items:baseline;gap:0 8px}.diag-what strong{font-weight:650}.diag-port{color:var(--muted);font-family:var(--mono);font-size:12px}.lane,.diag-timeline{display:block;width:100%}.diag-badge{margin-right:8px;font-size:13.5px;font-weight:650;color:var(--muted)}.diag-row[data-tone=up] .diag-badge{color:var(--good-ink)}.diag-row[data-tone=loss] .diag-badge{color:var(--critical)}.diag-row[data-tone=code] .diag-badge{color:var(--ink)}.diag-row[data-tone=code] .diag-badge:before{content:"";display:inline-block;width:7px;height:7px;margin-right:6px;border-radius:50%;background:var(--warning);vertical-align:1px}.diag-code{margin-left:8px;padding:1px 8px;font-size:12px;line-height:1.4;vertical-align:0}.diag-code[hidden]{display:none}.diag-figs{color:var(--ink-2);font-size:12.5px;font-variant-numeric:tabular-nums}.diag-detail{color:var(--ink-2);font-size:12px;overflow-wrap:anywhere}.diag-detail .diag-warn{color:var(--ink);font-weight:600}.diag-note{margin:12px 0 0;color:var(--ink-2);font-size:12.5px}.egress{display:grid;gap:14px}.egress-fam h3{margin:0 0 4px;font-size:14px;font-weight:650}.egress-fam dl{display:grid;grid-template-columns:auto 1fr;gap:3px 16px;margin:0;font-size:13px}.egress-fam dt{color:var(--muted)}.egress-fam dd{margin:0;overflow-wrap:anywhere}.egress-note{display:block;color:var(--muted);font-size:12px}.diag-log-head{justify-content:space-between}.diag-log{max-height:260px;margin:0;padding:0;overflow:auto;list-style:none;font-size:12.5px}.diag-log li{display:flex;gap:10px;padding:3px 0;border-bottom:1px solid var(--grid)}.diag-log time{color:var(--muted);font-family:var(--mono);font-variant-numeric:tabular-nums}.diag-log .none{color:var(--muted)}@media(max-width:980px){.diag-row{grid-template-columns:1fr 1.6fr}.diag-cols{display:none}.diag-row .lane,.diag-timeline{grid-column:1 / -1}}@media(max-width:600px){.diag-row{grid-template-columns:1fr;gap:6px}.diag-addr{flex-direction:column;align-items:flex-start;gap:0}.diag-ip.v6:not(.none){font-size:clamp(11px,calc((100vw - 72px) / 24),18px)}.diag-ip.v4:not(.none){font-size:clamp(18px,calc((100vw - 72px) / 11),24px)}}.opt-label .legend-key{vertical-align:1px}.dest-select{max-width:260px;padding:6px 10px;border:0;border-radius:10px;background:color-mix(in srgb,var(--ink) 5%,transparent);color:var(--ink);font:inherit;font-size:13px;font-weight:550;cursor:pointer}.dest-select option{background:var(--surface);color:var(--ink)}.dest-select:disabled,.seg button:disabled{cursor:default;opacity:.6}.compare-wrap{margin-bottom:12px}.table.compare th,.table.compare td{padding:3px 10px}.table.compare thead th{padding-bottom:6px}.table.compare thead th{vertical-align:bottom;font-size:13px;font-weight:650}.table.compare thead th:last-child{color:var(--muted);font-weight:600}.table.compare tbody td{font-size:14px;font-weight:600}.table.compare tbody td:last-child{color:var(--ink-2);font-weight:550}.table.compare td.bad{color:var(--critical)}.compare-name{display:inline-flex;align-items:center;gap:6px}.compare-sub{margin-left:8px;color:var(--muted);font-size:12px;font-weight:500}.empty-card{display:flex;flex-direction:column;align-items:center;gap:12px;padding:48px;color:var(--ink-2)}.chart-card+.card,.card+.card{margin-top:0}.page>.card,.page>div>.card{margin-bottom:20px}.help-summary h2,.help-card h2,.help-more{font-size:19px;font-weight:650}.help-summary>p{margin:8px 0 0;font-size:16px}.help-topics{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:14px;margin:16px 0}.help-topic{display:flex;flex-direction:column;gap:4px;padding:14px 16px;border-radius:var(--radius-sm);background:color-mix(in srgb,var(--ink) 3%,var(--surface));box-shadow:0 0 0 1px var(--border)}.help-topic h3{font-size:17px}.help-topic h3 a{text-decoration:none}.help-topic h3 a:hover{text-decoration:underline}.help-topic p{margin:0;color:var(--ink-2)}.help-topic p.help-question{color:var(--ink);font-weight:600}.help-topic .btn{align-self:flex-start;margin-top:auto}.help-topic p:last-of-type{margin-bottom:10px}.help-more{margin:28px 0 12px}.help-card p,.help-card ol,.help-card ul{margin:10px 0 0;color:var(--ink-2)}.help-card ol,.help-card ul{padding-left:22px}.help-card li+li{margin-top:4px}.help-card strong{color:var(--ink);font-weight:600}.help-card h3{margin-top:18px;font-size:15px}.help-words{display:grid;grid-template-columns:max-content minmax(0,1fr);gap:6px 16px;margin:12px 0 0}.help-words dt{font-weight:600}.help-words dd{margin:0;color:var(--ink-2)}@media(max-width:600px){.help-words{grid-template-columns:minmax(0,1fr);gap:0}.help-words dd{margin-bottom:8px}}.cli-card{margin-bottom:28px}.cli-card h2,.api-group h2{font-size:19px;font-weight:650}.cli-card p{color:var(--ink-2);margin:6px 0 14px}.api-group{margin-bottom:32px}.api-list{display:grid;grid-template-columns:repeat(auto-fill,minmax(340px,1fr));gap:14px;margin-top:14px}.api-item{display:flex;flex-direction:column;gap:6px;padding:18px}.api-item h3{font-size:15px}.api-item p{margin:0 0 6px;color:var(--ink-2);font-size:13.5px;flex:1}.api-sig{display:flex;align-items:center;gap:8px;font-family:var(--mono);font-size:13px;min-width:0}.api-sig code{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.method{padding:2px 7px;border-radius:6px;font-size:11px;font-weight:700;letter-spacing:.04em;color:var(--ink);background:color-mix(in srgb,var(--idle) 22%,transparent)}.method.m-post{background:color-mix(in srgb,var(--ul) 22%,transparent)}.method.m-ws{background:color-mix(in srgb,var(--dl) 22%,transparent)}.code{position:relative;border-radius:10px;background:var(--surface-2);box-shadow:inset 0 0 0 1px var(--border)}.code pre{margin:0;padding:12px 64px 12px 14px;overflow-x:auto;font:12.5px/1.6 var(--mono);color:var(--ink-2)}.api-item .code pre{white-space:pre-wrap;word-break:break-all}.code .copy{position:absolute;top:8px;right:8px;border:0;padding:3px 8px;border-radius:6px;font-size:12px;background:var(--surface);box-shadow:0 0 0 1px var(--border);cursor:pointer}.tooltip{position:fixed;left:0;top:0;z-index:50;pointer-events:none;min-width:140px;padding:8px 10px;border-radius:10px;background:color-mix(in srgb,var(--surface) 94%,transparent);-webkit-backdrop-filter:blur(8px);backdrop-filter:blur(8px);box-shadow:0 0 0 1px var(--border),0 12px 28px -10px #00000059;font-size:12.5px}.tooltip[hidden]{display:none}.tip-title{color:var(--muted);font-size:11.5px;margin-bottom:4px}.tip-row{display:flex;align-items:center;gap:7px;white-space:nowrap}.tip-row strong{font-variant-numeric:tabular-nums}.tip-row span:last-child{color:var(--ink-2)}.tip-key{flex:none;background:var(--key)}.tip-key.line{width:12px;height:2.5px;border-radius:2px}.tip-key.dot{width:8px;height:8px;border-radius:50%}.tip-key.square{width:9px;height:9px;border-radius:2px}.tip-key.none{width:0}.noscript{text-align:center;padding:40px}@media(max-width:980px){.hero{grid-template-columns:1fr;gap:16px}.hero-gauge{max-width:400px;width:100%;margin:0 auto}.tiles.six{grid-template-columns:repeat(3,1fr)}.tile[data-key=mos] .tile-count,.tile[data-key=worst] .tile-count{flex-basis:100%}}@media(max-width:1180px){.topbar-links{display:none}}.topbar.wrapped{flex-wrap:wrap}@media(max-width:600px){#size-picker{display:none}.table.compare th,.table.compare td{padding:5px 6px;font-size:13px}.table.compare thead th{white-space:normal}.compare-sub{display:none}.table .addr{display:inline-block;width:20ch}.details .table,.details .table tbody,.details .table tr{display:block}.details .table tr{padding:8px 0;border-bottom:1px solid var(--grid)}.details .table th,.details .table td{display:block;width:auto;padding:0;border:0}}@media(max-width:760px){.topbar{flex-wrap:wrap;gap:10px 16px}.brand-org{display:none}.tabs{order:3;width:100%;overflow-x:auto}.topbar-actions{flex:1 1 0;min-width:0;justify-content:flex-end}#server-picker,#server-picker .picker,#server-picker .picker>*{min-width:0}#server-picker .picker-name,#server-picker .picker-select{overflow:hidden;text-overflow:ellipsis}.family-picker .picker-select{field-sizing:content}.grid{grid-template-columns:minmax(0,1fr)}.span-2{grid-column:auto}.tiles,.rail{grid-template-columns:repeat(2,1fr)}.hero-set{margin-top:22px;padding:0;border:0}.hero-set+.hero-set{margin-top:18px}.hero-set legend{position:absolute;width:1px;height:1px;padding:0;overflow:hidden;clip-path:inset(50%);white-space:nowrap}.link{grid-template-columns:1fr 1fr;padding:16px}.link-wire{grid-column:1 / -1;grid-row:2}.node-detail{white-space:normal;overflow-wrap:anywhere}.card{padding:16px}.picker-loc{display:none}.table tbody th{width:auto}.stats-list{grid-template-columns:auto 1fr}}@media(max-width:420px){.tiles.six{grid-template-columns:repeat(2,1fr)}.picker{max-width:180px}.picker-select{max-width:130px}.topbar:has(#family-picker .picker) .brand-word{display:none}}@media(prefers-reduced-motion:reduce){*,*:before,*:after{animation:none!important;transition:none!important}}@media(forced-colors:active){.gauge-value,.chart-svg .line{stroke:CanvasText}}