riffer 0.51.0 → 0.52.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1379919ce4dcd42bd21286bb3447f32967cd94fff23cf5a3ed2e422b40a6cfc
-  data.tar.gz: 8d7860fa41acf5e89e82bd25f8f57477da356cb6948a4438d9ca0a7c71a6d959
+  metadata.gz: cdd49e9dd195fd8a90f82297b355f5a267fe79d15a909bb40219fcc5faedc1ea
+  data.tar.gz: c0aeeffd8b3aba99953c1efc2ac186a65d86611bd4c9e690cdd31c8834e8242d
 SHA512:
-  metadata.gz: 882930df0b0f87cc9e2dbe3b792969db10b811a1c33d92ea5797d53564421177032c5ad75362247cbd5e012784fea7bf25c90d5de3a3ce54cc472af2c210e268
-  data.tar.gz: 9b23fe7c44c6d3fbbbe5ef165f2dc07c1a55ad2050dfd7b188cb674b9b3fe6ee45441583e8cc544092e3820c1c2a30f1f9809ce3ddd874d038180f94184990fd
+  metadata.gz: fc7d4287a7a94b1891d95d2c048e8ad3d5cd1cac9e7cae3047887316ed52224aa8f72a0c01eaba5d0ba1ebe1b4d78b48de42cc4a00114d5a8119fefe405f0e58
+  data.tar.gz: db472038a3c65f8643e792c987a837e1955c0699d3a2fd6297612e7f3bc8a8374f56751541663e9662f6da2dea0381a219d43b32b96eef30d6716d9662fdb540

data/.release-please-manifest.json

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

data/CHANGELOG.md

