ruby_llm-agents 3.7.2 → 3.9.0

data/app/views/ruby_llm/agents/requests/show.html.erb

@@ -0,0 +1,136 @@
+<div class="flex items-center gap-3 mb-6">
+  <%= link_to ruby_llm_agents.requests_path, class: "text-gray-400 dark:text-gray-600 hover:text-gray-700 dark:hover:text-gray-300 transition-colors" do %>
+    <svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24">
+      <path stroke-linecap="round" stroke-linejoin="round" d="M15 19l-7-7 7-7"/>
+    </svg>
+  <% end %>
+  <span class="text-[10px] font-medium text-gray-400 dark:text-gray-600 uppercase tracking-widest font-mono">request</span>
+  <code class="font-mono text-xs text-gray-900 dark:text-gray-200 bg-gray-100 dark:bg-gray-800 px-2 py-0.5 rounded"><%= @request_id %></code>
+  <div class="flex-1 border-t border-gray-200 dark:border-gray-800"></div>
+  <% if @summary[:all_successful] %>
+    <span class="badge badge-sm badge-success">all ok</span>
+  <% elsif @summary[:error_count] > 0 %>
+    <span class="badge badge-sm badge-error"><%= @summary[:error_count] %> error<%= @summary[:error_count] > 1 ? "s" : "" %></span>
+  <% end %>
+</div>
+
+<!-- Summary Stats -->
+<div class="grid grid-cols-2 sm:grid-cols-4 gap-4 mb-6">
+  <div class="bg-gray-50 dark:bg-gray-800/50 rounded-lg px-4 py-3">
+    <div class="font-mono text-[10px] text-gray-400 dark:text-gray-600 uppercase tracking-wider mb-1">calls</div>
+    <div class="font-mono text-lg text-gray-900 dark:text-gray-100"><%= @summary[:call_count] %></div>
+  </div>
+  <div class="bg-gray-50 dark:bg-gray-800/50 rounded-lg px-4 py-3">
+    <div class="font-mono text-[10px] text-gray-400 dark:text-gray-600 uppercase tracking-wider mb-1">total cost</div>
+    <div class="font-mono text-lg text-gray-900 dark:text-gray-100">$<%= number_with_precision(@summary[:total_cost] || 0, precision: 4) %></div>
+  </div>
+  <div class="bg-gray-50 dark:bg-gray-800/50 rounded-lg px-4 py-3">
+    <div class="font-mono text-[10px] text-gray-400 dark:text-gray-600 uppercase tracking-wider mb-1">tokens</div>
+    <div class="font-mono text-lg text-gray-900 dark:text-gray-100"><%= number_with_delimiter(@summary[:total_tokens] || 0) %></div>
+  </div>
+  <div class="bg-gray-50 dark:bg-gray-800/50 rounded-lg px-4 py-3">
+    <div class="font-mono text-[10px] text-gray-400 dark:text-gray-600 uppercase tracking-wider mb-1">duration</div>
+    <div class="font-mono text-lg text-gray-900 dark:text-gray-100">
+      <%= @summary[:duration_ms] ? format_duration_ms(@summary[:duration_ms]) : "—" %>
+    </div>
+  </div>
+</div>
+
+<!-- Agents & Models -->
+<div class="flex flex-wrap gap-2 mb-6">
+  <% @summary[:agent_types].each do |agent_type| %>
+    <%= link_to agent_type.gsub(/Agent$/, ""),
+        ruby_llm_agents.agent_path(agent_type),
+        class: "font-mono text-xs px-2 py-0.5 rounded bg-gray-100 dark:bg-gray-800 text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-gray-200 transition-colors" %>
+  <% end %>
+  <span class="w-px h-4 bg-gray-200 dark:bg-gray-700 self-center"></span>
+  <% @summary[:models_used].each do |model| %>
+    <span class="font-mono text-xs px-2 py-0.5 rounded bg-gray-50 dark:bg-gray-800/30 text-gray-400 dark:text-gray-600"><%= model %></span>
+  <% end %>
+</div>
+
+<!-- Execution Timeline -->
+<div class="mb-2">
+  <span class="text-[10px] font-medium text-gray-400 dark:text-gray-600 uppercase tracking-widest font-mono">execution timeline</span>
+</div>
+
+<div class="space-y-px">
+  <!-- Column headers -->
+  <div class="flex items-center gap-3 px-2 -mx-2 font-mono text-[10px] text-gray-400 dark:text-gray-600 uppercase tracking-wider mb-1">
+    <span class="w-5 flex-shrink-0 text-center">#</span>
+    <span class="flex-1 min-w-0">agent</span>
+    <span class="w-20 flex-shrink-0">status</span>
+    <span class="flex-1 min-w-0 hidden lg:block">model</span>
+    <span class="w-16 flex-shrink-0 text-right">duration</span>
+    <span class="w-16 flex-shrink-0 text-right hidden md:block">tokens</span>
+    <span class="w-16 flex-shrink-0 text-right hidden md:block">cost</span>
+  </div>
+
+  <div class="font-mono text-xs">
+    <% @executions.each_with_index do |execution, idx| %>
+      <%
+        status_badge_class = case execution.status.to_s
+          when "running" then "badge-running"
+          when "success" then "badge-success"
+          when "error" then "badge-error"
+          when "timeout" then "badge-timeout"
+          else "badge-timeout"
+        end
+      %>
+      <div class="group flex items-center gap-3 py-1.5 px-2 -mx-2 rounded hover:bg-gray-100 dark:hover:bg-gray-800/50 cursor-pointer"
+           onclick="window.location='<%= ruby_llm_agents.execution_path(execution) %>'">
+        <span class="w-5 flex-shrink-0 text-center text-gray-300 dark:text-gray-700"><%= idx + 1 %></span>
+        <span class="flex-1 min-w-0 truncate">
+          <%= link_to execution.agent_type.gsub(/Agent$/, ""),
+              ruby_llm_agents.agent_path(execution.agent_type),
+              class: "text-gray-900 dark:text-gray-200 hover:underline",
+              onclick: "event.stopPropagation()" %>
+        </span>
+        <span class="w-20 flex-shrink-0">
+          <span class="badge badge-sm <%= status_badge_class %>"><%= execution.status %></span>
+        </span>
+        <span class="flex-1 min-w-0 truncate text-gray-400 dark:text-gray-600 hidden lg:inline" title="<%= execution.model_id %>"><%= execution.model_id %></span>
+        <span class="w-16 flex-shrink-0 text-right text-gray-500 dark:text-gray-400">
+          <% if execution.status_running? %>
+            <span class="text-blue-500 animate-pulse">...</span>
+          <% else %>
+            <%= execution.duration_ms ? format_duration_ms(execution.duration_ms) : "—" %>
+          <% end %>
+        </span>
+        <span class="w-16 flex-shrink-0 text-right text-gray-500 dark:text-gray-400 hidden md:inline"><%= number_with_delimiter(execution.total_tokens || 0) %></span>
+        <span class="w-16 flex-shrink-0 text-right text-gray-500 dark:text-gray-400 hidden md:inline">$<%= number_with_precision(execution.total_cost || 0, precision: 4) %></span>
+      </div>
+      <% if execution.status_error? && execution.error_class.present? %>
+        <div class="flex items-center gap-1 pl-8 py-0.5 text-red-400 dark:text-red-500/70 text-xs font-mono">
+          <span class="text-gray-300 dark:text-gray-700">&#x2514;</span>
+          <span class="truncate"><%= execution.error_class.split("::").last %><%= execution.error_message.present? ? ": #{truncate(execution.error_message, length: 100)}" : "" %></span>
+        </div>
+      <% end %>
+    <% end %>
+  </div>
+</div>
+
+<!-- Timing Details -->
+<% if @summary[:started_at] %>
+<div class="mt-6 pt-4 border-t border-gray-200 dark:border-gray-800">
+  <span class="text-[10px] font-medium text-gray-400 dark:text-gray-600 uppercase tracking-widest font-mono">timing</span>
+  <div class="mt-2 font-mono text-xs text-gray-500 dark:text-gray-400 space-y-1">
+    <div class="flex gap-4">
+      <span class="text-gray-400 dark:text-gray-600 w-20">started</span>
+      <span><%= @summary[:started_at].strftime("%Y-%m-%d %H:%M:%S.%L") %></span>
+    </div>
+    <% if @summary[:completed_at] %>
+    <div class="flex gap-4">
+      <span class="text-gray-400 dark:text-gray-600 w-20">completed</span>
+      <span><%= @summary[:completed_at].strftime("%Y-%m-%d %H:%M:%S.%L") %></span>
+    </div>
+    <% end %>
+    <% if @summary[:duration_ms] %>
+    <div class="flex gap-4">
+      <span class="text-gray-400 dark:text-gray-600 w-20">wall clock</span>
+      <span><%= format_duration_ms(@summary[:duration_ms]) %></span>
+    </div>
+    <% end %>
+  </div>
+</div>
+<% end %>

