llm

type Chunk struct {
	Text      string
	ToolCalls []ToolCall
	Done      bool
	Err       error
	// Heartbeat : chunk vide (ni texte, ni appels, Done faux) émis par le
	// fournisseur à la première activité du flux qui ne produit pas de
	// texte (deltas d'appels d'outils, événement sans contenu). Il prouve
	// que le flux vit : il arrête le délai du premier chunk du moteur, sans
	// compter comme une sortie (un repli reste possible). Le moteur l'ignore
	// pour l'affichage et l'historique.
	Heartbeat bool
	// Usage : consommation réelle de l'appel, portée par le chunk Done quand
	// le flux l'a fournie (nil sinon : le moteur estime).
	Usage *Usage
}

type Jurisdiction string

type Message struct {
	Role       Role       `json:"role"`
	Content    string     `json:"content,omitempty"`
	ToolCalls  []ToolCall `json:"tool_calls,omitempty"`
	ToolCallID string     `json:"tool_call_id,omitempty"`
	// Remote : message d'assistant (ou résumé de compaction) produit par un
	// fournisseur non local. Jamais envoyé ni sérialisé ; le contrôle sortant
	// des marquages l'ignore (le fournisseur distant a déjà ce texte).
	Remote bool `json:"-"`
}

type ProviderInfo struct {
	ID           string       `json:"id"`
	Name         string       `json:"name"`
	BaseURL      string       `json:"base_url"`
	Model        string       `json:"model"`
	Country      string       `json:"country"`
	Jurisdiction Jurisdiction `json:"jurisdiction"`
	// Qualifications déclarées (ex. "secnumcloud") ; jamais déduites.
	Qualifications []string `json:"qualifications,omitempty"`
	// NoStreamUsage : n'envoie pas stream_options.include_usage
	// (stream_usage = false). Jamais sérialisé.
	NoStreamUsage bool `json:"-"`
}

type Request struct {
	Model    string
	Messages []Message
	Tools    []ToolDef
}

type Role string

type ToolCall struct {
	ID   string          `json:"id"`
	Name string          `json:"name"`
	Args json.RawMessage `json:"args"`
}

type ToolDef struct {
	Name        string
	Description string
	Schema      json.RawMessage
}

type Usage struct {
	Input, Output, Cached int
}