riffer 0.48.0 → 0.49.0

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

@@ -1,42 +1,30 @@
 # Generated from lib/riffer/messages/base.rb with RBS::Inline
 
-# Base class for all message types. Subclasses must implement +role+.
 class Riffer::Messages::Base
-  # Builds the matching message subclass from a hash, or returns +msg+ unchanged
-  # when it is already a message. Raises Riffer::ArgumentError on an invalid message.
   # --
   # : ((Hash[Symbol, untyped] | Riffer::Messages::Base)) -> Riffer::Messages::Base
   def self.from_hash: (Hash[Symbol, untyped] | Riffer::Messages::Base) -> Riffer::Messages::Base
 
-  # The message content.
   attr_reader content: String
 
-  # The message id, or nil when +Riffer.config.message_id_strategy+ is +:none+.
   attr_reader id: String?
 
   # --
   # : (String, ?id: String?) -> void
   def initialize: (String, ?id: String?) -> void
 
-  # Converts the message to a hash.
-  #
   # --
   # : () -> Hash[Symbol, untyped]
   def to_h: () -> Hash[Symbol, untyped]
 
-  # Returns the message role.
   # --
   # : () -> Symbol
   def role: () -> Symbol
 
-  # Whether this message carries pending tool calls (overridden by
-  # +Riffer::Messages::Assistant+).
   # --
   # : () -> bool
   def has_tool_calls?: () -> bool
 
-  # Merges another same-role message into this one. +Tool+ messages are never
-  # merged.
   # --
   # : (untyped) -> Riffer::Messages::Base
   def +: (untyped) -> Riffer::Messages::Base

data/sig/generated/riffer/messages/system.rbs

@@ -1,9 +1,6 @@
 # Generated from lib/riffer/messages/system.rb with RBS::Inline
 
-# Represents a system message (instructions) in a conversation.
 class Riffer::Messages::System < Riffer::Messages::Base
-  # Builds a System message from a hash, or returns +msg+ unchanged when it is
-  # already a System message.
   # --
   # : ((Hash[Symbol, untyped] | Riffer::Messages::System)) -> Riffer::Messages::System
   def self.from_hash: (Hash[Symbol, untyped] | Riffer::Messages::System) -> Riffer::Messages::System

data/sig/generated/riffer/messages/tool.rbs

@@ -1,32 +1,22 @@
 # Generated from lib/riffer/messages/tool.rb with RBS::Inline
 
-# Represents a tool execution result in a conversation.
 class Riffer::Messages::Tool < Riffer::Messages::Base
-  # Builds a Tool message from a hash, or returns +msg+ unchanged when it is
-  # already a Tool message.
   # --
   # : ((Hash[Symbol, untyped] | Riffer::Messages::Tool)) -> Riffer::Messages::Tool
   def self.from_hash: (Hash[Symbol, untyped] | Riffer::Messages::Tool) -> Riffer::Messages::Tool
 
-  # The ID of the tool call this result responds to.
   attr_reader tool_call_id: String
 
-  # The name of the tool that was called.
   attr_reader name: String
 
-  # The error message if the tool execution failed.
   attr_reader error: String?
 
-  # The type of error (:unknown_tool, :validation_error, :execution_error,
-  # :timeout_error, :unhandled_error).
   attr_reader error_type: Symbol?
 
   # --
   # : (String, tool_call_id: String, name: String, ?id: String?, ?error: String?, ?error_type: Symbol?) -> void
   def initialize: (String, tool_call_id: String, name: String, ?id: String?, ?error: String?, ?error_type: Symbol?) -> void
 
-  # Returns true if the tool execution resulted in an error.
-  #
   # --
   # : () -> bool
   def error?: () -> bool
@@ -35,8 +25,6 @@ class Riffer::Messages::Tool < Riffer::Messages::Base
   # : () -> Symbol
   def role: () -> Symbol
 
-  # Converts the message to a hash.
-  #
   # --
   # : () -> Hash[Symbol, untyped]
   def to_h: () -> Hash[Symbol, untyped]

data/sig/generated/riffer/messages/user/file_part.rbs

@@ -1,7 +1,5 @@
 # Generated from lib/riffer/messages/user/file_part.rb with RBS::Inline
 
