active_harness 0.2.41 → 0.3.0

data/lib/active_harness/{agent → request}/custom_llm_backend.rb

@@ -1,9 +1,9 @@
 module ActiveHarness
-  class Agent
+  class Request
     # -------------------------------------------------------------------------
     # Custom LLM backend DSL
     #
-    # Allows an agent to delegate HTTP calls to any LLM client (e.g. `ruby_llm`)
+    # Allows a request to delegate HTTP calls to any LLM client (e.g. `ruby_llm`)
     # instead of ActiveHarness's built-in Net::HTTP providers.
     #
     # Usage:
@@ -31,9 +31,9 @@ module ActiveHarness
     BackendParams = Struct.new(:model, :provider, :temperature, keyword_init: true)
 
     class << self
-      # Define the custom LLM backend block for this agent class.
+      # Define the custom LLM backend block for this request class.
       def custom_llm_backend(&block)
-        agent_config[:custom_llm_backend] = block
+        request_config[:custom_llm_backend] = block
       end
     end
 

data/lib/active_harness/{agent → request}/hooks.rb

@@ -1,5 +1,5 @@
 module ActiveHarness
-  class Agent
+  class Request
     VALID_HOOKS = %i[
       setup
       before_call
@@ -31,8 +31,8 @@ module ActiveHarness
           raise ArgumentError, "Unknown hook :#{event}. Valid hooks: #{VALID_HOOKS.map { |h| ":#{h}" }.join(", ")}"
         end
 
-        agent_config[:hooks] ||= {}
-        (agent_config[:hooks][event] ||= []) << block
+        request_config[:hooks] ||= {}
+        (request_config[:hooks][event] ||= []) << block
       end
 
       # Rails-style aliases for +on+:
@@ -69,7 +69,7 @@ module ActiveHarness
 
     def fire(event, *args)
       run_hook(event, *args)
-      @stream&.call(:agent, event, *args)
+      @stream&.call(:request, event, *args)
     rescue IOError, ActionController::Live::ClientDisconnected
     end
   end

data/lib/active_harness/{agent → request}/image.rb

@@ -1,14 +1,14 @@
 module ActiveHarness
-  class Agent
+  class Request
     class << self
-      # Mark this agent as an image generation agent.
+      # Mark this request as an image generation request.
       #
-      #   class ImageAgent < ActiveHarness::Agent
+      #   class ImageRequest < ActiveHarness::Request
       #     image true
       #     size  "1024x1024"
       #
       #     # Optional: base style/formatting guidance, prepended to @input
-      #     # to form the final image prompt (see Agent#build_image_prompt).
+      #     # to form the final image prompt (see Request#build_image_prompt).
       #     system_prompt "Watercolor style, soft pastel colors, no text overlays."
       #
       #     model do
@@ -20,13 +20,13 @@ module ActiveHarness
       # result.output   — base64 string or data-URI (provider-dependent)
       # result.processed — same as output (format :text default)
       def image(value = true)
-        agent_config[:image] = value
+        request_config[:image] = value
       end
 
-      # Default image size for all models in this agent's chain.
+      # Default image size for all models in this request's chain.
       # Can be overridden per-model via:  use provider: :openai, model: "...", size: "1024x1792"
       def size(default_size)
-        agent_config[:image_size] = default_size
+        request_config[:image_size] = default_size
       end
     end
 

data/lib/active_harness/{agent → request}/models.rb

@@ -1,5 +1,5 @@
 module ActiveHarness
-  class Agent
+  class Request
     class << self
       # Array-style model list:
       #
@@ -8,10 +8,10 @@ module ActiveHarness
       #     { provider: :openrouter, model: "mistralai/mistral-nemo" }
       #   ]
       def models(list)
-        agent_config[:models] = Array(list)
+        request_config[:models] = Array(list)
       end
 
-      # Output format for this agent.
+      # Output format for this request.
       #
       #   format :text   # default — output is returned as-is
       #   format :json   # output is parsed; result.processed is a Ruby Hash/Array
@@ -20,7 +20,7 @@ module ActiveHarness
           raise ArgumentError, "Unknown format :#{type}. Valid values: :text, :json"
         end
 
-        agent_config[:format] = type
+        request_config[:format] = type
       end
 
       # Block-based model DSL:
@@ -32,16 +32,16 @@ module ActiveHarness
       def model(&block)
         config = ModelConfig.new
         config.instance_eval(&block)
-        agent_config[:model] = config.to_h
+        request_config[:model] = config.to_h
       end
     end
 
-    # Public instance API — returns a ModelList proxy for this agent instance.
+    # Public instance API — returns a ModelList proxy for this request instance.
     #
-    # Allows adding models at runtime before calling the agent:
+    # Allows adding models at runtime before calling the request:
     #
-    #   agent.models.prepend([{ provider: :openrouter, model: "..." }])
-    #   agent.models.push([{ provider: :openrouter, model: "..." }])
+    #   request.models.prepend([{ provider: :openrouter, model: "..." }])
+    #   request.models.push([{ provider: :openrouter, model: "..." }])
     #
     # Any prepended/pushed models are combined with the class-defined chain:
     #   [prepended...] + [class chain / constructor override] + [pushed...]
@@ -69,7 +69,7 @@ module ActiveHarness
   end
 
   # ---------------------------------------------------------------------------
-  # ModelList — mutable proxy returned by agent.models
+  # ModelList — mutable proxy returned by request.models
   # ---------------------------------------------------------------------------
   class ModelList
     def initialize(base_models)
@@ -93,7 +93,7 @@ module ActiveHarness
 
     # Replace the entire chain, discarding prepended/appended too.
     #
-    #   agent.models.replace([{ provider: :openrouter, model: "..." }])
+    #   request.models.replace([{ provider: :openrouter, model: "..." }])
     def replace(models)
       @base      = Array(models)
       @prepended = []
@@ -104,9 +104,9 @@ module ActiveHarness
     # Insert a single model entry at an arbitrary position in the final chain.
     # Position 0 is the same as prepend; -1 appends after the last element.
     #
-    #   agent.models.insert(0,  { provider: :openrouter, model: "fast-model" })
-    #   agent.models.insert(2,  { provider: :openrouter, model: "mid-model" })
-    #   agent.models.insert(-1, { provider: :openrouter, model: "last-resort" })
+    #   request.models.insert(0,  { provider: :openrouter, model: "fast-model" })
+    #   request.models.insert(2,  { provider: :openrouter, model: "mid-model" })
+    #   request.models.insert(-1, { provider: :openrouter, model: "last-resort" })
     def insert(position, model)
       to_a.tap { |list| list.insert(position, model) }.then do |new_list|
         @prepended = []
@@ -127,7 +127,7 @@ module ActiveHarness
   end
 
   # ---------------------------------------------------------------------------
-  # DSL builder — used by Agent.model { ... }
+  # DSL builder — used by Request.model { ... }
   # ---------------------------------------------------------------------------
   class ModelConfig
     def initialize

data/lib/active_harness/{agent → request}/output_parser.rb

@@ -1,5 +1,5 @@
 module ActiveHarness
-  class Agent
+  class Request
     private
 
     # Strips markdown code fences that some models add despite being told not to:

data/lib/active_harness/{agent → request}/prompt.rb

@@ -1,7 +1,7 @@
 module ActiveHarness
-  class Agent
+  class Request
     class << self
-      # System prompt for this agent.
+      # System prompt for this request.
       # Accepts:
       #   - a String  → used as-is
       #   - a Class   → instantiated and resolved via #call or #text
@@ -11,7 +11,7 @@ module ActiveHarness
       #   system_prompt MyPromptClass
       #   system_prompt -> { "Dynamic prompt built at #{Time.now}" }
       def system_prompt(text_or_class)
-        agent_config[:system_prompt] = text_or_class
+        request_config[:system_prompt] = text_or_class
       end
       alias prompt system_prompt
     end
@@ -32,13 +32,13 @@ module ActiveHarness
       when Proc     then instance_exec(&sp)
       when Class
         instance = sp.new
-        inject_agent_state(instance)
+        inject_request_state(instance)
         if    instance.respond_to?(:call) then instance.call
         elsif instance.respond_to?(:text) then instance.text
         else  instance.to_s
         end
       else
-        inject_agent_state(sp)
+        inject_request_state(sp)
         if    sp.respond_to?(:call) then sp.call
         elsif sp.respond_to?(:text) then sp.text
         else  sp.to_s
@@ -49,9 +49,9 @@ module ActiveHarness
       prompt
     end
 
-    # Injects agent state into a prompt class instance before #call.
+    # Injects request state into a prompt class instance before #call.
     # Available in prompt classes: @input, @context, @params, @memory, @context_window, @config
-    def inject_agent_state(obj)
+    def inject_request_state(obj)
       obj.instance_variable_set(:@input,          @input)
       obj.instance_variable_set(:@context,        @context)
       obj.instance_variable_set(:@params,         @params)

data/lib/active_harness/{agent → request}/providers.rb

@@ -1,5 +1,5 @@
 module ActiveHarness
-  class Agent
+  class Request
     # Errors that allow retrying the next model in the chain.
     # InvalidRequestError is included here so that a bad model name (or any
     # per-model request failure) does not abort the entire chain — the next
@@ -44,6 +44,7 @@ module ActiveHarness
     }.freeze
 
     TRANSCRIPTION_PROVIDERS = {
+      openai:      -> { Providers::Audio::OpenAI.new },
       openrouter:  -> { Providers::Audio::OpenRouter.new }
     }.freeze
 

