@promptbook/cli 0.113.0-9 → 0.114.0-0

package/apps/agents-server/src/instrumentation-node.ts

@@ -16,6 +16,45 @@ export async function registerNodeRuntimeInstrumentation(): Promise<void> {
         );
     }
 
+    try {
+        const { isAgentsServerSqliteMode } = await import('./database/agentsServerDatabaseMode');
+        if (isAgentsServerSqliteMode()) {
+            // Note: Creates the VPS registry database on first boot and registers all
+            //       `SERVERS` domains, so every server gets its own isolated SQLite database
+            //       before the first request arrives.
+            const { listStandaloneRegisteredServers } = await import(
+                './database/sqlite/standaloneServerRegistryStore'
+            );
+            const registeredServers = listStandaloneRegisteredServers();
+            console.info(
+                `🗂️ VPS server registry ready with ${registeredServers.length} registered server(s) in standalone SQLite mode.`,
+            );
+        }
+    } catch (error) {
+        console.error('❌ VPS server registry bootstrap failed during Agents Server instrumentation.', {
+            nextRuntime: process.env.NEXT_RUNTIME,
+            nodeEnv: process.env.NODE_ENV,
+            errorName: error instanceof Error ? error.name : undefined,
+            errorMessage: error instanceof Error ? error.message : String(error),
+            errorStack: error instanceof Error ? error.stack : undefined,
+        });
+    }
+
+    try {
+        const { synchronizeAllStalwartEmailDomains } = await import(
+            './utils/stalwart/synchronizeAllStalwartEmailDomains'
+        );
+        await synchronizeAllStalwartEmailDomains();
+    } catch (error) {
+        console.error('❌ Stalwart domain synchronization failed during Agents Server instrumentation.', {
+            nextRuntime: process.env.NEXT_RUNTIME,
+            nodeEnv: process.env.NODE_ENV,
+            errorName: error instanceof Error ? error.name : undefined,
+            errorMessage: error instanceof Error ? error.message : String(error),
+            errorStack: error instanceof Error ? error.stack : undefined,
+        });
+    }
+
     try {
         const { ensureAutomaticVpsSelfUpdateSchedulerBootstrapped } = await import(
             './utils/vpsSelfUpdate/vpsSelfUpdateScheduler'
@@ -30,6 +69,25 @@ export async function registerNodeRuntimeInstrumentation(): Promise<void> {
             errorStack: error instanceof Error ? error.stack : undefined,
         });
     }
