ruby_llm-codex 0.2.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 60eb34388c3f961cfbfa0604dfc757b407b781108bf9b33c1280bbb07c4a76e4
-  data.tar.gz: 5c4c9e0a38ced5c2bfd8d67cad4d135100bc55f4107479fcea3bb3e0cca37bfc
+  metadata.gz: dd8ce8fd8d9ea9084dd8a54f70e7aac4a790a74ea932820d77466f2eee87c660
+  data.tar.gz: 46a28a66dd5c527e31be3b86fc007edd4e9de6a5182aab124dc535f4025f8718
 SHA512:
-  metadata.gz: b22b44093a68b3c5d9c9c73fe533ef304d1aa7aa2408ede897940b78fc2cf2e23953237de4107b3a95f56a3b25cc72a06b9a2d67d554e7c81a968b5854d3122a
-  data.tar.gz: f6db93982d737c0769485f00c15c05ce48f182b394b594ea87bf2426add6e0f25eacca7e876ada5abdd8020a809ffe029193ee018bdc360929f7f2d6f310a173
+  metadata.gz: bc3d9164ed7f97cd26e22c259342df7bd870252a0c82306f9344dd6d9891f409c2604dee8a2e542c36454fb9fedbec87a88fde0d5d24f1db6b9ba00d2be481b5
+  data.tar.gz: bc03eb41c6baffa0c88872dd229d7f6dcb3b99adbfcaa7010fb94d9469bcae28cc76cc8641f7da45995221e9d83d73183ca8e49d5a8b050b950dffe2361f1f0c

data/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.0] - 2026-11-04
+
+
+### Added
+
+- require Ruby 4 and adopt Gemkit
+
+
+
+## [0.3.0] - 2026-10-12
+
+
+### feat
+
+- migrate Codex provider to RubyLLM 2.1
+
+
+
 ## [0.2.1] - 2026-07-17
 
 

data/README.md

@@ -18,9 +18,9 @@ supported mapping but not an identical wire-level request.
 
 ## Requirements
 
-- Ruby 3.3 or newer
-- RubyLLM 1.16.0 or newer, below 2.0
-- Codex CLI 0.144.5 or newer, available as `codex`
+- Ruby 4.0 or newer
+- RubyLLM 2.1.1 or newer, below 2.2
+- Codex CLI 0.162.1 or newer, available as `codex`
 - Linux or macOS (timeout cleanup relies on POSIX process groups)
 - A completed ChatGPT login: `codex login`
 
@@ -34,6 +34,8 @@ codex login
 Check the model list in your installed Codex version before a large run. Model
 availability depends on the account and currently installed CLI.
 
+For migration steps from RubyLLM 1.x, see [UPGRADE.md](UPGRADE.md).
+
 ## Installation
 
 Add the gem to your application's `Gemfile`:
@@ -55,7 +57,7 @@ Require the gem and use Codex as an explicit RubyLLM provider:
 ```ruby
 require "ruby_llm-codex"
 
-class SummarySchema < RubyLLM::Schema
+class SummarySchema < Schematist::Schema
   string :summary
 end
 
@@ -65,11 +67,11 @@ response = RubyLLM.chat(model: ENV.fetch("CODEX_MODEL"), provider: :codex)
   .with_thinking(effort: :medium)
   .ask("The text to summarize")
 
-pp response.content
+pp response.parsed
 ```
 
-`response.content` is normalized by RubyLLM into the same Hash shape returned
-for structured outputs from its other providers.
+`response.content` contains the JSON string. Read `response.parsed` for the
+structured Hash, and `response.tokens` for token counts.
 
 ## Isolation and reproducibility
 
@@ -97,7 +99,7 @@ saved session history from quietly affecting a request.
 To deliberately let Codex inspect a repository or use selected configuration:
 
 ```ruby
-chat.with_params(
+chat.with_provider_options(
   codex: {
     working_directory: "/path/to/project",
     sandbox: "read-only",
@@ -126,8 +128,8 @@ RubyLLM.configure do |config|
 end
 ```
 
