Skip to main content

Python SDK for agent action control: posture checks, action gates, signed receipts, and proof packets

Project description

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.

pip install agentveil

Quick Start

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

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.

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:

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

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

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

MCP Server

The base install includes the MCP runtime dependency:

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.

Resources

License

MIT. See the license.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentveil-0.7.14.tar.gz (202.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentveil-0.7.14-py3-none-any.whl (141.8 kB view details)

Uploaded Python 3

File details

Details for the file agentveil-0.7.14.tar.gz.

File metadata

  • Download URL: agentveil-0.7.14.tar.gz
  • Upload date:
  • Size: 202.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for agentveil-0.7.14.tar.gz
Algorithm Hash digest
SHA256 be2c67c35570c8b23041d08e962fc48698aac3b4c811d7f34ac4eb5a5bc30303
MD5 9089fe13993841ba0ba3159b4d198b8b
BLAKE2b-256 907523f440eb169a28c67b29ed33b9743a5f8649f5df9f23e05a7b93f0555bf9

See more details on using hashes here.

File details

Details for the file agentveil-0.7.14-py3-none-any.whl.

File metadata

  • Download URL: agentveil-0.7.14-py3-none-any.whl
  • Upload date:
  • Size: 141.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for agentveil-0.7.14-py3-none-any.whl
Algorithm Hash digest
SHA256 a829b25df04438a6e6dae6ddfae2c209f5d8cdc6cd0ec31366b7d89fba406475
MD5 987f28496a2e07d2908b60534c8dfa97
BLAKE2b-256 94f81cfd22bd9f5a21f45ab1dd977f7e7819406f1bb0a0b8a5152f3555bf7eb7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page