@homeflare/distilled-litellm 0.2.0

package/src/services/ui_settings.ts

@@ -0,0 +1,237 @@
+// 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 GetUiSettingsGetUiSettingsGetRequest {}
+export const GetUiSettingsGetUiSettingsGetRequest = /*@__PURE__*/ S.suspend(
+  () =>
+    S.Struct({}).pipe(
+      T.Http({ method: "GET", uri: "/get/ui_settings", code: 200 }),
+    ),
+).annotate({
+  identifier: "GetUiSettingsGetUiSettingsGetRequest",
+}) as any as S.Schema<GetUiSettingsGetUiSettingsGetRequest>;
+
+export type UISettingsResponseFieldSchemaMap = {
+  [key: string]: unknown | undefined;
+};
+export const UISettingsResponseFieldSchemaMap = /*@__PURE__*/ S.Record(
+  S.String,
+  S.Unknown,
+) as any as S.Schema<UISettingsResponseFieldSchemaMap>;
+
+export type UISettingsResponseValuesMap = {
+  [key: string]: unknown | undefined;
+};
+export const UISettingsResponseValuesMap = /*@__PURE__*/ S.Record(
+  S.String,
+  S.Unknown,
+) as any as S.Schema<UISettingsResponseValuesMap>;
+
+/** Response model for UI settings */
+export interface UISettingsResponse {
+  field_schema: UISettingsResponseFieldSchemaMap;
+  values: UISettingsResponseValuesMap;
+}
+export const UISettingsResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    field_schema: UISettingsResponseFieldSchemaMap,
+    values: UISettingsResponseValuesMap,
+  }),
+).annotate({
+  identifier: "UISettingsResponse",
+}) as any as S.Schema<UISettingsResponse>;
+
+export interface GetUserBannerGetUserBannerGetRequest {}
+export const GetUserBannerGetUserBannerGetRequest = /*@__PURE__*/ S.suspend(
+  () =>
+    S.Struct({}).pipe(
+      T.Http({ method: "GET", uri: "/get/user_banner", code: 200 }),
+    ),
+).annotate({
+  identifier: "GetUserBannerGetUserBannerGetRequest",
+}) as any as S.Schema<GetUserBannerGetUserBannerGetRequest>;
+
+/** Visual style of the banner. */
+export type UserBannerSeverity = "info" | "warning" | "error";
+export const UserBannerSeverity = S.String;
+
+export interface UserBanner {
+  /** If true, the banner is shown to all authenticated dashboard users. */
+  enabled?: boolean;
+  /** Banner text shown to dashboard users. Markdown is supported. */
+  message?: string;
+  /** Server-stamped opaque publish identity; a fresh value is generated on every update so clients re-surface dismissed banners on republish. */
+  revision?: string;
+  /** Visual style of the banner. */
+  severity?: UserBannerSeverity;
+}
+export const UserBanner = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    enabled: S.optional(S.Boolean),
+    message: S.optional(S.String),
+    revision: S.optional(S.String),
+    severity: S.optional(UserBannerSeverity),
+  }),
+).annotate({ identifier: "UserBanner" }) as any as S.Schema<UserBanner>;
+
+export type UpdateUiSettingsUpdateUiSettingsPatchRequestBodyMap = {
+  [key: string]: unknown | undefined;
+};
+export const UpdateUiSettingsUpdateUiSettingsPatchRequestBodyMap =
+  /*@__PURE__*/ S.Record(
+    S.String,
+    S.Unknown,
+  ) as any as S.Schema<UpdateUiSettingsUpdateUiSettingsPatchRequestBodyMap>;
+
+export interface UpdateUiSettingsUpdateUiSettingsPatchRequest {
+  body: UpdateUiSettingsUpdateUiSettingsPatchRequestBodyMap;
+}
+export const UpdateUiSettingsUpdateUiSettingsPatchRequest =
+  /*@__PURE__*/ S.suspend(() =>
+    S.Struct({
+      body: UpdateUiSettingsUpdateUiSettingsPatchRequestBodyMap.pipe(
+        T.HttpBody(),
+      ),
+    }).pipe(T.Http({ method: "PATCH", uri: "/update/ui_settings", code: 200 })),
+  ).annotate({
+    identifier: "UpdateUiSettingsUpdateUiSettingsPatchRequest",
+  }) as any as S.Schema<UpdateUiSettingsUpdateUiSettingsPatchRequest>;
+
+export interface UpdateUiSettingsUpdateUiSettingsPatchResponse {
+  body: unknown;
+}
+export const UpdateUiSettingsUpdateUiSettingsPatchResponse =
+  /*@__PURE__*/ S.suspend(() =>
+    S.Struct({
+      body: S.Unknown,
+    }),
+  ).annotate({
+    identifier: "UpdateUiSettingsUpdateUiSettingsPatchResponse",
+  }) as any as S.Schema<UpdateUiSettingsUpdateUiSettingsPatchResponse>;
+
+/** Visual style of the banner. */
+export type UpdateUserBannerUpdateUserBannerPatchRequestSeverity =
+  | "info"
+  | "warning"
+  | "error";
+export const UpdateUserBannerUpdateUserBannerPatchRequestSeverity = S.String;
+
+export interface UpdateUserBannerUpdateUserBannerPatchRequest {
+  /** If true, the banner is shown to all authenticated dashboard users. */
+  enabled?: boolean;
+  /** Banner text shown to dashboard users. Markdown is supported. */
+  message?: string;
+  /** Visual style of the banner. */
+  severity?:
+    | UpdateUserBannerUpdateUserBannerPatchRequestSeverity
+    | (string & {});
+}
+export const UpdateUserBannerUpdateUserBannerPatchRequest =
+  /*@__PURE__*/ S.suspend(() =>
+    S.Struct({
+      enabled: S.optional(S.Boolean),
+      message: S.optional(S.String),
+      severity: S.optional(
+        UpdateUserBannerUpdateUserBannerPatchRequestSeverity,
+      ),
+    }).pipe(T.Http({ method: "PATCH", uri: "/update/user_banner", code: 200 })),
+  ).annotate({
+    identifier: "UpdateUserBannerUpdateUserBannerPatchRequest",
+  }) as any as S.Schema<UpdateUserBannerUpdateUserBannerPatchRequest>;
+
+export interface UpdateUserBannerResponse {
+  banner: UserBanner;
+  message: string;
+}
+export const UpdateUserBannerResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    banner: UserBanner,
+    message: S.String,
+  }),
+).annotate({
+  identifier: "UpdateUserBannerResponse",
+}) as any as S.Schema<UpdateUserBannerResponse>;
+
+export type GetUiSettingsGetUiSettingsGetError = LitellmOpError;
+/** Get Ui Settings Get UI-specific configuration flags. All authenticated users can fetch these settings for client-side behavior. */
+export const getUiSettingsGetUiSettingsGet: API.OperationMethod<
+  GetUiSettingsGetUiSettingsGetRequest,
+  UISettingsResponse,
+  GetUiSettingsGetUiSettingsGetError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: GetUiSettingsGetUiSettingsGetRequest,
+  output: UISettingsResponse,
+  errors: [],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type GetUserBannerGetUserBannerGetError = LitellmOpError;
+/** Get User Banner Get the admin-published dashboard banner. Readable by any authenticated user; rendered on every dashboard page. */
+export const getUserBannerGetUserBannerGet: API.OperationMethod<
+  GetUserBannerGetUserBannerGetRequest,
+  UserBanner,
+  GetUserBannerGetUserBannerGetError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: GetUserBannerGetUserBannerGetRequest,
+  output: UserBanner,
+  errors: [],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type UpdateUiSettingsUpdateUiSettingsPatchError =
+  | UnprocessableEntity
+  | LitellmOpError;
+/** Update Ui Settings Update UI-specific configuration flags. Only proxy admins are allowed to modify these settings. */
+export const updateUiSettingsUpdateUiSettingsPatch: API.OperationMethod<
+  UpdateUiSettingsUpdateUiSettingsPatchRequest,
+  UpdateUiSettingsUpdateUiSettingsPatchResponse,
+  UpdateUiSettingsUpdateUiSettingsPatchError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: UpdateUiSettingsUpdateUiSettingsPatchRequest,
+  output: UpdateUiSettingsUpdateUiSettingsPatchResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type UpdateUserBannerUpdateUserBannerPatchError =
+  | UnprocessableEntity
+  | LitellmOpError;
+/** Update User Banner Publish, edit, or unpublish the dashboard banner. Only proxy admins are allowed to modify it. */
+export const updateUserBannerUpdateUserBannerPatch: API.OperationMethod<
+  UpdateUserBannerUpdateUserBannerPatchRequest,
+  UpdateUserBannerResponse,
+  UpdateUserBannerUpdateUserBannerPatchError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: UpdateUserBannerUpdateUserBannerPatchRequest,
+  output: UpdateUserBannerResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));

