agent-harness 0.5.7 → 0.5.8

data/lib/agent_harness/providers/aider.rb

@@ -6,6 +6,17 @@ module AgentHarness
     #
     # Provides integration with the Aider CLI tool.
     class Aider < Base
+      UV_VERSION = "0.8.17"
+      SUPPORTED_CLI_VERSION = "0.86.2"
+      SUPPORTED_CLI_REQUIREMENT = Gem::Requirement.new(">= #{SUPPORTED_CLI_VERSION}", "< 0.87.0").freeze
+      PYTHON_VERSION = "python3.12"
+      BINARY_PATH = "/usr/local/bin/aider"
+      UV_TOOL_ENV = {
+        "UV_TOOL_BIN_DIR" => "/usr/local/bin",
+        "UV_TOOL_DIR" => "/opt/uv/tools",
+        "UV_PYTHON_INSTALL_DIR" => "/opt/uv/python"
+      }.freeze
+
       class << self
         def provider_name
           :aider
@@ -50,6 +61,50 @@ module AgentHarness
           ]
         end
 
+        def installation_contract(version: SUPPORTED_CLI_VERSION)
+          unless SUPPORTED_CLI_REQUIREMENT.satisfied_by?(Gem::Version.new(version))
+            raise ArgumentError,
+              "Unsupported Aider CLI version #{version.inspect}; " \
+              "supported versions must satisfy #{SUPPORTED_CLI_REQUIREMENT}"
+          end
+
+          default_package = "aider-chat==#{version}".freeze
+          bootstrap_command = [
+            "python3", "-m", "pip", "install", "--no-cache-dir", "--break-system-packages", "uv==#{UV_VERSION}"
+          ].freeze
+          install_command_prefix = [
+            "uv", "tool", "install", "--force", "--python", PYTHON_VERSION, "--with", "pip"
+          ].freeze
+          install_command = (install_command_prefix + [default_package]).freeze
+          supported_versions = [version].freeze
+          version_requirement = SUPPORTED_CLI_REQUIREMENT.requirements
+            .map { |op, ver| "#{op} #{ver}".freeze }
+            .freeze
+
+          contract = {
+            source: :uv_tool,
+            bootstrap_source: :pip,
+            bootstrap_package: "uv==#{UV_VERSION}",
+            bootstrap_commands: [bootstrap_command].freeze,
+            install_environment: UV_TOOL_ENV,
+            package: default_package,
+            package_name: "aider-chat",
+            version: version,
+            version_format: "%{package_name}==%{version}",
+            version_requirement: version_requirement,
+            binary_name: binary_name,
+            binary_path: BINARY_PATH,
+            install_command_prefix: install_command_prefix,
+            install_command: install_command,
+            supported_versions: supported_versions
+          }
+
+          contract.each_value do |value|
+            value.freeze if value.is_a?(String)
+          end
+          contract.freeze
+        end
+
         def smoke_test_contract
           Base::DEFAULT_SMOKE_TEST_CONTRACT
         end

data/lib/agent_harness/providers/anthropic.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "json"
+require "shellwords"
 
 module AgentHarness
   module Providers
@@ -15,6 +16,12 @@ module AgentHarness
     class Anthropic < Base
       # Model name pattern for Anthropic Claude models
       MODEL_PATTERN = /^claude-[\d.-]+-(?:opus|sonnet|haiku)(?:-\d{8})?$/i
+      SUPPORTED_CLI_VERSION = "2.1.92"
+      SUPPORTED_CLI_REQUIREMENT = Gem::Requirement.new(">= #{SUPPORTED_CLI_VERSION}", "< 2.2.0").freeze
+
+      # Matches semver (e.g. "2.1.92"), optional pre-release (e.g. "2.1.92-beta.1"),
+      # or channel tokens (e.g. "latest", "stable").
+      VALID_VERSION_PATTERN = /\A(?:\d+\.\d+\.\d+(?:-[a-zA-Z0-9.]+)?|latest|stable)\z/
 
       class << self
         def provider_name
@@ -25,11 +32,79 @@ module AgentHarness
           "claude"
         end
 
