sentinel-oversight 0.1.0

Python SDK for Sentinel human-in-the-loop oversight

Sentinel SDK

Oversight infrastructure for AI agents.

Sentinel adds human-in-the-loop approval to any Python function your agent calls. Wrap the function with @oversight, and the SDK pauses execution, requests approval, and only runs once a human approves.

Install

pip install sentinel-oversight

Quick start

from sentinel import configure, oversight

configure(api_key="sk_live_...")

@oversight(
    risk_level="high",
    approvers=["slack://channel/agent-approvals"],
    timeout_seconds=300,
)
def transfer_funds(amount: int, recipient: str):
    return stripe.transfers.create(amount=amount, destination=recipient)

When your agent calls transfer_funds(1000, "acct_xyz"), Sentinel pauses execution, posts an approval card to Slack, and only runs the function once a human clicks Approve. If rejected, ApprovalRejected is raised. If no response within timeout_seconds, ApprovalTimeout is raised (unless fallback="execute").

Configuration

Set via configure(...) or env vars:

• SENTINEL_API_URL (default https://api.oversight.sh)
• SENTINEL_API_KEY
• SENTINEL_TIMEOUT (default 300)
• SENTINEL_FALLBACK (default reject)

LangChain

from sentinel.adapters.langchain import SentinelCallbackHandler

agent.run("...", callbacks=[SentinelCallbackHandler(risk_level="high")])

Install with pip install sentinel-oversight[langchain].

Links

• Website: https://oversight.sh
• API repo: https://github.com/PetrefiedThunder/sentinel-api
• This SDK: https://github.com/PetrefiedThunder/sentinel-sdk

License

MIT