@senpi/runtime 3.0.65 → 3.0.67

package/dist/telemetry/live-telemetry.js

@@ -0,0 +1,471 @@
+/**
+ * The publisher: the piece that turns the buffer and the three builders into frames on the gateway
+ * websocket, plus the snapshot a client reads when it connects.
+ *
+ * Two things about the transport shape the whole module:
+ * - The only route to the websocket is a captured `context.broadcast`, and `context` exists only
+ *   inside a gateway RPC handler — the plugin api object has no push surface at all. So the handle is
+ *   captured from the FIRST request of ANY kind, not only from the subscribe method: a box whose
+ *   client never calls subscribe would otherwise hold nothing to publish through, silently.
+ * - The gateway drops any event name that does not start with `plugin.`, and closes the socket with
+ *   1008 for a slow client unless the call passes `dropIfSlow`. Both are enforced here rather than at
+ *   each call site, because either mistake is invisible until a client is missing frames.
+ *
+ * Three cadences, because the three payloads cost different things to build:
+ * - timeline, on the flush tick — a drain plus a filter, cheap, and the one a live screen feels.
+ * - stats, on the sample tick — a scan of the whole held window and an async read of every runtime's
+ *   health and system state, so it runs an order of magnitude less often.
+ * - topology, on the sample tick but published only when it changes — it rides the same gather as
+ *   stats, and nothing in the plugin signals a topology change, so "on change" means polled and
+ *   diffed rather than pushed.
+ *
+ * The snapshot is what stops a client that joins mid-life from seeing an empty screen: it is read
+ * from the buffer's held window, which the flush drain never evicts.
+ */
+import { createLogger } from "../utils/logger.js";
+import { withSpanSync } from "./tracing.js";
+import { ADMITTED_EVENT_NAMES, readAndResetTapCounters } from "./telemetry-publisher.js";
+import { getTimelineBuffer, teardownTimelineBuffer, } from "./timeline-buffer.js";
+import { buildScannerStats, } from "./scanner-stats.js";
+import { buildStrategyTopology, } from "./strategy-topology.js";
+const logger = createLogger("[senpi-core][live-telemetry]");
+/** The gateway drops any broadcast whose name does not carry this prefix, with no error. */
+export const EVENT_TIMELINE = "plugin.senpi.timeline";
+export const EVENT_STATS = "plugin.senpi.scanner.stats";
+export const EVENT_TOPOLOGY = "plugin.senpi.strategies";
+/**
+ * Byte ceiling for one frame. The bridge's north read limit is 256 KiB and a breach closes the
+ * client socket with 1009, so the budget is set at half of it: the payload envelope the gateway wraps
+ * around ours, and the growth of a single record's attribute bag, both have to fit inside the margin.
+ */
+export const MAX_FRAME_BYTES = 128 * 1024;
+/** Flush cadence for the timeline. A live screen feels this number. */
+export const DEFAULT_FLUSH_INTERVAL_MS = 1_000;
+/**
+ * Sample cadence for stats and topology. Both are built from one async read of every runtime's health
+ * and system state, so they share a tick. Five seconds is roughly a third of the default bucket width
+ * — fast enough that a counter visibly moves and a hung scan is seen while it is still running, slow
+ * enough that the per-scanner store read behind the system state is not a poll loop.
+ */
+export const DEFAULT_SAMPLE_INTERVAL_MS = 5_000;
+/**
+ * The PUBLICATION list: what leaves on the timeline event. A name being on this list AND on the
+ * admission list is the normal case, not a duplication — `signal.outcome` is the decision row the feed
+ * is built around and the source of `opens`/`closes`/`skips`, and the two `scaffold.tick_*` names are
+ * the source of `errors` and the rows behind the Errors filter. A failing external scanner has to
+ * leave a visible line, not only a number that silently goes up.
+ *
+ * The two lists are separate so admission can be widened for a counter the feed does not display,
+ * which is the direction that has to stay open: the display filter belongs here at publish time,
+ * where it is still recoverable, never at append time, where it is not. Today nothing is admitted for
+ * counting alone, so the sets are equal — the seam is what matters, not the difference.
+ */
+export const PUBLISHED_EVENT_NAMES = new Set(ADMITTED_EVENT_NAMES);
+/**
+ * The share of its own interval a tick may take before it is warned about. A fraction rather than a
+ * constant, so a deployment that changes a cadence gets a proportional threshold: 250ms on the
+ * one-second timeline flush, 1.25s on the five-second sample.
+ *
+ * A quarter, not a whole interval. Both ticks share an event loop with the serial trading path, so a
+ * tick holding it for a quarter of its own period is already adding latency to trading; and a tick
+ * that fills its interval has already started stacking on the next one, which is too late to be told.
+ */
+export const SLOW_TICK_FRACTION = 0.25;
+/**
+ * How often the timing summary is logged, and the floor between two slow-tick warns of the same kind.
+ * The flush tick runs every second, so a line per tick would be tens of thousands a day for numbers
+ * that only mean anything aggregated — and a repeating tick that is slow is slow every time.
+ */
+export const TIMING_REPORT_INTERVAL_MS = 60_000;
+/** What the builders see when the facts could not be read: nothing, rather than a stale guess. */
+const NO_FACTS = {
+    strategies: [],
+    runningRuntimeIds: { has: () => false },
+    unwiredRuntimeIds: { has: () => false },
+    scannerState: [],
+};
+function toWireRecord(record) {
+    return {
+        seq: record.seq,
+        ts: record.ts,
+        name: record.name,
+        level: record.level,
+        address: record.address,
+        ...(record.scannerId !== undefined ? { scannerId: record.scannerId } : {}),
+        body: record.body,
+        attrs: record.attrs,
+    };
+}
+/** A cursor is a resume point, so anything that is not a whole non-negative number means "from the start". */
+function normalizeAfterSeq(raw) {
+    if (typeof raw !== "number" || !Number.isFinite(raw) || raw < 0)
+        return 0;
+    return Math.floor(raw);
+}
+/** Everything but `generatedAt`, which changes on every build and would make every topology "changed". */
+function topologySignature(payload) {
+    return JSON.stringify({ v: payload.v, strategies: payload.strategies });
+}
+/** Microsecond precision. A sub-millisecond tick is the interesting case; its 17th digit is not. */
+function roundMs(ms) {
+    return Math.round(ms * 1_000) / 1_000;
+}
+export function createLiveTelemetry(options) {
+    const ownsProcessBuffer = options.buffer === undefined;
+    const buffer = options.buffer ?? getTimelineBuffer();
+    const now = options.now ?? Date.now;
+    const monotonicMs = options.monotonicMs ?? (() => performance.now());
+    const flushIntervalMs = options.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
+    const sampleIntervalMs = options.sampleIntervalMs ?? DEFAULT_SAMPLE_INTERVAL_MS;
+    // When this epoch began watching: `since` falls back to it while the buffer holds nothing, so an
+    // empty window reads as "watching since X, nothing happened" rather than "no data".
+    const bufferStartedAt = now();
+    let broadcast;
+    let flushTimer;
+    let sampleTimer;
+    let sampleInFlight = false;
+    let batchSeq = 0;
+    let lastTopologySignature;
+    // Both guards sit on per-second paths, so each warns once until the condition clears.
+    let warnedNoBroadcast = false;
+    let warnedBroadcastFailure = false;
+    let warnedOversizedRecord = false;
+    // What the ticks cost over one report window. Bucket width and buffer retention are deliberately
+    // unfixed by the design, and these are the numbers they get sized from.
+    const timelineWindow = { ticks: 0, msMax: 0, records: 0, payloadBytes: 0 };
+    const statsWindow = { ticks: 0, msMax: 0, recordsScanned: 0, payloadBytesMax: 0 };
+    const tapWindow = { calls: 0, nsTotal: 0, nsMax: 0 };
+    let lastReportAt = bufferStartedAt;
+    const lastSlowWarnAt = { timeline: 0, stats: 0 };
+    /** True when the frame reached the gateway, so a caller counts bytes only for what went out. */
+    function publish(event, payload) {
+        if (broadcast === undefined) {
+            if (!warnedNoBroadcast) {
+                warnedNoBroadcast = true;
+                logger.warn("live telemetry has no gateway broadcast handle yet; nothing is published until a client calls any senpi gateway method", { "senpi.telemetry.event": event });
+            }
+            return false;
+        }
+        try {
+            // `dropIfSlow` is not optional: without it the gateway closes the socket with 1008 for a slow
+            // client instead of skipping the one frame it could not fit.
+            broadcast(event, payload, { dropIfSlow: true });
+            warnedBroadcastFailure = false;
+            return true;
+        }
+        catch (err) {
+            if (!warnedBroadcastFailure) {
+                warnedBroadcastFailure = true;
+                logger.warn("live telemetry broadcast failed; frames are being lost", {
+                    "senpi.telemetry.event": event,
+                    err: err instanceof Error ? err.message : String(err),
+                });
+            }
+            return false;
+        }
+    }
+    /** Record what a tick cost, and warn when it is eating its own interval. */
+    function noteTick(kind, elapsedMs, intervalMs) {
+        const window = kind === "timeline" ? timelineWindow : statsWindow;
+        window.ticks += 1;
+        if (elapsedMs > window.msMax)
+            window.msMax = elapsedMs;
+        const thresholdMs = intervalMs * SLOW_TICK_FRACTION;
+        if (elapsedMs <= thresholdMs)
+            return;
+        const at = now();
+        // A tick that is slow is slow every time, and these repeat on the order of seconds.
+        if (at - lastSlowWarnAt[kind] < TIMING_REPORT_INTERVAL_MS)
+            return;
+        lastSlowWarnAt[kind] = at;
+        logger.warn("live telemetry tick is slow relative to its own interval", {
+            "senpi.telemetry.tick": kind,
+            "senpi.telemetry.tick_ms": roundMs(elapsedMs),
+            "senpi.telemetry.tick_threshold_ms": thresholdMs,
+            "senpi.telemetry.tick_interval_ms": intervalMs,
+        });
+    }
+    /**
+     * One aggregated line per window, off the flush tick. Logged and not only traced: the OTel SDK
+     * stands up only when an OTLP endpoint is configured, so on a box with no collector there are no
+     * spans and nothing that says there are none.
+     */
+    function reportTiming() {
+        const at = now();
+        const windowMs = at - lastReportAt;
+        if (windowMs < TIMING_REPORT_INTERVAL_MS)
+            return;
+        lastReportAt = at;
+        logger.info("live telemetry tick timing", {
+            "senpi.telemetry.window_ms": windowMs,
+            "senpi.telemetry.timeline_ticks": timelineWindow.ticks,
+            "senpi.telemetry.timeline_ms_max": roundMs(timelineWindow.msMax),
+            "senpi.telemetry.records_flushed": timelineWindow.records,
+            "senpi.telemetry.timeline_payload_bytes": timelineWindow.payloadBytes,
+            "senpi.telemetry.stats_ticks": statsWindow.ticks,
+            "senpi.telemetry.stats_ms_max": roundMs(statsWindow.msMax),
+            "senpi.telemetry.records_scanned": statsWindow.recordsScanned,
+            "senpi.telemetry.stats_payload_bytes_max": statsWindow.payloadBytesMax,
+            "senpi.telemetry.tap_calls": tapWindow.calls,
+            "senpi.telemetry.tap_ns_total": tapWindow.nsTotal,
+            // No tap call is an idle box, not a division: the average of nothing is nothing.
+            "senpi.telemetry.tap_ns_avg": tapWindow.calls === 0 ? 0 : Math.round(tapWindow.nsTotal / tapWindow.calls),
+            "senpi.telemetry.tap_ns_p_max": tapWindow.nsMax,
+        });
+        timelineWindow.ticks = 0;
+        timelineWindow.msMax = 0;
+        timelineWindow.records = 0;
+        timelineWindow.payloadBytes = 0;
+        statsWindow.ticks = 0;
+        statsWindow.msMax = 0;
+        statsWindow.recordsScanned = 0;
+        statsWindow.payloadBytesMax = 0;
+        tapWindow.calls = 0;
+        tapWindow.nsTotal = 0;
+        tapWindow.nsMax = 0;
+    }
+    function noteOversizedRecord(record, bytes) {
+        if (warnedOversizedRecord)
+            return;
+        warnedOversizedRecord = true;
+        logger.warn("live telemetry dropped a record too large for one frame", {
+            "senpi.event.name": record.name,
+            "senpi.telemetry.record_bytes": bytes,
+            "senpi.telemetry.frame_limit_bytes": MAX_FRAME_BYTES,
+        });
+    }
+    /**
+     * Split records into frames that each serialise under the byte budget. A record that cannot fit a
+     * frame by itself is dropped rather than sent: an oversized frame does not lose one line, it closes
+     * the client's socket with 1009 and loses the stream.
+     */
+    function toFrames(records) {
+        const frames = [];
+        let current = [];
+        let bytes = 0;
+        for (const record of records) {
+            const wire = toWireRecord(record);
+            // Bytes, not string length: the read limit is counted on the wire, and one non-ASCII
+            // character costs up to three of them.
+            const size = Buffer.byteLength(JSON.stringify(wire));
+            if (size > MAX_FRAME_BYTES) {
+                noteOversizedRecord(wire, size);
+                continue;
+            }
+            if (current.length > 0 && bytes + size > MAX_FRAME_BYTES) {
+                frames.push(current);
+                current = [];
+                bytes = 0;
+            }
+            current.push(wire);
+            bytes += size;
+        }
+        if (current.length > 0)
+            frames.push(current);
+        return frames;
+    }
+    function published(records) {
+        return records.filter((record) => PUBLISHED_EVENT_NAMES.has(record.name));
+    }
+    /** `null` when the facts could not be read — the caller decides whether to publish without them. */
+    async function readFacts() {
+        try {
+            return await options.collectFacts();
+        }
+        catch (err) {
+            // Health and state come from live runtime handles, which can be mid-teardown. A tick that
+            // cannot read them reports nothing rather than taking the stream down.
+            logger.warn("live telemetry could not read runtime facts", {
+                err: err instanceof Error ? err.message : String(err),
+            });
+            return null;
+        }
+    }
+    function buildStats(facts, sampledAt, 
+    // The whole held window, not the drained batch: buckets are computed on demand from the same
+    // records the snapshot replays.
+    records) {
+        return buildScannerStats({
+            epoch: buffer.epoch,
+            records,
+            scannerState: facts.scannerState,
+            bufferStartedAt,
+            sampledAt,
+        });
+    }
+    function buildTopology(facts) {
+        return buildStrategyTopology({
+            epoch: buffer.epoch,
+            strategies: facts.strategies,
+            runningRuntimeIds: facts.runningRuntimeIds,
+            unwiredRuntimeIds: facts.unwiredRuntimeIds,
+            readHealth: facts.readHealth,
+            now,
+        });
+    }
+    function flushTimeline() {
+        const startedAt = monotonicMs();
+        // The drain advances the publish cursor whether or not a handle exists, so a box nobody is
+        // watching does not build a backlog that lands as one flood on the first connect. The snapshot
+        // covers that client instead — `drain` evicts nothing.
+        const batch = published(buffer.drain());
+        if (batch.length > 0) {
+            withSpanSync("telemetry.publish", {}, (span) => {
+                const sendStartedAt = monotonicMs();
+                let payloadBytes = 0;
+                let recordsFlushed = 0;
+                for (const records of toFrames(batch)) {
+                    const payload = {
+                        v: 1,
+                        epoch: buffer.epoch,
+                        batchSeq: ++batchSeq,
+                        records,
+                    };
+                    // Measured on the frame handed to broadcast. A sum of record sizes is an intermediate that
+                    // omits the envelope and the separators, and those are real bytes against the read limit.
+                    const bytes = Buffer.byteLength(JSON.stringify(payload));
+                    if (!publish(EVENT_TIMELINE, payload))
+                        continue;
+                    payloadBytes += bytes;
+                    recordsFlushed += records.length;
+                }
+                span.setAttributes({
+                    records_flushed: recordsFlushed,
+                    payload_bytes: payloadBytes,
+                    broadcast_ms: monotonicMs() - sendStartedAt,
+                });
+                timelineWindow.records += recordsFlushed;
+                timelineWindow.payloadBytes += payloadBytes;
+            });
+        }
+        noteTick("timeline", monotonicMs() - startedAt, flushIntervalMs);
+        reportTiming();
+    }
+    async function sample() {
+        // A gather slower than the tick would otherwise stack ticks on top of each other.
+        if (sampleInFlight)
+            return;
+        sampleInFlight = true;
+        const startedAt = monotonicMs();
+        try {
+            const facts = await readFacts();
+            if (facts === null)
+                return;
+            const stats = withSpanSync("telemetry.stats.compute", {}, (span) => {
+                // The tap counters are read here because this is the span that carries them: reading them on
+                // the faster tick would put a one-second window on a five-second measurement.
+                const tap = readAndResetTapCounters();
+                const records = buffer.read();
+                const payload = buildStats(facts, now(), records);
+                const payloadBytes = Buffer.byteLength(JSON.stringify(payload));
+                const bucketsEmitted = payload.scanners.reduce((n, entry) => n + entry.buckets.length, 0);
+                span.setAttributes({
+                    records_scanned: records.length,
+                    scanners: payload.scanners.length,
+                    buckets_emitted: bucketsEmitted,
+                    payload_bytes: payloadBytes,
+                    tap_ns_total: tap.nsTotal,
+                    tap_calls: tap.calls,
+                    tap_ns_p_max: tap.nsMax,
+                });
+                statsWindow.recordsScanned += records.length;
+                if (payloadBytes > statsWindow.payloadBytesMax)
+                    statsWindow.payloadBytesMax = payloadBytes;
+                tapWindow.calls += tap.calls;
+                tapWindow.nsTotal += tap.nsTotal;
+                if (tap.nsMax > tapWindow.nsMax)
+                    tapWindow.nsMax = tap.nsMax;
+                return payload;
+            });
+            publish(EVENT_STATS, stats);
+            const topology = buildTopology(facts);
+            const signature = topologySignature(topology);
+            if (signature === lastTopologySignature)
+                return;
+            // Remembered only once the frame actually left. The ticks start before any client connects, so
+            // the first topology is built with no handle to send it through — recording that as delivered
+            // would suppress every later publish of a topology that then never changes again.
+            if (publish(EVENT_TOPOLOGY, topology))
+                lastTopologySignature = signature;
+        }
+        finally {
+            sampleInFlight = false;
+            // The whole tick, including the runtime read: that is what has to fit the interval, and it is
+            // the half the compute span cannot see.
+            noteTick("stats", monotonicMs() - startedAt, sampleIntervalMs);
+        }
+    }
+    return {
+        epoch: buffer.epoch,
+        captureBroadcast(ctx, methodName) {
+            if (broadcast !== undefined)
+                return;
+            const candidate = ctx?.context
+                ?.broadcast;
+            if (typeof candidate !== "function")
+                return;
+            broadcast = candidate;
+            warnedNoBroadcast = false;
+            logger.info("live telemetry captured the gateway broadcast handle", {
+                "senpi.gateway.method": methodName,
+            });
+        },
+        async snapshot(params) {
+            // A seq only means something inside its epoch. A cursor minted by a previous run names records
+            // this one never had — most sharply after a restart, where the client's seq sits far above a
+            // counter that began again at 1 and "nothing after it" would hide the whole window. So unless
+            // the cursor names this epoch it is dropped entirely and everything held is served.
+            const afterSeq = params?.afterEpoch === buffer.epoch ? normalizeAfterSeq(params?.afterSeq) : 0;
+            const held = buffer.read();
+            // A cursor below the eviction frontier lost a record. The oldest record still held cannot
+            // answer this: the rings are per address, so one strategy's untouched low seqs sit under
+            // another's evictions. `afterSeq: 0` is a fresh client asking for whatever is held, not a
+            // resume, so it is never a gap.
+            let truncated = afterSeq > 0 && buffer.highestDroppedSeq() > afterSeq;
+            const owed = published(held.filter((record) => record.seq > afterSeq));
+            const frames = toFrames(owed);
+            // A response is one frame, so an over-budget window sends the newest slice and says so.
+            const records = frames.length === 0 ? [] : frames[frames.length - 1];
+            if (frames.length > 1)
+                truncated = true;
+            // A snapshot still answers when the facts are unreadable: the recent window is the part a
+            // joining client cannot reconstruct, and it comes from the buffer alone.
+            const facts = (await readFacts()) ?? NO_FACTS;
+            const sampledAt = now();
+            return {
+                epoch: buffer.epoch,
+                topology: buildTopology(facts),
+                stats: buildStats(facts, sampledAt, held),
+                recent: { v: 1, epoch: buffer.epoch, batchSeq: ++batchSeq, records },
+                truncated,
+            };
+        },
+        flushTimeline,
+        sample,
+        start() {
+            if (flushTimer !== undefined)
+                return;
+            flushTimer = setInterval(flushTimeline, flushIntervalMs);
+            sampleTimer = setInterval(() => void sample(), sampleIntervalMs);
+            // Telemetry must never be the reason a process stays alive.
+            flushTimer.unref?.();
+            sampleTimer.unref?.();
+        },
+        stop() {
+            if (flushTimer !== undefined)
+                clearInterval(flushTimer);
+            if (sampleTimer !== undefined)
+                clearInterval(sampleTimer);
+            flushTimer = undefined;
+            sampleTimer = undefined;
+            broadcast = undefined;
+            lastTopologySignature = undefined;
+            buffer.teardown();
+            // The next reader mints a fresh epoch, so a restarted seq run cannot collide with the one a
+            // client already holds.
+            if (ownsProcessBuffer)
+                teardownTimelineBuffer();
+        },
+    };
+}
+//# sourceMappingURL=live-telemetry.js.map