+
+    try {
+        // Note: Keeps Let's Encrypt certificates for every assigned server and project
+        //       domain obtained and renewed automatically. A domain whose DNS was not
+        //       ready when it was created gets its certificate on a later maintenance
+        //       pass, without ever restarting or taking down the running server.
+        const { ensureAutomaticVpsCertificateSchedulerBootstrapped } = await import(
+            './utils/vpsCertificateScheduler'
+        );
+        ensureAutomaticVpsCertificateSchedulerBootstrapped();
+    } catch (error) {
+        console.error('❌ Automatic VPS certificate scheduler failed during Agents Server instrumentation.', {
+            nextRuntime: process.env.NEXT_RUNTIME,
+            nodeEnv: process.env.NODE_ENV,
+            errorName: error instanceof Error ? error.name : undefined,
+            errorMessage: error instanceof Error ? error.message : String(error),
+            errorStack: error instanceof Error ? error.stack : undefined,
+        });
+    }
 }
 
 /**

package/apps/agents-server/src/languages/ServerTranslationKeys.ts

@@ -15,6 +15,7 @@ export const SERVER_TRANSLATION_KEYS = [
     'chat.answerDurationLabel',
     'common.book',
     'common.timeouts',
+    'common.projects',
     'common.more',
     'chatEnterBehavior.sectionEyebrow',
     'chatEnterBehavior.sectionTitle',
@@ -143,13 +144,16 @@ export const SERVER_TRANSLATION_KEYS = [
     'header.createNewUser',
     'header.servers',
     'header.environmentVariables',
+    'header.vpsEmailServer',
     'header.resourceMonitor',
     'header.update',
     'header.database',
+    'header.internalS3',
     'header.logs',
-    'header.codeRunners',
+    'header.harnessAuth',
     'header.cliAccess',
     'header.models',
+    'header.coreAgents',
     'header.openApiDocumentation',
     'header.apiTokens',
     'header.metadata',
@@ -159,7 +163,9 @@ export const SERVER_TRANSLATION_KEYS = [
     'header.chatHistory',
     'header.usageAnalytics',
     'header.taskManager',
+    'header.vpsTaskManager',
     'header.messagesEmails',
+    'header.emailServer',
     'header.backups',
     'header.chatFeedback',
     'header.browser',
@@ -169,6 +175,7 @@ export const SERVER_TRANSLATION_KEYS = [
     'header.errorSimulation',
     'header.imagesGallery',
     'header.files',
+    'header.agentProjects',
     'header.users',
     'header.shibboleth',
     'header.versionInfo',
@@ -177,6 +184,19 @@ export const SERVER_TRANSLATION_KEYS = [
     'header.documentationOverview',
     'header.documentationApiReference',
     'header.documentationAll',
+    'documentation.downloadManual',
+    'documentation.preparingManual',
+    'documentation.openDownloadOptions',
+    'documentation.exportFormatLabel',
+    'documentation.exportLanguageLabel',
+    'documentation.includeLowLevelCommitmentsLabel',
+    'documentation.includeLowLevelCommitmentsHint',
+    'documentation.bakedAgentsLabel',
+    'documentation.bakedAgentsHint',
+    'documentation.noBakedAgentsHint',
+    'documentation.noAgentsAvailable',
+    'documentation.downloadFailedTitle',
+    'documentation.downloadFailedMessage',
     'header.loggedInAs',
     'header.searchThisServerPlaceholder',
     'header.searchBoxDefaultPlaceholder',
@@ -393,16 +413,33 @@ export const SERVER_TRANSLATION_KEYS = [
     'forbidden.message',
     'users.loadingUsers',
     'users.sectionTitle',
+    'users.tableDescription',
+    'users.userColumn',
+    'users.roleColumn',
+    'users.activityColumn',
+    'users.actionsColumn',
+    'users.noUsers',
     'users.adminRole',
+    'users.userRole',
+    'users.anonymousUser',
+    'users.anonymousLabel',
     'users.createdLabel',
     'users.removeAdmin',
     'users.makeAdmin',
     'users.delete',
     'users.addNewUser',
+    'users.createDialogTitle',
+    'users.createDialogDescription',
+    'users.closeCreateDialog',
+    'users.usernameLabel',
     'users.usernamePlaceholder',
+    'users.passwordLabel',
     'users.passwordPlaceholder',
     'users.passwordAriaLabel',
+    'users.generatePassword',
+    'users.passwordGeneratorDescription',
     'users.isAdminCheckbox',
+    'users.adminRoleDescription',
     'users.createUser',
     'users.deleteConfirmTitle',
     'users.deleteConfirmMessage',
@@ -426,6 +463,18 @@ export const SERVER_TRANSLATION_KEYS = [
     'users.createdAgentsDescription',
     'users.activityTitle',
     'users.activityDescription',
+    'users.activityLoading',
+    'users.noActivity',
+    'users.activityTime',
+    'users.activityAgent',
+    'users.activityRole',
+    'users.activityMessage',
+    'users.activityAction',
+    'users.openActivity',
+    'users.activityShowing',
+    'users.viewChatHistory',
+    'users.viewProfile',
+    'users.viewTasks',
     'chat.feedback.reportIssueButtonTitle',
     'chat.feedback.reportIssueButtonAriaLabel',
     'chat.feedback.reportIssueModalTitle',

package/apps/agents-server/src/languages/translations/czech.yaml

@@ -9,6 +9,7 @@ common.chat: Chat
 chat.answerDurationLabel: 'Odpověď za {duration}'
 common.book: Book
 common.timeouts: Časovače
+common.projects: Projekty
 common.more: Více
 chatEnterBehavior.sectionEyebrow: Klávesové zkratky
 chatEnterBehavior.sectionTitle: Psaní zpráv
@@ -130,20 +131,23 @@ header.legalAndAbout: Právo a informace
 header.settings: Nastavení
 header.landingPage: Úvodní stránka
 header.userMemory: Moje paměť
-header.userWallet: Moje peněženka
+header.userWallet: Peněženka agentů
 header.utilities: Nástroje
 header.mockedChats: Ukázkové chaty
 header.viewAllUsers: Zobrazit všechny uživatele
 header.createNewUser: Vytvořit nového uživatele
 header.servers: Servery
 header.environmentVariables: Proměnné prostředí
+header.vpsEmailServer: E-mailový server VPS
 header.resourceMonitor: Monitoring zdrojů
 header.update: Aktualizace
 header.database: Databáze
+header.internalS3: Interní S3
 header.logs: Logy
-header.codeRunners: Code runnery
+header.harnessAuth: Přihlášení harnessu
 header.cliAccess: CLI přístup
 header.models: Modely
+header.coreAgents: Základní agenti
 header.openApiDocumentation: Dokumentace OpenAPI
 header.apiTokens: API tokeny
 header.metadata: Metadata
@@ -153,7 +157,9 @@ header.customJs: Vlastní JS
 header.chatHistory: Historie chatů
 header.usageAnalytics: Analytika využití
 header.taskManager: Správa úloh
+header.vpsTaskManager: Správa úloh (všechny servery)
 header.messagesEmails: Zprávy a e-maily
+header.emailServer: E-mailový server
 header.backups: Zálohy
 header.chatFeedback: Hodnocení chatu
 header.browser: Prohlížeč
@@ -163,6 +169,7 @@ header.searchEngineTest: Test vyhledávače
 header.errorSimulation: Simulace chyb
 header.imagesGallery: Galerie obrázků
 header.files: Soubory
+header.agentProjects: Projekty agentů
 header.users: Uživatelé
 header.shibboleth: Shibboleth
 header.versionInfo: Informace o verzi
@@ -171,6 +178,19 @@ header.story: Příběh
 header.documentationOverview: Přehled
 header.documentationApiReference: API reference
 header.documentationAll: Vše
+documentation.downloadManual: Stáhnout manuál
+documentation.preparingManual: Připravuji manuál…
+documentation.openDownloadOptions: Otevřít možnosti stažení manuálu
+documentation.exportFormatLabel: Formát
+documentation.exportLanguageLabel: Jazyk
+documentation.includeLowLevelCommitmentsLabel: Zahrnout nízkoúrovňové commitmenty
+documentation.includeLowLevelCommitmentsHint: Přidá závěrečnou kapitolu s pokročilými commitmenty, jako je MODEL. Většina autorů je nikdy nepotřebuje.
+documentation.bakedAgentsLabel: Agenti zahrnutí v manuálu
+documentation.bakedAgentsHint: 'Vybraní agenti ({count}) poskytnou příklady a určují prioritu commitmentů.'
+documentation.noBakedAgentsHint: Nejsou vybraní žádní agenti. Exportovaný manuál bude stejný pro každý server.
+documentation.noAgentsAvailable: Na tomto serveru nejsou k dispozici žádní agenti.
+documentation.downloadFailedTitle: Stažení manuálu se nezdařilo
+documentation.downloadFailedMessage: Book language manuál se nepodařilo stáhnout.
 header.loggedInAs: 'Přihlášen jako {username}'
 header.searchThisServerPlaceholder: Prohledat tento server…
 header.searchBoxDefaultPlaceholder: Hledat agenty, složky, dokumentaci nebo konverzace…
@@ -381,22 +401,39 @@ footer.logosAndBranding: Loga a vizuální identita
 footer.connectSectionTitle: Spojte se s námi
 footer.linksSectionTitle: Odkazy
 footer.allRightsReserved: Všechna práva vyhrazena.
-footer.madeInCzechRepublic: Vytvořeno s {emoji} v České republice.
+footer.madeInCzechRepublic: Vytvořeno s {emoji} v Evropě.
 footer.engineVersion: Verze jádra Promptbooku
 forbidden.title: 403 Zakázáno
 forbidden.message: Nemáte oprávnění k přístupu na tuto stránku.
 users.loadingUsers: Načítám uživatele…
 users.sectionTitle: 'Uživatelé ({count})'
+users.tableDescription: Pojmenovaní uživatelé jsou nahoře, anonymní návštěvníci jsou pod nimi.
+users.userColumn: Uživatel
+users.roleColumn: Role a identita
+users.activityColumn: Aktivita
+users.actionsColumn: Akce
+users.noUsers: Nebyli nalezeni žádní uživatelé.
 users.adminRole: Správce
+users.userRole: Uživatel
+users.anonymousUser: Anonymní uživatel
+users.anonymousLabel: Anonymní
 users.createdLabel: Vytvořeno
 users.removeAdmin: Odebrat roli správce
 users.makeAdmin: Nastavit jako správce
 users.delete: Smazat
 users.addNewUser: Přidat nového uživatele
+users.createDialogTitle: Vytvořit nového uživatele
+users.createDialogDescription: Přidejte účet, který se může přihlásit k tomuto serveru.
+users.closeCreateDialog: Zavřít dialog vytvoření uživatele
+users.usernameLabel: Uživatelské jméno
 users.usernamePlaceholder: Uživatelské jméno
+users.passwordLabel: Heslo
 users.passwordPlaceholder: Heslo
 users.passwordAriaLabel: Heslo
+users.generatePassword: Vygenerovat bezpečné heslo
+users.passwordGeneratorDescription: Používá bezpečný generátor náhodných hodnot vašeho prohlížeče.
 users.isAdminCheckbox: Administrátor
+users.adminRoleDescription: Správci mohou spravovat tento server a jeho uživatele.
 users.createUser: Vytvořit uživatele
 users.deleteConfirmTitle: Smazat uživatele
 users.deleteConfirmMessage: 'Opravdu chcete smazat uživatele {username}?'
@@ -419,7 +456,19 @@ users.deleteUserAction: Smazat uživatele
 users.createdAgentsTitle: Agenti tohoto uživatele
 users.createdAgentsDescription: Seznam agentů vytvořených tímto uživatelem zatím není propojený s datovým modelem.
 users.activityTitle: Aktivita
-users.activityDescription: Podrobné sledování aktivity zatím není k dispozici. Jako orientační přehled změn zatím můžete použít výše uvedené časy vytvoření a poslední úpravy.
+users.activityDescription: Poslední zaznamenané chatové zprávy tohoto uživatele.
+users.activityLoading: Načítám aktivitu…
+users.noActivity: Nebyla zaznamenána žádná aktivita v chatu.
+users.activityTime: Čas
+users.activityAgent: Agent
+users.activityRole: Role
+users.activityMessage: Zpráva
+users.activityAction: Akce
+users.openActivity: Otevřít
+users.activityShowing: Zobrazeno {count} z {total} zpráv.
+users.viewChatHistory: Historie chatu
+users.viewProfile: Zobrazit profil
+users.viewTasks: Správce úloh
 chat.feedback.reportIssueButtonTitle: Nahlásit problém
 chat.feedback.reportIssueButtonAriaLabel: Nahlásit problém s touto odpovědí
 chat.feedback.reportIssueModalTitle: Nahlásit problém

package/apps/agents-server/src/languages/translations/english.yaml

@@ -9,6 +9,7 @@ common.chat: Chat
 chat.answerDurationLabel: '{duration} to answer'
 common.book: Book
 common.timeouts: Timeouts
+common.projects: Projects
 common.more: More
 chatEnterBehavior.sectionEyebrow: Keybindings
 chatEnterBehavior.sectionTitle: Chat composer
@@ -132,20 +133,23 @@ header.legalAndAbout: Legal & About
 header.settings: Settings
 header.landingPage: Landing page
 header.userMemory: User Memory
-header.userWallet: User Wallet
+header.userWallet: Agent Wallet
 header.utilities: Utilities
 header.mockedChats: Mocked Chats
 header.viewAllUsers: View all users
 header.createNewUser: Create new user
 header.servers: Servers
 header.environmentVariables: Environment variables
+header.vpsEmailServer: VPS email server
 header.resourceMonitor: Resource monitor
 header.update: Update
 header.database: Database
+header.internalS3: Internal S3
 header.logs: Logs
-header.codeRunners: Code runners
+header.harnessAuth: Harness Auth
 header.cliAccess: CLI Access
 header.models: Models
+header.coreAgents: Core Agents
 header.openApiDocumentation: OpenAPI Documentation
 header.apiTokens: API Tokens
 header.metadata: Metadata
@@ -155,7 +159,9 @@ header.customJs: Custom JS
 header.chatHistory: Chat history
 header.usageAnalytics: Usage analytics
 header.taskManager: Task manager
+header.vpsTaskManager: Task manager (all servers)
 header.messagesEmails: Messages & Emails
+header.emailServer: Email server
 header.backups: Backups
 header.chatFeedback: Chat feedback
 header.browser: Browser
@@ -165,6 +171,7 @@ header.searchEngineTest: Search Engine Test
 header.errorSimulation: Error simulation
 header.imagesGallery: Images gallery
 header.files: Files
+header.agentProjects: Agent Projects
 header.users: Users
 header.shibboleth: Shibboleth
 header.versionInfo: Version info
@@ -173,6 +180,19 @@ header.story: Story
 header.documentationOverview: Overview
 header.documentationApiReference: API Reference
 header.documentationAll: All
+documentation.downloadManual: Download manual
+documentation.preparingManual: Preparing manual…
+documentation.openDownloadOptions: Open manual download options
+documentation.exportFormatLabel: Format
+documentation.exportLanguageLabel: Language
+documentation.includeLowLevelCommitmentsLabel: Include low level commitments
+documentation.includeLowLevelCommitmentsHint: Adds a closing chapter with advanced commitments such as MODEL. Most authors never need them.
+documentation.bakedAgentsLabel: Agents included in the manual
+documentation.bakedAgentsHint: '{count} selected agent(s) will provide the examples and commitment priority.'
+documentation.noBakedAgentsHint: No agents selected. The exported manual will be generic for every server.
+documentation.noAgentsAvailable: No agents are available on this server.
+documentation.downloadFailedTitle: Manual download failed
+documentation.downloadFailedMessage: Failed to download the Book language manual.
 header.loggedInAs: Logged in as {username}
 header.searchThisServerPlaceholder: Search this server...
 header.searchBoxDefaultPlaceholder: Search agents, folders, docs, conversations...
@@ -391,16 +411,33 @@ forbidden.title: 403 Forbidden
 forbidden.message: You do not have permission to access this page.
 users.loadingUsers: Loading users...
 users.sectionTitle: Users ({count})
+users.tableDescription: Named users appear first; anonymous visitors are grouped below them.
+users.userColumn: User
+users.roleColumn: Role and identity
+users.activityColumn: Activity
+users.actionsColumn: Actions
+users.noUsers: No users found.
 users.adminRole: Admin
+users.userRole: User
+users.anonymousUser: Anonymous user
+users.anonymousLabel: Anonymous
 users.createdLabel: Created
 users.removeAdmin: Remove Admin
 users.makeAdmin: Make Admin
 users.delete: Delete
 users.addNewUser: Add New User
+users.createDialogTitle: Create new user
+users.createDialogDescription: Add an account that can sign in to this server.
+users.closeCreateDialog: Close create user dialog
+users.usernameLabel: Username
 users.usernamePlaceholder: Username
+users.passwordLabel: Password
 users.passwordPlaceholder: Password
 users.passwordAriaLabel: Password
+users.generatePassword: Generate secure password
+users.passwordGeneratorDescription: Uses your browser's secure random generator.
 users.isAdminCheckbox: Is Admin
+users.adminRoleDescription: Administrators can manage this server and its users.
 users.createUser: Create User
 users.deleteConfirmTitle: Delete user
 users.deleteConfirmMessage: Are you sure you want to delete user {username}?
@@ -423,7 +460,19 @@ users.deleteUserAction: Delete user
 users.createdAgentsTitle: Created agents
 users.createdAgentsDescription: Listing agents created by users is not wired to the data model yet.
 users.activityTitle: Activity
-users.activityDescription: Detailed activity tracking is not implemented yet. For now, you can use the created and updated timestamps above as a basic signal of recent changes.
+users.activityDescription: Recent recorded chat messages for this user.
+users.activityLoading: Loading activity...
+users.noActivity: No recorded chat activity.
+users.activityTime: Time
+users.activityAgent: Agent
+users.activityRole: Role
+users.activityMessage: Message
+users.activityAction: Action
+users.openActivity: Open
+users.activityShowing: Showing {count} of {total} messages.
+users.viewChatHistory: Chat history
+users.viewProfile: View profile
+users.viewTasks: Task manager
 chat.feedback.reportIssueButtonTitle: Report issue
 chat.feedback.reportIssueButtonAriaLabel: Report issue with this response
 chat.feedback.reportIssueModalTitle: Report issue

package/apps/agents-server/src/message-providers/email/_common/parseInboundEmail.ts

@@ -0,0 +1,71 @@
+import type { string_email, string_markdown } from '@promptbook-local/types';
+import { simpleParser, type AddressObject, type EmailAddress as ParsedEmailAddress } from 'mailparser';
+import TurndownService from 'turndown';
+import { extractBodyContentFromHtml } from '../../../utils/content/extractBodyContentFromHtml';
+import type { EmailAddress, InboundEmail } from './Email';
+import { parseEmailAddress } from './utils/parseEmailAddress';
+
+/**
+ * Parses one RFC 5322 message into the shared inbound-email representation.
+ */
+export async function parseInboundEmail(rawEmail: string | Buffer): Promise<InboundEmail> {
+    const parsedEmail = await simpleParser(rawEmail);
+    const from = parseAddressObjects(parsedEmail.from);
+    const to = parseAddressObjects(parsedEmail.to);
+    const cc = parseAddressObjects(parsedEmail.cc);
+    const turndownService = new TurndownService();
+    const content = (parsedEmail.html
+        ? turndownService.turndown(extractBodyContentFromHtml(parsedEmail.html))
+        : parsedEmail.text || '') as string_markdown;
+
+    return {
+        channel: 'EMAIL',
+        direction: 'INBOUND',
+        sender: from[0]?.fullEmail || ('' as string_email),
+        recipients: to.map((emailAddress) => emailAddress.fullEmail),
+        cc,
+        subject: parsedEmail.subject || '',
+        content,
+        attachments: [
+            /* <- TODO: [📯] Parse attachments */
+        ],
+        metadata: {
+            messageId: parsedEmail.messageId || null,
+            inReplyTo: parsedEmail.inReplyTo || null,
+            references: parsedEmail.references || [],
+            autoSubmitted: parsedEmail.headers.get('auto-submitted') || null,
+            promptbookAgentReply: parsedEmail.headers.get('x-promptbook-agent-reply') || null,
+        },
+    };
+}
+
+/**
+ * Normalizes MailParser's singular-or-array address field.
+ */
+function normalizeAddressObjects<T>(value: T | T[] | undefined): T[] {
+    if (value === undefined) {
+        return [];
+    }
+
+    return Array.isArray(value) ? value : [value];
+}
+
+/**
+ * Converts MailParser address structures without splitting quoted display names on commas.
+ */
+function parseAddressObjects(value: AddressObject | AddressObject[] | undefined): EmailAddress[] {
+    return normalizeAddressObjects(value)
+        .flatMap((addressObject) => addressObject.value)
+        .flatMap(flattenParsedEmailAddress)
+        .map((address) => parseEmailAddress(address));
+}
+
+/**
+ * Recursively extracts mailbox strings from regular and grouped parsed addresses.
+ */
+function flattenParsedEmailAddress(value: ParsedEmailAddress): string[] {
+    return [
+        ...(value.address ? [value.address] : []),
+        ...(value.group || []).flatMap(flattenParsedEmailAddress),
+    ];
+}

