Reagir a eventos com um mod

on('tool.call', async ($, e, next) => {
  // Executa antes da ferramenta
  $.ui.log('Claude is about to use ' + e.tool)
  // Passe o evento adiante inalterado
  return next(e)
})

on('tool.call', async ($, e, next) => {
  // Deixe a ferramenta ser executada e aguarde seu resultado
  const result = await next(e)
  // Executa após a ferramenta
  $.ui.log(e.tool + ' finished')
  // Devolva o resultado inalterado
  return result
})

on('prompt.submit', async ($, e, next) => {
  // Passe uma cópia do evento com seu texto alterado
  return next({ ...e, text: e.text.trim() })
})

on('tool.call', { tool: 'Bash' }, async () => {
  // Nenhuma chamada para next, portanto o comando nunca é executado
  return { deny: 'Bash is turned off in this project. Use the file tools.' }
})

// Uma string corresponde a um valor: apenas chamadas Bash
on('tool.call', { tool: 'Bash' }, hook)
// Uma matriz corresponde a qualquer valor nela: chamadas Edit e Write
on('tool.call', { tool: ['Edit', 'Write'] }, hook)
// Uma expressão regular corresponde por padrão: cada ferramenta de um servidor MCP
on('tool.call', { tool: /^mcp__github__/ }, hook)

// O matcher limita o hook a chamadas Bash, portanto e.command é o comando do shell
on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
  if (/git push .*--force/.test(e.command)) {
    // Retornar sem chamar next responde ao evento, portanto o comando nunca é executado
    return { deny: 'Force pushes are not allowed in this repository. Push to a new branch instead.' }
  }
  // Cada outro comando passa para a verificação de permissão e depois para Bash
  return next(e)
})

on('tool.call', { tool: ['Edit', 'Write'] }, async ($, e, next) => {
  // Aguarde a verificação de permissão e a ferramenta, e mantenha o que produziram
  const result = await next(e)
  // Uma chamada recusada volta como { deny }, e uma falhada tem isError definido
  const changed = !result.deny && !result.isError
  if (changed && e.file_path.endsWith('.mdx')) $.ui.log('Claude changed ' + e.file_path)
  // Retorne o resultado como veio, portanto Claude lê o que a ferramenta retornou
  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) => {
    // Deixe cada outro comando passar sem uma pergunta
    if (!RISKY.test(e.command)) return next(e)
    // Comece a partir da resposta segura, portanto uma pergunta que ninguém responde recusa o comando
    let answer = 'Refuse'
    try {
      // A chamada de ferramenta aguarda aqui até o usuário escolher um dos dois rótulos
      answer = await $.ui.ask('Run this command? ' + e.command, ['Run it', 'Refuse'])
    } catch {
      // O usuário descartou a pergunta ou esta é uma execução claude -p sem ninguém para perguntar
    }
    if (answer !== 'Run it') {
      // Responda sem chamar next, portanto o comando não é executado
      return { deny: 'The user declined this command. Ask before trying a different approach.' }
    }
    return next(e)
  })
}

on('prompt.submit', async ($, e, next) => {
  // Passe um prompt que não menciona uma solicitação de pull como está
  if (!/\bPR\b|pull request/i.test(e.text)) return next(e)
  const git = await $.process.run(['git', 'branch', '--show-current'])
  // Fora de um repositório git o comando falha, portanto não há ramificação para adicionar
  if (git.exitCode !== 0) return next(e)
  // Mantenha qualquer contexto que um hook anterior adicionou e adicione mais uma linha para Claude
  return next({ ...e, context: [...(e.context ?? []), 'Current branch: ' + git.stdout.trim()] })
})

// function* torna o hook um gerador, que pode passar a resposta adiante pedaço por pedaço
on('turn.step', async function* ($, e, next) {
  // Envie a solicitação, encaminhe cada pedaço conforme chega e mantenha o resultado terminado
  const result = yield* next(e)
  // Pule um resultado que não relata contagens de token
  if (result.usage) {
    $.ui.log('cache read ' + result.usage.cache_read_input_tokens + ' · wrote ' + result.usage.cache_creation_input_tokens)
  }
  // Retorne o resultado inalterado, portanto o turno continua como usual
  return result
})

on('classic.Stop', async ($, e, next) => {
  // e tem os mesmos campos que um hook Stop em um arquivo de configurações lê de stdin
  $.ui.log('Transcript saved at ' + e.transcript_path)
  // Passe o evento adiante, portanto hooks Stop em seus arquivos de configurações ainda são executados
  return next(e)
})

// on retorna um registro e .catch anexa um manipulador a esse hook
on('tool.call', { tool: 'Bash' }, guard).catch(async ($, e, next) => {
  // next.error.kind é 'throw' ou 'timeout', que diz como guard falhou
  return { deny: 'The command guard failed, so this command was not run: ' + next.error.kind }
})