This commit is contained in:
71
.ideai/tickets/157/carnet.md
Normal file
71
.ideai/tickets/157/carnet.md
Normal file
@ -0,0 +1,71 @@
|
||||
---
|
||||
issueRef: "#157"
|
||||
version: 9
|
||||
updatedBy: {"kind":"agent","agent_id":"1ff94b51-3e17-4a39-8543-7715d1ff0f80"}
|
||||
updatedAt: 1786014830849
|
||||
---
|
||||
# Objectif
|
||||
|
||||
Améliorer la CLI custom / chat agent pour afficher **un maximum de progress intermédiaires réellement disponibles** au lieu d'un silence jusqu'au `Final`, avec une UX différenciée pour :
|
||||
|
||||
- les messages/progress agent généraux
|
||||
- les appels MCP / outils
|
||||
- les délégations inter-agent
|
||||
|
||||
# Dépendance
|
||||
|
||||
- Dépend explicitement de #156, qui doit fournir le contrat d'événements canonique multi-profils.
|
||||
|
||||
# Attentes produit
|
||||
|
||||
- Afficher les événements intermédiaires au fil de l'eau quand ils existent.
|
||||
- Montrer clairement quel agent parle à quel agent.
|
||||
- Afficher un extrait court de la demande déléguée.
|
||||
- Rendre les appels MCP/outils visuellement distincts du reste du flux.
|
||||
- Fonctionner avec un maximum de profils IA, avec dégradation élégante quand un profil n'expose pas grand-chose.
|
||||
|
||||
# Périmètre UI/UX attendu
|
||||
|
||||
## Types visuels
|
||||
|
||||
- `AgentMessage` : message/progress principal d'un agent.
|
||||
- `Delegation` : carte dédiée `Agent A -> Agent B` avec extrait court de la demande.
|
||||
- `ToolCall` : carte secondaire/indentée pour les appels d'outil.
|
||||
- `MCPEvent` : variante spécifique pour les appels MCP/méthodes MCP, distincte visuellement.
|
||||
|
||||
## États
|
||||
|
||||
- `started`
|
||||
- `running`
|
||||
- `done`
|
||||
- `error`
|
||||
|
||||
## Hiérarchie visuelle
|
||||
|
||||
- Les délégations et appels MCP ne doivent pas se confondre avec un simple texte agent.
|
||||
- Les appels MCP/outils doivent être lisibles mais plus discrets que le message principal.
|
||||
- Prévoir la lecture d'une conversation longue sans transformer l'écran en log brut.
|
||||
|
||||
# Recommandations UX initiales (retour UX intégré)
|
||||
|
||||
- `Delegation` : carte avec flèche `From -> To`, extrait de demande tronqué (~80 chars), accès au détail sur expansion/hover.
|
||||
- `ToolCall` : carte indentée avec badge outil, état spinner/check/error, args résumés/tronqués.
|
||||
- `MCPEvent` : bordure latérale/coloration dédiée par serveur ou type de méthode.
|
||||
- Timeline verticale légère pour relier visuellement les sous-événements au message/agent source.
|
||||
- Les événements très courts doivent être lissés/batchés pour éviter le clignotement.
|
||||
|
||||
# Anti-bruit / garde-fous
|
||||
|
||||
- Ne pas afficher comme texte brut tous les micro-événements sans hiérarchie.
|
||||
- Seuil temporel ou batching pour les événements trop fugitifs.
|
||||
- Possibilité de collapse/groupement pour tool calls répétitifs.
|
||||
- Limitation du nombre d'événements visibles avant expansion.
|
||||
- Si un profil n'expose aucun delta ni événement intermédiaire, afficher au minimum l'état occupé/vivant sans simuler un faux stream.
|
||||
|
||||
# Critères d'acceptation
|
||||
|
||||
- Sur les profils riches, l'utilisateur voit les progress/events apparaître avant le `Final`.
|
||||
- Sur les profils pauvres, l'UI reste honnête et utile (busy/progression minimale) sans faux "thinking".
|
||||
- Les appels MCP apparaissent au fil de l'eau, pas seulement après le `Final`, si l'information est disponible côté IdeA.
|
||||
- Les délégations inter-agent sont lisibles : on comprend qui parle à qui et à propos de quoi.
|
||||
- La vue reste stable et lisible sur conversation longue.
|
||||
17
.ideai/tickets/157/issue.md
Normal file
17
.ideai/tickets/157/issue.md
Normal file
@ -0,0 +1,17 @@
|
||||
---
|
||||
id: "d49aaae5-0d03-43fe-a51c-2ab5e921045c"
|
||||
number: 157
|
||||
title: "CLI custom: surface all available agent progress, MCP activity, and inter-agent delegation flow"
|
||||
status: "closed"
|
||||
priority: "high"
|
||||
sprint: null
|
||||
links: [{"target":"#156","kind":"dependsOn"}]
|
||||
agentRefs: [{"agentId":"8f7da528-58df-4315-97e9-0562230ecc19","role":"assigned"}]
|
||||
attachments: []
|
||||
createdBy: {"kind":"agent","agent_id":"a6c6ea12-bfc6-4bdc-8031-324102dfa34d"}
|
||||
updatedBy: {"kind":"agent","agent_id":"1ff94b51-3e17-4a39-8543-7715d1ff0f80"}
|
||||
createdAt: 1785965383914
|
||||
updatedAt: 1786014830849
|
||||
version: 9
|
||||
---
|
||||
User-facing feature for the custom CLI/chat surface: expose as much intermediate agent progress as available, distinguish MCP/tool activity visually from regular progress, show which agent is talking to which agent, and display a short excerpt of delegated requests. Must work across as many AI profiles as possible and degrade gracefully when a profile exposes only limited intermediate events.
|
||||
Reference in New Issue
Block a user