Salta al contenuto
ColliePWA

23/Documentation

Terminologia

I termini di Collie spiegati in modo semplice, a confronto con i nomi usati da altri strumenti: sessione, spazio, scheda, riquadro, terminale, agente durevole, harness, crew, lead e altro

I termini usati da Collie, spiegati in modo semplice. Ogni voce è breve e rimanda alla pagina dedicata. Se un altro strumento usa un termine diverso per lo stesso concetto, la voce lo segnala.

Collie (un'istanza)

Un processo bridge in esecuzione. Gestisce un singolo URL per il telefono, monitora un terminale e può mostrare durable agent al suo fianco. Un host può eseguirne più di uno, ciascuno con la propria porta e cartella di stato (Più istanze di Collie su un unico host).

Sessione

Una singola conversazione con l'agente. Un riquadro la mostra e Chat la legge dall'harness (Sessioni). Anche tmux e zellij chiamano sessione il proprio gruppo di livello superiore. Collie mostra tale gruppo come spazio.

Spazio

Un gruppo di schede, associato a una cartella. È il livello superiore sul telefono. Un'area di lavoro Herdr è uno spazio, una sessione tmux è uno spazio, una sessione zellij è uno spazio e un durable agent è uno spazio.

Scheda

Un gruppo di riquadri. Una scheda Herdr è una scheda, e una finestra tmux è una scheda (Terminali).

Riquadro

Un elemento visualizzabile sul telefono. In un terminale è un riquadro con uno schermo. In un durable agent è una singola conversazione e si apre soltanto in Chat.

Terminale (mux)

Herdr, tmux, zellij, tuios o Tern: il programma che ospita shell e agenti. Altri strumenti lo definiscono multiplexer o mux. Si sceglie tramite COLLIE_MUX (Terminali).

Durable agent

Un agente eseguito come processo indipendente, dotato di archiviazione propria. Si collega a Collie tramite il protocollo wire del durable agent. Si crea con il Durable SDK o con qualsiasi programma che implementi tale protocollo. Definisce autonomamente spazi, schede e riquadri. È sperimentale e si collega con collie durable attach (Agenti durevoli). Una sessione può essere una sessione di terminale o una sessione durable. L'API e il codice utilizzano ancora il termine program per il canale.

Harness

L'agente in esecuzione in un riquadro: Claude Code, Codex, pi, OmO o un durable agent (Claude Code sul proprio telefono).

Crew

Il lead e i suoi membri. Fornisce un unico URL per il telefono valido per più macchine (Crew). Una singola macchina non richiede una crew per mostrare un terminale e un durable agent insieme.

Lead

L'istanza Collie con cui comunica il telefono. Unisce gli elenchi dei suoi membri e ritrasmette i relativi riquadri (Crew).

Membro (peer)

Un'istanza Collie che si è unita a una crew. I due termini sono equivalenti. "Membro" è il termine usato dalla crew, mentre "peer" indica un'istanza Collie in esecuzione accanto a un'altra (Crew).

Scheda della domanda (ask)

Una richiesta generata da un durable agent. Il telefono la mostra come scheda e un singolo tocco consente di rispondere. Collie non risponde mai automaticamente (Agenti durevoli).

Cintura

La riga di azione sopra il composer. La sua sezione harness contiene i pulsanti specifici dell'harness (Configurazione).

Starter

Una riga nella pagina New che crea un nuovo pannello in un agente permanente (Starter da un agente permanente).

Sorgente

Il termine usato da sources.json per la voce di un agente permanente. Si trova solo nel nome di quel file e nei relativi campi. Nulla sul telefono riporta "source"; il telefono indica durable agent (Collegare un agente durevole).

Massimale

Un'azione che un agente permanente dichiara di poter compiere: asks, starters, send, steer, abort, rename, close, actions, history o reopen. Il telefono mostra un controllo solo per le funzionalità dichiarate dall'agente permanente. Anche i limiti di push sono chiamati cap, ma si tratta di un concetto differente (Notifiche push da un durable agent).

Hello

La prima informazione che un agente permanente trasmette a Collie: le versioni del protocollo wire supportate, le sue funzionalità e il suo nome. Collie ignora i dati successivi di un agente permanente le cui versioni non sono compatibili con le proprie (Versioni). Una connessione crew include un proprio hello, scambiato tra un lead e un membro (Crew).

Epoch

Un'etichetta generata da un agente permanente a ogni avvio. Una posizione all'interno di una conversazione è valida solo all'interno della stessa epoch. Quando l'epoch cambia, Collie rilegge la conversazione dall'inizio (Agenti durevoli).

Ricevuta

La registrazione di un'operazione richiesta da un telefono a un agente permanente: una risposta, un invio, un arresto o la selezione di uno starter. Contiene l'ID della richiesta e l'esito, e consente di ripetere l'operazione senza eseguirla due volte. Collie memorizza le ricevute nella propria cartella di stato (Dove Collie conserva i dati di un durable agent).

Conversazione

Il modo in cui le pagine Durable agents del telefono identificano un elemento permanente sessione. L'elenco delle conversazioni mostra prima gli elementi in attesa di risposta, poi gli altri aperti e infine quelli chiusi (Cosa mostra il telefono).

Sezione Agenti permanenti

Il gruppo nel dashboard che elenca ciascun agente permanente, uno per riga. Si sposta sopra gli spazi quando è presente una domanda in attesa, e non mostra alcun elemento se non è collegato alcun agente permanente (Cosa mostra il telefono).

Wire

Le regole utilizzate per la comunicazione tra Collie e un agente permanente: un hello, seguito da snapshot, eventi e risposte. Attualmente esiste una sola versione, la versione 1. Viene eseguito su un socket privato o su https tramite token (Versioni).

Modifica questa pagina su GitHub

The rest of the documentation