Remove OpenAI/custom providers

.config/dictionary.txt

@@ -39,6 +39,7 @@ codeclimate
 codespell
 contentmatch
 contentmatches
+contentmatching
 coreutils
 cpython
 dedupe
@@ -62,6 +63,7 @@ libonig
 libssh
 lightspeed
 lineinfile
+llmprovider
 maxlength
 microdnf
 mocharc

.depcheckrc.yml

@@ -6,6 +6,7 @@ ignores:
   - "@types/vscode"  # determined by (package.json).engines.vscode
   - "@vscode/test-electron" # used by @vscode/test-cli
   - "@vscode/vsce"
+  - c8 # used in unit-tests script
   - cypress-multi-reporters
   - depcheck
   - electron

docs/configuration.md

@@ -64,16 +64,49 @@ any level (User, Remote, Workspace and/or Folder).
 
 ## Lightspeed Configuration
 
-- `ansible.lightspeed.enabled`: Enable Ansible Lightspeed.
-- `ansible.lightspeed.URL`: URL for Ansible Lightspeed.
-- `ansible.lightspeed.suggestions.enabled`: Enable Ansible Lightspeed with
-  watsonx Code Assistant inline suggestions.
+### Core Settings
+
+- `ansible.lightspeed.enabled`: Enable/disable Ansible Lightspeed.
+- `ansible.lightspeed.provider`: Select AI provider (`wca`, `google`).
+  - `wca`: Red Hat Ansible Lightspeed with IBM watsonx Code Assistant (default)
+  - `google`: Google Gemini API access
+
+- `ansible.lightspeed.apiEndpoint`: API endpoint URL for the selected provider.
+  - For WCA: `https://c.ai.ansible.redhat.com` (default)
+  - For Google: `https://generativelanguage.googleapis.com/v1beta` (automatically set)
+
+- `ansible.lightspeed.modelName`: Model name/ID to use.
+  - For WCA: Model ID override (optional, for commercial users)
+  - For Google: Model identifier (e.g., `gemini-2.5-flash`)
+
+- `ansible.lightspeed.apiKey`: API key for LLM providers.
+  - Not used for WCA (uses OAuth2 authentication)
+  - Required for `google` provider
+
+- `ansible.lightspeed.timeout`: Request timeout in milliseconds (default: 30000).
+
+### Inline Suggestions
+
+- `ansible.lightspeed.suggestions.enabled`: Enable inline suggestions.
+  - Note: Currently only supported with WCA provider
+
 - `ansible.lightspeed.suggestions.waitWindow`: Delay (in milliseconds) prior to
-  sending an inline suggestion request to Ansible Lightspeed with watsonx Code
-  Assistant.
-- `ansible.lightspeed.modelIdOverride`: Model ID to override your organization's
-  default model. This setting is only applicable to commercial users with an
-  Ansible Lightspeed seat assignment.
+  sending an inline suggestion request.
+
+### Advanced Settings
+
+- `ansible.lightspeed.customHeaders`: Custom HTTP headers for LLM providers (JSON object).
+  - Example: `{"Custom-Header": "value"}`
+  - Not used for WCA
+
+### Backward Compatibility
+
+The following legacy settings are still supported for backward compatibility:
+
+- `ansible.lightspeed.URL`: Mapped to `ansible.lightspeed.apiEndpoint`
+- `ansible.lightspeed.modelIdOverride`: Mapped to `ansible.lightspeed.modelName`
+
+See [LLM Provider Documentation](llm-providers.md) for detailed setup instructions and examples.
 
 ## Completion & Language Server Settings
 

docs/llm-providers.md

