# NousResearch/hermes-agent · Add missing webui entry to PLATFORM_HINTS

## Open now

- Nothing open on GitHub.

These issues and PRs address a missing 'webui' entry in PLATFORM_HINTS that prevented MEDIA rendering hints from being applied in the WebUI. The work involves identifying the gap and adding the missing configuration entry.

## TL;DR

- 4 member(s): 0 open issue(s), 1 closed issue(s), 0 open PR(s), 1 merged PR(s), 2 PR(s) closed without merging.
- A fix was merged to main in PR #22438. Verify it addresses your case.
- **Recommended:** read PR #22438 (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-22438`. 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.50`: 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

- #21883: Bug: PLATFORM_HINTS missing "webui" entry — agent never uses MEDIA: in WebUI

## Prior & competing PRs

- **#22438: fix(webui): add platform hint for MEDIA rendering**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`
  - files: `agent/prompt_builder.py`, `tests/agent/test_prompt_builder.py`
  - fix hunks:
  - `agent/prompt_builder.py`

    ```diff
    @@ -564,6 +564,18 @@ def _strip_yaml_frontmatter(content: str) -> str:
             "code fences). Treat this like a conversation, not a document. Keep responses "
             "brief and natural."
         ),
    +    "webui": (
    +        "You are in the Hermes WebUI, a browser-based chat interface. "
    +        "Full Markdown rendering is supported — headings, bold, italic, code "
    +        "blocks, tables, math (LaTeX), and Mermaid diagrams all render natively. "
    +        "To display local or remote media/files inline, include "
    +        "MEDIA:/absolute/path/to/file or MEDIA:https://... in your response. "
    +        "Local file paths must be absolute. Images, audio (with playback speed "
    +        "controls), video, PDFs, HTML, CSV, diffs/patches, and Excalidraw files "
    +        "render as rich previews. Do not use Markdown image syntax like "
    +        "![alt](/path) for local files; local paths are not served that way. "
    +        "Use MEDIA:/absolute/path instead."
    +    ),
     }
     
     # ---------------------------------------------------------------------------
    ```
  - `tests/agent/test_prompt_builder.py`

    ```diff
    @@ -789,6 +789,7 @@ def test_platform_hints_known_platforms(self):
             assert "cron" in PLATFORM_HINTS
             assert "cli" in PLATFORM_HINTS
             assert "api_server" in PLATFORM_HINTS
    +        assert "webui" in PLATFORM_HINTS
     
         def test_cli_hint_does_not_suggest_media_tags(self):
             # Regression: MEDIA:/path tags are intercepted only by messaging
    ```

    ```diff
    @@ -826,6 +827,13 @@ def test_platform_hints_feishu(self):
             assert "MEDIA:" in hint
             assert "Markdown" in hint
     
    +    def test_platform_hints_webui(self):
    +        hint = PLATFORM_HINTS["webui"]
    +        assert "WebUI" in hint
    +        assert "MEDIA:" in hint
    +        assert "Markdown" in hint
    +        assert "absolute" in hint
    +
     
     # =========================================================================
     # Environment hints
    ```
- **#21891: fix(webui): add platform hint for MEDIA rendering**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#22438`
- **#22049: fix(platform-hints): add missing webui entry to PLATFORM_HINTS**. closed without merge
  - maintainer direction: category `merged_via`; implication `superseded`; refs `#21891`, `#21883`, `#22438`

## Fix status

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