boxcars 0.10.14 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: efe685ae5dc0980e60450b7b5188be1e9a985f0dfb584554c8e7d1bc186e79bd
-  data.tar.gz: 49bd24692b1f7cf64a5c2cf8018e7966cc74ea5de19bca4c4d5bb88f16085009
+  metadata.gz: 06c8b47287c93e2a1f56dbf8b282b41759017e89ce75b4da3b1549fc1fd91bc7
+  data.tar.gz: ee8353dceaf1ad652d056c452a89fb39a37f79973ba553204df0ddecc865dec3
 SHA512:
-  metadata.gz: d0e324db1f31406286df7581f5ee94a86a528e534d0da7cdd0280c5ec12ee449c4b4c422532da4ff98902cc1761fa631a5d601a666e3498d2657c7b2ae104354
-  data.tar.gz: 91517a270f913e32f22239d017f88e282a724036f7e0ba1f22d75fea6b8ef490b28291c81e3c4f2ba41054c3d86a28df6ed499231374b929e4967a9825954109
+  metadata.gz: 3d0cc047e675833cf40a0cee54e8021c049a6e0157218d76eea525d6d09180724e1390c384ebde247cea9fb7a95b3ee2f869bd2e60c82100992ae54ef12539ef
+  data.tar.gz: 0e7d67e1039632f0cada81fbdcb5a1a15f58885a0b579b57bf76340dcb28743834f7f7907355c64c91a0de1d417fbf6eba1bd776cf1c8f77a93335d15412802c

data/.rubocop.yml

@@ -10,7 +10,7 @@ plugins:
 
 
 AllCops:
-  TargetRubyVersion: 3.2
+  TargetRubyVersion: 3.3
   Exclude:
     - 'bin/{rails,rake}'
     - 'node_modules/**/*'

data/.ruby-version

@@ -1 +1 @@
-3.4.8
+4.0.6

data/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 ## [Unreleased]
 
+## [1.0.0] - 2026-08-28
+
+### Added
+
+- Added Ruby 4.0 to the supported CI test matrix and made Ruby 4.0.6 the default development runtime.
+- Added explicit engine-factory routing for the Cerebras `gpt-oss-120b` and Together AI `Qwen/Qwen2.5-VL-72B-Instruct` model IDs.
+
+### Changed
+
+- Raised the minimum supported Ruby version from 3.2 to 3.3, matching the current official OpenAI Ruby SDK.
+- Updated the curated `sonnet` and `opus` aliases to Claude Sonnet 5 and Claude Opus 5.
+- Claude Sonnet 5, Opus 5, and Fable 5 requests now omit unsupported `temperature`, `top_p`, and `top_k` parameters.
+
+### Removed
+
+- Removed the deprecated model aliases `anthropic`, `groq`, `deepseek`, `mistral`, `online`, `huge`, `online_huge`, `sonar-huge`, `sonar_huge`, `sonar_pro`, `flash`, `gemini-flash`, `gemini-pro`, `cerebras`, and `qwen`.
+- Removed the obsolete strict-mode configuration used to detect deprecated model aliases. The curated `sonnet`, `opus`, `sonar`, and `sonar-pro` aliases remain supported.
+
+### Maintenance
+
+- Declared `logger` as a runtime dependency because Ruby 4 no longer bundles it as a default gem.
+- Refreshed bundled dependencies for Ruby 3.3+ and Ruby 4 compatibility, including OpenAI, PostHog, RuboCop, SQLite, and WebMock, and updated the lockfile to Bundler 4.
+
 ## [0.10.14] - 2026-08-04
 
 ### Fixed

data/CLAUDE.md

@@ -39,7 +39,7 @@ Orchestrator that runs a series of boxcars using an engine. Three implementation
 - **XMLTrain** (`lib/boxcars/train/xml_train.rb`) — XML-based structured outputs
 
 ### Engine Factory (`lib/boxcars/engines.rb`)
-`Boxcars::Engines.engine(model:)` creates the right engine from a model name or alias. Default model: `"gemini-2.5-flash"`. Curated aliases include `"sonnet"`, `"opus"`, `"sonar"`, `"sonar-pro"`. Many legacy aliases are deprecated (see `DEPRECATED_MODEL_ALIASES`).
+`Boxcars::Engines.engine(model:)` creates the right engine from a model name or alias. Default model: `"gemini-2.5-flash"`. Curated aliases are `"sonnet"`, `"opus"`, `"sonar"`, and `"sonar-pro"`; legacy aliases were removed in v1.0.
 
 ### Other Key Components
 - **MCP** (`lib/boxcars/mcp/`) — Model Context Protocol integration for external tool servers
@@ -57,5 +57,5 @@ Orchestrator that runs a series of boxcars using an engine. Three implementation
 
 - Rubocop with `rubocop-rspec` and `rubocop-rake` plugins
 - Max line length: 130 (excluded for specs)
-- Target Ruby: 3.2+
+- Target Ruby: 3.3+
 - Provider gems are optional — core has zero runtime dependencies; providers are loaded on demand via `OptionalDependency`

data/Gemfile.lock

@@ -1,7 +1,8 @@
 PATH
   remote: .
   specs:
-    boxcars (0.10.14)
+    boxcars (1.0.0)
+      logger
 
 GEM
   remote: https://rubygems.org/
@@ -30,7 +31,6 @@ GEM
     ast (2.4.3)
     base64 (0.3.0)
     bigdecimal (4.1.2)
-    cgi (0.5.2)
     concurrent-ruby (1.3.8)
     connection_pool (3.0.2)
     crack (1.0.1)
@@ -57,7 +57,7 @@ GEM
     hnswlib (0.9.3)
     i18n (1.15.2)
       concurrent-ruby (~> 1.0)
-    io-console (0.8.2)
+    io-console (0.9.2)
     irb (1.18.0)
       pp (>= 0.6.0)
       prism (>= 1.3.0)
@@ -89,10 +89,9 @@ GEM
       racc (~> 1.4)
     nokogiri (1.19.4-x86_64-linux-musl)
       racc (~> 1.4)
-    openai (0.77.1)
-      base64
-      cgi
-      connection_pool
+    openai (0.83.0)
+      connection_pool (>= 2.2.3)
+      logger
     parallel (2.1.0)
     parser (3.3.12.0)
       ast (~> 2.4.1)
@@ -105,7 +104,7 @@ GEM
     pg (1.6.3-x86_64-linux)
     pg (1.6.3-x86_64-linux-musl)
     pgvector (0.3.3)
-    posthog-ruby (3.21.0)
+    posthog-ruby (3.23.5)
       concurrent-ruby (~> 1)
     pp (0.6.4)
       prettyprint
@@ -115,7 +114,7 @@ GEM
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.4.2)
-    rbs (4.1.2)
+    rbs (4.2.0)
       logger
       prism (>= 1.6.0)
       tsort
@@ -125,7 +124,7 @@ GEM
       rbs (>= 4.0.0)
       tsort
     regexp_parser (2.12.0)
-    reline (0.6.3)
+    reline (0.7.0)
       io-console (~> 0.5)
     rexml (3.4.4)
     rspec (3.13.2)
