rcrewai-rails 0.5.1 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3002ce8deaeb0a940a8d3636d3e88e7c3209a7198682f8210b2f93e46998c2c6
-  data.tar.gz: b37ea3a73e1d4a9d040293cf017d2790fd200745971c487a23c353cf1269c513
+  metadata.gz: 42ec86061d4e3a880fa4c985abc0f2ec55e6c7868b95c65d62f7d6de27324042
+  data.tar.gz: f73a244bd91a867dd450f94d5fe82ab02e968f62e0a82e311a8e9e736be99e46
 SHA512:
-  metadata.gz: e085f8cb656d8ff666a5796801268371ffcbbf9c80348b42ce82586e4d43cd91c419e1d32eae570eee3b75e757030a94732a584b88ccd2e51cef136c4f5f4933
-  data.tar.gz: 16fdc1b89c8955bdf57e74e43354965c0ca820ee8b18f254bdf1580e20db4d5fdc5efcaa08d468ed129fb06c777c94c5a4071f883200cfaa47481a5688a1173c
+  metadata.gz: 366cdfeb973451b6144514e72bcfe07e3dc3269e0d9bf093f9c73949f2f660ce6f3b8f136cf3fb1af7e27f08b5210da4c785b0f3e6ac5a9827379f764733f151
+  data.tar.gz: b91f369cbdd7141f83e36a407742cc31af9ecff0a3563668ec50b91dd6689c82f2bd2cd40c3db6753ef693bd535e90782cf51cfa4afc2a074a2012683d20ed74

data/CHANGELOG.md

