riffer 0.47.2 → 0.48.0

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

@@ -126,8 +126,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/base.rbs

@@ -32,18 +32,18 @@ class Riffer::Providers::Base
   # 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::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::FilePart]?, **untyped) -> Riffer::Messages::Assistant
+  # : (?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::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::FilePart]?, **untyped) -> Enumerator[Riffer::StreamEvents::Base, void]
+  # : (?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]
 
   # --
-  # : (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
 
@@ -105,6 +105,12 @@ class Riffer::Providers::Base
   # : (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]
+
   # --
   # : (untyped) -> String
   def extract_content: (untyped) -> String
@@ -150,6 +156,12 @@ 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
+
   # --
   # : (Riffer::Providers::_EventSink, Riffer::Providers::FinishReason?) -> void
   def yield_finish_reason: (Riffer::Providers::_EventSink, Riffer::Providers::FinishReason?) -> void
@@ -159,8 +171,8 @@ class Riffer::Providers::Base
   def parse_structured_output: (String) -> Hash[Symbol, untyped]?
 
   # --
-  # : ((String | Hash[String, untyped])?) -> Hash[String, untyped]
-  def parse_tool_arguments: ((String | Hash[String, untyped])?) -> Hash[String, untyped]
+  # : (String) -> Hash[String, untyped]
+  def parse_tool_arguments: (String) -> Hash[String, untyped]
 
   # --
   # : (Array[Riffer::Messages::Base]) -> Array[Riffer::Messages::Base]
@@ -171,8 +183,8 @@ class Riffer::Providers::Base
   def validate_input!: (prompt: String?, system: String?, messages: Array[Hash[Symbol | String, untyped] | Riffer::Messages::Base]?) -> void
 
   # --
-  # : (prompt: String?, system: String?, messages: Array[Hash[Symbol, untyped] | Riffer::Messages::Base]?, ?files: Array[Hash[Symbol, untyped] | Riffer::Messages::FilePart]?) -> Array[Riffer::Messages::Base]
-  def normalize_messages: (prompt: String?, system: String?, messages: Array[Hash[Symbol, untyped] | Riffer::Messages::Base]?, ?files: Array[Hash[Symbol, untyped] | Riffer::Messages::FilePart]?) -> Array[Riffer::Messages::Base]
+  # : (prompt: String?, system: String?, messages: Array[Hash[Symbol, untyped] | Riffer::Messages::Base]?, ?files: Array[Hash[Symbol, untyped] | Riffer::Messages::User::FilePart]?) -> Array[Riffer::Messages::Base]
+  def normalize_messages: (prompt: String?, system: String?, messages: Array[Hash[Symbol, untyped] | Riffer::Messages::Base]?, ?files: Array[Hash[Symbol, untyped] | Riffer::Messages::User::FilePart]?) -> Array[Riffer::Messages::Base]
 
   # --
   # : (Array[Riffer::Messages::Base]) -> void

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

@@ -12,8 +12,8 @@ class Riffer::Providers::Gemini < Riffer::Providers::Base
   def self.semconv_provider_name: () -> String
 
   # --
-  # : (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
 
@@ -74,8 +74,8 @@ class Riffer::Providers::Gemini < Riffer::Providers::Base
   def convert_assistant_to_gemini_format: (Riffer::Messages::Assistant) -> Hash[Symbol, untyped]
 
   # --
