riffer 0.47.2 → 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,7 +1,10 @@
 # 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
+  # --
+  # : ((Hash[Symbol, untyped] | Riffer::Messages::System)) -> Riffer::Messages::System
+  def self.from_hash: (Hash[Symbol, untyped] | Riffer::Messages::System) -> Riffer::Messages::System
+
   # --
   # : () -> Symbol
   def role: () -> Symbol

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

@@ -1,26 +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
-  # The ID of the tool call this result responds to.
+  # --
+  # : ((Hash[Symbol, untyped] | Riffer::Messages::Tool)) -> Riffer::Messages::Tool
+  def self.from_hash: (Hash[Symbol, untyped] | Riffer::Messages::Tool) -> Riffer::Messages::Tool
+
   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
@@ -29,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

@@ -0,0 +1,76 @@
+# Generated from lib/riffer/messages/user/file_part.rb with RBS::Inline
+
+class Riffer::Messages::User::FilePart
+  @data_bytes: String?
+
+  @downloaded_data: String?
+
+  @data: String?
+
+  @url_string: String?
+
+  MEDIA_TYPES: Hash[String, String]
+
+  SUPPORTED_MEDIA_TYPES: Array[String]
+
+  SHA256_PATTERN: Regexp
+
+  attr_reader media_type: String
+
+  attr_reader filename: String?
+
+  attr_reader sha256: String?
+
+  # --
+  # : (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
+
+  # --
+  # : (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
+
+  # --
+  # : ((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
+
+  # --
+  # : (String) -> String
+  def self.detect_media_type: (String) -> String
+
+  # --
+  # : () -> String?
+  def data: () -> String?
+
+  # : () -> String?
+  def data_bytes: () -> String?
+
+  # : (String) -> void
+  def cache_data_bytes: (String) -> void
+
+  # : () -> bool
+  def inline_data?: () -> bool
+
+  # --
+  # : (String) -> void
+  def cache_downloaded_data: (String) -> void
+
+  # --
+  # : () -> String?
+  def url: () -> String?
+
+  # --
+  # : () -> bool
+  def url?: () -> bool
+
+  # --
+  # : () -> bool
+  def image?: () -> bool
+
+  # --
+  # : () -> bool
+  def document?: () -> bool
+
+  # --
+  # : () -> Hash[Symbol, untyped]
+  def to_h: () -> Hash[Symbol, untyped]
+end

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

@@ -1,13 +1,15 @@
 # Generated from lib/riffer/messages/user.rb with RBS::Inline
 
-# Represents a user message in a conversation.
 class Riffer::Messages::User < Riffer::Messages::Base
-  # File attachments for this message.
-  attr_reader files: Array[Riffer::Messages::FilePart]
+  # --
+  # : ((Hash[Symbol, untyped] | Riffer::Messages::User)) -> Riffer::Messages::User
+  def self.from_hash: (Hash[Symbol, untyped] | Riffer::Messages::User) -> Riffer::Messages::User
+
+  attr_reader files: Array[Riffer::Messages::User::FilePart]
 
   # --
-  # : (String, ?id: String?, ?files: Array[Riffer::Messages::FilePart]) -> void
-  def initialize: (String, ?id: String?, ?files: Array[Riffer::Messages::FilePart]) -> void
+  # : (String, ?id: String?, ?files: Array[Riffer::Messages::User::FilePart]) -> void
+  def initialize: (String, ?id: String?, ?files: Array[Riffer::Messages::User::FilePart]) -> void
 
   # --
   # : () -> Symbol

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,32 +39,27 @@ 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]
 
   private
 
+  # +dup+ would leave the copy sharing this one's nested Params, enum list and
+  # default, so defining a parameter or editing either value on one would reach
+  # the other.
+  # --
+  # : (Riffer::Params::Param) -> void
+  def initialize_copy: (Riffer::Params::Param) -> void
+
   # --
   # : () -> void
   def validate_strict_shape!: () -> void

data/sig/generated/riffer/params.rbs

@@ -1,67 +1,42 @@
 # 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
 
+  # Without this, +dup+ shares parameters, so defining one on either copy
+  # would reach the other.
+  # --
+  # : (Riffer::Params) -> void
+  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?
@@ -78,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
@@ -25,8 +23,8 @@ class Riffer::Providers::AmazonBedrock < Riffer::Providers::Base
   def initialize: () -> void
 
   # --
-  # : (Riffer::Messages::FilePart) -> Symbol
-  def file_delivery: (Riffer::Messages::FilePart) -> Symbol
+  # : (Riffer::Messages::User::FilePart) -> Symbol
+  def file_delivery: (Riffer::Messages::User::FilePart) -> Symbol
 
   private
 
@@ -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,13 +140,17 @@ 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
 
   # --
-  # : (Riffer::Messages::FilePart) -> Hash[Symbol, untyped]
-  def convert_file_part_to_bedrock_format: (Riffer::Messages::FilePart) -> Hash[Symbol, untyped]
+  # : (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
+  def convert_file_part_to_bedrock_format: (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
 
   BEDROCK_FORMAT_MAP: Hash[String, String]
 

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
@@ -126,8 +116,8 @@ class Riffer::Providers::Anthropic < Riffer::Providers::Base
   def convert_assistant_to_anthropic_format: (Riffer::Messages::Assistant) -> Hash[Symbol, untyped]
 
   # --
-  # : (Riffer::Messages::FilePart) -> Hash[Symbol, untyped]
-  def convert_file_part_to_anthropic_format: (Riffer::Messages::FilePart) -> Hash[Symbol, untyped]
+  # : (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
+  def convert_file_part_to_anthropic_format: (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
 
   # --
   # : (singleton(Riffer::Tool)) -> Hash[Symbol, untyped]

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