PydanticAI Integration

CapFence wraps PydanticAI tools or callables with a deterministic gate check before execution.

Installation

shellscript

pip install capfence

Wrapping a tool

python

from capfence.framework.pydanticai import CapFencePydanticTool

async def fetch_account(account_id: str) -> dict:
    return {"account_id": account_id, "status": "active"}

safe_fetch = CapFencePydanticTool(
    tool=fetch_account,
    agent_id="pydantic-agent",
    capability="account.read",
    policy_path="policies/fintech.yaml",
)

Async usage

python

result = await safe_fetch.acall("acct_123")

Handling blocked calls

Blocked calls raise AgentActionBlocked.