-  # : (Riffer::Messages::FilePart) -> Hash[Symbol, untyped]
-  def convert_file_part_to_gemini_format: (Riffer::Messages::FilePart) -> Hash[Symbol, untyped]
+  # : (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
+  def convert_file_part_to_gemini_format: (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
 
   # --
   # : (singleton(Riffer::Tool)) -> Hash[Symbol, untyped]

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

@@ -43,10 +43,11 @@ class Riffer::Providers::Mock < Riffer::Providers::Base
   #   provider.stub_response("Final response",
   #                          token_usage: Riffer::Providers::TokenUsage.new(input_tokens: 10, output_tokens: 5))
   #   provider.stub_response("Truncated...", finish_reason: :length)
+  #   provider.stub_response("Answer", reasoning: [{type: :text, text: "Thinking...", format: "mock-v1"}])
   #
   # --
-  # : (String, ?tool_calls: Array[Hash[Symbol, untyped]], ?token_usage: Riffer::Providers::TokenUsage?, ?finish_reason: Symbol?) -> void
-  def stub_response: (String, ?tool_calls: Array[Hash[Symbol, untyped]], ?token_usage: Riffer::Providers::TokenUsage?, ?finish_reason: Symbol?) -> void
+  # : (String, ?tool_calls: Array[Hash[Symbol, untyped]], ?token_usage: Riffer::Providers::TokenUsage?, ?finish_reason: Symbol?, ?reasoning: Array[Hash[Symbol, untyped] | Riffer::Messages::Assistant::ReasoningPart]) -> void
+  def stub_response: (String, ?tool_calls: Array[Hash[Symbol, untyped]], ?token_usage: Riffer::Providers::TokenUsage?, ?finish_reason: Symbol?, ?reasoning: Array[Hash[Symbol, untyped] | Riffer::Messages::Assistant::ReasoningPart]) -> void
 
   # Clears all stubbed responses.
   #
@@ -76,6 +77,10 @@ class Riffer::Providers::Mock < Riffer::Providers::Base
   # : (untyped) -> Riffer::Providers::FinishReason?
   def extract_finish_reason: (untyped) -> Riffer::Providers::FinishReason?
 
+  # --
+  # : (untyped) -> Array[Riffer::Messages::Assistant::ReasoningPart]
+  def extract_reasoning: (untyped) -> Array[Riffer::Messages::Assistant::ReasoningPart]
+
   # --
   # : (untyped) -> String
   def extract_content: (untyped) -> String

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

@@ -19,8 +19,8 @@ class Riffer::Providers::OpenAI < 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
 
@@ -125,8 +125,8 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
   def convert_assistant_to_openai_format: (Riffer::Messages::Assistant) -> (Hash[Symbol, untyped] | Array[Hash[Symbol, untyped]])
 
   # --
-  # : (Riffer::Messages::FilePart) -> Hash[Symbol, untyped]
-  def convert_file_part_to_openai_format: (Riffer::Messages::FilePart) -> Hash[Symbol, untyped]
+  # : (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
+  def convert_file_part_to_openai_format: (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
 
   # --
   # : (singleton(Riffer::Tool)) -> Hash[Symbol, untyped]

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

@@ -19,8 +19,8 @@ class Riffer::Providers::OpenRouter < 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
 
@@ -114,8 +114,8 @@ class Riffer::Providers::OpenRouter < Riffer::Providers::Base
   def convert_assistant_to_chat_completions_format: (Riffer::Messages::Assistant) -> Hash[Symbol, untyped]
 
   # --
-  # : (Riffer::Messages::FilePart) -> Hash[Symbol, untyped]
-  def convert_file_part_to_chat_completions_format: (Riffer::Messages::FilePart) -> Hash[Symbol, untyped]
+  # : (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
+  def convert_file_part_to_chat_completions_format: (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
 
   # --
   # : (singleton(Riffer::Tool)) -> Hash[Symbol, untyped]

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

@@ -3,6 +3,12 @@
 # Normalized token usage for an LLM API call. Buckets carry the same
 # meaning for every provider.
 class Riffer::Providers::TokenUsage
+  # Builds a TokenUsage from a hash, or returns +usage+ unchanged when it is
+  # already a TokenUsage.
+  # --
+  # : ((Hash[Symbol, untyped] | Riffer::Providers::TokenUsage)) -> Riffer::Providers::TokenUsage
+  def self.from_hash: (Hash[Symbol, untyped] | Riffer::Providers::TokenUsage) -> Riffer::Providers::TokenUsage
+
   # Number of tokens entering the context window, including cache reads and writes.
   attr_reader input_tokens: Integer
 

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

@@ -45,4 +45,13 @@ class Riffer::Skills::Config
   # --
   # : (?singleton(Riffer::Tool)?) -> singleton(Riffer::Tool)?
   def activate_tool: (?singleton(Riffer::Tool)?) -> singleton(Riffer::Tool)?
+
+  private
+
+  # +dup+ would leave the copy sharing this one's activation list, so activating
+  # a skill on either would reach the other. DeepDup rebuilds the list and
+  # returns a Proc as-is, which has nothing to alias.
+  # --
+  # : (Riffer::Skills::Config) -> void
+  def initialize_copy: (Riffer::Skills::Config) -> void
 end

data/sig/generated/riffer/stream_events/reasoning_done.rbs

@@ -1,14 +1,16 @@
 # Generated from lib/riffer/stream_events/reasoning_done.rb with RBS::Inline
 
-# Represents completed reasoning during streaming; only emitted by providers
-# that support reasoning (e.g. OpenAI with the reasoning option).
+# Represents one completed reasoning block during streaming; only emitted by
+# providers that support reasoning (e.g. OpenAI with the reasoning option).
 class Riffer::StreamEvents::ReasoningDone < Riffer::StreamEvents::Base
-  # The complete reasoning content.
-  attr_reader content: String
+  # The reasoning block, which the agent loop accumulates onto the assistant
+  # message. Its +text+ is the content the preceding ReasoningDelta events
+  # added up to.
+  attr_reader part: Riffer::Messages::Assistant::ReasoningPart
 
   # --
-  # : (String, ?role: Symbol) -> void
-  def initialize: (String, ?role: Symbol) -> void
+  # : (Riffer::Messages::Assistant::ReasoningPart, ?role: Symbol) -> void
+  def initialize: (Riffer::Messages::Assistant::ReasoningPart, ?role: Symbol) -> void
 
   # --
   # : () -> Hash[Symbol, untyped]

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

@@ -44,8 +44,8 @@ class Riffer::Tools::Runtime
   def dispatch_tool_call: (Riffer::Messages::Assistant::ToolCall, tools: Array[singleton(Riffer::Tool)], context: Riffer::Agent::Context?, ?assistant_message: Riffer::Messages::Assistant?) -> Riffer::Tools::Response
 
   # --
-  # : (String?) -> untyped
-  def parse_arguments: (String?) -> untyped
+  # : (String) -> untyped
+  def parse_arguments: (String) -> untyped
 
   # Emitted outside +around_tool_call+ so host enrichment spans nest beneath it.
   # --

data/sig/generated/riffer/tracing/capture.rbs

@@ -35,12 +35,12 @@ module Riffer::Tracing::Capture
   def tool_call_part: (Riffer::Messages::Assistant::ToolCall) -> Hash[Symbol, untyped]
 
   # --
-  # : (Riffer::Messages::FilePart) -> Hash[Symbol, untyped]
-  def file_part: (Riffer::Messages::FilePart) -> Hash[Symbol, untyped]
+  # : (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
+  def file_part: (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
 
   # Semconv's tool_call part carries arguments as a JSON object; riffer holds
   # them as a string — parse so the captured payload isn't double-encoded.
   # --
-  # : (untyped) -> untyped
-  def parse_arguments: (untyped) -> untyped
+  # : (String) -> untyped
+  def parse_arguments: (String) -> untyped
 end

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

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: riffer
 version: !ruby/object:Gem::Version
-  version: 0.47.2
+  version: 0.48.0
 platform: ruby
 authors:
 - Jake Bottrall
@@ -138,6 +138,7 @@ files:
 - lib/riffer/helpers.rb
 - lib/riffer/helpers/boolean.rb
 - lib/riffer/helpers/call_or_value.rb
+- lib/riffer/helpers/deep_dup.rb
 - lib/riffer/helpers/dependencies.rb
 - lib/riffer/helpers/identifier.rb
 - lib/riffer/mcp.rb
@@ -151,11 +152,13 @@ files:
 - lib/riffer/mcp/tool_factory.rb
 - lib/riffer/messages.rb
 - lib/riffer/messages/assistant.rb
+- lib/riffer/messages/assistant/reasoning_part.rb
+- lib/riffer/messages/assistant/tool_call.rb
 - lib/riffer/messages/base.rb
-- lib/riffer/messages/file_part.rb
 - lib/riffer/messages/system.rb
 - lib/riffer/messages/tool.rb
 - lib/riffer/messages/user.rb
+- lib/riffer/messages/user/file_part.rb
 - lib/riffer/params.rb
 - lib/riffer/params/boolean.rb
 - lib/riffer/params/param.rb
@@ -269,6 +272,7 @@ files:
 - sig/generated/riffer/helpers.rbs
 - sig/generated/riffer/helpers/boolean.rbs
 - sig/generated/riffer/helpers/call_or_value.rbs
+- sig/generated/riffer/helpers/deep_dup.rbs
 - sig/generated/riffer/helpers/dependencies.rbs
 - sig/generated/riffer/helpers/identifier.rbs
 - sig/generated/riffer/mcp.rbs
@@ -282,11 +286,13 @@ files:
 - sig/generated/riffer/mcp/tool_factory.rbs
 - sig/generated/riffer/messages.rbs
 - sig/generated/riffer/messages/assistant.rbs
+- sig/generated/riffer/messages/assistant/reasoning_part.rbs
+- sig/generated/riffer/messages/assistant/tool_call.rbs
 - sig/generated/riffer/messages/base.rbs
-- sig/generated/riffer/messages/file_part.rbs
 - sig/generated/riffer/messages/system.rbs
 - sig/generated/riffer/messages/tool.rbs
 - sig/generated/riffer/messages/user.rbs
+- sig/generated/riffer/messages/user/file_part.rbs
 - sig/generated/riffer/params.rbs
 - sig/generated/riffer/params/boolean.rbs
 - sig/generated/riffer/params/param.rbs
@@ -359,6 +365,7 @@ files:
 - sig/manual/riffer/evals/evaluator_runner.rbs
 - sig/manual/riffer/helpers/boolean.rbs
 - sig/manual/riffer/helpers/call_or_value.rbs
+- sig/manual/riffer/helpers/deep_dup.rbs
 - sig/manual/riffer/helpers/dependencies.rbs
 - sig/manual/riffer/helpers/identifier.rbs
 - sig/manual/riffer/mcp.rbs