Merge branch 'develop' into develop

Author: wtfsayo

.env.example

@@ -18,6 +18,9 @@ SUPABASE_ANON_KEY=
 # Comma separated list of remote character urls (optional)
 REMOTE_CHARACTER_URLS=
 
+# Stores characters set by using the direct API in the data/character folder for further load when the app restarts
+USE_CHARACTER_STORAGE=false
+
 # Logging
 DEFAULT_LOG_LEVEL=warn
 LOG_JSON_FORMAT=false            # Print everything in logger as json; false by default
@@ -92,7 +95,7 @@ MEDIUM_OPENAI_MODEL=    # Default: gpt-4o
 LARGE_OPENAI_MODEL=     # Default: gpt-4o
 EMBEDDING_OPENAI_MODEL= # Default: text-embedding-3-small
 IMAGE_OPENAI_MODEL=     # Default: dall-e-3
-USE_OPENAI_EMBEDDING=   # Set to TRUE for OpenAI/1536, leave blank for local
+USE_OPENAI_EMBEDDING=TRUE   # Set to TRUE for OpenAI/1536, leave blank for local
 
 # Community Plugin for OpenAI Configuration
 ENABLE_OPEN_AI_COMMUNITY_PLUGIN=false
@@ -491,6 +494,9 @@ NEAR_NETWORK=testnet # or mainnet
 ZKSYNC_ADDRESS=
 ZKSYNC_PRIVATE_KEY=
 
+# HoldStation Wallet Configuration
+HOLDSTATION_PRIVATE_KEY=
+
 # Avail DA Configuration
 AVAIL_ADDRESS=
 AVAIL_SEED=

.github/workflows/integrationTests.yaml

@@ -1,11 +1,9 @@
 name: Integration Tests
 on:
     push:
-        branches:
-            - "*"
+        branches: ["*"]
     pull_request:
-        branches:
-            - "*"
+        branches: ["*"]
 
 jobs:
     integration-tests:
@@ -15,6 +13,11 @@ jobs:
         steps:
             - uses: actions/checkout@v4
 
+            - name: Setup Node.js
+              uses: actions/setup-node@v4
+              with:
+                  node-version: '23.3'
+
             - name: Cache pnpm
               uses: actions/cache@v4
               with:
@@ -23,28 +26,14 @@ jobs:
                       **/node_modules
                   key: ${{ runner.os }}-pnpm-${{ hashFiles('**/pnpm-lock.yaml') }}
                   restore-keys: ${{ runner.os }}-pnpm-
-
-            - name: Cache plugin dist
-              uses: actions/cache@v4
-              with:
-                  path: |
-                      **/packages/plugin-*/dist
-                  key: ${{ runner.os }}-plugin-dist-${{ hashFiles('**/pnpm-lock.yaml') }}
-                  restore-keys: ${{ runner.os }}-plugin-dist-
-
-            - uses: pnpm/action-setup@v3
+            
+            - name: Setup pnpm
+              uses: pnpm/action-setup@v3
               with:
                   version: 9.15.0
-
-            - uses: actions/setup-node@v4
-              with:
-                  node-version: "23.3.0"
-
-            - name: Clean up
-              run: pnpm clean
-
+            
             - name: Install dependencies
-              run: pnpm install -r --no-frozen-lockfile
+              run: pnpm install --no-frozen-lockfile
 
             - name: Build packages
               run: pnpm build
@@ -53,5 +42,4 @@ jobs:
               env:
                   OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
                   COINBASE_COMMERCE_KEY: ${{ secrets.COINBASE_COMMERCE_KEY }}
-              run: |
-                  pnpm run integrationTests
+              run: pnpm run integrationTests

.gitignore

@@ -9,6 +9,8 @@ concatenated-output.ts
 embedding-cache.json
 packages/plugin-buttplug/intiface-engine
 
+node-compile-cache
+
 .idea
 .DS_Store
 

agent/package.json

@@ -108,6 +108,7 @@
     "@elizaos/plugin-pyth-data": "workspace:*",
     "@elizaos/plugin-openai": "workspace:*",
     "@elizaos/plugin-devin": "workspace:*",
+    "@elizaos/plugin-holdstation": "workspace:*",
     "readline": "1.3.0",
     "ws": "8.18.0",
     "yargs": "17.7.2"

