import type { StatsArgs } from "../args.js";
/**
 * Generate activity statistics over a configurable lookback window and print them to stdout as either JSON or formatted tables.
 *
 * When the `json` flag is set, writes a JSON object with keys `weeklyVolume`, `longestSessions`, and `averageSessionDuration`.
 * Otherwise prints three human-readable sections: weekly volume, longest recent sessions, and average session duration.
 *
 * @param args - Command options. Recognized fields:
 *   - `weeks`: number of weeks to include for weekly and average calculations (falls back to `DEFAULT_WEEKS` if not a positive integer).
 *   - `longestWeeks`: number of weeks to include when computing longest single sessions (falls back to `DEFAULT_LONGEST_WEEKS` if not a positive integer).
 *   - `json`: when true, output is emitted as a JSON object instead of formatted tables.
 */
export declare function runStats(args: StatsArgs): Promise<void>;