riffer 0.40.0 → 0.41.0

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

@@ -2,20 +2,8 @@
 
 # Google Gemini provider for Gemini models via the Gemini REST API.
 class Riffer::Providers::Gemini < Riffer::Providers::Base
-  @read_timeout: Integer
-
-  @open_timeout: Integer
-
-  @api_key: String?
-
-  BASE_URI: URI::Generic
-
   VALID_MODEL_PATTERN: Regexp
 
-  DEFAULT_OPEN_TIMEOUT: Integer
-
-  DEFAULT_READ_TIMEOUT: Integer
-
   FINISH_REASONS: Hash[String, Symbol]
 
   # The GenAI semconv well-known provider name.
@@ -23,11 +11,15 @@ class Riffer::Providers::Gemini < Riffer::Providers::Base
   # : () -> String
   def self.semconv_provider_name: () -> String
 
+  private
+
   # --
-  # : (?api_key: String?, ?open_timeout: Integer?, ?read_timeout: Integer?, **untyped) -> void
-  def initialize: (?api_key: String?, ?open_timeout: Integer?, ?read_timeout: Integer?, **untyped) -> void
+  # : () -> untyped
+  def global_client: () -> untyped
 
-  private
+  # --
+  # : () -> untyped
+  def build_client: () -> untyped
 
   # --
   # : (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
@@ -89,10 +81,6 @@ class Riffer::Providers::Gemini < Riffer::Providers::Base
   # : (untyped) -> String
   def encode_tool_arguments: (untyped) -> String
 
-  # --
-  # : (String, Hash[Symbol, untyped]) -> Net::HTTPResponse
-  def post_request: (String, Hash[Symbol, untyped]) -> Net::HTTPResponse
-
   # --
   # : (String, String) -> String
   def api_path: (String, String) -> String
@@ -104,8 +92,4 @@ class Riffer::Providers::Gemini < Riffer::Providers::Base
   # --
   # : (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
   def strip_additional_properties: (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
-
-  # --
-  # : (Net::HTTPResponse) -> void
-  def handle_api_error!: (Net::HTTPResponse) -> void
 end

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

@@ -23,7 +23,8 @@ class Riffer::Providers::Mock < Riffer::Providers::Base
   attr_reader calls: Array[Hash[Symbol, untyped]]
 
   # +responses:+ pre-configures canned responses (same shape as
-  # +#stub_response+), typically set via +provider_options responses: [...]+.
+  # +#stub_response+) for standalone use; agent tests queue responses on
+  # <tt>agent.provider</tt> via +#stub_response+ instead.
   #
   #   Riffer::Providers::Mock.new(responses: [
   #     {content: "", tool_calls: [{name: "tool_a", arguments: "{}"}]},
@@ -31,8 +32,8 @@ class Riffer::Providers::Mock < Riffer::Providers::Base
   #   ])
   #
   # --
-  # : (**untyped) -> void
-  def initialize: (**untyped) -> void
+  # : (?responses: Array[Hash[Symbol, untyped]]) -> void
+  def initialize: (?responses: Array[Hash[Symbol, untyped]]) -> void
 
   # Stubs the next response; call repeatedly to queue several. +finish_reason+
   # defaults to +:tool_calls+ when tool calls are present, else +:stop+.

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

@@ -10,11 +10,22 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
   def self.semconv_provider_name: () -> String
 
   # --
-  # : (**untyped) -> void
-  def initialize: (**untyped) -> void
+  # : () -> void
+  def initialize: () -> void
 
   private
 
+  # --
+  # : () -> untyped
+  def global_client: () -> untyped
+
+  # Compacted so an unset value stays absent: the SDK reads +OPENAI_API_KEY+ /
+  # +OPENAI_BASE_URL+ only for a missing argument, and an explicit nil would
+  # suppress that fallback.
+  # --
+  # : () -> untyped
+  def build_client: () -> 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

@@ -2,7 +2,7 @@
 
 # OpenRouter provider (https://openrouter.ai). Requires the +openai+ gem —
 # OpenRouter exposes an OpenAI-compatible endpoint, so this reuses the OpenAI
-# SDK with a +base_url+ override. +api_key+ falls back to config, then
+# SDK with a +base_url+ override. +api_key+ resolves from config, then
 # +OPENROUTER_API_KEY+.
 class Riffer::Providers::OpenRouter < Riffer::Providers::Base
   BASE_URL: String
@@ -15,11 +15,24 @@ class Riffer::Providers::OpenRouter < Riffer::Providers::Base
   def self.semconv_provider_name: () -> String
 
   # --
-  # : (?api_key: String?, **untyped) -> void
-  def initialize: (?api_key: String?, **untyped) -> void
+  # : () -> void
+  def initialize: () -> void
 
   private
 
+  # --
+  # : () -> untyped
+  def global_client: () -> untyped
+
+  # Deliberately not compacted: this borrows the OpenAI SDK to talk to a
+  # different vendor, so omitting an unset +api_key+ would let the SDK fall
+  # back to +OPENAI_API_KEY+ and send an OpenAI credential to OpenRouter.
+  # Passing nil raises in the SDK instead. +OPENROUTER_API_KEY+ is read here
+  # rather than left to the SDK for the same reason.
+  # --
+  # : () -> untyped
+  def build_client: () -> 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]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: riffer
 version: !ruby/object:Gem::Version
-  version: 0.40.0
+  version: 0.41.0
 platform: ruby
 authors:
 - Jake Bottrall
@@ -151,6 +151,7 @@ files:
 - lib/riffer/providers/base.rb
 - lib/riffer/providers/finish_reason.rb
 - lib/riffer/providers/gemini.rb
+- lib/riffer/providers/gemini/client.rb
 - lib/riffer/providers/mock.rb
 - lib/riffer/providers/open_ai.rb
 - lib/riffer/providers/open_router.rb
@@ -209,6 +210,7 @@ files:
 - sig/_private/opentelemetry.rbs
 - sig/_private/riffer/providers/amazon_bedrock.rbs
 - sig/_private/riffer/providers/anthropic.rbs
+- sig/_private/riffer/providers/gemini.rbs
 - sig/_private/riffer/providers/open_ai.rbs
 - sig/_private/riffer/providers/open_router.rbs
 - sig/_private/zeitwerk.rbs
@@ -268,6 +270,7 @@ files:
 - sig/generated/riffer/providers/base.rbs
 - sig/generated/riffer/providers/finish_reason.rbs
 - sig/generated/riffer/providers/gemini.rbs
+- sig/generated/riffer/providers/gemini/client.rbs
 - sig/generated/riffer/providers/mock.rbs
 - sig/generated/riffer/providers/open_ai.rbs
 - sig/generated/riffer/providers/open_router.rbs