Contrat Tool ↔ Brain
La frontière stable qui permet à Studio et aux futurs tools d’utiliser le même contexte.
Pourquoi ce contrat existe
Un tool ne doit jamais connaître la structure physique des tables Brain pour construire ses prompts.
La frontière stable est le Context Engine.
Lecture
Contrat conceptuel :
context({
brainId,
toolId,
toolScopeId,
spaceIds,
intent,
budgetCu,
clientScope,
})
Réponse :
{
contextPackId,
spaces,
fragments,
provenance,
contradictions,
cuUsed,
engineVersion,
}
Le nom exact des fonctions peut évoluer ; ces responsabilités sont l’invariant.
Tool Context Binding
Le binding déclare :
- tool ;
- scope métier du tool ;
- Brain ;
- Spaces autorisés ;
- capacité de lecture ;
- catégories de write-back autorisées ;
- politique de durée/révocation.
Un binding ne contient jamais de credential fournisseur.
Write-back
Un tool ne crée pas silencieusement une Memory parce qu’un événement vient de se produire.
Flux cible :
Exemples Studio :
- verdict QC ;
- learning confirmé ;
- résultat d’expérience ;
- performance observée ;
- décision humaine validée.
Permissions
Le Context Engine applique les permissions avant récupération et avant livraison.
Le tool ne peut jamais élargir lui-même :
- les Spaces lisibles ;
- l’accès à Personal ;
- la capacité d’écriture ;
- la durée d’un binding.
Portabilité
MCP et API utilisent le même moteur et les mêmes policies que les tools internes.
Il n’existe qu’un seul stack de retrieval.