riffer 0.47.2 → 0.49.0

data/sig/generated/riffer/config.rbs

@@ -1,351 +1,46 @@
 # Generated from lib/riffer/config.rb with RBS::Inline
 
-# Configuration for the Riffer framework.
 class Riffer::Config
-  class AmazonBedrock < Struct[untyped]
-    attr_accessor api_token(): untyped
-
-    attr_accessor region(): untyped
-
-    attr_accessor client(): untyped
-
-    def self.new: (?untyped api_token, ?untyped region, ?untyped client) -> instance
-                | (?api_token: untyped, ?region: untyped, ?client: untyped) -> instance
-  end
-
-  class Anthropic < Struct[untyped]
-    attr_accessor api_key(): untyped
-
-    attr_accessor client(): untyped
-
-    def self.new: (?untyped api_key, ?untyped client) -> instance
-                | (?api_key: untyped, ?client: untyped) -> instance
-  end
-
-  class AzureOpenAI < Struct[untyped]
-    attr_accessor api_key(): untyped
-
-    attr_accessor endpoint(): untyped
-
-    attr_accessor client(): untyped
-
-    def self.new: (?untyped api_key, ?untyped endpoint, ?untyped client) -> instance
-                | (?api_key: untyped, ?endpoint: untyped, ?client: untyped) -> instance
-  end
-
-  class Gemini < Struct[untyped]
-    attr_accessor api_key(): untyped
-
-    attr_accessor client(): untyped
-
-    def self.new: (?untyped api_key, ?untyped client) -> instance
-                | (?api_key: untyped, ?client: untyped) -> instance
-  end
-
-  class OpenAI < Struct[untyped]
-    attr_accessor api_key(): untyped
-
-    attr_accessor base_url(): untyped
-
-    attr_accessor client(): untyped
-
-    def self.new: (?untyped api_key, ?untyped base_url, ?untyped client) -> instance
-                | (?api_key: untyped, ?base_url: untyped, ?client: untyped) -> instance
-  end
-
-  class OpenRouter < Struct[untyped]
-    attr_accessor api_key(): untyped
-
-    attr_accessor client(): untyped
-
-    def self.new: (?untyped api_key, ?untyped client) -> instance
-                | (?api_key: untyped, ?client: untyped) -> instance
-  end
-
-  class Evals < Struct[untyped]
-    attr_accessor judge_model(): untyped
-
-    def self.new: (?untyped judge_model) -> instance
-                | (?judge_model: untyped) -> instance
-  end
-
-  class Mcp < Struct[untyped]
-    attr_accessor credentials(): untyped
-
-    attr_accessor discovery_runner(): untyped
-
-    def self.new: (?untyped credentials, ?untyped discovery_runner) -> instance
-                | (?credentials: untyped, ?discovery_runner: untyped) -> instance
-  end
-
-  # Skills-related global configuration.
-  class Skills
-    # The tool class the LLM calls to activate a skill; defaults to
-    # <tt>Riffer::Skills::ActivateTool</tt>.
-    attr_reader default_activate_tool: singleton(Riffer::Tool)
-
-    # Default skills backend for agents that declare a +skills+ block without
-    # one; defaults to +nil+.
-    attr_reader default_backend: (Riffer::Skills::Backend | Proc)?
-
-    # --
-    # : () -> void
-    def initialize: () -> void
-
-    # Sets the default skill activation tool class. Raises Riffer::ArgumentError
-    # on an invalid value.
-    # --
-    # : (singleton(Riffer::Tool)) -> void
-    def default_activate_tool=: (singleton(Riffer::Tool)) -> void
-
-    # Sets the default skills backend. Raises Riffer::ArgumentError on an
-    # invalid value.
-    # --
-    # : ((Riffer::Skills::Backend | Proc)?) -> void
-    def default_backend=: ((Riffer::Skills::Backend | Proc)?) -> void
-  end
-
-  # Tracing-related global configuration.
-  class Tracing
-    # Whether riffer emits OTEL spans; defaults to +true+, a no-op until a
-    # host wires an OTEL SDK.
-    attr_reader enabled: bool
-
-    # Whether LLM-call spans capture full message content
-    # (<tt>gen_ai.input.messages</tt>, <tt>gen_ai.output.messages</tt>,
-    # <tt>gen_ai.system_instructions</tt>); defaults to +false+ — message
-    # content routinely carries sensitive data.
-    attr_reader capture_messages: bool
-
-    # The backend riffer routes spans through; defaults to +nil+, a no-op.
-    # Riffer auto-detects no backend; assigning one is opt-in.
-    attr_reader backend: untyped
-
-    # --
-    # : () -> void
-    def initialize: () -> void
-
-    # Sets the enabled flag, coercing boolean-ish values so an env-var
-    # +"false"+ (truthy in Ruby) doesn't silently keep tracing on. Raises
-    # Riffer::ArgumentError on an unrecognized value.
-    # --
-    # : (untyped) -> void
-    def enabled=: (untyped) -> void
-
-    # Sets the capture_messages flag, coercing boolean-ish values so an
-    # env-var +"false"+ (truthy in Ruby) doesn't silently enable content
-    # capture. Raises Riffer::ArgumentError on an unrecognized value.
-    # --
-    # : (untyped) -> void
-    def capture_messages=: (untyped) -> void
-
-    # Sets the tracing backend riffer routes spans through. Raises
-    # Riffer::ArgumentError unless the value is +nil+ or responds to the full
-    # delegated contract: +in_span+, +current_context+, and +with_context+.
-    # --
-    # : (untyped) -> void
-    def backend=: (untyped) -> void
-  end
-
-  # File-attachment-download policy for +Riffer::Messages::FilePart+ URL sources
-  class Files
-    # Allow file attachments to be downloaded to send to providers.
-    attr_reader allow_downloads: bool
-
-    # Maximum file size to download before failing.
-    attr_reader max_bytes: Integer
-
-    # Maximum amount of time to spend downloading a file before failing.
-    attr_reader timeout: Integer
-
-    # Maximum number of files to include in an individual message.
-    attr_reader max_per_message: Integer?
-
-    # Execution pattern for downloading files.
-    attr_reader runner: Riffer::Runner
-
-    # The object used to fetch a URL source's bytes
-    attr_reader downloader: untyped
-
-    # --
-    # : () -> void
-    def initialize: () -> void
-
-    # Sets the allow_downloads flag, coercing boolean-ish values so an env-var
-    # +"false"+ (truthy in Ruby) doesn't silently enable downloads.  Raises
-    # Riffer::ArgumentError on an unrecognized value.
-    # --
-    # : (untyped) -> void
-    def allow_downloads=: (untyped) -> void
-
-    # Sets max_bytes, provided value is a positive integer.
-    # Raises Riffer::ArgumentError if value is not an Integer or less than or equal to 0.
-    # --
-    # : (untyped) -> void
-    def max_bytes=: (untyped) -> void
-
-    # Sets timeout, provided value is a positive integer.
-    # Raises Riffer::ArgumentError if value is not an Integer or is less than or equal to 0.
-    # --
-    # : (untyped) -> void
-    def timeout=: (untyped) -> void
-
-    # Sets max_per_message, provided value is either nil or a positive integer.
-    # Raises Riffer::ArgumentError if value is not an Integer or nil, or is less than or equal to 0.
-    # --
-    # : (untyped) -> void
-    def max_per_message=: (untyped) -> void
-
-    # Sets the runner used to process file downloads, provided value is a Riffer::Runner.
-    # Raises Riffer::ArgumentError if value is not a Riffer::Runner.
-    # --
-    # : (untyped) -> void
-    def runner=: (untyped) -> void
-
-    # Sets the object used to download bytes from a URL.
-    # Raises Riffer::ArgumentError if value does not respond to +#call+.
-    # --
-    # : (untyped) -> void
-    def downloader=: (untyped) -> void
-  end
-
-  # Consumer-configured token pricing, keyed by +provider/model+ id. Riffer
-  # ships no price table, so an unconfigured model carries no cost.
-  class Pricing
-    @rates: Hash[String, Riffer::Config::Pricing::Rates]
-
-    # Per-million-token rates for one model's four token buckets. +cache_read+
-    # and +cache_write+ fall back to the +input+ rate when unset.
-    class Rates
-      # Input rate per million tokens.
-      attr_reader input: Float
-
-      # Output rate per million tokens.
-      attr_reader output: Float
-
-      # Cache-read rate per million tokens.
-      attr_reader cache_read: Float?
-
-      # Cache-write rate per million tokens.
-      attr_reader cache_write: Float?
-
-      # --
-      # : (input: Float, output: Float, ?cache_read: Float?, ?cache_write: Float?) -> void
-      def initialize: (input: Float, output: Float, ?cache_read: Float?, ?cache_write: Float?) -> void
-
-      # Returns the cost for the given token counts.
-      # --
-      # : (input_tokens: Integer, output_tokens: Integer, ?cache_read_tokens: Integer?, ?cache_write_tokens: Integer?) -> Float
-      def cost_for: (input_tokens: Integer, output_tokens: Integer, ?cache_read_tokens: Integer?, ?cache_write_tokens: Integer?) -> Float
-    end
-
-    # --
-    # : () -> void
-    def initialize: () -> void
-
-    # Registers per-million-token rates for a +provider/model+ id/s. Raises
-    # Riffer::ArgumentError on a malformed id or a negative/non-numeric rate.
-    # --
-    # : ((String | Array[String]), input: Numeric, output: Numeric, ?cache_read: Numeric?, ?cache_write: Numeric?) -> void
-    def set: (String | Array[String], input: Numeric, output: Numeric, ?cache_read: Numeric?, ?cache_write: Numeric?) -> void
-
-    # Returns the rates registered for a +provider/model+ id.
-    # --
-    # : (String) -> Riffer::Config::Pricing::Rates?
-    def rates_for: (String) -> Riffer::Config::Pricing::Rates?
-
-    # Returns true when no rates are registered.
-    # --
-    # : () -> bool
-    def empty?: () -> bool
-
-    private
-
-    # --
-    # : (String) -> void
-    def validate_model!: (String) -> void
-
-    # --
-    # : (untyped, String) -> Float
-    def coerce_rate: (untyped, String) -> Float
-
-    # --
-    # : (untyped, String) -> Float?
-    def coerce_optional_rate: (untyped, String) -> Float?
-  end
-
   VALID_MESSAGE_ID_STRATEGIES: untyped
 
