@runcore-sh/runcore 0.1.2

package/dist/metrics/firewall-metrics.js

@@ -0,0 +1,261 @@
+/**
+ * Metabolic Firewall metrics — tracks dedup guard, routine classifier,
+ * cooldown manager, autonomous action rate, and resolved pattern filter.
+ *
+ * Records into the existing MetricsStore as MetricPoints with "firewall.*" names.
+ * Provides a report generator for before/after comparison over 2-4 weeks.
+ */
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("firewall-metrics");
+// ─── Metric names ────────────────────────────────────────────────────────────
+export const FIREWALL_METRICS = {
+    /** Autonomous actions spawned in a 10-min window. */
+    AUTONOMOUS_ACTIONS: "firewall.autonomous.actions",
+    /** Dedup guard blocks (each block is one count). */
+    DEDUP_BLOCKS: "firewall.dedup.blocks",
+    /** Routine entries filtered per analysis cycle. */
+    ROUTINE_FILTERED: "firewall.routine.filtered",
+    /** Entries filtered by resolved pattern match per analysis cycle. */
+    RESOLVED_FILTERED: "firewall.resolved.filtered",
+    /** Cooldown activations (task put on cooldown). */
+    COOLDOWN_ACTIVATIONS: "firewall.cooldown.activations",
+    /** Cooldown skips (task skipped because on cooldown). */
+    COOLDOWN_SKIPS: "firewall.cooldown.skips",
+    /** Bridge reports generated (3+ failure handoffs). */
+    BRIDGE_REPORTS: "firewall.bridge.reports",
+    /** Spawn rate limiter blocks. */
+    SPAWN_RATE_BLOCKS: "firewall.spawn_rate.blocks",
+    /** Total entries entering analysis pipeline. */
+    ANALYSIS_ENTRIES_RAW: "firewall.analysis.entries_raw",
+    /** Entries remaining after all filters. */
+    ANALYSIS_ENTRIES_KEPT: "firewall.analysis.entries_kept",
+};
+// ─── In-memory accumulators (flushed on each collect cycle) ──────────────────
+let autonomousActions = 0;
+let dedupBlocks = 0;
+const dedupReasons = [];
+let routineFiltered = 0;
+let resolvedFiltered = 0;
+let cooldownActivations = 0;
+let cooldownSkips = 0;
+let bridgeReports = 0;
+let spawnRateBlocks = 0;
+let analysisEntriesRaw = 0;
+let analysisEntriesKept = 0;
+// ─── Recording API (called from firewall components) ─────────────────────────
+/** Record an autonomous action (agent spawned by the autonomous loop). */
+export function recordAutonomousAction() {
+    autonomousActions++;
+}
+/** Record a dedup guard block. */
+export function recordDedupBlock(reason) {
+    dedupBlocks++;
+    dedupReasons.push(reason);
+}
+/** Record routine entries filtered in an analysis cycle. */
+export function recordRoutineFiltered(count) {
+    routineFiltered += count;
+}
+/** Record resolved-pattern entries filtered in an analysis cycle. */
+export function recordResolvedFiltered(count) {
+    resolvedFiltered += count;
+}
+/** Record a cooldown activation (task failure → cooldown). */
+export function recordCooldownActivation() {
+    cooldownActivations++;
+}
+/** Record a cooldown skip (task skipped because on cooldown). */
+export function recordCooldownSkip() {
+    cooldownSkips++;
+}
+/** Record a bridge report generation. */
+export function recordBridgeReport() {
+    bridgeReports++;
+}
+/** Record a spawn rate limiter block. */
+export function recordSpawnRateBlock() {
+    spawnRateBlocks++;
+}
+/** Record analysis pipeline throughput for one cycle. */
+export function recordAnalysisThroughput(raw, kept) {
+    analysisEntriesRaw += raw;
+    analysisEntriesKept += kept;
+}
+// ─── Collection (called by the main metrics collector) ───────────────────────
+/**
+ * Drain in-memory accumulators and return MetricPoints.
+ * Designed to be called from the main collect() cycle in collector.ts.
+ */
+export function collectFirewallMetrics() {
+    const now = new Date().toISOString();
+    const points = [];
+    if (autonomousActions > 0) {
+        points.push({
+            timestamp: now,
+            name: FIREWALL_METRICS.AUTONOMOUS_ACTIONS,
+            value: autonomousActions,
+            unit: "count",
+        });
+    }
+    if (dedupBlocks > 0) {
+        points.push({
+            timestamp: now,
+            name: FIREWALL_METRICS.DEDUP_BLOCKS,
+            value: dedupBlocks,
+            unit: "count",
+        });
+    }
+    if (routineFiltered > 0) {
+        points.push({
+            timestamp: now,
+            name: FIREWALL_METRICS.ROUTINE_FILTERED,
+            value: routineFiltered,
+            unit: "count",
+        });
+    }
+    if (resolvedFiltered > 0) {
+        points.push({
+            timestamp: now,
+            name: FIREWALL_METRICS.RESOLVED_FILTERED,
+            value: resolvedFiltered,
+            unit: "count",
+        });
+    }
+    if (cooldownActivations > 0) {
+        points.push({
+            timestamp: now,
+            name: FIREWALL_METRICS.COOLDOWN_ACTIVATIONS,
+            value: cooldownActivations,
+            unit: "count",
+        });
+    }
+    if (cooldownSkips > 0) {
+        points.push({
+            timestamp: now,
+            name: FIREWALL_METRICS.COOLDOWN_SKIPS,
+            value: cooldownSkips,
+            unit: "count",
+        });
+    }
+    if (bridgeReports > 0) {
+        points.push({
+            timestamp: now,
+            name: FIREWALL_METRICS.BRIDGE_REPORTS,
+            value: bridgeReports,
+            unit: "count",
+        });
+    }
+    if (spawnRateBlocks > 0) {
+        points.push({
+            timestamp: now,
+            name: FIREWALL_METRICS.SPAWN_RATE_BLOCKS,
+            value: spawnRateBlocks,
+            unit: "count",
+        });
+    }
+    if (analysisEntriesRaw > 0) {
+        points.push({ timestamp: now, name: FIREWALL_METRICS.ANALYSIS_ENTRIES_RAW, value: analysisEntriesRaw, unit: "count" }, { timestamp: now, name: FIREWALL_METRICS.ANALYSIS_ENTRIES_KEPT, value: analysisEntriesKept, unit: "count" });
+    }
+    // Reset accumulators
+    autonomousActions = 0;
+    dedupBlocks = 0;
+    dedupReasons.length = 0;
+    routineFiltered = 0;
+    resolvedFiltered = 0;
+    cooldownActivations = 0;
+    cooldownSkips = 0;
+    bridgeReports = 0;
+    spawnRateBlocks = 0;
+    analysisEntriesRaw = 0;
+    analysisEntriesKept = 0;
+    return points;
+}
+/**
+ * Generate stats for a time period from the metrics store.
+ * @param store MetricsStore instance
+ * @param since ISO timestamp for period start
+ * @param until ISO timestamp for period end (defaults to now)
+ */
+export async function generatePeriodStats(store, since, until) {
+    const periodEnd = until ?? new Date().toISOString();
+    const query = (name) => store.query({ name, since, until: periodEnd });
+    const [autonomousPoints, dedupPoints, routinePoints, resolvedPoints, cooldownActPoints, cooldownSkipPoints, bridgePoints, spawnRatePoints, rawEntryPoints, keptEntryPoints,] = await Promise.all([
+        query(FIREWALL_METRICS.AUTONOMOUS_ACTIONS),
+        query(FIREWALL_METRICS.DEDUP_BLOCKS),
+        query(FIREWALL_METRICS.ROUTINE_FILTERED),
+        query(FIREWALL_METRICS.RESOLVED_FILTERED),
+        query(FIREWALL_METRICS.COOLDOWN_ACTIVATIONS),
+        query(FIREWALL_METRICS.COOLDOWN_SKIPS),
+        query(FIREWALL_METRICS.BRIDGE_REPORTS),
+        query(FIREWALL_METRICS.SPAWN_RATE_BLOCKS),
+        query(FIREWALL_METRICS.ANALYSIS_ENTRIES_RAW),
+        query(FIREWALL_METRICS.ANALYSIS_ENTRIES_KEPT),
+    ]);
+    const sum = (pts) => pts.reduce((s, p) => s + p.value, 0);
+    // Calculate autonomous actions per 10-min window
+    const totalAutonomous = sum(autonomousPoints);
+    const periodMs = new Date(periodEnd).getTime() - new Date(since).getTime();
+    const tenMinWindows = Math.max(1, periodMs / (10 * 60 * 1000));
+    const autonomousActionsPer10Min = Math.round((totalAutonomous / tenMinWindows) * 100) / 100;
+    // Analysis cycle count = number of raw entry data points
+    const analysisCycles = Math.max(1, rawEntryPoints.length);
+    const totalRaw = sum(rawEntryPoints);
+    const totalKept = sum(keptEntryPoints);
+    const filterEfficiency = totalRaw > 0
+        ? Math.round(((totalRaw - totalKept) / totalRaw) * 10000) / 100
+        : 0;
+    return {
+        periodStart: since,
+        periodEnd,
+        autonomousActionsPer10Min,
+        dedupBlocksTotal: sum(dedupPoints),
+        routineFilteredPerCycle: Math.round((sum(routinePoints) / analysisCycles) * 100) / 100,
+        resolvedFilteredPerCycle: Math.round((sum(resolvedPoints) / analysisCycles) * 100) / 100,
+        cooldownActivationsTotal: sum(cooldownActPoints),
+        cooldownSkipsTotal: sum(cooldownSkipPoints),
+        bridgeReportsTotal: sum(bridgePoints),
+        spawnRateBlocksTotal: sum(spawnRatePoints),
+        filterEfficiencyPercent: filterEfficiency,
+    };
+}
+/**
+ * Generate a markdown comparison report between two periods.
+ * Designed for the 2-4 week before/after writeup.
+ */
+export async function generateComparisonReport(store, before, after) {
+    const [beforeStats, afterStats] = await Promise.all([
+        generatePeriodStats(store, before.since, before.until),
+        generatePeriodStats(store, after.since, after.until),
+    ]);
+    const delta = (b, a) => {
+        if (b === 0 && a === 0)
+            return "—";
+        if (b === 0)
+            return `+${a}`;
+        const pct = Math.round(((a - b) / b) * 100);
+        const sign = pct > 0 ? "+" : "";
+        return `${sign}${pct}%`;
+    };
+    const lines = [
+        `# Metabolic Firewall — Before/After Comparison`,
+        ``,
+        `| Metric | Before | After | Change |`,
+        `|--------|--------|-------|--------|`,
+        `| Autonomous actions / 10-min window | ${beforeStats.autonomousActionsPer10Min} | ${afterStats.autonomousActionsPer10Min} | ${delta(beforeStats.autonomousActionsPer10Min, afterStats.autonomousActionsPer10Min)} |`,
+        `| Dedup guard blocks (total) | ${beforeStats.dedupBlocksTotal} | ${afterStats.dedupBlocksTotal} | ${delta(beforeStats.dedupBlocksTotal, afterStats.dedupBlocksTotal)} |`,
+        `| Routine entries filtered / cycle | ${beforeStats.routineFilteredPerCycle} | ${afterStats.routineFilteredPerCycle} | ${delta(beforeStats.routineFilteredPerCycle, afterStats.routineFilteredPerCycle)} |`,
+        `| Resolved-pattern filtered / cycle | ${beforeStats.resolvedFilteredPerCycle} | ${afterStats.resolvedFilteredPerCycle} | ${delta(beforeStats.resolvedFilteredPerCycle, afterStats.resolvedFilteredPerCycle)} |`,
+        `| Cooldown activations (total) | ${beforeStats.cooldownActivationsTotal} | ${afterStats.cooldownActivationsTotal} | ${delta(beforeStats.cooldownActivationsTotal, afterStats.cooldownActivationsTotal)} |`,
+        `| Cooldown skips (total) | ${beforeStats.cooldownSkipsTotal} | ${afterStats.cooldownSkipsTotal} | ${delta(beforeStats.cooldownSkipsTotal, afterStats.cooldownSkipsTotal)} |`,
+        `| Bridge reports (total) | ${beforeStats.bridgeReportsTotal} | ${afterStats.bridgeReportsTotal} | ${delta(beforeStats.bridgeReportsTotal, afterStats.bridgeReportsTotal)} |`,
+        `| Spawn rate blocks (total) | ${beforeStats.spawnRateBlocksTotal} | ${afterStats.spawnRateBlocksTotal} | ${delta(beforeStats.spawnRateBlocksTotal, afterStats.spawnRateBlocksTotal)} |`,
+        `| Filter efficiency | ${beforeStats.filterEfficiencyPercent}% | ${afterStats.filterEfficiencyPercent}% | ${delta(beforeStats.filterEfficiencyPercent, afterStats.filterEfficiencyPercent)} |`,
+        ``,
+        `**Before period:** ${beforeStats.periodStart} → ${beforeStats.periodEnd}`,
+        `**After period:** ${afterStats.periodStart} → ${afterStats.periodEnd}`,
+        ``,
+        `**Target:** Autonomous actions per 10-min window < 5 (baseline: 22)`,
+    ];
+    return lines.join("\n");
+}
+//# sourceMappingURL=firewall-metrics.js.map

