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.13.tar.gz (98.0 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.13-py3-none-any.whl (76.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: agentveil-0.7.13.tar.gz
  • Upload date:
  • Size: 98.0 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.13.tar.gz
Algorithm Hash digest
SHA256 ca53fc8e922dc06827bd7436f3b01e1b7e24b5f7228ea05d39f6301ea3dd1c14
MD5 453f59fa4ce0255cf1a0cb4f134eab28
BLAKE2b-256 f5a8e1e3b1cc47961b37d985569602ea9888056c7676b767ab3373076011fc51

See more details on using hashes here.

File details

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

File metadata

  • Download URL: agentveil-0.7.13-py3-none-any.whl
  • Upload date:
  • Size: 76.1 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.13-py3-none-any.whl
Algorithm Hash digest
SHA256 9ca61b32800c96097f78ecaa73a663e9dff22f506b4b81d51121c879f19eabe7
MD5 119b1318716f067c052463bad17f29ac
BLAKE2b-256 8a7d9d7bac336718028de72387408232ac09c559e1ecd83fd25815cbbe8cf95b

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