import { type DeliveryLog, type DeliveryOutcome, type DeliveryRecord } from "./delivery-log.js"; import type { RunnerName } from "./config.js"; import { type JobRecord, type JobStatus, type JobStore } from "./jobs.js"; import { type Trigger } from "./payload.js"; import { type JobOutcome } from "./response.js"; import { type FailureKind } from "./runners/failure.js"; export interface Percentiles { count: number; p50: number; p95: number; avg: number; max: number; } export interface Tokens { input: number; output: number; cached_input: number; } export interface JobStats { total: number; /** Jobs that ended (every status but queued and running). */ finished: number; queued: number; running: number; by_status: Record; by_outcome: Record; by_trigger: Record; by_runner: Record; by_failure_kind: Record; /** succeeded / finished, or null without finished jobs. */ success_rate: number | null; /** (completed + nothing_to_do) / finished jobs with a reported outcome (unknown excluded), or null. */ completion_rate: number | null; duration_ms: Percentiles | null; /** From creation to start. */ queue_wait_ms: Percentiles | null; cost_usd: number; tokens: Tokens; /** Jobs waiting for a person right now (an open question, or outcome needs_human nobody answered). */ waiting_for_human: number; } export interface DeliveryStats { total: number; by_outcome: Record; by_http_status: Record; /** accepted / total, or null without deliveries. */ accepted_rate: number | null; last_received_at: string | null; } export interface SkillStats { jobs: number; by_status: Record; by_outcome: Record; success_rate: number | null; cost_usd: number; tokens: Tokens; duration_ms: Percentiles | null; deliveries: number; last_job: { id: string; status: JobStatus; outcome: JobOutcome | null; created_at: string; } | null; } export interface StatsReport { window: { since: string | null; until: string | null; skill: string | null; }; jobs: JobStats; deliveries: DeliveryStats; skills: Record; generated_at: string; } /** `24h`, `7d`, `30m`, `2w` (ago) or an ISO-8601 instant, as an ISO string; undefined for anything else. */ export declare function parseSince(value: string | undefined, now?: number): string | undefined; export declare function percentiles(values: number[]): Percentiles | null; /** Claude reports `input_tokens`, `output_tokens`, `cache_read_input_tokens`; Codex `input_tokens`, `cached_input_tokens`, `output_tokens`. */ export declare function tokensOf(usage: unknown): Tokens; export interface ComputeStatsInput { jobs: JobRecord[]; deliveries: DeliveryRecord[]; since?: string; until?: string; skill?: string; now?: Date; } export declare function computeStats(input: ComputeStatsInput): StatsReport; export interface StatsQuery { /** ISO-8601 (use `parseSince` for `24h`-style values first). */ since?: string; until?: string; skill?: string; /** At most this many jobs and deliveries are read (default 5000, newest first). */ limit?: number; } /** The report over what is on disk: the job directories and the delivery log, newest first, capped by `limit`. */ export declare function collectStats(store: JobStore, deliveryLog: DeliveryLog | undefined, query?: StatsQuery): StatsReport; export declare function formatStats(report: StatsReport): string;