Adds backend-neutral observer hooks for plugins: session, turn, API request, tool, approval, and subagent lifecycle events with stable correlation IDs (session_id, task_id, turn_id, api_request_id, tool_call_id, parent/child subagent ids). Extends VALID_HOOKS with api_request_error and subagent_start. Hot path is zero-cost when no plugin subscribes: has_hook()/presence checks gate all payload construction, request payloads are returned by reference when no middleware rewrites, and the sanitized response payload no longer embeds raw response objects. Bundles the optional NeMo-Relay observability plugin (plugins/observability/nemo_relay) as an in-repo consumer of the new hooks, peer to the existing langfuse plugin. Fails open when the optional nemo-relay package is not installed. Authored-by: Bryan Bednarski <bbednarski@nvidia.com> Salvaged from #29722 onto current main.
21 lines
570 B
YAML
21 lines
570 B
YAML
name: nemo_relay
|
|
version: "0.1.0"
|
|
description: "Optional NeMo Relay observability for Hermes. Opt in with `hermes plugins enable observability/nemo_relay`; HERMES_NEMO_RELAY_* env vars configure exports after the plugin is enabled."
|
|
author: NousResearch
|
|
hooks:
|
|
- on_session_start
|
|
- on_session_end
|
|
- on_session_finalize
|
|
- on_session_reset
|
|
- pre_llm_call
|
|
- post_llm_call
|
|
- pre_api_request
|
|
- post_api_request
|
|
- api_request_error
|
|
- pre_tool_call
|
|
- post_tool_call
|
|
- pre_approval_request
|
|
- post_approval_response
|
|
- subagent_start
|
|
- subagent_stop
|