Терминология

Термины Collie простыми словами. Каждая статья кратка и содержит ссылку на соответствующую страницу. Если в другом инструменте то же самое называется иначе, в статье это указано.

Collie (экземпляр)

Один запущенный процесс bridge. Он обслуживает один URL для телефона, отслеживает один терминал и может отображать durable agents рядом с ним на экране. На хосте можно запустить несколько экземпляров, каждый со своим портом и каталогом состояния (Несколько экземпляров Collie на одном хосте).

Сессия

Один диалог с агентом. Он отображается на панели, а Chat считывает его из обвязки (Сессии). В tmux и zellij группа верхнего уровня тоже называется сессией. Collie отображает эту группу как пространство.

Space

Группа вкладок с рабочей директорией. Это верхний уровень на телефоне. Воркспейс Herdr — это space, сессия tmux — это space, сессия zellij — это space, и durable agent — это space.

Вкладка

Группа панелей. Вкладка Herdr — это вкладка, и окно tmux — это тоже вкладка (Терминалы).

Панель

Один элемент, который можно открыть на телефоне. В терминале это панель с экраном. В durable agent это один диалог, и он открывается только в Chat.

Терминал (mux)

Herdr, tmux, zellij, tuios или Tern — программа, в которой работают ваши командные оболочки и агенты. В других инструментах она называется мультиплексором, или mux. Вы выбираете её с помощью COLLIE_MUX (Терминалы).

Durable agent

Агент, который работает как отдельный процесс со своим собственным хранилищем. Он подключается к Collie через durable wire. Его можно создать с помощью Durable SDK или любой программы, поддерживающей этот протокол. Он сам формирует свои spaces, вкладки и панели. Это экспериментальная функция, подключение выполняется через collie durable attach (Durable agents). Сессия может быть либо терминальной, либо durable. В API и в коде этот канал до сих пор называется program.

Harness

Агент, который работает в панели: Claude Code, Codex, pi, OmO или durable agent (Claude Code на вашем телефоне).

Crew

Ведущий узел вместе с участниками. Даёт один URL для телефона на несколько машин (Crew). Одной машине crew не требуется, чтобы показывать терминал и durable agent вместе.

Ведущий узел (lead)

Экземпляр Collie, к которому обращается ваш телефон. Он объединяет списки своих участников и ретранслирует их панели (Crew).

Участник (member, peer)

Экземпляр Collie, присоединившийся к crew. Оба слова означают одно и то же. «Member» используется в контексте crew, а «peer» — для обозначения Collie, работающего рядом с другим экземпляром (Crew).

Карточка с вопросом (ask)

Вопрос, который задаёт durable agent. Телефон показывает его в виде карточки, и одно нажатие даёт разовый ответ. Collie никогда не отвечает за вас (Durable agents).

Belt

Строка действий над редактором. В её секции harness находятся собственные кнопки harness (Конфигурация).

Стартер

Строка на странице New, создающая новую панель в durable agent (Стартеры от durable agent).

Source

Слово, которое sources.json использует для одной записи durable agent. Оно встречается только в этом имени файла и его полях. На телефоне нигде не написано «source»; телефон пишет durable agent (Подключение durable-агента).

Ограничение

Действие, которое durable agent заявляет как поддерживаемое: asks, starters, send, steer, abort, rename, close, actions, history или reopen. Телефон отображает элемент управления только для cap, указанного durable agent. Лимиты push тоже называются caps, но это другое понятие (Push-уведомления от durable agent).

Hello

Первое, что durable agent сообщает Collie: поддерживаемые версии протокола wire, свои caps и своё имя. Collie ничего больше не считывает из durable agent, если версии не совпадают с его собственными (Версии). У crew link есть свой собственный hello, между lead и member (Crew).

Эпоха

Метка, которую durable agent создаёт при каждом запуске. Позиция в диалоге учитывается только внутри одной эпохи. При смене эпохи Collie считывает диалог заново с самого начала (Durable agents).

Квитанция

Запись об одном действии, которое телефон запросил у durable agent: ответ, отправка, остановка или нажатие на стартер. Она хранит идентификатор запроса и результат, а также позволяет повторить запрос без повторного запуска. Collie хранит квитанции в своей папке состояния (Где Collie хранит данные durable agent).

Диалог

Название durable сессия на страницах Durable agents в телефоне. Список диалогов показывает сначала то, что ждёт вашего ответа, затем остальные открытые диалоги, затем закрытые (Что показывает телефон).

Секция Durable agents

Группа на дашборде, в которой перечислен каждый durable agent, по одной строке на каждый. Она перемещается выше ваших пространств, пока ожидает вопрос, и ничего не показывает, если не подключён ни один durable agent (Что показывает телефон).

Wire

Правила, по которым общаются Collie и durable agent: сначала hello, затем снимки состояния, события и ответы. На сегодня есть одна версия: версия 1. Протокол работает через закрытый сокет или по https с токеном (Версии).