ruby_llm-agents 1.0.0 → 1.2.0

data/lib/generators/ruby_llm_agents/templates/rename_tenant_budgets_to_tenants_migration.rb.tt

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+# Migration to rename tenant_budgets table to tenants
+#
+# This migration is for users upgrading from an older version of the gem
+# where the table was called 'ruby_llm_agents_tenant_budgets'.
+#
+# If you're doing a fresh install, use the create_tenants_migration instead.
+#
+# Run with: rails db:migrate
+class RenameTenantBudgetsToTenants < ActiveRecord::Migration<%= migration_version %>
+  def change
+    # Rename the table
+    rename_table :ruby_llm_agents_tenant_budgets, :ruby_llm_agents_tenants
+
+    # Add new columns for Tenant model
+    add_column :ruby_llm_agents_tenants, :active, :boolean, default: true
+    add_column :ruby_llm_agents_tenants, :metadata, :json, null: false, default: {}
+
+    # Add index for active status
+    add_index :ruby_llm_agents_tenants, :active
+
+    # Rename indexes to match new table name
+    # Note: Some databases handle this automatically when renaming tables
+    # If you get an error about missing indexes, you may need to adjust this
+
+    # The polymorphic index needs to be renamed if it exists
+    if index_exists?(:ruby_llm_agents_tenants, [:tenant_record_type, :tenant_record_id], name: "index_tenant_budgets_on_tenant_record")
+      rename_index :ruby_llm_agents_tenants,
+                   "index_tenant_budgets_on_tenant_record",
+                   "index_tenants_on_tenant_record"
+    end
+  end
+end

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

@@ -1,4 +1,4 @@
-# <%= @root_namespace %> Agents
+# Agents
 
 This directory contains LLM-powered agents for the application. All agents inherit from `ApplicationAgent`.
 
@@ -11,30 +11,47 @@ rails generate ruby_llm_agents:agent AgentName param1:required param2:default_va
 
 Or create manually by extending `ApplicationAgent`:
 ```ruby
-module <%= @root_namespace %>
-  class MyAgent < ApplicationAgent
-    # Configuration
-    model "gpt-4o"
-    temperature 0.0
-    version "1.0"
+class MyAgent < ApplicationAgent
+  # Configuration
+  model "gpt-4o"
+  temperature 0.0
+  version "1.0"
 
-    # Parameters
-    param :query, required: true
-    param :limit, default: 10
+  # Parameters
+  param :query, required: true
+  param :limit, default: 10
 
-    private
+  private
 
-    def system_prompt
-      "You are a helpful assistant."
-    end
+  def system_prompt
+    "You are a helpful assistant."
+  end
 
-    def user_prompt
-      query
-    end
+  def user_prompt
+    query
   end
 end
 ```
 
+## Directory Structure
+
+```
+app/agents/
+├── application_agent.rb      # Base class for all agents
+├── concerns/                 # Shared agent mixins
+├── my_agent.rb              # Task agents at root
+├── images/                   # Image operation agents
+│   ├── product_generator.rb
+│   └── content_analyzer.rb
+├── audio/                    # Audio operation agents
+│   ├── meeting_transcriber.rb
+│   └── voice_narrator.rb
+├── embedders/               # Embedding agents
+│   └── semantic_embedder.rb
+└── moderators/              # Moderation agents
+    └── content_moderator.rb
+```
+
 ## DSL Reference
 
 ### Model Configuration
