free-antigravity-cli 1.0.0

package/dist/schemaValidator.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Schema Validator Module for Antigravity Proxy
+ *
+ * Validates API response schemas and data integrity for:
+ * - Gemini GenerateContentResponse format
+ * - Custom model configuration objects
+ * - Streaming chunk structure
+ *
+ * This module provides runtime validation to catch malformed
+ * responses before they reach the frontend, improving stability
+ * and preventing cryptic UI errors.
+ */
+interface ValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Validates a Gemini candidate object structure.
+ */
+export declare function validateCandidate(candidate: unknown): ValidationResult;
+/**
+ * Validates a Gemini GenerateContentResponse structure (top-level).
+ */
+export declare function validateGenerateContentResponse(response: unknown): ValidationResult;
+/**
+ * Validates a Cloud Code envelope (wrapper with response, traceId, metadata).
+ */
+export declare function validateCloudCodeEnvelope(envelope: unknown): ValidationResult;
+/**
+ * Validates a custom model configuration object.
+ */
+export declare function validateCustomModel(model: unknown): ValidationResult;
+/**
+ * Validates an array of custom model configurations.
+ */
+export declare function validateCustomModels(models: unknown): ValidationResult;
+/**
+ * Validates a Gemini request body (contents, generationConfig, tools, etc.)
+ */
+export declare function validateGenerateContentRequest(body: unknown): ValidationResult;
+/**
+ * Validates an OpenAI-style streaming chunk.
+ */
+export declare function validateOpenAiChunk(chunk: unknown): ValidationResult;
+/**
+ * Validates an Anthropic streaming event.
+ */
+export declare function validateAnthropicEvent(event: unknown): ValidationResult;
+export {};
+//# sourceMappingURL=schemaValidator.d.ts.map

package/dist/schemaValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaValidator.d.ts","sourceRoot":"","sources":["../src/schemaValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,UAAU,gBAAgB;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,gBAAgB,CAmBtE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,OAAO,GAAG,gBAAgB,CAkBnF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,OAAO,GAAG,gBAAgB,CAS7E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAoDpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAWtE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAkB9E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CASpE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAsBvE"}

