From 2ee413368b232c4975e97adb3465f3118ecbdc70 Mon Sep 17 00:00:00 2001
From: Maurice <mauriceboe@icloud.com>
Date: Fri, 13 Nov 2026 19:29:48 +0100
Subject: [PATCH] fix(mail-ingest): AI reading can be switched back on, and its
 hint names the addon

ai_available folded the person's own switch in, so switching AI reading off
greyed the switch out and it never came back. It now says only whether AI
reading works on the instance (the AI Parsing addon and a connection). When
it does not, the settings card says it needs the AI Parsing addon, by its
localized name, in all 28 locales; the wiki says the same.
---
 client/src/components/Settings/MailImportSection.tsx      | 7 ++++++-
 client/src/mobile/screens/settings/MMailImportSection.tsx | 6 +++++-
 server/src/nest/mail-ingest/mail-ingest-inbox.service.ts  | 4 +++-
 shared/src/i18n/ar/mailInbox.ts                           | 3 ++-
 shared/src/i18n/az/mailInbox.ts                           | 2 +-
 shared/src/i18n/br/mailInbox.ts                           | 2 +-
 shared/src/i18n/ca/mailInbox.ts                           | 2 +-
 shared/src/i18n/cs/mailInbox.ts                           | 3 ++-
 shared/src/i18n/de/mailInbox.ts                           | 2 +-
 shared/src/i18n/en/mailInbox.ts                           | 3 ++-
 shared/src/i18n/es/mailInbox.ts                           | 2 +-
 shared/src/i18n/et/mailInbox.ts                           | 2 +-
 shared/src/i18n/fr/mailInbox.ts                           | 2 +-
 shared/src/i18n/gr/mailInbox.ts                           | 2 +-
 shared/src/i18n/he/mailInbox.ts                           | 3 ++-
 shared/src/i18n/hu/mailInbox.ts                           | 2 +-
 shared/src/i18n/id/mailInbox.ts                           | 2 +-
 shared/src/i18n/it/mailInbox.ts                           | 2 +-
 shared/src/i18n/ja/mailInbox.ts                           | 2 +-
 shared/src/i18n/ko/mailInbox.ts                           | 2 +-
 shared/src/i18n/nl/mailInbox.ts                           | 2 +-
 shared/src/i18n/pl/mailInbox.ts                           | 2 +-
 shared/src/i18n/ru/mailInbox.ts                           | 2 +-
 shared/src/i18n/sk/mailInbox.ts                           | 2 +-
 shared/src/i18n/sv/mailInbox.ts                           | 3 ++-
 shared/src/i18n/th/mailInbox.ts                           | 3 ++-
 shared/src/i18n/tr/mailInbox.ts                           | 2 +-
 shared/src/i18n/uk/mailInbox.ts                           | 3 ++-
 shared/src/i18n/vi/mailInbox.ts                           | 3 ++-
 shared/src/i18n/zh-TW/mailInbox.ts                        | 3 ++-
 shared/src/i18n/zh/mailInbox.ts                           | 3 ++-
 shared/src/mail-ingest/mail-ingest.schema.ts              | 2 +-
 wiki/Booking-Mail-Import.md                               | 2 +-
 33 files changed, 54 insertions(+), 33 deletions(-)

