antigravity-claude-proxy 1.2.10 → 1.2.12

package/README.md

@@ -39,10 +39,10 @@ A proxy server that exposes an **Anthropic-compatible API** backed by **Antigrav
 
 ```bash
 # Run directly with npx (no install needed)
-npx antigravity-claude-proxy start
+npx antigravity-claude-proxy@latest start
 
 # Or install globally
-npm install -g antigravity-claude-proxy
+npm install -g antigravity-claude-proxy@latest
 antigravity-claude-proxy start
 ```
 
@@ -78,7 +78,7 @@ Add one or more Google accounts for load balancing.
 antigravity-claude-proxy accounts add
 
 # If using npx
-npx antigravity-claude-proxy accounts add
+npx antigravity-claude-proxy@latest accounts add
 
 # If cloned locally
 npm run accounts:add
@@ -93,7 +93,7 @@ This opens your browser for Google OAuth. Sign in and authorize access. Repeat f
 antigravity-claude-proxy accounts add --no-browser
 
 # If using npx
-npx antigravity-claude-proxy accounts add -- --no-browser
+npx antigravity-claude-proxy@latest accounts add -- --no-browser
 
 # If cloned locally
 npm run accounts:add -- --no-browser
@@ -121,7 +121,7 @@ antigravity-claude-proxy accounts
 antigravity-claude-proxy start
 
 # If using npx
-npx antigravity-claude-proxy start
+npx antigravity-claude-proxy@latest start
 
 # If cloned locally
 npm start
@@ -161,12 +161,15 @@ Add this configuration:
     "ANTHROPIC_MODEL": "claude-opus-4-5-thinking",
     "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5-thinking",
     "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-thinking",
-    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-5",
-    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-4-5-thinking"
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-2.5-flash-lite",
+    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-4-5-thinking",
+    "ENABLE_EXPERIMENTAL_MCP_CLI": "true"
   }
 }
 ```
 
+(Please use **gemini-2.5-flash-lite** as the default haiku model, even if others are claude, as claude code makes several calls via the haiku model for background tasks. If you use claude model for it, you may use you claude usage sooner)
+
 Or to use Gemini models:
 
 ```json
@@ -178,7 +181,8 @@ Or to use Gemini models:
     "ANTHROPIC_DEFAULT_OPUS_MODEL": "gemini-3-pro-high",
     "ANTHROPIC_DEFAULT_SONNET_MODEL": "gemini-3-flash",
     "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-2.5-flash-lite",
-    "CLAUDE_CODE_SUBAGENT_MODEL": "gemini-3-flash"
+    "CLAUDE_CODE_SUBAGENT_MODEL": "gemini-3-flash",
+    "ENABLE_EXPERIMENTAL_MCP_CLI": "true"
   }
 }
 ```
@@ -191,7 +195,7 @@ Add the proxy settings to your shell profile:
 
 ```bash
 echo 'export ANTHROPIC_BASE_URL="http://localhost:8080"' >> ~/.zshrc
-echo 'export ANTHROPIC_API_KEY="test"' >> ~/.zshrc
+echo 'export ANTHROPIC_AUTH_TOKEN="test"' >> ~/.zshrc
 source ~/.zshrc
 ```
 
@@ -201,7 +205,7 @@ source ~/.zshrc
 
 ```powershell
 Add-Content $PROFILE "`n`$env:ANTHROPIC_BASE_URL = 'http://localhost:8080'"
-Add-Content $PROFILE "`$env:ANTHROPIC_API_KEY = 'test'"
+Add-Content $PROFILE "`$env:ANTHROPIC_AUTH_TOKEN = 'test'"
 . $PROFILE
 ```
 
@@ -209,7 +213,7 @@ Add-Content $PROFILE "`$env:ANTHROPIC_API_KEY = 'test'"
 
 ```cmd
 setx ANTHROPIC_BASE_URL "http://localhost:8080"
-setx ANTHROPIC_API_KEY "test"
+setx ANTHROPIC_AUTH_TOKEN "test"
 ```
 
 Restart your terminal for changes to take effect.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antigravity-claude-proxy",
