# NousResearch/hermes-agent · Fix staged file attachment path allowlist mismatch

## Open now

- 1 issue, 2 PRs open on GitHub.
- #98634: \[Bug\]: file.attach returns @file: refs that prompt expansion always refuses (allowed_root=cwd vs attachments/ staging dir)
- PR #98646: fix(gateway): allowlist session attachment staging dir in @file: ref expansion
- PR #98653: fix(context): allow staged file.attach refs to expand inline

A bug where @file: references from staged file attachments are refused during expansion because the allowed root path does not include the attachments staging directory. These members address fixes to allowlist logic in both gateway and context layers.

## TL;DR

- 3 member(s): 1 open issue(s), 0 closed issue(s), 2 open PR(s), 0 merged PR(s), 0 PR(s) closed without merging.
- No fix has been merged to main; one or more PRs were attempted (see below).
- **Recommended:** review the prior/competing PR(s) below. A fix was attempted but not merged; your case may extend or revive that work.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `unresolved`. 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.

## Open related issues

- #98634: \[Bug\]: file.attach returns @file: refs that prompt expansion always refuses (allowed_root=cwd vs attachments/ staging dir)

## Prior & competing PRs

- **#98646: fix(gateway): allowlist session attachment staging dir in @file: ref expansion**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `agent/context_references.py`, `tests/agent/test_context_references.py`, `tests/tui_gateway/test_tui_gateway_server.py`, `tui_gateway/prompt_turn.py`
- **#98653: fix(context): allow staged file.attach refs to expand inline**. open
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#98646`
  - files: `agent/context_references.py`, `tests/agent/test_context_references.py`, `tests/test_tui_gateway_server.py`, `tui_gateway/server.py`

## Fix status

- No merged fix on record.
- Subsystem: `agent`