rcrewai 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 729f55dac5596c9689bf3f1aa6266b95e3e04b249342b739d6d43280aeec9b3c
-  data.tar.gz: ce70bdae47acd61d18df887b43509f5ebe9ab58da26ea67b1367d23feaf16544
+  metadata.gz: c7682076eeeb0d3c1bdc0de2185c83ad8c925ce19165786daa0910c1925fdf64
+  data.tar.gz: 1db4ba5508d8aef52b6645be9cae3dcb7328564f8335a24fe844655196d2f53f
 SHA512:
-  metadata.gz: 97cf0e1a33a584e384638d35e611c97ab4a14b521c5f68a4d6aa7e072c5e6fb6045076201f9e5eec1afceada7215ad0012faa2839afd5eca1f0da0b2ceb164b9
-  data.tar.gz: 2baae70e08e89475904442a76407126a73580902897a4ddb3ec6186b1d85494410640c42a187bfde18a0a4faa2efdf4c628ee3298284051eda846b57533cde92
+  metadata.gz: dfaf95b581c86cd36573400729a02e72e307721f51267fefafdb3245aae28bffc89201855dcd294f38ecfc54a6a1dbf2062d92fbd55310e4f2f9d968b49a1a6e
+  data.tar.gz: 4c8ed1132d754e92ab154c192f28d8add3d80fdbedbaaa15fa6fd876002f18674d30a91f7ef9fb5dcba65a4240ca9f464d26fa15b64a8cdcdee4ad806cefe3bd

data/.rubocop.yml

@@ -0,0 +1 @@
+inherit_from: .rubocop_todo.yml

data/.rubocop_todo.yml

@@ -0,0 +1,99 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2026-05-12 09:06:14 UTC using RuboCop version 1.78.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 2
+Lint/DuplicateMethods:
+  Exclude:
+    - 'lib/rcrewai/configuration.rb'
+
+# Offense count: 55
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
+Metrics/AbcSize:
+  Max: 61
+
+# Offense count: 30
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Max: 325
+
+# Offense count: 1
+# Configuration parameters: CountBlocks, CountModifierForms.
+Metrics/BlockNesting:
+  Max: 4
+
+# Offense count: 14
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ClassLength:
+  Max: 408
+
+# Offense count: 33
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/CyclomaticComplexity:
+  Max: 21
+
+# Offense count: 99
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 67
+
+# Offense count: 1
+# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
+Metrics/ParameterLists:
+  Max: 6
+
+# Offense count: 18
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/PerceivedComplexity:
+  Max: 21
+
+# Offense count: 1
+# Configuration parameters: NamePrefix, ForbiddenPrefixes, AllowedMethods, MethodDefinitionMacros, UseSorbetSigs.
+# NamePrefix: is_, has_, have_, does_
+# ForbiddenPrefixes: is_, has_, have_, does_
+# AllowedMethods: is_a?
+# MethodDefinitionMacros: define_method, define_singleton_method
+Naming/PredicatePrefix:
+  Exclude:
+    - 'spec/**/*'
+    - 'lib/rcrewai/agent.rb'
+
+# Offense count: 32
+# Configuration parameters: AllowedConstants.
+Style/Documentation:
+  Enabled: false
+
+# Offense count: 23
+# This cop supports safe autocorrection (--autocorrect).
+Style/IfUnlessModifier:
+  Exclude:
+    - 'lib/rcrewai/agent.rb'
+    - 'lib/rcrewai/human_input.rb'
+    - 'lib/rcrewai/llm_clients/ollama.rb'
+    - 'lib/rcrewai/memory.rb'
+    - 'lib/rcrewai/process.rb'
+    - 'lib/rcrewai/tools/code_executor.rb'
+    - 'lib/rcrewai/tools/email_sender.rb'
+    - 'lib/rcrewai/tools/file_writer.rb'
+    - 'lib/rcrewai/tools/pdf_processor.rb'
+    - 'lib/rcrewai/tools/sql_database.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: ExactNameMatch, AllowPredicates, AllowDSLWriters, IgnoreClassMethods, AllowedMethods.
+# AllowedMethods: to_ary, to_a, to_c, to_enum, to_h, to_hash, to_i, to_int, to_io, to_open, to_path, to_proc, to_r, to_regexp, to_str, to_s, to_sym
+Style/TrivialAccessors:
+  Exclude:
+    - 'lib/rcrewai/process.rb'
+
+# Offense count: 16
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 201

data/CHANGELOG.md

