Merge branch 'develop' into develop

Author: wtfsayo

.env.example

@@ -31,6 +31,9 @@ DISCORD_APPLICATION_ID=
 DISCORD_API_TOKEN=        # Bot token
 DISCORD_VOICE_CHANNEL_ID= # The ID of the voice channel the bot should join (optional)
 
+# Devin Configuration
+DEVIN_API_TOKEN=         # Get your API key from docs.devin.ai/tutorials/api-integration
+
 # Farcaster Neynar Configuration
 FARCASTER_FID=                # The FID associated with the account your are sending casts from
 FARCASTER_NEYNAR_API_KEY=     # Neynar API key: https://neynar.com/

agent/package.json

@@ -102,10 +102,12 @@
     "@elizaos/plugin-hyperliquid": "workspace:*",
     "@elizaos/plugin-akash": "workspace:*",
     "@elizaos/plugin-quai": "workspace:*",
+    "@elizaos/plugin-lightning": "workspace:*",
     "@elizaos/plugin-b2": "workspace:*",
     "@elizaos/plugin-nft-collections": "workspace:*",
     "@elizaos/plugin-pyth-data": "workspace:*",
     "@elizaos/plugin-openai": "workspace:*",
+    "@elizaos/plugin-devin": "workspace:*",
     "readline": "1.3.0",
     "ws": "8.18.0",
     "yargs": "17.7.2"

agent/src/index.ts

@@ -15,6 +15,7 @@ import { DirectClient } from "@elizaos/client-direct";
 import { agentKitPlugin } from "@elizaos/plugin-agentkit";
 // import { ReclaimAdapter } from "@elizaos/plugin-reclaim";
 import { PrimusAdapter } from "@elizaos/plugin-primus";
