riffer 0.48.0 → 0.49.0

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

@@ -1,6 +1,5 @@
 # Generated from lib/riffer/tools/runtime/inline.rb with RBS::Inline
 
-# Executes tool calls sequentially in the current thread — the default runtime.
 class Riffer::Tools::Runtime::Inline < Riffer::Tools::Runtime
   # --
   # : () -> void

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

@@ -1,10 +1,5 @@
 # Generated from lib/riffer/tools/runtime/threaded.rb with RBS::Inline
 
-# Executes tool calls concurrently using threads.
-#
-#   class MyAgent < Riffer::Agent
-#     tool_runtime Riffer::Tools::Runtime::Threaded
-#   end
 class Riffer::Tools::Runtime::Threaded < Riffer::Tools::Runtime
   DEFAULT_MAX_CONCURRENCY: Integer
 

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

@@ -1,8 +1,5 @@
 # Generated from lib/riffer/tools/runtime.rb with RBS::Inline
 
-# Handles tool call execution for an agent, composing with a Riffer::Runner for
-# concurrency. Subclass and override +dispatch_tool_call+ to customize dispatch
-# (e.g. HTTP, gRPC).
 class Riffer::Tools::Runtime
   @runner: Riffer::Runner
 
@@ -10,25 +7,11 @@ class Riffer::Tools::Runtime
   # : (runner: Riffer::Runner) -> void
   def initialize: (runner: Riffer::Runner) -> void
 
-  # Executes a batch of tool calls, returning <tt>[tool_call, response]</tt> pairs.
   # --
   # : (Array[Riffer::Messages::Assistant::ToolCall], tools: Array[singleton(Riffer::Tool)], context: Riffer::Agent::Context?, ?assistant_message: Riffer::Messages::Assistant?, ?tags: Hash[String, String]) -> Array[[Riffer::Messages::Assistant::ToolCall, Riffer::Tools::Response]]
   def execute: (Array[Riffer::Messages::Assistant::ToolCall], tools: Array[singleton(Riffer::Tool)], context: Riffer::Agent::Context?, ?assistant_message: Riffer::Messages::Assistant?, ?tags: Hash[String, String]) -> Array[[ Riffer::Messages::Assistant::ToolCall, Riffer::Tools::Response ]]
 
-  # Hook wrapping each tool call; override in subclasses to instrument or
-  # customize. Must +yield+ to continue.
-  #
-  #   class InstrumentedRuntime < Riffer::Tools::Runtime::Inline
-  #     private
-  #
-  #     def around_tool_call(tool_call, context:, assistant_message: nil)
-  #       start = Time.now
-  #       result = yield
-  #       Rails.logger.info("Tool #{tool_call.name} took #{Time.now - start}s")
-  #       result
-  #     end
-  #   end
-  #
+  # Overrides must +yield+ and return its Response.
   # --
   # : (Riffer::Messages::Assistant::ToolCall, context: Riffer::Agent::Context?, ?assistant_message: Riffer::Messages::Assistant?) { () -> Riffer::Tools::Response } -> Riffer::Tools::Response
   def around_tool_call: (Riffer::Messages::Assistant::ToolCall, context: Riffer::Agent::Context?, ?assistant_message: Riffer::Messages::Assistant?) { () -> Riffer::Tools::Response } -> Riffer::Tools::Response
@@ -39,6 +22,7 @@ class Riffer::Tools::Runtime
   # : (Riffer::Messages::Assistant::ToolCall, ?Hash[String, String]) { () -> Riffer::Tools::Response } -> [Riffer::Messages::Assistant::ToolCall, Riffer::Tools::Response]
   def instrument_tool_call: (Riffer::Messages::Assistant::ToolCall, ?Hash[String, String]) { () -> Riffer::Tools::Response } -> [ Riffer::Messages::Assistant::ToolCall, Riffer::Tools::Response ]
 
+  # Subclasses override this to dispatch elsewhere (e.g. HTTP, gRPC).
   # --
   # : (Riffer::Messages::Assistant::ToolCall, tools: Array[singleton(Riffer::Tool)], context: Riffer::Agent::Context?, ?assistant_message: Riffer::Messages::Assistant?) -> Riffer::Tools::Response
   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
@@ -47,7 +31,6 @@ class Riffer::Tools::Runtime
   # : (String) -> untyped
   def parse_arguments: (String) -> untyped
 
