@senpi/runtime 3.0.102 → 3.0.106

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

@@ -1,136 +0,0 @@
-/**
- * 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

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

package/dist/telemetry/scanner-stats.js

@@ -1,304 +0,0 @@
-/**
- * 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 { normalizeStrategyAddress } from "./event-store.js";
-import { createLogger } from "../utils/logger.js";
-const logger = createLogger("[senpi-core][scanner-stats]");
-/**
- * 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 const DEFAULT_BUCKET_MS = 15_000;
-/**
- * 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 const MAX_STATS_BUCKETS = 1_000;
-/** The one event carrying an action decision, one record per evaluation. */
-const OUTCOME_EVENT = "signal.outcome";
-/** Scanner-side tick failures: the scanner produced nothing, and that is not a decision. */
-const ERROR_EVENTS = new Set(["scaffold.tick_error", "scaffold.tick_timeout"]);
-const ATTR_OUTCOME_RESULT = "senpi.outcome.result";
-const ATTR_ACTION_TYPE = "senpi.action.type";
-const ATTR_SCANNER_NAME = "senpi.scanner.name";
-const ATTR_SCANNER_ID = "senpi.scanner.id";
-/** The only disposition meaning an order was actually placed — of either kind. */
-const RESULT_ACCEPTED = "accepted";
-/** The disposition meaning the attempt itself failed. */
-const RESULT_ERROR = "error";
-/** The producer's closed disposition set; anything outside it is drift worth a warning. */
-const KNOWN_RESULTS = new Set([RESULT_ACCEPTED, "rejected", "blocked", RESULT_ERROR]);
-/** The `ActionType` values that tell an accepted order which bucket it belongs in. */
-const ACTION_OPEN = "OPEN_POSITION";
-const ACTION_CLOSE = "CLOSE_POSITION";
-/** Separates the two halves of a group key. Never appears in a wallet or a scanner id. */
-const KEY_SEP = "\u0000";
-/**
- * Distinct unrecognised dispositions already warned about, process-wide. Keyed by value rather than
- * one-shot so a second kind of drift is still reported, and never per record — the flush tick can
- * carry thousands of them.
- */
-const warnedResults = new Set();
-/** The same, for action types. The empty string keys an outcome that carried none. */
-const warnedActionTypes = new Set();
-/**
- * The worst overflow warned about so far. A box permanently over the cap would otherwise warn on
- * every sample tick, and one that is getting worse would otherwise say so only once.
- */
-let warnedBucketOverflow = 0;
-function key(address, scannerId) {
-    return `${address}${KEY_SEP}${scannerId ?? ""}`;
-}
-/**
- * Rule 1: `senpi.scanner.id` carries the stable id on `signal.outcome` but the ephemeral, per-spawn id
- * on the scaffold tick events, where the stable value rides `senpi.scanner.name`. Reading the id
- * unqualified splits one scanner into two on every restart. The tap resolves this; the fallback here
- * keeps a record whose tap did not from landing in the unattributed bucket.
- */
-function resolveScannerId(record) {
-    if (typeof record.scannerId === "string" && record.scannerId !== "")
-        return record.scannerId;
-    const name = record.attrs?.[ATTR_SCANNER_NAME];
-    if (typeof name === "string" && name !== "")
-        return name;
-    const id = record.attrs?.[ATTR_SCANNER_ID];
-    if (typeof id === "string" && id !== "")
-        return id;
-    return undefined;
-}
-function warnUnknownResult(result) {
-    if (warnedResults.has(result))
-        return;
-    warnedResults.add(result);
-    logger.warn("signal.outcome carried an unrecognised disposition; counting it as a skip", {
-        [ATTR_OUTCOME_RESULT]: result,
-    });
-}
-function warnUnknownActionType(actionType) {
-    if (warnedActionTypes.has(actionType))
-        return;
-    warnedActionTypes.add(actionType);
-    logger.warn("an accepted signal.outcome named no action type this counter knows; counting it as an open", {
-        [ATTR_ACTION_TYPE]: actionType === "" ? "(absent)" : actionType,
-    });
-}
-/**
- * Which of the two order buckets an accepted outcome feeds.
- *
- * `closes` is asserted positively — a close is the case that has to be proven, because everything
- * that is not a close reads as it always did. An action type that is unrecognised, or absent (the
- * producer omits the attribute rather than stamping a placeholder that would poison a counter),
- * therefore counts as an open: it is the incumbent reading, it keeps the four counters summing to
- * the decisions counted, and it is warned about once per distinct value so the drift is findable
- * rather than dropped or silently folded away.
- */
-function acceptedCounter(record) {
-    const raw = record.attrs?.[ATTR_ACTION_TYPE];
-    const actionType = typeof raw === "string" ? raw : "";
-    if (actionType === ACTION_CLOSE)
-        return "closes";
-    if (actionType !== ACTION_OPEN)
-        warnUnknownActionType(actionType);
-    return "opens";
-}
-/**
- * Which counter a record feeds, or `null` when it feeds none.
- *
- * An order leaving the box is asserted positively: `accepted` is the single disposition that means
- * one did (`disposition()` in `event-builders.ts` maps the executed result to it), and the action
- * type then says whether it opened a position or closed one. Everything else that reached a decision
- * placed no order, so `rejected` (actively gated) and `blocked` (not attempted) both read as a skip,
- * and so does any value the producer adds later — an unrecognised disposition is warned about rather
- * than silently dropped, because opens + closes + skips + errors must stay equal to the decisions
- * counted or the four numbers cannot be read together.
- *
- * A failed attempt is an `error`, not an open or a close (nothing was placed) and not a skip (it was
- * not declined) — which is as true of a close as of an open, so the action type splits the accepted
- * case only. The scaffold tick failures land in the same counter: from the summary screen both mean
- * the scanner lost work to a fault.
- */
-function classify(record) {
-    if (ERROR_EVENTS.has(record.name))
-        return "errors";
-    if (record.name !== OUTCOME_EVENT)
-        return null;
-    const raw = record.attrs?.[ATTR_OUTCOME_RESULT];
-    const result = typeof raw === "string" ? raw : "";
-    if (result === RESULT_ACCEPTED)
-        return acceptedCounter(record);
-    if (result === RESULT_ERROR)
-        return "errors";
-    if (!KNOWN_RESULTS.has(result))
-        warnUnknownResult(result);
-    return "skips";
-}
-/**
- * The oldest bucket start the payload may keep, or undefined when everything fits. Chosen so the
- * kept buckets number at most {@link MAX_STATS_BUCKETS}, cut on a timestamp so every scanner's
- * series starts at the same place.
- */
-function trimCutoff(groups) {
-    const starts = [];
-    for (const group of groups)
-        for (const t of group.buckets.keys())
-            starts.push(t);
-    if (starts.length <= MAX_STATS_BUCKETS)
-        return undefined;
-    starts.sort((a, b) => b - a);
-    const cutoff = starts[MAX_STATS_BUCKETS - 1];
-    const dropped = starts.filter((t) => t < cutoff).length;
-    if (dropped > warnedBucketOverflow) {
-        warnedBucketOverflow = dropped;
-        logger.warn("scanner stats dropped its oldest buckets to keep the payload inside one frame", {
-            "senpi.telemetry.buckets_dropped": dropped,
-            "senpi.telemetry.buckets_kept": starts.length - dropped,
-            "senpi.telemetry.bucket_limit": MAX_STATS_BUCKETS,
-        });
-    }
-    return cutoff;
-}
-function resolveBucketMs(requested) {
-    if (requested === undefined)
-        return DEFAULT_BUCKET_MS;
-    // A zero or negative width makes every bucket key Infinity or NaN, which would collapse the whole
-    // series into one unreadable bucket rather than fail loudly.
-    return Number.isFinite(requested) && requested >= 1 ? Math.floor(requested) : DEFAULT_BUCKET_MS;
-}
-function groupFor(groups, address, scannerId) {
-    const k = key(address, scannerId);
-    let group = groups.get(k);
-    if (group === undefined) {
-        group = { address, ...(scannerId !== undefined ? { scannerId } : {}), buckets: new Map() };
-        groups.set(k, group);
-    }
-    return group;
-}
-/** Address, then scanner id, with the unattributed entry last so it reads as a footnote. */
-function compareEntries(a, b) {
-    if (a.address !== b.address)
-        return a.address < b.address ? -1 : 1;
-    if (a.scannerId === b.scannerId)
-        return 0;
-    if (a.scannerId === undefined)
-        return 1;
-    if (b.scannerId === undefined)
-        return -1;
-    return a.scannerId < b.scannerId ? -1 : 1;
-}
-function toEntry(group, snapshot, cutoff) {
-    const buckets = [...group.buckets.entries()]
-        .filter(([t]) => cutoff === undefined || t >= cutoff)
-        .sort(([a], [b]) => a - b)
-        .map(([t, counts]) => ({
-        t,
-        opens: counts.opens,
-        closes: counts.closes,
-        skips: counts.skips,
-        errors: counts.errors,
-    }));
-    return {
-        address: group.address,
-        ...(group.scannerId !== undefined ? { scannerId: group.scannerId } : {}),
-        health: snapshot?.health ?? "unknown",
-        degradedReason: snapshot?.degradedReason ?? null,
-        enabled: snapshot?.enabled ?? null,
-        inFlightSince: snapshot?.inFlightSince ?? null,
-        lastRunStartedAt: snapshot?.lastRunStartedAt ?? null,
-        lastRunFinishedAt: snapshot?.lastRunFinishedAt ?? null,
-        lastRunStatus: snapshot?.lastRunStatus ?? null,
-        lastRunReason: snapshot?.lastRunReason ?? null,
-        nextRunAt: snapshot?.nextRunAt ?? null,
-        lastAliveAt: snapshot?.lastAliveAt ?? null,
-        restartCount: snapshot?.restartCount ?? null,
-        buckets,
-    };
-}
-/** Build one `plugin.senpi.scanner.stats` payload. Pure: no timers, no clocks, no runtime reads. */
-export function buildScannerStats(input) {
-    const bucketMs = resolveBucketMs(input.bucketMs);
-    const groups = new Map();
-    const snapshots = new Map();
-    // Seeded first so a scanner the providers know about still gets an entry when it has produced
-    // nothing — a silent scanner is a fact the summary screen must be able to show.
-    for (const snapshot of input.scannerState) {
-        const address = normalizeStrategyAddress(snapshot.address);
-        snapshots.set(key(address, snapshot.scannerId), snapshot);
-        groupFor(groups, address, snapshot.scannerId);
-    }
-    let oldest;
-    for (const record of input.records) {
-        const ts = record.ts;
-        if (!Number.isFinite(ts))
-            continue;
-        // `since` tracks every held record, not only the counted ones: it describes the window the client
-        // is reading, which is the whole buffer.
-        if (oldest === undefined || ts < oldest)
-            oldest = ts;
-        const counter = classify(record);
-        if (counter === null)
-            continue;
-        const group = groupFor(groups, normalizeStrategyAddress(record.address), resolveScannerId(record));
-        const t = Math.floor(ts / bucketMs) * bucketMs;
-        let counts = group.buckets.get(t);
-        if (counts === undefined) {
-            counts = { opens: 0, closes: 0, skips: 0, errors: 0 };
-            group.buckets.set(t, counts);
-        }
-        counts[counter] += 1;
-    }
-    const cutoff = trimCutoff(groups.values());
-    const scanners = [...groups.entries()]
-        .map(([k, group]) => toEntry(group, snapshots.get(k), cutoff))
-        .sort(compareEntries);
-    // A broken start time must not put a non-finite `since` on the wire — it serialises to null and
-    // the client's truncation check silently stops working.
-    const held = oldest ?? (Number.isFinite(input.bufferStartedAt) ? input.bufferStartedAt : input.sampledAt);
-    return {
-        v: 1,
-        epoch: input.epoch,
-        sampledAt: input.sampledAt,
-        // `since` labels the counters, so a trim moves it: the buckets no longer reach back to the
-        // oldest record held, and a client summing them from an older mark would read the gap as zeros.
-        since: cutoff !== undefined && cutoff > held ? cutoff : held,
-        bucketMs,
-        scanners,
-    };
-}
-//# sourceMappingURL=scanner-stats.js.map

