Виправлення втрачених промптів у модах Claude Code через фонові таймери

Проблема життєвого циклу в обробниках модів

Під час розробки інтерактивних панелей для Claude Code (протестовано у версіях від 2.1.286 до 2.1.288), виклик $.prompt.submit({ text }) безпосередньо в обробнику onPress або хуку слеш-команди спричиняє періодичні збої. За документацією $.prompt.submit очікує переходу сесії в режим очікування для початку черги. Проте під час виклику всередині події натискання контекст часто очищується раніше, ніж запит надсилається, без генерації винятків.

Рішення через чергу та системний таймер

Для стабільної роботи необхідно відокремити клік від надсилання:

1. Зберігати текст повідомлення у змінній модуля під час onPress. 2. Ініціалізувати таймер через $.clock.every(1_000, ...) всередині хука session.start. 3. Зчитувати та очищати чергу в ітерації таймера перед викликом $.prompt.submit.

let toSend = null;
on('session.start', async ($, e, next) => {
  $.clock.every(1_000, () => {
    if (toSend) {
      const text = toSend;
      toSend = null;
      $.prompt.submit({ text });
    }
  });
});

Фоно Prozеси та оптимізація рендерингу

Такий самий життєвий цикл впливає на фонові процеси $.process.run (наприклад, відкриття системних файлів чи звукові сигнали) — перенесення їх у таймер захищає від раптового завершення. Крім того, оновлення конфігурації через $.config.set перезавантажує плагін і може дублювати таймери, тому слід викликати timer?.cancel?.(). Також викликайте $.ui.invalidate('ui.render') лише при зміні значень, щоб уникнути перебудови кнопок прямо під час кліку.