+        def install_contract(version: nil)
+          target_version = version || SUPPORTED_CLI_VERSION
+          validate_version!(target_version)
+          version_requirement = SUPPORTED_CLI_REQUIREMENT.requirements
+            .map { |op, ver| "#{op} #{ver}" }
+            .join(", ")
+          channel_token = %w[latest stable].include?(target_version.to_s)
+
+          warning = "Review the downloaded installer before execution and verify any published checksum or signature metadata when available."
+          if channel_token
+            warning += " Channel '#{target_version}' is not pinned; the resolved version may fall " \
+              "outside the supported range (#{version_requirement}). Verify the installed version " \
+              "after installation."
+          end
+
+          {
+            provider: provider_name,
+            binary_name: binary_name,
+            binary_paths: [
+              "$HOME/.local/bin/claude",
+              binary_name
+            ],
+            install: {
+              strategy: :shell,
+              source: "official",
+              command: "tmp_script=$(mktemp) && trap 'rm -f \"$tmp_script\"' EXIT && curl -fsSL https://claude.ai/install.sh -o \"$tmp_script\" && bash \"$tmp_script\" #{Shellwords.shellescape(target_version)}",
+              warning: warning,
+              post_install_binary_path: "$HOME/.local/bin/claude",
+              # When a channel token is used, include the requirement so
+              # consumers can validate the installed version post-install.
+              version_not_pinned: channel_token
+            },
+            supported_versions: {
+              default: SUPPORTED_CLI_VERSION,
+              requirement: version_requirement,
+              channel: "stable"
+            },
+            runtime_contract: {
+              available_via: binary_name,
+              build_command: [
+                binary_name,
+                "--print",
+                "--output-format=json"
+              ],
+              required_features: [
+                "print_mode",
+                "json_output",
+                "mcp_config",
+                "mcp_list",
+                "dangerously_skip_permissions",
+                "models_list"
+              ]
+            }
+          }
+        end
+
         def available?
           executor = AgentHarness.configuration.command_executor
           !!executor.which(binary_name)
         end
 
