feat(antigravity): add Antigravity CLI (agy) provider

[MarkusWohlmuth]

What

Adds an AntigravityCliProvider so CAO can drive Google's Antigravity CLI (agy) — the terminal-native successor to the Gemini CLI. Google retired the free Gemini Code Assist "Login with Google" path for the gemini binary on 2026-06-18 and is steering users to Antigravity, so teams relying on the gemini_cli provider for an independent-model worker need a path forward.

How it works

Modeled on the cursor_cli / gemini_cli providers:

• Launch: agy --dangerously-skip-permissions [--model "<name>"] [-i "<system prompt>"]. Models are the human-readable strings agy models prints (e.g. "Gemini 3.1 Pro (High)"). The profile body + skill catalog (+ security prompt when tool-restricted) is injected via -i with an "acknowledge your role and wait" guard so the agent adopts its role without exploring on launch.
• Status detection (footer-anchored, render-stable): esc to cancel → PROCESSING; ? for shortcuts → IDLE/COMPLETED, split on a turn counter (the TUI footer is identical in both states — same approach as cursor_cli). Survives strip_terminal_escapes.
• Response extraction: text between the echoed > <query> line and the input-box separator, filtering TUI chrome (banner, separators, footer, tips, spinner, ▸ thought lines, ● tool-call lines).
• MCP: writes the profile's mcpServers into agy's ~/.gemini/config/mcp_config.json (the fixed path it reads), forwarding CAO_TERMINAL_ID so cao-mcp-server resolves the terminal for handoff/assign; removed on cleanup.
• Registration: ProviderType.ANTIGRAVITY_CLI, manager branch, tool_mapping, RUNTIME_SKILL_PROMPT_PROVIDERS, SOFT_ENFORCEMENT_PROVIDERS, provider_binaries.
• Exit via /quit.

Testing

• Unit: test/providers/test_antigravity_cli_unit.py (18 tests) — status detection, extraction, command building, MCP config write/cleanup — against captured live-TUI fixtures. Full provider suite green (872 passed).
• Live end-to-end: launched a reviewer agent via CAO on agy (Gemini 3.1 Pro (High)). Verified: agy boots, the -i system prompt + skill catalog inject, role adoption, IDLE→PROCESSING→COMPLETED transitions, and cao-mcp-server connects and load_skill is invoked (confirming the CAO_TERMINAL_ID wiring). The agent returned a structured review (Verdict: CHANGES_REQUESTED).

Notes / limitations

• Tool restrictions are soft (prompt-level via the security prompt) — agy exposes no native hard deny flag, so the provider is in SOFT_ENFORCEMENT_PROVIDERS.
• agy reads MCP config from a single fixed path; concurrent terminals share it. This is safe under CAO's serialized launch (each agy reads the config and spawns its MCP subprocess before the next terminal writes), matching the gemini_cli provider's existing model.
• agy occasionally shows a server-driven feedback survey; it auto-dismisses on normal text input, so it does not affect task delivery.
• Docs: docs/antigravity-cli.md.

Happy to file a tracking issue first if that's preferred per CONTRIBUTING — opening this as a draft for visibility.

🤖 Generated with Claude Code

[codecov-commenter]

Codecov Report

❌ Patch coverage is 25.00000% with 144 lines in your changes missing coverage. Please review.
⚠️ Please upload report for BASE (main@b8b1897). Learn more about missing BASE report.

Files with missing lines	Patch %	Lines
...li_agent_orchestrator/providers/antigravity_cli.py	24.46%	142 Missing ⚠️
src/cli_agent_orchestrator/providers/manager.py	33.33%	2 Missing ⚠️

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #323   +/-   ##
=======================================
  Coverage        ?   14.69%           
=======================================
  Files           ?       76           
  Lines           ?     7670           
  Branches        ?        0           
=======================================
  Hits            ?     1127           
  Misses          ?     6543           
  Partials        ?        0           

Flag	Coverage Δ
unittests	14.69% <25.00%> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[haofeif]

@MarkusWohlmuth Thanks for your contribution! This is a much needed PR as the antigravity cli replaces gemini cli as the new Google Cli.

