Агенты изнутри

Сверено с выпуском 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[]) — имена скиллов из меню «/» (тот же IPC pulse: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): на macOS sandbox-exec с профилем SBPL, на Linux bwrap — запись только в 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 для ролей kind dev (ветка <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 спрашивает только агент). Живого прогона на боевом ключе Сбера по этой дороге не было — все проверки на фейковом сервере.

Куда дальше (в разработке)

  1. Роли в команде — поведение: ведущий агент раздаёт подзадачи, участники отчитываются — обмен результатами между сессиями (сейчас все видят один worktree, но не транскрипты друг друга; роли и библиотека инструкций уже есть).
  2. Смешанные темы: разные базовые агенты в одной команде (Claude ревьюит, локальная модель пишет тесты) — уже возможно через профили, нужна сводка команды на доске.
  3. Импорт/экспорт профилей JSON.
  4. Оценка результата команды: сравнение Diff сессий, выбор лучшего, слияние.
  5. GigaChat через тот же ApiAgentSession — сделано (см. раздел «GigaChat» выше); GigaChat как провайдер AI-действий — тоже сделано. Дальше — живые прогоны с боевым ключом (ни агент, ни AI-действия на нём не проверялись) и точные размеры контекстных окон моделей.

Worktree и приёмка (20.09.2026)

У новых команд обычных профилей, как и у разработчиков роя, отдельные worktree. Результат сессии смотрите во вкладке задачи «Изменения», режим «Результат», выбрав автора. После проверки кнопка «Объединить с задачей» переносит его работу в общую ветку. Приёмка общего результата выполняется отдельно; завершение хода агента означает только завершение запроса. Старые задачи не помечаются принятыми автоматически.

«Открыть в редакторе» открывает выбранную worktree; это позволяет продолжать пользоваться привычной IDE. При передаче управления другому процессу Pulse восстанавливает цель, профиль, заметки, память и последние ходы. Для полной истории остаётся транскрипт.