riffer 0.48.0 → 0.49.0

data/sig/generated/riffer/skills/context.rbs

@@ -1,8 +1,5 @@
 # Generated from lib/riffer/skills/context.rb with RBS::Inline
 
-# Skills context for an agent generation cycle — coordinates discovery,
-# activation, and prompt rendering, caching skill bodies to avoid redundant
-# backend reads. Exposed to tools via <tt>context.skills</tt>.
 class Riffer::Skills::Context
   @preactivated: Array[String]
 
@@ -12,79 +9,53 @@ class Riffer::Skills::Context
 
   @backend: Riffer::Skills::Backend
 
-  # Skill catalog indexed by name.
   attr_reader skills: Hash[String, Riffer::Skills::Frontmatter]
 
-  # The skill adapter used for this context.
   attr_reader adapter: Riffer::Skills::Adapter
 
-  # Optional callback invoked when a skill is first activated.
   attr_accessor on_activate: (^(String) -> void)?
 
   # --
   # : (backend: Riffer::Skills::Backend, skills: Hash[String, Riffer::Skills::Frontmatter], adapter: Riffer::Skills::Adapter) -> void
   def initialize: (backend: Riffer::Skills::Backend, skills: Hash[String, Riffer::Skills::Frontmatter], adapter: Riffer::Skills::Adapter) -> void
 
-  # Returns a skill's body without recording an activation.
-  #
   # Raises Riffer::ArgumentError if the skill is not in the catalog.
-  #
   # --
   # : (String) -> String
   def read: (String) -> String
 
-  # Activates a skill by name. Returns the cached body on re-activation.
-  #
   # Raises Riffer::ArgumentError if the skill is not in the catalog.
-  #
   # --
   # : (String) -> String
   def activate: (String) -> String
 
-  # Activates a skill and returns its body wrapped for injection as a user
-  # message.
-  #
   # Raises Riffer::ArgumentError if the skill is not in the catalog.
-  #
   # --
   # : (String) -> String
   def activation_prompt: (String) -> String
 
-  # Activates a skill whose body renders in the system prompt rather than the
-  # conversation.
-  #
   # Raises Riffer::ArgumentError if the skill is not in the catalog.
-  #
   # --
   # : (String) -> void
   def preactivate: (String) -> void
 
-  # Clears a skill's activation so the next activation is treated as the first.
-  #
   # Raises Riffer::ArgumentError if the skill is not in the catalog.
-  #
   # --
   # : (String) -> void
   def deactivate: (String) -> void
 
-  # Returns whether a skill has been activated.
-  #
   # --
   # : (String) -> bool
   def activated?: (String) -> bool
 
-  # Returns whether a skill exists and may be activated by the model.
   # --
   # : (String) -> bool
   def model_invocable?: (String) -> bool
 
-  # Returns whether any skill is available for the model to activate.
   # --
   # : () -> bool
   def activatable?: () -> bool
 
-  # Returns the complete skills section for the system prompt — the catalog plus
-  # any pre-activated skill bodies.
   # --
   # : () -> String
   def system_prompt: () -> String

data/sig/generated/riffer/skills/filesystem_backend.rbs

@@ -1,8 +1,5 @@
 # Generated from lib/riffer/skills/filesystem_backend.rb with RBS::Inline
 
-# Built-in backend that reads skills from the filesystem. Scans configured
-# directories for immediate child directories containing +SKILL.md+; directory
-# names must match the skill +name+.
 class Riffer::Skills::FilesystemBackend < Riffer::Skills::Backend
   @paths: Array[String]
 
@@ -12,14 +9,10 @@ class Riffer::Skills::FilesystemBackend < Riffer::Skills::Backend
   # : (*String) -> void
   def initialize: (*String) -> void
 
-  # Returns frontmatter for all discovered skills; on a name collision across
-  # paths, first-path-wins.
   # --
   # : () -> Array[Riffer::Skills::Frontmatter]
   def list_skills: () -> Array[Riffer::Skills::Frontmatter]
 
