active_harness 0.1.0 → 0.2.0

metadata

@@ -1,110 +1,70 @@
 --- !ruby/object:Gem::Specification
 name: active_harness
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - the-teacher
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-05-06 00:00:00.000000000 Z
+date: 2026-05-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: json
+  name: concurrent-ruby
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
-- !ruby/object:Gem::Dependency
-  name: minitest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-- !ruby/object:Gem::Dependency
-  name: minitest-reporters
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: mocha
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-description: |
-  ActiveHarness provides a DSL for describing AI agents and an engine for
-  their execution, with built-in prompt-injection protection (guard layer),
-  provider fallback chains, and a structured result API.
+        version: '1.3'
+description: 
 email:
 - the-teacher@github.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- LICENSE
-- README.md
 - lib/active_harness.rb
 - lib/active_harness/agent.rb
-- lib/active_harness/core/configuration.rb
+- lib/active_harness/agent/hooks.rb
+- lib/active_harness/agent/models.rb
+- lib/active_harness/agent/output_parser.rb
+- lib/active_harness/agent/prompt.rb
+- lib/active_harness/agent/providers.rb
 - lib/active_harness/core/errors.rb
-- lib/active_harness/core/version.rb
 - lib/active_harness/http/client.rb
-- lib/active_harness/http/retry_policy.rb
-- lib/active_harness/models/model_request.rb
-- lib/active_harness/models/model_response.rb
-- lib/active_harness/payload.rb
-- lib/active_harness/pipeline/engine.rb
-- lib/active_harness/pipeline/fallback_runner.rb
-- lib/active_harness/pipeline/guard_runner.rb
-- lib/active_harness/pipeline/output_parser.rb
-- lib/active_harness/pipeline/prompt_builder.rb
-- lib/active_harness/pipeline/provider_registry.rb
-- lib/active_harness/prompts/guard_system_prompt.rb
+- lib/active_harness/http/streaming_client.rb
+- lib/active_harness/memory.rb
+- lib/active_harness/memory/adapter/base.rb
+- lib/active_harness/memory/adapter/file.rb
+- lib/active_harness/pipeline.rb
+- lib/active_harness/pipeline/step.rb
+- lib/active_harness/providers/PROVIDER_CONTRACT.md
 - lib/active_harness/providers/anthropic.rb
 - lib/active_harness/providers/base.rb
-- lib/active_harness/providers/google.rb
+- lib/active_harness/providers/gemini.rb
+- lib/active_harness/providers/groq.rb
 - lib/active_harness/providers/openai.rb
 - lib/active_harness/providers/openrouter.rb
-- lib/active_harness/rate_limit/request_limiter.rb
-- lib/active_harness/rate_limit/risk_holdback.rb
-- lib/active_harness/results/debug_result.rb
-- lib/active_harness/results/input_result.rb
-- lib/active_harness/results/result.rb
+- lib/active_harness/railtie.rb
+- lib/active_harness/result.rb
+- lib/active_harness/tribunal.rb
+- lib/generators/active_harness/install/install_generator.rb
+- lib/generators/active_harness/install/templates/agents/test_support_agent.rb
+- lib/generators/active_harness/install/templates/agents/test_support_guard_agent.rb
+- lib/generators/active_harness/install/templates/controllers/ai_controller.rb
+- lib/generators/active_harness/install/templates/memory/test_support_memory.rb
+- lib/generators/active_harness/install/templates/pipelines/test_support_pipeline.rb
+- lib/generators/active_harness/install/templates/prompts/test_support_guard_prompt.rb
+- lib/generators/active_harness/install/templates/prompts/test_support_prompt.rb
+- lib/generators/active_harness/install/templates/tribunals/test_support_guard_tribunal.rb
 homepage: https://github.com/the-teacher/active_harness
 licenses:
 - MIT

data/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 the-teacher
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

data/README.md