-  # Amazon Bedrock configuration.
   attr_reader amazon_bedrock: Riffer::Config::AmazonBedrock
 
-  # Anthropic configuration.
   attr_reader anthropic: Riffer::Config::Anthropic
 
-  # Azure OpenAI configuration.
   attr_reader azure_openai: Riffer::Config::AzureOpenAI
 
-  # Google Gemini configuration.
   attr_reader gemini: Riffer::Config::Gemini
 
-  # OpenAI configuration.
   attr_reader openai: Riffer::Config::OpenAI
 
-  # OpenRouter configuration.
   attr_reader openrouter: Riffer::Config::OpenRouter
 
-  # Evals configuration.
   attr_reader evals: Riffer::Config::Evals
 
-  # MCP configuration. +credentials+ is an optional Proc returning per-run
-  # +tools/call+ headers (or +nil+ to deny); +discovery_runner+ runs tool
-  # discovery.
   attr_reader mcp: Riffer::Config::Mcp
 
-  # Global tool runtime configuration (experimental); defaults to
-  # <tt>Riffer::Tools::Runtime::Inline.new</tt>.
   attr_reader tool_runtime: singleton(Riffer::Tools::Runtime) | Riffer::Tools::Runtime | Proc
 
-  # Sets the global tool runtime. Raises Riffer::ArgumentError on an invalid
-  # value.
   # --
   # : ((singleton(Riffer::Tools::Runtime) | Riffer::Tools::Runtime | Proc)) -> void
   def tool_runtime=: (singleton(Riffer::Tools::Runtime) | Riffer::Tools::Runtime | Proc) -> void
 
