rcrewai-rails 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7987750789244c90f421923541a2132e3aab1f6891f6b706ed42544ea4ae2507
-  data.tar.gz: 99fe0af08b0ad8f1a4c5bccf93edd2285e32f5966f6c3d93c2f152c239074ffe
+  metadata.gz: 8a95b32182721ebdcaa575a0c4d06851286bd3ba79c1028d958a49c0e8eda054
+  data.tar.gz: 3f00b82481064604f975679bd358cb6fa0e7c8f97fe4378ae7ab44be277ffdbf
 SHA512:
-  metadata.gz: edafeb7cbf6461861bee821981911a5262d0dff09ec034cbb4cb2de123fe5a31a135e25685b7ba756931c665a908cf41e369b474aa33bb7a4beab7b99fcc17a3
-  data.tar.gz: f2edb449ac6b178e62392e809b677c103456e1ec6141e35b3dcac52b15c3254c5af0abe7e3165ba2b5f95137b87fcbcae1cf9dfc2cb0082afe3da795af470c3b
+  metadata.gz: d1090695f7c42d14caf966231f919c64ec0b2077cbc53d3192fd06823a8742f05e74fafc7d904fcc8ff4308888d3231aff9877fcedf5d5deb344849c905958db
+  data.tar.gz: 4573e67c5c9b925917d0a8a44ad38da4f6572a9580adb9da0122939118f94e9fe2b7e50be115165d01205154e7a6481d2a9bce7cf39ee8cdf00ecb6bfdf2348e

data/CHANGELOG.md

@@ -7,6 +7,75 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.0] - 2026-09-10
+
+Tracks **rcrewai 0.9.0**, whose theme is concurrency: a turn's tool calls,
+consensus proposals/scoring, and embeddings now fan out across threads. The
+0.8.1 suite passed against it unchanged, so this release is about verifying the
+engine under concurrency and exposing the new opt-out.
+
+### Added
+- `rcrewai_agents.parallel_tools` — forwards `parallel_tools:` to
+  `RCrewAI::Agent`. rcrewai 0.9 runs a turn's tool calls concurrently by
+  default; set this to `false` on an agent whose tools are not safe to run in
+  parallel (or that must not fan out against a rate-limited API). Nullable, and
+  only forwarded when explicitly set, so existing agents keep the gem's default.
+
+### Verified
+- **Span attribution holds under concurrent tool calls.** rcrewai 0.9 emits tool
+  events from worker threads, carrying the run span across the boundary
+  (`Events.with_parent` is thread-local). Confirmed against the real gem that
+  concurrent tool events arrive with the correct `parent_id` and none nil, and
+  added collector specs covering interleaved starts/results matched by
+  `call_id`, a failing tool not affecting its sibling, and delivery from eight
+  threads at once.
+
+### Changed
+- Requires `rcrewai ~> 0.9.0`.
+
+### Upgrading
+Existing installs need the new migration:
+
+```bash
+$ rails rcrew_ai_rails:install:migrations
+$ rails db:migrate
+```
+
+This adds one nullable column, `rcrewai_agents.parallel_tools`. Nothing changes
+until you set it.
+
+## [0.8.1] - 2026-09-10
+
+### Fixed
+- **Enabling checkpointing without running the 0.8 migration failed mid-run.**
+  `CrewExecutionJob` built the default `ActiveRecordCheckpointStore` without
+  checking that its table existed, so the run raised
+  `ActiveRecord::StatementInvalid: Could not find table 'rcrewai_checkpoints'`
+  partway through — after tasks had already executed and been paid for, and
+  with nothing in the message naming the cause. The job now fails up front with
+  `CheckpointTableMissing`, whose message names the migration command to run.
+  It is `discard_on`'d rather than retried, since retrying cannot fix a missing
+  table. Configuring a custom `checkpoint_store` skips the check, and nothing
+  changes when checkpointing is off (the default).
+- **The test suite was order-dependent.** `real_migrate_spec` and
+  `upgrade_migrate_spec` called `ActiveRecord::Base.establish_connection` to get
+  a scratch database for migrating. The test database is sqlite3 `":memory:"`,
+  so that discarded the pool holding Combustion's schema, and reconnecting gave
+  an empty database — every later example lost its tables. The suite passed only
+  because those specs happened to run last: under `--order random` it failed
+  ~128 of 258 examples. Migrations now run against an isolated connection via
+  `ActiveRecord::Tasks::DatabaseTasks.migration_class`, leaving the suite's own
+  connection untouched.
+- **`rails_logger_tool_spec` leaked a fake `Rails.logger`** into every example
+  that ran after it. The fake accepts exactly one argument, so unrelated specs
+  logging through the real logger raised `ArgumentError: wrong number of
+  arguments`. It is now restored after each example.
+
+### Changed
+- Specs run in random order by default (`config.order = :random`), so an example
+  that leaks global state fails immediately instead of silently depending on
+  file order. Seeds are reproducible: `bundle exec rspec --seed 1234`.
+
 ## [0.8.0] - 2026-09-10
 
 Tracks **rcrewai 0.8.0**, which is backward compatible for this engine — the
