dspy-openai 1.0.2 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e1d8fbfeab5565e4ef4847257b2e82aca7468beb11b5c3e179504fef3669ffb3
-  data.tar.gz: 95b61be39388a3cf2acfd7d74b397ec1b24dac2343932e6476830b870fbb3e88
+  metadata.gz: 40eb2bc2c132320aa8d90a64c64601dba7c4b711355f640c1aa5b92020b56699
+  data.tar.gz: b501f4eb22ec635b0be129602ed84fc20340b009d83251ba479379a970267b2f
 SHA512:
-  metadata.gz: ac0af9799be8627cab6f81127a3c15807bf884ad93cdc912342caae1c95b1f61d337df59cbaf84879c05ea8d5d8f6c5ad560a590807a604c591b247f8ff3f5a0
-  data.tar.gz: 662a5b2430a3eeaad636e4b7adeeedb32b657c367a49d6ad863ef0808bd4b27fd8a5793649e2fea3300812822455fbd9a03652830dbdd16ecb9b292b12c0217a
+  metadata.gz: 559d3f26f3e63a93048763151e7c542e52d0a0da29380805cedb3894579bc708fbbdd3c6ea5e748a06e80ea9746e0c12081ad8e08d8b25d966c7109ddb3c3727
+  data.tar.gz: 13de448698cde83f428400cb7cf24b81ee582eeedd13ba046f1db98572cd23305a0ac2c7dc9aad84322083a424570a8a30c12e5113998e43d8ab2f2d44869ecf

data/README.md

@@ -9,6 +9,7 @@
 **Build reliable LLM applications in idiomatic Ruby using composable, type-safe modules.**
 
 DSPy.rb is the Ruby port of Stanford's [DSPy](https://dspy.ai). Instead of wrestling with brittle prompt strings, you define typed signatures and let the framework handle the rest. Prompts become functions. LLM calls become predictable.
+The `1.x` line is the stable release track for production Ruby LLM applications.
 
 ```ruby
 require 'dspy'
@@ -137,26 +138,18 @@ result.answer     # => "60 km/h"
 Build agents that use tools to accomplish tasks:
 
 ```ruby
-class SearchTool < DSPy::Tools::Tool
+class SearchTool < DSPy::Tools::Base
   tool_name "search"
-  description "Search for information"
-
-  input do
-    const :query, String
-  end
-
-  output do
-    const :results, T::Array[String]
-  end
+  tool_description "Search for information"
 
+  sig { params(query: String).returns(String) }
   def call(query:)
     # Your search implementation
-    { results: ["Result 1", "Result 2"] }
+    "Result 1, Result 2"
   end
 end
 
-toolset = DSPy::Tools::Toolset.new(tools: [SearchTool.new])
-agent = DSPy::ReAct.new(signature: ResearchTask, tools: toolset, max_iterations: 5)
+agent = DSPy::ReAct.new(ResearchTask, tools: [SearchTool.new], max_iterations: 5)
 result = agent.call(question: "What's the latest on Ruby 3.4?")
 ```
 
@@ -185,8 +178,8 @@ result = agent.call(question: "What's the latest on Ruby 3.4?")
 A [Claude Skill](https://github.com/vicentereig/dspy-rb-skill) is available to help you build DSPy.rb applications:
 
 ```bash
-# Claude Code
-git clone https://github.com/vicentereig/dspy-rb-skill ~/.claude/skills/dspy-rb
+# Claude Code — install from the vicentereig/engineering marketplace
+claude install-skill vicentereig/engineering --skill dspy-rb
 ```
 
 For Claude.ai Pro/Max, download the [skill ZIP](https://github.com/vicentereig/dspy-rb-skill/archive/refs/heads/main.zip) and upload via Settings > Skills.
@@ -201,7 +194,7 @@ The [examples/](examples/) directory has runnable code for common patterns:
 - Prompt optimization
 
 ```bash
-bundle exec ruby examples/first_predictor.rb
+bundle exec ruby examples/basic_search_agent.rb
 ```
 
 ## Optional Gems

data/lib/dspy/openai/lm/adapters/openai_adapter.rb

@@ -5,9 +5,6 @@ require_relative '../schema_converter'
 require 'dspy/lm/vision_models'
 require 'dspy/lm/adapter'
 
-require 'dspy/openai/guardrails'
-DSPy::OpenAI::Guardrails.ensure_openai_installed!
-
 module DSPy
   module OpenAI
     module LM
@@ -26,7 +23,9 @@ module DSPy
             # Validate vision support if images are present
             if contains_images?(normalized_messages)
               DSPy::LM::VisionModels.validate_vision_support!('openai', model)
-              # Convert messages to OpenAI format with proper image handling
+            end
+
+            if contains_media?(normalized_messages)
               normalized_messages = format_multimodal_messages(normalized_messages, 'openai')
             end
 

data/lib/dspy/openai/version.rb

@@ -2,6 +2,6 @@
 
 module DSPy
   module OpenAI
-    VERSION = '1.0.2'
+    VERSION = '1.0.3'
   end
 end

data/lib/dspy/openai.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
 require 'dspy/openai/version'
-
-require 'dspy/openai/guardrails'
-DSPy::OpenAI::Guardrails.ensure_openai_installed!
+require 'dspy/support/openai_sdk_warning'
 
 require 'dspy/openai/lm/adapters/openai_adapter'
 require 'dspy/openai/lm/adapters/ollama_adapter'
 require 'dspy/openai/lm/adapters/openrouter_adapter'
 require 'dspy/openai/lm/schema_converter'
+
+DSPy::Support::OpenAISDKWarning.warn_if_community_gem_loaded!

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dspy-openai
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.3
 platform: ruby
 authors:
 - Vicente Reig Rincón de Arellano
@@ -15,28 +15,40 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.30'
+        version: 0.30.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.30'
+        version: 0.30.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: openai
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.57.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.57.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 description: Provides the OpenAI plus the Ollama and OpenRouter adapters so OpenAI-compatible
   providers can be added to DSPy.rb projects independently of the core gem.
 email:
@@ -49,7 +61,6 @@ files:
 - README.md
 - lib/dspy/openai.rb
 - lib/dspy/openai/README.md
-- lib/dspy/openai/guardrails.rb
 - lib/dspy/openai/lm/adapters/ollama_adapter.rb
 - lib/dspy/openai/lm/adapters/openai_adapter.rb
 - lib/dspy/openai/lm/adapters/openrouter_adapter.rb

data/lib/dspy/openai/guardrails.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-require 'dspy/lm/errors'
-
-module DSPy
-  module OpenAI
-    class Guardrails
-      SUPPORTED_OPENAI_VERSIONS = "~> 0.17".freeze
-
-      def self.ensure_openai_installed!
-        require 'openai'
-
-        spec = Gem.loaded_specs["openai"] 
-        unless spec && Gem::Requirement.new(SUPPORTED_OPENAI_VERSIONS).satisfied_by?(spec.version)
-          msg = <<~MSG
-            DSPY requires the official `openai` gem #{SUPPORTED_OPENAI_VERSIONS}.
-            Please install or upgrade it with `bundle add openai --version "#{SUPPORTED_OPENAI_VERSIONS}"`.
-          MSG
-          raise DSPy::LM::UnsupportedVersionError, msg
-        end
-
-        if Gem.loaded_specs["ruby-openai"]
-          msg = <<~MSG
-            DSPy uses the official `openai` gem.
-            Please remove the `ruby-openai` gem to avoid namespace conflicts.
-          MSG
-          raise DSPy::LM::MissingOfficialSDKError, msg
-        end
-      end
-    end
-  end
-end