-Only the nested `codex` namespace is accepted by `with_params`; unsupported
-generic params raise an error instead of being silently ignored. Use
+Only the nested `codex` namespace is accepted by `with_provider_options`; unsupported
+generic provider options raise an error instead of being silently ignored. Use
 `with_thinking` for reasoning effort and `with_instructions` for developer
 instructions. Those settings, plus `features.shell_snapshot` and
 `shell_environment_policy.inherit`, are reserved from the arbitrary
@@ -162,95 +164,45 @@ client while keeping the same RubyLLM provider surface.
 - **Local instructions affect output:** keep `ignore_user_config: true` and do
   not set a working directory when you need isolated requests.
 
-## Development
-
-```bash
-git clone https://github.com/ethos-link/ruby_llm-codex.git
-cd ruby_llm-codex
-
-bundle install
-bundle exec rake
-```
-
-To test an unreleased checkout from another application, use a local path in
-that application's `Gemfile`:
-
-```ruby
-gem "ruby_llm-codex", path: "/path/to/ruby_llm-codex"
-```
-
-The default Rake task runs the unit suite and Standard Ruby. CI runs the same
-gate on Ruby 3.3, 3.4, and 4.0.3, then validates commit messages and
-git-cliff changelog generation.
-
-The authenticated smoke task is intentionally separate because it sends real
-requests through the configured Codex account. Choose a model available to that
-account:
+## Contributing
 
-```bash
-CODEX_MODEL=your-model bundle exec rake codex:smoke
-```
+See [CONTRIBUTING.md](CONTRIBUTING.md). By participating, you agree to follow
+the [Code of Conduct](CODE_OF_CONDUCT.md). Security reports should follow
+[SECURITY.md](SECURITY.md), not a public issue.
 
-When changing process lifecycle or shell execution, run that task inside a
-bounded process and memory scope.
+## License
 
-### Git hooks
+MIT License. See [LICENSE](LICENSE).
 
