Восстановление и рабочий контекст
Сверено с выпуском 0.36.0, 14.11.2026.
Что происходит с работой, когда приложение закрылось, агент упал или сработал лимит, и
как Pulse возвращает вас на то же место. Главное для человека — список «Требует внимания» (⌘ ⌥ A, начало
«Дашборд → Обзор»): всё, что ждёт вашего ответа, собрано там. Ниже — как это устроено.
Реестр запросов
Каждая команда пользователя — промпт, остановка, отмена — получает запись в реестре
pulse-requests.json (папка данных приложения). У записи два независимых поля:
| Поле | Что означает |
|---|---|
Квитанция (accepted) |
main принял команду: ход начался или встал в очередь; известен номер хода |
Исход (done / failed) |
исполнение завершилось или не смогло начаться |
unknown |
приложение перезапустилось, не записав исход |
Квитанция возвращается сразу, не дожидаясь конца хода. Повтор команды с тем же ключом идемпотентности получает прежнюю квитанцию, а не второй ход, — и после перезапуска тоже, потому что реестр сохранён на диске. Промпт, который до перезапуска не был принят, повторяется только по явному решению человека (см. ниже), а не сам.
Источник команды хранится в записи: окно, телефон, внутренний вызов.
Причина остановки
Сессия, чей ход прервался не по завершению, получает причину:
| Причина | Когда |
|---|---|
| Прервано перезапуском приложения | сессия работала в момент выхода приложения; если ход ждал разрешения — «ждала вашего разрешения: <команда>» |
| Ошибка агента | процесс агента упал или отказал; рядом причина словами и код из реестра ошибок, сырой текст — под «Подробнее» |
| Остановлено по лимиту | бюджет задачи, лимит ходов или времени |
| Прервано по таймауту | задание роя не завершено в срок |
| Остановлено пользователем | кнопка «Стоп», удаление задачи |
| Задание роя отменено | решение владельца по рою |
| Остановлено защитой от петли | один и тот же вызов с тем же итогом трижды подряд; продолжить — «Продолжить» |
Причина видна в колонке сессий под названием сессии и строкой над полем ввода — с кнопками, которые правда помогут («Продолжить», «Откатить ход», «Время и лимиты», «Настройки агента»); снимается следующим ходом. На графе такой ход подписан «прерван перезапуском», а не «завершён». Аварийный выход никогда не подписывается как остановка пользователем; время выключенного приложения не начисляется как работа агента. Задания роя, открытые в момент выхода, отменяются с пометкой «Прервано перезапуском приложения».
Конец хода при сбое
- «Стоп» («Отменить») по зависшему агенту не зависает в «Останавливается»: если процесс
не ответил на
session/cancelза 12 секунд, ход добивается принудительнымstop— статус снимается, очередь промптов отпускает, процесс завершается (аудит 24.09). - Промпт, снятый с очереди (остановка, отмена, сбой предыдущего хода), не исчезает молча: в транскрипте остаётся его текст и отменённый ход.
- Падение агента посреди хода сразу снимает висящий запрос разрешения (не через 10-минутный таймаут) и закрывает его открытые вызовы инструментов статусом «отменено» — карточки не висят «в ожидании» ни в живой сессии, ни в восстановленном транскрипте.
stopво время восстановления рабочей папки (между ходами живой сессии) не оставляет статусrunningбез живого процесса: ход отклоняется «запуск агента отменён».
«Требует внимания»
«Обзор» дашборда начинается со списка блокеров, которые ждут человека:
- запрос разрешения;
- вопрос агента в конце хода;
- ошибка сессии — словами и кодом из реестра ошибок, а не сырым «fetch failed»;
- результат на проверке;
- конфликт слияния ветки участника роя;
- прерванный ход (перезапуск, ошибка, лимит, таймаут);
- неизвестный исход запроса;
- исчерпанный лимит задачи;
- ход, остановленный защитой от петли;
- агент расписания требует входа — одна карточка на агента со счётчиком пропусков и кнопкой «Войти»;
- записи общей доски команды, адресованные вам.
У каждой записи адресный переход: «Открыть» ведёт в нужную задачу, сессию и вкладку (у CLI-агента — во вкладку терминала). Часть ответов — прямо в строке: разрешение — «Разрешить» (только безопасное) и «Отклонить» один раз, вопрос — «Ответить», ход, остановленный защитой от петли, — «Продолжить»; секреты и необратимое разрешаются только из полной карточки. Прочтение не закрывает запись — она исчезает, когда блокер снят: разрешение дано, новый ход начат, результат принят. Ход, который шёл, когда Pulse закрылся, — одной строкой «Ход N прервался при закрытии Pulse — проверьте изменения или продолжите» с «Продолжить» (сессия с курсором в поле ввода) и «Открыть изменения»; новый ход этой сессии или откат хода закрывают строку сами, запись остаётся в реестре с пометкой, чем закрыта. Явное закрытие — «Закрыть вопрос» у неизвестного исхода запроса; если промпт не был принят до перезапуска и его текст сохранён, доступно «Отправить снова» — повтор идёт с прежним ключом идемпотентности: если команда всё же была принята, шлюз вернёт прежнюю квитанцию, и второй ход по ней не стартует (это и есть защита от дубля). Список упорядочен по времени и не перескакивает при обновлении состояния. Число блокеров показано бейджем на разделе «Дашборд».
Сохранение рабочего контекста
Перезапуск возвращает окно на то же место: раздел, открытая задача, выбранная сессия каждой задачи, вкладка (Сессия / Изменения / Граф задачи / Терминал / Файлы / Git), поиск и фильтры доски, глубина, направление и камера графа, выбранный проект команды, разрез отчёта измерений, размеры панелей и черновики сообщений. Удалённая задача не открывается — вместо неё доска; выбранные сессии несуществующих задач отбрасываются.
Восстановление ничего не запускает: показать прежнее место — операция интерфейса, а не команда агенту.
Явный worktree
Изолированный автор работает в своей папке, а не в worktree задачи. Колонка сессий показывает папку у таких сессий, участники роя — «свой worktree · ветка». Поле ввода отправляет промпт в выбранную сессию, шапка задачи показывает папку задачи.
Владелец исполнения — машина
Ход агента принадлежит процессу Pulse на машине, а не тому, кто его запустил. Отсюда правила, которые действуют для всех входов — окна, телефона, MCP-сервера внешнего агента и расписаний:
- Потеря связи ≠ остановка. Перезагрузка окна, обрыв соединения телефона, выход
MCP-клиента, не дождавшегося ответа, — ничто из этого не прерывает ход и не откатывает
команду. Остановить ход можно только явной командой (
cancel/stop), и у неё есть своя запись в реестре с квитанцией и источником. - Запуск Pulse имеет идентичность. У каждого запуска процесса свой
bootId(src/main/hostBoot.ts); он приходит телефону вhello, внешнему агенту — в/healthи в перечне команд (pulse_commands), а каждая запись реестра штампуется запуском, который её принял. Квитанция прежнего запуска — не обещание нынешнего. - Клиент отличает перезапуск от обрыва. После переподключения телефон сравнивает
bootId: совпал — ходы шли всё это время, достаточно дочитать ленту курсором; не совпал — то, что было в полёте, прервано, и телефон показывает предупреждение и список «Требует внимания» (attention.list) с записями «исход не подтверждён». Исход своей команды телефон читает по её ключу (request.get), а повтор с тем же ключом даёт прежнюю квитанцию, а не второй ход. Шапка Pulse Mobile при обрыве говорит «связь потеряна — ходы на машине продолжаются», а не «остановлено». - Защита от прежнего процесса. Событие, отчёт роя или интеграция от прежнего процесса
агента отвергаются (поколение процесса в
sessionManager, номер хода у задания роя); запуск «догоняющих» ходов после перезапуска не происходит сам — только по решению человека из списка «Требует внимания».
Чего здесь пока нет: исполнение живёт, пока запущен Pulse. Вынос runtime в отдельный
процесс или на другой хост (ход продолжается при закрытом приложении) — отдельный
проект; bootId, реестр с квитанциями и различение «обрыв / перезапуск» — его
предпосылки.
Ограничения
- Реестр хранит последние 300 записей и текст промпта до 20 000 символов; более длинный текст сохраняется усечённым, и «Отправить снова» для него не предлагается.
- Исход хода, начатого до перезапуска, не восстанавливается из транскрипта автоматически: проверка — за человеком; решением считается следующий ход сессии или откат.
- Камера графа сохраняется для графа одной задачи; граф всех агентов вписывается заново.
- Ключ идемпотентности после перезапуска окна не восстанавливается на стороне окна; защитой служит реестр main.