@senpi/runtime 3.0.135 → 3.0.139

package/dist/telemetry/scanner-tick-feed.d.ts

@@ -1,87 +0,0 @@
-/**
- * The seam between a finished scanner run and the live-telemetry publisher.
- *
- * The scanner runtime module is built per strategy, deep inside a runtime, and the publisher is one
- * object created once per plugin process. Neither holds a handle to the other, so the connection is a
- * process-global sink — the same shape the timeline buffer and the domain-event sinks already use.
- *
- * What travels over it is a LEVEL, not a record: the most recent state of a scanner, published so a
- * dashboard can show that a quiet box is alive. It is deliberately not routed through
- * `logger.event` — see {@link ../utils/telemetry-required-log.js} — because every event also reaches
- * `appendDomainEvent`, whose on-disk ring and bounded publisher buffer hold real decision records that
- * a per-tick fact would evict. Nothing here writes to either.
- *
- * Two properties this module exists to guarantee:
- * - With no sink registered the call is one comparison and a return. A box whose telemetry never
- *   started pays nothing per scan, and nothing is built at the call site either: the run object the
- *   terminal callback already holds is passed straight through.
- * - A sink that throws is swallowed. This runs inside the scanner's terminal callback, and a failure
- *   in telemetry cannot be allowed to break a scan.
- */
-import type { TickCall, TickCommitOutcome } from "./tick-frame.js";
-/**
- * What a producer outside this process reports about its own tick, on top of what the run itself
- * says. An internal scanner supplies none of it; a supervised external scanner supplies what its
- * scaffold measured, carried in over the intake POST that scanner already makes every tick.
- *
- * Every field is optional and ABSENT means UNKNOWN. None may be defaulted to zero anywhere on the
- * way to the wire: "made no MCP calls" and "did not say" are different facts about a scanner.
- */
-export interface ScannerTickExtras {
-    /** MCP failures the author's own `except` caught and did not re-raise. */
-    mcpFailures?: number;
-    /** Every MCP call the tick made, succeeded or failed, as the boundary timed it. */
-    mcpCalls?: readonly TickCall[];
-    /** Total time inside MCP this tick. */
-    mcpMs?: number;
-    /** Consecutive ticks, this one included, that produced no signal. */
-    quietTicks?: number;
-    /** Actual gap since the previous tick minus the configured interval. */
-    lagMs?: number;
-    /** Signals from earlier ticks still awaiting delivery in the producer's journal. */
-    journalPending?: number;
-    /** How the tick's state commit ended. `committed` is the normal case and is not published. */
-    commit?: TickCommitOutcome;
-    /** The last COMMITTED state row — stale by one tick whenever the current tick failed. */
-    state?: Readonly<Record<string, unknown>>;
-    /** Fields in that row before sanitising, so the drop stays countable. */
-    stateFieldCount?: number;
-    /** Fields in that row whose value moved since the previously reported row. */
-    stateChangedCount?: number;
-}
-/**
- * The subset of a finished run a tick carries. Structural on purpose, so the engine's own `ScanResult`
- * satisfies it without conversion and this module needs no import from the scanner subsystem.
- */
-export interface ScannerRunFacts {
-    address: string;
-    scannerId: string;
-    /** Run status as the terminal callback reports it — the same value the required log calls `outcome`. */
-    status: string;
-    /** The run's own signals. Absent for a producer that reports a count and holds no array. */
-    signals?: readonly unknown[];
-    /** Signals produced, when the producer counts them rather than handing them over. */
-    signalCount?: number;
-    /** Candidates evaluated. Absent on a run that never evaluated any; never zero as a stand-in. */
-    scannedCount?: number;
-    /** What the producer measured about the tick itself. Absent for an in-process scanner. */
-    tick?: ScannerTickExtras;
-}
-/**
- * `startedAt` is the run's own start and is absent for a run that never began, in which case no
- * duration may be claimed for it. `finishedAt` is the module clock at the terminal callback.
- */
-export type ScannerTickSink = (run: ScannerRunFacts, startedAt: number | undefined, finishedAt: number) => void;
-/**
- * Whether anything is listening.
- *
- * For a caller that has to BUILD the run before it can hand it over — the intake routes, which
- * translate a producer's wire facts — so an unwatched box allocates nothing per tick instead of
- * building an object for a sink that is null.
- */
-export declare function hasScannerTickSink(): boolean;
-/** Arm or release the process sink. The publisher arms it on start and releases it on stop. */
-export declare function setScannerTickSink(next: ScannerTickSink | null): void;
-/** Hand one finished run to the publisher, if one is listening. Never throws. */
-export declare function recordScannerTick(run: ScannerRunFacts, startedAt: number | undefined, finishedAt: number): void;
-//# sourceMappingURL=scanner-tick-feed.d.ts.map