data/lib/active_harness/{agent → request}/transcription.rb

@@ -1,9 +1,9 @@
 module ActiveHarness
-  class Agent
+  class Request
     class << self
-      # Mark this agent as an audio transcription agent.
+      # Mark this request as an audio transcription request.
       #
-      #   class TranscriptionAgent < ActiveHarness::Agent
+      #   class TranscriptionRequest < ActiveHarness::Request
       #     transcribe true
       #
       #     model do
@@ -16,13 +16,13 @@ module ActiveHarness
       # result.output    — transcribed text (String)
       # result.processed — same as output (format :text default)
       def transcribe(value = true)
-        agent_config[:transcribe] = value
+        request_config[:transcribe] = value
       end
 
-      # Default ISO-639-1 language hint for all models in this agent's chain.
+      # Default ISO-639-1 language hint for all models in this request's chain.
       # Can be overridden per-model via:  use provider: :openrouter, model: "...", language: "ja"
       def language(default_language)
-        agent_config[:transcribe_language] = default_language
+        request_config[:transcribe_language] = default_language
       end
     end
 
@@ -38,7 +38,7 @@ module ActiveHarness
 
     alias_method :_normalize_input_before_transcribe, :normalize_input!
 
-    # @input is a file path for transcription agents, not free text —
+    # @input is a file path for transcription requests, not free text —
     # stripping/collapsing whitespace could corrupt a path. Skip it.
     def normalize_input!
       return if @config[:transcribe]

