DevCom.AgenticRuntime.Plugin.IMAP 1.0.26

IMAP Email Trigger Plugin

DevCom Agentic Platform (DAP) plugin that adds an IMAP email trigger: poll a mailbox folder for new messages and fire agents with the message content.

Features

• Mailbox polling trigger — per-agent IMAP credentials and folder selection; new messages invoke the agent.
• Configurable start position — choose where the trigger begins reading when it is enabled or edited: new mail only, resume from the last processed message, or start from a specific date and time.
• OAuth2 for Microsoft 365 / Outlook — built-in OAuth endpoint completes the Azure AD (Entra ID) consent flow so mailboxes with basic auth disabled still work.
• Health check — reports mailbox connectivity on the host's plugin health endpoint.

Configuration

Plugin-wide settings (only needed for Microsoft/Outlook OAuth2):

IMAP server, credentials, and the folder to watch are configured on each agent's trigger config.

Per-agent trigger settings:

Installation

Install from the DAP admin Plugins page (searches the configured NuGet feed), or drop the package into the host's plugin directory.

Changelog

1.0.21 - 2026-08-31

• DAP-309: configurable start position for the trigger. New per-agent trigger settings StartFrom (newMailOnly / lastProcessed / specificDateTime) and StartFromDateTime control where reading begins when an operator enables the trigger or edits the setting; reconnects and restarts still resume from the persisted watermark, so mail arriving during an outage is never skipped. specificDateTime cuts by the message's server delivery time (INTERNALDATE), not the Date: header. Any backlog above the resolved position is drained immediately instead of waiting for the next arrival or re-IDLE. The plugin now also exposes its position (ITriggerPositionSource) so the API can show where the trigger stands.

1.0.17 - 2026-08-26

• DAP-298: trigger payload now includes inReplyToMessageId (the inbound email's RFC 2822 Message-ID, angle-bracket normalized) and threadId (the Gmail conversation id, hex-formatted, null on non-Gmail servers) — pass either straight into the Google Workspace plugin's gmail-send skill (threadId/inReplyToMessageId inputs, DAP-249) to reply on the original thread. Additive only; existing payload fields are unchanged. Upgrade this plugin on the target instance (Plugins → Discover → Upgrade) before the new fields appear in trigger payloads.

1.0.13 - 2026-06-17

• fix(DAP-37, imap): make the polling supervisor durable and observable — decouple its lifetime from the transient start token, log loop start/exit, and surface a faulted supervisor task so a dead loop no longer requires a manual reload to diagnose

1.0.12 - 2026-06-05

• no plugin changes recorded for this version

1.0.11 - 2026-05-04

• fixed forwarded proto for API behind reverse proxy, bumped IMAP plugin version (dbd6780)
• fix: extract PDF from nested message/rfc822 parts in .eml files (1d8b799)

1.0.10 - 2026-04-22

• Add chat message authorship and trigger display DSL (51130f6)

1.0.9 - 2026-04-16

• Refactor publish script; bump plugin versions (3919487)

1.0.8 - 2026-04-03

• feat: convert HTML email body to markdown when text body is missing (e43a207)

1.0.7 - 2026-04-02

• feat: add log seen/unseen tracking with improved Logs screen (c1e22e0)
• fix shadow drop modal (a157faf)

1.0.6 - 2026-04-01

• always https schema, bump version (ac4db92)

1.0.5 - 2026-04-01

• fix: clean up plugin disk cache on uninstall to prevent stale DLL reuse (2631c0f)
• feat: add OAuth2 authorization code flow for IMAP with conditional field visibility (029e2f4)

1.0.4 - 2026-03-25

• refactor: reorganize skill/script architecture with extensible engine interfaces (7ce536a)

1.0.3 - 2026-03-24

• fix: preserve full JSON Schema for MCP tool properties to fix OpenAI validation (97d8b88)
• Update ImapTriggerPlugin.cs (46d5268)

1.0.2 - 2026-03-24

• Update DevCom.AgenticRuntime.Plugin.IMAP.csproj (c80a8fd)
• fix: notify trigger plugins when config changes so workers restart with fresh credentials (442763f)

1.0.1 - 2026-03-21

• bundle deps (b0f7a9d)
• credential probes (cabed95)

1.0.0 - 2026-03-21

• IMAP extension (6f4e486)