@@ -5,6 +5,20 @@ 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)
+
+
+### Features
+
+* **structured_output:** add experimental prompted strategy ([#477](https://github.com/janeapp/riffer/issues/477)) ([f517fe1](https://github.com/janeapp/riffer/commit/f517fe19788fe34167515998a7ac2870605b2228))
+
 ## [0.51.0](https://github.com/janeapp/riffer/compare/riffer/v0.50.1...riffer/v0.51.0) (2026-10-07)
 
 

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:
 
@@ -183,6 +183,29 @@ else
 end
 ```
 
+#### Structured output strategy (experimental)
+
+By default Riffer sends the schema through each provider's native structured-output field. Some models reject that field, accept it without enforcing it, or behave differently with it enabled (for example, skipping tool calls). For those, opt the agent into the **experimental** prompted strategy:
+
+```ruby
+class SentimentAgent < Riffer::Agent
+  model 'amazon_bedrock/my-model'
+  instructions 'Analyze the sentiment of the given text.'
+  structured_output strategy: :prompted do
+    required :sentiment, String, description: "positive, negative, or neutral"
+  end
+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'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                                                        |
+| ------------------- | --------------------------------------------------------------- |
+| `:native` (default) | Schema sent through the provider's structured-output field      |
+| `:prompted`         | Schema sent in the system prompt; experimental, may change      |
+
+Riffer does not pick a strategy per model — the choice is always yours. The strategy is copied to subclasses and survives [serialization](SERIALIZATION.md). An unknown value raises `Riffer::ArgumentError`. `strategy:` can also be passed with a `Riffer::Params` instance: `structured_output params, strategy: :prompted`.
+
 #### Nested Objects
 
 Use `Hash` with a block to define nested object schemas:

data/docs/SERIALIZATION.md

@@ -45,6 +45,7 @@ The session is used **as-is**: the rebuilt agent does not prepend anything to it
   model_options:     { temperature: 0.2 },
   max_steps:         8,                        # integer; -1 = unlimited (see below)
   structured_output: { type: "object", … },   # JSON Schema, or null
+  structured_output_strategy: :native,        # :native or :prompted ("native"/"prompted" over JSON)
   tools: [ { name:, description:, parameters_schema:, timeout: }, … ]
 }
 ```
@@ -57,6 +58,8 @@ The session is used **as-is**: the rebuilt agent does not prepend anything to it
 
 Structured output crosses as **provider-neutral JSON Schema** (`Riffer::Params#to_json_schema`), never a provider-rendered schema. `from_h` rebuilds a validating `Riffer::Params` via `Riffer::Params.from_json_schema`, so the rebuilt agent both constrains the model and can `parse_and_validate` responses — rendering provider-correct bytes at call time, the same way an in-code agent does.
 
+`structured_output_strategy` carries the [strategy](AGENTS.md#structured-output-strategy-experimental) the agent was configured with, so a `:prompted` agent rebuilds as `:prompted`. A hash without the key decodes as `:native`.
+
 ## Reconstructing tools
 
 Tools cross as `{name, description, parameters_schema, timeout}` descriptors — never code. How a descriptor becomes a runnable tool is controlled by the `tool_resolver:` you pass to `from_h`. The two common shapes:

data/lib/riffer/agent/config.rb

@@ -3,6 +3,7 @@
 
 class Riffer::Agent::Config
   DEFAULT_MAX_STEPS = 16 #: Integer
+  STRUCTURED_OUTPUT_STRATEGIES = %i[native prompted].freeze #: Array[Symbol]
 
   # @rbs @tool_runtime: (singleton(Riffer::Tools::Runtime) | Riffer::Tools::Runtime | Proc)?
 
@@ -11,6 +12,7 @@ class Riffer::Agent::Config
   attr_reader :instructions #: (String | Proc)? # @dynamic instructions
   attr_accessor :model_options #: Hash[Symbol, untyped] # @dynamic model_options, model_options=
   attr_reader :structured_output #: Riffer::Params? # @dynamic structured_output
+  attr_reader :structured_output_strategy #: Symbol # @dynamic structured_output_strategy
   attr_accessor :max_steps #: Numeric? # @dynamic max_steps, max_steps=
   attr_accessor :tools_config #: (Array[singleton(Riffer::Tool)] | Proc)? # @dynamic tools_config, tools_config=
   attr_reader :mcp_configs #: Array[Hash[Symbol, untyped]] # @dynamic mcp_configs
@@ -24,6 +26,7 @@ class Riffer::Agent::Config
   #    ?instructions: (String | Proc)?,
   #    ?model_options: Hash[Symbol, untyped],
   #    ?structured_output: Riffer::Params?,
+  #    ?structured_output_strategy: Symbol,
   #    ?max_steps: Numeric?,
   #    ?tools_config: (Array[singleton(Riffer::Tool)] | Proc)?,
   #    ?mcp_configs: Array[Hash[Symbol, untyped]],
@@ -37,6 +40,7 @@ class Riffer::Agent::Config
     instructions: nil,
     model_options: {},
     structured_output: nil,
+    structured_output_strategy: :native,
     max_steps: DEFAULT_MAX_STEPS,
     tools_config: nil,
     mcp_configs: [],
@@ -54,6 +58,7 @@ class Riffer::Agent::Config
     self.model = model
     self.instructions = instructions
     self.structured_output = structured_output
+    self.structured_output_strategy = structured_output_strategy
     self.tool_runtime = tool_runtime if tool_runtime
   end
 
@@ -73,6 +78,17 @@ class Riffer::Agent::Config
     @structured_output = value
   end
 
+  #--
+  #: (Symbol) -> Symbol
+  def structured_output_strategy=(value)
+    unless STRUCTURED_OUTPUT_STRATEGIES.include?(value)
+      raise Riffer::ArgumentError,
+            "structured_output_strategy must be one of #{STRUCTURED_OUTPUT_STRATEGIES.inspect}, got #{value.inspect}"
+    end
+
+    @structured_output_strategy = value
+  end
+
   #--
   #: () -> (singleton(Riffer::Tools::Runtime) | Riffer::Tools::Runtime | Proc)
   def tool_runtime

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/serializer.rb

@@ -27,6 +27,7 @@ module Riffer::Agent::Serializer
       model_options: config.model_options,
       max_steps: encode_max_steps(config.max_steps),
       structured_output: config.structured_output&.to_json_schema(strict: false),
+      structured_output_strategy: config.structured_output_strategy,
       tools: agent.tools.map { |tool_class| tool_descriptor(tool_class) },
     }
   end
@@ -76,6 +77,7 @@ module Riffer::Agent::Serializer
       instructions: hash[:instructions],
       model_options: hash[:model_options] || {},
       structured_output: decode_structured_output(hash[:structured_output]),
+      structured_output_strategy: (hash[:structured_output_strategy] || :native).to_sym,
       max_steps: decode_max_steps(hash),
       tools_config: tools,
     } #: Hash[Symbol, untyped]

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

@@ -1,13 +1,23 @@
 # frozen_string_literal: true
 # rbs_inline: enabled
 
+require "json"
+
 class Riffer::Agent::StructuredOutput
   attr_reader :params #: Riffer::Params # @dynamic params
+  attr_reader :strategy #: Symbol # @dynamic strategy
 
   #--
-  #: (Riffer::Params) -> void
-  def initialize(params)
+  #: (Riffer::Params, ?strategy: Symbol) -> void
+  def initialize(params, strategy: :native)
     @params = params
+    @strategy = strategy
+  end
+
+  #--
+  #: () -> bool
+  def prompted?
+    @strategy == :prompted
   end
 
   #--
@@ -16,14 +26,23 @@ class Riffer::Agent::StructuredOutput
     @params.to_json_schema(strict: strict)
   end
 
