reflect

Prévisualiser avant de modifier la mémoire

Exécutez d'abord avec dry_run: true. Inspectez les nombres d'éléments promus, résumés et expirés avant de planifier une passe d'écriture.

Outil MCP public

reflect

Objectif

Exécuter une passe de maintenance délimitée Dream/Reflection qui rend compte des décisions de consolidation et de cycle de vie de la mémoire, avec application facultative des écritures sélectionnées.

Quand l'utiliser

Prévisualiser ou appliquer une maintenance périodique sur les mémoires épisodiques ou le cycle de vie de la mémoire de projet.
Inspecter les candidats de consolidation, d'expiration, de dépréciation ou d'archivage avec des totaux structurés.
Consigner un enregistrement d'audit pour les promotions et résumés de mémoire vérifiés.

Quand NE PAS l'utiliser

Ne l'utilisez pas pour le rappel ordinaire de mémoires au démarrage d'une tâche ; utilisez recall_context.
N'appliquez pas les écritures de cycle de vie sans avoir d'abord examiné les résultats d'une simulation (dry run).
Ne l'utilisez pas pour contourner les règles d'expiration ; le compacteur applique des limites d'âge et d'importance configurées.
L'API REST accepte un ensemble de champs plus large que l'outil MCP public ; consultez /docs/api/memory pour les filtres de périmètre, bucket, équipe et provenance.

Périmètre requis

memory:read est requis pour la prévisualisation en simulation (dry run) ; l'application des écritures requiert également memory:write.
Les actions de cycle de vie sont limitées au périmètre du propriétaire ou de l'équipe de l'agent authentifié.
Les modifications d'équipe nécessitent l'autorisation d'écriture au niveau de l'équipe.

Paramètres

Nom	Type	Description
`actions_csv`	string · par défaut : summarize,promote,expire,decay,archive	Actions séparées par des virgules. Les actions prises en charge sont summarize, promote, expire, decay et archive ; les alias tels que summary, promotion, expiry et importance_decay sont normalisés par le compacteur.
`dry_run`	boolean · par défaut : false	Lorsque vrai, calcule les candidats et les totaux sans écritures de consolidation ou de cycle de vie ; à privilégier pour examen.
`time_window_hours`	number · par défaut : 24.0	Fenêtre rétrospective positive pour la sélection de résumé/promotion épisodique ; since a priorité lorsqu'il est fourni.
`since / until`	string · par défaut : empty	Limites ISO 8601 facultatives pour la fenêtre de réflexion ; les horodatages malformés sont rejetés.
`path_filter / owner_filter`	string · par défaut : % / authenticated owner	Filtres de chemin logique et de propriétaire. Le serveur résout le filtre de propriétaire par rapport au contexte authentifié.
`bucket / scope / team_id`	string · par défaut : % / empty / empty	Filtres de limite de mémoire facultatifs ; un team_id explicite doit correspondre au contexte d'équipe lié/authentifié.
`limit`	integer · par défaut : 500	Budget maximal de candidats transmis au compacteur ; l'implémentation le contraint à sa plage prise en charge.

Schéma de retour

Le compacteur génère un rapport avec dry_run, actions normalisées, filtres, résumés, promotions, détails du cycle de vie, counts.summarized/promoted/expired/decayed/archived et audit_record_ids. La réponse textuelle MCP s'ouvre sur '### Memory Reflect Report' et affiche Dry Run, Actions, les cinq totaux, Audit Records et jusqu'aux 20 premiers Audit IDs.

Exemples

Prévisualiser une passe de maintenance complète

reflect({
  actions_csv: "summarize,promote,expire,decay,archive",
  dry_run: true,
  time_window_hours: 24,
  limit: 500
})

Appliquer une action de cycle de vie explicitement autorisée

reflect({
  actions_csv: "archive",
  dry_run: false,
  bucket: "personal",
  limit: 100
})

Erreurs

401/403 : jeton manquant ou autorisations insuffisantes pour les actions de cycle de vie demandées.
Échec de validation : time_window_hours est négatif, la chaîne actions_csv contient des actions non reconnues ou la limite dépasse le maximum.
Périmètre invalide : le filtre path_filter ou team_id demandé est en dehors des limites autorisées.
Conflit de cycle de vie : un enregistrement cible a été modifié simultanément pendant la passe de consolidation.

recall_context — Lire un pack de contexte délimité avant de décider si une maintenance est nécessaire.
remember — Persister un fait durable explicitement demandé sans exécuter de passe de consolidation.
search_memory — Rechercher des mémoires autorisées lorsque vous avez besoin d'une récupération plutôt que d'une maintenance de cycle de vie.

Source : Dream / Reflection