agent-harness 0.44.27 → 0.44.28

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65731aa602233c1e57ab11cc5b24ad52e617731750274ee15c1d85714df74e04
-  data.tar.gz: 3ef357ecd646eb9d6615ccea8c9985b73f22e09da09b4280cdb3e7762af50223
+  metadata.gz: e80d5408a298ecc69d9bb926850bbf11affb491c0df7cbc466196c26efbbc719
+  data.tar.gz: 28268cff5cf59d3aea8c38f5eca82231b531bcdf41b289e9d14ff5720ad2fbc8
 SHA512:
-  metadata.gz: 5a290801063d8ae6967038514604ceb0ef5adb95a260d9a000b9c8ad1e5153e91635a4e2b1943da4fd44ea8dbcfd36497ad0cd404f8a798316af3086637ef714
-  data.tar.gz: 9eb3e6f68e2b91d868bdf9809025c1efcf8d13c5bae113978118a9657d61053840a47f6d09f47997d0700f8ad739f78110964f937c5e1b531e673d149307a46e
+  metadata.gz: f77240dc395e73f9eef1e052d027ee4207720e709ef378b419637c929d2ae0d3eb26004e7b440a8d6638ab8243febe43439416b1182eb1db861bc96e121e902d
+  data.tar.gz: cd98f25ef91e81e9636f7e70e2cdf3fe884085fde1781dc60e6593c99078e74fc6dd41aaa9f9972c99c7ab3b9f0a83f1847c6f57a8961dcc6c1b6ba09cad9bdc

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.44.27"
+  ".": "0.44.28"
 }

data/CHANGELOG.md

@@ -12,6 +12,13 @@
 
 * close the RDR-072 upstream epic from #437's retained-scope evidence while keeping unpublished capabilities and downstream adoption behind their explicit release and integration gates ([#430](https://github.com/viamin/agent-harness/issues/430)).
 
+## [0.44.28](https://github.com/viamin/agent-harness/compare/agent-harness/v0.44.27...agent-harness/v0.44.28) (2026-10-28)
+
+
+### Bug Fixes
+
+* **opencode:** surface MiniMax Token Plan HTTP 429 during preflight ([#518](https://github.com/viamin/agent-harness/issues/518)) ([d6f6288](https://github.com/viamin/agent-harness/commit/d6f6288f239cba6ac241edf87987bec22300a7b4))
+
 ## [0.44.27](https://github.com/viamin/agent-harness/compare/agent-harness/v0.44.26...agent-harness/v0.44.27) (2026-10-25)
 
 

data/README.md

@@ -834,7 +834,13 @@ results.each do |r|
 end
 
 # Check a single provider
-result = AgentHarness.check_provider(:claude)
+minimax_runtime = AgentHarness::ProviderRuntime.new(
+  api_provider: "minimax",
+  model: "MiniMax-M3",
+  base_url: ENV.fetch("MINIMAX_BASE_URL"),
+  env: {"MINIMAX_API_KEY" => ENV.fetch("MINIMAX_API_KEY")}
+)
+result = AgentHarness.check_provider(:opencode, provider_runtime: minimax_runtime)
 puts result[:status]  # => "ok", "degraded", or "error"
 
 # Formatted CLI output
@@ -847,8 +853,11 @@ Each result is a hash with keys:
 - `:status` — `"ok"` (all checks passed), `"degraded"` (partial issues such as unimplemented auth status), or `"error"` (provider unavailable or authentication failed)
 - `:message` — human-readable description
 - `:latency_ms` — time taken for the check in milliseconds
+- `:error_category` — structured failure category such as `:rate_limit`, `:authentication`, or `:timeout`
+- `:check` — the check that produced the result, such as `:preflight` or `:smoke_test`
+- `:reset_at` — provider-supplied rate-limit reset time when one is available; otherwise omitted
 
-Health checks run five steps per provider: registration, CLI availability, authentication, provider health status, and configuration validation. The default timeout per provider is configurable via `orchestration.health_check.timeout` (default: 5 seconds).
+Health checks cover registration, CLI availability, authentication, provider health, configuration, provider-owned preflight, and a bounded smoke test. For direct MiniMax OpenCode runtimes, preflight makes one no-retry provider request so an upstream HTTP 429 is returned as `error_category: :rate_limit` before OpenCode's smoke timeout. The default timeout per provider is configurable via `orchestration.health_check.timeout` (default: 5 seconds).
 
 ## Development
 

data/lib/agent_harness/api/chat_transport.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "securerandom"
+require "time"
 require "ruby_llm"
 require_relative "attempt_report"
 require_relative "provider_error_detail"
@@ -499,7 +500,12 @@ module AgentHarness
         headers = error.response.respond_to?(:headers) ? error.response.headers : error.response[:response_headers]
         value = headers&.find { |key, _| key.to_s.casecmp?("retry-after") }&.last
         delay = Float(value, exception: false)
-        delay if delay&.finite? && delay >= 0
+        return delay if delay&.finite? && delay >= 0
+
+        delay = Time.httpdate(value.to_s) - Time.now
+        [delay, 0].max
+      rescue ArgumentError, TypeError
+        nil
       end
       private_class_method :retry_after_seconds
 

data/lib/agent_harness/provider_health_check.rb

@@ -281,7 +281,12 @@ module AgentHarness
         # when only the host cannot reach the endpoint.
         if provider_preflight_allowed
           preflight_env = build_preflight_env(provider_instance, provider_runtime)
-          preflight = provider_instance.preflight_check(env: preflight_env, timeout: timeout)
+          preflight = run_provider_preflight(
+            provider_instance,
+            env: preflight_env,
+            timeout: timeout,
+            provider_runtime: provider_runtime
+          )
           unless preflight[:healthy]
             return build_result(
               name: provider_name,
@@ -289,7 +294,8 @@ module AgentHarness
               message: preflight[:reason] || "Preflight check failed",
               start_time: start_time,
               error_category: normalize_preflight_error_category(preflight[:error_category]),
-              check: :preflight
+              check: :preflight,
+              reset_at: preflight[:reset_at]
             )
           end
         end
@@ -485,6 +491,16 @@ module AgentHarness
         effective_executor.is_a?(CommandExecutor) && !effective_executor.is_a?(DockerCommandExecutor)
       end
 
+      def run_provider_preflight(provider, env:, timeout:, provider_runtime:)
+        parameters = provider.method(:preflight_check).parameters
+        accepts_runtime = parameters.any? do |type, name|
+          type == :keyrest || (%i[key keyreq].include?(type) && name == :provider_runtime)
+        end
+        options = {env: env, timeout: timeout}
+        options[:provider_runtime] = provider_runtime if accepts_runtime
+        provider.preflight_check(**options)
+      end
+
       def runtime_sensitive_host_overrides?(runtime)
         runtime && (!runtime.env.empty? || !runtime.unset_env.empty? || runtime.base_url || runtime.api_provider)
       end

data/lib/agent_harness/providers/opencode.rb

@@ -165,6 +165,11 @@ module AgentHarness
           .freeze
       }.freeze
 
+      def initialize(preflight_transport: Api::ChatTransport.new, **options)
+        super(**options)
+        @preflight_transport = preflight_transport
+      end
+
       def name
         "opencode"
       end
@@ -243,6 +248,21 @@ module AgentHarness
         }
       end
 