package/dist/schemaValidator.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * Schema Validator Module for Antigravity Proxy
+ *
+ * Validates API response schemas and data integrity for:
+ * - Gemini GenerateContentResponse format
+ * - Custom model configuration objects
+ * - Streaming chunk structure
+ *
+ * This module provides runtime validation to catch malformed
+ * responses before they reach the frontend, improving stability
+ * and preventing cryptic UI errors.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateCandidate = validateCandidate;
+exports.validateGenerateContentResponse = validateGenerateContentResponse;
+exports.validateCloudCodeEnvelope = validateCloudCodeEnvelope;
+exports.validateCustomModel = validateCustomModel;
+exports.validateCustomModels = validateCustomModels;
+exports.validateGenerateContentRequest = validateGenerateContentRequest;
+exports.validateOpenAiChunk = validateOpenAiChunk;
+exports.validateAnthropicEvent = validateAnthropicEvent;
+/**
+ * Validates a Gemini candidate object structure.
+ */
+function validateCandidate(candidate) {
+    if (!candidate || typeof candidate !== 'object') {
+        return { valid: false, error: 'Candidate is null or not an object' };
+    }
+    const c = candidate;
+    if (!c.content || typeof c.content !== 'object') {
+        return { valid: false, error: 'Candidate missing content object' };
+    }
+    const content = c.content;
+    if (!Array.isArray(content.parts)) {
+        return { valid: false, error: 'Candidate content.parts is not an array' };
+    }
+    if (content.role && content.role !== 'model') {
+        return { valid: false, error: `Unexpected candidate role: ${content.role}` };
+    }
+    if (c.finishReason && typeof c.finishReason !== 'string') {
+        return { valid: false, error: 'finishReason must be a string' };
+    }
+    return { valid: true };
+}
+/**
+ * Validates a Gemini GenerateContentResponse structure (top-level).
+ */
+function validateGenerateContentResponse(response) {
+    if (!response || typeof response !== 'object') {
+        return { valid: false, error: 'Response is null or not an object' };
+    }
+    const r = response;
+    if (!Array.isArray(r.candidates)) {
+        return { valid: false, error: 'Response candidates is not an array' };
+    }
+    if (r.candidates.length === 0) {
+        return { valid: false, error: 'Response has no candidates' };
+    }
+    for (let i = 0; i < r.candidates.length; i++) {
+        const candidateResult = validateCandidate(r.candidates[i]);
+        if (!candidateResult.valid) {
+            return { valid: false, error: `Candidate[${i}]: ${candidateResult.error}` };
+        }
+    }
+    return { valid: true };
+}
+/**
+ * Validates a Cloud Code envelope (wrapper with response, traceId, metadata).
+ */
+function validateCloudCodeEnvelope(envelope) {
+    if (!envelope || typeof envelope !== 'object') {
+        return { valid: false, error: 'Envelope is null or not an object' };
+    }
+    const e = envelope;
+    if (!e.response || typeof e.response !== 'object') {
+        return { valid: false, error: 'Envelope missing response object' };
+    }
+    return validateGenerateContentResponse(e.response);
+}
+/**
+ * Validates a custom model configuration object.
+ */
+function validateCustomModel(model) {
+    if (!model || typeof model !== 'object') {
+        return { valid: false, error: 'Model is null or not an object' };
+    }
+    const m = model;
+    const required = ['name', 'provider', 'apiUrl'];
+    for (const field of required) {
+        if (!m[field] || typeof m[field] !== 'string') {
+            return { valid: false, error: `Missing or invalid required field: ${field}` };
+        }
+    }
+    const name = m.name;
+    // Validate model name format: should start with "models/" or be a valid path
+    if (!name.startsWith('models/') && !name.includes('/')) {
+        return { valid: false, error: 'Model name must start with "models/"' };
+    }
+    const provider = m.provider;
+    // Validate provider is one of the supported types
+    const validProviders = ['openai', 'anthropic', 'google', 'ollama', 'custom', 'openrouter'];
+    if (!validProviders.includes(provider)) {
+        return { valid: false, error: `Unsupported provider: ${provider}. Must be one of: ${validProviders.join(', ')}` };
+    }
+    const apiUrl = m.apiUrl;
+    // Validate API URL format
+    try {
+        const url = new URL(apiUrl);
+        if (!['http:', 'https:'].includes(url.protocol)) {
+            return { valid: false, error: 'API URL must use http or https protocol' };
+        }
+    }
+    catch (e) {
+        return { valid: false, error: `Invalid API URL: ${e.message}` };
+    }
+    // Validate optional fields
+    if (m.externalModelName && typeof m.externalModelName !== 'string') {
+        return { valid: false, error: 'externalModelName must be a string' };
+    }
+    if (m.displayName && typeof m.displayName !== 'string') {
+        return { valid: false, error: 'displayName must be a string' };
+    }
+    if (m.apiKey && typeof m.apiKey !== 'string') {
+        return { valid: false, error: 'apiKey must be a string' };
+    }
+    if (m.allowUnauthorized !== undefined && typeof m.allowUnauthorized !== 'boolean') {
+        return { valid: false, error: 'allowUnauthorized must be a boolean' };
+    }
+    return { valid: true };
+}
+/**
+ * Validates an array of custom model configurations.
+ */
+function validateCustomModels(models) {
+    if (!Array.isArray(models)) {
+        return { valid: false, error: 'Models must be an array' };
+    }
+    for (let i = 0; i < models.length; i++) {
+        const result = validateCustomModel(models[i]);
+        if (!result.valid) {
+            return { valid: false, error: `Model[${i}]: ${result.error}` };
+        }
+    }
+    return { valid: true };
+}
+/**
+ * Validates a Gemini request body (contents, generationConfig, tools, etc.)
+ */
+function validateGenerateContentRequest(body) {
+    if (!body || typeof body !== 'object') {
+        return { valid: false, error: 'Body is null or not an object' };
+    }
+    const b = body;
+    if (!Array.isArray(b.contents) || b.contents.length === 0) {
+        return { valid: false, error: 'Request must have non-empty contents array' };
+    }
+    if (b.systemInstruction && typeof b.systemInstruction !== 'object') {
+        return { valid: false, error: 'systemInstruction must be an object' };
+    }
+    if (b.generationConfig && typeof b.generationConfig !== 'object') {
+        return { valid: false, error: 'generationConfig must be an object' };
+    }
+    if (b.tools && !Array.isArray(b.tools)) {
+        return { valid: false, error: 'tools must be an array' };
+    }
+    return { valid: true };
+}
+/**
+ * Validates an OpenAI-style streaming chunk.
+ */
+function validateOpenAiChunk(chunk) {
+    if (!chunk || typeof chunk !== 'object') {
+        return { valid: false, error: 'Chunk is null or not an object' };
+    }
+    const c = chunk;
+    if (!Array.isArray(c.choices)) {
+        return { valid: false, error: 'Chunk choices is not an array' };
+    }
+    return { valid: true };
+}
+/**
+ * Validates an Anthropic streaming event.
+ */
+function validateAnthropicEvent(event) {
+    if (!event || typeof event !== 'object') {
+        return { valid: false, error: 'Event is null or not an object' };
+    }
+    const e = event;
+    if (!e.type || typeof e.type !== 'string') {
+        return { valid: false, error: 'Event missing type field' };
+    }
+    const validTypes = [
+        'message_start',
+        'content_block_start',
+        'content_block_delta',
+        'content_block_stop',
+        'message_delta',
+        'message_stop',
+        'ping',
+        'error',
+    ];
+    if (!validTypes.includes(e.type)) {
+        return { valid: false, error: `Unknown event type: ${e.type}` };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=schemaValidator.js.map

package/dist/schemaValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaValidator.js","sourceRoot":"","sources":["../src/schemaValidator.ts"],"names":[],"mappings":"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"}

package/install.cmd

@@ -0,0 +1,33 @@
+@echo off
+echo.
+echo   Free Antigravity CLI - Community Edition
+echo   ========================================
+echo.
+echo   Installing...
+echo.
+
+REM Check if Node.js is installed
+where node >nul 2>nul
+if %ERRORLEVEL% neq 0 (
+    echo   ERROR: Node.js is required but not found.
+    echo   Download from https://nodejs.org
+    exit /b 1
+)
+
+REM Install globally via npm
+call npm install -g free-antigravity-cli
+
+if %ERRORLEVEL% neq 0 (
+    echo.
+    echo   Direct install failed. Trying without global...
+    call npm install -g free-antigravity-cli --force
+)
+
+echo.
+echo   Installation complete!
+echo.
+echo   Try it out: antigravity chat
+echo.
+echo   Or add a model: antigravity models add
+echo.
+pause

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "free-antigravity-cli",
+  "version": "1.0.0",
+  "description": "Open-source community CLI for Antigravity - supports custom AI models (OpenAI, Anthropic, Ollama, OpenRouter, Google AI Studio) alongside Gemini",
+  "homepage": "https://github.com/vahapogut/free-antigravity-cli",
+  "author": {
+    "name": "Vahap Ogut",
+    "email": "vahap.ogut@outlook.com"
+  },
+  "license": "Apache-2.0",
+  "main": "dist/cli.js",
+  "bin": {
+    "antigravity": "./dist/cli.js",
+    "free-antigravity": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "npx tsc",
+    "dev": "npx ts-node src/cli.ts",
+    "start": "node dist/cli.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "antigravity",
+    "cli",
+    "ai",
+    "openai",
+    "anthropic",
+    "claude",
+    "gemini",
+    "ollama",
+    "chatbot",
+    "community",
+    "open-source"
+  ],
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^12.1.0",
+    "inquirer": "^8.2.6",
+    "ora": "^5.4.1"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^8.2.10",
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.0"
+  }
+}

