boxcars 0.10.12 → 0.10.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc0d243df1b2f99735023f498f3810008deeca868945e878ca3db11374bf25ee
-  data.tar.gz: 3e309dbfa081ac2bbd732d2045d4d554326c1a4d099ec3fc9c7d2d977b45e9e1
+  metadata.gz: 1b384afa83de379dbebf4fb7bce4ece7883993c87ad5526240bb69b1fab05a50
+  data.tar.gz: bdd1d266db61afdb05f4f4bb6851e219fed3cf71380ee3d5c4dd50e3a5505253
 SHA512:
-  metadata.gz: 2874d7d8211e773ca7dffae55669e1174f5cd140c5203c1bba96b21603e07a5efbd0a273c544380a9f5e0d0b138e2c3948cd942c3e2c5a8a32c9d1dfcd820ed4
-  data.tar.gz: ff81745ad77fe91baee37f3964c45a8092a5f8a6b7ae320bbe946e6054b4a6438ca051232a0429c135d6e97698cd1bad858db94fc5caec57cdb3811ddf284e5a
+  metadata.gz: 84c44b4ea6d7d8ab957f93ace2a71a229fff834a048489a1e85b580b76010747c35e844a0c72e64ab9524dd401eb3a7067208d583b5310b2cd631ecee82e51bf
+  data.tar.gz: e462bdad7c4b9594b5f45efed712b4801176341edc407638a9259625bc62340d593a37d9e0eaa3163df6c8a86d8326badda8d4642969f202614e0fe9c45f5ab4

data/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## [Unreleased]
 
+## [0.10.13] - 2026-08-04
+
+### Added
+
+- Added `Boxcars::Configuration#default_model_options` for applying shared engine options when the configured or built-in default model is used. Per-call options take precedence, and configured defaults are not passed to explicit models.
+
+### Maintenance
+
+- Refreshed bundled dependencies, including Active Record, OpenAI, RuboCop, and Sequel.
+
+## [0.10.12] - 2026-07-20
+
+### Maintenance
+
+- Updated development dependency constraints and refreshed bundled dependencies, including OpenAI, PostHog, RuboCop, and Sequel.
+
 ## [0.10.11] - 2026-06-26
 
 ### Fixed

data/Gemfile.lock

@@ -1,18 +1,18 @@
 PATH
   remote: .
   specs:
-    boxcars (0.10.12)
+    boxcars (0.10.13)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (8.1.3)
-      activesupport (= 8.1.3)
-    activerecord (8.1.3)
-      activemodel (= 8.1.3)
-      activesupport (= 8.1.3)
+    activemodel (8.1.3.1)
+      activesupport (= 8.1.3.1)
+    activerecord (8.1.3.1)
+      activemodel (= 8.1.3.1)
+      activesupport (= 8.1.3.1)
       timeout (>= 0.4.0)
-    activesupport (8.1.3)
+    activesupport (8.1.3.1)
       base64
       bigdecimal
       concurrent-ruby (~> 1.0, >= 1.3.1)
@@ -63,7 +63,7 @@ GEM
       prism (>= 1.3.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    json (2.21.1)
+    json (2.21.2)
     language_server-protocol (3.17.0.6)
     lint_roller (1.1.0)
     logger (1.7.0)
@@ -89,7 +89,7 @@ GEM
       racc (~> 1.4)
     nokogiri (1.19.4-x86_64-linux-musl)
       racc (~> 1.4)
-    openai (0.71.0)
+    openai (0.77.0)
       base64
       cgi
       connection_pool
@@ -115,7 +115,7 @@ GEM
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.4.2)
-    rbs (4.0.3)
+    rbs (4.1.2)
       logger
       prism (>= 1.6.0)
       tsort
@@ -141,7 +141,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.7)
-    rubocop (1.88.2)
+    rubocop (1.89.0)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -168,7 +168,7 @@ GEM
       faraday-multipart (>= 1)
     ruby-progressbar (1.13.0)
     securerandom (0.4.1)
