feat(providers): add DeepSeek, Mistral AI, Perplexity + refresh xAI, OpenAI, Anthropic, Gemini (v2.6.4)

New providers (v2.6.4):
- deepseek_provider: DeepSeek V4 (deepseek-v4-flash, deepseek-v4-pro), three-layer agentic protection
- mistral_provider: Mistral AI (mistral-large, codestral, devstral, magistral, 22 models), three-layer protection
- perplexity_provider: Perplexity Sonar (sonar, sonar-pro, sonar-reasoning-pro, sonar-deep-research), web-grounded

Updated providers:
- xai_provider v1.1.0: grok-4.3, grok-4.20 reasoning/non-reasoning, grok-build-0.1, grok-imagine-* (16 models)
- openai_provider v1.1.0: GPT-5.5, gpt-5.3-codex, o3, o3-mini current model IDs
- anthropic_provider v1.1.0: claude-opus-4-7, claude-sonnet-4-6, claude-haiku-4-5; retirement note for 4-0 series
- gemini_provider v1.1.0: gemini-3.5-flash, gemini-3.1-pro-preview, gemini-3.1-flash-* current model IDs

Infrastructure:
- providers/__init__.py v1.1.0: exports for all three new providers
- community_guardian.py: protect_deepseek, protect_mistral, protect_perplexity convenience functions
- pyproject.toml: [xai], [deepseek], [mistral], [perplexity] optional-dependency extras
- Tests: 138 new tests (46 per provider), 1806 total passing
- README: provider install examples and code snippets for all new providers

Author: Oracles Technologies LLC

README.md

@@ -40,9 +40,16 @@ pip install ethicore-engine-guardian
 
 With provider integrations:
 ```bash
-pip install "ethicore-engine-guardian[openai]"
-pip install "ethicore-engine-guardian[anthropic]"
-pip install "ethicore-engine-guardian[openai,anthropic]"
+# Cloud (OpenAI-compatible)
+pip install "ethicore-engine-guardian[openai]"       # OpenAI (GPT-5.5, o3, Codex)
+pip install "ethicore-engine-guardian[xai]"          # xAI / Grok (grok-4.3, grok-build)
+pip install "ethicore-engine-guardian[deepseek]"     # DeepSeek (deepseek-v4-flash, v4-pro)
+pip install "ethicore-engine-guardian[mistral]"      # Mistral AI (mistral-large, codestral, devstral)
+pip install "ethicore-engine-guardian[perplexity]"   # Perplexity Sonar (web-grounded models)
+
+# Cloud (native SDK)
+pip install "ethicore-engine-guardian[anthropic]"    # Anthropic (claude-opus-4-7, claude-sonnet-4-6)
+pip install "ethicore-engine-guardian[google]"       # Google Gemini (gemini-3.5-flash, gemini-3.1-pro)
 ```
 
 With visual analysis (images):
@@ -401,6 +408,71 @@ guardian = Guardian(config=GuardianConfig(api_key="eg_live_..."))
 client = guardian.wrap(anthropic.Anthropic())
 ```
 
+### xAI / Grok
+
+```python
+import openai
+from ethicore_guardian import Guardian, GuardianConfig
+
+guardian = Guardian(config=GuardianConfig(api_key="eg_live_..."))
+client = guardian.wrap(
+    openai.OpenAI(api_key="xai-...", base_url="https://api.x.ai/v1")
+)
+response = client.chat.completions.create(
+    model="grok-4.3",
+    messages=[{"role": "user", "content": user_input}]
+)
+```
+
+### DeepSeek
+
+```python
+import openai
+from ethicore_guardian import Guardian, GuardianConfig
+
+guardian = Guardian(config=GuardianConfig(api_key="eg_live_..."))
+client = guardian.wrap(
+    openai.OpenAI(api_key="sk-...", base_url="https://api.deepseek.com")
+)
+response = client.chat.completions.create(
+    model="deepseek-v4-flash",
+    messages=[{"role": "user", "content": user_input}]
+)
+```
+
+### Mistral AI
+
+```python
+import openai
+from ethicore_guardian import Guardian, GuardianConfig
+
+guardian = Guardian(config=GuardianConfig(api_key="eg_live_..."))
+client = guardian.wrap(
+    openai.OpenAI(api_key="...", base_url="https://api.mistral.ai/v1")
+)
+response = client.chat.completions.create(
+    model="mistral-large-latest",
+    messages=[{"role": "user", "content": user_input}]
+)
+```
+
+### Perplexity
+
+```python
+import openai
+from ethicore_guardian import Guardian, GuardianConfig
+
+guardian = Guardian(config=GuardianConfig(api_key="eg_live_..."))
+client = guardian.wrap(
+    openai.OpenAI(api_key="pplx-...", base_url="https://api.perplexity.ai")
+)
+# Guardian scans the user prompt before Perplexity fetches web sources
+response = client.chat.completions.create(
+    model="sonar-pro",
+    messages=[{"role": "user", "content": user_input}]
+)
+```
+
 ### Ollama (local LLMs)
 
 ```python

