| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647 |
- """Which runtime record describes a profile the host multiplexer may serve.
- One rule for ``/api/status`` and the messaging card so the two surfaces never pick different records
- for the same profile. Read-only: it selects and projects existing ``gateway_state.json`` records and
- writes nothing. ``gateway.status`` is resolved at call time so its test seams
- (``monkeypatch.setattr(gateway.status, ...)``) still intercept.
- """
- from __future__ import annotations
- from pathlib import Path
- from typing import Any, Optional
- def local_liveness_pid(liveness: Any) -> Optional[int]:
- """``liveness.pid`` when it was proven on THIS host; None for a health-probe answer, whose PID
- belongs to the remote container and may collide with an unrelated local one."""
- return None if liveness.source == "health" else liveness.pid
- def served_profile_runtime(
- home: Path, own_runtime: Optional[dict[str, Any]], *, gateway_pid: Optional[int] = None
- ) -> Optional[dict[str, Any]]:
- """The multiplexer's record projected onto ``home``'s profile (bare platform keys, the shape a
- standalone gateway writes) when it is that profile's live runtime record, else None.
- - ``own_runtime`` wins whenever it proves a live gateway of ``home`` -- an own ``--force`` one, or
- the host's own record on the host itself, which must stay whole so other profiles'
- ``<profile>:<platform>`` failures remain visible there;
- - a missing/unreadable multiplexer record (``(pid, {})``) is no record;
- - ``gateway_pid`` (a PID the caller proved on this host) must BE the multiplexer, so a gateway of
- the profile's own holding its lock keeps its record.
- """
- from gateway import status
- if own_runtime is not None and status.get_runtime_status_running_pid(own_runtime, expected_home=home) is not None:
- return None
- served = status.multiplexer_liveness_for_profile(home)
- if served is None or not served[1]:
- return None
- mux_pid, record = served
- if gateway_pid is not None and mux_pid != gateway_pid:
- return None
- # Fold on the profile NAME, never ``home.name``: the default root's basename is ``.hermes`` (or
- # any custom HERMES_HOME), so its flat keys never matched (#123088).
- name = status.profile_name_for_home(home) or "default"
- return {**record, "platforms": status.profile_platforms_from_multiplexer(record, name)}
|