"use client"; import { ArrowUpCircleIcon, ChevronDownIcon, CopyIcon, DownloadIcon, LoaderIcon, PlusIcon, Trash2Icon, XIcon, } from "lucide-react"; import * as Arr from "effect/Array"; import * as Result from "effect/Result"; import { 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 { useCopyToClipboard } from "../../hooks/useCopyToClipboard"; import { normalizeProviderAccentColor } from "../../providerInstances"; import { Badge } from "../ui/badge"; import { Button } from "../ui/button"; import { Checkbox } from "../ui/checkbox"; import { Collapsible, CollapsibleContent } from "../ui/collapsible"; import { DraftInput } from "../ui/draft-input"; import { Popover, PopoverPopup, PopoverTrigger } from "../ui/popover"; import { ScrollArea } from "../ui/scroll-area"; import { Switch } from "../ui/switch"; import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "../ui/table"; import { stackedThreadToast, toastManager } from "../ui/toast"; 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 { ProviderAccentColorPicker } from "./ProviderAccentColorPicker"; import { RedactedSensitiveText } from "./RedactedSensitiveText"; import { getProviderVersionAdvisoryPresentation, PROVIDER_STATUS_STYLES, getProviderSummary, getProviderVersionLabel, type ProviderStatusKey, } from "./providerStatus"; 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( Arr.filterMap(input.liveModels ?? [], (model) => model.isCustom ? Result.succeed([model.slug, model] as const) : Result.failVoid, ), ); 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 ProviderEnvironmentSection(props: { readonly environment: ReadonlyArray; readonly onChange: (environment: ReadonlyArray) => void; }) { const [rows, setRows] = useState>(() => props.environment.map(makeEnvironmentDraftRow), ); 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.

) : (
Variable Value Sensitive Options {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}`} />
{ const sensitive = Boolean(checked); updateVariable(variable.id, { sensitive, ...(sensitive && variable.valueRedacted === undefined ? {} : { valueRedacted: sensitive ? variable.valueRedacted : false }), }); }} aria-label={`Mark environment variable ${variable.name || index + 1} as sensitive`} />
))}
)} 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; readonly onRunUpdate?: (() => void) | undefined; readonly isUpdating?: boolean | undefined; } /** * 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, onRunUpdate, isUpdating = false, }: 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 versionAdvisory = getProviderVersionAdvisoryPresentation(liveProvider?.versionAdvisory); const updateCommand = versionAdvisory?.updateCommand ?? null; const FallbackIconComponent = driverOption?.icon; const displayName = instance.displayName?.trim() || driverOption?.label || String(instance.driver); const accentColor = normalizeProviderAccentColor(instance.accentColor); const { copyToClipboard } = useCopyToClipboard<{ providerName: string }>({ onCopy: ({ providerName }) => { toastManager.add({ type: "success", title: `${providerName} update command copied`, description: "Run it in a terminal when you are ready to update.", }); }, onError: (error, { providerName }) => { toastManager.add( stackedThreadToast({ type: "error", title: `Could not copy ${providerName} update command`, description: error.message, }), ); }, }); // 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), ); }; const titleIconNode = driverKind ? ( ) : FallbackIconComponent ? ( ) : ( ); const titleHeadNode = ( <> {titleIconNode}

{displayName}

{String(instanceId) !== String(instance.driver) ? ( {instanceId} ) : null} {driverOption?.badgeLabel ? ( {driverOption.badgeLabel} ) : null} ); const titleTailNode = ( <> {headerAction ? ( {headerAction} ) : null} {onDelete ? ( } /> Delete instance ) : null} ); const authRowNode = (

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

); const versionCodeNode = versionLabel ? ( {versionLabel} ) : null; return (
{titleHeadNode} {versionCodeNode} {versionAdvisory ? ( } />

Update available

{versionAdvisory.detail}

{onRunUpdate ? ( ) : null} {onRunUpdate && updateCommand ? (
or, update manually using
) : null} {updateCommand ? (
{updateCommand} copyToClipboard(updateCommand, { providerName: displayName, }) } aria-label="Copy update command" > } /> Copy command
) : null}
) : null} {titleTailNode}
{authRowNode}
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.

)}
); }