rails-agent-stack 0.1.1

data/spec/rails_agents/library_imports_spec.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+require "tmpdir"
+require "fileutils"
+
+RSpec.describe RailsAgents::LibraryImports do
+  around do |example|
+    Dir.mktmpdir do |root|
+      @root = Pathname.new(root)
+      @agent_dir = @root.join("app/agents/support")
+      @library_dir = @root.join("app/agents_library")
+      FileUtils.mkdir_p(@agent_dir)
+      FileUtils.mkdir_p(@library_dir)
+      example.run
+    end
+  end
+
+  it "builds virtual agent files from shared Library imports" do
+    FileUtils.mkdir_p(@library_dir.join("skills"))
+    @library_dir.join("skills/triage.rb").write("module Triage; end\n")
+    @agent_dir.join("imports.yml").write(<<~YAML)
+      version: 1
+      imports:
+        - kind: skill
+          slug: triage
+          from: library/skills/triage.rb
+    YAML
+
+    files = described_class.new(@agent_dir).virtual_files
+
+    expect(files).to contain_exactly(
+      hash_including(
+        "path" => "app/agents/support/skills/triage.rb",
+        "content" => "module Triage; end\n",
+        "library_source" => "skills/triage.rb"
+      )
+    )
+  end
+
+  it "exposes imported knowledge at its agent-relative runtime path" do
+    FileUtils.mkdir_p(@library_dir.join("knowledge"))
+    @library_dir.join("knowledge/policy.md").write("# Policy\n")
+    @agent_dir.join("imports.yml").write(<<~YAML)
+      version: 1
+      imports:
+        - kind: knowledge
+          slug: policy
+          from: library/knowledge/policy.md
+          as: knowledge/company/policy.md
+    YAML
+
+    imports = described_class.new(@agent_dir)
+
+    expect(imports.knowledge_paths).to eq(["knowledge/company/policy.md"])
+    expect(imports.virtual_files.first["path"]).to eq(
+      "app/agents/support/knowledge/company/policy.md"
+    )
+  end
+
+  it "rejects paths that escape the Library" do
+    @agent_dir.join("imports.yml").write(<<~YAML)
+      version: 1
+      imports:
+        - kind: tool
+          slug: secret
+          from: library/../../config/master.key
+    YAML
+
+    expect { described_class.new(@agent_dir).entries }
+      .to raise_error(described_class::Error, /stay inside/)
+  end
+
+  it "does nothing for agents without imports" do
+    imports = described_class.new(@agent_dir)
+
+    expect(imports.entries).to eq([])
+    expect(imports.virtual_files).to eq([])
+  end
+end

data/spec/rails_agents/local_sync_spec.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+require "tmpdir"
+require "fileutils"
+
+RSpec.describe RailsAgents::LocalSync do
+  let(:root) { Dir.mktmpdir }
+  let(:client) { instance_double(RailsAgents::Client) }
+
+  after { FileUtils.remove_entry(root) }
+
+  before do
+    RailsAgents.configure do |c|
+      c.api_key = "rak_sandbox_test"
+      c.api_base = "https://cloud.rails-agent.com"
+    end
+  end
+
+  describe "#pull!" do
+    it "writes cloud files under app/agents/<slug>/" do
+      allow(client).to receive(:get_agent).with(agent: "agt_1").and_return(
+        {
+          "data" => {
+            "id" => "agt_1",
+            "name" => "Support",
+            "slug" => "support"
+          }
+        }
+      )
+      allow(client).to receive(:list_files).with(agent: "agt_1").and_return(
+        {
+          "data" => [
+            { "path" => "agent.rb", "content" => "class Support < RailsAgents::Base; end\n" },
+            { "path" => "instructions.md", "content" => "# Support\n" },
+            { "path" => "tools/lookup.rb", "content" => "# tool\n" }
+          ]
+        }
+      )
+
+      result = described_class.new(client: client, root: root).pull!("agt_1")
+
+      expect(result["ok"]).to eq(true)
+      expect(result["slug"]).to eq("support")
+      expect(result["count"]).to eq(3)
+      expect(File.read(File.join(root, "app/agents/support/agent.rb"))).to include("RailsAgents::Base")
+      expect(File.read(File.join(root, "app/agents/support/tools/lookup.rb"))).to include("tool")
+    end
+
+    it "rejects path traversal" do
+      allow(client).to receive(:get_agent).and_return(
+        { "data" => { "id" => "agt_1", "slug" => "support" } }
+      )
+      allow(client).to receive(:list_files).and_return(
+        { "data" => [{ "path" => "../secrets.env", "content" => "nope" }] }
+      )
+
+      expect {
+        described_class.new(client: client, root: root).pull!("agt_1")
+      }.to raise_error(RailsAgents::LocalSync::Error, /Invalid path/)
+    end
+  end
+end