@@ -0,0 +1,238 @@
+# LLM Provider Support for Ansible Lightspeed
+
+The Ansible VS Code extension supports multiple LLM providers including Red Hat's Ansible Lightspeed with watsonx Code Assistant (WCA) and Google Gemini for Ansible code generation and assistance.
+
+## Supported Features
+
+When using LLM providers, the following Ansible Lightspeed features are available:
+
+✅ **Supported in Phase 1:**
+
+- Playbook Generation
+- Role Generation
+- Interactive Chat (if provider supports it)
+
+❌ **Not Supported in Phase 1:**
+
+- Inline Task Suggestions
+- Content Source Matching
+
+## Supported Providers
+
+### Google Gemini
+
+Direct access to Google Gemini models.
+
+**Configuration:**
+
+- Provider: `google`
+- API Endpoint: `https://generativelanguage.googleapis.com/v1beta` (⚠️ **fixed, not configurable**)
+- API Key: Your Google AI API key (starts with `AIza`)
+- Model Name: e.g., `gemini-2.5-flash`, `gemini-1.5-pro`
+
+> **Note:** For Google provider, the API endpoint is automatically set and cannot be changed.
+
+## Setup Instructions
+
+### Method 1: Guided Configuration (Recommended)
+
+1. Open the Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`)
+2. Run: `Ansible Lightspeed: Configure LLM Provider`
+3. Select your desired provider from the list (Google or WCA)
+4. Enter the required configuration details when prompted
+5. Test the connection when prompted
+
+### Quick Provider Selection
+
+1. Open VS Code Settings (`Ctrl+,` / `Cmd+,`)
+2. Search for "Ansible Lightspeed Provider"
+3. Select from the dropdown: `WCA` or `Google`
+4. Configure the required settings based on your selection
+
+### Method 2: Manual Configuration
+
+1. Open VS Code Settings (`Ctrl+,` / `Cmd+,`)
+2. Search for "Ansible Lightspeed"
+3. Configure the following settings:
+
+**For Google Gemini:**
+
+```json
+{
+  "ansible.lightspeed.enabled": true,
+  "ansible.lightspeed.provider": "google",
+  // apiEndpoint is automatically set (not configurable)
+  "ansible.lightspeed.apiKey": "your-google-api-key",
+  "ansible.lightspeed.modelName": "gemini-2.5-flash"
+}
+```
+
+**For WCA (default):**
+
+```json
+{
+  "ansible.lightspeed.enabled": true,
+  "ansible.lightspeed.provider": "wca",
+  "ansible.lightspeed.apiEndpoint": "https://c.ai.ansible.redhat.com"
+}
+```
+
+### Method 3: Workspace Configuration
+
+Add to your workspace `.vscode/settings.json`:
+
+```json
+{
+  "ansible.lightspeed.enabled": true,
+  "ansible.lightspeed.provider": "google",
+  // apiEndpoint is automatically set (not configurable)
+  "ansible.lightspeed.apiKey": "${env:GOOGLE_API_KEY}",
+  "ansible.lightspeed.modelName": "gemini-2.5-flash"
+}
+```
+
+## Configuration Settings
+
+| Setting                               | Description                           | Default                              | Applicable To            |
+| ------------------------------------- | ------------------------------------- | ------------------------------------ | ------------------------ |
+| `ansible.lightspeed.enabled`          | Enable/disable Ansible Lightspeed     | `true`                               | All providers            |
+| `ansible.lightspeed.provider`         | Provider selection                    | `wca`                                | All providers            |
+| `ansible.lightspeed.apiEndpoint`      | API endpoint URL                      | `https://c.ai.ansible.redhat.com`    | **WCA only**             |
+| `ansible.lightspeed.modelName`        | Model name/ID to use                  | `""`                                 | All providers            |
+| `ansible.lightspeed.apiKey`           | API key for authentication            | `""`                                 | Google only (not WCA)    |
+| `ansible.lightspeed.timeout`          | Request timeout in milliseconds       | `30000`                              | All providers            |
+| `ansible.lightspeed.customHeaders`    | Custom HTTP headers (JSON object)     | `{}`                                 | Third-party only         |
+
+## Usage
+
+Once configured, LLM providers work seamlessly with existing Ansible Lightspeed features:
+
+### Playbook Generation
+
+1. Right-click in an Ansible file
+2. Select "Generate Ansible Playbook with Lightspeed"
+3. Enter your requirements
+4. The configured LLM provider will generate the playbook
+
+### Role Generation
+
+1. Right-click in an Ansible file
+2. Select "Generate Ansible Role with Lightspeed"
+3. Enter your requirements
+4. The configured LLM provider will generate the role structure
+
+### Interactive Chat
+
+1. Open the Ansible Lightspeed panel
+2. Use the chat interface to ask Ansible-related questions
+3. The LLM provider will provide Ansible-specific assistance
+
+## Provider Management Commands
+
+Access these commands via the Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`):
+
+- `Ansible Lightspeed: Configure LLM Provider` - Guided setup
+- `Ansible Lightspeed: Test Provider Connection` - Verify connectivity
+- `Ansible Lightspeed: Show Provider Status` - View current configuration
+- `Ansible Lightspeed: Switch Provider` - Change between WCA and LLM providers
+
+## Switching Between Providers
+
+You can easily switch between providers using the dropdown:
+
+1. **Open Settings:** `Ctrl+,` / `Cmd+,`
+2. **Search:** "Ansible Lightspeed Provider"
+3. **Select:** Choose from the dropdown (`WCA` or `Google`)
+4. **Configure:** Update `apiKey` and `modelName` as needed for the selected provider
+
+**Or use the Command Palette:**
+
+1. `Ctrl+Shift+P` / `Cmd+Shift+P`
+2. Run: `Ansible Lightspeed: Switch Provider`
+3. Select your desired provider from the list
+
+## Security Considerations
+
+⚠️ **Important Security Notes:**
+
+1. **API Key Storage:** API keys are stored in VS Code settings. Consider using environment variables for sensitive keys.
+
+2. **Data Privacy:** When using LLM providers, your Ansible code and prompts are sent to external services. Review each provider's privacy policy.
+
+3. **Workspace Settings:** For team projects, avoid committing API keys to version control. Use environment variables or user-specific settings.
+
+4. **Network Security:** Ensure your network allows HTTPS connections to the provider endpoints.
+
+## Troubleshooting
+
+### Connection Issues
+
+1. **Test Connection:**
+
+   ```text
+   Command Palette > Ansible Lightspeed: Test Provider Connection
+   ```
+
+2. **Check API Key:** Ensure your API key is valid and has sufficient credits/quota
+
+3. **Verify Endpoint:** Confirm the API endpoint URL is correct
+
+4. **Network Access:** Check firewall/proxy settings
+
+### Common Error Messages
+
+| Error                    | Solution                                            |
+| ------------------------ | --------------------------------------------------- |
+| "Authentication failed"  | Check your API key                                  |
+| "Rate limit exceeded"    | Wait and try again, or check your quota             |
+| "Request timeout"        | Increase timeout setting or check network           |
+| "Model not found"        | Verify the model name is correct for your provider  |
+
+### Debug Information
+
+Enable debug logging by setting:
+
+```json
+{
+  "ansible.lightspeed.debug": true
+}
+```
+
+Check the "Ansible Support" output channel for detailed logs.
+
+## Model Recommendations
+
+### For Code Generation
+
+- **Google:** `gemini-2.5-flash` or `gemini-1.5-pro`
+
+### For Chat/Explanations
+
+- **Google:** `gemini-2.5-flash` (fast and cost-effective)
+
+## Limitations
+
+1. **Phase 1 Limitations:**
+   - No inline task suggestions
+   - No content source matching
+   - Limited to playbook and role generation
+
+2. **Provider-Specific:**
+   - Rate limits vary by provider
+   - Model capabilities differ
+   - Costs vary by usage
+
+3. **Authentication:**
+   - No Red Hat SSO integration
+   - No Ansible Automation Platform subscription validation
+
+## Support
+
+For issues with LLM provider integration:
+
+1. Check this documentation
+2. Test your provider configuration
+3. Review the troubleshooting section
+4. File an issue on the [Ansible VS Code Extension repository](https://github.com/ansible/vscode-ansible/issues)
+
+For provider-specific issues (API keys, billing, model availability), contact your provider's support directly.

mkdocs.yml

@@ -40,6 +40,7 @@ nav:
       - Settings: als/settings.md
       - Changelog: als/changelog.md
   - Configuration: configuration.md
+  - LLM Providers: llm-providers.md
   - Developer Guide:
       - development/index.md
       - development/contributing.md