tools/

Cualquier función anotada con @AITool bajo tools/ se convierte en una tool invocable.

tools/

Cualquier archivo .bx bajo tools/ (buscado recursivamente, así que subcarpetas como tools/nested/Search.bx también funcionan) que declare una función anotada con @AITool se convierte en una tool invocable para el agente.

// tools/Greeter.bx
class {

	@AITool( "Say hello to someone by name." )
	function sayHello( name ) {
		return "Hello, " & arguments.name & "!";
	}

}

BX Agents no escanea ni interpreta las anotaciones @AITool él mismo - descubre una entrada por archivo .bx (para comprobación de colisión de nombres) y luego copia toda la carpeta tools/ textualmente a la app generada. En el arranque, la app generada llama al propio scanner de bx-ai:

aiToolRegistry().scan( "tools" )

que hace el trabajo real de reflexión (recorriendo los archivos copiados, instanciando cada clase, encontrando funciones @AITool). Esta sentencia solo se emite en absoluto si el proyecto realmente tiene una carpeta tools/ con archivos en ella.

Nombramiento

El nombre de entrada descubierto es el propio nombre base del archivo (Greeter.bx → Greeter). Dos archivos de tool con el mismo nombre base (incluso en subcarpetas diferentes, ya que el descubrimiento es plano por nombre base) fallan la validación con un error de nombre duplicado.

Qué se excluye

• Los dotfiles (cualquier cosa que empiece con .) se ignoran en el descubrimiento.
• Los .env/dotfiles dentro de tools/ nunca se copian a la salida del build, incluso si están presentes - el paso de copia los excluye explícitamente.

Reconstrucciones

tools/ se copia con una estrategia de borrar-y-escribir: el propio directorio tools/ de la app generada se elimina y se reescribe en cada build, así que un archivo eliminado de la carpeta tools/ de tu proyecto no persiste como salida obsoleta de un build anterior.