update_site_html

io.github.suprraz/webzum · Verify this server

Edit a generated WebZum site by describing the change in natural language. This is the primary editor tool. Given a user instruction (in conversationHistory), the WebZum editor builds the minimal site tree, sends it to an LLM with the user's verbatim words, applies the returned HTML diff across every page that contains each affected section, and reassembles into a new version. Use this for nearly all edits: "make the hero say X", "remove the testimonials section", "change the about-us copy to be friendlier", "swap the order of the sections on the home page". Required: businessId, versionId, and a conversationHistory containing at least one user turn. The LLM reads the user's verbatim words — do not paraphrase. Returns { versionId, status: 'completed' | 'in_progress', ...extra }. If status is 'in_progress', the edit is still running in the background — poll get_site_status with the returned versionId every 5-10s until isComplete is true. Concurrency: edits on the same businessId MUST be serial. Never fire parallel edit calls on the same site; concurrent edits race and may return the wrong versionId. Wait for each edit to complete (status: 'completed' OR isComplete on get_site_status) before issuing the next one.