rails-agent-stack 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83dde44cc5a68ee22c237736bd5992f64baf5b474e1ef7e3615244277988060f
-  data.tar.gz: 407a7cc7dc2fdde847babc4e948f38f7028d8121bb3142a9804058c366fcb58d
+  metadata.gz: 0f5d7de33618df03c5ebbe49d571eee86e3b50da10077791ae70538ff617bcd0
+  data.tar.gz: b9763bf309ff5aba6d98db8e59325d4520521f26f4ea46eb0d2fcb0a9e560581
 SHA512:
-  metadata.gz: 520d19cb9bee5584270474f80b77518b99f81f4cec77c8d03603716dae2ef988007cf5b5474fb0150369aba473f6a00cfd1301259238fb8e267412bad36ff8e4
-  data.tar.gz: ccfacfe644d0facb1b2730b90c5877cecdde11c06b5d471a6ae5aa7d24cf48464a0aacae36e5ea5d362df8b1051e95702048d0a8bf42e2ed83c253968d833d71
+  metadata.gz: 0f5cfb786c36d73e5462922f62c3df17b01e350d5a0bc4ac434d4e7e47565c2fe6291ec55880e5efe479961329735bee8802867dd49e1399462abe7c0a05806b
+  data.tar.gz: 5ba805a6d684e768df713012bc573c2a54c014925dc3ceec9eb6d340b94ebf44fce0e3a71379dcc1faec40629839db57cf906ecf3da78d696ae7b27029701785

data/.github/workflows/README.md

@@ -4,10 +4,10 @@
 |----------|---------|---------|
 | `ci.yml` | push/PR to `main` | RSpec + gem build |
 
