status_report.py 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120
  1. """The one field set behind ``/status`` on every surface.
  2. The CLI (``cli_session_mixin._show_session_status``), the messaging gateway
  3. (``gateway/slash_commands_status._handle_status_command``) and the TUI backend
  4. (``tui_gateway/methods_session`` ``session.status``) all report the same session facts —
  5. id, home path, title, model route, created / last-activity stamps, lifetime tokens, running
  6. flag. Each used to derive them independently (three ``getattr(agent, "model")`` fallback
  7. chains, three ``updated_at`` candidate scans, three timestamp formats to keep aligned).
  8. They now all call :func:`build_status_fields`; a surface only adds its own header, labels
  9. (the gateway translates through ``t("gateway.status.*")``) and surface-specific extras.
  10. """
  11. from __future__ import annotations
  12. from datetime import datetime
  13. from pathlib import Path
  14. from typing import Any
  15. STATUS_STAMP = "%Y-%m-%d %H:%M"
  16. UNKNOWN_MODEL = "(unknown)"
  17. UNKNOWN_PROVIDER = "unknown"
  18. # Newest-first: a row carries at most one of these, depending on which writer last touched it.
  19. _LAST_ACTIVITY_FIELDS = ("updated_at", "last_updated_at", "last_activity_at")
  20. # English labels shared by the CLI and TUI renderers (the gateway has its own i18n catalog).
  21. STATUS_LABELS = {
  22. "session_id": "Session ID",
  23. "path": "Path",
  24. "title": "Title",
  25. "model": "Model",
  26. "created": "Created",
  27. "last_activity": "Last Activity",
  28. "tokens": "Tokens",
  29. "agent_running": "Agent Running",
  30. }
  31. def timestamp_or(value: Any, default: datetime | None) -> datetime | None:
  32. """``datetime.fromtimestamp(value)`` or *default* when the value is missing/unparseable."""
  33. if not value:
  34. return default
  35. try:
  36. return datetime.fromtimestamp(float(value))
  37. except (TypeError, ValueError, OverflowError, OSError):
  38. return default
  39. def session_timestamps(meta: dict, created_fallback: datetime | None = None) -> tuple[datetime, datetime]:
  40. """``(created, last_activity)`` from a SessionDB row; last activity falls back to created."""
  41. created = timestamp_or(meta.get("started_at"), created_fallback) or datetime.now()
  42. updated = next(
  43. (stamp for stamp in (timestamp_or(meta.get(f), None) for f in _LAST_ACTIVITY_FIELDS) if stamp),
  44. created,
  45. )
  46. return created, updated
  47. def build_status_fields(
  48. session_id: str,
  49. agent: Any,
  50. meta: dict | None,
  51. *,
  52. title: str | None = None,
  53. model: str | None = None,
  54. provider: str | None = None,
  55. created: datetime | None = None,
  56. last_activity: datetime | None = None,
  57. created_fallback: datetime | None = None,
  58. tokens: int | None = None,
  59. agent_running: bool = False,
  60. home: str | Path | None = None,
  61. ) -> dict[str, Any]:
  62. """Common ``/status`` facts, pre-formatted for display.
  63. ``agent`` wins for model / provider / tokens; the keyword values are the surface's fallback
  64. (CLI ``self.model``, TUI metadata mirror, gateway's resolved route) and are also what a
  65. surface passes when it has no live agent. ``created`` / ``last_activity`` override the
  66. ``meta`` row scan for surfaces whose session store is authoritative (gateway SessionEntry).
  67. ``home`` is an explicit owning-profile path for multiplexed surfaces; omitted callers keep
  68. the process/current-profile lookup.
  69. """
  70. from hermes_constants import display_hermes_home
  71. meta = meta or {}
  72. if created is None or last_activity is None:
  73. row_created, row_updated = session_timestamps(meta, created_fallback)
  74. created = created or row_created
  75. last_activity = last_activity or row_updated
  76. if tokens is None:
  77. tokens = getattr(agent, "session_total_tokens", 0) or 0
  78. row_title = meta.get("title") if title is None else title
  79. return {
  80. "session_id": str(session_id or ""),
  81. "path": display_hermes_home(Path(home) if home else None),
  82. "title": (row_title or "").strip(),
  83. "model": getattr(agent, "model", None) or model or "",
  84. "provider": getattr(agent, "provider", None) or provider or "",
  85. "created": created.strftime(STATUS_STAMP),
  86. "last_activity": last_activity.strftime(STATUS_STAMP),
  87. "tokens": f"{int(tokens or 0):,}",
  88. "agent_running": bool(agent_running),
  89. }
  90. def status_lines(fields: dict[str, Any], *keys: str) -> list[str]:
  91. """``Label: value`` lines for *keys* in order (English surfaces). An empty title is skipped;
  92. an unresolved model/provider shows a placeholder rather than an empty parenthesis."""
  93. lines: list[str] = []
  94. for key in keys:
  95. value = fields[key]
  96. if key == "title" and not value:
  97. continue
  98. if key == "model":
  99. value = f"{fields['model'] or UNKNOWN_MODEL} ({fields['provider'] or UNKNOWN_PROVIDER})"
  100. elif key == "agent_running":
  101. value = "Yes" if value else "No"
  102. lines.append(f"{STATUS_LABELS[key]}: {value}")
  103. return lines