feat: add BYOLLM webviews (#2342)

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Kaushiki Singh <kausingh@redhat.com>
Co-authored-by: PyContriver <siddarthpydev@gmail.com>
Co-authored-by: Siddarth Sharma <149260801+PyContriver@users.noreply.github.com>
Co-authored-by: Anushka Shukla <shuklaanushka2024@gmail.com>
Co-authored-by: tanwigeetika1618 <tengverified@gmail.com>
Co-authored-by: Abhishekism9450 <32683845+Abhishekism9450@users.noreply.github.com>
Co-authored-by: Abhishek Chaudhary <abhishekism9450@gmail.com>
Co-authored-by: tanwigeetika1618 <84617407+tanwigeetika1618@users.noreply.github.com>

Author: 6 people

.config/dictionary.txt

@@ -14,6 +14,7 @@ Infiles
 KUBEDOCK
 Konflux
 LIGHTSPEED
+LLMPROVIDER
 Lightspeed
 Lightspeed's
 Maciążek
@@ -42,6 +43,7 @@ codeclimate
 codespell
 contentmatch
 contentmatches
+contentmatching
 coreutils
 cpython
 dedupe
@@ -68,6 +70,7 @@ libonig
 libssh
 lightspeed
 lineinfile
+llmprovider
 maxlength
 microdnf
 mocharc
@@ -78,6 +81,7 @@ mymodule
 mynamespace
 myorg
 myproject
+myrole
 nocolor
 noheading
 norecursedirs

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`
+
+- `ansible.lightspeed.modelName`: Model name/ID to use.
+  - For WCA: Model ID override (optional, for commercial users)
+  - For LLM providers: Required 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
 

package.json

@@ -209,6 +209,22 @@
       {
         "command": "ansible.mcpServer.disable",
         "title": "Disable Ansible Development Tools MCP Server"
+      },
+      {
+        "command": "ansible.lightspeed.testProviderConnection",
+        "title": "Ansible Lightspeed: Test Provider Connection"
+      },
+      {
+        "command": "ansible.lightspeed.configureLlmProvider",
+        "title": "Ansible Lightspeed: Configure LLM Provider"
+      },
+      {
+        "command": "ansible.lightspeed.showProviderStatus",
+        "title": "Ansible Lightspeed: Show Provider Status"
+      },
+      {
+        "command": "ansible.lightspeed.switchProvider",
+        "title": "Ansible Lightspeed: Switch Provider"
       }
     ],
     "configuration": [
@@ -415,39 +431,73 @@
       },
       {
         "properties": {
+          "ansible.lightspeed.apiEndpoint": {
+            "default": "",
+            "markdownDescription": "API endpoint URL. **Only configurable for WCA provider.** For Google, the endpoint is automatically set and cannot be changed. Default for WCA: https://c.ai.ansible.redhat.com",
+            "order": 4,
+            "scope": "resource",
+            "type": "string"
+          },
+          "ansible.lightspeed.apiKey": {
+            "markdownDescription": "API key for Google provider. Not used for WCA (uses OAuth2 authentication). **Important**: This will be stored in VS Code settings.",
+            "order": 3,
+            "scope": "resource",
+            "type": "string"
+          },
+          "ansible.lightspeed.customHeaders": {
+            "markdownDescription": "Custom HTTP headers for LLM providers (JSON object). Example: {\"Custom-Header\": \"value\"}. Not used for WCA.",
+            "order": 6,
+            "scope": "resource",
+            "type": "object"
+          },
           "ansible.lightspeed.enabled": {
             "default": true,
             "markdownDescription": "Enable Ansible Lightspeed.",
             "order": 0,
             "scope": "resource",
             "type": "boolean"
           },
-          "ansible.lightspeed.modelIdOverride": {
-            "markdownDescription": "Model ID to override your organization's default model. This setting is only applicable to commercial users with an Ansible Lightspeed seat assignment.",
-            "order": 4,
+          "ansible.lightspeed.modelName": {
+            "markdownDescription": "Model name/ID to use. **Optional for Google** (uses smart defaults). For WCA: Model ID to override your organization's default model (commercial users only).",
+            "order": 2,
+            "scope": "resource",
+            "type": "string"
+          },
+          "ansible.lightspeed.provider": {
+            "default": "wca",
+            "enum": [
+              "wca",
+              "google"
+            ],
+            "enumDescriptions": [
+              "Red Hat Ansible Lightspeed with IBM watsonx Code Assistant",
+              "Google Gemini - Direct access to Google Gemini models (use your Google API key)"
+            ],
+            "markdownDescription": "Select the AI provider for Ansible Lightspeed suggestions and generation.",
+            "order": 1,
             "scope": "resource",
             "type": "string"
           },
           "ansible.lightspeed.suggestions.enabled": {
             "default": true,
-            "markdownDescription": "Enable Ansible Lightspeed with watsonx Code Assistant inline suggestions.",
-            "order": 2,
+            "markdownDescription": "Enable inline suggestions. Note: Currently only supported with WCA provider.",
+            "order": 7,
             "scope": "resource",
             "type": "boolean"
           },
           "ansible.lightspeed.suggestions.waitWindow": {
             "default": 0,
-            "markdownDescription": "Delay (in msecs) prior to sending an inline suggestion request to Ansible Lightspeed with watsonx Code Assistant.",
-            "order": 3,
+            "markdownDescription": "Delay (in msecs) prior to sending an inline suggestion request.",
+            "order": 8,
             "scope": "resource",
             "type": "number"
           },
-          "ansible.lightspeed.URL": {
-            "default": "https://c.ai.ansible.redhat.com",
-            "markdownDescription": "URL for Ansible Lightspeed.",
-            "order": 1,
+          "ansible.lightspeed.timeout": {
+            "default": 3000,
+            "markdownDescription": "Request timeout in milliseconds for API calls.",
+            "order": 5,
             "scope": "resource",
-            "type": "string"
+            "type": "number"
           }
         },
         "title": "Ansible Lightspeed"
@@ -742,7 +792,7 @@
         {
           "icon": "$(comment-discussion)",
           "id": "lightspeed-feedback-webview",
-          "name": "Ansible Lightspeed Feedback",
+          "name": "Ansible Lightspeed WCA Provider Feedback",
           "type": "webview",
           "when": "config.ansible.lightspeed.enabled"
         }

src/definitions/constants.ts

@@ -93,7 +93,7 @@ Write one paragraph per Ansible task.
 Markdown title starts with the '#' character.
 Write a title before every paragraph.
 Do not return any YAML or Ansible in the output.
-Give a lot of details regarding the parameters of each Ansible plugin.`;
+Give details regarding the parameters of each Ansible plugin.`;
 
 // Template for playbook generation
 export const ANSIBLE_PLAYBOOK_GENERATION_TEMPLATE = `This is what the playbook should do: {PROMPT}`;