-  "version": "1.2.10",
+  "version": "1.2.12",
   "description": "Proxy server to use Antigravity's Claude models with Claude Code CLI",
   "main": "src/index.js",
   "type": "module",
@@ -27,7 +27,8 @@
     "test:images": "node tests/test-images.cjs",
     "test:caching": "node tests/test-caching-streaming.cjs",
     "test:crossmodel": "node tests/test-cross-model-thinking.cjs",
-    "test:oauth": "node tests/test-oauth-no-browser.cjs"
+    "test:oauth": "node tests/test-oauth-no-browser.cjs",
+    "test:emptyretry": "node tests/test-empty-response-retry.cjs"
   },
   "keywords": [
     "claude",

package/src/cloudcode/request-builder.js

@@ -7,6 +7,7 @@
 import crypto from 'crypto';
 import {
     ANTIGRAVITY_HEADERS,
+    ANTIGRAVITY_SYSTEM_INSTRUCTION,
     getModelFamily,
     isThinkingModel
 } from '../constants.js';
@@ -27,14 +28,34 @@ export function buildCloudCodeRequest(anthropicRequest, projectId) {
     // Use stable session ID derived from first user message for cache continuity
     googleRequest.sessionId = deriveSessionId(anthropicRequest);
 
+    // Build systemInstruction with role: "user" (CLIProxyAPI v6.6.89 compatibility)
+    // Prepend Antigravity identity to any existing system instructions
+    let systemInstructionText = ANTIGRAVITY_SYSTEM_INSTRUCTION;
+    if (googleRequest.systemInstruction && googleRequest.systemInstruction.parts) {
+        const existingText = googleRequest.systemInstruction.parts
+            .map(p => p.text || '')
+            .filter(t => t)
+            .join('\n');
+        if (existingText) {
+            systemInstructionText = ANTIGRAVITY_SYSTEM_INSTRUCTION + '\n\n' + existingText;
+        }
+    }
+
     const payload = {
         project: projectId,
         model: model,
         request: googleRequest,
         userAgent: 'antigravity',
+        requestType: 'agent',  // CLIProxyAPI v6.6.89 compatibility
         requestId: 'agent-' + crypto.randomUUID()
     };
 
+    // Inject systemInstruction with role: "user" at the top level (CLIProxyAPI v6.6.89 behavior)
+    payload.request.systemInstruction = {
+        role: 'user',
+        parts: [{ text: systemInstructionText }]
+    };
+
     return payload;
 }
 

package/src/cloudcode/sse-streamer.js

@@ -7,6 +7,7 @@
 
 import crypto from 'crypto';
 import { MIN_SIGNATURE_LENGTH, getModelFamily } from '../constants.js';
+import { EmptyResponseError } from '../errors.js';
 import { cacheSignature, cacheThinkingSignature } from '../format/signature-cache.js';
 import { logger } from '../utils/logger.js';
 
@@ -226,39 +227,10 @@ export async function* streamSSEResponse(response, originalModel) {
         }
     }
 
