riffer 0.29.0 → 0.30.0

data/sig/generated/riffer/evals/evaluator.rbs

@@ -14,6 +14,14 @@
 #     judge_model "anthropic/claude-opus-4-5-20251101"
 #   end
 class Riffer::Evals::Evaluator
+  self.@instructions: String?
+
+  self.@higher_is_better: bool?
+
+  self.@judge_model: String?
+
+  @judge: Riffer::Evals::Judge?
+
   # Gets or sets the evaluation instructions (criteria and scoring rubric).
   #
   # --

data/sig/generated/riffer/evals/judge.rbs

@@ -15,6 +15,14 @@
 #   result[:score]  # => 0.85
 #   result[:reason] # => "The response is relevant..."
 class Riffer::Evals::Judge
+  @provider_options: Hash[Symbol, untyped]
+
+  @provider_instance: Riffer::Providers::Base?
+
+  @provider_name: String?
+
+  @model_name: String?
+
   # Internal tool for structured evaluation output.
   class EvaluationTool < Riffer::Tool
     # --

data/sig/generated/riffer/mcp/client.rbs

@@ -14,6 +14,8 @@
 class Riffer::Mcp::Client
   include Riffer::Helpers::Dependencies
 
+  @client: untyped
+
   # --
   # : (endpoint: String, ?headers: (Hash[String, String] | Proc), ?client: untyped?) -> void
   def initialize: (endpoint: String, ?headers: Hash[String, String] | Proc, ?client: untyped?) -> void

data/sig/generated/riffer/mcp/registration.rbs

@@ -5,6 +5,12 @@
 # Created when a server is registered. Discovers tools via the MCP
 # +tools/list+ call, then generates tool classes.
 class Riffer::Mcp::Registration
+  @cancelled: bool
+
+  @tools: Array[singleton(Riffer::Tool)]
+
+  @mutex: Thread::Mutex
+
   # The manifest that describes this server.
   attr_reader manifest: Riffer::Mcp::Manifest
 

data/sig/generated/riffer/mcp/registry.rbs

@@ -4,6 +4,10 @@
 #
 # Keyed by manifest name. All public methods are mutex-guarded.
 module Riffer::Mcp::Registry
+  self.@mutex: Thread::Mutex
+
+  self.@store: Hash[String, Riffer::Mcp::Registration]
+
   # Registers an MCP server and starts async tool discovery.
   #
   # Accepts a Manifest instance or a hash of manifest keyword arguments.

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

@@ -10,6 +10,8 @@
 #   file.url?        # => true
 #   file.document?   # => true
 class Riffer::Messages::FilePart
+  @url_string: String?
+
   MEDIA_TYPES: Hash[String, String]
 
   SUPPORTED_MEDIA_TYPES: Array[String]

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

@@ -8,11 +8,16 @@ class Riffer::Params::Param
   TYPE_MAPPINGS: Hash[Module, String]
 
   # Primitive types allowed for the <tt>of:</tt> keyword on Array params
-  PRIMITIVE_TYPES: Array[Class]
+  PRIMITIVE_TYPES: Array[Module]
+
+  # Maps JSON Schema type strings back to Ruby types. The inverse of
+  # TYPE_MAPPINGS, collapsing the three boolean spellings onto
+  # Riffer::Params::Boolean. Used by +from_json_schema+.
+  JSON_TYPE_MAPPINGS: Hash[String, Module]
 
   attr_reader name: Symbol
 
-  attr_reader type: Class
+  attr_reader type: Module
 
   attr_reader required: bool
 
@@ -22,13 +27,44 @@ class Riffer::Params::Param
 
   attr_reader default: untyped
 
-  attr_reader item_type: Class?
+  attr_reader item_type: Module?
 
   attr_reader nested_params: Riffer::Params?
 
   # --
