feat: SmartHopper 2.0.0 - Google Gemini Provider, Batch API, Vision Input, and Breaking Changes

.github/ISSUE_TEMPLATE/model-verification.yml

@@ -55,7 +55,7 @@ body:
     id: provider-model
     attributes:
       label: Provider / Model
-      description: Select the provider/model pair. Use type-to-filter to search. Only non-deprecated models are listed. This list is auto-updated from `*ProviderModels.cs`.
+      description: Select the provider/model pair. Only non-deprecated models are listed. This list is auto-updated from registered models in SmartHopper providers.
       options:
         # AUTO-GENERATED-MODEL-OPTIONS-START — updated by tools/Update-ModelVerificationTemplate.ps1
         - Anthropic / claude-sonnet-4-6
@@ -66,6 +66,29 @@ body:
         - Anthropic / claude-sonnet-4-5-20250929
         - DeepSeek / deepseek-v4-flash
         - DeepSeek / deepseek-v4-pro
+        - Gemini / lyria-3-clip-preview
+        - Gemini / lyria-3-pro-preview
+        - Gemini / gemma-4-26b-a4b-it
+        - Gemini / gemma-4-31b-it
+        - Gemini / gemini-3.1-flash-lite-preview
+        - Gemini / gemini-3.1-flash-image-preview
+        - Gemini / gemini-3.1-pro-preview
+        - Gemini / gemini-3.1-pro-preview-customtools
+        - Gemini / gemini-3-flash-preview
+        - Gemini / gemini-3-pro-image-preview
+        - Gemini / gemini-2.5-flash-image
+        - Gemini / gemini-2.5-flash-lite-preview-09-2025
+        - Gemini / gemini-2.5-flash-lite
+        - Gemini / gemini-2.5-flash
+        - Gemini / gemini-2.5-pro
+        - Gemini / gemma-3n-e2b-it
+        - Gemini / gemma-3n-e4b-it
+        - Gemini / gemini-2.5-pro-preview
+        - Gemini / gemini-2.5-pro-preview-05-06
+        - Gemini / gemma-3-4b-it
+        - Gemini / gemma-3-12b-it
+        - Gemini / gemma-3-27b-it
+        - Gemini / gemma-2-27b-it
         - MistralAI / mistral-small-2603
         - MistralAI / mistral-medium-3-5
         - MistralAI / ministral-3b-2512

.github/actions/ai/fetch-models/action.yml

@@ -15,7 +15,7 @@ description: 'Fetch model metadata from OpenRouter and update *ProviderModels.cs
 
 inputs:
   provider:
-    description: 'Provider identifier (e.g. OpenAI, MistralAI, Anthropic, OpenRouter, DeepSeek)'
+    description: 'Provider identifier (e.g. OpenAI, MistralAI, Anthropic, OpenRouter, DeepSeek, Gemini)'
     required: true
   api-key:
     description: 'OpenRouter API key (used as the single source of truth for all providers)'

.github/actions/documentation/generate-release-notes/action.yml

@@ -118,7 +118,7 @@ runs:
         ## Technical Requirements
         - Rhino 8.24 or above is required
         - Windows 10/11 or macOS
-        - Valid API keys for MistralAI, OpenAI, DeepSeek, Anthropic or OpenRouter
+        - Valid API keys for MistralAI, OpenAI, DeepSeek, Anthropic, OpenRouter or Gemini
 
         ## Important Notes
         ${STAGE_LINE}

.github/actions/milestone/assign-pr/action.yml

@@ -21,10 +21,19 @@ inputs:
     required: false
     default: 'true'
 
+outputs:
+  milestone-number:
+    description: 'The assigned milestone number'
+    value: ${{ steps.create-or-get.outputs.milestone-number }}
+  milestone-title:
+    description: 'The assigned milestone title'
+    value: ${{ steps.create-or-get.outputs.milestone-title }}
+
 runs:
   using: 'composite'
   steps:
-    - name: Read version and assign to milestone
+    - name: Read version from Solution.props
+      id: read-version
       uses: actions/github-script@v7
       with:
         github-token: ${{ inputs.token }}
@@ -76,86 +85,45 @@ runs:
           processedVersion = processedVersion.replace('-dev', '-alpha');
 
           console.log('Processed version for milestone:', processedVersion);
