agent-harness 0.5.6 → 0.5.8

data/lib/agent_harness/providers/github_copilot.rb

@@ -9,13 +9,27 @@ module AgentHarness
       # Model name pattern for GitHub Copilot (uses OpenAI models)
       MODEL_PATTERN = /^gpt-[\d.o-]+(?:-turbo)?(?:-mini)?$/i
 
+      # Copilot-specific smoke test contract.  The `what-the-shell` subcommand
+      # translates natural language into shell commands, so the generic
+      # "Reply with exactly OK." prompt would produce something like
+      # `echo "OK"` rather than the literal text "OK".  We use a prompt that
+      # is meaningful for the shell-translation path and only require
+      # non-empty output (no exact match).
+      SMOKE_TEST_CONTRACT = {
+        prompt: "list files in the current directory",
+        expected_output: nil,
+        timeout: 30,
+        require_output: true,
+        success_message: "Smoke test passed"
+      }.freeze
+
       class << self
         def provider_name
           :github_copilot
         end
 
         def binary_name
-          "copilot"
+          "github-copilot-cli"
         end
 
         def available?
@@ -23,6 +37,18 @@ module AgentHarness
           !!executor.which(binary_name)
         end
 
+        def provider_metadata_overrides
+          {
+            auth: {
+              service: :github,
+              api_family: :github_copilot
+            },
+            identity: {
+              bot_usernames: ["github-copilot[bot]"]
+            }
+          }
+        end
+
         def firewall_requirements
           {
             domains: [
@@ -56,6 +82,10 @@ module AgentHarness
           ]
         end
 
+        def smoke_test_contract
+          SMOKE_TEST_CONTRACT
+        end
+
         def model_family(provider_model_name)
           provider_model_name
         end
@@ -116,10 +146,10 @@ module AgentHarness
 
       def execution_semantics
         {
-          prompt_delivery: :flag,
+          prompt_delivery: :arg,
           output_format: :text,
           sandbox_aware: false,
-          uses_subcommand: false,
+          uses_subcommand: true,
           non_interactive_flag: nil,
           legitimate_exit_codes: [0],
           stderr_is_diagnostic: true,
@@ -155,10 +185,12 @@ module AgentHarness
       protected
 
       def build_command(prompt, options)
-        cmd = [self.class.binary_name, "-p", prompt]
+        cmd = [self.class.binary_name, "what-the-shell", prompt]
 
-        # Add dangerous mode flags by default for automation
-        cmd += dangerous_mode_flags if supports_dangerous_mode?
+        # Opt in to unrestricted tool access explicitly to preserve a safe default.
+        if supports_dangerous_mode? && options[:dangerous_mode]
+          cmd += dangerous_mode_flags
+        end
 
         # Add session support if provided
         if options[:session] && !options[:session].empty?

data/lib/agent_harness/providers/kilocode.rb

@@ -6,6 +6,10 @@ module AgentHarness
     #
     # Provides integration with the Kilocode CLI tool.
     class Kilocode < Base
+      PACKAGE_NAME = "@kilocode/cli"
+      DEFAULT_VERSION = "7.1.3"
+      SUPPORTED_VERSION_REQUIREMENT = "= #{DEFAULT_VERSION}"
+
       class << self
         def provider_name
           :kilocode
@@ -35,6 +39,41 @@ module AgentHarness
           return [] unless available?
           []
         end
+
+        def installation_contract(version: DEFAULT_VERSION)
+          validate_install_version!(version)
+          package_spec = "#{PACKAGE_NAME}@#{version}"
+
+          {
+            source: {
+              type: :npm,
+              package: PACKAGE_NAME
+            },
+            install_command: ["npm", "install", "-g", "--ignore-scripts", package_spec],
+            binary_name: binary_name,
+            default_version: DEFAULT_VERSION,
+            supported_version_requirement: SUPPORTED_VERSION_REQUIREMENT
+          }
+        end
+
+        def install_command(version: DEFAULT_VERSION)
+          installation_contract(version: version)[:install_command]
+        end
+
+        def smoke_test_contract
+          Base::DEFAULT_SMOKE_TEST_CONTRACT
+        end
+
+        private
+
+        def validate_install_version!(version)
+          requirement = Gem::Requirement.new(SUPPORTED_VERSION_REQUIREMENT)
+          return if requirement.satisfied_by?(Gem::Version.new(version))
+
+          raise ArgumentError,
+            "Unsupported Kilocode CLI version #{version.inspect}; " \
+            "supported versions must satisfy #{SUPPORTED_VERSION_REQUIREMENT}"
+        end
       end
 
       def name

data/lib/agent_harness/providers/mistral_vibe.rb

@@ -20,6 +20,15 @@ module AgentHarness
           !!executor.which(binary_name)
         end
 
+        def provider_metadata_overrides
+          {
+            auth: {
+              service: :mistral,
+              api_family: :mistral
+            }
+          }
+        end
+
         def firewall_requirements
           {
             domains: [
@@ -37,6 +46,10 @@ module AgentHarness
           return [] unless available?
           []
         end
+
+        def smoke_test_contract
+          Base::DEFAULT_SMOKE_TEST_CONTRACT
+        end
       end
 
       def name

data/lib/agent_harness/providers/opencode.rb

@@ -6,6 +6,15 @@ module AgentHarness
     #
     # Provides integration with the OpenCode CLI tool.
     class Opencode < Base
+      CLI_PACKAGE = "opencode-ai"
+      SUPPORTED_CLI_VERSION = "1.3.2"
+      SUPPORTED_CLI_REQUIREMENT = Gem::Requirement.new(">= #{SUPPORTED_CLI_VERSION}", "< 1.4.0").freeze
+      INSTALL_COMMAND_PREFIX = ["npm", "install", "-g", "--ignore-scripts"].freeze
+      SUPPORTED_CLI_VERSIONS = [SUPPORTED_CLI_VERSION].freeze
+      VERSION_REQUIREMENT_STRINGS = SUPPORTED_CLI_REQUIREMENT.requirements
+        .map { |op, ver| "#{op} #{ver}".freeze }
+        .freeze
+
       class << self
         def provider_name
           :opencode
@@ -20,6 +29,15 @@ module AgentHarness
           !!executor.which(binary_name)
         end
 
+        def provider_metadata_overrides
+          {
+            auth: {
+              service: :openai,
+              api_family: :openai_compatible
+            }
+          }
+        end
+
         def firewall_requirements
           {
             domains: [
@@ -37,8 +55,66 @@ module AgentHarness
           return [] unless available?
           []
         end
+
+        def installation_contract(version: SUPPORTED_CLI_VERSION)
+          normalized_version = normalize_install_version(version)
+          return DEFAULT_INSTALLATION_CONTRACT if normalized_version == SUPPORTED_CLI_VERSION
+
+          build_installation_contract(normalized_version)
+        end
+
+        def install_command(version: SUPPORTED_CLI_VERSION)
+          installation_contract(version: version)[:install_command]
+        end
+
+        def smoke_test_contract
+          Base::DEFAULT_SMOKE_TEST_CONTRACT
+        end
+
+        private
+
+        def build_installation_contract(version)
+          package = "#{CLI_PACKAGE}@#{version}".freeze
+          install_command = (INSTALL_COMMAND_PREFIX + [package]).freeze
+
+          contract = {
+            source: :npm,
+            package: package,
+            package_name: CLI_PACKAGE,
+            version: version,
+            version_requirement: VERSION_REQUIREMENT_STRINGS,
+            binary_name: binary_name,
+            install_command_prefix: INSTALL_COMMAND_PREFIX,
+            install_command: install_command,
+            supported_versions: SUPPORTED_CLI_VERSIONS
+          }
+
+          contract.each_value do |value|
+            value.freeze if value.is_a?(String)
+          end
+          contract.freeze
+        end
+
+        def normalize_install_version(version)
+          raise ArgumentError, unsupported_version_message(version) unless version.is_a?(String) && !version.strip.empty?
+
+          normalized_version = version.strip
+          parsed_version = Gem::Version.new(normalized_version)
+          return normalized_version if SUPPORTED_CLI_REQUIREMENT.satisfied_by?(parsed_version)
+
+          raise ArgumentError, unsupported_version_message(version)
+        rescue ArgumentError
+          raise ArgumentError, unsupported_version_message(version)
+        end
+
+        def unsupported_version_message(version)
+          "Unsupported OpenCode CLI version #{version.inspect}; " \
+            "supported versions must satisfy #{SUPPORTED_CLI_REQUIREMENT}"
+        end
       end
 
+      DEFAULT_INSTALLATION_CONTRACT = build_installation_contract(SUPPORTED_CLI_VERSION)
+
       def name
         "opencode"
       end
@@ -87,7 +163,7 @@ module AgentHarness
       protected
 
       def build_command(prompt, options)
-        cmd = [self.class.binary_name, "run"]
+        cmd = [self.class.installation_contract[:binary_name], "run"]
 
         runtime = options[:provider_runtime]
         if runtime