riffer 0.33.0 → 0.35.0

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

@@ -91,50 +91,56 @@ class Riffer::Providers::Base
   REQUEST_PARAM_ATTRIBUTES: Hash[Symbol, String]
 
   # --
-  # : [R] (String?, Array[Riffer::Messages::Base], Hash[Symbol, untyped]) { (Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span) -> R } -> R
-  def in_chat_span: [R] (String?, Array[Riffer::Messages::Base], Hash[Symbol, untyped]) { (Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span) -> R } -> R
+  # : [R] (String?, Array[Riffer::Messages::Base], Hash[Symbol, untyped]) { (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span) -> R } -> R
+  def in_chat_span: [R] (String?, Array[Riffer::Messages::Base], Hash[Symbol, untyped]) { (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span) -> R } -> R
 
   # --
   # : (String?, Hash[Symbol, untyped]) -> Hash[String, untyped]
   def chat_span_attributes: (String?, Hash[Symbol, untyped]) -> Hash[String, untyped]
 
   # --
-  # : (String?) -> Hash[String, untyped]
-  def chat_metric_base_attributes: (String?) -> Hash[String, untyped]
+  # : (String?, ?Hash[String, String]) -> Hash[String, untyped]
+  def chat_metric_base_attributes: (String?, ?Hash[String, String]) -> Hash[String, untyped]
 
   # --
-  # : (String?, String?) -> Hash[String, untyped]
-  def chat_metric_attributes: (String?, String?) -> Hash[String, untyped]
+  # : (String?, String?, ?Hash[String, String]) -> Hash[String, untyped]
+  def chat_metric_attributes: (String?, String?, ?Hash[String, String]) -> Hash[String, untyped]
+
+  # Maps normalized tags to their namespaced span/metric 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]
 
   # Per-call only — the run level would double-count an aggregate.
   # --
-  # : (String?, Riffer::Providers::TokenUsage?) -> void
-  def record_token_usage_metric: (String?, Riffer::Providers::TokenUsage?) -> void
+  # : (String?, Riffer::Providers::TokenUsage?, ?Hash[String, String]) -> void
+  def record_token_usage_metric: (String?, Riffer::Providers::TokenUsage?, ?Hash[String, String]) -> void
 
   # Per-call only — the run level would double-count an aggregate.
   # --
-  # : (String?, Riffer::Providers::TokenUsage?) -> void
-  def record_cost_metric: (String?, Riffer::Providers::TokenUsage?) -> void
+  # : (String?, Riffer::Providers::TokenUsage?, ?Hash[String, String]) -> void
+  def record_cost_metric: (String?, Riffer::Providers::TokenUsage?, ?Hash[String, String]) -> void
 
   # --
-  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span), Symbol?, String?) -> void
-  def record_finish_reason: (Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span, Symbol?, String?) -> void
+  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span), Symbol?, String?) -> void
+  def record_finish_reason: (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span, Symbol?, String?) -> void
 
   # --
-  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span), Riffer::Tracing::StreamRecorder) -> void
-  def record_stream_outcome: (Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span, Riffer::Tracing::StreamRecorder) -> void
+  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span), Riffer::Tracing::StreamRecorder) -> void
+  def record_stream_outcome: (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span, Riffer::Tracing::StreamRecorder) -> void
 
   # --
-  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span), Array[Riffer::Messages::Base]) -> void
-  def capture_input: (Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span, Array[Riffer::Messages::Base]) -> void
+  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span), Array[Riffer::Messages::Base]) -> void
+  def capture_input: (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span, Array[Riffer::Messages::Base]) -> void
 
   # --
-  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span), content: String?, tool_calls: Array[Riffer::Messages::Assistant::ToolCall], finish_reason: Symbol?) -> void
-  def capture_output: (Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span, content: String?, tool_calls: Array[Riffer::Messages::Assistant::ToolCall], finish_reason: Symbol?) -> void
+  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span), content: String?, tool_calls: Array[Riffer::Messages::Assistant::ToolCall], finish_reason: Symbol?) -> void
+  def capture_output: (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span, content: String?, tool_calls: Array[Riffer::Messages::Assistant::ToolCall], finish_reason: Symbol?) -> void
 
   # --
-  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span)) -> bool
-  def capture_messages?: (Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span) -> bool
+  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span)) -> bool
+  def capture_messages?: (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span) -> bool
 
   # --
   # : (Riffer::Providers::_EventSink, Riffer::Providers::FinishReason?) -> void

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

@@ -12,8 +12,8 @@ class Riffer::Tools::Runtime
 
   # 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?) -> 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?) -> Array[[ Riffer::Messages::Assistant::ToolCall, Riffer::Tools::Response ]]
+  # : (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.
@@ -36,8 +36,8 @@ class Riffer::Tools::Runtime
   private
 
   # --
