ruby_llm-agents 1.3.4 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b65843b4d3c71ceba5fe61973aaefe40135cbfb4330a2bffe223fe4bd7264635
-  data.tar.gz: '069100e15512c507cc0eae7c674cb884a35eea460c20e4dc46fefe572c699850'
+  metadata.gz: 7f2dcacc45b93f72d6de4f0d8ac2f56d85288f9cacc5495838fbc40473714ddf
+  data.tar.gz: d6e2e7d7c78d9f6443cf8f01fa43733951e552922418ba8ee7226df4977d51a1
 SHA512:
-  metadata.gz: 8eae2f88345529b8d2a1aa0c7c13bc4507686273eef5011ab4900fa81f50c249ddee25fee71f6483c71c6c68968ae1cc0e42b909a17d5ea923a358a4303de06f
-  data.tar.gz: de73b936bc4c71ae428231048be59818e19d77a1b806ab4b5715c5c17cec8be55457a6f16e27d516aadb47b8ad6716f0e48db5340a2217846c182857a010651b
+  metadata.gz: 3231be55f4d51f39bb8339ac878a82eef2c2ee5d2894a53356c43a7fc20fd9381141e19d1b447e7c755a6117d687a241e7d3be701792ebf5e97ce3f5e7cf4758
+  data.tar.gz: d89ded2027aa6ef14494216a116fcf42a6b549128677ec24a3881a63109f06a15955d0c824d7b3ff9c8aeecaa1ebdd675099d38bb5a9dce8dd4344bf045cd15f

data/README.md

@@ -6,8 +6,6 @@
 
 # RubyLLM::Agents
 
