Govern Your Own Tool

from faramesh.sdk.client import ExecutionGovernorClient

client = ExecutionGovernorClient()  # Uses FARAMESH_URL and FARAMESH_API_KEY

def refund_customer(amount: float, customer_id: str) -> dict:
    # 1. Submit to Faramesh
    action = client.submit_action(
        tool="refund",
        operation="process",
        params={"amount": amount, "customer_id": customer_id},
        context={"agent_id": "billing-bot"}
    )

    # 2. Check status
    if action["status"] == "denied":
        raise PermissionError(f"Refund denied: {action.get('reason')}")

    if action["status"] == "pending_approval":
        print(f"Refund needs approval. Action ID: {action['id']}")
        print("Open the dashboard to approve or deny.")
        # Option: poll until approved, or exit and let user approve
        import time
        for _ in range(150):  # 5 minutes
            time.sleep(2)
            updated = client.get_action(action["id"])
            if updated["status"] in ("approved", "allowed"):
                break
            if updated["status"] == "denied":
                raise PermissionError("Refund was denied")
        else:
            raise TimeoutError("Approval timeout")

    # 3. Execute only if allowed
    if action["status"] not in ("allowed", "approved"):
        raise PermissionError(f"Refund not approved. Status: {action['status']}")

    # 4. Do the actual refund
    try:
        result = your_refund_logic(amount, customer_id)
        client.report_result(action["id"], success=True, result=result)
        return result
    except Exception as e:
        client.report_result(action["id"], success=False, error=str(e))
        raise

def delete_user(user_id: str) -> bool:
    action = client.submit_action(
        tool="user_management",
        operation="delete",
        params={"user_id": user_id},
        context={"agent_id": "admin-bot"}
    )

    if action["status"] == "denied":
        raise PermissionError(f"Delete denied: {action.get('reason')}")

    if action["status"] == "pending_approval":
        print(f"Delete needs approval: {action['id']}")
        # Same polling logic as above...

    # Execute deletion
    try:
        your_delete_logic(user_id)
        client.report_result(action["id"], success=True)
        return True
    except Exception as e:
        client.report_result(action["id"], success=False, error=str(e))
        raise