+import { lightningPlugin } from "@elizaos/plugin-lightning";
 import { elizaCodeinPlugin, onchainJson } from "@elizaos/plugin-iq6900";
 
 import {
@@ -107,7 +108,10 @@ import { hyperliquidPlugin } from "@elizaos/plugin-hyperliquid";
 import { echoChambersPlugin } from "@elizaos/plugin-echochambers";
 import { dexScreenerPlugin } from "@elizaos/plugin-dexscreener";
 import { pythDataPlugin } from "@elizaos/plugin-pyth-data";
+
 import { openaiPlugin } from '@elizaos/plugin-openai';
+import { devinPlugin } from '@elizaos/plugin-devin';
+
 
 import { zksyncEraPlugin } from "@elizaos/plugin-zksync-era";
 import Database from "better-sqlite3";
@@ -209,7 +213,9 @@ export async function loadCharacterFromOnchain(): Promise<Character[]> {
 
         // .id isn't really valid
         const characterId = character.id || character.name;
-        const characterPrefix = `CHARACTER.${characterId.toUpperCase().replace(/ /g, "_")}.`;
+        const characterPrefix = `CHARACTER.${characterId
+            .toUpperCase()
+            .replace(/ /g, "_")}.`;
 
         const characterSettings = Object.entries(process.env)
             .filter(([key]) => key.startsWith(characterPrefix))
@@ -281,7 +287,9 @@ async function jsonToCharacter(
 
     // .id isn't really valid
     const characterId = character.id || character.name;
-    const characterPrefix = `CHARACTER.${characterId.toUpperCase().replace(/ /g, "_")}.`;
+    const characterPrefix = `CHARACTER.${characterId
+        .toUpperCase()
+        .replace(/ /g, "_")}.`;
     const characterSettings = Object.entries(process.env)
         .filter(([key]) => key.startsWith(characterPrefix))
         .reduce((settings, [key, value]) => {
@@ -391,8 +399,9 @@ export async function loadCharacters(
     if (characterPaths?.length > 0) {
         for (const characterPath of characterPaths) {
             try {
-                const character: Character =
-                    await loadCharacterTryPath(characterPath);
+                const character: Character = await loadCharacterTryPath(
+                    characterPath
+                );
                 loadedCharacters.push(character);
             } catch (e) {
                 process.exit(1);
@@ -555,9 +564,10 @@ export function getTokenForProvider(
                 settings.VENICE_API_KEY
             );
         case ModelProviderName.ATOMA:
-             return (
-                 character.settings?.secrets?.ATOMASDK_BEARER_AUTH ||
-                 settings.ATOMASDK_BEARER_AUTH
+            return (
+                character.settings?.secrets?.ATOMASDK_BEARER_AUTH ||
+                settings.ATOMASDK_BEARER_AUTH
+            );
         case ModelProviderName.NVIDIA:
             return (
                 character.settings?.secrets?.NVIDIA_API_KEY ||
@@ -1051,9 +1061,18 @@ export async function createAgent(
             getSecret(character, "PYTH_MAINNET_PROGRAM_KEY")
                 ? pythDataPlugin
                 : null,
-            getSecret(character, "OPENAI_API_KEY") && getSecret(character, "ENABLE_OPEN_AI_COMMUNITY_PLUGIN")
+            getSecret(character, "LND_TLS_CERT") &&
+            getSecret(character, "LND_MACAROON") &&
+            getSecret(character, "LND_SOCKET")
+                ? lightningPlugin
+                : null,
+            getSecret(character, "OPENAI_API_KEY") &&
+            getSecret(character, "ENABLE_OPEN_AI_COMMUNITY_PLUGIN")
                 ? openaiPlugin
                 : null,
+            getSecret(character, "DEVIN_API_TOKEN")
+                ? devinPlugin
+                : null,
         ].filter(Boolean),
         providers: [],
         actions: [],
@@ -1297,4 +1316,3 @@ if (
         console.error("unhandledRejection", err);
     });
 }
-

packages/client-telegram/README.md

@@ -4,16 +4,43 @@ This plugin integrates a Telegram client with ElizaOS, allowing characters in El
 
 ## Features
 
-- **Seamless Telegram Integration**: Connects ElizaOS characters to Telegram through the bot API.
-- **Configuration Validation**: Ensures required settings are properly configured before starting.
-- **Startup Logging**: Logs successful initialization of the Telegram client for better debugging.
-- **Future-proof Design**: Provides a basic structure for stopping the client (currently unsupported).
+-   **Seamless Telegram Integration**: Connects ElizaOS characters to Telegram through the bot API.
+-   **Configuration Validation**: Ensures required settings are properly configured before starting.
+-   **Startup Logging**: Logs successful initialization of the Telegram client for better debugging.
+-   **Future-proof Design**: Provides a basic structure for stopping the client (currently unsupported).
 
 ## Configuration
 
 Before starting the plugin, ensure the following environment variables or settings are configured:
 
 TELEGRAM_BOT_TOKEN: The bot token obtained from the Telegram BotFather.
 
-## License
+## Pre-Requisites
+
+1. Add the token to the `.env` file in the project root:
+
+```env
+TELEGRAM_BOT_TOKEN=your-bot-token
+```
+
+2. Add the same token to your character configuration file:
+
+Create or modify `characters/your-character.json`:
 
+````json
+{
+  "clients": ["telegram"],
+  "secrets": {
+    "key": "<your-bot-token>"
+  }
+}
++```
+
+## From the project root:
+npm run dev
+
+# Or using pnpm:
+pnpm start --character="characters/your-character.json"
+
+## License
+````

packages/plugin-agentkit/src/index.ts

@@ -10,15 +10,26 @@ console.log("│  Initializing AgentKit Plugin...       │");
 console.log("│  Version: 0.0.1                        │");
 console.log("└════════════════════════════════════════┘");
 
+const initializeActions = async () => {
+    try {
+        const actions = await getAgentKitActions({
+            getClient,
+        });
+        console.log("✔ AgentKit actions initialized successfully.");
+        return actions;
+    } catch (error) {
+        console.error("❌ Failed to initialize AgentKit actions:", error);
+        return null;
+    }
+};
+
 export const agentKitPlugin: Plugin = {
     name: "[AgentKit] Integration",
     description: "AgentKit integration plugin",
     providers: [walletProvider],
     evaluators: [],
     services: [],
-    actions: await getAgentKitActions({
-        getClient,
-    }),
+    actions: await initializeActions(),
 };
 
 export default agentKitPlugin;

packages/plugin-devin/README.md

@@ -0,0 +1,79 @@
+# @elizaos/plugin-devin
+
+Devin API integration plugin for Eliza, providing automated engineering assistance through the Devin API.
+
+## Installation
+
+```bash
+pnpm add @elizaos/plugin-devin
+```
+
+## Configuration
+
+The plugin requires a Devin API token for authentication. Set the following environment variable:
+
+```bash
+DEVIN_API_TOKEN=your_api_token_here
+```
+
+Or configure it in your Eliza runtime settings:
+
+```typescript
+runtime.setSetting("DEVIN_API_TOKEN", "your_api_token_here");
+```
+
+## Features
+
+- Session Management: Create and manage Devin engineering sessions
+- State Tracking: Monitor session status and progress
+- Client Agnostic: Works with any Eliza client implementation
+- Rate Limiting: Built-in API request rate limiting
+- Error Handling: Comprehensive error handling with retries
+
+## Usage
+
+### Actions
+
+#### START_DEVIN_SESSION
+
+Creates a new Devin session with the specified prompt.
+
+```typescript
+const result = await runtime.runAction("START_DEVIN_SESSION", {
+    content: { text: "Help me refactor this code" }
+});
+```
+
+### Providers
+
+#### devinProvider
+
+Manages Devin session state and provides session information.
+
+```typescript
+const state = await runtime.getState();
+const devinState = state.devin;
+
+// Access session details
+console.log(devinState.sessionId);
+console.log(devinState.status);
+console.log(devinState.url);
+```
+
+## Testing
+
+Run the test suite:
+
+```bash
+pnpm test
+```
+
+## API Documentation
+
+For detailed API documentation, visit:
+- [Devin API Integration Guide](https://docs.devin.ai/tutorials/api-integration)
+- [External API Reference](https://docs.devin.ai/external-api/)
+
+## License
+
+MIT