Skip to content

fix(cli): prevent ACP stdout pollution from SessionEnd hooks#26125

Merged
Adib234 merged 4 commits intomainfrom
acp-stdout
Apr 28, 2026
Merged

fix(cli): prevent ACP stdout pollution from SessionEnd hooks#26125
Adib234 merged 4 commits intomainfrom
acp-stdout

Conversation

@cocosheng-g
Copy link
Copy Markdown
Contributor

Summary

In ACP mode, stdout can be polluted by non-JSON debug lines when project hooks are enabled and the ACP session closes. This happens because the global ConsolePatcher is unpatched before the SessionEnd hooks have finished executing.

This PR ensures that in ACP mode, the ConsolePatcher is not unpatched during the final cleanup sequence. This keeps debug logs redirected to stderr and maintains NDJSON protocol integrity on stdout.

Changes

  • Modified packages/cli/src/gemini.tsx to skip ConsolePatcher.cleanup() registration when in ACP mode.
  • Added packages/cli/src/acp/acpConsolePatcher.test.ts to verify the conditional cleanup logic.

Verification

  • Manual reproduction confirms stdout is clean during ACP shutdown with hooks enabled.
  • New unit tests pass and verify behavior for both ACP and non-ACP modes.

Fixes #25345

@cocosheng-g cocosheng-g requested a review from a team as a code owner April 28, 2026 16:31
@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 debug logs were polluting stdout during the shutdown sequence of ACP sessions. By ensuring the console remains patched until after session hooks have completed, the integrity of the NDJSON protocol is preserved.

Highlights

  • ACP Mode Cleanup Logic: Modified the CLI initialization to conditionally skip registering the ConsolePatcher cleanup function when running in ACP mode, preventing premature unpatching.
  • Regression Testing: Added a new test suite to verify that ConsolePatcher cleanup is correctly registered in standard mode and skipped in ACP 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 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 counter productive. 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.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 28, 2026

Size Change: +38 B (0%)

Total Size: 33.9 MB

Filename Size Change
./bundle/chunk-2LUSSFFI.js 0 B -3.43 kB (removed) 🏆
./bundle/chunk-QFLLGUPL.js 0 B -14.7 MB (removed) 🏆
./bundle/chunk-VUV5JXQ2.js 0 B -673 kB (removed) 🏆
./bundle/chunk-WHRIYUZ4.js 0 B -49.2 kB (removed) 🏆
./bundle/chunk-YIMBEFFC.js 0 B -2.73 MB (removed) 🏆
./bundle/chunk-ZJWCL27O.js 0 B -3.8 kB (removed) 🏆
./bundle/core-C2IIG6KX.js 0 B -48.1 kB (removed) 🏆
./bundle/devtoolsService-CM2PR4UG.js 0 B -27.8 kB (removed) 🏆
./bundle/gemini-N3SGFNGF.js 0 B -574 kB (removed) 🏆
./bundle/interactiveCli-AW7X7I6V.js 0 B -1.31 MB (removed) 🏆
./bundle/liteRtServerManager-6WNCFMIF.js 0 B -2.08 kB (removed) 🏆
./bundle/oauth2-provider-H2GVOQXF.js 0 B -9.16 kB (removed) 🏆
./bundle/chunk-7H2GUAPO.js 673 kB +673 kB (new file) 🆕
./bundle/chunk-AYS2MZKA.js 3.8 kB +3.8 kB (new file) 🆕
./bundle/chunk-EGK2IS4J.js 14.7 MB +14.7 MB (new file) 🆕
./bundle/chunk-LGJVU5VB.js 2.73 MB +2.73 MB (new file) 🆕
./bundle/chunk-NRYT5Y4I.js 3.43 kB +3.43 kB (new file) 🆕
./bundle/chunk-RZGNT4JL.js 49.2 kB +49.2 kB (new file) 🆕
./bundle/core-MES4PGXO.js 48.1 kB +48.1 kB (new file) 🆕
./bundle/devtoolsService-322ZLN2R.js 27.8 kB +27.8 kB (new file) 🆕
./bundle/gemini-6KLYVD66.js 574 kB +574 kB (new file) 🆕
./bundle/interactiveCli-UGL5JMNP.js 1.31 MB +1.31 MB (new file) 🆕
./bundle/liteRtServerManager-CCCX6N6K.js 2.08 kB +2.08 kB (new file) 🆕
./bundle/oauth2-provider-MBUACQNE.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-DAHVX5MI.js 206 kB 0 B
./bundle/chunk-IUUIT4SU.js 56.5 kB 0 B
./bundle/chunk-MTD736U4.js 1.97 MB 0 B
./bundle/chunk-RJTRUG2J.js 39.8 kB 0 B
./bundle/cleanup-JBJVGYBA.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 4.97 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-NSOLCG4U.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-YPV7G5IA.js 0 B -622 B (removed) 🏆
./bundle/tree-sitter-7U6MW5PS.js 274 kB 0 B
./bundle/tree-sitter-bash-34ZGLXVX.js 1.84 MB 0 B
./bundle/cleanup-DSR2SN6X.js 932 B +932 B (new file) 🆕
./bundle/start-6XNB3HU6.js 622 B +622 B (new file) 🆕

