@senpi/runtime 3.0.102 → 3.0.106

package/dist/actions/skipped-signal-results.js

@@ -1,47 +0,0 @@
-/**
- * Per-signal `results[]` rows synthesized for a batch-level early exit — the exits that return
- * before the per-signal loop and would otherwise leave the scan's signals with no recorded outcome.
- * Entry shape matches the loop's own rows so the derived per-signal telemetry is identical in
- * structure: normalized `dex`, `direction`/`score` only when usable, and a zero-width work window
- * (both stamps present — a half window is dropped downstream, and a missing one is
- * indistinguishable from an unstamped legacy row).
- *
- * A signal with no usable asset is dropped: an outcome that names no asset is not attributable.
- * Total by construction — it runs on the trading path and must never throw on a malformed entry.
- */
-export function skippedSignalResults(signals, reason, nowMs, overrides) {
-    if (!Array.isArray(signals))
-        return [];
-    const rows = [];
-    for (const raw of signals) {
-        if (raw === null || typeof raw !== 'object')
-            continue;
-        const signal = raw;
-        const rawAsset = signal.asset;
-        // Kept verbatim (not trimmed) so it still joins the scanner signal it came from.
-        const asset = typeof rawAsset === 'string' ? rawAsset : typeof rawAsset === 'number' ? String(rawAsset) : '';
-        if (asset.trim() === '')
-            continue;
-        const direction = signal.direction;
-        const score = signal.score;
-        // A decision-payload signal carries the book top-level (the strategy hoists it there); a raw
-        // scanner signal carries it only on `meta`, since `Signal` has no `dex` field. Both call
-        // shapes reach this helper, so both are read — top-level first, matching the per-signal loop.
-        const meta = signal.meta;
-        const metaDex = meta !== null && typeof meta === 'object' ? meta.dex : undefined;
-        const dex = typeof signal.dex === 'string' && signal.dex.trim() !== '' ? signal.dex : metaDex;
-        rows.push({
-            asset,
-            ...(direction === 'LONG' || direction === 'SHORT' ? { direction } : {}),
-            dex: typeof dex === 'string' && dex.trim() !== '' ? dex.trim() : 'main',
-            ...(typeof score === 'number' && Number.isFinite(score) ? { score } : {}),
-            success: overrides?.success ?? true,
-            reason,
-            ...(overrides?.error !== undefined ? { error: overrides.error } : {}),
-            startedAt: nowMs,
-            endedAt: nowMs,
-        });
-    }
-    return rows;
-}
-//# sourceMappingURL=skipped-signal-results.js.map

