docs: update model names and descriptions for Roo Code Cloud and xAI providers (#319)

Author: hannesrudolph

docs/providers/roo-code-cloud.md

@@ -1,9 +1,10 @@
 ---
 sidebar_label: Roo Code Cloud
-description: Access the free roo/sonic AI model through Roo Code Cloud. No API keys or payment required during the promotional period.
+description: Access the free grok-code-fast-1 AI model through Roo Code Cloud. No API keys or payment required during the promotional period.
 keywords:
   - roo code cloud
   - roo provider
+  - grok-code-fast-1
   - sonic model
   - free ai model
   - cloud authentication
@@ -13,13 +14,20 @@ image: /img/social-share.jpg
 
 # Roo Code Cloud Provider
 
-Access the free "roo/sonic" model through Roo Code Cloud authentication. No API keys or usage costs during the promotional period.
+Access the free "grok-code-fast-1" model (formerly "roo/sonic") through Roo Code Cloud authentication. No API keys or usage costs during the promotional period.
+
+:::info Model Name Update
+The "roo/sonic" model is being renamed to **"grok-code-fast-1"** (officially "Grok Code Fast"). The model will be updated by **August 29th**. This is the same powerful coding model, just with its official xAI name. The model remains **free** when accessed through Roo Code Cloud during the promotional period.
+
+**Important for Roo Code users:** Within Roo Code, this model is only free through Roo Code Cloud. Using it directly through the [xAI provider](/providers/xai) in Roo Code will incur standard charges once pricing is established.
+:::
 
 :::note
 - Requires Roo Code Cloud account
 - Internet connection required
 - Prompts and completions are logged for model improvement
 - Available during promotional period only
+- Within Roo Code, free access is through Roo Code Cloud provider
 :::
 
 ---
@@ -34,16 +42,23 @@ Access the free "roo/sonic" model through Roo Code Cloud authentication. No API
 2. **Select Provider:**
    - Open Roo Code Settings (<Codicon name="gear" />)
    - Choose "Roo Code Cloud" from the API Provider dropdown
-   - Select the model "Sonic"
+   - Select the model "grok-code-fast-1" (may still show as "Sonic" until August 29th)
 
 ---
 
 ## Model
 
-**roo/sonic**:
+**grok-code-fast-1** (formerly roo/sonic):
+- Official Name: Grok Code Fast
 - Context Window: 262,144 tokens
 - Max Output: 16,384 tokens
 - Image Support: No
+- Optimized for: Coding tasks, checkpoint and deployment
+- **Pricing:** Free during promotional period through Roo Code Cloud
+
+:::tip Why Use Roo Code Cloud?
+Within Roo Code, `grok-code-fast-1` is only **free** when accessed through Roo Code Cloud. Using the [xAI provider](/providers/xai) directly in Roo Code will incur standard rates once pricing is established.
+:::
 
 ---
 

docs/providers/xai.md

@@ -1,5 +1,5 @@
 ---
-description: Configure xAI's Grok models in Roo Code. Access Grok-3, Grok-2, and vision models with large context windows and reasoning capabilities.
+description: Configure xAI's Grok models in Roo Code. Access Grok-4, Grok-3, Grok-2, and vision models with large context windows, reasoning capabilities, and prompt caching.
 keywords:
   - xAI
   - Grok
@@ -8,8 +8,10 @@ keywords:
   - reasoning AI
   - vision models
   - large context
+  - Grok-4
   - Grok-3
   - Grok-2
+  - prompt caching
 image: /img/social-share.jpg
 sidebar_label: xAI (Grok)
 ---
@@ -35,25 +37,19 @@ xAI is the company behind Grok, a large language model known for its conversatio
 
 Roo Code supports the following xAI Grok models:
 
-### Grok-3 Models
-* `grok-3-beta` (Default) - xAI's Grok-3 beta model with 131K context window
-* `grok-3-fast-beta` - xAI's Grok-3 fast beta model with 131K context window
-* `grok-3-mini-beta` - xAI's Grok-3 mini beta model with 131K context window
-* `grok-3-mini-fast-beta` - xAI's Grok-3 mini fast beta model with 131K context window
-
-### Grok-2 Models
-* `grok-2-latest` - xAI's Grok-2 model - latest version with 131K context window
-* `grok-2` - xAI's Grok-2 model with 131K context window
-* `grok-2-1212` - xAI's Grok-2 model (version 1212) with 131K context window
-
-### Grok Vision Models
-* `grok-2-vision-latest` - xAI's Grok-2 Vision model - latest version with image support and 32K context window
-* `grok-2-vision` - xAI's Grok-2 Vision model with image support and 32K context window
+### Current Models
+* `grok-4` (Default) - xAI's Grok-4 model with 256K context window, image support, and prompt caching
+* `grok-code-fast-1` - xAI's Grok Code Fast model with 262K context window, optimized for coding tasks
+* `grok-3` - xAI's Grok-3 model with 128K context window and prompt caching
+* `grok-3-fast` - xAI's Grok-3 fast model with 128K context window and prompt caching
+* `grok-3-mini` - xAI's Grok-3 mini model with 128K context window, reasoning support, and prompt caching
+* `grok-3-mini-fast` - xAI's Grok-3 mini fast model with 128K context window, reasoning support, and prompt caching
+* `grok-2-1212` - xAI's Grok-2 model (version 1212) with 128K context window
 * `grok-2-vision-1212` - xAI's Grok-2 Vision model (version 1212) with image support and 32K context window
-* `grok-vision-beta` - xAI's Grok Vision Beta model with image support and 8K context window
 
-### Legacy Models
-* `grok-beta` - xAI's Grok Beta model (legacy) with 131K context window
+:::info Grok Code Fast - Free Access in Roo Code
+`grok-code-fast-1` is available for **free** through the [Roo Code Cloud provider](/providers/roo-code-cloud) during the promotional period. When using the xAI provider directly in Roo Code, standard pricing will apply once established. This model was previously known as "roo/sonic" and has been renamed. For free access within Roo Code, use the Roo Code Cloud provider instead of the xAI provider.
+:::
 
 ---
 
@@ -73,10 +69,10 @@ Grok 3 Mini models feature specialized reasoning capabilities, allowing them to
 ### Reasoning-Enabled Models
 
 Reasoning is only supported by:
-* `grok-3-mini-beta`
-* `grok-3-mini-fast-beta`
+* `grok-3-mini` - Supports reasoning effort control
+* `grok-3-mini-fast` - Supports reasoning effort control
 
-The Grok 3 models `grok-3-beta` and `grok-3-fast-beta` do not support reasoning.
+The standard Grok 3 models (`grok-3` and `grok-3-fast`) and Grok 4 do not support reasoning effort parameters.
 
 ### Controlling Reasoning Effort
 
@@ -95,9 +91,14 @@ Choose `low` for simple queries that should complete quickly, and `high` for har
 
 ---
 
-## Tips and Notes
+## Prompt Caching
+
+Prompt caching is available for select Grok models including `grok-4`, `grok-3`, `grok-3-fast`, `grok-3-mini`, and `grok-3-mini-fast`. This feature can reduce costs and improve response times.
+
+---
+
+## Pricing
+
+Pricing varies by model. Refer to the [xAI documentation](https://console.x.ai/) for current pricing information.
 
-* **Context Window:** Most Grok models feature large context windows (up to 131K tokens), allowing you to include substantial amounts of code and context in your prompts.
-* **Vision Capabilities:** Select vision-enabled models (`grok-2-vision-latest`, `grok-2-vision`, etc.) when you need to process or analyze images.
-* **Pricing:** Pricing varies by model, with input costs ranging from $0.3 to $5.0 per million tokens and output costs from $0.5 to $25.0 per million tokens. Refer to the xAI documentation for the most current pricing information.
-* **Performance Tradeoffs:** "Fast" variants typically offer quicker response times but may have higher costs, while "mini" variants are more economical but may have reduced capabilities.
+**Note:** `grok-code-fast-1` is available for free through the [Roo Code Cloud provider](/providers/roo-code-cloud) during the promotional period. Standard pricing will apply when using the xAI provider directly in Roo Code.