Aller au contenu
ColliePWA

23/Documentation

Terminologie

Le vocabulaire de Collie en termes simples, face aux noms utilisés par d'autres outils : session, space, tab, pane, terminal, agent durable, harness, crew, lead et plus encore

Le vocabulaire utilisé par Collie, expliqué simplement. Chaque entrée est brève et renvoie vers la page dédiée. Lorsqu'un autre outil utilise un terme différent pour désigner la même chose, l'entrée le précise.

Collie (une instance)

Un processus bridge en cours d'exécution. Il dessert une URL pour téléphone, surveille un terminal et peut afficher des agents durables à côté. Un hôte peut en exécuter plusieurs, chacun avec son propre port et son propre dossier d'état (Plusieurs instances de Collie sur un même hôte).

Session

Une conversation avec un agent. Un panneau l'affiche, et Chat la lit depuis le harness (Sessions). tmux et zellij appellent également session leur groupe de premier niveau. Collie affiche ce groupe sous la forme d'un espace.

Space

Un groupe d'onglets, associé à un dossier. C'est le niveau supérieur sur le téléphone. Un espace de travail Herdr est un space, une session tmux est un space, une session zellij est un space, et un agent durable est un space.

Onglet

Un groupe de panneaux. Un onglet Herdr est un onglet, et une fenêtre tmux est un onglet (Terminaux).

Panneau

Un élément que vous pouvez ouvrir sur le téléphone. Dans un terminal, il s'agit d'un panneau avec un écran. Dans un agent durable, il s'agit d'une conversation, qui s'ouvre uniquement dans Chat.

Terminal (mux)

Herdr, tmux, zellij, tuios ou Tern, le programme qui héberge vos shells et vos agents. D'autres outils l'appellent un multiplexeur, ou un mux. Vous le choisissez avec COLLIE_MUX (Terminaux).

Agent durable

Un agent qui s'exécute dans son propre processus, avec son propre stockage. Il se connecte à Collie via le protocole durable. Vous en construisez un avec le SDK Durable, ou avec tout programme compatible avec ce protocole. Il organise lui-même ses spaces, ses onglets et ses panneaux. Cette fonctionnalité est expérimentale ; vous le rattachez avec collie durable attach (Agents durables). Une session est soit une session de terminal, soit une session durable. L'API et le code nomment encore ce canal program.

Harnais

L'agent qui s'exécute dans un panneau : Claude Code, Codex, pi, OmO ou un agent durable (Claude Code sur votre téléphone).

Crew

Le lead et ses membres. Il fournit une seule URL mobile pour plusieurs machines (Crews). Une machine isolée n'a pas besoin de crew pour afficher simultanément un terminal et un agent durable.

Lead

L'instance de Collie avec laquelle votre téléphone communique. Elle fusionne les listes de ses membres et relaie leurs panneaux (Crews).

Membre (peer)

Une instance de Collie qui a rejoint un crew. Les deux termes désignent la même chose. « Membre » est le terme propre au crew, et « peer » désigne une instance de Collie qui s'exécute aux côtés d'une autre (Crews).

Carte de question (ask)

Une question posée par un agent durable. Le téléphone l'affiche sous la forme d'une carte, et une simple pression y répond une fois. Collie ne répond jamais à votre place (Agents durables).

Ceinture

La rangée d'actions au-dessus de la zone de saisie. Sa section harness contient les boutons propres au harness (Configurer).

Starter

Une ligne sur la page New qui crée un nouveau volet dans un agent durable (Starters d'un agent durable).

Source

Le terme utilisé par sources.json pour désigner une entrée d'agent durable. Vous ne le rencontrez que dans ce nom de fichier et ses champs. Rien sur le téléphone n'affiche « source » ; le téléphone indique agent durable (Attacher un agent durable).

Plafond

Une action qu'un agent durable indique pouvoir effectuer : asks, starters, send, steer, abort, rename, close, actions, history ou reopen. Le téléphone n'affiche un contrôle que pour une cap déclarée par l'agent durable. Les limites de push sont aussi appelées caps, et correspondent à autre chose (Pushs émis par un agent durable).

Hello

Le premier message envoyé par un agent durable à Collie : les versions du protocole wire qu'il gère, ses caps et son nom. Collie n'échange rien de plus avec un agent durable dont les versions ne correspondent pas aux siennes (Versions). Un lien de crew possède son propre hello, entre un lead et un membre (Crews).

Epoch

Une étiquette générée par un agent durable à chaque démarrage. Une position dans une conversation ne compte qu'au sein d'une même epoch. Quand l'epoch change, Collie relit la conversation depuis le début (Agents durables).

Receipt

L'enregistrement d'une action demandée par un téléphone à un agent durable : une réponse, un envoi, un arrêt ou l'activation d'un starter. Il contient l'identifiant de requête et le résultat, et permet à une tentative de rejeu de ne pas s'exécuter deux fois. Collie stocke les receipts dans son dossier d'état (Emplacement où Collie conserve les données d'un agent durable).

Conversation

Le nom donné par les pages Durable agents du téléphone à un session durable. La liste des conversations affiche d'abord ce qui vous attend, puis les autres conversations ouvertes, et enfin les conversations fermées (Ce qu'affiche le téléphone).

Section Durable agents

Le groupe sur le tableau de bord qui liste chaque agent durable, une ligne par agent. Il se place au-dessus de vos espaces lorsqu'une question est en attente, et n'affiche rien si aucun agent durable n'est attaché (Ce qu'affiche le téléphone).

Wire

Les règles employées par Collie et un agent durable pour communiquer : un hello, puis des snapshots, des événements et des réponses. Une seule version existe aujourd'hui, la version 1. Il s'exécute sur un socket privé ou en https avec un jeton (Versions).

Modifier cette page sur GitHub

The rest of the documentation