riffer 0.47.0 → 0.47.2

data/lib/riffer/stream_events/reasoning_delta.rb

@@ -5,7 +5,7 @@
 # providers that support reasoning (e.g. OpenAI with the reasoning option).
 class Riffer::StreamEvents::ReasoningDelta < Riffer::StreamEvents::Base
   # The incremental reasoning content.
-  attr_reader :content #: String
+  attr_reader :content #: String # @dynamic content
 
   #--
   #: (String, ?role: Symbol) -> void

data/lib/riffer/stream_events/reasoning_done.rb

@@ -5,7 +5,7 @@
 # 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
+  attr_reader :content #: String # @dynamic content
 
   #--
   #: (String, ?role: Symbol) -> void

data/lib/riffer/stream_events/skill_activation.rb

@@ -5,7 +5,7 @@
 # callback when the LLM calls the activation tool.
 class Riffer::StreamEvents::SkillActivation < Riffer::StreamEvents::Base
   # The activated skill name.
-  attr_reader :name #: String
+  attr_reader :name #: String # @dynamic name
 
   #--
   #: (String, ?role: Symbol) -> void

data/lib/riffer/stream_events/text_delta.rb

@@ -4,7 +4,7 @@
 # Represents an incremental text chunk during streaming.
 class Riffer::StreamEvents::TextDelta < Riffer::StreamEvents::Base
   # The incremental text content.
-  attr_reader :content #: String
+  attr_reader :content #: String # @dynamic content
 
   #--
   #: (String, ?role: Symbol) -> void

data/lib/riffer/stream_events/text_done.rb

@@ -4,7 +4,7 @@
 # Represents completed text generation during streaming.
 class Riffer::StreamEvents::TextDone < Riffer::StreamEvents::Base
   # The complete text content.
-  attr_reader :content #: String
+  attr_reader :content #: String # @dynamic content
 
   #--
   #: (String, ?role: Symbol) -> void

data/lib/riffer/stream_events/token_usage_done.rb

@@ -4,7 +4,7 @@
 # Final token usage for the response, emitted when the LLM finishes.
 class Riffer::StreamEvents::TokenUsageDone < Riffer::StreamEvents::Base
   # The token usage data for this response.
-  attr_reader :token_usage #: Riffer::Providers::TokenUsage
+  attr_reader :token_usage #: Riffer::Providers::TokenUsage # @dynamic token_usage
 
   #--
   #: (token_usage: Riffer::Providers::TokenUsage, ?role: Symbol) -> void

data/lib/riffer/stream_events/tool_call_delta.rb

@@ -5,13 +5,13 @@
 # streaming.
 class Riffer::StreamEvents::ToolCallDelta < Riffer::StreamEvents::Base
   # The tool call item identifier.
-  attr_reader :item_id #: String
+  attr_reader :item_id #: String # @dynamic item_id
 
   # The tool name (may only be present in first delta).
-  attr_reader :name #: String?
+  attr_reader :name #: String? # @dynamic name
 
   # The incremental arguments JSON fragment.
-  attr_reader :arguments_delta #: String
+  attr_reader :arguments_delta #: String # @dynamic arguments_delta
 
   #--
   #: (item_id: String, arguments_delta: String, ?name: String?, ?role: Symbol) -> void

data/lib/riffer/stream_events/tool_call_done.rb

@@ -4,16 +4,16 @@
 # Represents a completed tool call during streaming.
 class Riffer::StreamEvents::ToolCallDone < Riffer::StreamEvents::Base
   # The tool call item identifier.
-  attr_reader :item_id #: String
+  attr_reader :item_id #: String # @dynamic item_id
 
   # The call identifier for response matching.
-  attr_reader :call_id #: String
+  attr_reader :call_id #: String # @dynamic call_id
 
   # The tool name.
-  attr_reader :name #: String
+  attr_reader :name #: String # @dynamic name
 
   # The complete arguments JSON string.
-  attr_reader :arguments #: String
+  attr_reader :arguments #: String # @dynamic arguments
 
   #--
   #: (item_id: String, call_id: String, name: String, arguments: String, ?role: Symbol) -> void

data/lib/riffer/stream_events/web_search_done.rb

