@acarmisc/backstage-plugin-litellm-common 0.2.0 → 0.4.0

package/dist/types.d.ts

@@ -250,3 +250,88 @@ export interface CreateTeamResponse {
     team_id: string;
     team_alias?: string;
 }
+export interface InsightSummary {
+    costPer1kTokens: number | null;
+    costPerRequest: number | null;
+    outputInputRatio: number | null;
+    retryWasteUsd: number;
+    retryWasteShare: number;
+    successRate: number | null;
+    premiumShare: number;
+    premiumSpend: number;
+    topModelConcentration: number;
+    projectedMonthSpend: number | null;
+    burnMultiple: number | null;
+}
+export interface PracticeScore {
+    total: number;
+    checks: Array<{
+        id: string;
+        label: string;
+        points: number;
+        maxPoints: number;
+        detail: string;
+    }>;
+}
+export interface ModelOpportunity {
+    model: string;
+    spend: number;
+    requests: number;
+    failureRate: number | null;
+    avgCostPerRequest: number;
+    flag: 'downgrade-candidate' | 'failure-outlier' | 'ok';
+    hint: string;
+}
+export interface SpendLogEntry {
+    requestId: string;
+    model: string;
+    spend: number;
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    status: string;
+    cacheHit: boolean;
+    userId?: string;
+    teamId?: string;
+    keyHash?: string;
+    timestamp: string;
+}
+export interface SpendLogsParams {
+    startDate: string;
+    endDate: string;
+    userId?: string;
+    teamId?: string;
+    page?: number;
+    pageSize?: number;
+}
+export interface PaginatedSpendLogs {
+    data: SpendLogEntry[];
+    total: number;
+    page: number;
+    pageSize: number;
+    truncated: boolean;
+}
+/** One model's Langfuse usage slice (cost/tokens/latency for the period). */
+export interface QualityByModel {
+    model: string;
+    cost: number;
+    tokens: number;
+    avgLatencyMs: number | null;
+    requests: number;
+}
+/** One Langfuse numeric score averaged over the period. */
+export interface QualityScore {
+    name: string;
+    avg: number;
+    count: number;
+}
+/** Quality summary served by GET /insights/quality when Langfuse is connected. */
+export interface QualitySummary {
+    configured: true;
+    byModel: QualityByModel[];
+    scores: QualityScore[];
+}
+/** GET /insights/quality response: data, or `{configured:false}` when Langfuse is off. */
+export type QualityResponse = {
+    configured: false;
+} | QualitySummary;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acarmisc/backstage-plugin-litellm-common",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Shared types, permissions, and schemas for the LiteLLM Backstage plugin",
   "backstage": {
     "role": "common-library",