@@ -242,7 +311,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.8.0...HEAD
+[Unreleased]: https://github.com/gkosmo/rcrewai-rails/compare/v0.9.0...HEAD
+[0.9.0]: https://github.com/gkosmo/rcrewai-rails/compare/v0.8.1...v0.9.0
+[0.8.1]: https://github.com/gkosmo/rcrewai-rails/compare/v0.8.0...v0.8.1
 [0.8.0]: https://github.com/gkosmo/rcrewai-rails/compare/v0.7.1...v0.8.0
 [0.7.1]: https://github.com/gkosmo/rcrewai-rails/compare/v0.7.0...v0.7.1
 [0.7.0]: https://github.com/gkosmo/rcrewai-rails/compare/v0.6.1...v0.7.0

data/README.md

@@ -10,12 +10,13 @@ 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.8 feature coverage** (see [rcrewai 0.8 capabilities](#rcrewai-08-capabilities) and [rcrewai 0.7 capabilities](#rcrewai-07-capabilities)):
+- **Full rcrewai 0.9 feature coverage** (see [rcrewai 0.9](#rcrewai-09-capabilities), [0.8](#rcrewai-08-capabilities) and [0.7](#rcrewai-07-capabilities) 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
   - Checkpointing with resume, LLM interceptors, and the Bedrock / Snowflake / OpenAI-compatible providers
+  - Concurrent tool calls, with a per-agent opt-out
 
 ## Observation Engine
 
@@ -104,7 +105,13 @@ $ rails db:migrate
 (The task name comes from the engine's railtie name, `rcrew_ai_rails`.)
 
 Rails copies only the migrations your app does not already have. Upgrading to
-0.8.0 from 0.7.x adds one:
+0.9.0 from 0.8.x adds one:
+
+| Migration | Purpose |
+|---|---|
+| `013_add_parallel_tools_to_rcrewai_agents` | `rcrewai_agents.parallel_tools` — per-agent opt-out from concurrent tool calls |
+
+Upgrading from 0.7.x adds one more:
 
 | Migration | Purpose |
 |---|---|
@@ -276,9 +283,27 @@ crew.execute_sync(inputs)
 CrewExecutionJob.set(wait: 5.minutes).perform_later(crew, inputs)
 ```
 
-## rcrewai 0.8 capabilities
+## rcrewai 0.9 capabilities
+
+This engine tracks [rcrewai](https://github.com/gkosmo/rcrewAI) `~> 0.9`.
+
+### Concurrency
+
+rcrewai 0.9 runs a turn's tool calls concurrently, so a turn costs the slowest
+call rather than the sum. This is on by default and needs no configuration.
 
-This engine tracks [rcrewai](https://github.com/gkosmo/rcrewAI) `~> 0.8`.
+Opt an agent out when its tools are not safe to run in parallel, or must not
+fan out against a rate-limited API:
+
+```ruby
+agent.update!(parallel_tools: false)
+```
+
+Left `nil` (the default), the gem's own default applies. The observation
+engine attributes concurrent tool calls correctly — each tool span is matched
+to its result by `call_id`, not by arrival order.
+
+## rcrewai 0.8 capabilities
 
 ### Checkpointing and resume
 
@@ -313,6 +338,11 @@ RCrewAI::Checkpoint.lineage(store, resumed.run_id)
 Any object responding to `save`/`load`/`list`/`delete` can replace the store via
 `config.checkpoint_store`.
 
+Checkpointing needs the `rcrewai_checkpoints` table, so run the migration when
+you enable it (see [Upgrading an existing install](#upgrading-an-existing-install)).
+If the table is missing, the job raises `CheckpointTableMissing` up front rather
+than failing partway through a run.
+
 ### LLM interceptors
 
 Hooks that run around every LLM request the engine's agents make — useful for
@@ -366,6 +396,7 @@ existing records are unaffected — set only what you need.
 | `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 |
+| `parallel_tools` | Run a turn's tool calls concurrently (rcrewai 0.9; `nil` uses the gem default of on) |
 | `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) |
 

data/app/jobs/rcrewai/rails/crew_execution_job.rb

@@ -1,9 +1,16 @@
 module RcrewAI
   module Rails
     class CrewExecutionJob < ActiveJob::Base
+      # Raised when checkpointing is enabled but its table is missing, which
+      # means the 0.8 migration has not been run.
+      class CheckpointTableMissing < StandardError; end
+
       queue_as { RcrewAI::Rails.config.job_queue_name }
 
       retry_on StandardError, wait: :exponentially_longer, attempts: 3
+      # A missing table is a configuration problem: retrying cannot fix it and
+      # only delays the error the operator needs to see.
+      discard_on CheckpointTableMissing
 
       def perform(crew, inputs = {}, batch_id: nil, resume_run_id: nil)
         execution = crew.executions.create!(
@@ -69,7 +76,24 @@ module RcrewAI
                   end
         return nil unless enabled
 
-        RcrewAI::Rails.config.checkpoint_store || ActiveRecordCheckpointStore.new
+        store = RcrewAI::Rails.config.checkpoint_store
+        return store if store
+
+        ensure_checkpoint_table!
+        ActiveRecordCheckpointStore.new
+      end
+
+      # Checkpointing was turned on but the 0.8 migration has not been run, so
+      # the default store has no table to write to. Failing here with the fix
+      # in the message beats an ActiveRecord::StatementInvalid raised partway
+      # through the run, once tasks have already been executed and paid for.
+      def ensure_checkpoint_table!
+        return if Checkpoint.table_exists?
+
+        raise CheckpointTableMissing,
+              "checkpointing is enabled but the #{Checkpoint.table_name} table does not exist. " \
+              "Run `rails rcrew_ai_rails:install:migrations && rails db:migrate` to add it, " \
+              "or set config.checkpoint_enabled = false."
       end
 
       # Translates rcrewai events into the span tree. Returns nil when

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

@@ -34,7 +34,7 @@ module RcrewAI
         )
       end
 
-      # rcrewai 0.5.0 agent options. Only emit a key when it is meaningfully
+      # rcrewai 0.5.0+ agent options. Only emit a key when it is meaningfully
       # set, so an all-default record constructs exactly as it did pre-0.5.
       def agent_options
         opts = {}
@@ -42,6 +42,10 @@ module RcrewAI
         opts[:reasoning] = reasoning if reasoning
         opts[:max_reasoning_attempts] = max_reasoning_attempts if reasoning && max_reasoning_attempts
         opts[:respect_context_window] = respect_context_window if respect_context_window
+        # rcrewai 0.9 runs a turn's tool calls concurrently by default. nil
+        # means "leave the gem's default alone"; only an explicit false (or
+        # true) is forwarded.
+        opts[:parallel_tools] = parallel_tools unless parallel_tools.nil?
         opts[:llm] = llm_config.symbolize_keys if llm_config.present?
         sources = rcrew_knowledge_sources
         opts[:knowledge_sources] = sources if sources.any?

data/db/migrate/013_add_parallel_tools_to_rcrewai_agents.rb

@@ -0,0 +1,7 @@
+class AddParallelToolsToRcrewAIAgents < ActiveRecord::Migration[7.0]
+  def change
+    # Nullable on purpose: nil means "use the rcrewai default" (parallel tools
+    # on), so existing agents keep the gem's behavior without a backfill.
+    add_column :rcrewai_agents, :parallel_tools, :boolean
+  end
+end

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

@@ -42,6 +42,7 @@ class CreateRcrewAITables < ActiveRecord::Migration[7.0]
       t.boolean :reasoning, default: false, null: false
       t.integer :max_reasoning_attempts, default: 3
       t.boolean :respect_context_window, default: false, null: false
+      t.boolean :parallel_tools
       t.text :llm_config
       t.boolean :active, default: true
 

data/lib/rcrewai/rails/version.rb

@@ -1,6 +1,6 @@
 module RcrewAI
   module Rails
-    VERSION = "0.8.0"
+    VERSION = "0.9.0"
     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.8.0"
+  spec.add_dependency "rcrewai", "~> 0.9.0"
   
   # 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.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - gkosmo
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.0
+        version: 0.9.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.0
+        version: 0.9.0
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
@@ -262,6 +262,7 @@ files:
 - db/migrate/010_create_rcrewai_spans.rb
 - db/migrate/011_add_observation_rollups_to_rcrewai_executions.rb
 - db/migrate/012_create_rcrewai_checkpoints.rb
+- db/migrate/013_add_parallel_tools_to_rcrewai_agents.rb
 - docs/api.html
 - docs/capabilities.html
 - docs/examples.html