23/Documentation
Begriffsbestimmungen
Die Fachbegriffe von Collie verständlich erklärt, im Vergleich zu Bezeichnungen anderer Werkzeuge: Sitzung, Raum, Reiter, Bereich, Terminal, persistenter Agent, Harness, Crew, Lead und mehr
Die Begriffe von Collie, verständlich erklärt. Jeder Eintrag ist kurz gehalten und verlinkt auf die entsprechende Seite. Verwendet ein anderes Werkzeug einen abweichenden Begriff für dieselbe Sache, wird dies vermerkt.
Collie (eine Instanz)
Ein laufender Bridge-Prozess. Er bedient eine Telefon-URL, überwacht ein Terminal und kann durable agents daneben anzeigen. Ein Host kann mehrere Instanzen ausführen, jeweils mit eigenem Port und eigenem Statusordner (Mehrere Collie-Instanzen auf einem Host).
Sitzung
Eine Agenten-Unterhaltung. Ein Pane zeigt sie an, und Chat liest sie aus dem Harness (Sitzungen). tmux und zellij bezeichnen ihre oberste Gruppe ebenfalls als Sitzung. Collie stellt diese Gruppe als Space dar.
Space
Eine Gruppe von Tabs mit einem Ordner. Dies ist die oberste Ebene auf dem Telefon. Ein Herdr-Workspace ist ein Space, eine tmux-Sitzung ist ein Space, eine zellij-Sitzung ist ein Space und ein durable agent ist ein Space.
Tab
Eine Gruppe von Panes. Ein Herdr-Tab ist ein Tab und ein tmux-Fenster ist ein Tab (Terminals).
Pane
Ein Element, das Sie auf dem Telefon öffnen können. In einem Terminal ist es ein Pane mit einem Bildschirm. In einem durable agent ist es eine Unterhaltung und öffnet sich ausschließlich im Chat.
Terminal (mux)
Herdr, tmux, zellij, tuios oder Tern, das Programm, das Ihre Shells und Agenten enthält. Andere Werkzeuge nennen dies Multiplexer oder Mux. Sie wählen es mit COLLIE_MUX aus (Terminals).
Durable agent
Ein Agent, der als eigener Prozess mit eigenem Speicherplatz läuft. Er verbindet sich über die Durable-Leitung mit Collie. Sie erstellen einen solchen Agenten mit dem Durable SDK oder mit jedem Programm, das die Leitung bedient. Er ordnet seine Spaces, Tabs und Panes selbst an. Diese Funktion ist experimentell, und Sie binden ihn mit collie durable attach ein (Persistente Agenten). Eine Sitzung ist entweder eine Terminal-Sitzung oder eine Durable-Sitzung. Die API und der Code nennen den Kanal weiterhin program.
Harness
Der Agent, der in einem Pane läuft: Claude Code, Codex, pi, OmO oder ein durable agent (Claude Code auf Ihrem Telefon).
Crew
Der Lead samt seinen Mitgliedern. Er stellt eine einzige Telefon-URL für mehrere Rechner bereit (Crews). Ein einzelner Rechner benötigt keine Crew, um ein Terminal und einen durable agent gemeinsam anzuzeigen.
Lead
Die Collie-Instanz, mit der Ihr Telefon kommuniziert. Sie führt die Listen ihrer Mitglieder zusammen und leitet deren Panes weiter (Crews).
Mitglied (Peer)
Eine Collie-Instanz, die einer Crew beigetreten ist. Beide Begriffe bedeuten dasselbe. "Mitglied" ist der Begriff der Crew und "Peer" die Bezeichnung für eine Collie-Instanz, die neben einer anderen läuft (Crews).
Fragekarte (ask)
Eine Frage, die ein durable agent stellt. Das Telefon zeigt sie als Karte an, und ein einziges Antippen beantwortet sie einmalig. Collie antwortet niemals automatisch für Sie (Persistente Agenten).
Belt
Die Aktionsleiste über dem Eingabefeld. Ihr Harness-Bereich enthält die Schaltflächen des Harness selbst (Konfiguration).
Starter
Eine Zeile auf der Seite „Neu“, die einen neuen Bereich in einem Durable Agent erzeugt (Starter aus einem Durable Agent).
Quelle
Das Wort, das sources.json für einen Durable-Agent-Eintrag verwendet. Sie finden es nur in diesem Dateinamen und dessen Feldern. Auf dem Smartphone steht nirgends „source“; das Smartphone zeigt durable agent an (Einen Durable Agent anbinden).
Obergrenze
Eine Fähigkeit, die ein Durable Agent laut eigener Angabe beherrscht: asks, starters, send, steer, abort, rename, close, actions, history oder reopen. Das Smartphone zeichnet nur für eine Cap ein Bedienelement, die der Durable Agent genannt hat. Die Push-Grenzwerte heißen ebenfalls Caps und sind etwas anderes (Push-Nachrichten von einem Durable Agent).
Hello
Die erste Mitteilung eines Durable Agent an Collie: die unterstützten Wire-Versionen, seine Caps und sein Name. Collie liest nichts weiter von einem Durable Agent, dessen Versionen nicht zu den eigenen passen (Versionen). Eine Crew-Verbindung hat ein eigenes Hello zwischen Lead und Mitglied (Crews).
Epoche
Eine Kennung, die ein Durable Agent bei jedem Start erzeugt. Eine Position in einer Konversation zählt nur innerhalb einer Epoche. Wenn die Epoche wechselt, liest Collie die Konversation noch einmal von Beginn an (Persistente Agenten).
Beleg
Das Protokoll einer Aktion, die ein Smartphone von einem Durable Agent angefordert hat: eine Antwort, ein Senden, ein Stopp oder das Antippen eines Starters. Es enthält die Anfrage-ID sowie das Ergebnis und sorgt dafür, dass ein erneuter Versuch wiederholt und nicht doppelt ausgeführt wird. Collie speichert Belege in seinem Statusordner (Wo Collie die Daten eines Durable Agents speichert).
Konversation
Die Bezeichnung auf den Durable-Agents-Seiten des Smartphones für ein Durable Sitzung. Die Konversationsliste zeigt zuerst die Einträge an, die auf Sie warten, danach die übrigen offenen und schließlich die geschlossenen (Anzeige auf dem Telefon).
Bereich „Durable Agents“
Die Gruppe auf dem Dashboard, die jeden Durable Agent zeilenweise auflistet. Sie rückt über Ihre Spaces, solange eine Frage offen ist, und zeigt nichts an, wenn kein Durable Agent angebunden ist (Anzeige auf dem Telefon).
Wire
Das Regelwerk für die Kommunikation zwischen Collie und einem Durable Agent: ein Hello, danach Snapshots, Ereignisse und Antworten. Aktuell gibt es eine Version, Version 1. Es läuft über ein privates Socket oder über https mit einem Token (Versionen).
Diese Seite auf GitHub bearbeiten