l0g

// agent surface v1.18.0

API financière et MCP compact pour agents IA

Agent Surface v1.18.0 expose le corpus français et anglais sous forme de JSON statique et NDJSON : catalogue, evidence graph, trois claims structurants typés maximum par article, sources primaires, fraîcheur, Risk Diff, Black Box Recorder, index de recherche partagé, historique des signaux, empreintes et contrat OpenAPI. Les traductions portent leur identifiant canonique, leur alternative et leur statut de fraîcheur. Les claims restent françaises et canoniques en français : une analyse anglaise pointe vers ses preuves via evidenceRef. Le type heuristique reste distinct d’une revue canonique. 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.

Guide agentJSON statiqueOpenAPISHA-256correction policy

English Agent Surface documentation →

l0g Agent Bench : résultats déterministes FR/EN →

// endpoints

MCP compact/api/mcp/compact

Porte d’entrée normale à six tools. get_risk_state est le produit principal pour l’état courant, le diff, l’historique et le replay.

Découverte/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 : trois claims structurants maximum par article, typés fait, estimation, inférence ou scénario, 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.

Séries nommées/series/

Registre des identifiants stables, noms citables, versions méthodologiques et exports CSV, JSON, NDJSON et SVG par jauge.

Ressources presse/ressources-journalistes/

Graphiques SVG permanents, code d’intégration, citations recommandées et limites de réutilisation.

Journal brut/api/v1/history.ndjson

Chaque assemblage opérationnel, append-only serveur mais non attesté individuellement par la CI.

Signal history/api/v1/signals/history.json

Historique canonique fusionné : continuité opérationnelle quotidienne, frames attestées, courant et evidenceTier.

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 bilingue du corpus avec language, canonicalId, translationOf, alternateUrl et translationStatus.

Index partagé/api/v1/search-index.json

Index de recherche bilingue canonique consommé par Agent Surface, MCP et WebMCP.

Corpus anglais/llms-full-en.txt

Texte complet des analyses et guides anglais, séparé du corpus français pour borner le contexte.

// flux conseillé

  1. Connecter le client à /api/mcp/compact et commencer par get_risk_state pour toute question sur le risque.
  2. N’utiliser /api/mcp que pour les workflows de recherche nécessitant le catalogue expert.
  3. Découvrir la surface avec /agents.json.
  4. Lire /api/v1/freshness.json pour dater le corpus et les signaux de dashboards.
  5. Vérifier les empreintes avec /api/v1/integrity.json si la réponse dépend d’un corpus figé.
  6. Surveiller /api/v1/changes.json pour suivre les nouveaux contenus et révisions.
  7. Lire /api/v1/risk-diff.json pour analyser les changements de risque sur 1, 7 ou 30 jours.
  8. Lire /api/v1/black-box.json pour rejouer une date sans remplir les trous historiques.
  9. Choisir une série nommée dans /series/, puis utiliser son export CSV, JSON, NDJSON ou SVG dédié.
  10. Lire /api/v1/signals/history.csv ou .ndjson pour rejouer les séries ; filtrer evidenceTier selon le niveau de preuve requis.
  11. Utiliser /api/v1/evidence-graph.json quand il faut parcourir la relation article → claim → source.
  12. Basculer sur les variantes .ndjson pour une ingestion ligne à ligne.
  13. Chercher le contenu dans /api/v1/search-index.json, partagé avec MCP et WebMCP.
  14. Utiliser /llms-full.txt pour le français ou /llms-full-en.txt pour l’anglais sans charger les deux corpus.
  15. Citer une affirmation via /api/v1/claims.json quand la réponse dépend d’un fait précis.
  16. Pour une traduction anglaise, suivre evidenceRef vers les claims et preuves françaises canoniques.
  17. 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 etconfidence 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

Attributionl0g.fr
LicenceCC BY 4.0
Versionv1.18.0
Protocole éditorialv1.0.0
FormatJSON + NDJSON
Preuveclaim-source
IntégritéSHA-256

// exemple

curl -s https://l0g.fr/api/v1/claims.json

// intégration

Pour un agent RAG, utiliser /api/v1/search-index.json pour rechercher les documents français et anglais, 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.