-  # Returns the full SKILL.md body (without frontmatter) for a skill. Raises
-  # Riffer::ArgumentError if the skill is not found.
   # --
   # : (String) -> String
   def read_skill: (String) -> String

data/sig/generated/riffer/skills/frontmatter.rbs

@@ -1,9 +1,5 @@
 # Generated from lib/riffer/skills/frontmatter.rb with RBS::Inline
 
-# Immutable value object holding parsed SKILL.md YAML frontmatter. Required
-# fields: +name+ and +description+; the optional +disable-model-invocation+
-# flag is recognized, and any other unrecognized top-level keys are merged into
-# +metadata+.
 class Riffer::Skills::Frontmatter
   NAME_PATTERN: Regexp
 
@@ -11,29 +7,20 @@ class Riffer::Skills::Frontmatter
 
   MAX_DESCRIPTION_LENGTH: Integer
 
-  # The skill name (1-64 chars, lowercase alphanumeric and hyphens).
   attr_reader name: String
 
-  # The skill description (1-1024 chars).
   attr_reader description: String
 
-  # Whether the skill opts out of model-driven activation. Hidden from the
-  # catalog and rejected at model activation; still reachable via programmatic
-  # activation.
   attr_reader disable_model_invocation: bool
 
-  # Metadata from the spec's +metadata+ field plus any unrecognized top-level
-  # keys.
   attr_reader metadata: Hash[Symbol, untyped]
 
-  # Parses a raw SKILL.md string into a +[Frontmatter, body]+ pair — public so
-  # custom backends needn't reimplement parsing. Raises Riffer::ArgumentError
-  # if the frontmatter is invalid.
+  # Public so custom backends needn't reimplement parsing. Raises
+  # Riffer::ArgumentError if the frontmatter is invalid.
   # --
   # : (String) -> [Riffer::Skills::Frontmatter, String]
   def self.parse: (String) -> [ Riffer::Skills::Frontmatter, String ]
 
-  # Parses only the frontmatter from a raw SKILL.md string, ignoring the body.
   # Raises Riffer::ArgumentError if the frontmatter is invalid.
   # --
   # : (String) -> Riffer::Skills::Frontmatter
@@ -44,7 +31,6 @@ class Riffer::Skills::Frontmatter
   def self.split_frontmatter: (String) -> [ Hash[Symbol, untyped], String ]
 
   # Raises Riffer::ArgumentError if +name+ or +description+ is invalid.
-  # +disable_model_invocation+ is treated as set only when literally +true+.
   # --
   # : (name: String, description: String, ?disable_model_invocation: bool, ?metadata: Hash[Symbol, untyped]) -> void
   def initialize: (name: String, description: String, ?disable_model_invocation: bool, ?metadata: Hash[Symbol, untyped]) -> void

data/sig/generated/riffer/skills/markdown_adapter.rbs

@@ -1,18 +1,12 @@
 # Generated from lib/riffer/skills/markdown_adapter.rb with RBS::Inline
 
-# Default skill adapter — renders a skill catalog as Markdown for the system
-# prompt.
 class Riffer::Skills::MarkdownAdapter < Riffer::Skills::Adapter
-  # Renders a skill catalog as Markdown.
   # --
   # : (Array[Riffer::Skills::Frontmatter]) -> String
   def render_catalog: (Array[Riffer::Skills::Frontmatter]) -> String
 
   private
 
-  # Collapses whitespace so a multi-line (block scalar) description stays within
-  # its `-` list item instead of breaking out to column 0, where continuation
-  # lines would read as top-level prompt text or fabricated catalog entries.
   # --
   # : (String) -> String
   def single_line: (String) -> String

data/sig/generated/riffer/skills/xml_adapter.rbs

@@ -1,9 +1,6 @@
 # Generated from lib/riffer/skills/xml_adapter.rb with RBS::Inline
 
