Skip to content

fix(cli/acp): prevent infinite thought loop in ACP mode by disablig nextSpeakerCheck#26874

Merged
sripasg merged 1 commit into
mainfrom
sripas_fix_1662
May 11, 2026
Merged

fix(cli/acp): prevent infinite thought loop in ACP mode by disablig nextSpeakerCheck#26874
sripasg merged 1 commit into
mainfrom
sripas_fix_1662

Conversation

@sripasg
Copy link
Copy Markdown
Contributor

@sripasg sripasg commented May 11, 2026

Summary

Forces skipNextSpeakerCheck to true when the CLI is running in ACP mode. This prevents the core GeminiClient from recursively initiating synthetic continuation turns, which previously resulted in unbounded agent_thought_chunk loops during ACP sessions.

Details

Why this happened:
The nextSpeakerCheck mechanism in GeminiClient was designed for the interactive terminal TUI. When a model returns a turn without explicit content or tools (e.g., thought-only responses), this mechanism makes a separate LLM call to evaluate if the model was cut off or expects to continue. If it decides the model should continue, it automatically injects a "Please continue." prompt and recurses the turn inside the generator.

However, in ACP mode, turn boundaries are explicit and strictly managed by the IDE client via the session/prompt protocol. The core client's internal recursive continuation bypasses the ACP session's while(true) outer loop. Because the ACP protocol expects the stream to end so it can evaluate tools or wait for the next user input, the internal continuation traps the agent in a loop where it perpetually emits thoughts without returning control to the client.

How we are fixing it:
Modified loadCliConfig in packages/cli/src/config/config.ts to apply an explicit override: skipNextSpeakerCheck: isAcpMode || settings.model?.skipNextSpeakerCheck

This ensures that regardless of the user's local settings.json, ACP sessions will always bypass the checkNextSpeaker flow. As a result, when an invalid or thought-only stream ends, the GeminiClient correctly yields control back to acpSession.ts, which emits an end_turn stop reason and allows the IDE protocol to gracefully handle the next step.

Related Issues

Fixes google-gemini/maintainers-gemini-cli#1662

How to Validate

There is no loop anymore. This is hard to repro so harder to validate.

Pre-Merge Checklist

  • [NA] Updated relevant documentation and README (if needed)
  • Added/updated tests (if needed)
  • [NA] Noted breaking changes (if any)
  • Validated on required platforms/methods:
    • MacOS
      • npm run
      • npx
      • Docker
      • Podman
      • Seatbelt
    • Windows
      • npm run
      • npx
      • Docker
    • Linux
      • npm run
      • npx
      • Docker

…nextSpeakerCheck

Summary:
Forces `skipNextSpeakerCheck` to `true` when the CLI is running in ACP mode. This prevents the core GeminiClient from recursively initiating synthetic continuation turns, which previously resulted in unbounded `agent_thought_chunk` loops during ACP sessions.

Details:

Why this happened:
The `nextSpeakerCheck` mechanism in `GeminiClient` was designed for the interactive terminal TUI. When a model returns a turn without explicit content or tools (e.g., thought-only responses), this mechanism makes a separate LLM call to evaluate if the model was cut off or expects to continue. If it decides the model should continue, it automatically injects a "Please continue." prompt and recurses the turn inside the generator.

However, in ACP mode, turn boundaries are explicit and strictly managed by the IDE client via the `session/prompt` protocol. The core client's internal recursive continuation bypasses the ACP session's `while(true)` outer loop. Because the ACP protocol expects the stream to end so it can evaluate tools or wait for the next user input, the internal continuation traps the agent in a loop where it perpetually emits thoughts without returning control to the client.

How we are fixing it:
Modified `loadCliConfig` in `packages/cli/src/config/config.ts` to apply an explicit override:
`skipNextSpeakerCheck: isAcpMode || settings.model?.skipNextSpeakerCheck`