-  # Emitted outside +around_tool_call+ so host enrichment spans nest beneath it.
   # --
   # : [R] (Riffer::Messages::Assistant::ToolCall, ?Hash[String, String]) { ((Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span)) -> R } -> R
   def in_tool_span: [R] (Riffer::Messages::Assistant::ToolCall, ?Hash[String, String]) { (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span) -> R } -> R
@@ -56,15 +39,10 @@ class Riffer::Tools::Runtime
   # : (Riffer::Messages::Assistant::ToolCall, ?Hash[String, String]) -> Hash[String, untyped]
   def tool_span_attributes: (Riffer::Messages::Assistant::ToolCall, ?Hash[String, String]) -> 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]
 
-  # A deliberate error Response is a handled outcome, so its status stays unset.
-  # An error status is reserved for a Response carrying the exception it was
-  # folded from — the tool failed for a reason nobody anticipated.
   # --
   # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span), Riffer::Tools::Response) -> void
   def record_tool_outcome: (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span, Riffer::Tools::Response) -> void

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

@@ -1,19 +1,5 @@
 # Generated from lib/riffer/tools/toolable.rb with RBS::Inline
 
-# Shared class-level DSL for anything that presents as a tool to an LLM. Extend
-# it to make a class discoverable as a tool; instance-level execution (+call+,
-# +call_with_validation+) lives on Riffer::Tool instead.
-#
-#   class MyTool
-#     extend Riffer::Tools::Toolable
-#
-#     description "Does something useful"
-#
-#     params do
-#       required :input, String
-#     end
-#   end
-#
 # @rbs module-self Module
 module Riffer::Tools::Toolable : Module
   @kind: Symbol?
@@ -30,69 +16,46 @@ module Riffer::Tools::Toolable : Module
 
   DEFAULT_TIMEOUT: Integer
 
-  # Tracks all classes that extend Toolable.
-  #
   # --
   # : (Module) -> void
   def self.extended: (Module) -> void
 
-  # Returns all classes that have extended Toolable.
-  #
   # --
   # : () -> Array[Module]
   def self.all: () -> Array[Module]
 
-  # Gets or sets the tool description.
-  #
   # --
   # : (?String?) -> String?
   def description: (?String?) -> String?
 
-  # Gets or sets the tool identifier/name.
-  #
   # --
   # : (?String?) -> String
   def identifier: (?String?) -> String
 
-  # Alias for identifier — used by providers.
-  #
   # --
   # : (?String?) -> String
   def name: (?String?) -> String
 
-  # Gets or sets the tool timeout in seconds.
-  #
   # --
   # : (?(Integer | Float)?) -> (Integer | Float)
   def timeout: (?(Integer | Float)?) -> (Integer | Float)
 
-  # Defines parameters using the Params DSL.
-  #
   # --
   # : () ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
   def params: () ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
 
-  # Returns the JSON Schema for the tool's parameters.
-  #
   # --
   # : (?strict: bool) -> Hash[Symbol, untyped]
   def parameters_schema: (?strict: bool) -> Hash[Symbol, untyped]
 
-  # Returns the kind of toolable entity; defaults to +:tool+.
   # --
   # : (?Symbol?) -> Symbol
   def kind: (?Symbol?) -> Symbol
 
-  # Returns a provider-agnostic tool schema hash.
-  #
   # --
   # : (?strict: bool) -> Hash[Symbol, untyped]
   def to_tool_schema: (?strict: bool) -> Hash[Symbol, untyped]
 
-  # Validates that the minimum required metadata is present for LLM tool use.
-  #
-  # Raises Riffer::ArgumentError if validation fails.
-  #
   # --
   # : () -> true
   def validate_as_tool!: () -> true

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

@@ -1,8 +1,5 @@
 # Generated from lib/riffer/tracing/capture.rb with RBS::Inline
 
-# Serializes riffer messages into the GenAI semconv JSON message structure
-# for opt-in span content capture. File parts become metadata-only stubs —
-# bytes and URLs never reach a span attribute.
 module Riffer::Tracing::Capture
   # --
   # : (Array[Riffer::Messages::Base]) -> String
@@ -38,8 +35,8 @@ module Riffer::Tracing::Capture
   # : (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.
