7h. ECHO Codex — Éditeur de Code Souverain

ECHO Codex est un environnement d'édition de code complet, entièrement intégré dans Open WebUI. Il associe un éditeur Monaco (le même moteur que VS Code) à un dépôt Git local (via dulwich, Python pur, sans binaire Git externe) et à une assistance AI (sous-chat Gemini via call_cascade()). Chaque conversation dispose de son propre espace de stockage isolé, persistent et versionné.

Stockage — Le Vault Codex

Chaque conversation dispose d'un dépôt Git dédié, isolé dans le Vault utilisateur :

/app/backend/data/users/{user_id}/files/codex/{chat_id}/
├── .git/           ← Dépôt Git dulwich (Python pur, pas de binaire git requis)
├── mon_script.py
├── config.yaml
└── README.md

La constante CODEX_DIR_NAME = "codex" (echo_constants.py) définit le nom du sous-dossier. L'isolation est garantie par user_id et chat_id : un utilisateur ne peut jamais accéder au Codex d'un autre, ni à celui d'une autre conversation.

Registre SQLite — codex_docs

Chaque fichier créé ou modifié est enregistré dans la table codex_docs de la base {chat_id}.db (EchoStateManager). Ce registre sert à deux fins : injection dans le vecteur proprioceptif (registre_codex) et statistiques rapides sans accès disque.

Classe CodexRepo (echo_codex_git.py)

Abstraction autour de la bibliothèque dulwich (implémentation Python pure de Git). Elle évite toute dépendance à un binaire git dans le conteneur.

Opérations CRUD

Historique Git

Administration

Outil LLM — echo_codex_tool.py (9 fonctions)

Ces fonctions sont exposées à Gemini comme Tool Calls. Le modèle peut les invoquer autonomement pendant une conversation pour interagir avec les fichiers du Codex.

Distillation dans summarize_codex

summarize_codex appelle EchoGeminiClient.call_distillation() avec le prompt CODEX_SUMMARIZE_PROMPT (défini dans echo_constants.py). La sortie est limitée à 8192 tokens.

1. Objectif et rôle du fichier
2. Architecture : classes, fonctions, structures principales
3. Dépendances et imports
4. Patterns et conventions utilisés
5. Points d'attention, complexité, dette technique éventuelle

Action HUD — echo_codex_action.py (v1.8)

L'Action ECHO Codex injecte un éditeur Monaco complet directement dans le DOM d'Open WebUI. C'est un HUD draggable et redimensionnable qui communique en temps réel avec le backend Python via le Pattern Promise (__event_call__).

Architecture HUD

Le HUD est généré par EchoUI._generate_codex_js() (echo_ui.py). Il s'agit d'un script JS auto-exécutable (IIFE) injecté une seule fois dans le DOM, qui charge Monaco Editor depuis CDN (monaco-editor@0.52.0 sur jsDelivr).

Boucle événementielle bidirectionnelle

La boucle Python est une boucle while True bloquée sur une Promise JS. Chaque interaction utilisateur dans le HUD résout la Promise et renvoie un dictionnaire { action: "...", filename: "...", content: "...", ... } au backend Python.

Édition AI — _codex_ai_edit()

La méthode privée _codex_ai_edit() orchestre un sub-chat dédié (sans historique, sans pensées) pour modifier le code. Elle retourne (texte_modifié, model_key_effectif) ou None en cas d'échec.

## Document complet
```{lang}
{content complet du fichier}
```

## Sélection ciblée   ← uniquement si l'utilisateur a sélectionné du texte
```{lang}
{selection}
```

## Instruction
{instruction de l'utilisateur}

Le système prompt (CODEX_EDIT_SYSTEM_PROMPT dans echo_constants.py) impose au LLM de retourner uniquement le fichier complet modifié, sans explication, sans bloc Markdown enveloppant. Le code Python nettoie les backticks parasites résiduels. La cascade (call_cascade()) gère le clamping politique et le basculement LITE/FLASH/PRO selon la disponibilité des modèles.

Actions rapides prédéfinies (CODEX_QUICK_ACTIONS)

L'utilisateur peut déclencher des transformations courantes via des boutons dans le panneau AI, sans rédiger d'instruction manuelle. Ces raccourcis sont définis dans echo_constants.py :

API JS globale (callable depuis Python)

Le HUD expose ses fonctions de contrôle sur window pour être appelées depuis les pushes Python via __event_call__({ type: "execute", data: { code } }) :

Proprioception — registre_codex

Le Filtre (new_context_filter.py v7.12) injecte automatiquement un registre des fichiers Codex dans le vecteur d'état environnement_contexte (AEC) à chaque tour de conversation. Gemini dispose ainsi d'une vue à jour de l'état du Codex sans avoir à appeler list_codex.

registre_codex:
  - id: "mon_script.py"
    lang: "python"
    lines: 142
    last_commit: "feat: add error handler"
  - id: "config.yaml"
    lang: "yaml"
    lines: 38
    last_commit: "chore: update timeout"

Tableau récapitulatif des composants