-
-          // Find milestone with matching title — paginate to walk through ALL
-          // milestones (default page size is 30, and the repo has more than that).
-          const milestones = await github.paginate(github.rest.issues.listMilestones, {
-            owner: context.repo.owner,
-            repo: context.repo.repo,
-            state: 'all', // Include both open and closed milestones
-            per_page: 100
-          });
-
-          let targetMilestone = milestones.find(milestone => milestone.title === processedVersion);
-
-          if (!targetMilestone) {
-            console.log(`No milestone found with title: ${processedVersion}`);
-            console.log('Available milestones:', milestones.map(m => m.title));
-
-            // Create the milestone if it doesn't exist
-            console.log(`Creating new milestone: ${processedVersion}`);
-            try {
-              const { data: newMilestone } = await github.rest.issues.createMilestone({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                title: processedVersion,
-                description: `Milestone for version ${processedVersion}`,
-                state: 'open'
-              });
-
-              targetMilestone = newMilestone;
-              console.log(`Successfully created milestone: ${targetMilestone.title}`);
-
-            } catch (error) {
-              // GitHub returns 422 with error code "already_exists" when a milestone
-              // with the same title already exists. This can happen if pagination
-              // missed it or another job created it concurrently — recover by
-              // re-listing and picking up the existing one instead of failing.
-              const msg = error.message || '';
-              if (error.status === 422 && /already[_ ]exists/.test(msg)) {
-                console.log(`ℹ️ Milestone ${processedVersion} already exists — re-listing to find it`);
-                const refreshed = await github.paginate(github.rest.issues.listMilestones, {
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  state: 'all',
-                  per_page: 100
-                });
-                targetMilestone = refreshed.find(m => m.title === processedVersion);
-                if (!targetMilestone) {
-                  core.setFailed(`Milestone ${processedVersion} reported as already_exists but could not be found after re-listing.`);
-                  return;
-                }
-                console.log(`Found existing milestone after re-list: ${targetMilestone.title} (${targetMilestone.state})`);
-              } else {
-                console.error('Error creating milestone:', error);
-                core.setFailed(`Failed to create milestone: ${error.message}`);
-                return;
-              }
-            }
-          } else {
-            console.log(`Found existing milestone: ${targetMilestone.title} (${targetMilestone.state})`);
-          }
-
-          // Assign PR to milestone
+          core.setOutput('milestone-title', processedVersion);
+
+    - name: Create or get milestone
+      id: create-or-get
+      if: steps.read-version.outputs.milestone-title != ''
+      uses: ./.github/actions/milestone/create-or-get
+      with:
+        title: ${{ steps.read-version.outputs.milestone-title }}
+        description: 'Milestone for version ${{ steps.read-version.outputs.milestone-title }}'
+        state: 'open'
+        token: ${{ inputs.token }}
+
+    - name: Assign PR to milestone
+      if: steps.create-or-get.outputs.milestone-number != ''
+      uses: actions/github-script@v7
+      with:
+        github-token: ${{ inputs.token }}
+        script: |
           const prNumber = parseInt('${{ inputs.pr-number }}', 10);
