=== Agents Genie ===
Contributors: advertpreneur
Tags: ai chat, chatbot, leads, customer support, analytics
Requires at least: 6.2
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI chat agents, lead capture, knowledge base, analytics, and team inbox tools for WordPress.

== Description ==

Agents Genie adds a configurable AI chat widget, agent prompts, knowledge base fields, lead capture, conversation analytics, and a team portal to WordPress.

The plugin includes local WordPress admin screens for agent setup, branding, knowledge base content, notifications, exports, and plan status. Hosted AI packages are provided as an external service through Agents Genie Manager. BYOK packages allow site owners to configure their own supported AI provider keys.

All plugin code included in this package is licensed under GPLv2 or later. Paid hosted packages are service plans for external AI usage, message quotas, billing, and manager sync.

== External services ==

Agents Genie can connect to external services only when a site administrator configures or uses those features:

* Agents Genie Manager: site registration, plan entitlement sync, hosted AI requests, usage snapshots, bug reports, and update/telemetry actions. Data may include site URL, domain, WordPress version, plugin version, plan entitlement, usage metadata, chat messages needed for AI responses, and admin-entered bug report details.
* OpenAI: BYOK chat completions and model testing when an administrator selects OpenAI and enters an API key.
* Google Gemini: BYOK chat completions and model testing when an administrator selects Gemini and enters an API key.
* OpenRouter: BYOK chat completions and model testing when an administrator selects OpenRouter and enters an API key.
* Ollama: BYOK or local Ollama-compatible chat/model requests when an administrator selects Ollama.
* WhatsApp: the public widget can open a WhatsApp link when a number is configured by an administrator.

The plugin does not load remote JavaScript or CSS for normal display. Public powered-by credit is optional and defaults off.

Service links:

* Advertpreneur: https://advertpreneur.com
* OpenAI Terms: https://openai.com/policies/terms-of-use
* Google Gemini Terms: https://policies.google.com/terms
* OpenRouter Terms: https://openrouter.ai/terms
* Ollama Terms: https://ollama.com/terms
* WhatsApp Terms: https://www.whatsapp.com/legal/terms-of-service

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/agents-genie`, or install the plugin zip from the WordPress admin.
2. Activate the plugin through the Plugins screen.
3. Open Agents Genie in the WordPress admin.
4. Choose a plan from Plan & Billing, then configure agents and knowledge base content.

== Frequently Asked Questions ==

= Does the plugin require a paid service? =

No. The plugin includes a free plan path. Hosted AI usage and paid quotas are external service packages. BYOK packages allow site owners to use their own provider keys.

= Are public credit links shown automatically? =

No. The powered-by footer is optional and defaults off.

= Does Agents Genie send data to external services? =

Only when configured or triggered by an administrator or when a configured hosted/BYOK AI feature is used. See the External services section for details.

== Changelog ==

= 1.0 =
* Initial release candidate for WordPress.org readiness.
