active_harness 0.2.41 → 0.3.0

data/lib/active_harness/tribunal.rb

@@ -11,19 +11,19 @@ module ActiveHarness
   #
   # Direct usage:
   #   tribunal = ActiveHarness::Tribunal.new(
-  #     input:   "Is this message toxic?",
-  #     context: { user_id: 42 },
-  #     agents:  [ToxicityAgent, BiasAgent, SpamAgent],
-  #     timeout: 7
+  #     input:    "Is this message toxic?",
+  #     context:  { user_id: 42 },
+  #     requests: [ToxicityRequest, BiasRequest, SpamRequest],
+  #     timeout:  7
   #   )
-  #   tribunal.on(:after_agent) { |result| puts result.model }
+  #   tribunal.on(:after_request) { |result| puts result.model }
   #   tribunal.process { |results| results.all? { |r| r.processed["result"] == true } }
   #   tribunal.call
   #
   # Subclass with DSL:
   #   class ContentQualityTribunal < ActiveHarness::Tribunal
-  #     agents PolitenessAgent, ConstructivenessAgent
-  #     on(:after_agent) { |result| puts result.model }
+  #     requests PolitenessRequest, ConstructivenessRequest
+  #     on(:after_request) { |result| puts result.model }
   #     process { |results| results.all? { |r| r.processed["result"] == true } }
   #   end
   #   ContentQualityTribunal.new(input: "...").call
@@ -35,11 +35,11 @@ module ActiveHarness
     class << self
       # Each subclass gets its own isolated config hash.
       def tribunal_config
-        @tribunal_config ||= { agents: [], hooks: {} }
+        @tribunal_config ||= { requests: [], hooks: {} }
       end
 
       def inherited(subclass)
-        subclass.instance_variable_set(:@tribunal_config, { agents: [], hooks: {} })
+        subclass.instance_variable_set(:@tribunal_config, { requests: [], hooks: {} })
       end
     end
 
@@ -54,7 +54,7 @@ module ActiveHarness
                   :errors,
                   :verdict,
                   :execution_time,
-                  :agent_execution_times,
+                  :request_execution_times,
                   :token,
                   :stream
 
@@ -63,7 +63,7 @@ module ActiveHarness
       context:  {},
       params:   {},
       memory:   nil,
-      agents:   nil,
+      requests: nil,
       timeout:  7,
       token:    nil,
       stream:   nil,
@@ -71,28 +71,28 @@ module ActiveHarness
     )
       config = self.class.tribunal_config
 
-      @input                 = input
-      @context               = context
-      @params                = params
-      @memory                = memory
-      @agents                = agents || config[:agents]
-      @timeout               = timeout
-      @process_block         = config[:process]
-      @strategy              = config[:strategy]
-      @evaluate_block        = config[:evaluate_block]
-      @may_fail              = may_fail == :_unset ? config[:may_fail] : may_fail
-      @hooks                 = config[:hooks].transform_values { |v| Array(v).dup }
-      @token                 = token
-      @stream                = stream
-      @results               = []
-      @errors                = []
-      @verdict               = nil
-      @execution_time        = nil
-      @agent_execution_times = []
+      @input                   = input
+      @context                 = context
+      @params                  = params
+      @memory                  = memory
+      @requests                = requests || config[:requests]
+      @timeout                 = timeout
+      @process_block           = config[:process]
+      @strategy                = config[:strategy]
+      @evaluate_block          = config[:evaluate_block]
+      @may_fail                = may_fail == :_unset ? config[:may_fail] : may_fail
+      @hooks                   = config[:hooks].transform_values { |v| Array(v).dup }
+      @token                   = token
+      @stream                  = stream
+      @results                 = []
+      @errors                  = []
+      @verdict                 = nil
+      @execution_time          = nil
+      @request_execution_times = []
     end
 
     # Returns a Result with processed: { "verdict" => @verdict } so the pipeline
-    # can handle agents and tribunals through the same interface.
+    # can handle requests and tribunals through the same interface.
     def result
       Result.new(
         input:          @input,
@@ -102,55 +102,55 @@ module ActiveHarness
       )
     end
 
