ruby_llm-agents 1.0.0 → 1.2.0

data/lib/generators/ruby_llm_agents/templates/skills/IMAGE_VARIATORS.md.tt

@@ -1,4 +1,4 @@
-# <%= @root_namespace %>::Image Variators
+# Images Variators
 
 This directory contains image variation services. All variators inherit from `ApplicationImageVariator`.
 
@@ -12,13 +12,11 @@ rails generate ruby_llm_agents:image_variator Product --count 4
 
 Or create manually:
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class ProductVariator < ApplicationImageVariator
-      model "gpt-image-1"
-      count 4
-      size "1024x1024"
-    end
+module Images
+  class ProductVariator < ApplicationImageVariator
+    model "gpt-image-1"
+    count 4
+    size "1024x1024"
   end
 end
 ```
@@ -40,7 +38,7 @@ end
 ## Using Variators
 
 ```ruby
-result = <%= @root_namespace %>::Image::ProductVariator.call(image: "product.png")
+result = Images::ProductVariator.call(image: "product.png")
 
 result.urls         # Array of variation URLs
 result.images       # Array of image data
@@ -51,7 +49,7 @@ result.total_cost   # Combined cost
 ### Override Count
 
 ```ruby
-result = <%= @root_namespace %>::Image::ProductVariator.call(
+result = Images::ProductVariator.call(
   image: "logo.png",
   count: 8  # Generate 8 variations
 )
@@ -60,7 +58,7 @@ result = <%= @root_namespace %>::Image::ProductVariator.call(
 ### Save All Variations
 
 ```ruby
-result = <%= @root_namespace %>::Image::ProductVariator.call(image: "design.png")
+result = Images::ProductVariator.call(image: "design.png")
 
 result.images.each_with_index do |image_data, i|
   File.write("variation_#{i}.png", image_data)
@@ -72,28 +70,24 @@ end
 ### Design Exploration
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class DesignVariator < ApplicationImageVariator
-      count 6
-      variation_strength 0.5  # Moderate differences
-    end
+module Images
+  class DesignVariator < ApplicationImageVariator
+    count 6
+    variation_strength 0.5  # Moderate differences
   end
 end
 
 # Generate design alternatives
-result = <%= @root_namespace %>::Image::DesignVariator.call(image: "concept.png")
+result = Images::DesignVariator.call(image: "concept.png")
 ```
 
 ### A/B Testing Assets
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class MarketingVariator < ApplicationImageVariator
-      count 4
-      variation_strength 0.3  # Similar but different
-    end
+module Images
+  class MarketingVariator < ApplicationImageVariator
+    count 4
+    variation_strength 0.3  # Similar but different
   end
 end
 ```
@@ -101,13 +95,11 @@ end
 ### Avatar Options
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class AvatarVariator < ApplicationImageVariator
-      count 8
-      size "512x512"
-      variation_strength 0.4
-    end
+module Images
+  class AvatarVariator < ApplicationImageVariator
+    count 8
+    size "512x512"
+    variation_strength 0.4
   end
 end
 ```

data/lib/generators/ruby_llm_agents/templates/skills/SPEAKERS.md.tt

@@ -1,4 +1,4 @@
-# <%= @root_namespace %>::Audio Speakers
+# Audio Speakers
 
 This directory contains text-to-speech (TTS) speakers. All speakers inherit from `ApplicationSpeaker`.
 
@@ -13,15 +13,13 @@ rails generate ruby_llm_agents:speaker Podcast --provider elevenlabs --voice Rac
 
 Or create manually:
 ```ruby
-module <%= @root_namespace %>
-  module Audio
-    class NarratorSpeaker < ApplicationSpeaker
-      provider :openai
-      model "tts-1"
-      voice "nova"
-      speed 1.0
-      output_format :mp3
-    end
+module Audio
+  class NarratorSpeaker < ApplicationSpeaker
+    provider :openai
+    model "tts-1"
+    voice "nova"
+    speed 1.0
+    output_format :mp3
   end
 end
 ```
@@ -89,7 +87,7 @@ end
 ### Generate Speech
 
 ```ruby
