opencode-antigravity-img 0.1.2 → 0.2.1

package/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.1] - 2026-01-28
+
+### Fixed
+- Clarify in tool description that output is always JPEG format
+- Fix default filename extension from `.png` to `.jpg`
+- Remove unnecessary PNG check since API always returns JPEG
+
+## [0.2.0] - 2026-01-27
+
+### Added
+- Related plugins section in README linking to sibling plugins
+
+### Changed
+- Updated auth plugin link to correct repository (NoeFabris)
+
+## [0.1.0] - 2026-01-26
+
+### Added
+- Initial release
+- `generate_image` tool for generating images with Gemini 3 Pro Image model
+- `image_quota` tool for checking remaining quota
+- Support for aspect ratios: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
+- Support for image sizes: 1K, 2K, 4K
+- Automatic fallback between CloudCode API endpoints

package/README.md

@@ -43,10 +43,12 @@ Generate an image from a text prompt.
 - `prompt` (required): Text description of the image to generate
 - `filename` (optional): Output filename (default: `generated_<timestamp>.jpg`)
 - `output_dir` (optional): Output directory (default: current working directory)
+- `aspect_ratio` (optional): Image aspect ratio. Supported values: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` (default: `1:1`)
+- `image_size` (optional): Image resolution. Supported values: `1K`, `2K`, `4K` (default: `1K`)
 
 **Example:**
 ```
-Generate an image of a sunset over mountains with a lake in the foreground
+Generate a 16:9 landscape image of a sunset over mountains with a lake in the foreground
 ```
 
 **Output:**
@@ -66,10 +68,24 @@ Check the remaining quota for the Gemini 3 Pro Image model.
 ## Image Details
 
 - **Model**: Gemini 3 Pro Image
-- **Resolution**: 1408x768 pixels
-- **Format**: JPEG (typically 600KB - 1MB)
+- **Resolutions**: 
+  - `1K`: 1024x1024 (default)
+  - `2K`: 2048x2048
+  - `4K`: 4096x4096
+- **Aspect ratios**: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`
+- **Format**: JPEG (always, regardless of filename extension)
 - **Generation time**: 10-30 seconds
 
+## Unsupported Parameters
+
+The following parameters are documented in Google's API but are **not supported** by the Gemini 3 Pro Image model (they are Imagen-specific):
+
+- `personGeneration` - Control generation of people in images
+- `outputMimeType` - Output format selection (always returns JPEG)
+- `compressionQuality` - JPEG compression control
+
+These parameters may work with Imagen models but have no effect with Gemini 3 Pro Image.
+
 ## Quota
 
 Image generation uses a separate quota from text models. The quota resets every 5 hours. Use the `image_quota` tool to check your remaining quota.
@@ -102,8 +118,8 @@ The plugin uses Google's CloudCode API with fallback endpoints:
 
 ## Related Plugins
 
