/** * Pre-constructed tools for descriptive statistics, correlation, quantiles, and numeric summaries. * * @module @nhtio/adk/batteries/tools/statistics * * @remarks * Pre-constructed bundled tools for the `statistics` category. Import individually, the whole * category, or import every tool via `@nhtio/adk/batteries`. */ import { Tool, SpooledJsonArtifact } from "../../../common"; /** * Compute descriptive statistics for a JSON array of numbers. * * @remarks * Returns count, sum, min/max/range, mean, median, mode, variance, standard deviation, * quartiles (Q1/Q2/Q3), IQR, and key percentiles (P10/P90/P95/P99) as a pretty-printed JSON * object. Non-numeric and non-finite entries are silently filtered. */ export declare const statsDescribeTool: Tool>; /** * Compute the Pearson correlation coefficient between two numeric arrays. * * @remarks * Returns `r`, `r²` (as a percentage of explained variance), and a plain-English interpretation * of strength and direction. Arrays must be the same length and contain at least two points. */ export declare const statsCorrelateTool: Tool; /** * Transform a numeric array — normalise, smooth, rank, or detect outliers. * * @remarks * Supported operations: `normalize_min_max`, `normalize_z_score`, `normalize_percent_of_sum`, * `running_total`, `rolling_avg`, `pct_change`, `rank`, `outliers_iqr`, `outliers_zscore`. Most * operations return a JSON array of transformed values; outlier operations return a * human-readable report. */ export declare const statsTransformTool: Tool; /** * Bin a numeric array into equal-width histogram buckets. * * @remarks * Output is a text histogram showing each bin's range, count, percentage of total, and a bar * chart. The last bin is inclusive on both ends; preceding bins are half-open. `bins` is clamped * to `[2, 100]`. */ export declare const statsHistogramTool: Tool;