agent-harness 0.21.0 → 0.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c94304f4eef10eed2b3a21cd345ff55a6aceb28c4cb86a4415b293ed29f7c7f2
-  data.tar.gz: 1bc568febc4ef6a45d4e9271eb50554e2a49662f2fc0c4ad3a2db876a8eeedbe
+  metadata.gz: 1e913f16d4377e9cc016dc2cee6018201358532fe61af764a5d860ef94e67711
+  data.tar.gz: 2b3ab503acfc2cc7493b33f8dfb7d5969e01e9980b0eb08181c2eb420b7dcecb
 SHA512:
-  metadata.gz: f9b375833a4541a9c364385432a9b3f7d279d0c09258696773ba6a3d333a871bdb10299f8d0e5a17989fdd787f786f7eb2477c589cc4dd72bd48df456ee6231e
-  data.tar.gz: d1cd7d45cf20094fa551d1dcc4e988c01e9e11daa9d0c00806fc4ec19e56ea9c06189d6fdf1214a98ec92a2dae23fcad538e5a31ca22d3e154c275bf7bedf3de
+  metadata.gz: ae9b5863d6d7edb3036abdb9217996f66479cf3fec35473aa16443879b11d096ccc9869920264ecf39255245c65fc062c5bcfd671e153ae679d50c7ebe4e85d1
+  data.tar.gz: 157f5c0ebad4cc73a7a1d8224506de837a0b84ef5a66d4c8795131340eb6e2a40ca6f5f8a9293c1a4fa7625bbeda9cad52e38f294ec74633ccbfb6e2ce1274b6

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.21.0"
+  ".": "0.22.0"
 }

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## [Unreleased]
 
