--- name: himalaya description: IMAP/SMTP 범용 메일 (Gmail 외). 회사·네이버웍스 등 일반 메일함 조회·전송 시 skill-email 확장 경로로 사용. runtime: kind: external_http service_url_env: SKILL_EMAIL_URL --- # himalaya skill-email에 IMAP/SMTP(himalaya 계열) 연동을 붙일 때의 의도·환경 기준. Gmail OAuth 전용 흐름과 구분. ## Trigger - `imap_read`: IMAP으로 수신함·메일 목록 조회 - `smtp_send`: SMTP로 메일 전송 - 네이버웍스 메일, 회사 메일 등 **Gmail OAuth가 아닌** 일반 메일함 ## Do - IMAP 메일 조회 - SMTP 전송 - 기존 skill-email HTTP API(`SKILL_EMAIL_URL`) 확장 시나리오에 맞춰 호출 ## Do Not - Gmail OAuth·Pub/Sub Push 전용 경로와 **동일 요청으로 충돌**시키지 않음 (provider·의도 분리) - IMAP/SMTP 자격증명을 로그·응답 본문에 노출하지 않음 ## API - `base_url_env`: `SKILL_EMAIL_URL` (skill-email 베이스 URL; IMAP/SMTP 확장은 동일 서비스에서 엔드포인트 추가를 전제) - 현행 skill-email 참고: `POST /send`, `GET /messages` 등 — IMAP/SMTP 추가 시 SSOT 문서·OpenAPI와 함께 갱신 ## 환경변수 - `IMAP_HOST`, `IMAP_PORT` - `SMTP_HOST`, `SMTP_PORT` - `IMAP_USER`, `IMAP_PASSWORD`