agent-harness 0.5.2 → 0.5.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f3ca48a731020ba5b0668cee27ca19c8d7ca8e9cfc907d0f9b4f42d77b56b7a8
-  data.tar.gz: 69b9c2ce746b4aa1a594479a7295a6510468e1f0d428a02896c218c711889b91
+  metadata.gz: 3dfde368468f5c0c037ec1cb2fefd705e813d192e3723fd70126757cd851cf14
+  data.tar.gz: f68f11de99ea61807ab1bb7a94a28aca4aa37e3346469b195a77019f6ceeceec
 SHA512:
-  metadata.gz: cb329e3f9d7e441d692a7a88ce7ed8c1637f0b314875ae355d5c4c088275fbc77e0726e979069a905c458d05599ea6f90b94434e8a2edcacee7eeb6878b32afc
-  data.tar.gz: 3b56558191606eb4431b6d9253a4dec6ada80a605af3af7422bd7db2163f1ce61b1b0b4c55c1b2f6dab4e046aa1504afbb717a172491e76f3f6f7d114b97c9f8
+  metadata.gz: 4cf0d1807fee47eb2ef1aecc63ab8c10ce71a681d6c98ca2cb860ae7eb9ba7b1a8d88e4382e9ff1f5f2f25acd9380a6cf4c3d8e61f5cf008d920b4d2bbf7b4bc
+  data.tar.gz: cd6ac3ae08acf302369a28cdda0a3e332994f679ad37258c0f4dd869f99f18396ccb1cb52d9a6d5bcbb3c6ac3c776ba87a5338edb8280b46785edce254eb8258

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.5.2"
+  ".": "0.5.3"
 }

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## [Unreleased]
 