package/dist/telemetry/scanner-stats.js.map

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

package/dist/telemetry/strategy-topology.d.ts

@@ -1,99 +0,0 @@
-/**
- * Builder for the `plugin.senpi.strategies` payload — the topology view of the live telemetry
- * stream: which strategies exist, whether each is up, how healthy it is, and which scanners it
- * declares.
- *
- * Pure. Every fact arrives as an input, nothing is read from the registry or a runtime handle here,
- * so the shape on the wire is testable without booting a runtime.
- *
- * Two properties this module exists to hold:
- * - `status` distinguishes a runtime that is down from one that is up but has no live entry
- *   scanners. The second reads as healthy unless it is named, and it is not.
- * - The raw scanner `config` never reaches the wire. It is an unbounded passthrough record and it
- *   has been through `resolveEnvInObject`, so it may hold resolved secrets. Only the declared,
- *   typed fields below are copied, each by name.
- */
-import type { ComponentHealth } from "../health/types.js";
-import type { RuntimeScanner } from "../runtime/runtime-schema.js";
-/** Payload schema version. Bump when a field changes meaning, not when one is added. */
-export declare const STRATEGY_TOPOLOGY_VERSION = 1;
-/**
- * `stopped` — no runtime handle.
- * `running_no_entry_scanners` — up, but its declared external scanners never wired, so it produces
- * no entry signals.
- * `running` — up and wired.
- */
-export type StrategyStatus = "running" | "stopped" | "running_no_entry_scanners";
-/** Membership test satisfied by both a `Map` and a `Set` — the two shapes the plugin holds. */
-export interface IdMembership {
-    has(id: string): boolean;
-}
-/** Engine registration facts for one scanner. Absent when the runtime has no live handle. */
-export interface TopologyScannerRegistration {
-    enabled: boolean;
-    scheduleMode: "interval" | "external";
-    intervalSeconds: number | null;
-    configVersion: number | null;
-}
-export interface TopologyScannerSource {
-    /**
-     * The parsed YAML scanner entry. Only `name`, `type`, `interval_seconds` and
-     * `signal_data_schema` are ever read from it — `config`, `advanced`, `inputs` and any
-     * passthrough key stay off the wire.
-     */
-    entry: RuntimeScanner;
-    registration?: TopologyScannerRegistration;
-}
-export interface TopologyStrategySource {
-    runtimeId: string;
-    /** The config wallet as written. Normalized to the wire form by the builder — see below. */
-    address: string;
-    name: string;
-    scanners: TopologyScannerSource[];
-}
-/** The slice of `RuntimeHealthStatus` the topology reads. `startedAt` is ISO, as health emits it. */
-export interface RuntimeHealthLike {
-    health: ComponentHealth;
-    startedAt?: string;
-}
-export interface BuildStrategyTopologyInput {
-    /** The buffer's epoch ULID. A change means the plugin restarted. */
-    epoch: string;
-    strategies: TopologyStrategySource[];
-    /** Runtimes holding a live handle. Everything else is stopped. */
-    runningRuntimeIds: IdMembership;
-    /** Runtimes that are up but whose entry scanners never wired. */
-    unwiredRuntimeIds: IdMembership;
-    /** Per-runtime health lookup, keyed on `runtimeId` the way `senpi.getHealthStatus` keys. */
-    readHealth?: (runtimeId: string) => RuntimeHealthLike | undefined;
-    /** Injectable clock for deterministic tests. */
-    now?: () => number;
-}
-export interface StrategyTopologyScanner {
-    /** The engine id — the YAML `name:` field. Unique within a runtime, not across runtimes. */
-    scannerId: string;
-    scheduleMode: "interval" | "external";
-    enabled: boolean;
-    intervalSeconds: number | null;
-    configVersion: number | null;
-    signalDataSchema: Record<string, unknown> | null;
-}
-export interface StrategyTopologyEntry {
-    runtimeId: string;
-    address: string;
-    name: string;
-    status: StrategyStatus;
-    health: ComponentHealth;
-    /** Epoch ms, converted from health's ISO stamp; null when health is unavailable. */
-    startedAt: number | null;
-    scanners: StrategyTopologyScanner[];
-}
-export interface StrategyTopologyPayload {
-    v: number;
-    epoch: string;
-    generatedAt: number;
-    strategies: StrategyTopologyEntry[];
-}
-/** Builds one `plugin.senpi.strategies` payload from an already-gathered set of facts. */
-export declare function buildStrategyTopology(input: BuildStrategyTopologyInput): StrategyTopologyPayload;
-//# sourceMappingURL=strategy-topology.d.ts.map

