ruby_llm-agents 1.0.0 → 1.2.0

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

@@ -1,4 +1,4 @@
-# <%= @root_namespace %>::Image Generators
+# Images Generators
 
 This directory contains image generation services. All generators inherit from `ApplicationImageGenerator`.
 
@@ -13,15 +13,13 @@ rails generate ruby_llm_agents:image_generator Product --quality hd --style vivi
 
 Or create manually:
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class LogoGenerator < ApplicationImageGenerator
-      model "gpt-image-1"
-      size "1024x1024"
-      quality "hd"
-      style "vivid"
-      content_policy :standard
-    end
+module Images
+  class LogoGenerator < ApplicationImageGenerator
+    model "gpt-image-1"
+    size "1024x1024"
+    quality "hd"
+    style "vivid"
+    content_policy :standard
   end
 end
 ```
@@ -100,7 +98,7 @@ end
 ### Basic Generation
 
 ```ruby
-result = <%= @root_namespace %>::Image::LogoGenerator.call(prompt: "Tech startup logo")
+result = Images::LogoGenerator.call(prompt: "Tech startup logo")
 
 result.url          # Temporary URL to generated image
 result.image_data   # Binary image data
@@ -111,14 +109,14 @@ result.total_cost   # Cost in USD
 ### Save to File
 
 ```ruby
-result = <%= @root_namespace %>::Image::LogoGenerator.call(prompt: "Company logo")
+result = Images::LogoGenerator.call(prompt: "Company logo")
 result.save("logo.png")
 ```
 
 ### Generate Multiple Images
 
 ```ruby
-result = <%= @root_namespace %>::Image::LogoGenerator.call(
+result = Images::LogoGenerator.call(
   prompt: "Product photography",
   count: 4
 )
@@ -130,7 +128,7 @@ result.images       # Array of image data
 ### Override Settings at Runtime
 
 ```ruby