-This repository uses [lefthook](https://lefthook.dev/) and the Ruby
-[commitlint](https://github.com/arandilopez/commitlint) gem. Hooks reject direct
-commits to `main` or `master`, validate Conventional Commit messages, and run
-Standard Ruby.
+## Development and releases
 
-Install them once per clone:
+Shared tooling uses published [Ethos Gemkit](https://github.com/ethos-link/ethos-gemkit).
+Keep the exact Gemfile version and workflow commit pins on the same release.
 
-```bash
+```sh
+bundle install
 bundle exec lefthook install
+bundle exec rake verify
 ```
 
-## Release
-
-Releases are tag-driven. GitHub Actions runs the full test matrix, publishes
-through RubyGems trusted publishing, and creates the GitHub release from
-`CHANGELOG.md`. See [docs/releasing.md](docs/releasing.md) for repository setup,
-the first-release procedure, verification, and recovery guidance.
-
-Install [git-cliff](https://git-cliff.org/) locally, check out a clean `main`,
-and run one of:
-
-```bash
-bundle exec rake 'release:prepare[patch]'
-bundle exec rake 'release:prepare[minor]'
-bundle exec rake 'release:prepare[major]'
-bundle exec rake 'release:prepare[0.2.0]'
-```
-
-For releases after `0.1.0`, the task:
-
-1. Prepends the next changelog section from Conventional Commits.
-2. Updates `lib/ruby_llm/codex/version.rb`.
-3. Commits the release files and creates `vX.Y.Z`.
-4. Pushes `main` and the tag to `origin`.
-
-The initial `0.1.0` release only needs its existing version commit tagged after
-the GitHub environment and pending RubyGems trusted publisher are configured.
+Verification uses a fake Codex executable; it makes no live model requests.
+The optional `codex:smoke` task requires your Codex account, an available
+`CODEX_MODEL` and a bounded process/memory scope.
 
-## Contributing
-
-See [CONTRIBUTING.md](CONTRIBUTING.md). By participating, you agree to follow
-the [Code of Conduct](CODE_OF_CONDUCT.md). Security reports should follow
-[SECURITY.md](SECURITY.md), not a public issue.
-
-## License
-
-MIT License. See [LICENSE](LICENSE).
+From clean, current `main`, run `bundle exec rake 'release:prepare[patch]'`
+(or `minor`, `major`, or an explicit version). Review and merge the generated
+release PR to publish through Actions. Shared prerequisites, registry credentials
+and failed-job recovery are in the [Gemkit release guide](https://github.com/ethos-link/ethos-gemkit#releasing-a-gem).
 
-## About
+## Built by Ethos Link
 
-Made by the team at [Ethos Link](https://www.ethos-link.com) — practical
-software for growing businesses. We build tools for hospitality operators who
-need clear workflows, fast onboarding, and real human support.
+[Ethos Link](https://www.ethos-link.com) builds business software and integrations
+that replace manual handoffs with connected workflows. We help teams automate
+routine work, use their data and improve the processes their business runs on.
 
-We also build [Reviato](https://www.reviato.com), “Capture. Interpret. Act.”.
-Turn guest feedback into clear next steps for your team. Collect private
-appraisals, spot patterns across reviews, and act before small issues turn into
-public ones.
+- [Reviato](https://www.reviato.com): Read public review trends and collect
+  private customer feedback, so your team can decide what to improve.
+- [EthosPlaces](https://www.ethos.place): Give customers the details they need to
+  choose and visit your business, from opening hours to directions.
+- [Nuntio](https://www.nuntiohq.com): Draft, review and schedule social posts in
+  one workspace, then track each publishing result.

data/UPGRADE.md

@@ -0,0 +1,39 @@
+# Upgrade Guide
+
+## 0.4.0
+
+### Shared development and release tooling
+
+Use Ruby 4 and published Gemkit 0.2.0. Install the bundle and hooks, then run the
+project's verification command from the README. Prepare releases from clean,
+current main; merging the generated release PR publishes through Actions.
+See the [Gemkit upgrade guide](https://github.com/ethos-link/ethos-gemkit/blob/main/UPGRADE.md)
+for workflow permissions and registry setup.
+
+
+## RubyLLM 2.1
+
+This provider now requires RubyLLM `~> 2.1.1` and Codex CLI 0.162.1 or newer.
+RubyLLM 1.x and 2.0 are no longer supported. Upgrade the CLI with
+`npm install -g @openai/codex` and check `codex --version`.
+
+Host applications must:
+
+- Replace `with_params(codex: ...)` with `with_provider_options(codex: ...)`.
+- Replace `RubyLLM::Schema` with `Schematist::Schema`.
+- Read structured results through `response.parsed`; `response.content` is
+  now a JSON string.
+- Read the model ID from `response.model` and usage from `response.tokens`:
+  `input`, `output`, `cache_read`, and `thinking`. Input excludes cached tokens;
+  output includes thinking tokens. Unreported counts remain `nil`.
+
+Plain Ruby consumers can update directly after adapting these calls. Rails
+hosts using RubyLLM persistence must complete the
+[2.0 upgrade](https://github.com/crmne/ruby_llm/blob/v2.0.0/docs/_reference/upgrading.md)
+on 2.0, including cleanup, before following the
+[2.1 upgrade](https://rubyllm.com/upgrading/). On Rails below 8.1.4, pin `json`
+to `< 3` before updating.
+
+Each Codex invocation records successful or failed usage attempts in RubyLLM.
+Timeouts cover process exit and pipe draining, including descendants that keep
+output pipes open after the CLI exits. Process-group cleanup remains bounded.

data/lib/ruby_llm/codex/version.rb

@@ -2,6 +2,6 @@
 
 module RubyLLM
   module Codex
-    VERSION = "0.2.1"
+    VERSION = "0.4.0"
   end
 end

data/lib/ruby_llm/providers/codex.rb

@@ -13,6 +13,8 @@ module RubyLLM
     # This provider is deliberately narrow: non-streaming text generation and
     # structured output are supported; RubyLLM tools and attachments are not.
     class Codex < Provider
+      protocol :codex, ::RubyLLM::Protocol
+
       class Error < RubyLLM::Error; end
       class TimeoutError < Error; end
       class UnsupportedFeatureError < Error; end
@@ -20,7 +22,7 @@ module RubyLLM
       DEFAULT_SANDBOX = "read-only"
       DEFAULT_TIMEOUT = 300
       DEFAULT_SHELL_ENVIRONMENT_INHERIT = "none"
-      MINIMUM_CLI_VERSION = "0.144.5"
+      MINIMUM_CLI_VERSION = "0.162.1"
       RESERVED_CONFIG_KEYS = %w[
         developer_instructions
         features.shell_snapshot
@@ -37,11 +39,23 @@ module RubyLLM
       end
 
       # rubocop:disable Metrics/ParameterLists
-      def complete(messages, tools:, temperature:, model:, params: {}, headers: {},
-        schema: nil, thinking: nil, tool_prefs: nil, &stream)
+      def complete(messages, tools:, temperature:, model:, provider_options: {}, headers: {},
+        schema: nil, thinking: nil, tool_prefs: nil, max_output_tokens: nil,
+        citations: false, caching: nil, protocol: nil, before_request: [],
+        usage_recorder: nil, provider_tools: [], compaction: nil, end_user: nil, &stream)
         validate_request!(tools:, temperature:, headers:, stream:)
 
-        options = codex_options(params)
+        unsupported = {
+          max_output_tokens:, citations: citations || nil, caching:,
+          provider_tools: provider_tools.empty? ? nil : provider_tools,
+          compaction:, end_user:, tool_prefs: (tool_prefs if tool_prefs&.values&.any?)
+        }.compact
+        unless unsupported.empty?
+          raise UnsupportedFeatureError,
+            "Unsupported Codex request options: #{unsupported.keys.join(", ")}"
+        end
+
+        options = codex_options(provider_options)
         developer_instructions, prompt = build_prompt(messages)
         request = {
           model: model.id,
@@ -51,9 +65,22 @@ module RubyLLM
           thinking:
         }
 
+        before_request.each { |hook| hook.call(request) }
+        tracker = Accounting::Usage::Tracker.new(
+          operation: :chat, provider: self, model:, config: @config, on_finish: usage_recorder
+        )
         with_working_directory(options) do |working_directory|
-          run_codex(request, working_directory:, options:)
+          ensure_cli_compatible!(working_directory, options)
+          tracker.start
+          response = run_codex(request, working_directory:, options:)
+          tracker.succeed(response)
         end
+      rescue Errno::ENOENT => error
+        tracker&.fail_pending(error)
+        raise Error, "Could not execute Codex CLI: #{error.message}. Install it or set codex_cli_path."
+      rescue => error
+        tracker&.fail_pending(error)
+        raise
       end
       # rubocop:enable Metrics/ParameterLists
 
@@ -109,11 +136,11 @@ module RubyLLM
           "Per-request HTTP headers do not apply to the local Codex provider"
       end
 
-      def codex_options(params)
-        validate_params!(params)
-        raw = params.is_a?(Hash) ? (params[:codex] || params["codex"] || {}) : {}
+      def codex_options(provider_options)
+        validate_provider_options!(provider_options)
+        raw = provider_options.is_a?(Hash) ? (provider_options[:codex] || provider_options["codex"] || {}) : {}
         unless raw.is_a?(Hash)
-          raise ArgumentError, "Codex params must be a Hash"
+          raise ArgumentError, "Codex provider_options must be a Hash"
         end
 
         raw = raw.transform_keys(&:to_sym)
@@ -144,16 +171,16 @@ module RubyLLM
         }
       end
 
-      def validate_params!(params)
-        unless params.is_a?(Hash)
-          raise ArgumentError, "RubyLLM params must be a Hash"
+      def validate_provider_options!(provider_options)
+        unless provider_options.is_a?(Hash)
+          raise ArgumentError, "RubyLLM provider_options must be a Hash"
         end
 
-        unsupported = params.keys.reject { |key| key.to_s == "codex" }
+        unsupported = provider_options.keys.reject { |key| key.to_s == "codex" }
         return if unsupported.empty?
 
         raise UnsupportedFeatureError,
-          "Unsupported params for the local Codex provider: #{unsupported.map(&:inspect).join(", ")}"
+          "Unsupported provider_options for the local Codex provider: #{unsupported.map(&:inspect).join(", ")}"
       end
 
       def validate_config!(config)
@@ -168,7 +195,7 @@ module RubyLLM
         value = raw.key?(:timeout) ? raw[:timeout] : @config.codex_timeout
         value = DEFAULT_TIMEOUT if value.nil?
         timeout = Float(value)
-        raise ArgumentError, "Codex timeout must be greater than zero" unless timeout.positive?
+        raise ArgumentError, "Codex timeout must be greater than zero" unless timeout.finite? && timeout.positive?
 
         timeout
       rescue TypeError, ArgumentError
@@ -200,8 +227,6 @@ module RubyLLM
       end
 
       def run_codex(request, working_directory:, options:)
-        ensure_cli_compatible!(working_directory, options)
-
         Tempfile.create(["ruby-llm-codex-output-", ".txt"]) do |output_file|
           with_schema_file(request[:schema]) do |schema_path|
             output_file.close
@@ -295,7 +320,7 @@ module RubyLLM
           chdir: working_directory,
           pgroup: true
         )
-        threads << writer = Thread.new do
+        threads << Thread.new do
           stdin.write(prompt)
         rescue Errno::EPIPE, IOError
           nil
@@ -306,12 +331,15 @@ module RubyLLM
         threads << stderr_reader = Thread.new { stderr.read }
         threads.each { |thread| thread.report_on_exception = false }
 
-        unless wait_thread.join(options[:timeout])
-          terminate_process_group(wait_thread)
-          raise TimeoutError, "Codex CLI timed out after #{options[:timeout]} seconds"
+        deadline = Process.clock_gettime(Process::CLOCK_MONOTONIC) + options[:timeout]
+        [wait_thread, *threads].each do |thread|
+          remaining = deadline - Process.clock_gettime(Process::CLOCK_MONOTONIC)
+          unless thread.join([remaining, 0].max)
+            terminate_process_group(wait_thread, threads)
+            raise TimeoutError, "Codex CLI timed out after #{options[:timeout]} seconds"
+          end
         end
 
-        writer.join
         [stdout_reader.value, stderr_reader.value, wait_thread.value]
       ensure
         [stdin, stdout, stderr].compact.each do |io|
@@ -322,10 +350,13 @@ module RubyLLM
         threads.each { |thread| thread.kill if thread.alive? }
       end
 
-      def terminate_process_group(wait_thread)
+      def terminate_process_group(wait_thread, threads)
         Process.kill("TERM", -wait_thread.pid)
-        return if wait_thread.join(2)
-
+        deadline = Process.clock_gettime(Process::CLOCK_MONOTONIC) + 2
+        [wait_thread, *threads].each do |thread|
+          remaining = deadline - Process.clock_gettime(Process::CLOCK_MONOTONIC)
+          thread.join([remaining, 0].max)
+        end
         Process.kill("KILL", -wait_thread.pid)
         wait_thread.join
       rescue Errno::ESRCH, Errno::ECHILD
@@ -335,7 +366,7 @@ module RubyLLM
       def add_reasoning_config(command, thinking)
         return unless thinking
 
-        effort = thinking.respond_to?(:effort) ? thinking.effort : thinking
+        effort = thinking.effort
         if effort
           add_config(command, "model_reasoning_effort", effort.to_s)
           return
@@ -387,7 +418,7 @@ module RubyLLM
       end
 
       def raise_invocation_error!(status, events, stderr)
-        event = events.reverse.find { |item| %w[turn.failed error].include?(item["type"]) }
+        event = events.rfind { |item| %w[turn.failed error].include?(item["type"]) }
         detail = event && (event["message"] || event["error"] || event).to_s
         detail = stderr.strip if detail.to_s.strip.empty?
         detail = "Codex exited with status #{status.exitstatus}" if detail.to_s.strip.empty?
@@ -395,14 +426,14 @@ module RubyLLM
       end
 
       def final_agent_message(events)
-        event = events.reverse.find do |item|
+        event = events.rfind do |item|
           item["type"] == "item.completed" && item.dig("item", "type") == "agent_message"
         end
         event&.dig("item", "text")
       end
 
       def build_message(content, model, events, stderr)
-        usage = events.reverse.find { |event| event["type"] == "turn.completed" }&.fetch("usage", {}) || {}
+        usage = events.rfind { |event| event["type"] == "turn.completed" }&.fetch("usage", {}) || {}
         cached = integer_or_nil(usage["cached_input_tokens"])
         total_input = integer_or_nil(usage["input_tokens"])
         uncached_input = total_input && [total_input - cached.to_i, 0].max
@@ -410,11 +441,14 @@ module RubyLLM
         Message.new(
           role: :assistant,
           content: content,
-          model_id: model,
-          input_tokens: uncached_input,
-          cached_tokens: cached,
-          output_tokens: integer_or_nil(usage["output_tokens"]),
-          thinking_tokens: integer_or_nil(usage["reasoning_output_tokens"]),
+          model:,
+          tokens: Tokens.new(
+            input: uncached_input,
+            cache_read: cached,
+            output: integer_or_nil(usage["output_tokens"]),
+            thinking: integer_or_nil(usage["reasoning_output_tokens"])
+          ),
+          finish_reason: :stop,
           raw: {events:, stderr: stderr.empty? ? nil : stderr}
         )
       end
@@ -449,23 +483,12 @@ module RubyLLM
       end
 
       def text_content(message)
-        content = message.content
-        return content if content.is_a?(String)
-
-        if content.is_a?(RubyLLM::Content)
-          unless content.attachments.empty?
-            raise UnsupportedFeatureError,
-              "Attachments are not supported by the Codex comparison provider"
-          end
-          return content.text.to_s
-        end
-
-        if defined?(RubyLLM::Content::Raw) && content.is_a?(RubyLLM::Content::Raw)
+        unless message.attachments.empty?
           raise UnsupportedFeatureError,
-            "Raw provider content is not supported by the Codex comparison provider"
+            "Attachments are not supported by the Codex comparison provider"
         end
 
-        content.respond_to?(:to_json) ? content.to_json : content.to_s
+        message.content
       end
 
       def present?(value)

data/lib/ruby_llm-codex.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "ruby_llm"
-require "ruby_llm/schema"
 require_relative "ruby_llm/codex/version"
 require_relative "ruby_llm/providers/codex"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_llm-codex
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Paulo Fidalgo
@@ -14,22 +14,16 @@ dependencies:
   name: ruby_llm
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '1.16'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.1.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '1.16'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.1.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -44,34 +38,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13'
-- !ruby/object:Gem::Dependency
-  name: standard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
 description: |-
   A RubyLLM provider that invokes the official Codex CLI, reuses local ChatGPT
   authentication, and maps RubyLLM structured-output schemas to Codex output
@@ -85,6 +51,7 @@ files:
 - CHANGELOG.md
 - LICENSE
 - README.md
+- UPGRADE.md
 - lib/ruby_llm-codex.rb
 - lib/ruby_llm/codex/version.rb
 - lib/ruby_llm/providers/codex.rb
@@ -108,14 +75,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.3.0
+      version: '4.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Use a local, ChatGPT-authenticated Codex CLI as a RubyLLM provider
 test_files: []