Não existe no Lola3d nenhuma operação que exista só na interface. A barra de ferramentas, a API REST, as ferramentas MCP e o assistente integrado chamam as mesmas 228 ações, validadas pelos mesmos esquemas JSON, confirmadas pelas mesmas revisões e etapas de desfazer.
GET /api/studio/actions é o esquema de execução oficial — não um documento que se afasta do código, mas o catálogo sobre o qual o próprio aplicativo é construído. Tudo o que está nele pode ser chamado com um token de sessão ou um token de API.
As mutações carregam expected_revision. Uma desatualizada é recusada com 409 em vez de mesclada por sorte, e um erro do kernel deixa o documento idêntico, byte a byte.
# Everything the modeler can do, with its schema curl -H "Authorization: Bearer $TOKEN" \ https://lola3d.app/api/studio/actions # One edit, on the revision you hold curl -X POST https://lola3d.app/api/studio/actions/push_pull \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"model_id":"…","expected_revision":12, "args":{"target":"body1","face_id":"f7","distance":40}}' # A hundred commands as one revision and one undo step curl -X POST https://lola3d.app/api/studio/actions/batch …
Um lote de comandos não consegue ler o modelo entre seus próprios comandos. Essa única limitação é o que separa automatizar um clique de gerar um projeto — e é o que o console Python remove.
cad oferececad.create_box(width=100, …) — qualquer ação do catálogo, pelo nome, validada pelo seu próprio esquemacad.actions() / cad.help(name) — o catálogo, de dentro do scriptcad.document, cad.features, cad.find(name) — o modelo como ele estácad.objects(), cad.bounds() — os corpos visíveis, seu volume, área e dimensõesparams — as variáveis que você passou; print(…) capturado; result retornadodry_run executa tudo e não guarda nada.O namespace restrito — sem open, sem eval, sem exec, sem atributos dunder e apenas com os módulos numéricos e estruturais — é uma proteção, não uma fronteira de segurança. O CPython nunca ofereceu uma sandbox real dentro do processo, e não vamos fingir o contrário.
O que realmente segura: o script roda em um processo worker de geometria com seus próprios limites de memória e CPU, sob um prazo que o próprio worker faz cumprir (um laço ocupado se interrompe sozinho em vez de custar um worker), e atrás de um escopo — admin por padrão, porque executar um script é executar código no host de geometria. Uma configuração o amplia a todos os editores; outra remove a ação do catálogo por completo.
n = params["cells"] pitch = params["pitch"] strut = params["strut"] for i in range(n + 1): for j in range(n + 1): cad.create_box(width=strut, depth=strut, height=n * pitch, position=[i * pitch, j * pitch, 0]) print("struts:", len(cad.features)) result = {"struts": len(cad.features), "extent_mm": n * pitch}
# Nothing applied — so this costs no revision at all. total = 0.0 for o in cad.objects(): print(f"{o['name']:<24} {o['volume']:>14,.1f} mm3") total += o["volume"] box = cad.bounds() size = [round(box["max"][i] - box["min"][i], 2) for i in range(3)] result = {"bodies": len(cad.objects()), "bbox_mm": size}
O endpoint MCP expõe o catálogo como ferramentas, sujeitas aos mesmos escopos de leitura e escrita que qualquer outro chamador. Um agente com um token de leitura pode medir, inspecionar e exportar; um com token de escrita pode modelar.
Ele também pode trabalhar como um colega: pré-visualizar uma alteração sem gravar nada, ou propor uma. Uma proposta desenha seu próprio fantasma na sua janela de visualização, com os dois botões que respondem a ela, e uma aprovação aplica todos os comandos como uma edição, com um grupo na linha do tempo sobre o que criou — ou uma rejeição não deixa nada para trás.
POST /mcp X-API-Key: ign_… # scope: ai {"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "propose_changes", "arguments": { "model_id": "…", "title": "Lighten the web by 18%", "commands": [ {"action": "shell", "args": {"target": "web", "thickness": 2.4}} ] }}}
| Formato | Importação | Exportação | Observações |
|---|---|---|---|
| STEP (.step) | Sim | Sim | B-rep exato. Montagens chegam como componentes. |
| IGES (.iges) | Sim | Sim | Superfícies costuradas onde são estanques. |
| BREP (.brep) | Sim | Sim | O formato exato do próprio kernel, com nomes e cores. |
| STL (.stl) | Sim | Sim | Costurado em um sólido quando estanque, mantido como faces quando não. |
| OBJ (.obj) | Sim | Sim | Exportado com seu MTL, em um zip. |
| 3MF (.3mf) | Sim | Sim | Cores preservadas. |
| glTF / GLB | Sim | Sim | Para a web e para renderizadores. |
| Collada (.dae) | Sim | Sim | A porta de entrada e de saída do SketchUp, que não tem um formato .skp aberto. |
| IFC (.ifc) | Sim | Sim | IFC4; corpos como proxies, componentes como montagens. |
| DXF / SVG | Sim | Sim | Entram como entidades de esboço; saem de um esboço, de um corte ou de um desenho. |
| — | Sim | Folhas de desenho. | |
| JSON | Sim | Sim | O próprio documento editável, incluindo a geometria congelada. |
| G-code | — | Sim | GRBL, LinuxCNC, Fanuc ou um pós-processador que você mesmo descreve. |
Entre, crie um token de API em Configurações e o modelador inteiro responde ao curl. Depois escreva o script que teria custado uma tarde de cliques.