-# Renders a skill catalog as XML for the system prompt, optimized for
-# Anthropic/Claude.
 class Riffer::Skills::XmlAdapter < Riffer::Skills::Adapter
-  # Renders a skill catalog as XML.
   # --
   # : (Array[Riffer::Skills::Frontmatter]) -> String
   def render_catalog: (Array[Riffer::Skills::Frontmatter]) -> String

data/sig/generated/riffer/stream_events/base.rbs

@@ -1,15 +1,12 @@
 # Generated from lib/riffer/stream_events/base.rb with RBS::Inline
 
-# Base class for all streaming events. Subclasses must implement +to_h+.
 class Riffer::StreamEvents::Base
-  # The message role (typically :assistant).
   attr_reader role: Symbol
 
   # --
   # : (?role: Symbol) -> void
   def initialize: (?role: Symbol) -> void
 
-  # Converts the event to a hash.
   # --
   # : () -> Hash[Symbol, untyped]
   def to_h: () -> Hash[Symbol, untyped]

data/sig/generated/riffer/stream_events/finish_reason_done.rbs

@@ -1,16 +1,11 @@
 # Generated from lib/riffer/stream_events/finish_reason_done.rb with RBS::Inline
 
-# Normalized reason the LLM finished, emitted once near the end of the
-# stream; no ordering guarantee relative to TokenUsageDone.
+# No ordering guarantee relative to TokenUsageDone.
 class Riffer::StreamEvents::FinishReasonDone < Riffer::StreamEvents::Base
-  # The normalized finish reason (see <tt>Riffer::Providers::FinishReason::VALUES</tt>).
   attr_reader finish_reason: Symbol
 
-  # The provider's raw finish-reason value, when one exists on the wire.
   attr_reader raw_finish_reason: String?
 
-  # Raises Riffer::ArgumentError when +finish_reason+ is outside the
-  # normalized vocabulary.
   # --
   # : (finish_reason: Symbol, ?raw_finish_reason: String?, ?role: Symbol) -> void
   def initialize: (finish_reason: Symbol, ?raw_finish_reason: String?, ?role: Symbol) -> void

data/sig/generated/riffer/stream_events/guardrail_modification.rbs

@@ -1,34 +1,24 @@
 # Generated from lib/riffer/stream_events/guardrail_modification.rb with RBS::Inline
 
-# Emitted when a guardrail transforms data during streaming.
 class Riffer::StreamEvents::GuardrailModification < Riffer::StreamEvents::Base
-  # The modification record.
   attr_reader modification: Riffer::Guardrails::Modification
 
   # --
   # : (Riffer::Guardrails::Modification, ?role: Symbol) -> void
   def initialize: (Riffer::Guardrails::Modification, ?role: Symbol) -> void
 
-  # The guardrail class that made the transformation.
-  #
   # --
   # : () -> singleton(Riffer::Guardrail)
   def guardrail: () -> singleton(Riffer::Guardrail)
 
-  # The phase when the transformation occurred.
-  #
   # --
   # : () -> Symbol
   def phase: () -> Symbol
 
-  # The indices of messages that were changed.
-  #
   # --
   # : () -> Array[Integer]
   def message_indices: () -> Array[Integer]
 
-  # Converts the event to a hash.
-  #
   # --
   # : () -> Hash[Symbol, untyped]
   def to_h: () -> Hash[Symbol, untyped]

data/sig/generated/riffer/stream_events/guardrail_tripwire.rbs

@@ -1,34 +1,24 @@
 # Generated from lib/riffer/stream_events/guardrail_tripwire.rb with RBS::Inline
 
-# Emitted when a guardrail blocks execution during streaming.
 class Riffer::StreamEvents::GuardrailTripwire < Riffer::StreamEvents::Base
-  # The tripwire containing block details.
   attr_reader tripwire: Riffer::Guardrails::Tripwire
 
   # --
   # : (Riffer::Guardrails::Tripwire, ?role: Symbol) -> void
   def initialize: (Riffer::Guardrails::Tripwire, ?role: Symbol) -> void
 
