===  AI Workflow Automation – AI Agent Hub===
Contributors: hasanazizul
Donate link: https://atlasaidev.com/
Tags: ai, chatgpt, content-analysis, woocommerce, assistant
Requires at least: 6.9
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI Agent Hub is a WordPress AI assistant plugin that uses the Abilities API to analyze content, and prepare for future WooCommerce.

== Description ==

** AI Workflow Automation – AI Agent Hub for WordPress** is a modern **WordPress AI plugin** built for **WordPress 6.9+** and the new **Abilities API**.

It turns your dashboard into a central **AI control hub** where you can:

* Connect multiple AI providers (via the official **WordPress AI Client**).
* Run AI-powered **content analysis** on posts and pages.
* Generate **SEO-friendly title suggestions** in one click.
* Prepare for upcoming **WooCommerce store management**, **support**, and **automation workflows** – all driven by AI.

This plugin is designed to be:

* 🧠 **AI-first & WordPress-native** – built on top of the **WordPress Abilities API**, so abilities like `ai-workflow-automation-ai-agent-hub/content/analyze-post` can be safely used by WordPress and other tools.
* 🌐 **Multi-provider / multi-agent** – works with the **WordPress AI Client** (`wordpress/wp-ai-client`), so you can use OpenAI, Google Gemini, Anthropic and more (depending on how you configure AI Credentials).
* 🧩 **Modular & extensible** – the first stable module is **AI Content Steward**. Other modules such as **AI Store Manager**, **AI Support Desk**, and **AI Automation Workflows** are visible in the UI as “Coming soon”, and will be expanded without breaking the existing API.

—

### What AI Agent Hub does today

Right now, AI Agent Hub focuses on the most important content tasks for WordPress site owners:

#### 1. AI Content Steward – Post & Page AI Assistant ✅

The **AI Content Steward** module is your AI content assistant inside the editor.

It adds a **meta box** on the post/page edit screen with:

**AI Agent / Provider selection**

* Choose which AI agent should handle this analysis:
  * **Auto** – automatically picks any configured text-capable provider.
  * **OpenAI**
  * **Google Gemini**
  * **Anthropic Claude**
* Provider availability is determined by the **WordPress AI Client** and your settings under **Settings <span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji">→</span></span></span></span></span></span></span></span> AI Credentials**.

**AI-powered content analysis**

* Click **“Analyze Post”** to send the current post to AI.
* AI returns:
  * **Summary** – concise overview (max 3 sentences).
  * **Reading level** – Beginner / Intermediate / Advanced.
  * **Suggestions** – short, bullet-style improvement tips (rendered with extra spacing to keep them readable).
* Great for quickly checking content quality before publishing.

**SEO-friendly title suggestions**

* Click **“Suggest Titles”** to generate multiple, **SEO-optimized title ideas**.
* Useful for:
  * Improving click-through rate (CTR) from search results.
  * Testing different angles for blog posts and pages.
  * Quickly brainstorming alternative headlines with AI.

Under the hood, this module:

* Registers dedicated **Abilities** in the Abilities API:
  * `ai-workflow-automation-ai-agent-hub/content/analyze-post`
  * `ai-workflow-automation-ai-agent-hub/content/suggest-titles`
* Uses the **WordPress AI Client** to call configured providers.
* Protects the abilities with capability checks (`edit_posts`) to keep things safe.

—

### Future modules (visible in UI, growing over time)

These modules are already visible in the **AI Agent Hub** dashboard with a **“Coming soon”** label, so users understand what’s planned. The abilities and UI are structured so you can grow into them without losing compatibility.

#### 2. AI Store Manager (WooCommerce) – Coming Soon 🛒

Planned as a **WooCommerce AI assistant** that can help you:

* Analyze best-selling products and basic store trends.
* Generate and improve **product descriptions** with AI.
* Identify missing or weak product content (titles, descriptions, image alt text).

In this version, a **stub ability** is already registered:

* `ai-workflow-automation-ai-agent-hub/store/analyze-top-products` – currently returns a simple placeholder message: Store Manager is coming soon.

This makes the plugin **forward-compatible** with future WooCommerce features while keeping the current version stable.

#### 3. AI Support Desk – Coming Soon 💬

Planned to become a **lightweight AI support assistant** that can:

