GEODE

1. 01

   AgenticLoop · sei fasicore/agent/loopflusso di dati: batch in attesa · salvataggio del roundSQLite messages · state.jsonmemory/session_checkpoint.py

   In una sessione con checkpointing configurato (un checkpoint e un session id), il batch proposto viene salvato prima che qualsiasi strumento venga eseguito, e il batch non viene eseguito se non può essere salvato. Il batch completato viene salvato di nuovo. I chiamanti senza checkpoint non hanno questa garanzia.

2. 02

   AgenticLoop · sei fasicore/agent/loopflusso di dati: blocchi tool_useToolCallProcessortool_executor/processor.py

   Una proposta del modello non è un permesso. Ogni chiamata riceve un ToolContext con l’identità del modello e dell’adapter del ciclo.

3. 03

   ToolCallProcessortool_executor/processor.pyflusso di dati: aexecuteambito · policy · schematool_executor/executor.py

   Controlla in ordine l’ambito della sessione, le riscritture del middleware delle richieste, la policy e lo schema. Una riscrittura che abbassa il livello di sicurezza o la classe dei dati personali viene negata.

4. 04

   BoundToolPlan · immutabilecore/tools/plan.pyautorità · composizione: consentito · livello di sicurezzaambito · policy · schematool_executor/executor.py

   Gli handler eseguibili e i livelli di sicurezza provengono dal BoundToolPlan proiettato per la sessione.

5. 05

   PreToolUse · PostToolUsetool_executor/executor.pyautorità · composizione: PreToolUse · PostToolUseHookRegistry · decisionicore/hooks

   Gli hook pubblici decidono blocco, riscrittura degli argomenti o richiesta di permesso, e a una riscrittura seguono di nuovo i controlli di ambito, policy e schema. Dopo l’esecuzione, un hook può aggiungere contesto o trattenere il risultato.

6. 06

   approvazione · HITLtool_executor/executor.pyautorità · composizione: richiesta di approvazioneUtente del terminale

   In una sessione IPC la richiesta di approvazione viene inoltrata alla thin CLI. Le modalità senza una persona applicano per impostazione predefinita la policy di rifiuto; l’unica eccezione è il computer use di DAEMON, quando un operatore lo abilita separatamente (altrimenti bloccato).

7. 07

   tool_executor/executor.pyrifiuto prima dell’esecuzione: negato prima dell’esecuzioneToolCallProcessortool_executor/processor.py

   Un rifiuto per ambito, policy o schema, un blocco PreToolUse o un’approvazione negata tornano come risultato d’errore senza dispatch. In quel caso nessun effetto di questa chiamata è iniziato.

8. 08

   effect receipttool_executor/executor.pyflusso di dati: ammissione · conferma dell’effettoEffectReceiptStorememory/effect_receipts.py

   Effetti come modifiche ai file, messaggi in uscita o azioni amministrative vengono ammessi prima dell’esecuzione. Un esito incerto non viene rieseguito; richiede una riconciliazione.

9. 09

   lock delle risorse · dispatchtool_executor/executor.pyflusso di dati: chiamata all’handlerhandler degli strumenti · bash · computercore/tools

   Inoltra all’handler vincolato dopo aver bloccato le sue chiavi di risorsa. Una chiamata interrotta alla scadenza può essere ancora in corso all’esterno.

10. 10

    lock delle risorse · dispatchtool_executor/executor.pyflusso di dati: chiamata MCPMCPServerManagercore/mcp/manager.py

    Vengono chiamati solo gli strumenti MCP con una policy delle risorse dichiarata.

11. 11

    MCPServerManagercore/mcp/manager.pyflusso di dati: tools/callServer MCP

    Il catalogo dei server proviene dalle impostazioni globali e dalle impostazioni di progetto che hanno superato il controllo di attendibilità; tale controllo vale solo per le voci di progetto. Il gestore MCP applica la propria policy di estensioni e risorse.

12. 12

    handler degli strumenti · bash · computercore/toolsflusso di dati: modifiche a file · git · processiFile · git · processi

    Le modifiche eseguite restano come stato esterno. Il checkpoint ripristina solo la conversazione e non le annulla.

13. 13

    tool_executor/executor.pyflusso di dati: risultato · errore dopo il dispatchToolCallProcessortool_executor/processor.py

    Dopo il dispatch, risultati normali ed errori (inclusi timeout ed esiti incerti) tornano tramite PostToolUse. Un errore o un timeout non significa che il lavoro esterno si sia fermato o sia stato annullato.

