activeagent 1.9.2 → 1.9.4

data/lib/active_agent/providers/opper_provider.rb

@@ -0,0 +1,72 @@
+require_relative "_base_provider"
+
+require_gem!(:openai, __FILE__)
+
+require_relative "open_ai_provider"
+require_relative "opper/_types"
+
+module ActiveAgent
+  module Providers
+    # Provides access to Opper's OpenAI-compatible LLM gateway.
+    #
+    # Extends the OpenAI provider to work with Opper's OpenAI-compatible API,
+    # enabling access to models from many providers through a single
+    # interface. Model ids are bare pool names (e.g. +claude-sonnet-4-6+);
+    # a +provider/model+ id (e.g. +anthropic/claude-sonnet-4-6+) pins a route.
+    #
+    # Opper is a plain OpenAI-compatible gateway: requests, responses and
+    # transforms are identical to the OpenAI Chat API, so this provider reuses
+    # OpenAI::Chat::RequestType and OpenAI::Chat::Transforms directly. The only
+    # Opper-specific configuration is the base URL and API key, which live in
+    # Opper::Options.
+    #
+    # @example Configuration in active_agent.yml
+    #   opper:
+    #     service: "Opper"
+    #     api_key: <%= ENV["OPPER_API_KEY"] %>
+    #     model: "claude-sonnet-4-6"
+    #
+    # @see OpenAI::ChatProvider
+    # @see https://docs.opper.ai
+    class OpperProvider < OpenAI::ChatProvider
+      # @return [String]
+      def self.service_name
+        "Opper"
+      end
+
+      # @return [Class]
+      def self.options_klass
+        Opper::Options
+      end
+
+      # @return [ActiveModel::Type::Value]
+      def self.prompt_request_type
+        OpenAI::Chat::RequestType.new
+      end
+
+      # @return [ActiveModel::Type::Value]
+      def self.embed_request_type
+        OpenAI::Embedding::RequestType.new
+      end
+
+      protected
+
+      # Executes an embedding request via Opper's OpenAI-compatible API.
+      #
+      # @param parameters [Hash]
+      # @return [Hash] symbolized API response
+      def api_embed_execute(parameters)
+        client.embeddings.create(**parameters).as_json.deep_symbolize_keys
+      end
+
+      # @see BaseProvider#api_response_normalize
+      # @param api_response [OpenAI::Models::ChatCompletion]
+      # @return [Hash] normalized response hash
+      def api_response_normalize(api_response)
+        return api_response unless api_response
+
+        OpenAI::Chat::Transforms.gem_to_hash(api_response)
+      end
+    end
+  end
+end

data/lib/active_agent/railtie.rb

@@ -6,6 +6,8 @@ require "active_agent"
 require "active_agent/railtie/schema_generator_extension"
 require "abstract_controller/railties/routes_helpers"
 
+Rails.autoload :AgentsController, "rails/agents_controller"
+
 module ActiveAgent
   class Railtie < Rails::Railtie # :nodoc:
     config.active_agent = ActiveSupport::OrderedOptions.new
@@ -101,8 +103,12 @@ module ActiveAgent
     end
 
     initializer "active_agent.set_autoload_paths", before: :set_autoload_paths do |app|
-      # options = app.config.active_agent
-      # app.config.paths["test/agents/previews"].concat(options.preview_paths)
+      options = app.config.active_agent
+      options.preview_paths |= [ "#{app.root}/test/agents/previews", "#{app.root}/test/docs/previews" ]
+      # This runs before set_configs assigns show_previews its development default.
+      if options.show_previews.nil? ? Rails.env.development? : options.show_previews
+        app.config.autoload_paths.concat(options.preview_paths)
+      end
     end
 
     initializer "active_agent.compile_config_methods" do
@@ -132,9 +138,9 @@ module ActiveAgent
 
       if options.show_previews
         app.routes.prepend do
-          get "/rails/agents" => "rails/agents#index", :internal => true
-          get "/rails/agents/download/*path" => "rails/agents#download", :internal => true
-          get "/rails/agents/*path" => "rails/agents#preview", :internal => true
+          get "/rails/agents" => "rails/agents#index", :internal => true, :as => :rails_agent_previews
+          get "/rails/agents/download/*path" => "rails/agents#download", :internal => true, :as => :download_rails_agent_preview, :format => false
+          get "/rails/agents/*path" => "rails/agents#preview", :internal => true, :as => :rails_agent_preview, :format => false
         end
       end
     end

data/lib/active_agent/version.rb

@@ -1,3 +1,3 @@
 module ActiveAgent
-  VERSION = "1.9.2"
+  VERSION = "1.9.4"
 end

data/lib/generators/test_unit/agent_generator.rb

@@ -17,7 +17,7 @@ module TestUnit # :nodoc:
       end
 
       def create_preview_files
