import { useEffect, useState, type ComponentType } from 'react' import { adminApi } from '../../api/client' import { useTranslation } from '../../i18n' import { useSettingsStore } from '../../store/settingsStore' import { useAddonStore } from '../../store/addonStore' import { useToast } from '../shared/Toast' import { Puzzle, ListChecks, Wallet, FileText, CalendarDays, Globe, Briefcase, Image, Terminal, Link2, Compass, BookOpen, MessageCircle, StickyNote, BarChart3, Sparkles, Luggage, Plane, Server, Cloud, Bookmark } from 'lucide-react' import CustomSelect from '../shared/CustomSelect' const ICON_MAP = { ListChecks, Wallet, FileText, CalendarDays, Puzzle, Globe, Briefcase, Image, Terminal, Link2, Compass, BookOpen, Plane, Bookmark, } function ImmichIcon({ size = 14 }: { size?: number }) { return ( ) } function SynologyIcon({ size = 14 }: { size?: number }) { return ( ) } const PROVIDER_ICONS: Record> = { immich: ImmichIcon, synologyphotos: SynologyIcon, } interface Addon { id: string name: string description: string icon: string type: string enabled: boolean config?: Record } interface ProviderOption { key: string label: string description: string enabled: boolean toggle: () => Promise } interface AddonIconProps { name: string size?: number } function AddonIcon({ name, size = 20 }: AddonIconProps) { const Icon = ICON_MAP[name] || Puzzle return } interface CollabFeatures { chat: boolean; notes: boolean; polls: boolean; whatsnext: boolean } const COLLAB_SUB_FEATURES = [ { key: 'chat', icon: MessageCircle, titleKey: 'admin.collab.chat.title', subtitleKey: 'admin.collab.chat.subtitle' }, { key: 'notes', icon: StickyNote, titleKey: 'admin.collab.notes.title', subtitleKey: 'admin.collab.notes.subtitle' }, { key: 'polls', icon: BarChart3, titleKey: 'admin.collab.polls.title', subtitleKey: 'admin.collab.polls.subtitle' }, { key: 'whatsnext', icon: Sparkles, titleKey: 'admin.collab.whatsnext.title', subtitleKey: 'admin.collab.whatsnext.subtitle' }, ] as const export default function AddonManager({ bagTrackingEnabled, onToggleBagTracking, collabFeatures, onToggleCollabFeature }: { bagTrackingEnabled?: boolean; onToggleBagTracking?: () => void; collabFeatures?: CollabFeatures; onToggleCollabFeature?: (key: string) => void }) { const { t } = useTranslation() const dm = useSettingsStore(s => s.settings.dark_mode) const dark = dm === true || dm === 'dark' || (dm === 'auto' && window.matchMedia('(prefers-color-scheme: dark)').matches) const toast = useToast() const refreshGlobalAddons = useAddonStore(s => s.loadAddons) const [addons, setAddons] = useState([]) const [loading, setLoading] = useState(true) useEffect(() => { loadAddons() }, []) const loadAddons = async () => { setLoading(true) try { const data = await adminApi.addons() setAddons(data.addons) } catch (err: unknown) { toast.error(t('admin.addons.toast.error')) } finally { setLoading(false) } } const handleToggle = async (addon: Addon) => { const newEnabled = !addon.enabled // Optimistic update setAddons(prev => prev.map(a => a.id === addon.id ? { ...a, enabled: newEnabled } : a)) try { await adminApi.updateAddon(addon.id, { enabled: newEnabled }) refreshGlobalAddons() toast.success(t('admin.addons.toast.updated')) } catch (err: unknown) { // Rollback setAddons(prev => prev.map(a => a.id === addon.id ? { ...a, enabled: !newEnabled } : a)) toast.error(t('admin.addons.toast.error')) } } const isPhotoProviderAddon = (addon: Addon) => { return addon.type === 'photo_provider' } const isPhotosAddon = (addon: Addon) => { const haystack = `${addon.id} ${addon.name} ${addon.description}`.toLowerCase() return addon.type === 'trip' && (addon.icon === 'Image' || haystack.includes('photo') || haystack.includes('memories')) } const handleTogglePhotoProvider = async (providerAddon: Addon) => { const enableProvider = !providerAddon.enabled const prev = addons setAddons(current => current.map(a => a.id === providerAddon.id ? { ...a, enabled: enableProvider } : a)) try { await adminApi.updateAddon(providerAddon.id, { enabled: enableProvider }) refreshGlobalAddons() toast.success(t('admin.addons.toast.updated')) } catch { setAddons(prev) toast.error(t('admin.addons.toast.error')) } } const photoProviderAddons = addons.filter(isPhotoProviderAddon) const photosAddon = addons.filter(a => a.type === 'trip').find(isPhotosAddon) const tripAddons = addons.filter(a => a.type === 'trip' && !isPhotosAddon(a)) const globalAddons = addons.filter(a => a.type === 'global') const integrationAddons = addons.filter(a => a.type === 'integration') const providerOptions: ProviderOption[] = photoProviderAddons.map((provider) => ({ key: provider.id, label: provider.name, description: provider.description, enabled: provider.enabled, toggle: () => handleTogglePhotoProvider(provider), })) const photosDerivedEnabled = providerOptions.some(p => p.enabled) if (loading) { return (
) } return (
{/* Header */}

{t('admin.addons.title')}

{t('admin.addons.subtitleBefore')}TREK{t('admin.addons.subtitleAfter')}

{addons.length === 0 ? (
{t('admin.addons.noAddons')}
) : (
{/* Trip Addons */} {tripAddons.length > 0 && (
{t('admin.addons.type.trip')} — {t('admin.addons.tripHint')}
{tripAddons.map(addon => (
{addon.id === 'packing' && addon.enabled && onToggleBagTracking && (
{t('admin.bagTracking.title')}
{t('admin.bagTracking.subtitle')}
{bagTrackingEnabled ? t('admin.addons.enabled') : t('admin.addons.disabled')}
)} {addon.id === 'collab' && addon.enabled && collabFeatures && onToggleCollabFeature && (
{COLLAB_SUB_FEATURES.map(feat => { const enabled = collabFeatures[feat.key] const Icon = feat.icon return (
{t(feat.titleKey)}
{t(feat.subtitleKey)}
{enabled ? t('admin.addons.enabled') : t('admin.addons.disabled')}
) })}
)}
))}
)} {/* Global Addons */} {globalAddons.length > 0 && (
{t('admin.addons.type.global')} — {t('admin.addons.globalHint')}
{globalAddons.map(addon => (
{/* Memories providers as sub-items under Journey addon */} {addon.id === 'journey' && providerOptions.length > 0 && (
{providerOptions.map(provider => { const ProviderIcon = PROVIDER_ICONS[provider.key] return (
{ProviderIcon && }
{provider.label}
{provider.description}
{provider.enabled ? t('admin.addons.enabled') : t('admin.addons.disabled')}
) })}
)}
))}
)} {/* Integration Addons */} {integrationAddons.length > 0 && (
{t('admin.addons.type.integration')} — {t('admin.addons.integrationHint')}
{integrationAddons.map(addon => (
{addon.id === 'llm_parsing' && addon.enabled && ( )}
))}
)}
)}
) } const MASKED = '••••••••' const DEFAULT_OLLAMA_URL = 'http://localhost:11434/v1' /** Curated models the local extractor is tuned for, pullable via Ollama. The router drives * one model per document via Ollama's grammar-constrained `format`; "thinking" is disabled * automatically, so the Qwen3 family works without any tuning. A host only needs one. */ const RECOMMENDED_MODELS: { id: string; label: string; note: string; recommended: boolean; vision: boolean }[] = [ { id: 'qwen3:8b', label: 'Qwen3 — 8B', note: 'Recommended · best extraction quality & speed on CPU (thinking auto-disabled) · Apache-2.0', recommended: true, vision: false }, ] /** * Instance-wide AI-parsing config. When set, applies to the whole instance and * overrides per-user config (see server llmConfig.ts). The API key is masked on * read; an unchanged mask is treated as a no-op by the server. For the local * provider, it also lists installed Ollama models and can pull NuExtract models. */ function LlmParsingConfig({ addon }: { addon: Addon }) { const toast = useToast() const cfg = (addon.config ?? {}) as Record const [provider, setProvider] = useState((cfg.provider as string) ?? 'local') const [model, setModel] = useState((cfg.model as string) ?? '') const [baseUrl, setBaseUrl] = useState((cfg.baseUrl as string) ?? '') const [apiKey, setApiKey] = useState((cfg.apiKey as string) ?? '') const [saving, setSaving] = useState(false) // Local-provider model management. const [installed, setInstalled] = useState([]) const [modelsErr, setModelsErr] = useState('') const [loadingModels, setLoadingModels] = useState(false) const [pulling, setPulling] = useState(null) const [pullPct, setPullPct] = useState(0) const [pullStatus, setPullStatus] = useState('') const effectiveUrl = baseUrl.trim() || DEFAULT_OLLAMA_URL const isInstalled = (id: string) => installed.some(n => n === id || n.startsWith(id + ':') || n.startsWith(id)) const loadModels = async () => { if (provider !== 'local') return setLoadingModels(true) setModelsErr('') try { const res = await adminApi.llmLocalModels(effectiveUrl) setInstalled(res.models.map(m => m.name)) } catch (e: unknown) { setModelsErr(e instanceof Error ? e.message : 'Could not reach the local LLM server') setInstalled([]) } finally { setLoadingModels(false) } } // Load installed models when the local provider is active. useEffect(() => { if (provider === 'local') loadModels() // eslint-disable-next-line react-hooks/exhaustive-deps }, [provider]) const pull = async (id: string) => { if (pulling) return setPulling(id) setPullPct(0) setPullStatus('starting…') try { await adminApi.llmLocalPull(effectiveUrl, id, (p) => { if (p.error) throw new Error(p.error) if (p.status) setPullStatus(p.status) if (p.total && p.completed != null) setPullPct(Math.round((p.completed / p.total) * 100)) }) toast.success('Model pulled') setModel(id) await loadModels() } catch (e: unknown) { toast.error(e instanceof Error ? e.message : 'Pull failed') } finally { setPulling(null) setPullPct(0) setPullStatus('') } } const save = async () => { setSaving(true) try { // Send the masked sentinel unchanged so the server keeps the stored key. await adminApi.updateAddon(addon.id, { config: { provider, model: model.trim(), baseUrl: provider === 'anthropic' ? '' : baseUrl.trim(), apiKey, multimodal: cfg.multimodal === true } }) toast.success('Saved') } catch { toast.error('Failed to save') } finally { setSaving(false) } } const fieldCls = 'w-full rounded-lg border border-edge-secondary bg-surface px-3 py-2 text-sm text-content placeholder:text-content-faint transition-colors focus:border-edge focus:outline-none' const labelCls = 'mb-1.5 block text-xs font-medium text-content-secondary' const sectionCls = 'text-[11px] font-semibold uppercase tracking-wide text-content-faint' const providerOptions = [ { value: 'local', label: 'Local · OpenAI-compatible', icon: , badge: 'Ollama' }, { value: 'openai', label: 'OpenAI', icon: }, { value: 'anthropic', label: 'Anthropic', icon: }, ] return (

Set instance-wide config (applies to all users). Leave blank to let each user configure their own provider.

{/* Connection */}
Connection
Provider setProvider(String(v))} options={providerOptions} />
{provider !== 'anthropic' && ( )} {provider === 'anthropic' && (

Anthropic reads PDFs (including scans) natively. Local/OpenAI models receive extracted text — scanned PDFs need Anthropic.

)}
{/* Model */}
Model
{/* Local model management (Ollama) */} {provider === 'local' && (
Installed on the server
{modelsErr &&

{modelsErr}

} {!modelsErr && installed.length === 0 && !loadingModels && (

No models installed yet — pull one below.

)} {installed.length > 0 && (
{installed.map(name => ( ))}
)}
Pull a recommended model
{RECOMMENDED_MODELS.map(m => { const installedHere = isInstalled(m.id) const isPulling = pulling === m.id const active = model === m.id return (
{m.label} {m.recommended && ( Recommended )}
{m.note}
{isPulling && (
{pullStatus}{pullPct ? ` · ${pullPct}%` : ''}
)}
{installedHere ? ( ) : ( )}
) })}
)}
) } interface AddonRowProps { addon: Addon onToggle: (addon: Addon) => void t: (key: string) => string statusOverride?: boolean hideToggle?: boolean } function getAddonLabel(t: (key: string) => string, addon: Addon): { name: string; description: string } { const nameKey = `admin.addons.catalog.${addon.id}.name` const descKey = `admin.addons.catalog.${addon.id}.description` const translatedName = t(nameKey) const translatedDescription = t(descKey) return { name: translatedName !== nameKey ? translatedName : addon.name, description: translatedDescription !== descKey ? translatedDescription : addon.description, } } function AddonRow({ addon, onToggle, t, nameOverride, descriptionOverride, statusOverride, hideToggle }: AddonRowProps & { nameOverride?: string; descriptionOverride?: string }) { const isComingSoon = false const label = getAddonLabel(t, addon) const displayName = nameOverride || label.name const displayDescription = descriptionOverride || label.description const enabledState = statusOverride ?? addon.enabled return (
{/* Icon */}
{/* Info */}
{displayName} {isComingSoon && ( Coming Soon )} {addon.type === 'global' ? t('admin.addons.type.global') : addon.type === 'integration' ? t('admin.addons.type.integration') : t('admin.addons.type.trip')}

{displayDescription}

{/* Toggle */}
{isComingSoon ? t('admin.addons.disabled') : enabledState ? t('admin.addons.enabled') : t('admin.addons.disabled')} {!hideToggle && ( )}
) }