14. 14

    ToolCallProcessortool_executor/processor.pyflusso di dati: tool_resultmessaggi · ConversationContextcore/agent/loop

    Risultati, rifiuti ed errori vengono tutti serializzati come tool_result e diventano messaggi nel successivo input del modello.

15. 15

    ToolCallProcessortool_executor/processor.pyregistro · osservazione: chiamata · osservazione del risultatoSessionTimeline · append-onlyobservability/session_timeline.py

    Scrive la chiamata e il suo risultato (ok o errore) nella timeline, comprese le chiamate negate prima dell’esecuzione. Il registro è osservazione; non prova che un effetto esterno sia iniziato o riuscito.

1. 01

   AgenticLoop · sei fasicore/agent/loopflusso di dati: batch in attesa · salvataggio del roundSQLite messages · state.jsonmemory/session_checkpoint.py

   In una sessione con checkpointing configurato (un checkpoint e un session id), il batch proposto viene salvato prima che qualsiasi strumento venga eseguito, e il batch non viene eseguito se non può essere salvato. Il batch completato viene salvato di nuovo. I chiamanti senza checkpoint non hanno questa garanzia.

2. 02

   SQLite messages · state.jsonmemory/session_checkpoint.pyflusso di dati: ripristino alla ripresaAgenticLoop · sei fasicore/agent/loop

   Un unico percorso di ripristino riporta messaggi, stato cognitivo e contatori delle guard. Il TaskGraph locale al processo non viene recuperato.

3. 03

   AgenticLoop · sei fasicore/agent/loopregistro · osservazione: registro del turnoSessionTimeline · append-onlyobservability/session_timeline.py

   Una cronologia di esecuzione append-only, mai riprodotta come stato.

4. 04

   AgenticLoop · sei fasicore/agent/loopautorità · composizione: controllo di completamentoverify_turn_asynccore/agent/verify.py

   La proposta del modello di fermarsi diventa completamento solo attraverso Verify.

5. 05

   verify_turn_asynccore/agent/verify.pyautorità · composizione: PostVerify · StopHookRegistry · decisionicore/hooks

   Le decisioni degli hook pubblici stabiliscono se proseguire con una riparazione, e le riparazioni avvengono solo entro un budget fissato (due per impostazione predefinita).

6. 06

   AgenticLoop · sei fasicore/agent/loopregistro · osservazione: righe delle prove · best-effortEvidenceLedger · JSONLagent/evidence_ledger.py

   Righe diagnostiche oscurate. Gli hash servono alla correlazione; una riga non prova che un effetto sia avvenuto, e non viene scritta in un’unica transazione con la timeline o il checkpoint.

7. 07

   AgenticLoop · sei fasicore/agent/loopregistro · osservazione: eventi cognitivi · del ciclo di vitaHookSystem · osservazionecore/hooks

   Gli hook di osservazione ricevono e registrano eventi; non decidono l’esecuzione.

1. 01

   Canale di messaggisticaflusso di dati: messaggio di canalepoller dei messengercore/server

   I poller del daemon serve gestiscono solo i messaggi dei canali vincolati.

2. 02

   poller dei messengercore/serverautorità · composizione: create_session(DAEMON)SharedServices.create_sessionsupervised/services.py

   Una modalità senza una persona che approvi: si applicano la policy di rifiuto predefinita e un budget di tempo. Solo il computer use può essere abilitato separatamente da un operatore; altrimenti resta bloccato.

3. 03

   poller dei messengercore/serverflusso di dati: arun(message)AgenticLoop · sei fasicore/agent/loop

   Un thread mantiene un session id fisso e prosegue un’unica catena di checkpoint.

4. 04

   Host MCP esternoflusso di dati: run_agent(prompt)run_agent · esecuzione singolacore/mcp_server.py

   Un host MCP esterno chiama GEODE come strumento.

5. 05

   run_agent · esecuzione singolacore/mcp_server.pyflusso di dati: ciclo headless a esecuzione singolaAgenticLoop · sei fasicore/agent/loop

   Un esecutore e un ciclo headless costruiti a parte che aggirano SharedServices. La denylist predefinita si applica così com’è, quindi strumenti come run_bash, delegate_task e computer vengono rimossi; l’eccezione di computer use di DAEMON qui non esiste.

Tutte le connessioni con lo stesso peso. Scegliendo un flusso se ne evidenzia solo il percorso, con passi numerati.