data/config/routes.rb

@@ -13,6 +13,8 @@ RubyLLM::Agents::Engine.routes.draw do
     end
   end
 
+  resources :requests, only: [:index, :show]
+
   resources :tenants, only: [:index, :show, :edit, :update]
 
   # Redirect old analytics route to dashboard

data/lib/generators/ruby_llm_agents/agent_generator.rb

@@ -21,8 +21,8 @@ module RubyLlmAgents
 
     argument :params, type: :array, default: [], banner: "param[:required|:default] param[:required|:default]"
 
-    class_option :model, type: :string, default: "gemini-2.0-flash",
-      desc: "The LLM model to use"
+    class_option :model, type: :string, default: "default",
+      desc: "The LLM model to use (omit to use configured default)"
     class_option :temperature, type: :numeric, default: 0.0,
       desc: "The temperature setting (0.0-1.0)"
     class_option :cache, type: :string, default: nil,

data/lib/generators/ruby_llm_agents/demo_generator.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module RubyLlmAgents
+  # Demo generator — scaffolds a working HelloAgent with a smoke-test script.
+  #
+  # Usage:
+  #   rails generate ruby_llm_agents:demo
+  #
+  # Creates:
+  #   - app/agents/hello_agent.rb        — minimal working agent
+  #   - bin/smoke_test_agent             — one-command verification script
+  #
+  class DemoGenerator < ::Rails::Generators::Base
+    source_root File.expand_path("templates", __dir__)
+
+    def ensure_base_class
+      agents_dir = "app/agents"
+      empty_directory agents_dir
+
+      base_class_path = "#{agents_dir}/application_agent.rb"
+      unless File.exist?(File.join(destination_root, base_class_path))
+        template "application_agent.rb.tt", base_class_path
+      end
+    end
+
+    def create_hello_agent
+      create_file "app/agents/hello_agent.rb", <<~RUBY
+        # frozen_string_literal: true
+
+        class HelloAgent < ApplicationAgent
+          system "You are a friendly assistant. Keep responses under 2 sentences."
+
+          prompt "Say hello to {name} and tell them one fun fact."
+        end
+      RUBY
+    end
+
+    def create_smoke_test
+      create_file "bin/smoke_test_agent", <<~RUBY
+        #!/usr/bin/env ruby
+        # frozen_string_literal: true
+
+        # Smoke test — verifies your RubyLLM::Agents setup end-to-end.
+        #
+        # Usage:
+        #   bin/rails runner bin/smoke_test_agent
+        #
+        puts "Running RubyLLM::Agents smoke test..."
+        puts ""
+
+        # 1. Check configuration
+        config = RubyLLM::Agents.configuration
+        model = config.default_model
+        puts "Default model: \#{model}"
+
+        # 2. Dry-run (no API call)
+        puts ""
+        puts "Dry run:"
+        dry = HelloAgent.call(name: "World", dry_run: true)
+        puts "  System prompt: \#{dry.system_prompt[0..80]}..."
+        puts "  User prompt:   \#{dry.user_prompt}"
+        puts "  Model:         \#{dry.model}"
+        puts "  Dry run OK!"
+
+        # 3. Live call
+        puts ""
+        puts "Live call (calling \#{model})..."
+        begin
+          result = HelloAgent.call(name: "World")
+          puts "  Response: \#{result.content}"
+          puts ""
+          puts "Success! Your setup is working."
+        rescue => e
+          puts "  Error: \#{e.class}: \#{e.message}"
+          puts ""
+          puts "The dry run worked but the live call failed."
+          puts "This usually means your API key is missing or invalid."
+          puts ""
+          puts "Run 'rails ruby_llm_agents:doctor' for detailed diagnostics."
+          exit 1
+        end
+      RUBY
+
+      chmod "bin/smoke_test_agent", 0o755
+    end
+
+    def show_next_steps
+      say ""
+      say "Demo agent created!", :green
+      say ""
+      say "Try it:"
+      say "  bin/rails runner bin/smoke_test_agent"
+      say ""
+      say "Or in the Rails console:"
+      say "  HelloAgent.call(name: \"World\")"
+      say "  HelloAgent.call(name: \"World\", dry_run: true)"
+      say ""
+    end
+  end
+end