-- [opencode-antigravity-auth](https://www.npmjs.com/package/opencode-antigravity-auth) - Authentication (required)
-- [opencode-antigravity-quota](https://www.npmjs.com/package/opencode-antigravity-quota) - Text model quota checking
+- [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth) - Authentication (required)
+- [opencode-antigravity-web](https://github.com/ominiverdi/opencode-antigravity-web) - Web search and URL reading
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-antigravity-img",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "OpenCode plugin for Gemini image generation via Antigravity/CloudCode API",
   "main": "src/index.ts",
   "type": "module",

package/src/api.ts

@@ -15,6 +15,7 @@ import type {
   CloudCodeQuotaResponse,
   GenerateContentResponse,
   ImageGenerationResult,
+  ImageGenerationOptions,
   QuotaInfo,
 } from "./types";
 
@@ -149,12 +150,34 @@ export async function getImageModelQuota(account: Account): Promise<QuotaInfo |
   }
 }
 
+/**
+ * Build imageConfig from options
+ */
+function buildImageConfig(options?: ImageGenerationOptions): ImageGenerationOptions | undefined {
+  if (!options) return undefined;
+
+  const { aspectRatio, imageSize } = options;
+
+  // Only include if at least one option is set
+  if (!aspectRatio && !imageSize) {
+    return undefined;
+  }
+
+  const imageConfig: ImageGenerationOptions = {};
+
+  if (aspectRatio) imageConfig.aspectRatio = aspectRatio;
+  if (imageSize) imageConfig.imageSize = imageSize;
+
+  return imageConfig;
+}
+
 /**
  * Generate an image using the Gemini 3 Pro Image model
  */
 export async function generateImage(
   account: Account,
-  prompt: string
+  prompt: string,
+  options?: ImageGenerationOptions
 ): Promise<ImageGenerationResult> {
   try {
     // Get access token
@@ -172,6 +195,7 @@ export async function generateImage(
     }
 
     // Build request
+    const imageConfig = buildImageConfig(options);
     const requestBody = {
       project: projectId,
       requestId: `req_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
@@ -183,6 +207,7 @@ export async function generateImage(
         session_id: `sess_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
         generationConfig: {
           responseModalities: ["TEXT", "IMAGE"],
+          ...(imageConfig && { imageConfig }),
         },
       },
     };

package/src/index.ts

@@ -3,7 +3,7 @@ import * as fs from "fs/promises";
 import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
 import { join, dirname } from "path";
 import { CONFIG_PATHS, COMMAND_DIR, COMMAND_FILE, COMMAND_CONTENT, IMAGE_MODEL } from "./constants";
-import type { AccountsConfig, Account } from "./types";
+import type { AccountsConfig, Account, ImageGenerationOptions, AspectRatio, ImageSize } from "./types";
 import { generateImage, getImageModelQuota } from "./api";
 
 // Create command file for opencode discovery
@@ -72,20 +72,29 @@ export const plugin: Plugin = async (ctx) => {
         description:
           "Generate an image using Gemini 3 Pro Image model. " +
           "Provide a text prompt describing the image you want. " +
+          "IMPORTANT: Output is always JPEG format regardless of filename extension. " +
           "Returns the path to the generated image file.",
         args: {
           prompt: tool.schema.string().describe("Text description of the image to generate"),
           filename: tool.schema
             .string()
             .optional()
-            .describe("Output filename (default: generated_<timestamp>.png)"),
+            .describe("Output filename (default: generated_<timestamp>.jpg). Note: format is always JPEG regardless of extension"),
           output_dir: tool.schema
             .string()
             .optional()
             .describe("Output directory (default: current working directory)"),
+          aspect_ratio: tool.schema
+            .string()
+            .optional()
+            .describe("Aspect ratio: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 (default: 1:1)"),
+          image_size: tool.schema
+            .string()
+            .optional()
+            .describe("Image resolution: 1K, 2K, 4K (default: 1K)"),
         },
         async execute(args, context) {
-          const { prompt, filename, output_dir } = args;
+          const { prompt, filename, output_dir, aspect_ratio, image_size } = args;
 
           if (!prompt?.trim()) {
             return "Error: Please provide a prompt describing the image to generate.";
@@ -105,17 +114,21 @@ export const plugin: Plugin = async (ctx) => {
 
           context.metadata({ title: "Generating image..." });
 
+          // Build generation options
+          const options: ImageGenerationOptions = {};
+          if (aspect_ratio) options.aspectRatio = aspect_ratio as AspectRatio;
+          if (image_size) options.imageSize = image_size as ImageSize;
+
           // Generate image
-          const result = await generateImage(account, prompt);
+          const result = await generateImage(account, prompt, Object.keys(options).length > 0 ? options : undefined);
 
           if (!result.success || !result.imageData) {
             return `Error generating image: ${result.error || "Unknown error"}`;
           }
 
-          // Determine output path
+          // Determine output path (always JPEG regardless of extension)
           const dir = output_dir || ctx.directory;
-          const ext = result.mimeType === "image/png" ? "png" : "jpg";
-          const name = filename || `generated_${Date.now()}.${ext}`;
+          const name = filename || `generated_${Date.now()}.jpg`;
           const outputPath = join(dir, name);
 
           // Ensure directory exists

package/src/types.ts

@@ -37,7 +37,20 @@ export interface ModelInfo {
   };
 }
 
-// Image generation
+// Image generation options
+export type AspectRatio = "1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "4:5" | "5:4" | "9:16" | "16:9" | "21:9";
+export type ImageSize = "1K" | "2K" | "4K";
+
+export interface ImageConfig {
+  aspectRatio?: AspectRatio;
+  imageSize?: ImageSize;
+}
+
+export interface ImageGenerationOptions {
+  aspectRatio?: AspectRatio;
+  imageSize?: ImageSize;
+}
+
 export interface GenerateContentRequest {
   project: string;
   requestId: string;
@@ -52,6 +65,7 @@ export interface GenerateContentRequest {
     session_id: string;
     generationConfig: {
       responseModalities: string[];
+      imageConfig?: ImageConfig;
     };
   };
 }