data/spec/rails_agents/taxonomy_spec.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+require "pathname"
+
+RSpec.describe "RailsAgents taxonomy" do
+  let(:client) { instance_double(RailsAgents::Client) }
+
+  before do
+    allow(client).to receive(:create_run).and_return({ "id" => "run_1" })
+  end
+
+  {
+    RailsAgents::KnowledgeAgent => :knowledge,
+    RailsAgents::CreationAgent => :creation,
+    RailsAgents::WorkflowAgent => :workflow,
+    RailsAgents::OperationsAgent => :operations,
+    RailsAgents::MonitoringAgent => :monitoring
+  }.each do |klass, kind|
+    it "#{klass.name} reports agent_kind #{kind}" do
+      expect(klass.agent_kind).to eq(kind)
+    end
+
+    it "#{klass.name} sends kind in run metadata" do
+      agent = Class.new(klass) do
+        model :gpt_5_mini, provider: :openai, credential: :company_openai
+      end
+      agent.instance_variable_set(:@agent_directory, Pathname.new("/tmp/agents/demo"))
+
+      agent.new(client: client).run("ping")
+
+      expect(client).to have_received(:create_run).with(
+        hash_including(metadata: hash_including(kind: kind))
+      )
+    end
+  end
+
+  it "ChatAgent is deprecated alias of Knowledge" do
+    expect(RailsAgents::ChatAgent.agent_kind).to eq(:knowledge)
+    expect(RailsAgents::ChatAgent).to be < RailsAgents::KnowledgeAgent
+  end
+
+  it "BackgroundAgent is deprecated alias of Operations" do
+    expect(RailsAgents::BackgroundAgent.agent_kind).to eq(:operations)
+    expect(RailsAgents::BackgroundAgent).to be < RailsAgents::OperationsAgent
+  end
+
+  it "defines TAXONOMY_TYPES constant" do
+    expect(RailsAgents::TAXONOMY_TYPES).to eq(%i[knowledge workflow operations monitoring])
+    expect(RailsAgents::LEGACY_TAXONOMY_TYPES).to eq(%i[creation])
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "webmock/rspec"
+
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+
+require "rails_agents"
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+  config.filter_run_when_matching :focus
+  config.disable_monkey_patching!
+  config.order = :random
+
+  config.before do
+    RailsAgents.reset!
+    WebMock.reset!
+  end
+end

metadata