@@ -1,113 +0,0 @@
-# ActiveHarness
-
-ActiveHarness is a lightweight framework for building production-ready AI agents in Ruby and Rails.
-
-Instead of relying on complex orchestration frameworks, ActiveHarness provides a simple and transparent DSL to define agents as plain Ruby classes.
-
-## Features
-
-- Agent-based architecture (Rails-style DSL)
-- Built-in guard layer (prompt injection, toxicity, relevance checks)
-- Multi-provider support: OpenAI, Anthropic, Google, OpenRouter
-- Automatic fallback between models and providers
-- Per-call language and translation support
-- Structured outputs (text / JSON with schema validation)
-- Input constraints (e.g. `max_input_length`)
-- Debug mode with full prompt visibility
-- Minimal dependencies, no magic
-
-## Installation
-
-```ruby
-# Gemfile
-gem "active_harness"
-```
-
-```bash
-bundle install
-```
-
-Or install directly:
-
-```bash
-gem install active_harness
-```
-
-## Quick Start
-
-### 1. Configure
-
-```ruby
-ActiveHarness.configure do |config|
-  config.openai_api_key      = ENV["OPENAI_API_KEY"]
-  config.openrouter_api_key  = ENV["OPENROUTER_API_KEY"]
-  config.default_temperature = 0.2
-  config.default_timeout     = 30
-end
-```
-
-### 2. Define an agent
-
-```ruby
-class SupportAgent < ActiveHarness::Agent
-  guard InjectionGuard
-
-  model do
-    use      provider: :openai,     model: "gpt-4.1-mini"
-    fallback provider: :openrouter, model: "meta-llama/llama-3.3-70b-instruct:free"
-  end
-
-  system_prompt "You are a helpful support assistant."
-  output :text
-end
-```
-
-### 3. Call it
-
-```ruby
-# One-liner
-result = SupportAgent.call(input: "How do I get started?")
-
-# Instance style
-agent  = SupportAgent.new(input: "How do I get started?", language: :ru)
-result = agent.call
-
-puts result.output  if result.success?
-puts result.output  if result.blocked?   # default_error_answer
-```
-
-## Guards
-
-Guards run before the main request and can block it:
-
-```ruby
-class InjectionGuard < ActiveHarness::Agent
-  model { use provider: :openai, model: "gpt-4.1-mini" }
-  system_language :en
-  risk_tolerance  :low
-end
-
-# Register on the main agent:
-guard InjectionGuard, name: :injection_guard
-guard ToxicityGuard,  name: :toxicity_guard
-```
-
-## Result API
-
-```ruby
-result.success?   # true / false
-result.blocked?   # true / false  (guard rejected)
-result.failed?    # true / false  (error / timeout)
-result.output     # String
-result.model      # "gpt-4.1-mini"
-result.provider   # :openai
-```
-
-## Requirements
-
-- Ruby >= 2.6
-- API key for at least one supported provider (OpenAI, Anthropic, Google, OpenRouter)
-
-## License
-
-MIT — see [LICENSE](LICENSE).

data/lib/active_harness/core/configuration.rb

@@ -1,55 +0,0 @@
-module ActiveHarness
-  class Configuration
-    attr_accessor :openai_api_key,
-                  :openrouter_api_key,
-                  :anthropic_api_key,
-                  :google_api_key,
-                  :default_timeout,
-                  :default_temperature,
-                  :default_language,
-                  :guard_retries,
-                  :log_requests,
-                  :log_responses,
-                  :debug,
-                  :on_model_attempt,
-                  :on_model_failure
-
-    def initialize
-      @openai_api_key      = ENV["OPENAI_API_KEY"]
-      @openrouter_api_key  = ENV["OPENROUTER_API_KEY"]
-      @anthropic_api_key   = ENV["ANTHROPIC_API_KEY"]
-      @google_api_key      = ENV["GOOGLE_API_KEY"]
-
-      @default_timeout     = 20
-      @default_temperature = 0.2
-      @default_language    = :en
-      @guard_retries       = 2   # up to 3 total attempts (1 initial + 2 retries)
-
-      @log_requests  = true
-      @log_responses = false
-      @debug         = false
-    end
-
-    # HTTP transport. Swap for a Faraday-backed client if needed:
-    #   config.http_client = MyFaradayClient.new
-    # Set to nil to let providers manage their own transport.
-    def http_client
-      @http_client ||= Http::Client.new
-    end
-    attr_writer :http_client
-
-    # Sliding-window rate limiter (10 req/min per user_id by default).
-    # Set to nil to disable.
-    def request_limiter
-      @request_limiter ||= RateLimit::RequestLimiter.new
-    end
-    attr_writer :request_limiter
-
-    # Progressive hold-back after repeated risky requests.
-    # Set to nil to disable.
-    def risk_holdback
-      @risk_holdback ||= RateLimit::RiskHoldback.new
-    end
-    attr_writer :risk_holdback
-  end
-end

data/lib/active_harness/core/version.rb