package/src/services/ui_theme_settings.ts

@@ -0,0 +1,173 @@
+// 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 GetUiThemeSettingsGetUiThemeSettingsGetRequest {}
+export const GetUiThemeSettingsGetUiThemeSettingsGetRequest =
+  /*@__PURE__*/ S.suspend(() =>
+    S.Struct({}).pipe(
+      T.Http({ method: "GET", uri: "/get/ui_theme_settings", code: 200 }),
+    ),
+  ).annotate({
+    identifier: "GetUiThemeSettingsGetUiThemeSettingsGetRequest",
+  }) as any as S.Schema<GetUiThemeSettingsGetUiThemeSettingsGetRequest>;
+
+export type UIThemeSettingsResponseFieldSchemaMap = {
+  [key: string]: unknown | undefined;
+};
+export const UIThemeSettingsResponseFieldSchemaMap = /*@__PURE__*/ S.Record(
+  S.String,
+  S.Unknown,
+) as any as S.Schema<UIThemeSettingsResponseFieldSchemaMap>;
+
+export type UIThemeSettingsResponseValuesMap = {
+  [key: string]: unknown | undefined;
+};
+export const UIThemeSettingsResponseValuesMap = /*@__PURE__*/ S.Record(
+  S.String,
+  S.Unknown,
+) as any as S.Schema<UIThemeSettingsResponseValuesMap>;
+
+/** Response model for UI theme settings */
+export interface UIThemeSettingsResponse {
+  field_schema: UIThemeSettingsResponseFieldSchemaMap;
+  values: UIThemeSettingsResponseValuesMap;
+}
+export const UIThemeSettingsResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    field_schema: UIThemeSettingsResponseFieldSchemaMap,
+    values: UIThemeSettingsResponseValuesMap,
+  }),
+).annotate({
+  identifier: "UIThemeSettingsResponse",
+}) as any as S.Schema<UIThemeSettingsResponse>;
+
+export interface UpdateUiThemeSettingsUpdateUiThemeSettingsPatchRequest {
+  /** URL to custom favicon image. Must be an HTTP/HTTPS URL to a .ico, .png, or .svg file */
+  favicon_url?: string | null;
+  /** URL or path to custom logo image. Can be a local file path or HTTP/HTTPS URL */
+  logo_url?: string | null;
+  /** URL or path to a custom logo image for dark mode. Can be a local file path or HTTP/HTTPS URL. Leave unset to reuse logo_url in dark mode */
+  logo_url_dark?: string | null;
+}
+export const UpdateUiThemeSettingsUpdateUiThemeSettingsPatchRequest =
+  /*@__PURE__*/ S.suspend(() =>
+    S.Struct({
+      favicon_url: S.optional(S.NullOr(S.String)),
+      logo_url: S.optional(S.NullOr(S.String)),
+      logo_url_dark: S.optional(S.NullOr(S.String)),
+    }).pipe(
+      T.Http({ method: "PATCH", uri: "/update/ui_theme_settings", code: 200 }),
+    ),
+  ).annotate({
+    identifier: "UpdateUiThemeSettingsUpdateUiThemeSettingsPatchRequest",
+  }) as any as S.Schema<UpdateUiThemeSettingsUpdateUiThemeSettingsPatchRequest>;
+
+export interface UpdateUiThemeSettingsUpdateUiThemeSettingsPatchResponse {
+  body: unknown;
+}
+export const UpdateUiThemeSettingsUpdateUiThemeSettingsPatchResponse =
+  /*@__PURE__*/ S.suspend(() =>
+    S.Struct({
+      body: S.Unknown,
+    }),
+  ).annotate({
+    identifier: "UpdateUiThemeSettingsUpdateUiThemeSettingsPatchResponse",
+  }) as any as S.Schema<UpdateUiThemeSettingsUpdateUiThemeSettingsPatchResponse>;
+
+export interface UploadLogoUploadLogoPostRequest {
+  file: string;
+}
+export const UploadLogoUploadLogoPostRequest = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    file: S.String,
+  }).pipe(
+    T.Http({
+      method: "POST",
+      uri: "/upload/logo",
+      code: 200,
+      contentType: "multipart",
+    }),
+  ),
+).annotate({
+  identifier: "UploadLogoUploadLogoPostRequest",
+}) as any as S.Schema<UploadLogoUploadLogoPostRequest>;
+
+export interface UploadLogoUploadLogoPostResponse {
+  body: unknown;
+}
+export const UploadLogoUploadLogoPostResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    body: S.Unknown,
+  }),
+).annotate({
+  identifier: "UploadLogoUploadLogoPostResponse",
+}) as any as S.Schema<UploadLogoUploadLogoPostResponse>;
+
+export type GetUiThemeSettingsGetUiThemeSettingsGetError = LitellmOpError;
+/** Get Ui Theme Settings Get UI theme configuration from the litellm_settings. Returns current logo settings for UI customization. Note: This endpoint is public (no authentication required) so all users can see custom branding. Only the /update/ui_theme_settings endpoint requires authentication for admins to change settings. */
+export const getUiThemeSettingsGetUiThemeSettingsGet: API.OperationMethod<
+  GetUiThemeSettingsGetUiThemeSettingsGetRequest,
+  UIThemeSettingsResponse,
+  GetUiThemeSettingsGetUiThemeSettingsGetError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: GetUiThemeSettingsGetUiThemeSettingsGetRequest,
+  output: UIThemeSettingsResponse,
+  errors: [],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type UpdateUiThemeSettingsUpdateUiThemeSettingsPatchError =
+  | UnprocessableEntity
+  | LitellmOpError;
+/** Update Ui Theme Settings Update UI theme configuration. Updates logo settings for the admin UI. */
+export const updateUiThemeSettingsUpdateUiThemeSettingsPatch: API.OperationMethod<
+  UpdateUiThemeSettingsUpdateUiThemeSettingsPatchRequest,
+  UpdateUiThemeSettingsUpdateUiThemeSettingsPatchResponse,
+  UpdateUiThemeSettingsUpdateUiThemeSettingsPatchError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: UpdateUiThemeSettingsUpdateUiThemeSettingsPatchRequest,
+  output: UpdateUiThemeSettingsUpdateUiThemeSettingsPatchResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));
+
+export type UploadLogoUploadLogoPostError =
+  | UnprocessableEntity
+  | LitellmOpError;
+/** Upload Logo Upload a custom logo for the admin UI. Accepts image files (PNG, JPG, JPEG, SVG) and stores them for use in the UI. */
+export const uploadLogoUploadLogoPost: API.OperationMethod<
+  UploadLogoUploadLogoPostRequest,
+  UploadLogoUploadLogoPostResponse,
+  UploadLogoUploadLogoPostError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: UploadLogoUploadLogoPostRequest,
+  output: UploadLogoUploadLogoPostResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));

