riffer 0.30.0 → 0.32.0

data/sig/manual/riffer.rbs

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: riffer
 version: !ruby/object:Gem::Version
-  version: 0.30.0
+  version: 0.32.0
 platform: ruby
 authors:
 - Jake Bottrall
@@ -35,14 +35,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.43.0
+        version: 1.46.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.43.0
+        version: 1.46.0
 - !ruby/object:Gem::Dependency
   name: aws-sdk-bedrockruntime
   requirement: !ruby/object:Gem::Requirement
@@ -91,14 +91,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.64.0
+        version: 0.66.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.64.0
+        version: 0.66.1
 - !ruby/object:Gem::Dependency
   name: async
   requirement: !ruby/object:Gem::Requirement
@@ -247,7 +247,6 @@ files:
 - ".agents/code-style.md"
 - ".agents/providers.md"
 - ".agents/rbs-inline.md"
-- ".agents/rdoc.md"
 - ".agents/testing.md"
 - ".bundle/config"
 - ".release-please-config.json"
@@ -322,11 +321,11 @@ files:
 - lib/riffer/mcp/manifest.rb
 - lib/riffer/mcp/registration.rb
 - lib/riffer/mcp/registry.rb
+- lib/riffer/mcp/search_tool.rb
 - lib/riffer/mcp/tool_factory.rb
 - lib/riffer/messages.rb
 - lib/riffer/messages/assistant.rb
 - lib/riffer/messages/base.rb
-- lib/riffer/messages/converter.rb
 - lib/riffer/messages/file_part.rb
 - lib/riffer/messages/system.rb
 - lib/riffer/messages/tool.rb
@@ -429,11 +428,11 @@ files:
 - sig/generated/riffer/mcp/manifest.rbs
 - sig/generated/riffer/mcp/registration.rbs
 - sig/generated/riffer/mcp/registry.rbs
+- sig/generated/riffer/mcp/search_tool.rbs
 - sig/generated/riffer/mcp/tool_factory.rbs
 - sig/generated/riffer/messages.rbs
 - sig/generated/riffer/messages/assistant.rbs
 - sig/generated/riffer/messages/base.rbs
-- sig/generated/riffer/messages/converter.rbs
 - sig/generated/riffer/messages/file_part.rbs
 - sig/generated/riffer/messages/system.rbs
 - sig/generated/riffer/messages/tool.rbs
@@ -491,10 +490,19 @@ files:
 - sig/generated/riffer/tools/toolable.rbs
 - sig/generated/riffer/version.rbs
 - sig/manifest.yaml
+- sig/manual/riffer.rbs
 - sig/manual/riffer/agent/run.rbs
 - sig/manual/riffer/agent/serializer.rbs
+- sig/manual/riffer/agent/session/repair.rbs
+- sig/manual/riffer/evals/evaluator_runner.rbs
 - sig/manual/riffer/helpers/call_or_value.rbs
-- sig/manual/riffer/tools/toolable.rbs
+- sig/manual/riffer/helpers/class_name_converter.rbs
+- sig/manual/riffer/helpers/dependencies.rbs
+- sig/manual/riffer/mcp.rbs
+- sig/manual/riffer/mcp/authenticated_tool.rbs
+- sig/manual/riffer/mcp/registry.rbs
+- sig/manual/riffer/mcp/tool_factory.rbs
+- sig/manual/riffer/providers/repository.rbs
 homepage: https://riffer.ai
 licenses:
 - MIT

data/.agents/rdoc.md

@@ -1,69 +0,0 @@
-# RDoc Documentation
-
-Use RDoc prose comments for public API descriptions and RBS inline annotations for types.
-
-## Parameters and Return Types
-
-Describe parameters using RDoc labeled list syntax. Use a single `#:` line for the RBS method signature (see [rbs-inline.md](rbs-inline.md) for the full type annotation syntax):
-
-```ruby
-# Creates a new agent.
-#
-# [name] the agent name.
-# [options] optional configuration.
-#
-#--
-#: (String, ?options: Hash[Symbol, untyped]) -> void
-def initialize(name, options: {})
-```
-
-Always add `#--` (RDoc stop directive) on the line before a standalone `#:` type annotation. Without it, RDoc treats `#:` as a label-list marker and corrupts the preceding comment into a `<pre>` block. Inline `#:` on the same line as code (e.g., `attr_reader :name #: String`) does not need this.
-
-## Inline Code
-
-Use `+word+` for single-word inline code. For multi-word expressions (containing spaces, colons, or brackets), use `<tt>multi word expression</tt>`:
-
-```ruby
-# Returns +nil+ when no instructions are configured.
-# Equivalent to <tt>throw :riffer_interrupt, reason</tt>.
-```
-
-## Attributes and Constants
-
-Use `#:` inline syntax (on the same line) for attribute and constant types:
-
-```ruby
-# The agent name.
-attr_reader :name #: String
-
-DEFAULT_TIMEOUT = 10 #: Integer
-```
-
-## Exceptions
-
-Document with prose:
-
-```ruby
-# Raises Riffer::ArgumentError if the name is invalid.
-```
-
-## Examples
-
-Include usage examples as indented code blocks (2 extra spaces of indent):
-
-```ruby
-# Creates a new agent.
-#
-#   agent = MyAgent.new
-#   agent.generate('Hello')
-#
-```
-
-## Internal APIs
-
-Mark internal APIs with `:nodoc:` to exclude from documentation:
-
-```ruby
-def internal_method # :nodoc:
-end
-```

data/lib/riffer/messages/converter.rb