@@ -1,3 +0,0 @@
-module ActiveHarness
-  VERSION = "0.1.0"
-end

data/lib/active_harness/http/retry_policy.rb

@@ -1,47 +0,0 @@
-module ActiveHarness
-  module Http
-    # Wraps a block with automatic retry on transient errors.
-    # Uses exponential backoff: delay doubles after each failed attempt.
-    #
-    # Example:
-    #   RetryPolicy.new(max_attempts: 3, base_delay: 0.5).run do
-    #     http_client.post(...)
-    #   end
-    #
-    # Custom errors:
-    #   RetryPolicy.new(errors: [MyTransientError]).run { ... }
-    #
-    class RetryPolicy
-      DEFAULT_ERRORS = [
-        Errors::TimeoutError,
-        Errors::RateLimitError,
-        Errors::ProviderUnavailableError,
-        Errors::ServerError
-      ].freeze
-
-      # @param max_attempts [Integer]  total number of attempts (first + retries)
-      # @param base_delay   [Float]    delay before 1st retry in seconds; doubles each round
-      # @param errors       [Array]    error classes that trigger a retry
-      def initialize(max_attempts: 3, base_delay: 1.0, errors: DEFAULT_ERRORS)
-        @max_attempts = max_attempts
-        @base_delay   = base_delay
-        @errors       = errors
-      end
-
-      # @yieldreturn [Object] result of the block on success
-      # @raise last error after all attempts are exhausted
-      def run
-        attempt = 0
-        begin
-          attempt += 1
-          yield
-        rescue *@errors
-          raise if attempt >= @max_attempts
-
-          sleep(@base_delay * (2**(attempt - 1)))
-          retry
-        end
-      end
-    end
-  end
-end

data/lib/active_harness/models/model_request.rb

@@ -1,14 +0,0 @@
-module ActiveHarness
-  class ModelRequest
-    attr_reader :provider, :model, :messages, :temperature, :timeout, :response_format
-
-    def initialize(provider:, model:, messages:, temperature: nil, timeout: nil, response_format: nil)
-      @provider        = provider
-      @model           = model
-      @messages        = messages
-      @temperature     = temperature || ActiveHarness.config.default_temperature
-      @timeout         = timeout     || ActiveHarness.config.default_timeout
-      @response_format = response_format
-    end
-  end
-end

data/lib/active_harness/models/model_response.rb

@@ -1,13 +0,0 @@
-module ActiveHarness
-  class ModelResponse
-    attr_reader :content, :provider, :model, :usage, :raw
-
-    def initialize(content:, provider:, model:, usage: {}, raw: nil)
-      @content  = content
-      @provider = provider
-      @model    = model
-      @usage    = usage
-      @raw      = raw
-    end
-  end
-end

data/lib/active_harness/payload.rb

@@ -1,47 +0,0 @@
-module ActiveHarness
-  # Unified request context — the single object available in every hook.
-  #
-  # Passed as the first argument to ALL before/after callbacks and to +setup+:
-  #
-  #   setup do |payload|
-  #     payload.meta[:started_at] = Time.now
-  #     payload                               # must return payload
-  #   end
-  #
-  #   before :guards do |payload, input|      # input = String
-  #     input.strip                           # return new String
-  #   end
-  #
-  #   after  :guards do |payload, result|     # result = InputResult
-  #     result                                # return InputResult
-  #   end
-  #
-  #   before :request do |payload, prompt|    # prompt = { system:, user: }
-  #     prompt                                # return Hash
-  #   end
-  #
-  #   after  :request do |payload, response|  # response = ModelResponse
-  #     response                              # return ModelResponse
-  #   end
-  #
-  # Fields:
-  #   input     — raw input text; can be modified in +setup+
-  #   context   — runtime context Hash (e.g. user_id, session data)
-  #   language  — language hint for guards / responses (e.g. :ru, :en)
-  #   translate — callable: translate.(key) → localized string; key format: "scope.agent.message"
-  #               typically built by an I18n module: Playground::I18n.translator(locale: language)
-  #   options   — per-guard static options set at registration time
-  #   meta      — free-form Hash for user-defined data (timestamps, flags, …)
-  class Payload
-    attr_accessor :input, :context, :language, :translate, :options, :meta
-
-    def initialize(input:, context: {}, language: nil, translate: nil, options: {}, meta: {})
-      @input     = input
-      @context   = context
-      @language  = language
-      @translate = translate
-      @options   = options
-      @meta      = meta
-    end
-  end
-end