agent-harness 0.28.6 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0462522eb82540a1cc498c27663441e6aab837cabab94921e7deed4f31e2f29
-  data.tar.gz: 14a84df84773fd4a64597d46733e4c4a0297ec3b4102dde5a9ded015e3a451e1
+  metadata.gz: e929940987f238b75b654eadf2d882b0a554fb755c3badac115c7ae218875677
+  data.tar.gz: a83fefa5de68968675304ed70316ccfa37a7b3063bd58a1edf3b8c493f017daf
 SHA512:
-  metadata.gz: 34f7e74dd1f62aed14782936a1d794c4e2406ddc05f274dbe39e28ac7938f7b00387cfdc05e7fb4c94bd1c3e79294fd9cbdfe25a0e8c235d6340b04de47e048f
-  data.tar.gz: 7a3946d5a75fa84c6502e02ce409325e870c0bbd0a23a7ea8319cffbfe75128a9bf8c1889b8d9747c0f8fef13f04dc9e625ce7969f60a92b3728e75041e496ac
+  metadata.gz: a08f5ce50f0b0c200034d53908ded075808f7a2e374aff7365d54240cf1dc291d1cde28d4e1d4e76cc2d16273aa30bb17f81384243d626ce60fd5c5fd6d2f702
+  data.tar.gz: 615fec572434e6a0653f3ae3cd1723f551d7578eb30ef2f1ee0a2714c6221be8acd29c06e3830d10f0e88c040c31faab51658c26b09b79e18215f295587c644e

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.28.6"
+  ".": "0.29.0"
 }

data/CHANGELOG.md

