Feature/jsdoc lift 2

.devcontainer/devcontainer.json

@@ -10,8 +10,8 @@
     },
     "privileged": true,
     "runArgs": [
-        "-p=3000:3000", // Add port for server api
-        "-p=5173:5173", // Add port for client
+        "-p 3000:3000", // Add port for server api
+        "-p 5173:5173", // Add port for client
         //"--volume=/usr/lib/wsl:/usr/lib/wsl", // uncomment for WSL
         //"--volume=/mnt/wslg:/mnt/wslg", // uncomment for WSL
         "--gpus=all", // ! uncomment for vGPU
@@ -35,4 +35,4 @@
         }
     },
     "features": {}
-}
+}

.env.example

@@ -352,6 +352,22 @@ SMALL_LMSTUDIO_MODEL=  # Default: hermes-3-llama-3.1-8b
 MEDIUM_LMSTUDIO_MODEL= # Default: hermes-3-llama-3.1-8b
 LARGE_LMSTUDIO_MODEL=  # Default: hermes-3-llama-3.1-8b
 
+# Secret AI Configuration
+SECRET_AI_API_KEY=            # Secret AI API Key
+SECRET_AI_URL=                # Default: https://ai1.scrtlabs.com:21434
+SMALL_SECRET_AI_MODEL=        # Default: deepseek-r1:70b
+MEDIUM_SECRET_AI_MODEL=       # Default: deepseek-r1:70b
+LARGE_SECRET_AI_MODEL=        # Default: deepseek-r1:70b
+
+# NEAR AI (https://near.ai) Configuration
+NEARAI_API_URL=      # Default: https://api.near.ai/v1
+NEARAI_API_KEY=      # NEAR AI API Key (optional). If you have run `nearai login` with NEAR AI CLI, the API key will be parsed from `~/.nearai/config.json`: https://docs.near.ai/agents/quickstart/
+NEARAI_MODEL=
+SMALL_NEARAI_MODEL=  # Default: fireworks::accounts/fireworks/models/llama-v3p2-3b-instruct
+MEDIUM_NEARAI_MODEL= # Default: fireworks::accounts/fireworks/models/llama-v3p1-70b-instruct
+LARGE_NEARAI_MODEL=  # Default: fireworks::accounts/fireworks/models/llama-v3p1-405b-instruct
+IMAGE_NEARAI_MODEL=   # Default: fireworks::accounts/fireworks/models/playground-v2-5-1024px-aesthetic
+
 # Remaining Provider Configurations
 GOOGLE_GENERATIVE_AI_API_KEY= # Gemini API key
 ALI_BAILIAN_API_KEY=          # Ali Bailian API Key
@@ -423,7 +439,7 @@ ABSTRACT_RPC_URL=https://api.testnet.abs.xyz
 # Starknet Configuration
 STARKNET_ADDRESS=
 STARKNET_PRIVATE_KEY=
-STARKNET_RPC_URL=
+STARKNET_RPC_URL=https://rpc.starknet-testnet.lava.build
 
 # Lens Network Configuration
 LENS_ADDRESS=
@@ -555,7 +571,7 @@ NEAR_WALLET_SECRET_KEY= # NEAR Wallet Secret Key
 NEAR_WALLET_PUBLIC_KEY= # NEAR Wallet Public Key
 NEAR_ADDRESS=
 NEAR_SLIPPAGE=1
-NEAR_RPC_URL=https://rpc.testnet.near.org
+NEAR_RPC_URL=https://near-testnet.lava.build
 NEAR_NETWORK=testnet # or mainnet
 
 # ZKsync Era Configuration
@@ -970,7 +986,6 @@ BUNDLE_EXECUTOR_ADDRESS=          # Address of the bundle executor contract
 DESK_EXCHANGE_PRIVATE_KEY=                  # Required for trading and cancelling orders
 DESK_EXCHANGE_NETWORK=                      # "mainnet" or "testnet
 
-
 # Compass plugin configuration
 COMPASS_WALLET_PRIVATE_KEY=
 COMPASS_ARBITRUM_RPC_URL=
@@ -983,4 +998,4 @@ DATA_AUTH_TOKEN=       # Your d.a.t.a auth token
 
 # NKN Configuration
 NKN_CLIENT_PRIVATE_KEY=           # Required, NKN client private key
-NKN_CLIENT_ID=                    # Optional, NKN client ID
+NKN_CLIENT_ID=                    # Optional, NKN client ID