* Summarize long comment threads or support inquiries.
* Suggest reply drafts for common questions.
* Categorize and prioritize user requests.

Right now, AI Support Desk appears in the module list as **Coming soon** and can be toggled, but doesn’t expose public UI or abilities yet.

#### 4. AI Automation Recipes / Workflows – Coming Soon ⚙️

Planned to add **simple AI automations** on top of WordPress events, for example:

* “When a post is published <span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji">→</span></span></span></span></span></span></span></span> run content analysis <span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji">→</span></span></span></span></span></span></span></span> save summary to post meta.”
* “When a new WooCommerce order is created <span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji">→</span></span></span></span></span></span></span></span> generate a brief AI summary <span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji">→</span></span></span></span></span></span></span></span> email the admin.”

The **AI Automation** module is shown as **Coming soon** in the dashboard, so users know that more advanced workflows are coming.

—

### AI Agent Hub Dashboard

The plugin adds an **“AI Agent Hub”** top-level menu in the WordPress admin.

From this dashboard you can:

**1. View connected AI providers (AI Agents)**

The **Connected AI Agents** panel shows which providers are detected via the WordPress AI Client:

* Auto (any configured provider)
* OpenAI
* Google Gemini
* Anthropic Claude

Each provider has a status:

* ✅ **Ready** – the provider supports text generation with your current AI credentials.
* ⚠️ **Not configured / unsupported** – the provider can’t be used until you set it up in **Settings <span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji">→</span></span></span></span></span></span></span></span> AI Credentials**.

This gives site owners a clear overview of which AI agents are ready to use in the post editor.

**2. Manage modules & features**

The **Modules & Features** section lists all current and future modules:

* **AI Content Steward** – marked as **Active**.
* **AI Store Manager (WooCommerce)** – **Coming soon** with a basic Abilities API stub.
* **AI Support Desk** – **Coming soon**.
* **AI Automation Recipes / Workflows** – **Coming soon**.

You can toggle modules on/off, although in this version only **AI Content Steward** is fully functional.

**3. Quick support access**

The dashboard includes a **“Contact Support”** button that links directly to:

> https://atlasaidev.com/contact-us/

so users can ask questions or request features from the developer.

—

### Built for Developers and Advanced Users

For developers building AI-powered WordPress solutions, AI Agent Hub offers:

* **Abilities API integration**
  * Abilities such as `ai-workflow-automation-ai-agent-hub/content/analyze-post` and `ai-workflow-automation-ai-agent-hub/content/suggest-titles` are registered with input/output schemas.
* **WordPress AI Client integration**
  * Uses `WordPress\AI_Client\AI_Client::prompt()` and model preferences to negotiate the best available model.
* **Capability-based security**
  * Uses capabilities like `manage_options`, `edit_posts` and `manage_woocommerce` for sensitive operations.
* **React + Tailwind admin UI**
  * Custom React UI bundled via Laravel Mix (no dependency on `@wordpress/scripts` in the admin app).
* **Extensible architecture**
  * Modules are separated and can be expanded in future versions (e.g., full Store Manager, Support Desk, and Workflows), while keeping the same abilities namespace.

—

== Installation ==

=== 1. Requirements ===

Before installing AI Agent Hub, make sure your environment meets these requirements:

* WordPress **6.9** or higher.
* PHP **7.4** or higher.
* At least one AI provider configured via the **WordPress AI Client**:
  * Go to **Settings <span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji">→</span></span></span></span></span></span></span></span> AI Credentials** and add your API key(s) (e.g., OpenAI, Google, Anthropic), as supported by the AI Client.

—

=== 2. Install via WordPress admin (recommended) ===

1. Download the plugin ZIP file.
2. In your WordPress admin, go to **Plugins <span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji">→</span></span></span></span></span></span></span></span> Add New <span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji">→</span></span></span></span></span></span></span></span> Upload Plugin**.
3. Upload the ZIP and click **Install Now**.
4. Click **Activate** to enable ** AI Workflow Automation – AI Agent Hub for WordPress**.

—

=== 3. Install from source (developers) ===

If you are working from the source code (Git/zip without vendor and built assets):

1. SSH/FTP into your site and go to:

   `wp-content/plugins/ai-workflow-automation-ai-agent-hub`

