Authorise an action

decision = rs.authorize(
    "grt_01KZXYD62VG0",
    {"tool": ["payments.settle"]},
    amount_minor=250_00,
    currency="EUR",
    trajectory_id=t.id,
)

decision = rs.authorize(..., raise_on_refusal=False)
if decision.allowed:
    settle(...)

from rotascale import Blocked, Exhausted, Gated, ReviewRequired, EnforcementUnavailable

try:
    rs.authorize("grt_01KZXYD62VG0", {"tool": ["payments.settle"]},
                 amount_minor=250_00, currency="EUR")
    settle(...)

except Exhausted:
    # Permitted, but the allowance is spent. Retrying cannot help, and the
    # agent is told so rather than being left to loop.
    escalate("ceiling reached")

except Gated:
    # Untrusted content entered this trajectory and this action requires a
    # clean one. See /concepts/clean-context.
    escalate("context not clean")

except ReviewRequired as exc:
    # A person has to decide. Park on exc.review_id and come back.
    park(exc.review_id)

except Blocked:
    # Policy refused it. This is the one that is a policy conversation.
    stop()

except EnforcementUnavailable:
    # Rotascale could not be reached. Enforcement fails CLOSED by default.
    stop()

Decision(
    outcome="allow",
    allowed=True,
    reason="within grant",
    grant_id="grt_01KZXYD62VG0",
    ledger_id="led_01KZZWKNEPCJ",
    remaining_amount_minor=2475000,
    remaining_count=39,
    policy_outcome="allow",
    enforcement_mode="enforce",
)