@iowarp/clio-coder 0.3.0 → 0.3.1

package/src/domains/observability/metrics.ts

@@ -0,0 +1,37 @@
+/**
+ * Thin reducer over TelemetrySnapshot. Produces a view the TUI + /cost overlay
+ * consume. Stays pure so tests can hand-roll snapshots and assert the shape.
+ */
+
+import type { TelemetrySnapshot } from "./telemetry.js";
+
+export interface MetricsView {
+	dispatchesCompleted: number;
+	dispatchesFailed: number;
+	safetyClassifications: number;
+	totalTokens: number;
+	histograms: Record<string, { count: number; avg: number; p50: number; p95: number }>;
+}
+
+function percentile(sorted: number[], p: number): number {
+	if (sorted.length === 0) return 0;
+	const idx = Math.min(sorted.length - 1, Math.floor((p / 100) * sorted.length));
+	return sorted[idx] ?? 0;
+}
+
+export function aggregateMetrics(snap: TelemetrySnapshot): MetricsView {
+	const histograms: MetricsView["histograms"] = {};
+	for (const [name, values] of Object.entries(snap.histograms)) {
+		const sorted = [...values].sort((a, b) => a - b);
+		const count = sorted.length;
+		const avg = count > 0 ? sorted.reduce((s, v) => s + v, 0) / count : 0;
+		histograms[name] = { count, avg, p50: percentile(sorted, 50), p95: percentile(sorted, 95) };
+	}
+	return {
+		dispatchesCompleted: snap.counters["dispatch.completed"] ?? 0,
+		dispatchesFailed: snap.counters["dispatch.failed"] ?? 0,
+		safetyClassifications: snap.counters["safety.classified"] ?? 0,
+		totalTokens: snap.counters["tokens.total"] ?? 0,
+		histograms,
+	};
+}

package/src/domains/observability/projection.ts

