Ben-Agent Email (Resend)

Canonical email inbox for 0 Finance operations.

Purpose

Manage inbound and outbound email for [email protected] using Resend and the existing AI email pipeline.

Canonical Inbox

• [email protected]
• Domain defaults to zerofinance.ai via AI_EMAIL_INBOUND_DOMAIN.

Inbound Flow (Required)

1. Resend catch-all or routed domain receives inbound email.
2. Resend webhook posts to POST /api/ai-email.
3. Webhook signature verified with RESEND_WEBHOOK_SECRET.
4. AI email pipeline parses, responds, and updates session state.

Outbound Flow

• Send via Resend with from: "Ben Agent <[email protected]>".
• Replies and confirmations are sent through packages/web/src/lib/email-provider/resend-provider.ts.

Environment (.env)

Create a collocated .env file at:

.opencode/skill/ben-agent-email/.env

Required values:

RESEND_API_KEY=
RESEND_WEBHOOK_SECRET=
EMAIL_PROVIDER=resend
AI_EMAIL_INBOUND_DOMAIN=zerofinance.ai

Credential Missing Behavior

• If RESEND_API_KEY or RESEND_WEBHOOK_SECRET is missing, ask the user to provide them and stop.
• Do not invent credentials or proceed without explicit access.

Entities + CRUD Coverage

• Email sessions: create/read/update via AI email pipeline; delete not supported.
• Messages: create (send/reply), read (session history), update (follow-up), delete not supported.
• Attachments: create (persist), read (load), update not used, delete not supported.

Tools / Interfaces

• packages/web/src/app/api/ai-email/route.ts - inbound webhook handler.
• packages/web/src/lib/email-provider/resend-provider.ts - Resend send/receive.
• packages/web/src/lib/ai-email/* - session state, prompts, attachment handling.

Completion Signals

• complete: inbound message processed and response sent.
• continue: awaiting user clarification or confirmation.
• error: provider failures or invalid webhook signature.

Example Prompts

• "Check [email protected] for new invoices and summarize."
• "Reply to the latest sender confirming we received their request."
• "Draft a follow-up asking for missing bank details."