Class: RailsAiBridge::Tools::Query::PayloadFormatter
- Inherits:
-
Object
- Object
- RailsAiBridge::Tools::Query::PayloadFormatter
- Defined in:
- lib/rails_ai_bridge/tools/query/payload_formatter.rb
Overview
Builds the compact JSON payload for a query result, honoring the detail level and the hard row cap.
Constant Summary collapse
- LIMITS_BY_DETAIL =
Row limits by detail level (summary never returns rows).
{ 'summary' => Query::MAX_ROWS, 'standard' => 20, 'full' => Query::MAX_ROWS }.freeze
- DEFAULT_ROWS =
Fallback row limit for an unrecognized detail level.
20
Class Method Summary collapse
-
.row_limit(row_limit, detail) ⇒ Integer
Effective row limit: client request clamped to 1..MAX_ROWS, or the detail-level default when no (or an invalid) limit was given.
Instance Method Summary collapse
-
#format ⇒ Hash
Builds the payload: columns, row count, truncation flag, and rows (rows omitted for summary detail).
-
#initialize(result, row_limit:, detail:) ⇒ PayloadFormatter
constructor
A new instance of PayloadFormatter.
Constructor Details
#initialize(result, row_limit:, detail:) ⇒ PayloadFormatter
Returns a new instance of PayloadFormatter.
18 19 20 21 22 23 |
# File 'lib/rails_ai_bridge/tools/query/payload_formatter.rb', line 18 def initialize(result, row_limit:, detail:) @columns = result.columns @rows = Query.redact_columns(@columns, result.to_a) @limit = self.class.row_limit(row_limit, detail) @detail = detail end |
Class Method Details
.row_limit(row_limit, detail) ⇒ Integer
Effective row limit: client request clamped to 1..MAX_ROWS, or the detail-level default when no (or an invalid) limit was given.
43 44 45 46 47 |
# File 'lib/rails_ai_bridge/tools/query/payload_formatter.rb', line 43 def self.row_limit(row_limit, detail) requested = row_limit.to_i requested = LIMITS_BY_DETAIL.fetch(detail, DEFAULT_ROWS) if requested < 1 requested.clamp(1, Query::MAX_ROWS) end |
Instance Method Details
#format ⇒ Hash
Builds the payload: columns, row count, truncation flag, and rows (rows omitted for summary detail).
29 30 31 32 33 34 35 |
# File 'lib/rails_ai_bridge/tools/query/payload_formatter.rb', line 29 def format total = @rows.size payload = { columns: @columns, row_count: [total, @limit].min, truncated: total > @limit } return payload if @detail == 'summary' payload.merge(rows: @rows.first(@limit)) end |