Policies & budgets

from agent_sentinel import PolicyEngine

PolicyEngine.configure(
    session_budget=5.0,
    run_budget=1.0,
    action_budgets={"call_llm": 0.50},
    denied_actions=["send_money", "delete_database"],
    allowed_actions=None,
    rate_limits={
        "search_web": {"max_count": 20, "window_seconds": 60},
    },
    strict_mode=True,
)

budgets:
  session: 5.0
  run: 1.0
  actions:
    call_llm: 0.50

denied_actions:
  - send_money
  - delete_database

rate_limits:
  search_web:
    max_count: 20
    window_seconds: 60

strict_mode: true

from agent_sentinel import PolicyEngine

PolicyEngine.load_from_yaml()

from agent_sentinel import BudgetExceededError, PolicyViolationError

try:
    # call some guarded action
    ...
except BudgetExceededError:
    # degrade gracefully (switch models, stop the run, etc.)
    ...
except PolicyViolationError:
    # treat as security / safety block
    ...

from agent_sentinel import CostTracker

print(CostTracker.get_session_total())
print(CostTracker.get_run_total())

# Reset between agent runs
CostTracker.reset_run()

from agent_sentinel import guarded_action

@guarded_action(name="search_web", cost_usd=0.02, impact="read")
def search_web(query: str) -> dict: ...

@guarded_action(name="issue_refund", cost_usd=0.0, impact="high")
def issue_refund(order_id: str, amount: float) -> dict: ...

import agent_sentinel
from agent_sentinel import PolicyEngine, guarded_action

# Process-wide, via the environment
#   AGENT_SENTINEL_ENFORCEMENT=fail_closed | fail_closed_writes | fail_open

# Process-wide, in code
PolicyEngine.set_enforcement_mode("fail_closed")

# On the one-call configure()
agent_sentinel.configure(api_key="as_...", fail_closed=True)

# Per action
@guarded_action(name="transfer_funds", impact="high", fail_closed=True)
def transfer_funds(...): ...

from agent_sentinel import PolicyEngine

PolicyEngine.enable_remote_sync(
    api_token="as_your_api_key_here",
    agent_id="my-agent",
    run_id="my-run",
    refresh_interval=300,
)