+  # Worded for the final answer only, so the model can still call tools first.
+  #--
+  #: () -> String
+  def prompt_instructions
+    "When you give your final answer, respond with only a JSON object that conforms to " \
+      "the following JSON Schema, with no other text before or after it:\n\n" \
+      "#{JSON.generate(json_schema)}"
+  end
+
   #--
   #: (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/agent.rb

@@ -53,13 +53,14 @@ class Riffer::Agent
   end
 
   #--
-  #: (?Riffer::Params?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
-  def self.structured_output(params = nil, &block)
+  #: (?Riffer::Params?, ?strategy: Symbol?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
+  def self.structured_output(params = nil, strategy: nil, &block)
     if block
       params = Riffer::Params.new
       params.instance_eval(&block)
     end
     config.structured_output = params if params
+    config.structured_output_strategy = strategy if strategy
     config.structured_output
   end
 
@@ -328,7 +329,7 @@ class Riffer::Agent
   #: () -> Riffer::Agent::StructuredOutput?
   def resolve_structured_output
     params = @config.structured_output
-    params ? Riffer::Agent::StructuredOutput.new(params) : nil
+    params ? Riffer::Agent::StructuredOutput.new(params, strategy: @config.structured_output_strategy) : nil
   end
 
   #--

data/lib/riffer/providers/base.rb

@@ -38,8 +38,8 @@ class Riffer::Providers::Base
     messages = normalize_messages(prompt: prompt, system: system, messages: messages, files: files)
     validate_normalized_messages!(messages)
     Riffer::Files::Resolver.new(provider: self).resolve!(messages)
-    messages = merge_consecutive_messages(messages)
-    params = build_request_params(messages, model, options)
+    messages = merge_consecutive_messages(with_structured_output_prompt(messages, options[:structured_output]))
+    params = build_request_params(messages, model, request_options(options))
 
     in_chat_span(model, messages, options) do |span|
       response = execute_generate(params)
@@ -76,8 +76,8 @@ class Riffer::Providers::Base
     messages = normalize_messages(prompt: prompt, system: system, messages: messages, files: files)
     validate_normalized_messages!(messages)
     Riffer::Files::Resolver.new(provider: self).resolve!(messages)
-    messages = merge_consecutive_messages(messages)
-    params = build_request_params(messages, model, options)
+    messages = merge_consecutive_messages(with_structured_output_prompt(messages, options[:structured_output]))
+    params = build_request_params(messages, model, request_options(options))
 
     # The enumerator body runs in its own fiber, where the fiber-local OTEL
     # context is empty — capture here so the chat span parents to the caller's
@@ -371,6 +371,26 @@ class Riffer::Providers::Base
     JSON.parse(arguments)
   end
 
+  #--
+  #: (Array[Riffer::Messages::Base], Riffer::Agent::StructuredOutput?) -> Array[Riffer::Messages::Base]
+  def with_structured_output_prompt(messages, structured_output)
+    return messages unless structured_output&.prompted?
+
+    # After the leading system messages, so merge_consecutive_messages folds it into the system prompt.
+    leading_system = messages.take_while { |m| m.is_a?(Riffer::Messages::System) }
+    [
+      *leading_system,
+      Riffer::Messages::System.new(structured_output.prompt_instructions),
+      *messages.drop(leading_system.length),
+    ]
+  end
+
+  #--
+  #: (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
+  def request_options(options)
+    options[:structured_output]&.prompted? ? options.except(:structured_output) : options
+  end
+
   #--
   #: (Array[Riffer::Messages::Base]) -> Array[Riffer::Messages::Base]
   def merge_consecutive_messages(messages)

data/lib/riffer/version.rb

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

data/sig/generated/riffer/agent/config.rbs

@@ -3,6 +3,8 @@
 class Riffer::Agent::Config
   DEFAULT_MAX_STEPS: Integer
 
+  STRUCTURED_OUTPUT_STRATEGIES: Array[Symbol]
+
   @tool_runtime: (singleton(Riffer::Tools::Runtime) | Riffer::Tools::Runtime | Proc)?
 
   attr_reader identifier: String?
@@ -15,6 +17,8 @@ class Riffer::Agent::Config
 
   attr_reader structured_output: Riffer::Params?
 
+  attr_reader structured_output_strategy: Symbol
+
   attr_accessor max_steps: Numeric?
 
   attr_accessor tools_config: (Array[singleton(Riffer::Tool)] | Proc)?
@@ -32,6 +36,7 @@ class Riffer::Agent::Config
   #     ?instructions: (String | Proc)?,
   #     ?model_options: Hash[Symbol, untyped],
   #     ?structured_output: Riffer::Params?,