-> **AI Agents:** For comprehensive documentation optimized for AI consumption, see [LLMS.txt](LLMS.txt)
-
 > **Production-ready Rails engine for building, managing, and monitoring LLM-powered AI agents**
 
 [![Gem Version](https://badge.fury.io/rb/ruby_llm-agents.svg)](https://rubygems.org/gems/ruby_llm-agents)
@@ -23,88 +21,28 @@ Build intelligent AI agents in Ruby with a clean DSL, automatic execution tracki
 - **Rails-Native** - Seamlessly integrates with your Rails app: models, jobs, caching, and Hotwire
 - **Production-Ready** - Built-in retries, model fallbacks, circuit breakers, and budget limits
 - **Full Observability** - Track every execution with costs, tokens, duration, and errors
-- **Workflow Orchestration** - Compose agents into pipelines, parallel tasks, and conditional routers
 - **Zero Lock-in** - Works with any LLM provider supported by RubyLLM
 
-## Features
-
-| Feature | Description | Docs |
-|---------|-------------|------|
-| **Agent DSL** | Declarative configuration with model, temperature, parameters, description | [Agent DSL](https://github.com/adham90/ruby_llm-agents/wiki/Agent-DSL) |
-| **Execution Tracking** | Automatic logging with token usage, cost analytics, and fallback tracking | [Tracking](https://github.com/adham90/ruby_llm-agents/wiki/Execution-Tracking) |
-| **Cost Analytics** | Track spending by agent, model, tenant, and time period | [Analytics](https://github.com/adham90/ruby_llm-agents/wiki/Execution-Tracking) |
-| **Reliability** | Automatic retries, model fallbacks, circuit breakers with block DSL | [Reliability](https://github.com/adham90/ruby_llm-agents/wiki/Reliability) |
-| **Budget Controls** | Daily/monthly limits with hard and soft enforcement | [Budgets](https://github.com/adham90/ruby_llm-agents/wiki/Budget-Controls) |
-| **Multi-Tenancy** | Per-tenant API keys, budgets, circuit breakers, and execution isolation | [Multi-Tenancy](https://github.com/adham90/ruby_llm-agents/wiki/Multi-Tenancy) |
-| **Workflows** | Pipelines, parallel execution, conditional routers | [Workflows](https://github.com/adham90/ruby_llm-agents/wiki/Workflows) |
-| **Async/Fiber** | Concurrent execution with Ruby fibers for high-throughput workloads | [Async](https://github.com/adham90/ruby_llm-agents/wiki/Async-Fiber) |
-| **Dashboard** | Real-time Turbo-powered monitoring UI | [Dashboard](https://github.com/adham90/ruby_llm-agents/wiki/Dashboard) |
-| **Streaming** | Real-time response streaming with TTFT tracking | [Streaming](https://github.com/adham90/ruby_llm-agents/wiki/Streaming) |
-| **Conversation History** | Multi-turn conversations with message history | [Conversation History](https://github.com/adham90/ruby_llm-agents/wiki/Conversation-History) |
-| **Attachments** | Images, PDFs, and multimodal support | [Attachments](https://github.com/adham90/ruby_llm-agents/wiki/Attachments) |
-| **PII Redaction** | Automatic sensitive data protection | [Security](https://github.com/adham90/ruby_llm-agents/wiki/PII-Redaction) |
-| **Content Moderation** | Input/output safety checks with OpenAI moderation API | [Moderation](https://github.com/adham90/ruby_llm-agents/wiki/Moderation) |
-| **Embeddings** | Vector embeddings with batching, caching, and preprocessing | [Embeddings](https://github.com/adham90/ruby_llm-agents/wiki/Embeddings) |
-| **Image Operations** | Generation, analysis, editing, pipelines with cost tracking | [Images](https://github.com/adham90/ruby_llm-agents/wiki/Image-Generation) |
-| **Alerts** | Slack, webhook, and custom notifications | [Alerts](https://github.com/adham90/ruby_llm-agents/wiki/Alerts) |
-
-## Quick Start
-
-### Installation
-
-```ruby
-# Gemfile
-gem "ruby_llm-agents"
-```
-
-```bash
-bundle install
-rails generate ruby_llm_agents:install
-rails db:migrate
-```
-
-### Configure API Keys
-
-```bash
-# .env
-OPENAI_API_KEY=sk-...
-ANTHROPIC_API_KEY=sk-ant-...
-GOOGLE_API_KEY=...
-```
-
-### Create Your First Agent
-
-```bash
-rails generate ruby_llm_agents:agent SearchIntent query:required
-```
+## Show Me the Code
 
 ```ruby
-# app/llm/agents/search_intent_agent.rb
-module LLM
-  class SearchIntentAgent < ApplicationAgent
-    model "gpt-4o"
-    temperature 0.0
-
-    param :query, required: true
-
-    def user_prompt
-      "Extract search intent from: #{query}"
-    end
-
-    def schema
-      @schema ||= RubyLLM::Schema.create do
-        string :refined_query, description: "Cleaned search query"
-        array :filters, of: :string, description: "Extracted filters"
-      end
-    end
+# app/agents/search_intent_agent.rb
+class SearchIntentAgent < ApplicationAgent
+  model "gpt-4o"
+  temperature 0.0
+
+  # Prompts with {placeholder} syntax - params auto-registered
+  system "You are a search intent analyzer. Extract structured data from queries."
+  prompt "Extract search intent from: {query}"
+
+  # Structured output with returns DSL
+  returns do
+    string :refined_query, description: "Cleaned search query"
+    array :filters, of: :string, description: "Extracted filters"
   end
 end
-```
 
-### Call the Agent
-
-```ruby
-result = LLM::SearchIntentAgent.call(query: "red summer dress under $50")
+result = SearchIntentAgent.call(query: "red summer dress under $50")
 
 result.content        # => { refined_query: "red dress", filters: ["color:red", "price:<50"] }
 result.total_cost     # => 0.00025
@@ -112,11 +50,8 @@ result.total_tokens   # => 150
 result.duration_ms    # => 850
 ```
 
-### Multi-Turn Conversations
-
-Build chatbots and conversational agents with message history:
-
 ```ruby
+# Multi-turn conversations
 result = ChatAgent.call(
   query: "What's my name?",
   messages: [
@@ -127,112 +62,124 @@ result = ChatAgent.call(
 # => "Your name is Alice!"
 ```
 
-See [Conversation History](https://github.com/adham90/ruby_llm-agents/wiki/Conversation-History) for more patterns.
-
-### Embeddings
+```ruby
+# Resilient agents with automatic retries and fallbacks
+class ReliableAgent < ApplicationAgent
+  model "gpt-4o"
 
-Generate vector embeddings for semantic search, RAG, and similarity matching:
+  prompt "{query}"
 
-```bash
-rails generate ruby_llm_agents:embedder Document
+  on_failure do
+    retries times: 3, backoff: :exponential
+    fallback to: ["gpt-4o-mini", "claude-3-5-sonnet"]
+    circuit_breaker after: 10, within: 60, cooldown: 5.minutes
+    timeout 30
+  end
+end
 ```
 
 ```ruby
-# app/llm/text/embedders/document_embedder.rb
-module LLM
-  module Text
-    class DocumentEmbedder < ApplicationEmbedder
-      model "text-embedding-3-small"
-      dimensions 512
-      batch_size 100
-      cache_for 1.week
-
-      # Optional: preprocess text before embedding
-      def preprocess(text)
-        text.strip.downcase.gsub(/\s+/, ' ')
-      end
-    end
+# Vector embeddings for semantic search and RAG
+# app/agents/embedders/document_embedder.rb
+module Embedders
+  class DocumentEmbedder < ApplicationEmbedder
+    model "text-embedding-3-small"
+    dimensions 512
+    cache_for 1.week
   end
 end
-```
 
-```ruby
-# Single text embedding
-result = LLM::Text::DocumentEmbedder.call(text: "Hello world")
+result = Embedders::DocumentEmbedder.call(text: "Hello world")
 result.vector       # => [0.123, -0.456, ...]
 result.dimensions   # => 512
-result.total_tokens # => 2
 
 # Batch embedding
-result = LLM::Text::DocumentEmbedder.call(texts: ["Hello", "World", "Ruby"])
+result = Embedders::DocumentEmbedder.call(texts: ["Hello", "World", "Ruby"])
 result.vectors      # => [[...], [...], [...]]
-result.count        # => 3
+```
 
-# With progress callback for large batches
-LLM::Text::DocumentEmbedder.call(texts: large_array) do |batch_result, index|
-  puts "Processed batch #{index + 1}"
+```ruby
+# Image generation, analysis, and pipelines
+# app/agents/images/logo_generator.rb
+module Images
+  class LogoGenerator < ApplicationImageGenerator
+    model "gpt-image-1"
+    size "1024x1024"
+    quality "hd"
+    style "vivid"
+    template "Professional logo design: {prompt}. Minimalist, scalable."
+  end
 end
+
+result = Images::LogoGenerator.call(prompt: "tech startup logo")
+result.url          # => "https://..."
+result.save("logo.png")
 ```
 
-Features:
-- **Configurable dimensions** - Reduce dimensions for efficient storage
-- **Batch processing** - Embed multiple texts in optimized API calls
-- **Caching** - Cache embeddings to reduce API costs
-- **Preprocessing** - Clean and normalize text before embedding
-- **Execution tracking** - All embeddings logged with tokens and costs
+## Features
+
+| Feature | Description | Docs |
+|---------|-------------|------|
+| **Agent DSL** | Declarative configuration with model, temperature, parameters, description | [Agent DSL](https://github.com/adham90/ruby_llm-agents/wiki/Agent-DSL) |
+| **Execution Tracking** | Automatic logging with token usage, cost analytics, and fallback tracking | [Tracking](https://github.com/adham90/ruby_llm-agents/wiki/Execution-Tracking) |
+| **Cost Analytics** | Track spending by agent, model, tenant, and time period | [Analytics](https://github.com/adham90/ruby_llm-agents/wiki/Execution-Tracking) |
+| **Reliability** | Automatic retries, model fallbacks, circuit breakers with block DSL | [Reliability](https://github.com/adham90/ruby_llm-agents/wiki/Reliability) |
+| **Budget Controls** | Daily/monthly limits with hard and soft enforcement | [Budgets](https://github.com/adham90/ruby_llm-agents/wiki/Budget-Controls) |
+| **Multi-Tenancy** | Per-tenant API keys, budgets, circuit breakers, and execution isolation | [Multi-Tenancy](https://github.com/adham90/ruby_llm-agents/wiki/Multi-Tenancy) |
+| **Async/Fiber** | Concurrent execution with Ruby fibers for high-throughput workloads | [Async](https://github.com/adham90/ruby_llm-agents/wiki/Async-Fiber) |
+| **Dashboard** | Real-time Turbo-powered monitoring UI | [Dashboard](https://github.com/adham90/ruby_llm-agents/wiki/Dashboard) |
+| **Streaming** | Real-time response streaming with TTFT tracking | [Streaming](https://github.com/adham90/ruby_llm-agents/wiki/Streaming) |
+| **Conversation History** | Multi-turn conversations with message history | [Conversation History](https://github.com/adham90/ruby_llm-agents/wiki/Conversation-History) |
+| **Attachments** | Images, PDFs, and multimodal support | [Attachments](https://github.com/adham90/ruby_llm-agents/wiki/Attachments) |
+| **Embeddings** | Vector embeddings with batching, caching, and preprocessing | [Embeddings](https://github.com/adham90/ruby_llm-agents/wiki/Embeddings) |
+| **Image Operations** | Generation, analysis, editing, pipelines with cost tracking | [Images](https://github.com/adham90/ruby_llm-agents/wiki/Image-Generation) |
+| **Alerts** | Slack, webhook, and custom notifications | [Alerts](https://github.com/adham90/ruby_llm-agents/wiki/Alerts) |
 
-See [Embeddings](https://github.com/adham90/ruby_llm-agents/wiki/Embeddings) for more patterns.
+## Quick Start
 
-### Image Operations
+### Installation
 
-Comprehensive image capabilities with generation, analysis, editing, and pipelines:
+```ruby
+# Gemfile
+gem "ruby_llm-agents"
+```
 
 ```bash
-# Generate image generators, analyzers, pipelines, and more
-rails generate ruby_llm_agents:image_generator Logo
-rails generate ruby_llm_agents:image_analyzer Product
-rails generate ruby_llm_agents:background_remover Photo
-rails generate ruby_llm_agents:image_pipeline Ecommerce --steps generate,upscale,analyze
+bundle install
+rails generate ruby_llm_agents:install
+rails db:migrate
 ```
 
-```ruby
-# Image Generation - create images from prompts
-result = LLM::Image::LogoGenerator.call(prompt: "tech startup logo")
-result.url          # => "https://..."
-result.save("logo.png")
+### Configure API Keys
 
-# Image Analysis - extract captions, tags, objects, colors
-result = LLM::Image::ProductAnalyzer.call(image: "product.jpg")
-result.caption      # => "Red sneaker on white background"
-result.tags         # => ["sneaker", "red", "footwear"]
-result.colors       # => [{ hex: "#FF0000", percentage: 30 }]
+```bash
+# .env
+OPENAI_API_KEY=sk-...
+ANTHROPIC_API_KEY=sk-ant-...
+GOOGLE_API_KEY=...
+```
 
-# Background Removal - extract subjects with transparency
-result = LLM::Image::PhotoBackgroundRemover.call(image: "portrait.jpg")
-result.save("portrait_transparent.png")
+### Generate an Agent
 
-# Image Pipelines - chain multiple operations
-result = LLM::Image::EcommercePipeline.call(
-  prompt: "professional laptop photo",
-  high_quality: true
-)
-result.final_image   # => Final processed image
-result.total_cost    # => Combined cost of all steps
-result.step(:analyze).tags  # => Access individual step results
+```bash
+rails generate ruby_llm_agents:agent SearchIntent query:required
 ```
 
-Features:
-- **8 image operation classes** - Generator, Analyzer, Editor, Transformer, Upscaler, Variator, BackgroundRemover, Pipeline
-- **Prompt templates** - Consistent styling with preset templates
-- **Content policy** - Validate prompts with configurable safety levels
-- **Cost tracking** - Dynamic pricing with execution logging
-- **Image Pipelines** - Chain operations into automated workflows
-- **ActiveStorage** - Attach images directly to Rails models
+This creates `app/agents/search_intent_agent.rb` with the agent class ready to customize.
+
+### Mount the Dashboard
+
+```ruby
+# config/routes.rb
+mount RubyLLM::Agents::Engine => "/agents"
+```
 
-See [Image Operations](https://github.com/adham90/ruby_llm-agents/wiki/Image-Generation) for full documentation.
+![RubyLLM Agents Dashboard](screenshot.png)
 
 ## Documentation
 
+> **AI Agents:** For comprehensive documentation optimized for AI consumption, see [LLMS.txt](LLMS.txt)
+
 > **Note:** Wiki content lives in the [`wiki/`](wiki/) folder. To sync changes to the [GitHub Wiki](https://github.com/adham90/ruby_llm-agents/wiki), run `./scripts/sync-wiki.sh`.
 
 | Guide | Description |
@@ -240,13 +187,11 @@ See [Image Operations](https://github.com/adham90/ruby_llm-agents/wiki/Image-Gen
 | [Getting Started](https://github.com/adham90/ruby_llm-agents/wiki/Getting-Started) | Installation, configuration, first agent |
 | [Agent DSL](https://github.com/adham90/ruby_llm-agents/wiki/Agent-DSL) | All DSL options: model, temperature, params, caching, description |
 | [Reliability](https://github.com/adham90/ruby_llm-agents/wiki/Reliability) | Retries, fallbacks, circuit breakers, timeouts, reliability block |
-| [Workflows](https://github.com/adham90/ruby_llm-agents/wiki/Workflows) | Pipelines, parallel execution, routers |
 | [Budget Controls](https://github.com/adham90/ruby_llm-agents/wiki/Budget-Controls) | Spending limits, alerts, enforcement |
 | [Multi-Tenancy](https://github.com/adham90/ruby_llm-agents/wiki/Multi-Tenancy) | Per-tenant budgets, isolation, configuration |
 | [Async/Fiber](https://github.com/adham90/ruby_llm-agents/wiki/Async-Fiber) | Concurrent execution with Ruby fibers |
 | [Testing Agents](https://github.com/adham90/ruby_llm-agents/wiki/Testing-Agents) | RSpec patterns, mocking, dry_run mode |
 | [Error Handling](https://github.com/adham90/ruby_llm-agents/wiki/Error-Handling) | Error types, recovery patterns |
-| [Moderation](https://github.com/adham90/ruby_llm-agents/wiki/Moderation) | Content moderation for input/output safety |
 | [Embeddings](https://github.com/adham90/ruby_llm-agents/wiki/Embeddings) | Vector embeddings, batching, caching, preprocessing |
 | [Image Generation](https://github.com/adham90/ruby_llm-agents/wiki/Image-Generation) | Text-to-image, templates, content policy, cost tracking |
 | [Dashboard](https://github.com/adham90/ruby_llm-agents/wiki/Dashboard) | Setup, authentication, analytics |
@@ -254,184 +199,6 @@ See [Image Operations](https://github.com/adham90/ruby_llm-agents/wiki/Image-Gen
 | [API Reference](https://github.com/adham90/ruby_llm-agents/wiki/API-Reference) | Complete class documentation |
 | [Examples](https://github.com/adham90/ruby_llm-agents/wiki/Examples) | Real-world use cases and patterns |
 
-## Reliability Features
-
-Build resilient agents with built-in fault tolerance:
-
-```ruby
-# app/llm/agents/reliable_agent.rb
-module LLM
-  class ReliableAgent < ApplicationAgent
-    model "gpt-4o"
-    description "A resilient agent with automatic retries and fallbacks"
-
-    # Option 1: Individual DSL methods
-    retries max: 3, backoff: :exponential
-    fallback_models "gpt-4o-mini", "claude-3-5-sonnet"
-    circuit_breaker errors: 10, within: 60, cooldown: 300
-    total_timeout 30
-
-    # Option 2: Grouped reliability block (equivalent to above)
-    reliability do
-      retries max: 3, backoff: :exponential
-      fallback_models "gpt-4o-mini", "claude-3-5-sonnet"
-      circuit_breaker errors: 10, within: 60, cooldown: 300
-      total_timeout 30
-    end
-
-    param :query, required: true
-
-    def user_prompt
-      query
-    end
-  end
-end
-```
-
-### Enhanced Result Object
-
-The result object provides detailed execution metadata:
-
-```ruby
-result = LLM::ReliableAgent.call(query: "test")
-
-# Basic response
-result.content           # => { ... }
-result.success?          # => true
-
-# Reliability info
-result.attempts_count    # => 2 (if retry occurred)
-result.used_fallback?    # => true (if fallback model used)
-result.chosen_model_id   # => "gpt-4o-mini" (actual model used)
-
-# Cost & timing
-result.total_cost        # => 0.00025
-result.total_tokens      # => 150
-result.duration_ms       # => 850
-```
-
-## Workflow Orchestration
-
-Compose agents into complex workflows:
-
-```ruby
-# Sequential pipeline - each step's output feeds the next
-class ContentPipeline < RubyLLM::Agents::Workflow::Pipeline
-  timeout 60.seconds
-  max_cost 1.00
-
-  step :classify, agent: ClassifierAgent
-  step :enrich,   agent: EnricherAgent
-  step :format,   agent: FormatterAgent, optional: true
-end
-
-result = ContentPipeline.call(text: data)
-result.steps[:classify].content  # Individual step result
-result.total_cost                # Sum of all steps
-
-# Parallel execution - run agents concurrently
-class AnalysisPipeline < RubyLLM::Agents::Workflow::Parallel
-  fail_fast false  # Continue even if a branch fails
-
-  branch :sentiment, agent: SentimentAgent
-  branch :entities,  agent: EntityAgent
-  branch :summary,   agent: SummaryAgent
-end
-
-result = AnalysisPipeline.call(text: content)
-result.branches[:sentiment].content  # Individual branch result
-
-# Conditional routing - dispatch based on classification
-class SupportRouter < RubyLLM::Agents::Workflow::Router
-  classifier_model "gpt-4o-mini"
-
-  route :support, to: SupportAgent, description: "Technical support issues"
-  route :sales,   to: SalesAgent,   description: "Sales and pricing questions"
-  route :default, to: GeneralAgent
-end
-
-result = SupportRouter.call(message: user_input)
-result.routed_to  # :support, :sales, or :default
-```
-
-## Async/Fiber Concurrency
-
-Run multiple agents concurrently with minimal resources using Ruby's Fiber scheduler:
-
-```ruby
-# Add async gem to Gemfile
-gem 'async'
-```
-
-```ruby
-require 'async'
-
-# Run agents concurrently - non-blocking I/O
-Async do
-  results = RubyLLM::Agents::Async.batch([
-    [SentimentAgent, { input: "I love this!" }],
-    [SummaryAgent, { input: "Long text..." }],
-    [CategoryAgent, { input: "Product review" }]
-  ], max_concurrent: 10)
-end
-
-# Process large collections efficiently
-Async do
-  results = RubyLLM::Agents::Async.each(texts, max_concurrent: 20) do |text|
-    AnalyzerAgent.call(input: text)
-  end
-end
-```
-
-Benefits:
-- **100x less memory** - Fibers use ~10KB vs ~1MB per thread
-- **Shared connections** - Single database connection for all fibers
-- **Auto-detection** - Parallel workflows automatically use fibers in async context
-- **Non-blocking retries** - Backoff delays don't block other operations
-
-See [Async/Fiber](https://github.com/adham90/ruby_llm-agents/wiki/Async-Fiber) for more patterns.
-
-## Cost & Budget Controls
-
-Track and limit LLM spending:
-
-```ruby
-# config/initializers/ruby_llm_agents.rb
-RubyLLM::Agents.configure do |config|
-  config.budgets = {
-    global_daily: 100.0,      # $100/day limit
-    global_monthly: 2000.0,   # $2000/month limit
-    per_agent_daily: {
-      "ExpensiveAgent" => 50.0
-    },
-    enforcement: :hard        # Block when exceeded
-  }
-
-  config.alerts = {
-    on_events: [:budget_soft_cap, :budget_hard_cap, :breaker_open],
-    slack_webhook_url: ENV['SLACK_WEBHOOK_URL']
-  }
-end
-```
-
-## Dashboard
-
-Mount the real-time monitoring dashboard:
-
-```ruby
-# config/routes.rb
-mount RubyLLM::Agents::Engine => "/agents"
-```
-
-![RubyLLM Agents Dashboard](screenshot.png)
-
-Features:
-- Execution history with filtering and search
-- Cost analytics by agent, model, and time period
-- Performance trends and charts
-- Token usage breakdowns
-- Error tracking and debugging
-
 ## Requirements
 
 - **Ruby** >= 3.1.0

data/app/controllers/concerns/ruby_llm/agents/sortable.rb

@@ -22,7 +22,6 @@ module RubyLLM
         "agent_type" => "agent_type",
         "status" => "status",
         "model_id" => "model_id",
-        "agent_version" => "agent_version",
         "total_tokens" => "total_tokens",
         "total_cost" => "total_cost",
         "duration_ms" => "duration_ms",

data/app/controllers/ruby_llm/agents/agents_controller.rb

@@ -48,7 +48,6 @@ module RubyLLM
         @agents_by_type = {
           agent: @agents.select { |a| a[:agent_type] == "agent" },
           embedder: @agents.select { |a| a[:agent_type] == "embedder" },
-          moderator: @agents.select { |a| a[:agent_type] == "moderator" },
           speaker: @agents.select { |a| a[:agent_type] == "speaker" },
           transcriber: @agents.select { |a| a[:agent_type] == "transcriber" },
           image_generator: @agents.select { |a| a[:agent_type] == "image_generator" }
@@ -60,7 +59,7 @@ module RubyLLM
         Rails.logger.error("[RubyLLM::Agents] Error loading agents: #{e.message}")
         @agents = []
         @deleted_agents = []
-        @agents_by_type = { agent: [], embedder: [], moderator: [], speaker: [], transcriber: [], image_generator: [] }
+        @agents_by_type = { agent: [], embedder: [], speaker: [], transcriber: [], image_generator: [] }
         @agent_count = 0
         @deleted_count = 0
         @sort_params = { column: DEFAULT_AGENT_SORT_COLUMN, direction: DEFAULT_AGENT_SORT_DIRECTION }
@@ -119,13 +118,11 @@ module RubyLLM
       def load_filter_options
         # Single query to get all filter options (fixes N+1)
         filter_data = Execution.by_agent(@agent_type)
-                               .where.not(agent_version: nil)
-                               .or(Execution.by_agent(@agent_type).where.not(model_id: nil))
+                               .where.not(model_id: nil)
                                .or(Execution.by_agent(@agent_type).where.not(temperature: nil))
-                               .pluck(:agent_version, :model_id, :temperature)
+                               .pluck(:model_id, :temperature)
 
-        @versions = filter_data.map(&:first).compact.uniq.sort.reverse
-        @models = filter_data.map { |d| d[1] }.compact.uniq.sort
+        @models = filter_data.map(&:first).compact.uniq.sort
         @temperatures = filter_data.map(&:last).compact.uniq.sort
       end
 
@@ -149,7 +146,7 @@ module RubyLLM
 
       # Builds a filtered scope for the current agent's executions
       #
-      # Applies filters in order: status, version, model, temperature, time.
+      # Applies filters in order: status, model, temperature, time.
       # Each filter is optional and only applied if values are provided.
       #
       # @return [ActiveRecord::Relation] Filtered execution scope
@@ -160,10 +157,6 @@ module RubyLLM
         statuses = parse_array_param(:statuses)
         scope = apply_status_filter(scope, statuses) if statuses.any?
 
-        # Apply version filter
-        versions = parse_array_param(:versions)
-        scope = scope.where(agent_version: versions) if versions.any?
-
         # Apply model filter
         models = parse_array_param(:models)
         scope = scope.where(model_id: models) if models.any?
@@ -188,37 +181,6 @@ module RubyLLM
         @trend_data = Execution.trend_analysis(agent_type: @agent_type, days: 30)
         @status_distribution = Execution.by_agent(@agent_type).group(:status).count
         @finish_reason_distribution = Execution.by_agent(@agent_type).finish_reason_distribution
-        load_version_comparison
-      end
-
-      # Loads version comparison data if multiple versions exist
-      #
-      # Includes trend data for sparkline charts.
-      #
-      # @return [void]
-      def load_version_comparison
-        return unless @versions.size >= 2
-
-        # Default to comparing two most recent versions
-        v1 = params[:compare_v1] || @versions[0]
-        v2 = params[:compare_v2] || @versions[1]
-
-        comparison_data = Execution.compare_versions(@agent_type, v1, v2, period: :this_month)
-
-        # Fetch trend data for sparklines
-        v1_trend = Execution.version_trend_data(@agent_type, v1, days: 14)
-        v2_trend = Execution.version_trend_data(@agent_type, v2, days: 14)
-
-        @version_comparison = {
-          v1: v1,
-          v2: v2,
-          data: comparison_data,
-          v1_trend: v1_trend,
-          v2_trend: v2_trend
-        }
-      rescue StandardError => e
-        Rails.logger.debug("[RubyLLM::Agents] Version comparison error: #{e.message}")
-        @version_comparison = nil
       end
 
       # Loads the current agent class configuration
@@ -234,7 +196,6 @@ module RubyLLM
         # Common config for all types
         @config = {
           model: safe_config_call(:model),
-          version: safe_config_call(:version) || "N/A",
           description: safe_config_call(:description)
         }
 
@@ -242,8 +203,6 @@ module RubyLLM
         case @agent_type_kind
         when "embedder"
           load_embedder_config
-        when "moderator"
-          load_moderator_config
         when "speaker"
           load_speaker_config
         when "transcriber"
@@ -284,16 +243,6 @@ module RubyLLM
         )
       end
 
-      # Loads configuration specific to Moderators
-      #
-      # @return [void]
-      def load_moderator_config
-        @config.merge!(
-          threshold: safe_config_call(:threshold),
-          categories: safe_config_call(:categories)
-        )
-      end
-
       # Loads configuration specific to Speakers
       #
       # @return [void]