Won es para quien lee la memoria.

La mayor parte de esta API responde con memoria. Won responde sobre ella: cuánto se ha reescrito de un store y hasta dónde se puede confiar en él. Está pensado para el lado que lee, normalmente el asistente que estás construyendo, y no para la persona de la que hablan las memorias.

Wontopos es Won + Topos, un solo lugar donde vive la memoria. Won es la parte de ese lugar que informa sobre la memoria en vez de devolverla. Estas llamadas son gratuitas, de solo lectura, y nunca tocan la recuperación: preguntar no le cuesta nada a tu usuario y no cambia nada de lo que está recordado.

Lo que hay disponible ahora

Por ahora, una sola llamada.

Un ejemplo resuelto

Use la proporción, no el recuento en bruto. 3 de 40 y 30 de 40 requieren un tratamiento distinto.

r = mem.revisions()
# {"revised": 3, "total": 40, "counts": "…", "excludes": "…"}

if r["revised"] / r["total"] > 0.1:
    system += "Some of what you remember here has been corrected since."

const r = await mem.revisions();
// { revised: 3, total: 40, counts: "…", excludes: "…" }

if (r.revised / r.total > 0.1) {
  system += "Some of what you remember here has been corrected since.";
}

let r = mem.revisions(None).await?;
let (rev, tot) = (r["revised"].as_f64().unwrap_or(0.0),
                r["total"].as_f64().unwrap_or(1.0));
if rev / tot > 0.1 { /* say so in the system prompt */ }

curl -X POST https://api.wontopos.com/api/v1/won/revisions \
  -H "X-API-Key: $WOS_KEY" -H "Content-Type: application/json" \
  -d '{"user_id":"alice"}'

# → {"user_id":"alice","revised":3,"total":40,
#     "counts":"memories a transform has touched (supersede, update, retract, image removed)",
#     "excludes":"deletions — a deleted memory leaves nothing to count"}

counts y excludes se devuelven como frases y no como banderas, porque quien llama suele ser un modelo. Las eliminaciones no se cuentan.

Precio y límites

Ambos techos responden 429 con Retry-After en segundos y un mensaje que nombra cuál de los dos se ha alcanzado.

Retry-After: 41

{ "error": { "type": "rate_limit_error",
    "message": "This endpoint is free and limited to 10 requests per
                minute, counted per endpoint. Retry in 41s." } }