agent-harness 0.18.1 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54a70f890647d75ff53ab3b965cd3071fdab5fa42ccf1f6aad95387a5e4b1469
-  data.tar.gz: 34dc8a3d3725d4d8d436671818716ef340ddc712412bd86fb73aa55cce5d2dd5
+  metadata.gz: 35805e09786006c623325c10d579dc95c8be7863536ae52b0440332403f108da
+  data.tar.gz: 162638a405a7b1cfadbd5d03396cd898142ecf4fa57a9d811726644c0329e485
 SHA512:
-  metadata.gz: 055d9ef0f856eae6105e54ab76236c8b1fa3b0e24679b0874b1ebdcf74d610d6a005862ab18ce586ce21657bb7e93042558175fc3e8df2b41f5d2aa52cc7ac44
-  data.tar.gz: ee320df58fd1ed97c931ed079068971918890dfed3ca338b835db5ad39b204de053e19e6c100da9dfcfe199fd9271fe91944f25abb0735c34f246ddcdeb0a901
+  metadata.gz: b624b8380ae5d7e0759be8ef02b1affafff2180773172e4cd7d9d715678570d6e04d1090ffad50461c5d9a8500f756191a0c7705df042603d02d359dc45ac8e6
+  data.tar.gz: 8c8de046b361f532a701d5121550fe41ce47b4f9bab3799b5754dfb7db01803a42e3f898782af8dfdf2e7b5d783f9981e42ddd95db7d3ccf3775a70e74272cf6

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.18.1"
+  ".": "0.19.0"
 }

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 ## [Unreleased]
 