This ensures that regardless of the user's local `settings.json`, ACP sessions will always bypass the `checkNextSpeaker` flow. As a result, when an invalid or thought-only stream ends, the `GeminiClient` correctly yields control back to `acpSession.ts`, which emits an `end_turn` stop reason and allows the IDE protocol to gracefully handle the next step.
@sripasg sripasg requested a review from a team as a code owner May 11, 2026 16:54
@sripasg sripasg self-assigned this May 11, 2026
@sripasg sripasg added the ACP label May 11, 2026
@github-actions
Copy link
Copy Markdown

Size Change: +283 B (0%)

Total Size: 34.1 MB

Filename Size Change
./bundle/chunk-GU75XBQS.js 0 B -3.8 kB (removed) 🏆
./bundle/chunk-P6LP6CDQ.js 0 B -49.2 kB (removed) 🏆
./bundle/chunk-VEMM7Q4F.js 0 B -19.5 kB (removed) 🏆
./bundle/chunk-WZC7A2RB.js 0 B -12.5 kB (removed) 🏆
./bundle/chunk-XQX2NMBF.js 0 B -658 kB (removed) 🏆
./bundle/chunk-YQR5MNZ3.js 0 B -3.43 kB (removed) 🏆
./bundle/chunk-YWS2IOUI.js 0 B -14.8 MB (removed) 🏆
./bundle/chunk-Z6C7I4HJ.js 0 B -2.78 MB (removed) 🏆
./bundle/core-XPTLHV3H.js 0 B -49.2 kB (removed) 🏆
./bundle/devtoolsService-OR6CUAPQ.js 0 B -28 kB (removed) 🏆
./bundle/gemini-52LOYLS2.js 0 B -586 kB (removed) 🏆
./bundle/interactiveCli-HMER6GQZ.js 0 B -1.3 MB (removed) 🏆
./bundle/liteRtServerManager-MJQUL4N3.js 0 B -2.11 kB (removed) 🏆
./bundle/oauth2-provider-RIFORLFL.js 0 B -9.16 kB (removed) 🏆
./bundle/chunk-6BPCO5ET.js 3.8 kB +3.8 kB (new file) 🆕
./bundle/chunk-L5QEUJEW.js 2.78 MB +2.78 MB (new file) 🆕
./bundle/chunk-L6PGO5NZ.js 14.8 MB +14.8 MB (new file) 🆕
./bundle/chunk-LVUX2OH4.js 49.2 kB +49.2 kB (new file) 🆕
./bundle/chunk-N33VR772.js 19.5 kB +19.5 kB (new file) 🆕
./bundle/chunk-UF6M63U6.js 3.43 kB +3.43 kB (new file) 🆕
./bundle/chunk-YLLHEKO3.js 12.5 kB +12.5 kB (new file) 🆕
./bundle/chunk-ZRGZOPQV.js 658 kB +658 kB (new file) 🆕
./bundle/core-OO7U76BO.js 49.2 kB +49.2 kB (new file) 🆕
./bundle/devtoolsService-WL63NBQT.js 28 kB +28 kB (new file) 🆕
./bundle/gemini-WQHA567K.js 587 kB +587 kB (new file) 🆕
./bundle/interactiveCli-EKIQCUSL.js 1.3 MB +1.3 MB (new file) 🆕
./bundle/liteRtServerManager-GAFBK6YJ.js 2.11 kB +2.11 kB (new file) 🆕
./bundle/oauth2-provider-6UWI4Q2P.js 9.16 kB +9.16 kB (new file) 🆕
ℹ️ View Unchanged
Filename Size Change
./bundle/bundled/third_party/index.js 8 MB 0 B
./bundle/chunk-34MYV7JD.js 2.45 kB 0 B
./bundle/chunk-5AUYMPVF.js 858 B 0 B
./bundle/chunk-5PS3AYFU.js 1.18 kB 0 B
./bundle/chunk-664ZODQF.js 124 kB 0 B
./bundle/chunk-6NNHMYAM.js 1.97 MB 0 B
./bundle/chunk-DAHVX5MI.js 206 kB 0 B
./bundle/chunk-IUUIT4SU.js 56.5 kB 0 B
./bundle/chunk-RJTRUG2J.js 39.8 kB 0 B
./bundle/cleanup-IMYOVT7C.js 0 B -932 B (removed) 🏆
./bundle/devtools-36NN55EP.js 696 kB 0 B
./bundle/dist-T73EYRDX.js 356 B 0 B
./bundle/events-XB7DADIJ.js 418 B 0 B
./bundle/examples/hooks/scripts/on-start.js 188 B 0 B
./bundle/examples/mcp-server/example.js 1.43 kB 0 B
./bundle/gemini.js 5.1 kB 0 B
./bundle/getMachineId-bsd-TXG52NKR.js 1.55 kB 0 B
./bundle/getMachineId-darwin-7OE4DDZ6.js 1.55 kB 0 B
./bundle/getMachineId-linux-SHIFKOOX.js 1.34 kB 0 B
./bundle/getMachineId-unsupported-5U5DOEYY.js 1.06 kB 0 B
./bundle/getMachineId-win-6KLLGOI4.js 1.72 kB 0 B
./bundle/memoryDiscovery-QGLPGQCK.js 980 B 0 B
./bundle/multipart-parser-KPBZEGQU.js 11.7 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/client/main.js 222 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.js 229 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/index.js 13.4 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/types.js 132 B 0 B
./bundle/sandbox-macos-permissive-open.sb 890 B 0 B
./bundle/sandbox-macos-permissive-proxied.sb 1.31 kB 0 B
./bundle/sandbox-macos-restrictive-open.sb 3.36 kB 0 B
./bundle/sandbox-macos-restrictive-proxied.sb 3.56 kB 0 B
./bundle/sandbox-macos-strict-open.sb 4.82 kB 0 B
./bundle/sandbox-macos-strict-proxied.sb 5.02 kB 0 B
./bundle/src-QVCVGIUX.js 47 kB 0 B
./bundle/start-QAV2EU6U.js 0 B -652 B (removed) 🏆
./bundle/tree-sitter-7U6MW5PS.js 274 kB 0 B
./bundle/tree-sitter-bash-34ZGLXVX.js 1.84 MB 0 B
./bundle/cleanup-FA4O3BIX.js 932 B +932 B (new file) 🆕
./bundle/start-4MELL3MN.js 652 B +652 B (new file) 🆕