@@ -0,0 +1,229 @@
+--- !ruby/object:Gem::Specification
+name: rails-agent-stack
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Rails Agent Team
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-08-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: open-wire
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.23'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.23'
+description: Rails Agent is the most advanced agentic platform for Ruby on Rails.
+  Mount /agents, scaffold agent directories, attach BYOK model credentials, and build
+  with instructions, tools, connectors, channels, skills, packages, knowledge, memory,
+  and guardrails. Sync, run, deploy, and monitor on Rails Agent Cloud — a production
+  Rails agent framework and better alternative to RubyLLM and ActiveAgent for fullstack
+  Rails AI agents.
+email:
+- hello@railsagents.dev
+executables:
+- rails-agents
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/README.md"
+- ".github/workflows/ci.yml"
+- ".gitignore"
+- ".rspec"
+- AGENTS.md
+- CHANGELOG.md
+- Gemfile
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/images/rails_agents/kip-logo.png
+- app/assets/images/rails_agents/kip-waving.png
+- app/assets/stylesheets/rails_agents/application.css
+- app/controllers/rails_agents/application_controller.rb
+- app/controllers/rails_agents/connect_controller.rb
+- app/controllers/rails_agents/dashboard_controller.rb
+- app/controllers/rails_agents/handshake_controller.rb
+- app/controllers/rails_agents/open_wire_inbound_controller.rb
+- app/controllers/rails_agents/pulls_controller.rb
+- app/controllers/rails_agents/registrations_controller.rb
+- app/controllers/rails_agents/schema_controller.rb
+- app/controllers/rails_agents/sessions_controller.rb
+- app/controllers/rails_agents/tool_bridge_controller.rb
+- app/views/layouts/rails_agents/application.html.erb
+- app/views/rails_agents/dashboard/show.html.erb
+- app/views/rails_agents/registrations/new.html.erb
+- app/views/rails_agents/sessions/new.html.erb
+- app/views/rails_agents/shared/_auth_brand.html.erb
+- config/routes.rb
+- docs/AGENTS.md
+- docs/PRD.md
+- docs/assets/hero-banner.png
+- examples/support/agent.rb
+- examples/support/channels/.keep
+- examples/support/evals/smoke.yml
+- examples/support/knowledge/shipping.md
+- examples/support/memory.rb
+- examples/support/prompt.md
+- examples/support/skills/.keep
+- examples/support/tools/.keep
+- exe/rails-agents
+- lib/generators/rails_agents/agent/agent_generator.rb
+- lib/generators/rails_agents/agent/templates/agent.rb.tt
+- lib/generators/rails_agents/agent/templates/agent_database.rb.tt
+- lib/generators/rails_agents/agent/templates/channels/slack.rb.tt
+- lib/generators/rails_agents/agent/templates/evals/smoke.yml.tt
+- lib/generators/rails_agents/agent/templates/imports.yml.tt
+- lib/generators/rails_agents/agent/templates/memory.rb.tt
+- lib/generators/rails_agents/agent/templates/prompt.md.tt
+- lib/generators/rails_agents/agent/templates/prompt_database.md.tt
+- lib/generators/rails_agents/install/INSTALL
+- lib/generators/rails_agents/install/install_generator.rb
+- lib/generators/rails_agents/install/templates/AGENTS.md.tt
+- lib/generators/rails_agents/install/templates/initializer.rb.tt
+- lib/generators/rails_agents/install/templates/library_README.md.tt
+- lib/generators/rails_agents/install/templates/library_manifest.yml.tt
+- lib/generators/rails_agents/install/templates/rails_agents_autoload.rb.tt
+- lib/rails-agent-stack.rb
+- lib/rails_agents.rb
+- lib/rails_agents/background_agent.rb
+- lib/rails_agents/base.rb
+- lib/rails_agents/chat_agent.rb
+- lib/rails_agents/cli.rb
+- lib/rails_agents/client.rb
+- lib/rails_agents/configuration.rb
+- lib/rails_agents/creation_agent.rb
+- lib/rails_agents/credentials_writer.rb
+- lib/rails_agents/engine.rb
+- lib/rails_agents/knowledge_agent.rb
+- lib/rails_agents/library_imports.rb
+- lib/rails_agents/local_auth.rb
+- lib/rails_agents/local_sync.rb
+- lib/rails_agents/monitoring_agent.rb
+- lib/rails_agents/open_wire_adapter.rb
+- lib/rails_agents/operations_agent.rb
+- lib/rails_agents/railtie.rb
+- lib/rails_agents/tasks.rake
+- lib/rails_agents/version.rb
+- lib/rails_agents/workflow_agent.rb
+- rails-agent-stack.gemspec
+- rails-agents.code-workspace
+- spec/generators/agent_generator_spec.rb
+- spec/rails_agents/base_spec.rb
+- spec/rails_agents/client_spec.rb
+- spec/rails_agents/configuration_spec.rb
+- spec/rails_agents/library_imports_spec.rb
+- spec/rails_agents/local_sync_spec.rb
+- spec/rails_agents/taxonomy_spec.rb
+- spec/spec_helper.rb
+homepage: https://rails-agent.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://rails-agent.com
+  documentation_uri: https://rails-agent.com/docs/getting-started
+  source_code_uri: https://github.com/Tiny-Bubble-Company/rails-agents
+  bug_tracker_uri: https://github.com/Tiny-Bubble-Company/rails-agents/issues
+  changelog_uri: https://github.com/Tiny-Bubble-Company/rails-agents/releases
+  rubygems_mimetype: application/x-rubygem
+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: '0'
+requirements: []
+rubygems_version: 3.4.1
+signing_key:
+specification_version: 4
+summary: Rails AI agents framework — fullstack Ruby on Rails agents (ActiveAgent /
+  RubyLLM alternative).
+test_files: []