dsh-telegram-multiagent 1.3.0 → 1.4.1

package/src/index.js

@@ -99,6 +99,10 @@ export function apply(ctx, config = {}) {
   // Имя агента — только для журнала: при нескольких ботах на машине нужно
   // видеть, чья строка. К логике отношения не имеет.
   const who = config.agentName || 'telegram';
+  // 🔴 Отдельная переменная, а НЕ повторное использование `who`: ниже, в ветке
+  // отказа чужому, `who` затенена локальной `const who = msg.from ?? {}`, и
+  // подстановка дала бы «[object Object]» вместо имени. Форма взята дословно
+  // из опубликованного 1.3.0, чтобы места не разъезжались при следующей правке.
   const who_ = config.agentName || 'агент';   // для текстов, видимых собеседнику
   const log = (m) => console.error(`[${who}] ${m}`);
 
@@ -123,7 +127,7 @@ export function apply(ctx, config = {}) {
   // улетит в чат владельца. Ключ — сессия, значение — 'a2a' или 'tg'.
   const lastOrigin = new Map();
 
-  // 🔴 СЛИЯНИЕ КАНАЛОВ В ОДНУ ПАМЯТЬ (20.08.2026, решение владельца).
+  // 🔴 СЛИЯНИЕ КАНАЛОВ В ОДНУ ПАМЯТЬ (20.08.2026, решение владельца машины).
   // mergeChatIntoA2A: <идентификатор чата> — сообщения этого чата попадают НЕ в
   // свою сессию `telegram-<чат>`, а в служебную. Тогда владелец и координатор
   // говорят с ОДНИМ агентом и одной памятью разговора, а различает он их по
@@ -134,14 +138,14 @@ export function apply(ctx, config = {}) {
   // Куда отвечать в мессенджер, если сессия общая: sessionId → числовой чат.
   const tgChatFor = new Map();
 
-  // 🔴 КОМУ АДРЕСОВАН ОТВЕТ (21.08.2026, задача владельца).
+  // 🔴 КОМУ АДРЕСОВАН ОТВЕТ (21.08.2026, задача владельца машины).
   // Пометка на ВХОДЕ решает «кто спросил», но не решает «кому отвечено»: когда в
   // одной памяти сидят двое, ответ без адреса читается обоими как свой. И хуже:
   // маршрут «отвечаем последнему спросившему» ломается, если второй вопрос
   // пришёл, пока первый ещё считается, — ответ уедет не тому.
   // Поэтому происхождение привязано к ХОДУ, а не к последнему сообщению: на
   // входе кладём в очередь, на turn/start снимаем, ответ метим тем, что сняли.
-  // ── НАСТРОЙКА ДОСТАВКИ, ОТДЕЛЬНЫМ ФАЙЛОМ (21.08.2026, задача владельца)
+  // ── НАСТРОЙКА ДОСТАВКИ, ОТДЕЛЬНЫМ ФАЙЛОМ (21.08.2026, задача владельца машины)
   //
   // Файл живёт ВНЕ модуля и переживает его обновление: код можно переписать,
   // перевыпустить, поставить заново — настройка останется. Читается на лету,
@@ -217,21 +221,57 @@ export function apply(ctx, config = {}) {
   // 🔴 НИКАКИХ ТИХИХ ВЫХОДОВ: каждая ветка что-то пишет в журнал. Ровно на этом
   // обжглись сегодня — `agent.inbox?.hasPending` при недоступном inbox даёт
   // undefined, условие «всё хорошо» проходит, и отказ маскируется под успех.
+  // ── ЧЕТЫРЕ ИСХОДА ВМЕСТО ДВУХ (обосновано замером 01.09.2026).
+  // Прежняя редакция знала только «забрано» и «не забрали», и второе печаталось
+  // бедой. Замер за сутки: 48 писем принято, 45 строк «не забрали», побудок за всё
+  // время НОЛЬ, а настоящая задержка доставки — медиана 10 с. То есть беда
+  // объявлялась при штатной работе, 94 раза из 100.
+  //
+  // Две причины, обе исправлены здесь:
+  //  1) проверка «забрано ли» стояла ПОСЛЕ проверки занятости, и при занятом агенте
+  //     очередь не смотрелась вовсе — выйти из цикла было структурно нельзя, пока
+  //     агент работает. Теперь состояние очереди проверяется ПЕРВЫМ и от занятости
+  //     не зависит: забрано — значит забрано, кто бы чем ни был занят;
+  //  2) «агент был занят весь срок» и «агент свободен, а письмо висит» — разные
+  //     новости. Первое — сведение о штатном состоянии, второе — отказ механизма.
+  //     Раньше обе давали одну красную строку, и настоящий отказ утонул бы в шуме.
+  //
+  // 🔴 ГДЕ НЕ ПРИМЕНЯЕТСЯ И ЧЕГО НЕ ЛОВИТ:
+  //  • это наблюдение, а не доставка: письмо доходит и без побудки, платформа
+  //    заберёт его на следующем ходе. Молчание механизма не означает потери;
+  //  • «занят все проверки» не доказывает, что письмо доставлено — только что
+  //    будить было некого. Момент забора виден лишь при выходе по пустой очереди;
+  //  • очередь, опустевшая уже на первой проверке, неотличима от «письмо вклеено
+  //    в идущий ход» — поэтому такой случай помечается отдельно, а не молчит.
+  //
+  // 🔴 НИКАКИХ ТИХИХ ВЫХОДОВ: каждая ветка что-то пишет в журнал.
   function nudgeUntilClaimed(agent, tag, budgetMs = 120000) {
     void (async () => {
-      const deadline = Date.now() + budgetMs;
-      let woke = 0;
+      const nachato = Date.now();
+      const deadline = nachato + budgetMs;
+      let woke = 0;       // сколько раз будили
+      let proverok = 0;   // сколько проходов сделали
+      let zanyat = 0;     // из них пришлось на занятого агента
+      let videliOchered = false;  // видели ли очередь непустой хоть раз
       while (Date.now() < deadline) {
         await new Promise((r) => setTimeout(r, 500));
+        proverok += 1;
         if (typeof agent?.inbox?.hasPending !== 'boolean') {
           log(`${tag} 🔴 очередь агента недоступна — добивать побудку нечем`);
           return;
         }
-        if (agent.status === 'running') continue;
+        // Забрано ли — вопрос о ПИСЬМЕ, а не об агенте. Спрашиваем всегда.
         if (!agent.inbox.hasPending) {
-          if (woke) log(`${tag} сообщение забрано после ${woke} повторных побудок`);
+          const sek = ((Date.now() - nachato) / 1000).toFixed(1);
+          const primech = videliOchered
+            ? ''
+            : ' (очередь была пуста уже на первой проверке — вероятно, письмо вклеено в идущий ход)';
+          log(`${tag} сообщение забрано за ${sek} с: побудок ${woke}, проверок ${proverok}${primech}`);
           return;
         }
+        videliOchered = true;
+        // А вот будить — вопрос об АГЕНТЕ: занятого будить незачем и нечем.
+        if (agent.status === 'running') { zanyat += 1; continue; }
         if (typeof agent.wakeDriver !== 'function') {
           log(`${tag} 🔴 сообщение висит в очереди, а wakeDriver недоступен`);
           return;
@@ -239,7 +279,11 @@ export function apply(ctx, config = {}) {
         agent.wakeDriver();
         woke += 1;
       }
-      log(`${tag} 🔴 за ${budgetMs} мс сообщение так и не забрали (побудок: ${woke})`);
+      if (proverok > 0 && zanyat === proverok) {
+        log(`${tag} письмо ещё в очереди спустя ${budgetMs} мс: агент был занят все ${zanyat} проверок из ${proverok} — будить было некого, состояние штатное`);
+      } else {
+        log(`${tag} 🔴 за ${budgetMs} мс сообщение так и не забрали: агент был свободен ${proverok - zanyat} проверок из ${proverok}, побудок ${woke} — побудка не помогла`);
+      }
     })();
   }
 
@@ -271,24 +315,19 @@ export function apply(ctx, config = {}) {
    * cordis возвращает undefined БЕЗ ошибки, пока волокно поставщика не активно
    * (ReflectService._getImpl: `if (strict && impl.fiber.state !== 2) return;`).
    * Значит «сервиса нет в сборке» и «сервис ещё поднимается» приходят одним и
-   * тем же значением, и код, написанный как `const x = ctx.get('x'); if (x)`,
-   * тихо уходит по ветке «этой возможности просто нет». Снаружи это выглядит
-   * штатной работой: агент собирается, отвечает и молчит о том, чего лишился.
+   * тем же значением, и код вида `const x = ctx.get('x'); if (x)` тихо уходит по
+   * ветке «этой возможности просто нет». Снаружи это штатная работа.
    *
-   * Поймано трижды за три дня, каждый раз дороже предыдущего:
-   *   19.08.2026 — фабрика агентов (см. withFactoryRetry выше);
-   *   22.08.2026 — sessionPersistence: блок продолжения истории пропускался
-   *                целиком, агент создавался поверх существующего журнала, и
-   *                КАЖДЫЙ ход умирал с «id collision» за считаные миллисекунды;
-   *   22.08.2026 — agentPresets: набор инструментов у модели упал с 33 до 3,
-   *                без ошибки и без строки в журнале.
-   * Общий вывод, ради которого функция ОДНА, а не три: лечение, применённое к
-   * экземпляру, а не ко всем местам класса, гарантирует рецидив.
+   * Поймано трижды за три дня: 19.08 фабрика агентов (withFactoryRetry выше),
+   * 22.08 sessionPersistence (блок продолжения пропускался целиком, агент
+   * создавался поверх существующего журнала, каждый ход умирал с «id collision»),
+   * 22.08 agentPresets (набор инструментов у соседа упал с 33 до 3 без единой
+   * строки в журнале). Лечение экземпляра вместо класса гарантирует рецидив —
+   * поэтому функция ОДНА и форма у неё одна с опубликованным пакетом 1.2.3.
    *
-   * ГРАНИЦА ОЖИДАНИЯ — назвать обязательно, иначе защита сама станет отказом:
-   * ждём не дольше `tries` секунд и только при заведении агента. Не дождались —
-   * говорим ГРОМКО, называем последствие и идём дальше. Канал не запирается там,
-   * где сервиса в сборке нет вовсе (это законная сборка, а не поломка).
+   * ГРАНИЦА ОЖИДАНИЯ: не дольше `tries` секунд и только при заведении агента.
+   * Не дождались — говорим ГРОМКО, называем последствие и идём дальше. Канал не
+   * запирается там, где сервиса в сборке нет вовсе: это законная сборка.
    */
   async function waitService(name, tag, consequence, tries = 30) {
     for (let i = 0; i < tries; i++) {
@@ -305,36 +344,38 @@ export function apply(ctx, config = {}) {
   }
 
   /**
-   * 🔴 РЕШЕНИЕ ПО КАЖДОМУ ctx.get() В ЭТОМ ФАЙЛЕ. Проверять надо КАЖДЫЙ, а не
-   * тот, на котором обожглись, — иначе рецидив, и рецидив будет выглядеть новой
-   * болезнью, потому что рядом лежит доказательство «мы это уже лечили».
+   * 🔴 РЕШЕНИЕ ПО КАЖДОМУ ctx.get() В ЭТОМ ФАЙЛЕ (23.08.2026, уточнено при
+   * сведении с копией соседа). Проверять надо КАЖДЫЙ, а не тот, на котором
+   * обожглись, — иначе рецидив.
    *
-   * ПРИЗНАК, по которому решается, а не «кажется безопасным»: ожидание нужно
-   * там, где место может сработать ДО подъёма сервиса И отказ при этом
-   * МОЛЧАЛИВ ИЛИ ЛОЖЕН. Одного условия мало.
+   * ПРИЗНАК: ожидание нужно там, где место может сработать ДО подъёма сервиса
+   * И отказ при этом МОЛЧАЛИВ ИЛИ ЛОЖЕН. Второе добавлено сознательно: раньше
+   * здесь было записано «отказ громкий — значит ждать не надо», и это было
+   * ошибкой. Громкий отказ «сервис не подключён» — это ДИАГНОЗ, которого код
+   * поставить не может: undefined одинаково означает и «нет в сборке», и «ещё
+   * поднимается». Механизм не вправе утверждать то, чего не в силах установить.
    *
-   * Отдельно замечено на живом: порядок готовности волокон МЕНЯЕТСЯ от подъёма
-   * к подъёму. В одном подъёме ждала фабрика агентов, в другом — набор пресета,
-   * причём гонка была в обоих. Значит судить о гонке по соседнему сервису
-   * нельзя: соседний в этот раз мог успеть. Ожидание ставится по устройству
-   * места, а не по тому, где однажды видели примету.
+   * И отдельно, доказано на живом 23.08: порядок готовности волокон МЕНЯЕТСЯ
+   * от подъёма к подъёму — в одном ждала фабрика агентов, в другом набор
+   * пресета, а гонка была в обоих. Значит судить о гонке по соседнему сервису
+   * нельзя, ожидание ставится по устройству места, а не по примете.
    *
-   *   1) agentFor → agentPresets, agentDefaultModel, sessionPersistence.
-   *      ОЖИДАНИЕ ЕСТЬ, предел 30 с: заведение агента идёт вплотную к подъёму
-   *      платформы, а отказ здесь молчалив и разрушителен.
-   *   2) goalCommand → goals, goalMarker, mcpBridge. ОЖИДАНИЕ ЕСТЬ, предел
-   *      короткий (GOAL_WAIT_TRIES): по undefined невозможно отличить «сервиса
-   *      нет в сборке» от «ещё поднимается», а ответ «не подключён» — это
-   *      диагноз, которого код поставить не может. Ждём мало, потому что на том
-   *      конце живой собеседник.
-   *   3) stripGoalMarker → goalMarker. ОЖИДАНИЯ НЕТ намеренно: место
-   *      СИНХРОННОЕ (обработчик события сессии не async), а отказ не молчалив —
+   *   1) agentFor → agentPresets, agentDefaultModel, sessionPersistence:
+   *      ОЖИДАНИЕ ЕСТЬ, предел 30 с — заведение агента идёт вплотную к подъёму
+   *      платформы, отказ молчалив и разрушителен.
+   *   2) goalCommand → goals, goalMarker, mcpBridge: ОЖИДАНИЕ ЕСТЬ, предел
+   *      короткий (GOAL_WAIT_TRIES) — на том конце живой собеседник.
+   *   3) stripGoalMarker → goalMarker: ОЖИДАНИЯ НЕТ намеренно. Место
+   *      СИНХРОННОЕ (обработчик события сессии не async), а отказ не молчалив:
    *      маркер уезжает в чат видимым текстом.
-   *   4) обработчик goal/change → goals. ОЖИДАНИЯ НЕТ намеренно: сюда попадают
-   *      только те сессии, где цель уже поставлена через goalCommand, а тот без
-   *      сервиса целей не проходит вовсе. Значит пустота здесь означает не «ещё
-   *      не поднялся», а «сервис ПРОПАЛ», и это надо не переждать, а сказать.
+   *   4) обработчик goal/change → goals: ОЖИДАНИЯ НЕТ намеренно. Сюда попадают
+   *      только сессии, где цель уже поставлена через goalCommand, а тот без
+   *      сервиса целей не проходит. Значит пустота означает не «ещё не
+   *      поднялся», а «сервис ПРОПАЛ», и это надо сказать, а не переждать.
    */
+  // Сколько секунд ждать сервис на пути КОМАНДЫ (не на заведении агента).
+  // Пять, а не тридцать: на том конце живой собеседник, см. goalCommand.
+  const GOAL_WAIT_TRIES = 5;
 
   async function agentFor(chatId) {
     const key = String(chatId);
@@ -359,8 +400,6 @@ export function apply(ctx, config = {}) {
     const setupFn = async (agentCtx) => {
       platform.installModelSelection(agentCtx, { current: selection, assembled: undefined });
       if (presets && presetId) await presets.mount(agentCtx, presetId);
-      // Молча остаться без инструментов нельзя: снаружи это выглядит как
-      // «агент отупел», а причина — несмонтированный пресет.
       else log(`[${key}] 🔴 пресет НЕ смонтирован (presets=${!!presets}, presetId=${presetId})`);
     };
 
@@ -376,6 +415,17 @@ export function apply(ctx, config = {}) {
     // события turn/end (раньше плагин печатал только тип события).
     // Правильный путь — ctx.agents.resume(): «загрузить сохранённую сессию и
     // продолжить агента на ней» (dsh-agent/lib/index.js, resume()).
+    // 🔴 СЕРВИС ПЕРСИСТЕНЦИИ ПОЯВЛЯЕТСЯ ПОЗЖЕ КАНАЛА — та же болезнь, что у фабрики
+    // агентов выше, и тот же почерк: ctx.get() отдаёт undefined ТИХО, пока волокно
+    // поставщика не активно (cordis, ReflectService._getImpl:
+    //   `if (strict && impl.fiber.state !== 2) return;`),
+    // исключения при этом нет. Без ожидания весь блок продолжения молча
+    // пропускался, агент создавался заново поверх существующего журнала, и КАЖДЫЙ
+    // ход умирал с «id collision». Поймано 22.08.2026: подъём 18:53 не напечатал
+    // ни строки о продолжении, ни об отказе — молчание и было ответом.
+    // ГРАНИЦА ОЖИДАНИЯ: ждём не дольше 30 с и только здесь, при заведении агента.
+    // Не дождались — говорим об этом громко и идём создавать, иначе канал запрётся
+    // навсегда там, где персистенции в сборке просто нет.
     const persistence = await waitService('sessionPersistence', `[${key}]`,
       'сохранённую сессию продолжить нечем, история будет потеряна');
     let handle;
@@ -384,15 +434,16 @@ export function apply(ctx, config = {}) {
       try {
         known = (await persistence.list()).map((h) => h.id);
       } catch (e) {
-        log(`🔴 [${key}] не смог перечислить сохранённые сессии: ${e?.message ?? e}`);
+        log(`🔴 [${key}] не смогла перечислить сохранённые сессии: ${e?.message ?? e}`);
       }
-      // 🔴 УХОДИТЬ В create() МОЛЧА НЕЛЬЗЯ — ЭТО ВТОРОЙ ТИХИЙ ПУТЬ В ЭТОЙ ЖЕ
-      // ФУНКЦИИ. Снаружи он неотличим от честного первого запуска, а на деле
-      // означает create() поверх существующего журнала и «id collision» на
-      // каждом ходе. Поэтому список сообщаем ЧИСЛОМ и именами.
+      // 🔴 УХОДИТЬ В create() МОЛЧА НЕЛЬЗЯ. Снаружи это неотличимо от штатного
+      // первого запуска, а на деле означает потерю истории и id collision на
+      // каждом ходе. Поэтому отсутствие своей сессии в списке — громкая строка
+      // с числом найденных и их именами, а не тишина.
       if (known !== undefined && !known.includes(sessionId)) {
-        // Пустой список — честный первый запуск, тревожить нечем. Тревога там,
-        // где сохранённые сессии ЕСТЬ, а нашей среди них нет.
+        // Пустой список — это честный первый запуск, а не беда: тревожить нечем.
+        // Тревога начинается там, где сохранённые сессии ЕСТЬ, а нашей среди них
+        // нет: значит журнал на диске остался, и create() сейчас об него разобьётся.
         if (known.length === 0) log(`[${key}] сохранённых сессий на диске нет — ${sessionId} заводится впервые`);
         else {
           // ⚠️, а не 🔴, СОЗНАТЕЛЬНО: по одному списку два исхода неразличимы —
@@ -476,36 +527,33 @@ export function apply(ctx, config = {}) {
     }
   }
 
-  // ── ПОСТАНОВКА ЦЕЛИ ИЗ КАНАЛА (21.08.2026, задача владельца).
+  // ── ПОСТАНОВКА ЦЕЛИ ИЗ КАНАЛА (21.08.2026, распоряжение главной).
   //
-  // ЗАЧЕМ. Когда цикл ведёт внешний движок (агент работает через подписку, а не
-  // через родной цикл платформы), инструменты платформы до модели НЕ ДОХОДЯТ
-  // вовсе — доходит только то, что имеет форму СООБЩЕНИЯ. Значит поставить цель
-  // изнутри разговора нельзя, а руками в веб-интерфейсе — можно. Здесь мы даём
+  // ЗАЧЕМ. На подписочном маршруте цикл ведёт движок, поэтому родные
+  // инструменты платформы (goal/jobs) до модели НЕ ДОХОДЯТ вовсе — доходит
+  // только то, что имеет форму СООБЩЕНИЯ. Значит поставить цель изнутри
+  // разговора нельзя, а руками в веб-интерфейсе — можно. Здесь мы даём
   // постановку из любого канала: сервис целей доступен КОДУ модуля как
   // ctx.get('goals'), инструмент модели для этого не нужен.
   //
   // КТО ВПРАВЕ. Отдельные настройки, обе по умолчанию ВЫКЛЮЧЕНЫ:
-  //   goalUsers: [<числовые id>]     — кто ставит цель из Telegram
-  //   goalA2ASenders: ["<имя>", …]   — кто вправе из служебного канала
+  //   goalUsers: [<числовые id>]  — кто ставит цель из Telegram
+  //   goalFromA2A: true|false     — вправе ли служебный канал
   // Право НЕ наследуется от allowedUsers сознательно: allowedUsers — это
   // «с кем я вообще разговариваю», и завтра туда добавят гостя. Право завести
   // дорогой автономный цикл шире права поговорить.
-  //
-  // 🔴 ЧЕМ ЗА ЭТО ПЛАТИМ, назвать обязательно: проверки платформы
-  // (currentInitiator, hasDirectHumanInput, roots) живут в её инструменте целей
-  // и на ЭТОМ пути не участвуют. Мы не обходим политику — мы пишем её заново,
-  // и две строки ниже есть вся политика целиком. Пустые списки = постановка
-  // отключена; это умолчание выбрано нарочно.
+  // Проверки платформы (currentInitiator, hasDirectHumanInput, roots) живут в
+  // tool-goal и на этом пути НЕ участвуют: мы не обходим политику, мы пишем её
+  // заново, и вот эти две строки — вся политика целиком.
   const goalUsers = new Set((config.goalUsers ?? []).map(Number));
-  // 🔴 ПРАВО ИЗ СЛУЖЕБНОГО КАНАЛА — ПОИМЁННО, А НЕ «КАНАЛУ ЦЕЛИКОМ». Признак
-  // источника получает ЛЮБОЕ сообщение служебного канала, а каталог обмена
-  // бывает общим на несколько машин: правом «всем, кто пишет в канал» мы
-  // раздали бы возможность заводить дорогие циклы кому попало.
-  // Отправитель называет себя первой строкой файла:  From: <имя>
+  // 🔴 ПРАВО ИЗ СЛУЖЕБНОГО КАНАЛА — ПОИМЁННО, А НЕ «КАНАЛУ ЦЕЛИКОМ» (21.08.2026,
+  // поправка главной к собственному замыслу). Вид источника 'a2a' получает ЛЮБОЕ
+  // сообщение служебного канала, а канал на ферме общий — правом «всем, кто пишет
+  // в a2a» мы раздали бы возможность заводить дорогие циклы кому попало.
+  // Отправитель называет себя первой строкой файла:  From: <инстанс>/<папка>
   // Нет заголовка или имени нет в списке — отказ, и он произносится вслух.
   const goalA2ASenders = new Set(config.goalA2ASenders ?? []);
-  // sessionId → { channel, agent } — куда сообщить об исходе цели.
+  // sessionId → { channel, chatId } — куда сообщить об исходе цели.
   const goalOrigin = new Map();
   // канал → метки времени постановок, для счётчика ниже.
   const goalStarts = new Map();
@@ -513,26 +561,22 @@ export function apply(ctx, config = {}) {
   // 🔴 СЧЁТЧИК ПОСТАНОВОК: не более трёх за скользящий час на канал.
   //
   // ОТ ЧЕГО ЗАЩИЩАЕТ: от СЛУЧАЙНОСТИ и РАЗГОНА — от петли, в которую механизм
-  // вошёл сам, от ошибки в коде, от лавины повторов. Предел раундов у платформы
-  // стоит на ЦЕЛЬ, а не на агента: новая цель — новый счётчик, и поток целей
-  // ничем не ограничен. Каталог входящих принадлежит самому агенту, то есть в
-  // автономном раунде он способен положить себе файл «/goal …» и продлить цикл.
+  // вошёл сам, от ошибки в коде, от лавины повторов. Предел раундов стоит на
+  // ЦЕЛЬ, а не на агента: новая цель — новый счётчик, и поток целей ничем не
+  // ограничен. Каталог входящих принадлежит самому агенту, то есть в автономном
+  // раунде он способен положить себе файл «/goal …» и продлить цикл.
   //
-  // 🔴 ГДЕ НЕ ПРИМЕНЯЕТСЯ: счётчик НЕ защищает от намеренного действия агента,
-  // у которого есть права администратора на этой машине, — такой агент снимет
-  // и его, и предел раундов одной командой. Технической границы против самого
-  // агента здесь не существует, изоляция ПОВЕДЕНЧЕСКАЯ. Настоящий сторож —
-  // снаружи, на другой машине, вне досягаемости этого процесса.
+  // 🔴 ГДЕ НЕ ПРИМЕНЯЕТСЯ: он НЕ защищает от намеренного действия агента,
+  // у которого на этой машине полное sudo без пароля (проверено 21.08.2026:
+  // <агент> ALL NOPASSWD: ALL). Такой агент снимет и этот счётчик, и предел
+  // раундов одной командой. Технической границы против самого агента здесь
+  // не существует, изоляция ПОВЕДЕНЧЕСКАЯ. Настоящий сторож — снаружи, на
+  // другой машине, вне досягаемости этого процесса.
   //
   // ГРАНИЦЫ САМОГО СЧЁТЧИКА: снятию цели (/goal stop) он не мешает никогда —
   // механизм, включаемый снаружи и невыключаемый, хуже отсутствия механизма;
   // обнуляется перезапуском процесса; ничего не чинит сам, только отказывает.
   const GOAL_MAX_PER_HOUR = 3;
-
-  // Сколько секунд ждать сервис на пути КОМАНДЫ (не на заведении агента).
-  // Пять, а не тридцать: см. пояснение в goalCommand ниже.
-  const GOAL_WAIT_TRIES = 5;
-
   function goalRateOk(channel) {
     const now = Date.now();
     const marks = (goalStarts.get(channel) ?? []).filter((t) => now - t < 3600000);
@@ -540,12 +584,12 @@ export function apply(ctx, config = {}) {
     return marks.length < GOAL_MAX_PER_HOUR;
   }
 
-  // 🔴 ПРИЗНАК СОБСТВЕННОЙ ИСПРАВНОСТИ. Права на постановку цели заголовком
-  // запроса к модели НЕ проверяются в принципе: плагин не даёт модели ни одного
-  // инструмента и в заголовке невидим. Печатаем ЧИСЛА, а не «загрузился»: длина
-  // списка прав отличает верную настройку от пустого умолчания, при котором
-  // постановка отказывает молча и выглядит поломкой. Сами идентификаторы не
-  // печатаем — в журнал уходит устройство, а не список людей.
+  // 🔴 ПРИЗНАК СОБСТВЕННОЙ ИСПРАВНОСТИ ПЛАГИНА (22.08.2026, распоряжение главной).
+  // Права на постановку цели заголовком request/header НЕ проверяются в принципе:
+  // плагин не даёт модели ни одного инструмента и в заголовке невидим. Печатаем
+  // ЧИСЛА, а не «загрузился»: длина списка прав отличает верную настройку от
+  // пустого умолчания, при котором постановка отказывает молча и выглядит поломкой.
+  // Сами идентификаторы не печатаем — в журнал уходит устройство, а не список людей.
   log(`[goal] смонтирован: goalUsers=${goalUsers.size} goalA2ASenders=${goalA2ASenders.size} `
     + `предел постановок=${GOAL_MAX_PER_HOUR}/час`);
 
@@ -566,11 +610,25 @@ export function apply(ctx, config = {}) {
    *
    * 🔴 ЧЕСТНАЯ ГРАНИЦА, назвать её обязательно: это УЧЁТ, А НЕ ЗАЩИТА.
    * Отправитель называет себя сам, и подделать имя может любой, кто способен
-   * положить файл в каталог входящих. Настоящая граница здесь — права ОС на
-   * этот каталог: писать в него должны только сам агент и доставка. Нужна
-   * проверка сильнее самоназвания — это общий секрет в файле с правами, и
-   * заводить его нужно отдельным решением, а не походя.
+   * положить файл в каталог входящих. Настоящая граница здесь — права ОС:
+   * дом агента открыт на проход только владельцу (drwxr-x---), поэтому писать
+   * во входящие могут лишь сам агент и тот, у кого есть sudo. Проверено
+   * опытом 21.08.2026: dsh и arg получают Permission denied и на чтение, и на
+   * запись. Владелец файла отправителя НЕ выдаёт вовсе — доставка кладёт файл
+   * от root и тут же делает chown на адресата.
+   * Нужна проверка сильнее самоназвания — это общий секрет в файле с правами,
+   * и заводить его нужно решением, а не походя.
    */
+  /**
+   * Убрать маркер цели из текста, уходящего наружу. Если плагин разбора не
+   * смонтирован — текст идёт как есть: маркер в чате некрасив, но безвреден,
+   * а молча глотать ответ из-за отсутствия служебного плагина нельзя.
+   */
+  function stripGoalMarker(raw) {
+    const marker = ctx.get('goalMarker');
+    return marker ? marker.strip(raw) : raw;
+  }
+
   function splitSender(raw) {
     const nl = raw.indexOf('\n');
     const head = (nl === -1 ? raw : raw.slice(0, nl)).trim();
@@ -579,31 +637,18 @@ export function apply(ctx, config = {}) {
     return { sender: m[1], text: nl === -1 ? '' : raw.slice(nl + 1).trimStart() };
   }
 
-  /**
-   * Убрать маркер цели из текста, уходящего наружу.
-   *
-   * 🔴 ЗДЕСЬ ОЖИДАНИЯ СЕРВИСА НЕТ, И ЭТО РЕШЕНИЕ, А НЕ ПРОПУСК. Место
-   * СИНХРОННОЕ (зовётся из обработчика session/event, который не async), и
-   * отказ здесь НЕ молчалив: маркер уезжает в чат видимым текстом, читатель
-   * увидит его сам. Ждать по 30 с на каждом исходящем сообщении было бы
-   * лечением хуже болезни — см. общее решение по ctx.get() выше.
-   */
-  function stripGoalMarker(raw) {
-    const marker = ctx.get('goalMarker');
-    return marker ? marker.strip(raw) : raw;
-  }
-
   // Разбор команды. Возвращает текст ответа; отправку делает вызывающий.
   // Отказы называем вслух: молчаливый отказ здесь неотличим от «агент не понял».
   async function goalCommand(text, channel, agent) {
     const rest = text.slice('/goal'.length).trim();
-    // 🔴 ЖДЁМ СЕРВИС, А НЕ ОТКАЗЫВАЕМ СРАЗУ — и ждём КОРОТКО. Без ожидания
-    // ответ «сервис не подключён» был бы диагнозом, которого код поставить не
-    // может: undefined одинаково означает и «нет в сборке», и «ещё поднимается».
-    // Предел короткий (а не 30 с, как при заведении агента) потому, что на том
-    // конце ждёт живой собеседник: полминуты молчания в чате читаются как
-    // «бот умер», и лечение снова оказалось бы хуже болезни.
-    const goals = await waitService('goals', '[goal]', 'команда постановки цели невыполнима', GOAL_WAIT_TRIES);
+    // 🔴 ЖДЁМ СЕРВИС, А НЕ ОТКАЗЫВАЕМ СРАЗУ (23.08.2026, сведение с копией
+    // соседа — решение его, форма наша). Без ожидания ответ «не подключён» был
+    // бы диагнозом, которого код поставить не может: undefined одинаково
+    // означает и «нет в сборке», и «ещё поднимается». Предел короткий, а не
+    // 30 с как при заведении агента: на том конце ждёт живой собеседник, и
+    // полминуты молчания в чате читаются как «бот умер».
+    const goals = await waitService('goals', '[goal]',
+      'команда постановки цели невыполнима', GOAL_WAIT_TRIES);
     if (!goals) return 'Сервис целей на этом агенте не подключён.';
     let current;
     try { current = goals.get(agent); }
@@ -631,8 +676,8 @@ export function apply(ctx, config = {}) {
     }
 
     // Постановка. Предел раундов командой НЕ задаётся: он живёт в настройке
-    // платформы и не должен подниматься тем же путём, каким запускается
-    // дорогой цикл.
+    // (defaultMaxGoalRounds) и не должен подниматься тем же путём, каким
+    // запускается дорогой цикл.
     if (!goalRateOk(channel)) {
       log(`[goal] ОТКАЗ ${channel}: исчерпан предел ${GOAL_MAX_PER_HOUR} постановок за час`);
       return `Предел ${GOAL_MAX_PER_HOUR} постановок цели за час исчерпан. Зовите человека.`;
@@ -640,19 +685,19 @@ export function apply(ctx, config = {}) {
     try {
       let view = goals.create(agent, { objective: rest });
       // 🔴 НАСТАВЛЕНИЕ ПРО МАРКЕР КЛАДЁМ В САМ ЗАМЫСЕЛ. Промпт автоматического
-      // раунда несёт только замысел и номер раунда — ни идентификатора цели, ни
-      // ревизии в нём нет, а без них модель не сложит маркер. Идентификатор
-      // известен только после create, поэтому edit вторым шагом; edit поднимает
-      // ревизию на единицу, её и называем в наставлении.
+      // раунда (renderGoalRoundPrompt) несёт только Objective и Round — ни
+      // идентификатора цели, ни ревизии в нём нет, а без них модель не сложит
+      // маркер. Идентификатор известен только после create, поэтому edit вторым
+      // шагом; edit поднимает ревизию на единицу, её и называем в наставлении.
       const marker = await waitService('goalMarker', '[goal]',
         'цель будет поставлена без наставления о маркере', GOAL_WAIT_TRIES);
       if (marker) {
-        // 🔴 ИМЕНА ИНСТРУМЕНТОВ БЕРЁМ У МОСТА, А НЕ ПИШЕМ ПО ПАМЯТИ. Протокол
-        // MCP добавляет к базовому имени приставку mcp__<сервер>__; наставление,
-        // называющее инструмент БЕЗ неё, отсылает модель к несуществующему
-        // имени, и выглядит это как «мост не работает». Нет моста — нет и имён:
-        // тогда наставление честно говорит, что инструментов нет, и остаётся
-        // только пометка.
+        // 🔴 ИМЕНА ИНСТРУМЕНТОВ БЕРЁМ У МОСТА, А НЕ ПИШЕМ ПО ПАМЯТИ (22.08.2026).
+        // Протокол MCP добавляет к базовому имени приставку mcp__<сервер>__;
+        // наставление, называющее инструмент БЕЗ неё, отсылает модель к
+        // несуществующему имени, и выглядит это как «мост не работает».
+        // Нет моста — нет и имён: тогда наставление честно говорит, что
+        // инструментов нет, и остаётся только пометка.
         const bridge = await waitService('mcpBridge', '[goal]',
           'в наставлении останется только пометка, без имён инструментов', GOAL_WAIT_TRIES);
         const goalTools = bridge?.modelToolName
@@ -681,19 +726,20 @@ export function apply(ctx, config = {}) {
     // 🔴 DEBUG 2026-08-18: все типы событий
     log(`[event] type=${event.type} session.id=${session?.id} knownSessions=${[...sessionToChat.keys()].join('|')}`);
     const sid = String(session?.id ?? '');
-    // 🔴 ИСХОД ЦЕЛИ СООБЩАЕМ САМИ. Доводчик при упоре в предел раундов переводит
-    // цель в blocked — и делает это молча: снаружи автономный цикл просто
-    // перестаёт просыпаться. Молчаливый останов неотличим от поломки, поэтому
-    // говорим в тот канал, из которого цель ставили, и ровно один раз.
-    // Блок стоит ДО проверки chatId нарочно: у служебного канала числового чата
-    // нет вовсе, и ранний выход съел бы событие.
+    // 🔴 ИСХОД ЦЕЛИ СООБЩАЕМ САМИ. Доводчик при упоре в предел переводит цель в
+    // blocked — и делает это молча: снаружи автономный цикл просто перестаёт
+    // просыпаться. Молчаливый останов неотличим от поломки, поэтому говорим в
+    // тот канал, из которого цель ставили, и ровно один раз.
     if (event.type === 'goal/change') {
       const origin = goalOrigin.get(sid);
       if (origin) {
         try {
-          // Ожидания сервиса здесь нет намеренно — см. решение по ctx.get выше:
-          // сюда попадают только сессии, где цель уже поставлена, значит пустота
-          // означает не «ещё не поднялся», а «пропал», и это стоит строки.
+          // 🔴 БЫЛО МОЛЧАЛИВО: `ctx.get('goals')?.get(...)` при отсутствии
+          // сервиса возвращал undefined, и сообщение об исходе цели просто не
+          // уходило — ровно то молчание, от которого этот блок и заведён.
+          // Сервис здесь обязан быть: goalOrigin заполняет только goalCommand,
+          // а он без ctx.get('goals') не проходит. Значит пустота означает, что
+          // сервис ПРОПАЛ, и это событие само по себе стоит строки.
           const goalsSvc = ctx.get('goals');
           if (!goalsSvc) {
             log(`[goal] 🔴 сервис целей исчез — исход цели по сессии ${sid} не сообщён`);
@@ -742,7 +788,7 @@ export function apply(ctx, config = {}) {
         }
       } else if (event.type === 'assistant/message'
                  && (turnAsk.get(sid)?.origin ?? lastOrigin.get(sid) ?? (chatId === A2A_CHAT ? 'a2a' : 'tg')) === 'a2a') {
-        // ответ координатору — в файл, Telegram тут ни при чём
+        // ответ для Забавы — в файл, Telegram тут ни при чём
         const blocks = event.data?.message?.content ?? [];
         // 🔴 МАРКЕР ВЫРЕЗАЕМ ИЗ ВСЕГО, ЧТО УХОДИТ НАРУЖУ — из доставляемого
         // текста и из копий. Он служебный: его дело остановить цикл, а не
@@ -755,7 +801,7 @@ export function apply(ctx, config = {}) {
             fs.mkdirSync(A2A_OUT, { recursive: true });
             fs.writeFileSync(path.join(A2A_OUT, `${Date.now()}.txt`), replyHeader(sid) + text);
             { const c = copyTo('a2a'); if (c) sendCopy(c, sid, text); }
-            log(`[a2a] ответ координатору записан (${text.length} знаков)`);
+            log(`[a2a] ответ Забаве записан (${text.length} знаков)`);
           } catch (e) { log(`[a2a] не смог записать ответ: ${e?.message ?? e}`); }
         }
       } else if (event.type === 'assistant/message') {
@@ -793,7 +839,7 @@ export function apply(ctx, config = {}) {
     return tmp;
   }
 
-  // Расшифровывает голосовое сообщение внешней командой из настройки.
+  // Транскрибирует голосовое сообщение через нашу локальную цепочку.
   // Возвращает строку с текстом или null при ошибке.
   async function transcribeVoice(fileId) {
     let tmpAudio = null;
@@ -901,10 +947,16 @@ export function apply(ctx, config = {}) {
     const routeKey = (MERGE_CHAT && String(chatId) === MERGE_CHAT) ? A2A_CHAT : chatId;
     const { handle, sessionId } = await agentFor(routeKey);
     tgChatFor.set(sessionId, chatId);
-    // 🔴 ТОЛЬКО send(), НЕ followup(). Проверено на установленной версии 0.1.0-rc.7:
-    // followup объявлен в описании типов, но В КОДЕ ЕГО НЕТ — вызов молча не делает
-    // ничего, и снаружи это выглядит как «бот принял сообщение и замолчал».
-    // Правильный вызов подсмотрен в самом продукте: this.send(input, "next-turn", true).
+    // 🔴 ЗДЕСЬ send(), А НЕ followup() — но причина СМЕНИЛАСЬ, читай внимательно.
+    // Было (0.1.0-rc.7): followup объявлен в описании типов, а В КОДЕ ЕГО НЕТ —
+    // вызов молча не делал ничего, снаружи «бот принял сообщение и замолчал».
+    // Стало (проверено на установленной 0.1.1-rc.2, 21.08.2026): followup в коде
+    // ЕСТЬ и он ровно наш вызов — dsh-agent-loop/lib/index.js:396
+    //   followup(input) { this.send(input, "next-turn", true) }
+    // То есть обход больше не обход, а тот же самый путь, записанный явно.
+    // Оставляем send(): он работает на обеих версиях. Копии модуля разведены
+    // 22.08.2026 по агентам, но версии платформ у них разные (0.1.1-rc.2 и
+    // 0.1.0-rc.8), и код обязан работать на обеих.
     //   next-turn — обычный следующий ход;
     //   true      — разбудить исполнителя, иначе сообщение будет ждать вечно.
     lastOrigin.set(sessionId, 'tg');
@@ -941,8 +993,8 @@ export function apply(ctx, config = {}) {
   // пользователя, а бот боту не пишет — так устроен мессенджер. Поэтому связь
   // через каталог обмена, он же работает поверх ssh с любой машины фермы.
   //
-  //   входящие мне:  <a2aDir>/in/*.txt   — кладёт координатор, я передаю агенту
-  //   исходящие ей:  <a2aDir>/out/*.txt  — пишет агент, забирает координатор
+  //   входящие мне:  <дом агента>/a2a/in/*.txt   — кладёт координатор, я передаю агенту
+  //   исходящие ей:  <дом агента>/a2a/out/*.txt  — пишет агент, забирает координатор
   // Каталог обмена задаётся настройкой: у каждого агента он свой. Не задан —
   // межагентского канала у этого агента просто нет, и опрос не ведётся вовсе
   // (молчаливое создание чужих каталогов было бы хуже отсутствия связи).
@@ -951,6 +1003,54 @@ export function apply(ctx, config = {}) {
   const A2A_OUT = A2A_DIR ? path.join(A2A_DIR, 'out') : null;
   const A2A_CHAT = config.a2aSession || 'a2a';  // отдельная сессия, не смешивается с Telegram
 
+  // ── ВТОРОЙ ИСТОЧНИК ВХОДЯЩИХ: ЯЩИК ШИНЫ A2A (31.08.2026) ────────────────────
+  // Шина между агентами машины: отправитель кладёт письмо в щель
+  // /var/spool/a2a/<получатель>/ (каталог 1730: опустить можно, прочесть нельзя),
+  // почтальон a2a-pochtalon раз в 5 с переносит его в собственность получателя,
+  // а забрать из ящика и подать агенту должен ЭТОТ модуль.
+  //
+  // 🔴 ЗАЧЕМ ЗАВЕДЕНО: без этого блока выход шины не подключён никуда. Замер
+  // 31.08.2026: три письма соседа пролежали в ящике ДВОЕ СУТОК и дошли рукой
+  // координатора, а не шиной. Снаружи это выглядело как «агент не отвечает».
+  //
+  // Путь — НАСТРОЙКА, не константа: у каждого агента ящик свой, и требование
+  // владельца от 31.08.2026 — всё управляемое вынести из кода. Не задан — звена
+  // нет вовсе, опрос не ведётся (молчаливое чтение чужого ящика было бы хуже).
+  const SPOOL_IN = config.spoolDir || null;
+  // Порог пачки: до него письма подаются по одному (ход на письмо сохраняет
+  // структуру разговора), сверх него — ОДНИМ ходом, чтобы накопленное не
+  // превратилось в лавину подряд идущих ходов. Правило координатора 31.08.2026.
+  const SPOOL_BATCH = Number(config.spoolBatchCount ?? 5);
+  // Старше этого — подаётся с ЯВНОЙ пометкой возраста в тексте. Письмо
+  // двухсуточной давности, поданное как свежее, толкает отвечать на устаревшее.
+  const SPOOL_STALE_HOURS = Number(config.spoolStaleHours ?? 12);
+
+  /**
+   * Отправитель — из ИМЕНИ файла: <метка>-<отправитель>-<случайное>.txt.
+   * Так решил почтальон: содержимое письма — сырой текст без заголовков, и
+   * подделать имя отправитель не может (имя формирует a2a-send, а каталог
+   * закрыт на перечисление). Не разобралось — говорим прямо, а не молчим.
+   */
+  function spoolSender(name) {
+    const m = /^\d{8}T\d{6}Z-([^-]+)-/.exec(name);
+    return m ? m[1] : '(имя не разобрано)';
+  }
+
+  /**
+   * Возраст письма в часах. Источник — метка в ИМЕНИ (её ставит отправитель),
+   * а не mtime: почтальон копирует файл, и при потере метки времени mtime
+   * оказался бы временем переноса, то есть свежим у двухсуточного письма.
+   * Метка не разобралась — берём mtime как нижнюю оценку и говорим об этом.
+   */
+  function spoolAgeHours(name, full) {
+    const m = /^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})Z-/.exec(name);
+    if (m) {
+      const t = Date.UTC(+m[1], +m[2] - 1, +m[3], +m[4], +m[5], +m[6]);
+      return (Date.now() - t) / 3600000;
+    }
+    try { return (Date.now() - fs.statSync(full).mtimeMs) / 3600000; } catch { return 0; }
+  }
+
   // Берём простые текстовые форматы. Всё остальное НЕ берём — но и не
   // проглатываем: имя отвергнутого файла называем в журнале. Поймано
   // 21.08.2026: письмо с расширением .md пролежало во входящих 26 минут,
@@ -998,7 +1098,7 @@ export function apply(ctx, config = {}) {
         // который нам не по правам (например 600 root:root), молча оставался
         // лежать во входящих. Снаружи это «агент не отвечает», а на деле
         // мы даже не смогли прочитать вопрос. Поймано 18.08.2026.
-        log(`[a2a] 🔴 не смог прочитать ${f}: ${e?.message ?? e} (права: файл должен принадлежать владельцу агента и быть читаемым, chmod 644)`);
+        log(`[a2a] 🔴 не смогла прочитать ${f}: ${e?.message ?? e} (права: файл должен принадлежать владельцу агента и быть читаемым, chmod 644)`);
         continue;
       }
       if (!text) continue;
@@ -1010,7 +1110,7 @@ export function apply(ctx, config = {}) {
         if (!goalA2ASenders.has(sender)) {
           log(`[goal] ОТКАЗ служебному каналу: отправитель ${sender ?? '(не назвался)'} не в списке goalA2ASenders`);
           await sayTo('a2a', null, sender === undefined
-            ? 'Постановка цели из служебного канала требует заголовка первой строкой: "From: <имя>".'
+            ? 'Постановка цели из служебного канала требует заголовка первой строкой: "From: <инстанс>/<папка>".'
             : `Отправитель ${sender} не вправе ставить цель.`);
         } else {
           try {
@@ -1038,7 +1138,25 @@ export function apply(ctx, config = {}) {
         text = `[служебный канал, от координатора${sender ? ` ${sender}` : ''}]\n${stripMark(text)}`;
         handle.agent.send(platform.createUserMessage({
           content: [{ type: 'text', text }],
-          source: { kind: 'user' },
+          // 🔴 СВОЙ ВИД ИСТОЧНИКА ДЛЯ СЛУЖЕБНОГО КАНАЛА (21.08.2026, распоряжение
+          // главной). Раньше тут стоял kind: 'user' — и это была НЕПРАВДА в слое
+          // прав: платформа считала сообщение координатора человеческим, то есть
+          // право ставить цель добывалось подлогом метки, а не записанным решением.
+          // Теперь журнал честен: видно, что писал агент-координатор, а не человек.
+          // ЧТО ЭТИМ ТЕРЯЕМ — обход ВСЕХ потребителей kind === 'user' в дереве
+          // платформы (31 совпадение, разобраны все):
+          //   tool-goal          hasDirectHumanInput -> false: из этого канала нельзя
+          //                      закрыть цель родным инструментом (он у нас погашен);
+          //   tool-jobs          бюджет подряд идущих пробуждений больше не обнуляется;
+          //   tool-skill         жест /имя отсюда не подтянет тело скилла;
+          //   session-title      заголовок сессии по такому сообщению не строится;
+          //   session-reference  сообщение вне проекции «текущей поверхности».
+          // Право ставить цель координатору вернём ЯВНЫМ списком видов в мосту —
+          // решением, которое видно тому, кто откроет список.
+          // Вид произвольный по устройству: createMessage кладёт source как есть,
+          // схемы нет; 'goal' и 'skill-catalog' — такие же добавленные виды.
+          // ⚠️ Личный чат владельца остаётся 'user' (строка 560) — он и есть человек.
+          source: { kind: 'a2a' },
         }), 'next-turn', true);
         nudgeUntilClaimed(handle.agent, '[a2a]');
         // 🔴 УДАЛЯЕМ ТОЛЬКО ПОСЛЕ УСПЕШНОЙ ПЕРЕДАЧИ (19.08.2026). Раньше файл
@@ -1052,10 +1170,115 @@ export function apply(ctx, config = {}) {
     }
   }
 
+  /**
+   * Забрать письма из ящика шины и подать агенту.
+   *
+   * 🔴 ДВА МЕСТА ОДНОЙ ДОСТАВКИ. Это короткий повтор того, что делает pollA2A;
+   * общий кусок не выносила намеренно — в pollA2A он переплетён с разбором
+   * /goal, и хелпер вышел бы дороже двух коротких кусков. Но перечень-копия
+   * молча расходится: правишь ОДНО — проверь ВТОРОЕ. За этим следит
+   * stend-yashchika-shiny.sh (сверяет, что оба места делают одно).
+   *
+   * Команд (/goal) из ящика НЕ принимаем: право ставить цель поимённое и живёт
+   * у координатора прямым каналом. Второй путь к тому же действию всегда
+   * расходится с первым, и по журналу перестаёт быть видно, кто поставил цель.
+   */
+  async function pollSpool() {
+    if (!SPOOL_IN) return;
+    let all = [];
+    try {
+      all = fs.readdirSync(SPOOL_IN).sort();
+    } catch (e) {
+      // Одна строка на причину, не на прогон: опрос идёт каждые ~25 с.
+      const key = `SPOOL:${e?.code ?? 'ERR'}`;
+      if (!a2aReported.has(key)) {
+        a2aReported.add(key);
+        log(`[ящик] \u{1F534} недоступен (${SPOOL_IN}): ${e?.message ?? e}`);
+      }
+      return;
+    }
+    const files = all.filter((f) => A2A_EXT.some((x) => f.endsWith(x)));
+    for (const f of all) {
+      if (files.includes(f) || a2aReported.has(`SP:${f}`)) continue;
+      a2aReported.add(`SP:${f}`);
+      log(`[ящик] \u{1F534} НЕ ВЗЯТ файл ${f}: беру только ${A2A_EXT.join(', ')}. `
+        + `Он так и будет лежать в ящике — переименуй отправителю`);
+    }
+    for (const name of [...a2aReported]) {
+      if (name.startsWith('SP:') && !all.includes(name.slice(3))) a2aReported.delete(name);
+    }
+    if (!files.length) return;   // пустой ящик — тишина, а не строка «пусто»
+
+    // Читаем всё, что взяли, и только потом решаем: по одному или пачкой.
+    const pisma = [];
+    for (const f of files) {
+      const full = path.join(SPOOL_IN, f);
+      let text = '';
+      try {
+        text = fs.readFileSync(full, 'utf-8').trim();
+      } catch (e) {
+        log(`[ящик] \u{1F534} не смогла прочитать ${f}: ${e?.message ?? e} `
+          + `(письмо должно принадлежать владельцу агента; переносит почтальон)`);
+        continue;
+      }
+      if (!text) { try { fs.unlinkSync(full); } catch { /* пустое — убрать */ } continue; }
+      const age = spoolAgeHours(f, full);
+      const stale = age >= SPOOL_STALE_HOURS
+        ? `\n[письмо пролежало в ящике ${Math.round(age)} ч — возможно, оно устарело]`
+        : '';
+      pisma.push({ f, full, who: spoolSender(f), text: stripMark(text), stale });
+    }
+    if (!pisma.length) return;
+
+    const packoj = pisma.length > SPOOL_BATCH;
+    const partii = packoj ? [pisma] : pisma.map((p) => [p]);
+    for (const partiya of partii) {
+      const who = partiya.length === 1 ? partiya[0].who : 'агентов машины';
+      const body = partiya.length === 1
+        ? `[служебный канал, от агента ${partiya[0].who}]${partiya[0].stale}\n${partiya[0].text}`
+        : `[служебный канал, ${partiya.length} писем из ящика одной пачкой]\n\n`
+          + partiya.map((p) => `── от агента ${p.who}${p.stale}\n${p.text}`).join('\n\n');
+      try {
+        const { handle, sessionId: a2aSessionId } = await agentFor(A2A_CHAT);
+        lastOrigin.set(a2aSessionId, 'a2a');
+        pushAsk(a2aSessionId, { origin: 'a2a', who, q: partiya[0].text });
+        copyAsk('a2a', who, body);
+        handle.agent.send(platform.createUserMessage({
+          content: [{ type: 'text', text: body }],
+          // Тот же вид источника, что у служебного канала: письмо агента — не
+          // слово человека. Разбор последствий kind !== 'user' — в pollA2A выше.
+          source: { kind: 'a2a' },
+        }), 'next-turn', true);
+        nudgeUntilClaimed(handle.agent, '[ящик]');
+        // 🔴 УДАЛЯЕМ ТОЛЬКО ПОСЛЕ УСПЕШНОЙ ПЕРЕДАЧИ, но удаляем ОБЯЗАТЕЛЬНО:
+        // модуль опрашивает ящик каждые ~25 с, и неудалённое письмо подавалось
+        // бы снова и снова. Не удалить — не «сохранить улику», а завести лавину.
+        for (const p of partiya) { try { fs.unlinkSync(p.full); } catch { /* уже убрали */ } }
+        log(`[ящик] принято ${partiya.length} письмо(писем) от ${who}, ${body.length} знаков`);
+      } catch (e) {
+        log(`[ящик] \u{1F534} не удалось передать агенту: ${e?.message ?? e} — `
+          + `${partiya.map((p) => p.f).join(', ')} ОСТАВЛЕНЫ в ящике, попробую снова`);
+      }
+    }
+  }
+
+  // 🔴 fetch failed СКРЫВАЕТ причину (ECONNRESET/ETIMEDOUT/ENOTFOUND выглядят
+  // одинаково). Печатаем e.cause рядом с e.message. ЦЕНА: не всякая ошибка несёт
+  // cause — тогда пишем «не указана», а не пустое место (пустое читается как
+  // «причины нет», и это та же слепота, что и раньше).
+  // Перенесено из второй живой копии модуля 01.09.2026 ДОСЛОВНО: своя редакция
+  // того же лечения развела бы копии по логике при сверке.
+  function errDetail(e) {
+    const c = e?.cause;
+    if (!c) return 'не указана';
+    return c?.message ?? c?.code ?? String(c);
+  }
+
   async function loop(run) {
     while (run.alive) {
       try {
         await pollA2A();
+        await pollSpool();
         const updates = await tg.poll(25);
         for (const u of updates) {
           try { await handleUpdate(u); }
@@ -1063,7 +1286,7 @@ export function apply(ctx, config = {}) {
         }
       } catch (e) {
         // Сеть моргнула или Telegram ответил ошибкой — ждём и продолжаем.
-        log(`опрос не удался: ${e?.message ?? e}`);
+        log(`опрос не удался: ${e?.message ?? e} | причина: ${errDetail(e)}`);
         await new Promise((r) => setTimeout(r, 3000));
       }
     }