Реагировать на события с помощью мода

on('tool.call', async ($, e, next) => {
  // Запускается перед запуском инструмента
  $.ui.log('Claude is about to use ' + e.tool)
  // Передайте событие дальше без изменений
  return next(e)
})

on('tool.call', async ($, e, next) => {
  // Позвольте инструменту запуститься и дождитесь его результата
  const result = await next(e)
  // Запускается после запуска инструмента
  $.ui.log(e.tool + ' finished')
  // Верните результат без изменений
  return result
})

on('prompt.submit', async ($, e, next) => {
  // Передайте копию события с изменённым текстом
  return next({ ...e, text: e.text.trim() })
})

on('tool.call', { tool: 'Bash' }, async () => {
  // Нет вызова next, поэтому команда никогда не запускается
  return { deny: 'Bash is turned off in this project. Use the file tools.' }
})

// Строка совпадает с одним значением: только вызовы Bash
on('tool.call', { tool: 'Bash' }, hook)
// Массив совпадает с любым значением в нём: вызовы Edit и Write
on('tool.call', { tool: ['Edit', 'Write'] }, hook)
// Регулярное выражение совпадает по шаблону: каждый инструмент одного сервера MCP
on('tool.call', { tool: /^mcp__github__/ }, hook)

// Matcher ограничивает hook вызовами Bash, поэтому e.command — это команда оболочки
on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
  if (/git push .*--force/.test(e.command)) {
    // Возврат без вызова next отвечает на событие, поэтому команда никогда не запускается
    return { deny: 'Force pushes are not allowed in this repository. Push to a new branch instead.' }
  }
  // Каждая другая команда переходит к проверке разрешений, а затем к Bash
  return next(e)
})

on('tool.call', { tool: ['Edit', 'Write'] }, async ($, e, next) => {
  // Дождитесь проверки разрешений и инструмента, и сохраните то, что они произвели
  const result = await next(e)
  // Отказанный вызов возвращается как { deny }, а неудачный имеет установленный isError
  const changed = !result.deny && !result.isError
  if (changed && e.file_path.endsWith('.mdx')) $.ui.log('Claude changed ' + e.file_path)
  // Верните результат как он пришёл, чтобы Claude читал то, что вернул инструмент
  return result
})

const RISKY = /\brm\s+-rf?\b|\bgit\s+reset\s+--hard\b|\bgit\s+push\b.*--force/

export function register(on) {
  on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
    // Пропустите каждую другую команду без вопроса
    if (!RISKY.test(e.command)) return next(e)
    // Начните с безопасного ответа, чтобы вопрос, на который никто не ответит, отказал в команде
    let answer = 'Refuse'
    try {
      // Вызов инструмента ждёт здесь, пока пользователь выберет один из двух ярлыков
      answer = await $.ui.ask('Run this command? ' + e.command, ['Run it', 'Refuse'])
    } catch {
      // Пользователь отклонил вопрос, или это запуск claude -p без кого-либо, кого можно спросить
    }
    if (answer !== 'Run it') {
      // Ответьте без вызова next, чтобы команда не запускалась
      return { deny: 'The user declined this command. Ask before trying a different approach.' }
    }
    return next(e)
  })
}

on('prompt.submit', async ($, e, next) => {
  // Передайте подсказку, которая не упоминает pull request, как она есть
  if (!/\bPR\b|pull request/i.test(e.text)) return next(e)
  const git = await $.process.run(['git', 'branch', '--show-current'])
  // Вне репозитория git команда не удаётся, поэтому нет ветки для добавления
  if (git.exitCode !== 0) return next(e)
  // Сохраните любой контекст, который добавил более ранний hook, и добавьте ещё одну строку для Claude
  return next({ ...e, context: [...(e.context ?? []), 'Current branch: ' + git.stdout.trim()] })
})

// function* делает hook генератором, который может передавать ответ по частям
on('turn.step', async function* ($, e, next) {
  // Отправьте запрос, пересылайте каждую часть по мере её поступления и сохраняйте завершённый результат
  const result = yield* next(e)
  // Пропустите результат, который не сообщает количество токенов
  if (result.usage) {
    $.ui.log('cache read ' + result.usage.cache_read_input_tokens + ' · wrote ' + result.usage.cache_creation_input_tokens)
  }
  // Верните результат без изменений, чтобы ход продолжался как обычно
  return result
})

on('classic.Stop', async ($, e, next) => {
  // e имеет те же поля, которые hook Stop в файле настроек читает из stdin
  $.ui.log('Transcript saved at ' + e.transcript_path)
  // Передайте событие дальше, чтобы hooks Stop в ваших файлах настроек всё ещё запускались
  return next(e)
})

// on возвращает регистрацию, и .catch присоединяет обработчик к этому одному hook
on('tool.call', { tool: 'Bash' }, guard).catch(async ($, e, next) => {
  // next.error.kind — это 'throw' или 'timeout', что говорит, как guard не удался
  return { deny: 'The command guard failed, so this command was not run: ' + next.error.kind }
})