-  # : (Riffer::Messages::Assistant::ToolCall) { () -> Riffer::Tools::Response } -> [Riffer::Messages::Assistant::ToolCall, Riffer::Tools::Response]
-  def instrument_tool_call: (Riffer::Messages::Assistant::ToolCall) { () -> Riffer::Tools::Response } -> [ Riffer::Messages::Assistant::ToolCall, Riffer::Tools::Response ]
+  # : (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 ]
 
   # --
   # : (Riffer::Messages::Assistant::ToolCall, tools: Array[singleton(Riffer::Tool)], context: Riffer::Agent::Context?, ?assistant_message: Riffer::Messages::Assistant?) -> Riffer::Tools::Response
@@ -49,32 +49,38 @@ class Riffer::Tools::Runtime
 
   # Emitted outside +around_tool_call+ so host enrichment spans nest beneath it.
   # --
-  # : [R] (Riffer::Messages::Assistant::ToolCall) { ((Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span)) -> R } -> R
-  def in_tool_span: [R] (Riffer::Messages::Assistant::ToolCall) { (Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span) -> R } -> R
+  # : [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
 
   # --
-  # : (Riffer::Messages::Assistant::ToolCall) -> Hash[String, untyped]
-  def tool_span_attributes: (Riffer::Messages::Assistant::ToolCall) -> Hash[String, untyped]
+  # : (Riffer::Messages::Assistant::ToolCall, ?Hash[String, String]) -> Hash[String, untyped]
+  def tool_span_attributes: (Riffer::Messages::Assistant::ToolCall, ?Hash[String, String]) -> Hash[String, untyped]
 
   # --
-  # : (Riffer::Messages::Assistant::ToolCall, String?) -> Hash[String, untyped]
-  def tool_metric_attributes: (Riffer::Messages::Assistant::ToolCall, String?) -> Hash[String, untyped]
+  # : (Riffer::Messages::Assistant::ToolCall, String?, ?Hash[String, String]) -> Hash[String, untyped]
+  def tool_metric_attributes: (Riffer::Messages::Assistant::ToolCall, String?, ?Hash[String, String]) -> Hash[String, untyped]
+
+  # Maps normalized tags to their namespaced span/metric 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 returned error Response is a handled outcome, so its status stays unset —
   # an error span status is reserved for a raised exception.
   # --
-  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span), Riffer::Tools::Response) -> void
-  def record_tool_outcome: (Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span, Riffer::Tools::Response) -> void
+  # : ((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
 
   # --
-  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span), Riffer::Messages::Assistant::ToolCall) -> void
-  def capture_tool_arguments: (Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span, Riffer::Messages::Assistant::ToolCall) -> void
+  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span), Riffer::Messages::Assistant::ToolCall) -> void
+  def capture_tool_arguments: (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span, Riffer::Messages::Assistant::ToolCall) -> void
 
   # --
-  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span), Riffer::Tools::Response) -> void
-  def capture_tool_result: (Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span, Riffer::Tools::Response) -> void
+  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span), Riffer::Tools::Response) -> void
+  def capture_tool_result: (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span, Riffer::Tools::Response) -> void
 
   # --
-  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span)) -> bool
-  def capture_tool_content?: (Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span) -> bool
+  # : ((Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span)) -> bool
+  def capture_tool_content?: (Riffer::Tracing::Otel::Span | Riffer::Tracing::NoOp::Span) -> bool
 end

data/sig/generated/riffer/tracing/{null.rbs → no_op.rbs}

@@ -1,8 +1,8 @@
-# Generated from lib/riffer/tracing/null.rb with RBS::Inline
+# 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::Null
+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
@@ -27,12 +27,12 @@ module Riffer::Tracing::Null
     def recording?: () -> bool
   end
 
-  SPAN: Riffer::Tracing::Null::Span
+  SPAN: Riffer::Tracing::NoOp::Span
 
   # Yields the no-op span, ignoring all span options.
   # --
-  # : [R] (String, **untyped) { (Riffer::Tracing::Null::Span) -> R } -> R
-  def in_span: [R] (String, **untyped) { (Riffer::Tracing::Null::Span) -> R } -> R
+  # : [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.
   # --

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

@@ -39,10 +39,11 @@ class Riffer::Tracing::Otel
   end
 
   # Builds a backend when the OpenTelemetry API is loadable at a supported
-  # version; returns +nil+ so resolution falls back to Null.
+  # version; returns +nil+ so resolution falls back to NoOp. +provider+
+  # defaults to the global <tt>OpenTelemetry.tracer_provider</tt>.
   # --
-  # : (provider: untyped) -> Riffer::Tracing::Otel?
-  def self.build: (provider: untyped) -> Riffer::Tracing::Otel?
+  # : (?provider: untyped) -> Riffer::Tracing::Otel?
+  def self.build: (?provider: untyped) -> Riffer::Tracing::Otel?
 
   # Whether the OpenTelemetry API gem is loadable at a supported version.
   # --

data/sig/generated/riffer/tracing.rbs