-    sequel (5.106.0)
+    sequel (5.107.0)
       bigdecimal
     sqlite3 (2.9.5-aarch64-linux-gnu)
     sqlite3 (2.9.5-aarch64-linux-musl)

data/docs/boxcars_guide.md

@@ -39,7 +39,8 @@ Use a Rails initializer for defaults, then call Boxcars from normal service obje
 ```ruby
 # config/initializers/boxcars.rb
 Boxcars.configure do |config|
-  config.default_model = "gpt-5-mini"
+  config.default_model = "gpt-5.6-luna"
+  config.default_model_options = { reasoning_effort: "high" }
   config.log_prompts = Rails.env.development?
 end
 ```
@@ -279,24 +280,47 @@ If you need a softer rollout during migration, use `json_schema_strict: false` a
 
 #### Global Configuration
 
-Set a global default model used by `Boxcars::Engines.engine()` when no model is specified:
+Set a global default model and options used by `Boxcars::Engines.engine()` and
+`Boxcars::Engines.json_engine()` when no model is specified:
 
 ```ruby
-# Set the default model globally
-Boxcars.configuration.default_model = "gpt-4o"
+Boxcars.configure do |config|
+  config.default_model = "gpt-5.6-luna"
+  config.default_model_options = { reasoning_effort: "high" }
+end
+
+# Uses gpt-5.6-luna with reasoning_effort: "high"
+engine = Boxcars::Engines.engine
+```
+
+`default_model_options` defaults to an empty hash. Options passed directly to
+the factory override configured defaults:
 
-# Now all engines created without specifying a model will use GPT-4o
-engine = Boxcars::Engines.engine  # Uses gpt-4o
-calc = Boxcars::Calculator.new    # Uses gpt-4o via default engine
+```ruby
+# Uses reasoning_effort: "low"
+engine = Boxcars::Engines.engine(reasoning_effort: "low")
 ```
 
+Passing an explicit model bypasses `default_model_options`, preventing options
+intended for one provider or model from leaking into another:
+
+```ruby
+# Uses gpt-4o without the configured reasoning_effort option
+engine = Boxcars::Engines.engine(model: "gpt-4o")
+json_engine = Boxcars::Engines.json_engine(model: "gpt-4o")
+```
+
+For `json_engine`, the helper's JSON-specific defaults and explicit call options
+take precedence over `default_model_options`.
+
 #### Configuration Block
 
 ```ruby
 Boxcars.configure do |config|
-  config.default_model = "sonnet"  # Use Claude Sonnet as default
-  config.logger = Rails.logger     # Set custom logger
-  config.log_prompts = true        # Enable prompt logging
+  config.default_model = "gpt-5.6-luna"
+  config.default_model_options = { reasoning_effort: "high" }
+  config.logger = Rails.logger  # Set custom logger
+  config.log_prompts = true     # Enable prompt logging
 end
 ```
 
@@ -334,6 +358,10 @@ end
 2. **Global configuration**: `Boxcars.configuration.default_model`
 3. **Built-in default**: `"gemini-2.5-flash"`
 
+When no model is passed, configured `default_model_options` are merged with the
+call's options, with call options winning. When a model is passed explicitly,
+configured default options are not merged.
+
 #### Supported Model Aliases for default_model
 
 ```ruby

data/lib/boxcars/engines.rb

@@ -40,6 +40,7 @@ module Boxcars
     # @param kw_args [Hash] Additional arguments to pass to the engine
     # @return [Boxcars::Engine] An instance of the appropriate engine class
     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}" }

data/lib/boxcars/version.rb

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

data/lib/boxcars.rb

@@ -29,13 +29,14 @@ 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,
-                  :observability_backend, :strict_deprecated_model_aliases
+                  :default_model_options, :observability_backend, :strict_deprecated_model_aliases
 
     def initialize
       @organization_id = nil
       @logger = Rails.logger if defined?(Rails)
       @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)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: boxcars
 version: !ruby/object:Gem::Version
-  version: 0.10.12
+  version: 0.10.13
 platform: ruby
 authors:
 - Francis Sullivan