# Omniloq — Phase 1.5 : Résultats **Statut : ✅ 10/10 tests d'acceptation — 23/23 au total (spike + runtime + Phase 1.5)** Phase 1.5 découpe le runtime enrichi en 4 composants, validés chacun par des tests d'acceptation. ## Composants livrés ### 1. ContextBuilder (`packages/core/src/context-builder.ts`) - **Seule porte d'entrée du contexte LLM** : `buildContext({ agentRevision, variables, allMessages, triggerMessage, contactProfile?, recentMessageCount?, maxContextTokens? })`. - Produit `system` (system prompt + variables `{{key}}` substituées + profil contact) et `prompt` (derniers messages sérialisés). - **Règle essentielle respectée** : jamais toute la conversation — `recentMessageCount` (défaut 20) + budget `maxContextTokens` (défaut 8000, estimation ~4 chars/token) qui tronque les plus anciens. - Le summarizer automatique viendra plus tard (budget approximatif pour l'instant). ### 2. ToolPolicy (`packages/core/src/tool-policy.ts`) - `evaluateToolPolicy({ agentTool, mcpServer, callsSoFarThisRun })` → `ALLOW | CONFIRM | DENY`. - Vérifie dans l'ordre : tool enregistré pour l'agent → `enabled` → MCP `enabled` → `maxCallsPerRun` → `requiresConfirmation`/`riskLevel` → ALLOW. - **Le LLM ne décide jamais** si une action a besoin de confirmation : c'est le runtime. ### 3. Confirmation persistante / Resume (`runtime.ts`) - Tool sensible → `ToolCall.status = awaiting_confirmation` (arguments + `confirmationExpiresAt` = 2 h persistés AVANT tout side effect). - Message outbound de confirmation **déterministe** (`buildConfirmationPrompt`), `AgentRun.finishReason = awaiting_confirmation`. - Reprise : nouveau message inbound affirmatif (`oui`, `confirme`, …) + ToolCall pending **non expiré** + même conversation → résolution : `confirmedAt`/`confirmedByMessageId`/`confirmationDecision`, exécution MCP, **nouveau AgentRun**, réponse finale. - Le « oui » ne confirme pas n'importe quel ancien ToolCall : résolution scoped `conversation + pending + non expiré`. ### 4. ResponseGuard (`packages/core/src/response-guard.ts`) - `detectLeak(text)` sur signatures précises (balises ``/``, `let me think`, `chain of thought`, `voici mon raisonnement`, `as an ai`). - **SUSPECT → régénération** (`guardFinalAnswer`), jamais de mutilation regex. False positive ⇒ on régénère (sûr) plutôt que de fuiter. ## Séparation runtime / MCP (point surveillé) ``` AI SDK request tool → wrapper Omniloq → ToolPolicy → ToolCall persistence → MCP ``` Tous les tools exposés au LLM sont des **proxies Omniloq** : aucun MCP n'est appelé directement hors ToolPolicy/ToolExecutor. C'est ce chemin unique qui garantira demain confirmation / quota / billing / timeout / audit / RBAC / idempotency. ## Les 10 tests d'acceptation | # | Test | Vérification | |---|------|--------------| | 1 | Context court construit | 3 messages → tous présents, non tronqué | | 2 | Long historique tronqué | 500 messages → budget respecté, derniers conservés | | 3 | Variables agent | `{{garage_name}}` → `Garage Atlas`, plus de placeholder | | 4 | Tool autorisé | `get_balance` → ToolCall SUCCESS | | 5 | Tool désactivé | refusé SANS appel MCP (DENY, `result` null) | | 6 | maxCallsPerRun | ALLOW sous limite, DENY à la limite + décisions CONFIRM/DENY | | 7 | Tool sensible | `book_appointment` → `awaiting_confirmation`, non exécuté | | 8 | Confirmation ultérieure | `oui` → tool exécuté, **nouveau AgentRun**, `confirmedAt` | | 9 | Confirmation expirée | aucune action métier (reste `awaiting_confirmation`) | | 10 | Réponse suspecte | reasoning → régénération, jamais envoyé brut | ## Fichiers - `packages/core/src/context-builder.ts` - `packages/core/src/tool-policy.ts` - `packages/core/src/response-guard.ts` - `packages/core/src/text.ts` - `packages/core/src/runtime.ts` (intègre les 4 composants + resume) - `packages/core/src/seed.ts` (variable `garage_name` + system prompt) - `packages/core/test/phase15.test.ts` (10 tests) ## Bilan cumulé Runtime ✅ · Persistance ✅ · Context ✅ · Policy ✅ · Confirmation ✅ · Reasoning guard ✅ → **Phase 2 (WhatsApp Meta) devient raisonnable.**