.github/pull_request_template.md

@@ -78,7 +78,7 @@ None: Automated tests are acceptable.
 ## Deployment instructions
 -->
 
-<!-- If you are on Discord, please join https://discord.gg/ai16z and state your Discord username here for the contributor role and join us in #development-feed -->
+<!-- If you are on Discord, please join https://discord.gg/elizaOS and state your Discord username here for the contributor role and join us in #development-feed -->
 <!--
 ## Discord username
 

.github/workflows/integrationTests.yaml

@@ -14,7 +14,7 @@ jobs:
       OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
       TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
       TURBO_TEAM: ${{ vars.TURBO_TEAM }}
-      TURBO_REMOTE_ONLY: true
+      TURBO_CACHE: remote:rw
     steps:
       - uses: actions/checkout@v4
         with:
@@ -43,4 +43,4 @@ jobs:
           fi
 
       - name: Run integration tests
-        run: pnpm run integrationTests
+        run: pnpm run integrationTests

.github/workflows/smoke-tests.yml

@@ -14,7 +14,7 @@ jobs:
       OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
       TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
       TURBO_TEAM: ${{ vars.TURBO_TEAM }}
-      TURBO_REMOTE_ONLY: true
+      TURBO_CACHE: remote:rw
     steps:
       - uses: actions/checkout@v4
         with:

.npmrc

@@ -1,2 +1 @@
-node-linker=hoisted
-frozen-lockfile=true
+frozen-lockfile=true

