Metadata-Version: 2.1
Name: correctover
Version: 2.3.1
Summary: Correctover — LLM Reliability Engineering platform. Protocol-level contract validation, verified failover (DeepSeek/OpenAI/Anthropic), MCP security, CCS v1.0 standard, 84.1% self-heal rate across 20K+ trajectories.
Home-page: https://correctover.com
Author: Correctover Team
Author-email: Correctover Team <team@correctover.com>
Maintainer-email: Correctover Team <team@correctover.com>
License: Proprietary Commercial License — see LICENSE
Project-URL: Homepage, https://correctover.com
Project-URL: Documentation, https://correctover.com/docs
Project-URL: Changelog, https://correctover.com/docs/changelog
Project-URL: Bug Tracker, https://correctover.com/support
Keywords: llm,self-healing,failover,circuit-breaker,api-resilience,openai,anthropic,deepseek,contract-validation,correctover,ai-gateway,semantic-verification,mcp,security,ccs,runtime-guard,agent-reliability,llmre
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.24.0
Requires-Dist: aiohttp>=3.8.0

# Correctover SDK

**Failure is not fatal.** Protocol-level contract validation with automatic verified failover for LLM APIs — now with MCP security, CCS v1.0 standard, and runtime guardrails.

[![PyPI version](https://img.shields.io/pypi/v/correctover.svg)](https://pypi.org/project/correctover/)
[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
[![License: Proprietary](https://img.shields.io/badge/license-Proprietary-red.svg)](LICENSE)

## Install

```bash
pip install correctover
```

## Quick Start

```python
import correctover

# Automatic failover with verified contract validation
result = correctover.run("Hello!")
print(result)
```

## What It Does

Correctover is the **LLM Reliability Engineering (LLMRE)** platform for AI agents:

| Capability | Description |
|------------|-------------|
| **Contract Validation** | Protocol-level output verification — schema, semantic, safety |
| **Verified Failover** | Automatic retry to DeepSeek/OpenAI/Anthropic on failure |
| **Self-Healing** | 84.1% success rate across 20K+ decision trajectories |
| **MCP Security** | 14 OWASP AISVS 1.0 checks for Model Context Protocol configs |
| **Runtime Guard** | 22µs P50 RCE/SSRF/credential leak interception |
| **CCS v1.0 Standard** | First formal conformance standard for agentic runtimes (DOI: 10.5281/zenodo.21234580) |

## CLI Tools

```bash
correctover-shield    # Runtime guard daemon
correctover-ccs       # CCS v1.0 conformance scanner
correctover-mcs       # MCP security scanner
correctover-hunt      # Vulnerability hunter
```

## Key Metrics

| Metric | Value |
|--------|-------|
| Self-heal success rate | 84.1% |
| Failover latency | 0.4–0.7ms |
| Runtime guard P50 | 22µs |
| Test trajectories | 20,071 |
| CVEs filed | 6 (AutoGen ×2, CrewAI, Semantic Kernel, MS AGT) |
| Fault types | 215 |

## Supported Providers

- **DeepSeek** (primary failover target)
- **OpenAI** (GPT-4o, GPT-4-turbo)
- **Anthropic** (Claude 3.5 Sonnet)

## Free Tier

50 calls/day — no credit card required.

Unlock unlimited: [correctover.com/checkout](https://correctover.com/checkout)

```bash
export CORRECTOVER_LICENSE_KEY=your-key-here
```

## Related Correctover Tools

| Tool | Install | Description |
|------|---------|-------------|
| **Security Scanner** | `npx correctover-scan` | MCP config security audit (14 checks) |
| **Self-Healing Test** | `pip install correctover-test` | Agent self-healing test suite |
| **Vulnerability Scan** | `pip install correctover-security-audit` | 215 fault type scanner |
| **Compliance Check** | `pip install correctover-compliance-check` | OAuth 2.1 + CCS v1.0 |
| **Runtime Guard** | `pip install correctover-runtime-guard` | 22µs RCE/SSRF interception |
| **MCP Server** | `npm install correctover-mcp-server` | 6-dimension validation |

## Links

- **Website**: [correctover.com](https://correctover.com)
- **GitHub**: [github.com/Correctover](https://github.com/Correctover)
- **CCS Standard**: [DOI: 10.5281/zenodo.21234580](https://doi.org/10.5281/zenodo.21234580)
- **Checkout**: [correctover.com/checkout](https://correctover.com/checkout)

## License

Proprietary Commercial License. See LICENSE file.