-# Represents a file attachment (image or document) — from a URL (+from_url+) or
-# raw base64 data (+new+).
 class Riffer::Messages::User::FilePart
   @data_bytes: String?
 
@@ -17,41 +15,28 @@ class Riffer::Messages::User::FilePart
 
   SHA256_PATTERN: Regexp
 
-  # The MIME type of the file.
   attr_reader media_type: String
 
-  # The filename, if available.
   attr_reader filename: String?
 
-  # The expected SHA-256 of the file contents, if the caller supplied one.
   attr_reader sha256: String?
 
-  # Raises Riffer::ArgumentError unless +data+ or +url+ is given and
-  # +media_type+ is supported.
   # --
   # : (media_type: String, ?data: String?, ?filename: String?, ?url: String?, ?sha256: String?) -> void
   def initialize: (media_type: String, ?data: String?, ?filename: String?, ?url: String?, ?sha256: String?) -> void
 
-  # Creates a FilePart from a URL, detecting +media_type+ from the path
-  # extension when omitted. Raises Riffer::ArgumentError if it can't be detected.
   # --
   # : (String, ?media_type: String?, ?filename: String?, ?sha256: String?) -> Riffer::Messages::User::FilePart
   def self.from_url: (String, ?media_type: String?, ?filename: String?, ?sha256: String?) -> Riffer::Messages::User::FilePart
 
-  # Builds a FilePart from a +{url:, media_type:}+ or +{data:, media_type:}+ hash,
-  # or returns +file+ unchanged when it is already a FilePart. Raises
-  # Riffer::ArgumentError on an invalid hash.
   # --
   # : ((Hash[Symbol, untyped] | Riffer::Messages::User::FilePart)) -> Riffer::Messages::User::FilePart
   def self.from_hash: (Hash[Symbol, untyped] | Riffer::Messages::User::FilePart) -> Riffer::Messages::User::FilePart
 
-  # Raises Riffer::ArgumentError when the URL's extension isn't a known media type.
   # --
   # : (String) -> String
   def self.detect_media_type: (String) -> String
 
-  # The base64-encoded contents - caller-supplied, or filled in by the file
-  # resolver after a download.  Nil for a URL source riffer hasn't fetched.
   # --
   # : () -> String?
   def data: () -> String?
@@ -62,44 +47,29 @@ class Riffer::Messages::User::FilePart
   # : (String) -> void
   def cache_data_bytes: (String) -> void
 
-  # Whether data was supplied directly, as opposed to filled in later by the
-  # file resolver after a download
   # : () -> bool
   def inline_data?: () -> bool
 
-  # Caches bytes fetched for a URL source.  Deliberately absent from +to_h+:
-  # the agent loop re-sends history on every turn, so the cache saves refreshing
-  # the same file, while persisted history stays free of megabytes of base64
   # --
   # : (String) -> void
   def cache_downloaded_data: (String) -> void
 
-  # Returns the URL if the source was a URL, nil otherwise.
-  #
   # --
   # : () -> String?
   def url: () -> String?
 
-  # Returns true if the source was a URL.
-  #
   # --
   # : () -> bool
   def url?: () -> bool
 
-  # Returns true if the file is an image.
-  #
   # --
   # : () -> bool
   def image?: () -> bool
 
-  # Returns true if the file is a document (not an image).
-  #
   # --
   # : () -> bool
   def document?: () -> bool
 
-  # Serializes the FilePart to a hash.
-  #
   # --
   # : () -> Hash[Symbol, untyped]
   def to_h: () -> Hash[Symbol, untyped]

data/sig/generated/riffer/messages/user.rbs

@@ -1,14 +1,10 @@
 # Generated from lib/riffer/messages/user.rb with RBS::Inline
 
-# Represents a user message in a conversation.
 class Riffer::Messages::User < Riffer::Messages::Base
-  # Builds a User message from a hash, or returns +msg+ unchanged when it is
-  # already a User message. Raises Riffer::ArgumentError on an invalid file.
   # --
   # : ((Hash[Symbol, untyped] | Riffer::Messages::User)) -> Riffer::Messages::User
   def self.from_hash: (Hash[Symbol, untyped] | Riffer::Messages::User) -> Riffer::Messages::User
 