agent/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@elizaos/agent",
-    "version": "0.25.7",
+    "version": "0.25.8",
     "main": "src/index.ts",
     "type": "module",
     "scripts": {

agent/src/index.ts

@@ -1,17 +1,17 @@
 import { DirectClient } from "@elizaos/client-direct";
 import {
+    type Adapter,
     AgentRuntime,
     CacheManager,
     CacheStore,
     type Character,
+    type ClientInstance,
     DbCacheAdapter,
     elizaLogger,
     FsCacheAdapter,
     type IAgentRuntime,
     type IDatabaseAdapter,
     type IDatabaseCacheAdapter,
-    type ClientInstance,
-    type Adapter,
     ModelProviderName,
     parseBooleanFromText,
     settings,
@@ -24,6 +24,7 @@ import { bootstrapPlugin } from "@elizaos/plugin-bootstrap";
 
 import fs from "fs";
 import net from "net";
+import os from "os";
 import path from "path";
 import { fileURLToPath } from "url";
 import yargs from "yargs";
@@ -212,6 +213,13 @@ async function jsonToCharacter(
     }
     // Handle plugins
     character.plugins = await handlePluginImporting(character.plugins);
+
+    // Handle Post Processors plugins
+    if (character.postProcessors?.length > 0) {
+        character.postProcessors = await handlePluginImporting(character.postProcessors);
+    }
+
+    // Handle extends
     if (character.extends) {
         elizaLogger.info(
             `Merging  ${character.name} character with parent characters`
@@ -367,6 +375,7 @@ async function handlePluginImporting(plugins: string[]) {
                     const functionName =
                         plugin
                             .replace("@elizaos/plugin-", "")
+                            .replace("@elizaos-plugins/plugin-", "")
                             .replace(/-./g, (x) => x[1].toUpperCase()) +
                         "Plugin"; // Assumes plugin function is camelCased with Plugin suffix
                     return (
@@ -544,6 +553,23 @@ export function getTokenForProvider(
                 character.settings?.secrets?.LIVEPEER_GATEWAY_URL ||
                 settings.LIVEPEER_GATEWAY_URL
             );
+        case ModelProviderName.SECRETAI:
+            return (
+                character.settings?.secrets?.SECRET_AI_API_KEY ||
+                settings.SECRET_AI_API_KEY
+            );
+        case ModelProviderName.NEARAI:
+            try {
+                const config = JSON.parse(fs.readFileSync(path.join(os.homedir(), '.nearai/config.json'), 'utf8'));
+                return JSON.stringify(config?.auth);
+            } catch (e) {
+                elizaLogger.warn(`Error loading NEAR AI config: ${e}`);
+            }
+            return (
+                character.settings?.secrets?.NEARAI_API_KEY ||
+                settings.NEARAI_API_KEY
+            );
+
         default:
             const errorMessage = `Failed to get token - unsupported model provider: ${provider}`;
             elizaLogger.error(errorMessage);
@@ -773,6 +799,26 @@ const hasValidRemoteUrls = () =>
     process.env.REMOTE_CHARACTER_URLS !== "" &&
     process.env.REMOTE_CHARACTER_URLS.startsWith("http");
 
+/**
+ * Post processing of character after loading
+ * @param character
+ */
+const handlePostCharacterLoaded = async (character: Character): Promise<Character> => {
+    let processedCharacter = character;
+    // Filtering the plugins with the method of handlePostCharacterLoaded
+    const processors = character?.postProcessors?.filter(p => typeof p.handlePostCharacterLoaded === 'function');
+    if (processors?.length > 0) {
+        processedCharacter = Object.assign({}, character, { postProcessors: undefined });
+        // process the character with each processor
+        // the order is important, so we loop through the processors
+        for (let i = 0; i < processors.length; i++) {
+            const processor = processors[i];
+            processedCharacter = await processor.handlePostCharacterLoaded(processedCharacter);
+        }
+    }
+    return processedCharacter;
+}
+
 const startAgents = async () => {
     const directClient = new DirectClient();
     let serverPort = Number.parseInt(settings.SERVER_PORT || "3000");
@@ -786,7 +832,8 @@ const startAgents = async () => {
 
     try {
         for (const character of characters) {
-            await startAgent(character, directClient);
+            const processedCharacter = await handlePostCharacterLoaded(character);
+            await startAgent(processedCharacter, directClient);
         }
     } catch (error) {
         elizaLogger.error("Error starting agents:", error);
@@ -801,15 +848,20 @@ const startAgents = async () => {
     }
 
     // upload some agent functionality into directClient
-    // XXX TODO: is this still used?
+    // This is used in client-direct/api.ts at "/agents/:agentId/set" route to restart an agent
     directClient.startAgent = async (character) => {
-        throw new Error('not implemented');
-
         // Handle plugins
         character.plugins = await handlePluginImporting(character.plugins);
 
+        // Handle Post Processors plugins
+        if (character.postProcessors?.length > 0) {
+            character.postProcessors = await handlePluginImporting(character.postProcessors);
+        }
+        // character's post processing
+        const processedCharacter = await handlePostCharacterLoaded(character);
+
         // wrap it so we don't have to inject directClient later
-        return startAgent(character, directClient);
+        return startAgent(processedCharacter, directClient);
     };
 
     directClient.loadCharacterTryPath = loadCharacterTryPath;
@@ -837,12 +889,12 @@ if (
     parseBooleanFromText(process.env.PREVENT_UNHANDLED_EXIT)
 ) {
     // Handle uncaught exceptions to prevent the process from crashing
-    process.on("uncaughtException", function (err) {
+    process.on("uncaughtException", (err) => {
         console.error("uncaughtException", err);
     });
 
     // Handle unhandled rejections to prevent the process from crashing
-    process.on("unhandledRejection", function (err) {
+    process.on("unhandledRejection", (err) => {
         console.error("unhandledRejection", err);
     });
 }

client/src/lib/info.json

@@ -1 +1 @@
-{"version": "0.25.6-alpha.1"}
+{"version": "0.25.8"}

docs/api/classes/AgentRuntime.md

@@ -1,4 +1,4 @@
-[@elizaos/core v0.25.7](../index.md) / AgentRuntime
+[@elizaos/core v0.25.8](../index.md) / AgentRuntime
 
 # Class: AgentRuntime
 

docs/api/classes/CacheManager.md

@@ -1,4 +1,4 @@
-[@elizaos/core v0.25.7](../index.md) / CacheManager
+[@elizaos/core v0.25.8](../index.md) / CacheManager
 
 # Class: CacheManager\<CacheAdapter\>
 

docs/api/classes/DatabaseAdapter.md

@@ -1,4 +1,4 @@
-[@elizaos/core v0.25.7](../index.md) / DatabaseAdapter
+[@elizaos/core v0.25.8](../index.md) / DatabaseAdapter
 
 # Class: `abstract` DatabaseAdapter\<DB\>
 

docs/api/classes/DbCacheAdapter.md

@@ -1,4 +1,4 @@
-[@elizaos/core v0.25.7](../index.md) / DbCacheAdapter
+[@elizaos/core v0.25.8](../index.md) / DbCacheAdapter
 
 # Class: DbCacheAdapter
 

docs/api/classes/FsCacheAdapter.md

@@ -1,4 +1,4 @@
-[@elizaos/core v0.25.7](../index.md) / FsCacheAdapter
+[@elizaos/core v0.25.8](../index.md) / FsCacheAdapter
 
 # Class: FsCacheAdapter
 

docs/api/classes/MemoryCacheAdapter.md

@@ -1,4 +1,4 @@
-[@elizaos/core v0.25.7](../index.md) / MemoryCacheAdapter
+[@elizaos/core v0.25.8](../index.md) / MemoryCacheAdapter
 
 # Class: MemoryCacheAdapter
 

docs/api/classes/MemoryManager.md

@@ -1,4 +1,4 @@
-[@elizaos/core v0.25.7](../index.md) / MemoryManager
+[@elizaos/core v0.25.8](../index.md) / MemoryManager
 
 # Class: MemoryManager
 

docs/api/classes/RAGKnowledgeManager.md

@@ -1,4 +1,4 @@
-[@elizaos/core v0.25.7](../index.md) / RAGKnowledgeManager
+[@elizaos/core v0.25.8](../index.md) / RAGKnowledgeManager
 
 # Class: RAGKnowledgeManager
 

docs/api/classes/Service.md

@@ -1,4 +1,4 @@
-[@elizaos/core v0.25.7](../index.md) / Service
+[@elizaos/core v0.25.8](../index.md) / Service
 
 # Class: `abstract` Service
 
@@ -40,7 +40,7 @@
 
 #### Defined in
 
-[packages/core/src/types.ts:1252](https://github.com/elizaOS/eliza/blob/main/packages/core/src/types.ts#L1252)
+[packages/core/src/types.ts:1259](https://github.com/elizaOS/eliza/blob/main/packages/core/src/types.ts#L1259)
 
 ***
 
@@ -56,7 +56,7 @@
 
 #### Defined in
 
-[packages/core/src/types.ts:1263](https://github.com/elizaOS/eliza/blob/main/packages/core/src/types.ts#L1263)
+[packages/core/src/types.ts:1270](https://github.com/elizaOS/eliza/blob/main/packages/core/src/types.ts#L1270)
 
 ## Methods
 
@@ -74,7 +74,7 @@
 
 #### Defined in
 
-[packages/core/src/types.ts:1256](https://github.com/elizaOS/eliza/blob/main/packages/core/src/types.ts#L1256)
+[packages/core/src/types.ts:1263](https://github.com/elizaOS/eliza/blob/main/packages/core/src/types.ts#L1263)
 
 ***
 
@@ -94,4 +94,4 @@ Add abstract initialize method that must be implemented by derived classes
 
 #### Defined in
 
-[packages/core/src/types.ts:1268](https://github.com/elizaOS/eliza/blob/main/packages/core/src/types.ts#L1268)
+[packages/core/src/types.ts:1275](https://github.com/elizaOS/eliza/blob/main/packages/core/src/types.ts#L1275)

docs/api/enumerations/ActionTimelineType.md

@@ -1,4 +1,4 @@
-[@elizaos/core v0.25.7](../index.md) / ActionTimelineType
+[@elizaos/core v0.25.8](../index.md) / ActionTimelineType
 
 # Enumeration: ActionTimelineType
 
@@ -10,7 +10,7 @@
 
 #### Defined in
 
-[packages/core/src/types.ts:1584](https://github.com/elizaOS/eliza/blob/main/packages/core/src/types.ts#L1584)
+[packages/core/src/types.ts:1592](https://github.com/elizaOS/eliza/blob/main/packages/core/src/types.ts#L1592)
 
 ***
 
@@ -20,4 +20,4 @@
 
 #### Defined in
 
-[packages/core/src/types.ts:1585](https://github.com/elizaOS/eliza/blob/main/packages/core/src/types.ts#L1585)
+[packages/core/src/types.ts:1593](https://github.com/elizaOS/eliza/blob/main/packages/core/src/types.ts#L1593)

docs/api/enumerations/CacheKeyPrefix.md

@@ -1,4 +1,4 @@
-[@elizaos/core v0.25.7](../index.md) / CacheKeyPrefix
+[@elizaos/core v0.25.8](../index.md) / CacheKeyPrefix
 
 # Enumeration: CacheKeyPrefix
 
@@ -10,4 +10,4 @@
 
 #### Defined in
 
-[packages/core/src/types.ts:1593](https://github.com/elizaOS/eliza/blob/main/packages/core/src/types.ts#L1593)
+[packages/core/src/types.ts:1601](https://github.com/elizaOS/eliza/blob/main/packages/core/src/types.ts#L1601)