data/lib/generators/ruby_llm_agents/doctor_generator.rb

@@ -0,0 +1,196 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module RubyLlmAgents
+  # Doctor generator — validates that setup is complete and working.
+  #
+  # Usage:
+  #   rails generate ruby_llm_agents:doctor
+  #   rails ruby_llm_agents:doctor   (rake task alias)
+  #
+  # Checks:
+  #   1. API keys — at least one provider key is configured
+  #   2. Migrations — required tables exist
+  #   3. Routes — engine is mounted
+  #   4. Background jobs — ActiveJob adapter is configured (not :async/:inline in prod)
+  #   5. Agents — at least one agent file exists
+  #
+  class DoctorGenerator < ::Rails::Generators::Base
+    desc "Validate your RubyLLM::Agents setup and print actionable fixes"
+
+    def run_checks
+      @pass = 0
+      @fail = 0
+      @warn = 0
+
+      say ""
+      say "RubyLLM::Agents Doctor", :bold
+      say "=" * 40
+
+      check_api_keys
+      check_migrations
+      check_routes
+      check_background_jobs
+      check_agents
+
+      say ""
+      say "=" * 40
+      summary = "#{@pass} passed, #{@fail} failed, #{@warn} warnings"
+      if @fail > 0
+        say "Result: #{summary}", :red
+      elsif @warn > 0
+        say "Result: #{summary}", :yellow
+      else
+        say "Result: #{summary} — you're all set!", :green
+      end
+      say ""
+    end
+
+    private
+
+    def check_api_keys
+      say ""
+      say "API Keys", :bold
+
+      config = RubyLLM::Agents.configuration
+      providers = {
+        "OpenAI" => -> { config.openai_api_key },
+        "Anthropic" => -> { config.anthropic_api_key },
+        "Gemini" => -> { config.gemini_api_key },
+        "DeepSeek" => -> { config.deepseek_api_key },
+        "OpenRouter" => -> { config.openrouter_api_key },
+        "Mistral" => -> { config.mistral_api_key }
+      }
+
+      configured = providers.select { |_, v| v.call.present? }.keys
+
+      if configured.any?
+        configured.each { |name| pass "#{name} API key configured" }
+      else
+        fail_check "No API keys configured"
+        fix "Add to config/initializers/ruby_llm_agents.rb:"
+        fix "  config.openai_api_key = ENV[\"OPENAI_API_KEY\"]"
+        fix "Then set the environment variable in .env or credentials."
+      end
+    end
+
+    def check_migrations
+      say ""
+      say "Database", :bold
+
+      tables = {
+        "ruby_llm_agents_executions" => "rails generate ruby_llm_agents:install && rails db:migrate",
+        "ruby_llm_agents_execution_details" => "rails generate ruby_llm_agents:upgrade && rails db:migrate"
+      }
+
+      tables.each do |table, fix_cmd|
+        if table_exists?(table)
+          pass "Table #{table} exists"
+        else
+          fail_check "Table #{table} missing"
+          fix fix_cmd
+        end
+      end
+    end
+
+    def check_routes
+      say ""
+      say "Routes", :bold
+
+      routes_file = File.join(destination_root, "config/routes.rb")
+      if File.exist?(routes_file)
+        content = File.read(routes_file)
+        if content.include?("RubyLLM::Agents::Engine")
+          pass "Dashboard engine mounted"
+        else
+          warn_check "Dashboard engine not mounted in routes"
+          fix "Add to config/routes.rb:"
+          fix "  mount RubyLLM::Agents::Engine => \"/agents\""
+        end
+      else
+        warn_check "Could not find config/routes.rb"
+      end
+    end
+
+    def check_background_jobs
+      say ""
+      say "Background Jobs", :bold
+
+      adapter = ActiveJob::Base.queue_adapter.class.name
+      async_logging = RubyLLM::Agents.configuration.async_logging
+
+      if !async_logging
+        pass "Async logging disabled (synchronous mode)"
+      elsif adapter.include?("Async") || adapter.include?("Inline")
+        if Rails.env.production?
+          warn_check "ActiveJob adapter is #{adapter} — execution logging may be lost in production"
+          fix "Configure a persistent adapter (Sidekiq, GoodJob, SolidQueue, etc.)"
+          fix "Or set config.async_logging = false for synchronous logging."
+        else
+          pass "ActiveJob adapter: #{adapter} (OK for development)"
+        end
+      else
+        pass "ActiveJob adapter: #{adapter}"
+      end
+    end
+
+    def check_agents
+      say ""
+      say "Agents", :bold
+
+      agents_dir = File.join(destination_root, "app/agents")
+      if Dir.exist?(agents_dir)
+        agent_files = Dir.glob(File.join(agents_dir, "**/*_agent.rb"))
+          .reject { |f| f.end_with?("application_agent.rb") }
+
+        if agent_files.any?
+          pass "Found #{agent_files.size} agent(s)"
+        else
+          warn_check "No agents found (only application_agent.rb)"
+          fix "rails generate ruby_llm_agents:agent HelloWorld query:required"
+          fix "Or: rails generate ruby_llm_agents:demo"
+        end
+      else
+        fail_check "app/agents/ directory missing"
+        fix "rails generate ruby_llm_agents:install"
+      end
+    end
+
+    # Helpers
+
+    def table_exists?(name)
+      ActiveRecord::Base.connection.table_exists?(name)
+    rescue => e
+      say "  (Could not check database: #{e.message})", :yellow
+      false
+    end
+
+    def pass(msg)
+      @pass += 1
+      say "  #{status_icon(:pass)} #{msg}", :green
+    end
+
+    def fail_check(msg)
+      @fail += 1
+      say "  #{status_icon(:fail)} #{msg}", :red
+    end
+
+    def warn_check(msg)
+      @warn += 1
+      say "  #{status_icon(:warn)} #{msg}", :yellow
+    end
+
+    def fix(msg)
+      say "    Fix: #{msg}"
+    end
+
+    def status_icon(type)
+      case type
+      when :pass then "OK"
+      when :fail then "FAIL"
+      when :warn then "WARN"
+      end
+    end
+  end
+end