-result = <%= @root_namespace %>::Audio::NarratorSpeaker.call(text: "Hello world")
+result = Audio::NarratorSpeaker.call(text: "Hello world")
 
 result.audio        # Binary audio data
 result.format       # :mp3
@@ -100,7 +98,7 @@ result.total_cost   # Cost in USD
 ### Save to File
 
 ```ruby
-result = <%= @root_namespace %>::Audio::NarratorSpeaker.call(text: "Hello world")
+result = Audio::NarratorSpeaker.call(text: "Hello world")
 result.save_to("output.mp3")
 ```
 
@@ -109,7 +107,7 @@ result.save_to("output.mp3")
 For long text, stream chunks as they're generated:
 
 ```ruby
-<%= @root_namespace %>::Audio::NarratorSpeaker.stream(text: long_article) do |chunk|
+Audio::NarratorSpeaker.stream(text: long_article) do |chunk|
   audio_player.play(chunk.audio)
 end
 ```
@@ -117,7 +115,7 @@ end
 ### Override Settings at Runtime
 
 ```ruby
-result = <%= @root_namespace %>::Audio::NarratorSpeaker.call(
+result = Audio::NarratorSpeaker.call(
   text: "Speak slowly and clearly",
   voice: "onyx",
   speed: 0.8
@@ -129,46 +127,42 @@ result = <%= @root_namespace %>::Audio::NarratorSpeaker.call(
 ### Article Narration
 
 ```ruby
-module <%= @root_namespace %>
-  module Audio
-    class ArticleNarratorSpeaker < ApplicationSpeaker
-      provider :openai
-      model "tts-1-hd"
-      voice "fable"
-      speed 0.9
-
-      cache_for 30.days
-
-      lexicon do
-        pronounce 'JavaScript', 'java-script'
-        pronounce 'TypeScript', 'type-script'
-      end
+module Audio
+  class ArticleNarratorSpeaker < ApplicationSpeaker
+    provider :openai
+    model "tts-1-hd"
+    voice "fable"
+    speed 0.9
+
+    cache_for 30.days
+
+    lexicon do
+      pronounce 'JavaScript', 'java-script'
+      pronounce 'TypeScript', 'type-script'
     end
   end
 end
 
 # Usage
 article = Article.find(params[:id])
-result = <%= @root_namespace %>::Audio::ArticleNarratorSpeaker.call(text: article.body)
+result = Audio::ArticleNarratorSpeaker.call(text: article.body)
 result.save_to("public/audio/articles/#{article.id}.mp3")
 ```
 
 ### Voice Announcements
 
 ```ruby
-module <%= @root_namespace %>
-  module Audio
-    class AnnouncementSpeaker < ApplicationSpeaker
-      provider :openai
-      voice "nova"
-      speed 1.1
-      output_format :mp3
-    end
+module Audio
+  class AnnouncementSpeaker < ApplicationSpeaker
+    provider :openai
+    voice "nova"
+    speed 1.1
+    output_format :mp3
   end
 end
 
 # Usage
