forget

Verifica una eliminación

Vuelve a ejecutar la búsqueda que antes devolvía la memoria. La eliminación solo se confirma cuando la entrada deja de aparecer.

search_memory({ query: "<the removed content>", limit: 5 })
// -> the removed entry must be absent

Herramienta MCP pública

forget

Propósito

Elimina una memoria, un TODO o un registro basado en Ledger tras revisarlo, mediante el límite de control del usuario. El contrato público cubre únicamente la eliminación lógica y física; usa redact_memory para reemplazar el contenido en su lugar.

Cuándo usar

Un usuario pide explícitamente eliminar un registro revisado y proporciona, cuando es posible, una referencia exacta.
El llamador necesita una eliminación recuperable, que es el comportamiento público predeterminado, o una eliminación permanente confirmada de forma explícita.
Es necesario eliminar un ID conocido de TODO o de una transacción de Ledger mediante el mismo ciclo de vida sujeto a control.

Cuándo NO usar

No lo uses para redactar o reemplazar contenido: forget rechaza replacement_content en la superficie pública; llama a redact_memory.
No uses una consulta aproximada para limpiar datos en bloque; primero resuelve y revisa un objetivo exacto.
No uses mode=hard salvo que el usuario confirme explícitamente una eliminación permanente e irreversible.
No lo uses para revisar el contenido de una memoria; usa un flujo de actualización/corrección cuando esté disponible.
La API REST acepta un conjunto de campos más amplio que la herramienta MCP pública; consulta /docs/api/memory para los filtros de scope, bucket, team y provenance.

Ámbito requerido

La eliminación pública requiere memory:write; la política de despliegue puede exigir una capacidad destructiva adicional para la eliminación física.
El llamador debe estar autorizado para el límite de owner/equipo/scope del objetivo.

Parámetros

Nombre	Tipo	Descripción
`memory_id`	string	Referencia exacta del registro que se va a eliminar. Es preferible a target.
`target`	string	Objetivo descriptivo cuando no hay una referencia exacta disponible.
`mode`	string · predeterminado: soft	'soft' (predeterminado y recuperable) o 'hard' (permanente, requiere confirmación explícita previa). Se aceptan los alias 'soft_delete' y 'hard_delete', y un valor vacío significa soft. Cualquier otro valor se rechaza.
`reason`	string	Motivo breve de auditoría que se registra con la eliminación.

Esquema de retorno

El texto de éxito informa de la referencia opaca afectada y del estado del ciclo de vida. La eliminación lógica puede recuperarse mediante la ruta de restauración; la física no.

Ejemplos

Elimina de forma recuperable un registro exacto

forget({
  target: "memory-id-from-recall",
  mode: "soft",
  reason: "User requested removal"
})

Errores

Error de validación: se proporcionó un mode distinto de 'soft'/'soft_delete'/'hard'/'hard_delete', o se estableció replacement_content (usa redact_memory).
401/403: el token no tiene la capacidad de escritura/eliminación necesaria o no puede acceder al objetivo.
Objetivo ambiguo: query_hint coincide con varios registros o no puede establecerse un objetivo exacto.
Modo no válido: la eliminación física no se infiere y los modos no admitidos se rechazan en la superficie pública.
No encontrado o conflicto de ciclo de vida: la memoria, el TODO o el registro de Ledger seleccionado ya no existe o ha cambiado.

search_memory — Encuentra un resultado autorizado y estricto antes de una acción destructiva.
remember — Crea un nuevo registro duradero solo cuando sea realmente necesario.
todos — Gestiona directamente el estado de la tarea; usa forget solo para una eliminación revisada.
ledger — Gestiona los registros financieros mediante el dispatcher de Ledger sujeto a control.

Fuente: Superficie de herramientas MCP