data/lib/generators/ruby_llm_agents/install_generator.rb

@@ -96,28 +96,16 @@ module RubyLlmAgents
       say ""
       say "RubyLLM::Agents has been installed!", :green
       say ""
-      say "Directory structure created:"
-      say "  app/"
-      say "  ├── agents/"
-      say "  │   ├── application_agent.rb"
-      say "  │   ├── concerns/"
-      say "  │   └── AGENTS.md"
-      say "  └── tools/"
-      say "      └── TOOLS.md"
-      say ""
-      say "Skill files (*.md) help AI coding assistants understand how to use this gem."
-      say ""
       say "Next steps:"
-      say "  1. Set your API keys in config/initializers/ruby_llm_agents.rb"
+      say "  1. Set your API key in config/initializers/ruby_llm_agents.rb"
       say "  2. Run migrations: rails db:migrate"
-      say "  3. Generate an agent: rails generate ruby_llm_agents:agent MyAgent query:required"
-      say "  4. Access the dashboard at: /agents"
+      say "  3. Verify setup:   rails ruby_llm_agents:doctor"
+      say "  4. Try it out:     rails generate ruby_llm_agents:demo"
+      say ""
+      say "Or generate a custom agent:"
+      say "  rails generate ruby_llm_agents:agent MyAgent query:required"
       say ""
