feat: Load multiple characters from a single remote url (elizaOS#2475)

* Feat: Load multiple characters from a single remote url

* Chore: Added fetch try/catch

* Chore: added parenthesis around s in error message

---------

Co-authored-by: Sayo <hi@sayo.wtf>

Author: leeran7

agent/src/index.ts

@@ -249,10 +249,26 @@ export async function loadCharacterFromOnchain(): Promise<Character[]> {
     }
 }
 
-async function loadCharacterFromUrl(url: string): Promise<Character> {
-    const response = await fetch(url);
-    const character = await response.json();
-    return await jsonToCharacter(url, character);
+
+async function loadCharactersFromUrl(url: string): Promise<Character[]> {
+    try {
+        const response = await fetch(url);
+        const responseJson = await response.json();
+
+        let characters: Character[] = [];
+        if (Array.isArray(responseJson)) {
+            characters = await Promise.all(
+                responseJson.map((character) => jsonToCharacter(url, character))
+            );
+        } else {
+            const character = await jsonToCharacter(url, responseJson);
+            characters.push(character);
+        }
+        return characters;
+    } catch (e) {
+        elizaLogger.error(`Error loading character(s) from ${url}: ${e}`);
+        process.exit(1);
+    }
 }
 
 async function jsonToCharacter(
@@ -388,8 +404,8 @@ export async function loadCharacters(
             process.env.REMOTE_CHARACTER_URLS
         );
         for (const characterUrl of characterUrls) {
-            const character = await loadCharacterFromUrl(characterUrl);
-            loadedCharacters.push(character);
+            const characters = await loadCharactersFromUrl(characterUrl);
+            loadedCharacters.push(...characters);
         }
     }