-    # Run all agents in parallel, then compute the verdict.
+    # Run all requests in parallel, then compute the verdict.
     # Returns self so calls can be chained: tribunal.call.verdict
     #
     # Accepts an optional input to update payload before running — matches
-    # the Agent#call(input) interface so tribunals work as pipeline executors.
+    # the Request#call(input) interface so tribunals work as pipeline executors.
     #
     # Behaviour on failure:
-    #   - If some agents fail/timeout, their errors are in #errors and
+    #   - If some requests fail/timeout, their errors are in #errors and
     #     #results contains only successful results.
-    #   - If ALL agents fail/timeout, raises Errors::AllAgentsFailed.
+    #   - If ALL requests fail/timeout, raises Errors::AllRequestsFailed.
     def call(input = nil, token: nil, stream: nil)
       @input  = input  if input
       @token  = token  if token
       @stream = stream if stream
-      agents = resolve_agents
+      requests = resolve_requests
       fire(:before_call)
 
       started_at = Process.clock_gettime(Process::CLOCK_MONOTONIC)
 
-      futures = agents.each_with_index.map do |agent, index|
-        fire(:before_agent, agent, index)
+      futures = requests.each_with_index.map do |request, index|
+        fire(:before_request, request, index)
         t0 = Process.clock_gettime(Process::CLOCK_MONOTONIC)
-        future = Concurrent::Future.execute { agent.call }
+        future = Concurrent::Future.execute { request.call }
         [future, t0]
       end
 
-      @results               = []
-      @errors                = []
-      @agent_execution_times = []
+      @results                 = []
+      @errors                  = []
+      @request_execution_times = []
 
       futures.each_with_index do |(future, t0), index|
         future.wait(@timeout)
         elapsed = (Process.clock_gettime(Process::CLOCK_MONOTONIC) - t0).round(3)
-        @agent_execution_times << { agent: agents[index].class.name, time: elapsed }
+        @request_execution_times << { request: requests[index].class.name, time: elapsed }
 
         if future.fulfilled?
           value  = future.value
-          result = value.is_a?(ActiveHarness::Agent) ? value.result : value
+          result = value.is_a?(ActiveHarness::Request) ? value.result : value
           @results << result
-          fire(:after_agent, result, index)
+          fire(:after_request, result, index)
         elsif future.incomplete?
           error = Errors::TimeoutError.new(
-            "Agent #{agents[index].class.name} timed out after #{@timeout}s"
+            "Request #{requests[index].class.name} timed out after #{@timeout}s"
           )
-          @errors << { agent: agents[index].class.name, error: error }
-          fire(:agent_error, agents[index].class.name, error, index)
+          @errors << { request: requests[index].class.name, error: error }
+          fire(:request_error, requests[index].class.name, error, index)
         else
-          @errors << { agent: agents[index].class.name, error: future.reason }
-          fire(:agent_error, agents[index].class.name, future.reason, index)
+          @errors << { request: requests[index].class.name, error: future.reason }
+          fire(:request_error, requests[index].class.name, future.reason, index)
         end
       end
 
@@ -158,7 +158,7 @@ module ActiveHarness
 
       fire(:after_call, @results, @errors)
 
-      # If all agents failed, raise an exception.
+      # If all requests failed, raise an exception.
       # Otherwise, compute the verdict based on successful results.
       check_failure_threshold!
 
@@ -174,26 +174,26 @@ module ActiveHarness
 
     def check_failure_threshold!
       if !@may_fail.nil? && @errors.size > @may_fail
-        raise Errors::AllAgentsFailed,
-          "Too many agents failed (#{@errors.size} > may_fail: #{@may_fail}) — #{error_summary}"
+        raise Errors::AllRequestsFailed,
+          "Too many requests failed (#{@errors.size} > may_fail: #{@may_fail}) — #{error_summary}"
       elsif @results.empty?
-        raise Errors::AllAgentsFailed, "All agents failed — #{error_summary}"
+        raise Errors::AllRequestsFailed, "All requests failed — #{error_summary}"
       end
     end
 
     def error_summary
-      @errors.map { |e| "#{e[:agent]}: #{e[:error].message}" }.join("; ")
+      @errors.map { |e| "#{e[:request]}: #{e[:error].message}" }.join("; ")
     end
 
