@elizaos/core 1.6.2-alpha.20 → 1.6.2-alpha.22

package/dist/character.d.ts

@@ -22,4 +22,19 @@ export declare function validateCharacterConfig(character: Character): {
  * @returns Complete character with defaults
  */
 export declare function mergeCharacterDefaults(char: Partial<Character>): Character;
+/**
+ * Build ordered plugin list based on available environment variables
+ *
+ * Plugin loading order:
+ * 1. Core plugins (@elizaos/plugin-sql)
+ * 2. Text-only LLM plugins (no embedding support)
+ * 3. Embedding-capable LLM plugins
+ * 4. Platform plugins (Discord, Twitter, Telegram)
+ * 5. Bootstrap plugin (unless IGNORE_BOOTSTRAP is set)
+ * 6. Ollama fallback (only if no other LLM providers configured)
+ *
+ * @param env - Environment object to check for API keys (defaults to process.env)
+ * @returns Ordered array of plugin names
+ */
+export declare function buildCharacterPlugins(env?: Record<string, string | undefined>): string[];
 //# sourceMappingURL=character.d.ts.map

package/dist/character.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../src/character.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAyB5E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAoBA;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAY1E"}
+{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../src/character.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAyB5E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAoBA;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAY1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,MAAM,EAAE,CA0CV"}

package/dist/index.d.ts

@@ -8,6 +8,7 @@
 export * from './types';
 export * from './utils';
 export * from './schemas/character';
+export * from './character';
 export * from './utils/environment';
 export * from './utils/buffer';
 export * from './utils/paths';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,SAAS,CAAC;AAGxB,cAAc,qBAAqB,CAAC;AAGpC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,gBAAgB,CAAC;AAI/B,cAAc,eAAe,CAAC;AAG9B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AAGzB,cAAc,WAAW,CAAC;AAG1B,eAAO,MAAM,SAAS,SAG+B,CAAC;AACtD,eAAO,MAAM,MAAM,SAG2B,CAAC;AAG/C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,SAAS,CAAC;AAGxB,cAAc,qBAAqB,CAAC;AAGpC,cAAc,aAAa,CAAC;AAG5B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,gBAAgB,CAAC;AAI/B,cAAc,eAAe,CAAC;AAG9B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AAGzB,cAAc,WAAW,CAAC;AAG1B,eAAO,MAAM,SAAS,SAG+B,CAAC;AACtD,eAAO,MAAM,MAAM,SAG2B,CAAC;AAG/C,cAAc,uBAAuB,CAAC"}

package/dist/node/index.node.js

@@ -42568,6 +42568,67 @@ function formatActions(actions) {
 class DatabaseAdapter {
   db;
 }
+// src/character.ts
+function parseCharacter(input) {
+  if (typeof input === "string") {
+    throw new Error(`Character path provided but must be loaded first: ${input}`);
+  }
+  if (typeof input === "object") {
+    const validationResult = validateCharacter(input);
+    if (!validationResult.success) {
+      const errorDetails = validationResult.error?.issues ? validationResult.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ") : validationResult.error?.message || "Unknown validation error";
+      throw new Error(`Character validation failed: ${errorDetails}`);
+    }
+    return validationResult.data;
+  }
+  throw new Error("Invalid character input format");
+}
+function validateCharacterConfig(character) {
+  const validationResult = validateCharacter(character);
+  if (validationResult.success) {
+    return {
+      isValid: true,
+      errors: []
+    };
+  }
+  const errors = validationResult.error?.issues ? validationResult.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`) : [validationResult.error?.message || "Unknown validation error"];
+  return {
+    isValid: false,
+    errors
+  };
+}
+function mergeCharacterDefaults(char) {
+  const defaults = {
+    settings: {},
+    plugins: [],
+    bio: []
+  };
+  return {
+    ...defaults,
+    ...char,
+    name: char.name || "Unnamed Character"
+  };
+}
+function buildCharacterPlugins(env2 = process.env) {
+  const plugins = [
+    "@elizaos/plugin-sql",
+    ...env2.ANTHROPIC_API_KEY?.trim() ? ["@elizaos/plugin-anthropic"] : [],
+    ...env2.OPENROUTER_API_KEY?.trim() ? ["@elizaos/plugin-openrouter"] : [],
+    ...env2.OPENAI_API_KEY?.trim() ? ["@elizaos/plugin-openai"] : [],
+    ...env2.GOOGLE_GENERATIVE_AI_API_KEY?.trim() ? ["@elizaos/plugin-google-genai"] : [],
+    ...env2.DISCORD_API_TOKEN?.trim() ? ["@elizaos/plugin-discord"] : [],
+    ...env2.TWITTER_API_KEY?.trim() && env2.TWITTER_API_SECRET_KEY?.trim() && env2.TWITTER_ACCESS_TOKEN?.trim() && env2.TWITTER_ACCESS_TOKEN_SECRET?.trim() ? ["@elizaos/plugin-twitter"] : [],
+    ...env2.TELEGRAM_BOT_TOKEN?.trim() ? ["@elizaos/plugin-telegram"] : [],
+    ...(() => {
+      const ignore = env2.IGNORE_BOOTSTRAP?.trim().toLowerCase();
+      const shouldIgnore = ignore === "true" || ignore === "1" || ignore === "yes";
+      return shouldIgnore ? [] : ["@elizaos/plugin-bootstrap"];
+    })(),
+    ...!env2.ANTHROPIC_API_KEY?.trim() && !env2.OPENROUTER_API_KEY?.trim() && !env2.OPENAI_API_KEY?.trim() && !env2.GOOGLE_GENERATIVE_AI_API_KEY?.trim() ? ["@elizaos/plugin-ollama"] : []
+  ];
+  return plugins;
+}
+
 // src/memory.ts
 function createMessageMemory(params) {
   return {
@@ -43820,7 +43881,7 @@ class AgentRuntime {
   currentActionContext;
   maxWorkingMemoryEntries = 50;
   constructor(opts) {
-    this.agentId = opts.character?.id ?? opts?.agentId ?? stringToUuid(opts.character?.name ?? v4_default() + opts.character?.username);
+    this.agentId = opts.character?.id ?? opts?.agentId ?? stringToUuid(opts.character?.name ?? v4_default());
     this.character = opts.character;
     this.initPromise = new Promise((resolve, reject) => {
       this.initResolver = resolve;
@@ -43986,9 +44047,12 @@ class AgentRuntime {
       this.logger.info("Running plugin migrations...");
       await this.runPluginMigrations();
       this.logger.info("Plugin migrations completed.");
-      const existingAgent = await this.ensureAgentExists(this.character);
+      const existingAgent = await this.ensureAgentExists({
+        ...this.character,
+        id: this.agentId
+      });
       if (!existingAgent) {
-        const errorMsg = `Agent ${this.character.name} does not exist in database after ensureAgentExists call`;
+        const errorMsg = `Agent ${this.agentId} does not exist in database after ensureAgentExists call`;
         throw new Error(errorMsg);
       }
       let agentEntity = await this.getEntityById(this.agentId);
@@ -44536,42 +44600,56 @@ class AgentRuntime {
     }
   }
   async evaluate(message, state, didRespond, callback, responses) {
-    const evaluatorPromises = this.evaluators.map(async (evaluator) => {
-      if (!evaluator.handler) {
-        return null;
-      }
-      if (!didRespond && !evaluator.alwaysRun) {
-        return null;
-      }
-      const result = await evaluator.validate(this, message, state);
-      if (result) {
-        return evaluator;
+    try {
+      const evaluatorPromises = this.evaluators.map(async (evaluator) => {
+        try {
+          if (!evaluator.handler) {
+            return null;
+          }
+          if (!didRespond && !evaluator.alwaysRun) {
+            return null;
+          }
+          const result = await evaluator.validate(this, message, state);
+          if (result) {
+            return evaluator;
+          }
+          return null;
+        } catch (error) {
+          this.logger.error({ error, evaluatorName: evaluator.name }, `Error validating evaluator ${evaluator.name}`);
+          return null;
+        }
+      });
+      const evaluators = (await Promise.all(evaluatorPromises)).filter(Boolean);
+      if (evaluators.length === 0) {
+        return [];
       }
-      return null;
-    });
-    const evaluators = (await Promise.all(evaluatorPromises)).filter(Boolean);
-    if (evaluators.length === 0) {
+      state = await this.composeState(message, ["RECENT_MESSAGES", "EVALUATORS"]);
+      await Promise.all(evaluators.map(async (evaluator) => {
+        try {
+          if (evaluator.handler) {
+            await evaluator.handler(this, message, state, {}, callback, responses);
+            this.adapter.log({
+              entityId: message.entityId,
+              roomId: message.roomId,
+              type: "evaluator",
+              body: {
+                evaluator: evaluator.name,
+                messageId: message.id,
+                message: message.content.text,
+                state,
+                runId: this.getCurrentRunId()
+              }
+            });
+          }
+        } catch (error) {
+          this.logger.error({ error, evaluatorName: evaluator.name }, `Error executing evaluator ${evaluator.name}`);
+        }
+      }));
+      return evaluators;
+    } catch (error) {
+      this.logger.error({ error, messageId: message.id, roomId: message.roomId }, "Error in evaluate method");
       return [];
     }
-    state = await this.composeState(message, ["RECENT_MESSAGES", "EVALUATORS"]);
-    await Promise.all(evaluators.map(async (evaluator) => {
-      if (evaluator.handler) {
-        await evaluator.handler(this, message, state, {}, callback, responses);
-        this.adapter.log({
-          entityId: message.entityId,
-          roomId: message.roomId,
-          type: "evaluator",
-          body: {
-            evaluator: evaluator.name,
-            messageId: message.id,
-            message: message.content.text,
-            state,
-            runId: this.getCurrentRunId()
-          }
-        });
-      }
-    }));
-    return evaluators;
   }
   async ensureConnections(entities, rooms, source, world) {
     if (!entities) {
@@ -45307,34 +45385,33 @@ ${input}`;
     return await this.adapter.deleteAgent(agentId);
   }
   async ensureAgentExists(agent) {
-    if (!agent.name) {
-      throw new Error("Agent name is required");
+    if (!agent.id) {
+      throw new Error("Agent id is required");
     }
-    const agents = await this.adapter.getAgents();
-    const existingAgentId = agents.find((a) => a.name === agent.name)?.id;
-    if (existingAgentId) {
+    const existingAgent = await this.adapter.getAgent(agent.id);
+    if (existingAgent) {
       const updatedAgent = {
         ...agent,
-        id: existingAgentId,
+        id: agent.id,
         updatedAt: Date.now()
       };
-      await this.adapter.updateAgent(existingAgentId, updatedAgent);
-      const existingAgent = await this.adapter.getAgent(existingAgentId);
-      if (!existingAgent) {
-        throw new Error(`Failed to retrieve agent after update: ${existingAgentId}`);
+      await this.adapter.updateAgent(agent.id, updatedAgent);
+      const refreshedAgent = await this.adapter.getAgent(agent.id);
+      if (!refreshedAgent) {
+        throw new Error(`Failed to retrieve agent after update: ${agent.id}`);
       }
-      this.logger.debug(`Updated existing agent ${agent.name} on restart`);
-      return existingAgent;
+      this.logger.debug(`Updated existing agent ${agent.id} on restart`);
+      return refreshedAgent;
     }
     const newAgent = {
       ...agent,
-      id: stringToUuid(agent.name)
+      id: agent.id
     };
     const created = await this.adapter.createAgent(newAgent);
     if (!created) {
-      throw new Error(`Failed to create agent: ${agent.name}`);
+      throw new Error(`Failed to create agent: ${agent.id}`);
     }
-    this.logger.debug(`Created new agent ${agent.name}`);
+    this.logger.debug(`Created new agent ${agent.id}`);
     return newAgent;
   }
   async getEntityById(entityId) {
@@ -46723,47 +46800,6 @@ Data: ${JSON.stringify(entity.metadata)}
   return entityStrings.join(`
 `);
 }
-// src/character.ts
-function parseCharacter(input) {
-  if (typeof input === "string") {
-    throw new Error(`Character path provided but must be loaded first: ${input}`);
-  }
-  if (typeof input === "object") {
-    const validationResult = validateCharacter(input);
-    if (!validationResult.success) {
-      const errorDetails = validationResult.error?.issues ? validationResult.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ") : validationResult.error?.message || "Unknown validation error";
-      throw new Error(`Character validation failed: ${errorDetails}`);
-    }
-    return validationResult.data;
-  }
-  throw new Error("Invalid character input format");
-}
-function validateCharacterConfig(character) {
-  const validationResult = validateCharacter(character);
-  if (validationResult.success) {
-    return {
-      isValid: true,
-      errors: []
-    };
-  }
-  const errors = validationResult.error?.issues ? validationResult.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`) : [validationResult.error?.message || "Unknown validation error"];
-  return {
-    isValid: false,
-    errors
-  };
-}
-function mergeCharacterDefaults(char) {
-  const defaults = {
-    settings: {},
-    plugins: [],
-    bio: []
-  };
-  return {
-    ...defaults,
-    ...char,
-    name: char.name || "Unnamed Character"
-  };
-}
 
 // src/index.node.ts
 var isBrowser4 = false;
@@ -46898,6 +46934,7 @@ export {
   clearSaltCache,
   characterSchema,
   byteLength,
+  buildCharacterPlugins,
   booleanFooter,
   asUUID,
   alloc,
@@ -46928,5 +46965,5 @@ export {
   AgentRuntime
 };
 
-//# debugId=5D467EA1E4701BE864756E2164756E21
+//# debugId=5DD1578DC5F08BED64756E2164756E21
 //# sourceMappingURL=index.node.js.map