Method executeToolCall

src/agent/loop.ts:2205–2470

(
    tc: ToolCall,
    transaction: Transaction,
    sessionId: string,
    options: AgentOptions,
  )

          for (const sm of skipped) newMessages.push(sm);
          sessionStore.recordTurn(sessionId, skipped, { input: 0, output: 0, costUsd: 0 });
        }
        newMessages.push(stuckMsg);
        sessionStore.recordTurn(sessionId, [stuckMsg], { input: 0, output: 0, costUsd: 0 });
        // CRITICAL: also clear recentCalls so the model gets one clean shot after the advice
        recentCalls.length = 0;
        continue;
      }

      // Error-guessing loop: same tool, same error kind, different args each time (e.g. reading
      // Header.tsx / App.tsx / Navbar.jsx — all FILE_NOT_FOUND — on a .jsx project). detectStuckLoop
      // misses this because the args differ. Nudge the model to STOP guessing and learn the real paths.
      // Scope guard: if the user never asked to run/install/test and the model is now starting a
      // dev server or installing packages on its own, nudge it once to finish the edits and ask
      // first. Advisory only (doesn't skip execution); the soft-failure loop detector is the real
      // circuit-breaker if the model ignores this and starts thrashing.
      if (!userAskedExecution && !scopeNudged) {
        const wandering = toolCalls.find(tc =>
          isExecutionAction(tc.function.name, tc.function.arguments ?? ''),
        );
        if (wandering) {
          scopeNudged = true;
          const smsg: Message = {
            role: 'user',
            content:
              '[SYSTEM] The user asked you to write/redesign code, not to run a dev server or install ' +
              'packages. Finish and save the file changes, then report what you changed in a short ' +
              'summary. Do NOT start dev servers, install dependencies, or debug the environment unless ' +
              'the user explicitly asks — those steps are out of scope and waste time.',
          };
          newMessages.push(smsg);
          sessionStore.recordTurn(sessionId, [smsg], { input: 0, output: 0, costUsd: 0 });
        }
      }

      const errLoop = detectErrorLoop(recentErrors);
      if (errLoop) {
        let advice = ' Change approach instead of repeating the same kind of call.';
        if (errLoop.code === 'FILE_NOT_FOUND') {
          advice =
            ' STOP guessing file paths. The "did you mean …" suggestions in the errors show the REAL ' +
            'names — this project likely uses different extensions than you assume (e.g. .jsx, not .tsx). ' +
            'Run `glob` or `ls` to get exact paths, then read those. Do not keep trying filename variations.';
        }
        const msg: Message = {
          role: 'user',
          content:
            `[SYSTEM] \`${errLoop.name}\` has returned ${errLoop.code} ${errLoop.count} times with different ` +
            `arguments.${advice} If you genuinely can't proceed, say so in ONE sentence and stop. Do not loop.`,
        };
        // Answer the just-emitted tool_calls before skipping execution, or the assistant's
        // tool_calls are orphaned and OpenAI-format providers 400 on the next request.
        if (toolCalls.length > 0) {
          const skipped = skippedToolResults(toolCalls, 'loop guard: same error kind repeated');
          for (const sm of skipped) newMessages.push(sm);
          sessionStore.recordTurn(sessionId, skipped, { input: 0, output: 0, costUsd: 0 });
        }
        newMessages.push(msg);
        sessionStore.recordTurn(sessionId, [msg], { input: 0, output: 0, costUsd: 0 });