feat(gateway): compact status card by leoge007 · Pull Request #37476 · NousResearch/hermes-agent

leoge007 · 2026-06-02T15:35:49Z

Summary

Adds a compact gateway /status card formatter.
Updates gateway /status to show version/SHA, gateway + system uptime, model/fallbacks, token/cost/cache/context metrics, session id, active tasks, and queue mode/depth.
Keeps noisy debug fields out of the Telegram-facing status card (Execution, Runtime, Platforms).

Example output

🪽 Hermes 0.15.1 (c6501c0)
⏱️ Uptime: gateway 2m · system 1d 5h
🧠 Model: azure-foundry/gpt-5.5-1
🔄 Fallbacks: deepseek/deepseek-v4-pro, deepseek/deepseek-v4-flash
🧮 Tokens: 64k in / 3k out · 💵 Cost: $0.12
🗄️ Cache: 22% hit · 14k read, 0 write
📚 Context: 64k/1.0m (6%) · 🧹 Compactions: 0
🧵 Session: 20260602_xxx
📌 Tasks: 0 active
🪢 Queue: steer (depth 0)

This is intentionally concise for messaging surfaces: it gives operators the quick runtime health snapshot without turning /status into a full debug dump.

Test Plan

./venv/bin/python -m pytest tests/gateway/test_status_card.py tests/gateway/test_unknown_command.py -q -n 0 --tb=short
./venv/bin/python - <<'PY'\nimport importlib\nfor name in ['gateway.status_card','gateway.run']:\n importlib.import_module(name)\nprint('imports ok')\nPY

leoge007 · 2026-06-03T10:59:24Z

Local verification after rebasing this PR onto current main (047e7cf):

PR diff is still limited to gateway/run.py, gateway/status_card.py, and tests/gateway/test_status_card.py.
./venv/bin/python -m pytest tests/gateway/test_status_card.py tests/gateway/test_unknown_command.py -q -n 0 --tb=short -> 15 passed.
scripts/run_tests_parallel.py tests/gateway/test_status_card.py -j 1 -> 4 passed.
./venv/bin/ruff check . -> passed.
scripts/check-windows-footguns.py --all -> passed.
Import smoke test for gateway.status_card and gateway.run -> passed.
History/contributor/supply-chain equivalent checks are clean locally.

GitHub Actions are not failing at runtime; every PR workflow is currently completed with conclusion action_required at 0s, so an upstream maintainer/admin needs to approve and run workflows for this fork PR.

Integrates PR NousResearch#37476 (gateway-status-card) into our feishu-table-card branch. Adds format_hermes_status_card() for compact status display with: - Version, git commit, gateway/system uptime - Model, fallbacks, tokens, cache hit rate - Context usage, compactions, active tasks, queue depth

teknium1

Thanks for the focused gateway status-card proposal. The feature remains useful, but it needs a current-main port and a few corrections before salvage.

Problems

Current /status now lives in gateway/slash_commands.py:496; it uses the async session facade at gateway/slash_commands.py:501 after 9d38a2309ece. The PR's synchronous self.session_store.get_or_create_session() at gateway/run.py:10399 must not be carried forward.
gateway/run.py:1314 invokes ps, while gateway/run.py:1327-1347 has no Windows path. Existing cross-platform gateway status helpers use psutil fallback behavior in gateway/status.py:147-210.
gateway/run.py:10457 reads a non-persisted compression_count session field. Current main obtains this from the live context compressor at gateway/slash_commands.py:4040-4041.
Current Matrix scope status at gateway/slash_commands.py:648-663 needs preservation in any compact replacement.

Suggested changes

Port the card into GatewaySlashCommandsMixin, preserve async storage access, use cross-platform uptime collection, and add nonzero-compression plus Windows tests.

Automated hermes-sweeper review.

teknium1 · 2026-07-13T22:08:20Z

@@ -10299,63 +10398,70 @@ async def _handle_status_command(self, event: MessageEvent) -> str:
        source = event.source
        session_entry = self.session_store.get_or_create_session(source)


Current main moved /status into GatewaySlashCommandsMixin and uses await self.async_session_store.get_or_create_session(source) after the async SessionStore-boundary fix (9d38a2309ece). Please port this handler through that facade rather than retaining synchronous SessionStore access.

Addressed in c327980. The /status implementation now lives in GatewaySlashCommandsMixin and retains await self.async_session_store.get_or_create_session(source); no synchronous SessionStore access was reintroduced.

teknium1 · 2026-07-13T22:08:20Z