+      # OpenCode can silently retry MiniMax subscription limits until the CLI
+      # smoke timeout. Probe the same direct upstream once so callers receive a
+      # structured provider state without parsing CLI output.
+      def preflight_check(env:, timeout: 10, provider_runtime: nil)
+        runtime = ProviderRuntime.wrap(provider_runtime)
+        return {healthy: true} unless minimax_preflight?(runtime)
+
+        result = @preflight_transport.call(minimax_preflight_request(runtime, env, timeout))
+        return {healthy: true} if result[:status] == :succeeded
+
+        minimax_preflight_failure(result[:error])
+      rescue ArgumentError => e
+        {healthy: false, reason: e.message, error_category: :configuration}
+      end
+
       protected
 
       def build_command(prompt, options)
@@ -290,6 +310,58 @@ module AgentHarness
 
       private
 
+      def minimax_preflight?(runtime)
+        runtime && runtime.api_provider.to_s.casecmp?("minimax")
+      end
+
+      def minimax_preflight_request(runtime, env, timeout)
+        {
+          request_id: "opencode-minimax-preflight",
+          operation: :chat,
+          candidates: [minimax_candidate(runtime, env)],
+          messages: [{role: :user, content: [{type: :text, text: "Reply with exactly OK."}]}],
+          tools: [],
+          max_output_tokens: 8,
+          timeout: {read_seconds: timeout},
+          retry: {max_attempts: 1}
+        }
+      end
+
+      def minimax_candidate(runtime, env)
+        endpoint = runtime.chat_base_url || runtime.base_url
+        model = runtime.chat_model || runtime.model
+        api_key = runtime.chat_api_key || env["MINIMAX_API_KEY"] || env["ANTHROPIC_API_KEY"]
+        raise ArgumentError, "MiniMax preflight requires an API endpoint" if endpoint.to_s.empty?
+        raise ArgumentError, "MiniMax preflight requires a model" if model.to_s.empty?
+        raise ArgumentError, "MiniMax preflight requires an API credential" if api_key.to_s.empty?
+
+        {
+          provider: :anthropic, protocol: :messages, authentication_mode: :api_key,
+          model: model, endpoint: endpoint, credentials: {api_key: api_key}
+        }
+      end
+
+      def minimax_preflight_failure(error)
+        return minimax_rate_limit_failure(error) if error&.dig(:code)&.to_sym == :rate_limited
+
+        {
+          healthy: false,
+          reason: "MiniMax preflight request failed",
+          error_category: error&.dig(:category) || :transient
+        }
+      end
+
+      def minimax_rate_limit_failure(error)
+        result = {
+          healthy: false,
+          reason: "MiniMax Token Plan rate limit reached",
+          error_category: :rate_limited
+        }
+        retry_after = error[:retry_after_seconds]
+        result[:reset_at] = Time.now.utc + retry_after if retry_after
+        result
+      end
+
       def opencode_config_payload(runtime)
         metadata = runtime.metadata
         config_extras = metadata[:config] || metadata["config"] || {}

data/lib/agent_harness/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: agent-harness
 version: !ruby/object:Gem::Version
-  version: 0.44.27
+  version: 0.44.28
 platform: ruby
 authors:
 - Bart Agapinan