Le gate qui refuse de compacter : ce que protège réellement compression.checkpoint_required

Trois heures après le début d’une session, la fenêtre de contexte se remplit, Hermes compresse, et vous continuez à travailler. Deux jours plus tard, vous demandez pourquoi une décision a été prise et vous obtenez une réponse assurée qui s’avère être le résumé d’un résumé. Rien n’est corrompu à proprement parler — mais ce dont vous aviez besoin n’a jamais été consigné nulle part de façon durable, et le transcript qui le contenait a été réécrit.
C’est la défaillance que compression.checkpoint_required existe pour empêcher. C’est un instrument brutal : le gate armé, Hermes préfère refuser de compacter plutôt que de réécrire votre historique sans sauvegarde.
L’idée en une phrase
La compaction est avec perte par définition — un long transcript devient un résumé plus court accompagné d’une queue récente. Le gate dit : avant que cette réécriture ait lieu, quelqu’un doit avoir validé une copie durable du transcript non compressé, et m’avoir dit qu’elle l’était.
Qui est ce quelqu’un ? Un plugin de provider de mémoire. Pas le summarizer, pas la base de sessions, pas le modèle.
L’activer
compression:
checkpoint_required: true # par défaut : false
ou, de façon équivalente :
hermes config set compression.checkpoint_required true
hermes config get compression.checkpoint_required
C’est toute la surface d’exploitation. Tout ce qui suit porte sur ce que cela change, parce que les conséquences sont plus vastes qu’un simple booléen ne le suggère.
Ce que le gate bloque
Le gate armé, une tentative de compaction échoue en mode fermé avant toute réécriture avec perte :
- le transcript non compressé est préservé exactement tel qu’il est ;
- la tentative renvoie l’erreur
BLOCKED_MISSING_PREREQUISITEavec un motif nommant ce qui manquait ; - elle peut être relancée une fois votre archive remise en état.
Le gate lie aussi toute autorité de compaction, pas seulement le summarizer de Hermes. La compaction native côté serveur est désactivée tant que le gate est armé, la micro-compaction d’après-tour est forcée à l’arrêt à l’initialisation de l’agent (elle absorbe les anciens échanges dans un résumé glissant sans point d’accroche de checkpoint sur son chemin), et le mode d’API codex_app_server est refusé au démarrage — ce runtime compacte son propre fil sans frontière pré-compaction fiable, donc un checkpoint obligatoire ne peut y être garanti. Le compresseur Hermes conscient des checkpoints reste la seule autorité avec perte.
Ce dernier point est le compromis honnête : activer le gate rend la compaction plus stricte et, sur certains runtimes, impossible. C’est un réglage d’intégrité des données, pas un réglage de performance.
Ce qu’un provider doit implémenter
Le contrat est court et explicite. Un provider s’inscrit en déclarant la version 2 de l’API :
from agent.memory_provider import MemoryProvider
class MyArchivingProvider(MemoryProvider):
pre_compress_checkpoint_api_version = 2
def on_pre_compress(self, messages, *, require_checkpoint=False):
ids = self._archive(messages) # doit être durable avant le retour
return f"checkpoint: {ids}" # transmis au prompt de résumé
require_checkpoint reflète le réglage de l’opérateur : quand il vaut True, lever une exception depuis cette méthode est ce qui bloque la réécriture avec perte. Retourner signifie que la copie durable est validée — l’échec partiel n’est donc pas une option, et la documentation est explicite : il faut lever sur n’importe quelle erreur plutôt que de retourner avec optimisme.
Les providers en version 2 reçoivent aussi des preuves directes normalisées au lieu de la liste brute : uniquement les lignes de texte utilisateur et assistant. Les résultats d’outils, les messages système, la charge tool_calls des messages assistant et les résumés de compaction antérieurs sont filtrés côté hôte. Les résumés antérieurs sont reconnus grâce à un marqueur persistant, si bien qu’une session reprise ne renvoie jamais de résumés dérivés dans votre archive comme s’il s’agissait de preuves d’origine.
Une exigence de plus qui surprend : les checkpoints doivent être idempotents. Après un blocage en mode fermé, la tentative suivante appelle de nouveau on_pre_compress() avec le même transcript, et un transcript légèrement allongé produit des preuves largement redondantes. Indexez les écritures d’archive par contenu — un digest du transcript, par exemple — et faites des upserts, sinon les relances empileront des doublons.
Ce qui a changé le 6 novembre
Le gate est sorti plus tôt, mais il avait une arête vive qu’un correctif ultérieur a dû limer (PR #149763, fusionnée le 6 novembre 2026). Deux problèmes :
- Les subagents et les forks étaient construits avec la mémoire désactivée.
delegate_task, le curator, le batch runner et les tours de commentaires Feishu font tourner chacun leur propre transcript, et ces forks étaient construits avecskip_memory=True. Le gate armé, leur première compaction échouait avecBLOCKED_MISSING_PREREQUISITE— non pas parce que votre provider avait un défaut, mais parce que le fork n’en avait jamais reçu un. - La purge proactive des résultats d’outils ignorait le gate. Elle retire les gros résultats d’outils pour récupérer des tokens sans appel au modèle, et elle les retirait sans checkpoint préalable — supprimant discrètement des preuves que le gate était censé protéger.
Les deux sont corrigés. Les forks conservent désormais le provider tant que le gate est armé, et l’hôte supprime leurs écritures et leur rappel (ils tournent dans un contexte de subagent au lieu de prétendre être vous). La purge est retenue à son point d’appel tant qu’un checkpoint n’existe pas.
Si vous avez activé le gate avant ce correctif et vu des tours de subagent mourir à leur première compaction, voilà pourquoi — et cela vaut la peine de réessayer maintenant.
Faut-il l’activer
Posez-vous une seule question : un transcript compacté est-il récupérable chez vous aujourd’hui ?
Si votre réponse est que le résumé suffit, laissez le gate désactivé. Il l’est par défaut, et aucun des providers livrés avec Hermes n’annonce l’API checkpoint v2 — activez le gate sans provider v2 et vous bloquez toute tentative de compaction, manuelle comme automatique. L’initialisation de l’agent journalise un avertissement nommant le provider actif, et chaque refus nomme compression.checkpoint_required comme clé à désactiver : il échoue donc bruyamment plutôt que silencieusement.
Si votre réponse est que vous avez une archive de chaque conversation et qu’elle doit être complète, le gate transforme une perte silencieuse en arrêt bruyant, ce qui est généralement souhaitable dans un déploiement réglementé ou de longue durée. Associez-le à un provider qui fait des upserts par digest, et prévoyez que le comportement de compaction devienne déterministe plutôt que du meilleur effort.
Pour le tableau d’ensemble — quelle part de votre fenêtre la compaction récupère, et où vont réellement les tokens — le guide d’optimisation des tokens de contexte est la lecture complémentaire. Et si vous mettez à jour de toute façon, la page de release v0.23.0 liste les autres changements de compression de ce cycle, dont la compaction préparée facultative qui écrit le résumé suivant en arrière-plan.