agent-harness 0.11.1 → 0.11.3

data/lib/agent_harness/providers/mcp_config_file_support.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module AgentHarness
+  module Providers
+    # Shared concern for writing and cleaning up MCP configuration tempfiles.
+    #
+    # Include this module in any provider that needs to write MCP config files
+    # for CLI processes. The including class must define an +mcp_provider_key+
+    # method that returns the symbol passed to +McpConfigTranslator.for_provider+.
+    module McpConfigFileSupport
+      def write_mcp_config_file(mcp_servers, working_dir: nil)
+        require "tempfile"
+        require "tmpdir"
+        require "securerandom"
+
+        config = McpConfigTranslator.for_provider(mcp_provider_key, mcp_servers)
+        config_json = JSON.generate(config)
+
+        if @executor.is_a?(DockerCommandExecutor)
+          # When running inside a Docker container, write the config file
+          # inside the container so the CLI process can read it.
+          # Track the path so cleanup_mcp_tempfiles! can remove it after execution.
+          container_path = "/tmp/agent_harness_mcp_#{SecureRandom.hex(8)}.json"
+          result = @executor.execute(
+            ["sh", "-c", "cat > #{container_path}"],
+            stdin_data: config_json,
+            timeout: 5
+          )
+          unless result.success?
+            raise McpConfigurationError,
+              "Failed to write MCP config inside container: #{result.stderr}"
+          end
+
+          @mcp_docker_config_paths ||= []
+          @mcp_docker_config_paths << container_path
+
+          container_path
+        else
+          dir = working_dir || Dir.tmpdir
+          file = Tempfile.new(["agent_harness_mcp_", ".json"], dir)
+          file.write(config_json)
+          file.close
+
+          # Hold a reference so the Tempfile is not garbage-collected (and
+          # therefore deleted) before the CLI process reads it.
+          # Cleaned up by cleanup_mcp_tempfiles! after execution.
+          @mcp_config_tempfiles ||= []
+          @mcp_config_tempfiles << file
+
+          file.path
+        end
+      end
+
+      def cleanup_mcp_tempfiles!
+        if @mcp_config_tempfiles
+          @mcp_config_tempfiles.each do |file|
+            file.close unless file.closed?
+            file.unlink
+          rescue
+            nil
+          end
+          @mcp_config_tempfiles = nil
+        end
+
+        if @mcp_docker_config_paths
+          @mcp_docker_config_paths.each do |path|
+            @executor.execute(["rm", "-f", path], timeout: 5)
+          rescue
+            nil
+          end
+          @mcp_docker_config_paths = nil
+        end
+      end
+    end
+  end
+end

data/lib/agent_harness/version.rb

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

data/lib/agent_harness.rb

@@ -77,6 +77,47 @@ module AgentHarness
       conductor.send_message(prompt, provider: provider, executor: executor, **options)
     end
 
+    # Resolve a canonical extension definition by name or inline object.
+    #
+    # @param reference [Symbol, String, Extensions::Base]
+    # @return [Extensions::Base]
+    def extension(reference)
+      configuration.resolve_extension(reference)
+    end
+
+    # Load one or more extensions from disk through an adapter.
+    #
+    # @param path [String] extension file, directory, or package root
+    # @param adapter [Symbol, String, nil] optional explicit adapter
+    # @return [Array<Extensions::Base>]
+    def load_extensions(path, adapter: nil)
+      configuration.load_extensions(path, adapter: adapter)
+    end
+
+    # Discover and register all extensions found in a directory.
+    #
+    # @param directory [String] directory to scan
+    # @return [Array<Extensions::Base>]
+    def discover_extensions(directory)
+      configuration.discover_extensions(directory)
+    end
+
+    # Build a compatibility report for extensions against a provider.
+    #
+    # @param provider [Symbol, String, Providers::Base] target provider
+    # @param extensions [Array<Symbol, String, Extensions::Base>] extension references
+    # @return [Array<Extensions::CompatibilityReport>]
+    def extension_compatibility(provider:, extensions:)
+      provider_instance = provider.is_a?(Providers::Base) ? provider : self.provider(provider)
+
+      Array(extensions).map do |extension_ref|
+        Extensions::Compatibility.report(
+          provider: provider_instance,
+          extension: extension(extension_ref)
+        )
+      end
+    end
+
     # Resolve a canonical sub-agent definition by name or inline payload.
     #
     # @param reference [Symbol, String, Hash, SubAgentConfig]
@@ -277,7 +318,10 @@ end
 
 # Core components
 require_relative "agent_harness/errors"
+require_relative "agent_harness/extensions"
 require_relative "agent_harness/mcp_server"
+require_relative "agent_harness/mcp_config_loader"
+require_relative "agent_harness/mcp_config_translator"
 require_relative "agent_harness/sub_agent_config"
 require_relative "agent_harness/sub_agent_file_loader"
 require_relative "agent_harness/sub_agent_translator"
@@ -301,6 +345,7 @@ 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/mcp_config_file_support"
 require_relative "agent_harness/providers/anthropic"
 require_relative "agent_harness/providers/aider"
 require_relative "agent_harness/providers/codex"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: agent-harness
 version: !ruby/object:Gem::Version
-  version: 0.11.1
+  version: 0.11.3
 platform: ruby
 authors:
 - Bart Agapinan
@@ -107,6 +107,9 @@ files:
 - lib/agent_harness/error_taxonomy.rb
 - lib/agent_harness/errors.rb
 - lib/agent_harness/execution_preparation.rb
+- lib/agent_harness/extensions.rb
+- lib/agent_harness/mcp_config_loader.rb
+- lib/agent_harness/mcp_config_translator.rb
 - lib/agent_harness/mcp_server.rb
 - lib/agent_harness/openai_compatible_transport.rb
 - lib/agent_harness/orchestration/circuit_breaker.rb
@@ -126,6 +129,7 @@ files:
 - lib/agent_harness/providers/gemini.rb
 - lib/agent_harness/providers/github_copilot.rb
 - lib/agent_harness/providers/kilocode.rb
+- lib/agent_harness/providers/mcp_config_file_support.rb
 - lib/agent_harness/providers/mistral_vibe.rb
 - lib/agent_harness/providers/opencode.rb
 - lib/agent_harness/providers/rate_limit_reset_parsing.rb