dspy 0.6.3 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae1673ad31bc71e2573800124ebb74ea807cd94a1c14b9b58f3de94b7f62363a
-  data.tar.gz: f52d96924b536e5941ff34b45f1080ddb08dc9243095df51f11352cb65979ba1
+  metadata.gz: 44671af9a40e3f452983f616a3df0770babbe5d9cde85c18c9ace6fe618fcfe5
+  data.tar.gz: e3ba107fed63ba58dfa9b3f707d682acc88a6e7a1c8a72a89a46fbb19c82347c
 SHA512:
-  metadata.gz: 98f1d7b285f9342b8dfc82cdc7606d2a4c8cbdb1df86713b7176a389893f7c652e7c5df473ddcf42335ab37a2cfffe35e9519310b45be396c9bfe8847c7fabc1
-  data.tar.gz: cbee70fb3afc5b5b7dce3caf2efbca258d5cbd12680f950fe52be30bd84754369b620c21617315c04a62e2f982fe485b0c05f7ed30676007c19527715c3fc9c0
+  metadata.gz: bda31c209ff68af39500de5b8f562fb173e08a5fc41863cd96b89f4f0e8be62cadbc73fc31fc61567d8d8e2e0afce86e4710028fbdeba8a4e6709811be73c754
+  data.tar.gz: a4823fcc2341684b7c0b98b00e2c7dbe9847b61d3b3fde69e3cd31767478659e75fd8c432be6de44290a557f30e382836f671e7fe83edc0cab07f037ab2f6e7c

data/lib/dspy/lm/adapter.rb

@@ -24,7 +24,12 @@ module DSPy
 
       def validate_configuration!
         raise ConfigurationError, "Model is required" if model.nil? || model.empty?
-        raise ConfigurationError, "API key is required" if api_key.nil? || api_key.empty?
+      end
+
+      def validate_api_key!(api_key, provider)
+        if api_key.nil? || api_key.to_s.strip.empty?
+          raise MissingAPIKeyError.new(provider)
+        end
       end
 
       # Helper method to normalize message format

data/lib/dspy/lm/adapters/anthropic_adapter.rb

@@ -7,6 +7,7 @@ module DSPy
     class AnthropicAdapter < Adapter
       def initialize(model:, api_key:)
         super
+        validate_api_key!(api_key, 'anthropic')
         @client = Anthropic::Client.new(api_key: api_key)
       end
 

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

@@ -7,6 +7,7 @@ module DSPy
     class OpenAIAdapter < Adapter
       def initialize(model:, api_key:)
         super
+        validate_api_key!(api_key, 'openai')
         @client = OpenAI::Client.new(api_key: api_key)
       end
 

data/lib/dspy/lm/errors.rb

@@ -6,5 +6,18 @@ module DSPy
     class AdapterError < Error; end
     class UnsupportedProviderError < Error; end
     class ConfigurationError < Error; end
+    
+    # Raised when API key is missing or invalid
+    class MissingAPIKeyError < Error
+      def initialize(provider)
+        env_var = case provider
+                  when 'openai' then 'OPENAI_API_KEY'
+                  when 'anthropic' then 'ANTHROPIC_API_KEY'
+                  else "#{provider.upcase}_API_KEY"
+                  end
+        
+        super("API key is required but was not provided. Set it via the api_key parameter or #{env_var} environment variable.")
+      end
+    end
   end
 end

data/lib/dspy/predict.rb

@@ -115,6 +115,9 @@ module DSPy
       output_attributes = output_attributes.transform_keys(&:to_sym)
       output_props = @signature_class.output_struct_class.props
       
+      # Apply defaults for missing fields
+      output_attributes = apply_defaults_to_output(output_attributes)
+      
       coerce_output_attributes(output_attributes, output_props)
     end
 
@@ -143,5 +146,22 @@ module DSPy
         output: output_props
       })
     end
+
+    # Applies default values to missing output fields
+    sig { params(output_attributes: T::Hash[Symbol, T.untyped]).returns(T::Hash[Symbol, T.untyped]) }
+    def apply_defaults_to_output(output_attributes)
+      return output_attributes unless @signature_class.respond_to?(:output_field_descriptors)
+      
+      field_descriptors = @signature_class.output_field_descriptors
+      
+      field_descriptors.each do |field_name, descriptor|
+        # Only apply default if field is missing and has a default
+        if !output_attributes.key?(field_name) && descriptor.has_default
+          output_attributes[field_name] = descriptor.default_value
+        end
+      end
+      
+      output_attributes
+    end
   end
 end

data/lib/dspy/signature.rb

@@ -20,11 +20,15 @@ module DSPy
       sig { returns(T::Boolean) }
       attr_reader :has_default
 
-      sig { params(type: T.untyped, description: T.nilable(String), has_default: T::Boolean).void }
-      def initialize(type, description = nil, has_default = false)
+      sig { returns(T.untyped) }
+      attr_reader :default_value
+
+      sig { params(type: T.untyped, description: T.nilable(String), has_default: T::Boolean, default_value: T.untyped).void }
+      def initialize(type, description = nil, has_default = false, default_value = nil)
         @type = type
         @description = description
         @has_default = has_default
+        @default_value = default_value
       end
     end
 
@@ -44,8 +48,8 @@ module DSPy
       def const(name, type, **kwargs)
         description = kwargs[:description]
         has_default = kwargs.key?(:default)
-        @field_descriptors[name] = FieldDescriptor.new(type, description, has_default)
-        # Store default for future use if needed
+        default_value = kwargs[:default]
+        @field_descriptors[name] = FieldDescriptor.new(type, description, has_default, default_value)
       end
 
       sig { returns(T.class_of(T::Struct)) }
@@ -54,7 +58,11 @@ module DSPy
         Class.new(T::Struct) do
           extend T::Sig
           descriptors.each do |name, descriptor|
-            const name, descriptor.type
+            if descriptor.has_default
+              const name, descriptor.type, default: descriptor.default_value
+            else
+              const name, descriptor.type
+            end
           end
         end
       end

data/lib/dspy/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DSPy
-  VERSION = "0.6.3"
+  VERSION = "0.7.0"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: dspy
 version: !ruby/object:Gem::Version
-  version: 0.6.3
+  version: 0.7.0
 platform: ruby
 authors:
 - Vicente Reig Rincón de Arellano
 bindir: bin
 cert_chain: []
-date: 2025-07-08 00:00:00.000000000 Z
+date: 2025-07-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-configurable