Sequenza runtime del core ThothII

Sequenza runtime del core ThothII A sequence diagram generated by Archify. domanda o decisione gate POST /sessions o /response sessionNew o sessionShow/reopen manifest, artifact e ledger createFor + bind; configure + searchPack configure(...) e searchPack(...) terminano in parallelo prima dell’avvio del modello. /nuova-domanda o /riprendi-sessione In ripresa usa /riprendi-sessione <id> dopo aver riletto provider, modello e thinking dal manifest. turno modello; token e tool call comandi phase / session / evidence legge/scrive artifact e ledger Il workspace persistito è la verità; DWH è read-only e Qdrant serve il retrieval. text_delta / ui_request SSE via SseHub: text · info · widget testo o widget di revisione Avvio o ripresa Turno Pi e workflow persistito Evento SSE e gate umano Revisore · browser · Sequence participant Revisore browser Frontend · React + SSE · Sequence participant Frontend React + SSE Core API · Fastify + SseHub · Sequence participant Core API Fastify + SseHub Runtime · manager + bridge · Sequence participant Runtime manager + bridge Pi + tht-gate · RPC per sessione · Sequence participant Pi + tht-gate RPC per sessione Modello AI · provider configurato · Sequence participant Modello AI provider configurato tht CLI · workflow persistito · Sequence participant tht CLI workflow persistito Stato e dati · workspace + dati · Sequence participant Stato e dati workspace + dati Legend request return default message

Bootstrap

  • • La sessione viene persistita prima dell’avvio di Pi; configurazione e retrieval terminano prima del primo prompt.
  • • La ripresa rifiuta sessioni finalizzate o archiviate e usa sempre /riprendi-sessione <id>.
  • • Il modello propone; il revisore decide tramite reviewer_select, reviewer_decide o reviewer_confirm.
  • • La risposta percorre POST /sessions/:id/response → bridge.respond → extension_ui_response; stale/duplicate ricevono 409.
  • • La fase avanza solo dopo append della decisione esplicita e fold del ledger persistito.