mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-07-29 18:46:59 +00:00
cfb206fe2e
Three mechanisms to detect and notify when gateway sessions stall silently: 1. Mid-turn activity heartbeats stamped to SessionDB so hermes sessions list and hermes status show progress during long turns without new message rows. 2. Stall watchdog: when a busy session has pending inbound and the shared activity clock is idle past agent.session_stall_timeout (default 300), log a WARNING and notify the user once to try /new. Notify-only; does not kill the turn. 3. Compaction timeout: fenceless compress_context callers get a progress-aware host budget (compression.context_timeout_seconds default 120 idle, compression.context_total_ceiling_seconds default 600 ceiling). On timeout, cancel via commit fence, skip compaction without dropping messages, and continue the turn. Closes #72016 (slices 1-3; slice 4 cumulative SSE stream-retry deadline remains a follow-up). Cherry-picked from PR #72424 by @fangliquanflq.
82 lines
3 KiB
Python
82 lines
3 KiB
Python
"""Shared session activity observation contract (#72016 / #72039).
|
|
|
|
Observation-only: timestamp + bounded description/provenance.
|
|
Notification, timeout, kill, and retry policy stay in their own components.
|
|
Consumers distinguish work (API / tool / compacting / stalled) from the
|
|
description text itself — there is no separate phase enum.
|
|
|
|
Provenance is a small closed enum of *noun* sources (where the stamp came
|
|
from). The default agent activity clock (``_touch_activity``) stamps
|
|
``unknown`` unless a caller passes an explicit ``provenance=``; named
|
|
values are for special writers.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from enum import Enum
|
|
from typing import Any, Mapping, Optional
|
|
|
|
ACTIVITY_DESCRIPTION_MAX = 120
|
|
|
|
|
|
class ActivityProvenance(str, Enum):
|
|
"""Where a durable/in-memory activity stamp came from."""
|
|
|
|
UNKNOWN = "unknown"
|
|
# Compression writers (#72424 / activity contract): heartbeat, host timeout, cooldown.
|
|
AGENT_COMPRESSION = "agent.compression"
|
|
AGENT_COMPRESSION_TIMEOUT = "agent.compression_timeout"
|
|
AGENT_COMPRESSION_COOLDOWN = "agent.compression_cooldown"
|
|
|
|
|
|
def bound_activity_description(description: Optional[str]) -> str:
|
|
"""Clamp free-form activity text to the shared description budget."""
|
|
text = (description or "").strip()
|
|
if len(text) <= ACTIVITY_DESCRIPTION_MAX:
|
|
return text
|
|
return text[: ACTIVITY_DESCRIPTION_MAX - 1] + "…"
|
|
|
|
|
|
def normalize_activity_provenance(
|
|
provenance: Optional[ActivityProvenance | str],
|
|
) -> ActivityProvenance:
|
|
"""Return a known provenance, or ``UNKNOWN`` when unset/unrecognized."""
|
|
if isinstance(provenance, ActivityProvenance):
|
|
return provenance
|
|
value = (provenance or "").strip()
|
|
try:
|
|
return ActivityProvenance(value)
|
|
except ValueError:
|
|
return ActivityProvenance.UNKNOWN
|
|
|
|
|
|
def build_activity_snapshot(
|
|
*,
|
|
last_activity_at: Optional[float],
|
|
last_activity_description: Optional[str],
|
|
last_activity_provenance: Optional[ActivityProvenance | str] = None,
|
|
now: Optional[float] = None,
|
|
extra: Optional[Mapping[str, Any]] = None,
|
|
) -> dict[str, Any]:
|
|
"""Build the shared activity snapshot (plus optional caller extras)."""
|
|
import time as _time
|
|
|
|
when = float(last_activity_at) if last_activity_at is not None else None
|
|
clock = float(now if now is not None else _time.time())
|
|
desc = bound_activity_description(last_activity_description)
|
|
prov = normalize_activity_provenance(last_activity_provenance)
|
|
elapsed = round(clock - when, 1) if when is not None else None
|
|
snap: dict[str, Any] = {
|
|
"last_activity_at": when,
|
|
"last_activity_description": desc,
|
|
"last_activity_provenance": prov.value,
|
|
"seconds_since_activity": elapsed,
|
|
# Short aliases used by existing gateway/delegate readers.
|
|
"last_activity_ts": when,
|
|
"last_activity_desc": desc,
|
|
"description": desc,
|
|
"provenance": prov.value,
|
|
}
|
|
if extra:
|
|
snap.update(dict(extra))
|
|
return snap
|