agent-harness 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cb82dfba3d7a36312cfcb32c86b39f88726b558828643361be96a3b69ca1a3ea
-  data.tar.gz: 19d643749ed639f4932f82ebdb8ef92f984cb7a4fc12c8c3d05a201103464d5a
+  metadata.gz: a3f57fefa5527c5cdc436d4da8c10e5f638c69363b32e689213feb9bdccadf7d
+  data.tar.gz: ae98c1fc1f1a919adf7919f8d4dc0dc308286f1cb0e02d4a719d9060e29451b4
 SHA512:
-  metadata.gz: 575d764e422d9b465233ea8ffd0db147165be8cc6f6e70fd19cb549d13677da5054acf8d2ec0632d20a95f22c02d27a9add9c12f137a62133a88ebce0b00a70b
-  data.tar.gz: 87122eb8b3feef772bbd7b8d8fb6a29bd99a18cadd5e260eb74b00a55c489b01e5b0c9d82d93412e270b339ca7fab5ab559999fcd1a9171a2ab7c79325bd688d
+  metadata.gz: eeafca1c0fe7183572056d50caf4e30f28e7a410a5fdb0f2bd3271ae3c0ef5a679f48c559266143a14cd03130de714a6e9af286d7e6e990eb8977fa3972c74df
+  data.tar.gz: c29ad51bcd248190e44d089d28daf6914a319a800536a3dfce25be6ad9b993a1582b6f317bf7df5f0989864c0a6b663cbb76de1921155b2c2f1aad10037bdd9e

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.3.0"
+  ".": "0.4.0"
 }

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.4.0](https://github.com/viamin/agent-harness/compare/agent-harness/v0.3.0...agent-harness/v0.4.0) (2026-02-16)
+
+
+### Features
+
+* add DockerCommandExecutor for container-based command execution ([85826e5](https://github.com/viamin/agent-harness/commit/85826e5ece76d9f073329902769093f846cfd8b7))
+* add DockerCommandExecutor for container-based command execution ([cb18f2e](https://github.com/viamin/agent-harness/commit/cb18f2e2f1d16ef52ea2ce54c51970d73fcae6c8))
+
 ## [0.3.0](https://github.com/viamin/agent-harness/compare/agent-harness-v0.2.2...agent-harness/v0.3.0) (2026-01-26)
 
 

data/lib/agent_harness/command_executor.rb

@@ -87,7 +87,7 @@ module AgentHarness
       !which(binary).nil?
     end
 
-    private
+    protected
 
     def normalize_command(command)
       case command
@@ -100,6 +100,8 @@ module AgentHarness
       end
     end
 
+    private
+
     def execute_with_timeout(cmd_array, timeout:, env:, stdin_data:)
       stdout = ""
       stderr = ""

data/lib/agent_harness/docker_command_executor.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module AgentHarness
+  # Executes commands inside a Docker container
+  #
+  # Wraps commands with `docker exec` so they run inside
+  # the specified container rather than on the host.
+  #
+  # @example Basic usage
+  #   executor = AgentHarness::DockerCommandExecutor.new(container_id: "abc123")
+  #   result = executor.execute(["python", "script.py"])
+  #
+  # @example With environment variables
+  #   result = executor.execute("echo $FOO", env: { "FOO" => "bar" })
+  class DockerCommandExecutor < CommandExecutor
+    attr_reader :container_id
+
+    # Initialize the Docker command executor
+    #
+    # @param container_id [String] the Docker container ID or name
+    # @param logger [Logger, nil] optional logger
+    # @raise [CommandExecutionError] if Docker CLI is not found on the host
+    def initialize(container_id:, logger: nil)
+      raise ArgumentError, "container_id cannot be nil or empty" if container_id.nil? || container_id.empty?
+
+      super(logger: logger)
+      @container_id = container_id
+      validate_docker!
+    end
+
+    # Execute a command inside the Docker container
+    #
+    # Wraps the given command with `docker exec` and delegates
+    # to the parent class for actual process execution.
+    #
+    # @param command [Array<String>, String] command to execute
+    # @param timeout [Integer, nil] timeout in seconds
+    # @param env [Hash] environment variables to set in the container
+    # @param stdin_data [String, nil] data to send to stdin
+    # @return [Result] execution result
+    def execute(command, timeout: nil, env: {}, stdin_data: nil)
+      docker_cmd = build_docker_command(command, env: env, stdin_data: stdin_data)
+      super(docker_cmd, timeout: timeout, env: {}, stdin_data: stdin_data)
+    end
+
+    # Check if a binary exists inside the container
+    #
+    # @param binary [String] binary name
+    # @return [String, nil] full path or nil
+    def which(binary)
+      result = execute(["which", binary], timeout: 5)
+      result.success? ? result.stdout.strip : nil
+    end
+
+    private
+
+    def validate_docker!
+      return if ENV["PATH"]&.split(File::PATH_SEPARATOR)&.any? { |path| File.executable?(File.join(path, "docker")) }
+
+      raise CommandExecutionError, "Docker CLI not found on host PATH"
+    end
+
+    def build_docker_command(command, env:, stdin_data:)
+      cmd = ["docker", "exec"]
+
+      env.each { |key, value| cmd.push("--env", "#{key}=#{value}") }
+      cmd.push("-i") if stdin_data
+
+      cmd.push(@container_id)
+
+      cmd.concat(normalize_command(command))
+    end
+  end
+end

data/lib/agent_harness/providers/base.rb

@@ -32,7 +32,8 @@ module AgentHarness
     class Base
       include Adapter
 
-      attr_reader :config, :executor, :logger
+      attr_reader :config, :logger
+      attr_accessor :executor
 
       # Initialize the provider
       #

data/lib/agent_harness/version.rb

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

data/lib/agent_harness.rb

@@ -89,6 +89,7 @@ end
 require_relative "agent_harness/errors"
 require_relative "agent_harness/configuration"
 require_relative "agent_harness/command_executor"
+require_relative "agent_harness/docker_command_executor"
 require_relative "agent_harness/response"
 require_relative "agent_harness/token_tracker"
 require_relative "agent_harness/error_taxonomy"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: agent-harness
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Bart Agapinan
@@ -78,6 +78,7 @@ files:
 - lib/agent_harness.rb
 - lib/agent_harness/command_executor.rb
 - lib/agent_harness/configuration.rb
+- lib/agent_harness/docker_command_executor.rb
 - lib/agent_harness/error_taxonomy.rb
 - lib/agent_harness/errors.rb
 - lib/agent_harness/orchestration/circuit_breaker.rb