package/src/chat.ts

@@ -0,0 +1,184 @@
+/**
+ * Interactive chat REPL - streaming AI chat in the terminal.
+ */
+import * as readline from 'readline';
+import * as http from 'http';
+import { startProxy, getProxyPort, loadCustomModels, generateModelPlaceholderId, toSlug, CustomModel } from './proxy';
+import { loadModels, CustomModelEntry } from './config';
+
+function toProxyModel(m: CustomModelEntry): CustomModel {
+  return { ...m, displayName: m.displayName || m.name, description: m.description || '', _slug: undefined };
+}
+
+async function getModels(): Promise<string[]> {
+  const custom = loadModels();
+  return custom.map((m) => m.displayName || m.name);
+}
+
+async function selectModel(): Promise<string> {
+  const models = await getModels();
+  console.log('\nAvailable models:');
+  models.forEach((m, i) => console.log(`  ${i + 1}. ${m}`));
+  console.log('  0. Enter model name manually');
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question('\nSelect model (number): ', (answer) => {
+      rl.close();
+      const idx = parseInt(answer, 10) - 1;
+      if (idx >= 0 && idx < models.length) resolve(models[idx]);
+      else resolve('');
+    });
+  });
+}
+
+export async function startChat(model?: string): Promise<void> {
+  // Start proxy
+  let proxyPort: number;
+  try { proxyPort = await startProxy(); }
+  catch { console.error('Failed to start proxy. Is port 50999 in use?'); process.exit(1); }
+
+  console.log(`
+  ╔══════════════════════════════════════╗
+  ║   Free Antigravity CLI v1.0.0      ║
+  ║   Community Edition                 ║
+  ╚══════════════════════════════════════╝
+  Proxy: http://127.0.0.1:${proxyPort}
+  `);
+
+  if (!model) model = await selectModel();
+  if (!model) { console.log('No model selected. Exiting.'); process.exit(0); }
+
+  const customModels = loadModels();
+  const selectedEntry = customModels.find((m) => (m.displayName || m.name) === model);
+  if (!selectedEntry) {
+    console.log(`Model "${model}" not configured. Use "antigravity models add" first.`);
+    process.exit(1);
+  }
+
+  const selectedModel = toProxyModel(selectedEntry);
+  console.log(`Using: ${selectedModel.displayName} (${selectedModel.provider})`);
+  console.log('Type /help for commands, /quit to exit.\n');
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout, prompt: '\n> ' });
+
+  let conversationHistory: { role: string; parts: { text?: string }[] }[] = [];
+
+  rl.on('line', async (line) => {
+    const input = line.trim();
+
+    if (input === '/quit' || input === '/exit') {
+      console.log('Goodbye!');
+      rl.close();
+      process.exit(0);
+    }
+
+    if (input === '/help') {
+      console.log('Commands: /quit, /help, /clear (clear history), /model (switch model)');
+      rl.prompt();
+      return;
+    }
+
+    if (input === '/clear') {
+      conversationHistory = [];
+      console.log('Conversation cleared.');
+      rl.prompt();
+      return;
+    }
+
+    if (input === '/model') {
+      const newModel = await selectModel();
+      if (newModel) {
+        const m = customModels.find((x) => (x.displayName || x.name) === newModel);
+        if (m) { console.log(`Switched to ${m.displayName}`); }
+      }
+      rl.prompt();
+      return;
+    }
+
+    if (!input) { rl.prompt(); return; }
+
+    // Build Gemini request
+    const geminiBody = {
+      model: selectedModel.name,
+      contents: [
+        ...conversationHistory,
+        { role: 'user', parts: [{ text: input }] },
+      ],
+      generationConfig: { temperature: 0.7, maxOutputTokens: 4096 },
+    };
+
+    // Send to proxy
+    const placeholderId = generateModelPlaceholderId(selectedModel);
+    const slug = toSlug(selectedModel);
+
+    const postData = JSON.stringify({
+      request: geminiBody,
+      model: slug,
+      project: 'free-antigravity-cli',
+      requestId: Date.now().toString(),
+      requestType: 'CHAT',
+    });
+
+    const options: http.RequestOptions = {
+      hostname: '127.0.0.1',
+      port: proxyPort,
+      path: '/v1internal:streamGenerateContent?alt=sse',
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(postData),
+        'Accept': 'text/event-stream',
+      },
+    };
+
+    const req = http.request(options, (res) => {
+      let buffer = '';
+      let fullResponse = '';
+
+      res.on('data', (chunk: Buffer) => {
+        buffer += chunk.toString('utf-8');
+        const lines = buffer.split('\n');
+        buffer = lines.pop() || '';
+
+        for (const line of lines) {
+          const trimmed = line.trim();
+          if (!trimmed || !trimmed.startsWith('data: ')) continue;
+          try {
+            const data = JSON.parse(trimmed.substring(6));
+            const candidates = data.response?.candidates || [];
+            for (const c of candidates) {
+              const parts = c.content?.parts || [];
+              for (const p of parts) {
+                if (p.text && !p.thought) {
+                  process.stdout.write(p.text);
+                  fullResponse += p.text;
+                }
+              }
+            }
+          } catch { /* partial chunk */ }
+        }
+      });
+
+      res.on('end', () => {
+        console.log();
+        conversationHistory.push({ role: 'user', parts: [{ text: input }] });
+        conversationHistory.push({ role: 'model', parts: [{ text: fullResponse }] });
+        // Keep history manageable
+        if (conversationHistory.length > 20) conversationHistory = conversationHistory.slice(-20);
+        rl.prompt();
+      });
+    });
+
+    req.on('error', (err) => {
+      console.error(`\nConnection error: ${err.message}`);
+      console.error('Is the proxy running? Try: antigravity proxy');
+      rl.prompt();
+    });
+
+    req.write(postData);
+    req.end();
+  });
+
+  rl.prompt();
+}