Abilities catalog
All 20 registered Kindly Edit abilities with exact input and output JSON schemas.
Registered operations#
cantata-edit/list-pages: The site's pages this account can edit, newest change first: id, title, status, address, whether it is built with Kindly Edit and whether it has an unpublished draft. Use a page's id with get-page.cantata-edit/get-page: One page as an outline: its sections in order (s1, s2…), each with its design (component), heading, layout and color style and the choices it allows, its editable fields (words, links, pictures) and its repeated items (cards, people, questions…) with their fields. Ids are paths valid for the returned rev: read the page before changing it, and send rev back with the change. By default this is the unpublished draft if there is one. format "text" gives a short outline; "html" adds each section's markup.cantata-edit/list-sections-available: The theme's designed sections, the same list as the editor's Add a section window: id (to add one), name, kind, category, description, search words, and the layouts and color styles each allows. search matches any of its words.cantata-edit/edit-page: Apply up to 100 structured changes to the revision just read. All changes succeed together and are saved only as an unpublished draft.cantata-edit/save-draft: Replace the page draft with sanitized HTML. Visitors do not see it until publish-page is called.cantata-edit/discard-draft: Permanently discard the unpublished page draft while leaving the live page unchanged.cantata-edit/publish-page: Run the page checks, then explicitly make its saved draft live. Problems must be resolved or deliberately allowed.cantata-edit/restore-version: Put a version from History back live. A current unpublished draft is kept aside.cantata-edit/check-page: Find unfinished pictures, links, text and heading structure before publishing.cantata-edit/get-history: List published versions of a page, newest first.cantata-edit/get-build-contract: Read the native-first element/settings standard, supported exception storage and developer documentation before building. Unsupported hidden implementations must be rejected.cantata-edit/get-element-code: Trusted developers only: read each element's CSS and Custom JavaScript with a revision and element index. Indices are valid only for this revision. Native settings remain the first choice.cantata-edit/set-element-code: Trusted developers only: intentionally change one element's scoped CSS or executable Custom JavaScript, after reading its current revision and build contract. Native components/settings must be used when they cover the requirement. This never publishes and never runs code over the editor UI.cantata-edit/get-element-php: File-code developers only: read the current element owners, revision and protected PHP source for one Kindly page or shared part. Source never belongs in generic page HTML.cantata-edit/set-element-php: Native settings and registered providers first. For an intentional server PHP exception, use server-php intent and the revision/element from get-element-php. Source is protected, syntax checked and signed for this page or part. Saves only a draft, never executes over the editor. Empty PHP removes it.cantata-edit/get-client-design: Read the active parent and child theme plus the complete client design document: brand tokens, layout, assets, component rules, style guide and advanced CSS. Returns a revision required for changes.cantata-edit/validate-client-design: Validate and normalize a complete client design document without saving it.cantata-edit/save-client-design-draft: Validate and save a complete client design as an unpublished draft. It does not change the public site until publish-client-design is called.cantata-edit/publish-client-design: Publish the validated client design draft so its brand, layout and style settings become public.cantata-edit/discard-client-design-draft: Discard the unpublished client design draft without changing the public design.