diff --git a/client/src/components/Settings/MailImportSection.tsx b/client/src/components/Settings/MailImportSection.tsx
index 65a8727bf..c1107d60e 100644
--- a/client/src/components/Settings/MailImportSection.tsx
+++ b/client/src/components/Settings/MailImportSection.tsx
@@ -109,7 +109,12 @@ export default function MailImportSection(): ReactElement | null {
         />
         <SettingRow
           label={t('mailInbox.settings.ai')}
-          hint={aiAvailable ? t('mailInbox.settings.aiHint') : t('mailInbox.settings.aiUnavailable')}
+          // Off without the AI Parsing addon and a connection: the hint names the addon, so the person knows what to ask for.
+          hint={
+            aiAvailable
+              ? t('mailInbox.settings.aiHint')
+              : t('mailInbox.settings.aiUnavailable', { addon: t('admin.addons.catalog.llm_parsing.name') })
+          }
           dimmed={!prefs.enabled}
           control={
             <ToggleSwitch
diff --git a/client/src/mobile/screens/settings/MMailImportSection.tsx b/client/src/mobile/screens/settings/MMailImportSection.tsx
index 6927c8cf4..05af6c4cc 100644
--- a/client/src/mobile/screens/settings/MMailImportSection.tsx
+++ b/client/src/mobile/screens/settings/MMailImportSection.tsx
@@ -73,7 +73,11 @@ export default function MMailImportSection(): ReactElement | null {
         />
         <MSetRow
           label={t('mailInbox.settings.ai')}
-          sub={aiAvailable ? t('mailInbox.settings.aiHint') : t('mailInbox.settings.aiUnavailable')}
+          sub={
+            aiAvailable
+              ? t('mailInbox.settings.aiHint')
+              : t('mailInbox.settings.aiUnavailable', { addon: t('admin.addons.catalog.llm_parsing.name') })
+          }
           trailing={
             <MToggle
               checked={prefs.ai_enabled && aiAvailable}
diff --git a/server/src/nest/mail-ingest/mail-ingest-inbox.service.ts b/server/src/nest/mail-ingest/mail-ingest-inbox.service.ts
index 0baec5405..146095d1c 100644
--- a/server/src/nest/mail-ingest/mail-ingest-inbox.service.ts
+++ b/server/src/nest/mail-ingest/mail-ingest-inbox.service.ts
@@ -71,7 +71,9 @@ export class MailIngestInboxService {
       available: true,
       address: await this.addresses.ownAddress(userId),
       prefs,
-      ai_available: prefs.ai_enabled && (await this.reader.isAvailable(userId)),
+      // Whether AI reading can work here at all (the AI Parsing addon and a connection), not the person's own
+      // switch: with it folded in, switching AI off greyed the switch out and it could never come back on.
+      ai_available: await this.reader.isAvailable(userId),
       pending: await this.candidates.countPending(userId),
     };
   }
diff --git a/shared/src/i18n/ar/mailInbox.ts b/shared/src/i18n/ar/mailInbox.ts
index fcda84a9f..08e392e54 100644
--- a/shared/src/i18n/ar/mailInbox.ts
+++ b/shared/src/i18n/ar/mailInbox.ts
@@ -81,7 +81,8 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.ai': 'القراءة بالذكاء الاصطناعي',
   'mailInbox.settings.aiHint':
     'يقرأ أي رسالة حجز ويحدد رحلتها. يُرسل البريد وتواريخ رحلاتك ووجهاتها إلى مزوّد الذكاء الاصطناعي.',
-  'mailInbox.settings.aiUnavailable': 'غير متاح هنا: تُقرأ فقط الرسائل التي تحتوي على بيانات حجز قابلة للقراءة آلياً.',
+  'mailInbox.settings.aiUnavailable':
+    'يتطلب الإضافة {addon} واتصال ذكاء اصطناعي يُعدّه المسؤول. حتى ذلك الحين تُقرأ فقط الرسائل التي تحتوي على بيانات حجز قابلة للقراءة آلياً.',
   'mailInbox.settings.autoAdd': 'الإضافة تلقائياً',
   'mailInbox.settings.autoAddHint':
     'الحجز الذي يتأكد منه TREK يُضاف مباشرة إلى رحلته، ويمكنك التراجع عنه خلال 7 أيام. عند الإيقاف، ينتظر كل حجز موافقتك.',
diff --git a/shared/src/i18n/az/mailInbox.ts b/shared/src/i18n/az/mailInbox.ts
index 9b6511d4a..06ee051cd 100644
--- a/shared/src/i18n/az/mailInbox.ts
+++ b/shared/src/i18n/az/mailInbox.ts
@@ -80,7 +80,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'İstənilən rezervasiya məktubunu oxuyur və səyahətini tapır. Məktub, səyahətlərinin tarixləri və təyinat məntəqələri süni intellekt provayderinə göndərilir.',
   'mailInbox.settings.aiUnavailable':
-    'Burada əlçatan deyil: yalnız maşın tərəfindən oxuna bilən rezervasiya məlumatı olan məktublar oxunur.',
+    '{addon} əlavəsi və administratorun qurduğu süni intellekt bağlantısı lazımdır. O vaxta qədər yalnız maşınla oxuna bilən rezervasiya məlumatları olan məktublar oxunur.',
   'mailInbox.settings.autoAdd': 'Özbaşına əlavə et',
   'mailInbox.settings.autoAddHint':
     'TREK-in əmin olduğu rezervasiya birbaşa səyahətinə düşür və 7 gün ərzində geri ala bilərsən. Deaktiv olduqda hər biri təsdiqini gözləyir.',
diff --git a/shared/src/i18n/br/mailInbox.ts b/shared/src/i18n/br/mailInbox.ts
index 73a43371b..f68bafa17 100644
--- a/shared/src/i18n/br/mailInbox.ts
+++ b/shared/src/i18n/br/mailInbox.ts
@@ -80,7 +80,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'Lê qualquer e-mail de reserva e descobre a viagem correspondente. O e-mail e as datas e destinos das suas viagens são enviados ao provedor de IA.',
   'mailInbox.settings.aiUnavailable':
-    'Indisponível aqui: só são lidos e-mails com dados de reserva legíveis por máquina.',
+    'Requer o complemento {addon} e uma conexão de IA, configurados por um administrador. Até lá, só são lidos e-mails com dados de reserva legíveis por máquina.',
   'mailInbox.settings.autoAdd': 'Adicionar automaticamente',
   'mailInbox.settings.autoAddHint':
     'Uma reserva da qual o TREK tem certeza vai direto para a viagem, e você pode desfazer por 7 dias. Desativado, cada uma espera o seu OK.',
diff --git a/shared/src/i18n/ca/mailInbox.ts b/shared/src/i18n/ca/mailInbox.ts
index f1d75b76a..b8c11713a 100644
--- a/shared/src/i18n/ca/mailInbox.ts
+++ b/shared/src/i18n/ca/mailInbox.ts
@@ -80,7 +80,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'Llegeix qualsevol correu de reserva i en troba el viatge. El correu i les dates i destinacions dels teus viatges s’envien al proveïdor d’IA.',
   'mailInbox.settings.aiUnavailable':
-    'No disponible aquí: només es llegeixen correus amb dades de reserva llegibles per màquina.',
+    'Necessita el complement {addon} i una connexió d’IA, que configura un administrador. Fins aleshores només es llegeixen correus amb dades de reserva llegibles per màquina.',
   'mailInbox.settings.autoAdd': 'Afegeix automàticament',
   'mailInbox.settings.autoAddHint':
     'Una reserva de la qual TREK n’està segur va directa al seu viatge, i pots desfer-ho durant 7 dies. Desactivat, cada una espera la teva aprovació.',
diff --git a/shared/src/i18n/cs/mailInbox.ts b/shared/src/i18n/cs/mailInbox.ts
index 98a32db69..7b7cfdf66 100644
--- a/shared/src/i18n/cs/mailInbox.ts
+++ b/shared/src/i18n/cs/mailInbox.ts
@@ -79,7 +79,8 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.ai': 'Číst pomocí AI',
   'mailInbox.settings.aiHint':
     'Přečte jakýkoli e-mail s rezervací a najde k němu výlet. E-mail a data a cíle tvých výletů se odesílají poskytovateli AI.',
-  'mailInbox.settings.aiUnavailable': 'Zde není dostupné: čtou se jen e-maily se strojově čitelnými údaji o rezervaci.',
+  'mailInbox.settings.aiUnavailable':
+    'Vyžaduje doplněk {addon} a připojení k AI, které nastaví správce. Do té doby se čtou jen e-maily se strojově čitelnými údaji o rezervaci.',
   'mailInbox.settings.autoAdd': 'Přidávat automaticky',
   'mailInbox.settings.autoAddHint':
     'Rezervace, ve které si je TREK jistý, se rovnou přidá do výletu a 7 dní ji můžeš vrátit zpět. Při vypnutí každá čeká na tvé potvrzení.',
diff --git a/shared/src/i18n/de/mailInbox.ts b/shared/src/i18n/de/mailInbox.ts
index e4c5be438..2edf54174 100644
--- a/shared/src/i18n/de/mailInbox.ts
+++ b/shared/src/i18n/de/mailInbox.ts
@@ -80,7 +80,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'Liest jede Buchungsmail und findet die Reise. Die Mail sowie Daten und Ziele deiner Reisen gehen an den AI-Anbieter.',
   'mailInbox.settings.aiUnavailable':
-    'Hier nicht verfügbar: Gelesen werden nur Mails mit maschinenlesbaren Buchungsdaten.',
+    'Braucht das Addon {addon} und eine AI-Verbindung, die ein Admin einrichtet. Bis dahin werden nur Mails mit maschinenlesbaren Buchungsdaten gelesen.',
   'mailInbox.settings.autoAdd': 'Selbst eintragen',
   'mailInbox.settings.autoAddHint':
     'Eine sichere Buchung landet direkt in der Reise und lässt sich 7 Tage lang rückgängig machen. Aus, wartet jede auf dein OK.',
diff --git a/shared/src/i18n/en/mailInbox.ts b/shared/src/i18n/en/mailInbox.ts
index 54d36cdd9..a86ffb3b4 100644
--- a/shared/src/i18n/en/mailInbox.ts
+++ b/shared/src/i18n/en/mailInbox.ts
@@ -78,7 +78,8 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.ai': 'Read with AI',
   'mailInbox.settings.aiHint':
     'Reads any booking mail and finds its trip. The mail and the dates and destinations of your trips go to the AI provider.',
-  'mailInbox.settings.aiUnavailable': 'Not available here: only mails with machine-readable booking data are read.',
+  'mailInbox.settings.aiUnavailable':
+    'Needs the {addon} addon and an AI connection, which an admin sets up. Until then only mails with machine-readable booking data are read.',
   'mailInbox.settings.autoAdd': 'Add on its own',
   'mailInbox.settings.autoAddHint':
     'A booking TREK is sure about goes straight into its trip, and you can undo it for 7 days. Off, each one waits for your OK.',
diff --git a/shared/src/i18n/es/mailInbox.ts b/shared/src/i18n/es/mailInbox.ts
index 013af4e89..7601edb19 100644
--- a/shared/src/i18n/es/mailInbox.ts
+++ b/shared/src/i18n/es/mailInbox.ts
@@ -80,7 +80,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'Lee cualquier correo de reserva y encuentra su viaje. El correo y las fechas y destinos de tus viajes se envían al proveedor de IA.',
   'mailInbox.settings.aiUnavailable':
-    'No disponible aquí: solo se leen correos con datos de reserva legibles por máquina.',
+    'Necesita el complemento {addon} y una conexión de IA, que configura un administrador. Hasta entonces solo se leen correos con datos de reserva legibles por máquina.',
   'mailInbox.settings.autoAdd': 'Añadir automáticamente',
   'mailInbox.settings.autoAddHint':
     'Una reserva de la que TREK está seguro va directa a su viaje, y puedes deshacerlo durante 7 días. Desactivado, cada una espera tu visto bueno.',
diff --git a/shared/src/i18n/et/mailInbox.ts b/shared/src/i18n/et/mailInbox.ts
index d843909b0..b0f004e62 100644
--- a/shared/src/i18n/et/mailInbox.ts
+++ b/shared/src/i18n/et/mailInbox.ts
@@ -80,7 +80,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'Loeb mis tahes broneeringukirja ja leiab selle reisi. Kiri ning sinu reiside kuupäevad ja sihtkohad lähevad tehisintellekti pakkujale.',
   'mailInbox.settings.aiUnavailable':
-    'Siin pole saadaval: loetakse ainult kirju, mis sisaldavad masinloetavaid broneeringuandmeid.',
+    'Vajab lisandmoodulit {addon} ja tehisintellekti ühendust, mille seadistab administraator. Seni loetakse ainult kirju, mis sisaldavad masinloetavaid broneeringuandmeid.',
   'mailInbox.settings.autoAdd': 'Lisa ise',
   'mailInbox.settings.autoAddHint':
     'Broneering, milles TREK on kindel, läheb otse oma reisile ja seda saab 7 päeva jooksul tagasi võtta. Väljalülitatuna ootab iga broneering sinu kinnitust.',
diff --git a/shared/src/i18n/fr/mailInbox.ts b/shared/src/i18n/fr/mailInbox.ts
index f0c18d175..f58d55665 100644
--- a/shared/src/i18n/fr/mailInbox.ts
+++ b/shared/src/i18n/fr/mailInbox.ts
@@ -81,7 +81,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'Lit n’importe quel e-mail de réservation et trouve son voyage. L’e-mail ainsi que les dates et destinations de vos voyages sont transmis au fournisseur d’IA.',
   'mailInbox.settings.aiUnavailable':
-    'Indisponible ici : seuls les e-mails contenant des données de réservation lisibles par machine sont lus.',
+    'Nécessite le module {addon} et une connexion IA, configurés par un administrateur. D’ici là, seuls les e-mails contenant des données de réservation lisibles par machine sont lus.',
   'mailInbox.settings.autoAdd': 'Ajouter automatiquement',
   'mailInbox.settings.autoAddHint':
     'Une réservation dont TREK est sûr va directement dans son voyage, et vous pouvez l’annuler pendant 7 jours. Désactivé, chacune attend votre accord.',
diff --git a/shared/src/i18n/gr/mailInbox.ts b/shared/src/i18n/gr/mailInbox.ts
index 0656f24d6..2d2883f93 100644
--- a/shared/src/i18n/gr/mailInbox.ts
+++ b/shared/src/i18n/gr/mailInbox.ts
@@ -80,7 +80,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'Διαβάζει κάθε email κράτησης και βρίσκει το ταξίδι του. Το email και οι ημερομηνίες και οι προορισμοί των ταξιδιών σου πηγαίνουν στον πάροχο AI.',
   'mailInbox.settings.aiUnavailable':
-    'Δεν είναι διαθέσιμο εδώ: διαβάζονται μόνο email με δεδομένα κράτησης αναγνώσιμα από μηχανή.',
+    'Απαιτεί το πρόσθετο {addon} και μια σύνδεση ΤΝ, που ρυθμίζει ένας διαχειριστής. Μέχρι τότε διαβάζονται μόνο μηνύματα με μηχαναγνώσιμα στοιχεία κράτησης.',
   'mailInbox.settings.autoAdd': 'Αυτόματη προσθήκη',
   'mailInbox.settings.autoAddHint':
     'Μια κράτηση για την οποία το TREK είναι σίγουρο μπαίνει κατευθείαν στο ταξίδι της και μπορείς να την αναιρέσεις για 7 ημέρες. Όταν είναι ανενεργό, κάθε κράτηση περιμένει το OK σου.',
diff --git a/shared/src/i18n/he/mailInbox.ts b/shared/src/i18n/he/mailInbox.ts
index 4582add9a..19e5fecff 100644
--- a/shared/src/i18n/he/mailInbox.ts
+++ b/shared/src/i18n/he/mailInbox.ts
@@ -78,7 +78,8 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.ai': 'קריאה בבינה מלאכותית',
   'mailInbox.settings.aiHint':
     'קוראת כל דוא״ל של הזמנה ומוצאת את הטיול שלו. הדוא״ל ותאריכי הטיולים והיעדים שלכם נשלחים לספק הבינה המלאכותית.',
-  'mailInbox.settings.aiUnavailable': 'לא זמין כאן: נקרא רק דוא״ל עם נתוני הזמנה שניתנים לקריאה אוטומטית.',
+  'mailInbox.settings.aiUnavailable':
+    'נדרשים התוסף {addon} וחיבור בינה מלאכותית שמנהל מגדיר. עד אז נקראים רק מיילים עם נתוני הזמנה קריאים למכונה.',
   'mailInbox.settings.autoAdd': 'הוספה אוטומטית',
   'mailInbox.settings.autoAddHint':
     'הזמנה ש-TREK בטוח בה נכנסת ישירות לטיול שלה, ואפשר לבטל אותה במשך 7 ימים. כשהאפשרות כבויה, כל הזמנה ממתינה לאישור שלכם.',
diff --git a/shared/src/i18n/hu/mailInbox.ts b/shared/src/i18n/hu/mailInbox.ts
index cb8b07df3..5fdb15d56 100644
--- a/shared/src/i18n/hu/mailInbox.ts
+++ b/shared/src/i18n/hu/mailInbox.ts
@@ -80,7 +80,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'Bármilyen foglalási e-mailt elolvas, és megtalálja hozzá az utazást. Az e-mail, valamint az utazásaid dátumai és úti céljai az AI-szolgáltatóhoz kerülnek.',
   'mailInbox.settings.aiUnavailable':
-    'Itt nem érhető el: csak a géppel olvasható foglalási adatokat tartalmazó e-maileket olvassa el.',
+    'Szükséges hozzá a(z) {addon} bővítmény és egy MI-kapcsolat, amelyet egy rendszergazda állít be. Addig csak a géppel olvasható foglalási adatokat tartalmazó levelek olvashatók.',
   'mailInbox.settings.autoAdd': 'Hozzáadás magától',
   'mailInbox.settings.autoAddHint':
     'Az a foglalás, amelyben a TREK biztos, rögtön bekerül az utazásába, és 7 napig visszavonhatod. Kikapcsolva mindegyik a te jóváhagyásodra vár.',
diff --git a/shared/src/i18n/id/mailInbox.ts b/shared/src/i18n/id/mailInbox.ts
index 4fe7b0408..ff7e0ab3f 100644
--- a/shared/src/i18n/id/mailInbox.ts
+++ b/shared/src/i18n/id/mailInbox.ts
@@ -79,7 +79,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'Membaca email pemesanan apa pun dan menemukan perjalanannya. Email serta tanggal dan tujuan perjalanan Anda dikirim ke penyedia AI.',
   'mailInbox.settings.aiUnavailable':
-    'Tidak tersedia di sini: hanya email dengan data pemesanan yang dapat dibaca mesin yang dibaca.',
+    'Memerlukan add-on {addon} dan koneksi AI yang diatur oleh admin. Hingga saat itu, hanya email dengan data pemesanan yang dapat dibaca mesin yang dibaca.',
   'mailInbox.settings.autoAdd': 'Tambahkan otomatis',
   'mailInbox.settings.autoAddHint':
     'Pemesanan yang diyakini TREK langsung masuk ke perjalanannya, dan Anda bisa membatalkannya selama 7 hari. Jika nonaktif, setiap pemesanan menunggu persetujuan Anda.',
diff --git a/shared/src/i18n/it/mailInbox.ts b/shared/src/i18n/it/mailInbox.ts
index dcea46442..65bdcf357 100644
--- a/shared/src/i18n/it/mailInbox.ts
+++ b/shared/src/i18n/it/mailInbox.ts
@@ -81,7 +81,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'Legge qualsiasi e-mail di prenotazione e ne trova il viaggio. L’e-mail e le date e destinazioni dei tuoi viaggi vengono inviate al provider di IA.',
   'mailInbox.settings.aiUnavailable':
-    'Non disponibile qui: vengono lette solo le e-mail con dati di prenotazione leggibili da una macchina.',
+    'Richiede il componente aggiuntivo {addon} e una connessione IA, configurati da un amministratore. Fino ad allora vengono lette solo le e-mail con dati di prenotazione leggibili da una macchina.',
   'mailInbox.settings.autoAdd': 'Aggiungi automaticamente',
   'mailInbox.settings.autoAddHint':
     'Una prenotazione di cui TREK è sicuro va direttamente nel suo viaggio, e puoi annullarla per 7 giorni. Disattivato, ognuna attende il tuo OK.',
diff --git a/shared/src/i18n/ja/mailInbox.ts b/shared/src/i18n/ja/mailInbox.ts
index cd4f48ea6..6e1a0c765 100644
--- a/shared/src/i18n/ja/mailInbox.ts
+++ b/shared/src/i18n/ja/mailInbox.ts
@@ -78,7 +78,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'あらゆる予約メールを読み取り、該当する旅行を見つけます。メールと、旅行の日付や目的地がAIプロバイダに送信されます。',
   'mailInbox.settings.aiUnavailable':
-    'ここでは利用できません。機械で読み取れる予約データを含むメールのみ読み取られます。',
+    '{addon} アドオンと、管理者が設定する AI 接続が必要です。それまでは、機械で読み取れる予約データを含むメールのみ読み取られます。',
   'mailInbox.settings.autoAdd': '自動で追加',
   'mailInbox.settings.autoAddHint':
     'TREKが確信できる予約はそのまま旅行に追加され、7日間は取り消せます。オフにすると、すべて確認を待ちます。',
diff --git a/shared/src/i18n/ko/mailInbox.ts b/shared/src/i18n/ko/mailInbox.ts
index 310badb63..0825174bc 100644
--- a/shared/src/i18n/ko/mailInbox.ts
+++ b/shared/src/i18n/ko/mailInbox.ts
@@ -79,7 +79,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     '모든 예약 메일을 읽고 해당하는 여행을 찾습니다. 메일과 여행의 날짜 및 목적지가 AI 제공업체로 전송됩니다.',
   'mailInbox.settings.aiUnavailable':
-    '여기서는 사용할 수 없습니다. 기계가 읽을 수 있는 예약 데이터가 담긴 메일만 읽습니다.',
+    '{addon} 애드온과 관리자가 설정하는 AI 연결이 필요합니다. 그때까지는 기계가 읽을 수 있는 예약 데이터가 담긴 메일만 읽습니다.',
   'mailInbox.settings.autoAdd': '자동으로 추가',
   'mailInbox.settings.autoAddHint':
     'TREK이 확신하는 예약은 바로 여행에 추가되며, 7일 동안 되돌릴 수 있습니다. 끄면 모든 예약이 내 확인을 기다립니다.',
diff --git a/shared/src/i18n/nl/mailInbox.ts b/shared/src/i18n/nl/mailInbox.ts
index 7792053db..e08b9de37 100644
--- a/shared/src/i18n/nl/mailInbox.ts
+++ b/shared/src/i18n/nl/mailInbox.ts
@@ -79,7 +79,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'Leest elke boekingsmail en zoekt de bijbehorende reis. De mail en de data en bestemmingen van je reizen gaan naar de AI-provider.',
   'mailInbox.settings.aiUnavailable':
-    'Hier niet beschikbaar: alleen mails met machineleesbare boekingsgegevens worden gelezen.',
+    'Vereist de add-on {addon} en een AI-verbinding, die een beheerder instelt. Tot die tijd worden alleen mails met machineleesbare boekingsgegevens gelezen.',
   'mailInbox.settings.autoAdd': 'Zelf toevoegen',
   'mailInbox.settings.autoAddHint':
     'Een boeking waar TREK zeker van is, komt direct in de reis en je kunt dit 7 dagen ongedaan maken. Uit: elke boeking wacht op jouw akkoord.',
diff --git a/shared/src/i18n/pl/mailInbox.ts b/shared/src/i18n/pl/mailInbox.ts
index 23e37ec31..0229d4c5b 100644
--- a/shared/src/i18n/pl/mailInbox.ts
+++ b/shared/src/i18n/pl/mailInbox.ts
@@ -82,7 +82,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'Odczytuje każdą wiadomość z rezerwacją i znajduje dla niej podróż. Wiadomość oraz daty i cele Twoich podróży trafiają do dostawcy AI.',
   'mailInbox.settings.aiUnavailable':
-    'Niedostępne tutaj: odczytywane są tylko wiadomości z danymi rezerwacji w formie czytelnej dla maszyn.',
+    'Wymaga dodatku {addon} i połączenia z AI, które konfiguruje administrator. Do tego czasu odczytywane są tylko maile z danymi rezerwacji czytelnymi maszynowo.',
   'mailInbox.settings.autoAdd': 'Dodawaj samodzielnie',
   'mailInbox.settings.autoAddHint':
     'Rezerwacja, której TREK jest pewien, trafia od razu do podróży i przez 7 dni możesz ją cofnąć. Po wyłączeniu każda czeka na Twoje potwierdzenie.',
diff --git a/shared/src/i18n/ru/mailInbox.ts b/shared/src/i18n/ru/mailInbox.ts
index 0c823529b..6803714f7 100644
--- a/shared/src/i18n/ru/mailInbox.ts
+++ b/shared/src/i18n/ru/mailInbox.ts
@@ -81,7 +81,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'Читает любое письмо с бронированием и находит для него поездку. Письмо, а также даты и направления ваших поездок передаются провайдеру ИИ.',
   'mailInbox.settings.aiUnavailable':
-    'Здесь недоступно: читаются только письма с машиночитаемыми данными о бронировании.',
+    'Нужны дополнение {addon} и подключение к ИИ, которые настраивает администратор. До тех пор читаются только письма с машиночитаемыми данными бронирования.',
   'mailInbox.settings.autoAdd': 'Добавлять самостоятельно',
   'mailInbox.settings.autoAddHint':
     'Бронирование, в котором TREK уверен, сразу попадает в поездку, и 7 дней его можно отменить. Если выключено, каждое ждёт вашего подтверждения.',
diff --git a/shared/src/i18n/sk/mailInbox.ts b/shared/src/i18n/sk/mailInbox.ts
index 5e2b47cb6..4eb6ada14 100644
--- a/shared/src/i18n/sk/mailInbox.ts
+++ b/shared/src/i18n/sk/mailInbox.ts
@@ -81,7 +81,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'Prečíta akýkoľvek e-mail s rezerváciou a nájde k nemu výlet. E-mail a dátumy a ciele tvojich výletov sa odosielajú poskytovateľovi AI.',
   'mailInbox.settings.aiUnavailable':
-    'Tu nie je dostupné: čítajú sa len e-maily so strojovo čitateľnými údajmi o rezervácii.',
+    'Vyžaduje doplnok {addon} a pripojenie k AI, ktoré nastaví správca. Dovtedy sa čítajú len e-maily so strojovo čitateľnými údajmi o rezervácii.',
   'mailInbox.settings.autoAdd': 'Pridávať automaticky',
   'mailInbox.settings.autoAddHint':
     'Rezervácia, v ktorej si je TREK istý, sa rovno pridá do výletu a 7 dní ju môžeš vrátiť späť. Pri vypnutí každá čaká na tvoje potvrdenie.',
diff --git a/shared/src/i18n/sv/mailInbox.ts b/shared/src/i18n/sv/mailInbox.ts
index d1b0becdf..034d9d5d5 100644
--- a/shared/src/i18n/sv/mailInbox.ts
+++ b/shared/src/i18n/sv/mailInbox.ts
@@ -79,7 +79,8 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.ai': 'Läs med AI',
   'mailInbox.settings.aiHint':
     'Läser alla bokningsmejl och hittar rätt resa. Mejlet samt datum och destinationer för dina resor skickas till AI-leverantören.',
-  'mailInbox.settings.aiUnavailable': 'Inte tillgängligt här: endast mejl med maskinläsbara bokningsdata läses.',
+  'mailInbox.settings.aiUnavailable':
+    'Kräver tillägget {addon} och en AI-anslutning, som en administratör konfigurerar. Tills dess läses bara mejl med maskinläsbara bokningsuppgifter.',
   'mailInbox.settings.autoAdd': 'Lägg till automatiskt',
   'mailInbox.settings.autoAddHint':
     'En bokning som TREK är säker på hamnar direkt i sin resa, och du kan ångra det i 7 dagar. När det är av väntar varje bokning på ditt OK.',
diff --git a/shared/src/i18n/th/mailInbox.ts b/shared/src/i18n/th/mailInbox.ts
index 7278fd3ec..b86404787 100644
--- a/shared/src/i18n/th/mailInbox.ts
+++ b/shared/src/i18n/th/mailInbox.ts
@@ -76,7 +76,8 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.ai': 'อ่านด้วย AI',
   'mailInbox.settings.aiHint':
     'อ่านอีเมลการจองทุกรูปแบบและหาทริปที่เกี่ยวข้อง อีเมลรวมถึงวันที่และจุดหมายของทริปจะถูกส่งไปยังผู้ให้บริการ AI',
-  'mailInbox.settings.aiUnavailable': 'ใช้ไม่ได้ที่นี่ ระบบจะอ่านเฉพาะอีเมลที่มีข้อมูลการจองในรูปแบบที่เครื่องอ่านได้',
+  'mailInbox.settings.aiUnavailable':
+    'ต้องใช้ส่วนเสริม {addon} และการเชื่อมต่อ AI ที่ผู้ดูแลระบบตั้งค่า จนกว่าจะถึงตอนนั้น ระบบจะอ่านเฉพาะอีเมลที่มีข้อมูลการจองที่เครื่องอ่านได้',
   'mailInbox.settings.autoAdd': 'เพิ่มอัตโนมัติ',
   'mailInbox.settings.autoAddHint':
     'การจองที่ TREK มั่นใจจะเข้าไปอยู่ในทริปทันที และคุณเลิกทำได้ภายใน 7 วัน เมื่อปิด ทุกรายการจะรอการยืนยันจากคุณ',
diff --git a/shared/src/i18n/tr/mailInbox.ts b/shared/src/i18n/tr/mailInbox.ts
index f265a01a9..94998930a 100644
--- a/shared/src/i18n/tr/mailInbox.ts
+++ b/shared/src/i18n/tr/mailInbox.ts
@@ -79,7 +79,7 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.aiHint':
     'Her rezervasyon e-postasını okur ve seyahatini bulur. E-posta ile seyahatlerinin tarihleri ve varış yerleri yapay zeka sağlayıcısına gider.',
   'mailInbox.settings.aiUnavailable':
-    'Burada kullanılamıyor: yalnızca makine tarafından okunabilir rezervasyon verisi içeren e-postalar okunur.',
+    '{addon} eklentisi ve bir yöneticinin kurduğu yapay zekâ bağlantısı gerekir. O zamana kadar yalnızca makinece okunabilir rezervasyon verisi içeren e-postalar okunur.',
   'mailInbox.settings.autoAdd': 'Kendiliğinden ekle',
   'mailInbox.settings.autoAddHint':
     'TREK’in emin olduğu bir rezervasyon doğrudan seyahatine girer ve 7 gün içinde geri alabilirsin. Kapalıyken her biri onayını bekler.',
diff --git a/shared/src/i18n/uk/mailInbox.ts b/shared/src/i18n/uk/mailInbox.ts
index 33f908a92..cb45f6694 100644
--- a/shared/src/i18n/uk/mailInbox.ts
+++ b/shared/src/i18n/uk/mailInbox.ts
@@ -81,7 +81,8 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.ai': 'Читати за допомогою ШІ',
   'mailInbox.settings.aiHint':
     'Читає будь-який лист із бронюванням і знаходить для нього подорож. Лист, а також дати й напрямки ваших подорожей передаються провайдеру ШІ.',
-  'mailInbox.settings.aiUnavailable': 'Тут недоступно: читаються лише листи з машинозчитуваними даними про бронювання.',
+  'mailInbox.settings.aiUnavailable':
+    'Потрібні доповнення {addon} і підключення до ШІ, які налаштовує адміністратор. Доти читаються лише листи з машинозчитуваними даними бронювання.',
   'mailInbox.settings.autoAdd': 'Додавати самостійно',
   'mailInbox.settings.autoAddHint':
     'Бронювання, у якому TREK певен, одразу потрапляє до подорожі, і 7 днів його можна скасувати. Якщо вимкнено, кожне чекає на ваше підтвердження.',
diff --git a/shared/src/i18n/vi/mailInbox.ts b/shared/src/i18n/vi/mailInbox.ts
index 5a2bd8183..d35ec9a94 100644
--- a/shared/src/i18n/vi/mailInbox.ts
+++ b/shared/src/i18n/vi/mailInbox.ts
@@ -78,7 +78,8 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.ai': 'Đọc bằng AI',
   'mailInbox.settings.aiHint':
     'Đọc mọi email đặt chỗ và tìm chuyến đi tương ứng. Email cùng ngày và điểm đến của các chuyến đi của bạn sẽ được gửi đến nhà cung cấp AI.',
-  'mailInbox.settings.aiUnavailable': 'Không khả dụng ở đây: chỉ đọc những email có dữ liệu đặt chỗ máy đọc được.',
+  'mailInbox.settings.aiUnavailable':
+    'Cần tiện ích bổ sung {addon} và kết nối AI do quản trị viên thiết lập. Trước đó, chỉ những email có dữ liệu đặt chỗ máy đọc được mới được đọc.',
   'mailInbox.settings.autoAdd': 'Tự động thêm',
   'mailInbox.settings.autoAddHint':
     'Đặt chỗ mà TREK chắc chắn sẽ vào thẳng chuyến đi, và bạn có thể hoàn tác trong 7 ngày. Khi tắt, mỗi đặt chỗ sẽ chờ bạn đồng ý.',
diff --git a/shared/src/i18n/zh-TW/mailInbox.ts b/shared/src/i18n/zh-TW/mailInbox.ts
index 6ea84626f..8ed5cd2de 100644
--- a/shared/src/i18n/zh-TW/mailInbox.ts
+++ b/shared/src/i18n/zh-TW/mailInbox.ts
@@ -74,7 +74,8 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.enabledHint': '關閉後，寄到你地址的郵件不會被讀取。',
   'mailInbox.settings.ai': '用 AI 讀取',
   'mailInbox.settings.aiHint': '讀取任何預訂郵件並找到對應的旅行。郵件以及你旅行的日期和目的地會傳送給 AI 服務商。',
-  'mailInbox.settings.aiUnavailable': '此處無法使用：只會讀取包含機器可讀預訂資料的郵件。',
+  'mailInbox.settings.aiUnavailable':
+    '需要 {addon} 外掛程式和由管理員設定的 AI 連線。在此之前，只會讀取含有機器可讀訂位資料的郵件。',
   'mailInbox.settings.autoAdd': '自動加入',
   'mailInbox.settings.autoAddHint': 'TREK 有把握的預訂會直接加入旅行，7 天內可以復原。關閉後，每筆預訂都會等你確認。',
   'mailInbox.settings.upload': '上傳郵件檔案',
diff --git a/shared/src/i18n/zh/mailInbox.ts b/shared/src/i18n/zh/mailInbox.ts
index 03b8d2689..373500fdc 100644
--- a/shared/src/i18n/zh/mailInbox.ts
+++ b/shared/src/i18n/zh/mailInbox.ts
@@ -75,7 +75,8 @@ const mailInbox: TranslationStrings = {
   'mailInbox.settings.enabledHint': '关闭后，发到你地址的邮件不会被读取。',
   'mailInbox.settings.ai': '用 AI 读取',
   'mailInbox.settings.aiHint': '读取任何预订邮件并找到对应的旅行。邮件以及你旅行的日期和目的地会发送给 AI 服务商。',
-  'mailInbox.settings.aiUnavailable': '此处不可用：只会读取包含机器可读预订数据的邮件。',
+  'mailInbox.settings.aiUnavailable':
+    '需要 {addon} 插件和由管理员设置的 AI 连接。在此之前，只会读取包含机器可读预订数据的邮件。',
   'mailInbox.settings.autoAdd': '自动添加',
   'mailInbox.settings.autoAddHint': 'TREK 有把握的预订会直接加入旅行，7 天内可以撤销。关闭后，每个预订都会等你确认。',
   'mailInbox.settings.upload': '上传邮件文件',
diff --git a/shared/src/mail-ingest/mail-ingest.schema.ts b/shared/src/mail-ingest/mail-ingest.schema.ts
index 8b0379da0..3cad97ae7 100644
--- a/shared/src/mail-ingest/mail-ingest.schema.ts
+++ b/shared/src/mail-ingest/mail-ingest.schema.ts
@@ -102,7 +102,7 @@ export const mailIngestSettingsResponseSchema = z.object({
   available: z.boolean(),
   address: mailIngestAddressSchema.nullable(),
   prefs: mailIngestPrefsSchema,
-  /** Whether a mail could be read by AI for this person right now. */
+  /** Whether AI reading works on this instance for this person (AI Parsing addon and a connection), whatever their own switch says. */
   ai_available: z.boolean(),
   /** Open entries in the inbox. */
   pending: z.number().int().nonnegative(),
diff --git a/wiki/Booking-Mail-Import.md b/wiki/Booking-Mail-Import.md
index 75b7da074..19affcd2e 100644
--- a/wiki/Booking-Mail-Import.md
+++ b/wiki/Booking-Mail-Import.md
@@ -42,7 +42,7 @@ An entry also shows whether its sender is confirmed: the mail came from your own
 
 ## AI reading
 
-With **Read with AI** on, the mail's text and attachments, and the title, dates and destinations of your trips, go to the AI provider set up for your instance, so it can read the booking and name its trip; the sender, recipient and forwarding headers are removed first. The AI only fills in the booking; TREK's own checks decide whether it is added. Without AI, only mails with machine-readable booking data are read, and everything else waits under Pending bookings. An admin sets how many mails a day the AI reads for one person (default 10); above it, only machine-readable data is read.
+With **Read with AI** on, the mail's text and attachments, and the title, dates and destinations of your trips, go to the AI provider set up for your instance, so it can read the booking and name its trip; the sender, recipient and forwarding headers are removed first. The AI only fills in the booking; TREK's own checks decide whether it is added. **Read with AI** needs the **AI Parsing** addon and an AI connection, both set up by an admin ([AI Booking Import](AI-Booking-Import)); until then the switch stays off and says so. Without AI, only mails with machine-readable booking data are read, and everything else waits under Pending bookings. An admin sets how many mails a day the AI reads for one person (default 10); above it, only machine-readable data is read.
 
 On TREK Cloud, reading a mail with AI counts as one document of your plan's AI allowance. The Start plan has no booking mail import.