@elizaos/plugin-messages 2.0.11-beta.7

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,73 @@
+# @elizaos/plugin-messages
+
+Android SMS plugin for elizaOS. Adds an SMS inbox, thread viewer, and compose surface to the elizaOS agent shell on Android.
+
+## What it does
+
+- Reads SMS threads and message history from the Android SMS store via the native capacitor bridge.
+- Lets users and agents compose and send text messages.
+- Surfaces the Android default SMS role status and prompts to request it when not held.
+- Registers three views: a full overlay app, an XR variant, and a TUI (terminal) variant for agent automation.
+
+## Platform requirement
+
+**Android only.** The plugin is marked `androidOnly: true`. Non-Android runtimes leave overlay app registration unchanged.
+
+## Enabling the plugin
+
+Add `@elizaos/plugin-messages` to the agent's plugin list when constructing the runtime:
+
+```ts
+import messagesPlugin from "@elizaos/plugin-messages";
+
+const runtime = new AgentRuntime({
+  // ...
+  plugins: [messagesPlugin],
+});
+```
+
+## Views registered
+
+| Path | Description |
+|---|---|
+| `/messages` | Full SMS inbox and composer overlay |
+| `/messages` (XR) | XR variant of the same surface |
+| `/messages/tui` | Terminal-style view for agent automation |
+
+## Android SMS role
+
+Reading and sending SMS requires Android to grant the default SMS role (`android.app.role.SMS`) to the elizaOS app. When the role is not held, the UI shows a "Set default SMS" banner. The role can also be requested programmatically through the TUI `interact()` API.
+
+## Agent automation (TUI)
+
+The `MessagesTuiView` component and `interact()` function expose a programmatic terminal API:
+
+```ts
+import { interact } from "@elizaos/plugin-messages/components/MessagesAppView";
+
+// List threads
+const { threads, ownsSmsRole } = await interact("terminal-list-threads", { limit: 50 });
+
+// Send an SMS
+await interact("terminal-send-sms", { address: "+15550100", body: "Hello" });
+
+// Request the default SMS role
+await interact("terminal-request-sms-role");
+```
+
+The TUI view also writes its full state to a `data-view-state` attribute on the root element, which test harnesses and agents can read without parsing inner DOM structure.
+
+## Dependencies
+
+- `@elizaos/capacitor-messages` — native SMS bridge (`Messages.listMessages`, `Messages.sendSms`)
+- `@elizaos/capacitor-system` — system role API (`System.getStatus`, `System.requestRole`)
+- `@elizaos/ui` — shared component library and overlay app registration
+- `@elizaos/core` — plugin type definitions
+
+## Building
+
+```bash
+bun run --cwd plugins/plugin-messages build
+```
+
+This runs `build:js` (tsup library bundle), `build:views` (vite view bundle at `dist/views/bundle.js`), and `build:types` (TypeScript declarations).

package/assets/hero.svg

@@ -0,0 +1,68 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1024 1024" width="1024" height="1024" role="img" aria-label="Messages">
+  <defs>
+    <linearGradient id="bg-messages" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#1a1528"/>
+      <stop offset="1" stop-color="#120b19"/>
+    </linearGradient>
+    <radialGradient id="blobA-messages" cx="0.5" cy="0.5" r="0.5">
+      <stop offset="0" stop-color="#5d2fda" stop-opacity="0.55"/>
+      <stop offset="1" stop-color="#5d2fda" stop-opacity="0"/>
+    </radialGradient>
+    <radialGradient id="blobB-messages" cx="0.5" cy="0.5" r="0.5">
+      <stop offset="0" stop-color="#9928c3" stop-opacity="0.5"/>
+      <stop offset="1" stop-color="#9928c3" stop-opacity="0"/>
+    </radialGradient>
+    <radialGradient id="vig-messages" 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-messages" 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-messages" x="-30%" y="-30%" width="160%" height="160%">
+      <feGaussianBlur stdDeviation="46"/>
+    </filter>
+    <filter id="iglow-messages" x="-40%" y="-40%" width="180%" height="180%">
+      <feDropShadow dx="0" dy="0" stdDeviation="14" flood-color="#7245ed" flood-opacity="0.45"/>
+    </filter>
+  </defs>
+
+  <rect width="1024" height="1024" fill="url(#bg-messages)"/>
+
+  <g opacity="0.9">
+    <circle cx="232" cy="220" r="300" fill="url(#blobA-messages)" filter="url(#soft-messages)"/>
+    <circle cx="840" cy="800" r="340" fill="url(#blobB-messages)" filter="url(#soft-messages)"/>
+  </g>
+
+  <g stroke="#dcd7ea" 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="#7245ed" stroke-width="3" opacity="0.35"/>
+  </g>
+
+  <g transform="translate(512 432)" filter="url(#iglow-messages)"
+     color="#dcd7ea" stroke="#dcd7ea" stroke-width="20"
+     stroke-linecap="round" stroke-linejoin="round" fill="none">
+    <path d="M-150 -120 H150 A24 24 0 0 1 174 -96 V60 A24 24 0 0 1 150 84 H-30 L-100 150 V84 H-150 A24 24 0 0 1 -174 60 V-96 A24 24 0 0 1 -150 -120 Z"/>
+    <line x1="-100" y1="-44" x2="100" y2="-44"/>
+    <line x1="-100" y1="16" x2="40" y2="16"/>
+  </g>
+
+  <rect x="0" y="784" width="1024" height="240" fill="url(#label-messages)"/>
+  <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="#dcd7ea">Messages</text>
+  <rect x="460" y="924" width="104" height="6" rx="3" fill="#7245ed"/>
+
+  <rect width="1024" height="1024" fill="url(#vig-messages)"/>
+</svg>

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@elizaos/plugin-messages",
+  "version": "2.0.11-beta.7",
+  "type": "module",
+  "description": "Android Messages overlay app for ElizaOS — SMS inbox and compose surface backed by @elizaos/capacitor-messages.",
+  "main": "./dist/index.js",
+  "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",
+      "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"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsgo --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"
+  },
+  "dependencies": {
+    "@elizaos/app-core": "2.0.11-beta.7",
+    "@elizaos/capacitor-messages": "2.0.11-beta.7",
+    "@elizaos/capacitor-system": "2.0.11-beta.7",
+    "@elizaos/core": "2.0.11-beta.7",
+    "@elizaos/shared": "2.0.11-beta.7",
+    "@elizaos/ui": "2.0.11-beta.7",
+    "lucide-react": "^1.0.0"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "elizaos": {
+    "app": {
+      "displayName": "Messages",
+      "category": "system",
+      "androidOnly": true,
+      "heroImage": "assets/hero.png"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "assets",
+    "dist"
+  ],
+  "devDependencies": {
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "jsdom": "^29.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"
+  },
+  "gitHead": "cdbc876f793d96073d7eb0d09715a031ce0cd32e"
+}