riffer 0.52.0 → 0.52.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a69720c69304a2b2ac26a5b03a3fa0866a58434687fc5745563a6a4dd0afc7c
-  data.tar.gz: aa9b4937c096c1e152b941f426b7f6b119d6b90d45935a57a42e9fd0f19ac0bd
+  metadata.gz: cdd49e9dd195fd8a90f82297b355f5a267fe79d15a909bb40219fcc5faedc1ea
+  data.tar.gz: c0aeeffd8b3aba99953c1efc2ac186a65d86611bd4c9e690cdd31c8834e8242d
 SHA512:
-  metadata.gz: 169697ebceedccc7be95b4f98ddee84a93f48b330b1fe71a1207ad98d79822298e0432e7bb9ab4696ffa2e2709c8df4f795fbd2e6fd33a1643147be2f2cf8870
-  data.tar.gz: eb1eab78a9d50a63ea156b53c951e500944d5ef8ec622811dead87c0427198de9d979a31ec60b0de006d8c6409424d73b605ff7ddf997a88de55bd37eea3d3b1
+  metadata.gz: fc7d4287a7a94b1891d95d2c048e8ad3d5cd1cac9e7cae3047887316ed52224aa8f72a0c01eaba5d0ba1ebe1b4d78b48de42cc4a00114d5a8119fefe405f0e58
+  data.tar.gz: db472038a3c65f8643e792c987a837e1955c0699d3a2fd6297612e7f3bc8a8374f56751541663e9662f6da2dea0381a219d43b32b96eef30d6716d9662fdb540

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.52.0"
+  ".": "0.52.1"
 }

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.52.1](https://github.com/janeapp/riffer/compare/riffer/v0.52.0...riffer/v0.52.1) (2026-10-09)
+
+
+### Bug Fixes
+
+* **structured_output:** return the extracted JSON as response content ([#484](https://github.com/janeapp/riffer/issues/484)) ([cbea668](https://github.com/janeapp/riffer/commit/cbea66888690ec7fc0dccbde6198d2704fb165f0))
+
 ## [0.52.0](https://github.com/janeapp/riffer/compare/riffer/v0.51.0...riffer/v0.52.0) (2026-10-08)
 
 

data/docs/AGENTS.md

@@ -168,7 +168,7 @@ end
 
 The LLM response is automatically parsed and validated against the schema. Access the result via `response.structured_output`.
 
-If the response is not valid JSON on its own, Riffer recovers a JSON object wrapped in a code fence (```` ```json ````), surrounded by prose (`Here is the data: {...}`), or wrapped in formatting (`**{...}**`). It parses the span from the first `{` to the last `}`, so a reply whose surrounding text contains other braces, or that holds more than one object, is still rejected; `response.content` keeps the raw text.
+If the response is not valid JSON on its own, Riffer recovers a JSON object wrapped in a code fence (```` ```json ````), surrounded by prose (`Here is the data: {...}`), or wrapped in formatting (`**{...}**`). It parses the span from the first `{` to the last `}`, so a reply whose surrounding text contains other braces, or that holds more than one object, is still rejected. When the recovered object validates, `response.content` holds only the extracted JSON text, without the fence or prose; the assistant message in `response.messages` keeps the raw reply. A reply that fails parsing or validation leaves the raw text in `response.content`.
 
 When the response contains no well-formed JSON object or does not satisfy the schema, `response.structured_output` is `nil`, `response.outcome.reason` is `:invalid_structured_output`, and `response.outcome.detail` carries the parse or validation message:
 
@@ -197,7 +197,7 @@ class SentimentAgent < Riffer::Agent
 end
 ```
 
-With `strategy: :prompted`, the provider never receives its native structured-output field. Instead, an instruction carrying the JSON Schema is appended to the system instructions on every request of the run (it is not stored in `session.messages`), and the reply is parsed and validated exactly as above: `response.content` is the reply text, `response.structured_output` holds the validated object, and a reply that fails parsing or validation ends with `:invalid_structured_output`. Because nothing forces the model to comply, expect more `:invalid_structured_output` outcomes than with the native strategy.
+With `strategy: :prompted`, the provider never receives its native structured-output field. Instead, an instruction carrying the JSON Schema is appended to the system instructions on every request of the run (it is not stored in `session.messages`), and the reply is parsed and validated exactly as above: `response.content` is the reply's JSON text, `response.structured_output` holds the validated object, and a reply that fails parsing or validation ends with `:invalid_structured_output`. Because nothing forces the model to comply, expect more `:invalid_structured_output` outcomes than with the native strategy.
 
 | Strategy            | Behavior                                                        |
 | ------------------- | --------------------------------------------------------------- |

data/lib/riffer/agent/run.rb

@@ -207,7 +207,7 @@ module Riffer::Agent::Run
     result = agent.structured_output && structured_output_result(agent, message)
     build_response(
       agent,
-      message&.content || "",
+      result&.json || message&.content || "",
       outcome: final_outcome(message, result, interrupted: interrupted, interrupt_reason: interrupt_reason),
       modifications: all_modifications,
       reasoning: message&.reasoning || [],

data/lib/riffer/agent/structured_output/parser.rb

@@ -9,19 +9,30 @@ module Riffer::Agent::StructuredOutput::Parser
   #--
   #: (String) -> Hash[Symbol, untyped]?
   def parse(content)
-    parse_object(content) || outermost_object(content)
+    extract(content)&.last
+  end
+
+  #--
+  #: (String) -> [String, Hash[Symbol, untyped]]?
+  def extract(content)
+    parsed = parse_object(content)
+    return [content, parsed] if parsed
+
+    outermost_object(content)
   end
 
   private
 
   #--
-  #: (String) -> Hash[Symbol, untyped]?
+  #: (String) -> [String, Hash[Symbol, untyped]]?
   def outermost_object(content)
     start = content.index("{")
     stop = content.rindex("}")
     return unless start && stop
 
-    parse_object(content[start..stop].to_s)
+    json = content[start..stop].to_s
+    parsed = parse_object(json)
+    [json, parsed] if parsed
   end
 
   #--

data/lib/riffer/agent/structured_output/result.rb

@@ -5,11 +5,14 @@ class Riffer::Agent::StructuredOutput::Result
   attr_reader :object #: Hash[Symbol, untyped]? # @dynamic object
   attr_reader :error #: String? # @dynamic error
 
+  attr_reader :json #: String? # @dynamic json
+
   #--
-  #: (?object: Hash[Symbol, untyped]?, ?error: String?) -> void
-  def initialize(object: nil, error: nil)
+  #: (?object: Hash[Symbol, untyped]?, ?error: String?, ?json: String?) -> void
+  def initialize(object: nil, error: nil, json: nil)
     @object = object
     @error = error
+    @json = json
   end
 
   #--

data/lib/riffer/agent/structured_output.rb

@@ -38,11 +38,11 @@ class Riffer::Agent::StructuredOutput
   #--
   #: (String) -> Riffer::Agent::StructuredOutput::Result
   def parse_and_validate(json_string)
-    parsed = Riffer::Agent::StructuredOutput::Parser.parse(json_string)
+    json, parsed = Riffer::Agent::StructuredOutput::Parser.extract(json_string)
     return Result.new(error: "JSON parse error: no JSON object found in the response") if parsed.nil?
 
     validated = @params.validate(parsed)
-    Result.new(object: validated)
+    Result.new(object: validated, json: json)
   rescue Riffer::ValidationError => e
     Result.new(error: "Validation error: #{e.message}")
   end

data/lib/riffer/version.rb

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

data/sig/generated/riffer/agent/structured_output/parser.rbs

@@ -5,11 +5,15 @@ module Riffer::Agent::StructuredOutput::Parser
   # : (String) -> Hash[Symbol, untyped]?
   def parse: (String) -> Hash[Symbol, untyped]?
 
+  # --
+  # : (String) -> [String, Hash[Symbol, untyped]]?
+  def extract: (String) -> [ String, Hash[Symbol, untyped] ]?
+
   private
 
   # --
-  # : (String) -> Hash[Symbol, untyped]?
-  def outermost_object: (String) -> Hash[Symbol, untyped]?
+  # : (String) -> [String, Hash[Symbol, untyped]]?
+  def outermost_object: (String) -> [ String, Hash[Symbol, untyped] ]?
 
   # --
   # : (String) -> Hash[Symbol, untyped]?

data/sig/generated/riffer/agent/structured_output/result.rbs

@@ -5,9 +5,11 @@ class Riffer::Agent::StructuredOutput::Result
 
   attr_reader error: String?
 
+  attr_reader json: String?
+
   # --
-  # : (?object: Hash[Symbol, untyped]?, ?error: String?) -> void
-  def initialize: (?object: Hash[Symbol, untyped]?, ?error: String?) -> void
+  # : (?object: Hash[Symbol, untyped]?, ?error: String?, ?json: String?) -> void
+  def initialize: (?object: Hash[Symbol, untyped]?, ?error: String?, ?json: String?) -> void
 
   # --
   # : () -> bool

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: riffer
 version: !ruby/object:Gem::Version
-  version: 0.52.0
+  version: 0.52.1
 platform: ruby
 authors:
 - Jake Bottrall