+## [0.22.0](https://github.com/viamin/agent-harness/compare/agent-harness/v0.21.0...agent-harness/v0.22.0) (2026-06-10)
+
+
+### Features
+
+* automated dependency updates for installable agents with cooldown period ([#239](https://github.com/viamin/agent-harness/issues/239)) ([0682cc0](https://github.com/viamin/agent-harness/commit/0682cc0d40264f5b5431fc0a7ab0c0d76416ec64))
+
 ## [0.21.0](https://github.com/viamin/agent-harness/compare/agent-harness/v0.20.1...agent-harness/v0.21.0) (2026-06-09)
 
 

data/lib/agent_harness/dependency_updater.rb

@@ -0,0 +1,130 @@
+# frozen_string_literal: true
+
+module AgentHarness
+  class DependencyUpdater
+    DEFAULT_COOLDOWN_SECONDS = 3 * 24 * 60 * 60
+
+    attr_reader :release_registry, :cooldown_period
+
+    def initialize(cooldown_period: DEFAULT_COOLDOWN_SECONDS, release_registry: nil)
+      @cooldown_period = validate_cooldown(cooldown_period)
+      @per_provider_cooldown = {}
+      @release_registry = release_registry || ReleaseRegistry.new
+    end
+
+    def cooldown_period=(value)
+      @cooldown_period = validate_cooldown(value)
+    end
+
+    def set_cooldown(provider_name, period)
+      provider_name = provider_name.to_sym
+      @per_provider_cooldown[provider_name] = validate_cooldown(period)
+    end
+
+    def clear_cooldown(provider_name)
+      @per_provider_cooldown.delete(provider_name.to_sym)
+    end
+
+    def cooldown_for(provider_name)
+      @per_provider_cooldown[provider_name.to_sym] || @cooldown_period
+    end
+
+    def register_release(provider_name, version, released_at: Time.now)
+      @release_registry.register(provider_name, version, released_at: released_at)
+    end
+
+    def resolve_latest_version(provider_name, bypass_cooldown: false, now: Time.now)
+      provider_name = provider_name.to_sym
+      available = @release_registry.versions_for(provider_name)
+      return nil if available.nil? || available.empty?
+
+      if bypass_cooldown
+        return newest_version(available)
+      end
+
+      cooldown = cooldown_for(provider_name)
+      eligible = available.select do |entry|
+        entry[:released_at].nil? || (now - entry[:released_at]) >= cooldown
+      end
+
+      return nil if eligible.empty?
+
+      newest_version(eligible)
+    end
+
+    def eligible?(provider_name, version, bypass_cooldown: false, now: Time.now)
+      return true if bypass_cooldown
+
+      provider_name = provider_name.to_sym
+      version = version.to_s
+
+      released_at = @release_registry.released_at(provider_name, version)
+      return true if released_at.nil?
+
+      cooldown = cooldown_for(provider_name)
+      (now - released_at) >= cooldown
+    end
+
+    def resolve_latest_installation_contract(provider_name, bypass_cooldown: false, now: Time.now)
+      provider_name = provider_name.to_sym
+      version_info = resolve_latest_version(provider_name, bypass_cooldown: bypass_cooldown, now: now)
+      return nil unless version_info
+
+      version = version_info[:version]
+      begin
+        contract = Providers::Registry.instance.installation_contract(provider_name, version: version)
+        {
+          provider: provider_name,
+          version: version,
+          released_at: version_info[:released_at],
+          installation_contract: contract
+        }
+      rescue ConfigurationError
+        {
+          provider: provider_name,
+          version: version,
+          released_at: version_info[:released_at],
+          installation_contract: nil
+        }
+      end
+    end
+
+    def resolve_all_latest(bypass_cooldown: false, now: Time.now)
+      @release_registry.providers.each_with_object({}) do |provider_name, results|
+        version_info = resolve_latest_version(provider_name, bypass_cooldown: bypass_cooldown, now: now)
+        results[provider_name] = version_info if version_info
+      end
+    end
+
+    private
+
+    def validate_cooldown(value)
+      numeric = case value
+      when Integer
+        value
+      when Float
+        value
+      when Numeric
+        value
+      else
+        raise ArgumentError, "cooldown period must be a positive number of seconds, got #{value.inspect}"
+      end
+
+      raise ArgumentError, "cooldown period must be positive, got #{numeric}" unless numeric > 0
+
+      numeric
+    end
+
+    def newest_version(entries)
+      entries.max_by do |entry|
+        parse_version(entry[:version])
+      end
+    end
+
+    def parse_version(version_string)
+      Gem::Version.new(version_string)
+    rescue ArgumentError
+      Gem::Version.new("0")
+    end
+  end
+end

data/lib/agent_harness/release_registry.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module AgentHarness
+  class ReleaseRegistry
+    attr_reader :releases
+
+    def initialize
+      @releases = {}
+    end
+
+    def register(provider_name, version, released_at: Time.now)
+      provider_name = provider_name.to_sym
+      version = version.to_s
+
+      raise ArgumentError, "version must be a non-empty string" if version.empty?
+      raise ArgumentError, "released_at must be a Time" unless released_at.is_a?(Time)
+
+      @releases[provider_name] ||= []
+      entry = {version: version, released_at: released_at}
+      existing = @releases[provider_name].find { |e| e[:version] == version }
+      if existing
+        existing[:released_at] = released_at
+      else
+        @releases[provider_name] << entry
+      end
+
+      entry
+    end
+
+    def versions_for(provider_name)
+      provider_name = provider_name.to_sym
+      return nil unless @releases.key?(provider_name)
+
+      @releases[provider_name].dup
+    end
+
+    def released_at(provider_name, version)
+      provider_name = provider_name.to_sym
+      version = version.to_s
+
+      entries = @releases[provider_name]
+      return nil unless entries
+
+      entry = entries.find { |e| e[:version] == version }
+      entry&.fetch(:released_at, nil)
+    end
+
+    def registered?(provider_name, version)
+      provider_name = provider_name.to_sym
+      version = version.to_s
+
+      entries = @releases[provider_name]
+      return false unless entries
+
+      entries.any? { |e| e[:version] == version }
+    end
+
+    def providers
+      @releases.keys
+    end
+
+    def clear
+      @releases.clear
+    end
+
+    def clear_provider(provider_name)
+      @releases.delete(provider_name.to_sym)
+    end
+
+    def merge!(other_registry)
+      other_registry.releases.each do |provider_name, entries|
+        @releases[provider_name] ||= []
+        entries.each do |entry|
+          existing = @releases[provider_name].find { |e| e[:version] == entry[:version] }
+          if existing
+            existing[:released_at] = entry[:released_at]
+          else
+            @releases[provider_name] << entry.dup
+          end
+        end
+      end
+
+      self
+    end
+  end
+end

data/lib/agent_harness/version.rb

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

data/lib/agent_harness.rb

@@ -47,6 +47,7 @@ module AgentHarness
       @configuration = nil
       @conductor = nil
       @token_tracker = nil
+      @dependency_updater = nil
       Skills.reset! if defined?(Skills)
     end
 
@@ -341,6 +342,30 @@ module AgentHarness
       options[:provider_runtime] = provider_runtime unless provider_runtime.nil?
       ProviderHealthCheck.check(provider_name, **options)
     end
+
+    # Returns the global dependency updater for managing agent tool versions.
+    #
+    # The dependency updater applies a configurable cooldown period before
+    # adopting new upstream releases, reducing exposure to regressions.
+    #
+    # @return [DependencyUpdater] the dependency updater instance
+    def dependency_updater
+      @dependency_updater ||= DependencyUpdater.new
+    end
+
+    # Resolve the latest eligible version for an installable provider tool,
+    # applying the configured cooldown period.
+    #
+    # @param provider_name [Symbol, String] the provider name
+    # @param bypass_cooldown [Boolean] when true, skip the cooldown check
+    # @return [Hash, nil] version info with :provider, :version, :released_at,
+    #   :installation_contract keys, or nil when no eligible version exists
+    def resolve_latest_version(provider_name, bypass_cooldown: false)
+      dependency_updater.resolve_latest_installation_contract(
+        provider_name,
+        bypass_cooldown: bypass_cooldown
+      )
+    end
   end
 end
 
@@ -368,6 +393,8 @@ require_relative "agent_harness/openai_compatible_transport"
 require_relative "agent_harness/conversation"
 require_relative "agent_harness/authentication"
 require_relative "agent_harness/provider_health_check"
+require_relative "agent_harness/release_registry"
+require_relative "agent_harness/dependency_updater"
 
 # Provider layer
 require_relative "agent_harness/providers/registry"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: agent-harness
 version: !ruby/object:Gem::Version
-  version: 0.21.0
+  version: 0.22.0
 platform: ruby
 authors:
 - Bart Agapinan
@@ -104,6 +104,7 @@ files:
 - lib/agent_harness/command_executor.rb
 - lib/agent_harness/configuration.rb
 - lib/agent_harness/conversation.rb
+- lib/agent_harness/dependency_updater.rb
 - lib/agent_harness/docker_command_executor.rb
 - lib/agent_harness/error_taxonomy.rb
 - lib/agent_harness/errors.rb
@@ -137,6 +138,7 @@ files:
 - lib/agent_harness/providers/rate_limit_reset_parsing.rb
 - lib/agent_harness/providers/registry.rb
 - lib/agent_harness/providers/token_usage_parsing.rb
+- lib/agent_harness/release_registry.rb
 - lib/agent_harness/response.rb
 - lib/agent_harness/skill.rb
 - lib/agent_harness/skills.rb