9. High-Level Design (HLD)

L'Architecture "Ombre Riche" (Rich Shadow)

Le framework ECHO repose sur un constat critique audité sur l'architecture standard : l'historique des messages est volatil. Les interfaces de chat "nettoient" systématiquement les injections faites par les filtres avant de stocker les messages en base de données.

Pour garantir que Gemini conserve une mémoire parfaite (Smart Context, Raisonnement CoT, Artefacts), ECHO implémente une Ombre Riche : un miroir haute-fidélité de la session stocké dans une base SQLite locale (user-XXX.db), capable de "réparer" l'historique avant chaque envoi à l'API Gemini.

Diagramme de Flux de la Suture Cognitive

Le diagramme ci-dessous illustre le parcours d'une requête et la reconstruction du contexte bit-perfect.

sequenceDiagram participant U as Utilisateur participant F as Filtre (Inlet) participant O as Open WebUI participant P as Pipe (Moteur) participant B as SQLite ECHO participant G as API Gemini U->>F: Envoi Message + Fichiers F->>F: Calcul Invariant Hash F->>F: Aiguillage (Smart Context) F->>O: Payload + Metadata (InvHash) O->>P: Historique Volatil + Metadata P->>B: Restauration du Passé (Cumulative Hash) P->>P: Suture Bit-Perfect (Signatures, Outils) P->>G: Payload Gemini Normalisé G->>P: Stream Réponse + Thought + Signature P->>U: Affichage Temps Réel P->>B: Archivage Suture Riche (Fin de tour)

Infrastructure de Données & Moteur de Hachage

Situé dans : 14-owui-libs/echo_utils.py (Classe EchoStateManager)

Le Schéma SQL (Tables Spécialisées)

suture_index : PK cumulative_hash. Lie un point temporel à un contenu riche.
rich_payloads : PK invariant_hash. Stocke les contenus lourds (Résumés, Base64) de façon factorisée (déduplication).
cognitive_signatures : PK cumulative_hash. Stocke les thoughtSignature de Google (Ancres logiques).
tool_journal : PK cumulative_hash. Stocke les entrées/sorties des outils (functionCall).

Les Algorithmes de Hachage (Blockchain-like)

1. Invariant Hash : calculate_invariant_hash(role, content, files)
Crée une empreinte unique du message "propre" (Hash du rôle + texte brut + IDs de fichiers triés). Utilisé pour identifier la source sémantique d'un message.

2. Cumulative Hash : calculate_cumulative_hash(invariant, parent_hash)
Crée une chaîne cryptographique. (Hash de l'invariant actuel + hash cumulatif du message précédent). Permet de détecter instantanément le Branching (édition d'un message passé).