+## [0.19.0](https://github.com/viamin/agent-harness/compare/agent-harness/v0.18.2...agent-harness/v0.19.0) (2026-05-29)
+
+
+### Features
+
+* opencode-ai install contract should support postinstall (native binary download) ([b3eed97](https://github.com/viamin/agent-harness/commit/b3eed971b9bc46ce2bb2976b70dfd65b15ae5e9b))
+* **opencode:** add requires_postinstall and postinstall_command to install contract ([d6808fd](https://github.com/viamin/agent-harness/commit/d6808fd62476289b199202b0c20c65fc4966bfcc)), closes [#223](https://github.com/viamin/agent-harness/issues/223)
+
+## [0.18.2](https://github.com/viamin/agent-harness/compare/agent-harness/v0.18.1...agent-harness/v0.18.2) (2026-05-17)
+
+
+### Bug Fixes
+
+* **release:** require conventional PR titles for release-please ([4f0054f](https://github.com/viamin/agent-harness/commit/4f0054f4c9f35251c3185fa8bbf645fcace130b5))
+* **release:** require conventional PR titles for release-please ([fd6633d](https://github.com/viamin/agent-harness/commit/fd6633dff3710ad1575af9bd172f047a93a8f647))
+
 ## [0.18.1](https://github.com/viamin/agent-harness/compare/agent-harness/v0.18.0...agent-harness/v0.18.1) (2026-05-12)
 
 

data/lib/agent_harness/error_taxonomy.rb

@@ -124,7 +124,7 @@ module AgentHarness
           :idle_timeout
         when /rate.?limit|too many requests|\b429\b/i
           :rate_limited
-        when /quota|usage.?limit|billing/i
+        when /quota|usage.?limit|billing|(?:weekly|monthly)(?:\/(?:weekly|monthly))?\s+limit\s+exhausted/i
           :quota_exceeded
         when /auth|unauthorized|forbidden|invalid.*(key|token)|\b401\b|\b403\b/i
           :auth_expired

data/lib/agent_harness/errors.rb

@@ -31,11 +31,12 @@ module AgentHarness
 
   # Rate limiting and circuit breaker errors
   class RateLimitError < Error
-    attr_reader :reset_time, :provider
+    attr_reader :reset_time, :provider, :error_category
 
-    def initialize(message = nil, reset_time: nil, provider: nil, **kwargs)
+    def initialize(message = nil, reset_time: nil, provider: nil, error_category: :rate_limited, **kwargs)
       @reset_time = reset_time
       @provider = provider
+      @error_category = error_category
       super(message, **kwargs)
     end
   end

data/lib/agent_harness/providers/adapter.rb

@@ -22,7 +22,7 @@ module AgentHarness
         source = contract[:source]
         install_command = contract[:install_command]&.dup
 
-        {
+        normalized = {
           provider: provider_name.to_sym,
           source_type: normalize_metadata_source_type(contract[:source_type] || source),
           package_name: metadata_package_name(contract, source),
@@ -35,6 +35,11 @@ module AgentHarness
           install_command: install_command,
           install_command_string: contract[:install_command_string] || install_command&.join(" ")
         }
+
+        normalized[:requires_postinstall] = contract[:requires_postinstall] if contract.key?(:requires_postinstall)
+        normalized[:postinstall_command] = contract[:postinstall_command] if contract.key?(:postinstall_command)
+
+        normalized
       end
 
       def self.normalize_metadata_source_type(source)
@@ -838,9 +843,11 @@ module AgentHarness
           quota: [
             /requires more credits/i,
             /insufficient credits/i,
+            /insufficient balance/i,
             /credit.*exceeded/i,
             /spend limit.*reached/i,
-            /billing.*limit/i
+            /billing.*limit/i,
+            /(?:weekly|monthly)(?:\/(?:weekly|monthly))?\s+limit\s+exhausted/i
           ]
         }
       end
@@ -1130,7 +1137,7 @@ module AgentHarness
       rescue AuthenticationError => e
         failure_smoke_test_result(e.message, :auth_expired)
       rescue RateLimitError => e
-        failure_smoke_test_result(e.message, :rate_limited)
+        failure_smoke_test_result(e.message, e.error_category || :rate_limited)
       rescue ProviderError => e
         failure_smoke_test_result(e.message, classify_smoke_test_message(e.message))
       end

data/lib/agent_harness/providers/base.rb

@@ -26,6 +26,7 @@ module AgentHarness
     class Base
       include Adapter
       include Extensions::DeepDupable
+      include RateLimitResetParsing
 
       DEFAULT_SMOKE_TEST_CONTRACT = {
         prompt: "Reply with exactly OK.",
@@ -52,7 +53,8 @@ module AgentHarness
         quota_exceeded: [
           /quota.*exceeded/i,
           /insufficient.*quota/i,
-          /billing/i
+          /billing/i,
+          /(?:weekly|monthly)(?:\/(?:weekly|monthly))?\s+limit\s+exhausted/i
         ],
         transient: [
           /timeout/i,
@@ -432,10 +434,6 @@ module AgentHarness
       #
       # @param text [String, nil] error output text
       # @return [Time, nil] UTC reset time, or nil if not parseable
-      def parse_rate_limit_reset(text)
-        nil
-      end
-
       # Run a lightweight provider-owned preflight check before committing to a
       # full prompt execution.
       #
@@ -1038,8 +1036,13 @@ module AgentHarness
 
       def map_to_error_class(classification, original_error)
         case classification
-        when :rate_limited
-          RateLimitError.new(original_error.message, original_error: original_error)
+        when :rate_limited, :quota_exceeded
+          RateLimitError.new(
+            original_error.message,
+            reset_time: parse_rate_limit_reset(original_error.message),
+            error_category: classification,
+            original_error: original_error
+          )
         when :auth_expired
           AuthenticationError.new(
             original_error.message,

data/lib/agent_harness/providers/kilocode.rb

@@ -189,7 +189,7 @@ module AgentHarness
           non_interactive_flag: nil,
           legitimate_exit_codes: [0],
           stderr_is_diagnostic: true,
-          parses_rate_limit_reset: false
+          parses_rate_limit_reset: true
         }
       end
 

data/lib/agent_harness/providers/opencode.rb

@@ -14,6 +14,7 @@ module AgentHarness
       SUPPORTED_CLI_REQUIREMENT = Gem::Requirement.new(">= #{SUPPORTED_CLI_VERSION}", "< 1.4.0").freeze
       INSTALL_COMMAND_PREFIX = ["npm", "install", "-g", "--ignore-scripts"].freeze
       SUPPORTED_CLI_VERSIONS = [SUPPORTED_CLI_VERSION].freeze
+      POSTINSTALL_COMMAND = "node $(npm root -g)/opencode-ai/postinstall.mjs"
       VERSION_REQUIREMENT_STRINGS = SUPPORTED_CLI_REQUIREMENT.requirements
         .map { |op, ver| "#{op} #{ver}".freeze }
         .freeze
@@ -89,6 +90,8 @@ module AgentHarness
             binary_name: binary_name,
             install_command_prefix: INSTALL_COMMAND_PREFIX,
             install_command: install_command,
+            requires_postinstall: true,
+            postinstall_command: POSTINSTALL_COMMAND,
             supported_versions: SUPPORTED_CLI_VERSIONS
           }
 
@@ -194,7 +197,7 @@ module AgentHarness
           non_interactive_flag: nil,
           legitimate_exit_codes: [0],
           stderr_is_diagnostic: true,
-          parses_rate_limit_reset: false
+          parses_rate_limit_reset: true
         }
       end
 

data/lib/agent_harness/providers/rate_limit_reset_parsing.rb

@@ -24,6 +24,7 @@ module AgentHarness
 
         parse_retry_after(text) ||
           parse_reset_at(text) ||
+          parse_reset_at_datetime(text) ||
           parse_resets_time(text) ||
           parse_resets_date_time(text)
       end
@@ -46,6 +47,16 @@ module AgentHarness
         Time.at(match[1].to_i).utc
       end
 
+      # "reset at 2026-05-18 11:22:32"
+      def parse_reset_at_datetime(text)
+        match = text.match(/reset\s+at\s+(\d{4}-\d{2}-\d{2})\s+(\d{2}:\d{2}:\d{2})/i)
+        return unless match
+
+        Time.strptime("#{match[1]} #{match[2]} UTC", "%Y-%m-%d %H:%M:%S %Z").utc
+      rescue ArgumentError
+        nil
+      end
+
       # "resets 5am (UTC)" / "resets 5:00am (UTC)"
       def parse_resets_time(text)
         match = text.match(/resets\s+(\d{1,2})(?::(\d{2}))?\s*(am|pm)\s*\(UTC\)/i)

data/lib/agent_harness/version.rb

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

data/lib/agent_harness.rb

@@ -372,9 +372,9 @@ require_relative "agent_harness/provider_health_check"
 # Provider layer
 require_relative "agent_harness/providers/registry"
 require_relative "agent_harness/providers/adapter"
-require_relative "agent_harness/providers/base"
 require_relative "agent_harness/providers/token_usage_parsing"
 require_relative "agent_harness/providers/rate_limit_reset_parsing"
+require_relative "agent_harness/providers/base"
 require_relative "agent_harness/providers/mcp_config_file_support"
 require_relative "agent_harness/providers/anthropic"
 require_relative "agent_harness/providers/aider"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: agent-harness
 version: !ruby/object:Gem::Version
-  version: 0.18.1
+  version: 0.19.0
 platform: ruby
 authors:
 - Bart Agapinan
@@ -169,7 +169,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Unified interface for CLI-based AI coding agents
 test_files: []