Cuánto se ha reescrito de un store
revisions responde revised de total: cuántas memorias de un store fueron alteradas después de haber sido escritas. Vale la pena preguntarlo antes de apoyarte en la memoria para algo que importa, o cuando un dato recordado no encaja con lo que el usuario está diciendo ahora. Un store donde tres de cada diez hechos han sido reemplazados merece menos confianza que uno que nadie ha editado.
Compatible con Tablet 2 y superiores. Se puede llamar por la API HTTP, desde los SDK de Python, TypeScript y Rust, y como herramienta MCP. Los motores anteriores responden 501 y nombran el modelo que no puede atenderlo.
Recuentos
Cuenta lo que tocó una transformación - reemplazado, actualizado, retractado y imágenes eliminadas.
mem.revisions()
# {"revised": 3, "unrevised": 37, "total": 40, …}| Campo | Qué significa |
|---|---|
| revised | Memorias que ha tocado una transformación. |
| unrevised | Memorias que nada ha tocado desde que se escribieron. revised + unrevised siempre es igual a total - es un valor derivado, no contado aparte, así que una escritura concurrente no puede hacer que los tres no cuadren. |
| total | Memorias que hay en el store. |
| counts / excludes | Frases llanas, no banderas, que detallan qué cubren los números. Quien llama suele ser un modelo. |
Leer la lista
Pase include para obtener las memorias en sí, no solo cuántas hay. Si lo omite, recibe solo los recuentos, que es la llamada barata.
page = mem.revisions(include="revised", limit=20)
page["memories"], page["matched"], page["has_more"]| Campo | Qué hace |
|---|---|
| include | "revised" o "unrevised". Cualquier otro valor se rechaza con un 400 en lugar de recurrir a los recuentos - una errata que descarta la lista en silencio se ve igual que un store vacío. |
| limit | De 5 a 20, por defecto 20. Un valor fuera de rango, o de tipo incorrecto, se rechaza en lugar de ajustarse. |
| matched | Total de filas que hay detrás de esta página, no el tamaño de la página. |
| ordered_by | El servicio declara su propio orden: primero lo guardado más recientemente, no lo editado más recientemente. |
| next_before | Cursor para la página siguiente, junto con next_skip_ids. Devuelva los dos; los ids se acumulan de una página a otra. |
La lista se ordena por cuándo se guardó una memoria, no por cuándo se modificó. Quien asuma "lo editado más recientemente primero" leerá mal la página, y por eso la respuesta indica cuál de los dos órdenes usa.
Las eliminaciones no se cuentan. Una memoria borrada no deja nada que contar, así que un store muy podado sigue reportando un
revised bajo. Este número te dice cuánto se reescribió, no cuánto ha desaparecido.