=== AIOHM Knowledge Assistant ===
Contributors: ohmevents
Tags: ai assistant, knowledge base, chatbot, brand voice, personalized ai
Requires at least: 6.2
Tested up to: 6.8
Stable tag: 1.3.8
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create intelligent AI chatbots that reflect your brand voice and provide accurate answers from your WordPress content.

== Description ==

Transform your WordPress site into an intelligent knowledge base with AI-powered chatbots that understand your brand's unique voice. AIOHM Knowledge Assistant processes your existing content to deliver accurate, contextual responses while maintaining your authentic communication style.

## Key Features

**Intelligent Content Processing**
* Automatic indexing of WordPress posts, pages, and uploaded files
* Support for PDF, CSV, TXT, and JSON document formats
* Advanced semantic search with vector embeddings
* Smart content chunking for optimal AI processing

**Multi-Provider AI Integration**
* OpenAI GPT models (GPT-3.5, GPT-4)
* Google Gemini Pro with advanced embeddings
* Anthropic Claude for sophisticated reasoning
* Groq for ultra-fast inference with Llama and Mistral models
* ShareAI for specialized model access
* Complete API key privacy - your data stays under your control

**Brand Voice Alignment**
* Comprehensive brand personality questionnaire
* Custom system prompts and tone configuration
* Consistent voice across all AI interactions
* Private brand assistant for internal team use

**Enterprise-Grade Security**
* Encrypted API key storage using WordPress security constants
* Rate limiting (100 requests/hour per user and IP)
* Membership-based access control integration
* GDPR-compliant data handling practices
* Private knowledge segregation for sensitive content

**Performance Optimized**
* WordPress object cache integration
* Intelligent caching with automatic invalidation
* Minimal server resource requirements
* CDN-compatible static assets

## Use Cases

**Professional Services**: Provide 24/7 client support while maintaining confidential internal processes through dual-mode functionality.

**Content Creators**: Get writing assistance that matches your style while offering public AI assistance to your audience.

**E-commerce**: Answer product questions instantly while using private mode for inventory management and strategic planning.

**Coaching & Consulting**: Replace repetitive client questions with an AI that understands your methodology and speaks with your expertise.

## Implementation

Deploy AI functionality through three shortcodes:
* `[aiohm_chat]` - Public chatbot for website visitors
* `[aiohm_search]` - Knowledge base search interface
* `[aiohm_private_assistant]` - Private AI assistant for authenticated users

The plugin automatically processes WordPress shortcodes, extracts meaningful content from complex layouts, and maintains context relationships between content pieces.

## Technical Requirements

* WordPress 6.2 or higher
* PHP 7.4 or higher
* API key from at least one supported provider (OpenAI, Claude, Gemini, Groq, or ShareAI)
* Optional: Paid Memberships Pro for advanced access control

## Privacy & External Services

This plugin connects to external AI services only when configured with user-provided API keys. All communications use secure HTTPS connections, and no conversation data is stored on external servers beyond temporary processing requirements.

**Supported AI Services:**
* OpenAI API (api.openai.com) - [Terms](https://openai.com/terms/) | [Privacy](https://openai.com/privacy/)
* Google Gemini API (generativelanguage.googleapis.com) - [Terms](https://ai.google.dev/terms) | [Privacy](https://policies.google.com/privacy)
* Anthropic Claude API (api.anthropic.com) - [Terms](https://www.anthropic.com/terms) | [Privacy](https://www.anthropic.com/privacy)
* Groq API (api.groq.com) - [Terms](https://groq.com/terms-of-service/) | [Privacy](https://groq.com/privacy-policy/)
* ShareAI API (shareai.com) - [Terms](https://shareai.com/terms) | [Privacy](https://shareai.com/privacy)

User consent is required before making any external API calls. All API keys are encrypted and stored securely in your WordPress database.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/aiohm-knowledge-assistant/`
2. Activate the plugin through the WordPress Plugins menu
3. Navigate to AIOHM > Settings and configure your AI provider API key
4. Run the content scan to build your knowledge base
5. Configure your brand voice settings
6. Add shortcodes to display AI functionality on your site

== Frequently Asked Questions ==

= What AI providers are supported? =

AIOHM supports OpenAI (GPT-3.5, GPT-4), Google Gemini Pro, Anthropic Claude, Groq (ultra-fast inference), and ShareAI. You need only one API key to get started.

= How does this differ from other AI chatbot plugins? =

AIOHM offers dual-mode functionality: a public chatbot trained on approved content and a private AI assistant with access to confidential materials. It captures and reflects your actual writing style rather than providing generic responses.

= Is coding knowledge required? =

No programming skills are needed. All configuration is handled through the WordPress dashboard with intuitive interfaces. Implementation requires only copying and pasting shortcodes.

= Will this impact website performance? =

No. AI processing occurs on external servers, not your website. The plugin is optimized for performance with smart caching and minimal resource usage.

= How does the privacy mode work? =

Private mode content is completely separate from public content. Only authenticated users with proper permissions can access private AI features. Confidential documents remain invisible to public users.

= Can I customize the appearance? =

Yes. The plugin includes CSS customization options, supports theme integration, and provides responsive design that works across all devices.

= What file types can be processed? =

WordPress posts and pages, PDF documents, CSV files, TXT files, and JSON data. The plugin intelligently extracts and processes content from each format.

= How is my data secured? =

API keys are encrypted using WordPress security constants, all database operations use prepared statements, and the plugin follows WordPress security best practices. Your data remains on your server except when sent to AI providers for processing.

= Can I restrict access to the private assistant? =

Yes. The plugin integrates with Paid Memberships Pro and supports custom user roles for complete control over private AI feature access.

= What happens if the AI doesn't know something? =

The AI will indicate when it lacks sufficient information and direct users to contact you directly. It doesn't generate responses from outdated internet information or make up answers.

== Changelog ==

= 1.3.8 =
**Groq Integration & Enhanced Model Selection**
* Added Groq API support with ultra-fast Llama 3.3 70B model for lightning-fast AI responses
* Enhanced Mirror Mode and Muse Mode AI model selection to include all configured providers
* Fixed AI model selection dropdowns to dynamically update based on saved API keys
* Reorganized Premium AI Services section into clean 2-column layout
* Removed "More API Connectors Soon" banner for cleaner interface
* Added complete Groq chat completion handler with model mapping and usage logging
* Enhanced HTTP request authentication system to support Groq Bearer token
* Updated AI client dispatcher to route Groq models to appropriate handler

= 1.3.7 =
**Production Ready & WordPress.org Compliance**
* Complete WordPress.org directory compliance with all security and coding standards
* Enhanced external service documentation for transparency
* Improved plugin stability and performance optimizations
* Comprehensive internationalization support for global users

== Upgrade Notice ==

= 1.3.8 =
Major update adds Groq ultra-fast AI inference and enhances model selection across all modes. Recommended for users seeking lightning-fast AI responses.

= 1.3.7 =
Production-ready release with complete WordPress.org compliance and enhanced stability. Recommended for all users.

== Screenshots ==

1. **Dashboard Overview** - Complete control center for AI assistant setup and management
2. **Mirror Mode Configuration** - Set up your public chatbot with brand voice and personality
3. **Muse Mode Settings** - Configure your private AI assistant for creative workflows
4. **Knowledge Base Manager** - View, organize, and manage all indexed content
5. **Brand Soul Questionnaire** - Define your unique voice and communication style
6. **Public Chat Interface** - Clean, responsive chatbot for website visitors
7. **Private Assistant Interface** - Full-featured AI assistant for authenticated users
8. **Content Scanning** - Automatic indexing of posts, pages, and uploaded documents