+## [0.5.3](https://github.com/viamin/agent-harness/compare/agent-harness/v0.5.2...agent-harness/v0.5.3) (2026-03-27)
+
+
+### Bug Fixes
+
+* 41: Add provider-specific health/auth checks for Gemini and Codex ([#42](https://github.com/viamin/agent-harness/issues/42)) ([be95135](https://github.com/viamin/agent-harness/commit/be9513534e55aa3df9c0885b6e3580a3b146eb93))
+
 ## [0.5.2](https://github.com/viamin/agent-harness/compare/agent-harness/v0.5.1...agent-harness/v0.5.2) (2026-03-24)
 
 

data/lib/agent_harness/providers/codex.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "json"
+
 module AgentHarness
   module Providers
     # OpenAI Codex CLI provider
@@ -78,11 +80,104 @@ module AgentHarness
         ["--session", session_id]
       end
 
+      def error_patterns
+        {
+          rate_limited: [
+            /rate.?limit/i,
+            /too.?many.?requests/i,
+            /429/
+          ],
+          auth_expired: [
+            /invalid.*api.*key/i,
+            /unauthorized/i,
+            /authentication/i,
+            /401/,
+            /incorrect.*api.*key/i
+          ],
+          quota_exceeded: [
+            /quota.*exceeded/i,
+            /insufficient.*quota/i,
+            /billing/i
+          ],
+          transient: [
+            /timeout/i,
+            /connection.*reset/i,
+            /service.*unavailable/i,
+            /503/,
+            /502/
+          ]
+        }
+      end
+
+      def auth_status
+        api_key = ENV["OPENAI_API_KEY"]
+        if api_key && !api_key.strip.empty?
+          if api_key.strip.start_with?("sk-")
+            return {valid: true, expires_at: nil, error: nil, auth_method: :api_key}
+          else
+            return {valid: false, expires_at: nil, error: "OPENAI_API_KEY is set but does not appear to be a valid OpenAI API key"}
+          end
+        end
+
+        credentials = read_codex_credentials
+        if credentials
+          key = credentials["api_key"] || credentials["apiKey"] || credentials["OPENAI_API_KEY"]
+          if key.is_a?(String) && !key.strip.empty?
+            if key.strip.start_with?("sk-")
+              return {valid: true, expires_at: nil, error: nil, auth_method: :config_file}
+            else
+              return {valid: false, expires_at: nil, error: "Config file API key is set but does not appear to be a valid OpenAI API key"}
+            end
+          end
+        end
+
+        {valid: false, expires_at: nil, error: "No OpenAI API key found. Set OPENAI_API_KEY or configure in #{codex_config_path}"}
+      rescue IOError, JSON::ParserError => e
+        {valid: false, expires_at: nil, error: e.message}
+      end
+
+      def health_status
+        unless self.class.available?
+          return {healthy: false, message: "Codex CLI not found in PATH. Install from https://github.com/openai/codex"}
+        end
+
+        auth = auth_status
+        unless auth[:valid]
+          return {healthy: false, message: auth[:error]}
+        end
+
+        {healthy: true, message: "Codex CLI available and authenticated"}
+      end
+
+      def validate_config
+        errors = []
+
+        flags = @config.default_flags
+        unless flags.nil?
+          if flags.is_a?(Array)
+            invalid = flags.reject { |f| f.is_a?(String) }
+            errors << "default_flags contains non-string values" if invalid.any?
+          else
+            errors << "default_flags must be an array of strings"
+          end
+        end
+
+        {valid: errors.empty?, errors: errors}
+      end
+
       protected
 
       def build_command(prompt, options)
         cmd = [self.class.binary_name, "exec"]
 
+        flags = @config.default_flags
+        if flags
+          unless flags.is_a?(Array)
+            raise ArgumentError, "Codex configuration error: default_flags must be an array of strings"
+          end
+          cmd += flags if flags.any?
+        end
+
         if options[:session]
           cmd += session_flags(options[:session])
         end
@@ -95,6 +190,29 @@ module AgentHarness
       def default_timeout
         300
       end
+
+      private
+
+      def read_codex_credentials
+        path = codex_config_path
+        return nil unless File.exist?(path)
+
+        parsed = JSON.parse(File.read(path))
+        return nil unless parsed.is_a?(Hash)
+
+        parsed
+      rescue Errno::ENOENT
+        nil
+      rescue Errno::EACCES => e
+        raise IOError, "Permission denied reading Codex config at #{path}: #{e.message}"
+      rescue JSON::ParserError
+        raise JSON::ParserError, "Invalid JSON in Codex config at #{path}"
+      end
+
+      def codex_config_path
+        config_dir = ENV["CODEX_CONFIG_DIR"] || File.expand_path("~/.codex")
+        File.join(config_dir, "config.json")
+      end
     end
   end
 end

data/lib/agent_harness/providers/gemini.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require "json"
+require "time"
+
 module AgentHarness
   module Providers
     # Google Gemini CLI provider
@@ -106,7 +109,11 @@ module AgentHarness
           auth_expired: [
             /authentication/i,
             /unauthorized/i,
-            /invalid.?credentials/i
+            /invalid.?credentials/i,
+            /login.*required/i,
+            /not.*logged.*in/i,
+            /credentials.*expired/i,
+            /account.*not.*verified/i
           ],
           transient: [
             /timeout/i,
@@ -116,6 +123,68 @@ module AgentHarness
         }
       end
 
+      def auth_status
+        api_key = [ENV["GEMINI_API_KEY"], ENV["GOOGLE_API_KEY"]].find { |key| key && !key.strip.empty? }
+        if api_key
+          return {valid: true, expires_at: nil, error: nil, auth_method: :api_key}
+        end
+
+        credentials = read_gemini_credentials
+        return {valid: false, expires_at: nil, error: "No Gemini credentials found. Run 'gemini auth login' or set GEMINI_API_KEY or GOOGLE_API_KEY"} unless credentials
+
+        token = credentials["access_token"] || credentials["oauth_token"]
+        unless token.is_a?(String) && !token.strip.empty?
+          return {valid: false, expires_at: nil, error: "No authentication token in Gemini credentials"}
+        end
+
+        expires_at = parse_gemini_expiry(credentials)
+        if expires_at && expires_at < Time.now
+          {valid: false, expires_at: expires_at, error: "Gemini session expired. Run 'gemini auth login' to re-authenticate"}
+        else
+          {valid: true, expires_at: expires_at, error: nil, auth_method: :oauth}
+        end
+      rescue IOError, JSON::ParserError => e
+        {valid: false, expires_at: nil, error: e.message}
+      end
+
+      def health_status
+        unless self.class.available?
+          return {healthy: false, message: "Gemini CLI not found in PATH. Install from https://github.com/google-gemini/gemini-cli"}
+        end
+
+        auth = auth_status
+        unless auth[:valid]
+          return {healthy: false, message: auth[:error]}
+        end
+
+        {healthy: true, message: "Gemini CLI available and authenticated"}
+      end
+
+      def validate_config
+        errors = []
+
+        model = @config.model
+        if !model.nil? && !model.is_a?(String)
+          errors << "model must be a string"
+        elsif model.is_a?(String) && !model.empty?
+          unless self.class.supports_model_family?(model)
+            errors << "Unrecognized model '#{model}'. Expected a Gemini model (e.g., gemini-2.0-flash, gemini-2.5-pro)"
+          end
+        end
+
+        flags = @config.default_flags
+        unless flags.nil?
+          if flags.is_a?(Array)
+            invalid = flags.reject { |f| f.is_a?(String) }
+            errors << "default_flags contains non-string values" if invalid.any?
+          else
+            errors << "default_flags must be an array of strings"
+          end
+        end
+
+        {valid: errors.empty?, errors: errors}
+      end
+
       protected
 
       def build_command(prompt, options)
@@ -125,7 +194,13 @@ module AgentHarness
           cmd += ["--model", @config.model]
         end
 
-        cmd += @config.default_flags if @config.default_flags&.any?
+        flags = @config.default_flags
+        if flags
+          unless flags.is_a?(Array)
+            raise ArgumentError, "Gemini configuration error: default_flags must be an array of strings"
+          end
+          cmd += flags if flags.any?
+        end
 
         cmd += ["--prompt", prompt]
 
@@ -135,6 +210,45 @@ module AgentHarness
       def default_timeout
         300
       end
+
+      private
+
+      def read_gemini_credentials
+        path = gemini_credentials_path
+        return nil unless File.exist?(path)
+
+        parsed = JSON.parse(File.read(path))
+        return nil unless parsed.is_a?(Hash)
+
+        parsed
+      rescue Errno::ENOENT
+        nil
+      rescue Errno::EACCES => e
+        raise IOError, "Permission denied reading Gemini credentials at #{path}: #{e.message}"
+      rescue JSON::ParserError
+        raise JSON::ParserError, "Invalid JSON in Gemini credentials at #{path}"
+      end
+
+      def gemini_credentials_path
+        config_dir = ENV["GEMINI_CONFIG_DIR"] || File.expand_path("~/.gemini")
+        File.join(config_dir, "credentials.json")
+      end
+
+      def parse_gemini_expiry(credentials)
+        value = credentials["expires_at"] || credentials["expiresAt"] || credentials["expiry"]
+        return nil unless value
+
+        case value
+        when Time
+          value
+        when Integer, Float
+          Time.at(value)
+        when String
+          Time.parse(value)
+        end
+      rescue ArgumentError
+        nil
+      end
     end
   end
 end

data/lib/agent_harness/providers/mistral_vibe.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module AgentHarness
+  module Providers
+    # Mistral Vibe CLI provider
+    #
+    # Provides integration with the Mistral Vibe CLI agent tool.
+    class MistralVibe < Base
+      class << self
+        def provider_name
+          :mistral_vibe
+        end
+
+        def binary_name
+          "mistral-vibe"
+        end
+
+        def available?
+          executor = AgentHarness.configuration.command_executor
+          !!executor.which(binary_name)
+        end
+
+        def firewall_requirements
+          {
+            domains: [
+              "api.mistral.ai"
+            ],
+            ip_ranges: []
+          }
+        end
+
+        def instruction_file_paths
+          []
+        end
+
+        def discover_models
+          return [] unless available?
+          []
+        end
+      end
+
+      def name
+        "mistral_vibe"
+      end
+
+      def display_name
+        "Mistral Vibe CLI"
+      end
+
+      def capabilities
+        {
+          streaming: false,
+          file_upload: false,
+          vision: false,
+          tool_use: false,
+          json_mode: false,
+          mcp: false,
+          dangerous_mode: false
+        }
+      end
+
+      protected
+
+      def build_command(prompt, options)
+        cmd = [self.class.binary_name, "run"]
+        cmd << prompt
+        cmd
+      end
+
+      def default_timeout
+        300
+      end
+    end
+  end
+end

data/lib/agent_harness/providers/registry.rb

@@ -123,6 +123,7 @@ module AgentHarness
         register_if_available(:opencode, "agent_harness/providers/opencode", :Opencode)
         register_if_available(:kilocode, "agent_harness/providers/kilocode", :Kilocode)
         register_if_available(:aider, "agent_harness/providers/aider", :Aider)
+        register_if_available(:mistral_vibe, "agent_harness/providers/mistral_vibe", :MistralVibe)
       end
 
       def register_if_available(name, require_path, class_name, aliases: [])

data/lib/agent_harness/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AgentHarness
-  VERSION = "0.5.2"
+  VERSION = "0.5.3"
 end

data/lib/agent_harness.rb

@@ -157,6 +157,7 @@ require_relative "agent_harness/providers/cursor"
 require_relative "agent_harness/providers/gemini"
 require_relative "agent_harness/providers/github_copilot"
 require_relative "agent_harness/providers/kilocode"
+require_relative "agent_harness/providers/mistral_vibe"
 require_relative "agent_harness/providers/opencode"
 
 # Orchestration layer

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: agent-harness
 version: !ruby/object:Gem::Version
-  version: 0.5.2
+  version: 0.5.3
 platform: ruby
 authors:
 - Bart Agapinan
@@ -100,6 +100,7 @@ files:
 - lib/agent_harness/providers/gemini.rb
 - lib/agent_harness/providers/github_copilot.rb
 - lib/agent_harness/providers/kilocode.rb
+- lib/agent_harness/providers/mistral_vibe.rb
 - lib/agent_harness/providers/opencode.rb
 - lib/agent_harness/providers/registry.rb
 - lib/agent_harness/response.rb