@acarmisc/backstage-plugin-litellm-backend 0.12.0 → 0.14.0

package/dist/types.d.ts

@@ -34,6 +34,16 @@ export interface TeamInfo {
     /** Spend-reset period for max_budget, e.g. "30d". */
     budget_duration?: string;
     spend: number;
+    /**
+     * Share of max_budget consumed (0-100), present only on redacted records.
+     * Set by the backend when litellm.display.hideTeamBudgetFor* is enabled so
+     * clients can render the consumption level without dollar amounts.
+     */
+    budget_pct?: number;
+    /** ok | near (>=80%) | over (>=100%), present only on redacted records. */
+    budget_status?: 'ok' | 'near' | 'over';
+    /** True when max_budget/spend were stripped by budget hiding. */
+    budget_hidden?: boolean;
     members_with_roles?: TeamMember[];
     models?: string[];
     tpm_limit?: number;
@@ -273,6 +283,42 @@ export interface PaginatedAuditLogs {
     page_size: number;
     total_pages: number;
 }
+/** One row from LiteLLM's `/spend/logs` (per-request spend log entry). */
+export interface SpendLogEntry {
+    request_id?: string;
+    /** ISO timestamp of the call. */
+    startTime?: string;
+    endTime?: string;
+    spend?: number;
+    total_tokens?: number;
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    model?: string;
+    /** Virtual key alias or hash the request was billed to. */
+    api_key?: string;
+    user?: string;
+    team_id?: string;
+    /**
+     * Tags attached to the request (e.g. `channel:backstage`,
+     * `session:<thread>`, `invoked-by:<user>`). Shape varies across LiteLLM
+     * versions (array or object) and is normalised to a string[].
+     */
+    request_tags?: string[] | Record<string, string>;
+    /** LiteLLM `metadata` blob; carries trace ids and session grouping. */
+    metadata?: Record<string, unknown> | string | null;
+}
+export interface SpendLogsParams {
+    /** ISO date `YYYY-MM-DD` (inclusive). */
+    start_date: string;
+    /** ISO date `YYYY-MM-DD` (inclusive). */
+    end_date: string;
+    /** Restrict to the given virtual key. */
+    api_key?: string;
+    user_id?: string;
+    team_id?: string;
+    /** Max rows to return (LiteLLM caps at 1000 per page). */
+    page_size?: number;
+}
 export interface AuditLogsParams {
     page?: number;
     page_size?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acarmisc/backstage-plugin-litellm-backend",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "The Backstage backend plugin for LiteLLM governance",
   "backstage": {
     "role": "backend-plugin",