@elizaos/plugin-feed 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,75 @@
+# @elizaos/plugin-feed
+
+An elizaOS plugin that connects an Eliza agent to the [Feed](https://feed.market) prediction market game. It adds an operator dashboard (standard, XR, and terminal views) and a full HTTP proxy layer so the elizaOS agent can read and write Feed markets, posts, chats, and team state.
+
+## What it does
+
+- Embeds the Feed operator dashboard as a first-class elizaOS view (accessible in the agent manager, desktop tab, and terminal TUI).
+- Proxies requests between the elizaOS API surface and the Feed backend: agent status, market data, prediction trades, perpetual positions, social posts, chat messages, team management, and admin controls.
+- Handles Feed agent authentication automatically, including token caching and auto-refresh on 401.
+- In development, attempts to auto-provision credentials from a local Feed dev server.
+- Exposes a postMessage auth token so the embedded Feed web viewer can authenticate without a separate login.
+
+## Capabilities / views
+
+| View | Type | Description |
+|------|------|-------------|
+| Feed | standard | Full operator dashboard |
+| Feed XR | xr | XR-compatible operator surface |
+| Feed TUI | tui | Terminal operator dashboard with commands: `get-state`, `refresh-agent-status`, `open-live-dashboard`, `send-team-message` |
+
+## Required configuration
+
+Set these env vars (or agent character secrets) before enabling the plugin:
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `FEED_AGENT_ID` | Yes | Your Feed agent identifier |
+| `FEED_AGENT_SECRET` | Yes | Your Feed agent secret |
+| `FEED_API_URL` | No | Feed backend URL (default: `http://localhost:3000` dev, `https://staging.feed.market` prod) |
+| `FEED_APP_URL` | No | Alias for `FEED_API_URL`; used as a fallback when resolving the API base URL and client URL |
+| `FEED_CLIENT_URL` | No | Client URL used for the embedded viewer and launch link |
+| `FEED_A2A_API_KEY` | No | Agent-to-agent API key (`X-Feed-Api-Key` header) |
+
+In `NODE_ENV !== "production"`, the plugin will probe a local Feed dev server for credentials automatically if `FEED_AGENT_ID` and `FEED_AGENT_SECRET` are not set.
+
+## How to enable
+
+Add `@elizaos/plugin-feed` to your agent character's plugin list:
+
+```json
+{
+  "name": "My Agent",
+  "plugins": ["@elizaos/plugin-feed"],
+  "settings": {
+    "secrets": {
+      "FEED_AGENT_ID": "your-agent-id",
+      "FEED_AGENT_SECRET": "your-agent-secret"
+    }
+  }
+}
+```
+
+## Building
+
+```bash
+bun run --cwd plugins/plugin-feed build
+```
+
+This runs three steps: `build:js` (tsup), `build:views` (Vite for the UI bundle), and `build:types` (tsc declarations). Both `build:js` and `build:views` must be run before the plugin works correctly in the elizaOS runtime.
+
+## API routes proxied
+
+The plugin registers routes under `/api/apps/feed/` that proxy to the Feed backend:
+
+- **Agent:** `/agent/status`, `/agent/activity`, `/agent/logs`, `/agent/wallet`, `/agent/goals`, `/agent/stats`, `/agent/summary`, `/agent/recent-trades`, `/agent/chat`, `/agent/card`, `/agent/trading-balance`, `/agent/benchmark`, `/agent/autonomy`, `/agent/toggle`
+- **Markets:** `/markets/predictions`, `/markets/predictions/:id`, `/markets/predictions/:id/history`, `/markets/predictions/:id/trades`, `/markets/predictions/:id/buy`, `/markets/predictions/:id/sell`, `/markets/perps`, `/markets/perps/open`, `/markets/perps/preview`, `/markets/perps/position/:id/close`
+- **Social:** `/posts`, `/posts/:id`, `/posts/:id/comments`, `/posts/:id/like`
+- **Messaging:** `/chats`, `/chats/dm`, `/chats/:id/messages`, `/chats/:id/message`
+- **Groups:** `/groups`, `/groups/:id`, `/groups/:id/members`
+- **Team:** `/team`, `/team/info`, `/team/chat`, `/team/dashboard`, `/team/conversations`
+- **Feed:** `/feed/for-you`, `/feed/hot`, `/trades`
+- **Agents:** `/agents/discover`
+- **Admin:** `/admin/agents/pause-all`, `/admin/agents/resume-all`
+- **SSE:** `/sse` — streams Feed's server-sent events to the client
+- **Session:** `/session/:id`, `/session/:id/message`, `/session/:id/control`

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "@elizaos/plugin-feed",
+  "version": "2.0.3-beta.2",
+  "type": "module",
+  "description": "Eliza app integration for Feed prediction market game.",
+  "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"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elizaos/eliza.git"
+  },
+  "keywords": [
+    "game",
+    "prediction-market",
+    "feed",
+    "elizaos",
+    "eliza"
+  ],
+  "dependencies": {
+    "@elizaos/app-core": "2.0.3-beta.2",
+    "@elizaos/core": "2.0.3-beta.2",
+    "@elizaos/shared": "2.0.3-beta.2",
+    "@elizaos/ui": "2.0.3-beta.2"
+  },
+  "elizaos": {
+    "app": {
+      "displayName": "Feed",
+      "category": "game",
+      "heroImage": "assets/hero.png",
+      "launchType": "url",
+      "launchUrl": "{FEED_CLIENT_URL}",
+      "capabilities": [
+        "trades",
+        "prediction-markets",
+        "social",
+        "team-chat",
+        "autonomous"
+      ],
+      "uiExtension": {
+        "detailPanelId": "feed-operator-dashboard"
+      },
+      "viewer": {
+        "url": "{FEED_CLIENT_URL}",
+        "embedParams": {
+          "embedded": "true"
+        },
+        "postMessageAuth": true,
+        "sandbox": "allow-scripts allow-same-origin allow-popups allow-forms"
+      },
+      "session": {
+        "mode": "spectate-and-steer",
+        "features": [
+          "commands",
+          "telemetry",
+          "pause",
+          "resume"
+        ]
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "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",
+    "test": "vitest run --config vitest.config.ts"
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": "^19.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.0"
+  },
+  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc"
+}