"use client"; import { Radio as RadioPrimitive } from "@base-ui/react/radio"; import { CheckIcon } from "lucide-react"; import { useMemo, useState } from "react"; import { ProviderInstanceId, ProviderDriverKind, type EnvironmentId, type ProviderInstanceConfig, } from "@t3tools/contracts"; import { useEnvironmentSettings, useUpdateEnvironmentSettings } 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 } 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 { WizardPanel, WizardPopup, WizardHeader, WizardFooter } from "../ui/wizard"; import { ADD_PROVIDER_WIZARD_STEPS, resolveWizardNavigation, type WizardNavigation, } from "./AddProviderInstanceDialog.logic"; import { AddProviderInstanceWizardSteps } from "./AddProviderInstanceWizardSteps"; 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 = {}; 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 { readonly open: boolean; readonly environmentId: EnvironmentId; readonly environmentLabel: string; readonly onOpenChange: (open: boolean) => void; } export function AddProviderInstanceDialog({ open, environmentId, environmentLabel, onOpenChange, }: AddProviderInstanceDialogProps) { const settings = useEnvironmentSettings(environmentId); const updateSettings = useUpdateEnvironmentSettings(environmentId); const [wizardStep, setWizardStep] = useState(0); const [driver, setDriver] = useState(DEFAULT_DRIVER_KIND); const [label, setLabel] = useState(""); const [accentColor, setAccentColor] = useState(""); const [instanceIdOverride, setInstanceIdOverride] = useState(null); // Driver-specific config drafts keyed by driver so toggling between drivers // during the same dialog session does not lose in-progress input. const [configByDriver, setConfigByDriver] = useState>>({}); // Errors are suppressed until the user has tried to submit once. After that // they update live so fixing the problem clears the message in place. const [hasAttemptedSubmit, setHasAttemptedSubmit] = useState(false); const existingIds = useMemo( () => new Set(Object.keys(settings.providerInstances ?? {})), [settings.providerInstances], ); const driverOption = DRIVER_OPTION_BY_VALUE[driver] ?? DEFAULT_DRIVER_OPTION; const instanceId = instanceIdOverride ?? deriveInstanceId(driver, label); const driverSettingsFields = useMemo( () => deriveProviderSettingsFields(driverOption), [driverOption], ); 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 = (config: Record | undefined) => { setConfigByDriver((existing) => { const next = { ...existing }; if (config === undefined || Object.keys(config).length === 0) { delete next[driver]; } else { next[driver] = config; } return next; }); }; const applyWizardNavigation = (navigation: WizardNavigation) => { if (navigation.kind === "blocked") { setHasAttemptedSubmit(true); } setWizardStep(navigation.step); }; const navigateToStep = (requestedStep: number) => { applyWizardNavigation( resolveWizardNavigation(wizardStep, requestedStep, ADD_PROVIDER_WIZARD_STEPS.length, { instanceIdError, }), ); }; const handleSave = () => { setHasAttemptedSubmit(true); 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.", }); } }; return ( Configure an additional provider instance on {environmentLabel} — for example, a second Codex install pointed at a different workspace. } >
Driver
setDriver(ProviderDriverKind.make(value))} aria-labelledby="add-instance-driver-label" className="grid grid-cols-1 gap-2 sm:grid-cols-2" > {DRIVER_OPTIONS.map((option) => { const IconComponent = option.icon; return ( {option.label} {option.badgeLabel ? ( {option.badgeLabel} ) : null} ); })} {COMING_SOON_DRIVER_OPTIONS.map((option) => { const IconComponent = option.icon; return ( {option.label} Coming Soon ); })}
Accent color
setAccentColor(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 = accentColor.toLowerCase() === swatch; return (
{accentColor ? ( ) : null}
Optional marker shown in the picker.
{driverSettingsFields.length > 0 ? (
) : wizardStep === 2 ? (

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

) : null}
{wizardStep < ADD_PROVIDER_WIZARD_STEPS.length - 1 ? ( ) : ( )}
); }