@senpi/runtime 3.0.6-dev.skill-manager-v2.20260629194505 → 3.0.9-dev.runtime-phase-2.20260707070820

package/dist/telemetry/event-store.js.map

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

package/dist/telemetry/identity.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Runtime identity stamped onto telemetry: the {@link IdentityEnvelope} and the config fingerprint.
+ *
+ * Because a runtime instance is bound to a single strategy/wallet, `strategyAddress` lives on the
+ * envelope rather than being repeated per signal.
+ *
+ * The hash is computed over the **unresolved** config (raw, pre-`${VAR}`) with canonically sorted
+ * keys: this keeps it stable across secret rotation and deterministic for a byte-identical recipe,
+ * and means it never carries resolved secrets.
+ */
+/**
+ * Identity stamped onto every telemetry record/span by the identity stamping layer.
+ *
+ * Producers never pass these fields individually — the layer holds them for its lifetime and applies
+ * them to everything it forwards. Because a runtime instance is bound to a single strategy/wallet,
+ * `strategyAddress` lives here rather than being repeated on each record.
+ */
+export interface IdentityEnvelope {
+    /** Logical service name (e.g. the ingestion service identifier). */
+    readonly service: string;
+    /** Recipe / strategy configuration name (the config's top-level `name`). */
+    readonly recipe: string;
+    /** Declared config version (the config's optional top-level `version`), when set. */
+    readonly recipeVersion?: string | number;
+    /**
+     * Content fingerprint of the **unresolved** config (raw, pre env-var substitution), canonically
+     * serialized (sorted keys) and hashed once at boot. Unresolved on purpose: hashing post-`${VAR}`
+     * would (a) put secrets in the hash input and (b) change the key whenever a secret rotates, even
+     * for a byte-identical recipe — the opposite of a "which recipe produced this" join key. Hashing
+     * the raw config makes the key stable across secret rotation and deterministic. Computed upstream
+     * at boot, NOT in any mapper, so a redaction pass can never perturb it. The cross-session join key:
+     * every record carries it via the envelope, while the unresolved config blob lives once on the
+     * runtime-lifecycle record's `config` (hash and blob share the same input). Distinguishes edits
+     * that didn't bump the declared `recipeVersion`.
+     */
+    readonly configHash?: string;
+    /** Runtime instance name (`runtimeName`). */
+    readonly runtime: string;
+    /** Strategy identifier = wallet address. */
+    readonly strategyAddress: string;
+    /**
+     * Deployment / installation group (the config's optional top-level `group`), when set. The fleet
+     * key the install flow stamps: it answers "same strategy failing across many boxes" and "one wallet
+     * of a multi-wallet install" — questions `strategyAddress` + `user.id` alone can't. Per-runtime (a
+     * multi-wallet install can run one group per wallet in one process), so it rides the identity bag,
+     * never the process-global resource (see `trace-identity.ts`).
+     */
+    readonly group?: string;
+    /** Unique id for this process boot, to disambiguate restarts. */
+    readonly bootId: string;
+}
+/** Logical producer name stamped as `service.name`. Must stay `senpi-trading-runtime`:
+ * it matches the sibling ingestion service's documented convention and the rows already in its
+ * ClickHouse tables, where `ServiceName` is part of the sort key. */
+export declare const SERVICE_NAME = "senpi-trading-runtime";
+/** SHA-256 hex of the canonicalized unresolved config; `undefined` when no config is available. */
+export declare function computeConfigHash(unresolvedConfig: Record<string, unknown> | undefined): string | undefined;
+export interface BuildIdentityParams {
+    /** Recipe / runtime name (the config's top-level `name`). */
+    readonly name: string;
+    readonly recipeVersion?: string | number;
+    /** Strategy identifier = wallet address. */
+    readonly strategyAddress: string;
+    /** Deployment / installation group (the config's optional top-level `group`). */
+    readonly group?: string;
+    /** Per-process boot id. */
+    readonly bootId: string;
+    /** Unresolved config, used to fingerprint the recipe (`configHash`). */
+    readonly unresolvedConfig?: Record<string, unknown>;
+}
+export declare function buildIdentity(params: BuildIdentityParams): IdentityEnvelope;
+//# sourceMappingURL=identity.d.ts.map

package/dist/telemetry/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/telemetry/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;qEAEqE;AACrE,eAAO,MAAM,YAAY,0BAA0B,CAAC;AAiBpD,mGAAmG;AACnG,wBAAgB,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAO3G;AAED,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC,4CAA4C;IAC5C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,CAW3E"}

package/dist/{recording/wiring → telemetry}/identity.js

@@ -1,12 +1,15 @@
 /**
- * Build the {@link IdentityEnvelope} and the config fingerprint stamped on every recorded row.
+ * Runtime identity stamped onto telemetry: the {@link IdentityEnvelope} and the config fingerprint.
+ *
+ * Because a runtime instance is bound to a single strategy/wallet, `strategyAddress` lives on the
+ * envelope rather than being repeated per signal.
  *
  * The hash is computed over the **unresolved** config (raw, pre-`${VAR}`) with canonically sorted
  * keys: this keeps it stable across secret rotation and deterministic for a byte-identical recipe,
  * and means it never carries resolved secrets.
  */
 import { createHash } from "node:crypto";