@@ -4,10 +4,10 @@
 # The result of a completed server-side web search during streaming.
 class Riffer::StreamEvents::WebSearchDone < Riffer::StreamEvents::Base
   # The search query used.
-  attr_reader :query #: String
+  attr_reader :query #: String # @dynamic query
 
   # The search result sources with title and url.
-  attr_reader :sources #: Array[Hash[Symbol, String?]]
+  attr_reader :sources #: Array[Hash[Symbol, String?]] # @dynamic sources
 
   #--
   #: (String, ?sources: Array[Hash[Symbol, String?]], ?role: Symbol) -> void

data/lib/riffer/stream_events/web_search_status.rb

@@ -5,13 +5,13 @@
 # progresses.
 class Riffer::StreamEvents::WebSearchStatus < Riffer::StreamEvents::Base
   # The web search status ("in_progress", "searching", "completed", "open_page").
-  attr_reader :status #: String
+  attr_reader :status #: String # @dynamic status
 
   # The URL being fetched (present for "open_page" status).
-  attr_reader :url #: String?
+  attr_reader :url #: String? # @dynamic url
 
   # The search query (present when available during status changes).
-  attr_reader :query #: String?
+  attr_reader :query #: String? # @dynamic query
 
   #--
   #: (String, ?url: String?, ?query: String?, ?role: Symbol) -> void

data/lib/riffer/tools/response.rb

@@ -20,17 +20,17 @@ class Riffer::Tools::Response
   VALID_FORMATS = %i[text json].freeze #: Array[Symbol]
 
   # The response content.
-  attr_reader :content #: String
+  attr_reader :content #: String # @dynamic content
 
   # The error message, or +nil+ on success.
-  attr_reader :error_message #: String?
+  attr_reader :error_message #: String? # @dynamic error_message
 
   # The error type, or +nil+ on success.
-  attr_reader :error_type #: Symbol?
+  attr_reader :error_type #: Symbol? # @dynamic error_type
 
   # The exception an unhandled failure was folded from, or +nil+. Kept out of
   # every serialized form so it never reaches an LLM or a message payload.
-  attr_reader :exception #: Exception?
+  attr_reader :exception #: Exception? # @dynamic exception
 
   # Creates a success response.
   #

data/lib/riffer/tracing/stream_recorder.rb

@@ -8,17 +8,17 @@ class Riffer::Tracing::StreamRecorder # :nodoc: all
   # @rbs @clock: ^() -> Float
   # @rbs @started_at: Float
 
-  attr_reader :token_usage #: Riffer::Providers::TokenUsage?
+  attr_reader :token_usage #: Riffer::Providers::TokenUsage? # @dynamic token_usage
 
-  attr_reader :time_to_first_chunk #: Float?
+  attr_reader :time_to_first_chunk #: Float? # @dynamic time_to_first_chunk
 
-  attr_reader :finish_reason #: Symbol?
+  attr_reader :finish_reason #: Symbol? # @dynamic finish_reason
 
-  attr_reader :raw_finish_reason #: String?
+  attr_reader :raw_finish_reason #: String? # @dynamic raw_finish_reason
 
-  attr_reader :content #: String?
+  attr_reader :content #: String? # @dynamic content
 
-  attr_reader :tool_calls #: Array[Riffer::Messages::Assistant::ToolCall]
+  attr_reader :tool_calls #: Array[Riffer::Messages::Assistant::ToolCall] # @dynamic tool_calls
 
   #--
   #: (Enumerator::Yielder, ?clock: ^() -> Float) -> void

data/lib/riffer/version.rb

@@ -2,5 +2,5 @@
 # rbs_inline: enabled
 
 module Riffer
-  VERSION = "0.47.0" #: String
+  VERSION = "0.47.2" #: String
 end

data/lib/riffer.rb

@@ -41,6 +41,13 @@ module Riffer
   # Raised when a tool encounters an expected execution error.
   class ToolExecutionError < Error; end
 
+  # Raised when a provider's stream ends before its terminal event (Bedrock's
+  # messageStop, Anthropic's message_stop, OpenAI's response.completed /
+  # incomplete / failed), so a truncated or empty response is never returned
+  # as a complete message. Events already yielded were delivered; the
+  # request is safe to retry.
+  class IncompleteStreamError < Error; end
+
   # Base error for a file attachment that can't be resolved for the provider.
   class FileError < Error; end
 

