agent-harness 0.16.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 12fc4554399bc5663e5fcde0747f0ba4f25b92499633fb9e6916f5f205f9f05e
-  data.tar.gz: 2c5f3e1235a2c648c246988d684f9479a2151cbd6fb905e8774581115ce472ef
+  metadata.gz: f3de614caae7f2e65904c6118c209a2e149769e518e4a200c3efb77e8424db93
+  data.tar.gz: 8bd46e4f308b5de943554bd1dc3a4b31ab9180e2d1a2b61fd126840de6ff9029
 SHA512:
-  metadata.gz: e0f815d6b6fb68e0d4b1307d0a4d594022cd814a213afbea4a87db1759c8a00513ec43b95a144698f5a3dca05e91e71474ee239865ad9b8174033c0694e7e838
-  data.tar.gz: dfa7e99ee7c88cc4fce145dcbc431419d61a86dac4f9ebf5e3b6045c92729bb640b7dbbab5d1b597439039f0381d6f12f05de59731e20f282e8245c8dc15e052
+  metadata.gz: 4981d9c872f63e2739f7bda8f182387aac3218f7522e66cdc137aa1d34dfb51516b4e82e3193b8ee4b983c5a19cb68185d7bab5b630ace98a6b9bfad1b2ffb8d
+  data.tar.gz: d84d943eccbc10258eafbd60f53b6aad796cc2f2b9b663addb6c178cc29934ef3ee2d0c92925d627edb4c875c39a912915f0f7f04ed273be451a4a0a314bc047

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.16.0"
+  ".": "0.17.0"
 }

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 ## [Unreleased]
 
+## [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)
+
+
+### Bug Fixes
+
+* **kilocode:** config_file_content generates invalid JSON for kilo CLI v7.1.3 ([#190](https://github.com/viamin/agent-harness/issues/190)) ([0f7e24a](https://github.com/viamin/agent-harness/commit/0f7e24a8c342045d16a9332385e93f0607d0845e))
+
 ## [0.16.0](https://github.com/viamin/agent-harness/compare/agent-harness/v0.15.0...agent-harness/v0.16.0) (2026-05-03)
 
 

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,11 +130,50 @@ module AgentHarness
         }
       end
 
-      def config_file_content(options = {})
+      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
+            }
+          ]
+        )
+
         {
-          provider: options[:api_provider],
-          model: options[:model_id]
-        }.to_json
+          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
+        # a valid Kilo built-in provider ID, so we must not fall back to it here.
+        provider_name = options[:provider_name] || "openai"
+        model_id = options[:model_id]
+
+        config = {provider: {provider_name => {}}}
+        config[:model] = "#{provider_name}/#{model_id}" if model_id
+
+        config.to_json
       end
 
       def error_patterns
@@ -292,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.0"
+  VERSION = "0.17.0"
 end

metadata

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