package/dist/telemetry/scanner-tick-feed.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scanner-tick-feed.d.ts","sourceRoot":"","sources":["../../src/telemetry/scanner-tick-feed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC/B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,yFAAyF;IACzF,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1C,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,wGAAwG;IACxG,MAAM,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gGAAgG;IAChG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,eAAe,EACpB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,KACf,IAAI,CAAC;AAIV;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,+FAA+F;AAC/F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAErE;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,eAAe,EACpB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,GACjB,IAAI,CAQN"}

package/dist/telemetry/scanner-tick-feed.js

@@ -1,48 +0,0 @@
-/**
- * The seam between a finished scanner run and the live-telemetry publisher.
- *
- * The scanner runtime module is built per strategy, deep inside a runtime, and the publisher is one
- * object created once per plugin process. Neither holds a handle to the other, so the connection is a
- * process-global sink — the same shape the timeline buffer and the domain-event sinks already use.
- *
- * What travels over it is a LEVEL, not a record: the most recent state of a scanner, published so a
- * dashboard can show that a quiet box is alive. It is deliberately not routed through
- * `logger.event` — see {@link ../utils/telemetry-required-log.js} — because every event also reaches
- * `appendDomainEvent`, whose on-disk ring and bounded publisher buffer hold real decision records that
- * a per-tick fact would evict. Nothing here writes to either.
- *
- * Two properties this module exists to guarantee:
- * - With no sink registered the call is one comparison and a return. A box whose telemetry never
- *   started pays nothing per scan, and nothing is built at the call site either: the run object the
- *   terminal callback already holds is passed straight through.
- * - A sink that throws is swallowed. This runs inside the scanner's terminal callback, and a failure
- *   in telemetry cannot be allowed to break a scan.
- */
-let sink = null;
-/**
- * Whether anything is listening.
- *
- * For a caller that has to BUILD the run before it can hand it over — the intake routes, which
- * translate a producer's wire facts — so an unwatched box allocates nothing per tick instead of
- * building an object for a sink that is null.
- */
-export function hasScannerTickSink() {
-    return sink !== null;
-}
-/** Arm or release the process sink. The publisher arms it on start and releases it on stop. */
-export function setScannerTickSink(next) {
-    sink = next;
-}
-/** Hand one finished run to the publisher, if one is listening. Never throws. */
-export function recordScannerTick(run, startedAt, finishedAt) {
-    const current = sink;
-    if (current === null)
-        return;
-    try {
-        current(run, startedAt, finishedAt);
-    }
-    catch {
-        // A telemetry-side failure must never disturb the scan that produced the tick.
-    }
-}
-//# sourceMappingURL=scanner-tick-feed.js.map

package/dist/telemetry/scanner-tick-feed.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"scanner-tick-feed.js","sourceRoot":"","sources":["../../src/telemetry/scanner-tick-feed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAgEH,IAAI,IAAI,GAA2B,IAAI,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,KAAK,IAAI,CAAC;AACvB,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,kBAAkB,CAAC,IAA4B;IAC7D,IAAI,GAAG,IAAI,CAAC;AACd,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAC/B,GAAoB,EACpB,SAA6B,EAC7B,UAAkB;IAElB,MAAM,OAAO,GAAG,IAAI,CAAC;IACrB,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO;IAC7B,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,+EAA+E;IACjF,CAAC;AACH,CAAC"}

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

package/dist/telemetry/strategy-topology.js.map

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

package/dist/telemetry/telemetry-publisher.d.ts

