@elizaos/plugin-inbox 2.0.3-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,99 @@
+# @elizaos/plugin-inbox
+
+Unified cross-channel inbox triage with unresolved-item tracking, snooze, archive, and follow-up watcher. Drives the inbox-zero workflow.
+
+## Scope
+
+Aggregates threads across email, Discord, Telegram, WhatsApp, Slack, X, Farcaster, iMessage, and similar connected channels into one triage queue.
+
+**Out of scope:** Android SMS — that remains in `@elizaos/plugin-messages`.
+
+## Plugin surface
+
+### Action
+
+`INBOX` — op-based dispatch. Ops: `list`, `search`, `summarize`.
+
+- `list` — fan-out fetch across all connected platform adapters (gmail, discord, telegram, signal, imessage, whatsapp), dedupe by message id and thread topic, return merged feed ordered by recency.
+- `search` — search across selected platforms by `query`.
+- `summarize` — return a per-platform count plus a single rolled-up summary.
+
+Fetchers are injectable via `setInboxFetchers` for tests. Owner-only.
+
+### Providers
+
+- `inboxTriage` (position `14`) — injects the user's pending triage queue (urgent, needs_reply, recent auto-replies) into owner context from the `InboxRepository`.
+- `crossChannelContext` (position `-3`) — injects recent triage entries from the current message sender across other channels (resolved by entityId then senderName). Owner-only, silently empty when no cross-channel history exists.
+
+### Service
+
+`InboxService` (`src/inbox/service.ts`) — `triage()`, `curate()`, `triageWithCuration()`, `search()`, `list()`, `digest()`, `resolve()`. No dependency on `@elizaos/plugin-personal-assistant`.
+
+### Schema
+
+`pgSchema('app_inbox')` with three tables:
+
+- `triage_decisions` — history of decisions per (thread, decision-event).
+- `snoozed` — threads to re-surface at `wake_at`.
+- `archived` — threads explicitly removed from the active inbox.
+
+### View
+
+`/inbox` — `InboxView` component. Minimal placeholder UI (header, channel filter chips, empty thread list) until the full triage drawer / snooze picker / approval queue lands.
+
+## Layout
+
+```
+src/
+  index.ts                            Public API barrel
+  plugin.ts                           inboxPlugin Plugin object
+  types.ts                            TriageDecision, ThreadSummary, channel + decision enums
+  actions/
+    inbox.ts                          INBOX umbrella action (list/search/summarize fan-out)
+  providers/
+    inbox-triage.ts                   inboxTriage provider — pending triage queue (position 14)
+    cross-channel-context.ts          crossChannelContext provider — sender cross-channel history (position -3)
+  inbox/
+    service.ts                        InboxService — triage/curate/search/list/digest/resolve
+    repository.ts                     InboxRepository — raw SQL over app_lifeops.life_inbox_triage_*
+    types.ts                          InboundMessage, TriageEntry, TriageClassification, etc.
+    triage-classifier.ts              LLM classification of inbound messages
+    email-curation.ts                 Email curation engine (save/archive/delete decisions)
+    config.ts                         loadInboxTriageConfig()
+    message-fetcher.ts                Per-platform message fetchers
+    channel-deep-links.ts             Channel deep-link helpers
+    reflection.ts                     Inbox reflection utilities
+  db/
+    index.ts                          re-exports schema.ts
+    schema.ts                         drizzle pgSchema('app_inbox') + tables
+  components/
+    inbox/
+      InboxView.tsx                   Minimal React inbox view
+      inbox-view-bundle.ts            Vite bundle entry — re-exports InboxView
+```
+
+## Commands
+
+```bash
+bun run --cwd plugins/plugin-inbox typecheck    # tsc --noEmit
+bun run --cwd plugins/plugin-inbox lint         # biome check src/
+bun run --cwd plugins/plugin-inbox test         # vitest run
+bun run --cwd plugins/plugin-inbox build        # build:js + build:views + build:types
+bun run --cwd plugins/plugin-inbox build:js     # tsup
+bun run --cwd plugins/plugin-inbox build:views  # vite build (overlay bundle)
+bun run --cwd plugins/plugin-inbox build:types  # tsc declaration emit
+bun run --cwd plugins/plugin-inbox clean        # rm -rf dist
+```
+
+## Config / env vars
+
+None. Channel credentials are read from each provider plugin (`plugin-discord`, `plugin-telegram`, etc.).
+
+## Conventions / gotchas
+
+- **`GET /api/lifeops/inbox` lives in `plugin-personal-assistant`.** The `InboxView` fetches from this route (served by PA). The triage domain (classify/persist/search) lives here and is imported by PA.
+- **`@elizaos/plugin-sql` must be loaded first.** The schema registration relies on `runtime.db`.
+- **No Android SMS.** SMS routing intentionally stays in `plugin-messages`. Do not add SMS channel handling here.
+- **Schema name is `app_inbox`** to avoid collision with any host-app `inbox` table the runtime might also surface.
+- **Two build steps.** The JS/types build (tsup + tsc) and the Vite views build are separate. Both must be run for a complete build.
+- See the root `AGENTS.md` for repo-wide architecture rules, logger requirements, ESM/module standards, and the cloud-frontend visual-review gate (if any of this plugin's UI ends up in `cloud-frontend`).

package/assets/hero.svg

@@ -0,0 +1,67 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1024 1024" width="1024" height="1024" role="img" aria-label="Inbox">
+  <defs>
+    <linearGradient id="bg-inbox" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#152824"/>
+      <stop offset="1" stop-color="#0b1919"/>
+    </linearGradient>
+    <radialGradient id="blobA-inbox" cx="0.5" cy="0.5" r="0.5">
+      <stop offset="0" stop-color="#2fdab8" stop-opacity="0.55"/>
+      <stop offset="1" stop-color="#2fdab8" stop-opacity="0"/>
+    </radialGradient>
+    <radialGradient id="blobB-inbox" cx="0.5" cy="0.5" r="0.5">
+      <stop offset="0" stop-color="#2899c3" stop-opacity="0.5"/>
+      <stop offset="1" stop-color="#2899c3" stop-opacity="0"/>
+    </radialGradient>
+    <radialGradient id="vig-inbox" cx="0.5" cy="0.42" r="0.75">
+      <stop offset="0" stop-color="#000000" stop-opacity="0"/>
+      <stop offset="0.72" stop-color="#000000" stop-opacity="0"/>
+      <stop offset="1" stop-color="#000000" stop-opacity="0.5"/>
+    </radialGradient>
+    <linearGradient id="label-inbox" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#000000" stop-opacity="0"/>
+      <stop offset="1" stop-color="#000000" stop-opacity="0.55"/>
+    </linearGradient>
+    <filter id="soft-inbox" x="-30%" y="-30%" width="160%" height="160%">
+      <feGaussianBlur stdDeviation="46"/>
+    </filter>
+    <filter id="iglow-inbox" x="-40%" y="-40%" width="180%" height="180%">
+      <feDropShadow dx="0" dy="0" stdDeviation="14" flood-color="#45edcb" flood-opacity="0.45"/>
+    </filter>
+  </defs>
+
+  <rect width="1024" height="1024" fill="url(#bg-inbox)"/>
+
+  <g opacity="0.9">
+    <circle cx="232" cy="220" r="300" fill="url(#blobA-inbox)" filter="url(#soft-inbox)"/>
+    <circle cx="840" cy="800" r="340" fill="url(#blobB-inbox)" filter="url(#soft-inbox)"/>
+  </g>
+
+  <g stroke="#d7eae6" stroke-width="1.4" opacity="0.06">
+    <line x1="0" y1="256" x2="1024" y2="256"/>
+    <line x1="0" y1="512" x2="1024" y2="512"/>
+    <line x1="0" y1="768" x2="1024" y2="768"/>
+    <line x1="256" y1="0" x2="256" y2="1024"/>
+    <line x1="512" y1="0" x2="512" y2="1024"/>
+    <line x1="768" y1="0" x2="768" y2="1024"/>
+  </g>
+
+  <g opacity="0.5">
+    <path d="M120 470 A 400 400 0 0 1 904 470" fill="none" stroke="#45edcb" stroke-width="3" opacity="0.35"/>
+  </g>
+
+  <g transform="translate(512 432)" filter="url(#iglow-inbox)"
+     color="#d7eae6" stroke="#d7eae6" stroke-width="20"
+     stroke-linecap="round" stroke-linejoin="round" fill="none">
+    <path d="M-150 -40 L-110 -130 H110 L150 -40 V120 A20 20 0 0 1 130 140 H-130 A20 20 0 0 1 -150 120 Z"/>
+    <path d="M-150 -40 H-44 L-10 24 H10 L44 -40 H150"/>
+  </g>
+
+  <rect x="0" y="784" width="1024" height="240" fill="url(#label-inbox)"/>
+  <text x="512" y="892" text-anchor="middle"
+        font-family="system-ui, -apple-system, Segoe UI, Roboto, sans-serif"
+        font-size="76" font-weight="600" letter-spacing="0.5"
+        fill="#d7eae6">Inbox</text>
+  <rect x="460" y="924" width="104" height="6" rx="3" fill="#45edcb"/>
+
+  <rect width="1024" height="1024" fill="url(#vig-inbox)"/>
+</svg>

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "@elizaos/plugin-inbox",
+  "version": "2.0.3-beta.2",
+  "type": "module",
+  "description": "Unified cross-channel inbox triage with unresolved-item tracking, snooze, archive, and follow-up watcher. Drives the inbox-zero workflow across email/Discord/Telegram/WhatsApp/X/Slack and other non-SMS channels.",
+  "main": "./dist/index.js",
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "lint": "bunx @biomejs/biome check src/",
+    "test": "bunx vitest run --config ./vitest.config.ts",
+    "build": "bun run build:js && bun run build:views && bun run build:types",
+    "clean": "rm -rf dist",
+    "build:js": "tsup --config ../tsup.plugin-packages.shared.ts",
+    "build:views": "bunx --bun vite build --config vite.config.views.ts",
+    "build:types": "tsc --noCheck -p tsconfig.build.json"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "eliza-source": {
+        "types": "./src/plugin.ts",
+        "import": "./src/plugin.ts",
+        "default": "./src/plugin.ts"
+      },
+      "import": "./dist/plugin.js",
+      "default": "./dist/plugin.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
+    }
+  },
+  "dependencies": {
+    "@elizaos/agent": "2.0.3-beta.2",
+    "@elizaos/app-core": "2.0.3-beta.2",
+    "@elizaos/core": "2.0.3-beta.2",
+    "@elizaos/plugin-google": "2.0.3-beta.2",
+    "@elizaos/shared": "2.0.3-beta.2",
+    "@elizaos/ui": "2.0.3-beta.2",
+    "drizzle-orm": "^0.45.1",
+    "lucide-react": "^1.0.0"
+  },
+  "peerDependencies": {
+    "@elizaos/plugin-sql": "2.0.3-beta.2",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.14",
+    "@types/node": "^25.0.6",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.0",
+    "vitest": "^4.0.17"
+  },
+  "elizaos": {
+    "app": {
+      "displayName": "Inbox",
+      "category": "productivity"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "assets",
+    "dist"
+  ],
+  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc"
+}