From 0851cc7af62d0ac470ab96352fad4e1168dd1bbc Mon Sep 17 00:00:00 2001 From: "Dave (translate via Sonnet 4.6)" Date: Tue, 30 Jun 2026 05:05:23 -0600 Subject: [PATCH] docs: update Superdav AI Agent 1.18.0 --- docs/addons/superdav-ai-agent/changelog.md | 22 ++++++++ docs/addons/superdav-ai-agent/index.mdx | 53 ++++++++++++++++++- .../superdav-ai-agent/theme-builder/tools.md | 24 ++++++++- .../gratis-ai-agent-settings.md | 49 ++++++++++++++++- .../configuration/built-in-agents.md | 26 +++++++-- 5 files changed, 165 insertions(+), 9 deletions(-) diff --git a/docs/addons/superdav-ai-agent/changelog.md b/docs/addons/superdav-ai-agent/changelog.md index 92ede47f..05bfd25c 100644 --- a/docs/addons/superdav-ai-agent/changelog.md +++ b/docs/addons/superdav-ai-agent/changelog.md @@ -5,6 +5,28 @@ sidebar_position: 5 # Changelog +## 1.18.0 — Released on 2026-06-29 + +### New + +- **Google Calendar tools** — read configured calendars and events for schedule-aware automations +- **Contact mapping and attendee helpers** — match calendar participants to site users and contacts +- **Human approval gates and reminder records** — pause automations for review and avoid duplicate notifications +- **TextBee SMS provider** — send configured text-message notifications through TextBee +- **Advanced companion package** — add trusted-developer filesystem, database, WP-CLI, REST dispatcher, plugin builder, git snapshot, user-management, and benchmark tools distributed separately from the WordPress.org build + +### Improved + +- **Managed Superdav service setup** — add hosted service endpoints and automatic connection provisioning for supported sites +- **Release packaging** — build separate core and Advanced ZIPs, publish both on GitHub, and send only the core package to WordPress.org + +### Fixed + +- **AI request reliability** — improve model selection, request timeouts, default setup model, reasoning-text handling, and retry guidance for invalid tool calls +- **Calendar and reminder hardening** — strengthen Google Calendar tokens and reminder deduplication +- **Onboarding and approval resumes** — fix frontend onboarding launches and confirmed ability resumes +- **WordPress.org packaging review issues** — address packaging review feedback for the core release + ## 1.16.0 — Released on 2026-05-20 ### New diff --git a/docs/addons/superdav-ai-agent/index.mdx b/docs/addons/superdav-ai-agent/index.mdx index 393d2ae8..e6c7a6aa 100644 --- a/docs/addons/superdav-ai-agent/index.mdx +++ b/docs/addons/superdav-ai-agent/index.mdx @@ -9,7 +9,7 @@ import AddonBanner from '@site/src/components/AddonBanner'; # Superdav AI Agent -Superdav AI Agent is an advanced WordPress AI assistant that extends Gratis AI Agent with theme-aware skills, enhanced internet search capabilities, and improved site builder features. Version 1.16.0 adds custom logo generation, palette contrast validation, photo uploads in the discovery interview, structured hospitality menu generation, and desktop/mobile preview rendering in Theme Builder. +Superdav AI Agent is an advanced WordPress AI assistant that extends Gratis AI Agent with theme-aware skills, enhanced internet search capabilities, site builder features, and optional automation integrations. Version 1.18.0 adds Google Calendar read tools, contact and attendee mapping, human approval gates, reminder deduplication, TextBee SMS notifications, managed Superdav service provisioning, and a separately distributed Advanced companion package for trusted developer workflows. ## Key Features @@ -26,6 +26,13 @@ Superdav AI Agent is an advanced WordPress AI assistant that extends Gratis AI A - **Hospitality menus** — generate structured food and beverage menu pages for restaurants, cafes, and hospitality businesses - **Desktop and mobile previews** — preview your design on desktop and mobile devices during design-direction selection - **Tier 1 site scraping** — sd-ai-agent/site-scrape is now available by default for analyzing competitor and inspiration websites +- **Google Calendar read tools** — read configured calendars and events so automations can reason about upcoming schedule context +- **Contact and attendee mapping** — match calendar participants to known site users and contacts before generating follow-up work +- **Human approval gates** — pause sensitive automations for review before sending messages, resuming work, or making changes +- **Reminder records and deduplication** — track reminders that have already been sent so repeat automation runs do not notify the same recipient twice +- **TextBee SMS notifications** — send configured text-message notifications through TextBee when an SMS provider is enabled +- **Managed Superdav service provisioning** — connect supported sites to hosted Superdav endpoints with automatic setup instead of manual endpoint configuration +- **Advanced companion package** — separately distributed trusted-developer tools for filesystem, database, WP-CLI, REST dispatcher, plugin builder, git snapshot, user-management, and benchmark workflows ## Requirements @@ -40,7 +47,9 @@ Superdav AI Agent is an advanced WordPress AI assistant that extends Gratis AI A 1. Upload the plugin files to `/wp-content/plugins/superdav-ai-agent` 2. Activate the plugin through the **Plugins** screen in WordPress 3. Ensure Gratis AI Agent is also activated -4. Navigate to **Gratis AI Agent → Settings** and configure your internet search provider (optional) +4. Navigate to **Gratis AI Agent → Settings** and configure your internet search provider, managed Superdav service connection, Google Calendar, or TextBee credentials as needed + +The WordPress.org package contains the core Superdav AI Agent features. The Advanced companion package is built and distributed separately for environments where trusted developer tools are explicitly installed and authorised. ## Quick Start @@ -60,6 +69,14 @@ Search the web for the latest WordPress security best practices. Create a hero section using the active theme's block patterns. ``` +``` +Review tomorrow's configured Google Calendar events and draft reminders for attendees. +``` + +``` +Send an SMS reminder after I approve the message. +``` + ## Theme-Aware Skills Superdav AI Agent automatically detects your active theme and installed plugins, loading the appropriate theme-aware skill into the assistant's context. Available skills include: @@ -84,6 +101,18 @@ Superdav AI Agent v1.10.0 adds **Tavily** as an alternative to Brave Search for See [Internet Search](../../user-guide/configuration/internet-search) for configuration instructions. +## Calendar, Approval, and Notification Workflows + +Superdav AI Agent v1.18.0 expands automation workflows beyond content and site-building tasks: + +- **Google Calendar tools** let the agent read configured calendars and event details when calendar credentials are available. +- **Contact and attendee helpers** map event participants to WordPress users or known contacts before preparing reminders or follow-up tasks. +- **Human approval gates** allow an automation to pause until an authorised user reviews the proposed action. +- **Reminder records** prevent duplicate calendar or notification reminders when an automation is retried or scheduled repeatedly. +- **TextBee SMS support** enables text-message notifications when the TextBee provider is configured. + +Use these tools for schedule-aware assistance, attendee follow-up, and reminder workflows that still require human review before sensitive messages are sent. + ## Site Builder Contact Forms The Site Builder agent can now create contact forms directly from the chat interface. Simply ask the Site Builder to create a contact form, and it will automatically detect your installed form plugin (Contact Form 7, WPForms, Fluent Forms, or Gravity Forms) and generate a ready-to-use form. @@ -128,6 +157,26 @@ All settings are under **Gratis AI Agent → Settings** in the WordPress admin. |---|---| | **Internet Search Provider** | Choose between Brave Search and Tavily (optional) | | **Tavily API Key** | API key for Tavily internet search (if Tavily is selected) | +| **Managed Superdav Service** | Connect supported sites to the hosted Superdav service with automatic endpoint provisioning | +| **Google Calendar Credentials** | Configure calendar access so the agent can read calendars and events | +| **TextBee SMS Provider** | Configure TextBee credentials for approved SMS notification workflows | + +## Advanced Companion Package + +Superdav AI Agent v1.18.0 adds a separately distributed Advanced companion package for trusted developer workflows. These capabilities are not bundled in the WordPress.org core package. Install the companion package only on sites where administrators explicitly trust the agent to access developer tooling. + +Advanced tools include filesystem operations, database access, WP-CLI, REST dispatcher workflows, plugin builder utilities, git snapshots, user-management helpers, and benchmark tooling. Keep these tools limited to trusted administrators and review approval-gate configuration before enabling them on production sites. + +## Improvements in v1.18.0 + +- **Google Calendar support** — read configured calendars and events for schedule-aware automations +- **Contact and attendee mapping** — match calendar participants to site users and contacts +- **Human approval gates** — pause sensitive automations for review before continuing +- **Reminder deduplication** — record reminders to avoid duplicate notifications on retries or repeated runs +- **TextBee SMS provider** — send configured text-message notifications after required approvals +- **Managed Superdav service setup** — provision hosted service endpoints automatically for supported sites +- **Advanced companion distribution** — publish trusted-developer tools separately from the WordPress.org core build +- **Reliability fixes** — improve model selection, request timeouts, default setup model handling, reasoning-text handling, retry guidance, calendar token hardening, reminder hardening, onboarding launches, confirmed ability resumes, and WordPress.org packaging review issues ## Improvements in v1.16.0 diff --git a/docs/addons/superdav-ai-agent/theme-builder/tools.md b/docs/addons/superdav-ai-agent/theme-builder/tools.md index a0456be3..890f41fb 100644 --- a/docs/addons/superdav-ai-agent/theme-builder/tools.md +++ b/docs/addons/superdav-ai-agent/theme-builder/tools.md @@ -5,7 +5,7 @@ sidebar_position: 4 # Tools and Configuration -Theme Builder uses a set of tools to analyze, design, and build your WordPress site. In version 1.16.0, **sd-ai-agent/site-scrape is now a Tier 1 tool**, making it available by default in Theme Builder. +Theme Builder uses a set of tools to analyze, design, and build your WordPress site. In version 1.16.0, **sd-ai-agent/site-scrape is now a Tier 1 tool**, making it available by default in Theme Builder. Superdav AI Agent v1.18.0 also introduces a separately distributed Advanced companion package for trusted developer workflows; those tools are not part of the WordPress.org core package and must be installed and authorised separately. ## Available Tools @@ -99,6 +99,23 @@ Provides advanced design capabilities: - Advanced color theory - Typography optimization +### Advanced Companion Tools (Separate Package) + +The Advanced companion package is distributed separately from the core Superdav AI Agent release. It is intended for trusted developer and site-owner environments where administrators explicitly allow the agent to use high-impact tooling. + +Advanced companion capabilities can include: + +- **Filesystem tools** — inspect and modify approved files in trusted environments +- **Database tools** — query or update site data when explicitly authorised +- **WP-CLI tools** — run WordPress maintenance and inspection commands +- **REST dispatcher tools** — call registered REST endpoints through controlled dispatch workflows +- **Plugin builder tools** — scaffold and iterate on plugin code +- **Git snapshot tools** — create snapshots before risky developer operations +- **User-management tools** — help review or adjust user records where permitted +- **Benchmark tools** — run performance or capability benchmarks for development review + +Do not document these as generally available Theme Builder tools for every installation. They are available only when the Advanced companion package is installed, enabled, and restricted to trusted administrators. + ## Tool Configuration ### Enabling Tools @@ -118,6 +135,7 @@ Some tools require permissions: - **Analytics** — requires Google Analytics integration - **Content generation** — requires API keys - **Advanced features** — may require premium subscription +- **Advanced companion tools** — require the separately distributed Advanced package and explicit administrator trust ### API Keys and Credentials @@ -128,6 +146,10 @@ Configure API keys for tools that require them: 3. Test connection 4. Save securely +### Installing the Advanced Companion Package + +The Advanced companion package is released separately from the WordPress.org core ZIP. Install it only from the official project distribution channel for the release, then restrict access to trusted administrators. Review human approval gates and git snapshot behaviour before enabling filesystem, database, WP-CLI, REST dispatcher, plugin builder, user-management, or benchmark tools on a production site. + ## Using sd-ai-agent/site-scrape ### Basic Usage diff --git a/docs/user-guide/administration/gratis-ai-agent-settings.md b/docs/user-guide/administration/gratis-ai-agent-settings.md index 946c7afc..055761ec 100644 --- a/docs/user-guide/administration/gratis-ai-agent-settings.md +++ b/docs/user-guide/administration/gratis-ai-agent-settings.md @@ -5,7 +5,7 @@ sidebar_position: 22 # Gratis AI Agent Settings -The **Settings → Advanced** screen in Gratis AI Agent provides administrator-level configuration for backend integrations introduced in v1.5.0. This page documents the **Feedback Endpoint** fields and their expected format. +The **Settings → Advanced** screen in Gratis AI Agent provides administrator-level configuration for backend integrations. This page documents feedback forwarding, search provider keys, managed Superdav service setup, Google Calendar controls, TextBee SMS settings, and network-wide feature flags. ## Accessing Settings @@ -73,6 +73,42 @@ The field label includes a clickable link to the Brave Search API sign-up page. See [Internet Search](../configuration/internet-search) for end-user documentation on this feature. +## Managed Superdav Service + +Superdav AI Agent v1.18.0 adds managed Superdav service endpoints and automatic connection provisioning for supported sites. Use these controls when your site should connect to the hosted provider instead of a manually configured service endpoint. + +| Field | Description | +|---|---| +| **Managed Superdav Service** | Enables the hosted Superdav service connection for supported sites. | +| **Provision Connection** | Starts automatic endpoint and credential provisioning. Use this after confirming the site should use the managed provider. | +| **Service Endpoint / Connection Status** | Shows the current endpoint or connection state after provisioning. | + +After provisioning, save settings and verify the connection status before relying on managed-service workflows. If provisioning fails, review the displayed retry guidance and confirm the site has permission to use the hosted provider. + +## Google Calendar Configuration + +When Superdav AI Agent v1.18.0 calendar features are enabled, the agent can read configured calendars and event details. Calendar tools are read-oriented and are useful for schedule-aware reminders, attendee follow-up, and contact matching. + +| Field | Description | +|---|---| +| **Google Calendar Credentials** | Stores the credentials or token connection required to read calendar data. | +| **Calendar Selection** | Limits which configured calendars the agent may inspect. | +| **Calendar Connection Status** | Confirms whether the current credentials can read calendars and events. | + +Keep calendar credentials limited to the calendars the agent needs. Reconnect or rotate credentials if the status indicates an expired token. + +## TextBee SMS Notifications + +Superdav AI Agent v1.18.0 adds TextBee as an SMS provider for configured notification workflows. SMS notifications should be paired with human approval gates for sensitive or user-facing messages. + +| Field | Description | +|---|---| +| **TextBee API Key** | Authenticates requests to the TextBee SMS provider. | +| **TextBee Device / Sender** | Selects the TextBee sender or device used for outgoing messages, when required by the provider. | +| **SMS Notifications Enabled** | Allows approved workflows to send text-message notifications. Leave disabled to prevent SMS sends. | + +Send a test message only to an administrator-owned number, then confirm approval-gate behaviour before enabling scheduled or attendee-facing reminders. + ## Feature Flags Also introduced in v1.9.0, the **Settings → Feature Flags** tab provides toggle switches for optional functionality. Each flag is either enabled or disabled network-wide; there is no per-site override at this time. @@ -100,6 +136,17 @@ Also introduced in v1.9.0, the **Settings → Feature Flags** tab provides toggl | **Hide Agent Picker** | Off | When enabled, users cannot switch between the five built-in agents. The current agent is fixed to whatever is configured as the default in Settings → General. | | **Use Site Icon as Chat Avatar** | Off | Replaces the default AI icon in the chat widget header with the WordPress site icon (set under Appearance → Customize → Site Identity). | +### Automation Safety Flags + +Superdav AI Agent v1.18.0 introduces human approval gates and reminder records for safer automation runs. These controls may appear in the feature flags or advanced automation settings, depending on the installed package. + +| Flag | Default | Description | +|---|---|---| +| **Require Human Approval** | Recommended on | Pauses sensitive automations until an authorised user reviews and confirms the proposed action. | +| **Reminder Deduplication** | On | Records sent reminders so retries or scheduled runs do not send duplicate notifications. | +| **Enable Calendar Tools** | Off until configured | Allows the agent to read configured Google calendars and events. | +| **Enable SMS Notifications** | Off until configured | Allows approved workflows to send TextBee SMS notifications after credentials are saved. | + ### Applying Changes Click **Save Settings** after toggling any flag. Changes take effect immediately — no cache flush or plugin reactivation is required. diff --git a/docs/user-guide/configuration/built-in-agents.md b/docs/user-guide/configuration/built-in-agents.md index ce2928c6..4b809424 100644 --- a/docs/user-guide/configuration/built-in-agents.md +++ b/docs/user-guide/configuration/built-in-agents.md @@ -5,7 +5,7 @@ sidebar_position: 12 # Built-in Agents -Gratis AI Agent v1.9.0 ships five built-in agents, each pre-configured with a focused set of tools, a tailored system prompt, and starter suggestions matched to common tasks in that area. Switching between agents changes what the assistant can do and how it responds — without any configuration on your part. +Gratis AI Agent v1.9.0 ships five built-in agents, each pre-configured with a focused set of tools, a tailored system prompt, and starter suggestions matched to common tasks in that area. Switching between agents changes what the assistant can do and how it responds — without any configuration on your part. Superdav AI Agent v1.18.0 can add schedule-aware tools, reminder records, approval gates, and SMS notifications to these workflows when the related integrations are configured. ## What Is an Agent? @@ -30,18 +30,20 @@ You can also switch agents mid-conversation — the new agent's system prompt ta **Focus:** Creating and editing posts, pages, and contact forms. -**Available tools:** `create_post`, `update_post`, `batch_create_posts`, `set_featured_image`, `create_contact_form`, `get_option`, `list_post_types` +**Available tools:** `create_post`, `update_post`, `batch_create_posts`, `set_featured_image`, `create_contact_form`, `get_option`, `list_post_types`. With Superdav AI Agent v1.18.0 integrations enabled, configured calendar context, approval gates, reminders, and SMS notification tools may also be available to approved workflows. **What it does well:** - Drafting and publishing blog posts from a brief or outline - Creating batches of landing pages for a new site - Building contact and enquiry forms - Setting featured images on posts from a URL or search +- Drafting event follow-up messages from configured Google Calendar context, then pausing for approval before sending notifications **Starter suggestions:** - *Write a 500-word blog post about the benefits of WordPress multisite.* - *Create an About, Services, and Contact page and publish them.* - *Add a booking enquiry form to the Contact page.* +- *Draft a reminder for attendees on tomorrow's configured calendar event and wait for approval before sending it.* --- @@ -49,7 +51,7 @@ You can also switch agents mid-conversation — the new agent's system prompt ta **Focus:** End-to-end website creation from a single prompt. -**Available tools:** `create_site_plan`, `execute_site_plan`, `get_plan_progress`, `handle_plan_error`, `create_post`, `batch_create_posts`, `register_post_type`, `create_menu`, `add_menu_item`, `inject_custom_css`, `apply_theme_json_preset`, `install_ability`, `recommend_plugin`, `create_contact_form` +**Available tools:** `create_site_plan`, `execute_site_plan`, `get_plan_progress`, `handle_plan_error`, `create_post`, `batch_create_posts`, `register_post_type`, `create_menu`, `add_menu_item`, `inject_custom_css`, `apply_theme_json_preset`, `install_ability`, `recommend_plugin`, `create_contact_form`. With Superdav AI Agent v1.18.0, configured managed-service, approval, reminder, calendar, and SMS tools may be available where administrators enable them. **What it does well:** - Generating a multi-phase site build plan for a described business type @@ -57,12 +59,14 @@ You can also switch agents mid-conversation — the new agent's system prompt ta - Recovering from errors mid-plan without requiring manual intervention - Installing recommended plugins as part of the build - Creating contact forms directly from the chat interface (Superdav AI Agent v1.10.0+) +- Coordinating launch reminders or attendee follow-up without duplicate notifications when approval gates and reminder records are enabled **Starter suggestions:** - *Build a photography portfolio site with a gallery post type, a booking page, and a contact form.* - *Create a restaurant website with an online menu, opening hours, and a table-booking enquiry form.* - *Set up a freelance consulting site with service pages, a portfolio section, and a blog.* - *Add a contact form to the Contact page using the site builder.* +- *After the site launch checklist is approved, send an SMS reminder to the configured stakeholder contact.* --- @@ -83,8 +87,6 @@ You can also switch agents mid-conversation — the new agent's system prompt ta - *Take a screenshot of the homepage and tell me what you'd improve.* - *Create a reusable hero block pattern with a full-width background image and centred heading.* ---- - ### Plugin Manager **Focus:** Discovering, installing, and managing WordPress plugins. @@ -122,6 +124,20 @@ You can also switch agents mid-conversation — the new agent's system prompt ta --- +## Superdav Automation Integrations + +When Superdav AI Agent v1.18.0 integrations are configured, built-in agents can participate in safer schedule-aware automation workflows: + +- **Google Calendar read tools** allow agents to inspect configured calendars and events before drafting follow-up work. +- **Contact and attendee mapping** helps match event participants to WordPress users or known contacts. +- **Human approval gates** pause sensitive actions until an authorised user reviews and confirms them. +- **Reminder records** prevent duplicate notifications when scheduled jobs retry or repeat. +- **TextBee SMS notifications** send configured text messages only when SMS credentials and workflow permissions are enabled. + +Recommended workflow: ask the agent to prepare the message or action, review the approval prompt, then allow the approved action to resume. For recurring reminders, keep reminder deduplication enabled so the same event or contact is not notified repeatedly. + +--- + ## Customising Agents Each built-in agent can be extended or replaced through the `gratis_ai_agent_agents` filter.