ruby_llm-agents 0.3.5 → 0.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6dbcf1c63db9bd3aad406eaa802c632f932f7dc5ebe0eaf2cbec51c492cf89ed
-  data.tar.gz: 4b6b7d2c440371147c9e754a91f86fb5712aa388584d7f6bef9204f1c10c49b6
+  metadata.gz: 40771a5bbdc5c7baea26c0900c6715e3e1033569154ebeb0d7cd60eff83d1389
+  data.tar.gz: bedbf16ff8717ebcdca79aa256f9aae489677baad1b848baa38d4d485b87c803
 SHA512:
-  metadata.gz: da89ade6f5a60c77253c7a9647447085632126dfc4d231aa7afec1eca6dc3a82abe5850575db7fb1c23ca71708bf685d74dc138c9b5a277b5f760377e664aec7
-  data.tar.gz: f9551e2dc805d7d76ea42d90098a863bc6abe3451801ab8c893696dd4662c8fc804b4820d3dbb61feb9c90a42d7a0111ab1e2440b94a419df4ef78818ea981a2
+  metadata.gz: 3202614bf8c8209a1e9a589137440c804d2fcdc8fa2045840e4429963e06a0b4b1b25f82da99f6e1a5e3090afa1b149dec500d87ce59c09de946a3293e728962
+  data.tar.gz: '08d565511fc883fdb83377e4993dbd699a5ecce23cbfdc454c6372279fc275165dddfc5c0b4b4d1010f1dde3c4acdaca4f260d0c07b6cc7b9ad81e7b13cd4b41'

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

@@ -58,7 +58,7 @@ module RubyLLM
       #
       # @return [void]
       def show
-        @agent_type = params[:id]
+        @agent_type = CGI.unescape(params[:id])
         @agent_class = AgentRegistry.find(@agent_type)
         @agent_active = @agent_class.present?
 
@@ -215,6 +215,7 @@ module RubyLLM
           model: @agent_class.model,
           temperature: @agent_class.temperature,
           version: @agent_class.version,
+          description: @agent_class.respond_to?(:description) ? @agent_class.description : nil,
           timeout: @agent_class.timeout,
           cache_enabled: @agent_class.cache_enabled?,
           cache_ttl: @agent_class.cache_ttl,

data/app/services/ruby_llm/agents/agent_registry.rb

@@ -140,6 +140,7 @@ module RubyLLM
             workflow_type: workflow_type,
             workflow_children: workflow_children,
             version: safe_call(agent_class, :version) || "N/A",
+            description: safe_call(agent_class, :description),
             model: safe_call(agent_class, :model) || (is_workflow ? "workflow" : "N/A"),
             temperature: safe_call(agent_class, :temperature),
             timeout: safe_call(agent_class, :timeout),

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

@@ -1,10 +1,14 @@
-<%= 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 %>
+<%= link_to ruby_llm_agents.agent_path(ERB::Util.url_encode(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$/, '') %>
+          <% name_parts = agent[:name].gsub(/Agent$/, '').split('::') %>
+          <% if name_parts.length > 1 %>
+            <span class="text-gray-400 dark:text-gray-500 font-normal"><%= name_parts[0..-2].join('::') %>::</span>
+          <% end %>
+          <%= name_parts.last %>
         </h3>
         <span class="hidden sm:inline text-sm text-gray-500 dark:text-gray-400">v<%= agent[:version] %></span>
         <% if agent[:active] %>
@@ -25,6 +29,13 @@
       </span>
     </div>
 
+    <!-- Description -->
+    <% if agent[:description].present? %>
+      <p class="mt-1 text-sm text-gray-500 dark:text-gray-400 line-clamp-2">
+        <%= agent[:description] %>
+      </p>
+    <% end %>
+
     <!-- 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 -->

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

@@ -15,13 +15,17 @@
 %>
 
 <div x-data="{ expanded: false }" class="block bg-white dark:bg-gray-800 rounded-lg shadow hover:shadow-md transition-shadow border-l-4 <%= colors[:border] %>">
-  <%= link_to ruby_llm_agents.agent_path(workflow[:name]), class: "block p-4 sm:p-5" do %>
+  <%= link_to ruby_llm_agents.agent_path(ERB::Util.url_encode(workflow[:name])), class: "block p-4 sm:p-5" do %>
     <!-- Header Row -->
     <div class="flex items-center justify-between gap-2">
       <div class="flex items-center gap-2 min-w-0">
         <%= render "ruby_llm/agents/shared/workflow_type_badge", workflow_type: workflow[:workflow_type], size: :sm %>
         <h3 class="font-semibold text-gray-900 dark:text-gray-100 truncate">
-          <%= workflow[:name].gsub(/Workflow$/, '').gsub(/Pipeline$|Parallel$|Router$/, '') %>
+          <% name_parts = workflow[:name].gsub(/Workflow$/, '').gsub(/Pipeline$|Parallel$|Router$/, '').split('::') %>
+          <% if name_parts.length > 1 %>
+            <span class="text-gray-400 dark:text-gray-500 font-normal"><%= name_parts[0..-2].join('::') %>::</span>
+          <% end %>
+          <%= name_parts.last %>
         </h3>
         <span class="hidden sm:inline text-sm text-gray-500 dark:text-gray-400">v<%= workflow[:version] %></span>
         <% if workflow[:active] %>
@@ -35,6 +39,13 @@
       </span>
     </div>
 
+    <!-- Description -->
+    <% if workflow[:description].present? %>
+      <p class="mt-1 text-sm text-gray-500 dark:text-gray-400 line-clamp-2">
+        <%= workflow[:description] %>
+      </p>
+    <% end %>
+
     <!-- Stats Row -->
     <div class="mt-2 sm:mt-3 sm:border-t sm:border-gray-100 sm:dark:border-gray-700 sm:pt-3">
       <% success_rate = workflow[:success_rate] || 0 %>

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

@@ -45,6 +45,11 @@
           <%= @config[:model] %> &middot; temp <%= @config[:temperature] %>
           &middot; timeout <%= @config[:timeout] %>s
         </p>
+        <% if @config[:description].present? %>
+          <p class="text-gray-600 dark:text-gray-300 mt-2">
+            <%= @config[:description] %>
+          </p>
+        <% end %>
       <% end %>
     </div>
 

data/lib/generators/ruby_llm_agents/agent_generator.rb

@@ -29,16 +29,21 @@ module RubyLlmAgents
                  desc: "Cache TTL (e.g., '1.hour', '30.minutes')"
 
     def create_agent_file
-      template "agent.rb.tt", "app/agents/#{file_name}_agent.rb"
+      # Support nested paths: "chat/support" -> "app/agents/chat/support_agent.rb"
+      # Rails' class_name handles namespacing: "chat/support" -> "Chat::Support"
+      agent_path = name.underscore
+      template "agent.rb.tt", "app/agents/#{agent_path}_agent.rb"
     end
 
     def show_usage
+      # Build full class name from path (e.g., "chat/support" -> "Chat::Support")
+      full_class_name = name.split('/').map(&:camelize).join("::")
       say ""
-      say "Agent #{class_name}Agent created!", :green
+      say "Agent #{full_class_name}Agent created!", :green
       say ""
       say "Usage:"
-      say "  #{class_name}Agent.call(#{usage_params})"
-      say "  #{class_name}Agent.call(#{usage_params}, dry_run: true)"
+      say "  #{full_class_name}Agent.call(#{usage_params})"
+      say "  #{full_class_name}Agent.call(#{usage_params}, dry_run: true)"
       say ""
     end
 

data/lib/ruby_llm/agents/base/dsl.rb

@@ -48,6 +48,17 @@ module RubyLLM
           @version || inherited_or_default(:version, VERSION)
         end
 
+        # Sets or returns the description for this agent class
+        #
+        # @param value [String, nil] The description text
+        # @return [String, nil] The current description
+        # @example
+        #   description "Searches the knowledge base for relevant documents"
+        def description(value = nil)
+          @description = value if value
+          @description || inherited_or_default(:description, nil)
+        end
+
         # Sets or returns the timeout in seconds for LLM requests
         #
         # @param value [Integer, nil] Timeout in seconds

data/lib/ruby_llm/agents/base/execution.rb

@@ -233,9 +233,10 @@ module RubyLLM
         # @param msgs [Array<Hash>] Messages with :role and :content keys
         # @return [RubyLLM::Chat] Client with messages applied
         def apply_messages(client, msgs)
-          msgs.reduce(client) do |c, message|
-            c.with_message(message[:role].to_s, message[:content])
+          msgs.each do |message|
+            client.add_message(role: message[:role].to_sym, content: message[:content])
           end
+          client
         end
 
         # Builds a client with pre-populated conversation history

data/lib/ruby_llm/agents/version.rb

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

data/lib/ruby_llm/agents/workflow.rb

@@ -42,6 +42,10 @@ module RubyLLM
         #   @return [Float, nil] Maximum cost threshold for the workflow
         attr_accessor :_max_cost
 
+        # @!attribute [rw] description
+        #   @return [String, nil] Description of the workflow
+        attr_accessor :_description
+
         # Sets or returns the workflow version
         #
         # @param value [String, nil] Version string to set
@@ -78,6 +82,18 @@ module RubyLLM
           end
         end
 
+        # Sets or returns the workflow description
+        #
+        # @param value [String, nil] Description text to set
+        # @return [String, nil] The current description
+        def description(value = nil)
+          if value
+            self._description = value
+          else
+            _description
+          end
+        end
+
         # Factory method to instantiate and execute a workflow
         #
         # @param kwargs [Hash] Parameters to pass to the workflow

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_llm-agents
 version: !ruby/object:Gem::Version
-  version: 0.3.5
+  version: 0.3.6
 platform: ruby
 authors:
 - adham90