1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
"""Hermes plugin installed by Herdr to report resumable session identity."""
# HERDR_INTEGRATION_ID=hermes
# HERDR_INTEGRATION_VERSION=5
from __future__ import annotations
import os
import subprocess
import time
_SOURCE = "herdr:hermes"
_AGENT = "hermes"
_INTERACTIVE_PLATFORMS = {"cli", "tui", "desktop", "acp"}
def _pane_id() -> str | None:
if os.environ.get("HERDR_ENV") != "1":
return None
return os.environ.get("HERDR_PANE_ID", "").strip() or None
def _send_session(session_id: str, start_source: str) -> None:
pane_id = _pane_id()
if pane_id is None:
return
command = [
os.environ.get("HERDR_BIN_PATH") or "herdr",
"pane",
"report-agent-session",
pane_id,
"--source",
_SOURCE,
"--agent",
_AGENT,
"--seq",
str(time.time_ns()),
"--agent-session-id",
session_id,
"--session-start-source",
start_source,
]
try:
kwargs = {"timeout": 1, "stdout": subprocess.DEVNULL, "stderr": subprocess.DEVNULL}
if os.name == "nt":
kwargs["creationflags"] = subprocess.CREATE_NO_WINDOW
subprocess.run(command, check=False, **kwargs)
except Exception:
pass
def _report_session(start_source: str, **kwargs) -> None:
if kwargs.get("platform") not in _INTERACTIVE_PLATFORMS:
return
session_id = kwargs.get("session_id")
if not isinstance(session_id, str) or not session_id:
return
_send_session(session_id, start_source)
def _session_started(**kwargs) -> None:
_report_session("startup", **kwargs)
def _session_reset(**kwargs) -> None:
_report_session("new", **kwargs)
def _session_observed(**kwargs) -> None:
if kwargs.get("platform") == "cli":
_report_session("resume", **kwargs)
def register(ctx):
ctx.register_hook("on_session_start", _session_started)
ctx.register_hook("on_session_reset", _session_reset)
ctx.register_hook("pre_llm_call", _session_observed)
|
