affe-agent

affe-agent est une bibliothèque TypeScript qui sert de noyau d'exécution d'agents natif Effect, se plaçant entre les primitives LanguageModel, Prompt, Tool et Toolkit d'Effect AI et la couche applicative. Elle fournit la couche de sessions, runs, turns, steering, follow-ups, interruptions et événements de cycle de vie que les applications d'agents réinventent généralement. Le modèle central est sessions → submissions → runs → turns, avec une unique histoire canonique en ajout seul (append-only) et des événements de cycle de vie typés. Le noyau est petit et extensible grâce à une poignée de points d'extension (seams) : toolkit/tools, contextTransform, loop, permission, toolExecution, elicitation, InputChannel, eventSink/events, AgentSessionHost, LanguageModel et Sandbox. Les batteries se branchent sur ces points d'extension pour ajouter des fonctionnalités sans modifier le cœur. Les principales fonctionnalités incluent : - Transports multiples : HTTP, RPC, AG-UI, A2A, MCP (v1 et v2), complétions compatibles OpenAI et connecteurs (Slack) - Batteries pour le codage (outils fichier/shell sur un sandbox), le web (recherche, fetch protégé, capture de pages rendues), les sous-agents, la mémoire, les skills, la compaction, le budget (plafonds de tokens et monétaires), les métadonnées de modèle, l'observabilité, le masquage de données (redaction), les données, les hooks, la planification, l'arbre (sessions ramifiables), les sessions (répertoire paginé), l'export (snapshot et JSONL), le stockage blob, les plugins et les presets - Exécution durable via Effect Workflow, avec prise en charge des clusters et Durable Streams - Abstraction de sandbox avec des implémentations portables et locales (Node) - Utilitaires de test incluant un TestLanguageModel scripté, AgentProbe, des doubles web et des suites de conformité - Portabilité d'exécution sur Node, Bun, Deno et les runtimes edge (Cloudflare Workers) La bibliothèque est en version 0.0.1 (pré-version). La conception est stable, mais le substrat Effect v4 sous-jacent est encore au stade de release candidate ; des remaniements d'API provenant d'Effect sont donc à attendre jusqu'à la GA. Le projet recommande de fixer ensemble des versions exactes de affe-agent, effect et des fournisseurs @effect/ai-*. Le dépôt inclut également des applications de référence : une TUI de codage locale en plein écran, un client CLI classique et un déploiement Cloudflare Worker avec un Durable Object par session.