Notify workflow failure with Email when the workflow is triggered by webhooks

[satococoa]

Summary

This Pull Request introduces the following improvements and features:

1. Email notification on workflow errors triggered via GitHub Webhook.
2. Session-independent usage reporting for agents.
3. GitHub comment posting only when the flow execution is successfully completed.

Changes

• Added nodemailer and its type definitions
  • Implemented the sendEmail function using nodemailer, providing configurable SMTP settings through environment variables.
• Introduced a debug mode (SEND_EMAIL_DEBUG)
  • Allows logging email content to the console instead of sending it for local or development usage.
• Implemented an onStepFail callback
  • Ensures team members are notified via email if a workflow execution triggered by GitHub Webhook fails.
• Modified reportAgentTimeUsage
  • Removed session-based dependencies by accepting agentId explicitly and querying the appropriate team and subscription details.
• Conditionally post comments to GitHub
  • Only post issue comments upon successful workflow completion, preventing redundant or partial information from appearing.

Why nodemailer?

nodemailer vs. emailjs

• Ecosystem and Community: nodemailer has a larger user base and more extensive documentation, making it easier to find solutions and best practices.
• Active Maintenance: nodemailer is regularly updated and well-maintained.

https://npmtrends.com/emailjs-vs-nodemailer

nodemailer vs. aws-sdk/client-ses

• Vendor Neutrality: nodemailer can send emails via any SMTP server. This provides flexibility if you decide to switch providers or are not exclusively using AWS.

TODO

• Add SMTP_XXXX environment values to Preview
• Add SMTP_XXXX environment values to Production

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
giselle	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jan 27, 2025 7:31am

[shige]

LGTM 👍

[shige]

nits: @satococoa

I would appreciate it if you could delete this file!
ref: #306