package/dist/telemetry/strategy-topology.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"strategy-topology.d.ts","sourceRoot":"","sources":["../../src/telemetry/strategy-topology.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAInE,wFAAwF;AACxF,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,2BAA2B,CAAC;AAEjF,+FAA+F;AAC/F,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,6FAA6F;AAC7F,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,UAAU,GAAG,UAAU,CAAC;IACtC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,KAAK,EAAE,cAAc,CAAC;IACtB,YAAY,CAAC,EAAE,2BAA2B,CAAC;CAC5C;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED,qGAAqG;AACrG,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,kEAAkE;IAClE,iBAAiB,EAAE,YAAY,CAAC;IAChC,iEAAiE;IACjE,iBAAiB,EAAE,YAAY,CAAC;IAChC,4FAA4F;IAC5F,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAC;IAClE,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,4FAA4F;IAC5F,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,UAAU,GAAG,UAAU,CAAC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,oFAAoF;IACpF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,uBAAuB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB;IACtC,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAwDD,0FAA0F;AAC1F,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAChC,uBAAuB,CAwBzB"}

package/dist/telemetry/strategy-topology.js

@@ -1,93 +0,0 @@
-/**
- * Builder for the `plugin.senpi.strategies` payload — the topology view of the live telemetry
- * stream: which strategies exist, whether each is up, how healthy it is, and which scanners it
- * declares.
- *
- * Pure. Every fact arrives as an input, nothing is read from the registry or a runtime handle here,
- * so the shape on the wire is testable without booting a runtime.
- *
- * Two properties this module exists to hold:
- * - `status` distinguishes a runtime that is down from one that is up but has no live entry
- *   scanners. The second reads as healthy unless it is named, and it is not.
- * - The raw scanner `config` never reaches the wire. It is an unbounded passthrough record and it
- *   has been through `resolveEnvInObject`, so it may hold resolved secrets. Only the declared,
- *   typed fields below are copied, each by name.
- */
-import { createLogger } from "../utils/logger.js";
-import { normalizeStrategyAddress } from "./event-store.js";
-const logger = createLogger("[senpi-core][strategy-topology]");
-/** Payload schema version. Bump when a field changes meaning, not when one is added. */
-export const STRATEGY_TOPOLOGY_VERSION = 1;
-/**
- * Mirrors the three-way distinction `senpi.listRuntimes` draws: no handle is stopped, a handle in
- * the unwired set is running blind, anything else is running. The wire carries the machine token —
- * the operator-facing string is the frontend's to choose.
- */
-function resolveStatus(runtimeId, running, unwired) {
-    if (!running.has(runtimeId))
-        return "stopped";
-    return unwired.has(runtimeId) ? "running_no_entry_scanners" : "running";
-}
-/** Health is advisory here: a lookup that fails must degrade the row, never the payload. */
-function resolveHealth(runtimeId, readHealth) {
-    let status;
-    try {
-        status = readHealth?.(runtimeId);
-    }
-    catch (err) {
-        logger.warn("strategy topology could not read runtime health; reporting unknown", err, {
-            runtimeId,
-        });
-        return { health: "unknown", startedAt: null };
-    }
-    if (!status)
-        return { health: "unknown", startedAt: null };
-    const parsed = status.startedAt === undefined ? NaN : Date.parse(status.startedAt);
-    return {
-        health: status.health,
-        startedAt: Number.isFinite(parsed) ? parsed : null,
-    };
-}
-/**
- * Copies the declared scanner fields one by one. Never spread `entry` and never copy `config` —
- * see the module note.
- */
-function buildScanner(source) {
-    const { entry, registration } = source;
-    const declaredSchema = entry.signal_data_schema;
-    return {
-        scannerId: entry.name,
-        scheduleMode: registration?.scheduleMode ?? (entry.type === "external_scanner" ? "external" : "interval"),
-        enabled: registration?.enabled ?? true,
-        intervalSeconds: registration?.intervalSeconds ?? entry.interval_seconds ?? null,
-        configVersion: registration?.configVersion ?? null,
-        signalDataSchema: declaredSchema ?? null,
-    };
-}
-/** Builds one `plugin.senpi.strategies` payload from an already-gathered set of facts. */
-export function buildStrategyTopology(input) {
-    const now = input.now ?? Date.now;
-    const strategies = input.strategies.map((source) => {
-        const { health, startedAt } = resolveHealth(source.runtimeId, input.readHealth);
-        return {
-            runtimeId: source.runtimeId,
-            // `(address, scannerId)` is the join key across all four payloads, and the other three
-            // normalize their own address input. A checksummed EIP-55 wallet reaching the wire raw would
-            // spell this strategy differently from its own scanner rows and timeline rows, and nothing
-            // downstream rejects that — the join just returns nothing.
-            address: normalizeStrategyAddress(source.address),
-            name: source.name,
-            status: resolveStatus(source.runtimeId, input.runningRuntimeIds, input.unwiredRuntimeIds),
-            health,
-            startedAt,
-            scanners: source.scanners.map(buildScanner),
-        };
-    });
-    return {
-        v: STRATEGY_TOPOLOGY_VERSION,
-        epoch: input.epoch,
-        generatedAt: now(),
-        strategies,
-    };
-}
-//# sourceMappingURL=strategy-topology.js.map