Ultimate-Multisite · superdav42 · Jul 9, 2026 · Jul 9, 2026
diff --git 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, 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.
+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, customer-facing chat modes, documentation knowledge imports, and optional automation integrations. Version 1.19.0 adds static documentation knowledge imports, anonymous public chat, embeddable documentation chat widgets, customer simple chat mode, a customer chat setup tool, and calendar SMS reminder setup/orchestration on top of the v1.18.0 calendar, approval, notification, managed-service, and Advanced companion workflows.
 
 ## Key Features
 
@@ -32,6 +32,12 @@ Superdav AI Agent is an advanced WordPress AI assistant that extends Gratis AI A
 - **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
+- **Static documentation knowledge imports** — build a searchable knowledge base from configured documentation sites for docs-aware answers
+- **Anonymous public chat** — allow approved visitors to ask limited questions without a WordPress login
+- **Embeddable docs chat widgets** — place a documentation-aware assistant on public docs, help, or product pages
+- **Customer simple chat mode** — present a focused customer-facing assistant with simplified controls and safer defaults
+- **Customer chat setup tool** — guide administrators through the settings needed for a public or customer-facing assistant
+- **Calendar SMS reminder orchestration** — configure calendar-driven text-message reminders with approval, mapping, and deduplication controls
 - **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
@@ -47,13 +53,13 @@ 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, managed Superdav service connection, Google Calendar, or TextBee credentials as needed
+4. Navigate to **Gratis AI Agent → Settings** and configure your internet search provider, managed Superdav service connection, Google Calendar, TextBee credentials, public chat mode, customer chat widget, or documentation import sources 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
 
-Once activated, Superdav AI Agent automatically enhances your Gratis AI Agent installation with theme-aware skills and additional capabilities. Open the **Gratis AI Agent** panel in the WordPress admin sidebar and start using the new features.
+Once activated, Superdav AI Agent automatically enhances your Gratis AI Agent installation with theme-aware skills and additional capabilities. Open the **Gratis AI Agent** panel in the WordPress admin sidebar to use internal assistant features, or use the customer chat setup tool when you want a public or customer-facing assistant.
 
 **Example instructions:**
 
