ask-rails 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2abe315f91db647a828734bbb14a557ba8feac60a35e99185f83545704e721cc
-  data.tar.gz: be8595aaa795abec9f74d8bee89e44cdfbb0da792b11e944eb7294529e7bede1
+  metadata.gz: 8c73b254e032db5c313a0eeca47499a4b30152fcf725ed410e575b0ea0a9460f
+  data.tar.gz: bfe5f9b1769e4ea4b864b7dee0c6ca3d1a6587186ccac7820a71f65999f8e0f5
 SHA512:
-  metadata.gz: ccc55bc26de71c3382af0dc38ab825e1886ddfcfaf030715bf4dc3ff5c0016fe50dcaa3eb0c0f7dd630cbfeb3f35880cc0d4a28c9f1291ab4822872aa9501336
-  data.tar.gz: 0bab3d0dab2a293485984deb1acf767c14e63cc9cc8995fab0f2a0e70e276d6e847a2573d41cd535632033f1d151dfbe6cb3118a9c0763ac5c08eacf0593bef7
+  metadata.gz: 9c02cc27c98ea141900339703160ecfad56ed70979292a654b8b1f6c7e6562f02307abc7c02a88e319cc3f8e78b66677cfa37bee8a9fc84430f07ef3b3188ba4
+  data.tar.gz: d8f235e67a77dba643184f1f81d71f40c70be04725d24e26f6a4778b41bb6cf658f7e1a73067b9ebd88bb1552e25862dce57fe21b52653cfceb7d1db066fc32a

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [0.9.0] — 2026-07-30
+
+### Fixed
+
+- **Agent generator + templates now follow the ask-agent directory convention.**
+  `rails generate ask:agent support_bot` creates `app/agents/support_bot/agent.rb`
+  + `instructions.md` + `tools/` (the discovery layout), not a flat
+  `app/agents/support_bot.rb`. Templates no longer reference the removed
+  `system_prompt`/`tool` Definition DSL — they use `model`, `provider`,
+  `max_turns`, and `tools` (plural), with instructions auto-loaded from
+  the sibling `instructions.md`.
+
 ## [0.8.0] — 2026-07-31
 
 ### Added

data/README.md

@@ -41,16 +41,28 @@ Scaffolds a new agent:
 rails generate ask:agent support_bot
 ```
 
-Creates `app/agents/support_bot.rb`:
+Creates the agent directory convention used by ask-agent discovery:
+
+```
+app/agents/support_bot/
+├── agent.rb           # class Agents::SupportBot < 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
-    system_prompt "You are a helpful assistant."
+    model "gpt-4o"
+    # tools :search_knowledge_base
   end
 end
 ```
 
+Run it with `Ask::Agent.new("support_bot")`. The directory name is the
+agent name — keep the file named `agent.rb`.
+
 ### `ask:workflow NAME`
 
 Scaffolds a new workflow (requires ask-graph):

data/lib/ask/rails/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module Rails
-    VERSION = "0.8.0"
+    VERSION = "0.9.0"
   end
 end

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

@@ -6,13 +6,17 @@
 #   agent = Ask::Agent.new("<%= file_name %>")
 #   response = agent.run("Hello")
 #
+# 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
     # model "gpt-4o"
-    system_prompt "You are a helpful assistant."
+    # provider :openai
+    # max_turns 25
 
-    # tool :bash
-    # tool :read
-    # tool :grep
+    # tools :bash
+    # tools :read
+    # tools :grep
   end
 end

data/lib/generators/ask/agent/templates/instructions.md

@@ -0,0 +1,9 @@
+# <%= class_name %>
+
+You are a helpful assistant. Describe what this agent does and how it
+should behave. This file is auto-loaded as the system prompt.
+
+## Guidelines
+
+- Be concise and direct.
+- Use the tools available to you when you need information.

data/lib/generators/ask/agent_generator.rb

@@ -7,10 +7,12 @@ module Ask
     class AgentGenerator < ::Rails::Generators::NamedBase
       source_root File.expand_path("agent/templates", __dir__)
 
-      desc "Creates an agent under app/agents — subclass ApplicationAgent with a model and system prompt"
+      desc "Creates an agent under app/agents/<name>/ — the ask-agent directory convention with agent.rb, instructions.md, and tools/"
 
       def create_agent
-        template "agent.rb", "app/agents/#{file_name}.rb"
+        template "agent.rb", "app/agents/#{file_name}/agent.rb"
+        template "instructions.md", "app/agents/#{file_name}/instructions.md"
+        empty_directory "app/agents/#{file_name}/tools"
       end
     end
   end

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

@@ -4,23 +4,20 @@
 #
 # Subclass this to define agents:
 #
-#   class Agents::SupportBot < ApplicationAgent
+#   # app/agents/support_bot/agent.rb
+#   class SupportBotAgent < ApplicationAgent
 #     model "gpt-4o"
-#     system_prompt "You help users with support questions."
-#
-#     tool :search_knowledge_base
+#     tools :search_knowledge_base
 #   end
 #
+#   # app/agents/support_bot/instructions.md — auto-loaded as the system prompt
+#   # app/agents/support_bot/tools/search_knowledge_base.rb — per-agent tools
+#
 # Then run:
 #   agent = Ask::Agent.new("support_bot")
 #   agent.run("How do I reset my password?")
 #
 class ApplicationAgent < Ask::Agent::Definition
-  # Default instructions — override in subclasses
-  system_prompt "You are a helpful assistant."
-
-  # Uncomment to add built-in tools:
-  # tool :bash
-  # tool :read
-  # tool :grep
+  # Default instructions — override by adding an instructions.md file
+  # in the agent directory, or with option :system_prompt, "..."
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-rails
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Kaka Ruto
@@ -116,6 +116,7 @@ files:
 - lib/generators/ask/action/templates/action.rb
 - lib/generators/ask/action_generator.rb
 - lib/generators/ask/agent/templates/agent.rb
+- lib/generators/ask/agent/templates/instructions.md
 - lib/generators/ask/agent_generator.rb
 - lib/generators/ask/install/templates/application_action.rb
 - lib/generators/ask/install/templates/application_agent.rb