-  # The reason for blocking.
-  #
   # --
   # : () -> String
   def reason: () -> String
 
-  # The phase when blocking occurred (:before or :after).
-  #
   # --
   # : () -> Symbol
   def phase: () -> Symbol
 
-  # The guardrail class that triggered the block.
-  #
   # --
   # : () -> singleton(Riffer::Guardrail)
   def guardrail: () -> singleton(Riffer::Guardrail)
 
-  # Converts the event to a hash.
-  #
   # --
   # : () -> Hash[Symbol, untyped]
   def to_h: () -> Hash[Symbol, untyped]

data/sig/generated/riffer/stream_events/interrupt.rbs

@@ -1,20 +1,12 @@
 # Generated from lib/riffer/stream_events/interrupt.rb with RBS::Inline
 
-# Represents an interrupt during streaming, fired when a callback throws
-# +:riffer_interrupt+.
 class Riffer::StreamEvents::Interrupt < Riffer::StreamEvents::Base
-  # The reason provided with the interrupt, if any.
   attr_reader reason: (String | Symbol)?
 
-  # Call ids of tool_use blocks riffer filled with placeholder results when the
-  # interrupt fired (only when history healing is on).
-  attr_reader healed_tool_call_ids: Array[String]
-
   # --
-  # : (?reason: (String | Symbol)?, ?healed_tool_call_ids: Array[String]) -> void
-  def initialize: (?reason: (String | Symbol)?, ?healed_tool_call_ids: Array[String]) -> void
+  # : (?reason: (String | Symbol)?) -> void
+  def initialize: (?reason: (String | Symbol)?) -> void
 
-  # Converts the event to a hash.
   # --
   # : () -> Hash[Symbol, untyped]
   def to_h: () -> Hash[Symbol, untyped]

data/sig/generated/riffer/stream_events/reasoning_delta.rbs

@@ -1,9 +1,6 @@
 # Generated from lib/riffer/stream_events/reasoning_delta.rb with RBS::Inline
 
-# Represents an incremental reasoning chunk during streaming; only emitted by
-# 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
 
   # --

data/sig/generated/riffer/stream_events/reasoning_done.rbs

@@ -1,11 +1,7 @@
 # Generated from lib/riffer/stream_events/reasoning_done.rb with RBS::Inline
 
-# Represents one completed reasoning block during streaming; only emitted by
-# providers that support reasoning (e.g. OpenAI with the reasoning option).
 class Riffer::StreamEvents::ReasoningDone < Riffer::StreamEvents::Base
-  # The reasoning block, which the agent loop accumulates onto the assistant
-  # message. Its +text+ is the content the preceding ReasoningDelta events
-  # added up to.
+  # +text+ is the concatenation of the preceding ReasoningDelta events.
   attr_reader part: Riffer::Messages::Assistant::ReasoningPart
 
   # --

data/sig/generated/riffer/stream_events/skill_activation.rbs

@@ -1,9 +1,6 @@
 # Generated from lib/riffer/stream_events/skill_activation.rb with RBS::Inline
 
-# Emitted when a skill is activated during streaming, via the +on_activate+
-# callback when the LLM calls the activation tool.
 class Riffer::StreamEvents::SkillActivation < Riffer::StreamEvents::Base
-  # The activated skill name.
   attr_reader name: String
 
   # --

data/sig/generated/riffer/stream_events/text_delta.rbs

@@ -1,8 +1,6 @@
 # Generated from lib/riffer/stream_events/text_delta.rb with RBS::Inline
 
-# Represents an incremental text chunk during streaming.
 class Riffer::StreamEvents::TextDelta < Riffer::StreamEvents::Base
-  # The incremental text content.
   attr_reader content: String
 
   # --

data/sig/generated/riffer/stream_events/text_done.rbs