-  # Skills-related global configuration.
   attr_reader skills: Riffer::Config::Skills
 
-  # Tracing-related global configuration.
   attr_reader tracing: Riffer::Config::Tracing
 
   attr_reader files: Riffer::Config::Files
 
-  # Consumer-configured per-model token pricing.
   attr_reader pricing: Riffer::Config::Pricing
 
-  # Strategy for auto-generating message ids: +:none+ (default), +:uuid+, or
-  # +:uuidv7+. When not +:none+, messages get an +id+ at construction, and
-  # seeded messages passed to +Riffer::Agent#generate+ must carry their own.
+  # When not +:none+, seeded messages passed to +Riffer::Agent#generate+ must
+  # carry their own +id+.
   attr_reader message_id_strategy: Symbol
 
-  # Sets the message id strategy. Raises Riffer::ArgumentError unless the value
-  # is +:none+, +:uuid+, or +:uuidv7+.
   # --
   # : (Symbol) -> void
   def message_id_strategy=: (Symbol) -> void
 
-  # Experimental: when +true+, riffer maintains the +tool_use+ ↔ +tool_result+
-  # invariant itself — stripping orphaned exchanges and filling interrupted
-  # ones. Defaults to +false+; the surface may change without notice.
-  attr_reader experimental_history_healing: bool
-
-  # Sets the +experimental_history_healing+ flag, coercing boolean-ish values so
-  # an env-var +"false"+ (truthy in Ruby) doesn't silently enable healing.
-  # Raises Riffer::ArgumentError on an unrecognized value.
-  # --
-  # : (untyped) -> void
-  def experimental_history_healing=: (untyped) -> void
-
   # --
   # : () -> void
   def initialize: () -> void

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

