decionis 0.1.0

Official Decionis Python SDK for execution interception.

Decionis Python SDK

Decionis SDKs are execution interceptors. They do not encode policy logic inside the client application. They capture execution intent, submit it to Decionis, and continue, block, or escalate based on the signed decision.

pip install decionis

Decorator

from decionis import DecionisClient, decionis_gate

client = DecionisClient(
    api_key="DECIONIS_API_KEY",
    tenant_id="trading_client_001",
)


@decionis_gate(
    client=client,
    action="OPEN_POSITION",
    policy="cfd-risk-policy",
    actor={"id": "cfd_bot_7", "type": "TRADING_BOT"},
)
def open_position(order):
    return broker.open_position(order)

The trading client does not own policy criteria, approvals, escalation rules, or compliance decisions. Those stay versioned in Decionis.

Client Gate

@client.gate(
    action="TRANSFER_FUNDS",
    policy="treasury-transfer-policy-v3",
    actor={"id": "treasury-agent", "type": "AI_AGENT"},
)
def transfer_funds(request):
    return payment_service.transfer(request)

Low-Level Enforcement

Use enforce when you need to package execution intent manually:

decision = client.enforce(
    tenant_id="bank_001",
    actor={"id": "agent_42", "type": "AI_AGENT"},
    action={"type": "TRANSFER_FUNDS", "resource": "liquidity_pool"},
    context={"workflow": "treasury_ops"},
    policy_refs=["treasury-transfer-policy-v3"],
)

enforce returns only for ALLOW. BLOCK, ESCALATE, and REVIEW_REQUIRED raise DecionisBlockedException with the decision ID, reason codes, explanation, dossier URL, and original response.

Configuration

client = DecionisClient(
    api_key="DECIONIS_API_KEY",
    base_url="https://api.decionis.ai",
    timeout=10.0,
    max_retries=2,
    retry_backoff=0.25,
    tenant_id="bank_001",
)

FastAPI

from fastapi import FastAPI
from decionis import DecionisClient
from decionis.middleware.fastapi import FastAPIDecionisMiddleware

app = FastAPI()
client = DecionisClient(api_key="DECIONIS_API_KEY", tenant_id="bank_001")

app.add_middleware(
    FastAPIDecionisMiddleware,
    client=client,
    build_request=lambda scope: {
        "actor": {"id": "api", "type": "SERVICE"},
        "action": {"type": "HTTP_REQUEST"},
        "context": {"path": scope["path"]},
        "policy_refs": ["api-execution-policy-v1"],
    },
)

Release

The package is ready for PyPI Trusted Publishing from GitHub Actions. Releases are triggered from GitHub Releases and start at 0.1.0.