riffer 0.52.1 → 0.54.0

data/sig/generated/riffer/params.rbs

@@ -14,12 +14,16 @@ class Riffer::Params
   def self.from_json_schema: (Hash[Symbol, untyped]) -> Riffer::Params
 
   # --
-  # : (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?of: Module?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
-  def required: (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?of: Module?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
+  # : (Symbol, singleton(Riffer::Params::AnyOf), ?description: String?) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
+  # : (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?of: (Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
+  def required: (Symbol, singleton(Riffer::Params::AnyOf), ?description: String?) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
+              | (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?of: (Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
 
   # --
-  # : (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?default: untyped, ?of: Module?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
-  def optional: (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?default: untyped, ?of: Module?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
+  # : (Symbol, singleton(Riffer::Params::AnyOf), ?description: String?, ?default: untyped) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
+  # : (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?of: (Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
+  def optional: (Symbol, singleton(Riffer::Params::AnyOf), ?description: String?, ?default: untyped) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
+              | (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?of: (Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
 
   # --
   # : (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
@@ -38,8 +42,16 @@ class Riffer::Params
   def initialize_copy: (Riffer::Params) -> void
 
   # --
-  # : (Module, Module?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
-  def build_nested: (Module, Module?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
+  # : ((Module | Array[untyped])?, ?Integer) -> [Module?, Integer]
+  def unwrap_of: ((Module | Array[untyped])?, ?Integer) -> [ Module?, Integer ]
+
+  # --
+  # : (Module, Module?, Array[untyped]?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
+  def build_nested: (Module, Module?, Array[untyped]?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
+
+  # --
+  # : ((Module | Array[untyped])?, Array[untyped]?) ?{ (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> Array[Riffer::Params]
+  def build_variants: ((Module | Array[untyped])?, Array[untyped]?) ?{ (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> Array[Riffer::Params]
 
   # --
   # : (Riffer::Params::Param, untyped, Array[String]) -> untyped
@@ -49,13 +61,27 @@ class Riffer::Params
   # : (Riffer::Params::Param, Hash[Symbol, untyped], Array[String]) -> Hash[Symbol, untyped]
   def validate_nested_hash: (Riffer::Params::Param, Hash[Symbol, untyped], Array[String]) -> Hash[Symbol, untyped]
 
+  # --
+  # : (Riffer::Params::Param, Hash[Symbol, untyped], Array[String]) -> Hash[Symbol, untyped]
+  def validate_any_of: (Riffer::Params::Param, Hash[Symbol, untyped], Array[String]) -> Hash[Symbol, untyped]
+
+  # Validation drops keys a Params doesn't declare, at any depth, so they are
+  # the keys in the input that are missing from the output.
+  # --
+  # : (untyped, untyped, ?String?) -> Array[String]
+  def undeclared_keys: (untyped, untyped, ?String?) -> Array[String]
+
   # --
   # : (Riffer::Params::Param, Array[untyped], Array[String]) -> Array[untyped]
   def validate_nested_array_of_objects: (Riffer::Params::Param, Array[untyped], Array[String]) -> Array[untyped]
 
   # --
-  # : (Riffer::Params::Param, Array[untyped], Array[String]) -> Array[untyped]
-  def validate_typed_array: (Riffer::Params::Param, Array[untyped], Array[String]) -> Array[untyped]
+  # : (Riffer::Params::Param, Array[untyped], Array[String], ?String, ?Integer) -> Array[untyped]
+  def validate_typed_array: (Riffer::Params::Param, Array[untyped], Array[String], ?String, ?Integer) -> Array[untyped]
+
+  # --
+  # : (Module, untyped) -> bool
+  def valid_item?: (Module, untyped) -> bool
 
   # --
   # : (Module, untyped) -> untyped

data/sig/generated/riffer/providers/amazon_bedrock.rbs

@@ -36,6 +36,12 @@ class Riffer::Providers::AmazonBedrock < Riffer::Providers::Base
   # : () -> untyped
   def build_client: () -> untyped
 
+  # Claude's fields, since application inference profile ARNs hide the model
+  # family; other families need a catalog entry.
+  # --
+  # : (Symbol) -> Hash[Symbol, untyped]
+  def default_reasoning_options: (Symbol) -> Hash[Symbol, untyped]
+
   # --
   # : (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
   def build_request_params: (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]

data/sig/generated/riffer/providers/anthropic.rbs

@@ -32,6 +32,10 @@ class Riffer::Providers::Anthropic < Riffer::Providers::Base
   # : () -> untyped
   def build_client: () -> untyped
 
+  # --
+  # : (Symbol) -> Hash[Symbol, untyped]
+  def default_reasoning_options: (Symbol) -> Hash[Symbol, untyped]
+
   # --
   # : (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
   def build_request_params: (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]

data/sig/generated/riffer/providers/base.rbs

@@ -76,8 +76,28 @@ class Riffer::Providers::Base
   def apply_pricing: (Riffer::Providers::TokenUsage) -> Riffer::Providers::TokenUsage
 
   # --
-  # : () -> Riffer::Config::Pricing::Rates?
-  def pricing_rates: () -> Riffer::Config::Pricing::Rates?
+  # : () -> Riffer::Catalog::Rates?
+  def pricing_rates: () -> Riffer::Catalog::Rates?
+
+  # --
+  # : (String) -> String?
+  def catalog_key: (String) -> String?
+
+  # A catalog fragment beats the provider default per level; the caller's
+  # options are merged over either, so +model_options+ always wins.
+  # --
+  # : (String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
+  def apply_reasoning: (String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
+
+  # Maps a level onto the provider's own reasoning params when the catalog has
+  # no entry; +nil+ means riffer raises before the request.
+  # --
+  # : (Symbol) -> Hash[Symbol, untyped]?
+  def default_reasoning_options: (Symbol) -> Hash[Symbol, untyped]?
+
+  # --
+  # : (Hash[Symbol, untyped], Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
+  def deep_merge: (Hash[Symbol, untyped], Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
 
   # --
   # : (untyped) -> Riffer::Providers::FinishReason?

data/sig/generated/riffer/providers/gemini.rbs

@@ -23,6 +23,10 @@ class Riffer::Providers::Gemini < Riffer::Providers::Base
   # : () -> untyped
   def build_client: () -> untyped
 
+  # --
+  # : (Symbol) -> Hash[Symbol, untyped]
+  def default_reasoning_options: (Symbol) -> Hash[Symbol, untyped]
+
   # --
   # : (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
   def build_request_params: (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]

data/sig/generated/riffer/providers/mock.rbs

@@ -35,6 +35,11 @@ class Riffer::Providers::Mock < Riffer::Providers::Base
   # : (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
   def normalize_response: (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
 
+  # Never raises, so test suites can set +reasoning+ without catalog entries.
+  # --
+  # : (Symbol) -> Hash[Symbol, untyped]
+  def default_reasoning_options: (Symbol) -> Hash[Symbol, untyped]
+
   # --
   # : (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
   def build_request_params: (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]

data/sig/generated/riffer/providers/open_ai.rbs

@@ -29,6 +29,10 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
   # : () -> untyped
   def build_client: () -> untyped
 
+  # --
+  # : (Symbol) -> Hash[Symbol, untyped]
+  def default_reasoning_options: (Symbol) -> Hash[Symbol, untyped]
+
   # --
   # : (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
   def build_request_params: (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]

data/sig/generated/riffer/providers/open_router.rbs

@@ -34,6 +34,10 @@ class Riffer::Providers::OpenRouter < Riffer::Providers::Base
   # : () -> untyped
   def build_client: () -> untyped
 
+  # --
+  # : (Symbol) -> Hash[Symbol, untyped]
+  def default_reasoning_options: (Symbol) -> Hash[Symbol, untyped]
+
   # --
   # : (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
   def build_request_params: (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]

data/sig/generated/riffer.rbs

@@ -55,6 +55,7 @@ module Riffer
   # : () -> Riffer::Config
   def config: () -> Riffer::Config
 
+  # Builds the catalog after the block, so a bad catalog file fails boot.
   # --
   # : () ?{ (Riffer::Config) -> void } -> void
   def configure: () ?{ (Riffer::Config) -> void } -> void

data/sig/manifest.yaml

@@ -1,4 +1,5 @@
 dependencies:
   - name: uri
   - name: net-http
-  - name: digest
+  - name: digest
+  - name: ipaddr

data/sig/manual/riffer/params/format.rbs

@@ -0,0 +1,5 @@
+# `Riffer::Params::Format` uses `extend self`; rbs-inline doesn't emit that,
+# so re-extend here to expose its instance methods as singleton methods.
+module Riffer::Params::Format
+  extend ::Riffer::Params::Format
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: riffer
 version: !ruby/object:Gem::Version
-  version: 0.52.1
+  version: 0.54.0
 platform: ruby
 authors:
 - Jake Bottrall
@@ -83,6 +83,7 @@ files:
 - docs/AGENTS.md
 - docs/AGENT_LIFECYCLE.md
 - docs/AGENT_LOOP.md
+- docs/CATALOG.md
 - docs/CONFIGURATION.md
 - docs/EVALS.md
 - docs/GETTING_STARTED.md
@@ -119,6 +120,8 @@ files:
 - lib/riffer/agent/structured_output.rb
 - lib/riffer/agent/structured_output/parser.rb
 - lib/riffer/agent/structured_output/result.rb
+- lib/riffer/catalog.rb
+- lib/riffer/catalog/rates.rb
 - lib/riffer/config.rb
 - lib/riffer/config/amazon_bedrock.rb
 - lib/riffer/config/anthropic.rb
@@ -130,7 +133,6 @@ files:
 - lib/riffer/config/open_ai.rb
 - lib/riffer/config/open_router.rb
 - lib/riffer/config/pricing.rb
-- lib/riffer/config/pricing/rates.rb
 - lib/riffer/config/skills.rb
 - lib/riffer/config/tracing.rb
 - lib/riffer/evals.rb
@@ -175,7 +177,9 @@ files:
 - lib/riffer/messages/user.rb
 - lib/riffer/messages/user/file_part.rb
 - lib/riffer/params.rb
+- lib/riffer/params/any_of.rb
 - lib/riffer/params/boolean.rb
+- lib/riffer/params/format.rb
 - lib/riffer/params/param.rb
 - lib/riffer/providers.rb
 - lib/riffer/providers/amazon_bedrock.rb
@@ -268,6 +272,8 @@ files:
 - sig/generated/riffer/agent/structured_output.rbs
 - sig/generated/riffer/agent/structured_output/parser.rbs
 - sig/generated/riffer/agent/structured_output/result.rbs
+- sig/generated/riffer/catalog.rbs
+- sig/generated/riffer/catalog/rates.rbs
 - sig/generated/riffer/config.rbs
 - sig/generated/riffer/config/amazon_bedrock.rbs
 - sig/generated/riffer/config/anthropic.rbs
@@ -279,7 +285,6 @@ files:
 - sig/generated/riffer/config/open_ai.rbs
 - sig/generated/riffer/config/open_router.rbs
 - sig/generated/riffer/config/pricing.rbs
-- sig/generated/riffer/config/pricing/rates.rbs
 - sig/generated/riffer/config/skills.rbs
 - sig/generated/riffer/config/tracing.rbs
 - sig/generated/riffer/evals.rbs
@@ -324,7 +329,9 @@ files:
 - sig/generated/riffer/messages/user.rbs
 - sig/generated/riffer/messages/user/file_part.rbs
 - sig/generated/riffer/params.rbs
+- sig/generated/riffer/params/any_of.rbs
 - sig/generated/riffer/params/boolean.rbs
+- sig/generated/riffer/params/format.rbs
 - sig/generated/riffer/params/param.rbs
 - sig/generated/riffer/providers.rbs
 - sig/generated/riffer/providers/amazon_bedrock.rbs
@@ -404,6 +411,7 @@ files:
 - sig/manual/riffer/mcp/authenticated_tool.rbs
 - sig/manual/riffer/mcp/registry.rbs
 - sig/manual/riffer/mcp/tool_factory.rbs
+- sig/manual/riffer/params/format.rbs
 - sig/manual/riffer/providers.rbs
 - sig/manual/riffer/providers/repository.rbs
 - sig/manual/riffer/testing.rbs