ruby_llm-agents 3.8.0 → 3.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2d24a8046e58bdadf37d70ddb1effb038f69b1fa01c4dd7f9e08bf819527d94
-  data.tar.gz: 0f620acc86ebe001c151c6a95ee784463bb1e10eb66532e7f6d2684ca2021f06
+  metadata.gz: 6925b14509a50c3bbf5efb8d0e37f5a38b4d2f52f13f3c7ecd7af588f832c5c1
+  data.tar.gz: 4332d03ebaf4bd94f3e314656e7f6755475c5ad45661a8c1e76e6e324d37ec2e
 SHA512:
-  metadata.gz: 9bd06ce2399f86359e00a115d269af22d3f73a0ad8a1bc0d21e315c4a41b0a023bd59b9b9504ac3902d65c76195467f6ae232caed955b5b247439e27aca59b7e
-  data.tar.gz: bb2b29a3b6d7c3c4b0312103fe98bd8c3744dc42415280fda8bbb41054c414f489954c1ee869f6b21cb4e98a470eb7f7e9cf8fc63cc05c0810d4f1b635c9bd55
+  metadata.gz: e12ea68a14b7c9ec683ae7b07a14d9d422922fc8e5233d7296fd42bc6100097bb929da87b6c52fe55929779a17c04e59253fa490c40147558392a32a79023fa6
+  data.tar.gz: 9d0d5d249ee0bb6bac741d5c1087ade27ba0a6d032184bb01e1ecfc0d43f79453fbd12cd22e9e4f3eeca7b457bfb242ebca7ebc4e010f44387b9ee8a13bf0865

data/README.md

@@ -206,7 +206,7 @@ puts run.summary
 
 ## Quick Start
 
-### Installation
+### 1. Install
 
 ```ruby
 # Gemfile
@@ -219,29 +219,49 @@ rails generate ruby_llm_agents:install
 rails db:migrate
 ```
 
-### Configure API Keys
+### 2. Set one API key
 
-Configure all provider API keys in one place (v2.1+):
+Uncomment one line in `config/initializers/ruby_llm_agents.rb`:
 
 ```ruby
-# config/initializers/ruby_llm_agents.rb
 RubyLLM::Agents.configure do |config|
   config.openai_api_key = ENV["OPENAI_API_KEY"]
-  config.anthropic_api_key = ENV["ANTHROPIC_API_KEY"]
-  config.gemini_api_key = ENV["GOOGLE_API_KEY"]
 end
 ```
 
-Or use environment variables directly (auto-detected by RubyLLM):
+Then set the environment variable (e.g., in `.env` or Rails credentials).
+
+<details>
+<summary>Other providers</summary>
 
+```ruby
+config.anthropic_api_key = ENV["ANTHROPIC_API_KEY"]
+config.gemini_api_key    = ENV["GOOGLE_API_KEY"]
+config.deepseek_api_key  = ENV["DEEPSEEK_API_KEY"]
+# ... see initializer for full list
+```
+
+Or use environment variables directly (auto-detected by RubyLLM):
 ```bash
-# .env
 OPENAI_API_KEY=sk-...
 ANTHROPIC_API_KEY=sk-ant-...
-GOOGLE_API_KEY=...
+```
+</details>
+
+### 3. Verify setup
+
+```bash
+rails ruby_llm_agents:doctor
+```
+
+### 4. Try it
+
+```bash
+rails generate ruby_llm_agents:demo
+bin/rails runner bin/smoke_test_agent
 ```
 
