Turn a natural-language system description into a validated cloud architecture and draw it on the user's Pinpole canvas. Returns a canvas URL the user can open to see and edit the live ReactFlow diagram (a draw.io replacement). Optionally runs a cost simulation. Use this when the user wants to design or visualize a system/architecture.

Generate a validated {nodes, edges} cloud architecture from a description using Pinpole's AWS Well-Architected model. Does NOT draw it — pass the result to pinpole_draw_on_canvas or pinpole_simulate_cost. Use pinpole_build_architecture to do both in one step.

Run Pinpole's simulation engine over an architecture graph at a given traffic level and return per-node + total estimated monthly cost, latency (p50/p95/p99), throughput, and throttling/error alerts. Use to answer 'what will this cost / how will it perform'.

Persist an architecture graph to the user's Pinpole canvas (ReactFlow), creating a project and workspace if none is given. Returns the canvas URL to open the live diagram. Nodes are auto-laid-out left-to-right when positions are omitted.

Return the Pinpole canvas deep link for a project + workspace so the user can open the live, editable architecture diagram in their browser.

List the authenticated user's Pinpole projects (id + title).

Create a new Pinpole project to hold architecture workspaces.

Generate Terraform project files from an architecture graph. Works offline.

List AWS service ids/specs the canvas understands. Reads local repo specs when available.