class Riffer::StructuredOutput

Riffer::StructuredOutput provides parse/validate for structured JSON responses from LLM providers.

params = Riffer::Params.new
params.required(:sentiment, String)
so = Riffer::StructuredOutput.new(params)
result = so.parse_and_validate('{"sentiment":"positive","score":0.9}')
result.object  #=> {sentiment: "positive", score: 0.9}

Attributes

params [R]

Public Class Methods

new (params)

Source

# File lib/riffer/structured_output.rb, line 20
def initialize(params)
  @params = params
end

Public Instance Methods

json_schema (strict: false)

Source

# File lib/riffer/structured_output.rb, line 28
def json_schema(strict: false)
  @params.to_json_schema(strict: strict)
end

Returns the JSON Schema for this structured output.

parse_and_validate (json_string)

Source

# File lib/riffer/structured_output.rb, line 38
def parse_and_validate(json_string)
  parsed = JSON.parse(json_string, symbolize_names: true)
  validated = @params.validate(parsed)
  Result.new(object: validated)
rescue JSON::ParserError => e
  Result.new(error: "JSON parse error: #{e.message}")
rescue Riffer::ValidationError => e
  Result.new(error: "Validation error: #{e.message}")
end

Parses a JSON string and validates it against the schema.

Returns a Result with the validated object on success, or an error message on failure.