+          const milestoneNumber = parseInt('${{ steps.create-or-get.outputs.milestone-number }}', 10);
+          const milestoneTitle = '${{ steps.create-or-get.outputs.milestone-title }}';
 
           try {
             await github.rest.issues.update({
               owner: context.repo.owner,
               repo: context.repo.repo,
               issue_number: prNumber,
-              milestone: targetMilestone.number
+              milestone: milestoneNumber
             });
 
-            console.log(`Successfully assigned PR #${prNumber} to milestone "${targetMilestone.title}"`);
+            console.log(`Successfully assigned PR #${prNumber} to milestone "${milestoneTitle}"`);
 
             // Add a comment to the PR if requested
             if ('${{ inputs.comment-on-pr }}' === 'true') {
               await github.rest.issues.createComment({
                 owner: context.repo.owner,
                 repo: context.repo.repo,
                 issue_number: prNumber,
-                body: `🏷️ This PR has been automatically assigned to milestone **${targetMilestone.title}** based on the version in \`Solution.props\`.`
+                body: `🏷️ This PR has been automatically assigned to milestone **${milestoneTitle}** based on the version in \`Solution.props\`.`
               });
             }
 

.github/actions/milestone/create-or-get/action.yml

@@ -0,0 +1,103 @@
+name: 'Create or Get Milestone'
+description: 'Creates a milestone if it does not exist, or returns the existing one. Handles already_exists errors gracefully.'
+
+inputs:
+  title:
+    description: 'Milestone title to create or find'
+    required: true
+  description:
+    description: 'Milestone description (only used when creating new)'
+    required: false
+    default: ''
+  state:
+    description: 'Milestone state (open/closed), only used when creating new'
+    required: false
+    default: 'open'
+  token:
+    description: 'GitHub token with issues:write permission'
+    required: true
+
+outputs:
+  milestone-number:
+    description: 'The milestone number (for API usage)'
+    value: ${{ steps.create-or-get.outputs.milestone-number }}
+  milestone-title:
+    description: 'The milestone title'
+    value: ${{ steps.create-or-get.outputs.milestone-title }}
+  created:
+    description: 'Whether the milestone was newly created (true) or already existed (false)'
+    value: ${{ steps.create-or-get.outputs.created }}
+
+runs:
+  using: composite
+  steps:
+    - name: Create or get milestone
+      id: create-or-get
+      uses: actions/github-script@v7
+      with:
+        github-token: ${{ inputs.token }}
+        script: |
+          const title = '${{ inputs.title }}';
+          const description = '${{ inputs.description }}' || `Milestone for ${title}`;
+          const state = '${{ inputs.state }}';
+
+          // List milestones to check if it exists
+          const { data: milestones } = await github.rest.issues.listMilestones({
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            state: 'all',
+            per_page: 100
+          });
+
+          let milestone = milestones.find(m => m.title === title);
+
+          if (milestone) {
+            console.log(`Found existing milestone: ${milestone.title} (#${milestone.number})`);
+            core.setOutput('milestone-number', milestone.number);
+            core.setOutput('milestone-title', milestone.title);
+            core.setOutput('created', 'false');
+            return;
+          }
+
+          // Try to create the milestone
+          try {
+            const { data: newMilestone } = await github.rest.issues.createMilestone({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              title: title,
+              description: description,
+              state: state
+            });
+
+            console.log(`Created new milestone: ${newMilestone.title} (#${newMilestone.number})`);
+            core.setOutput('milestone-number', newMilestone.number);
+            core.setOutput('milestone-title', newMilestone.title);
+            core.setOutput('created', 'true');
+
+          } catch (error) {
+            // Handle case where milestone was created by another concurrent process
+            if (error.status === 422 && error.message && error.message.includes('already_exists')) {
+              console.log(`Milestone "${title}" already exists (concurrent creation). Fetching...`);
+
+              // Re-fetch to get the existing milestone
+              const { data: allMilestones } = await github.rest.issues.listMilestones({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                state: 'all',
+                per_page: 100
+              });
+
+              milestone = allMilestones.find(m => m.title === title);
+
+              if (milestone) {
+                console.log(`Found existing milestone: ${milestone.title} (#${milestone.number})`);
+                core.setOutput('milestone-number', milestone.number);
+                core.setOutput('milestone-title', milestone.title);
+                core.setOutput('created', 'false');
+              } else {
+                core.setFailed(`Milestone exists but could not be found: ${error.message}`);
+              }
+            } else {
+              core.setFailed(`Failed to create milestone: ${error.message}`);
+            }
+          }

.github/issue-labeler.yml

@@ -11,6 +11,8 @@
   - '(?i)\bDeepSeek\b'
 "provider: OpenRouter":
   - '(?i)\bOpenRouter\b'
+"provider: Gemini":
+  - '(?i)\bGemini\b'
 
 "os: Windows":
   - '(?i)\bWindows\b'

.github/labeler.yml

@@ -22,6 +22,10 @@
   - changed-files:
       - any-glob-to-any-file: 'src/SmartHopper.Providers.OpenRouter/**'
 
+"provider: Gemini":
+  - changed-files:
+      - any-glob-to-any-file: 'src/SmartHopper.Providers.Gemini/**'
+
 # --- Scope labels ---
 "scope: UI":
   - changed-files:
@@ -68,6 +72,5 @@ ci:
 documentation:
   - changed-files:
       - any-glob-to-any-file:
-          - '**/*.md'
           - 'docs/**'
           - '.github/ISSUE_TEMPLATE/**'

.github/labels.yml

@@ -153,6 +153,9 @@
 - name: "provider: Anthropic"
   color: "000"
   description: "Issues related to the Anthropic provider"
+- name: "provider: Gemini"
+  color: "000"
+  description: "Issues related to the Gemini provider"
 
 # Scope Labels
 - name: "scope: Settings"

.github/workflows/chore-update-contributors.yml

@@ -20,6 +20,8 @@ on:
     branches:
       - main
       - dev
+      - 'main-*'
+      - 'dev-*'
       - 'release/**'
       - 'hotfix/**'
 
@@ -45,8 +47,8 @@ jobs:
 
       - name: Configure Git
         run: |
-          git config --local user.email "action@github.com"
-          git config --local user.name "GitHub Action"
+          git config --local user.email "${{ vars.SMARTHOPPER_BOT_EMAIL }}"
+          git config --local user.name "${{ vars.SMARTHOPPER_BOT_NAME }}"
 
       - name: Get target branch and setup
         run: |