@@ -1,14 +1,5 @@
 # Generated from lib/riffer/evals/evaluator.rb with RBS::Inline
 
-# Base class for all evaluators. Set +instructions+ and the base class calls
-# the judge automatically; override +#evaluate+ for custom logic. See
-# examples/evaluators/ for reference implementations.
-#
-#   class MyEvaluator < Riffer::Evals::Evaluator
-#     instructions "Assess medical accuracy of the response..."
-#     higher_is_better true
-#     judge_model "anthropic/claude-opus-4-5-20251101"
-#   end
 class Riffer::Evals::Evaluator
   self.@instructions: String?
 
@@ -16,29 +7,32 @@ class Riffer::Evals::Evaluator
 
   self.@judge_model: String?
 
+  self.@identifier: String?
+
   @judge: Riffer::Evals::Judge?
 
-  # Gets or sets the evaluation instructions (criteria and scoring rubric).
-  #
+  DEFAULT_IDENTIFIER: String
+
   # --
   # : (?String?) -> String?
   def self.instructions: (?String?) -> String?
 
-  # Gets or sets whether higher scores are better.
-  #
   # --
   # : (?bool?) -> bool
   def self.higher_is_better: (?bool?) -> bool
 
-  # Gets or sets the judge model for LLM-as-judge evaluations.
-  #
   # --
   # : (?String?) -> String?
   def self.judge_model: (?String?) -> String?
 
-  # Evaluates an input/output pair. The default calls the judge with the
-  # class-level +instructions+; override for custom logic (e.g. rule-based
-  # evaluators).
+  # --
+  # : (?String?) -> String
+  def self.identifier: (?String?) -> String
+
+  # --
+  # : () -> String
+  private def self.derived_identifier: () -> String
+
   # --
   # : (input: String | Array[Hash[Symbol, untyped] | Riffer::Messages::Base], output: String, ?ground_truth: String?, ?messages: Array[Riffer::Messages::Base]) -> Riffer::Evals::Result
   def evaluate: (input: String | Array[Hash[Symbol, untyped] | Riffer::Messages::Base], output: String, ?ground_truth: String?, ?messages: Array[Riffer::Messages::Base]) -> Riffer::Evals::Result
@@ -49,13 +43,10 @@ class Riffer::Evals::Evaluator
   # : (String | Array[Hash[Symbol, untyped] | Riffer::Messages::Base]) -> String
   def format_input: (String | Array[Hash[Symbol, untyped] | Riffer::Messages::Base]) -> String
 
-  # Returns a Judge instance configured for this evaluator.
-  #
   # --
   # : () -> Riffer::Evals::Judge
   def judge: () -> Riffer::Evals::Judge
 
-  # Builds a Result for this evaluator.
   # --
   # : (score: Float, ?reason: String?, ?metadata: Hash[Symbol, untyped], ?token_usage: Riffer::Providers::TokenUsage?) -> Riffer::Evals::Result
   def result: (score: Float, ?reason: String?, ?metadata: Hash[Symbol, untyped], ?token_usage: Riffer::Providers::TokenUsage?) -> Riffer::Evals::Result

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

@@ -1,20 +1,6 @@
 # Generated from lib/riffer/evals/evaluator_runner.rb with RBS::Inline
 
-# Orchestrates running evaluators against an agent across multiple scenarios.
-#
-#   result = Riffer::Evals::EvaluatorRunner.run(
-#     agent: MyAgent,
-#     scenarios: [
-#       { input: "What is Ruby?", ground_truth: "A programming language" },
-#       { input: "What is Python?" }
-#     ],
-#     evaluators: [AnswerRelevancyEvaluator]
-#   )
-#
-#   result.scores   # => { AnswerRelevancyEvaluator => 0.85 }
 module Riffer::Evals::EvaluatorRunner
-  # Runs evaluators against an agent for the given scenarios. Raises
-  # Riffer::ArgumentError on an invalid agent or evaluator.
   # --
   # : (agent: singleton(Riffer::Agent), scenarios: Array[Hash[Symbol, untyped]], evaluators: Array[singleton(Riffer::Evals::Evaluator)], ?context: Hash[Symbol, untyped]?) -> Riffer::Evals::RunResult
   def run: (agent: singleton(Riffer::Agent), scenarios: Array[Hash[Symbol, untyped]], evaluators: Array[singleton(Riffer::Evals::Evaluator)], ?context: Hash[Symbol, untyped]?) -> Riffer::Evals::RunResult

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

@@ -1,7 +1,5 @@
 # Generated from lib/riffer/evals/judge.rb with RBS::Inline
 
-# Executes LLM-as-judge evaluations, using tool calling internally to get
-# structured output from the judge model.
 class Riffer::Evals::Judge
   @provider_instance: Riffer::Providers::Base?
 
@@ -9,22 +7,20 @@ class Riffer::Evals::Judge
 
   @model_name: String?
 
-  # Internal tool for structured evaluation output.
   class EvaluationTool < Riffer::Tool
     # --
     # : (context: Riffer::Agent::Context?, score: Float, reason: String) -> Riffer::Tools::Response
     def call: (context: Riffer::Agent::Context?, score: Float, reason: String) -> Riffer::Tools::Response
   end
 
-  # The model string (provider/model format).
   attr_reader model: String
 
-  # Raises Riffer::ArgumentError unless +model+ is "provider/model" format.
+  attr_reader tags: Hash[String, String]
+
   # --
-  # : (model: String) -> void
-  def initialize: (model: String) -> void
+  # : (model: String, ?tags: Hash[String, String]) -> void
+  def initialize: (model: String, ?tags: Hash[String, String]) -> void
 
-  # Evaluates an input/output pair using the configured LLM.
   # --
   # : (instructions: String, input: String, output: String, ?ground_truth: String?) -> Hash[Symbol, untyped]
   def evaluate: (instructions: String, input: String, output: String, ?ground_truth: String?) -> Hash[Symbol, untyped]

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

@@ -1,33 +1,23 @@
 # Generated from lib/riffer/evals/result.rb with RBS::Inline
 
-# Represents the result of a single evaluation.
 class Riffer::Evals::Result
-  # The evaluator class that produced this result.
   attr_reader evaluator: singleton(Riffer::Evals::Evaluator)
 
-  # The evaluation score (0.0 to 1.0).
   attr_reader score: Float
 
-  # Human-readable explanation of the score.
   attr_reader reason: String?
 
-  # Additional metadata from the evaluation.
   attr_reader metadata: Hash[Symbol, untyped]
 
-  # Whether higher scores are better for this evaluator.
   attr_reader higher_is_better: bool
 
-  # Token usage for the judge call that produced this result, when the
-  # evaluator used an LLM. Nil for rule-based evaluators.
+  # Nil for rule-based evaluators.
   attr_reader token_usage: Riffer::Providers::TokenUsage?
 
-  # Raises Riffer::ArgumentError if +score+ is not between 0.0 and 1.0.
   # --
   # : (evaluator: singleton(Riffer::Evals::Evaluator), score: Float, ?reason: String?, ?metadata: Hash[Symbol, untyped], ?higher_is_better: bool, ?token_usage: Riffer::Providers::TokenUsage?) -> void
   def initialize: (evaluator: singleton(Riffer::Evals::Evaluator), score: Float, ?reason: String?, ?metadata: Hash[Symbol, untyped], ?higher_is_better: bool, ?token_usage: Riffer::Providers::TokenUsage?) -> void
 
-  # Returns a hash representation of the result.
-  #
   # --
   # : () -> Hash[Symbol, untyped]
   def to_h: () -> Hash[Symbol, untyped]

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

@@ -1,36 +1,24 @@
 # Generated from lib/riffer/evals/run_result.rb with RBS::Inline
 
-# Represents the complete result of an evaluation run across multiple scenarios.
 class Riffer::Evals::RunResult
-  # Per-scenario evaluation results.
   attr_reader scenario_results: Array[Riffer::Evals::ScenarioResult]
 
   # --
   # : (scenario_results: Array[Riffer::Evals::ScenarioResult]) -> void
   def initialize: (scenario_results: Array[Riffer::Evals::ScenarioResult]) -> void
 
-  # Returns average scores keyed by evaluator class across all scenarios.
-  #
   # --
   # : () -> Hash[singleton(Riffer::Evals::Evaluator), Float]
   def scores: () -> Hash[singleton(Riffer::Evals::Evaluator), Float]
 
-  # Returns the summed token usage the agents under test spent across every
-  # scenario, or nil when none reported usage.
-  #
   # --
   # : () -> Riffer::Providers::TokenUsage?
   def token_usage: () -> Riffer::Providers::TokenUsage?
 
-  # Returns the summed token usage across every scenario's LLM-as-judge
-  # evaluators, or nil when none reported usage.
-  #
   # --
   # : () -> Riffer::Providers::TokenUsage?
   def evaluator_token_usage: () -> Riffer::Providers::TokenUsage?
 
-  # Returns a hash representation of the run result.
-  #
   # --
   # : () -> Hash[Symbol, untyped]
   def to_h: () -> Hash[Symbol, untyped]

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

@@ -1,44 +1,30 @@
 # Generated from lib/riffer/evals/scenario_result.rb with RBS::Inline
 
-# Represents the result of evaluating a single scenario.
 class Riffer::Evals::ScenarioResult
-  # The input that was evaluated.
   attr_reader input: String
 
-  # The agent output for this scenario.
   attr_reader output: String
 
-  # The ground truth used during evaluation.
   attr_reader ground_truth: String?
 
-  # Individual evaluation results.
   attr_reader results: Array[Riffer::Evals::Result]
 
-  # The full message history from the agent conversation.
   attr_reader messages: Array[Riffer::Messages::Base]
 
-  # Token usage the agent under test spent generating this scenario's output.
   attr_reader token_usage: Riffer::Providers::TokenUsage?
 
   # --
   # : (input: String, output: String, ground_truth: String?, results: Array[Riffer::Evals::Result], ?messages: Array[Riffer::Messages::Base], ?token_usage: Riffer::Providers::TokenUsage?) -> void
   def initialize: (input: String, output: String, ground_truth: String?, results: Array[Riffer::Evals::Result], ?messages: Array[Riffer::Messages::Base], ?token_usage: Riffer::Providers::TokenUsage?) -> void
 
-  # Returns scores keyed by evaluator class.
-  #
   # --
   # : () -> Hash[singleton(Riffer::Evals::Evaluator), Float]
   def scores: () -> Hash[singleton(Riffer::Evals::Evaluator), Float]
 
-  # Returns the summed token usage across this scenario's LLM-as-judge
-  # evaluators, or nil when none reported usage.
-  #
   # --
   # : () -> Riffer::Providers::TokenUsage?
   def evaluator_token_usage: () -> Riffer::Providers::TokenUsage?
 
-  # Returns a hash representation of the scenario result.
-  #
   # --
   # : () -> Hash[Symbol, untyped]
   def to_h: () -> Hash[Symbol, untyped]

data/sig/generated/riffer/files/resolver.rbs

