@acarmisc/backstage-plugin-litellm-backend 0.19.0 → 0.21.0

package/config.d.ts

@@ -171,6 +171,16 @@ export interface Config {
        */
       allowedDurations?: string[];
 
+      /**
+       * Allowed `budget_duration` values for new keys (how often a key's
+       * spend resets, e.g. "30d" or "1mo"). Requests with a value not in this
+       * list are rejected with a 400 error. An empty array allows any value
+       * matching /^\d+(s|m|h|d|mo)$/. Omitting the field keeps today's
+       * behaviour: the key's budget never resets.
+       * @default ["1d", "7d", "30d", "1mo"]
+       */
+      allowedBudgetDurations?: string[];
+
       /**
        * When true, key owners can reset their key's spend counter via the
        * "Reset Spend" button in the frontend, subject to the
@@ -206,6 +216,12 @@ export interface Config {
        */
       maxBudget?: number;
 
+      /**
+       * Reset period of maxBudget in LiteLLM format (e.g. "30d"). Unset, maxBudget
+       * covers the whole life of the key.
+       */
+      budgetDuration?: string;
+
       /**
        * When true a team must be supplied and the user must belong to it.
        * @default false
@@ -397,6 +413,37 @@ export interface Config {
       hideTeamBudgetForManagers?: boolean;
     };
 
+    /**
+     * Team usage views beyond the team totals shown to every member.
+     */
+    teamUsage?: {
+      /**
+       * Per-member usage breakdown (GET /teams/:teamId/usage/members and the
+       * "Usage by member" table on the Teams tab). Per-person spend is
+       * sensitive, so the breakdown is off by default and, when on, only
+       * reaches:
+       *   - managers of the team (members of its metadata.owning_group, with
+       *     team management enabled);
+       *   - members of the team holding one of `viewerRoles` in it;
+       *   - members of the team granted `litellm.team.usage.read` (only
+       *     consulted when permission.enabled is true).
+       */
+      memberBreakdown?: {
+        /**
+         * When false, the route returns 404 and the UI hides the table.
+         * @default false
+         */
+        enabled?: boolean;
+
+        /**
+         * LiteLLM team roles (e.g. ["admin"]) whose holders may view their
+         * own team's breakdown.
+         * @default []
+         */
+        viewerRoles?: string[];
+      };
+    };
+
     bridge?: {
       /**
        * When true, mount the /bridge/keys, /bridge/keys (POST), /bridge/models

package/dist/client.d.ts

@@ -60,6 +60,11 @@ export declare class LiteLLMClient {
      * `expires` instead of `expires_at`).
      */
     listKeys(userId?: string): Promise<VirtualKey[]>;
+    /**
+     * Lists every key bound to a team (any owner), following `/key/list`
+     * pagination. Stops after 50 pages of 100 keys.
+     */
+    listTeamKeys(teamId: string): Promise<VirtualKey[]>;
     private toVirtualKey;
     /**
      * Creates a new virtual key on the LiteLLM proxy.

package/dist/client.js

@@ -198,6 +198,27 @@ class LiteLLMClient {
             throw err;
         }
     }
+    /**
+     * Lists every key bound to a team (any owner), following `/key/list`
+     * pagination. Stops after 50 pages of 100 keys.
+     */
+    async listTeamKeys(teamId) {
+        const keys = [];
+        for (let page = 1; page <= 50; page++) {
+            const params = new URLSearchParams({
+                team_id: teamId,
+                return_full_object: 'true',
+                page: String(page),
+                size: '100',
+            });
+            const response = await this.request(`/key/list?${params.toString()}`);
+            const rawKeys = (response.keys ?? []).filter((k) => typeof k === 'object' && k !== null);
+            keys.push(...rawKeys.map(this.toVirtualKey));
+            if (rawKeys.length === 0 || page >= (response.total_pages ?? 1))
+                break;
+        }
+        return keys;
+    }
     toVirtualKey(k) {
         return {
             key: k.key_name ?? k.token,