798 lines
51 KiB
Markdown
Executable File
798 lines
51 KiB
Markdown
Executable File
# Балда → Callee + Prism: делегирование
|
||
|
||
> Обновлён 2026-09-29. Статус: **C0 закрыта. Топология пересмотрена: стек переезжает
|
||
> на Mac, на Kraken остаётся только MM-сервер.** C1-C5 не начаты.
|
||
> Часть [[personal/projects/balda/balda-mm-delegation-plan]].
|
||
> Опорная заметка по контрактам инструментов: [[personal/tech/callee-prism]].
|
||
>
|
||
> 🔴 **Открытая развилка (§6.7):** как давать доступ к `xcodebuild` / `lume` / `docker build` —
|
||
> узкий контейнер (три операции недоступны) или гибрид с хост-исполнителем. Определяет объём C1a.
|
||
|
||
---
|
||
|
||
## 1. Целевая архитектура
|
||
|
||
**Принцип: стек — единое целое по признаку «работает с файлами на Mac».** Всё, что трогает
|
||
код, сборку, тесты, хосты, обязано быть рядом. Всё, что только принимает сообщения — может
|
||
жить отдельно.
|
||
|
||
```
|
||
┌─ Mac ─────────────────────────────────────────────┐
|
||
│ Балда (оркестрация, планирование, крон) │
|
||
│ callee (движок воркфлоу) │
|
||
│ движки: codex / claude / dsh-acp │
|
||
│ bd (Beads) — состояние задач │
|
||
│ тулчейн: ~/Developer, xcodebuild, lume, docker │
|
||
└───────────────────────────────────────────────────┘
|
||
▲
|
||
│ Mattermost API — ИСХОДЯЩЕЕ соединение с Mac
|
||
│
|
||
┌─ Kraken ──────────────────────────────────────────┐
|
||
│ MM-сервер + postgres ← только это │
|
||
└───────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### Что это убирает
|
||
|
||
| Узел | Почему больше не нужен |
|
||
|---|---|
|
||
| `balda-executor-mcp` (:8890) | его работа — пропихнуть вызов к мосту. Балда на Mac → пропускать нечего |
|
||
| мост `agents-bridge` (:8790) | был границей хостов. Границы нет — нет моста |
|
||
| Cloudflare Tunnel для этого потока | нужен только для внешнего доступа к MM |
|
||
| MCP-сервер `obsidian-mcp` на Kraken | Obsidian рядом с Балдой |
|
||
|
||
📌 **Соединение — исходящее с Mac к MM.** Никаких входящих портов, туннеля внутрь Mac,
|
||
«Mac спит → мост недоступен». При недоступности MM — переподключение.
|
||
|
||
### Что остаётся на Kraken
|
||
|
||
Только **MM-сервер + postgres**. Доступность 24/7, один сетевой вход, ничего тяжёлого.
|
||
Kraken разгружается: уходят Балда, MCP-сервер, obsidian-mcp (при load 8.03 на 4 ядрах это
|
||
заметно).
|
||
|
||
### Разделение расходов
|
||
|
||
| Роль | Где | Провайдер |
|
||
|---|---|---|
|
||
| Оркестратор | Mac | DeepSeek `deepseek-chat` |
|
||
| Исполнитель-роли callee | Mac | DeepSeek |
|
||
|
||
📌 «DeepSeek с обоих концов» = обе стороны на DeepSeek. Codex/Claude подключаются позже
|
||
заменой провайдера в `DynamicRole` — без правки графа.
|
||
|
||
---
|
||
|
||
## 1.1 Балда на Mac: контейнер и границы доступа
|
||
|
||
### Где живёт
|
||
|
||
**В Docker-контейнере.** Причины те же, что были на Kraken: изоляция, воспроизводимость,
|
||
образ уже собран (`balda-mm:0.1.13`), откат одним тегом.
|
||
|
||
### Проблема: контейнер изолирован, а нужен тулчейн
|
||
|
||
В контейнере нет и не должно быть по умолчанию:
|
||
|
||
| Чего нет | Почему это правильно |
|
||
|---|---|
|
||
| `~/.ssh` | ключи дают доступ ко всем хостам сразу |
|
||
| `docker.sock` | **эквивалент root на хосте** |
|
||
| пароли, `.env` с токенами | Балде они не нужны |
|
||
| `~/.aws`, `~/.config/gh`, прочие креды | то же |
|
||
|
||
Но нужны: `xcodebuild`, `lume`, `docker build`, опционально `ssh`.
|
||
|
||
### Решение: три класса доступа
|
||
|
||
| Класс | Что | Как | Права |
|
||
|---|---|---|---|
|
||
| **1. Прямой** | файлы проектов, git | bind-mount `~/Developer` (только нужные проекты, не весь `~`) | чтение-запись в проекте |
|
||
| **2. Через шлюз** | `docker build`, `lume` | **не давать `docker.sock` и бинарь** — вместо этого узкий сокет/скрипт-обёртка на хосте с белым списком команд | только разрешённые операции |
|
||
| **3. Через ssh** | доступ к хосту, TrueNAS, Kraken | `ssh` с ключом **ограниченным** `command=` в `authorized_keys` | одноразовые команды, без шелла |
|
||
|
||
🔴 **`docker.sock` в контейнер не монтировать никогда.** Это тождественно выдаче root на
|
||
хосте: через сокет можно запустить контейнер с `-v /:/host` и получить всё. Если нужны
|
||
сборки — либо `docker build` через ограниченную обёртку на хосте, либо **вынести сборку в
|
||
отдельный Script-узел, исполняемый на хосте**, а не в контейнере.
|
||
|
||
### Xcode и lume: где физически
|
||
|
||
| Задача | Где исполняется | Почему |
|
||
|---|---|---|
|
||
| `xcodebuild` | **не в Linux-контейнере** — в lume VM с macOS | контейнер Linux, Xcode только на macOS |
|
||
| `lume` | **на хосте Mac** | бинарь на хосте, в контейнере недоступен |
|
||
| `docker build` | **на хосте Mac** | `docker.sock` в контейнер не даём |
|
||
|
||
📌 **Это означает: часть ролей исполняется НЕ в контейнере Балды.** Значит нужен явный
|
||
механизм «роль → хост-исполнитель». Вариант — callee запускается не только в контейнере,
|
||
но и на хосте (для ролей, требующих Xcode/lume/docker); маршрутизация роли по хосту
|
||
описывается в графе.
|
||
|
||
### Границы: что Балда НЕ должна получить
|
||
|
||
| Ресурс | Статус |
|
||
|---|---|
|
||
| пароли, токены в открытом виде | ❌ только через env-файл с ограниченным набором (DeepSeek-ключ) |
|
||
| `~/.ssh` целиком | ❌ только конкретные ключи |
|
||
| `docker.sock` | ❌ никогда |
|
||
| весь `~` | ❌ только выбранные проекты |
|
||
| root на хосте | ❌ |
|
||
| host-шелл | ❌ только белый список команд |
|
||
|
||
---
|
||
|
||
## 1.1a Формула прав
|
||
|
||
**`права = права процесса × смонтированное × разрешённое в графе`**
|
||
|
||
| Уровень | Кто задаёт | Пример |
|
||
|---|---|---|
|
||
| Чем запущен процесс | вы, при старте | контейнер / хост-юзер / отдельный системный юзер |
|
||
| Что смонтировано | compose | `~/agents:/agents` — и ничего больше |
|
||
| Что разрешено в графе | автор воркфлоу | какие роли и скрипты вообще есть в каталоге |
|
||
|
||
🔴 **`permissions.mode: allow_all` у роли — это про права модели ВНУТРИ ACP-сессии**
|
||
(править файлы, запускать команды). Оно **не** расширяет, что процесс видит в файловой
|
||
системе. Это два разных ограничения, не путать.
|
||
|
||
### Где callee — там и движки, и Script'ы
|
||
|
||
🔴 **ACP-провайдер — дочерний процесс callee.** Движок на хосте + callee в контейнере
|
||
технически невозможны: это один процесс-тред.
|
||
|
||
| Исполнитель | Что исполняет | Права |
|
||
|---|---|---|
|
||
| callee | сам граф: циклы, роли, state | права процесса, которыми запущен |
|
||
| движок (codex/claude/dsh) | модель: думает, правит файлы | наследует + своя песочница |
|
||
| Script | shell: сборки, тесты, ssh | наследует права процесса |
|
||
|
||
**Следствие:** «callee на хосте» = **всё исполнение на хосте целиком**. Промежуточного
|
||
варианта нет.
|
||
|
||
### Динамических маунтов не существует
|
||
|
||
На macOS Docker маунты задаются **при создании контейнера**; live `mount --bind` контейнер
|
||
не видит; симлинк на внешний путь битый. **Вопрос «как модель запросит доступ к папке»
|
||
не имеет решения через маунты.**
|
||
|
||
| Подход | Как | Оценка |
|
||
|---|---|---|
|
||
| A. Смонтировать всё заранее | `~/Developer:ro` | запись нельзя |
|
||
| B. Пересоздание контейнера | правка compose + `up -d` (~3 с) | нужен механизм вне контейнера |
|
||
| C. Хост-агент ставит права сам | callee на хосте | полный доступ, ноль изоляции |
|
||
| **D. Проект = рабочая копия** ✅ | модель работает в `~/agents/<проект>`, результат уходит в `~/Developer` через git | доступ задаётся наличием репозитория, а не маунтом |
|
||
|
||
**Решение: D.** Модель всегда работает в `~/agents/<проект>` (уже смонтировано), результат
|
||
попадает в проект через `git`. Право выдаётся точечно.
|
||
|
||
### Доступ не запрашивается — он выбирается маршрутом
|
||
|
||
Модель **не просит** прав: она не может эскалировать. Если у роли нет доступа, задача
|
||
**падает**, а не спрашивает. Доступ задаёт автор графа.
|
||
|
||
```
|
||
Роутер в графе
|
||
├─ задача требует ~/agents → роль в контейнере
|
||
├─ задача требует Xcode/lume → роль на хост-исполнителе
|
||
└─ задача требует хоста по ssh → роль со ssh-ключом (command=)
|
||
```
|
||
|
||
**Разграничение = статический роутинг по типам задач**, а не динамические права.
|
||
|
||
### Гибрид «контейнер + узкий хост-исполнитель»
|
||
|
||
| Вариант | Права | Динамика | Оценка |
|
||
|---|---|---|---|
|
||
| callee в контейнере | узкие, контролируемые | только `~/agents` | безопасно; Xcode/lume/docker недоступны |
|
||
| callee на хосте | **полный доступ пользователя** | всё работает | ноль изоляции |
|
||
| **гибрид** ✅ | контейнер для основного + узкий хост-исполнитель для Xcode/lume/docker | маунты не нужны | рекомендован |
|
||
|
||
🟡 Хост-исполнитель — дыра в изоляции **по определению**, но **узкая и явная**: три операции
|
||
(xcodebuild, lume, docker build), а не «что угодно».
|
||
|
||
---
|
||
|
||
## 1.1b Роли: жизненный цикл и контроль
|
||
|
||
### Что такое роль
|
||
|
||
**Роль — YAML/MD-файл в каталоге.** Не «право», не «токен», а **описание листа графа**:
|
||
какой провайдер, какой промпт, какие параметры, какой таймаут.
|
||
|
||
```yaml
|
||
apiVersion: callee.metalagman.dev/v1alpha1
|
||
kind: Role
|
||
spec:
|
||
description: Собирает Xcode-проект
|
||
provider:
|
||
type: generic_acp
|
||
cmd: dsh-acp
|
||
model: deepseek-chat
|
||
timeout: 20m
|
||
---
|
||
Собери проект {{ .Params.project }} и верни отчёт об ошибках.
|
||
```
|
||
|
||
### Кто их раздаёт и откуда они берутся
|
||
|
||
| Источник | Что даёт |
|
||
|---|---|
|
||
| Каталог по умолчанию | 6 стартовых ресурсов (`callee setup`) |
|
||
| Импорт из git | `callee agent import baldaworks/prism-callee --prefix prism` |
|
||
| **Наши собственные** | файлы в рабочем каталоге проекта / `~/.callee/` |
|
||
|
||
**Роли не выдаются динамически — они ЛЕЖАТ в каталоге.** Кто положил файл, тот и «выдал»
|
||
роль. Никакого рантайм-механизма выдачи прав нет.
|
||
|
||
### Что раздаётся, а что нет
|
||
|
||
| Сущность | Динамически выдаётся? | Чем регулируется |
|
||
|---|---|---|
|
||
| Роль (файл графа) | ❌ статично | наличие файла в каталоге |
|
||
| Провайдер (тип, `cmd`) | ❌ статично, или из `State` через DynamicRole | автор графа |
|
||
| **Файлы** | ❌ | монтирование + рабочая копия (§1.1a) |
|
||
| **SSH-ключ** | ❌ | наличие файла у процесса |
|
||
| **Разрешение модели внутри сессии** | ⚠️ **да** — `allow_all`/`ask`/`deny_all` | конфиг Балды |
|
||
|
||
🔴 **Единственное, что реально запрашивается в рантайме — разрешение модели внутри ACP-сессии**
|
||
(`ask` → вопрос в чат). Всё остальное статично.
|
||
|
||
### Ваша гипотеза: проверяю по пунктам
|
||
|
||
> «я ставлю задачу → приходит запрос "дать такую-то роль для такой-то задачи" → апрув → доступ появился»
|
||
|
||
| Часть гипотезы | Вердикт |
|
||
|---|---|
|
||
| Задача приходит в систему | ✅ да |
|
||
| **Приходит запрос «выдать роль»** | ❌ **нет такого механизма.** Роли не выдаются, они лежат в каталоге |
|
||
| **Апрув → у агента появляется доступ** | ⚠️ **частично — не к инструментарию, а к действию** |
|
||
| **Без апрува доступа нет** | ✅ **верно, но иначе** |
|
||
|
||
**Что происходит на самом деле:** доступ у роли **есть всегда** — он определяется тем, чем
|
||
запущен callee и что смонтировано. Апрув не выдаёт доступ, апрув **разрешает выполнить
|
||
операцию**, которая уже технически возможна.
|
||
|
||
### Значит правильная формулировка
|
||
|
||
```
|
||
Роль лежит в каталоге (доступ есть по определению)
|
||
│
|
||
▼
|
||
Граф доходит до узла → Human («собрать Xcode в VM macos-27?») → пауза
|
||
│
|
||
├─ апрув → Script исполняется, потому что права у процесса УЖЕ были
|
||
└─ отказ → граф останавливается, ничего не исполняется
|
||
```
|
||
|
||
🔴 **Разница принципиальная.** Вы описали **capability-модель** (права выдаются на задачу).
|
||
Callee работает по **статической модели** (права постоянны, гейты контролируют исполнение).
|
||
|
||
**Что это значит для вашей безопасности:** гейт `Human` защищает от **действия**, но не от
|
||
**возможности**. Если у процесса есть ssh-ключ — ключ есть всегда, вне зависимости от апрувов.
|
||
Изоляцию даёт **только то, чем процесс запущен и что смонтировано** — не граф.
|
||
|
||
### Что можно сделать, чтобы приблизиться к вашей модели
|
||
|
||
| Способ | Как |
|
||
|---|---|
|
||
| **Разные профили запуска** | контейнер «узкий» (без ssh, без docker) и хост-исполнитель «широкий» — выбор профиля роутером |
|
||
| **Роль на задачу** | задача → своя роль с нужным `cmd`/таймаутом; доступ = какой профиль она выбрала |
|
||
| **Апрув как гейт исполнения** | `Human` перед дорогой/опасной операцией |
|
||
| **Белый список команд в Script** | `Script` не «любой shell», а конкретный скрипт с фиксированной командой |
|
||
|
||
---
|
||
|
||
## 1.2 Правила работы: Hermes-конфигурация в Балде
|
||
|
||
В Hermes у Alex накоплены: правила ведения документации (Obsidian — источник истины),
|
||
правила работы (план → апрув → работа, бэкапы, запрет удаления), формат ответов
|
||
(артефакт первой строкой, единица счёта, ADHD-friendly), правила приёмки (от учётки
|
||
заказчика, а не подставной).
|
||
|
||
**Эти правила — не код, а контент.** Значит их надо переносить как контент, а не
|
||
зашивать в Балду.
|
||
|
||
| Слой Hermes | Аналог в Балде | Как переносится |
|
||
|---|---|---|
|
||
| System prompt / SOUL | `balda.global_instruction` | текст в конфиг |
|
||
| Память (`memory`) | session memory Балды + Obsidian | Obsidian MCP |
|
||
| Скиллы (процедуры) | **callee-ресурсы** (`Role`/`Sequential`) | правила работы как воркфлоу |
|
||
| Правила документирования | `global_instruction` + Role, обновляющий Obsidian | текст |
|
||
| Формат ответов | `deliveryfmt` / `questionfmt` | рендеринг, не промпт |
|
||
| Правила приёмки | `Script` + `Human` в графе | исполняемый граф |
|
||
|
||
🔴 **Ключевое различие:** в Hermes правила лежат в промпте и памяти — это **мягкое**
|
||
принуждение (модель может нарушить). В callee часть правил становится **жёсткой**:
|
||
валидация графа, `Human`-гейт, `Script`-проверка. Например «план → апрув → работа»
|
||
превращается в узел `Human` между фазами, а не в просьбу в промпте.
|
||
|
||
**Что это значит на практике:** правила, которые важны как инвариант (апрув, бэкап,
|
||
приёмка) — переносятся в граф как узлы. Правила, которые про стиль (формат ответа,
|
||
тон) — остаются в `global_instruction`.
|
||
|
||
### Obsidian
|
||
|
||
Балда ходит в Obsidian по MCP. На Mac поднимается `obsidian-mcp` рядом (по образцу
|
||
Kraken — контейнер `mcp-proxy --port 3101 -- mcpvault /vault`, `type: sse`), том
|
||
`~/obsidian:/vault`.
|
||
|
||
---
|
||
|
||
## 2. Провайдер DeepSeek для callee
|
||
|
||
### 2.1 ACP-адаптер — выбран `@openma/deepseek-harness-acp@0.4.33`
|
||
|
||
Свой адаптер писать не надо.
|
||
|
||
| | Значение |
|
||
|---|---|
|
||
| Пакет | `@openma/deepseek-harness-acp` |
|
||
| Версия | **`0.4.33`** |
|
||
| `bin` | **`dsh-acp`** → `dist/bin.js` — запускаемый ACP-сервер |
|
||
| Родословная | обёртка вокруг официального DeepSeek Harness |
|
||
| Node | **`>= 22.15`** (в контейнере 24.21.0 ✅) |
|
||
| Лицензия | Apache-2.0 |
|
||
| Зависимости | `@agentclientprotocol/sdk 1.4.0`, `tar`, `zod` |
|
||
|
||
Установка (standalone-вариант, подходит для `generic_acp`):
|
||
|
||
```bash
|
||
npm i -g @openma/deepseek-harness-acp
|
||
# запуск: dsh-acp
|
||
```
|
||
|
||
### 2.2 Креды
|
||
|
||
Приоритет: **флаги → переменные окружения → дефолты**.
|
||
|
||
| Способ | Значение |
|
||
|---|---|
|
||
| Флаг | `api-key`, либо `api-key:<provider>` при нескольких провайдерах |
|
||
| Env | **`DEEPSEEK_API_KEY`** |
|
||
| Env | **`DEEPSEEK_BASE_URL`** — OpenAI-совместимый endpoint override |
|
||
|
||
🔴 `DEEPSEEK_BASE_URL` — это OpenAI-совместимый override, значит переезд на Colex
|
||
сводится к смене одной переменной, без правки графа.
|
||
|
||
📌 Ключ `DEEPSEEK_API_KEY` лежит в `~/.hermes/hermes-whale/.env` (длина 35).
|
||
|
||
📌 Креды не попадают в конфиг клиента: адаптер переиспользует ключ из credential store
|
||
(`dsh web` / `dsh-acp login`), либо берёт `DEEPSEEK_API_KEY` из окружения процесса.
|
||
|
||
### 2.3 Конфигурация Role
|
||
|
||
Тип провайдера — **`generic_acp`**, потому что список поддерживаемых типов закрытый:
|
||
`codex`, `claude`, `opencode`, `copilot`, `grok`, `cursor`, `generic_acp`.
|
||
DeepSeek в нём отсутствует.
|
||
|
||
```yaml
|
||
provider:
|
||
type: generic_acp
|
||
cmd: dsh-acp # одно имя исполняемого файла, НЕ shell-строка
|
||
model: deepseek-chat
|
||
timeout: 20m
|
||
```
|
||
|
||
| Поле | Контракт |
|
||
|---|---|
|
||
| `cmd` | одно имя исполняемого файла; для `generic_acp` обязателен |
|
||
| `extraArgs` | упорядоченный argv-список; каждый элемент непустой |
|
||
| `model` / `reasoning` / `mode` | опциональны; пустые → дефолт бэкенда |
|
||
| `timeout` | Go duration, **по умолчанию `15m`** |
|
||
| Конфиг провайдера | обязан быть **вложенным** (`spec.provider.*`), плоские поля не поддержаны |
|
||
|
||
### 2.4 DynamicRole — провайдер из состояния
|
||
|
||
Все поля провайдера — шаблоны, рендерятся из состояния в момент визита:
|
||
|
||
```yaml
|
||
kind: DynamicRole
|
||
spec:
|
||
provider:
|
||
type: '{{ .State.provider }}'
|
||
model: '{{ .State.model }}'
|
||
timeout: '{{ .State.timeout }}'
|
||
state:
|
||
provider: generic_acp
|
||
model: deepseek-chat
|
||
timeout: 20m
|
||
```
|
||
|
||
| Факт | Значение |
|
||
|---|---|
|
||
| Что рендерится | `type`, `cmd`, `model`, `reasoning`, `mode`, `timeout`, каждый `extraArgs` |
|
||
| Из чего | `.Prompt`, текущий `.Input`, один согласованный post-node снапшот `.State`, `.Params` |
|
||
| Чего нельзя | `.Output`, env, файловая система, сеть, часы, рандом, криптография, мутаторы |
|
||
| Когда валидируется | до поиска и старта процесса; ошибка → визит падает, провайдер не стартует |
|
||
| Периметр визита | конфиг фиксирован на весь визит, включая REPL-ходы; новый визит Loop рендерит заново |
|
||
| Переиспользование процесса | одинаковые effective type+cmd → один процесс; сессия всегда новая |
|
||
|
||
🔴 **Безопасность:** state-driven `cmd` и `extraArgs` могут выбирать исполняемый код.
|
||
Не подавать туда вывод модели без ограничения через авторскую шаблонную логику.
|
||
|
||
---
|
||
|
||
### 2.6 Отлов опасных команд: возможные механизмы
|
||
|
||
> ⚠️ Исследование 2026-09-29. **Решения нет** — зафиксированы варианты и границы, выбор не сделан.
|
||
|
||
**Где физически можно перехватить команду модели:**
|
||
|
||
| Место перехвата | Что видит | Кто решает |
|
||
|---|---|---|
|
||
| Внутри ACP-сессии (адаптер `dsh-acp`) | **каждую** команду модели | адаптер / обёртка вокруг него |
|
||
| `Script`-узел в графе | **только** команды сборок/деплоев, вынесенные в граф | граф callee |
|
||
|
||
🔴 **Ограничение охвата:** узел `Human` в графе защищает **только** `Script`-шаги. Команды, которые
|
||
модель запускает внутри своей ACP-сессии (обычный `bash` харнесса), граф **не видит вообще**.
|
||
Значит «отловить все опасные команды» и «отловить только свои сборки» — принципиально разные
|
||
объёмы работы: первое требует правки адаптера, второе делается чисто в графе.
|
||
|
||
**Механизм 1 — regexp / белый список.**
|
||
Детерминированно, ~0 мс, не обходится вероятностной ошибкой. Ловит только известные шаблоны
|
||
(`rm -rf`, обращение к `docker.sock`, `~/.ssh`, `curl | sh`); обфускация обходит.
|
||
|
||
**Механизм 2 — Jev (`TypeSafeJev` / типизированная оценка).**
|
||
Возвращает **числа**, а не решение: `choice` (вероятности по опциям), `score` (0–3 по рубрике),
|
||
`noul` (0–1 для утверждения). Не LLM, не вызывает инструменты, текст не генерирует.
|
||
Порог и действие пишет **ваш код**:
|
||
|
||
```
|
||
risk(0–3) / injection(noul) / exfiltration(noul)
|
||
├─ if risk >= 1.5 || injection >= 0.8 → deny
|
||
├─ if risk >= 0.5 || exfiltration >= 0.5 → ask
|
||
└─ иначе → allow
|
||
```
|
||
|
||
🔴 **Если `if` не написан — тул выполнится как обычно.** Jev сам не запрещает и не спрашивает;
|
||
без обвязки он даёт «команда опасная» и ничего не меняет. Латентность — сотни мс на каждый
|
||
тул-колл. Вендор позиционирует его как один слой defense-in-depth, не замену sandboxing.
|
||
|
||
**Механизм 3 — Script + Human в графе.**
|
||
Апрув только для того, что само вынесено в `Script`. Внутри ACP-сессии не работает.
|
||
|
||
**Граница, которая важнее гейта:** любой из трёх механизмов защищает **действие**, но не
|
||
**возможность** (§1.1a). Права определяет процесс и монтирование; гейт лишь разрешает
|
||
выполнить уже технически возможное. Если ключ есть у процесса — он есть всегда.
|
||
|
||
**Сопутствующие факты:**
|
||
|
||
- `TypeSafeJev` — один из 10 публичных kinds callee ([personal/tech/callee-prism]] §2.1), то есть
|
||
нативный узел графа; схема порогов выше — из вендорской доки tool-approval.
|
||
- `permissions.mode` (`allow_all`/`ask`/`deny_all`) — режим разрешений **внутри** ACP-сессии.
|
||
В Балде `ask` работает для MM, вопрос уходит реплаем в тред (§4).
|
||
- 🔴 **Не подавать вывод модели в `cmd`/`extraArgs` DynamicRole** — исполнение произвольного кода
|
||
мимо любого гейта внутри сессии (питфолл 8).
|
||
- Разбор слоёв привратника: [[Research/Gatekeeper Architecture for Agent Tool Calls]] — подходы 3
|
||
(OPA), 4 (Cedar), 5 (MCP-прокси), 8 (Jev).
|
||
|
||
---
|
||
|
||
## 2.5 Карта стека: кто кого дёргает
|
||
|
||
> ⚠️ Обновлено под топологию §1 (стек на Mac). Прежний вид — «Балда на Kraken + MCP +
|
||
> мост → callee» — **устарел**, оставлен ниже как справка по демонтированным узлам.
|
||
|
||
### Актуально (топология «стек на Mac»)
|
||
|
||
```
|
||
ВЫ (Mattermost)
|
||
│ задача словами
|
||
▼ MM API — исходящее соединение с Mac
|
||
Балда-оркестратор — Mac, balda-mm:0.1.13, DeepSeek
|
||
│ понимает задачу, читает Obsidian, планирует, держит крон, отвечает
|
||
│ НЕ пишет код, НЕ собирает, НЕ ходит по хостам
|
||
▼
|
||
callee — Mac
|
||
│ ДВИЖОК ВОРКФЛОУ: компилирует граф, валидирует целиком до запуска
|
||
│ МОДЕЛИ НЕ СОДЕРЖИТ: дирижёр — раздаёт роли, гоняет циклы, собирает артефакт
|
||
├─ Role ────► ACP-процесс ───► МОДЕЛЬ (DeepSeek / позже Codex)
|
||
├─ Script ──► shell на Mac: git, docker build, xcodebuild, pytest
|
||
└─ Human ───► пауза, ответ реплаем в треде MM
|
||
▼
|
||
bd (Beads) — трекинг Story → Tasks, живёт между сессиями
|
||
▼
|
||
артефакт → Балда → Mattermost
|
||
```
|
||
|
||
### Демонтированные узлы (не нужны в новой топологии)
|
||
|
||
| Узел | Почему больше не нужен |
|
||
|---|---|
|
||
| `balda-executor-mcp` (:8890) | его работа — пропихнуть вызов к мосту; Балда на Mac → пропускать нечего |
|
||
| мост `agents-bridge` (:8790) | был границей хостов; границы нет |
|
||
| Cloudflare Tunnel (для этого потока) | остаётся только для внешнего доступа к MM |
|
||
| `obsidian-mcp` на Kraken | Obsidian рядом с Балдой |
|
||
|
||
### Кто есть кто
|
||
|
||
| Компонент | Где | Что это |
|
||
|---|---|---|
|
||
| Балда | **Mac** | Оркестратор верхнего уровня: понимает смысл задачи, планирует, крон |
|
||
| **callee** | Mac | Движок воркфлоу. Граф, роли, циклы. **Не модель** |
|
||
| Role / DynamicRole | Mac | Узел, который зовёт модель |
|
||
| **ACP** | Mac | Протокол «редактор ↔ агент». Транспорт, не модель |
|
||
| **dsh / dsh-acp** | Mac | Адаптер: отдаёт DeepSeek по протоколу ACP |
|
||
| **Codex / Claude CLI** | Mac | Агент-харнесс: модель + умение править файлы и запускать команды |
|
||
| **bd (Beads)** | Mac | Память задач: что сделано, что нет |
|
||
| **prism** | Mac | Воркфлоу: specify → design → breakdown → human → apply → verify |
|
||
| **lume** | Mac (хост) | macOS-виртуалки: `macos-15-golden`, `macos-27-golden`, `uitest-26.4.1-golden`, `pdf-hud-macos27` |
|
||
| MM-сервер | **Kraken** | Только чат-сервер 24/7. Больше ничего |
|
||
|
||
📌 **`callee` не умеет ничего сам** — ни думать, ни писать код. Он берёт описание графа,
|
||
проверяет его и по шагам вызывает: роль → модель, скрипт → shell, human → пауза.
|
||
Вся содержательная работа — либо в модели через Role, либо в shell через Script.
|
||
|
||
📌 **Модель ≠ агент-харнесс.** `dsh-acp` только отдаёт DeepSeek. `codex` — харнесс:
|
||
модель плюс умение править файлы, запускать команды, искать. Через ACP callee зовёт и то,
|
||
и другое.
|
||
|
||
### Разбор сценариев
|
||
|
||
| Сценарий | Механизм | Где исполняется | Статус |
|
||
|---|---|---|---|
|
||
| Настроить на **Mac** | `Script` → локальный shell | контейнер, только `~/agents` | ⚠️ `~/Developer` не смонтирован |
|
||
| Настроить на **TrueNAS** | `Script` → `ssh truenas_admin@mallexxx.duckdns.org` | контейнер | ❌ `~/.ssh` не смонтирован |
|
||
| Настроить на **Kraken** | `Script` → `ssh kraken` | контейнер | ❌ ssh не настроен; 🔴 риск потерять канал управления |
|
||
| Собрать **Xcode** | `Script` → `xcodebuild` | **lume VM с macOS** | ❌ в Linux-контейнере невозможно |
|
||
| Тесты в **lume** | `Script` → `lume` | **хост Mac** | ❌ `lume` стоит на хосте, не в контейнере |
|
||
| Собрать **докер-образ** | `Script` → `docker build` | **хост Mac** | ❌ `docker.sock` не смонтирован |
|
||
|
||
🔴 **Корень:** шесть сценариев делятся на две группы, и текущая схема закрывает одну.
|
||
|
||
| Группа | Сценарии | Где |
|
||
|---|---|---|
|
||
| В контейнере | файлы Mac, git, Linux-сборки | `balda-executor` |
|
||
| **Вне контейнера** | TrueNAS/Kraken по ssh, Xcode, lume, docker build | нужен доступ к хосту |
|
||
|
||
**Причина одна:** контейнер изолирован. Нет `docker.sock`, `~/.ssh`, `lume`, Xcode, `~/Developer`.
|
||
|
||
### Как закрывать: роли по исполнителям
|
||
|
||
| Вариант | Суть | Оценка |
|
||
|---|---|---|
|
||
| **A. Роли по исполнителям** ✅ | контейнер чистый для Linux-задач; для остального роли ходят через `ssh` на хост и узлы. Требует `~/.ssh:ro` в контейнер + `ssh admin@host.docker.internal` | изоляция сохраняется; роли явно описаны в графе: «linux-задача», «macOS-задача», «удалённый хост» |
|
||
| B. Дать контейнеру больше прав | смонтировать `docker.sock`, `lume`, `~/Developer` | проще, но контейнер теряет изоляцию — одну из причин своего существования |
|
||
|
||
**Решение: A.**
|
||
|
||
### Чего нет в схеме (докрутить в C1)
|
||
|
||
| Нужно | Статус |
|
||
|---|---|
|
||
| `~/.ssh` в контейнере | ❌ |
|
||
| `docker.sock` | ❌ |
|
||
| `lume` в контейнере | ❌ (стоит на хосте, v0.5.3) |
|
||
| ssh с контейнера на Kraken/TrueNAS | ❌ |
|
||
| lume VM как исполнитель | ❌ VM есть (`macos-15-golden`, `macos-27-golden`, `uitest-26.4.1-golden`, `pdf-hud-macos27`), интеграции нет |
|
||
| Разделение ролей по хостам | ❌ в графе не описано |
|
||
|
||
---
|
||
|
||
## 3. Prism — таск-трекинг
|
||
|
||
### 3.1 Callee и prism — независимые установки
|
||
|
||
Установка одного плагина не ставит другой.
|
||
|
||
| | `baldaworks/prism` | `baldaworks/prism-callee` |
|
||
|---|---|---|
|
||
| Что это | плагин в coding agent (Codex/Claude/Grok/Copilot/Cursor) | callee-агенты для тех же воркфлоу |
|
||
| Требования | coding agent + `bd` (Beads) | coding agent + `bd` + callee ≥ 0.19.0 |
|
||
| Команды | `$prism:story`, `$prism:epic`, `$prism:lifecycle` | `$prism-callee:lifecycle` |
|
||
| Состояние | Beads (`bd`) | Beads (`bd`) |
|
||
|
||
Импорт callee-агентов:
|
||
|
||
```bash
|
||
callee agent import baldaworks/prism-callee --path pack/callee/prism --prefix prism
|
||
```
|
||
|
||
🔴 **Проверка импорта:** `callee agent view prism/lifecycle --json` → **kind `Router`**.
|
||
`Sequential` = устаревший импорт, обновлять `--force`.
|
||
|
||
### 3.2 Жизненный цикл
|
||
|
||
**Story:** Specify → Design → Breakdown → **Human approval** → Apply → Verify.
|
||
Фазы: `phase:story:specify` → `design` → `breakdown` → `human` → `apply` → `verify`.
|
||
|
||
**Epic:** Frame → Architecture → Roadmap → **approval** → Deliver Stories → Validation.
|
||
|
||
| Правило | Значение |
|
||
|---|---|
|
||
| Дети Epic | только Stories |
|
||
| Дети Story | только Tasks |
|
||
| Вложенные Epic / Task напрямую в Epic | невалидно |
|
||
| Фиксированного диапазона числа детей | нет — оценка качественная |
|
||
| Apply | каждый переход требует явной авторизации человека |
|
||
| Одобрение Epic → Story | не переносится |
|
||
|
||
---
|
||
|
||
## 4. Одобрения в Mattermost — работают
|
||
|
||
Одобрение проходит **ответом в треде**, как в Slack.
|
||
|
||
| Механизм | Статус |
|
||
|---|---|
|
||
| Вопрос с опциями (markdown-нумерация) | ✅ `questionfmt` + `questioncmd` + `deliveryfmt`, покрыто тестами |
|
||
| Приём ответа реплаем | ✅ `BuildInboundReply` через `RootID` (`channel/mattermost/inbound.go`) |
|
||
| `ask` как режим разрешений | ✅ `mattermost` в списке каналов (`permissions/service.go`) |
|
||
|
||
📌 `ask` — это режим политики разрешений агента; механизм вопросов — отдельный слой.
|
||
Оба в MM работают.
|
||
|
||
⛔ **Инлайн-кнопок и реакций в MM нет** — только Telegram. Событие `reaction`
|
||
сознательно отбрасывается в `channel/mattermost/ingress.go`.
|
||
|
||
---
|
||
|
||
## 5. Фазы
|
||
|
||
> ⚠️ Переписано под топологию §1 (стек на Mac). Прежняя фаза C3 («переписать `PROVIDERS`
|
||
> в мосте») **отменена**: мост в новой топологии не нужен.
|
||
|
||
### C0 — ✅ ЗАКРЫТА 2026-09-29
|
||
|
||
Разведка npm: готовый ACP-адаптер к DeepSeek существует (§2.1). Свой адаптер не нужен.
|
||
|
||
**Метод поиска:** прямые URL `registry.npmjs.org/<scope>%2f<name>` и
|
||
`/-/v1/search?text=...`. ⛔ Поиск по `scope:normahq` и `scope:baldaworks` даёт пусто —
|
||
scoped-пакеты так не индексируются.
|
||
|
||
### C1 — переезд стека на Mac (2-3 ч)
|
||
|
||
Объём вырос относительно исходного варианта: теперь это не «установка callee в контейнер»,
|
||
а **переезд Балды на Mac + установка инструментов рядом**.
|
||
|
||
| # | Шаг | Проверка |
|
||
|---|---|---|
|
||
| 1 | Запустить второй инстанс `balda-mm:0.1.13` на Mac | контейнер Up, лог `Balda bot started` |
|
||
| 2 | 🔴 **Отдельный MM-бот и токен для Mac-инстанса** | два процесса на один WebSocket MM рвут события (`bad_seq`) |
|
||
| 3 | `npm i -g @baldaworks/callee` на Mac | `callee --version` |
|
||
| 4 | `npm i -g @openma/deepseek-harness-acp` | `dsh-acp --help` |
|
||
| 5 | `callee setup codex` → стартовые ресурсы | `callee agent list` содержит `workflows/investigate` |
|
||
| 6 | Установить Beads `bd` | `bd where` |
|
||
| 7 | Импорт prism-пака | `callee agent view prism/lifecycle --json` → `Router` |
|
||
| 8 | `obsidian-mcp` рядом с Балдой (том `~/obsidian:/vault`) | `/sse` отвечает |
|
||
| 9 | Прогон стартового `investigate` | артефакт в stdout, exit 0 |
|
||
|
||
**Решения по хранению (принять на C1):** установки должны переживать пересборку образа —
|
||
том или `Dockerfile`.
|
||
|
||
### C1a — доступы и исполнители (объём зависит от развилки)
|
||
|
||
Закрывает шесть сценариев из §2.5. **Объём определяется выбором в §6.7:**
|
||
|
||
| Что нужно | Как |
|
||
|---|---|
|
||
| `~/.ssh` в контейнере | монтирование **конкретных ключей** с `command=` в `authorized_keys`, не каталога целиком |
|
||
| `docker build` | ❌ **не через `docker.sock`**; либо обёртка на хосте, либо хост-исполнитель |
|
||
| `lume` | ❌ в контейнер не пробрасывается; хост-исполнитель |
|
||
| `xcodebuild` | ❌ в Linux-контейнере невозможно; **lume VM с macOS** |
|
||
| `~/Developer` | рабочая копия в `~/agents/<проект>` + git (см. §1.1a) |
|
||
| Доступ к хостам (TrueNAS, Kraken) | ssh-ключ с ограничением `command=` |
|
||
|
||
### C2 — Role к DeepSeek (1 ч)
|
||
|
||
Описать `Role` по §2.3 и проверить один визит вживую.
|
||
|
||
**Гейт:** в логе видны `role_model` и `role_reasoning`. До успешного рендера провайдера
|
||
эти поля опускаются — их появление означает, что рендер прошёл.
|
||
|
||
### C3 — ~~подключение к мосту~~ ОТМЕНЕНА
|
||
|
||
Мост `agents-bridge` в топологии «стек на Mac» не участвует. Фаза сохраняется только как
|
||
**план отката** к топологии «Kraken-оркестратор», если переезд не оправдается.
|
||
|
||
### C4 — таск-трекинг (1-2 ч)
|
||
|
||
1. `bd` инициализируется в рабочей области.
|
||
2. Прогон `prism:story` на реальной задаче.
|
||
3. Проверить durable: прервать сессию, возобновить Story — состояние в Beads на месте.
|
||
|
||
### C5 — сквозная приёмка (1 ч)
|
||
|
||
От **учётки Alex**, не подставным аккаунтом:
|
||
|
||
```
|
||
@balda добавь CSV-экспорт в отчёт
|
||
→ Specify → Design → Breakdown → Human approval → Apply → Verify
|
||
→ ответ в Mattermost + артефакт
|
||
```
|
||
|
||
Доказательство — лента `qentra:balda-test`, автор поста `cbwsorzwoigbtrdnteugnx4aqo`.
|
||
|
||
---
|
||
|
||
## 6. Решения
|
||
|
||
> ⚠️ Решения по §2.6 (отлов опасных команд) **не приняты** — это зафиксированное исследование,
|
||
> не выбор. Развилки ниже помечены явно.
|
||
|
||
| # | Вопрос | Решение | Почему |
|
||
|---|---|---|---|
|
||
| 1 | Провайдер обеих сторон | DeepSeek | команда Alex |
|
||
| 2 | Оркестрация | callee | документированная архитектура вместо самодельной |
|
||
| 3 | Таск-трекинг | prism + Beads | задание Alex |
|
||
| 4 | Где живёт стек | **Mac целиком** | исполнение работает с файлами Mac → обязано быть рядом |
|
||
| 5 | Где MM-сервер | **Kraken** | единственный, кому нужна доступность 24/7 |
|
||
| 6 | Тип провайдера | `generic_acp` | список типов закрытый, DeepSeek в нём нет |
|
||
| 7 | 🔴 **Открыто: доступ к Xcode/lume/docker** | **не решено** | узкий контейнер (три операции недоступны) vs гибрид с хост-исполнителем |
|
||
| 8 | Роли: где живут | статично, файлами в каталоге | рантайм-выдачи ролей в callee не существует (§1.1b) |
|
||
| 9 | Права | `права процесса × монтирование × граф` | гейт `Human` защищает действие, но не возможность (§1.1a) |
|
||
| 10 | Мост `:8790` / MCP `:8890` | **демонтируются** | лишние посредники без содержательной работы |
|
||
| 11 | Старый инстанс на Kraken | **оставить живым как запасной** | откат без пересборки; ⚠️ требует отдельного MM-бота |
|
||
|
||
---
|
||
|
||
## 7. Питфоллы
|
||
|
||
1. 🔴 **Два инстанса Балды на один MM-бот = рвут WebSocket друг другу.** Симптом —
|
||
`bad_seq`, события не приходят. Mac-инстансу нужен **отдельный бот и токен**.
|
||
2. 🔴 **`docker.sock` в контейнер не монтировать никогда** — эквивалент root на хосте
|
||
(через сокет запускается контейнер с `-v /:/host`).
|
||
3. 🔴 **`~/.ssh` целиком не монтировать** — один ключ даёт доступ ко всем хостам.
|
||
Только конкретные ключи + `command=` в `authorized_keys`.
|
||
4. 🔴 **ACP-провайдер — дочерний процесс callee.** Движок на хосте + callee в контейнере
|
||
невозможны: один процесс-тред. Где callee, там и движки, и Script'ы.
|
||
5. 🔴 **Гейт `Human` защищает действие, но не возможность.** Права определяет процесс и
|
||
монтирование, не граф (§1.1a).
|
||
6. ⚠️ **`prism/lifecycle` должен быть `Router`** — `Sequential` означает устаревший
|
||
импорт, лечится `--force`.
|
||
7. ⚠️ **Provider `cmd` — одно имя файла, не shell-строка.** Аргументы — только
|
||
в `extraArgs`.
|
||
8. ⚠️ **Никогда не маршрутизировать вывод модели в `cmd`/`extraArgs`.**
|
||
9. ⚠️ **Установки в контейнере не переживают пересборку** — том или `Dockerfile`.
|
||
10. ⚠️ **`docker-compose` (дефис) на Mac, `docker compose` (пробел) на Kraken.**
|
||
11. ⚠️ **Node `>= 22.15`** требуется адаптером (в образе 24.21.0).
|
||
12. ⚠️ **Динамических маунтов на macOS Docker нет** — только `up -d` с пересозданием.
|
||
Доступ к проектам — через рабочую копию в `~/agents` + git, не через маунт под задачу.
|
||
13. 🔴 **Граф не видит команды внутри ACP-сессии.** Узел `Human`/`Script` закрывает только то,
|
||
что само вынесено в граф; обычный `bash` модели идёт мимо (§2.6).
|
||
14. 🔴 **Jev не запрещает и не спрашивает — он возвращает числа.** Без вашего `if` по порогам
|
||
тул выполнится как обычно (§2.6).
|
||
|
||
---
|
||
|
||
## 8. Риски
|
||
|
||
| Риск | Оценка | Митигация |
|
||
|---|---|---|
|
||
| 🔴 **Mac спит → бот не отвечает** | **высокий** | `caffeinate` / Energy Saver; MM-сервер на Kraken жив всегда, Mac переподключается |
|
||
| 🔴 **Развилка доступа к Xcode/lume/docker не решена** | **высокий** | решить до C1a (§6.7) |
|
||
| Хост-исполнитель = дыра в изоляции | средний | узкий набор операций (3 шт.), явный и названный |
|
||
| Два инстанса Балды конфликтуют по MM | средний | отдельный бот/токен для Mac-инстанса |
|
||
| Импорт `prism/*` устаревает при обновлении | средний | проверять `kind: Router` после каждого импорта |
|
||
| callee обновляется и меняет контракт | средний | пиннить версию в ресурсах |
|
||
| Переезд стека с Kraken не оправдается | средний | оставить Kraken-инстанс живым как запасной (§6.11) |
|
||
| Стоимость DeepSeek растёт | низкий | исполнитель-роли — короткие визиты |
|
||
| Установка в контейнер не переживёт пересборку | низкий | том или `Dockerfile` |
|
||
|
||
---
|
||
|
||
## 9. Порядок и запреты
|
||
|
||
**Порядок:** C1 → C1a → C2 → C4 → C5. (C3 отменена.)
|
||
|
||
**НЕ трогать в `~/Developer/balda`:** `go.mod`, `Dockerfile.release`, `go.sum`,
|
||
`internal/apps/balda/app.go`, `internal/apps/balda/preflight.go` — вне PR-дерева,
|
||
нужны для сборки стенда. `git checkout -- .` / `stash` / `reset --hard` их снесёт.
|
||
См. [[personal/plans/balda-mm-pr-plan]] §5.
|
||
|
||
**НЕ начинать работу** без явного «поехали».
|
||
**Ничего не удалять** без отдельного подтверждения. В частности: Kraken-инстанс Балды,
|
||
образы для отката, диагностические контейнеры, старые теги.
|
||
|
||
---
|
||
|
||
## Связанные заметки
|
||
|
||
- [[personal/tech/callee-prism]] — **справочник по контрактам callee и prism**
|
||
- [[personal/projects/balda/balda-mm-delegation-plan]] — общий план Фаз 1-5
|
||
- [[personal/plans/balda-mm-phase4-agents]] — Фаза 4 (мост :8790, приёмка)
|
||
- [[personal/plans/balda-mm-pr-plan]] — Фаза 2 (PR #8)
|
||
- [[personal/projects/balda/balda-kraken-mm-deploy]] — Фаза 3
|
||
- [[personal/tech/agents-bridge]] — мост :8790
|
||
- [[personal/tech/balda-executor-mcp]] — MCP-сервер делегирования
|