@@ -4,7 +4,7 @@
 # OpenTelemetry API and no-ops otherwise, so riffer never declares an OTEL
 # dependency.
 module Riffer::Tracing
-  @backend: (Riffer::Tracing::Otel | singleton(Riffer::Tracing::Null))?
+  @backend: untyped
 
   MUTEX: Mutex
 
@@ -14,8 +14,8 @@ module Riffer::Tracing
 
   # Opens a span around the block, yielding the span.
   # --
-  # : [R] (String, ?attributes: Hash[String, untyped]?, ?kind: Symbol) { (Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span) -> R } -> R
-  def in_span: [R] (String, ?attributes: Hash[String, untyped]?, ?kind: Symbol) { (Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span) -> R } -> R
+  # : [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.
@@ -32,8 +32,8 @@ module Riffer::Tracing
   # 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::Null::Span), Riffer::Providers::TokenUsage?) -> void
-  def record_usage: (Riffer::Tracing::Otel::Span | Riffer::Tracing::Null::Span, Riffer::Providers::TokenUsage?) -> void
+  # : ((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.
   # --
@@ -43,10 +43,10 @@ module Riffer::Tracing
   private
 
   # --
-  # : () -> (Riffer::Tracing::Otel | singleton(Riffer::Tracing::Null))
-  def backend: () -> (Riffer::Tracing::Otel | singleton(Riffer::Tracing::Null))
+  # : () -> untyped
+  def backend: () -> untyped
 
   # --
-  # : () -> (Riffer::Tracing::Otel | singleton(Riffer::Tracing::Null))
-  def resolve_backend: () -> (Riffer::Tracing::Otel | singleton(Riffer::Tracing::Null))
+  # : () -> untyped
+  def resolve_backend: () -> untyped
 end

data/sig/manual/riffer/metrics/no_op.rbs

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

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

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: riffer
 version: !ruby/object:Gem::Version
-  version: 0.33.0
+  version: 0.35.0
 platform: ruby
 authors:
 - Jake Bottrall
@@ -35,14 +35,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.48.1
+        version: 1.49.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.48.1
+        version: 1.49.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.66.1
+        version: 0.68.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.66.1
+        version: 0.68.0
 - !ruby/object:Gem::Dependency
   name: async
   requirement: !ruby/object:Gem::Requirement
@@ -336,7 +336,7 @@ files:
 - lib/riffer/messages/user.rb
 - lib/riffer/metrics.rb
 - lib/riffer/metrics/instruments.rb
-- lib/riffer/metrics/null.rb
+- lib/riffer/metrics/no_op.rb
 - lib/riffer/metrics/otel.rb
 - lib/riffer/params.rb
 - lib/riffer/params/boolean.rb
@@ -393,7 +393,7 @@ files:
 - lib/riffer/tools/toolable.rb
 - lib/riffer/tracing.rb
 - lib/riffer/tracing/capture.rb
-- lib/riffer/tracing/null.rb
+- lib/riffer/tracing/no_op.rb
 - lib/riffer/tracing/otel.rb
 - lib/riffer/tracing/stream_recorder.rb
 - lib/riffer/version.rb
@@ -457,7 +457,7 @@ files:
 - sig/generated/riffer/messages/user.rbs
 - sig/generated/riffer/metrics.rbs
 - sig/generated/riffer/metrics/instruments.rbs
-- sig/generated/riffer/metrics/null.rbs
+- sig/generated/riffer/metrics/no_op.rbs
 - sig/generated/riffer/metrics/otel.rbs
 - sig/generated/riffer/params.rbs
 - sig/generated/riffer/params/boolean.rbs
@@ -514,7 +514,7 @@ files:
 - sig/generated/riffer/tools/toolable.rbs
 - sig/generated/riffer/tracing.rbs
 - sig/generated/riffer/tracing/capture.rbs
-- sig/generated/riffer/tracing/null.rbs
+- sig/generated/riffer/tracing/no_op.rbs
 - sig/generated/riffer/tracing/otel.rbs
 - sig/generated/riffer/tracing/stream_recorder.rbs
 - sig/generated/riffer/version.rbs
@@ -533,12 +533,12 @@ files:
 - sig/manual/riffer/mcp/registry.rbs
 - sig/manual/riffer/mcp/tool_factory.rbs
 - sig/manual/riffer/metrics.rbs
-- sig/manual/riffer/metrics/null.rbs
+- sig/manual/riffer/metrics/no_op.rbs
 - sig/manual/riffer/providers.rbs
 - sig/manual/riffer/providers/repository.rbs
 - sig/manual/riffer/tracing.rbs
 - sig/manual/riffer/tracing/capture.rbs
-- sig/manual/riffer/tracing/null.rbs
+- sig/manual/riffer/tracing/no_op.rbs
 homepage: https://riffer.ai
 licenses:
 - MIT

data/sig/manual/riffer/metrics/null.rbs

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

data/sig/manual/riffer/tracing/null.rbs

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