-        template "preview.rb", File.join("test/docs/previews", class_path, "#{file_name}_agent_preview.rb")
+        template "preview.rb", File.join("test/agents/previews", class_path, "#{file_name}_agent_preview.rb")
       end
 
       private

data/lib/generators/test_unit/templates/functional_test.rb.tt

@@ -1,7 +1,7 @@
 require "test_helper"
 
 <% module_namespacing do -%>
-class <%= class_name %>AgentTest < ActiveAgent::TestCase
+class <%= class_name %>AgentTest < ActiveSupport::TestCase
 <% actions.each_with_index do |action, index| -%>
 <% if index != 0 -%>
 

data/lib/generators/test_unit/templates/preview.rb.tt

@@ -1,13 +1,13 @@
 <% module_namespacing do -%>
-# Preview all agent views/prompts templates at http://localhost:3000/active_agent/agents/<%= file_path %>_agent
+# Preview all agent views/prompts templates at http://localhost:3000/rails/agents/<%= file_path %>_agent
 class <%= class_name %>AgentPreview < ActiveAgent::Preview
 <% actions.each_with_index do |action, index| -%>
 <% if index != 0 -%>
 
 <% end -%>
-  # Preview this email at http://localhost:3000/active_agent/agents/<%= file_path %>_agent/<%= action %>
+  # Preview this prompt at http://localhost:3000/rails/agents/<%= file_path %>_agent/<%= action %>
   def <%= action %>
-    <%= class_name %>Agent.<%= action %>
+    <%= class_name %>Agent.with(params).<%= action %>
   end
 <% end -%>
 end

data/lib/rails/agents_controller.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "rails/application_controller"
+
+class Rails::AgentsController < Rails::ApplicationController # :nodoc:
+  prepend_view_path File.expand_path("../active_agent/preview/templates", __dir__)
+  layout "active_agent/preview"
+  before_action :require_local!
+
+  def index
+    @previews = ActiveAgent::Preview.all
+  end
+
+  def preview
+    if found = ActiveAgent::Preview.find(params[:path])
+      @previews = [ found ]
+      render :index
+    elsif load_preview
+      render :preview
+    end
+  end
+
+  def download
+    return unless load_preview
+
+    send_data @content, type: "text/markdown", disposition: "attachment",
+      filename: "#{@preview.preview_name.tr('/', '-')}-#{@prompt}.md"
+  end
+
+  private
+
+  def load_preview
+    name, _, @prompt = params[:path].to_s.rpartition("/")
+    @preview = ActiveAgent::Preview.find(name)
+    unless @preview&.prompt_exists?(@prompt)
+      head :not_found
+      return false
+    end
+
+    @content = @preview.call(@prompt, request.query_parameters).prompt_preview
+    true
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: activeagent
 version: !ruby/object:Gem::Version
-  version: 1.9.2
+  version: 1.9.4
 platform: ruby
 authors:
 - Justin Bowen
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-20 00:00:00.000000000 Z
+date: 2026-10-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -467,6 +467,7 @@ files:
 - lib/active_agent/evals/replay.rb
 - lib/active_agent/evals/report.rb
 - lib/active_agent/evals/report_html.rb
+- lib/active_agent/evals/report_markdown.rb
 - lib/active_agent/evals/result.rb
 - lib/active_agent/evals/ruby_llm.rb
 - lib/active_agent/evals/runner.rb
@@ -481,6 +482,9 @@ files:
 - lib/active_agent/input_request.rb
 - lib/active_agent/input_request/resume.rb
 - lib/active_agent/model_capabilities.rb
+- lib/active_agent/preview/templates/layouts/active_agent/preview.html.erb
+- lib/active_agent/preview/templates/rails/agents/index.html.erb
+- lib/active_agent/preview/templates/rails/agents/preview.html.erb
 - lib/active_agent/providers/_base_provider.rb
 - lib/active_agent/providers/anthropic/_types.rb
 - lib/active_agent/providers/anthropic/options.rb
@@ -585,6 +589,9 @@ files:
 - lib/active_agent/providers/open_router_provider.rb
 - lib/active_agent/providers/openai_provider.rb
 - lib/active_agent/providers/openrouter_provider.rb
+- lib/active_agent/providers/opper/_types.rb
+- lib/active_agent/providers/opper/options.rb
+- lib/active_agent/providers/opper_provider.rb
 - lib/active_agent/providers/requesty/_types.rb
 - lib/active_agent/providers/requesty/options.rb
 - lib/active_agent/providers/requesty_provider.rb
@@ -637,6 +644,7 @@ files:
 - lib/generators/test_unit/install_generator.rb
 - lib/generators/test_unit/templates/functional_test.rb.tt
 - lib/generators/test_unit/templates/preview.rb.tt
+- lib/rails/agents_controller.rb
 - lib/tasks/activeagent_tasks.rake
 homepage: https://activeagents.ai
 licenses: