riffer 0.43.0 → 0.44.0

data/sig/generated/riffer/testing.rbs

@@ -0,0 +1,75 @@
+# Generated from lib/riffer/testing.rb with RBS::Inline
+
+# Builds throwaway agents and tools a test suite can resolve by identifier or
+# constant name, and removes them again. Require <tt>riffer/testing/rspec</tt>
+# or <tt>riffer/testing/minitest</tt> to get +stub_agent+/+stub_tool+ in every
+# example plus per-test cleanup; otherwise include this module and call +reset!+
+# from your own teardown, or call the methods on the module directly.
+#
+# Tracking is not synchronized — stub from a single-threaded test, before
+# concurrent lookups begin.
+module Riffer::Testing
+  self.@registrations: Array[[ Class, String? ]]?
+
+  CONST_NAME_PATTERN: Regexp
+
+  # Builds an agent class, evaluates the optional body in it, and makes it
+  # resolvable until the next +reset!+. A +name+ assigns a top-level constant
+  # and derives the identifier; the body may set +identifier+ like any other
+  # agent config.
+  #
+  #   agent = stub_agent("SupportAgent") { model "mock/gpt-5-mini" }
+  #
+  # Raises Riffer::ArgumentError when the constant is already defined or the
+  # stub ends up with no identifier, and Riffer::DuplicateIdentifierError when
+  # another agent already holds the identifier.
+  #
+  # --
+  # : (?(String | Symbol)?, ?base: singleton(Riffer::Agent)) ?{ () [self: singleton(Riffer::Agent)] -> void } -> singleton(Riffer::Agent)
+  def stub_agent: (?(String | Symbol)?, ?base: singleton(Riffer::Agent)) ?{ () [self: singleton(Riffer::Agent)] -> void } -> singleton(Riffer::Agent)
+
+  # Builds a tool class, evaluates the optional body in it, and makes it
+  # resolvable until the next +reset!+. A +name+ assigns a top-level constant
+  # and derives the identifier; the body may set +identifier+ like any other
+  # tool config.
+  #
+  #   tool = stub_tool("KbSearch") { def call(context:, **) = text("stubbed") }
+  #
+  # Raises Riffer::ArgumentError when the constant is already defined or the
+  # stub ends up with no identifier, and Riffer::DuplicateIdentifierError when
+  # another tool already holds the identifier.
+  #
+  # --
+  # : (?(String | Symbol)?, ?base: singleton(Riffer::Tool)) ?{ () [self: singleton(Riffer::Tool)] -> void } -> singleton(Riffer::Tool)
+  def stub_tool: (?(String | Symbol)?, ?base: singleton(Riffer::Tool)) ?{ () [self: singleton(Riffer::Tool)] -> void } -> singleton(Riffer::Tool)
+
+  # Removes every stub built since the last reset — its registration and any
+  # constant it created — newest first, and forgets them. A no-op when nothing
+  # has been stubbed.
+  # --
+  # : () -> void
+  def reset!: () -> void
+
+  # The stub classes awaiting cleanup. Lives on the module rather than the
+  # caller so an including test case and a direct
+  # <tt>Riffer::Testing.stub_*</tt> call share one list.
+  # --
+  # : () -> Array[[Class, String?]]
+  def self.registrations: () -> Array[[ Class, String? ]]
+
+  private
+
+  # --
+  # : ((String | Symbol)?, base: Class) ?{ () [self: untyped] -> void } -> Class
+  def build_stub: ((String | Symbol)?, base: Class) ?{ () [self: untyped] -> void } -> Class
+
+  # --
+  # : ((String | Symbol)?) -> String?
+  def validate_const_name: ((String | Symbol)?) -> String?
+
+  # A test may have removed or replaced the constant itself, so never clobber
+  # one that no longer points at the stub.
+  # --
+  # : (String, Class) -> void
+  def remove_stub_const: (String, Class) -> void
+end