+  #     ?structured_output_strategy: Symbol,
   #     ?max_steps: Numeric?,
   #     ?tools_config: (Array[singleton(Riffer::Tool)] | Proc)?,
   #     ?mcp_configs: Array[Hash[Symbol, untyped]],
@@ -39,7 +44,7 @@ class Riffer::Agent::Config
   #     ?skills_config: Riffer::Skills::Config?,
   #     ?guardrails: Hash[Symbol, Array[Hash[Symbol, untyped]]]
   #   ) -> void
-  def initialize: (?identifier: String?, ?model: (String | Proc)?, ?instructions: (String | Proc)?, ?model_options: Hash[Symbol, untyped], ?structured_output: Riffer::Params?, ?max_steps: Numeric?, ?tools_config: (Array[singleton(Riffer::Tool)] | Proc)?, ?mcp_configs: Array[Hash[Symbol, untyped]], ?tool_runtime: (singleton(Riffer::Tools::Runtime) | Riffer::Tools::Runtime | Proc)?, ?skills_config: Riffer::Skills::Config?, ?guardrails: Hash[Symbol, Array[Hash[Symbol, untyped]]]) -> void
+  def initialize: (?identifier: String?, ?model: (String | Proc)?, ?instructions: (String | Proc)?, ?model_options: Hash[Symbol, untyped], ?structured_output: Riffer::Params?, ?structured_output_strategy: Symbol, ?max_steps: Numeric?, ?tools_config: (Array[singleton(Riffer::Tool)] | Proc)?, ?mcp_configs: Array[Hash[Symbol, untyped]], ?tool_runtime: (singleton(Riffer::Tools::Runtime) | Riffer::Tools::Runtime | Proc)?, ?skills_config: Riffer::Skills::Config?, ?guardrails: Hash[Symbol, Array[Hash[Symbol, untyped]]]) -> void
 
   # --
   # : (untyped) -> String?
@@ -49,6 +54,10 @@ class Riffer::Agent::Config
   # : (Riffer::Params?) -> Riffer::Params?
   def structured_output=: (Riffer::Params?) -> Riffer::Params?
 
+  # --
+  # : (Symbol) -> Symbol
+  def structured_output_strategy=: (Symbol) -> Symbol
+
   # --
   # : () -> (singleton(Riffer::Tools::Runtime) | Riffer::Tools::Runtime | Proc)
   def tool_runtime: () -> (singleton(Riffer::Tools::Runtime) | Riffer::Tools::Runtime | Proc)

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

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

@@ -3,14 +3,25 @@
 class Riffer::Agent::StructuredOutput
   attr_reader params: Riffer::Params
 
+  attr_reader strategy: Symbol
+
+  # --
+  # : (Riffer::Params, ?strategy: Symbol) -> void
+  def initialize: (Riffer::Params, ?strategy: Symbol) -> void
+
   # --
-  # : (Riffer::Params) -> void
-  def initialize: (Riffer::Params) -> void
+  # : () -> bool
+  def prompted?: () -> bool
 
   # --
   # : (?strict: bool) -> Hash[Symbol, untyped]
   def json_schema: (?strict: bool) -> Hash[Symbol, untyped]
 
+  # Worded for the final answer only, so the model can still call tools first.
+  # --
+  # : () -> String
+  def prompt_instructions: () -> String
+
   # --
   # : (String) -> Riffer::Agent::StructuredOutput::Result
   def parse_and_validate: (String) -> Riffer::Agent::StructuredOutput::Result

data/sig/generated/riffer/agent.rbs

@@ -32,8 +32,8 @@ class Riffer::Agent
   def self.model_options: (?Hash[Symbol, untyped]?) -> Hash[Symbol, untyped]
 
   # --
-  # : (?Riffer::Params?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
-  def self.structured_output: (?Riffer::Params?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
+  # : (?Riffer::Params?, ?strategy: Symbol?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
+  def self.structured_output: (?Riffer::Params?, ?strategy: Symbol?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
 
   # --
   # : (*Numeric?) -> Numeric?

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

@@ -146,6 +146,14 @@ class Riffer::Providers::Base
   # : (String) -> Hash[String, untyped]
   def parse_tool_arguments: (String) -> Hash[String, untyped]
 
+  # --
+  # : (Array[Riffer::Messages::Base], Riffer::Agent::StructuredOutput?) -> Array[Riffer::Messages::Base]
+  def with_structured_output_prompt: (Array[Riffer::Messages::Base], Riffer::Agent::StructuredOutput?) -> Array[Riffer::Messages::Base]
+
+  # --
+  # : (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
+  def request_options: (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
+
   # --
   # : (Array[Riffer::Messages::Base]) -> Array[Riffer::Messages::Base]
   def merge_consecutive_messages: (Array[Riffer::Messages::Base]) -> Array[Riffer::Messages::Base]

metadata

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