Metadata-Version: 2.4
Name: agentveil
Version: 0.7.21
Summary: Python SDK for routed AI-agent action decisions, approvals, receipt records, and bounded evidence
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/agentveil-sdk#readme
Project-URL: Repository, https://github.com/agentveil-protocol/agentveil-sdk
Project-URL: Changelog, https://github.com/agentveil-protocol/agentveil-sdk/releases
Project-URL: Issues, https://github.com/agentveil-protocol/agentveil-sdk/issues
Keywords: ai,agents,agent-control,runtime-gate,routed-actions,signed-receipts,did,identity,mcp
Classifier: Development Status :: 3 - Alpha
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

**Routed action control for risky AI-agent actions.**

AgentVeil's public product path is action control for AI-agent workflows:
project connectors, MCP Proxy routing, approval / redirect / block decisions,
and bounded local evidence.

For the action-control path, install the MCP Proxy package:

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

## Quick Start

Route MCP tool calls through AgentVeil:

```bash
pip install agentveil-mcp-proxy
agentveil-mcp-proxy init --quickstart-filesystem ./sandbox
agentveil-mcp-proxy doctor --full
agentveil-mcp-proxy run
```

MCP Proxy gates only tool calls routed through the proxy. It does not control
host shell, IDE-native edits, direct git/pip commands, or other actions that
bypass the proxy. Actions not routed through AgentVeil are not classified or
logged.

## Python SDK and advanced protocol primitives

Advanced Python SDK package: `agentveil`.

The root Python SDK remains available for advanced protocol primitives: local
DID identity, delegation receipts, receipt helpers, credential checks, advisory
reputation, and optional framework adapter modules when their framework
dependencies are installed.

Run a local SDK-only identity and delegation check with no server 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"])
```

## What AgentVeil Provides

- routed action decisions for allow, approval-required, or block outcomes;
- approval routing for sensitive routed requests;
- bounded evidence for local review and offline checks;
- local privacy defaults for MCP Proxy;
- protocol primitives for DID identity, delegation receipts, receipt
  helpers, credential checks, and optional framework adapter modules when their framework dependencies are installed.

## Resources

- [Full GitHub README](https://github.com/agentveil-protocol/agentveil-sdk#readme)
- [MCP Proxy README](https://github.com/agentveil-protocol/agentveil-sdk/blob/main/packages/agentveil-mcp-proxy/README.md)
- [Security Model](https://github.com/agentveil-protocol/agentveil-sdk/blob/main/docs/SECURITY_MODEL.md)
- [Data Handling](https://github.com/agentveil-protocol/agentveil-sdk/blob/main/docs/DATA_HANDLING.md)
- [Customer Integration guide](https://github.com/agentveil-protocol/agentveil-sdk/blob/main/docs/CUSTOMER_INTEGRATION.md)
- [AgentVeil website](https://agentveil.dev)

## License

The `agentveil` package is MIT licensed. The separate `agentveil-mcp-proxy`
package is source-available under Business Source License 1.1. See the
[licensing boundary](https://github.com/agentveil-protocol/agentveil-sdk/blob/main/LICENSING.md).
