sovigl 0.1.7

SOVIGL returns approved, pending, or blocked for any action.

sovigl

Sovigl evaluates approval decisions for actions like payments and returns one of three states: approved, pending, or blocked.

Install

pip install sovigl

Access

Demo: works instantly, no key needed. pip install sovigl and call evaluate().

Production: email [e-mail] to get org_id and api_key.

Python Usage

import sovigl

for amount in [500, 5000, 100000]:
    decision = sovigl.evaluate(
        action="payment.create",
        context={"amount": amount}
    )

    print(f"amount={amount} status={decision.status} reason={decision.reason}")

    if decision.approved:
        print("Execute payment")
    elif decision.pending:
        print("Human approval required")
    elif decision.blocked:
        print("Do not execute payment")

Full Response Object (Python)

evaluate() returns a Decision object with these fields/properties:

• decision.status - approved / pending / blocked
• decision.decision_id - permanent audit ID
• decision.reason - why this decision was made
• decision.explanation_registry - full explainability record
• decision.risk_assessment - risk score 0.0-1.0 + factors
• decision.policy_version - which policy version was active
• decision.approval_id - human approval reference
• decision.summary - plain English summary
• decision.approved - True/False helper
• decision.pending - True/False helper
• decision.blocked - True/False helper
• decision.raw - complete backend response

Example:

decision = sovigl.evaluate(
    action="payment.create",
    context={"amount": 5000}
)

print(decision.status)
print(decision.decision_id)
print(decision.reason)
print(decision.explanation_registry)
print(decision.risk_assessment)
print(decision.policy_version)
print(decision.approval_id)
print(decision.summary)
print(decision.approved)
print(decision.pending)
print(decision.blocked)
print(decision.raw)

Pending Workflow

When decision.status == "pending", treat it as a hard stop for automatic execution and route to manual approval.

decision = sovigl.evaluate(
    action="payment.create",
    context={"amount": 5000}
)

if decision.pending:
    approval_id = getattr(decision, "approval_id", None)
    print("Human approval required", approval_id, decision.reason)

Context Fields

Field	Type	Description
amount	number	Transaction amount evaluated against policy
user_id	string	Who is performing the action
role	string	Caller role - employee, manager, or admin
agent_id	string	AI agent identifier if action is automated

Action Types

Sovigl accepts any action string in . format.

• payment.create
• expense.submit
• transfer.initiate
• loan.approve

Node.js Usage

const sovigl = require("./node/index.js");

(async () => {
  for (const amount of [500, 5000, 100000]) {
    const decision = await sovigl.evaluate({
      action: "payment.create",
      context: { amount }
    });

    console.log({ amount, status: decision.status, reason: decision.reason });
  }
})();

Backend: https://github.com/riteshkumar10000/sovigl-sdk | PyPI: https://pypi.org/project/sovigl/