consolidated: document Superdav AI Agent v1.10.0

[superdav42]

Supersedes #44 — this issue is the consolidated spec.

What

Update the Ultimate Multisite docs for Superdav AI Agent v1.10.0, released 2026-05-05, so the documentation covers the new user-facing features and relevant behavior changes from the release.

Deliverables:

• Document Tavily as a new internet search provider option alongside Brave Search.
• Document the four new theme-aware built-in skills: Block Themes, Classic Themes, Kadence Blocks, and Kadence Theme.
• Document the site builder contact form ability and how to invoke it from the chat interface.
• Add a changelog entry for Superdav AI Agent v1.10.0 that preserves the release notes below.

Why

Superdav AI Agent v1.10.0 added new configuration, skills, and site-builder capabilities that users cannot discover reliably from the current docs. The release also includes fixes and improvements that should be represented in the changelog so users and support staff can understand what changed in 1.10.0.

Per @superdav42, prior workers could not safely implement #44 because it lacked explicit file paths, reference patterns, and verification commands. This consolidated spec supplies those implementation details so the task is directly dispatchable.

How

Update these docs paths:

1. docs/user-guide/configuration/

   • Add Tavily to the internet search provider documentation.
   • Include setup steps for obtaining and entering a Tavily API key in the plugin settings.
   • Reference pattern: model the structure on the existing search provider configuration docs in this directory, preserving current frontmatter and heading style.

2. docs/user-guide/getting-started/ or the user-guide skills section

   • Add documentation for the built-in skills shipped in v1.10.0: Block Themes, Classic Themes, Kadence Blocks, and Kadence Theme.
   • Explain that these skills are theme-aware and automatically selected based on the active WordPress theme.
   • Reference pattern: model on the existing getting-started or skills pages that introduce built-in agent capabilities.

3. docs/user-guide/administration/ or the site builder section

   • Document the new contact form ability in the site builder.
   • Describe how a user invokes adding a contact form from the chat interface.
   • Reference pattern: model on existing user-guide pages that explain chat-driven site builder actions.

4. Changelog documentation for Superdav AI Agent, if present in the docs tree

   • Add this entry exactly enough to preserve the release content:

= 1.10.0 - Released on 2026-05-05 =
* New: Tavily internet search — add Tavily as a search provider for richer internet search results alongside Brave Search
* New: Theme-aware built-in skills — Block Themes, Classic Themes, Kadence Blocks, and Kadence Theme skill guides now ship with the plugin
* New: Site builder contact form ability — add a contact form to any page directly from the chat interface
* Improved: WooCommerce integration refactored to use native WooCommerce APIs for better reliability and compatibility
* Improved: Provider list refreshes automatically when any plugin is activated or deactivated
* Fix: navigate-to ability caused an infinite reload loop on some admin pages
* Fix: list-posts now correctly resolves category and tag names to slugs
* Fix: WP-CLI commands (wp sd-ai-agent) were missing namespace aliases after a previous refactor
* Fix: Event automation gracefully handles sites where automation tables are not yet created
* Fix: memory-save ability now uses the correct namespace prefix in the system instruction builder
* Fix: Scalar tool results are now correctly wrapped before being returned to the AI
* Fix: Usage statistics now correctly handle the legacy ability key format on upgrade from older versions

Verification command:

npm run build

Acceptance Criteria

• Tavily is documented as an internet search provider with configuration steps for the Tavily API key.
• The docs explain the Block Themes, Classic Themes, Kadence Blocks, and Kadence Theme built-in skills.
• The docs state that the new built-in skills are theme-aware and auto-selected based on the active theme.
• The site builder contact form ability is documented, including chat-interface invocation guidance.
• The Superdav AI Agent v1.10.0 changelog entry is present where changelog content is maintained.
• npm run build succeeds.

Context & Decisions

• Original Docs update: Superdav AI Agent v1.10.0 #44, authored by @superdav42, requested documentation updates for Superdav AI Agent v1.10.0 and inlined the release changelog.
• Per @superdav42’s automated escalation comments, the original issue was not worker-ready because it did not include file paths, reference patterns, or verification commands.
• The final agreed approach is to update the user guide in the existing configuration, getting-started/skills, and administration/site-builder areas, using nearby docs as patterns and verifying with the Docusaurus production build.
• Reading Docs update: Superdav AI Agent v1.10.0 #44 is no longer necessary for implementation because this consolidated issue preserves the substantive parent body and comments.

Contributors

cc @superdav42

---

aidevops.sh v3.15.38 plugin for OpenCode v1.14.48 with gpt-5.5 spent 1m and 22,645 tokens on this as a headless worker.

[superdav42]

CLAIM_RELEASED reason=worker_worktree_live_owner runner=dave ts=2026-05-13T17:00:41Z aidevops_version=3.15.38 opencode_version=1.14.48 exit=0 session_count=0