riffer 0.37.1 → 0.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf9db0e6d260a9528768fd4c13e59af50504afde1a251fdbe056f2e0220e60e4
-  data.tar.gz: 71064f20c5214d303080a57494b3a4d3b93f23b3f446c131bbb34c015ec7a4ae
+  metadata.gz: 201c994ac795b1563165552d686a38b103b83f718ceae14b102213ecb17984fd
+  data.tar.gz: 933ede064f5446e7634a446c9cf8ad502c99728ee87f18498fdb564303f2dce1
 SHA512:
-  metadata.gz: c4971ac39454bc52acb06ee24542ac64764db8360f8f07252c709a4145301a590c8d336b6496a10a5a1920964cb12dcc815c05519ece50bf6b07d17dba7118e9
-  data.tar.gz: 653fe046ac9feb510284ef89808b2ac17a83b274fe2c4b979c33d7c46ba8362bd1a3280259957b217f0fc1855c1acdfbc4979764314ed1b5290e1f84370ab6ae
+  metadata.gz: 064e68be4a2c9916e6a33fed5952501722434396c82eed7da754cadaef509ecce764b67297f61bc1dca5e0cef1ec4447bb99013fb6cc4ac70dc74c274ecc746a
+  data.tar.gz: fbeda57bbc9611d9f1be65f01560faf26e93c7d723e2e9116e6fb0d7c1f7b005488fd123c14f3917c4e73345b6554e7b10e8a7b104fe6bb5b65cf547f86de859

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.37.1"
+  ".": "0.38.0"
 }

data/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.38.0](https://github.com/janeapp/riffer/compare/riffer/v0.37.1...riffer/v0.38.0) (2026-07-21)
+
+
+### Features
+
+* record time to first chunk on streaming chat spans ([#369](https://github.com/janeapp/riffer/issues/369)) ([133b019](https://github.com/janeapp/riffer/commit/133b0197dd358ae1cd37adbeb7b5df7446b0cbde))
+
 ## [0.37.1](https://github.com/janeapp/riffer/compare/riffer/v0.37.0...riffer/v0.37.1) (2026-07-13)
 
 

data/docs/16_TRACING.md

@@ -147,6 +147,7 @@ Usage on this span is the run total, aggregated across every step. See [Token us
 | `riffer.cost`                              | float    | When the call's model was priced                                              |
 | `gen_ai.response.finish_reasons`           | string[] | When the provider reported a finish reason                                    |
 | `riffer.finish_reason.raw`                 | string   | When the raw value differs from the normalized one                            |
+| `gen_ai.response.time_to_first_chunk`      | float    | Streaming only — seconds from request issuance to the first stream event      |
 | `gen_ai.input.messages`                    | string   | When `capture_messages` is on (JSON; see [capture](#message-content-capture)) |
 | `gen_ai.system_instructions`               | string   | When `capture_messages` is on and a system prompt exists                      |
 | `gen_ai.output.messages`                   | string   | When `capture_messages` is on (JSON)                                          |

data/lib/riffer/providers/base.rb

@@ -263,6 +263,8 @@ class Riffer::Providers::Base
   def record_stream_outcome(span, recorder)
     Riffer::Tracing.record_usage(span, recorder.token_usage)
     record_finish_reason(span, recorder.finish_reason, recorder.raw_finish_reason)
+    time_to_first_chunk = recorder.time_to_first_chunk
+    span.set_attribute("gen_ai.response.time_to_first_chunk", time_to_first_chunk) if time_to_first_chunk
     capture_output(span, content: recorder.content, tool_calls: recorder.tool_calls, finish_reason: recorder.finish_reason)
   end
 

data/lib/riffer/tracing/stream_recorder.rb

@@ -5,9 +5,13 @@
 # forwarding every event downstream untouched.
 class Riffer::Tracing::StreamRecorder # :nodoc: all
   # @rbs @yielder: Enumerator::Yielder
+  # @rbs @clock: ^() -> Float
+  # @rbs @started_at: Float
 
   attr_reader :token_usage #: Riffer::Providers::TokenUsage?
 
+  attr_reader :time_to_first_chunk #: Float?
+
   attr_reader :finish_reason #: Symbol?
 
   attr_reader :raw_finish_reason #: String?
@@ -17,15 +21,18 @@ class Riffer::Tracing::StreamRecorder # :nodoc: all
   attr_reader :tool_calls #: Array[Riffer::Messages::Assistant::ToolCall]
 
   #--
-  #: (Enumerator::Yielder) -> void
-  def initialize(yielder)
+  #: (Enumerator::Yielder, ?clock: ^() -> Float) -> void
+  def initialize(yielder, clock: -> { Process.clock_gettime(Process::CLOCK_MONOTONIC) })
     @yielder = yielder
+    @clock = clock
+    @started_at = clock.call
     @tool_calls = [] #: Array[Riffer::Messages::Assistant::ToolCall]
   end
 
   #--
   #: (Riffer::StreamEvents::Base) -> self
   def <<(event)
+    @time_to_first_chunk ||= @clock.call - @started_at
     record(event)
     @yielder << event
     self

data/lib/riffer/version.rb

@@ -2,5 +2,5 @@
 # rbs_inline: enabled
 
 module Riffer
-  VERSION = "0.37.1" #: String
+  VERSION = "0.38.0" #: String
 end

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

@@ -5,8 +5,14 @@
 class Riffer::Tracing::StreamRecorder
   @yielder: Enumerator::Yielder
 
+  @clock: ^() -> Float
+
+  @started_at: Float
+
   attr_reader token_usage: Riffer::Providers::TokenUsage?
 
+  attr_reader time_to_first_chunk: Float?
+
   attr_reader finish_reason: Symbol?
 
   attr_reader raw_finish_reason: String?
@@ -16,8 +22,8 @@ class Riffer::Tracing::StreamRecorder
   attr_reader tool_calls: Array[Riffer::Messages::Assistant::ToolCall]
 
   # --
-  # : (Enumerator::Yielder) -> void
-  def initialize: (Enumerator::Yielder) -> void
+  # : (Enumerator::Yielder, ?clock: ^() -> Float) -> void
+  def initialize: (Enumerator::Yielder, ?clock: ^() -> Float) -> void
 
   # --
   # : (Riffer::StreamEvents::Base) -> self

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: riffer
 version: !ruby/object:Gem::Version
-  version: 0.37.1
+  version: 0.38.0
 platform: ruby
 authors:
 - Jake Bottrall
@@ -35,14 +35,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.55.0
+        version: 1.56.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.55.0
+        version: 1.56.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.69.0
+        version: 0.71.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.69.0
+        version: 0.71.0
 - !ruby/object:Gem::Dependency
   name: async
   requirement: !ruby/object:Gem::Requirement