Composants Touba

Le source décrit le programme, le runtime en contrôle l’exécution et les handlers le relient aux systèmes externes.

Le modèle propose. Touba contrôle l’appel. Vos handlers réalisent l’action et la trace en conserve le déroulement.

Du programme à l’action

Composant	Responsabilité
Langage	Décrire types, fonctions, skills, agents, stratégies et règles d’accès dans les fichiers .tb
Compilateur et AIR	Vérifier le source et produire sa représentation intermédiaire structurée
Runtime	Exécuter le programme, contrôler appels, permissions, budgets et validations, puis produire la trace
Manifest	Relier les tools à leurs handlers et préciser les accès accordés
Provider de décision	Fournir les choix du modèle à partir du contexte et des capacités proposées
Handler	Réaliser une opération externe avec les entrées et accès prévus par son contrat

Le choix du modèle et l’autorisation d’exécuter sont deux étapes distinctes. Les contrôles du runtime s’appliquent aux interfaces de décision structurée et native.

Déclarer le contrat, implémenter l’opération

Le source définit les entrées, la sortie et la capacité requise :

tool SearchDatasets
    takes query as Text
    gives Text
    requires network

Le handler implémente la recherche en JavaScript ou Python. Le manifest associe ce handler au tool et accorde l’accès réseau. Le guide d’un tool réel montre l’ensemble.

Outils de développement

Outil	Usage
CLI Touba	Initialiser, préparer, compiler, exécuter, inspecter et gérer les packages
Touba Language Toolkit	Diagnostics, complétion, navigation et lecture des traces dans VS Code
SDK JavaScript et Python	Écrire des handlers, piloter le même runtime avec ToubaEngine, tester les contrats et intégrer les providers

Les deux SDK partagent les mêmes concepts. Choisissez celui de votre application :

touba sdk install javascript

ou :

touba sdk install python

Consultez les guides JavaScript et Python pour les imports et les API correspondantes.

Composition et réutilisation

Un package peut réunir déclarations Touba, handlers et procédures contextuelles. Les imports rendent ses déclarations accessibles au programme ; les permissions restent définies par le projet qui les utilise.

Les stratégies organisent les appels et les décisions humaines. La composition multi-agents et le parallélisme borné permettent de structurer des traitements plus importants avec des traces et des limites communes.

Pour commencer

Suivez le premier programme, puis configurez l’extension VS Code.