ask-rails 0.14.0 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d91e3a8bca91cc21042906a20c68483a38ee90c2cf56fb7f5bf93904471b115
-  data.tar.gz: '09dc7e9f9321381de7152d5757111385dcaf89c66fb70c59de997dae488bc1f0'
+  metadata.gz: 59ba33037208fef8912b1943bc2da59f8a726f89d5d06b5a489128e66ab0068d
+  data.tar.gz: 2ed8a54baec5bb27c79892430643e1fd035791970c5f784e6af2b9c83c4f5b4a
 SHA512:
-  metadata.gz: 68a5ebfc02cb60e684099dab18081fdcff952e764ed10ec96af0121aab8934206a44438f7ab072a66d51ed1d788fa2b2ffe7aea958c3d65200361d245a6e401a
-  data.tar.gz: f5a34df2706d15ec288790e5861708446b974f94e6985167a9a8d292ea0a29aac6e46ce2c446ae5d305a3598e9d7ac590fc771cdf45febb67b5158e87724f3d5
+  metadata.gz: c86ae3b8971c9a7844a89945bd57f87d4cf94af230dbc05ba58163035a1ff99c75b6ae9c36bcd52b48613ee0f702d913262ca4cf90d357d09eb27c6abcca7398
+  data.tar.gz: 03bbfcdad570a35fbe36e53e8cf3f91174001f23d30d87fe98e8ee6ab01c7c409064ef019d6baf352397a4ec816e58556258859065145c9056cdfd26a18442ac

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [0.15.0] — 2026-07-30
+
+### Added
+
+- **Zeitwerk integration — agent directories are ignored by the autoloader.**
+  ask-agent discovers agents, tools, and skills via direct `require`
+  (`app/agents/<name>/agent.rb`, `shared/tools/*.rb`, ...). Their class
+  names (`SupportBot::Agent`) don't match Zeitwerk's constant mapping
+  (`SupportBot::Agent` from `app/agents/support_bot/agent.rb` would be
+  expected as `SupportBot::Agent` — ambiguous), so the railtie now tells
+  Zeitwerk to ignore every directory under `app/agents/`. Prevents
+  `NameError` at eager load in production while keeping development
+  discovery intact.
+
 ## [0.14.0] — 2026-07-30
 
 ### Notes

data/README.md

@@ -45,15 +45,15 @@ Creates the agent directory convention used by ask-agent discovery:
 
 ```
 app/agents/support_bot/
-├── agent.rb           # class Agents::SupportBot < ApplicationAgent
+├── agent.rb           # module SupportBot; class Agent < ApplicationAgent
 ├── instructions.md    # auto-loaded as the system prompt
 └── tools/             # per-agent tools (referenced with `tools :tool_name`)
 ```
 
 ```ruby
 # app/agents/support_bot/agent.rb
-module Agents
-  class SupportBot < ApplicationAgent
+module SupportBot
+  class Agent < ApplicationAgent
     model "gpt-4o"
     # tools :search_knowledge_base
   end

data/lib/ask/rails/railtie.rb

@@ -3,6 +3,20 @@
 module Ask
   module Rails
     class Railtie < ::Rails::Railtie
+      # ask-agent discovers agents, tools, and skills itself via direct
+      # `require` (app/agents/<name>/agent.rb, shared/tools/*.rb, ...).
+      # Zeitwerk must not try to autoload those directories — the class
+      # names inside (e.g. `NlOperatorAgent`) don't match the Zeitwerk
+      # constant mapping (e.g. `NlOperator::Agent`) and eager loading
+      # would raise. Keep the directories out of Zeitwerk entirely.
+      initializer "ask_rails.zeitwerk" do |app|
+        agents_path = app.root.join("app/agents")
+        next unless agents_path.directory?
+
+        Dir.glob(agents_path.join("*")).each do |entry|
+          Rails.autoloaders.main.ignore(entry) if File.directory?(entry)
+        end
+      end
     end
   end
 end

data/lib/ask/rails/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module Rails
-    VERSION = "0.14.0"
+    VERSION = "0.15.0"
   end
 end

data/lib/generators/ask/agent/templates/agent.rb

@@ -9,8 +9,8 @@
 # Instructions load automatically from instructions.md next to this file.
 # Per-agent tools live in tools/ — reference them with `tools :tool_name`.
 #
-module Agents
-  class <%= class_name %> < ApplicationAgent
+module <%= class_name %>
+  class Agent < ApplicationAgent
     # model "gpt-4o"
     # provider :openai
     # max_turns 25

data/lib/generators/ask/install/templates/application_agent.rb

@@ -5,9 +5,11 @@
 # Subclass this to define agents:
 #
 #   # app/agents/support_bot/agent.rb
-#   class SupportBotAgent < ApplicationAgent
-#     model "gpt-4o"
-#     tools :search_knowledge_base
+#   module SupportBot
+#     class Agent < ApplicationAgent
+#       model "gpt-4o"
+#       tools :search_knowledge_base
+#     end
 #   end
 #
 #   # app/agents/support_bot/instructions.md — auto-loaded as the system prompt

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-rails
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.15.0
 platform: ruby
 authors:
 - Kaka Ruto