ruby_llm-agents 1.2.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a14dc618496842dd6db2fc197ab5c4f4190fb635b1bad8765a0983cc00e2550d
-  data.tar.gz: 22132d6e59964206dccb41db60dd3a9939217d47d6925074523bc1027173f4ed
+  metadata.gz: b6f99247af4fcb9e76776ab2658bac4914d5b869423258bf3827583212447146
+  data.tar.gz: a6927cced434962ed4b923717d7fd582e983c3091ac8172554afb68671a2514d
 SHA512:
-  metadata.gz: c4936cf3773b4864bb9d1dd8031fb23e8321435bc4c1730ac088f299cc60f5a88992496b317f3391a131a303a6c82666ca7c4d1b77e4ea7da2f8c033e01a8c43
-  data.tar.gz: ca34cddc439b2f80652f9748dc62bd5fa1d365feac68101f7567e15f1bc5c2fef4dcec97e552b1dde7a20744782143c1ef5bffc2c7aaa97083b7d2f36bcf600c
+  metadata.gz: c98ae91fde73edf152ac4efc5665fe5da30e17ec14ff9f2f9128102bf4665530f55196e705dc371f0dac2354af4ab7a2102be9c04b3b7ec2e8331b7b5445ce23
+  data.tar.gz: af36432d85c4ac5ee6219eba846411dd4ffaa0ba8d8c9998550ea3d3e757fd125fa8a2bea3cc5c98a0387db519cc03b45d1fd3f3d63de5facc2dc84338b02692

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

