reflect

Previsualiza antes de cambiar la memoria

Usa dry_run=true para inspeccionar las cinco acciones de reflexión publicadas, sus recuentos y los detalles de los candidatos antes de permitir una escritura de resumen, promoción, expiración, decaimiento o archivado.

Herramienta MCP pública

reflect

Propósito

Ejecuta una pasada acotada de mantenimiento Dream/Reflection que informa sobre la consolidación y las decisiones del ciclo de vida de la memoria, con posibilidad de aplicar las escrituras seleccionadas.

Cuándo usar

Un operador autorizado o worker de mantenimiento necesita resumir memorias episódicas recientes en registros de reflexión semántica.
Necesitas inspeccionar evidencia episódica repetida antes de decidir si debe convertirse en un hecho semántico durable.
Necesitas una pasada explícita y acotada de expiración, decaimiento de importancia o archivado sobre un límite autorizado de propietario/equipo/scope.

Cuándo NO usar

No la uses para un hecho durable ordinario solicitado por un usuario; usa remember o un helper de captura del SDK.
No la uses como herramienta general de búsqueda, recuperación de contexto o borrado definitivo; usa recall_context, search_memory o la superficie forget gobernada.
No omitas dry_run cuando el caller solo esté evaluando candidatos o no tenga autorización explícita para modificar la memoria.
No describas esta herramienta como el diseño Dream Light/REM/Deep más amplio ni como un scheduler autónomo; la superficie publicada solo contiene estas cinco acciones.

Ámbito requerido

dry_run=true requiere memory:read; una ejecución de escritura requiere memory:write.
El catálogo clasifica reflect como una superficie de mantenimiento interno, no como una herramienta mínima de marketplace-app pública. Úsala solo desde un contexto de mantenimiento autorizado o MCP directo.
El servidor resuelve owner, bucket, scope, team, bound-space y autorización del agente; los filtros del caller no pueden ampliar ese límite.

Parámetros

Nombre	Tipo	Descripción
`actions_csv`	string · predeterminado: summarize,promote,expire,decay,archive	Acciones separadas por comas. Las acciones publicadas son summarize, promote, expire, decay y archive; el compactor normaliza alias como summary, promotion, expiry e importance_decay.
`dry_run`	boolean · predeterminado: false	Cuando es true, calcula candidatos y recuentos sin realizar escrituras de consolidación o ciclo de vida; es preferible para revisión.
`time_window_hours`	number · predeterminado: 24.0	Ventana positiva de consulta retrospectiva para seleccionar episodios de summarize/promote; since la sustituye cuando se proporciona.
`since / until`	string · predeterminado: empty	Límites ISO 8601 opcionales para la ventana de reflexión; se rechazan las marcas de tiempo mal formadas.
`path_filter / owner_filter`	string · predeterminado: % / authenticated owner	Filtros de ruta lógica y propietario. El servidor resuelve el filtro de propietario contra el contexto autenticado.
`bucket / scope / team_id`	string · predeterminado: % / empty / empty	Filtros opcionales del límite de memoria; un team_id explícito debe coincidir con el contexto de equipo vinculado/autenticado.
`limit`	integer · predeterminado: 500	Presupuesto máximo de candidatos que se pasa al compactor; la implementación lo limita a su rango admitido.

Esquema de retorno

El compactor genera un informe con dry_run, acciones normalizadas, filtros, summaries, promotions, detalles del ciclo de vida, counts.summarized/promoted/expired/decayed/archived y audit_record_ids. La respuesta de texto MCP comienza con '### Memory Reflect Report' y muestra Dry Run, Actions, los cinco counts, Audit Records y hasta los primeros 20 Audit IDs.

Ejemplos

Previsualiza una pasada completa de mantenimiento

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

Aplica una acción del ciclo de vida autorizada explícitamente

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

Errores

401/403: el caller carece del scope de lectura para dry_run o del scope de escritura para una ejecución mutante, o el propietario/equipo/bound space solicitado no está autorizado.
Validation failure: una acción no es compatible, time_window_hours no es positivo, since/until no es ISO 8601 o un valor de límite/limit no es válido.
Team authorization failure: una mutación de ciclo de vida de equipo no autorizada se rechaza en lugar de aplicarse silenciosamente.
Concurrency or audit failure: un cambio de memoria, una transición de estado incompleta o una auditoría de consolidación fallida se revierte o se informa como error.

recall_context — Lee un paquete de contexto acotado antes de decidir si hace falta mantenimiento.
remember — Persiste un hecho durable solicitado explícitamente sin ejecutar una pasada de consolidación.
search_memory — Busca memorias autorizadas cuando necesitas recuperación y no mantenimiento del ciclo de vida.

Fuente: Dream / Reflection