rails_ai_agents 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c25238542baeaaf8282355331fe4cbf48e7cf7f9599b08e99ac72482377d3af5
+  data.tar.gz: 592c3a6f26984a0b42580630cbdad218a2ab205b1248e644b34f7b10ed132554
+SHA512:
+  metadata.gz: efef1eedec187ecd9e5ee3860decefb394d76b42de5a15f64deb07bc2b12e4b5021071ca88d6407b2cbc0a05cef7caf1efe104b0a219a392539c648e6e877639
+  data.tar.gz: d9baafe0f8124cc75e65d58da83bb9ce41b2273bce72a7f560a58341b566ec63803092e81b9d1fb71600939afafe2b00a07cf608735b634068b8b11c681778fb

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2024 Rohit
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,296 @@
+# Rails AI Agents
+
+A modular and extendable Rails engine that provides an Agent model and LLM client integration for building AI-powered applications.
+
+[![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.2.0-ruby.svg)](https://www.ruby-lang.org/en/)
+[![Rails](https://img.shields.io/badge/rails-%3E%3D%208.0.0-red.svg)](https://rubyonrails.org/)
+
+## Features
+
+- 🚀 **Mountable Rails Engine** - Easily integrate into existing Rails applications
+- 🤖 **Agent Model** - Manage AI agents with configurable settings
+- 🔌 **LLM Integration** - Built-in support for OpenAI and other LLM providers
+- ⚙️ **Configurable** - Flexible configuration through Rails initializers
+- 🛠️ **Generator Support** - Easy installation with Rails generators
+- 📋 **Rake Tasks** - Built-in commands for managing agents
+- 🔄 **Extensible** - Modular design for easy customization
+
+## Requirements
+
+- Ruby >= 3.2.0
+- Rails >= 8.0.0
+- A supported LLM provider (OpenAI, etc.)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'rails_ai_agents'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+Or install it yourself as:
+
+```bash
+gem install rails_ai_agents
+```
+
+## Setup
+
+### 1. Run the installer
+
+```bash
+rails generate ai_agents:install
+```
+
+This will:
+- Create a migration for the `ai_agents` table
+- Generate a configuration initializer at `config/initializers/ai_agents.rb`
+
+### 2. Run the migration
+
+```bash
+rails db:migrate
+```
+
+### 3. Configure your LLM provider
+
+Edit `config/initializers/ai_agents.rb`:
+
+```ruby
+RailsAiAgents.configure do |config|
+  # LLM Provider Configuration
+  config.llm_provider = :openai
+  
+  # API Key (store securely!)
+  config.api_key = Rails.application.credentials.openai_api_key || ENV['OPENAI_API_KEY']
+  
+  # Default model
+  config.default_model = "gpt-3.5-turbo"
+  
+  # API base URL (for OpenAI-compatible APIs)
+  config.api_base_url = "https://api.openai.com/v1"
+end
+```
+
+### 4. Test your configuration
+
+```bash
+rails ai_agents:test_connection
+```
+
+## Usage
+
+### Creating Agents
+
+```ruby
+# Create a basic agent
+agent = AiAgents::Agent.create!(
+  name: "Assistant",
+  description: "A helpful AI assistant",
+  model: "gpt-3.5-turbo"
+)
+
+# Create an agent with custom configuration
+agent = AiAgents::Agent.create!(
+  name: "Creative Writer",
+  description: "An AI specialized in creative writing",
+  model: "gpt-4",
+  config: {
+    "temperature" => 0.9,
+    "max_tokens" => 2000,
+    "top_p" => 0.95
+  }
+)
+```
+
+### Using Agents
+
+```ruby
+# Simple usage
+agent = AiAgents::Agent.find_by(name: "Assistant")
+response = agent.run("Hello, how are you today?")
+puts response
+
+# Handle errors
+begin
+  response = agent.run("Write a story about robots")
+  puts response
+rescue AiAgents::LLMClient::AuthenticationError => e
+  puts "Authentication failed: #{e.message}"
+rescue AiAgents::LLMClient::RateLimitError => e
+  puts "Rate limit exceeded: #{e.message}"
+rescue AiAgents::LLMClient::APIError => e
+  puts "API error: #{e.message}"
+end
+```
+
+### Finding Agents
+
+```ruby
+# Find by name
+agent = AiAgents::Agent.by_name("Assistant")
+
+# Find active agents
+active_agents = AiAgents::Agent.active
+
+# Find agents by model
+gpt4_agents = AiAgents::Agent.where(model: "gpt-4")
+```
+
+### Managing Agents
+
+```ruby
+# List all agents (via rake task)
+rails ai_agents:list
+
+# Deactivate an agent
+agent.update!(active: false)
+
+# Update agent configuration
+agent.update!(
+  config: {
+    "temperature" => 0.5,
+    "max_tokens" => 1500
+  }
+)
+```
+
+## Configuration
+
+The gem supports the following configuration options:
+
+```ruby
+RailsAiAgents.configure do |config|
+  # LLM Provider (:openai is currently the only supported provider)
+  config.llm_provider = :openai
+  
+  # Your API key
+  config.api_key = "your-api-key-here"
+  
+  # Default model to use for new agents
+  config.default_model = "gpt-3.5-turbo"
+  
+  # API base URL (useful for OpenAI-compatible APIs)
+  config.api_base_url = "https://api.openai.com/v1"
+end
+```
+
+### Agent Configuration Options
+
+Each agent can be configured with the following options in their `config` field:
+
+- `temperature`: Controls randomness (0.0 to 2.0, default: 0.7)
+- `max_tokens`: Maximum tokens in response (default: 1000)
+- `top_p`: Nucleus sampling parameter (0.0 to 1.0, default: 1.0)
+- `frequency_penalty`: Reduces repetition (-2.0 to 2.0, default: 0.0)
+- `presence_penalty`: Encourages new topics (-2.0 to 2.0, default: 0.0)
+
+## Rake Tasks
+
+### List all agents
+
+```bash
+rails ai_agents:list
+```
+
+Shows all registered agents with their configurations and status.
+
+### Test LLM connection
+
+```bash
+rails ai_agents:test_connection
+```
+
+Tests the connection to your configured LLM provider.
+
+## Routes
+
+This gem is designed as a mountable engine but **does not auto-mount any routes**. You have full control over the routing in your host application.
+
+If you want to add web interfaces for managing agents, you can create controllers in your host app or mount specific routes as needed.
+
+## Error Handling
+
+The gem provides several custom exception classes:
+
+- `AiAgents::LLMClient::LLMError` - Base error class
+- `AiAgents::LLMClient::AuthenticationError` - API key issues
+- `AiAgents::LLMClient::RateLimitError` - Rate limiting
+- `AiAgents::LLMClient::APIError` - General API errors
+
+## Extending the Gem
+
+### Adding Custom LLM Providers
+
+To add support for additional LLM providers, extend the `LLMClient` class:
+
+```ruby
+# In your application
+module AiAgents
+  class LLMClient
+    private
+    
+    def complete_with_custom_provider(prompt)
+      # Your custom implementation
+    end
+  end
+end
+```
+
+### Custom Agent Behaviors
+
+You can extend the `Agent` model in your application:
+
+```ruby
+# app/models/ai_agents/agent.rb (in your app)
+module AiAgents
+  class Agent
+    # Add custom methods or behaviors
+    def run_with_context(prompt, context = {})
+      enhanced_prompt = "Context: #{context.to_json}\n\nPrompt: #{prompt}"
+      run(enhanced_prompt)
+    end
+  end
+end
+```
+
+## Database Schema
+
+The `ai_agents` table includes:
+
+- `name` - Unique identifier for the agent
+- `description` - Human-readable description
+- `model` - LLM model to use (e.g., "gpt-3.5-turbo")
+- `config` - JSON configuration for model parameters
+- `active` - Boolean flag for enabling/disabling agents
+- `created_at` / `updated_at` - Standard Rails timestamps
+
+## Security Considerations
+
+1. **API Keys**: Store API keys securely using Rails credentials or environment variables
+2. **Input Validation**: Always validate and sanitize user inputs before sending to LLM APIs
+3. **Rate Limiting**: Implement rate limiting in your application to avoid API limits
+4. **Cost Control**: Monitor your LLM provider usage to control costs
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+This gem is available as open source under the terms of the [MIT License](MIT-LICENSE).
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for version history and changes.

data/Rakefile

@@ -0,0 +1,14 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec
+
+# Load engine rake tasks in development
+begin
+  require 'rails_ai_agents/engine'
+  RailsAiAgents::Engine.load_tasks
+rescue LoadError
+  # Engine not loaded in development
+end

data/app/models/ai_agents/agent.rb

@@ -0,0 +1,61 @@
+module AiAgents
+  class Agent < ApplicationRecord
+    self.table_name = "ai_agents"
+
+    # Validations
+    validates :name, presence: true, uniqueness: true
+    validates :description, presence: true
+    validates :model, presence: true
+
+    # JSON serialization for config field
+    serialize :config, coder: JSON
+
+    # Callbacks
+    before_validation :set_default_config, if: -> { config.blank? }
+    before_validation :set_default_model, if: -> { model.blank? }
+
+    # Instance methods
+    def run(prompt)
+      raise ArgumentError, "Prompt cannot be blank" if prompt.blank?
+      
+      llm_client = AiAgents::LLMClient.new(
+        model: self.model,
+        config: self.config
+      )
+      
+      llm_client.complete(prompt)
+    rescue => e
+      Rails.logger.error "Agent #{name} failed to process prompt: #{e.message}"
+      raise e
+    end
+
+    # Class methods
+    def self.by_name(name)
+      find_by(name: name)
+    end
+
+    def self.active
+      where(active: true)
+    end
+
+    private
+
+    def set_default_config
+      self.config = default_config
+    end
+
+    def set_default_model
+      self.model = RailsAiAgents.configuration.default_model
+    end
+
+    def default_config
+      {
+        "temperature" => 0.7,
+        "max_tokens" => 1000,
+        "top_p" => 1.0,
+        "frequency_penalty" => 0.0,
+        "presence_penalty" => 0.0
+      }
+    end
+  end
+end

data/app/services/ai_agents/llm_client.rb

@@ -0,0 +1,91 @@
+require "faraday"
+require "json"
+
+module AiAgents
+  class LLMClient
+    class LLMError < StandardError; end
+    class AuthenticationError < LLMError; end
+    class RateLimitError < LLMError; end
+    class APIError < LLMError; end
+
+    attr_reader :model, :config
+
+    def initialize(model: nil, config: {})
+      @model = model || RailsAiAgents.configuration.default_model
+      @config = config || {}
+    end
+
+    def complete(prompt)
+      case RailsAiAgents.configuration.llm_provider
+      when :openai
+        complete_with_openai(prompt)
+      else
+        raise LLMError, "Unsupported LLM provider: #{RailsAiAgents.configuration.llm_provider}"
+      end
+    end
+
+    private
+
+    def complete_with_openai(prompt)
+      raise AuthenticationError, "OpenAI API key not configured" unless api_key
+
+      response = openai_client.post("/chat/completions") do |req|
+        req.headers["Authorization"] = "Bearer #{api_key}"
+        req.headers["Content-Type"] = "application/json"
+        req.body = build_openai_payload(prompt).to_json
+      end
+
+      handle_openai_response(response)
+    end
+
+    def build_openai_payload(prompt)
+      {
+        model: @model,
+        messages: [
+          {
+            role: "user",
+            content: prompt
+          }
+        ],
+        temperature: @config["temperature"] || 0.7,
+        max_tokens: @config["max_tokens"] || 1000,
+        top_p: @config["top_p"] || 1.0,
+        frequency_penalty: @config["frequency_penalty"] || 0.0,
+        presence_penalty: @config["presence_penalty"] || 0.0
+      }
+    end
+
+    def handle_openai_response(response)
+      case response.status
+      when 200
+        data = JSON.parse(response.body)
+        data.dig("choices", 0, "message", "content")
+      when 401
+        raise AuthenticationError, "Invalid API key"
+      when 429
+        raise RateLimitError, "Rate limit exceeded"
+      when 400..499
+        error_data = JSON.parse(response.body) rescue {}
+        error_message = error_data.dig("error", "message") || "Client error"
+        raise APIError, "Client error: #{error_message}"
+      when 500..599
+        raise APIError, "Server error: #{response.status}"
+      else
+        raise APIError, "Unexpected response: #{response.status}"
+      end
+    rescue JSON::ParserError => e
+      raise APIError, "Invalid JSON response: #{e.message}"
+    end
+
+    def openai_client
+      @openai_client ||= Faraday.new(
+        url: RailsAiAgents.configuration.api_base_url,
+        request: { timeout: 30 }
+      )
+    end
+
+    def api_key
+      @api_key ||= RailsAiAgents.configuration.api_key
+    end
+  end
+end

data/lib/generators/ai_agents/install/install_generator.rb

@@ -0,0 +1,36 @@
+require "rails/generators"
+require "rails/generators/migration"
+
+module AiAgents
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      include Rails::Generators::Migration
+
+      source_root File.expand_path("templates", __dir__)
+      desc "Install AI Agents migration and initializer"
+
+      def self.next_migration_number(path)
+        next_migration_number = current_migration_number(path) + 1
+        ActiveRecord::Migration.next_migration_number(next_migration_number)
+      end
+
+      def copy_migration
+        migration_template "create_ai_agents.rb.erb", "db/migrate/create_ai_agents.rb"
+      end
+
+      def copy_initializer
+        template "ai_agents_initializer.rb.erb", "config/initializers/ai_agents.rb"
+      end
+
+      def show_readme
+        readme "README" if behavior == :invoke
+      end
+
+      private
+
+      def migration_version
+        "[#{ActiveRecord::Migration.current_version}]"
+      end
+    end
+  end
+end

data/lib/generators/ai_agents/install/templates/README

@@ -0,0 +1,33 @@
+===============================================================================
+
+Rails AI Agents has been installed!
+
+===============================================================================
+
+Next steps:
+
+1. Run the migration to create the ai_agents table:
+   rails db:migrate
+
+2. Configure your LLM provider in config/initializers/ai_agents.rb
+   Make sure to set your API key using Rails credentials or environment variables.
+
+3. Create your first AI agent:
+   
+   agent = AiAgents::Agent.create!(
+     name: "Assistant",
+     description: "A helpful assistant",
+     model: "gpt-3.5-turbo"
+   )
+
+4. Use your agent:
+   
+   response = agent.run("Hello, how are you?")
+   puts response
+
+5. List all agents using the rake task:
+   rails ai_agents:list
+
+For more information, check out the documentation.
+
+===============================================================================

data/lib/generators/ai_agents/install/templates/ai_agents_initializer.rb.erb

@@ -0,0 +1,15 @@
+RailsAiAgents.configure do |config|
+  # LLM Provider Configuration
+  # Supported providers: :openai (more coming soon)
+  config.llm_provider = :openai
+
+  # API Key for your LLM provider
+  # It's recommended to store this in Rails credentials or environment variables
+  config.api_key = Rails.application.credentials.openai_api_key || ENV['OPENAI_API_KEY']
+
+  # Default model to use if not specified on individual agents
+  config.default_model = "gpt-3.5-turbo"
+
+  # API base URL (useful for OpenAI-compatible APIs)
+  config.api_base_url = "https://api.openai.com/v1"
+end

data/lib/generators/ai_agents/install/templates/create_ai_agents.rb.erb

@@ -0,0 +1,16 @@
+class CreateAiAgents < ActiveRecord::Migration<%= migration_version %>
+  def change
+    create_table :ai_agents do |t|
+      t.string :name, null: false, index: { unique: true }
+      t.text :description, null: false
+      t.string :model, null: false
+      t.json :config, default: {}
+      t.boolean :active, default: true, null: false
+
+      t.timestamps null: false
+    end
+
+    add_index :ai_agents, :active
+    add_index :ai_agents, :model
+  end
+end

data/lib/rails_ai_agents/engine.rb

@@ -0,0 +1,28 @@
+require "rails/engine"
+
+module RailsAiAgents
+  class Engine < ::Rails::Engine
+    isolate_namespace RailsAiAgents
+
+    # Don't auto-mount any routes - let the host app define them
+    config.generators do |g|
+      g.test_framework :rspec, fixture: false
+      g.fixture_replacement :factory_bot, dir: "spec/factories"
+      g.assets false
+      g.helper false
+    end
+
+    # Load rake tasks
+    rake_tasks do
+      load File.expand_path("../tasks/ai_agents.rake", __dir__)
+    end
+
+    # Ensure models and services are autoloaded
+    config.autoload_paths << File.expand_path("../../app/models", __dir__)
+    config.autoload_paths << File.expand_path("../../app/services", __dir__)
+
+    initializer "rails_ai_agents.load_app_root" do |app|
+      config.paths.add "config/database", with: "config/database.yml"
+    end
+  end
+end

data/lib/rails_ai_agents/tasks/ai_agents.rake

@@ -0,0 +1,62 @@
+namespace :ai_agents do
+  desc "List all registered AI agents"
+  task list: :environment do
+    begin
+      agents = AiAgents::Agent.all.order(:name)
+      
+      if agents.empty?
+        puts "No AI agents found. Create one using AiAgents::Agent.create!"
+        puts
+        puts "Example:"
+        puts "  agent = AiAgents::Agent.create!("
+        puts "    name: 'Assistant',"
+        puts "    description: 'A helpful assistant',"
+        puts "    model: 'gpt-3.5-turbo'"
+        puts "  )"
+      else
+        puts "AI Agents (#{agents.count} total):"
+        puts "=" * 60
+        
+        agents.each do |agent|
+          status = agent.active? ? "✓ Active" : "✗ Inactive"
+          
+          puts "Name: #{agent.name}"
+          puts "Description: #{agent.description}"
+          puts "Model: #{agent.model}"
+          puts "Status: #{status}"
+          puts "Created: #{agent.created_at.strftime('%Y-%m-%d %H:%M:%S')}"
+          puts "Config: #{agent.config.inspect}" if agent.config.present?
+          puts "-" * 40
+        end
+      end
+    rescue => e
+      puts "Error listing agents: #{e.message}"
+      puts "Make sure you've run 'rails ai_agents:install' and 'rails db:migrate'"
+    end
+  end
+  
+  desc "Test connection to LLM provider"
+  task test_connection: :environment do
+    begin
+      puts "Testing connection to #{RailsAiAgents.configuration.llm_provider}..."
+      puts "Model: #{RailsAiAgents.configuration.default_model}"
+      puts "API Base URL: #{RailsAiAgents.configuration.api_base_url}"
+      
+      if RailsAiAgents.configuration.api_key.nil?
+        puts "❌ API key not configured"
+        puts "Set your API key in config/initializers/ai_agents.rb"
+      else
+        puts "✅ API key is configured"
+        
+        # Test with a simple prompt
+        client = AiAgents::LLMClient.new
+        response = client.complete("Say 'Hello from Rails AI Agents!'")
+        
+        puts "✅ Connection successful!"
+        puts "Response: #{response}"
+      end
+    rescue => e
+      puts "❌ Connection failed: #{e.message}"
+    end
+  end
+end

data/lib/rails_ai_agents/version.rb

@@ -0,0 +1,3 @@
+module RailsAiAgents
+  VERSION = "0.1.0"
+end

data/lib/rails_ai_agents.rb

@@ -0,0 +1,30 @@
+require "rails_ai_agents/version"
+require "rails_ai_agents/engine"
+
+module RailsAiAgents
+  # Configuration class for gem-wide settings
+  class Configuration
+    attr_accessor :llm_provider, :api_key, :default_model, :api_base_url
+
+    def initialize
+      @llm_provider = :openai
+      @api_key = nil
+      @default_model = "gpt-3.5-turbo"
+      @api_base_url = "https://api.openai.com/v1"
+    end
+  end
+
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
+  end
+end

metadata

@@ -0,0 +1,145 @@
+--- !ruby/object:Gem::Specification
+name: rails_ai_agents
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Rohit
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-10-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.0.0
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-multipart
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: factory_bot_rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+description: A modular and extendable Rails engine that provides an Agent model and
+  LLM client integration for building AI-powered applications.
+email:
+- your-email@example.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/models/ai_agents/agent.rb
+- app/services/ai_agents/llm_client.rb
+- lib/generators/ai_agents/install/install_generator.rb
+- lib/generators/ai_agents/install/templates/README
+- lib/generators/ai_agents/install/templates/ai_agents_initializer.rb.erb
+- lib/generators/ai_agents/install/templates/create_ai_agents.rb.erb
+- lib/rails_ai_agents.rb
+- lib/rails_ai_agents/engine.rb
+- lib/rails_ai_agents/tasks/ai_agents.rake
+- lib/rails_ai_agents/version.rb
+homepage: https://github.com/yourusername/rails_ai_agents
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/yourusername/rails_ai_agents
+  source_code_uri: https://github.com/yourusername/rails_ai_agents
+  changelog_uri: https://github.com/yourusername/rails_ai_agents/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.8.11
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: A Rails engine for managing AI agents with LLM integration
+test_files: []