@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-05-12
+
+### Added
+- Native function calling across all five providers (OpenAI, Anthropic, Google, Azure, Ollama). Tools declare a JSON schema via the new DSL (`tool_name`, `description`, `param`) on `Tools::Base`.
+- Typed streaming event model (`RCrewAI::Events::*`) covering text deltas, tool-call lifecycle, usage, and errors. Pass `stream:` to `crew.execute` or `agent.execute_task`.
+- MCP (Model Context Protocol) client. Connect to stdio or HTTP MCP servers and expose their tools as ordinary RCrewAI tools (`RCrewAI::MCP::Client.with_connection`).
+- Per-model price table (`RCrewAI::Pricing`) and `cost_usd` on `Events::Usage` for cost tracking.
+- `Tools::Base#execute_with_validation` coerces and validates args against the DSL schema.
+- New `ToolRunner` (native function calling loop) and `LegacyReactRunner` (extracted `USE_TOOL[]` parsing loop).
+- `RCrewAI::SSEParser` — reusable Server-Sent Events parser used by all providers and MCP HTTP transport.
+
+### Changed
+- `Agent#execute_task` now delegates to `ToolRunner` (native function calling) or `LegacyReactRunner` (existing `USE_TOOL[]` parsing, used as fallback for legacy models or tools without a DSL declaration).
+- `Agent#execute_task` return value is now a hash including `:content`, `:tool_calls_history`, `:usage`, `:iterations`, `:finish_reason`. `task.result` continues to hold the string content.
+- `LLMClients::Base#chat` gains `tools:`, `tool_choice:`, and `stream:` keyword arguments.
+- Provider clients return symbolic `finish_reason` (`:stop`, `:tool_calls`, `:length`) and symbol-keyed `usage`.
+
+### Breaking
+- Subclasses of `LLMClients::Base` that override `chat` with an explicit kwarg list must add `tools: nil, stream: nil` to the signature (or accept `**options`).
+- Tools without DSL declarations now receive a permissive fallback schema and emit a one-time deprecation warning to stderr.
+
+### Migration
+- See `docs/upgrading-to-0.3.md` for step-by-step migration.
+
 ## [0.1.0] - 2025-01-12
 
 ### Added

data/README.md