2. Install Composer dependencies:

   `composer install`

   This installs `wordpress/wp-ai-client` and generates `vendor/autoload.php`.

3. Install Node dependencies:

   `npm install`

4. Build the JavaScript and CSS once:

   npm run dev
   npx tailwindcss -c tailwind.config.js -i src/tailwind.css -o assets/css/admin.css

== Frequently Asked Questions ==

= Is this a ChatGPT plugin for WordPress? =

AI Agent Hub works with the **WordPress AI Client**, which can connect to OpenAI (often used as “ChatGPT”), Google Gemini, Anthropic Claude, and other providers. If you configure OpenAI in **Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> AI Credentials**, AI Agent Hub can use those models to analyze content and suggest titles. The plugin itself is provider-agnostic and not limited to a single AI vendor.

= Which AI providers are supported? =

AI Agent Hub supports any provider that the **WordPress AI Client** supports for text generation, including (but not limited to):

* OpenAI (GPT models)
* Google Gemini
* Anthropic Claude

Availability depends on your configuration under **Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> AI Credentials**.

= Why do I see “AI analysis failed. Check AI credentials or logs”? =

This usually means:

* No AI provider is configured for text generation.
* Your API key is invalid or missing required permissions.
* The selected model does not support text generation for the prompt.
* There was a network or API error.

To fix:

1. Go to **Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> AI Credentials** and verify at least one provider is configured.
2. Enable `WP_DEBUG_LOG` and check `debug.log` for lines beginning with `[AI Agent Hub]`.
3. Make sure you are running WordPress 6.9+ and have installed plugin dependencies.

= Where can I find the AI tools in the editor? =

Open any **post** or **page** in the editor. In the sidebar/meta box area, you will see **“AI Content Steward”**. From there you can:

* Choose an AI agent/provider.
* Click **Analyze Post** to get summary, reading level, and suggestions.
* Click **Suggest Titles** to generate SEO-friendly title ideas.

= Does this plugin work with WooCommerce? =

The **AI Store Manager (WooCommerce)** module is currently marked as **Coming soon**. A placeholder ability (`ai-workflow-automation-ai-agent-hub/store/analyze-top-products`) is already registered, but no full WooCommerce UI or functionality is included in this version. Future releases will add AI-powered product descriptions and store insights.

= Is there a Pro version? =

This initial version focuses on:

* Reliable content analysis in the post editor.
* SEO title suggestions.
* A dashboard that surfaces AI providers and future modules.

A Pro version with extended features (full Store Manager, Support Desk, Automation Workflows) is planned, but not required to use the current free features.

= How do I get support or request a feature? =

You can:

* Click the **“Contact Support”** button in the **AI Agent Hub** dashboard, or
* Visit: https://atlasaidev.com/contact-us/

== Changelog ==

= 1.0.0 =

* Initial public release of ** AI Workflow Automation – AI Agent Hub for WordPress**.
* Added **AI Content Steward** module:
  * Meta box in post/page editor with:
    * **Analyze Post** (summary, reading level, suggestions).
    * **Suggest Titles** (SEO-friendly title ideas).
  * Registered Abilities:
    * `ai-workflow-automation-ai-agent-hub/content/analyze-post`
    * `ai-workflow-automation-ai-agent-hub/content/suggest-titles`
* Added **AI Providers Dashboard**:
  * Detects Auto, OpenAI, Google Gemini, Anthropic via the WordPress AI Client.
  * Shows provider status (Ready / Not configured).
* Added **Modules & Features Dashboard**:
  * AI Content Steward – Active.
  * AI Store Manager (WooCommerce) – Coming soon (stub ability).
  * AI Support Desk – Coming soon.
  * AI Automation Recipes / Workflows – Coming soon.
* Registered stub ability for **AI Store Manager**:
  * `ai-workflow-automation-ai-agent-hub/store/analyze-top-products` – placeholder message indicating that Store Manager is coming soon.
* Added **support link** in the dashboard to https://atlasaidev.com/contact-us/.

== Upgrade Notice ==

= 1.0.0 =

First public version of AI Agent Hub.
This release adds the AI Content Steward meta box (content analysis + SEO title suggestions), the AI Agent Hub dashboard, provider detection, and placeholders for upcoming WooCommerce, Support Desk, and Automation modules.