Saltar al contenido
ColliePWA

23/Documentation

Terminología

Los términos de Collie en lenguaje sencillo, junto con los nombres empleados por otras herramientas: session, space, tab, pane, terminal, durable agent, harness, crew, lead y más

Los términos que utiliza Collie, explicados de forma directa. Cada entrada es breve y enlaza a la página correspondiente. Cuando otra herramienta usa un término diferente para lo mismo, la entrada lo indica.

Collie (una instancia)

Un proceso bridge en ejecución. Sirve una URL para el teléfono y supervisa un terminal, y puede mostrar agentes duraderos a su lado. Un host puede ejecutar más de uno, cada uno con su propio puerto y carpeta de estado (Múltiples instancias de Collie en un mismo host).

Sesión

Una conversación con un agente. Un panel la muestra, y Chat la lee desde el harness (Sesiones). tmux y zellij también llaman sesión a su propio grupo de nivel superior. Collie muestra ese grupo como un espacio.

Espacio

Un grupo de pestañas, con una carpeta. Es el nivel superior en el teléfono. Un espacio de trabajo de Herdr es un espacio, una sesión de tmux es un espacio, una sesión de zellij es un espacio y un agente duradero es un espacio.

Pestaña

Un grupo de paneles. Una pestaña de Herdr es una pestaña, y una ventana de tmux es una pestaña (Terminales).

Panel

Un elemento que se puede abrir en el teléfono. En un terminal es un panel con una pantalla. En un agente duradero es una conversación, y se abre únicamente en Chat.

Terminal (mux)

Herdr, tmux, zellij, tuios o Tern, el programa que aloja los shells y los agentes. Otras herramientas lo llaman multiplexor o mux. Se selecciona con COLLIE_MUX (Terminales).

Agente duradero

Un agente que se ejecuta como un proceso independiente, con su propio almacenamiento. Se conecta a Collie mediante el protocolo durable wire. Se compila con el Durable SDK o con cualquier programa que implemente dicho protocolo. Organiza sus propios espacios, pestañas y paneles. Es experimental y se conecta con collie durable attach (Durable agents). Una sesión es una sesión de terminal o una sesión duradera. La API y el código todavía denominan al canal program.

Harness

El agente que se ejecuta en un panel: Claude Code, Codex, pi, OmO o un agente duradero (Claude Code en el teléfono).

Crew

El lead y sus miembros. Proporciona una única URL de teléfono para varias máquinas (Crews). Una sola máquina no necesita un crew para mostrar un terminal y un agente duradero juntos.

Lead

El Collie con el que se comunica el teléfono. Combina las listas de sus miembros y retransmite sus paneles (Crews).

Miembro (peer)

Un Collie que se unió a un crew. Ambas palabras significan lo mismo. «Member» es la palabra del crew y «peer» es la palabra para un Collie que se ejecuta junto a otro (Crews).

Tarjeta de pregunta (ask)

Una pregunta planteada por un agente duradero. El teléfono la muestra como una tarjeta, y una sola pulsación la responde una vez. Collie nunca responde por usted (Durable agents).

Belt

La fila de acciones situada sobre el editor. Su sección de harness contiene los botones propios del harness (Configuración).

Starter

Una fila en la página New que crea un nuevo panel en un agente duradero (Starters de un agente duradero).

Fuente

La palabra que sources.json utiliza para una entrada de agente duradero. Solo aparece en ese nombre de archivo y en sus campos. Nada en el teléfono dice "source"; el teléfono dice agente duradero (Conectar un agente durable).

Límite máximo

Una acción que un agente duradero indica que puede realizar: asks, starters, send, steer, abort, rename, close, actions, history o reopen. El teléfono solo muestra un control para un cap que el agente duradero haya indicado. Los límites de push también se denominan caps, y son un concepto distinto (Notificaciones push de un agente duradero).

Hello

Lo primero que un agente duradero comunica a Collie: las versiones de wire compatibles, sus caps y su nombre. Collie no lee nada más de un agente duradero cuyas versiones no coincidan con las suyas (Versiones). Un enlace de crew tiene su propio hello, entre un lead y un miembro (Crews).

Epoch

Una etiqueta que genera un agente duradero cada vez que se inicia. Una posición en una conversación solo es válida dentro de una misma epoch. Cuando la epoch cambia, Collie vuelve a leer la conversación desde el principio (Durable agents).

Receipt

El registro de una acción que un teléfono solicitó a un agente duradero: una respuesta, un envío, una detención o la activación de un starter. Contiene el id de solicitud y el resultado, y permite reproducir un reintento sin ejecutarlo dos veces. Collie almacena los receipts en su carpeta de estado (Dónde almacena Collie los datos de un durable agent).

Conversation

El nombre que las páginas de agentes duraderos del teléfono dan a un session duradero. La lista de conversaciones muestra primero lo que requiere atención, luego las demás abiertas y, al final, las cerradas (Qué muestra el teléfono).

Sección Durable agents

El grupo del panel que lista cada agente duradero, una fila por agente. Se sitúa encima de los espacios mientras haya una pregunta pendiente y no muestra nada si no hay ningún agente duradero conectado (Qué muestra el teléfono).

Wire

Las reglas que Collie y un agente duradero utilizan para comunicarse: un hello, seguido de instantáneas, eventos y respuestas. Actualmente existe una sola versión, la versión 1. Funciona a través de un socket privado o mediante https con un token (Versiones).

Editar esta página en GitHub

The rest of the documentation