Reaccionar a eventos con un mod

on('tool.call', async ($, e, next) => {
  // Se ejecuta antes de que la herramienta se ejecute
  $.ui.log('Claude is about to use ' + e.tool)
  // Pasa el evento sin cambios
  return next(e)
})

on('tool.call', async ($, e, next) => {
  // Deja que la herramienta se ejecute y espera su resultado
  const result = await next(e)
  // Se ejecuta después de que la herramienta se ejecuta
  $.ui.log(e.tool + ' finished')
  // Devuelve el resultado sin cambios
  return result
})

on('prompt.submit', async ($, e, next) => {
  // Pasa una copia del evento con su texto cambiado
  return next({ ...e, text: e.text.trim() })
})

on('tool.call', { tool: 'Bash' }, async () => {
  // Sin llamada a next, por lo que el comando nunca se ejecuta
  return { deny: 'Bash is turned off in this project. Use the file tools.' }
})

// Una cadena coincide con un valor: solo llamadas Bash
on('tool.call', { tool: 'Bash' }, hook)
// Una matriz coincide con cualquier valor en ella: llamadas Edit y Write
on('tool.call', { tool: ['Edit', 'Write'] }, hook)
// Una expresión regular coincide por patrón: cada herramienta de un servidor MCP
on('tool.call', { tool: /^mcp__github__/ }, hook)

// El matcher limita el hook a llamadas Bash, por lo que e.command es el comando del shell
on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
  if (/git push .*--force/.test(e.command)) {
    // Devolver sin llamar a next responde el evento, por lo que el comando nunca se ejecuta
    return { deny: 'Force pushes are not allowed in this repository. Push to a new branch instead.' }
  }
  // Cada otro comando va a la verificación de permisos y luego a Bash
  return next(e)
})

on('tool.call', { tool: ['Edit', 'Write'] }, async ($, e, next) => {
  // Espera la verificación de permisos y la herramienta, y mantén lo que produjeron
  const result = await next(e)
  // Una llamada rechazada vuelve como { deny }, y una fallida tiene isError establecido
  const changed = !result.deny && !result.isError
  if (changed && e.file_path.endsWith('.mdx')) $.ui.log('Claude changed ' + e.file_path)
  // Devuelve el resultado tal como vino, para que Claude lea lo que la herramienta devolvió
  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) => {
    // Deja pasar cada otro comando sin una pregunta
    if (!RISKY.test(e.command)) return next(e)
    // Comienza desde la respuesta segura, por lo que una pregunta que nadie responde rechaza el comando
    let answer = 'Refuse'
    try {
      // La llamada de herramienta espera aquí hasta que el usuario elige una de las dos etiquetas
      answer = await $.ui.ask('Run this command? ' + e.command, ['Run it', 'Refuse'])
    } catch {
      // El usuario descartó la pregunta, o esto es una ejecución de claude -p sin nadie a quien preguntar
    }
    if (answer !== 'Run it') {
      // Responde sin llamar a next, por lo que el comando no se ejecuta
      return { deny: 'The user declined this command. Ask before trying a different approach.' }
    }
    return next(e)
  })
}

on('prompt.submit', async ($, e, next) => {
  // Pasa una indicación que no menciona una solicitud de extracción tal como está
  if (!/\bPR\b|pull request/i.test(e.text)) return next(e)
  const git = await $.process.run(['git', 'branch', '--show-current'])
  // Fuera de un repositorio git el comando falla, por lo que no hay rama para añadir
  if (git.exitCode !== 0) return next(e)
  // Mantén cualquier contexto que un hook anterior añadió, y añade una línea más para Claude
  return next({ ...e, context: [...(e.context ?? []), 'Current branch: ' + git.stdout.trim()] })
})

// function* hace que el hook sea un generador, que puede pasar la respuesta pieza por pieza
on('turn.step', async function* ($, e, next) {
  // Envía la solicitud, reenvía cada pieza mientras llega, y mantén el resultado terminado
  const result = yield* next(e)
  // Omite un resultado que no reporta conteos de tokens
  if (result.usage) {
    $.ui.log('cache read ' + result.usage.cache_read_input_tokens + ' · wrote ' + result.usage.cache_creation_input_tokens)
  }
  // Devuelve el resultado sin cambios, para que el turno continúe como de costumbre
  return result
})

on('classic.Stop', async ($, e, next) => {
  // e tiene los mismos campos que un hook Stop en un archivo de configuración lee de stdin
  $.ui.log('Transcript saved at ' + e.transcript_path)
  // Pasa el evento, para que los hooks Stop en tus archivos de configuración aún se ejecuten
  return next(e)
})

// on devuelve un registro, y .catch adjunta un manejador a ese hook
on('tool.call', { tool: 'Bash' }, guard).catch(async ($, e, next) => {
  // next.error.kind es 'throw' o 'timeout', que dice cómo falló guard
  return { deny: 'The command guard failed, so this command was not run: ' + next.error.kind }
})