-result = <%= @root_namespace %>::Image::LogoGenerator.call(
+result = Images::LogoGenerator.call(
   prompt: "High quality portrait",
   quality: "hd",
   size: "1792x1024",
@@ -143,7 +141,7 @@ result = <%= @root_namespace %>::Image::LogoGenerator.call(
 If ActiveStorage is available:
 
 ```ruby
-result = <%= @root_namespace %>::Image::ProductGenerator.call(prompt: "Product shot")
+result = Images::ProductGenerator.call(prompt: "Product shot")
 
 # Attach to a model
 product.images.attach(
@@ -158,19 +156,17 @@ product.images.attach(
 ### Product Photography
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class ProductGenerator < ApplicationImageGenerator
-      model "gpt-image-1"
-      size "1024x1024"
-      quality "hd"
-      style "natural"
-
-      template "Professional product photography of {prompt}, " \
-               "white background, studio lighting, e-commerce style"
-
-      negative_prompt "text, watermark, blurry, low quality"
-    end
+module Images
+  class ProductGenerator < ApplicationImageGenerator
+    model "gpt-image-1"
+    size "1024x1024"
+    quality "hd"
+    style "natural"
+
+    template "Professional product photography of {prompt}, " \
+             "white background, studio lighting, e-commerce style"
+
+    negative_prompt "text, watermark, blurry, low quality"
   end
 end
 ```
@@ -178,17 +174,15 @@ end
 ### Marketing Banners
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class BannerGenerator < ApplicationImageGenerator
-      model "gpt-image-1"
-      size "1792x1024"  # Landscape
-      quality "hd"
-      style "vivid"
-
-      template "Marketing banner for {prompt}, bold colors, " \
-               "eye-catching design, professional"
-    end
+module Images
+  class BannerGenerator < ApplicationImageGenerator
+    model "gpt-image-1"
+    size "1792x1024"  # Landscape
+    quality "hd"
+    style "vivid"
+
+    template "Marketing banner for {prompt}, bold colors, " \
+             "eye-catching design, professional"
   end
 end
 ```
@@ -196,18 +190,16 @@ end
 ### Avatar Generation
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class AvatarGenerator < ApplicationImageGenerator
-      model "gpt-image-1"
-      size "512x512"
-      quality "standard"
-      style "vivid"
-      content_policy :strict
-
-      template "Friendly cartoon avatar of {prompt}, " \
-               "professional, approachable, colorful"
-    end
+module Images
+  class AvatarGenerator < ApplicationImageGenerator
+    model "gpt-image-1"
+    size "512x512"
+    quality "standard"
+    style "vivid"
+    content_policy :strict
+
+    template "Friendly cartoon avatar of {prompt}, " \
+             "professional, approachable, colorful"
   end
 end
 ```
@@ -215,26 +207,24 @@ end
 ### Social Media Graphics
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class SocialGenerator < ApplicationImageGenerator
-      model "gpt-image-1"
-      quality "standard"
-
-      def preprocess_prompt(prompt)
-        "#{prompt}, social media post, engaging, modern design"
-      end
+module Images
+  class SocialGenerator < ApplicationImageGenerator
+    model "gpt-image-1"
+    quality "standard"
+
+    def preprocess_prompt(prompt)
+      "#{prompt}, social media post, engaging, modern design"
     end
   end
 end
 
 # Usage with different sizes
-<%= @root_namespace %>::Image::SocialGenerator.call(
+Images::SocialGenerator.call(
   prompt: "Tech announcement",
   size: "1024x1024"  # Instagram
 )
 
-<%= @root_namespace %>::Image::SocialGenerator.call(
+Images::SocialGenerator.call(
   prompt: "Tech announcement",
   size: "1792x1024"  # Twitter/LinkedIn
 )
@@ -243,7 +233,7 @@ end
 ## Testing Generators
 
 ```ruby
-RSpec.describe <%= @root_namespace %>::Image::LogoGenerator do
+RSpec.describe Images::LogoGenerator do
   describe ".call" do
     it "generates an image" do
       result = described_class.call(prompt: "Test logo")

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

@@ -1,4 +1,4 @@
-# <%= @root_namespace %>::Image Pipelines
+# Images Pipelines
 
 This directory contains multi-step image processing pipelines. All pipelines inherit from `ApplicationImagePipeline`.
 
@@ -12,13 +12,11 @@ rails generate ruby_llm_agents:image_pipeline Product --steps generate,upscale,r
 
 Or create manually:
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class ProductPipeline < ApplicationImagePipeline
-      step :generate, generator: ProductGenerator
-      step :upscale, upscaler: PhotoUpscaler, scale: 2
-      step :remove_bg, remover: BackgroundRemover
-    end
+module Images
+  class ProductPipeline < ApplicationImagePipeline
+    step :generate, generator: ProductGenerator
+    step :upscale, upscaler: PhotoUpscaler, scale: 2
+    step :remove_bg, remover: BackgroundRemover
   end
 end
 ```
@@ -77,7 +75,7 @@ cache_for 1.hour     # Cache pipeline results
 ### Basic Execution
 
 ```ruby
-result = <%= @root_namespace %>::Image::ProductPipeline.call(prompt: "Laptop on desk")
+result = Images::ProductPipeline.call(prompt: "Laptop on desk")
 
 result.success?       # All steps succeeded
 result.final_image    # Final processed image
@@ -89,7 +87,7 @@ result.duration_ms    # Total pipeline duration
 ### Access Individual Steps
 
 ```ruby
-result = <%= @root_namespace %>::Image::ProductPipeline.call(prompt: "Product photo")
+result = Images::ProductPipeline.call(prompt: "Product photo")
 
 result.step(:generate)    # Generation step result
 result.step(:upscale)     # Upscale step result
@@ -100,25 +98,23 @@ result.step_count         # Total number of steps
 ### Save Result
 
 ```ruby
-result = <%= @root_namespace %>::Image::ProductPipeline.call(prompt: "...")
+result = Images::ProductPipeline.call(prompt: "...")
 result.save("final_output.png")
 ```
 
 ### Conditional Execution
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class SmartPipeline < ApplicationImagePipeline
-      step :generate, generator: ProductGenerator
-      step :upscale, upscaler: PhotoUpscaler, if: ->(ctx) { ctx[:hd] }
-      step :remove_bg, remover: BackgroundRemover, if: ->(ctx) { ctx[:transparent] }
-    end
+module Images
+  class SmartPipeline < ApplicationImagePipeline
+    step :generate, generator: ProductGenerator
+    step :upscale, upscaler: PhotoUpscaler, if: ->(ctx) { ctx[:hd] }
+    step :remove_bg, remover: BackgroundRemover, if: ->(ctx) { ctx[:transparent] }
   end
 end
 
 # Call with options
-result = <%= @root_namespace %>::Image::SmartPipeline.call(
+result = Images::SmartPipeline.call(
   prompt: "Product photo",
   hd: true,
   transparent: false
@@ -130,26 +126,24 @@ result = <%= @root_namespace %>::Image::SmartPipeline.call(
 ### E-commerce Product Pipeline
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class EcommercePipeline < ApplicationImagePipeline
-      description "Generate and process product images"
-      version "1.0"
+module Images
+  class EcommercePipeline < ApplicationImagePipeline
+    description "Generate and process product images"
+    version "1.0"
 
-      step :generate, generator: ProductGenerator
-      step :upscale, upscaler: PhotoUpscaler, scale: 2
-      step :remove_bg, remover: BackgroundRemover
-      step :analyze, analyzer: ProductAnalyzer
+    step :generate, generator: ProductGenerator
+    step :upscale, upscaler: PhotoUpscaler, scale: 2
+    step :remove_bg, remover: BackgroundRemover
+    step :analyze, analyzer: ProductAnalyzer
 
-      cache_for 1.day
+    cache_for 1.day
 
-      after_pipeline :log_completion
+    after_pipeline :log_completion
 
-      private
+    private
 
-      def log_completion(result)
-        Rails.logger.info("Pipeline completed: cost=#{result.total_cost}")
-      end
+    def log_completion(result)
+      Rails.logger.info("Pipeline completed: cost=#{result.total_cost}")
     end
   end
 end
@@ -158,45 +152,41 @@ end
 ### Marketing Asset Pipeline
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class MarketingPipeline < ApplicationImagePipeline
-      step :generate, generator: MarketingGenerator, quality: "hd"
-      step :transform, transformer: BrandStyleTransformer, strength: 0.3
-      step :variations, variator: DesignVariator, count: 4
-
-      stop_on_error false  # Continue even if transform fails
-    end
+module Images
+  class MarketingPipeline < ApplicationImagePipeline
+    step :generate, generator: MarketingGenerator, quality: "hd"
+    step :transform, transformer: BrandStyleTransformer, strength: 0.3
+    step :variations, variator: DesignVariator, count: 4
+
+    stop_on_error false  # Continue even if transform fails
   end
 end
 
-result = <%= @root_namespace %>::Image::MarketingPipeline.call(prompt: "Sale banner")
+result = Images::MarketingPipeline.call(prompt: "Sale banner")
 result.step(:variations).images  # Get all variations
 ```
 
 ### Photo Enhancement Pipeline
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class EnhancementPipeline < ApplicationImagePipeline
-      step :upscale, upscaler: PhotoUpscaler, scale: 2
-      step :enhance, transformer: EnhancementTransformer, strength: 0.2
-      step :analyze, analyzer: QualityAnalyzer
+module Images
+  class EnhancementPipeline < ApplicationImagePipeline
+    step :upscale, upscaler: PhotoUpscaler, scale: 2
+    step :enhance, transformer: EnhancementTransformer, strength: 0.2
+    step :analyze, analyzer: QualityAnalyzer
 
-      before_pipeline :validate_image_format
+    before_pipeline :validate_image_format
 
-      private
+    private
 
-      def validate_image_format
-        raise ArgumentError, "Image required" unless context[:image]
-      end
+    def validate_image_format
+      raise ArgumentError, "Image required" unless context[:image]
     end
   end
 end
 
 # Process existing image
-result = <%= @root_namespace %>::Image::EnhancementPipeline.call(image: "photo.jpg")
+result = Images::EnhancementPipeline.call(image: "photo.jpg")
 ```
 
 ## Result Methods

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

@@ -1,4 +1,4 @@
-# <%= @root_namespace %>::Image Transformers
+# Images Transformers
 
 This directory contains image transformation services (style transfer, img2img). All transformers inherit from `ApplicationImageTransformer`.
 
@@ -12,13 +12,11 @@ rails generate ruby_llm_agents:image_transformer Style --strength 0.8
 
 Or create manually:
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class StyleTransformer < ApplicationImageTransformer
-      model "gpt-image-1"
-      strength 0.7
-      size "1024x1024"
-    end
+module Images
+  class StyleTransformer < ApplicationImageTransformer
+    model "gpt-image-1"
+    strength 0.7
+    size "1024x1024"
   end
 end
 ```
@@ -40,7 +38,7 @@ end
 ## Using Transformers
 
 ```ruby
-result = <%= @root_namespace %>::Image::StyleTransformer.call(
+result = Images::StyleTransformer.call(
   image: "photo.jpg",
   prompt: "Oil painting style, impressionist"
 )
@@ -53,7 +51,7 @@ result.save("transformed.png")
 ### Override Strength
 
 ```ruby
-result = <%= @root_namespace %>::Image::StyleTransformer.call(
+result = Images::StyleTransformer.call(
   image: "photo.jpg",
   prompt: "Watercolor painting",
   strength: 0.5  # More subtle
@@ -65,18 +63,16 @@ result = <%= @root_namespace %>::Image::StyleTransformer.call(
 ### Artistic Style Transfer
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class ArtisticTransformer < ApplicationImageTransformer
-      strength 0.8
+module Images
+  class ArtisticTransformer < ApplicationImageTransformer
+    strength 0.8
 
-      template "{prompt} style, artistic rendering, high quality"
-    end
+    template "{prompt} style, artistic rendering, high quality"
   end
 end
 
 # Usage
-<%= @root_namespace %>::Image::ArtisticTransformer.call(
+Images::ArtisticTransformer.call(
   image: "photo.jpg",
   prompt: "Van Gogh starry night"
 )
@@ -85,14 +81,12 @@ end
 ### Photo Enhancement
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class EnhancementTransformer < ApplicationImageTransformer
-      strength 0.3  # Subtle enhancement
-
-      def default_prompt
-        "Enhanced lighting, improved colors, professional photography"
-      end
+module Images
+  class EnhancementTransformer < ApplicationImageTransformer
+    strength 0.3  # Subtle enhancement
+
+    def default_prompt
+      "Enhanced lighting, improved colors, professional photography"
     end
   end
 end
@@ -101,13 +95,11 @@ end
 ### Sketch to Photo
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class SketchToPhotoTransformer < ApplicationImageTransformer
-      strength 0.9
+module Images
+  class SketchToPhotoTransformer < ApplicationImageTransformer
+    strength 0.9
 
-      template "Photorealistic version of this sketch: {prompt}"
-    end
+    template "Photorealistic version of this sketch: {prompt}"
   end
 end
 ```

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

@@ -1,4 +1,4 @@
-# <%= @root_namespace %>::Image Upscalers
+# Images Upscalers
 
 This directory contains image upscaling services. All upscalers inherit from `ApplicationImageUpscaler`.
 
@@ -12,13 +12,11 @@ rails generate ruby_llm_agents:image_upscaler Photo --scale 4
 
 Or create manually:
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class PhotoUpscaler < ApplicationImageUpscaler
-      model "esrgan"
-      scale 4
-      denoise true
-    end
+module Images
+  class PhotoUpscaler < ApplicationImageUpscaler
+    model "esrgan"
+    scale 4
+    denoise true
   end
 end
 ```
@@ -40,7 +38,7 @@ end
 ## Using Upscalers
 
 ```ruby
-result = <%= @root_namespace %>::Image::PhotoUpscaler.call(image: "small.jpg")
+result = Images::PhotoUpscaler.call(image: "small.jpg")
 
 result.url              # Upscaled image URL
 result.image_data       # Binary data
@@ -52,7 +50,7 @@ result.save("large.png")
 ### Override Scale
 
 ```ruby
-result = <%= @root_namespace %>::Image::PhotoUpscaler.call(
+result = Images::PhotoUpscaler.call(
   image: "thumbnail.jpg",
   scale: 2  # Just double it
 )
@@ -63,13 +61,11 @@ result = <%= @root_namespace %>::Image::PhotoUpscaler.call(
 ### Thumbnail Enhancement
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class ThumbnailUpscaler < ApplicationImageUpscaler
-      scale 4
-      denoise true
-      sharpen true
-    end
+module Images
+  class ThumbnailUpscaler < ApplicationImageUpscaler
+    scale 4
+    denoise true
+    sharpen true
   end
 end
 ```
@@ -77,12 +73,10 @@ end
 ### Print Preparation
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class PrintUpscaler < ApplicationImageUpscaler
-      scale 4
-      denoise false  # Preserve original detail
-    end
+module Images
+  class PrintUpscaler < ApplicationImageUpscaler
+    scale 4
+    denoise false  # Preserve original detail
   end
 end
 ```
@@ -90,13 +84,11 @@ end
 ### Avatar Enhancement
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class AvatarUpscaler < ApplicationImageUpscaler
-      scale 2  # Modest upscale
-      denoise true
-      sharpen true
-    end
+module Images
+  class AvatarUpscaler < ApplicationImageUpscaler
+    scale 2  # Modest upscale
+    denoise true
+    sharpen true
   end
 end
 ```