Skip to content

refactor(core): introduce SubagentState enum for progress#26934

Merged
adamfweidman merged 5 commits into
mainfrom
refactor/subagent-progress-enums
May 12, 2026
Merged

refactor(core): introduce SubagentState enum for progress#26934
adamfweidman merged 5 commits into
mainfrom
refactor/subagent-progress-enums

Conversation

@adamfweidman
Copy link
Copy Markdown
Contributor

@adamfweidman adamfweidman commented May 12, 2026

Summary

Refactors SubagentProgress and SubagentActivityItem to use a new SubagentState enum instead of string literal unions for status values (running, completed, error, cancelled). This improves type safety and maintainability.

Details

  • Defined SubagentState enum in packages/core/src/agents/types.ts.
  • Updated usages in:
    • packages/core/src/agents/local-invocation.ts
    • packages/core/src/agents/remote-invocation.ts
    • packages/core/src/agents/a2aUtils.ts
    • packages/core/src/agents/browser/browserAgentInvocation.ts
    • packages/cli/src/ui/components/messages/SubagentGroupDisplay.tsx
  • Updated tests to use the enum in assertions and mock data.
  • Note: Some UI tests in packages/cli failed during preflight due to environment issues (toMatchSvgSnapshot missing) and non-deterministic spinner frames in snapshots. These are unrelated to this refactor.

Related Issues

Cleanup towards #20995 generally

How to Validate

Run unit tests in packages/core:

npx vitest run packages/core/src/agents/local-invocation.test.ts
npx vitest run packages/core/src/agents/remote-invocation.test.ts

Pre-Merge Checklist

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

@adamfweidman adamfweidman requested a review from a team as a code owner May 12, 2026 18:12
@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 standardizes subagent status management by introducing a SubagentState enum. By replacing loose string literals with a strongly-typed enum, the changes enhance the robustness of agent state tracking and simplify maintenance across both core logic and UI components.

Highlights

  • Enum Introduction: Introduced the SubagentState enum to replace string literal unions for agent status values, providing a centralized and type-safe way to manage subagent states.
  • Type Safety Improvements: Updated core agent invocation logic and UI components to utilize the new enum, significantly improving type safety and maintainability across the codebase.
  • Test Refactoring: Refactored existing unit and regression tests to use the SubagentState enum for status assertions, ensuring consistency with the updated core logic.
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.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 12, 2026

Size Change: +1.39 kB (0%)

Total Size: 34.1 MB

Filename Size Change
./bundle/chunk-3CXVGURJ.js 0 B -3.43 kB (removed) 🏆
./bundle/chunk-AQAEDKDP.js 0 B -2.78 MB (removed) 🏆
./bundle/chunk-F75QE7GW.js 0 B -19.5 kB (removed) 🏆
./bundle/chunk-J6ONP7GM.js 0 B -14.8 MB (removed) 🏆
./bundle/chunk-MCAF3UOB.js 0 B -12.5 kB (removed) 🏆
./bundle/chunk-NJQ5BAXR.js 0 B -49.2 kB (removed) 🏆
./bundle/chunk-UCKBKHVY.js 0 B -3.8 kB (removed) 🏆
./bundle/chunk-ZF6PYIIB.js 0 B -659 kB (removed) 🏆
./bundle/core-ESXV4UZC.js 0 B -49.2 kB (removed) 🏆
./bundle/devtoolsService-5IBIX6S4.js 0 B -28 kB (removed) 🏆
./bundle/gemini-NYURXGUP.js 0 B -587 kB (removed) 🏆
./bundle/interactiveCli-QP7P4J2M.js 0 B -1.3 MB (removed) 🏆
./bundle/liteRtServerManager-PLWK2YU6.js 0 B -2.11 kB (removed) 🏆
./bundle/oauth2-provider-U6GCASUQ.js 0 B -9.16 kB (removed) 🏆
./bundle/chunk-DAWWRC45.js 19.5 kB +19.5 kB (new file) 🆕
./bundle/chunk-F3YELFLL.js 2.78 MB +2.78 MB (new file) 🆕
./bundle/chunk-HLHQ6UMO.js 49.2 kB +49.2 kB (new file) 🆕
./bundle/chunk-HOC77ODV.js 14.8 MB +14.8 MB (new file) 🆕
./bundle/chunk-O6UVHVIO.js 3.43 kB +3.43 kB (new file) 🆕
./bundle/chunk-PKSHYNLY.js 3.8 kB +3.8 kB (new file) 🆕
./bundle/chunk-VHTB4Q3R.js 659 kB +659 kB (new file) 🆕
./bundle/chunk-XAOYWO22.js 12.5 kB +12.5 kB (new file) 🆕
./bundle/core-HHIUMQNZ.js 49.3 kB +49.3 kB (new file) 🆕
./bundle/devtoolsService-EH6S4COF.js 28 kB +28 kB (new file) 🆕
./bundle/gemini-C6J6UFMR.js 587 kB +587 kB (new file) 🆕
./bundle/interactiveCli-63GAEXUO.js 1.3 MB +1.3 MB (new file) 🆕
./bundle/liteRtServerManager-WS3AKX4E.js 2.11 kB +2.11 kB (new file) 🆕
./bundle/oauth2-provider-OI4VWMWJ.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-RJTRUG2J.js 39.8 kB 0 B
./bundle/chunk-SAKTCNAD.js 1.97 MB 0 B
./bundle/cleanup-KMG5TWSO.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-QD2WWMTN.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-342GB5HR.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-YQOY7P7A.js 932 B +932 B (new file) 🆕
./bundle/start-RQDIEVB4.js 652 B +652 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 a SubagentState enum to replace string literals for subagent statuses, improving type safety and consistency across the core logic, UI components, and test suites. While the refactor is applied extensively, feedback indicates that the migration is incomplete in SubagentGroupDisplay.tsx, where some hardcoded string literals still persist.

Comment thread packages/cli/src/ui/components/messages/SubagentGroupDisplay.tsx
@adamfweidman
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 introduces a SubagentState enum to replace string literals for managing subagent states, improving type safety and consistency across the codebase. The reviewer highlights that several string literal usages were missed in SubagentProgressDisplay.tsx and remote-invocation.test.ts, which must be updated to avoid TypeScript compilation errors.

Comment thread packages/core/src/agents/types.ts
@adamfweidman
Copy link
Copy Markdown
Contributor Author

/gemini review

@gemini-cli gemini-cli Bot added the status/need-issue Pull requests that need to have an associated issue. label May 12, 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 refactors the handling of subagent statuses by introducing a SubagentState enum in packages/core. This enum replaces string literals for 'running', 'completed', 'error', and 'cancelled' states across the CLI UI components, core agent logic, and associated test files, ensuring better type safety and consistency throughout the monorepo. I have no feedback to provide.

@adamfweidman adamfweidman enabled auto-merge May 12, 2026 18:48
@adamfweidman adamfweidman added this pull request to the merge queue May 12, 2026
Merged via the queue into main with commit c987b99 May 12, 2026
29 checks passed
@adamfweidman adamfweidman deleted the refactor/subagent-progress-enums branch May 12, 2026 19:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

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.

2 participants