# -*- coding: utf-8 -*-
"""
Le contrat que chaque fournisseur d'API doit remplir.

Un projet choisit son fournisseur à sa création et ne change plus : la
conversation est enregistrée dans le format natif du fournisseur, sans
traduction. Convertir un dialogue d'un format à l'autre serait une source de
bogues sans fin, pour un besoin qui n'existe pas — on ne change pas de moteur
au milieu d'un site.

Chaque module de fournisseur expose :

    NOM, ETIQUETTE, CLE_ENV, PAQUET, MODELE_DEFAUT, TARIFS

    disponible()                        -> (bool, message)
    modeles(cle)                        -> liste des modèles accessibles
    essai(modele)                       -> texte renvoyé par un appel minimal

    bloc_texte(texte)                   -> bloc de contenu natif
    bloc_document(chemin, titre)        -> idem, pour un PDF
    bloc_image(chemin, type_mime)       -> idem, pour une image
    marquer_cache(bloc, duree)          -> bool, pose un point de reprise

    conversation_initiale(systeme, blocs, modele) -> dict sérialisable JSON
    ajouter_texte_utilisateur(conv, texte)
    appeler(conv, outils)               -> Tour
    ajouter_tour(conv, tour)            -> enregistre la réponse du modèle
    ajouter_resultats(conv, resultats)  -> enregistre les résultats d'outils
"""

import dataclasses
import os


# Valeurs normalisées du champ Tour.arret, communes à tous les fournisseurs.
OUTILS = "outils"      # le modèle demande l'exécution d'outils
FIN = "fin"            # le modèle a fini de parler
TRONQUE = "tronque"    # réponse coupée : il faut relancer
REFUS = "refus"        # le modèle ou un filtre a décliné


@dataclasses.dataclass
class Tour:
    """Ce qu'un tour d'API rapporte, indépendamment du fournisseur."""

    arret: str
    texte: str = ""
    appels: list = dataclasses.field(default_factory=list)
    # appels : [{"id": str, "nom": str, "entree": dict}]
    contenu: object = None      # la réponse native, à ré-enregistrer telle quelle
    usage: dict = dataclasses.field(default_factory=dict)
    motif: str = ""             # renseigné quand arret == REFUS


def usage_vide():
    return {"entree": 0, "sortie": 0, "cache_lecture": 0, "cache_ecriture": 0}


def lire_taille(chemin):
    return os.path.getsize(chemin)