-    def resolve_agents
-      @agents.map do |agent|
-        if agent.is_a?(Class)
-          agent.new(input: @input, context: @context.dup, params: @params, token: @token, stream: @stream)
+    def resolve_requests
+      @requests.map do |request|
+        if request.is_a?(Class)
+          request.new(input: @input, context: @context.dup, params: @params, token: @token, stream: @stream)
         else
-          agent.input = @input if @input
-          agent.instance_variable_set(:@token,  @token)  if @token
-          agent.instance_variable_set(:@stream, @stream) if @stream
-          agent
+          request.input = @input if @input
+          request.instance_variable_set(:@token,  @token)  if @token
+          request.instance_variable_set(:@stream, @stream) if @stream
+          request
         end
       end
     end

data/lib/active_harness.rb

@@ -23,17 +23,18 @@ require_relative "active_harness/providers/vertexai"
 require_relative "active_harness/providers/custom"
 require_relative "active_harness/providers/images/openai"
 require_relative "active_harness/providers/images/openrouter"
+require_relative "active_harness/providers/audio/openai"
 require_relative "active_harness/providers/audio/openrouter"
 require "active_harness_pricing"
 require_relative "active_harness/memory"
-require_relative "active_harness/agent"
+require_relative "active_harness/request"
 require_relative "active_harness/tribunal"
 require_relative "active_harness/pipeline"
 
 require_relative "active_harness/railtie" if defined?(Rails::Railtie)
 
 module ActiveHarness
-  VERSION = "0.2.41"
+  VERSION = "0.3.0"
 
   class << self
     # Configure ActiveHarness.

data/lib/generators/active_harness/install/install_generator.rb

@@ -7,7 +7,7 @@ module ActiveHarness
 
       source_root File.expand_path("templates", __dir__)
 
-      APP_AI_DIRS = %w[agents prompts tribunals pipelines memory].freeze
+      APP_AI_DIRS = %w[requests prompts tribunals pipelines memory].freeze
 
       def create_structure
         APP_AI_DIRS.each do |dir|

data/lib/generators/active_harness/install/templates/controllers/ai_controller.rb

@@ -8,7 +8,7 @@ class AiSupportController < ApplicationController
   # body: { input: "What is your return policy?" }
   # ---------------------------------------------------------------------------
   def agent
