dsh-tool-antigravity
English | 中文
High-performance, streamlined Antigravity capability bundle plugin for DeepSeek Harness (DSH).
Provides private Google OAuth 2.0 PKCE authentication, smart multi-account pooling with seamless quota failover, multi-model LLM routing (google-antigravity), session-persistent Nano Banana 2 image generation and editing (generate_image, list_images), and an interactive Web settings panel with live quota visualization.
Highlights in v0.5.2
- Core Engine & CLI Fingerprint Sync (
@cortexkit/antigravity-auth-core@3.0.14): Upgraded to the latest upstream core engine and synced wire identity to antigravity/cli/1.3.5.
- New Generation Live Models Support: Added full support for
antigravity-gemini-4-argon (1M context / 65K output with 3-tier thinking), antigravity-claude-opus-5-5 & antigravity-claude-sonnet-5-5 (1M context / 128K output with adaptive thinking and VALIDATED tool calls). Retired models (3.1-pro, 3.6-flash, 3.7-flash, 4-6-thinking) are cleanly refused locally with INVALID_MODEL.
- Fixed HTTP 400 Retry & Hardened Schema Sanitization (Issue #11): Removed
PROTOCOL_DRIFT from providerRetryPolicy so HTTP 400 errors fail immediately without redundant retries; hardened sanitizeSchema with oneOf -> anyOf, nullable type array normalization, and strict required property checks for Gemini Protobuf compatibility.
Features
1. High-Performance Core Architecture
- TLS Connection Pooling & Session Resumption: Built-in HTTP/1.1 Keep-Alive socket pool and TLS session resumption against Google endpoints, eliminating repeated TLS handshake roundtrips and significantly reducing Time-To-First-Token (TTFT).
- Sliding-Window Buffer SSE Parser: High-throughput binary chunking directly locates newline separators on raw Buffers, bypassing heavy string concatenations and drastically reducing V8 heap allocations and GC spikes during long reasoning chains.
- Granular Thinking Budgets: Fine-grained reasoning effort configuration (
low, medium, high) across Gemini and Claude models with graceful fallbacks.
- Pre-flight Idempotent Retry: Automatically retries transient network interruptions (e.g. TLS RST / 502 / 503 / 504) up to 3 times with exponential backoff prior to first byte emission.
- Windows File Lock Recovery: Active PID probing (
process.kill(pid, 0)) detects stale locks from crashed processes and immediately frees them, preventing 30-second hang timeouts.
- Stale-While-Revalidate (SWR) Quota Resilience: Robust quota normalization supporting 5h and weekly windows; retains and displays last-known valid quota with smooth shimmer animations during transient network disruptions.
2. Supported Models (google-antigravity)
| Model Identifier | Display Name | Capabilities | Thinking Budget |
|---|
antigravity-gemini-4-argon | Gemini 4 Argon | Text, Vision, Tools | Low / Medium / High |
antigravity-gemini-3.8-flash | Gemini 3.8 Flash | Text, Vision, Tools | Low / Medium / High |
antigravity-gemini-3.5-flash | Gemini 3.5 Flash | Text, Vision, Tools | Low / Medium / High |
antigravity-claude-opus-5-5 | Claude Opus 5.5 | Text, Vision, Tools | Low / Medium / High |
antigravity-claude-sonnet-5-5 | Claude Sonnet 5.5 | Text, Vision, Tools | Low / Medium / High |
antigravity-gpt-oss-120b-medium | GPT-OSS 120B Medium | Text, Vision, Tools | Fixed Effort |
3. Nano Banana 2 Image Generation & Multi-Turn Editing
generate_image: Prompt-based image creation and iterative image-to-image editing powered by Nano Banana 2 (gemini-3.1-flash-image) using session references.list_images: Inspect and retrieve generated image attachments within the current session.- Fully integrated with DSH
AttachmentStore and FileSystem with TOCTOU path escape protection without polluting chat context with raw base64 payloads.
Installation
Via DSH Plugin CLI (Recommended)
# Add directly to your active DSH web profile
dsh plugin --profile web add dsh-tool-antigravity
Via npm / pnpm
# Using npm
npm install dsh-tool-antigravity
# Using pnpm
pnpm add dsh-tool-antigravity
Cordis Plugin Configuration
Add the plugin entries to your cordis.patch.yml or DSH config file:
- id: antigravity-auth
name: 'dsh-tool-antigravity'
- id: antigravity-image
name: 'dsh-tool-antigravity/image'
Usage & Commands
Slash Commands
Manage authentication directly from the DSH terminal / chat prompt:
/antigravity-auth login: Initiates Google OAuth 2.0 PKCE login and launches your default browser./antigravity-auth status: Check current authentication state, masked email, and project id./antigravity-auth logout: Discard credentials and revoke tokens./antigravity-auth cancel: Abort an ongoing login attempt.
UI Settings & Dashboard
Once loaded in the DSH Web client:
- Antigravity Auth Settings Card: View live login status, account identifier, and toggle capabilities.
- Quota Visualizer: Real-time remaining quota percentages and countdowns for 5-hour and weekly reset windows.
- Image Generation Card: Configure default image models and batch size.
Security & Invariants
- Credential Isolation: Access and refresh tokens are strictly held in host-side secure stores and are never forwarded to the frontend UI, logs, or command done events.
- Strict Loopback Guard: Account RPC endpoints fail-closed (
loopback-required) unless the web service is explicitly bound to 127.0.0.1.
- Immutable Wire Identity: Emits verified AGY CLI headers (
antigravity/cli/1.1.24) and attribution metadata.
- Media Path Containment: All file references are verified against directory traversal and symlink escapes.
Disclaimer
This project is an unofficial, community-driven capability bundle intended strictly for personal research, educational purposes, and independent development. Please adhere to relevant platform Terms of Service.
License
MIT © dsh-tool-antigravity contributors
