ouyangbo/hermes-agent
1
0
Fork 0
Code Issues Pull Requests Actions 12 Packages Projects Releases Wiki Activity

fix(relay): complete native plugin cutover

Browse Source 
Signed-off-by: Alex Fournier <afournier@nvidia.com>
This commit is contained in:
Alex Fournier
2026-08-19 07:57:03 -07:00
committed by Bryan Bednarski
parent 0cc00d0a0c
commit 31402f630b
12 changed files with 208 additions and 244 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/observability/README.md
+3 -3
View File
@@ -318,7 +318,7 @@ nested agent work or security lifecycle events.
The bundled Langfuse plugin demonstrates direct hook-based observability for
turns, provider requests, and tool calls.
The native NeMo Relay SDK integration maps Hermes session, turn, LLM, tool,
and mark lifecycles to Relay. Explicit Relay plugin configuration can add ATOF
or ATIF exporters and execution middleware; see
The native NeMo Relay SDK integration maps Hermes session, turn, LLM, and tool
lifecycles to Relay. Explicit Relay plugin configuration can add ATOF or ATIF
exporters and execution middleware; see
[Relay shared metrics](relay-shared-metrics.md).
docs/observability/relay-shared-metrics.md
+24
View File
@@ -62,6 +62,30 @@ from the selected file only. If the selected file cannot be loaded, Hermes
reports the error and does not invoke Relay initialization or fall back to
ambient discovery.
## Session-Span Segmentation for Continuous Sessions
Relay exports a span when its scope closes. A continuous gateway session can
remain open for days, so its session span remains open even though each turn
span is exported normally. Optional segmentation rotates only the session
scope at a turn boundary:
```yaml
gateway:
telemetry:
session_segments:
on_compaction: false # rotate after context compaction
max_turns: 0 # 0 = unlimited; N = turns per segment
```
| Key | Default | Behavior |
|---|---:|---|
| `on_compaction` | `false` | Rotate after compaction completes, at the next turn boundary. |
| `max_turns` | `0` | Rotate after every N completed turns; `0` disables the cap. |
Both defaults preserve one session scope for the full session. Rotated spans
retain the same `session_id` and add `hermes.session.segment` plus
`hermes.session.segment_reason` (`compaction` or `max_turns`).
## Process-Wide Plugin Policy and Profile Isolation
Relay plugin configuration is a process-level deployment choice, not a Hermes