-This repo is the **Ruby gem** (`rails-agent-stack`). It has **no Hetzner deploy** — customers install from GitHub:
+This repo is the **Ruby gem** (`rails-agent-stack`). It has **no Hetzner deploy** — customers install from [RubyGems](https://rubygems.org/gems/rails-agent-stack):
 
 ```ruby
-gem "rails-agent-stack", github: "Tiny-Bubble-Company/rails-agents"
+gem "rails-agent-stack", "~> 0.1"
 ```
 
 Production sites deploy from sibling repos:

data/.gitignore

@@ -6,3 +6,15 @@
 /.rspec_status
 *.gem
 .DS_Store
+
+# Secrets & local credentials (never commit)
+.env
+.env.*
+!.env.example
+config/master.key
+config/credentials.yml
+config/credentials/*.key
+config/rails_agents_credentials.yml
+*.pem
+id_rsa*
+secrets.json

data/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to `rails-agent-stack` will be documented in this file.
 
-## [0.2.0] - Unreleased
+## [0.2.0] - 2026-08-03
 
 ### Changed
 
@@ -12,11 +12,16 @@ All notable changes to `rails-agent-stack` will be documented in this file.
 - Generator `--type` and `--database` for database-connected Knowledge agents.
 - Company subscription + pass-through usage + 1% service fee pricing model.
 - Deprecated cloud pull bridge in embed UI; `rails-agents pull` retained for compatibility.
+- **Rails support widened to 6.1+** (was 7.0+). Compatibility shims for redirects, CSRF,
+  Zeitwerk ignore, `module_parent_name`, and database configs.
+- Gem authors attributed to Tiny Bubble Company (`support@rails-agent.com`).
 
 ### Added
 
 - `KnowledgeAgent`, `OperationsAgent`, and `MonitoringAgent` classes; the legacy output-focused class remains loadable for compatibility.
 - `docs/AGENTS.md` canonical guide for external coding agents.
+- `docs/RAILS_SUPPORT.md` — supported versions and upgrade/sidecar guidance for Rails 3–5 apps.
+- `RailsAgents::Compat` helpers for cross-version engine behavior.
 
 ## [0.1.1] - 2026-08-02
 

data/README.md

@@ -15,7 +15,7 @@
   <a href="https://rails-agent.com"><img src="https://img.shields.io/badge/rails--agent.com-docs-C2410C?style=flat-square" alt="Docs" /></a>
   <a href="https://github.com/Tiny-Bubble-Company/rails-agents"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT" /></a>
   <a href="https://rails-agent.com/docs/getting-started"><img src="https://img.shields.io/badge/Ruby-3.2%2B-CC342D?style=flat-square&logo=ruby&logoColor=white" alt="Ruby 3.2+" /></a>
-  <a href="https://rails-agent.com/docs/getting-started"><img src="https://img.shields.io/badge/Rails-7%2B-D30001?style=flat-square&logo=rubyonrails&logoColor=white" alt="Rails 7+" /></a>
+  <a href="docs/RAILS_SUPPORT.md"><img src="https://img.shields.io/badge/Rails-6.1%2B-D30001?style=flat-square&logo=rubyonrails&logoColor=white" alt="Rails 6.1+" /></a>
 </p>
 
 <p align="center">
@@ -95,7 +95,7 @@ Positioning in one line: **most advanced agentic platform for Ruby on Rails**
 
 ```ruby
 # Gemfile
-gem "rails-agent-stack", github: "Tiny-Bubble-Company/rails-agents"
+gem "rails-agent-stack", "~> 0.2"
 ```
 
 ```bash

data/app/controllers/rails_agents/application_controller.rb

@@ -19,7 +19,7 @@ module RailsAgents
     end
 
     def cloud_redirect(path)
-      redirect_to dashboard_url(path), allow_other_host: true
+      redirect_to dashboard_url(path), **RailsAgents::Compat.redirect_options
     end
   end
 end

data/app/controllers/rails_agents/handshake_controller.rb

@@ -16,7 +16,7 @@ module RailsAgents
 
       email = params.require(:email).to_s.strip
       password = params.require(:password).to_s
-      workspace = params[:workspace].presence || (defined?(Rails) ? Rails.application.class.module_parent_name : "App")
+      workspace = params[:workspace].presence || (defined?(Rails) ? RailsAgents::Compat.application_name : "App")
 
       response = Client.new.handshake(
         email: email,

data/app/controllers/rails_agents/open_wire_inbound_controller.rb

@@ -12,7 +12,7 @@ module RailsAgents
   # Resolves agent via:
   #   ?agent=order_notification  OR  JSON meta / installation mapping in channels/*.yml
   class OpenWireInboundController < ApplicationController
-    skip_forgery_protection
+    RailsAgents::Compat.skip_csrf!(self)
 
     def create
       slug = resolve_agent_slug

data/app/controllers/rails_agents/registrations_controller.rb

@@ -90,7 +90,9 @@ module RailsAgents
     private
 
     def default_workspace
-      (Rails.application.class.module_parent_name rescue "MyApp")
+      RailsAgents::Compat.application_name
+    rescue StandardError
+      "MyApp"
     end
   end
 end

data/app/controllers/rails_agents/schema_controller.rb

@@ -25,14 +25,7 @@ module RailsAgents
     def configured_databases
       configs = []
       if defined?(ActiveRecord::Base)
-        ActiveRecord::Base.configurations.configs_for(env_name: Rails.env).each do |db|
-          configs << {
-            name: db.name.to_s,
-            adapter: normalize_adapter(db.adapter),
-            raw_adapter: db.adapter.to_s,
-            source: "config/database.yml"
-          }
-        end
+        configs.concat(active_record_database_configs)
       end
       if Rails.root.join("config/mongoid.yml").exist?
         configs << {
@@ -47,6 +40,33 @@ module RailsAgents
       []
     end
 
+    def active_record_database_configs
+      configurations = ActiveRecord::Base.configurations
+      if configurations.respond_to?(:configs_for)
+        configurations.configs_for(env_name: Rails.env).map do |db|
+          {
+            name: (db.respond_to?(:name) ? db.name : "primary").to_s,
+            adapter: normalize_adapter(db.adapter),
+            raw_adapter: db.adapter.to_s,
+            source: "config/database.yml"
+          }
+        end
+      else
+        # Rails < 6.0 Hash-style configurations fallback
+        entry = configurations[Rails.env]
+        entry = entry["primary"] || entry.values.first if entry.is_a?(Hash) && entry.values.first.is_a?(Hash)
+        adapter = entry.is_a?(Hash) ? (entry["adapter"] || entry[:adapter]) : nil
+        [{
+          name: "primary",
+          adapter: normalize_adapter(adapter),
+          raw_adapter: adapter.to_s,
+          source: "config/database.yml"
+        }]
+      end
+    rescue StandardError
+      []
+    end
+
     def active_record_tables
       return [] unless defined?(ActiveRecord::Base)
 

data/app/controllers/rails_agents/sessions_controller.rb

@@ -70,7 +70,7 @@ module RailsAgents
     def destroy
       cloud = RailsAgents.config.dashboard_base.to_s.chomp("/")
       cloud = "https://cloud.rails-agent.com" if cloud.blank?
-      redirect_to "#{cloud}/signin", allow_other_host: true
+      redirect_to "#{cloud}/signin", **RailsAgents::Compat.redirect_options
     end
   end
 end

data/app/controllers/rails_agents/tool_bridge_controller.rb

@@ -7,7 +7,7 @@ require "uri"
 
 module RailsAgents
   class ToolBridgeController < ApplicationController
-    skip_forgery_protection
+    RailsAgents::Compat.skip_csrf!(self)
 
     def create
       return render json: { error: "Unauthorized" }, status: :unauthorized unless authorized_runtime?

data/app/views/rails_agents/registrations/new.html.erb

@@ -1,6 +1,6 @@
 <%
   @step ||= :email
-  @workspace ||= (Rails.application.class.module_parent_name rescue "MyApp")
+  @workspace ||= RailsAgents::Compat.application_name
   @github_url ||= "#"
 %>
 <div class="rails-agents-connect">

data/docs/RAILS_SUPPORT.md

@@ -0,0 +1,55 @@
+# Rails version support
+
+## Supported
+
+| Rails | Status |
+|-------|--------|
+| **8.x** | Fully supported |
+| **7.x** | Fully supported |
+| **6.1** | Supported (compatibility shims) |
+| 6.0 | Best-effort (upgrade to 6.1+ recommended) |
+| 5.x and older | **Not supported** — see below |
+
+| Ruby | Status |
+|------|--------|
+| **3.2+** | Required |
+| 3.1 and older | Not supported (open-wire and modern MRI tooling require 3.2+) |
+
+`rails-agent-stack` is a mountable Rails engine with Zeitwerk-aware installers,
+cloud sync, and channel webhooks. Those APIs exist from Rails 6.1 onward.
+
+## Why not Rails 3–5?
+
+Apps from ~2009 often run Rails 3–5 on Ruby 1.8–2.7. This gem targets **Ruby 3.2+**,
+which those stacks never ran. Supporting Rails 3 would mean a separate legacy
+product (different gem, different Ruby), not a shim inside this engine.
+
+## Older apps (Rails 3–5): two practical paths
+
+### 1. Upgrade the host app (recommended)
+
+Bring the app to **Rails 6.1+ / Ruby 3.2+** (or Rails 7/8), then:
+
+```ruby
+gem "rails-agent-stack", "~> 0.2"
+```
+
+```bash
+bundle install
+bin/rails generate rails_agents:install
+```
+
+### 2. Sidecar modern Rails app
+
+Keep the legacy app as-is. Create a small Rails 7/8 app (same database, or
+API/DB views into the legacy data), install `rails-agent-stack` there, and expose
+agents via channels/API. The legacy app stays on its old Rails; the agent
+runtime stays modern.
+
+## Checking your version
+
+```bash
+bin/rails runner 'puts "Rails #{Rails.version} / Ruby #{RUBY_VERSION}"'
+```
+
+Need help choosing a path? Email [support@rails-agent.com](mailto:support@rails-agent.com).

data/lib/generators/rails_agents/install/templates/AGENTS.md.tt

@@ -1,4 +1,4 @@
-# AGENTS.md — <%= Rails.application.class.module_parent_name rescue "YourApp" %>
+# AGENTS.md — <%= (RailsAgents::Compat.application_name rescue "YourApp") %>
 
 Project guide for external coding agents. Platform docs: [rails-agents/docs/AGENTS.md](https://github.com/Tiny-Bubble-Company/rails-agents/blob/main/docs/AGENTS.md)
 

data/lib/generators/rails_agents/install/templates/rails_agents_autoload.rb.tt

@@ -1,10 +1,13 @@
 # frozen_string_literal: true
 
-# Prevents Zeitwerk from treating agent definitions and shared assets as normal
+# Prevent Zeitwerk from treating agent definitions and shared assets as normal
 # application namespaces. Agents load through the Rails Agent runtime.
+# Rails 6.0+ / Zeitwerk only — skipped safely on classic autoloaders.
 Rails.application.configure do
   config.before_configuration do
-    Rails.autoloaders.main.ignore(Rails.root.join("app/agents"))
-    Rails.autoloaders.main.ignore(Rails.root.join("app/agents_library"))
+    if defined?(Rails.autoloaders) && Rails.autoloaders.respond_to?(:main) && Rails.autoloaders.main
+      Rails.autoloaders.main.ignore(Rails.root.join("app/agents"))
+      Rails.autoloaders.main.ignore(Rails.root.join("app/agents_library"))
+    end
   end
 end

data/lib/rails_agents/compat.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module RailsAgents
+  # Compatibility helpers so the engine can run on Rails 6.1+ (and 7/8).
+  # Rails 3–5 are not supported: they cannot run on Ruby 3.2+, which this gem requires.
+  module Compat
+    module_function
+
+    def rails_major
+      ::Rails::VERSION::MAJOR
+    rescue StandardError
+      0
+    end
+
+    def rails_minor
+      ::Rails::VERSION::MINOR
+    rescue StandardError
+      0
+    end
+
+    def at_least?(major, minor = 0)
+      rails_major > major || (rails_major == major && rails_minor >= minor)
+    end
+
+    def zeitwerk?
+      defined?(::Rails) &&
+        ::Rails.respond_to?(:autoloaders) &&
+        ::Rails.autoloaders.respond_to?(:main) &&
+        ::Rails.autoloaders.main
+    end
+
+    def application_name
+      return "App" unless defined?(::Rails)
+
+      klass = ::Rails.application.class
+      if klass.respond_to?(:module_parent_name)
+        klass.module_parent_name
+      elsif klass.respond_to?(:parent_name)
+        klass.parent_name
+      else
+        klass.name.to_s.split("::").first
+      end
+    rescue StandardError
+      "App"
+    end
+
+    # Rails 7+ open-redirect protection requires allow_other_host: true.
+    def redirect_options
+      at_least?(7, 0) ? { allow_other_host: true } : {}
+    end
+
+    def skip_csrf!(controller_class)
+      if controller_class.respond_to?(:skip_forgery_protection)
+        controller_class.skip_forgery_protection
+      elsif controller_class.respond_to?(:skip_before_action)
+        controller_class.skip_before_action :verify_authenticity_token, raise: false
+      end
+    end
+  end
+end

data/lib/rails_agents/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsAgents
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

data/lib/rails_agents.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "rails_agents/version"
+require "rails_agents/compat"
 require "rails_agents/configuration"
 require "rails_agents/client"
 require "rails_agents/credentials_writer"

data/rails-agent-stack.gemspec

@@ -5,8 +5,8 @@ require_relative "lib/rails_agents/version"
 Gem::Specification.new do |spec|
   spec.name          = "rails-agent-stack"
   spec.version       = RailsAgents::VERSION
-  spec.authors       = ["Rails Agent Team"]
-  spec.email         = ["hello@railsagents.dev"]
+  spec.authors       = ["Tiny Bubble Company"]
+  spec.email         = ["support@rails-agent.com"]
 
   spec.summary       = "Rails AI agents framework — fullstack Ruby on Rails agents " \
                          "(ActiveAgent / RubyLLM alternative)."
@@ -39,7 +39,7 @@ Gem::Specification.new do |spec|
   spec.executables   = ["rails-agents"]
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "railties", ">= 7.0"
+  spec.add_dependency "railties", ">= 6.1"
   spec.add_dependency "thor", "~> 1.3"
   spec.add_dependency "open-wire", "~> 0.1"
 

data/spec/rails_agents/compat_spec.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+require "rails_agents/compat"
+
+RSpec.describe RailsAgents::Compat do
+  describe ".redirect_options" do
+    it "includes allow_other_host on Rails 7+" do
+      allow(described_class).to receive(:at_least?).with(7, 0).and_return(true)
+      expect(described_class.redirect_options).to eq(allow_other_host: true)
+    end
+
+    it "is empty on Rails 6.1" do
+      allow(described_class).to receive(:at_least?).with(7, 0).and_return(false)
+      expect(described_class.redirect_options).to eq({})
+    end
+  end
+
+  describe ".application_name" do
+    it "returns a string" do
+      expect(described_class.application_name).to be_a(String)
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails-agent-stack
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
-- Rails Agent Team
+- Tiny Bubble Company
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-02 00:00:00.000000000 Z
+date: 2026-08-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '6.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '6.1'
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -101,7 +101,7 @@ description: Rails Agent is the most advanced agentic platform for Ruby on Rails
   Rails agent framework and better alternative to RubyLLM and ActiveAgent for fullstack
   Rails AI agents.
 email:
-- hello@railsagents.dev
+- support@rails-agent.com
 executables:
 - rails-agents
 extensions: []
@@ -138,6 +138,8 @@ files:
 - config/routes.rb
 - docs/AGENTS.md
 - docs/PRD.md
+- docs/RAILS_SUPPORT.md
+- docs/assets/azure-bot-logo.png
 - docs/assets/hero-banner.png
 - examples/support/agent.rb
 - examples/support/channels/.keep
@@ -171,6 +173,7 @@ files:
 - lib/rails_agents/chat_agent.rb
 - lib/rails_agents/cli.rb
 - lib/rails_agents/client.rb
+- lib/rails_agents/compat.rb
 - lib/rails_agents/configuration.rb
 - lib/rails_agents/creation_agent.rb
 - lib/rails_agents/credentials_writer.rb
@@ -191,6 +194,7 @@ files:
 - spec/generators/agent_generator_spec.rb
 - spec/rails_agents/base_spec.rb
 - spec/rails_agents/client_spec.rb
+- spec/rails_agents/compat_spec.rb
 - spec/rails_agents/configuration_spec.rb
 - spec/rails_agents/library_imports_spec.rb
 - spec/rails_agents/local_sync_spec.rb