data/lib/active_harness/{agent.rb → request.rb}

@@ -1,15 +1,15 @@
 require "json"
 
 module ActiveHarness
-  class Agent
+  class Request
     # -------------------------------------------------------------------------
     # Class-level DSL — core
     # -------------------------------------------------------------------------
     class << self
       # Class-level entry point.
       #
-      #   SupportAgent.call(input: "Hi")
-      #   SupportAgent.call(input: "Hi", context: { user_id: 42 })
+      #   SupportRequest.call(input: "Hi")
+      #   SupportRequest.call(input: "Hi", context: { user_id: 42 })
       def call(
         input:   nil,
         context: {},
@@ -31,12 +31,12 @@ module ActiveHarness
       end
 
       # Each subclass gets its own isolated config hash.
-      def agent_config
-        @agent_config ||= {}
+      def request_config
+        @request_config ||= {}
       end
 
       def inherited(subclass)
-        subclass.instance_variable_set(:@agent_config, {})
+        subclass.instance_variable_set(:@request_config, {})
       end
 
       # Automatically strip and collapse whitespace in @input before each call.
@@ -44,7 +44,7 @@ module ActiveHarness
       #
       #   normalize_input false
       def normalize_input(value = true)
-        agent_config[:normalize_input] = value
+        request_config[:normalize_input] = value
       end
     end
 
@@ -74,7 +74,7 @@ module ActiveHarness
       stream:  nil
     )
       @input           = input
-      @config          = self.class.agent_config
+      @config          = self.class.request_config
       normalize_input!
       @context         = context
       @params          = params
@@ -89,8 +89,8 @@ module ActiveHarness
     # Raises Errors::AllModelsFailed if every model in the chain fails.
     #
     # Optionally accepts input and stream callback inline:
-    #   agent.call("What is the capital of Japan?")
-    #   agent.call("...", stream: ->(token) { print token })
+    #   request.call("What is the capital of Japan?")
+    #   request.call("...", stream: ->(token) { print token })
     def call(input = nil, token: nil, stream: nil)
       if input
         @input = input
@@ -205,13 +205,13 @@ module ActiveHarness
   end
 end
 
