@homeflare/distilled-litellm 0.2.0

package/src/services/tag_management.ts

@@ -0,0 +1,1004 @@
+// AUTO-GENERATED by scripts/generate.ts from .generated-specs (pinned litellm-openapi @ 1.100.0 — see README). Do not edit.
+import * as S from "@distilled.cloud/core/schema";
+import * as API from "@distilled.cloud/core/api";
+import * as C from "@distilled.cloud/core/category";
+import * as T from "../traits.ts";
+import {
+  LitellmProtocol,
+  type LitellmOpError,
+  type LitellmOpContext,
+} from "../protocol.ts";
+import * as Retry from "../retry.ts";
+
+export type { LitellmOpError, LitellmOpContext };
+
+export class UnprocessableEntity
+  extends /*@__PURE__*/ T.applyErrorMatchers(
+    /*@__PURE__*/ S.TaggedError<UnprocessableEntity>()("UnprocessableEntity", {
+      code: S.Number,
+      message: S.String,
+    }).pipe(C.withBadRequestError),
+    [{ status: 422 }],
+  ) {}
+
+export interface DeleteTagTagDeletePostRequest {
+  name: string;
+}
+export const DeleteTagTagDeletePostRequest = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    name: S.String,
+  }).pipe(T.Http({ method: "POST", uri: "/tag/delete", code: 200 })),
+).annotate({
+  identifier: "DeleteTagTagDeletePostRequest",
+}) as any as S.Schema<DeleteTagTagDeletePostRequest>;
+
+export interface DeleteTagTagDeletePostResponse {
+  body: unknown;
+}
+export const DeleteTagTagDeletePostResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    body: S.Unknown,
+  }),
+).annotate({
+  identifier: "DeleteTagTagDeletePostResponse",
+}) as any as S.Schema<DeleteTagTagDeletePostResponse>;
+
+export type GetDailyActiveUsersTagDauGetRequestTagFiltersList = Array<string>;
+export const GetDailyActiveUsersTagDauGetRequestTagFiltersList =
+  /*@__PURE__*/ S.Array(
+    S.String,
+  ) as any as S.Schema<GetDailyActiveUsersTagDauGetRequestTagFiltersList>;
+
+export interface GetDailyActiveUsersTagDauGetRequest {
+  /** Filter by specific tag (optional) */
+  tag_filter?: string;
+  /** Filter by multiple specific tags (optional, takes precedence over tag_filter) */
+  tag_filters?: GetDailyActiveUsersTagDauGetRequestTagFiltersList;
+}
+export const GetDailyActiveUsersTagDauGetRequest = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    tag_filter: S.optional(S.String.pipe(T.Query())),
+    tag_filters: S.optional(
+      GetDailyActiveUsersTagDauGetRequestTagFiltersList.pipe(T.Query()),
+    ),
+  }).pipe(T.Http({ method: "GET", uri: "/tag/dau", code: 200 })),
+).annotate({
+  identifier: "GetDailyActiveUsersTagDauGetRequest",
+}) as any as S.Schema<GetDailyActiveUsersTagDauGetRequest>;
+
+/** Response for tag active users metrics */
+export interface TagActiveUsersResponse {
+  active_users: number;
+  date: string;
+  period_end?: string | null;
+  period_start?: string | null;
+  tag: string;
+}
+export const TagActiveUsersResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    active_users: S.Number,
+    date: S.String,
+    period_end: S.optional(S.NullOr(S.String)),
+    period_start: S.optional(S.NullOr(S.String)),
+    tag: S.String,
+  }),
+).annotate({
+  identifier: "TagActiveUsersResponse",
+}) as any as S.Schema<TagActiveUsersResponse>;
+
+export type ActiveUsersAnalyticsResponseResultsList =
+  Array<TagActiveUsersResponse>;
+export const ActiveUsersAnalyticsResponseResultsList = /*@__PURE__*/ S.Array(
+  TagActiveUsersResponse,
+) as any as S.Schema<ActiveUsersAnalyticsResponseResultsList>;
+
+/** Response for active users analytics */
+export interface ActiveUsersAnalyticsResponse {
+  results: ActiveUsersAnalyticsResponseResultsList;
+}
+export const ActiveUsersAnalyticsResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    results: ActiveUsersAnalyticsResponseResultsList,
+  }),
+).annotate({
+  identifier: "ActiveUsersAnalyticsResponse",
+}) as any as S.Schema<ActiveUsersAnalyticsResponse>;
+
+export interface GetDistinctUserAgentTagsTagDistinctGetRequest {}
+export const GetDistinctUserAgentTagsTagDistinctGetRequest =
+  /*@__PURE__*/ S.suspend(() =>
+    S.Struct({}).pipe(
+      T.Http({ method: "GET", uri: "/tag/distinct", code: 200 }),
+    ),
+  ).annotate({
+    identifier: "GetDistinctUserAgentTagsTagDistinctGetRequest",
+  }) as any as S.Schema<GetDistinctUserAgentTagsTagDistinctGetRequest>;
+
+/** Response for distinct user agent tags */
+export interface DistinctTagResponse {
+  tag: string;
+}
+export const DistinctTagResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    tag: S.String,
+  }),
+).annotate({
+  identifier: "DistinctTagResponse",
+}) as any as S.Schema<DistinctTagResponse>;
+
+export type DistinctTagsResponseResultsList = Array<DistinctTagResponse>;
+export const DistinctTagsResponseResultsList = /*@__PURE__*/ S.Array(
+  DistinctTagResponse,
+) as any as S.Schema<DistinctTagsResponseResultsList>;
+
+/** Response for all distinct user agent tags */
+export interface DistinctTagsResponse {
+  results: DistinctTagsResponseResultsList;
+}
+export const DistinctTagsResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    results: DistinctTagsResponseResultsList,
+  }),
+).annotate({
+  identifier: "DistinctTagsResponse",
+}) as any as S.Schema<DistinctTagsResponse>;
+
+export type GetMonthlyActiveUsersTagMauGetRequestTagFiltersList = Array<string>;
+export const GetMonthlyActiveUsersTagMauGetRequestTagFiltersList =
+  /*@__PURE__*/ S.Array(
+    S.String,
+  ) as any as S.Schema<GetMonthlyActiveUsersTagMauGetRequestTagFiltersList>;
+
+export interface GetMonthlyActiveUsersTagMauGetRequest {
+  /** Filter by specific tag (optional) */
+  tag_filter?: string;
+  /** Filter by multiple specific tags (optional, takes precedence over tag_filter) */
+  tag_filters?: GetMonthlyActiveUsersTagMauGetRequestTagFiltersList;
+}
+export const GetMonthlyActiveUsersTagMauGetRequest = /*@__PURE__*/ S.suspend(
+  () =>
+    S.Struct({
+      tag_filter: S.optional(S.String.pipe(T.Query())),
+      tag_filters: S.optional(
+        GetMonthlyActiveUsersTagMauGetRequestTagFiltersList.pipe(T.Query()),
+      ),
+    }).pipe(T.Http({ method: "GET", uri: "/tag/mau", code: 200 })),
+).annotate({
+  identifier: "GetMonthlyActiveUsersTagMauGetRequest",
+}) as any as S.Schema<GetMonthlyActiveUsersTagMauGetRequest>;
+
+export type GetPerUserAnalyticsTagUserAgentPerUserAnalyticsGetRequestTagFiltersList =
+  Array<string>;
+export const GetPerUserAnalyticsTagUserAgentPerUserAnalyticsGetRequestTagFiltersList =
+  /*@__PURE__*/ S.Array(
+    S.String,
+  ) as any as S.Schema<GetPerUserAnalyticsTagUserAgentPerUserAnalyticsGetRequestTagFiltersList>;
+
+export interface GetPerUserAnalyticsTagUserAgentPerUserAnalyticsGetRequest {
+  /** Filter by specific tag (optional) */
+  tag_filter?: string;
+  /** Filter by multiple specific tags (optional, takes precedence over tag_filter) */
+  tag_filters?: GetPerUserAnalyticsTagUserAgentPerUserAnalyticsGetRequestTagFiltersList;
+  /** Page number for pagination */
+  page?: number;
+  /** Items per page */
+  page_size?: number;
+}
+export const GetPerUserAnalyticsTagUserAgentPerUserAnalyticsGetRequest =
+  /*@__PURE__*/ S.suspend(() =>
+    S.Struct({
+      tag_filter: S.optional(S.String.pipe(T.Query())),
+      tag_filters: S.optional(
+        GetPerUserAnalyticsTagUserAgentPerUserAnalyticsGetRequestTagFiltersList.pipe(
+          T.Query(),
+        ),
+      ),
+      page: S.optional(S.Number.pipe(T.Query())),
+      page_size: S.optional(S.Number.pipe(T.Query())),
+    }).pipe(
+      T.Http({
+        method: "GET",
+        uri: "/tag/user-agent/per-user-analytics",
+        code: 200,
+      }),
+    ),
+  ).annotate({
+    identifier: "GetPerUserAnalyticsTagUserAgentPerUserAnalyticsGetRequest",
+  }) as any as S.Schema<GetPerUserAnalyticsTagUserAgentPerUserAnalyticsGetRequest>;
+
+/** Metrics for individual user */
+export interface PerUserMetrics {
+  failed_requests?: number;
+  spend?: number;
+  successful_requests?: number;
+  total_requests?: number;
+  total_tokens?: number;
+  user_agent?: string | null;
+  user_email?: string | null;
+  user_id: string;
+}
+export const PerUserMetrics = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    failed_requests: S.optional(S.Number),
+    spend: S.optional(S.Number),
+    successful_requests: S.optional(S.Number),
+    total_requests: S.optional(S.Number),
+    total_tokens: S.optional(S.Number),
+    user_agent: S.optional(S.NullOr(S.String)),
+    user_email: S.optional(S.NullOr(S.String)),
+    user_id: S.String,
+  }),
+).annotate({ identifier: "PerUserMetrics" }) as any as S.Schema<PerUserMetrics>;
+
+export type PerUserAnalyticsResponseResultsList = Array<PerUserMetrics>;
+export const PerUserAnalyticsResponseResultsList = /*@__PURE__*/ S.Array(
+  PerUserMetrics,
+) as any as S.Schema<PerUserAnalyticsResponseResultsList>;
+
+/** Response for per-user analytics */
+export interface PerUserAnalyticsResponse {
+  page: number;
+  page_size: number;
+  results: PerUserAnalyticsResponseResultsList;
+  total_count: number;
+  total_pages: number;
+}
+export const PerUserAnalyticsResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    page: S.Number,
+    page_size: S.Number,
+    results: PerUserAnalyticsResponseResultsList,
+    total_count: S.Number,
+    total_pages: S.Number,
+  }),
+).annotate({
+  identifier: "PerUserAnalyticsResponse",
+}) as any as S.Schema<PerUserAnalyticsResponse>;
+
+export interface GetTagDailyActivityTagDailyActivityGetRequest {
+  tags?: string;
+  start_date?: string;
+  end_date?: string;
+  model?: string;
+  api_key?: string;
+  page?: number;
+  page_size?: number;
+}
+export const GetTagDailyActivityTagDailyActivityGetRequest =
+  /*@__PURE__*/ S.suspend(() =>
+    S.Struct({
+      tags: S.optional(S.String.pipe(T.Query())),
+      start_date: S.optional(S.String.pipe(T.Query())),
+      end_date: S.optional(S.String.pipe(T.Query())),
+      model: S.optional(S.String.pipe(T.Query())),
+      api_key: S.optional(S.String.pipe(T.Query())),
+      page: S.optional(S.Number.pipe(T.Query())),
+      page_size: S.optional(S.Number.pipe(T.Query())),
+    }).pipe(T.Http({ method: "GET", uri: "/tag/daily/activity", code: 200 })),
+  ).annotate({
+    identifier: "GetTagDailyActivityTagDailyActivityGetRequest",
+  }) as any as S.Schema<GetTagDailyActivityTagDailyActivityGetRequest>;
+
+export interface DailySpendMetadata {
+  has_more?: boolean;
+  page?: number;
+  total_api_requests?: number;
+  total_autorouter_savings_spend?: number;
+  total_cache_creation_input_tokens?: number;
+  total_cache_read_input_tokens?: number;
+  total_completion_tokens?: number;
+  total_compression_saved_tokens?: number;
+  total_compression_savings_spend?: number;
+  total_failed_requests?: number;
+  total_flat_cost?: number;
+  total_gateway_injected_caching_savings_spend?: number;
+  total_pages?: number;
+  total_prompt_caching_savings_spend?: number;
+  total_prompt_tokens?: number;
+  total_spend?: number;
+  total_successful_requests?: number;
+  total_tokens?: number;
+}
+export const DailySpendMetadata = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    has_more: S.optional(S.Boolean),
+    page: S.optional(S.Number),
+    total_api_requests: S.optional(S.Number),
+    total_autorouter_savings_spend: S.optional(S.Number),
+    total_cache_creation_input_tokens: S.optional(S.Number),
+    total_cache_read_input_tokens: S.optional(S.Number),
+    total_completion_tokens: S.optional(S.Number),
+    total_compression_saved_tokens: S.optional(S.Number),
+    total_compression_savings_spend: S.optional(S.Number),
+    total_failed_requests: S.optional(S.Number),
+    total_flat_cost: S.optional(S.Number),
+    total_gateway_injected_caching_savings_spend: S.optional(S.Number),
+    total_pages: S.optional(S.Number),
+    total_prompt_caching_savings_spend: S.optional(S.Number),
+    total_prompt_tokens: S.optional(S.Number),
+    total_spend: S.optional(S.Number),
+    total_successful_requests: S.optional(S.Number),
+    total_tokens: S.optional(S.Number),
+  }),
+).annotate({
+  identifier: "DailySpendMetadata",
+}) as any as S.Schema<DailySpendMetadata>;
+
+/** Metadata for a key */
+export interface KeyMetadata {
+  key_alias?: string | null;
+  team_id?: string | null;
+}
+export const KeyMetadata = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    key_alias: S.optional(S.NullOr(S.String)),
+    team_id: S.optional(S.NullOr(S.String)),
+  }),
+).annotate({ identifier: "KeyMetadata" }) as any as S.Schema<KeyMetadata>;
+
+export interface SpendMetrics {
+  api_requests?: number;
+  autorouter_savings_spend?: number;
+  cache_creation_input_tokens?: number;
+  cache_read_input_tokens?: number;
+  completion_tokens?: number;
+  compression_saved_tokens?: number;
+  compression_savings_spend?: number;
+  failed_requests?: number;
+  flat_cost?: number;
+  gateway_injected_caching_savings_spend?: number;
+  prompt_caching_savings_spend?: number;
+  prompt_tokens?: number;
+  spend?: number;
+  successful_requests?: number;
+  total_tokens?: number;
+}
+export const SpendMetrics = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    api_requests: S.optional(S.Number),
+    autorouter_savings_spend: S.optional(S.Number),
+    cache_creation_input_tokens: S.optional(S.Number),
+    cache_read_input_tokens: S.optional(S.Number),
+    completion_tokens: S.optional(S.Number),
+    compression_saved_tokens: S.optional(S.Number),
+    compression_savings_spend: S.optional(S.Number),
+    failed_requests: S.optional(S.Number),
+    flat_cost: S.optional(S.Number),
+    gateway_injected_caching_savings_spend: S.optional(S.Number),
+    prompt_caching_savings_spend: S.optional(S.Number),
+    prompt_tokens: S.optional(S.Number),
+    spend: S.optional(S.Number),
+    successful_requests: S.optional(S.Number),
+    total_tokens: S.optional(S.Number),
+  }),
+).annotate({ identifier: "SpendMetrics" }) as any as S.Schema<SpendMetrics>;
+
+/** Base class for metrics with additional metadata */
+export interface KeyMetricWithMetadata {
+  metadata?: KeyMetadata;
+  metrics: SpendMetrics;
+}
+export const KeyMetricWithMetadata = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    metadata: S.optional(KeyMetadata),
+    metrics: SpendMetrics,
+  }),
+).annotate({
+  identifier: "KeyMetricWithMetadata",
+}) as any as S.Schema<KeyMetricWithMetadata>;
+
+export type BreakdownMetricsApiKeysMap = {
+  [key: string]: KeyMetricWithMetadata | undefined;
+};
+export const BreakdownMetricsApiKeysMap = /*@__PURE__*/ S.Record(
+  S.String,
+  KeyMetricWithMetadata,
+) as any as S.Schema<BreakdownMetricsApiKeysMap>;
+
+export type MetricWithMetadataApiKeyBreakdownMap = {
+  [key: string]: KeyMetricWithMetadata | undefined;
+};
+export const MetricWithMetadataApiKeyBreakdownMap = /*@__PURE__*/ S.Record(
+  S.String,
+  KeyMetricWithMetadata,
+) as any as S.Schema<MetricWithMetadataApiKeyBreakdownMap>;
+
+export type MetricWithMetadataMetadataMap = {
+  [key: string]: unknown | undefined;
+};
+export const MetricWithMetadataMetadataMap = /*@__PURE__*/ S.Record(
+  S.String,
+  S.Unknown,
+) as any as S.Schema<MetricWithMetadataMetadataMap>;
+
+export interface MetricWithMetadata {
+  api_key_breakdown?: MetricWithMetadataApiKeyBreakdownMap;
+  metadata?: MetricWithMetadataMetadataMap;
+  metrics: SpendMetrics;
+}
+export const MetricWithMetadata = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    api_key_breakdown: S.optional(MetricWithMetadataApiKeyBreakdownMap),
+    metadata: S.optional(MetricWithMetadataMetadataMap),
+    metrics: SpendMetrics,
+  }),
+).annotate({
+  identifier: "MetricWithMetadata",
+}) as any as S.Schema<MetricWithMetadata>;
+
+export type BreakdownMetricsEndpointsMap = {
+  [key: string]: MetricWithMetadata | undefined;
+};
+export const BreakdownMetricsEndpointsMap = /*@__PURE__*/ S.Record(
+  S.String,
+  MetricWithMetadata,
+) as any as S.Schema<BreakdownMetricsEndpointsMap>;
+
+export type BreakdownMetricsEntitiesMap = {
+  [key: string]: MetricWithMetadata | undefined;
+};
+export const BreakdownMetricsEntitiesMap = /*@__PURE__*/ S.Record(
+  S.String,
+  MetricWithMetadata,
+) as any as S.Schema<BreakdownMetricsEntitiesMap>;
+
+export type BreakdownMetricsMcpServersMap = {
+  [key: string]: MetricWithMetadata | undefined;
+};
+export const BreakdownMetricsMcpServersMap = /*@__PURE__*/ S.Record(
+  S.String,
+  MetricWithMetadata,
+) as any as S.Schema<BreakdownMetricsMcpServersMap>;
+
+export type BreakdownMetricsModelGroupsMap = {
+  [key: string]: MetricWithMetadata | undefined;
+};
+export const BreakdownMetricsModelGroupsMap = /*@__PURE__*/ S.Record(
+  S.String,
+  MetricWithMetadata,
+) as any as S.Schema<BreakdownMetricsModelGroupsMap>;
+
+export type BreakdownMetricsModelsMap = {
+  [key: string]: MetricWithMetadata | undefined;
+};
+export const BreakdownMetricsModelsMap = /*@__PURE__*/ S.Record(
+  S.String,
+  MetricWithMetadata,
+) as any as S.Schema<BreakdownMetricsModelsMap>;
+
+export type BreakdownMetricsProvidersMap = {
+  [key: string]: MetricWithMetadata | undefined;
+};
+export const BreakdownMetricsProvidersMap = /*@__PURE__*/ S.Record(
+  S.String,
+  MetricWithMetadata,
+) as any as S.Schema<BreakdownMetricsProvidersMap>;
+
+/** Breakdown of spend by different dimensions */
+export interface BreakdownMetrics {
+  api_keys?: BreakdownMetricsApiKeysMap;
+  endpoints?: BreakdownMetricsEndpointsMap;
+  entities?: BreakdownMetricsEntitiesMap;
+  mcp_servers?: BreakdownMetricsMcpServersMap;
+  model_groups?: BreakdownMetricsModelGroupsMap;
+  models?: BreakdownMetricsModelsMap;
+  providers?: BreakdownMetricsProvidersMap;
+}
+export const BreakdownMetrics = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    api_keys: S.optional(BreakdownMetricsApiKeysMap),
+    endpoints: S.optional(BreakdownMetricsEndpointsMap),
+    entities: S.optional(BreakdownMetricsEntitiesMap),
+    mcp_servers: S.optional(BreakdownMetricsMcpServersMap),
+    model_groups: S.optional(BreakdownMetricsModelGroupsMap),
+    models: S.optional(BreakdownMetricsModelsMap),
+    providers: S.optional(BreakdownMetricsProvidersMap),
+  }),
+).annotate({
+  identifier: "BreakdownMetrics",
+}) as any as S.Schema<BreakdownMetrics>;
+
+export interface DailySpendData {
+  breakdown?: BreakdownMetrics;
+  date: string;
+  metrics: SpendMetrics;
+}
+export const DailySpendData = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    breakdown: S.optional(BreakdownMetrics),
+    date: S.String,
+    metrics: SpendMetrics,
+  }),
+).annotate({ identifier: "DailySpendData" }) as any as S.Schema<DailySpendData>;
+
+export type SpendAnalyticsPaginatedResponseResultsList = Array<DailySpendData>;
+export const SpendAnalyticsPaginatedResponseResultsList = /*@__PURE__*/ S.Array(
+  DailySpendData,
+) as any as S.Schema<SpendAnalyticsPaginatedResponseResultsList>;
+
+export interface SpendAnalyticsPaginatedResponse {
+  metadata?: DailySpendMetadata;
+  results: SpendAnalyticsPaginatedResponseResultsList;
+}
+export const SpendAnalyticsPaginatedResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    metadata: S.optional(DailySpendMetadata),
+    results: SpendAnalyticsPaginatedResponseResultsList,
+  }),
+).annotate({
+  identifier: "SpendAnalyticsPaginatedResponse",
+}) as any as S.Schema<SpendAnalyticsPaginatedResponse>;
+
+export type GetTagSummaryTagSummaryGetRequestTagFiltersList = Array<string>;
+export const GetTagSummaryTagSummaryGetRequestTagFiltersList =
+  /*@__PURE__*/ S.Array(
+    S.String,
+  ) as any as S.Schema<GetTagSummaryTagSummaryGetRequestTagFiltersList>;
+
+export interface GetTagSummaryTagSummaryGetRequest {
+  /** Start date in YYYY-MM-DD format */
+  start_date: string;
+  /** End date in YYYY-MM-DD format */
+  end_date: string;
+  /** Filter by specific tag (optional) */
+  tag_filter?: string;
+  /** Filter by multiple specific tags (optional, takes precedence over tag_filter) */
+  tag_filters?: GetTagSummaryTagSummaryGetRequestTagFiltersList;
+}
+export const GetTagSummaryTagSummaryGetRequest = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    start_date: S.String.pipe(T.Query()),
+    end_date: S.String.pipe(T.Query()),
+    tag_filter: S.optional(S.String.pipe(T.Query())),
+    tag_filters: S.optional(
+      GetTagSummaryTagSummaryGetRequestTagFiltersList.pipe(T.Query()),
+    ),
+  }).pipe(T.Http({ method: "GET", uri: "/tag/summary", code: 200 })),
+).annotate({
+  identifier: "GetTagSummaryTagSummaryGetRequest",
+}) as any as S.Schema<GetTagSummaryTagSummaryGetRequest>;
+
+/** Summary metrics for a tag */
+export interface TagSummaryMetrics {
+  failed_requests: number;
+  successful_requests: number;
+  tag: string;
+  total_requests: number;
+  total_spend: number;
+  total_tokens: number;
+  unique_users: number;
+}
+export const TagSummaryMetrics = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    failed_requests: S.Number,
+    successful_requests: S.Number,
+    tag: S.String,
+    total_requests: S.Number,
+    total_spend: S.Number,
+    total_tokens: S.Number,
+    unique_users: S.Number,
+  }),
+).annotate({
+  identifier: "TagSummaryMetrics",
+}) as any as S.Schema<TagSummaryMetrics>;
+
+export type TagSummaryResponseResultsList = Array<TagSummaryMetrics>;
+export const TagSummaryResponseResultsList = /*@__PURE__*/ S.Array(
+  TagSummaryMetrics,
+) as any as S.Schema<TagSummaryResponseResultsList>;
+
+/** Response for tag summary analytics */
+export interface TagSummaryResponse {
+  results: TagSummaryResponseResultsList;
+}
+export const TagSummaryResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    results: TagSummaryResponseResultsList,
+  }),
+).annotate({
+  identifier: "TagSummaryResponse",
+}) as any as S.Schema<TagSummaryResponse>;
+
+export type GetWeeklyActiveUsersTagWauGetRequestTagFiltersList = Array<string>;
+export const GetWeeklyActiveUsersTagWauGetRequestTagFiltersList =
+  /*@__PURE__*/ S.Array(
+    S.String,
+  ) as any as S.Schema<GetWeeklyActiveUsersTagWauGetRequestTagFiltersList>;
+
+export interface GetWeeklyActiveUsersTagWauGetRequest {
+  /** Filter by specific tag (optional) */
+  tag_filter?: string;
+  /** Filter by multiple specific tags (optional, takes precedence over tag_filter) */
+  tag_filters?: GetWeeklyActiveUsersTagWauGetRequestTagFiltersList;
+}
+export const GetWeeklyActiveUsersTagWauGetRequest = /*@__PURE__*/ S.suspend(
+  () =>
+    S.Struct({
+      tag_filter: S.optional(S.String.pipe(T.Query())),
+      tag_filters: S.optional(
+        GetWeeklyActiveUsersTagWauGetRequestTagFiltersList.pipe(T.Query()),
+      ),
+    }).pipe(T.Http({ method: "GET", uri: "/tag/wau", code: 200 })),
+).annotate({
+  identifier: "GetWeeklyActiveUsersTagWauGetRequest",
+}) as any as S.Schema<GetWeeklyActiveUsersTagWauGetRequest>;
+
+export interface ListTagsTagListGetRequest {
+  /** Optional start date (YYYY-MM-DD). When provided together with end_date, dynamic tags are limited to those active in the window. Stored tags are always returned. */
+  start_date?: string;
+  /** Optional end date (YYYY-MM-DD). Must be given with start_date. */
+  end_date?: string;
+}
+export const ListTagsTagListGetRequest = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    start_date: S.optional(S.String.pipe(T.Query())),
+    end_date: S.optional(S.String.pipe(T.Query())),
+  }).pipe(T.Http({ method: "GET", uri: "/tag/list", code: 200 })),
+).annotate({
+  identifier: "ListTagsTagListGetRequest",
+}) as any as S.Schema<ListTagsTagListGetRequest>;
+
+export interface ListTagsTagListGetResponse {
+  body: unknown;
+}
+export const ListTagsTagListGetResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    body: S.Unknown,
+  }),
+).annotate({
+  identifier: "ListTagsTagListGetResponse",
+}) as any as S.Schema<ListTagsTagListGetResponse>;
+
+export type PostInfoTagTagInfoRequestNamesList = Array<string>;
+export const PostInfoTagTagInfoRequestNamesList = /*@__PURE__*/ S.Array(
+  S.String,
+) as any as S.Schema<PostInfoTagTagInfoRequestNamesList>;
+
+export interface PostInfoTagTagInfoRequest {
+  names: PostInfoTagTagInfoRequestNamesList;
+}
+export const PostInfoTagTagInfoRequest = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    names: PostInfoTagTagInfoRequestNamesList,
+  }).pipe(T.Http({ method: "POST", uri: "/tag/info", code: 200 })),
+).annotate({
+  identifier: "PostInfoTagTagInfoRequest",
+}) as any as S.Schema<PostInfoTagTagInfoRequest>;
+
+export interface PostInfoTagTagInfoResponse {
+  body: unknown;
+}
+export const PostInfoTagTagInfoResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    body: S.Unknown,
+  }),
+).annotate({
+  identifier: "PostInfoTagTagInfoResponse",
+}) as any as S.Schema<PostInfoTagTagInfoResponse>;
+
+export type PostNewTagTagNewRequestModelInfoMap = {
+  [key: string]: string | undefined;
+};
+export const PostNewTagTagNewRequestModelInfoMap = /*@__PURE__*/ S.Record(
+  S.String,
+  S.String,
+) as any as S.Schema<PostNewTagTagNewRequestModelInfoMap>;
+
+export type PostNewTagTagNewRequestModelMaxBudgetMap = {
+  [key: string]: unknown | undefined;
+};
+export const PostNewTagTagNewRequestModelMaxBudgetMap = /*@__PURE__*/ S.Record(
+  S.String,
+  S.Unknown,
+) as any as S.Schema<PostNewTagTagNewRequestModelMaxBudgetMap>;
+
+export type PostNewTagTagNewRequestModelsList = Array<string>;
+export const PostNewTagTagNewRequestModelsList = /*@__PURE__*/ S.Array(
+  S.String,
+) as any as S.Schema<PostNewTagTagNewRequestModelsList>;
+
+export interface PostNewTagTagNewRequest {
+  budget_duration?: string | null;
+  budget_id?: string | null;
+  description?: string | null;
+  max_budget?: number | null;
+  max_parallel_requests?: number | null;
+  model_info?: PostNewTagTagNewRequestModelInfoMap | null;
+  model_max_budget?: PostNewTagTagNewRequestModelMaxBudgetMap | null;
+  models?: PostNewTagTagNewRequestModelsList | null;
+  name: string;
+  rpm_limit?: number | null;
+  soft_budget?: number | null;
+  tpm_limit?: number | null;
+}
+export const PostNewTagTagNewRequest = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    budget_duration: S.optional(S.NullOr(S.String)),
+    budget_id: S.optional(S.NullOr(S.String)),
+    description: S.optional(S.NullOr(S.String)),
+    max_budget: S.optional(S.NullOr(S.Number)),
+    max_parallel_requests: S.optional(S.NullOr(S.Number)),
+    model_info: S.optional(S.NullOr(PostNewTagTagNewRequestModelInfoMap)),
+    model_max_budget: S.optional(
+      S.NullOr(PostNewTagTagNewRequestModelMaxBudgetMap),
+    ),
+    models: S.optional(S.NullOr(PostNewTagTagNewRequestModelsList)),
+    name: S.String,
+    rpm_limit: S.optional(S.NullOr(S.Number)),
+    soft_budget: S.optional(S.NullOr(S.Number)),
+    tpm_limit: S.optional(S.NullOr(S.Number)),
+  }).pipe(T.Http({ method: "POST", uri: "/tag/new", code: 200 })),
+).annotate({
+  identifier: "PostNewTagTagNewRequest",
+}) as any as S.Schema<PostNewTagTagNewRequest>;
+
+export interface PostNewTagTagNewResponse {
+  body: unknown;
+}
+export const PostNewTagTagNewResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    body: S.Unknown,
+  }),
+).annotate({
+  identifier: "PostNewTagTagNewResponse",
+}) as any as S.Schema<PostNewTagTagNewResponse>;
+
+export type UpdateTagTagUpdatePostRequestModelInfoMap = {
+  [key: string]: string | undefined;
+};
+export const UpdateTagTagUpdatePostRequestModelInfoMap = /*@__PURE__*/ S.Record(
+  S.String,
+  S.String,
+) as any as S.Schema<UpdateTagTagUpdatePostRequestModelInfoMap>;
+
+export type UpdateTagTagUpdatePostRequestModelMaxBudgetMap = {
+  [key: string]: unknown | undefined;
+};
+export const UpdateTagTagUpdatePostRequestModelMaxBudgetMap =
+  /*@__PURE__*/ S.Record(
+    S.String,
+    S.Unknown,
+  ) as any as S.Schema<UpdateTagTagUpdatePostRequestModelMaxBudgetMap>;
+
+export type UpdateTagTagUpdatePostRequestModelsList = Array<string>;
+export const UpdateTagTagUpdatePostRequestModelsList = /*@__PURE__*/ S.Array(
+  S.String,
+) as any as S.Schema<UpdateTagTagUpdatePostRequestModelsList>;
+
+export interface UpdateTagTagUpdatePostRequest {
+  budget_duration?: string | null;
+  budget_id?: string | null;
+  description?: string | null;
+  max_budget?: number | null;
+  max_parallel_requests?: number | null;
+  model_info?: UpdateTagTagUpdatePostRequestModelInfoMap | null;
+  model_max_budget?: UpdateTagTagUpdatePostRequestModelMaxBudgetMap | null;
+  models?: UpdateTagTagUpdatePostRequestModelsList | null;
+  name: string;
+  rpm_limit?: number | null;
+  soft_budget?: number | null;
+  tpm_limit?: number | null;
+}
+export const UpdateTagTagUpdatePostRequest = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    budget_duration: S.optional(S.NullOr(S.String)),
+    budget_id: S.optional(S.NullOr(S.String)),
+    description: S.optional(S.NullOr(S.String)),
+    max_budget: S.optional(S.NullOr(S.Number)),
+    max_parallel_requests: S.optional(S.NullOr(S.Number)),
+    model_info: S.optional(S.NullOr(UpdateTagTagUpdatePostRequestModelInfoMap)),
+    model_max_budget: S.optional(
+      S.NullOr(UpdateTagTagUpdatePostRequestModelMaxBudgetMap),
+    ),
+    models: S.optional(S.NullOr(UpdateTagTagUpdatePostRequestModelsList)),
+    name: S.String,
+    rpm_limit: S.optional(S.NullOr(S.Number)),
+    soft_budget: S.optional(S.NullOr(S.Number)),
+    tpm_limit: S.optional(S.NullOr(S.Number)),
+  }).pipe(T.Http({ method: "POST", uri: "/tag/update", code: 200 })),
+).annotate({
+  identifier: "UpdateTagTagUpdatePostRequest",
+}) as any as S.Schema<UpdateTagTagUpdatePostRequest>;
+
+export interface UpdateTagTagUpdatePostResponse {
+  body: unknown;
+}
+export const UpdateTagTagUpdatePostResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    body: S.Unknown,
+  }),
+).annotate({
+  identifier: "UpdateTagTagUpdatePostResponse",
+}) as any as S.Schema<UpdateTagTagUpdatePostResponse>;
+
+export type DeleteTagTagDeletePostError = UnprocessableEntity | LitellmOpError;
+/** Delete Tag Delete a tag. Parameters: - name: str - The name of the tag to delete */
+export const deleteTagTagDeletePost: API.OperationMethod<
+  DeleteTagTagDeletePostRequest,
+  DeleteTagTagDeletePostResponse,
+  DeleteTagTagDeletePostError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: DeleteTagTagDeletePostRequest,
+  output: DeleteTagTagDeletePostResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type GetDailyActiveUsersTagDauGetError =
+  | UnprocessableEntity
+  | LitellmOpError;
+/** Get Daily Active Users Get Daily Active Users (DAU) by tags for the last {MAX_DAYS} days ending on UTC today + 1 day. This endpoint efficiently calculates unique users per tag for each of the last {MAX_DAYS} days using a single optimized SQL query, perfect for dashboard time series visualization. Args: tag_filter: Optional filter to specific tag (legacy) tag_filters: Optional filter to multiple specific tags (takes precedence over tag_filter) Returns: ActiveUsersAnalyticsResponse: DAU data by tag for each of the last {MAX_DAYS} days */
+export const getDailyActiveUsersTagDauGet: API.OperationMethod<
+  GetDailyActiveUsersTagDauGetRequest,
+  ActiveUsersAnalyticsResponse,
+  GetDailyActiveUsersTagDauGetError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: GetDailyActiveUsersTagDauGetRequest,
+  output: ActiveUsersAnalyticsResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type GetDistinctUserAgentTagsTagDistinctGetError = LitellmOpError;
+/** Get Distinct User Agent Tags Get all distinct user agent tags up to a maximum of {MAX_TAGS} tags. This endpoint returns all unique user agent tags found in the database, sorted by frequency of usage. Returns: DistinctTagsResponse: List of distinct user agent tags */
+export const getDistinctUserAgentTagsTagDistinctGet: API.OperationMethod<
+  GetDistinctUserAgentTagsTagDistinctGetRequest,
+  DistinctTagsResponse,
+  GetDistinctUserAgentTagsTagDistinctGetError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: GetDistinctUserAgentTagsTagDistinctGetRequest,
+  output: DistinctTagsResponse,
+  errors: [],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type GetMonthlyActiveUsersTagMauGetError =
+  | UnprocessableEntity
+  | LitellmOpError;
+/** Get Monthly Active Users Get Monthly Active Users (MAU) by tags for the last {MAX_MONTHS} months ending on UTC today + 1 day. Shows month-by-month breakdown: - Month 1 (Nov): Earliest month (7 months ago, 30-day period) - Month 2 (Dec): Next month (6 months ago) - Month 3 (Jan): Next month (5 months ago) - ... and so on for {MAX_MONTHS} months total - Month 7: Most recent month ending on UTC today + 1 day Args: tag_filter: Optional filter to specific tag (legacy) tag_filters: Optional filter to multiple specific tags (takes precedence over tag_filter) Returns: ActiveUsersAnalyticsResponse: MAU data by tag for each of the last {MAX_MONTHS} months with descriptive month labels (e.g., "Month 1 (Nov)") */
+export const getMonthlyActiveUsersTagMauGet: API.OperationMethod<
+  GetMonthlyActiveUsersTagMauGetRequest,
+  ActiveUsersAnalyticsResponse,
+  GetMonthlyActiveUsersTagMauGetError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: GetMonthlyActiveUsersTagMauGetRequest,
+  output: ActiveUsersAnalyticsResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type GetPerUserAnalyticsTagUserAgentPerUserAnalyticsGetError =
+  | UnprocessableEntity
+  | LitellmOpError;
+/** Get Per User Analytics Get per-user analytics including successful requests, tokens, and spend by individual users. This endpoint provides usage metrics broken down by individual users based on their tag activity during the last 30 days ending on UTC today + 1 day. Args: tag_filter: Optional filter to specific tag (legacy) tag_filters: Optional filter to multiple specific tags (takes precedence over tag_filter) page: Page number for pagination page_size: Number of items per page Returns: PerUserAnalyticsResponse: Analytics data broken down by individual users for the last 30 days */
+export const getPerUserAnalyticsTagUserAgentPerUserAnalyticsGet: API.OperationMethod<
+  GetPerUserAnalyticsTagUserAgentPerUserAnalyticsGetRequest,
+  PerUserAnalyticsResponse,
+  GetPerUserAnalyticsTagUserAgentPerUserAnalyticsGetError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: GetPerUserAnalyticsTagUserAgentPerUserAnalyticsGetRequest,
+  output: PerUserAnalyticsResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type GetTagDailyActivityTagDailyActivityGetError =
+  | UnprocessableEntity
+  | LitellmOpError;
+/** Get Tag Daily Activity Get daily activity for specific tags or all tags. Args: tags (Optional[str]): Comma-separated list of tags to filter by. If not provided, returns data for all tags. start_date (Optional[str]): Start date for the activity period (YYYY-MM-DD). end_date (Optional[str]): End date for the activity period (YYYY-MM-DD). model (Optional[str]): Filter by model name. api_key (Optional[str]): Filter by API key. page (int): Page number for pagination. page_size (int): Number of items per page. Returns: SpendAnalyticsPaginatedResponse: Paginated response containing daily activity data. */
+export const getTagDailyActivityTagDailyActivityGet: API.OperationMethod<
+  GetTagDailyActivityTagDailyActivityGetRequest,
+  SpendAnalyticsPaginatedResponse,
+  GetTagDailyActivityTagDailyActivityGetError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: GetTagDailyActivityTagDailyActivityGetRequest,
+  output: SpendAnalyticsPaginatedResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type GetTagSummaryTagSummaryGetError =
+  | UnprocessableEntity
+  | LitellmOpError;
+/** Get Tag Summary Get summary analytics for tags including unique users, requests, tokens, and spend. Args: start_date: Start date for the analytics period (YYYY-MM-DD) end_date: End date for the analytics period (YYYY-MM-DD) tag_filter: Optional filter to specific tag (legacy) tag_filters: Optional filter to multiple specific tags (takes precedence over tag_filter) Returns: TagSummaryResponse: Summary analytics data by tag */
+export const getTagSummaryTagSummaryGet: API.OperationMethod<
+  GetTagSummaryTagSummaryGetRequest,
+  TagSummaryResponse,
+  GetTagSummaryTagSummaryGetError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: GetTagSummaryTagSummaryGetRequest,
+  output: TagSummaryResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type GetWeeklyActiveUsersTagWauGetError =
+  | UnprocessableEntity
+  | LitellmOpError;
+/** Get Weekly Active Users Get Weekly Active Users (WAU) by tags for the last {MAX_WEEKS} weeks ending on UTC today + 1 day. Shows week-by-week breakdown: - Week 1 (Jan 1): Earliest week (7 weeks ago) - Week 2 (Jan 8): Next week (6 weeks ago) - Week 3 (Jan 15): Next week (5 weeks ago) - ... and so on for {MAX_WEEKS} weeks total - Week 7: Most recent week ending on UTC today + 1 day Args: tag_filter: Optional filter to specific tag (legacy) tag_filters: Optional filter to multiple specific tags (takes precedence over tag_filter) Returns: ActiveUsersAnalyticsResponse: WAU data by tag for each of the last {MAX_WEEKS} weeks with descriptive week labels (e.g., "Week 1 (Jan 1)") */
+export const getWeeklyActiveUsersTagWauGet: API.OperationMethod<
+  GetWeeklyActiveUsersTagWauGetRequest,
+  ActiveUsersAnalyticsResponse,
+  GetWeeklyActiveUsersTagWauGetError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: GetWeeklyActiveUsersTagWauGetRequest,
+  output: ActiveUsersAnalyticsResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type ListTagsTagListGetError = UnprocessableEntity | LitellmOpError;
+/** List Tags List all available tags with their budget information. */
+export const listTagsTagListGet: API.OperationMethod<
+  ListTagsTagListGetRequest,
+  ListTagsTagListGetResponse,
+  ListTagsTagListGetError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: ListTagsTagListGetRequest,
+  output: ListTagsTagListGetResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type PostInfoTagTagInfoError = UnprocessableEntity | LitellmOpError;
+/** Info Tag Get information about specific tags. Parameters: - names: List[str] - List of tag names to get information for */
+export const postInfoTagTagInfo: API.OperationMethod<
+  PostInfoTagTagInfoRequest,
+  PostInfoTagTagInfoResponse,
+  PostInfoTagTagInfoError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: PostInfoTagTagInfoRequest,
+  output: PostInfoTagTagInfoResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type PostNewTagTagNewError = UnprocessableEntity | LitellmOpError;
+/** New Tag Create a new tag. Parameters: - name: str - The name of the tag - description: Optional[str] - Description of what this tag represents - models: List[str] - List of either 'model_id' or 'model_name' allowed for this tag - budget_id: Optional[str] - The id for a budget (tpm/rpm/max budget) for the tag ### IF NO BUDGET ID - CREATE ONE WITH THESE PARAMS ### - max_budget: Optional[float] - Max budget for tag - tpm_limit: Optional[int] - Max tpm limit for tag - rpm_limit: Optional[int] - Max rpm limit for tag - max_parallel_requests: Optional[int] - Max parallel requests for tag - soft_budget: Optional[float] - Get a slack alert when this soft budget is reached - model_max_budget: Optional[dict] - Max budget for a specific model - budget_duration: Optional[str] - Frequency of resetting tag budget */
+export const postNewTagTagNew: API.OperationMethod<
+  PostNewTagTagNewRequest,
+  PostNewTagTagNewResponse,
+  PostNewTagTagNewError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: PostNewTagTagNewRequest,
+  output: PostNewTagTagNewResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type UpdateTagTagUpdatePostError = UnprocessableEntity | LitellmOpError;
+/** Update Tag Update an existing tag. Parameters: - name: str - The name of the tag to update - description: Optional[str] - Updated description - models: List[str] - Updated list of allowed LLM models - budget_id: Optional[str] - The id for a budget to associate with the tag ### BUDGET UPDATE PARAMS ### - max_budget: Optional[float] - Max budget for tag - tpm_limit: Optional[int] - Max tpm limit for tag - rpm_limit: Optional[int] - Max rpm limit for tag - max_parallel_requests: Optional[int] - Max parallel requests for tag - soft_budget: Optional[float] - Get a slack alert when this soft budget is reached - model_max_budget: Optional[dict] - Max budget for a specific model - budget_duration: Optional[str] - Frequency of resetting tag budget */
+export const updateTagTagUpdatePost: API.OperationMethod<
+  UpdateTagTagUpdatePostRequest,
+  UpdateTagTagUpdatePostResponse,
+  UpdateTagTagUpdatePostError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: UpdateTagTagUpdatePostRequest,
+  output: UpdateTagTagUpdatePostResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));