Can you please make sure that the new provider pass the examples/assign test ?
Supervisor agent is able to parallel assign 3x tasks to data analysts, and sequential handoff to report generator. Data analyst are ables to complete the jobs and successfully send message back to supervisor agent. supervisor agent is able to complete the reporting. Supervisor agent is not supposed to complete the jobs itself.

You can also refer to the skill https://github.com/awslabs/cli-agent-orchestrator/tree/main/skills/cao-provider for the new provider.

Also please address the copilot's reviews, and fix the CI errors and Codecov Report. Much appreciated!

[Copilot]

Pull request overview

Adds a new antigravity_cli provider so CLI Agent Orchestrator can drive Google’s Antigravity CLI (agy) in a tmux-backed interactive TUI session, including status detection, response extraction, and MCP server wiring.

Changes:

• Introduces AntigravityCliProvider with footer-anchored status detection, response extraction, launch command construction, and MCP config merge/cleanup.
• Registers the new provider across the orchestrator (provider type enum, provider manager, runtime skill prompt + soft enforcement sets, API provider listing, and tool mapping).
• Adds unit tests plus captured TUI fixtures and user-facing documentation for setup/usage.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
test/providers/test_antigravity_cli_unit.py	Unit tests for status detection, extraction, command building, and MCP config lifecycle.
test/providers/fixtures/agy_review_completed.txt	Captured “completed” TUI output fixture used by extraction tests.
test/providers/fixtures/agy_processing.txt	Captured “processing” TUI output fixture used by status tests.
test/providers/fixtures/agy_idle.txt	Captured “idle” TUI output fixture used by status tests.
test/providers/fixtures/agy_completed.txt	Captured “completed” TUI output fixture used by status tests.
src/cli_agent_orchestrator/utils/tool_mapping.py	Adds CAO→native tool mapping for antigravity_cli.
src/cli_agent_orchestrator/services/terminal_service.py	Includes antigravity_cli in runtime skill prompt + soft enforcement provider sets.
src/cli_agent_orchestrator/providers/manager.py	Wires provider creation branch for ProviderType.ANTIGRAVITY_CLI.
src/cli_agent_orchestrator/providers/antigravity_cli.py	New provider implementation (launch, MCP config, status detection, extraction, cleanup).
src/cli_agent_orchestrator/models/provider.py	Adds ANTIGRAVITY_CLI to ProviderType enum.
src/cli_agent_orchestrator/api/main.py	Adds antigravity_cli → agy to /agents/providers binary probe list.
docs/antigravity-cli.md	Documentation for installing/configuring/using the new provider.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[MarkusWohlmuth]

@haofeif thanks for the review! Just pushed 2c9fd1a addressing all the feedback:

Copilot review comments

• Safety guard — AntigravityCliProvider now opts into blocks_orchestrated_input_while_waiting_user_answer = True, so orchestrated assign/handoff messages are held back while an approval/picker prompt is up instead of being pasted in as the answer.
• Docstring priority order — corrected get_status docstring so WAITING_USER_ANSWER is listed before PROCESSING, matching the actual check order.
• PII in fixtures — redacted email, hostname, and home-directory paths across agy_idle.txt, agy_processing.txt, agy_completed.txt, and agy_review_completed.txt (now user@host / user@example.com / /Users/example/...).

examples/assign

• Added TestAntigravityCliAssign in test/e2e/test_assign.py covering parallel data_analyst assignment, sequential report_generator handoff, and the full callback round-trip (worker completes → send_message → supervisor receives), plus a require_antigravity fixture. Also added antigravity_cli to PROVIDERS_REQUIRING_WORKSPACE_ACCESS so the supervisor delegates rather than doing the work itself.

CI / Codecov

• Added a dedicated .github/workflows/test-antigravity-cli-provider.yml (unit tests + coverage upload across Python 3.10–3.12, plus black/isort/mypy).
• Added /agents/providers endpoint assertions for antigravity_cli.

One note on coverage: the e2e assign tests require a live agy binary so they skip in CI — the provider's status/extraction logic is exercised by the unit fixtures, but the codecov patch % mostly reflects the e2e paths that can't run on the runner. Happy to add more unit-level coverage if you'd like.