blomios/IdeA
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
00bda6a988b8d52490d55b04af5008ed1cde4292
IdeA/.ideai/briefs/d4-commandes-bridge-chat.md
Blomios f4d5727a69 feat(agent): commandes Tauri + ChatBridge streaming (D4) — §17 
Expose l'exécution structurée à l'UI (jumeau du chemin PTY) :
- ChatBridge (chat.rs) : pompe ReplyStream -> Channel<ReplyChunk>,
  generation-tracked (anti-double-pompe) ; scrollback de conversation
  côté transport (le port AgentSession est sans mémoire), purgé à la
  fermeture, préservé à la ré-attache.
- Commandes agent_send / reattach_agent_chat / close_agent_session.
- DTO : ReplyChunk (textDelta/toolActivity/final, camelCase tagué kind),
  ReattachChatDto, CellKind {pty,chat} + champ cellKind dérivé sur
  TerminalSessionDto (chat ssi LaunchAgentOutput.structured = Some).
- Wiring composition root : StructuredSessions + ChatBridge dans AppState,
  via la factory déjà injectée (aucun new d'adapter — règle D §17.8).
- From<AgentSessionError> for AppError (mappe sur PROCESS).

Tests (QA) : 35 unitaires verts — generation supersede validé par mutation
test, séquence deltas*+Final, reattach sans re-spawn, teardown shutdown+
unregister, DTO cellKind + round-trip ReplyChunk, non-régression PTY.
cargo test --workspace : 803 passed, 0 failed.

Reste D5 : AgentChatView (frontend) + routage cellKind dans LayoutGrid.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-09 23:15:08 +02:00

5.2 KiB
Raw Blame History

Brief Dev — Lot D4 : commandes Tauri + bridge chat (§17.9)

Demandé par Main à DevBackend (dev) + QA (test). Cycle §3 : code → tests → vert. Périmètre backend uniquement (app-tauri). Le frontend chat est D5, hors périmètre ici.

0. Où on en est

Le fil §17 (exécution structurée des agents IA via le port AgentSession) est livré jusqu'à D3 inclus :

  • D0/D1 (5e10b5e) : port domain::ports::AgentSession + AgentSessionFactory, ReplyEvent/ReplyStream/AgentSessionError, champ AgentProfile.structured_adapter, registre StructuredSessions, agrégateur LiveSessions, helper send_blocking.
  • D2 (751d94d) + spikes S1/S2 (f104862) : adapters ClaudeSdkSession / CodexExecSession dans crates/infrastructure/src/session/, fake CLI + harnais de conformité, formats réels Claude stream-json / Codex exec --json câblés.
  • D3 (56913b9) : LaunchAgent route structuré vs PTY ; LaunchAgentOutput porte désormais structured: Option<StructuredSessionDescriptor>.

D4 = exposer tout ça à l'UI : commandes Tauri + pont de streaming, jumeau exact du chemin PTY existant. Aucun chemin PTY (terminal non-IA) ne doit changer ni régresser.

1. Périmètre D4 (réf. §17.7 et tableau §17.9)

À livrer dans crates/app-tauri/src/ :

  1. ChatBridge — jumeau de PtyBridge (crates/app-tauri/src/pty.rs), generation-tracked (même mécanique de génération pour éviter la double-pompe lors d'une ré-attache). Il pompe un ReplyStream (events ReplyEvent du port) vers un tauri::ipc::Channel, en émettant des ReplyChunk (DTO ci-dessous). Vit à côté de PtyBridge, ne le remplace pas.
  2. Commandes Tauri :
    • agent_send(sessionId, prompt) → pompe les ReplyEvent du tour sur le Channel (deltas TextDelta → chunks, ToolActivity → chunks d'activité, Final → chunk final qui fige le tour). S'appuie sur le registre StructuredSessions / send_blocking côté application (déjà livré en D1).
    • reattach_agent_chat(...) → renvoie le scrollback de conversation + rebranche le Channel (repeint sans re-spawn ; supersede l'ancienne génération).
    • close_agent_session(sessionId) → shutdown (polymorphe) + unregister du registre.
  3. DTO (crates/app-tauri/src/dto.rs) :
    • ReplyChunk : variantes delta texte / activité outil / final (sérialisation camelCase, cohérente avec les DTO existants).
    • ReattachChatDto.
    • cellKind ajouté au DTO de session (terminal pty vs chat chat), dérivé de la présence d'un descripteur structuré (LaunchAgentOutput.structured).
  4. Wiring composition root (state.rs/lib.rs) : injecter les dépendances nécessaires, enregistrer les nouvelles commandes. Aucun new ClaudeSdkSession ici — passe par la factory déjà injectée (règle D du §17.8).

2. Contrat / invariants à respecter

  • Generation supersede : une ré-attache invalide l'ancienne pompe ; pas de double émission.
  • cellKind est la seule info dont D5 (frontend) a besoin pour router cellule chat vs terminal. Stable et explicite au DTO.
  • Isolation parsing : D4 ne parse aucun format CLI — il consomme des ReplyEvent typés.
  • Zéro régression PTY : le chemin terminal brut (PtyBridge, commandes terminal) reste identique. Les tests PTY existants restent verts.
  • Frontières hexagonales (§17.8) : app-tauri dépend des ports/registres application, jamais des adapters infra concrets.

3. Tests attendus (QA — réf. colonne « Tests attendus » D4 du §17.9)

Crate app-tauri (fakes pour la session structurée, pas de vrai CLI) :

  • agent_send pompe les events d'un tour sur le Channel (séquence deltas… puis Final).
  • ré-attache → scrollback conversation repeint, sans re-spawn de session.
  • close_agent_session → shutdown appelé et unregister du registre.
  • generation supersede : après ré-attache, l'ancienne génération ne pompe plus (pas de double émission sur le Channel).
  • DTO : cellKind = chat pour une sortie LaunchAgentOutput avec structured: Some(..), pty sinon ; round-trip ReplyChunk (camelCase).
  • non-régression : un DTO de session PTY existant sérialise toujours pareil (le nouveau champ cellKind ne casse pas les snapshots — vérifier la valeur par défaut/dérivée).

4. Méthode

Cycle §3 strict : DevBackend code → QA écrit + exécute les tests → vert avant de clore. Rapport d'erreurs clair si rouge → correction → re-test. Commit feat(agent): … (D4) — §17 quand cargo test --workspace est vert. Ne pas push (validation Main requise).

5. Références code

  • Jumeau à copier : crates/app-tauri/src/pty.rs (PtyBridge, generation tracking).
  • Source du flux : domain::ports::{AgentSession, ReplyEvent, ReplyStream} ; registre/send_blocking : crates/application/src/agent/structured.rs.
  • Routage déjà fait : crates/application/src/agent/lifecycle.rs (LaunchAgentOutput.structured).
  • DTO existants : crates/app-tauri/src/dto.rs ; commandes : crates/app-tauri/src/commands.rs.
  • Spec complète : ARCHITECTURE.md §17.7 (commandes & DTO) et tableau §17.9 ligne D4.