+  # Semconv's tool_call part carries arguments as a JSON object, so a string
+  # would be double-encoded.
   # --
   # : (String) -> untyped
   def parse_arguments: (String) -> untyped

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

@@ -1,10 +1,6 @@
 # Generated from lib/riffer/tracing/no_op.rb with RBS::Inline
 
-# No-op tracing backend, used when OTEL is unavailable or tracing is
-# disabled.
 module Riffer::Tracing::NoOp
-  # No-op stand-in for a span; answers <tt>recording?</tt> with +false+ so
-  # callers can skip expensive attribute serialization.
   class Span
     # --
     # : (String, untyped) -> void
@@ -29,17 +25,14 @@ module Riffer::Tracing::NoOp
 
   SPAN: Riffer::Tracing::NoOp::Span
 
-  # Yields the no-op span, ignoring all span options.
   # --
   # : [R] (String, **untyped) { (Riffer::Tracing::NoOp::Span) -> R } -> R
   def in_span: [R] (String, **untyped) { (Riffer::Tracing::NoOp::Span) -> R } -> R
 
-  # Returns +nil+; there is no trace context without OTEL.
   # --
   # : () -> nil
   def current_context: () -> nil
 
-  # Yields immediately; there is no context to attach.
   # --
   # : [R] (untyped) { () -> R } -> R
   def with_context: [R] (untyped) { () -> R } -> R

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

@@ -1,14 +1,13 @@
 # Generated from lib/riffer/tracing/otel.rb with RBS::Inline
 
-# OTEL-backed tracing backend. <tt>::OpenTelemetry</tt> constants appear only
-# inside method bodies here, so the gem loads and eager-loads cleanly when the
-# OpenTelemetry API is absent.
+# <tt>::OpenTelemetry</tt> constants must appear only inside method bodies, so
+# the gem eager-loads cleanly when the OpenTelemetry API is absent.
 class Riffer::Tracing::Otel
   # :nodoc: all
   SUPPORTED_API_VERSIONS: Gem::Requirement
 
-  # Wraps a live OTEL span behind the port's span surface, so callers never
-  # touch <tt>::OpenTelemetry</tt> constants (status objects in particular).
+  # Keeps callers from touching <tt>::OpenTelemetry</tt> constants (status
+  # objects in particular).
   class Span
     @otel_span: untyped
 
@@ -28,7 +27,6 @@ class Riffer::Tracing::Otel
     # : (Exception) -> void
     def record_exception: (Exception) -> void
 
-    # Marks the span status as error.
     # --
     # : (?String) -> void
     def error!: (?String) -> void
@@ -38,21 +36,17 @@ class Riffer::Tracing::Otel
     def recording?: () -> bool
   end
 
-  # Builds a backend when the OpenTelemetry API is loadable at a supported
-  # version; returns +nil+ so resolution falls back to NoOp. +provider+
-  # defaults to the global <tt>OpenTelemetry.tracer_provider</tt>.
+  # Returns +nil+ so resolution falls back to NoOp.
   # --
   # : (?provider: untyped) -> Riffer::Tracing::Otel?
   def self.build: (?provider: untyped) -> Riffer::Tracing::Otel?
 
-  # Whether the OpenTelemetry API gem is loadable at a supported version.
   # --
   # : () -> bool
   def self.available?: () -> bool
 
-  # Whether the given opentelemetry-api version is one riffer codes
-  # against. The gem is undeclared, so this guard is the only protection
-  # against an incompatible API.
+  # opentelemetry-api is undeclared, so this is the only protection against
+  # an incompatible API.
   # --
   # : (Gem::Version) -> bool
   def self.supported?: (Gem::Version) -> bool
@@ -67,17 +61,14 @@ class Riffer::Tracing::Otel
   # : (provider: untyped) -> void
   def initialize: (provider: untyped) -> void
 
-  # Opens an OTEL span around the block, yielding the wrapped span.
   # --
   # : [R] (String, attributes: Hash[String, untyped]?, kind: Symbol) { (Riffer::Tracing::Otel::Span) -> R } -> R
   def in_span: [R] (String, attributes: Hash[String, untyped]?, kind: Symbol) { (Riffer::Tracing::Otel::Span) -> R } -> R
 
-  # Returns the active OTEL context.
   # --
   # : () -> untyped
   def current_context: () -> untyped
 
