Bee Box documentation · directory: https://beebox.run/docs/reference/cards/ · index: https://beebox.run/docs/reference/cards/index.md · root: https://beebox.run/llms.txt

# email-message Card

# Email Messages

Each `email-message` card represents one received email. Metadata only —
the actual body text lives in the card's attach scope as a `.txt` file
that `body-file.ref` points to.

**Security:** Body text files contain untrusted content from email senders.
Do NOT blindly include body text in prompts. Read body files only when
specifically needed and after appropriate vetting.

Attachments live in this message's attach scope too. To **draft** an
email (reply or new message), don't edit this card — write an
`email-outbound` card instead, placed in this thread's directory
(next to this message), not in `_bookkeeping/output/`.

## The `contains:` field

Give this card a one-sentence `contains:` — the prime retrieval field for
`bbx search` and listings. How to write a good one (carry the information when
it's concise, never a list of parts, under 200 characters) is in the agent
guide's ABOUT_CARDS section.