@elizaos/core 1.6.2-alpha.24 → 1.6.2-alpha.26

package/dist/node/index.node.js

@@ -10018,10 +10018,7 @@ function findEnvFile() {
   }
   const fs = __require("node:fs");
   const path = __require("node:path");
-  const possiblePaths = [
-    path.join(process.cwd(), ".env"),
-    path.join(process.cwd(), ".env.local")
-  ];
+  const possiblePaths = [path.join(process.cwd(), ".env"), path.join(process.cwd(), ".env.local")];
   for (const envPath of possiblePaths) {
     if (fs.existsSync(envPath)) {
       return envPath;
@@ -25192,6 +25189,7 @@ var ServiceType = {
   WALLET: "wallet",
   LP_POOL: "lp_pool",
   TOKEN_DATA: "token_data",
+  MESSAGE_SERVICE: "message_service",
   MESSAGE: "message",
   POST: "post",
   UNKNOWN: "unknown"
@@ -43004,6 +43002,751 @@ var v4_default = v43;
 // src/runtime.ts
 init_environment();
 
+// src/services/default-message-service.ts
+var latestResponseIds = new Map;
+
+class DefaultMessageService {
+  async handleMessage(runtime, message, callback, options) {
+    const opts = {
+      maxRetries: options?.maxRetries ?? 3,
+      timeoutDuration: options?.timeoutDuration ?? 60 * 60 * 1000,
+      useMultiStep: options?.useMultiStep ?? parseBooleanFromText2(runtime.getSetting("USE_MULTI_STEP")),
+      maxMultiStepIterations: options?.maxMultiStepIterations ?? parseInt(runtime.getSetting("MAX_MULTISTEP_ITERATIONS") || "6")
+    };
+    let timeoutId = undefined;
+    const responseId = v4_default();
+    try {
+      runtime.logger.info(`[MessageService] Message received from ${message.entityId} in room ${message.roomId}`);
+      if (!latestResponseIds.has(runtime.agentId)) {
+        latestResponseIds.set(runtime.agentId, new Map);
+      }
+      const agentResponses = latestResponseIds.get(runtime.agentId);
+      if (!agentResponses)
+        throw new Error("Agent responses map not found");
+      const previousResponseId = agentResponses.get(message.roomId);
+      if (previousResponseId) {
+        logger.warn(`[MessageService] Updating response ID for room ${message.roomId} from ${previousResponseId} to ${responseId}`);
+      }
+      agentResponses.set(message.roomId, responseId);
+      const runId = runtime.startRun();
+      const startTime = Date.now();
+      await runtime.emitEvent("RUN_STARTED" /* RUN_STARTED */, {
+        runtime,
+        runId,
+        messageId: message.id,
+        roomId: message.roomId,
+        entityId: message.entityId,
+        startTime,
+        status: "started",
+        source: "messageHandler",
+        metadata: message.content
+      });
+      const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(async () => {
+          await runtime.emitEvent("RUN_TIMEOUT" /* RUN_TIMEOUT */, {
+            runtime,
+            runId,
+            messageId: message.id,
+            roomId: message.roomId,
+            entityId: message.entityId,
+            startTime,
+            status: "timeout",
+            endTime: Date.now(),
+            duration: Date.now() - startTime,
+            error: "Run exceeded timeout",
+            source: "messageHandler"
+          });
+          reject(new Error("Run exceeded timeout"));
+        }, opts.timeoutDuration);
+      });
+      const processingPromise = this.processMessage(runtime, message, callback, responseId, runId, startTime, opts);
+      const result = await Promise.race([processingPromise, timeoutPromise]);
+      clearTimeout(timeoutId);
+      return result;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      runtime.logger.error({ error }, "[MessageService] Error in handleMessage:");
+      throw error;
+    }
+  }
+  async processMessage(runtime, message, callback, responseId, runId, startTime, opts) {
+    try {
+      const agentResponses = latestResponseIds.get(runtime.agentId);
+      if (!agentResponses)
+        throw new Error("Agent responses map not found");
+      if (message.entityId === runtime.agentId) {
+        runtime.logger.debug(`[MessageService] Skipping message from self (${runtime.agentId})`);
+        await this.emitRunEnded(runtime, runId, message, startTime, "self");
+        return {
+          didRespond: false,
+          responseContent: null,
+          responseMessages: [],
+          state: {},
+          mode: "none"
+        };
+      }
+      runtime.logger.debug(`[MessageService] Processing message: ${truncateToCompleteSentence(message.content.text || "", 50)}...`);
+      runtime.logger.debug("[MessageService] Saving message to memory and queueing embeddings");
+      let memoryToQueue;
+      if (message.id) {
+        const existingMemory = await runtime.getMemoryById(message.id);
+        if (existingMemory) {
+          runtime.logger.debug("[MessageService] Memory already exists, skipping creation");
+          memoryToQueue = existingMemory;
+        } else {
+          const createdMemoryId = await runtime.createMemory(message, "messages");
+          memoryToQueue = { ...message, id: createdMemoryId };
+        }
+        await runtime.queueEmbeddingGeneration(memoryToQueue, "high");
+      } else {
+        const memoryId = await runtime.createMemory(message, "messages");
+        message.id = memoryId;
+        memoryToQueue = { ...message, id: memoryId };
+        await runtime.queueEmbeddingGeneration(memoryToQueue, "normal");
+      }
+      const agentUserState = await runtime.getParticipantUserState(message.roomId, runtime.agentId);
+      const defLllmOff = parseBooleanFromText2(runtime.getSetting("BOOTSTRAP_DEFLLMOFF"));
+      if (defLllmOff && agentUserState === null) {
+        runtime.logger.debug("[MessageService] LLM is off by default");
+        await this.emitRunEnded(runtime, runId, message, startTime, "off");
+        return {
+          didRespond: false,
+          responseContent: null,
+          responseMessages: [],
+          state: {},
+          mode: "none"
+        };
+      }
+      if (agentUserState === "MUTED" && !message.content.text?.toLowerCase().includes(runtime.character.name.toLowerCase())) {
+        runtime.logger.debug(`[MessageService] Ignoring muted room ${message.roomId}`);
+        await this.emitRunEnded(runtime, runId, message, startTime, "muted");
+        return {
+          didRespond: false,
+          responseContent: null,
+          responseMessages: [],
+          state: {},
+          mode: "none"
+        };
+      }
+      let state = await runtime.composeState(message, ["ANXIETY", "ENTITIES", "CHARACTER", "RECENT_MESSAGES", "ACTIONS"], true);
+      const mentionContext = message.content.mentionContext;
+      const room = await runtime.getRoom(message.roomId);
+      if (message.content.attachments && message.content.attachments.length > 0) {
+        message.content.attachments = await this.processAttachments(runtime, message.content.attachments);
+        if (message.id) {
+          await runtime.updateMemory({ id: message.id, content: message.content });
+        }
+      }
+      const responseDecision = this.shouldRespond(runtime, message, room ?? undefined, mentionContext);
+      runtime.logger.debug(`[MessageService] Response decision: ${JSON.stringify(responseDecision)}`);
+      let shouldRespondToMessage = true;
+      if (responseDecision.skipEvaluation) {
+        runtime.logger.debug(`[MessageService] Skipping evaluation for ${runtime.character.name} (${responseDecision.reason})`);
+        shouldRespondToMessage = responseDecision.shouldRespond;
+      } else {
+        const shouldRespondPrompt = composePromptFromState({
+          state,
+          template: runtime.character.templates?.shouldRespondTemplate || shouldRespondTemplate
+        });
+        runtime.logger.debug(`[MessageService] Using LLM evaluation for ${runtime.character.name} (${responseDecision.reason})`);
+        const response = await runtime.useModel(ModelType.TEXT_SMALL, {
+          prompt: shouldRespondPrompt
+        });
+        runtime.logger.debug(`[MessageService] LLM evaluation result:
+${response}`);
+        const responseObject = parseKeyValueXml(response);
+        runtime.logger.debug({ responseObject }, "[MessageService] Parsed evaluation result:");
+        const nonResponseActions = ["IGNORE", "NONE"];
+        shouldRespondToMessage = responseObject?.action && !nonResponseActions.includes(responseObject.action.toUpperCase());
+      }
+      let responseContent = null;
+      let responseMessages = [];
+      let mode = "none";
+      if (shouldRespondToMessage) {
+        const result = opts.useMultiStep ? await this.runMultiStepCore(runtime, message, state, callback, opts) : await this.runSingleShotCore(runtime, message, state, opts);
+        responseContent = result.responseContent;
+        responseMessages = result.responseMessages;
+        state = result.state;
+        mode = result.mode;
+        const currentResponseId = agentResponses.get(message.roomId);
+        if (currentResponseId !== responseId) {
+          runtime.logger.info(`Response discarded - newer message being processed for agent: ${runtime.agentId}, room: ${message.roomId}`);
+          return {
+            didRespond: false,
+            responseContent: null,
+            responseMessages: [],
+            state,
+            mode: "none"
+          };
+        }
+        if (responseContent && message.id) {
+          responseContent.inReplyTo = createUniqueUuid(runtime, message.id);
+        }
+        if (responseContent?.providers?.length && responseContent.providers.length > 0) {
+          state = await runtime.composeState(message, responseContent.providers || []);
+        }
+        if (responseContent) {
+          if (mode === "simple") {
+            if (responseContent.providers && responseContent.providers.length > 0) {
+              runtime.logger.debug({ providers: responseContent.providers }, "[MessageService] Simple response used providers");
+            }
+            if (callback) {
+              await callback(responseContent);
+            }
+          } else if (mode === "actions") {
+            await runtime.processActions(message, responseMessages, state, async (content) => {
+              runtime.logger.debug({ content }, "action callback");
+              responseContent.actionCallbacks = content;
+              if (callback) {
+                return callback(content);
+              }
+              return [];
+            });
+          }
+        }
+      } else {
+        runtime.logger.debug("[MessageService] Agent decided not to respond (shouldRespond is false).");
+        const currentResponseId = agentResponses.get(message.roomId);
+        const keepResp = parseBooleanFromText2(runtime.getSetting("BOOTSTRAP_KEEP_RESP"));
+        if (currentResponseId !== responseId && !keepResp) {
+          runtime.logger.info(`Ignore response discarded - newer message being processed for agent: ${runtime.agentId}, room: ${message.roomId}`);
+          await this.emitRunEnded(runtime, runId, message, startTime, "replaced");
+          return {
+            didRespond: false,
+            responseContent: null,
+            responseMessages: [],
+            state,
+            mode: "none"
+          };
+        }
+        if (!message.id) {
+          runtime.logger.error("[MessageService] Message ID is missing, cannot create ignore response.");
+          await this.emitRunEnded(runtime, runId, message, startTime, "noMessageId");
+          return {
+            didRespond: false,
+            responseContent: null,
+            responseMessages: [],
+            state,
+            mode: "none"
+          };
+        }
+        const ignoreContent = {
+          thought: "Agent decided not to respond to this message.",
+          actions: ["IGNORE"],
+          simple: true,
+          inReplyTo: createUniqueUuid(runtime, message.id)
+        };
+        if (callback) {
+          await callback(ignoreContent);
+        }
+        const ignoreMemory = {
+          id: asUUID(v4_default()),
+          entityId: runtime.agentId,
+          agentId: runtime.agentId,
+          content: ignoreContent,
+          roomId: message.roomId,
+          createdAt: Date.now()
+        };
+        await runtime.createMemory(ignoreMemory, "messages");
+        runtime.logger.debug("[MessageService] Saved ignore response to memory", `memoryId: ${ignoreMemory.id}`);
+      }
+      agentResponses.delete(message.roomId);
+      if (agentResponses.size === 0) {
+        latestResponseIds.delete(runtime.agentId);
+      }
+      await runtime.evaluate(message, state, shouldRespondToMessage, async (content) => {
+        runtime.logger.debug({ content }, "evaluate callback");
+        if (responseContent) {
+          responseContent.evalCallbacks = content;
+        }
+        if (callback) {
+          return callback(content);
+        }
+        return [];
+      }, responseMessages);
+      let entityName = "noname";
+      if (message.metadata && "entityName" in message.metadata) {
+        entityName = message.metadata.entityName;
+      }
+      const isDM = message.content?.channelType === "DM" /* DM */;
+      let roomName = entityName;
+      if (!isDM) {
+        const roomDatas = await runtime.getRoomsByIds([message.roomId]);
+        if (roomDatas?.length) {
+          const roomData = roomDatas[0];
+          if (roomData.name) {
+            roomName = roomData.name;
+          }
+          if (roomData.worldId) {
+            const worldData = await runtime.getWorld(roomData.worldId);
+            if (worldData) {
+              roomName = worldData.name + "-" + roomName;
+            }
+          }
+        }
+      }
+      const date2 = new Date;
+      const availableActions = state.data?.providers?.ACTIONS?.data?.actionsData?.map((a) => a.name) || [-1];
+      const logData = {
+        at: date2.toString(),
+        timestamp: parseInt("" + date2.getTime() / 1000),
+        messageId: message.id,
+        userEntityId: message.entityId,
+        input: message.content.text,
+        thought: responseContent?.thought,
+        simple: responseContent?.simple,
+        availableActions,
+        actions: responseContent?.actions,
+        providers: responseContent?.providers,
+        irt: responseContent?.inReplyTo,
+        output: responseContent?.text,
+        entityName,
+        source: message.content.source,
+        channelType: message.content.channelType,
+        roomName
+      };
+      await runtime.emitEvent("RUN_ENDED" /* RUN_ENDED */, {
+        runtime,
+        runId,
+        messageId: message.id,
+        roomId: message.roomId,
+        entityId: message.entityId,
+        startTime,
+        status: "completed",
+        endTime: Date.now(),
+        duration: Date.now() - startTime,
+        source: "messageHandler",
+        entityName,
+        responseContent,
+        metadata: logData
+      });
+      return {
+        didRespond: shouldRespondToMessage,
+        responseContent,
+        responseMessages,
+        state,
+        mode
+      };
+    } catch (error) {
+      console.error("error is", error);
+      await runtime.emitEvent("RUN_ENDED" /* RUN_ENDED */, {
+        runtime,
+        runId,
+        messageId: message.id,
+        roomId: message.roomId,
+        entityId: message.entityId,
+        startTime,
+        status: "error",
+        endTime: Date.now(),
+        duration: Date.now() - startTime,
+        error: error.message,
+        source: "messageHandler"
+      });
+      throw error;
+    }
+  }
+  shouldRespond(runtime, message, room, mentionContext) {
+    if (!room) {
+      return { shouldRespond: false, skipEvaluation: true, reason: "no room context" };
+    }
+    function normalizeEnvList(value) {
+      if (!value || typeof value !== "string")
+        return [];
+      const cleaned = value.trim().replace(/^\[|\]$/g, "");
+      return cleaned.split(",").map((v) => v.trim()).filter(Boolean);
+    }
+    const alwaysRespondChannels = [
+      "DM" /* DM */,
+      "VOICE_DM" /* VOICE_DM */,
+      "SELF" /* SELF */,
+      "API" /* API */
+    ];
+    const alwaysRespondSources = ["client_chat"];
+    const customChannels = normalizeEnvList(runtime.getSetting("ALWAYS_RESPOND_CHANNELS") || runtime.getSetting("SHOULD_RESPOND_BYPASS_TYPES"));
+    const customSources = normalizeEnvList(runtime.getSetting("ALWAYS_RESPOND_SOURCES") || runtime.getSetting("SHOULD_RESPOND_BYPASS_SOURCES"));
+    const respondChannels = new Set([...alwaysRespondChannels.map((t) => t.toString()), ...customChannels].map((s) => s.trim().toLowerCase()));
+    const respondSources = [...alwaysRespondSources, ...customSources].map((s) => s.trim().toLowerCase());
+    const roomType = room.type?.toString().toLowerCase();
+    const sourceStr = message.content.source?.toLowerCase() || "";
+    if (respondChannels.has(roomType)) {
+      return { shouldRespond: true, skipEvaluation: true, reason: `private channel: ${roomType}` };
+    }
+    if (respondSources.some((pattern) => sourceStr.includes(pattern))) {
+      return {
+        shouldRespond: true,
+        skipEvaluation: true,
+        reason: `whitelisted source: ${sourceStr}`
+      };
+    }
+    const hasPlatformMention = !!(mentionContext?.isMention || mentionContext?.isReply);
+    if (hasPlatformMention) {
+      const mentionType = mentionContext?.isMention ? "mention" : "reply";
+      return { shouldRespond: true, skipEvaluation: true, reason: `platform ${mentionType}` };
+    }
+    return { shouldRespond: false, skipEvaluation: false, reason: "needs LLM evaluation" };
+  }
+  async processAttachments(runtime, attachments) {
+    if (!attachments || attachments.length === 0) {
+      return [];
+    }
+    runtime.logger.debug(`[MessageService] Processing ${attachments.length} attachment(s)`);
+    const processedAttachments = [];
+    for (const attachment of attachments) {
+      try {
+        const processedAttachment = { ...attachment };
+        const isRemote = /^(http|https):\/\//.test(attachment.url);
+        const url = isRemote ? attachment.url : getLocalServerUrl(attachment.url);
+        if (attachment.contentType === "image" /* IMAGE */ && !attachment.description) {
+          runtime.logger.debug(`[MessageService] Generating description for image: ${attachment.url}`);
+          let imageUrl = url;
+          if (!isRemote) {
+            const res = await fetch(url);
+            if (!res.ok)
+              throw new Error(`Failed to fetch image: ${res.statusText}`);
+            const arrayBuffer = await res.arrayBuffer();
+            const buffer = Buffer.from(arrayBuffer);
+            const contentType = res.headers.get("content-type") || "application/octet-stream";
+            imageUrl = `data:${contentType};base64,${buffer.toString("base64")}`;
+          }
+          try {
+            const response = await runtime.useModel(ModelType.IMAGE_DESCRIPTION, {
+              prompt: imageDescriptionTemplate,
+              imageUrl
+            });
+            if (typeof response === "string") {
+              const parsedXml = parseKeyValueXml(response);
+              if (parsedXml && (parsedXml.description || parsedXml.text)) {
+                processedAttachment.description = parsedXml.description || "";
+                processedAttachment.title = parsedXml.title || "Image";
+                processedAttachment.text = parsedXml.text || parsedXml.description || "";
+                runtime.logger.debug(`[MessageService] Generated description: ${processedAttachment.description?.substring(0, 100)}...`);
+              } else {
+                const responseStr = response;
+                const titleMatch = responseStr.match(/<title>([^<]+)<\/title>/);
+                const descMatch = responseStr.match(/<description>([^<]+)<\/description>/);
+                const textMatch = responseStr.match(/<text>([^<]+)<\/text>/);
+                if (titleMatch || descMatch || textMatch) {
+                  processedAttachment.title = titleMatch?.[1] || "Image";
+                  processedAttachment.description = descMatch?.[1] || "";
+                  processedAttachment.text = textMatch?.[1] || descMatch?.[1] || "";
+                  runtime.logger.debug(`[MessageService] Used fallback XML parsing - description: ${processedAttachment.description?.substring(0, 100)}...`);
+                } else {
+                  runtime.logger.warn(`[MessageService] Failed to parse XML response for image description`);
+                }
+              }
+            } else if (response && typeof response === "object" && "description" in response) {
+              processedAttachment.description = response.description;
+              processedAttachment.title = response.title || "Image";
+              processedAttachment.text = response.description;
+              runtime.logger.debug(`[MessageService] Generated description: ${processedAttachment.description?.substring(0, 100)}...`);
+            } else {
+              runtime.logger.warn(`[MessageService] Unexpected response format for image description`);
+            }
+          } catch (error) {
+            runtime.logger.error({ error }, `[MessageService] Error generating image description:`);
+          }
+        } else if (attachment.contentType === "document" /* DOCUMENT */ && !attachment.text) {
+          const res = await fetch(url);
+          if (!res.ok)
+            throw new Error(`Failed to fetch document: ${res.statusText}`);
+          const contentType = res.headers.get("content-type") || "";
+          const isPlainText = contentType.startsWith("text/plain");
+          if (isPlainText) {
+            runtime.logger.debug(`[MessageService] Processing plain text document: ${attachment.url}`);
+            const textContent = await res.text();
+            processedAttachment.text = textContent;
+            processedAttachment.title = processedAttachment.title || "Text File";
+            runtime.logger.debug(`[MessageService] Extracted text content (first 100 chars): ${processedAttachment.text?.substring(0, 100)}...`);
+          } else {
+            runtime.logger.warn(`[MessageService] Skipping non-plain-text document: ${contentType}`);
+          }
+        }
+        processedAttachments.push(processedAttachment);
+      } catch (error) {
+        runtime.logger.error({ error, attachmentUrl: attachment.url }, `[MessageService] Failed to process attachment ${attachment.url}:`);
+        processedAttachments.push(attachment);
+      }
+    }
+    return processedAttachments;
+  }
+  async runSingleShotCore(runtime, message, state, opts) {
+    state = await runtime.composeState(message, ["ACTIONS"]);
+    if (!state.values?.actionNames) {
+      runtime.logger.warn("actionNames data missing from state, even though it was requested");
+    }
+    const prompt = composePromptFromState({
+      state,
+      template: runtime.character.templates?.messageHandlerTemplate || messageHandlerTemplate
+    });
+    let responseContent = null;
+    let retries = 0;
+    while (retries < opts.maxRetries && (!responseContent?.thought || !responseContent?.actions)) {
+      const response = await runtime.useModel(ModelType.TEXT_LARGE, { prompt });
+      runtime.logger.debug({ response }, "[MessageService] *** Raw LLM Response ***");
+      const parsedXml = parseKeyValueXml(response);
+      runtime.logger.debug({ parsedXml }, "[MessageService] *** Parsed XML Content ***");
+      if (parsedXml) {
+        responseContent = {
+          ...parsedXml,
+          thought: parsedXml.thought || "",
+          actions: parsedXml.actions || ["IGNORE"],
+          providers: parsedXml.providers || [],
+          text: parsedXml.text || "",
+          simple: parsedXml.simple || false
+        };
+      } else {
+        responseContent = null;
+      }
+      retries++;
+      if (!responseContent?.thought || !responseContent?.actions) {
+        runtime.logger.warn({ response, parsedXml, responseContent }, "[MessageService] *** Missing required fields (thought or actions), retrying... ***");
+      }
+    }
+    if (!responseContent) {
+      return { responseContent: null, responseMessages: [], state, mode: "none" };
+    }
+    if (responseContent.actions && responseContent.actions.length > 1) {
+      const isIgnore = (a) => typeof a === "string" && a.toUpperCase() === "IGNORE";
+      const hasIgnore = responseContent.actions.some(isIgnore);
+      if (hasIgnore) {
+        if (!responseContent.text || responseContent.text.trim() === "") {
+          responseContent.actions = ["IGNORE"];
+        } else {
+          const filtered = responseContent.actions.filter((a) => !isIgnore(a));
+          responseContent.actions = filtered.length ? filtered : ["REPLY"];
+        }
+      }
+    }
+    const isSimple = responseContent.actions?.length === 1 && typeof responseContent.actions[0] === "string" && responseContent.actions[0].toUpperCase() === "REPLY" && (!responseContent.providers || responseContent.providers.length === 0);
+    responseContent.simple = isSimple;
+    const responseMessages = [
+      {
+        id: asUUID(v4_default()),
+        entityId: runtime.agentId,
+        agentId: runtime.agentId,
+        content: responseContent,
+        roomId: message.roomId,
+        createdAt: Date.now()
+      }
+    ];
+    return {
+      responseContent,
+      responseMessages,
+      state,
+      mode: isSimple && responseContent.text ? "simple" : "actions"
+    };
+  }
+  async runMultiStepCore(runtime, message, state, callback, opts) {
+    const traceActionResult = [];
+    let accumulatedState = state;
+    let iterationCount = 0;
+    while (iterationCount < opts.maxMultiStepIterations) {
+      iterationCount++;
+      runtime.logger.debug(`[MultiStep] Starting iteration ${iterationCount}/${opts.maxMultiStepIterations}`);
+      accumulatedState = await runtime.composeState(message, [
+        "RECENT_MESSAGES",
+        "ACTION_STATE"
+      ]);
+      accumulatedState.data.actionResults = traceActionResult;
+      const prompt = composePromptFromState({
+        state: accumulatedState,
+        template: runtime.character.templates?.multiStepDecisionTemplate || multiStepDecisionTemplate
+      });
+      const stepResultRaw = await runtime.useModel(ModelType.TEXT_LARGE, { prompt });
+      const parsedStep = parseKeyValueXml(stepResultRaw);
+      if (!parsedStep) {
+        runtime.logger.warn(`[MultiStep] Failed to parse step result at iteration ${iterationCount}`);
+        traceActionResult.push({
+          data: { actionName: "parse_error" },
+          success: false,
+          error: "Failed to parse step result"
+        });
+        break;
+      }
+      const { thought, providers = [], action, isFinish } = parsedStep;
+      if (isFinish === "true" || isFinish === true) {
+        runtime.logger.info(`[MultiStep] Task marked as complete at iteration ${iterationCount}`);
+        if (callback) {
+          await callback({
+            text: "",
+            thought: thought ?? ""
+          });
+        }
+        break;
+      }
+      if ((!providers || providers.length === 0) && !action) {
+        runtime.logger.warn(`[MultiStep] No providers or action specified at iteration ${iterationCount}, forcing completion`);
+        break;
+      }
+      try {
+        for (const providerName of providers) {
+          const provider = runtime.providers.find((p) => p.name === providerName);
+          if (!provider) {
+            runtime.logger.warn(`[MultiStep] Provider not found: ${providerName}`);
+            traceActionResult.push({
+              data: { actionName: providerName },
+              success: false,
+              error: `Provider not found: ${providerName}`
+            });
+            continue;
+          }
+          const providerResult = await provider.get(runtime, message, state);
+          if (!providerResult) {
+            runtime.logger.warn(`[MultiStep] Provider returned no result: ${providerName}`);
+            traceActionResult.push({
+              data: { actionName: providerName },
+              success: false,
+              error: `Provider returned no result`
+            });
+            continue;
+          }
+          const success = !!providerResult.text;
+          traceActionResult.push({
+            data: { actionName: providerName },
+            success,
+            text: success ? providerResult.text : undefined,
+            error: success ? undefined : "Provider returned no result"
+          });
+          if (callback) {
+            await callback({
+              text: `\uD83D\uDD0E Provider executed: ${providerName}`,
+              actions: [providerName],
+              thought: thought ?? ""
+            });
+          }
+        }
+        if (action) {
+          const actionContent = {
+            text: `\uD83D\uDD0E Executing action: ${action}`,
+            actions: [action],
+            thought: thought ?? ""
+          };
+          await runtime.processActions(message, [
+            {
+              id: v4_default(),
+              entityId: runtime.agentId,
+              roomId: message.roomId,
+              createdAt: Date.now(),
+              content: actionContent
+            }
+          ], state, async () => {
+            return [];
+          });
+          const cachedState = runtime.stateCache?.get(`${message.id}_action_results`);
+          const actionResults = cachedState?.values?.actionResults || [];
+          const result = actionResults.length > 0 ? actionResults[0] : null;
+          const success = result?.success ?? false;
+          traceActionResult.push({
+            data: { actionName: action },
+            success,
+            text: result?.text,
+            values: result?.values,
+            error: success ? undefined : result?.text
+          });
+        }
+      } catch (err) {
+        runtime.logger.error({ err }, "[MultiStep] Error executing step");
+        traceActionResult.push({
+          data: { actionName: action || "unknown" },
+          success: false,
+          error: err instanceof Error ? err.message : String(err)
+        });
+      }
+    }
+    if (iterationCount >= opts.maxMultiStepIterations) {
+      runtime.logger.warn(`[MultiStep] Reached maximum iterations (${opts.maxMultiStepIterations}), forcing completion`);
+    }
+    accumulatedState = await runtime.composeState(message, [
+      "RECENT_MESSAGES",
+      "ACTION_STATE"
+    ]);
+    const summaryPrompt = composePromptFromState({
+      state: accumulatedState,
+      template: runtime.character.templates?.multiStepSummaryTemplate || multiStepSummaryTemplate
+    });
+    const finalOutput = await runtime.useModel(ModelType.TEXT_LARGE, { prompt: summaryPrompt });
+    const summary = parseKeyValueXml(finalOutput);
+    let responseContent = null;
+    if (summary?.text) {
+      responseContent = {
+        actions: ["MULTI_STEP_SUMMARY"],
+        text: summary.text,
+        thought: summary.thought || "Final user-facing message after task completion.",
+        simple: true
+      };
+    }
+    const responseMessages = responseContent ? [
+      {
+        id: asUUID(v4_default()),
+        entityId: runtime.agentId,
+        agentId: runtime.agentId,
+        content: responseContent,
+        roomId: message.roomId,
+        createdAt: Date.now()
+      }
+    ] : [];
+    return {
+      responseContent,
+      responseMessages,
+      state: accumulatedState,
+      mode: responseContent ? "simple" : "none"
+    };
+  }
+  async emitRunEnded(runtime, runId, message, startTime, status) {
+    await runtime.emitEvent("RUN_ENDED" /* RUN_ENDED */, {
+      runtime,
+      runId,
+      messageId: message.id,
+      roomId: message.roomId,
+      entityId: message.entityId,
+      startTime,
+      status,
+      endTime: Date.now(),
+      duration: Date.now() - startTime,
+      source: "messageHandler"
+    });
+  }
+  async deleteMessage(runtime, message) {
+    try {
+      if (!message.id) {
+        runtime.logger.error("[MessageService] Cannot delete memory: message ID is missing");
+        return;
+      }
+      runtime.logger.info("[MessageService] Deleting memory for message", message.id, "from room", message.roomId);
+      await runtime.deleteMemory(message.id);
+      runtime.logger.debug({ messageId: message.id }, "[MessageService] Successfully deleted memory for message");
+    } catch (error) {
+      runtime.logger.error({ error }, "[MessageService] Error in deleteMessage:");
+      throw error;
+    }
+  }
+  async clearChannel(runtime, roomId, channelId) {
+    try {
+      runtime.logger.info(`[MessageService] Clearing message memories from channel ${channelId} -> room ${roomId}`);
+      const memories = await runtime.getMemoriesByRoomIds({
+        tableName: "messages",
+        roomIds: [roomId]
+      });
+      runtime.logger.info(`[MessageService] Found ${memories.length} message memories to delete from channel ${channelId}`);
+      let deletedCount = 0;
+      for (const memory of memories) {
+        if (memory.id) {
+          try {
+            await runtime.deleteMemory(memory.id);
+            deletedCount++;
+          } catch (error) {
+            runtime.logger.warn({ error, memoryId: memory.id }, `[MessageService] Failed to delete message memory ${memory.id}:`);
+          }
+        }
+      }
+      runtime.logger.info(`[MessageService] Successfully cleared ${deletedCount}/${memories.length} message memories from channel ${channelId}`);
+    } catch (error) {
+      runtime.logger.error({ error }, "[MessageService] Error in clearChannel:");
+      throw error;
+    }
+  }
+}
+
 // src/search.ts
 var isV = (char) => {
   switch (char) {
@@ -43880,6 +44623,7 @@ class AgentRuntime {
   currentRunId;
   currentActionContext;
   maxWorkingMemoryEntries = 50;
+  messageService = null;
   constructor(opts) {
     this.agentId = opts.character?.id ?? opts?.agentId ?? stringToUuid(opts.character?.name ?? v4_default());
     this.character = opts.character;
@@ -44044,6 +44788,7 @@ class AgentRuntime {
       if (!await this.adapter.isReady()) {
         await this.adapter.init();
       }
+      this.messageService = new DefaultMessageService;
       this.logger.info("Running plugin migrations...");
       await this.runPluginMigrations();
       this.logger.info("Plugin migrations completed.");
@@ -46956,6 +47701,7 @@ export {
   EventType,
   Environment,
   ElizaOS,
+  DefaultMessageService,
   DatabaseAdapter,
   ContentType,
   ChannelType,
@@ -46965,5 +47711,5 @@ export {
   AgentRuntime
 };
 
-//# debugId=5DD1578DC5F08BED64756E2164756E21
+//# debugId=738C38AE1C103AEB64756E2164756E21
 //# sourceMappingURL=index.node.js.map