@@ -1,8 +1,6 @@
 # Generated from lib/riffer/stream_events/text_done.rb with RBS::Inline
 
-# Represents completed text generation during streaming.
 class Riffer::StreamEvents::TextDone < Riffer::StreamEvents::Base
-  # The complete text content.
   attr_reader content: String
 
   # --

data/sig/generated/riffer/stream_events/token_usage_done.rbs

@@ -1,8 +1,6 @@
 # Generated from lib/riffer/stream_events/token_usage_done.rb with RBS::Inline
 
-# 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
 
   # --

data/sig/generated/riffer/stream_events/tool_call_delta.rbs

@@ -1,15 +1,11 @@
 # Generated from lib/riffer/stream_events/tool_call_delta.rb with RBS::Inline
 
-# Represents an incremental tool call chunk (partial argument data) during
-# streaming.
 class Riffer::StreamEvents::ToolCallDelta < Riffer::StreamEvents::Base
-  # The tool call item identifier.
   attr_reader item_id: String
 
-  # The tool name (may only be present in first delta).
+  # Providers may send the name only on the first delta.
   attr_reader name: String?
 
-  # The incremental arguments JSON fragment.
   attr_reader arguments_delta: String
 
   # --

data/sig/generated/riffer/stream_events/tool_call_done.rbs

@@ -1,17 +1,12 @@
 # Generated from lib/riffer/stream_events/tool_call_done.rb with RBS::Inline
 
-# Represents a completed tool call during streaming.
 class Riffer::StreamEvents::ToolCallDone < Riffer::StreamEvents::Base
-  # The tool call item identifier.
   attr_reader item_id: String
 
-  # The call identifier for response matching.
   attr_reader call_id: String
 
-  # The tool name.
   attr_reader name: String
 
-  # The complete arguments JSON string.
   attr_reader arguments: String
 
   # --

data/sig/generated/riffer/stream_events/web_search_done.rbs

@@ -1,11 +1,8 @@
 # Generated from lib/riffer/stream_events/web_search_done.rb with RBS::Inline
 
-# 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
 
-  # The search result sources with title and url.
   attr_reader sources: Array[Hash[Symbol, String?]]
 
   # --

data/sig/generated/riffer/stream_events/web_search_status.rbs

@@ -1,15 +1,11 @@
 # Generated from lib/riffer/stream_events/web_search_status.rb with RBS::Inline
 
-# A web search status notification, emitted as a server-side web search
-# progresses.
 class Riffer::StreamEvents::WebSearchStatus < Riffer::StreamEvents::Base
-  # The web search status ("in_progress", "searching", "completed", "open_page").
+  # One of "in_progress", "searching", "open_page", or "completed".
   attr_reader status: String
 
-  # The URL being fetched (present for "open_page" status).
   attr_reader url: String?
 
-  # The search query (present when available during status changes).
   attr_reader query: String?
 
   # --

data/sig/generated/riffer/testing.rbs

@@ -1,58 +1,22 @@
 # 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? ]]
@@ -67,8 +31,6 @@ module Riffer::Testing
   # : ((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

data/sig/generated/riffer/tool.rbs

@@ -1,53 +1,26 @@
 # Generated from lib/riffer/tool.rb with RBS::Inline
 
-# Base class for all tools in the Riffer framework. Subclasses must implement
-# the +call+ method.
-#
-#   class WeatherLookupTool < Riffer::Tool
-#     description "Provides current weather information for a specified city."
-#
-#     params do
-#       required :city, String, description: "The city to look up"
-#       optional :units, String, default: "celsius"
-#     end
-#
-#     def call(context:, city:, units: nil)
-#       # Implementation
-#     end
-#   end
 class Riffer::Tool
   extend Riffer::Tools::Toolable
 
   extend Riffer::Registrable
 
-  # Executes the tool with the given arguments.
   # --
   # : (context: Riffer::Agent::Context?, **untyped) -> Riffer::Tools::Response
   def call: (context: Riffer::Agent::Context?, **untyped) -> Riffer::Tools::Response
 