@@ -8,10 +8,6 @@ class Riffer::Files::Resolver
   # : (provider: Riffer::Providers::Base) -> void
   def initialize: (provider: Riffer::Providers::Base) -> void
 
-  # Resolves every file in every User message in place - downloading,
-  # verifying, and caching as the provider's capability and each file's
-  # sha256 require.  Raises Riffer::FileError on any file that can't be
-  # resolved
   # : (Array[Riffer::Messages::Base]) -> void
   def resolve!: (Array[Riffer::Messages::Base]) -> void
 
@@ -20,17 +16,14 @@ class Riffer::Files::Resolver
   # : (Riffer::Messages::User) -> void
   def check_file_count!: (Riffer::Messages::User) -> void
 
-  # : (Riffer::Messages::FilePart) -> void
-  def resolve_file!: (Riffer::Messages::FilePart) -> void
+  # : (Riffer::Messages::User::FilePart) -> void
+  def resolve_file!: (Riffer::Messages::User::FilePart) -> void
 
-  # : (Riffer::Messages::FilePart) -> void
-  def verify_inline!: (Riffer::Messages::FilePart) -> void
+  # : (Riffer::Messages::User::FilePart) -> void
+  def verify_inline!: (Riffer::Messages::User::FilePart) -> void
 
-  # +cache:+ is false for a :url-delivery provider verifying a sha256 — the
-  # request still sends the URL, never the downloaded bytes, so caching them
-  # would hold memory nothing reads and let later turns skip re-verifying.
-  # : (Riffer::Messages::FilePart, cache: (false | Symbol)) -> void
-  def download!: (Riffer::Messages::FilePart, cache: false | Symbol) -> void
+  # : (Riffer::Messages::User::FilePart, cache: (false | Symbol)) -> void
+  def download!: (Riffer::Messages::User::FilePart, cache: false | Symbol) -> void
 
   def verify_bytes!: (untyped bytes, untyped sha256) -> untyped
 end

data/sig/generated/riffer/guardrail.rbs

@@ -1,48 +1,28 @@
 # Generated from lib/riffer/guardrail.rb with RBS::Inline
 
-# Base class for guardrails that process input and output in the agent pipeline.
-#
-#   class MyGuardrail < Riffer::Guardrail
-#     def process_input(messages, context:)
-#       # Return pass(messages), transform(modified_messages), or block(reason)
-#       pass(messages)
-#     end
-#
-#     def process_output(response, messages:, context:)
-#       # Return pass(response), transform(modified_response), or block(reason)
-#       pass(response)
-#     end
-#   end
 class Riffer::Guardrail
-  # Processes input messages before they're sent to the LLM; override in
-  # subclasses.
   # --
   # : (Array[Riffer::Messages::Base], context: untyped) -> Riffer::Guardrails::Result
   def process_input: (Array[Riffer::Messages::Base], context: untyped) -> Riffer::Guardrails::Result
 
-  # Processes the output response after it's received from the LLM; override in
-  # subclasses.
   # --
   # : (Riffer::Messages::Assistant, messages: Array[Riffer::Messages::Base], context: untyped) -> Riffer::Guardrails::Result
   def process_output: (Riffer::Messages::Assistant, messages: Array[Riffer::Messages::Base], context: untyped) -> Riffer::Guardrails::Result
 
-  # Returns the guardrail's identifier, used as the tracing span suffix and the
-  # <tt>riffer.guardrail.name</tt> attribute; override to label the span.
+  # Used as the tracing span suffix and the <tt>riffer.guardrail.name</tt>
+  # attribute.
   # --
   # : () -> String
   def name: () -> String
 
-  # Creates a pass result that continues with unchanged data.
   # --
   # : (untyped) -> Riffer::Guardrails::Result
   def pass: (untyped) -> Riffer::Guardrails::Result
 
-  # Creates a transform result that continues with transformed data.
   # --
   # : (untyped) -> Riffer::Guardrails::Result
   def transform: (untyped) -> Riffer::Guardrails::Result
 
-  # Creates a block result that halts execution.
   # --
   # : (String, ?metadata: Hash[Symbol, untyped]?) -> Riffer::Guardrails::Result
   def block: (String, ?metadata: Hash[Symbol, untyped]?) -> Riffer::Guardrails::Result