-  # : (name: Symbol, type: Class, required: bool, ?description: String?, ?enum: Array[untyped]?, ?default: untyped, ?item_type: Class?, ?nested_params: Riffer::Params?) -> void
-  def initialize: (name: Symbol, type: Class, required: bool, ?description: String?, ?enum: Array[untyped]?, ?default: untyped, ?item_type: Class?, ?nested_params: Riffer::Params?) -> void
+  #  Reconstructs a Param from a single JSON Schema property.
+  #
+  #  [name] the parameter name (Symbol).
+  #  [schema] the property's JSON Schema (Symbol-keyed).
+  #  [required] whether the property appeared in the parent's +required+ list.
+  #
+  #  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
+
+  # Resolves the +[item_type, nested_params]+ pair for a reconstructed Param:
+  # a nested Params for object / array-of-object schemas, an +item_type+ for
+  # typed primitive arrays, and +nil+ for everything else.
+  #
+  # --
+  # : (Module, Hash[Symbol, untyped]) -> [Module?, Riffer::Params?]
+  def self.resolve_nesting: (Module, Hash[Symbol, untyped]) -> [ Module?, Riffer::Params? ]
+
+  # Resolves a JSON Schema +type+ (a String, or a <tt>[type, "null"]</tt>
+  # union) back to its Ruby type. Returns a Module because
+  # Riffer::Params::Boolean is a Module, not a Class — the same widening the
+  # +type+ attribute uses. Raises Riffer::ArgumentError on a type outside the
+  # Params-expressible subset (the block runs only for an unmapped type).
+  #
+  # --
+  # : (untyped) -> Module
+  def self.json_type_to_ruby: (untyped) -> Module
+
+  # --
+  # : (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.
   #
@@ -52,6 +88,11 @@ class Riffer::Params::Param
   # constraint from the null type, since providers like Anthropic reject
   # <tt>{"type": ["string", "null"], "enum": [...]}</tt>.
   #
+  # In non-strict mode a +default+ is emitted when set (a standard JSON
+  # Schema keyword), making the schema a lossless source for
+  # +Riffer::Params.from_json_schema+. Strict mode omits it, since strict
+  # providers reject the keyword.
+  #
   # --
   # : (?strict: bool) -> Hash[Symbol, untyped]
   def to_json_schema: (?strict: bool) -> Hash[Symbol, untyped]

data/sig/generated/riffer/params.rbs

@@ -16,17 +16,36 @@ class Riffer::Params
   # : () -> void
   def initialize: () -> void
 
+  # Reconstructs a Params from a JSON Schema object (the inverse of
+  # +to_json_schema(strict: false)+).
+  #
+  # Accepts the Symbol-keyed object schema produced by +to_json_schema+
+  # (property-name keys may be String or Symbol — both are normalized).
+  # Reconstructs types, +required+, +description+, +enum+, +default+,
+  # typed-array +item_type+, and nested object/array Params recursively.
+  #
+  # Round-trips losslessly with +to_json_schema(strict: false)+ over the
+  # Params-expressible subset of JSON Schema. Raises Riffer::ArgumentError
+  # on a schema using features outside that subset.
+  #
+  #   schema = params.to_json_schema(strict: false)
+  #   Riffer::Params.from_json_schema(schema) # => equivalent Riffer::Params
+  #
+  # --
+  # : (Hash[Symbol, untyped]) -> Riffer::Params
+  def self.from_json_schema: (Hash[Symbol, untyped]) -> Riffer::Params
+
   # Defines a required parameter.
   #
   # --