-  # Creates a text response.
-  #
   # --
   # : (untyped) -> Riffer::Tools::Response
   def text: (untyped) -> Riffer::Tools::Response
 
-  # Creates a JSON response.
-  #
   # --
   # : (untyped) -> Riffer::Tools::Response
   def json: (untyped) -> Riffer::Tools::Response
 
-  # Creates an error response.
-  #
   # --
   # : (String, ?type: Symbol) -> Riffer::Tools::Response
   def error: (String, ?type: Symbol) -> Riffer::Tools::Response
 
-  # Executes the tool with validation and timeout, folding every +StandardError+
-  # into an error Response. Anything outside +StandardError+ — an unimplemented
-  # +#call+ above all — still propagates, because a broken tool is a broken
-  # deploy rather than a bad request.
-  #
   # --
   # : (context: Riffer::Agent::Context?, **untyped) -> Riffer::Tools::Response
   def call_with_validation: (context: Riffer::Agent::Context?, **untyped) -> Riffer::Tools::Response

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

@@ -1,71 +1,45 @@
 # Generated from lib/riffer/tools/response.rb with RBS::Inline
 
-# Represents the result of a tool execution; every tool's +call+ must return one.
-#
-#   class MyTool < Riffer::Tool
-#     def call(context:, **kwargs)
-#       result = perform_operation
-#       Riffer::Tools::Response.success(result)
-#     rescue MyError => e
-#       Riffer::Tools::Response.error(e.message)
-#     end
-#   end
+# Every tool's +call+ must return one.
 class Riffer::Tools::Response
   @success: bool
 
   VALID_FORMATS: Array[Symbol]
 
-  # The response content.
   attr_reader content: String
 
-  # The error message, or +nil+ on success.
   attr_reader error_message: String?
 
-  # The error type, or +nil+ on success.
   attr_reader error_type: Symbol?
 
-  # 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.
+  # Kept out of every serialized form so it never reaches an LLM or a message
+  # payload.
   attr_reader exception: Exception?
 
-  # Creates a success response.
-  #
-  # Raises Riffer::ArgumentError if format is invalid.
-  #
   # --
   # : (untyped, ?format: Symbol) -> Riffer::Tools::Response
   def self.success: (untyped, ?format: Symbol) -> Riffer::Tools::Response
 
-  # Creates a success response with text format.
-  #
   # --
   # : (untyped) -> Riffer::Tools::Response
   def self.text: (untyped) -> Riffer::Tools::Response
 
-  # Creates a success response with JSON format.
-  #
   # --
   # : (untyped) -> Riffer::Tools::Response
   def self.json: (untyped) -> Riffer::Tools::Response
 
-  # Creates an error response.
-  #
   # --
   # : (String, ?type: Symbol, ?exception: Exception?) -> Riffer::Tools::Response
   def self.error: (String, ?type: Symbol, ?exception: Exception?) -> Riffer::Tools::Response
 
-  # Returns true if the tool execution succeeded.
   # --
   # : () -> bool
   def success?: () -> bool
 
-  # Returns true if the tool execution failed.
   # --
   # : () -> bool
   def error?: () -> bool
 
-  # Returns a hash representation of the response.
-  #
   # --
   # : () -> Hash[Symbol, untyped]
   def to_h: () -> Hash[Symbol, untyped]

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

@@ -1,10 +1,5 @@
 # Generated from lib/riffer/tools/runtime/fibers.rb with RBS::Inline
 
-# Executes tool calls concurrently using fibers via the +async+ gem.
-#
-#   class MyAgent < Riffer::Agent
-#     tool_runtime Riffer::Tools::Runtime::Fibers
-#   end
 class Riffer::Tools::Runtime::Fibers < Riffer::Tools::Runtime
   # --
   # : (?max_concurrency: Integer?) -> void