docs: update image generation documentation and add release notes for v3.26.3 (#326)

Author: hannesrudolph

docs/features/image-generation.md

@@ -1,19 +1,24 @@
 ---
-description: Generate images from text prompts directly in Roo Code using OpenRouter API. Save AI-generated images to your workspace with preview support.
+description: Generate new images from text prompts or edit existing images in Roo Code using OpenRouter API. Transform, enhance, and save AI-processed images to your workspace with preview support.
 keywords:
   - image generation
+  - image editing
   - text to image
+  - image transformation
   - OpenRouter
   - AI images
   - experimental feature
   - image creation
   - prompt to image
+  - watercolor
+  - upscaling
+  - style transfer
 image: /img/social-share.jpg
 ---
 
 # Image Generation
 
-Generate images from plain text prompts, save them to your project, and preview them in the chat. This experimental feature requires an OpenRouter API key.
+Generate new images from text prompts or edit existing images in your workspace. Save results to your project with preview in chat. This experimental feature requires an OpenRouter API key.
 
 :::warning Experimental Feature
 Image Generation is an experimental feature that requires enabling in settings and configuring an OpenRouter API key.
@@ -23,25 +28,32 @@ Image Generation is an experimental feature that requires enabling in settings a
 
 ## Key Features
 
-- Create images directly from chat using natural language
-- Saves to your workspace at a path you choose; file extension is auto-added if missing
-- Shows a preview of the generated image in the conversation
-- Choose an image generation model (via OpenRouter)
+- Create new images from text prompts using natural language
+- Edit and transform existing images in your workspace
+- Saves to your workspace at a path you choose; appropriate extension (.png or .jpg) is auto-added if missing
+- Shows a preview of the generated/edited image in the conversation
+- Currently uses Gemini 2.5 Flash Image Preview models via OpenRouter
 - Simple on/off toggle under Experimental settings
 
 ---
 
-## Use Case
+## Use Cases
 
+### Image Generation
 **Before:** You had to copy prompts to an external site, download the result, then move it into your workspace.
 
 **With this feature:** Ask Roo to generate an image, approve, pick a save location, and continue editing with the image already in your project.
 
+### Image Editing
+**Before:** Export image, upload to external editor, make changes, download, import back to project.
+
+**With this feature:** Ask Roo to transform your existing image directly - it reads the file, applies your edits, and saves the result in your project.
+
 ---
 
 ## How It Works
 
-When enabled, Roo sends your prompt to an image-capable model through OpenRouter. The image returned by OpenRouter is saved to the path you specify inside your current workspace. Roo shows a preview in the chat and the file appears in your file explorer.
+When enabled, Roo sends your prompt (and optionally an existing image) to an image-capable model through OpenRouter. The generated or edited image returned by OpenRouter is saved to the path you specify inside your current workspace. Roo shows a preview in the chat and the file appears in your file explorer.
 
 ---
 
@@ -67,19 +79,39 @@ When enabled, Roo sends your prompt to an image-capable model through OpenRouter
 
 ### 3. Image Generation Model
 - **Purpose:** Selects which model to use for generation
-- **Default:** Gemini 2.5 Flash Image Preview (or the free preview variant)
+- **Default:** Gemini 2.5 Flash Image Preview
+- **Available Models:** Currently limited to Gemini 2.5 Flash Image Preview and its free variant
 
 ---
 
 ## Using Image Generation
 
 1. In chat, ask Roo to generate an image and describe what you want (subject, style, lighting, composition).
 2. Confirm the action when prompted. Roo may ask you to choose a save path (for example: `images/sunset.png`).
-3. Roo generates the image and saves it. If you don't include an extension, one is added automatically (png or jpg).
+3. Roo generates the image and saves it. If you don't include an extension, the appropriate extension (.png or .jpg) is added based on the output format.
 4. See the image preview in the chat and locate the file in your workspace.
 
 ---
 
+## Editing Existing Images
+
+Roo can also transform and edit existing images in your workspace:
+
+1. Ask Roo to edit an image, describing the transformation you want
+2. Specify both the input image path and where to save the result
+3. Roo will apply your requested edits to the existing image
+
+**Supported Input Formats**: PNG, JPG, JPEG, GIF, WEBP
+
+**Example Requests**:
+- "Transform `photos/portrait.jpg` into a watercolor painting and save as `art/watercolor-portrait.png`"
+- "Upscale and enhance `images/logo.png` to higher resolution"
+- "Apply a vintage filter to `screenshots/app.png`"
+
+**Note**: Both the input image path and output path must be accessible (not blocked by `.rooignore`)
+
+---
+
 ## Tips for Better Results
 
 ### Be Specific
@@ -95,8 +127,11 @@ Include these elements in your prompts:
 ## Limitations
 
 - Experimental feature; availability and model list are limited
+- Currently limited to Gemini 2.5 Flash Image Preview models
 - One image is produced per request
 - Output formats supported: PNG or JPG
+- Supported input formats for editing: PNG, JPG, JPEG, GIF, WEBP only
+- Image paths must be accessible (not blocked by `.rooignore` restrictions)
 - Usage may be subject to your OpenRouter plan limits and costs
 
 ---

docs/update-notes/index.md

@@ -19,6 +19,7 @@ image: /img/social-share.jpg
 
 ### Version 3.26
 
+*   [3.26.3](/update-notes/v3.26.3) (2025-08-29)
 *   [3.26.2](/update-notes/v3.26.2) (2025-08-28)
 *   [3.26.1](/update-notes/v3.26.1) (2025-08-27)
 *   [3.26.0](/update-notes/v3.26.0) (2025-08-26)

docs/update-notes/v3.26.3.mdx

@@ -0,0 +1,33 @@
+---
+description: This release adds image editing capabilities to the image generation tool and improves developer experience.
+keywords:
+  - roo code 3.26.3
+  - image editing
+  - image generation
+image: /img/social-share.jpg
+---
+
+# Roo Code 3.26.3 Release Notes (2025-08-29)
+
+This release adds image editing capabilities to the image generation tool and improves developer experience.
+
+## Image Editing with Input Images
+
+We've enhanced the image generation tool with the ability to edit and transform existing images ([#7525](https://github.com/RooCodeInc/Roo-Code/pull/7525)):
+
+- **Transform Existing Images**: Apply artistic styles, convert photos to paintings, or create variations of existing artwork
+- **Style Transfer**: Convert images into watercolor, oil painting, sketch, or other artistic styles
+- **Image Enhancement**: Upscale and enhance existing images to higher resolution while maintaining composition
+- **Creative Editing**: Use text prompts to modify specific aspects of an image while preserving the rest
+
+The tool now accepts an optional `image` parameter for transforming existing images in your workspace. Supported input formats include PNG, JPG, JPEG, GIF, and WEBP.
+
+> **📚 Documentation**: See [Image Generation - Editing Existing Images](/features/image-generation#editing-existing-images) for detailed usage and transformation examples.
+
+## Bug Fixes
+
+* **Image Generation Settings**: Fixed issue where the saved API key would clear when switching modes ([#7536](https://github.com/RooCodeInc/Roo-Code/pull/7536))
+
+## Misc Improvements
+
+* **Test Debugging**: Console logs now visible in tests when using the --no-silent flag (thanks hassoncs!) ([#7467](https://github.com/RooCodeInc/Roo-Code/pull/7467))

docs/update-notes/v3.26.mdx

@@ -69,13 +69,20 @@ We've added Vercel AI Gateway as a complete provider integration (thanks joshual
 
 ### Image Generation (OpenRouter) — Free option: Gemini 2.5 Flash Image Preview
 
-Generate images from natural‑language prompts directly inside Roo Code using OpenRouter’s image generation models. Configure your OpenRouter API key, pick a supported model, and preview results in the built‑in Image Viewer. See [Image Generation](/features/image-generation) and [OpenRouter Provider](/providers/openrouter) for setup and model selection.
+Generate images from natural‑language prompts directly inside Roo Code using OpenRouter's image generation models. Configure your OpenRouter API key, pick a supported model, and preview results in the built‑in Image Viewer. See [Image Generation](/features/image-generation) and [OpenRouter Provider](/providers/openrouter) for setup and model selection.
 
 - **Free option available: Gemini 2.5 Flash Image Preview** — try image generation without paid credits for faster onboarding and quick experiments
 - Prompt‑to‑image workflow inside the editor with approvals flow (supports auto‑approval when write permissions are granted)
 - Image Viewer with zoom, copy, and save for quick reuse in docs and prototypes
+- **NEW in v3.26.3: Image Editing** — Transform and edit existing images in your workspace ([#7525](https://github.com/RooCodeInc/Roo-Code/pull/7525)):
+  - Apply artistic styles like watercolor, oil painting, or sketch
+  - Upscale and enhance images to higher resolution
+  - Modify specific aspects while preserving the rest
+  - Supports PNG, JPG, JPEG, GIF, and WEBP input formats
 
-PRs: [#7474](https://github.com/RooCodeInc/Roo-Code/pull/7474), [#7492](https://github.com/RooCodeInc/Roo-Code/pull/7492), [#7493](https://github.com/RooCodeInc/Roo-Code/pull/7493)
+PRs: [#7474](https://github.com/RooCodeInc/Roo-Code/pull/7474), [#7492](https://github.com/RooCodeInc/Roo-Code/pull/7492), [#7493](https://github.com/RooCodeInc/Roo-Code/pull/7493), [#7525](https://github.com/RooCodeInc/Roo-Code/pull/7525))
+
+> **📚 Documentation**: See [Image Generation - Editing Existing Images](/features/image-generation#editing-existing-images) for transformation examples.
 
 ### Provider Updates
 
@@ -106,6 +113,7 @@ PRs: [#7474](https://github.com/RooCodeInc/Roo-Code/pull/7474), [#7492](https://
 * **Mistral Thinking Content**: Fixed validation errors when using Mistral models that send thinking content (thanks Biotrioo!) ([#7106](https://github.com/RooCodeInc/Roo-Code/pull/7106))
 * **Requesty Model Listing**: Fixed model listing for Requesty provider when using custom base URLs (thanks dtrugman!) ([#7378](https://github.com/RooCodeInc/Roo-Code/pull/7378))
 * **Todo List Setting**: Fixed newTaskRequireTodos setting to properly enforce todo list requirements ([#7363](https://github.com/RooCodeInc/Roo-Code/pull/7363))
+* **Image Generation Settings** (v3.26.3): Fixed issue where the saved API key would clear when switching modes ([#7536](https://github.com/RooCodeInc/Roo-Code/pull/7536))
 * ImageGenerationSettings no longer shows a dirty state on first open; the save button only enables after an actual change. (#[7495](https://github.com/RooCodeInc/Roo-Code/pull/7495))
 * GPT‑5 reliability improvements:
   - Manual condense preserves conversation continuity by correctly handling `previous_response_id` on the next request
@@ -128,9 +136,11 @@ PRs: [#7474](https://github.com/RooCodeInc/Roo-Code/pull/7474), [#7492](https://
 * **Issue Fixer Mode**: Added missing todos parameter in new_task tool usage ([#7391](https://github.com/RooCodeInc/Roo-Code/pull/7391))
 * **Privacy Policy Update**: Updated privacy policy to clarify proxy mode data handling (thanks jdilla1277!) ([#7255](https://github.com/RooCodeInc/Roo-Code/pull/7255))
 * **Dependencies**: Updated drizzle-kit to v0.31.4 ([#5453](https://github.com/RooCodeInc/Roo-Code/pull/5453))
+* **Test Debugging** (v3.26.3): Console logs now visible in tests when using the --no-silent flag (thanks hassoncs!) ([#7467](https://github.com/RooCodeInc/Roo-Code/pull/7467))
 * Release automation: version bumps, changelog updates, and auto-publishing on merge for a faster, more reliable release process. (#[7490](https://github.com/RooCodeInc/Roo-Code/pull/7490))
 * New TaskSpawned developer event so integrations can detect when a subtask is created and capture its ID for chaining or monitoring. (#[7465](https://github.com/RooCodeInc/Roo-Code/pull/7465))
 * Roo Code Cloud SDK bumped to 0.25.0. (#[7475](https://github.com/RooCodeInc/Roo-Code/pull/7475))
 * Release automation: version bumps, changelog updates, and auto-publishing on merge for a faster, more reliable release process. (#[7490](https://github.com/RooCodeInc/Roo-Code/pull/7490))
 * New TaskSpawned developer event so integrations can detect when a subtask is created and capture its ID for chaining or monitoring. (#[7465](https://github.com/RooCodeInc/Roo-Code/pull/7465))
+
 * Roo Code Cloud SDK bumped to 0.25.0. (#[7475](https://github.com/RooCodeInc/Roo-Code/pull/7475))

sidebars.ts

@@ -217,6 +217,7 @@ const sidebars: SidebarsConfig = {
           label: '3.26',
           items: [
             { type: 'doc', id: 'update-notes/v3.26', label: '3.26 Combined' },
+            { type: 'doc', id: 'update-notes/v3.26.3', label: '3.26.3' },
             { type: 'doc', id: 'update-notes/v3.26.2', label: '3.26.2' },
             { type: 'doc', id: 'update-notes/v3.26.1', label: '3.26.1' },
             { type: 'doc', id: 'update-notes/v3.26.0', label: '3.26.0' },