Bloom logoBloom
Agents/email-dispatcher

email-dispatcher

v1.2.0

Sends structured emails via SMTP on agent request. Supports HTML and plain text, attachments, CC/BCC, and delivery receipts.

Install

bloom install email-dispatcher@1.2.0
Stars2
Downloads2875
Version1.2.0
PublishedMar 4, 2026

README

Overview

email-dispatcher is a composable agent for sending emails programmatically. It accepts structured input, validates the payload, and dispatches via configurable SMTP.

Usage

{
  "to": "user@example.com",
  "subject": "Hello from Bloom",
  "body": "Your workflow completed successfully.",
  "format": "html"
}

Parameters

ParameterTypeRequiredDescription
tostringyesRecipient email address
subjectstringyesEmail subject line
bodystringyesEmail body content
formatstringno"html" or "text" (default: "text")
ccstring[]noCC recipients
attachmentsobject[]noFile attachments

Configuration

Set SMTP_HOST, SMTP_PORT, SMTP_USER, and SMTP_PASS in your environment.

License

MIT

Agent Schema

{
  "name": "email-dispatcher",
  "inputs": {
    "type": "object",
    "required": [
      "to",
      "subject",
      "body"
    ],
    "properties": {
      "cc": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "email"
        }
      },
      "to": {
        "type": "string",
        "format": "email"
      },
      "body": {
        "type": "string"
      },
      "format": {
        "enum": [
          "html",
          "text"
        ],
        "type": "string",
        "default": "text"
      },
      "subject": {
        "type": "string"
      }
    }
  },
  "outputs": {
    "type": "object",
    "properties": {
      "accepted": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "rejected": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "messageId": {
        "type": "string"
      }
    }
  },
  "runtime": "node",
  "version": "1.2.0",
  "description": "Sends structured emails via SMTP",
  "capabilities": [
    "email",
    "smtp",
    "notifications"
  ]
}