-      say "Generator commands:"
-      say "  rails generate ruby_llm_agents:agent CustomerSupport query:required"
-      say "  rails generate ruby_llm_agents:image_generator Product"
-      say "  rails generate ruby_llm_agents:transcriber Meeting"
-      say "  rails generate ruby_llm_agents:embedder Semantic"
+      say "Dashboard: /agents"
       say ""
     end
 

data/lib/generators/ruby_llm_agents/templates/add_dashboard_performance_indexes_migration.rb.tt

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# Migration to add composite indexes for dashboard query performance
+#
+# These indexes optimize the most frequent dashboard queries:
+# - [status, created_at]: now_strip_data conditional counts, error spike detection, top_errors
+# - [model_id, status]: model_stats GROUP BY with success count
+# - [cache_hit, created_at]: cache_savings queries
+class AddDashboardPerformanceIndexes < ActiveRecord::Migration<%= migration_version %>
+  def change
+    add_index :ruby_llm_agents_executions, [:status, :created_at],
+              name: "idx_executions_status_created_at",
+              if_not_exists: true
+
+    add_index :ruby_llm_agents_executions, [:model_id, :status],
+              name: "idx_executions_model_id_status",
+              if_not_exists: true
+
+    add_index :ruby_llm_agents_executions, [:cache_hit, :created_at],
+              name: "idx_executions_cache_hit_created_at",
+              if_not_exists: true
+  end
+end

data/lib/generators/ruby_llm_agents/templates/agent.rb.tt

