Add RubyLLM provider for unified multi-provider LLM access

Implements a new provider backed by the ruby_llm gem, giving
ActiveAgent access to 15+ LLM providers (OpenAI, Anthropic,
Gemini, Bedrock, Azure, Ollama, etc.) through a single config.

Uses RubyLLM's provider-level API (provider.complete()) to avoid
conflicts with ActiveAgent's own conversation management and tool
execution loop. Includes support for prompts, streaming, tool
calling, embeddings, and ToolChoiceClearing.

44 unit tests, 5 integration tests (excluded from default rake).

Author: khasinski

AGENTS.md

@@ -224,6 +224,12 @@ bin/test test/integration/open_ai/
 - Access 200+ models through single API
 - Provider preferences via `provider: { order: [...] }`
 
+### RubyLLM
+- Uses `ruby_llm` gem for unified access to 15+ providers
+- RubyLLM manages its own API keys via `RubyLLM.configure`
+- Model ID determines which provider is used automatically
+- Supports prompts, embeddings, tool calling, and streaming
+
 ## Common Gotchas
 
 1. **Generation is lazy** - Nothing happens until `generate_now` or `prompt_later`
@@ -253,7 +259,7 @@ bin/rubocop
 
 - Ruby 3.1+
 - Rails 7.2+ / 8.0+ / 8.1+
-- Provider gems (optional): `openai`, `anthropic`
+- Provider gems (optional): `openai`, `anthropic`, `ruby_llm`
 
 ## Links
 

README.md

@@ -39,6 +39,9 @@ bundle add openai
 
 # OpenRouter (uses OpenAI-compatible API)
 bundle add openai
+
+# RubyLLM (unified API for 15+ providers)
+bundle add ruby_llm
 ```
 
 ### Setup
@@ -119,12 +122,15 @@ development:
   ollama:
     service: "Ollama"
     model: "llama3.2"
+
+  ruby_llm:
+    service: "RubyLLM"
 ```
 
 ## Features
 
 - **Agent-Oriented Programming**: Build AI applications using familiar Rails patterns
-- **Multiple Provider Support**: Works with OpenAI, Anthropic, Ollama, and more
+- **Multiple Provider Support**: Works with OpenAI, Anthropic, Ollama, RubyLLM, and more
 - **Action-Based Design**: Define agent capabilities through actions
 - **View Templates**: Use ERB templates for prompts (text, JSON, HTML)
 - **Streaming Support**: Real-time response streaming with ActionCable

Rakefile

@@ -4,7 +4,9 @@ require "rake/testtask"
 
 Rake::TestTask.new(:test) do |t|
   t.libs << "test"
-  t.pattern = "test/**/*_test.rb"
+  t.test_files = FileList["test/**/*_test.rb"]
+    .exclude("test/**/integration_test.rb")
+    .exclude("test/dummy/tmp/**/*")
   t.verbose = true
 end
 

activeagent.gemspec

@@ -29,6 +29,7 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency "anthropic", "~> 1.12"
   spec.add_development_dependency "openai", "~> 0.34"
+  spec.add_development_dependency "ruby_llm", ">= 1.0"
 
   spec.add_development_dependency "capybara", "~> 3.40"
   spec.add_development_dependency "cuprite", "~> 0.15"

docs/actions/embeddings.md

@@ -84,3 +84,4 @@ Different models produce different embedding dimensions:
 - [Testing](/framework/testing) - Test embedding functionality
 - [OpenAI Provider](/providers/open_ai) - OpenAI embedding models
 - [Ollama Provider](/providers/ollama) - Local embedding generation
+- [RubyLLM Provider](/providers/ruby_llm) - Embeddings via RubyLLM's unified API

docs/actions/mcps.md