-    // Handle no content received
+    // Handle no content received - throw error to trigger retry in streaming-handler
     if (!hasEmittedStart) {
-        logger.warn('[CloudCode] No content parts received, emitting empty message');
-        yield {
-            type: 'message_start',
-            message: {
-                id: messageId,
-                type: 'message',
-                role: 'assistant',
-                content: [],
-                model: originalModel,
-                stop_reason: null,
-                stop_sequence: null,
-                usage: {
-                    input_tokens: inputTokens - cacheReadTokens,
-                    output_tokens: 0,
-                    cache_read_input_tokens: cacheReadTokens,
-                    cache_creation_input_tokens: 0
-                }
-            }
-        };
-
-        yield {
-            type: 'content_block_start',
-            index: 0,
-            content_block: { type: 'text', text: '' }
-        };
-        yield {
-            type: 'content_block_delta',
-            index: 0,
-            delta: { type: 'text_delta', text: '[No response received from API]' }
-        };
-        yield { type: 'content_block_stop', index: 0 };
+        logger.warn('[CloudCode] No content parts received, throwing for retry');
+        throw new EmptyResponseError('No content parts received from API');
     } else {
         // Close any open block
         if (currentBlockType !== null) {

package/src/cloudcode/streaming-handler.js

@@ -8,16 +8,17 @@
 import {
     ANTIGRAVITY_ENDPOINT_FALLBACKS,
     MAX_RETRIES,
+    MAX_EMPTY_RESPONSE_RETRIES,
     MAX_WAIT_BEFORE_ERROR_MS
 } from '../constants.js';
-import { isRateLimitError, isAuthError } from '../errors.js';
+import { isRateLimitError, isAuthError, isEmptyResponseError } from '../errors.js';
 import { formatDuration, sleep, isNetworkError } from '../utils/helpers.js';
 import { logger } from '../utils/logger.js';
 import { parseResetTime } from './rate-limit-parser.js';
 import { buildCloudCodeRequest, buildHeaders } from './request-builder.js';
 import { streamSSEResponse } from './sse-streamer.js';
 import { getFallbackModel } from '../fallback-config.js';
-
+import crypto from 'crypto';
 
 /**
  * Send a streaming request to Cloud Code with multi-account support
@@ -143,16 +144,90 @@ export async function* sendMessageStream(anthropicRequest, accountManager, fallb
                         continue;
                     }
 
-                    // Stream the response - yield events as they arrive
-                    yield* streamSSEResponse(response, anthropicRequest.model);
+                    // Stream the response with retry logic for empty responses
+                    // Uses a for-loop for clearer retry semantics
+                    let currentResponse = response;
+
+                    for (let emptyRetries = 0; emptyRetries <= MAX_EMPTY_RESPONSE_RETRIES; emptyRetries++) {
+                        try {
+                            yield* streamSSEResponse(currentResponse, anthropicRequest.model);
+                            logger.debug('[CloudCode] Stream completed');
+                            return;
+                        } catch (streamError) {
+                            // Only retry on EmptyResponseError
+                            if (!isEmptyResponseError(streamError)) {
+                                throw streamError;
+                            }
+
+                            // Check if we have retries left
+                            if (emptyRetries >= MAX_EMPTY_RESPONSE_RETRIES) {
+                                logger.error(`[CloudCode] Empty response after ${MAX_EMPTY_RESPONSE_RETRIES} retries`);
+                                yield* emitEmptyResponseFallback(anthropicRequest.model);
+                                return;
+                            }
+
+                            // Exponential backoff: 500ms, 1000ms, 2000ms
+                            const backoffMs = 500 * Math.pow(2, emptyRetries);
+                            logger.warn(`[CloudCode] Empty response, retry ${emptyRetries + 1}/${MAX_EMPTY_RESPONSE_RETRIES} after ${backoffMs}ms...`);
+                            await sleep(backoffMs);
+
+                            // Refetch the response
+                            currentResponse = await fetch(url, {
+                                method: 'POST',
+                                headers: buildHeaders(token, model, 'text/event-stream'),
+                                body: JSON.stringify(payload)
+                            });
 
-                    logger.debug('[CloudCode] Stream completed');
-                    return;
+                            // Handle specific error codes on retry
+                            if (!currentResponse.ok) {
+                                const retryErrorText = await currentResponse.text();
+
+                                // Rate limit error - mark account and throw to trigger account switch
+                                if (currentResponse.status === 429) {
+                                    const resetMs = parseResetTime(currentResponse, retryErrorText);
+                                    accountManager.markRateLimited(account.email, resetMs, model);
+                                    throw new Error(`429 RESOURCE_EXHAUSTED during retry: ${retryErrorText}`);
+                                }
+
+                                // Auth error - clear caches and throw with recognizable message
+                                if (currentResponse.status === 401) {
+                                    accountManager.clearTokenCache(account.email);
+                                    accountManager.clearProjectCache(account.email);
+                                    throw new Error(`401 AUTH_INVALID during retry: ${retryErrorText}`);
+                                }
+
+                                // For 5xx errors, don't pass to streamer - just continue to next retry
+                                if (currentResponse.status >= 500) {
+                                    logger.warn(`[CloudCode] Retry got ${currentResponse.status}, will retry...`);
+                                    // Don't continue here - let the loop increment and refetch
+                                    // Set currentResponse to null to force refetch at loop start
+                                    emptyRetries--; // Compensate for loop increment since we didn't actually try
+                                    await sleep(1000);
+                                    // Refetch immediately for 5xx
+                                    currentResponse = await fetch(url, {
+                                        method: 'POST',
+                                        headers: buildHeaders(token, model, 'text/event-stream'),
+                                        body: JSON.stringify(payload)
+                                    });
+                                    if (currentResponse.ok) {
+                                        continue; // Try streaming with new response
+                                    }
+                                    // If still failing, let it fall through to throw
+                                }
+
+                                throw new Error(`Empty response retry failed: ${currentResponse.status} - ${retryErrorText}`);
+                            }
+                            // Response is OK, loop will continue to try streamSSEResponse
+                        }
+                    }
 
                 } catch (endpointError) {
                     if (isRateLimitError(endpointError)) {
                         throw endpointError; // Re-throw to trigger account switch
                     }
+                    if (isEmptyResponseError(endpointError)) {
+                        throw endpointError; // Re-throw empty response errors to outer handler
+                    }
                     logger.warn(`[CloudCode] Stream error at ${endpoint}:`, endpointError.message);
                     lastError = endpointError;
                 }
@@ -201,3 +276,49 @@ export async function* sendMessageStream(anthropicRequest, accountManager, fallb
 
     throw new Error('Max retries exceeded');
 }
+
+/**
+ * Emit a fallback message when all retry attempts fail with empty response
+ * @param {string} model - The model name
+ * @yields {Object} Anthropic-format SSE events for empty response fallback
+ */
+function* emitEmptyResponseFallback(model) {
+    // Use proper message ID format consistent with Anthropic API
+    const messageId = `msg_${crypto.randomBytes(16).toString('hex')}`;
+
+    yield {
+        type: 'message_start',
+        message: {
+            id: messageId,
+            type: 'message',
+            role: 'assistant',
+            content: [],
+            model: model,
+            stop_reason: null,
+            stop_sequence: null,
+            usage: { input_tokens: 0, output_tokens: 0 }
+        }
+    };
+
+    yield {
+        type: 'content_block_start',
+        index: 0,
+        content_block: { type: 'text', text: '' }
+    };
+
+    yield {
+        type: 'content_block_delta',
+        index: 0,
+        delta: { type: 'text_delta', text: '[No response after retries - please try again]' }
+    };
+
+    yield { type: 'content_block_stop', index: 0 };
+
+    yield {
+        type: 'message_delta',
+        delta: { stop_reason: 'end_turn', stop_sequence: null },
+        usage: { output_tokens: 0 }
+    };
+
+    yield { type: 'message_stop' };
+}

package/src/constants.js

@@ -76,6 +76,7 @@ export const ANTIGRAVITY_DB_PATH = getAntigravityDbPath();
 
 export const DEFAULT_COOLDOWN_MS = 10 * 1000; // 10 second default cooldown
 export const MAX_RETRIES = 5; // Max retry attempts across accounts
+export const MAX_EMPTY_RESPONSE_RETRIES = 2; // Max retries for empty API responses
 export const MAX_ACCOUNTS = 10; // Maximum number of accounts allowed
 
 // Rate limit wait thresholds
@@ -144,6 +145,89 @@ export const OAUTH_CONFIG = {
 };
 export const OAUTH_REDIRECT_URI = `http://localhost:${OAUTH_CONFIG.callbackPort}/oauth-callback`;
 
+// Antigravity system instruction (from CLIProxyAPI v6.6.89)
+// Required for compatibility with latest Antigravity API changes
+export const ANTIGRAVITY_SYSTEM_INSTRUCTION = `<identity>
+You are Antigravity, a powerful agentic AI coding assistant designed by the Google Deepmind team working on Advanced Agentic Coding.
+You are pair programming with a USER to solve their coding task. The task may require creating a new codebase, modifying or debugging an existing codebase, or simply answering a question.
+The USER will send you requests, which you must always prioritize addressing. Along with each USER request, we will attach additional metadata about their current state, such as what files they have open and where their cursor is.
+This information may or may not be relevant to the coding task, it is up for you to decide.
+</identity>
+
+<tool_calling>
+Call tools as you normally would. The following list provides additional guidance to help you avoid errors:
+ - **Absolute paths only**. When using tools that accept file path arguments, ALWAYS use the absolute file path.
+</tool_calling>
+
+<web_application_development>
+## Technology Stack,
+Your web applications should be built using the following technologies:,
+1. **Core**: Use HTML for structure and Javascript for logic.
+2. **Styling (CSS)**: Use Vanilla CSS for maximum flexibility and control. Avoid using TailwindCSS unless the USER explicitly requests it; in this case, first confirm which TailwindCSS version to use.
+3. **Web App**: If the USER specifies that they want a more complex web app, use a framework like Next.js or Vite. Only do this if the USER explicitly requests a web app.
+4. **New Project Creation**: If you need to use a framework for a new app, use \`npx\` with the appropriate script, but there are some rules to follow:,
+ - Use \`npx -y\` to automatically install the script and its dependencies
+ - You MUST run the command with \`--help\` flag to see all available options first, 
+ - Initialize the app in the current directory with \`./\` (example: \`npx -y create-vite-app@latest ./\`),
+ - You should run in non-interactive mode so that the user doesn't need to input anything,
+5. **Running Locally**: When running locally, use \`npm run dev\` or equivalent dev server. Only build the production bundle if the USER explicitly requests it or you are validating the code for correctness.
+
+# Design Aesthetics,
+1. **Use Rich Aesthetics**: The USER should be wowed at first glance by the design. Use best practices in modern web design (e.g. vibrant colors, dark modes, glassmorphism, and dynamic animations) to create a stunning first impression. Failure to do this is UNACCEPTABLE.
+2. **Prioritize Visual Excellence**: Implement designs that will WOW the user and feel extremely premium:
+		- Avoid generic colors (plain red, blue, green). Use curated, harmonious color palettes (e.g., HSL tailored colors, sleek dark modes).
+ - Using modern typography (e.g., from Google Fonts like Inter, Roboto, or Outfit) instead of browser defaults.
+		- Use smooth gradients,
+		- Add subtle micro-animations for enhanced user experience,
+3. **Use a Dynamic Design**: An interface that feels responsive and alive encourages interaction. Achieve this with hover effects and interactive elements. Micro-animations, in particular, are highly effective for improving user engagement.
+4. **Premium Designs**. Make a design that feels premium and state of the art. Avoid creating simple minimum viable products.
+4. **Don't use placeholders**. If you need an image, use your generate_image tool to create a working demonstration.,
+
+## Implementation Workflow,
+Follow this systematic approach when building web applications:,
+1. **Plan and Understand**:,
+		- Fully understand the user's requirements,
+		- Draw inspiration from modern, beautiful, and dynamic web designs,
+		- Outline the features needed for the initial version,
+2. **Build the Foundation**:,
+		- Start by creating/modifying \`index.css\`,
+		- Implement the core design system with all tokens and utilities,
+3. **Create Components**:,
+		- Build necessary components using your design system,
+		- Ensure all components use predefined styles, not ad-hoc utilities,
+		- Keep components focused and reusable,
+4. **Assemble Pages**:,
+		- Update the main application to incorporate your design and components,
+		- Ensure proper routing and navigation,
+		- Implement responsive layouts,
+5. **Polish and Optimize**:,
+		- Review the overall user experience,
+		- Ensure smooth interactions and transitions,
+		- Optimize performance where needed,
+
+## SEO Best Practices,
+Automatically implement SEO best practices on every page:,
+- **Title Tags**: Include proper, descriptive title tags for each page,
+- **Meta Descriptions**: Add compelling meta descriptions that accurately summarize page content,
+- **Heading Structure**: Use a single \`<h1>\` per page with proper heading hierarchy,
+- **Semantic HTML**: Use appropriate HTML5 semantic elements,
+- **Unique IDs**: Ensure all interactive elements have unique, descriptive IDs for browser testing,
+- **Performance**: Ensure fast page load times through optimization,
+CRITICAL REMINDER: AESTHETICS ARE VERY IMPORTANT. If your web app looks simple and basic then you have FAILED!
+</web_application_development>
+<ephemeral_message>
+There will be an <EPHEMERAL_MESSAGE> appearing in the conversation at times. This is not coming from the user, but instead injected by the system as important information to pay attention to. 
+Do not respond to nor acknowledge those messages, but do follow them strictly.
+</ephemeral_message>
+
+
+<communication_style>
+- **Formatting**. Format your responses in github-style markdown to make your responses easier for the USER to parse. For example, use headers to organize your responses and bolded or italicized text to highlight important keywords. Use backticks to format file, directory, function, and class names. If providing a URL to the user, format this in markdown as well, for example \`[label](example.com)\`.
+- **Proactiveness**. As an agent, you are allowed to be proactive, but only in the course of completing the user's task. For example, if the user asks you to add a new component, you can edit the code, verify build and test statuses, and take any other obvious follow-up actions, such as performing additional research. However, avoid surprising the user. For example, if the user asks HOW to approach something, you should answer their question and instead of jumping into editing a file.
+- **Helpfulness**. Respond like a helpful software engineer who is explaining your work to a friendly collaborator on the project. Acknowledge mistakes or any backtracking you do as a result of new information.
+- **Ask for clarification**. If you are unsure about the USER's intent, always ask for clarification rather than making assumptions.
+</communication_style>`;
+
 // Model fallback mapping - maps primary model to fallback when quota exhausted
 export const MODEL_FALLBACK_MAP = {
     'gemini-3-pro-high': 'claude-opus-4-5-thinking',
@@ -166,6 +250,7 @@ export default {
     ANTIGRAVITY_DB_PATH,
     DEFAULT_COOLDOWN_MS,
     MAX_RETRIES,
+    MAX_EMPTY_RESPONSE_RETRIES,
     MAX_ACCOUNTS,
     MAX_WAIT_BEFORE_ERROR_MS,
     MIN_SIGNATURE_LENGTH,
@@ -176,5 +261,6 @@ export default {
     isThinkingModel,
     OAUTH_CONFIG,
     OAUTH_REDIRECT_URI,
-    MODEL_FALLBACK_MAP
+    MODEL_FALLBACK_MAP,
+    ANTIGRAVITY_SYSTEM_INSTRUCTION
 };

package/src/errors.js

@@ -135,6 +135,20 @@ export class NativeModuleError extends AntigravityError {
     }
 }
 
+/**
+ * Empty response error - thrown when API returns no content
+ * Used to trigger retry logic in streaming handler
+ */
+export class EmptyResponseError extends AntigravityError {
+    /**
+     * @param {string} message - Error message
+     */
+    constructor(message = 'No content received from API') {
+        super(message, 'EMPTY_RESPONSE', true, {});
+        this.name = 'EmptyResponseError';
+    }
+}
+
 /**
  * Check if an error is a rate limit error
  * Works with both custom error classes and legacy string-based errors
@@ -164,6 +178,16 @@ export function isAuthError(error) {
         msg.includes('TOKEN REFRESH FAILED');
 }
 
+/**
+ * Check if an error is an empty response error
+ * @param {Error} error - Error to check
+ * @returns {boolean}
+ */
+export function isEmptyResponseError(error) {
+    return error instanceof EmptyResponseError ||
+        error?.name === 'EmptyResponseError';
+}
+
 export default {
     AntigravityError,
     RateLimitError,
@@ -172,6 +196,8 @@ export default {
     MaxRetriesError,
     ApiError,
     NativeModuleError,
+    EmptyResponseError,
     isRateLimitError,
-    isAuthError
+    isAuthError,
+    isEmptyResponseError
 };