@@ -178,7 +195,7 @@ end
 
 ```ruby
 # Basic call
-result = <%= @root_namespace %>::MyAgent.call(query: "hello")
+result = MyAgent.call(query: "hello")
 
 # Access result
 result.content          # The response content
@@ -187,27 +204,73 @@ result.output_tokens    # Tokens in response
 result.total_cost       # Cost in USD
 
 # Debug mode (no API call)
-result = <%= @root_namespace %>::MyAgent.call(query: "hello", dry_run: true)
+result = MyAgent.call(query: "hello", dry_run: true)
 
 # Skip cache
-result = <%= @root_namespace %>::MyAgent.call(query: "hello", skip_cache: true)
+result = MyAgent.call(query: "hello", skip_cache: true)
 
 # With attachments
-result = <%= @root_namespace %>::MyAgent.call(query: "describe this", with: "image.png")
+result = MyAgent.call(query: "describe this", with: "image.png")
 
 # Streaming
-<%= @root_namespace %>::MyAgent.stream(query: "hello") do |chunk|
+MyAgent.stream(query: "hello") do |chunk|
   print chunk.content
 end
 
 # Multi-tenancy
-result = <%= @root_namespace %>::MyAgent.call(query: "hello", tenant: current_user)
+result = MyAgent.call(query: "hello", tenant: current_user)
+```
+
+## Specialized Agents
+
+### Image Agents
+```ruby
+# app/agents/images/product_generator.rb
+module Images
+  class ProductGenerator < RubyLLM::Agents::Image::Generator
+    model "dall-e-3"
+    size "1024x1024"
+    quality "hd"
+  end
+end
+
+# Usage
+result = Images::ProductGenerator.call(prompt: "A product photo")
+result.url  # Image URL
+```
+
+### Audio Agents
+```ruby
+# app/agents/audio/meeting_transcriber.rb
+module Audio
+  class MeetingTranscriber < RubyLLM::Agents::Audio::Transcriber
+    model "whisper-1"
+  end
+end
+
+# Usage
+result = Audio::MeetingTranscriber.call(audio: "meeting.mp3")
+result.text  # Transcribed text
+```
+
+### Embedding Agents
+```ruby
+# app/agents/embedders/semantic_embedder.rb
+module Embedders
+  class SemanticEmbedder < RubyLLM::Agents::Embedder
+    model "text-embedding-3-large"
+  end
+end
+
+# Usage
+result = Embedders::SemanticEmbedder.call(text: "Hello world")
+result.embedding  # Vector array
 ```
 
 ## Testing Agents
 
 ```ruby
-RSpec.describe <%= @root_namespace %>::MyAgent do
+RSpec.describe MyAgent do
   describe ".call" do
     it "returns expected result" do
       # Use dry_run for unit tests

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

@@ -1,4 +1,4 @@
-# <%= @root_namespace %>::Image Background Removers
+# Images Background Removers
 
 This directory contains background removal services. All removers inherit from `ApplicationBackgroundRemover`.
 
@@ -12,13 +12,11 @@ rails generate ruby_llm_agents:background_remover Product --edge_refinement high
 
 Or create manually:
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class ProductRemover < ApplicationBackgroundRemover
-      model "remove-bg"
-      edge_refinement :high
-      output_format :png
-    end
+module Images
+  class ProductRemover < ApplicationBackgroundRemover
+    model "remove-bg"
+    edge_refinement :high
+    output_format :png
   end
 end
 ```
@@ -45,7 +43,7 @@ end
 ## Using Removers
 
 ```ruby
-result = <%= @root_namespace %>::Image::ProductRemover.call(image: "product.jpg")
+result = Images::ProductRemover.call(image: "product.jpg")
 
 result.url          # Image URL with transparent background
 result.image_data   # PNG binary data
@@ -56,7 +54,7 @@ result.save("product_nobg.png")
 ### With Background Color
 
 ```ruby