agent/src/index.ts

@@ -17,6 +17,7 @@ import { agentKitPlugin } from "@elizaos/plugin-agentkit";
 import { PrimusAdapter } from "@elizaos/plugin-primus";
 import { lightningPlugin } from "@elizaos/plugin-lightning";
 import { elizaCodeinPlugin, onchainJson } from "@elizaos/plugin-iq6900";
+import { holdstationPlugin } from "@elizaos/plugin-holdstation";
 
 import {
     AgentRuntime,
@@ -390,10 +391,31 @@ function commaSeparatedStringToArray(commaSeparated: string): string[] {
     return commaSeparated?.split(",").map((value) => value.trim());
 }
 
+async function readCharactersFromStorage(characterPaths: string[]): Promise<string[]> {
+    try {
+        const uploadDir = path.join(process.cwd(), "data", "characters");
+        await fs.promises.mkdir(uploadDir, { recursive: true });
+        const fileNames = await fs.promises.readdir(uploadDir);
+        fileNames.forEach(fileName => {
+            characterPaths.push(path.join(uploadDir, fileName));
+        });
+    } catch (err) {
+        elizaLogger.error(`Error reading directory: ${err.message}`);
+    }
+
+    return characterPaths;
+};
+
 export async function loadCharacters(
     charactersArg: string
 ): Promise<Character[]> {
-    const characterPaths = commaSeparatedStringToArray(charactersArg);
+
+    let characterPaths = commaSeparatedStringToArray(charactersArg);
+
+    if(process.env.USE_CHARACTER_STORAGE === "true") {
+        characterPaths = await readCharactersFromStorage(characterPaths);
+    }
+
     const loadedCharacters: Character[] = [];
 
     if (characterPaths?.length > 0) {
@@ -1067,12 +1089,15 @@ export async function createAgent(
                 ? lightningPlugin
                 : null,
             getSecret(character, "OPENAI_API_KEY") &&
-            getSecret(character, "ENABLE_OPEN_AI_COMMUNITY_PLUGIN")
+            parseBooleanFromText(getSecret(character, "ENABLE_OPEN_AI_COMMUNITY_PLUGIN"))
                 ? openaiPlugin
                 : null,
             getSecret(character, "DEVIN_API_TOKEN")
                 ? devinPlugin
                 : null,
+            getSecret(character, "HOLDSTATION_PRIVATE_KEY")
+                ? holdstationPlugin
+                : null,
         ].filter(Boolean),
         providers: [],
         actions: [],
@@ -1250,7 +1275,9 @@ const startAgents = async () => {
         characters = await loadCharacterFromOnchain();
     }
 
-    if ((!onchainJson && charactersArg) || hasValidRemoteUrls()) {
+    const notOnchainJson = !onchainJson || onchainJson == "null";
+
+  if ((notOnchainJson && charactersArg) || hasValidRemoteUrls()) {
         characters = await loadCharacters(charactersArg);
     }
 

packages/client-direct/src/api.ts

@@ -1,6 +1,8 @@
 import express from "express";
 import bodyParser from "body-parser";
 import cors from "cors";
+import path from "path";
+import fs from "fs";
 
 import {
     type AgentRuntime,
@@ -80,6 +82,16 @@ export function createApiRouter(
         res.json({ agents: agentsList });
     });
 
+    router.get('/storage', async (req, res) => {
+        try {
+            const uploadDir = path.join(process.cwd(), "data", "characters");
+            const files = await fs.promises.readdir(uploadDir);
+            res.json({ files });
+        } catch (error) {
+            res.status(500).json({ error: error.message });
+        }
+    });
+
     router.get("/agents/:agentId", (req, res) => {
         const { agentId } = validateUUIDParams(req.params, res) ?? {
             agentId: null,
@@ -127,7 +139,7 @@ export function createApiRouter(
         };
         if (!agentId) return;
 
-        const agent: AgentRuntime = agents.get(agentId);
+        let agent: AgentRuntime = agents.get(agentId);
 
         // update character
         if (agent) {
@@ -137,6 +149,9 @@ export function createApiRouter(
             // if it has a different name, the agentId will change
         }
 
+        // stores the json data before it is modified with added data
+        const characterJson = { ...req.body };
+
         // load character from body
         const character = req.body;
         try {
@@ -152,7 +167,7 @@ export function createApiRouter(
 
         // start it up (and register it)
         try {
-            await directClient.startAgent(character);
+            agent = await directClient.startAgent(character);
             elizaLogger.log(`${character.name} started`);
         } catch (e) {
             elizaLogger.error(`Error starting agent: ${e}`);
@@ -162,6 +177,35 @@ export function createApiRouter(
             });
             return;
         }
+
+        if (process.env.USE_CHARACTER_STORAGE === "true") {
+            try {
+                const filename = `${agent.agentId}.json`;
+                const uploadDir = path.join(
+                    process.cwd(),
+                    "data",
+                    "characters"
+                );
+                const filepath = path.join(uploadDir, filename);
+                await fs.promises.mkdir(uploadDir, { recursive: true });
+                await fs.promises.writeFile(
+                    filepath,
+                    JSON.stringify(
+                        { ...characterJson, id: agent.agentId },
+                        null,
+                        2
+                    )
+                );
+                elizaLogger.info(
+                    `Character stored successfully at ${filepath}`
+                );
+            } catch (error) {
+                elizaLogger.error(
+                    `Failed to store character: ${error.message}`
+                );
+            }
+        }
+
         res.json({
             id: character.id,
             character: character,

packages/client-farcaster/__tests__/cast.test.ts

@@ -0,0 +1,86 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { createTestCast } from './test-utils';
+import { FarcasterClient } from '../src/client';
+import { NeynarAPIClient } from '@neynar/nodejs-sdk';
+
+// Mock dependencies
+vi.mock('@neynar/nodejs-sdk', () => ({
+    NeynarAPIClient: vi.fn().mockImplementation(() => ({
+        publishCast: vi.fn().mockResolvedValue({
+            success: true,
+            cast: {
+                hash: 'cast-1',
+                author: { fid: '123' },
+                text: 'Test cast',
+                timestamp: '2025-01-20T20:00:00Z'
+            }
+        }),
+        fetchBulkUsers: vi.fn().mockResolvedValue({
+            users: [{
+                fid: '123',
+                username: 'test.farcaster',
+                display_name: 'Test User',
+                pfp: {
+                    url: 'https://example.com/pic.jpg'
+                }
+            }]
+        })
+    }))
+}));
+
+describe('Cast Functions', () => {
+    let client: FarcasterClient;
+
+    beforeEach(() => {
+        vi.clearAllMocks();
+        client = new FarcasterClient({
+            runtime: {
+                name: 'test-runtime',
+                memory: new Map(),
+                getMemory: vi.fn(),
+                setMemory: vi.fn(),
+                clearMemory: vi.fn()
+            },
+            url: 'https://api.example.com',
+            ssl: true,
+            neynar: new NeynarAPIClient({ apiKey: 'test-key' }),
+            signerUuid: 'test-signer',
+            cache: new Map(),
+            farcasterConfig: {
+                apiKey: 'test-key',
+                signerUuid: 'test-signer'
+            }
+        });
+    });
+
+    describe('createTestCast', () => {
+        it('should create a cast successfully', async () => {
+            const content = 'Test cast content';
+            const result = await createTestCast(client, content);
+            
+            expect(result).toBeDefined();
+            expect(result.success).toBe(true);
+            expect(result.cast.text).toBe(content);
+            expect(client.neynar.publishCast).toHaveBeenCalledWith({
+                text: content,
+                signerUuid: 'test-signer'
+            });
+        });
+
+        it('should handle cast creation errors', async () => {
+            const content = 'Test cast content';
+            vi.mocked(client.neynar.publishCast).mockRejectedValueOnce(new Error('Cast creation failed'));
+            await expect(createTestCast(client, content)).rejects.toThrow('Cast creation failed');
+        });
+
+        it('should handle empty content', async () => {
+            const content = '';
+            await expect(createTestCast(client, content)).rejects.toThrow('Cast content cannot be empty');
+        });
+
+        it('should handle very long content', async () => {
+            const content = 'a'.repeat(321); // Farcaster limit is 320 characters
+            await expect(createTestCast(client, content)).rejects.toThrow('Cast content too long');
+        });
+    });
+});