-  # Runs the block with the given OTEL context active.
   # --
   # : [R] (untyped) { () -> R } -> R
   def with_context: [R] (untyped) { () -> R } -> R

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

@@ -1,7 +1,5 @@
 # Generated from lib/riffer/tracing/stream_recorder.rb with RBS::Inline
 
-# Wraps a stream yielder to observe terminal events for span stamping while
-# forwarding every event downstream untouched.
 class Riffer::Tracing::StreamRecorder
   @yielder: Enumerator::Yielder
 

data/sig/generated/riffer/tracing.rbs

@@ -1,52 +1,33 @@
 # Generated from lib/riffer/tracing.rb with RBS::Inline
 
-# Internal tracing port — emits OTEL spans when the host bundles the
-# OpenTelemetry API and no-ops otherwise, so riffer never declares an OTEL
-# dependency.
+# No-ops unless the host bundles the OpenTelemetry API, so riffer never
+# declares an OTEL dependency.
 module Riffer::Tracing
-  @backend: untyped
-
-  MUTEX: Mutex
-
   # The Ruby API cannot attach a schema URL to a tracer, so the semconv pin
   # lives here as the documented contract version.
   SCHEMA_URL: String
 
-  # Opens a span around the block, yielding the span.
   # --
   # : [R] (String, ?attributes: Hash[String, untyped]?, ?kind: Symbol) { (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span) -> R } -> R
   def in_span: [R] (String, ?attributes: Hash[String, untyped]?, ?kind: Symbol) { (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span) -> R } -> R
 
-  # Returns the active trace context, for re-attachment across fiber or
-  # thread boundaries.
+  # For re-attachment across fiber or thread boundaries.
   # --
   # : () -> untyped
   def current_context: () -> untyped
 
-  # Runs the block with the given trace context active; +nil+ passes through
-  # so captures taken while tracing was dark stay harmless.
+  # +nil+ passes through so captures taken while tracing was off stay harmless.
   # --
   # : [R] (untyped) { () -> R } -> R
   def with_context: [R] (untyped) { () -> R } -> R
 
-  # Stamps token usage onto the span — the <tt>gen_ai.usage.*</tt> counts and,
-  # when the model was priced, <tt>riffer.cost</tt>.
   # --
   # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span), Riffer::Providers::TokenUsage?) -> void
   def record_usage: (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span, Riffer::Providers::TokenUsage?) -> void
 
-  # Discards the resolved backend so the next span re-resolves it.
-  # --
-  # : () -> void
-  def reset!: () -> void
-
   private
 
   # --
   # : () -> untyped
   def backend: () -> untyped
-
-  # --
-  # : () -> untyped
-  def resolve_backend: () -> untyped
 end

data/sig/generated/riffer.rbs

@@ -3,89 +3,62 @@
 module Riffer
   @config: Riffer::Config?
 
-  # Base error class for Riffer.
   class Error < StandardError
   end
 
-  # Raised when invalid arguments are provided.
   class ArgumentError < ::ArgumentError
   end
 
-  # Raised when tool parameter validation fails.
   class ValidationError < Error
   end
 
-  # Raised inside a tool's +call+ when execution exceeds the configured
-  # timeout. Rescue it in the tool to clean up; otherwise it becomes a
+  # Rescue it in the tool to clean up; otherwise it becomes a
   # +:timeout_error+ response.
   class TimeoutError < Error
   end
 
-  # 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.
+  # 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
 
-  # Raised when the provider can't accept the file at all.
   class FileUnsupportedError < FileError
   end
 
-  # Raised when a download is required but Riffer.config.files.allow_downloads is false.
   class FileDownloadsDisabledError < FileError
   end
 
-  # Raised when a message carries more files than Riffer.config.files.max_per_message allows.
   class TooManyFilesError < FileError
   end
 
-  # Raised when there's an issue downloading a file
   class FileDownloadError < FileError
   end
 
-  # Raised when a file size exceeds Riffer.config.files.max_bytes
   class FileTooLargeError < FileError
   end
 
-  # Raised when a downloaded or inline file's sha256 doesn't match.
   class FileChecksumMismatchError < FileError
   end
 
-  # Raised when a FilePart's data isn't valid base64
   class FileEncodingError < FileError
   end
 