data/sig/generated/riffer.rbs

@@ -25,6 +25,38 @@ module Riffer
   class ToolExecutionError < 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

data/sig/manifest.yaml

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

data/sig/manual/riffer/testing.rbs

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: riffer
 version: !ruby/object:Gem::Version
-  version: 0.43.0
+  version: 0.44.0
 platform: ruby
 authors:
 - Jake Bottrall
@@ -29,6 +29,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 2.6.0
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Riffer is a comprehensive Ruby framework designed to simplify the development
   of AI-powered applications and agents. It provides a complete toolkit for integrating
   artificial intelligence capabilities into your Ruby projects.
@@ -79,6 +93,7 @@ files:
 - docs/SERIALIZATION.md
 - docs/SKILLS.md
 - docs/STREAM_EVENTS.md
+- docs/TESTING.md
 - docs/TOOLS.md
 - docs/TOOL_ADVANCED.md
 - docs/TRACING.md
@@ -110,6 +125,9 @@ files:
 - lib/riffer/evals/result.rb
 - lib/riffer/evals/run_result.rb
 - lib/riffer/evals/scenario_result.rb
+- lib/riffer/files.rb
+- lib/riffer/files/downloader.rb
+- lib/riffer/files/resolver.rb
 - lib/riffer/guardrail.rb
 - lib/riffer/guardrails.rb
 - lib/riffer/guardrails/modification.rb
@@ -184,6 +202,9 @@ files:
 - lib/riffer/stream_events/tool_call_done.rb
 - lib/riffer/stream_events/web_search_done.rb
 - lib/riffer/stream_events/web_search_status.rb
+- lib/riffer/testing.rb
+- lib/riffer/testing/minitest.rb
+- lib/riffer/testing/rspec.rb
 - lib/riffer/tool.rb
 - lib/riffer/tools.rb
 - lib/riffer/tools/response.rb
@@ -203,6 +224,7 @@ files:
 - 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
@@ -210,6 +232,8 @@ files:
 - sig/_private/riffer/providers/gemini.rbs
 - sig/_private/riffer/providers/open_ai.rbs
 - sig/_private/riffer/providers/open_router.rbs
+- sig/_private/riffer/testing/minitest.rbs
+- sig/_private/rspec.rbs
 - sig/_private/zeitwerk.rbs
 - sig/generated/riffer.rbs
 - sig/generated/riffer/agent.rbs
@@ -230,6 +254,9 @@ files:
 - sig/generated/riffer/evals/result.rbs
 - sig/generated/riffer/evals/run_result.rbs
 - sig/generated/riffer/evals/scenario_result.rbs
+- sig/generated/riffer/files.rbs
+- sig/generated/riffer/files/downloader.rbs
+- sig/generated/riffer/files/resolver.rbs
 - sig/generated/riffer/guardrail.rbs
 - sig/generated/riffer/guardrails.rbs
 - sig/generated/riffer/guardrails/modification.rbs
@@ -304,6 +331,8 @@ files:
 - sig/generated/riffer/stream_events/tool_call_done.rbs
 - sig/generated/riffer/stream_events/web_search_done.rbs
 - sig/generated/riffer/stream_events/web_search_status.rbs
+- sig/generated/riffer/testing.rbs
+- sig/generated/riffer/testing/rspec.rbs
 - sig/generated/riffer/tool.rbs
 - sig/generated/riffer/tools.rbs
 - sig/generated/riffer/tools/response.rbs
@@ -335,6 +364,7 @@ files:
 - sig/manual/riffer/mcp/tool_factory.rbs
 - sig/manual/riffer/providers.rbs
 - sig/manual/riffer/providers/repository.rbs
+- sig/manual/riffer/testing.rbs
 - sig/manual/riffer/tool.rbs
 - sig/manual/riffer/tracing.rbs
 - sig/manual/riffer/tracing/capture.rbs