compressed-size-action

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 introduces logic to skip the registration of ConsolePatcher cleanup when the CLI is operating in ACP mode, accompanied by new unit tests to verify this behavior. Feedback indicates that the manual flag check for ACP mode duplicates existing logic and should be replaced by the centralized Config object's state to prevent potential inconsistencies.

Comment thread packages/cli/src/gemini.tsx Outdated
@gemini-cli gemini-cli Bot added the area/non-interactive Issues related to GitHub Actions, SDK, 3P Integrations, Shell Scripting, Command line automation label Apr 28, 2026
@cocosheng-g
Copy link
Copy Markdown
Contributor Author

/gemini review

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 modifies the CLI's main entry point to conditionally register the ConsolePatcher cleanup based on whether ACP mode is active. It also introduces unit tests to verify this behavior and adds necessary mocks for the ConsolePatcher and ACP client. Feedback suggests that the current placement of the cleanup registration may still lead to stdout pollution in certain modes (such as JSON output) because it occurs before the SessionEnd hook registration; moving the cleanup registration after the hook is recommended to ensure shutdown logs are correctly redirected to stderr.

Comment thread packages/cli/src/gemini.tsx Outdated
@cocosheng-g
Copy link
Copy Markdown
Contributor Author

/gemini review

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 updates the cleanup logic in the Gemini CLI to conditionally register the ConsolePatcher cleanup. Specifically, it ensures that the cleanup is only registered when not in ACP mode, which helps maintain correct log redirection to stderr during shutdown. Corresponding unit tests have been added to verify this behavior, and the mock configuration has been cleaned up by removing the unused getToolRegistry method. I have no feedback to provide as the changes are clear and well-tested.

@Adib234 Adib234 enabled auto-merge April 28, 2026 17:25
@Adib234 Adib234 added this pull request to the merge queue Apr 28, 2026
@cocosheng-g cocosheng-g self-assigned this Apr 28, 2026
Merged via the queue into main with commit 4b8d5e7 Apr 28, 2026
27 checks passed
@Adib234 Adib234 deleted the acp-stdout branch April 28, 2026 17:44
TirthNaik-99 pushed a commit to TirthNaik-99/gemini-cli that referenced this pull request May 4, 2026
kimjune01 pushed a commit to kimjune01/gemini-cli-claude that referenced this pull request May 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/non-interactive Issues related to GitHub Actions, SDK, 3P Integrations, Shell Scripting, Command line automation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ACP stdout is polluted by SessionEnd hook debug logs during shutdown

2 participants