# NousResearch/hermes-agent · Improve checkpoint_required error messaging and warnings

## Open now

- Nothing open on GitHub.

These issues and fixes address the lack of startup warnings and actionable guidance when compression.checkpoint_required cannot be satisfied due to missing checkpoint API v2 support. The work adds upfront initialization warnings and clearer remediation messaging to replace opaque blocking errors.

## 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 #115394. Verify it addresses your case.
- **Recommended:** read PR #115394 (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-115394`. 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

- #106870: \[Bug\]: compression.checkpoint_required=true permanently blocks /compress with an opaque error when the memory provider lacks checkpoint API v2 — no startup warning, no actionable guidance

## Prior & competing PRs

- **#115394: checkpoint_required block names the flag and the way out; init warns up front (#106870, consolidates #106879 + #106882)**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`
  - files: `agent/agent_init.py`, `agent/conversation_compression.py`, `tests/agent/test_pre_compress_checkpoint_contract.py`, `website/docs/developer-guide/memory-provider-plugin.md`
- **#106879: fix(compression): warn and remediate opaque checkpoint_required blocks**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `96030a353662860b16ecad447d88e3cafe672a13`, `02e12e0c2a9`, `53acc39af76`, `#115394`, `#106870`
- **#106882: fix(compression): warn at init and add remediation when checkpoint_required cannot pass**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `96030a353662860b16ecad447d88e3cafe672a13`, `#115394`

## Fix status

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