compressed-size-action

@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request addresses an issue where the CLI would enter an infinite loop of thought chunks when operating in ACP mode. By forcing the skipNextSpeakerCheck to true, the GeminiClient is prevented from initiating recursive continuation turns that conflict with the explicit turn management protocol used by ACP sessions. This ensures control is properly returned to the IDE client, allowing for stable and predictable interaction.

Highlights

  • ACP Mode Stability: Forced the skipNextSpeakerCheck configuration to true when the CLI is running in ACP mode to prevent infinite recursion loops.
  • Configuration Override: Updated loadCliConfig to prioritize the ACP mode state over local user settings for the next-speaker check.
  • Test Coverage: Added unit tests to verify that skipNextSpeakerCheck is correctly forced in ACP mode while respecting user settings in standard mode.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize the Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counterproductive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@gemini-cli gemini-cli Bot added the status/need-issue Pull requests that need to have an associated issue. label May 11, 2026
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request ensures that skipNextSpeakerCheck is always enabled when the CLI is in ACP mode to prevent infinite loops during turn management. It includes updates to the loadCliConfig function and new unit tests in config.test.ts to validate this logic. I have no feedback to provide.

@sripasg sripasg added this pull request to the merge queue May 11, 2026
Merged via the queue into main with commit 4739495 May 11, 2026
28 checks passed
@sripasg sripasg deleted the sripas_fix_1662 branch May 11, 2026 17:54
adamfweidman pushed a commit that referenced this pull request May 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ACP status/need-issue Pull requests that need to have an associated issue.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants