[FEATURE REQUEST] add /usage endpoint to know the usage of our account

[uratmangun]

so i recently vibing the /usage locally i dont wanna ruin your repo so i didnt create any pull request but this is how i do it, i think this could be useful for people to know their account usage:

async def _fetch_v2_usage(auth_manager: KiroAuthManager) -> Dict[str, Any]:
    """
    Fetch usage limits from AWS CodeWhisperer GetUsageLimits API for v2 account.
    
    Uses the Q API endpoint (same as amazon-q-developer-cli).
    """
    try:
        token = await auth_manager.get_access_token()
        
        headers = {
            "Authorization": f"Bearer {token}",
            "Content-Type": "application/x-amz-json-1.0",
            "x-amz-target": "AmazonCodeWhispererService.GetUsageLimits",
        }
        
        # Use the Q API host (with region fallback built-in)
        url = f"{auth_manager.q_host}/"
        
        body = {}
        if auth_manager.profile_arn:
            body["profileArn"] = auth_manager.profile_arn
        
        async with httpx.AsyncClient(timeout=30) as client:
            response = await client.post(url, headers=headers, json=body)
            
            if response.status_code == 200:
                data = response.json()
                
                if "Output" in data and "__type" in data.get("Output", {}):
                    return {
                        "status": "unavailable",
                        "error_message": "Usage API not available for this account type",
                    }
                
                # Parse usageBreakdownList
                breakdown_list = data.get("usageBreakdownList", [])
                breakdown = breakdown_list[0] if breakdown_list else {}
                free_trial = breakdown.get("freeTrialInfo", {})
                
                # Convert timestamps
                next_reset = data.get("nextDateReset")
                free_trial_expiry = free_trial.get("freeTrialExpiry")
                
                return {
                    "status": "success",
                    "profile_arn": auth_manager.profile_arn,
                    "region": auth_manager.region,
                    "next_reset_timestamp": next_reset,
                    "subscription_info": data.get("subscriptionInfo", {}),
                    "usage": {
                        "current": breakdown.get("currentUsageWithPrecision") or breakdown.get("currentUsage", 0),
                        "limit": breakdown.get("usageLimitWithPrecision") or breakdown.get("usageLimit", 0),
                        "display_name": breakdown.get("displayName", "Credit"),
                    },
                    "bonus": {
                        "status": free_trial.get("freeTrialStatus"),
                        "current": free_trial.get("currentUsageWithPrecision") or free_trial.get("currentUsage", 0),
                        "limit": free_trial.get("usageLimitWithPrecision") or free_trial.get("usageLimit", 0),
                        "expiry_timestamp": free_trial_expiry,
                    } if free_trial else None,
                }
            else:
                return {
                    "status": "error",
                    "error_message": response.text[:500] if response.text else f"HTTP {response.status_code}",
                }
    
    except Exception as e:
        return {
            "status": "error",
            "error_message": str(e),
        }

it will look like this:

{
"status": "success",
      "profile_arn": null,
      "region": "us-east-1",
      "next_reset_timestamp": 1769904000,
      "subscription_info": {
        "overageCapability": "OVERAGE_INCAPABLE",
        "subscriptionManagementTarget": "PURCHASE",
        "subscriptionTitle": "KIRO FREE",
        "type": "Q_DEVELOPER_STANDALONE_FREE",
        "upgradeCapability": "UPGRADE_CAPABLE"
      },
      "usage": {
        "current": 50,
        "limit": 50,
        "display_name": "Credit"
      },
      "bonus": {
        "status": "EXPIRED",
        "current": 147.82,
        "limit": 500,
        "expiry_timestamp": 1767083820.361
      }
}

lets say you want to put this into UI it will look like this:

im testing this with sqlite auth only so i think you need to debug yourself in order for it to work with desktop ide credential and as the comment stated i got this endpoint for usage from https://github.com/aws/amazon-q-developer-cli so i think you can refer to that as well if there is any error

[jwadow]

Hi, good to see you, I've never used this functionality, only /models and /v1/messages and the like.

I'd like to know if /usage is used extensively in any software? Or is it for manual requests?

Perhaps, in addition to /usage, we should display the credit count after each request?

I don't use this feature myself, so I don't know what it should look like. I don't want to overload Kiro Gateway with unnecessary functionality and overload the user console with unnecessary INFO logs. Therefore, I need to determine whether this is worthwhile at all, since each authentication method may have its own way of making a request, and this would require some work.

[uratmangun]

yeah this is used to see how much credit you have left, if you have kiro-cli try to login then type /usage its the same thing as what i describe to you, let me know what you think if its not necessary and you want to see credit usage manually then its fine you can close this discussion its just and idea not a bug so its not urgent

[jwadow]

The issue is that /usage isn't a standardized endpoint in the industry (OpenAI and Anthropic don't have it). This means clients like Cursor, Claude Code, and others won't use it automatically - it would only work for manual curl requests.

Because of that, it's low priority for now. I might look into adding it later, but not right now. I'll think about how to implement this elegantly in my spare time.