98745df3b9
Fence accepted RPCs, side agents, continuations, delegation and cron before issuing process-bound retirement permits. Co-authored-by: chelsealong <chelsealong@126.com> Co-authored-by: Mark Sheppard <mark@orchardstreetpress.com>
58 lines
2.3 KiB
Python
58 lines
2.3 KiB
Python
"""Diagnostic work snapshot for a Desktop-pooled ``hermes serve`` child.
|
|
|
|
Reads process admission, session/worker, delegation, cron and human-input ledgers. Unreadable
|
|
state is indeterminate, never idle. This snapshot alone is NOT permission to retire: only
|
|
``backend_retirement.RetirementFence.prepare`` freezes admission before taking the snapshot,
|
|
and only a confirmed commit permits the client to stop that exact backend generation.
|
|
The separate messaging gateway process owns its own lifecycle and drain protocol.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
from typing import Callable, Optional
|
|
|
|
from hermes_cli.web_server_idle_exit import turn_in_flight
|
|
|
|
_log = logging.getLogger(__name__)
|
|
|
|
_input_probe_failure_logged = False
|
|
|
|
|
|
def pending_human_input() -> Optional[int]:
|
|
"""Count of prompts waiting on a human (clarify/approval/sudo/secret requests plus queued
|
|
gateway approvals); ``None`` when a ledger cannot be read."""
|
|
global _input_probe_failure_logged
|
|
try:
|
|
from tui_gateway import server_requests
|
|
from tools.approval import pending_gateway_approval_count
|
|
|
|
return server_requests.open_request_count() + pending_gateway_approval_count()
|
|
except Exception:
|
|
if not _input_probe_failure_logged:
|
|
_input_probe_failure_logged = True
|
|
_log.warning("idle-proof input probe unavailable; this backend will report indeterminate",
|
|
exc_info=True)
|
|
return None
|
|
|
|
|
|
def idle_proof(turn_probe: Callable[[], Optional[bool]] = turn_in_flight,
|
|
input_probe: Callable[[], Optional[int]] = pending_human_input) -> dict:
|
|
"""``{"idle": True | False | None, "reason": str | None}``.
|
|
|
|
``True`` only when no turn is in flight (session table AND cron ledger) and nothing is waiting
|
|
on a human. ``None`` whenever either probe is indeterminate — the caller treats it exactly like
|
|
busy.
|
|
"""
|
|
turn = turn_probe()
|
|
if turn is None:
|
|
return {"idle": None, "reason": "turn_probe_unavailable"}
|
|
if turn:
|
|
return {"idle": False, "reason": "turn_in_flight"}
|
|
pending = input_probe()
|
|
if pending is None:
|
|
return {"idle": None, "reason": "input_probe_unavailable"}
|
|
if pending:
|
|
return {"idle": False, "reason": "awaiting_human_input"}
|
|
return {"idle": True, "reason": None}
|