# NousResearch/hermes-agent · Structured tool failure reporting in run events

## Open now

- Nothing open on GitHub.

A bug where tool.completed run events never reported failure status for structured (dict) tool results and provided no result preview was identified and addressed. The fix aims to carry redacted result previews and properly surface structured tool failures to consumers.

## TL;DR

- 3 member(s): 0 open issue(s), 1 closed issue(s), 0 open PR(s), 1 merged PR(s), 1 PR(s) closed without merging.
- A fix was merged to main in PR #112230. Verify it addresses your case.
- **Recommended:** read PR #112230 (and any competing PRs below) before filing. Confirm the merged change covers your symptom.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `resolved` · deciding PR(s): `pr-112230`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_SPANNING`): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
- Pairwise link density `0.67`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Closed / duplicate issues

- #111815: \[Bug\]: tool.completed run event never reports failure for structured (dict) tool results, and carries no result/preview so consumers cannot distinguish blocked vs ordinary failures

## Prior & competing PRs

- **#112230: fix(gateway): tool.completed run events report structured tool failures and carry a redacted result preview (#111815, salvage #111821)**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`
  - files: `agent/display.py`, `agent/tool_executor.py`, `gateway/platforms/api_server_runs.py`, `tests/agent/test_display_tool_failure.py`, `tests/agent/test_start_order_gate.py`, `tests/gateway/test_api_server_runs.py`, `website/docs/user-guide/features/api-server.md`
- **#111821: fix(gateway): report structured tool failures in run events**. closed without merge
  - maintainer direction: category `merged_via`; implication `superseded`; refs `1d14418ea2`, `#112230`

## Fix status

- Merged to main in PR #112230 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-09-16`.