@@ -18,6 +18,7 @@ Connect agents to external services via [Model Context Protocol](https://modelco
 | **Anthropic**  | ⚠️      | Beta |
 | **OpenRouter** | 🚧      | In development |
 | **Ollama**     | ❌      | Not supported |
+| **RubyLLM**    | ❌      | Not supported (use provider-specific integration) |
 | **Mock**       | ❌      | Not supported |
 
 ## MCP Format

docs/actions/structured_output.md

@@ -23,6 +23,7 @@ Two JSON response formats:
 | **Anthropic**  | 🟦            | ❌             | Emulated via prompt engineering technique |
 | **OpenRouter** | 🟩            | 🟩             | Native support, depends on underlying model |
 | **Ollama**     | 🟨            | 🟨             | Model-dependent, support varies by model |
+| **RubyLLM**    | 🟨            | 🟨             | Depends on underlying provider/model |
 | **Mock**       | 🟩            | 🟩             | Accepted but not validated or enforced |
 
 ## JSON Object Mode

docs/actions/tools.md

@@ -23,6 +23,7 @@ The LLM calls `get_weather` automatically when it needs weather data, and uses t
 | **Anthropic**  | 🟩        | 🟩                | Full support for built-in tools |
 | **OpenRouter** | 🟩        | ❌                | Model-dependent capabilities |
 | **Ollama**     | 🟩        | ❌                | Model-dependent capabilities |
+| **RubyLLM**    | 🟩        | ❌                | Depends on underlying provider/model |
 | **Mock**       | 🟦        | ❌                | Accepted but not enforced |
 
 For **MCP (Model Context Protocol)** support, see the [MCP documentation](/actions/mcps).

docs/framework.md

@@ -113,7 +113,7 @@ Actions call `prompt()` or `embed()` to configure requests. Callbacks manage con
 
 ActiveAgent integrates with Rails features and AI capabilities:
 
-- **[Providers](/providers)** - Swap AI services (OpenAI, Anthropic, Ollama, OpenRouter)
+- **[Providers](/providers)** - Swap AI services (OpenAI, Anthropic, Ollama, OpenRouter, RubyLLM)
 - **[Instructions](/agents/instructions)** - System prompts from templates or strings
 - **[Callbacks](/agents/callbacks)** - Lifecycle hooks for context and logging
 - **[Tools](/actions/tools)** - Agent methods as AI-callable functions
@@ -133,7 +133,7 @@ ActiveAgent integrates with Rails features and AI capabilities:
 - [Generation](/agents/generation) - Synchronous and asynchronous execution
 - [Instructions](/agents/instructions) - System prompts and behavior guidance
 - [Messages](/actions/messages) - Conversation context with multimodal support
-- [Providers](/providers) - OpenAI, Anthropic, Ollama, OpenRouter configuration
+- [Providers](/providers) - OpenAI, Anthropic, Ollama, OpenRouter, RubyLLM configuration
 
 **Advanced:**
 - [Tools](/actions/tools) - AI-callable Ruby methods and MCP integration

docs/framework/configuration.md

@@ -206,7 +206,7 @@ Common settings available across all providers:
 
 | Setting | Type | Required | Description |
 |---------|------|----------|-------------|
-| `service` | String | Yes | Provider class name (OpenAI, Anthropic, OpenRouter, Ollama, Mock) |
+| `service` | String | Yes | Provider class name (OpenAI, Anthropic, OpenRouter, Ollama, RubyLLM, Mock) |
 | `access_token` / `api_key` | String | Yes* | API authentication key |
 | `model` | String | Yes* | Model identifier for the LLM to use |
 | `temperature` | Float | No | Randomness control (0.0-2.0, default varies by provider) |
@@ -220,6 +220,7 @@ Common settings available across all providers:
 - **[Ollama Provider](/providers/ollama)** - Host configuration for local instances
 - **[OpenAI Provider](/providers/open_ai)** - Organization ID, request timeout, admin token, etc.
 - **[OpenRouter Provider](/providers/open_router)** - App name, site URL, provider preferences, etc.
+- **[RubyLLM Provider](/providers/ruby_llm)** - Unified API for 15+ providers via RubyLLM
 - **[Mock Provider](/providers/mock)** - Testing-specific options
 
 ### Using Configured Providers