@@ -141,8 +140,8 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.7)
-    rubocop (1.89.0)
-      json (~> 2.3)
+    rubocop (1.90.0)
+      json (>= 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
       parallel (>= 1.10)
@@ -170,14 +169,14 @@ GEM
     securerandom (0.4.1)
     sequel (5.107.0)
       bigdecimal
-    sqlite3 (2.9.5-aarch64-linux-gnu)
-    sqlite3 (2.9.5-aarch64-linux-musl)
-    sqlite3 (2.9.5-arm-linux-gnu)
-    sqlite3 (2.9.5-arm-linux-musl)
-    sqlite3 (2.9.5-arm64-darwin)
-    sqlite3 (2.9.5-x86_64-darwin)
-    sqlite3 (2.9.5-x86_64-linux-gnu)
-    sqlite3 (2.9.5-x86_64-linux-musl)
+    sqlite3 (2.9.6-aarch64-linux-gnu)
+    sqlite3 (2.9.6-aarch64-linux-musl)
+    sqlite3 (2.9.6-arm-linux-gnu)
+    sqlite3 (2.9.6-arm-linux-musl)
+    sqlite3 (2.9.6-arm64-darwin)
+    sqlite3 (2.9.6-x86_64-darwin)
+    sqlite3 (2.9.6-x86_64-linux-gnu)
+    sqlite3 (2.9.6-x86_64-linux-musl)
     timeout (0.6.1)
     tsort (0.2.0)
     tzinfo (2.0.6)
@@ -187,7 +186,7 @@ GEM
     unicode-emoji (4.2.0)
     uri (1.1.1)
     vcr (6.4.0)
-    webmock (3.26.2)
+    webmock (3.26.3)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
@@ -228,4 +227,4 @@ DEPENDENCIES
   webmock (~> 3.26.1)
 
 BUNDLED WITH
-   2.5.20
+  4.0.16

data/README.md

@@ -46,6 +46,8 @@ All of these concepts are in a module named Boxcars:
 
 ## Installation
 
+Boxcars requires Ruby 3.3 or newer.
+
 Add this line to your application's Gemfile:
 
 ```ruby

data/UPGRADING.md

@@ -1,6 +1,6 @@
 # Upgrading Boxcars (v0.9 -> v1.0)
 
-This guide covers the migration path for the modernization work added in v0.9 and the planned alias removals in v1.0.
+This guide covers the migration path from Boxcars v0.9 and v0.10 to v1.0.
 
 ## Summary
 
@@ -11,10 +11,15 @@ v0.9 introduces:
 - JSON Schema support for `JSONEngineBoxcar`
 - Deprecated model alias warnings with optional strict mode
 
-v1.0 is expected to:
+v1.0:
 
 - Remove deprecated model aliases
 - Prefer explicit model names (with a small curated alias set)
+- Require Ruby 3.3 or newer, with Ruby 4 fully supported
+
+## Ruby 3.3 or Newer Is Required
+
+Boxcars 1.0 drops Ruby 3.2 support and requires Ruby 3.3 or newer. Upgrade your Ruby runtime before installing Boxcars 1.0. Applications that must remain on Ruby 3.2 should stay on Boxcars 0.10.x and OpenAI Ruby SDK 0.75.x, the final compatible release line.
 
 ## SQL Boxcars Now Default to Read-Only (v0.10.x)
 
@@ -115,7 +120,7 @@ result.answer
 
 ## 1. Model Alias Migration (Do This First)
 
-Deprecated aliases still work in v0.9, but emit one-time warnings.
+The aliases below emitted one-time warnings in v0.9 and v0.10 and are removed in v1.0. Using one now raises `Boxcars::ArgumentError` with an `Unknown model` message.
 
 ### Kept curated aliases (not deprecated)
 
@@ -124,6 +129,10 @@ Deprecated aliases still work in v0.9, but emit one-time warnings.
 - `sonnet`
 - `opus`
 
+In v1.0, `sonnet` targets `claude-sonnet-5` and `opus` targets `claude-opus-5`. These Claude 5 models do not accept
+custom `temperature`, `top_p`, or `top_k` values, so Boxcars removes those options before sending the request. Use an
+explicit older Claude model ID if your application depends on custom sampling values.
+
 ### Replace deprecated aliases
 
 - `anthropic` -> `sonnet`
@@ -148,27 +157,14 @@ Prefer explicit model names in app code:
 
 ```ruby
 Boxcars::Engines.engine(model: "gpt-4o")
-Boxcars::Engines.engine(model: "claude-sonnet-4-0")
+Boxcars::Engines.engine(model: "claude-sonnet-5")
 Boxcars::Engines.engine(model: "gemini-2.5-flash")
 Boxcars::Engines.engine(model: "sonar-pro")
 ```
 
-## 2. Enable Strict Alias Mode in CI
-
-Use this to fail builds when deprecated aliases are used.
-
-```ruby
-# config/initializers/boxcars.rb
-Boxcars.configure do |config|
-  config.strict_deprecated_model_aliases = ENV["CI"] == "true"
-end
-```
-
-Or enforce globally in tests:
+## 2. Verify Removed Aliases in CI
 
-```ruby
-Boxcars::Engines.strict_deprecated_aliases = true
-```
+No strict-mode setting is needed in v1.0. Removed aliases fail during engine construction, so normal application tests catch any remaining uses.
 
 ## 3. Migrate ReAct/Text Trains to Native Tool Calling (Optional, Recommended)
 
@@ -260,7 +256,7 @@ boxcar = Boxcars::JSONEngineBoxcar.new(json_schema: schema, json_schema_strict:
 3. Migrate one workflow from `ZeroShot` to `ToolTrain`.
 4. Add MCP tools where they simplify app-specific integrations.
 5. Add JSON Schema to `JSONEngineBoxcar` uses that need reliable structure.
-6. Upgrade to v1.0 after strict mode stays green.
+6. Upgrade to v1.0 after the application test suite passes with explicit models or curated aliases.
 
 ## 7. Known Ongoing Modernization Work
 

data/boxcars.gemspec

@@ -12,9 +12,8 @@ Gem::Specification.new do |spec|
   spec.description = "You simply set an OpenAI key, give a number of Boxcars to a Train, and magic ensues when you run it."
   spec.homepage = "https://github.com/BoxcarsAI/boxcars"
   spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.2.0"
+  spec.required_ruby_version = ">= 3.3.0"
 
-  spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = spec.homepage
   spec.metadata["changelog_uri"] = "https://github.com/BoxcarsAI/boxcars/blob/main/CHANGELOG.md"
   spec.metadata["rubygems_mfa_required"] = "true"
@@ -31,6 +30,8 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   # runtime dependencies
+  spec.add_dependency "logger"
+
   # Provider/tooling gems are optional and loaded on use.
 
   # For more information and examples about making a new gem, checkout our

data/docs/boxcars_guide.md

@@ -93,35 +93,38 @@ perplexity_engine = Boxcars::Engines.engine(model: "sonar")
 #### Supported Model Aliases
 
 **OpenAI Models:**
-- Any OpenAI model ID from the [OpenAI pricing/models page](https://developers.openai.com/api/pricing) (for example `"gpt-5-mini"`, `"gpt-5"`, `"o1"`, `"o3"`) creates `Boxcars::Openai` engines
+- Any OpenAI model ID from the [OpenAI pricing/models page](https://developers.openai.com/api/pricing) (for example `"gpt-5.6-sol"`, `"gpt-5.6-terra"`, `"gpt-5.6-luna"`, `"o1"`, or `"o3"`) creates `Boxcars::Openai` engines
 
 **Anthropic Models:**
-- `"anthropic"`, `"sonnet"` - Creates `Boxcars::Anthropic` with Claude Sonnet
-- `"opus"` - Creates `Boxcars::Anthropic` with Claude Opus
+- `"sonnet"` - Creates `Boxcars::Anthropic` with `claude-sonnet-5`
+- `"opus"` - Creates `Boxcars::Anthropic` with `claude-opus-5`
+- `"claude-fable-5"` - Creates `Boxcars::Anthropic` with Claude Fable 5
 - `"claude-3-5-sonnet"`, etc. - Any model starting with "claude-"
 
+Use the full model IDs for Sol, Terra, Luna, and Fable; their short names are not Boxcars aliases.
+
 **Groq Models:**
-- `"groq"` - Creates `Boxcars::Groq` with Llama 3.3 70B
-- `"deepseek"` - Creates `Boxcars::Groq` with DeepSeek R1
-- `"mistral"` - Creates `Boxcars::Groq` with Mistral
+- `"llama-3.3-70b-versatile"` - Creates `Boxcars::Groq` with Llama 3.3 70B
 - Models starting with `"mistral-"`, `"meta-llama/"`, or `"deepseek-"`
 
 **Gemini Models:**
-- `"flash"`, `"gemini-flash"` - Creates `Boxcars::GeminiAi` with Gemini 2.5 Flash
-- `"gemini-pro"` - Creates `Boxcars::GeminiAi` with Gemini 2.5 Pro
 - Any model starting with `"gemini-"`
 
 **Perplexity Models:**
-- `"online"`, `"sonar"` - Creates `Boxcars::Perplexityai` with Sonar
-- `"sonar-pro"`, `"huge"` - Creates `Boxcars::Perplexityai` with Sonar Pro
+- `"sonar"` - Creates `Boxcars::Perplexityai` with Sonar
+- `"sonar-pro"` - Creates `Boxcars::Perplexityai` with Sonar Pro
 - Models containing `"-sonar-"`
 
+**Cerebras Models:**
+- `"gpt-oss-120b"` - Creates `Boxcars::Cerebras`
+
 **Together AI Models:**
 - `"together-model-name"` - Creates `Boxcars::Together` (strips "together-" prefix)
+- `"Qwen/Qwen2.5-VL-72B-Instruct"` - Creates `Boxcars::Together`
 
-#### Alias Deprecations (Migration to v1.0)
+#### Aliases Removed in v1.0
 
-Some older aliases are still supported but emit a one-time deprecation warning (per process):
+The following aliases were deprecated in v0.9 and v0.10 and are removed in v1.0:
 
 - `"anthropic"` (use `"sonnet"`)
 - `"groq"` (use an explicit model like `"llama-3.3-70b-versatile"`)
@@ -130,26 +133,7 @@ Some older aliases are still supported but emit a one-time deprecation warning (
 - `"flash"` / `"gemini-flash"` / `"gemini-pro"` (use explicit Gemini models)
 - `"deepseek"`, `"mistral"`, `"cerebras"`, `"qwen"` (use explicit model names)
 
-`"sonar"` and `"sonar-pro"` remain supported curated aliases.
-
-Enable strict mode to raise an error instead of warning on deprecated aliases:
-
-```ruby
-Boxcars.configure do |config|
-  config.strict_deprecated_model_aliases = true
-end
-
-# or:
-Boxcars::Engines.strict_deprecated_aliases = true
-```
-
-Temporarily silence deprecation warnings during migration:
-
-```ruby
-Boxcars.configure do |config|
-  config.emit_deprecation_warnings = false
-end
-```
+`"sonnet"`, `"opus"`, `"sonar"`, and `"sonar-pro"` remain supported curated aliases. See [UPGRADING.md](../UPGRADING.md) for the complete replacement table.
 
 #### Passing Additional Parameters
 

data/lib/boxcars/boxcar/active_record.rb

@@ -3,7 +3,7 @@
 # Boxcars is a framework for running a series of tools to get an answer to a question.
 module Boxcars
   # A Boxcar that interprets a prompt and executes Active Record code to get answers.
-  # rubocop:disable Metrics/ClassLength
+  # rubocop:disable-next Metrics/ClassLength
   class ActiveRecord < EngineBoxcar
     # Default description for this boxcar.
     ARDESC = "useful for when you need to query a database for an application named %<name>s."
@@ -172,9 +172,8 @@ module Boxcars
       new_code = new_code.gsub(/\b(puts|print)\b/, '')
 
       proc do
-        # rubocop:disable Security/Eval
+        # rubocop:disable-next Security/Eval
         eval(new_code, binding)
-        # rubocop:enable Security/Eval
       end.call
     end
 
@@ -288,5 +287,4 @@ module Boxcars
         output_variables: [:answer])
     end
   end
-  # rubocop:enable Metrics/ClassLength
 end

data/lib/boxcars/engine/anthropic.rb

@@ -15,8 +15,13 @@ module Boxcars
       max_tokens: 4096,
       temperature: 0.1
     }.freeze
-    OPUS_4_7_MODEL_PREFIX = "claude-opus-4-7"
-    OPUS_4_7_UNSUPPORTED_SAMPLING_PARAMS = %i[temperature top_p top_k].freeze
+    MODELS_WITHOUT_SAMPLING_PARAMS = %w[
+      claude-opus-4-7
+      claude-sonnet-5
+      claude-opus-5
+      claude-fable-5
+    ].freeze
+    UNSUPPORTED_SAMPLING_PARAMS = %i[temperature top_p top_k].freeze
 
     # The default name of the engine.
     DEFAULT_NAME = "Anthropic engine"
@@ -29,7 +34,7 @@ module Boxcars
       raise ArgumentError, "unknown keyword: :prompts" if kwargs.key?(:prompts)
 
       user_id = kwargs.delete(:user_id)
-      @llm_params = remove_opus_4_7_unsupported_sampling_params(DEFAULT_PARAMS.merge(kwargs))
+      @llm_params = remove_unsupported_sampling_params(DEFAULT_PARAMS.merge(kwargs))
       super(description:, name:, batch_size: 20, user_id:)
     end
 
@@ -85,7 +90,7 @@ module Boxcars
       params[:stop_sequences] = params.delete(:stop) if params.key?(:stop)
       params[:system] = params[:messages].shift[:content] if params.dig(:messages, 0, :role) == :system
       params[:messages].pop if params[:messages].last[:content].nil? || params[:messages].last[:content].strip.empty?
-      remove_opus_4_7_unsupported_sampling_params(params)
+      remove_unsupported_sampling_params(params)
       combine_assistant(params)
     end
 
@@ -114,18 +119,21 @@ module Boxcars
 
     private
 
-    def remove_opus_4_7_unsupported_sampling_params(params)
-      return params unless opus_4_7_model?(params[:model] || params["model"])
+    def remove_unsupported_sampling_params(params)
+      return params unless sampling_params_unsupported?(params[:model] || params["model"])
 
-      OPUS_4_7_UNSUPPORTED_SAMPLING_PARAMS.each do |key|
+      UNSUPPORTED_SAMPLING_PARAMS.each do |key|
         params.delete(key)
         params.delete(key.to_s)
       end
       params
     end
 
-    def opus_4_7_model?(model)
-      model.to_s.start_with?(OPUS_4_7_MODEL_PREFIX)
+    def sampling_params_unsupported?(model)
+      model_name = model.to_s
+      MODELS_WITHOUT_SAMPLING_PARAMS.any? do |base_model|
+        model_name == base_model || model_name.start_with?("#{base_model}-")
+      end
     end
 
     # Process the raw response from Anthropic API

data/lib/boxcars/engine/openai.rb

@@ -356,7 +356,7 @@ module Boxcars
         when "output_text"
           content = i["content"]
           if content.is_a?(Array)
-            # rubocop:disable Metrics/BlockNesting
+            # rubocop:disable-next Metrics/BlockNesting
             texts << content.filter_map { |c|
               if c.is_a?(Hash)
                 if c["text"].is_a?(String)
@@ -366,7 +366,6 @@ module Boxcars
                 end
               end
             }.join
-            # rubocop:enable Metrics/BlockNesting
           elsif content.is_a?(String)
             texts << content
           end

data/lib/boxcars/engine/perplexityai.rb

@@ -26,7 +26,7 @@ module Boxcars
       super(description:, name:, batch_size:, user_id:)
     end
 
-    # rubocop:disable Metrics/MethodLength
+    # rubocop:disable-next Metrics/MethodLength
     def client(prompt:, inputs: {}, perplexity_api_key: nil, **kwargs)
       start_time = Time.now
       response_data = { response_obj: nil, parsed_json: nil, success: false, error: nil, status_code: nil }
@@ -108,7 +108,6 @@ module Boxcars
 
       perplexity_handle_call_outcome(response_data:)
     end
-    # rubocop:enable Metrics/MethodLength
 
     def default_params
       @perplexity_params

data/lib/boxcars/engine/unified_observability.rb

@@ -6,7 +6,7 @@ require 'securerandom'
 module Boxcars
   # Unified observability module that provides PostHog-centric tracking for all engines
   # Uses standardized $ai_* properties as defined by PostHog's LLM observability spec
-  # rubocop:disable Metrics/ModuleLength
+  # rubocop:disable-next Metrics/ModuleLength
   module UnifiedObservability
     private
 
@@ -486,5 +486,4 @@ module Boxcars
         (response_data[:response_obj].respond_to?(:status) ? response_data[:response_obj].status : nil)
     end
   end
-  # rubocop:enable Metrics/ModuleLength
 end

data/lib/boxcars/engines.rb

@@ -6,33 +6,12 @@ module Boxcars
   class Engines
     VALID_ANSWER_REMOVE_IN = "3.0"
     DEFAULT_MODEL = "gemini-2.5-flash"
-    DEPRECATED_MODEL_ALIASES = {
-      # Generic provider aliases are convenient but ambiguous and make pruning harder.
-      "anthropic" => { replacement: "sonnet", remove_in: "3.0", reason: "generic provider alias" },
-      "groq" => { replacement: "llama-3.3-70b-versatile", remove_in: "3.0", reason: "generic provider alias" },
-      "deepseek" => { replacement: "deepseek-r1-distill-llama-70b", remove_in: "3.0",
-                      reason: "provider-specific shortcut alias" },
-      "mistral" => { replacement: "mistral-saba-24b", remove_in: "3.0", reason: "provider-specific shortcut alias" },
-      "online" => { replacement: "sonar", remove_in: "3.0", reason: "ambiguous alias" },
-      "huge" => { replacement: "sonar-pro", remove_in: "3.0", reason: "ambiguous alias" },
-      "online_huge" => { replacement: "sonar-pro", remove_in: "3.0", reason: "ambiguous alias" },
-      "sonar-huge" => { replacement: "sonar-pro", remove_in: "3.0", reason: "legacy alias spelling" },
-      "sonar_huge" => { replacement: "sonar-pro", remove_in: "3.0", reason: "legacy alias spelling" },
-      "sonar_pro" => { replacement: "sonar-pro", remove_in: "3.0", reason: "legacy alias spelling" },
-      "flash" => { replacement: "gemini-2.5-flash", remove_in: "3.0", reason: "generic alias" },
-      "gemini-flash" => { replacement: "gemini-2.5-flash", remove_in: "3.0", reason: "generic alias" },
-      "gemini-pro" => { replacement: "gemini-2.5-pro", remove_in: "3.0", reason: "generic alias" },
-      "cerebras" => { replacement: "gpt-oss-120b", remove_in: "3.0", reason: "generic provider alias" },
-      "qwen" => { replacement: "Qwen/Qwen2.5-VL-72B-Instruct", remove_in: "3.0", reason: "provider-specific shortcut alias" }
-    }.freeze
 
     @emit_deprecation_warnings = true
-    @strict_deprecated_aliases = false
-    @warned_aliases = {}
     @warned_valid_answer = false
 
     class << self
-      attr_accessor :emit_deprecation_warnings, :strict_deprecated_aliases
+      attr_accessor :emit_deprecation_warnings
     end
 
     # Create an engine instance based on the model name
@@ -42,57 +21,40 @@ module Boxcars
     def self.engine(model: nil, **kw_args)
       kw_args = Boxcars.configuration.default_model_options.merge(kw_args) if model.nil?
       model ||= Boxcars.configuration.default_model || DEFAULT_MODEL
-      emit_alias_deprecation_warning(model)
       Boxcars.logger&.info { "running api with #{model}" }
 
       case model.to_s
+      when "gpt-oss-120b"
+        Boxcars::Cerebras.new(model:, **kw_args)
       when /^(gpt-|o\d($|-))/
         Boxcars::Openai.new(model:, **kw_args)
-      when "anthropic", "sonnet"
-        Boxcars::Anthropic.new(model: "claude-sonnet-4-0", **kw_args)
-      when "opus", "claude-opus-4-0"
-        Boxcars::Anthropic.new(model: "claude-opus-4-0", **kw_args)
+      when "sonnet"
+        Boxcars::Anthropic.new(model: "claude-sonnet-5", **kw_args)
+      when "opus"
+        Boxcars::Anthropic.new(model: "claude-opus-5", **kw_args)
       when /claude-/
         Boxcars::Anthropic.new(model:, **kw_args)
-      when "groq", "llama-3.3-70b-versatile"
+      when "llama-3.3-70b-versatile"
         Boxcars::Groq.new(model: "llama-3.3-70b-versatile", **kw_args)
-      when "deepseek"
-        Boxcars::Groq.new(model: "deepseek-r1-distill-llama-70b", **kw_args)
-      when "mistral"
-        Boxcars::Groq.new(model: "mistral-saba-24b", **kw_args)
       when /^mistral-/, %r{^meta-llama/}, /^deepseek-/
         Boxcars::Groq.new(model:, **kw_args)
-      when "online", "sonar"
+      when "sonar"
         Boxcars::Perplexityai.new(model: "sonar", **kw_args)
-      when "huge", "online_huge", "sonar-huge", "sonar_huge", "sonar-pro", "sonar_pro"
+      when "sonar-pro"
         Boxcars::Perplexityai.new(model: "sonar-pro", **kw_args)
-      when "flash", "gemini-flash"
-        Boxcars::GeminiAi.new(model: "gemini-2.5-flash", **kw_args)
-      when "gemini-pro"
-        Boxcars::GeminiAi.new(model: "gemini-2.5-pro", **kw_args)
-      when /gemini-/
+      when /^gemini-(?!flash$|pro$)/
         Boxcars::GeminiAi.new(model:, **kw_args)
       when /-sonar-/
         Boxcars::Perplexityai.new(model:, **kw_args)
       when /^together-/
         Boxcars::Together.new(model: model[9..-1], **kw_args)
-      when "cerebras"
-        Boxcars::Cerebras.new(model: "gpt-oss-120b", **kw_args)
-      when "qwen"
-        Boxcars::Together.new(model: "Qwen/Qwen2.5-VL-72B-Instruct", **kw_args)
+      when "Qwen/Qwen2.5-VL-72B-Instruct"
+        Boxcars::Together.new(model:, **kw_args)
       else
         raise Boxcars::ArgumentError, "Unknown model: #{model}"
       end
     end
 
-    def self.deprecated_alias_info(model)
-      DEPRECATED_MODEL_ALIASES[model.to_s]
-    end
-
-    def self.deprecated_alias?(model)
-      !deprecated_alias_info(model).nil?
-    end
-
     # Create an engine instance optimized for JSON responses
     # @param model [String] The model name or alias
     # @param kw_args [Hash] Additional arguments to pass to the engine
@@ -101,7 +63,7 @@ module Boxcars
       default_options = { temperature: 0.1 }
       effective_model = model || Boxcars.configuration.default_model || DEFAULT_MODEL
       name = effective_model.to_s
-      blocked = name.start_with?("gpt-5", "llama") || name.match?(/sonnet|opus|haiku|sonar/)
+      blocked = name.start_with?("gpt-5", "llama", "claude-") || name.match?(/sonnet|opus|haiku|sonar/)
       default_options[:response_format] = { type: "json_object" } unless blocked
       options = default_options.merge(kw_args)
       engine(model:, **options)
@@ -122,40 +84,10 @@ module Boxcars
       Boxcars::Result.valid_conduct_payload?(answer)
     end
 
-    def self.emit_alias_deprecation_warning(model)
-      model_name = model.to_s
-      info = deprecated_alias_info(model_name)
-      return unless info
-
-      replacement = info[:replacement]
-      remove_in = info[:remove_in]
-      reason = info[:reason]
-      message = "Deprecated model alias #{model_name.inspect} (#{reason}); use #{replacement.inspect} instead"
-      message += " (planned removal in v#{remove_in})" if remove_in
-
-      raise Boxcars::ArgumentError, "#{message}. Set an explicit model name." if strict_deprecated_aliases_enabled?
-
-      return unless deprecation_warnings_enabled?
-      return if @warned_aliases[model_name]
-
-      if Boxcars.logger
-        Boxcars.logger.warn(message)
-      else
-        warn(message)
-      end
-
-      @warned_aliases[model_name] = true
-    end
-
     def self.reset_deprecation_warnings!
-      @warned_aliases = {}
       @warned_valid_answer = false
     end
 
-    def self.strict_deprecated_aliases_enabled?
-      strict_deprecated_aliases || Boxcars.configuration.strict_deprecated_model_aliases
-    end
-
     def self.deprecation_warnings_enabled?
       emit_deprecation_warnings && Boxcars.configuration.emit_deprecation_warnings
     end

data/lib/boxcars/prompt.rb

@@ -19,11 +19,10 @@ module Boxcars
     # compute the prompt parameters with input substitutions (used for chatGPT)
     # @param inputs [Hash] The inputs to use for the prompt.
     # @return [Hash] The formatted prompt { messages: ...}
-    # rubocop:disable Lint/UnusedMethodArgument
+    # rubocop:disable-next Lint/UnusedMethodArgument
     def as_prompt(inputs: nil, prefixes: nil, show_roles: nil)
       { prompt: format(inputs) }
     end
-    # rubocop:enable Lint/UnusedMethodArgument
 
     # compute the prompt parameters with input substitutions
     # @param inputs [Hash] The inputs to use for the prompt.

data/lib/boxcars/version.rb

@@ -2,5 +2,5 @@
 
 module Boxcars
   # The current version of the gem.
-  VERSION = "0.10.14"
+  VERSION = "1.0.0"
 end

data/lib/boxcars/x_node.rb

@@ -32,9 +32,8 @@ module Boxcars
       doc = Nokogiri::XML.parse(xml)
       if doc.errors.any?
         Boxcars.debug("XML: #{xml}", :yellow)
-        # rubocop:disable Lint/Debugger
+        # rubocop:disable-next Lint/Debugger
         debugger if ENV.fetch("DEBUG_XML", false)
-        # rubocop:enable Lint/Debugger
         raise XmlError, "XML is not valid: #{doc.errors.map { |e| "#{e.line}:#{e.column} #{e.message}" }}"
       end
       XNode.new(doc.root)
@@ -53,9 +52,8 @@ module Boxcars
     end
 
     def xtext(path)
-      # rubocop:disable Style/SafeNavigationChainLength
+      # rubocop:disable-next Style/SafeNavigationChainLength
       rv = xpath(path)&.text&.gsub(/[[:space:]]+/, " ")&.strip
-      # rubocop:enable Style/SafeNavigationChainLength
       return nil if rv.empty?
 
       rv

data/lib/boxcars.rb

@@ -29,7 +29,7 @@ module Boxcars
   class Configuration
     attr_writer :openai_access_token, :serpapi_api_key, :groq_api_key, :cerebras_api_key, :perplexity_api_key
     attr_accessor :organization_id, :logger, :log_prompts, :log_generated, :default_train, :default_engine, :default_model,
-                  :default_model_options, :observability_backend, :strict_deprecated_model_aliases
+                  :default_model_options, :observability_backend
 
     def initialize
       @organization_id = nil
@@ -37,7 +37,6 @@ module Boxcars
       @log_prompts = ENV.fetch("LOG_PROMPTS", false)
       @log_generated = ENV.fetch("LOG_GEN", false)
       @default_model_options = {}
-      @strict_deprecated_model_aliases = false
       self.emit_deprecation_warnings = true
       self.openai_official_require_native = ENV.fetch("OPENAI_OFFICIAL_REQUIRE_NATIVE", false)
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: boxcars
 version: !ruby/object:Gem::Version
-  version: 0.10.14
+  version: 1.0.0
 platform: ruby
 authors:
 - Francis Sullivan
@@ -9,7 +9,21 @@ authors:
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: You simply set an OpenAI key, give a number of Boxcars to a Train, and
   magic ensues when you run it.
 email:
@@ -131,7 +145,6 @@ homepage: https://github.com/BoxcarsAI/boxcars
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/BoxcarsAI/boxcars
   source_code_uri: https://github.com/BoxcarsAI/boxcars
   changelog_uri: https://github.com/BoxcarsAI/boxcars/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
@@ -142,14 +155,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Boxcars is a gem that enables you to create new systems with AI composability.
   Inspired by python langchain.