agent-harness 0.16.1 → 0.17.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1c7a73c78312193fa3d7a73f3fa32aa032f9a5c8748dd0a679b2f05abc0853fe
-  data.tar.gz: ca7ed61365d3df1aaa8c3b48ee0100804e7ff49ad08f4da73cc07ce444934b79
+  metadata.gz: 68dcb8a37c35c6ded8f4d01e0f0d6d14e1588ac41a88f2b613fa2fbab9decc79
+  data.tar.gz: 6317ce0f0ef2aaadf13dfa39b6897d67a4b453bbb7b7b09db348366d33b8d993
 SHA512:
-  metadata.gz: 7bbd40a153f7565617f151d2dea5d7bdded0314b3d144971947ab92699dde8c0851a83ab15eed45f0a4eb34faf30a75274de88434963420b28a68263db1c77fd
-  data.tar.gz: c97a38b9bdb74397b18a9c37f641e3469be3e0fa9532a8728e2f5a8517b2c14bacd5b4b65441fda0c28f2397ab21f83ead4ceaa0aa17585c02c32b5a22d5d8f8
+  metadata.gz: 59989e7197cf596e87ae4ffb87f252419d72f3c9c119de4f210fc4a41c7b3777187a69f1745e65f7a1cefb0010b87f316cd375c673de56e906e4b223364dac44
+  data.tar.gz: a691c948ee1fb9f3f6777b3624863b42024ecf85c84b5b320a0e258cf4f7467db7832e703048cee42272cd3e946c020321873788d48de225acaf00eaa8bee757

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.16.1"
+  ".": "0.17.1"
 }

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 ## [Unreleased]
 