@@ -6,6 +6,13 @@
 * **auth:** add provider-owned PKCE code-exchange API for Claude OAuth (`AgentHarness::Authentication.exchange_code`). Takes an authorization code plus PKCE verifier (and `redirect_uri`/`client_id`), posts an `authorization_code` grant to the Claude token endpoint, and persists the resulting access/refresh tokens in the native `claudeAiOauth` shape. Adds `exchange_code_supported?` and a `code_exchange` key to `auth_capabilities` ([#266](https://github.com/viamin/agent-harness/issues/266)).
 
 
+## [0.29.0](https://github.com/viamin/agent-harness/compare/agent-harness/v0.28.6...agent-harness/v0.29.0) (2026-07-16)
+
+
+### Features
+
+* Add Oh My Pi provider metadata and install contract ([#298](https://github.com/viamin/agent-harness/issues/298)) ([3be62a8](https://github.com/viamin/agent-harness/commit/3be62a884f50ceeb903e199f4a9906cf3fecf014))
+
 ## [0.28.6](https://github.com/viamin/agent-harness/compare/agent-harness/v0.28.5...agent-harness/v0.28.6) (2026-07-12)
 
 

data/README.md

@@ -5,7 +5,7 @@ A unified Ruby interface for CLI-based AI coding agents like Claude Code, Cursor
 ## Features
 
 - **Unified Interface**: Single API for multiple AI coding agents
-- **10 Built-in Providers**: Claude Code, Cursor, Gemini CLI, GitHub Copilot, Codex, Pi, Aider, OpenCode, Kilocode, Mistral Vibe
+- **11 Built-in Providers**: Claude Code, Cursor, Gemini CLI, GitHub Copilot, Codex, Pi, Oh My Pi, Aider, OpenCode, Kilocode, Mistral Vibe
 - **Full Orchestration**: Provider switching, circuit breakers, rate limiting, and health monitoring
 - **Flexible Configuration**: YAML, Ruby DSL, or environment variables
 - **Token Tracking**: Monitor usage across providers for cost and limit management
@@ -105,6 +105,7 @@ end
 | `:github_copilot` | `copilot` | GitHub Copilot CLI |
 | `:codex` | `codex` | OpenAI Codex CLI |
 | `:pi` | `pi` | Pi coding agent CLI |
+| `:omp` | `omp` | Oh My Pi coding agent CLI (Bun-based fork of Pi) |
 | `:aider` | `aider` | Aider coding assistant |
 | `:opencode` | `opencode` | OpenCode CLI |
 | `:kilocode` | `kilo` | Kilocode CLI |
@@ -188,7 +189,7 @@ puts contract[:supported_versions][:requirement]
 
 # List all registered providers
 AgentHarness::Providers::Registry.instance.all
-# => [:claude, :cursor, :gemini, :github_copilot, :pi, :codex, :opencode, :kilocode, :aider, :mistral_vibe]
+# => [:claude, :cursor, :gemini, :github_copilot, :pi, :omp, :codex, :opencode, :kilocode, :aider, :mistral_vibe]
 ```
 
 For Claude, the install contract is the first-class source of truth for:

data/lib/agent_harness/providers/adapter.rb

@@ -39,9 +39,35 @@ module AgentHarness
         normalized[:requires_postinstall] = contract[:requires_postinstall] if contract.key?(:requires_postinstall)
         normalized[:postinstall_command] = contract[:postinstall_command] if contract.key?(:postinstall_command)
 
+        if contract.key?(:runtime_requirements)
+          normalized[:runtime_requirements] =
+            normalize_metadata_runtime_requirements(contract[:runtime_requirements])
+        end
+
         normalized
       end
 
+      # Normalize an installation contract's `runtime_requirements` so the
+      # stable provider-metadata path exposes the same runtime prerequisites
+      # (e.g. Bun for the :omp provider) as the raw installation contract.
+      #
+      # Each entry is duplicated so consumers receive a self-contained hash
+      # they can mutate top-level keys on without aliasing the provider-owned
+      # contract, and the resulting array is frozen to signal that the
+      # normalized metadata is read-only.
+      #
+      # @param requirements [Array<Hash>, nil]
+      # @return [Array<Hash>, nil] normalized requirements, or nil when absent
+      def self.normalize_metadata_runtime_requirements(requirements)
+        return requirements unless requirements.is_a?(Array)
+
+        requirements.map do |requirement|
+          next requirement.dup if requirement.is_a?(Hash)
+
+          requirement
+        end.freeze
+      end
+
       def self.normalize_metadata_source_type(source)
         return source[:type]&.to_sym if source.is_a?(Hash)
 

data/lib/agent_harness/providers/omp.rb

@@ -0,0 +1,258 @@
+# frozen_string_literal: true
+
+require "rubygems/requirement"
+
+module AgentHarness
+  module Providers
+    # Oh My Pi coding agent CLI provider
+    #
+    # Provides integration with the Oh My Pi (can1357/oh-my-pi) terminal
+    # coding agent, a Bun-based fork of the Pi coding agent. Distinct from
+    # the {Pi} provider, which targets the upstream @mariozechner/pi-coding-agent
+    # CLI.
+    class OhMyPi < Base
+      CLI_PACKAGE = "@oh-my-pi/pi-coding-agent"
+      SUPPORTED_CLI_VERSION = "17.0.1"
+      SUPPORTED_CLI_REQUIREMENT = Gem::Requirement.new("= #{SUPPORTED_CLI_VERSION}").freeze
+
+      # Bun runtime requirements. The omp entrypoint is
+      # `#!/usr/bin/env bun` and the published package metadata requires
+      # Bun `>= 1.3.14`. Consumers must provision a compatible Bun runtime
+      # before installing the @oh-my-pi/pi-coding-agent package.
+      #
+      # The `bun` npm package relies on its `postinstall` script to fetch the
+      # platform binary; installing it with `npm install --ignore-scripts`
+      # ships only the Windows shims (`bin/bun.exe`, `bunx.exe`) and leaves
+      # Linux/macOS without a working `bun` binary. Provision Bun via the
+      # official installer script instead, which fetches the correct
+      # platform binary directly.
+      BUN_BINARY = "bun"
+      BUN_INSTALL_SCRIPT_URL = "https://bun.sh/install"
+      SUPPORTED_BUN_VERSION = "1.3.14"
+      BUN_REQUIREMENT_STRING = ">= #{SUPPORTED_BUN_VERSION}".freeze
+
+      class << self
+        def provider_name
+          :omp
+        end
+
+        def binary_name
+          "omp"
+        end
+
+        def available?
+          executor = AgentHarness.configuration.command_executor
+          !!executor.which(binary_name)
+        end
+
+        def provider_metadata_overrides
+          {
+            auth: {
+              service: :omp,
+              api_family: :multi_provider
+            }
+          }
+        end
+
+        def firewall_requirements
+          {
+            domains: [
+              "pi.dev"
+            ],
+            ip_ranges: []
+          }
+        end
+
+        def instruction_file_paths
+          [
+            {
+              path: "AGENTS.md",
+              description: "Oh My Pi agent instructions",
+              symlink: false
+            },
+            {
+              path: "SYSTEM.md",
+              description: "Oh My Pi system prompt override",
+              symlink: false
+            }
+          ]
+        end
+
+        def discover_models
+          return [] unless available?
+          []
+        end
+
+        def bun_runtime_contract
+          # The official Bun installer reads `BUN_VERSION` to pin the release
+          # it downloads, and fetches the platform-appropriate binary itself.
+          install_command_prefix = ["sh", "-c"].freeze
+          inner_script = "curl -fsSL #{BUN_INSTALL_SCRIPT_URL} | " \
+                          "BUN_VERSION=#{SUPPORTED_BUN_VERSION} bash"
+          install_command = (install_command_prefix + [inner_script]).freeze
+
+          {
+            name: :bun,
+            binary_name: BUN_BINARY,
+            pinned_version: SUPPORTED_BUN_VERSION,
+            version_requirement: BUN_REQUIREMENT_STRING,
+            source: :script,
+            install_script_url: BUN_INSTALL_SCRIPT_URL,
+            install_command_prefix: install_command_prefix,
+            install_command: install_command,
+            install_command_string: inner_script,
+            rationale: "omp entrypoint is #!/usr/bin/env bun; the bun npm package relies on " \
+                       "its postinstall script to fetch the platform binary, so install Bun " \
+                       "via the official installer script rather than npm --ignore-scripts"
+          }.freeze
+        end
+
+        def installation_contract(version: SUPPORTED_CLI_VERSION)
+          version = version.strip if version.respond_to?(:strip)
+
+          unless version.is_a?(String) && !version.empty?
+            raise ArgumentError,
+              "Unsupported Oh My Pi CLI version #{version.inspect}; " \
+              "supported versions must satisfy #{SUPPORTED_CLI_REQUIREMENT}"
+          end
+
+          parsed_version = begin
+            Gem::Version.new(version)
+          rescue ArgumentError
+            raise ArgumentError,
+              "Unsupported Oh My Pi CLI version #{version.inspect}; " \
+              "supported versions must satisfy #{SUPPORTED_CLI_REQUIREMENT}"
+          end
+
+          unless SUPPORTED_CLI_REQUIREMENT.satisfied_by?(parsed_version)
+            raise ArgumentError,
+              "Unsupported Oh My Pi CLI version #{version.inspect}; " \
+              "supported versions must satisfy #{SUPPORTED_CLI_REQUIREMENT}"
+          end
+
+          package = "#{CLI_PACKAGE}@#{version}".freeze
+          install_command_prefix = ["npm", "install", "-g", "--ignore-scripts"].freeze
+          install_command = (install_command_prefix + [package]).freeze
+          supported_versions = [version].freeze
+          version_requirement = SUPPORTED_CLI_REQUIREMENT.requirements
+            .map { |op, ver| "#{op} #{ver}".freeze }
+            .freeze
+
+          contract = {
+            source: :npm,
+            package: package,
+            package_name: CLI_PACKAGE,
+            version: version,
+            version_requirement: version_requirement,
+            binary_name: binary_name,
+            install_command_prefix: install_command_prefix,
+            install_command: install_command,
+            supported_versions: supported_versions,
+            runtime_requirements: [bun_runtime_contract]
+          }
+
+          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
+      end
+
+      def name
+        "omp"
+      end
+
+      def display_name
+        "Oh My Pi"
+      end
+
+      def configuration_schema
+        {
+          fields: [
+            {
+              name: :model,
+              type: :string,
+              label: "Model",
+              required: false,
+              hint: "Oh My Pi model pattern or ID passed to --model"
+            },
+            {
+              name: :provider,
+              type: :string,
+              label: "Provider",
+              required: false,
+              hint: "Oh My Pi provider name passed to --provider"
+            }
+          ],
+          auth_modes: %i[api_key oauth],
+          openai_compatible: false
+        }
+      end
+
+      def capabilities
+        {
+          streaming: false,
+          file_upload: true,
+          vision: true,
+          tool_use: true,
+          # Oh My Pi's non-interactive CLI currently exposes only text print mode.
+          # Keep JSON mode disabled until the CLI ships a structured output flag.
+          json_mode: false,
+          mcp: false,
+          dangerous_mode: false
+        }
+      end
+
+      def error_patterns
+        COMMON_ERROR_PATTERNS
+      end
+
+      def supports_tool_control?
+        true
+      end
+
+      def auth_type
+        :oauth
+      end
+
+      def execution_semantics
+        {
+          prompt_delivery: :flag,
+          output_format: :text,
+          sandbox_aware: false,
+          uses_subcommand: false,
+          non_interactive_flag: "-p",
+          legitimate_exit_codes: [0],
+          stderr_is_diagnostic: true,
+          parses_rate_limit_reset: false
+        }
+      end
+
+      protected
+
+      def build_command(prompt, options)
+        runtime = options[:provider_runtime]
+        provider = runtime&.api_provider || @config.provider
+        model = runtime&.model || @config.model
+
+        cmd = [self.class.binary_name, "--no-session"]
+        cmd += @config.default_flags if @config.default_flags&.any?
+        cmd += runtime.flags if runtime
+        cmd += ["--provider", provider] if provider
+        cmd += ["--model", model] if model
+        cmd << "--no-tools" if options[:tools] == :none
+        cmd += ["-p", prompt]
+
+        cmd
+      end
+
+      def default_timeout
+        300
+      end
+    end
+  end
+end

data/lib/agent_harness/providers/registry.rb

@@ -28,6 +28,7 @@ module AgentHarness
           aliases: [:copilot]
         },
         {name: :pi, require_path: "agent_harness/providers/pi", class_name: :Pi, aliases: []},
+        {name: :omp, require_path: "agent_harness/providers/omp", class_name: :OhMyPi, aliases: []},
         {name: :codex, require_path: "agent_harness/providers/codex", class_name: :Codex, aliases: []},
         {name: :opencode, require_path: "agent_harness/providers/opencode", class_name: :Opencode, aliases: []},
         {name: :kilocode, require_path: "agent_harness/providers/kilocode", class_name: :Kilocode, aliases: []},

data/lib/agent_harness/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: agent-harness
 version: !ruby/object:Gem::Version
-  version: 0.28.6
+  version: 0.29.0
 platform: ruby
 authors:
 - Bart Agapinan
@@ -134,6 +134,7 @@ files:
 - 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/omp.rb
 - lib/agent_harness/providers/opencode.rb
 - lib/agent_harness/providers/pi.rb
 - lib/agent_harness/providers/rate_limit_reset_parsing.rb