@@ -7,6 +7,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.1] - 2026-07-07
+
+### Fixed
+- Refresh the README for rcrewai 0.7: corrected the install-generator namespace
+  (`rcrewai:rails:install`) and removed a broken crew-level `memory_enabled`
+  example (that DSL method no longer exists — memory is agent-level). Added a
+  "rcrewai 0.7 capabilities" section documenting the new agent/task/crew/
+  knowledge/flow configuration. Docs only.
+
+## [0.6.0] - 2026-07-07
+
+Tracks rcrewai 0.7.0: adds the `:consensual` crew process and agent-level
+cognitive memory configuration, and requires `rcrewai ~> 0.7`. Includes a
+schema cleanup that removes unused columns (see Removed + the `009` migration).
+
+### Added
+- Support the rcrewai 0.7.0 `:consensual` crew process: `process_type:
+  "consensual"` is now valid, a nullable `consensus_agents` column is forwarded to
+  the core crew (defaulting to the core's 3 when unset), and the web UI + API
+  permit it. Existing sequential/hierarchical crews are unaffected.
+- Agent memory configuration: enable rcrewai 0.6+ cognitive memory per agent via
+  the existing `memory_enabled` flag, with `memory_scope` /
+  `memory_short_term_limit` columns forwarded to the core agent. The embedder and
+  store come from `RcrewAI::Rails.config.default_memory_embedder` /
+  `default_memory_store` (set in a host initializer). Memory is off by default, so
+  existing agents are unaffected.
+
+### Changed
+- Require `rcrewai ~> 0.7` (was `~> 0.5`).
+
+### Removed
+- Dropped the unused `memory_enabled` and `memory` columns from `rcrewai_crews`.
+  Core memory is agent-level; these crew columns were never wired to anything.
+  **Migration note:** the `009` migration removes them (reversible).
+
 ## [0.5.1] - 2026-07-06
 
 ### Fixed
@@ -88,7 +123,9 @@ existing agents, tasks, and crews build unchanged.
 ### Changed
 - Rename generators from `rcrew_a_i` to `rcrewai` namespacing.
 
-[Unreleased]: https://github.com/gkosmo/rcrewai-rails/compare/v0.5.1...HEAD
+[Unreleased]: https://github.com/gkosmo/rcrewai-rails/compare/v0.6.1...HEAD
+[0.6.1]: https://github.com/gkosmo/rcrewai-rails/compare/v0.6.0...v0.6.1
+[0.6.0]: https://github.com/gkosmo/rcrewai-rails/compare/v0.5.1...v0.6.0
 [0.5.1]: https://github.com/gkosmo/rcrewai-rails/compare/v0.5.0...v0.5.1
 [0.5.0]: https://github.com/gkosmo/rcrewai-rails/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/gkosmo/rcrewai-rails/compare/v0.3.1...v0.4.0

data/README.md

@@ -10,6 +10,11 @@ Rails engine for integrating [RcrewAI](https://github.com/gkosmo/rcrewai-rails)
 - **Web UI**: Monitor and manage crews through a built-in interface
 - **Rails-Specific Tools**: Pre-built tools for ActiveRecord, ActionMailer, Rails cache, and more
 - **Configuration**: Flexible configuration through Rails initializers
+- **Full rcrewai 0.7 feature coverage** (see [rcrewai 0.7 capabilities](#rcrewai-07-capabilities)):
+  - Agent config: reasoning, per-agent LLM, rate limiting, context-window trimming, cognitive memory
+  - Task output: structured output schemas, guardrails, file output, multimodal attachments
+  - Crew: `before_kickoff`/`after_kickoff` hooks, planning, the `consensual` process, batch execution
+  - Knowledge (RAG) sources and Flow persistence
 
 ## Installation
 
@@ -28,7 +33,7 @@ $ bundle install
 Run the installation generator:
 
 ```bash
-$ rails generate rcrew_a_i:rails:install
+$ rails generate rcrewai:rails:install
 $ rails db:migrate
 ```
 
@@ -103,8 +108,7 @@ class ResearchCrew
   
   crew_name "research_team"
   crew_description "AI-powered research team"
-  process_type :sequential
-  memory_enabled true
+  process_type :sequential # :sequential, :hierarchical, or :consensual
   
   def setup_agents
     @researcher = create_agent("researcher",
@@ -187,6 +191,101 @@ crew.execute_sync(inputs)
 CrewExecutionJob.set(wait: 5.minutes).perform_later(crew, inputs)
 ```
 
+## rcrewai 0.7 capabilities
+
+This engine tracks [rcrewai](https://github.com/gkosmo/rcrewAI) `~> 0.7`. The
+following capabilities are configured through columns on the persisted models and
+forwarded to the core objects at build time. All are **off/absent by default**, so
+existing records are unaffected — set only what you need.
+
+### Agent configuration (`RcrewAI::Rails::Agent`)
+
+| Column | Effect |
+|---|---|
+| `max_rpm` | Rate-limit the agent's LLM calls (requests per minute) |
+| `reasoning` / `max_reasoning_attempts` | Run a planning/reasoning pass before answering |
+| `respect_context_window` | Trim history to fit the model's context window |
+| `llm_config` (JSON) | Per-agent LLM override, e.g. `{ "provider": "anthropic", "model": "claude-sonnet-5" }` |
+| `memory_enabled` + `memory_scope` + `memory_short_term_limit` | Enable cognitive memory (see below) |
+
+```ruby
+agent = crew.agents.create!(
+  name: "researcher", role: "Researcher", goal: "Find facts",
+  reasoning: true,
+  max_rpm: 30,
+  llm_config: { provider: "anthropic", model: "claude-sonnet-5" },
+  memory_enabled: true, memory_scope: "research", memory_short_term_limit: 20
+)
+```
+
+**Agent memory** (rcrewai 0.6+): set `memory_enabled: true` to turn on cognitive
+memory. `memory_scope` isolates an agent's memories; `memory_short_term_limit`
+caps recent-execution recall. The embedder and store are objects, so configure
+them once in the initializer:
+
+```ruby
+RcrewAI::Rails.configure do |config|
+  config.default_memory_embedder = RCrewAI::Knowledge::Embedder.new
+  config.default_memory_store     = RCrewAI::Memory::SqliteStore.new(path: "db/rcrewai_memory.sqlite3")
+end
+```
+
+### Task output processing (`RcrewAI::Rails::Task`)
+
+| Column | Effect |
+|---|---|
+| `output_schema` (JSON) | Validate/coerce the result against a JSON schema (structured output) |
+| `guardrail_class` + `guardrail_method_name` + `guardrail_max_retries` | Validate/transform output, retrying on failure |
+| `output_file` + `create_directory` + `markdown` | Write the result to disk |
+| `attachments` (JSON) | Multimodal image inputs, e.g. `[{ "type": "image", "url": "https://…" }]` |
+
+A guardrail is resolved from a host class: `guardrail_class` names a class whose
+`guardrail_method_name` accepts the output and returns `[ok, value_or_error]`.
+
+### Crew orchestration (`RcrewAI::Rails::Crew`)
+
+| Column | Effect |
+|---|---|
+| `process_type` | `"sequential"`, `"hierarchical"`, or `"consensual"` |
+| `consensus_agents` | Number of proposers for the `consensual` process (default 3) |
+| `planning` / `planning_llm` | Run a planner pass before execution |
+| `before_kickoff_class`/`_method`, `after_kickoff_class`/`_method` | Lifecycle hooks resolved from host classes |
+
+**Batch execution** (rcrewai `kickoff_for_each` parity) runs the crew once per
+input set, one `Execution` per input grouped by a shared `batch_id`:
+
+```ruby
+result = crew.execute_batch_sync([{ topic: "a" }, { topic: "b" }])
+crew.batch_executions(result[:batch_id]) # the runs, in order
+crew.execute_batch_async(inputs_list)     # enqueue N jobs, returns the batch_id
+```
+
+### Knowledge (RAG)
+
+Attach sources to an agent (role-specific) or a crew (shared with all its agents):
+
+```ruby
+agent.knowledge_sources.create!(source_type: "url",    value: "https://example.com/doc")
+crew.knowledge_sources.create!(source_type: "string", value: "Reference text…")
+# source_type: "string" | "file" | "pdf" | "csv" | "url"
+```
+
+Active sources are embedded lazily at execution. See the memory initializer above
+for embedder configuration.
+
+### Flows
+
+Define Flow subclasses in your app (Ruby); the engine persists their state and
+runs. Pass `RcrewAI::Rails::ActiveRecordStateStore` so flows resume from the DB,
+and use `FlowRun.execute` to track a kickoff:
+
+```ruby
+run = RcrewAI::Rails::FlowRun.execute(MyFlow, inputs: { topic: "ruby" })
+run.status     # "completed" / "failed"
+run.result     # the final flow state
+RcrewAI::Rails::FlowState.find_by(state_id: run.state_id) # the persisted state
+```
+
 ## Database Models
 
 The gem provides these ActiveRecord models:
@@ -196,6 +295,9 @@ The gem provides these ActiveRecord models:
 - `RcrewAI::Rails::Task` - Task definitions
 - `RcrewAI::Rails::Execution` - Execution history
 - `RcrewAI::Rails::ExecutionLog` - Detailed execution logs
+- `RcrewAI::Rails::KnowledgeSource` - Knowledge (RAG) sources, owned by an agent or a crew
+- `RcrewAI::Rails::FlowState` - Persisted rcrewai Flow state (resume flows across restarts)
+- `RcrewAI::Rails::FlowRun` - Flow-run tracking (status, inputs, result, timing)
 
 ## API Endpoints
 

data/app/controllers/rcrewai/rails/api/v1/crews_controller.rb

@@ -45,7 +45,7 @@ module RcrewAI
           def crew_params
             params.require(:crew).permit(
               :name, :description, :process_type, :verbose,
-              :memory_enabled, :cache_enabled, :max_rpm, :manager_llm, :active
+              :cache_enabled, :max_rpm, :manager_llm, :consensus_agents, :active
             )
           end
         end

data/app/controllers/rcrewai/rails/crews_controller.rb

@@ -59,7 +59,7 @@ module RcrewAI
       def crew_params
         params.require(:crew).permit(
           :name, :description, :process_type, :verbose,
-          :memory_enabled, :cache_enabled, :max_rpm, :manager_llm, :active
+          :cache_enabled, :max_rpm, :manager_llm, :consensus_agents, :active
         )
       end
     end

data/app/models/rcrewai/rails/agent.rb

@@ -41,9 +41,24 @@ module RcrewAI
         opts[:llm] = llm_config.symbolize_keys if llm_config.present?
         sources = rcrew_knowledge_sources
         opts[:knowledge_sources] = sources if sources.any?
+        opts[:memory] = memory_options if memory_enabled
         opts
       end
 
+      # Agent memory config (rcrewai 0.6+). Scalars come from columns; embedder
+      # and store come from the engine configuration (set in a host initializer).
+      # May return {} — an empty hash still enables memory with core defaults.
+      def memory_options
+        m = {}
+        m[:scope] = memory_scope if memory_scope.present?
+        m[:short_term_limit] = memory_short_term_limit if memory_short_term_limit.present?
+        embedder = RcrewAI::Rails.config.default_memory_embedder
+        store = RcrewAI::Rails.config.default_memory_store
+        m[:embedder] = embedder if embedder
+        m[:store] = store if store
+        m
+      end
+
       def rcrew_knowledge_sources
         knowledge_sources.active.map(&:to_rcrew_source)
       end

data/app/models/rcrewai/rails/crew.rb

@@ -9,10 +9,9 @@ module RcrewAI
       has_many :knowledge_sources, as: :owner, class_name: "RcrewAI::Rails::KnowledgeSource", dependent: :destroy
 
       validates :name, presence: true
-      validates :process_type, inclusion: { in: %w[sequential hierarchical] }
+      validates :process_type, inclusion: { in: %w[sequential hierarchical consensual] }
 
       serialize :config, coder: JSON
-      serialize :memory, coder: JSON
 
       scope :active, -> { where(active: true) }
       scope :with_agents, -> { includes(:agents) }
@@ -37,14 +36,16 @@ module RcrewAI
         crew
       end
 
-      # rcrewai 0.5.0 planning options. Emit a key only when meaningfully set, so
-      # an all-default crew constructs exactly as it did before.
+      # Crew construction options (planning, consensus_agents, knowledge). Emit a
+      # key only when meaningfully set, so an all-default crew constructs exactly
+      # as it did before.
       def crew_planning_options
         opts = {}
         opts[:planning] = planning if planning
         opts[:planning_llm] = planning_llm.to_sym if planning_llm.present?
         sources = rcrew_knowledge_sources
         opts[:knowledge_sources] = sources if sources.any?
+        opts[:consensus_agents] = consensus_agents if consensus_agents.present?
         opts
       end
 

data/app/views/rcrewai/rails/crews/edit.html.erb

@@ -34,7 +34,8 @@
       <%= form.select :process_type, 
           options_for_select([
             ['Sequential', 'sequential'],
-            ['Hierarchical', 'hierarchical']
+            ['Hierarchical', 'hierarchical'],
+            ['Consensual', 'consensual']
           ], @crew.process_type), 
           { prompt: 'Select process type' }, 
           { class: "form-select" } %>
@@ -46,12 +47,6 @@
       <span class="form-help">Enable verbose logging</span>
     </div>
 
-    <div class="form-group">
-      <%= form.label :memory_enabled, class: "form-label" %>
-      <%= form.check_box :memory_enabled, class: "form-checkbox" %>
-      <span class="form-help">Enable memory for agents</span>
-    </div>
-
     <div class="form-group">
       <%= form.label :cache_enabled, class: "form-label" %>
       <%= form.check_box :cache_enabled, class: "form-checkbox" %>

data/app/views/rcrewai/rails/crews/new.html.erb

@@ -31,7 +31,8 @@
       <%= form.select :process_type, 
           options_for_select([
             ['Sequential', 'sequential'],
-            ['Hierarchical', 'hierarchical']
+            ['Hierarchical', 'hierarchical'],
+            ['Consensual', 'consensual']
           ], @crew.process_type), 
           { prompt: 'Select process type' }, 
           { class: "form-select" } %>
@@ -43,12 +44,6 @@
       <span class="form-help">Enable verbose logging</span>
     </div>
 
-    <div class="form-group">
-      <%= form.label :memory_enabled, class: "form-label" %>
-      <%= form.check_box :memory_enabled, class: "form-checkbox" %>
-      <span class="form-help">Enable memory for agents</span>
-    </div>
-
     <div class="form-group">
       <%= form.label :cache_enabled, class: "form-label" %>
       <%= form.check_box :cache_enabled, class: "form-checkbox" %>

data/app/views/rcrewai/rails/crews/show.html.erb

@@ -14,9 +14,6 @@
     <div class="meta-item">
       <strong>Process Type:</strong> <%= @crew.process_type %>
     </div>
-    <div class="meta-item">
-      <strong>Memory:</strong> <%= @crew.memory_enabled ? "Enabled" : "Disabled" %>
-    </div>
     <div class="meta-item">
       <strong>Cache:</strong> <%= @crew.cache_enabled ? "Enabled" : "Disabled" %>
     </div>

data/db/migrate/008_add_consensus_agents_to_rcrewai_crews.rb

@@ -0,0 +1,5 @@
+class AddConsensusAgentsToRcrewaiCrews < ActiveRecord::Migration[7.0]
+  def change
+    add_column :rcrewai_crews, :consensus_agents, :integer
+  end
+end

data/db/migrate/009_add_memory_config_to_agents_and_clean_crews.rb

@@ -0,0 +1,10 @@
+class AddMemoryConfigToAgentsAndCleanCrews < ActiveRecord::Migration[7.0]
+  def change
+    add_column :rcrewai_agents, :memory_scope, :string
+    add_column :rcrewai_agents, :memory_short_term_limit, :integer
+
+    # Core memory is agent-level; these crew columns were never used.
+    remove_column :rcrewai_crews, :memory_enabled, :boolean, default: false
+    remove_column :rcrewai_crews, :memory, :text
+  end
+end

data/lib/generators/rcrewai/rails/crew/templates/crew.rb.erb

@@ -7,7 +7,6 @@ class <%= class_name %>Crew
       description: "<%= crew_description %>",
       process_type: "<%= process_type %>",
       verbose: true,
-      memory_enabled: false,
       cache_enabled: true
     )
 

data/lib/generators/rcrewai/rails/install/templates/create_rcrewai_tables.rb

@@ -5,10 +5,10 @@ class CreateRcrewaiTables < ActiveRecord::Migration[7.0]
       t.text :description
       t.string :process_type, default: "sequential"
       t.boolean :verbose, default: false
-      t.boolean :memory_enabled, default: false
       t.boolean :cache_enabled, default: false
       t.integer :max_rpm
       t.string :manager_llm
+      t.integer :consensus_agents
       t.boolean :planning, default: false, null: false
       t.string :planning_llm
       t.string :before_kickoff_class
@@ -16,7 +16,6 @@ class CreateRcrewaiTables < ActiveRecord::Migration[7.0]
       t.string :after_kickoff_class
       t.string :after_kickoff_method
       t.text :config
-      t.text :memory
       t.boolean :active, default: true
 
       t.timestamps
@@ -32,6 +31,8 @@ class CreateRcrewaiTables < ActiveRecord::Migration[7.0]
       t.text :goal
       t.text :backstory
       t.boolean :memory_enabled, default: false
+      t.string :memory_scope
+      t.integer :memory_short_term_limit
       t.boolean :verbose, default: false
       t.boolean :allow_delegation, default: false
       t.text :tools

data/lib/rcrewai/rails/configuration.rb

@@ -3,7 +3,8 @@ module RcrewAI
     class Configuration
       attr_accessor :job_queue_name, :enable_web_ui, :persistence_backend,
                     :default_llm_provider, :default_llm_model, :max_retries,
-                    :timeout, :enable_logging, :log_level, :async_execution
+                    :timeout, :enable_logging, :log_level, :async_execution,
+                    :default_memory_embedder, :default_memory_store
 
       def initialize
         @job_queue_name = "default"
@@ -16,6 +17,8 @@ module RcrewAI
         @enable_logging = true
         @log_level = :info
         @async_execution = true # Use ActiveJob for async by default
+        @default_memory_embedder = nil
+        @default_memory_store = nil
       end
     end
   end

data/lib/rcrewai/rails/crew_builder.rb

@@ -26,11 +26,6 @@ module RcrewAI
           @process_type || :sequential
         end
 
-        def memory_enabled(enabled = nil)
-          @memory_enabled = enabled unless enabled.nil?
-          @memory_enabled || false
-        end
-
         def cache_enabled(enabled = nil)
           @cache_enabled = enabled unless enabled.nil?
           @cache_enabled || true
@@ -66,7 +61,6 @@ module RcrewAI
         RcrewAI::Rails::Crew.find_or_create_by(name: self.class.crew_name) do |crew|
           crew.description = self.class.crew_description
           crew.process_type = self.class.process_type.to_s
-          crew.memory_enabled = self.class.memory_enabled
           crew.cache_enabled = self.class.cache_enabled
           crew.verbose = verbose?
         end

data/lib/rcrewai/rails/version.rb

@@ -1,6 +1,6 @@
 module RcrewAI
   module Rails
-    VERSION = "0.5.1"
+    VERSION = "0.6.1"
     Version = VERSION
   end
 end

data/rcrewai-rails.gemspec

@@ -45,7 +45,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   # Core dependency
-  spec.add_dependency "rcrewai", "~> 0.5"
+  spec.add_dependency "rcrewai", "~> 0.7"
   
   # Rails dependencies
   spec.add_dependency "rails", ">= 7.0.0"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rcrewai-rails
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.6.1
 platform: ruby
 authors:
 - gkosmo
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0.7'
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
@@ -249,6 +249,8 @@ files:
 - db/migrate/005_add_batch_id_to_rcrewai_executions.rb
 - db/migrate/006_create_rcrewai_knowledge_sources.rb
 - db/migrate/007_create_rcrewai_flows.rb
+- db/migrate/008_add_consensus_agents_to_rcrewai_crews.rb
+- db/migrate/009_add_memory_config_to_agents_and_clean_crews.rb
 - docs/index.html
 - lib/generators/rcrewai/rails/crew/crew_generator.rb
 - lib/generators/rcrewai/rails/crew/templates/agent.rb.erb