"use client"; import { CheckIcon } from "lucide-react"; import { Radio as RadioPrimitive } from "@base-ui/react/radio"; import { useCallback, useMemo, useReducer } from "react"; import { ProviderInstanceId, ProviderDriverKind, type ProviderInstanceConfig, } from "@t3tools/contracts"; import { useSettings, useUpdateSettings } from "../../hooks/useSettings"; import { cn } from "../../lib/utils"; import { normalizeProviderAccentColor } from "../../providerInstances"; import { Button } from "../ui/button"; import { ACPRegistryIcon, Gemini, GithubCopilotIcon, PiAgentIcon, type Icon } from "../Icons"; import { Dialog, DialogDescription, DialogFooter, DialogHeader, DialogPopup, DialogTitle, } from "../ui/dialog"; import { Badge } from "../ui/badge"; import { Input } from "../ui/input"; import { RadioGroup } from "../ui/radio-group"; import { toastManager } from "../ui/toast"; import { DRIVER_OPTION_BY_VALUE, DRIVER_OPTIONS } from "./providerDriverMeta"; import { ProviderSettingsForm, deriveProviderSettingsFields } from "./ProviderSettingsForm"; import { AnimatedHeight } from "../AnimatedHeight"; const PROVIDER_ACCENT_SWATCHES = [ "#2563eb", "#16a34a", "#ea580c", "#dc2626", "#7c3aed", "#0891b2", ] as const; /** * Normalize a user-provided label into a slug suffix for the instance id. * The full id is formed by prefixing the driver slug — e.g. label "Work" on * driver "codex" becomes `codex_work`. Output is trimmed to 48 chars so the * final composed id stays under the 64-char slug cap enforced by * `ProviderInstanceId` in `@t3tools/contracts`. */ function slugifyLabel(value: string): string { return value .trim() .toLowerCase() .replace(/[^a-z0-9]+/g, "_") .replace(/^_+|_+$/g, "") .slice(0, 48); } function deriveInstanceId(driver: ProviderDriverKind, label: string): string { const slug = slugifyLabel(label); return slug ? `${driver}_${slug}` : ""; } const INSTANCE_ID_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]*$/; const DEFAULT_DRIVER_KIND = ProviderDriverKind.make("codex"); const DEFAULT_DRIVER_OPTION = DRIVER_OPTIONS[0]!; const EMPTY_CONFIG_DRAFT: Record = {}; const WIZARD_STEPS = ["Driver", "Identity", "Config"] as const; interface ComingSoonDriverOption { readonly value: ProviderDriverKind; readonly label: string; readonly icon: Icon; } const COMING_SOON_DRIVER_OPTIONS: readonly ComingSoonDriverOption[] = [ { value: ProviderDriverKind.make("githubCopilot"), label: "Github Copilot", icon: GithubCopilotIcon, }, { value: ProviderDriverKind.make("gemini"), label: "Gemini", icon: Gemini, }, { value: ProviderDriverKind.make("acpRegistry"), label: "ACP Registry", icon: ACPRegistryIcon, }, { value: ProviderDriverKind.make("piAgent"), label: "Pi Agent", icon: PiAgentIcon, }, ]; /** * Validate an instance id against the same slug rules the server applies in * `ProviderInstanceId` (see `packages/contracts/src/providerInstance.ts`). * Returns a user-facing error string, or `null` if valid. */ function validateInstanceId(id: string, existing: ReadonlySet): string | null { if (id.length === 0) return "Instance ID is required."; if (id.length > 64) return "Instance ID must be 64 characters or fewer."; if (!INSTANCE_ID_PATTERN.test(id)) { return "Instance ID must start with a letter and use only letters, digits, '-', or '_'."; } if (existing.has(id)) return `An instance named '${id}' already exists.`; return null; } interface AddProviderInstanceDialogProps { open: boolean; onOpenChange: (open: boolean) => void; } interface AddProviderInstanceDraftState { readonly wizardStep: number; readonly driver: ProviderDriverKind; readonly label: string; readonly accentColor: string; readonly manualInstanceId: string; readonly instanceIdDirty: boolean; readonly configByDriver: Record>; readonly hasAttemptedSubmit: boolean; } type AddProviderInstanceDraftAction = | { readonly type: "setWizardStep"; readonly step: number } | { readonly type: "setDriver"; readonly driver: ProviderDriverKind } | { readonly type: "setLabel"; readonly label: string } | { readonly type: "setAccentColor"; readonly accentColor: string } | { readonly type: "setManualInstanceId"; readonly instanceId: string } | { readonly type: "setConfigDraft"; readonly driver: ProviderDriverKind; readonly config: Record | undefined; } | { readonly type: "markAttemptedSubmit" }; function createInitialAddProviderInstanceDraftState(): AddProviderInstanceDraftState { return { wizardStep: 0, driver: DEFAULT_DRIVER_KIND, label: "", accentColor: "", manualInstanceId: "", instanceIdDirty: false, configByDriver: {}, hasAttemptedSubmit: false, }; } function addProviderInstanceDraftReducer( state: AddProviderInstanceDraftState, action: AddProviderInstanceDraftAction, ): AddProviderInstanceDraftState { switch (action.type) { case "setWizardStep": return state.wizardStep === action.step ? state : { ...state, wizardStep: action.step }; case "setDriver": return state.driver === action.driver ? state : { ...state, driver: action.driver }; case "setLabel": return state.label === action.label ? state : { ...state, label: action.label }; case "setAccentColor": return state.accentColor === action.accentColor ? state : { ...state, accentColor: action.accentColor }; case "setManualInstanceId": return state.manualInstanceId === action.instanceId && state.instanceIdDirty ? state : { ...state, manualInstanceId: action.instanceId, instanceIdDirty: true }; case "setConfigDraft": { const next = { ...state.configByDriver }; if (action.config === undefined || Object.keys(action.config).length === 0) { delete next[action.driver]; } else { next[action.driver] = action.config; } return { ...state, configByDriver: next }; } case "markAttemptedSubmit": return state.hasAttemptedSubmit ? state : { ...state, hasAttemptedSubmit: true }; } } export function AddProviderInstanceDialog({ open, onOpenChange }: AddProviderInstanceDialogProps) { return ( {open ? : null} ); } function AddProviderInstanceDialogContent({ onOpenChange, }: Pick) { const settings = useSettings(); const { updateSettings } = useUpdateSettings(); const [draft, dispatch] = useReducer( addProviderInstanceDraftReducer, undefined, createInitialAddProviderInstanceDraftState, ); const { wizardStep, driver, label, accentColor, manualInstanceId, instanceIdDirty, configByDriver, hasAttemptedSubmit, } = draft; const existingIds = useMemo( () => new Set(Object.keys(settings.providerInstances ?? {})), [settings.providerInstances], ); const driverOption = DRIVER_OPTION_BY_VALUE[driver] ?? DEFAULT_DRIVER_OPTION; const driverSettingsFields = useMemo( () => deriveProviderSettingsFields(driverOption), [driverOption], ); const derivedInstanceId = deriveInstanceId(driver, label); const instanceId = instanceIdDirty ? manualInstanceId : derivedInstanceId; const instanceIdError = validateInstanceId(instanceId, existingIds); const showInstanceIdError = hasAttemptedSubmit && instanceIdError !== null; const previewLabel = label.trim() || `${driverOption.label} Workspace`; const wizardStepSummaries = [driverOption.label, previewLabel, null] as const; const configDraft = configByDriver[driver] ?? EMPTY_CONFIG_DRAFT; const setConfigDraft = useCallback( (config: Record | undefined) => { dispatch({ type: "setConfigDraft", driver, config }); }, [driver], ); const handleSave = useCallback(() => { dispatch({ type: "markAttemptedSubmit" }); if (instanceIdError !== null) return; const config = configByDriver[driver] ?? {}; const hasConfig = Object.keys(config).length > 0; const normalizedAccentColor = normalizeProviderAccentColor(accentColor); const nextInstance: ProviderInstanceConfig = { driver, enabled: true, ...(label.trim().length > 0 ? { displayName: label.trim() } : {}), ...(normalizedAccentColor ? { accentColor: normalizedAccentColor } : {}), ...(hasConfig ? { config } : {}), }; // `ProviderInstanceId.make` revalidates the slug; we've already checked // it via `validateInstanceId`, but going through the brand constructor // keeps the type boundary honest and guards against any future drift in // the slug rules. const brandedId = ProviderInstanceId.make(instanceId); const nextMap = { ...settings.providerInstances, [brandedId]: nextInstance, }; try { updateSettings({ providerInstances: nextMap }); toastManager.add({ type: "success", title: "Provider instance added", description: `${driverOption.label} instance '${instanceId}' was added.`, }); onOpenChange(false); } catch (error) { toastManager.add({ type: "error", title: "Could not add provider instance", description: error instanceof Error ? error.message : "Update failed.", }); } }, [ driver, driverOption, configByDriver, instanceId, instanceIdError, label, accentColor, onOpenChange, settings.providerInstances, updateSettings, ]); return (
dispatch({ type: "setWizardStep", step })} /> dispatch({ type: "setLabel", label: nextLabel })} instanceId={instanceId} instanceIdError={instanceIdError} showInstanceIdError={showInstanceIdError} onInstanceIdChange={(nextInstanceId) => dispatch({ type: "setManualInstanceId", instanceId: nextInstanceId }) } accentColor={accentColor} onAccentColorChange={(nextAccentColor) => dispatch({ type: "setAccentColor", accentColor: nextAccentColor }) } onDriverChange={(nextDriver) => dispatch({ type: "setDriver", driver: nextDriver })} configDraft={configDraft} onConfigDraftChange={setConfigDraft} /> { if (wizardStep === 0) { onOpenChange(false); return; } dispatch({ type: "setWizardStep", step: Math.max(0, wizardStep - 1) }); }} onNext={() => dispatch({ type: "setWizardStep", step: Math.min(WIZARD_STEPS.length - 1, wizardStep + 1), }) } onSave={handleSave} />
); } function AddProviderInstanceDialogHeader(props: { wizardStep: number; wizardStepSummaries: readonly (string | null)[]; onStepSelect: (step: number) => void; }) { return ( Add provider instance Configure an additional provider instance — for example, a second Codex install pointed at a different workspace.
{WIZARD_STEPS.map((step, index) => ( ))}
); } function AddProviderInstanceDialogPanel(props: { wizardStep: number; driver: ProviderDriverKind; driverOption: typeof DEFAULT_DRIVER_OPTION; driverSettingsFields: ReturnType; label: string; onLabelChange: (label: string) => void; instanceId: string; instanceIdError: string | null; showInstanceIdError: boolean; onInstanceIdChange: (instanceId: string) => void; accentColor: string; onAccentColorChange: (accentColor: string) => void; onDriverChange: (driver: ProviderDriverKind) => void; configDraft: Record; onConfigDraftChange: (config: Record | undefined) => void; }) { return (
); } function AddProviderInstanceDriverStep(props: { active: boolean; driver: ProviderDriverKind; onDriverChange: (driver: ProviderDriverKind) => void; }) { return (
Driver props.onDriverChange(ProviderDriverKind.make(value))} aria-labelledby="add-instance-driver-label" className="grid grid-cols-2 gap-2.5" > {DRIVER_OPTIONS.map((option) => { const IconComponent = option.icon; const isSelected = option.value === props.driver; return ( {option.label} {option.badgeLabel ? ( {option.badgeLabel} ) : null} ); })} {COMING_SOON_DRIVER_OPTIONS.map((option) => { const IconComponent = option.icon; return ( {option.label} Coming Soon ); })}
); } function AddProviderInstanceIdentityStep(props: { active: boolean; driver: ProviderDriverKind; label: string; onLabelChange: (label: string) => void; instanceId: string; instanceIdError: string | null; showInstanceIdError: boolean; onInstanceIdChange: (instanceId: string) => void; accentColor: string; onAccentColorChange: (accentColor: string) => void; }) { return ( <>
Accent color
props.onAccentColorChange(event.target.value)} aria-label="Provider instance accent color" className="h-8 w-10 cursor-pointer rounded-xl border border-input bg-background p-0.5" />
{PROVIDER_ACCENT_SWATCHES.map((swatch) => { const selected = props.accentColor.toLowerCase() === swatch; return (
{props.accentColor ? ( ) : null}
Optional marker shown in the picker.
); } function AddProviderInstanceConfigStep(props: { active: boolean; driver: ProviderDriverKind; driverOption: typeof DEFAULT_DRIVER_OPTION; driverSettingsFields: ReturnType; configDraft: Record; onConfigDraftChange: (config: Record | undefined) => void; }) { if (props.driverSettingsFields.length > 0) { return (
); } if (!props.active) { return null; } return (

This driver has no required configuration. You can add the instance now.

); } function AddProviderInstanceDialogFooter(props: { wizardStep: number; onBack: () => void; onNext: () => void; onSave: () => void; }) { return ( {props.wizardStep < WIZARD_STEPS.length - 1 ? ( ) : ( )} ); }