riffer 0.47.0 → 0.47.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63cc9b38354166dc44a162e7fb8cc168cf14e950d8cbbba582fb9710721c25a5
-  data.tar.gz: 8a386abc38526d731d7253efbab2c8e2ab345da712762d605f469c5708ec5cca
+  metadata.gz: 4ac69c8c20b892c53242b0fb792aee2ee1ce5da1ab02b1c53536fa8d1c006f08
+  data.tar.gz: 0fa02ebc739e1968167e517a41d4f0a2cabff5a5845862ac78980d207638c6cd
 SHA512:
-  metadata.gz: 9a36b54ef99b21ea74a8e215c3ba5abb70c2bf949e40bf15056209f9cc4875c62505406568fc5a258508d17735a5d92c360510a5092a4f158733feebd6f64fb4
-  data.tar.gz: 69209c501af21331079d0e5374b4b41119619ddd81afa6debeb8e93da3955bb144370cb3c1b506411043de9544f070855c66ef62819d5affadc3d671410b906f
+  metadata.gz: 5c0363ce9dad27ccfc899d6c7f4e71123eaa9ae5ceec8e50387575f0642c7696f07de37cb987c45099aee999fe5ac39c8635f07f36efb784c3341bd8a4c6a6aa
+  data.tar.gz: 4b5d6209255a46d9abd52275021709740bf0e87676c20c3bd9240f12acddc7768a050391530970c2a2ed407dbdd27fb50a1b03e43caff8361ad6f28cc67884db

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.47.0"
+  ".": "0.47.1"
 }

data/CHANGELOG.md

@@ -5,6 +5,14 @@ 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.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.47.1](https://github.com/janeapp/riffer/compare/riffer/v0.47.0...riffer/v0.47.1) (2026-09-11)
+
+
+### Bug Fixes
+
+* **params:** keep optional Hash params nullable in strict JSON Schema ([#433](https://github.com/janeapp/riffer/issues/433)) ([c7308fd](https://github.com/janeapp/riffer/commit/c7308fd15a3293877510e74c41662a68fac942df))
+* **params:** raise for bare Hash and Array params under strict schemas ([#434](https://github.com/janeapp/riffer/issues/434)) ([174ad92](https://github.com/janeapp/riffer/commit/174ad92e7c765dc8833695ded9d2920f1ab27337))
+
 ## [0.47.0](https://github.com/janeapp/riffer/compare/riffer/v0.46.1...riffer/v0.47.0) (2026-09-11)
 
 

data/docs/AGENTS.md

@@ -247,7 +247,7 @@ end
 
 #### Limitations
 
-Using both `of:` and a block raises `Riffer::ArgumentError`. Using `of:` with a non-primitive type (e.g. `of: Hash`) also raises `Riffer::ArgumentError`.
+A `Hash` param requires a block, and an `Array` param requires a block or `of:`. Using both `of:` and a block raises `Riffer::ArgumentError`. Using `of:` with a non-primitive type (e.g. `of: Hash`) also raises `Riffer::ArgumentError`.
 
 Structured output is not compatible with streaming — calling `stream` on an agent with structured output configured raises `Riffer::ArgumentError`.
 

data/lib/riffer/params/param.rb

@@ -140,10 +140,14 @@ class Riffer::Params::Param
   # params are made nullable (<tt>["type", "null"]</tt>) so strict providers
   # distinguish absent from present; optional params with an +enum+ use +anyOf+
   # instead, since providers like Anthropic reject
-  # <tt>{"type": ["string", "null"], "enum": [...]}</tt>.
+  # <tt>{"type": ["string", "null"], "enum": [...]}</tt>. Raises
+  # Riffer::ArgumentError when +strict+ and a Hash param has no block or an
+  # Array param has neither a block nor <tt>of:</tt>, since strict providers
+  # reject objects without +properties+ and arrays without +items+.
   #--
   #: (?strict: bool) -> Hash[Symbol, untyped]
   def to_json_schema(strict: false)
+    validate_strict_shape! if strict
     nullable = strict && !required
 
     if nullable && enum
@@ -168,9 +172,24 @@ class Riffer::Params::Param
     elsif self.type == Array && item_type
       schema[:items] = { type: TYPE_MAPPINGS[item_type] }
     elsif self.type == Hash && nested_params
-      schema.merge!(nested_params.to_json_schema(strict: strict))
+      # The nested schema carries its own type: "object", which would clobber a nullable union.
+      schema.merge!(nested_params.to_json_schema(strict: strict).except(:type))
     end
 
     schema
   end
+
+  private
+
+  #--
+  #: () -> void
+  def validate_strict_shape!
+    if type == Hash && nested_params.nil?
+      raise Riffer::ArgumentError,
+            "#{name}: a Hash param requires a block defining its properties under strict schemas"
+    elsif type == Array && nested_params.nil? && item_type.nil?
+      raise Riffer::ArgumentError,
+            "#{name}: an Array param requires a block or of: defining its items under strict schemas"
+    end
+  end
 end

data/lib/riffer/params.rb

@@ -128,6 +128,8 @@ class Riffer::Params
   # Converts all parameters to JSON Schema format. When +strict+ is true, every
   # property is listed in +required+ and optional ones are made nullable
   # instead, satisfying providers that enforce strict structured output schemas.
+  # Raises Riffer::ArgumentError when +strict+ and a Hash param (at any depth)
+  # has no block or an Array param has neither a block nor <tt>of:</tt>.
   #--
   #: (?strict: bool) -> Hash[Symbol, untyped]
   def to_json_schema(strict: false)

data/lib/riffer/version.rb

@@ -2,5 +2,5 @@
 # rbs_inline: enabled
 
 module Riffer
-  VERSION = "0.47.0" #: String
+  VERSION = "0.47.1" #: String
 end

data/sig/generated/riffer/params/param.rbs

@@ -74,8 +74,17 @@ class Riffer::Params::Param
   # params are made nullable (<tt>["type", "null"]</tt>) so strict providers
   # distinguish absent from present; optional params with an +enum+ use +anyOf+
   # instead, since providers like Anthropic reject
-  # <tt>{"type": ["string", "null"], "enum": [...]}</tt>.
+  # <tt>{"type": ["string", "null"], "enum": [...]}</tt>. Raises
+  # Riffer::ArgumentError when +strict+ and a Hash param has no block or an
+  # Array param has neither a block nor <tt>of:</tt>, since strict providers
+  # reject objects without +properties+ and arrays without +items+.
   # --
   # : (?strict: bool) -> Hash[Symbol, untyped]
   def to_json_schema: (?strict: bool) -> Hash[Symbol, untyped]
+
+  private
+
+  # --
+  # : () -> void
+  def validate_strict_shape!: () -> void
 end

data/sig/generated/riffer/params.rbs

@@ -54,6 +54,8 @@ class Riffer::Params
   # Converts all parameters to JSON Schema format. When +strict+ is true, every
   # property is listed in +required+ and optional ones are made nullable
   # instead, satisfying providers that enforce strict structured output schemas.
+  # Raises Riffer::ArgumentError when +strict+ and a Hash param (at any depth)
+  # has no block or an Array param has neither a block nor <tt>of:</tt>.
   # --
   # : (?strict: bool) -> Hash[Symbol, untyped]
   def to_json_schema: (?strict: bool) -> Hash[Symbol, untyped]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: riffer
 version: !ruby/object:Gem::Version
-  version: 0.47.0
+  version: 0.47.1
 platform: ruby
 authors:
 - Jake Bottrall