package/apps/agents-server/src/message-providers/email/sendgrid/parseInboundSendgridEmail.ts

@@ -1,49 +1,9 @@
-import { string_markdown } from '@promptbook-local/types';
-import { simpleParser } from 'mailparser';
-import TurndownService from 'turndown';
-import { extractBodyContentFromHtml } from '../../../utils/content/extractBodyContentFromHtml';
 import type { InboundEmail } from '../_common/Email';
-import { parseEmailAddress } from '../_common/utils/parseEmailAddress';
-import { parseEmailAddresses } from '../_common/utils/parseEmailAddresses';
+import { parseInboundEmail } from '../_common/parseInboundEmail';
 
 /**
  * Function parseInboundSendgridEmail will parse raw inbound email from Sendgrid and return Email object
  */
 export async function parseInboundSendgridEmail(rawEmail: string): Promise<InboundEmail> {
-    const parsedEmail = await simpleParser(rawEmail);
-
-    const toArray = !Array.isArray(parsedEmail.to)
-        ? parsedEmail.to === undefined
-            ? []
-            : [parsedEmail.to]
-        : parsedEmail.to;
-    const to = toArray.flatMap((_) => parseEmailAddresses(_.text));
-
-    const ccArray = !Array.isArray(parsedEmail.cc)
-        ? parsedEmail.cc === undefined
-            ? []
-            : [parsedEmail.cc]
-        : parsedEmail.cc;
-    const cc = ccArray.flatMap((_) => parseEmailAddresses(_.text));
-
-    const turndownService = new TurndownService();
-
-    const content = (parsedEmail.html
-        ? turndownService.turndown(extractBodyContentFromHtml(parsedEmail.html))
-        : parsedEmail.text || '') as string_markdown;
-
-    const email: InboundEmail = {
-        channel: 'EMAIL',
-        direction: 'INBOUND',
-        sender: parseEmailAddress(parsedEmail.from?.text || '').fullEmail,
-        recipients: to.map((_) => _.fullEmail),
-        cc,
-        subject: parsedEmail.subject || '',
-        content,
-        attachments: [
-            /* <- TODO: [📯] Parse attachments */
-        ],
-    };
-
-    return email;
+    return parseInboundEmail(rawEmail);
 }