-  # Raised when two registered subclasses share the same identifier.
   class DuplicateIdentifierError < Error
   end
 
-  # Returns the Riffer configuration.
-  #
   # --
   # : () -> Riffer::Config
   def config: () -> Riffer::Config
 
-  # Yields the configuration for block-based setup.
-  #
-  #   Riffer.configure do |config|
-  #     config.openai.api_key = ENV['OPENAI_API_KEY']
-  #   end
-  #
   # --
   # : () ?{ (Riffer::Config) -> void } -> void
   def configure: () ?{ (Riffer::Config) -> void } -> void
 
-  # Returns the gem version.
   # --
   # : () -> String
   def version: () -> String

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

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: riffer
 version: !ruby/object:Gem::Version
-  version: 0.48.0
+  version: 0.49.0
 platform: ruby
 authors:
 - Jake Bottrall
@@ -119,6 +119,19 @@ files:
 - lib/riffer/agent/structured_output.rb
 - lib/riffer/agent/structured_output/result.rb
 - lib/riffer/config.rb
+- lib/riffer/config/amazon_bedrock.rb
+- lib/riffer/config/anthropic.rb
+- lib/riffer/config/azure_open_ai.rb
+- lib/riffer/config/evals.rb
+- lib/riffer/config/files.rb
+- lib/riffer/config/gemini.rb
+- lib/riffer/config/mcp.rb
+- lib/riffer/config/open_ai.rb
+- lib/riffer/config/open_router.rb
+- lib/riffer/config/pricing.rb
+- lib/riffer/config/pricing/rates.rb
+- lib/riffer/config/skills.rb
+- lib/riffer/config/tracing.rb
 - lib/riffer/evals.rb
 - lib/riffer/evals/evaluator.rb
 - lib/riffer/evals/evaluator_runner.rb
@@ -141,6 +154,7 @@ files:
 - lib/riffer/helpers/deep_dup.rb
 - lib/riffer/helpers/dependencies.rb
 - lib/riffer/helpers/identifier.rb
+- lib/riffer/helpers/validate.rb
 - lib/riffer/mcp.rb
 - lib/riffer/mcp/authenticated_tool.rb
 - lib/riffer/mcp/client.rb
@@ -253,6 +267,19 @@ files:
 - sig/generated/riffer/agent/structured_output.rbs
 - sig/generated/riffer/agent/structured_output/result.rbs
 - sig/generated/riffer/config.rbs
+- sig/generated/riffer/config/amazon_bedrock.rbs
+- sig/generated/riffer/config/anthropic.rbs
+- sig/generated/riffer/config/azure_open_ai.rbs
+- sig/generated/riffer/config/evals.rbs
+- sig/generated/riffer/config/files.rbs
+- sig/generated/riffer/config/gemini.rbs
+- sig/generated/riffer/config/mcp.rbs
+- sig/generated/riffer/config/open_ai.rbs
+- sig/generated/riffer/config/open_router.rbs
+- sig/generated/riffer/config/pricing.rbs
+- sig/generated/riffer/config/pricing/rates.rbs
+- sig/generated/riffer/config/skills.rbs
+- sig/generated/riffer/config/tracing.rbs
 - sig/generated/riffer/evals.rbs
 - sig/generated/riffer/evals/evaluator.rbs
 - sig/generated/riffer/evals/evaluator_runner.rbs
@@ -275,6 +302,7 @@ files:
 - sig/generated/riffer/helpers/deep_dup.rbs
 - sig/generated/riffer/helpers/dependencies.rbs
 - sig/generated/riffer/helpers/identifier.rbs
+- sig/generated/riffer/helpers/validate.rbs
 - sig/generated/riffer/mcp.rbs
 - sig/generated/riffer/mcp/authenticated_tool.rbs
 - sig/generated/riffer/mcp/client.rbs
@@ -368,6 +396,7 @@ files:
 - sig/manual/riffer/helpers/deep_dup.rbs
 - sig/manual/riffer/helpers/dependencies.rbs
 - sig/manual/riffer/helpers/identifier.rbs
+- sig/manual/riffer/helpers/validate.rbs
 - sig/manual/riffer/mcp.rbs
 - sig/manual/riffer/mcp/authenticated_tool.rbs
 - sig/manual/riffer/mcp/registry.rbs