@@ -8,108 +8,55 @@
 <%- else -%>
 class <%= class_name %>Agent < ApplicationAgent
 <%- end -%>
-    # ============================================
-    # Model Configuration
-    # ============================================
-
+<% if options[:model] != "default" -%>
     model "<%= options[:model] %>"
+<% end -%>
+<% if options[:temperature] != 0.0 -%>
     temperature <%= options[:temperature] %>
-    # timeout 30  # Per-request timeout in seconds (default: 60)
-
-    # ============================================
-    # Caching
-    # ============================================
-
-<% if options[:cache] -%>
-    cache <%= options[:cache] %>
-<% else -%>
-    # cache 1.hour  # Enable response caching with TTL
 <% end -%>
 
     # ============================================
-    # Reliability (Retries & Fallbacks)
+    # Prompts
     # ============================================
+    # Use {placeholder} syntax — placeholders become required params automatically.
 
-    # Automatic retries with exponential backoff
-    # - max: Number of retry attempts
-    # - backoff: :constant or :exponential
-    # - base: Base delay in seconds
-    # - max_delay: Maximum delay between retries
-    # - on: Additional error classes to retry on
-    # retries max: 2, backoff: :exponential, base: 0.4, max_delay: 3.0
-
-    # Fallback models (tried in order when primary model fails)
-    # fallback_models ["gpt-4o-mini", "claude-3-haiku"]
-
-    # Total timeout across all retry/fallback attempts
-    # total_timeout 30
-
-    # Circuit breaker (prevents repeated calls to failing models)
-    # - errors: Number of errors to trigger open state
-    # - within: Rolling window in seconds
-    # - cooldown: Time to wait before allowing requests again
-    # circuit_breaker errors: 5, within: 60, cooldown: 300
-
-    # ============================================
-    # Parameters
-    # ============================================
+    system "You are a helpful assistant."
 
-<% parsed_params.each do |param| -%>
-    param :<%= param.name %><%= ", required: true" if param.required? %><%= ", default: #{param.default.inspect}" if param.default && !param.required? %>
+<% if parsed_params.any? -%>
+    prompt "<%= parsed_params.map { |p| "{#{p.name}}" }.join(" ") %>"
+<% else -%>
+    prompt "Your prompt here"
 <% end -%>
 
-    private
+<% parsed_params.select { |p| !p.required? && p.default }.each do |param| -%>
+    param :<%= param.name %>, default: <%= param.default.inspect %>
+<% end -%>
+<% if options[:cache] -%>
 
     # ============================================
-    # Prompts (required)
+    # Caching
     # ============================================
 
-    def system_prompt
-      <<~PROMPT
-        You are a helpful assistant.
-        # Define your system instructions here
-      PROMPT
-    end
-
-    def user_prompt
-      # Build the prompt from parameters
-<% if parsed_params.any? -%>
-      <%= parsed_params.first.name %>
-<% else -%>
-      "Your prompt here"
+    cache for: <%= options[:cache] %>
 <% end -%>
-    end
 
     # ============================================
-    # Optional Overrides
+    # Error Handling (uncomment to enable)
     # ============================================
 
-    # Structured output schema (returns parsed hash instead of raw text)
-    # def schema
-    #   @schema ||= RubyLLM::Schema.create do
-    #     string :result, description: "The result"
-    #     integer :confidence, description: "Confidence score 1-100"
-    #     array :tags, description: "Relevant tags" do
-    #       string
-    #     end
-    #   end
-    # end
-
-    # Custom response processing (default: symbolize hash keys)
-    # def process_response(response)
-    #   content = response.content
-    #   # Transform or validate the response
-    #   content
+    # on_failure do
+    #   retries times: 2, backoff: :exponential
+    #   fallback to: ["gpt-4o-mini"]
+    #   timeout 30
     # end
 
-    # Custom metadata to include in execution logs
-    # def metadata
-    #   { custom_field: "value", request_id: params[:request_id] }
-    # end
+    # ============================================
+    # Structured Output (uncomment to enable)
+    # ============================================
 
-    # Custom cache key data (default: all params except skip_cache, dry_run)
-    # def cache_key_data
-    #   { query: params[:query], locale: I18n.locale }
+    # returns do
+    #   string :result, description: "The result"
+    #   integer :confidence, description: "Confidence score 1-100"
     # end
 <%- if class_name.include?("::") -%>
 <%- (class_name.split("::").length - 1).times do |i| -%>