data/rbs_collection.lock.yaml

@@ -0,0 +1,320 @@
+---
+path: ".gem_rbs_collection"
+gems:
+- name: addressable
+  version: '2.8'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: anthropic
+  version: 1.71.0
+  source:
+    type: rubygems
+- name: ast
+  version: '2.4'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: async
+  version: '2.12'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: aws-sdk-bedrockruntime
+  version: 1.85.0
+  source:
+    type: rubygems
+- name: aws-sdk-core
+  version: 3.257.0
+  source:
+    type: rubygems
+- name: base64
+  version: 0.3.0
+  source:
+    type: rubygems
+- name: bigdecimal
+  version: 4.1.3
+  source:
+    type: rubygems
+- name: cgi
+  version: '0.5'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: concurrent-ruby
+  version: '1.1'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: connection_pool
+  version: '2.4'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: csv
+  version: '3.3'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: dbm
+  version: '0'
+  source:
+    type: stdlib
+- name: delegate
+  version: '0'
+  source:
+    type: stdlib
+- name: digest
+  version: '0'
+  source:
+    type: stdlib
+- name: erb
+  version: '0'
+  source:
+    type: stdlib
+- name: faraday
+  version: '2.7'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: ffi
+  version: 1.17.4
+  source:
+    type: rubygems
+- name: fileutils
+  version: '0'
+  source:
+    type: stdlib
+- name: forwardable
+  version: '0'
+  source:
+    type: stdlib
+- name: hashdiff
+  version: '1.1'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: io-console
+  version: '0'
+  source:
+    type: stdlib
+- name: json
+  version: '0'
+  source:
+    type: stdlib
+- name: language_server-protocol
+  version: 3.17.0.6
+  source:
+    type: rubygems
+- name: listen
+  version: '3.9'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: logger
+  version: '1.7'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: minitest
+  version: '5.25'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: monitor
+  version: '0'
+  source:
+    type: stdlib
+- name: net-http
+  version: '0'
+  source:
+    type: stdlib
+- name: net-protocol
+  version: '0'
+  source:
+    type: stdlib
+- name: openai
+  version: 0.91.0
+  source:
+    type: rubygems
+- name: openssl
+  version: '0'
+  source:
+    type: stdlib
+- name: optparse
+  version: '0'
+  source:
+    type: stdlib
+- name: parser
+  version: '3.2'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: pp
+  version: '0'
+  source:
+    type: stdlib
+- name: prettyprint
+  version: '0'
+  source:
+    type: stdlib
+- name: prism
+  version: 1.9.0
+  source:
+    type: rubygems
+- name: pstore
+  version: '0.2'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: psych
+  version: '0'
+  source:
+    type: stdlib
+- name: rainbow
+  version: '3.0'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: rake
+  version: '13.0'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: random-formatter
+  version: '0'
+  source:
+    type: stdlib
+- name: rbs
+  version: 4.2.0
+  source:
+    type: rubygems
+- name: rbs-inline
+  version: 0.14.0
+  source:
+    type: rubygems
+- name: rdoc
+  version: '0'
+  source:
+    type: stdlib
+- name: regexp_parser
+  version: '2.8'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: securerandom
+  version: '0'
+  source:
+    type: stdlib
+- name: singleton
+  version: '0'
+  source:
+    type: stdlib
+- name: socket
+  version: '0'
+  source:
+    type: stdlib
+- name: stringio
+  version: '0'
+  source:
+    type: stdlib
+- name: strscan
+  version: '0'
+  source:
+    type: stdlib
+- name: tempfile
+  version: '0'
+  source:
+    type: stdlib
+- name: thor
+  version: '1.2'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: timeout
+  version: '0'
+  source:
+    type: stdlib
+- name: tmpdir
+  version: '0'
+  source:
+    type: stdlib
+- name: tsort
+  version: '0'
+  source:
+    type: stdlib
+- name: uri
+  version: '0'
+  source:
+    type: stdlib
+- name: webmock
+  version: '3.19'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: webrick
+  version: 1.9.2
+  source:
+    type: rubygems
+- name: yaml
+  version: '0'
+  source:
+    type: stdlib
+gemfile_lock_path: Gemfile.lock