+            "cache_write_tokens": cache_write_tokens,
+            "context_tokens": context_tokens,
+            "context_limit": _status_context_limit(cfg),
+            "compactions": session_row.get("compression_count", 0),


compression_count is not persisted in the current SessionDB, so this defaults to 0 instead of reporting real compactions. Read the active/cached agent's context_compressor.compression_count when available, otherwise render this metric as unavailable, and cover a nonzero case.

Addressed in c327980. Compactions now come only from the live or cached agent’s context_compressor.compression_count; when no compressor is available the metric is omitted. Coverage includes nonzero live and cached values.

teknium1 · 2026-07-13T22:08:20Z

+    """Best-effort uptime for the current gateway process."""
+    try:
+        proc = subprocess.run(
+            ["ps", "-o", "etimes=", "-p", str(os.getpid())],


ps is unavailable on native Windows, and the system-uptime helper has no Windows fallback. Use a cross-platform source such as psutil (already used by gateway/status.py) and add Windows-path coverage.

Addressed in c327980. Uptime collection now uses psutil.Process(...).create_time() and psutil.boot_time() on every OS, with no ps subprocess. The focused Windows-path test sets sys.platform = "win32" and fails if uptime collection shells out.

leoge007 · 2026-07-20T10:29:20Z

Ported the compact /status card to current main in c327980.

Key changes:

integrated through GatewaySlashCommandsMixin with the async session facade;
preserved current SessionDB token truth, live/cached/persisted model/context fallbacks, and Matrix scope/redaction;
added cross-platform psutil uptime collection with Windows-safe coverage;
reads compaction count only from the live/cached context compressor;
uses only locally persisted cost data (no account/billing network calls);
added all locale keys with placeholder parity.

Local verification after rebasing onto current main (3441b80):

focused status/dispatch/Matrix suite: 57 passed;
i18n + locale wheel + gateway status suite: 146 passed (2 wheel-build tests deselected by their existing guards);
per-file runner: 5 passed;
ruff: passed;
Windows footgun scan: 785 files, clean;
import smoke and YAML parsing: passed.

Please re-review when convenient.

alt-glitch added type/feature New feature or request comp/gateway Gateway runner, session dispatch, delivery P3 Low — cosmetic, nice to have labels Jun 2, 2026

leoge007 mentioned this pull request Jun 2, 2026

feat(gateway): compact runtime card for /status #37474

Open

leoge007 force-pushed the feat/gateway-status-card branch from f2213ea to 9a1610a Compare June 3, 2026 10:51

teknium1 reviewed Jul 13, 2026

View reviewed changes

feat(gateway): port compact status card to slash commands

c327980

leoge007 force-pushed the feat/gateway-status-card branch from 9a1610a to c327980 Compare July 20, 2026 10:28

Navigation Menu

Uh oh!

feat(gateway): compact status card - #37476

feat(gateway): compact status card#37476
leoge007 wants to merge 1 commit into
NousResearch:mainfrom
leoge007:feat/gateway-status-card

leoge007 commented Jun 2, 2026 •

edited

Loading

Uh oh!

leoge007 commented Jun 3, 2026

Uh oh!

teknium1 left a comment

Uh oh!

teknium1 Jul 13, 2026

Uh oh!

leoge007 Jul 20, 2026

Uh oh!

teknium1 Jul 13, 2026

Uh oh!

leoge007 Jul 20, 2026

Uh oh!

teknium1 Jul 13, 2026

Uh oh!

leoge007 Jul 20, 2026

Uh oh!

leoge007 commented Jul 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		@@ -10299,63 +10398,70 @@ async def _handle_status_command(self, event: MessageEvent) -> str:
		source = event.source
		session_entry = self.session_store.get_or_create_session(source)

Uh oh!

Conversation

leoge007 commented Jun 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Example output

Test Plan

Uh oh!

leoge007 commented Jun 3, 2026

Uh oh!

teknium1 left a comment

Choose a reason for hiding this comment

Problems

Suggested changes

Uh oh!

teknium1 Jul 13, 2026

Choose a reason for hiding this comment

Uh oh!

leoge007 Jul 20, 2026

Choose a reason for hiding this comment

Uh oh!

teknium1 Jul 13, 2026

Choose a reason for hiding this comment

Uh oh!

leoge007 Jul 20, 2026

Choose a reason for hiding this comment

Uh oh!

teknium1 Jul 13, 2026

Choose a reason for hiding this comment

Uh oh!

leoge007 Jul 20, 2026

Choose a reason for hiding this comment

Uh oh!

leoge007 commented Jul 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

leoge007 commented Jun 2, 2026 •

edited

Loading