Vai al contenuto

Prodotto · il work plane

La metà che non è la mappa degli accessi

Gran parte di questo sito spiega cosa può RAGGIUNGERE un agente. Questa pagina spiega come agenti e sessioni coordinano il lavoro stesso — e fin dove arriva davvero oggi ogni componente.

Perché esiste

La governance senza un work plane è una dashboard senza nulla su cui agire

Olivares AI ha due metà, distribuite nello stesso binario. Una esegue e collega il lavoro; l’altra lo osserva e lo governa. Nessuna è un ornamento dell’altra: un work plane senza governance produce lavoro di cui nessuno può rendere conto in seguito, e la governance senza un work plane è una dashboard senza nulla su cui agire.

Il problema per cui esiste questa metà non è ipotetico. È quello che il progetto ha sofferto durante il proprio sviluppo: sessioni che non riescono a vedersi, stato che diverge tra loro, lavoro eseguito due volte e decisioni che vivono in un terminale e si perdono quando viene chiuso.

Cosa esiste e cosa no

Ogni componente, con la portata che ha davvero

Il confine è imposto nel codice, non promesso nel testo. Quando un componente ha una portata più ristretta dell’idea, la restrizione viene dichiarata qui e un test la mantiene tale.

Work item

Operativo, API pubblica

Un’unità di lavoro con descrizione, provenienza, dipendenze, criteri di accettazione, decisioni, un responsabile e una propria cronologia degli eventi — persistente e guidata da un unico documento di comandi condiviso da REST, CLI e chiamanti nello stesso processo.

modules/sessions/work_model.go · modules/sessions/work_api.go

Lease

Operativo, API pubblica

Titolarità come autorità con scadenza e protetta da fencing: acquisire, rinnovare, rilasciare, subentrare, revocare. Un titolare con lease obsoleto non può continuare ad agire su un work item, e un’acquisizione concorrente produce esattamente un vincitore.

modules/sessions/work_lease.go

Messaggi, conferme e passaggi di consegne

Operativo, volutamente circoscritto

Conversazione persistente legata a un work item, con replay e rifiuto degli epoch obsoleti. Vale la pena soffermarsi sulla conferma: il coordinamento si interrompe molto più spesso perché un messaggio è stato visto ma non ha prodotto un’azione che perché non è mai stato consegnato; «letto» e «risposto» smettono di essere la stessa cosa.

Reale ALL’INTERNO di un workflow di orchestrazione. La casella di posta generale e trasversale è volutamente lasciata non collegata, e questo viene imposto anziché promesso: un test di avvio fissa le fonti di autorità a cui l’avvio si collega e il loro ordine, e fallisce su ognuna delle quattro attivazioni preparatorie note. Non è un’allowlist esaustiva — un percorso futuro con un selettore diverso richiederebbe un proprio caso —, ma collegare per errore uno di quei percorsi predisposti rende rosso il test, invece di creare una sorpresa in produzione.

modules/sessions/communication_model.go (le strutture) · communication_ack_service.go e communication_ack_apply.go (il percorso della conferma e i relativi controlli dell’epoch) · cmd/olivares/communicationauthorityboot_test.go (il test di avvio che mantiene scollegato il piano pubblico)

Avvio per un work item

Operativo, volutamente circoscritto

Prenotare, acquisire il lease e solo DOPO avviare la sessione — rendendo persistenti lavoro, epoch, fence ed esecuzione, affinché un nuovo tentativo sia sicuro invece di diventare una seconda esecuzione.

Tramite l’orchestrazione, non come punto di ingresso autonomo.

modules/sessions/runtime_work_launch.go

Esecuzione remota tramite A2A

Operativo, volutamente circoscritto

Pianificare, testare, avviare, osservare e annullare il lavoro su un peer autorizzato, con ricevute persistenti di ciò che è stato delegato e di ciò che è tornato.

Montato SOLO quando è configurata una destinazione. Senza un target autorizzato, il punto di collegamento non viene montato affatto — non esiste un percorso che invii lavoro a un peer arbitrario solo perché un file di configurazione lo chiede gentilmente.

cmd/olivares/wire.go · cmd/olivares/orchremote.go

Shadow mode e autorità finale sul lavoro

Assente; non implementato

Doppio reporting rispetto al sistema che già usi, con un comparatore, prima che il work plane diventi quello che decide.

NON significa «prossimamente» né «parziale»: è assente. Oggi un deployment non può dare al work plane l’ultima parola su una sessione, e nulla nel prodotto deve essere interpretato come se offrisse questa capacità. Se mai verrà realizzato, arriverà con le prove del suo funzionamento: una finestra di confronto con le fonti esistenti, non un cambio di versione.

solo progettazione

Come leggere questa pagina

La versione onesta degli «agenti che parlano tra loro»

Work item e lease sono normali superfici API che puoi usare oggi. La conversazione tra agenti è reale e persistente, ma limitata a un workflow di orchestrazione: non esiste un bus di messaggi generale per agenti arbitrari. La delega remota funziona e rifiuta i peer sconosciuti.

Ciò che non esiste non è indicato come «prossimamente» nell’interfaccia. È indicato qui sopra come assente. L’alternativa ti costerebbe il pomeriggio impiegato a scoprirlo durante l’integrazione, proprio il tipo di affermazione che questo progetto si rifiuta di fare: consulta il Centro di fiducia e scopri come viene governato Claude Code.