Агенты изнутри
Сверено с выпуском 0.36.1, 15.11.2026.
Технический документ — как агенты устроены в коде: реестр, ACP-сессии, встроенный агент, рой, память, политики, MCP. Пользовательская инструкция — в Агенты и модели и Рой агентов.
Исторические записи по версиям идут снизу вверх; текущую поддержку агента проверяйте
по src/shared/agentCapabilities.ts и src/main/agents/registry.ts.
Базовые агенты (`src/main/agents/registry.ts`)
| Агент | Как запускается | Вход | Что даёт |
|---|---|---|---|
| Claude Code | ACP-адаптер @agentclientprotocol/claude-agent-acp дочерним Node-процессом |
OAuth-токен claude setup-token, вставленный в карточку (связка ключей); свой профиль CLAUDE_CONFIG_DIR |
список моделей приходит от адаптера в рантайме — на живую проверку 21.09.2026 это Fable 5.1 / Opus 5 / Sonnet 5 / Haiku 4.5; родные режимы Pulse переводит только в default и plan (см. «Режим и доверие»), effort |
| Codex | @agentclientprotocol/codex-acp; CLI @openai/codex встроен в Pulse, свой в PATH имеет приоритет |
кнопка «Войти» (codex login) или ключ API OpenAI → CODEX_API_KEY |
модели и режимы после первой сессии |
| Kimi Code | kimi acp |
kimi login |
K2.8 / K2.7 / K3, thinking, режимы default · plan (auto и yolo обходят разрешения Pulse и не предлагаются) |
| OpenCode | opencode acp |
opencode auth login — только для своих провайдеров, бесплатные модели OpenCode Zen идут без входа |
десятки провайдеров, включая Ollama и LM Studio через конфиг OpenCode |
| Grok | grok agent --no-leader stdio |
grok login или XAI_API_KEY |
модели сообщает сам CLI после сессии; автоодобрение и свой worktree Pulse не включает |
| Cursor | в графе не запускается: строка в «Использование · все агенты» (#1912) | cookie дашборда не читаем | квоту подписки Pulse узнаёт только из сессии, если сессия её пришлёт |
| Локальная модель | встроенный ApiAgentSession поверх OpenAI-совместимого API |
ключ необязателен для локальных серверов; шлюз может требовать Bearer | Ollama, LM Studio, LiteLLM, llama.cpp, vLLM и удалённые шлюзы; код остаётся на компьютере, только если сервер запущен на ней |
| GigaChat | встроенный ApiAgentSession (flavor gigachat) поверх GigaChat API |
ключ авторизации (OAuth, scope PERS/B2B/CORP) | GigaChat-2 / Pro / Max, режимы Manual · Auto; TLS — CA НУЦ Минцифры из resources/certs |
AgentKind (src/shared/types.ts) — открытый: PulseAgentKind (агенты таблицы) или
acp:<id> — любой агент реестра ACP (cdn.agentclientprotocol.com). Такого агента Pulse ставит
сам в свою папку (main/agents/acpPackage.ts, acpArchive.ts: npm, uv или архив), считает
sha256 программы и всего дерева и сверяет их перед запуском (#668, решение 0031); план
запуска — AgentContext.acpPlan, выбор — раздел «Из реестра ACP» меню агента композера и
окна «Новая задача», каталог — AcpCatalogDialog. Кто за каким провайдером и каким знаком
показан — каталог агентов (src/shared/agentCatalog.ts). Агентов,
запущенных вне Pulse, подключают хуки (main/agents/*Hooks.ts: Codex, Gemini, Grok, Kimi,
OpenCode, Qwen; Claude Code — mcp/pulse-agent-hook.sh), см. «Сессии, запущенные вне Pulse».
Все внешние агенты говорят с Pulse по ACP (session/new, prompt, tool_call,
request_permission), поэтому транскрипт, граф, сводки и режимы для них одинаковы.
Картинки и файлы в сообщении (с 0.36.2, задача 2169). Принимает ли агент картинки, Pulse узнаёт до отправки: у
живого процесса — из ответа ACP, без него — из памяти по виду агента, которую пополняют старт сессии и фоновый пробник
(probeAgentConfig). Агенту без картинок картинка уходит файлом: Pulse кладёт её в копию задачи (.pulse/attachments/,
мимо git) и пишет агенту путь; любой другой файл — так же. Сообщение уходит всегда.
Локальная модель (`src/main/agents/apiAgentSession.ts`)
- Сервер задаётся в карточке агента: адрес
/v1(пресеты Ollama, LM Studio, LiteLLM, llama.cpp) и необязательный ключ. Pulse спрашивает/v1/models— список становится чипом «Модель». - Необязательный JSON-объект
chat_template_kwargsзадаётся рядом с адресом и ключом. Например,{"enable_thinking":false}отключает рассуждения на совместимых моделях Qwen3; Pulse передаёт настройку при проверкеpingи в каждом запросе хода. Пустое поле не отправляется. Поддержку и нужное значение определяет сервер и модель. - Ход = цикл «
chat/completions(stream, tools) → вызовы инструментов → результаты → снова модель», до 30 кругов. Инструменты:read_file,write_file,edit_file,list_dir,search(ripgrep или обход),bash(zsh в worktree, 2 мин). Запись — только внутри worktree. - Разрешения — общие с ACP: режим и доверие сессии (раздел ниже), карточка в чате,
«Разрешать в сессии». Под границей чтения агента (
readBoundary) файловые инструменты главного процесса закрыты (MAIN_PROCESS_FILE_TOOLS), работа — черезbashв песочнице. Чтение с путём (read_file,list_dir,search,code_map) тоже проходит через политики, но в режиме policyOnly: без подходящего правила разрешается молча, а правило вроде «файлы с секретами — всегда спрашивать» показывает карточку и на чтении, запрет отклоняет вызов без карточки. - События те же, что у ACP:
message,tool_call/tool_call_updateсkind(read / edit / search / execute) иlocations,usage(окно по умолчанию 32k),compaction,turn_complete. - Модели должны уметь function calling: qwen2.5-coder, qwen3, llama3.1, devstral,
gpt-oss. Чистый поток без сети проверен smoke-тестом (
apiAgentStream.ts) и мок-серверомscratchpad/mock-openai.cjs.
GigaChat (`src/main/agents/gigachat/client.ts`)
- Тот же
ApiAgentSession, что у «Локальной модели», ноflavor: 'gigachat': запрос сfunctions+function_call: 'auto'вместоtools, история —assistant.function_callи рольfunctionвместоtool_calls/tool. Инструменты, пермиссии, события — общие. - Авторизация: OAuth (
ngw.devices.sberbank.ru:9443/api/v2/oauth) по ключу из secrets, токен кэшируется и обновляется за 3 мин доexpires_at; scope — из настроек карточки. - TLS: корень НУЦ Минцифры из
resources/certs/russian_trusted_root_ca.pem(extraResources),https.Agent({ ca }); транспорт —node:https, не undici. - Кнопка «Проверить» на карточке: OAuth +
/models, модели — в кэш config option «model» (до проверки — fallback GigaChat-2 / Pro / Max). Дизайн —docs/gigachat.md. - Тот же ключ обслуживает AI-действия (сообщение коммита, stash, объяснение, тексты PR) — см. раздел «GigaChat как провайдер AI-действий» ниже.
Режим и доверие сессии (задачи 1109, 1122, 1123; с 0.34)
Прежний чип «Разрешения» (Спрашивать / Авто) заменён двумя осями — src/shared/agentModes.ts,
src/shared/actionKinds.ts, решение 0049 Р-2.
- Режим
SessionMode: «Спросить» (ask) · «План» (plan) · «Агент» (agent), ⇧⇥ по кругу (nextSessionMode). «Спросить» и «План» держит политика «только чтение» (shared/readOnly.ts) у любого агента; у агента со своим режимом плана включается и он (nativeModeFor). Исключение — простая читалка закрытого списка (readOnlyReadCommand,shared/actionKinds.ts:ls,cat,head,grep… с путями в копии, цепочкой через&& ; |), которую исполнит агентская вкладка под границей чтения:decidePolicyполучаетreadSafeот раннера терминала и пропускает её без карточки (#2154; запрет и «спросить» правилом сильнее). Классsafeдля этого мал: в нёмnpm testи git, исполняющий конфиг, — они в «только чтении» запрещены. Отказ режима называет класс команды; встроенный агент получает причину раннера, а не «пользователь или политика». - Доверие
TrustLevel, только в «Агенте»: «Спрашивать» · «Правки сами» · «Полный доступ», плюс матрица из восьми типов действий (ACTION_KINDS: чтение, правка в worktree, правка вне worktree, безопасные команды, остальные команды, MCP, браузер, субагенты) со значениями «разрешать / спрашивать / запретить». Хранятся только отличия от умолчаний уровня (TRUST_DEFAULTS). «Полный доступ» — все клетки «разрешать» (2178). - Порядок решения в
askPermission: политики и обязательный вопрос о секретах и необратимом (alwaysAskForCall) — раньше матрицы; в «Спрашивать» и «Правках сами» матрица их не снимает. В «Полном доступе» (noQuestions, 2178) обязательного вопроса нет — ни уaskPermission, ни у раннера терминала (fullAccessконтекста), и процессы агента идут без границы чтения ОС; отказывают только запрет правилом и «запретить» в клетке. - «Полный доступ» разрешает проект (
RepoSettings.fullAccess, диалог настроек проекта, решение 0007).effectiveTrustберёт меньшее из доверия сессии и потолка проекта по каждой клетке: сняли разрешение — сессии опускаются до «Правок сами», «запретить» человека сохраняется. Одна функция на разрешения ACP, встроенного агента и раннер терминала. - Родные режимы агента.
acceptEditsи режимы обхода (bypass,yolo) Pulse не включает (shared/policyMode.ts,assertPolicyOption): в них агент перестаёт спрашивать Pulse. «Правки сами» и «Полный доступ» Pulse держит сам, отвечая на запросы. - «Авторежим» в карточке агента, варианта и участника роя (
autoApprove) — теперь стартовое доверие новой сессии (initialTrust): «Полный доступ», если проект разрешил, иначе «Правки сами» с пометкой понижения. Старые сессии «Авто» читаются как «Полный доступ» с пометкойlegacyFull(sessionModeOf).
Правая панель сессии (эпик 1105; с 0.34)
Один чат сессии везде — SessionChat (вкладка задачи и панель графа; CompactTranscript
удалён). Что в нём и где код:
| Возможность | Где |
|---|---|
| очередь сообщений «В очереди · N», «Стоп» откладывает очередь, «Продолжить» | session/QueueStrip.tsx |
«Откатить ход»: файлы и беседа / только файлы / только беседа, «Вернуть как было»; снимки в <userData>/checkpoints/, предел 2 ГБ (снимки закрытых сессий уходят первыми) |
shared/conversationRewind.ts, main/sessions/turnRollback.ts, main/git/checkpointStore.ts |
| ответвление «после этого хода» / «переиграть этот ход» — в новую сессию или новую попытку | shared/conversationFork.ts, session/ForkDialog.tsx |
| полоса плана «План · N из M · сейчас: …» | session/PlanStrip.tsx |
| кольцо контекста, шкала «Окно контекста», «Сжать» | session/ContextChip.tsx, shared/compaction.ts |
| защита от петли: три одинаковых вызова подряд с тем же итогом — ход стоп | shared/loopGuard.ts, main/agents/sessionManager.ts |
| фоновые агенты задачи и субагенты хода, «Стоп все» | shared/backgroundAgents.ts, session/BackgroundStrip.tsx |
упоминания @-путь, @блок, @git, @ошибки, @сессия; «/» и /план |
shared/composerMentions.ts, session/MentionSuggest.tsx, shared/skillMenu.ts |
| история сессий: поиск по содержимому, сортировка новые / стоимость / токены / избранное | shared/sessionHistory.ts, main/sessions/sessionHistory.ts, session/SessionHistory.tsx |
| Diff по кускам (Hunk) в «Изменениях», «Принять файл», замечание агенту к строке | git/diff/WorkingFileDiff.tsx, transcript/EditDiffCard.tsx |
Стоимость в истории — только из ответа провайдера (historyCost): сумма, «от …» при части
ходов без цены, «—» у локальной модели, «нет цены», если провайдер не сообщил.
Варианты агента (профили, бывш. «Мои агенты») — v2
AgentProfile в pulse-settings.json: имя, роль, характер (одна строка), инструкция,
базовый агент, модель / режим / effort, авторежим, скиллы, цвет. Отдельной страницы
«Мои агенты» больше нет: профили живут в настройках «Агенты» — в карточке каждого
агента, раздел «Варианты агента» (список профилей с agent === kind, кнопки
изменить / дублировать / удалить, «Добавить вариант» открывает ProfileEditor
с зафиксированным базовым агентом). Так у одного агента может быть несколько
вариантов: например, два Claude — Sonnet-разработчик и Opus-ревьюер.
- Роль (
role) — id пресета изsrc/shared/roles.ts(ведущий, разработчик, ревьюер, тестировщик, документатор, рефакторщик) илиcustom. Выбор пресета подставляет характер и инструкцию из библиотеки — но только в нетронутые поля (пустые или всё ещё равные пресету); свой текст не затирается. Роль видна бейджем в списке вариантов, в чипе «Команда» композера, на ноде сессии графа и в SessionPanel. - Быстрый набор (кнопка в шапке страницы «Агенты»): одним кликом создаёт команду —
Ведущий (Opus), Разработчик (Sonnet), Ревьюер (Sonnet), Тестировщик (Haiku) на
Claude Code или первом доступном агенте; модели — только из реально известных
вариантов реестра, профили с существующими именами пропускаются (
planQuickSet). - Инструкция уходит первым ходом сессии: «Роль: Ревьюер. Инструкция агента «Имя»: …
--- Задача: …» (
buildFirstTurnText). Так работает с любым базовым агентом без правки адаптеров. - Скиллы (
skills?: string[]) — имена скиллов из меню «/» (тот же IPCpulse:list-skills, мультивыбор вProfileEditorс фильтром при >10). Это не ограничение, а рекомендация: в первый ход добавляется строка «Подключённые скиллы: /name1, /name2 — применяй их когда уместно по задаче». Пусто — все скиллы доступны агенту как обычно. Миграция: отсутствие поля и невалидные значения → undefined (normalizeProfiles). - Инструменты (
tools?: string[]) — ограничение из frontmatter библиотечного агента (library/agents/*.md, полеtools:в нотации Claude Code: Read, Write, …). Парсится при выборе «Из библиотеки» (libraryAgentPrompt→parseAgentTools), в редакторе показано чипами только для чтения. Применяет его только встроенный агент (ApiAgentSession):TOOL_SPECSфильтруется по списку (profileToolsToInternalизshared/profileTools.ts: Read → read_file+code_map+ui_*, Grep → search+code_search, Glob → list_dir, Write/Edit/Bash — как есть), а вызов вне списка отклоняется локально. У ACP-агентов (Claude, Codex, Kimi, OpenCode) ограничение не действует — их инструменты управляются их собственным CLI; в UI это сказано в подсказке строки. - Композер: профиль выбирается в чипе агента (раздел «Мои агенты»), чип «Команда»
добавляет ещё профили — задача получает по сессии на каждого, все стартуют с одним
промптом параллельно. В колонке сессий каждая подписана именем профиля. При двух и больше
участниках каждый получает свою worktree до первого хода (
isolateSession→createMemberWorktree, ветка<ветка задачи>-agent-<id сессии>); результат автора переносится в ветку задачи кнопкой «Объединить с задачей» (см. «Worktree и приёмка» ниже). Раздачи заданий и отчётов, как у роя, у команды нет. - Подготовленная задача запускается кнопкой «Запустить» во все незапущенные сессии.
- Продолжение сессии у провайдера (0.30.12). Идентификатор сессии ACP хранится в
session.providerSessionIdи переживает перезапуск приложения. При старте нового процесса он передаётся адаптеру: если агент объявилloadSession, сессия поднимается черезsession/loadсо всей историей у провайдера, и выдержка транскрипта в промпт не подставляется. Отказ загрузки не роняет запуск — начинается новая сессия, контекст едет текстом, в транскрипт попадает запись о причине. Что умеет конкретный адаптер, показываетnode scripts/acp-capabilities.mjs all: он спрашивает возможность и сразу пробует её в деле. Отказ на пустой сессии ещё не означает отказ после завершённого хода. На 21 сентября 2026 Claude принимал пустую сессию в том же процессе, Codex объявлял возможность, но отвечал внутренней ошибкой. На 1 октября отдельная живая ACP-проба после настоящего хода показала продолжение Kimi и Codex во втором процессе; Claude остановился наAuthentication required. Это ещё не проверка перезапуска самого Pulse, см.docs/testing/acp-session-resume.md.
Рой (0.16.0)
Рой — именованный состав ролей (shared/swarm.ts: архитектор, аналитик, фронтенд, бэкенд,
безопасность, продукт, тестировщик, DevOps), который запускается на репозиторий одной кнопкой.
- Состав хранится в
settings.swarms(Настройки → Рой): у участника роль, агент, модель, авторежим, ведущий, своя инструкция. Готовые составы —SWARM_PRESETS. - Запуск (
ipc.ts: launchSwarm): задача получает по сессии на роль (session.swarmRole),task.swarmхранит ведущего, участников, задания и число волн. Стартует только ведущий с текстомleadBrief(роль, состав, протокол, бриф); участники ждут. - Протокол: архитектор раздаёт задания блоком
pulse-assign— строки «роль: задание» (parseAssignmentsпонимает id, русские подписи,@роль, продолжение на следующих строках). Координатор (main/swarm/coordinator.ts) наturn_completeведущего шлёт задания участникам (memberFirstTurn/assignmentPrompt), наturn_completeучастника с открытым заданием отправляет его последний текст ведущему (reportPrompt); ошибка участника —memberFailedPrompt. Все ходы идут через очередьSessionManager.runTurn, так что отчёты не теряются, пока ведущий занят. - Ограничения v1: один worktree на рой (разработчики получают непересекающиеся области по инструкции архитектора), отчёт = последнее сообщение хода, задания только от ведущего (пользователь может писать любому участнику напрямую в его чате).
Память (0.17.0)
- Заметки задачи (
task.notes): текст владельца из окна «Заметки» задачи (и файлЗадачи/<название> (<id>).mdв хранилище заметок,main/notes/vault.ts); первым ходом каждой сессии задачи и участникам роя уходит блок «Заметки задачи от владельца» (до 2000 символов,shared/memory.ts: notesBlock / withContext). - Память репозитория (
main/memory/repoMemory.ts):userData/memory/<имя>-<хэш>.md. Записи «## дата — задача» добавляет архитектор роя (итог после закрытых заданий, один раз на волну,coordinator.ts), кнопка «в память» в колонке сессий (последний ответ активной сессии, окно «Заметки») и правка в редакторе (окно «Заметки» или Настройки → Репозитории). Выдержка (memoryExcerpt, 3000 символов по границе строки) уходит первым ходом всем сессиям и в бриф архитектора.
Отдельный Vault-журнал ролей пока не подключён к рабочему исполнителю; контракт подтверждённых уроков и проверочный сценарий описаны в документе модуля «Рой», «Подтверждённые уроки».
Egress-allowlist роя 24/7: пока не действует в сессиях
packages/pulse-guard/src/egress.ts содержит HTTP/HTTPS-прокси, который проверяет адреса
по AgentTaskManifest.egress, и egressProxyEnv для клиентов, использующих proxy env.
Однако startEgressProxy и egressProxyEnv не вызываются нетестовым кодом: сервер роя
24/7 проверяет конфигурацию, но не запускает исполнителя сессий. В рое приложения
SessionManager запускает ACP-агента через AcpSession.start с launch.env или ведёт
встроенного API-агента в главном процессе; у этих сессий нет манифеста 24/7 с egress.
Поэтому наличие правил в манифесте сейчас не ограничивает сеть работающего агента и не
создаёт записей в pulse.egress_log от его хода.
Одной передачи HTTP(S)_PROXY в launch.env недостаточно для заявленного сетевого
периметра: код агента может открыть прямой сокет, а часть HTTP-клиентов не использует эти
переменные. Для подключения требуется исполнитель, который связывает конкретный манифест
с сессией, запускает и закрывает её прокси и принуждает весь сетевой трафик сессии идти
через проверяемый путь (например, изоляцией сети процесса). Сквозная проверка должна
запустить настоящий агентский процесс, проверить разрешённый и запрещённый адреса,
попытку прямого соединения и журнал. Пока это не выполнено, тесты прокси доказывают
только его поведение для запросов, уже направленных через него.
Политики, бюджеты, песочница, аудит (0.18.0)
- Политики (
shared/policy.ts: decidePolicy): порядок проверки вaskPermission— ограничение роли (review → запрет правок и команд) → правила сверху вниз (первое подходящее) → «спросить» → auto агента / авторежим сессии / «Разрешать в сессии» → карточка пользователю. Контекст правила:title,kind,commandиpathsизrawInput/locations(ACP присылает их вrequestPermission), роль роя. - Бюджет (
shared/budget.ts,ipc.ts: checkBudget / guardBudget): поusage-событиям считается суммаcostUsdсессий задачи против лимита (задача → общий); warn — уведомление один раз, over —cancelвсех сессий,task.budgetExceeded, отказ в новых ходах. - Песочница записи (
shared/sandbox.ts, реэкспорт вapiAgentTools.ts): на macOSsandbox-execс профилем SBPL, на Linuxbwrap— запись только в worktree, tmp и кэши пакетных менеджеров; сеть — отдельной настройкой. На Windows ограничения записи нет, и Pulse этого не скрывает. - Граница чтения (#467,
main/agents/readBoundaryMode.ts,shared/readBoundaryMode.ts): агент видит только worktree задачи (bwrap / sandbox-exec), секреты компьютера ему не видны. На стендах несобранного приложения снимаетсяPULSE_AGENT_READ_BOUNDARY=0. - Аудит (
shared/auditReport.ts):buildAuditMarkdown/buildAuditJsonиз задачи, сессий, транскриптов и ленты; решения по разрешениям — записиkind: 'permission'ленты (onPermissionDecided).
Внешние MCP-серверы (0.19.0)
- Конфиг —
settings.mcpServers(McpServerConfig: stdio/http, agents, hint,{worktree}). - ACP-агенты:
SessionManager.ensureSession → AcpSession.start(launch, cwd, mcpServers)→session/new { mcpServers }(формат ACP: env как пары name/value). - Встроенный агент:
ApiAgentSession.connectMcpподнимаетMcpStdioClientна сервер, списокtools/listпревращается вToolSpecс именамиmcp__<id>__<tool>;runCallроутит их вrunMcpCall(tools/call); каждый вызов проходитpermission— клеткаmcpматрицы доверия. Подключение, выключенное или изменённое в «Плагинах», отзывается (canUseMcpServer) и до, и после ожидания разрешения. - Отпечаток инструментов (
shared/mcpToolPin.ts, задача 946): смена описаний или набора после одобрения — отказPULSE-AGENT-010. Переменные окружения из формы для stdio не передаются (shared/mcpConfirm.ts). - Подсказки серверов — блок «Подключённые MCP-серверы» в
withContextпервого хода.
Рой: свои worktree, слияние, автоповторы (0.20.0)
ipc.launchSwarm→memberGit.createMemberWorktreeдля ролей kinddev(ветка<task.branch>-<role>,session.cwd);SessionManager.ensureSessionберётsession.cwd ?? task.worktreePath.- Координатор:
send()→deps.syncMember(коммит незакоммиченного, merge ветки задачи в worktree участника; конфликт → задание failed + архитектору);finishAssignments()→deps.integrateMember(коммит работы участника, merge в worktree задачи; конфликт →merge --abort, note архитектору) →assignment.merge. - Автоповторы:
onMemberError→attempts < MAX_ATTEMPTS(2)→ задание повторно, иначе failed +memberFailedPrompt. Пользовательские задания:assignFromUser(from: 'user', волны не считает). - План
docs/harness-plan.mdзакрыт в 0.22.0.
GigaChat: автоподбор scope · рой: таймаут задания (0.22.1)
GigaChatClient.requestToken: порядок scope — из настроек, затем остальныеGIGACHAT_SCOPES;isScopeMismatch(400 + «scope» в теле) → следующий, иная ошибка → сразу наружу; успех под другим scope →currentScope,opts.onScopeResolved(scope)(ipc сохраняет вagents.gigachat.scope; «Проверить» — черезGigaChatCheckResult.scope).SwarmCoordinator.start()/stop()— сторож раз вWATCHDOG_INTERVAL_MS;checkTimeouts(now): заданияsentсоsentAt + ASSIGNMENT_TIMEOUT_MS <= now→deps.cancelTurn(sessionId)+onMemberError(...)(повтор / провал);timedOut— сессии, чейturn_complete(cancelled)не считается отчётом. Deps:listSwarmTasks,cancelTurn.
Контекст встроенного агента (0.22.0)
shared/chatContext.ts:estimateTokens(кириллица ≈2.5 символа на токен, остальное ≈3.5),messagesTokens,splitTurns(система / сводка / ходы от user до user),trimToolOutputs,summarizeTurn(запрос, инструменты сmainArgи счётчиком, файлы write/edit, итог),mergeSummary(одна сводка с префиксомSUMMARY_PREFIX, лимит 6000 символов, старые ходы выпадают),compactMessages— ступени: мягкая подрезка старых → сводка старых (кромеKEEP_TURNS= 2) → жёсткая подрезка недавних → сводка всего, кроме текущего → подрезка текущего без последнего сообщения. Порог 75 % окна, цель 50 %.ApiAgentSession:maybeCompact()перед каждым запросом (и между кругами одного хода),compact()— «Сжать» человека тем же алгоритмом без порога;calibration= prompt_tokens сервера / оценка (0.5…4), событиеcompaction(source: auto | manual, было / стало); ACP-агенту «Сжать» отправляет его команду, только если он объявилcompact(compactPathвshared/compaction.ts);opts.contextSize←AgentSettings.contextSize(Настройки → Агенты → «Окно контекста»,settings/ContextWindowRow.tsx), по умолчаниюDEFAULT_CONTEXT_SIZE= 32k.
Версии инструкций (0.21.0)
shared/promptHistory.ts:recordVersion(history, owner, text, at, note)— новая версия только при изменении текста (trim), лимитMAX_PROMPT_VERSIONS = 30;latestVersion,dropOwner,diffLines(построчно, без учёта порядка). Владельцы:profileOwner(id)→profile:<id>,swarmMemberOwner(swarmId, memberId)→swarm:<id>:<member>.SettingsStore.patch: приprofiles/swarmsпишет версии изменённых инструкций и стирает историю удалённых;promptVersionOf(owner, text)— версия для сессии (старый профиль без истории получает v1 «из настроек»).ipc.createSessionRecordиlaunchSwarmставятsession.promptVersion; колонка сессий показывает «инстр. vN». UI —settings/PromptHistory.tsxпод полем инструкции профиля (ProfileEditor) и участника роя (SwarmPage).
Сессии, запущенные вне Pulse (Фаза 6.4)
Агент, поднятый руками в терминале (claude, codex, …), сообщает о себе хуками на
локальный мост 127.0.0.1 (main/agents/externalStatus.ts): POST /session —
регистрация и статус, POST /permission — блокирующий запрос разрешения, который Pulse
показывает своей карточкой. Мост присылает в renderer список ExternalAgentSession
(store.externalAgents): агент, pid, папка, заголовок, статус, время последнего события.
Адрес и токен моста — discovery-файл os.tmpdir()/pulse/agent-<pid>.json: каталог 0700,
файл 0600, чужой uid читателями отбраковывается (хук mcp/pulse-agent-hook.sh,
mcp/pulse-mcp.cjs, чистка stale — в самом сервисе). Хук разбирает discovery через node
(sed по JSON подменял значения, аудит 24.09 #226/#338); его стенд — прогоны реального
bash против поддельных discovery-файлов в src/main/agentHook.test.ts.
Где это видно
- Дашборд, панель «CLI-агенты» — весь список (сессии из хуков и агенты во вкладках терминала). У строки показана задача, если папка сессии лежит в её worktree; клик открывает задачу. Не совпало — строка честно говорит «без задачи»: на граф такая сессия не попадёт.
- Граф задачи — нода вида
externalв слое сессий, рядом со своими и после них. Ребро к задаче означает ровно одно: сессия идёт в worktree этой задачи. Занята ли она её целью, Pulse не знает и нигде этого не утверждает. - Рейка статистики — строка «Вне Pulse» отдельным числом. В «Сессии», «Инструменты» и «Стоимость» чужие сессии не входят: их ходов Pulse не видит, и сложить их со своими значит завысить итог.
Граница знания
Чужая сессия приходит одним статусом. Транскрипта, ходов, вызовов, стоимости, контекста и модели у Pulse нет — и они не достраиваются по аналогии со своей сессией:
- карточка вместо счётчиков показывает «ходов не видно»;
- панель ноды перечисляет неизвестное словами («Чего Pulse не видит»), а не прочерками: прочерк на месте числа читается как ноль;
- у ноды нет детей и нет
sessionId— открывать под ней нечего и переключать чат не на что; - чтобы вызовы попадали в граф, сессию нужно вести из Pulse.
Исключение — стоимость, контекст и лимиты подписки Claude Code (604, 04.10.2026): если человек включил тумблер
«Деньги, контекст и лимиты в карточке агента», строка состояния Claude Code обёрткой mcp/pulse-statusline.sh
передаёт их мосту (shared/agentUsage.ts, поле usage сессии), и карточка показывает их разделом; подсказка узла
тогда не говорит, что их не видно (externalUnknown). Нет данных — нет раздела, а не «$0»; в «Стоимость» рейки эти
деньги не входят.
Где код
shared/externalGraph.ts— чистая часть с тестами: сопоставление папки сессии с worktree задачи (taskIdForExternalSession,externalSessionsOfTask,splitExternalSessions), общие подписи статуса иEXTERNAL_UNKNOWN— список того, чего мы не знаем. Регистр пути не нормализуется намеренно: совпадение по букве — факт, совпадение «с точностью до регистра» — догадка, и непохожее написание честнее оставить без задачи.graph/externalNodes.ts—ExternalNodeInfoи сборка нод. Статусы переводятся так:working → running,waiting → pending(«ждёт ответа» — это висящий запрос разрешения, то есть действительно «ждёт вас»),idle → completed(спокойное состояние;pendingпокрасил бы карточку тревожным и зажёг ореол). На пилюлю этот перевод не влияет: её красит свой словарь моста (exc-*в graph.css).graph/layout.ts—BuildOptions.externalиGraphStats.external; сама ветка вынесена вexternalNodes.ts, чтобы не растить и без того переросший файл.graph/AgentGraphView.tsx— отбор по задачам иexternalSignature. Модель графа зависит не от списка, а от его отпечатка: мост шлёт обновление на каждое событие внешнего агента, и меняется в нём обычно одноlastEventAt, которого на карточке нет. Без отпечатка полный пересчёт модели и раскладки шёл бы по нескольку раз в секунду ни за что (цена — см. scale.md). ПоэтомуlastEventAtне лежит и в ноде: возраст события панель читает из живого списка, иначе показывала бы застывшее число.
GigaChat как провайдер AI-действий (`main/ai/providers/gigachat.ts`)
GigaChat перестал быть только агентом: он же теперь провайдер AI-движка — сообщение
коммита, имя stash, объяснение изменений, тексты PR, план атомарных коммитов, AI-разрешение
конфликтов. Всё это идёт через AIService.generate, поэтому провайдер один на все действия.
- Ключ один.
needsApiKey: false(иначе страница AI показала бы второе поле ключа, которого не существует), правду про доступ отдаёт новый необязательныйAIProvider.hasCredentials. Ключ, scope и моделиAIServiceполучает черезAIServiceDeps.gigachat()из тех же мест, что и агент:secrets.gigachatAuthKey,gigachatScope(ctx), кэш config option «model» карточки (иначеGIGACHAT_FALLBACK_MODELS).onScopeResolvedпишет подобранный scope в карточку. - Транспорт живёт дольше провайдера.
providerForсобирает провайдер на каждый вызов, поэтомуAIServiceдержитcacheGigaChatTransport: одинGigaChatClientна время работы приложения, пока не сменилисьauthKeyиscope. Без него трёхминутный кэш токена внутри клиента не срабатывал ни разу — клиент умирал вместе с вызовом, и каждое действие платило новым OAuth, чтением PEM корня НУЦ Минцифры и новымhttps.Agent.fresh: true(кнопка «Проверить») кэш обходит: ответ из кэша значил бы «у нас ещё есть токен», а не «ключ действует». - Коды ошибок. OAuth 401/403 и «не подошёл ни к одному scope» →
AI_INVALID_KEY; недозвон →AI_NETWORK; HTTP-отказ OAuth →AI_PROVIDER. У/chat/completions: 401/403 →AI_INVALID_KEY, 402/404/429 →AI_PROVIDERс пояснением (statusHint), пустой ответ →AI_PROVIDER. В каждом тексте про ключ стоит адрес «Настройки → Агенты → карточка GigaChat»: окно (renderer/src/ai.ts: namesPlace) показывает слова провайдера только тогда, когда он сам назвал раздел, иначе подставляет общий совет про «Настройки → AI-функции». - UI.
settings/AiPage.tsx: GigaChatKeyRow— вместо поля ввода состояние ключа, переход на карточку агента и «Проверить» (pulse:ai-verify-key→verifyKey→ настоящий OAuth). - Чего нет. Расшифровки речи через GigaChat (
voiceCapabilityотвечает отказом с готовым выходом), потоковой выдачи у AI-действий (её нет ни у одного провайдера), остатка пакета токенов (/balanceспрашивает только агент). Живого прогона на боевом ключе Сбера по этой дороге не было — все проверки на фейковом сервере.
Куда дальше (в разработке)
- Роли в команде — поведение: ведущий агент раздаёт подзадачи, участники отчитываются — обмен результатами между сессиями (сейчас все видят один worktree, но не транскрипты друг друга; роли и библиотека инструкций уже есть).
- Смешанные темы: разные базовые агенты в одной команде (Claude ревьюит, локальная модель пишет тесты) — уже возможно через профили, нужна сводка команды на доске.
- Импорт/экспорт профилей JSON.
- Оценка результата команды: сравнение Diff сессий, выбор лучшего, слияние.
GigaChat через тот же— сделано (см. раздел «GigaChat» выше);ApiAgentSessionGigaChat как провайдер AI-действий— тоже сделано. Дальше — живые прогоны с боевым ключом (ни агент, ни AI-действия на нём не проверялись) и точные размеры контекстных окон моделей.
Worktree и приёмка (20.09.2026)
У новых команд обычных профилей, как и у разработчиков роя, отдельные worktree. Результат сессии смотрите во вкладке задачи «Изменения», режим «Результат», выбрав автора. После проверки кнопка «Объединить с задачей» переносит его работу в общую ветку. Приёмка общего результата выполняется отдельно; завершение хода агента означает только завершение запроса. Старые задачи не помечаются принятыми автоматически.
«Открыть в редакторе» открывает выбранную worktree; это позволяет продолжать пользоваться привычной IDE. При передаче управления другому процессу Pulse восстанавливает цель, профиль, заметки, память и последние ходы. Для полной истории остаётся транскрипт.