// agent surface v1.10.0
Une surface M2M pour lire l0g sans scraper.
Agent Surface v1.10.0 expose le corpus l0g sous forme de JSON statique et NDJSON : catalogue, evidence graph, claims sourcées, sources primaires, fraîcheur, Risk Diff, Black Box Recorder, historique des signaux, empreintes et contrat OpenAPI. La promesse est simple : un agent doit pouvoir citer une affirmation sans perdre la source, claimDate, observationDate, sourcePublicationDate, retrievedAt, indexedAt et le niveau de lecture. Pour les signaux de risque, le contrat conserve aussi les limites de modèle : Dette US publie un stress courant hors CBO et une couverture de buckets lorsque le snapshot amont la fournit.
// endpoints
/agents.json Manifeste des capacités, règles d’usage, endpoints et politique de preuve.
Contrat/openapi.json Description OpenAPI 3.1 des endpoints consommables par agents et clients M2M.
Claims/api/v1/claims.json Graphe affirmation-source : fait revu, estimation, inférence, scénario ou assertion non classée, avec références datées quand détectable.
Evidence graph/api/v1/evidence-graph.json Graphe articles, claims, références, hôtes, sources primaires et datasets, exprimé en nœuds et arêtes.
Claims NDJSON/api/v1/claims.ndjson Flux ligne à ligne des claims pour ingestion RAG, streaming ou traitement incrémental.
Catalogue NDJSON/api/v1/catalog.ndjson Catalogue complet en lignes NDJSON : articles, guides, méthodes, glossaire et sources.
Sources/api/v1/sources.json Registre des sources primaires et des hôtes effectivement cités dans les articles.
Fraîcheur/api/v1/freshness.json Derniers contenus, endpoints, politique de fraîcheur et temporalité par signal de dashboard.
Intégrité/api/v1/integrity.json Empreintes SHA-256 canoniques des surfaces M2M, pour vérifier un snapshot sans dépendre du timestamp de build.
Changefeed/api/v1/changes.json Flux machine des publications, révisions et politiques, avec version courante, hash et statut de diff.
Risk Diff/api/v1/risk-diff.json Diff du risque par fenêtre 1, 7 et 30 jours : signaux, sources, claims, modèles, articles et confiance.
Black Box/api/v1/black-box.json Frames point-in-time hashées pour rejouer l’état public du risque à une date donnée, sans reconstruction rétroactive.
Signal history/api/v1/signals/history.json Historique point-in-time des signaux : observations backtestables, alertes de seuil, couverture et politique.
Signal NDJSON/api/v1/signals/history.ndjson Flux ligne à ligne des signaux pour agents, watchers et ingestion incrémentale.
Signal CSV/api/v1/signals/history.csv Observations de signaux à plat pour pandas, R, DuckDB ou tableur.
Catalogue/api/v1/catalog.json Carte complète du corpus : articles, guides, méthodologies, atlas du glossaire, sources et protocole.
// flux conseillé
- Découvrir la surface avec /agents.json.
- Lire /api/v1/freshness.json pour dater le corpus et les signaux de dashboards.
- Vérifier les empreintes avec /api/v1/integrity.json si la réponse dépend d’un corpus figé.
- Surveiller /api/v1/changes.json pour suivre les nouveaux contenus et révisions.
- Lire /api/v1/risk-diff.json pour analyser les changements de risque sur 1, 7 ou 30 jours.
- Lire /api/v1/black-box.json pour rejouer une date sans remplir les trous historiques.
- Lire /api/v1/signals/history.csv ou .ndjson pour rejouer les signaux point-in-time sans look-ahead bias.
- Utiliser /api/v1/evidence-graph.json quand il faut parcourir la relation article → claim → source.
- Basculer sur les variantes .ndjson pour une ingestion ligne à ligne.
- Chercher le contenu dans /api/v1/catalog.json ou /llms.txt.
- Citer une affirmation via /api/v1/claims.json quand la réponse dépend d’un fait précis.
- Conserver l’URL canonique, la date et le type de claim dans la réponse générée.
// garde-fous
Les champs kind, dateLabel, references et
confidence ne sont pas décoratifs. Ils évitent de transformer une
estimation ou un scénario en fait observé, et rappellent qu’une relation extraite
automatiquement reste vérifiable dans la page canonique.
// contrat minimal
// exemple
curl -s https://l0g.fr/api/v1/claims.json// intégration
Pour un agent RAG, utiliser /api/v1/catalog.ndjson pour découvrir
les documents, puis /api/v1/evidence-graph.json ou
/api/v1/claims.ndjson pour les assertions sensibles.
/api/v1/changes.ndjson évite de rescanner tout le corpus.
/api/v1/risk-diff.json résume les mouvements de risque,
/api/v1/black-box.json rejoue les frames publiques disponibles,
et /api/v1/integrity.json permet de vérifier les empreintes du snapshot.
Pour une intégration typée, partir de /openapi.json.