@@ -77,6 +83,18 @@ Review tomorrow's configured Google Calendar events and draft reminders for atte
 Send an SMS reminder after I approve the message.
 ```
 
+```
+Import our documentation site into the assistant knowledge base.
+```
+
+```
+Create a public docs chat widget for the product help centre.
+```
+
+```
+Set up customer simple chat mode for anonymous visitors.
+```
+
 ## 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:
@@ -101,17 +119,30 @@ 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.
 
+## Documentation Knowledge and Customer Chat
+
+Superdav AI Agent v1.19.0 adds customer-facing assistant experiences that can answer from approved documentation sources:
+
+- **Static documentation imports** fetch configured documentation sites and add their content to the assistant knowledge base, making public support answers more consistent with your published docs.
+- **Anonymous public chat** lets visitors ask approved questions without requiring a WordPress account. Keep public tools read-only and limit them to documentation or customer-support use cases.
+- **Embeddable docs chat widgets** can be placed on documentation, help-centre, or product pages so customers can ask questions in context.
+- **Customer simple chat mode** reduces the interface to a focused customer assistant instead of the full administrator chat panel.
+- **Customer chat setup tool** walks administrators through the required public-chat, widget, knowledge-source, and safety settings.
+
+Recommended setup: import trusted documentation sources first, review the generated knowledge counts, enable customer simple chat mode, then embed the docs widget on a limited page before making it broadly available.
+
 ## Calendar, Approval, and Notification Workflows
 
-Superdav AI Agent v1.18.0 expands automation workflows beyond content and site-building tasks:
+Superdav AI Agent v1.18.0 expanded automation workflows beyond content and site-building tasks, and v1.19.0 adds setup/orchestration controls for calendar-driven SMS reminders:
 
 - **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.
+- **Calendar SMS reminder setup** helps administrators connect calendar selections, attendee/contact mappings, SMS provider settings, approval requirements, and reminder deduplication into one reminder workflow.
 
-Use these tools for schedule-aware assistance, attendee follow-up, and reminder workflows that still require human review before sensitive messages are sent.
+Use these tools for schedule-aware assistance, attendee follow-up, and reminder workflows that still require human review before sensitive messages are sent. For customer-facing reminders, test with an administrator-owned number before enabling recurring calendar SMS orchestration.
 
 ## Site Builder Contact Forms
 
@@ -160,13 +191,24 @@ All settings are under **Gratis AI Agent → Settings** in the WordPress admin.
 | **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 |
+| **Static Documentation Sources** | Add documentation URLs or sources that should be imported into the assistant knowledge base |
+| **Public / Customer Chat Mode** | Enable anonymous public chat, customer simple chat mode, and the embeddable docs chat widget |
+| **Calendar SMS Reminder Setup** | Connect calendar selections, contact mappings, approvals, and SMS settings for reminder orchestration |
 
 ## 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.19.0
+
+- **Static documentation knowledge imports** — build searchable assistant knowledge from approved documentation sites
+- **Public and customer chat modes** — support anonymous public chat, customer simple chat mode, embeddable documentation chat widgets, and the customer chat setup tool
+- **Calendar SMS reminder setup** — orchestrate calendar selections, attendee/contact mapping, approvals, deduplication, and TextBee SMS settings for reminder workflows
+- **Public docs chat reliability** — improve public docs chat behaviour, packaging validation, and bundled DI cache packaging for more reliable releases
+- **Chat and provider fixes** — improve retry and recovery states, embedded assistant Markdown rendering, provider/model handling, knowledge count queries, calendar SMS mappings, and tool permission defaults
+
 ## Improvements in v1.18.0
 
 - **Google Calendar support** — read configured calendars and events for schedule-aware automations

diff --git 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. This page documents feedback forwarding, search provider keys, managed Superdav service setup, Google Calendar controls, TextBee SMS settings, and network-wide feature flags.
+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, public/customer chat controls, static documentation imports, calendar SMS reminder setup, and network-wide feature flags.
 
 ## Accessing Settings
 
@@ -109,6 +109,52 @@ Superdav AI Agent v1.18.0 adds TextBee as an SMS provider for configured notific
 
 Send a test message only to an administrator-owned number, then confirm approval-gate behaviour before enabling scheduled or attendee-facing reminders.
 
+## Public and Customer Chat Configuration
+
+Superdav AI Agent v1.19.0 adds settings for customer-facing assistant experiences. Use these controls when visitors or customers should be able to ask limited questions without the full administrator chat panel.
+
+| Field | Description |
+|---|---|
+| **Enable Anonymous Public Chat** | Allows approved unauthenticated visitors to open a public chat experience. Keep enabled tools limited to read-only support or documentation answers. |
+| **Customer Simple Chat Mode** | Uses a simplified customer-facing chat interface instead of the full internal assistant panel. |
+| **Docs Chat Widget / Embed Code** | Provides the widget or embed settings for placing a documentation-aware assistant on help, product, or documentation pages. |
+| **Customer Chat Setup Tool** | Opens a guided setup flow for public-chat mode, widget placement, documentation sources, and safety settings. |
+
+Recommended setup:
+
+1. Configure the assistant name, branding, and public-chat scope.
+2. Enable **Customer Simple Chat Mode** for customer-facing pages.
+3. Use the **Customer Chat Setup Tool** to review allowed tools, anonymous access, and widget placement.
+4. Test the widget in a private or staging page before adding it to public navigation.
+5. Review a sample anonymous conversation and confirm the assistant answers only from approved sources or safe public context.
+
+## Static Documentation Knowledge Imports
+
+Static documentation imports let administrators build a searchable knowledge base from approved documentation sites. Use them before publishing a docs chat widget so the assistant can answer from current product documentation.
+
+| Field | Description |
+|---|---|
+| **Documentation Import Sources** | Lists documentation sites, sections, or source URLs that may be imported. Use only trusted public or internal documentation sources that the assistant is allowed to quote. |
+| **Run Documentation Import** | Starts or refreshes the static documentation import job. |
+| **Knowledge Counts / Import Status** | Shows how many documents or chunks were imported and whether the last import completed successfully. |
+| **Docs Chat Knowledge Scope** | Selects which imported documentation collections the public docs widget may use. |
+
+After each import, check the knowledge count and test representative questions in the docs chat widget. Refresh imports after major documentation releases so customer-facing answers match the current docs.
+
+## Calendar SMS Reminder Setup
+
+Superdav AI Agent v1.19.0 adds setup controls for calendar-driven SMS reminder orchestration. These controls combine calendar access, attendee/contact mapping, SMS provider settings, approval gates, and reminder deduplication.
+
+| Field | Description |
+|---|---|
+| **Calendar Reminder Workflow** | Enables calendar-driven reminder orchestration for selected calendars or event types. |
+| **Reminder Calendar Selection** | Chooses which configured calendars may trigger reminder workflows. |
+| **Attendee / Contact Mapping** | Controls how event attendees are matched to WordPress users, customer records, or known contacts before SMS reminders are prepared. |
+| **Require Approval Before SMS** | Pauses reminder sends until an authorised administrator approves the proposed message. Recommended for customer-facing reminders. |
+| **Reminder Deduplication** | Records sent reminders so retries or scheduled runs do not notify the same contact repeatedly. |
+
+Before enabling recurring reminders, send a test reminder to an administrator-owned number, confirm attendee mapping, approve the proposed message, and verify that reminder records prevent duplicate sends.
+
 ## 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.
@@ -146,6 +192,9 @@ Superdav AI Agent v1.18.0 introduces human approval gates and reminder records f
 | **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. |
+| **Enable Public Chat** | Off | Allows anonymous public chat when public-chat settings and safety controls are configured. |
+| **Enable Customer Simple Chat** | Off | Shows the simplified customer-facing chat mode instead of the internal administrator assistant. |
+| **Enable Docs Chat Widget** | Off | Allows the embeddable documentation chat widget to answer from selected imported documentation sources. |
 
 ### Applying Changes