-  # : (Symbol, Class, ?description: String?, ?enum: Array[untyped]?, ?of: Class?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
-  def required: (Symbol, Class, ?description: String?, ?enum: Array[untyped]?, ?of: Class?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
+  # : (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, Class, ?description: String?, ?enum: Array[untyped]?, ?default: untyped, ?of: Class?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
-  def optional: (Symbol, Class, ?description: String?, ?enum: Array[untyped]?, ?default: untyped, ?of: Class?) ?{ (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
 
   # Validates arguments against parameter definitions.
   #
@@ -49,8 +68,8 @@ class Riffer::Params
   private
 
   # --
-  # : (Class, Class?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
-  def build_nested: (Class, Class?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
+  # : (Module, Module?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
+  def build_nested: (Module, Module?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
 
   # --
   # : (Riffer::Params::Param, untyped, Array[String]) -> untyped

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

@@ -34,20 +34,20 @@ class Riffer::Providers::AmazonBedrock < Riffer::Providers::Base
   def build_request_params: (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
 
   # --
-  # : (Hash[Symbol, untyped]) -> Aws::BedrockRuntime::Client::_ConverseResponseSuccess
-  def execute_generate: (Hash[Symbol, untyped]) -> Aws::BedrockRuntime::Client::_ConverseResponseSuccess
+  # : (Hash[Symbol, untyped]) -> untyped
+  def execute_generate: (Hash[Symbol, untyped]) -> untyped
 
   # --
-  # : (Aws::BedrockRuntime::Client::_ConverseResponseSuccess) -> Riffer::Providers::TokenUsage?
-  def extract_token_usage: (Aws::BedrockRuntime::Client::_ConverseResponseSuccess) -> Riffer::Providers::TokenUsage?
+  # : (untyped) -> Riffer::Providers::TokenUsage?
+  def extract_token_usage: (untyped) -> Riffer::Providers::TokenUsage?
 
   # --
-  # : (Aws::BedrockRuntime::Client::_ConverseResponseSuccess) -> String
-  def extract_content: (Aws::BedrockRuntime::Client::_ConverseResponseSuccess) -> String
+  # : (untyped) -> String
+  def extract_content: (untyped) -> String
 
   # --
-  # : (Aws::BedrockRuntime::Client::_ConverseResponseSuccess) -> Array[Riffer::Messages::Assistant::ToolCall]
-  def extract_tool_calls: (Aws::BedrockRuntime::Client::_ConverseResponseSuccess) -> Array[Riffer::Messages::Assistant::ToolCall]
+  # : (untyped) -> Array[Riffer::Messages::Assistant::ToolCall]
+  def extract_tool_calls: (untyped) -> Array[Riffer::Messages::Assistant::ToolCall]
 
   # --
   # : (Hash[Symbol, untyped], Enumerator::Yielder) -> void
@@ -67,28 +67,28 @@ class Riffer::Providers::AmazonBedrock < Riffer::Providers::Base
   def raise_if_stream_exception!: (untyped) -> void
 
   # --
-  # : (Aws::BedrockRuntime::Types::ContentBlockStartEvent, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
-  def handle_content_block_start_tool_use: (Aws::BedrockRuntime::Types::ContentBlockStartEvent, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  # : (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  def handle_content_block_start_tool_use: (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
 
   # --
-  # : (Aws::BedrockRuntime::Types::ContentBlockDeltaEvent, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
-  def handle_content_block_delta_text_delta: (Aws::BedrockRuntime::Types::ContentBlockDeltaEvent, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  # : (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  def handle_content_block_delta_text_delta: (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
 
   # --
-  # : (Aws::BedrockRuntime::Types::ContentBlockDeltaEvent, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
-  def handle_content_block_delta_tool_use: (Aws::BedrockRuntime::Types::ContentBlockDeltaEvent, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  # : (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  def handle_content_block_delta_tool_use: (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
 
   # --
-  # : (Aws::BedrockRuntime::Types::ContentBlockStopEvent, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
-  def handle_content_block_stop_text_delta: (Aws::BedrockRuntime::Types::ContentBlockStopEvent, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  # : (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  def handle_content_block_stop_text_delta: (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
 
   # --
-  # : (Aws::BedrockRuntime::Types::ContentBlockStopEvent, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
-  def handle_content_block_stop_tool_use: (Aws::BedrockRuntime::Types::ContentBlockStopEvent, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  # : (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  def handle_content_block_stop_tool_use: (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
 
   # --
-  # : (Aws::BedrockRuntime::Types::ConverseStreamMetadataEvent, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
-  def handle_metadata_usage: (Aws::BedrockRuntime::Types::ConverseStreamMetadataEvent, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  # : (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  def handle_metadata_usage: (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
 
   # --
   # : (Array[Riffer::Messages::Base]) -> Hash[Symbol, untyped]

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

@@ -27,20 +27,20 @@ class Riffer::Providers::Anthropic < Riffer::Providers::Base
   def build_request_params: (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
 
   # --
-  # : (Hash[Symbol, untyped]) -> Anthropic::Models::Message
-  def execute_generate: (Hash[Symbol, untyped]) -> Anthropic::Models::Message
+  # : (Hash[Symbol, untyped]) -> untyped
+  def execute_generate: (Hash[Symbol, untyped]) -> untyped
 
   # --
-  # : (Anthropic::Models::Message) -> Riffer::Providers::TokenUsage?
-  def extract_token_usage: (Anthropic::Models::Message) -> Riffer::Providers::TokenUsage?
+  # : (untyped) -> Riffer::Providers::TokenUsage?
+  def extract_token_usage: (untyped) -> Riffer::Providers::TokenUsage?
 
   # --
-  # : (Anthropic::Models::Message) -> String
-  def extract_content: (Anthropic::Models::Message) -> String
+  # : (untyped) -> String
+  def extract_content: (untyped) -> String
 
   # --
-  # : (Anthropic::Models::Message) -> Array[Riffer::Messages::Assistant::ToolCall]
-  def extract_tool_calls: (Anthropic::Models::Message) -> Array[Riffer::Messages::Assistant::ToolCall]
+  # : (untyped) -> Array[Riffer::Messages::Assistant::ToolCall]
+  def extract_tool_calls: (untyped) -> Array[Riffer::Messages::Assistant::ToolCall]
 
   # --
   # : (Hash[Symbol, untyped], Enumerator::Yielder) -> void
@@ -87,8 +87,8 @@ class Riffer::Providers::Anthropic < Riffer::Providers::Base
   def handle_content_block_stop_web_search_result: (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
 
   # --
-  # : (untyped, accumulated_message: Anthropic::Models::Message?, yielder: Enumerator::Yielder) -> void
-  def handle_message_stop: (untyped, accumulated_message: Anthropic::Models::Message?, yielder: Enumerator::Yielder) -> void
+  # : (untyped, accumulated_message: untyped, yielder: Enumerator::Yielder) -> void
+  def handle_message_stop: (untyped, accumulated_message: untyped, yielder: Enumerator::Yielder) -> void
 
   # --
   # : (Array[Riffer::Messages::Base]) -> Hash[Symbol, untyped]

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

@@ -14,6 +14,8 @@
 # [extract_content] extract text content from the SDK response
 # [extract_tool_calls] extract tool calls from the SDK response
 class Riffer::Providers::Base
+  @current_tools: Array[singleton(Riffer::Tool)]
+
   include Riffer::Helpers::Dependencies
 
   include Riffer::Messages::Converter

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

@@ -2,6 +2,12 @@
 
 # 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

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

@@ -4,6 +4,12 @@
 #
 # No external gems required.
 class Riffer::Providers::Mock < Riffer::Providers::Base
+  @stubbed_responses: Array[Hash[Symbol, untyped]]
+
+  @current_index: Integer
+
+  @responses: Array[Hash[Symbol, untyped]]
+
   # Returns the preferred skill adapter for the given mock model.
   #
   # Mock is used to stand in for any real provider in tests, so the model

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

@@ -19,20 +19,20 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
   def build_request_params: (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
 
   # --
-  # : (Hash[Symbol, untyped]) -> OpenAI::Models::Responses::Response
-  def execute_generate: (Hash[Symbol, untyped]) -> OpenAI::Models::Responses::Response
+  # : (Hash[Symbol, untyped]) -> untyped
+  def execute_generate: (Hash[Symbol, untyped]) -> untyped
 
   # --
-  # : (OpenAI::Models::Responses::Response) -> Riffer::Providers::TokenUsage?
-  def extract_token_usage: (OpenAI::Models::Responses::Response) -> Riffer::Providers::TokenUsage?
+  # : (untyped) -> Riffer::Providers::TokenUsage?
+  def extract_token_usage: (untyped) -> Riffer::Providers::TokenUsage?
 
   # --
-  # : (OpenAI::Models::Responses::Response) -> String
-  def extract_content: (OpenAI::Models::Responses::Response) -> String
+  # : (untyped) -> String
+  def extract_content: (untyped) -> String
 
   # --
-  # : (OpenAI::Models::Responses::Response) -> Array[Riffer::Messages::Assistant::ToolCall]
-  def extract_tool_calls: (OpenAI::Models::Responses::Response) -> Array[Riffer::Messages::Assistant::ToolCall]
+  # : (untyped) -> Array[Riffer::Messages::Assistant::ToolCall]
+  def extract_tool_calls: (untyped) -> Array[Riffer::Messages::Assistant::ToolCall]
 
   # --
   # : (Hash[Symbol, untyped], Enumerator::Yielder) -> void

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

@@ -24,48 +24,48 @@ class Riffer::Providers::OpenRouter < Riffer::Providers::Base
   def build_request_params: (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
 
   # --
-  # : (Hash[Symbol, untyped]) -> OpenAI::Models::Chat::ChatCompletion
-  def execute_generate: (Hash[Symbol, untyped]) -> OpenAI::Models::Chat::ChatCompletion
+  # : (Hash[Symbol, untyped]) -> untyped
+  def execute_generate: (Hash[Symbol, untyped]) -> untyped
 
   # --
-  # : (OpenAI::Models::Chat::ChatCompletion) -> Riffer::Providers::TokenUsage?
-  def extract_token_usage: (OpenAI::Models::Chat::ChatCompletion) -> Riffer::Providers::TokenUsage?
+  # : (untyped) -> Riffer::Providers::TokenUsage?
+  def extract_token_usage: (untyped) -> Riffer::Providers::TokenUsage?
 
   # --
-  # : (OpenAI::Models::Chat::ChatCompletion) -> String
-  def extract_content: (OpenAI::Models::Chat::ChatCompletion) -> String
+  # : (untyped) -> String
+  def extract_content: (untyped) -> String
 
   # --
-  # : (OpenAI::Models::Chat::ChatCompletion) -> Array[Riffer::Messages::Assistant::ToolCall]
-  def extract_tool_calls: (OpenAI::Models::Chat::ChatCompletion) -> Array[Riffer::Messages::Assistant::ToolCall]
+  # : (untyped) -> Array[Riffer::Messages::Assistant::ToolCall]
+  def extract_tool_calls: (untyped) -> Array[Riffer::Messages::Assistant::ToolCall]
 
   # --
   # : (Hash[Symbol, untyped], Enumerator::Yielder) -> void
   def execute_stream: (Hash[Symbol, untyped], Enumerator::Yielder) -> void
 
   # --
-  # : (OpenAI::Models::Chat::ChatCompletionChunk, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
-  def handle_stream_chunk: (OpenAI::Models::Chat::ChatCompletionChunk, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  # : (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  def handle_stream_chunk: (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
 
   # --
-  # : (OpenAI::Models::Chat::ChatCompletionChunk::Choice::Delta, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
-  def handle_text_delta: (OpenAI::Models::Chat::ChatCompletionChunk::Choice::Delta, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  # : (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  def handle_text_delta: (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
 
   # --
   # : (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
   def handle_reasoning_delta: (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
 
   # --
-  # : (OpenAI::Models::Chat::ChatCompletionChunk::Choice::Delta, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
-  def handle_tool_call_deltas: (OpenAI::Models::Chat::ChatCompletionChunk::Choice::Delta, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  # : (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
+  def handle_tool_call_deltas: (untyped, state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
 
   # --
   # : (state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
   def emit_tool_call_done_events: (state: Hash[Symbol, untyped], yielder: Enumerator::Yielder) -> void
 
   # --
-  # : (OpenAI::Models::Chat::ChatCompletionChunk::Choice) -> bool
-  def finish_reason_is_tool_calls?: (OpenAI::Models::Chat::ChatCompletionChunk::Choice) -> bool
+  # : (untyped) -> bool
+  def finish_reason_is_tool_calls?: (untyped) -> bool
 
   # --
   # : (Array[Riffer::Messages::Base]) -> Array[Hash[Symbol, untyped]]

data/sig/generated/riffer/runner/fibers.rbs

@@ -12,6 +12,8 @@
 #   runner = Riffer::Runner::Fibers.new
 #   runner.map(items) { |item| expensive_operation(item) }
 class Riffer::Runner::Fibers < Riffer::Runner
+  @max_concurrency: Integer?
+
   include Riffer::Helpers::Dependencies
 
   # [max_concurrency] maximum number of fibers to run simultaneously.

data/sig/generated/riffer/runner/threaded.rbs

@@ -12,6 +12,8 @@
 #   runner = Riffer::Runner::Threaded.new(max_concurrency: 3)
 #   runner.map(items) { |item| expensive_operation(item) }
 class Riffer::Runner::Threaded < Riffer::Runner
+  @max_concurrency: Integer
+
   DEFAULT_MAX_CONCURRENCY: Integer
 
   # [max_concurrency] maximum number of threads to run simultaneously.

data/sig/generated/riffer/skills/config.rbs

@@ -10,6 +10,14 @@
 #     activate ["code-review"]
 #   end
 class Riffer::Skills::Config
+  @backend: (Riffer::Skills::Backend | Proc)?
+
+  @adapter: singleton(Riffer::Skills::Adapter)?
+
+  @activate: (Array[String] | Proc)?
+
+  @activate_tool: singleton(Riffer::Tool)?
+
   # Creates a new Config with all options unset.
   #
   # --

data/sig/generated/riffer/skills/context.rbs

@@ -10,6 +10,10 @@
 #
 # See Riffer::Skills::Backend, Riffer::Skills::Frontmatter.
 class Riffer::Skills::Context
+  @backend: Riffer::Skills::Backend
+
+  @activated: Hash[String, String]
+
   # Skill catalog indexed by name.
   attr_reader skills: Hash[String, Riffer::Skills::Frontmatter]
 

data/sig/generated/riffer/skills/filesystem_backend.rbs

@@ -9,6 +9,10 @@
 #   backend.list_skills  # => [Riffer::Skills::Frontmatter, ...]
 #   backend.read_skill("code-review")  # => "Full skill instructions..."
 class Riffer::Skills::FilesystemBackend < Riffer::Skills::Backend
+  @paths: Array[String]
+
+  @skills_cache: Hash[String, String]?
+
   # Creates a new FilesystemBackend.
   #
   # [paths] one or more directory paths to scan for skills.

data/sig/generated/riffer/tools/response.rbs

@@ -14,6 +14,8 @@
 #     end
 #   end
 class Riffer::Tools::Response
+  @success: bool
+
   VALID_FORMATS: Array[Symbol]
 
   attr_reader content: String

data/sig/generated/riffer/tools/runtime.rbs

@@ -11,6 +11,8 @@
 #   runtime = Riffer::Tools::Runtime::Inline.new
 #   results = runtime.execute(tool_calls, tools: tools, context: context)
 class Riffer::Tools::Runtime
+  @runner: Riffer::Runner
+
   # [runner] the concurrency runner to use for batch execution.
   #
   # Subclasses must provide a runner; instantiating Riffer::Tools::Runtime directly

data/sig/generated/riffer/tools/toolable.rbs

@@ -21,6 +21,18 @@
 #     end
 #   end
 module Riffer::Tools::Toolable
+  @kind: Symbol?
+
+  @params_builder: Riffer::Params?
+
+  @timeout: (Integer | Float)?
+
+  @identifier: String?
+
+  @description: String?
+
+  self.@extenders: Array[Module]?
+
   DEFAULT_TIMEOUT: Integer
 
   # Tracks all classes that extend Toolable.

data/sig/generated/riffer.rbs

@@ -1,6 +1,8 @@
 # Generated from lib/riffer.rb with RBS::Inline
 
 module Riffer
+  self.@config: Riffer::Config?
+
   # Base error class for Riffer.
   class Error < StandardError
   end

data/sig/manifest.yaml

@@ -0,0 +1,3 @@
+dependencies:
+  - name: uri
+  - name: net-http

data/sig/manual/riffer/agent/run.rbs

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

data/sig/manual/riffer/agent/serializer.rbs

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

data/sig/manual/riffer/helpers/call_or_value.rbs

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

data/sig/manual/riffer/tools/toolable.rbs

@@ -0,0 +1,6 @@
+# Toolable is extended onto tool classes; its instance methods run as class
+# methods on the extender, which is also extended with ClassNameConverter
+# (see Toolable.extended). The include models that method availability for Steep.
+module Riffer::Tools::Toolable
+  include Riffer::Helpers::ClassNameConverter
+end