Product credits

systems = nozle.credit_systems.list()

for system in systems:
    print(system["code"], system["unit_name"], system["status"])

balance = nozle.credits.get_balance("workspace_123", "ai_credits")

print(balance["available"])
print(balance["sources"])

all_balances = nozle.credits.list_balances("workspace_123")

page = nozle.credits.list_operations(
    "workspace_123",
    credit_system_code="ai_credits",
    limit=25,
)

next_page = (
    nozle.credits.list_operations(
        "workspace_123",
        credit_system_code="ai_credits",
        limit=25,
        cursor=page["next_cursor"],
    )
    if page["next_cursor"]
    else None
)

balance = nozle.credits.get_entity_balance(
    "workspace_123",
    "user_42",
    "ai_credits",
)

print(balance["entity_available"])
print(balance["shared_available"])
print(balance["effective_available"])
print(balance["pool_policy"])

all_balances = nozle.credits.list_entity_balances(
    "workspace_123",
    "user_42",
)

history = nozle.credits.list_entity_operations(
    "workspace_123",
    "user_42",
    credit_system_code="ai_credits",
    limit=25,
)

allocation = nozle.credits.allocate(
    "workspace_123",
    "user_42",
    credit_system_code="ai_credits",
    amount="100.000000000001",
    idempotency_key="allocate-user-42-100-v1",
)

print(allocation["transferred"])
print(allocation["parent_sources"])
print(allocation["entity_sources"])
print(allocation["replayed"])

deallocation = nozle.credits.deallocate(
    "workspace_123",
    "user_42",
    credit_system_code="ai_credits",
    amount="25",
    idempotency_key="deallocate-user-42-25-v1",
)

check = nozle.usage.check(
    "workspace_123",
    "agent_execution",
    entity_id="user_42",
    credit_system_code="ai_credits",
    properties={"model": "example-model"},
)

print(check["advisory"])
print(check["credits_required"])
print(check.get("projected_remaining"))
print(check.get("projected_deductions"))

result = nozle.usage.track(
    "workspace_123",
    "agent_execution",
    entity_id="user_42",
    credit_system_code="ai_credits",
    properties={"model": "example-model"},
    idempotency_key="agent-execution-0183f",
)

if not result["allowed"]:
    print(result.get("reason"), result.get("available"))