package/dist/actions/skipped-signal-results.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"skipped-signal-results.js","sourceRoot":"","sources":["../../src/actions/skipped-signal-results.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAuC,EACvC,MAAc,EACd,KAAa,EACb,SAAiD;IAEjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,IAAI,GAAmC,EAAE,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,SAAS;QACtD,MAAM,MAAM,GAAG,GAA8B,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;QAC9B,iFAAiF;QACjF,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7G,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QAClC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,6FAA6F;QAC7F,yFAAyF;QACzF,8FAA8F;QAC9F,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAgC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9G,MAAM,GAAG,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;QAC9F,IAAI,CAAC,IAAI,CAAC;YACR,KAAK;YACL,GAAG,CAAC,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,GAAG,EAAE,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM;YACvE,GAAG,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,OAAO,EAAE,SAAS,EAAE,OAAO,IAAI,IAAI;YACnC,MAAM;YACN,GAAG,CAAC,SAAS,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/scanners/external/scaffold/ulid.py

@@ -1,58 +0,0 @@
-"""ULID minting: a 26-character, lexicographically sortable id — 48 bits of millisecond timestamp
-followed by 80 bits of randomness, rendered in Crockford's base32. Sortable ids are what let two
-ticks be ordered without carrying a second field, and 80 random bits make a collision between two
-ticks of the same millisecond unreachable.
-
-Mirrors src/utils/ulid.ts so a scaffold id and a runtime id are the same kind of value. The random
-half is read out of a `uuid.uuid4()`, taking only the ten bytes that carry no version or variant
-bits, so all 80 of them are random.
-"""
-
-from __future__ import annotations
-
-import math
-import time
-import uuid
-
-# Crockford's base32: no I, L, O or U, so a transcribed id cannot be misread.
-CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ"
-
-TIME_CHARS = 10
-RANDOM_CHARS = 16
-MAX_TIME = 2 ** 48 - 1
-
-
-def _encode_time(ms) -> str:
-    """Render `ms` as the 10-character time prefix.
-
-    Clamped, and never raised from: a clock that reads non-finite, negative, or past the 48-bit
-    ceiling must still yield a valid id rather than kill the tick that asked for one.
-    """
-    try:
-        remaining = min(max(math.floor(ms), 0), MAX_TIME)
-    except (OverflowError, ValueError, TypeError):
-        remaining = 0
-    out = ""
-    for _ in range(TIME_CHARS):
-        out = CROCKFORD[remaining % 32] + out
-        remaining //= 32
-    return out
-
-
-def _encode_random() -> str:
-    """Render 80 random bits as the 16-character suffix, five bits at a time."""
-    # uuid4 holds its version and variant in bytes 6 and 8; the ten bytes taken here are the
-    # fully random ones.
-    raw = uuid.uuid4().bytes
-    acc = int.from_bytes(raw[:6] + raw[9:13], "big")
-    return "".join(
-        CROCKFORD[(acc >> shift) & 31]
-        for shift in range(RANDOM_CHARS * 5 - 5, -1, -5)
-    )
-
-
-def new_ulid(now_ms: int | None = None) -> str:
-    """Mint a ULID. `now_ms` is injectable so a caller can pin the time half in a test."""
-    if now_ms is None:
-        now_ms = int(time.time() * 1000)
-    return _encode_time(now_ms) + _encode_random()

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

@@ -1,158 +0,0 @@
-/**
- * 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.
- *
- * Everything that leaves the box is scrubbed here. `logger.event` redacts its `redact` slot and not
- * its `attributes`, which is sound for the disk ring — that never leaves — but not for a stream a
- * browser reads. Both outbound paths funnel through {@link toWireRecord}, so that is where the
- * scrub sits; it is what makes the flush tick asynchronous and gives it an in-flight guard.
- */
-import type { EventName } from "../utils/event-catalog.js";
-import { type TimelineBuffer } from "./timeline-buffer.js";
-import { type ScannerStateSnapshot, type ScannerStatsPayload } from "./scanner-stats.js";
-import { type IdMembership, type RuntimeHealthLike, type StrategyTopologyPayload, type TopologyStrategySource } from "./strategy-topology.js";
-/** The gateway drops any broadcast whose name does not carry this prefix, with no error. */
-export declare const EVENT_TIMELINE = "plugin.senpi.timeline";
-export declare const EVENT_STATS = "plugin.senpi.scanner.stats";
-export declare 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 declare const MAX_FRAME_BYTES: number;
-/** Flush cadence for the timeline. A live screen feels this number. */
-export declare const DEFAULT_FLUSH_INTERVAL_MS = 1000;
-/**
- * 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 declare const DEFAULT_SAMPLE_INTERVAL_MS = 5000;
-/**
- * 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 declare const PUBLISHED_EVENT_NAMES: ReadonlySet<EventName>;
-/**
- * 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 declare 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 declare const TIMING_REPORT_INTERVAL_MS = 60000;
-export interface GatewayBroadcastOpts {
-    dropIfSlow?: boolean;
-    stateVersion?: number;
-}
-export type GatewayBroadcastFn = (event: string, payload: unknown, opts?: GatewayBroadcastOpts) => void;
-/** One record as it goes on the wire. */
-export interface TimelineWireRecord {
-    seq: number;
-    ts: number;
-    name: string;
-    level: string;
-    address: string;
-    scannerId?: string;
-    body: string;
-    attrs: Record<string, string | number | boolean>;
-}
-export interface TimelinePayload {
-    v: 1;
-    epoch: string;
-    batchSeq: number;
-    records: TimelineWireRecord[];
-}
-export interface TelemetrySnapshot {
-    epoch: string;
-    topology: StrategyTopologyPayload;
-    stats: ScannerStatsPayload;
-    recent: TimelinePayload;
-    /**
-     * The client asked to resume from a cursor inside THIS epoch whose successor is no longer held, or
-     * the window it is owed did not fit one frame. Either way there is a gap this response cannot fill,
-     * and only the box knows it: `recent.records` alone looks like a normal short window.
-     *
-     * A cursor from another epoch is not truncation. It buys nothing, so the whole retained window is
-     * served — which is the most this box could ever serve, and so nothing was withheld.
-     */
-    truncated: boolean;
-}
-/** Everything the two builders need that the buffer cannot supply, gathered once per tick. */
-export interface TelemetryFacts {
-    strategies: TopologyStrategySource[];
-    runningRuntimeIds: IdMembership;
-    unwiredRuntimeIds: IdMembership;
-    readHealth?: (runtimeId: string) => RuntimeHealthLike | undefined;
-    scannerState: ScannerStateSnapshot[];
-}
-export interface LiveTelemetryOptions {
-    /** Defaults to the process buffer — one per process, shared by every address. */
-    buffer?: TimelineBuffer;
-    collectFacts: () => Promise<TelemetryFacts>;
-    flushIntervalMs?: number;
-    sampleIntervalMs?: number;
-    now?: () => number;
-    /**
-     * Monotonic millisecond reader for tick durations. Defaults to `performance.now`; `now` is wall
-     * clock and can step backwards under NTP, which would report a negative tick.
-     */
-    monotonicMs?: () => number;
-}
-export interface LiveTelemetry {
-    readonly epoch: string;
-    /** Take the broadcast handle off a gateway request context if we do not hold one yet. */
-    captureBroadcast(ctx: unknown, methodName: string): void;
-    /** `afterSeq` counts only when `afterEpoch` is the epoch this box is running. */
-    snapshot(params?: {
-        afterEpoch?: unknown;
-        afterSeq?: unknown;
-    }): Promise<TelemetrySnapshot>;
-    /** One flush tick: drain, filter to the publication list, scrub, frame, broadcast. */
-    flushTimeline(): Promise<void>;
-    /** One sample tick: stats always, topology when it changed. */
-    sample(): Promise<void>;
-    start(): void;
-    /** Clear both timers, drop the captured handle, and empty the buffer. */
-    stop(): void;
-}
-export declare function createLiveTelemetry(options: LiveTelemetryOptions): LiveTelemetry;
-//# sourceMappingURL=live-telemetry.d.ts.map

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

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