ruby_llm-agents 0.3.0 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0cf7b20ca960eab7d26da1c568c5aa5078e12e887a4d93c9b472d6897cf1e5e
-  data.tar.gz: 59372d2c80bd8fdb23d49ffdd672911948bf1b78da8243aaac7df926a378bd59
+  metadata.gz: 26b04f0b8d00a9c87b5555beccacbfc83208be0a370b0fcc6e7ee518c2543282
+  data.tar.gz: 51a1d674af7e489ad6020eb324b13b6509137e035c45bb53d140ca22574fc187
 SHA512:
-  metadata.gz: 1902ad245d20d405fe69633e122a83302bbd5b95e5b65fe0d24b1da14b0effaf27e9308e4a5a42bd9072545b2d128ed173214812667727fb2ea0de43948f1ee1
-  data.tar.gz: d3937f03bc62481c6257c55c9a7f1a8c6eccc9fc08a759c8f40334b21000a12cc67e5277ca0d018b551c3abb6b077d4ffc1caa8bfaa3f2d8e784aac98c1e9bf8
+  metadata.gz: 69635d4258f0082742d1b899e26e21019020e58f904df3a20833c7d7035dc39f139a4d07568a598735b4071e694dff48cf7ca67b37f04ae3f6341d9c32e30f8c
+  data.tar.gz: f655a50e12ce7117f34bf7a1d0cbc3c8b7168233c6fd4ebcd63e5678de92b0d5fad61152f4001a173b201673dcd87380f4a22faa9b6d542210428e3896b7482d

data/README.md

@@ -1,5 +1,7 @@
 # RubyLLM::Agents
 
