Function executeAgentIteration

app/src/utils/main_loop.ts:257–443

(agentId: string)

 * Execute a single iteration of the agent's loop
 */
export async function executeAgentIteration(agentId: string): Promise<void> {
  const loopData = activeLoops[agentId];
  if (!loopData?.isRunning) {
    // This log is outside an iteration, so no ID is needed.
    Logger.debug(agentId, `Skipping execution for stopped agent`);
    return;
  }

  // --- ITERATION START ---
  const iterationId = `iter_${new Date().toISOString()}_${Math.random().toString(36).substring(2, 9)}`;
  const iterationStartTime = Date.now();

  try {
    const agent = await getAgent(agentId);
    const agentCode = await getAgentCode(agentId) || '';
    if (!agent) throw new Error(`Agent ${agentId} not found`);

    // Logger dispatches the window event automatically
    Logger.info(agentId, `Iteration started`, {
      logType: 'iteration-start',
      iterationId,
      content: {
        model: agent.model_name,
        interval: agent.loop_interval_seconds,
        intervalMs: loopData.intervalMs,
        iterationStartTime
      }
    });

    const preprocessResult = await preProcess(agentId, agent.system_prompt, iterationId);

    // Determine response source: cached or from model
    let response: string;
    let fromCache = false;

    // Check if we should use cached response (no significant change detected)
    const shouldUseCache = agent.only_on_significant_change &&
                          !(await detectSignificantChange(agentId, preprocessResult));

    if (shouldUseCache) {
      // Use cached response
      const cachedResponse = activeLoops[agentId]?.lastResponse;
      if (!cachedResponse) {
        throw new Error("No cached response available - this shouldn't happen after first iteration");
      }
      response = cachedResponse;
      fromCache = true;
    } else {
      // Call the model
      Logger.info(agentId, `Prompt`, { logType: 'model-prompt', iterationId, content: preprocessResult });

      let token: string | undefined;
      if (loopData.getToken) {
          try {
            Logger.debug(agentId, 'Requesting fresh API token...', { iterationId });
            token = await loopData.getToken();
          } catch (error) {
            Logger.warn(agentId, `Could not retrieve auth token: ${error}. Continuing without it.`, { iterationId });