Saltar al contenido principal
Herramientas para leer el árbol de archivos, leer un archivo, escribir commits y buscar texto en el código.

get_presentation

Ver apresentação aplicada. Lê a apresentação validada, commit aplicado e erros, sem publicar o executável.
Solo lectura: no modifica datos. La confirmación corresponde al cliente de IA; los permisos y bloqueos siguen vigentes.

Parámetros

string
requerido
ID del script (uuid)

Ejemplo

validate_presentation

Validar cartão e popup. Valida ui/site/ de uma branch ou commit. Não aplica branches de trabalho.
Solo lectura: no modifica datos. La confirmación corresponde al cliente de IA; los permisos y bloqueos siguen vigentes.

Parámetros

string
requerido
ID del script (uuid)
string
Branch ou commit

Ejemplo

ensure_presentation_files

Preparar apresentação. Adiciona apenas arquivos ui/site/ ausentes ao repositório antigo. Não sobrescreve o executável. Exige expected_head.
Escribe o modifica datos del script. La confirmación corresponde al cliente de IA; los permisos y bloqueos siguen vigentes.

Parámetros

string
requerido
ID del script (uuid)
string | null
requerido
—

Ejemplo

read_tree

Leer árbol. Lista los archivos de una branch o commit.
Solo lectura: no modifica datos. La confirmación corresponde al cliente de IA; los permisos y bloqueos siguen vigentes.

Parámetros

string
requerido
ID del script (uuid)
string
Branch o SHA (por defecto: principal)

Qué llama en la API

Por baixo, a ferramenta usa GET /scripts/{script_id}/repo/tree da API do Scripts. La respuesta incluye texto y structuredContent, sin secretos.

Ejemplo

read_file

Leer archivo. Contenido de un archivo.
Solo lectura: no modifica datos. La confirmación corresponde al cliente de IA; los permisos y bloqueos siguen vigentes.

Parámetros

string
requerido
ID del script (uuid)
string
requerido
Ruta, ej.: src/script.js
string
Branch o SHA

Qué llama en la API

Por baixo, a ferramenta usa GET /scripts/{script_id}/repo/files/{path} da API do Scripts. La respuesta incluye texto y structuredContent, sin secretos.

Ejemplo

write_files

Escribir archivos. Escribe un commit. Lee el head de la branch en list_branches y envíalo en expected_head. content null borra el archivo.
Escribe o modifica datos del script. Acción destructiva: revisa en tu cliente de IA antes de confirmar. La confirmación corresponde al cliente de IA; los permisos y bloqueos siguen vigentes.

Parámetros

string
requerido
ID del script (uuid)
string
Branch (por defecto: principal)
string
requerido
head_sha actual de la branch
string
requerido
Mensaje del commit
object[]
requerido
Lista de elementos.

Qué llama en la API

Por baixo, a ferramenta usa POST /scripts/{script_id}/repo/commits da API do Scripts. La respuesta incluye texto y structuredContent, sin secretos.

Ejemplo

search_code

Buscar en el código. Busca un texto en todos los archivos de un ref (hasta 50 resultados).
Solo lectura: no modifica datos. La confirmación corresponde al cliente de IA; los permisos y bloqueos siguen vigentes.

Parámetros

string
requerido
ID del script (uuid)
string
requerido
Texto
string
Branch o SHA

Qué llama en la API

Por baixo, a ferramenta usa GET /scripts/{script_id}/repo/tree, GET /scripts/{script_id}/repo/files/{path} da API do Scripts. La respuesta incluye texto y structuredContent, sin secretos.

Ejemplo