"use client"; import { ChevronDownIcon, PlusIcon, Trash2Icon, XIcon } from "lucide-react"; import { useEffect, useState, type ReactNode } from "react"; import { isProviderDriverKind, type ProviderInstanceConfig, type ProviderInstanceEnvironmentVariable, type ProviderInstanceId, type ProviderDriverKind, type ServerProvider, type ServerProviderModel, } from "@t3tools/contracts"; import { cn } from "../../lib/utils"; import { normalizeProviderAccentColor } from "../../providerInstances"; import { Badge } from "../ui/badge"; import { Button } from "../ui/button"; import { Collapsible, CollapsibleContent } from "../ui/collapsible"; import { DraftInput } from "../ui/draft-input"; import { Switch } from "../ui/switch"; import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip"; import type { DriverOption } from "./providerDriverMeta"; import { ProviderSettingsForm } from "./ProviderSettingsForm"; import { ProviderModelsSection } from "./ProviderModelsSection"; import { ProviderInstanceIcon } from "../chat/ProviderInstanceIcon"; import { RedactedSensitiveText } from "./RedactedSensitiveText"; import { PROVIDER_STATUS_STYLES, getProviderSummary, getProviderVersionLabel, type ProviderStatusKey, } from "./providerStatus"; const PROVIDER_ACCENT_SWATCHES = [ "#2563eb", "#16a34a", "#ea580c", "#dc2626", "#7c3aed", "#0891b2", ] as const; const ENVIRONMENT_VARIABLE_NAME_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/; let environmentVariableDraftId = 0; const nextEnvironmentVariableDraftId = () => `provider-env-${environmentVariableDraftId++}`; type EnvironmentDraftRow = { readonly id: string; readonly name: string; readonly value: string; readonly sensitive: boolean; readonly valueRedacted?: boolean; }; function makeEnvironmentDraftRow( variable: ProviderInstanceEnvironmentVariable, index: number, ): EnvironmentDraftRow { return { id: `${index}:${variable.name}`, name: variable.name, value: variable.value, sensitive: variable.sensitive, ...(variable.valueRedacted !== undefined ? { valueRedacted: variable.valueRedacted } : {}), }; } /** * Read a string[] at `key` from the opaque config blob, filtering out * non-string entries. Used for `customModels`, which is always typed as * `string[]` by the concrete driver schemas but arrives here as * `Schema.Unknown`. */ function readConfigStringArray(config: unknown, key: string): ReadonlyArray { if (config === null || typeof config !== "object") return []; const value = (config as Record)[key]; if (!Array.isArray(value)) return []; return value.filter((entry): entry is string => typeof entry === "string"); } /** * Set `key` to an arbitrary value on the opaque config blob. Unlike * provider settings field updates, does not drop empty-looking values — the * caller is responsible for deciding whether an empty array / empty * object should be stored explicitly (e.g. `customModels: []` is a * meaningful "user cleared their custom list" state distinct from * "driver default"). */ function nextConfigBlobWithValue( config: unknown, key: string, value: unknown, ): Record { const base: Record = config !== null && typeof config === "object" ? { ...(config as Record) } : {}; base[key] = value; return base; } export function deriveProviderModelsForDisplay(input: { readonly liveModels: ReadonlyArray | undefined; readonly customModels: ReadonlyArray; }): ReadonlyArray { const liveCustomModelsBySlug = new Map( (input.liveModels ?? []) .filter((model) => model.isCustom) .map((model) => [model.slug, model] as const), ); const serverModels = input.liveModels?.filter((model) => !model.isCustom) ?? []; const customModels = input.customModels.map( (slug) => liveCustomModelsBySlug.get(slug) ?? { slug, name: slug, isCustom: true, capabilities: null, }, ); return [...serverModels, ...customModels]; } function ProviderAuthEmail(props: { readonly email: string | undefined; readonly prefix?: string; readonly separator?: boolean; }) { const trimmed = props.email?.trim(); if (!trimmed) return null; return ( {props.separator ? · : null} {props.prefix ? {props.prefix} : null} ); } function ProviderAccentColorPicker(props: { readonly displayName: string; readonly value: string | undefined; readonly onCommit: (value: string) => void; }) { const [draft, setDraft] = useState(props.value ?? ""); const [isEditing, setIsEditing] = useState(false); const draftColor = normalizeProviderAccentColor(draft); useEffect(() => { if (isEditing) return; setDraft(props.value ?? ""); }, [isEditing, props.value]); const commitDraft = () => { setIsEditing(false); props.onCommit(draftColor ?? ""); }; const commitSwatch = (swatch: string) => { setIsEditing(false); setDraft(swatch); props.onCommit(swatch); }; return (
Accent color
setIsEditing(true)} onInput={(event) => { setIsEditing(true); setDraft(event.currentTarget.value); }} onChange={(event) => { setIsEditing(true); setDraft(event.currentTarget.value); }} onBlur={commitDraft} aria-label={`Accent color for ${props.displayName}`} className="h-8 w-10 cursor-pointer rounded border border-input bg-background p-0.5" />
{PROVIDER_ACCENT_SWATCHES.map((swatch) => { const selected = draftColor?.toLowerCase() === swatch; return (
{draftColor ? ( ) : null}
Used to distinguish this instance in picker rails and model lists.
); } function ProviderEnvironmentSection(props: { readonly environment: ReadonlyArray; readonly onChange: (environment: ReadonlyArray) => void; }) { const [rows, setRows] = useState>(() => props.environment.map(makeEnvironmentDraftRow), ); useEffect(() => { setRows(props.environment.map(makeEnvironmentDraftRow)); }, [props.environment]); const publishRows = (nextRows: ReadonlyArray) => { const published: ProviderInstanceEnvironmentVariable[] = []; for (const row of nextRows) { const name = row.name.trim(); if (!ENVIRONMENT_VARIABLE_NAME_PATTERN.test(name)) { if ( name.length > 0 || row.value.length > 0 || row.sensitive !== true || row.valueRedacted !== undefined ) { return; } continue; } const { id: _id, ...rest } = row; published.push({ ...rest, name }); } props.onChange(published); }; const updateVariable = (id: string, patch: Partial>) => { const nextRows = rows.map((row) => row.id === id ? { ...row, ...patch, ...(patch.value !== undefined ? { valueRedacted: false } : {}), } : row, ); setRows(nextRows); publishRows(nextRows); }; const removeVariable = (id: string) => { const nextRows = rows.filter((row) => row.id !== id); setRows(nextRows); publishRows(nextRows); }; return (
Environment variables
{rows.length === 0 ? (

Add variables to pass API keys, base URLs, or other per-instance CLI settings.

) : (
{rows.map((variable, index) => (
updateVariable(variable.id, { name: name.trim() })} placeholder="VARIABLE_NAME" spellCheck={false} aria-label={`Environment variable name ${index + 1}`} /> updateVariable(variable.id, { value })} type={variable.sensitive ? "password" : undefined} autoComplete="off" placeholder={ variable.valueRedacted ? "Stored secret - enter a new value to replace" : "Value" } spellCheck={false} aria-label={`Environment variable value ${index + 1}`} />
))}
)} Sensitive values are stored separately and are not returned to the app after saving.
); } interface ProviderInstanceCardProps { readonly instanceId: ProviderInstanceId; readonly instance: ProviderInstanceConfig; readonly driverOption: DriverOption | undefined; readonly liveProvider: ServerProvider | undefined; readonly isExpanded: boolean; readonly onExpandedChange: (open: boolean) => void; readonly onUpdate: (nextInstance: ProviderInstanceConfig) => void; /** * Pass `undefined` to hide the delete button entirely. Built-in default * instance slots use `undefined` — they can't be deleted without losing * the slot, and their "reset to defaults" affordance lives on an outer * reset button instead. Explicit `| undefined` in the type accommodates * `exactOptionalPropertyTypes: true`, where an absent key and * `{ onDelete: undefined }` are treated as distinct shapes. */ readonly onDelete?: (() => void) | undefined; /** * Optional outer reset button rendered next to the driver icon. Built-in * default slots supply a reset-to-factory control here; custom instances * omit it. */ readonly headerAction?: ReactNode | undefined; readonly hiddenModels: ReadonlyArray; readonly favoriteModels: ReadonlyArray; readonly modelOrder: ReadonlyArray; readonly onHiddenModelsChange: (next: ReadonlyArray) => void; readonly onFavoriteModelsChange: (next: ReadonlyArray) => void; readonly onModelOrderChange: (next: ReadonlyArray) => void; } /** * A single configured provider-instance row in the Providers settings * section. Used for every row — both the built-in default instance for a * driver (rendered with `onDelete` omitted) and user-authored custom * instances (`onDelete` supplied). The only UI difference between the two * is whether the trash button is visible; every other field (display * name, config fields, models) behaves identically. * * Behavior notes: * - `liveProvider` is matched by the caller via `instanceId`; when no * match is available (e.g. the server hasn't probed yet, or the * driver is not shipped by the current build) the card still renders * with a neutral "checking" summary. * - Unknown drivers (`driverOption === undefined`) get a read-only * notice instead of editable fields, so fork instances round-trip * without accidentally destroying their config. * - The enabled Switch writes to the envelope's `instance.enabled` * field; the server's registry consults this at `entry.enabled ?? true` * before materializing the instance, and the probe also checks its * driver-specific `config.enabled`. We treat the envelope flag as the * single source of truth from the UI — built-in cards used to write * the inner flag, but on the promotion-to-instance path every edit * flows through the envelope. */ export function ProviderInstanceCard({ instanceId, instance, driverOption, liveProvider, isExpanded, onExpandedChange, onUpdate, onDelete, headerAction, hiddenModels, favoriteModels, modelOrder, onHiddenModelsChange, onFavoriteModelsChange, onModelOrderChange, }: ProviderInstanceCardProps) { const enabled = instance.enabled ?? true; // The server-reported status wins when present; otherwise fall back to // "disabled"/"warning" based on the local `enabled` flag so the dot // reflects the persisted intent even before the first probe completes. const statusKey: ProviderStatusKey = (liveProvider?.status as ProviderStatusKey | undefined) ?? (enabled ? "warning" : "disabled"); const statusStyle = PROVIDER_STATUS_STYLES[statusKey]; const rawSummary = getProviderSummary(liveProvider); const authEmail = liveProvider?.auth.email; const hasAuthenticatedEmail = liveProvider?.auth.status === "authenticated" && Boolean(authEmail?.trim()); const authenticatedDetail = hasAuthenticatedEmail ? (liveProvider?.auth.label ?? liveProvider?.auth.type ?? null) : null; const summary = rawSummary; const versionLabel = getProviderVersionLabel(liveProvider?.version); const FallbackIconComponent = driverOption?.icon; const displayName = instance.displayName?.trim() || driverOption?.label || String(instance.driver); const accentColor = normalizeProviderAccentColor(instance.accentColor); // Narrow `instance.driver` for callers that key on the closed // `ProviderDriverKind` union (e.g. `normalizeModelSlug`'s alias table). Custom // fork drivers pass through as `null` and those callers fall back to // verbatim behaviour. const driverKind: ProviderDriverKind | null = isProviderDriverKind(instance.driver) ? instance.driver : null; const customModels = readConfigStringArray(instance.config, "customModels"); // Server-returned models may lag behind settings writes. Treat probe // models as the source for built-ins only; custom rows come directly // from the current instance config so add/remove reflects immediately. const modelsForDisplay = deriveProviderModelsForDisplay({ liveModels: liveProvider?.models, customModels, }); const updateDisplayName = (value: string) => { const trimmed = value.trim(); const { displayName: _omit, ...rest } = instance; onUpdate( trimmed.length > 0 ? ({ ...rest, displayName: trimmed } as ProviderInstanceConfig) : (rest as ProviderInstanceConfig), ); }; const updateEnabled = (value: boolean) => { onUpdate({ ...instance, enabled: value }); }; const updateAccentColor = (value: string) => { const normalized = normalizeProviderAccentColor(value); const { accentColor: _omit, ...rest } = instance; onUpdate( normalized ? ({ ...rest, accentColor: normalized } as ProviderInstanceConfig) : (rest as ProviderInstanceConfig), ); }; const updateConfig = (nextConfig: Record | undefined) => { const { config: _omit, ...rest } = instance; onUpdate( nextConfig !== undefined ? ({ ...rest, config: nextConfig } as ProviderInstanceConfig) : (rest as ProviderInstanceConfig), ); }; const updateCustomModels = (next: ReadonlyArray) => { const nextConfig = nextConfigBlobWithValue(instance.config, "customModels", [...next]); const { config: _omit, ...rest } = instance; onUpdate({ ...rest, config: nextConfig } as ProviderInstanceConfig); }; const updateEnvironment = (environment: ReadonlyArray) => { const cleaned = environment.filter((variable) => variable.name.trim().length > 0); const { environment: _omit, ...rest } = instance; onUpdate( cleaned.length > 0 ? ({ ...rest, environment: cleaned } as ProviderInstanceConfig) : (rest as ProviderInstanceConfig), ); }; return (
{driverKind ? ( ) : FallbackIconComponent ? ( ) : ( )}

{displayName}

{String(instanceId) !== String(instance.driver) ? ( // Hide the id chip on a default slot whose id === the // driver slug — it's redundant with the driver icon + // label. Custom instances (and any instance the user has // since renamed) keep the chip so their slug stays // visible for copy/paste + disambiguation. {instanceId} ) : null} {driverOption?.badgeLabel ? ( {driverOption.badgeLabel} ) : null} {versionLabel ? ( {versionLabel} ) : null} {headerAction ? ( {headerAction} ) : null} {onDelete ? ( } /> Delete instance ) : null}

{hasAuthenticatedEmail ? ( <> Authenticated as {authenticatedDetail ? · {authenticatedDetail} : null} ) : ( <> {summary.headline} )} {summary.detail ? - {summary.detail} : null}

updateEnabled(Boolean(checked))} aria-label={`Enable ${displayName}`} />
{driverOption ? ( ) : null} {driverOption !== undefined ? ( ) : (

This instance uses a driver ( {String(instance.driver)}) that is not shipped with the current build. Configuration values are preserved but cannot be edited from this surface.

)}
); }