package/dist/metrics/firewall-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firewall-metrics.js","sourceRoot":"","sources":["../../src/metrics/firewall-metrics.ts"],"names":[],"mappings":"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"}

package/dist/metrics/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Metrics module — public API.
+ * Follows src/health/index.ts pattern: re-export types + implementations.
+ */
+export { MetricsStore } from "./store.js";
+export { startCollector, stopCollector, isCollectorRunning, recordHttp, recordConcurrentRequests, recordAgentSpawn, recordAgentCompletion, recordError, } from "./collector.js";
+export { registerDefaultThresholds, registerThreshold, clearThresholds, getThresholds, evaluateAlerts, getRecentAlerts, buildDashboard, } from "./reporter.js";
+export { FIREWALL_METRICS, recordAutonomousAction, recordDedupBlock, recordRoutineFiltered, recordResolvedFiltered, recordCooldownActivation, recordCooldownSkip, recordBridgeReport, recordSpawnRateBlock, recordAnalysisThroughput, collectFirewallMetrics, generatePeriodStats, generateComparisonReport, } from "./firewall-metrics.js";
+export type { FirewallPeriodStats } from "./firewall-metrics.js";
+export { metricsMiddleware } from "./middleware.js";
+export { Counter, Gauge, Histogram, DEFAULT_BUCKETS } from "./instruments.js";
+export type { Labels, Sample, BucketSample, HistogramSamples } from "./instruments.js";
+export { MetricRegistry } from "./registry.js";
+export type { MetricStoreBackend, MetricType } from "./registry.js";
+export { prometheusRegistry, collectPrometheus, agentSpawnsTotal, agentExecutionsTotal, agentExecutionDuration, agentSuccessRate, agentMemoryUsageBytes, apiCallsTotal, apiCallDuration, httpRequestsTotal, httpRequestDurationSeconds, concurrentRequests, memoryUsageBytes, agentExecutionsInFlight, uptimeSeconds, cpuUsagePercent, eventLoopDriftSeconds, errorsTotal, diskUsageBytes, } from "./prometheus.js";
+export { initCpuBaseline, collectMemoryMetrics, collectCpuMetrics, collectDiskMetrics, collectSystemMetrics, } from "./system.js";
+export { aggregateHourly, aggregateDaily, runAggregation, isAggregating, } from "./aggregator.js";
+export type { AggregateWindow, AggregateEntry, AggregateFile, } from "./aggregator.js";
+export type { MetricPoint, MetricCategory, MetricSummary, HistogramBucket, AlertThreshold, Alert, AlertSeverity, DashboardSnapshot, RotationConfig, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/metrics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EACL,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,wBAAwB,EACxB,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,KAAK,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/metrics/index.js

@@ -0,0 +1,23 @@
+/**
+ * Metrics module — public API.
+ * Follows src/health/index.ts pattern: re-export types + implementations.
+ */
+// Store
+export { MetricsStore } from "./store.js";
+// Collector
+export { startCollector, stopCollector, isCollectorRunning, recordHttp, recordConcurrentRequests, recordAgentSpawn, recordAgentCompletion, recordError, } from "./collector.js";
+// Reporter
+export { registerDefaultThresholds, registerThreshold, clearThresholds, getThresholds, evaluateAlerts, getRecentAlerts, buildDashboard, } from "./reporter.js";
+// Firewall metrics
+export { FIREWALL_METRICS, recordAutonomousAction, recordDedupBlock, recordRoutineFiltered, recordResolvedFiltered, recordCooldownActivation, recordCooldownSkip, recordBridgeReport, recordSpawnRateBlock, recordAnalysisThroughput, collectFirewallMetrics, generatePeriodStats, generateComparisonReport, } from "./firewall-metrics.js";
+// Middleware
+export { metricsMiddleware } from "./middleware.js";
+// Prometheus-style instruments and registry
+export { Counter, Gauge, Histogram, DEFAULT_BUCKETS } from "./instruments.js";
+export { MetricRegistry } from "./registry.js";
+export { prometheusRegistry, collectPrometheus, agentSpawnsTotal, agentExecutionsTotal, agentExecutionDuration, agentSuccessRate, agentMemoryUsageBytes, apiCallsTotal, apiCallDuration, httpRequestsTotal, httpRequestDurationSeconds, concurrentRequests, memoryUsageBytes, agentExecutionsInFlight, uptimeSeconds, cpuUsagePercent, eventLoopDriftSeconds, errorsTotal, diskUsageBytes, } from "./prometheus.js";
+// System metrics
+export { initCpuBaseline, collectMemoryMetrics, collectCpuMetrics, collectDiskMetrics, collectSystemMetrics, } from "./system.js";
+// Aggregator
+export { aggregateHourly, aggregateDaily, runAggregation, isAggregating, } from "./aggregator.js";
+//# sourceMappingURL=index.js.map

package/dist/metrics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,QAAQ;AACR,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY;AACZ,OAAO,EACL,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,wBAAwB,EACxB,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,WAAW;AACX,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,mBAAmB;AACnB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,aAAa;AACb,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,4CAA4C;AAC5C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,iBAAiB;AACjB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,aAAa;AACb,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC"}

package/dist/metrics/instruments.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Prometheus-style metric instruments: Counter, Gauge, Histogram.
+ * Each instrument tracks values in-memory with optional label dimensions.
+ */
+export type Labels = Record<string, string>;
+/** Collected sample from an instrument. */
+export interface Sample {
+    labels: Labels;
+    value: number;
+}
+/** Histogram bucket sample. */
+export interface BucketSample {
+    labels: Labels;
+    le: number;
+    count: number;
+}
+/** Histogram collected data. */
+export interface HistogramSamples {
+    buckets: BucketSample[];
+    sums: Sample[];
+    counts: Sample[];
+}
+/** Monotonically increasing counter. */
+export declare class Counter {
+    readonly name: string;
+    readonly help: string;
+    readonly labelNames: readonly string[];
+    private values;
+    constructor(opts: {
+        name: string;
+        help: string;
+        labelNames?: string[];
+    });
+    /** Increment the counter. Value must be >= 0. */
+    inc(labels?: Labels, value?: number): void;
+    /** Get current value for a label set. */
+    get(labels?: Labels): number;
+    /** Reset all values. */
+    reset(): void;
+    /** Collect all samples for exposition. */
+    collect(): Sample[];
+}
+/** Value that can go up and down. */
+export declare class Gauge {
+    readonly name: string;
+    readonly help: string;
+    readonly labelNames: readonly string[];
+    private values;
+    constructor(opts: {
+        name: string;
+        help: string;
+        labelNames?: string[];
+    });
+    /** Set the gauge to an absolute value. */
+    set(labels: Labels | undefined, value: number): void;
+    /** Increment the gauge. */
+    inc(labels?: Labels, value?: number): void;
+    /** Decrement the gauge. */
+    dec(labels?: Labels, value?: number): void;
+    /** Get current value for a label set. */
+    get(labels?: Labels): number;
+    /** Reset all values. */
+    reset(): void;
+    /** Collect all samples for exposition. */
+    collect(): Sample[];
+}
+/** Default Prometheus histogram buckets. */
+export declare const DEFAULT_BUCKETS: number[];
+/** Tracks value distributions with configurable bucket boundaries. */
+export declare class Histogram {
+    readonly name: string;
+    readonly help: string;
+    readonly labelNames: readonly string[];
+    readonly buckets: readonly number[];
+    private entries;
+    constructor(opts: {
+        name: string;
+        help: string;
+        labelNames?: string[];
+        buckets?: number[];
+    });
+    /** Record an observed value. */
+    observe(labels: Labels | undefined, value: number): void;
+    /** Reset all entries. */
+    reset(): void;
+    /** Collect all histogram data for exposition. */
+    collect(): HistogramSamples;
+}
+//# sourceMappingURL=instruments.d.ts.map

package/dist/metrics/instruments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruments.d.ts","sourceRoot":"","sources":["../../src/metrics/instruments.ts"],"names":[],"mappings":"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"}

package/dist/metrics/instruments.js

@@ -0,0 +1,172 @@
+/**
+ * Prometheus-style metric instruments: Counter, Gauge, Histogram.
+ * Each instrument tracks values in-memory with optional label dimensions.
+ */
+/** Serialize a label set to a stable string key for Map lookups. */
+function labelsKey(labels) {
+    const entries = Object.entries(labels);
+    if (entries.length === 0)
+        return "";
+    return entries.sort(([a], [b]) => a.localeCompare(b))
+        .map(([k, v]) => `${k}="${v}"`)
+        .join(",");
+}
+// ─── Counter ─────────────────────────────────────────────────────────────────
+/** Monotonically increasing counter. */
+export class Counter {
+    name;
+    help;
+    labelNames;
+    values = new Map();
+    constructor(opts) {
+        this.name = opts.name;
+        this.help = opts.help;
+        this.labelNames = opts.labelNames ?? [];
+    }
+    /** Increment the counter. Value must be >= 0. */
+    inc(labels, value = 1) {
+        if (value < 0)
+            throw new Error("Counter can only increase");
+        const key = labelsKey(labels ?? {});
+        const existing = this.values.get(key);
+        if (existing) {
+            existing.value += value;
+        }
+        else {
+            this.values.set(key, { labels: { ...(labels ?? {}) }, value });
+        }
+    }
+    /** Get current value for a label set. */
+    get(labels) {
+        return this.values.get(labelsKey(labels ?? {}))?.value ?? 0;
+    }
+    /** Reset all values. */
+    reset() {
+        this.values.clear();
+    }
+    /** Collect all samples for exposition. */
+    collect() {
+        return Array.from(this.values.values());
+    }
+}
+// ─── Gauge ───────────────────────────────────────────────────────────────────
+/** Value that can go up and down. */
+export class Gauge {
+    name;
+    help;
+    labelNames;
+    values = new Map();
+    constructor(opts) {
+        this.name = opts.name;
+        this.help = opts.help;
+        this.labelNames = opts.labelNames ?? [];
+    }
+    /** Set the gauge to an absolute value. */
+    set(labels, value) {
+        const key = labelsKey(labels ?? {});
+        const existing = this.values.get(key);
+        if (existing) {
+            existing.value = value;
+        }
+        else {
+            this.values.set(key, { labels: { ...(labels ?? {}) }, value });
+        }
+    }
+    /** Increment the gauge. */
+    inc(labels, value = 1) {
+        const key = labelsKey(labels ?? {});
+        const existing = this.values.get(key);
+        if (existing) {
+            existing.value += value;
+        }
+        else {
+            this.values.set(key, { labels: { ...(labels ?? {}) }, value });
+        }
+    }
+    /** Decrement the gauge. */
+    dec(labels, value = 1) {
+        this.inc(labels, -value);
+    }
+    /** Get current value for a label set. */
+    get(labels) {
+        return this.values.get(labelsKey(labels ?? {}))?.value ?? 0;
+    }
+    /** Reset all values. */
+    reset() {
+        this.values.clear();
+    }
+    /** Collect all samples for exposition. */
+    collect() {
+        return Array.from(this.values.values());
+    }
+}
+// ─── Histogram ───────────────────────────────────────────────────────────────
+/** Default Prometheus histogram buckets. */
+export const DEFAULT_BUCKETS = [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
+/** Tracks value distributions with configurable bucket boundaries. */
+export class Histogram {
+    name;
+    help;
+    labelNames;
+    buckets;
+    entries = new Map();
+    constructor(opts) {
+        this.name = opts.name;
+        this.help = opts.help;
+        this.labelNames = opts.labelNames ?? [];
+        this.buckets = [...(opts.buckets ?? DEFAULT_BUCKETS)].sort((a, b) => a - b);
+    }
+    /** Record an observed value. */
+    observe(labels, value) {
+        const key = labelsKey(labels ?? {});
+        let entry = this.entries.get(key);
+        if (!entry) {
+            entry = {
+                labels: { ...(labels ?? {}) },
+                bucketCounts: new Array(this.buckets.length).fill(0),
+                sum: 0,
+                count: 0,
+            };
+            this.entries.set(key, entry);
+        }
+        entry.sum += value;
+        entry.count++;
+        for (let i = 0; i < this.buckets.length; i++) {
+            if (value <= this.buckets[i]) {
+                entry.bucketCounts[i]++;
+            }
+        }
+    }
+    /** Reset all entries. */
+    reset() {
+        this.entries.clear();
+    }
+    /** Collect all histogram data for exposition. */
+    collect() {
+        const buckets = [];
+        const sums = [];
+        const counts = [];
+        for (const entry of this.entries.values()) {
+            // Cumulative bucket counts (Prometheus convention)
+            let cumulative = 0;
+            for (let i = 0; i < this.buckets.length; i++) {
+                cumulative += entry.bucketCounts[i];
+                buckets.push({
+                    labels: entry.labels,
+                    le: this.buckets[i],
+                    count: cumulative,
+                });
+            }
+            // +Inf bucket
+            buckets.push({
+                labels: entry.labels,
+                le: Infinity,
+                count: entry.count,
+            });
+            sums.push({ labels: entry.labels, value: entry.sum });
+            counts.push({ labels: entry.labels, value: entry.count });
+        }
+        return { buckets, sums, counts };
+    }
+}
+//# sourceMappingURL=instruments.js.map

package/dist/metrics/instruments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruments.js","sourceRoot":"","sources":["../../src/metrics/instruments.ts"],"names":[],"mappings":"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"}

package/dist/metrics/middleware.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Hono middleware for automatic HTTP request metrics collection.
+ * Measures request duration, status codes, and concurrent requests.
+ * Records to both the time-series collector and Prometheus instruments.
+ */
+import type { MiddlewareHandler } from "hono";
+/**
+ * Metrics middleware — records request duration, status code, and concurrent requests.
+ * Attach early in the middleware chain (before routes).
+ */
+export declare function metricsMiddleware(): MiddlewareHandler;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/metrics/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/metrics/middleware.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAU9C;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,CA+BrD"}