package/src/services/usage_ai.ts

@@ -0,0 +1,86 @@
+// 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 type ChatMessageRole = "user" | "assistant";
+export const ChatMessageRole = S.String;
+
+export interface ChatMessage {
+  content: string;
+  role: ChatMessageRole | (string & {});
+}
+export const ChatMessage = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    content: S.String,
+    role: ChatMessageRole,
+  }),
+).annotate({ identifier: "ChatMessage" }) as any as S.Schema<ChatMessage>;
+
+/** Chat messages (user/assistant history) */
+export type PostUsageAiChatUsageAiChatRequestMessagesList = Array<ChatMessage>;
+export const PostUsageAiChatUsageAiChatRequestMessagesList =
+  /*@__PURE__*/ S.Array(
+    ChatMessage,
+  ) as any as S.Schema<PostUsageAiChatUsageAiChatRequestMessagesList>;
+
+export interface PostUsageAiChatUsageAiChatRequest {
+  /** Chat messages (user/assistant history) */
+  messages: PostUsageAiChatUsageAiChatRequestMessagesList;
+  /** Model to use for AI chat */
+  model?: string | null;
+}
+export const PostUsageAiChatUsageAiChatRequest = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    messages: PostUsageAiChatUsageAiChatRequestMessagesList,
+    model: S.optional(S.NullOr(S.String)),
+  }).pipe(T.Http({ method: "POST", uri: "/usage/ai/chat", code: 200 })),
+).annotate({
+  identifier: "PostUsageAiChatUsageAiChatRequest",
+}) as any as S.Schema<PostUsageAiChatUsageAiChatRequest>;
+
+export interface PostUsageAiChatUsageAiChatResponse {
+  body: unknown;
+}
+export const PostUsageAiChatUsageAiChatResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    body: S.Unknown,
+  }),
+).annotate({
+  identifier: "PostUsageAiChatUsageAiChatResponse",
+}) as any as S.Schema<PostUsageAiChatUsageAiChatResponse>;
+
+export type PostUsageAiChatUsageAiChatError =
+  | UnprocessableEntity
+  | LitellmOpError;
+/** Usage Ai Chat AI chat about usage data. Streams SSE events with the AI response. The AI agent has access to tools that query aggregated daily activity data. */
+export const postUsageAiChatUsageAiChat: API.OperationMethod<
+  PostUsageAiChatUsageAiChatRequest,
+  PostUsageAiChatUsageAiChatResponse,
+  PostUsageAiChatUsageAiChatError,
+  LitellmOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: PostUsageAiChatUsageAiChatRequest,
+  output: PostUsageAiChatUsageAiChatResponse,
+  errors: [UnprocessableEntity],
+  protocol: LitellmProtocol,
+  retry: Retry.Retry,
+}));