Pular para o conteúdo principal
Ferramentas para ler a árvore de arquivos, ler um arquivo, gravar commits e procurar texto no código.

get_presentation

Ver apresentação aplicada. Lê a apresentação validada, commit aplicado e erros, sem publicar o executável.
Só leitura: não muda nada. Confirmação no cliente de IA; escopos e bloqueios continuam valendo.

Parâmetros

string
obrigatório
ID do script (uuid)

Exemplo

validate_presentation

Validar cartão e popup. Valida ui/site/ de uma branch ou commit. Não aplica branches de trabalho.
Só leitura: não muda nada. Confirmação no cliente de IA; escopos e bloqueios continuam valendo.

Parâmetros

string
obrigatório
ID do script (uuid)
string
Branch ou commit

Exemplo

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.
Grava ou muda dados do script. Confirmação no cliente de IA; escopos e bloqueios continuam valendo.

Parâmetros

string
obrigatório
ID do script (uuid)
string | null
obrigatório
—

Exemplo

read_tree

Ler árvore. Lista os arquivos de uma branch ou commit.
Só leitura: não muda nada. Confirmação no cliente de IA; escopos e bloqueios continuam valendo.

Parâmetros

string
obrigatório
ID do script (uuid)
string
Branch ou SHA (padrão: principal)

O que chama na API

Por baixo, a ferramenta usa GET /scripts/{script_id}/repo/tree da API do Scripts. A resposta inclui texto e structuredContent, com segredos removidos.

Exemplo

read_file

Ler arquivo. Conteúdo de um arquivo.
Só leitura: não muda nada. Confirmação no cliente de IA; escopos e bloqueios continuam valendo.

Parâmetros

string
obrigatório
ID do script (uuid)
string
obrigatório
Caminho, ex.: src/script.js
string
Branch ou SHA

O que chama na API

Por baixo, a ferramenta usa GET /scripts/{script_id}/repo/files/{path} da API do Scripts. A resposta inclui texto e structuredContent, com segredos removidos.

Exemplo

write_files

Gravar arquivos. Grava um commit. Leia o head da branch em list_branches e envie em expected_head. content null apaga o arquivo.
Grava ou muda dados do script. Ação destrutiva: confira antes de aprovar. Confirmação no cliente de IA; escopos e bloqueios continuam valendo.

Parâmetros

string
obrigatório
ID do script (uuid)
string
Branch (padrão: principal)
string
obrigatório
head_sha atual da branch
string
obrigatório
Mensagem do commit
object[]
obrigatório
Lista de itens.

O que chama na API

Por baixo, a ferramenta usa POST /scripts/{script_id}/repo/commits da API do Scripts. A resposta inclui texto e structuredContent, com segredos removidos.

Exemplo

search_code

Buscar no código. Procura um texto em todos os arquivos de um ref (até 50 resultados).
Só leitura: não muda nada. Confirmação no cliente de IA; escopos e bloqueios continuam valendo.

Parâmetros

string
obrigatório
ID do script (uuid)
string
obrigatório
Texto
string
Branch ou SHA

O que chama na API

Por baixo, a ferramenta usa GET /scripts/{script_id}/repo/tree, GET /scripts/{script_id}/repo/files/{path} da API do Scripts. A resposta inclui texto e structuredContent, com segredos removidos.

Exemplo