package/dist/telemetry/live-telemetry.js.map

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

package/dist/telemetry/scanner-stats.d.ts

@@ -0,0 +1,136 @@
+/**
+ * The `plugin.senpi.scanner.stats` payload: per-scanner activity counters plus the per-scanner state
+ * a summary screen needs, built as one pure function of its inputs.
+ *
+ * Two halves, from two sources:
+ * - The **counters** are computed on demand by scanning the recent-window buffer — no second data
+ *   structure, no pre-aggregation on the write path, no retention setting of their own. Records are
+ *   grouped by `(address, scannerId)` and bucketed by timestamp, because `scannerId` alone collides
+ *   across strategies (the engine keys on the same pair).
+ * - The **state fields** are not derivable from records at all — health, schedule and liveness live in
+ *   the health/system-state providers — so they arrive as {@link ScannerStateSnapshot} inputs and are
+ *   joined on the same key. A scanner known to only one side still gets an entry: counters without
+ *   state read `unknown`, state without counters carries an empty bucket list.
+ *
+ * The box never picks the window. It emits fixed-width buckets and the frontend sums however many it
+ * wants, so one payload serves every client and every window at once. `since` is what makes that sum
+ * honest: it is the stamp of the oldest record still held, and when nothing is held it is the moment
+ * this epoch began watching — "I have been watching since X and nothing happened" is a different
+ * statement from "no data", and only one of them is true.
+ */
+import type { ComponentHealth } from "../health/types.js";
+import type { TimelineRecord } from "./timeline-buffer.js";
+/**
+ * Bucket width in ms. It sets two things at once: the payload cost per active scanner, and the finest
+ * window a frontend can ask for (it can sum buckets, never split one).
+ *
+ * 15s divides the windows a summary screen actually shows — 1m is 4 buckets, 5m is 20, 15m is 60 — so
+ * no rendered window ever needs a partial bucket. It is also about two ticks of the fastest scanner
+ * the runtime will schedule (built-in cadence is floored at 7s in `runtime-schema.ts`), which keeps a
+ * bucket from hiding a run while still letting "it went quiet 30 seconds ago" show up. Buckets are
+ * emitted sparsely, so an idle scanner costs nothing regardless of this value.
+ *
+ * This is the number to change once real payload sizes are measured — see also the `bucketMs` input,
+ * which overrides it per call.
+ */
+export declare const DEFAULT_BUCKET_MS = 15000;
+/**
+ * Ceiling on the buckets one payload may carry, across every scanner and every address.
+ *
+ * Buckets are the only part of this payload that grows without a bound of its own. A scanner
+ * producing one counted record per run fills one bucket per run, so a retention window of N records
+ * is N buckets on a single scanner, and every address the box runs adds its own series — the state
+ * rows do not, because there is one per registered scanner. One bucket serialises to about sixty
+ * bytes, so this budgets them at roughly 60 KiB and leaves the rest of the frame to the rows.
+ *
+ * Nothing downstream survives a breach: the bridge's north read limit is 256 KiB and exceeding it
+ * closes the client socket, which loses the stream rather than one sample.
+ *
+ * The trim cuts at a bucket boundary, so a payload may carry up to one extra bucket per scanner —
+ * splitting a timestamp across scanners would misalign the series a client sums.
+ */
+export declare const MAX_STATS_BUCKETS = 1000;
+/**
+ * The four counters, which sum to the decisions counted in the bucket. `closes` is its own field
+ * because an accepted close is none of the other three: it opened nothing, it was not declined, and
+ * nothing failed — folding it into any of them replaces one wrong number with another.
+ */
+export interface ScannerStatsBucket {
+    /** Bucket start, epoch ms, aligned to a `bucketMs` grid so buckets line up across scanners. */
+    readonly t: number;
+    readonly opens: number;
+    readonly closes: number;
+    readonly skips: number;
+    readonly errors: number;
+}
+/**
+ * One scanner's state as the health/system-state providers report it. These fields have no
+ * representation in the buffer, so the builder takes them rather than reaching into the runtime.
+ *
+ * `inFlightSince` is a timestamp, not a boolean: a scan running for 200ms is normal and one running
+ * for four minutes on a 15s interval is hung, and a boolean cannot tell those apart.
+ */
+export interface ScannerStateSnapshot {
+    readonly address: string;
+    readonly scannerId: string;
+    readonly health: ComponentHealth;
+    readonly degradedReason?: string | null;
+    readonly enabled: boolean;
+    readonly inFlightSince: number | null;
+    readonly lastRunStartedAt: number | null;
+    readonly lastRunFinishedAt: number | null;
+    readonly lastRunStatus: string | null;
+    readonly lastRunReason: string | null;
+    readonly nextRunAt: number | null;
+    readonly lastAliveAt: number | null;
+    /** Null when no supervision row covers this scanner — a known zero is a different statement. */
+    readonly restartCount: number | null;
+}
+/**
+ * One scanner on the wire. `scannerId` is absent — not null — when the records could not be
+ * attributed to a scanner; the client buckets those separately rather than seeing them folded into a
+ * named scanner's numbers. Every state field is `null` when no snapshot covers this scanner, which is
+ * a different statement from a known `false` or a known `0`.
+ */
+export interface ScannerStatsEntry {
+    readonly address: string;
+    readonly scannerId?: string;
+    readonly health: ComponentHealth;
+    readonly degradedReason: string | null;
+    readonly enabled: boolean | null;
+    readonly inFlightSince: number | null;
+    readonly lastRunStartedAt: number | null;
+    readonly lastRunFinishedAt: number | null;
+    readonly lastRunStatus: string | null;
+    readonly lastRunReason: string | null;
+    readonly nextRunAt: number | null;
+    readonly lastAliveAt: number | null;
+    readonly restartCount: number | null;
+    /** Only buckets with activity, ascending by `t`. A gap means zero, not missing. */
+    readonly buckets: ScannerStatsBucket[];
+}
+export interface ScannerStatsPayload {
+    readonly v: 1;
+    readonly epoch: string;
+    readonly sampledAt: number;
+    /** Oldest record still held, or the buffer's start time when nothing is held. Never absent. */
+    readonly since: number;
+    readonly bucketMs: number;
+    readonly scanners: ScannerStatsEntry[];
+}
+export interface BuildScannerStatsInput {
+    /** The buffer's epoch ULID. A change means the box restarted. */
+    readonly epoch: string;
+    /** Every record the counters are derived from — the buffer's full held window. */
+    readonly records: readonly TimelineRecord[];
+    /** Per-scanner state from the health/system-state providers. */
+    readonly scannerState: readonly ScannerStateSnapshot[];
+    /** When this epoch began watching. Used as `since` only while the buffer holds nothing. */
+    readonly bufferStartedAt: number;
+    readonly sampledAt: number;
+    /** Overrides {@link DEFAULT_BUCKET_MS}. Ignored unless it is a finite width of at least 1ms. */
+    readonly bucketMs?: number;
+}
+/** Build one `plugin.senpi.scanner.stats` payload. Pure: no timers, no clocks, no runtime reads. */
+export declare function buildScannerStats(input: BuildScannerStatsInput): ScannerStatsPayload;
+//# sourceMappingURL=scanner-stats.d.ts.map

package/dist/telemetry/scanner-stats.d.ts.map

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