-/** Logical producer name stamped as `service.name` on every row. Must stay `senpi-trading-runtime`:
+/** Logical producer name stamped as `service.name`. Must stay `senpi-trading-runtime`:
  * it matches the sibling ingestion service's documented convention and the rows already in its
  * ClickHouse tables, where `ServiceName` is part of the sort key. */
 export const SERVICE_NAME = "senpi-trading-runtime";
@@ -44,6 +47,7 @@ export function buildIdentity(params) {
         recipeVersion: params.recipeVersion,
         runtime: params.name,
         strategyAddress: params.strategyAddress,
+        group: params.group,
         bootId: params.bootId,
         configHash: computeConfigHash(params.unresolvedConfig),
     };

package/dist/telemetry/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/telemetry/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA4CzC;;qEAEqE;AACrE,MAAM,CAAC,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAEpD;;;GAGG;AACH,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7E,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,iBAAiB,CAAC,gBAAqD;IACrF,IAAI,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAgBD,MAAM,UAAU,aAAa,CAAC,MAA2B;IACvD,OAAO;QACL,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,MAAM,CAAC,IAAI;QACnB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,OAAO,EAAE,MAAM,CAAC,IAAI;QACpB,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,iBAAiB,CAAC,MAAM,CAAC,gBAAgB,CAAC;KACvD,CAAC;AACJ,CAAC"}