@@ -299,6 +299,38 @@ RCrewAI provides a flexible, production-ready architecture:
               └─────────────────┘    └─────────────────┘
 ```
 
+## 🚀 Rails Integration
+
+### rcrew RAILS
+
+For Rails applications, use the **rcrew RAILS** gem (`rcrewai-rails`) [(repo here)](https://github.com/gkosmo/rcrewai-rails) which provides:
+
+- **🏗️ Rails Engine**: Mountable engine with web UI for managing crews
+- **💾 ActiveRecord Integration**: Database persistence for agents, tasks, and executions
+- **⚡ Background Jobs**: ActiveJob integration for async crew execution
+- **🎯 Rails Generators**: Scaffolding for crews, agents, and tasks
+- **🌐 Web Dashboard**: Monitor and manage your AI crews through a web interface
+- **🔧 Rails Configuration**: Seamless integration with Rails configuration patterns
+
+```ruby
+# Gemfile
+gem 'rcrewai-rails'
+
+# config/routes.rb
+Rails.application.routes.draw do
+  mount RcrewAI::Rails::Engine, at: '/rcrewai'
+end
+
+# Generate a new crew
+rails generate rcrew_ai:crew marketing_crew
+
+# Create persistent agents and tasks through Rails models
+crew = RcrewAI::Rails::Crew.create!(name: "Content Team", description: "AI content generation")
+agent = crew.agents.create!(name: "writer", role: "Content Writer", goal: "Create engaging content")
+```
+
+Install rcrew RAILS: `gem install rcrewai-rails`
+
 ## 🤝 Contributing
 
 We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
@@ -325,4 +357,4 @@ RCrewAI is released under the [MIT License](LICENSE).
 
 ---
 
-Made with ❤️ by the RCrewAI community
+Made with ❤️ by the RCrewAI community

data/Rakefile

@@ -1,130 +1,130 @@
 # frozen_string_literal: true
 
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-require "rubocop/rake_task"
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
 
 # Default task
-task default: [:spec, :rubocop]
+task default: %i[spec rubocop]
 
 # RSpec task
 RSpec::Core::RakeTask.new(:spec) do |task|
-  task.rspec_opts = "--color --format documentation"
+  task.rspec_opts = '--color --format documentation'
 end
 
 # RuboCop task
 RuboCop::RakeTask.new do |task|
-  task.options = ["--display-cop-names", "--display-style-guide"]
+  task.options = ['--display-cop-names', '--display-style-guide']
 end
 
 # Test with coverage
-desc "Run specs with coverage report"
+desc 'Run specs with coverage report'
 task :spec_coverage do
   ENV['COVERAGE'] = 'true'
   Rake::Task[:spec].invoke
 end
 
 # Clean coverage files
-desc "Clean coverage files"
+desc 'Clean coverage files'
 task :clean_coverage do
-  FileUtils.rm_rf("coverage/")
+  FileUtils.rm_rf('coverage/')
 end
 
 # Build and install gem locally
-desc "Build and install gem locally"
+desc 'Build and install gem locally'
 task :install_local do
-  sh "gem build rcrewai.gemspec"
-  sh "gem install rcrewai-*.gem"
-  FileUtils.rm(Dir.glob("rcrewai-*.gem"))
+  sh 'gem build rcrewai.gemspec'
+  sh 'gem install rcrewai-*.gem'
+  FileUtils.rm(Dir.glob('rcrewai-*.gem'))
 end
 
 # Run all tests and checks
-desc "Run all tests and code quality checks"
+desc 'Run all tests and code quality checks'
 task :ci do
-  puts "Running RSpec tests..."
+  puts 'Running RSpec tests...'
   Rake::Task[:spec].invoke
-  
+
   puts "\nRunning RuboCop..."
   Rake::Task[:rubocop].invoke
-  
+
   puts "\nAll checks passed! ✅"
 end
 
 # Console task for development
-desc "Start interactive console with gem loaded"
+desc 'Start interactive console with gem loaded'
 task :console do
-  require "irb"
-  require_relative "lib/rcrewai"
+  require 'irb'
+  require_relative 'lib/rcrewai'
   IRB.start
 end
 
 # Generate documentation
-desc "Generate documentation"
+desc 'Generate documentation'
 task :docs do
-  sh "yard doc lib/**/*.rb"
-  puts "Documentation generated in doc/ directory"
+  sh 'yard doc lib/**/*.rb'
+  puts 'Documentation generated in doc/ directory'
 end
 
 # Benchmark task
-desc "Run performance benchmarks"
+desc 'Run performance benchmarks'
 task :benchmark do
-  require_relative "lib/rcrewai"
-  
+  require_relative 'lib/rcrewai'
+
   # Simple benchmark example
-  require "benchmark"
-  
+  require 'benchmark'
+
   RCrewAI.configure do |config|
     config.llm_provider = :openai
-    config.api_key = "test-key"
+    config.api_key = 'test-key'
   end
-  
+
   agent = RCrewAI::Agent.new(
-    name: "benchmark_agent",
-    role: "Test Agent",
-    goal: "Run benchmarks"
+    name: 'benchmark_agent',
+    role: 'Test Agent',
+    goal: 'Run benchmarks'
   )
-  
+
   task = RCrewAI::Task.new(
-    name: "benchmark_task",
-    description: "Test task",
+    name: 'benchmark_task',
+    description: 'Test task',
     agent: agent
   )
-  
-  crew = RCrewAI::Crew.new("benchmark_crew")
+
+  crew = RCrewAI::Crew.new('benchmark_crew')
   crew.add_agent(agent)
   crew.add_task(task)
-  
+
   puts "\nBenchmarking crew creation and setup..."
   result = Benchmark.measure do
     100.times do
       test_crew = RCrewAI::Crew.new("test_#{rand(1000)}")
       test_agent = RCrewAI::Agent.new(
-        name: "test_agent",
-        role: "Test Agent",
-        goal: "Test performance"
+        name: 'test_agent',
+        role: 'Test Agent',
+        goal: 'Test performance'
       )
       test_crew.add_agent(test_agent)
     end
   end
-  
+
   puts "Created 100 crews with agents in: #{result.real.round(4)}s"
 end
 
 # Development setup
-desc "Set up development environment"
+desc 'Set up development environment'
 task :setup do
-  puts "Setting up development environment..."
-  
+  puts 'Setting up development environment...'
+
   # Install dependencies
-  sh "bundle install"
-  
+  sh 'bundle install'
+
   # Create necessary directories
-  FileUtils.mkdir_p("spec/vcr_cassettes") unless Dir.exist?("spec/vcr_cassettes")
-  FileUtils.mkdir_p("coverage") unless Dir.exist?("coverage")
-  FileUtils.mkdir_p("doc") unless Dir.exist?("doc")
-  
+  FileUtils.mkdir_p('spec/vcr_cassettes') unless Dir.exist?('spec/vcr_cassettes')
+  FileUtils.mkdir_p('coverage') unless Dir.exist?('coverage')
+  FileUtils.mkdir_p('doc') unless Dir.exist?('doc')
+
   puts "\n✅ Development environment set up successfully!"
   puts "\nRun 'rake spec' to run tests"
   puts "Run 'rake console' to start an interactive session"
   puts "Run 'rake ci' to run all checks"
-end
+end

data/bin/rcrewai

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require "bundler/setup"
-require "rcrewai"
+require 'bundler/setup'
+require 'rcrewai'
 
-RCrewAI::CLI.start(ARGV)
+RCrewAI::CLI.start(ARGV)

data/docs/mcp.md

@@ -0,0 +1,109 @@
+# MCP (Model Context Protocol) Support
+
+RCrewAI 0.3 ships a minimal MCP client that lets your agents call tools
+hosted by any MCP server — local processes (stdio) or remote services
+(streamable HTTP) — without any custom adapter code.
+
+## What is MCP?
+
+[MCP](https://modelcontextprotocol.io) is an open protocol for connecting
+language models to tools and data sources. Servers expose tools via a
+JSON-RPC schema; clients (like RCrewAI) connect, discover the tools, and
+invoke them on the model's behalf.
+
+The big win: any of the dozens of off-the-shelf MCP servers — filesystem,
+git, Slack, Postgres, browser automation, custom internal tools — works
+with RCrewAI without writing a single line of glue.
+
+## Connecting
+
+### Stdio (local subprocess)
+
+```ruby
+require 'rcrewai'
+
+RCrewAI::MCP::Client.with_connection(
+  command: "npx",
+  args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
+) do |client|
+  puts "connected to #{client.server_name}"
+  client.tools.each { |t| puts " - #{t.name}: #{t.description}" }
+end
+```
+
+### Streamable HTTP (remote)
+
+```ruby
+RCrewAI::MCP::Client.with_connection(
+  url: "https://mcp.example.com/v1",
+  headers: { "Authorization" => "Bearer #{ENV['MCP_TOKEN']}" }
+) do |client|
+  # ...
+end
+```
+
+### Manual lifecycle
+
+`with_connection` is the recommended form (auto-closes on block exit), but
+you can also drive the lifecycle manually:
+
+```ruby
+client = RCrewAI::MCP::Client.connect(command: "ruby", args: ["my_server.rb"])
+# ... use client.tools ...
+client.close
+```
+
+## Tool name prefix
+
+To prevent collisions when an agent uses tools from multiple MCP servers,
+tool names are prefixed with the server name:
+
+```
+echo-server__echo
+filesystem__read_file
+filesystem__write_file
+git__commit
+```
+
+The prefix is `#{server_name}__#{tool_name}`, where `server_name` comes
+from the server's own `serverInfo.name`.
+
+## Using MCP tools with an agent
+
+MCP tools are ordinary `RCrewAI::Tools::Base` instances — pass them to
+`Agent.new(tools: ...)` like any other tool:
+
+```ruby
+RCrewAI::MCP::Client.with_connection(command: "npx", args: [...]) do |client|
+  agent = RCrewAI::Agent.new(
+    name: "fs_agent",
+    role: "Filesystem operator",
+    goal: "Read and summarize files",
+    tools: client.tools
+  )
+
+  task = RCrewAI::Task.new(name: "summarize",
+                           description: "Read /tmp/notes.md and summarize",
+                           agent: agent)
+  result = agent.execute_task(task)
+  puts result[:content]
+end
+```
+
+When `ToolRunner` (the new native-function-calling loop) is selected, the
+LLM picks an MCP tool by name, RCrewAI dispatches the call to the MCP
+server, threads the result back into the conversation, and continues.
+
+## What's not (yet) supported in 0.3
+
+The 0.3 client is intentionally minimal — it covers `initialize`,
+`tools/list`, `tools/call`, and the `notifications/initialized` handshake.
+The following are not implemented:
+
+- **Resources** (`resources/list`, `resources/read`)
+- **Prompts** (`prompts/list`, `prompts/get`)
+- **Server mode** — RCrewAI can be an MCP client, not yet an MCP server
+- **OAuth** authentication for HTTP transports
+- **Notifications other than `initialized`** (e.g., progress, log)
+
+These will land in follow-up releases as the MCP spec stabilizes.