Documentation
¶
Overview ¶
Package headless exécute un tour d'agent sans interface interactive : toute demande de permission est refusée, la sortie est du texte ou du JSON.
Index ¶
- func Banner(l i18n.Lang, p llm.ProviderInfo) string
- func Clean(s string) string
- func JurisdictionLabel(l i18n.Lang, j llm.Jurisdiction) string
- func MCPBanner(l i18n.Lang, servers []event.MCPServerInfo) string
- func OneLine(s string) string
- func ProviderLabel(p llm.ProviderInfo) string
- func Run(ctx context.Context, eng *engine.Engine, sessionID, prompt string, ...) int
- func ServerDownNotice(l i18n.Lang, p event.McpServerDownPayload, redact func(string) string) string
- type Options
- type Output
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Banner ¶
func Banner(l i18n.Lang, p llm.ProviderInfo) string
Banner renvoie la bannière de transparence dans la langue l : « tenon · <modèle> · <nom fournisseur> · <pays> · juridiction <UE|hors UE|locale> ». Un nom ou un pays vide est omis.
func Clean ¶
Clean retire de s les séquences d'échappement ANSI, les caractères de contrôle autres que le saut de ligne et les caractères de format (bidirectionnels, largeur nulle) ; tabulations, retours chariot et séparateurs Unicode deviennent des espaces. Le texte vient d'un serveur MCP, non fiable. Les lignes sont conservées : un masquage ancré en fin de ligne s'applique ensuite.
func JurisdictionLabel ¶
func JurisdictionLabel(l i18n.Lang, j llm.Jurisdiction) string
JurisdictionLabel renvoie le libellé traduit de la juridiction j.
func MCPBanner ¶
func MCPBanner(l i18n.Lang, servers []event.MCPServerInfo) string
MCPBanner renvoie la ligne « MCP : id (juridiction), … » des serveurs MCP actifs, ou "" s'il n'y en a aucun.
func ProviderLabel ¶
func ProviderLabel(p llm.ProviderInfo) string
ProviderLabel renvoie le nom du fournisseur, à défaut son identifiant.
func Run ¶
func Run(ctx context.Context, eng *engine.Engine, sessionID, prompt string, opts Options, stdout, stderr io.Writer) int
Run soumet prompt à eng dans la session sessionID et renvoie le code de sortie : 3 si une action a été refusée (permission, politique) ou le tour bloqué, 1 si Submit échoue ou si le tour n'a pas pu tourner (contexte trop volumineux), sinon 0.
func ServerDownNotice ¶
ServerDownNotice renvoie l'avis d'un serveur MCP indisponible. Chaque partie est nettoyée puis masquée seule, lignes conservées (une règle ancrée en fin de ligne y reconnaît un secret), avant d'être mise sur une ligne.
Types ¶
type Options ¶
type Options struct {
Output Output
// Lang est la langue des messages affichés (vide : français).
Lang i18n.Lang
// Redact masque une charge utile JSON avant affichage (sortie json).
// nil : aucun masquage.
Redact func(string) string
// RedactText masque le texte libre : réponse finale (sortie texte) et
// messages écrits sur stderr. nil : Redact est utilisé.
RedactText func(string) string
}
Options configure Run.
Source Files