@elizaos/plugin-vincent 2.0.3-beta.5

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,84 @@
+# @elizaos/plugin-vincent
+
+Adds Vincent trading integration to an [elizaOS](https://github.com/elizaOS/eliza) agent. Vincent ([heyvincent.ai](https://heyvincent.ai)) provides OAuth-gated trading access on Hyperliquid and Polymarket.
+
+## What this plugin provides
+
+- **OAuth connection flow** — server-side PKCE OAuth against Vincent. The agent handles the code verifier; the user's browser visits the Vincent authorization page and is redirected back. No secrets are exposed to the browser.
+- **Trading strategy management** — configure a named strategy (`dca`, `rebalance`, `threshold`, or `manual`) with params, execution interval, and dry-run mode, stored in the agent config.
+- **Dashboard UI** — a full-screen React view showing connection status, wallet addresses and balances, strategy settings, and P&L analytics. Available in desktop, XR, and terminal (TUI) variants.
+
+## Capabilities added
+
+| Capability | Description |
+|------------|-------------|
+| Vincent OAuth | Connect/disconnect a Vincent account via PKCE OAuth |
+| Connection status | Poll whether Vincent is connected and which venues are available |
+| Strategy config | Read and update the active trading strategy |
+| Trading profile | Retrieve P&L analytics (via Vincent API) |
+| Wallet overview | Display the agent's EVM and Solana wallet addresses and balances |
+
+## API routes registered
+
+All routes use `rawPath: true` — they appear at these exact paths regardless of plugin prefix:
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `POST` | `/api/vincent/start-login` | Begin OAuth: returns `authUrl` to open in browser |
+| `GET` | `/callback/vincent` | OAuth redirect landing page; exchanges code for tokens |
+| `GET` | `/api/vincent/status` | Connection status and available trading venues |
+| `POST` | `/api/vincent/disconnect` | Clear stored Vincent credentials |
+| `GET` | `/api/vincent/trading-profile` | P&L profile data |
+| `GET` | `/api/vincent/strategy` | Current strategy configuration |
+| `POST` | `/api/vincent/strategy` | Update strategy configuration |
+
+## Enabling the plugin
+
+Add `vincentPlugin` to your agent's plugin list:
+
+```ts
+import { vincentPlugin } from "@elizaos/plugin-vincent";
+
+const agent = {
+  plugins: [vincentPlugin],
+  // ...
+};
+```
+
+The overlay app self-registers when the package is imported, making the Vincent dashboard available in the UI apps grid.
+
+## Configuration
+
+The plugin stores its state in the elizaOS agent config file (no additional env vars required). After a successful OAuth flow the following fields are written to config:
+
+| Field | Description |
+|-------|-------------|
+| `vincent.accessToken` | Vincent OAuth access token |
+| `vincent.refreshToken` | OAuth refresh token (if provided) |
+| `vincent.clientId` | Dynamically registered OAuth client ID |
+| `vincent.connectedAt` | Unix timestamp of connection |
+| `trading.strategy` | Strategy name: `dca`, `rebalance`, `threshold`, or `manual` |
+| `trading.params` | Strategy-specific parameter object |
+| `trading.intervalSeconds` | Execution interval in seconds |
+| `trading.dryRun` | Whether to run in dry-run mode |
+
+The Vincent API base URL (`https://heyvincent.ai`) is not configurable via env var.
+
+## OAuth flow
+
+1. The UI calls `POST /api/vincent/start-login`.
+2. The agent registers a dynamic OAuth client with Vincent, generates a PKCE challenge, and returns an `authUrl`.
+3. The UI opens `authUrl` in the system browser.
+4. The user authenticates; Vincent redirects to `GET /callback/vincent` on the local agent server.
+5. The agent exchanges the authorization code for tokens using the stored PKCE verifier and persists them.
+6. The UI polls `GET /api/vincent/status` until `connected: true`.
+
+Pending login sessions expire after 10 minutes. A server restart during a flow requires restarting the login.
+
+## Development
+
+```bash
+bun run --cwd plugins/plugin-vincent build     # full build
+bun run --cwd plugins/plugin-vincent test      # unit tests
+bun run --cwd plugins/plugin-vincent clean     # clean dist
+```

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@elizaos/plugin-vincent",
+  "version": "2.0.3-beta.5",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "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"
+    }
+  },
+  "dependencies": {
+    "@elizaos/agent": "2.0.3-beta.5",
+    "@elizaos/app-core": "2.0.3-beta.5",
+    "@elizaos/core": "2.0.3-beta.5",
+    "@elizaos/shared": "2.0.3-beta.5",
+    "@elizaos/ui": "2.0.3-beta.5",
+    "lucide-react": "^1.0.0",
+    "react": "^19.0.0"
+  },
+  "elizaos": {
+    "app": {
+      "heroImage": "assets/hero.png"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "bun run build:js && bun run build:views && bun run build:types",
+    "clean": "node ../../packages/scripts/rm-path-recursive.mjs dist",
+    "test": "vitest run --config vitest.config.ts",
+    "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",
+    "typecheck": "tsgo --noEmit -p tsconfig.build.json",
+    "test:e2e:manual": "vitest run --config ../../vitest.config.ts test/*.real.e2e.test.ts"
+  },
+  "files": [
+    "registry-entry.json",
+    "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",
+    "vite": "^8.0.0",
+    "vitest": "^4.1.5"
+  },
+  "gitHead": "ff6157011c9459670021cc28a6797592a78b8817"
+}

package/registry-entry.json

@@ -0,0 +1,36 @@
+{
+  "id": "vincent",
+  "name": "Vincent",
+  "description": "Connect Vincent to trade on Hyperliquid and Polymarket through Vincent's agent.",
+  "npmName": "@elizaos/plugin-vincent",
+  "source": "bundled",
+  "tags": ["trading", "hyperliquid", "polymarket", "prediction-markets"],
+  "config": {},
+  "render": {
+    "visible": true,
+    "pinTo": [],
+    "style": "hero-card",
+    "icon": "Wallet",
+    "group": "Curated",
+    "groupOrder": 6,
+    "actions": ["launch", "configure"]
+  },
+  "resources": {},
+  "dependsOn": ["wallet"],
+  "kind": "app",
+  "subtype": "trading",
+  "launch": {
+    "type": "server-launch",
+    "capabilities": ["vincent", "delegated-trading", "wallet"],
+    "curatedSlug": "vincent",
+    "routePlugin": {
+      "specifier": "@elizaos/plugin-vincent/plugin",
+      "exportName": "vincentPlugin"
+    }
+  },
+  "curatedApp": {
+    "slug": "vincent",
+    "order": 5,
+    "aliases": []
+  }
+}