-  # File attachments for this message.
   attr_reader files: Array[Riffer::Messages::User::FilePart]
 
   # --

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

@@ -1,8 +1,5 @@
 # Generated from lib/riffer/params/boolean.rb with RBS::Inline
 
-# Sentinel type for declaring boolean parameters — Ruby has no +Boolean+ class
-# (+true+/+false+ are +TrueClass+/+FalseClass+).
-#
-#   required :verbose, Riffer::Params::Boolean
+# Ruby has no +Boolean+ class, so params declare booleans with this sentinel.
 module Riffer::Params::Boolean
 end

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

@@ -1,44 +1,28 @@
 # Generated from lib/riffer/params/param.rb with RBS::Inline
 
-# A single parameter definition, handling type validation and JSON Schema
-# generation.
 class Riffer::Params::Param
-  # Maps Ruby types to JSON Schema type strings
   TYPE_MAPPINGS: Hash[Module, String]
 
-  # Primitive types allowed for the <tt>of:</tt> keyword on Array params
   PRIMITIVE_TYPES: Array[Module]
 
-  # Maps JSON Schema type strings back to Ruby types (inverse of TYPE_MAPPINGS),
-  # collapsing the three boolean spellings onto Riffer::Params::Boolean.
   JSON_TYPE_MAPPINGS: Hash[String, Module]
 
-  # The parameter name.
   attr_reader name: Symbol
 
-  # The Ruby type.
   attr_reader type: Module
 
-  # Whether the parameter is required.
   attr_reader required: bool
 
-  # The parameter description, if any.
   attr_reader description: String?
 
-  # Allowed values, if constrained.
   attr_reader enum: Array[untyped]?
 
-  # The default value, if any.
   attr_reader default: untyped
 
-  # Element type for a typed array (+of:+).
   attr_reader item_type: Module?
 
-  # Nested Params for object / array-of-object types.
   attr_reader nested_params: Riffer::Params?
 
-  # Reconstructs a Param from a single JSON Schema property. Raises
-  # Riffer::ArgumentError on a type outside the Params-expressible subset.
   # --
   # : (Symbol, Hash[Symbol, untyped], required: bool) -> Riffer::Params::Param
   def self.from_json_schema: (Symbol, Hash[Symbol, untyped], required: bool) -> Riffer::Params::Param
@@ -47,9 +31,6 @@ class Riffer::Params::Param
   # : (Module, Hash[Symbol, untyped]) -> [Module?, Riffer::Params?]
   def self.resolve_nesting: (Module, Hash[Symbol, untyped]) -> [ Module?, Riffer::Params? ]
 
-  # Resolves a JSON Schema +type+ (or a <tt>[type, "null"]</tt> union) to its
-  # Ruby type. Returns a Module — Riffer::Params::Boolean is a Module, not a
-  # Class. Raises Riffer::ArgumentError on an unsupported type.
   # --
   # : (untyped) -> Module
   def self.json_type_to_ruby: (untyped) -> Module
@@ -58,26 +39,14 @@ class Riffer::Params::Param
   # : (name: Symbol, type: Module, required: bool, ?description: String?, ?enum: Array[untyped]?, ?default: untyped, ?item_type: Module?, ?nested_params: Riffer::Params?) -> void
   def initialize: (name: Symbol, type: Module, required: bool, ?description: String?, ?enum: Array[untyped]?, ?default: untyped, ?item_type: Module?, ?nested_params: Riffer::Params?) -> void
 
-  # Validates that a value matches the expected type.
-  #
   # --
   # : (untyped) -> bool
   def valid_type?: (untyped) -> bool
 
-  # Returns the JSON Schema type name for this parameter.
-  #
   # --
   # : () -> String
   def type_name: () -> String
 
-  # Converts this parameter to JSON Schema format. When +strict+, optional
-  # 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>. 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]

data/sig/generated/riffer/params.rbs

@@ -1,69 +1,38 @@
 # Generated from lib/riffer/params.rb with RBS::Inline
 
-# A DSL for defining tool parameters and structured-output schemas, used within
-# a Tool's +params+ block.
-#
-#   params do
-#     required :city, String, description: "The city name"
-#     optional :units, String, default: "celsius", enum: ["celsius", "fahrenheit"]
-#   end
 class Riffer::Params