+[![Gem Version](https://badge.fury.io/rb/ruby_llm-agents.svg)](https://badge.fury.io/rb/ruby_llm-agents)
+
 A powerful Rails engine for building, managing, and monitoring LLM-powered agents using [RubyLLM](https://github.com/crmne/ruby_llm).
 
 ## Features
@@ -12,6 +14,9 @@ A powerful Rails engine for building, managing, and monitoring LLM-powered agent
 - **🛠️ Generators** - Quickly scaffold new agents with customizable templates
 - **🔍 Anomaly Detection** - Automatic warnings for unusual cost or duration patterns
 - **🎯 Type Safety** - Structured output with RubyLLM::Schema integration
+- **⚡ Real-time Streaming** - Stream LLM responses with time-to-first-token tracking
+- **📎 Attachments** - Send images, PDFs, and files to vision-capable models
+- **📋 Rich Results** - Access token counts, costs, timing, and model info from every execution
 - **🔄 Reliability** - Automatic retries, model fallbacks, and circuit breakers for resilient agents
 - **💵 Budget Controls** - Daily/monthly spending limits with hard and soft enforcement
 - **🔔 Alerts** - Slack, webhook, and custom notifications for budget and circuit breaker events
@@ -150,6 +155,210 @@ SearchIntentAgent.call(query: "test", dry_run: true)
 SearchIntentAgent.call(query: "test", skip_cache: true)
 ```
 
+### Streaming Responses
+
+Enable real-time streaming to receive LLM responses as they're generated:
+
+```ruby
+class StreamingAgent < ApplicationAgent
+  model "gpt-4o"
+  streaming true  # Enable streaming for this agent
+
+  param :prompt, required: true
+
+  def user_prompt
+    prompt
+  end
+end
+```
+
+#### Using Streaming with a Block
+
+```ruby
+# Stream responses in real-time
+StreamingAgent.call(prompt: "Write a story") do |chunk|
+  print chunk  # Process each chunk as it arrives
+end
+```
+
+#### HTTP Streaming with ActionController::Live
+
+```ruby
+class StreamingController < ApplicationController
+  include ActionController::Live
+
+  def stream_response
+    response.headers['Content-Type'] = 'text/event-stream'
+    response.headers['Cache-Control'] = 'no-cache'
+
+    StreamingAgent.call(prompt: params[:prompt]) do |chunk|
+      response.stream.write "data: #{chunk}\n\n"
+    end
+  ensure
+    response.stream.close
+  end
+end
+```
+
+#### Time-to-First-Token Tracking
+
+Streaming executions automatically track latency metrics:
+
+```ruby
+execution = RubyLLM::Agents::Execution.last
+execution.streaming?              # => true
+execution.time_to_first_token_ms  # => 245 (milliseconds to first chunk)
+```
+
+#### Global Streaming Configuration
+
+Enable streaming by default for all agents:
+
+```ruby
+# config/initializers/ruby_llm_agents.rb
+RubyLLM::Agents.configure do |config|
+  config.default_streaming = true
+end
+```
+
+### Attachments (Vision & Multimodal)
+
+Send images, PDFs, and other files to vision-capable models using the `with:` option:
+
+```ruby
+class VisionAgent < ApplicationAgent
+  model "gpt-4o"  # Use a vision-capable model
+  param :question, required: true
+
+  def user_prompt
+    question
+  end
+end
+```
+
+#### Single Attachment
+
+```ruby
+# Local file
+VisionAgent.call(question: "Describe this image", with: "photo.jpg")
+
+# URL
+VisionAgent.call(question: "What architecture is shown?", with: "https://example.com/building.jpg")
+```
+
+#### Multiple Attachments
+
+```ruby
+VisionAgent.call(
+  question: "Compare these two screenshots",
+  with: ["screenshot_v1.png", "screenshot_v2.png"]
+)
+```
+
+#### Supported File Types
+
+RubyLLM automatically detects file types:
+
+- **Images:** `.jpg`, `.jpeg`, `.png`, `.gif`, `.webp`, `.bmp`
+- **Videos:** `.mp4`, `.mov`, `.avi`, `.webm`
+- **Audio:** `.mp3`, `.wav`, `.m4a`, `.ogg`, `.flac`
+- **Documents:** `.pdf`, `.txt`, `.md`, `.csv`, `.json`, `.xml`
+- **Code:** `.rb`, `.py`, `.js`, `.html`, `.css`, and many others
+
+#### Debug Mode with Attachments
+
+```ruby
+VisionAgent.call(question: "test", with: "image.png", dry_run: true)
+# => { ..., attachments: "image.png", ... }
+```
+
+### Execution Results
+
+Every agent call returns a `Result` object with full execution metadata:
+
+```ruby
+result = SearchAgent.call(query: "red dress")
+
+# Access the processed response
+result.content            # => { refined_query: "red dress", ... }
+
+# Token usage
+result.input_tokens       # => 150
+result.output_tokens      # => 50
+result.total_tokens       # => 200
+result.cached_tokens      # => 0
+
+# Cost calculation
+result.input_cost         # => 0.000150
+result.output_cost        # => 0.000100
+result.total_cost         # => 0.000250
+
+# Model info
+result.model_id           # => "gpt-4o"
+result.chosen_model_id    # => "gpt-4o" (may differ if fallback used)
+result.temperature        # => 0.0
+
+# Timing
+result.duration_ms        # => 1234
+result.started_at         # => 2025-11-27 10:30:00 UTC
+result.completed_at       # => 2025-11-27 10:30:01 UTC
+result.time_to_first_token_ms # => 245 (streaming only)
+
+# Status
+result.finish_reason      # => "stop", "length", "tool_calls", etc.
+result.streaming?         # => false
+result.success?           # => true
+result.truncated?         # => false (true if hit max_tokens)
+
+# Tool calls (for agents with tools)
+result.tool_calls         # => [{ "id" => "call_abc", "name" => "search", "arguments" => {...} }]
+result.tool_calls_count   # => 1
+result.has_tool_calls?    # => true
+
+# Reliability info
+result.attempts_count     # => 1
+result.used_fallback?     # => false
+```
+
+#### Backward Compatibility
+
+The Result object delegates hash methods to content, so existing code continues to work:
+
+```ruby
+# Old style (still works)
+result[:refined_query]
+result.dig(:nested, :key)
+
+# New style (access metadata)
+result.content[:refined_query]
+result.total_cost
+```
+
+#### Full Metadata Hash
+
+```ruby
+result.to_h
+# => {
+#   content: { refined_query: "red dress", ... },
+#   input_tokens: 150,
+#   output_tokens: 50,
+#   total_tokens: 200,
+#   cached_tokens: 0,
+#   input_cost: 0.000150,
+#   output_cost: 0.000100,
+#   total_cost: 0.000250,
+#   model_id: "gpt-4o",
+#   chosen_model_id: "gpt-4o",
+#   temperature: 0.0,
+#   duration_ms: 1234,
+#   finish_reason: "stop",
+#   streaming: false,
+#   tool_calls: [...],
+#   tool_calls_count: 0,
+#   ...
+# }
+```
+
 ## Usage Guide
 
 ### Agent DSL
@@ -680,6 +889,9 @@ RubyLLM::Agents.configure do |config|
   # Default timeout for LLM requests (in seconds)
   config.default_timeout = 60
 
+  # Enable streaming by default for all agents
+  config.default_streaming = false
+
   # ============================================================================
   # Caching Configuration
   # ============================================================================
@@ -866,6 +1078,18 @@ trend = RubyLLM::Agents::Execution.trend_analysis(
 # ]
 ```
 
+### Streaming Analytics
+
+```ruby
+# Percentage of executions using streaming
+RubyLLM::Agents::Execution.streaming_rate
+# => 45.5
+
+# Average time-to-first-token for streaming executions (milliseconds)
+RubyLLM::Agents::Execution.avg_time_to_first_token
+# => 245.3
+```
+
 ### Scopes
 
 Chain scopes for complex queries:
@@ -919,6 +1143,10 @@ expensive_slow_failures = RubyLLM::Agents::Execution
 
 # Token usage
 .high_token_usage(threshold)
+
+# Streaming
+.streaming
+.non_streaming
 ```
 
 ## Generators

data/app/models/ruby_llm/agents/execution/scopes.rb

@@ -256,6 +256,16 @@ module RubyLLM
           scope :content_filtered, -> { where(finish_reason: "content_filter") }
           scope :tool_calls, -> { where(finish_reason: "tool_calls") }
 
+          # @!method with_tool_calls
+          #   Returns executions that made tool calls
+          #   @return [ActiveRecord::Relation]
+
+          # @!method without_tool_calls
+          #   Returns executions that did not make tool calls
+          #   @return [ActiveRecord::Relation]
+          scope :with_tool_calls, -> { where("tool_calls_count > 0") }
+          scope :without_tool_calls, -> { where(tool_calls_count: 0) }
+
           # @!endgroup
         end
 

data/app/models/ruby_llm/agents/execution.rb

@@ -219,6 +219,13 @@ module RubyLLM
         finish_reason == "content_filter"
       end
 
+      # Returns whether this execution made tool calls
+      #
+      # @return [Boolean] true if tool calls were made
+      def has_tool_calls?
+        tool_calls_count.to_i > 0
+      end
+
       # Returns real-time dashboard data for the Now Strip
       #
       # @return [Hash] Now strip metrics

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

@@ -322,6 +322,15 @@
     .badge-timeout {
       @apply bg-yellow-100 dark:bg-yellow-900 text-yellow-800 dark:text-yellow-200;
     }
+    .badge-cyan {
+      @apply bg-cyan-100 dark:bg-cyan-900/50 text-cyan-700 dark:text-cyan-300;
+    }
+    .badge-purple {
+      @apply bg-purple-100 dark:bg-purple-900/50 text-purple-700 dark:text-purple-300;
+    }
+    .badge-orange {
+      @apply bg-orange-100 dark:bg-orange-900/50 text-orange-700 dark:text-orange-300;
+    }
   </style>
   </head>
 
@@ -581,7 +590,7 @@
       data-controller="theme"
     >
       <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-4">
-        <div class="flex items-center justify-between">
+        <div class="flex flex-col sm:flex-row items-center sm:justify-between gap-3 sm:gap-0">
           <div class="flex items-center space-x-2">
             <label
               for="theme-select"
@@ -606,7 +615,7 @@
             </select>
           </div>
 
-          <p class="text-sm text-gray-500 dark:text-gray-400">
+          <p class="text-sm text-gray-500 dark:text-gray-400 text-center">
             Powered by
             <a href="https://github.com/adham90/ruby_llm-agents" class="text-blue-600 dark:text-blue-400 hover:underline">ruby_llm-agents</a>
           </p>

data/app/views/rubyllm/agents/agents/_agent.html.erb

@@ -0,0 +1,87 @@
+<%= link_to ruby_llm_agents.agent_path(agent[:name]), class: "block bg-white dark:bg-gray-800 rounded-lg shadow hover:shadow-md transition-shadow" do %>
+  <div class="p-4 sm:p-5">
+    <!-- Row 1: Agent name + badge + model/timestamp -->
+    <div class="flex items-center justify-between gap-2">
+      <div class="flex items-center gap-2 min-w-0">
+        <h3 class="font-semibold text-gray-900 dark:text-gray-100 truncate">
+          <%= agent[:name].gsub(/Agent$/, '') %>
+        </h3>
+        <span class="hidden sm:inline text-sm text-gray-500 dark:text-gray-400">v<%= agent[:version] %></span>
+        <% if agent[:active] %>
+          <span class="inline-flex items-center px-1.5 py-0.5 rounded text-[10px] font-medium bg-green-100 dark:bg-green-900/50 text-green-800 dark:text-green-300">Active</span>
+        <% else %>
+          <span class="inline-flex items-center px-1.5 py-0.5 rounded text-[10px] font-medium bg-gray-100 dark:bg-gray-700 text-gray-600 dark:text-gray-400">Deleted</span>
+        <% end %>
+      </div>
+      <!-- Desktop: model -->
+      <span class="hidden sm:block text-sm text-gray-500 dark:text-gray-400"><%= agent[:model] %></span>
+      <!-- Mobile: last executed -->
+      <span class="sm:hidden text-xs text-gray-400 dark:text-gray-500 whitespace-nowrap">
+        <% if agent[:last_executed] %>
+          <%= time_ago_in_words(agent[:last_executed]) %> ago
+        <% else %>
+          Never
+        <% end %>
+      </span>
+    </div>
+
+    <!-- Row 2: Stats -->
+    <div class="mt-2 sm:mt-3 sm:border-t sm:border-gray-100 sm:dark:border-gray-700 sm:pt-3">
+      <!-- Mobile: compact inline -->
+      <% success_rate = agent[:success_rate] || 0 %>
+      <div class="sm:hidden text-xs text-gray-500 dark:text-gray-400">
+        <%= number_with_delimiter(agent[:execution_count]) %> runs
+        <span class="mx-1 text-gray-300 dark:text-gray-600">·</span>
+        $<%= number_with_precision(agent[:total_cost] || 0, precision: 2) %>
+        <span class="mx-1 text-gray-300 dark:text-gray-600">·</span>
+        <span class="<%= success_rate >= 95 ? 'text-green-600 dark:text-green-400' : success_rate >= 80 ? 'text-yellow-600 dark:text-yellow-400' : 'text-red-600 dark:text-red-400' %>">
+          <%= success_rate %>%
+        </span>
+      </div>
+
+      <!-- Desktop: full stats with icons -->
+      <div class="hidden sm:flex items-center justify-between text-sm">
+        <div class="flex items-center space-x-6">
+          <!-- Executions -->
+          <div class="flex items-center text-gray-600 dark:text-gray-300">
+            <svg class="w-4 h-4 mr-1.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z" />
+            </svg>
+            <span><%= number_with_delimiter(agent[:execution_count]) %> executions</span>
+          </div>
+
+          <!-- Cost -->
+          <div class="flex items-center text-gray-600 dark:text-gray-300">
+            <svg class="w-4 h-4 mr-1.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8c-1.657 0-3 .895-3 2s1.343 2 3 2 3 .895 3 2-1.343 2-3 2m0-8c1.11 0 2.08.402 2.599 1M12 8V7m0 1v8m0 0v1m0-1c-1.11 0-2.08-.402-2.599-1M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
+            </svg>
+            <span>$<%= number_with_precision(agent[:total_cost] || 0, precision: 4) %></span>
+          </div>
+
+          <!-- Success Rate -->
+          <div class="flex items-center">
+            <% if success_rate >= 95 %>
+              <span class="w-2 h-2 rounded-full bg-green-500 mr-1.5"></span>
+              <span class="text-green-600 dark:text-green-400"><%= success_rate %>%</span>
+            <% elsif success_rate >= 80 %>
+              <span class="w-2 h-2 rounded-full bg-yellow-500 mr-1.5"></span>
+              <span class="text-yellow-600 dark:text-yellow-400"><%= success_rate %>%</span>
+            <% else %>
+              <span class="w-2 h-2 rounded-full bg-red-500 mr-1.5"></span>
+              <span class="text-red-600 dark:text-red-400"><%= success_rate %>%</span>
+            <% end %>
+          </div>
+        </div>
+
+        <!-- Last Executed -->
+        <div class="text-gray-400 dark:text-gray-500">
+          <% if agent[:last_executed] %>
+            <%= time_ago_in_words(agent[:last_executed]) %> ago
+          <% else %>
+            Never executed
+          <% end %>
+        </div>
+      </div>
+    </div>
+  </div>
+<% end %>

data/app/views/rubyllm/agents/agents/index.html.erb

@@ -12,78 +12,9 @@
     <p class="mt-1 text-sm text-gray-500 dark:text-gray-400">Create an agent by running <code class="bg-gray-100 dark:bg-gray-700 dark:text-gray-200 px-1 rounded">rails g ruby_llm_agents:agent YourAgentName</code></p>
   </div>
 <% else %>
-  <div class="space-y-4">
+  <div class="space-y-3 sm:space-y-4">
     <% @agents.each do |agent| %>
-      <%= link_to ruby_llm_agents.agent_path(agent[:name]), class: "block bg-white dark:bg-gray-800 rounded-lg shadow hover:shadow-md transition-shadow" do %>
-        <div class="p-5">
-          <!-- Header Row -->
-          <div class="flex items-start justify-between mb-3">
-            <div class="flex items-center space-x-3">
-              <h3 class="text-lg font-semibold text-gray-900 dark:text-gray-100">
-                <%= agent[:name].gsub(/Agent$/, '') %>
-              </h3>
-              <span class="text-sm text-gray-500 dark:text-gray-400">v<%= agent[:version] %></span>
-              <% if agent[:active] %>
-                <span class="inline-flex items-center px-2 py-0.5 rounded text-xs font-medium bg-green-100 dark:bg-green-900/50 text-green-800 dark:text-green-300">
-                  Active
-                </span>
-              <% else %>
-                <span class="inline-flex items-center px-2 py-0.5 rounded text-xs font-medium bg-gray-100 dark:bg-gray-700 text-gray-600 dark:text-gray-400">
-                  Deleted
-                </span>
-              <% end %>
-            </div>
-            <div class="text-right">
-              <p class="text-sm text-gray-500 dark:text-gray-400"><%= agent[:model] %></p>
-            </div>
-          </div>
-
-          <!-- Stats Row -->
-          <div class="flex items-center justify-between text-sm border-t border-gray-100 dark:border-gray-700 pt-3">
-            <div class="flex items-center space-x-6">
-              <!-- Executions -->
-              <div class="flex items-center text-gray-600 dark:text-gray-300">
-                <svg class="w-4 h-4 mr-1.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                  <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z" />
-                </svg>
-                <span><%= number_with_delimiter(agent[:execution_count]) %> executions</span>
-              </div>
-
-              <!-- Cost -->
-              <div class="flex items-center text-gray-600 dark:text-gray-300">
-                <svg class="w-4 h-4 mr-1.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                  <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8c-1.657 0-3 .895-3 2s1.343 2 3 2 3 .895 3 2-1.343 2-3 2m0-8c1.11 0 2.08.402 2.599 1M12 8V7m0 1v8m0 0v1m0-1c-1.11 0-2.08-.402-2.599-1M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
-                </svg>
-                <span>$<%= number_with_precision(agent[:total_cost] || 0, precision: 4) %></span>
-              </div>
-
-              <!-- Success Rate -->
-              <div class="flex items-center">
-                <% success_rate = agent[:success_rate] || 0 %>
-                <% if success_rate >= 95 %>
-                  <span class="w-2 h-2 rounded-full bg-green-500 mr-1.5"></span>
-                  <span class="text-green-600 dark:text-green-400"><%= success_rate %>%</span>
-                <% elsif success_rate >= 80 %>
-                  <span class="w-2 h-2 rounded-full bg-yellow-500 mr-1.5"></span>
-                  <span class="text-yellow-600 dark:text-yellow-400"><%= success_rate %>%</span>
-                <% else %>
-                  <span class="w-2 h-2 rounded-full bg-red-500 mr-1.5"></span>
-                  <span class="text-red-600 dark:text-red-400"><%= success_rate %>%</span>
-                <% end %>
-              </div>
-            </div>
-
-            <!-- Last Executed -->
-            <div class="text-gray-400 dark:text-gray-500">
-              <% if agent[:last_executed] %>
-                <%= time_ago_in_words(agent[:last_executed]) %> ago
-              <% else %>
-                Never executed
-              <% end %>
-            </div>
-          </div>
-        </div>
-      <% end %>
+      <%= render partial: "rubyllm/agents/agents/agent", locals: { agent: agent } %>
     <% end %>
   </div>
 <% end %>

data/app/views/rubyllm/agents/agents/show.html.erb

@@ -61,8 +61,26 @@
       <% end %>
     </div>
 
-    <div class="text-right text-sm text-gray-500 dark:text-gray-400">
-      <p><%= @stats[:count] %> total executions</p>
+    <div class="text-right">
+      <p class="text-sm text-gray-500 dark:text-gray-400">
+        <%= number_with_delimiter(@stats[:count]) %> total executions
+      </p>
+      <div class="flex items-center justify-end gap-3 mt-1">
+        <% status_colors = {
+            "success" => "bg-green-500",
+            "error" => "bg-red-500",
+            "timeout" => "bg-yellow-500",
+            "running" => "bg-blue-500"
+          } %>
+        <% @status_distribution.each do |status, count| %>
+          <div class="flex items-center gap-1">
+            <span class="w-2 h-2 rounded-full <%= status_colors[status] || 'bg-gray-400' %> <%= status == 'running' ? 'animate-pulse' : '' %>"></span>
+            <span class="text-xs text-gray-600 dark:text-gray-400">
+              <%= number_with_delimiter(count) %>
+            </span>
+          </div>
+        <% end %>
+      </div>
     </div>
   </div>
 </div>
@@ -199,37 +217,6 @@
   </div>
 </div>
 
-<!-- Status Distribution (compact) -->
-<div class="bg-white dark:bg-gray-800 rounded-lg shadow p-4 mb-6">
-  <div class="flex items-center justify-between">
-    <p class="text-sm text-gray-500 dark:text-gray-400 uppercase">Status Distribution</p>
-
-    <div class="flex flex-wrap gap-4">
-      <% status_colors = {
-          "success" => "#10B981",
-          "error" => "#EF4444",
-          "timeout" => "#F59E0B",
-          "running" => "#3B82F6"
-        } %>
-
-      <% @status_distribution.each do |status, count| %>
-        <div class="flex items-center">
-          <span
-            class="w-2 h-2 rounded-full mr-1.5"
-            style="background-color: <%= status_colors[status] || '#6B7280' %>"
-          ></span>
-
-          <span class="text-sm text-gray-700 dark:text-gray-300 capitalize"><%= status %></span>
-
-          <span class="text-sm font-medium text-gray-900 dark:text-gray-100 ml-1">
-            (<%= number_with_delimiter(count) %>)
-          </span>
-        </div>
-      <% end %>
-    </div>
-  </div>
-</div>
-
 <!-- Finish Reason Distribution -->
 <% if @finish_reason_distribution.present? && @finish_reason_distribution.any? %>
   <div class="bg-white dark:bg-gray-800 rounded-lg shadow p-4 mb-6">

data/app/views/rubyllm/agents/dashboard/_action_center.html.erb

@@ -9,11 +9,11 @@
 
     <div class="space-y-2">
       <% critical_alerts.each do |alert| %>
-        <div class="flex items-center justify-between bg-white dark:bg-gray-800 rounded-lg px-4 py-3 shadow-sm">
+        <div class="flex flex-col sm:flex-row sm:items-center sm:justify-between gap-2 sm:gap-0 bg-white dark:bg-gray-800 rounded-lg px-4 py-3 shadow-sm">
           <% case alert[:type] %>
           <% when :breaker %>
             <div class="flex items-center">
-              <span class="w-2 h-2 bg-orange-500 rounded-full mr-3"></span>
+              <span class="w-2 h-2 bg-orange-500 rounded-full mr-3 flex-shrink-0"></span>
               <div>
                 <p class="text-sm font-medium text-gray-900 dark:text-gray-100">
                   Circuit breaker open: <%= alert[:data][:agent_type].gsub(/Agent$/, '') %>
@@ -23,13 +23,13 @@
                 </p>
               </div>
             </div>
-            <span class="text-xs text-orange-600 dark:text-orange-400 font-medium">
+            <span class="text-xs text-orange-600 dark:text-orange-400 font-medium ml-5 sm:ml-0">
               <%= alert[:data][:cooldown_remaining] %>s remaining
             </span>
 
           <% when :budget_breach %>
             <div class="flex items-center">
-              <span class="w-2 h-2 bg-red-500 rounded-full mr-3"></span>
+              <span class="w-2 h-2 bg-red-500 rounded-full mr-3 flex-shrink-0"></span>
               <div>
                 <p class="text-sm font-medium text-gray-900 dark:text-gray-100">
                   <%= alert[:data][:period].to_s.capitalize %> budget exceeded
@@ -39,11 +39,11 @@
                 </p>
               </div>
             </div>
-            <%= link_to "Adjust", ruby_llm_agents.settings_path, class: "text-xs text-red-600 dark:text-red-400 hover:underline font-medium" %>
+            <%= link_to "Adjust", ruby_llm_agents.settings_path, class: "text-xs text-red-600 dark:text-red-400 hover:underline font-medium ml-5 sm:ml-0" %>
 
           <% when :error_spike %>
             <div class="flex items-center">
-              <span class="w-2 h-2 bg-red-500 rounded-full mr-3 animate-pulse"></span>
+              <span class="w-2 h-2 bg-red-500 rounded-full mr-3 flex-shrink-0 animate-pulse"></span>
               <div>
                 <p class="text-sm font-medium text-gray-900 dark:text-gray-100">
                   Error spike detected
@@ -53,7 +53,7 @@
                 </p>
               </div>
             </div>
-            <%= link_to "View failures", ruby_llm_agents.executions_path(status: "error"), class: "text-xs text-red-600 dark:text-red-400 hover:underline font-medium" %>
+            <%= link_to "View failures", ruby_llm_agents.executions_path(status: "error"), class: "text-xs text-red-600 dark:text-red-400 hover:underline font-medium ml-5 sm:ml-0" %>
           <% end %>
         </div>
       <% end %>