ethicore_guardian/__init__.py

@@ -7,7 +7,7 @@
 """
 
 # Version information
-__version__ = "2.6.3"
+__version__ = "2.6.4"
 __author__ = "Oracles Technologies LLC"
 
 # Core exports — full API-tier guardian preferred; community fallback for wheel installs

ethicore_guardian/community_guardian.py

@@ -510,8 +510,11 @@ def wrap(self, client: Any) -> Any:
         """
         Wrap an AI provider client so every request is scanned first.
 
-        Community edition supports OpenAI, xAI/Grok, and Azure OpenAI
-        clients (anything with a ``.chat.completions.create`` interface).
+        Community edition supports any OpenAI-compatible client
+        (OpenAI, xAI/Grok, DeepSeek, Mistral AI, Perplexity, Azure OpenAI)
+        and anything with a ``.chat.completions.create`` interface.
+        Full three-layer agentic protection (tool result and tool call scanning)
+        requires the API tier.
         """
         return _WrappedClient(client, self)
 
@@ -609,6 +612,27 @@ def protect_xai(client: Any, api_key: Optional[str] = None) -> Any:
     return Guardian(api_key=api_key).wrap(client)
 
 
+def protect_deepseek(client: Any, api_key: Optional[str] = None) -> Any:
+    """Wrap a DeepSeek client with Guardian protection."""
+    return Guardian(api_key=api_key).wrap(client)
+
+
+def protect_mistral(client: Any, api_key: Optional[str] = None) -> Any:
+    """Wrap a Mistral AI client with Guardian protection."""
+    return Guardian(api_key=api_key).wrap(client)
+
+
+def protect_perplexity(client: Any, api_key: Optional[str] = None) -> Any:
+    """
+    Wrap a Perplexity Sonar client with Guardian protection.
+
+    Guardian scans the user-supplied prompt before it reaches Perplexity.
+    Web-fetched content within Perplexity's inference pipeline is outside
+    the API boundary. Full three-layer agentic protection requires the API tier.
+    """
+    return Guardian(api_key=api_key).wrap(client)
+
+
 def protect_azure(client: Any, api_key: Optional[str] = None) -> Any:
     """Wrap an Azure OpenAI client with Guardian protection."""
     return Guardian(api_key=api_key).wrap(client)

ethicore_guardian/providers/__init__.py

@@ -1,16 +1,35 @@
 """
 Ethicore Engine™ - Guardian SDK - Providers Package
 AI provider integrations for Guardian SDK
-"""
 
-# This makes the providers directory a proper Python package.
-# Providers are importable either directly from their module or from here.
+Supported providers:
+  Local / self-hosted:
+    LM Studio, llama.cpp, LocalAI, Jan.ai  — local_openai_compat_provider
+    Ollama                                  — guardian_ollama_provider
+
+  Cloud (OpenAI-compatible API):
+    xAI / Grok                              — xai_provider
+    DeepSeek                                — deepseek_provider
+    Mistral AI                              — mistral_provider
+    Perplexity                              — perplexity_provider
+
+  Cloud (native API):
+    OpenAI                                  — openai_provider
+    Anthropic                               — anthropic_provider
+    Google Gemini                           — gemini_provider
+    Azure OpenAI                            — azure_provider
+    AWS Bedrock                             — bedrock_provider
+
+  Meta-provider:
+    LiteLLM (140+ backends)                 — litellm_provider
+
+  Framework integrations:
+    LangChain callback                      — langchain_callback
+"""
 