+## [0.17.1](https://github.com/viamin/agent-harness/compare/agent-harness/v0.17.0...agent-harness/v0.17.1) (2026-05-05)
+
+
+### Bug Fixes
+
+* 173: Smoke test contract timeout (30s) overrides caller timeout, breaking slow models ([#205](https://github.com/viamin/agent-harness/issues/205)) ([3a1e301](https://github.com/viamin/agent-harness/commit/3a1e301e36ef8957fd440f2782b3b8e4687b473c))
+
+## [0.17.0](https://github.com/viamin/agent-harness/compare/agent-harness/v0.16.1...agent-harness/v0.17.0) (2026-05-03)
+
+
+### Features
+
+* **extensions:** add activity heartbeat support for OpenCode/KiloCode-compatible providers ([#201](https://github.com/viamin/agent-harness/issues/201)) ([4914f6d](https://github.com/viamin/agent-harness/commit/4914f6d7971c55600f268b6886b967b753b25c96))
+
 ## [0.16.1](https://github.com/viamin/agent-harness/compare/agent-harness/v0.16.0...agent-harness/v0.16.1) (2026-05-03)
 
 

data/lib/agent_harness/provider_health_check.rb

@@ -324,7 +324,18 @@ module AgentHarness
         # contract[:timeout]. When the provider overrides #smoke_test without
         # publishing a contract, forward the validated health-check timeout so
         # the override can honour it instead of running without any limit.
-        smoke_timeout = smoke_contract ? nil : timeout
+        # However, when the caller explicitly provides a timeout that exceeds
+        # the contract timeout, honour the caller's intent so slow models
+        # are not prematurely killed by the contract default.
+        contract_timeout = smoke_contract&.dig(:timeout)
+        valid_contract_timeout = contract_timeout.is_a?(Numeric) && contract_timeout.positive?
+        smoke_timeout = if valid_contract_timeout && timeout && timeout > contract_timeout
+          timeout
+        elsif smoke_contract
+          nil
+        else
+          timeout
+        end
         smoke = provider_instance.smoke_test(timeout: smoke_timeout, provider_runtime: provider_runtime)
         unless smoke[:ok]
           return build_result(

data/lib/agent_harness/providers/adapter.rb

@@ -1187,6 +1187,39 @@ module AgentHarness
         nil
       end
 
+      # Whether this provider supports activity heartbeat signaling.
+      #
+      # Providers that can emit a container-visible liveness signal during
+      # long-running CLI execution return +true+. Downstream callers use
+      # this to decide whether heartbeat-backed idle timeout is viable
+      # without maintaining provider-name allowlists.
+      #
+      # @return [Boolean] true if the provider can emit heartbeat signals
+      def supports_activity_heartbeat?
+        false
+      end
+
+      # Return structured heartbeat integration wiring for this provider.
+      #
+      # Providers that support activity heartbeat return a Hash describing
+      # how to wire heartbeat file touches into the CLI execution. The
+      # returned contract includes environment variables, execution
+      # preparation (config/plugin file writes), and the heartbeat
+      # granularity so downstream callers can enable heartbeat-backed idle
+      # timeout without hardcoding provider-specific config logic.
+      #
+      # @param heartbeat_file_path [String] absolute path to the heartbeat
+      #   file that should be touched on activity
+      # @return [Hash] heartbeat integration contract:
+      #   - +:supported+ [Boolean] whether heartbeat is available
+      #   - +:env+ [Hash] environment variables to set (empty when unsupported)
+      #   - +:preparation+ [ExecutionPreparation, nil] file writes for config/plugin wiring
+      #   - +:granularity+ [Symbol, nil] heartbeat event granularity
+      #     (+:tool_call+, +:turn+, or +:progress+)
+      def heartbeat_integration(heartbeat_file_path:)
+        {supported: false, env: {}, preparation: nil, granularity: nil}
+      end
+
       private
 
       def classify_smoke_test_message(message)

data/lib/agent_harness/providers/kilocode.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "json"
+require "shellwords"
 
 module AgentHarness
   module Providers
@@ -129,6 +130,39 @@ module AgentHarness
         }
       end
 
+      def supports_activity_heartbeat?
+        true
+      end
+
+      def heartbeat_integration(heartbeat_file_path:)
+        unless heartbeat_file_path.is_a?(String) && !heartbeat_file_path.strip.empty?
+          raise ArgumentError, "heartbeat_file_path must be a non-empty String"
+        end
+        unless heartbeat_file_path.start_with?("/")
+          raise ArgumentError, "heartbeat_file_path must be an absolute path (got #{heartbeat_file_path.inspect})"
+        end
+
+        hook_script = heartbeat_hook_script(heartbeat_file_path)
+        config_payload = merge_heartbeat_hooks(hook_script)
+
+        preparation = ExecutionPreparation.new(
+          file_writes: [
+            {
+              path: heartbeat_hook_config_path,
+              content: JSON.pretty_generate(config_payload),
+              mode: 0o600
+            }
+          ]
+        )
+
+        {
+          supported: true,
+          env: {"KILO_HEARTBEAT_FILE" => heartbeat_file_path},
+          preparation: preparation,
+          granularity: :tool_call
+        }
+      end
+
       def config_file_content(options = {})
         # Only use explicit provider_name or default to "openai".
         # api_provider is a generic backend label (e.g. "openrouter") that is not
@@ -298,6 +332,32 @@ module AgentHarness
 
       private
 
+      def heartbeat_hook_script(heartbeat_file_path)
+        "touch #{Shellwords.escape(heartbeat_file_path)}"
+      end
+
+      def heartbeat_hook_config_path
+        "~/.config/kilocode/hooks.json"
+      end
+
+      def merge_heartbeat_hooks(hook_script)
+        existing = load_existing_hooks_config(heartbeat_hook_config_path)
+        hooks = existing.fetch("hooks", {})
+        on_activity = hooks.fetch("on_activity", [])
+        on_activity = on_activity.dup
+        on_activity << {"command" => hook_script}
+        existing.merge("hooks" => hooks.merge("on_activity" => on_activity))
+      end
+
+      def load_existing_hooks_config(path)
+        expanded = File.expand_path(path)
+        return {} unless File.exist?(expanded)
+
+        JSON.parse(File.read(expanded))
+      rescue JSON::ParserError
+        {}
+      end
+
       def each_json_event(output)
         return if output.nil? || output.empty?
 

data/lib/agent_harness/providers/opencode.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "json"
+require "shellwords"
 
 module AgentHarness
   module Providers
@@ -147,6 +148,39 @@ module AgentHarness
         }
       end
 
+      def supports_activity_heartbeat?
+        true
+      end
+
+      def heartbeat_integration(heartbeat_file_path:)
+        unless heartbeat_file_path.is_a?(String) && !heartbeat_file_path.strip.empty?
+          raise ArgumentError, "heartbeat_file_path must be a non-empty String"
+        end
+        unless heartbeat_file_path.start_with?("/")
+          raise ArgumentError, "heartbeat_file_path must be an absolute path (got #{heartbeat_file_path.inspect})"
+        end
+
+        hook_script = heartbeat_hook_script(heartbeat_file_path)
+        config_payload = merge_heartbeat_hooks(hook_script)
+
+        preparation = ExecutionPreparation.new(
+          file_writes: [
+            {
+              path: heartbeat_hook_config_path,
+              content: serialize_opencode_config(config_payload),
+              mode: 0o600
+            }
+          ]
+        )
+
+        {
+          supported: true,
+          env: {"OPENCODE_HEARTBEAT_FILE" => heartbeat_file_path},
+          preparation: preparation,
+          granularity: :tool_call
+        }
+      end
+
       def error_patterns
         COMMON_ERROR_PATTERNS
       end
@@ -233,6 +267,32 @@ module AgentHarness
         JSON.pretty_generate(payload)
       end
 
+      def heartbeat_hook_script(heartbeat_file_path)
+        "touch #{Shellwords.escape(heartbeat_file_path)}"
+      end
+
+      def heartbeat_hook_config_path
+        "~/.config/opencode/hooks.json"
+      end
+
+      def merge_heartbeat_hooks(hook_script)
+        existing = load_existing_hooks_config(heartbeat_hook_config_path)
+        hooks = existing.fetch("hooks", {})
+        on_activity = hooks.fetch("on_activity", [])
+        on_activity = on_activity.dup
+        on_activity << {"command" => hook_script}
+        existing.merge("hooks" => hooks.merge("on_activity" => on_activity))
+      end
+
+      def load_existing_hooks_config(path)
+        expanded = File.expand_path(path)
+        return {} unless File.exist?(expanded)
+
+        JSON.parse(File.read(expanded))
+      rescue JSON::ParserError
+        {}
+      end
+
       def stringify_keys(hash)
         hash.each_with_object({}) do |(key, value), result|
           result[key.to_s] = value

data/lib/agent_harness/version.rb

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

metadata

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