Metadata-Version: 2.4
Name: agentveil
Version: 0.7.13
Summary: Python SDK for agent action control: posture checks, action gates, signed receipts, and proof packets
Author-email: Oleg Boiko <ob@agentveil.dev>
Maintainer-email: Oleg Boiko <ob@agentveil.dev>
License-Expression: MIT
Project-URL: Homepage, https://agentveil.dev
Project-URL: Documentation, https://github.com/agentveil-protocol/avp-sdk#readme
Project-URL: Repository, https://github.com/agentveil-protocol/avp-sdk
Project-URL: Changelog, https://github.com/agentveil-protocol/avp-sdk/releases
Project-URL: Issues, https://github.com/agentveil-protocol/avp-sdk/issues
Keywords: ai,agents,agent-control,runtime-gate,controlled-actions,signed-receipts,did,identity,mcp,reputation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27.0
Requires-Dist: pynacl>=1.5.0
Requires-Dist: base58>=2.1.0
Requires-Dist: jcs>=0.2.1
Requires-Dist: mcp>=1.0.0
Provides-Extra: test
Requires-Dist: pytest>=8.0.0; extra == "test"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "test"
Provides-Extra: mcp
Requires-Dist: mcp>=1.0.0; extra == "mcp"
Dynamic: license-file

# AgentVeil

**Action control for autonomous agents — check posture, gate risky actions, prove execution.**

AgentVeil is the Python SDK for agent action control: posture checks, Runtime Gate decisions, signed receipts, W3C verifiable credentials, plus DID identity, reputation signals, and MCP integrations.

```bash
pip install agentveil
```

## Quick Start

Run locally with real cryptography and mocked HTTP. No server is required.

```python
from datetime import timedelta
from agentveil import AVPAgent

owner = AVPAgent.create(mock=True, name="workflow-owner")
agent = AVPAgent.create(mock=True, name="demo-agent")
agent.register(display_name="Demo Agent")

delegation = owner.issue_delegation_receipt(
    agent_did=agent.did,
    allowed_categories=["deploy"],
    valid_for=timedelta(minutes=15),
)
verification = agent.verify_delegation_receipt(delegation)

print("delegation valid:", verification["valid"])
print("scope:", verification["scope"][0]["value"])
```

For production setup, see the [Customer Integration guide](https://github.com/agentveil-protocol/avp-sdk/blob/main/docs/CUSTOMER_INTEGRATION.md).

## What AgentVeil Provides

- **Posture checks** before risky agent actions reach production.
- **Runtime Gate decisions** for allow, approval required, or block outcomes.
- **Signed receipts and proof packets** for audit and offline verification.
- **W3C VC v2.0 credentials** with `eddsa-jcs-2022` Data Integrity proofs.
- **DID identity** with portable `did:key` Ed25519 keys.
- **Framework integrations** for CrewAI, LangGraph, AutoGen, OpenAI, Claude MCP, Gemini, PydanticAI, Paperclip, and AWS Bedrock.

## Offline Verification

Fetch a W3C Verifiable Credential:

```bash
curl https://agentveil.dev/v1/reputation/{agent_did}/credential?format=w3c
```

Verify it with any VC library, or with the SDK:

```python
cred = agent.get_reputation_credential(format="w3c")
assert AVPAgent.verify_w3c_credential(cred)
```

## MCP Server

The base install includes the MCP runtime dependency:

```bash
pip install agentveil
agentveil-mcp
```

Local/full MCP mode exposes Runtime Gate evaluation, human approval routing,
approved execution, signed receipt retrieval, reputation checks, identity
lookup, and audit verification. Hosted read-only mode exposes public
inspection tools only.

The compatibility extra `agentveil[mcp]` still works for legacy setups. MCP setup details are in the [MCP README](https://github.com/agentveil-protocol/avp-sdk/blob/main/agentveil_mcp/README.md).

## Resources

- [Full GitHub README and demo](https://github.com/agentveil-protocol/avp-sdk#readme)
- [API reference](https://github.com/agentveil-protocol/avp-sdk/blob/main/docs/API.md)
- [Customer integration guide](https://github.com/agentveil-protocol/avp-sdk/blob/main/docs/CUSTOMER_INTEGRATION.md)
- [Framework integrations](https://github.com/agentveil-protocol/avp-sdk/blob/main/docs/INTEGRATIONS.md)
- [Security context](https://github.com/agentveil-protocol/avp-sdk/blob/main/docs/SECURITY_CONTEXT.md)
- [Examples](https://github.com/agentveil-protocol/avp-sdk/tree/main/examples)
- [AgentVeil API](https://agentveil.dev)
- [Live Network](https://agentveil.dev/live)

## License

MIT. See the [license](https://github.com/agentveil-protocol/avp-sdk/blob/main/LICENSE).
