Dla programistów
Kartografia jako strukturalne wyjście.
Generuj i edytuj dokument DSL deterministycznie, następnie renderuj do PNG lub SVG. Przez HTTP, MCP lub CLI — do wdrożenia w swoich potokach i agentach.
Otwórz Studio →example · MCP
> validate_gesta_map(doc)
{ "valid": true, "errors": [] }
> render_gesta_map(doc, format="svg")
{ "image_base64": "PD94…",
"mime": "image/svg+xml" }Trzy interfejsy, jeden silnik.
HTTP API
Endpointy REST
POST /api/generate → DSL + PNG/SVG POST /api/edit → typed ops POST /api/apply-ops → deterministic patch POST /api/rerender → re-render POST /api/render-svg → SVG, id-tagged layers POST /api/geocode → names → coordinates
MCP
Narzędzia dla agentów
render_gesta_map(doc, format, dpi)
validate_gesta_map(doc) → {valid, errors}
extract_draft_from_prose(prose)
how_to(feature) → self-explain
engine_version()CLI
Linia poleceń
$ gesta validate map.gesta.yaml $ gesta render map.gesta.yaml -o out.svg $ gesta geocode map.gesta.yaml --apply $ gesta resolve map.gesta.yaml $ gesta-serve # HTTP · gesta-mcp
Edycja deterministyczna
Dziesięć typowanych operacji na dokumencie.
Edycje to operacje na AST, nie regeneracje — bez regresji, ręczne edycje przetrwają.
create_layermodify_layerdelete_layeradd_memberremove_membermodify_arrowmodify_annotationchange_viewapply_classset_disambiguation
- Deterministyczne
- Ten sam dokument → ta sama mapa, do piksela. Geokodowanie online jest migawkowane.
- Walidowane
- Każdy dokument jest sprawdzany względem JSON Schema formatu V1.
- Wyjście
- PNG, SVG (z <g> na warstwę), PDF, JPG. SVG edytowalne dalej.
- Jeden silnik
- API, MCP i CLI to cienkie wrappery tego samego potoku renderowania.