+        def provider_metadata_overrides
+          {
+            auth: {
+              service: :anthropic,
+              api_family: :anthropic
+            },
+            identity: {
+              bot_usernames: %w[claude anthropic]
+            }
+          }
+        end
+
         def firewall_requirements
           {
             domains: [
@@ -87,6 +162,25 @@ module AgentHarness
 
         private
 
+        def validate_version!(version)
+          version_str = version.to_s
+
+          unless VALID_VERSION_PATTERN.match?(version_str)
+            raise ArgumentError, "Invalid version: #{version.inspect}. " \
+              "Must be a semver string (e.g. '2.1.92'), optional pre-release suffix, or a channel token ('latest', 'stable')."
+          end
+
+          # Channel tokens are not concrete versions; skip requirement check.
+          return if %w[latest stable].include?(version_str)
+
+          # Validate concrete versions against the supported range.
+          gem_version = Gem::Version.new(version_str)
+          return if SUPPORTED_CLI_REQUIREMENT.satisfied_by?(gem_version)
+
+          raise ArgumentError, "Version #{version.inspect} is outside the supported range " \
+            "(#{SUPPORTED_CLI_REQUIREMENT}). Update SUPPORTED_CLI_REQUIREMENT before targeting this version."
+        end
+
         def parse_models_list(output)
           return [] if output.nil? || output.empty?
 

data/lib/agent_harness/providers/codex.rb

@@ -25,6 +25,15 @@ module AgentHarness
           !!executor.which(binary_name)
         end
 
+        def provider_metadata_overrides
+          {
+            auth: {
+              service: :openai,
+              api_family: :openai
+            }
+          }
+        end
+
         def firewall_requirements
           {
             domains: [
@@ -53,11 +62,17 @@ module AgentHarness
           ]
         end
 
-        def installation_contract
-          default_package = "@openai/codex@#{SUPPORTED_CLI_VERSION}".freeze
+        def installation_contract(version: SUPPORTED_CLI_VERSION)
+          unless SUPPORTED_CLI_REQUIREMENT.satisfied_by?(Gem::Version.new(version))
+            raise ArgumentError,
+              "Unsupported Codex CLI version #{version.inspect}; " \
+              "supported versions must satisfy #{SUPPORTED_CLI_REQUIREMENT}"
+          end
+
+          default_package = "@openai/codex@#{version}".freeze
           install_command_prefix = ["npm", "install", "-g", "--ignore-scripts"].freeze
           install_command = (install_command_prefix + [default_package]).freeze
-          supported_versions = [SUPPORTED_CLI_VERSION].freeze
+          supported_versions = [version].freeze
           version_requirement = SUPPORTED_CLI_REQUIREMENT.requirements
             .map { |op, ver| "#{op} #{ver}".freeze }
             .freeze
@@ -66,7 +81,7 @@ module AgentHarness
             source: :npm,
             package: default_package,
             package_name: "@openai/codex",
-            version: SUPPORTED_CLI_VERSION,
+            version: version,
             version_requirement: version_requirement,
             binary_name: binary_name,
             install_command_prefix: install_command_prefix,

data/lib/agent_harness/providers/cursor.rb

@@ -12,6 +12,12 @@ module AgentHarness
     #   provider = AgentHarness::Providers::Cursor.new
     #   response = provider.send_message(prompt: "Hello!")
     class Cursor < Base
+      INSTALL_SCRIPT_URL = "https://cursor.com/install"
+      INSTALL_TARGET_LATEST = "latest"
+      INSTALL_BUILD = "2026.03.30-a5d3e17"
+      INSTALL_SCRIPT_SHA256 = "8371988b483abec13c07c10e95cccc839da81ebf9596e430d3c90835a227cbad"
+      INSTALL_LINUX_X64_PACKAGE_SHA256 = "e0d4b611db111d2dbe76474386271bff3e1dbb2cc6ddf527f9d5d5801b2ce2a0"
+
       class << self
         def provider_name
           :cursor
@@ -26,6 +32,15 @@ module AgentHarness
           !!executor.which(binary_name)
         end
 
+        def provider_metadata_overrides
+          {
+            auth: {
+              service: :cursor,
+              api_family: :cursor
+            }
+          }
+        end
+
         def firewall_requirements
           {
             domains: [
@@ -84,9 +99,66 @@ module AgentHarness
           family_name.match?(/^(claude|gpt|cursor)-/)
         end
 
+        def install_metadata(version: nil)
+          install_target = normalize_install_target(version)
+          linux_x64_package_url = package_url_for(os: "linux", arch: "x64")
+
+          {
+            source: {
+              type: :shell_script,
+              url: INSTALL_SCRIPT_URL,
+              resolved_version: INSTALL_BUILD,
+              default_artifact_url: linux_x64_package_url
+            },
+            checksum: {
+              strategy: :sha256,
+              targets: {
+                script: {
+                  url: INSTALL_SCRIPT_URL,
+                  value: INSTALL_SCRIPT_SHA256
+                },
+                artifacts: {
+                  "linux/x64" => {
+                    url: linux_x64_package_url,
+                    value: INSTALL_LINUX_X64_PACKAGE_SHA256
+                  }
+                }
+              }
+            },
+            binary: {
+              name: binary_name,
+              path: "$HOME/.local/bin/#{binary_name}",
+              suggested_global_path: "/usr/local/bin/#{binary_name}"
+            },
+            version: {
+              default: INSTALL_TARGET_LATEST,
+              supported: install_target,
+              command: [binary_name, "--version"]
+            }
+          }
+        end
+
         def smoke_test_contract
           Base::DEFAULT_SMOKE_TEST_CONTRACT
         end
+
+        private
+
+        def package_url_for(os:, arch:)
+          format(
+            "https://downloads.cursor.com/lab/%<build>s/%<os>s/%<arch>s/agent-cli-package.tar.gz",
+            build: INSTALL_BUILD,
+            os: os,
+            arch: arch
+          )
+        end
+
+        def normalize_install_target(version)
+          target = version.nil? ? INSTALL_TARGET_LATEST : version.to_s
+          return target if target == INSTALL_TARGET_LATEST
+
+          raise ArgumentError, "Unsupported Cursor install target: #{version.inspect}"
+        end
       end
 
       def name
@@ -253,7 +325,7 @@ module AgentHarness
         return nil unless self.class.available?
 
         begin
-          result = @executor.execute(["cursor-agent", "mcp", "list"], timeout: 5)
+          result = @executor.execute([self.class.binary_name, "mcp", "list"], timeout: 5)
           return nil unless result.success?
 
           parse_mcp_servers_output(result.stdout)

data/lib/agent_harness/providers/gemini.rb

@@ -30,6 +30,15 @@ module AgentHarness
           !!executor.which(binary_name)
         end
 
+        def provider_metadata_overrides
+          {
+            auth: {
+              service: :google,
+              api_family: :gemini
+            }
+          }
+        end
+
         def install_contract(version: SUPPORTED_CLI_VERSION)
           parsed_version = begin
             Gem::Version.new(version)

data/lib/agent_harness/providers/github_copilot.rb

@@ -37,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: [

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: [

data/lib/agent_harness/providers/opencode.rb

@@ -29,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: [