data/rbs_collection.yaml

@@ -0,0 +1,12 @@
+sources:
+  - type: git
+    name: ruby/gem_rbs_collection
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
+    repo_dir: gems
+
+path: .gem_rbs_collection
+
+gems:
+  - name: yaml
+  - name: cgi

data/sig/_private/anthropic.rbs

@@ -1,7 +1,7 @@
-# Arity patch for the `anthropic` gem (see openai.rbs for the rationale).
-# `Messages#create` is positional at runtime but typed keyword-only in the gem's
-# RBS; `Messages#stream` is omitted from the gem's RBS but present at runtime
-# (returns a MessageStream helper). Loaded only for riffer's own Steep run.
+# Arity patch for the `anthropic` gem (see openai.rbs for the rationale). Both
+# `Messages#create` and `Messages#stream` are positional `def x(params)` at
+# runtime but typed keyword-only in the gem's RBS. Streaming returns `untyped`
+# (a MessageStream helper). Loaded only for riffer's own Steep run.
 module Anthropic
   module Resources
     class Messages
@@ -11,6 +11,7 @@ module Anthropic
 
       def stream: (Hash[Symbol, untyped] params) -> untyped
                 | (**untyped) -> untyped
+                | ...
     end
   end
 end

data/sig/_private/aws-sdk-core/event_error.rbs

@@ -0,0 +1,15 @@
+# aws-sdk-core ships no signature for EventError; ConverseStream delivers
+# `:message-type: error` frames to the on_event block as instances of it.
+module Aws
+  module Errors
+    class EventError < RuntimeError
+      def initialize: (Symbol event_type, String code, String message) -> void
+
+      attr_reader event_type: Symbol
+
+      attr_reader error_code: String
+
+      attr_reader error_message: String
+    end
+  end
+end

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

@@ -74,8 +74,17 @@ class Riffer::Params::Param
   # 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>.
+  # <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
+
+  # --
+  # : () -> void
+  def validate_strict_shape!: () -> void
 end

data/sig/generated/riffer/params.rbs

@@ -54,6 +54,8 @@ class Riffer::Params
   # 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]

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

@@ -91,10 +91,19 @@ class Riffer::Providers::AmazonBedrock < Riffer::Providers::Base
   # : (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.
+  # 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

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

@@ -15,8 +15,6 @@ module Riffer::Providers::Repository
   #
   #   Riffer::Providers::Repository.register(:jane) { MyApp::JaneProvider }
   #
-  # Raises Riffer::ArgumentError when called without a block.
-  #
   # --
   # : ((String | Symbol)) { () -> singleton(Riffer::Providers::Base) } -> void
   def register: (String | Symbol) { () -> singleton(Riffer::Providers::Base) } -> void

data/sig/generated/riffer.rbs

@@ -25,6 +25,14 @@ module Riffer
   class ToolExecutionError < Error
   end
 
+  # Raised when a provider's stream ends before its terminal event (Bedrock's
+  # messageStop, Anthropic's message_stop, OpenAI's response.completed /
+  # incomplete / failed), so a truncated or empty response is never returned
+  # as a complete message. Events already yielded were delivered; the
+  # request is safe to retry.
+  class IncompleteStreamError < Error
+  end
+
   # Base error for a file attachment that can't be resolved for the provider.
   class FileError < Error
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: riffer
 version: !ruby/object:Gem::Version
-  version: 0.47.0
+  version: 0.47.2
 platform: ruby
 authors:
 - Jake Bottrall
@@ -220,12 +220,13 @@ files:
 - lib/riffer/tracing/otel.rb
 - lib/riffer/tracing/stream_recorder.rb
 - lib/riffer/version.rb
+- rbs_collection.lock.yaml
+- rbs_collection.yaml
 - sig/_private/anthropic.rbs
-- sig/_private/async.rbs
+- sig/_private/aws-sdk-core/event_error.rbs
 - sig/_private/aws-sdk-core/seahorse_request_context.rbs
 - sig/_private/aws-sdk-core/static_token_provider.rbs
 - sig/_private/mcp.rbs
-- sig/_private/minitest.rbs
 - sig/_private/openai.rbs
 - sig/_private/opentelemetry.rbs
 - sig/_private/riffer/providers/amazon_bedrock.rbs