-require_relative "agent/prompt"
-require_relative "agent/hooks"
-require_relative "agent/models"
-require_relative "agent/providers"
-require_relative "agent/output_parser"
-require_relative "agent/custom_llm_backend"
-require_relative "agent/cost"
-require_relative "agent/image"
-require_relative "agent/transcription"
+require_relative "request/prompt"
+require_relative "request/hooks"
+require_relative "request/models"
+require_relative "request/providers"
+require_relative "request/output_parser"
+require_relative "request/custom_llm_backend"
+require_relative "request/cost"
+require_relative "request/image"
+require_relative "request/transcription"
 

data/lib/active_harness/result.rb

@@ -33,16 +33,16 @@ module ActiveHarness
   # nil when pricing data is unavailable.
   CostBreakdown = Struct.new(:input, :output, :total, keyword_init: true)
 
-  # Combined token + cost stats for a single agent call.
+  # Combined token + cost stats for a single request call.
   # tokens is always present (raw provider data).
   # cost is nil when pricing is unavailable.
   UsageInfo = Struct.new(:tokens, :cost, keyword_init: true)
 
-  # Result returned by Agent#call (accessible via agent.result).
+  # Result returned by Request#call (accessible via request.result).
   #
   #   result.input            — original input string
   #   result.output           — raw string from the provider
-  #   result.processed        — parsed Hash/Array for :json agents, raw string for :text
+  #   result.processed        — parsed Hash/Array for :json requests, raw string for :text
   #   result.system_prompt    — resolved system prompt string
   #   result.model            — ModelInfo (name, provider, temperature, context_window, pricing)
   #   result.model_list       — full model chain proxy

data/lib/active_harness/tribunal/dsl.rb

@@ -1,12 +1,12 @@
 module ActiveHarness
   class Tribunal
     class << self
-      # Declare agents at the class level.
+      # Declare requests at the class level.
       #
-      #   agents PolitenessAgent, ConstructivenessAgent
-      #   agents [PolitenessAgent, ConstructivenessAgent]
-      def agents(*list)
-        tribunal_config[:agents] = list.flatten
+      #   requests PolitenessRequest, ConstructivenessRequest
+      #   requests [PolitenessRequest, ConstructivenessRequest]
+      def requests(*list)
+        tribunal_config[:requests] = list.flatten
       end
 
       # Class-level process block — defines how to compute the verdict from all results.
@@ -25,8 +25,8 @@ module ActiveHarness
       #   :majority   — verdict true when more than half of successful results evaluate to true
       #
       # Options:
-      #   may_fail: N — tolerate up to N agent errors before raising AllAgentsFailed
-      #                 (default: nil — raise only when all agents fail, preserving legacy behavior)
+      #   may_fail: N — tolerate up to N request errors before raising AllRequestsFailed
+      #                 (default: nil — raise only when all requests fail, preserving legacy behavior)
       #
       # The block receives a single Result and must return a truthy/falsy value.
       #

data/lib/active_harness/tribunal/hooks.rb

@@ -2,9 +2,9 @@ module ActiveHarness
   class Tribunal
     VALID_HOOKS = %i[
       before_call
-      before_agent
-      after_agent
-      agent_error
+      before_request
+      after_request
+      request_error
       after_call
       before_verdict
       after_verdict
@@ -14,9 +14,9 @@ module ActiveHarness
       # Class-level hook registration.
       #
       #   on :before_call                  do ... end
-      #   on :before_agent                 do |agent| ... end
-      #   on :after_agent                  do |result| ... end
-      #   on :agent_error                  do |name, error| ... end
+      #   on :before_request               do |request| ... end
+      #   on :after_request                do |result| ... end
+      #   on :request_error                do |name, error| ... end
       #   on :after_call                   do |results, errors| ... end
       #   on :before_verdict               do |results| results end  # transform hook
       #   on :after_verdict                do |verdict| ... end
@@ -32,12 +32,12 @@ module ActiveHarness
       # Rails-style aliases for +on+:
       #
       #   before :call                     do ... end       # → on :before_call
-      #   before :agent                    do |agent| end   # → on :before_agent
+      #   before :request                  do |request| end # → on :before_request
       #   before :verdict                  do |results| end # → on :before_verdict (transform)
       #   after  :call                     do |r, e| end    # → on :after_call
-      #   after  :agent                    do |result| end  # → on :after_agent
+      #   after  :request                  do |result| end  # → on :after_request
       #   after  :verdict                  do |verdict| end # → on :after_verdict
-      #   callback :agent_error            do |name, e| end # → on :agent_error
+      #   callback :request_error          do |name, e| end # → on :request_error
       def before(event, &block)
         on(:"before_#{event}", &block)
       end