-result = <%= @root_namespace %>::Image::ProductRemover.call(
+result = Images::ProductRemover.call(
   image: "product.jpg",
   background_color: "#FFFFFF"  # White background
 )
@@ -65,7 +63,7 @@ result = <%= @root_namespace %>::Image::ProductRemover.call(
 ### Override Settings
 
 ```ruby
-result = <%= @root_namespace %>::Image::ProductRemover.call(
+result = Images::ProductRemover.call(
   image: "complex_photo.jpg",
   edge_refinement: :high,
   output_format: :webp
@@ -77,14 +75,12 @@ result = <%= @root_namespace %>::Image::ProductRemover.call(
 ### E-commerce Product Photos
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class ProductBackgroundRemover < ApplicationBackgroundRemover
-      edge_refinement :high
-      output_format :png
-
-      cache_for 30.days  # Product images don't change often
-    end
+module Images
+  class ProductBackgroundRemover < ApplicationBackgroundRemover
+    edge_refinement :high
+    output_format :png
+
+    cache_for 30.days  # Product images don't change often
   end
 end
 ```
@@ -92,24 +88,22 @@ end
 ### Profile Photo Processing
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class AvatarBackgroundRemover < ApplicationBackgroundRemover
-      edge_refinement :high
-      output_format :png
-    end
+module Images
+  class AvatarBackgroundRemover < ApplicationBackgroundRemover
+    edge_refinement :high
+    output_format :png
   end
 end
 
 # Remove background and resize
-result = <%= @root_namespace %>::Image::AvatarBackgroundRemover.call(image: uploaded_photo)
+result = Images::AvatarBackgroundRemover.call(image: uploaded_photo)
 ```
 
 ### Batch Processing
 
 ```ruby
 Product.where(background_removed: false).find_each do |product|
-  result = <%= @root_namespace %>::Image::ProductBackgroundRemover.call(
+  result = Images::ProductBackgroundRemover.call(
     image: product.original_image.download
   )
 

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

@@ -1,4 +1,4 @@
-# <%= @root_namespace %>::Text Embedders
+# Embedders
 
 This directory contains text embedding services for vector search and semantic similarity. All embedders inherit from `ApplicationEmbedder`.
 
@@ -13,14 +13,12 @@ rails generate ruby_llm_agents:embedder Search --dimensions 512 --batch_size 50
 
 Or create manually:
 ```ruby
-module <%= @root_namespace %>
-  module Text
-    class DocumentEmbedder < ApplicationEmbedder
-      model "text-embedding-3-small"
-      dimensions 1536
-      batch_size 100
-      cache_for 1.week
-    end
+module Embedders
+  class DocumentEmbedder < ApplicationEmbedder
+    model "text-embedding-3-small"
+    dimensions 1536
+    batch_size 100
+    cache_for 1.week
   end
 end
 ```
@@ -76,7 +74,7 @@ end
 ### Single Text Embedding
 
 ```ruby
-result = <%= @root_namespace %>::Text::DocumentEmbedder.call(text: "Hello world")
+result = Embedders::DocumentEmbedder.call(text: "Hello world")
 
 result.embedding    # [0.123, -0.456, ...] vector array
 result.dimensions   # 1536
@@ -90,7 +88,7 @@ Process multiple texts efficiently:
 
 ```ruby
 texts = ["Hello world", "Goodbye world", "Ruby programming"]
-result = <%= @root_namespace %>::Text::DocumentEmbedder.call(texts: texts)
+result = Embedders::DocumentEmbedder.call(texts: texts)
 
 result.embeddings   # Array of embedding vectors
 result.count        # 3
@@ -112,7 +110,7 @@ end
 
 # Generate and store embedding
 document = Document.find(1)
-result = <%= @root_namespace %>::Text::DocumentEmbedder.call(text: document.content)
+result = Embedders::DocumentEmbedder.call(text: document.content)
 document.update!(embedding: result.embedding)
 ```
 
@@ -120,7 +118,7 @@ document.update!(embedding: result.embedding)
 
 ```ruby
 # Embed the query
-query_result = <%= @root_namespace %>::Text::SearchEmbedder.call(text: "ruby web framework")
+query_result = Embedders::SearchEmbedder.call(text: "ruby web framework")
 
 # Find similar documents
 similar = Document.nearest_neighbors(:embedding, query_result.embedding, distance: "cosine")
@@ -132,20 +130,18 @@ similar = Document.nearest_neighbors(:embedding, query_result.embedding, distanc
 ### Document Embedding
 
 ```ruby
-module <%= @root_namespace %>
-  module Text
-    class DocumentEmbedder < ApplicationEmbedder
-      model "text-embedding-3-large"
-      dimensions 1024
-      batch_size 50
-      cache_for 30.days
-
-      def preprocess(text)
-        text
-          .strip
-          .gsub(/\s+/, ' ')
-          .truncate(8000)
-      end
+module Embedders
+  class DocumentEmbedder < ApplicationEmbedder
+    model "text-embedding-3-large"
+    dimensions 1024
+    batch_size 50
+    cache_for 30.days
+
+    def preprocess(text)
+      text
+        .strip
+        .gsub(/\s+/, ' ')
+        .truncate(8000)
     end
   end
 end
@@ -154,16 +150,14 @@ end
 ### Search Query Embedding
 
 ```ruby
-module <%= @root_namespace %>
-  module Text
-    class SearchEmbedder < ApplicationEmbedder
-      model "text-embedding-3-small"
-      dimensions 512
-      cache_for 1.hour  # Queries may repeat
-
-      def preprocess(text)
-        text.strip.downcase
-      end
+module Embedders
+  class SearchEmbedder < ApplicationEmbedder
+    model "text-embedding-3-small"
+    dimensions 512
+    cache_for 1.hour  # Queries may repeat
+
+    def preprocess(text)
+      text.strip.downcase
     end
   end
 end
@@ -172,20 +166,18 @@ end
 ### Code Embedding
 
 ```ruby
-module <%= @root_namespace %>
-  module Text
-    class CodeEmbedder < ApplicationEmbedder
-      model "text-embedding-3-large"
-      cache_for 7.days
-
-      def preprocess(text)
-        # Remove comments, normalize whitespace
-        text
-          .gsub(/#.*$/, '')
-          .gsub(/\/\/.*$/, '')
-          .gsub(/\s+/, ' ')
-          .strip
-      end
+module Embedders
+  class CodeEmbedder < ApplicationEmbedder
+    model "text-embedding-3-large"
+    cache_for 7.days
+
+    def preprocess(text)
+      # Remove comments, normalize whitespace
+      text
+        .gsub(/#.*$/, '')
+        .gsub(/\/\/.*$/, '')
+        .gsub(/\s+/, ' ')
+        .strip
     end
   end
 end
@@ -198,13 +190,13 @@ end
 Document.find_each(batch_size: 100) do |doc|
   next if doc.embedding.present?
 
-  result = <%= @root_namespace %>::Text::DocumentEmbedder.call(text: doc.content)
+  result = Embedders::DocumentEmbedder.call(text: doc.content)
   doc.update!(embedding: result.embedding)
 end
 
 # Or batch multiple at once
 texts = Document.where(embedding: nil).limit(100).pluck(:id, :content)
-results = <%= @root_namespace %>::Text::DocumentEmbedder.call(texts: texts.map(&:last))
+results = Embedders::DocumentEmbedder.call(texts: texts.map(&:last))
 
 texts.each_with_index do |(id, _), index|
   Document.find(id).update!(embedding: results.embeddings[index])
@@ -214,7 +206,7 @@ end
 ## Testing Embedders
 
 ```ruby
-RSpec.describe <%= @root_namespace %>::Text::DocumentEmbedder do
+RSpec.describe Embedders::DocumentEmbedder do
   describe ".call" do
     it "returns embedding vector" do
       result = described_class.call(text: "Hello world")

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

@@ -1,4 +1,4 @@
-# <%= @root_namespace %>::Image Analyzers
+# Images Analyzers
 
 This directory contains image analysis services. All analyzers inherit from `ApplicationImageAnalyzer`.
 
@@ -12,14 +12,12 @@ rails generate ruby_llm_agents:image_analyzer Product --model gpt-4o
 
 Or create manually:
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class ProductAnalyzer < ApplicationImageAnalyzer
-      model "gpt-4o"
-      analysis_type :detailed
-      extract_colors true
-      detect_objects true
-    end
+module Images
+  class ProductAnalyzer < ApplicationImageAnalyzer
+    model "gpt-4o"
+    analysis_type :detailed
+    extract_colors true
+    detect_objects true
   end
 end
 ```
@@ -41,7 +39,7 @@ end
 ## Using Analyzers
 
 ```ruby
-result = <%= @root_namespace %>::Image::ProductAnalyzer.call(image: "product.jpg")
+result = Images::ProductAnalyzer.call(image: "product.jpg")
 
 result.description   # Text description
 result.objects       # Detected objects
@@ -53,7 +51,7 @@ result.total_cost    # Cost in USD
 ### Analyze URL
 
 ```ruby
-result = <%= @root_namespace %>::Image::ProductAnalyzer.call(
+result = Images::ProductAnalyzer.call(
   image: "https://example.com/photo.jpg"
 )
 ```
@@ -61,16 +59,14 @@ result = <%= @root_namespace %>::Image::ProductAnalyzer.call(
 ### Custom Analysis Prompt
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class CustomAnalyzer < ApplicationImageAnalyzer
-      model "gpt-4o"
-      analysis_type :custom
-
-      def analysis_prompt
-        "Analyze this image for: composition, lighting, color harmony. " \
-        "Return JSON with scores from 1-10 for each aspect."
-      end
+module Images
+  class CustomAnalyzer < ApplicationImageAnalyzer
+    model "gpt-4o"
+    analysis_type :custom
+
+    def analysis_prompt
+      "Analyze this image for: composition, lighting, color harmony. " \
+      "Return JSON with scores from 1-10 for each aspect."
     end
   end
 end
@@ -81,15 +77,13 @@ end
 ### Content Moderation
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class ModerationAnalyzer < ApplicationImageAnalyzer
-      model "gpt-4o"
-
-      def analysis_prompt
-        "Analyze this image for inappropriate content. " \
-        "Return JSON with: safe (boolean), reason (string if unsafe)"
-      end
+module Images
+  class ModerationAnalyzer < ApplicationImageAnalyzer
+    model "gpt-4o"
+
+    def analysis_prompt
+      "Analyze this image for inappropriate content. " \
+      "Return JSON with: safe (boolean), reason (string if unsafe)"
     end
   end
 end
@@ -98,15 +92,13 @@ end
 ### Product Categorization
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class CategoryAnalyzer < ApplicationImageAnalyzer
-      model "gpt-4o"
-      detect_objects true
-
-      def analysis_prompt
-        "Identify the product category, brand if visible, and condition."
-      end
+module Images
+  class CategoryAnalyzer < ApplicationImageAnalyzer
+    model "gpt-4o"
+    detect_objects true
+
+    def analysis_prompt
+      "Identify the product category, brand if visible, and condition."
     end
   end
 end

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

@@ -1,4 +1,4 @@
-# <%= @root_namespace %>::Image Editors
+# Images Editors
 
 This directory contains image editing services (inpainting, masked edits). All editors inherit from `ApplicationImageEditor`.
 
@@ -12,13 +12,11 @@ rails generate ruby_llm_agents:image_editor Background --model gpt-image-1
 
 Or create manually:
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class BackgroundEditor < ApplicationImageEditor
-      model "gpt-image-1"
-      size "1024x1024"
-      content_policy :standard
-    end
+module Images
+  class BackgroundEditor < ApplicationImageEditor
+    model "gpt-image-1"
+    size "1024x1024"
+    content_policy :standard
   end
 end
 ```
@@ -36,7 +34,7 @@ end
 ### Basic Edit with Mask
 
 ```ruby
-result = <%= @root_namespace %>::Image::BackgroundEditor.call(
+result = Images::BackgroundEditor.call(
   image: "photo.png",
   mask: "mask.png",
   prompt: "Beautiful sunset sky background"
@@ -51,7 +49,7 @@ result.save("edited.png")
 
 ```ruby
 # Mask should be PNG with transparent areas indicating regions to edit
-result = <%= @root_namespace %>::Image::BackgroundEditor.call(
+result = Images::BackgroundEditor.call(
   image: original_image,
   mask: mask_with_transparent_areas,
   prompt: "Modern city skyline"
@@ -63,15 +61,13 @@ result = <%= @root_namespace %>::Image::BackgroundEditor.call(
 ### Background Replacement
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class BackgroundReplacer < ApplicationImageEditor
-      model "gpt-image-1"
-      size "1024x1024"
-
-      def default_prompt
-        "Professional studio background, soft lighting"
-      end
+module Images
+  class BackgroundReplacer < ApplicationImageEditor
+    model "gpt-image-1"
+    size "1024x1024"
+
+    def default_prompt
+      "Professional studio background, soft lighting"
     end
   end
 end
@@ -80,15 +76,13 @@ end
 ### Object Removal
 
 ```ruby
-module <%= @root_namespace %>
-  module Image
-    class ObjectRemover < ApplicationImageEditor
-      model "gpt-image-1"
-
-      # Mask covers the object to remove
-      def default_prompt
-        "Seamless continuation of the surrounding area"
-      end
+module Images
+  class ObjectRemover < ApplicationImageEditor
+    model "gpt-image-1"
+
+    # Mask covers the object to remove
+    def default_prompt
+      "Seamless continuation of the surrounding area"
     end
   end
 end