Metadata-Version: 2.4
Name: verilink-aiverify-plugin
Version: 1.1.0
Summary: VeriLinkOS Active Governance Integration for AI Verify
License: Apache-2.0
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx<0.29.0,>=0.28.1
Requires-Dist: pydantic<3.0.0,>=2.0.0
Requires-Dist: python-dotenv<2.1.0,>=0.19.0
Requires-Dist: tenacity<9.1.0,>=8.0.0
Requires-Dist: cryptography<50.0.0,>=49.0.0
Provides-Extra: dev
Requires-Dist: pytest<8.0.0,>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio<0.22.0,>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov<5.0.0,>=4.0.0; extra == "dev"
Requires-Dist: mypy<2.0.0,>=1.0.0; extra == "dev"
Requires-Dist: ruff<0.2.0,>=0.1.0; extra == "dev"
Dynamic: license-file
Dynamic: requires-python

# VeriLinkOS AI Verify Plugin

[![PyPI version](https://badge.fury.io/py/verilink-aiverify-plugin.svg)](https://badge.fury.io/py/verilink-aiverify-plugin)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![Python Version](https://img.shields.io/pypi/pyversions/verilink-aiverify-plugin.svg)](https://pypi.org/project/verilink-aiverify-plugin)
[![Downloads](https://img.shields.io/pypi/dm/verilink-aiverify-plugin.svg)](https://pypi.org/project/verilink-aiverify-plugin)

## 📖 Overview

VeriLinkOS AI Verify Plugin integrates **active governance capabilities** from [VeriLinkOS](https://verilink.io) into the [AI Verify](https://github.com/aiverify-foundation/aiverify) testing framework. It provides real-time enforcement, cryptographic evidence, and compliance guardrails for AI testing.

### 🎯 Why Use This Plugin?

- **🛡️ Active Governance**: Prevent unauthorized AI actions **before** they occur
- **🔐 Cryptographic Receipts**: Tamper-evident VAP receipts with Merkle-tree batching
- **✅ AI-BOM Verification**: Ensure model integrity and provenance
- **🔑 Trust Tokens**: JIT authentication for each test session
- **🧠 Predictive Enforcement**: ML-based risk prediction to preemptively block risky tests
- **⚖️ Constitutional AI**: Ethical and legal guardrails via MetaRuleSet
- **👥 Multi-Agent Arbitration**: Conflict resolution for resource contention

---

## 🚀 Installation

### From PyPI (Recommended)
```bash
pip install verilink-aiverify-plugin
```

## Configuration
Set environment variables:

```bash
export VERILINK_API_URL=https://api.verilink.os
export VERILINK_API_KEY=your_api_key
export VERILINK_AGENT_ID=your_agent_id
export VERILINK_ORG_ID=your_org_id
```

## Quick Start
```python
import asyncio
from verilink_plugin import VeriLinkGovernancePlugin

async def test_model():
    plugin = VeriLinkGovernancePlugin()
    
    result = await plugin.run_test(
        {"model_id": "model-001", "dataset": "test-data"},
        lambda config: {"passed": True, "artifacts": {}}
    )
    
    print(f"Passed: {result.passed}")
    print(f"Receipt: {result.receipt_id}")
    
    await plugin.cleanup()

asyncio.run(test_model())
```

## License
Apache 2.0
