Won s'adresse à ceux qui lisent la mémoire.

La plus grande partie de cette API répond avec la mémoire. Won répond à propos d'elle : quelle part d'un store a été réécrite, et jusqu'où on peut lui faire confiance. Cela s'adresse au côté qui lit, le plus souvent l'assistant que vous construisez, et non à la personne dont parlent les souvenirs.

Wontopos, c'est Won + Topos, un seul lieu où la mémoire habite. Won est la part de ce lieu qui renseigne sur la mémoire au lieu de la restituer. Ces appels sont gratuits, en lecture seule, et ne touchent jamais à la récupération : demander ne coûte rien à vos utilisateurs et ne change rien à ce qui est mémorisé.

Ce qui s'y trouve aujourd'hui

Un seul appel aujourd'hui.

Un exemple détaillé

Utilisez le ratio, pas le compte brut. 3 sur 40 et 30 sur 40 n'appellent pas le même traitement.

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 et excludes sont renvoyés sous forme de phrases plutôt que d'indicateurs, car l'appelant est souvent un modèle. Les suppressions ne sont pas comptées.

Prix et limites

Les deux plafonds répondent 429 avec Retry-After en secondes et un message indiquant lequel a été atteint.

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." } }