fc-plugin-codbi/com.github.xima_formcycle_entwicklerkreis.fc.plugin.codbi.logic.cb/MailBridge

MailBridge

MailBridge – KI-initiierter E-Mail-Versand mit Ratenbegrenzung

Ermöglicht dem KI-Modell das Senden von E-Mails über „CALL:mail(to='...', subject='...', body='...')`-Marker. Verwendet zur Laufzeit die Mail-API von FORMCYCLE: Ruft den System-Mail-Kontext über ab „MailContextProvider.getSystemContext()“ und sendet dann über „SimpleTextMail“.

Sicherheit und Ratenbegrenzung

Globale Obergrenze: max. GLOBAL_MAX_MAILS_PER_HOUR E-Mails pro Stunde über alle Sitzungen hinweg
Obergrenze pro Sitzung: max. SESSION_MAX_MAILS E-Mails pro Streaming-Sitzung
Empfänger-Whitelist: Nur Adressen, die mit allowedRecipientPattern übereinstimmen, sind zulässig
Subjekt und Körper werden desinfiziert (keine Header-Injektion)

Konfiguration

Eigentum	Formatieren	Beispiel
`AI_Mail_Enabled`	„wahr“/„falsch“	„wahr“
`AI_Mail_AllowedRecipients`	Regex-Muster	`.*@mycompany\.com`
`AI_Mail_MaxPerHour`	Ganzzahl	`10`
`AI_Mail_MaxPerSession`	Ganzzahl	`3`
`AI_Mail_Disclaimer`	Freitext	„KI-generiert“

Types

MailResult

data class MailResult(val success: Boolean, val recipient: String? = null, val subject: String? = null, val error: String? = null)

Ergebnis eines E-Mail-Versandversuchs.

Properties

aiDisclaimer

@Volatile

var aiDisclaimer: String

Disclaimer text appended to every AI-sent email. Customise via AI_Mail_Disclaimer.

allowedRecipientPattern

@Volatile

var allowedRecipientPattern: Regex?

Regex pattern that recipient addresses must match. null = allow all.

CALL_MAIL_PATTERN

val CALL_MAIL_PATTERN: Regex

Entspricht „CALL:mail(to='...', subject='...', body='...')` in der Modellausgabe (vollständiges Muster).

CALL_MAIL_PATTERN_TRUNCATED

val CALL_MAIL_PATTERN_TRUNCATED: Regex

Fallback-Muster für abgeschnittene CALL:mail, bei der der Text durch das Token-Limit abgeschnitten wurde. Aufnahmen an, Betreff und den verfügbaren Textkörper (auch ohne schließendes Anführungszeichen/Paren).

enabled

@Volatile

var enabled: Boolean

Whether the mail bridge is enabled. Enable via AI_Mail_Enabled=true.

isAvailable

val isAvailable: Boolean

Ob die Mail-Brücke zum Senden bereit ist. Wenn der System-Mail-Kontext zur Laufzeit nicht verfügbar ist, „sendMail“ gibt einen Fehler zurück.

maxMailsPerHour

@Volatile

var maxMailsPerHour: Int

Maximum mails per hour (global across all sessions).

maxMailsPerSession