-### Generate an Agent
+Or generate a custom agent:
 
 ```bash
 rails generate ruby_llm_agents:agent SearchIntent query:required

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

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+module RubyLLM
+  module Agents
+    # Controller for browsing tracked request groups
+    #
+    # Provides listing and detail views for executions grouped by
+    # request_id, as set by RubyLLM::Agents.track blocks.
+    #
+    # @api private
+    class RequestsController < ApplicationController
+      include Paginatable
+
+      # Lists all tracked requests with aggregated stats
+      #
+      # @return [void]
+      def index
+        @sort_column = sanitize_sort_column(params[:sort])
+        @sort_direction = (params[:direction] == "asc") ? "asc" : "desc"
+
+        scope = Execution
+          .where.not(request_id: [nil, ""])
+          .select(
+            "request_id",
+            "COUNT(*) AS call_count",
+            "SUM(total_cost) AS total_cost",
+            "SUM(total_tokens) AS total_tokens",
+            "MIN(started_at) AS started_at",
+            "MAX(completed_at) AS completed_at",
+            "SUM(duration_ms) AS total_duration_ms",
+            "GROUP_CONCAT(DISTINCT agent_type) AS agent_types_list",
+            "GROUP_CONCAT(DISTINCT status) AS statuses_list",
+            "MAX(created_at) AS latest_created_at"
+          )
+          .group(:request_id)
+
+        # Apply time filter
+        days = params[:days].to_i
+        scope = scope.where("created_at >= ?", days.days.ago) if days > 0
+
+        result = paginate_requests(scope)
+        @requests = result[:records]
+        @pagination = result[:pagination]
+
+        # Stats
+        total_scope = Execution.where.not(request_id: [nil, ""])
+        @stats = {
+          total_requests: total_scope.distinct.count(:request_id),
+          total_cost: total_scope.sum(:total_cost) || 0
+        }
+      end
+
+      # Shows a single tracked request with all its executions
+      #
+      # @return [void]
+      def show
+        @request_id = params[:id]
+        @executions = Execution
+          .where(request_id: @request_id)
+          .order(started_at: :asc)
+
+        if @executions.empty?
+          redirect_to ruby_llm_agents.requests_path,
+            alert: "Request not found: #{@request_id}"
+          return
+        end
+
+        @summary = {
+          call_count: @executions.count,
+          total_cost: @executions.sum(:total_cost) || 0,
+          total_tokens: @executions.sum(:total_tokens) || 0,
+          started_at: @executions.minimum(:started_at),
+          completed_at: @executions.maximum(:completed_at),
+          agent_types: @executions.distinct.pluck(:agent_type),
+          models_used: @executions.distinct.pluck(:model_id),
+          all_successful: @executions.where.not(status: "success").count.zero?,
+          error_count: @executions.where(status: "error").count
+        }
+
+        if @summary[:started_at] && @summary[:completed_at]
+          @summary[:duration_ms] = ((@summary[:completed_at] - @summary[:started_at]) * 1000).to_i
+        end
+      end
+
+      private
+
+      ALLOWED_SORT_COLUMNS = %w[latest_created_at call_count total_cost total_tokens total_duration_ms].freeze
+
+      def sanitize_sort_column(column)
+        ALLOWED_SORT_COLUMNS.include?(column) ? column : "latest_created_at"
+      end
+
+      def paginate_requests(scope)
+        page = [(params[:page] || 1).to_i, 1].max
+        per_page = RubyLLM::Agents.configuration.per_page
+
+        total_count = Execution
+          .where.not(request_id: [nil, ""])
+          .distinct
+          .count(:request_id)
+
+        sorted = scope.order("#{@sort_column} #{@sort_direction.upcase}")
+        offset = (page - 1) * per_page
+
+        {
+          records: sorted.offset(offset).limit(per_page),
+          pagination: {
+            current_page: page,
+            per_page: per_page,
+            total_count: total_count,
+            total_pages: (total_count.to_f / per_page).ceil
+          }
+        }
+      end
+    end
+  end
+end

data/app/views/layouts/ruby_llm/agents/application.html.erb

@@ -295,7 +295,8 @@
           <% nav_items = [
             [ruby_llm_agents.root_path, "dashboard"],
             [ruby_llm_agents.agents_path, "agents"],
-            [ruby_llm_agents.executions_path, "executions"]
+            [ruby_llm_agents.executions_path, "executions"],
+            [ruby_llm_agents.requests_path, "requests"]
           ]
           nav_items << [ruby_llm_agents.tenants_path, "tenants"] if tenant_filter_enabled?
           nav_items.each do |path, label| %>
@@ -345,7 +346,8 @@
           <% mobile_nav_items = [
             [ruby_llm_agents.root_path, "dashboard"],
             [ruby_llm_agents.agents_path, "agents"],
-            [ruby_llm_agents.executions_path, "executions"]
+            [ruby_llm_agents.executions_path, "executions"],
+            [ruby_llm_agents.requests_path, "requests"]
           ]
           mobile_nav_items << [ruby_llm_agents.tenants_path, "tenants"] if tenant_filter_enabled?
           mobile_nav_items.each do |path, label| %>

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

@@ -0,0 +1,153 @@
+<div class="flex items-center gap-3 mb-6">
+  <span class="text-[10px] font-medium text-gray-400 dark:text-gray-600 uppercase tracking-widest font-mono">requests</span>
+  <div class="flex-1 border-t border-gray-200 dark:border-gray-800"></div>
+  <span class="font-mono text-[10px] text-gray-400 dark:text-gray-600">
+    <%= number_with_delimiter(@stats[:total_requests]) %> tracked
+    &middot;
+    $<%= number_with_precision(@stats[:total_cost] || 0, precision: 4) %> total
+  </span>
+</div>
+
+<%
+  sort_column = @sort_column
+  sort_direction = @sort_direction
+
+  sort_link = ->(column, label, extra_class: "") {
+    is_active = column == sort_column
+    next_dir = is_active && sort_direction == "asc" ? "desc" : "asc"
+    url = url_for(request.query_parameters.merge(sort: column, direction: next_dir, page: 1))
+
+    arrow = if is_active && sort_direction == "asc"
+              raw('<svg class="w-2.5 h-2.5 inline" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 15l7-7 7 7"/></svg>')
+            elsif is_active
+              raw('<svg class="w-2.5 h-2.5 inline" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7"/></svg>')
+            else
+              ""
+            end
+
+    active_class = is_active ? "text-gray-700 dark:text-gray-300" : ""
+    raw(%(<a href="#{url}" class="group inline-flex items-center gap-0.5 hover:text-gray-700 dark:hover:text-gray-300 #{active_class} #{extra_class}"><span>#{label}</span><span class="#{is_active ? 'opacity-100' : 'opacity-0 group-hover:opacity-50'} transition-opacity">#{arrow}</span></a>))
+  }
+%>
+
+<% if @requests.empty? %>
+  <div class="font-mono text-xs text-gray-400 dark:text-gray-600 py-8 text-center">
+    No tracked requests found. Use <code class="bg-gray-100 dark:bg-gray-800 px-1.5 py-0.5 rounded">RubyLLM::Agents.track { ... }</code> to start tracking.
+  </div>
+<% else %>
+  <!-- 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-36 flex-shrink-0">request_id</span>
+    <span class="flex-1 min-w-0">agents</span>
+    <span class="w-12 flex-shrink-0 text-right"><%= sort_link.call("call_count", "calls", extra_class: "justify-end w-full") %></span>
+    <span class="w-14 flex-shrink-0 text-right hidden sm:block">status</span>
+    <span class="w-16 flex-shrink-0 text-right hidden md:block"><%= sort_link.call("total_duration_ms", "duration", extra_class: "justify-end w-full") %></span>
+    <span class="w-16 flex-shrink-0 text-right hidden md:block"><%= sort_link.call("total_tokens", "tokens", extra_class: "justify-end w-full") %></span>
+    <span class="w-16 flex-shrink-0 text-right"><%= sort_link.call("total_cost", "cost", extra_class: "justify-end w-full") %></span>
+    <span class="w-24 flex-shrink-0 text-right"><%= sort_link.call("latest_created_at", "time", extra_class: "justify-end w-full") %></span>
+  </div>
+
+  <!-- Rows -->
+  <div class="font-mono text-xs space-y-px">
+    <% @requests.each do |req| %>
+      <%
+        statuses = (req.statuses_list || "").split(",")
+        has_errors = statuses.include?("error") || statuses.include?("timeout")
+        all_success = statuses == ["success"]
+        status_class = if has_errors
+          "badge-error"
+        elsif all_success
+          "badge-success"
+        else
+          "badge-running"
+        end
+        status_label = if has_errors
+          "errors"
+        elsif all_success
+          "ok"
+        else
+          "mixed"
+        end
+        agent_names = (req.agent_types_list || "").split(",").map { |a| a.gsub(/Agent$/, "") }
+      %>
+      <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.request_path(req.request_id) %>'">
+        <span class="w-36 flex-shrink-0 truncate text-gray-900 dark:text-gray-200" title="<%= req.request_id %>">
+          <%= truncate(req.request_id, length: 20) %>
+        </span>
+        <span class="flex-1 min-w-0 truncate text-gray-400 dark:text-gray-600">
+          <%= agent_names.first(3).join(", ") %><%= agent_names.size > 3 ? " +#{agent_names.size - 3}" : "" %>
+        </span>
+        <span class="w-12 flex-shrink-0 text-right text-gray-500 dark:text-gray-400"><%= req.call_count %></span>
+        <span class="w-14 flex-shrink-0 text-right hidden sm:block">
+          <span class="badge badge-sm <%= status_class %>"><%= status_label %></span>
+        </span>
+        <span class="w-16 flex-shrink-0 text-right text-gray-500 dark:text-gray-400 hidden md:inline">
+          <%= req.total_duration_ms ? format_duration_ms(req.total_duration_ms.to_i) : "—" %>
+        </span>
+        <span class="w-16 flex-shrink-0 text-right text-gray-500 dark:text-gray-400 hidden md:inline"><%= number_with_delimiter(req.total_tokens || 0) %></span>
+        <span class="w-16 flex-shrink-0 text-right text-gray-500 dark:text-gray-400">$<%= number_with_precision(req.total_cost || 0, precision: 4) %></span>
+        <span class="w-24 flex-shrink-0 text-gray-400 dark:text-gray-600 text-right whitespace-nowrap">
+          <% if req.respond_to?(:latest_created_at) && req.latest_created_at %>
+            <%= time_ago_in_words(req.latest_created_at) %>
+          <% else %>
+            —
+          <% end %>
+        </span>
+      </div>
+    <% end %>
+  </div>
+
+  <%# Pagination %>
+  <% if @pagination && @pagination[:total_pages] > 1 %>
+    <%
+      current_page = @pagination[:current_page]
+      total_pages = @pagination[:total_pages]
+      total_count = @pagination[:total_count]
+      per_page = @pagination[:per_page]
+      from_record = ((current_page - 1) * per_page) + 1
+      to_record = [current_page * per_page, total_count].min
+    %>
+    <div class="flex items-center justify-between font-mono text-xs mt-4 pt-4 border-t border-gray-200 dark:border-gray-800">
+      <span class="text-gray-400 dark:text-gray-600"><%= from_record %>-<%= to_record %> of <%= number_with_delimiter(total_count) %></span>
+      <nav class="flex items-center gap-1">
+        <% if current_page > 1 %>
+          <%= link_to "prev", url_for(request.query_parameters.merge(page: current_page - 1)),
+              class: "px-2 py-0.5 text-gray-400 dark:text-gray-500 hover:text-gray-700 dark:hover:text-gray-300" %>
+        <% else %>
+          <span class="px-2 py-0.5 text-gray-300 dark:text-gray-700">prev</span>
+        <% end %>
+
+        <%
+          window = 2
+          pages_to_show = []
+          (1..total_pages).each do |page|
+            if page <= 1 || page >= total_pages || (page >= current_page - window && page <= current_page + window)
+              pages_to_show << page
+            elsif pages_to_show.last != :gap
+              pages_to_show << :gap
+            end
+          end
+        %>
+
+        <% pages_to_show.each do |page| %>
+          <% if page == :gap %>
+            <span class="px-1 text-gray-400 dark:text-gray-600">...</span>
+          <% elsif page == current_page %>
+            <span class="px-2 py-0.5 text-gray-900 dark:text-gray-100"><%= page %></span>
+          <% else %>
+            <%= link_to page, url_for(request.query_parameters.merge(page: page)),
+                class: "px-2 py-0.5 text-gray-400 dark:text-gray-500 hover:text-gray-700 dark:hover:text-gray-300" %>
+          <% end %>
+        <% end %>
+
+        <% if current_page < total_pages %>
+          <%= link_to "next", url_for(request.query_parameters.merge(page: current_page + 1)),
+              class: "px-2 py-0.5 text-gray-400 dark:text-gray-500 hover:text-gray-700 dark:hover:text-gray-300" %>
+        <% else %>
+          <span class="px-2 py-0.5 text-gray-300 dark:text-gray-700">next</span>
+        <% end %>
+      </nav>
+    </div>
+  <% end %>
+<% end %>

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