package/apps/agents-server/src/message-providers/email/smtp/SmtpMessageProvider.ts

@@ -13,6 +13,7 @@ export type SmtpMessageProviderConfiguration = {
     host: string;
     port: number;
     secure: boolean;
+    isTlsCertificateValidationEnabled?: boolean;
     username: string;
     password: string;
 };
@@ -28,6 +29,9 @@ export class SmtpMessageProvider implements MessageProvider {
             host: configuration.host,
             port: configuration.port,
             secure: configuration.secure,
+            tls: {
+                rejectUnauthorized: configuration.isTlsCertificateValidationEnabled ?? true,
+            },
             auth: {
                 user: configuration.username,
                 pass: configuration.password,
@@ -49,6 +53,7 @@ export class SmtpMessageProvider implements MessageProvider {
 
         const text = removeMarkdownFormatting(message.content);
         const html = await marked.parse(message.content);
+        const headers = normalizeStringRecord(message.metadata?.headers);
 
         return this.transporter.sendMail({
             from: sender.fullName
@@ -62,6 +67,44 @@ export class SmtpMessageProvider implements MessageProvider {
             subject: message.subject || message.metadata?.subject || 'No Subject',
             text,
             html,
+            replyTo: normalizeOptionalString(message.metadata?.replyTo),
+            inReplyTo: normalizeOptionalString(message.metadata?.inReplyTo),
+            references: normalizeStringArray(message.metadata?.references),
+            headers: Object.keys(headers).length > 0 ? headers : undefined,
         });
     }
 }
+
+/**
+ * Normalizes an arbitrary metadata value to an optional non-empty string.
+ */
+function normalizeOptionalString(value: unknown): string | undefined {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+
+/**
+ * Normalizes an arbitrary metadata value to a string array.
+ */
+function normalizeStringArray(value: unknown): string[] | undefined {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+
+    const normalizedValues = value.filter((item): item is string => typeof item === 'string' && Boolean(item.trim()));
+    return normalizedValues.length > 0 ? normalizedValues : undefined;
+}
+
+/**
+ * Normalizes custom SMTP headers stored in message metadata.
+ */
+function normalizeStringRecord(value: unknown): Record<string, string> {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return {};
+    }
+
+    return Object.fromEntries(
+        Object.entries(value).filter(
+            (entry): entry is [string, string] => typeof entry[1] === 'string' && Boolean(entry[1].trim()),
+        ),
+    );
+}