@@ -214,7 +214,7 @@
             <%
               nav_items = [
                 { path: ruby_llm_agents.root_path, label: "Dashboard", icon: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 12l2-2m0 0l7-7 7 7M5 10v10a1 1 0 001 1h3m10-11l2 2m-2-2v10a1 1 0 01-1 1h-3m-6 0a1 1 0 001-1v-4a1 1 0 011-1h2a1 1 0 011 1v4a1 1 0 001 1m-6 0h6" />' },
-                { path: ruby_llm_agents.agents_path, label: "Agents", icon: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9.75 17L9 20l-1 1h8l-1-1-.75-3M3 13h18M5 17h14a2 2 0 002-2V5a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z" />' },
+                { path: ruby_llm_agents.agents_path, label: "Agents", icon: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 3v2m6-2v2M9 19v2m6-2v2M5 9H3m2 6H3m18-6h-2m2 6h-2M7 19h10a2 2 0 002-2V7a2 2 0 00-2-2H7a2 2 0 00-2 2v10a2 2 0 002 2zM9 9h6v6H9V9z"/>' },
                 { path: ruby_llm_agents.workflows_path, label: "Workflows", icon: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 5a1 1 0 011-1h14a1 1 0 011 1v2a1 1 0 01-1 1H5a1 1 0 01-1-1V5zm0 8a1 1 0 011-1h6a1 1 0 011 1v6a1 1 0 01-1 1H5a1 1 0 01-1-1v-6zm12 0a1 1 0 011-1h2a1 1 0 011 1v6a1 1 0 01-1 1h-2a1 1 0 01-1-1v-6z"/>' },
                 { path: ruby_llm_agents.executions_path, label: "Executions", icon: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-3 7h3m-3 4h3m-6-4h.01M9 16h.01" />' },
                 { path: ruby_llm_agents.tenants_path, label: "Tenants", icon: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 21V5a2 2 0 00-2-2H7a2 2 0 00-2 2v16m14 0h2m-2 0h-5m-9 0H3m2 0h5M9 7h1m-1 4h1m4-4h1m-1 4h1m-5 10v-5a1 1 0 011-1h2a1 1 0 011 1v5m-4 0h4" />' }

data/app/views/ruby_llm/agents/agents/_empty_state.html.erb

@@ -1,23 +1,26 @@
-<%
-  type = local_assigns[:type] || "agents"
-  is_workflow = type == "workflows"
-%>
-<div class="bg-white dark:bg-gray-800 rounded-lg shadow p-8 text-center">
-  <svg class="mx-auto h-12 w-12 text-gray-400 dark:text-gray-500" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-    <% if is_workflow %>
-      <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 5a1 1 0 011-1h14a1 1 0 011 1v2a1 1 0 01-1 1H5a1 1 0 01-1-1V5zm0 8a1 1 0 011-1h6a1 1 0 011 1v6a1 1 0 01-1 1H5a1 1 0 01-1-1v-6zm12 0a1 1 0 011-1h2a1 1 0 011 1v6a1 1 0 01-1 1h-2a1 1 0 01-1-1v-6z"/>
-    <% else %>
-      <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9.75 17L9 20l-1 1h8l-1-1-.75-3M3 13h18M5 17h14a2 2 0 002-2V5a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z" />
-    <% end %>
+<div class="bg-white dark:bg-gray-800 rounded-xl border border-gray-200 dark:border-gray-700 p-8 text-center">
+  <!-- Agent Icon - Blue -->
+  <svg class="mx-auto h-16 w-16 text-blue-500 dark:text-blue-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M9 3v2m6-2v2M9 19v2m6-2v2M5 9H3m2 6H3m18-6h-2m2 6h-2M7 19h10a2 2 0 002-2V7a2 2 0 00-2-2H7a2 2 0 00-2 2v10a2 2 0 002 2zM9 9h6v6H9V9z"/>
   </svg>
-  <h3 class="mt-2 text-sm font-medium text-gray-900 dark:text-gray-100">
-    No <%= type %> found
+
+  <h3 class="mt-4 text-lg font-medium text-gray-900 dark:text-gray-100">
+    No agents yet
   </h3>
-  <p class="mt-1 text-sm text-gray-500 dark:text-gray-400">
-    <% if is_workflow %>
-      Create a workflow by subclassing <code class="bg-gray-100 dark:bg-gray-700 dark:text-gray-200 px-1 rounded">Pipeline</code>, <code class="bg-gray-100 dark:bg-gray-700 dark:text-gray-200 px-1 rounded">Parallel</code>, or <code class="bg-gray-100 dark:bg-gray-700 dark:text-gray-200 px-1 rounded">Router</code>
-    <% else %>
-      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>
-    <% end %>
+
+  <p class="mt-2 text-sm text-gray-500 dark:text-gray-400 max-w-md mx-auto">
+    Create an agent by inheriting from <code class="bg-blue-100 dark:bg-blue-900/50 text-blue-700 dark:text-blue-300 px-1.5 py-0.5 rounded font-mono text-xs">ApplicationAgent</code>
   </p>
+
+  <!-- Code Example -->
+  <div class="mt-6 max-w-sm mx-auto">
+    <pre class="bg-gray-900 dark:bg-gray-950 rounded-lg p-4 text-left text-sm overflow-x-auto"><code class="text-gray-300"><span class="text-pink-400">class</span> <span class="text-yellow-300">MyAgent</span> <span class="text-pink-400">&lt;</span> <span class="text-yellow-300">ApplicationAgent</span>
+  <span class="text-purple-400">model</span> <span class="text-green-400">"gpt-4o-mini"</span>
+  <span class="text-purple-400">param</span> <span class="text-blue-400">:query</span>, <span class="text-blue-400">required:</span> <span class="text-orange-400">true</span>
+
+  <span class="text-pink-400">def</span> <span class="text-blue-300">user_prompt</span>
+    <span class="text-gray-300">query</span>
+  <span class="text-pink-400">end</span>
+<span class="text-pink-400">end</span></code></pre>
+  </div>
 </div>

data/app/views/ruby_llm/agents/workflows/_empty_state.html.erb

@@ -0,0 +1,22 @@
+<div class="bg-white dark:bg-gray-800 rounded-xl border border-gray-200 dark:border-gray-700 p-8 text-center">
+  <!-- Workflow Icon - Emerald -->
+  <svg class="mx-auto h-16 w-16 text-emerald-500 dark:text-emerald-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"/>
+  </svg>
+
+  <h3 class="mt-4 text-lg font-medium text-gray-900 dark:text-gray-100">
+    No workflows yet
+  </h3>
+
+  <p class="mt-2 text-sm text-gray-500 dark:text-gray-400 max-w-md mx-auto">
+    Create a workflow by inheriting from <code class="bg-emerald-100 dark:bg-emerald-900/50 text-emerald-700 dark:text-emerald-300 px-1.5 py-0.5 rounded font-mono text-xs">ApplicationWorkflow</code> and defining steps
+  </p>
+
+  <!-- Code Example -->
+  <div class="mt-6 max-w-sm mx-auto">
+    <pre class="bg-gray-900 dark:bg-gray-950 rounded-lg p-4 text-left text-sm overflow-x-auto"><code class="text-gray-300"><span class="text-pink-400">class</span> <span class="text-yellow-300">MyWorkflow</span> <span class="text-pink-400">&lt;</span> <span class="text-yellow-300">ApplicationWorkflow</span>
+  <span class="text-purple-400">step</span> <span class="text-emerald-400">:analyze</span>, <span class="text-yellow-300">AnalyzerAgent</span>
+  <span class="text-purple-400">step</span> <span class="text-emerald-400">:summarize</span>, <span class="text-yellow-300">SummarizerAgent</span>
+<span class="text-pink-400">end</span></code></pre>
+  </div>
+</div>

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

@@ -7,7 +7,7 @@
 </div>
 
 <% if @workflows.empty? %>
-  <%= render "ruby_llm/agents/agents/empty_state", type: "workflows" %>
+  <%= render "ruby_llm/agents/workflows/empty_state" %>
 <% else %>
   <div class="bg-white dark:bg-gray-800 rounded-lg shadow overflow-hidden">
     <div class="overflow-x-auto">

data/lib/ruby_llm/agents/core/configuration.rb

@@ -353,21 +353,21 @@ module RubyLLM
       #     config.async_max_concurrency = 20
 
       # @!attribute [rw] root_directory
-      #   The root directory name under app/ for all LLM components.
+      #   The root directory name under app/ for all agent components.
       #   This allows customization of the directory structure.
-      #   @return [String] Directory name (default: "llm")
+      #   @return [String] Directory name (default: "agents")
       #   @example
-      #     config.root_directory = "ai"  # Creates app/ai/ instead of app/llm/
+      #     config.root_directory = "ai"  # Creates app/ai/ instead of app/agents/
 
       # @!attribute [rw] root_namespace
-      #   The root namespace for all LLM component classes.
-      #   This should match the root_directory in camelized form.
-      #   Set to nil or "" to use no namespace (classes at top-level).
-      #   @return [String, nil] Namespace (default: "Llm")
+      #   The root namespace for all agent component classes.
+      #   When set, subdirectory namespaces are prefixed with this.
+      #   Set to nil or "" to use no root namespace.
+      #   @return [String, nil] Namespace (default: nil)
       #   @example Custom namespace
-      #     config.root_namespace = "AI"  # Uses AI:: instead of Llm::
-      #   @example No namespace (top-level classes)
-      #     config.root_namespace = nil   # Uses top-level classes (ApplicationAgent, etc.)
+      #     config.root_namespace = "AI"  # app/agents/embedders -> AI::Embedders
+      #   @example No namespace (default)
+      #     config.root_namespace = nil   # app/agents/embedders -> Embedders
 
       # Attributes without validation (simple accessors)
       attr_accessor :default_model,
@@ -821,26 +821,18 @@ module RubyLLM
 
       # Returns the full namespace for a given category
       #
-      # @param category [Symbol, nil] Category (:audio, :image, :text, or nil for root)
+      # @param category [Symbol, String, nil] Category (e.g., :embedders, :images, or nil for root)
       # @return [String, nil] Full namespace string, or nil if no namespace configured
-      # @example With root_namespace = "Llm"
-      #   namespace_for(:image) #=> "Llm::Image"
-      #   namespace_for(nil)    #=> "Llm"
+      # @example With root_namespace = "AI"
+      #   namespace_for(:embedders) #=> "AI::Embedders"
+      #   namespace_for(nil)        #=> "AI"
       # @example With no namespace (root_namespace = nil)
-      #   namespace_for(:image) #=> "Image"
-      #   namespace_for(nil)    #=> nil
+      #   namespace_for(:embedders) #=> "Embedders"
+      #   namespace_for(nil)        #=> nil
       def namespace_for(category = nil)
-        category_namespace = case category
-        when :images then "Images"
-        when :audio then "Audio"
-        when :embedders then "Embedders"
-        when :moderators then "Moderators"
-        when :workflows then "Workflows"
-        when :text then "Text"
-        when :image then "Image"
-        end
+        category_namespace = category&.to_s&.camelize
 
-        if root_namespace
+        if root_namespace.present?
           category_namespace ? "#{root_namespace}::#{category_namespace}" : root_namespace
         else
           category_namespace

data/lib/ruby_llm/agents/core/version.rb

@@ -4,6 +4,6 @@ module RubyLLM
   module Agents
     # Current version of the RubyLLM::Agents gem
     # @return [String] Semantic version string
-    VERSION = "1.2.0"
+    VERSION = "1.2.1"
   end
 end

data/lib/ruby_llm/agents/rails/engine.rb

@@ -170,14 +170,16 @@ module RubyLLM
         g.factory_bot dir: "spec/factories"
       end
 
-      # Adds the host app's LLM directories to Rails autoload paths
+      # Adds the host app's agent directories to Rails autoload paths
       #
-      # This allows agent classes and other LLM components defined in app/llm/
+      # This allows agent classes and other components defined in app/agents/
       # to be automatically loaded without explicit requires.
       #
-      # Supports two structures:
-      # 1. New grouped structure: app/llm/agents/, app/llm/tools/, etc.
-      # 2. Legacy flat structure: app/agents/ (for backwards compatibility)
+      # Supports subdirectory namespacing:
+      # - app/agents/ (top-level, no namespace)
+      # - app/agents/embedders/ -> Embedders namespace
+      # - app/agents/images/ -> Images namespace
+      # - app/workflows/ (top-level, no namespace)
       #
       # @api private
       initializer "ruby_llm_agents.autoload_agents", before: :set_autoload_paths do |app|
@@ -210,42 +212,34 @@ module RubyLLM
 
       # Determines the namespace constant for a given path
       #
-      # @param path [String] Relative path like "app/llm/agents"
+      # @param path [String] Relative path like "app/agents/embedders"
       # @param config [Configuration] Current configuration
       # @return [Module, nil] Namespace module or nil for top-level
       # @api private
       def self.namespace_for_path(path, config)
-        # Parse the path to determine namespace
         parts = path.split("/")
-        return nil unless parts.length >= 3
 
-        category = parts[2] # e.g., "agents", "audio", "image", "text"
+        # app/workflows -> no namespace (top-level workflows)
+        return nil if parts == ["app", "workflows"]
 
-        # Determine the namespace name based on category and root_namespace setting
+        # Need at least app/{root_directory}
+        return nil unless parts.length >= 2 && parts[0] == "app"
+        return nil unless parts[1] == config.root_directory
+
+        # app/agents -> no namespace (root level)
+        return nil if parts.length == 2
+
+        # app/agents/embedders -> Embedders namespace
+        subdirectory = parts[2]
         namespace_name = if config.root_namespace.blank?
-          # No root namespace - use category namespace only for audio/image/text
-          case category
-          when "audio", "image", "text"
-            category.camelize # "Audio", "Image", "Text"
-          else
-            nil # Top-level for agents, workflows, tools
-          end
+          subdirectory.camelize
         else
-          # With root namespace - prefix category with root namespace
-          case category
-          when "audio", "image", "text"
-            "#{config.root_namespace}::#{category.camelize}"
-          else
-            config.root_namespace
-          end
+          "#{config.root_namespace}::#{subdirectory.camelize}"
         end
 
-        return nil if namespace_name.nil?
-
-        # Return the constant, creating intermediate modules if needed
+        # Create the namespace module if needed
         namespace_name.constantize
       rescue NameError
-        # Create the namespace module if it doesn't exist
         namespace_name.split("::").inject(Object) do |mod, name|
           mod.const_defined?(name, false) ? mod.const_get(name) : mod.const_set(name, Module.new)
         end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_llm-agents
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.2.1
 platform: ruby
 authors:
 - adham90
@@ -159,6 +159,7 @@ files:
 - app/views/ruby_llm/agents/tenants/edit.html.erb
 - app/views/ruby_llm/agents/tenants/index.html.erb
 - app/views/ruby_llm/agents/tenants/show.html.erb
+- app/views/ruby_llm/agents/workflows/_empty_state.html.erb
 - app/views/ruby_llm/agents/workflows/_step_performance.html.erb
 - app/views/ruby_llm/agents/workflows/_structure_dsl.html.erb
 - app/views/ruby_llm/agents/workflows/_structure_parallel.html.erb