package/dist/telemetry/metrics.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Manual OTel instruments, mirroring `tracing.ts`: obtained through the `@opentelemetry/api` proxy
+ * meter, so they no-op before the SDK initialises and resolve the real meter afterwards.
+ *
+ * One lazy cache stands up every instrument once: a name → instrument map per kind, fed by a spec
+ * table (description + unit). The instrument is created on first record (so it binds to the real
+ * meter after SDK init, not the no-op meter at module load) and cached thereafter. Every record
+ * helper is fully guarded — metrics must never throw into a caller path.
+ *
+ * GenAI instruments follow the GenAI semantic conventions; operational instruments mirror their
+ * event-family names (`scanner.*`, `runtime.*`), with attributes in the shared `senpi.*` namespace.
+ */
+import { type Meter } from "@opentelemetry/api";
+/** The single meter for our manual instruments. Resolves the no-op meter pre-init. */
+export declare function getMeter(): Meter;
+/** Reset cached instruments (tests only). */
+export declare function __resetMetricsForTest(): void;
+/** Elapsed seconds from a `Date.now()` start, clamped to non-negative. */
+export declare function elapsedSeconds(startMs: number | undefined): number | undefined;
+export interface GenAiOperationDims {
+    provider?: string;
+    model?: string;
+}
+/**
+ * Record token usage at chat finalize: one data point per token type present (input/output and, when
+ * the model reports them, cache_read/cache_write — the signal a silent context compaction otherwise
+ * hides). Skips a token type whose count is undefined.
+ */
+export declare function recordTokenUsage(dims: GenAiOperationDims, tokens: {
+    input?: number;
+    output?: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+}): void;
+/** Record the chat operation duration (seconds); stamps `error.type` when set. */
+export declare function recordOperationDuration(seconds: number | undefined, dims: GenAiOperationDims & {
+    errorType?: string;
+}): void;
+/**
+ * The origin-uniform tool-call metric plane: one entry point recording both the `tool.calls` counter
+ * (every call) and the `gen_ai.execute_tool.duration` histogram (when a duration was measured), under
+ * one set of dimensions so a single query spans every dispatch origin. `origin` is `agent`|`mcp`|
+ * `decision`; `outcome` is `ok`|`error`|`unknown`|`denied`. The narrative event (`tool.called`) is
+ * separate and abnormal-only — this is the count/weight half.
+ */
+export interface ToolCallDims {
+    toolName?: string;
+    /** Dispatch site: `agent` | `mcp` | `decision`. */
+    origin: string;
+    /** `ok` | `error` | `unknown` | `denied`. */
+    outcome: string;
+    /** Low-cardinality error class on an abnormal outcome (`errorTypeOf`). */
+    errorType?: string;
+    /** Measured call duration in seconds; omitted when the call never ran (e.g. an invented tool). */
+    durationSec?: number;
+}
+export declare function recordToolCall(dims: ToolCallDims): void;
+/** Record the sub-agent invocation duration (seconds); stamps `error.type` when set. */
+export declare function recordInvokeAgentDuration(seconds: number | undefined, dims: {
+    agentName?: string;
+    errorType?: string;
+}): void;
+/** Low-cardinality dimensions for the supervised-scanner health instruments. */
+export interface ScannerHealthDims {
+    /** Recipe-declared scanner name — stable across relaunch (the ephemeral scanner id is not a dim). */
+    scannerName?: string;
+    /** Strategy wallet, lowercased by the caller to match the identity join key. */
+    strategyAddress?: string;
+}
+/** Count one supervised-scanner restart (the supervisor's `restarting` edge). */
+export declare function recordScannerRestart(dims: ScannerHealthDims): void;
+/**
+ * Move the `scanner.degraded` state gauge: +1 on the healthy→degraded edge, −1 on degraded→recovered.
+ * The supervisor fires each edge once, so the net is the count of scanners currently degraded —
+ * alertable as `> 0` without a trace or log scan.
+ */
+export declare function recordScannerDegradedDelta(delta: number, dims: ScannerHealthDims): void;
+/** Count one scanner run by outcome (the run status). */
+export declare function recordScannerRun(dims: {
+    scannerId?: string;
+    outcome: string;
+}): void;
+/** Time a signal's wait in the serial queue before processing (seconds). */
+export declare function recordSignalQueueWait(seconds: number | undefined, dims: {
+    scannerId?: string;
+}): void;
+/** Count one signal-intake disposition at the HTTP boundary (accepted/rejected/expired/superseded/…). */
+export declare function recordSignalIntake(dims: {
+    scannerName?: string;
+    disposition: string;
+    reasonCode?: string;
+}): void;
+/** Count one post-decision signal outcome by result (accepted/rejected/blocked/error). */
+export declare function recordSignalOutcome(dims: {
+    result: string;
+    reasonCode?: string;
+}): void;
+/** Count one trade decision by mode/intent. */
+export declare function recordDecision(dims: {
+    mode?: string;
+    intent?: string;
+    byLlm?: boolean;
+}): void;
+/** Count one venue order submission by outcome (placed/filled/failed). */
+export declare function recordOrder(dims: {
+    asset?: string;
+    outcome: string;
+    reason?: string;
+    errorType?: string;
+}): void;
+/** Count one DSL degradation event by kind (sl_sync/price_stale/handoff). */
+export declare function recordDslDegradation(dims: {
+    failure: string;
+    handoffFailure?: string;
+    errorType?: string;
+}): void;
+/** Count one StateManager write that failed to persist. */
+export declare function recordStatePersistFailure(): void;
+/** Count one clearinghouse-state fetch retry by outcome (`stale` | `unreadable` | `exhausted`). */
+export declare function recordClearinghouseRetry(outcome: string): void;
+/** Per-runtime identity for the liveness heartbeat: wallet + the optional fleet `group` key. */
+export interface RuntimeIdentityDims {
+    /** Strategy wallet, lowercased by the caller to match the identity join key. */
+    strategyAddress?: string;
+    /** Deployment/fleet key — answers "same strategy failing across many boxes". */
+    group?: string;
+}
+/**
+ * Emit one liveness tick for a runtime. Called once at start and then every window: the *absence* of
+ * ticks for a runtime (by wallet/group) is what detects a dead runtime or box — a down process can't
+ * emit a "down" event, only the gap in this positive signal is alertable.
+ */
+export declare function recordRuntimeHeartbeat(dims: RuntimeIdentityDims): void;
+/** One runtime's contribution to the shared `runtime.queue_depth` gauge. */
+export interface QueueDepthSource {
+    /** Strategy wallet, lowercased by the caller to match the identity join key. */
+    strategyAddress?: string;
+    /** Deployment/fleet key. */
+    group?: string;
+    /** Live, sync read of the current queue depth — invoked at each metric collection. */
+    read: () => number;
+}
+/**
+ * Register a runtime's queue depth as a callback on the shared `runtime.queue_depth` observable gauge,
+ * dimensioned by wallet so N runtimes in one process report distinct series. The callback reads the live
+ * depth at each collection. Returns a disposer the runtime must call on stop to drop its observation.
+ */
+export declare function registerQueueDepthGauge(source: QueueDepthSource): () => void;
+/** One runtime's contribution to the shared `dsl.active_positions` gauge. */
+export interface DslActivePositionsSource {
+    /** Strategy wallet, lowercased by the caller to match the identity join key. */
+    strategyAddress?: string;
+    /** Deployment/fleet key. */
+    group?: string;
+    /** Live, sync read of this runtime's active DSL positions counted by exit phase. */
+    read: () => {
+        phase1: number;
+        phase2: number;
+    };
+}
+/**
+ * Register a runtime's active DSL-managed positions as a callback on the shared `dsl.active_positions`
+ * observable gauge, split by exit phase (`senpi.dsl.phase` 1|2) and dimensioned by wallet. Both phases
+ * are observed every collection (0 when empty) so the series stay live — a flat 0 (alive, no positions)
+ * reads differently from an absent series (a dead runtime). The callback reads the live counts at each
+ * collection. Returns a disposer the runtime must call on stop to drop its observation.
+ */
+export declare function registerDslActivePositionsGauge(source: DslActivePositionsSource): () => void;
+//# sourceMappingURL=metrics.d.ts.map

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

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