@geekbeer/minion 3.8.0 → 3.8.1

package/core/config.js

@@ -75,6 +75,7 @@ const config = {
   HQ_URL: process.env.HQ_URL || '',
   API_TOKEN: process.env.API_TOKEN || '',
   MINION_ID: process.env.MINION_ID || '',
+  MINION_EMAIL: process.env.MINION_ID ? `m-${process.env.MINION_ID}@minion-agent.com` : '',
 
   // Server settings
   AGENT_PORT: parseInt(process.env.AGENT_PORT, 10) || 8080,
@@ -111,6 +112,12 @@ function validate() {
   } else {
     console.log('[Config] HQ not configured, running in standalone mode')
   }
+
+  // Expose MINION_EMAIL to child processes (e.g. Claude Code, Gemini CLI)
+  if (config.MINION_EMAIL) {
+    process.env.MINION_EMAIL = config.MINION_EMAIL
+    console.log(`[Config] Email: ${config.MINION_EMAIL}`)
+  }
 }
 
 /**

package/docs/api-reference.md

@@ -443,6 +443,94 @@ POST `/api/project-memories` body:
 3. 該当なし → `POST /api/threads` でブロッカー起票（プロジェクトなら `scope: "project"` + `project_id`、ルーティンなら `scope: "workspace"`）
 4. 解決後 → プロジェクトスレッドの場合は `POST /api/project-memories` で知見を蓄積
 
+### Email
+
+ミニオン専用メールアドレス (`m-{MINION_ID}@minion-agent.com`) 宛のメールを管理する。
+メールは Cloudflare Email Worker → HQ → ミニオンの経路で自動受信・保存される。
+添付ファイルはセキュリティ上、人間が HQ ダッシュボードで承認するまでデータを取得できない。
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/email/inbox/summary` | 未読・合計件数 (`{unread, total, latest_at}`) |
+| GET | `/api/email/inbox` | メール一覧（フィルター対応） |
+| GET | `/api/email/inbox/:id` | メール詳細（添付メタデータ含む） |
+| PUT | `/api/email/inbox/:id` | 既読/未読を更新 |
+| DELETE | `/api/email/inbox/:id` | メールを削除 |
+| POST | `/api/email/inbox/:id/attachments/:attachmentId/approve` | 添付ファイルを承認（HQダッシュボード用） |
+| GET | `/api/email/inbox/:id/attachments/:attachmentId` | 添付ファイルを取得（承認済みのみ） |
+
+GET `/api/email/inbox` query parameters:
+
+| Param | Description |
+|-------|-------------|
+| `is_read` | `0` (未読) or `1` (既読) でフィルター |
+| `from_address` | 送信元アドレスで部分一致検索 |
+| `search` | 件名・本文でテキスト検索（3文字以上でFTS5使用） |
+| `limit` | 取得件数（デフォルト: 50） |
+
+GET `/api/email/inbox/summary` response:
+```json
+{
+  "success": true,
+  "summary": { "unread": 3, "total": 12, "latest_at": "2026-04-01T10:30:00Z" }
+}
+```
+
+GET `/api/email/inbox` response:
+```json
+{
+  "success": true,
+  "emails": [
+    {
+      "id": "abc123",
+      "from_address": "user@example.com",
+      "to_address": "m-uuid@minion-agent.com",
+      "subject": "タスクの依頼",
+      "body_text": "...",
+      "body_html": "...",
+      "received_at": "2026-04-01T10:30:00Z",
+      "is_read": 0,
+      "labels": []
+    }
+  ]
+}
+```
+
+GET `/api/email/inbox/:id` response (添付ファイル付き):
+```json
+{
+  "success": true,
+  "email": {
+    "id": "abc123",
+    "from_address": "user@example.com",
+    "to_address": "m-uuid@minion-agent.com",
+    "subject": "資料送付",
+    "body_text": "...",
+    "body_html": "...",
+    "received_at": "2026-04-01T10:30:00Z",
+    "is_read": 0,
+    "labels": [],
+    "attachments": [
+      {
+        "id": "att456",
+        "email_id": "abc123",
+        "filename": "report.pdf",
+        "content_type": "application/pdf",
+        "size_bytes": 102400,
+        "approved": 0
+      }
+    ]
+  }
+}
+```
+
+PUT `/api/email/inbox/:id` body:
+```json
+{ "is_read": 1 }
+```
+
+Note: 既読メールは受信後90日で自動削除される。未読メールは保持される。
+
 ### Commands
 
 | Method | Endpoint | Description |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekbeer/minion",
-  "version": "3.8.0",
+  "version": "3.8.1",
   "description": "AI Agent runtime for Minion - manages status and skill deployment on VPS",
   "main": "linux/server.js",
   "bin": {

package/rules/core.md

@@ -27,6 +27,19 @@ Minion
 - **Routine**: ミニオンスコープ。ミニオンローカルの定期タスク。
 - ミニオンは複数プロジェクトに `pm` または `engineer` として参加できる。
 
+## Email
+
+各ミニオンには専用メールアドレス `m-{MINION_ID}@minion-agent.com` が割り当てられている。
+受信メールはローカルSQLiteに自動保存され、Agent APIで確認できる。
+
+- **受信確認**: `GET /api/email/inbox/summary` で未読件数を確認
+- **メール一覧**: `GET /api/email/inbox` でメール一覧を取得（フィルター・検索対応）
+- **メール詳細**: `GET /api/email/inbox/:id` で本文・添付ファイルを確認
+- **既読管理**: `PUT /api/email/inbox/:id` で既読/未読を切り替え
+- **添付ファイル**: 添付ファイルはセキュリティ上、人間がHQダッシュボードで承認するまでダウンロード不可
+
+API の詳細仕様は `~/.minion/docs/api-reference.md` の「Email」セクションを参照。
+
 ## Available Tools
 
 ### CLI
@@ -127,6 +140,7 @@ Note: Codex CLI の `.codex/` ディレクトリはLLMからの直接編集が
 | `MINION_ID` | UUID assigned by HQ |
 | `AGENT_PORT` | Agent HTTP port (default: 8080) |
 | `MINION_USER` | System user running the agent |
+| `MINION_EMAIL` | Minion email address (`m-{MINION_ID}@minion-agent.com`) |
 
 Routine 実行中は以下もtmuxセッション環境で利用可能:
 - `MINION_EXECUTION_ID` — 実行UUID