-__version__ = "1.0.0"
+__version__ = "1.1.0"
 
 # ── Local OpenAI-compatible providers ────────────────────────────────────────
-# LM Studio, llama.cpp server, LocalAI, Jan.ai — all share the same
-# OpenAI-compatible REST API, covered by a single implementation.
 from .local_openai_compat_provider import (
     LocalOpenAICompatConfig,
     LocalOpenAICompatProvider,
@@ -31,25 +50,66 @@
     LocalProviderError,
 )
 
+# ── DeepSeek provider ─────────────────────────────────────────────────────────
+from .deepseek_provider import (
+    DeepSeekProvider,
+    ProtectedDeepSeekClient,
+    create_protected_deepseek_client,
+    DEEPSEEK_BASE_URL,
+    DEEPSEEK_MODELS,
+)
+
+# ── Mistral AI provider ───────────────────────────────────────────────────────
+from .mistral_provider import (
+    MistralProvider,
+    ProtectedMistralClient,
+    create_protected_mistral_client,
+    MISTRAL_BASE_URL,
+    MISTRAL_MODELS,
+)
+
+# ── Perplexity provider ───────────────────────────────────────────────────────
+from .perplexity_provider import (
+    PerplexityProvider,
+    ProtectedPerplexityClient,
+    create_protected_perplexity_client,
+    PERPLEXITY_BASE_URL,
+    PERPLEXITY_MODELS,
+)
+
 __all__ = [
-    # Config
+    # ── Local OpenAI-compatible ───────────────────────────────────────────────
     "LocalOpenAICompatConfig",
-    # Base provider
     "LocalOpenAICompatProvider",
-    # Named providers
     "LMStudioProvider",
     "LlamaCppProvider",
     "LocalAIProvider",
     "JanAIProvider",
-    # Wrapped clients
     "ProtectedLocalClient",
     "ProtectedAsyncLocalClient",
-    # Convenience factories
     "create_protected_lmstudio_client",
     "create_protected_llamacpp_client",
     "create_protected_localai_client",
     "create_protected_janai_client",
-    # Exceptions
+    # ── DeepSeek ─────────────────────────────────────────────────────────────
+    "DeepSeekProvider",
+    "ProtectedDeepSeekClient",
+    "create_protected_deepseek_client",
+    "DEEPSEEK_BASE_URL",
+    "DEEPSEEK_MODELS",
+    # ── Mistral ───────────────────────────────────────────────────────────────
+    "MistralProvider",
+    "ProtectedMistralClient",
+    "create_protected_mistral_client",
+    "MISTRAL_BASE_URL",
+    "MISTRAL_MODELS",
+    # ── Perplexity ────────────────────────────────────────────────────────────
+    "PerplexityProvider",
+    "ProtectedPerplexityClient",
+    "create_protected_perplexity_client",
+    "PERPLEXITY_BASE_URL",
+    "PERPLEXITY_MODELS",
+    # ── Exceptions (re-exported from local_openai_compat_provider) ────────────
     "ThreatBlockedException",
     "ThreatChallengeException",
     "ToolOutputBlockedException",

ethicore_guardian/providers/anthropic_provider.py

@@ -1,7 +1,15 @@
 """
 Ethicore Engine™ - Guardian SDK — Anthropic Provider
 Mirrors the OpenAI provider pattern for the Anthropic Messages API.
-Version: 1.0.0
+Version: 1.1.0
+
+Current Claude model IDs (May 2026):
+  claude-opus-4-7      — Most capable; 1M context, 128k output (current flagship)
+  claude-sonnet-4-6    — Speed + intelligence balance; 1M context
+  claude-haiku-4-5     — Fastest; 200k context
+
+Retiring June 15 2026 (migrate off these):
+  claude-sonnet-4-0 / claude-opus-4-0 (claude-*-4-20250514 snapshots)
 
 Copyright © 2026 Oracles Technologies LLC
 All Rights Reserved
@@ -415,7 +423,7 @@ def create_protected_anthropic_client(
             guardian_api_key="ethicore-...",
         )
         response = client.messages.create(
-            model="claude-opus-4-5",
+            model="claude-opus-4-7",
             max_tokens=1024,
             messages=[{"role": "user", "content": "Hello"}],
         )