Tools - HMP Language

📝 Log & Sistema

log.print

Imprime mensagem no console de saida.

CALL log.print WITH message="Ola!"

system.env

Obtem variavel de ambiente (apenas lista segura).

CALL system.env WITH name="USER"

system.sleep

Pausa a execucao (maximo 5 segundos).

CALL system.sleep WITH seconds=2

meta.metrics

Retorna metricas de execucao do script.

CALL meta.metrics WITH label="stats"

meta.version

Retorna versao do motor HMP.

CALL meta.version WITH label="v"

meta.tools

Lista todas as tools disponiveis.

CALL meta.tools WITH label="tools"

🔢 Matematica

math.sum

Soma dois numeros (a + b).

CALL math.sum WITH a=10, b=5, label="r"

math.subtract

Subtrai dois numeros (a - b).

CALL math.subtract WITH a=10, b=3, label="r"

math.multiply

Multiplica dois numeros (a * b).

CALL math.multiply WITH a=4, b=5, label="r"

math.divide

Divide dois numeros (a / b).

CALL math.divide WITH a=20, b=4, label="r"

math.power

Potencia (base ^ exponent).

CALL math.power WITH base=2, exponent=8, label="r"

math.mod

Resto da divisao (a % b).

CALL math.mod WITH a=10, b=3, label="r"

math.abs

Valor absoluto de um numero.

CALL math.abs WITH value=-15, label="r"

math.round

Arredonda numero para N casas decimais.

CALL math.round WITH value=3.14159, decimals=2

math.min

Retorna o menor valor entre a e b.

CALL math.min WITH a=5, b=3, label="r"

math.max

Retorna o maior valor entre a e b.

CALL math.max WITH a=5, b=3, label="r"

📜 Strings

string.concat

Concatena duas strings.

CALL string.concat WITH a="Ola", b=" Mundo"

string.split

Divide string em lista pelo delimitador.

CALL string.split WITH text="a,b,c", delimiter=","

string.join

Junta lista em string com separador.

CALL string.join WITH list=items, separator="-"

string.upper

Converte para maiusculas.

CALL string.upper WITH text="hello"

string.lower

Converte para minusculas.

CALL string.lower WITH text="HELLO"

string.trim

Remove espacos do inicio e fim.

CALL string.trim WITH text=" texto "

string.replace

Substitui texto na string.

CALL string.replace WITH text="abc", old="b", new="x"

string.contains

Verifica se contem substring.

CALL string.contains WITH text="hello", search="ell"

string.length

Retorna tamanho da string.

CALL string.length WITH text="hello"

string.substring

Extrai parte da string.

CALL string.substring WITH text="hello", start=0, end=3

string.startswith

Verifica se comeca com prefixo.

CALL string.startswith WITH text="hello", prefix="hel"

string.endswith

Verifica se termina com sufixo.

CALL string.endswith WITH text="hello", suffix="lo"

📋 Listas

list.push

Adiciona item ao final da lista.

CALL list.push WITH list=items, item="novo"

list.pop

Remove e retorna ultimo item.

CALL list.pop WITH list=items, label="ultimo"

list.length

Retorna tamanho da lista.

CALL list.length WITH list=items, label="tam"

list.get

Obtem item pelo indice.

CALL list.get WITH list=items, index=0

list.set

Define valor em um indice.

CALL list.set WITH list=items, index=0, value="x"

list.reverse

Inverte ordem da lista.

CALL list.reverse WITH list=items

list.sort

Ordena a lista.

CALL list.sort WITH list=items

list.contains

Verifica se item esta na lista.

CALL list.contains WITH list=items, item="x"

list.index

Retorna indice do item.

CALL list.index WITH list=items, item="x"

list.slice

Retorna sublista (start:end).

CALL list.slice WITH list=items, start=0, end=3

📦 JSON

json.parse

Converte string JSON em objeto.

CALL json.parse WITH text='{"a":1}', label="obj"

json.stringify

Converte objeto em string JSON.

CALL json.stringify WITH value=objeto, label="str"

📅 Data e Hora

date.now

Data/hora atual (iso, date, time, timestamp).

CALL date.now WITH format="iso", label="agora"

date.format

Formata timestamp para string.

CALL date.format WITH timestamp=ts, format="%d/%m/%Y"

date.parse

Converte string em timestamp.

CALL date.parse WITH text="2025-01-15"

date.add

Adiciona dias/horas/minutos a timestamp.

CALL date.add WITH timestamp=ts, days=7

🌐 HTTP (Protegido)

http.get

Faz requisicao GET para URL permitida.

CALL http.get WITH url="https://api.github.com/zen"

http.post

Faz requisicao POST com dados JSON.

CALL http.post WITH url="...", data={"k":"v"}

🛡️ Hosts Permitidos (Allowlist)

api.github.com jsonplaceholder.typicode.com httpbin.org api.openai.com api.anthropic.com reqres.in dummyjson.com fakestoreapi.com

Timeout: 5s | Limite: 1MB | Protecao SSRF ativa

🔐 Crypto

crypto.hash

Gera hash (sha256, sha512, md5).

CALL crypto.hash WITH text="senha", algorithm="sha256"

crypto.uuid

Gera UUID v4 unico.

CALL crypto.uuid WITH label="id"

crypto.base64_encode

Codifica texto em Base64.

CALL crypto.base64_encode WITH text="hello"

crypto.base64_decode

Decodifica Base64 para texto.

CALL crypto.base64_decode WITH text="aGVsbG8="

🎲 Random

random.int

Gera inteiro aleatorio entre min e max.

CALL random.int WITH min=1, max=100, label="num"

random.float

Gera float aleatorio entre min e max.

CALL random.float WITH min=0, max=1, label="num"

random.choice

Escolhe item aleatorio da lista.

CALL random.choice WITH list=items, label="item"

random.shuffle

Embaralha ordem da lista.

CALL random.shuffle WITH list=items, label="mixed"

Catalogo de Tools