blomios/IdeA
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
9000b4d09f7d803d0be466de17a3918822522ad8
IdeA/.ideai/memory/session-limit-handling-design.md
Blomios fa5b826df5 docs(session-limits): cadrage Architect — gestion des limites de session des agents 
Pose le cadrage de la feature « Gestion des limites de session des agents »
avant tout code (lots LS1→LS8) :
- ARCHITECTURE.md §21 : détection hiérarchique des limites de session +
  reprise auto annulable (domaine → adapter Claude → port Scheduler →
  service → parser regex → filet humain → app-tauri → frontend) ; état en
  mémoire uniquement, aucun schéma de persistance modifié.
- .ideai/memory/session-limit-handling-design.md : design validé.
- .ideai/memory/MEMORY.md : pointeur vers le design.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-16 14:25:05 +02:00

2.7 KiB
Raw Blame History

name, description, metadata
name description metadata
session-limit-handling-design Design valide pour la detection des limites de session des agents et la reprise auto a la levee.
type
project

Feature : detecter quand un agent IA est en limite de session (et jusqu'a quelle heure), puis reprendre ou il en etait une fois la limite levee. Cadree le 2026-06-16.

Constat dur : l'heure exacte de reset n'existe nulle part de facon universelle (ni OS, ni code de sortie, ni API inter-modeles) — elle est fabriquee par le fournisseur et seulement exposee dans le flux de sa CLI. Donc « 100% fiable + zero dependance modele + heure exacte » sont incompatibles simultanement ; on vise le meilleur compromis via un detecteur hierarchique.

Solution retenue — detecteur hierarchique calque sur la hierarchie de readiness existante (remaining-work-idea-agent-control-ide) :

  • Niveau 1 (solide) : l'adapter structure extrait limite + reset du flux machine. Pour Claude, rate_limit_event.rate_limit_info est DEJA parse dans infrastructure/session/claude.rs mais jete (reduit a Heartbeat) — il suffit de lire resetsAt.
  • Niveau 2 (configurable) : champ de profil rate_limit_pattern (regex + capture heure) pour agents PTY/TUI sans adapter structure, dans la lignee des profils declaratifs §9.
  • Niveau 3 (filet humain) : si rien ne matche mais agent Stalled (deja prevu dans domain/readiness.rs), IdeA DEMANDE a l'utilisateur. Garantit le « 100% meme pour un novice » : jamais d'inaction silencieuse.

Model-agnostic tenu AU DOMAINE : le domaine ne connait que RateLimited { until: Option<Instant> }. Le savoir specifique modele est confine aux adapters/profils (philosophie §9).

Reprise = partie facile et deja model-agnostique : pivot sur conversation_id du moteur + --resume natif (deja cable dans session/claude.rs + agent/resume.rs) qui portent tout l'historique. Pas de reconstruction manuelle fragile.

Decisions produit verrouillees (2026-06-16) :

  • Reprise : AUTOMATIQUE a l'heure de reset, ANNULABLE (fenetre + notification).
  • Couverture : les TROIS niveaux d'emblee (incl. repli regex niveau 2).
  • Etat : EN MEMOIRE uniquement (pas de persistance de SessionLimit). Consequence assumee : le reveil auto ne joue que tant qu'IdeA reste ouvert ; si l'IDE est ferme/rouvert apres le reset, le chemin existant ListResumableAgents (agent_was_running/conversation_id) prend le relais.

Decoupage (cycle dev/test §3) : 1) domaine (variante ReplyEvent::RateLimited, ReadinessSignal::RateLimited, etat SessionLimit) ; 2) adapter Claude (extraire resetsAt) ; 3) profil (rate_limit_pattern) ; 4) application (planificateur de reprise sur le port Clock) ; 5) UI (badge « limite jusqu'a HH:MM » + filet humain).