-<%= @root_namespace %>::Audio::AnnouncementSpeaker.call(
+Audio::AnnouncementSpeaker.call(
   text: "Your order has been shipped!"
 )
 ```
@@ -176,13 +170,11 @@ end
 ### Multilingual TTS
 
 ```ruby
-module <%= @root_namespace %>
-  module Audio
-    class MultilingualSpeaker < ApplicationSpeaker
-      provider :elevenlabs
-      model "eleven_multilingual_v2"
-      voice "Rachel"
-    end
+module Audio
+  class MultilingualSpeaker < ApplicationSpeaker
+    provider :elevenlabs
+    model "eleven_multilingual_v2"
+    voice "Rachel"
   end
 end
 ```
@@ -190,7 +182,7 @@ end
 ## Testing Speakers
 
 ```ruby
-RSpec.describe <%= @root_namespace %>::Audio::NarratorSpeaker do
+RSpec.describe Audio::NarratorSpeaker do
   describe ".call" do
     it "generates audio from text" do
       result = described_class.call(text: "Hello world")

data/lib/generators/ruby_llm_agents/templates/skills/TOOLS.md.tt

@@ -1,4 +1,4 @@
-# <%= @root_namespace %> Tools
+# Agents Tools
 
 This directory contains tools that agents can use to perform actions. Tools allow LLM agents to interact with external systems, APIs, databases, and more.
 
@@ -7,7 +7,7 @@ This directory contains tools that agents can use to perform actions. Tools allo
 Tools use the RubyLLM tool interface. Create a class that includes `RubyLLM::Tool`:
 
 ```ruby
-module <%= @root_namespace %>
+module Agents
   class SearchTool
     include RubyLLM::Tool
 
@@ -68,7 +68,7 @@ end
 Register tools in your agent:
 
 ```ruby
-module <%= @root_namespace %>
+module Agents
   class ResearchAgent < ApplicationAgent
     model "gpt-4o"
 
@@ -97,7 +97,7 @@ end
 ### Database Query Tool
 
 ```ruby
-module <%= @root_namespace %>
+module Agents
   class CustomerLookupTool
     include RubyLLM::Tool
 
@@ -129,7 +129,7 @@ end
 ### API Integration Tool
 
 ```ruby
-module <%= @root_namespace %>
+module Agents
   class WeatherTool
     include RubyLLM::Tool
 
@@ -161,7 +161,7 @@ end
 ### Action Tool
 
 ```ruby
-module <%= @root_namespace %>
+module Agents
   class SendEmailTool
     include RubyLLM::Tool
 
@@ -198,7 +198,7 @@ end
 ## Testing Tools
 
 ```ruby
-RSpec.describe <%= @root_namespace %>::SearchTool do
+RSpec.describe Agents::SearchTool do
   describe "#execute" do
     it "returns search results" do
       tool = described_class.new

data/lib/generators/ruby_llm_agents/templates/skills/TRANSCRIBERS.md.tt

@@ -1,4 +1,4 @@
-# <%= @root_namespace %>::Audio Transcribers
+# Audio Transcribers
 
 This directory contains audio transcription services. All transcribers inherit from `ApplicationTranscriber`.
 
@@ -13,14 +13,12 @@ rails generate ruby_llm_agents:transcriber Podcast --output_format srt
 
 Or create manually:
 ```ruby
-module <%= @root_namespace %>
-  module Audio
-    class MeetingTranscriber < ApplicationTranscriber
-      model "whisper-1"
-      language "en"
-      output_format :text
-      include_timestamps :segment
-    end
+module Audio
+  class MeetingTranscriber < ApplicationTranscriber
+    model "whisper-1"
+    language "en"
+    output_format :text
+    include_timestamps :segment
   end
 end
 ```
@@ -85,7 +83,7 @@ end
 ### Basic Transcription
 
 ```ruby
-result = <%= @root_namespace %>::Audio::MeetingTranscriber.call(audio: "meeting.mp3")
+result = Audio::MeetingTranscriber.call(audio: "meeting.mp3")
 
 result.text         # The transcribed text
 result.duration     # Audio duration in seconds
@@ -96,20 +94,20 @@ result.total_cost   # Cost in USD
 ### From File Path
 
 ```ruby
-result = <%= @root_namespace %>::Audio::MeetingTranscriber.call(audio: "/path/to/audio.mp3")
+result = Audio::MeetingTranscriber.call(audio: "/path/to/audio.mp3")
 ```
 
 ### From Binary Data
 
 ```ruby
 audio_data = File.read("recording.wav", mode: "rb")
-result = <%= @root_namespace %>::Audio::MeetingTranscriber.call(audio: audio_data)
+result = Audio::MeetingTranscriber.call(audio: audio_data)
 ```
 
 ### From URL
 
 ```ruby
-result = <%= @root_namespace %>::Audio::MeetingTranscriber.call(
+result = Audio::MeetingTranscriber.call(
   audio: "https://example.com/audio.mp3"
 )
 ```
@@ -117,17 +115,15 @@ result = <%= @root_namespace %>::Audio::MeetingTranscriber.call(
 ### With Timestamps (SRT)
 
 ```ruby
-module <%= @root_namespace %>
-  module Audio
-    class SubtitleTranscriber < ApplicationTranscriber
-      model "whisper-1"
-      output_format :srt
-      include_timestamps :segment
-    end
+module Audio
+  class SubtitleTranscriber < ApplicationTranscriber
+    model "whisper-1"
+    output_format :srt
+    include_timestamps :segment
   end
 end
 
-result = <%= @root_namespace %>::Audio::SubtitleTranscriber.call(audio: "video.mp4")
+result = Audio::SubtitleTranscriber.call(audio: "video.mp4")
 File.write("subtitles.srt", result.text)
 ```
 
@@ -136,23 +132,21 @@ File.write("subtitles.srt", result.text)
 ### Meeting Transcription
 
 ```ruby
-module <%= @root_namespace %>
-  module Audio
-    class MeetingTranscriber < ApplicationTranscriber
-      model "whisper-1"
-      language "en"
-      cache_for 90.days
-
-      def prompt
-        "Business meeting with technical discussions"
-      end
-
-      def postprocess_text(text)
-        text
-          .gsub(/\bum\b/i, '')
-          .gsub(/\buh\b/i, '')
-          .squeeze(' ')
-      end
+module Audio
+  class MeetingTranscriber < ApplicationTranscriber
+    model "whisper-1"
+    language "en"
+    cache_for 90.days
+
+    def prompt
+      "Business meeting with technical discussions"
+    end
+
+    def postprocess_text(text)
+      text
+        .gsub(/\bum\b/i, '')
+        .gsub(/\buh\b/i, '')
+        .squeeze(' ')
     end
   end
 end
@@ -161,16 +155,14 @@ end
 ### Podcast Subtitles
 
 ```ruby
-module <%= @root_namespace %>
-  module Audio
-    class PodcastTranscriber < ApplicationTranscriber
-      model "whisper-1"
-      output_format :vtt
-      include_timestamps :segment
-
-      def prompt
-        "Technology podcast discussing software development"
-      end
+module Audio
+  class PodcastTranscriber < ApplicationTranscriber
+    model "whisper-1"
+    output_format :vtt
+    include_timestamps :segment
+
+    def prompt
+      "Technology podcast discussing software development"
     end
   end
 end
@@ -179,20 +171,18 @@ end
 ### Voice Note Processing
 
 ```ruby
-module <%= @root_namespace %>
-  module Audio
-    class VoiceNoteTranscriber < ApplicationTranscriber
-      model "whisper-1"
-      output_format :json
-
-      def postprocess_text(text)
-        # Clean up casual speech
-        text
-          .gsub(/\byou know\b/i, '')
-          .gsub(/\bi mean\b/i, '')
-          .gsub(/\bkind of\b/i, '')
-          .squeeze(' ')
-      end
+module Audio
+  class VoiceNoteTranscriber < ApplicationTranscriber
+    model "whisper-1"
+    output_format :json
+
+    def postprocess_text(text)
+      # Clean up casual speech
+      text
+        .gsub(/\byou know\b/i, '')
+        .gsub(/\bi mean\b/i, '')
+        .gsub(/\bkind of\b/i, '')
+        .squeeze(' ')
     end
   end
 end
@@ -201,24 +191,22 @@ end
 ### Multilingual Transcription
 
 ```ruby
-module <%= @root_namespace %>
-  module Audio
-    class MultilingualTranscriber < ApplicationTranscriber
-      model "whisper-1"
-      # Leave language nil for auto-detection
-      output_format :json
-    end
+module Audio
+  class MultilingualTranscriber < ApplicationTranscriber
+    model "whisper-1"
+    # Leave language nil for auto-detection
+    output_format :json
   end
 end
 
-result = <%= @root_namespace %>::Audio::MultilingualTranscriber.call(audio: "spanish.mp3")
+result = Audio::MultilingualTranscriber.call(audio: "spanish.mp3")
 result.language  # => "es"
 ```
 
 ## Testing Transcribers
 
 ```ruby
-RSpec.describe <%= @root_namespace %>::Audio::MeetingTranscriber do
+RSpec.describe Audio::MeetingTranscriber do
   describe ".call" do
     it "transcribes audio file" do
       result = described_class.call(audio: fixture_file("sample.mp3"))