@@ -1,83 +0,0 @@
-/**
- * The producer tap for the live telemetry stream: a second {@link EventSink} that copies selected
- * `logger.event` records into the in-memory {@link TimelineBuffer} while the on-disk ring keeps
- * receiving every one of them. It sits on the serial trading path, so it resolves the scanner id,
- * picks a fixed set of fields, appends, and returns — no I/O, no await, no counting, no serialization.
- *
- * Two lists govern the stream, and this module owns only the first:
- * - ADMISSION ({@link ADMITTED_EVENT_NAMES}) — what enters the buffer. Every name the timeline
- *   displays PLUS every name a counter is derived from, because a counting source that never enters
- *   the buffer makes the stats read zero with nothing logged anywhere.
- * - PUBLICATION — what leaves on the timeline event. Applied at flush time, not here. Admission is
- *   deliberately the wider of the two: filtering for display at append time is unrecoverable.
- */
-import { type EventName } from "../utils/event-catalog.js";
-import { type EventSink } from "./event-store.js";
-import { type TimelineBuffer } from "./timeline-buffer.js";
-/**
- * The names that may enter the buffer. Volume control for a bounded ring, so it is an allow-list of
- * the strategy's own narrative: what its scanners did, what each signal became, what was traded, how
- * the exit engine defended an open position, and why the strategy's status changed. It excludes the
- * box-operations and agent-plane families — `auto_update.*`, `tool.*`, `tool_approval.*`, the
- * installer and the state/mcp faults — which describe the box the strategy runs on, not the
- * strategy.
- *
- * The whole `dsl.*` family is admitted, the four records of the engine acting on money included: a
- * stop that moved, a close it is waiting on, the attempt that performs the close, and a position it
- * can no longer price. None of them is poll-frequency. A `dsl.sl_updated` follows a venue write that
- * `shouldSyncExchangeSl` allowed — a stop that is missing, a sync retrying, a phase or tier change,
- * or a floor that moved further than `slSyncMinDeltaForPrice` — and a position the backend owns
- * emits none at all. `dsl.price_fetch_stale` is latched on the position state and re-armed only when
- * a price returns, so a stall costs one record rather than one per failed poll, and the close pair
- * fires once in a position's life. Against a ring holding `DEFAULT_MAX_RECORDS_PER_ADDRESS` records
- * per address over a window measured in minutes, that volume evicts nothing — and a reader watching
- * a trade has to be able to see the stop move.
- *
- * `dsl.tick_aborted` and `dsl.tick_recovered` are the widest of the family and the cheapest: a tick
- * that aborts at the clearinghouse gate evaluates NO position on the box, and the per-position
- * counters that `dsl.price_fetch_stale` is derived from sit past that gate, so without this pair the
- * largest blind spot in the engine reaches the ring as nothing at all. Both are latched on the
- * monitor and re-armed only by a completed tick, so an outage of any length costs exactly two
- * records — a floor under the pair's volume that no poll frequency can lift.
- *
- * `dsl.close_attempt` has no `logger.event` behind it: it is a span the monitor opens around the
- * venue call, so admitting the name reserves it rather than adding records.
- *
- * Typed as `EventName`, so renaming a catalog entry out from under this list is a compile error
- * rather than a silently empty counter.
- */
-export declare const ADMITTED_EVENT_NAMES: ReadonlySet<EventName>;
-/**
- * What the tap cost, in nanoseconds, since the last read. Two plain numbers and a maximum — no span,
- * no histogram, no allocation: a span per event is exactly the blocking cost the buffer exists to
- * avoid, and this sits on the same serial trading path the records describe.
- */
-export interface TapCounters {
-    /** Tap invocations, admitted or not: the admission check is cost the trading path already paid. */
-    calls: number;
-    nsTotal: number;
-    /** The longest single call. An average hides the one append that had to evict. */
-    nsMax: number;
-}
-/**
- * Take the window and zero it. The reader owns the window: a counter that is never reset reports a
- * lifetime total forever, which sizes nothing. Process-wide, like the buffer the tap feeds.
- */
-export declare function readAndResetTapCounters(): TapCounters;
-export interface TelemetryPublisherOptions {
-    /** Buffer to feed. Defaults to the process buffer — one per process, shared by every address. */
-    buffer?: TimelineBuffer;
-}
-/**
- * A sink that copies admitted records into the timeline buffer under `address`. One instance per
- * registered address; every instance writes into the same process buffer, which is what makes the
- * publisher process-wide and address-partitioned rather than per-runtime.
- */
-export declare function createTelemetryPublisherSink(address: string, options?: TelemetryPublisherOptions): EventSink;
-/**
- * One sink that feeds several. `registerEventSink` keys a single sink per address, so this is how
- * the publisher rides alongside the on-disk ring instead of replacing it. Each branch already
- * swallows its own failures; the loop keeps one branch's throw from starving the rest regardless.
- */
-export declare function createFanOutEventSink(sinks: readonly EventSink[]): EventSink;
-//# sourceMappingURL=telemetry-publisher.d.ts.map

package/dist/telemetry/telemetry-publisher.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"telemetry-publisher.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry-publisher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEvF,OAAO,EAA4B,KAAK,SAAS,EAAoB,MAAM,kBAAkB,CAAC;AAC9F,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAS9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,SAAS,CA4DtD,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,mGAAmG;IACnG,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;CACf;AAMD;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,WAAW,CAMrD;AASD,MAAM,WAAW,yBAAyB;IACxC,iGAAiG;IACjG,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAqCD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,yBAA8B,GACtC,SAAS,CAkDX;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAuB5E"}