@@ -0,0 +1,477 @@
+/**
+ * Reactive observability projection. Folds the dispatch, provider, and
+ * diagnostic bus channels plus the session cost/telemetry trackers into a
+ * single bounded {@link ObservabilitySnapshot} that product surfaces (footer,
+ * overlays, CLI status) can consume through one seam.
+ *
+ * Design constraints for this slice:
+ * - Bus listeners stay cheap. The bus is synchronous, so each handler only
+ *   mutates in-memory state and marks the projection changed; the actual
+ *   snapshot build and listener fan-out happen on a short debounce so a burst
+ *   of DispatchProgress events coalesces into one notification.
+ * - The snapshot never stores raw worker output, tool arguments, or transcript
+ *   text. Run summaries carry compact lifecycle fields; notices carry a short
+ *   rendered message and a reference id, nothing more.
+ * - Run summaries and notices are bounded rings so a long-lived session cannot
+ *   grow the projection without limit.
+ */
+
+import { BusChannels } from "../../core/bus-events.js";
+import type { SafeEventBus } from "../../core/event-bus.js";
+import type { TargetStatus } from "../providers/contract.js";
+import type { AccountabilitySummary } from "./accountability.js";
+import type {
+	ObservabilityNotice,
+	ObservabilityRunEvidence,
+	ObservabilityRunSummary,
+	ObservabilitySnapshot,
+	TokenThroughputSnapshot,
+} from "./contract.js";
+import type { CostAggregate, UsageBreakdown } from "./cost.js";
+import type { MetricsView } from "./metrics.js";
+
+/** Recent run summaries retained. Mirrors the dispatch board's window. */
+export const MAX_PROJECTION_RUNS = 50;
+/** Recent notices retained across all kinds. */
+export const MAX_PROJECTION_NOTICES = 100;
+/** Debounce for coalescing listener notifications, in milliseconds. */
+export const PROJECTION_FLUSH_DEBOUNCE_MS = 16;
+
+/**
+ * Read model the projection folds session-local state from. The extension owns
+ * the cost/telemetry trackers and the latest-throughput register; the
+ * projection reads them at snapshot-build time so ordering with the extension's
+ * own bus handlers never matters (both run synchronously before the debounced
+ * build).
+ */
+export interface ProjectionReadModel {
+	metrics(): MetricsView;
+	sessionCost(): number;
+	sessionCostSummary(): CostAggregate;
+	sessionTokens(): UsageBreakdown;
+	latestThroughput(): TokenThroughputSnapshot | null;
+	readAccountability(): AccountabilitySummary;
+}
+
+export interface ObservabilityProjection {
+	snapshot(): ObservabilitySnapshot;
+	subscribe(listener: (snapshot: ObservabilitySnapshot) => void): () => void;
+	/** Recompute after a direct session mutation (recordTokens/resetSession/safety counter). */
+	refresh(): void;
+	/** A forensic evidence build for `runId` has started. */
+	evidenceBuildStarted(runId: string): void;
+	/** The evidence bundle for `runId` finalized and its index row landed. */
+	evidenceBuildSucceeded(runId: string, evidence: ObservabilityRunEvidence): void;
+	/** The evidence build for `runId` failed; surface a bounded notice. */
+	evidenceBuildFailed(runId: string, message: string): void;
+	/** Detach bus listeners and cancel any pending flush. */
+	stop(): void;
+}
+
+// --- small runtime coercions. Bus payloads that crossed a process boundary
+// (DispatchProgress.event) are not validated, so every read is defensive. ---
+
+function str(value: unknown, fallback: string): string {
+	return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+
+function num(value: unknown, fallback: number): number {
+	return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+
+function asRunId(value: unknown): string | null {
+	return typeof value === "string" && value.length > 0 ? value : null;
+}
+
+function isTerminal(status: ObservabilityRunSummary["status"]): boolean {
+	return status === "completed" || status === "failed" || status === "aborted" || status === "dead";
+}
+
+function resolveHeartbeat(status: unknown): ObservabilityRunSummary["status"] | null {
+	if (status === "alive") return "running";
+	if (status === "stale") return "stale";
+	if (status === "dead") return "dead";
+	return null;
+}
+
+/** Map a DispatchFailed outcome/reason to a summary status, mirroring the board. */
+function resolveFailedStatus(reason: unknown): ObservabilityRunSummary["status"] {
+	if (reason === "dead" || reason === "stalled") return "dead";
+	if (reason === "interrupted" || reason === "canceled") return "aborted";
+	return "failed";
+}
+
+function normalizeLevel(value: unknown): ObservabilityNotice["level"] {
+	return value === "error" || value === "warning" || value === "info" ? value : "info";
+}
+
+/** Build a notice ref from candidate parts, dropping anything non-string/empty. */
+function makeRef(parts: Record<string, unknown>): ObservabilityNotice["ref"] | undefined {
+	const ref: Record<string, string> = {};
+	for (const [key, value] of Object.entries(parts)) {
+		if (typeof value === "string" && value.length > 0) ref[key] = value;
+	}
+	return Object.keys(ref).length > 0 ? (ref as ObservabilityNotice["ref"]) : undefined;
+}
+
+/** Shared identity fields carried on every dispatch lifecycle event. */
+interface RunIdentityLike {
+	agentId?: unknown;
+	targetId?: unknown;
+	wireModelId?: unknown;
+	runtimeId?: unknown;
+	runtimeKind?: unknown;
+}
+
+export function createObservabilityProjection(bus: SafeEventBus, deps: ProjectionReadModel): ObservabilityProjection {
+	const runs = new Map<string, ObservabilityRunSummary>();
+	const notices: ObservabilityNotice[] = [];
+	const providerHealth = new Map<string, TargetStatus>();
+	const pendingEvidence = new Set<string>();
+	let accountability: AccountabilitySummary = deps.readAccountability();
+	let revision = 0;
+	let noticeSeq = 0;
+
+	const listeners = new Set<(snapshot: ObservabilitySnapshot) => void>();
+	let flushTimer: ReturnType<typeof setTimeout> | null = null;
+
+	function buildSnapshot(): ObservabilitySnapshot {
+		const providerHealthRecord: Record<string, TargetStatus> = {};
+		for (const [id, status] of providerHealth) providerHealthRecord[id] = status;
+		return {
+			revision,
+			generatedAt: Date.now(),
+			session: {
+				costUsd: deps.sessionCost(),
+				cost: deps.sessionCostSummary(),
+				tokens: deps.sessionTokens(),
+				latestThroughput: deps.latestThroughput(),
+			},
+			metrics: deps.metrics(),
+			accountability,
+			// Newest-first: Map preserves first-seen (enqueue) order, so reversing
+			// surfaces the most recently started runs at the head of the list.
+			runs: [...runs.values()].reverse(),
+			providerHealth: providerHealthRecord,
+			notices: [...notices],
+			pendingEvidenceBuildRunIds: [...pendingEvidence],
+		};
+	}
+
+	function flush(): void {
+		flushTimer = null;
+		if (listeners.size === 0) return;
+		const snapshot = buildSnapshot();
+		for (const listener of [...listeners]) {
+			try {
+				listener(snapshot);
+			} catch (error) {
+				const message = error instanceof Error ? (error.stack ?? error.message) : String(error);
+				console.error(`[clio:observability] projection listener crashed: ${message}`);
+			}
+		}
+	}
+
+	function scheduleFlush(): void {
+		if (flushTimer !== null) return;
+		flushTimer = setTimeout(flush, PROJECTION_FLUSH_DEBOUNCE_MS);
+		// A pending flush must never keep a one-shot `clio-coder run` process alive.
+		flushTimer.unref?.();
+	}
+
+	function markChanged(): void {
+		revision += 1;
+		scheduleFlush();
+	}
+
+	function putRun(runId: string, summary: ObservabilityRunSummary): void {
+		runs.set(runId, summary);
+		while (runs.size > MAX_PROJECTION_RUNS) {
+			const oldest = runs.keys().next().value;
+			if (oldest === undefined) break;
+			runs.delete(oldest);
+		}
+	}
+
+	function emptyRun(runId: string, now: number): ObservabilityRunSummary {
+		return {
+			runId,
+			agentId: "-",
+			status: "enqueued",
+			startedAtMs: now,
+			updatedAtMs: now,
+			finishedAtMs: null,
+			durationMs: null,
+			tokens: { input: 0, output: 0, reasoning: 0, total: 0 },
+			costUsd: 0,
+			costProvenance: "unknown",
+		};
+	}
+
+	function applyIdentity(summary: ObservabilityRunSummary, id: RunIdentityLike): void {
+		if (typeof id.agentId === "string" && id.agentId.length > 0) summary.agentId = id.agentId;
+		if (typeof id.targetId === "string" && id.targetId.length > 0) summary.targetId = id.targetId;
+		if (typeof id.wireModelId === "string" && id.wireModelId.length > 0) summary.modelId = id.wireModelId;
+		if (typeof id.runtimeId === "string" && id.runtimeId.length > 0) summary.runtimeId = id.runtimeId;
+		if (typeof id.runtimeKind === "string" && id.runtimeKind.length > 0) summary.runtimeKind = id.runtimeKind;
+	}
+
+	function applyTerminalTokens(summary: ObservabilityRunSummary, payload: Record<string, unknown>): void {
+		if (typeof payload.tokenCount === "number") summary.tokens.total = payload.tokenCount;
+		if (typeof payload.inputTokenCount === "number") {
+			summary.tokens.input = payload.inputTokenCount + num(payload.cacheReadTokenCount, 0);
+		}
+		if (typeof payload.outputTokenCount === "number") summary.tokens.output = payload.outputTokenCount;
+		if (typeof payload.reasoningTokenCount === "number") summary.tokens.reasoning = payload.reasoningTokenCount;
+		if (typeof payload.costUsd === "number") summary.costUsd = payload.costUsd;
+		if (
+			payload.costProvenance === "known" ||
+			payload.costProvenance === "known_free" ||
+			payload.costProvenance === "estimated" ||
+			payload.costProvenance === "unknown"
+		) {
+			summary.costProvenance = payload.costProvenance;
+		}
+	}
+
+	function pushNotice(
+		kind: ObservabilityNotice["kind"],
+		level: ObservabilityNotice["level"],
+		message: string,
+		ref?: ObservabilityNotice["ref"],
+	): void {
+		const notice: ObservabilityNotice = {
+			id: `n${noticeSeq++}`,
+			at: Date.now(),
+			kind,
+			level,
+			message,
+			...(ref ? { ref } : {}),
+		};
+		notices.push(notice);
+		if (notices.length > MAX_PROJECTION_NOTICES) {
+			notices.splice(0, notices.length - MAX_PROJECTION_NOTICES);
+		}
+		markChanged();
+	}
+
+	const unsubscribes: Array<() => void> = [
+		bus.on(BusChannels.DispatchEnqueued, (raw: unknown) => {
+			const payload = (raw ?? {}) as Record<string, unknown>;
+			const runId = asRunId(payload.runId);
+			if (!runId) return;
+			const now = Date.now();
+			const summary = runs.get(runId) ?? emptyRun(runId, now);
+			applyIdentity(summary, payload);
+			summary.status = "enqueued";
+			summary.updatedAtMs = now;
+			putRun(runId, summary);
+			markChanged();
+		}),
+		bus.on(BusChannels.DispatchStarted, (raw: unknown) => {
+			const payload = (raw ?? {}) as Record<string, unknown>;
+			const runId = asRunId(payload.runId);
+			if (!runId) return;
+			const now = Date.now();
+			const summary = runs.get(runId) ?? emptyRun(runId, now);
+			applyIdentity(summary, payload);
+			summary.status = "running";
+			summary.startedAtMs = now;
+			summary.updatedAtMs = now;
+			summary.finishedAtMs = null;
+			summary.durationMs = null;
+			putRun(runId, summary);
+			markChanged();
+		}),
+		bus.on(BusChannels.DispatchProgress, (raw: unknown) => {
+			const payload = (raw ?? {}) as Record<string, unknown>;
+			const runId = asRunId(payload.runId);
+			if (!runId) return;
+			// Only track progress for a run we already know; a bare progress relay
+			// carries no identity to seed a summary from.
+			const summary = runs.get(runId);
+			if (!summary) return;
+			const now = Date.now();
+			summary.updatedAtMs = now;
+			const event = (payload.event ?? {}) as Record<string, unknown>;
+			const type = typeof event.type === "string" ? event.type : "";
+			if (type === "heartbeat_status") {
+				const status = resolveHeartbeat(event.status);
+				if (status && !isTerminal(summary.status)) summary.status = status;
+				markChanged();
+				return;
+			}
+			if (type === "message_end" && !isTerminal(summary.status)) {
+				const message = (event.message ?? {}) as { role?: unknown; usage?: Record<string, unknown> };
+				if (message.role === "assistant" && message.usage) {
+					const input = num(message.usage.input, 0) + num(message.usage.cacheRead, 0);
+					const output = num(message.usage.output, 0);
+					summary.tokens.input += input;
+					summary.tokens.output += output;
+					summary.tokens.total += input + output + num(message.usage.cacheWrite, 0);
+				}
+			}
+			markChanged();
+		}),
+		bus.on(BusChannels.DispatchCompleted, (raw: unknown) => {
+			const payload = (raw ?? {}) as Record<string, unknown>;
+			const runId = asRunId(payload.runId);
+			if (!runId) return;
+			const now = Date.now();
+			const summary = runs.get(runId) ?? emptyRun(runId, now);
+			applyIdentity(summary, payload);
+			summary.status = "completed";
+			summary.updatedAtMs = now;
+			summary.finishedAtMs = now;
+			summary.durationMs = num(payload.durationMs, Math.max(0, now - summary.startedAtMs));
+			applyTerminalTokens(summary, payload);
+			summary.outcome = str(payload.outcome, "succeeded");
+			summary.outcomeDetail = typeof payload.outcomeDetail === "string" ? payload.outcomeDetail : null;
+			putRun(runId, summary);
+			markChanged();
+		}),
+		bus.on(BusChannels.DispatchFailed, (raw: unknown) => {
+			const payload = (raw ?? {}) as Record<string, unknown>;
+			const runId = asRunId(payload.runId);
+			if (!runId) return;
+			const now = Date.now();
+			const summary = runs.get(runId) ?? emptyRun(runId, now);
+			applyIdentity(summary, payload);
+			summary.status = resolveFailedStatus(payload.reason);
+			summary.updatedAtMs = now;
+			summary.finishedAtMs = now;
+			summary.durationMs = num(payload.durationMs, Math.max(0, now - summary.startedAtMs));
+			applyTerminalTokens(summary, payload);
+			summary.outcome = str(payload.outcome, str(payload.reason, "failed"));
+			summary.outcomeDetail = typeof payload.outcomeDetail === "string" ? payload.outcomeDetail : null;
+			putRun(runId, summary);
+			markChanged();
+		}),
+		bus.on(BusChannels.ProviderHealth, (raw: unknown) => {
+			const payload = (raw ?? {}) as Record<string, unknown>;
+			if (typeof payload.id !== "string" || payload.id.length === 0) return;
+			// status is the full TargetStatus record (an object); store it as-is.
+			if (payload.status === null || typeof payload.status !== "object") return;
+			providerHealth.set(payload.id, payload.status as TargetStatus);
+			markChanged();
+		}),
+		bus.on(BusChannels.RuntimeNotice, (raw: unknown) => {
+			const payload = (raw ?? {}) as Record<string, unknown>;
+			pushNotice(
+				"runtime",
+				normalizeLevel(payload.level),
+				str(payload.message, "runtime notice"),
+				makeRef({ targetId: payload.targetId, modelId: payload.model }),
+			);
+		}),
+		bus.on(BusChannels.MiddlewareHookFailed, (raw: unknown) => {
+			const payload = (raw ?? {}) as Record<string, unknown>;
+			const kind = payload.kind;
+			// Mirror the interactive notice policy: every crashed hook surfaces, but
+			// a budget overrun only surfaces once it is steady-state slowness.
+			if (kind === "budget_exceeded" && payload.steadyStateWarn !== true) return;
+			const hook = str(payload.hook, "hook");
+			const message =
+				typeof payload.message === "string" && payload.message.length > 0
+					? payload.message
+					: kind === "budget_exceeded"
+						? `middleware hook ${hook} exceeded ${num(payload.budgetMs, 0)}ms budget`
+						: `middleware hook ${hook} failed`;
+			pushNotice("middleware", kind === "budget_exceeded" ? "warning" : "error", message);
+		}),
+		bus.on(BusChannels.SafetyBlocked, (raw: unknown) => {
+			const payload = (raw ?? {}) as Record<string, unknown>;
+			const tool = str(payload.tool, "tool");
+			const rejection = (payload.rejection ?? {}) as { short?: unknown };
+			const short = str(rejection.short, `${str(payload.actionClass, "action")} blocked`);
+			pushNotice("safety", "warning", `${tool}: ${short}`, makeRef({ tool: payload.tool }));
+		}),
+		bus.on(BusChannels.LoopBlocked, (raw: unknown) => {
+			const payload = (raw ?? {}) as Record<string, unknown>;
+			const tool = str(payload.tool, "tool");
+			pushNotice(
+				"loop",
+				payload.interrupted === true ? "error" : "warning",
+				`loop guard blocked repeated ${tool} (${num(payload.repeatCount, 0)}x)`,
+				makeRef({ tool: payload.tool }),
+			);
+		}),
+		bus.on(BusChannels.ToolBudgetExceeded, (raw: unknown) => {
+			const payload = (raw ?? {}) as Record<string, unknown>;
+			const tool = str(payload.tool, "tool");
+			pushNotice(
+				"tool-budget",
+				payload.interrupted === true ? "error" : "warning",
+				`tool-call budget reached on ${tool} (${num(payload.callsThisTurn, 0)} calls)`,
+				makeRef({ tool: payload.tool }),
+			);
+		}),
+		bus.on(BusChannels.ContextPruned, (raw: unknown) => {
+			const payload = (raw ?? {}) as Record<string, unknown>;
+			const reclaimed = Math.max(0, num(payload.tokensBefore, 0) - num(payload.tokensAfter, 0));
+			pushNotice("context", "info", `context pruned ${reclaimed} tokens (${str(payload.stage, "prune")})`);
+		}),
+		bus.on(BusChannels.BudgetAlert, (raw: unknown) => {
+			const payload = (raw ?? {}) as Record<string, unknown>;
+			const over = payload.level === "over";
+			pushNotice(
+				"budget",
+				over ? "error" : "warning",
+				`session cost $${num(payload.currentUsd, 0).toFixed(2)} ${over ? "over" : "at"} $${num(payload.ceilingUsd, 0).toFixed(2)} ceiling`,
+			);
+		}),
+	];
+
+	return {
+		snapshot: buildSnapshot,
+		subscribe(listener) {
+			listeners.add(listener);
+			listener(buildSnapshot());
+			return () => {
+				listeners.delete(listener);
+			};
+		},
+		refresh() {
+			markChanged();
+		},
+		evidenceBuildStarted(runId) {
+			if (typeof runId !== "string" || runId.length === 0) return;
+			pendingEvidence.add(runId);
+			markChanged();
+		},
+		evidenceBuildSucceeded(runId, evidence) {
+			pendingEvidence.delete(runId);
+			const summary = runs.get(runId);
+			if (summary) {
+				summary.evidence = {
+					evidenceId: evidence.evidenceId,
+					firstPassSuccess: evidence.firstPassSuccess,
+					findingCount: evidence.findingCount,
+					tags: [...evidence.tags],
+				};
+			}
+			// The index row that feeds accountability was written before this fires,
+			// so refresh the cached summary from the sidecar index.
+			accountability = deps.readAccountability();
+			markChanged();
+		},
+		evidenceBuildFailed(runId, message) {
+			pendingEvidence.delete(runId);
+			pushNotice(
+				"evidence",
+				"warning",
+				message.length > 0 ? message : `evidence build failed for ${runId}`,
+				makeRef({ runId }),
+			);
+		},
+		stop() {
+			for (const off of unsubscribes) off();
+			unsubscribes.length = 0;
+			if (flushTimer !== null) {
+				clearTimeout(flushTimer);
+				flushTimer = null;
+			}
+			listeners.clear();
+		},
+	};
+}

package/src/domains/observability/telemetry.ts

@@ -0,0 +1,89 @@
+/**
+ * In-memory telemetry store. Counters increment; histograms keep the newest N
+ * samples so metrics.ts can derive p50/p95 on demand. No I/O, no persistence.
+ * The process exiting discards the state.
+ *
+ * Histogram sample storage is bounded by a ring buffer (default
+ * {@link DEFAULT_HISTOGRAM_CAPACITY}). A long-lived interactive session records
+ * a histogram sample per dispatch duration and per completed assistant stream,
+ * so an unbounded array would grow without limit; the ring keeps the most
+ * recent samples, which is what p50/p95 over a rolling window wants anyway.
+ */
+
+export type MetricKind = "counter" | "histogram";
+
+/**
+ * Default number of samples retained per histogram. Percentiles are computed
+ * over this rolling window, so the value trades window length against the
+ * fixed per-histogram memory ceiling.
+ */
+export const DEFAULT_HISTOGRAM_CAPACITY = 256;
+
+export interface TelemetrySnapshot {
+	counters: Record<string, number>;
+	histograms: Record<string, ReadonlyArray<number>>;
+}
+
+export interface Telemetry {
+	record(kind: MetricKind, name: string, value: number): void;
+	snapshot(): TelemetrySnapshot;
+	reset(): void;
+}
+
+/**
+ * Fixed-capacity sample ring. Before the ring fills it appends; once full it
+ * overwrites the oldest sample. `values()` returns a copy in no guaranteed
+ * chronological order, which is fine because every consumer (metrics.ts) sorts
+ * before deriving percentiles.
+ */
+class BoundedSamples {
+	private readonly buffer: number[] = [];
+	private writeIndex = 0;
+
+	constructor(private readonly capacity: number) {}
+
+	push(value: number): void {
+		if (this.buffer.length < this.capacity) {
+			this.buffer.push(value);
+			return;
+		}
+		this.buffer[this.writeIndex] = value;
+		this.writeIndex = (this.writeIndex + 1) % this.capacity;
+	}
+
+	values(): number[] {
+		return [...this.buffer];
+	}
+}
+
+export function createTelemetry(histogramCapacity: number = DEFAULT_HISTOGRAM_CAPACITY): Telemetry {
+	const capacity = Math.max(1, Math.floor(histogramCapacity));
+	const counters = new Map<string, number>();
+	const histograms = new Map<string, BoundedSamples>();
+
+	return {
+		record(kind, name, value) {
+			if (kind === "counter") {
+				counters.set(name, (counters.get(name) ?? 0) + value);
+				return;
+			}
+			let bucket = histograms.get(name);
+			if (!bucket) {
+				bucket = new BoundedSamples(capacity);
+				histograms.set(name, bucket);
+			}
+			bucket.push(value);
+		},
+		snapshot() {
+			const c: Record<string, number> = {};
+			for (const [k, v] of counters) c[k] = v;
+			const h: Record<string, ReadonlyArray<number>> = {};
+			for (const [k, v] of histograms) h[k] = v.values();
+			return { counters: c, histograms: h };
+		},
+		reset() {
+			counters.clear();
+			histograms.clear();
+		},
+	};
+}