-    result = SupportAgent.call(input: params.require(:input))
+    result = SupportRequest.call(input: params.require(:input))
 
     render json: {
       output: result.output,
@@ -26,7 +26,7 @@ class AiSupportController < ApplicationController
   # ---------------------------------------------------------------------------
   def agent_memory
     memory = AppMemory.new(session_id: params.require(:session_id))
-    result = SupportAgent.call(input: params.require(:input), memory: memory)
+    result = SupportRequest.call(input: params.require(:input), memory: memory)
 
     render json: {
       output: result.output,
@@ -94,7 +94,7 @@ class AiSupportController < ApplicationController
 
     sse = ActionController::Live::SSE.new(response.stream, event: "message")
 
-    SupportAgent.call(
+    SupportRequest.call(
       input:  input,
       stream: ->(token) { sse.write({ token: token }.to_json) }
     )

data/lib/generators/active_harness/install/templates/initializers/active_harness.rb

@@ -74,7 +74,7 @@ ActiveHarness.configure do |config|
 
   # ---------------------------------------------------------------------------
   # Azure OpenAI Service
-  # The `model:` in your agent config is the deployment name, not the model name.
+  # The `model:` in your request config is the deployment name, not the model name.
   # ---------------------------------------------------------------------------
   # config.azure_api_base      = ENV["AZURE_API_BASE"]    # "https://my-resource.openai.azure.com"
   # config.azure_api_key       = ENV["AZURE_API_KEY"]     # resource API key (preferred)
@@ -92,7 +92,7 @@ ActiveHarness.configure do |config|
   # config.custom["VLLMServer"]["url"]     = "http://gpu-server:8000/v1/chat/completions"
   # config.custom["VLLMServer"]["api_key"] = ENV["VLLM_API_KEY"]
   #
-  # Use in an agent:
+  # Use in a request:
   #   model do
   #     use      provider: :custom, name: "MyLocal",    model: "llama3.2"
   #     fallback provider: :custom, name: "VLLMServer", model: "mixtral"

data/lib/generators/active_harness/install/templates/pipelines/support_pipeline.rb

@@ -1,5 +1,5 @@
 require_relative "../tribunals/support_guard_tribunal"
-require_relative "../agents/support_agent"
+require_relative "../requests/support_request"
 
 # Two-step pipeline: spam guard → answer.
 # Add more steps between them as needed.
@@ -11,7 +11,7 @@ class SupportPipeline < ActiveHarness::Pipeline
   end
 
   # Step 2 — RESPOND: generate the actual answer
-  step :respond, SupportAgent
+  step :respond, SupportRequest
 
   before :step do |step_name, _payload|
     puts "[pipeline] → :#{step_name}"

data/lib/generators/active_harness/install/templates/{agents/support_guard_agent.rb → requests/support_guard_request.rb}

@@ -1,6 +1,6 @@
 require_relative "../prompts/support_guard_prompt"
 
-class SupportGuardAgent < ActiveHarness::Agent
+class SupportGuardRequest < ActiveHarness::Request
   system_prompt SupportGuardPrompt
   format :json
 

data/lib/generators/active_harness/install/templates/{agents/support_agent.rb → requests/support_request.rb}

@@ -1,6 +1,6 @@
 require_relative "../prompts/support_prompt"
 
-class SupportAgent < ActiveHarness::Agent
+class SupportRequest < ActiveHarness::Request
   system_prompt SupportPrompt
 
   model do

data/lib/generators/active_harness/install/templates/tribunals/support_guard_tribunal.rb

@@ -1,9 +1,9 @@
-require_relative "../agents/support_guard_agent"
+require_relative "../requests/support_guard_request"
 
-# Runs SupportGuardAgent in parallel (single agent here, extendable).
+# Runs SupportGuardRequest in parallel (single request here, extendable).
 # Verdict is true (safe) when no spam is detected.
 class SupportGuardTribunal < ActiveHarness::Tribunal
-  agents SupportGuardAgent
+  requests SupportGuardRequest
 
   process do |results|
     results.none? { |r| r.processed["spam"] == true }

data/lib/generators/active_harness/pipeline/templates/pipeline.rb.tt

@@ -1,5 +1,5 @@
 class <%= class_name %>Pipeline < ActiveHarness::Pipeline
-  step :respond, <%= class_name %>Agent
+  step :respond, <%= class_name %>Request
 
   before :step do |step_name, _payload|
     puts "[pipeline] → :#{step_name}"

data/lib/generators/active_harness/request/request_generator.rb

@@ -0,0 +1,16 @@
+require "rails/generators"
+
+module ActiveHarness
+  module Generators
+    class RequestGenerator < Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Creates an ActiveHarness request in app/ai/requests/"
+
+      def create_request
+        template "request.rb.tt",
+                 "app/ai/requests/#{file_name}_request.rb"
+      end
+    end
+  end
+end

data/lib/generators/active_harness/{agent/templates/agent.rb.tt → request/templates/request.rb.tt}

@@ -1,4 +1,4 @@
-class <%= class_name %>Agent < ActiveHarness::Agent
+class <%= class_name %>Request < ActiveHarness::Request
   system_prompt <%= class_name %>Prompt
 
   model do

data/lib/generators/active_harness/tribunal/templates/tribunal.rb.tt

@@ -1,5 +1,5 @@
 class <%= class_name %>Tribunal < ActiveHarness::Tribunal
-  agents <%= class_name %>Agent
+  requests <%= class_name %>Request
 
   process do |results|
     results.all? { |r| r.processed["result"] == true }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_harness
 version: !ruby/object:Gem::Version
-  version: 0.2.41
+  version: 0.3.0
 platform: ruby
 authors:
 - the-teacher
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-07-19 00:00:00.000000000 Z
+date: 2026-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -46,16 +46,6 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/active_harness.rb
-- lib/active_harness/agent.rb
-- lib/active_harness/agent/cost.rb
-- lib/active_harness/agent/custom_llm_backend.rb
-- lib/active_harness/agent/hooks.rb
-- lib/active_harness/agent/image.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/agent/transcription.rb
 - lib/active_harness/configuration.rb
 - lib/active_harness/core/errors.rb
 - lib/active_harness/core/hooks.rb
@@ -73,6 +63,7 @@ files:
 - lib/active_harness/pipeline/step.rb
 - lib/active_harness/providers/PROVIDER_CONTRACT.md
 - lib/active_harness/providers/anthropic.rb
+- lib/active_harness/providers/audio/openai.rb
 - lib/active_harness/providers/audio/openrouter.rb
 - lib/active_harness/providers/azure.rb
 - lib/active_harness/providers/base.rb
@@ -92,22 +83,30 @@ files:
 - lib/active_harness/providers/vertexai.rb
 - lib/active_harness/providers/xai.rb
 - lib/active_harness/railtie.rb
+- lib/active_harness/request.rb
+- lib/active_harness/request/cost.rb
+- lib/active_harness/request/custom_llm_backend.rb
+- lib/active_harness/request/hooks.rb
+- lib/active_harness/request/image.rb
+- lib/active_harness/request/models.rb
+- lib/active_harness/request/output_parser.rb
+- lib/active_harness/request/prompt.rb
+- lib/active_harness/request/providers.rb
+- lib/active_harness/request/transcription.rb
 - lib/active_harness/result.rb
 - lib/active_harness/tribunal.rb
 - lib/active_harness/tribunal/dsl.rb
 - lib/active_harness/tribunal/hooks.rb
 - lib/active_harness/tribunal/processing.rb
-- lib/generators/active_harness/agent/agent_generator.rb
-- lib/generators/active_harness/agent/templates/agent.rb.tt
 - lib/generators/active_harness/install/install_generator.rb
-- lib/generators/active_harness/install/templates/agents/support_agent.rb
-- lib/generators/active_harness/install/templates/agents/support_guard_agent.rb
 - lib/generators/active_harness/install/templates/controllers/ai_controller.rb
 - lib/generators/active_harness/install/templates/initializers/active_harness.rb
 - lib/generators/active_harness/install/templates/memory/app_memory.rb
 - lib/generators/active_harness/install/templates/pipelines/support_pipeline.rb
 - lib/generators/active_harness/install/templates/prompts/support_guard_prompt.rb
 - lib/generators/active_harness/install/templates/prompts/support_prompt.rb
+- lib/generators/active_harness/install/templates/requests/support_guard_request.rb
+- lib/generators/active_harness/install/templates/requests/support_request.rb
 - lib/generators/active_harness/install/templates/tribunals/support_guard_tribunal.rb
 - lib/generators/active_harness/memory/memory_generator.rb
 - lib/generators/active_harness/memory/templates/memory.rb.tt
@@ -119,6 +118,8 @@ files:
 - lib/generators/active_harness/pipeline/templates/pipeline.rb.tt
 - lib/generators/active_harness/prompt/prompt_generator.rb
 - lib/generators/active_harness/prompt/templates/prompt.rb.tt
+- lib/generators/active_harness/request/request_generator.rb
+- lib/generators/active_harness/request/templates/request.rb.tt
 - lib/generators/active_harness/tribunal/templates/tribunal.rb.tt
 - lib/generators/active_harness/tribunal/tribunal_generator.rb
 homepage: https://github.com/the-teacher/active_harness
@@ -143,5 +144,5 @@ requirements: []
 rubygems_version: 3.0.3.1
 signing_key: 
 specification_version: 4
-summary: DSL for describing and running AI agents with safety layers
+summary: DSL for describing and running resilient LLM requests with safety layers
 test_files: []

data/lib/generators/active_harness/agent/agent_generator.rb

@@ -1,16 +0,0 @@
-require "rails/generators"
-
-module ActiveHarness
-  module Generators
-    class AgentGenerator < Rails::Generators::NamedBase
-      source_root File.expand_path("templates", __dir__)
-
-      desc "Creates an ActiveHarness agent in app/ai/agents/"
-
-      def create_agent
-        template "agent.rb.tt",
-                 "app/ai/agents/#{file_name}_agent.rb"
-      end
-    end
-  end
-end