Function handler

packages/tools/src/definitions/render-chart.ts:122–157

(params: Record<string, unknown>, context: ToolExecutionContext)

}

async function handler(params: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult> {
  if (!context.dataProvider) throw new Error('render_chart requires a data provider')

  const hasSql = typeof params.sql === 'string' && params.sql.trim().length > 0
  const hasRows = Array.isArray(params.rows)
  if (!hasSql && !hasRows) throw new Error('render_chart requires either sql or rows')

  const maxRows = normalizeMaxRows(params.maxRows)
  let rows: Record<string, unknown>[]
  let truncated: boolean

  if (hasRows) {
    const normalized = normalizeRows(params.rows, maxRows)
    rows = normalized.rows
    truncated = normalized.truncated
  } else {
    const sql = normalizeSql(params.sql, maxRows)
    const sqlParams = normalizeParams(params.params)
    const fetchedRows = await context.dataProvider.executeParameterizedSql<Record<string, unknown>>(sql, sqlParams)
    truncated = fetchedRows.length > maxRows
    rows = truncated ? fetchedRows.slice(0, maxRows) : fetchedRows
  }

  const chart = buildChartPayload(rows, params.chartSpec, { truncated })

  return {
    content: summarizeChartForModel(chart.spec.type, chart.spec.title, rows, truncated, context.locale),
    data: {
      rowCount: rows.length,
      truncated,
      chartType: chart.spec.type,
      title: chart.spec.title,
    },
    chart,
  }
}

export const renderChartTool: ToolDefinition = {
  name: 'render_chart',