Class: RailsAiBridge::Tools::Query::PayloadFormatter

Inherits:
Object
  • Object
show all
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

Instance Method Summary collapse

Constructor Details

#initialize(result, row_limit:, detail:) ⇒ PayloadFormatter

Returns a new instance of PayloadFormatter.

Parameters:

  • result (ActiveRecord::Result) —

    executed statement result

  • row_limit (Integer, nil) —

    requested row limit

  • detail (String) —

    summary, standard, or full



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.

Parameters:

  • row_limit (Integer, nil) —

    requested row limit

  • detail (String) —

    detail level

Returns:

  • (Integer)


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).

Returns:

  • (Hash) —

    compact payload



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