@@ -1,90 +0,0 @@
-# frozen_string_literal: true
-# rbs_inline: enabled
-
-# Module for converting hashes to message objects.
-#
-# Included in Agent and Provider classes to handle message normalization.
-module Riffer::Messages::Converter
-  # Converts a hash or message object to a Riffer::Messages::Base subclass.
-  #
-  # Raises Riffer::ArgumentError if the message format is invalid.
-  #
-  #--
-  #: ((Hash[Symbol, untyped] | Riffer::Messages::Base)) -> Riffer::Messages::Base
-  def convert_to_message_object(msg)
-    return msg if msg.is_a?(Riffer::Messages::Base)
-
-    unless msg.is_a?(Hash)
-      raise Riffer::ArgumentError, "Message must be a Hash or Message object, got #{msg.class}"
-    end
-
-    convert_hash_to_message(msg)
-  end
-
-  # Converts a hash or FilePart object to a Riffer::Messages::FilePart.
-  #
-  # Accepts:
-  # - +Riffer::Messages::FilePart+ objects (passed through)
-  # - <tt>{url: "https://...", media_type: "..."}</tt> (URL source)
-  # - <tt>{data: "...", media_type: "..."}</tt> (raw base64)
-  #
-  # Raises Riffer::ArgumentError if the hash format is invalid.
-  #
-  #--
-  #: ((Hash[Symbol, untyped] | Riffer::Messages::FilePart)) -> Riffer::Messages::FilePart
-  def convert_to_file_part(file)
-    return file if file.is_a?(Riffer::Messages::FilePart)
-
-    unless file.is_a?(Hash)
-      raise Riffer::ArgumentError, "File must be a Hash or FilePart object, got #{file.class}"
-    end
-
-    url = file[:url]
-    data = file[:data]
-    media_type = file[:media_type]
-    filename = file[:filename]
-
-    if url
-      Riffer::Messages::FilePart.from_url(url, media_type: media_type)
-    elsif data && media_type
-      Riffer::Messages::FilePart.new(data: data, media_type: media_type, filename: filename)
-    else
-      raise Riffer::ArgumentError, "File hash must include :url or :data with :media_type"
-    end
-  end
-
-  private
-
-  #--
-  #: (Hash[Symbol, untyped]) -> Riffer::Messages::Base
-  def convert_hash_to_message(hash)
-    role = hash[:role]
-    content = hash[:content]
-
-    if role.nil? || role.empty?
-      raise Riffer::ArgumentError, "Message hash must include a 'role' key"
-    end
-
-    id = hash[:id]
-
-    case role.to_sym
-    when :user
-      files = (hash[:files] || []).map { |f| convert_to_file_part(f) }
-      Riffer::Messages::User.new(content, id: id, files: files)
-    when :assistant
-      tool_calls = (hash[:tool_calls] || []).map { |tc|
-        tc.is_a?(Riffer::Messages::Assistant::ToolCall) ? tc : Riffer::Messages::Assistant::ToolCall.new(**tc)
-      }
-      structured_output = hash[:structured_output]
-      Riffer::Messages::Assistant.new(content, id: id, tool_calls: tool_calls, structured_output: structured_output)
-    when :system
-      Riffer::Messages::System.new(content, id: id)
-    when :tool
-      tool_call_id = hash[:tool_call_id]
-      name = hash[:name]
-      Riffer::Messages::Tool.new(content, id: id, tool_call_id: tool_call_id, name: name)
-    else
-      raise Riffer::ArgumentError, "Unknown message role: #{role}"
-    end
-  end
-end

data/sig/generated/riffer/messages/converter.rbs

@@ -1,33 +0,0 @@
-# Generated from lib/riffer/messages/converter.rb with RBS::Inline
-
-# Module for converting hashes to message objects.
-#
-# Included in Agent and Provider classes to handle message normalization.
-module Riffer::Messages::Converter
-  # Converts a hash or message object to a Riffer::Messages::Base subclass.
-  #
-  # Raises Riffer::ArgumentError if the message format is invalid.
-  #
-  # --
-  # : ((Hash[Symbol, untyped] | Riffer::Messages::Base)) -> Riffer::Messages::Base
-  def convert_to_message_object: (Hash[Symbol, untyped] | Riffer::Messages::Base) -> Riffer::Messages::Base
-
-  # Converts a hash or FilePart object to a Riffer::Messages::FilePart.
-  #
-  # Accepts:
-  # - +Riffer::Messages::FilePart+ objects (passed through)
-  # - <tt>{url: "https://...", media_type: "..."}</tt> (URL source)
-  # - <tt>{data: "...", media_type: "..."}</tt> (raw base64)
-  #
-  # Raises Riffer::ArgumentError if the hash format is invalid.
-  #
-  # --
-  # : ((Hash[Symbol, untyped] | Riffer::Messages::FilePart)) -> Riffer::Messages::FilePart
-  def convert_to_file_part: (Hash[Symbol, untyped] | Riffer::Messages::FilePart) -> Riffer::Messages::FilePart
-
-  private
-
-  # --
-  # : (Hash[Symbol, untyped]) -> Riffer::Messages::Base
-  def convert_hash_to_message: (Hash[Symbol, untyped]) -> Riffer::Messages::Base
-end

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

@@ -1,6 +0,0 @@
-# Toolable is extended onto tool classes; its instance methods run as class
-# methods on the extender, which is also extended with ClassNameConverter
-# (see Toolable.extended). The include models that method availability for Steep.
-module Riffer::Tools::Toolable
-  include Riffer::Helpers::ClassNameConverter
-end