tools

type Option func(*options)

type Registry struct {
	// contains filtered or unexported fields
}

type Result struct {
	Content    string
	IsError    bool
	Path       string
	HashBefore string
	HashAfter  string
	// NoCheckpoint vaut true quand l'écriture n'a pas pu être copiée (fichier
	// trop volumineux pour une copie, voir SnapshotMaxBytes).
	NoCheckpoint bool
	// Denied vaut "policy" quand l'outil a refusé l'appel par règle (vide sinon).
	Denied string
	// ServerDown porte l'identifiant d'un serveur MCP qui vient de tomber pendant
	// cet appel (vide sinon) ; signalé une seule fois par serveur.
	ServerDown string
	// Sandbox indique comment la commande shell s'est exécutée (isolée ou
	// non, réseau accordé ou non) ; nil pour les autres outils.
	Sandbox *event.SandboxUse
	// Untruncated est le texte complet avant troncature (résultat MCP), pour
	// le seul contrôle de classification ; jamais enregistré ni envoyé.
	// Vide : Content est complet.
	Untruncated string
}

type Risk int

type ShellOptions struct {
	// Sandbox est la Spec de base des commandes isolées (nil : non isolées).
	// Son champ Network est remplacé, à chaque appel, par NetworkFrom(ctx).
	Sandbox *sandbox.Spec
	// Env est l'environnement des commandes, déjà filtré des secrets ; nil
	// hérite de l'environnement de tenon.
	Env []string
	// NetworkOpen indique que l'isolation ne coupe pas le réseau (sonde :
	// isolation réseau "none") : une commande confinée a alors le réseau, et
	// le journal le dit.
	NetworkOpen bool
}

type Target struct {
	Paths   []string // chemins absolus nettoyés
	Command string
	// ForceAsk impose une validation humaine : Permissions.Check renvoie Ask
	// (Deny si une règle deny correspond), quelles que soient les règles allow.
	ForceAsk bool
}

type Tool interface {
	Name() string
	Description() string
	Schema() json.RawMessage
	Risk() Risk
	Target(args json.RawMessage) (Target, error)
	// Run renvoie une error uniquement en cas d'annulation du contexte.
	Run(ctx context.Context, args json.RawMessage) (Result, error)
}