-  # The defined parameters.
   attr_reader parameters: Array[Riffer::Params::Param]
 
   # --
   # : () -> void
   def initialize: () -> void
 
-  # Reconstructs a Params from a JSON Schema object — the inverse of
-  # +to_json_schema(strict: false)+. Raises Riffer::ArgumentError on features
-  # outside the Params-expressible subset of JSON Schema.
-  #
-  #   schema = params.to_json_schema(strict: false)
-  #   Riffer::Params.from_json_schema(schema) # => equivalent Riffer::Params
-  #
+  # The inverse of +to_json_schema(strict: false)+. Raises Riffer::ArgumentError
+  # on features outside the Params-expressible subset of JSON Schema.
   # --
   # : (Hash[Symbol, untyped]) -> Riffer::Params
   def self.from_json_schema: (Hash[Symbol, untyped]) -> Riffer::Params
 
-  # Defines a required parameter.
-  #
   # --
   # : (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
 
-  # Defines an optional parameter.
-  #
   # --
   # : (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
 
-  # Validates arguments against parameter definitions.
-  #
-  # A Float param accepts an Integer (JSON Schema <tt>"number"</tt> covers
-  # integers) and its value is coerced with +to_f+, so callers always get a
-  # Float. The same holds for the items of an <tt>of: Float</tt> array. No other
-  # type is coerced.
-  #
-  # Raises Riffer::ValidationError if validation fails.
-  #
   # --
   # : (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
   def validate: (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
 
-  # 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]
 
   private
 
-  # +dup+ would leave the copy sharing this one's parameters, so a caller
-  # defining a parameter on either would reach the other.
+  # Without this, +dup+ shares parameters, so defining one on either copy
+  # would reach the other.
   # --
   # : (Riffer::Params) -> void
   def initialize_copy: (Riffer::Params) -> void
@@ -84,15 +53,10 @@ class Riffer::Params
   # : (Riffer::Params::Param, Array[untyped], Array[String]) -> Array[untyped]
   def validate_nested_array_of_objects: (Riffer::Params::Param, Array[untyped], Array[String]) -> Array[untyped]
 
-  # Returns the array with its valid items coerced by +coerce_value+.
   # --
   # : (Riffer::Params::Param, Array[untyped], Array[String]) -> Array[untyped]
   def validate_typed_array: (Riffer::Params::Param, Array[untyped], Array[String]) -> Array[untyped]
 
-  # Coerces an already-validated value to the Ruby type its param declares.
-  # Only Float coerces today, because JSON Schema "number" accepts integers and
-  # callers should not get a type that depends on whether the model wrote a
-  # decimal point. Add a branch here rather than inline at a call site.
   # --
   # : (Module, untyped) -> untyped
   def coerce_value: (Module, untyped) -> untyped

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

@@ -1,21 +1,19 @@
 # Generated from lib/riffer/providers/amazon_bedrock.rb with RBS::Inline
 
-# Amazon Bedrock provider for Claude and other foundation models. Requires the
-# +aws-sdk-bedrockruntime+ gem.
 class Riffer::Providers::AmazonBedrock < Riffer::Providers::Base
-  # Matches Anthropic models on Bedrock — bare (+anthropic.claude-...+) and
-  # cross-region (+us.anthropic.claude-...+) ids.
+  # Bedrock ids are bare (+anthropic.claude-...+) or cross-region (+us.anthropic.claude-...+).
   ANTHROPIC_MODEL_PATTERN: Regexp
 
   FINISH_REASONS: Hash[String, Symbol]
 
-  # Returns the skill adapter for the Bedrock model — XML for Anthropic models
-  # (which Bedrock hosts alongside other vendors'), else Markdown.
+  # Only parts carrying this tag are replayed, so reasoning captured by another
+  # adapter, whose signatures Converse cannot verify, never reaches the request.
+  REASONING_FORMAT: String
+
   # --
   # : (?String?) -> singleton(Riffer::Skills::Adapter)
   def self.skills_adapter: (?String?) -> singleton(Riffer::Skills::Adapter)
 
-  # The GenAI semconv well-known provider name.
   # --
   # : () -> String
   def self.semconv_provider_name: () -> String
@@ -34,9 +32,6 @@ class Riffer::Providers::AmazonBedrock < Riffer::Providers::Base
   # : () -> untyped
   def global_client: () -> untyped
 
-  # Compacted so an unset region stays absent: the AWS SDK resolves +AWS_REGION+
-  # and the shared config only for a missing argument, and raises
-  # +Aws::Errors::MissingRegionError+ on an explicit nil.
   # --
   # : () -> untyped
   def build_client: () -> untyped
@@ -45,10 +40,6 @@ class Riffer::Providers::AmazonBedrock < Riffer::Providers::Base
   # : (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]
 
-  # Converse treats +tools -> system -> messages+ as one prefix and looks back
-  # from a +cachePoint+ for the longest cached run, so the point on the final
-  # message reuses the previous step's cache wherever that point sat. Mixed
-  # ttls must be ordered 1h before 5m, so both points share one.
   # --
   # : (Hash[Symbol, untyped], untyped) -> void
   def apply_cache_point: (Hash[Symbol, untyped], untyped) -> void
@@ -65,8 +56,6 @@ class Riffer::Providers::AmazonBedrock < Riffer::Providers::Base
   # : (untyped) -> Riffer::Providers::TokenUsage?
   def extract_token_usage: (untyped) -> Riffer::Providers::TokenUsage?
 
-  # Converse's +input_tokens+ excludes the cache buckets; TokenUsage's
-  # input includes them.
   # --
   # : (untyped) -> Riffer::Providers::TokenUsage
   def build_token_usage: (untyped) -> Riffer::Providers::TokenUsage
@@ -87,23 +76,24 @@ class Riffer::Providers::AmazonBedrock < Riffer::Providers::Base
   # : (untyped) -> Array[Riffer::Messages::Assistant::ToolCall]
   def extract_tool_calls: (untyped) -> Array[Riffer::Messages::Assistant::ToolCall]
 
+  # --
+  # : (untyped) -> Array[Riffer::Messages::Assistant::ReasoningPart]
+  def extract_reasoning: (untyped) -> Array[Riffer::Messages::Assistant::ReasoningPart]
+
+  # +redacted_content+ is raw bytes; it is stored Base64-encoded so the part
+  # survives JSON persistence.
+  # --
+  # : (?text: String?, ?signature: String?, ?redacted_content: String?) -> Riffer::Messages::Assistant::ReasoningPart
+  def build_reasoning_part: (?text: String?, ?signature: String?, ?redacted_content: String?) -> Riffer::Messages::Assistant::ReasoningPart
+
   # --
   # : (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
   def execute_stream: (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
 
-  # Re-raises an +Aws::Errors::EventError+ event with a message built from its
-  # error code and message. The SDK's own +#message+ is just the class name,
-  # so without this the failure would be unreadable.
   # --
   # : (untyped) -> void
   def raise_stream_event_error!: (untyped) -> void
 
-  # Re-raises a Bedrock stream-exception event as the matching
-  # +Aws::BedrockRuntime::Errors+ class. ConverseStream delivers API errors on
-  # the same channel as content, so without this a mid-stream failure would
-  # silently end the stream with no content. Non-exception events that we do
-  # not consume (including the SDK's +:unknown_event+ struct) are ignored for
-  # forward compatibility.
   # --
   # : (untyped) -> void
   def raise_if_stream_exception!: (untyped) -> void
@@ -120,6 +110,16 @@ class Riffer::Providers::AmazonBedrock < Riffer::Providers::Base
   # : (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
   def handle_content_block_delta_tool_use: (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
 
+  # A reasoning block streams its text in pieces, then its signature (or its
+  # redacted bytes) in a delta of its own.
+  # --
+  # : (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
+  def handle_reasoning_delta: (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
+
+  # --
+  # : (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
+  def handle_reasoning_stop: (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
+
   # --
   # : (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
   def handle_content_block_stop_text_delta: (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
@@ -140,6 +140,10 @@ class Riffer::Providers::AmazonBedrock < Riffer::Providers::Base
   # : (Riffer::Messages::Assistant) -> Hash[Symbol, untyped]
   def convert_assistant_to_bedrock_format: (Riffer::Messages::Assistant) -> Hash[Symbol, untyped]
 
+  # --
+  # : (Riffer::Messages::Assistant::ReasoningPart) -> Hash[Symbol, untyped]
+  def convert_reasoning_part_to_bedrock_format: (Riffer::Messages::Assistant::ReasoningPart) -> Hash[Symbol, untyped]
+
   # --
   # : (Array[Hash[Symbol, untyped]], Riffer::Messages::Tool) -> void
   def append_tool_result: (Array[Hash[Symbol, untyped]], Riffer::Messages::Tool) -> void

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

@@ -1,19 +1,14 @@
 # Generated from lib/riffer/providers/anthropic.rb with RBS::Inline
 
-# Anthropic provider for Claude models via the Anthropic API. Requires the
-# +anthropic+ gem.
 class Riffer::Providers::Anthropic < Riffer::Providers::Base
   WEB_SEARCH_TOOL_TYPE: String
 
   FINISH_REASONS: Hash[String, Symbol]
 
-  # Returns the XML skill adapter for Anthropic/Claude.
-  #
   # --
   # : (?String?) -> singleton(Riffer::Skills::Adapter)
   def self.skills_adapter: (?String?) -> singleton(Riffer::Skills::Adapter)
 
-  # The GenAI semconv well-known provider name.
   # --
   # : () -> String
   def self.semconv_provider_name: () -> String
@@ -28,9 +23,6 @@ class Riffer::Providers::Anthropic < Riffer::Providers::Base
   # : () -> untyped
   def global_client: () -> untyped
 
-  # Compacted for the same reason as the other providers: never hand an SDK an
-  # explicit nil credential, so its own +ANTHROPIC_API_KEY+ resolution stays
-  # reachable regardless of how that SDK distinguishes nil from absent.
   # --
   # : () -> untyped
   def build_client: () -> untyped
@@ -55,8 +47,6 @@ class Riffer::Providers::Anthropic < Riffer::Providers::Base
   # : (untyped) -> Riffer::Providers::FinishReason?
   def build_finish_reason: (untyped) -> Riffer::Providers::FinishReason?
 
-  # Anthropic's +input_tokens+ excludes the cache buckets; TokenUsage's
-  # input includes them.
   # --
   # : (untyped) -> Riffer::Providers::TokenUsage
   def build_token_usage: (untyped) -> Riffer::Providers::TokenUsage

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

@@ -1,10 +1,6 @@
 # Generated from lib/riffer/providers/azure_open_ai.rb with RBS::Inline
 
-# Azure OpenAI provider for GPT models hosted on Azure. Requires the +openai+
-# gem. Credentials resolve from config, then +AZURE_OPENAI_API_KEY+ /
-# +AZURE_OPENAI_ENDPOINT+.
 class Riffer::Providers::AzureOpenAI < Riffer::Providers::OpenAI
-  # The GenAI semconv well-known provider name.
   # --
   # : () -> String
   def self.semconv_provider_name: () -> String
@@ -15,10 +11,6 @@ class Riffer::Providers::AzureOpenAI < Riffer::Providers::OpenAI
   # : () -> untyped
   def global_client: () -> untyped
 
-  # Deliberately not compacted: this borrows the OpenAI SDK to talk to Azure, so
-  # omitting an unset argument would let the SDK fall back to +OPENAI_API_KEY+
-  # and +OPENAI_BASE_URL+ — sending Azure traffic, and an OpenAI credential, to
-  # whatever those name. Passing nil raises in the SDK instead.
   # --
   # : () -> untyped
   def build_client: () -> untyped

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

@@ -1,9 +1,5 @@
 # Generated from lib/riffer/providers/base.rb with RBS::Inline
 
-# Base class for all LLM providers. A template-method flow: subclasses implement
-# the hooks (+build_request_params+, +execute_generate+, +execute_stream+,
-# +extract_token_usage+, +extract_content+, +extract_tool_calls+) and the base
-# class orchestrates them.
 class Riffer::Providers::Base
   self.@semconv_provider_name: String?
 
@@ -15,28 +11,18 @@ class Riffer::Providers::Base
 
   WIRE_SEPARATOR: String
 
-  # Returns the preferred skill adapter for this provider; override in
-  # subclasses (optionally introspecting +model+) for provider-specific formats.
   # --
   # : (?String?) -> singleton(Riffer::Skills::Adapter)
   def self.skills_adapter: (?String?) -> singleton(Riffer::Skills::Adapter)
 
-  # Returns the provider name stamped as <tt>gen_ai.provider.name</tt> on trace
-  # spans, ideally a GenAI semconv well-known value. Defaults to the snake_cased
-  # class name rather than raising like the abstract provider methods, so
-  # enabling tracing never breaks an otherwise-working custom provider.
   # --
   # : () -> String
   def self.semconv_provider_name: () -> String
 
-  # Generates text using the provider.
-  #
   # --
   # : (?prompt: String?, ?system: String?, ?messages: Array[Hash[Symbol, untyped] | Riffer::Messages::Base]?, ?model: String?, ?files: Array[Hash[Symbol, untyped] | Riffer::Messages::User::FilePart]?, **untyped) -> Riffer::Messages::Assistant
   def generate_text: (?prompt: String?, ?system: String?, ?messages: Array[Hash[Symbol, untyped] | Riffer::Messages::Base]?, ?model: String?, ?files: Array[Hash[Symbol, untyped] | Riffer::Messages::User::FilePart]?, **untyped) -> Riffer::Messages::Assistant
 
-  # Streams text from the provider.
-  #
   # --
   # : (?prompt: String?, ?system: String?, ?messages: Array[Hash[Symbol, untyped] | Riffer::Messages::Base]?, ?model: String?, ?files: Array[Hash[Symbol, untyped] | Riffer::Messages::User::FilePart]?, **untyped) -> Enumerator[Riffer::StreamEvents::Base, void]
   def stream_text: (?prompt: String?, ?system: String?, ?messages: Array[Hash[Symbol, untyped] | Riffer::Messages::Base]?, ?model: String?, ?files: Array[Hash[Symbol, untyped] | Riffer::Messages::User::FilePart]?, **untyped) -> Enumerator[Riffer::StreamEvents::Base, void]
@@ -50,16 +36,10 @@ class Riffer::Providers::Base
   # : (String) -> true
   def depends_on: (String) -> true
 
-  # Returns the client for the current LLM call. A configured client wins,
-  # resolved on every call so a Proc can vary the client by process or
-  # credential lifetime; otherwise the provider builds one from the configured
-  # credentials, memoized for the life of the provider.
   # --
   # : () -> untyped
   def client: () -> untyped
 
-  # Returns the consumer-configured client for this provider; nil when none is
-  # configured, and for providers that take no configuration at all.
   # --
   # : () -> untyped
   def global_client: () -> untyped
@@ -99,14 +79,10 @@ class Riffer::Providers::Base
   # : () -> Riffer::Config::Pricing::Rates?
   def pricing_rates: () -> Riffer::Config::Pricing::Rates?
 
-  # Defaults to nil rather than raising — finish reasons are optional, so
-  # providers that don't report one stay valid.
   # --
   # : (untyped) -> Riffer::Providers::FinishReason?
   def extract_finish_reason: (untyped) -> Riffer::Providers::FinishReason?
 
-  # Defaults to no parts rather than raising — reasoning parts are optional, so
-  # providers that don't expose replayable reasoning stay valid.
   # --
   # : (untyped) -> Array[Riffer::Messages::Assistant::ReasoningPart]
   def extract_reasoning: (untyped) -> Array[Riffer::Messages::Assistant::ReasoningPart]
@@ -130,8 +106,6 @@ class Riffer::Providers::Base
   # : (String?, Hash[Symbol, untyped]) -> Hash[String, untyped]
   def chat_span_attributes: (String?, Hash[Symbol, untyped]) -> Hash[String, untyped]
 
-  # Maps normalized tags to their namespaced span attribute form. An empty map
-  # yields an empty hash, so merging it is a no-op.
   # --
   # : (Hash[String, String]) -> Hash[String, String]
   def tag_attributes: (Hash[String, String]) -> Hash[String, String]
@@ -156,8 +130,6 @@ class Riffer::Providers::Base
   # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span)) -> bool
   def capture_messages?: (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span) -> bool
 
-  # Wraps reasoning text that an adapter cannot yet replay in a +:text+ part
-  # with no +format+, so it persists for display but is never sent back.
   # --
   # : (Riffer::Providers::_EventSink, String) -> void
   def yield_reasoning_done: (Riffer::Providers::_EventSink, String) -> void